codebase-onboarder 0.5.0 → 0.7.0

package/cli/main.js

@@ -1,26 +1,37 @@
+import { scanOptionsFromFlags } from './scanOptions.js';
 // argv → command. `bin/onboarder.js` is a one-line trampoline into `main`; all
 // parsing and dispatch lives here so the tests can call it directly.
 //
 // Flags use node's util.parseArgs — still zero dependencies, still strict about
 // unknown flags, which is what a tool that writes a config file should be.
-
 import fs from 'node:fs';
 import { parseArgs } from 'node:util';
-
-import {
-  runSetup, runStart, runStartBackground, runStartup, runLogs, runStatus, runStop, runRestart,
-  runConfig, runConfigKey, runConfigReset, runDoctor, runTunnel, runHttps,
-} from './commands.js';
+import { runSetup, runStart, runStartBackground, runStartup, runLogs, runStatus, runStop, runRestart, runConfig, runConfigKey, runConfigReset, runDoctor, runTunnel, runHttps, } from './commands.js';
 import { runExplore } from './explorer/app.js';
-
+import { openRepoOrClone, closeRemote } from './explorer/session.js';
+import { createReport, formatReport } from './explorer/report.js';
+import { setColorEnabled } from './ui.js';
+import { runReview } from '../server/review.js';
+import { reviewMarkdown, reviewProfile, SEVERITY_RANK } from '../shared/review/review.js';
+import { expandHome } from '../server/paths.js';
 const PACKAGE = JSON.parse(fs.readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
-
 const HELP = `
   🧭 Onboarder — drop a path, get a map.
 
+  Scan options for report and explore
+    --max-files <count>        Maximum files to walk (default: 4000)
+    --max-file-size <bytes>    Maximum UTF-8 file size (default: 204800)
+    --read-concurrency <n>     Concurrent reads, 1–32 (default: 8)
+
   Usage
     onboarder                     Explore a codebase here, interactively
-    onboarder explore [folder]    The same, pointed somewhere else (alias: tui)
+    onboarder explore [folder|url]  Choose a source, or open one directly (alias: tui)
+    onboarder report [folder|url]   One-shot summary for terminals and scripts (--json)
+    onboarder review [folder]       Review local changes (--json for scripts)
+      --base <ref> --head <ref>     Compare branches from their merge base
+      --staged                    Review only staged changes
+      --profile focused|balanced|thorough
+      --fail-on high|medium|low|critical|info  Exit 1 for findings at this level or above
     onboarder start               Start the web UI in the foreground (Ctrl-C stops it)
     onboarder start background    Start detached — keeps running after you close the terminal
     onboarder start startup       Run automatically at login [install|remove|status]
@@ -36,11 +47,20 @@ const HELP = `
 
   In the explorer
     map tour explain             what this is, where to start, and why
-    tree find show deps          browse it, search it, read it, trace it
+    tree find show inspect deps  browse it, search it, read it, trace it
+    graph blast symbols          the dependency tree, the blast radius, the outline
     health hubs layers patterns  the analysis, in the same words the site uses
-    stats security stack entry   numbers, findings, dependencies
-    cd rescan web                switch repo, reload, open the web UI
+    coupling clusters risks      the heat grid, the module groups, what is wrong
+    log hotspots blame           git history, hot files, who wrote a line
+    diagram atlas docs           Mermaid source, diagram index, and prose
+    workflows sbom               CI jobs and dependency/license inventory
+    diff engines deep            Changed files, analyzer status, optional deep scan
+    ask <question>                Optional AI answer grounded in the loaded repo
+    pick cd rescan web           choose a source, switch repo, reload, open the web UI
+    github                       what GitHub says about this repo — stars, issues, license
+    !<command>                   run a shell command without leaving
     help exit                    everything, and the way out
+    Tab                          completes commands, then file paths
 
   Setup flags (interactive wizard skips what they answer)
     --mode local|self-hosted   --host <addr>   --port <n>   --domain <name>
@@ -68,6 +88,9 @@ const HELP = `
   Examples
     onboarder                           # explore the repo you are standing in
     onboarder explore ~/code/my-app     # explore somewhere else
+    onboarder explore                  # choose a local folder or paste a Git URL
+    onboarder explore https://github.com/expressjs/express   # clone one and read it
+    onboarder report . --json            # analyze once and print machine-readable JSON
     onboarder start background          # leave the web UI running, close the terminal
     onboarder logs -f                   # watch what it is doing
     onboarder start startup install     # also start it every time you log in
@@ -75,144 +98,218 @@ const HELP = `
     onboarder setup --non-interactive --mode self-hosted --domain map.example.com --https --start
     onboarder config set tunnel.cloudflare true && onboarder tunnel cloudflare
 `;
-
 const OPTIONS = {
-  help: { type: 'boolean', short: 'h' },
-  version: { type: 'boolean', short: 'v' },
-  json: { type: 'boolean' },
-  yes: { type: 'boolean', short: 'y' },
-  'non-interactive': { type: 'boolean' },
-  reveal: { type: 'boolean' },
-  verbose: { type: 'boolean' },
-  start: { type: 'boolean' },
-  color: { type: 'boolean' }, // --no-color falls out of parseArgs for free
-  config: { type: 'string' },
-  mode: { type: 'string' },
-  host: { type: 'string' },
-  port: { type: 'string' },
-  domain: { type: 'string' },
-  https: { type: 'boolean' },
-  'access-key': { type: 'string' },
-  name: { type: 'string' },
-  email: { type: 'string' },
-  provider: { type: 'string' },
-  'base-url': { type: 'string' },
-  model: { type: 'string' },
-  cloudflare: { type: 'boolean' },
-  tailscale: { type: 'boolean' },
-  'auto-open': { type: 'boolean' },
-  lines: { type: 'string', short: 'n' },
-  follow: { type: 'boolean', short: 'f' },
-  timeout: { type: 'string' },
-  server: { type: 'boolean' },
+    help: { type: 'boolean', short: 'h' },
+    version: { type: 'boolean', short: 'v' },
+    json: { type: 'boolean' },
+    yes: { type: 'boolean', short: 'y' },
+    'non-interactive': { type: 'boolean' },
+    reveal: { type: 'boolean' },
+    verbose: { type: 'boolean' },
+    start: { type: 'boolean' },
+    color: { type: 'boolean' }, // `--no-color` is lifted out by extractNegatedFlags; --color forces it on
+    config: { type: 'string' },
+    mode: { type: 'string' },
+    host: { type: 'string' },
+    port: { type: 'string' },
+    domain: { type: 'string' },
+    https: { type: 'boolean' },
+    'access-key': { type: 'string' },
+    name: { type: 'string' },
+    email: { type: 'string' },
+    provider: { type: 'string' },
+    'base-url': { type: 'string' },
+    model: { type: 'string' },
+    cloudflare: { type: 'boolean' },
+    tailscale: { type: 'boolean' },
+    'auto-open': { type: 'boolean' },
+    lines: { type: 'string', short: 'n' },
+    follow: { type: 'boolean', short: 'f' },
+    timeout: { type: 'string' },
+    server: { type: 'boolean' },
+    'max-files': { type: 'string' },
+    'max-file-size': { type: 'string' },
+    'read-concurrency': { type: 'string' },
+    base: { type: 'string' },
+    head: { type: 'string' },
+    staged: { type: 'boolean' },
+    profile: { type: 'string' },
+    'fail-on': { type: 'string' },
 };
-
 // parseArgs speaks kebab-case; the wizard's flags speak camelCase.
 function normalizeFlags(values) {
-  const out = {};
-  for (const [k, v] of Object.entries(values)) {
-    const key = k.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
-    out[key] = v;
-  }
-  return out;
+    const out = {};
+    for (const [k, v] of Object.entries(values)) {
+        const key = k.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+        out[key] = v;
+    }
+    return out;
+}
+// `parseArgs` cannot express a negated boolean. `--color=false` is rejected
+// outright, `--color false` sets `color: true` and leaves `false` behind as a
+// positional, and `--no-color` is an unknown option — so the documented flag
+// had never worked, for any command, and `--no-color status` would try to run a
+// command called `no-color`.
+//
+// There is no parser-level spelling for "this boolean is false", so the flag is
+// lifted out of argv before parsing and applied to the parsed flags after. That
+// keeps `parseArgs` strict about genuinely unknown options (which is the point
+// of a tool that writes a config file) while making the one negation the CLI
+// documents actually work.
+function extractNegatedFlags(argv) {
+    const rest = [];
+    let noColor = false;
+    for (const arg of argv) {
+        if (arg === '--no-color')
+            noColor = true;
+        else
+            rest.push(arg);
+    }
+    return { argv: rest, noColor };
 }
-
 export async function main(argv = process.argv.slice(2)) {
-  let parsed;
-  try {
-    parsed = parseArgs({ args: argv, options: OPTIONS, allowPositionals: true });
-  } catch (e) {
-    console.error('  ' + e.message + '\n' + HELP);
-    return 2;
-  }
-  const { values, positionals } = parsed;
-  const flags = normalizeFlags(values);
-
-  if (flags.help) { console.log(HELP); return 0; }
-  if (flags.version) { console.log(PACKAGE.version); return 0; }
-
-  const [cmd, sub, ...rest] = positionals;
-  try {
-    switch (cmd) {
-      case 'help':
+    const { argv: argsIn, noColor } = extractNegatedFlags(argv);
+    let parsed;
+    try {
+        parsed = parseArgs({ args: argsIn, options: OPTIONS, allowPositionals: true });
+    }
+    catch (e) {
+        console.error('  ' + e.message + '\n' + HELP);
+        return 2;
+    }
+    const { values, positionals } = parsed;
+    const flags = normalizeFlags(values);
+    // Color is decided here, after the flags exist and before anything is
+    // painted. An explicit `--no-color` wins over `FORCE_COLOR`: a person who
+    // typed the flag meant it, and a stray `FORCE_COLOR` inherited from a CI
+    // profile should not override the thing they just asked for.
+    if (noColor) {
+        flags.color = false;
+        setColorEnabled(false);
+    }
+    else if (flags.color === true) {
+        // `--color` was accepted by the parser and then ignored, which is the same
+        // lie in the other direction. It is the documented way to keep ANSI in a
+        // captured log, so it has to actually turn color on.
+        setColorEnabled(true);
+    }
+    if (flags.help) {
         console.log(HELP);
         return 0;
-      case undefined:
-        // The entry point. On a terminal, bare `onboarder` explores the repo you
-        // are standing in — the thing people actually want from this tool, and
-        // what the name promises. Everywhere else (a pipe, CI, a script) it
-        // still starts the server, because an interactive session with no input
-        // source is a hang, and nothing about a background job wants a prompt.
-        // `--server` forces the old behavior even on a terminal.
-        if (!flags.server && process.stdin.isTTY && process.stdout.isTTY) {
-          return codeOf(await runExplore({ flags, target: '.' }));
-        }
-        return codeOf(await runStart({ flags }));
-      case 'explore':
-      case 'tui':
-      case 'shell':
-        return codeOf(await runExplore({ flags, target: sub || '.' }));
-      case 'web':
-      case 'site':
-        return codeOf(await runStart({ flags }));
-      case 'start':
-        // `onboarder start [background|fg|startup [action]]`. The sub-verb is a
-        // positional, not a flag, because `onboarder start` has to keep working
-        // exactly as it did and `startup install` is a different verb from
-        // `start`.
-        if (sub === 'background' || sub === 'bg' || sub === 'daemon' || sub === 'detached') {
-          return codeOf(await runStartBackground({ flags }));
-        }
-        if (sub === 'startup' || sub === 'login' || sub === 'autostart') {
-          return codeOf(await runStartup(rest[0] || 'status', { flags }));
-        }
-        if (sub === 'fg' || sub === 'foreground') return codeOf(await runStart({ flags }));
-        if (sub === 'status') return codeOf(await runStatus({ flags }));
-        if (sub === 'stop') return codeOf(await runStop({ flags }));
-        if (sub === 'logs') return codeOf(await runLogs({ flags }));
-        if (sub) {
-          console.error('  Unknown start mode: ' + sub + '\n' + HELP);
-          return 2;
+    }
+    if (flags.version) {
+        console.log(PACKAGE.version);
+        return 0;
+    }
+    const [cmd, sub, ...rest] = positionals;
+    try {
+        switch (cmd) {
+            case 'help':
+                console.log(HELP);
+                return 0;
+            case undefined:
+                // The entry point. On a terminal, bare `onboarder` explores the repo you
+                // are standing in — the thing people actually want from this tool, and
+                // what the name promises. Everywhere else (a pipe, CI, a script) it
+                // still starts the server, because an interactive session with no input
+                // source is a hang, and nothing about a background job wants a prompt.
+                // `--server` forces the old behavior even on a terminal.
+                if (!flags.server && process.stdin.isTTY && process.stdout.isTTY) {
+                    return codeOf(await runExplore({ flags }));
+                }
+                return codeOf(await runStart({ flags }));
+            case 'explore':
+            case 'tui':
+            case 'shell':
+                return codeOf(await runExplore({ flags, target: sub }));
+            case 'report': {
+                const repo = await openRepoOrClone(sub || '.', scanOptionsFromFlags(flags));
+                try {
+                    const report = createReport(repo);
+                    console.log(flags.json ? JSON.stringify(report, null, 2) : formatReport(report));
+                    return 0;
+                }
+                finally {
+                    await closeRemote(repo);
+                }
+            }
+            case 'review': {
+                if (flags.staged && flags.head)
+                    throw new Error('Choose either --staged or --head.');
+                if (flags.failOn && !Object.hasOwn(SEVERITY_RANK, flags.failOn))
+                    throw new Error('Choose a valid --fail-on severity: critical, high, medium, low, or info.');
+                const report = await runReview(expandHome(sub || '.'), { base: flags.base || 'HEAD', head: flags.head || '', mode: flags.staged ? 'staged' : flags.head ? 'range' : 'working', profile: flags.profile ? reviewProfile(flags.profile) : undefined });
+                console.log(flags.json ? JSON.stringify(report, null, 2) : reviewMarkdown(report));
+                return flags.failOn && report.findings.some(f => SEVERITY_RANK[f.severity] >= SEVERITY_RANK[flags.failOn]) || report.checks.some(c => c.id === 'conflicts' && c.status === 'fail') ? 1 : 0;
+            }
+            case 'web':
+            case 'site':
+                return codeOf(await runStart({ flags }));
+            case 'start':
+                // `onboarder start [background|fg|startup [action]]`. The sub-verb is a
+                // positional, not a flag, because `onboarder start` has to keep working
+                // exactly as it did and `startup install` is a different verb from
+                // `start`.
+                if (sub === 'background' || sub === 'bg' || sub === 'daemon' || sub === 'detached') {
+                    return codeOf(await runStartBackground({ flags }));
+                }
+                if (sub === 'startup' || sub === 'login' || sub === 'autostart') {
+                    return codeOf(await runStartup(rest[0] || 'status', { flags }));
+                }
+                if (sub === 'fg' || sub === 'foreground')
+                    return codeOf(await runStart({ flags }));
+                if (sub === 'status')
+                    return codeOf(await runStatus({ flags }));
+                if (sub === 'stop')
+                    return codeOf(await runStop({ flags }));
+                if (sub === 'logs')
+                    return codeOf(await runLogs({ flags }));
+                if (sub) {
+                    console.error('  Unknown start mode: ' + sub + '\n' + HELP);
+                    return 2;
+                }
+                return codeOf(await runStart({ flags }));
+            case 'logs':
+            case 'log':
+                return codeOf(await runLogs({ flags }));
+            case 'startup':
+            case 'autostart':
+                return codeOf(await runStartup(sub || 'status', { flags }));
+            case 'status':
+                return codeOf(await runStatus({ flags }));
+            case 'stop':
+                return codeOf(await runStop({ flags }));
+            case 'restart':
+                return codeOf(await runRestart({ flags }));
+            case 'setup':
+            case 'onboard':
+            case 'init':
+                return codeOf(await runSetup({ flags, version: PACKAGE.version }));
+            case 'config':
+                if (sub === 'key')
+                    return codeOf(await runConfigKey(rest[0], rest.slice(1), { flags }));
+                if (sub === 'reset')
+                    return codeOf(await runConfigReset({ flags }));
+                return codeOf(await runConfig(sub || 'show', rest, { flags }));
+            case 'tunnel':
+                return codeOf(await runTunnel(sub, { flags }));
+            case 'https':
+                return codeOf(await runHttps(sub || 'status', { flags }));
+            case 'doctor':
+                return codeOf(await runDoctor({ flags }));
+            default:
+                console.error('  Unknown command: ' + cmd + '\n' + HELP);
+                return 2;
         }
-        return codeOf(await runStart({ flags }));
-      case 'logs':
-      case 'log':
-        return codeOf(await runLogs({ flags }));
-      case 'startup':
-      case 'autostart':
-        return codeOf(await runStartup(sub || 'status', { flags }));
-      case 'status':
-        return codeOf(await runStatus({ flags }));
-      case 'stop':
-        return codeOf(await runStop({ flags }));
-      case 'restart':
-        return codeOf(await runRestart({ flags }));
-      case 'setup':
-      case 'onboard':
-      case 'init':
-        return codeOf(await runSetup({ flags, version: PACKAGE.version }));
-      case 'config':
-        if (sub === 'key') return codeOf(await runConfigKey(rest[0], rest.slice(1), { flags }));
-        if (sub === 'reset') return codeOf(await runConfigReset({ flags }));
-        return codeOf(await runConfig(sub || 'show', rest, { flags }));
-      case 'tunnel':
-        return codeOf(await runTunnel(sub, { flags }));
-      case 'https':
-        return codeOf(await runHttps(sub || 'status', { flags }));
-      case 'doctor':
-        return codeOf(await runDoctor({ flags }));
-      default:
-        console.error('  Unknown command: ' + cmd + '\n' + HELP);
-        return 2;
     }
-  } catch (e) {
-    console.error('  ' + (e.message || e));
-    return 1;
-  }
+    catch (e) {
+        console.error('  ' + (e.message || e));
+        return 1;
+    }
 }
-
 // Commands return an exit code or, for `start`, an object carrying the live
 // server. Both collapse to "what code should the process eventually use".
 function codeOf(result) {
-  return typeof result === 'number' ? result : result?.code ?? 0;
+    return typeof result === 'number' ? result : result?.code ?? 0;
 }
+//# sourceMappingURL=main.js.map

package/cli/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/cli/main.ts"],"names":[],"mappings":"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","sourcesContent":["import { scanOptionsFromFlags } from './scanOptions.js';\n// argv → command. `bin/onboarder.js` is a one-line trampoline into `main`; all\n// parsing and dispatch lives here so the tests can call it directly.\n//\n// Flags use node's util.parseArgs — still zero dependencies, still strict about\n// unknown flags, which is what a tool that writes a config file should be.\n\nimport fs from 'node:fs';\nimport { parseArgs } from 'node:util';\n\nimport {\n  runSetup, runStart, runStartBackground, runStartup, runLogs, runStatus, runStop, runRestart,\n  runConfig, runConfigKey, runConfigReset, runDoctor, runTunnel, runHttps,\n} from './commands.js';\nimport { runExplore } from './explorer/app.js';\nimport { openRepoOrClone, closeRemote } from './explorer/session.js';\nimport { createReport, formatReport } from './explorer/report.js';\nimport { setColorEnabled } from './ui.js';\nimport { runReview } from '../server/review.js';\nimport { reviewMarkdown, reviewProfile, SEVERITY_RANK } from '../shared/review/review.js';\nimport { expandHome } from '../server/paths.js';\n\nconst PACKAGE = JSON.parse(fs.readFileSync(new URL('../package.json', import.meta.url), 'utf8'));\n\nconst HELP = `\n  🧭 Onboarder — drop a path, get a map.\n\n  Scan options for report and explore\n    --max-files <count>        Maximum files to walk (default: 4000)\n    --max-file-size <bytes>    Maximum UTF-8 file size (default: 204800)\n    --read-concurrency <n>     Concurrent reads, 1–32 (default: 8)\n\n  Usage\n    onboarder                     Explore a codebase here, interactively\n    onboarder explore [folder|url]  Choose a source, or open one directly (alias: tui)\n    onboarder report [folder|url]   One-shot summary for terminals and scripts (--json)\n    onboarder review [folder]       Review local changes (--json for scripts)\n      --base <ref> --head <ref>     Compare branches from their merge base\n      --staged                    Review only staged changes\n      --profile focused|balanced|thorough\n      --fail-on high|medium|low|critical|info  Exit 1 for findings at this level or above\n    onboarder start               Start the web UI in the foreground (Ctrl-C stops it)\n    onboarder start background    Start detached — keeps running after you close the terminal\n    onboarder start startup       Run automatically at login [install|remove|status]\n    onboarder web                 Alias for \\`onboarder start\\`\n    onboarder logs                Show recent log lines  (-n <count>, -f to follow)\n    onboarder status              Show whether the web UI is running\n    onboarder stop                Stop the running web UI\n    onboarder restart             Stop and start again\n    onboarder config [<…>]         show | get <key> | set <key> <value> | path | reset | key <rotate|show|set>\n    onboarder tunnel <name>       cloudflare | tailscale\n    onboarder https <action>      check | setup | start | stop | status\n    onboarder doctor              Check the machine and the config\n\n  In the explorer\n    map tour explain             what this is, where to start, and why\n    tree find show inspect deps  browse it, search it, read it, trace it\n    graph blast symbols          the dependency tree, the blast radius, the outline\n    health hubs layers patterns  the analysis, in the same words the site uses\n    coupling clusters risks      the heat grid, the module groups, what is wrong\n    log hotspots blame           git history, hot files, who wrote a line\n    diagram atlas docs           Mermaid source, diagram index, and prose\n    workflows sbom               CI jobs and dependency/license inventory\n    diff engines deep            Changed files, analyzer status, optional deep scan\n    ask <question>                Optional AI answer grounded in the loaded repo\n    pick cd rescan web           choose a source, switch repo, reload, open the web UI\n    github                       what GitHub says about this repo — stars, issues, license\n    !<command>                   run a shell command without leaving\n    help exit                    everything, and the way out\n    Tab                          completes commands, then file paths\n\n  Setup flags (interactive wizard skips what they answer)\n    --mode local|self-hosted   --host <addr>   --port <n>   --domain <name>\n    --https                    Set up automatic HTTPS through Caddy\n    --access-key generate|<k>  --name <n>   --email <e>\n    --provider none|openai-compatible|ollama|openrouter|custom\n    --base-url <url>   --model <m>   --cloudflare   --tailscale\n\n  General flags\n    --config <file>     Use this config file (or ONBOARDER_CONFIG)\n    --server            With bare \\`onboarder\\`, start the web UI instead of exploring\n    --non-interactive   Never prompt; flags + defaults are the answers\n    -y, --yes           Answer yes to confirmations\n    --json              Machine-readable output\n    --reveal            config show prints the full access key\n    --no-color          Plain output (NO_COLOR works too)\n    -h, --help          This text      -v, --version      Print the version\n\n  Also accepted\n    help | --help       onboarder help | onboarder --help\n    config | config show\n    bg | detached       alias for start background\n    fg | foreground     alias for start\n\n  Examples\n    onboarder                           # explore the repo you are standing in\n    onboarder explore ~/code/my-app     # explore somewhere else\n    onboarder explore                  # choose a local folder or paste a Git URL\n    onboarder explore https://github.com/expressjs/express   # clone one and read it\n    onboarder report . --json            # analyze once and print machine-readable JSON\n    onboarder start background          # leave the web UI running, close the terminal\n    onboarder logs -f                   # watch what it is doing\n    onboarder start startup install     # also start it every time you log in\n    onboarder setup --non-interactive --mode local --port 4310\n    onboarder setup --non-interactive --mode self-hosted --domain map.example.com --https --start\n    onboarder config set tunnel.cloudflare true && onboarder tunnel cloudflare\n`;\n\nconst OPTIONS: NonNullable<import('node:util').ParseArgsConfig['options']> = {\n  help: { type: 'boolean', short: 'h' },\n  version: { type: 'boolean', short: 'v' },\n  json: { type: 'boolean' },\n  yes: { type: 'boolean', short: 'y' },\n  'non-interactive': { type: 'boolean' },\n  reveal: { type: 'boolean' },\n  verbose: { type: 'boolean' },\n  start: { type: 'boolean' },\n  color: { type: 'boolean' }, // `--no-color` is lifted out by extractNegatedFlags; --color forces it on\n  config: { type: 'string' },\n  mode: { type: 'string' },\n  host: { type: 'string' },\n  port: { type: 'string' },\n  domain: { type: 'string' },\n  https: { type: 'boolean' },\n  'access-key': { type: 'string' },\n  name: { type: 'string' },\n  email: { type: 'string' },\n  provider: { type: 'string' },\n  'base-url': { type: 'string' },\n  model: { type: 'string' },\n  cloudflare: { type: 'boolean' },\n  tailscale: { type: 'boolean' },\n  'auto-open': { type: 'boolean' },\n  lines: { type: 'string', short: 'n' },\n  follow: { type: 'boolean', short: 'f' },\n  timeout: { type: 'string' },\n  server: { type: 'boolean' },\n  'max-files': { type: 'string' },\n  'max-file-size': { type: 'string' },\n  'read-concurrency': { type: 'string' },\n  base: { type: 'string' },\n  head: { type: 'string' },\n  staged: { type: 'boolean' },\n  profile: { type: 'string' },\n  'fail-on': { type: 'string' },\n};\n\n// parseArgs speaks kebab-case; the wizard's flags speak camelCase.\nfunction normalizeFlags(values) {\n  const out: Record<string, any> = {};\n  for (const [k, v] of Object.entries(values)) {\n    const key = k.replace(/-([a-z])/g, (_, c) => c.toUpperCase());\n    out[key] = v;\n  }\n  return out;\n}\n\n// `parseArgs` cannot express a negated boolean. `--color=false` is rejected\n// outright, `--color false` sets `color: true` and leaves `false` behind as a\n// positional, and `--no-color` is an unknown option — so the documented flag\n// had never worked, for any command, and `--no-color status` would try to run a\n// command called `no-color`.\n//\n// There is no parser-level spelling for \"this boolean is false\", so the flag is\n// lifted out of argv before parsing and applied to the parsed flags after. That\n// keeps `parseArgs` strict about genuinely unknown options (which is the point\n// of a tool that writes a config file) while making the one negation the CLI\n// documents actually work.\nfunction extractNegatedFlags(argv) {\n  const rest = [];\n  let noColor = false;\n  for (const arg of argv) {\n    if (arg === '--no-color') noColor = true;\n    else rest.push(arg);\n  }\n  return { argv: rest, noColor };\n}\n\nexport async function main(argv = process.argv.slice(2)) {\n  const { argv: argsIn, noColor } = extractNegatedFlags(argv);\n  let parsed;\n  try {\n    parsed = parseArgs({ args: argsIn, options: OPTIONS, allowPositionals: true });\n  } catch (e) {\n    console.error('  ' + e.message + '\\n' + HELP);\n    return 2;\n  }\n  const { values, positionals } = parsed;\n  const flags = normalizeFlags(values);\n\n  // Color is decided here, after the flags exist and before anything is\n  // painted. An explicit `--no-color` wins over `FORCE_COLOR`: a person who\n  // typed the flag meant it, and a stray `FORCE_COLOR` inherited from a CI\n  // profile should not override the thing they just asked for.\n  if (noColor) {\n    flags.color = false;\n    setColorEnabled(false);\n  } else if (flags.color === true) {\n    // `--color` was accepted by the parser and then ignored, which is the same\n    // lie in the other direction. It is the documented way to keep ANSI in a\n    // captured log, so it has to actually turn color on.\n    setColorEnabled(true);\n  }\n\n  if (flags.help) { console.log(HELP); return 0; }\n  if (flags.version) { console.log(PACKAGE.version); return 0; }\n\n  const [cmd, sub, ...rest] = positionals;\n  try {\n    switch (cmd) {\n      case 'help':\n        console.log(HELP);\n        return 0;\n      case undefined:\n        // The entry point. On a terminal, bare `onboarder` explores the repo you\n        // are standing in — the thing people actually want from this tool, and\n        // what the name promises. Everywhere else (a pipe, CI, a script) it\n        // still starts the server, because an interactive session with no input\n        // source is a hang, and nothing about a background job wants a prompt.\n        // `--server` forces the old behavior even on a terminal.\n        if (!flags.server && process.stdin.isTTY && process.stdout.isTTY) {\n          return codeOf(await runExplore({ flags }));\n        }\n        return codeOf(await runStart({ flags }));\n      case 'explore':\n      case 'tui':\n      case 'shell':\n        return codeOf(await runExplore({ flags, target: sub }));\n      case 'report': {\n        const repo = await openRepoOrClone(sub || '.', scanOptionsFromFlags(flags));\n        try {\n          const report = createReport(repo);\n          console.log(flags.json ? JSON.stringify(report, null, 2) : formatReport(report));\n          return 0;\n        } finally {\n          await closeRemote(repo);\n        }\n      }\n      case 'review': {\n        if (flags.staged && flags.head) throw new Error('Choose either --staged or --head.');\n        if (flags.failOn && !Object.hasOwn(SEVERITY_RANK, flags.failOn)) throw new Error('Choose a valid --fail-on severity: critical, high, medium, low, or info.');\n        const report = await runReview(expandHome(sub || '.'), { base: flags.base || 'HEAD', head: flags.head || '', mode: flags.staged ? 'staged' : flags.head ? 'range' : 'working', profile: flags.profile ? reviewProfile(flags.profile) : undefined });\n        console.log(flags.json ? JSON.stringify(report, null, 2) : reviewMarkdown(report));\n        return flags.failOn && report.findings.some(f => SEVERITY_RANK[f.severity] >= SEVERITY_RANK[flags.failOn]) || report.checks.some(c => c.id === 'conflicts' && c.status === 'fail') ? 1 : 0;\n      }\n      case 'web':\n      case 'site':\n        return codeOf(await runStart({ flags }));\n      case 'start':\n        // `onboarder start [background|fg|startup [action]]`. The sub-verb is a\n        // positional, not a flag, because `onboarder start` has to keep working\n        // exactly as it did and `startup install` is a different verb from\n        // `start`.\n        if (sub === 'background' || sub === 'bg' || sub === 'daemon' || sub === 'detached') {\n          return codeOf(await runStartBackground({ flags }));\n        }\n        if (sub === 'startup' || sub === 'login' || sub === 'autostart') {\n          return codeOf(await runStartup(rest[0] || 'status', { flags }));\n        }\n        if (sub === 'fg' || sub === 'foreground') return codeOf(await runStart({ flags }));\n        if (sub === 'status') return codeOf(await runStatus({ flags }));\n        if (sub === 'stop') return codeOf(await runStop({ flags }));\n        if (sub === 'logs') return codeOf(await runLogs({ flags }));\n        if (sub) {\n          console.error('  Unknown start mode: ' + sub + '\\n' + HELP);\n          return 2;\n        }\n        return codeOf(await runStart({ flags }));\n      case 'logs':\n      case 'log':\n        return codeOf(await runLogs({ flags }));\n      case 'startup':\n      case 'autostart':\n        return codeOf(await runStartup(sub || 'status', { flags }));\n      case 'status':\n        return codeOf(await runStatus({ flags }));\n      case 'stop':\n        return codeOf(await runStop({ flags }));\n      case 'restart':\n        return codeOf(await runRestart({ flags }));\n      case 'setup':\n      case 'onboard':\n      case 'init':\n        return codeOf(await runSetup({ flags, version: PACKAGE.version }));\n      case 'config':\n        if (sub === 'key') return codeOf(await runConfigKey(rest[0], rest.slice(1), { flags }));\n        if (sub === 'reset') return codeOf(await runConfigReset({ flags }));\n        return codeOf(await runConfig(sub || 'show', rest, { flags }));\n      case 'tunnel':\n        return codeOf(await runTunnel(sub, { flags }));\n      case 'https':\n        return codeOf(await runHttps(sub || 'status', { flags }));\n      case 'doctor':\n        return codeOf(await runDoctor({ flags }));\n      default:\n        console.error('  Unknown command: ' + cmd + '\\n' + HELP);\n        return 2;\n    }\n  } catch (e) {\n    console.error('  ' + (e.message || e));\n    return 1;\n  }\n}\n\n// Commands return an exit code or, for `start`, an object carrying the live\n// server. Both collapse to \"what code should the process eventually use\".\nfunction codeOf(result) {\n  return typeof result === 'number' ? result : result?.code ?? 0;\n}\n"]}

package/cli/prompt.d.ts

@@ -0,0 +1,5 @@
+export declare class WizardCancelled extends Error {
+    code: string;
+    constructor();
+}
+export declare function runSteps(steps: any, answers?: Record<string, any>, io?: Record<string, any>): Promise<Record<string, any>>;