Skip to content

Commit 7203579

Browse files
committed
release: v1.11.3
1 parent c1e927f commit 7203579

22 files changed

Lines changed: 1274 additions & 302 deletions

‎CHANGELOG.md‎

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,15 @@
11
# 变更日志 (CHANGELOG)
22

33
> **说明**: 版本概览摘要。最新版本的详细变更见下方表格首行的 `changelogs/vX.Y.Z.md` 链接;历史版本见对应详细变更文件
4-
> **最后更新**: 2026-05-28
4+
> **最后更新**: 2026-05-29
55
66
---
77

88
## 版本概览
99

1010
| 版本 | 日期 | 变更摘要 | 详细 |
1111
|------|------|---------|------|
12+
| [v1.11.3](./changelogs/v1.11.3.md) | 2026-05-29 | 🛡️ **命名空间安全边界与宿主配置保护收口**:统一 `workspace-layout` 真相源,阻断 MCP `project` 路径穿越、修复 nested monorepo 命名空间碰撞与无会话 sticky 误继承;Claude adapter 改为备份+保守合并,`doctor` 去除 Codex 偏置,并将 `test:audit` 从确定性主链拆分 | [查看](./changelogs/v1.11.3.md) |
1213
| [v1.11.2](./changelogs/v1.11.2.md) | 2026-05-28 | 🔧 **治理生命周期与运行态落点收口**:新增 `spec-governance` / RecordRouter / SCV 验证链,修复 workspace-namespace 运行态落点、临时/备份产物漂移、MCP SUMMARY 模板与 release/profile/audit-state 防漂移校验,并同步 Profile 全模式 PC0~PC7 与历史归档页口径 | [查看](./changelogs/v1.11.2.md) |
1314
| [v1.11.1](./changelogs/v1.11.1.md) | 2026-05-27 | 🔧 **Codex 宿主闭环 + Hook 契约与执行复审增强**:补齐 Codex adapter 分发、宿主实际落点、Hook 拦截状态机、危险命令确认、MCP memory scope、宿主输出契约 direct replay,并新增 ECR、Intent Expansion Card、ConfirmationRequest 与报告推荐结论校验 | [查看](./changelogs/v1.11.1.md) |
1415
| [v1.11.0](./changelogs/v1.11.0.md) | 2026-05-26 | 🎯 **全模式入口检查 + 项目现实扩展**:PC0~PC7 从 dev-only 提升为所有模式基础入口状态,dev 模式保留 PC4 完整规范雷达与 FC/SC/RC/T;新增“语义初判 → Profile → 项目现实扩展 → 最终路由”链路,并同步 runtime bootstrap/Stop 提醒、模板、Skills、validate 探针、README 与网站文档 | [查看](./changelogs/v1.11.0.md) |
@@ -88,7 +89,7 @@
8889

8990
## 相关文档
9091

91-
- [`changelogs/v1.11.2.md`](./changelogs/v1.11.2.md) — 最新版本详细变更文档
92+
- [`changelogs/v1.11.3.md`](./changelogs/v1.11.3.md) — 最新版本详细变更文档
9293
- [`changelogs/v1.11.1.md`](./changelogs/v1.11.1.md) — 上一个版本详细变更文档
9394
- [`changelogs/v1.11.0.md`](./changelogs/v1.11.0.md) — 历史版本详细变更文档
9495
- [`changelogs/v1.10.0.md`](./changelogs/v1.10.0.md) — 历史版本详细变更文档

‎RULES.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
1-
# DevCodex v1.11.2 — 使用入口
1+
# DevCodex v1.11.3 — 使用入口
22

3-
> AI workflow injector for Copilot / Claude Code / Codex · publisher: Rocky · version: 1.11.2
3+
> AI workflow injector for Copilot / Claude Code / Codex · publisher: Rocky · version: 1.11.3
44
55
## 正式主支持客户端
66

‎changelogs/unreleased.md‎

Lines changed: 4 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -6,14 +6,8 @@
66
77
---
88

9-
## 2026-05-28
9+
## 记录提示
1010

