opencode-auto-agent 1.0.0 → 1.2.0

package/src/lib/ui.js

@@ -0,0 +1,446 @@
+/**
+ * Terminal UI utilities — zero-dep, inspired by OpenCode's TUI aesthetic.
+ *
+ * Provides box-drawing, ANSI colors, spinners, and interactive prompts
+ * that work on Node 18+ with raw stdin.
+ */
+
+import { createInterface } from "node:readline";
+import { stdin, stdout } from "node:process";
+
+// ── ANSI color helpers ─────────────────────────────────────────────────────
+
+const ESC = "\x1b[";
+
+export const c = {
+  reset:    (s) => `${ESC}0m${s}${ESC}0m`,
+  bold:     (s) => `${ESC}1m${s}${ESC}0m`,
+  dim:      (s) => `${ESC}2m${s}${ESC}0m`,
+  italic:   (s) => `${ESC}3m${s}${ESC}0m`,
+  underline:(s) => `${ESC}4m${s}${ESC}0m`,
+
+  // Theme colors (OpenCode-inspired)
+  cyan:     (s) => `${ESC}36m${s}${ESC}0m`,
+  green:    (s) => `${ESC}32m${s}${ESC}0m`,
+  yellow:   (s) => `${ESC}33m${s}${ESC}0m`,
+  red:      (s) => `${ESC}31m${s}${ESC}0m`,
+  magenta:  (s) => `${ESC}35m${s}${ESC}0m`,
+  blue:     (s) => `${ESC}34m${s}${ESC}0m`,
+  white:    (s) => `${ESC}37m${s}${ESC}0m`,
+  gray:     (s) => `${ESC}90m${s}${ESC}0m`,
+
+  // Bright variants
+  brightCyan:    (s) => `${ESC}96m${s}${ESC}0m`,
+  brightGreen:   (s) => `${ESC}92m${s}${ESC}0m`,
+  brightYellow:  (s) => `${ESC}93m${s}${ESC}0m`,
+  brightRed:     (s) => `${ESC}91m${s}${ESC}0m`,
+  brightMagenta: (s) => `${ESC}95m${s}${ESC}0m`,
+
+  // Background
+  bgCyan:    (s) => `${ESC}46m${ESC}30m${s}${ESC}0m`,
+  bgGreen:   (s) => `${ESC}42m${ESC}30m${s}${ESC}0m`,
+  bgYellow:  (s) => `${ESC}43m${ESC}30m${s}${ESC}0m`,
+  bgRed:     (s) => `${ESC}41m${ESC}37m${s}${ESC}0m`,
+  bgBlue:    (s) => `${ESC}44m${ESC}37m${s}${ESC}0m`,
+  bgMagenta: (s) => `${ESC}45m${ESC}37m${s}${ESC}0m`,
+};
+
+// ── Box-drawing characters ─────────────────────────────────────────────────
+
+const BOX = {
+  tl: "\u256d", tr: "\u256e", bl: "\u2570", br: "\u256f",
+  h: "\u2500", v: "\u2502",
+  cross: "\u253c",
+  tee_r: "\u251c", tee_l: "\u2524",
+};
+
+// ── Layout helpers ─────────────────────────────────────────────────────────
+
+/**
+ * Get terminal width, fallback to 80.
+ */
+function termWidth() {
+  return stdout.columns || 80;
+}
+
+/**
+ * Draw a horizontal rule.
+ */
+export function hr(char = BOX.h, width) {
+  const w = width || termWidth();
+  console.log(c.gray(char.repeat(w)));
+}
+
+/**
+ * Print a styled header banner (OpenCode-style).
+ */
+export function banner(title, subtitle) {
+  const w = Math.min(termWidth(), 72);
+  const pad = (s, len) => {
+    const stripped = stripAnsi(s);
+    return s + " ".repeat(Math.max(0, len - stripped.length));
+  };
+
+  console.log();
+  console.log(c.cyan(`  ${BOX.tl}${BOX.h.repeat(w - 4)}${BOX.tr}`));
+  console.log(c.cyan(`  ${BOX.v}`) + " " + c.bold(c.brightCyan(pad(title, w - 6))) + c.cyan(BOX.v));
+  if (subtitle) {
+    console.log(c.cyan(`  ${BOX.v}`) + " " + c.gray(pad(subtitle, w - 6)) + c.cyan(BOX.v));
+  }
+  console.log(c.cyan(`  ${BOX.bl}${BOX.h.repeat(w - 4)}${BOX.br}`));
+  console.log();
+}
+
+/**
+ * Print a section header.
+ */
+export function section(title) {
+  console.log();
+  console.log(`  ${c.bold(c.cyan(title))}`);
+  console.log(`  ${c.gray(BOX.h.repeat(stripAnsi(title).length + 2))}`);
+}
+
+/**
+ * Print a status line with icon.
+ */
+export function status(icon, label, detail) {
+  const icons = {
+    pass:  c.green("\u2713"),
+    fail:  c.red("\u2717"),
+    warn:  c.yellow("\u26A0"),
+    info:  c.cyan("\u2139"),
+    arrow: c.cyan("\u25B6"),
+    dot:   c.gray("\u2022"),
+    star:  c.yellow("\u2605"),
+  };
+  const i = icons[icon] || icon;
+  const d = detail ? c.gray(` ${detail}`) : "";
+  console.log(`  ${i} ${label}${d}`);
+}
+
+/**
+ * Print a key-value pair.
+ */
+export function kv(key, value) {
+  console.log(`  ${c.gray(key + ":")} ${c.white(String(value))}`);
+}
+
+/**
+ * Print an error block.
+ */
+export function error(message, hint) {
+  console.log();
+  console.log(`  ${c.bgRed(" ERROR ")} ${c.red(message)}`);
+  if (hint) {
+    console.log(`          ${c.gray(hint)}`);
+  }
+  console.log();
+}
+
+/**
+ * Print a warning block.
+ */
+export function warn(message, hint) {
+  console.log(`  ${c.bgYellow(" WARN ")} ${c.yellow(message)}`);
+  if (hint) {
+    console.log(`         ${c.gray(hint)}`);
+  }
+}
+
+/**
+ * Print a success block.
+ */
+export function success(message) {
+  console.log();
+  console.log(`  ${c.bgGreen(" OK ")} ${c.green(message)}`);
+  console.log();
+}
+
+/**
+ * Print a boxed list of items.
+ */
+export function boxList(title, items) {
+  const w = Math.min(termWidth(), 68);
+  console.log();
+  console.log(c.gray(`  ${BOX.tl}${BOX.h} ${c.bold(c.white(title))} ${c.gray(BOX.h.repeat(Math.max(0, w - stripAnsi(title).length - 6)))}${c.gray(BOX.tr)}`));
+  for (const item of items) {
+    const line = `  ${c.gray(BOX.v)} ${item}`;
+    console.log(line + " ".repeat(Math.max(0, w - stripAnsi(line).length + 2)) + c.gray(BOX.v));
+  }
+  console.log(c.gray(`  ${BOX.bl}${BOX.h.repeat(w - 2)}${BOX.br}`));
+}
+
+// ── Spinner ────────────────────────────────────────────────────────────────
+
+const SPINNER_FRAMES = ["\u280B", "\u2819", "\u2839", "\u2838", "\u283C", "\u2834", "\u2826", "\u2827", "\u2807", "\u280F"];
+
+export function createSpinner(text) {
+  let i = 0;
+  let interval = null;
+
+  return {
+    start() {
+      interval = setInterval(() => {
+        const frame = c.cyan(SPINNER_FRAMES[i % SPINNER_FRAMES.length]);
+        stdout.write(`\r  ${frame} ${text}`);
+        i++;
+      }, 80);
+    },
+    stop(finalText) {
+      if (interval) clearInterval(interval);
+      stdout.write(`\r  ${c.green("\u2713")} ${finalText || text}\n`);
+    },
+    fail(finalText) {
+      if (interval) clearInterval(interval);
+      stdout.write(`\r  ${c.red("\u2717")} ${finalText || text}\n`);
+    },
+  };
+}
+
+// ── Interactive prompts (zero-dep) ─────────────────────────────────────────
+
+/**
+ * Ask a yes/no confirmation.
+ */
+export async function confirm(question, defaultYes = true) {
+  const rl = createInterface({ input: stdin, output: stdout });
+  const hint = defaultYes ? "Y/n" : "y/N";
+  return new Promise((resolve) => {
+    rl.question(`  ${c.cyan("?")} ${question} ${c.gray(`(${hint})`)} `, (answer) => {
+      rl.close();
+      const a = answer.trim().toLowerCase();
+      if (a === "") resolve(defaultYes);
+      else resolve(a === "y" || a === "yes");
+    });
+  });
+}
+
+/**
+ * Ask for text input.
+ */
+export async function input(question, defaultValue = "") {
+  const rl = createInterface({ input: stdin, output: stdout });
+  const hint = defaultValue ? c.gray(` (${defaultValue})`) : "";
+  return new Promise((resolve) => {
+    rl.question(`  ${c.cyan("?")} ${question}${hint} `, (answer) => {
+      rl.close();
+      resolve(answer.trim() || defaultValue);
+    });
+  });
+}
+
+/**
+ * Interactive single-select menu with arrow-key navigation.
+ * Returns the selected item object.
+ *
+ * @param {string} title - Prompt title
+ * @param {Array<{label: string, value: any, hint?: string}>} items
+ * @returns {Promise<{label: string, value: any}>}
+ */
+export async function select(title, items) {
+  if (!items.length) throw new Error("select: no items provided");
+
+  return new Promise((resolve) => {
+    let cursor = 0;
+
+    const render = () => {
+      // Move cursor up to overwrite previous render
+      if (cursor !== -1) {
+        stdout.write(`\x1b[${items.length + 1}A`);
+      }
+
+      stdout.write(`  ${c.cyan("?")} ${c.bold(title)}\n`);
+      for (let i = 0; i < items.length; i++) {
+        const item = items[i];
+        const selected = i === cursor;
+        const pointer = selected ? c.cyan("\u25B6") : " ";
+        const label = selected ? c.cyan(item.label) : c.white(item.label);
+        const hint = item.hint ? c.gray(` ${item.hint}`) : "";
+        stdout.write(`  ${pointer} ${label}${hint}\n`);
+      }
+    };
+
+    // Initial render
+    stdout.write(`  ${c.cyan("?")} ${c.bold(title)}\n`);
+    for (let i = 0; i < items.length; i++) {
+      const item = items[i];
+      const selected = i === cursor;
+      const pointer = selected ? c.cyan("\u25B6") : " ";
+      const label = selected ? c.cyan(item.label) : c.white(item.label);
+      const hint = item.hint ? c.gray(` ${item.hint}`) : "";
+      stdout.write(`  ${pointer} ${label}${hint}\n`);
+    }
+
+    stdin.setRawMode(true);
+    stdin.resume();
+    stdin.setEncoding("utf8");
+
+    const onData = (key) => {
+      // Ctrl+C
+      if (key === "\x03") {
+        stdin.setRawMode(false);
+        stdin.removeListener("data", onData);
+        stdin.pause();
+        process.exit(130);
+      }
+      // Enter
+      if (key === "\r" || key === "\n") {
+        stdin.setRawMode(false);
+        stdin.removeListener("data", onData);
+        stdin.pause();
+        // Clear and reprint final selection
+        stdout.write(`\x1b[${items.length + 1}A`);
+        stdout.write(`  ${c.green("\u2713")} ${c.bold(title)} ${c.cyan(items[cursor].label)}\n`);
+        for (let i = 0; i < items.length; i++) {
+          stdout.write(`\x1b[2K\n`); // clear each line
+        }
+        stdout.write(`\x1b[${items.length}A`); // move back up
+        resolve(items[cursor]);
+        return;
+      }
+      // Arrow up / k
+      if (key === "\x1b[A" || key === "k") {
+        cursor = (cursor - 1 + items.length) % items.length;
+        render();
+      }
+      // Arrow down / j
+      if (key === "\x1b[B" || key === "j") {
+        cursor = (cursor + 1) % items.length;
+        render();
+      }
+    };
+
+    stdin.on("data", onData);
+  });
+}
+
+/**
+ * Interactive multi-select menu with space to toggle and arrow keys to navigate.
+ * Returns array of selected item objects.
+ *
+ * @param {string} title - Prompt title
+ * @param {Array<{label: string, value: any, hint?: string, selected?: boolean}>} items
+ * @returns {Promise<Array<{label: string, value: any}>>}
+ */
+export async function multiSelect(title, items) {
+  if (!items.length) throw new Error("multiSelect: no items provided");
+
+  return new Promise((resolve) => {
+    let cursor = 0;
+    const selected = new Set(
+      items.filter((it) => it.selected).map((_, i) => i)
+    );
+
+    const render = () => {
+      stdout.write(`\x1b[${items.length + 2}A`);
+      stdout.write(`  ${c.cyan("?")} ${c.bold(title)} ${c.gray("(space to toggle, enter to confirm)")}\n`);
+      for (let i = 0; i < items.length; i++) {
+        const item = items[i];
+        const isCursor = i === cursor;
+        const isSelected = selected.has(i);
+        const pointer = isCursor ? c.cyan("\u25B6") : " ";
+        const check = isSelected ? c.green("\u25C9") : c.gray("\u25CB");
+        const label = isCursor ? c.cyan(item.label) : c.white(item.label);
+        const hint = item.hint ? c.gray(` ${item.hint}`) : "";
+        stdout.write(`\x1b[2K  ${pointer} ${check} ${label}${hint}\n`);
+      }
+      stdout.write("\x1b[2K\n");
+    };
+
+    // Initial render
+    stdout.write(`  ${c.cyan("?")} ${c.bold(title)} ${c.gray("(space to toggle, enter to confirm)")}\n`);
+    for (let i = 0; i < items.length; i++) {
+      const item = items[i];
+      const isCursor = i === cursor;
+      const isSelected = selected.has(i);
+      const pointer = isCursor ? c.cyan("\u25B6") : " ";
+      const check = isSelected ? c.green("\u25C9") : c.gray("\u25CB");
+      const label = isCursor ? c.cyan(item.label) : c.white(item.label);
+      const hint = item.hint ? c.gray(` ${item.hint}`) : "";
+      stdout.write(`  ${pointer} ${check} ${label}${hint}\n`);
+    }
+    stdout.write("\n");
+
+    stdin.setRawMode(true);
+    stdin.resume();
+    stdin.setEncoding("utf8");
+
+    const onData = (key) => {
+      if (key === "\x03") {
+        stdin.setRawMode(false);
+        stdin.removeListener("data", onData);
+        stdin.pause();
+        process.exit(130);
+      }
+      if (key === "\r" || key === "\n") {
+        stdin.setRawMode(false);
+        stdin.removeListener("data", onData);
+        stdin.pause();
+        const result = [...selected].map((i) => items[i]);
+        // Clear and show final
+        stdout.write(`\x1b[${items.length + 2}A`);
+        stdout.write(`\x1b[2K  ${c.green("\u2713")} ${c.bold(title)} ${c.cyan(result.map((r) => r.label).join(", "))}\n`);
+        for (let i = 0; i < items.length + 1; i++) {
+          stdout.write(`\x1b[2K\n`);
+        }
+        stdout.write(`\x1b[${items.length + 1}A`);
+        resolve(result);
+        return;
+      }
+      if (key === " ") {
+        if (selected.has(cursor)) selected.delete(cursor);
+        else selected.add(cursor);
+        render();
+      }
+      if (key === "\x1b[A" || key === "k") {
+        cursor = (cursor - 1 + items.length) % items.length;
+        render();
+      }
+      if (key === "\x1b[B" || key === "j") {
+        cursor = (cursor + 1) % items.length;
+        render();
+      }
+    };
+
+    stdin.on("data", onData);
+  });
+}
+
+/**
+ * Display a table with columns.
+ * @param {string[]} headers
+ * @param {string[][]} rows
+ */
+export function table(headers, rows) {
+  const colWidths = headers.map((h, i) => {
+    const maxData = rows.reduce((max, row) => Math.max(max, stripAnsi(String(row[i] || "")).length), 0);
+    return Math.max(stripAnsi(h).length, maxData) + 2;
+  });
+
+  const headerLine = headers.map((h, i) => c.bold(h.padEnd(colWidths[i]))).join(c.gray(" \u2502 "));
+  console.log(`  ${headerLine}`);
+  console.log(`  ${colWidths.map((w) => c.gray(BOX.h.repeat(w))).join(c.gray("\u2500\u253c\u2500"))}`);
+
+  for (const row of rows) {
+    const line = row.map((cell, i) => String(cell || "").padEnd(colWidths[i])).join(c.gray(" \u2502 "));
+    console.log(`  ${line}`);
+  }
+}
+
+// ── Utilities ──────────────────────────────────────────────────────────────
+
+/**
+ * Strip ANSI escape codes from a string.
+ */
+export function stripAnsi(str) {
+  // eslint-disable-next-line no-control-regex
+  return str.replace(/\x1b\[[0-9;]*m/g, "");
+}
+
+/**
+ * Truncate a string to maxLen, adding ellipsis if needed.
+ */
+export function truncate(str, maxLen = 40) {
+  if (str.length <= maxLen) return str;
+  return str.slice(0, maxLen - 1) + "\u2026";
+}

package/templates/agents/developer.md

@@ -21,7 +21,7 @@ You are the **Developer** — you implement code changes according to the plan p
 
 ## Context Loading Rule
 Before writing code, ALWAYS:
-1. Read `.ai-starter-kit/context/runtime-context.md` for active preset and rules.
+1. Read `.opencode/context/runtime-context.md` for active preset and rules.
 2. Read the plan provided by the orchestrator or planner.
 3. Read existing files you will modify to understand current patterns.
 4. Check the preset file for framework-specific conventions (naming, structure, patterns).

package/templates/agents/docs.md

@@ -20,7 +20,7 @@ You are the **Docs Agent** — you maintain project documentation so it stays ac
 
 ## Context Loading Rule
 Before writing docs, ALWAYS:
-1. Read `.ai-starter-kit/context/runtime-context.md` for docs path and conventions.
+1. Read `.opencode/context/runtime-context.md` for docs path and conventions.
 2. Read the plan and implementation summary to understand what changed.
 3. Read existing documentation to avoid duplication.
 4. Check the preset file for framework-specific documentation conventions.

package/templates/agents/orchestrator.md

@@ -14,7 +14,7 @@ permission:
 You are the **Orchestrator** — the single entry point for all work in this project. You coordinate a team of specialist agents and ensure every task follows the defined workflow.
 
 ## Responsibilities
-1. **Load context** — On every invocation, read `.ai-starter-kit/context/runtime-context.md` first. This contains the active preset, rules, and project documentation summary.
+1. **Load context** — On every invocation, read `.opencode/context/runtime-context.md` first. This contains the active preset, rules, and project documentation summary.
 2. **Read tasks** — Identify the current task from the PRD or task list being processed by Ralphy.
 3. **Route to specialists** — Delegate work to the correct sub-agent:
    - `@planner` for breaking objectives into steps
@@ -42,9 +42,9 @@ For each task:
 
 ## Context Loading Rule (CRITICAL)
 Before doing ANY work, you MUST:
-1. Read `.ai-starter-kit/context/runtime-context.md`
-2. Read `.ai-starter-kit/rules/universal.md`
-3. Read the active preset file from `.ai-starter-kit/presets/<preset>.md`
+1. Read `.opencode/context/runtime-context.md`
+2. Read `.opencode/rules/universal.md`
+3. Read the active preset file from `.opencode/presets/<preset>.md`
 4. If `docsPath` is configured, scan that directory for relevant documentation
 
 Only after loading context should you begin task routing.

package/templates/agents/planner.md

@@ -22,7 +22,7 @@ You are the **Planner** — an architect who turns high-level objectives into co
 
 ## Context Loading Rule
 Before planning, ALWAYS:
-1. Read `.ai-starter-kit/context/runtime-context.md` for active preset and rules.
+1. Read `.opencode/context/runtime-context.md` for active preset and rules.
 2. Read relevant source files to understand current state.
 3. Check the preset file for framework-specific conventions.
 

package/templates/agents/qa.md

@@ -23,7 +23,7 @@ You are the **QA Agent** — you verify that implementation meets requirements,
 
 ## Context Loading Rule
 Before testing, ALWAYS:
-1. Read `.ai-starter-kit/context/runtime-context.md` for test commands and conventions.
+1. Read `.opencode/context/runtime-context.md` for test commands and conventions.
 2. Read the plan and acceptance criteria for the current task.
 3. Check the preset file for framework-specific test expectations.
 

package/templates/agents/reviewer.md

@@ -22,7 +22,7 @@ You are the **Reviewer** — you perform code review on changes made by the Deve
 
 ## Context Loading Rule
 Before reviewing, ALWAYS:
-1. Read `.ai-starter-kit/context/runtime-context.md` for project conventions.
+1. Read `.opencode/context/runtime-context.md` for project conventions.
 2. Read the plan to understand intent behind changes.
 3. Read the preset file for framework-specific review criteria.
 

package/templates/sample-config.json

@@ -1,19 +1,58 @@
 {
-  "$schema": "https://github.com/ai-starter-kit/config-schema",
-  "version": "0.1.0",
+  "$schema": "https://github.com/opencode-auto-agent/config-schema",
+  "version": "0.2.0",
   "preset": "java",
   "docsPath": "./Docs",
   "tasksPath": "./PRD.md",
   "outputPath": "./",
   "engine": "opencode",
+  "models": {
+    "orchestrator": "google/gemini-3-pro",
+    "planner": "google/gemini-3-pro",
+    "developer": "openai/gpt-5.1-codex",
+    "qa": "anthropic/claude-sonnet-4-5",
+    "reviewer": "anthropic/claude-sonnet-4-5",
+    "docs": "anthropic/claude-sonnet-4-5"
+  },
   "agents": {
-    "orchestrator": { "enabled": true },
-    "planner": { "enabled": true },
-    "developer": { "enabled": true },
-    "qa": { "enabled": true },
-    "reviewer": { "enabled": true },
-    "docs": { "enabled": true }
+    "orchestrator": {
+      "enabled": true,
+      "model": "google/gemini-3-pro",
+      "mode": "primary"
+    },
+    "planner": {
+      "enabled": true,
+      "model": "google/gemini-3-pro",
+      "mode": "subagent"
+    },
+    "developer": {
+      "enabled": true,
+      "model": "openai/gpt-5.1-codex",
+      "mode": "subagent"
+    },
+    "qa": {
+      "enabled": true,
+      "model": "anthropic/claude-sonnet-4-5",
+      "mode": "subagent"
+    },
+    "reviewer": {
+      "enabled": true,
+      "model": "anthropic/claude-sonnet-4-5",
+      "mode": "subagent"
+    },
+    "docs": {
+      "enabled": true,
+      "model": "anthropic/claude-sonnet-4-5",
+      "mode": "subagent"
+    }
   },
+  "rules": [
+    ".opencode/rules/universal.md"
+  ],
+  "instructions": [
+    "AGENTS.md",
+    ".opencode/rules/universal.md"
+  ],
   "orchestrator": {
     "workflowSteps": ["plan", "implement", "test", "verify"],
     "requirePlanApproval": false