@shgroup/opencode-serenity-plugin 0.2.0

package/dist/install.js

@@ -0,0 +1,255 @@
+/**
+ * v1.11 — bin install CLI lib (pure logic, no side effects at import)
+ *
+ * 职责:
+ * - 检测 global config home (XDG_CONFIG_HOME / ~/.config / %APPDATA%)
+ * - 解析 install path → 两个 plugin entry (server + tui)
+ * - 读写 JSON config (atomic write via tmp + rename)
+ * - 幂等: 同一 plugin (id 或 abs path) 不重复添加
+ * - 追踪 _plugin_origins: 知道每个 entry 是哪个 plugin 装的、何时装、从哪装
+ *
+ * 与 src/util/tui-install.ts 的关系:
+ * - tui-install.ts 只管 global tui.json,只放 dist/tui.js,函数风格 imperative
+ * - install.ts 通用化: 既管 tui.json 也管 opencode.json,同时写多个 entry
+ * - 复用 tui-install.ts 的 toPluginSpec 思想 (realpath + file://)
+ *
+ * D23 (2026-06-07): 两 entry 架构不可破 — server entry 仅 project-level
+ *   加载,TUI entry 全局加载,保留 V2 非侵入语义。
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync, renameSync, realpathSync, } from 'node:fs';
+import { dirname, join, isAbsolute } from 'node:path';
+import { homedir, platform } from 'node:os';
+import { pathToFileURL } from 'node:url';
+export const PLUGIN_ID = 'opencode-serenity-plugin';
+const DIST_DIR = 'dist';
+const SERVER_ENTRY_FILENAME = 'index.js';
+const TUI_ENTRY_FILENAME = 'tui.js';
+const OPENCODE_SCHEMA_URL = 'https://opencode.ai/config.json';
+const TUI_SCHEMA_URL = 'https://opencode.ai/tui.json';
+// ── 路径解析 ──
+/**
+ * 解析 global opencode config 目录。
+ *
+ * 优先级:
+ * 1. $XDG_CONFIG_HOME/opencode (XDG Base Directory 规范,Linux/macOS)
+ * 2. $APPDATA/opencode (Windows 优先)
+ * 3. ~/AppData/Roaming/opencode (Windows 兜底)
+ * 4. ~/.config/opencode (Unix 兜底)
+ */
+export function detectGlobalConfigHome() {
+    const xdg = process.env['XDG_CONFIG_HOME'];
+    if (typeof xdg === 'string' && xdg.trim().length > 0) {
+        return join(xdg, 'opencode');
+    }
+    if (platform() === 'win32') {
+        const appdata = process.env['APPDATA'];
+        if (typeof appdata === 'string' && appdata.trim().length > 0) {
+            return join(appdata, 'opencode');
+        }
+        return join(homedir(), 'AppData', 'Roaming', 'opencode');
+    }
+    return join(homedir(), '.config', 'opencode');
+}
+/** global config 文件路径 */
+export function getGlobalConfigPath(filename) {
+    return join(detectGlobalConfigHome(), filename);
+}
+/**
+ * 解析 install path → 两个 plugin entry。
+ *
+ * - installPath 应为 package 根目录 (含 dist/index.js + dist/tui.js)
+ * - 自动 realpath 解析 symlink (npm global install / pnpm link 都会建 symlink)
+ * - 绝对路径验证 (相对路径直接抛)
+ */
+export function resolvePluginEntries(installPath) {
+    if (!isAbsolute(installPath)) {
+        throw new Error(`installPath must be absolute: ${installPath}`);
+    }
+    const realInstall = realpathSync(installPath);
+    const serverAbs = join(realInstall, DIST_DIR, SERVER_ENTRY_FILENAME);
+    const tuiAbs = join(realInstall, DIST_DIR, TUI_ENTRY_FILENAME);
+    return {
+        id: PLUGIN_ID,
+        server: {
+            id: PLUGIN_ID,
+            path: pathToFileURL(serverAbs).href,
+            absPath: serverAbs,
+        },
+        tui: {
+            id: PLUGIN_ID,
+            path: pathToFileURL(tuiAbs).href,
+            absPath: tuiAbs,
+        },
+    };
+}
+/**
+ * 从 bin 文件路径反推 install path (package 根目录)。
+ *
+ * 用于 CLI: bin 位于 <pkg>/bin/<name>.js,install path = <pkg>/。
+ * 自动 realpath 解析 symlink (npm global install 会建 symlink)。
+ */
+export function resolveInstallPathFromBin(binFilePath) {
+    if (!isAbsolute(binFilePath)) {
+        throw new Error(`bin path must be absolute: ${binFilePath}`);
+    }
+    const realBin = realpathSync(binFilePath);
+    // <pkg>/bin/<name>.js → dirname = <pkg>/bin → dirname = <pkg>
+    return dirname(dirname(realBin));
+}
+// ── JSON I/O ──
+/**
+ * 读 JSON config。文件不存在或为空 → 返回 {}。
+ *
+ * 严格模式 (v1.18 收口 — 旧 tui-install.ts 行为):
+ * - 文件不存在或空 → 返回 {} (允许新装)
+ * - JSON.parse 失败 → 抛 Error (writePluginEntry 捕获并返回 error, 不覆盖用户数据)
+ * - 根节点非 object (array / null / 标量) → 抛 Error
+ *
+ * 不抛的"宽松"行为会静默覆盖用户已损坏的 config, 风险高。
+ * 严格模式让 writePluginEntry 显式告诉用户 "config 损坏, 请人工修复"。
+ */
+export function readJsonConfig(path) {
+    if (!existsSync(path)) {
+        return {};
+    }
+    const text = readFileSync(path, 'utf8');
+    if (text.trim().length === 0) {
+        return {};
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(text);
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        throw new Error(`parse error: ${reason}`);
+    }
+    if (parsed === null) {
+        throw new Error(`config root is null, expected object`);
+    }
+    if (typeof parsed !== 'object' || Array.isArray(parsed)) {
+        throw new Error(`config root is not an object (got ${Array.isArray(parsed) ? 'array' : typeof parsed})`);
+    }
+    return parsed;
+}
+/**
+ * 原子写 JSON config。
+ *
+ * 流程: mkdir -p parent → 写 path.tmp → rename 到 path。
+ * rename 在同一文件系统下是原子操作,避免半写状态。
+ */
+export function writeJsonConfig(path, data) {
+    mkdirSync(dirname(path), { recursive: true });
+    const tmpPath = `${path}.tmp`;
+    writeFileSync(tmpPath, JSON.stringify(data, null, 2) + '\n', 'utf8');
+    renameSync(tmpPath, path);
+}
+// ── 幂等检查 ──
+/** 提取 plugin 数组里所有 entry 的主 spec (string 或 [string, opts] tuple) */
+function collectExistingSpecs(plugin) {
+    const specs = new Set();
+    if (!Array.isArray(plugin))
+        return specs;
+    for (const item of plugin) {
+        if (typeof item === 'string') {
+            specs.add(item);
+        }
+        else if (Array.isArray(item) && typeof item[0] === 'string') {
+            specs.add(item[0]);
+        }
+    }
+    return specs;
+}
+/**
+ * 判定 entries 是否已安装。
+ *
+ * 只检查 plugin 数组：已有相同 file:// URL 的视为已安装 (string / tuple 形式)
+ * 不写 _plugin_origins — opencode 严格校验 config JSON schema，不认未知 key。
+ *
+ * 返回 true = 全部 entries 都不必再写 (no-op)
+ * 返回 false = 至少一个 entry 还没装
+ */
+export function isAlreadyInstalled(entries, existing) {
+    if (entries.length === 0)
+        return true;
+    const existingSpecs = collectExistingSpecs(existing['plugin']);
+    for (const entry of entries) {
+        if (existingSpecs.has(entry.path)) {
+            return true;
+        }
+    }
+    return false;
+}
+// ── 主入口 ──
+/**
+ * 把 plugin entries 写入 config file 的 `plugin` 数组 (idempotent)。
+ *
+ * 行为契约:
+ * - 文件不存在 → 创建 (含 $schema + plugin 数组)
+ * - 已有 plugin 数组 → 保留,append 不重复 entry
+ * - 已有非 plugin 字段 → 完全保留
+ * - 写失败 → 返回 { changed: false, error },不抛
+ *
+ * 注意: 不写 _plugin_origins 等非标准 key — opencode 严格校验 config schema。
+ *
+ * @param configPath  目标 config 文件绝对路径
+ * @param entries     要注册的 plugin entries (server/tui 之一或两者)
+ */
+export function writePluginEntry(configPath, entries) {
+    if (entries.length === 0) {
+        return { changed: false, configPath, skippedPaths: [] };
+    }
+    let config;
+    try {
+        config = readJsonConfig(configPath);
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        return { changed: false, configPath, error: `read failed: ${reason}` };
+    }
+    // 分离: 真正要新增的 vs 已存在的（只检查 plugin 数组，不写 _plugin_origins）
+    const existingSpecs = collectExistingSpecs(config['plugin']);
+    const currentPlugin = Array.isArray(config['plugin']) ? config['plugin'] : [];
+    const toAdd = [];
+    const skipped = [];
+    for (const entry of entries) {
+        if (existingSpecs.has(entry.path)) {
+            skipped.push(entry.path);
+        }
+        else {
+            toAdd.push(entry.path);
+        }
+    }
+    if (toAdd.length === 0) {
+        return {
+            changed: false,
+            configPath,
+            skippedPaths: skipped,
+        };
+    }
+    // 追加 spec
+    for (const spec of toAdd) {
+        currentPlugin.push(spec);
+    }
+    config['plugin'] = currentPlugin;
+    // 新文件加 $schema (与 tui-install.ts 一致)
+    if (!('$schema' in config)) {
+        config['$schema'] = configPath.endsWith('tui.json')
+            ? TUI_SCHEMA_URL
+            : OPENCODE_SCHEMA_URL;
+    }
+    try {
+        writeJsonConfig(configPath, config);
+    }
+    catch (err) {
+        const reason = err instanceof Error ? err.message : String(err);
+        return { changed: false, configPath, error: `write failed: ${reason}` };
+    }
+    return {
+        changed: true,
+        configPath,
+        addedPaths: toAdd,
+        skippedPaths: skipped,
+    };
+}
+//# sourceMappingURL=install.js.map

