pactive 0.0.1-alpha.1 → 0.0.3-alpha.1

package/commands/pactive.md

@@ -0,0 +1,49 @@
+---
+description: Pactive 主动机制 — status、schedule、tell、history（经 pactive MCP server）
+argument-hint: "[status|schedule|tell|history] [args...]"
+---
+
+# pactive:pactive
+
+把用户关于「主动机制 / 空闲触发 / 定时任务 / 跨会话消息」的请求路由到 `pactive` MCP server。
+宿主把它暴露为 `/pactive:pactive`；裸 `/pactive` 不由插件契约保证。
+
+## 工具名
+
+OPCteam 用命名空间暴露插件 MCP 工具：
+
+```
+mcp__plugin_pactive_pactive__<tool>
+```
+
+具体名字：
+
+- `mcp__plugin_pactive_pactive__pactive_status`
+- `mcp__plugin_pactive_pactive__pactive_schedule`
+- `mcp__plugin_pactive_pactive__pactive_tell`
+- `mcp__plugin_pactive_pactive__pactive_history`
+- `mcp__plugin_pactive_pactive__pactive_config`（只读；要改配置时只返回可复制命令）
+
+裸名（`pactive_status`）不一定能被 ToolSearch 发现；若命名空间工具没加载，用
+`select:mcp__plugin_pactive_pactive__pactive_status` 搜一次。
+
+## 路由
+
+| 用户说 | 调用 |
+|---|---|
+| 状态 / 为什么没触发 | `pactive_status`（看 `idle.reason`，别猜） |
+| 10 分钟后提醒我 / 定时 | `pactive_schedule` `when:"10m"` `prompt:"…"` |
+| 18:30 提醒我 | `pactive_schedule` `when:"18:30"` |
+| 每小时 | `pactive_schedule` `when:"every 1h"` |
+| 告诉另一个会话 | `pactive_tell` `to` `body`（可选 `kind:"ask"`） |
+| 最近发生过什么 | `pactive_history` `limit` |
+| 开关 / 阈值 / 安静时间是多少 | `pactive_config` `key`（只读，报当前值与默认值） |
+| 帮我开启主动提醒 / 改阈值 | `pactive_config` `key` `value` → 只拿到 `pactive config set … --confirm`，交给用户执行 |
+
+## 硬规则
+
+1. **不要替用户改配置**：pactive 的开关与配置是人工闸门（CLI `--confirm`）。用户要求改配置时，
+   告诉他用 `pactive config set … --confirm`，不要自行绕过；用户执行后下一轮用 `pactive_status` 复核。
+2. **回执如实转述**：`queued` 就是**还没送到**（对端离线），不要说成已送达。
+3. **默认不打扰**：空闲触发默认关闭；用户没明确要「空闲自动推进」时，不要假设它已开启。
+4. **只报新事实**：状态类输出要给出 `idle.reason` 与护栏结论，不要泛泛说「一切正常」。

package/dsh/cordis.patch.yml

@@ -1,10 +1,10 @@
-# DSH bundle overlay for the acti package.
+# DSH bundle overlay for the pactive package.
 #
 # Format (verified against DSH 0.2.1-rc.5 by running
 # `dsh plugin --profile <p> add <pkg>`): a **top-level YAML array** of loader
 # patch entries; each entry may carry an `insert` list of plugin rows
-# ({ id, name, config }). `name` must be the installed package name (`acti`).
+# ({ id, name, config }). `name` must be the installed package name (`pactive`).
 - insert:
-    - id: acti
-      name: acti/dsh
+    - id: pactive
+      name: pactive/dsh
       config: {}

package/dsh/index.js

@@ -1,8 +1,8 @@
 /**
- * Acti — DSH (Cordis) plugin.
+ * Pactive — DSH (Cordis) plugin.
  *
- * Registers the acti tool surface (`acti_status` / `acti_schedule`) and the
- * `/acti` command, and subscribes to session events so the acti activity
+ * Registers the pactive tool surface (`pactive_status` / `pactive_schedule`) and the
+ * `/pactive` command, and subscribes to session events so the pactive activity
  * timeline and the control flag stay accurate.
  *
  * The core module (`src/core/index.mjs`) is loaded lazily by relative path —
@@ -18,7 +18,7 @@
 
 import { loadCore, mutateState, parseWhen, pickState, readState } from "../mcp/tools/_core.mjs";
 
-export const name = "acti";
+export const name = "pactive";
 
 /** Every Cordis service this plugin touches must be declared here. */
 export const inject = ["tools", "commands", "sessions"];
