codebase-onboarder 0.6.0 → 1.0.0

package/cli/main.js

@@ -1,27 +1,43 @@
+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 { runChat, CHAT_HELP } from './chat/app.js';
+import { isRemoteSource } from './chat/source.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';
+import { agentCommand, AGENT_OPTIONS } from './agent/command.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|url]  The same, pointed somewhere else (alias: tui)
+    onboarder                      Open the Hermes chat harness here
+    onboarder chat [folder|url]     Clone/open a repo and chat (alias: tui)
+    onboarder explore [folder|url]  Open the offline repository explorer
+    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 agent <workflow>      Hermes: ask, review, triage, implement, pr, github
+      onboarder agent --help        Agent setup, permissions, and examples
     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]
@@ -37,13 +53,16 @@ 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
     coupling clusters risks      the heat grid, the module groups, what is wrong
     log hotspots blame           git history, hot files, who wrote a line
-    diagram docs                 Mermaid source, and prose you can write out
-    cd rescan web                switch repo (or clone a URL), reload, open the web UI
+    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
@@ -58,7 +77,7 @@ const HELP = `
 
   General flags
     --config <file>     Use this config file (or ONBOARDER_CONFIG)
-    --server            With bare \`onboarder\`, start the web UI instead of exploring
+    --server            With bare \`onboarder\`, start the web UI instead of chatting
     --non-interactive   Never prompt; flags + defaults are the answers
     -y, --yes           Answer yes to confirmations
     --json              Machine-readable output
@@ -73,9 +92,12 @@ const HELP = `
     fg | foreground     alias for start
 
   Examples
-    onboarder                           # explore the repo you are standing in
+    onboarder                           # chat about the repo you are standing in
+    onboarder chat --mode review         # begin in review mode
     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
