create-harness-vibe-coding 0.8.18 → 0.8.19

package/src/index.js

@@ -2,7 +2,7 @@
 import * as p from '@clack/prompts';
 import fs from 'node:fs';
 import path from 'node:path';
-import { spawnSync } from 'node:child_process';
+import { spawn, spawnSync } from 'node:child_process';
 import pc from 'picocolors';
 import { askConflictPolicy, askInstallScope, askOptionalSelections, askProjectName, askTargetDir } from './prompts.js';
 import { generate, getOptionalCatalog } from './generator.js';
@@ -10,37 +10,55 @@ import { generate, getOptionalCatalog } from './generator.js';
 const UPDATE_SUCCESS_STATUSES = new Set(['up-to-date', 'update-available', 'partial-update']);
 const UPDATE_FAILURE_STATUSES = new Set(['error', 'offline', 'template-remote', 'downgrade-refused']);
 const CANONICAL_UPDATE_SOURCE_BASE = 'https://raw.githubusercontent.com/LiWeny16/create-harness-vibe-coding/main/templates/common/';
-
-// ── CLI flags ──────────────────────────────────────────────
-const raw = process.argv.slice(2);
+
+// ── CLI flags ──────────────────────────────────────────────
+const raw = process.argv.slice(2);
+function extractFlag(args, flag) {
+  const idx = args.indexOf(flag);
+  if (idx !== -1 && idx + 1 < args.length) return args[idx + 1];
+  const withEquals = args.find(arg => arg.startsWith(`${flag}=`));
+  if (withEquals) return withEquals.slice(flag.length + 1);
+  return null;
+}
+function hasFlag(args, flag) {
+  return args.includes(flag);
+}
+
+// wf-ui subcommand: handle before parseArgs so --project/--port/--open flags
+// never fall through to the scaffold installer.
+if (raw[0] === 'wf-ui') {
+  await runWfUi(raw.slice(1));
+  process.exit(0);
+}
+
 const parsed = parseArgs(raw);
 const showHelp = parsed.flags.help || parsed.flags.h;
 const skipPrompts = parsed.flags.yes || parsed.flags.y;
 const conflictPolicyProvided = parsed.flags.onConflict !== undefined;
