@shgroup/opencode-serenity-plugin 0.2.0

package/dist/init/init-wizard.js

@@ -0,0 +1,297 @@
+/**
+ * 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. 输出完成信息
+ */
+import { existsSync, mkdirSync, writeFileSync } from 'node:fs';
+import { join, basename } from 'node:path';
+import { createInterface } from 'node:readline';
+import { stdin, stdout } from 'node:process';
+import { getTemplatesDir, installTemplate, defaultPlaceholders, } from '../skills/template-loader.js';
+// ── 默认值 ──
+const STANDARD_SKILLS = [
+    'compass',
+    'session',
+    'sqc',
+    'exploration',
+    'quality-review',
+    'landscape',
+    'git',
+];
+/** 从目录名推断 prefix */
+function inferPrefix(dirName) {
+    // 取第一个词（小写，非字母开头的去掉）
+    const cleaned = dirName.replace(/[^a-zA-Z0-9-]/g, '');
+    const first = cleaned.split(/[-_]/)[0];
+    if (!first)
+        return 'my';
+    return first.toLowerCase().slice(0, 8);
+}
+/** 从 prefix 推断中文名 */
+function inferName(prefix) {
+    const names = {
+        home: '宁静号',
+        tg: '天工宁静号',
+        pg: '盘古宁静号',
+    };
+    return names[prefix] ?? `${prefix.toUpperCase()} 宁静号`;
+}
+// ── 交互式问答 ──
+async function askQuestion(prompt, defaultValue) {
+    const rl = createInterface({ input: stdin, output: stdout });
+    return new Promise((resolve) => {
+        const fullPrompt = defaultValue
+            ? `${prompt} [${defaultValue}]: `
+            : `${prompt}: `;
+        rl.question(fullPrompt, (answer) => {
+            rl.close();
+            resolve(answer.trim() || defaultValue || '');
+        });
+    });
+}
+async function collectInfo(prefill) {
+    const prefix = await askQuestion('What prefix for skill names? (kebab-case, e.g. "home", "tg", "pg")', prefill);
+    const description = await askQuestion('Describe this serenity instance in one sentence', '');
+    return {
+        prefix: prefix || prefill,
+        description: description || 'A serenity instance',
+    };
+}
+function buildSkeleton(prefix) {
+    const skillDir = join('.opencode', 'skills');
+    const rootSkill = `${prefix}-serenity`;
+    return [
+        // 目录
+        { path: join('AGENT_SESSIONS'), content: '', isDir: true },
+        { path: join('docs'), content: '', isDir: true },
+        { path: join('.opencode', 'scripts'), content: '', isDir: true },
+        { path: join('.opencode', 'references'), content: '', isDir: true },
+        // .serenity
+        { path: '.serenity', content: `${rootSkill}\n` },
+        // .gitignore
+        {
+            path: '.gitignore',
+            content: [
+                '# 宁静号标准 .gitignore — 外部仓库不被纳入本仓库',
+                '# 用户可在此追加专属的排除规则',
+                '',
+                '# 在宁静号项目中，所有子项目作为独立 git 仓库存放',
+                '# 通过根 .gitignore 排除它们，避免意外提交',
+            ].join('\n') + '\n',
+        },
+        // opencode.json
+        {
+            path: 'opencode.json',
+            content: JSON.stringify({
+                $schema: 'https://opencode.ai/config.json',
+                permission: {
+                    read: 'allow',
+                    edit: 'allow',
+                },
+            }, null, 2) + '\n',
+        },
+        // 根 skill 骨架（等待 Phase 2 生成）
+        {
+            path: join(skillDir, rootSkill, 'SKILL.md'),
+            content: [
+                `# ${rootSkill} — ${inferName(prefix)}`,
+                '',
+                '> 由 serenity-plugin init 创建。此文件将在 Phase 2 由 Agent 完善。',
+                '> 运行 `npx tsx ` + resolve + ` 根据引导完成初始化。',
+                '',
+                '## 初始配置',
+                '',
+                `- prefix: ${prefix}`,
+                '- 标准技能已预装（见 .opencode/skills/）',
+                '- 等待 Phase 2 生成完整的根 skill',
+            ].join('\n') + '\n',
+        },
+        // 根 skill 目录结构
+        { path: join(skillDir, rootSkill, 'references'), content: '', isDir: true },
+        { path: join(skillDir, rootSkill, 'scripts'), content: '', isDir: true },
+        // Agent Phase 2 prompt
+        {
+            path: join(skillDir, rootSkill, 'scripts', 'generate-root-skill.prompt.md'),
+            content: generatePhase2Prompt(prefix),
+        },
+        // 根 skill 注册表骨架
+        {
+            path: join(skillDir, rootSkill, 'references', 'mech-registry.json'),
+            content: JSON.stringify({
+                version: 1,
+                serenity: rootSkill,
+                description: `Register for ${rootSkill}`,
+                entries: [],
+            }, null, 2) + '\n',
+        },
+    ];
+}
+// ── Phase 2 Agent Prompt ──
+function generatePhase2Prompt(prefix) {
+    return [
+        `# Phase 2: Complete ${prefix}-serenity Root Skill`,
+        '',
+        'This serenity instance has been initialized with all standard meta-skills.',
+        'Now you need to complete the root skill SKILL.md.',
+        '',
+        '## Interview Questions',
+        '',
+        'Answer these questions interactively with the user, then fill in the root skill at',
+        `.opencode/skills/${prefix}-serenity/SKILL.md`,
+        '',
+        '1. **System description**: What project/system does this serenity manage?',
+        '2. **Scope**: Single person, small team, or enterprise?',
+        '3. **Key components**: What sub-projects or modules does the system contain?',
+        '4. **Collaboration style**: Structured (formal docs/SOP) or flexible (ad-hoc)?',
+        '5. **Language preference**: Precise, conversational, or technical?',
+        '',
+        '## Root Skill Skeleton',
+        '',
+        `Create the SKILL.md for ${prefix}-serenity with these sections:`,
+        '',
+        '- `# Skill: ${prefix}-serenity — <Name>`',
+        '- System identity and core principles',
+        '- Skill list (all 9 pre-installed skills)',
+        '- Task route table (basic routes)',
+        '- Collaboration protocols (Neat + naming + session conventions)',
+        '- EAP checklist',
+        '',
+        '## Available Tools',
+        '',
+        'The plugin provides these tools that work in any serenity instance:',
+        '- **file_system**: root/resolve/list (no instance-specific coupling)',
+        '- **session_tool**: list/show/create/health/archive/summary',
+        '- **msm_list / msm_exec / msm_admin**: standard MSM management',
+        '',
+        '## Important',
+        '',
+        '- All 9 standard skills are already installed',
+        '- The AGENT_SESSIONS/ directory exists and session_tool is ready',
+        '- Guide the user through the 5 questions, then write the SKILL.md',
+        '- The SKILL.md should be fully usable — no placeholder text',
+    ].join('\n') + '\n';
+}
+// ── 主入口 ──
+export async function initWizard(opts) {
+    const { targetPath, pluginRoot, force } = opts;
+    const targetDirName = basename(targetPath);
+    // 检查目标目录
+    if (existsSync(targetPath)) {
+        const hasFiles = existsSync(join(targetPath, '.serenity'));
+        if (hasFiles && !force) {
+            return {
+                success: false,
+                prefix: '',
+                name: '',
+                message: `Target already contains a serenity instance: ${targetPath}. Use --force to overwrite.`,
+                createdDirs: [],
+                installedSkills: [],
+            };
+        }
+    }
+    // Phase 1: 收集基本信息
+    const prefill = opts.prefix ?? inferPrefix(targetDirName);
+    let prefix;
+    let description;
+    if (opts.nonInteractive) {
+        prefix = prefill;
+        description = opts.description ?? 'Serenity instance';
+    }
+    else {
+        const info = await collectInfo(prefill);
+        prefix = info.prefix;
+        description = info.description;
+    }
+    // 验证 prefix
+    if (!/^[a-z][a-z0-9-]{0,19}$/.test(prefix)) {
+        return {
+            success: false, prefix: '', name: '',
+            message: `Invalid prefix "${prefix}": must be kebab-case (lowercase a-z, 0-9, dashes; max 20 chars)`,
+            createdDirs: [], installedSkills: [],
+        };
+    }
+    const name = opts.name ?? inferName(prefix);
+    const ph = defaultPlaceholders(prefix);
+    // Phase 1a: 创建目录骨架
+    const createdDirs = [];
+    const skeleton = buildSkeleton(prefix);
+    mkdirSync(targetPath, { recursive: true });
+    for (const item of skeleton) {
+        const fullPath = join(targetPath, item.path);
+        if (item.isDir) {
+            if (!existsSync(fullPath)) {
+                mkdirSync(fullPath, { recursive: true });
+                createdDirs.push(item.path);
+            }
+        }
+        else {
+            if (existsSync(fullPath) && !force)
+                continue;
+            const parentDir = fullPath.slice(0, fullPath.lastIndexOf('/'));
+            if (!existsSync(parentDir)) {
+                mkdirSync(parentDir, { recursive: true });
+            }
+            writeFileSync(fullPath, item.content, 'utf8');
+            createdDirs.push(item.path);
+        }
+    }
+    // Phase 1b: 复制标准技能模板
+    const templatesDir = getTemplatesDir(pluginRoot);
+    const installedSkills = [];
+    let templatesMissing = false;
+    for (const skillName of STANDARD_SKILLS) {
+        try {
+            const result = installTemplate({
+                templateDir: templatesDir,
+                name: skillName,
+                serenityRoot: targetPath,
+                prefix,
+                placeholders: ph,
+                dryRun: false,
+            });
+            if (result.changed) {
+                installedSkills.push(skillName);
+            }
+        }
+        catch {
+            // 模板缺失是允许的 — 用户可后续 install-skill
+            templatesMissing = true;
+        }
+    }
+    // Phase 1c: 写 .serenity 确认
+    const serenityPath = join(targetPath, '.serenity');
+    if (!existsSync(serenityPath) || force) {
+        writeFileSync(serenityPath, `${prefix}-serenity\n`, 'utf8');
+    }
+    // 输出
+    const skillSummary = installedSkills.length > 0
+        ? `Pre-installed ${installedSkills.length} skill(s): ${installedSkills.join(', ')}`
+        : 'No templates were copied (templates may not exist yet)';
+    return {
+        success: true,
+        prefix,
+        name,
+        message: [
+            `Serenity instance "${name}" created at ${targetPath}`,
+            `  prefix: ${prefix}`,
+            `  description: ${description}`,
+            `  ${skillSummary}`,
+            '',
+            `Next steps:`,
+            `  1. Open ${targetPath} in OpenCode`,
+            `  2. Agent will guide you through Phase 2 to complete the root skill`,
+            templatesMissing ? '  (Some skill templates not found — run `opencode-serenity-plugin install-skill <name>` to add them later)' : '',
+        ].filter(Boolean).join('\n'),
+        createdDirs,
+        installedSkills,
+    };
+}
+//# sourceMappingURL=init-wizard.js.map

