frontend-project-context 1.2.0 → 1.3.0

package/CHANGELOG.md

@@ -1,13 +1,22 @@
 # Changelog
 
-## 1.2.0 — unreleased
+## 1.3.0 — unreleased
+
+- 新增严格的 Task Context Plan schema 1 与 Stage Receipt schema 1：宿主显式提供任务、stage 依赖、revision label、snapshot、路径和预算，未知、权限、执行、循环依赖、非法路径与无依赖范围重叠均失败封闭。
+- 新增永远只读的 `stage-context`，复用 Scope Compiler 为显式指定阶段生成 Stage Context Bundle schema 1，并用调用方提供的规范 UTF-8 字节与 read-target 预算失败封闭。
+- 新增永远只读的 `integration-review`，比较 plan/receipt/Contract baseline、宿主提供的 main/branch changed paths、Contract item 重叠、stage 越界、生命周期 finding 和待人判断的 decision candidate。
+- 公开 Stage Context Bundle 和 Integration Review Bundle schema 1，capabilities 增加两个命令、四份 schema 和 `canonical-utf8-bytes` 预算语义。
+- 不新增 store migration、Provider、Agent Runtime、Git 读写、源码正文读取、任务/测试执行、依赖、自动批准、合并或长期事实晋升。
+- A-64 至 A-73 与全部旧回归共 79/79 项为实现 Gate；本条不代表 npm 打包、发布、Git 提交/push 或真实项目验收。
+
+## 1.2.0 — 2026-09-09
 
 - 新增未初始化和已初始化项目均可使用的只读 `capabilities`，公开 package、exchange protocol、schema、command、八类 action 和永久边界。
 - 新增 Action Plan schema 1 和只读 `preflight`，把 AI 建议规范化为带三个 snapshot、action 专属 baseline、精确 impact 与 blocker 的短生命周期输入。
 - 新增 Review Bundle schema 1，稳定分组 current/proposed、item/source/path/projection 影响与结构化 `{ command, args }` invocation；invocation 不含 `--write` 或 `--by`。
 - 发布 capabilities、Assist Bundle、Action Plan 与 Review Bundle 四份 JSON schema，并把 `schemas/` 加入 npm 白名单；动态项目状态继续排除。
 - 八类 action 均复用现有 register/propose/review/accept/revise/deprecate/approve/publish 预检语义；不新增 `apply-plan`、Provider、Agent Runtime、Git、网络、依赖安装、自动批准或业务代码执行。
-- A-56 至 A-63 与全部回归共 69/69 项本地验收通过；公共发布尚未授权。
+- A-56 至 A-63 与全部回归共 69/69 项验收通过；已发布到公共 npm，并完成候选包与 registry tarball 的逐字节一致性及独立安装验证。
 
 ## 1.1.0 — unreleased
 

package/README.md

@@ -37,7 +37,7 @@ npm install --save-dev frontend-project-context@1.2.0
 
 The package has zero runtime dependencies.
 
-`1.2.0` is the locally verified source version in this repository. The latest independently verified public npm version remains `1.0.1` until separate release authorization and publication.
+`1.2.0` is the current independently verified public npm version. The published tarball was byte-matched against the reviewed release candidate and smoke-tested from the official registry.
 
 ### Quick start
 
@@ -128,7 +128,33 @@ npx project-context preflight \
 
 `preflight` validates the project ID, all three snapshot digests, action-specific baselines, exact impacts, blockers, and projection ownership. It returns structured `{ command, args }` invocations without `--write` or `--by`. The plan and Review Bundle grant no authority: after a human approves exact action IDs and paths, the host must add the required identity and write flags to the existing fine-grained command. Any intervening write invalidates the remaining review and requires a fresh `sync` and `preflight`.
 
