@shgroup/opencode-serenity-plugin 0.2.0

package/dist/hooks/permission-guards.js

@@ -0,0 +1,153 @@
+/**
+ * Permission Guards Hook 工厂
+ *
+ * 包含：tool.execute.before hook
+ * 职责（RR5 + v1.6 补全）：
+ * 1. read / edit / write 工具的 path 字段强制在 cwdRoot 内（RR5 hard block；v1.6 加 edit/write）
+ * 2. symlink 防御（v1.6 扩展 v1-1 msm-schema 的 realpath 逻辑到 tool.execute.before）
+ *
+ * 注意：bash 禁令于 2026-06-08 移除（旧 RR3），改用运行时开关：
+ *   TUI slash command /serenity-bash-on|off|status 控制，通过文件 IPC 通信，
+ *   在 tool.execute.before 中做静默拒绝。默认 bash 启用。
+ *
+ * 设计：v1.6 RR5 补全 = plugin **接管**权限管理（不再依赖 opencode.json 静态 allow）
+ * - 主仓 opencode.json 已复原 read/edit = "ask"（commit fe19b5e）
+ * - LLM 在 cwdRoot 内时：v1.3-v2 auto-reply 仍处理 "ask" 弹窗
+ * - LLM 在 cwdRoot 外时：plugin hard block 早于 opencode 弹窗生效
+ *
+ * L3 验证：单 hook 抛错会中断整条 Effect 链（plugin/index.ts:286-299），
+ * 所以抛错已被 safeHook 包装为 silent（util.ts）
+ */
+import { resolve as pathResolve } from 'node:path';
+import { realpathSync, existsSync } from 'node:fs';
+import { isPathInside } from '../util/git.js';
+import { getState, ensureReady } from '../state.js';
+import { isHookEnabled } from './util.js';
+import { log } from '../util/log.js';
+import { isBashDisabled } from '../bash-toggle.js';
+/**
+ * v1.6 字段名提取：
+ * - 显式列表：command, path, filePath, file, cwd（v0.1-3 已有）
+ * - 启发式后缀：*path* / *file* / *dir* / *Path* / *File* / *Dir*（v1.6 加）
+ *   覆盖：targetPath / sourceFilePath / outputDir / newPath / etc.
+ */
+export function extractPathsFromArgs(args) {
+    const candidates = [];
+    // 显式字段（不区分大小写）
+    const explicitKeys = new Set(['command', 'path', 'filepath', 'file', 'cwd']);
+    for (const [key, value] of Object.entries(args)) {
+        if (typeof value !== 'string' || value.length === 0)
+            continue;
+        if (explicitKeys.has(key.toLowerCase())) {
+            candidates.push(value);
+        }
+    }
+    // 启发式后缀（覆盖大多数 LLM 工具的命名习惯）
+    for (const [key, value] of Object.entries(args)) {
+        if (typeof value !== 'string' || value.length === 0)
+            continue;
+        if (explicitKeys.has(key.toLowerCase()))
+            continue; // 跳过已加的
+        const lower = key.toLowerCase();
+        if (lower.includes('path') || lower.includes('file') || lower.includes('dir')) {
+            candidates.push(value);
+        }
+    }
+    return candidates;
+}
+/**
+ * 路径越界判定 + symlink 防御
+ * 返回：
+ *  - 'inside'：路径在 cwdRoot 内
+ *  - 'outside'：路径解析后在 cwdRoot 外
+ *  - 'symlink'：是 symlink 且 realpath 在 cwdRoot 外
+ *  - 'unparseable'：路径无法解析
+ *  - 'not-exist'：文件不存在（写场景，无法 realpath）
+ */
+function classifyPath(value, cwdRoot) {
+    if (value.startsWith('/') || /^[a-zA-Z]:[\\\/]/.test(value)) {
+        let abs;
+        try {
+            abs = pathResolve(value);
+        }
+        catch {
+            return 'unparseable';
+        }
+        if (!isPathInside(cwdRoot, abs))
+            return 'outside';
+        if (existsSync(abs)) {
+            try {
+                const real = realpathSync(abs);
+                if (real !== abs)
+                    return 'symlink';
+                if (!isPathInside(cwdRoot, real))
+                    return 'symlink';
+            }
+            catch {
+                return 'unparseable';
+            }
+        }
+        else {
+            return 'not-exist'; // 写文件场景合理
+        }
+        return 'inside';
+    }
+    return 'inside'; // 相对路径由 msm 子进程处理；tool 调用前已是绝对路径
+}
+const toolExecuteBeforeImpl = async (input, _output) => {
+    // v0.1: 阻塞等待 Phase 2 完成（失败时：放行所有 = plugin 不工作）
+    try {
+        await ensureReady();
+    }
+    catch {
+        return;
+    }
+    const state = getState();
+    // SDK 1.15.13: tool.execute.before signature = (input, output) where output.args is the tool call's arguments
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const args = _output?.args ?? {};
+    const paths = extractPathsFromArgs(args);
+    // v1.6: edit + write 一起 hard block（read 已有；webfetch A2 决定不动）
+    // v1.6: grep 加入 — path 参数强制在 cwdRoot 内，禁止搜索宁静号之外的内容
+    // v0.1: glob 加入 — 与 grep 同级限制
+    if (input.tool === 'read' || input.tool === 'edit' || input.tool === 'write' || input.tool === 'grep' || input.tool === 'glob') {
+        for (const p of paths) {
+            const verdict = classifyPath(p, state.cwdRoot);
+            if (verdict === 'outside' || verdict === 'symlink') {
+                log.warn('guard', `${input.tool} path ${verdict} cwdRoot`, { path: p, cwdRoot: state.cwdRoot });
+                throw new Error(`[serenity] ${input.tool} path "${p}" is ${verdict} the serenity workspace root "${state.cwdRoot}" (RR5).`);
+            }
+        }
+    }
+    // webfetch A2 决定不动（保持 v0.1-3 行为）
+    if (input.tool === 'webfetch') {
+        for (const p of paths) {
+            const verdict = classifyPath(p, state.cwdRoot);
+            if (verdict === 'outside' || verdict === 'symlink') {
+                log.warn('guard', `webfetch path ${verdict} cwdRoot`, { path: p, cwdRoot: state.cwdRoot });
+                throw new Error(`[serenity] webfetch path "${p}" is ${verdict} the serenity workspace root "${state.cwdRoot}" (RR5).`);
+            }
+        }
+    }
+    // bash toggle: 静默拒绝（文件 IPC，TUI slash command 控制）
+    if (input.tool === 'bash' && isBashDisabled()) {
+        throw new Error(`bash is disabled by user, use msm instead`);
+    }
+};
+/** 工厂：返回 permission guards 相关的 hooks 集合
+ *
+ * v1.6 关键修正：permission-guards **不**走 safeHook。
+ * 原因：safeHook 的"silent 策略"会吞掉 throw，导致 RR5 hard block 失效。
+ * L3 验证：单 hook 抛错中断整条 Effect 链（plugin/index.ts:286-299）——
+ * 这正是 RR5 hard block 想要的行为，所以应当让它**传播**给 opencode。
+ * 其他 hook（compacting / shell-env）保留 safeHook（throw 不应硬中断）。
+ */
+export function createPermissionGuards(config) {
+    const hooks = {};
+    if (isHookEnabled('tool.execute.before', config)) {
+        // 不走 safeHook —— 让 RR5 throw 真正生效
+        hooks['tool.execute.before'] = toolExecuteBeforeImpl;
+    }
+    return hooks;
+}
+//# sourceMappingURL=permission-guards.js.map

