@mingmaple/dsh-handover 0.9.14 → 0.9.22

package/src/tools/peer.mjs

@@ -0,0 +1,205 @@
+/**
+ * peer —— 平级会话：一个入口，按 action 分流。
+ *   list 会话一览（只读缓存，不激活任何会话）
+ *   status 单会话详情
+ *   send 投一条消息（唯一会消耗对方 token 的动作）
+ *   peek 读取目标会话近期会话历史（内容进本会话上下文）
+ *   rename 只改显示标题
+ *   new 新建平级会话
+ * 原 peer_list、peer_status、peer_send、peer_peek、peer_rename、peer_new 合并于此。
+ * 动作级权限在这里再判一次：角色矩阵只决定「这个工具可不可见」，不细分动作。
+ */
+import { randomUUID } from 'node:crypto';
+import { textOutput } from '../lib/output.mjs';
+import { PEER_NAME } from '../lib/names.mjs';
+import { NL } from '../lib/text.mjs';
+import {
+  readProjCache, rowLine, sessionRows, stamp, pressurePct, isSubagent, isBusy,
+  projectName, pick, peerMarker, resolveWorkspaceId, findSessionLog, decodeSessionLog, conversation,
+} from '../lib/peer.mjs';
+
+export const ACTIONS = ['list', 'status', 'send', 'peek', 'rename', 'new'];
+const GLOBAL_ONLY = ['list', 'peek', 'rename'];
+
+function roleOf(env, exec) {
+  try { return env.roleOf(exec) || { role: 'plain' }; } catch { return { role: 'plain' }; }
+}
+
+function denyUnless(ok, action, why) {
+  if (!ok) throw new Error('peer(action="' + action + '")：' + why);
+}
+
+async function listText(env, args) {
+  const limit = Number.isFinite(args.limit) ? Math.max(1, Math.min(200, Math.trunc(args.limit))) : 40;
+  const controller = env.controller();
+  if (!controller || typeof controller.list !== 'function') {
+    throw new Error('peer(action="list")：sessionController 不可用（插件未注入该服务）');
+  }
+  const rows = await sessionRows(controller, args.include_subagents === true);
+  if (rows.length === 0) return 'no sessions';
+  return rows.slice(0, limit).map((row) => {
+    const cache = readProjCache(row.sessionId);
+    const state = row.running ? 'running' : row.agentAvailable ? 'idle' : 'cold';
+    return rowLine(row.sessionId, cache, state) + ' | ' + stamp(row.updatedAt);
+  }).join(NL);
+}
+
+async function statusText(env, args) {
+  const controller = env.controller();
+  if (!controller || typeof controller.list !== 'function') {
+    throw new Error('peer(action="status")：sessionController 不可用（插件未注入该服务）');
+  }
+  const sid = String(args.session_id || '').trim();
+  if (!sid) throw new Error('peer(action="status")：session_id 不能为空');
+  const cache = readProjCache(sid);
+  const rows = await sessionRows(controller, true);
+  const row = rows.find((r) => r.sessionId === sid) ?? null;
+  if (cache === null && row === null) return 'unknown session: ' + sid;
+  const stats = pick(cache, 'record', 'rows', 'sessionStats', 'val') ?? {};
+  const pct = cache === null ? null : pressurePct(cache);
+  return [
+    'session  ' + sid,
+    'kind     ' + (cache === null ? '?' : isSubagent(cache) ? '子会话（subagent）' : '平级会话（peer）'),
+    'project  ' + (cache === null ? '-' : projectName(cache)),
+    'pressure ' + (pct === null ? '?' : pct.toFixed(1) + '%') + (pct !== null && pct >= 32 ? '  已进入预警区' : ''),
+    'state    ' + (isBusy(cache) === true ? 'running' : row === null ? 'cold' : row.agentAvailable ? 'idle' : 'cold'),
+    'turns    ' + String(stats.turns ?? '?') + '   steps ' + String(stats.steps ?? '?'),
+    'cwd      ' + String(row?.cwd ?? pick(cache, 'record', 'identity', 'cwd') ?? '-'),
+    'preset   ' + String(pick(cache, 'record', 'rows', 'agentPreset', 'val') ?? '-'),
+    'updated  ' + stamp(row?.updatedAt ?? pick(cache, 'record', 'identity', 'createdAt')),
+  ].join(NL);
+}
+
+async function sendText(env, args, exec, info) {
+  const controller = env.controller();
+  if (!controller || typeof controller.prompt !== 'function') {
+    throw new Error('peer(action="send")：sessionController.prompt 不可用（插件未注入该服务）');
+  }
+  const target = String(args.session_id || '').trim();
+  if (!target) throw new Error('peer(action="send")：session_id 不能为空');
+  const message = typeof args.message === 'string' ? args.message : '';
+  if (message.trim() === '') throw new Error('peer(action="send")：message 不能为空');
+  const mode = args.mode === 'steer' ? 'steer' : 'queue';
+  // 来源标记：dsh 把宿主投递的消息记成 source.kind === "user"，不加标记的话，
+  // 平级会话的消息在日志和界面上与用户消息完全无法区分。
+  const sender = exec?.agent?.session?.header?.id ?? 'unknown';
+  const marker = peerMarker(sender);
+  const body = message.startsWith(marker) ? message : marker + NL + message;
+  const receipt = await controller.prompt(
+    { requestId: randomUUID(), sessionId: target, mode, content: [{ type: 'text', text: body }] },
+    new AbortController().signal,
+  );
+  return 'accepted=' + String(receipt.accepted) + ' mode=' + mode + ' target=' + target + ' from=' + sender;
+}
+
+async function peekText(args) {
+  const sid = String(args.session_id || '').trim();
+  if (!sid) throw new Error('peer(action="peek")：session_id 不能为空');
+  const limit = Number.isFinite(args.limit) ? Math.max(1, Math.min(40, Math.trunc(args.limit))) : 8;
+  const file = findSessionLog(sid);
+  if (file === null) return 'no session log found for ' + sid;
+  const events = decodeSessionLog(file);
+  if (events === null) return 'this Node build has no zstd support; cannot read the session log';
+  const items = conversation(events, limit);
+  const head = 'session ' + sid + '  |  最近 ' + String(items.length) + ' 条  |  ' + file;
+  if (items.length === 0) return head + NL + '(没有可读的会话历史)';
+  const body = items.map((it) => {
+    const one = it.text.replace(/\s+/g, ' ').trim();
+    const cut = one.length > 400 ? one.slice(0, 400) + ' …' : one;
+    return '[' + stamp(it.t) + ' ' + it.who + '] ' + cut;
+  }).join(NL);
+  return head + NL + body;
+}
+
+async function renameText(env, args) {
+  const controller = env.controller();
+  if (!controller || typeof controller.rename !== 'function') {
+    throw new Error('peer(action="rename")：sessionController.rename 不可用（插件未注入该服务）');
+  }
+  const sid = String(args.session_id || '').trim();
+  if (!sid) throw new Error('peer(action="rename")：session_id 不能为空');
+  const title = String(args.title ?? '').trim();
+  if (title === '') throw new Error('peer(action="rename")：title 不能为空');
+  await controller.rename({ sessionId: sid, title });
+  return 'renamed ' + sid + ' -> ' + title;
+}
+
+async function newText(env, args, info) {
+  const controller = env.controller();
+  if (!controller || typeof controller.create !== 'function') {
+    throw new Error('peer(action="new")：sessionController.create 不可用（插件未注入该服务）');
+  }
+  // 会话创建仅属全局；杂项可以把会话建在 Misc 下（落到本任务体系内）。
+  const wantsWorkspace = typeof args.workspace === 'string' && args.workspace.trim() !== '';
+  if (wantsWorkspace && args.cwd !== undefined) {
+    throw new Error('peer(action="new")：传 workspace 时不要再传 cwd —— session.create 只接受其中之一（cwd 会自动取该工作区的 path）');
+  }
+  const targetText = String(args.workspace || args.cwd || '').toLowerCase();
+  const allowed = info.role === 'global' || (info.role === 'misc' && targetText.indexOf('misc') !== -1);
+  denyUnless(allowed, 'new', '会话创建仅属全局（杂项可建到 Misc 下）');
+  let request = {};
+  if (wantsWorkspace) {
+    const workspaceId = resolveWorkspaceId(args.workspace);
+    if (workspaceId === null || workspaceId === undefined) {
+      throw new Error('peer(action="new")：找不到工作区「' + args.workspace + '」（可用 id / 标题 / 路径；数据源 storages/workspace.json）');
+    }
+    request = { workspaceId };
+  } else if (args.cwd !== undefined) {
+    request = { cwd: args.cwd };
+  }
+  const created = await controller.create(request);
+  const id = created.sessionId;
+  if (typeof args.title === 'string' && args.title.trim() !== '') {
+    try {
+      await controller.rename({ sessionId: id, title: args.title.trim() });
+    } catch (error) {
+      if (typeof env.log === 'function') env.log('peer(action="new")：改标题失败：' + String(error));
+    }
+  }
+  let tail = '';
+  if (typeof args.message === 'string' && args.message.trim() !== '') {
+    await controller.prompt(
+      { requestId: randomUUID(), sessionId: id, mode: 'queue', content: [{ type: 'text', text: args.message }] },
+      new AbortController().signal,
+    );
+    tail = ' (opening message delivered)';
+  }
+  return 'created ' + id + tail;
+}
+
+export function pmPeerTool(env) {
+  return {
+    name: PEER_NAME,
+    description:
+      '平级会话：action=list 一览、status 详情、send 投消息（耗对方 token）、peek 读近期会话历史（耗本会话 token）、rename 改标题、new 新建。list、peek、rename 与 new 仅全局会话可用。',
+    parameters: {
+      type: 'object',
+      additionalProperties: false,
+      required: ['action'],
+      properties: {
+        action: { type: 'string', enum: ACTIONS, description: '要做的动作' },
+        session_id: { type: 'string', description: 'status、send、peek、rename：目标会话 id' },
+        message: { type: 'string', description: 'send：要投递的正文' },
+        mode: { type: 'string', enum: ['queue', 'steer'], description: 'send：queue（默认）或 steer' },
+        limit: { type: 'number', description: 'list：最多多少行（默认 40）；peek：最近多少条（默认 8，上限 40）' },
+        include_subagents: { type: 'boolean', description: 'list：同时列出子会话' },
+        title: { type: 'string', description: 'new、rename：显示标题' },
+        workspace: { type: 'string', description: 'new：工作区 id、标题或路径（与 cwd 互斥）' },
+        cwd: { type: 'string', description: 'new：新会话的工作目录' },
+      },
+    },
+    output: textOutput(),
+    async execute(args, exec) {
+      const action = String(args.action || '');
+      if (ACTIONS.indexOf(action) === -1) throw new Error('peer：action 只能是 ' + ACTIONS.join(' | ') + '（收到 ' + JSON.stringify(action) + '）');
+      const info = roleOf(env, exec);
+      if (GLOBAL_ONLY.indexOf(action) !== -1) denyUnless(info.role === 'global', action, '该动作仅全局会话可用');
+      if (action === 'list') return { text: await listText(env, args) };
+      if (action === 'status') return { text: await statusText(env, args) };
+      if (action === 'send') return { text: await sendText(env, args, exec, info) };
+      if (action === 'peek') return { text: await peekText(args) };
+      if (action === 'rename') return { text: await renameText(env, args) };
+      return { text: await newText(env, args, info) };
+    },
+  };
+}