-The package publishes `schemas/capabilities.schema.json`, `schemas/assist-bundle.schema.json`, `schemas/action-plan.schema.json`, and `schemas/review-bundle.schema.json`.
+For multi-stage feature work, a host can provide a Task Context Plan, prior Stage Receipts, and explicit changed-path signals. Compile only the requested stage:
+
+```bash
+npx project-context stage-context \
+  --project . \
+  --plan task-context-plan.json \
+  --stage stage-render \
+  --receipt stage-understand.receipt.json \
+  --changed-path src/example.ts \
+  --json
+```
+
+Before an external merge, compare host-provided main/branch path signals with the plan, receipts, current Contract snapshots, and checker findings:
+
+```bash
+npx project-context integration-review \
+  --project . \
+  --plan task-context-plan.json \
+  --receipt stage-understand.receipt.json \
+  --main-changed-path src/shared.ts \
+  --branch-changed-path src/example.ts \
+  --json
+```
+
+Both commands are read-only. They do not inspect Git, read source bodies, execute the task or tests, save task state, promote decisions, or grant merge authority. Budget limits are caller-supplied canonical UTF-8 bytes and read-target counts, not model tokens.
+
+The package publishes eight machine schemas: capabilities, Assist Bundle, Action Plan, Review Bundle, Task Context Plan, Stage Receipt, Stage Context Bundle, and Integration Review Bundle.
 
 Generate the read-only governance dashboard:
 
@@ -185,6 +211,8 @@ All commands are read-only unless that command explicitly includes `--write`. So
 | `check` | Detect stale sources, contracts, and projections |
 | `sync` | Aggregate source drift, item impact, changed paths, and reconciliation work units |
 | `preflight` | Validate an Action Plan and return a read-only grouped Review Bundle |
+| `stage-context` | Compile the explicitly requested stage within caller-provided byte/read-target budgets |
+| `integration-review` | Review plan, receipts, host path signals, baselines, and context-layer conflicts without Git |
 | `dashboard` | Render the read-only governance dashboard |
 | `review-source` | Review a changed source and its exact impact set |
 | `accept-source-change` | Accept a pinned source digest and revoke affected approvals |
@@ -203,6 +231,8 @@ Run `npx project-context --help` for the complete command syntax.
 - [Read-only governance dashboard](./docs/13-READ-ONLY-GOVERNANCE-DASHBOARD-DESIGN.md)
 - [Source lifecycle](./docs/15-SOURCE-LIFECYCLE-CLOSURE-DESIGN.md)
 - [Guided onboarding and AI-assisted reconciliation](./docs/16-GUIDED-ONBOARDING-AND-AI-RECONCILIATION-DESIGN.md)
+- [AI exchange boundary](./docs/17-AI-EXCHANGE-BOUNDARY-DESIGN.md)
+- [Branch-aware staged context and handoff](./docs/18-BRANCH-AWARE-STAGED-CONTEXT-DESIGN.md)
 - [AI Exchange Boundary design](./docs/17-AI-EXCHANGE-BOUNDARY-DESIGN.md)
 - [Upgrade notes](./UPGRADING.md)
 
@@ -237,7 +267,7 @@ npm install --save-dev frontend-project-context@1.2.0
 
 本包没有运行时第三方依赖。
 
-`1.2.0` 是本仓库当前已经完成本地验收的源码版本。在获得单独发布授权并完成发布前，公共 npm 已独立核验的最新版本仍为 `1.0.1`。
+`1.2.0` 是当前已独立核验的公共 npm 最新版本。已发布 tarball 与审查过的发布候选逐字节一致，并已从官方 registry 完成安装冒烟验证。
 
 ### 快速开始
 
@@ -328,7 +358,33 @@ npx project-context preflight \
 
 `preflight` 会验证 project ID、三个 snapshot digest、action 专属 baseline、精确影响集、blocker 和投影所有权，并返回不含 `--write`、`--by` 的结构化 `{ command, args }` invocation。Action Plan 和 Review Bundle 都不授予权限；只有人批准明确 action ID 与路径后，宿主才能为既有细粒度命令补入身份和写入参数。期间任何写入都会使余下 review 失效，必须重新 `sync` 和 `preflight`。
 