package/dist/hooks/permission-guards.js.map

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

package/dist/hooks/shell-env.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Shell Environment Hook 工厂
+ *
+ * 包含：shell.env hook
+ * 职责（v0.1 增强）：
+ * - 注入 HOME_SERENITY_ROOT = state.cwdRoot（所有 bash 子进程可见）
+ * - 注入 SERENITY_INSTANCE = state.instanceName
+ * - 注入 SERENITY_PLUGIN_VERSION（plugin 自报版本，便于 msm 脚本判定）
+ *
+ * 注意：v0 禁 bash（同名 tool 覆盖 + permission.bash=deny），
+ *      shell.env 仍生效到 msm_exec 子进程 + 用户终端（如 msm 间接调 bash）
+ */
+import type { Hooks } from '@opencode-ai/plugin';
+import { type HookConfig } from './util.js';
+/** 工厂：返回 shell env 相关的 hooks 集合
+ *
+ * v1.12: 改用 safeCreateHook（factory pattern）
+ */
+export declare function createShellEnv(config?: HookConfig): Partial<Hooks>;
+//# sourceMappingURL=shell-env.d.ts.map

package/dist/hooks/shell-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-env.d.ts","sourceRoot":"","sources":["../../src/hooks/shell-env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EAAkB,KAAK,UAAU,EAAE,MAAM,WAAW,CAAC;AAiB5D;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,CAQlE"}