package/src/tools/ho_brief.mjs

@@ -1,57 +0,0 @@
-/** ho_brief —— 一条命令汇总：水位 + 闸门 + 会话清点 + 阶段建议。 */
-import { textOutput } from '../lib/output.mjs';
-import { nameOf } from '../lib/names.mjs';
-import { NL } from '../lib/text.mjs';
-import { syncCheck } from '../lib/gates.mjs';
-import { scanSessions, readSelfPressure } from '../lib/sessions.mjs';
-import { composeBrief } from '../lib/brief.mjs';
-import { decide } from '../lib/phase.mjs';
-import { computeDrift } from '../lib/drift.mjs';
-import { watermark } from '../lib/facts.mjs';
-
-export function pmBriefTool(env) {
-  const w = watermark(env.cfg);
-  return {
-    name: nameOf('brief'),
-    description:
-      '起始与收束的单条命令：水位、闸门、会话清点、阶段建议。只读。',
-    parameters: {
-      type: 'object',
-      additionalProperties: false,
-      properties: {
-        threshold: { type: 'number', description: '预警阈值百分比（默认 ' + w.warnValue + '）' },
-      },
-    },
-    output: textOutput(),
-    async execute(args, exec) {
-      const ws = env.resolveWs(exec);
-      const warn = typeof args.threshold === "number" ? args.threshold : w.warnValue;
-      const gate = syncCheck(ws);
-      const meId = env.selfId(exec);
-      const self = readSelfPressure(env.cacheDir(), meId);
-      const scan = scanSessions({
-        dir: env.cacheDir(),
-        meId,
-        meCwd: env.selfCwd(exec),
-        warn,
-        silentHours: env.cfg.sessionScanHours,
-      });
-      const drift = computeDrift({ ws, cacheDir: env.cacheDir(), slack: env.cfg.driftSlack, all: false });
-      const ratio = self.used === null || self.win === null ? null : self.used / self.win;
-      const adv = decide({ ratio, compactionsUsed: 0, cfg: env.cfg, lockState: "unknown" });
-      const selfPct = self.used === null || self.win === null ? null : (self.used / self.win) * 100;
-      const ok = gate.ok && (selfPct === null || selfPct < warn);
-      const lines = composeBrief({
-        cfg: env.cfg,
-        selfUsed: self.used,
-        selfWin: self.win,
-        gate,
-        scan,
-        drift,
-        advice: { text: adv.action + " —— " + adv.reason },
-        ok,
-      });
-      return { text: lines.join(NL) };
-    },
-  };
-}

