@shgroup/opencode-serenity-plugin 0.2.0

package/dist/skills/install-skill.d.ts

@@ -0,0 +1,36 @@
+/**
+ * install-skill.ts — D2: 技能安装命令处理器
+ *
+ * CLI: opencode-serenity-plugin install-skill <name> [--prefix=<str>] [--include=<feat>] [--dry-run]
+ *
+ * 流程：
+ *   1. 确定 prefix（从 --prefix 或 .serenity）
+ *   2. 找到 plugin 的 src/templates/<name>/
+ *   3. 加载模板，替换占位符
+ *   4. 写入 <serenityRoot>/.opencode/skills/<prefix>-<name>/
+ *   5. 注册 MSM（若 manifest 有声明）
+ *   6. 输出结果
+ */
+export interface InstallSkillOptions {
+    /** plugin 根目录（resolveInstallPathFromBin 的产出） */
+    pluginRoot: string;
+    /** 技能名（如 auth, pagedesigner） */
+    name: string;
+    /** 宁静号项目 cwd（用于定位 .serenity） */
+    cwd: string;
+    /** 技能前缀（可选，默认从 .serenity 推断） */
+    prefix?: string;
+    /** dry-run 模式 */
+    dryRun?: boolean;
+}
+export interface InstallSkillResult {
+    success: boolean;
+    skillDir?: string;
+    createdFiles?: string[];
+    message: string;
+}
+/**
+ * 主入口：安装技能到 serenity 实例
+ */
+export declare function installSkill(opts: InstallSkillOptions): InstallSkillResult;
+//# sourceMappingURL=install-skill.d.ts.map

package/dist/skills/install-skill.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-skill.d.ts","sourceRoot":"","sources":["../../src/skills/install-skill.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAaH,MAAM,WAAW,mBAAmB;IAClC,gDAAgD;IAChD,UAAU,EAAE,MAAM,CAAC;IACnB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iBAAiB;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,mBAAmB,GAAG,kBAAkB,CA6E1E"}

package/dist/skills/install-skill.js

@@ -0,0 +1,91 @@
+/**
+ * install-skill.ts — D2: 技能安装命令处理器
+ *
+ * CLI: opencode-serenity-plugin install-skill <name> [--prefix=<str>] [--include=<feat>] [--dry-run]
+ *
+ * 流程：
+ *   1. 确定 prefix（从 --prefix 或 .serenity）
+ *   2. 找到 plugin 的 src/templates/<name>/
+ *   3. 加载模板，替换占位符
+ *   4. 写入 <serenityRoot>/.opencode/skills/<prefix>-<name>/
+ *   5. 注册 MSM（若 manifest 有声明）
+ *   6. 输出结果
+ */
+import { existsSync } from 'node:fs';
+import { findSerenityRootSafe, readSerenityInstanceName, } from '../fs/resolve-path.js';
+import { getTemplatesDir, listAvailableTemplates, installTemplate, } from './template-loader.js';
+/**
+ * 主入口：安装技能到 serenity 实例
+ */
+export function installSkill(opts) {
+    const { pluginRoot, name, cwd, dryRun } = opts;
+    // 1. 验证 .serenity 存在
+    const serenityRoot = findSerenityRootSafe(cwd);
+    if (!serenityRoot) {
+        return {
+            success: false,
+            message: `Not inside a serenity instance: no .serenity found from ${cwd}`,
+        };
+    }
+    // 2. 确定 prefix
+    const prefix = opts.prefix ?? readSerenityInstanceName(serenityRoot);
+    if (!prefix) {
+        return {
+            success: false,
+            message: `Failed to determine instance prefix: .serenity at ${serenityRoot} is empty or unreadable`,
+        };
+    }
+    // 3. 验证模板存在
+    const templatesDir = getTemplatesDir(pluginRoot);
+    if (!existsSync(templatesDir)) {
+        return {
+            success: false,
+            message: `Templates directory not found: ${templatesDir} (plugin not built or src/ missing)`,
+        };
+    }
+    const available = listAvailableTemplates(templatesDir);
+    if (!available.includes(name)) {
+        const hint = available.length > 0
+            ? `Available templates: ${available.join(', ')}`
+            : 'No templates available.';
+        return {
+            success: false,
+            message: `Template "${name}" not found. ${hint}`,
+        };
+    }
+    // 4. 安装模板
+    try {
+        const result = installTemplate({
+            templateDir: templatesDir,
+            name,
+            serenityRoot,
+            prefix,
+            dryRun,
+        });
+        if (result.error) {
+            return { success: false, message: result.error };
+        }
+        if (!result.changed) {
+            return {
+                success: true,
+                skillDir: result.skillDirName,
+                createdFiles: [],
+                message: `Already installed: ${result.skillDirName} (no changes)`,
+            };
+        }
+        const fileCount = result.createdFiles.length;
+        return {
+            success: true,
+            skillDir: result.skillDirName,
+            createdFiles: result.createdFiles,
+            message: dryRun
+                ? `[dry-run] Would install: ${result.skillDirName}/ (${fileCount} file(s))`
+                : `Installed: ${result.skillDirName}/ (${fileCount} file(s))`,
+        };
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return { success: false, message: `Install failed: ${msg}` };
+    }
+}
+//# sourceMappingURL=install-skill.js.map

