@rockysoft/opencode-hybrid-workflow 0.9.0 → 1.0.0

package/README.md

@@ -125,7 +125,7 @@ Confirm installation of Playwright and Firefox.
 
 ![Confirm browser installation](https://cdn.jsdelivr.net/npm/@rockysoft/opencode-hybrid-workflow@0.3.2-beta.3/docs/images/11-browser-confirm.png)
 
-Each reviewer gets an isolated browser for a captured frontend and disposable API fixtures. Ask the agent to add [repeatable browser checks](https://cdn.jsdelivr.net/npm/@rockysoft/opencode-hybrid-workflow@0.8.0/docs/browser-evidence.md). Live backend testing stays with your application's integration tests.
+Each reviewer gets an isolated browser for a captured frontend and disposable API fixtures. Ask the agent to add [repeatable browser checks](https://cdn.jsdelivr.net/npm/@rockysoft/opencode-hybrid-workflow@1.0.0/docs/browser-evidence.md). Live backend testing stays with your application's integration tests.
 
 ![Browser support installed](https://cdn.jsdelivr.net/npm/@rockysoft/opencode-hybrid-workflow@0.3.2-beta.3/docs/images/12-browser-ready.png)
 
@@ -175,10 +175,10 @@ Remove the old plugin entries from `opencode.json` and `cli.json` before adding
 
 </details>
 
-[Advanced configuration](https://cdn.jsdelivr.net/npm/@rockysoft/opencode-hybrid-workflow@0.4.0/docs/configuration.md) · [MIT license](https://cdn.jsdelivr.net/npm/@rockysoft/opencode-hybrid-workflow@0.4.0/LICENSE) · [Third-party notices](https://cdn.jsdelivr.net/npm/@rockysoft/opencode-hybrid-workflow@0.4.0/THIRD_PARTY_NOTICES.md)
+[Advanced configuration](https://cdn.jsdelivr.net/npm/@rockysoft/opencode-hybrid-workflow@1.0.0/docs/configuration.md) · [MIT license](https://cdn.jsdelivr.net/npm/@rockysoft/opencode-hybrid-workflow@1.0.0/LICENSE) · [Third-party notices](https://cdn.jsdelivr.net/npm/@rockysoft/opencode-hybrid-workflow@1.0.0/THIRD_PARTY_NOTICES.md)
 
-For deterministic Vitest projects, see [faster verification](https://cdn.jsdelivr.net/npm/@rockysoft/opencode-hybrid-workflow@0.7.0/docs/verification.md). Full checks remain the default; eligible projects automatically choose full checks when measured optimization overhead is higher.
+For deterministic Vitest projects, see [faster verification](https://cdn.jsdelivr.net/npm/@rockysoft/opencode-hybrid-workflow@1.0.0/docs/verification.md). Full checks remain the default; eligible projects automatically choose full checks when measured optimization overhead is higher.
 
-[Repeatable browser checks](https://cdn.jsdelivr.net/npm/@rockysoft/opencode-hybrid-workflow@0.8.0/docs/browser-evidence.md) capture changed frontend states once for both reviewers, while keeping their independent inspections and approval decisions.
-
-[Engineering handoffs](https://cdn.jsdelivr.net/npm/@rockysoft/opencode-hybrid-workflow@0.9.0/docs/engineering-handoffs.md) give implementation agents concrete responsibility and state ownership. Reviewers check the code against the plan; small changes keep existing patterns, with no file-length limits or extra planning phase.
+[Repeatable browser checks](https://cdn.jsdelivr.net/npm/@rockysoft/opencode-hybrid-workflow@1.0.0/docs/browser-evidence.md) capture changed frontend states once for both reviewers, while keeping their independent inspections and approval decisions.
+
+[Engineering handoffs](https://cdn.jsdelivr.net/npm/@rockysoft/opencode-hybrid-workflow@1.0.0/docs/engineering-handoffs.md) give implementation agents concrete responsibility and state ownership. Reviewers check the code against the plan; small changes keep existing patterns, with no file-length limits or extra planning phase.

package/assets/skills/ui-ux-pro-max/SKILL.md

@@ -2,13 +2,13 @@
 name: ui-ux-pro-max
 description: "Search local UI/UX references for palettes, typography, layout patterns, accessibility, and design systems. Use for new visual directions or focused design questions."
 ---
-
+
 ## OpenCode local setup
 
 User and repository requirements take precedence over generic style recommendations. Preserve an established design system unless a redesign was requested. Verify external APIs against current official documentation using Context7/webfetch; bundled reference data is not proof of current API behavior.
 
-Use actual screenshots for visual inspection and DOM/accessibility/interaction checks for behavior. Never infer visual approval from captions or hashes.
-
+Use actual screenshots for visual inspection and DOM/accessibility/interaction checks for behavior. Never infer visual approval from captions or hashes.
+
 
 # UI/UX Pro Max - Design Intelligence
 
@@ -45,11 +45,11 @@ For the full rule list per category (all 119 UX guidelines with rationale), read
 
 The search script lives inside this skill's own directory, not the project directory. Always invoke it by its full path — do not assume a particular working directory:
 
-```powershell
-python scripts/search.py "<query>" --domain <domain>
+```text
+<python3-executable> "<skill-directory>/scripts/search.py" "<query>" --domain <domain>
 ```
 
-The examples use the existing local Python 3.12 installation. The search tool needs no external Python packages. If this executable is missing, report that rather than silently installing a different runtime.
+The examples below are command templates, not literal shell commands. Replace `<skill-directory>` with the absolute directory containing this SKILL.md. On macOS/Linux, use `python3`; on Windows, use the configured Python 3 executable (usually `python` or `py -3`). If the executable path contains spaces, quote it; PowerShell additionally needs the call operator `&` before a quoted executable path. The plugin's automated research uses its configured `design.pythonExecutable` and resolves the script path itself. Do not assume a particular Python installation or shell. The search tool needs no external Python packages. If Python 3 is unavailable, report the missing prerequisite rather than silently installing another runtime.
 
 ## Workflow
 
@@ -81,23 +81,23 @@ Extract from the user request:
 
 Use `--design-system` when the task needs a coherent product-wide visual direction:
 
-```powershell
-python scripts/search.py "<product_type> <industry> <keywords>" --design-system [-p "Project Name"]
+```text
+<python3-executable> "<skill-directory>/scripts/search.py" "<product_type> <industry> <keywords>" --design-system [-p "Project Name"]
 ```
 
 This aggregates product/style/color/landing/typography matches, applies reasoning rules from `ui-reasoning.csv`, and returns pattern, style, colors, typography, effects, and anti-patterns to avoid.
 
 **Example:**
-```powershell
-python scripts/search.py "beauty spa wellness service" --design-system -p "Serenity Spa"
+```text
+<python3-executable> "<skill-directory>/scripts/search.py" "beauty spa wellness service" --design-system -p "Serenity Spa"
 ```
 
 ### Step 2b: Persist Design System (Master + Overrides Pattern)
 
 To save the design system for retrieval across sessions, add `--persist` **and always pass `--output-dir` pointed at the project root** — without it, files are written relative to whatever directory the tool happens to run from:
 
-```powershell
-python scripts/search.py "<query>" --design-system --persist -p "Project Name" --output-dir "<project-root>"
+```text
+<python3-executable> "<skill-directory>/scripts/search.py" "<query>" --design-system --persist -p "Project Name" --output-dir "<project-root>"
 ```
 
 This creates:
@@ -119,8 +119,8 @@ Read an existing `MASTER.md` before deciding whether `--force` is justified. Nev
 
 Three optional 1-10 sliders that tune `--design-system` output without changing your query. Add any combination of them to the same command:
 
-```powershell
-python scripts/search.py "<query>" --design-system --variance <1-10> --motion <1-10> --density <1-10>
+```text
+<python3-executable> "<skill-directory>/scripts/search.py" "<query>" --design-system --variance <1-10> --motion <1-10> --density <1-10>
 ```
 
 | Dial | Low (1-3) | Mid (4-7) | High (8-10) |
@@ -134,14 +134,14 @@ python scripts/search.py "<query>" --design-system --variance <1-10> --motion <1
 - Leaving a dial unset keeps that part of the output exactly as it was before (no behavior change).
 
 **Example:**
-```powershell
-python scripts/search.py "internal analytics dashboard" --design-system --variance 8 --motion 7 --density 8 -p "Ops Console"
+```text
+<python3-executable> "<skill-directory>/scripts/search.py" "internal analytics dashboard" --design-system --variance 8 --motion 7 --density 8 -p "Ops Console"
 ```
 
 ### Step 3: Supplement with Detailed Searches (as needed)
 
-```powershell
-python scripts/search.py "<keyword>" --domain <domain> [-n <max_results>]
+```text
+<python3-executable> "<skill-directory>/scripts/search.py" "<keyword>" --domain <domain> [-n <max_results>]
 ```
 
 | Need | Domain | Example |
@@ -163,8 +163,8 @@ Domain is auto-detected from the query if `--domain` is omitted — but auto-det
 
 ### Step 4: Stack Guidelines
 
-```powershell
-python scripts/search.py "<keyword>" --stack <stack>
+```text
+<python3-executable> "<skill-directory>/scripts/search.py" "<keyword>" --stack <stack>
 ```
 
 **Available stacks:** `react`, `nextjs`, `vue`, `svelte`, `astro`, `nuxtjs`, `nuxt-ui`, `angular`, `laravel`, `swiftui`, `react-native`, `flutter`, `jetpack-compose`, `html-tailwind`, `shadcn`, `threejs`, `javafx`, `wpf`, `winui`, `avalonia`, `uno`, `uwp`. Use the stack detected in Step 1.
@@ -182,15 +182,15 @@ Do not fabricate output. Instead:
 
 **User request:** "Make an AI search homepage." (stack detected as Next.js from `package.json`)
 
-```powershell
+```text
 # Step 2: design system
-python scripts/search.py "AI search tool modern minimal" --design-system -p "AI Search"
+<python3-executable> "<skill-directory>/scripts/search.py" "AI search tool modern minimal" --design-system -p "AI Search"
 
 # Step 3: supplement
-python scripts/search.py "keyboard focus modal" --domain ux
+<python3-executable> "<skill-directory>/scripts/search.py" "keyboard focus modal" --domain ux
 
 # Step 4: stack guidelines
-python scripts/search.py "suspense streaming bundle" --stack nextjs
+<python3-executable> "<skill-directory>/scripts/search.py" "suspense streaming bundle" --stack nextjs
 ```
 
 Then synthesize the design system + detailed searches and implement.
@@ -218,4 +218,4 @@ Then synthesize the design system + detailed searches and implement.
 
 ## Before Delivering App UI
 
-Read `references/pro-rules.md` and run through its canonical Pre-Delivery Checklist. It covers icon/visual-element discipline, interaction feedback, light/dark contrast, safe-area layout, and accessibility — scoped to native/mobile app UI (iOS/Android/React Native/Flutter).
+Read `references/pro-rules.md` and run through its canonical Pre-Delivery Checklist. It covers icon/visual-element discipline, interaction feedback, light/dark contrast, safe-area layout, and accessibility — scoped to native/mobile app UI (iOS/Android/React Native/Flutter).

package/cli.mjs

@@ -1,91 +1,91 @@
-#!/usr/bin/env node
-import {modelCatalog,selection,selectInteractively} from './lib/select-reviewers.mjs';
-import {lanes,reviewer} from './lib/reviewers.mjs';
-import {readFileSync,existsSync} from 'node:fs';
-import {spawnSync} from 'node:child_process';
-import path from 'node:path';
-import {readSettings,configDirectory,settingsFile,defaultSettings} from './lib/config.mjs';
-import {install,parseJsonc} from './lib/install.mjs';
-import {validateBrowser} from './lib/reviewer-browser.mjs';
-import {commandSpec,nativeCodex} from './lib/commands.mjs';
-import {requireSubscription,workerEnvironment} from './core/workers.mjs';
-const args=process.argv.slice(2),command=args.shift()??'help';
-function option(name){const i=args.indexOf(name);if(i<0)return undefined;const value=args[i+1];if(!value||value.startsWith('--'))throw Error(`Missing ${name} value.`);return value;}
-const root=path.resolve(option('--config-dir')??configDirectory());
-// An explicit CLI profile is a human-selected trust root, unlike project plugin options.
-process.env.OPENCODE_CONFIG_DIR=root;
-const opts={configFile:path.join(root,'hybrid','config.json')};
-async function main(){
- if(command==='init') {
-   const patch={};
-   if(option('--legacy-config')) {
-     const old=JSON.parse(readFileSync(path.resolve(option('--legacy-config')),'utf8'));
-     const project=option('--project');if(!project)throw Error('--legacy-config requires --project; history is mapped only for that project.');
-     const defaults=defaultSettings();
-     patch.reviewers={astra:{...defaults.reviewers.astra,...old.codex},opus:{...defaults.reviewers.opus,...old.claude}};
-     patch.legacyReviewerOverrides={...(existsSync(opts.configFile)?JSON.parse(readFileSync(opts.configFile,'utf8')).legacyReviewerOverrides:{}),[path.resolve(project)]:{reviewers:patch.reviewers,designAuthor:'opus',codex:patch.reviewers.astra,claude:patch.reviewers.opus}};
-     patch.verification={executable:old.pnpmExecutable??'pnpm',timeoutMs:0};
-     patch.projectRuntimeOverrides={...(existsSync(opts.configFile)?JSON.parse(readFileSync(opts.configFile,'utf8')).projectRuntimeOverrides:{}),[path.resolve(project)]:old.runtimeDirectory};
-     if(old.design?.pythonExecutable)patch.design={pythonExecutable:old.design.pythonExecutable};
-   }else if(!existsSync(opts.configFile)) {
-     patch.setupComplete=false;
-     try{const defaults=defaultSettings();defaults.reviewers.astra.executable=nativeCodex('codex');patch.reviewers=defaults.reviewers;}catch{/* doctor explains missing commands without preventing installation */}
-   }
-   console.log(JSON.stringify(install({root,settingsPatch:patch,replaceLegacyPackage:option('--legacy-config')?path.dirname(path.resolve(option('--legacy-config'))):undefined,apply:!args.includes('--dry-run')}),null,2));
-   return;
- }
- if(command==='config'){console.log(settingsFile(opts));return;}
- if(command==='browser') {
-   if(!args.includes('--enable')&&!args.includes('--disable'))throw Error('Use browser --enable or browser --disable.');
-   if(args.includes('--enable')&&args.includes('--disable'))throw Error('Choose enable or disable, not both.');
-   let reviewBrowser={enabled:false};
-   if(args.includes('--enable')) {
-     // Read only the human-owned GLOBAL config, never project-supplied executables.
-     const jsonc=path.join(root,'opencode.jsonc'),json=path.join(root,'opencode.json');
-     const oc=parseJsonc(readFileSync(existsSync(jsonc)?jsonc:json,'utf8'));
-     const server=oc.mcp?.servers?.playwright;
-     if(server?.type!=='local'||!Array.isArray(server.command))throw Error('Configure a local Playwright MCP in global OpenCode first, or set reviewBrowser.command in hybrid/config.json.');
-     // Keep executable + entry script only. Drop shared-profile/CDP/storage flags.
-     const boundary=server.command.findIndex((v,i)=>i>0&&v.startsWith('--'));
-     const command=server.command.slice(0,boundary<0?undefined:boundary);
-     if(command.some(v=>/^(-y|install|add)$/.test(v)))throw Error('Use an installed Playwright MCP command, not an on-demand package download.');
-     const browserAt=server.command.indexOf('--browser');
-     reviewBrowser={enabled:true,command,browser:browserAt>=0?server.command[browserAt+1]:'chrome',headless:true};
-     validateBrowser(reviewBrowser);commandSpec(command[0]);
-   }
-   console.log(JSON.stringify(install({root,settingsPatch:{reviewBrowser}}),null,2));
-   console.log('Reviewer browser setting saved. Restart OpenCode to load it. CLI and OpenCode-provider reviewers each receive their own isolated browser.');return;
- }
- if(command==='models') {console.log(JSON.stringify(modelCatalog(option('--project')??process.cwd()).map(m=>({provider:m.providerID,model:m.id,name:m.name,variants:(m.variants??[]).map(v=>v.id),images:m.capabilities.input.includes('image')})),null,2));return;}
- if(command==='configure') {
-   const config=readSettings(opts);let patch;
-   if(option('--reviewer1')) {
-     const first=option('--reviewer1'),second=option('--reviewer2')??'none';
-     const catalog=[first,second].some(v=>v.startsWith('opencode:'))?modelCatalog(option('--project')??process.cwd()):[];
-     const reviewers={astra:selection(first,{catalog,previous:config.reviewers.astra,variant:option('--variant1')}),opus:selection(second,{catalog,previous:config.reviewers.opus??{},variant:option('--variant2')})};
-     if(!reviewers.astra)throw Error('Reviewer 1 is required.');
-     const designAuthor=option('--lead')==='1'?'astra':reviewers.opus?'opus':'astra';
-     patch={reviewers,designAuthor};
-   }else patch=await selectInteractively(config);
-   console.log(JSON.stringify(install({root,settingsPatch:{...patch,setupComplete:true}}),null,2));
-   console.log('Reviewer defaults saved for new tasks. Active tasks retain their original reviewer assignments and findings.');return;
- }
-
- if(command==='doctor') {
-   const config=readSettings(opts),checks=[];
-   function check(name,run){try{checks.push({name,ok:true,...run()});}catch(error){checks.push({name,ok:false,error:error.message});}}
-   const version=executable=>{const spec=commandSpec(executable);const r=spawnSync(spec.executable,[...spec.args,'--version'],{encoding:'utf8',windowsHide:true,env:workerEnvironment(),timeout:15000});if(r.status!==0)throw Error('Version check failed; check executable installation.');return {version:(r.stdout||r.stderr).trim().split('\n')[0]};};
-   check('OpenCode',()=>{const result=version('opencode');if(!/^(?:opencode\s+v?)?2\./i.test(result.version))throw Error('OpenCode 2 is required.');return result;});
-   for(const who of lanes(config))check(who,()=>{const lane=reviewer(config,who);if(lane.adapter==='opencode'){const catalog=modelCatalog();selection(`opencode:${lane.providerID}/${lane.model}`,{catalog,variant:lane.variant});return {adapter:lane.adapter,model:lane.model,variant:lane.variant??'default',catalogVerified:true};}const result=version(lane.executable);if(!args.includes('--no-auth'))requireSubscription(who,config,root);return {...result,model:lane.model,effort:lane.effort,authChecked:!args.includes('--no-auth')};});
-   check('git',()=>version('git'));check('verification',()=>version(config.pnpmExecutable));check('design Python',()=>version(config.design.pythonExecutable));
-   if(config.reviewBrowser?.enabled)check('reviewer browser',()=>{const b=config.reviewBrowser;validateBrowser(b);const spec=commandSpec(b.command[0]);const r=spawnSync(spec.executable,[...spec.args,...b.command.slice(1),'--version'],{encoding:'utf8',windowsHide:true,env:workerEnvironment(),timeout:15000});if(r.status!==0)throw Error('Playwright MCP version check failed.');return {version:r.stdout.trim(),browser:b.browser??'chrome',scope:'CLI and OpenCode-provider reviewers; separate isolated sessions'};});
-   for(const skill of ['frontend-design','ui-ux-pro-max','web-design-guidelines'])check(skill,()=>{if(!existsSync(path.join(config.design.skillsDirectory,skill,'SKILL.md')))throw Error('Missing bundled skill');return {};});
-   console.log(JSON.stringify({configFile:opts.configFile,platform:process.platform,checks,modelCalls:0},null,2));
-   if(checks.some(c=>!c.ok))process.exitCode=1;
-   return;
- }
- if(command!=='help')throw Error(`Unknown command: ${command}`);
- console.log('opencode-hybrid browser --enable|--disable [--config-dir PATH] (independent reviewer browsers)');
- console.log('opencode-hybrid configure [--config-dir PATH] (interactive reviewer selection)\nopencode-hybrid models [--project PATH]\nopencode-hybrid configure --reviewer1 SOURCE:MODEL --reviewer2 SOURCE:MODEL|none [--variant1 NAME] [--variant2 NAME] [--lead 1|2]\nopencode-hybrid init [--config-dir PATH] [--dry-run]\nopencode-hybrid doctor [--config-dir PATH] [--no-auth]\nopencode-hybrid config [--config-dir PATH]\nMigration: init --legacy-config FILE --project PROJECT\nAfter init, open any project with ordinary opencode. Configuration is user-owned; installation never copies credentials.');
-}
-main().catch(error=>{console.error(error.message);process.exitCode=1;});
+#!/usr/bin/env node
+import {modelCatalog,selection,selectInteractively} from './lib/select-reviewers.mjs';
+import {lanes,reviewer} from './lib/reviewers.mjs';
+import {readFileSync,existsSync} from 'node:fs';
+import {spawnSync} from 'node:child_process';
+import path from 'node:path';
+import {readSettings,configDirectory,settingsFile,defaultSettings} from './lib/config.mjs';
+import {install,parseJsonc} from './lib/install.mjs';
+import {validateBrowser} from './lib/reviewer-browser.mjs';
+import {commandSpec,nativeCodex} from './lib/commands.mjs';
+import {requireCliAuthentication,workerEnvironment} from './core/workers.mjs';
+const args=process.argv.slice(2),command=args.shift()??'help';
+function option(name){const i=args.indexOf(name);if(i<0)return undefined;const value=args[i+1];if(!value||value.startsWith('--'))throw Error(`Missing ${name} value.`);return value;}
+const root=path.resolve(option('--config-dir')??configDirectory());
+// An explicit CLI profile is a human-selected trust root, unlike project plugin options.
+process.env.OPENCODE_CONFIG_DIR=root;
+const opts={configFile:path.join(root,'hybrid','config.json')};
+async function main(){
+ if(command==='init') {
+   const patch={};
+   if(option('--legacy-config')) {
+     const old=JSON.parse(readFileSync(path.resolve(option('--legacy-config')),'utf8'));
+     const project=option('--project');if(!project)throw Error('--legacy-config requires --project; history is mapped only for that project.');
+     const defaults=defaultSettings();
+     patch.reviewers={astra:{...defaults.reviewers.astra,...old.codex},opus:{...defaults.reviewers.opus,...old.claude}};
+     patch.legacyReviewerOverrides={...(existsSync(opts.configFile)?JSON.parse(readFileSync(opts.configFile,'utf8')).legacyReviewerOverrides:{}),[path.resolve(project)]:{reviewers:patch.reviewers,designAuthor:'opus',codex:patch.reviewers.astra,claude:patch.reviewers.opus}};
+     patch.verification={executable:old.pnpmExecutable??'pnpm',timeoutMs:0};
+     patch.projectRuntimeOverrides={...(existsSync(opts.configFile)?JSON.parse(readFileSync(opts.configFile,'utf8')).projectRuntimeOverrides:{}),[path.resolve(project)]:old.runtimeDirectory};
+     if(old.design?.pythonExecutable)patch.design={pythonExecutable:old.design.pythonExecutable};
+   }else if(!existsSync(opts.configFile)) {
+     patch.setupComplete=false;
+     try{const defaults=defaultSettings();defaults.reviewers.astra.executable=nativeCodex('codex');patch.reviewers=defaults.reviewers;}catch{/* doctor explains missing commands without preventing installation */}
+   }
+   console.log(JSON.stringify(install({root,settingsPatch:patch,replaceLegacyPackage:option('--legacy-config')?path.dirname(path.resolve(option('--legacy-config'))):undefined,apply:!args.includes('--dry-run')}),null,2));
+   return;
+ }
+ if(command==='config'){console.log(settingsFile(opts));return;}
+ if(command==='browser') {
+   if(!args.includes('--enable')&&!args.includes('--disable'))throw Error('Use browser --enable or browser --disable.');
+   if(args.includes('--enable')&&args.includes('--disable'))throw Error('Choose enable or disable, not both.');
+   let reviewBrowser={enabled:false};
+   if(args.includes('--enable')) {
+     // Read only the human-owned GLOBAL config, never project-supplied executables.
+     const jsonc=path.join(root,'opencode.jsonc'),json=path.join(root,'opencode.json');
+     const oc=parseJsonc(readFileSync(existsSync(jsonc)?jsonc:json,'utf8'));
+     const server=oc.mcp?.servers?.playwright;
+     if(server?.type!=='local'||!Array.isArray(server.command))throw Error('Configure a local Playwright MCP in global OpenCode first, or set reviewBrowser.command in hybrid/config.json.');
+     // Keep executable + entry script only. Drop shared-profile/CDP/storage flags.
+     const boundary=server.command.findIndex((v,i)=>i>0&&v.startsWith('--'));
+     const command=server.command.slice(0,boundary<0?undefined:boundary);
+     if(command.some(v=>/^(-y|install|add)$/.test(v)))throw Error('Use an installed Playwright MCP command, not an on-demand package download.');
+     const browserAt=server.command.indexOf('--browser');
+     reviewBrowser={enabled:true,command,browser:browserAt>=0?server.command[browserAt+1]:'chrome',headless:true};
+     validateBrowser(reviewBrowser);commandSpec(command[0]);
+   }
+   console.log(JSON.stringify(install({root,settingsPatch:{reviewBrowser}}),null,2));
+   console.log('Reviewer browser setting saved. Restart OpenCode to load it. CLI and OpenCode-provider reviewers each receive their own isolated browser.');return;
+ }
+ if(command==='models') {console.log(JSON.stringify(modelCatalog(option('--project')??process.cwd()).map(m=>({provider:m.providerID,model:m.id,name:m.name,variants:(m.variants??[]).map(v=>v.id),images:m.capabilities.input.includes('image')})),null,2));return;}
+ if(command==='configure') {
+   const config=readSettings(opts);let patch;
+   if(option('--reviewer1')) {
+     const first=option('--reviewer1'),second=option('--reviewer2')??'none';
+     const catalog=[first,second].some(v=>v.startsWith('opencode:'))?modelCatalog(option('--project')??process.cwd()):[];
+     const reviewers={astra:selection(first,{catalog,previous:config.reviewers.astra,variant:option('--variant1')}),opus:selection(second,{catalog,previous:config.reviewers.opus??{},variant:option('--variant2')})};
+     if(!reviewers.astra)throw Error('Reviewer 1 is required.');
+     const designAuthor=option('--lead')==='1'?'astra':reviewers.opus?'opus':'astra';
+     patch={reviewers,designAuthor};
+   }else patch=await selectInteractively(config);
+   console.log(JSON.stringify(install({root,settingsPatch:{...patch,setupComplete:true}}),null,2));
+   console.log('Reviewer defaults saved for new tasks. Active tasks retain their original reviewer assignments and findings.');return;
+ }
+
+ if(command==='doctor') {
+   const config=readSettings(opts),checks=[];
+   function check(name,run){try{checks.push({name,ok:true,...run()});}catch(error){checks.push({name,ok:false,error:error.message});}}
+   const version=executable=>{const spec=commandSpec(executable);const r=spawnSync(spec.executable,[...spec.args,'--version'],{encoding:'utf8',windowsHide:true,env:workerEnvironment(),timeout:15000});if(r.status!==0)throw Error('Version check failed; check executable installation.');return {version:(r.stdout||r.stderr).trim().split('\n')[0]};};
+   check('OpenCode',()=>{const result=version('opencode');if(!/^(?:opencode\s+v?)?2\./i.test(result.version))throw Error('OpenCode 2 is required.');return result;});
+   for(const who of lanes(config))check(who,()=>{const lane=reviewer(config,who);if(lane.adapter==='opencode'){const catalog=modelCatalog();selection(`opencode:${lane.providerID}/${lane.model}`,{catalog,variant:lane.variant});return {adapter:lane.adapter,model:lane.model,variant:lane.variant??'default',catalogVerified:true};}const result=version(lane.executable);if(!args.includes('--no-auth'))requireCliAuthentication(who,config,root);return {...result,model:lane.model,effort:lane.effort,authChecked:!args.includes('--no-auth')};});
+   check('git',()=>version('git'));check('verification',()=>version(config.pnpmExecutable));check('design Python',()=>version(config.design.pythonExecutable));
+   if(config.reviewBrowser?.enabled)check('reviewer browser',()=>{const b=config.reviewBrowser;validateBrowser(b);const spec=commandSpec(b.command[0]);const r=spawnSync(spec.executable,[...spec.args,...b.command.slice(1),'--version'],{encoding:'utf8',windowsHide:true,env:workerEnvironment(),timeout:15000});if(r.status!==0)throw Error('Playwright MCP version check failed.');return {version:r.stdout.trim(),browser:b.browser??'chrome',scope:'CLI and OpenCode-provider reviewers; separate isolated sessions'};});
+   for(const skill of ['frontend-design','ui-ux-pro-max','web-design-guidelines'])check(skill,()=>{if(!existsSync(path.join(config.design.skillsDirectory,skill,'SKILL.md')))throw Error('Missing bundled skill');return {};});
+   console.log(JSON.stringify({configFile:opts.configFile,platform:process.platform,checks,modelCalls:0},null,2));
+   if(checks.some(c=>!c.ok))process.exitCode=1;
+   return;
+ }
+ if(command!=='help')throw Error(`Unknown command: ${command}`);
+ console.log('opencode-hybrid browser --enable|--disable [--config-dir PATH] (independent reviewer browsers)');
+ console.log('opencode-hybrid configure [--config-dir PATH] (interactive reviewer selection)\nopencode-hybrid models [--project PATH]\nopencode-hybrid configure --reviewer1 SOURCE:MODEL --reviewer2 SOURCE:MODEL|none [--variant1 NAME] [--variant2 NAME] [--lead 1|2]\nopencode-hybrid init [--config-dir PATH] [--dry-run]\nopencode-hybrid doctor [--config-dir PATH] [--no-auth]\nopencode-hybrid config [--config-dir PATH]\nMigration: init --legacy-config FILE --project PROJECT\nAfter init, open any project with ordinary opencode. Configuration is user-owned; installation never copies credentials.');
+}
+main().catch(error=>{console.error(error.message);process.exitCode=1;});