-npm 包公开 `schemas/capabilities.schema.json`、`schemas/assist-bundle.schema.json`、`schemas/action-plan.schema.json` 和 `schemas/review-bundle.schema.json`。
+多阶段功能开发中，宿主可以显式提供 Task Context Plan、前序 Stage Receipt 和 changed-path 信号，只编译当前指定阶段：
+
+```bash
+npx project-context stage-context \
+  --project . \
+  --plan task-context-plan.json \
+  --stage stage-render \
+  --receipt stage-understand.receipt.json \
+  --changed-path src/example.ts \
+  --json
+```
+
+外部合并前，可把宿主提供的 main/branch 路径信号与 plan、receipt、当前 Contract snapshot 和 checker finding 一起进行只读审查：
+
+```bash
+npx project-context integration-review \
+  --project . \
+  --plan task-context-plan.json \
+  --receipt stage-understand.receipt.json \
+  --main-changed-path src/shared.ts \
+  --branch-changed-path src/example.ts \
+  --json
+```
+
+两个命令都不会读取 Git 或源码正文、执行任务或测试、保存任务状态、晋升决定或授予合并权限。预算由调用方以规范 UTF-8 字节数和 read-target 数量显式提供，不等同于模型 token。
+
+npm 包公开八份机器 schema：capabilities、Assist Bundle、Action Plan、Review Bundle、Task Context Plan、Stage Receipt、Stage Context Bundle 和 Integration Review Bundle。
 
 生成只读治理看板：
 
@@ -385,6 +441,8 @@ npx project-context dashboard --project . > project-context-dashboard.html
 | `check` | 检测来源、合同和投影漂移 |
 | `sync` | 聚合来源漂移、item 影响、变化路径和维护工作单元 |
 | `preflight` | 验证 Action Plan 并返回只读分组 Review Bundle |
+| `stage-context` | 在调用方字节/read-target 预算内编译显式指定的当前阶段 |
+| `integration-review` | 不读取 Git，只读审查 plan、receipt、路径信号、baseline 与上下文冲突 |
 | `dashboard` | 生成只读治理看板 |
 | `review-source` | 查看来源变化及精确影响集 |
 | `accept-source-change` | 接受固定摘要并撤销受影响批准 |
@@ -403,6 +461,8 @@ npx project-context dashboard --project . > project-context-dashboard.html
 - [只读治理看板](./docs/13-READ-ONLY-GOVERNANCE-DASHBOARD-DESIGN.md)
 - [来源生命周期](./docs/15-SOURCE-LIFECYCLE-CLOSURE-DESIGN.md)
 - [引导式接入与 AI 辅助维护](./docs/16-GUIDED-ONBOARDING-AND-AI-RECONCILIATION-DESIGN.md)
+- [AI 双向交换边界](./docs/17-AI-EXCHANGE-BOUNDARY-DESIGN.md)
+- [分支感知的分阶段上下文与交接](./docs/18-BRANCH-AWARE-STAGED-CONTEXT-DESIGN.md)
 - [AI 双向交换边界设计](./docs/17-AI-EXCHANGE-BOUNDARY-DESIGN.md)
 - [升级说明](./UPGRADING.md)
 

package/UPGRADING.md

@@ -1,9 +1,25 @@
 # 升级说明
 
