opencode-auto-agent 1.0.0 → 1.2.0

package/README.md

@@ -2,14 +2,17 @@
 
 `opencode-auto-agent` is a lightweight starter template for running a reusable AI agent team with **Ralphy + OpenCode**.
 
-It scaffolds a standard project integration folder, ships language-agnostic agent definitions, and supports stack presets like Java, Spring Boot, and Next.js.
+It scaffolds a standard project integration folder, ships language-agnostic agent definitions, supports stack presets like Java, Spring Boot, and Next.js, and now includes model-aware setup aligned with OpenCode's agent schema.
 
 ## Features
 
-- One-command project setup
+- One-command project setup with interactive TUI
 - Reusable agent team (orchestrator, planner, developer, qa, reviewer, docs)
 - Preset-based context (Java, Spring Boot, Next.js)
 - Orchestrated workflow: plan -> implement -> test -> verify
+- Model discovery from `opencode models` and per-agent model assignment
+- OpenCode-aligned config generation (`opencode.json` + `.opencode/config.json`)
+- Validation tooling for config, agents, rules, and model availability
 - Auto-release pipeline with semantic-release (GitHub Actions)
 
 ## Installation
@@ -30,11 +33,21 @@ npm install -g opencode-auto-agent
 
 ```bash
 opencode-auto-agent init [--preset=<name>]
-opencode-auto-agent run [--engine=<name>]
-opencode-auto-agent setup <preset>
-opencode-auto-agent doctor
+opencode-auto-agent run [--engine=<name>] [--dry-run]
+opencode-auto-agent setup [preset] [--models]
+opencode-auto-agent doctor [--verbose]
+opencode-auto-agent models [provider]
+opencode-auto-agent config
 ```
 
+### Common Flags
+
+- `--dir=<path>`: target directory (default: current directory)
+- `--force`: overwrite existing generated files during `init`
+- `--non-interactive`: skip prompts and use defaults
+- `--models`: reconfigure model assignments during `setup`
+- `--dry-run`: assemble runtime context without launching Ralphy
+
 ### Presets
 
 - `java`
@@ -46,6 +59,7 @@ opencode-auto-agent doctor
 ```bash
 npx opencode-auto-agent init --preset=nextjs
 npx opencode-auto-agent doctor
+npx opencode-auto-agent models
 npx opencode-auto-agent run
 ```
 