package/dist/install.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.js","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EACL,YAAY,EACZ,aAAa,EACb,UAAU,EACV,SAAS,EACT,UAAU,EACV,YAAY,GACb,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACtD,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,MAAM,CAAC,MAAM,SAAS,GAAG,0BAA0B,CAAC;AACpD,MAAM,QAAQ,GAAG,MAAM,CAAC;AACxB,MAAM,qBAAqB,GAAG,UAAU,CAAC;AACzC,MAAM,kBAAkB,GAAG,QAAQ,CAAC;AACpC,MAAM,mBAAmB,GAAG,iCAAiC,CAAC;AAC9D,MAAM,cAAc,GAAG,8BAA8B,CAAC;AAiCtD,aAAa;AAEb;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB;IACpC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;IAC3C,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrD,OAAO,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,QAAQ,EAAE,KAAK,OAAO,EAAE,CAAC;QAC3B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACvC,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7D,OAAO,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;QACnC,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;IAC3D,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AAChD,CAAC;AAED,yBAAyB;AACzB,MAAM,UAAU,mBAAmB,CAAC,QAAoB;IACtD,OAAO,IAAI,CAAC,sBAAsB,EAAE,EAAE,QAAQ,CAAC,CAAC;AAClD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,oBAAoB,CAAC,WAAmB;IACtD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,iCAAiC,WAAW,EAAE,CAAC,CAAC;IAClE,CAAC;IACD,MAAM,WAAW,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,qBAAqB,CAAC,CAAC;IACrE,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,kBAAkB,CAAC,CAAC;IAC/D,OAAO;QACL,EAAE,EAAE,SAAS;QACb,MAAM,EAAE;YACN,EAAE,EAAE,SAAS;YACb,IAAI,EAAE,aAAa,CAAC,SAAS,CAAC,CAAC,IAAI;YACnC,OAAO,EAAE,SAAS;SACnB;QACD,GAAG,EAAE;YACH,EAAE,EAAE,SAAS;YACb,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,IAAI;YAChC,OAAO,EAAE,MAAM;SAChB;KACF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,WAAmB;IAC3D,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,8BAA8B,WAAW,EAAE,CAAC,CAAC;IAC/D,CAAC;IACD,MAAM,OAAO,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;IAC1C,8DAA8D;IAC9D,OAAO,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC;AACnC,CAAC;AAED,iBAAiB;AAEjB;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,IAAI,GAAG,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5B,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,gBAAgB,MAAM,EAAE,CAAC,CAAC;IAC5C,CAAC;IACD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;IAC1D,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QACxD,MAAM,IAAI,KAAK,CAAC,qCAAqC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,MAAM,GAAG,CAAC,CAAC;IAC3G,CAAC;IACD,OAAO,MAAoB,CAAC;AAC9B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,IAAgB;IAC5D,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,GAAG,IAAI,MAAM,CAAC;IAC9B,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IACrE,UAAU,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,aAAa;AAEb,oEAAoE;AACpE,SAAS,oBAAoB,CAAC,MAAe;IAC3C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IACzC,KAAK,MAAM,IAAI,IAAI,MAAM,EAAE,CAAC;QAC1B,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,EAAE,CAAC;YAC9D,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAsB,EACtB,QAAoB;IAEpB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAEtC,MAAM,aAAa,GAAG,oBAAoB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IAE/D,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,YAAY;AAEZ;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,gBAAgB,CAC9B,UAAkB,EAClB,OAAsB;IAEtB,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,EAAE,EAAE,CAAC;IAC1D,CAAC;IAED,IAAI,MAAkB,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,GAAG,cAAc,CAAC,UAAU,CAAC,CAAC;IACtC,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,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,gBAAgB,MAAM,EAAE,EAAE,CAAC;IACzE,CAAC;IAED,uDAAuD;IACvD,MAAM,aAAa,GAAG,oBAAoB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7D,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9E,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YAClC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,UAAU;YACV,YAAY,EAAE,OAAO;SACtB,CAAC;IACJ,CAAC;IAED,UAAU;IACV,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IACD,MAAM,CAAC,QAAQ,CAAC,GAAG,aAAa,CAAC;IAEjC,qCAAqC;IACrC,IAAI,CAAC,CAAC,SAAS,IAAI,MAAM,CAAC,EAAE,CAAC;QAC3B,MAAM,CAAC,SAAS,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,UAAU,CAAC;YACjD,CAAC,CAAC,cAAc;YAChB,CAAC,CAAC,mBAAmB,CAAC;IAC1B,CAAC;IAED,IAAI,CAAC;QACH,eAAe,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IACtC,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,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,iBAAiB,MAAM,EAAE,EAAE,CAAC;IAC1E,CAAC;IAED,OAAO;QACL,OAAO,EAAE,IAAI;QACb,UAAU;QACV,UAAU,EAAE,KAAK;QACjB,YAAY,EAAE,OAAO;KACtB,CAAC;AACJ,CAAC"}