+## `1.2.0 → 1.3.0`
+
+`1.3.0` 增加可选 Branch-aware Staged Context & Handoff 协议：四份新的短生命周 schema、只读 `stage-context` 和只读 `integration-review`。Contract、proposal、source/projection lock、renderer、Dashboard View Model、Assist Bundle、Action Plan 和 Review Bundle schema 都不变，旧项目无需迁移 `.project-context/`。
+
+采用该可选协议时：
+
+1. 宿主根据 `schemas/task-context-plan.schema.json` 显式准备 task、stage DAG、workspace label、三个 snapshot 与 UTF-8 字节/read-target 预算。
+2. 运行 `project-context stage-context --project . --plan FILE --stage STAGE_ID --json`；只为当前 stage 提供有效前序 receipt 和 changed-path 信号。
+3. 外部 Coding Agent 执行任务后，由宿主按 `schemas/stage-receipt.schema.json` 记录结构化结果；receipt 不是人工验收或后续权限。
+4. 合并前运行 `project-context integration-review`，显式传入 main/branch changed paths；工具不自行读 Git。
+5. 合并、测试、业务正确性、任务工件存放/删除和长期事实晋升仍由外部工具与人决定。
+
+当前源码已完成实现验收，但未获得 npm 打包或发布授权；已公开核验的 npm `latest` 仍为 `1.2.0`。
+
 ## `1.1.0 → 1.2.0`
 
 `1.2.0` 完成模型无关双向 AI Exchange Boundary：新增只读 `capabilities`、Action Plan schema 1、只读 `preflight`、Review Bundle schema 1 和四份公开机器 schema。Contract、proposal、source lock、projection lock、renderer 与 Dashboard View Model 均未升级，旧项目无需迁移 `.project-context/`。
 
+该版本已于 2026-09-09 发布到官方公共 npm，`latest` 指向 `1.2.0`；发布包与冻结候选逐字节一致。
+
 升级后建议：
 
 1. 运行 `project-context capabilities --project . --json`，由宿主读取版本、schema、action kind、初始化状态和永久边界。

package/docs/04-PROGRAM-DESIGN.md

@@ -2,7 +2,7 @@
 
 > 权威说明：本文记录当前实现设计；如与 [00-PRODUCT-CONSTITUTION.md](./00-PRODUCT-CONSTITUTION.md) 冲突，以产品宪法为准。
 
-> 状态：`1.2.0 AI Exchange Boundary implemented locally; A-01 through A-63, B0 regressions, CLI, schemas, and release artifacts verified; 69 tests total`
+> 状态：`1.3.0 Branch-aware Staged Context implemented locally; A-01 through A-73, B0 regressions, CLI, schemas, and package metadata verified; 79 tests total; pack and release not authorized`
 >
 > 前置真源：[03-FINAL-SOLUTION.md](./03-FINAL-SOLUTION.md)。本文不得重新引入 Agent Runtime、任务执行、Git 生命周期或完整多工具适配矩阵。
 
@@ -419,6 +419,7 @@ Action Plan 的新增稳定错误为：schema/project mismatch 退出 2；projec
 9. 来源 review/accept、同 ID revise、deprecate、pending reapproval、store 并发补强和 A-21 至 A-30。
 10. setup/sync Assist Bundle 聚合、changed path 映射和 A-46 至 A-55。
 11. capabilities、Action Plan/Review Bundle、只读 preflight、机器 schema 和 A-56 至 A-63。
+12. Task Context Plan/Stage Receipt、字节预算 Stage Context Bundle、只读 integration review 和 A-64 至 A-73。
 
 任何一步都不需要真实项目任务或 Provider。
 
@@ -500,3 +501,15 @@ A-46 至 A-55、两个新增 CLI 入口回归和全部既有测试已通过，
 [17-AI-EXCHANGE-BOUNDARY-DESIGN.md](./17-AI-EXCHANGE-BOUNDARY-DESIGN.md) 冻结的双向桥接协议已完成本地实现：新增机器可发现 capabilities、短生命周期 Action Plan、只读 preflight/Review Bundle、structured invocation 与四份公开 schema；八类 action 继续复用现有安全原语。
 
 A-56 至 A-63 和全部既有回归共 69/69 通过。实现未增加 store migration、`apply-plan`、Provider、Agent Runtime、业务代码执行、Git、网络、依赖安装、scheduler、daemon、自动批准或自动修复；未执行打包、registry、Git push 或发布。