11-
- 修复规范治理台账闭环:统一 `violations` / `pending-fixes` 字段模型,新增修复方案、修复时间、验证状态、验证证据与关闭时间,明确 DevCodex 规范自身问题按 active-root 写入 `.devcodex/devcodex-v1/data/`,并补强 RecordRouter 对用户纠偏、误关闭、误落点和复审逃逸问题的分流规则与 validate 探针。
12-
- 修复 Hook Stop/PreCompact 可见回复验证:支持 content parts、messages、choices 与 transcript variants,并将 closure 判断升级为 `verified-present` / `verified-missing` / `unverified` 三态。
13-
- 修复 Copilot 多项目 workspace 根每轮 warning:已识别唯一项目后短 TTL 内沿用 sticky `activeProject` 与项目 `mode`,workspace-namespace 提示改为真实 `.devcodex/workspace/profile/` 路径,并避免把 payload `role: "user"`、prompt `user-visible`、URL 片段或前缀项目路径等通用/相邻词误判为同名项目。
14-
- 补充 dev/fix 用户可见意图扩展摘要规则,在控制面、宿主差异、路由修正、风险升高或跨会话 resume 时输出 3~5 行摘要。
15-
- 新增 `execution-contract`、`test-router`、`release-verification`、`host-contract-verification`、`source-consumer-sync` 五个支撑型 Skill,并同步注册到 `plugin.json`。
16-
- 补强 dev/fix、报告模板、实施计划、实施进度与交付清单对执行契约、测试路由、发布验证和多批次进度的强制消费。
17-
- 补强 Concept Sync Map 与 HostContractRoute:控制面任务需显式区分真相源、当前消费者、历史镜像、validate 探针、部署副本与黄色偏离边界;宿主契约任务需显式记录 direct replay / fixture replay / bootstrap / workspace guard 证据。
18-
- 更新 README、website 与 Agent/Profile 文档,将 Skill 数量同步为 41,并说明 Auto/控制面/多批次/发布任务的闭环约束。
19-
- 收敛规范资产跨层漂移:统一 `resume` 读取顺序、PC5 的 Codex 部署面、`audit-state` 的 `<audit-root>` 口径、audit 报告收敛头部,以及 `CONTRIBUTING` 模板占位命令;新增 `validate` 的 `V30~V34` 探针并同步 website 当前消费者文案。
11+
- 控制面 / 长流程 / 多批次变更写入本文件时,优先标明 `execution-contract`、`test-router`、`release-verification`、`host-contract-verification`、`source-consumer-sync` 等支撑型能力是否同步更新。
12+
- 宿主输出、Hook 或项目现实扩展相关条目,建议显式写出 `verified-present / verified-missing / unverified`、sticky `activeProject` 与用户可见 `意图扩展摘要` 是否发生变化。
13+
- 执行闭环、确认机制或发布门禁相关条目,建议补充 `Intent Expansion Card`、`ConfirmationRequest`、`ECR` 与验证证据,方便正式发版时直接归档到版本 changelog。

‎changelogs/v1.11.3.md‎

