diff --git a/.planning/phases/09-minimum-browser-runnable/09-21-PLAN.md b/.planning/phases/09-minimum-browser-runnable/09-21-PLAN.md index c08773f..b3d3862 100644 --- a/.planning/phases/09-minimum-browser-runnable/09-21-PLAN.md +++ b/.planning/phases/09-minimum-browser-runnable/09-21-PLAN.md @@ -34,7 +34,7 @@ must_haves: - "**D-99 / D-100：** 构建仍前置 `vue-tsc --noEmit`（保留于 `build:game`）；移除 `main.js` 二次压缩（babel）步骤与相关依赖引用；`manualChunks` 按实际依赖微调——`audio` chunk（`codec-parser` / `opus-decoder` / `ogg-opus-decoder` / `@wasm-audio-decoders/ogg-vorbis`）保留，`antdv` chunk 移除（全仓源码无 `ant-design-vue` / `@ant-design/icons-vue` 导入）；`@vitejs/plugin-legacy` 维持现状（目标浏览器列表不变）。" - "**写入边界（D-56 / AGENTS.md / 用户裁定「你改 src，我做脚本」）：** 只允许写 `files_modified` 所列路径；**完全不修改 `src/**`**（含 `src/bootstrap.ts`、`src/data/**`、`src/client/**`，以及用户待修复的两处 stale import）；不回退用户既有改动（`index.html`、`packages-user/client-modules/src/**`、`src/**` 等 WIP）；不改数据端/渲染端源码、`public/**`、`vite.config.ts`、lockfile、`.planning/ROADMAP.md` / `STATE.md` / `09-CONTEXT.md` / 既有 PLAN 与 SUMMARY。`dev.md` 仅按 W5 更新构建命令表中的 `build:packages` / `build:lib` / `build:game` 三行。**范围门禁以 Task 0 的 baseline 快照为基线：任何相对 baseline 新增或被二次修改的 `src/**` / `09-CONTEXT.md` 路径一律判负，不得整体白名单放行 `src/`。**" - "**命名须先获批（AGENTS.md / D-04）：** 新增文件 `script/vite-plugin-data-isolation.ts`、导出 `dataIsolationPlugin`、插件 `name: 'mota-data-isolation'`、测试文件 `script/vite-plugin-data-isolation.test.ts`（OI-1）；`script/build-resource.ts` 新导出 `buildContent` / `minifyJSONC` / `IContentBuildOptions` / `IContentBuildStats` 与测试文件 `script/build-resource.test.ts`（OI-2）。**类型一致性（W2）：`IContentBuildOptions.chars` 为 `string`，`getAllChars` 相应返回 `Promise`（`[...set].join('')`），`Fontmin.glyph({ text })` 收到的是字符串。** 未获批前不得落码（测试文件按 AGENTS.md 免审批，但仍列入报备）。" - - "**验证可运行性（Nyquist）与门禁分层：** Task 1 以**真实 Vite `build()`** 驱动插件单测（渲染端 specifier（**未设 alias 的 `vue`**）被拒 / 渲染端解析路径（`packages-user/client-*`、`packages/render*`、`packages/client*`、`packages/system`、`packages/audio`、`packages/legacy-*`、`src/client`）被拒**且错误含命中 token** / 纯数据端通过并输出 ESM / 数据端路径不误判）；Task 2 以 `minifyJSONC` / `buildContent` 单测 + 构建脚本结构断言（含**数据先于渲染的调用顺序**、**`dist` 只清空一次**、**两处 `emptyOutDir: false`**）+ 产物门禁 + **baseline 范围门禁**兜底；`pnpm exec tsx script/build-game.ts` **必须实跑**。**数据端 ESM 是独立硬门禁**：数据端先构建，`dist/data/data.js` 必须存在且含 `export`，否则 `bad.push` + 非零；**不因渲染端失败而跳过**。**渲染端产物门禁是条件分支**：`dist/index.html` 存在 → 断言不含 `styles.css` link；不存在 → 打印 BLOCKED 说明（渲染端因用户 `src/**` stale import 失败），而 `dist/data/data.js`、`dist/content/**`、`dist/LICENSE` 仍照常断言。**不存在任何无条件通过承诺。**" + - "**验证可运行性（Nyquist）与门禁分层：** Task 1 以**真实 Vite `build()`** 驱动插件单测（渲染端 specifier（**未设 alias 的 `vue`**）被拒 / 渲染端解析路径（`packages-user/client-*`、`packages/render*`、`packages/client*`、`packages/system`、`packages/audio`、`packages/legacy-*`、`src/client`）被拒**且错误含命中 token** / 纯数据端通过并输出 ESM / 数据端路径不误判）；Task 2 以 `minifyJSONC` / `buildContent` 单测 + 构建脚本结构断言（含**数据先于渲染的调用顺序**、**`dist` 只清空一次**、**两处 `emptyOutDir: false`**）+ 产物门禁 + **baseline 范围门禁**兜底；`cmd /c \"pnpm exec tsx script/build-game.ts\"` **必须实跑**（本仓 PowerShell 5.1 下裸 `pnpm` 会因 `pnpm.ps1` 的 `PSSecurityException` 失败，故一律经 `cmd /c` 调用），且**构建进程必须在有界时间内显式退出**（见 Task 2 的显式 `process.exit(...)` 要求）。**数据端 ESM 是独立硬门禁**：数据端先构建，`dist/data/data.js` 必须存在且含 `export`，否则 `bad.push` + 非零；**不因渲染端失败而跳过**。**渲染端产物门禁是条件分支**：`dist/index.html` 存在 → 断言不含 `styles.css` link；不存在 → 打印 BLOCKED 说明（渲染端因用户 `src/**` stale import 失败），而 `dist/data/data.js`、`dist/content/**`、`dist/LICENSE` 仍照常断言。**不存在任何无条件通过承诺。**" artifacts: - path: script/vite-plugin-data-isolation.ts provides: "新增 Vite 插件 `dataIsolationPlugin`：`enforce: 'pre'` + `resolveId` 拦渲染端 specifier，`moduleParsed` 按解析后绝对路径拦渲染端包（含传递依赖与 `src/client/**`），命中即 `this.error(...)` 终止数据端构建；错误消息含 `[mota-data-isolation]` + 命中模块 + **命中 token（`matched: `）** + importers（命名待批准，OI-1）" @@ -57,10 +57,10 @@ must_haves: - path: dev.md provides: "构建命令表同步：删除 `build:packages` / `build:lib` 两行，更新 `build:game` 说明（类型检查 + 渲染端游戏 + 数据端 ESM + content）；不改其它章节" - path: .planning/phases/09-minimum-browser-runnable/09-21-SUMMARY.md - provides: "本计划执行摘要：范围、插件扫描口径与错误行为（含命中 token）、content 压缩口径（含标记保留这一兼容性约束）、dist 产物清单与排除项、删除清单、`dev.md` 同步、`open_items` 最终处置、门禁结果（渲染端 BLOCKED 分支或成功分支）、数据端 ESM 硬门禁结果、渲染端两处 stale import 的当前状态、baseline 范围门禁结果" + provides: "本计划执行摘要：范围、插件扫描口径与错误行为（含命中 token）、content 压缩口径（含标记保留这一兼容性约束）、dist 产物清单与排除项、删除清单、`dev.md` 同步、`open_items` 最终处置、门禁结果（渲染端 BLOCKED 分支或成功分支）、数据端 ESM 硬门禁结果、渲染端两处 stale import 的当前状态、**D-97「样式经入口 JS 引入」不由本计划交付的显式声明（`src/styles.less` 全仓无 import 点；移除 link 后、用户接线前 `dist` 缺 `#game-draw` 居中样式，OI-5；不静默降级）**、baseline 范围门禁结果" key_links: - "`dataIsolationPlugin`（`script/vite-plugin-data-isolation.ts`）↔ `buildData` 的 `plugins` 数组（`script/build-game.ts`）—— D-94 的唯一执行点；取代 `checkClientData` 体积启发式" - - "插件 `this.error` 错误文本（含 `mota-data-isolation`、命中模块与**命中 token**）↔ `buildGame` 的数据端 `.catch` 分类 —— 归一化后（`String(reason)` 上把 Windows 反斜杠替换为 `/`，**源码单反斜杠正则**）同时匹配插件标识与已知渲染端 token（`@motajs/render` / `packages/render` / `packages/render-vue` / `packages/client` / `packages/system` / `packages/audio` / `packages/legacy-` / `packages-user/client-` / `src/client`）才标记为 **OI-11 回归诊断**；其它数据端错误标记为普通数据端失败；两条路径都使最终退出码非零（数据端 ESM 是硬门禁）" + - "插件 `this.error` 错误文本（含 `mota-data-isolation`、命中模块与**命中 token**）↔ `buildGame` 的数据端 `.catch` 分类 —— 归一化后（`String(reason)` 上把 Windows 反斜杠替换为 `/`，**源码单反斜杠正则**）同时匹配插件标识与已知渲染端 token（`@motajs/render` / `@motajs/client` / `@motajs/system` / `@motajs/audio` / `@motajs/legacy-` / `@user/client-` / `packages/render` / `packages/render-vue` / `packages/client` / `packages/system` / `packages/audio` / `packages/legacy-` / `packages-user/client-` / `src/client`）才标记为 **OI-11 回归诊断**；其它数据端错误标记为普通数据端失败；两条路径都使最终退出码非零（数据端 ESM 是硬门禁）" - "`buildGame` 的调用顺序 `await buildData(` 先于 `await buildClient(` ↔ 数据端产物与渲染端解耦（D-95 / B1）—— 渲染端失败不会抹掉 `dist/data/data.js`；清空 `dist` 只在准备步骤执行一次，两次构建均 `emptyOutDir: false`" - "`buildData` 的 `build.lib.fileName: 'data'` + `formats: ['es']` ↔ `dist/data/data.js` —— D-95 产物契约（硬门禁）" - "`minifyJSONC` 的标记保留 ↔ `PrefixedJSONCProcessor.process`（`packages-user/data-state/src/loader/jsoncProcessor.ts:14-18`，`split(prefixSplit)` 要求恰好 2 段）—— 丢失标记会导致运行期 error 66 / `{}`" @@ -90,7 +90,7 @@ must_haves: - "**未经批准的命名一律不得使用：** `script/vite-plugin-data-isolation.ts` / `dataIsolationPlugin` / `mota-data-isolation` / `script/vite-plugin-data-isolation.test.ts`（OI-1）与 `buildContent` / `minifyJSONC` / `IContentBuildOptions` / `IContentBuildStats` / `script/build-resource.test.ts`（OI-2）必须先经 Task 0 报备并获批准；未获批前不得落码。" - "**content 压缩必须保留标记行：** 不得只输出 `JSON.stringify` 结果而丢掉 `// --- SYSTEM PREFIX END --- //`；不得改后缀（仍为 `.jsonc`）。此为本计划对 D-96 的**兼容性补充**（OI-3），不是范围扩张。" - "**构建顺序不得倒置：** 不得先构建渲染端再构建数据端；不得在 `buildClient` 或 `buildData` 内使用 `emptyOutDir: true`（会删除已产出的 `dist/data`）；不得让渲染端失败以任何方式跳过后面的 content / `LICENSE` / 产物断言。" - - "**数据端门禁不得软化：** 不得为 `dist/data/data.js` 缺失写 expected-pending 软通过、不得写 sentinel 豁免、不得以「渲染端失败」为由跳过数据端 ESM 断言。严格签名只用于把数据端错误标记为 OI-11 回归诊断，最终退出码仍为非零。" + - "**数据端门禁不得软化：** 不得为 `dist/data/data.js` 缺失写 expected-pending 软通过、不得写 sentinel 豁免、不得以「渲染端失败」为由跳过数据端 ESM 断言。严格签名只用于把数据端错误标记为 OI-11 回归诊断，最终退出码仍为非零。**`buildGame` 必须在每个分支显式 `process.exit(...)` 终止进程**（先 flush stdout；不得依赖事件循环自然退出——Vite/esbuild 的 handle 会让进程在渲染端构建失败后存活至超时）。" - "**不得删除 `public/**`：** D-97 的「整体删除」由用户执行；本计划只通过 `copyPublicDir: false` 阻止其进入 `dist`。" - "**写入边界（D-56 + 用户裁定「你改 src，我做脚本」）：** 只允许写 `files_modified`；**不得修改 `src/**` 的任何文件**（包括 `src/bootstrap.ts`、`src/data/**`、`src/client/**`、两处 stale import）；不得改 `vite.config.ts`、`packages/**`、`packages-user/**`、`public/**`、`script/dev.ts`、`script/declare.ts`、`script/types.ts`、`script/utils.ts`、lockfile；不得回退用户在工作树中的任何既有改动。`dev.md` 只允许改构建命令表三行。" - "**`.planning/**` 边界：** 不得改 `ROADMAP.md` / `STATE.md` / `09-CONTEXT.md` / 任何既有 PLAN 或 SUMMARY；只允许新增 `09-21-SUMMARY.md`（与 09-19 / 09-20 的既有做法一致）。范围门禁以 baseline 快照为准，**不得整体白名单放行 `src/` 或 `09-CONTEXT.md`**。" @@ -100,7 +100,7 @@ must_haves: - "**不得为通过门禁而修改范围外文件：** 数据端若出现严格签名，只能记录 OI-11 回归诊断；渲染端若因用户两处 stale import 或其它 WIP 失败，也只能记录完整错误与归因；不得修 `src/**` 或包源码。" - "**不得伪造条件门禁：** 渲染端失败时不得手写 `dist/index.html` 以骗过产物门禁；不得把 BLOCKED 分支描述为「通过」；不得给出任何无条件通过承诺。注意：content 与 `LICENSE` 是构建脚本**正常产出**的，不是手写补的。" - "**不得使用双反斜杠正则做路径归一化：** 源码必须是单反斜杠正则（`String(reason)` 上把 Windows 反斜杠替换为 `/`），不得写成四反斜杠（在 Windows 上会把两个反斜杠误当一次匹配，导致分类失效）。" - - "**不得把被删除的旧 pipeline 标识符写进注释或字符串：** Task 2 的结构门禁对 `transformAsync` / `archiver` / `compressing` / `checkClientData` / `ClientDataLevel` / `getFileName` / `getFileSize` / `generateResourceJSON` / `splitResource` / `source-code.zip` / `loadList.json` / `dist.zip` / `data.iife.js` / `_temp` 做负向检查，残留会被判负。" + - "**不得把被删除的旧 pipeline 标识符写进注释或字符串：** Task 2 的结构门禁对 `transformAsync` / `archiver` / `compressing` / `checkClientData` / `ClientDataLevel` / `getFileName` / `getFileSize` / `generateResourceJSON` / `splitResource` / `source-code.zip` / `loadList.json` / `dist.zip` / `data.iife.js` / `_temp` 做负向检查，残留会被判负；并对**裸 `iife`** 做负向检查——`formats: ['iife']`、`data.iife.js`、甚至注释里解释「不用 iife」的说明都不得出现在 `script/build-game.ts` 中（要与该门禁口径一致，改写说明请放在本 PLAN / SUMMARY，不写进源码注释）。" open_items: - "**OI-1（插件文件与导出命名）：** 提议新增 `script/vite-plugin-data-isolation.ts`，导出 `dataIsolationPlugin(): Plugin`，插件 `name: 'mota-data-isolation'`；测试文件 `script/vite-plugin-data-isolation.test.ts`。备选命名：`script/build-plugin-data-isolation.ts` / `forbidRenderDependencies` / `renderIsolationPlugin`。**待用户报备批准**（D-04；测试文件按 AGENTS.md 免审批，但仍一并报备）。" - "**OI-2（content 模块命名与类型）：** 提议 `script/build-resource.ts` 导出 `buildContent(options: IContentBuildOptions): Promise`、`minifyJSONC(text: string): string`，接口 `IContentBuildOptions`（`sourceDir` / `outputDir` / **`chars: string`**）与 `IContentBuildStats`（`files` / `jsonc` / `fonts`）；测试文件 `script/build-resource.test.ts`。**W2 类型一致性：`getAllChars` 返回 `Promise`，`chars` 不做 `Set`。** 备选：`processContent` / `compressJSONC`。**待批准**（dev.md 要求对象入参声明 interface）。" @@ -209,7 +209,7 @@ Phase 9 · 任务 11 · 第 21 个计划 —— **构建重构（适配新引擎 ⑤ **D-96 content：** `src/content` → `dist/content`；`.jsonc` = **保留一行系统标记 + `JSON.stringify(JSON.parse(body))`**（去注释、后缀仍 `.jsonc`；标记必须保留，否则 `PrefixedJSONCProcessor` 运行期 error 66）；字体用 fontmin glyph 子集压缩；**不分块、不 zip**。`build-resource` 改为从 `src/content` 读取素材。实测 `src/content/**` 共 **23** 个 jsonc，每个恰好一个标记。 - ⑥ **D-97 产物：** 不复制 `public/**`（`copyPublicDir: false`；整体删除由用户执行）；dist 不携带旧模板内容（`editor.html` / `_server` / `_docs` / `libs` / `logo.png` / `styles.css` / `main.js` / `启动服务.exe`）；不打包源码 zip；不生成资源地图 JSON；不生成 `dist.zip`；**复制 `LICENSE` 到 `dist/LICENSE`**；`index.html` 去掉旧样式表 link。样式 import 由用户后续在 `src/**` 侧添加（OI-5），本计划不改 `src/**`。 + ⑥ **D-97 产物：** 不复制 `public/**`（`copyPublicDir: false`；整体删除由用户执行）；dist 不携带旧模板内容（`editor.html` / `_server` / `_docs` / `libs` / `logo.png` / `styles.css` / `main.js` / `启动服务.exe`）；不打包源码 zip；不生成资源地图 JSON；不生成 `dist.zip`；**复制 `LICENSE` 到 `dist/LICENSE`**；`index.html` 去掉旧样式表 link。**D-97 的「样式经入口 JS 引入」不由本计划交付：** `src/styles.less` 当前全仓无 import 点（仅 `index.html` 的旧 link 引用），按用户裁定「你改 src，我做脚本」本计划不改 `src/**`；因此移除 link 后、用户接线前 `dist` 缺 `#game-draw` 居中样式（OI-5），该缺口须**显式记入 SUMMARY**，不得描述为已交付。 ⑦ **D-98 / D-99 / D-100：** 删除 `build:packages` / `build:lib`；`build:game` 调整（OI-6：移除读取已删 `public/project` 的 `declare.ts` 前置；**保留 `vue-tsc --noEmit`**）；移除 babel 二次压缩；`manualChunks` 移除 `antdv`（源码已无引用）、保留 `audio`；legacy 插件维持现状；**`dev.md` 构建表删除 `build:packages` / `build:lib` 两行并更新 `build:game` 说明**。 @@ -229,9 +229,9 @@ Phase 9 · 任务 11 · 第 21 个计划 —— **构建重构（适配新引擎 ⑮ **不在本增量：** 不删 `public/**`；**不改 `src/**`（零改动，含两处 stale import）**；不改数据端/渲染端源码、`vite.config.ts`、`script/dev.ts`、`script/declare.ts`、`script/types.ts`、lockfile；不新增依赖；不改 `ROADMAP.md` / `STATE.md` / `09-CONTEXT.md` / 既有 PLAN 与 SUMMARY。 - ⑯ **已知阻断（须一并告知并记入 SUMMARY）：** ① 数据端**当前无已知阻断**（历史 OI-11 链路已解决）；② 渲染端可能因两处 stale import 失败（用户 WIP，用户修复）；③ 若渲染端仍因用户其它 WIP 失败，记录完整错误与归因，**不得**修改范围外文件。 + ⑯ **已知阻断（须一并告知并记入 SUMMARY）：** ① 数据端**当前无已知阻断**（历史 OI-11 链路已解决）；② 渲染端可能因两处 stale import 失败（用户 WIP，用户修复）；③ 若渲染端仍因用户其它 WIP 失败，记录完整错误与归因，**不得**修改范围外文件；④ **样式缺口（D-97 未尽项）**：`src/styles.less` 全仓无 import 点，移除 `index.html` 的 `styles.css` link 后，用户接线前 `dist` 缺 `#game-draw` 居中样式（OI-5），本计划**不交付**「样式经入口 JS 引入」，须显式写明。 - ⑰ **验证方式：** Task 1 = `pnpm exec vitest run script/vite-plugin-data-isolation.test.ts`（真实 `vite.build()`：未设 alias 的 `vue` 被拒 / 拒渲染端解析路径（含 token 断言：`packages-user/client-`、`packages/render`、`packages/render-vue`、`packages/system`、`packages/audio`、`packages/legacy-`、`src/client`）/ 通过纯数据端并输出 ESM / 不误判数据端路径）+ 结构断言；Task 2 = `pnpm exec vitest run script/build-resource.test.ts` + 构建脚本结构断言（含 **数据先于渲染的调用顺序**、**`dist` 只清空一次**、**两处 `emptyOutDir: false`**、`getAllChars` 返回 `Promise`、`dev.md` 构建表）+ 产物门禁（**数据端 ESM 硬断言** / 渲染端条件分支）+ **baseline 范围门禁** + `pnpm exec tsx script/build-game.ts` 实跑；**不设全仓 `check:type` / `build` / 全量 `test:ci` 门禁**。 + ⑰ **验证方式（PowerShell 5.1 口径：一律经 `cmd /c` 调用，裸 `pnpm` 会因 `pnpm.ps1` 的 `PSSecurityException` 失败）：** Task 1 = `cmd /c "pnpm exec vitest run script/vite-plugin-data-isolation.test.ts"`（真实 `vite.build()`：未设 alias 的 `vue` 被拒 / 拒渲染端解析路径（含 token 断言：`packages-user/client-`、`packages/render`、`packages/render-vue`、`packages/system`、`packages/audio`、`packages/legacy-`、`src/client`）/ 通过纯数据端并输出 ESM / 不误判数据端路径）+ 结构断言；Task 2 = `cmd /c "pnpm exec vitest run script/build-resource.test.ts"` + 构建脚本结构断言（含 **数据先于渲染的调用顺序**、**`dist` 只清空一次**、**两处 `emptyOutDir: false`**、**显式 `process.exit(...)` 终止**、`getAllChars` 返回 `Promise`、`dev.md` 构建表）+ 产物门禁（**数据端 ESM 硬断言** / 渲染端条件分支）+ **baseline 范围门禁** + `cmd /c "pnpm exec tsx script/build-game.ts"` 实跑（必须在有界时间内退出）；**不设全仓 `check:type` / `build` / 全量 `test:ci` 门禁**。 ⑱ **修改方式声明（AGENTS.md）：** 本计划执行含文件写入与删除，由**派发子代理执行**（`gsd-executor`），非内联执行。 @@ -239,7 +239,7 @@ Phase 9 · 任务 11 · 第 21 个计划 —— **构建重构（适配新引擎 是否按本计划（09-21）执行「任务 11 · 构建重构」——新增数据端/渲染端分离 Vite 插件（错误含命中 token）并注入数据端库模式 ESM 构建（**数据端先构建、`dist/data/data.js` 为硬门禁**）、重写 `build-resource` 把 `src/content`（23 个 jsonc）压缩拷贝到 `dist/content`（jsonc 保留系统标记、fontmin、不分块不 zip）、重写 `build-game`（清空一次 → 数据端 → 渲染端条件 BLOCKED → content → LICENSE；去掉旧模板/babel/资源分块/源码 zip/资源地图/dist.zip）、删除 `build-packages.ts` / `build-lib.ts` 与对应 npm script、同步 `dev.md` 构建表、`index.html` 去旧样式表 link、保留 `vue-tsc --noEmit`、微调 `manualChunks`；**不删 `public/**`、不改 `src/**`（含用户待修复的两处渲染端 stale import）、不动用户其它并发 WIP**；**数据端 ESM 硬失败、渲染端产物条件分支**。 - AGENTS.md / D-03 / D-04 要求执行前与命名先获批；`.planning/config.json` 为 `mode: yolo`，故本关卡显式 `blocking-human` 且 `autonomous: false`。执行期含写操作与**删除两个脚本**。`src/content` 共 **23** 个 jsonc，均为「前缀注释 + 严格 JSON」且每个恰好一个标记，加载器 `PrefixedJSONCProcessor` 依赖 `// --- SYSTEM PREFIX END --- //` 的 split（必须恰好 2 段），故压缩保留标记是运行期兼容硬约束（去的是标记**之外**的注释）。`src/content/font` 无字体二进制、`src/content/item.ts` 与 `core.jsonc` 的 `itemEffectDir` 不匹配——属既有缺口，本计划只记录不改。**revision 4 的关键事实：** 用户的 `src` 重构已删除 `src/constant.ts`，数据端闭包（`src/data/**`）**不含任何渲染端导入**，因此 `dist/data/data.js` 必须产出并断言 ESM（硬门禁）；渲染端仍有两处指向已删除文件的 stale import（`src/client/initialize.ts:14` / `src/client/plugin/shop/shop.tsx:9`），属用户 WIP，本计划**不改 `src/**`**，故渲染端产物门禁是条件分支，但**绝不能拖累数据端硬门禁**。工作树含用户并发改动（`index.html`、`packages-user/client-modules/src/**`、`09-CONTEXT.md`、`pnpm-lock.yaml` 等），提交时须逐条核对暂存面、只暂存本计划 `files_modified`。行号为规划日实测、可能漂移，门禁以结构/行为断言为准。 + AGENTS.md / D-03 / D-04 要求执行前与命名先获批；`.planning/config.json` 为 `mode: yolo`，故本关卡显式 `blocking-human` 且 `autonomous: false`。执行期含写操作与**删除两个脚本**。`src/content` 共 **23** 个 jsonc，均为「前缀注释 + 严格 JSON」且每个恰好一个标记，加载器 `PrefixedJSONCProcessor` 依赖 `// --- SYSTEM PREFIX END --- //` 的 split（必须恰好 2 段），故压缩保留标记是运行期兼容硬约束（去的是标记**之外**的注释）。`src/content/font` 无字体二进制、`src/content/item.ts` 与 `core.jsonc` 的 `itemEffectDir` 不匹配——属既有缺口，本计划只记录不改。**revision 4 的关键事实：** 用户的 `src` 重构已删除 `src/constant.ts`，数据端闭包（`src/data/**`）**不含任何渲染端导入**，因此 `dist/data/data.js` 必须产出并断言 ESM（硬门禁）；渲染端仍有两处指向已删除文件的 stale import（`src/client/initialize.ts:14` / `src/client/plugin/shop/shop.tsx:9`），属用户 WIP，本计划**不改 `src/**`**，故渲染端产物门禁是条件分支，但**绝不能拖累数据端硬门禁**。**baseline 由 Task 0 在执行时捕获，不预置并发文件清单：** 规划日实测 `git status --porcelain -uall` 仅含 `.planning/phases/09-minimum-browser-runnable/09-CONTEXT.md`、`.planning/phases/10-docs-restructure/10-CONTEXT.md` 与 `10-13..10-20-PLAN.md`、`pnpm-lock.yaml` 的既有改动（`index.html` / `packages-user/**` / `src/**` 当前无改动）；执行时以实际快照为准，提交时须逐条核对暂存面、只暂存本计划 `files_modified`。行号为规划日实测、可能漂移，门禁以结构/行为断言为准。