@shgroup/opencode-serenity-plugin 0.2.0

package/dist/tui.js

@@ -0,0 +1,279 @@
+/**
+ * opencode-serenity-plugin TUI entry（v1.9 → ... → v1.15 → v0.1 D6）
+ *
+ * 独立 TUI plugin（与 server plugin 平级）。opencode 1.16+ 强制 PluginModule
+ * 二选一（server | tui），所以走两条独立 entry：
+ * - server entry: dist/index.js（走 Hooks 系统）
+ * - tui entry:    dist/tui.js  （走 TuiPluginApi）
+ *
+ * v0.1 D6:
+ * - 启动时检测当前目录的宁静号状态，显示在 toast 上
+ * - 三种状态：Activated / Not Activated / Error
+ * - 版本号始终显示
+ *
+ * v1.9 修复：
+ * - R-α fix: TUI entry 不放 opencode.json；放到主仓 tui.json#plugin
+ * - R-β fix: default export 改为 { id, tui } 对象形式（之前是裸函数）
+ * - R-γ fix: 路径 plugin 显式 export id
+ *
+ * v1.9.1 调整（slot 暂未实现）：
+ * - 移除 JSX slot。@opentui/solid 的 JSX runtime 只支持 build-time transform
+ *   （bun-plugin / babel-preset-solid），运行时 import 必然 throw。
+ *   我们用 tsc 编译没有 bun-plugin，所以 slot 加载会炸掉整个 plugin。
+ * - 保留 toast（不依赖 JSX），用户至少看到 "plugin activated" 通知。
+ * - 永久 slot 状态指示器待 v1.10 — 需要切到 bun build + bun-plugin-solid
+ *   或者重写为 createElement/spread 直调。
+ *
+ * v1.10 RR7 init:
+ * - 注册 /serenity-init slash command
+ * - onSelect(dialog) → DialogPrompt → initSerenity
+ * - 失败用 toast 通知（不抛错给 TUI）
+ * - 成功提示"请重启 opencode"（不做 live re-activation）
+ *
+ * v1.10.1 修复（/serenity-init 在非 serenity 目录不可见的 bug）：
+ * - 根因：plugin path 只登记在项目 tui.json；非 serenity 目录 walk-up
+ *   找不到 tui.json → plugin 不加载 → Tui(api) 永不调 → slash 不出现
+ *   详见 AGENT_SESSIONS/2026-06-06--S020--fix-serenity-init-visibility
+ * - 修复：B 段自安装到 global tui.json（$XDG_CONFIG_HOME/opencode/tui.json
+ *   或 ~/.config/opencode/tui.json），让 opencode 在**任何**目录启动都加载
+ *   plugin。slash command 注册不受 self-install 成功与否影响
+ *   （try/catch 包住，失败仅 log.warn）
+ * - 一次性行为：self-install 幂等，no-op 当 plugin path 已存在
+ *
+ * v1.15 版本号可见性:
+ * - 每次 plugin 加载在 toast 里显示 `opencode-serenity-plugin v${VERSION}`，
+ *   用户重启 opencode 时即可确认实际加载的版本（避免 dev 缓存/旧 dist）。
+ * - VERSION 动态从 package.json 读（`import pkg ... with { type: 'json' }`），
+ *   release 时改 package.json#version 即可，无需同步本文件。
+ * - "loaded" toast 放在 self-install 之前，无论 self-install 是否成功都
+ *   能看到版本号。
+ *
+ * 与 server plugin 协同：
+ * - server plugin 负责"拦截 + 行为"（RR1-RR7 + permission auto-reply + config-patch）
+ * - tui plugin 负责"通知用户"（激活提示 + 自安装 + RR7 初始化入口）
+ */
+import { basename } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { defaultPrefix, initSerenity, isValidPrefix, } from './util/init.js';
+import { ensureGlobalTuiPluginRegistration } from './util/tui-install.js';
+import { InvalidInstanceNameError, NotInGitRepoError, InitGitCommitError, } from './errors.js';
+import { log } from './util/log.js';
+import { findSerenityRootSafe, readSerenityInstanceName } from './fs/resolve-path.js';
+import { setBashDisabled, isBashDisabled } from './bash-toggle.js';
+import pkg from '../package.json' with { type: 'json' };
+const VERSION = pkg.version;
+const Tui = async (api) => {
+    // v1.15 — 每次加载都显示版本号
+    api.ui.toast({
+        title: `opencode-serenity-plugin v${VERSION}`,
+        message: 'loaded',
+        variant: 'success',
+        duration: 3000,
+    });
+    // v0.1 D6 — 检测当前目录的宁静号状态
+    const cwd = api.state.path.directory;
+    let serenityStatus;
+    let serenityVariant;
+    let serenityInstance = null;
+    const root = findSerenityRootSafe(cwd);
+    if (root) {
+        const name = readSerenityInstanceName(root);
+        serenityInstance = name;
+        // 验证 SKILL.md 存在（RR2 同级检测）
+        const { existsSync } = await import('node:fs');
+        const { resolve } = await import('node:path');
+        const skillPath = name
+            ? resolve(root, '.opencode', 'skills', name, 'SKILL.md')
+            : null;
+        if (skillPath && existsSync(skillPath)) {
+            serenityStatus = `✓ Serenity Activated${name ? ` (${name})` : ''}`;
+            serenityVariant = 'success';
+        }
+        else {
+            serenityStatus = `⚠ Serenity Error${name ? ` (${name})` : ''}`;
+            serenityVariant = 'error';
+        }
+    }
+    else {
+        serenityStatus = '○ Serenity Not Activated';
+        serenityVariant = 'info';
+    }
+    api.ui.toast({
+        title: `serenity v${VERSION}`,
+        message: serenityInstance
+            ? `${serenityStatus} — instance: ${serenityInstance}`
+            : serenityStatus,
+        variant: serenityVariant,
+        duration: 5000,
+    });
+    // A: v1.1 — self-install to global tui.json
+    //    让 plugin 在非 serenity 目录也被加载，从而 /serenity-init 全局可见
+    //    失败不抛（仅 log），slash command 仍注册
+    try {
+        const pluginFile = fileURLToPath(import.meta.url);
+        const result = ensureGlobalTuiPluginRegistration(pluginFile);
+        if (result.changed) {
+            api.ui.toast({
+                title: 'serenity',
+                message: `opencode-serenity-plugin v${VERSION} installed; restart opencode to ` +
+                    `enable /serenity-init in non-serenity directories`,
+                variant: 'info',
+                duration: 8000,
+            });
+        }
+        else if (result.error) {
+            log.warn('tui-install', 'self-install failed; /serenity-init visible only in this project', {
+                error: result.error,
+                configPath: result.configPath,
+            });
+        }
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        log.warn('tui-install', 'unexpected error during self-install (slash command still registered)', {
+            error: reason,
+        });
+    }
+    // C: v1.10 RR7 — /serenity-init slash command
+    //    走 api.command.register（v1 SDK 的 legacy slash 入口，TS 类型仍支持）
+    //    返回值是 disposer（不存，plugin 卸载时 TUI 框架负责清理）
+    api.command?.register(() => [
+        {
+            title: 'serenity: init cwd',
+            value: 'serenity-init',
+            description: 'Create /.serenity and git-commit (requires restart)',
+            slash: { name: 'serenity-init' },
+            onSelect: (dialog) => {
+                if (!dialog) {
+                    api.ui.toast({
+                        title: 'Error',
+                        message: 'dialog unavailable; cannot open serenity init prompt',
+                        variant: 'error',
+                        duration: 5000,
+                    });
+                    return;
+                }
+                const cwd = api.state.path.directory;
+                const prefill = defaultPrefix(basename(cwd));
+                dialog.replace(() => api.ui.DialogPrompt({
+                    title: 'Initialize serenity',
+                    placeholder: 'kebab-case prefix (e.g. xx, tg)',
+                    value: prefill,
+                    onConfirm: async (value) => {
+                        const prefix = value.trim();
+                        if (!isValidPrefix(prefix)) {
+                            api.ui.toast({
+                                title: 'Error',
+                                message: `Invalid prefix "${prefix}"; ` +
+                                    `must be kebab-case (lowercase a-z, 0-9, dashes; no leading or trailing dash)`,
+                                variant: 'error',
+                                duration: 5000,
+                            });
+                            return; // dialog 保持开启，让用户改完重试
+                        }
+                        try {
+                            const result = await initSerenity(cwd, prefix);
+                            dialog.clear();
+                            if (result.kind === 'created') {
+                                api.ui.toast({
+                                    title: 'serenity',
+                                    message: `Initialized ${result.name}; please restart opencode`,
+                                    variant: 'success',
+                                    duration: 5000,
+                                });
+                            }
+                            else {
+                                api.ui.toast({
+                                    title: 'serenity',
+                                    message: `Already initialized as ${result.name}`,
+                                    variant: 'info',
+                                    duration: 5000,
+                                });
+                            }
+                        }
+                        catch (err) {
+                            dialog.clear();
+                            let msg;
+                            if (err instanceof NotInGitRepoError) {
+                                msg = 'cwd is not a git repository; run `git init` first, then `/serenity-init` again';
+                            }
+                            else if (err instanceof InitGitCommitError) {
+                                msg = `git add+commit failed (rolled back): ${err.message}`;
+                            }
+                            else if (err instanceof InvalidInstanceNameError) {
+                                msg = err.message;
+                            }
+                            else {
+                                msg = err instanceof Error ? err.message : String(err);
+                            }
+                            api.ui.toast({ title: 'Error', message: msg, variant: 'error', duration: 5000 });
+                            log.warn('serenity-init', 'init failed', { err: msg });
+                        }
+                    },
+                    onCancel: () => {
+                        dialog.clear();
+                        api.ui.toast({
+                            title: 'serenity',
+                            message: 'Cancelled',
+                            variant: 'info',
+                            duration: 5000,
+                        });
+                    },
+                }));
+            },
+        },
+        // D: /serenity-bash-on — 启用 bash
+        {
+            title: 'serenity: enable bash',
+            value: 'serenity-bash-on',
+            description: 'Enable bash tool (default)',
+            slash: { name: 'serenity-bash-on' },
+            onSelect: () => {
+                setBashDisabled(false);
+                api.ui.toast({
+                    title: 'Bash',
+                    message: 'bash is now enabled',
+                    variant: 'success',
+                    duration: 3000,
+                });
+            },
+        },
+        // D: /serenity-bash-off — 禁用 bash（静默拒绝）
+        {
+            title: 'serenity: disable bash',
+            value: 'serenity-bash-off',
+            description: 'Disable bash tool (silent reject via plugin hook)',
+            slash: { name: 'serenity-bash-off' },
+            onSelect: () => {
+                setBashDisabled(true);
+                api.ui.toast({
+                    title: 'Bash',
+                    message: 'bash is now disabled (silent reject)',
+                    variant: 'warning',
+                    duration: 3000,
+                });
+            },
+        },
+        // D: /serenity-bash-status — 查看当前状态
+        {
+            title: 'serenity: bash status',
+            value: 'serenity-bash-status',
+            description: 'Show current bash toggle status',
+            slash: { name: 'serenity-bash-status' },
+            onSelect: () => {
+                const disabled = isBashDisabled();
+                api.ui.toast({
+                    title: 'Bash Status',
+                    message: disabled ? 'bash is DISABLED (silent reject)' : 'bash is enabled',
+                    variant: disabled ? 'warning' : 'success',
+                    duration: 5000,
+                });
+            },
+        },
+    ]);
+};
+export default {
+    id: 'opencode-serenity-plugin-tui',
+    tui: Tui,
+};
+//# sourceMappingURL=tui.js.map