package/src/tools/ho_diag.mjs

@@ -1,87 +0,0 @@
-/** ho_diag —— 诊断：服务是否可解析、调度器是否就绪、配置是否如预期。不写任何东西。 */
-import fs from 'node:fs';
-import { nameOf } from '../lib/names.mjs';
-import path from 'node:path';
-import { textOutput } from '../lib/output.mjs';
-import { NL } from '../lib/text.mjs';
-import { eventsOf, countCompactions } from '../lib/events.mjs';
-
-export function pmDiagTool(env, state) {
-  return {
-    name: nameOf('diag'),
-    description:
-      '插件自检：服务、调度器、压缩计数、工作区是否接入。只读。',
-    parameters: { type: "object", additionalProperties: false, properties: {} },
-    output: textOutput(),
-    async execute(args, exec) {
-      const out = [];
-      const meId = env.selfId(exec);
-      out.push("会话      " + (meId || "?"));
-      if (typeof env.version === "function") out.push("版本      " + env.version());
-      out.push("调度器    " + (state.schedulerReady() ? "就绪" : "未就绪" + (state.schedulerError() ? "：" + state.schedulerError() : "（稍后重试或重启）")));
-      if (typeof env.injectList === 'function') out.push('inject    ' + env.injectList().join(' / '));
-      if (typeof env.initErrors === 'function') {
-        const errs = env.initErrors();
-        out.push('初始化    ' + (errs.length ? '有 ' + errs.length + ' 处失败：' + errs.join('；') : '无错误'));
-      }
-      if (typeof env.probeServices === "function") {
-        const svc = env.probeServices();
-        out.push("服务      " + Object.keys(svc).map((k) => k + "=" + (svc[k] ? "可用" : "—")).join("  "));
-      }
-      if (typeof env.guardLast === "function") {
-        const g = env.guardLast();
-        out.push("唤醒判定  " + (g
-          ? (g.allow ? "放行" : "拦截") + " · 依据 " + g.source + (g.title ? " · 标题 " + g.title : "") + " · 会话 " + g.sid
-          : "本进程还没有 peer_send、peer_new 调用"));
-      }
-      if (typeof env.probeAgentScope === "function") {
-        const a = env.probeAgentScope(exec);
-        const show = ["compaction", "compactNow", "tokenMeter", "sessions", "llm", "agents"]
-          .map((k) => k + "=" + (a[k] ? "可用" : "—")).join("  ");
-        out.push("会话作用域 " + (a.ctx ? show : "无法获取 exec.agent.ctx"));
-      }
-      const st = typeof env.compactionState === "function"
-        ? env.compactionState(exec)
-        : (() => { const c = countCompactions(eventsOf(exec)); return { used: c.used, lock: c.lock, source: 'events' }; })();
-      out.push("压缩      " + st.used + "/" + env.cfg.maxCompactions + " 次；锁 " + st.lock + "；来源 " + st.source);
-      const pct = env.selfPct(meId);
-      out.push("水位      " + (pct === null ? "读不到" : pct.toFixed(1) + "%") + (typeof env.staleNote === "function" ? env.staleNote(exec) : ""));
-      const ws = env.resolveWs(exec);
-      let wsOk = false;
-      try { wsOk = fs.existsSync(path.join(ws, '_Control_Center')); } catch { wsOk = false; }
-      if (typeof env.roleOf === "function") {
-        try {
-          const info = env.roleOf(exec);
-          const ts = typeof env.toolsetOf === 'function' ? env.toolsetOf(info.role) : null;
-          out.push("角色      " + info.role + (info.project ? "（项目 " + info.project + "）" : info.task ? "（任务 " + info.task + "）" : "") + " · 依据 " + info.source + (ts ? " · 可见工具 " + ts.allow.length + "/" + (ts.allow.length + ts.deny.length) : ""));
-          if (typeof env.roleState === "function") {
-            const rs = env.roleState();
-            const cnt = typeof rs.count === "number" ? " · 已装配 " + rs.count + " 个会话" : "";
-            out.push("角色装配  " + (rs.mode || "未知") + cnt + (rs.last ? " · 最近：" + rs.last.sid + " → " + rs.last.role + "（" + rs.last.at + "）" : ""));
-          }
-        } catch (e) {
-          out.push("角色      判定失败：" + (e && e.message ? e.message : e));
-        }
-      }
-      out.push("工作区    " + ws + (wsOk
-        ? "  已接入"
-        : "  — 未接入（未找到 _Control_Center）：让用户走设置页「首次安装」，或本会话直接 ho_init(parent=\"<目录>\", register=true)"));
-      try {
-        const mv = typeof env.moveInfo === "function" ? env.moveInfo() : null;
-        if (mv) out.push("迁移      " + mv.phase + " · " + mv.src + (mv.dst ? "  →  " + mv.dst : ""));
-      } catch { /* ignore */ }
-      out.push("配置      warn=" + env.cfg.warnRatio + " handover=" + env.cfg.handoverRatio + " hard=" + env.cfg.hardRatio + " max=" + env.cfg.maxCompactions);
-      if (typeof env.handoverFor === "function") {
-        try {
-          const hp = env.handoverFor(exec);
-          out.push("交接路径  " + (hp && hp.path ? hp.path + "（" + hp.kind + "）" : "无 —— " + ((hp && hp.reason) || "角色未定")));
-        } catch (e) {
-          out.push("交接路径  解析失败：" + (e && e.message ? e.message : e));
-        }
-      } else {
-        out.push("交接路径  " + (env.cfg.handoverPath || "（按角色解析）"));
-      }
-      return { text: out.join(NL) };
-    },
-  };
-}

