pantheon-opencode 1.1.1-beta.4 → 1.1.1-beta.5

package/bin/pantheon-init.mjs

@@ -27,10 +27,13 @@ function printUsage() {
   console.log('  npx pantheon-opencode init              # Install globally');
   console.log('  npx pantheon-opencode init --project    # Install in project');
   console.log('  npx pantheon-opencode init --dry-run    # Preview only');
-  console.log('  npx pantheon-opencode init --no-mcp     # Skip MCP + venv');
-  console.log('  npx pantheon-opencode init --force      # Overwrite + recreate venv');
-  console.log('  npx pantheon-opencode init --doctor     # Run health check after install');
-  console.log('  npx pantheon-opencode --help            # Show this help');
+  console.log('  npx pantheon-opencode init --no-mcp       # Skip MCP + venv');
+  console.log('  npx pantheon-opencode init --force        # Overwrite + recreate venv');
+  console.log('  npx pantheon-opencode init --doctor       # Run health check after install');
+  console.log('  npx pantheon-opencode init --interactive  # Force interactive TUI mode');
+  console.log('  npx pantheon-opencode init --headless     # Force non-interactive mode');
+  console.log('  npx pantheon-opencode init -y             # Skip confirmations, use defaults');
+  console.log('  npx pantheon-opencode --help              # Show this help');
 }
 
 async function main() {
@@ -45,6 +48,9 @@ async function main() {
     const skipMCP = args.includes('--no-mcp');
     const forceReinstall = args.includes('--force');
     const runDoctor = args.includes('--doctor');
+    const forceInteractive = args.includes('--interactive');
+    const forceHeadless = args.includes('--headless');
+    const autoYes = args.includes('--yes') || args.includes('-y');
 
     const components = ['agents', 'skills', 'instructions', 'commands', 'plugins'];
     if (!skipMCP) components.push('runtime');
@@ -56,13 +62,20 @@ async function main() {
       version = JSON.parse(fs.readFileSync(pkgPath, 'utf8')).version || '?';
     } catch { /* use default */ }
 
-    console.log(`Pantheon OpenCode v${version} — ${isDryRun ? 'DRY RUN' : 'Installing...'}`);
     console.log('');
+    if (!forceInteractive || isDryRun) {
+      console.log(`Pantheon OpenCode v${version} — ${isDryRun ? 'DRY RUN' : 'Installing...'}`);
+      console.log('');
+    }
 
     try {
       const { installOpenCode } = await import('../scripts/install/opencode.mjs');
       const target = isProject ? process.cwd() : undefined;
-      installOpenCode(target, isDryRun, forceReinstall, components);
+      await installOpenCode(target, isDryRun, forceReinstall, components, {
+        interactive: forceInteractive,
+        headless: forceHeadless,
+        yes: autoYes,
+      });
     } catch (err) {
       console.error(`❌ Installation failed: ${err.message}\n   Run with --no-mcp to skip Python dependencies:\n     npx pantheon-opencode init --no-mcp\n   Or retry with --force to recreate the venv:\n     npx pantheon-opencode init --force`);
       process.exit(1);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pantheon-opencode",
-  "version": "1.1.1-beta.4",
+  "version": "1.1.1-beta.5",
   "description": "Multi-agent orchestration for OpenCode — 14 specialized agents, TDD, Themis review gates.",
   "publishConfig": {
     "access": "public",

package/scripts/install/interactive.mjs

@@ -0,0 +1,395 @@
+#!/usr/bin/env node
+
+import { emitKeypressEvents } from 'node:readline'
+import { colors, icons } from './cli-ui.mjs'
+
+const cursorHide = () => process.stdout.write('\x1b[?25l')
+const cursorShow = () => process.stdout.write('\x1b[?25h')
+const cursorUp = (n) => process.stdout.write(`\x1b[${n}A`)
+const clearDown = () => process.stdout.write('\x1b[J')
+
+function setupStdin() {
+  if (!process.stdin.isTTY) return false
+  if (!process.stdout.isTTY) return false
+  emitKeypressEvents(process.stdin)
+  try {
+    process.stdin.setRawMode(true)
+  } catch {
+    return false
+  }
+  process.stdin.resume()
+  return true
+}
+
+function teardownStdin() {
+  try {
+    process.stdin.setRawMode(false)
+    process.stdin.removeAllListeners('keypress')
+    process.stdin.pause()
+  } catch {
+    /* safe to ignore */
+  }
+}
+
+export async function promptMultiSelect(options, { title = '', selected = new Set(), pageSize = 6 } = {}) {
+  if (options.length === 0) return new Set()
+
+  const preSelected = selected instanceof Set ? selected : new Set(selected)
+  const items = options.map((o) => ({
+    name: o.name,
+    value: o.value,
+    description: o.description || '',
+    checked: o.checked || preSelected.has(o.value),
+  }))
+
+  let cursor = 0
+  let scroll = 0
+  const maxVisible = Math.min(pageSize, options.length)
+  let previousLineCount = 0
+
+  const isTTY = setupStdin()
+  if (!isTTY) {
+    return new Set(items.filter((i) => i.checked).map((i) => i.value))
+  }
+  cursorHide()
+
+  function render() {
+    if (cursor < scroll) scroll = cursor
+    if (cursor >= scroll + maxVisible) scroll = cursor - maxVisible + 1
+
+    const visible = items.slice(scroll, scroll + maxVisible)
+    const lines = []
+
+    if (title) lines.push(colors.bold(title))
+
+    const hasMoreAbove = scroll > 0
+    const hasMoreBelow = scroll + maxVisible < options.length
+
+    if (hasMoreAbove) lines.push(colors.dim('  ...'))
+
+    for (let i = 0; i < visible.length; i++) {
+      const item = visible[i]
+      const idx = scroll + i
+      const active = idx === cursor
+      const box = item.checked ? '[x]' : '[ ]'
+      const ptr = active ? `${colors.cyan('>')} ` : '  '
+      const name = active ? colors.cyan(item.name) : item.name
+      const desc = item.description ? colors.dim(` — ${item.description}`) : ''
+      lines.push(`${ptr}${colors.bold(box)} ${name}${desc}`)
+    }
+
+    if (hasMoreBelow) lines.push(colors.dim('  ...'))
+
+    const count = items.filter((i) => i.checked).length
+    const total = items.length
+    const noun = count === 1 ? 'selected' : 'selected'
+    lines.push(colors.dim(`(${count}/${total} ${noun}) — ${colors.cyan('↑')}${colors.dim('/')}${colors.cyan('↓')} navigate · ${colors.cyan('Space')}${colors.dim(' toggle · ')}${colors.cyan('Enter')}${colors.dim(' confirm')}`))
+
+    const lineCount = lines.length
+    if (previousLineCount > 0) cursorUp(previousLineCount)
+    clearDown()
+    process.stdout.write(lines.join('\n') + '\n')
+    previousLineCount = lineCount
+  }
+
+  return new Promise((resolve, reject) => {
+    let settled = false
+
+    function finalize(result) {
+      if (settled) return
+      settled = true
+      cursorShow()
+      teardownStdin()
+      if (previousLineCount > 0) cursorUp(previousLineCount)
+      clearDown()
+      resolve(result)
+    }
+
+    function cancel() {
+      if (settled) return
+      settled = true
+      cursorShow()
+      teardownStdin()
+      if (previousLineCount > 0) cursorUp(previousLineCount)
+      clearDown()
+      reject(new Error('Canceled'))
+    }
+
+    function handler(str, key) {
+      if (!key) return
+      if ((key.ctrl && key.name === 'c') || key.name === 'escape') {
+        cancel()
+        return
+      }
+      if (key.name === 'return' || key.name === 'enter') {
+        const result = new Set(items.filter((i) => i.checked).map((i) => i.value))
+        finalize(result)
+        return
+      }
+      if (key.name === 'up') {
+        cursor = (cursor - 1 + items.length) % items.length
+        render()
+        return
+      }
+      if (key.name === 'down') {
+        cursor = (cursor + 1) % items.length
+        render()
+        return
+      }
+      if (key.name === 'space') {
+        items[cursor].checked = !items[cursor].checked
+        render()
+        return
+      }
+    }
+
+    process.stdin.on('keypress', handler)
+    render()
+  })
+}
+
+export async function promptConfirm(message, { default: def = true } = {}) {
+  const label = def ? 'Y/n' : 'y/N'
+  const isTTY = setupStdin()
+  if (!isTTY) return def
+
+  cursorHide()
+  process.stdout.write(`${colors.bold('?')} ${message} ${colors.cyan(label)} `)
+
+  return new Promise((resolve, reject) => {
+    let settled = false
+
+    function finalize(result) {
+      if (settled) return
+      settled = true
+      cursorShow()
+      teardownStdin()
+      process.stdout.write(`${result ? 'Yes' : 'No'}\n`)
+      resolve(result)
+    }
+
+    function cancel() {
+      if (settled) return
+      settled = true
+      cursorShow()
+      teardownStdin()
+      process.stdout.write('\n')
+      reject(new Error('Canceled'))
+    }
+
+    function handler(str, key) {
+      if (!key) return
+      if ((key.ctrl && key.name === 'c') || key.name === 'escape') {
+        cancel()
+        return
+      }
+      if (key.name === 'return' || key.name === 'enter') {
+        finalize(def)
+        return
+      }
+      if (str) {
+        const ch = str.toLowerCase()
+        if (ch === 'y' || ch === 'yes') {
+          finalize(true)
+        } else if (ch === 'n' || ch === 'no') {
+          finalize(false)
+        }
+      }
+    }
+
+    process.stdin.on('keypress', handler)
+  })
+}
+
+export async function promptList(options, { title = '' } = {}) {
+  if (options.length === 0) throw new Error('No options provided')
+  if (options.length === 1) return options[0].value
+
+  const items = options.map((o) => ({
+    name: o.name,
+    value: o.value,
+    description: o.description || '',
+  }))
+
+  let cursor = 0
+  const pageSize = Math.min(8, options.length)
+  let scroll = 0
+  const maxVisible = Math.min(pageSize, options.length)
+  let previousLineCount = 0
+
+  const isTTY = setupStdin()
+  if (!isTTY) return items[0].value
+  cursorHide()
+
+  function render() {
+    if (cursor < scroll) scroll = cursor
+    if (cursor >= scroll + maxVisible) scroll = cursor - maxVisible + 1
+
+    const visible = items.slice(scroll, scroll + maxVisible)
+    const lines = []
+
+    if (title) lines.push(colors.bold(title))
+
+    const hasMoreAbove = scroll > 0
+    const hasMoreBelow = scroll + maxVisible < options.length
+
+    if (hasMoreAbove) lines.push(colors.dim('  ...'))
+
+    for (let i = 0; i < visible.length; i++) {
+      const item = visible[i]
+      const idx = scroll + i
+      const active = idx === cursor
+      const ptr = active ? `${colors.cyan('>')} ` : '  '
+      const name = active ? colors.cyan(item.name) : item.name
+      const desc = item.description ? colors.dim(` — ${item.description}`) : ''
+      lines.push(`${ptr}${colors.bold('◉')} ${name}${desc}`)
+    }
+
+    if (hasMoreBelow) lines.push(colors.dim('  ...'))
+
+    lines.push(colors.dim(`(${colors.cyan('↑')}${colors.dim('/')}${colors.cyan('↓')} navigate · ${colors.cyan('Enter')}${colors.dim(' select')}`))
+
+    const lineCount = lines.length
+    if (previousLineCount > 0) cursorUp(previousLineCount)
+    clearDown()
+    process.stdout.write(lines.join('\n') + '\n')
+    previousLineCount = lineCount
+  }
+
+  return new Promise((resolve, reject) => {
+    let settled = false
+
+    function finalize(result) {
+      if (settled) return
+      settled = true
+      cursorShow()
+      teardownStdin()
+      if (previousLineCount > 0) cursorUp(previousLineCount)
+      clearDown()
+      resolve(result)
+    }
+
+    function cancel() {
+      if (settled) return
+      settled = true
+      cursorShow()
+      teardownStdin()
+      if (previousLineCount > 0) cursorUp(previousLineCount)
+      clearDown()
+      reject(new Error('Canceled'))
+    }
+
+    function handler(str, key) {
+      if (!key) return
+      if ((key.ctrl && key.name === 'c') || key.name === 'escape') {
+        cancel()
+        return
+      }
+      if (key.name === 'return' || key.name === 'enter') {
+        finalize(items[cursor].value)
+        return
+      }
+      if (key.name === 'up') {
+        cursor = (cursor - 1 + items.length) % items.length
+        render()
+        return
+      }
+      if (key.name === 'down') {
+        cursor = (cursor + 1) % items.length
+        render()
+        return
+      }
+    }
+
+    process.stdin.on('keypress', handler)
+    render()
+  })
+}
+
+export async function runInteractiveInstall({ components = [], defaultComponents = [] } = {}) {
+  const defaultSet = new Set(
+    defaultComponents.length > 0 ? defaultComponents : components,
+  )
+
+  const componentOptions = [
+    {
+      name: 'agents',
+      value: 'agents',
+      description: `Agent configurations and routing (${14} agents)`,
+    },
+    {
+      name: 'skills',
+      value: 'skills',
+      description: `Reusable skill workflows (${21} skills)`,
+    },
+    {
+      name: 'instructions',
+      value: 'instructions',
+      description: 'AGENTS.md and instructional files',
+    },
+    {
+      name: 'prompts',
+      value: 'prompts',
+      description: 'Prompt templates for agents',
+    },
+    {
+      name: 'commands',
+      value: 'commands',
+      description: 'OpenCode command shortcuts',
+    },
+    {
+      name: 'plugins',
+      value: 'plugins',
+      description: 'TUI sidebar plugin',
+    },
+    {
+      name: 'runtime',
+      value: 'runtime',
+      description: 'Python venv + MCP server scripts',
+    },
+  ]
+
+  process.stdout.write('\n')
+  process.stdout.write(`${colors.bold(colors.cyan('📦 OpenCode Installer'))}\n\n`)
+
+  const selectedComponents = await promptMultiSelect(componentOptions, {
+    title: 'Select components to install:',
+    selected: defaultSet,
+    pageSize: 7,
+  })
+
+  process.stdout.write('\n')
+
+  if (selectedComponents.size === 0) {
+    process.stdout.write(`${colors.yellow('No components selected — using defaults\n')}`)
+    defaultSet.forEach((v) => selectedComponents.add(v))
+  }
+
+  const targetOptions = [
+    {
+      name: 'Global directory',
+      value: 'global',
+      description: '~/.config/opencode (shared across projects)',
+    },
+    {
+      name: 'Current project',
+      value: 'project',
+      description: './.opencode (scoped to this project)',
+    },
+  ]
+
+  const target = await promptList(targetOptions, {
+    title: 'Install location:',
+  })
+
+  process.stdout.write('\n')
+
+  const confirmed = await promptConfirm(
+    `Install ${selectedComponents.size} component(s) in ${target === 'global' ? 'global config' : 'current project'}?`,
+    { default: true },
+  )
+
+  process.stdout.write('\n')
+
+  return { components: selectedComponents, target, confirmed }
+}

package/scripts/install/opencode.mjs

@@ -8,7 +8,7 @@ import { homedir } from 'node:os'
 import { join, resolve } from 'node:path'
 import { healthCheck } from './health-check.mjs'
 import { detectVersion, runMigrations } from './migrate.mjs'
-import { configure, section, step, success, warning, error, info, bullet, spinner, printSummary } from './cli-ui.mjs'
+import { colors, configure, section, step, success, warning, error, info, bullet, spinner, printSummary } from './cli-ui.mjs'
 import {
   collectSkillNames,
   copyFiles,
@@ -24,6 +24,8 @@ import { setupVenv } from './venv.mjs'
 import { installPlugin, registerPlugin, unregisterPlugin } from './plugin.mjs'
 import { resolveComponents } from './component.mjs'
 
+const COMPONENT_NAMES = ['agents', 'skills', 'instructions', 'prompts', 'commands', 'plugins', 'runtime']
+
 function deepClone(value) {
   return JSON.parse(JSON.stringify(value))
 }
@@ -72,11 +74,12 @@ function isGlobalConfigDir(target) {
   return resolve(target) === xdgDir
 }
 
-export function installOpenCode(
+export async function installOpenCode(
   target,
   dryRun = false,
   clean = false,
   components = ['agents', 'skills', 'instructions', 'commands', 'plugins', 'runtime'],
+  opts = {},
 ) {
   // Default target if not provided (global ~/.config/opencode)
   if (!target) {
@@ -86,6 +89,35 @@ export function installOpenCode(
   const componentSet = new Set(components)
   const stats = summary.opencode
 
+  // Interactive mode handling
+  const stdinTTY = process.stdin.isTTY && process.stdout.isTTY
+  const forceInteractive = opts.interactive === true
+  const forceHeadless = opts.headless === true
+  const autoYes = opts.yes === true
+  const interactive = forceInteractive || (stdinTTY && !forceHeadless)
+
+  if (interactive && !dryRun) {
+    const { runInteractiveInstall } = await import('./interactive.mjs')
+    const result = await runInteractiveInstall({
+      components,
+      defaultComponents: COMPONENT_NAMES,
+    })
+
+    if (!result.confirmed && !autoYes) {
+      info('Installation canceled.')
+      return stats
+    }
+
+    // Map target selection to actual path
+    const newComponents = [...result.components]
+    componentSet.clear()
+    for (const c of newComponents) componentSet.add(c)
+
+    if (result.target === 'project') {
+      target = process.cwd()
+    }
+  }
+
   // Determine layout based on install scope.
   // Global config dir (~/.opencode or ~/.config/opencode) uses a flat layout:
   //   agents/   skills/   commands/   plugins/
@@ -679,5 +711,25 @@ export function installOpenCode(
     }
   }
 
-  printSummary(target, ['opencode'], stats)
+  if (interactive && !dryRun) {
+    const created = stats.created
+    const skipped = stats.skipped
+    const errors = stats.errors
+
+    process.stdout.write('\n')
+    process.stdout.write(`  ${colors.bold(colors.green('Installation complete'))}\n`)
+    process.stdout.write(`  ${colors.dim('\u2500'.repeat(Math.min(process.stdout.columns || 60, 60)))}\n`)
+    process.stdout.write(`  ${colors.green('\u2713')} ${created} component(s) installed\n`)
+    if (skipped > 0) process.stdout.write(`  ${colors.dim('\u2014')} ${skipped} already up-to-date\n`)
+    if (errors > 0) process.stdout.write(`  ${colors.yellow('\u26a0')} ${errors} error(s) encountered\n`)
+    process.stdout.write('\n')
+    process.stdout.write(`  ${colors.bold('Next steps:')}\n`)
+    process.stdout.write(`  ${colors.dim('\u2022')} Configure agents in opencode.json\n`)
+    process.stdout.write(`  ${colors.dim('\u2022')} Add MCP servers in mcp.json\n`)
+    process.stdout.write(`  ${colors.dim('\u2022')} Run 'opencode doctor' to verify\n`)
+    process.stdout.write(`  ${colors.dim('\u2022')} Run 'opencode' to start using Pantheon agents\n`)
+    process.stdout.write('\n')
+  } else {
+    printSummary(target, ['opencode'], stats)
+  }
 }