@neurcode-ai/cli 0.16.4 → 0.16.6

package/dist/commands/eval.js

@@ -0,0 +1,246 @@
+"use strict";
+/**
+ * `neurcode eval` — the guided enterprise evaluation runner.
+ *
+ * Turns the technical evaluation from a static checklist into an interactive,
+ * progress-aware flow a principal engineer can drive without a founder on the
+ * call. Subcommands:
+ *
+ *   neurcode eval start [--fixture] [--agent <id>]  — begin / scaffold the eval
+ *   neurcode eval status [--json]                   — progress + per-step facts
+ *   neurcode eval next [--json]                     — the single next command
+ *   neurcode eval export [--json] [--out <path>]    — source-free shareable report
+ *
+ * Everything here is source-free and read-only against the user's repo. The
+ * only thing that writes is `--fixture` mode (a controlled local demo repo) and
+ * the eval run-state / report under `.neurcode/eval/` (gitignored).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.evalCommand = evalCommand;
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const v0_governance_1 = require("../utils/v0-governance");
+const guided_eval_1 = require("../utils/guided-eval");
+let chalk;
+try {
+    chalk = require('chalk');
+}
+catch {
+    chalk = {
+        green: (s) => s,
+        yellow: (s) => s,
+        red: (s) => s,
+        dim: (s) => s,
+        bold: (s) => s,
+        cyan: (s) => s,
+    };
+}
+const EVAL_RUN_STATE_SCHEMA = 'neurcode.eval-run.v1';
+function evalDir(repoRoot) {
+    return (0, node_path_1.join)(repoRoot, '.neurcode', 'eval');
+}
+function runStatePath(repoRoot) {
+    return (0, node_path_1.join)(evalDir(repoRoot), 'run-state.json');
+}
+function loadRunState(repoRoot) {
+    const p = runStatePath(repoRoot);
+    if (!(0, node_fs_1.existsSync)(p))
+        return null;
+    try {
+        return JSON.parse((0, node_fs_1.readFileSync)(p, 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+function saveRunState(repoRoot, state) {
+    const dir = evalDir(repoRoot);
+    if (!(0, node_fs_1.existsSync)(dir))
+        (0, node_fs_1.mkdirSync)(dir, { recursive: true });
+    (0, node_fs_1.writeFileSync)(runStatePath(repoRoot), JSON.stringify(state, null, 2) + '\n', 'utf8');
+}
+/** Resolve agent/mode from flags, falling back to the saved run-state. */
+function resolveRun(options) {
+    const repoRoot = (0, v0_governance_1.resolveRepoRoot)(options.dir || process.cwd());
+    const saved = loadRunState(repoRoot);
+    const agent = options.agent ? (0, guided_eval_1.normalizeGuidedEvalAgent)(options.agent) : saved?.agent ?? 'claude';
+    const mode = options.fixture ? 'fixture' : saved?.mode ?? 'real';
+    const fixtureDir = (0, node_path_1.join)(repoRoot, '.neurcode', 'eval', 'fixture');
+    const gatherRoot = mode === 'fixture' && (0, node_fs_1.existsSync)(fixtureDir) ? fixtureDir : repoRoot;
+    return { repoRoot, agent, mode, gatherRoot };
+}
+function buildState(run) {
+    const ctx = (0, guided_eval_1.gatherGuidedEvalContext)(run.gatherRoot, { agent: run.agent, mode: run.mode });
+    return (0, guided_eval_1.buildGuidedEvalState)(ctx);
+}
+const STATUS_TONE = {
+    done: (s) => chalk.green(s),
+    pending: (s) => chalk.dim(s),
+    attention: (s) => chalk.yellow(s),
+    not_applicable: (s) => chalk.dim(s),
+};
+const STATUS_GLYPH = {
+    done: '✓',
+    pending: '○',
+    attention: '!',
+    not_applicable: '–',
+};
+function printState(state) {
+    const { summary } = state;
+    console.log('');
+    console.log(chalk.bold('Guided Enterprise Evaluation'));
+    console.log(chalk.dim(`  agent ${state.agent} · ${state.enforcementLabel} · mode ${state.mode}`));
+    const bar = '█'.repeat(Math.round(summary.percent / 10)) + '░'.repeat(10 - Math.round(summary.percent / 10));
+    console.log(`  ${bar} ${summary.percent}%  ` +
+        chalk.dim(`(${summary.done}/${summary.applicable} done${summary.attention ? `, ${summary.attention} need attention` : ''})`));
+    console.log('');
+    for (const step of state.steps) {
+        const glyph = STATUS_TONE[step.status](STATUS_GLYPH[step.status]);
+        const tier = chalk.dim(`[${guided_eval_1.GUIDED_EVAL_TRUTH_TIERS[step.truthTier].label}]`);
+        const title = step.status === 'done' ? chalk.green(step.title) : step.title;
+        console.log(`  ${glyph} ${title} ${tier}`);
+        if (step.fact)
+            console.log(chalk.dim(`      ${step.fact}`));
+    }
+    console.log('');
+    if (state.nextAction) {
+        console.log(chalk.bold('Next action:') + ` ${state.nextAction.title}`);
+        console.log(chalk.dim(`  why: ${state.nextAction.why}`));
+        for (const line of state.nextAction.command.split('\n'))
+            console.log(chalk.cyan(`  ${line}`));
+    }
+    else if (summary.complete) {
+        console.log(chalk.green('All applicable steps complete. Run `neurcode eval export` for a shareable report.'));
+    }
+    console.log('');
+}
+function evalCommand(program) {
+    const evalCmd = program
+        .command('eval')
+        .description('Guided enterprise evaluation — progress-aware, source-free, agent-specific');
+    // ── start ──────────────────────────────────────────────────────────────────
+    evalCmd
+        .command('start')
+        .description('Begin the guided evaluation (optionally scaffold a safe local fixture)')
+        .option('--dir <path>', 'Repository root (default: current directory)')
+        .option('--agent <id>', 'Agent posture: claude | codex | cursor | vscode | copilot | action', 'claude')
+        .option('--fixture', 'Create/use a controlled local demo fixture (never touches your source)')
+        .option('--json', 'Output machine-readable JSON')
+        .action((options) => {
+        const repoRoot = (0, v0_governance_1.resolveRepoRoot)(options.dir || process.cwd());
+        const agent = (0, guided_eval_1.normalizeGuidedEvalAgent)(options.agent);
+        const mode = options.fixture ? 'fixture' : 'real';
+        let fixture = null;
+        if (mode === 'fixture')
+            fixture = (0, guided_eval_1.scaffoldEvalFixture)(repoRoot);
+        const runState = {
+            schemaVersion: EVAL_RUN_STATE_SCHEMA,
+            agent,
+            mode,
+            startedAt: new Date().toISOString(),
+            repoRootHash: '',
+        };
+        const run = resolveRun({ dir: options.dir, agent, fixture: options.fixture });
+        const state = buildState(run);
+        runState.repoRootHash = state.repoRootHash;
+        saveRunState(repoRoot, runState);
+        if (options.json) {
+            console.log(JSON.stringify({ ok: true, runState, fixture, state }, null, 2));
+            return;
+        }
+        console.log('');
+        console.log(chalk.green('Guided evaluation started.'));
+        console.log(chalk.dim(`  agent: ${agent} · mode: ${mode}`));
+        if (fixture) {
+            console.log('');
+            console.log(chalk.bold('Safe fixture ready:') + ` ${fixture.relativeDir}`);
+            console.log(chalk.dim('  A throwaway repo with a CODEOWNERS boundary. Edits here never touch your source.'));
+            console.log(chalk.dim('  Run the block / approve / neighbor steps against this directory.'));
+        }
+        printState(state);
+        console.log(chalk.dim('Run `neurcode eval status` anytime, or `neurcode eval next` for just the next step.'));
+        console.log('');
+    });
+    // ── status ─────────────────────────────────────────────────────────────────
+    evalCmd
+        .command('status')
+        .description('Show evaluation progress and per-step facts')
+        .option('--dir <path>', 'Repository root (default: current directory)')
+        .option('--agent <id>', 'Override the agent posture for this view')
+        .option('--fixture', 'Inspect the local fixture state')
+        .option('--json', 'Output machine-readable JSON (for dashboard consumption)')
+        .action((options) => {
+        const run = resolveRun(options);
+        const state = buildState(run);
+        if (options.json) {
+            console.log(JSON.stringify(state, null, 2));
+            return;
+        }
+        printState(state);
+    });
+    // ── next ───────────────────────────────────────────────────────────────────
+    evalCmd
+        .command('next')
+        .description('Print exactly the next command to run for the selected agent')
+        .option('--dir <path>', 'Repository root (default: current directory)')
+        .option('--agent <id>', 'Override the agent posture')
+        .option('--fixture', 'Use the local fixture state')
+        .option('--json', 'Output machine-readable JSON')
+        .action((options) => {
+        const run = resolveRun(options);
+        const state = buildState(run);
+        if (options.json) {
+            console.log(JSON.stringify({ nextAction: state.nextAction, complete: state.summary.complete }, null, 2));
+            return;
+        }
+        if (!state.nextAction) {
+            console.log(chalk.green('Nothing pending — all applicable steps are complete.'));
+            console.log(chalk.dim('Run `neurcode eval export` for a shareable source-free report.'));
+            return;
+        }
+        console.log('');
+        console.log(chalk.bold(`Next: ${state.nextAction.title}`));
+        console.log(chalk.dim(`  ${state.nextAction.why}`));
+        for (const line of state.nextAction.command.split('\n'))
+            console.log(chalk.cyan(`  ${line}`));
+        console.log('');
+    });
+    // ── export ─────────────────────────────────────────────────────────────────
+    evalCmd
+        .command('export')
+        .description('Write a shareable, source-free evaluation report')
+        .option('--dir <path>', 'Repository root (default: current directory)')
+        .option('--agent <id>', 'Override the agent posture')
+        .option('--fixture', 'Export the local fixture evaluation')
+        .option('--out <path>', 'Output path for the JSON report (default: .neurcode/eval/guided-eval-report.json)')
+        .option('--json', 'Print the report JSON to stdout instead of a summary')
+        .action((options) => {
+        const run = resolveRun(options);
+        const ctx = (0, guided_eval_1.gatherGuidedEvalContext)(run.gatherRoot, { agent: run.agent, mode: run.mode });
+        const state = (0, guided_eval_1.buildGuidedEvalState)(ctx);
+        const report = (0, guided_eval_1.buildGuidedEvalReport)(state, ctx);
+        const markdown = (0, guided_eval_1.renderGuidedEvalReportMarkdown)(report);
+        // Source-free backstop before anything is written or printed.
+        (0, guided_eval_1.assertGuidedEvalSourceFree)(report, 'guided-eval report (json)');
+        (0, guided_eval_1.assertGuidedEvalSourceFree)(markdown, 'guided-eval report (markdown)');
+        const dir = evalDir(run.repoRoot);
+        if (!(0, node_fs_1.existsSync)(dir))
+            (0, node_fs_1.mkdirSync)(dir, { recursive: true });
+        const jsonPath = options.out ? (0, node_path_1.resolve)(run.repoRoot, options.out) : (0, node_path_1.join)(dir, 'guided-eval-report.json');
+        const mdPath = jsonPath.replace(/\.json$/, '.md');
+        (0, node_fs_1.writeFileSync)(jsonPath, JSON.stringify(report, null, 2) + '\n', 'utf8');
+        (0, node_fs_1.writeFileSync)(mdPath, markdown, 'utf8');
+        if (options.json) {
+            console.log(JSON.stringify(report, null, 2));
+            return;
+        }
+        console.log('');
+        console.log(chalk.green('Evaluation report written (source-free).'));
+        console.log(`  JSON:     ${chalk.cyan(jsonPath)}`);
+        console.log(`  Markdown: ${chalk.cyan(mdPath)}`);
+        console.log(chalk.dim(`  ${report.result.done}/${report.result.applicable} applicable steps done (${report.result.percent}%) · agent ${report.agent}`));
+        console.log(chalk.dim('  Contains paths, owners, symbol names, hashes, verdicts, and tiers only — no source.'));
+        console.log('');
+    });
+}
+//# sourceMappingURL=eval.js.map

