opencode-lisa 0.2.1 → 0.3.0

package/README.md

@@ -26,10 +26,27 @@ The **Ralph Wiggum pattern** is a simple bash loop that keeps feeding prompts to
 ## Install
 
 ```bash
-npm install opencode-lisa
+npm install -D opencode-lisa
+npx opencode-lisa init
 ```
 
-Add to your `opencode.json`:
+This will:
+- Install command and skill files to `.opencode/`
+- Add the plugin to your `opencode.json`
+- Set up Lisa for use in your project
+
+Requires [OpenCode](https://opencode.ai) 1.0+.
+
+### Global Installation
+
+To install Lisa globally for all projects:
+
+```bash
+npm install -g opencode-lisa
+npx opencode-lisa init --global
+```
+
+Add to your global `~/.config/opencode/opencode.json`:
 
 ```json
 {
@@ -37,8 +54,6 @@ Add to your `opencode.json`:
 }
 ```
 
-Restart OpenCode. Requires [OpenCode](https://opencode.ai).
-
 ## Usage
 
 ```

package/bin/cli.js

@@ -0,0 +1,252 @@
+#!/usr/bin/env node
+
+import { existsSync, mkdirSync, readFileSync, writeFileSync, copyFileSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { createInterface } from 'readline';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const ASSETS_DIR = join(__dirname, '..', 'assets');
+
+// ANSI colors
+const colors = {
+  green: (s) => `\x1b[32m${s}\x1b[0m`,
+  yellow: (s) => `\x1b[33m${s}\x1b[0m`,
+  red: (s) => `\x1b[31m${s}\x1b[0m`,
+  cyan: (s) => `\x1b[36m${s}\x1b[0m`,
+  dim: (s) => `\x1b[2m${s}\x1b[0m`,
+};
+
+async function prompt(question) {
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.toLowerCase().trim());
+    });
+  });
+}
+
+async function confirmOverwrite(filePath, force) {
+  if (!existsSync(filePath)) return true;
+  if (force) return true;
+
+  const answer = await prompt(
+    `${colors.yellow('?')} ${filePath} already exists. Overwrite? (y/N) `
+  );
+  return answer === 'y' || answer === 'yes';
+}
+
+function ensureDir(filePath) {
+  const dir = dirname(filePath);
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+}
+
+function copyAsset(srcRelative, destPath, force) {
+  return async () => {
+    const srcPath = join(ASSETS_DIR, srcRelative);
+    
+    if (!existsSync(srcPath)) {
+      console.error(colors.red(`Error: Source file not found: ${srcPath}`));
+      process.exit(1);
+    }
+
+    const shouldWrite = await confirmOverwrite(destPath, force);
+    if (!shouldWrite) {
+      console.log(colors.dim(`  Skipped: ${destPath}`));
+      return false;
+    }
+
+    ensureDir(destPath);
+    copyFileSync(srcPath, destPath);
+    console.log(colors.green(`  Created: ${destPath}`));
+    return true;
+  };
+}
+
+function updateOpencodeJson(targetDir, force) {
+  return async () => {
+    const configPath = join(targetDir, 'opencode.json');
+    let config = {};
+    let existed = false;
+
+    if (existsSync(configPath)) {
+      existed = true;
+      try {
+        const content = readFileSync(configPath, 'utf-8');
+        config = JSON.parse(content);
+      } catch (e) {
+        console.error(colors.red(`Error parsing ${configPath}: ${e.message}`));
+        const answer = await prompt(
+          `${colors.yellow('?')} Create a new opencode.json? (y/N) `
+        );
+        if (answer !== 'y' && answer !== 'yes') {
+          console.log(colors.dim(`  Skipped: opencode.json update`));
+          return false;
+        }
+        config = {};
+      }
+    }
+
+    // Ensure plugin array exists
+    if (!config.plugin) {
+      config.plugin = [];
+    }
+
+    // Check if already has the plugin
+    if (config.plugin.includes('opencode-lisa')) {
+      console.log(colors.dim(`  Already configured: opencode-lisa in plugins`));
+      return false;
+    }
+
+    // Add the plugin
+    config.plugin.push('opencode-lisa');
+
+    // Add schema if not present
+    if (!config.$schema) {
+      config.$schema = 'https://opencode.ai/config.json';
+    }
+
+    ensureDir(configPath);
+    writeFileSync(configPath, JSON.stringify(config, null, 2) + '\n');
+    
+    if (existed) {
+      console.log(colors.green(`  Updated: opencode.json (added opencode-lisa to plugins)`));
+    } else {
+      console.log(colors.green(`  Created: opencode.json`));
+    }
+    return true;
+  };
+}
+
+async function init(targetDir, options) {
+  const { force, global: isGlobal } = options;
+
+  console.log('');
+  console.log(colors.cyan('Lisa - Intelligent Epic Workflow Plugin'));
+  console.log(colors.dim('Installing command and skill files...'));
+  console.log('');
+
+  const tasks = [
+    {
+      name: 'skill',
+      run: copyAsset(
+        'skills/lisa/SKILL.md',
+        join(targetDir, '.opencode', 'skills', 'lisa', 'SKILL.md'),
+        force
+      ),
+    },
+    {
+      name: 'command',
+      run: copyAsset(
+        'commands/lisa.md',
+        join(targetDir, '.opencode', 'commands', 'lisa.md'),
+        force
+      ),
+    },
+  ];
+
+  // Only update opencode.json for local installs (not global)
+  if (!isGlobal) {
+    tasks.push({
+      name: 'config',
+      run: updateOpencodeJson(targetDir, force),
+    });
+  }
+
+  let anyCreated = false;
+  for (const task of tasks) {
+    const created = await task.run();
+    if (created) anyCreated = true;
+  }
+
+  console.log('');
+
+  if (anyCreated) {
+    console.log(colors.green('Done!'));
+    console.log('');
+    console.log('Lisa is now installed. You can use:');
+    console.log('');
+    console.log(`  ${colors.cyan('/lisa')} - Run Lisa commands in OpenCode`);
+    console.log(`  ${colors.cyan('/lisa help')} - Show available Lisa commands`);
+    console.log(`  ${colors.cyan('/lisa list')} - List all your epics`);
+    console.log('');
+    console.log(colors.dim('Start by running /lisa <epic-name> to create your first epic!'));
+  } else {
+    console.log(colors.dim('Nothing to do - everything is already set up.'));
+  }
+
+  console.log('');
+}
+
+function printHelp() {
+  console.log(`
+${colors.cyan('Lisa - Intelligent Epic Workflow Plugin')}
+
+Like Ralph Wiggum, but smarter. Lisa plans before she acts.
+
+Usage:
+  npx opencode-lisa init [options]
+
+Commands:
+  init          Install the Lisa command and skill files
+
+Options:
+  --force       Overwrite existing files without asking
+  --global      Install to ~/.config/opencode/ instead of current directory
+  --help, -h    Show this help message
+
+Examples:
+  npx opencode-lisa init
+  npx opencode-lisa init --force
+  npx opencode-lisa init --global
+
+After installation, use /lisa in OpenCode to get started!
+`);
+}
+
+async function main() {
+  const args = process.argv.slice(2);
+  
+  // Parse flags
+  const force = args.includes('--force') || args.includes('-f');
+  const isGlobal = args.includes('--global') || args.includes('-g');
+  const help = args.includes('--help') || args.includes('-h');
+  
+  // Get command (first non-flag argument)
+  const command = args.find((arg) => !arg.startsWith('-'));
+
+  if (help || (!command && args.length === 0)) {
+    printHelp();
+    process.exit(0);
+  }
+
+  if (command !== 'init') {
+    console.error(colors.red(`Unknown command: ${command}`));
+    console.error(`Run ${colors.cyan('npx opencode-lisa --help')} for usage.`);
+    process.exit(1);
+  }
+
+  // Determine target directory
+  let targetDir;
+  if (isGlobal) {
+    const home = process.env.HOME || process.env.USERPROFILE;
+    targetDir = join(home, '.config', 'opencode');
+  } else {
+    targetDir = process.cwd();
+  }
+
+  await init(targetDir, { force, global: isGlobal });
+}
+
+main().catch((err) => {
+  console.error(colors.red('Error:'), err.message);
+  process.exit(1);
+});

package/package.json

@@ -1,9 +1,12 @@
 {
   "name": "opencode-lisa",
-  "version": "0.2.1",
+  "version": "0.3.0",
   "description": "Lisa - intelligent epic workflow plugin for OpenCode. Like Ralph Wiggum, but smarter.",
   "type": "module",
   "main": "dist/index.js",
+  "bin": {
+    "opencode-lisa": "./bin/cli.js"
+  },
   "exports": {
     ".": {
       "import": "./dist/index.js"
@@ -11,8 +14,8 @@
   },
   "files": [
     "dist",
-    ".opencode/command",
-    ".opencode/skill"
+    "bin",
+    "assets"
   ],
   "scripts": {
     "build": "bun build src/index.ts --outdir dist --target bun --format esm",
@@ -39,11 +42,17 @@
   "bugs": {
     "url": "https://github.com/fractalswift/lisa-simpson/issues"
   },
+  "engines": {
+    "node": ">=18.0.0"
+  },
   "peerDependencies": {
     "@opencode-ai/plugin": ">=1.0.0"
   },
   "devDependencies": {
     "@opencode-ai/plugin": "^1.1.25",
     "typescript": "^5.0.0"
+  },
+  "dependencies": {
+    "opencode-lisa": "^0.2.1"
   }
 }