package/dist/msm-schema.d.ts

@@ -0,0 +1,76 @@
+/**
+ * MSM flag 规范解析 + path-arg 校验（v1.2 修复）
+ *
+ * 设计目标：让 plugin 兼容 **两种 msm schema**：
+ *
+ * **v1 schema**（主仓实际使用）：
+ *   ```json
+ *   flags: [{ "flag": "--check <路径>", "description": "..." }]
+ *   ```
+ *   - 字段是 `flag`（含 `--` 整字符串）
+ *   - 路径型用 valueHint `<路径>` / `<path>` 标记
+ *   - 无 type 字段
+ *
+ * **v0 schema**（plugin 仓设计）：
+ *   ```json
+ *   flags: [{ "name": "check", "type": "path", "description": "..." }]
+ *   ```
+ *
+ * 输出统一 NormalizedFlag[]：
+ *   - name: 'check'（不带 `--`）
+ *   - hasValue: boolean
+ *   - valueHint: '路径'（v1 schema 提取）
+ *   - isPath: boolean
+ *
+ * 校验流程：
+ * 1. CLI args 字符串 → tokenize（支持引号）
+ * 2. token pair `--flag value` → 查 normalizeFlags 找 isPath 标记
+ * 3. 路径型 → isPathInside 黑名单 + symlink 防御
+ */
+/** 原始 flag 字段（v1 schema 用 `flag`，v0 schema 用 `name`） */
+type RawFlag = {
+    flag?: string;
+    name?: string;
+    type?: string;
+    description?: string;
+    required?: boolean;
+    default?: unknown;
+};
+/** 规范化后的 flag（plugin 内部统一使用） */
+export type NormalizedFlag = {
+    name: string;
+    hasValue: boolean;
+    valueHint: string | undefined;
+    isPath: boolean;
+    type: string | undefined;
+    required: boolean;
+};
+/** 规范化单个 flag（兼容 v0 / v1 schema） */
+export declare function normalizeFlag(raw: RawFlag): NormalizedFlag | null;
+/** 批量规范化 */
+export declare function normalizeFlags(rawFlags: RawFlag[]): NormalizedFlag[];
+/** 从 normalized flags 提取所有 path-arg 名字 */
+export declare function getPathArgNames(normalized: NormalizedFlag[]): string[];
+/**
+ * 轻量 shell tokenize（支持单/双引号 + 转义）。
+ * 不支持 glob / 变量展开（msm 脚本不需要）。
+ * 示例：
+ *   '--check .opencode/x' → ['--check', '.opencode/x']
+ *   '--name "hello world"' → ['--name', 'hello world']
+ *   '--root' → ['--root']
+ */
+export declare function tokenizeArgs(args: string): string[];
+/**
+ * 校验 tokenized CLI args 中的 path-arg。
+ * 启发式：解析 `--flag value` / `--flag=value` 形式，对 valueHint 标为 path 的 flag 做 isPathInside 检查。
+ *
+ * 行为细节：
+ * - 非 path-arg 不校验
+ * - token 顺序解析，--flag 后面跟的 token 是 value
+ * - = 形式 --flag=value 不校验（罕见）
+ * - 文件不存在（写文件场景）→ 通过
+ * - symlink 防御
+ */
+export declare function validatePathArgsFromTokens(tokens: string[], normalized: NormalizedFlag[], cwdRoot: string): void;
+export {};
+//# sourceMappingURL=msm-schema.d.ts.map