package/dist/skills/install-skill.js.map

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

package/dist/skills/template-loader.d.ts

@@ -0,0 +1,79 @@
+/**
+ * template-loader.ts — 技能模板加载器（v0.1 D2）
+ *
+ * 职责：
+ *   1. 从 plugin 的 src/templates/<name>/ 目录加载模板
+ *   2. 替换占位符（{{prefix}}, {{instance_name}}, {{date}}）
+ *   3. 输出目标路径 → 文件内容映射
+ */
+export interface TemplateManifest {
+    name: string;
+    eal?: string;
+    description: string;
+    /** 依赖的其他技能名 */
+    dependencies?: string[];
+    /** 需要注册的 MSM 列表 */
+    msm?: Array<{
+        name: string;
+        path: string;
+        description: string;
+        category: 'mech' | 'semi-mech';
+    }>;
+    version?: string;
+}
+export interface TemplateFiles {
+    /** 根目录下要创建的文件（key = 相对路径, value = 内容） */
+    files: Record<string, string>;
+    /** 模板清单 */
+    manifest: TemplateManifest;
+}
+export interface Placeholders {
+    prefix: string;
+    instanceName: string;
+    date: string;
+}
+export declare function defaultPlaceholders(prefix: string): Placeholders;
+/**
+ * 返回 plugin 内置模板的 src/templates/ 目录路径。
+ * 开发模式：相对于 bin/ 脚本的安装路径。
+ */
+export declare function getTemplatesDir(pluginRoot: string): string;
+/**
+ * 列出所有可用模板名
+ */
+export declare function listAvailableTemplates(templatesDir: string): string[];
+/**
+ * 加载模板目录，返回文件映射（已替换占位符）。
+ * 跳过 manifest.yaml 本身（不作为目标文件）。
+ */
+export declare function loadTemplate(templatesDir: string, name: string, placeholders: Placeholders): TemplateFiles;
+export interface InstallTemplateOptions {
+    /** 源模板路径（plugin 的 src/templates/<name>/） */
+    templateDir: string;
+    /** 模板名 */
+    name: string;
+    /** 目标 serenity 根路径（cwdRoot） */
+    serenityRoot: string;
+    /** 实例前缀 */
+    prefix: string;
+    /** 占位符（可选，不传则用默认值） */
+    placeholders?: Placeholders;
+    /** dry-run 模式 */
+    dryRun?: boolean;
+}
+export interface InstallTemplateResult {
+    /** 是否做了实际写入 */
+    changed: boolean;
+    /** 安装的目标技能目录名（如 "prefix-auth"） */
+    skillDirName: string;
+    /** 创建的文件列表 */
+    createdFiles: string[];
+    /** 错误信息（可选） */
+    error?: string;
+}
+/**
+ * 安装技能模板到 serenity 实例。
+ * 输出到 <serenityRoot>/.opencode/skills/<prefix>-<name>/
+ */
+export declare function installTemplate(opts: InstallTemplateOptions): InstallTemplateResult;
+//# sourceMappingURL=template-loader.d.ts.map