package/src/tools/ho_drift.mjs

@@ -1,41 +0,0 @@
-/** ho_drift —— 交接漂移体检（替代 handover_check.mjs）。 */
-import { textOutput } from '../lib/output.mjs';
-import { nameOf } from '../lib/names.mjs';
-import { NL } from '../lib/text.mjs';
-import { computeDrift, driftVerdict } from '../lib/drift.mjs';
-
-export function pmDriftTool(env) {
-  return {
-    name: nameOf('drift'),
-    description:
-      '交接漂移体检：Δ＝当前轮−交接轮，超过容忍轮数（默认 3）需刷新交接。只读。',
-    parameters: {
-      type: 'object',
-      additionalProperties: false,
-      properties: {
-        slack: { type: 'number', description: '容忍轮数（默认 3）' },
-        all: { type: 'boolean', description: '列全部会话，而不只是每个项目的在任会话' },
-      },
-    },
-    output: textOutput(),
-    async execute(args, exec) {
-      const ws = env.resolveWs(exec);
-      const res = computeDrift({
-        ws,
-        cacheDir: env.cacheDir(),
-        slack: typeof args.slack === 'number' ? args.slack : env.cfg.driftSlack,
-        all: args.all === true,
-      });
-      const out = [];
-      out.push('交接匹配检查（跟着交接走；冗余 ' + res.slack + ' 轮）  工作区根 ' + ws);
-      out.push('  项目  会话类型 会话  当前轮  交接轮  Δ  判定');
-      for (const r of res.rows) {
-        const cells = [r.project, r.kind, r.sid.slice(-8), String(r.turns), r.handoverTurn === null ? '?' : String(r.handoverTurn), r.delta === null ? '?' : String(r.delta), r.verdict];
-        out.push('  ' + cells.join('  '));
-      }
-      if (!res.rows.length) out.push('  读不到任何项目会话（Projects/ 下对应库不存在时属正常）');
-      out.push(driftVerdict(res));
-      return { text: out.join(NL) };
-    },
-  };
-}