package/dist/commands/eval.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eval.js","sourceRoot":"","sources":["../../src/commands/eval.ts"],"names":[],"mappings":"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"}

package/dist/commands/onboard.d.ts

@@ -0,0 +1,29 @@
+/**
+ * `neurcode onboard` — Self-serve enterprise onboarding walkthrough.
+ *
+ * Prints the step-by-step recipe for a first governed session, adapted to the
+ * selected agent. Covers: install, repo brain index, agent activation, health
+ * check, first governed session, boundary block, approval, evidence export.
+ *
+ * Use --agent to select the agent path. Defaults to claude.
+ * Use --json for machine-readable output.
+ */
+import type { Command } from 'commander';
+export type OnboardAgent = 'claude' | 'codex' | 'cursor' | 'copilot' | 'vscode' | 'action';
+export declare const ONBOARD_AGENTS: OnboardAgent[];
+export interface OnboardStep {
+    id: string;
+    title: string;
+    command: string;
+}
+export interface OnboardWalkthrough {
+    agent: OnboardAgent;
+    label: string;
+    guarantee: string;
+    steps: OnboardStep[];
+    dashboardUrl: string;
+}
+export declare function resolveOnboardAgent(value: string | undefined): OnboardAgent;
+export declare function buildOnboardWalkthrough(agent: OnboardAgent): OnboardWalkthrough;
+export declare function onboardCommand(program: Command): void;
+//# sourceMappingURL=onboard.d.ts.map

