frontend-project-context 1.6.0 → 1.7.0

package/docs/README.md

@@ -48,7 +48,7 @@
 
 10. [14-FORMAL-RELEASE-READINESS.md](./14-FORMAL-RELEASE-READINESS.md)
 
-    记录 `1.0.0` 正式发布、`1.0.1` README/metadata patch 与 `1.2.0` AI Exchange Boundary 发布：包边界、项目接入、CI、迁移、验收、registry 完整性和不伪造公共仓库链接的决定。
+    记录 `1.0.0`、`1.0.1`、`1.2.0`、`1.3.x` 与 `1.6.0` 正式发布：包边界、项目接入、CI、迁移、验收、registry 完整性和不伪造公共仓库链接的决定。
 
 11. [15-SOURCE-LIFECYCLE-CLOSURE-DESIGN.md](./15-SOURCE-LIFECYCLE-CLOSURE-DESIGN.md)
 
@@ -80,22 +80,38 @@
 
 18. [22-PHASE-C-TARGET-UPGRADE-PROTOCOL-DESIGN.md](./22-PHASE-C-TARGET-UPGRADE-PROTOCOL-DESIGN.md)
 
-    冻结并记录 `1.6.0` Phase C 本地实现：只读 `upgrade-check/upgrade-plan`、默认 preview/显式写入的 `upgrade-apply`、Migration Manifest schema 2、三份升级工件 schema 1、单步 digest/CAS 收敛、兼容/回滚矩阵与 A-101 至 A-114；当前 120/120 通过，已授权进入公开 npm 发布候选流程，真实目标项目验收仍未授权。
+    冻结并记录 `1.6.0` Phase C 的实现与正式发布：只读 `upgrade-check/upgrade-plan`、默认 preview/显式写入的 `upgrade-apply`、Migration Manifest schema 2、三份升级工件 schema 1、单步 digest/CAS 收敛、兼容/回滚矩阵与 A-101 至 A-114；120/120、公共 npm 与 registry 独立复验均已通过，真实目标项目验收仍未授权。
+
+19. [23-ADAPTIVE-BOUNDED-TASK-CONTEXT-DESIGN.md](./23-ADAPTIVE-BOUNDED-TASK-CONTEXT-DESIGN.md)
+
+    用反证方式冻结并记录 `1.7.0` 初始本地实现与历史复验；当前 docs/26 统一修复已在其上完成，完整回归增至 194/194。历史真实 Host/Provider 复验仍为完整 8/8、自适应 7/8，新的复验与发布均未授权。
+
+20. [24-A130-REAL-HOST-TARGET-PROJECT-COMPARISON.md](./24-A130-REAL-HOST-TARGET-PROJECT-COMPARISON.md)
+
+    记录 `dtg-tmc-pc` 上首次对照及 A-130R 后的成对复验。复验中自适应首包降至 5,283 字节，但质量仍为 7/8，对照完整臂为 8/8，且 tokens、命令数与耗时均未改善，故 A-130 严格失败；原目标仓库始终未修改。
+
+21. [25-REAL-PROJECT-SOURCE-OF-TRUTH-MAINTENANCE-DESIGN.md](./25-REAL-PROJECT-SOURCE-OF-TRUTH-MAINTENANCE-DESIGN.md)
+
+    冻结真实项目全量应用下的真源维护设计，并完成隔离协议 fixture。裁定失败后的机器闭环已由 docs/26 升级为 Truth Reconciliation Input/Review Bundle schema 2、previous Review 绑定与可验证终态；A-144、Sidecar 和真实项目写入仍未授权。
+
+22. [26-A130-QUALITY-CLOSURE-AND-ADAPTIVE-DELIVERY-REPAIR-DESIGN.md](./26-A130-QUALITY-CLOSURE-AND-ADAPTIVE-DELIVERY-REPAIR-DESIGN.md)
+
+    冻结并完成 A-130 与 Truth Resolution Closure 本地统一修复：A-130D-01 至 A-130D-31 处理评测、scope/lineage、严格 schema、交付和计量；A-130T-01 至 A-130T-10 处理上一 Review 绑定、人工裁定、Contract/外部代码修复分流和机器可验证终态。全量 194/194 通过；Provider 复验与发布仍未授权。
 
 ## 历史证据
 
-19. [06-HISTORICAL-PROTOTYPE.md](./06-HISTORICAL-PROTOTYPE.md)
-20. [07-REAL-TASK-EVIDENCE.md](./07-REAL-TASK-EVIDENCE.md)
+23. [06-HISTORICAL-PROTOTYPE.md](./06-HISTORICAL-PROTOTYPE.md)
+24. [07-REAL-TASK-EVIDENCE.md](./07-REAL-TASK-EVIDENCE.md)
 
 历史文档只解释为什么不再建设任务执行 Harness。它们不是程序需求、工作流或授权来源。
 
 ## Beta 证据
 
