frontend-project-context 1.6.0 → 1.8.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +31 -0
- package/README.md +101 -48
- package/UPGRADING.md +30 -1
- package/docs/05-ACCEPTANCE-CONTRACT.md +20 -1
- package/docs/08-INSTALLATION-AND-DISTRIBUTION.md +62 -22
- package/docs/14-FORMAL-RELEASE-READINESS.md +9 -5
- package/docs/19-POST-1.3.1-AI-TAKEOVER-EVIDENCE-AND-UPGRADE-PLAN.md +5 -5
- package/docs/20-PHASE-A-AI-TAKEOVER-AND-HEALTH-CLOSURE-DESIGN.md +11 -11
- package/docs/22-PHASE-C-TARGET-UPGRADE-PROTOCOL-DESIGN.md +4 -4
- package/docs/23-ADAPTIVE-BOUNDED-TASK-CONTEXT-DESIGN.md +432 -0
- package/docs/24-A130-REAL-HOST-TARGET-PROJECT-COMPARISON.md +210 -0
- package/docs/25-REAL-PROJECT-SOURCE-OF-TRUTH-MAINTENANCE-DESIGN.md +409 -0
- package/docs/26-A130-QUALITY-CLOSURE-AND-ADAPTIVE-DELIVERY-REPAIR-DESIGN.md +609 -0
- package/docs/27-TEAM-SHARED-CONTEXT-DIRECTION-DISCUSSION.md +30 -0
- package/docs/28-REAL-PROJECT-ONBOARDING-CLOSURE-DESIGN.md +534 -0
- package/docs/AI-PROJECT-INITIALIZATION.md +89 -0
- package/docs/README.md +34 -6
- package/docs/USER-AND-AI-OPERATION-MANUAL.md +87 -40
- package/examples/README.md +6 -6
- package/examples/package.json +1 -1
- package/migration-manifest.json +42 -8
- package/package.json +2 -2
- package/schemas/adaptive-context-bundle.schema.json +70 -0
- package/schemas/capabilities.schema.json +37 -8
- package/schemas/context-query.schema.json +69 -0
- package/schemas/coverage-audit.schema.json +32 -0
- package/schemas/evidence-bundle.schema.json +2 -2
- package/schemas/host-promotion-evidence.schema.json +33 -0
- package/schemas/initialization-instruction.schema.json +60 -0
- package/schemas/migration-manifest.schema.json +3 -3
- package/schemas/migration-plan.schema.json +2 -2
- package/schemas/project-status.schema.json +5 -4
- package/schemas/projection-lock.schema.json +1 -1
- package/schemas/routing-index.schema.json +58 -0
- package/schemas/truth-reconciliation-input.schema.json +60 -0
- package/schemas/truth-reconciliation-review-bundle.schema.json +155 -0
- package/schemas/upgrade-assessment.schema.json +2 -2
- package/schemas/upgrade-result-bundle.schema.json +1 -1
- package/src/project-context/a130-evaluation.mjs +91 -0
- package/src/project-context/adaptive-context-schema.mjs +392 -0
- package/src/project-context/adaptive-context.mjs +547 -0
- package/src/project-context/ai-entry.mjs +11 -9
- package/src/project-context/assist.mjs +4 -2
- package/src/project-context/capabilities.mjs +32 -0
- package/src/project-context/checker.mjs +4 -3
- package/src/project-context/cli.mjs +55 -5
- package/src/project-context/contract-schema.mjs +1 -1
- package/src/project-context/discovery.mjs +7 -7
- package/src/project-context/exchange-schema.mjs +6 -5
- package/src/project-context/initialization-instruction.mjs +42 -0
- package/src/project-context/maintenance.mjs +2 -2
- package/src/project-context/migration-manifest.mjs +7 -5
- package/src/project-context/project-status.mjs +14 -3
- package/src/project-context/project-store.mjs +27 -2
- package/src/project-context/renderer.mjs +75 -1
- package/src/project-context/source-reader.mjs +63 -30
- package/src/project-context/task-context.mjs +14 -2
- package/src/project-context/truth-reconciliation-schema.mjs +488 -0
- package/src/project-context/truth-reconciliation.mjs +543 -0
- package/src/project-context/upgrade-schema.mjs +5 -1
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
> 权威说明:本文是支持性设计文档;当前唯一规范真源是 [00-PRODUCT-CONSTITUTION.md](./00-PRODUCT-CONSTITUTION.md)。
|
|
4
4
|
|
|
5
|
-
状态:`frontend-project-context@1.
|
|
5
|
+
状态:`frontend-project-context@1.7.0` 已发布到 public npm,registry 工件逐字节匹配并完成全新项目回装初始化;195/195、真实 PC 初始化与 A-130 有界 Host/Provider 终验均通过
|
|
6
6
|
适用项目:`dtg-frontend-delivery-agent`
|
|
7
7
|
本文记录产品如何交付、安装、共享、升级和验证;它不自行授权打包、registry、Git 或发布操作。
|
|
8
8
|
|
|
@@ -38,19 +38,38 @@ CI 安装项目锁定的依赖版本并执行只读检查。CI 不依赖机器
|
|
|
38
38
|
|
|
39
39
|
## 3. 推荐安装路径
|
|
40
40
|
|
|
41
|
-
### 3.1
|
|
41
|
+
### 3.1 正式安装:先固定项目开发依赖
|
|
42
42
|
|
|
43
|
-
|
|
43
|
+
持久初始化前,先把精确版本安装为项目开发依赖:
|
|
44
44
|
|
|
45
45
|
```bash
|
|
46
|
-
|
|
47
|
-
pnpm dlx frontend-project-context@1.3.1 setup --project . --id PROJECT_ID --name "Project Name" --json
|
|
48
|
-
bunx frontend-project-context@1.3.1 setup --project . --id PROJECT_ID --name "Project Name" --json
|
|
46
|
+
npm install --save-dev frontend-project-context@1.8.0
|
|
49
47
|
```
|
|
50
48
|
|
|
51
|
-
|
|
49
|
+
包名冻结为 `frontend-project-context`,可执行文件名为 `project-context`。安装必须先于任何持久初始化写入,使 discovery 登记的 `package.json` digest 已包含正式依赖,避免补装工具后立即产生 `source-changed`。`1.8.0` 已通过本地 O-01 至 O-12、完整回归与隔离真实项目的无历史 Host 发布阻断验收。
|
|
52
50
|
|
|
53
|
-
|
|
51
|
+
选择项目内安装而不是全局安装,原因是:
|
|
52
|
+
|
|
53
|
+
- 团队成员和 CI 使用相同版本;
|
|
54
|
+
- 不同项目可以独立升级;
|
|
55
|
+
- 依赖升级及生成物变化可以通过 Git diff 审查;
|
|
56
|
+
- 全局环境变化不会改变项目输出;
|
|
57
|
+
- 回滚项目版本时可以同步回滚 DTG 行为。
|
|
58
|
+
|
|
59
|
+
### 3.2 首次初始化:只运行已安装的本地 CLI
|
|
60
|
+
|
|
61
|
+
先确认本地包存在,再从本地依赖读取唯一初始化指令:
|
|
62
|
+
|
|
63
|
+
```bash
|
|
64
|
+
npm exec --offline -- project-context instructions --project . --prompt
|
|
65
|
+
npm exec --offline -- project-context status --project . --json
|
|
66
|
+
```
|
|
67
|
+
|
|
68
|
+
唯一流程正文是 [AI-PROJECT-INITIALIZATION.md](./AI-PROJECT-INITIALIZATION.md)。本文件只说明安装与分发,不复制另一套 Host 初始化步骤。
|
|
69
|
+
|
|
70
|
+
`--offline` 使本地 CLI 缺失时失败封闭,不允许 npm 临时下载无关的同名 `project-context` 包。确需一次性运行器时,只允许用精确包名和版本做零写 preview;任何 `setup --write` 前仍必须先完成项目内固定安装。
|
|
71
|
+
|
|
72
|
+
作为底层原语,`setup` 只负责:
|
|
54
73
|
|
|
55
74
|
- 在内存中构造与 `init` 相同的空 store 并复用保守 discovery;
|
|
56
75
|
- 输出包含候选、`readTargets` 和 `workUnits` 的 Assist Bundle;
|
|
@@ -60,23 +79,13 @@ bunx frontend-project-context@1.3.1 setup --project . --id PROJECT_ID --name "Pr
|
|
|
60
79
|
|
|
61
80
|
初始化不得自动访问网络、安装额外依赖、批准规范候选、生成投影或修改业务代码。
|
|
62
81
|
|
|
63
|
-
### 3.
|
|
82
|
+
### 3.3 明确授权的全新初始化
|
|
64
83
|
|
|
65
|
-
|
|
84
|
+
`setup` 对已初始化项目是幂等的,不是 reset 或翻译命令。需要用正式包重新初始化时,Host 必须先盘点并留存人工 policy、validation-description、manual source 和批准决定;用 `remove-entry` 只移除所有权可信的受管区域;再由人明确授权外部工具精确清理可丢弃的 `.project-context`;确认状态回到 `uninitialized` 后,按 3.1、3.2 顺序重建并重新批准所保留的人工语义。
|
|
66
85
|
|
|
67
|
-
|
|
68
|
-
pnpm add -D frontend-project-context@1.3.1
|
|
69
|
-
```
|
|
86
|
+
如果 `AGENTS.md` 既是人工 source 又承载 AI Entry,首次发布区域会按既有设计产生一次预期的 `source-changed`。Host 必须继续执行 `review-source → accept-source-change → reapprove → check/status`,不能把入口写入隐式当作 source acceptance。
|
|
70
87
|
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
- 团队成员和 CI 使用相同版本;
|
|
74
|
-
- 不同项目可以独立升级;
|
|
75
|
-
- 依赖升级及生成物变化可以通过 Git diff 审查;
|
|
76
|
-
- 全局环境变化不会改变项目输出;
|
|
77
|
-
- 回滚项目版本时可以同步回滚 DTG 行为。
|
|
78
|
-
|
|
79
|
-
### 3.3 团队消费:静态投影随仓库分发
|
|
88
|
+
### 3.4 团队消费:静态投影随仓库分发
|
|
80
89
|
|
|
81
90
|
由 DTG 从唯一的 `Project Contract` 生成、且体积可控的静态 Agent 投影,默认应提交到仓库。
|
|
82
91
|
|
|
@@ -241,3 +250,34 @@ IDE 插件可以在未来提供状态提示、冲突解释和可视化配置,
|
|
|
241
250
|
`1.6.0` 新增只读 `upgrade-check`、`upgrade-plan` 与默认 preview 的 `upgrade-apply`,公开 Migration Manifest schema 2 和三份升级工件 schema 1。依赖/lockfile 切换仍由 Host 在外部完成;工具只评估当前 Project Context store、受管 AI Entry/projection 与 manifest 声明的协议兼容面,并在精确 `--write` 下执行一份 plan 展示的一个已编译、产品自有单元。
|
|
242
251
|
|
|
243
252
|
实现 Gate 为 120/120 本地隔离测试通过。capabilities/Exchange Protocol 为 4,Action Plan/Review Bundle 仍为 2,现有 store/renderer 目标版本不变。`coreMigration: complete` 不等于依赖、CI、新窗口或发布完成。没有执行候选打包、真实 Host/目标项目升级、Git、网络、包管理器或 npm 发布;这些仍需要新的独立授权。
|
|
253
|
+
|
|
254
|
+
## 17. `1.7.0` 真实 PC 包初始化验收
|
|
255
|
+
|
|
256
|
+
2026-09-14 在 `dtg-tmc-pc` 的隔离副本上执行了一次无网络、无 Provider、无 Git 写入的真实包消费验收。候选 tarball 版本为 `1.7.0`,共 99 个文件,解包约 1.3 MB;包的 prepack Gate 通过 195/195。精确工件摘要只记录在不进入 npm 包的 `PROJECT_STATE.json`,避免可分发文档引用自身 tarball 摘要形成自引用。
|
|
257
|
+
|
|
258
|
+
消费端使用安装后的项目本地 `project-context` 完成:
|
|
259
|
+
|
|
260
|
+
1. `status` 判定未初始化,`setup` preview 零写入;
|
|
261
|
+
2. `setup --write` 只创建 `.project-context` 和候选建议;
|
|
262
|
+
3. 人工授权审批 19 项从现有文件直接发现的客观事实与 `AGENTS.md` 引用;
|
|
263
|
+
4. `publish-entry --write` 仅追加中文受管区域,原有人工 `AGENTS.md` 字节保留;
|
|
264
|
+
5. 因 `AGENTS.md` 同时是已登记真源,按 3.3 的既定边界执行一次 `review-source → accept-source-change → approve --pending`,没有隐式批准;
|
|
265
|
+
6. `check` 返回空 findings,`status` 返回 `health: clean` 和 `ready-for-task`;
|
|
266
|
+
7. 针对 `src/components/flight/non-whitelist-confirm.vue` 与 `src/components/center/protocolPriceDialog.vue` 的真实行李展示任务,`context --locale zh-CN` 成功产生中文 Project Context Bundle。
|
|
267
|
+
|
|
268
|
+
原始 PC 仓库全程保持干净,没有写入业务代码、`AGENTS.md`、`package.json`、lockfile 或 `.project-context`。本次结果证明 `1.7.0` 候选包能在真实 PC 项目结构中完成初始化并进入正常任务路径。后续 A-130 有界 Host/Provider 终验已通过,见 `docs/24` 第 11 节;A-144 不属于本次发布范围。
|
|
269
|
+
|
|
270
|
+
## 18. `1.7.0` public npm 发布与 registry 回装
|
|
271
|
+
|
|
272
|
+
`2026-09-14`,release commit `d5b6389` 与 tag `v1.7.0` 已推送,精确冻结的 99 文件 tarball 发布为 public npm 的 `frontend-project-context@1.7.0`。registry 的 `latest`、SHA-1 与 SHA-512 integrity 均指向该版本;重新下载后的 SHA-256 为 `42d83423d61831b4bf0d4b1bc39e29731e18acf181827abe699c60fb512fb4af`,与冻结候选逐字节一致。
|
|
273
|
+
|
|
274
|
+
独立回装在全新临时项目中从 registry 安装精确 `1.7.0`,然后只使用安装后的 `npm exec --offline -- project-context`:
|
|
275
|
+
|
|
276
|
+
1. capabilities 报告包版本 `1.7.0`、schema 7 与 Exchange Protocol 7;
|
|
277
|
+
2. status 正确识别为 `uninitialized`,setup preview 零写入;
|
|
278
|
+
3. setup write 后由人显式批准四项直接发现的客观事实;
|
|
279
|
+
4. publish-entry 仅追加 renderer 3 受管区域;
|
|
280
|
+
5. 对登记的 `AGENTS.md` 执行一次精确 source acceptance 与重审批;
|
|
281
|
+
6. check 无 findings,status 为 `clean/ready-for-task`,正常中文任务 context 成功生成。
|
|
282
|
+
|
|
283
|
+
发布工件、Git 与回装证据全部闭合,本次 release 权限已经消费。
|
|
@@ -115,14 +115,18 @@ registry/可见性决策、发布者认证、A-39/pack、release commit、`v1.0.
|
|
|
115
115
|
|
|
116
116
|
本次授权只完成既定 `1.3.1` 修复发布,不授权 `ci-reconciliation-artifacts`、Provider、Agent Runtime、任务执行、自动批准、产品内 Git/网络能力、真实业务项目试用、团队验收、公共源码仓库创建或后续发布。发布授权已经消耗。
|
|
117
117
|
|
|
118
|
-
## 12. `1.6.0` Target Upgrade Protocol
|
|
118
|
+
## 12. `1.6.0` Target Upgrade Protocol 正式发布
|
|
119
119
|
|
|
120
|
-
用户于 `2026-09-11` 明确授权 `1.6.0` 发布候选整理、Git commit/tag/push、官方公共 npm 发布与 registry
|
|
120
|
+
用户于 `2026-09-11` 明确授权 `1.6.0` 发布候选整理、Git commit/tag/push、官方公共 npm 发布与 registry 独立复验。冻结候选来自提交 `14fc66ec2dd0524bfb94bd735c8ddc4dfd9a9e14`,远端 `v1.6.0` 精确指向该提交;发布后状态记录留在后续提交,避免改变标签对应的包源码。
|
|
121
121
|
|
|
122
|
-
|
|
122
|
+
发布验证记录:
|
|
123
|
+
|
|
124
|
+
1. `npm run check` 120/120 通过;
|
|
123
125
|
2. tarball 白名单审查,不包含测试、Git、自托管 `.project-context/`、`PROJECT_STATE.json` 或 `RTK.md`;
|
|
124
126
|
3. 候选 tarball 全新安装后的 version/help/capabilities/status/init/clean-check 冒烟;
|
|
125
127
|
4. 通过包内 manifest 完成 `1.3.1 → check → plan → preview → apply → recheck` 独立冒烟;
|
|
126
|
-
5.
|
|
128
|
+
5. tarball 包含 83 个文件,压缩大小 272766 bytes、解包大小 972317 bytes,SHA-1 为 `9d3d196900460af86801e9cd543be4d2d9e326ca`,integrity 为 `sha512-dIwhRxARBSvz1uxt+mvXsJEtZfNs1pQVxrVjFQxbw9arbBHzbF4hiUfoURpP+YEazI5dRjZOsDJpIguw0EDJow==`;
|
|
129
|
+
6. `fushanyx1` 于 `2026-09-11T05:45:25.010Z` 向官方 registry public 发布 `frontend-project-context@1.6.0`,`latest` 已指向该版本;
|
|
130
|
+
7. 从 registry 重新下载的 tarball 与候选逐字节一致,随后在全新目录从 registry 安装,version/help/capabilities/status/init/publish-entry/clean-check 全部通过。
|
|
127
131
|
|
|
128
|
-
该授权不包含真实目标项目升级、Phase D 其余适配器、Provider/Agent Runtime
|
|
132
|
+
该授权不包含真实目标项目升级、Phase D 其余适配器、Provider/Agent Runtime、自动批准或新产品能力。本次实现与发布授权均已消耗。
|
|
@@ -2,9 +2,9 @@
|
|
|
2
2
|
|
|
3
3
|
> 权威说明:本文收敛 `frontend-project-context@1.3.1` 发布后的产品讨论,定义后续设计基线和分期路线。如与 [00-PRODUCT-CONSTITUTION.md](./00-PRODUCT-CONSTITUTION.md) 冲突,以产品宪法为准。
|
|
4
4
|
>
|
|
5
|
-
> 状态:`frozen-overall-design;
|
|
5
|
+
> 状态:`frozen-overall-design; phases-a-b-c-implemented-and-published-in-1.6.0`
|
|
6
6
|
>
|
|
7
|
-
> 基线:`frontend-project-context@1.
|
|
7
|
+
> 基线:`frontend-project-context@1.6.0` 是当前已发布并完成 registry 独立复验的版本;真实目标项目升级与 Host 验收尚未授权。
|
|
8
8
|
|
|
9
9
|
## 1. 总结论
|
|
10
10
|
|
|
@@ -505,7 +505,7 @@ Upgrade Result Bundle 可以记录 before/after 版本、schema、renderer、迁
|
|
|
505
505
|
|
|
506
506
|
目标:把目标项目从旧版本安全、可解释地带到新版本并回到 healthy。
|
|
507
507
|
|
|
508
|
-
状态:`1.6.0` 已按 [22-PHASE-C-TARGET-UPGRADE-PROTOCOL-DESIGN.md](./22-PHASE-C-TARGET-UPGRADE-PROTOCOL-DESIGN.md) 完成本地实现与 120/120
|
|
508
|
+
状态:`1.6.0` 已按 [22-PHASE-C-TARGET-UPGRADE-PROTOCOL-DESIGN.md](./22-PHASE-C-TARGET-UPGRADE-PROTOCOL-DESIGN.md) 完成本地实现与 120/120 验收,Git、候选打包、公开 npm 发布与 registry 逐字节一致性/全新安装复验均已完成;真实目标项目升级仍不在本次范围。
|
|
509
509
|
|
|
510
510
|
- migration manifest schema 和包内发布义务;
|
|
511
511
|
- upgrade check/plan/apply 详细合同;
|
|
@@ -568,7 +568,7 @@ Upgrade Result Bundle 可以记录 before/after 版本、schema、renderer、迁
|
|
|
568
568
|
|
|
569
569
|
## 18. 本文停止点
|
|
570
570
|
|
|
571
|
-
本文已将 `1.3.1` 后讨论收敛并归档为冻结总体设计。Phase A 合同见 [20-PHASE-A-AI-TAKEOVER-AND-HEALTH-CLOSURE-DESIGN.md](./20-PHASE-A-AI-TAKEOVER-AND-HEALTH-CLOSURE-DESIGN.md),已完成 `1.4.0` 本地实现;Phase B 合同见 [21-PHASE-B-EVIDENCE-FEEDBACK-PROTOCOL-DESIGN.md](./21-PHASE-B-EVIDENCE-FEEDBACK-PROTOCOL-DESIGN.md),已完成 `1.5.0` 本地实现;Phase C 合同见 [22-PHASE-C-TARGET-UPGRADE-PROTOCOL-DESIGN.md](./22-PHASE-C-TARGET-UPGRADE-PROTOCOL-DESIGN.md)
|
|
571
|
+
本文已将 `1.3.1` 后讨论收敛并归档为冻结总体设计。Phase A 合同见 [20-PHASE-A-AI-TAKEOVER-AND-HEALTH-CLOSURE-DESIGN.md](./20-PHASE-A-AI-TAKEOVER-AND-HEALTH-CLOSURE-DESIGN.md),已完成 `1.4.0` 本地实现;Phase B 合同见 [21-PHASE-B-EVIDENCE-FEEDBACK-PROTOCOL-DESIGN.md](./21-PHASE-B-EVIDENCE-FEEDBACK-PROTOCOL-DESIGN.md),已完成 `1.5.0` 本地实现;Phase C 合同见 [22-PHASE-C-TARGET-UPGRADE-PROTOCOL-DESIGN.md](./22-PHASE-C-TARGET-UPGRADE-PROTOCOL-DESIGN.md),现已随 `1.6.0` 完成 120/120、正式发布与 registry 独立复验。到此仍应停止,不得自动:
|
|
572
572
|
|
|
573
573
|
- 修改产品代码、CLI 或 schema;
|
|
574
574
|
- 修改产品宪法;
|
|
@@ -576,4 +576,4 @@ Upgrade Result Bundle 可以记录 before/after 版本、schema、renderer、迁
|
|
|
576
576
|
- 创建 Git 分支、提交、tag、push 或发布 npm;
|
|
577
577
|
- 把 Phase A、B、C 或 D 的顺序解读为实现授权。
|
|
578
578
|
|
|
579
|
-
用户于 `2026-09-11` 进一步授权 `1.6.0` 发布候选整理、Git commit/tag/push、公开 npm 发布与 registry
|
|
579
|
+
用户于 `2026-09-11` 进一步授权 `1.6.0` 发布候选整理、Git commit/tag/push、公开 npm 发布与 registry 独立复验;该有界发布流程已完成,授权已消耗。当前唯一下一步是等待用户选择 `1.6.0` 之后的产品方向;Phase D 其余适配器和真实目标项目验收仍未授权。
|
|
@@ -185,20 +185,20 @@ partial / invalid
|
|
|
185
185
|
|
|
186
186
|
```md
|
|
187
187
|
<!-- project-context:ai-entry:start -->
|
|
188
|
-
<!-- project-context:ai-entry; schema-version: 1; renderer-version:
|
|
189
|
-
## Project Context
|
|
188
|
+
<!-- project-context:ai-entry; schema-version: 1; renderer-version: 3 -->
|
|
189
|
+
## Project Context 启动流程
|
|
190
190
|
|
|
191
|
-
|
|
191
|
+
开始项目工作前,使用项目本地安装的 `frontend-project-context` CLI,不要临时下载其他版本。
|
|
192
192
|
|
|
193
|
-
1.
|
|
194
|
-
2.
|
|
195
|
-
3.
|
|
196
|
-
4.
|
|
197
|
-
5.
|
|
193
|
+
1. 运行 `npm exec --offline -- project-context status --project . --json`;如果本地依赖不存在,停止并报告,不要临时下载同名包。
|
|
194
|
+
2. 如果状态为 `partial` 或 `invalid`,停止写入并报告准确的恢复证据。
|
|
195
|
+
3. 如果尚未初始化,先预览 `setup`;如果已初始化但需要处理,使用 `sync` 工作单元;如果为 `clean`,继续遵守本文件其余仓库规则,并执行已获授权的用户任务。
|
|
196
|
+
4. 任何 plan、bundle、receipt、review 或 AI 建议都不代表人工批准。
|
|
197
|
+
5. 声明完成前,将 Project Context 恢复为 `clean`,否则报告准确的阻断项。
|
|
198
198
|
<!-- project-context:ai-entry:end -->
|
|
199
199
|
```
|
|
200
200
|
|
|
201
|
-
|
|
201
|
+
`1.7.0` 将默认人类可读文案调整为中文,并把 AI Entry renderer 升为 3。renderer 1/2 区域继续可读但报告 stale,只有显式 republish 才升级;机器字段、命令、marker、ID 和枚举继续使用稳定英文。renderer 3 使用 `npm exec --offline -- project-context`,本地依赖缺失时失败封闭,不允许 `npx project-context` 回退下载无关同名包。文案不得增加项目特定事实、当前任务、升级指令或联网安装。
|
|
202
202
|
|
|
203
203
|
### 6.2 字节级所有权
|
|
204
204
|
|
|
@@ -309,7 +309,7 @@ Assist Bundle、Task Context Plan、Stage Receipt、Stage Context Bundle 和 Int
|
|
|
309
309
|
- `schemas.projectStatus: 1`;
|
|
310
310
|
- `schemas.projectionLockReadable: [1, 2]`;
|
|
311
311
|
- `schemas.projectionLockWritten: 1 | 2` 的状态说明;
|
|
312
|
-
- `schemas.aiEntryRenderer: 1
|
|
312
|
+
- `schemas.aiEntryRenderer: 3`(renderer 1/2 继续可读,显式 republish 后写 renderer 3 中文安全入口);
|
|
313
313
|
- `commands` 中的 `status`、`publish-entry`、`remove-entry`;
|
|
314
314
|
- `actionKinds` 中的两种 AI Entry action;
|
|
315
315
|
- `boundaries.telemetry: false`、`boundaries.selfUpdate: false`。
|
|
@@ -491,7 +491,7 @@ status: uninitialized | initialized-attention
|
|
|
491
491
|
- **A-77 未初始化状态**:空项目连续调用 `status` 输出稳定、零写入,state/health/nextActions 正确,不创建 `.project-context`。
|
|
492
492
|
- **A-78 partial 与 invalid**:三种 partial 组合和代表性 schema/JSON 损坏均返回结构化状态与退出码 2,所有 bytes 不变,不猜测修复。
|
|
493
493
|
- **A-79 initialized health**:clean、source changed、pending、verification failed、projection stale 和 ownership conflict 的分类与现有 check/sync 完全一致。
|
|
494
|
-
- **A-80 Entry preview/create**:无 `AGENTS.md` 和已有人工文件的 preview 均零写入;write 只创建/插入精确区域,区域外字节、BOM
|
|
494
|
+
- **A-80 Entry preview/create**:无 `AGENTS.md` 和已有人工文件的 preview 均零写入;write 只创建/插入精确区域,区域外字节、BOM 和换行保持;入口只调用离线项目本地 CLI,禁止模糊 `npx project-context`。
|
|
495
495
|
- **A-81 区域所有权**:区域外人工编辑不冲突;区域内编辑、marker 缺失/重复/嵌套、lock 错配均失败封闭且不覆盖。
|
|
496
496
|
- **A-82 Entry 更新与移除**:可信区域可确定性 unchanged/update/remove;remove 只移除受管字节和 lock entry,不删文件或区域外内容。
|
|
497
497
|
- **A-83 source 共存**:已登记人工 `AGENTS.md` 时,preview 完整列出影响;写入后仍必须经 accept/reapprove 才恢复 clean,不隐式接受 digest。
|
|
@@ -2,11 +2,11 @@
|
|
|
2
2
|
|
|
3
3
|
> 权威说明:本文是 [19-POST-1.3.1-AI-TAKEOVER-EVIDENCE-AND-UPGRADE-PLAN.md](./19-POST-1.3.1-AI-TAKEOVER-EVIDENCE-AND-UPGRADE-PLAN.md) 中 Phase C 的可开发合同。如与 [00-PRODUCT-CONSTITUTION.md](./00-PRODUCT-CONSTITUTION.md) 冲突,以产品宪法为准。
|
|
4
4
|
>
|
|
5
|
-
> 状态:`implemented-
|
|
5
|
+
> 状态:`implemented-and-published-public-npm-verified`
|
|
6
6
|
>
|
|
7
7
|
> 目标版本:`frontend-project-context@1.6.0`
|
|
8
8
|
>
|
|
9
|
-
>
|
|
9
|
+
> 发布基线:`frontend-project-context@1.6.0` 已于 `2026-09-11` 发布到官方公共 npm,候选与 registry tarball 逐字节一致,并完成全新 registry 安装冒烟。真实目标项目升级仍未授权。
|
|
10
10
|
|
|
11
11
|
## 1. 结论
|
|
12
12
|
|
|
@@ -389,10 +389,10 @@ Frontend Project Context 最多声称 `coreMigration: complete`。整体升级
|
|
|
389
389
|
3. 在真实目标项目中升级依赖、写 store/projection、执行测试或新窗口验收需要独立范围授权;
|
|
390
390
|
4. Git commit/tag/push、候选打包、网络和 npm 发布需要新的明确授权。
|
|
391
391
|
|
|
392
|
-
用户于 `2026-09-11` 已给予第 4 项授权,范围限于 `1.6.0` 发布候选整理、Git commit/tag/push、公开 npm 发布与 registry
|
|
392
|
+
用户于 `2026-09-11` 已给予第 4 项授权,范围限于 `1.6.0` 发布候选整理、Git commit/tag/push、公开 npm 发布与 registry 独立复验;该授权已全部执行并消耗,不包含真实目标项目升级或新产品能力。
|
|
393
393
|
|
|
394
394
|
## 19. 停止点
|
|
395
395
|
|
|
396
396
|
本文已冻结 `1.6.0` 的用户问题、产品边界、CLI、manifest 与三份工件 schema、单步收敛、兼容矩阵、并发/失败/回滚、协议版本、文件范围与 A-101 至 A-114。
|
|
397
397
|
|
|
398
|
-
用户于 `2026-09-11` 明确授权“按 docs/22 实现 1.6.0
|
|
398
|
+
用户于 `2026-09-11` 明确授权“按 docs/22 实现 1.6.0”,随后又授权完整发布流程。实现与 A-01 至 A-114 共 120/120、候选打包、`v1.6.0` tag/push、官方公共 npm 发布、registry 逐字节一致性和全新安装冒烟均已完成。当前应停止:实现与发布授权均已消耗,真实目标项目升级、Host 验收、Phase D 其余适配器、新产品实现或后续发布均需要新的明确授权。
|