@shgroup/opencode-serenity-plugin 0.2.0

package/README.md

@@ -0,0 +1,199 @@
+# @shgroup/opencode-serenity-plugin
+
+> **v0.2.0** — Serenity 认知基础设施的 [OpenCode](https://github.com/open-code-ai/opencode) 平台插件层。
+>
+> 提供 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)
+
+---
+
+## 安装
+
+### 前置条件
+
+| 条件 | 要求 |
+|------|------|
+| Node.js | >= 20 |
+| 包管理器 | pnpm |
+| OpenCode 版本 | >= 1.16 |
+
+### 标准安装（推荐）
+
+```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
+```
+
+`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`） |
+
+### 手动配置
+
+当 `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"
+  ]
+}
+```
+
+### 快速验证
+
+插件加载后在 opencode 中查询：
+
+```
+msm_list
+```
+
+期待输出包含以下注册项：
+
+| 名称 | 技能 | 类别 | 描述 |
+|------|------|------|------|
+| `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 |
+
+### 开发期快速迭代
+
+修改源码后不需要重复 clone：
+
+```bash
+pnpm build                    # 仅编译
+npx opencode-serenity-plugin install   # 重新写入配置
+# 或使用 serenity-plugin-develop-kit MSM 自动执行 typecheck → test → build → 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
+
+| 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 启用/禁用状态。 |
+
+---
+
+## 开发指南
+
+### 标准开发循环
+
+```bash
+pnpm typecheck             # 编译检查，零 LLM 推理
+pnpm test                  # 执行全部 382 个测试（vitest）
+pnpm build                 # 编译到 dist/
+pnpm opencode-serenity-plugin install   # 安装到当前 project
+```
+
+推荐使用 `serenity-plugin-develop-kit` MSM 工具自动执行上述 4 步（typecheck → test → build → install），遇非零即停，提供完整审计可追溯性。
+
+### 测试架构
+
+```bash
+pnpm test                          # 全部 382 个测试
+pnpm test -- --watch               # 监视模式
+pnpm test tests/msm.test.ts        # 单文件测试
+```
+
+测试文件按模块分组于 `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` | — | 错误类层级 |
+
+---
+
+## 架构模型：Template-Instance
+
+```
+opencode-serenity-plugin     ← template（持久源，source of truth）
+         ↓ build + install
+serenity 实例目录（如 home-serenity/） ← instance（可重建的下游 artifact）
+```
+
+| 角色 | 特征 |
+|------|------|
+| **template**（plugin 仓） | durable，不可替代，GitHub 发布源 |
+| **instance**（serenity 目录） | replicable，可删除后重新 build + install |
+| **关系** | 单向模板→实例。不存在"双真源防漂移"。修改 plugin 后必须重新 build + install。 |
+
+---
+
+## 关联文档
+
+| 主题 | 文档路径 |
+|------|---------|
+| 范围层（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` |
+
+---
+
+> **版本**: v0.1.0 (2026-06-15)
+> **作者**: yh + 宁静号 Agent

package/bin/opencode-serenity-plugin.js

@@ -0,0 +1,316 @@
+#!/usr/bin/env node
+/**
+ * opencode-serenity-plugin CLI (v1.11 → v0.0.4 全局化)
+ *
+ * Usage:
+ *   opencode-serenity-plugin install [flags]
+ *
+ * Flags:
+ *   --dry-run    Print what would be done without writing
+ *   --verbose    Show detailed output (default: silent on no-op success)
+ *   --help       Show this help
+ *   --version    Show version
+ *
+ * Exit codes:
+ *   0  Success (including no-op when already installed)
+ *   1  Hard error (permission denied, dist/ not built, etc.)
+ *   2  Conflict: plugin already installed at a different path
+ *
+ * Notes:
+ * - 逻辑层在 ../dist/install.js (来自 src/install.ts)。
+ *   跑 install 前必须 `pnpm build` (或 `npm run build`)。
+ * - v0.0.4: 两个 entry (server + TUI) 都装到全局 config:
+ *   - dist/index.js → ~/.config/opencode/opencode.json#plugin
+ *   - dist/tui.js   → ~/.config/opencode/tui.json#plugin
+ * - 所有目录下 opencode 都加载两个 entry,由 tryActivateSync 判断是否激活。
+ *   (之前 server entry 装项目级 opencode.json, 非 serenity 目录不加载 server)
+ */
+
+import { fileURLToPath } from 'node:url';
+import { dirname, resolve } from 'node:path';
+import { existsSync, readFileSync } from 'node:fs';
+import {
+  resolvePluginEntries,
+  resolveInstallPathFromBin,
+  getGlobalConfigPath,
+  writePluginEntry,
+} from '../dist/install.js';
+import { installSkill } from '../dist/skills/install-skill.js';
+import { initWizard } from '../dist/init/init-wizard.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const INSTALL_PATH = resolveInstallPathFromBin(__filename);
+
+// ── CLI 解析 (轻量,无 yargs 依赖) ──
+
+function parseArgs(argv) {
+  const flags = {
+    command: null,
+    /** skill name for install-skill, or target path for init */
+    skillName: null,
+    prefix: null,
+    /** flag for non-interactive init */
+    nonInteractive: false,
+    /** flag for force overwrite */
+    force: false,
+    global: false,
+    dryRun: false,
+    verbose: false,
+    help: false,
+    version: false,
+  };
+  let expectPrefix = false;
+  for (let i = 0; i < argv.length; i++) {
+    const arg = argv[i];
+
+    // handle --prefix <value> (consumes next arg)
+    if (expectPrefix) {
+      flags.prefix = arg;
+      expectPrefix = false;
+      continue;
+    }
+
+    switch (arg) {
+      case 'init':
+        flags.command = 'init';
+        // next arg is the target path (optional)
+        if (i + 1 < argv.length && !argv[i + 1].startsWith('--')) {
+          flags.skillName = argv[++i];
+        }
+        break;
+      case 'install': flags.command = 'install'; break;
+      case 'install-skill':
+        flags.command = 'install-skill';
+        // next arg is the skill name
+        if (i + 1 < argv.length && !argv[i + 1].startsWith('--')) {
+          flags.skillName = argv[++i];
+        }
+        break;
+      case 'uninstall': flags.command = 'uninstall'; break;
+      case '--global': flags.global = true; break;
+      case '--dry-run': flags.dryRun = true; break;
+      case '--verbose': case '-v': flags.verbose = true; break;
+      case '--non-interactive': flags.nonInteractive = true; break;
+      case '--force': flags.force = true; break;
+      case '--help': case '-h': flags.help = true; break;
+      case '--version': flags.version = true; break;
+      default:
+        if (arg.startsWith('--prefix=')) {
+          flags.prefix = arg.slice('--prefix='.length);
+        } else if (arg === '--prefix') {
+          expectPrefix = true;
+        } else if (arg.startsWith('--')) {
+          process.stderr.write(`error: unknown flag: ${arg}\n`);
+          process.exit(1);
+        }
+    }
+  }
+  return flags;
+}
+
+function readVersion() {
+  const pkgPath = resolve(INSTALL_PATH, 'package.json');
+  if (!existsSync(pkgPath)) return 'unknown';
+  try {
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
+    return pkg.version || 'unknown';
+  } catch {
+    return 'unknown';
+  }
+}
+
+function printHelp() {
+  const version = readVersion();
+  process.stdout.write(`opencode-serenity-plugin v${version}
+
+Usage:
+  opencode-serenity-plugin init [path] [flags]
+  opencode-serenity-plugin install [flags]
+  opencode-serenity-plugin install-skill <name> [flags]
+
+Commands:
+  init            Create a new serenity instance (interactive wizard)
+  install         Write server + TUI plugin entries to global opencode configs (idempotent)
+  install-skill   Install a domain skill from built-in templates into the current serenity instance
+
+  init [path]           Path for the new serenity instance (default: current directory)
+  install-skill <name>  Available skills vary by version
+
+Flags:
+  --prefix=<str>   Skill prefix (default: auto-detect from .serenity)
+  --non-interactive Skip interactive prompts (use defaults)
+  --force           Overwrite existing files
+  --dry-run        Print what would be done without writing
+  --verbose        Show detailed output
+  --help, -h       Show this help
+  --version        Print version and exit
+
+Exit codes:
+  0  Success
+  1  Hard error
+`);
+}
+
+// ── 主入口 ──
+
+function installCommand(flags) {
+  // 1. 解析 entries
+  let entries;
+  try {
+    entries = resolvePluginEntries(INSTALL_PATH);
+  } catch (err) {
+    process.stderr.write(`error: failed to resolve plugin entries: ${err.message}\n`);
+    return 1;
+  }
+
+  // 2. 检查 dist/ 是否存在
+  if (!existsSync(entries.server.absPath) || !existsSync(entries.tui.absPath)) {
+    process.stderr.write(`error: dist/ not built at ${INSTALL_PATH}\n`);
+    process.stderr.write(`hint: run 'pnpm build' or 'npm run build' first\n`);
+    return 1;
+  }
+
+  // 3. 决定目标 — 两个 entry 都装到全局 config
+  //    server entry 在全局 opencode.json，TUI entry 在全局 tui.json。
+  //    所有目录下 opencode 都加载两个 entry，由 tryActivateSync 判断是否激活。
+  //    （之前 server entry 装到项目级 opencode.json，导致非 serenity 目录不加载 server）
+  const targets = [
+    {
+      configPath: getGlobalConfigPath('opencode.json'),
+      entries: [entries.server],
+      label: `global opencode.json`,
+    },
+    {
+      configPath: getGlobalConfigPath('tui.json'),
+      entries: [entries.tui],
+      label: `global tui.json`,
+    },
+  ];
+
+  // 4. 执行 — writePluginEntry 内已做幂等检查（isAlreadyInstalled）
+  let changed = 0;
+  let noop = 0;
+  for (const t of targets) {
+    if (flags.dryRun) {
+      const specs = t.entries.map(e => e.path).join(', ');
+      process.stdout.write(`[dry-run] would write ${specs} to ${t.configPath}\n`);
+      continue;
+    }
+    const result = writePluginEntry(t.configPath, t.entries);
+    if (result.error) {
+      process.stderr.write(`error: ${t.label}: ${result.error}\n`);
+      return 1;
+    }
+    if (result.changed) {
+      changed++;
+      if (flags.verbose) {
+        process.stdout.write(`✓ wrote ${t.configPath} (${result.addedPaths.join(', ')})\n`);
+      }
+    } else {
+      noop++;
+      if (flags.verbose) {
+        process.stdout.write(`✓ already installed: ${t.configPath}\n`);
+      }
+    }
+  }
+
+  // 6. 输出
+  if (flags.dryRun) {
+    // already printed above
+  } else if (changed > 0 && !flags.verbose) {
+    process.stdout.write(`opencode-serenity-plugin: installed (${changed} config${changed === 1 ? '' : 's'}). restart opencode to activate.\n`);
+  } else if (flags.verbose) {
+    process.stdout.write(`done. changed=${changed} noop=${noop}\n`);
+  }
+  // else: silent on no-op success
+
+  return 0;
+}
+
+// ── install-skill 命令 ──
+
+function installSkillCommand(flags) {
+  const name = flags.skillName;
+  if (!name) {
+    process.stderr.write('error: install-skill requires a skill name\n');
+    process.stderr.write('usage: opencode-serenity-plugin install-skill <name> [--prefix=<str>]\n');
+    return 1;
+  }
+
+  const result = installSkill({
+    pluginRoot: INSTALL_PATH,
+    name,
+    cwd: process.cwd(),
+    prefix: flags.prefix || undefined,
+    dryRun: flags.dryRun,
+  });
+
+  if (!result.success) {
+    process.stderr.write(`error: ${result.message}\n`);
+    return 1;
+  }
+
+  if (flags.dryRun && flags.verbose && result.createdFiles?.length) {
+    process.stdout.write('Files to create:\n');
+    for (const f of result.createdFiles) {
+      process.stdout.write(`  ${f}\n`);
+    }
+  }
+
+  process.stdout.write(result.message + '\n');
+  return 0;
+}
+
+// ── init 命令 ──
+
+async function initCommand(flags) {
+  const targetPath = flags.skillName || process.cwd(); // reuse skillName as positional target
+
+  const result = await initWizard({
+    targetPath,
+    pluginRoot: INSTALL_PATH,
+    prefix: flags.prefix || undefined,
+    nonInteractive: flags.nonInteractive,
+    force: flags.force,
+  });
+
+  if (!result.success) {
+    process.stderr.write(`error: ${result.message}\n`);
+    return 1;
+  }
+
+  process.stdout.write(result.message + '\n');
+  return 0;
+}
+
+async function main() {
+  const flags = parseArgs(process.argv.slice(2));
+
+  if (flags.version) {
+    process.stdout.write(readVersion() + '\n');
+    return 0;
+  }
+  if (flags.help || !flags.command) {
+    printHelp();
+    return flags.help ? 0 : 1;
+  }
+
+  switch (flags.command) {
+    case 'init':
+      return await initCommand(flags);
+    case 'install':
+      return installCommand(flags);
+    case 'install-skill':
+      return installSkillCommand(flags);
+    case 'uninstall':
+      process.stderr.write(`error: 'uninstall' not implemented in v1.11 (D24 scope: install only)\n`);
+      process.stderr.write(`hint: manually remove entry from <config>#plugin, then delete from _plugin_origins\n`);
+      return 1;
+    default:
+      process.stderr.write(`error: unknown command: ${flags.command}\n`);
+      return 1;
+  }
+}
+
+main().then((code) => process.exit(code ?? 0));

