@mingmaple/dsh-handover 0.9.13 → 0.9.14

package/README.md

@@ -146,7 +146,7 @@ npm run test:docs                     # 文档校验：工具名、旧数、链
 
 ## 版本
 
-当前版本 0.9.13，首次公开版本为 0.9.6。内部版本史不随仓库发布。
+当前版本 0.9.14，首次公开版本为 0.9.6。内部版本史不随仓库发布。
 
 支持的内核为 0.2.1-rc.2 至 0.3.0（不含 0.3.0 及其候选版），见 `package.json` 的 `engines.dsh`；0.2.2-rc.1 上的工具装配、角色裁剪与压缩调度已实测通过。
 

package/docs/releases/0.9.14.md

@@ -0,0 +1,18 @@
+# 0.9.14
+
+修三处与新建会话、换任相关的路径与登记问题，均在真机演练中复现后修复。
+
+## 修复
+
+- 新建杂项会话：启动提示词里的交接路径此前按调用者角色推算，杂项被当成全局，指向全局交接文件。现按新会话自身的角色取路径：杂项读 `_Misc/tasks/<任务>/Handover.md`，项目读 `_Project_Meta/<项目>/Handover.md`；杂项没有任务交接时退回杂项任务标准。强制交接路径的配置项只对全局角色生效。
+- 在任登记表的工作区一栏改记会话实际所在的工作区，不再记调用者所在的工作区根。
+- 杂项换任：接任会话此前落在工作区根，现落回本会话所在的注册工作区。做法是按会话工作目录反查工作区注册表，反查不到时才退回工作区根。
+- 换任启动提示词里的「全局 id」改为现任全局会话。此前填入的是发起换任的前任会话，项目与杂项的接任者因此被指向已经退休的会话。
+
+## 测试
+
+冒烟新增三条回归断言：新建杂项会话的启动提示读本任务交接、杂项接任者落回本会话所在的工作区、接任提示的全局 id 为现任全局。
+
+## 升级
+
+先移除旧版本再安装；或替换文件后在插件列表停用再启用。已存在的在任登记表无需改动，工作区一栏在下次登记时自然更新。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mingmaple/dsh-handover",
-  "version": "0.9.13",
+  "version": "0.9.14",
   "type": "module",
   "description": "DeepSeek Harness 插件：把「全局」的交接、闸门、会话清点与上下文压缩续跑流程做成工具（dsh-handover）",
   "license": "MIT",

package/scripts/blank-smoke.mjs

@@ -1019,6 +1019,71 @@ try {
 } catch (e) { newErr = String(e && e.message ? e.message : e); }
 ok(/工作区/.test(newErr) && /已注册的工作区/.test(newErr), '新建会话缺工作区时应报错并列出可选工作区', newErr.slice(0, 160));
 
