opencode-onboard 0.4.3 → 0.4.5

package/content/AGENTS.md

@@ -65,9 +65,11 @@ The output must be a real, populated `ARCHITECTURE.md` based on what you found i
 
 ### Step 4, Populate OpenSpec config
 
-Read `openspec/config.yaml`. It contains a template with commented-out examples. Fill in the `context:` field with real project information discovered during steps 1-3:
+Write `openspec/config.yaml` with the real project information discovered during steps 1-3. Overwrite whatever is currently in the file. The output must contain `schema: spec-driven` and a populated `context:` block. Do not leave placeholder text.
 
 ```yaml
+schema: spec-driven
+
 context: |
   Tech stack: <languages, frameworks, libraries found in the codebase>
   Build system: <build tools, package managers>
@@ -76,7 +78,7 @@ context: |
   Domain: <what this project does, in one line>
 ```
 
-Keep the `schema: spec-driven` line. Add `rules:` only if the codebase has clear conventions worth enforcing (e.g., max task size, proposal format). Do not invent rules that aren't evidenced by the codebase.
+Replace every `<…>` with real values from the codebase. Add a `rules:` section only if the codebase has clear conventions worth enforcing (e.g., max task size, proposal format). Do not invent rules that aren't evidenced by the codebase.
 
 ---
 
@@ -184,11 +186,11 @@ Core tools used in this workflow:
 If a teammate stalls due to model quota/rate-limit exhaustion:
 1. `team_shutdown name:"<stuck-member>" force:true`
 2. `team_spawn` same member/task with an available model
-3. `team_message` start instruction with the exact next task ID
+3. `team_message` start instruction with the exact next task ID
 
 ---
 
-## Pipeline
+## Pipeline
 
 ```
 devops-manager (lead mode)
@@ -206,7 +208,7 @@ devops-manager (ship mode)
   → verify completion → commit → push → PR → post comment
 ```
 
-### Phase 1, Parse & Propose
+### Phase 1, Parse & Propose
 
 ```
 1. Detect URL type → load matching skill (ob-userstory-gh or ob-userstory-az)
@@ -226,7 +228,7 @@ devops-manager (ship mode)
    - Lead assigns next batch (up to 3) to agents that report done. Repeat until board empty.
    - Lead merges each engineer branch after shutdown, then marks tasks done in tasks.md.
 2. Verify with tests/build/lint according to task scope.
-```
+```
 
 ### Phase 3, Ship
 
@@ -280,7 +282,7 @@ Default `basic-engineer` abilities:
 - Infrastructure: @ob-default
 ```
 
-## Skills
+## Skills
 
 Skills provide platform and tech-specific knowledge. Agents detect and load them automatically, **you never tell an agent which skill to use**.
 
@@ -299,10 +301,10 @@ Skills are located in `.agents/skills/`. Each skill has a `SKILL.md` with a desc
 | `ob-pullrequest-gh` | Create PR on GitHub |
 | `openspec-propose` | Propose change artifacts (proposal, specs, tasks) |
 | `openspec-apply-change` | Implement change with agent team |
-| `openspec-archive-change` | Archive completed change |
-| `browser-automation` | Browser automation for localhost UI, screenshots, clicks, queries |
-
-Execution rules live in skills. Keep AGENTS.md focused on orchestration and routing.
+| `openspec-archive-change` | Archive completed change |
+| `browser-automation` | Browser automation for localhost UI, screenshots, clicks, queries |
+
+Execution rules live in skills. Keep AGENTS.md focused on orchestration and routing.
 
 ---
 
@@ -343,16 +345,25 @@ When `## Source Roots` lists multiple roots, each root is an independent git rep
 
 ---
 