+
+## 18. `1.3.0` Branch-aware Staged Context & Handoff 实现结果
+
+[18-BRANCH-AWARE-STAGED-CONTEXT-DESIGN.md](./18-BRANCH-AWARE-STAGED-CONTEXT-DESIGN.md) 冻结的可选协议已完成本地实现：
+
+- `task-context-schema.mjs` 严格验证并稳定规范化 Task Context Plan 与 Stage Receipt；
+- `task-context.mjs` 复用现有 checker 和 Scope Compiler，只读编译当前 Stage Context Bundle 与 Integration Review Bundle；
+- `stage-context` 要求调用方显式选择 stage，核对 plan/receipt/snapshot，按规范 UTF-8 字节和 read-target 数失败封闭；
+- `integration-review` 只消费宿主传入的 main/branch changed paths，报告 path/Contract overlap、stage 越界、生命周阻塞和 decision candidate；
+- capabilities 公开两个新命令、四份 schema version 1 和 `canonical-utf8-bytes` 预算单位。
+
+A-64 至 A-73 与全部旧回归共 79/79 通过。实现不读 Git 或源码正文，不执行任务/测试，不保存 task store，不自动批准、合并或晋升决定，不增加 Provider、Agent Runtime、Git、网络、依赖、scheduler 或 daemon。未执行 npm pack、registry、真实项目试用、Git commit/push 或发布。

package/docs/05-ACCEPTANCE-CONTRACT.md

@@ -2,7 +2,7 @@
 
 > 权威说明：本文记录核心引擎验收；完整 v1 完成定义以 [00-PRODUCT-CONSTITUTION.md](./00-PRODUCT-CONSTITUTION.md) 第 7 节为准。
 
-> 状态：`A-01 through A-63 plus B0-01/B0-02, CLI, machine schemas, and release artifacts passed locally; 69 tests total on 2026-09-09`
+> 状态：`A-01 through A-73 plus B0-01/B0-02, CLI, machine schemas, and release artifacts passed; 79 tests total. Public npm latest remains independently verified 1.2.0; 1.3.0 pack and release are not authorized.`
 
 ## 1. 验收原则
 
@@ -322,7 +322,7 @@
 
 ### A-39 发布候选边界
 
-- package name 固定为 `frontend-project-context`，当前本地实现版本为 `1.2.0`、公共 npm 已核验最新版本为 `1.0.1`，bin 为 `project-context`，Node.js 下限为 18，第三方 runtime dependency 为零；
+- package name 固定为 `frontend-project-context`，当前本地实现版本为 `1.3.0`，公共 npm 已核验 latest 仍为 `1.2.0`，bin 为 `project-context`，Node.js 下限为 18，第三方 runtime dependency 为零；
 - package metadata 声明 Apache-2.0，发布包包含官方 LICENSE 和 `Copyright 2026 Fushan` NOTICE；
 - `files` 白名单包含 bin、src、docs、examples、四份公开 machine schema、变更/升级说明和许可证文件，但不包含测试、PROJECT_STATE、RTK、自托管 `.project-context/` 或本地生成物；
 - `prepack` 必须运行全量检查，bin 保持可执行；
@@ -377,4 +377,21 @@ A-39 是发布工件一致性验证，不扩展 Project Contract、CLI、schema
 - **A-62 机器 schema 一致性**：四份 JSON schema 覆盖实际 capabilities、Assist Bundle、Action Plan 与 Review Bundle fixture；npm 白名单包含 `schemas/` 且继续排除项目动态状态；
 - **A-63 兼容与永久边界**：A-01 至 A-55、B0、CLI 和发布工件无回归；零 Provider、Agent Runtime、Git、network、child process、dependency install、scheduler、daemon、自动批准和业务代码修改。
 
