pactive 0.0.1-alpha.1 → 0.0.2-alpha.1

package/{pi/skills/acti → skills/pactive}/SKILL.md

@@ -1,28 +1,28 @@
 ---
-name: acti
+name: pactive
 description: >-
-  Correct usage of the acti proactive-assistant extension (tools acti_status / acti_schedule /
-  acti_tell / acti_history and the "/acti" command family). Use when the task involves checking
+  Correct usage of the pactive proactive-assistant extension (tools pactive_status / pactive_schedule /
+  pactive_tell / pactive_history and the "/pactive" command family). Use when the task involves checking
   whether the idle trigger fired or why it did not, scheduling work for later (one-shot or
-  repeating), reading the acti event ledger, or sending a message to another session on the same
+  repeating), reading the pactive event ledger, or sending a message to another session on the same
   machine. Covers the semantics traps (queued is not delivered, idle is disabled by default,
   human-gated config needs CLI --confirm, the Stop hook blocks at most once per turn) and the
   "when" syntax (10m / 18:30 / ISO 8601 / every 1h).
 ---
 
-# acti：怎么正确用它
+# pactive：怎么正确用它
 
-acti 给会话加**主动机制**：空闲判定（到点才动手）、**定时任务**、**跨会话消息**与**事件账本**。
+pactive 给会话加**主动机制**：空闲判定（到点才动手）、**定时任务**、**跨会话消息**与**事件账本**。
 
 ## 工具与命令
 
 | 入口 | 作用 |
 |---|---|
-| `acti_status` / `/acti status` | 空闲判定与 `reason`、护栏四闸门、定时任务数、最近活动（只读） |
-| `acti_schedule` / `/acti schedule <when> <prompt>` | 登记一个定时任务（真正落盘，重启后仍在） |
-| `acti_tell <to> <body>` | 给同机另一个会话投递消息（离线时排队，不伪装成功） |
-| `acti_history [n]` | 读事件账本尾部：触发 → 投递 → 回应 → 结账 |
-| `/acti tasks` | 列出待触发的定时任务 |
+| `pactive_status` / `/pactive status` | 空闲判定与 `reason`、护栏四闸门、定时任务数、最近活动（只读） |
+| `pactive_schedule` / `/pactive schedule <when> <prompt>` | 登记一个定时任务（真正落盘，重启后仍在） |
+| `pactive_tell <to> <body>` | 给同机另一个会话投递消息（离线时排队，不伪装成功） |
+| `pactive_history [n]` | 读事件账本尾部：触发 → 投递 → 回应 → 结账 |
+| `/pactive tasks` | 列出待触发的定时任务 |
 
 ## 关键语义（别踩）
 
@@ -43,5 +43,5 @@ ISO 8601 时间戳（绝对时刻）、`every 1h`（周期）。缺省 `10m`。
 ## 排障
 
 - 状态面板里 `reason=disabled` → 开关没开；`reason=busy` → 宿主还在忙；`reason=threshold` → 还没到阈值。
-- 任务登记了但没触发 → 先看 `acti_history` 里有没有 `triggered` 记录；没有说明调度器没跑到。
-- 消息一直是 `queued` → 对端不在线；看 `acti_status` 的 peers。
+- 任务登记了但没触发 → 先看 `pactive_history` 里有没有 `triggered` 记录；没有说明调度器没跑到。
+- 消息一直是 `queued` → 对端不在线；看 `pactive_status` 的 peers。

package/src/core/config.mjs