Lines changed: 36 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,36 @@
1+
# v1.11.3 — 命名空间安全边界与宿主配置保护收口
2+
3+
> 发布日期:2026-05-29
4+
5+
## Highlights
6+
7+
- 命名空间安全边界收口:新增共享 `workspace-layout.cjs` 真相源,统一 Hook / CLI / MCP / fallback-check 的 namespace 解析,并阻断 `project` 参数路径穿越。
8+
- 宿主配置保护增强:`init/update --claude` 改为备份 + 保守合并,保留用户 `permissions.ask/deny`、custom hooks 与 custom MCP servers。
9+
- 发布验证链收敛:新增 `scripts/test-cli-behavior.js`、`validate` 的 `V37` 与独立 `test:audit`,把确定性主链和依赖审计链拆开。
10+
11+
## Changed
12+
13+
- 新增 `host-contract-verification` 与 `source-consumer-sync` 两个支撑型 Skill,并增强 `execution-contract`、`test-router`、报告模板、实施计划/进度与 README / website / Profile / 部署副本消费链。
14+
- 补齐 `Intent Expansion Card`、`ConfirmationRequest`、ECR 执行闭环复审与发布验证证据在规范源、报告模板、validate 探针和发布文档中的同步语义。
15+
- 统一规范治理口径:补齐 `spec-governance` / RecordRouter / SCV、Concept Sync Map、HostContractRoute 与 active-root / report / validate 真相源联动。
16+
- `doctor` 现在区分 env 证据和安装痕迹,在多宿主共存时显式输出 `installed hosts`,不再默认偏置为 Codex。
17+
18+
## Fixed
19+
20+
- 修复 `mcp/profile-server.js` 与 `mcp/memory-server.js` 的 `project` 参数路径穿越,避免越界读写工作区外的 profile / memory 文件。
21+
- 修复 workspace-namespace 下 nested monorepo 命名空间碰撞、Hook 运行态 state 落错命名空间、无会话 sticky project 误继承,以及 `migrate-layout` 对 `packages/*` 旧布局的浅扫描问题。
22+
- 修复 Claude adapter 覆盖用户本地配置的问题,为 `CLAUDE.md`、`.claude/settings.json`、`.mcp.json` 增加备份并改为保守合并。
23+
- 修复容器目录(如 `packages/`)在自身带 marker 时被误识别为项目命名空间的问题,避免 nested monorepo workspace guard 回退到浅模型。
24+
25+
## Validation
26+
27+
- `npm test`
28+
- `npm run test:all`
29+
- `npm run test:audit`
30+
- `npm pack --dry-run`
31+
- `npm publish --dry-run`
32+
33+
## Included Unreleased Items
34+
35+
- 2026-05-28 控制面支撑 Skill、Concept Sync Map / HostContractRoute、规范治理台账闭环与跨层漂移收敛相关未发布条目。
36+
- 2026-05-29 workspace-namespace 安全边界、Claude adapter 配置保护、doctor 宿主判定去偏置与确定性验证链拆分相关未发布条目。

‎hooks/_runtime/lifecycle.cjs‎

Lines changed: 88 additions & 53 deletions
Original file line numberDiff line numberDiff line change
@@ -14,6 +14,11 @@
1414
const fs = require('fs')
1515
const path = require('path')
1616
const crypto = require('crypto')
17+
const {
18+
collectWorkspaceProjectNamespaces,
19+
findLayoutInfo,
20+
inferProjectFromCwd
21+
} = require('./workspace-layout.cjs')
1722

1823
const CONTEXT_ROOT = process.cwd()
1924
const PAYLOAD_PREVIEW_LIMIT = 160
@@ -105,56 +110,19 @@ function mergeConfig(baseConfig, overlayConfig) {
105110
return merged
106111
}
107112

108-
function findLayoutInfo(startDir) {
109-
let current = path.resolve(startDir)
110-
while (true) {
111-
const markerPath = path.join(current, '.devcodex', 'layout.json')
112-
const marker = readJsonFile(markerPath)
113-
if (marker && String(marker.mode || '').trim() === 'workspace-namespace') {
114-
return {
115-
enabled: true,
116-
mode: 'workspace-namespace',
117-
workspaceRoot: current,
118-
markerPath
119-
}
120-
}
121-
const parent = path.dirname(current)
122-
if (parent === current) break
123-
current = parent
124-
}
125-
return {
126-
enabled: false,
127-
mode: 'legacy-project-root',
128-
workspaceRoot: path.resolve(startDir),
129-
markerPath: null
130-
}
131-
}
132-
133113
const LAYOUT = findLayoutInfo(CONTEXT_ROOT)
134114
const WORKSPACE_ROOT = LAYOUT.workspaceRoot
135115

136116
function inferContextProject() {
137-
if (!LAYOUT.enabled) return ''
138-
const relative = path.relative(WORKSPACE_ROOT, CONTEXT_ROOT)
139-
if (!relative || relative.startsWith('..') || path.isAbsolute(relative)) return ''
140-
const parts = relative.split(path.sep).filter(Boolean)
141-
if (!parts.length) return ''
142-
const first = parts[0]
143-
if (first === '.devcodex' || first === 'workspace') return ''
144-
return first
117+
return inferProjectFromCwd(CONTEXT_ROOT, LAYOUT)
145118
}
146119

