@plainconceptsplatform/agent-harness 2.0.0 → 2.1.0

package/src/commands/single.js

@@ -1,79 +1,79 @@
-import fse from 'fs-extra'
-import path from 'node:path'
-import { fileURLToPath } from 'url'
-import { cleanAiFiles } from '../steps/clean/index.js'
-import { copyContentStep } from '../steps/copy/index.js'
-import { chooseModels } from '../steps/models/index.js'
-import { initOpenspec } from '../steps/openspec/index.js'
-import { tokenOptimizationStep } from '../steps/optimization/index.js'
-import { choosePlatform } from '../steps/platform/index.js'
-import { installBrowser } from '../steps/browser/index.js'
-import { writeHarnessConfig } from '../steps/metadata/index.js'
-import { readHarnessConfig } from './shared.js'
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url))
-const platformsPreset = await fse.readJson(path.resolve(__dirname, '../presets/platforms.json'))
-// platforms.json is the single source of truth for valid platform values.
-// Hardcoding a subset here silently rewrote jira/gitlab/browser projects to github.
-const VALID_PLATFORMS = new Set(platformsPreset.map(p => p.value))
-
-export function resolvePlatform(value, fallback = 'github') {
-  return VALID_PLATFORMS.has(value) ? value : fallback
-}
-
-export async function runSingleCommand(command) {
-  const saved = await readHarnessConfig()
-  const ctx = {
-    hasDesign: !!saved?.preexisting?.design,
-    hasArchitecture: !!saved?.preexisting?.architecture,
-    hasOpenspec: !!saved?.preexisting?.openspec,
-    sourceMode: saved?.source?.mode ?? 'current',
-    sourceRoots: Array.isArray(saved?.source?.roots) ? saved.source.roots : [],
-    maxConcurrentAgents: saved?.agents?.maxConcurrent ?? 3,
-  }
-  const backlogPlatform = saved?.platform?.backlog
-  const repoPlatform = saved?.platform?.repo
-  const resolvedBacklog = resolvePlatform(backlogPlatform)
-  const resolvedRepo = resolvePlatform(repoPlatform)
-
-  const handlers = {
-    clean: async () => {
-      await cleanAiFiles()
-    },
-    platform: async () => {
-      await choosePlatform()
-    },
-    copy: async () => {
-      await copyContentStep({ backlogPlatform: resolvedBacklog, repoPlatform: resolvedRepo }, ctx)
-    },
-    openspec: async () => {
-      await initOpenspec()
-    },
-    models: async () => {
-      await chooseModels()
-    },
-    optimization: async () => {
-      await tokenOptimizationStep({ ctx })
-    },
-    browser: async () => {
-      await installBrowser()
-    },
-    metadata: async () => {
-      await writeHarnessConfig({
-        ...ctx,
-        backlogPlatform: resolvedBacklog,
-        repoPlatform: resolvedRepo,
-        maxConcurrentAgents: saved?.agents?.maxConcurrent ?? 3,
-        planModel: saved?.models?.plan ?? null,
-        buildModel: saved?.models?.build ?? null,
-        fastModel: saved?.models?.fast ?? null,
-        optionalTools: saved?.tools ?? null,
-      })
-    },
-  }
-
-  const handler = handlers[command]
-  if (!handler) return false
-  await handler()
-  return true
-}
+import fse from 'fs-extra'
+import path from 'node:path'
+import { fileURLToPath } from 'url'
+import { cleanAiFiles } from '../steps/clean/index.js'
+import { copyContentStep } from '../steps/copy/index.js'
+import { chooseModels } from '../steps/models/index.js'
+import { initOpenspec } from '../steps/openspec/index.js'
+import { tokenOptimizationStep } from '../steps/optimization/index.js'
+import { choosePlatform } from '../steps/platform/index.js'
+import { installBrowser } from '../steps/browser/index.js'
+import { writeHarnessConfig } from '../steps/metadata/index.js'
+import { readHarnessConfig } from './shared.js'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const platformsPreset = await fse.readJson(path.resolve(__dirname, '../presets/platforms.json'))
+// platforms.json is the single source of truth for valid platform values.
+// Hardcoding a subset here silently rewrote jira/gitlab/browser projects to github.
+const VALID_PLATFORMS = new Set(platformsPreset.map(p => p.value))
+
+export function resolvePlatform(value, fallback = 'github') {
+  return VALID_PLATFORMS.has(value) ? value : fallback
+}
+
+export async function runSingleCommand(command) {
+  const saved = await readHarnessConfig()
+  const ctx = {
+    hasDesign: !!saved?.preexisting?.design,
+    hasArchitecture: !!saved?.preexisting?.architecture,
+    hasOpenspec: !!saved?.preexisting?.openspec,
+    sourceMode: saved?.source?.mode ?? 'current',
+    sourceRoots: Array.isArray(saved?.source?.roots) ? saved.source.roots : [],
+    maxConcurrentAgents: saved?.agents?.maxConcurrent ?? 3,
+  }
+  const backlogPlatform = saved?.platform?.backlog
+  const repoPlatform = saved?.platform?.repo
+  const resolvedBacklog = resolvePlatform(backlogPlatform)
+  const resolvedRepo = resolvePlatform(repoPlatform)
+
+  const handlers = {
+    clean: async () => {
+      await cleanAiFiles()
+    },
+    platform: async () => {
+      await choosePlatform()
+    },
+    copy: async () => {
+      await copyContentStep({ backlogPlatform: resolvedBacklog, repoPlatform: resolvedRepo }, ctx)
+    },
+    openspec: async () => {
+      await initOpenspec()
+    },
+    models: async () => {
+      await chooseModels()
+    },
+    optimization: async () => {
+      await tokenOptimizationStep({ ctx })
+    },
+    browser: async () => {
+      await installBrowser()
+    },
+    metadata: async () => {
+      await writeHarnessConfig({
+        ...ctx,
+        backlogPlatform: resolvedBacklog,
+        repoPlatform: resolvedRepo,
+        maxConcurrentAgents: saved?.agents?.maxConcurrent ?? 3,
+        planModel: saved?.models?.plan ?? null,
+        buildModel: saved?.models?.build ?? null,
+        fastModel: saved?.models?.fast ?? null,
+        optionalTools: saved?.tools ?? null,
+      })
+    },
+  }
+
+  const handler = handlers[command]
+  if (!handler) return false
+  await handler()
+  return true
+}

