Skip to content

Commit e2e5e2f

Browse files
committed
release: v1.11.12
1 parent 1cfee42 commit e2e5e2f

57 files changed

Lines changed: 640 additions & 122 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: 5 additions & 3 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-03
4+
> **最后更新**: 2026-06-04
55
66
---
77

88
## 版本概览
99

1010
| 版本 | 日期 | 变更摘要 | 详细 |
1111
|------|------|---------|------|
12+
| [v1.11.12](./changelogs/releases/v1.11.12.md) | 2026-06-04 | 🔧 **平台工程守门、轻路径与复审覆盖收口**:新增平台工程前置、SimpleTaskFastPath、ContextHandoffCard、ReviewCoverageDelta、发布包边界串行与消费者依赖树优先探针,并补强发布型 Profile 与 V56/V57 校验 | [查看](./changelogs/releases/v1.11.12.md) |
1213
| [v1.11.11](./changelogs/releases/v1.11.11.md) | 2026-06-03 | 🔧 **S02 用户策略优先与服务清理收口**:反转 S02 为默认允许敏感信息、明文连接信息与硬编码;仅用户 / 项目明确禁止时才脱敏、占位或改用 env、`secretRef`、secret manager、`config.local.json`,并新增 AI 自启动服务清理闭环 | [查看](./changelogs/releases/v1.11.11.md) |
1314
| [v1.11.10](./changelogs/releases/v1.11.10.md) | 2026-06-02 | 🔧 **config.local 连接配置唯一入口收口**:收窄 S02 为可提交产物秘密禁止,允许用户授权的本地明文秘密写入已忽略的 `profile/config.local.json`,并强制脚本、测试、数据库 / SSH / MongoDB / 数据操作连接信息只能从 `config.local.json` 取得 | [查看](./changelogs/releases/v1.11.10.md) |
1415
| [v1.11.9](./changelogs/releases/v1.11.9.md) | 2026-06-02 | 🔧 **通用规范吸纳与提示词激励收口**:吸纳自然语言 Auto、Node.js >=18、远端 CI、依赖/兼容拆层、内部共享库评估、包工程层、TS 契约迁移、provider/connector 字段合同、service 防过度防御、README 能力矩阵与 JS/Node 标准 JSDoc,并补齐最小实现/复杂度预算守门 | [查看](./changelogs/releases/v1.11.9.md) |
@@ -97,8 +98,9 @@
9798

9899
## 相关文档
99100

100-
- [`changelogs/releases/v1.11.11.md`](./changelogs/releases/v1.11.11.md) — 最新版本详细变更文档
101-
- [`changelogs/releases/v1.11.10.md`](./changelogs/releases/v1.11.10.md) — 上一版本详细变更文档
101+
- [`changelogs/releases/v1.11.12.md`](./changelogs/releases/v1.11.12.md) — 最新版本详细变更文档
102+
- [`changelogs/releases/v1.11.11.md`](./changelogs/releases/v1.11.11.md) — 上一版本详细变更文档
103+
- [`changelogs/releases/v1.11.10.md`](./changelogs/releases/v1.11.10.md) — 历史版本详细变更文档
102104
- [`changelogs/releases/v1.11.9.md`](./changelogs/releases/v1.11.9.md) — 历史版本详细变更文档
103105
- [`changelogs/releases/v1.11.8.md`](./changelogs/releases/v1.11.8.md) — 历史版本详细变更文档
104106
- [`changelogs/releases/v1.11.6.md`](./changelogs/releases/v1.11.6.md) — 上一个版本详细变更文档

‎README.md‎