package/dist/hooks/shell-env.js

@@ -0,0 +1,38 @@
+/**
+ * Shell Environment Hook 工厂
+ *
+ * 包含：shell.env hook
+ * 职责（v0.1 增强）：
+ * - 注入 HOME_SERENITY_ROOT = state.cwdRoot（所有 bash 子进程可见）
+ * - 注入 SERENITY_INSTANCE = state.instanceName
+ * - 注入 SERENITY_PLUGIN_VERSION（plugin 自报版本，便于 msm 脚本判定）
+ *
+ * 注意：v0 禁 bash（同名 tool 覆盖 + permission.bash=deny），
+ *      shell.env 仍生效到 msm_exec 子进程 + 用户终端（如 msm 间接调 bash）
+ */
+import { getState, ensureReady } from '../state.js';
+import { safeCreateHook } from './util.js';
+import pkg from '../../package.json' with { type: 'json' };
+const shellEnvImpl = async (_input, output) => {
+    try {
+        await ensureReady();
+    }
+    catch {
+        return;
+    }
+    const state = getState();
+    output.env.HOME_SERENITY_ROOT = state.cwdRoot;
+    output.env.SERENITY_INSTANCE = state.instanceName;
+    // v1.18 统一：与 tui.ts 同源 (package.json#version)，release 时改一处
+    output.env.SERENITY_PLUGIN_VERSION = pkg.version;
+};
+/** 工厂：返回 shell env 相关的 hooks 集合
+ *
+ * v1.12: 改用 safeCreateHook（factory pattern）
+ */
+export function createShellEnv(config) {
+    const hooks = {};
+    hooks['shell.env'] = safeCreateHook('shell.env', () => shellEnvImpl, config);
+    return hooks;
+}
+//# sourceMappingURL=shell-env.js.map