147120
const CONTEXT_PROJECT = inferContextProject()
148121
const DEFAULT_SCOPE = LAYOUT.enabled ? (CONTEXT_PROJECT ? 'project' : 'workspace') : 'project'
149-
const STATE_SCOPE_KEY = LAYOUT.enabled ? (CONTEXT_PROJECT || 'workspace') : 'legacy'
150122
const ACTIVE_RUNTIME_ROOT = LAYOUT.enabled
151123
? path.join(WORKSPACE_ROOT, '.devcodex', CONTEXT_PROJECT || 'workspace')
152124
: path.join(WORKSPACE_ROOT, '.devcodex')
153-
const STATE_DIR = path.join(ACTIVE_RUNTIME_ROOT, '.memory', 'hooks', STATE_SCOPE_KEY)
154-
const STATE_FILE = path.join(STATE_DIR, 'lifecycle-state.json')
155-
const FINAL_PAYLOAD_FLAG = path.join(STATE_DIR, 'capture-final-payload.flag')
156-
const FINAL_PAYLOAD_LOG = path.join(STATE_DIR, 'captured-final-payloads.ndjson')
157-
const INTERCEPTION_LOG = path.join(STATE_DIR, 'interceptions.jsonl')
125+
const META_STATE_SCOPE_KEY = LAYOUT.enabled ? 'workspace' : 'legacy'
158126
const INTERCEPTION_ACTION = {
159127
FORBID: 'forbid',
160128
REQUIRE_COMPLETION: 'require_completion',
@@ -193,6 +161,41 @@ function getProjectNamespaceRoot(projectName) {
193161
return path.join(WORKSPACE_ROOT, '.devcodex', resolveProjectName(projectName))
194162
}
195163

164+
function buildStatePaths(namespaceRoot, scopeKey) {
165+
const dir = path.join(namespaceRoot, '.memory', 'hooks', scopeKey)
166+
return {
167+
dir,
168+
file: path.join(dir, 'lifecycle-state.json'),
169+
finalPayloadFlag: path.join(dir, 'capture-final-payload.flag'),
170+
finalPayloadLog: path.join(dir, 'captured-final-payloads.ndjson'),
171+
interceptionLog: path.join(dir, 'interceptions.jsonl')
172+
}
173+
}
174+
175+
function getMetaStatePaths() {
176+
const namespaceRoot = LAYOUT.enabled ? getWorkspaceNamespaceRoot() : path.join(WORKSPACE_ROOT, '.devcodex')
177+
return buildStatePaths(namespaceRoot, META_STATE_SCOPE_KEY)
178+
}
179+
180+
function getStatePathsFor(projectName, scope) {
181+
if (!LAYOUT.enabled) return getMetaStatePaths()
182+
if (scope === 'workspace' || !projectName) return getMetaStatePaths()
183+
return buildStatePaths(getProjectNamespaceRoot(projectName), projectName)
184+
}
185+
186+
function getStatePaths(state, explicitProject, explicitScope) {
187+
const scope = explicitScope || state?.activeScope || DEFAULT_SCOPE
188+
const projectName = resolveProjectName(explicitProject || state?.activeProject || '')
189+
return getStatePathsFor(projectName, scope)
190+
}
191+
192+
const META_STATE_PATHS = getMetaStatePaths()
193+
const STATE_DIR = META_STATE_PATHS.dir
194+
const STATE_FILE = META_STATE_PATHS.file
195+
const FINAL_PAYLOAD_FLAG = META_STATE_PATHS.finalPayloadFlag
196+
const FINAL_PAYLOAD_LOG = META_STATE_PATHS.finalPayloadLog
197+
const INTERCEPTION_LOG = META_STATE_PATHS.interceptionLog
198+
196199
function getActiveScope(state) {
197200
return state?.activeScope || DEFAULT_SCOPE
198201
}
@@ -461,8 +464,12 @@ function appendInterception(state, entry) {
461464
enforcementMode: ENFORCEMENT_MODE,
462465
activeProject: state?.activeProject || ''
463466
}
464-
fs.mkdirSync(STATE_DIR, { recursive: true })
465-
fs.appendFileSync(INTERCEPTION_LOG, `${JSON.stringify(record)}\n`)
467+
const targets = [getStatePaths(state)]
468+
if (LAYOUT.enabled && targets[0].file !== META_STATE_PATHS.file) targets.push(META_STATE_PATHS)
469+
for (const target of targets) {
470+
fs.mkdirSync(target.dir, { recursive: true })
471+
fs.appendFileSync(target.interceptionLog, `${JSON.stringify(record)}\n`)
472+
}
466473
}
467474