+// 回归锁（0.9.14）：① 新建杂项会话的启动提示读本任务交接，不退回全局交接；
+// ② 杂项换任的接任者落回本会话所在的注册工作区；③ 接任提示里的「全局 id」是现任全局，不是退休前任。
+{
+  const { registerHolder } = await import(DIST('lib/office.mjs'));
+  const storages = path.join(BLANK, '.dsh', 'storages');
+  fs.mkdirSync(storages, { recursive: true });
+  const miscWs = path.join(WS, '_Misc');
+  fs.writeFileSync(path.join(storages, 'workspace.json'), JSON.stringify({
+    tables: { workspaces: {
+      'ws-glob': { id: 'ws-glob', title: '全局', path: WS },
+      'ws-misc': { id: 'ws-misc', title: '_Misc', path: miscWs },
+    } },
+  }), 'utf8');
+  const seen = { creates: [], prompts: [] };
+  ctx.sessionController.create = async (a) => { seen.creates.push(a || {}); return { sessionId: 'session-made-' + seen.creates.length }; };
+  ctx.sessionController.rename = async () => { };
+  ctx.sessionController.prompt = async (a) => {
+    const part = a && Array.isArray(a.content) ? a.content[0] : null;
+    seen.prompts.push(String(part && part.text ? part.text : ''));
+    return { accepted: true };
+  };
+  const makerExec2 = { name: 'ho_sessions', arguments: {}, agent: { session: { header: { id: 'session-maker2', cwd: WS } } } };
+  const sessT = reg.tools.find((t) => t.name === 'ho_sessions');
+  {
+    let createdOut = '';
+    try {
+      const r = await sessT.execute({ action: 'new', confirm: true, title: '杂项2', kind: 'misc', role: 'misc', task: '抢名额', workspace: 'ws-misc' }, makerExec2);
+      createdOut = String((r && r.text) || '');
+    } catch (e) { createdOut = 'ERR ' + String(e && e.message ? e.message : e); }
+    const p = seen.prompts[seen.prompts.length - 1] || '';
+    ok(/已建会话/.test(createdOut), '新建杂项会话应成功', createdOut.slice(0, 200));
+    ok(/_Misc[\\/]tasks[\\/]抢名额[\\/]Handover\.md/.test(p), '新建杂项会话的启动提示应读本任务交接', p.slice(0, 200));
+    ok(p.indexOf('Global_Handover') === -1, '新建杂项会话的启动提示不得指向全局交接', p.slice(0, 200));
+  }
+  {
+    const { runSuccession } = await import(DIST('lib/succession.mjs'));
+    const { grantConsent } = await import(DIST('lib/consent.mjs'));
+    const miscHandover = path.join(miscWs, 'tasks', '抢名额', 'Handover.md');
+    fs.mkdirSync(path.dirname(miscHandover), { recursive: true });
+    fs.writeFileSync(miscHandover, '# 抢名额交接' + '\n\n## 下一步\n- 等用户指派下一步\n', 'utf8');
+    registerHolder(WS, { kind: 'global', name: '全局1', sessionId: 'session-global-cur', workspace: WS });
+    registerHolder(WS, { kind: 'misc', task: '抢名额', name: '杂项1', sessionId: 'session-misc-old', workspace: miscWs });
+    grantConsent('session-misc-old', 'blank-smoke', 'succeed');
+    const succOut = await runSuccession({
+      cfg: resolveConfig({ workspaceRoot: WS }),
+      roleOf: () => ({ role: 'misc', task: '抢名额', project: '' }),
+      selfId: () => 'session-misc-old',
+      selfCwd: () => miscWs,
+      handoverFor: () => ({ path: miscHandover, reason: '' }),
+      resolveWs: () => WS,
+      selfPct: () => 40,
+      registry: () => ({ list: () => [] }),
+      controller: () => ctx.sessionController,
+      writeRole: () => { },
+    }, null, {});
+    ok(/换任完成/.test(succOut), '杂项换任应能走通（授权、体检、建会话、登记、投递）', succOut.split('\n').join(' ').slice(0, 240));
+    const madeArgs = seen.creates[seen.creates.length - 1] || {};
+    ok(madeArgs.workspaceId === 'ws-misc', '杂项接任者应落回本会话所在的工作区', JSON.stringify(madeArgs));
+    const p = seen.prompts[seen.prompts.length - 1] || '';
+    ok(new RegExp('.{0,1}抢名额[\\\\/]Handover\\.md').test(p), '接任提示末尾应带本任务交接路径', p.slice(-320));
+    ok(p.indexOf('session-global-cur') !== -1, '接任提示的「全局 id」应是现任全局', p.slice(-320));
+    ok(p.indexOf('session-misc-old') === -1, '接任提示不得把退休前任当全局', p.slice(-320));
+  }
+}
+
 fs.rmSync(BLANK, { recursive: true, force: true });
 console.log('');
 if (fails.length) {

package/src/lib/session-ops.mjs

@@ -94,6 +94,28 @@ export function resolveWorkspaceFor(env, exec, kind, project, task, opts) {
     + '全局会话落在标题含「全局」的工作区；项目会话同时传 project 与该项目的工作区；杂项会话传该项目外的独立工作区。');
 }
 