package/dist/hooks/shell-env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shell-env.js","sourceRoot":"","sources":["../../src/hooks/shell-env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,cAAc,EAAmB,MAAM,WAAW,CAAC;AAC5D,OAAO,GAAG,MAAM,oBAAoB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAC;AAE3D,MAAM,YAAY,GAAoC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;IAC7E,IAAI,CAAC;QACH,MAAM,WAAW,EAAE,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;IAED,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IACzB,MAAM,CAAC,GAAG,CAAC,kBAAkB,GAAG,KAAK,CAAC,OAAO,CAAC;IAC9C,MAAM,CAAC,GAAG,CAAC,iBAAiB,GAAG,KAAK,CAAC,YAAY,CAAC;IAClD,2DAA2D;IAC3D,MAAM,CAAC,GAAG,CAAC,uBAAuB,GAAG,GAAG,CAAC,OAAO,CAAC;AACnD,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,MAAmB;IAChD,MAAM,KAAK,GAAmB,EAAE,CAAC;IACjC,KAAK,CAAC,WAAW,CAAC,GAAG,cAAc,CACjC,WAAW,EACX,GAAG,EAAE,CAAC,YAAY,EAClB,MAAM,CACP,CAAC;IACF,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/hooks/util.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Hook 工厂公共工具（oMo 模式 v1.12 增强）
+ *
+ * v1.12 新增 3 项能力（D25 决策 — 仿 omo safeHook 模式 + 失败自动 disable）：
+ * 1. `isHookEnabled(name, config?)` — 集中开关
+ *    - 显式 config[name] === false → 禁用
+ *    - 环境变量 `SERENITY_HOOK_DISABLED_<NAME>=1` → 禁用
+ *    - module-level disable（plugin process lifetime）→ 禁用
+ * 2. `disableHook(name, reason?)` / `isHookDisabled(name)` — 手动 / 自动禁用
+ * 3. `safeCreateHook(name, factory, config?)` — 工厂包装（v1.12 推荐 API）
+ *    - isHookEnabled === false → 返回 no-op 函数（hook 签名匹配）
+ *    - factory 抛错 → 标记 disabled + 返回 no-op（**避免 retry storm**）
+ *    - 注册后 hook 抛错 → 标记 disabled + 不 rethrow（**不传播 = 整 plugin 不挂**）
+ *    - 错误信息用 log.debug 记录 + module-level _sessionErrors Map 保留
+ *
+ * state lifetime: plugin process lifetime（不是 chat session）
+ * - 一个 opencode 进程 = 一个 plugin 进程 = 一组 disable 状态
+ * - 测试用 `_resetSessionHookGuard()` 显式清空（vitest beforeEach 已挂上）
+ *
+ * 向后兼容（v0.0.1 → v1.12）：
+ * - 旧 `safeHook(name, impl, config?)` 仍工作；内部已升级走新 isHookEnabled
+ * - 旧 `isHookEnabled(name, config?)` 签名不变，行为增强（环境变量 + module-level disable）
+ *
+ * 与 omo 的差异（v1.12 比 omo 更细）：
+ * - 粒度更细：每个 hook 独立 disable
+ * - 多层 disable：env var / process / config 三道闸
+ * - module-level 自动 disable（hook 抛错一次后本次 plugin process 不再试）
+ *
+ * v1.12 决策：v0.1-3 决策依然有效（"plugin 应静默"），所以 hook 抛错**不 rethrow**
+ * 但**不静默丢弃** — 错误信息存到 _sessionErrors Map，调试时可查
+ *
+ * v1.18 收口：HookName / HookConfig / HOOK_NAMES 全部从 config-schema.ts 导入
+ * （单一真相源，zod record 严格校验 key ∈ HOOK_NAMES）。
+ */
+import type { Hooks } from '@opencode-ai/plugin';
+import { HOOK_NAMES, type HookName, type HookConfig } from '../config-schema.js';
+export { HOOK_NAMES };
+export type { HookName, HookConfig };
+/** 检查 hook 是否启用（默认 true；任一闸 false 则禁用） */
+export declare function isHookEnabled(name: HookName, config?: HookConfig): boolean;
+/** 显式禁用一个 hook（手动或自动触发） */
+export declare function disableHook(name: HookName, reason?: unknown): void;
+/** 检查 hook 是否已被 session-level 禁用 */
+export declare function isHookDisabled(name: HookName): boolean;
+/** 拿 session-level 错误 Map（调试用） */
+export declare function _getSessionErrors(): ReadonlyMap<HookName, {
+    error: unknown;
+    ts: Date;
+}>;
+/** 测试用：清空 session-level disable 状态 */
+export declare function _resetSessionHookGuard(): void;
+/**
+ * safeCreateHook（v1.12 推荐 API）
+ *
+ * 包装 hook factory：
+ * 1. isHookEnabled === false → 返回 no-op（hook 签名匹配，host 调用但不做事）
+ * 2. factory() 抛错 → log.debug + disableHook + 返回 no-op
+ * 3. 注册后 hook 抛错 → log.debug + disableHook + 不 rethrow
+ *
+ * @param name    hook 名（用于 env var / session disable 追踪）
+ * @param factory 工厂函数（v0 模式：返回 hook impl；这里就是返回 impl 本身）
+ * @param config  per-hook 配置（可选）
+ */
+export declare function safeCreateHook<K extends HookName>(name: K, factory: () => NonNullable<Hooks[K]>, config?: HookConfig): NonNullable<Hooks[K]>;
+/**
+ * safeHook（v0.0.1 旧 API，向后兼容）
+ *
+ * 行为：
+ * - isHookEnabled === false → 返回 undefined（host 不注册 hook，走默认）
+ * - 注册后 hook 抛错 → v1.12: disableHook + 不 rethrow
+ *
+ * 与 safeCreateHook 区别：
+ * - safeCreateHook 返回 no-op（hook 已注册但不做事）
+ * - safeHook 返回 undefined（hook 未注册）
+ *
+ * 选择建议：
+ * - 旧代码（v0.1-3 起的 hook 工厂）继续用 safeHook，行为兼容
+ * - 新代码推荐 safeCreateHook，hook 仍注册（host 期望所有 hook 都存在）
+ */
+export declare function safeHook<K extends HookName>(name: K, impl: NonNullable<Hooks[K]>, config?: HookConfig): NonNullable<Hooks[K]> | undefined;
+//# sourceMappingURL=util.d.ts.map