468475
function recordInterception(state, eventName, platform, action, code, reason, nextStep, effective) {
@@ -488,6 +495,9 @@ function buildInterceptionOutput(state, platform, eventName, action, code, reaso
488495

489496
// ─── Multi-project workspace detection (v1.9.8+) ──────────────────────────────
490497
function listWorkspaceProjects() {
498+
if (LAYOUT.enabled) {
499+
return collectWorkspaceProjectNamespaces(WORKSPACE_ROOT)
500+
}
491501
let entries
492502
try { entries = fs.readdirSync(WORKSPACE_ROOT) } catch { return [] }
493503
const projects = []
@@ -499,8 +509,7 @@ function listWorkspaceProjects() {
499509
if (!stat.isDirectory()) continue
500510
const hasPkg = fs.existsSync(path.join(dir, 'package.json'))
501511
const hasProfile = fs.existsSync(path.join(dir, '.devcodex', 'profile'))
502-
const hasNamespaceProfile = LAYOUT.enabled && fs.existsSync(path.join(WORKSPACE_ROOT, '.devcodex', name, 'profile'))
503-
if (hasPkg || hasProfile || hasNamespaceProfile) {
512+
if (hasPkg || hasProfile) {
504513
projects.push(name)
505514
}
506515
}
@@ -616,6 +625,7 @@ function getValidStickyProject(previousState, payload) {
616625
if (!updatedAtMs || now - updatedAtMs > STICKY_PROJECT_TTL_MS) return null
617626
const currentSessionKey = getPayloadSessionKey(payload)
618627
const stickySessionKey = String(sticky.sessionKey || '').trim()
628+
if (!currentSessionKey || !stickySessionKey) return null
619629
if (currentSessionKey && stickySessionKey && currentSessionKey !== stickySessionKey) return null
620630
return { project, source: sticky.source || 'sticky', sessionKey: stickySessionKey }
621631
}
@@ -976,23 +986,47 @@ function buildDefaultState(mode) {
976986
}
977987

978988
function loadState(modeHint) {
979-
const saved = readJsonFile(STATE_FILE)
980-
const mode = modeHint || readProfileMode(saved || null)
989+
const metaState = readJsonFile(META_STATE_PATHS.file)
990+
let saved = metaState
991+
if (LAYOUT.enabled) {
992+
const preferredProject = String(metaState?.activeProject || CONTEXT_PROJECT || '').trim()
993+
const preferredScope = metaState?.activeScope || (preferredProject ? 'project' : DEFAULT_SCOPE)
994+
const activeState = readJsonFile(getStatePathsFor(preferredProject, preferredScope).file)
995+
if (activeState && typeof activeState === 'object') {
996+
saved = activeState
997+
} else if (CONTEXT_PROJECT) {
998+
const contextState = readJsonFile(getStatePathsFor(CONTEXT_PROJECT, 'project').file)
999+
if (contextState && typeof contextState === 'object') saved = contextState
1000+
}
1001+
}
1002+
const mode = modeHint || readProfileMode(saved || metaState || null, saved?.activeProject || metaState?.activeProject || '')
9811003
const current = buildDefaultState(mode)
9821004
if (!saved || typeof saved !== 'object') return current
9831005
return {
9841006
...current, ...saved, mode,
9851007
bootstrap: { ...current.bootstrap, ...(saved.bootstrap || {}) },
9861008
visible: { ...current.visible, ...(saved.visible || {}) },
987-
stickyProject: { ...current.stickyProject, ...(saved.stickyProject || {}) },
1009+
stickyProject: { ...current.stickyProject, ...(saved.stickyProject || {}), ...(metaState?.stickyProject || {}) },
9881010
dangerousApprovals: { ...current.dangerousApprovals, ...(saved.dangerousApprovals || {}) }
9891011
}
9901012
}
9911013

9921014
function saveState(state) {
993-
fs.mkdirSync(STATE_DIR, { recursive: true })
9941015
state.updatedAt = new Date().toISOString()
995-
fs.writeFileSync(STATE_FILE, JSON.stringify(state, null, 2))
1016+
const activePaths = getStatePaths(state)
1017+
fs.mkdirSync(activePaths.dir, { recursive: true })
1018+
fs.writeFileSync(activePaths.file, JSON.stringify(state, null, 2))
1019+
if (LAYOUT.enabled && activePaths.file !== META_STATE_PATHS.file) {
1020+
const metaState = {
1021+
...state,
1022+
bootstrap: { ...(state.bootstrap || {}) },
1023+
visible: { ...(state.visible || {}) },
1024+
stickyProject: { ...(state.stickyProject || {}) },
1025+
dangerousApprovals: { ...(state.dangerousApprovals || {}) }
1026+
}
1027+
fs.mkdirSync(META_STATE_PATHS.dir, { recursive: true })
1028+
fs.writeFileSync(META_STATE_PATHS.file, JSON.stringify(metaState, null, 2))
1029+
}
9961030
}
9971031

9981032
function resetState(mode, previousState) {
@@ -1684,17 +1718,18 @@ function updateVisibleReplyState(state, payload, eventName) {
16841718
}
16851719

16861720
function captureFinalPayloadSample(payload, eventName, state) {
1687-
if ((eventName !== 'PreCompact' && eventName !== 'Stop') || !fs.existsSync(FINAL_PAYLOAD_FLAG)) return
1688-
fs.mkdirSync(STATE_DIR, { recursive: true })
1721+
const statePaths = getStatePaths(state)
1722+
if ((eventName !== 'PreCompact' && eventName !== 'Stop') || !fs.existsSync(statePaths.finalPayloadFlag)) return
1723+
fs.mkdirSync(statePaths.dir, { recursive: true })
16891724
const snap = {
16901725
capturedAt: new Date().toISOString(), eventName,
16911726
payloadKeys: Object.keys(payload).sort(),
16921727
visiblePayloadDetected: hasVisibleReplyPayload(payload),
16931728
interestingStrings: collectInterestingStrings(payload),
16941729
state: { mode: state.mode, executionMode: state.executionMode, phase: state.phase, mutated: state.mutated }
16951730
}
1696-
fs.appendFileSync(FINAL_PAYLOAD_LOG, `${JSON.stringify(snap)}\n`)
1697-
if (eventName === 'Stop') fs.unlinkSync(FINAL_PAYLOAD_FLAG)
1731+
fs.appendFileSync(statePaths.finalPayloadLog, `${JSON.stringify(snap)}\n`)
1732+
if (eventName === 'Stop') fs.unlinkSync(statePaths.finalPayloadFlag)
16981733
}
16991734

17001735
// ─── Closure reminder ─────────────────────────────────────────────────────────
@@ -1712,7 +1747,7 @@ function buildClosureReminder(state, eventName) {
17121747
if (eventName === 'Stop' && precheckStatus === 'verified-missing') {
17131748
items.push('entry check block 未输出(S07/C18:首条用户可见回复必须含 PC0~PC7 入口检查块)')
17141749
} else if (eventName === 'Stop' && precheckStatus === 'unverified') {
1715-
items.push(`无法验证最终用户可见回复是否包含入口检查块(Stop/PreCompact 未提供可解析 assistant 内容;如需取证请创建 ${FINAL_PAYLOAD_FLAG} 后重试)`)
1750+
items.push(`无法验证最终用户可见回复是否包含入口检查块(Stop/PreCompact 未提供可解析 assistant 内容;如需取证请创建 ${getStatePaths(state).finalPayloadFlag} 后重试)`)
17161751
}
17171752
if (eventName === 'Stop' && state.mode === 'dev' && state.reportTouched && state.visible && !state.visible.compliance) {
17181753
items.push('合规检查状态块未输出(17-compliance:dev 模式非 chat 回复末尾必须含 🛡️ DEV 模式 | 合规检查 状态块)')

0 commit comments

Comments
 (0)