+/**
+ * 某个目录是不是已注册工作区的根：是则返回 workspaceId，否则返回空串（不抛错）。
+ * 换任时用来让接任者落回本会话所在的那个工作区，而不是工作区根。
+ */
+export function workspaceIdOfPath(env, p) {
+  const want = normPath(p);
+  if (!want || want === '-') return '';
+  const hit = listWorkspaces(env).find((r) => {
+    const rp = normPath(String(r.path || ''));
+    return rp && rp !== '-' && rp === want;
+  });
+  return hit ? String(hit.id || '') : '';
+}
+
+/** workspaceId 对应的根路径；查不到返回空串（登记表的工作区一栏用它写成实际落点）。 */
+export function workspacePathOf(env, id) {
+  const key = String(id || '');
+  if (!key) return '';
+  const hit = listWorkspaces(env).find((r) => String(r.id || '') === key);
+  return hit && hit.path ? String(hit.path) : '';
+}
+
 /** 已注册工作区清单（插件服务优先，退化读 workspace.json）：新建会话时用来列出可选项。 */
 function listWorkspaces(env) {
   try {
@@ -197,16 +219,23 @@ export async function sessionNew(env, args, exec) {
   // 建会话即登记在任：全局手工建/换会话与自服务换任共用一张登记表，不让注册表漏记或与实况分叉。
   try {
     if (officeKind) {
-      const reg = registerHolder(ws, { kind: officeKind, project, task, name: title, sessionId, workspace: ws });
+      // 工作区一栏写**实际落点**（用户指定的那个工作区），不是调用者自己所在的工作区根。
+      const reg = registerHolder(ws, {
+        kind: officeKind, project, task, name: title, sessionId,
+        workspace: workspacePathOf(env, workspaceId) || ws,
+      });
       out.push('在任登记：' + reg.key + ' → ' + title + (reg.previous ? '（原 ' + reg.previous.name + ' 进历史）' : ''));
     }
   } catch (e) {
     out.push('在任登记失败：' + String(e && e.message ? e.message : e) + '（不影响会话本身）');
   }
   const meId = env.selfId(exec) || '（未知）';
-  // 交接路径按**接任者自身的角色**取用：项目换任读取项目交接，不再退回全局交接。
-  const hp = handoverPathFor(ws, finalRole === 'project' && project ? { role: 'project', project } : { role: 'global' });
-  const handover = env.cfg.handoverPath || (hp.path || '');
+  // 交接路径按**新会话自身的角色**取用：项目读项目交接、杂项读任务交接，都不退回全局交接。
+  // cfg.handoverPath 是「强制全局交接路径」的演练开关，只对全局角色生效。
+  const hp = handoverPathFor(ws, finalRole === 'project' && project ? { role: 'project', project }
+    : finalRole === 'misc' && task ? { role: 'misc', task } : { role: 'global' });
+  const handover = (finalRole === 'global' ? env.cfg.handoverPath : '') || hp.path
+    || (finalRole === 'misc' ? path.join(ws, '_Control_Center', 'rules', 'Misc_Task_Standard.md') : '');
   const text = args.message || [
     '先读交接：' + handover + '。',
     '读毕先向用户报告，不得自行开展作业：一、当前停在哪一步；二、交接列有哪些待办；三、建议先做哪一条。待用户指派后再动手。交接无待办时如实说明，不得编造任务。',

package/src/lib/succession.mjs

@@ -12,7 +12,7 @@ import { lineageKeyOf, loadOffice, nextName, registerHolder, stampNow } from './
 import { checkConsent, consumedConsent } from './consent.mjs';
 import { newSessionIn } from './session-create.mjs';
 import { sendPrompt } from './prompt.mjs';
-import { resolveWorkspaceFor, promptFor } from './session-ops.mjs';
+import { resolveWorkspaceFor, promptFor, workspaceIdOfPath, workspacePathOf } from './session-ops.mjs';
 import { watermark } from './facts.mjs';
 
 /** 交接里不得残留的占位符。 */
@@ -22,6 +22,14 @@ function msgOf(e) {
   return String(e && e.message ? e.message : e);
 }
 
+/** 现任全局会话 id（登记表是唯一事实源）；没有记录或读不到时返回空串。 */
+function currentGlobalId(ws) {
+  try {
+    const lin = loadOffice(ws).lineages['全局'];
+    return lin && lin.current && lin.current.sessionId ? String(lin.current.sessionId) : '';
+  } catch { return ''; }
+}
+
 /**
  * 找接任指令节：含「## 下一步」或「## 2.」这类标题；没有标题时接受 §2 的写法。
  * 判据与 ho_gate 的交接体检一致：这一节至少要有一个条目（列表、表格或编号行）。
@@ -165,18 +173,26 @@ export async function runSuccession(env, exec, opts) {
   // 5. 分配编号：登记表历史最大号加一，不采用会话自述。
   const name = nextName(store, key);
 
-  // 6. 确定工作区：与 ho_sessions(action="new") 同一套解析；杂项落到本会话所在工作区。
+  // 6. 确定工作区：与 ho_sessions(action="new") 同一套解析。
+  // 杂项接任者落回**本会话所在的注册工作区**（按会话 cwd 反查）；反查不到才退回工作区根。
   let workspaceId = '';
   try {
-    workspaceId = resolveWorkspaceFor(env, exec, kind, project, task, kind === 'misc' ? { workspace: ws } : {});
+    let wsOpt = {};
+    if (kind === 'misc') {
+      const selfCwd = typeof env.selfCwd === 'function' ? String(env.selfCwd(exec) || '') : '';
+      wsOpt = selfCwd && workspaceIdOfPath(env, selfCwd) ? { cwd: selfCwd } : { workspace: ws };
+    }
+    workspaceId = resolveWorkspaceFor(env, exec, kind, project, task, wsOpt);
   } catch (e) {
     return reject(msgOf(e));
   }
 
   // 7. 拼启动提示词：末尾追加交接路径与「先读交接、读毕报到」。
+  // 「全局 id」填**现任全局**：项目与杂项换任时，前任不是全局，不能顶替这个位置。
   let prompt = '';
   try {
-    const base = promptFor(env, { ws, kind, project, task, title: name, sessionId: '', globalSessionId: selfId, extra: '' });
+    const globalId = kind === 'global' ? selfId : (currentGlobalId(ws) || selfId);
+    const base = promptFor(env, { ws, kind, project, task, title: name, sessionId: '', globalSessionId: globalId, extra: '' });
     prompt = base + NL + NL + [
       '接任交接：' + handoverFile,
       '先读这份交接再动手；读毕向用户报告当前停在哪一步、交接列有哪些待办，然后等待用户指派任务。',
@@ -195,7 +211,7 @@ export async function runSuccession(env, exec, opts) {
   // 9. 登记在任：原在任者自动进历史，Registry.md 在役列同步。
   let reg = null;
   try {
-    reg = registerHolder(ws, { kind, project, task, name, sessionId, workspace: ws, note });
+    reg = registerHolder(ws, { kind, project, task, name, sessionId, workspace: workspacePathOf(env, workspaceId) || ws, note });
   } catch (e) {
     return [
       '会话已建 ' + sessionId + '（' + name + '），但登记在任失败：' + msgOf(e),