@@ -47,7 +47,7 @@ async function markActivity(kind, ctx) {
       return next && typeof next === "object" ? next : state;
     });
   } catch (err) {
-    safeLog(ctx, "warn", `acti: markActivity(${kind}) failed`, { error: errorText(err) });
+    safeLog(ctx, "warn", `pactive: markActivity(${kind}) failed`, { error: errorText(err) });
   }
 }
 
@@ -61,11 +61,19 @@ async function markControlReturned(ctx) {
       return next && typeof next === "object" ? next : state;
     });
   } catch (err) {
-    safeLog(ctx, "warn", "acti: markControlReturned failed", { error: errorText(err) });
+    safeLog(ctx, "warn", "pactive: markControlReturned failed", { error: errorText(err) });
   }
 }
 
 const STATUS_PARAMETERS = { type: "object", properties: {}, additionalProperties: false };
+const CONFIG_PARAMETERS = {
+  type: "object",
+  properties: {
+    key: { type: "string", description: "配置键；缺省返回全部（idle.enabled / idle.thresholdMs / policy.*）" },
+    value: { type: "string", description: "想改成的新值；给了就只返回 `pactive config set <key> <value> --confirm`，不落盘" },
+  },
+  additionalProperties: false,
+};
 const SCHEDULE_PARAMETERS = {
   type: "object",
   properties: {
@@ -87,9 +95,10 @@ export function apply(ctx, config) {
     if (!ctx?.tools?.register) return;
 
     ctx.tools.register({
-      name: "acti_status",
+      name: "pactive_status",
       description:
-        "Acti 主动机制状态：空闲判定与 reason、护栏四闸门、定时任务数、最近活动。只读。",
+        "当用户问「我现在闲不闲」「主动提醒开启了吗」「为什么没触发」「刚才主动做了什么」时用。" +
+        "→ 读当前空闲判定、reason、护栏四闸门、任务数与最近活动。只读，不落盘。",
       parameters: STATUS_PARAMETERS,
       async execute(args = {}) {
         try {
@@ -120,8 +129,11 @@ export function apply(ctx, config) {
     });
 
     ctx.tools.register({
-      name: "acti_schedule",
-      description: "登记一个定时任务（真正落盘）。when 支持时长（10m）、时刻（18:30）、ISO 时间、every 1h。",
+      name: "pactive_schedule",
+      description:
+        "当用户说「10 分钟后提醒我喝水」「18:30 提醒我开会」「每小时检查一次」时用。" +
+        "→ 登记一条定时任务并立即落盘；when 支持 10m / 18:30 / ISO 8601 / every 1h。" +
+        "会写盘，需要人工确认（只在用户明确要求时调用）。",
       parameters: SCHEDULE_PARAMETERS,
       async execute(args = {}) {
         try {
@@ -155,14 +167,54 @@ export function apply(ctx, config) {
         }
       },
     });
+
+    // Read-only by construction: a write request returns the command, never a write (contract §2.3).
+    ctx.tools.register({
+      name: "pactive_config",
+      description:
+        "当用户问「主动提醒的开关开着吗」「阈值是多少」「安静时间是几点」「帮我把主动提醒打开」时用。" +
+        "→ 读配置值与默认值；要改配置时只返回一条需要人工确认的可复制命令。只读，不落盘。",
+      parameters: CONFIG_PARAMETERS,
+      async execute(args = {}) {
+        try {
+          const core = await loadCore();
+          const described = core.config?.describe ? core.config.describe() : { schema: {}, defaults: {} };
+          const known = Object.keys(described.defaults);
+          const key = typeof args.key === "string" ? args.key.trim() : "";
+          const rawValue = args.value === undefined || args.value === null ? "" : String(args.value).trim();
+          if (key !== "" && !known.includes(key)) {
+            return { ok: false, error: `未知配置键（${key}）；已知：${known.join(", ")}` };
+          }
+          const paths = core.resolvePaths(HOST_KIND, process.env);
+          const state = (await readState(core, paths)) ?? core.defaultState();
+          const values = (key === "" ? known : [key]).map((k) => ({
+            key: k,
+            value: core.config?.get ? core.config.get(state, k) : null,
+            default: described.defaults[k] ?? null,
+            humanGated: described.schema?.[k]?.humanGated === true,
+          }));
+          if (rawValue === "") return { ok: true, readOnly: true, wrote: false, values };
+          return {
+            ok: false,
+            wrote: false,
+            reason: "need_human_confirmation",
+            command: `pactive config set ${key} ${rawValue} --confirm`,
+            hint: "不要自己改状态文件；把 command 原样给用户，等他执行后下一轮用 pactive_status 复核。",
+            values,
+          };
+        } catch (err) {
+          return { ok: false, error: errorText(err) };
+        }
+      },
+    });
   };
 
   const registerCommands = () => {
     if (!ctx?.commands?.register) return;
 
     ctx.commands.register({
-      name: "acti",
-      description: "Acti：status | tasks | schedule <when> <prompt> | help",
+      name: "pactive",
+      description: "Pactive：status | tasks | schedule <when> <prompt> | help",
       input: { hint: "status | tasks | schedule <when> <prompt> | help" },
       async handler(invocation) {
         const raw = String(invocation?.rawInput ?? "").trim();
@@ -182,7 +234,7 @@ export function apply(ctx, config) {
             const guard = core.checkGuard ? core.checkGuard(state, now) : { pass: false, reason: "requires-action" };
             const tasks = core.schedule?.list ? core.schedule.list(state) : (state.tasks ?? []);
             return ok(
-              `acti: idle=${idle.idle} reason=${idle.reason} guard=${guard.pass ? "pass" : "blocked"} ` +
+              `pactive: idle=${idle.idle} reason=${idle.reason} guard=${guard.pass ? "pass" : "blocked"} ` +
                 `(${guard.reason ?? "-"}) tasks=${Array.isArray(tasks) ? tasks.length : 0}`,
             );
           }
@@ -191,17 +243,17 @@ export function apply(ctx, config) {
             const list = Array.isArray(tasks) ? tasks : [];
             return ok(
               list.length === 0
-                ? "acti: 没有定时任务"
-                : `acti: ${list.length} 个定时任务\n` +
+                ? "pactive: 没有定时任务"
+                : `pactive: ${list.length} 个定时任务\n` +
                     list.map((task) => `- [${task?.id ?? "?"}] ${task?.prompt ?? task?.content ?? ""}`).join("\n"),
             );
           }
           if (sub === "schedule") {
             const when = parts[1] ?? "10m";
             const prompt = parts.slice(2).join(" ");
-            if (prompt === "") return fail("用法：/acti schedule <when> <prompt>");
+            if (prompt === "") return fail("用法：/pactive schedule <when> <prompt>");
             const spec = parseWhen(when, now);
-            if (!spec) return fail(`acti: 无法解析 when（${when}）`);
+            if (!spec) return fail(`pactive: 无法解析 when（${when}）`);
             const next = await mutateState(core, paths, (current) => {
               const out = core.schedule.add(
                 current,
@@ -212,11 +264,11 @@ export function apply(ctx, config) {
             });
             const tasks = core.schedule?.list ? core.schedule.list(next) : (next.tasks ?? []);
             const created = Array.isArray(tasks) ? tasks[tasks.length - 1] : null;
-            return ok(`acti: 已登记定时任务 ${created?.id ?? "-"}（${when}）`);
+            return ok(`pactive: 已登记定时任务 ${created?.id ?? "-"}（${when}）`);
           }
-          return fail("用法：/acti status | tasks | schedule <when> <prompt> | help");
+          return fail("用法：/pactive status | tasks | schedule <when> <prompt> | help");
         } catch (err) {
-          return fail(`acti 失败：${errorText(err)}`);
+          return fail(`pactive 失败：${errorText(err)}`);
         }
       },
     });
@@ -247,7 +299,7 @@ export function apply(ctx, config) {
           void markActivity(kind, ctx);
         });
       } catch (err) {
-        safeLog(ctx, "debug", `acti: session event ${event} unavailable`, { error: errorText(err) });
+        safeLog(ctx, "debug", `pactive: session event ${event} unavailable`, { error: errorText(err) });
       }
     }
     // The agent settled → control returned to the human.
@@ -257,7 +309,7 @@ export function apply(ctx, config) {
           void markControlReturned(ctx);
         });
       } catch (err) {
-        safeLog(ctx, "debug", `acti: session event ${event} unavailable`, { error: errorText(err) });
+        safeLog(ctx, "debug", `pactive: session event ${event} unavailable`, { error: errorText(err) });
       }
     }
   };
@@ -267,7 +319,7 @@ export function apply(ctx, config) {
     registerCommands();
     subscribeSessionEvents();
   } catch (err) {
-    safeLog(ctx, "error", "acti: failed to register tools/commands", { error: errorText(err) });
+    safeLog(ctx, "error", "pactive: failed to register tools/commands", { error: errorText(err) });
   }
 
   // The agent stops → control returns to the human.
@@ -276,10 +328,10 @@ export function apply(ctx, config) {
       void markControlReturned(ctx);
     });
   } catch (err) {
-    safeLog(ctx, "warn", "acti: ctx.effect unavailable; control flag updated on events only", {
+    safeLog(ctx, "warn", "pactive: ctx.effect unavailable; control flag updated on events only", {
       error: errorText(err),
     });
   }
 
-  safeLog(ctx, "info", "acti plugin loaded", { config: pluginConfig });
+  safeLog(ctx, "info", "pactive plugin loaded", { config: pluginConfig });
 }

package/hooks/post-tool-use.mjs

@@ -13,7 +13,7 @@ await readStdinJson();
 try {
   await markActivity("tool");
 } catch (err) {
-  process.stderr.write(`[acti] PostToolUse: ${String(err?.message ?? err)}\n`);
+  process.stderr.write(`[pactive] PostToolUse: ${String(err?.message ?? err)}\n`);
 }
 
 writeHookOutput({});

package/hooks/session-end.mjs

@@ -13,7 +13,7 @@ await readStdinJson();
 try {
   await markActivity("session-end");
 } catch (err) {
-  process.stderr.write(`[acti] SessionEnd: ${String(err?.message ?? err)}\n`);
+  process.stderr.write(`[pactive] SessionEnd: ${String(err?.message ?? err)}\n`);
 }
 
 writeHookOutput({});

package/hooks/session-start.mjs

@@ -14,7 +14,7 @@ await readStdinJson();
 try {
   await markActivity("session-start");
 } catch (err) {
-  process.stderr.write(`[acti] SessionStart: ${String(err?.message ?? err)}\n`);
+  process.stderr.write(`[pactive] SessionStart: ${String(err?.message ?? err)}\n`);
 }
 
 writeHookOutput({});

package/hooks/stop.mjs

@@ -44,12 +44,12 @@ try {
       writeHookOutput({});
     } else {
       const lines = tasks.map((task) => `- [${task?.id ?? "?"}] ${task?.prompt ?? task?.content ?? ""}`.trim());
-      const reason = `acti: ${tasks.length} 个定时任务到期\n${lines.join("\n")}`;
+      const reason = `pactive: ${tasks.length} 个定时任务到期\n${lines.join("\n")}`;
       await mutateState(core, paths, (current) => ({ ...current, stopBlockCount: 1, controlReturned: false }));
       writeHookOutput({ decision: "block", reason });
     }
   }
 } catch (err) {
-  process.stderr.write(`[acti] Stop: ${String(err?.message ?? err)}\n`);
+  process.stderr.write(`[pactive] Stop: ${String(err?.message ?? err)}\n`);
   writeHookOutput({});
 }