package/src/commands/update.js

@@ -1,109 +1,109 @@
-import chalk from 'chalk'
-import { execa } from 'execa'
-import fse from 'fs-extra'
-import path from 'node:path'
-import { fileURLToPath } from 'url'
-import { readHarnessConfig } from './shared.js'
-import { copyContentStep } from '../steps/copy/index.js'
-import { writeModelsToConfigs } from '../steps/models/write.js'
-import { patchGuardrails } from '../steps/optimization/patch-guardrails.js'
-import { writeHarnessConfig } from '../steps/metadata/index.js'
-import { exit } from '../utils/process.js'
-
-const SIMPLE_ENGLISH_ENTRY = {
-  source: 'AminBlg/SimpleEnglish',
-  sourceType: 'github',
-  skillPath: 'skills/simple-english/SKILL.md',
-}
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url))
-const platformsPreset = await fse.readJson(path.resolve(__dirname, '../presets/platforms.json'))
-const VALID_PLATFORMS = new Set(platformsPreset.map(p => p.value))
-
-function resolvePlatform(value, fallback = 'github') {
-  return VALID_PLATFORMS.has(value) ? value : fallback
-}
-
-export async function runUpdate() {
-  const saved = await readHarnessConfig()
-  if (!saved?.platform) {
-    console.log(chalk.red('No agent-harness config found. Run the wizard first.'))
-    exit(1)
-    return
-  }
-
-  const backlogPlatform = resolvePlatform(saved.platform.backlog)
-  const repoPlatform = resolvePlatform(saved.platform.repo)
-
-  const ctx = {
-    hasDesign: !!saved.preexisting?.design,
-    hasArchitecture: !!saved.preexisting?.architecture,
-    hasOpenspec: !!saved.preexisting?.openspec,
-    sourceMode: saved.source?.mode ?? 'current',
-    sourceRoots: Array.isArray(saved.source?.roots) ? saved.source.roots : [],
-    maxConcurrentAgents: saved.agents?.maxConcurrent ?? 3,
-    installScope: 'local',
-    skipSkills: false,
-    updateMode: true,
-  }
-
-  console.log()
-  console.log(chalk.bold('Updating project from saved config'))
-  console.log(chalk.dim(`  backlog: ${backlogPlatform}  repo: ${repoPlatform}  agents: ${ctx.maxConcurrentAgents}`))
-  console.log()
-
-  await copyContentStep({ backlogPlatform, repoPlatform }, ctx)
-
-  if (saved.models) {
-    await writeModelsToConfigs({ buildModel: saved.models.build })
-  }
-
-  const tools = saved.tools ?? {}
-  await migrateCavemanSkill(tools)
-  await patchGuardrails({
-    rtk: !!tools.rtk,
-    simpleEnglish: !!(tools.simpleEnglish || tools.caveman),
-    codegraph: !!tools.codegraph,
-    memory: !!tools.memory,
-    humanizer: !!tools.humanizer,
-  })
-
-  await writeHarnessConfig({
-    ...ctx,
-    backlogPlatform,
-    repoPlatform,
-    maxConcurrentAgents: ctx.maxConcurrentAgents,
-    planModel: saved.models?.plan ?? null,
-    buildModel: saved.models?.build ?? null,
-    fastModel: saved.models?.fast ?? null,
-    optionalTools: tools,
-  })
-
-  console.log()
-  console.log(chalk.bold.green('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'))
-  console.log(chalk.bold.green('  Update complete!'))
-  console.log(chalk.bold.green('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'))
-  console.log()
-}
-
-async function migrateCavemanSkill(tools) {
-  if (!tools.caveman || tools.simpleEnglish) return
-
-  const lockPath = path.join(process.cwd(), 'skills-lock.json')
-  const lock = await fse.readJson(lockPath).catch(() => ({ version: 1, skills: {} }))
-  lock.skills ??= {}
-  delete lock.skills.caveman
-  lock.skills['simple-english'] = SIMPLE_ENGLISH_ENTRY
-  await fse.writeJson(lockPath, lock, { spaces: 2 })
-  await fse.remove(path.join(process.cwd(), '.agents', 'skills', 'caveman'))
-
-  const result = await execa('npx', ['skills', 'experimental_install', '--yes'], {
-    cwd: process.cwd(),
-    reject: false,
-    stdio: 'pipe',
-    timeout: 600000,
-  })
-  if (result.exitCode !== 0) {
-    console.log(chalk.yellow('Simple English was added to skills-lock.json but could not be installed. Run npx skills experimental_install --yes.'))
-  }
-}
+import chalk from 'chalk'
+import { execa } from 'execa'
+import fse from 'fs-extra'
+import path from 'node:path'
+import { fileURLToPath } from 'url'
+import { readHarnessConfig } from './shared.js'
+import { copyContentStep } from '../steps/copy/index.js'
+import { writeModelsToConfigs } from '../steps/models/write.js'
+import { patchGuardrails } from '../steps/optimization/patch-guardrails.js'
+import { writeHarnessConfig } from '../steps/metadata/index.js'
+import { exit } from '../utils/process.js'
+
+const SIMPLE_ENGLISH_ENTRY = {
+  source: 'AminBlg/SimpleEnglish',
+  sourceType: 'github',
+  skillPath: 'skills/simple-english/SKILL.md',
+}
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+const platformsPreset = await fse.readJson(path.resolve(__dirname, '../presets/platforms.json'))
+const VALID_PLATFORMS = new Set(platformsPreset.map(p => p.value))
+
+function resolvePlatform(value, fallback = 'github') {
+  return VALID_PLATFORMS.has(value) ? value : fallback
+}
+
+export async function runUpdate() {
+  const saved = await readHarnessConfig()
+  if (!saved?.platform) {
+    console.log(chalk.red('No agent-harness config found. Run the wizard first.'))
+    exit(1)
+    return
+  }
+
+  const backlogPlatform = resolvePlatform(saved.platform.backlog)
+  const repoPlatform = resolvePlatform(saved.platform.repo)
+
+  const ctx = {
+    hasDesign: !!saved.preexisting?.design,
+    hasArchitecture: !!saved.preexisting?.architecture,
+    hasOpenspec: !!saved.preexisting?.openspec,
+    sourceMode: saved.source?.mode ?? 'current',
+    sourceRoots: Array.isArray(saved.source?.roots) ? saved.source.roots : [],
+    maxConcurrentAgents: saved.agents?.maxConcurrent ?? 3,
+    installScope: 'local',
+    skipSkills: false,
+    updateMode: true,
+  }
+
+  console.log()
+  console.log(chalk.bold('Updating project from saved config'))
+  console.log(chalk.dim(`  backlog: ${backlogPlatform}  repo: ${repoPlatform}  agents: ${ctx.maxConcurrentAgents}`))
+  console.log()
+
+  await copyContentStep({ backlogPlatform, repoPlatform }, ctx)
+
+  if (saved.models) {
+    await writeModelsToConfigs({ buildModel: saved.models.build })
+  }
+
+  const tools = saved.tools ?? {}
+  await migrateCavemanSkill(tools)
+  await patchGuardrails({
+    rtk: !!tools.rtk,
+    simpleEnglish: !!(tools.simpleEnglish || tools.caveman),
+    codegraph: !!tools.codegraph,
+    memory: !!tools.memory,
+    humanizer: !!tools.humanizer,
+  })
+
+  await writeHarnessConfig({
+    ...ctx,
+    backlogPlatform,
+    repoPlatform,
+    maxConcurrentAgents: ctx.maxConcurrentAgents,
+    planModel: saved.models?.plan ?? null,
+    buildModel: saved.models?.build ?? null,
+    fastModel: saved.models?.fast ?? null,
+    optionalTools: tools,
+  })
+
+  console.log()
+  console.log(chalk.bold.green('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'))
+  console.log(chalk.bold.green('  Update complete!'))
+  console.log(chalk.bold.green('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'))
+  console.log()
+}
+
+async function migrateCavemanSkill(tools) {
+  if (!tools.caveman || tools.simpleEnglish) return
+
+  const lockPath = path.join(process.cwd(), 'skills-lock.json')
+  const lock = await fse.readJson(lockPath).catch(() => ({ version: 1, skills: {} }))
+  lock.skills ??= {}
+  delete lock.skills.caveman
+  lock.skills['simple-english'] = SIMPLE_ENGLISH_ENTRY
+  await fse.writeJson(lockPath, lock, { spaces: 2 })
+  await fse.remove(path.join(process.cwd(), '.agents', 'skills', 'caveman'))
+
+  const result = await execa('npx', ['skills', 'experimental_install', '--yes'], {
+    cwd: process.cwd(),
+    reject: false,
+    stdio: 'pipe',
+    timeout: 600000,
+  })
+  if (result.exitCode !== 0) {
+    console.log(chalk.yellow('Simple English was added to skills-lock.json but could not be installed. Run npx skills experimental_install --yes.'))
+  }
+}

