@mingmaple/dsh-handover 0.9.6 → 0.9.13

package/src/tools/ho_handover.mjs

@@ -5,7 +5,7 @@ import { NL } from '../lib/text.mjs';
 import fs from 'node:fs';
 import path from 'node:path';
 import crypto from 'node:crypto';
-import { readHandover, writeHandover } from '../lib/handover-io.mjs';
+import { readHandover, writeHandover, archiveStamp, archiveFileName } from '../lib/handover-io.mjs';
 import { archiveDirFor } from '../lib/role.mjs';
 
 function noPath(input) {
@@ -51,13 +51,14 @@ export function pmHandoverTool(env) {
       if (args.action === "archive") {
         const src = readHandover(target.path);
         if (src.text === null) throw new Error("要归档的交接不存在：" + target.path);
-        const d = new Date();
-        const p = (n) => (n < 10 ? "0" + n : "" + n);
-        const stampText = d.getFullYear() + p(d.getMonth() + 1) + p(d.getDate()) + "_" + p(d.getHours()) + p(d.getMinutes());
+        const stampText = archiveStamp(new Date());
         const dir = archiveDirFor(ws, info);
         fs.mkdirSync(dir, { recursive: true });
-        const base = info.role === 'project' ? (info.project + '_Handover_') : info.role === 'misc' ? ((info.task || 'task') + '_Handover_') : 'Global_Handover_';
-        const dest = path.join(dir, base + stampText + ".md");
+        // 命名按 Handover_Rules §4.2：<原文件名>_<YYYYMMDD_HHMMSS>.md；同一秒重复归档加 -2、-3。
+        let dest = path.join(dir, archiveFileName(target.path, stampText));
+        for (let n = 2; fs.existsSync(dest) && n < 100; n++) {
+          dest = path.join(dir, archiveFileName(target.path, stampText + "-" + n));
+        }
         if (fs.existsSync(dest)) throw new Error("归档目标已存在，不覆盖：" + dest);
         fs.copyFileSync(target.path, dest);
         const a = crypto.createHash("sha256").update(fs.readFileSync(target.path)).digest("hex");

package/src/tools/ho_office.mjs

@@ -0,0 +1,59 @@
+/** 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';
+
+export function pmOfficeTool(env) {
+  return {
+    name: nameOf('office'),
+    description:
+      '查在任：输入「全局」「全局3」「项目名」等，返回现任会话的名字与 id；多个用空格分隔，留空列全部。只读。',
+    parameters: {
+      type: 'object',
+      additionalProperties: false,
+      properties: {
+        query: { type: 'string', description: '要查的名字，如「全局」「全局3」「Mingent」「抢名额脚本」；多个用空格或逗号分隔；留空＝列出全部在任' },
+        json: { type: 'boolean', description: 'true 时输出机器可读 JSON（供脚本解析）' },
+      },
+    },
+    output: textOutput(),
+    async execute(args, exec) {
+      const ws = env.resolveWs(exec);
+      if (!ws) return { text: '无法确定工作区根，读不到在任登记表。' };
+      const store = loadOffice(ws);
+      const rows = rowsOf(store);
+      if (!rows.length) {
+        return { text: '在任登记表还是空的（' + officePath(ws) + '）：先登记一次在任会话，再查。' };
+      }
+      const raw = String(args.query || '').trim();
+      const tokens = raw ? raw.split(/[\s,，、;；]+/).filter(Boolean) : [];
+      if (!tokens.length) {
+        if (args.json) return { text: JSON.stringify({ updatedAt: store.updatedAt || '', rows }, null, 2) };
+        const out = [];
+        let lastKind = '';
+        for (const r of rows) {
+          if (r.kind !== lastKind) {
+            if (out.length) out.push('');
+            out.push('【' + (r.kind === 'global' ? '全局' : r.kind === 'project' ? '项目' : r.kind === 'misc' ? '杂项' : r.kind) + '】');
+            lastKind = r.kind;
+          }
+          out.push(formatRow(r));
+        }
+        return { text: out.join(NL) };
+      }
+      const out = [];
+      const hits = [];
+      for (const t of tokens) {
+        const r = resolveOffice(store, t);
+        if (!r.ok) { out.push(t + '  — ' + r.reason); continue; }
+        if (r.vacant) { out.push(t + '  — 类别「' + r.key + '」当前空缺（无人在任）'); continue; }
+        const row = { key: r.key, kind: r.lineage.kind, project: r.lineage.project, task: r.lineage.task, current: r.lineage.current };
+        out.push(formatRow(row, t));
+        hits.push({ askedAs: t, via: r.via, key: r.key, kind: r.lineage.kind, name: r.lineage.current.name, sessionId: r.lineage.current.sessionId });
+      }
+      if (args.json) return { text: JSON.stringify({ updatedAt: store.updatedAt || '', hits, lines: out }, null, 2) };
+      return { text: out.join(NL) };
+    },
+  };
+}

package/src/tools/ho_profile.mjs

@@ -3,15 +3,23 @@ import { textOutput } from '../lib/output.mjs';
 import { nameOf } from '../lib/names.mjs';
 import { NL } from '../lib/text.mjs';
 import { presets, readProfile, writeProfile, validateProfile, profilePathFor, PROFILE_KINDS } from '../lib/profile.mjs';
+import { assertProjectName, assertTaskName } from '../lib/role.mjs';
 import { stampTz } from '../lib/brief.mjs';
 
 function targetOf(env, info, args, exec) {
   if (info && (info.role === 'project' || info.role === 'misc')) {
+    const own = info.role === 'project' ? String(info.project || '') : String(info.task || '');
+    const given = String(args.project || args.task || '').trim();
+    // 项目会话只处理自己的骨架；传了别的名字就明确报错，而不是静默忽略入参（实测踩过）。
+    if (given && given !== own) {
+      throw new Error('本会话是' + (info.role === 'project' ? '项目「' + own + '」' : '杂项「' + own + '」')
+        + '，只能读写自己的骨架；要看「' + given + '」请由全局会话执行 ho_profile。');
+    }
     return { role: info.role, project: info.project || '', task: info.task || '', self: true };
   }
   if (info && info.role === 'global') {
-    if (args.project) return { role: 'project', project: String(args.project), task: '', self: false };
-    if (args.task) return { role: 'misc', project: '', task: String(args.task), self: false };
+    if (args.project) return { role: 'project', project: assertProjectName(String(args.project)), task: '', self: false };
+    if (args.task) return { role: 'misc', project: '', task: assertTaskName(String(args.task)), self: false };
     throw new Error('全局会话使用 ho_profile 时须给 project 或 task');
   }
   throw new Error('普通会话不参与骨架注册');

package/src/tools/ho_sessions.mjs

@@ -67,6 +67,7 @@ export function pmSessionsTool(env) {
       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 + '）' },
@@ -76,8 +77,8 @@ export function pmSessionsTool(env) {
         task: { type: 'string', description: '任务名（role=misc 必填）' },
         notify: { type: 'boolean', description: 'role 时投整理指令（默认 true，会唤醒它一轮）' },
         title: { type: 'string', description: 'new 的标题；prompt 用于推断代际' },
-        workspace: { type: 'string', description: 'new、place 的工作区 id、标题、路径' },
-        cwd: { type: 'string', description: 'new 的工作目录（与 workspace 二选一）' },
+        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 允许停掉在跑的' },
         kind: { type: 'string', enum: ['global', 'project', 'misc', 'migration'], description: 'prompt 的类型；new 时用作角色候选' },

package/src/tools/ho_snapshot.mjs

@@ -5,6 +5,7 @@ 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'];
@@ -50,7 +51,7 @@ export function pmSnapshotTool(env) {
     output: textOutput(),
     async execute(args, exec) {
       const ws = env.resolveWs(exec);
-      const project = typeof args.project === 'string' ? args.project.trim() : '';
+      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);

package/src/tools/ho_succeed.mjs

@@ -0,0 +1,24 @@
+/** ho_succeed —— 换任自服务：在任会话在用户授权后，自行校验交接、建接任会话并登记在任。 */
+import { textOutput } from '../lib/output.mjs';
+import { nameOf } from '../lib/names.mjs';
+import { runSuccession } from '../lib/succession.mjs';
+
+export function pmSucceedTool(env) {
+  return {
+    name: nameOf('succeed'),
+    description:
+      '换任：校验本会话交接，建接任会话并登记在任；须用户先授权（/allow-succeed）。',
+    parameters: {
+      type: 'object',
+      additionalProperties: false,
+      properties: {
+        note: { type: 'string', description: '写进在任登记的备注（可选）' },
+        force: { type: 'boolean', description: '本会话水位未到线时仍换任（默认不传）' },
+      },
+    },
+    output: textOutput(),
+    async execute(args, exec) {
+      return { text: await runSuccession(env, exec, { note: args && args.note, force: args && args.force === true }) };
+    },
+  };
+}

package/src/tools/ho_workspace.mjs

@@ -47,8 +47,9 @@ export function pmWorkspaceTool(env) {
           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',
         },
-        path: { type: 'string', description: 'create 用：已存在的绝对目录（不会替你先建）' },
+        path: { type: 'string', description: 'create 用：目录绝对路径；默认要求已存在，ensure=true 时自动创建' },
         title: { type: 'string', description: 'create 用：显示标题' },
+        ensure: { type: 'boolean', description: 'create 用：目录不存在时自动创建（默认 false，不替你建目录）' },
         workspace: { type: 'string', description: 'delete 用：工作区 id、标题、路径' },
         to: { type: 'string', description: 'move 用：新根绝对路径（父目录可自动建）' },
         confirm: { type: 'boolean', description: 'move-cleanup 用：true 才真的删旧副本' },
@@ -82,10 +83,13 @@ export function pmWorkspaceTool(env) {
       if (action === 'create') {
         if (!reg || typeof reg.create !== 'function') throw new Error('workspaceRegistry.create 不可用');
         const p = String(args.path || '').trim();
-        if (!p) throw new Error('create 需要 path（已存在的绝对目录）');
+        if (!p) throw new Error('create 需要 path（目录绝对路径）');
         let st = null;
         try { st = fs.statSync(p); } catch { st = null; }
-        if (!st || !st.isDirectory()) throw new Error('目录不存在或不是目录：' + p + '（本工具不替你建目录，先手工建好再注册）');
+        if ((!st || !st.isDirectory()) && args.ensure === true) {
+          try { fs.mkdirSync(p, { recursive: true }); st = fs.statSync(p); } catch (e) { throw new Error('建目录失败：' + p + '（' + String(e && e.message ? e.message : e) + '）'); }
+        }
+        if (!st || !st.isDirectory()) throw new Error('目录不存在或不是目录：' + p + '（默认不替你建目录；要建请传 ensure=true，或先手工建好）');
         const title = String(args.title || '').trim() || p.split(/[\\/]/).filter(Boolean).pop() || p;
         let w = null;
         try { w = await reg.create(p, title); } catch (e) { throw new Error('建工作区失败：' + String(e && e.message ? e.message : e)); }