feat: consolidate control assets under content root

Author: rockyshi1993

.audit-state/content-root-s15-codex-production-20260730.json

@@ -0,0 +1,102 @@
+{
+  "schemaVersion": "SkillRouteS15EvidenceV1",
+  "status": "PASS",
+  "probeRunId": "s15-codex-production-68bb76ae-7315-4273-b77b-d06bdf13233d",
+  "host": "codex",
+  "hostVariant": "codex-cli/exec-user-global-local-stdio",
+  "testedVersion": "codex-cli 0.145.0",
+  "protocolVersion": "2024-11-05",
+  "runtimeDigest": "1c727701a1ae4f3a8699a932066994098402744b99ed81ba2ec32f1929bf5d6a",
+  "hostAdapterDigest": "6ba881f7fd7eba6297e1fcb8c55da09abbd5f47a42661fb2269f38d05e014139",
+  "authorizationSource": "capability-pass",
+  "routeActivation": {
+    "requested": "unified",
+    "source": "source-default",
+    "effective": "unified",
+    "reason": "unified-default",
+    "hostEligibility": "PASS",
+    "capabilityRuntimeCurrent": true,
+    "capabilityAdapterCurrent": true,
+    "probeAuthorityUsed": false
+  },
+  "project": "s15-codex",
+  "contextEpoch": "ctx-75b75233-2b41-4c53-a260-a9f9108c03d7",
+  "turnBinding": "turn-82fd7e7a1f4cb26569f59ce22b2a13a447dc58fd",
+  "catalogDigest": "133df96e2aa7aa402b915a760c96d2eecd184a452211c188dcb4448452ae24d5",
+  "catalogPages": 6,
+  "candidateCount": 76,
+  "decisionSkillId": "workspace-s15-probe",
+  "decisionDigest": "34d888ab11e42f55c2ad9b344d3884478ac7c55625860422ef38d6dacfc3a569",
+  "planDigest": "e93c5115c7cd0e9916c0a1ff3bebed6fed531df70ea4188d70fc595b1eae6547",
+  "planGeneration": 1,
+  "activatedConditionIds": [
+    "test-validation"
+  ],
+  "requiredStageIds": [
+    "entry",
+    "execution:test-validation",
+    "closeout"
+  ],
+  "loadedStageIds": [
+    "entry",
+    "execution:test-validation",
+    "closeout"
+  ],
+  "processComplete": true,
+  "bodyDigest": "2057dfd1a53010720efa6d18ca2bcec1371431c928d2767fb86afc39f82c2e3e",
+  "marker": "S15_BODY_3D05FD2B-92C1-4979-8CC2-E965680191E0",
+  "markerDigest": "5e205a7df655f5583586665053e3907ca03150c99b8122df7defd79ec2abfc91",
+  "contextAcquisition": {
+    "source": "host-hooks",
+    "prewritten": false,
+    "receiptStatus": "relevant-complete",
+    "observedTools": [
+      "devcodex-profile/profile_context_plan",
+      "devcodex-profile/profile_load",
+      "devcodex-memory/memory_status",
+      "devcodex-profile/skill_route",
+      "devcodex-profile/skill_route",
+      "devcodex-profile/skill_route",
+      "devcodex-profile/skill_route",
+      "devcodex-profile/skill_route",
+      "devcodex-profile/skill_route",
+      "devcodex-profile/skill_route",
+      "devcodex-profile/skill_route",
+      "devcodex-profile/skill_route",
+      "devcodex-profile/skill_route",
+      "devcodex-profile/skill_route",
+      "devcodex-profile/skill_route"
+    ]
+  },
+  "observedOps": [
+    "profile_context_plan",
+    "profile_load",
+    "memory_status",
+    "catalog",
+    "commit",
+    "conditional-replan",
+    "load_stage",
+    "status"
+  ],
+  "retirementAnomalies": {
+    "legacyFallback": 0,
+    "doubleBody": 0,
+    "crossRoot": 0,
+    "stateCorruption": 0,
+    "missingStage": 0,
+    "missingCloseout": 0
+  },
+  "transport": {
+    "kind": "local-stdio",
+    "servers": [
+      "devcodex-profile",
+      "devcodex-memory"
+    ],
+    "networkListener": false,
+    "longRunningServiceStarted": false,
+    "childExitedWithHost": true
+  },
+  "startedAt": "2026-07-30T10:01:51.233Z",
+  "completedAt": "2026-07-30T10:04:23.337Z",
+  "evidenceDigest": "ce8fb9c145934bb59f2ce1f5d253a21fb9ba33218a728d4b23b7a0c45fe2cc53"
+}