@@ -83,48 +105,54 @@ 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` 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' },
+    ...AGENT_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` 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
@@ -137,126 +165,185 @@ function normalizeFlags(values) {
 // 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 };
+    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)) {
-  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; }
-  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 && ['chat', 'tui'].includes(positionals[0])) {
+        console.log(CHAT_HELP);
+        return 0;
+    }
+    if (flags.help && positionals[0] !== 'agent') {
         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 'agent': {
+                if (sub === 'chat') {
+                    if (rest.length > 1)
+                        throw new Error('Use one repository folder: onboarder agent chat [folder].');
+                    return runChat({ target: rest[0], flags, version: PACKAGE.version });
+                }
+                const abort = new AbortController();
+                const cancel = () => abort.abort();
+                process.once('SIGINT', cancel);
+                process.once('SIGTERM', cancel);
+                try {
+                    return await agentCommand(sub, rest, flags, { signal: abort.signal });
+                }
+                finally {
+                    process.off('SIGINT', cancel);
+                    process.off('SIGTERM', cancel);
+                }
+            }
+            case 'help':
+                console.log(HELP);
+                return 0;
+            case undefined:
+                // Chat on a terminal; retain server behavior for existing scripts.
+                if (!flags.server && process.stdin.isTTY && process.stdout.isTTY) {
+                    return codeOf(await runChat({ flags, version: PACKAGE.version }));
+                }
+                return codeOf(await runStart({ flags }));
+            case 'explore':
+            case 'shell':
+                return codeOf(await runExplore({ flags, target: sub }));
+            case 'chat':
+            case 'tui':
+                if (rest.length)
+                    throw new Error('Use one repository folder: onboarder chat [folder].');
+                return codeOf(await runChat({ flags, target: sub, version: PACKAGE.version }));
+            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:
+                if (isRemoteSource(cmd)) {
+                    if (sub)
+                        throw new Error('Use onboarder chat <GitHub URL>, then type your question.');
+                    return codeOf(await runChat({ target: cmd, flags, version: PACKAGE.version }));
+                }
+                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":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AACxD,+EAA+E;AAC/E,qEAAqE;AACrE,EAAE;AACF,gFAAgF;AAChF,2EAA2E;AAE3E,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EACL,QAAQ,EAAE,QAAQ,EAAE,kBAAkB,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAC3F,SAAS,EAAE,YAAY,EAAE,cAAc,EAAE,SAAS,EAAE,SAAS,EAAE,QAAQ,GACxE,MAAM,eAAe,CAAC;AACvB,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC1F,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEjE,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,GAAG,CAAC,iBAAiB,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;AAEjG,MAAM,IAAI,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsFZ,CAAC;AAEF,MAAM,OAAO,GAAgE;IAC3E,GAAG,aAAa;IAChB,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE;IACrC,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE;IACxC,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IACzB,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE;IACpC,iBAAiB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IACtC,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IAC3B,OAAO,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IAC5B,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IAC1B,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,0EAA0E;IACtG,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC1B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IACxB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IACxB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IACxB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC1B,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IAC1B,YAAY,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IAChC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IACxB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IACzB,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC5B,UAAU,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC9B,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IACzB,UAAU,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IAC/B,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IAC9B,WAAW,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IAChC,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE;IACrC,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,EAAE;IACvC,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC3B,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IAC3B,WAAW,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC/B,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IACnC,kBAAkB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IACtC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IACxB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IACxB,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;IAC3B,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;IAC3B,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;CAC9B,CAAC;AAEF,mEAAmE;AACnE,SAAS,cAAc,CAAC,MAAM;IAC5B,MAAM,GAAG,GAAwB,EAAE,CAAC;IACpC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5C,MAAM,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;QAC9D,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,gFAAgF;AAChF,6BAA6B;AAC7B,EAAE;AACF,gFAAgF;AAChF,gFAAgF;AAChF,+EAA+E;AAC/E,6EAA6E;AAC7E,2BAA2B;AAC3B,SAAS,mBAAmB,CAAC,IAAI;IAC/B,MAAM,IAAI,GAAG,EAAE,CAAC;IAChB,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,GAAG,KAAK,YAAY;YAAE,OAAO,GAAG,IAAI,CAAC;;YACpC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AACjC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IACrD,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IAC5D,IAAI,MAAM,CAAC;IACX,IAAI,CAAC;QACH,MAAM,GAAG,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,CAAC,CAAC;IACjF,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC;QAC9C,OAAO,CAAC,CAAC;IACX,CAAC;IACD,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IACvC,MAAM,KAAK,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IAErC,sEAAsE;IACtE,0EAA0E;IAC1E,yEAAyE;IACzE,6DAA6D;IAC7D,IAAI,OAAO,EAAE,CAAC;QACZ,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC;QACpB,eAAe,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;SAAM,IAAI,KAAK,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QAChC,2EAA2E;QAC3E,yEAAyE;QACzE,qDAAqD;QACrD,eAAe,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAAC,OAAO,CAAC,CAAC;IAAC,CAAC;IACjG,IAAI,KAAK,CAAC,IAAI,IAAI,WAAW,CAAC,CAAC,CAAC,KAAK,OAAO,EAAE,CAAC;QAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAAC,OAAO,CAAC,CAAC;IAAC,CAAC;IAC9E,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAAC,OAAO,CAAC,CAAC;IAAC,CAAC;IAE9D,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,GAAG,WAAW,CAAC;IACxC,IAAI,CAAC;QACH,QAAQ,GAAG,EAAE,CAAC;YACZ,KAAK,OAAO,EAAE,CAAC;gBACb,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;oBACnB,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;wBAAE,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;oBAClG,OAAO,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;gBACvE,CAAC;gBACD,MAAM,KAAK,GAAG,IAAI,eAAe,EAAE,CAAC;gBACpC,MAAM,MAAM,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;gBAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;gBAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;gBACpG,IAAI,CAAC;oBAAC,OAAO,MAAM,YAAY,CAAC,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;gBAAC,CAAC;wBACtE,CAAC;oBAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;oBAAC,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;gBAAC,CAAC;YAC5E,CAAC;YACD,KAAK,MAAM;gBACT,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;gBAClB,OAAO,CAAC,CAAC;YACX,KAAK,SAAS;gBACZ,mEAAmE;gBACnE,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;oBACjE,OAAO,MAAM,CAAC,MAAM,OAAO,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBACpE,CAAC;gBACD,OAAO,MAAM,CAAC,MAAM,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;YAC3C,KAAK,SAAS,CAAC;YACf,KAAK,OAAO;gBACV,OAAO,MAAM,CAAC,MAAM,UAAU,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;YAC1D,KAAK,MAAM,CAAC;YACZ,KAAK,KAAK;gBACR,IAAI,IAAI,CAAC,MAAM;oBAAE,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;gBACxF,OAAO,MAAM,CAAC,MAAM,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACjF,KAAK,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,GAAG,MAAM,eAAe,CAAC,GAAG,IAAI,GAAG,EAAE,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC;gBAC5E,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;oBAClC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;oBACjF,OAAO,CAAC,CAAC;gBACX,CAAC;wBAAS,CAAC;oBACT,MAAM,WAAW,CAAC,IAAI,CAAC,CAAC;gBAC1B,CAAC;YACH,CAAC;YACD,KAAK,QAAQ,EAAE,CAAC;gBACd,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI;oBAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,CAAC,CAAC;gBACrF,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC;oBAAE,MAAM,IAAI,KAAK,CAAC,0EAA0E,CAAC,CAAC;gBAC7J,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;gBACpP,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;gBACnF,OAAO,KAAK,CAAC,MAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,WAAW,IAAI,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAC7L,CAAC;YACD,KAAK,KAAK,CAAC;YACX,KAAK,MAAM;gBACT,OAAO,MAAM,CAAC,MAAM,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;YAC3C,KAAK,OAAO;gBACV,wEAAwE;gBACxE,wEAAwE;gBACxE,mEAAmE;gBACnE,WAAW;gBACX,IAAI,GAAG,KAAK,YAAY,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;oBACnF,OAAO,MAAM,CAAC,MAAM,kBAAkB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;gBACrD,CAAC;gBACD,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;oBAChE,OAAO,MAAM,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;gBAClE,CAAC;gBACD,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,YAAY;oBAAE,OAAO,MAAM,CAAC,MAAM,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;gBACnF,IAAI,GAAG,KAAK,QAAQ;oBAAE,OAAO,MAAM,CAAC,MAAM,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;gBAChE,IAAI,GAAG,KAAK,MAAM;oBAAE,OAAO,MAAM,CAAC,MAAM,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC5D,IAAI,GAAG,KAAK,MAAM;oBAAE,OAAO,MAAM,CAAC,MAAM,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;gBAC5D,IAAI,GAAG,EAAE,CAAC;oBACR,OAAO,CAAC,KAAK,CAAC,wBAAwB,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC;oBAC5D,OAAO,CAAC,CAAC;gBACX,CAAC;gBACD,OAAO,MAAM,CAAC,MAAM,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;YAC3C,KAAK,MAAM,CAAC;YACZ,KAAK,KAAK;gBACR,OAAO,MAAM,CAAC,MAAM,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;YAC1C,KAAK,SAAS,CAAC;YACf,KAAK,WAAW;gBACd,OAAO,MAAM,CAAC,MAAM,UAAU,CAAC,GAAG,IAAI,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;YAC9D,KAAK,QAAQ;gBACX,OAAO,MAAM,CAAC,MAAM,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;YAC5C,KAAK,MAAM;gBACT,OAAO,MAAM,CAAC,MAAM,OAAO,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;YAC1C,KAAK,SAAS;gBACZ,OAAO,MAAM,CAAC,MAAM,UAAU,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;YAC7C,KAAK,OAAO,CAAC;YACb,KAAK,SAAS,CAAC;YACf,KAAK,MAAM;gBACT,OAAO,MAAM,CAAC,MAAM,QAAQ,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;YACrE,KAAK,QAAQ;gBACX,IAAI,GAAG,KAAK,KAAK;oBAAE,OAAO,MAAM,CAAC,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;gBACxF,IAAI,GAAG,KAAK,OAAO;oBAAE,OAAO,MAAM,CAAC,MAAM,cAAc,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;gBACpE,OAAO,MAAM,CAAC,MAAM,SAAS,CAAC,GAAG,IAAI,MAAM,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;YACjE,KAAK,QAAQ;gBACX,OAAO,MAAM,CAAC,MAAM,SAAS,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;YACjD,KAAK,OAAO;gBACV,OAAO,MAAM,CAAC,MAAM,QAAQ,CAAC,GAAG,IAAI,QAAQ,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;YAC5D,KAAK,QAAQ;gBACX,OAAO,MAAM,CAAC,MAAM,SAAS,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;YAC5C;gBACE,IAAI,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;oBACxB,IAAI,GAAG;wBAAE,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;oBACtF,OAAO,MAAM,CAAC,MAAM,OAAO,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;gBACjF,CAAC;gBACD,OAAO,CAAC,KAAK,CAAC,qBAAqB,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC;gBACzD,OAAO,CAAC,CAAC;QACb,CAAC;IACH,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;QACvC,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED,4EAA4E;AAC5E,0EAA0E;AAC1E,SAAS,MAAM,CAAC,MAAM;IACpB,OAAO,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,CAAC;AACjE,CAAC","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 { runChat, CHAT_HELP } from './chat/app.js';\nimport { isRemoteSource } from './chat/source.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';\nimport { agentCommand, AGENT_OPTIONS } from './agent/command.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                      Open the Hermes chat harness here\n    onboarder chat [folder|url]     Clone/open a repo and chat (alias: tui)\n    onboarder explore [folder|url]  Open the offline repository explorer\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 agent <workflow>      Hermes: ask, review, triage, implement, pr, github\n      onboarder agent --help        Agent setup, permissions, and examples\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 chatting\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                           # chat about the repo you are standing in\n    onboarder chat --mode review         # begin in review mode\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  ...AGENT_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 && ['chat', 'tui'].includes(positionals[0])) { console.log(CHAT_HELP); return 0; }\n  if (flags.help && positionals[0] !== 'agent') { 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 'agent': {\n        if (sub === 'chat') {\n          if (rest.length > 1) throw new Error('Use one repository folder: onboarder agent chat [folder].');\n          return runChat({ target: rest[0], flags, version: PACKAGE.version });\n        }\n        const abort = new AbortController();\n        const cancel = () => abort.abort(); process.once('SIGINT', cancel); process.once('SIGTERM', cancel);\n        try { return await agentCommand(sub, rest, flags, { signal: abort.signal }); }\n        finally { process.off('SIGINT', cancel); process.off('SIGTERM', cancel); }\n      }\n      case 'help':\n        console.log(HELP);\n        return 0;\n      case undefined:\n        // Chat on a terminal; retain server behavior for existing scripts.\n        if (!flags.server && process.stdin.isTTY && process.stdout.isTTY) {\n          return codeOf(await runChat({ flags, version: PACKAGE.version }));\n        }\n        return codeOf(await runStart({ flags }));\n      case 'explore':\n      case 'shell':\n        return codeOf(await runExplore({ flags, target: sub }));\n      case 'chat':\n      case 'tui':\n        if (rest.length) throw new Error('Use one repository folder: onboarder chat [folder].');\n        return codeOf(await runChat({ flags, target: sub, version: PACKAGE.version }));\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        if (isRemoteSource(cmd)) {\n          if (sub) throw new Error('Use onboarder chat <GitHub URL>, then type your question.');\n          return codeOf(await runChat({ target: cmd, flags, version: PACKAGE.version }));\n        }\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>>;