package/dist/tui.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,30 @@
+/**
+ * 内部类型定义 — plugin 内部状态 + 内部接口
+ *
+ * 与外部契约（contract-v0.md）区别：
+ * - 外部契约 = plugin 暴露给 opencode runtime + LLM 的接口
+ * - 内部类型 = plugin 内部模块间共享的状态 / 函数签名
+ */
+import type { PluginInput } from '@opencode-ai/plugin';
+/** plugin 激活后维护的运行时状态（仅在 plugin 内部使用） */
+export type SerenityState = {
+    /** 是否激活（RR1+RR6 任一不满足 = false）*/
+    activated: boolean;
+    /** cwd 根（git root），plugin 一切判断基于此 */
+    cwdRoot: string;
+    /** 实例名（从 /.serenity 文件内容读取）*/
+    instanceName: string;
+    /** SKILL.md 绝对路径（.opencode/skills/<instanceName>/SKILL.md）*/
+    skillPath: string;
+    /** SKILL.md 全文（phase2 读取，用于 system.transform 注入到 system prompt）*/
+    skillContent: string | null;
+    /** 激活失败原因（仅在 activated=false 时有意义）*/
+    failureReason?: string;
+};
+/** plugin 不激活时的状态工厂 */
+export declare const INACTIVE_STATE: Readonly<SerenityState>;
+/** PluginInput 的简化别名（plugin 入口签名用） */
+export type SerenityPluginInput = PluginInput;
+/** 错误恢复策略（每个 hook 内部决定如何处理抛错） */
+export type ErrorRecovery = 'silent' | 'log' | 'throw';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,yCAAyC;AACzC,MAAM,MAAM,aAAa,GAAG;IAC1B,iCAAiC;IACjC,SAAS,EAAE,OAAO,CAAC;IACnB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,6DAA6D;IAC7D,SAAS,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,qCAAqC;IACrC,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,uBAAuB;AACvB,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,aAAa,CAOjD,CAAC;AAEH,sCAAsC;AACtC,MAAM,MAAM,mBAAmB,GAAG,WAAW,CAAC;AAE9C,iCAAiC;AACjC,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,KAAK,GAAG,OAAO,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,17 @@
+/**
+ * 内部类型定义 — plugin 内部状态 + 内部接口
+ *
+ * 与外部契约（contract-v0.md）区别：
+ * - 外部契约 = plugin 暴露给 opencode runtime + LLM 的接口
+ * - 内部类型 = plugin 内部模块间共享的状态 / 函数签名
+ */
+/** plugin 不激活时的状态工厂 */
+export const INACTIVE_STATE = Object.freeze({
+    activated: false,
+    cwdRoot: '',
+    instanceName: '',
+    skillPath: '',
+    skillContent: null,
+    failureReason: 'plugin not activated',
+});
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoBH,uBAAuB;AACvB,MAAM,CAAC,MAAM,cAAc,GAA4B,MAAM,CAAC,MAAM,CAAC;IACnE,SAAS,EAAE,KAAK;IAChB,OAAO,EAAE,EAAE;IACX,YAAY,EAAE,EAAE;IAChB,SAAS,EAAE,EAAE;IACb,YAAY,EAAE,IAAI;IAClB,aAAa,EAAE,sBAAsB;CACtC,CAAC,CAAC"}