-
-if (parsed.errors.length > 0) {
-  for (const err of parsed.errors) {
-    console.error(pc.red(`Error: ${err}`));
-  }
-  process.exit(1);
-}
-
-if (showHelp) {
-  console.log('');
-  console.log('  create-harness-vibe-coding');
-  console.log('');
-  console.log('  Usage:');
-  console.log('    npx create-harness-vibe-coding@latest [project-name] [target-dir] [flags]');
-  console.log('');
-  console.log('  Arguments:');
-  console.log('    project-name   Name for the new project (default: my-vibe-project)');
-  console.log('    target-dir     Directory to create the project in (default: ./<project-name>)');
-  console.log('');
-  console.log('  Flags:');
-  console.log('    -y, --yes                    Skip all prompts, use defaults or provided args');
-  console.log('    -h, --help                   Show this help');
-  console.log('    --dry-run                    Print the planned writes without creating files');
-  console.log('    --on-conflict <policy>       fail, skip, backup, or overwrite (default: fail)');
+
+if (parsed.errors.length > 0 && raw[0] !== 'wf-ui') {
+  for (const err of parsed.errors) {
+    console.error(pc.red(`Error: ${err}`));
+  }
+  process.exit(1);
+}
+
+if (showHelp) {
+  console.log('');
+  console.log('  create-harness-vibe-coding');
+  console.log('');
+  console.log('  Usage:');
+  console.log('    npx create-harness-vibe-coding@latest [project-name] [target-dir] [flags]');
+  console.log('');
+  console.log('  Arguments:');
+  console.log('    project-name   Name for the new project (default: my-vibe-project)');
+  console.log('    target-dir     Directory to create the project in (default: ./<project-name>)');
+  console.log('');
+  console.log('  Flags:');
+  console.log('    -y, --yes                    Skip all prompts, use defaults or provided args');
+  console.log('    -h, --help                   Show this help');
+  console.log('    --dry-run                    Print the planned writes without creating files');
+  console.log('    --on-conflict <policy>       fail, skip, backup, or overwrite (default: fail)');
   console.log('    --with <id,id>               Add optional local workflow skills');
   console.log('    --without <id,id>            Remove optional workflow skills selected by --preset or --with');
   console.log('    --recommend <id,id>          Record recommendation-only external capabilities');
@@ -52,35 +70,35 @@ if (showHelp) {
   console.log('    --json                       Output machine-readable JSON (use with --dry-run for planning)');
   console.log('');
   console.log('  Interactive mode offers checkbox selection for optional workflows and external recommendations.');
-  console.log('');
-  console.log('  Examples:');
-  console.log('    npx create-harness-vibe-coding@latest');
-  console.log('    npx create-harness-vibe-coding@latest -y');
-  console.log('    npx create-harness-vibe-coding@latest my-project');
-  console.log('    npx create-harness-vibe-coding@latest my-project ./dist/my-project -y');
-  console.log('    npx create-harness-vibe-coding@latest legacy ./legacy -y --dry-run');
-  console.log('    npx create-harness-vibe-coding@latest legacy ./legacy -y --on-conflict skip');
+  console.log('');
+  console.log('  Examples:');
+  console.log('    npx create-harness-vibe-coding@latest');
+  console.log('    npx create-harness-vibe-coding@latest -y');
+  console.log('    npx create-harness-vibe-coding@latest my-project');
+  console.log('    npx create-harness-vibe-coding@latest my-project ./dist/my-project -y');
+  console.log('    npx create-harness-vibe-coding@latest legacy ./legacy -y --dry-run');
+  console.log('    npx create-harness-vibe-coding@latest legacy ./legacy -y --on-conflict skip');
   console.log('    npx create-harness-vibe-coding@latest web ./web -y --with ts-react-frontend,ui-ux-review');
   console.log('    npx create-harness-vibe-coding@latest web ./web -y --preset web-app');
   console.log('    npx create-harness-vibe-coding@latest api ./api -y --preset fullstack --without github-pr-review');
   console.log('    npx create-harness-vibe-coding@latest app ./app -y --install-scope global');
-  console.log('');
-  process.exit(0);
-}
-
-if (parsed.flags.listOptions) {
-  printOptions();
-  process.exit(0);
-}
-
-// Positional args (non-flag)
-const positional = parsed.positionals;
-const argName = positional[0];
-const argDir = positional[1];
-const generationOptions = {
-  dryRun: Boolean(parsed.flags.dryRun),
-  onConflict: parsed.flags.onConflict || 'fail',
-  withOptions: parsed.flags.with || [],
+  console.log('');
+  process.exit(0);
+}
+
+if (parsed.flags.listOptions) {
+  printOptions();
+  process.exit(0);
+}
+
+// Positional args (non-flag)
+const positional = parsed.positionals;
+const argName = positional[0];
+const argDir = positional[1];
+const generationOptions = {
+  dryRun: Boolean(parsed.flags.dryRun),
+  onConflict: parsed.flags.onConflict || 'fail',
+  withOptions: parsed.flags.with || [],
   withoutOptions: parsed.flags.without || [],
   externalOptions: parsed.flags.recommend || [],
   preset: parsed.flags.preset,
@@ -89,10 +107,10 @@ const generationOptions = {
   hostGlobalDir: parsed.flags.hostGlobalDir,
   json: Boolean(parsed.flags.json),
 };
-
-const DEFAULT_NAME = 'my-vibe-project';
-
-// --json: machine-readable output, no prompts, no decorative output
+
+const DEFAULT_NAME = 'my-vibe-project';
+
+// --json: machine-readable output, no prompts, no decorative output
 if (generationOptions.json) {
   const projectName = argName || DEFAULT_NAME;
   const targetDir = argDir || `./${projectName}`;
@@ -116,20 +134,22 @@ if (generationOptions.json) {
     scan,
   });
   printJsonResult(result);
-  // printJsonResult exits with 1 on failure; we only reach here on success
-  process.exit(0);
-}
-
-console.log('');
-console.log(pc.magenta('╔══════════════════════════════════════════╗'));
-console.log(pc.magenta('║   create-harness-vibe-coding             ║'));
-console.log(pc.magenta('║   0-1 Product Harness Scaffold           ║'));
-console.log(pc.magenta('╚══════════════════════════════════════════╝'));
-console.log('');
-
-let projectName, targetDir;
-
-// Non-interactive: positionals provided OR -y/--yes flag set
+  // printJsonResult exits with 1 on failure; we only reach here on success
+  process.exit(0);
+}
+
+console.log('');
+console.log(pc.magenta('╔══════════════════════════════════════════╗'));
+console.log(pc.magenta('║   create-harness-vibe-coding             ║'));
+console.log(pc.magenta('║   0-1 Product Harness Scaffold           ║'));
+console.log(pc.magenta('╚══════════════════════════════════════════╝'));
+console.log('');
+
+let projectName, targetDir;
+
+// wf-ui: server already running, skip the scaffold/update flow
+if (raw[0] !== 'wf-ui') {
+// Non-interactive: positionals provided OR -y/--yes flag set
 if (argName || skipPrompts) {
   projectName = argName || DEFAULT_NAME;
   targetDir = argDir || `./${projectName}`;
@@ -157,39 +177,39 @@ if (argName || skipPrompts) {
     ? 'project bridge/state/settings + global runtime + Claude/Codex/OpenCode host copies'
     : 'CLAUDE.md, README.md, Harness/PROGRESS.md, Harness/, .claude/, .agents/, .opencode/, opencode.json, tests/';
   console.log(`  Creates     ${pc.cyan(creates)}`);
-  if (generationOptions.dryRun) {
+  if (generationOptions.dryRun) {
     console.log(`  Mode        ${pc.yellow('dry-run')}`);
-  }
-  console.log(`  Conflicts   ${pc.cyan(generationOptions.onConflict)}`);
-  if (generationOptions.withOptions.length > 0) {
-    console.log(`  Optional    ${pc.cyan(generationOptions.withOptions.join(','))}`);
-  }
+  }
+  console.log(`  Conflicts   ${pc.cyan(generationOptions.onConflict)}`);
+  if (generationOptions.withOptions.length > 0) {
+    console.log(`  Optional    ${pc.cyan(generationOptions.withOptions.join(','))}`);
+  }
   if (generationOptions.withoutOptions.length > 0) {
     console.log(`  Without     ${pc.cyan(generationOptions.withoutOptions.join(','))}`);
   }
   if (generationOptions.externalOptions.length > 0) {
     console.log(`  Recommend   ${pc.cyan(generationOptions.externalOptions.join(','))}`);
   }
-  if (generationOptions.preset) {
-    console.log(`  Preset      ${pc.cyan(generationOptions.preset)}`);
-  }
-  if (skipPrompts) {
-    console.log(`  Mode        ${pc.dim('non-interactive (-y)')}`);
-  }
-  console.log(pc.dim('────────────────────────────────────────────'));
-  console.log('');
-
-  const result = generate({ projectName, targetDir, ...generationOptions });
-  printResult(result, targetDir);
-} else {
-  // Interactive mode
-  try {
-    projectName = await askProjectName();
-  } catch {
-    projectName = 'my-vibe-project';
-    console.log(pc.dim(`  Project: ${projectName} (default)`));
-  }
-
+  if (generationOptions.preset) {
+    console.log(`  Preset      ${pc.cyan(generationOptions.preset)}`);
+  }
+  if (skipPrompts) {
+    console.log(`  Mode        ${pc.dim('non-interactive (-y)')}`);
+  }
+  console.log(pc.dim('────────────────────────────────────────────'));
+  console.log('');
+
+  const result = generate({ projectName, targetDir, ...generationOptions });
+  printResult(result, targetDir);
+} else {
+  // Interactive mode
+  try {
+    projectName = await askProjectName();
+  } catch {
+    projectName = 'my-vibe-project';
+    console.log(pc.dim(`  Project: ${projectName} (default)`));
+  }
+
   try {
     targetDir = await askTargetDir(projectName);
   } catch {
@@ -240,9 +260,9 @@ if (argName || skipPrompts) {
       console.log(pc.dim('  Optional: none (default)'));
     }
   }
-
-  console.log('');
-  console.log(pc.dim('────────────────────────────────────────────'));
+
+  console.log('');
+  console.log(pc.dim('────────────────────────────────────────────'));
   console.log(`  Project     ${pc.green(projectName)}`);
   console.log(`  Directory   ${pc.green(targetDir)}`);
   console.log(`  Scope       ${pc.green(generationOptions.installScope)}`);
@@ -263,14 +283,14 @@ if (argName || skipPrompts) {
   if (generationOptions.externalOptions.length > 0) {
     console.log(`  Recommend   ${pc.cyan(generationOptions.externalOptions.join(','))}`);
   }
-  console.log(pc.dim('────────────────────────────────────────────'));
-  console.log('');
-
-  const preview = generate({ projectName, targetDir, ...generationOptions, dryRun: true });
-  if (!preview.success) {
-    printResult(preview, targetDir);
-  }
-
+  console.log(pc.dim('────────────────────────────────────────────'));
+  console.log('');
+
+  const preview = generate({ projectName, targetDir, ...generationOptions, dryRun: true });
+  if (!preview.success) {
+    printResult(preview, targetDir);
+  }
+
   console.log(pc.yellow('Planned changes: no files have been written yet.'));
   console.log(pc.bold('Project plan:'));
   printSummary(preview.summary);
@@ -284,34 +304,34 @@ if (argName || skipPrompts) {
   printHostPlans(preview.hostPlans, preview.hostSummary);
   printWarnings(preview);
   console.log('');
-
-  if (generationOptions.dryRun) {
-    process.exit(0);
-  }
-
-  let proceed = true;
-  try {
-    proceed = await p.confirm({
-      message: 'Confirm generation with this plan?',
-      initialValue: true,
-    });
-    if (p.isCancel(proceed)) proceed = false;
-  } catch {
-    proceed = true;
-  }
-
-  if (!proceed) {
-    p.cancel('Cancelled');
-    process.exit(0);
-  }
-
-  console.log('');
-  const result = generate({ projectName, targetDir, ...generationOptions });
-  printResult(result, targetDir);
-}
-
-function printResult(result, targetDir) {
-  if (result.success) {
+
+  if (generationOptions.dryRun) {
+    process.exit(0);
+  }
+
+  let proceed = true;
+  try {
+    proceed = await p.confirm({
+      message: 'Confirm generation with this plan?',
+      initialValue: true,
+    });
+    if (p.isCancel(proceed)) proceed = false;
+  } catch {
+    proceed = true;
+  }
+
+  if (!proceed) {
+    p.cancel('Cancelled');
+    process.exit(0);
+  }
+
+  console.log('');
+  const result = generate({ projectName, targetDir, ...generationOptions });
+  printResult(result, targetDir);
+}
+
+function printResult(result, targetDir) {
+  if (result.success) {
     if (result.dryRun) {
       console.log(pc.yellow('\nDry run: no files or directories were written.'));
       console.log(pc.bold('Project plan:'));
@@ -325,14 +345,14 @@ function printResult(result, targetDir) {
       }
       printHostPlans(result.hostPlans, result.hostSummary);
       if (result.warnings.length > 0) {
-        console.log(pc.yellow('\nWarning(s):'));
-        for (const warning of result.warnings) {
-          console.log(pc.yellow(`  - ${warning}`));
-        }
-      }
-      console.log('');
-      return;
-    }
+        console.log(pc.yellow('\nWarning(s):'));
+        for (const warning of result.warnings) {
+          console.log(pc.yellow(`  - ${warning}`));
+        }
+      }
+      console.log('');
+      return;
+    }
 
     console.log(pc.green('\nGeneration complete.\n'));
     console.log(pc.bold('Project install:'));
@@ -345,86 +365,182 @@ function printResult(result, targetDir) {
     printHostPlans(result.hostPlans, result.hostSummary, { summaryOnly: true });
 
     printWarnings(result);
-
+
     console.log(pc.bold('Next steps:'));
     console.log(`  ${pc.cyan(`cd ${targetDir}`)}`);
-    console.log(`  ${pc.cyan('claude')}                          # Start Claude Code`);
-    console.log(`  ${pc.cyan('codex')}                           # Or start Codex`);
-    console.log(`  ${pc.cyan('opencode')}                        # Or start OpenCode`);
+    console.log(`  ${pc.cyan('claude')}                          # Start Claude Code`);
+    console.log(`  ${pc.cyan('codex')}                           # Or start Codex`);
+    console.log(`  ${pc.cyan('opencode')}                        # Or start OpenCode`);
     console.log(`  Tell your agent: "${pc.yellow('Read Harness/specs/guides/SETUP.md. Bootstrap this project from idea to first vertical slice.')}"`);
-    console.log('');
+    console.log('');
     console.log(pc.dim('  Keep Harness/specs/guides/SETUP.md as a setup reference; normal sessions start at CLAUDE.md, with Harness/README.md as the routed workflow router.'));
-    console.log('');
-
-  } else {
-    console.log(pc.red('\nGeneration failed:'));
-    for (const err of result.errors) {
-      console.log(pc.red(`  - ${err}`));
-    }
-    process.exit(1);
-  }
-}
-
-function parseArgs(args) {
-  const flags = {
-    with: [],
-    without: [],
-  };
-  const positionals = [];
-  const errors = [];
-
-  function readValue(flagName, index) {
-    const value = args[index + 1];
-    if (!value || value.startsWith('-')) {
-      errors.push(`${flagName} requires a value`);
-      return { value: undefined, nextIndex: index };
-    }
-    return { value, nextIndex: index + 1 };
-  }
-
-  function readEqualsValue(flagName, value) {
-    if (!value || value.startsWith('-')) {
-      errors.push(`${flagName} requires a value`);
-      return undefined;
-    }
-    return value;
-  }
-
-  for (let i = 0; i < args.length; i += 1) {
-    const arg = args[i];
-
-    if (arg === '-h') {
-      flags.h = true;
-    } else if (arg === '--help') {
-      flags.help = true;
-    } else if (arg === '-y') {
-      flags.y = true;
-    } else if (arg === '--yes') {
-      flags.yes = true;
-    } else if (arg === '--dry-run') {
-      flags.dryRun = true;
+    console.log('');
+
+  } else {
+    console.log(pc.red('\nGeneration failed:'));
+    for (const err of result.errors) {
+      console.log(pc.red(`  - ${err}`));
+    }
+    process.exit(1);
+  }
+}
+} // wf-ui skip block end — functions below are module-scoped
+
+async function runWfUi(args) {
+  const projectRoot = extractFlag(args, '--project') || process.cwd();
+  const host = extractFlag(args, '--host') || '127.0.0.1';
+  const rawPort = extractFlag(args, '--port') || '0';
+  const port = Number.parseInt(rawPort, 10);
+  const openBrowser = !hasFlag(args, '--no-open');
+
+  if (host !== '127.0.0.1') {
+    console.error('[wf-ui] host must be 127.0.0.1');
+    process.exit(1);
+  }
+  if (!Number.isInteger(port) || port < 0 || port > 65535) {
+    console.error('[wf-ui] port must be an integer from 0 to 65535');
+    process.exit(1);
+  }
+
+  try {
+    const serverModule = await import('./wf-ui-server/server.mjs');
+    const { SessionRegistry } = await import('./wf-ui-server/session-registry.mjs');
+    const { attachEventsWs } = await import('./wf-ui-server/ws-events.mjs');
+    const { attachTerminalWs } = await import('./wf-ui-server/ws-terminal.mjs');
+    const { warmRuntimeCache } = await import('./wf-ui-server/runtime-detector.mjs');
+    const { appendSessionEvent, appendTerminalData, persistSession, recordInputRequest } =
+      await import('./wf-ui-server/terminal-store.mjs');
+    const registry = new SessionRegistry();
+    const terminalHub = {};
+    const started = await serverModule.startServer({
+      projectRoot,
+      host,
+      port,
+      sessionRegistry: registry,
+      terminalHub,
+    });
+    attachEventsWs(started.server, started.token, projectRoot);
+    Object.assign(terminalHub, attachTerminalWs(started.server, started.token, registry, {
+      onTerminalInput(session, data) {
+        try {
+          recordInputRequest(projectRoot, session.sessionId, data);
+        } catch {
+          // The session may not have been persisted yet; stdout/stderr capture still remains authoritative.
+        }
+        appendTerminalData(projectRoot, session, data, 'stdin');
+      },
+      onAttachModeChange(session, attachMode) {
+        persistSession(projectRoot, session);
+        appendSessionEvent(projectRoot, session, { type: 'session.attach-mode', attachMode });
+      },
+      onSessionState(session, state) {
+        persistSession(projectRoot, session);
+        appendSessionEvent(projectRoot, session, { type: 'session.state', state });
+      },
+    }));
+    warmRuntimeCache();
+    console.log(`[wf-ui] ${started.url}`);
+    if (openBrowser) openLocalUrl(started.url);
+    await waitForWfUiShutdown(started.server);
+  } catch (err) {
+    console.error(`[wf-ui] ${err.message}`);
+    process.exit(1);
+  }
+}
+
+function waitForWfUiShutdown(server) {
+  return new Promise((resolve) => {
+    let closing = false;
+    const shutdown = () => {
+      if (closing) return;
+      closing = true;
+      server.close(() => resolve());
+    };
+    process.once('SIGINT', shutdown);
+    process.once('SIGTERM', shutdown);
+    server.once('close', resolve);
+  });
+}
+
+function openLocalUrl(url) {
+  const command = process.platform === 'win32'
+    ? { file: 'cmd', args: ['/c', 'start', '', url] }
+    : process.platform === 'darwin'
+      ? { file: 'open', args: [url] }
+      : { file: 'xdg-open', args: [url] };
+
+  try {
+    const child = spawn(command.file, command.args, {
+      detached: true,
+      stdio: 'ignore',
+      windowsHide: true,
+    });
+    child.unref();
+  } catch (err) {
+    console.error(`[wf-ui] could not open browser automatically: ${err.message}`);
+  }
+}
+
+function parseArgs(args) {
+  const flags = {
+    with: [],
+    without: [],
+  };
+  const positionals = [];
+  const errors = [];
+
+  function readValue(flagName, index) {
+    const value = args[index + 1];
+    if (!value || value.startsWith('-')) {
+      errors.push(`${flagName} requires a value`);
+      return { value: undefined, nextIndex: index };
+    }
+    return { value, nextIndex: index + 1 };
+  }
+
+  function readEqualsValue(flagName, value) {
+    if (!value || value.startsWith('-')) {
+      errors.push(`${flagName} requires a value`);
+      return undefined;
+    }
+    return value;
+  }
+
+  for (let i = 0; i < args.length; i += 1) {
+    const arg = args[i];
+
+    if (arg === '-h') {
+      flags.h = true;
+    } else if (arg === '--help') {
+      flags.help = true;
+    } else if (arg === '-y') {
+      flags.y = true;
+    } else if (arg === '--yes') {
+      flags.yes = true;
+    } else if (arg === '--dry-run') {
+      flags.dryRun = true;
     } else if (arg === '--list-options') {
       flags.listOptions = true;
     } else if (arg === '--json') {
       flags.json = true;
-    } else if (arg === '--on-conflict') {
-      const parsedValue = readValue('--on-conflict', i);
-      flags.onConflict = parsedValue.value;
-      i = parsedValue.nextIndex;
-    } else if (arg.startsWith('--on-conflict=')) {
-      flags.onConflict = readEqualsValue('--on-conflict', arg.slice('--on-conflict='.length));
-    } else if (arg === '--with') {
-      const parsedValue = readValue('--with', i);
-      if (parsedValue.value !== undefined) flags.with.push(parsedValue.value);
-      i = parsedValue.nextIndex;
-    } else if (arg.startsWith('--with=')) {
-      const value = readEqualsValue('--with', arg.slice('--with='.length));
-      if (value !== undefined) flags.with.push(value);
-    } else if (arg === '--without') {
-      const parsedValue = readValue('--without', i);
-      if (parsedValue.value !== undefined) flags.without.push(parsedValue.value);
-      i = parsedValue.nextIndex;
-    } else if (arg.startsWith('--without=')) {
+    } else if (arg === '--on-conflict') {
+      const parsedValue = readValue('--on-conflict', i);
+      flags.onConflict = parsedValue.value;
+      i = parsedValue.nextIndex;
+    } else if (arg.startsWith('--on-conflict=')) {
+      flags.onConflict = readEqualsValue('--on-conflict', arg.slice('--on-conflict='.length));
+    } else if (arg === '--with') {
+      const parsedValue = readValue('--with', i);
+      if (parsedValue.value !== undefined) flags.with.push(parsedValue.value);
+      i = parsedValue.nextIndex;
+    } else if (arg.startsWith('--with=')) {
+      const value = readEqualsValue('--with', arg.slice('--with='.length));
+      if (value !== undefined) flags.with.push(value);
+    } else if (arg === '--without') {
+      const parsedValue = readValue('--without', i);
+      if (parsedValue.value !== undefined) flags.without.push(parsedValue.value);
+      i = parsedValue.nextIndex;
+    } else if (arg.startsWith('--without=')) {
       const value = readEqualsValue('--without', arg.slice('--without='.length));
       if (value !== undefined) flags.without.push(value);
     } else if (arg === '--recommend') {
@@ -466,23 +582,23 @@ function parseArgs(args) {
       flags.hostGlobalDir = readEqualsValue('--host-global-dir', arg.slice('--host-global-dir='.length));
     } else if (arg.startsWith('-')) {
       errors.push(`Unknown flag "${arg}"`);
-    } else {
-      positionals.push(arg);
-    }
-  }
-
-  return { flags, positionals, errors };
-}
-
-function printOptions() {
-  const catalog = getOptionalCatalog();
-
-  console.log('');
-  console.log(pc.bold('Optional workflow skills:'));
-  for (const skill of catalog.skills) {
-    console.log(`  ${pc.cyan(skill.id)} - ${skill.description}`);
-  }
-
+    } else {
+      positionals.push(arg);
+    }
+  }
+
+  return { flags, positionals, errors };
+}
+
+function printOptions() {
+  const catalog = getOptionalCatalog();
+
+  console.log('');
+  console.log(pc.bold('Optional workflow skills:'));
+  for (const skill of catalog.skills) {
+    console.log(`  ${pc.cyan(skill.id)} - ${skill.description}`);
+  }
+
   console.log('');
   console.log(pc.bold('Presets:'));
   for (const [name, skills] of Object.entries(catalog.presets)) {
@@ -498,24 +614,24 @@ function printOptions() {
   }
   console.log('');
 }
-
-function printSummary(summary) {
-  console.log(`  created     ${pc.green(summary.created)}`);
-  console.log(`  skipped     ${pc.yellow(summary.skipped)}`);
-  console.log(`  backed up   ${pc.cyan(summary.backedUp)}`);
-  console.log(`  overwritten ${pc.cyan(summary.overwritten)}`);
-  console.log(`  conflicts   ${summary.conflicts > 0 ? pc.red(summary.conflicts) : pc.dim(summary.conflicts)}`);
-  console.log(`  directories ${pc.dim(summary.mkdir)}`);
-  console.log('');
-}
-
+
+function printSummary(summary) {
+  console.log(`  created     ${pc.green(summary.created)}`);
+  console.log(`  skipped     ${pc.yellow(summary.skipped)}`);
+  console.log(`  backed up   ${pc.cyan(summary.backedUp)}`);
+  console.log(`  overwritten ${pc.cyan(summary.overwritten)}`);
+  console.log(`  conflicts   ${summary.conflicts > 0 ? pc.red(summary.conflicts) : pc.dim(summary.conflicts)}`);
+  console.log(`  directories ${pc.dim(summary.mkdir)}`);
+  console.log('');
+}
+
 function printPlan(plan) {
   for (const [label, files] of Object.entries(plan)) {
     if (!files.length) continue;
-    console.log(`  ${label}:`);
-    for (const file of files) {
-      console.log(`    - ${file}`);
-    }
+    console.log(`  ${label}:`);
+    for (const file of files) {
+      console.log(`    - ${file}`);
+    }
   }
 }
 
@@ -533,20 +649,20 @@ function printHostPlans(hostPlans = [], hostSummary = [], { summaryOnly = false
 }
 
 function printWarnings(result) {
-  if (!result.warnings.length) return;
-
-  console.log(pc.yellow('\nWarning(s):'));
-  for (const warning of result.warnings) {
-    console.log(pc.yellow(`  - ${warning}`));
-  }
-}
-
+  if (!result.warnings.length) return;
+
+  console.log(pc.yellow('\nWarning(s):'));
+  for (const warning of result.warnings) {
+    console.log(pc.yellow(`  - ${warning}`));
+  }
+}
+
 function printJsonResult(result) {
   // Remove `created` array from output — it is already in the plan, avoid duplication
   const { created, globalCreated, hostCreated, ...rest } = result;
-  console.log(JSON.stringify(rest, null, 2));
-  if (!result.success) {
-    process.exit(1);
+  console.log(JSON.stringify(rest, null, 2));
+  if (!result.success) {
+    process.exit(1);
   }
 }
 
@@ -729,8 +845,8 @@ function scanTarget(targetDir) {
   const hasClaude = isDirectory && fs.existsSync(path.join(resolvedDir, 'CLAUDE.md'));
   const hasAgents = isDirectory && fs.existsSync(path.join(resolvedDir, 'AGENTS.md'));
   const hasAgentSkills = isDirectory && fs.existsSync(path.join(resolvedDir, '.agents'));
-  const hasCodex = isDirectory && fs.existsSync(path.join(resolvedDir, '.codex'));
-  const hasOpencode = isDirectory && (fs.existsSync(path.join(resolvedDir, '.opencode')) || fs.existsSync(path.join(resolvedDir, 'opencode.json')));
+  const hasCodex = isDirectory && fs.existsSync(path.join(resolvedDir, '.codex'));
+  const hasOpencode = isDirectory && (fs.existsSync(path.join(resolvedDir, '.opencode')) || fs.existsSync(path.join(resolvedDir, 'opencode.json')));
   const hasDocs = isDirectory && fs.existsSync(path.join(resolvedDir, 'docs'));
   const hasReadme = isDirectory && fs.existsSync(path.join(resolvedDir, 'README.md'));
   const hasPackageJson = isDirectory && fs.existsSync(path.join(resolvedDir, 'package.json'));
@@ -748,8 +864,8 @@ function scanTarget(targetDir) {
     hasClaude,
     hasAgents,
     hasAgentSkills,
-    hasCodex,
-    hasOpencode,
+    hasCodex,
+    hasOpencode,
     hasDocs,
     hasReadme,
     hasPackageJson,
@@ -777,8 +893,8 @@ function createJsonScan(scan) {
       hasClaude: scan.hasClaude,
       hasAgents: scan.hasAgents,
       hasAgentSkills: scan.hasAgentSkills,
-      hasCodex: scan.hasCodex,
-      hasOpencode: scan.hasOpencode,
+      hasCodex: scan.hasCodex,
+      hasOpencode: scan.hasOpencode,
       hasDocs: scan.hasDocs,
       hasReadme: scan.hasReadme,
       hasPackageJson: scan.hasPackageJson,
@@ -995,7 +1111,7 @@ function printScan(scan) {
   if (scan.hasClaude) console.log(`  CLAUDE.md   ${pc.yellow('exists')}`);
   if (scan.hasAgents) console.log(`  AGENTS.md   ${pc.yellow('exists')}`);
   if (scan.hasAgentSkills) console.log(`  .agents/    ${pc.yellow('exists')}`);
-  if (scan.hasCodex) console.log(`  .codex/     ${pc.yellow('exists')}`);
-  if (scan.hasOpencode) console.log(`  opencode     ${pc.yellow('exists')}  ${pc.dim('(.opencode/ or opencode.json)')}`);
+  if (scan.hasCodex) console.log(`  .codex/     ${pc.yellow('exists')}`);
+  if (scan.hasOpencode) console.log(`  opencode     ${pc.yellow('exists')}  ${pc.dim('(.opencode/ or opencode.json)')}`);
   if (scan.hasDocs) console.log(`  docs/       ${pc.dim('project-owned; Harness stays in Harness/')}`);
 }