@@ -1,4 +1,4 @@
-import { actiError } from './errors.mjs';
+import { pactiveError } from './errors.mjs';
 
 export const CONFIG_SCHEMA = {
   'idle.enabled': { type: 'boolean', default: false, humanGated: true },
@@ -45,7 +45,7 @@ export const config = {
 function specOf(key) {
   const spec = Object.prototype.hasOwnProperty.call(CONFIG_SCHEMA, key) ? CONFIG_SCHEMA[key] : null;
   if (!spec) {
-    throw actiError('CONFIG_KEY_UNKNOWN', `unknown config key: ${key}`);
+    throw pactiveError('CONFIG_KEY_UNKNOWN', `unknown config key: ${key}`);
   }
   return spec;
 }

package/src/core/errors.mjs

@@ -1,7 +1,7 @@
 // Shared error helpers. The contract freezes one public error-code constant.
 export const NOT_IMPLEMENTED = 'NOT_IMPLEMENTED';
 
-export function actiError(code, message) {
+export function pactiveError(code, message) {
   const err = new Error(message);
   err.code = code;
   return err;

package/src/core/identity.mjs

@@ -2,7 +2,7 @@ import crypto from 'node:crypto';
 import fs from 'node:fs';
 import path from 'node:path';
 
-import { actiError } from './errors.mjs';
+import { pactiveError } from './errors.mjs';
 
 /**
  * Stable identity of an agent session.
@@ -14,7 +14,7 @@ export function makeIdentity({ name, hostKind, sessionId, cwd } = {}) {
   const h = typeof hostKind === 'string' ? hostKind.trim() : '';
   const s = typeof sessionId === 'string' ? sessionId.trim() : '';
   if (!n || !h || !s) {
-    throw actiError('IDENTITY_INCOMPLETE', 'name, hostKind and sessionId are required');
+    throw pactiveError('IDENTITY_INCOMPLETE', 'name, hostKind and sessionId are required');
   }
   const projectHash = hashProject(cwd ?? process.cwd());
   return {

package/src/core/lineage.mjs

@@ -1,14 +1,14 @@
 import fs from 'node:fs';
 import path from 'node:path';
 
-import { actiError } from './errors.mjs';
+import { pactiveError } from './errors.mjs';
 
 let tmpSeq = 0;
 
 /** Append-only event ledger: one JSON object per line, private file. */
 export const ledger = {
   append(file, event) {
-    if (typeof file !== 'string' || !file) throw actiError('LEDGER_PATH_REQUIRED', 'ledger path is required');
+    if (typeof file !== 'string' || !file) throw pactiveError('LEDGER_PATH_REQUIRED', 'ledger path is required');
     const dir = path.dirname(file);
     fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
     try {

package/src/core/lock.mjs

@@ -1,7 +1,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 
-import { actiError } from './errors.mjs';
+import { pactiveError } from './errors.mjs';
 
 export const LOCK_STALE_MS = 30000;
 export const LOCK_TIMEOUT_MS = 10000;
@@ -53,7 +53,7 @@ export async function withLock(locksDir, name, fn, opts = {}) {
         continue;
       }
       if (Date.now() > deadline) {
-        throw actiError('LOCK_TIMEOUT', `could not acquire lock ${lockFile}`);
+        throw pactiveError('LOCK_TIMEOUT', `could not acquire lock ${lockFile}`);
       }
       await sleep(20);
     }

package/src/core/paths.mjs

@@ -2,9 +2,9 @@ import fs from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
 
-import { actiError } from './errors.mjs';
+import { pactiveError } from './errors.mjs';
 
-export const DEFAULT_ROOT_DIRNAME = '.acti';
+export const DEFAULT_ROOT_DIRNAME = '.pactive';
 
 /**
  * Resolve the state root and every file location derived from it.
@@ -12,9 +12,9 @@ export const DEFAULT_ROOT_DIRNAME = '.acti';
  */
 export function resolvePaths(hostKind, env = process.env) {
   const kind = typeof hostKind === 'string' ? hostKind.trim() : '';
-  if (!kind) throw actiError('HOST_KIND_REQUIRED', 'hostKind is required');
+  if (!kind) throw pactiveError('HOST_KIND_REQUIRED', 'hostKind is required');
 
-  const source = env && typeof env.ACTI_STATE_DIR === 'string' ? env.ACTI_STATE_DIR.trim() : '';
+  const source = env && typeof env.PACTIVE_STATE_DIR === 'string' ? env.PACTIVE_STATE_DIR.trim() : '';
   const root = path.resolve(source || path.join(os.homedir(), DEFAULT_ROOT_DIRNAME));
 
   let stat = null;
@@ -25,12 +25,12 @@ export function resolvePaths(hostKind, env = process.env) {
   }
   if (stat) {
     if (!stat.isDirectory()) {
-      throw actiError('STATE_ROOT_INVALID', `state root is not a directory: ${root}`);
+      throw pactiveError('STATE_ROOT_INVALID', `state root is not a directory: ${root}`);
     }
     try {
       fs.accessSync(root, fs.constants.W_OK);
     } catch {
-      throw actiError('STATE_ROOT_NOT_WRITABLE', `state root is not writable: ${root}`);
+      throw pactiveError('STATE_ROOT_NOT_WRITABLE', `state root is not writable: ${root}`);
     }
   }
 

package/src/core/scheduler.mjs

@@ -1,4 +1,4 @@
-import { actiError } from './errors.mjs';
+import { pactiveError } from './errors.mjs';
 
 export const TASK_KINDS = ['in', 'at', 'every'];
 
@@ -10,22 +10,22 @@ let seq = 0;
  */
 export const schedule = {
   add(state, spec, now = Date.now()) {
-    if (!spec || typeof spec !== 'object') throw actiError('TASK_SPEC_REQUIRED', 'a task spec is required');
+    if (!spec || typeof spec !== 'object') throw pactiveError('TASK_SPEC_REQUIRED', 'a task spec is required');
     const ts = Number.isFinite(now) ? now : Date.now();
     const kind = spec.kind ?? (Number.isFinite(spec.at) ? 'at' : 'in');
     if (!TASK_KINDS.includes(kind)) {
-      throw actiError('TASK_KIND_UNKNOWN', `unknown task kind: ${kind}`);
+      throw pactiveError('TASK_KIND_UNKNOWN', `unknown task kind: ${kind}`);
     }
     if (!Array.isArray(state.tasks)) state.tasks = [];
 
     let dueAt;
     let everyMs = 0;
     if (kind === 'at') {
-      if (!Number.isFinite(spec.at)) throw actiError('TASK_AT_REQUIRED', 'an "at" task needs spec.at');
+      if (!Number.isFinite(spec.at)) throw pactiveError('TASK_AT_REQUIRED', 'an "at" task needs spec.at');
       dueAt = spec.at;
     } else if (kind === 'every') {
       everyMs = Number.isFinite(spec.everyMs) ? spec.everyMs : Number.isFinite(spec.intervalMs) ? spec.intervalMs : 0;
-      if (everyMs <= 0) throw actiError('TASK_INTERVAL_REQUIRED', 'an "every" task needs a positive interval');
+      if (everyMs <= 0) throw pactiveError('TASK_INTERVAL_REQUIRED', 'an "every" task needs a positive interval');
       dueAt = ts + everyMs;
     } else {
       const delay = Number.isFinite(spec.delayMs) ? spec.delayMs

package/src/core/state.mjs

@@ -1,7 +1,7 @@
 import fs from 'node:fs';
 import path from 'node:path';
 
-import { actiError } from './errors.mjs';
+import { pactiveError } from './errors.mjs';
 import { ensureDir, withLock } from './lock.mjs';
 import { ledger } from './lineage.mjs';
 
@@ -38,7 +38,7 @@ export function defaultState() {
 
 /** Accept either a paths object (from resolvePaths) or a state file path. */
 export function toPaths(target) {
-  if (!target) throw actiError('STATE_TARGET_REQUIRED', 'a paths object or state file path is required');
+  if (!target) throw pactiveError('STATE_TARGET_REQUIRED', 'a paths object or state file path is required');
   if (typeof target === 'string') {
     const stateFile = path.resolve(target);
     const root = path.dirname(stateFile);
@@ -54,7 +54,7 @@ export function toPaths(target) {
     };
   }
   if (typeof target.stateFile !== 'string' || !target.stateFile) {
-    throw actiError('STATE_TARGET_REQUIRED', 'a paths object or state file path is required');
+    throw pactiveError('STATE_TARGET_REQUIRED', 'a paths object or state file path is required');
   }
   const root = target.root ?? path.dirname(target.stateFile);
   return {
@@ -111,7 +111,7 @@ export function loadState(target) {
   try {
     const parsed = JSON.parse(raw);
     if (!parsed || typeof parsed !== 'object' || parsed.schemaVersion !== SCHEMA_VERSION) {
-      throw actiError('STATE_SCHEMA_UNSUPPORTED', `unsupported schemaVersion in ${paths.stateFile}`);
+      throw pactiveError('STATE_SCHEMA_UNSUPPORTED', `unsupported schemaVersion in ${paths.stateFile}`);
     }
     return normalize(parsed);
   } catch (err) {
@@ -143,10 +143,10 @@ function quarantine(paths, cause) {
 export function saveState(target, state) {
   const paths = toPaths(target);
   if (!state || typeof state !== 'object') {
-    throw actiError('STATE_REQUIRED', 'a state object is required');
+    throw pactiveError('STATE_REQUIRED', 'a state object is required');
   }
   if (state.schemaVersion !== SCHEMA_VERSION) {
-    throw actiError('STATE_SCHEMA_UNSUPPORTED', `expected schemaVersion ${SCHEMA_VERSION}`);
+    throw pactiveError('STATE_SCHEMA_UNSUPPORTED', `expected schemaVersion ${SCHEMA_VERSION}`);
   }
   ensureStateDirs(paths);
   const dir = path.dirname(paths.stateFile);
@@ -168,7 +168,7 @@ export function saveState(target, state) {
 
 /** Read-modify-write under a lock; the callback may be async and may mutate in place. */
 export async function mutateState(target, fn) {
-  if (typeof fn !== 'function') throw actiError('MUTATOR_REQUIRED', 'mutateState needs a function');
+  if (typeof fn !== 'function') throw pactiveError('MUTATOR_REQUIRED', 'mutateState needs a function');
   const paths = toPaths(target);
   ensureStateDirs(paths);
   return withLock(paths.locksDir, 'state', async () => {

package/src/hosts/dsh/index.mjs

@@ -1,4 +1,4 @@
-// DSH host adapter (contract §2). argv is verbatim per design §1: acti owns a dedicated profile.
+// DSH host adapter (contract §2). argv is verbatim per design §1: pactive owns a dedicated profile.
 import { readFileSync, readdirSync, rmSync } from 'node:fs';
 import os from 'node:os';
 import path from 'node:path';
@@ -17,7 +17,7 @@ export const MODE = 'profile';
 export const resolveExec = makeResolver('dsh', 'dsh');
 
 export function buildArgv({ pkgRoot, userArgs = [] }) {
-  return ['--profile', 'acti', ...userArgs];
+  return ['--profile', 'pactive', ...userArgs];
 }
 
 export function plan({ pkgRoot, env = process.env, userArgs = [] }) {
@@ -62,13 +62,13 @@ export function stateRoot(ctx = {}) {
 }
 
 export function installArgs({ pkgRoot }) {
-  return ['plugin', '--profile', 'acti', 'add', pkgRoot];
+  return ['plugin', '--profile', 'pactive', 'add', pkgRoot];
 }
 
 export function uninstallArgs({ pkgRoot }) {
   // pnpm removes by DEPENDENCY NAME, not by path: `pnpm remove /abs/path` exits 1 and leaves
   // the profile untouched (defect found 2026-11-05 via install→uninstall→residue probe).
-  return ['plugin', '--profile', 'acti', 'remove', packageName(pkgRoot)];
+  return ['plugin', '--profile', 'pactive', 'remove', packageName(pkgRoot)];
 }
 
 /** The dependency name that `install` registered (falls back to the package's own default). */
@@ -79,25 +79,25 @@ function packageName(pkgRoot) {
   } catch {
     // manifest unreadable: fall back to the contract name
   }
-  return 'acti';
+  return 'pactive';
 }
 
-/** Whether the acti profile currently exists (used to keep `uninstall` idempotent and quiet). */
+/** Whether the pactive profile currently exists (used to keep `uninstall` idempotent and quiet). */
 export function isInstalled({ env }) {
   const home = env.DSH_HOME || path.join(os.homedir(), '.dsh');
-  const manifest = path.join(home, 'profiles', 'acti', 'package.json');
+  const manifest = path.join(home, 'profiles', 'pactive', 'package.json');
   try {
     const pkg = JSON.parse(readFileSync(manifest, 'utf8'));
-    return Boolean(pkg?.dependencies?.acti) || (pkg?.dsh?.profile?.bundles || []).includes('acti');
+    return Boolean(pkg?.dependencies?.pactive) || (pkg?.dsh?.profile?.bundles || []).includes('pactive');
   } catch {
     return false;
   }
 }
 
-/** Remove the acti-owned DSH profile directory so `uninstall` leaves zero residue (I40). */
+/** Remove the pactive-owned DSH profile directory so `uninstall` leaves zero residue (I40). */
 export function cleanup({ env }) {
   const home = env.DSH_HOME || path.join(os.homedir(), '.dsh');
-  const profileDir = path.join(home, 'profiles', 'acti');
+  const profileDir = path.join(home, 'profiles', 'pactive');
   const manifest = path.join(profileDir, 'package.json');
   let pkg;
   try {
@@ -105,7 +105,7 @@ export function cleanup({ env }) {
   } catch {
     return { removed: false, reason: 'no-profile' };
   }
-  if (pkg.name !== 'dsh-profile-acti') {
+  if (pkg.name !== 'dsh-profile-pactive') {
     return { removed: false, reason: 'profile-not-owned' };
   }
   rmSync(profileDir, { recursive: true, force: true });
@@ -120,7 +120,7 @@ export function cleanup({ env }) {
 }
 
 export function verifyArgs({ pkgRoot }) {
-  return ['plugin', '--profile', 'acti', 'list'];
+  return ['plugin', '--profile', 'pactive', 'list'];
 }
 
 export function verifyMatch({ pkgRoot }, output) {

package/src/hosts/errors.mjs

@@ -1,17 +1,17 @@
 // Contract §2 error taxonomy.
-export class ActiError extends Error {
-  constructor(message, { code = 'ACTI_ERROR', exitCode = 1, cause } = {}) {
+export class PactiveError extends Error {
+  constructor(message, { code = 'PACTIVE_ERROR', exitCode = 1, cause } = {}) {
     super(message, cause === undefined ? undefined : { cause });
-    this.name = 'ActiError';
+    this.name = 'PactiveError';
     this.code = code;
     this.exitCode = exitCode;
   }
 }
 
 /** The host binary could not be found → CLI exit code 127. */
-export class HostMissingError extends ActiError {
+export class HostMissingError extends PactiveError {
   constructor(host, attempted = null) {
-    const envVar = `ACTI_${host.toUpperCase()}_BIN`;
+    const envVar = `PACTIVE_${host.toUpperCase()}_BIN`;
     super(
       `host binary for '${host}' not found${attempted ? ` (${attempted})` : ''} — install '${host}' or set ${envVar}`,
       { code: 'HOST_MISSING', exitCode: 127 },

package/src/hosts/pi/index.mjs

@@ -19,7 +19,7 @@ export function buildArgv({ pkgRoot, userArgs = [] }) {
     '--extension',
     path.join(pkgRoot, 'pi', 'extension.ts'),
     '--skill',
-    path.join(pkgRoot, 'pi', 'skills', 'acti'),
+    path.join(pkgRoot, 'pi', 'skills', 'pactive'),
     ...userArgs,
   ];
 }

package/src/hosts/shared/index.mjs

@@ -26,10 +26,10 @@ export function findOnPath(name, env = process.env) {
   return null;
 }
 
-/** env.ACTI_<HOST>_BIN → PATH lookup → throw HostMissingError (exit 127). */
+/** env.PACTIVE_<HOST>_BIN → PATH lookup → throw HostMissingError (exit 127). */
 export function makeResolver(host, binaryName) {
   return function resolveExec({ env = process.env } = {}) {
-    const override = env[`ACTI_${host.toUpperCase()}_BIN`];
+    const override = env[`PACTIVE_${host.toUpperCase()}_BIN`];
     if (override) {
       if (isExecutable(override)) return path.resolve(override);
       throw new HostMissingError(host, override);
@@ -60,5 +60,5 @@ export function unreachableReceipt(reason) {
 }
 
 export function defaultStateRoot(ctx = {}) {
-  return ctx.stateRoot ?? ctx.paths?.root ?? path.join(os.homedir(), '.acti');
+  return ctx.stateRoot ?? ctx.paths?.root ?? path.join(os.homedir(), '.pactive');
 }

package/commands/acti.md

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