-21. [09-B0-DTG-TMC-MOBILE.md](./09-B0-DTG-TMC-MOBILE.md)
+25. [09-B0-DTG-TMC-MOBILE.md](./09-B0-DTG-TMC-MOBILE.md)
 
    记录首次真实项目只读接入、通用修补和同项目回归。报告中的历史“下一步”不再产生新需求。
 
-22. [10-B0-DTG-TMC-PC.md](./10-B0-DTG-TMC-PC.md)
+26. [10-B0-DTG-TMC-PC.md](./10-B0-DTG-TMC-PC.md)
 
    记录第二个真实项目只读接入和跨项目对比：核心链路与首轮通用修补再次通过。产品宪法已经停止继续寻找项目和扩充技术发现白名单。
 

package/docs/USER-AND-AI-OPERATION-MANUAL.md

@@ -1,6 +1,6 @@
 # Frontend Project Context 操作手册
 
-> 适用版本：`frontend-project-context@1.3.1`
+> 适用版本：`frontend-project-context@1.7.0` 发布候选
 >
 > 适用对象：项目维护者、开发者、使用 Codex / Claude / Cursor / 其他 Coding Agent 的团队，以及集成该 CLI 的 AI Host Agent。
 >
@@ -101,7 +101,7 @@ AI 可以提取事实、整理文字、去重、建议 scope/override、生成 p
 固定为项目开发依赖，使本地与 CI 使用同一版本：
 
 ```bash
-npm install --save-dev frontend-project-context@1.3.1
+npm install --save-dev frontend-project-context@1.7.0
 ```
 
 建议在 `package.json` 中提供稳定入口：
@@ -120,18 +120,35 @@ npm install --save-dev frontend-project-context@1.3.1
 试运行：
 
 ```bash
-npx project-context --help
-npx project-context capabilities --project . --json
+npm exec --offline -- project-context --help
+npm exec --offline -- project-context capabilities --project . --json
+npm exec --offline -- project-context status --project . --json
 ```
 
+所有正式命令都通过 `npm exec --offline -- project-context` 或上面的项目脚本调用。`--offline` 会在本地依赖缺失时失败封闭，不能退回 registry 下载无关的同名 `project-context` 包。持久初始化必须发生在精确版本安装之后，避免后续补装依赖改变已登记的 `package.json` source digest。
+
 `capabilities` 在项目未初始化时也可用，适合 AI Host 先查询当前包版本、schema、支持的 action kind 和永久边界。
 
+`1.7.0` 默认以中文生成 AI Entry 和 discovery 候选的 `statement`，便于中文团队直接审查项目语义；稳定 ID、subject、kind、CLI 命令、JSON 字段、枚举和 marker 继续使用英文。AI Entry renderer 3 同时固定离线项目本地 CLI 入口；既有 renderer 1/2 不会被静默覆盖，升级后会报告 stale，必须先预览并获得明确写入授权，再 republish 为 renderer 3 中文入口。
+
+### 4.3 全新初始化不是普通升级
+
+再次运行 `setup` 会复用现有 store，不会 reset，也不会把已经批准的英文 statement 自动翻译成中文。确需使用正式包全新初始化时，必须先：
+
+1. 导出并人工核对现有 Contract 中的 policy、validation-description、manual source 和批准决定；
+2. 使用当前所有权记录预览并显式执行 `remove-entry`，只移除受管区域，保留 `AGENTS.md` 其余人工内容；
+3. 由人明确授权外部工具精确清理可丢弃的 `.project-context`，确认 `status.initialization.state=uninitialized`；
+4. 先安装精确版本，再按第 5 节重新 setup、审查、录入和批准被保留的人工规则；
+5. 如果 `AGENTS.md` 同时是 active source，发布新 AI Entry 后继续完成预期的 source review、accept 和受影响 item 重新批准，直到 `check/status` 为 clean。
+
+工具没有自动 reset 命令，也不会把删除 store、翻译批准规则或接受 source drift 伪装成普通升级。
+
 ## 5. 首次接入 SOP
 
 ### 第 1 步：只读预览初始化结果
 
 ```bash
-npx project-context setup \
+npm exec --offline -- project-context setup \
   --project . \
   --id my-project \
   --name "My Project" \
@@ -153,7 +170,7 @@ npx project-context setup \
 确认项目 ID、名称和 proposal 路径后执行：
 
 ```bash
-npx project-context setup \
+npm exec --offline -- project-context setup \
   --project . \
   --id my-project \
   --name "My Project" \
@@ -188,7 +205,7 @@ AI 应：
 先预览，再在对象无误后重复同一命令并加 `--write`：
 
 ```bash
-npx project-context register \
+npm exec --offline -- project-context register \
   --project . \
   --id source.package \
   --kind file \
@@ -198,7 +215,7 @@ npx project-context register \
 创建合同项 proposal：
 
 ```bash
-npx project-context propose \
+npm exec --offline -- project-context propose \
   --project . \
   --id policy.ui-copy \
   --kind policy \
@@ -258,7 +275,7 @@ AI 必须先展示：
 ### 第 6 步：批准精确 ID
 
 ```bash
-npx project-context approve \
+npm exec --offline -- project-context approve \
   --project . \
   --proposal .project-context/policy.ui-copy.proposal.json \
   --ids policy.ui-copy \
@@ -272,7 +289,7 @@ npx project-context approve \
 为目标路径生成临时上下文：
 
 ```bash
