pantheon-opencode 1.6.0-beta.11 → 1.6.0-beta.13

package/scripts/install/interactive.mjs

@@ -1,420 +1,98 @@
 #!/usr/bin/env node
 
-import { emitKeypressEvents } from 'node:readline'
-import { colors } from './cli-ui.mjs'
+import * as clack from '@clack/prompts'
+import { PROMPT_CANCELED } from './prompt-result.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')
+export { PROMPT_CANCELED }
 
-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 isTerminal() {
+  return Boolean(process.stdin.isTTY && process.stdout.isTTY)
 }
 
-function teardownStdin() {
-  try {
-    process.stdin.setRawMode(false)
-    process.stdin.removeAllListeners('keypress')
-    process.stdin.pause()
-  } catch {
-    /* safe to ignore */
-  }
+function cancelPrompt(prompts, value) {
+  if (!prompts.isCancel(value)) return false
+  prompts.cancel('Installation canceled.')
+  return true
 }
 
-export async function promptMultiSelect(
-  options,
-  { title = '', selected = new Set(), pageSize = 6 } = {},
+/**
+ * Prompt for authorization to apply a reviewed installer plan.
+ *
+ * @param {string} planSummary Summary of the changes that require approval.
+ * @param {{ default?: boolean, prompts?: typeof clack, isTTY?: boolean }} [options]
+ * @returns {Promise<boolean | typeof PROMPT_CANCELED>} True if authorized, false if declined, or the cancellation sentinel.
+ */
+export async function promptReview(
+  planSummary,
+  { default: defaultValue = false, prompts = clack, isTTY = isTerminal() } = {},
 ) {
-  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)
-  })
+  if (!isTTY) return false
+  const result = await prompts.confirm({ message: planSummary, initialValue: defaultValue })
+  if (cancelPrompt(prompts, result)) return PROMPT_CANCELED
+  return result === true
 }
 
 /**
- * Apply-gate prompt. Unlike the pre-install confirm this defaults to NO, so a
- * bare Enter never authorizes a write. In a non-TTY it returns the default
- * (`false`) without blocking — callers that must not prompt at all should branch
- * on TTY before calling.
+ * Collect interactive setup choices before the installer begins any writes.
  *
- * @param {string} planSummary e.g. "Apply these 12 changes?"
- * @param {{ default?: boolean }} [opts]
- * @returns {Promise<boolean>}
+ * @param {{ components?: string[], defaultComponents?: string[], prompts?: typeof clack, isTTY?: boolean }} [options]
+ * @returns {Promise<{ components?: Set<string>, target?: string, confirmed?: boolean, canceled?: boolean }>}
  */
-export async function promptReview(planSummary, { default: def = false } = {}) {
-  return promptConfirm(planSummary, { default: def })
-}
-
-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')}`,
-      ),
-    )
+export async function runInteractiveInstall({
+  components = [],
+  defaultComponents = [],
+  prompts = clack,
+  isTTY = isTerminal(),
+} = {}) {
+  const defaults = defaultComponents.length > 0 ? defaultComponents : components
+  const defaultSet = new Set(defaults)
 
-    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()
-  })
-}
+  // Preserve the prior no-TTY fallback (defaults, global target, and no apply
+  // authorization) without asking a terminal prompt library to access stdin.
+  if (!isTTY) return { components: defaultSet, target: 'global', confirmed: true }
 