package/src/tools/ho_init.mjs

@@ -1,82 +0,0 @@
-/**
- * ho_init —— 首次安装：在用户给的目录里建「全局文件体系」，可选顺带注册为工作区。
- * 与设置页的「首次安装向导」同一套实现（lib/scaffold.mjs），因此两条路径行为一致。
- */
-import fs from 'node:fs';
-import { nameOf } from '../lib/names.mjs';
-import path from 'node:path';
-import { textOutput } from '../lib/output.mjs';
-import { NL } from '../lib/text.mjs';
-import { createGlobalWorkspace } from '../lib/scaffold.mjs';
-
-export function pmInitTool(env) {
-  return {
-    name: nameOf('init'),
-    description:
-      '首次安装：在指定目录（不存在会创建）下建全局文件体系（根为 <目录>/_Workspace），可顺带注册工作区。',
-    parameters: {
-      type: 'object',
-      additionalProperties: false,
-      required: ['parent'],
-      properties: {
-        parent: { type: 'string', description: '目标父目录绝对路径（不存在会创建）；全局根建在它里面' },
-        name: { type: 'string', description: '全局根目录名，默认 _Workspace' },
-        register: { type: 'boolean', description: '建好后顺带注册为工作区（默认 false）' },
-        title: { type: 'string', description: 'register 时的工作区标题，默认「全局」' },
-      },
-    },
-    output: textOutput(),
-    async execute(args) {
-      const r = createGlobalWorkspace(args.parent, { name: args.name });
-      const out = [];
-      if (!r.ok) {
-        out.push('未建立：' + r.error);
-        if (r.root) out.push('目标：' + r.root);
-        out.push('');
-        out.push('用法：ho_init(parent="<已存在的目录绝对路径>")。插件只新建、不覆盖。');
-        return { text: out.join(NL) };
-      }
-      out.push('已建立全局文件体系：' + r.root);
-      out.push('  目录 ' + r.created.length + ' 个：' + r.created.slice(0, 5).join('、') + (r.created.length > 5 ? ' 等' : ''));
-      out.push('  文件 ' + r.written.length + ' 个：' + (r.written.length ? r.written.join('、') : '（都已存在，未覆盖）'));
-      if (r.existed) out.push('  目标目录原为空目录，直接使用。');
-      if (r.createdParent) out.push('  父目录原本不存在，已创建。');
-      if (r.skipped.length) out.push('  跳过（已存在、未覆盖）：' + r.skipped.join('、'));
-
-      let registered = null;
-      if (args.register === true) {
-        const reg = env.registry();
-        if (!reg || typeof reg.create !== 'function') {
-          out.push('');
-          out.push('注册未完成：workspaceRegistry 不可用。请把下面这个路径粘进 DSH 的新建工作区窗口：');
-          out.push('  ' + r.root);
-          return { text: out.join(NL) };
-        }
-        const title = String(args.title || '').trim() || '全局';
-        try {
-          const w = await reg.create(r.root, title);
-          registered = w;
-          out.push('');
-          out.push('已注册工作区：' + title + '（' + String(w && w.id ? w.id : '?') + '）');
-        } catch (e) {
-          out.push('');
-          out.push('注册失败：' + String(e && e.message ? e.message : e));
-          out.push('可把下面这个路径粘进 DSH 的新建工作区窗口：');
-          out.push('  ' + r.root);
-          return { text: out.join(NL) };
-        }
-      }
-
-      out.push('');
-      out.push('下一步：');
-      if (!registered) {
-        out.push('  1. 注册为工作区：ho_workspace(action="create", path="' + r.root + '", title="全局")，或把该路径粘进 DSH 的新建工作区窗口；');
-        out.push('  2. 新建一个标题含「全局」的会话，闸门、交接体检、会话水位即接入。');
-      } else {
-        out.push('  新建一个标题含「全局」的会话，闸门、交接体检、会话水位即接入。');
-      }
-      out.push('（也可以在设置页的 dsh-handover 中完成「首次安装」，效果相同。）');
-      return { text: out.join(NL) };
-    },
-  };
-}

