Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 27 additions & 0 deletions docs/active/mapcreator-recovery-gates-20260814/context.md
Original file line number Diff line number Diff line change
Expand Up @@ -124,3 +124,30 @@ Stage C 无剩余执行项。tracked dist、legacy catalog projection 与可信
| Process | Owner | Command / cwd / shared outputs | Log | Success / failure / stop | State |
| --- | --- | --- | --- | --- | --- |
| Pages/dist regeneration | `/root` | `npm run -s verify:pages-dist`;cwd `C:\Users\raede\Desktop\dev\mapcreator`;共享 `dist/` 与 `.runtime/` | `.runtime/tests/stage-c-pages-dist.log`;stderr `.runtime/tests/stage-c-pages-dist.stderr.log` | builder 913.73 MiB、startup shell 62/62、landing assets 10/10、showcase view 20/20;source/dist no-index diff clean | released / PASS |

## Post-Stage-C R1 current truth (2026-08-31)

- Reconciliation baseline:`main == origin/main == 45fbb58e70a2a212552a89f835422146bcaaed0b`,初始工作树干净且只有主 checkout。
- 原始六 Epic 路线仍有 Gate 3→5 未完成;Stage A–C 是三个基础设施 amendment,不是整条原计划的最终阶段替代。
- 当前 checked-in policy 为 schema 2、`progress.latestPhase=P4.3`;技术 source `2ee6653f` 已在 main ancestry,P4.4 recovery source `65335370` 不在 main ancestry;两个 admission marker 均未写入。
- R1 只同时启动三个文件面不重叠的候选:P4.3 current-main drift、静态 startup graph、Export vertical seam。P4.4 保持 blocked,直到主监督写入正式 `A_ADMITTED_SHA`。

### R1 task ownership

| Lane | Owner | Scope | State |
| --- | --- | --- | --- |
| R1 integration / task records / live gates | `/root` | Git/index/refs、共享 files/routes、review、frozen SHA、long gates、admission markers | active |
| P4.3 candidate | `client-new-thread:c1c90d1a-bace-48a3-b3d2-ecfd60f15fbb` | P4.3 drift、聚焦 source/policy/route fixes;不写 A marker | queued / worktree setup |
| Startup resource graph | `client-new-thread:ca61daef-6921-4702-aee0-082c280758fd` | 新 static graph/contract 与 focused tests | queued / worktree setup |
| Export vertical seam | `client-new-thread:d06e7b78-4f86-4c04-beac-944522d00bee` | Export 专属模块与 focused tests | queued / worktree setup |

### R1 live-process ownership

| Process | Owner | Command / cwd / shared outputs | Success / failure / stop | State |
| --- | --- | --- | --- | --- |
| P4.3 canonical checkpoint builder | `/root` | exact command在 source integration 后固定;目标 `tools/state_writer_policy.json` 与 supervisor-owned `.runtime` log | 同一 frozen SHA、clean identity、单 writer;相同失败三次停止重跑 | reserved / inactive |
| Pages/dist | `/root` | `verify:pages-dist` / `verify:dist-drift`;共享 `dist/`、`.runtime` | source/dist identity 与完整 gate;只在最终 candidate 运行 | reserved / inactive |
| Browser / Playwright | `/root` | localhost profile;`.runtime/browser/`、`.runtime/tests/playwright/` | exact admission journeys;端口与进程完全释放 | reserved / inactive |
| Standard performance | `/root` | `npm run -s perf:gate`;supervisor-owned log/artifact | frozen SHA、environment admitted;结构切片落定前不运行 | reserved / inactive |

Non-owner tasks 只能运行无共享输出的 focused child-safe tests。它们不得启动、轮询、重试、停止或解释以上 live process;交接时必须报告精确 commit、changed files、聚焦证据和未运行门禁。
27 changes: 27 additions & 0 deletions docs/active/mapcreator-recovery-gates-20260814/plan.md
Original file line number Diff line number Diff line change
Expand Up @@ -128,3 +128,30 @@
- Stage C baseline amendment 已由 PR #115 合并为 `9bf4bc135dd8a23b2226c7dbf6d312a2ffd0ad76`。
- C1、C2、canonical verification route 与 tracked Pages mirror 已按独立 commit 集成;本地 focused、shadow、route schema、architecture 与 Pages 合同全部通过。
- PR #116 的 10 项最终检查全部通过,并以 `df1b14fa3cee45b539e1a8d4f7976ec816c765dc` 合并到 protected `main`;候选 refs、tasks、worktrees 与临时分支均已按可恢复顺序收口,Stage C 完成。

## Original-plan continuation amendment — R1 (2026-08-31)

### Reconciled scope

- Stage A 已覆盖原 Phase A 的 City-light boot cut、ready-before-full-UI 与 `verify:commit` 基础;不代表全部 panel 已按首次打开动态加载。
- Stage B 已覆盖 `RenderSnapshot/v1` 与 `RenderChangeSet/v1` 的纯合同;live apply/undo、history/runtime/render wiring 仍属于 Gate 5。
- Stage C 已覆盖本地 CAS 的一个真实 startup-support adapter 与 road maturity 首个 projection;全 stage 产品面、artifact cutover、tracked-dist retirement、vertical feature migration 和 runtime-hook 退休均未完成。
- Gate 3、Gate 4 与 Gate 5 继续使用本计划原验收,不因 Stage A–C amendment 自动勾选。

### R1 work packages and ownership