package/dist/util/config-patch.d.ts

@@ -0,0 +1,58 @@
+/**
+ * opencode.json 自动 patch 模块（v1.7）
+ *
+ * 目标：plugin 启动时自动修正主仓 opencode.json（让 cwdRoot 内 read/edit = allow）。
+ * 与 v1.5 init-check 的关系：
+ * - v1.5 只 warn 不 patch
+ * - v1.7 **自动 patch**（用户 m0649 决定"全自动"）
+ *
+ * 行为：
+ * - 幂等（已 "allow" 跳过）
+ * - 缺 permission 字段自动补
+ * - 自动 `git add + commit`
+ * - 失败 log.warn（不阻断 plugin 启动）
+ * - 改完调 TUI toast 通知用户
+ */
+export type PatchField = 'read' | 'edit';
+export type PatchResult = {
+    changed: boolean;
+    diff: Array<{
+        path: string;
+        from: unknown;
+        to: unknown;
+    }>;
+    configPath: string;
+    error?: string;
+};
+/**
+ * TUI toast 客户端最小接口 (v1.18 抽出)
+ *
+ * 设计：保持 config-patch 与具体 opencode 客户端类型解耦。
+ * activation.ts 通过 `as ToastClient | null` 适配（避免反推 v1/v2 客户端类型）。
+ */
+export type ToastOpts = {
+    title?: string;
+    message: string;
+    variant?: 'info' | 'success' | 'warning' | 'error';
+    duration?: number;
+};
+export type ToastClient = {
+    tui?: {
+        showToast: (opts: {
+            body: ToastOpts;
+        }) => Promise<unknown>;
+    };
+};
+/** 工厂签名：返回 toast 客户端或 null */
+export type GetToastClient = () => ToastClient | null;
+/**
+ * Patch 主仓 opencode.json（idempotent + 自动 commit）
+ *
+ * 目标：permission.read 和 permission.edit 设为 "allow"
+ * 已为 "allow" 跳过；缺 permission 字段自动建
+ *
+ * @param cwdRoot 主仓根路径
+ * @param getClient SDK client 工厂（用于 tui toast 通知）—— 可选
+ */
+export declare function patchMainRepoOpencodeJson(cwdRoot: string, getClient?: GetToastClient): Promise<PatchResult>;
+//# sourceMappingURL=config-patch.d.ts.map

