@haposoft/cafekit 0.8.16 → 0.9.0

package/bin/install.js

@@ -4,9 +4,12 @@
  * CafeKit Installer
  * Multi-platform installer for AI coding assistants
  *
- * Supported platforms:
- * - claude: Claude Code (.claude/)
- * - antigravity: Antigravity (.agent/)
+ * Supported platforms (each install is fully self-contained):
+ * - claude: Claude Code → .claude/ (skills, rules, scripts, references, runtime.json)
+ * - opencode: OpenCode → .opencode/ (same layout, content rewritten on copy)
+ *
+ * Selecting both creates both folders independently. There is no shared
+ * runtime directory between platforms.
  *
  * To add a new platform:
  * 1. Add to PLATFORMS registry below
@@ -20,6 +23,19 @@ const os = require('os');
 const readline = require('readline');
 const { execSync } = require('child_process');
 const packageJson = require('../package.json');
+const { copyRecursive, isTextAsset, readJsonFile } = require('./lib/copy-utils');
+const {
+  normalizeOpenCodeBody,
+  getOpenCodeCopyOptions,
+  convertOpenCodeAgentContent,
+  convertOpenCodeCommandContent,
+  copyOpenCodeAgentsMdFile,
+  copyOpenCodeSharedRuntimeFiles,
+  copyOpenCodePlugins,
+  copyOpenCodeCommandTemplates,
+  mergeOpenCodeConfig,
+  setupOpenCodeModel
+} = require('./lib/opencode-install');
 const INSTALL_COMMAND = `npx ${packageJson.name}@${packageJson.version}`;
 
 function validateManifestV2(manifest) {
@@ -57,65 +73,11 @@ const CLAUDE_MIGRATION_MANIFEST = loadClaudeMigrationManifest();
 const DEPENDENCY_TEMPLATES = {
   commands: {
     claude: {},
-    antigravity: {
-      'code.md': `---
-description: Implement approved work from specification tasks and then hand off to test and hapo:code-review.
-allowed-tools: Read, Glob, Grep, Edit, Write, Bash
-argument-hint: <feature-name>
----
-
-# /code
-
-Use this workflow after /spec-tasks.
-
-1. Read .specs/$ARGUMENTS/tasks.md and identify the next pending task.
-2. Implement only that task following project standards.
-3. Run /test.
-4. Run /hapo:code-review.
-
-Preferred flow: /spec-init -> /spec-requirements -> /spec-design -> /spec-tasks -> /code -> /test -> /hapo:code-review
-`,
-      'test.md': `---
-description: Run project tests and report failures concisely.
-allowed-tools: Bash, Read, Grep
-argument-hint: [scope]
----
-
-# /test
-
-Run the project's test command and report:
-- total passed/failed
-- failing test names
-- root cause hints
-- next fix action
-`,
-    }
+    opencode: {}
   },
   agents: {
     claude: {},
-    antigravity: {
-      'frontend-specialist.md': `---
-name: frontend-specialist
-description: Implement approved UI and interaction tasks from specifications.
----
-
-Implement UI tasks from approved specs with accessibility and responsive behavior.
-`,
-      'test-engineer.md': `---
-name: test-engineer
-description: Execute tests and report reliability issues.
----
-
-Run test suites, highlight failures, and propose precise fixes.
-`,
-      'code-archaeologist.md': `---
-name: code-archaeologist
-description: Review recent changes for regressions and hidden impacts.
----
-
-Inspect changed code paths, dependencies, and potential regressions.
-`
-    }
+    opencode: {}
   }
 };
 
@@ -136,18 +98,19 @@ const PLATFORMS = {
     sourceDir: 'claude',       // Maps to src/claude/
     sourceSubdir: 'commands'   // Source subfolder within src/claude/
   },
-  antigravity: {
-    id: 'antigravity',
-    name: 'Antigravity',
-    description: 'Google\'s Antigravity Kit',
-    folder: '.agent',
-    commandsDir: '.agent/workflows',  // Antigravity uses workflows/ not commands/
-    skillsDir: '.agent/skills',
-    agentsDir: '.agent/agents',
-    skillsRef: '.agent/skills',
+  opencode: {
+    id: 'opencode',
+    name: 'OpenCode',
+    description: 'OpenCode terminal AI coding agent',
+    folder: '.opencode',
+    detectFiles: ['.opencode', 'opencode.json', 'opencode.jsonc'],
+    commandsDir: '.opencode/commands',
+    skillsDir: '.opencode/skills',
+    agentsDir: '.opencode/agents',
+    skillsRef: '.opencode/skills',
     commandPrefix: '/',
-    sourceDir: 'antigravity',  // Maps to src/antigravity/
-    sourceSubdir: 'workflows'  // Source subfolder within src/antigravity/
+    sourceDir: 'claude',
+    sourceSubdir: 'archive-command'
   }
   // Add new platforms here:
   // cursor: {
@@ -169,7 +132,8 @@ function detectPlatforms() {
   const detected = [];
 
   for (const [key, config] of Object.entries(PLATFORMS)) {
-    if (fs.existsSync(config.folder)) {
+    const markers = Array.isArray(config.detectFiles) ? config.detectFiles : [config.folder];
+    if (markers.some(marker => fs.existsSync(marker))) {
       detected.push(key);
     }
   }
@@ -189,6 +153,30 @@ function getPlatformKeys() {
   return Object.keys(PLATFORMS);
 }
 
+// Warn opencode-only installs when a legacy .claude/ folder remains from
+// pre-0.9.0 installs (when OpenCode shared the .claude/ runtime). We do not
+// delete anything; user must remove it explicitly to opt in.
+function warnLegacyClaudeFolder(platforms) {
+  if (!platforms.includes('opencode')) return;
+  if (platforms.includes('claude')) return;
+  if (!fs.existsSync('.claude')) return;
+
+  console.log('');
+  console.log('⚠ Legacy .claude/ folder detected.');
+  console.log('  As of CafeKit 0.9.0, OpenCode installs are self-contained under .opencode/.');
+  console.log('  The .claude/ folder from older installs is no longer used by OpenCode.');
+  console.log('  After this install finishes you can remove it: rm -rf .claude');
+  console.log('');
+}
+
+function isClaudeCompatibleRuntime(platformKey) {
+  return platformKey === 'claude' || platformKey === 'opencode';
+}
+
+function getRuntimeSupportTargetDir(platformKey, subdir) {
+  return path.join(PLATFORMS[platformKey].folder, subdir);
+}
+
 function parseInstallerArgs(argv) {
   const args = {
     upgrade: false
@@ -205,6 +193,13 @@ function parseInstallerArgs(argv) {
   return args;
 }
 
+function getCopyOptions(platformKey, baseOptions = {}) {
+  if (platformKey === 'opencode') {
+    return getOpenCodeCopyOptions(baseOptions);
+  }
+  return baseOptions;
+}
+
 // ═══════════════════════════════════════════════════════════
 // USER INTERACTION
 // ═══════════════════════════════════════════════════════════
@@ -271,30 +266,6 @@ async function promptMultiPlatformConfirm(detected) {
 // FILE OPERATIONS
 // ═══════════════════════════════════════════════════════════
 
-function copyRecursive(src, dest, options = {}) {
-  const exists = fs.existsSync(src);
-  const stats = exists && fs.statSync(src);
-  const isDirectory = exists && stats.isDirectory();
-  const shouldOverwriteManagedFiles = Boolean(options.upgrade);
-
-  if (isDirectory) {
-    if (!fs.existsSync(dest)) {
-      fs.mkdirSync(dest, { recursive: true });
-    }
-    fs.readdirSync(src).forEach(childItemName => {
-      const destItemName = childItemName === 'gitignore' ? '.gitignore' : childItemName;
-      copyRecursive(path.join(src, childItemName), path.join(dest, destItemName), options);
-    });
-  } else {
-    if (fs.existsSync(dest) && !shouldOverwriteManagedFiles) {
-      return;
-    }
-
-    fs.mkdirSync(path.dirname(dest), { recursive: true });
-    fs.copyFileSync(src, dest);
-  }
-}
-
 function ensureDependencyFile(targetPath, content, results, label, options = {}) {
   const destinationExists = fs.existsSync(targetPath);
   const shouldOverwriteManagedFiles = Boolean(options.upgrade);
@@ -340,18 +311,6 @@ function ensureWorkflowDependencies(platformKey, platform, results, options = {}
   });
 }
 
-function readJsonFile(filePath) {
-  if (!fs.existsSync(filePath)) {
-    return {};
-  }
-
-  try {
-    return JSON.parse(fs.readFileSync(filePath, 'utf8'));
-  } catch {
-    return {};
-  }
-}
-
 function writePlatformVersionMetadata(platformKey, results) {
   const platform = PLATFORMS[platformKey];
   const targetPath = path.join(platform.folder, 'cafekit.json');
@@ -409,18 +368,8 @@ function getPlatformSpecFiles(platformKey) {
     ];
   }
 
-  if (platformKey === 'antigravity') {
-    return [
-      'spec-init.md',
-      'spec-requirements.md',
-      'spec-design.md',
-      'spec-validate.md',
-      'spec-tasks.md',
-      'spec-status.md',
-      'impact-analysis.md',
-      'docs-init.md',
-      'docs-update.md'
-    ];
+  if (platformKey === 'opencode') {
+    return [];
   }
 
   return [];
@@ -444,9 +393,10 @@ function copyPlatformFiles(platformKey, results, options = {}) {
   const agentsSourceDir = path.join(__dirname, `../src/${platform.sourceDir}/agents`);
 
   // Create directories
-  if (!fs.existsSync(platform.commandsDir)) {
-    fs.mkdirSync(platform.commandsDir, { recursive: true });
-  }
+  // commandsDir is created on-demand per platform: Claude only mkdirs when
+  // getPlatformSpecFiles returns files; OpenCode mkdirs inside
+  // copyOpenCodeCommandTemplates. Skip the unconditional mkdir to avoid
+  // leaving empty commands/ folders behind.
   if (!fs.existsSync(platform.skillsDir)) {
     fs.mkdirSync(platform.skillsDir, { recursive: true });
   }
@@ -461,7 +411,7 @@ function copyPlatformFiles(platformKey, results, options = {}) {
 
     if (fs.existsSync(specSkillSource)) {
       const skillExisted = fs.existsSync(specSkillDest);
-      copyRecursive(specSkillSource, specSkillDest, options);
+      copyRecursive(specSkillSource, specSkillDest, getCopyOptions(platformKey, options));
       results.installedSkills++;
 
       if (shouldOverwriteManagedFiles && skillExisted) {
@@ -525,11 +475,8 @@ function copyPlatformFiles(platformKey, results, options = {}) {
 
     // Copy additional required skills based on platform
     let requiredSkills = [];
-    if (platformKey === 'claude') {
+    if (isClaudeCompatibleRuntime(platformKey)) {
       requiredSkills = CLAUDE_MIGRATION_MANIFEST?.skills?.required || [];
-    } else if (platformKey === 'antigravity') {
-      // Antigravity also needs shared investigation and impact-analysis skills
-      requiredSkills = ['impact-analysis', 'debug', 'ai-multimodal', 'generate-graph'];
     }
 
     requiredSkills
@@ -540,7 +487,7 @@ function copyPlatformFiles(platformKey, results, options = {}) {
 
         if (fs.existsSync(skillSource)) {
           const skillExisted = fs.existsSync(skillDest);
-          copyRecursive(skillSource, skillDest, options);
+          copyRecursive(skillSource, skillDest, getCopyOptions(platformKey, options));
           results.installedSkills++;
 
           if (shouldOverwriteManagedFiles && skillExisted) {
@@ -557,7 +504,7 @@ function copyPlatformFiles(platformKey, results, options = {}) {
   }
 
   // Copy agents
-  if (platformKey === 'claude') {
+  if (isClaudeCompatibleRuntime(platformKey)) {
     if (fs.existsSync(agentsSourceDir)) {
       const requiredAgents = CLAUDE_MIGRATION_MANIFEST?.agents?.required || [
         'tester.md',
@@ -586,7 +533,12 @@ function copyPlatformFiles(platformKey, results, options = {}) {
         }
 
         fs.mkdirSync(path.dirname(dest), { recursive: true });
-        fs.copyFileSync(source, dest);
+        if (platformKey === 'opencode') {
+          const content = fs.readFileSync(source, 'utf8');
+          fs.writeFileSync(dest, convertOpenCodeAgentContent(content, fileName), 'utf8');
+        } else {
+          fs.copyFileSync(source, dest);
+        }
         results.dependencyChecks++;
         results.installedDependencies++;
 
@@ -601,9 +553,9 @@ function copyPlatformFiles(platformKey, results, options = {}) {
       // Copy agent reference manuals (debugger manuals, etc.) recursively
       const refsSource = path.join(__dirname, '../src', platform.sourceDir, 'references');
       if (fs.existsSync(refsSource)) {
-        const refsDest = path.join(platform.folder, 'references');
+        const refsDest = getRuntimeSupportTargetDir(platformKey, 'references');
         const refsExisted = fs.existsSync(refsDest);
-        copyRecursive(refsSource, refsDest, options);
+        copyRecursive(refsSource, refsDest, getCopyOptions(platformKey, options));
 
         if (shouldOverwriteManagedFiles && refsExisted) {
           console.log(`  ↻ Agent reference manuals updated`);
@@ -622,9 +574,9 @@ function copyPlatformFiles(platformKey, results, options = {}) {
     // Copy native scripts (browser-tool, docs-fetch, validate-docs)
     const scriptsSourceDir = path.join(__dirname, '../src/claude/scripts');
     if (fs.existsSync(scriptsSourceDir)) {
-      const scriptsDest = path.join(platform.folder, 'scripts');
+      const scriptsDest = getRuntimeSupportTargetDir(platformKey, 'scripts');
       const scriptsExisted = fs.existsSync(scriptsDest);
-      copyRecursive(scriptsSourceDir, scriptsDest, options);
+      copyRecursive(scriptsSourceDir, scriptsDest, getCopyOptions(platformKey, options));
 
       if (shouldOverwriteManagedFiles && scriptsExisted) {
         console.log(`  ↻ Native scripts updated`);
@@ -662,6 +614,9 @@ function copyPlatformFiles(platformKey, results, options = {}) {
     fs.mkdirSync(path.dirname(dest), { recursive: true });
     let content = fs.readFileSync(source, 'utf8');
     content = content.replace(/\{\{SKILLS_DIR\}\}/g, platform.skillsRef);
+    if (platformKey === 'opencode') {
+      content = convertOpenCodeCommandContent(content, file);
+    }
     fs.writeFileSync(dest, content);
 
     if (destinationExists && shouldOverwriteManagedFiles) {
@@ -692,6 +647,9 @@ function copyRoutingFile(platformKey, results, options = {}) {
 
     let content = fs.readFileSync(source, 'utf8');
     content = content.replace(/\{\{SKILLS_DIR\}\}/g, platform.skillsRef);
+    if (platformKey === 'opencode') {
+      content = normalizeOpenCodeBody(content);
+    }
     fs.writeFileSync(dest, content);
 
     if (destinationExists && shouldOverwriteManagedFiles) {
@@ -704,40 +662,6 @@ function copyRoutingFile(platformKey, results, options = {}) {
   }
 }
 
-// Copy GEMINI.md rule file to .agent/rules/ for Antigravity
-function copyGeminiFile(platformKey, results, options = {}) {
-  const platform = PLATFORMS[platformKey];
-  const shouldOverwriteManagedFiles = Boolean(options.upgrade);
-  const rulesDir = path.join(platform.folder, 'rules');
-  const source = path.join(__dirname, `../src/${platform.sourceDir}/GEMINI.md`);
-  const dest = path.join(rulesDir, 'GEMINI.md');
-
-  if (fs.existsSync(source)) {
-    // Create rules directory if not exists
-    if (!fs.existsSync(rulesDir)) {
-      fs.mkdirSync(rulesDir, { recursive: true });
-    }
-
-    const destinationExists = fs.existsSync(dest);
-
-    if (destinationExists && !shouldOverwriteManagedFiles) {
-      console.log(`  → Skipped: rules/GEMINI.md (already exists)`);
-      results.skipped++;
-      return;
-    }
-
-    fs.copyFileSync(source, dest);
-
-    if (destinationExists && shouldOverwriteManagedFiles) {
-      console.log(`  ↻ Updated: rules/GEMINI.md`);
-      results.updated++;
-    } else {
-      console.log(`  ✓ Copied: rules/GEMINI.md`);
-      results.copied++;
-    }
-  }
-}
-
 // Copy Claude runtime files (statusline bundle)
 function copyClaudeRuntimeFiles(platformKey, results, options = {}) {
   if (platformKey !== 'claude') return;
@@ -944,13 +868,13 @@ function copyClaudeMdFile(platformKey, results, options = {}) {
 
 // Copy rules directory (always overwrite)
 function copyRulesDirectory(platformKey, results, options = {}) {
-  if (platformKey !== 'claude') return;
+  if (!isClaudeCompatibleRuntime(platformKey)) return;
 
   const source = path.join(__dirname, '../src/claude/rules');
-  const dest = path.join(PLATFORMS.claude.folder, 'rules');
+  const dest = getRuntimeSupportTargetDir(platformKey, 'rules');
 
   if (fs.existsSync(source)) {
-    copyRecursive(source, dest, { upgrade: true });
+    copyRecursive(source, dest, getCopyOptions(platformKey, { upgrade: true }));
     console.log(`  ↻ rules/ directory overwritten`);
     results.updated++;
   } else {
@@ -1061,26 +985,37 @@ async function promptGeminiAPIKey() {
   });
 }
 
-function configureGeminiKey(apiKey) {
-  try {
-    const targetDir = path.join(process.cwd(), '.claude');
-    const localEnvFile = path.join(targetDir, '.env');
+function configureGeminiKey(apiKey, platforms = ['claude']) {
+  const envBody = `GEMINI_API_KEY=${apiKey}\nVISUAL_MODEL=gemma-4-31b-it\nSEARCH_MODEL=gemini-2.5-pro\n`;
+  const targets = platforms
+    .filter(key => PLATFORMS[key])
+    .map(key => PLATFORMS[key].folder);
 
-    if (!fs.existsSync(targetDir)) {
-      fs.mkdirSync(targetDir, { recursive: true });
-    }
+  if (targets.length === 0) {
+    targets.push('.claude');
+  }
 
-    // Luôn ghi trực tiếp key vào rốn của não bộ AI
-    fs.writeFileSync(localEnvFile, `GEMINI_API_KEY=${apiKey}\nVISUAL_MODEL=gemma-4-31b-it\nSEARCH_MODEL=gemini-2.5-pro\n`, { mode: 0o600 });
-    console.log('  ✓ Gemini API key configured securely in project (.claude/.env)');
+  let success = true;
+  for (const folder of targets) {
+    try {
+      const targetDir = path.join(process.cwd(), folder);
+      const localEnvFile = path.join(targetDir, '.env');
 
-    return true;
-  } catch (error) {
-    console.log('  ✗ Failed to configure Gemini API key');
-    console.log(`  Error: ${error.message}`);
-    console.log('  You can manually set: export GEMINI_API_KEY="your-key"');
-    return false;
+      if (!fs.existsSync(targetDir)) {
+        fs.mkdirSync(targetDir, { recursive: true });
+      }
+
+      fs.writeFileSync(localEnvFile, envBody, { mode: 0o600 });
+      console.log(`  ✓ Gemini API key configured securely in project (${folder}/.env)`);
+    } catch (error) {
+      success = false;
+      console.log('  ✗ Failed to configure Gemini API key');
+      console.log(`  Error: ${error.message}`);
+      console.log('  You can manually set: export GEMINI_API_KEY="your-key"');
+    }
   }
+
+  return success;
 }
 
 async function setupGeminiCLI(platforms) {
@@ -1102,7 +1037,7 @@ async function setupGeminiCLI(platforms) {
   // Always prompt for API config since we need it for hapo:test Multimodal
   const apiKey = await promptGeminiAPIKey();
   if (apiKey) {
-    configureGeminiKey(apiKey);
+    configureGeminiKey(apiKey, platforms);
   } else {
     console.log('\n  ℹ Skipped API key configuration');
     console.log('  Set later: export GEMINI_API_KEY="your-key"');
@@ -1149,6 +1084,8 @@ async function main() {
   const platformNames = platforms.map(key => PLATFORMS[key].name).join(', ');
   console.log(`\nInstalling for: ${platformNames}`);
 
+  warnLegacyClaudeFolder(platforms);
+
   if (installerOptions.upgrade) {
     console.log('Mode: upgrade (overwrite managed files)\n');
   } else {
@@ -1185,9 +1122,13 @@ async function main() {
         copyRulesDirectory(platformKey, results, installerOptions);
       }
 
-      // Copy GEMINI.md for Antigravity platform
-      if (platformKey === 'antigravity') {
-        copyGeminiFile(platformKey, results, installerOptions);
+      if (platformKey === 'opencode') {
+        copyOpenCodeSharedRuntimeFiles(platformKey, results, installerOptions);
+        copyOpenCodePlugins(platformKey, results, installerOptions);
+        copyOpenCodeCommandTemplates(platformKey, results, installerOptions);
+        copyOpenCodeAgentsMdFile(platformKey, results, installerOptions);
+        copyRulesDirectory(platformKey, results, installerOptions);
+        mergeOpenCodeConfig(platformKey, results);
       }
 
       writePlatformVersionMetadata(platformKey, results);
@@ -1202,7 +1143,8 @@ async function main() {
     ensureGitignore(results, installerOptions);
     console.log();
 
-    // Setup Gemini CLI and API Key config
+    // Setup runtime-specific optional model/API configuration
+    await setupOpenCodeModel(platforms, results);
     await setupGeminiCLI(platforms);
 
     // Summary
@@ -1238,8 +1180,13 @@ async function main() {
       }
     }
 
-    console.log('\n  2. The AI will automatically sync docs/ (Continuous Documentation)');
-    console.log('  3. Project API Keys are now securely isolated in .claude/.env');
+    if (platforms.includes('claude')) {
+      console.log('\n  2. Claude Code will automatically sync docs/ (Continuous Documentation)');
+    } else {
+      console.log('\n  2. CafeKit skills and AGENTS.md are installed for the selected runtime');
+    }
+    const envHosts = platforms.map(key => `${PLATFORMS[key].folder}/.env`).join(' and ');
+    console.log(`  3. Project API Keys are now securely isolated in ${envHosts}`);
     if (!installerOptions.upgrade) {
       console.log('  4. To refresh managed templates later, run installer with --upgrade');
     }

package/bin/lib/copy-utils.js

@@ -0,0 +1,61 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const TEXT_REWRITE_EXTENSIONS = new Set([
+  '.md', '.mdx', '.txt', '.json', '.cjs', '.js', '.mjs', '.ts', '.sh', '.yml', '.yaml'
+]);
+
+function isTextAsset(filePath) {
+  return TEXT_REWRITE_EXTENSIONS.has(path.extname(filePath).toLowerCase());
+}
+
+function copyRecursive(src, dest, options = {}) {
+  const exists = fs.existsSync(src);
+  const stats = exists && fs.statSync(src);
+  const isDirectory = exists && stats.isDirectory();
+  const shouldOverwriteManagedFiles = Boolean(options.upgrade);
+
+  if (isDirectory) {
+    if (!fs.existsSync(dest)) {
+      fs.mkdirSync(dest, { recursive: true });
+    }
+    fs.readdirSync(src).forEach(childItemName => {
+      const destItemName = childItemName === 'gitignore' ? '.gitignore' : childItemName;
+      copyRecursive(path.join(src, childItemName), path.join(dest, destItemName), options);
+    });
+  } else {
+    if (fs.existsSync(dest) && !shouldOverwriteManagedFiles) {
+      return;
+    }
+
+    fs.mkdirSync(path.dirname(dest), { recursive: true });
+
+    if (typeof options.transform === 'function' && isTextAsset(src)) {
+      const original = fs.readFileSync(src, 'utf8');
+      fs.writeFileSync(dest, options.transform(original, src), 'utf8');
+    } else {
+      fs.copyFileSync(src, dest);
+    }
+  }
+}
+
+function readJsonFile(filePath) {
+  if (!fs.existsSync(filePath)) {
+    return {};
+  }
+
+  try {
+    return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+  } catch {
+    return {};
+  }
+}
+
+module.exports = {
+  TEXT_REWRITE_EXTENSIONS,
+  isTextAsset,
+  copyRecursive,
+  readJsonFile
+};