Skip to content

Commit ed1d712

Browse files
committed
Release v1.11.20 data absorption guards
1 parent ec95080 commit ed1d712

55 files changed

Lines changed: 393 additions & 48 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: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@
99

1010
| 版本 | 日期 | 变更摘要 | 详细 |
1111
|------|------|---------|------|
12+
| [v1.11.20](./changelogs/releases/v1.11.20.md) | 2026-06-12 | 🔧 **最新 data 吸纳守门补强**:新增全工作区 data 扫描、流程图节点说明、文档站视觉验收、遗漏专审、方法级泄漏压测与 v2 正式方案包守门,并补齐 V63 探针 | [查看](./changelogs/releases/v1.11.20.md) |
1213
| [v1.11.19](./changelogs/releases/v1.11.19.md) | 2026-06-12 | 🔧 **剩余 data 吸纳守门扩展与 v2 MCP-first 路线纠偏**:新增产品原文追溯、本机可执行配置、人工复核数据留存、相邻范围扩大、包名权限、性能 benchmark-first、公开模块差异化与 V2 MCP-first 规划守门,并补齐 V62 探针 | [查看](./changelogs/releases/v1.11.19.md) |
1314
| [v1.11.18](./changelogs/releases/v1.11.18.md) | 2026-06-11 | 🔧 **前端体验质量门禁与跨项目吸纳守门收口**:新增 `FrontendExperienceQualityGate`、UI/UX 体验门禁、8 项 `CrossProjectLearnedGuards`,并同步 dev/fix/audit/test Skill、CP/报告模板、README、website、活动版本 P1 需求页与 V61 探针 | [查看](./changelogs/releases/v1.11.18.md) |
1415
| [v1.11.17](./changelogs/releases/v1.11.17.md) | 2026-06-11 | 🔧 **并发策略、默认 Auto 别名与泄漏稳定性测试路线收口**:新增 `ConcurrencyPolicy` Profile schema、全局默认 `@rocky` Auto 别名、`PE-12` 资源生命周期审查维度与 `LeakRiskStabilityPressureTest` 测试路线,并补齐活动版本 P1 需求页、website sidebar 与治理探针 | [查看](./changelogs/releases/v1.11.17.md) |
@@ -105,7 +106,7 @@
105106

106107
## 相关文档
107108

108-
- [`changelogs/releases/v1.11.19.md`](./changelogs/releases/v1.11.19.md) — 最新版本详细变更文档
109+
- [`changelogs/releases/v1.11.20.md`](./changelogs/releases/v1.11.20.md) — 最新版本详细变更文档
109110
- [`changelogs/releases/v1.11.18.md`](./changelogs/releases/v1.11.18.md) — 上一版本详细变更文档
110111
- [`changelogs/releases/v1.11.17.md`](./changelogs/releases/v1.11.17.md) — 历史版本详细变更文档
111112
- [`changelogs/releases/v1.11.15.md`](./changelogs/releases/v1.11.15.md) — 历史版本详细变更文档

