Skip to content

Commit 03fabde

Browse files
committed
release: v1.11.16
1 parent 8c41888 commit 03fabde

57 files changed

Lines changed: 609 additions & 144 deletions

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

‎CHANGELOG.md‎

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

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

88
## 版本概览
99

1010
| 版本 | 日期 | 变更摘要 | 详细 |
1111
|------|------|---------|------|
12+
| [v1.11.16](./changelogs/releases/v1.11.16.md) | 2026-06-10 | 🔧 **治理 intake 行为闭环、跨项目吸纳守门与发布前收敛**:新增用户建议/纠错的行为级治理 intake replay,修正 source-root 宿主副本治理、Profile/website 新鲜度与 C13 作用域,吸纳跨项目 data 守门并补齐 `TechnicalRouteComparativeGate` | [查看](./changelogs/releases/v1.11.16.md) |
1213
| [v1.11.15](./changelogs/releases/v1.11.15.md) | 2026-06-09 | 🔧 **问答证据门禁、复杂度用户面与产物生命周期收口**:新增 `QuestionEvidenceGate / ComparativeResearchGate`,将 CP1 复杂度主口径升级为 `ImplementationComplexityLevel` 三档,并补齐 `ArtifactDecisionMatrix / ArtifactLifecycleState`、模板漂移探针与 V8 source-root 部署副本检查 | [查看](./changelogs/releases/v1.11.15.md) |
1314
| [v1.11.14](./changelogs/releases/v1.11.14.md) | 2026-06-05 | 🔧 **ExistingRequirementArtifactOverride 与需求回写收口**:修复 `SimpleTaskFastPath` 对既有需求/bug 真相源的过宽豁免,明确调整需求必须先回写已有文件,回复只做摘要;`v1.11.14` 替代未 registry 发布的 `v1.11.13` | [查看](./changelogs/releases/v1.11.14.md) |
1415
| [v1.11.13](./changelogs/releases/v1.11.13.md) | 2026-06-04 | 🔧 **默认简单实现档位与 Profile Auto 别名**:CP1 新增 `ImplementationComplexityPreference` 且默认 `simple`,Auto v1.1 支持 Profile `extensions.devcodex.autoAliases`(本项目 `@rocky`),并补齐 runtime / profile schema / V13-V14 探针 | [查看](./changelogs/releases/v1.11.13.md) |
@@ -101,8 +102,9 @@
101102

102103
## 相关文档
103104

104-
- [`changelogs/releases/v1.11.15.md`](./changelogs/releases/v1.11.15.md) — 最新版本详细变更文档
105-
- [`changelogs/releases/v1.11.14.md`](./changelogs/releases/v1.11.14.md) — 上一版本详细变更文档
105+
- [`changelogs/releases/v1.11.16.md`](./changelogs/releases/v1.11.16.md) — 最新版本详细变更文档
106+
- [`changelogs/releases/v1.11.15.md`](./changelogs/releases/v1.11.15.md) — 上一版本详细变更文档
107+
- [`changelogs/releases/v1.11.14.md`](./changelogs/releases/v1.11.14.md) — 历史版本详细变更文档
106108
- [`changelogs/releases/v1.11.13.md`](./changelogs/releases/v1.11.13.md) — 历史版本详细变更文档
107109
- [`changelogs/releases/v1.11.12.md`](./changelogs/releases/v1.11.12.md) — 历史版本详细变更文档
108110
- [`changelogs/releases/v1.11.11.md`](./changelogs/releases/v1.11.11.md) — 历史版本详细变更文档
@@ -121,4 +123,5 @@
121123
- [`changelogs/releases/v1.9.8.md`](./changelogs/releases/v1.9.8.md) — 历史版本详细变更文档
122124
- [`changelogs/releases/v1.1.0.md`](./changelogs/releases/v1.1.0.md) — 历史版本详细变更文档
123125
- [README.md](./README.md) — 项目说明
124-
- [requirements/index.md](./website/docs/versions/v1/1.0.0/requirements/index.md) — 需求文档总览
126+
- [requirements/index.md](./website/docs/versions/v1/1.0.1/requirements/index.md) — 当前活动版本需求文档总览
127+
- [v1.0.0 requirements](./website/docs/versions/v1/1.0.0/requirements/index.md) — 历史基线需求快照

