pi-proactive 0.2.0-beta.2 → 0.2.0-beta.4

package/build/extensions/proactive.js

@@ -27,7 +27,7 @@ import { randomUUID } from "node:crypto";
 import os from "node:os";
 import path from "node:path";
 import { Type } from "typebox";
-import { PROACTIVE_FILE_MODE, chmodQuiet, defaultConfig, ensureDir, hardenProactivePermissions, loadConfig, resolveAgentDir, saveEnabled, } from "../src/config.js";
+import { PROACTIVE_FILE_MODE, chmodQuiet, defaultConfig, ensureDir, hardenProactivePermissions, loadConfig, resolveAgentDir, saveEnabled, ConfigValidationError } from "../src/config.js";
 import { ActivityTracker } from "../src/activity.js";
 import { Guard } from "../src/guard.js";
 import { Trigger } from "../src/trigger.js";
@@ -44,6 +44,8 @@ import { SeenSet } from "../src/dedupe.js";
 import { Mailbox, gcStaleTemporaries } from "../src/mailbox.js";
 import { createEnvelope, nextHop } from "../src/envelope.js";
 import { writeToMailbox } from "../src/outbox.js";
+import { collectSupervisorState, formatSupervisorSummary } from "../src/supervisor-state.js";
+import { formatSupervisorPanel } from "../src/supervisor-tui.js";
 import { deliverCrossProcess, startSocketServer, } from "../src/socket.js";
 import { createScheduledTask, dispatchProactiveCommand, errText, formatHumanGatedNotice, formatIdleDecision, formatScheduleResult, queryPeerDirectory, SUBCOMMANDS, } from "../src/commands.js";
 const TICK_MS = 1000;
@@ -286,11 +288,27 @@ let peerWatch;
 const threadStores = new Map();
 /** peer watch 扫描节流（ms）：注册表读盘不必每秒做。 */
 let lastPeerWatchAt = 0;