package/src/tools/ho_pack.mjs

@@ -1,38 +0,0 @@
-/** ho_pack —— 打包族：action=check（前置闸门）、pack（打包）、verify（校包）、restore（默认预演）。 */
-import { textOutput } from '../lib/output.mjs';
-import { nameOf } from '../lib/names.mjs';
-import { packCheck, packNow, packVerify, packRestore } from '../lib/pack-ops.mjs';
-
-export function pmPackTool(env) {
-  return {
-    name: nameOf('pack'),
-    description: '迁移包四合一：check 前置闸门、pack 打包、verify 校包、restore 恢复（默认预演）。',
-    parameters: {
-      type: 'object',
-      additionalProperties: false,
-      properties: {
-        action: { type: 'string', enum: ['check', 'pack', 'verify', 'restore'], description: '缺省 pack' },
-        kind: { type: 'string', enum: ['project', 'task', 'global'], description: 'pack 的目标类型' },
-        name: { type: 'string', description: 'pack 的项目名、任务名' },
-        out: { type: 'string', description: 'pack 的输出目录' },
-        note: { type: 'string', description: 'pack 写进 MIGRATION.md 的说明' },
-        items: { type: 'array', items: { type: 'string' }, description: 'check 检查的项目名（global 表示全局）' },
-        min_age_min: { type: 'number', description: 'check 要求静止分钟（默认 90）' },
-        pack: { type: 'string', description: 'verify/restore 的包路径' },
-        target: { type: 'string', description: 'restore 的目标根（默认当前）' },
-        apply: { type: 'boolean', description: 'restore 时 true 才写入' },
-        dry_run: { type: 'boolean', description: 'pack 只列清单；restore 只预演' },
-        format: { type: 'string', enum: ['auto', '7z', 'tar'], description: 'pack 的归档格式：auto＝有 7-Zip 用 7z，否则内置 tar.gz（默认）' },
-      },
-    },
-    output: textOutput(),
-    async execute(args, exec) {
-      const action = typeof args.action === 'string' && args.action ? args.action : 'pack';
-      if (action === 'check') return { text: packCheck(env, args, exec) };
-      if (action === 'verify') return { text: packVerify(env, args, exec) };
-      if (action === 'restore') return { text: packRestore(env, args, exec) };
-      if (action !== 'pack') throw new Error('未知 action：' + action + '（check、pack、verify、restore）');
-      return { text: packNow(env, args, exec) };
-    },
-  };
-}