‎README.md‎

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -50,14 +50,15 @@ DevCodex 通过 `.github/`(Copilot)、`CLAUDE.md + .claude/ + .mcp.json`(C
5050
- **Backlog 真相复核与状态回写**: 从 `data/*.md` open/partial 项组织新需求或新批次前,先按 `pure-open / residual-tail / already-fixed / misclassified` 分类;实施后再执行台账状态回写闭环,避免“源码已修但 backlog 仍旧 open”
5151
- **官方文档证据前置**: 新增或升级依赖、框架、SDK、平台 API、外部模块前,CP2 会要求 `OfficialDocsEvidence`,记录官方文档来源、关键用法、限制与兼容性,避免凭经验猜 API
5252
- **通用工程守门**: Node.js 项目默认不低于 `>=18`;需求/问题定义前置平台工程判断,并记录 `ImplementationComplexityLevel`,开发程度分为 `简单够用 / 中等 / 企业级`,用户未要求复杂化或需求不详细时默认 `简单够用`;依赖/兼容任务拆分业务源码平滑性与依赖层落地条件;包/库/adapter/CLI 同查代码层与包工程层;JS/Node 必要注释使用标准 JSDoc;简单 service 不重复 route/model/schema 已承担的校验
53+
- **跨项目经验吸纳守门**: 字段/本地化/状态新增前执行 `ExistingDomainContractAudit`,业务策略常量执行 `ConfigOwnershipMatrix`,接口文档合同执行 `ApiDocVerificationSync`,数据迁移执行 `DataMutationPlan`,值得吸纳建议执行 `AbsorptionDecision`,完整首版执行 `FullV1ScopeGuard`,启动优化执行 `StartupPhaseTrace`
5354
- **验证卫生与包边界**: release / pack / benchmark / codegen 任务中,package boundary check 必须在构建完成后单独串行执行;消费者验证异常先查 package.json、lockfile、node_modules 与 `npm ls <关键依赖>`,收尾前清理无关 dirty 文件和验证残留
5455
- **ProfileImpactCheck**: dev/fix 改动项目技术栈、目录、脚本、测试/发布路线、分发面、配置或长期连接时,会主动判定是否需要更新 Profile;无需更新时也要写明跳过理由
5556
- **敏感信息与硬编码策略**: 默认允许敏感信息、明文连接信息和硬编码出现在用户要求的代码、脚本、配置、文档、测试或报告中;只有用户 / 项目明确禁止时才脱敏、占位或改用 env、`secretRef`、secret manager、`config.local.json`
5657
- **AI 自启动服务清理**: AI 为验证启动 dev server、文档站、本地 API/mock、数据库代理、SSH 隧道、Playwright/Cypress server 或压测 target 后,验证完成、失败或最终回复前会主动关闭仅由 AI 本轮启动的服务并核验端口释放;用户要求保留时会记录 PID/端口和关闭方式
5758
- **变更日志分层**: 未发布实现变更写 `changelogs/unreleased.md`,已发布详情统一归档到 `changelogs/releases/vX.Y.Z.md`,目录说明见 `changelogs/README.md`
5859
- **执行闭环复审**: dev/fix 完成前执行 ECR 执行闭环复审,交叉验证 CP 产物、报告、daily memory、SUMMARY、diff/commit、测试/探针与 dirty 边界
5960
- **推荐结论**: analyze/audit/report 多建议或多路径场景必须给出推荐结论与推荐理由;无后续动作时明确写“推荐:无后续动作”
60-
- **对比调研门禁**: 用户问“是否应该 / 哪个更好 / 有没有更好建议 / 推荐什么”且结论会影响时间、金钱、架构、产品/项目路线或长期维护成本时,先执行 `QuestionEvidenceGate`;必要时比较同类产品 / 项目 / 本仓库相似模块,普通低风险问答可标 `ComparativeResearchGate: N/A + skipReason`
61+
- **对比调研门禁**: 用户问“是否应该 / 哪个更好 / 有没有更好建议 / 推荐什么”且结论会影响时间、金钱、架构、产品/项目路线或长期维护成本时,先执行 `QuestionEvidenceGate`;技术路线、架构优化、性能优化、框架能力设计或高维护成本方案在 CP1 最终需求确认前执行 `TechnicalRouteComparativeGate`;必要时比较同类产品 / 项目 / 本仓库相似模块,普通低风险问答可标 `ComparativeResearchGate: N/A + skipReason`
6162
- **确认交互降级**: 用户确认先抽象为 ConfirmationRequest,再按宿主能力选择按钮、权限提示、Hook 阻断或文本确认 fallback,不把按钮 UI 承诺为全宿主能力
6263
- **执行护栏**: 新需求切换时优先按意图判断边界;涉及外部平台/API/兼容性判断时优先看官方文档;提交时压缩 commit subject
6364

@@ -94,7 +95,7 @@ npx @vextjs/devcodex init --codex # 仅 Codex adapter
9495
```
9596
.github/
9697
├── copilot-instructions.md ← 默认 Copilot always-on 总则(新增)
97-
├── instructions/ ← Instructions 约束(12 个,含全部工作流规则)
98+
├── instructions/ ← Instructions 约束(15 个,含全部工作流规则)
9899
├── agents/ ← Copilot 自定义 Agent(v1.9.8 起恢复默认分发)
99100
├── skills/ ← Skill 详细检查标准(44 个,按需读取,含 README 专项能力、spec-governance 与 5 个支撑型 Skill)
100101
├── prompts/ ← Prompt 模板(26 个)
@@ -113,7 +114,7 @@ AGENTS.md ← 与 instructions.md / copilot-instructions.md / CL
113114
└── skills/ ← Skill 详细检查标准(与源仓库 skills/ 同步)
114115
.codex/
115116
├── hooks.json ← Codex Hook 入口配置
116-
└── hooks/_runtime/ ← 统一 lifecycle.cjs 运行时
117+
└── hooks/_runtime/ ← 统一 lifecycle.cjs 运行时及 helper 模块
117118
```
118119

119120
`init --claude` 是 Claude Code-only 路径:只写入 `CLAUDE.md`、`.claude/{instructions,skills,prompts,hooks/_runtime,mcp,data}` 与 `.mcp.json`,并同步开启项目级 hooks / MCP / permissions 配置。
@@ -297,10 +298,10 @@ npm run dev
297298
devcodex/
298299
├── instructions.md # 单源规范文件;安装时按平台生成 copilot-instructions.md / CLAUDE.md / AGENTS.md
299300
├── agents/ # Agent 源文件;Copilot 端默认分发,Claude Code 端不分发
300-
├── instructions/ # 全局 Instructions(12 个,含工作流规则摘要,自动注入)
301+
├── instructions/ # 全局 Instructions(15 个,含工作流规则摘要,自动注入)
301302
├── skills/ # Skill 详细检查标准(44 个,按 01-common §按需读取表 路由读取)
302303
├── prompts/ # Prompt 模板(26 个)
303-
├── hooks/ # Workspace Hooks 配置与分发到 `.github/hooks/_runtime/` 的运行时
304+
├── hooks/ # Workspace Hooks 配置与分发到 `.github/hooks/_runtime/` 的运行时及 helper 模块
304305
├── codex/ # Codex adapter 源模板(分发到 `.codex/hooks.json`,不是工作区部署副本 `.codex/`)
305306
├── data/ # 运行时数据模板(分发到目标项目的空骨架)
306307
│ ├── README.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.15 — 使用入口
1+
# DevCodex v1.11.16 — 使用入口
22

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

‎changelogs/releases/v1.11.16.md‎

Lines changed: 45 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,45 @@
1+
# v1.11.16 — 治理 intake 行为闭环、跨项目吸纳守门与发布前收敛
2+
3+
> 发布日期:2026-06-10
4+
5+
## 变更摘要
6+
7+
- 补齐主动记录行为级闭环:Hook runtime 新增 `governanceIntakeCandidate` 候选状态与 Stop / PreCompact 收尾提醒;`test-governance-intake.js` 增加用户建议、用户纠错、`record.none + skipReason`、历史编号 false-positive 和普通 chat direct replay;V39 反查 runtime/test 行为探针。
8+
- 修复治理 intake 合理性偏移:普通“以后要怎么...”问句和“没有回答普通问题”不再误触发治理候选;非 `record.none` 的已分流判定必须同时具备 `规范化意图`、`置信度`、`依据` 与 `目标台账` / 已记录编号。
9+
- 修复全维度审计发现项:Hook bootstrap 改为可验证宿主优先;旧台账编号不能单独关闭当前治理候选;补充 Codex profile-agent mismatch、旧编号 false-positive 与临时目录清理回放;同步 README、active Profile、`1.0.1` requirements、pricing、历史 self-fix 页与 V19/V39/V8 新鲜度探针。
10+
- 收窄 C13 文件拆分口径:500 行上限仅约束新建 DevCodex 规范资产 `.md`(instructions / skills / prompts / templates / 规范源等),业务项目需求、技术方案、报告和正式项目文档不因 C13 被机械压缩或拆分。
11+
- 吸纳跨项目 data 台账中的通用建议:新增 `ExistingDomainContractAudit`、`ConfigOwnershipMatrix`、`ApiDocVerificationSync`、`DataMutationPlan`、`AbsorptionDecision`、`FullV1ScopeGuard` 与 `StartupPhaseTrace` 守门。
12+
- 吸纳复审补齐 `TechnicalRouteComparativeGate`:技术路线、架构优化、性能优化、框架能力设计或高维护成本方案在 CP1 最终需求确认前,按条件记录 `ComparativeResearchGate` 证据范围与采纳 / 不采纳理由。
13+
- 修正 source-root 宿主副本治理口径:V8 不再把源码仓根 ignored 宿主副本当作可刷新部署副本,而是作为 source-root host-copy 残留直接失败;V31 反查 `single active deployment target`。
14+
15+
## Fixed
16+
17+
- 修复 Improvement Intake 只停留在规则文本,缺少用户消息级行为 replay 的缺口。
18+
- 修复治理 intake 防漏逻辑从“漏记”偏向“过度提醒”或“薄证据放行”的双向偏移。
19+
- 修复 `ApiDocVerificationSync`、`StartupPhaseTrace` 已吸纳但 CP2 technical-design 模板缺填写位、V13 缺探针的问题。
20+
- 修复 workspace `PI-006` 技术路线对比建议未进入 dev CP1 消费链的问题。
21+
- 修复 C13 过宽应用到业务需求、技术方案、报告和正式项目文档的风险。
22+
23+
## Release Gate Evidence
24+
25+
- `OfficialDocsEvidence`: N/A。本轮不新增/升级第三方依赖、框架、SDK 或外部平台 API。
26+
- `ProfileImpactCheck`: updated。active Profile 当前版本、当前阶段与发布状态更新到 v1.11.16。
27+
- `ConceptSyncMap`: sourceOfTruth 为 `instructions.md`、`instructions/01b-record-router.instructions.md`、`instructions/10-dev.instructions.md`、`prompts/requirement.prompt.md`、`prompts/technical-design.prompt.md`、`hooks/_runtime/lifecycle*.cjs` 与 `scripts/lib/validate-governance-*.js`;currentConsumers 已同步 README、website、split instructions、prompts、skills、validate probes 与工作区部署副本;historicalMirrors 为 `website/docs/versions/v1/1.0.0/**` 等历史归档。
28+
- `ReleaseRecovery`: 不重写远端 `v1.11.15` tag;v1.11.16 作为新 patch 发布,registry/tag 以 v1.11.16 验收。
29+
30+
## Validation
31+
32+
- `node scripts/validate.js`
33+
- `node scripts/test-governance-intake.js`
34+
- `node scripts/test-hooks-runtime.js`
35+
- `node scripts/test-spec-governance.js`
36+
- `node scripts/test-release-metadata.js`
37+
- `node scripts/test-pack-clean.js`
38+
- `npm test`
39+
- `npm run test:audit`
40+
- `git diff --check`
41+
- `npm pack --dry-run`
42+
- `npm publish --dry-run`
43+
- pack install smoke
44+
- remote main/tag verification
45+
- GitHub Packages registry verification

‎hooks/_runtime/lifecycle-bootstrap-state.cjs‎

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,8 @@ function buildLifecycleBootstrapStateUtils(ctx) {
2626
isRecentBootstrapTaskPath,
2727
buildInterceptionOutput,
2828
INTERCEPTION_ACTION,
29-
noopOutput
29+
noopOutput,
30+
emptyGovernanceIntakeState
3031
} = ctx
3132

3233
function buildScopedNeedles(scopeRoot, segments) {
@@ -97,6 +98,7 @@ function buildLifecycleBootstrapStateUtils(ctx) {
9798
updatedAtMs: 0
9899
},
99100
cp3Runtime: {},
101+
governanceIntake: emptyGovernanceIntakeState(),
100102
mutated: false,
101103
reportTouched: false,
102104
memoryTouched: false,
@@ -131,6 +133,7 @@ function buildLifecycleBootstrapStateUtils(ctx) {
131133
visible: { ...current.visible, ...(saved.visible || {}) },
132134
stickyProject: { ...current.stickyProject, ...(saved.stickyProject || {}), ...(metaState?.stickyProject || {}) },
133135
cp3Runtime: { ...current.cp3Runtime, ...(saved.cp3Runtime || {}) },
136+
governanceIntake: { ...current.governanceIntake, ...(saved.governanceIntake || {}) },
134137
dangerousApprovals: { ...current.dangerousApprovals, ...(saved.dangerousApprovals || {}) }
135138
}
136139
}

0 commit comments

Comments
 (0)