@shgroup/opencode-serenity-plugin 0.2.2 → 0.3.0

package/README.md

@@ -1,199 +1,127 @@
 # @shgroup/opencode-serenity-plugin
 
-> **v0.2.0** — Serenity 认知基础设施的 [OpenCode](https://github.com/open-code-ai/opencode) 平台插件层。
+> **Serenity（宁静号）** — 为 OpenCode Agent 提供受控工作空间的插件。
 >
-> 提供 MSM 工具调用框架（`msm_list` / `msm_exec` / `msm_admin`）、
-> 安全文件系统操作（`file_system`）、会话管理（`session_tool`），
-> 以及 TUI slash command（`/serenity-init`、bash 开关）。
->
-> 源码：[github.com/tellmewhattodo/opencode-serenity-plugin](https://github.com/tellmewhattodo/opencode-serenity-plugin)
+> 安装后，Agent 自动获得安全文件操作、可审计命令执行、工作会话追踪等能力。
+> 所有这些能力被限定在一个有明确边界的"认知容器"内——根内自由，根外隔离。
 
 ---
 
-## 安装
-
-### 前置条件
+## 这是什么
 
-| 条件 | 要求 |
-|------|------|
-| Node.js | >= 20 |
-| 包管理器 | pnpm |
-| OpenCode 版本 | >= 1.16 |
+Serenity 是一个 [OpenCode](https://github.com/open-code-ai/opencode) 平台插件。它的核心资产是**认知容器**（Cognitive Container）：
 
-### 标准安装（推荐）
+| 概念 | 是什么 | 怎么用 |
+|------|--------|--------|
+| 认知容器 | 一个 `.serenity` 标记的 git 目录。Agent 在该目录内拥有受控的工作权限。 | 每个项目创建一个。`home-serenity/` 是家庭管理用，`my-project-serenity/` 是开发用。 |
+| 本插件 | 认知容器的"蓝图"。定义了容器有什么能力、遵守什么约束。 | `npm install` + `install`，一次配置，所有容器共用。 |
 
-```bash
-npm install @shgroup/opencode-serenity-plugin
-npx opencode-serenity-plugin install
-```
-
-### 从源码构建（贡献者用）
-
-```bash
-git clone git@github.com:tellmewhattodo/opencode-serenity-plugin.git
-cd opencode-serenity-plugin
-pnpm install
-pnpm build
-npx opencode-serenity-plugin install
-```
+类比：插件是操作系统，认知容器是用户目录——装一次 OS，在各个目录下工作。
 
-`install` 命令的结果：
+### 为什么需要认知容器
 
-| 配置目标 | 写入位置 | 作用 |
-|---------|----------|------|
-| 项目级 | 当前目录 `opencode.json` | 注册 5 个自定义工具（`msm_list` / `msm_exec` / `msm_admin` / `file_system` / `session_tool`） |
-| 全局级 | `~/.config/opencode/tui.json` | 注册 slash command（`/serenity-init`、`/serenity-bash-on/off/status`） |
+OpenCode Agent 原生的 `bash`、`read`、`edit`、`write` 可以访问整个文件系统。Serenity 加上一层边界：
 
-### 手动配置
+| 无 Serenity | 有 Serenity |
+|-------------|------------|
+| Agent 可以读写任何路径 | 读写限制在容器根内（P3 权限二分） |
+| `bash` 执行不可审计 | `msm_exec` 执行可追踪、可审查 |
+| 没有工作记录 | 每次多步工作自动创建 SESSION |
+| 没有上下文持久化 | SKILL.md 自动注入 Agent 对话 |
 
-当 `install` 命令不可用或不适用时，手动编辑：
+---
 
-```jsonc
-// opencode.json（项目根）
-{
-  "plugin": [
-    "file:///absolute/path/to/opencode-serenity-plugin/dist/index.js"
-  ]
-}
+## 三个硬约束
 
-// ~/.config/opencode/tui.json（全局，slash command 可见性）
-{
-  "plugin": [
-    "file:///absolute/path/to/opencode-serenity-plugin/dist/tui.js"
-  ]
-}
-```
+每个认知容器遵守三条原则，由插件自动执行：
 
-### 快速验证
+| # | 原则 | 含义 | 谁执行 |
+|---|------|------|--------|
+| P1 | **有根** | 容器有且仅有一个 `.serenity` 标记的根目录 | `file_system` 工具 |
+| P2 | **git 管** | 根目录必须在 git 管理下，所有变更可追溯 | 激活检查 + `msm_admin` 自动 commit |
+| P3 | **权限二分** | 根内完全读写，根外零权限 | `permission-guards` hook（RR5） |
 
-插件加载后在 opencode 中查询：
+---
 
-```
-msm_list
-```
+## 6 个工具
 
-期待输出包含以下注册项：
+安装后 Agent 获得以下工具，替代裸 bash 和原生文件操作：
 
-| 名称 | 技能 | 类别 | 描述 |
-|------|------|------|------|
-| `msm_list` | serenity-plugin | mech | List all available MSM |
-| `msm_exec` | serenity-plugin | mech | Execute a registered MSM |
-| `msm_admin` | serenity-plugin | mech | Register or deregister an MSM |
-| `file_system` | serenity-plugin | mech | Serenity file-system utility |
-| `session_tool` | serenity-plugin | semi-mech | Session lifecycle management |
+| 工具 | 作用 |
+|------|------|
+| `msm_list` | 查看当前容器已注册的可执行操作（MSM）。**任何 shell 操作前先调这个。** |
+| `msm_exec` | 容器唯一标准执行路径。替代裸 bash。自动注入 `SERENITY_ROOT` / `SERENITY_CCC` / `SERENITY_VERSION` 到子进程。 |
+| `msm_admin` | 向容器注册新的 MSM。注册表变更自动 git commit。 |
+| `file_system` | 安全文件操作。12 个子命令：`root` / `resolve` / `exists` / `list` / `tree` / `relative` / `mkdir` / `rm` / `mv` / `cp` / `touch` / `append`。写操作限定在容器根内。 |
+| `session_tool` | 工作会话全周期管理。`create` / `list` / `show` / `health` / `qa` / `archive` / `summary`。 |
+| `ccc_status` | 容器健康检查。验证 P1（`.serenity` 存在）、P2（git 仓库）、P3（`opencode.json` 配置完整）。 |
 
-### 开发期快速迭代
+---
 
-修改源码后不需要重复 clone：
+## 安装
 
 ```bash
-pnpm build                    # 仅编译
-npx opencode-serenity-plugin install   # 重新写入配置
-# 或使用 serenity-plugin-develop-kit MSM 自动执行 typecheck → test → build → install
+# 前置：Node >= 20，OpenCode >= 1.16
+npm install @shgroup/opencode-serenity-plugin
+npx opencode-serenity-plugin install
 ```
 
----
-
-## 功能清单
-
-### 5 个 OpenCode 自定义工具
-
-| 工具名 | 类别 | 职责 |
-|--------|------|------|
-| `msm_list` | mech | 查询 `mech-registry.json`，列出所有已注册 MSM 及其描述。`msm_exec` 的前置查询步骤。 |
-| `msm_exec` | mech | 执行已注册 MSM。参数 `msm_name` + `args: string[]`。替代裸 bash 的安全命令入口。 |
-| `msm_admin` | mech | 注册/注销 MSM。单 tool + `action` enum（`register` / `deregister`）。注册表变更自动 git commit。 |
-| `file_system` | mech | 安全文件系统操作。10 个子命令：`root` / `resolve` / `exists` / `list` / `relative` / `mkdir` / `rm` / `mv` / `cp` / `touch`。所有写操作限制在 `.serenity` 根目录内，保护 `.serenity` 标记文件和根目录自身不被删除。 |
-| `session_tool` | semi-mech | 会话生命周期管理。7 个子命令：`list` / `show` / `create` / `health` / `archive` / `summary` / `qa`。管理 `AGENT_SESSIONS/` 目录下的会话记录。 |
-
-### 系统 Hook
+`install` 写入两处配置：
 
-| Hook 名 | 执行时机 | 职责 |
-|---------|----------|------|
-| `tool.execute.before` | 每个工具调用前 | 路径守卫：`read`/`edit`/`write`/`grep`/`glob`/`webfetch` 的 `path` 参数强制在 `cwdRoot` 内（含 symlink 防御）。bash 静默拒绝开关：被禁用时 AI 收到 `"bash is disabled by user, use msm instead"`。 |
-| `experimental.chat.system.transform` | 新 session 首次激活 | 注入 `/.opencode/skills/<实例名>/SKILL.md` 全文到 system prompt 末尾。 |
-| `experimental.session.compacting` | 压缩事件 | 注入 serenity 关键状态（实例名、路径、激活状态）。 |
-| `experimental.tool.definition` | 工具定义阶段 | 向 `task` 工具描述注入精简 serenity context（使 subagent 也能感知 serenity 环境）。 |
-| `shell.env` | shell 执行前 | 注入环境变量 `HOME_SERENITY_ROOT`（实例根路径）、`SERENITY_INSTANCE`（实例名）。 |
-| `event: permission.asked` | 权限弹窗触发时 | cwdRoot 内文件操作自动回复 `always`。 |
-
-### TUI Slash Command
-
-| 命令 | 作用 |
-|------|------|
-| `/serenity-init` | 将当前 git 仓库初始化为 serenity 实例：创建 `/.serenity` + `git commit -m "chore: initialize serenity (instance: <name>)"`。 |
-| `/serenity-bash-on` | 启用 bash 工具。 |
-| `/serenity-bash-off` | 禁用 bash 工具。AI 对 bash 的任何调用收到 `"bash is disabled by user, use msm instead"` 错误。 |
-| `/serenity-bash-status` | 显示当前 bash 启用/禁用状态。 |
+| 目标 | 路径 | 作用 |
+|------|------|------|
+| 项目级 | 当前目录 `opencode.json` | 注册 6 个工具 |
+| 全局级 | `~/.config/opencode/tui.json` | 注册 `/serenity-init` slash command |
 
 ---
 
-## 开发指南
-
-### 标准开发循环
+## 创建认知容器
 
 ```bash
-pnpm typecheck             # 编译检查，零 LLM 推理
-pnpm test                  # 执行全部 382 个测试（vitest）
-pnpm build                 # 编译到 dist/
-pnpm opencode-serenity-plugin install   # 安装到当前 project
-```
+# 1. 进入 git 管理的目录
+mkdir my-project && cd my-project && git init
 
-推荐使用 `serenity-plugin-develop-kit` MSM 工具自动执行上述 4 步（typecheck → test → build → install），遇非零即停，提供完整审计可追溯性。
+# 2. 在 OpenCode 中输入
+/serenity-init
+```
 
-### 测试架构
+TUI 会询问容器前缀（如 `my-project`）和一句话描述。确认后自动创建：
 
-```bash
-pnpm test                          # 全部 382 个测试
-pnpm test -- --watch               # 监视模式
-pnpm test tests/msm.test.ts        # 单文件测试
+```
+my-project-serenity/
+├── .serenity                ← 容器标记文件
+├── AGENT_SESSIONS/           ← 工作会话记录
+├── .opencode/skills/
+│   └── my-project-serenity/
+│       ├── SKILL.md          ← 容器主入口文档
+│       └── references/
+│           └── mech-registry.json
 ```
 
-测试文件按模块分组于 `tests/`：
+初始化后立即可用：
 
-| 文件 | 用例数 | 覆盖范围 |
-|------|--------|---------|
-| `tests/msm.test.ts` | — | MSM 工具（list/exec/admin） |
-| `tests/fs-file-system-tool.test.ts` | 40 | 全部 10 个文件系统子命令 + 安全边界 |
-| `tests/util-*.test.ts` | — | 各 util 函数（init / serenity-file / log 等） |
-| `tests/session-*.test.ts` | — | 会话管理各子命令 |
-| `tests/hooks/*.test.ts` | — | Hook 行为（permission-guards / compacting / 
-tool-definition / auto-reply） |
-| `tests/tui*.test.ts` | — | TUI slash command |
-| `tests/errors.test.ts` | — | 错误类层级 |
+```
+msm_list                    # 查看已注册 MSM
+ccc_status                  # 验证容器健康状态
+session_tool create --desc "my-first-task"
+file_system tree --path src/
+```
 
 ---
 
-## 架构模型：Template-Instance
+## 概念模型（深入阅读）
+
+如果你关心"为什么这样设计"，Serenity 的底层模型是 **ACC/CCC 分层**：
 
 ```
-opencode-serenity-plugin     ← template（持久源，source of truth）
-         ↓ build + install
-serenity 实例目录（如 home-serenity/） ← instance（可重建的下游 artifact）
+ACC (Abstract Cognitive Container)  →  本插件（持久源，定义"什么是容器"）
+  └── CCC (Concrete Cognitive Container)  →  每个 `xxx-serenity/` 目录（可操作实例，可从 ACC 重建）
 ```
 
-| 角色 | 特征 |
-|------|------|
-| **template**（plugin 仓） | durable，不可替代，GitHub 发布源 |
-| **instance**（serenity 目录） | replicable，可删除后重新 build + install |
-| **关系** | 单向模板→实例。不存在"双真源防漂移"。修改 plugin 后必须重新 build + install。 |
-
----
-
-## 关联文档
+关系：ACC 是蓝图，CCC 是建筑。修改插件（ACC） → build + install → 所有 CCC 自动获得新能力。
 
-| 主题 | 文档路径 |
-|------|---------|
-| 范围层（RR1-RR7，终版） | [`docs/requirements-v0-scope.md`](docs/requirements-v0-scope.md) |
-| 架构设计（两阶段 init + 模块分解） | [`docs/architecture-v0.md`](docs/architecture-v0.md) |
-| 接口契约（6 契约 + 13 错误类） | [`docs/contract-v0.md`](docs/contract-v0.md) |
-| RR7 Init 实施记录 | [`docs/rr7-init-design.md`](docs/rr7-init-design.md) |
-| 重构方向（v1.11-v1.17） | [`docs/refactor-direction-v1.11.md`](docs/refactor-direction-v1.11.md) |
-| v0.1 候选实施（3/3 实施） | [`docs/v0.1-candidates.md`](docs/v0.1-candidates.md) |
-| MSM 自包含 RFC（S028） | [`docs/plugin-self-contained-msm-v1.md`](docs/plugin-self-contained-msm-v1.md) |
-| 设计方案索引（S031） | `AGENT_SESSIONS/2026-05-17--S031--plugin-next-round-requirements/SESSION.md` |
+日常使用时不需要这些术语——"Serenity" 或"认知容器"就够了。
 
 ---
 
-> **版本**: v0.1.0 (2026-06-15)
-> **作者**: yh + 宁静号 Agent
+**版本**: v0.2.2

package/dist/activation.js

@@ -60,9 +60,9 @@ export function tryActivateSync(input, getClient) {
  */
 async function activateAsync(cwdRoot, getClient) {
     // RR1 — 读 /.serenity
-    let instanceName;
+    let cccName;
     try {
-        instanceName = readSerenityFile(cwdRoot);
+        cccName = readSerenityFile(cwdRoot);
     }
     catch (err) {
         const detail = err instanceof Error ? err.message : String(err);
@@ -71,8 +71,8 @@ async function activateAsync(cwdRoot, getClient) {
     // RR2 — 验证 SKILL.md
     let skillPath;
     try {
-        skillPath = buildSkillPath(cwdRoot, instanceName);
-        validateSkillExists(skillPath, cwdRoot, instanceName);
+        skillPath = buildSkillPath(cwdRoot, cccName);
+        validateSkillExists(skillPath, cwdRoot, cccName);
     }
     catch (err) {
         const detail = err instanceof Error ? err.message : String(err);
@@ -93,7 +93,7 @@ async function activateAsync(cwdRoot, getClient) {
     const state = Object.freeze({
         activated: true,
         cwdRoot,
-        instanceName,
+        cccName,
         skillPath,
         skillContent,
     });
@@ -101,7 +101,7 @@ async function activateAsync(cwdRoot, getClient) {
     markReady();
     // v1.5 init-check：plugin 启动时自检 opencode.json 关键配置
     // 只 warn，不 patch
-    checkSerenityConfig(cwdRoot, instanceName);
+    checkSerenityConfig(cwdRoot, cccName);
     // v1.7 config-patch：自动改主仓 opencode.json 让 cwdRoot 内 read/edit = allow
     // 用户 m0649 决定"全自动"——plugin 启动即生效（用户需重启 opencode 应用改动）
     if (getClient) {

package/dist/activation.js.map

@@ -1 +1 @@
-{"version":3,"file":"activation.js","sourceRoot":"","sources":["../src/activation.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"activation.js","sourceRoot":"","sources":["../src/activation.ts"],"names":[],"mappings":"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"}

package/dist/ccc-status.d.ts

@@ -0,0 +1,13 @@
+/**
+ * ccc-status.ts — CCC status check tool (v0.3)
+ *
+ * Validates the three CCC principles:
+ *   P1: .serenity file exists and is non-empty
+ *   P2: root is inside a git repository
+ *   P3: opencode.json plugin configuration is present
+ *
+ * Output is a JSON status report.
+ */
+import { type ToolDefinition } from '@opencode-ai/plugin';
+export declare const cccStatusTool: ToolDefinition;
+//# sourceMappingURL=ccc-status.d.ts.map

package/dist/ccc-status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ccc-status.d.ts","sourceRoot":"","sources":["../src/ccc-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAOhE,eAAO,MAAM,aAAa,EAAE,cA0D1B,CAAC"}

package/dist/ccc-status.js

@@ -0,0 +1,70 @@
+/**
+ * ccc-status.ts — CCC status check tool (v0.3)
+ *
+ * Validates the three CCC principles:
+ *   P1: .serenity file exists and is non-empty
+ *   P2: root is inside a git repository
+ *   P3: opencode.json plugin configuration is present
+ *
+ * Output is a JSON status report.
+ */
+import { existsSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { tool } from '@opencode-ai/plugin';
+import { findSerenityRoot } from './fs/resolve-path.js';
+import { getState, ensureReady } from './state.js';
+import pkg from '../package.json' with { type: 'json' };
+const VERSION = pkg.version;
+export const cccStatusTool = tool({
+    description: `CCC status health check (v${VERSION}). Validates three CCC principles: ` +
+        'P1 (rooted — .serenity exists), P2 (git-managed), P3 (binary permissions — opencode.json present). ' +
+        'Returns a JSON status report with pass/fail per principle.',
+    args: {},
+    execute: async (_input, ctx) => {
+        await ensureReady();
+        const state = getState();
+        const root = findSerenityRoot(ctx.directory);
+        // P1: .serenity file exists and is non-empty
+        const serenityPath = resolve(root, '.serenity');
+        const p1Pass = existsSync(serenityPath);
+        // Note: .serenity content is already validated during activation
+        // P2: git-managed — the state.activated implies git check passed
+        // (RR6 in activation.ts verifies git repo)
+        const p2Pass = state.activated;
+        // P3: opencode.json with plugin config
+        const opencodeJsonPath = resolve(root, 'opencode.json');
+        let p3Pass = false;
+        let p3Detail = '';
+        if (existsSync(opencodeJsonPath)) {
+            // Simple check: file exists. Full parse is done by activation.
+            p3Pass = true;
+            p3Detail = 'opencode.json found';
+        }
+        else {
+            p3Detail = 'opencode.json not found at CCC root';
+        }
+        const allPass = p1Pass && p2Pass && p3Pass;
+        const report = {
+            ccc: state.cccName,
+            root,
+            version: VERSION,
+            status: allPass ? 'healthy' : 'degraded',
+            principles: {
+                P1_rooted: {
+                    pass: p1Pass,
+                    detail: p1Pass ? '.serenity marker found' : '.serenity marker missing',
+                },
+                P2_git_managed: {
+                    pass: p2Pass,
+                    detail: p2Pass ? 'git repository verified' : 'not in a git repository',
+                },
+                P3_binary_permissions: {
+                    pass: p3Pass,
+                    detail: p3Detail,
+                },
+            },
+        };
+        return JSON.stringify(report, null, 2);
+    },
+});
+//# sourceMappingURL=ccc-status.js.map

package/dist/ccc-status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ccc-status.js","sourceRoot":"","sources":["../src/ccc-status.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,IAAI,EAAuB,MAAM,qBAAqB,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,GAAG,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAExD,MAAM,OAAO,GAAG,GAAG,CAAC,OAAO,CAAC;AAE5B,MAAM,CAAC,MAAM,aAAa,GAAmB,IAAI,CAAC;IAChD,WAAW,EACT,6BAA6B,OAAO,qCAAqC;QACzE,qGAAqG;QACrG,4DAA4D;IAC9D,IAAI,EAAE,EAAE;IACR,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE;QAC7B,MAAM,WAAW,EAAE,CAAC;QACpB,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;QAEzB,MAAM,IAAI,GAAG,gBAAgB,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAE7C,6CAA6C;QAC7C,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;QACxC,iEAAiE;QAEjE,iEAAiE;QACjE,2CAA2C;QAC3C,MAAM,MAAM,GAAG,KAAK,CAAC,SAAS,CAAC;QAE/B,uCAAuC;QACvC,MAAM,gBAAgB,GAAG,OAAO,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;QACxD,IAAI,MAAM,GAAG,KAAK,CAAC;QACnB,IAAI,QAAQ,GAAG,EAAE,CAAC;QAClB,IAAI,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;YACjC,+DAA+D;YAC/D,MAAM,GAAG,IAAI,CAAC;YACd,QAAQ,GAAG,qBAAqB,CAAC;QACnC,CAAC;aAAM,CAAC;YACN,QAAQ,GAAG,qCAAqC,CAAC;QACnD,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,IAAI,MAAM,IAAI,MAAM,CAAC;QAE3C,MAAM,MAAM,GAAG;YACb,GAAG,EAAE,KAAK,CAAC,OAAO;YAClB,IAAI;YACJ,OAAO,EAAE,OAAO;YAChB,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU;YACxC,UAAU,EAAE;gBACV,SAAS,EAAE;oBACT,IAAI,EAAE,MAAM;oBACZ,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,0BAA0B;iBACvE;gBACD,cAAc,EAAE;oBACd,IAAI,EAAE,MAAM;oBACZ,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,yBAAyB;iBACvE;gBACD,qBAAqB,EAAE;oBACrB,IAAI,EAAE,MAAM;oBACZ,MAAM,EAAE,QAAQ;iBACjB;aACF;SACF,CAAC;QAEF,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACzC,CAAC;CACF,CAAC,CAAC"}

package/dist/config-schema.d.ts

@@ -253,8 +253,8 @@ export declare const pluginConfigSchema: z.ZodObject<{
     disabled_tools: z.ZodOptional<z.ZodArray<z.ZodString>>;
     disabled_msms: z.ZodOptional<z.ZodArray<z.ZodString>>;
     msm_exec_format: z.ZodOptional<z.ZodEnum<{
-        text: "text";
         json: "json";
+        text: "text";
     }>>;
     msm_exec_log: z.ZodOptional<z.ZodString>;
     msm_exec_timeout_ms: z.ZodOptional<z.ZodNumber>;

package/dist/errors.d.ts

@@ -26,9 +26,9 @@ export declare class SerenityFileNotFoundError extends SerenityError {
 export declare class SerenityFileEmptyError extends SerenityError {
     constructor(path: string);
 }
-/** RR2 违反：.opencode/skills/<instanceName>/SKILL.md 不存在 */
+/** RR2 违反：.opencode/skills/<cccName>/SKILL.md 不存在 */
 export declare class SkillNotFoundError extends SerenityError {
-    constructor(cwdRoot: string, instanceName: string);
+    constructor(cwdRoot: string, cccName: string);
 }
 /** msm_exec 失败：MSM 不在注册表中 */
 export declare class MsmNotRegisteredError extends SerenityError {
@@ -68,7 +68,7 @@ export declare class InitGitCommitError extends SerenityError {
     constructor(reason: string);
 }
 /** v1.10 RR7：用户输入的 prefix 不是 kebab-case */
-export declare class InvalidInstanceNameError extends SerenityError {
+export declare class InvalidCccNameError extends SerenityError {
     constructor(name: string);
 }
 /** msm_exec 失败：path-arg 解析为 cwdRoot 之外的路径（v0.1-2 path escape guard）*/

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,kCAAkC;AAClC,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;CAI5B;AAED,+BAA+B;AAC/B,qBAAa,iBAAkB,SAAQ,aAAa;gBACtC,GAAG,EAAE,MAAM;CAIxB;AAED,8BAA8B;AAC9B,qBAAa,yBAA0B,SAAQ,aAAa;gBAC9C,OAAO,EAAE,MAAM;CAI5B;AAED,8BAA8B;AAC9B,qBAAa,sBAAuB,SAAQ,aAAa;gBAC3C,IAAI,EAAE,MAAM;CAIzB;AAED,0DAA0D;AAC1D,qBAAa,kBAAmB,SAAQ,aAAa;gBACvC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM;CAIlD;AAED,6BAA6B;AAC7B,qBAAa,qBAAsB,SAAQ,aAAa;gBAC1C,OAAO,EAAE,MAAM;CAI5B;AAED,4BAA4B;AAC5B,qBAAa,eAAgB,SAAQ,aAAa;gBACpC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAI/C;AAED,gCAAgC;AAChC,qBAAa,yBAA0B,SAAQ,aAAa;gBAC9C,OAAO,EAAE,MAAM;CAI5B;AAED,sCAAsC;AACtC,qBAAa,sBAAuB,SAAQ,aAAa;gBAC3C,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAIhD;AAED,yCAAyC;AACzC,qBAAa,qBAAsB,SAAQ,aAAa;gBAC1C,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;GAMG;AACH,qBAAa,iBAAkB,SAAQ,aAAa;IAClD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBACd,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAW9E;AAED,+CAA+C;AAC/C,qBAAa,kBAAmB,SAAQ,aAAa;gBACvC,MAAM,EAAE,MAAM;CAI3B;AAED,2CAA2C;AAC3C,qBAAa,wBAAyB,SAAQ,aAAa;gBAC7C,IAAI,EAAE,MAAM;CAOzB;AAED,sEAAsE;AACtE,qBAAa,kBAAmB,SAAQ,aAAa;gBACvC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAO9E;AAED,kEAAkE;AAClE,qBAAa,eAAgB,SAAQ,aAAa;gBACpC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAO9F;AAED,iCAAiC;AACjC,qBAAa,eAAgB,SAAQ,aAAa;gBACpC,OAAO,EAAE,MAAM;CAI5B;AAED,6BAA6B;AAC7B,qBAAa,YAAa,SAAQ,aAAa;gBACjC,OAAO,EAAE,MAAM;CAI5B"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,kCAAkC;AAClC,qBAAa,aAAc,SAAQ,KAAK;gBAC1B,OAAO,EAAE,MAAM;CAI5B;AAED,+BAA+B;AAC/B,qBAAa,iBAAkB,SAAQ,aAAa;gBACtC,GAAG,EAAE,MAAM;CAIxB;AAED,8BAA8B;AAC9B,qBAAa,yBAA0B,SAAQ,aAAa;gBAC9C,OAAO,EAAE,MAAM;CAI5B;AAED,8BAA8B;AAC9B,qBAAa,sBAAuB,SAAQ,aAAa;gBAC3C,IAAI,EAAE,MAAM;CAIzB;AAED,qDAAqD;AACrD,qBAAa,kBAAmB,SAAQ,aAAa;gBACvC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI7C;AAED,6BAA6B;AAC7B,qBAAa,qBAAsB,SAAQ,aAAa;gBAC1C,OAAO,EAAE,MAAM;CAI5B;AAED,4BAA4B;AAC5B,qBAAa,eAAgB,SAAQ,aAAa;gBACpC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;CAI/C;AAED,gCAAgC;AAChC,qBAAa,yBAA0B,SAAQ,aAAa;gBAC9C,OAAO,EAAE,MAAM;CAI5B;AAED,sCAAsC;AACtC,qBAAa,sBAAuB,SAAQ,aAAa;gBAC3C,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM;CAIhD;AAED,yCAAyC;AACzC,qBAAa,qBAAsB,SAAQ,aAAa;gBAC1C,OAAO,EAAE,MAAM;CAI5B;AAED;;;;;;GAMG;AACH,qBAAa,iBAAkB,SAAQ,aAAa;IAClD,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBACd,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAW9E;AAED,+CAA+C;AAC/C,qBAAa,kBAAmB,SAAQ,aAAa;gBACvC,MAAM,EAAE,MAAM;CAI3B;AAED,2CAA2C;AAC3C,qBAAa,mBAAoB,SAAQ,aAAa;gBACxC,IAAI,EAAE,MAAM;CAOzB;AAED,sEAAsE;AACtE,qBAAa,kBAAmB,SAAQ,aAAa;gBACvC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAO9E;AAED,kEAAkE;AAClE,qBAAa,eAAgB,SAAQ,aAAa;gBACpC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAO9F;AAED,iCAAiC;AACjC,qBAAa,eAAgB,SAAQ,aAAa;gBACpC,OAAO,EAAE,MAAM;CAI5B;AAED,6BAA6B;AAC7B,qBAAa,YAAa,SAAQ,aAAa;gBACjC,OAAO,EAAE,MAAM;CAI5B"}

package/dist/errors.js

@@ -34,14 +34,14 @@ export class SerenityFileNotFoundError extends SerenityError {
 /** /.serenity 文件存在但内容为空或无效 */
 export class SerenityFileEmptyError extends SerenityError {
     constructor(path) {
-        super(`/.serenity file at "${path}" is empty or contains only whitespace; expected a non-empty instance name`);
+        super(`/.serenity file at "${path}" is empty or contains only whitespace; expected a non-empty CCC name`);
         this.name = 'SerenityFileEmptyError';
     }
 }
-/** RR2 违反：.opencode/skills/<instanceName>/SKILL.md 不存在 */
+/** RR2 违反：.opencode/skills/<cccName>/SKILL.md 不存在 */
 export class SkillNotFoundError extends SerenityError {
-    constructor(cwdRoot, instanceName) {
-        super(`SKILL.md not found at "${cwdRoot}/.opencode/skills/${instanceName}/SKILL.md"; serenity plugin requires RR2 (the instance skill must exist)`);
+    constructor(cwdRoot, cccName) {
+        super(`SKILL.md not found at "${cwdRoot}/.opencode/skills/${cccName}/SKILL.md"; serenity plugin requires RR2 (the CCC skill must exist)`);
         this.name = 'SkillNotFoundError';
     }
 }
@@ -111,11 +111,11 @@ export class InitGitCommitError extends SerenityError {
     }
 }
 /** v1.10 RR7：用户输入的 prefix 不是 kebab-case */
-export class InvalidInstanceNameError extends SerenityError {
+export class InvalidCccNameError extends SerenityError {
     constructor(name) {
-        super(`Invalid serenity prefix "${name}"; must be kebab-case ` +
+        super(`Invalid CCC prefix "${name}"; must be kebab-case ` +
             `(lowercase a-z, 0-9, dashes; no leading or trailing dash)`);
-        this.name = 'InvalidInstanceNameError';
+        this.name = 'InvalidCccNameError';
     }
 }
 /** msm_exec 失败：path-arg 解析为 cwdRoot 之外的路径（v0.1-2 path escape guard）*/

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,kCAAkC;AAClC,MAAM,OAAO,aAAc,SAAQ,KAAK;IACtC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,+BAA+B;AAC/B,MAAM,OAAO,iBAAkB,SAAQ,aAAa;IAClD,YAAY,GAAW;QACrB,KAAK,CAAC,QAAQ,GAAG,4FAA4F,CAAC,CAAC;QAC/G,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED,8BAA8B;AAC9B,MAAM,OAAO,yBAA0B,SAAQ,aAAa;IAC1D,YAAY,OAAe;QACzB,KAAK,CAAC,iCAAiC,OAAO,qEAAqE,CAAC,CAAC;QACrH,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAED,8BAA8B;AAC9B,MAAM,OAAO,sBAAuB,SAAQ,aAAa;IACvD,YAAY,IAAY;QACtB,KAAK,CAAC,uBAAuB,IAAI,4EAA4E,CAAC,CAAC;QAC/G,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,0DAA0D;AAC1D,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IACnD,YAAY,OAAe,EAAE,YAAoB;QAC/C,KAAK,CAAC,0BAA0B,OAAO,qBAAqB,YAAY,0EAA0E,CAAC,CAAC;QACpJ,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,6BAA6B;AAC7B,MAAM,OAAO,qBAAsB,SAAQ,aAAa;IACtD,YAAY,OAAe;QACzB,KAAK,CAAC,QAAQ,OAAO,kFAAkF,CAAC,CAAC;QACzG,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED,4BAA4B;AAC5B,MAAM,OAAO,eAAgB,SAAQ,aAAa;IAChD,YAAY,OAAe,EAAE,SAAiB;QAC5C,KAAK,CAAC,QAAQ,OAAO,qBAAqB,SAAS,IAAI,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,gCAAgC;AAChC,MAAM,OAAO,yBAA0B,SAAQ,aAAa;IAC1D,YAAY,OAAe;QACzB,KAAK,CAAC,QAAQ,OAAO,wFAAwF,CAAC,CAAC;QAC/G,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAED,sCAAsC;AACtC,MAAM,OAAO,sBAAuB,SAAQ,aAAa;IACvD,YAAY,OAAe,EAAE,UAAkB;QAC7C,KAAK,CAAC,QAAQ,OAAO,0BAA0B,UAAU,yEAAyE,CAAC,CAAC;QACpI,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AAED,yCAAyC;AACzC,MAAM,OAAO,qBAAsB,SAAQ,aAAa;IACtD,YAAY,OAAe;QACzB,KAAK,CAAC,QAAQ,OAAO,uDAAuD,CAAC,CAAC;QAC9E,IAAI,CAAC,IAAI,GAAG,uBAAuB,CAAC;IACtC,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,iBAAkB,SAAQ,aAAa;IACzC,MAAM,CAAS;IACf,MAAM,CAAS;IACf,QAAQ,CAAS;IAC1B,YAAY,OAAe,EAAE,QAAgB,EAAE,MAAc,EAAE,MAAc;QAC3E,MAAM,aAAa,GAAG,MAAM,CAAC,CAAC,CAAC;UACzB,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACnC,MAAM,aAAa,GAAG,MAAM,CAAC,CAAC,CAAC;UACzB,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClC,KAAK,CAAC,QAAQ,OAAO,2BAA2B,QAAQ,GAAG,aAAa,GAAG,aAAa,EAAE,CAAC,CAAC;QAC5F,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,+CAA+C;AAC/C,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IACnD,YAAY,MAAc;QACxB,KAAK,CAAC,0CAA0C,MAAM,EAAE,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,2CAA2C;AAC3C,MAAM,OAAO,wBAAyB,SAAQ,aAAa;IACzD,YAAY,IAAY;QACtB,KAAK,CACH,4BAA4B,IAAI,wBAAwB;YACxD,2DAA2D,CAC5D,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF;AAED,sEAAsE;AACtE,MAAM,OAAO,kBAAmB,SAAQ,aAAa;IACnD,YAAY,OAAe,EAAE,OAAe,EAAE,KAAa,EAAE,QAAgB;QAC3E,KAAK,CACH,QAAQ,OAAO,eAAe,OAAO,MAAM,KAAK,kBAAkB,QAAQ,IAAI;YAC9E,4FAA4F,CAC7F,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AAED,kEAAkE;AAClE,MAAM,OAAO,eAAgB,SAAQ,aAAa;IAChD,YAAY,OAAe,EAAE,OAAe,EAAE,KAAa,EAAE,QAAgB,EAAE,MAAc;QAC3F,KAAK,CACH,QAAQ,OAAO,eAAe,OAAO,MAAM,KAAK,QAAQ,QAAQ,MAAM,MAAM,IAAI;YAChF,6DAA6D,CAC9D,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,iCAAiC;AACjC,MAAM,OAAO,eAAgB,SAAQ,aAAa;IAChD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,6BAA6B;AAC7B,MAAM,OAAO,YAAa,SAAQ,aAAa;IAC7C,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/fs/file-system-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-system-tool.d.ts","sourceRoot":"","sources":["../../src/fs/file-system-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AASH,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAsFhE,eAAO,MAAM,cAAc,EAAE,cA4Q3B,CAAC"}
+{"version":3,"file":"file-system-tool.d.ts","sourceRoot":"","sources":["../../src/fs/file-system-tool.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AASH,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAsFhE,eAAO,MAAM,cAAc,EAAE,cA4W3B,CAAC"}