+/**
+ * 最近一次**配置校验错误**（拼错的配置项 → 必须让用户看见，不得静默忽略）。
+ *
+ * 通道限制：配置加载发生在宿主给出 `ctx` 之前 → 先存起来，
+ * 由 `session_start`（拿得到 `ctx.ui.notify`）呈现给用户（stderr 亦有一份）。
+ */
+let pendingConfigError;
 function safeConfig() {
     try {
+        pendingConfigError = undefined;
         return loadConfig();
     }
-    catch {
+    catch (err) {
+        if (err instanceof ConfigValidationError) {
+            // M8：未知配置项 → **报错并指名**（键名 + 文件路径 + 建议值）。
+            pendingConfigError = err.message;
+            console.error(err.message);
+        }
+        else {
+            console.error("[proactive] 配置加载失败:", err);
+        }
         return defaultConfig();
     }
 }
@@ -332,7 +350,7 @@ const scheduleTaskParameters = Type.Object({
  * 参数名与命令面一致（`when` / `content` / `id` / `peer` / `scope` / `limit` / `name` / `all` …），
  * `action` 的取值就是命令面的子命令名 → 语义同源、可机检。
  */
-/** 查询域：查对端 / 看历史 / 看状态 / 看任务 / 只读体检 / 看手册。 */
+/** 查询域：查对端 / 看历史 / 看状态 / 看任务 / 只读体检 / 看手册 / 查配置清单。 */
 const proactiveQueryParameters = Type.Object({
     action: Type.Union([
         Type.Literal("peers"),
@@ -341,6 +359,8 @@ const proactiveQueryParameters = Type.Object({
         Type.Literal("tasks"),
         Type.Literal("doctor"),
         Type.Literal("help"),
+        Type.Literal("config"),
+        Type.Literal("supervisor"),
     ], { description: "查询动作（与 /proactive 子命令同名）" }),
     name: Type.Optional(Type.String({ description: "peers：名字子串过滤" })),
     all: Type.Optional(Type.Boolean({ description: "peers：是否包含离线对端" })),
@@ -349,8 +369,15 @@ const proactiveQueryParameters = Type.Object({
     scope: Type.Optional(Type.Union([Type.Literal("peer"), Type.Literal("me")], { description: "history：范围（对端 / 我）" })),
     peer: Type.Optional(Type.String({ description: "history：按对端 agentId 过滤" })),
     limit: Type.Optional(Type.String({ description: "history：条数（1-200 的整数）" })),
-    json: Type.Optional(Type.Boolean({ description: "doctor：输出 JSON" })),
+    json: Type.Optional(Type.Boolean({ description: "doctor / config：输出 JSON" })),
 });
+/**
+ * 进度 / ETA 查询（任务卡 ETA · E3）。
+ *
+ * 与人侧 `/proactive progress` **同源同口径**：同一个分派（`dispatchProactiveCommand`）→
+ * 同一份快照 → 两侧正文逐字一致。
+ */
+const progressQueryParameters = Type.Object({});
 /** 排程域：定时 / 定点 / 周期 / 取消。 */
 const proactiveScheduleParameters = Type.Object({
     action: Type.Union([Type.Literal("in"), Type.Literal("at"), Type.Literal("every"), Type.Literal("cancel")], { description: "排程动作（与 /proactive 子命令同名）" }),
@@ -429,6 +456,10 @@ function commandContext() {
         },
         tellPeer: (args) => runTell(args),
         selfTest: () => runSelfTest(),
+        // 常驻助理后台装完 → 用户可见通道（命令面回执；工具面无此通道时静默落盘）。
+        assistantDone: (text) => {
+            currentCtx?.ui.notify(text);
+        },
     };
 }
 /**
@@ -651,10 +682,22 @@ export default function proactiveExtension(pi) {
     pi.registerTool({
         name: "proactive_query",
         label: "Proactive Query",
-        description: "查询域：查对端（peers）/ 看主动行为历史（history）/ 看状态（status）/ 看任务（tasks）/ 只读体检（doctor）/ 看命令手册（help）。" +
+        description: "查询域：查对端（peers）/ 看主动行为历史（history）/ 看状态（status）/ 看任务（tasks）/ 只读体检（doctor）/ 看命令手册（help）/ 查配置清单（config）/ 看监督面（supervisor）。" +
             "**只读**：不产生任何对外行为。",
         parameters: proactiveQueryParameters,
         async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
+            // 监督面（只读）：**就地呈现**（不走命令面分派 —— 它不产生任何对外行为）。
+            // 数字与 Web 看板**同源**（同一份聚合模块）→ 两个面逐字一致。
+            if (params.action === "supervisor") {
+                const state = readSupervisorState();
+                if (state === undefined) {
+                    return { content: [{ type: "text", text: "proactive: 监督面读取失败（事实源不可读）" }], details: { level: "error" } };
+                }
+                return {
+                    content: [{ type: "text", text: formatSupervisorPanel(state).join("\n") }],
+                    details: { level: "info" },
+                };
+            }
             const parts = [params.action];
             if (params.action === "peers") {
                 if (params.all === true)
@@ -675,12 +718,24 @@ export default function proactiveExtension(pi) {
                 if (params.limit !== undefined && /^\d+$/.test(params.limit))
                     parts.push(params.limit);
             }
-            else if (params.action === "doctor" && params.json === true) {
+            else if ((params.action === "doctor" || params.action === "config") && params.json === true) {
                 parts.push("--json");
             }
             return dispatchTool(parts.join(" "), { action: params.action });
         },
     });
+    pi.registerTool({
+        name: "progress_query",
+        label: "Progress Query",
+        description: "查项目进度与 ETA：返回**区间 + 置信度 + 归因 + 阻塞项**（不给单点数字）。" +
+            "口径唯一（scripts/progress-clock.py），与人侧 `/proactive progress` 同源同口径、逐字一致。" +
+            "**只读**：不产生任何对外行为。",
+        parameters: progressQueryParameters,
+        async execute(_toolCallId, _params, _signal, _onUpdate, _ctx) {
+            // **同源**：与人侧 `/proactive progress` 走同一个分派 → 同一份快照 → 逐字一致。
+            return dispatchTool("progress", { capability: "progress-eta" });
+        },
+    });
     pi.registerTool({
         name: "proactive_schedule",
         label: "Proactive Schedule",
@@ -728,6 +783,19 @@ export default function proactiveExtension(pi) {
             return dispatchTool(parts.join(" "), { action: params.action });
         },
     });
+    /**
+     * 常驻域：会话内开 / 关 / 看常驻助理（7×24）。
+     *
+     * 与人侧 `/proactive assistant …` **共用同一分派**（`dispatchProactiveCommand`）→ 输出逐字一致。
+     */
+    const proactiveAssistantParameters = Type.Object({
+        action: Type.Union([
+            Type.Literal("on"),
+            Type.Literal("off"),
+            Type.Literal("status"),
+            Type.Literal("restart"),
+        ], { description: "常驻助理动作：on 打开 / off 关闭 / status 看状态 / restart 重装（与 /proactive assistant 同名）" }),
+    });
     pi.registerTool({
         name: "proactive_manage",
         label: "Proactive Manage",
@@ -738,6 +806,17 @@ export default function proactiveExtension(pi) {
             return manageTool(params.action, params.state);
         },
     });
+    pi.registerTool({
+        name: "proactive_assistant",
+        label: "Proactive Assistant",
+        description: "常驻助理（7×24）控制：on 打开 / off 关闭 / status 看状态 / restart 重装。" +
+            "与人侧 `/proactive assistant …` 同源同分派 → 逐字一致；安装**不阻塞**（立即回执「正在安装…」，结果用 status 查）。" +
+            "装上默认 enabled=false + 干跑 → 不花钱、不主动打扰。",
+        parameters: proactiveAssistantParameters,
+        async execute(_toolCallId, params, _signal, _onUpdate, _ctx) {
+            return dispatchTool(`assistant ${params.action}`, { action: params.action });
+        },
+    });
     pi.registerCommand("proactive", {
         description: `proactive 主动机制：${SUBCOMMANDS}`,
         handler: async (args, cmdCtx) => {
@@ -751,6 +830,14 @@ export default function proactiveExtension(pi) {
             catch {
                 // ignore: 活动标记失败不得影响命令处理
             }
+            // 监督面（只读）：TUI 面板 / 非交互模式的纯文本；数字与 Web 看板**同源**。
+            //
+            // 为什么在这里就地处理（不走 commands.ts 的分派）：监督面是**只读呈现**，
+            // 不产生任何对外行为、不落盘 → 不需要进入命令面的能力分派表。
+            if (sub === "supervisor") {
+                await showSupervisorPanel(cmdCtx);
+                return;
+            }
             // 命令面子命令 → **能力 id**（与 `docs/project/capability-catalog.json` 逐字一致）。
             //
             // 为什么需要这张表：能力是**语义**，命令/工具只是入口；这张表是「命令面 ↔ 能力目录」的
@@ -785,8 +872,14 @@ export default function proactiveExtension(pi) {
                         return "activity-history";
                     case "doctor":
                         return "health-diagnose";
+                    case "progress":
+                        return "progress-eta";
                     case "help":
                         return "manual-help";
+                    case "config":
+                        return "config-inspect";
+                    case "assistant":
+                        return "assistant-resident";
                     default:
                         return "unknown";
                 }
@@ -1024,6 +1117,7 @@ export default function proactiveExtension(pi) {
             // 退订终端输入（setIdleDetect("off") 会解除订阅）。
             tracker.setIdleDetect("off");
             currentCtx?.ui.setStatus(STATUS_KEY, undefined);
+            currentCtx?.ui.setStatus(SUPERVISOR_STATUS_KEY, undefined);
             currentCtx = undefined;
             currentPi = undefined;
         }
@@ -1090,6 +1184,8 @@ async function tick() {
         }
         // 未触发时用判定原因填状态栏。
         setStatus(ctx, evaluateIdle({ config, tracker, guard, runtimeMode: ctx.mode }));
+        // 监督面状态栏（助理在不在 · 上次联系 · 预算余量；与 Web 看板同源，内建节流）。
+        setSupervisorStatus(ctx);
     }
     catch (err) {
         console.error("[proactive] tick 失败:", err);
@@ -1113,6 +1209,129 @@ function setStatus(ctx, decision) {
         // ignore: 状态栏失败不得让宿主崩溃
     }
 }
+/**
+ * 监督面的状态栏（**第二个状态栏 key**）：助理在不在 · 上次联系 · 预算余量。
+ *
+ * 与主动机制的状态栏分开：前者是「我现在为什么（没）触发」，后者是「它对我做了什么」。
+ * 数字全部来自 `src/supervisor-state.ts` 的**同一份聚合**（与 Web 看板逐字一致）。
+ */
+const SUPERVISOR_STATUS_KEY = "proactive-supervisor";
+/** 上次写监督面状态栏的时刻（节流：最多每 5s 采集一次）。 */
+let lastSupervisorStatusAt = 0;
+/** 上次写进监督面状态栏的文本（内容未变不重写 → 不刷噪声）。 */
+let lastSupervisorStatusText = "";
+/** 写监督面状态栏（失败不得冒泡；内容未变不重写）。 */
+function setSupervisorStatus(ctx) {
+    try {
+        const now = Date.now();
+        if (now - lastSupervisorStatusAt < STATUS_THROTTLE_MS)
+            return;
+        lastSupervisorStatusAt = now;
+        const text = formatSupervisorSummary(collectSupervisorState({ agentDir: resolveAgentDir() }));
+        if (text === lastSupervisorStatusText)
+            return;
+        lastSupervisorStatusText = text;
+        ctx.ui.setStatus(SUPERVISOR_STATUS_KEY, text);
+    }
+    catch {
+        // ignore: 监督面状态栏失败不得让宿主崩溃
+    }
+}
+/**
+ * 采集监督面状态（**只读**；聚合失败 → undefined，调用方如实回执）。
+ */
+function readSupervisorState() {
+    try {
+        return collectSupervisorState({ agentDir: resolveAgentDir() });
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * 展示监督面（TUI 面板；非交互模式 → 同样的纯文本）。
+ *
+ * 只读：面板里没有任何可点/可改的操作（写操作只在 Pi 会话的自然语言/命令面）。
+ */
+async function showSupervisorPanel(ctx) {
+    const state = readSupervisorState();
+    if (state === undefined) {
+        ctx.ui.notify("proactive: 监督面读取失败（事实源不可读）", "error");
+        return;
+    }
+    const lines = formatSupervisorPanel(state);
+    // 非交互模式（json / print / rpc 无 TUI）：同样内容以纯文本给出 → 不依赖 TUI 能力。
+    if (ctx.mode !== "tui") {
+        console.log(lines.join("\n"));
+        return;
+    }
+    await ctx.ui.custom((tui, theme, keybindings, done) => {
+        let cachedWidth;
+        let cachedLines;
+        const invalidate = () => {
+            cachedWidth = undefined;
+            cachedLines = undefined;
+        };
+        return {
+            render(width) {
+                if (cachedLines !== undefined && cachedWidth === width)
+                    return cachedLines;
+                cachedWidth = width;
+                cachedLines = [...lines, theme.fg("dim", "按 Esc 关闭")].map((line) => truncateToColumns(line, width));
+                return cachedLines;
+            },
+            handleInput(data) {
+                const close = (() => {
+                    try {
+                        return keybindings.matches(data, "tui.select.cancel") || keybindings.matches(data, "tui.select.confirm");
+                    }
+                    catch {
+                        return data === "\x1b";
+                    }
+                })();
+                if (close) {
+                    done(undefined);
+                    return;
+                }
+                invalidate();
+                tui.requestRender();
+            },
+            invalidate,
+        };
+    });
+}
+/**
+ * 按**可见列宽**裁剪一行（CJK 算 2 列）。
+ *
+ * 为什么自己算：宿主有 `truncateToWidth`，但那是宿主包里的模块 → 扩展产物不依赖它
+ * （打包后扩展只保证 peerDependencies 可解析）。宽字符按 1 列裁会溢出 → 这里按 2 列算。
+ */
+function truncateToColumns(line, width) {
+    if (width <= 0)
+        return "";
+    let used = 0;
+    let out = "";
+    for (const ch of line) {
+        const w = isWideChar(ch) ? 2 : 1;
+        if (used + w > width)
+            break;
+        used += w;
+        out += ch;
+    }
+    return out;
+}
+/** 是否是宽字符（CJK / 全角）。 */
+function isWideChar(ch) {
+    const code = ch.codePointAt(0) ?? 0;
+    return ((code >= 0x1100 && code <= 0x115f) ||
+        (code >= 0x2e80 && code <= 0xa4cf) ||
+        (code >= 0xac00 && code <= 0xd7a3) ||
+        (code >= 0xf900 && code <= 0xfaff) ||
+        (code >= 0xfe30 && code <= 0xfe6f) ||
+        (code >= 0xff00 && code <= 0xff60) ||
+        (code >= 0xffe0 && code <= 0xffe6) ||
+        (code >= 0x20000 && code <= 0x3fffd));
+}
 /**
  * `/proactive test`：强制投递一次自检消息。
  *
@@ -2184,8 +2403,14 @@ function formatHelp() {
         "  every <时长> <内容>  排期重复",
         "  test                 强制走一次投递链路自检（不受总开关与冷却影响）",
         "  doctor [--json]      只读体检：插件面各面状态 + 判据 + 处置建议（不打扰、不耗额度）",
+        "  progress             项目进度 + ETA：区间 + 置信度 + 归因 + 阻塞项（不给单点数字）",
         "  tell <peer> <内容>    人侧给对端 agent 下指令（--kind ask|task|notify；缺省 ask）",
+        "  assistant on          打开常驻助理（7×24；后台装，不阻塞会话；装完看 assistant status）",
+        "  assistant off         关闭常驻助理（回执含残留终检：任务 / 进程 / 单元）",
+        "  assistant status      常驻状态：宿主 / 进程 / 心跳 / 上次联系",
+        "  assistant restart     重装常驻助理（等价于再跑一次 on）",
         "  help                 本页",
+        "  supervisor           监督面（只读）：助理在不在 / 联系时间线 / 托付 / 阻塞 / 预算 / 守恒等式",
         "",
         "【配置键速查】（详表见 <安装目录>/README.md「配置」）",
         "  enabled               主动性总开关（默认 true）",