-npx project-context context \
+npm exec --offline -- project-context context \
   --project . \
   --path src \
   --locale zh-CN
@@ -281,7 +298,7 @@ npx project-context context \
 生成 AGENTS 投影：
 
 ```bash
-npx project-context publish \
+npm exec --offline -- project-context publish \
   --project . \
   --target agents \
   --output src/AGENTS.md \
@@ -291,7 +308,7 @@ npx project-context publish \
 或生成 Ruler 投影：
 
 ```bash
-npx project-context publish \
+npm exec --offline -- project-context publish \
   --project . \
   --target ruler \
   --output .ruler/project-context.md \
@@ -305,7 +322,7 @@ npx project-context publish \
 ### 第 8 步：检查并提交
 
 ```bash
-npx project-context check --project .
+npm exec --offline -- project-context check --project .
 ```
 
 `check` clean 后，提交三个 store 和团队明确采用的受管投影。proposal 通常不提交。
@@ -315,7 +332,7 @@ npx project-context check --project .
 一般任务不需要重新扫描整个仓库。先根据任务的真实修改目标生成 Context Bundle：
 
 ```bash
-npx project-context context \
+npm exec --offline -- project-context context \
   --project . \
   --path src/features/order \
   --path src/shared/request.ts \
@@ -325,6 +342,26 @@ npx project-context context \
 
 `--task` 是当次临时约束，只会进入这份 bundle，不会写回 Contract，也不会扩大开发权限。
 
+`1.7.0` 本地实现也支持由 Host 提供 schema 1 Context Query，把原始任务文本、target paths、topics、changed paths、三个 snapshot 和软/硬预算一次传入：
+
+```bash
+npm exec --offline -- project-context context-query \
+  --project . \
+  --input .project-context/context-query.json \
+  --json
+```
+
+`--json` 用于 Host 审查健康、deferred 目录与字节计量；真正传给模型时使用同一查询的 `--prompt`，不要把整份审查 JSON 当成模型上下文。小 Contract 中完整 Context 更小时会自动回退到完整投影。普通局部任务使用 `initial` + `snapshot-and-signal-bound`；证据不足时把前一份 bundle 保存后，以 `expanded` query 配合 `--previous` 增量扩展；要求绝对当前新鲜度时使用 `strict-current` 或 `complete`。policy/validation 不因软预算被截断，硬预算不足会返回 blocked。
+
+初始化、覆盖规则变化或显式审计时运行：
+
+```bash
+npm exec --offline -- project-context coverage-audit --project . --json
+npm exec --offline -- project-context index-context --project . --json
+```
+
+`coverage-audit` 只证明已批准 coverage profile 的声明范围；不会输出“全部项目真源已发现”。`index-context` 默认只预览，从 Contract 确定性重建；只有人明确需要缓存时才加 `--write`，生成的 `.project-context/derived/routing-index.json` 不是 store 或真源。
+
 推荐把下面四类信息一起给外部 Coding Agent：
 
 1. 当次任务目标和验收标准；
@@ -335,7 +372,7 @@ npx project-context context \
 完成业务修改后，由外部 Agent、IDE 或 CI 把真实 changed paths 传给 `sync`：
 
 ```bash
-npx project-context sync \
+npm exec --offline -- project-context sync \
   --project . \
   --changed-path src/features/order/detail.ts \
   --changed-path src/shared/request.ts \
@@ -361,7 +398,7 @@ check / sync
 ### 7.1 先一次汇总变化
 
 ```bash
-npx project-context sync --project . --json
+npm exec --offline -- project-context sync --project . --json
 ```
 
 AI 应先交付变化清单，不应直接写入：
@@ -376,7 +413,7 @@ AI 应先交付变化清单，不应直接写入：
 ### 7.2 精确审查单个来源
 
 ```bash
-npx project-context review-source \
+npm exec --offline -- project-context review-source \
   --project . \
   --id source.package \
   --json
@@ -387,7 +424,7 @@ npx project-context review-source \
 只有人确认 new digest 和完整 affected item IDs 后，才预览：
 
 ```bash
-npx project-context accept-source-change \
+npm exec --offline -- project-context accept-source-change \
   --project . \
   --id source.package \
   --expected-digest sha256:NEW_DIGEST \
@@ -401,7 +438,7 @@ npx project-context accept-source-change \
 修订前必须使用当前 item digest：
 
 ```bash
-npx project-context revise \
+npm exec --offline -- project-context revise \
   --project . \
   --id policy.ui-copy \
   --expected-item-digest sha256:CURRENT_ITEM_DIGEST \
@@ -417,7 +454,7 @@ npx project-context revise \
 废弃 item：
 
 ```bash
-npx project-context deprecate \
+npm exec --offline -- project-context deprecate \
   --project . \
   --id policy.ui-copy \
   --expected-item-digest sha256:CURRENT_ITEM_DIGEST \