-实现 Gate 已满足：A-56 至 A-63 共 8 项新增验收，连同全部既有测试为 `npm run check` 69/69。验证只使用隔离临时 fixture；没有访问真实业务项目、Provider、网络或 Git，没有安装依赖、打包或发布。
+实现 Gate 已满足：A-56 至 A-63 共 8 项新增验收，连同全部既有测试为 `npm run check` 69/69。实现验收只使用隔离临时 fixture；没有访问真实业务项目、Provider、网络或 Git。随后 `1.2.0` 经单独发布授权完成公共 npm 发布和 registry 工件独立验证，发布事实见 [14-FORMAL-RELEASE-READINESS.md](./14-FORMAL-RELEASE-READINESS.md)。
+
+## 15. `1.3.0` Branch-aware Staged Context & Handoff 验收（已实现并通过）
+
+[18-BRANCH-AWARE-STAGED-CONTEXT-DESIGN.md](./18-BRANCH-AWARE-STAGED-CONTEXT-DESIGN.md) 冻结以下 A-64 至 A-73。它们属于帮助现有 Coding Agent 更准确、分阶段完成目标功能的可选上下文协议，不改变 Project Contract 核心身份：
+
+- **A-64 capability 与公开 schema**：capabilities 稳定公开 `stage-context`、`integration-review`、四份新 schema、UTF-8 byte 预算单位和永久边界；npm 白名单覆盖 schema；
+- **A-65 Task Context Plan**：合法 plan 稳定规范化；未知/权限/执行字段、重复 ID、循环依赖、非法路径、缺失预算和无依赖重叠 stage 失败封闭；
+- **A-66 Stage 选择与依赖**：只编译调用方显式选择的 stage；依赖缺失、blocked 或 stale 时 blocked，完整 completed receipts 才 ready，不自动前进；
+- **A-67 Scope 与 changed paths**：复用现有 Scope Compiler 精确选择 Contract items，保持 sibling 隔离；changed paths 只作外部信号，不读 Git、不成为来源；
+- **A-68 确定性预算**：相同输入字节等价；默认无 source/code/diff/chat body；必要内容超限显式 blocked，不静默截断；
+- **A-69 Stage Receipt**：receipt 严格绑定 plan、bundle、stage 和 acceptance；completed/blocked 语义完整；不含 shell、权限或伪造 approval；
+- **A-70 跨窗口恢复**：只使用 plan、当前 stage、有效 receipts 和 paths 可重建同一 Bundle，不依赖聊天历史或新 store；
+- **A-71 Integration Review**：精确报告 main/branch path overlap、Contract item overlap、stage scope escape、incomplete receipt 和 decision candidate；
+- **A-72 baseline 与恢复**：Contract/source/projection snapshot、plan 或 receipt baseline 失效立即 blocked；刷新显式输入后可确定性恢复；
+- **A-73 生命周期、兼容与边界**：合并审查不执行 Git、测试或业务代码，不自动晋升决定或保存任务；A-01 至 A-63、B0、CLI 和发布工件全部继续通过。
+
+实现 Gate 已满足：A-64 至 A-73 新增 10 项编号验收，连同全部旧回归为 `npm run check` 79/79。验收只使用隔离临时 fixture，没有访问真实业务项目、Provider、网络或产品内 Git，没有安装依赖、执行任务/测试、产生新 store、自动晋升决定或发布。测试通过不等于团队试用或发布授权。

package/docs/08-INSTALLATION-AND-DISTRIBUTION.md

@@ -2,7 +2,7 @@
 
 > 权威说明：本文是支持性设计文档；当前唯一规范真源是 [00-PRODUCT-CONSTITUTION.md](./00-PRODUCT-CONSTITUTION.md)。
 
-状态：`frontend-project-context@1.2.0` 已完成本地实现与 69 项验证；公共 npm 已核验最新版本仍为 `1.0.1`，`1.2.0` 发布未授权
+状态：`frontend-project-context@1.2.0` 已发布到官方公共 npm；69 项验收、候选包完整性和 registry 安装均已独立验证
 适用项目：`dtg-frontend-delivery-agent`  
 本文记录产品如何交付、安装、共享、升级和验证；它不自行授权打包、registry、Git 或发布操作。
 
