@mingmaple/dsh-handover 0.9.14 → 1.0.0

package/src/tools/ho_office.mjs

@@ -1,19 +1,29 @@
-/** ho_office —— 在任登记表：查某条类别现在由哪个会话在任（只读）。 */
+/** ho_office —— 在任登记表：查在任；也用于会话首次注册自己的名字。 */
 import { textOutput } from '../lib/output.mjs';
 import { nameOf } from '../lib/names.mjs';
 import { NL } from '../lib/text.mjs';
-import { loadOffice, resolveOffice, rowsOf, formatRow, officePath } from '../lib/office.mjs';
+import { loadOffice, resolveOffice, rowsOf, formatRow, officePath, registerHolder, lineageKeyOf } from '../lib/office.mjs';
+
+function validDisplayName(name) {
+  const s = String(name || '').trim();
+  if (!s) return '名字不能为空';
+  if (s.length > 40) return '名字不超过 40 个字符';
+  if (/[\\/:*?"<>|\r\n]/.test(s)) return '名字不能含路径分隔符或换行';
+  return '';
+}
 
 export function pmOfficeTool(env) {
   return {
     name: nameOf('office'),
     description:
-      '查在任：输入「全局」「全局3」「项目名」等，返回现任会话的名字与 id；多个用空格分隔，留空列全部。只读。',
+      '在任登记：query 查在任（缺省）；action=register 由本会话首次注册自身名称，注册后不得自行修改。',
     parameters: {
       type: 'object',
       additionalProperties: false,
       properties: {
-        query: { type: 'string', description: '要查的名字，如「全局」「全局3」「Mingent」「抢名额脚本」；多个用空格或逗号分隔；留空＝列出全部在任' },
+        action: { type: 'string', enum: ['read', 'register'], description: '缺省 read；register 首次注册名字' },
+        name: { type: 'string', description: 'action=register 时的注册名（≤40 字，不含路径分隔符）' },
+        query: { type: 'string', description: '要查的名字，如「全局」「全局3」「Demo1」「示例任务」；多个用空格或逗号分隔；留空＝列出全部在任' },
         json: { type: 'boolean', description: 'true 时输出机器可读 JSON（供脚本解析）' },
       },
     },
@@ -21,10 +31,41 @@ export function pmOfficeTool(env) {
     async execute(args, exec) {
       const ws = env.resolveWs(exec);
       if (!ws) return { text: '无法确定工作区根，读不到在任登记表。' };
+      const action = typeof args.action === 'string' && args.action ? args.action : 'read';
+      if (action === 'register') {
+        const meId = String(env.selfId(exec) || '');
+        if (!meId) throw new Error('无法取得本会话 id，不能注册');
+        let info = null;
+        try { info = env.roleOf(exec); } catch { info = null; }
+        const role = info && info.role ? info.role : 'plain';
+        if (role !== 'project' && role !== 'misc' && role !== 'global') {
+          throw new Error('普通会话没有注册名；先在设置页设定项目或杂项角色');
+        }
+        const name = String(args.name || '').trim();
+        const bad = validDisplayName(name);
+        if (bad) throw new Error(bad);
+        const kind = role;
+        const project = role === 'project' ? String(info.project || '') : '';
+        const task = role === 'misc' ? String(info.task || '') : '';
+        const key = lineageKeyOf(kind, project, task);
+        const store = loadOffice(ws);
+        const lin = store.lineages[key];
+        const cur = lin && lin.current;
+        if (cur && cur.sessionId && String(cur.sessionId) !== meId) {
+          throw new Error('类别「' + key + '」已有在任会话：' + (cur.name || '') + '（' + cur.sessionId + '）。不得抢注；先由全局处理在任会话。');
+        }
+        if (cur && String(cur.sessionId) === meId) {
+          if (String(cur.name || '') === name) return { text: '已注册：' + name + '（' + key + '）。注册后不得自行修改。' };
+          throw new Error('本会话已注册为「' + cur.name + '」，注册后不得自行修改；改名须找全局。');
+        }
+        const reg = registerHolder(ws, { kind, project, task, name, sessionId: meId });
+        try { if (typeof env.refreshPromptFor === 'function') env.refreshPromptFor(meId); } catch { /* 重装失败不影响注册 */ }
+        return { text: '已注册：' + name + '（' + reg.key + '，会话 ' + meId + '）。注册后不得自行修改；改名须找全局。' };
+      }
       const store = loadOffice(ws);
       const rows = rowsOf(store);
       if (!rows.length) {
-        return { text: '在任登记表还是空的（' + officePath(ws) + '）：先登记一次在任会话，再查。' };
+        return { text: '在任登记表为空（' + officePath(ws) + '）：先登记一次在任会话，再查询。' };
       }
       const raw = String(args.query || '').trim();
       const tokens = raw ? raw.split(/[\s,，、;；]+/).filter(Boolean) : [];

package/src/tools/ho_profile.mjs

@@ -13,7 +13,7 @@ function targetOf(env, info, args, exec) {
     // 项目会话只处理自己的骨架；传了别的名字就明确报错，而不是静默忽略入参（实测踩过）。
     if (given && given !== own) {
       throw new Error('本会话是' + (info.role === 'project' ? '项目「' + own + '」' : '杂项「' + own + '」')
-        + '，只能读写自己的骨架；要看「' + given + '」请由全局会话执行 ho_profile。');
+        + '，只能读写自己的骨架；如需查看「' + given + '」，由全局会话执行 ho_profile。');
     }
     return { role: info.role, project: info.project || '', task: info.task || '', self: true };
   }
@@ -32,7 +32,7 @@ function scopeOf(t) {
 export function pmProfileTool(env) {
   return {
     name: nameOf('profile'),
-    description: '项目或杂项骨架：读取、注册、校验、取预设。只写本角色的 _Project_Meta 或 _Misc 目录。',
+    description: '项目或杂项骨架：读取、注册、校验、取预设。仅写本角色的 _Project_Meta 或 _Misc 目录。',
     parameters: {
       type: 'object',
       additionalProperties: false,
@@ -81,7 +81,7 @@ export function pmProfileTool(env) {
         return { text: out.join(NL) };
       }
       if (action === 'register') {
-        if (!t.self) throw new Error('注册须由该项目或杂项会话本人执行');
+        if (!t.self) throw new Error('注册须由该项目或杂项会话自身执行');
         if (!r.exists) throw new Error('未找到骨架文件：' + p + '。先通读本库并写入该文件，再执行注册。');
         if (r.errors.length) throw new Error('骨架结构不合法：' + r.errors.join('；'));
         const saved = writeProfile(ws, scope, r.profile);

package/src/tools/ho_sessions.mjs

@@ -2,16 +2,16 @@
 import { textOutput } from '../lib/output.mjs';
 import { nameOf } from '../lib/names.mjs';
 import { NL } from '../lib/text.mjs';
-import path from 'node:path';
 import { scanSessions } from '../lib/sessions.mjs';
 import { syncCheck } from '../lib/gates.mjs';
 import { stamp } from '../lib/brief.mjs';
 import { sessionNew, sessionPrompt, sessionArchive, sessionUnarchive, sessionOrder, sessionPlace } from '../lib/session-ops.mjs';
+import { createGlobalTask } from '../lib/global-task.mjs';
 import { readRoles, resolveRole, ROLE_LABEL, sessionMeta } from '../lib/role.mjs';
 import { watermark } from '../lib/facts.mjs';
 
 function list(env, args, exec) {
-  const warn = typeof args.warn === "number" ? args.warn : watermark(env.cfg).warnValue;
+  const warn = typeof args.warn === "number" ? args.warn : watermark(env.cfg).remindValue;
   const limit = typeof args.limit === "number" ? args.limit : 40;
   const scan = scanSessions({
     dir: env.cacheDir(),
@@ -27,7 +27,7 @@ function list(env, args, exec) {
     return resolveRole({ cfg: env.cfg, roles: store, sessionId: r.sid, cwd: meta.cwd, firstPrompt: meta.firstPrompt, subagent: meta.subagent, title: r.project });
   };
   const out = [];
-  out.push("活跃 / 沉默线：最后活动 " + stamp(scan.cutoffMs) + " 之后算活跃（" + scan.silentHours + " 小时；Charter 7.2.3）");
+  out.push("活跃与沉默线：最后活动晚于 " + stamp(scan.cutoffMs) + " 记为活跃（" + scan.silentHours + " 小时；Charter 7.2.3）");
   for (const r of scan.rows.slice(0, limit)) {
     const pct = r.pct === null ? "水位 ?" : "水位 " + r.pct.toFixed(1) + "%";
     const lab = r.mtime >= scan.cutoffMs ? "活跃" : "沉默";
@@ -37,19 +37,19 @@ function list(env, args, exec) {
   }
   const notifProjects = new Set(scan.notify.map((r) => r.project));
   const skipProjects = new Set(scan.skip.map((r) => r.project));
-  out.push("通知判定：活跃项目 " + notifProjects.size + " 个，需要通知 " + scan.notify.length + " 个会话（仅各项目在任）/ 沉默项目 " + skipProjects.size + " 个，跳过 " + scan.skip.length + " 个会话（沉默项目全部＋前任）");
+  out.push("通知判定：活跃项目 " + notifProjects.size + " 个，需要通知 " + scan.notify.length + " 个会话（仅各项目在任）/ 沉默项目 " + skipProjects.size + " 个，跳过 " + scan.skip.length + " 个会话（沉默项目全部＋已交出的旧会话）");
   for (const r of scan.notify) out.push("  要通知【在任】" + r.project + "(" + r.sid + ")  最后活动 " + stamp(r.mtime));
-  if (scan.skip.length) out.push("  跳过（沉默项目，含其前任）：" + scan.skip.map((x) => x.project + "(" + x.sid.slice(-8) + ")").join("、"));
+  if (scan.skip.length) out.push("  跳过（沉默项目，含其已交出的旧会话）：" + scan.skip.map((x) => x.project + "(" + x.sid.slice(-8) + ")").join("、"));
   const gate = syncCheck(env.resolveWs(exec));
-  if (gate.error) out.push("通用约束条闸门（Charter §7.2.3）：读不到 §8.1.1.4 正文 —— 请人工核 " + gate.path);
+  if (gate.error) out.push("通用约束条闸门（Charter §7.2.3）：读不到 §8.1.1.4 正文，请人工核对 " + gate.path);
   else if (!gate.ok) {
     const bad = gate.libraries.filter((l) => !l.ok).map((l) => l.name + "(缺 " + l.missing.length + " 行)");
-    out.push("通用约束条闸门（Charter §7.2.3「闸门」）：**未过** —— " + bad.join("、"));
+    out.push("通用约束条闸门（Charter §7.2.3「闸门」）：未通过 —— " + bad.join("、"));
     out.push("判定：通用约束条有库缺，交接前必须补齐（Charter §7.2.3 闸门）");
     return out.join(NL);
   } else out.push("通用约束条闸门（Charter §7.2.3「闸门」）：" + gate.total + "/" + gate.total + " 已落位");
   const verdict = scan.hot.length
-    ? "判定：" + scan.hot.length + " 个会话已进预警区（>=" + warn + "%），按 Charter 7.2.3 先收齐交接再换会话"
+    ? "判定：" + scan.hot.length + " 个会话已进入预警区（>=" + warn + "%），按 Charter 7.2.3 先收齐交接，再换会话"
     : scan.unknown.length
       ? "判定：" + scan.unknown.length + " 个会话水位无法读取，需人工判断"
       : "判定：没有会话进入预警区（>=" + warn + "%），可以继续";
@@ -60,38 +60,53 @@ function list(env, args, exec) {
 export function pmSessionsTool(env) {
   return {
     name: nameOf('sessions'),
-    description: '会话清点与调度；action=role 设置角色、new 建会话、order 下指令（交接、压缩）、place 移入工作区、prompt 出提示词、archive/unarchive 归档。',
+    description: '会话清点与调度：action=list 清点、role 设定角色、new 新建会话（from_task 可把全局任务独立为项目或杂项）、task-init 建全局任务库、order 下达指令、place 移入工作区、prompt 生成启动提示词、archive 与 unarchive 归档。',
     parameters: {
       type: 'object',
       additionalProperties: false,
       properties: {
-        action: { type: 'string', enum: ['list', 'role', 'new', 'order', 'place', 'prompt', 'archive', 'unarchive'], description: '缺省 list' },
-        order: { type: 'string', enum: ['handover', 'compact'], description: 'order 的动作：handover 让它写交接再换任；compact 给它排压缩（先要有合格交接）' },
-        resume: { type: 'string', enum: ['continue', 'wait'], description: 'order=compact 时的去向：缺省 wait（交接后收尾，压缩后不唤醒）；continue 表示压缩后按交接继续' },
-        include_subagents: { type: 'boolean', description: 'list 时含子会话' },
-        limit: { type: 'number', description: 'list 行数（默认 40）' },
-        warn: { type: 'number', description: 'list 预警阈值（默认 ' + watermark(env.cfg).warn + '）' },
-        session_id: { type: 'string', description: 'role/order/place/archive/unarchive 的目标会话' },
-        role: { type: 'string', enum: ['global', 'project', 'misc', 'plain'], description: 'role 要设成的角色；new 时也据此登记接任者角色' },
-        project: { type: 'string', description: '项目名（role=project 必填；new 时为换任项目）' },
-        task: { type: 'string', description: '任务名（role=misc 必填）' },
-        notify: { type: 'boolean', description: 'role 时投整理指令（默认 true，会唤醒它一轮）' },
+        action: { type: 'string', enum: ['list', 'role', 'new', 'task-init', 'order', 'place', 'prompt', 'archive', 'unarchive'], description: '缺省 list' },
+        order: { type: 'string', enum: ['handover', 'compact'], description: 'order 的动作：handover 令目标会话写交接后换任；compact 为其排压缩（须先有合格交接）' },
+        resume: { type: 'string', enum: ['continue', 'wait'], description: 'order=compact 时的去向：缺省 wait（任务已收尾，压缩后不唤醒）；continue 为压缩后按交接继续' },
+        include_subagents: { type: 'boolean', description: 'list：是否列出子会话' },
+        limit: { type: 'number', description: 'list 的行数（默认 40）' },
+        warn: { type: 'number', description: 'list 的预警阈值（默认 ' + watermark(env.cfg).remind + '）' },
+        session_id: { type: 'string', description: 'role、order、place、archive、unarchive 的目标会话' },
+        role: { type: 'string', enum: ['global', 'project', 'misc', 'plain'], description: 'role 要设成的角色；new 时据此登记接任者角色' },
+        project: { type: 'string', description: '项目名（role=project 时必填；new 时为接任会话所属项目）' },
+        migrate: { type: 'string', enum: ['auto', 'direct'], description: 'role 时项目与杂项互转的方式：auto（缺省）先快照再移动；direct 直接建新体系' },
+        from_task: { type: 'string', description: 'new 时把某个全局任务整体独立为项目或杂项会话（沿用现有体系，不重建、不重新注册）' },
+        task: { type: 'string', description: '任务名（task-init 必填；role=misc 必填；new 时为接任会话所属任务）' },
+        notify: { type: 'boolean', description: 'role 时投递首轮指令（默认 true，将唤醒该会话一轮）' },
         title: { type: 'string', description: 'new 的标题；prompt 用于推断代际' },
         workspace: { type: 'string', description: 'new 必填：目标工作区的 id、标题或路径；new 时不给也能按 project 自动匹配同名工作区' },
         cwd: { type: 'string', description: 'new 的工作目录，必须是某个已注册工作区的根（与 workspace 二选一）' },
         message: { type: 'string', description: 'new 的启动提示词；不给则自动生成' },
-        force: { type: 'boolean', description: 'new 越过 <' + watermark(env.cfg).warn + ' 复用判据；order=compact 越过 120 秒去抖；archive 允许停掉在跑的' },
+        force: { type: 'boolean', description: 'new 越过 <' + watermark(env.cfg).remind + ' 复用判据；order=compact 越过 120 秒去抖；archive 允许停掉在跑的' },
         kind: { type: 'string', enum: ['global', 'project', 'misc', 'migration'], description: 'prompt 的类型；new 时用作角色候选' },
         sessionId: { type: 'string', description: 'prompt：新会话自己的 id' },
-        globalSessionId: { type: 'string', description: 'prompt：现任全局 id' },
+        globalSessionId: { type: 'string', description: 'prompt：在任全局 id' },
         extra: { type: 'string', description: 'prompt 附加一句；order 时作为「全局附加」拼进指令' },
-        confirm: { type: 'boolean', description: 'new、order 需要用户明确同意后传 true；否则只报错、不做任何事' },
+        confirm: { type: 'boolean', description: 'new、order 需要当前用户明确同意后传 true；否则只报错、不做任何事' },
       },
     },
     output: textOutput(),
     async execute(args, exec) {
       const action = typeof args.action === 'string' && args.action ? args.action : 'list';
       if (action === 'list') return { text: list(env, args, exec) };
+      if (action === 'task-init') {
+        const info = env.roleOf(exec);
+        if (!info || info.role !== 'global') throw new Error('task-init 只对全局会话开放');
+        const ws = env.resolveWs(exec);
+        const r = createGlobalTask(ws, args.task);
+        const out = [];
+        out.push('已建立全局任务库：' + r.dir);
+        out.push('  新建 ' + r.created.length + ' 个文件' + (r.created.length ? '：' + r.created.join('、') : ''));
+        out.push('交接：_Control_Center/tasks/' + String(args.task) + '/Handover.md；用 ho_handover(action=…, task="' + String(args.task) + '") 读写。');
+        out.push('体系注册已登记进 _Control_Center/records/systems.md；行动计划用 ho_docmap(action="plan", task="' + String(args.task) + '", mode="write")。');
+        out.push('独立为项目或杂项会话：ho_sessions(action="new", role="project"|"misc", from_task="' + String(args.task) + '", …)（须当前用户确认）。');
+        return { text: out.join(NL) };
+      }
       if (action === 'new') return { text: await sessionNew(env, args, exec) };
       if (action === 'order') return { text: await sessionOrder(env, args) };
       if (action === 'place') return { text: await sessionPlace(env, args) };
@@ -100,12 +115,17 @@ export function pmSessionsTool(env) {
       if (action === 'unarchive') return { text: await sessionUnarchive(env, args) };
       if (action === 'role') {
         if (typeof env.applyRole !== 'function') throw new Error('宿主侧没有装配 applyRole');
-        const r = await env.applyRole({ sessionId: args.session_id, role: args.role, project: args.project, task: args.task, wake: args.notify !== false });
+        const r = await env.applyRole({
+          sessionId: args.session_id, role: args.role, project: args.project, task: args.task,
+          wake: args.notify !== false, migrate: args.migrate,
+        });
         const out = [];
         out.push(r.ok ? '已设定角色：' + (ROLE_LABEL[r.role] || r.role) : '设定失败：' + r.error);
         if (r.ok) {
-          out.push('  存活会话当场生效：' + (r.live ? '是（工具集与提示段已换）' : '否（下次开轮时生效）'));
-          out.push('  整理指令：' + (r.delivered ? '已投递（会唤醒它一轮）' : (r.error ? '投递失败：' + r.error : '未投递')));
+          out.push('  存活会话当场生效：' + (r.live ? '是（工具集与提示段已更换）' : '否（下次开轮时生效）'));
+          if (r.migrated) out.push('  身份互转：' + r.migrated + ' —— ' + r.migrationSummary);
+          out.push('  首轮指令：' + (r.delivered ? '已投递（将唤醒该会话一轮）' : (r.error ? '投递失败：' + r.error : '未投递')));
+          out.push('  注册名：' + (r.registeredName || '尚未注册（由该会话首轮与当前用户确认后，用 ho_office action="register" 注册）'));
         }
         return { text: out.join(NL) };
       }

package/src/tools/ho_status.mjs

@@ -0,0 +1,251 @@
+/**
+ * ho_status —— 会话状态：一个入口，按 view 分流。
+ *   phase（默认）：水位、压缩次数、锁、建议动作
+ *   brief：水位、闸门、会话清点、交接漂移、阶段建议
+ *   diag：服务可解析性、调度器、初始化错误、角色与工具集
+ *   drift：交接漂移体检
+ *   tokens：按会话 id 统计轮数、步数、每步 token
+ * 全部只读；原 ho_phase、ho_brief、ho_diag、ho_drift、ho_tokens 合并于此。
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { textOutput } from '../lib/output.mjs';
+import { nameOf } from '../lib/names.mjs';
+import { NL, pick } 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, driftVerdict } from '../lib/drift.mjs';
+import { watermark } from '../lib/facts.mjs';
+import { eventsOf, countCompactions } from '../lib/events.mjs';
+import { findLog, decodeLog, turnStarts } from '../lib/zstd-log.mjs';
+import { activeConsentsFor, formatConsentLine } from '../lib/consent.mjs';
+import { readReminderState } from '../lib/reminder.mjs';
+
+export const VIEWS = ['phase', 'brief', 'diag', 'drift', 'tokens'];
+
+function analyzeLog(records) {
+  const turns = turnStarts(records).length;
+  let steps = 0, outTok = 0, maxResult = 0, toolResults = 0;
+  const perTurn = new Map();
+  for (const r of records) {
+    if (!r || !r.type) continue;
+    if (r.type === 'step/start') {
+      steps++;
+      const t = pick(r, 'data', 'turn');
+      if (typeof t === 'number') perTurn.set(t, (perTurn.get(t) || 0) + 1);
+    } else if (r.type === 'assistant/message') {
+      const u = pick(r, 'data', 'usage');
+      if (u && typeof u.outputTokens === 'number') outTok += u.outputTokens;
+    } else if (r.type === 'tool/result') {
+      toolResults++;
+      try { const len = JSON.stringify(pick(r, 'data') || '').length; if (len > maxResult) maxResult = len; } catch { /* ignore */ }
+    }
+  }
+  const heavyTurns = Array.from(perTurn.values()).filter((n) => n > 20).length;
+  return { turns, steps, outTok, maxResult, toolResults, heavyTurns, perStep: steps ? Math.round(outTok / steps) : 0 };
+}
+
+/** 授权状态行：压缩与换任各一句，未授权写「无授权」。 */
+function consentLine(meId) {
+  try { return formatConsentLine(activeConsentsFor(meId)); } catch { return ''; }
+}
+
+function phaseText(env, 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) : ''));
+  out.push('压缩      ' + count.used + '/' + env.cfg.maxCompactions + ' 次' + (count.note ? '  ' + count.note : ''));
+  out.push('锁        ' + lock);
+  out.push('建议      ' + adv.action + ' —— ' + adv.reason);
+  const c = consentLine(meId);
+  if (c) out.push('授权      ' + c);
+  return out;
+}
+
+function briefText(env, args, exec) {
+  const ws = env.resolveWs(exec);
+  const w = watermark(env.cfg);
+  const warn = typeof args.threshold === 'number' ? args.threshold : w.remindValue;
+  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,
+  });
+  const c = consentLine(meId);
+  if (c) lines.push('授权   ' + c);
+  return lines;
+}
+
+function diagText(env, state, 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（action="send"、"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) : ''));
+  try {
+    const rec = readReminderState().sessions[String(meId || '')] || {};
+    out.push('提醒      35%=' + (rec.r35 ? '已提醒' : '未提醒') + '  50%=' + (rec.r50 ? '已提醒' : '未提醒'));
+  } catch { /* 提醒状态读不到不影响自检 */ }
+  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_workspace(action="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('配置      remind=' + env.cfg.remindRatio + '·' + env.cfg.remind2Ratio + ' handover=' + env.cfg.handoverRatio + ' pureWindow=' + env.cfg.pureWindowRatio + ' 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 out;
+}
+
+function driftText(env, 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 out;
+}
+
+function tokensText(args) {
+  const out = [];
+  const list = Array.isArray(args.sessions) ? args.sessions.filter((s) => typeof s === 'string' && s.trim() !== '') : [];
+  if (!list.length) throw new Error('view=tokens 时 sessions 不能为空（给会话 id 数组）');
+  out.push('会话 轮 步 输出tok 每步tok 最贵返回 超20步轮 判定');
+  for (const sid of list) {
+    const full = sid.indexOf('session-') === 0 ? sid : 'session-' + sid;
+    const log = findLog(full);
+    if (!log) { out.push(sid + '  ERR 日志不存在'); continue; }
+    const recs = decodeLog(log);
+    if (!recs) { out.push(sid + '  ERR 日志无法解码'); continue; }
+    const m = analyzeLog(recs);
+    const verdict = m.perStep > 2000 ? '偏贵（每步 >2k）' : m.heavyTurns > 0 ? '有超 20 步的轮' : '正常';
+    out.push([sid.slice(-8), m.turns, m.steps, m.outTok, m.perStep, Math.round(m.maxResult / 1024) + 'KB', m.heavyTurns, verdict].join('  '));
+  }
+  return out;
+}
+
+export function pmStatusTool(env, state) {
+  const w = watermark(env.cfg);
+  return {
+    name: nameOf('status'),
+    description:
+      '会话状态（只读）：view=phase 水位与建议（缺省）、brief 起始简报、diag 插件自检、drift 交接漂移、tokens token 体检。',
+    parameters: {
+      type: 'object',
+      additionalProperties: false,
+      properties: {
+        view: { type: 'string', enum: VIEWS, description: '缺省 phase' },
+        threshold: { type: 'number', description: 'view=brief：预警阈值百分比（默认 ' + w.remindValue + '）' },
+        simulateRatio: { type: 'number', description: 'view=phase：演练用比例替代真实水位（0-1），不写任何状态' },
+        sessions: { type: 'array', items: { type: 'string' }, description: 'view=tokens：会话 id 列表' },
+        slack: { type: 'number', description: 'view=drift：容忍轮数（默认 3）' },
+        all: { type: 'boolean', description: 'view=drift：列全部会话，而不只是每个项目的在任会话' },
+      },
+    },
+    output: textOutput(),
+    async execute(args, exec) {
+      const view = typeof args.view === 'string' && args.view ? args.view : 'phase';
+      if (VIEWS.indexOf(view) === -1) throw new Error('view 只能是 ' + VIEWS.join(' | ') + '（收到 ' + String(view) + '）');
+      if (view === 'phase') return { text: phaseText(env, args, exec).join(NL) };
+      if (view === 'brief') return { text: briefText(env, args, exec).join(NL) };
+      if (view === 'diag') return { text: diagText(env, state, exec).join(NL) };
+      if (view === 'drift') return { text: driftText(env, args, exec).join(NL) };
+      return { text: tokensText(args).join(NL) };
+    },
+  };
+}

package/src/tools/ho_succeed.mjs

@@ -7,13 +7,13 @@ export function pmSucceedTool(env) {
   return {
     name: nameOf('succeed'),
     description:
-      '换任：校验本会话交接，建接任会话并登记在任；须用户先授权（/allow-succeed）。',
+      '换任：校验本会话交接，建立接任会话并登记在任；须由当前用户先行授权（/allow-succeed）。',
     parameters: {
       type: 'object',
       additionalProperties: false,
       properties: {
-        note: { type: 'string', description: '写进在任登记的备注（可选）' },
-        force: { type: 'boolean', description: '本会话水位未到线时仍换任（默认不传）' },
+        note: { type: 'string', description: '写入在任登记的备注（可选）' },
+        force: { type: 'boolean', description: '本会话水位未到线时仍执行换任（缺省不传）' },
       },
     },
     output: textOutput(),