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

package/CHANGELOG.md

@@ -18,6 +18,23 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
 ## ✅ Closed Issues
 
+## [v1.6.0-beta.13] - 2026-10-17
+
+## 🆕 What's New
+
+- **Modernize interactive TTY setup** with `@clack/prompts` while keeping the
+  existing component, install-location, authorization, and worktree guidance
+  choices. Canceling the setup wizard leaves configuration unchanged; headless,
+  `--yes`, dry-run, and non-TTY behavior remain available.
+
+## 🐞 Fixed
+
+- **Let npm finish on an unsupported Node runtime:** postinstall now warns and
+  skips Node-dependent TUI/config sync, leaving the CLI to show its explicit
+  Node >=26.4.0 hard gate and user-managed upgrade instructions.
+- **Synchronize Beta 13 package and release metadata** across manifests and
+  lockfiles without changing the Node >=26.4.0 engine floor.
+
 ## [v1.6.0-beta.12] - 2026-10-17
 
 ## 🆕 What's New

package/README.md

@@ -43,6 +43,18 @@ asserted here. The optional `pantheon_cost` SQLite backend has its own capabilit
 threshold, `node:sqlite` on Node >= 22.5; that feature threshold does not lower
 Pantheon's package or CLI support floor.
 
+With npm's default configuration, an unsupported Node version may produce an
+`EBADENGINE` warning during install. Pantheon's postinstall then skips Node-based
+sync without changing OpenCode configuration, and the CLI itself exits with a
+clear error before setup. If needed, switch using a user-managed version
+manager—no system-wide install is required:
+
+```bash
+nvm install 26.4.0 && nvm use 26.4.0
+# or: fnm install 26.4.0 && fnm use 26.4.0
+# or: volta install node@26.4.0
+```
+
 From the project where you want to use Pantheon:
 
 ```bash
@@ -50,7 +62,10 @@ npx pantheon-opencode init
 opencode
 ```
 
-The installer guides you through the available setup. For optional MCP servers,
+In a TTY, the interactive setup uses Clack prompts to choose components and a
+global or project location before reviewing the apply. Canceling writes nothing.
+`--yes`, `--headless`, `--dry-run`, and non-TTY workflows retain their existing
+behavior. The installer guides you through the available setup. For optional MCP servers,
 project-local installation, or non-interactive setup, see the
 [installation guide](docs/INSTALLATION.md).
 

package/README.pt-BR.md

