Skip to content

Commit 1176468

Browse files
committed
fix(docs): freeze surface floors and align maintainer intro matrix
Raise docs-surface-inventory npm script floor to 113 and record the 2026-07-27 baseline fixture. Expand intro evidence columns for scripts, validation, delivery-honesty, and a five-host L0 honesty table so the maintainer site matches the live inventory denominator.
1 parent 3a9b1b9 commit 1176468

4 files changed

Lines changed: 60 additions & 5 deletions

File tree

‎changelogs/unreleased.md‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -5,6 +5,7 @@
55
66
## 当前未发布实现候选
77

8+
- **维护者站点×清单一致性(Fix-1 分母重冻)**:`docs-surface-inventory` npm scripts 下限 **≥113**、scripts/lib **≥102**;基线 `scripts/fixtures/docs-surface-baseline-20260727.json`;intro 能力证据表补 scripts/lib/validation/delivery-honesty 与五宿主 L0 摘要表。需求:`maintainer-site-docs-consistency`。
89
- **跨宿主 MCP runtime 闭包 + tools/call 烟雾 + hang 有界 + 模板真/重/路径列 + Track Q**:`CLAUDE_MCP_RUNTIME_SCRIPT_DEPS` 补 `executable-absorption-gates.js`;`mcpToolCallProbe` 进 Grok runtime verify;`test:mcp-runtime-closure` 挂 host-parity;ConfirmBinding mismatch nextStep;概况 §11/§12 真实性/去重;delivery/report 禁无路径短名表;memory Skill package vs activeRoot。需求:`跨宿主MCP卡死与Runtime依赖不全修复`(L4 真机仍待执行)。
910
- **Agent 交付诚实需求关账**:H0/H1(`8910712`)+ H2 ECR 对账报告;Stop gaps `stage-report-missing` / `progress-overclaim`;与 ecr-missing 串联。需求目录 closed。
1011
- **ECR 完成宣称强制闭环(ecr-missing)**:`classifyEcrClosure`;强完成/关需求无 ECR/DoD 证据 → Stop gap `ecr-missing`;`npm run test:ecr-closure` 挂 stop-gate 与 control-plane;report-dev 标明测试绿≠ECR。需求:`ECR与完成宣称强制闭环修复`。
Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
{
2+
"schemaVersion": "DocsSurfaceBaselineV1",
3+
"frozenAt": "2026-07-27",
4+
"requirement": "maintainer-site-docs-consistency",
5+
"note": "Live floors for assertDocsSurfaceInventory; counts from scanDocsSurfaceInventory on package root after MCP/honesty deliveries.",
6+
"exact": {
7+
"skills": 84,
8+
"workflows": 8,
9+
"mcpTools": 15,
10+
"hookEvents": 5,
11+
"prompts": 30,
12+
"instructionsMain": 15,
13+
"gateGroups": 51
14+
},
15+
"minima": {
16+
"hookRuntime": 26,
17+
"websiteMd": 156,
18+
"validationNodes": 83,
19+
"npmScripts": 113,
20+
"scriptsLib": 102
21+
},
22+
"requiredWorkflows": [
23+
"analyze",
24+
"audit",
25+
"chat",
26+
"dev",
27+
"fix",
28+
"other",
29+
"resume",
30+
"self-fix"
31+
],
32+
"requiredHookEvents": [
33+
"UserPromptSubmit",
34+
"PreToolUse",
35+
"PostToolUse",
36+
"PreCompact",
37+
"Stop"
38+
]
39+
}