@@ -48,7 +48,7 @@ pnpm dlx frontend-project-context@1.2.0 setup --project . --id PROJECT_ID --name
 bunx frontend-project-context@1.2.0 setup --project . --id PROJECT_ID --name "Project Name" --json
 ```
 
-以上 `1.2.0` 一次性命令只在该版本获得单独发布授权并实际发布后可用；当前公共 registry 最新已核验版本仍为 `1.0.1`。包名冻结为 `frontend-project-context`，可执行文件名为 `project-context`，CLI 合同以 [04-PROGRAM-DESIGN.md](./04-PROGRAM-DESIGN.md) 为准。
+以上 `1.2.0` 一次性命令现已可从官方公共 npm 使用，`latest` 已独立核验为 `1.2.0`。包名冻结为 `frontend-project-context`，可执行文件名为 `project-context`，CLI 合同以 [04-PROGRAM-DESIGN.md](./04-PROGRAM-DESIGN.md) 为准。
 
 `setup` 初始化入口只负责：
 
@@ -200,7 +200,7 @@ IDE 插件可以在未来提供状态提示、冲突解释和可视化配置，
 
 `1.0.1` 是不改变运行逻辑的 patch：README 改为中英双语的用户向入口，包元数据移除 `bin` 规范化警告，并从发布白名单移除只属于源码仓库治理的 `PROJECT_STATE.json` 与 `RTK.md`。当前没有真实可公开访问的源码仓库，因此不伪造 `repository` 或 `bugs` URL。
 
-## 11. `1.1.0` 与 `1.2.0` 本地实现状态
+## 11. `1.1.0` 实现与 `1.2.0` 正式发布状态
 
 `1.1.0` 增加 `setup`、永远只读的 `sync` 和短生命周期 Assist Bundle schema 1，现归入 AI Exchange Boundary 的模型无关聚合基础。新入口只聚合现有初始化、discovery、source review/impact、checker 和 Scope Compiler；宿主 Agent 触发仍是可选适配器，不增加 Provider、Agent Runtime、Git、网络、scheduler、daemon、自动批准或新 store。
 
@@ -210,4 +210,4 @@ IDE 插件可以在未来提供状态提示、冲突解释和可视化配置，
 
 本地 A-01 至 A-63、B0-01/B0-02、CLI、schema 与发布工件共 69/69 项通过。Contract reader 1/2、proposal/source/projection lock schema 1、renderer 3 与 Dashboard View Model 3 保持兼容，`1.1.0 → 1.2.0` 无 store migration。
 
-本次实现授权不包含 `npm pack` 发布候选核验、registry 访问、tag、push 或 `npm publish`。公共 npm 的 `latest` 仍以已核验的 `1.0.1` 为准，任何 `1.2.0` 发布操作必须获得新的明确授权。
+用户于 2026-09-09 明确进入 `1.2.0` 发布流程。发布候选 prepack 69/69 通过，包含 54 个文件、解包大小 570621 bytes；本地 tarball 与官方 registry 返回的 tarball 逐字节一致，SHA-1 均为 `f70774673df16e2d4d1ceed84df663b5bf76260e`。`fushanyx1` 于 `2026-09-09T09:34:06.552Z` 完成 public 发布，`latest` 指向 `1.2.0`；从 registry 安装后的 help、capabilities、init 与 clean check 冒烟均通过。`v1.2.0` 指向冻结候选提交 `c991187c4dfd094d9cff5a4e15516fb25d74d803`。本次发布授权已经消耗，后续发布或扩大产品边界仍需新的明确授权。

package/docs/14-FORMAL-RELEASE-READINESS.md

@@ -65,3 +65,18 @@ registry/可见性决策、发布者认证、A-39/pack、release commit、`v1.0.
 首次发布后的 npm 页面审查确认，`1.0.0` README 把源码仓库治理记录放在安装入口之前，并保留 release-ready 候选状态；package metadata 还会触发 `bin[project-context]` 自动清理警告。用户已授权以 patch release 修复这些发布质量问题。
 
 `1.0.1` 只重写中英双语用户向 README、规范化 `bin` 路径、补充真实 npm homepage/关键词、更新示例与验收，并从 tarball 移除仓库动态状态文件。当前唯一 Git remote 为非公开公司仓库，且未授权创建公共仓库，因此不设置虚假的 `repository` 或 `bugs`。产品运行逻辑、命令、schema、依赖和兼容面均不改变。