@@ -428,7 +465,7 @@ npx project-context deprecate \
 重新批准 pending item：
 
 ```bash
-npx project-context approve \
+npm exec --offline -- project-context approve \
   --project . \
   --pending \
   --ids fact.node-version validation.check \
@@ -465,10 +502,10 @@ npx project-context approve \
 ### 8.1 查询协议能力
 
 ```bash
-npx project-context capabilities --project . --json
+npm exec --offline -- project-context capabilities --project . --json
 ```
 
-`1.3.1` 支持八类 Action Plan action：
+`1.7.0` 支持十类 Action Plan action：
 
 - `register-source`；
 - `propose-item`；
@@ -477,7 +514,9 @@ npx project-context capabilities --project . --json
 - `deprecate-item`；
 - `deprecate-source`；
 - `request-item-approval`；
-- `publish-projection`。
+- `publish-projection`；
+- `publish-ai-entry`；
+- `remove-ai-entry`。
 
 ### 8.2 AI 生成无权限 Action Plan
 
@@ -488,7 +527,7 @@ Action Plan 中不得包含 Provider 调用、shell、Git、业务代码写入
 ### 8.3 只读预检
 
 ```bash
-npx project-context preflight \
+npm exec --offline -- project-context preflight \
   --project . \
   --plan .project-context/action-plan.json \
   --json
@@ -542,7 +581,7 @@ Plan 是宿主提供的外部任务工件，不是 Contract，不授予执行权
 首阶段：
 
 ```bash
-npx project-context stage-context \
+npm exec --offline -- project-context stage-context \
   --project . \
   --plan task-context-plan.json \
   --stage stage-understand \
@@ -553,7 +592,7 @@ npx project-context stage-context \
 后续阶段：
 
 ```bash
-npx project-context stage-context \
+npm exec --offline -- project-context stage-context \
   --project . \
   --plan task-context-plan.json \
   --stage stage-render \
@@ -592,7 +631,7 @@ Task Context Plan
 ### 9.4 合并前只读审查
 
 ```bash
-npx project-context integration-review \
+npm exec --offline -- project-context integration-review \
   --project . \
   --plan task-context-plan.json \
   --receipt stage-understand.receipt.json \
@@ -611,7 +650,7 @@ npx project-context integration-review \
 ### 10.1 本地只读看板
 
 ```bash
-npx project-context dashboard --project . > project-context-dashboard.html
+npm exec --offline -- project-context dashboard --project . > project-context-dashboard.html
 ```
 
 Dashboard 是 stdout 生成的自包含离线 HTML，不会自动打开浏览器，不会修改 Contract。HTML 通常不提交。
@@ -669,6 +708,7 @@ npm run context:check
 | 现象 | 原因 | 处理 |
 | --- | --- | --- |
 | 命令显示了结果但文件没变 | 没有 `--write`，只做了 preview | 审查预览后，对同一条命令显式加 `--write` |
+| 本地没有 `project-context` 命令 | 精确开发依赖尚未安装，或不在 npm script 环境 | 先经人授权安装 `frontend-project-context@1.7.0`，再使用 `npm exec --offline -- project-context`；不要运行 `npx project-context` |
 | `source-changed` | 来源内容与上次人工确认 digest 不同 | `sync` → `review-source` → 人确认 → `accept-source-change` → revise/deprecate/reapprove |
 | `source-missing` | 已登记本地来源不存在 | 先判断是移动、暂时缺失还是永久退役；不自动修复 |
 | `projection-ownership-conflict` | 受管投影被人或其他工具修改，或目标本就不属于本工具 | 保留现有文件，人判断合并、换路径或重新建立 ownership；不强制覆盖 |
@@ -777,6 +817,9 @@ Receipt 只记录阶段证据，不代表人已验收、合并或批准长期规
 | `propose` | 创建待审的合同项 | 仅保存 proposal 时 `--write` |
 | `approve` | 批准 proposal 或 pending 中的精确 ID | 仅显式 `--write` |
 | `context` | 按路径/任务编译最小上下文 | 否 |
+| `context-query` | 按任务编译自适应证据闭包、健康、新鲜度和预算 | 否 |
+| `coverage-audit` | 审计声明范围内的登记覆盖 | 否 |
+| `index-context` | 构建可删除的派生路由索引 | 仅显式 `--write` |
 | `publish` | 生成受管 AGENTS 或 Ruler 投影 | 仅显式 `--write` |
 | `check` | 检测来源、合同和投影漂移 | 否 |
 | `sync` | 聚合变化、影响集、路径信号和维护工作单元 | 否 |
@@ -793,5 +836,5 @@ Receipt 只记录阶段证据，不代表人已验收、合并或批准长期规
 完整且以当前安装版本为准的语法，始终通过以下命令查看：
 
 ```bash
-npx project-context --help
+npm exec --offline -- project-context --help
 ```

package/examples/README.md

@@ -33,9 +33,9 @@ npm run context:preflight -- --plan .project-context/action-plan.json --json
 采用分阶段上下文协议时，宿主必须把每份前序 Stage Receipt 与生成该 receipt 的 Stage Context Bundle 成对传入：
 
 ```bash