-export async function runInteractiveInstall({ components = [], defaultComponents = [] } = {}) {
-  const defaultSet = new Set(defaultComponents.length > 0 ? defaultComponents : components)
+  process.stdout.write('\n📦 OpenCode Installer\n\n')
 
   const componentOptions = [
-    {
-      name: 'agents',
-      value: 'agents',
-      description: `Agent configurations and routing (${14} agents)`,
-    },
-    {
-      name: 'skills',
-      value: 'skills',
-      description: `Reusable skill workflows (${20} 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',
-    },
+    { label: 'agents', value: 'agents', hint: 'Agent configurations and routing (14 agents)' },
+    { label: 'skills', value: 'skills', hint: `Reusable skill workflows (${20} skills)` },
+    { label: 'instructions', value: 'instructions', hint: 'AGENTS.md and instructional files' },
+    { label: 'prompts', value: 'prompts', hint: 'Prompt templates for agents' },
+    { label: 'commands', value: 'commands', hint: 'OpenCode command shortcuts' },
+    { label: 'plugins', value: 'plugins', hint: 'TUI sidebar plugin' },
+    { label: 'runtime', value: 'runtime', hint: '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,
+  const chosen = await prompts.multiselect({
+    message: 'Select components to install:',
+    options: componentOptions,
+    initialValues: [...defaultSet],
+    required: false,
   })
+  if (cancelPrompt(prompts, chosen)) return { canceled: true }
 
-  process.stdout.write('\n')
-
+  const selectedComponents = new Set(chosen)
   if (selectedComponents.size === 0) {
-    process.stdout.write(`${colors.yellow('No components selected — using defaults\n')}`)
-    defaultSet.forEach((v) => {
-      selectedComponents.add(v)
-    })
+    for (const value of defaults) selectedComponents.add(value)
   }
 
-  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:',
+  const target = await prompts.select({
+    message: 'Install location:',
+    options: [
+      {
+        label: 'Global directory',
+        value: 'global',
+        hint: '~/.config/opencode (shared across projects)',
+      },
+      { label: 'Current project', value: 'project', hint: './.opencode (scoped to this project)' },
+    ],
   })
+  if (cancelPrompt(prompts, target)) return { canceled: true }
 
-  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')
+  const confirmed = await prompts.confirm({
+    message: `Install ${selectedComponents.size} component(s) in ${target === 'global' ? 'global config' : 'current project'}?`,
+    initialValue: true,
+  })
+  if (cancelPrompt(prompts, confirmed)) return { canceled: true }
 
   return { components: selectedComponents, target, confirmed }
 }

package/scripts/install/migrate.mjs

@@ -11,7 +11,7 @@
 import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs'
 import { dirname, join } from 'node:path'
 import { fileURLToPath } from 'node:url'
-import { ACTIONS, recordChange, snapshot } from './plan.mjs'
+import { ACTIONS, fingerprintOutput, recordChange } from './plan.mjs'
 import { createInitialState, readState, writeState } from './state.mjs'
 
 const __dirname = dirname(fileURLToPath(import.meta.url))
@@ -48,7 +48,11 @@ export function detectVersion(target) {
  * @param {{ dryRun?: boolean, recorder?: (change: object) => void }} [options]
  * @returns {{ applied: number, messages: string[] }}
  */
-export function runMigrations(target, currentVersion, { dryRun = false, recorder = null } = {}) {
+export function runMigrations(
+  target,
+  currentVersion,
+  { dryRun = false, recorder = null, updatedAt = new Date().toISOString() } = {},
+) {
   const applied = []
   const semver = parseSemver(currentVersion)
 
@@ -107,49 +111,52 @@ export function runMigrations(target, currentVersion, { dryRun = false, recorder
   // ── Write updated state ───────────────────────────────────────────
   if (applied.length > 0) {
     const statePath = join(target, '.pantheon', 'install-state.json')
-    if (dryRun) {
-      // State-only bookkeeping write: recorded so the preview is complete, but
-      // unscored because the install summary does not count it. Classified as
-      // an update — a migration that applies implies a state file existed.
-      recordChange({ path: statePath, action: ACTIONS.UPDATE, bytes: 0, scored: false }, recorder)
-    } else {
-      const newVersion = formatSemver(semver)
-      let state = readState(target)
-      const stateExisted = state !== null
-      if (!state) state = createInitialState(newVersion)
-      state.pantheon_version = newVersion
-      for (const m of applied) {
-        state.applied_migrations.push({
-          from: m.from,
-          to: m.to,
-          applied_at: new Date().toISOString(),
-          status: 'completed',
-        })
-      }
-      if (!state.components) {
-        state.components = {
-          agents: { version: 1, status: 'installed' },
-          skills: { version: 1, status: 'installed' },
-          plugins: { version: 1, status: 'installed' },
-          runtime: { version: 1, status: 'installed' },
-        }
+    const newVersion = formatSemver(semver)
+    let state = readState(target)
+    const stateExisted = state !== null
+    if (!state) state = createInitialState(newVersion, updatedAt)
+    state.pantheon_version = newVersion
+    for (const m of applied) {
+      state.applied_migrations.push({
+        from: m.from,
+        to: m.to,
+        applied_at: updatedAt,
+        status: 'completed',
+      })
+    }
+    if (!state.components) {
+      state.components = {
+        agents: { version: 1, status: 'installed' },
+        skills: { version: 1, status: 'installed' },
+        plugins: { version: 1, status: 'installed' },
+        runtime: { version: 1, status: 'installed' },
       }
-      writeState(target, state)
-      recordChange(
-        {
-          path: statePath,
-          action: stateExisted ? ACTIONS.UPDATE : ACTIONS.CREATE,
-          bytes: snapshot(statePath).size,
-          scored: false,
-        },
-        recorder,
-      )
+    }
+    state.updated_at = updatedAt
+    state.schema_version = 2
+    const stateContent = `${JSON.stringify(state, null, 2)}\n`
+    if (!dryRun) writeState(target, state, { updatedAt })
+    recordChange(
+      {
+        path: statePath,
+        action: stateExisted ? ACTIONS.UPDATE : ACTIONS.CREATE,
+        bytes: Buffer.byteLength(stateContent, 'utf8'),
+        outputFingerprint: fingerprintOutput(stateContent),
+        scored: false,
+      },
+      recorder,
+    )
+    return {
+      applied: applied.length,
+      messages: applied.map((m) => `${m.from} → ${m.to}: ${m.description}`),
+      plannedState: state,
     }
   }
 
   return {
     applied: applied.length,
     messages: applied.map((m) => `${m.from} → ${m.to}: ${m.description}`),
+    plannedState: null,
   }
 }