package/dist/activation.d.ts

@@ -0,0 +1,40 @@
+/**
+ * 10 步启动协议 — v0.1 两阶段 init
+ *
+ * 旧 v0：one-phase sync（tryActivate 一次 await 完所有 IO）
+ * 新 v0.1：two-phase
+ *   Phase 1 同步（plugin 入口立即返回）：
+ *     - RR6 检查 cwd 是否在 git repo → 失败：mark disabled，返回
+ *     - 成功：启动 Phase 2 fire-and-forget
+ *   Phase 2 异步（后台 IO）：
+ *     - RR1 读 /.serenity → 失败：state.error
+ *     - RR2 验证 SKILL.md 存在 → 失败：state.error
+ *     - 成功：setState + mark ready
+ *
+ * 关键设计：tools/hooks 通过 `ensureReady()` 阻塞等待 Phase 2 完成。
+ *
+ * 不抛错——所有失败路径通过 state/console.warn 表达。
+ */
+import type { PluginInput } from '@opencode-ai/plugin';
+export type SyncResult = {
+    ok: true;
+    cwdRoot: string;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * getClient 工厂：可注入，便于测试 mock + 隔离 v1/v2 client 类型
+ *
+ * 返回类型用 unknown，activation 内部按需 cast 成 ToastClient（v1.18 解耦）。
+ */
+export type GetClient = () => unknown | null;
+/**
+ * Phase 1：同步检查 RR6（git repo）。
+ * - 失败：mark disabled + console.warn
+ * - 成功：启动 Phase 2 fire-and-forget + 立即返回 ok
+ *
+ * 注：调用方不需 await Phase 2 任何 IO；后续 tools/hooks 会自己 ensureReady()
+ */
+export declare function tryActivateSync(input: PluginInput, getClient?: GetClient): SyncResult;
+//# sourceMappingURL=activation.d.ts.map

package/dist/activation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"activation.d.ts","sourceRoot":"","sources":["../src/activation.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAQH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAQvD,MAAM,MAAM,UAAU,GAClB;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAC7B;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,GAAG,IAAI,CAAC;AAE7C;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,EAAE,SAAS,CAAC,EAAE,SAAS,GAAG,UAAU,CAyBrF"}

package/dist/activation.js

@@ -0,0 +1,133 @@
+/**
+ * 10 步启动协议 — v0.1 两阶段 init
+ *
+ * 旧 v0：one-phase sync（tryActivate 一次 await 完所有 IO）
+ * 新 v0.1：two-phase
+ *   Phase 1 同步（plugin 入口立即返回）：
+ *     - RR6 检查 cwd 是否在 git repo → 失败：mark disabled，返回
+ *     - 成功：启动 Phase 2 fire-and-forget
+ *   Phase 2 异步（后台 IO）：
+ *     - RR1 读 /.serenity → 失败：state.error
+ *     - RR2 验证 SKILL.md 存在 → 失败：state.error
+ *     - 成功：setState + mark ready
+ *
+ * 关键设计：tools/hooks 通过 `ensureReady()` 阻塞等待 Phase 2 完成。
+ *
+ * 不抛错——所有失败路径通过 state/console.warn 表达。
+ */
+import { findGitRoot } from './util/git.js';
+import { readSerenityFile } from './util/serenity-file.js';
+import { buildSkillPath, validateSkillExists } from './util/path.js';
+import { readFileSync } from 'node:fs';
+import { setState, markReady, markDisabled, getReadyMachine } from './state.js';
+import { log } from './util/log.js';
+import { checkSerenityConfig } from './util/init-check.js';
+import { patchMainRepoOpencodeJson, } from './util/config-patch.js';
+/**
+ * Phase 1：同步检查 RR6（git repo）。
+ * - 失败：mark disabled + console.warn
+ * - 成功：启动 Phase 2 fire-and-forget + 立即返回 ok
+ *
+ * 注：调用方不需 await Phase 2 任何 IO；后续 tools/hooks 会自己 ensureReady()
+ */
+export function tryActivateSync(input, getClient) {
+    const cwd = input.directory;
+    log.info('phase1', 'start sync activation', { cwd });
+    // Phase 1 — RR6 同步检查
+    let cwdRoot;
+    try {
+        cwdRoot = findGitRoot(cwd);
+        log.info('phase1', 'RR6 ok: cwd in git repo', { cwdRoot });
+    }
+    catch (err) {
+        const reason = formatErrorMessage(err, 'RR6: cwd not in git repo');
+        log.warn('phase1', 'RR6 failed', { reason, cwd });
+        markDisabled(reason);
+        return { ok: false, reason };
+    }
+    // Phase 2 — fire-and-forget（不 await）
+    const machine = getReadyMachine();
+    void machine.start(async () => {
+        log.debug('phase2', 'starting async activation', { cwdRoot });
+        await activateAsync(cwdRoot, getClient); // throws on RR1/RR2 failure → machine.markError()
+        log.info('phase2', 'activation complete', { cwdRoot });
+    });
+    return { ok: true, cwdRoot };
+}
+/**
+ * Phase 2：异步激活。
+ * 内部 try/catch 所有失败 → machine 自然 catch 并推 error 状态。
+ */
+async function activateAsync(cwdRoot, getClient) {
+    // RR1 — 读 /.serenity
+    let instanceName;
+    try {
+        instanceName = readSerenityFile(cwdRoot);
+    }
+    catch (err) {
+        const detail = err instanceof Error ? err.message : String(err);
+        throw new Error(`RR1: ${detail}`);
+    }
+    // RR2 — 验证 SKILL.md
+    let skillPath;
+    try {
+        skillPath = buildSkillPath(cwdRoot, instanceName);
+        validateSkillExists(skillPath, cwdRoot, instanceName);
+    }
+    catch (err) {
+        const detail = err instanceof Error ? err.message : String(err);
+        throw new Error(`RR2: ${detail}`);
+    }
+    // RR2.5 — 读 SKILL.md 全文（用于 system.transform 注入）
+    // 失败：降级为 null（plugin 仍工作，只是不注 SKILL.md）
+    let skillContent = null;
+    try {
+        skillContent = readFileSync(skillPath, 'utf8');
+        log.debug('phase2', 'SKILL.md loaded', { bytes: skillContent.length, skillPath });
+    }
+    catch (err) {
+        const detail = err instanceof Error ? err.message : String(err);
+        log.warn('phase2', 'SKILL.md read failed; will skip system.transform injection', { detail, skillPath });
+    }
+    // 成功 — 写 state + mark ready
+    const state = Object.freeze({
+        activated: true,
+        cwdRoot,
+        instanceName,
+        skillPath,
+        skillContent,
+    });
+    setState(state);
+    markReady();
+    // v1.5 init-check：plugin 启动时自检 opencode.json 关键配置
+    // 只 warn，不 patch
+    checkSerenityConfig(cwdRoot, instanceName);
+    // v1.7 config-patch：自动改主仓 opencode.json 让 cwdRoot 内 read/edit = allow
+    // 用户 m0649 决定"全自动"——plugin 启动即生效（用户需重启 opencode 应用改动）
+    if (getClient) {
+        try {
+            const result = await patchMainRepoOpencodeJson(cwdRoot, () => {
+                try {
+                    return getClient();
+                }
+                catch {
+                    return null;
+                }
+            });
+            if (result.changed) {
+                log.info('phase2', 'main-repo opencode.json auto-patched', {
+                    configPath: result.configPath,
+                    diff: result.diff,
+                });
+            }
+        }
+        catch (err) {
+            const detail = err instanceof Error ? err.message : String(err);
+            log.warn('phase2', 'config-patch failed; plugin continues', { detail });
+        }
+    }
+}
+function formatErrorMessage(err, fallback) {
+    return err instanceof Error ? err.message : fallback;
+}
+//# sourceMappingURL=activation.js.map