package/dist/init/init-wizard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init-wizard.js","sourceRoot":"","sources":["../../src/init/init-wizard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC/D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EACL,eAAe,EACf,eAAe,EACf,mBAAmB,GAEpB,MAAM,8BAA8B,CAAC;AA8BtC,YAAY;AAEZ,MAAM,eAAe,GAAG;IACtB,SAAS;IACT,SAAS;IACT,KAAK;IACL,aAAa;IACb,gBAAgB;IAChB,WAAW;IACX,KAAK;CACN,CAAC;AAEF,oBAAoB;AACpB,SAAS,WAAW,CAAC,OAAe;IAClC,qBAAqB;IACrB,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,gBAAgB,EAAE,EAAE,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACzC,CAAC;AAED,qBAAqB;AACrB,SAAS,SAAS,CAAC,MAAc;IAC/B,MAAM,KAAK,GAA2B;QACpC,IAAI,EAAE,KAAK;QACX,EAAE,EAAE,OAAO;QACX,EAAE,EAAE,OAAO;KACZ,CAAC;IACF,OAAO,KAAK,CAAC,MAAM,CAAC,IAAI,GAAG,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC;AACxD,CAAC;AAED,cAAc;AAEd,KAAK,UAAU,WAAW,CAAC,MAAc,EAAE,YAAqB;IAC9D,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,UAAU,GAAG,YAAY;YAC7B,CAAC,CAAC,GAAG,MAAM,KAAK,YAAY,KAAK;YACjC,CAAC,CAAC,GAAG,MAAM,IAAI,CAAC;QAClB,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,EAAE;YACjC,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,YAAY,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,OAAe;IAIxC,MAAM,MAAM,GAAG,MAAM,WAAW,CAC9B,oEAAoE,EACpE,OAAO,CACR,CAAC;IAEF,MAAM,WAAW,GAAG,MAAM,WAAW,CACnC,iDAAiD,EACjD,EAAE,CACH,CAAC;IAEF,OAAO;QACL,MAAM,EAAE,MAAM,IAAI,OAAO;QACzB,WAAW,EAAE,WAAW,IAAI,qBAAqB;KAClD,CAAC;AACJ,CAAC;AAUD,SAAS,aAAa,CACpB,MAAc;IAEd,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IAC7C,MAAM,SAAS,GAAG,GAAG,MAAM,WAAW,CAAC;IAEvC,OAAO;QACL,KAAK;QACL,EAAE,IAAI,EAAE,IAAI,CAAC,gBAAgB,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;QAC1D,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;QAChD,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;QAChE,EAAE,IAAI,EAAE,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;QACnE,YAAY;QACZ,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,SAAS,IAAI,EAAE;QAChD,aAAa;QACb;YACE,IAAI,EAAE,YAAY;YAClB,OAAO,EAAE;gBACP,kCAAkC;gBAClC,kBAAkB;gBAClB,EAAE;gBACF,8BAA8B;gBAC9B,8BAA8B;aAC/B,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI;SACpB;QACD,gBAAgB;QAChB;YACE,IAAI,EAAE,eAAe;YACrB,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC;gBACtB,OAAO,EAAE,iCAAiC;gBAC1C,UAAU,EAAE;oBACV,IAAI,EAAE,OAAO;oBACb,IAAI,EAAE,OAAO;iBACd;aACF,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI;SACnB;QACD,4BAA4B;QAC5B;YACE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC;YAC3C,OAAO,EAAE;gBACP,KAAK,SAAS,MAAM,SAAS,CAAC,MAAM,CAAC,EAAE;gBACvC,EAAE;gBACF,uDAAuD;gBACvD,0CAA0C;gBAC1C,EAAE;gBACF,SAAS;gBACT,EAAE;gBACF,aAAa,MAAM,EAAE;gBACrB,gCAAgC;gBAChC,2BAA2B;aAC5B,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI;SACpB;QACD,eAAe;QACf,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,YAAY,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;QAC3E,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE;QACxE,uBAAuB;QACvB;YACE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,SAAS,EAAE,+BAA+B,CAAC;YAC3E,OAAO,EAAE,oBAAoB,CAAC,MAAM,CAAC;SACtC;QACD,gBAAgB;QAChB;YACE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,SAAS,EAAE,YAAY,EAAE,oBAAoB,CAAC;YACnE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC;gBACtB,OAAO,EAAE,CAAC;gBACV,QAAQ,EAAE,SAAS;gBACnB,WAAW,EAAE,gBAAgB,SAAS,EAAE;gBACxC,OAAO,EAAE,EAAE;aACZ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI;SACnB;KACF,CAAC;AACJ,CAAC;AAED,6BAA6B;AAE7B,SAAS,oBAAoB,CAAC,MAAc;IAC1C,OAAO;QACL,uBAAuB,MAAM,sBAAsB;QACnD,EAAE;QACF,4EAA4E;QAC5E,mDAAmD;QACnD,EAAE;QACF,wBAAwB;QACxB,EAAE;QACF,oFAAoF;QACpF,oBAAoB,MAAM,oBAAoB;QAC9C,EAAE;QACF,2EAA2E;QAC3E,yDAAyD;QACzD,8EAA8E;QAC9E,gFAAgF;QAChF,oEAAoE;QACpE,EAAE;QACF,wBAAwB;QACxB,EAAE;QACF,2BAA2B,MAAM,gCAAgC;QACjE,EAAE;QACF,0CAA0C;QAC1C,uCAAuC;QACvC,2CAA2C;QAC3C,mCAAmC;QACnC,iEAAiE;QACjE,iBAAiB;QACjB,EAAE;QACF,oBAAoB;QACpB,EAAE;QACF,qEAAqE;QACrE,sEAAsE;QACtE,6DAA6D;QAC7D,gEAAgE;QAChE,EAAE;QACF,cAAc;QACd,EAAE;QACF,+CAA+C;QAC/C,kEAAkE;QAClE,mEAAmE;QACnE,6DAA6D;KAC9D,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AACtB,CAAC;AAED,YAAY;AAEZ,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAiB;IAChD,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;IAC/C,MAAM,aAAa,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;IAE3C,SAAS;IACT,IAAI,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;QAC3D,IAAI,QAAQ,IAAI,CAAC,KAAK,EAAE,CAAC;YACvB,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,EAAE;gBACV,IAAI,EAAE,EAAE;gBACR,OAAO,EAAE,gDAAgD,UAAU,6BAA6B;gBAChG,WAAW,EAAE,EAAE;gBACf,eAAe,EAAE,EAAE;aACpB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,kBAAkB;IAClB,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,IAAI,WAAW,CAAC,aAAa,CAAC,CAAC;IAE1D,IAAI,MAAc,CAAC;IACnB,IAAI,WAAmB,CAAC;IAExB,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;QACxB,MAAM,GAAG,OAAO,CAAC;QACjB,WAAW,GAAG,IAAI,CAAC,WAAW,IAAI,mBAAmB,CAAC;IACxD,CAAC;SAAM,CAAC;QACN,MAAM,IAAI,GAAG,MAAM,WAAW,CAAC,OAAO,CAAC,CAAC;QACxC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QACrB,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;IACjC,CAAC;IAED,YAAY;IACZ,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3C,OAAO;YACL,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE;YACpC,OAAO,EAAE,mBAAmB,MAAM,kEAAkE;YACpG,WAAW,EAAE,EAAE,EAAE,eAAe,EAAE,EAAE;SACrC,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC;IAC5C,MAAM,EAAE,GAAiB,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAErD,mBAAmB;IACnB,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC;IAEvC,SAAS,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE3C,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7C,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;gBAC1B,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBACzC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;aAAM,CAAC;YACN,IAAI,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK;gBAAE,SAAS;YAC7C,MAAM,SAAS,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;YAC/D,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;gBAC3B,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC5C,CAAC;YACD,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC9C,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,qBAAqB;IACrB,MAAM,YAAY,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;IACjD,MAAM,eAAe,GAAa,EAAE,CAAC;IACrC,IAAI,gBAAgB,GAAG,KAAK,CAAC;IAE7B,KAAK,MAAM,SAAS,IAAI,eAAe,EAAE,CAAC;QACxC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,eAAe,CAAC;gBAC7B,WAAW,EAAE,YAAY;gBACzB,IAAI,EAAE,SAAS;gBACf,YAAY,EAAE,UAAU;gBACxB,MAAM;gBACN,YAAY,EAAE,EAAE;gBAChB,MAAM,EAAE,KAAK;aACd,CAAC,CAAC;YACH,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAClC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,iCAAiC;YACjC,gBAAgB,GAAG,IAAI,CAAC;QAC1B,CAAC;IACH,CAAC;IAED,2BAA2B;IAC3B,MAAM,YAAY,GAAG,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IACnD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,KAAK,EAAE,CAAC;QACvC,aAAa,CAAC,YAAY,EAAE,GAAG,MAAM,aAAa,EAAE,MAAM,CAAC,CAAC;IAC9D,CAAC;IAED,KAAK;IACL,MAAM,YAAY,GAAG,eAAe,CAAC,MAAM,GAAG,CAAC;QAC7C,CAAC,CAAC,iBAAiB,eAAe,CAAC,MAAM,cAAc,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACnF,CAAC,CAAC,wDAAwD,CAAC;IAE7D,OAAO;QACL,OAAO,EAAE,IAAI;QACb,MAAM;QACN,IAAI;QACJ,OAAO,EAAE;YACP,sBAAsB,IAAI,gBAAgB,UAAU,EAAE;YACtD,aAAa,MAAM,EAAE;YACrB,kBAAkB,WAAW,EAAE;YAC/B,KAAK,YAAY,EAAE;YACnB,EAAE;YACF,aAAa;YACb,aAAa,UAAU,cAAc;YACrC,sEAAsE;YACtE,gBAAgB,CAAC,CAAC,CAAC,4GAA4G,CAAC,CAAC,CAAC,EAAE;SACrI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QAC5B,WAAW;QACX,eAAe;KAChB,CAAC;AACJ,CAAC"}