package/dist/commands/onboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboard.d.ts","sourceRoot":"","sources":["../../src/commands/onboard.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAkBzC,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE3F,eAAO,MAAM,cAAc,EAAE,YAAY,EAExC,CAAC;AAEF,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,YAAY,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,YAAY,CAI3E;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,YAAY,GAAG,kBAAkB,CAkK/E;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CA0DrD"}

package/dist/commands/onboard.js

@@ -0,0 +1,247 @@
+"use strict";
+/**
+ * `neurcode onboard` — Self-serve enterprise onboarding walkthrough.
+ *
+ * Prints the step-by-step recipe for a first governed session, adapted to the
+ * selected agent. Covers: install, repo brain index, agent activation, health
+ * check, first governed session, boundary block, approval, evidence export.
+ *
+ * Use --agent to select the agent path. Defaults to claude.
+ * Use --json for machine-readable output.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ONBOARD_AGENTS = void 0;
+exports.resolveOnboardAgent = resolveOnboardAgent;
+exports.buildOnboardWalkthrough = buildOnboardWalkthrough;
+exports.onboardCommand = onboardCommand;
+let chalk;
+try {
+    chalk = require('chalk');
+}
+catch {
+    chalk = {
+        cyan: (s) => s,
+        green: (s) => s,
+        yellow: (s) => s,
+        bold: (s) => s,
+        dim: (s) => s,
+        gray: (s) => s,
+        white: (s) => s,
+        red: (s) => s,
+    };
+}
+exports.ONBOARD_AGENTS = [
+    'claude', 'codex', 'cursor', 'copilot', 'vscode', 'action',
+];
+function resolveOnboardAgent(value) {
+    if (!value)
+        return 'claude';
+    const lower = value.toLowerCase();
+    return exports.ONBOARD_AGENTS.includes(lower) ? lower : 'claude';
+}
+function buildOnboardWalkthrough(agent) {
+    const brain = 'neurcode brain index\nneurcode brain inspect "billing auth payments"';
+    const exportEvidence = 'neurcode session export-admission <session-id> --explain';
+    const viewEvidence = '# Dashboard → Runtime Evidence → click session ID\n# Verify: boundary events, approval chain, replay hash, no source code';
+    let label;
+    let guarantee;
+    let steps;
+    if (agent === 'claude') {
+        label = 'Claude Code';
+        guarantee = 'Hard pre-write deny where Claude hooks are installed and healthy.';
+        steps = [
+            { id: 'install', title: 'Verify CLI install', command: 'npx -y @neurcode-ai/cli@latest --version' },
+            { id: 'brain', title: 'Build repo brain', command: brain },
+            {
+                id: 'activate',
+                title: 'Activate Claude Code',
+                command: 'npx -y @neurcode-ai/cli@latest activate claude --dir .\n' +
+                    '# Or with token from Runtime Control Plane:\n' +
+                    'npx -y @neurcode-ai/cli@latest activate claude --connect <short-lived-token> --dir .',
+            },
+            { id: 'health', title: 'Verify health', command: 'neurcode doctor --runtime' },
+            {
+                id: 'session',
+                title: 'Start a governed session',
+                command: '# Open Claude Code in the paired repo.\n' +
+                    '# Prompt normally — hooks run start/check/finish automatically.\n' +
+                    '# Begin with a safe file to confirm no false blocks.',
+            },
+            {
+                id: 'block',
+                title: 'Trigger a boundary block',
+                command: '# Ask Claude to edit a CODEOWNERS-covered file:\n' +
+                    '#   > Update src/billing/charge.py with a network retry.\n' +
+                    '# Block appears in Runtime Control Plane → block queue.',
+            },
+            {
+                id: 'approve',
+                title: 'Approve the exact path',
+                command: 'neurcode approve <approval-id>\n# Approves ONLY the exact path. Sibling files remain blocked.',
+            },
+            { id: 'export', title: 'Export AI Change Record', command: exportEvidence },
+            { id: 'view', title: 'View Runtime Evidence', command: viewEvidence },
+        ];
+    }
+    else if (agent === 'cursor') {
+        label = 'Cursor';
+        guarantee = 'Cooperative checks plus local supervisor containment. No native hard pre-write denial.';
+        steps = [
+            { id: 'install', title: 'Verify CLI install', command: 'npx -y @neurcode-ai/cli@latest --version' },
+            { id: 'brain', title: 'Build repo brain', command: brain },
+            {
+                id: 'activate',
+                title: 'Activate Cursor',
+                command: 'npx -y @neurcode-ai/cli@latest cursor onboard --strict\nneurcode cursor gate install --hook both',
+            },
+            { id: 'health', title: 'Verify health', command: 'neurcode cursor health --record' },
+            {
+                id: 'session',
+                title: 'Start a guarded session',
+                command: 'neurcode agent guard start cursor \\\n' +
+                    '  --goal "Add retry to export task" \\\n' +
+                    '  --plan "Edit src/tasks/export_task.ts only; keep billing untouched"',
+            },
+            { id: 'block', title: 'Trigger a boundary check', command: 'neurcode agent check src/billing/charge.py --agent cursor' },
+            {
+                id: 'approve',
+                title: 'Approve and finish',
+                command: '# Dashboard → Approval Ledger → Approve\n' +
+                    'neurcode agent guard finish --session-id <session-id> --fail-on-unverified\n' +
+                    'neurcode agent report cursor --session-id <session-id>',
+            },
+            { id: 'export', title: 'Export AI Change Record', command: exportEvidence },
+            { id: 'view', title: 'View Runtime Evidence', command: viewEvidence },
+        ];
+    }
+    else if (agent === 'action') {
+        label = 'GitHub Action';
+        guarantee = 'Post-PR advisory routing and admission display. Not live pre-write enforcement.';
+        steps = [
+            { id: 'install', title: 'Verify CLI install', command: 'npx -y @neurcode-ai/cli@latest --version' },
+            { id: 'brain', title: 'Build repo brain', command: brain },
+            {
+                id: 'activate',
+                title: 'Add GitHub Action',
+                command: '# .github/workflows/neurcode.yml\n- uses: sujit-jaunjal/neurcode-actions@v0.3.0-rc.5',
+            },
+            { id: 'health', title: 'Verify Action runs', command: 'gh run list --workflow neurcode.yml --limit 3' },
+            {
+                id: 'session',
+                title: 'Open a PR',
+                command: '# Open a PR that edits non-sensitive files first.\n' +
+                    '# Action comment shows: no boundary facts matched.',
+            },
+            {
+                id: 'block',
+                title: 'Trigger boundary in PR',
+                command: '# Open a PR editing a CODEOWNERS-covered file.\n' +
+                    '# Action comment shows: boundary facts, trust level.',
+            },
+            {
+                id: 'approve',
+                title: 'Attach admission record',
+                command: 'neurcode session export-admission <session-id>\n' +
+                    'git add .neurcode-admission/*.json\n' +
+                    'git commit -m "Add Neurcode runtime admission context"',
+            },
+            { id: 'export', title: 'Export AI Change Record', command: exportEvidence },
+            {
+                id: 'view',
+                title: 'View Action report',
+                command: '# GitHub PR → Checks → Neurcode Runtime Admission Advisory\n' +
+                    '# Dashboard → Runtime Evidence',
+            },
+        ];
+    }
+    else {
+        // codex / copilot / vscode
+        const agentId = agent === 'vscode' ? 'vscode' : agent === 'copilot' ? 'copilot' : 'codex';
+        label =
+            agent === 'vscode' ? 'VS Code / Copilot' : agent === 'copilot' ? 'GitHub Copilot' : 'Codex';
+        guarantee = 'Cooperative guard plus supervisor evidence. No host-level hard pre-write deny is claimed.';
+        steps = [
+            { id: 'install', title: 'Verify CLI install', command: 'npx -y @neurcode-ai/cli@latest --version' },
+            { id: 'brain', title: 'Build repo brain', command: brain },
+            {
+                id: 'activate',
+                title: `Activate ${label}`,
+                command: `npx -y @neurcode-ai/cli@latest agent walkthrough ${agentId}\nneurcode agent bootstrap ${agentId}`,
+            },
+            { id: 'health', title: 'Verify health', command: `neurcode agent doctor ${agentId}` },
+            {
+                id: 'session',
+                title: 'Start a guarded session',
+                command: `neurcode agent guard start ${agentId} \\\n` +
+                    `  --goal "Add retry to export task" \\\n` +
+                    `  --plan "Edit src/tasks/export_task.ts only; keep billing untouched"`,
+            },
+            { id: 'block', title: 'Trigger a boundary check', command: `neurcode agent check src/billing/charge.py --agent ${agentId}` },
+            {
+                id: 'approve',
+                title: 'Approve and finish',
+                command: `# Dashboard → Approval Ledger → Approve\n` +
+                    `neurcode agent guard finish --session-id <session-id> --fail-on-unverified\n` +
+                    `neurcode agent report ${agentId} --session-id <session-id>`,
+            },
+            { id: 'export', title: 'Export AI Change Record', command: exportEvidence },
+            { id: 'view', title: 'View Runtime Evidence', command: viewEvidence },
+        ];
+    }
+    return { agent, label, guarantee, steps, dashboardUrl: 'https://app.neurcode.com' };
+}
+function onboardCommand(program) {
+    program
+        .command('onboard')
+        .description('Step-by-step onboarding walkthrough for the selected AI agent.\n' +
+        'Covers: install, repo brain, activation, health check, governed session,\n' +
+        'boundary block, exact-path approval, AI Change Record export.')
+        .option('--agent <agent>', `Agent path: ${exports.ONBOARD_AGENTS.join(' | ')}`, 'claude')
+        .option('--json', 'Emit machine-readable JSON instead of the walkthrough')
+        .action((opts) => {
+        const agent = resolveOnboardAgent(opts.agent);
+        const walkthrough = buildOnboardWalkthrough(agent);
+        if (opts.json) {
+            console.log(JSON.stringify(walkthrough, null, 2));
+            return;
+        }
+        const yellow = chalk.yellow;
+        const dim = chalk.dim;
+        const green = chalk.green;
+        const bold = chalk.bold;
+        const gray = chalk.gray;
+        const SEP = dim('─'.repeat(72));
+        console.log('');
+        console.log(bold(yellow('Neurcode Self-Serve Onboarding')));
+        console.log(dim(`Agent: ${walkthrough.label}`));
+        console.log(dim(`Posture: ${walkthrough.guarantee}`));
+        console.log('');
+        console.log(SEP);
+        walkthrough.steps.forEach(({ title, command }, i) => {
+            console.log('');
+            console.log(bold(`  Step ${i + 1}: ${title}`));
+            command.split('\n').forEach((line) => {
+                if (line.startsWith('#')) {
+                    console.log(gray(`  ${line}`));
+                }
+                else if (line.trim() === '') {
+                    console.log('');
+                }
+                else {
+                    console.log(green(`  ${line}`));
+                }
+            });
+        });
+        console.log('');
+        console.log(SEP);
+        console.log('');
+        console.log(bold('  Next steps'));
+        console.log(dim('  Dashboard:       https://app.neurcode.com'));
+        console.log(dim('  Setup checklist: /w/me/setup'));
+        console.log(dim('  Tech eval:       /w/me/enterprise-eval'));
+        console.log(dim('  Agent matrix:    /w/me/integrations'));
+        console.log(dim('  CI setup:        /w/me/onboarding/ci'));
+        console.log('');
+    });
+}
+//# sourceMappingURL=onboard.js.map

package/dist/commands/onboard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboard.js","sourceRoot":"","sources":["../../src/commands/onboard.ts"],"names":[],"mappings":"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"}

package/dist/commands/runtime-doctor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime-doctor.d.ts","sourceRoot":"","sources":["../../src/commands/runtime-doctor.ts"],"names":[],"mappings":"AAmDA,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAsBD,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,oBAAyB,GAAG,IAAI,CAgb7E"}
+{"version":3,"file":"runtime-doctor.d.ts","sourceRoot":"","sources":["../../src/commands/runtime-doctor.ts"],"names":[],"mappings":"AAoDA,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAsBD,wBAAgB,oBAAoB,CAAC,OAAO,GAAE,oBAAyB,GAAG,IAAI,CA0f7E"}