package/src/tools/ho_phase.mjs

@@ -1,37 +0,0 @@
-/** ho_phase —— 本会话阶段：水位 / 已压缩次数 / 锁状态 / 建议动作（纯只读，不压缩）。 */
-import { textOutput } from '../lib/output.mjs';
-import { nameOf } from '../lib/names.mjs';
-import { NL } from '../lib/text.mjs';
-import { decide } from '../lib/phase.mjs';
-
-export function pmPhaseTool(env) {
-  return {
-    name: nameOf('phase'),
-    description:
-      '本会话阶段：水位、已压缩次数、锁状态、建议动作。只读。',
-    parameters: {
-      type: 'object',
-      additionalProperties: false,
-      properties: {
-        simulateRatio: { type: 'number', description: '演练用：用这个比例替代真实水位（0-1），不写任何状态' },
-      },
-    },
-    output: textOutput(),
-    async execute(args, exec) {
-      const meId = env.selfId(exec);
-      const real = env.selfPct(meId);
-      const ratio = typeof args.simulateRatio === 'number' ? args.simulateRatio : (real === null ? null : real / 100);
-      const count = env.compactionCount(exec);
-      const lock = env.lockState(exec);
-      const adv = decide({ ratio, compactionsUsed: count.used, cfg: env.cfg, lockState: lock });
-      const out = [];
-      out.push('会话      ' + (meId || '未知'));
-      out.push('水位      ' + (ratio === null ? '读不到' : (Math.round(ratio * 1000) / 10).toFixed(1) + '%') + (typeof args.simulateRatio === 'number' ? '  （演练模拟值）' : '') + (typeof env.staleNote === 'function' ? env.staleNote(exec) : ''));
-      const usedText = count.used + '/' + (env.cfg.maxCompactions) + ' 次';
-      out.push('压缩      ' + usedText + (count.note ? '  ' + count.note : ''));
-      out.push('锁        ' + lock);
-      out.push('建议      ' + adv.action + ' —— ' + adv.reason);
-      return { text: out.join(NL) };
-    },
-  };
-}

package/src/tools/ho_snapshot.mjs