package/dist/util/config-patch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-patch.d.ts","sourceRoot":"","sources":["../../src/util/config-patch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzC,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,EAAE,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;IAC1D,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAKF;;;;;GAKG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,GAAG,CAAC,EAAE;QACJ,SAAS,EAAE,CAAC,IAAI,EAAE;YAAE,IAAI,EAAE,SAAS,CAAA;SAAE,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;KAC5D,CAAC;CACH,CAAC;AAEF,8BAA8B;AAC9B,MAAM,MAAM,cAAc,GAAG,MAAM,WAAW,GAAG,IAAI,CAAC;AA2BtD;;;;;;;;GAQG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,MAAM,EACf,SAAS,CAAC,EAAE,cAAc,GACzB,OAAO,CAAC,WAAW,CAAC,CAkEtB"}

package/dist/util/config-patch.js

@@ -0,0 +1,117 @@
+/**
+ * opencode.json 自动 patch 模块（v1.7）
+ *
+ * 目标：plugin 启动时自动修正主仓 opencode.json（让 cwdRoot 内 read/edit = allow）。
+ * 与 v1.5 init-check 的关系：
+ * - v1.5 只 warn 不 patch
+ * - v1.7 **自动 patch**（用户 m0649 决定"全自动"）
+ *
+ * 行为：
+ * - 幂等（已 "allow" 跳过）
+ * - 缺 permission 字段自动补
+ * - 自动 `git add + commit`
+ * - 失败 log.warn（不阻断 plugin 启动）
+ * - 改完调 TUI toast 通知用户
+ */
+import { readFileSync, writeFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import { log } from './log.js';
+import { gitAddAndCommit } from './git.js';
+const TOAST_TITLE = 'serenity plugin';
+const TOAST_DURATION_MS = 8000;
+/**
+ * 主仓 opencode.json 读 + 解析
+ */
+function readMainConfig(cwdRoot) {
+    const configPath = join(cwdRoot, 'opencode.json');
+    if (!existsSync(configPath)) {
+        return null;
+    }
+    try {
+        const raw = readFileSync(configPath, 'utf8');
+        return { config: JSON.parse(raw), path: configPath };
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        log.warn('config-patch', 'opencode.json parse error', { path: configPath, err: reason });
+        return null;
+    }
+}
+/**
+ * 主仓 opencode.json 写（格式化 2-space）
+ */
+function writeMainConfig(configPath, config) {
+    writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n', 'utf8');
+}
+/**
+ * Patch 主仓 opencode.json（idempotent + 自动 commit）
+ *
+ * 目标：permission.read 和 permission.edit 设为 "allow"
+ * 已为 "allow" 跳过；缺 permission 字段自动建
+ *
+ * @param cwdRoot 主仓根路径
+ * @param getClient SDK client 工厂（用于 tui toast 通知）—— 可选
+ */
+export async function patchMainRepoOpencodeJson(cwdRoot, getClient) {
+    const fields = ['read', 'edit'];
+    const read = readMainConfig(cwdRoot);
+    if (!read) {
+        return { changed: false, diff: [], configPath: join(cwdRoot, 'opencode.json'), error: 'opencode.json not found or parse error' };
+    }
+    const { config, path: configPath } = read;
+    // 计算 diff
+    const diff = [];
+    const perm = (config['permission'] ?? {});
+    const newPerm = { ...perm };
+    for (const f of fields) {
+        if (perm[f] === 'allow')
+            continue;
+        diff.push({ path: `permission.${f}`, from: perm[f] ?? null, to: 'allow' });
+        newPerm[f] = 'allow';
+    }
+    if (diff.length === 0) {
+        log.info('config-patch', 'no changes needed; already allowed', { configPath });
+        return { changed: false, diff: [], configPath };
+    }
+    // 应用 patch（只改业务字段，不加任何 marker）
+    config['permission'] = newPerm;
+    try {
+        writeMainConfig(configPath, config);
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        log.warn('config-patch', 'write failed', { configPath, err: reason });
+        return { changed: false, diff, configPath, error: `write failed: ${reason}` };
+    }
+    log.info('config-patch', 'patched opencode.json', { configPath, diff });
+    // 自动 commit（不阻断）
+    try {
+        gitAddAndCommit(cwdRoot, 'opencode.json', 'chore(serenity): auto-grant read/edit permissions');
+        log.info('config-patch', 'auto-committed', { configPath });
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        log.warn('config-patch', 'auto-commit failed; patch is on disk but uncommitted', { configPath, err: reason });
+    }
+    // TUI toast 通知用户
+    const client = getClient?.();
+    if (client?.tui?.showToast) {
+        try {
+            const fieldList = diff.map((d) => d.path.replace('permission.', '')).join(' + ');
+            await client.tui.showToast({
+                body: {
+                    title: TOAST_TITLE,
+                    message: `auto-granted ${fieldList} (restart opencode to apply)`,
+                    variant: 'info',
+                    duration: TOAST_DURATION_MS,
+                },
+            });
+        }
+        catch (err) {
+            const reason = err instanceof Error ? err.message : String(err);
+            log.warn('config-patch', 'tui toast failed (non-blocking)', { err: reason });
+        }
+    }
+    return { changed: true, diff, configPath };
+}
+//# sourceMappingURL=config-patch.js.map

package/dist/util/config-patch.js.map

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

package/dist/util/git.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Git 工具 — RR6 验证 + git root 查找
+ *
+ * 严格使用 SDK 提供的 `input.$` (BunShell) — 不调 git 二进制以保证一致性
+ * 注：v0 实际测试中发现 input.$ 是 BunShell，与 POSIX shell 有差异
+ * v0 改用 spawn git 二进制（通过 node:child_process），更可靠
+ */
+/**
+ * 从任意 cwd 出发，向上 walk 找到 git root（git rev-parse --show-toplevel）
+ * @throws NotInGitRepoError 如果不在 git repo 内
+ */
+export declare function findGitRoot(cwd: string): string;
+/**
+ * 同 findGitRoot，但不在 git repo 时返回 null 而非抛错
+ * 给 bin/opencode-serenity-plugin.js 用（不抛错便于分支处理）
+ */
+export declare function tryFindGitRoot(cwd: string): string | null;
+/**
+ * 判断 childPath 是否在 parentPath 内（路径前缀比较）
+ * - 规范化路径（resolve）
+ * - 用 path.relative 算相对路径
+ * - 相对路径不以 '..' 开头 = 在内部
+ */
+export declare function isPathInside(parentPath: string, childPath: string): boolean;
+/** git repo 是否是干净的（用于 RR7 init 前的 sanity check） */
+export declare function isGitClean(cwd: string): boolean;
+/** git add + commit（用于 RR7） */
+export declare function gitAddAndCommit(cwd: string, file: string, message: string): void;
+//# sourceMappingURL=git.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../src/util/git.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH;;;GAGG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAW/C;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAMzD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAM3E;AAED,mDAAmD;AACnD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO/C;AAED,+BAA+B;AAC/B,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAQhF"}

package/dist/util/git.js

@@ -0,0 +1,74 @@
+/**
+ * Git 工具 — RR6 验证 + git root 查找
+ *
+ * 严格使用 SDK 提供的 `input.$` (BunShell) — 不调 git 二进制以保证一致性
+ * 注：v0 实际测试中发现 input.$ 是 BunShell，与 POSIX shell 有差异
+ * v0 改用 spawn git 二进制（通过 node:child_process），更可靠
+ */
+import { execFileSync } from 'node:child_process';
+import { NotInGitRepoError } from '../errors.js';
+/**
+ * 从任意 cwd 出发，向上 walk 找到 git root（git rev-parse --show-toplevel）
+ * @throws NotInGitRepoError 如果不在 git repo 内
+ */
+export function findGitRoot(cwd) {
+    try {
+        const out = execFileSync('git', ['rev-parse', '--show-toplevel'], {
+            cwd,
+            encoding: 'utf8',
+            stdio: ['ignore', 'pipe', 'ignore'],
+        });
+        return out.trim();
+    }
+    catch {
+        throw new NotInGitRepoError(cwd);
+    }
+}
+/**
+ * 同 findGitRoot，但不在 git repo 时返回 null 而非抛错
+ * 给 bin/opencode-serenity-plugin.js 用（不抛错便于分支处理）
+ */
+export function tryFindGitRoot(cwd) {
+    try {
+        return findGitRoot(cwd);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 判断 childPath 是否在 parentPath 内（路径前缀比较）
+ * - 规范化路径（resolve）
+ * - 用 path.relative 算相对路径
+ * - 相对路径不以 '..' 开头 = 在内部
+ */
+export function isPathInside(parentPath, childPath) {
+    const parent = parentPath.replace(/\/+$/, '');
+    const child = childPath.startsWith('/') ? childPath : `/${childPath}`;
+    // 简单前缀比较（已规范化的绝对路径）
+    if (parent === '/')
+        return child.startsWith('/');
+    return child === parent || child.startsWith(parent + '/');
+}
+/** git repo 是否是干净的（用于 RR7 init 前的 sanity check） */
+export function isGitClean(cwd) {
+    try {
+        execFileSync('git', ['diff-index', '--quiet', 'HEAD', '--'], { cwd, stdio: 'ignore' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/** git add + commit（用于 RR7） */
+export function gitAddAndCommit(cwd, file, message) {
+    try {
+        execFileSync('git', ['add', file], { cwd, stdio: 'ignore' });
+        execFileSync('git', ['commit', '-m', message], { cwd, stdio: 'ignore' });
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        throw new Error(`git add+commit failed: ${reason}`);
+    }
+}
+//# sourceMappingURL=git.js.map

package/dist/util/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../src/util/git.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,KAAK,EAAE,CAAC,WAAW,EAAE,iBAAiB,CAAC,EAAE;YAChE,GAAG;YACH,QAAQ,EAAE,MAAM;YAChB,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC;SACpC,CAAC,CAAC;QACH,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACnC,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,IAAI,CAAC;QACH,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,UAAkB,EAAE,SAAiB;IAChE,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,SAAS,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,SAAS,EAAE,CAAC;IACtE,oBAAoB;IACpB,IAAI,MAAM,KAAK,GAAG;QAAE,OAAO,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACjD,OAAO,KAAK,KAAK,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;AAC5D,CAAC;AAED,mDAAmD;AACnD,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,IAAI,CAAC;QACH,YAAY,CAAC,KAAK,EAAE,CAAC,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACvF,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,+BAA+B;AAC/B,MAAM,UAAU,eAAe,CAAC,GAAW,EAAE,IAAY,EAAE,OAAe;IACxE,IAAI,CAAC;QACH,YAAY,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC7D,YAAY,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IAC3E,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAChE,MAAM,IAAI,KAAK,CAAC,0BAA0B,MAAM,EAAE,CAAC,CAAC;IACtD,CAAC;AACH,CAAC"}