package/hooks/user-prompt-submit.mjs

@@ -20,7 +20,7 @@ await readStdinJson();
 try {
   await markActivity("user");
 } catch (err) {
-  process.stderr.write(`[acti] UserPromptSubmit: ${String(err?.message ?? err)}\n`);
+  process.stderr.write(`[pactive] UserPromptSubmit: ${String(err?.message ?? err)}\n`);
 }
 
 try {
@@ -28,7 +28,7 @@ try {
   const paths = core.resolvePaths("opcteam", process.env);
   await mutateState(core, paths, (state) => ({ ...state, stopBlockCount: 0 }));
 } catch (err) {
-  process.stderr.write(`[acti] UserPromptSubmit (reset): ${String(err?.message ?? err)}\n`);
+  process.stderr.write(`[pactive] UserPromptSubmit (reset): ${String(err?.message ?? err)}\n`);
 }
 
 writeHookOutput({});

package/mcp/server.mjs

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
 /**
- * `acti` MCP server for OPCteam — stdio JSON-RPC, zero third-party dependencies.
+ * `pactive` MCP server for OPCteam — stdio JSON-RPC, zero third-party dependencies.
  *
- * Exposes: acti_status / acti_schedule / acti_tell / acti_history.
+ * Exposes: pactive_status / pactive_schedule / pactive_tell / pactive_history.
  * Protocol: newline-delimited JSON-RPC 2.0 (MCP `initialize` / `tools/list` /
  * `tools/call`), the same wire shape the OPCteam plugin loader expects.
  */
@@ -14,8 +14,8 @@ import { fileURLToPath } from "node:url";
 import { TOOL_DEFINITIONS, findTool, runTool } from "./tools/definitions.mjs";
 
 const DEFAULT_PROTOCOL = "2024-11-05";
-const SERVER_NAME = "acti";
-const SERVER_VERSION = "0.0.1-alpha.1";
+const SERVER_NAME = "pactive";
+const SERVER_VERSION = "0.0.2-alpha.1";
 
 /** @param {NodeJS.WritableStream} output */
 function send(output, message) {

package/mcp/tools/_core.mjs

@@ -1,11 +1,11 @@
 /**
- * Shared Acti core access for the OPCteam / DSH host surfaces.
+ * Shared Pactive core access for the OPCteam / DSH host surfaces.
  *
  * `src/core/index.mjs` is produced by the parallel core worker. It is loaded
  * **lazily by relative path** so a missing (not yet built) core degrades into
  * a readable error instead of breaking plugin load.
  *
- * unverified: the frozen host contract (docs/team/task-cards/ACTI-CONTRACT.md)
+ * unverified: the frozen host contract (docs/team/task-cards/ACTI-CONTRACT.md, historical file name)
  * freezes the **export names** of core, but not the argument shapes of
  * `loadState` / `saveState` / `mutateState`. Every call below therefore tries
  * the plausible shapes in order and falls back to an explicit read/compute/write
@@ -31,7 +31,7 @@ let cachedCore = null;
  */
 export async function loadCore(env = process.env) {
   if (cachedCore) return cachedCore;
-  const explicit = env.ACTI_CORE_MODULE;
+  const explicit = env.PACTIVE_CORE_MODULE;
   const candidates = explicit ? [explicit, ...CORE_CANDIDATES] : CORE_CANDIDATES;
   const tried = [];
   for (const candidate of candidates) {
@@ -50,8 +50,8 @@ export async function loadCore(env = process.env) {
     }
   }
   throw new Error(
-    `acti: core module not found (tried: ${tried.join(", ")}). ` +
-      `Build src/core before using this surface; set ACTI_CORE_MODULE to override.`,
+    `pactive: core module not found (tried: ${tried.join(", ")}). ` +
+      `Build src/core before using this surface; set PACTIVE_CORE_MODULE to override.`,
   );
 }
 
@@ -137,7 +137,7 @@ export async function mutateState(core, paths, fn) {
   try {
     await writeState(core, paths, after);
   } catch (err) {
-    throw new Error(`acti: state write failed (${errorText(err)})`);
+    throw new Error(`pactive: state write failed (${errorText(err)})`);
   }
   return after;
 }

package/mcp/tools/definitions.mjs

@@ -1,7 +1,7 @@
 /**
- * MCP tool surface of the `acti` OPCteam plugin (stdio JSON-RPC server).
+ * MCP tool surface of the `pactive` OPCteam plugin (stdio JSON-RPC server).
  *
- * Tools: acti_status / acti_schedule / acti_tell / acti_history.
+ * Tools: pactive_status / pactive_schedule / pactive_tell / pactive_history.
  * Zero third-party dependencies — the schemas are plain JSON Schema.
  *
  * unverified: mailbox.send / ledger.tail argument shapes come from the frozen
@@ -33,15 +33,31 @@ const str = (description) => ({ type: "string", description });
 /** @type {Array<{name:string, description:string, inputSchema:object}>} */
 export const TOOL_DEFINITIONS = [
   {
-    name: "acti_status",
+    name: "pactive_status",
     description:
-      "Acti 主动机制状态：空闲判定与 reason、护栏四闸门、定时任务数、最近活动。只读。",
+      "当用户问「我现在闲不闲」「主动提醒开启了吗」「为什么没触发」「刚才主动做了什么」时用。" +
+      "→ 读当前空闲判定、reason、护栏四闸门、任务数与最近活动。只读，不落盘。",
     inputSchema: obj({}, []),
   },
   {
-    name: "acti_schedule",
+    name: "pactive_config",
     description:
-      "登记一个定时任务（真正落盘）。when 支持时长（10m）、时刻（18:30）、ISO 时间、every 1h。",
+      "当用户问「主动提醒的开关开着吗」「阈值是多少」「安静时间是几点」「帮我把主动提醒打开」时用。" +
+      "→ 读配置值与默认值；要改配置时只返回一条需要人工确认的可复制命令。只读，不落盘。",
+    inputSchema: obj(
+      {
+        key: str("配置键；缺省返回全部（idle.enabled / idle.thresholdMs / policy.*）"),
+        value: str("想改成的新值；给了就只返回 `pactive config set <key> <value> --confirm`，不落盘"),
+      },
+      [],
+    ),
+  },
+  {
+    name: "pactive_schedule",
+    description:
+      "当用户说「10 分钟后提醒我喝水」「18:30 提醒我开会」「每小时检查一次」时用。" +
+      "→ 登记一条定时任务并立即落盘；when 支持 10m / 18:30 / ISO 8601 / every 1h。" +
+      "会写盘，需要人工确认（只在用户明确要求时调用）。",
     inputSchema: obj(
       {
         prompt: str("任务正文（到点注入给会话的内容）"),
@@ -51,9 +67,11 @@ export const TOOL_DEFINITIONS = [
     ),
   },
   {
-    name: "acti_tell",
+    name: "pactive_tell",
     description:
-      "给同机另一个会话投递一条消息。对端离线时进入 outbox 排队，不伪装成功。",
+      "当用户说「告诉另一个会话我有空」「问一下隔壁 agent 跑完了吗」时用。" +
+      "→ 给同机另一个会话投递消息；对端离线时进入 outbox 排队，不伪装成功。" +
+      "会写盘，需要人工确认（只在用户明确要求时调用）。",
     inputSchema: obj(
       {
         to: str("目标会话的 agentId 或名字"),
@@ -64,8 +82,10 @@ export const TOOL_DEFINITIONS = [
     ),
   },
   {
-    name: "acti_history",
-    description: "读取 Acti 事件账本尾部（触发→投递→回应→结账），用于追溯主动行为。",
+    name: "pactive_history",
+    description:
+      "当用户问「刚才那几次主动提醒都发生了什么」「有没有真的触发过」时用。" +
+      "→ 读事件账本尾部（触发→投递→回应→结账）。只读。",
     inputSchema: obj({ limit: { type: "integer", description: "返回条数，默认 20" } }, []),
   },
 ];
@@ -98,7 +118,7 @@ export async function runTool(name, args = {}, options = {}) {
 
   try {
     switch (name) {
-      case "acti_status": {
+      case "pactive_status": {
         const state = (await readState(core, paths)) ?? core.defaultState();
         const policy = state.policy ?? {};
         const idle = core.evaluateIdle ? core.evaluateIdle(state, now, policy) : { idle: false, reason: "requires-action" };
@@ -117,7 +137,38 @@ export async function runTool(name, args = {}, options = {}) {
         });
       }
 
-      case "acti_schedule": {
+      case "pactive_config": {
+        // Read-only. A write request never lands: the model gets a copy-pasteable command
+        // whose --confirm only a human can type (contract §2.3 / I59).
+        const described = core.config?.describe ? core.config.describe() : { schema: {}, defaults: {}, humanGatedKeys: [] };
+        const known = Object.keys(described.defaults);
+        const key = typeof args.key === "string" ? args.key.trim() : "";
+        const rawValue = args.value === undefined || args.value === null ? "" : String(args.value).trim();
+        if (key !== "" && !known.includes(key)) {
+          return json(`ERROR INVALID_ARGUMENT: 未知配置键（${key}）；已知：${known.join(", ")}`, true);
+        }
+        const state = (await readState(core, paths)) ?? core.defaultState();
+        const values = (key === "" ? known : [key]).map((k) => ({
+          key: k,
+          value: core.config?.get ? core.config.get(state, k) : null,
+          default: described.defaults[k] ?? null,
+          humanGated: described.schema?.[k]?.humanGated === true,
+        }));
+        if (rawValue === "") {
+          return json({ ok: true, readOnly: true, wrote: false, values, stateFile: paths.stateFile });
+        }
+        return json({
+          ok: false,
+          readOnly: false,
+          wrote: false,
+          reason: "need_human_confirmation",
+          command: `pactive config set ${key} ${rawValue} --confirm`,
+          hint: "不要自己改状态文件；把 command 原样给用户，等他执行后下一轮用 pactive_status 复核。",
+          values,
+        });
+      }
+
+      case "pactive_schedule": {
         const prompt = typeof args.prompt === "string" ? args.prompt.trim() : "";
         if (prompt === "") return json("ERROR INVALID_ARGUMENT: prompt 必填", true);
         const spec = parseWhen(args.when, now);
@@ -138,7 +189,7 @@ const next = await mutateState(core, paths, (state) => {
         });
       }
 
-      case "acti_tell": {
+      case "pactive_tell": {
         const to = typeof args.to === "string" ? args.to.trim() : "";
         const body = typeof args.body === "string" ? args.body.trim() : "";
         if (to === "" || body === "") return json("ERROR INVALID_ARGUMENT: to 与 body 必填", true);
@@ -158,7 +209,7 @@ const next = await mutateState(core, paths, (state) => {
         });
       }
 
-      case "acti_history": {
+      case "pactive_history": {
         const limit = Number.isInteger(args.limit) ? args.limit : 20;
         const events = core.ledger?.tail ? core.ledger.tail(paths.ledgerFile, limit) : [];
         return json({ count: Array.isArray(events) ? events.length : 0, events });

package/package.json

@@ -1,12 +1,11 @@
 {
   "name": "pactive",
-  "version": "0.0.1-alpha.1",
-  "description": "Acti：跨 Pi / OPCteam / DSH 的主动能力运行时（idle 判定默认关闭、人工闸门、事件账本）。专有软件：使用条款见包内 LICENSE（发行物含 Pi 扩展源码 pi/extension.ts）。",
+  "version": "0.0.3-alpha.1",
+  "description": "Pactive：跨 Pi / OPCteam / DSH 的主动能力运行时（idle 判定默认关闭、人工闸门、事件账本）。专有软件：使用条款见包内 LICENSE（发行物含 Pi 扩展源码 pi/extension.ts）。",
   "license": "SEE LICENSE IN LICENSE",
   "type": "module",
   "bin": {
-    "pactive": "bin/acti.mjs",
-    "acti": "bin/acti.mjs"
+    "pactive": "bin/pactive.mjs"
   },
   "exports": {
     ".": "./src/core/index.mjs",
@@ -33,7 +32,7 @@
       "./pi/extension.ts"
     ],
     "skills": [
-      "./pi/skills/acti"
+      "./pi/skills/pactive"
     ]
   },
   "dsh": {