package/dist/hooks/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../../src/hooks/util.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAEjD,OAAO,EACL,UAAU,EACV,KAAK,QAAQ,EACb,KAAK,UAAU,EAChB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,UAAU,EAAE,CAAC;AACtB,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AAsBrC,0CAA0C;AAC1C,wBAAgB,aAAa,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,UAAU,GAAG,OAAO,CAW1E;AAED,2BAA2B;AAC3B,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI,CAMlE;AAED,oCAAoC;AACpC,wBAAgB,cAAc,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAEtD;AAED,kCAAkC;AAClC,wBAAgB,iBAAiB,IAAI,WAAW,CAAC,QAAQ,EAAE;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,EAAE,EAAE,IAAI,CAAA;CAAE,CAAC,CAEvF;AAED,sCAAsC;AACtC,wBAAgB,sBAAsB,IAAI,IAAI,CAG7C;AAgBD;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,QAAQ,EAC/C,IAAI,EAAE,CAAC,EACP,OAAO,EAAE,MAAM,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EACpC,MAAM,CAAC,EAAE,UAAU,GAClB,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAyBvB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,QAAQ,EACzC,IAAI,EAAE,CAAC,EACP,IAAI,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAC3B,MAAM,CAAC,EAAE,UAAU,GAClB,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,CAanC"}

package/dist/hooks/util.js

