dsh-plugin-tool-management 0.9.0 → 0.10.0

package/lib/history/bridge.js

@@ -9,6 +9,13 @@ export { CapabilityRefusalError };
 // presence, shapes, read-only behaviour), never from comparing source text:
 // text equality only ever proved "same release", and it turned every harmless
 // upstream refactor into a total feature outage.
+//
+// 纪律边界（对工作区「官方包与宿主机制只读」一条的解释，2026-09-18 复核确认）：
+// 这里的包装是**运行时实例**上的临时、可恢复、能力门控的适配（仅当宿主自己缺
+// delete/whenIdle 时才装；按原 descriptor 恢复；serial 队列防复活），不修改任何
+// 官方包文件、不持久化改动、不改变宿主机制的对外行为 —— 与「不 patch 官方代码」
+// 禁令针对的对象（包文件与宿主机制的永久改写）不同层。若用户裁定该解释不成立，
+// 撤掉 acquire/releaseCacheGuard 即可整体退回「无删除屏障」的降级形态。
 const cacheGuards = new WeakMap();
 const raw = (value) => value?.[symbols.original] ?? value;
 const sameLifecycle = (a, b) => a && b && a.createdAt === b.createdAt && (a.cwd ?? null) === (b.cwd ?? null);

package/lib/history/tombstone.js

@@ -1,8 +1,7 @@
 //#region lib/types/tombstone.js
 /**
  * 通用墓碑簿记：登记一个已删除 id，并按 FIFO 在上限处淘汰最旧项。
- * 工作区注册表（lib/workspace.js）与投影缓存（lib/projcache.js）共用
- * 同一份语义，避免两处拷贝的淘汰策略分叉。
+ * 工作区注册表（lib/history/workspace.js）在用；淘汰策略集中在这里，避免各处拷贝分叉。
  */
 /**
  * 登记已删除 id 并执行上限淘汰。

package/lib/hub.js

@@ -116,7 +116,9 @@ export function migrateHubLayoutSync(home = resolveDshHome()) {
         }
     };
     // ① 更早的 hub 目录名（插件叫 dsh-skill-mcp-manager 的时期）：**先**逐项并入 hub，
-    //    让下面 ② 的改名也覆盖从旧目录搬进来的那些（同名保留 hub 里已有的那份）。
+    //    让下面 ② 的改名也覆盖从旧目录搬进来的那些（同名保留 hub 里已有的那份 ——
+    //    move 对已存在目标跳过且旧份不删：合并是「只进不覆盖」，滞留旧目录的条目
+    //    不丢失但也不可见，清掉旧目录即可整体放弃）。
     for (const legacyHub of ['dsh-plugin-tool-management', 'skill-mcp-manager']) {
         const from = join(home, legacyHub);
         try {