@@ -1,104 +0,0 @@
-/** ho_snapshot —— 库快照：逐字节复制 + sha256 清单 + PROVENANCE（Charter §4.4）。 */
-import fs from 'node:fs';
-import { nameOf } from '../lib/names.mjs';
-import path from 'node:path';
-import crypto from 'node:crypto';
-import { textOutput } from '../lib/output.mjs';
-import { NL, isDir } from '../lib/text.mjs';
-import { assertProjectName } from '../lib/role.mjs';
-
-const SKIP_DIRS = ['__pycache__', '.git', 'node_modules', '.obsidian'];
-const SKIP_FILES = ['.DS_Store', 'Thumbs.db'];
-
-function stamp() {
-  const d = new Date();
-  const p = (n) => (n < 10 ? '0' + n : '' + n);
-  return d.getFullYear() + p(d.getMonth() + 1) + p(d.getDate()) + '-' + p(d.getHours()) + p(d.getMinutes());
-}
-
-function walk(root, rel, rows) {
-  for (const name of fs.readdirSync(path.join(root, rel))) {
-    const full = path.join(root, rel, name);
-    const st = fs.statSync(full);
-    const r = rel ? rel + '/' + name : name;
-    if (st.isDirectory()) {
-      if (SKIP_DIRS.indexOf(name) !== -1) continue;
-      walk(root, r, rows);
-    } else if (st.isFile()) {
-      if (SKIP_FILES.indexOf(name) !== -1) continue;
-      if (name.endsWith('.pyc')) continue;
-      rows.push({ rel: r, size: st.size });
-    }
-  }
-  return rows;
-}
-
-export function pmSnapshotTool(env) {
-  return {
-    name: nameOf('snapshot'),
-    description:
-      '库快照：逐字节复制、sha256 清单、来源说明。',
-    parameters: {
-      type: 'object',
-      additionalProperties: false,
-      required: ['project'],
-      properties: {
-        project: { type: 'string', description: '项目名（Projects/<项目>/ 下）' },
-        tag: { type: 'string', description: '标签，默认 行为检查' },
-        dry_run: { type: 'boolean', description: '只统计不落盘' },
-      },
-    },
-    output: textOutput(),
-    async execute(args, exec) {
-      const ws = env.resolveWs(exec);
-      const project = assertProjectName(typeof args.project === 'string' ? args.project.trim() : '');
-      if (!project) throw new Error('project 不能为空（写项目名，如 Demo）');
-      const projDir = path.join(ws, 'Projects', project);
-      if (!isDir(projDir)) throw new Error('找不到项目：' + projDir);
-      let lib = null;
-      for (const name of fs.readdirSync(projDir)) {
-        const p = path.join(projDir, name);
-        if (isDir(p) && fs.existsSync(path.join(p, 'RULES.md'))) { lib = p; break; }
-      }
-      if (!lib) throw new Error('该项目下没有带 RULES.md 的库根：' + projDir);
-      const rows = walk(lib, '', []);
-      const total = rows.reduce((a, b) => a + b.size, 0);
-      const out = [];
-      out.push('源库 ' + lib);
-      out.push('文件 ' + rows.length + ' 个，共 ' + (total / 1048576).toFixed(2) + ' MB');
-      if (args.dry_run) { out.push('dry_run：不落盘。'); return { text: out.join(NL) }; }
-      const tag = args.tag || '行为检查';
-      const dest = path.join(ws, '_Temp', 'Checks', args.project + '_' + tag + '_' + stamp());
-      if (fs.existsSync(dest)) throw new Error('目标已存在，不覆盖：' + dest);
-      const libDest = path.join(dest, 'lib');
-      fs.mkdirSync(libDest, { recursive: true });
-      const manifest = ['# 源库: ' + lib, '# 文件: ' + rows.length + '  字节: ' + total];
-      let drift = 0;
-      for (const r of rows) {
-        const src = path.join(lib, r.rel);
-        const dst = path.join(libDest, r.rel);
-        fs.mkdirSync(path.dirname(dst), { recursive: true });
-        fs.copyFileSync(src, dst);
-        const h1 = crypto.createHash('sha256').update(fs.readFileSync(src)).digest('hex');
-        const h2 = crypto.createHash('sha256').update(fs.readFileSync(dst)).digest('hex');
-        if (h1 !== h2) drift++;
-        manifest.push(r.rel + String.fromCharCode(9) + r.size + String.fromCharCode(9) + h1);
-      }
-      fs.writeFileSync(path.join(dest, 'MANIFEST.tsv'), manifest.join(NL), 'utf8');
-      const prov = [
-        '# PROVENANCE',
-        '- 源库: ' + lib,
-        '- 生成时间: ' + new Date().toISOString(),
-        '- 发起会话: ' + (env.selfId(exec) || '?'),
-        '- 文件数/字节: ' + rows.length + ' / ' + total,
-        '- 排除: __pycache__ .git node_modules .obsidian *.pyc .DS_Store Thumbs.db',
-        '- 校验: 逐文件 sha256 比对，drift=' + drift,
-        '- 含个人数据，不得外发、不得进 _Archives',
-      ].join(NL);
-      fs.writeFileSync(path.join(dest, 'PROVENANCE.md'), prov, 'utf8');
-      out.push('已落盘 ' + dest);
-      out.push('校验 drift=' + drift + (drift === 0 ? '（逐文件一致）' : '（**不一致，判失败**）'));
-      return { text: out.join(NL) };
-    },
-  };
-}