@@ -33,6 +33,8 @@ de planejar o trabalho, avançar, conferir resultados e preservar o contexto
 
 Requisitos: [OpenCode 1.18.4+](https://opencode.ai/docs/) e Node.js `>=26.4.0` para a CLI, o instalador e as ferramentas Node do Pantheon. Node 22, Node 24 e Node 26.0–26.3 não são compatíveis com esta versão.
 
+Com a configuração padrão do npm, versões incompatíveis podem gerar um aviso `EBADENGINE`; o postinstall pula a sincronização Node/config, e a CLI bloqueia a configuração antes de gravar arquivos. Para atualizar sem instalação de sistema, use um gerenciador de Node do usuário: `nvm install 26.4.0 && nvm use 26.4.0`, `fnm install 26.4.0 && fnm use 26.4.0` ou `volta install node@26.4.0`.
+
 Esse requisito do pacote não significa que todo host OpenCode execute Node: o OpenCode V2.0.31 oficial oferece um caminho de runtime Bun e um build Node separado fixado em Node 26.4.0. Não há aqui um requisito mínimo para Bun. O backend SQLite opcional de `pantheon_cost` tem um limite de capacidade distinto (`node:sqlite` requer Node >=22.5), que não reduz o requisito de suporte do pacote.
 
 No projeto em que você quer usar o Pantheon:
@@ -77,7 +79,7 @@ verificações repetíveis e passagens claras entre etapas do trabalho.
 
 ## Status
 
-Versão operacional neste checkout: **v1.6.0-beta.12** (esta página não afirma publicação). O Pantheon foi feito para OpenCode e depende da
+Versão operacional neste checkout: **v1.6.0-beta.13** (esta página não afirma publicação). O Pantheon foi feito para OpenCode e depende da
 disponibilidade e da configuração do OpenCode e dos serviços opcionais que você
 escolher. Veja as [releases](https://github.com/ils15/pantheon-opencode/releases)
 e o [changelog](CHANGELOG.md) para acompanhar as mudanças publicadas.

package/bin/pantheon-init.mjs

@@ -26,9 +26,10 @@ import {
   loadPlanArtifact,
   savePlanArtifact,
 } from '../scripts/install/plan-artifact.mjs'
+import { PROMPT_CANCELED } from '../scripts/install/prompt-result.mjs'
 import {
   isSupportedNodeVersion,
-  MIN_SUPPORTED_NODE_VERSION,
+  unsupportedNodeVersionMessage,
 } from '../scripts/node-engine-policy.mjs'
 import { runUpdate } from '../scripts/update.mjs'
 
@@ -36,10 +37,7 @@ const __dirname = path.dirname(fileURLToPath(import.meta.url))
 const ROOT = path.resolve(__dirname, '..')
 
 if (!isSupportedNodeVersion(process.versions.node)) {
-  console.error(
-    `❌ Pantheon requires Node.js >= ${MIN_SUPPORTED_NODE_VERSION} (current: ${process.versions.node})`,
-  )
-  console.error('   Install a newer Node via nvm: https://github.com/nvm-sh/nvm')
+  console.error(unsupportedNodeVersionMessage(process.versions.node))
   process.exit(1)
 }
 
@@ -111,14 +109,8 @@ async function authorizeReviewedPlan(plan) {
   for (const operation of operations) {
     console.log(`  ${operation.action.padEnd(9)} ${operation.path}`)
   }
-  const readline = await import('node:readline/promises')
-  const prompt = readline.createInterface({ input: process.stdin, output: process.stdout })
-  try {
-    const answer = await prompt.question('Apply this reviewed plan? [y/N] ')
-    return ['y', 'yes'].includes(answer.trim().toLowerCase())
-  } finally {
-    prompt.close()
-  }
+  const { promptReview } = await import('../scripts/install/interactive.mjs')
+  return promptReview('Apply this reviewed plan?', { default: false })
 }
 
 async function main() {
@@ -490,8 +482,14 @@ async function main() {
 
     if (reviewedPlan && !autoYes) {
       if (!forceHeadless && process.stdin.isTTY && process.stdout.isTTY) {
-        if (!(await authorizeReviewedPlan(reviewedPlan))) {
+        const authorization = await authorizeReviewedPlan(reviewedPlan)
+        if (authorization === PROMPT_CANCELED) {
           console.log('❌ Install canceled; no files were written.')
+          process.exitCode = 130
+          return
+        }
+        if (!authorization) {
+          console.log('❌ Install declined; no files were written.')
           return
         }
       } else {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pantheon-opencode",
-  "version": "1.6.0-beta.12",
+  "version": "1.6.0-beta.13",
   "description": "Multi-agent orchestration for OpenCode — 14 specialized agents, TDD, Themis review gates.",
   "type": "module",
   "workspaces": [
@@ -99,6 +99,7 @@
     "!**/*.pyc"
   ],
   "dependencies": {
+    "@clack/prompts": "1.8.1",
     "@opencode-ai/plugin": "1.18.33",
     "js-yaml": "^5.4.2",
     "zod": "4.1.8",

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "pantheon",
   "publisher": "ils15",
-  "version": "1.6.0-beta.12",
+  "version": "1.6.0-beta.13",
   "displayName": "Pantheon",
   "description": "Conductor-Delegate orchestration platform with 14 specialized agents, 20 skills, and OpenCode support.",
   "agents": "./src/agents",

package/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.backends._legacy:_Backend"
 
 [project]
 name = "pantheon"
-version = "1.6.0-beta.12"
+version = "1.6.0-beta.13"
 description = "Multi-agent orchestration framework"
 requires-python = ">=3.11"
 dependencies = []

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/opencode.mjs

@@ -63,6 +63,7 @@ import {
 } from './plan.mjs'
 import { findPlanDrift } from './plan-artifact.mjs'
 import { copyPluginFiles, installPlugin, registerPlugin, unregisterPlugin } from './plugin.mjs'
+import { PROMPT_CANCELED } from './prompt-result.mjs'
 import {
   checkRuntimePrerequisites,
   collectSkillNames,
@@ -1152,8 +1153,15 @@ async function installPass(
     const result = await runInteractiveInstall({
       components,
       defaultComponents: COMPONENT_NAMES,
+      prompts: opts.deps?.prompts,
+      isTTY: opts.deps?.isTTY,
     })
 
+    if (result.canceled) {
+      info('Installation canceled.')
+      return { ...stats, applied: false, reason: 'canceled' }
+    }
+
     if (!result.confirmed && !autoYes) {
       info('Installation canceled.')
       return { ...stats, applied: false, reason: 'canceled' }
@@ -1266,7 +1274,13 @@ async function installPass(
         const ask = typeof injected === 'function' ? injected : promptReview
         const accepted = await ask(`Apply these ${planned?.planned ?? 0} changes?`, {
           default: false,
+          prompts: opts.deps?.prompts,
+          isTTY: opts.deps?.isTTY,
         })
+        if (accepted === PROMPT_CANCELED) {
+          info(S.nothingApplied)
+          return { ...stats, applied: false, reason: 'canceled' }
+        }
         if (!accepted) {
           info(S.nothingApplied)
           return { ...stats, applied: false, reason: 'declined' }

package/scripts/install/prompt-result.mjs

@@ -0,0 +1,2 @@
+/** Sentinel returned when the user cancels an interactive authorization prompt. */
+export const PROMPT_CANCELED = Symbol('pantheon-prompt-canceled')

package/scripts/install/shared.mjs

@@ -19,12 +19,14 @@ import {
 } from 'node:fs'
 import { dirname, join } from 'node:path'
 import { fileURLToPath } from 'node:url'
-import { isSupportedNodeVersion, MIN_SUPPORTED_NODE_VERSION } from '../node-engine-policy.mjs'
+import {
+  isSupportedNodeVersion,
+  MIN_SUPPORTED_NODE_VERSION,
+  unsupportedNodeVersionMessage,
+} from '../node-engine-policy.mjs'
 
 if (!isSupportedNodeVersion(process.versions.node)) {
-  console.error(
-    `❌ Pantheon requires Node.js >= ${MIN_SUPPORTED_NODE_VERSION} (current: ${process.versions.node})`,
-  )
+  console.error(unsupportedNodeVersionMessage(process.versions.node))
   process.exit(1)
 }
 

package/scripts/node-engine-policy.mjs

@@ -4,6 +4,17 @@ import { join } from 'node:path'
 export const MIN_SUPPORTED_NODE_VERSION = '26.4.0'
 export const REQUIRED_NODE_ENGINE_RANGE = `>=${MIN_SUPPORTED_NODE_VERSION}`
 
+/** Return actionable, user-managed upgrade guidance for an unsupported runtime. */
+export function unsupportedNodeVersionMessage(version) {
+  return [
+    `❌ Pantheon requires Node.js >= ${MIN_SUPPORTED_NODE_VERSION} (current: ${version})`,
+    '   Install and switch with a user-managed Node version manager:',
+    `     nvm install ${MIN_SUPPORTED_NODE_VERSION} && nvm use ${MIN_SUPPORTED_NODE_VERSION}`,
+    `     fnm install ${MIN_SUPPORTED_NODE_VERSION} && fnm use ${MIN_SUPPORTED_NODE_VERSION}`,
+    `     volta install node@${MIN_SUPPORTED_NODE_VERSION}`,
+  ].join('\n')
+}
+
 function parseNodeVersion(version) {
   const match = /^v?(\d+)\.(\d+)\.(\d+)(?:-([^+]+))?(?:\+([\w.-]+))?$/.exec(String(version))
   if (!match) return null

package/scripts/postinstall.mjs

@@ -5,36 +5,37 @@
  * Runs after `npm install` completes. Validates environment and prints
  * setup instructions. Does NOT install Pantheon platform components.
  */
-import { isSupportedNodeVersion, MIN_SUPPORTED_NODE_VERSION } from './node-engine-policy.mjs'
+import { isSupportedNodeVersion, unsupportedNodeVersionMessage } from './node-engine-policy.mjs'
 
 try {
-  // Validate Node.js version
+  // npm may warn about `engines.node`, but must still finish installing so the
+  // bin can print the actionable hard-gate message. No Node-dependent setup is
+  // attempted from an incompatible lifecycle runtime.
   if (!isSupportedNodeVersion(process.versions.node)) {
-    console.error(
-      `❌ Pantheon requires Node.js >= ${MIN_SUPPORTED_NODE_VERSION} (current: ${process.versions.node})`,
+    console.warn(
+      `⚠️ Pantheon postinstall skipped because this runtime is unsupported.\n${unsupportedNodeVersionMessage(process.versions.node)}\n   Switch to Node.js >= 26.4.0 before running Pantheon setup.`,
     )
-    process.exit(1)
-  }
+  } else {
+    // Validate js-yaml is available
+    try {
+      await import('js-yaml')
+    } catch {
+      console.warn('⚠️  js-yaml not found — run `npm install` to install dependencies')
+    }
 
-  // Validate js-yaml is available
-  try {
-    await import('js-yaml')
-  } catch {
-    console.warn('⚠️  js-yaml not found — run `npm install` to install dependencies')
+    console.log('')
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')
+    console.log('  Pantheon OpenCode — npm dependencies installed ✅')
+    console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')
+    console.log('')
+    console.log('  Next steps:')
+    console.log('  1. Configure Pantheon:')
+    console.log('     npm run setup')
+    console.log('     # or: npx pantheon-opencode init')
+    console.log('  2. Verify installation:')
+    console.log('     npm run doctor')
+    console.log('')
   }
-
-  console.log('')
-  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')
-  console.log('  Pantheon OpenCode — npm dependencies installed ✅')
-  console.log('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━')
-  console.log('')
-  console.log('  Next steps:')
-  console.log('  1. Configure Pantheon:')
-  console.log('     npm run setup')
-  console.log('     # or: npx pantheon-opencode init')
-  console.log('  2. Verify installation:')
-  console.log('     npm run doctor')
-  console.log('')
 } catch (err) {
   console.error(`❌ Post-install check failed: ${err.message}`)
   process.exit(1)

package/scripts/sync-tui.mjs

@@ -15,6 +15,7 @@ import { homedir } from 'node:os'
 import { join } from 'node:path'
 import { fileURLToPath, pathToFileURL } from 'node:url'
 import { resolveOpenCodeVersion } from './install/opencode-version.mjs'
+import { isSupportedNodeVersion } from './node-engine-policy.mjs'
 
 const __dirname = fileURLToPath(new URL('.', import.meta.url))
 const ROOT = join(__dirname, '..')
@@ -257,7 +258,10 @@ async function main() {
 const isDirectRun =
   Boolean(process.argv[1]) && pathToFileURL(process.argv[1]).href === import.meta.url
 
-if (isDirectRun) {
+if (isDirectRun && !isSupportedNodeVersion(process.versions.node)) {
+  // postinstall.mjs already reports the engine mismatch. Do not call npm ci or
+  // touch the user's config with an incompatible lifecycle runtime.
+} else if (isDirectRun) {
   main().catch((err) => {
     console.error(`❌ TUI sync failed: ${err.message}`)
     process.exitCode = 1

package/src/plugins/tui/dist/tui-v2.js

@@ -477,7 +477,7 @@ function Sidebar(props) {
 		setProp(_el$, "width", "100%");
 		setProp(_el$, "padding", 1);
 		setProp(_el$2, "attributes", 1);
-		insert(_el$2, `Pantheon v1.6.0-beta.12`);
+		insert(_el$2, `Pantheon v1.6.0-beta.13`);
 		insertNode(_el$3, createTextNode(`OpenCode V2 · plugin TUI ativo`));
 		insert(_el$, createComponent(Show, {
 			get when() {
@@ -623,7 +623,7 @@ function HomeStatus(props) {
 	const muted = () => props.context.theme?.text?.muted ?? props.context.theme?.text?.base;
 	return (() => {
 		var _el$20 = createElement("text");
-		insert(_el$20, () => `Pantheon v1.6.0-beta.12${preset().name ? ` ⚡ ${preset().name}` : ""}`);
+		insert(_el$20, () => `Pantheon v1.6.0-beta.13${preset().name ? ` ⚡ ${preset().name}` : ""}`);
 		effect((_$p) => setProp(_el$20, "fg", muted(), _$p));
 		return _el$20;
 	})();

package/src/plugins/tui/dist/tui.js

@@ -167,7 +167,7 @@ async function detectVersion(api) {
 			if (ver) return ver;
 		}
 	} catch {}
-	return "1.6.0-beta.12";
+	return "1.6.0-beta.13";
 }
 /**
 * usage-bar — AI subscription usage gauge for the opencode TUI.

package/src/plugins/tui/package-lock.json

@@ -1,12 +1,12 @@
 {
   "name": "pantheon-tui",
-  "version": "1.6.0-beta.12",
+  "version": "1.6.0-beta.13",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "pantheon-tui",
-      "version": "1.6.0-beta.12",
+      "version": "1.6.0-beta.13",
       "license": "MIT",
       "dependencies": {
         "@opencode-ai/plugin": "1.18.33",

package/src/plugins/tui/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pantheon-tui",
   "type": "module",
-  "version": "1.6.0-beta.12",
+  "version": "1.6.0-beta.13",
   "description": "Pantheon TUI plugin — V1 rich sidebar and usage gauges; native V2 status, session and delegation sidebar",
   "license": "MIT",
   "engines": {