Lines changed: 9 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -45,10 +45,12 @@ DevCodex 通过 `.github/`(Copilot)、`CLAUDE.md + .claude/ + .mcp.json`(C
4545
- **发布前审查能力**: `audit-release` 负责 release readiness、发布说明质量、兼容/迁移风险、package/plugin 元数据、文档/Profile/website 同步、回滚策略、registry/tag 风险与发布后验收 review;`release-verification` 仍负责 R0~R7 执行验证链
4646
- **README 专项能力**: `readme-authoring` 负责 README 用户/使用者优先写作,`audit-readme` 负责 README / 用户使用文档专项 review
4747
- **Profile 新鲜度审查**: audit 会先执行 `Profile Freshness Check`,反向核对 Profile 是否仍匹配当前包版本、目录资产、脚本、发布状态、宿主能力和任务现实
48+
- **复审覆盖增量**: audit / review / ECR 的连续零发现必须附 `ReviewCoverageDelta`(`ReviewedSet` / `UnreviewedRelatedSet` / `NewlyReadThisRound` / `RepeatReadReason` / `NoNewSurfaceReason`),优先阅读此前未审查但相关联的代码、配置、测试、文档、部署副本和消费者链;无新增覆盖且无证据化理由时,不计入有效零发现
4849
- **规范治理 Intake**: 所有模式下每条用户消息在合理性评估后都会额外检查是否命中可泛化改进;命中时主动写入 `data/process-improvements.md`(优化清单,PI),必要时联动 `data/pending-fixes.md`(PF),并显式回执 `PI/PF`
4950
- **Backlog 真相复核与状态回写**: 从 `data/*.md` open/partial 项组织新需求或新批次前,先按 `pure-open / residual-tail / already-fixed / misclassified` 分类;实施后再执行台账状态回写闭环,避免“源码已修但 backlog 仍旧 open”
5051
- **官方文档证据前置**: 新增或升级依赖、框架、SDK、平台 API、外部模块前,CP2 会要求 `OfficialDocsEvidence`,记录官方文档来源、关键用法、限制与兼容性,避免凭经验猜 API
51-
- **通用工程守门**: Node.js 项目默认不低于 `>=18`;依赖/兼容任务拆分业务源码平滑性与依赖层落地条件;包/库/adapter/CLI 同查代码层与包工程层;JS/Node 必要注释使用标准 JSDoc;简单 service 不重复 route/model/schema 已承担的校验
52+
- **通用工程守门**: Node.js 项目默认不低于 `>=18`;需求/问题定义前置平台工程判断,先确认消费者范围、共享契约边界、模块职责、维护成本和非目标;依赖/兼容任务拆分业务源码平滑性与依赖层落地条件;包/库/adapter/CLI 同查代码层与包工程层;JS/Node 必要注释使用标准 JSDoc;简单 service 不重复 route/model/schema 已承担的校验
53+
- **验证卫生与包边界**: release / pack / benchmark / codegen 任务中,package boundary check 必须在构建完成后单独串行执行;消费者验证异常先查 package.json、lockfile、node_modules 与 `npm ls <关键依赖>`,收尾前清理无关 dirty 文件和验证残留
5254
- **ProfileImpactCheck**: dev/fix 改动项目技术栈、目录、脚本、测试/发布路线、分发面、配置或长期连接时,会主动判定是否需要更新 Profile;无需更新时也要写明跳过理由
5355
- **敏感信息与硬编码策略**: 默认允许敏感信息、明文连接信息和硬编码出现在用户要求的代码、脚本、配置、文档、测试或报告中;只有用户 / 项目明确禁止时才脱敏、占位或改用 env、`secretRef`、secret manager、`config.local.json`
5456
- **AI 自启动服务清理**: AI 为验证启动 dev server、文档站、本地 API/mock、数据库代理、SSH 隧道、Playwright/Cypress server 或压测 target 后,验证完成、失败或最终回复前会主动关闭仅由 AI 本轮启动的服务并核验端口释放;用户要求保留时会记录 PID/端口和关闭方式
@@ -170,6 +172,8 @@ AGENTS.md ← 与 instructions.md / copilot-instructions.md / CL
170172
- **Intent Expansion 可见性**:dev 模式默认会直接展示完整 Card;prod、instruction-fallback 宿主或低风险轻任务才退化为 3~5 行摘要。
171173
- **意图扩展摘要**:当扩展后路由变化、命中控制面/宿主差异、风险较高或跨会话恢复时,会在用户面输出 3~5 行摘要,便于确认“为什么这样路由”。
172174
- **Context Rehydration Contract**:压缩恢复、resume 或用户要求按文件真相重建时,会按“当前用户消息 → 已确认产物 → sessions → tasks → SUMMARY → 摘要 → AI 推断”的优先级恢复上下文,摘要不能覆盖文件真相源。
175+
- **ContextHandoffCard**:跨会话、跨 Agent、多批次、summary/compact 前或用户要求传递上下文时,会把 source-of-truth、confirmed decisions、open risks、next action、must-not-overwrite、validation state 与 ArtifactLinkSet 写入报告或 daily tasks;恢复时仍按 Context Rehydration Contract 重新核对文件真相源。
176+
- **SimpleTaskFastPath**:非常明确、预计 ≤2 文件、无公共契约/配置/发布/控制面/台账来源/高风险、无需多轮跟踪的简单 dev/fix 任务,可免建 `01-需求概述.md` / `04-实施计划.md`,改用内联 CP 摘要 + 报告/记忆 `N/A + skipReason`;范围扩大时立即升级回完整产物链。
173177
- **Hook closure 三态**:Stop/PreCompact 可见回复验证区分 `verified-present`、`verified-missing`、`unverified`;无法解析最终 assistant 内容时只提示无法验证,并给出 payload capture 指引,不再断言“未输出”。
174178
- **长流程执行契约**:Auto、控制面、多批次、预计修改 ≥10 文件或发布前置任务会触发 ExecutionContract;测试路线不明显时触发 TestRoute;正式发版前触发 ReleaseAudit 与 ReleaseVerification;控制面消费链联动时建立 Concept Sync Map;宿主契约变化时触发 `host-contract-verification`。
175179
- **执行期 CP3 回退**:若执行过程中实际修改范围扩展到 CP3 门槛(≥5 文件、高风险、控制面联动),必须暂停执行并先补做 CP3,再继续改动。
@@ -182,6 +186,7 @@ AGENTS.md ← 与 instructions.md / copilot-instructions.md / CL
182186
- **官方资料优先**:涉及平台能力、框架 API、版本兼容性或工具语义判断时,优先读取官方文档,再降级到其他资料;新增/升级依赖、框架、SDK、平台 API 或外部模块时必须形成 `OfficialDocsEvidence`。
183187
- **ProfileImpactCheck**:项目事实变化后,DevCodex 会检查是否需要同步 Profile 的技术栈、目录边界、脚本/测试/发布路线、配置说明或当前阶段;若不更新,需要在报告中写明 `skipReason`。
184188
- **ServiceLifecycleCleanup**:若验证需要 AI 自己启动本地服务,会记录启动命令、cwd、PID/job、端口/URL,并在验证完成、失败或最终回复前关闭仅由 AI 本轮启动的服务;不会为了释放端口杀掉用户已有进程。
189+
- **文档阅读顺序同步**:正文、README 或维护者文档一旦定义“先看什么 / 审查顺序 / 实施顺序”,website sidebar/nav、索引页和目录页要作为当前消费者同批校验;若信息架构故意不同,必须说明差异。
185190
- **提交标题收短**:用户要求提交时,DevCodex 会优先生成一句简洁的 commit subject,而不是把整段会话摘要塞进标题。
186191

187192

@@ -275,6 +280,8 @@ node /path/to/devcodex/index.js status
275280

276281
### 文档站本地预览
277282

283+
> 维护者提示:CLI 安装/运行仍只要求 Node.js >=18;文档站基于 Rspress 2,当前本地构建需 Node.js `^20.19.0 || >=22.12.0`。
284+
278285
```bash
279286
cd website
280287
npm install
@@ -421,6 +428,7 @@ DevCodex Hook runtime 不再把所有拦截都等同为“停止”。拦截会
421428

422429
**前置条件**:
423430
- Node.js ≥ 18(CLI 零依赖,仅使用标准库)
431+
- 若维护或构建 `website/` 文档站,需要 Node.js `^20.19.0 || >=22.12.0`(Rspress 2 依赖要求)
424432
- 已启用目标宿主的规则加载能力(Copilot `Use Instruction Files` / Claude Code 标准项目规则加载 / Codex 工作区 `AGENTS.md` 加载)
425433
- Copilot 路径:已安装支持的 GitHub Copilot IDE(VS Code / JetBrains 全量支持;Visual Studio / Xcode / Eclipse 部分支持,详见 §IDE 兼容性)
426434
- Claude Code 路径:允许项目级 hooks 与 MCP(`init --claude` 会写入默认配置)

‎RULES.md‎

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

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

‎changelogs/releases/v1.11.12.md‎

Lines changed: 53 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,53 @@
1+
# v1.11.12 — 平台工程守门、轻路径与复审覆盖收口
2+
3+
> 发布日期:2026-06-04
4+
5+
## 变更摘要
6+
7+
- 新增平台工程前置守门:dev/fix 的需求或问题定义必须先判断消费者范围、共享契约边界、模块职责、维护成本与非目标,避免把“通用性/模块化”写成无消费者的空心抽象。
8+
- 新增 `SimpleTaskFastPath`:非常明确、预计 <=2 文件、无公共契约/配置/发布/控制面/台账来源/高风险、无需多轮跟踪的简单 dev/fix 任务,可免建完整需求/bug 目录,用内联 CP 摘要、报告和记忆记录 `N/A + skipReason`。
9+
- 新增 `ContextHandoffCard`:跨会话、跨 Agent、多批次、summary/compact 前或用户要求传递上下文时,报告或 daily tasks 必须写入 source-of-truth、confirmed decisions、open risks、next action、must-not-overwrite、validation state 与 artifact links。
10+
- 新增 `ReviewCoverageDelta`:audit / review / ECR 的连续零发现必须说明 `ReviewedSet`、`UnreviewedRelatedSet`、`NewlyReadThisRound`、`RepeatReadReason` 与 `NoNewSurfaceReason`;无新增覆盖且无证据化理由时,不计入有效零发现。
11+
- 补强发布与验证卫生:新增 `PackageBoundarySerialCheck`、`ConsumerDependencyTreeProbe`、发布型 Profile `PFresh-6` 与文档阅读顺序同步规则,要求 pack / boundary 检查在构建完成后单独串行执行,消费者验证失败时先排除依赖树漂移。
12+
- 补强 active-root Profile freshness:`validate-profile.js` 新增 S02 旧口径探针,防止运行时 Profile 残留“默认禁止硬编码/秘密”表述。
13+
- 修复发布态 changelog 校验:`V54~V57` 与 `test-spec-governance` 现在按 `unreleased + changelogs/releases/*.md` 查找证据,避免正式归档后因 `unreleased` 复位为空模板而误报。
14+
15+
## Changed
16+
17+
- 同步 `instructions.md`、`10-dev`、`11-fix`、`12-audit`、`13-analyze`、`15-memory`、`16-report`、`17-compliance` 与相关 Skills / Prompts。
18+
- 同步 README、website development / release guide、flowcharts 与 workflow execution flow。
19+
- 新增 `V56` 与 `V57` governance probes,覆盖平台工程前置、包边界串行、依赖树优先、导航顺序同步和复审覆盖增量。
20+
- `V54~V57` changelog evidence 改为扫描 `changelogs/unreleased.md` 和所有 `changelogs/releases/*.md`,兼容正式发布归档状态。
21+
- `test-requirement-artifacts` 支持识别 `SimpleTaskFastPath` 的合法 N/A 产物。
22+
- `website/package-lock.json` 刷新 `@rspress/core` 间接依赖的 `react-router-dom` / `react-router` 到 `7.16.0`,解除发布前生产依赖审计中的 React Router 安全公告阻断。
23+
24+
## Fixed
25+
26+
- 修复简单任务被强制创建完整需求概况和实施计划的流程过重问题。
27+
- 修复上下文传递规则只定义恢复、不定义交接产物的问题。
28+
- 修复复审收敛可能机械重复同一批已读内容、缺少新增覆盖证据的问题。
29+
- 修复 active-root Profile S02 旧口径无法被 `validate` 发现的盲区。
30+
- 修复 release 归档后 `unreleased.md` 已清空但 V57 / targeted probe 仍硬要求其保留条目的误报。
31+
- 修复 README / Profile 未区分 CLI Node >=18 与文档站 Rspress 2 维护构建 Node 20.19+ 的 Profile Freshness 风险。
32+
33+
## Release Gate Evidence
34+
35+
- `OfficialDocsEvidence`: updated。发布前审计发现 `website` 生产依赖命中 React Router 官方安全公告;已核对 React Router changelog、GitHub Security Advisory 与 npm 元数据,采用 `npm --prefix website audit fix` 将间接依赖提升到 `react-router-dom@7.16.0` / `react-router@7.16.0`。
36+
- `ProfileImpactCheck`: updated。发布版本、当前阶段、发布型 Profile 字段与文档站 Node 维护构建下限已同步 active-root Profile;source release metadata 已同步 package / plugin / lockfile / RULES / instructions frontmatter。
37+
- `ReviewCoverageDelta`: 本轮发布前复审按差异文件、发布元数据、active-root Profile、运行时台账、ignored host copies、部署副本和 registry/tag 事实分层新增阅读;结果写入发布报告。
38+
- 已知非阻断项:`PI-019 / PI-020 / ISSUE-027` 属 v2 一期架构规划与技术方案包延期项,不影响 v1.11.12 package 行为与发布边界。
39+
40+
## Validation
41+
42+
- `node scripts/test-spec-governance.js`
43+
- `node scripts/test-requirement-artifacts.js`
44+
- `node scripts/test-validate-profile.js`
45+
- `node scripts/validate.js`
46+
- `npm test`
47+
- `npm run test:audit`
48+
- `git diff --check`
49+
- `node .\devcodex-v1\index.js update`
50+
- `npm pack --dry-run`
51+
- `npm publish --dry-run`
52+
- pack install smoke
53+
- post-publish registry / tag verification

‎changelogs/unreleased.md‎

Lines changed: 0 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,3 @@
1111
- 控制面 / 长流程 / 多批次变更写入本文件时,优先标明 `execution-contract`、`test-router`、`release-verification`、`host-contract-verification`、`source-consumer-sync` 等支撑型能力是否同步更新。
1212
- 宿主输出、Hook 或项目现实扩展相关条目,建议显式写出 `verified-present / verified-missing / unverified`、sticky `activeProject` 与用户可见 `意图扩展摘要` 是否发生变化。
1313
- 执行闭环、确认机制或发布门禁相关条目,建议补充 `Intent Expansion Card`、`ConfirmationRequest`、`ECR` 与验证证据,方便正式发版时直接归档到版本 changelog。
14-
15-
## 2026-06-03
16-
17-
- 暂无未发布变更。

0 commit comments

Comments
 (0)