@mingmaple/dsh-handover 0.9.12 → 0.9.14

package/src/selftest.mjs

@@ -10,6 +10,8 @@ import { pmGateTool } from './tools/ho_gate.mjs';
 import { pmSessionsTool } from './tools/ho_sessions.mjs';
 import { pmPhaseTool } from './tools/ho_phase.mjs';
 import { pmCharterTool } from './tools/ho_charter.mjs';
+import { pmOfficeTool } from './tools/ho_office.mjs';
+import { pmSucceedTool } from './tools/ho_succeed.mjs';
 import path from 'node:path';
 
 const argv = process.argv.slice(2);
@@ -54,6 +56,13 @@ const env = {
   lockState: () => 'unknown',
 };
 
+/** 换任只读用例：只验授权判据，不带用户授权时应当返回「没有授权」，而不是抛异常。 */
+const envSucceed = Object.assign({}, env, {
+  selfId: () => 'session-selftest-succeed',
+  roleOf: () => ({ role: 'project', project: 'Demo', task: '', source: 'selftest' }),
+  handoverFor: () => ({ path: path.join(ws, '_Project_Meta', 'Demo', 'Handover.md'), reason: '' }),
+});
+
 const exec = null;
 const cases = [
   { t: pmBriefTool(env), a: {}, flag: "brief" },
@@ -61,6 +70,8 @@ const cases = [
   { t: pmSessionsTool(env), a: {}, flag: "sessions" },
   { t: pmPhaseTool(env), a: {}, flag: "phase" },
   { t: pmCharterTool(env), a: { doc: "charter", section: "8.1.1.4", maxLines: 30 }, flag: "charter" },
+  { t: pmOfficeTool(env), a: { query: "全局" }, flag: "office" },
+  { t: pmSucceedTool(envSucceed), a: {}, flag: "succeed", want: /没有授权/ },
 ];
 
 let failed = 0;
@@ -71,6 +82,10 @@ for (const c of cases) {
   try {
     const out = await c.t.execute(c.a, exec);
     console.log(out.text);
+    if (c.want && !c.want.test(String(out && out.text))) {
+      failed++;
+      console.log("FAILED: 输出不符合预期 " + c.want);
+    }
   } catch (e) {
     failed++;
     console.log("FAILED: " + (e && e.message ? e.message : String(e)));

package/src/templates/Charter.skeleton.md

@@ -1,6 +1,6 @@
 # Workspace Charter（骨架）
 
-> 本文件由 dsh-handover 首次安装向导生成，只含跑起来所需的最小内容；按需继续写。
+> 本文件由 dsh-handover 首次安装向导生成，只含可运行所需的最小内容；按需继续写。
 > 铁律：§8.1.1.4 那 24 行是唯一正文来源，任何项目库的 RULES.md 都要逐字复制它（外加一行「上下文水位自查」）。改这里就必须同步改所有库。
 
 ## 8. 工程约束

package/src/templates/Prompt_Templates.md

@@ -7,7 +7,7 @@
 ```text
 你是<角色>，由全局管理对话创建并交接。
 第一条要读的：<绝对路径>（读毕再开始作业）。| 项目→ _Project_Meta/<项目名>/Handover.md；全局→ records/Global_Handover.md；杂项首任→ rules/Misc_Task_Standard.md
-你是平级会话：跑完一轮不会有任何自动通知。会话之间可直接 `peer_send`，不必经全局转述；**默认沉默**：只在三种时机各发一条给现任全局——≥32% 且已写交接、需用户决定、发现全局口径有误；**任务完成不向全局报告**（任务属本会话内部事务）；**不得每轮回执，亦不得发送「收到」「已完成」一类确认**（全局不看回执，只看文件末态）。
+不得每轮回执，也不发送「收到」「已完成」一类确认；全局只看文件末态。
 你的 session id：<本会话 id>。确需向全局发消息时，以 `peer_send` 发至 <全局 id>。| 不得据 peer_list 推测 id
 水位：≥32% 应先写毕交接、再通知全局，并提醒用户换会话；>35% 不得新开任务。
 边界：只读写 <范围>。删除或覆盖前须先留快照，**删除须经用户确认**。对用户可见一律中文（含工具 description 字段）。
@@ -37,7 +37,7 @@
 库根：Projects/<项目名>/<项目名>库/ ；元数据：_Project_Meta/<项目名>/ ；快照：_Temp/<项目名>/Snapshots/ ；版本冻结：_Archives/<项目名>/Backups/
 开始作业前应先读：_Project_Meta/<项目名>/Handover.md → 库根 SKILL.md →（修改文档时）_Control_Center/rules/ 下对应规范。
 两件必查：库内 RULES.md 里必须有「运行期省 token」与「上下文水位自查」两条；缺者应照 Workspace_Charter.md 原文补上（唯一来源，不得自行改动数字）。
-换任由全局执行，不由你执行：进入预警区后只写交接、通知全局并提醒用户，**不得自行调用 peer_new**。
+换任自办，规则见插件注入的提示段；**不得自行调用 peer_new**，也不向全局请求换任。
 ```
 
 ### 2.3 杂项（只在首任时由全局发，此后自理）
@@ -47,25 +47,17 @@
 你是杂项任务会话，标题「<任务短名>」，不编号。
 任务目录：_Misc/tasks/<任务短名>/（产物、脚本、日志都放这里）
 三件文件：Project_Overview.md（是什么/边界/验收判据）· Changelog.md（环境事实/变更/回滚，只追加）· Handover.md（在途）
-换任自己办：peer_new({ workspace: 'Misc', title: '<自拟名称>' }) → 查重 → 新 id 写进交接 §0 → 不通知全局。
+换任自办（规则见插件注入的提示段）：接任者名字与会话 id 由插件写进登记表并在旧交接末尾追加登记，不通知全局。
 本任务：<任务正文>| 用户原话照抄，不改写、不缩范围、不替用户补验收判据
 ```
 
-## 3 消息二 · 项目 → 全局：交接请求
+## 3 消息二 · 换任（已停用）
 
-```text
-【交接请求】<项目名>｜<本会话 id>｜水位 <xx>%
-已写完 _Project_Meta/<项目名>/Handover.md（<行数> 行，已归档旧版到 _Archives/<项目名>/Handover/）。
-在途：<有/无>；一句话：<现在卡在哪>。
-请建接任会话。
-```
+> 换任由在任会话调用 `ho_succeed` 完成：用户授权、插件体检交接、分配编号、建立接任会话并投递启动提示。不再有「项目 → 全局：交接请求」的消息，也不再需要全局代办。本节保留编号，避免后续节号变动。
 
-## 4 消息三 · 全局 → 项目：已交接
+## 4 消息三 · 全局代建（仅备选）
 
-```text
-【已交接】<项目名>｜接任已建：<项目名><N>｜session id <新 id>
-你的交接已归档，可以停止操作：不得新开任务，不得修改文件。
-```
+> 仅在自动换任失败、且用户要求时使用：全局用 `ho_sessions(action="new")` 建接任会话，标题按 `<项目名><N>`（N＝本机下一个序号），启动提示必须带新会话自己的 session id、现任全局 session id 与旧会话 `Handover.md` 的绝对路径。建完请用户在旧会话里确认停止。
 
 ## 5 消息四 · 全局 → 项目：新任务派发
 
@@ -76,7 +68,7 @@
 约束：<本次不许碰的东西；无则删本行>
 ```
 
-> 派活前先 `peer_list`：已有会话且 <32% **必须复用它**，不许新建；≥32% 先让其写完交接再新建。
+> 派活前先查在任（`ho_office` 空参数，零成本）；复用准则固定写在插件注入的提示段，本节不重复。
 
 ## 6 消息五 · 迁移通知（打包前刷交接）
 
@@ -91,6 +83,6 @@
 
 ## 7 发送纪律
 
-> 时机与纪律（不寒暄、一次一件事、并发 ≤3、默认沉默、未被要求勿唤醒、不转述）见 `rules/Workspace_Charter.md` §7.2.4 第 9 条，本节不重复。
+> 汇报时机见插件注入的提示段；格式与频率纪律（不寒暄、一次一件事、并发 ≤3、未被要求勿唤醒、不转述）见 `rules/Workspace_Charter.md` §7.2.4 第 9 条，本节不重复。
 >
 > 本节只留一条**模板自身**的要求：发送前删掉所有 `|` 之后的提示与 `<>` 占位，只留实值。

package/src/templates/Runtime_Manual.md

@@ -2,22 +2,22 @@
 
 > 这是**按需取回**的全文：系统提示里只留短段与指针，需要细节时用 `ho_charter(doc="runtime")` 取本文。
 >
-> **内置即默认**：本文、Charter 骨架、交接、台账骨架、提示词模板、四份规则文档都随插件发布（`dist/templates/`）。工作区里的同名文件只是「本地化覆盖」；删掉就自动回到内置，功能不降级。`ho_init` 是把默认口径落盘方便修改，**不是使用前提**。
+> **内置即默认**：本文、Charter 骨架、交接、台账骨架、提示词模板、四份规则文档都随插件发布（`dist/templates/`）。工作区里的同名文件只是「本地化覆盖」；删掉就自动回到内置，功能不降级。`ho_init` 是把默认口径写入磁盘，便于修改，**不是使用前提**。
 > 口径冲突时以工作区的 `_Control_Center/rules/` 为准；本文只讲「插件怎么用、角色怎么分」。
 
 ## 1. 角色四档
 
 | 角色 | 判定顺序 | 交接文件 | 可见工具 |
 |---|---|---|---|
-| 全局 | 角色表 → 标题含「全局」 → 全局工作区 | `_Control_Center/records/Global_Handover.md` | 22 个（全部） |
-| 项目 | 角色表（带项目名）→ cwd 在 `Projects/<名>/` → 首条提示含 `Projects/<名>/` | `_Project_Meta/<项目>/Handover.md` | 9 个 |
-| 杂项 | 角色表（带任务名）→ cwd 在 `_Misc/tasks/<任务>/` | `_Misc/tasks/<任务>/Handover.md` | 9 个 |
+| 全局 | 角色表 → 标题含「全局」 → 全局工作区 | `_Control_Center/records/Global_Handover.md` | 24 个（全部） |
+| 项目 | 角色表（带项目名）→ cwd 在 `Projects/<名>/` → 首条提示含 `Projects/<名>/` | `_Project_Meta/<项目>/Handover.md` | 11 个 |
+| 杂项 | 角色表（带任务名）→ cwd 在 `_Misc/tasks/<任务>/` | `_Misc/tasks/<任务>/Handover.md` | 11 个 |
 | 普通 | 子会话，或都不中 | 无（不参与交接） | 0 个（不注入提示段） |
 
 角色表在 `~/.dsh/storages/dsh-handover.roles.json`，是**本机状态**，不进仓库、不进迁移包。子会话默认普通；需要时由全局在角色表里指定。
 设定入口：设置 → dsh-handover →「会话角色」；或对全局说「把 Demo1 设成项目角色」，它用 `ho_sessions(action="role")` 办。
 
-## 2. 工具清单（22 个）
+## 2. 工具清单（24 个）
 
 ### 只读
 - `ho_brief` —— 起始与收束的单条命令：水位、闸门、会话清点、阶段建议。
@@ -28,6 +28,7 @@
 - `ho_drift` —— 交接漂移：Δ＝当前轮−交接轮，>3 需刷新。
 - `ho_diag` —— 插件自检：服务、调度器、压缩计数、工作区、角色判定。
 - `ho_tokens` —— 会话 token 体检：轮数、步数、每步 token、最贵单条返回。
+- `ho_office` —— 查在任：输入「全局」「全局3」「项目名」等，返回现任会话的名字与会话 id；多个名字空格分隔，留空列出全部。
 - `peer_list` / `peer_status` / `peer_peek` —— 平级会话清点与近期对话（peek 会花本会话 token）。
 
 ### 写
@@ -39,6 +40,7 @@
 - `ho_workspace` —— 工作区 list、create、delete（删除只删注册）与换盘动作。
 - `ho_init` —— 首次安装：在指定目录下建整套全局文件体系，可顺带注册工作区。
 - `ho_profile` —— 项目或杂项的骨架注册：由所属会话通读自己的库后写入并校验。
+- `ho_succeed` —— 换任：用户授权后校验交接、按记录分配编号、建立接任会话、登记在任并投递启动提示词。
 - `peer_send` / `peer_new` / `peer_rename` —— 投递消息、建平级会话、只改标题。
 
 ### ho_sessions 的 action
@@ -57,9 +59,10 @@
 
 - 32% 提醒、35% 交接线、85% 硬顶；同一会话最多压缩 3 次（共 4 段使用）。数值来自 `config.mjs`，提示段与设置页由 `lib/facts.mjs` 统一渲染。
 - 到线流程：`ho_handover` 写交接（体检不通过就拒绝压缩）→ `ho_checkpoint` 登记（`resume=continue|wait`）→ 轮末自动压缩 → 继续时投续跑消息；收尾时不唤醒，等用户派新任务。
-- 第 4 段到线：写交接 ＋ 全局用 `ho_sessions(action="new")` 建下一任；项目会话自己**不要**建会话（换任由全局做）。
+- 第 4 段到线或压缩额度用尽：由在任会话自己换任——写交接 → 请用户在聊天框敲 `/allow-succeed` 授权 → 调 `ho_succeed`（校验交接、分配编号、建立接任会话、登记在任、投递提示词）。全局仍可用 `ho_sessions(action="new")` 手动建立会话，作为自动流程失败时的备选方式。
 - 关键步骤不要压：`ho_checkpoint` 传 `at_risk=true`，它只提醒不压；硬顶 85% 除外。
 - 压缩不可逆：历史会被摘要替换，所以「先把交接写合格」是硬前提。
+- 在任登记表由插件维护：`_Control_Center/records/Office.json` 记每一类会话的现任与会话 id；查现任用 `ho_office`，不起会话时用 `node scripts/office.mjs 全局 全局3`。
 
 ## 4. 交接文件的结构要求
 
@@ -124,14 +127,14 @@
 
 ### 12.1 分层（谁在每轮付费）
 
-| 层 | 内容 | 何时进入上下文 | 体积上限（加权 token） |
+| 层 | 内容 | 何时进入上下文 | 实测参考（加权 token） |
 |---|---|---|---|
-| L0 常驻 | 角色段（全局五节；项目、杂项九行） | **每一轮** | 全局 320；项目 300；长路径与迁移提示档 360、340 |
+| L0 常驻 | 角色段（全局五节；项目、杂项各节） | **每一轮** | 全局约 385；项目与杂项约 370；长路径与迁移提示档约 435、419（参考值，不设上限） |
 | L0 用户内容 | 全局前置提示词（用户开关，默认关闭） | 开启且非空时每轮 | 由用户自管，不计入本插件预算 |
 | L1 手册 | 本文件 | 按需取回，可**按节**取 | 不设上限（不进每轮） |
 | L2 规则文档 | 工作区 `_Control_Center/rules/` | 按需 | 由工作区自管 |
 
-> 加权 token 的算法：CJK 与全角标点每字符 1 token，其余每 4 字符 1 token。上限集中在 `lib/facts.mjs` 的 `TOKEN_BUDGET`，冒烟断言直接引用该表。工具描述单条上限 70 token。
+> 加权 token 的算法：CJK 与全角标点每字符 1 token，其余每 4 字符 1 token。实测常量在 `lib/facts.mjs` 的 `TOKEN_BUDGET`，冒烟只打印实测值，**不设上限**，也不用于拒绝或截断。
 >
 > L0 是成本主体：它按轮次乘算，所以只放「每轮都要用到的判定」。任何「一个会话生命周期里只用几次」的流程，一律以指针落到 L1。
 

package/src/templates/rules/Handover_Rules.md

@@ -15,10 +15,10 @@
 
 ## 2. 什么时候写
 
-- 水位 **32%**：开始收口，别开新活。
+- 水位 **32%**：开始收尾，不要开新任务。
 - 水位 **35%**：必须写完交接 → `ho_checkpoint` 登记 → 轮末自动压缩 → 续跑。
 - 水位 **85%**：硬顶，不压也得压。
-- 同一会话最多压 3 次；第 4 段写交接并通知全局换任（**项目会话不要自己建会话**）。
+- 同一会话最多压 3 次；第 4 段写交接，用户授权后由在任会话调用 `ho_succeed` 换任（**不得自行新建会话**）。
 
 ## 3. 必须写清（缺一项就会在换任时丢信息）
 

package/src/templates/rules/Misc_Task_Standard.md

@@ -2,7 +2,7 @@
 
 ## 1. 什么算杂项
 
-一次性或短期的活：不建项目库、不进 `_Project_Meta/Registry.md`。落点 `_Misc/tasks/<任务短名>/`。
+一次性或短期任务：不建项目库、不进 `_Project_Meta/Registry.md`。落点 `_Misc/tasks/<任务短名>/`。
 
 ## 2. 目录约定
 
@@ -14,8 +14,8 @@
 
 ## 3. 边界
 
-- 只写上面三处；`_Control_Center`、`Projects`、其他任务目录都不碰。
-- 接任：杂项可以自建 Misc 换任（`ho_sessions(action="new")` 指向 Misc 工作区），项目会话不许。
+- 只写上面三处；`_Control_Center`、`Projects`、其他任务目录都不得写入。
+- 接任：杂项须用户授权（`/allow-succeed` 或设置页），再由本会话调用 `ho_succeed`，由插件按登记表建立接任会话；项目会话不得自行新建会话。
 - 交接与水位协议同项目（32% 提醒 / 35% 交接线 / 85% 硬顶）。
 
 ## 4. 升级为项目

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