.gitignore

@@ -33,7 +33,14 @@ website/*
 .tmp/
 .tmp/**
 
+# Generated npm compatibility projection; tracked authoring source lives under content/.
+/instructions.md
+/instructions/**/*.md
+/prompts/**/*.md
+/skills/*/SKILL.md
+/skills/*/intent.json
+/content-source/
+
 source-root-deployment-backup-*/
 tmp-validate*.txt
 package.json.tmp-test
-

README.md

@@ -230,7 +230,7 @@ npm run test:skill-route
 npm run global-adapters:apply
 ```
 
-源码仓中的 instruction、prompt 与 Skill Markdown 维护入口统一位于 `content-source/`。修改 authoring source 后先运行 `npm run check:control-content`；需要更新既有 delivery 路径时显式运行 `npm run generate:control-content`。运行时和 npm 安装包继续读取原路径，不读取或携带 `content-source/`。
+源码仓中的 instruction、prompt 与 Skill Markdown 唯一维护入口统一位于 `content/`。修改 canonical content 后先运行 `npm run check:control-content`；仓库兼容路径由 `npm run generate:control-content` 确定性投影，npm 打包则通过带锁和回执的 prepack/postpack 临时投影旧 delivery 路径。运行时和 npm 安装包继续读取 standalone delivery，不读取或携带 `content/`。
 
 维护者文档站（需本机已有完整 `website/`）：
 

RULES.md

@@ -61,8 +61,8 @@ DevCodex 同时支持五宿主的用户级加载路径，规则语义保持一
 
 ## 控制面 Markdown 维护
 
-- 135 个 instruction/prompt/Skill Markdown 的唯一手写源位于 `content-source/`。
-- `instructions.md`、`instructions/`、`prompts/`、`skills/*/SKILL.md` 是确定性 delivery，不直接双写。
+- 135 个 instruction/prompt/Skill Markdown 的唯一手写源位于 `content/`。
+- `instructions.md`、`instructions/`、`prompts/`、`skills/*/SKILL.md` 是确定性兼容 delivery，不直接双写；发布时由带锁和回执的 projection 事务临时物化。
 - shared include 只在构建期展开；禁止 runtime include、嵌套 include、symlink 和路径穿越。
 - 提交前必须通过 `npm run test:control-content`；prepack 只校验，不自动改写，npm 包不含 authoring source。
 

changelogs/releases/v1.5.0.md

@@ -85,9 +85,9 @@ npx @vextjs/devcodex status
 
 ## 🔗 相关资源
 
-- [需求模板](../../prompts/requirement.prompt.md)
-- [产物路径规范](../../instructions/02-output-paths.instructions.md)
-- [开发工作流规则](../../instructions/10-dev.instructions.md)
+- [需求模板](../../content/prompts/requirement.prompt.md)
+- [产物路径规范](../../content/instructions/02-output-paths.instructions.md)
+- [开发工作流规则](../../content/instructions/10-dev.instructions.md)
 
 ---
 
@@ -126,4 +126,3 @@ npx @vextjs/devcodex status
 
 - `instructions/13-analyze.instructions.md` — 新增「代码实现验证约束」节：当分析结论依赖代码事实时，强制先 grep/glob 探索实际代码，再与计划文档比对；禁止以计划路径做存在性替代验证；触发由 AI 自检而非用户措辞决定（防止架构偏差被误判为未实现）
 - `instructions/14-self-fix.instructions.md` — 自动级修复验证 V1~V6 升级为 V1~V7，新增 V7「规则触发条件写作检查」：约束规范本身的写作方式，触发条件主语必须是 AI 内部判断，禁止以用户意图/措辞为触发主语（防止关键词依赖反模式复现）
-

changelogs/unreleased.md

@@ -5,6 +5,7 @@
 
 ## 当前未发布实现候选
 - **控制面规范资产去重与确定性组合**：新增 `content-source/` 作为 135 个 instruction/prompt/Skill Markdown 的唯一手写根，保留既有 tracked delivery 路径；22 个 build-time 单层 shared fragments 覆盖 58 个消费点，26 exact + 4 near-section 候选全部有 disposition。新增 zero-write materializer、受控 extraction、重复分析、compatibility mirror、validation DAG invariant 与 prepack/package 排除门禁；修复 folded/literal frontmatter 解析和纯 `>`/`|` intent false-green，83 active intent 全部重生并通过 semantic quality。
+- **在途缺陷绑定与渐进路由恢复**：新增 `InFlightIssueRequirementBindingGate`，禁止用 PI/PF 代替未闭环需求修订；`skill_route` 增加受约束的 `rebind` 操作，在 ContextRead 漂移后保持原 skill 决策、条件和兼容阶段进度，并用宿主会话身份隔离 Stop 约束。
 - **工作区 Skill 意图结构化与渐进路由（B4 收口）**：83 个 active Skill 使用 `SkillIntentV1`；运行时构建 W + managed G 动态快照，经单一 `skill_route` MCP Tool 执行 catalog/commit/load_stage/status、0/1 自由选择、依赖闭包、冲突与预算校验、分阶段正文加载、条件重规划、幂等重放、会话隔离恢复和有锁 GC。统一路由现为 Claude/Codex/Copilot/Gemini/Grok 五宿主唯一源码默认，能力证据仅用于发布后观测，不再切换模式或阻塞完成；旧 `WorkspaceSkillAutoMatch` / `WorkspaceSkillIntent` 生命周期分支、CLI 入口和验证节点退出活跃闭包。修复跨会话 Stop 读取共享状态导致的 `test` 误触发，并把否定、截图、日志、报告、诊断性提及排除在显式调用外；多项目工作区目标未绑定时改为 `SkillRouteBootstrapPendingV1`，只接受 observed ContextRead plan 绑定现有项目，禁止用 workspace basename 创建合成 namespace。MCP 为宿主按需启动的本地 stdio 子进程，无端口、HTTP、远程服务或常驻 daemon。W 在每轮动态发现；用户原生 `AGENTS.md` / `CLAUDE.md` / `SKILL.md` 与个人 Skill 保持宿主所有权，同名不构成清理或覆盖权限。
 - **公共 README 校验迁移**：以严格 `PublicReadmeContractV1` 替代要求公共 README 罗列内部 Gate/Skill/控制面术语的历史断言；README/client/release/workflow/brand/turn/execution consumers 共用该边界，并用损坏核心安装路径的负向探针防止宽松绕过。
 - **全局验证 skill `skill-load-verify`**：触发「验证技能 / skill load verify」；用户可见仅固定句 `SKILL-LOAD-VERIFY-OK`；Skill 规模 85→**86**（83 active + 3 gray）。

codex/hooks.json

@@ -6,7 +6,8 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node -e \"let d=process.cwd(),fs=require('fs'),p=require('path');while(true){const f=p.join(d,'.codex','hooks','_runtime','lifecycle.cjs');if(fs.existsSync(f)&&(fs.existsSync(p.join(d,'.devcodex'))||fs.existsSync(p.join(d,'package.json')))){require(f);break}const n=p.dirname(d);if(n===d){process.exit(0)}d=n}\""
+            "command": "node -e \"let d=process.cwd(),fs=require('fs'),p=require('path');while(true){const f=p.join(d,'.codex','hooks','_runtime','lifecycle.cjs');if(fs.existsSync(f)&&(fs.existsSync(p.join(d,'.devcodex'))||fs.existsSync(p.join(d,'package.json')))){require(f);break}const n=p.dirname(d);if(n===d){process.exit(0)}d=n}\"",
+            "timeout": 30
           }
         ]
       }
@@ -16,7 +17,8 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node -e \"let d=process.cwd(),fs=require('fs'),p=require('path');while(true){const f=p.join(d,'.codex','hooks','_runtime','lifecycle.cjs');if(fs.existsSync(f)&&(fs.existsSync(p.join(d,'.devcodex'))||fs.existsSync(p.join(d,'package.json')))){require(f);break}const n=p.dirname(d);if(n===d){process.exit(0)}d=n}\""
+            "command": "node -e \"let d=process.cwd(),fs=require('fs'),p=require('path');while(true){const f=p.join(d,'.codex','hooks','_runtime','lifecycle.cjs');if(fs.existsSync(f)&&(fs.existsSync(p.join(d,'.devcodex'))||fs.existsSync(p.join(d,'package.json')))){require(f);break}const n=p.dirname(d);if(n===d){process.exit(0)}d=n}\"",
+            "timeout": 30
           }
         ]
       }
@@ -27,7 +29,8 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node -e \"let d=process.cwd(),fs=require('fs'),p=require('path');while(true){const f=p.join(d,'.codex','hooks','_runtime','lifecycle.cjs');if(fs.existsSync(f)&&(fs.existsSync(p.join(d,'.devcodex'))||fs.existsSync(p.join(d,'package.json')))){require(f);break}const n=p.dirname(d);if(n===d){process.exit(0)}d=n}\""
+            "command": "node -e \"let d=process.cwd(),fs=require('fs'),p=require('path');while(true){const f=p.join(d,'.codex','hooks','_runtime','lifecycle.cjs');if(fs.existsSync(f)&&(fs.existsSync(p.join(d,'.devcodex'))||fs.existsSync(p.join(d,'package.json')))){require(f);break}const n=p.dirname(d);if(n===d){process.exit(0)}d=n}\"",
+            "timeout": 30
           }
         ]
       }
@@ -38,7 +41,8 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node -e \"let d=process.cwd(),fs=require('fs'),p=require('path');while(true){const f=p.join(d,'.codex','hooks','_runtime','lifecycle.cjs');if(fs.existsSync(f)&&(fs.existsSync(p.join(d,'.devcodex'))||fs.existsSync(p.join(d,'package.json')))){require(f);break}const n=p.dirname(d);if(n===d){process.exit(0)}d=n}\""
+            "command": "node -e \"let d=process.cwd(),fs=require('fs'),p=require('path');while(true){const f=p.join(d,'.codex','hooks','_runtime','lifecycle.cjs');if(fs.existsSync(f)&&(fs.existsSync(p.join(d,'.devcodex'))||fs.existsSync(p.join(d,'package.json')))){require(f);break}const n=p.dirname(d);if(n===d){process.exit(0)}d=n}\"",
+            "timeout": 30
           }
         ]
       }
@@ -48,7 +52,8 @@
         "hooks": [
           {
             "type": "command",
-            "command": "node -e \"let d=process.cwd(),fs=require('fs'),p=require('path');while(true){const f=p.join(d,'.codex','hooks','_runtime','lifecycle.cjs');if(fs.existsSync(f)&&(fs.existsSync(p.join(d,'.devcodex'))||fs.existsSync(p.join(d,'package.json')))){require(f);break}const n=p.dirname(d);if(n===d){process.exit(0)}d=n}\""
+            "command": "node -e \"let d=process.cwd(),fs=require('fs'),p=require('path');while(true){const f=p.join(d,'.codex','hooks','_runtime','lifecycle.cjs');if(fs.existsSync(f)&&(fs.existsSync(p.join(d,'.devcodex'))||fs.existsSync(p.join(d,'package.json')))){require(f);break}const n=p.dirname(d);if(n===d){process.exit(0)}d=n}\"",
+            "timeout": 30
           }
         ]
       }