‎scripts/lib/docs-surface-inventory.js‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -205,7 +205,8 @@ function assertDocsSurfaceInventory (inv) {
205205
if (inv.validationNodes < 83) {
206206
failures.push(`validation nodes expected >=83 got ${inv.validationNodes}`)
207207
}
208-
if (inv.npmScripts < 110) failures.push(`npm scripts expected >=110 got ${inv.npmScripts}`)
208+
// Floors frozen 2026-07-27 (maintainer-site-docs Fix-1): live after honesty/ecr/mcp deltas
209+
if (inv.npmScripts < 113) failures.push(`npm scripts expected >=113 got ${inv.npmScripts}`)
209210
if (inv.scriptsLib < 102) failures.push(`scripts/lib expected >=102 got ${inv.scriptsLib}`)
210211

211212
for (const [f, ok] of Object.entries(inv.processFiles || {})) {

‎website/docs/intro/index.md‎

Lines changed: 18 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -150,15 +150,29 @@ DevCodex 提供两个 Agent 入口:
150150

151151
| 能力面 | 声明(代码/矩阵) | 探针(可重复命令) | 真机 |
152152
|--------|-------------------|--------------------|------|
153-
| 8 workflows | `workflow-capabilities.json` | `npm run test:workflow-capabilities` | 不要求 |
153+
| 8 workflows(含 `other`,无 workflow id=`plan`) | `workflow-capabilities.json` | `npm run test:workflow-capabilities` | 不要求 |
154154
| Skills 84 | `plugin.json` + 磁盘 SKILL.md | `npm run test:docs-surface-inventory` | 不要求 |
155-
| MCP 15 tools | `mcp/*-server.js` | `npm run test:mcp-servers` 等 | 不要求 |
155+
| MCP 15 tools | `mcp/*-server.js` | `test:mcp-servers` / `test:mcp-runtime-closure` | 不要求 |
156156
| Hooks 五事件 | `hooks/devcodex.lifecycle.json` | `test:hooks-runtime` / 宿主契约 | 按宿主事件降级 |
157+
| Prompts 30 / Instructions 15 | `prompts/` · `instructions/` | `test:docs-surface-inventory` | 不要求 |
158+
| npm scripts ≥113 / scripts/lib ≥102 | `package.json` · `scripts/lib` | `test:docs-surface-inventory`(基线 `docs-surface-baseline-20260727.json`) | 不要求 |
159+
| validation nodes ≥83 / gate groups 51 | `validation-manifest` · gate-registry | 同上 | 不要求 |
157160
| 流程强制 Mutation/路径 | `process-enforcement` + HostEnforcementMatrix | `test:process-enforcement-e2e` · `test:stop-gate` | L4 非默认 DoD |
158-
| 五宿主 adapter | host-parity / doctor 分层 | `test:host-parity` · `devcodex doctor` | doctor 可选;人工会话非关站硬条件 |
161+
| 交付诚实 / ECR 门禁 | process-enforcement + stop-gate | `test:delivery-honesty` · `test:ecr-closure` | 不要求 |
162+
| 五宿主 adapter | host-parity / doctor 分层 | `test:host-parity` · `devcodex doctor` | doctor 可选;**native 就绪 ≠ 五宿主全绿** |
159163
| 公开文本 | `public-text-surfaces.json` | `test:public-text-integrity` | 不要求 |
160164

161-
Grok:**无 UPS inject**;Stop 为条件硬拦。Copilot:**CLI 与 IDE 能力不等价**(IDE 常为 instruction-fallback)。
165+
**宿主诚实(L0 摘要)**:
166+
167+
| 宿主 | PreTool 无 CP2 | Stop | UPS inject | 文档口径 |
168+
|------|----------------|------|------------|----------|
169+
| copilot | CLI hard-deny;**IDE fallback** | 事件支持时 | N/A | **CLI 与 IDE 分列** |
170+
| claude | hard-deny | stop-block | 可 inject | hook-enforced 上限 |
171+
| codex | hard-deny | stop-block | 可 context | 安装≠全事件硬拦 |
172+
| gemini | 能则 hard | 能则 stop | **N/A** | 禁止假 inject |
173+
| grok | PreTool deny | **条件** Stop | **N/A** | 禁止 UPS 假绿 |
174+
175+
Grok:**无 UPS inject**;Stop 为条件硬拦。Copilot:**CLI 与 IDE 能力不等价**(IDE 常为 instruction-fallback)。`devcodex doctor` 的 adapter match 与 native ready **分层**,不得把「adapter 5/5」写成「五宿主 CLI 全就绪」。
162176

163177
---
164178

0 commit comments

Comments
 (0)