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

package/.opcteam-plugin/plugin.json

@@ -1,10 +1,10 @@
 {
-  "name": "acti",
-  "version": "0.0.1-alpha.1",
-  "description": "Acti 主动机制：空闲判定、定时任务与跨会话消息（hooks + MCP）。",
+  "name": "pactive",
+  "version": "0.0.2-alpha.1",
+  "description": "Pactive 主动机制：空闲判定、定时任务与跨会话消息（hooks + MCP）。",
   "author": { "name": "pk09" },
   "mcpServers": {
-    "acti": {
+    "pactive": {
       "command": "node",
       "args": ["${OPCTEAM_PLUGIN_ROOT}/mcp/server.mjs"]
     }

package/BREAKING-CHANGES.md

@@ -1,17 +1,17 @@
 # Breaking Changes
 
-本文件记录 Acti 的**破坏性变更**。
+本文件记录 Pactive 的**破坏性变更**。
 
-## 协议版本：`acti/1`
+## 协议版本：`pactive/1`
 
-事件协议（ledger 事件、注入载荷、回执）的版本标识为 `acti/1`。
+事件协议（ledger 事件、注入载荷、回执）的版本标识为 `pactive/1`。
 
 **规则：只加不改。**
 
 - **可以**：新增事件类型、新增可选字段、新增枚举值（且旧消费方对未知值必须安全降级）。
 - **不可以**：重命名 / 删除已发布的字段或事件名、改变字段语义、收紧已发布字段的可接受取值范围、
   改变已发布字段的必填性。
-- 若某次变更无法在「只加不改」下表达，则必须**提升协议版本**（如 `acti/2`），
+- 若某次变更无法在「只加不改」下表达，则必须**提升协议版本**（如 `pactive/2`），
   并在本文件顶部新增一节说明迁移路径；旧版本**继续可用**，不删除、不 unpublish。
 
 ## 变更记录格式
@@ -29,11 +29,27 @@
 
 ## 未发布
 
-当前版本 `0.0.1-alpha.1` 尚未发布，暂无已发布的破坏性变更记录。
+当前版本 `0.0.2-alpha.1` 尚未发布，暂无已发布的破坏性变更记录。
+
+## 0.0.2-alpha.1 — 2026-11-05（尚未发布）
+
+### 破坏性
+
+- **产品/命令全量改名：`acti` → `pactive`**：旧行为 = 命令 `acti`、包内 CLI `bin/acti.mjs`、MCP server/工具名
+  `acti` / `acti_status` / `acti_schedule` / `acti_tell` / `acti_history`、Pi 命令 `/acti`、环境变量 `ACTI_*`、
+  默认状态根 `~/.acti`、协议串 `acti/1`；新行为 = 命令 `pactive`（`bin` 只剩 `{"pactive": "bin/pactive.mjs"}`）、
+  MCP `pactive` / `pactive_status` 等、Pi 命令 `/pactive`、环境变量 `PACTIVE_*`、默认状态根 `~/.pactive`、
+  协议串 `pactive/1`。
+  - 迁移：把脚本/集成里的 `acti` 命令换成 `pactive`，`ACTI_*` 换成 `PACTIVE_*`，`~/.acti` 状态根改到 `~/.pactive`
+    （或继续用 `PACTIVE_STATE_DIR` 显式指定旧目录以保留原状态）；MCP 工具名与 `/acti` 命令同步改名；协议串按 `pactive/1` 解析。
+- **旧命令不保留兼容别名**：`acti` 命令与 `ACTI_*` 环境变量**不再提供**（不注册别名、不读旧变量）。
+  旧版仍在 npm `@pk09/acti`（历史版本名），可继续安装使用，但不再随本包演进。
+- **状态根默认值变化**：默认由 `~/.acti` 改为 `~/.pactive`。不迁移旧目录内容；需要沿用旧状态时显式设置
+  `PACTIVE_STATE_DIR=<旧目录>`。
 
 ## 0.0.1-alpha.1 — 2026-11-05（尚未发布）
 
 ### 破坏性
 
-- 无。这是 `acti/1` 的首个版本，协议形状由
-  `docs/team/task-cards/ACTI-CONTRACT.md` 冻结；冻结之后只增不改。
+- 无。这是 `pactive/1` 的首个版本，协议形状由
+  `docs/team/task-cards/ACTI-CONTRACT.md`（历史文件名）冻结；冻结之后只增不改。

package/README.md

@@ -1,9 +1,9 @@
-# Acti
+# Pactive
 
 跨宿主的**主动能力运行时**：在宿主（Pi / OPCteam / DSH）之外统一判定「该不该主动说话」，
 把触发、投递、回应、结账写进一条 append-only 事件账本，并提供 CLI / doctor / 定时任务 / 跨会话消息。
 
-> **状态：v0.0.1-alpha.1（预发布）。** 本文只描述**契约层面**的接口。
+> **状态：v0.0.2-alpha.1（预发布）。** 本文只描述**契约层面**的接口。
 > 每一项能力后都标注了**当前实际验证到哪一步**——绝大多数条目当前为「未验证」。
 > 本文档不构成「已支持」的声明；请以「宿主兼容矩阵」与「未验证项」两节为准。
 
@@ -13,16 +13,16 @@
 
 ```bash
 # 从 npm（alpha 标签；首次发布前该命令会 404）
-npm i -g pactive   # 命令：pactive 或 acti
+npm i -g pactive   # 命令：pactive（旧命令已退役，见 BREAKING-CHANGES.md）
 
 # 从本地 tarball
 npm pack
-npm i -g --prefix /tmp/acti-prefix ./pactive-0.0.1-alpha.1.tgz
+npm i -g --prefix /tmp/pactive-prefix ./pactive-0.0.2-alpha.1.tgz
 ```
 
 运行环境：**Node.js ≥ 22.19.0**（`engines.node`）。
 
-安装后提供单个可执行文件 `acti`。本包**不含**源码仓库中的测试目录（`files` 白名单不含 `tests/`），
+安装后提供单个可执行文件 `pactive`。本包**不含**源码仓库中的测试目录（`files` 白名单不含 `tests/`），
 测试与门禁脚本仅存在于源码仓库。
 
 包元数据见 `package.json`：除设计 §10 列出的字段外，另加了 `pi`（Pi 宿主加载扩展/技能所需）、
@@ -32,39 +32,39 @@ npm i -g --prefix /tmp/acti-prefix ./pactive-0.0.1-alpha.1.tgz
 
 ## 2. 用法
 
-### 2.1 启动宿主（带 Acti 注入参数）
+### 2.1 启动宿主（带 Pactive 注入参数）
 
 ```bash
-acti pi        -p "继续处理积压任务"    # pi --extension <pkg>/pi/extension.ts --skill <pkg>/pi/skills/acti
-acti opcteam  -p "继续处理积压任务"    # opcteam --plugin-dir <pkg>
-acti dsh                            # dsh --profile acti（只写 acti 专用 profile）
+pactive pi       -p "继续处理积压任务"   # pi --extension <pkg>/pi/extension.ts --skill <pkg>/pi/skills/pactive
+pactive opcteam  -p "继续处理积压任务"   # opcteam --plugin-dir <pkg>
+pactive dsh                             # dsh --profile pactive（只写 pactive 专用 profile）
 ```
 - 注入参数在前，用户参数原样追加。
 - Pi 宿主通过包内 `pi` 字段声明扩展与技能（`pi.extensions` → `pi/extension.ts`，
-  `pi.skills` → `pi/skills/acti`）；`pi install acti` 依赖该字段。
+  `pi.skills` → `pi/skills/pactive`）；`pi install pactive` 依赖该字段。
 - 宿主退出码 / 信号原样透传（信号 → 128+n）。
-- **stdout 纯净**：Acti 自身的回执、诊断、进度一律走 stderr，
+- **stdout 纯净**：Pactive 自身的回执、诊断、进度一律走 stderr，
   stdout 只承载被启动宿主的输出，以及 `--print-plan` / `doctor --json` 的机器可读结果。
 
 ### 2.2 其它子命令
 
 | 命令 | 行为 | 退出码 |
 |---|---|---|
-| `acti --version` / `-v` | 打印版本号 | 0 |
-| `acti --help` / `-h` | 列出三个宿主、子命令、环境变量 | 0 |
-| `acti --print-plan <host>` | 打印注入计划 JSON（零写盘） | 0（未知宿主 2） |
-| `acti doctor [--json]` | 宿主 / 版本 / 注入模式 / 状态根 / 权限 / 残留 | 0（有 FAIL 段则 1） |
-| `acti install <host>` / `acti uninstall <host>` | 幂等安装 / 卸载 | 0（有残留则 1） |
-| `acti <未知宿主>` | 列出 pi / opcteam / dsh 到 stderr | 2 |
-| 宿主二进制缺失 | 提示安装 + `ACTI_<HOST>_BIN` 覆盖 | 127 |
+| `pactive --version` / `-v` | 打印版本号 | 0 |
+| `pactive --help` / `-h` | 列出三个宿主、子命令、环境变量 | 0 |
+| `pactive --print-plan <host>` | 打印注入计划 JSON（零写盘） | 0（未知宿主 2） |
+| `pactive doctor [--json]` | 宿主 / 版本 / 注入模式 / 状态根 / 权限 / 残留 | 0（有 FAIL 段则 1） |
+| `pactive install <host>` / `pactive uninstall <host>` | 幂等安装 / 卸载 | 0（有残留则 1） |
+| `pactive <未知宿主>` | 列出 pi / opcteam / dsh 到 stderr | 2 |
+| 宿主二进制缺失 | 提示安装 + `PACTIVE_<HOST>_BIN` 覆盖 | 127 |
 
 ### 2.3 环境变量
 
 | 变量 | 作用 |
 |---|---|
-| `ACTI_STATE_DIR` | 状态根覆盖（默认按宿主约定解析） |
-| `ACTI_HOME` | 包根覆盖（测试用） |
-| `ACTI_PI_BIN` / `ACTI_OPCTEAM_BIN` / `ACTI_DSH_BIN` | 宿主二进制路径覆盖 |
+| `PACTIVE_STATE_DIR` | 状态根覆盖（默认按宿主约定解析） |
+| `PACTIVE_HOME` | 包根覆盖（测试用） |
+| `PACTIVE_PI_BIN` / `PACTIVE_OPCTEAM_BIN` / `PACTIVE_DSH_BIN` | 宿主二进制路径覆盖 |
 
 ---
 
@@ -74,12 +74,12 @@ acti dsh                            # dsh --profile acti（只写 acti 专用 pr
 
 | 宿主 | 本机版本 | 注入方式 | 当前验证到哪一步 |
 |---|---|---|---|
-| Pi | 1.4.0（`pi --version` 实测） | `pi --extension <pkg>/pi/extension.ts --skill <pkg>/pi/skills/acti` | **已验证**：扩展真实加载 + `session_start` 触发 + `/acti status` 在真实 Pi 里输出状态行（`acti pi -p "/acti status"` → `[acti] ... idle=false reason=disabled`，exit 0）。**未验证**：TUI 交互模式下的命令可见性、`--skill` 技能是否被检索到 |
-| OPCteam | 1.1.6-test（`opcteam --version` 实测） | `opcteam --plugin-dir <pkg>`（包根即插件根） | **已验证**：`opcteam plugin validate <pkg>` → ✔ Validation passed；`opcteam plugin list` 显示 `acti@inline`；真实会话里 `/acti:acti status` 能被识别，MCP 工具 `mcp__plugin_acti_acti__acti_status` 已注册并被权限闸门拦下（`-p` 非交互下的预期行为）。**未验证**：人工批准后工具真正执行、hooks 在真实会话中的作用 |
-| DSH | 0.2.1-rc.5（`dsh --version` 实测） | `dsh plugin --profile acti add <pkg>` → `dsh --profile acti` | **已验证**：`acti install dsh` 写入专用 profile（`profiles/acti/package.json` 的 `dsh.profile.bundles` 含 `acti`），`dsh --profile acti --dump-config` 输出中出现 `acti`（7 处）。**未验证**：真实 GUI / TUI 会话里工具与命令的可用性 |
+| Pi | 1.4.0（`pi --version` 实测） | `pi --extension <pkg>/pi/extension.ts --skill <pkg>/pi/skills/pactive` | **已验证**：扩展真实加载 + `session_start` 触发 + `/pactive status` 在真实 Pi 里输出状态行（`pactive pi -p "/pactive status"` → `[pactive] ... idle=false reason=disabled`，exit 0）。**未验证**：TUI 交互模式下的命令可见性、`--skill` 技能是否被检索到 |
+| OPCteam | 1.1.6-test（`opcteam --version` 实测） | `opcteam --plugin-dir <pkg>`（包根即插件根） | **已验证**：`opcteam plugin validate <pkg>` → ✔ Validation passed（manifest `name=pactive`、`mcpServers.pactive`）。**未验证**：本机 opcteam 未登录（`pactive opcteam -p …` → `Not logged in · Please run /login`），改名后的 `/pactive:pactive` 命令识别、`mcp__plugin_pactive_pactive__pactive_status` 注册与工具执行均**未**在真实会话复验；改名前的同一链路曾在登录会话中验证（旧命令面）。 |
+| DSH | 0.2.1-rc.5（`dsh --version` 实测） | `dsh plugin --profile pactive add <pkg>` → `dsh --profile pactive` | **已验证**：`pactive install dsh` 写入专用 profile（`profiles/pactive/package.json` 的 `dsh.profile.bundles` 含 `pactive`），`dsh --profile pactive --dump-config` 输出里 `grep -c '^# == pactive'` = 1（段内 `id: pactive` / `name: pactive/dsh`）；`pactive uninstall dsh` 后 profile 目录被删净。**未验证**：真实 GUI / TUI 会话里工具与命令的可用性 |
 
-三宿主共同的端到端冒烟（`acti pi -p` / `acti opcteam -p` / `acti dsh --dump-config` 能看到 Acti 工具/命令）
-**尚未执行**，因此本文不声称任何宿主「已支持」。
+端到端冒烟现状：Pi 与 DSH 两条已实测（见上表），OPCteam 因本机未登录**未完成**。
+因此本文仍不声称任何宿主「已支持」。
 
 ACP 通道（第四个 adapter）**本期不实现**，仅留接口 stub 与文档口径，不在 CLI 表面内。
 
@@ -87,14 +87,14 @@ ACP 通道（第四个 adapter）**本期不实现**，仅留接口 stub 与文
 
 ## 4. 默认不打扰
 
-Acti 的默认状态是**不主动说话**：
+Pactive 的默认状态是**不主动说话**：
 
 - `idle.enabled = false`（空闲触发默认关闭）。引擎在、开关关。
 - 打开 idle 必须走**人工闸门**：只有 CLI 带 `--confirm` 才能改；
   MCP / 模型调用只能得到 `need_human_confirmation`，配置不变。
 - 空闲判定是四要素合取，缺一不触发：控制权已交回（Stop 后）、当前不忙、
   超过空闲阈值、四道护栏（静默时段 / 每小时上限 / 最小间隔 / 冷却）全部放行。
-- Acti 自己的注入**不刷新**活动基线；同一活动纪元最多触发一次。
+- Pactive 自己的注入**不刷新**活动基线；同一活动纪元最多触发一次。
 - 动作集默认只允许 `prompt`；`agent-inline` / `agent-process` 默认关闭。
 
 ---
@@ -106,9 +106,9 @@ Acti 的默认状态是**不主动说话**：
 - **不联网、不自更新**：启动与诊断不发起网络请求，包内不引入自动更新机制。
 - **权限**：状态目录 0700、状态文件 0600；权限不合要求时显式报错，不静默降级。
 - **默认零持久化**：Pi / OPCteam 默认只在会话内注入，不写用户 settings；
-  DSH 只写专用 `acti` profile，**不改**用户默认 profile。
-- **可卸载**：`acti uninstall <host>` 幂等，残留可枚举，残留非 0 即失败退出。
-- 发行物含 Pi 扩展源码（`pi/extension.ts`），使用条款见包内 `LICENSE`；使用条款见包内 `LICENSE`（专有许可）。
+  DSH 只写专用 `pactive` profile，**不改**用户默认 profile。
+- **可卸载**：`pactive uninstall <host>` 幂等，残留可枚举，残留非 0 即失败退出。
+- 发行物含 Pi 扩展源码（`pi/extension.ts`），使用条款见包内 `LICENSE`（专有许可）。
 
 ---
 
@@ -118,24 +118,26 @@ Acti 的默认状态是**不主动说话**：
 
 1. Pi 1.4.0：扩展加载/事件/命令已验证；**TUI 交互模式**下命令可见性与 skill 检索未验证。
 2. DSH Cordis bundle 在真实 GUI / 会话下的行为 —— 只计划验到 `--dump-config` 与工具注册。
-3. OPCteam：validate/list/命令发现/MCP 注册已验证；**人工批准后工具真正执行**与 hooks 实战效果未验证。
-4. 三宿主真实端到端冒烟（`acti pi -p` / `acti opcteam -p` / `acti dsh --dump-config`）。
-5. npm 安装链：`npm pack` → `npm i -g --prefix <prefix> ./acti-*.tgz` → `acti --version` → `acti doctor` 通过。
-6. npm 发布与回滚链路（`npm publish --tag alpha` / `npm view acti version` / `npm deprecate`）。
+3. OPCteam：改名后只验证到 `plugin validate`；**命令发现 / MCP 注册 / 人工批准后工具真正执行 / hooks 实战效果**均未在真实会话复验（本机未登录）。
+4. 三宿主端到端冒烟：Pi（`pactive pi -p "/pactive status"` → `[pactive] idle=false reason=disabled`，exit 0）与 DSH（`install` → `--dump-config` 有 `# == pactive` 段 → `uninstall` 零残留）**已实测**；OPCteam 受阻于未登录，**未完成**。
+5. npm 安装链：**已实测**（`npm pack` → `npm i -g --prefix <prefix> ./pactive-0.0.2-alpha.1.tgz` → `<prefix>/bin/pactive --version` = `0.0.2-alpha.1` → `<prefix>/bin/pactive doctor` = OK；同一 PATH 下旧命令 `acti` 已 `command not found`，exit 127）。**未验证**：真实 npm registry 安装（包尚未发布）。
+6. npm 发布与回滚链路（`npm publish --tag alpha` / `npm view pactive version` / `npm deprecate`）。
 7. Windows（Node spawn / 路径差异）—— 未在任何 Windows 机器验证。
 8. ACP 通道（I51–I56）—— 全部未实现、未探针。
 9. 空闲唤醒在 headless 下能否产生第二回合（B12 边界）。
 10. 卸载残留枚举为 0 的实测（`装两次 → 卸两次 → 残留 0`）。
-11. 安全项：假 key 不落地、目录/文件权限、子进程 env 过滤 —— 依赖 `tests/security` 用例，当前未落盘。
+11. 安全项：假 key 不落地、目录/文件权限、子进程 env 过滤 —— 用例已落盘于 `tests/security/`，但「子进程 env 过滤」无可测实现（用例 SKIP），该项视为未验证。
 
 ---
 
 ## 7. 协议与破坏性变更
 
-- 事件协议版本：`acti/1`。**只加不改**——已发布的字段不重命名、不删除、不改语义。
+- 事件协议版本：`pactive/1`。**只加不改**——已发布的字段不重命名、不删除、不改语义。
+- **改名（0.0.2-alpha.1 起）**：命令 = `pactive`；旧命令（历史版本名 `@pk09/acti` 提供）与 `ACTI_*` 环境变量**不再提供**，
+  状态根默认值改为 `~/.pactive`。详见 [`BREAKING-CHANGES.md`](./BREAKING-CHANGES.md)。
 - 破坏性变更记录见 [`BREAKING-CHANGES.md`](./BREAKING-CHANGES.md)。
 - 内部 API（`src/core` 导出名、宿主 adapter 签名）以
-  `docs/team/task-cards/ACTI-CONTRACT.md` 为冻结契约，改名即破坏并行。
+  `docs/team/task-cards/ACTI-CONTRACT.md` 为冻结契约（任务卡文件名保持历史原名），改名即破坏并行。
 
 ---
 
@@ -143,15 +145,15 @@ Acti 的默认状态是**不主动说话**：
 
 ```bash
 # 独立性门禁（依赖 / 源码 import / npm pack 产物 三层扫旧包名）
-bash scripts/quality/acti-independence-gate.sh
-bash scripts/quality/acti-independence-gate.sh --self-test   # 自测：造命中 → 断言红 → 清理 → 绿
+bash scripts/quality/pactive-independence-gate.sh
+bash scripts/quality/pactive-independence-gate.sh --self-test   # 自测：造命中 → 断言红 → 清理 → 绿
 
 # 聚合门禁（S1 core / S2 cli+hosts / S3 pack 单测+白名单+入口存在性 / S4 独立性 / S5 security / S6 文档机检+自测+数字对齐 / S7 结论行）
-bash scripts/quality/acti-gate.sh
-bash scripts/quality/acti-gate.sh S3      # 单段可跑
+bash scripts/quality/pactive-gate.sh
+bash scripts/quality/pactive-gate.sh S3      # 单段可跑
 ```
 
-独立性的含义：Acti **不依赖**旧的 `pi-proactive` / `opcteam-proactive` / `dsh-proactive` / `mcp-proactive` 包，
+独立性的含义：Pactive **不依赖**旧的 `pi-proactive` / `opcteam-proactive` / `dsh-proactive` / `mcp-proactive` 包，
 三层机检保证这一点（依赖声明 / 源码 import / 打包产物文件名）。
 
 ## 9. 本仓库目录（发行包 = 仓库根）
@@ -160,12 +162,12 @@ bash scripts/quality/acti-gate.sh S3      # 单段可跑
 
 | 路径 | 是什么 | 进 npm 包 |
 |---|---|---|
-| `bin/ src/ pi/ hooks/ mcp/ dsh/ commands/ agents/ skills/ .opcteam-plugin/` | **Acti 本体**（本新产品） | ✅ |
+| `bin/ src/ pi/ hooks/ mcp/ dsh/ commands/ agents/ skills/ .opcteam-plugin/` | **Pactive 本体**（本新产品） | ✅ |
 | `tests/` | 测试（core/cli/hosts/pack） | ❌ |
-| `scripts/quality/acti-*.sh` `scripts/quality/acti-proactive-probe.mjs` | 门禁与验收探针 | ❌ |
-| `docs/acti/` | 需求与设计真源（不变量 I1–I56、方案、功能清单、可视化设计、详细设计） | ❌ |
+| `scripts/quality/pactive-*.sh` `scripts/quality/pactive-proactive-probe.mjs` | 门禁与验收探针 | ❌ |
+| `docs/pactive/` | 需求与设计真源（不变量 I1–I56、方案、功能清单、可视化设计、详细设计） | ❌ |
 | `docs/project/` `docs/team/` `docs/review/` | 过程资产（里程碑/排期/回执/任务卡/评审） | ❌ |
-| `pi-proactive/ dsh-proactive/ opcteam-proactive/ mcp-proactive/` | **旧四个包**（仅行为参考，Acti 不依赖） | ❌ |
+| `pi-proactive/ dsh-proactive/ opcteam-proactive/ mcp-proactive/` | **旧四个包**（仅行为参考，Pactive 不依赖） | ❌ |
 | `dist/` `marketplace/` `runtime/` | 历史交付制品与分发入口 | ❌ |
 
-判据：`npm pack --dry-run --json | grep -c '"path"'` → 42（当前），且不含 `tests/`，由 `scripts/quality/acti-gate.sh` S3 段机检。
+判据：`npm pack --dry-run --json | grep -c '"path"'` → 41（当前实测），且不含 `tests/`，由 `scripts/quality/pactive-gate.sh` S3 段机检。

package/agents/{acti-observer.md → pactive-observer.md}

@@ -1,6 +1,6 @@
 ---
-name: acti-observer
-description: 观察 acti 的空闲判定与主动触发是否真的发生，只报可核验的事实
+name: pactive-observer
+description: 观察 pactive 的空闲判定与主动触发是否真的发生，只报可核验的事实
 tools:
   - Read
   - Grep
@@ -10,11 +10,11 @@ permissionMode: default
 maxTurns: 8
 ---
 
-你是 acti 的观察 agent：负责回答「主动机制到底有没有按预期工作」。
+你是 pactive 的观察 agent：负责回答「主动机制到底有没有按预期工作」。
 
 ## 任务
 
-1. 读 `acti_status`（或 `acti history`）拿到**当前**的空闲判定、`reason`、护栏结论与事件账本尾部。
+1. 读 `pactive_status`（或 `pactive history`）拿到**当前**的空闲判定、`reason`、护栏结论与事件账本尾部。
 2. 对照用户的期望回答：**触发了吗？为什么没触发？**
 3. 只报告**新事实**：具体的事件、具体的时间戳、具体的 `reason`，不要重复用户已知内容。
 

package/bin/{acti.mjs → pactive.mjs}

@@ -1,8 +1,8 @@
 #!/usr/bin/env node
-// Acti CLI — contract §3 / design §6.
+// Pactive CLI — contract §3 / design §6.
 //
 // Output discipline (design §6.3): machine-readable results (--print-plan, doctor --json,
-// --version) go to stdout; every human/diagnostic Acti text goes to stderr, so the stdout of a
+// --version) go to stdout; every human/diagnostic Pactive text goes to stderr, so the stdout of a
 // spawned host is never polluted.
 import { spawn, spawnSync } from 'node:child_process';
 import { existsSync, readdirSync, readFileSync, realpathSync, rmSync, statSync } from 'node:fs';
@@ -10,47 +10,47 @@ import os from 'node:os';
 import path from 'node:path';
 import { fileURLToPath, pathToFileURL } from 'node:url';
 
-import { ActiError } from '../src/hosts/errors.mjs';
+import { PactiveError } from '../src/hosts/errors.mjs';
 
 const HOSTS = ['pi', 'opcteam', 'dsh'];
 const CLI_DIR = path.dirname(fileURLToPath(import.meta.url));
 const PKG_ROOT = path.resolve(CLI_DIR, '..');
-const FALLBACK_VERSION = '0.0.1-alpha.1';
+const FALLBACK_VERSION = '0.0.2-alpha.1';
 const STALE_LOCK_MS = 30 * 60 * 1000;
 
 function usage(io) {
-  io.write(`acti — proactive companion for Pi / OPCteam / DSH
+  io.write(`pactive — proactive companion for Pi / OPCteam / DSH
 
 Usage:
-  acti <host> [args...]        run a host with acti injected (stdio inherited)
-  acti --print-plan <host>     print the launch plan as JSON (no side effects)
-  acti doctor [--json]         diagnose hosts, state root and permissions (read-only)
-  acti install <host>          register acti with a host (idempotent)
-  acti uninstall <host>        unregister acti and remove acti state residue
-  acti --version | -v          print the acti version
-  acti --help | -h             show this help
+  pactive <host> [args...]        run a host with pactive injected (stdio inherited)
+  pactive --print-plan <host>     print the launch plan as JSON (no side effects)
+  pactive doctor [--json]         diagnose hosts, state root and permissions (read-only)
+  pactive install <host>          register pactive with a host (idempotent)
+  pactive uninstall <host>        unregister pactive and remove pactive state residue
+  pactive --version | -v          print the pactive version
+  pactive --help | -h             show this help
 
 Hosts: ${HOSTS.join(', ')}
 
 Environment:
-  ACTI_HOME          package root override (default: this package)
-  ACTI_STATE_DIR     acti state root override
-  ACTI_PI_BIN        override the pi executable
-  ACTI_OPCTEAM_BIN   override the opcteam executable
-  ACTI_DSH_BIN       override the dsh executable
+  PACTIVE_HOME          package root override (default: this package)
+  PACTIVE_STATE_DIR     pactive state root override
+  PACTIVE_PI_BIN        override the pi executable
+  PACTIVE_OPCTEAM_BIN   override the opcteam executable
+  PACTIVE_DSH_BIN       override the dsh executable
 `);
 }
 
 function unknownHost(host, io) {
-  io.write(`acti: unknown host '${host}'\n`);
-  io.write(`acti: known hosts: ${HOSTS.join(', ')}\n`);
+  io.write(`pactive: unknown host '${host}'\n`);
+  io.write(`pactive: known hosts: ${HOSTS.join(', ')}\n`);
 }
 
 function resolvePkgRoot(env) {
-  return env.ACTI_HOME ? path.resolve(env.ACTI_HOME) : PKG_ROOT;
+  return env.PACTIVE_HOME ? path.resolve(env.PACTIVE_HOME) : PKG_ROOT;
 }
 
-function actiVersion() {
+function pactiveVersion() {
   try {
     const pkg = JSON.parse(readFileSync(path.join(PKG_ROOT, 'package.json'), 'utf8'));
     if (typeof pkg.version === 'string') return pkg.version;
@@ -64,26 +64,26 @@ async function loadAdapter(host) {
   return import(new URL(`../src/hosts/${host}/index.mjs`, import.meta.url));
 }
 
-/** src/core is built by the acti-core worker; until then the CLI degrades instead of faking it. */
+/** src/core is built by the pactive-core worker; until then the CLI degrades instead of faking it. */
 async function loadCore() {
   try {
     return await import(new URL('../src/core/index.mjs', import.meta.url));
   } catch (err) {
-    throw new ActiError('ACTI core not built yet', { code: 'CORE_MISSING', exitCode: 1, cause: err });
+    throw new PactiveError('PACTIVE core not built yet', { code: 'CORE_MISSING', exitCode: 1, cause: err });
   }
 }
 
 async function resolveStateRoot(env, warnings = []) {
-  if (env.ACTI_STATE_DIR) return path.resolve(env.ACTI_STATE_DIR);
+  if (env.PACTIVE_STATE_DIR) return path.resolve(env.PACTIVE_STATE_DIR);
   try {
     const core = await loadCore();
     const paths = core.resolvePaths('pi', env);
     if (paths?.root) return paths.root;
-    warnings.push('ACTI core returned no state root — using the default location');
+    warnings.push('PACTIVE core returned no state root — using the default location');
   } catch (err) {
     warnings.push(`${err.message} — using the default state root`);
   }
-  return path.join(os.homedir(), '.acti');
+  return path.join(os.homedir(), '.pactive');
 }
 
 function modeOf(p) {
@@ -198,7 +198,7 @@ async function doctorReport(env) {
       }
     } catch (err) {
       if (err.code !== 'HOST_MISSING') throw err;
-      warnings.push(`host ${host}: not installed (set ACTI_${host.toUpperCase()}_BIN to override)`);
+      warnings.push(`host ${host}: not installed (set PACTIVE_${host.toUpperCase()}_BIN to override)`);
     }
     hosts.push({ host, present, version, mode: mod.MODE, compatible });
   }
@@ -245,7 +245,7 @@ function doctorCmd(args, env, io) {
     if (asJson) {
       io.stdout.write(`${JSON.stringify(report, null, 2)}\n`);
     } else {
-      io.stderr.write(`acti doctor: ${report.ok ? 'OK' : 'FAIL'}\n`);
+      io.stderr.write(`pactive doctor: ${report.ok ? 'OK' : 'FAIL'}\n`);
       io.stderr.write(`state root: ${report.stateRoot} (dir ${report.perm.dir}, file ${report.perm.file})\n`);
       for (const h of report.hosts) {
         io.stderr.write(
@@ -317,7 +317,7 @@ function installCmd(args, env, io, action) {
         if (typeof mod.cleanup === 'function') {
           try { mod.cleanup({ pkgRoot, env }); } catch { /* residue 清理失败由下方 residue 检查兜底 */ }
         }
-        io.stderr.write(`acti: ${host} not installed — nothing to uninstall\n`);
+        io.stderr.write(`pactive: ${host} not installed — nothing to uninstall\n`);
         return 0;
       }
     }
@@ -327,31 +327,31 @@ function installCmd(args, env, io, action) {
     if (res.status !== 0) {
       const stillRegistered = verifyRegistered(mod, exec, pkgRoot);
       if (action === 'install' ? !stillRegistered : stillRegistered) {
-        io.stderr.write(`acti: ${action} ${host} failed (exit ${res.status})\n`);
+        io.stderr.write(`pactive: ${action} ${host} failed (exit ${res.status})\n`);
         if (res.stderr.trim()) io.stderr.write(`${res.stderr.trim()}\n`);
         return 1;
       }
     }
 
     if (action === 'uninstall') {
-      // Host-level residue: adapters may own resources Acti created (e.g. the DSH profile dir).
+      // Host-level residue: adapters may own resources Pactive created (e.g. the DSH profile dir).
       if (typeof mod.cleanup === 'function') {
         try {
           const cleaned = mod.cleanup({ pkgRoot, env });
-          if (cleaned && cleaned.removed) io.stderr.write(`acti: removed ${cleaned.path}\n`);
+          if (cleaned && cleaned.removed) io.stderr.write(`pactive: removed ${cleaned.path}\n`);
         } catch (err) {
-          io.stderr.write(`acti: cleanup warning: ${err?.message ?? err}\n`);
+          io.stderr.write(`pactive: cleanup warning: ${err?.message ?? err}\n`);
         }
       }
       const stateRoot = await resolveStateRoot(env, []);
       const residue = removeStateResidue(stateRoot);
       if (residue.length > 0) {
-        io.stderr.write(`acti: residue left in ${stateRoot}: ${residue.join(', ')}\n`);
+        io.stderr.write(`pactive: residue left in ${stateRoot}: ${residue.join(', ')}\n`);
         return 1;
       }
     }
 
-    io.stderr.write(`acti: ${action} ${host} ok (${pkgRoot})\n`);
+    io.stderr.write(`pactive: ${action} ${host} ok (${pkgRoot})\n`);
     return 0;
   });
 }
@@ -361,7 +361,7 @@ function runHost(host, userArgs, env, io) {
     const exec = mod.resolveExec({ env });
     const pkgRoot = resolvePkgRoot(env);
     const argv = mod.buildArgv({ pkgRoot, userArgs });
-    io.stderr.write(`acti: launching ${host} (${exec})\n`);
+    io.stderr.write(`pactive: launching ${host} (${exec})\n`);
     return new Promise((resolve) => {
       const child = spawn(exec, argv, { stdio: 'inherit', env });
       const forward = (sig) => {
@@ -370,7 +370,7 @@ function runHost(host, userArgs, env, io) {
       process.on('SIGINT', forward);
       process.on('SIGTERM', forward);
       child.on('error', (err) => {
-        io.stderr.write(`acti: failed to launch ${host}: ${err.message}\n`);
+        io.stderr.write(`pactive: failed to launch ${host}: ${err.message}\n`);
         resolve(err.code === 'ENOENT' ? 127 : 1);
       });
       child.on('exit', (code, signal) => {
@@ -392,7 +392,7 @@ export async function main(argv, env = process.env, io = { stdout: process.stdou
   switch (cmd) {
     case '--version':
     case '-v':
-      io.stdout.write(`${actiVersion()}\n`);
+      io.stdout.write(`${pactiveVersion()}\n`);
       return 0;
     case '--help':
     case '-h':
@@ -432,8 +432,8 @@ if (isMain) {
   try {
     process.exitCode = await main(process.argv, process.env, { stdout: process.stdout, stderr: process.stderr });
   } catch (err) {
-    const exitCode = err instanceof ActiError ? err.exitCode : 1;
-    process.stderr.write(`acti: ${err?.message ?? err}\n`);
+    const exitCode = err instanceof PactiveError ? err.exitCode : 1;
+    process.stderr.write(`pactive: ${err?.message ?? err}\n`);
     process.exitCode = exitCode;
   }
 }

package/commands/pactive.md

@@ -0,0 +1,46 @@
+---
+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`
+
+裸名（`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` |
+
+## 硬规则
+
+1. **不要替用户改配置**：pactive 的开关与配置是人工闸门（CLI `--confirm`）。用户要求改配置时，
+   告诉他用 `pactive config set … --confirm`，不要自行绕过。
+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: {}