@mingmaple/dsh-handover 0.9.13 → 0.9.22

package/src/tools/ho_workspace.mjs

@@ -1,10 +1,11 @@
-/** ho_workspace —— 工作区生命周期：list / create / delete（官方 workspaceRegistry）＋ 全局根目录搬迁。 */
+/** ho_workspace —— 工作区生命周期：list / create / delete / init（首次建体系）＋ 全局根目录迁移。 */
 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 { workspaceRows } from '../lib/registry.mjs';
+import { createGlobalWorkspace, ensureScaffold } from '../lib/scaffold.mjs';
 import { probeMove, startMove, moveStatus, cleanupOld, stageSwitch, repairLink, stageRetarget } from '../lib/mover.mjs';
 import { currentRoot } from '../lib/api.mjs';
 
@@ -20,7 +21,7 @@ function gb(n) {
 
 function renderProbe(p) {
   const out = [];
-  out.push('搬迁预检：' + (p.ok ? '通过' : '不通过'));
+  out.push('迁移预检：' + (p.ok ? '通过' : '不通过'));
   out.push('  源  ' + p.src + (p.srcIsLink ? '（已是链接，指向 ' + p.linkTarget + '）' : ''));
   out.push('  复制源  ' + p.copyFrom);
   out.push('  目标  ' + p.dst);
@@ -36,7 +37,7 @@ export function pmWorkspaceTool(env) {
   return {
     name: nameOf('workspace'),
     description:
-      '工作区 list、create、delete；move-* 搬整个全局根目录（探针、执行、状态、清旧副本）。删除只删注册。',
+      '工作区：init 首次建全局体系、scaffold 补齐缺失目录与说明、list、create、delete、move-* 搬整个全局根目录。删除只删注册。',
     parameters: {
       type: 'object',
       additionalProperties: false,
@@ -44,15 +45,18 @@ export function pmWorkspaceTool(env) {
       properties: {
         action: {
           type: 'string',
-          enum: ['list', 'create', 'delete', 'move-probe', 'move', 'move-switch', 'move-status', 'move-retarget', 'move-repair', 'move-cleanup'],
-          description: 'list / create / delete / move-probe / move / move-switch / move-status / move-retarget / move-repair / move-cleanup',
+          enum: ['init', 'scaffold', 'list', 'create', 'delete', 'move-probe', 'move', 'move-switch', 'move-status', 'move-retarget', 'move-repair', 'move-cleanup'],
+          description: 'init / scaffold / list / create / delete / move-probe / move / move-switch / move-status / move-retarget / move-repair / move-cleanup',
         },
+        parent: { type: 'string', description: 'init 用：目标父目录绝对路径（不存在会创建）；全局根建在它里面' },
+        name: { type: 'string', description: 'init 用：全局根目录名，默认 _Workspace' },
+        register: { type: 'boolean', description: 'init 用：建好后顺带注册为工作区（默认 false）' },
         path: { type: 'string', description: 'create 用：目录绝对路径；默认要求已存在，ensure=true 时自动创建' },
-        title: { type: 'string', description: 'create 用：显示标题' },
+        title: { type: 'string', description: 'create、init 用：工作区显示标题（init 默认「全局」）' },
         ensure: { type: 'boolean', description: 'create 用：目录不存在时自动创建（默认 false，不替你建目录）' },
         workspace: { type: 'string', description: 'delete 用：工作区 id、标题、路径' },
         to: { type: 'string', description: 'move 用：新根绝对路径（父目录可自动建）' },
-        confirm: { type: 'boolean', description: 'move-cleanup 用：true 才真的删旧副本' },
+        confirm: { type: 'boolean', description: 'move-cleanup 用：true 才真的删旧备份' },
       },
     },
     output: textOutput(),
@@ -61,6 +65,74 @@ export function pmWorkspaceTool(env) {
       const action = String(args.action || '');
       const out = [];
 
+      if (action === 'init') {
+        const parent = String(args.parent || '').trim();
+        if (!parent) throw new Error('action="init" 需要 parent（目标父目录绝对路径）');
+        const r = createGlobalWorkspace(parent, { name: args.name });
+        if (!r.ok) {
+          out.push('未建立：' + r.error);
+          if (r.root) out.push('目标：' + r.root);
+          out.push('');
+          out.push('用法：ho_workspace(action="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) {
+          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) };
+      }
+
+      if (action === 'scaffold') {
+        const root = currentRoot(env);
+        if (!root) throw new Error('未找到全局根（工作区未接入）');
+        const r = ensureScaffold(root);
+        if (!r.ok) {
+          out.push('未补齐：' + r.error);
+          out.push('根目录：' + root);
+          return { text: out.join(NL) };
+        }
+        out.push('已核对文件体系：' + root);
+        out.push('  新建目录 ' + r.created.length + ' 个：' + (r.created.length ? r.created.join('、') : '（无缺失）'));
+        out.push('  新建文件 ' + r.written.length + ' 个：' + (r.written.length ? r.written.join('、') : '（无缺失）'));
+        out.push('  已存在未覆盖 ' + r.skipped.length + ' 个' + (r.skipped.length ? '：' + r.skipped.join('、') : ''));
+        out.push('只新建、不覆盖、不删：已有文件的内容一字未改。');
+        return { text: out.join(NL) };
+      }
+
       if (action === 'list') {
         if (reg && typeof reg.list === 'function') {
           let list = [];
@@ -144,7 +216,7 @@ export function pmWorkspaceTool(env) {
         out.push('下一步（三条，顺序不能换）：');
         out.push('  ① 完全退出 DSH（源目录被占用，改名会失败）');
         out.push('  ② 执行 ho_workspace(action="move-switch") 派后台助手（推荐）；助手会等待 DSH 退出后自动完成');
-        out.push('  ③ 重新启动 DSH；确认无误后在设置页点「删除旧副本」');
+        out.push('  ③ 重新启动 DSH；确认无误后可在设置页删除旧备份');
         return { text: out.join(NL) };
       }
 
@@ -160,8 +232,8 @@ export function pmWorkspaceTool(env) {
 
       if (action === 'move-status') {
         const st = moveStatus();   // 以标记里的源路径为准：修改登记后当前根已是新位置，拿它比对会误报
-        const label = { none: '没有搬迁记录', verified: '已复制校验通过，等待切换', switched: '已切换（旧路径是 junction）', partial: '复制有差异，未生成脚本' };
-        out.push('搬迁状态：' + (label[st.phase] || st.phase));
+        const label = { none: '没有迁移记录', verified: '已复制并校验通过，待切换', switched: '已切换（原路径为链接）', partial: '复制有差异，未生成脚本' };
+        out.push('迁移状态：' + (label[st.phase] || st.phase));
         out.push('  源  ' + st.src + (st.linkTarget ? '（→ ' + st.linkTarget + '）' : ''));
         if (st.dst) out.push('  目标  ' + st.dst);
         if (st.marker && st.marker.files) out.push('  清单  ' + st.marker.files + ' 文件 · ' + (st.marker.digest || '').slice(0, 16) + '…');
@@ -175,10 +247,10 @@ export function pmWorkspaceTool(env) {
           }
         }
         if (st.olds && st.olds.length) {
-          for (const o of st.olds) out.push('  旧副本  ' + o.path + '  ' + gb(o.bytes));
+          for (const o of st.olds) out.push('  旧备份  ' + o.path + '  ' + gb(o.bytes));
           out.push('  删除：ho_workspace(action="move-cleanup", confirm=true)');
         } else if (st.phase === 'switched') {
-          out.push('  没有旧副本残留');
+          out.push('  没有旧备份');
         }
         return { text: out.join(NL) };
       }
@@ -203,7 +275,7 @@ export function pmWorkspaceTool(env) {
       }
 
       if (action === 'move-cleanup') {
-        if (args.confirm !== true) throw new Error('move-cleanup 需要 confirm=true（会真删旧副本目录）');
+        if (args.confirm !== true) throw new Error('move-cleanup 需要 confirm=true（会真删旧备份目录）');
         const r = await cleanupOld({ confirm: true });
         out.push(r.note);
         for (const p of r.removed) out.push('  已删 ' + p);
@@ -211,7 +283,7 @@ export function pmWorkspaceTool(env) {
         return { text: out.join(NL) };
       }
 
-      throw new Error('action 只能是 list / create / delete / move-probe / move / move-switch / move-status / move-retarget / move-repair / move-cleanup');
+      throw new Error('action 只能是 init / scaffold / list / create / delete / move-probe / move / move-switch / move-status / move-retarget / move-repair / move-cleanup');
     },
   };
 }

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) };
-    },
-  };
-}