@@ -0,0 +1,172 @@
+/**
+ * Hook 工厂公共工具（oMo 模式 v1.12 增强）
+ *
+ * v1.12 新增 3 项能力（D25 决策 — 仿 omo safeHook 模式 + 失败自动 disable）：
+ * 1. `isHookEnabled(name, config?)` — 集中开关
+ *    - 显式 config[name] === false → 禁用
+ *    - 环境变量 `SERENITY_HOOK_DISABLED_<NAME>=1` → 禁用
+ *    - module-level disable（plugin process lifetime）→ 禁用
+ * 2. `disableHook(name, reason?)` / `isHookDisabled(name)` — 手动 / 自动禁用
+ * 3. `safeCreateHook(name, factory, config?)` — 工厂包装（v1.12 推荐 API）
+ *    - isHookEnabled === false → 返回 no-op 函数（hook 签名匹配）
+ *    - factory 抛错 → 标记 disabled + 返回 no-op（**避免 retry storm**）
+ *    - 注册后 hook 抛错 → 标记 disabled + 不 rethrow（**不传播 = 整 plugin 不挂**）
+ *    - 错误信息用 log.debug 记录 + module-level _sessionErrors Map 保留
+ *
+ * state lifetime: plugin process lifetime（不是 chat session）
+ * - 一个 opencode 进程 = 一个 plugin 进程 = 一组 disable 状态
+ * - 测试用 `_resetSessionHookGuard()` 显式清空（vitest beforeEach 已挂上）
+ *
+ * 向后兼容（v0.0.1 → v1.12）：
+ * - 旧 `safeHook(name, impl, config?)` 仍工作；内部已升级走新 isHookEnabled
+ * - 旧 `isHookEnabled(name, config?)` 签名不变，行为增强（环境变量 + module-level disable）
+ *
+ * 与 omo 的差异（v1.12 比 omo 更细）：
+ * - 粒度更细：每个 hook 独立 disable
+ * - 多层 disable：env var / process / config 三道闸
+ * - module-level 自动 disable（hook 抛错一次后本次 plugin process 不再试）
+ *
+ * v1.12 决策：v0.1-3 决策依然有效（"plugin 应静默"），所以 hook 抛错**不 rethrow**
+ * 但**不静默丢弃** — 错误信息存到 _sessionErrors Map，调试时可查
+ *
+ * v1.18 收口：HookName / HookConfig / HOOK_NAMES 全部从 config-schema.ts 导入
+ * （单一真相源，zod record 严格校验 key ∈ HOOK_NAMES）。
+ */
+import { log } from '../util/log.js';
+import { HOOK_NAMES, } from '../config-schema.js';
+// 重新导出供现有 import 路径继续工作（hooks/util.js 是公开 API）
+export { HOOK_NAMES };
+/** module-level disable + 错误追踪状态（plugin process lifetime；测试用 reset API） */
+const _sessionDisabled = new Set();
+const _sessionErrors = new Map();
+/**
+ * 把 hook name 转成 env var key
+ *
+ * 例:
+ *   'shell.env' → 'SERENITY_HOOK_DISABLED_SHELL_ENV'
+ *   'tool.execute.before' → 'SERENITY_HOOK_DISABLED_TOOL_EXECUTE_BEFORE'
+ *   'experimental.chat.system.transform' → 'SERENITY_HOOK_DISABLED_EXPERIMENTAL_CHAT_SYSTEM_TRANSFORM'
+ */
+function envVarKeyForHook(name) {
+    const normalized = name
+        .replace(/\./g, '_')
+        .replace(/-/g, '_')
+        .toUpperCase();
+    return `SERENITY_HOOK_DISABLED_${normalized}`;
+}
+/** 检查 hook 是否启用（默认 true；任一闸 false 则禁用） */
+export function isHookEnabled(name, config) {
+    // 1. 环境变量闸
+    if (process.env[envVarKeyForHook(name)] === '1')
+        return false;
+    // 2. session-level disable 闸（v1.12：throw 一次后自动 disable）
+    if (_sessionDisabled.has(name))
+        return false;
+    // 3. config 闸
+    if (config && config[name] === false)
+        return false;
+    return true;
+}
+/** 显式禁用一个 hook（手动或自动触发） */
+export function disableHook(name, reason) {
+    _sessionDisabled.add(name);
+    if (reason !== undefined) {
+        _sessionErrors.set(name, { error: reason, ts: new Date() });
+    }
+    log.debug('hooks-guard', 'hook disabled', { name, reason: String(reason) });
+}
+/** 检查 hook 是否已被 session-level 禁用 */
+export function isHookDisabled(name) {
+    return _sessionDisabled.has(name);
+}
+/** 拿 session-level 错误 Map（调试用） */
+export function _getSessionErrors() {
+    return _sessionErrors;
+}
+/** 测试用：清空 session-level disable 状态 */
+export function _resetSessionHookGuard() {
+    _sessionDisabled.clear();
+    _sessionErrors.clear();
+}
+/**
+ * no-op hook（v1.12：safeCreateHook 禁用时返回的 stub）
+ *
+ * 签名匹配：所有 opencode hook 接受 (input, output) → Promise<void> | void
+ * no-op 不做事，类型断言成对应 hook
+ */
+function noOpHook(_name) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    return (async (..._args) => {
+        // no-op: 不 rethrow 不 log（v0.0.1 release 静默原则）
+        // 调试时: log.debug('hooks-guard', 'no-op hook called', { name: _name });
+    });
+}
+/**
+ * safeCreateHook（v1.12 推荐 API）
+ *
+ * 包装 hook factory：
+ * 1. isHookEnabled === false → 返回 no-op（hook 签名匹配，host 调用但不做事）
+ * 2. factory() 抛错 → log.debug + disableHook + 返回 no-op
+ * 3. 注册后 hook 抛错 → log.debug + disableHook + 不 rethrow
+ *
+ * @param name    hook 名（用于 env var / session disable 追踪）
+ * @param factory 工厂函数（v0 模式：返回 hook impl；这里就是返回 impl 本身）
+ * @param config  per-hook 配置（可选）
+ */
+export function safeCreateHook(name, factory, config) {
+    // 闸 1: 启用？
+    if (!isHookEnabled(name, config)) {
+        return noOpHook(name);
+    }
+    // 闸 2: factory 抛错？
+    let hookImpl;
+    try {
+        hookImpl = factory();
+    }
+    catch (err) {
+        disableHook(name, err);
+        return noOpHook(name);
+    }
+    // 闸 3: 注册后 hook 抛错 → disable + 不 rethrow
+    return (async (input, output) => {
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            await hookImpl(input, output);
+        }
+        catch (err) {
+            disableHook(name, err);
+            // v0.0.1 release 静默：不 rethrow，不 console 输出
+        }
+    });
+}
+/**
+ * safeHook（v0.0.1 旧 API，向后兼容）
+ *
+ * 行为：
+ * - isHookEnabled === false → 返回 undefined（host 不注册 hook，走默认）
+ * - 注册后 hook 抛错 → v1.12: disableHook + 不 rethrow
+ *
+ * 与 safeCreateHook 区别：
+ * - safeCreateHook 返回 no-op（hook 已注册但不做事）
+ * - safeHook 返回 undefined（hook 未注册）
+ *
+ * 选择建议：
+ * - 旧代码（v0.1-3 起的 hook 工厂）继续用 safeHook，行为兼容
+ * - 新代码推荐 safeCreateHook，hook 仍注册（host 期望所有 hook 都存在）
+ */
+export function safeHook(name, impl, config) {
+    if (!isHookEnabled(name, config))
+        return undefined;
+    return (async (input, output) => {
+        try {
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            await impl(input, output);
+        }
+        catch (err) {
+            // v0.0.1 release 静默：不 rethrow，不 console 输出
+            // v1.12: mark disabled for rest of session
+            disableHook(name, err);
+        }
+    });
+}
+//# sourceMappingURL=util.js.map