package/dist/install.d.ts

@@ -0,0 +1,117 @@
+/**
+ * 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 非侵入语义。
+ */
+export declare const PLUGIN_ID = "opencode-serenity-plugin";
+export type PluginEntry = {
+    /** Plugin 逻辑 id (e.g. opencode-serenity-plugin) */
+    id: string;
+    /** 规范化的 file:// URL,用于 opencode 配置 */
+    path: string;
+    /** 绝对文件系统路径,用于 _plugin_origins 追踪 */
+    absPath: string;
+};
+export type ResolvedEntries = {
+    id: string;
+    server: PluginEntry;
+    tui: PluginEntry;
+};
+export type InstallResult = {
+    changed: boolean;
+    configPath: string;
+    error?: string;
+    addedPaths?: string[];
+    skippedPaths?: string[];
+};
+export type ConfigType = 'opencode.json' | 'tui.json';
+/** 读出的 config 结构 (可包含 _plugin_origins 元数据) */
+export type ReadConfig = {
+    [key: string]: unknown;
+    plugin?: unknown;
+};
+/**
+ * 解析 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 declare function detectGlobalConfigHome(): string;
+/** global config 文件路径 */
+export declare function getGlobalConfigPath(filename: ConfigType): string;
+/**
+ * 解析 install path → 两个 plugin entry。
+ *
+ * - installPath 应为 package 根目录 (含 dist/index.js + dist/tui.js)
+ * - 自动 realpath 解析 symlink (npm global install / pnpm link 都会建 symlink)
+ * - 绝对路径验证 (相对路径直接抛)
+ */
+export declare function resolvePluginEntries(installPath: string): ResolvedEntries;
+/**
+ * 从 bin 文件路径反推 install path (package 根目录)。
+ *
+ * 用于 CLI: bin 位于 <pkg>/bin/<name>.js,install path = <pkg>/。
+ * 自动 realpath 解析 symlink (npm global install 会建 symlink)。
+ */
+export declare function resolveInstallPathFromBin(binFilePath: string): string;
+/**
+ * 读 JSON config。文件不存在或为空 → 返回 {}。
+ *
+ * 严格模式 (v1.18 收口 — 旧 tui-install.ts 行为):
+ * - 文件不存在或空 → 返回 {} (允许新装)
+ * - JSON.parse 失败 → 抛 Error (writePluginEntry 捕获并返回 error, 不覆盖用户数据)
+ * - 根节点非 object (array / null / 标量) → 抛 Error
+ *
+ * 不抛的"宽松"行为会静默覆盖用户已损坏的 config, 风险高。
+ * 严格模式让 writePluginEntry 显式告诉用户 "config 损坏, 请人工修复"。
+ */
+export declare function readJsonConfig(path: string): ReadConfig;
+/**
+ * 原子写 JSON config。
+ *
+ * 流程: mkdir -p parent → 写 path.tmp → rename 到 path。
+ * rename 在同一文件系统下是原子操作,避免半写状态。
+ */
+export declare function writeJsonConfig(path: string, data: ReadConfig): void;
+/**
+ * 判定 entries 是否已安装。
+ *
+ * 只检查 plugin 数组：已有相同 file:// URL 的视为已安装 (string / tuple 形式)
+ * 不写 _plugin_origins — opencode 严格校验 config JSON schema，不认未知 key。
+ *
+ * 返回 true = 全部 entries 都不必再写 (no-op)
+ * 返回 false = 至少一个 entry 还没装
+ */
+export declare function isAlreadyInstalled(entries: PluginEntry[], existing: ReadConfig): boolean;
+/**
+ * 把 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 declare function writePluginEntry(configPath: string, entries: PluginEntry[]): InstallResult;
+//# sourceMappingURL=install.d.ts.map

package/dist/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../src/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAcH,eAAO,MAAM,SAAS,6BAA6B,CAAC;AAOpD,MAAM,MAAM,WAAW,GAAG;IACxB,mDAAmD;IACnD,EAAE,EAAE,MAAM,CAAC;IACX,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,WAAW,CAAC;IACpB,GAAG,EAAE,WAAW,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG,eAAe,GAAG,UAAU,CAAC;AAEtD,8CAA8C;AAC9C,MAAM,MAAM,UAAU,GAAG;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IACvB,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAIF;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,IAAI,MAAM,CAa/C;AAED,yBAAyB;AACzB,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,UAAU,GAAG,MAAM,CAEhE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,EAAE,MAAM,GAAG,eAAe,CAoBzE;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAOrE;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,CAsBvD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAKpE;AAkBD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,WAAW,EAAE,EACtB,QAAQ,EAAE,UAAU,GACnB,OAAO,CAWT;AAID;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC9B,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,WAAW,EAAE,GACrB,aAAa,CA4Df"}