‎README.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -54,7 +54,7 @@ DevCodex 通过 `.github/`(Copilot)、`CLAUDE.md + .claude/ + .mcp.json`(C
5454
- **Backlog 真相复核与状态回写**: 从 `data/*.md` open/partial 项组织新需求或新批次前,先按 `pure-open / residual-tail / already-fixed / misclassified` 分类;实施后再执行台账状态回写闭环,避免“源码已修但 backlog 仍旧 open”
5555
- **官方文档证据前置**: 新增或升级依赖、框架、SDK、平台 API、外部模块前,CP2 会要求 `OfficialDocsEvidence`,记录官方文档来源、关键用法、限制与兼容性,避免凭经验猜 API
5656
- **通用工程守门**: Node.js 项目默认不低于 `>=18`;需求/问题定义前置平台工程判断,并记录 `ImplementationComplexityLevel`,开发程度分为 `简单够用 / 中等 / 企业级`,用户未要求复杂化或需求不详细时默认 `简单够用`;依赖/兼容任务拆分业务源码平滑性与依赖层落地条件;包/库/adapter/CLI 同查代码层与包工程层;JS/Node 必要注释使用标准 JSDoc;简单 service 不重复 route/model/schema 已承担的校验
57-
- **跨项目经验吸纳守门**: 字段/本地化/状态新增前执行 `ExistingDomainContractAudit`,业务策略常量执行 `ConfigOwnershipMatrix`,接口文档合同执行 `ApiDocVerificationSync`,数据迁移执行 `DataMutationPlan`,值得吸纳建议执行 `AbsorptionDecision`,完整首版执行 `FullV1ScopeGuard`,启动优化执行 `StartupPhaseTrace`;新增吸纳 `CodeTruthRequirementGate`、`ManualReviewEvidenceRetention`、`DocumentationTranslationParityGuard`、`FormalDocsDevCodexBoundary`、`LLMPromptContractTriage`、`VerificationScopeBudgetGate`、`LiveVerificationExecutionObligation`、`AdapterBenchmarkAttribution`、`ProductRequirementTraceabilityGate`、`LocalExecutionConfigProbe`、`ManualReviewEvidenceDataRetention`、`AdjacentScopeExpansionGuard`、`PackageNameAuthorityGate`、`PerformanceBenchmarkFirstGate`、`PublicModuleDifferentiationGate` 与 `V2MCPFirstPlanningGate`
57+
- **跨项目经验吸纳守门**: 字段/本地化/状态新增前执行 `ExistingDomainContractAudit`,业务策略常量执行 `ConfigOwnershipMatrix`,接口文档合同执行 `ApiDocVerificationSync`,数据迁移执行 `DataMutationPlan`,值得吸纳建议执行 `AbsorptionDecision`,完整首版执行 `FullV1ScopeGuard`,启动优化执行 `StartupPhaseTrace`;新增吸纳 `CodeTruthRequirementGate`、`ManualReviewEvidenceRetention`、`DocumentationTranslationParityGuard`、`FormalDocsDevCodexBoundary`、`LLMPromptContractTriage`、`VerificationScopeBudgetGate`、`LiveVerificationExecutionObligation`、`AdapterBenchmarkAttribution`、`ProductRequirementTraceabilityGate`、`LocalExecutionConfigProbe`、`ManualReviewEvidenceDataRetention`、`AdjacentScopeExpansionGuard`、`PackageNameAuthorityGate`、`PerformanceBenchmarkFirstGate`、`PublicModuleDifferentiationGate`、`V2MCPFirstPlanningGate`、`WorkspaceDataAbsorptionScopeGate`、`FlowchartNodeExplanationGate`、`DocsSiteVisualAcceptanceGate`、`OmissionOnlyReviewGate`、`MethodLevelLeakPressureProbe` 与 `V2FormalSolutionPackage`
5858
- **验证卫生与包边界**: release / pack / benchmark / codegen 任务中,package boundary check 必须在构建完成后单独串行执行;消费者验证异常先查 package.json、lockfile、node_modules 与 `npm ls <关键依赖>`,收尾前清理无关 dirty 文件和验证残留
5959
- **ProfileImpactCheck**: dev/fix 改动项目技术栈、目录、脚本、测试/发布路线、分发面、配置或长期连接时,会主动判定是否需要更新 Profile;无需更新时也要写明跳过理由
6060
- **敏感信息与硬编码策略**: 默认允许敏感信息、明文连接信息和硬编码出现在用户要求的代码、脚本、配置、文档、测试或报告中;只有用户 / 项目明确禁止时才脱敏、占位或改用 env、`secretRef`、secret manager、`config.local.json`

‎RULES.md‎

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

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

‎changelogs/releases/v1.11.20.md‎

Lines changed: 41 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,41 @@
1+
# v1.11.20 — 最新 data 吸纳守门补强
2+
3+
> 发布日期:2026-06-12
4+
> 变更类型:规范治理 / 文档站 / 测试门禁
5+
> 风险级别:P1
6+
> 向后兼容:✅ 兼容
7+
8+
## 变更摘要
9+
10+
本版本吸纳最新仍需吸纳清单,将全工作区 data 扫描、遗漏专审、文档站视觉验收、方法级泄漏压测和 v2 正式方案包转为可执行门禁,并补齐 V63 探针。
11+
12+
## Added
13+
14+
- 新增 `WorkspaceDataAbsorptionScopeGate`:data 吸纳必须扫描 `.devcodex/*/data/` 全命名空间。
15+
- 新增 `FlowchartNodeExplanationGate`:正式流程图和 Nxx 节点图必须配套中文节点说明。
16+
- 新增 `DocsSiteVisualAcceptanceGate`:文档站/官网视觉验收覆盖主题、点击、动效、代码 token、TOC 和辅助导航。
17+
- 新增 `OmissionOnlyReviewGate`:用户要求遗漏专审时只列此前未覆盖且仍有价值的项。
18+
- 新增 `MethodLevelLeakPressureProbe`:高风险资源泄漏修复需评估公开方法级重复调用或生命周期压测。
19+
- 新增 `V2FormalSolutionPackage`:建立 v2 一期正式 CP1/CP2 方案包与 website formal page。
20+
- 新增 `V63` validate 探针和 `test-spec-governance` 覆盖。
21+
22+
## Changed
23+
24+
- 同步 `instructions.md`、`10-dev`、`12-audit`、dev/audit/test/doc Skill、CP/report prompts、README、website guide、requirements index、sidebar 和 v2 路线图。
25+
- 同步工作区 `.github/`、`.claude/`、`AGENTS.md`、`.agents/` 与 `.codex/` 部署副本。
26+
27+
## 验证
28+
29+
```bash
30+
node scripts/validate.js
31+
node scripts/test-spec-governance.js
32+
npm test
33+
```
34+
35+
全部通过。
36+
37+
## 相关资源
38+
39+
- `website/docs/versions/v1/1.0.1/requirements/p1/latest-data-absorption-guards/`
40+
- `website/docs/versions/v2/2.0.0/formal-solution-package.md`
41+
- `.devcodex/devcodex-v1/requirements/v2一期正式方案包/`

‎changelogs/unreleased.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -14,5 +14,6 @@
1414

1515
- 控制面 / 长流程 / 多批次变更写入本文件时,优先标明 `execution-contract`、`test-router`、`release-verification`、`host-contract-verification`、`source-consumer-sync` 等支撑型能力是否同步更新。
1616
- 剩余 `data` 吸纳守门类变更需显式标明 `ProductRequirementTraceabilityGate`、`PackageNameAuthorityGate`、`V2MCPFirstPlanningGate` 等关键门禁,避免正式发版前遗漏 V62 覆盖链路。
17+
- 最新 `data` 吸纳守门补强需显式标明 `WorkspaceDataAbsorptionScopeGate`、`DocsSiteVisualAcceptanceGate`、`OmissionOnlyReviewGate`、`MethodLevelLeakPressureProbe` 与 `V2FormalSolutionPackage`,避免正式发版前遗漏 V63 覆盖链路。
1718
- 宿主输出、Hook 或项目现实扩展相关条目,建议显式写出 `verified-present / verified-missing / unverified`、sticky `activeProject` 与用户可见 `意图扩展摘要` 是否发生变化。
1819
- 执行闭环、确认机制或发布门禁相关条目,建议补充 `Intent Expansion Card`、`ConfirmationRequest`、`ECR` 与验证证据,方便正式发版时直接归档到版本 changelog。

‎instructions.md‎

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -299,6 +299,12 @@ dev/fix 修改完成前必须判定是否影响 Profile。命中以下任一触
299299
- `PerformanceBenchmarkFirstGate`:用户要求“最快、首个、优于、性能提升、压测、benchmark”时,必须先冻结基线、环境、指标、负载和比较对象,再实施优化;缺少基线时不得宣称提升或第一。
300300
- `PublicModuleDifferentiationGate`:面向公开模块、SDK、CLI、插件或文档站能力时,必须区分 public API、内部实现、示例代码、发布包文件和消费者入口;不得把内部 helper 或历史镜像描述成公开承诺。
301301
- `V2MCPFirstPlanningGate`:DevCodex v2 一期规划默认以 Intent-Gated Hosted Spec MCP / Codex-only 验证 MVP 为优先路线;未形成正式 CP1/CP2 方案包前,不得把 MongoDB、控制台、多租户自定义工作流、本地规则正文缓存或安装 `.github` / `CLAUDE.md` / `AGENTS.md` 副本作为一期默认范围。
302+
- `WorkspaceDataAbsorptionScopeGate`:用户要求“检查/吸纳最新问题、data 目录、仍需吸纳清单”时,必须扫描工作区 `.devcodex/*/data/` 下所有项目命名空间与 workspace data 台账,而不是只扫当前源码项目或 sticky activeProject;扫描结果须列出命中命名空间、台账类型、跳过原因和最终归属。
303+
- `FlowchartNodeExplanationGate`:正式流程图、生命周期图、Nxx 节点图、维护者流程页或需求/方案中的 Mermaid 流程图必须配套中文节点说明;每个非终止节点至少说明角色/触发、前置条件、处理动作、成功/失败出口和异常/回退,禁止只给图不解释。
304+
- `DocsSiteVisualAcceptanceGate`:官网、文档站、技术站或正式说明页的视觉/交互验收需覆盖主题集成、真实点击路径、异步动效绑定、`prefers-reduced-motion`、代码 token 对比度、终端 demo 可读范围、TOC inline code 展示和辅助导航层级;纯内容页可写 `N/A + skipReason`。
305+
- `OmissionOnlyReviewGate`:用户明确要求“只审查遗漏、上次没检查的、不要重复已吸纳/没必要项”时,审查范围必须切换为 omission-only;输出需包含用户指定轮次/范围、此前已覆盖集合、本轮新增覆盖集合、遗漏候选、排除理由和收敛状态,禁止把已确认吸纳或明确无必要项重新列入最终清单。
306+
- `MethodLevelLeakPressureProbe`:高风险资源泄漏修复、公开库/adapter/SDK、连接池/监听器/定时器/worker/cache 或 PE-12 命中项,除常规单测和发布验证外,需按项目现实评估是否追加公开方法级重复调用/生命周期压测探针;未触发时记录 `N/A + skipReason`,不得把所有低风险纯函数机械升级为方法级压测。
307+
- `V2FormalSolutionPackage`:DevCodex v2 一期进入正式规划、用户要求冻结方案或 ISSUE-027 残余尾项时,必须形成正式 CP1/CP2 方案包,覆盖架构、数据模型、MCP API contract、最小 instruction return、可见性分层、cache/signature/rollback、Codex-only 验证矩阵、Registry/Marketplace、私有维护站和 Mermaid 节点流程;未完成前不得宣告 v2 一期范围已收敛。
302308

303309
### 台账落点与关闭证据
304310

‎instructions/00-safety.instructions.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
applyTo: "**"
33
description: 安全底线与输出语言规则,定义 S01~S07、违规处理与不可豁免边界
44
priority: P2
5-
version: 1.11.19
5+
version: 1.11.20
66
---
77
# 安全底线规范(S01~S07)
88

‎instructions/01-common.instructions.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
applyTo: "**"
33
description: 通用规范总则,覆盖优先级、意图路由、Profile/active-root、宿主适配与治理总线
44
priority: P5
5-
version: 1.11.19
5+
version: 1.11.20
66
---
77
# 通用规范
88

‎instructions/01a-profile-loading.instructions.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
applyTo: "**"
33
description: Profile 加载、active-root 路径、目标项目识别与项目现实扩展的通用规范
44
priority: P5
5-
version: 1.11.19
5+
version: 1.11.20
66
---
77
# Profile 加载与项目现实扩展
88

‎instructions/01b-record-router.instructions.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
applyTo: "**"
33
description: 任务切换边界、RecordRouter 分流、Improvement Intake 与提交发布边界的通用规范
44
priority: P5
5-
version: 1.11.19
5+
version: 1.11.20
66
---
77
# 任务边界与 RecordRouter
88

0 commit comments

Comments
 (0)