package/src/commands/wizard.js

@@ -1,134 +1,134 @@
-import { select as wizardSelect } from '@inquirer/prompts'
-import chalk from 'chalk'
-import { ensureGitLongpaths } from './shared.js'
-import { chooseSourceScope } from '../steps/source/index.js'
-import { cleanAiFiles } from '../steps/clean/index.js'
-import { choosePlatform } from '../steps/platform/index.js'
-import { copyContentStep } from '../steps/copy/index.js'
-import { initOpenspec } from '../steps/openspec/index.js'
-import { chooseModels } from '../steps/models/index.js'
-import { tokenOptimizationStep } from '../steps/optimization/index.js'
-import { installBrowser } from '../steps/browser/index.js'
-import { writeHarnessConfig } from '../steps/metadata/index.js'
-
-export async function runWizard(version) {
-  const logo = chalk.hex('#fe3d57')
-  const bannerLines = [
-    logo('                             '),
-    logo('        ▒▒▒▒▒▒▒▒▒▒▒▒▒        '),
-    logo('        ▒▒▓       ▓▒▓        '),
-    logo('   ▒▒▒▒▒▒▓▒▒▒▒▒▒▒▒▒▓▓▒▒▒▒▒   '),
-    logo('  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓  '),
-    logo(' ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓ '),
-    logo(' ▓▒▒▒▒░░░▒▒▒▒▒▒▒▒▒▒▒░░░▒▒▒▓▓ '),
-    logo('  ▓▓▓▓▒▒▒▓▓▓▓▓▓▓▓▓▓▓▒▒▒▓▓▓▓  '),
-    logo('  ▓▓▒▒▒▒▒▒░▒▒▒▒▒▒▒░▒▒▒▒▒▒▓▓  '),
-    logo('  ▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓   '),
-    logo('  ▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓   '),
-    logo('   ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓    '),
-    '',
-    chalk.bold('        🧰 agent-harness') + chalk.dim(` v${version}`),
-    chalk.dim('        Prepare your codebase for AI agents'),
-  ]
-
-  for (const line of bannerLines) console.log(line)
-  console.log()
-  console.log('  This tool will set up your project with a team of AI agents,')
-  console.log('  install skills, select models, and configure OpenCode.')
-  console.log()
-
-  // Only wait for Enter in a real interactive TTY
-  if (process.stdin.isTTY) {
-    console.log(chalk.bold('  Press Enter to begin...'))
-    console.log()
-    await new Promise(resolve => {
-      process.stdin.resume()
-      process.stdin.once('data', () => {
-        process.stdin.pause()
-        resolve()
-      })
-    })
-  }
-
-  const longpathsConfigured = await ensureGitLongpaths()
-  if (longpathsConfigured) console.log(chalk.dim('  Git long paths enabled for this repository.'))
-
-  const scope = await chooseSourceScope()
-
-  const maxConcurrentAgents = await wizardSelect({
-    message: 'Max concurrent agents:',
-    default: 3,
-    choices: [
-      { name: '1', value: 1, description: 'Serial: one agent at a time' },
-      { name: '2', value: 2, description: 'Conservative: lower resource usage' },
-      { name: '3 (default)', value: 3, description: 'Recommended: balances speed vs MCP load' },
-      { name: '4', value: 4, description: 'Higher parallelism' },
-      { name: '5', value: 5, description: 'Maximum: needs more resources' },
-    ],
-  })
-
-  const installScope = await wizardSelect({
-    message: 'Install dependencies:',
-    default: 'local',
-    choices: [
-      { name: 'Locally (default)', value: 'local', description: 'Install tools project-locally where possible' },
-      { name: 'Globally', value: 'global', description: 'Install tools globally (affects all projects on this machine)' },
-    ],
-  })
-
-  const preserve = await cleanAiFiles({ removeLegacyConfig: true })
-  const ctx = { ...preserve, ...scope, maxConcurrentAgents, installScope }
-
-  const { backlogPlatform, repoPlatform } = await choosePlatform()
-
-  await copyContentStep({ backlogPlatform, repoPlatform }, ctx)
-
-  const openspec = await initOpenspec()
-
-  const selectedModels = await chooseModels()
-
-  const tokenOpt = await tokenOptimizationStep({ ctx })
-  const { rtk, quota, simpleEnglish, codegraph, memory, humanizer } = tokenOpt
-
-  await installBrowser(ctx)
-
-  await writeHarnessConfig({
-    ...ctx,
-    backlogPlatform,
-    repoPlatform,
-    openspec,
-    maxConcurrentAgents,
-    installScope,
-    additionalSkillsProvider: 'npx-skills',
-    ...selectedModels,
-    optionalTools: { rtk, quota, simpleEnglish, codegraph, memory, humanizer },
-  })
-
-  const toGenerate = [
-    !ctx.hasDesign && 'DESIGN.md',
-    !ctx.hasArchitecture && 'ARCHITECTURE.md',
-  ].filter(Boolean)
-
-  console.log()
-  console.log(chalk.bold.green('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'))
-  console.log(chalk.bold.green('  Onboarding complete!'))
-  console.log(chalk.bold.green('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'))
-  console.log()
-  console.log('  Open this project in OpenCode and type:')
-  console.log(chalk.bold('  "/init"'))
-  console.log('  Or run the following command in your terminal:')
-  console.log(chalk.bold('  opencode --prompt "/init" --model "opencode/big-pickle"  '))
-  console.log()
-  console.log(chalk.dim('  Note: the first time you open OpenCode in this project,'))
-  console.log(chalk.dim('  it will install plugin dependencies. You may see a black'))
-  console.log(chalk.dim('  screen for a moment: this is normal. Wait for it to load.'))
-  console.log()
-  if (toGenerate.length > 0) {
-    console.log(`  OpenCode will generate ${toGenerate.join(' and ')}`)
-    console.log('  from your actual codebase, then activate the agent team.')
-  } else {
-    console.log('  OpenCode will activate the agent team.')
-  }
-  console.log(`  Source scope: ${ctx.sourceMode === 'parent-selected' ? ctx.sourceRoots.map(p => `../${p.split(/[/\\]/).pop()}`).join(', ') : 'current folder'}`)
-  console.log()
-}
+import { select as wizardSelect } from '@inquirer/prompts'
+import chalk from 'chalk'
+import { ensureGitLongpaths } from './shared.js'
+import { chooseSourceScope } from '../steps/source/index.js'
+import { cleanAiFiles } from '../steps/clean/index.js'
+import { choosePlatform } from '../steps/platform/index.js'
+import { copyContentStep } from '../steps/copy/index.js'
+import { initOpenspec } from '../steps/openspec/index.js'
+import { chooseModels } from '../steps/models/index.js'
+import { tokenOptimizationStep } from '../steps/optimization/index.js'
+import { installBrowser } from '../steps/browser/index.js'
+import { writeHarnessConfig } from '../steps/metadata/index.js'
+
+export async function runWizard(version) {
+  const logo = chalk.hex('#fe3d57')
+  const bannerLines = [
+    logo('                             '),
+    logo('        ▒▒▒▒▒▒▒▒▒▒▒▒▒        '),
+    logo('        ▒▒▓       ▓▒▓        '),
+    logo('   ▒▒▒▒▒▒▓▒▒▒▒▒▒▒▒▒▓▓▒▒▒▒▒   '),
+    logo('  ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓  '),
+    logo(' ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓▓ '),
+    logo(' ▓▒▒▒▒░░░▒▒▒▒▒▒▒▒▒▒▒░░░▒▒▒▓▓ '),
+    logo('  ▓▓▓▓▒▒▒▓▓▓▓▓▓▓▓▓▓▓▒▒▒▓▓▓▓  '),
+    logo('  ▓▓▒▒▒▒▒▒░▒▒▒▒▒▒▒░▒▒▒▒▒▒▓▓  '),
+    logo('  ▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓   '),
+    logo('  ▓▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▓   '),
+    logo('   ▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓▓    '),
+    '',
+    chalk.bold('        🧰 agent-harness') + chalk.dim(` v${version}`),
+    chalk.dim('        Prepare your codebase for AI agents'),
+  ]
+
+  for (const line of bannerLines) console.log(line)
+  console.log()
+  console.log('  This tool will set up your project with a team of AI agents,')
+  console.log('  install skills, select models, and configure OpenCode.')
+  console.log()
+
+  // Only wait for Enter in a real interactive TTY
+  if (process.stdin.isTTY) {
+    console.log(chalk.bold('  Press Enter to begin...'))
+    console.log()
+    await new Promise(resolve => {
+      process.stdin.resume()
+      process.stdin.once('data', () => {
+        process.stdin.pause()
+        resolve()
+      })
+    })
+  }
+
+  const longpathsConfigured = await ensureGitLongpaths()
+  if (longpathsConfigured) console.log(chalk.dim('  Git long paths enabled for this repository.'))
+
+  const scope = await chooseSourceScope()
+
+  const maxConcurrentAgents = await wizardSelect({
+    message: 'Max concurrent agents:',
+    default: 3,
+    choices: [
+      { name: '1', value: 1, description: 'Serial: one agent at a time' },
+      { name: '2', value: 2, description: 'Conservative: lower resource usage' },
+      { name: '3 (default)', value: 3, description: 'Recommended: balances speed vs MCP load' },
+      { name: '4', value: 4, description: 'Higher parallelism' },
+      { name: '5', value: 5, description: 'Maximum: needs more resources' },
+    ],
+  })
+
+  const installScope = await wizardSelect({
+    message: 'Install dependencies:',
+    default: 'local',
+    choices: [
+      { name: 'Locally (default)', value: 'local', description: 'Install tools project-locally where possible' },
+      { name: 'Globally', value: 'global', description: 'Install tools globally (affects all projects on this machine)' },
+    ],
+  })
+
+  const preserve = await cleanAiFiles({ removeLegacyConfig: true })
+  const ctx = { ...preserve, ...scope, maxConcurrentAgents, installScope }
+
+  const { backlogPlatform, repoPlatform } = await choosePlatform()
+
+  await copyContentStep({ backlogPlatform, repoPlatform }, ctx)
+
+  const openspec = await initOpenspec()
+
+  const selectedModels = await chooseModels()
+
+  const tokenOpt = await tokenOptimizationStep({ ctx })
+  const { rtk, quota, simpleEnglish, codegraph, memory, humanizer } = tokenOpt
+
+  await installBrowser(ctx)
+
+  await writeHarnessConfig({
+    ...ctx,
+    backlogPlatform,
+    repoPlatform,
+    openspec,
+    maxConcurrentAgents,
+    installScope,
+    additionalSkillsProvider: 'npx-skills',
+    ...selectedModels,
+    optionalTools: { rtk, quota, simpleEnglish, codegraph, memory, humanizer },
+  })
+
+  const toGenerate = [
+    !ctx.hasDesign && 'DESIGN.md',
+    !ctx.hasArchitecture && 'ARCHITECTURE.md',
+  ].filter(Boolean)
+
+  console.log()
+  console.log(chalk.bold.green('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'))
+  console.log(chalk.bold.green('  Onboarding complete!'))
+  console.log(chalk.bold.green('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'))
+  console.log()
+  console.log('  Open this project in OpenCode and type:')
+  console.log(chalk.bold('  "/init"'))
+  console.log('  Or run the following command in your terminal:')
+  console.log(chalk.bold('  opencode --prompt "/init" --model "opencode/big-pickle"  '))
+  console.log()
+  console.log(chalk.dim('  Note: the first time you open OpenCode in this project,'))
+  console.log(chalk.dim('  it will install plugin dependencies. You may see a black'))
+  console.log(chalk.dim('  screen for a moment: this is normal. Wait for it to load.'))
+  console.log()
+  if (toGenerate.length > 0) {
+    console.log(`  OpenCode will generate ${toGenerate.join(' and ')}`)
+    console.log('  from your actual codebase, then activate the agent team.')
+  } else {
+    console.log('  OpenCode will activate the agent team.')
+  }
+  console.log(`  Source scope: ${ctx.sourceMode === 'parent-selected' ? ctx.sourceRoots.map(p => `../${p.split(/[/\\]/).pop()}`).join(', ') : 'current folder'}`)
+  console.log()
+}