package/dist/hooks/util.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * opencode-serenity-plugin — server entry
+ *
+ * 职责：注册 5 个自定义工具 + 6 个 system hook，实现 serenity 认知基础设施的
+ *       plugin 层（MSM 框架、文件系统操作、会话管理、路径守卫、skill 注入等）。
+ *
+ * 设计文档见 docs/：
+ *   - architecture-v0.md — 两阶段 init + 模块分解
+ *   - contract-v0.md — 6 契约 + 13 错误类
+ *   - requirements-v0-scope.md — RR1-RR7 范围层
+ *
+ * Hook 工厂分层：
+ *   createPermissionGuards → tool.execute.before（RR5 路径守卫 + bash 开关）
+ *   createCompactingHooks  → system.transform（SKILL.md 注入）
+ *                           + session.compacting（关键状态保留）
+ *                           + tool.definition（subagent context 注入）
+ *   createShellEnv         → shell.env（HOME_SERENITY_ROOT + SERENITY_INSTANCE）
+ *   createPermissionAutoReply → event permission.asked（cwdRoot 内自动 always）
+ */
+import type { Plugin } from '@opencode-ai/plugin';
+declare const _default: {
+    id: string;
+    server: Plugin;
+};
+export default _default;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAS,MAAM,qBAAqB,CAAC;;;;;AAoDzD,wBAGE"}

package/dist/index.js