-## Guardrails
-
-Guardrails are mandatory via `ob-global` and ability-loaded skills.
-
-Minimal non-negotiables:
-- Never commit or push to `main`.
-- Never force push.
-- Never expose or commit secrets.
-- Use `gh`/`az` CLI for platform operations.
-- In multi-repo source scope, run git operations per repository.
+## Guardrails
+
+Guardrails are mandatory via `ob-global` and ability-loaded skills.
+
+Minimal non-negotiables:
+- Never commit or push to `main`.
+- Never force push.
+- Never expose or commit secrets.
+- Use `gh`/`az` CLI for platform operations.
+- In multi-repo source scope, run git operations per repository.
+
+### Config file conflict: `opencode.jsonc` vs `.opencode/opencode.json`
+
+This project uses `.opencode/opencode.json` as the single OpenCode configuration file. Some tools (e.g., codegraph) may create an `opencode.jsonc` file at the project root. **These two files cannot coexist.**
+
+If you detect both `opencode.jsonc` (project root) and `.opencode/opencode.json` exist:
+1. **Stop immediately** and warn the user: "Conflicting OpenCode config files detected. This project uses `.opencode/opencode.json` only. The root `opencode.jsonc` must be removed or its contents merged into `.opencode/opencode.json`."
+2. Do NOT proceed with any task until the conflict is resolved.
+3. If the user asks you to fix it: merge any `mcpServers` or other config from `opencode.jsonc` into `.opencode/opencode.json`, then delete `opencode.jsonc`.
 
 ---
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-onboard",
-  "version": "0.4.3",
+  "version": "0.4.5",
   "description": "Prepare any brownfield codebase for AI agent workflows using OpenCode, OpenSpec, and ensemble orchestration.",
   "keywords": [
     "opencode",

package/src/commands/wizard.js

@@ -1,113 +1,124 @@
-import { select as wizardSelect } from '@inquirer/prompts'
-import chalk from 'chalk'
-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 { writeOnboardConfig } 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('        🧰 opencode-onboard') + 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 scope = await chooseSourceScope()
-
-  const maxConcurrentAgents = await wizardSelect({
-    message: 'Max concurrent agents:',
-    default: 4,
-    choices: [
-      { name: '2', value: 2, description: 'Conservative — lower resource usage' },
-      { name: '3', value: 3, description: 'Moderate parallelism' },
-      { name: '4 (default)', value: 4, description: 'Recommended for most projects' },
-      { name: '5', value: 5, description: 'High parallelism — requires more resources' },
-      { name: '6', value: 6, description: 'Maximum parallelism' },
-    ],
-  })
-
-  const preserve = await cleanAiFiles()
-  const ctx = { ...preserve, ...scope, maxConcurrentAgents }
-
-  const platform = await choosePlatform()
-
-  await copyContentStep(platform, ctx)
-
-  await initOpenspec()
-
-  const selectedModels = await chooseModels()
-
-  const tokenOpt = await tokenOptimizationStep({ ctx })
-  const { rtk, quota, caveman, cavemanGuidance } = tokenOpt
-
-  await installBrowser()
-
-  await writeOnboardConfig({
-    ...ctx,
-    platform,
-    maxConcurrentAgents,
-    additionalSkillsProvider: 'npx-skills',
-    ...selectedModels,
-    optionalTools: { rtk, quota, caveman },
-    cavemanGuidance,
-  })
-
-  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()
-  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 { 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 { writeOnboardConfig } 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('        🧰 opencode-onboard') + 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 scope = await chooseSourceScope()
+
+  const maxConcurrentAgents = await wizardSelect({
+    message: 'Max concurrent agents:',
+    default: 4,
+    choices: [
+      { name: '2', value: 2, description: 'Conservative — lower resource usage' },
+      { name: '3', value: 3, description: 'Moderate parallelism' },
+      { name: '4 (default)', value: 4, description: 'Recommended for most projects' },
+      { name: '5', value: 5, description: 'High parallelism — requires more resources' },
+      { name: '6', value: 6, description: 'Maximum parallelism' },
+    ],
+  })
+
+  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()
+  const ctx = { ...preserve, ...scope, maxConcurrentAgents, installScope }
+
+  const platform = await choosePlatform()
+
+  await copyContentStep(platform, ctx)
+
+  const openspec = await initOpenspec()
+
+  const selectedModels = await chooseModels()
+
+  const tokenOpt = await tokenOptimizationStep({ ctx })
+  const { rtk, quota, caveman, cavemanGuidance } = tokenOpt
+
+  await installBrowser(ctx)
+
+  await writeOnboardConfig({
+    ...ctx,
+    platform,
+    openspec,
+    maxConcurrentAgents,
+    installScope,
+    additionalSkillsProvider: 'npx-skills',
+    ...selectedModels,
+    optionalTools: { rtk, quota, caveman },
+    cavemanGuidance,
+  })
+
+  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()
+  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()
+}

package/src/presets/browser.json

@@ -1,18 +1,22 @@
-{
-  "installer": {
-    "command": "npx",
-    "args": ["@different-ai/opencode-browser", "install"]
-  },
-  "output": {
-    "showAfter": "To load the extension",
-    "hideAfter": "Press Enter when"
-  },
-  "autoAnswers": [
-    { "trigger": "Press Enter when", "response": "" },
-    { "trigger": "Choose config location", "response": "2" },
-    { "trigger": "Add plugin automatically?", "response": "y" },
-    { "trigger": "Create one?", "response": "y" },
-    { "trigger": "Add browser-automation skill", "response": "n" },
-    { "trigger": "Check broker", "response": "n" }
-  ]
-}
+{
+  "installer": {
+    "command": "npx",
+    "args": ["@different-ai/opencode-browser", "install"]
+  },
+  "output": {
+    "showAfter": "To load the extension",
+    "hideAfter": "Press Enter when"
+  },
+  "locationChoices": {
+    "local": "2",
+    "global": "1"
+  },
+  "autoAnswers": [
+    { "trigger": "Press Enter when", "response": "" },
+    { "trigger": "Choose config location", "response": "__LOCATION__" },
+    { "trigger": "Add plugin automatically?", "response": "y" },
+    { "trigger": "Create one?", "response": "y" },
+    { "trigger": "Add browser-automation skill", "response": "n" },
+    { "trigger": "Check broker", "response": "n" }
+  ]
+}

package/src/presets/optimization.json

@@ -1,22 +1,27 @@
-{
-  "message": "Enable tools:",
-  "info": "Choose which optimization tools to enable (recommended: all).",
-  "timeoutMs": 30000,
-  "choices": [
-    {
-      "name": "RTK check (recommended)",
-      "value": "rtk",
-      "checked": true
-    },
-    {
-      "name": "opencode-quota plugin (recommended)",
-      "value": "quota",
-      "checked": true
-    },
-    {
-      "name": "caveman concise mode (recommended)",
-      "value": "caveman",
-      "checked": true
-    }
-  ]
-}
+{
+  "message": "Enable tools:",
+  "info": "Choose which optimization tools to enable (recommended: all).",
+  "timeoutMs": 30000,
+  "choices": [
+    {
+      "name": "RTK check (recommended)",
+      "value": "rtk",
+      "checked": true
+    },
+    {
+      "name": "opencode-quota plugin (recommended)",
+      "value": "quota",
+      "checked": true
+    },
+    {
+      "name": "caveman concise mode (recommended)",
+      "value": "caveman",
+      "checked": true
+    },
+    {
+      "name": "codegraph semantic index (recommended)",
+      "value": "codegraph",
+      "checked": true
+    }
+  ]
+}

package/src/steps/browser/browser.test.js

@@ -1,81 +1,115 @@
-import { describe, it, expect, vi, beforeEach } from 'vitest'
-
-vi.mock('../../utils/exec.js', () => ({
-  header: vi.fn(),
-  info: vi.fn(),
-  success: vi.fn(),
-  warn: vi.fn(),
-  error: vi.fn(),
-}))
-
-vi.mock('fs-extra', () => ({
-  default: {
-    readJson: vi.fn().mockResolvedValue({
-      installer: { command: 'npx', args: ['@different-ai/opencode-browser', 'install'] },
-      output: { showAfter: '===', hideAfter: '===' },
-      autoAnswers: [
-        { trigger: 'Install', response: 'y' },
-      ],
-    }),
-  },
-}))
-
-vi.mock('execa', () => ({
-  execa: vi.fn(),
-}))
-
-import fse from 'fs-extra'
-import { installBrowser } from './index.js'
-
-describe('installBrowser()', () => {
-  beforeEach(() => {
-    vi.clearAllMocks()
-  })
-
-  it('calls installer command from preset', async () => {
-    const { execa } = await import('execa')
-    const mockChild = {
-      stdout: { on: vi.fn() },
-      stderr: { on: vi.fn() },
-      stdin: { write: vi.fn() },
-      then: (cb) => cb({ exitCode: 0 }),
-    }
-    execa.mockReturnValue(mockChild)
-
-    await installBrowser()
-
-    expect(execa).toHaveBeenCalledWith('npx', expect.arrayContaining(['@different-ai/opencode-browser']), expect.any(Object))
-  })
-
-  it('logs success when exit code is 0', async () => {
-    const { execa } = await import('execa')
-    const mockChild = {
-      stdout: { on: vi.fn() },
-      stderr: { on: vi.fn() },
-      stdin: { write: vi.fn() },
-      then: (cb) => cb({ exitCode: 0 }),
-    }
-    execa.mockReturnValue(mockChild)
-    const { success } = await import('../../utils/exec.js')
-
-    await installBrowser()
-
-    expect(success).toHaveBeenCalledWith('opencode-browser installed')
-  })
-
-  it('logs warning when exit code is non-zero', async () => {
-    const { execa } = await import('execa')
-    const mockChild = {
-      stdout: { on: vi.fn() },
-      stderr: { on: vi.fn() },
-      stdin: { write: vi.fn() },
-      then: (cb) => cb({ exitCode: 1 }),
-    }
-    execa.mockReturnValue(mockChild)
-    const { warn } = await import('../../utils/exec.js')
-
-    await installBrowser()
-
-    expect(warn).toHaveBeenCalledWith('opencode-browser install exited with non-zero code')
-  })
-})
+import { describe, it, expect, vi, beforeEach } from 'vitest'
+import { installBrowser } from './index.js'
+
+vi.mock('../../utils/exec.js', () => ({
+  header: vi.fn(),
+  info: vi.fn(),
+  success: vi.fn(),
+  warn: vi.fn(),
+  error: vi.fn(),
+}))
+
+vi.mock('fs-extra', () => ({
+  default: {
+    readJson: vi.fn().mockResolvedValue({
+      installer: { command: 'npx', args: ['@different-ai/opencode-browser', 'install'] },
+      output: { showAfter: '===', hideAfter: '===' },
+      locationChoices: { local: '2', global: '1' },
+      autoAnswers: [
+        { trigger: 'Install', response: 'y' },
+        { trigger: 'Choose config location', response: '__LOCATION__' },
+      ],
+    }),
+  },
+}))
+
+vi.mock('execa', () => ({
+  execa: vi.fn(),
+}))
+
+describe('installBrowser()', () => {
+  beforeEach(() => {
+    vi.clearAllMocks()
+  })
+
+  it('calls installer command from preset', async () => {
+    const { execa } = await import('execa')
+    const mockChild = {
+      stdout: { on: vi.fn() },
+      stderr: { on: vi.fn() },
+      stdin: { write: vi.fn() },
+      then: (cb) => cb({ exitCode: 0 }),
+    }
+    execa.mockReturnValue(mockChild)
+
+    await installBrowser()
+
+    expect(execa).toHaveBeenCalledWith('npx', expect.arrayContaining(['@different-ai/opencode-browser']), expect.any(Object))
+  })
+
+  it('logs success when exit code is 0', async () => {
+    const { execa } = await import('execa')
+    const mockChild = {
+      stdout: { on: vi.fn() },
+      stderr: { on: vi.fn() },
+      stdin: { write: vi.fn() },
+      then: (cb) => cb({ exitCode: 0 }),
+    }
+    execa.mockReturnValue(mockChild)
+    const { success } = await import('../../utils/exec.js')
+
+    await installBrowser()
+
+    expect(success).toHaveBeenCalledWith('opencode-browser installed')
+  })
+
+  it('logs warning when exit code is non-zero', async () => {
+    const { execa } = await import('execa')
+    const mockChild = {
+      stdout: { on: vi.fn() },
+      stderr: { on: vi.fn() },
+      stdin: { write: vi.fn() },
+      then: (cb) => cb({ exitCode: 1 }),
+    }
+    execa.mockReturnValue(mockChild)
+    const { warn } = await import('../../utils/exec.js')
+
+    await installBrowser()
+
+    expect(warn).toHaveBeenCalledWith('opencode-browser install exited with non-zero code')
+  })
+
+  it('resolves __LOCATION__ to local answer by default', async () => {
+    const { execa } = await import('execa')
+    let capturedTriggers = null
+    const mockChild = {
+      stdout: { on: vi.fn((_, cb) => { capturedTriggers = cb }) },
+      stderr: { on: vi.fn() },
+      stdin: { write: vi.fn() },
+      then: (cb) => cb({ exitCode: 0 }),
+    }
+    execa.mockReturnValue(mockChild)
+
+    await installBrowser()
+
+    if (capturedTriggers) capturedTriggers(Buffer.from('Choose config location'))
+    expect(mockChild.stdin.write).toHaveBeenCalledWith('2\n')
+  })
+
+  it('resolves __LOCATION__ to global answer when installScope is global', async () => {
+    const { execa } = await import('execa')
+    let capturedTriggers = null
+    const mockChild = {
+      stdout: { on: vi.fn((_, cb) => { capturedTriggers = cb }) },
+      stderr: { on: vi.fn() },
+      stdin: { write: vi.fn() },
+      then: (cb) => cb({ exitCode: 0 }),
+    }
+    execa.mockReturnValue(mockChild)
+
+    await installBrowser({ installScope: 'global' })
+
+    if (capturedTriggers) capturedTriggers(Buffer.from('Choose config location'))
+    expect(mockChild.stdin.write).toHaveBeenCalledWith('1\n')
+  })
+})