+
+## 9. `1.2.0` AI Exchange Boundary 正式发布
+
+用户于 2026-09-09 明确进入 `1.2.0` 发布流程。冻结候选来自提交 `c991187c4dfd094d9cff5a4e15516fb25d74d803`，`v1.2.0` 精确指向该提交；发布后状态记录留在后续提交，避免改变标签对应的包源码。
+
+发布验证记录：
+
+1. prepack 重新执行全部 69/69 项验收并通过；
+2. tarball 包含 54 个文件，解包大小为 570621 bytes，不包含测试、Git、自托管 `.project-context/`、`PROJECT_STATE.json` 或 `RTK.md`；
+3. 候选 SHA-1 为 `f70774673df16e2d4d1ceed84df663b5bf76260e`，integrity 为 `sha512-VJg48A7lGKanGOgh2V8zPG+6xGMvzPzSIYDRsvFEgkVeClOLRp+2w57KTrY6lphRIB/WujZFlbm9ebiNySB0Vw==`；
+4. 本地 tarball 安装后的 help、capabilities、init、preflight 与 clean check 通过，preflight 前后 store SHA-256 保持不变；
+5. `fushanyx1` 于 `2026-09-09T09:34:06.552Z` 向官方 registry public 发布 `frontend-project-context@1.2.0`，`latest` 已指向该版本；
+6. 从 registry 重新下载的 tarball 与候选逐字节一致，随后直接从 registry 安装并再次通过 help、capabilities、init 与 clean check 冒烟。
+
+本次授权只完成既定 `1.2.0` 发布，不授权 Provider、Agent Runtime、`apply-plan`、自动批准、业务代码执行、Git 管理、网络能力、依赖安装、scheduler、daemon 或公共源码仓库创建。发布授权已经消耗。

package/docs/17-AI-EXCHANGE-BOUNDARY-DESIGN.md

@@ -2,7 +2,7 @@
 
 > 权威说明：本文定义项目与现有 AI 编程工具之间的模型无关双向交换边界；如与 [00-PRODUCT-CONSTITUTION.md](./00-PRODUCT-CONSTITUTION.md) 冲突，以产品宪法为准。
 >
-> 状态：`implemented-local; A-56-through-A-63-and-full-69-test-suite-passed; release-not-authorized`
+> 状态：`published-public-npm-verified; A-56-through-A-63-and-full-69-test-suite-passed`
 >
 > 设计基线：`frontend-project-context@1.1.0` 本地完整性修正、Assist Bundle schema 1、A-01 至 A-55、B0-01/B0-02、CLI 与发布工件共 61 项通过。
 
@@ -265,4 +265,6 @@ Contract、proposal、source lock、projection lock、renderer 和 Dashboard sch
 - `schemas/` 发布 capabilities、Assist Bundle、Action Plan 与 Review Bundle 四份机器合同，npm 白名单继续排除动态项目状态和自托管 store；
 - A-56 至 A-63 和全部旧验收共 69/69 通过，store schema、renderer、Dashboard 与旧 CLI 无迁移和无回归。
 
-实现和自托管同步完成后本阶段停止。当前仍不授权 Provider、Agent Runtime、`apply-plan`、自动批准/修复、业务代码执行、Git 管理、网络、依赖安装、scheduler、daemon、真实项目访问、`npm pack`、registry、push 或发布。构建与测试成功不等于发布授权。
+用户于 2026-09-09 单独授权进入 `1.2.0` 发布流程。冻结候选 prepack 69/69 通过，官方 registry public 发布成功，`latest` 指向 `1.2.0`；registry tarball 与候选逐字节一致，直接安装后的 help、capabilities、init 与 clean check 冒烟通过。`v1.2.0` 精确指向冻结候选提交 `c991187c4dfd094d9cff5a4e15516fb25d74d803`。
+
+本阶段至此停止，发布授权已经消耗。Provider、Agent Runtime、`apply-plan`、自动批准/修复、业务代码执行、Git 管理、网络能力、依赖安装、scheduler、daemon、真实项目访问和后续发布仍未授权；构建、测试或本次发布成功不会扩大这些永久边界。