@@ -0,0 +1,63 @@
+/**
+ * opencode-serenity-plugin — server entry
+ *
+ * 职责：注册 5 个自定义工具 + 6 个 system hook，实现 serenity 认知基础设施的
+ *       plugin 层（MSM 框架、文件系统操作、会话管理、路径守卫、skill 注入等）。
+ *
+ * 设计文档见 docs/：
+ *   - architecture-v0.md — 两阶段 init + 模块分解
+ *   - contract-v0.md — 6 契约 + 13 错误类
+ *   - requirements-v0-scope.md — RR1-RR7 范围层
+ *
+ * Hook 工厂分层：
+ *   createPermissionGuards → tool.execute.before（RR5 路径守卫 + bash 开关）
+ *   createCompactingHooks  → system.transform（SKILL.md 注入）
+ *                           + session.compacting（关键状态保留）
+ *                           + tool.definition（subagent context 注入）
+ *   createShellEnv         → shell.env（HOME_SERENITY_ROOT + SERENITY_INSTANCE）
+ *   createPermissionAutoReply → event permission.asked（cwdRoot 内自动 always）
+ */
+import { tryActivateSync } from './activation.js';
+import { msmListTool, msmExecTool, msmAdminTool, } from './msm.js';
+import { fileSystemTool } from './fs/file-system-tool.js';
+import { sessionTool } from './session/session-tool.js';
+import { createPermissionGuards } from './hooks/permission-guards.js';
+import { createCompactingHooks } from './hooks/compacting.js';
+import { createShellEnv } from './hooks/shell-env.js';
+import { createPermissionAutoReplyHandler } from './hooks/permission-auto-reply.js';
+import { log } from './util/log.js';
+const plugin = async (input) => {
+    log.info('entry', 'plugin loading', { directory: input.directory, worktree: input.worktree });
+    // Phase 1: 同步 RR6 验证（git repo）
+    const syncResult = tryActivateSync(input, () => input.client);
+    if (!syncResult.ok) {
+        log.warn('entry', 'plugin not activated', { reason: syncResult.reason });
+        return {};
+    }
+    // Phase 2 启动：fire-and-forget，状态机后台验证 RR1 + RR2
+    // （由 activation.activateAsync 内部触发，此处不 await）
+    // 注册 hooks + tools（Phase 2 未完成时 hook 内 await ensureReady() 阻塞）
+    const hooks = {
+        tool: {
+            msm_list: msmListTool,
+            msm_exec: msmExecTool,
+            msm_admin: msmAdminTool,
+            file_system: fileSystemTool, // v0.1 D4: 跨实例文件系统工具
+            session_tool: sessionTool, // v0.1 D5: 通用会话管理工具
+        },
+        ...createPermissionGuards(),
+        ...createCompactingHooks(),
+        ...createShellEnv(),
+        event: createPermissionAutoReplyHandler({
+            getServerUrl: () => input.serverUrl,
+        }),
+    };
+    log.info('entry', 'phase 1 ok; phase 2 loading in background', { cwdRoot: syncResult.cwdRoot });
+    log.info('entry', 'registered tools', { tools: Object.keys(hooks.tool ?? {}) });
+    return hooks;
+};
+export default {
+    id: 'opencode-serenity-plugin-server',
+    server: plugin,
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EACL,WAAW,EACX,WAAW,EACX,YAAY,GAEb,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AACxD,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,gCAAgC,EAAE,MAAM,kCAAkC,CAAC;AACpF,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAEpC,MAAM,MAAM,GAAW,KAAK,EAAE,KAAK,EAAE,EAAE;IACrC,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,gBAAgB,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;IAE9F,+BAA+B;IAC/B,MAAM,UAAU,GAAG,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAE9D,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,CAAC;QACnB,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,sBAAsB,EAAE,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;QACzE,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,+CAA+C;IAC/C,8CAA8C;IAE9C,+DAA+D;IAC/D,MAAM,KAAK,GAAU;QACnB,IAAI,EAAE;YACJ,QAAQ,EAAE,WAAW;YACrB,QAAQ,EAAE,WAAW;YACrB,SAAS,EAAE,YAAY;YACvB,WAAW,EAAE,cAAc,EAAE,qBAAqB;YAClD,YAAY,EAAE,WAAW,EAAE,oBAAoB;SAChD;QACD,GAAG,sBAAsB,EAAE;QAC3B,GAAG,qBAAqB,EAAE;QAC1B,GAAG,cAAc,EAAE;QACnB,KAAK,EAAE,gCAAgC,CAAC;YACtC,YAAY,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,SAAS;SACpC,CAAC;KACH,CAAC;IAEF,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,2CAA2C,EAAE,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,EAAE,CAAC,CAAC;IAChG,GAAG,CAAC,IAAI,CAAC,OAAO,EAAE,kBAAkB,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;IAChF,OAAO,KAAK,CAAC;AACf,CAAC,CAAC;AAEF,eAAe;IACb,EAAE,EAAE,iCAAiC;IACrC,MAAM,EAAE,MAAM;CACf,CAAC"}

package/dist/init/init-wizard.d.ts

@@ -0,0 +1,39 @@
+/**
+ * init-wizard.ts — D1 Init 向导 Phase 1
+ *
+ * CLI 交互式创建宁静号实例的目录骨架并复制标准技能模板。
+ *
+ * 流程：
+ *   1. 收集基本信息（prefix, description）
+ *   2. 创建目录骨架（.serenity, .gitignore, AGENT_SESSIONS/, docs/）
+ *   3. 复制 9 个标准技能模板到 .opencode/skills/
+ *   4. 生成 opencode.json（注册 plugin）
+ *   5. 写入 Phase 2 Agent prompt
+ *   6. 输出完成信息
+ */
+export interface InitOptions {
+    /** 目标路径 */
+    targetPath: string;
+    /** 实例前缀（如 home, tg, pg） */
+    prefix?: string;
+    /** 实例名称（如 宁静号，用于根 skill 标题） */
+    name?: string;
+    /** 实例描述（一句话） */
+    description?: string;
+    /** Plugin 根路径（用于定位模板） */
+    pluginRoot: string;
+    /** 非交互模式 */
+    nonInteractive?: boolean;
+    /** 强制覆盖已有文件 */
+    force?: boolean;
+}
+export interface InitResult {
+    success: boolean;
+    prefix: string;
+    name: string;
+    message: string;
+    createdDirs: string[];
+    installedSkills: string[];
+}
+export declare function initWizard(opts: InitOptions): Promise<InitResult>;
+//# sourceMappingURL=init-wizard.d.ts.map

package/dist/init/init-wizard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-wizard.d.ts","sourceRoot":"","sources":["../../src/init/init-wizard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAeH,MAAM,WAAW,WAAW;IAC1B,WAAW;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yBAAyB;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY;IACZ,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,MAAM,EAAE,CAAC;CAC3B;AAsMD,wBAAsB,UAAU,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC,CA2HvE"}