package/dist/msm-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"msm-schema.d.ts","sourceRoot":"","sources":["../src/msm-schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAOH,wDAAwD;AACxD,KAAK,OAAO,GAAG;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAC;AAEF,gCAAgC;AAChC,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IACzB,QAAQ,EAAE,OAAO,CAAC;CACnB,CAAC;AAwCF,oCAAoC;AACpC,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAwBjE;AAED,YAAY;AACZ,wBAAgB,cAAc,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,cAAc,EAAE,CAOpE;AAED,0CAA0C;AAC1C,wBAAgB,eAAe,CAAC,UAAU,EAAE,cAAc,EAAE,GAAG,MAAM,EAAE,CAEtE;AAID;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAqCnD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,MAAM,EAAE,EAChB,UAAU,EAAE,cAAc,EAAE,EAC5B,OAAO,EAAE,MAAM,GACd,IAAI,CAoCN"}

package/dist/msm-schema.js

@@ -0,0 +1,207 @@
+/**
+ * MSM flag 规范解析 + path-arg 校验（v1.2 修复）
+ *
+ * 设计目标：让 plugin 兼容 **两种 msm schema**：
+ *
+ * **v1 schema**（主仓实际使用）：
+ *   ```json
+ *   flags: [{ "flag": "--check <路径>", "description": "..." }]
+ *   ```
+ *   - 字段是 `flag`（含 `--` 整字符串）
+ *   - 路径型用 valueHint `<路径>` / `<path>` 标记
+ *   - 无 type 字段
+ *
+ * **v0 schema**（plugin 仓设计）：
+ *   ```json
+ *   flags: [{ "name": "check", "type": "path", "description": "..." }]
+ *   ```
+ *
+ * 输出统一 NormalizedFlag[]：
+ *   - name: 'check'（不带 `--`）
+ *   - hasValue: boolean
+ *   - valueHint: '路径'（v1 schema 提取）
+ *   - isPath: boolean
+ *
+ * 校验流程：
+ * 1. CLI args 字符串 → tokenize（支持引号）
+ * 2. token pair `--flag value` → 查 normalizeFlags 找 isPath 标记
+ * 3. 路径型 → isPathInside 黑名单 + symlink 防御
+ */
+import { resolve as resolvePath } from 'node:path';
+import { realpathSync, existsSync } from 'node:fs';
+import { isPathInside } from './util/git.js';
+import { MsmPathEscapeError, MsmSymlinkError } from './errors.js';
+/** v1 schema 的 valueHint 视为"路径型" */
+const PATH_VALUE_HINTS = new Set([
+    '路径',
+    'path',
+    'file',
+    'filePath',
+    'filepath',
+    'dir',
+    'directory',
+    '文件',
+    '目录',
+    'url',
+    'uri',
+]);
+/** v0 schema 的 type 视为"路径型" */
+const PATH_ARG_TYPES = new Set([
+    'path',
+    'file',
+    'filePath',
+    'filepath',
+    'dir',
+    'directory',
+]);
+/** v1 schema flag 字符串 → {name, hasValue, valueHint} */
+function parseV1Flag(flagStr) {
+    const m = /^--([\w-]+)(?:[=\s]+(?:<(.+?)>))?$/.exec(flagStr.trim());
+    if (!m) {
+        return { name: flagStr, hasValue: false, valueHint: undefined };
+    }
+    return {
+        name: m[1],
+        hasValue: m[2] !== undefined,
+        valueHint: m[2],
+    };
+}
+/** 规范化单个 flag（兼容 v0 / v1 schema） */
+export function normalizeFlag(raw) {
+    if (typeof raw.name === 'string') {
+        const type = raw.type;
+        return {
+            name: raw.name,
+            hasValue: type !== 'boolean',
+            valueHint: undefined,
+            isPath: type !== undefined && PATH_ARG_TYPES.has(type),
+            type,
+            required: raw.required ?? false,
+        };
+    }
+    if (typeof raw.flag === 'string') {
+        const parsed = parseV1Flag(raw.flag);
+        return {
+            name: parsed.name,
+            hasValue: parsed.hasValue,
+            valueHint: parsed.valueHint,
+            isPath: parsed.valueHint !== undefined && PATH_VALUE_HINTS.has(parsed.valueHint),
+            type: undefined,
+            required: false,
+        };
+    }
+    return null;
+}
+/** 批量规范化 */
+export function normalizeFlags(rawFlags) {
+    const out = [];
+    for (const raw of rawFlags) {
+        const norm = normalizeFlag(raw);
+        if (norm !== null)
+            out.push(norm);
+    }
+    return out;
+}
+/** 从 normalized flags 提取所有 path-arg 名字 */
+export function getPathArgNames(normalized) {
+    return normalized.filter((f) => f.isPath).map((f) => f.name);
+}
+/* ===== CLI tokenize + path-arg 校验（v1.2 简化为启发式） ===== */
+/**
+ * 轻量 shell tokenize（支持单/双引号 + 转义）。
+ * 不支持 glob / 变量展开（msm 脚本不需要）。
+ * 示例：
+ *   '--check .opencode/x' → ['--check', '.opencode/x']
+ *   '--name "hello world"' → ['--name', 'hello world']
+ *   '--root' → ['--root']
+ */
+export function tokenizeArgs(args) {
+    const out = [];
+    let cur = '';
+    let inSingle = false;
+    let inDouble = false;
+    let hasToken = false;
+    for (let i = 0; i < args.length; i++) {
+        const c = args[i];
+        if (c === '\\' && i + 1 < args.length) {
+            cur += args[i + 1];
+            i++;
+            hasToken = true;
+            continue;
+        }
+        if (c === "'" && !inDouble) {
+            inSingle = !inSingle;
+            hasToken = true;
+            continue;
+        }
+        if (c === '"' && !inSingle) {
+            inDouble = !inDouble;
+            hasToken = true;
+            continue;
+        }
+        if (/\s/.test(c) && !inSingle && !inDouble) {
+            if (hasToken) {
+                out.push(cur);
+                cur = '';
+                hasToken = false;
+            }
+            continue;
+        }
+        cur += c;
+        hasToken = true;
+    }
+    if (hasToken)
+        out.push(cur);
+    return out;
+}
+/**
+ * 校验 tokenized CLI args 中的 path-arg。
+ * 启发式：解析 `--flag value` / `--flag=value` 形式，对 valueHint 标为 path 的 flag 做 isPathInside 检查。
+ *
+ * 行为细节：
+ * - 非 path-arg 不校验
+ * - token 顺序解析，--flag 后面跟的 token 是 value
+ * - = 形式 --flag=value 不校验（罕见）
+ * - 文件不存在（写文件场景）→ 通过
+ * - symlink 防御
+ */
+export function validatePathArgsFromTokens(tokens, normalized, cwdRoot) {
+    // path-arg names 集合
+    const pathArgNames = new Set(getPathArgNames(normalized));
+    for (let i = 0; i < tokens.length; i++) {
+        const tok = tokens[i];
+        // 匹配 --flag
+        const m = /^--([\w-]+)$/.exec(tok);
+        if (!m)
+            continue;
+        const flagName = m[1];
+        if (!pathArgNames.has(flagName))
+            continue;
+        // 取下一个 token 作为 value
+        const value = tokens[i + 1];
+        if (value === undefined || value.startsWith('--'))
+            continue;
+        if (typeof value !== 'string' || value.trim() === '')
+            continue;
+        const abs = resolvePath(cwdRoot, value);
+        if (!isPathInside(cwdRoot, abs)) {
+            throw new MsmPathEscapeError('msm_exec', flagName, value, abs);
+        }
+        if (existsSync(abs)) {
+            let real;
+            try {
+                real = realpathSync(abs);
+            }
+            catch {
+                throw new MsmSymlinkError('msm_exec', flagName, value, abs, 'realpath resolution failed');
+            }
+            if (real !== abs) {
+                throw new MsmSymlinkError('msm_exec', flagName, value, abs, `symlink detected: ${abs} → ${real}`);
+            }
+            if (!isPathInside(cwdRoot, real)) {
+                throw new MsmSymlinkError('msm_exec', flagName, value, abs, `symlink points outside cwdRoot: ${real}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=msm-schema.js.map

package/dist/msm-schema.js.map

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

package/dist/msm.d.ts

@@ -0,0 +1,25 @@
+/**
+ * msm.ts
+ *
+ * 工具集（3 个）：
+ * - msm_list          : PRIMARY — 列出所有 MSM
+ * - msm_exec          : PRIMARY — 执行 MSM / 协议元命令
+ * - msm_admin         : 注册 / 注销 MSM（合并 register/deregister）
+ *
+ * 注意：bash override (RR3) 已于 2026-06-08 移除。
+ */
+import { type ToolDefinition } from '@opencode-ai/plugin';
+import { type MechEntry, type RegistryFile } from './config-schema.js';
+/** 加载 mech-registry.json（v0 简化：实例内一份） */
+/** 支持两种 schema：
+ *  - v1 包装格式：{ version, description, entries: [...] }
+ *  - 数组格式：[...]
+ * 返回统一 MechEntry[]
+ */
+export declare function loadMechRegistryFrom(cwdRoot: string, instanceName: string): MechEntry[];
+export declare function loadRegistryFile(cwdRoot: string, instanceName: string): RegistryFile;
+export declare function writeRegistryFile(cwdRoot: string, instanceName: string, file: RegistryFile): void;
+export declare const msmListTool: ToolDefinition;
+export declare const msmExecTool: ToolDefinition;
+export declare const msmAdminTool: ToolDefinition;
+//# sourceMappingURL=msm.d.ts.map

package/dist/msm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"msm.d.ts","sourceRoot":"","sources":["../src/msm.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAehE,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AAM5B,yCAAyC;AACzC;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,SAAS,EAAE,CAEvF;AAMD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,YAAY,CAqCpF;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,GAAG,IAAI,CAUjG;AAkBD,eAAO,MAAM,WAAW,EAAE,cAyBxB,CAAC;AAUH,eAAO,MAAM,WAAW,EAAE,cAmDxB,CAAC;AA4GH,eAAO,MAAM,YAAY,EAAE,cA+DzB,CAAC"}