@@ -54,7 +68,7 @@ npx opencode-auto-agent run
 The `init` command creates:
 
 ```text
-.ai-starter-kit/
+.opencode/
   agents/
   presets/
   context/
@@ -67,12 +81,16 @@ Plus helper config files:
 - `opencode.json`
 - `.ralphy/config.yaml`
 
+`config.json` includes a `models` map (role -> `provider/model-id`) and mirrored agent model settings in `agents`.
+
 ## Requirements
 
 - Node.js 18+
 - OpenCode CLI installed and configured
 - Ralphy CLI installed
 
+The CLI validates prerequisites and does not auto-install missing tools.
+
 ## Releasing
 
 Releases are fully automated via semantic-release on pushes to `main`.

package/bin/cli.js

@@ -1,19 +1,22 @@
 #!/usr/bin/env node
 
 /**
- * opencode-auto-agent CLI
+ * opencode-auto-agent CLI — main entry point.
  *
  * Commands:
- *   init              Scaffold .ai-starter-kit/ into the current repo
- *   run               Start the orchestrator (Ralphy + OpenCode agents)
- *   setup <preset>    Apply or switch a preset (java, springboot, nextjs, ...)
- *   doctor            Validate configuration and tool availability
+ *   init                Scaffold .opencode/ into the current project
+ *   run                 Start the orchestrator (Ralphy + OpenCode agents)
+ *   setup [preset]      Apply or switch a preset (java, springboot, nextjs, ...)
+ *   doctor              Validate configuration, tools, and agent definitions
+ *   models              Show available models from OpenCode
+ *   config              Show current project configuration
+ *   help                Show this help message
  */
 
-import { resolve, basename } from "node:path";
+import { resolve } from "node:path";
 import { argv, exit, cwd } from "node:process";
 
-// ── arg parsing (zero-dep) ─────────────────────────────────────────────────
+// ── Arg parsing (zero-dep) ─────────────────────────────────────────────────
 const args = argv.slice(2);
 const command = args[0] || "help";
 const positional = args.slice(1).filter((a) => !a.startsWith("--"));
@@ -28,77 +31,298 @@ const flags = Object.fromEntries(
 
 const TARGET_DIR = resolve(flags.dir || cwd());
 
-// ── dynamic import of command modules ──────────────────────────────────────
+// ── Command router ─────────────────────────────────────────────────────────
 async function main() {
   switch (command) {
     case "init": {
       const { init } = await import("../src/commands/init.js");
-      await init(TARGET_DIR, { preset: positional[0] || flags.preset });
+      await init(TARGET_DIR, {
+        preset: positional[0] || flags.preset,
+        force: !!flags.force,
+        nonInteractive: !!flags["non-interactive"],
+      });
       break;
     }
+
     case "run": {
       const { run } = await import("../src/commands/run.js");
-      await run(TARGET_DIR, flags);
+      await run(TARGET_DIR, {
+        engine: flags.engine,
+        dryRun: !!flags["dry-run"],
+        verbose: !!flags.verbose,
+      });
       break;
     }
+
     case "setup": {
       const { setup } = await import("../src/commands/setup.js");
-      const preset = positional[0] || flags.preset;
-      if (!preset) {
-        console.error("Usage: opencode-auto-agent setup <preset>");
-        console.error("Available presets: java, springboot, nextjs");
-        exit(1);
-      }
-      await setup(TARGET_DIR, preset);
+      const preset = positional[0] || flags.preset || null;
+      await setup(TARGET_DIR, preset, {
+        models: !!flags.models,
+        nonInteractive: !!flags["non-interactive"],
+      });
       break;
     }
+
     case "doctor": {
       const { doctor } = await import("../src/commands/doctor.js");
-      await doctor(TARGET_DIR);
+      await doctor(TARGET_DIR, {
+        verbose: !!flags.verbose,
+      });
       break;
     }
+
+    case "models": {
+      await showModels(positional[0] || flags.provider);
+      break;
+    }
+
+    case "config": {
+      await showConfig(TARGET_DIR);
+      break;
+    }
+
     case "help":
     case "--help":
     case "-h":
+      await printHelp();
+      break;
+
+    case "--version":
+    case "-v":
+      await printVersion();
+      break;
+
     default:
-      printHelp();
+      // Check if it's a known flag passed as first arg
+      if (command.startsWith("-")) {
+        await printHelp();
+      } else {
+        const { c } = await import("../src/lib/ui.js");
+        console.log(`\n  ${c.red("Unknown command:")} ${command}`);
+        console.log(`  ${c.gray("Run 'opencode-auto-agent help' for usage.\n")}`);
+        exit(1);
+      }
       break;
   }
 }
 
-function printHelp() {
-  const name = "opencode-auto-agent";
-  console.log(`
-${name} v0.1.0 — AI agent team starter kit (Ralphy + OpenCode)
-
-USAGE
-  npx ${name} <command> [options]
-
-COMMANDS
-  init [--preset=<name>]   Scaffold .ai-starter-kit/ into the current project
-  run  [--engine=<name>]   Start the orchestrator (Ralphy task loop)
-  setup <preset>           Apply or switch a preset (java | springboot | nextjs)
-  doctor                   Validate config, tools, and agent definitions
-
-OPTIONS
-  --dir=<path>             Target directory (default: cwd)
-  --preset=<name>          Preset to apply during init
-  --engine=<name>          Ralphy engine (opencode | claude | cursor, default: opencode)
-
-PRESETS
-  java         General Java project (Maven/Gradle)
-  springboot   Spring Boot web application
-  nextjs       Next.js (React) application
-
-EXAMPLES
-  npx ${name} init --preset=nextjs
-  npx ${name} run
-  npx ${name} setup springboot
-  npx ${name} doctor
-`);
+// ── models command ─────────────────────────────────────────────────────────
+
+async function showModels(providerFilter) {
+  const { banner, section, status, c, table } = await import("../src/lib/ui.js");
+  const { discoverModelsInteractive, groupByProvider } = await import("../src/lib/models.js");
+
+  banner("OpenCode Models", "Available models from configured providers");
+
+  const models = discoverModelsInteractive();
+
+  if (models.length === 0) {
+    status("warn", "No models found.", "Is opencode configured with providers?");
+    return;
+  }
+
+  const groups = groupByProvider(models);
+
+  if (providerFilter) {
+    // Show only the specified provider
+    const filtered = groups.get(providerFilter);
+    if (!filtered) {
+      status("fail", `Provider "${providerFilter}" not found.`);
+      console.log(`  ${c.gray("Available providers:")} ${[...groups.keys()].join(", ")}`);
+      return;
+    }
+
+    section(`Provider: ${providerFilter}`);
+    table(
+      ["Model ID", "Model Name"],
+      filtered.map((m) => [c.cyan(m.id), m.model])
+    );
+  } else {
+    // Show all providers grouped
+    for (const [provider, providerModels] of groups) {
+      section(`Provider: ${provider}`);
+      table(
+        ["Model ID", "Model Name"],
+        providerModels.map((m) => [c.cyan(m.id), m.model])
+      );
+    }
+  }
+
+  console.log();
+  status("info", `Total: ${c.bold(String(models.length))} models from ${c.bold(String(groups.size))} providers`);
+  console.log();
+}
+
+// ── config command ─────────────────────────────────────────────────────────
+
+async function showConfig(targetDir) {
+  const { join } = await import("node:path");
+  const { banner, section, kv, status, c, table, error } = await import("../src/lib/ui.js");
+  const { readJsonSync } = await import("../src/lib/fs-utils.js");
+  const { SCAFFOLD_DIR, CONFIG_FILE, AGENTS, AGENT_ROLES } = await import("../src/lib/constants.js");
+
+  banner("OpenCode Auto-Agent Config", "Current project configuration");
+
+  const scaffoldDir = join(targetDir, SCAFFOLD_DIR);
+  const configPath = join(scaffoldDir, CONFIG_FILE);
+  const config = readJsonSync(configPath);
+
+  if (!config) {
+    error(
+      "No configuration found.",
+      "Run 'npx opencode-auto-agent init' to scaffold the project."
+    );
+    return;
+  }
+
+  section("General");
+  kv("Version", config.version || "unknown");
+  kv("Preset", config.preset || "(none)");
+  kv("Engine", config.engine || "opencode");
+  kv("Tasks path", config.tasksPath || "PRD.md");
+  kv("Docs path", config.docsPath || "Docs");
+  kv("Output path", config.outputPath || "./");
+
+  if (config.models) {
+    section("Model Assignments");
+    table(
+      ["Agent", "Model", "Mode", "Status"],
+      AGENTS.map((role) => {
+        const enabled = config.agents?.[role]?.enabled !== false;
+        return [
+          c.bold(role),
+          c.cyan(config.models[role] || "(not set)"),
+          c.gray(AGENT_ROLES[role]?.mode || "subagent"),
+          enabled ? c.green("enabled") : c.gray("disabled"),
+        ];
+      })
+    );
+  }
+
+  if (config.orchestrator) {
+    section("Orchestrator");
+    kv("Workflow", (config.orchestrator.workflowSteps || []).join(" \u2192 "));
+    kv("Require plan approval", String(config.orchestrator.requirePlanApproval ?? false));
+  }
+
+  if (config.instructions) {
+    section("Instructions");
+    for (const instr of config.instructions) {
+      status("dot", instr);
+    }
+  }
+
+  if (config.rules) {
+    section("Rules");
+    for (const rule of config.rules) {
+      status("dot", rule);
+    }
+  }
+
+  // Also show opencode.json status
+  const { existsSync } = await import("node:fs");
+  const opencodeConfig = join(targetDir, "opencode.json");
+  const ralphyConfig = join(targetDir, ".ralphy", "config.yaml");
+
+  console.log();
+  section("Integration Files");
+  status(
+    existsSync(opencodeConfig) ? "pass" : "warn",
+    "opencode.json",
+    existsSync(opencodeConfig) ? "exists" : "missing"
+  );
+  status(
+    existsSync(ralphyConfig) ? "pass" : "warn",
+    ".ralphy/config.yaml",
+    existsSync(ralphyConfig) ? "exists" : "missing"
+  );
+
+  console.log();
+}
+
+// ── help command ───────────────────────────────────────────────────────────
+
+async function printHelp() {
+  const { banner, c } = await import("../src/lib/ui.js");
+  const pkg = await loadPkg();
+
+  banner(
+    "opencode-auto-agent",
+    `v${pkg.version} \u2014 AI agent team starter kit (Ralphy + OpenCode)`
+  );
+
+  const indent = "  ";
+  const cmd = (name, desc) => `${indent}${c.cyan(name.padEnd(28))} ${c.gray(desc)}`;
+
+  console.log(`${indent}${c.bold("USAGE")}`);
+  console.log(`${indent}  npx opencode-auto-agent <command> [options]\n`);
+
+  console.log(`${indent}${c.bold("COMMANDS")}`);
+  console.log(cmd("init [--preset=<name>]", "Scaffold .opencode/ into the current project"));
+  console.log(cmd("run  [--engine=<name>]", "Start the orchestrator (Ralphy task loop)"));
+  console.log(cmd("setup [preset]", "Apply or switch a preset"));
+  console.log(cmd("doctor", "Validate config, tools, and agent definitions"));
+  console.log(cmd("models [provider]", "Show available models from OpenCode"));
+  console.log(cmd("config", "Show current project configuration"));
+  console.log(cmd("help", "Show this help message"));
+  console.log();
+
+  console.log(`${indent}${c.bold("OPTIONS")}`);
+  console.log(cmd("--dir=<path>", "Target directory (default: cwd)"));
+  console.log(cmd("--preset=<name>", "Preset to apply during init/setup"));
+  console.log(cmd("--engine=<name>", "Ralphy engine (opencode | claude | cursor)"));
+  console.log(cmd("--force", "Overwrite existing files during init"));
+  console.log(cmd("--non-interactive", "Skip all prompts, use defaults"));
+  console.log(cmd("--dry-run", "Assemble context without launching Ralphy"));
+  console.log(cmd("--models", "Reconfigure model assignments (with setup)"));
+  console.log(cmd("--verbose", "Show extra detail (doctor, run)"));
+  console.log(cmd("--version, -v", "Show version"));
+  console.log();
+
+  console.log(`${indent}${c.bold("PRESETS")}`);
+  console.log(cmd("java", "General Java project (Maven/Gradle)"));
+  console.log(cmd("springboot", "Spring Boot 3.x web application"));
+  console.log(cmd("nextjs", "Next.js 14+ with App Router"));
+  console.log();
+
+  console.log(`${indent}${c.bold("EXAMPLES")}`);
+  console.log(`${indent}  ${c.gray("$")} npx opencode-auto-agent init --preset=nextjs`);
+  console.log(`${indent}  ${c.gray("$")} npx opencode-auto-agent setup springboot --models`);
+  console.log(`${indent}  ${c.gray("$")} npx opencode-auto-agent models openai`);
+  console.log(`${indent}  ${c.gray("$")} npx opencode-auto-agent run --dry-run`);
+  console.log(`${indent}  ${c.gray("$")} npx opencode-auto-agent doctor --verbose`);
+  console.log();
+}
+
+// ── version command ────────────────────────────────────────────────────────
+
+async function printVersion() {
+  const pkg = await loadPkg();
+  console.log(`opencode-auto-agent v${pkg.version}`);
+}
+
+// ── Helpers ────────────────────────────────────────────────────────────────
+
+async function loadPkg() {
+  const { readFileSync } = await import("node:fs");
+  const { resolve: resolvePath, dirname } = await import("node:path");
+  const { fileURLToPath } = await import("node:url");
+  const __dirname = dirname(fileURLToPath(import.meta.url));
+  try {
+    return JSON.parse(readFileSync(resolvePath(__dirname, "..", "package.json"), "utf8"));
+  } catch {
+    return { version: "0.0.0" };
+  }
 }
 
+// ── Run ────────────────────────────────────────────────────────────────────
 main().catch((err) => {
-  console.error("Fatal:", err.message || err);
-  exit(1);
+  import("../src/lib/ui.js").then(({ error: uiError }) => {
+    uiError(err.message || String(err));
+    exit(1);
+  }).catch(() => {
+    console.error("Fatal:", err.message || err);
+    exit(1);
+  });
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-auto-agent",
-  "version": "1.0.0",
+  "version": "1.2.0",
   "description": "Scaffold and run an AI agent team powered by Ralphy + OpenCode. Presets for Java, Spring Boot, Next.js, and more.",
   "license": "MIT",
   "type": "module",