package/dist/skills/template-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-loader.d.ts","sourceRoot":"","sources":["../../src/skills/template-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe;IACf,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,mBAAmB;IACnB,GAAG,CAAC,EAAE,KAAK,CAAC;QACV,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,GAAG,WAAW,CAAC;KAChC,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,WAAW;IACX,QAAQ,EAAE,gBAAgB,CAAC;CAC5B;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAID,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,YAAY,CAOhE;AAID;;;GAGG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,EAAE,CASrE;AAiBD;;;GAGG;AACH,wBAAgB,YAAY,CAC1B,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,YAAY,GACzB,aAAa,CA0Cf;AA0BD,MAAM,WAAW,sBAAsB;IACrC,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU;IACV,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,iBAAiB;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,eAAe;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,kCAAkC;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,sBAAsB,GAAG,qBAAqB,CA8CnF"}

package/dist/skills/template-loader.js

@@ -0,0 +1,170 @@
+/**
+ * template-loader.ts — 技能模板加载器（v0.1 D2）
+ *
+ * 职责：
+ *   1. 从 plugin 的 src/templates/<name>/ 目录加载模板
+ *   2. 替换占位符（{{prefix}}, {{instance_name}}, {{date}}）
+ *   3. 输出目标路径 → 文件内容映射
+ */
+import { existsSync, readFileSync, readdirSync, statSync, mkdirSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+// ── 默认值 ──
+export function defaultPlaceholders(prefix) {
+    const now = new Date();
+    return {
+        prefix,
+        instanceName: `${prefix}-serenity`,
+        date: now.toISOString().slice(0, 10),
+    };
+}
+// ── 模板发现 ──
+/**
+ * 返回 plugin 内置模板的 src/templates/ 目录路径。
+ * 开发模式：相对于 bin/ 脚本的安装路径。
+ */
+export function getTemplatesDir(pluginRoot) {
+    return join(pluginRoot, 'src', 'templates');
+}
+/**
+ * 列出所有可用模板名
+ */
+export function listAvailableTemplates(templatesDir) {
+    try {
+        return readdirSync(templatesDir, { withFileTypes: true })
+            .filter((e) => e.isDirectory())
+            .map((e) => e.name)
+            .sort();
+    }
+    catch {
+        return [];
+    }
+}
+// ── 模板加载 ──
+const PLACEHOLDER_PATTERN = /\{\{(\w+)\}\}/g;
+function replacePlaceholders(content, placeholders) {
+    return content.replace(PLACEHOLDER_PATTERN, (_, key) => {
+        switch (key) {
+            case 'prefix': return placeholders.prefix;
+            case 'instance_name': return placeholders.instanceName;
+            case 'date': return placeholders.date;
+            default: return `{{${key}}}`; // 保持未知占位符不变
+        }
+    });
+}
+/**
+ * 加载模板目录，返回文件映射（已替换占位符）。
+ * 跳过 manifest.yaml 本身（不作为目标文件）。
+ */
+export function loadTemplate(templatesDir, name, placeholders) {
+    const templatePath = join(templatesDir, name);
+    if (!existsSync(templatePath)) {
+        throw new Error(`Template not found: "${name}" at ${templatePath}`);
+    }
+    if (!statSync(templatePath).isDirectory()) {
+        throw new Error(`Template path is not a directory: ${templatePath}`);
+    }
+    // 读取 manifest
+    const manifestPath = join(templatePath, 'manifest.yaml');
+    let manifest;
+    if (existsSync(manifestPath)) {
+        const raw = readFileSync(manifestPath, 'utf8');
+        manifest = parseManifest(raw, name);
+    }
+    else {
+        manifest = { name, description: `Skill: ${name}` };
+    }
+    // 收集所有文件（递归）
+    const files = {};
+    function collectFiles(dir, relativeDir) {
+        const entries = readdirSync(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (entry.name === 'manifest.yaml')
+                continue; // 跳过 manifest
+            const fullPath = join(dir, entry.name);
+            const relPath = relativeDir ? `${relativeDir}/${entry.name}` : entry.name;
+            if (entry.isDirectory()) {
+                collectFiles(fullPath, relPath);
+            }
+            else if (entry.isFile()) {
+                const content = readFileSync(fullPath, 'utf8');
+                files[relPath] = replacePlaceholders(content, placeholders);
+            }
+        }
+    }
+    collectFiles(templatePath, '');
+    return { files, manifest };
+}
+// ── Manifest 解析（简单 yaml 解析） ──
+function parseManifest(raw, fallbackName) {
+    const result = { name: fallbackName, description: '' };
+    for (const line of raw.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        const colonIdx = trimmed.indexOf(':');
+        if (colonIdx === -1)
+            continue;
+        const key = trimmed.slice(0, colonIdx).trim();
+        const value = trimmed.slice(colonIdx + 1).trim();
+        switch (key) {
+            case 'name':
+                result.name = value;
+                break;
+            case 'eal':
+                result.eal = value;
+                break;
+            case 'description':
+                result.description = value;
+                break;
+            case 'version':
+                result.version = value;
+                break;
+        }
+    }
+    return result;
+}
+/**
+ * 安装技能模板到 serenity 实例。
+ * 输出到 <serenityRoot>/.opencode/skills/<prefix>-<name>/
+ */
+export function installTemplate(opts) {
+    const { templateDir, name, serenityRoot, prefix, dryRun } = opts;
+    const ph = opts.placeholders ?? defaultPlaceholders(prefix);
+    // 加载模板
+    const { files } = loadTemplate(templateDir, name, ph);
+    // 目标路径
+    const targetDir = join(serenityRoot, '.opencode', 'skills', `${prefix}-${name}`);
+    const createdFiles = [];
+    if (dryRun) {
+        return {
+            changed: true,
+            skillDirName: `${prefix}-${name}`,
+            createdFiles: Object.keys(files),
+        };
+    }
+    // 写入文件
+    let hasChanges = false;
+    for (const [relPath, content] of Object.entries(files)) {
+        const targetFile = join(targetDir, relPath);
+        const parentDir = targetFile.slice(0, targetFile.lastIndexOf('/'));
+        // 检查是否已存在且内容一致
+        if (existsSync(targetFile)) {
+            const existing = readFileSync(targetFile, 'utf8');
+            if (existing === content)
+                continue;
+        }
+        // 创建父目录
+        if (!existsSync(parentDir)) {
+            mkdirSync(parentDir, { recursive: true });
+        }
+        writeFileSync(targetFile, content, 'utf8');
+        createdFiles.push(relPath);
+        hasChanges = true;
+    }
+    return {
+        changed: hasChanges,
+        skillDirName: `${prefix}-${name}`,
+        createdFiles,
+    };
+}
+//# sourceMappingURL=template-loader.js.map

package/dist/skills/template-loader.js.map

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

package/dist/state.d.ts

@@ -0,0 +1,35 @@
+/**
+ * 全局激活状态 — v0.1 两阶段 init 支持
+ *
+ * 状态机（ReadyStateMachine）：
+ *   idle → loading → ready / error / disabled
+ *
+ * 维持旧 API 兼容：
+ *   - getState() / setState() / isActive() / resetState() 不变
+ *
+ * 新增 v0.1 API：
+ *   - getReadyMachine()   拿状态机
+ *   - ensureReady()       tools/hooks execute 阻塞等待激活完成
+ *
+ * 注意：plugin 入口的 input 是 opencode 调用时传入的，Hooks 闭包要访问状态
+ * —— 用模块级 singleton 缓存。
+ */
+import { type SerenityState } from './types/index.js';
+import { ReadyStateMachine } from './util/ready-state.js';
+/** 写入激活状态（仅 activation.ts 调用） */
+export declare function setState(state: SerenityState): void;
+/** 读取当前激活状态（其他模块用） */
+export declare function getState(): SerenityState;
+/** 是否已激活（最常用判定，**同步快路径**） */
+export declare function isActive(): boolean;
+/** 重置为不激活（测试用） */
+export declare function resetState(): void;
+/** v0.1：拿状态机（activation.ts / hooks 内部用） */
+export declare function getReadyMachine(): ReadyStateMachine;
+/** v0.1：tools/hooks execute 阻塞等待激活完成 */
+export declare function ensureReady(): Promise<void>;
+/** v0.1：把状态机推 ready（activation.ts 异步完成时调） */
+export declare function markReady(): void;
+/** v0.1：把状态机推 disabled（sync 阶段失败时调） */
+export declare function markDisabled(reason: string): void;
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAkB,KAAK,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAK1D,iCAAiC;AACjC,wBAAgB,QAAQ,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAMnD;AAED,sBAAsB;AACtB,wBAAgB,QAAQ,IAAI,aAAa,CAExC;AAED,6BAA6B;AAC7B,wBAAgB,QAAQ,IAAI,OAAO,CAElC;AAED,kBAAkB;AAClB,wBAAgB,UAAU,IAAI,IAAI,CAGjC;AAED,2CAA2C;AAC3C,wBAAgB,eAAe,IAAI,iBAAiB,CAEnD;AAED,wCAAwC;AACxC,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAKjD;AAED,6CAA6C;AAC7C,wBAAgB,SAAS,IAAI,IAAI,CAEhC;AAED,uCAAuC;AACvC,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAEjD"}

package/dist/state.js

@@ -0,0 +1,62 @@
+/**
+ * 全局激活状态 — v0.1 两阶段 init 支持
+ *
+ * 状态机（ReadyStateMachine）：
+ *   idle → loading → ready / error / disabled
+ *
+ * 维持旧 API 兼容：
+ *   - getState() / setState() / isActive() / resetState() 不变
+ *
+ * 新增 v0.1 API：
+ *   - getReadyMachine()   拿状态机
+ *   - ensureReady()       tools/hooks execute 阻塞等待激活完成
+ *
+ * 注意：plugin 入口的 input 是 opencode 调用时传入的，Hooks 闭包要访问状态
+ * —— 用模块级 singleton 缓存。
+ */
+import { INACTIVE_STATE } from './types/index.js';
+import { ReadyStateMachine } from './util/ready-state.js';
+let _state = INACTIVE_STATE;
+const _machine = new ReadyStateMachine();
+/** 写入激活状态（仅 activation.ts 调用） */
+export function setState(state) {
+    _state = state;
+    if (state.activated) {
+        // 立即把状态机推到 ready（v0 路径：同步激活完成）
+        // 注：setState 自身不暴露 machine API；activation.ts 走的是 markReady 显式调用
+    }
+}
+/** 读取当前激活状态（其他模块用） */
+export function getState() {
+    return _state;
+}
+/** 是否已激活（最常用判定，**同步快路径**） */
+export function isActive() {
+    return _state.activated;
+}
+/** 重置为不激活（测试用） */
+export function resetState() {
+    _state = INACTIVE_STATE;
+    _machine.reset();
+}
+/** v0.1：拿状态机（activation.ts / hooks 内部用） */
+export function getReadyMachine() {
+    return _machine;
+}
+/** v0.1：tools/hooks execute 阻塞等待激活完成 */
+export async function ensureReady() {
+    // 快路径：v0 同步激活完成，state.activated === true
+    if (_state.activated)
+        return;
+    // 慢路径：v0.1 异步激活，阻塞等待状态机
+    await _machine.whenReady();
+}
+/** v0.1：把状态机推 ready（activation.ts 异步完成时调） */
+export function markReady() {
+    _machine.markAsReady();
+}
+/** v0.1：把状态机推 disabled（sync 阶段失败时调） */
+export function markDisabled(reason) {
+    _machine.markDisabled(reason);
+}
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,cAAc,EAAsB,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D,IAAI,MAAM,GAAkB,cAAc,CAAC;AAC3C,MAAM,QAAQ,GAAG,IAAI,iBAAiB,EAAE,CAAC;AAEzC,iCAAiC;AACjC,MAAM,UAAU,QAAQ,CAAC,KAAoB;IAC3C,MAAM,GAAG,KAAK,CAAC;IACf,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACpB,+BAA+B;QAC/B,gEAAgE;IAClE,CAAC;AACH,CAAC;AAED,sBAAsB;AACtB,MAAM,UAAU,QAAQ;IACtB,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,6BAA6B;AAC7B,MAAM,UAAU,QAAQ;IACtB,OAAO,MAAM,CAAC,SAAS,CAAC;AAC1B,CAAC;AAED,kBAAkB;AAClB,MAAM,UAAU,UAAU;IACxB,MAAM,GAAG,cAAc,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,eAAe;IAC7B,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,wCAAwC;AACxC,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,yCAAyC;IACzC,IAAI,MAAM,CAAC,SAAS;QAAE,OAAO;IAC7B,wBAAwB;IACxB,MAAM,QAAQ,CAAC,SAAS,EAAE,CAAC;AAC7B,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,SAAS;IACvB,QAAQ,CAAC,WAAW,EAAE,CAAC;AACzB,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,QAAQ,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC"}

package/dist/tui.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 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 type { TuiPlugin } from '@opencode-ai/plugin/tui';
+declare const _default: {
+    id: string;
+    tui: TuiPlugin;
+};
+export default _default;
+//# sourceMappingURL=tui.d.ts.map

package/dist/tui.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tui.d.ts","sourceRoot":"","sources":["../src/tui.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;;;;;AAwOzD,wBAGE"}