-npx project-context stage-context --project . --plan task-context-plan.json --stage stage-render \
+npm exec --offline -- project-context stage-context --project . --plan task-context-plan.json --stage stage-render \
   --receipt stage-understand.receipt.json --receipt-bundle stage-understand.bundle.json --json
-npx project-context integration-review --project . --plan task-context-plan.json \
+npm exec --offline -- project-context integration-review --project . --plan task-context-plan.json \
   --receipt stage-understand.receipt.json --receipt-bundle stage-understand.bundle.json --json
 ```
 
@@ -53,8 +53,8 @@ Host 在产品边界外把依赖和 lockfile 固定到精确目标版本后，
 
 ```bash
 npm run context:upgrade-check -- --from-version 1.5.0 --json
-npx project-context upgrade-plan --project . --assessment .project-context/upgrade-assessment.json --json
-npx project-context upgrade-apply --project . --plan .project-context/migration-plan.json --json
+npm exec --offline -- project-context upgrade-plan --project . --assessment .project-context/upgrade-assessment.json --json
+npm exec --offline -- project-context upgrade-apply --project . --plan .project-context/migration-plan.json --json
 ```
 
 只有人审查精确 plan 后才可为最后一条命令增加 `--write`。每次只执行一个产品自有迁移单元；包管理器、Git、项目测试、独立新窗口复核和临时工件清理由 Host 负责。

package/examples/package.json

@@ -14,6 +14,6 @@
     "context:upgrade-check": "project-context upgrade-check --project ."
   },
   "devDependencies": {
-    "frontend-project-context": "1.6.0"
+    "frontend-project-context": "1.7.0"
   }
 }

package/migration-manifest.json

@@ -22,19 +22,26 @@
   ],
   "consumerChanges": {
     "actionPlan": {"reason": "Action Plan schema 1 and 2 readers remain compatible; writers remain schema 2.", "state": "preserve"},
-    "capabilities": {"reason": "Consumers must branch on capabilities schema 4 and exchange protocol 4.", "state": "regenerate"},
+    "adaptiveContextBundle": {"reason": "Schema 1 Adaptive Context Bundles lack task lineage and strict withheld-delivery semantics; regenerate as schema 2.", "state": "regenerate"},
+    "capabilities": {"reason": "Consumers must branch on capabilities schema 7 and exchange protocol 7.", "state": "regenerate"},
+    "contextQuery": {"reason": "Context Query schema 1 is short-lived and must use current snapshots.", "state": "regenerate"},
+    "coverageAudit": {"reason": "Coverage Audit schema 1 is derived from the current Contract and filesystem evidence.", "state": "regenerate"},
     "evidenceBundle": {"reason": "Evidence Bundle schema 1 remains readable and separate from upgrade results.", "state": "preserve"},
     "evidenceInput": {"reason": "Evidence Input schema 1 remains readable and is never rewritten by upgrade.", "state": "preserve"},
-    "exchange": {"reason": "Exchange protocol capability metadata changes to version 4.", "state": "regenerate"},
+    "exchange": {"reason": "Exchange protocol capability metadata changes to version 7.", "state": "regenerate"},
+    "hostPromotionEvidence": {"reason": "Host Promotion Evidence is short-lived and remains bound to exact code, artifact, and Project Context snapshots.", "state": "regenerate"},
     "integrationReviewBundle": {"reason": "Short-lived integration review bundles must be regenerated against current baselines.", "state": "regenerate"},
     "reviewBundle": {"reason": "Review Bundle schema 2 remains readable but short-lived reviews must be regenerated when their baselines change.", "state": "regenerate"},
+    "routingIndex": {"reason": "Routing Index schema 1 is disposable derived data and must be rebuilt from the current Contract.", "state": "invalidate"},
     "stageContextBundle": {"reason": "Short-lived stage context bundles must be regenerated against current receipts.", "state": "regenerate"},
     "stageReceipt": {"reason": "Existing receipts remain evidence but do not grant next-stage or upgrade authority.", "state": "preserve"},
     "taskContextPlan": {"reason": "Short-lived task plans must be regenerated when their project baselines change.", "state": "regenerate"}
+    ,"truthReconciliationInput": {"reason": "Schema 1 inputs lack previous-review-bound resolution attempts; regenerate as schema 2 from the current baseline.", "state": "regenerate"}
+    ,"truthReconciliationReviewBundle": {"reason": "Schema 1 reviews lack finding digests and machine-verifiable resolution outcomes; recompute as schema 2.", "state": "regenerate"}
   },
   "externalEffects": {"automaticUpgrade": false, "businessCode": false, "git": false, "network": false, "packageManager": false, "projectTests": false},
-  "manifestDigest": "sha256:071f7461ae5669a6d78657bb81ec019a5508919a8f2de8640ba48eaec1343101",
-  "package": {"name": "frontend-project-context", "version": "1.6.0"},
+  "manifestDigest": "sha256:34b1b611ebf31471f2e136eb3f84ad627df612998d0358654e7cdde4713de777",
+  "package": {"name": "frontend-project-context", "version": "1.7.0"},
   "paths": [
     {
       "acceptance": ["project-context-clean", "target-renderers-current"],
@@ -59,21 +66,36 @@
       "migrationIds": ["upgrade.republish-ai-entry.v1", "upgrade.republish-projection.v1"],
       "requiresHumanReview": false,
       "rollbackClass": "package-only"
+    },
+    {
+      "acceptance": ["project-context-clean", "target-renderers-current"],
+      "classification": "package-only",
+      "fromVersion": "1.6.0",
+      "migrationIds": ["upgrade.republish-ai-entry.v1"],
+      "requiresHumanReview": false,
+      "rollbackClass": "package-only"
     }
   ],
   "protocols": {
     "actionPlan": {"readable": [1, 2], "written": 2},
+    "adaptiveContextBundle": {"readable": [2], "written": 2},
+    "contextQuery": {"readable": [2], "written": 2},
+    "coverageAudit": {"readable": [1], "written": 1},
     "evidenceBundle": {"readable": [1], "written": 1},
     "evidenceInput": {"readable": [1], "written": 1},
-    "exchange": {"readable": [4], "written": 4},
+    "exchange": {"readable": [4, 5, 6, 7], "written": 7},
+    "hostPromotionEvidence": {"readable": [1], "written": 1},
     "integrationReviewBundle": {"readable": [1], "written": 1},
     "reviewBundle": {"readable": [1, 2], "written": 2},
+    "routingIndex": {"readable": [1, 2], "written": 2},
     "stageContextBundle": {"readable": [1], "written": 1},
     "stageReceipt": {"readable": [1], "written": 1},
-    "taskContextPlan": {"readable": [1], "written": 1}
+    "taskContextPlan": {"readable": [1], "written": 1},
+    "truthReconciliationInput": {"readable": [2], "written": 2},
+    "truthReconciliationReviewBundle": {"readable": [2], "written": 2}
   },
   "renderers": {
-    "aiEntry": {"readable": [1], "written": 1},
+    "aiEntry": {"readable": [1, 2, 3], "written": 3},
     "projection": {"readable": [1, 2, 3], "written": 3}
   },
   "rollback": {"automatic": false, "defaultClass": "package-only", "externalRestoreRequired": true},
@@ -84,5 +106,5 @@
     "proposal": {"readable": [1], "written": [1]},
     "sourceLock": {"readable": [1], "written": [1]}
   },
-  "upgradeFrom": ["1.3.1", "1.4.0", "1.5.0"]
+  "upgradeFrom": ["1.3.1", "1.4.0", "1.5.0", "1.6.0"]
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "frontend-project-context",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "Govern, compile, and verify project-local context for AI coding tools.",
   "private": false,
   "publishConfig": {
@@ -27,7 +27,7 @@
   },
   "scripts": {
     "check": "node --check bin/project-context.mjs && npm test",
-    "test": "node --test test/project-context/acceptance.test.mjs test/project-context/assist.test.mjs test/project-context/cli.test.mjs test/project-context/dashboard.test.mjs test/project-context/evidence.test.mjs test/project-context/exchange.test.mjs test/project-context/maintenance.test.mjs test/project-context/source-lifecycle.test.mjs test/project-context/task-context.test.mjs test/project-context/takeover.test.mjs test/project-context/upgrade.test.mjs test/release/acceptance.test.mjs",
+    "test": "node --test test/project-context/acceptance.test.mjs test/project-context/adaptive-context.test.mjs test/project-context/adaptive-delivery-v2.test.mjs test/project-context/assist.test.mjs test/project-context/cli.test.mjs test/project-context/dashboard.test.mjs test/project-context/evidence.test.mjs test/project-context/exchange.test.mjs test/project-context/maintenance.test.mjs test/project-context/source-lifecycle.test.mjs test/project-context/task-context.test.mjs test/project-context/takeover.test.mjs test/project-context/truth-reconciliation.test.mjs test/project-context/upgrade.test.mjs test/release/acceptance.test.mjs",
     "prepack": "npm run check"
   },
   "engines": {

package/schemas/adaptive-context-bundle.schema.json

@@ -0,0 +1,70 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "urn:frontend-project-context:schema:adaptive-context-bundle:2",
+  "title": "Frontend Project Context Adaptive Context Bundle",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schemaVersion", "kind", "project", "task", "queryDigest", "taskDigest", "level", "expansionDepth", "snapshots", "routing", "guarantees", "globalHealth", "taskHealth", "targetStates", "hydratedItems", "retainedItemIds", "deferredItems", "sources", "evidenceEdges", "readTargets", "findings", "excluded", "metrics", "budget", "delivery", "bundleDigest"],
+  "properties": {
+    "schemaVersion": { "const": 2 },
+    "kind": { "const": "adaptive-context-bundle" },
+    "project": { "type": "object", "additionalProperties": false, "required": ["id", "name"], "properties": { "id": { "type": "string" }, "name": { "type": "string" } } },
+    "task": { "$ref": "context-query.schema.json#/properties/task" },
+    "queryDigest": { "$ref": "#/$defs/digest" },
+    "taskDigest": { "$ref": "#/$defs/digest" },
+    "previousBundleDigest": { "$ref": "#/$defs/digest" },
+    "level": { "enum": ["initial", "expanded", "complete"] },
+    "expansionDepth": { "type": "integer", "minimum": 0, "maximum": 1 },
+    "snapshots": { "$ref": "context-query.schema.json#/$defs/snapshots" },
+    "routing": { "type": "object", "additionalProperties": false, "required": ["indexDigest", "indexState"], "properties": { "indexDigest": { "$ref": "#/$defs/digest" }, "indexState": { "enum": ["current", "invalid-rebuilt-in-memory", "stale-rebuilt-in-memory", "missing-rebuilt-in-memory"] }, "rejectedDigest": { "$ref": "#/$defs/digest" } } },
+    "guarantees": { "type": "object", "additionalProperties": false, "required": ["registrationCoverage", "mandatoryCoverage", "declaredDependencyCoverage", "retrievalStatus", "semanticCompleteness", "freshness"], "properties": { "registrationCoverage": { "type": "string" }, "mandatoryCoverage": { "enum": ["complete", "blocked"] }, "declaredDependencyCoverage": { "enum": ["complete", "missing", "not-declared"] }, "retrievalStatus": { "enum": ["matched", "no-candidate", "ambiguous", "complete"] }, "semanticCompleteness": { "const": "not-claimed" }, "freshness": { "enum": ["strict-current", "snapshot-and-signal-bound"] } } },
+    "globalHealth": { "enum": ["clean", "attention", "conflict", "not-checked", "snapshot-stale"] },
+    "taskHealth": { "enum": ["ready", "needs-expansion", "blocked"] },
+    "targetStates": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["path", "state"], "properties": { "path": { "type": "string" }, "state": { "enum": ["existing", "prospective-or-deleted"] } } } },
+    "hydratedItems": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["id", "kind", "subject", "value", "statement", "scope", "sourceIds", "overrides", "selectionReasons", "itemDigest"], "properties": { "id": { "$ref": "#/$defs/id" }, "kind": { "enum": ["fact", "policy", "reference", "validation-description"] }, "subject": { "$ref": "#/$defs/id" }, "value": {}, "statement": { "type": "string", "minLength": 1 }, "scope": { "$ref": "#/$defs/scope" }, "sourceIds": { "$ref": "#/$defs/ids" }, "overrides": { "$ref": "#/$defs/ids" }, "verification": {}, "selectionReasons": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } }, "itemDigest": { "$ref": "#/$defs/digest" } } } },
+    "retainedItemIds": { "type": "array", "uniqueItems": true, "items": { "type": "string" } },
+    "deferredItems": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["id", "kind", "subject", "scope", "sourceIds", "itemDigest", "reason"], "properties": { "id": { "$ref": "#/$defs/id" }, "kind": { "enum": ["fact", "policy", "reference", "validation-description"] }, "subject": { "$ref": "#/$defs/id" }, "scope": { "$ref": "#/$defs/scope" }, "sourceIds": { "$ref": "#/$defs/ids" }, "itemDigest": { "$ref": "#/$defs/digest" }, "reason": { "const": "applicable-not-selected" } } } },
+    "sources": { "type": "array", "items": { "$ref": "#/$defs/sourceEvidence" } },
+    "evidenceEdges": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["itemId", "sourceId"], "properties": { "itemId": { "type": "string" }, "sourceId": { "type": "string" } } } },
+    "readTargets": { "type": "array", "items": { "$ref": "#/$defs/readTarget" } },
+    "findings": { "type": "array", "items": { "$ref": "#/$defs/finding" } },
+    "excluded": { "type": "array", "uniqueItems": true, "items": { "type": "string" } },
+    "metrics": { "type": "object", "additionalProperties": false, "required": ["sourceDigestReads", "sourceBodyReads", "sourceIdentityReads", "hydratedItemCount", "retainedItemCount", "deferredItemCount", "hostToolCalls"], "properties": { "sourceDigestReads": { "type": "integer" }, "sourceBodyReads": { "type": "integer" }, "sourceIdentityReads": { "type": "integer" }, "hydratedItemCount": { "type": "integer" }, "retainedItemCount": { "type": "integer" }, "deferredItemCount": { "type": "integer" }, "hostToolCalls": { "const": 1 } } },
+    "budget": { "type": "object", "additionalProperties": false, "required": ["unit", "audit", "delivery", "readTargets"], "properties": { "unit": { "const": "canonical-utf8-bytes" }, "audit": { "$ref": "#/$defs/auditBudget" }, "delivery": { "$ref": "#/$defs/deliveryBudget" }, "readTargets": { "$ref": "#/$defs/readBudget" } } },
+    "delivery": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["status", "format", "mode", "itemIds", "contentDigest", "utf8Bytes"],
+      "properties": {
+        "status": { "enum": ["ready", "withheld"] },
+        "format": { "const": "project-context-markdown" },
+        "mode": { "type": ["string", "null"], "enum": ["adaptive", "complete", null] },
+        "itemIds": { "type": "array", "uniqueItems": true, "items": { "type": "string" } },
+        "contentDigest": { "oneOf": [{ "$ref": "#/$defs/digest" }, { "type": "null" }] },
+        "utf8Bytes": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "bundleDigest": { "$ref": "#/$defs/digest" }
+  },
+  "$defs": {
+    "id": { "type": "string", "pattern": "^[a-z0-9]+(?:[.-][a-z0-9]+)*$" },
+    "digest": { "type": "string", "pattern": "^sha256:[a-f0-9]{64}$" },
+    "nullableDigest": { "oneOf": [{ "$ref": "#/$defs/digest" }, { "type": "null" }] },
+    "ids": { "type": "array", "uniqueItems": true, "items": { "$ref": "#/$defs/id" } },
+    "paths": { "type": "array", "uniqueItems": true, "items": { "type": "string", "minLength": 1 } },
+    "scope": { "oneOf": [
+      { "type": "object", "additionalProperties": false, "required": ["kind"], "properties": { "kind": { "const": "project" } } },
+      { "type": "object", "additionalProperties": false, "required": ["kind", "path"], "properties": { "kind": { "enum": ["path-prefix", "file"] }, "path": { "type": "string", "minLength": 1 } } }
+    ] },
+    "locator": { "oneOf": [
+      { "type": "object", "additionalProperties": false, "required": ["path"], "properties": { "path": { "type": "string", "minLength": 1 }, "pointer": { "type": "string" } } },
+      { "type": "object", "additionalProperties": false, "required": ["reference"], "properties": { "reference": { "type": "string", "minLength": 1 } } }
+    ] },
+    "sourceEvidence": { "type": "object", "additionalProperties": false, "required": ["id", "kind", "locator", "sourceDigest", "freshness"], "properties": { "id": { "$ref": "#/$defs/id" }, "kind": { "type": "string", "minLength": 1 }, "locator": { "$ref": "#/$defs/locator" }, "sourceDigest": { "$ref": "#/$defs/digest" }, "freshness": { "enum": ["current", "drifted", "unreadable", "unverifiable-non-local"] }, "expectedDigest": { "$ref": "#/$defs/nullableDigest" }, "actualDigest": { "$ref": "#/$defs/nullableDigest" } } },
+    "readTarget": { "type": "object", "additionalProperties": false, "required": ["path", "reason"], "properties": { "path": { "type": "string", "minLength": 1 }, "reason": { "enum": ["task-target", "host-changed-path-signal", "contract-source"] }, "sourceId": { "$ref": "#/$defs/id" } } },
+    "finding": { "type": "object", "additionalProperties": false, "required": ["code", "severity"], "properties": { "code": { "type": "string", "minLength": 1 }, "severity": { "enum": ["attention", "needs-expansion", "blocked"] }, "itemId": { "$ref": "#/$defs/id" }, "requiredItemId": { "$ref": "#/$defs/id" }, "sourceId": { "$ref": "#/$defs/id" }, "subject": { "$ref": "#/$defs/id" }, "itemIds": { "$ref": "#/$defs/ids" }, "path": { "type": "string", "minLength": 1 }, "paths": { "$ref": "#/$defs/paths" }, "expected": {}, "actual": {}, "expectedDigest": { "$ref": "#/$defs/nullableDigest" }, "actualDigest": { "$ref": "#/$defs/nullableDigest" }, "reason": { "type": "string", "minLength": 1 }, "state": { "type": "string", "minLength": 1 }, "target": { "type": "integer", "minimum": 0 }, "limit": { "type": "integer", "minimum": 0 }, "required": { "type": "integer", "minimum": 0 }, "conflicts": { "type": "array" }, "projectFinding": {} } },
+    "auditBudget": { "type": "object", "additionalProperties": false, "required": ["targetUtf8Bytes", "maxUtf8Bytes", "usedUtf8Bytes"], "properties": { "targetUtf8Bytes": { "type": "integer", "minimum": 1 }, "maxUtf8Bytes": { "type": "integer", "minimum": 1 }, "usedUtf8Bytes": { "type": "integer", "minimum": 1 } } },
+    "deliveryBudget": { "type": "object", "additionalProperties": false, "required": ["completeBelowUtf8Bytes", "maxUtf8Bytes", "usedUtf8Bytes"], "properties": { "completeBelowUtf8Bytes": { "type": "integer", "minimum": 1 }, "maxUtf8Bytes": { "type": "integer", "minimum": 1 }, "usedUtf8Bytes": { "type": "integer", "minimum": 0 } } },
+    "readBudget": { "type": "object", "additionalProperties": false, "required": ["target", "max", "count"], "properties": { "target": { "type": "integer", "minimum": 1 }, "max": { "type": "integer", "minimum": 1 }, "count": { "type": "integer", "minimum": 0 } } }
+  }
+}