dsh-tiddlywiki 0.30.48 → 0.30.50

package/docs/CHANGELOG.md

@@ -4,6 +4,8 @@
 
 > 最近几个主要版本的一句话记录（完整变更见 [Releases](https://github.com/bbqisbbq/dsh-tiddlywiki/releases) / git log）。
 
+- **v0.30.50**（2026-09-30）：`src/index.ts` **724 → 674** —— 新模块 `index-startup.ts`(202)：**自举阶段整片**（装拆库 skill → 读控制文件 → 读会话作用域 → 建 farm → `startAll` → `applyPrompt` → 绑剪藏桥，收进 `createStartupStage(deps)`）。`index.ts` 拆分第三轮：剩下的是 `apply()` 的其余装配（farm/锁/工具接线 + 拆卸 effect），读入口现在基本能一眼看完生命周期。**三条刻意不动**：① `disposed` 仍归入口（它是**拆卸 effect 与这个任务共同的主人**——任务每次 await 后检查它、发现卸载就自己停子进程，v0.19.1），以 `isDisposed` 传入；② `farm` 由这个阶段**创建**、但**全插件所有**（路由/工具/视图都读）⇒ 经 `setFarm` 交回入口，入口仍是可变状态的唯一主人；③ **顺序即语义**（尤其是「拆库 skill 必须在 wiki 之前装」，那是真实事故的产物）——已在模块头逐条写明。⚠️ 其中一个**必须留在 `index.ts` 的导入绑定**（`readLocationState` / `readRegistry` 这两个名字只被 barrel 再导出使用）暴露成一个模式，本版顺手改掉了根因：`export { X } from '…'` **不消费** import 绑定 ⇒ `noUnusedLocals` 报「声明未读」、而删掉 import 就让 `lib/index.js` **静默少一个导出**（v0.30.48 / v0.30.50 各踩一次，只有 e2e 能发现）。修法：这类名字改用**无 `from` 的 `export { X }`** —— 真的读一次绑定，导出照样存在，两个要求同时满足。⚠️ 守门同步：`verify-ready-policy` 那条「`base: config` 必须交给实例」的断言改读 **`src/index` 族**（阶段搬走后 `base: deps.config` 落在新模块里）—— 判据不变，只是不再钉文件名；`verify-index-barrel`（v0.30.49 新增）本轮**当场**抓出了被漏掉的两个导出。
+- **v0.30.49**（2026-09-30）：**修 v0.30.48 引入的真缺陷 + 补上「barrel 公共面」的守门**。① v0.30.48 用 `noUnusedLocals` 清理 import 时删掉了 `writeLocationState` 的 **import 行**，而同一文件里 `export { … } from './host/wiki-location.ts'` 是**独立语句**、不消费那个绑定 —— 于是 `lib/index.js` 不再导出它，`scripts/verify-wiki-switch.mjs` 在 **e2e** 阶段才崩（`does not provide an export named 'writeLocationState'`），而 `typecheck` / `verify:unit` / `verify:static` **全绿**。这正是 v0.30.42（误删 `MARKDOWN_PLUGIN`）那一类「**barrel 丢失对编译器和多数守门不可见**」的第二次事故。② 新增 `scripts/verify-index-barrel.mjs`（进 `verify:static`）：**凡是本仓库脚本从 `../lib/index.js` 具名导入的符号，`src/index.ts` 必须真的导出它**（解析的是 `export { … }` 与 `export <decl>`，**不是**「出现过这个名字」—— 后者挡不住「barrel 行被降级成 import」这种形态）。带两条反空转保险（导出数 ≥100、需求数 ≥50），并**反向验证**过两种注入（删掉导出 / 降级成 import，都稳定变红）。③ 写这条守门时自己踩了同一个坑的**第三种方向**：解析 `export { … }` 列表时按 `,` 切分，而列表里恰好有一段解释性注释 —— 注释里的逗号把名字切碎、注释里的右花括号提前终止列表，**症状是「源码明明导出了，守门却报缺」**。修法同 v0.30.45/48：**先剥注释再解析**（顺序照旧先剥行注释）。⇒ 「对源码文本做结构断言先剥注释」这条纪律，本仓库已经交了**四次**学费（v0.28.12 假红、v0.30.45 假绿、v0.30.48 假红、v0.30.49 解析器自己出错）。
 - **v0.30.48**（2026-09-30）：`src/index.ts` **955 → 724** —— 新模块 `index-routes.ts`(381)：**路由 / admin 装配阶段整片**（`RouteDeps` + `AdminDeps` 两个对象与两张路由表的注册，收进 `createRouteStage(deps)`）。**这是 `index.ts` 拆分第二轮**：v0.30.42 先切走了「纯」的配置面，这一轮切走的是**装配阶段里唯一自成一段**的部分 —— 读入口现在能一眼看到生命周期（farm → prompt/tools → 启动任务 → 路由 → 拆卸），而不再被 120 行 accessor 接线打断。三条刻意不动的东西：① **`disposed` 仍归入口**（它的主人是拆卸 effect 与启动任务），唯一需要它的那处守卫改为**传入谓词** `isDisposed()`；② **变更锁仍由入口建、并把同一个实例传进 stage**（v0.30.12：整插件一把锁）—— 顺手删掉一个**从未被读的依赖** `GitLayerDeps.isDisposed`，README 式的「按行删 import」交给 `noUnusedLocals`（一次点名 23 处，零猜）；③ **注册时机一字未改**（`ctx.inject(['webServer'])` 仍在 wikiViews 之后、拆卸 effect 之前 —— 顺序没有重排）。⚠️ 守门同步一处：`verify-mutation-lock` 的「只建一把锁」计数改成**按模块族**统计，并给该判据**剥注释** —— 新模块的说明文字里写了一句 `createMutationLock()`，未剥注释时会被当成**第二个调用点**（v0.30.45 那种「断言被自己的文档满足」的镜像：这次是假红）。
 - **v0.30.47**（2026-09-30）：`src/client/note-widget.ts` **588 → 573** —— 新模块 `note-widget-foot.ts`(73)：**底栏那一组**（左组：上传按钮 / 「🕘 最近」/ `Ctrl+Enter` 提示；右组：「✏️ 在 TW 中编辑」/「保存」）。这一片是**零卡片状态**的纯布局（与 v0.30.43 的 placement 片同类）：依赖面只有「一个已经建好的上传按钮」+「`recent.toggle` 的函数引用」，把 `{ foot, footLeft, footRight, saveBtn, editBtn }` 交回卡片 —— 两个按钮的 `click` 处理器**仍绑在卡片里**（紧挨着实现它们的 `note-widget-save.ts`），因为「谁实现动作」与「谁画按钮」是两件事。`footLeft`/`footRight` 两个 class 一并交回，因为 `.dsh-tw-note-foot-right` 的 flex 规则（右贴边 + 装不下时整组换行，v0.22.6 的按钮压成两行事故）是**契约**，卡片还要往里 append。
 - **v0.30.46**（2026-09-30）：`src/client/note-widget.ts` **615 → 588** —— 新模块 `note-widget-upload-ui.ts`(82)：上传的**接线**那一组（「上传」按钮 + 隐藏的 file input + 拖放到编辑器上，连同它自有的 `dragDepth`）。分层刻意分成两个文件：`note-widget-upload.ts` 是**动作**（`uploadInto`：校验大小 → POST → 在光标处插入 Markdown 行 → toast），`note-widget-upload-ui.ts` 是**接线**（File 从哪来、何时给编辑器挂 `.dsh-tw-note-drop` 高亮）。分界线：整组只问卡片要两样东西 —— 编辑器（拖放目标 + 插入点）与 `wikiQuery`（附件必须落在**这张卡片的目标库**里），卡片侧不再持有任何上传状态（`footLeft.append(upload.button, …)` 一行替代原 36 行）。