1. **Gate 4 static startup graph**
- 独立新增 startup module/resource graph 与聚焦合同;分类 `critical`、`deferred`、`scenario-specific`、`export-only`、`dev-only`。
- 不运行真实 perf、Pages/dist、browser 或 shared `.runtime`;不修改共享 Pages builder、canonical routes 或 UI composition roots。
2. **Gate 3 Export vertical seam**
- 收口 Export lifecycle、required dependency、artifact/download transaction 与 error taxonomy 的窄接口。
- worker 只修改 Export 专属模块和 focused tests;`js/ui/toolbar.js` 的任何最终 wiring 由主监督单 owner 串行完成。
3. **Gate 5A P4.3 candidate**
- 先核对 P4.3 current-main drift 并提交聚焦 source fixes;不得写 `A_ADMITTED_SHA`。
- checkpoint generator、Pages/dist、browser、core main-thread、standard perf 与最终 admission 由主监督在 R1 source integration 后的 frozen SHA 上串行执行。

### Dependency and admission order

`R1 source candidates → supervisor integration/review → frozen SHA → P4.3 exact admission/A_ADMITTED_SHA → P4.4 semantic replay/exact admission/B_ADMITTED_SHA → Appearance/Transport live lifecycle → recoverable Demo → final release verdict`。

P4.4、live ChangeSet、tracked-dist retirement、共享 cache 与 P4.5 runtime-hook 退休都不得越过各自前置准入或授权。性能实测只在结构切片落定且 frozen SHA 可比较后运行一次,不在 R1 早期重复模拟。
25 changes: 25 additions & 0 deletions docs/active/mapcreator-recovery-gates-20260814/task.md
Original file line number Diff line number Diff line change
Expand Up @@ -151,3 +151,28 @@ Stage C boundaries: CAS 仅限仓库本机 `.runtime` / caller-provided local ro
Stage C residual: 缓存根、objects/manifests 与 prefix 的预置 symlink/reparse 已拒绝,但同权限恶意进程若在 `lstat` 与 path-based I/O 之间并发替换路径组件,仍超出当前“可信本地单写者”威胁模型;未来若扩大为共享或不可信缓存,必须先改为 handle-relative no-follow I/O。

Stage C closeout: 原始 C1/C2 候选分别保留在 `refs/archive/runtime-architecture-reset/c1-content-addressed-artifact-20260831` 与 `refs/archive/runtime-architecture-reset/c2-road-maturity-20260831`;两个 user-visible tasks 已归档,两个隔离 worktree 已解除注册,Stage C baseline/integration 临时分支已在确认进入 `main` 后删除。

## Original-plan reconciliation and continuation tranche R1 (2026-08-31)

对照“项目结构优化”原始六 Epic 路线,Stage A–C 只完成了基础切片,不能关闭原 Gate 3→5。当前精确状态如下:

- [x] 启动止血基础:Modern City Lights 退出基础启动图,map-ready 不再等待完整 UI hydration,canonical `verify:commit` 已建立。
- [x] 渲染交接基础:`RenderSnapshot/v1` 与纯 `RenderChangeSet/v1` intent 已建立。
- [ ] `RenderChangeSet/v1` live Preview / Compare / Apply / Undo、history/runtime/render wiring 尚未完成。
- [ ] Export / Startup / Interaction / Sidebar-Toolbar / Scenario chunk 五条 Gate 3 vertical seam 尚未正式验收;`map_renderer.js` import、Toolbar/Sidebar composition 与 required-dependency ratchet 尚未全部达标。
- [ ] Gate 4 startup module/resource graph、first-visible 与 artifact frozen-SHA budgets 尚未完成;本轮先实现静态确定性合同,不重复早期性能模拟。
- [ ] CAS 目前只接入 TNO startup-support 三文件;base/scenario/optional/web 产品面、共享/远端 cache 与全 stage 覆盖尚未完成。
- [ ] road maturity 目前只是首个只读 projection;其它 family、真实 consumers 与通用 feature maturity matrix 尚未完成。
- [ ] tracked `dist` retirement、generated JS/perf trace 迁移均未授权或未完成。
- [ ] `A_ADMITTED_SHA`、`B_ADMITTED_SHA`、Appearance/Transport live change-set、恢复型 Demo 与 final release verdict 均未完成。

### Active R1 execution tasks

- [~] Gate 5A P4.3 admission candidate:queued client task `client-new-thread:c1c90d1a-bace-48a3-b3d2-ecfd60f15fbb`;仅做当前主线 drift、聚焦修复与候选交付,不写 `A_ADMITTED_SHA`,不抢跑共享长门禁。
- [~] Gate 4 startup resource graph / budget contract:queued client task `client-new-thread:ca61daef-6921-4702-aee0-082c280758fd`;只新增确定性静态 graph/contract,不运行 perf、Pages、browser 或 shared `.runtime`。
- [~] Gate 3 Export vertical seam:queued client task `client-new-thread:d06e7b78-4f86-4c04-beac-944522d00bee`;独占 Export 专属模块与聚焦测试,共享 `toolbar.js` wiring 需主监督另行串行处理。
- [ ] 主监督逐个审查并整合 R1 候选,在最终 source candidate 上冻结 exact SHA。
- [ ] 冻结后由唯一 live-test owner 执行 P4.3 checkpoint/exact/Pages/browser/core-main-thread/perf 组合并写入 `A_ADMITTED_SHA`。
- [ ] A 正式准入后才创建 P4.4 replay/admission 执行任务;B 正式准入后才激活 Appearance/Transport live lifecycle。

R1 的整合顺序为:静态 startup graph → Export seam → 其它必要 source fixes → frozen SHA → P4.3 formal admission。任何在 P4.3 exact checkpoint 之后落入 source tree 的代码都必须使 admission 重新绑定最终候选,不能复用旧结果。
Loading