robrain 0.1.0

package/dist/commands/install.js

@@ -0,0 +1,305 @@
+// src/commands/install.ts
+// ─────────────────────────────────────────────────────────────
+// robrain install [--token TOKEN] [--editor claude-code|cursor|copilot]
+//
+// 1. Authenticate with Rory Plans
+// 2. Fetch provisioned API URLs + keys
+// 3. Prompt for embedding provider if not set
+// 4. Detect editors (or use --editor flag)
+// 5. Write MCP config to each detected editor
+// 6. Save config to ~/.robrain/config.json
+// ─────────────────────────────────────────────────────────────
+import chalk from 'chalk';
+import ora from 'ora';
+import prompts from 'prompts';
+import { readConfig, writeConfig, mergeConfig } from '../lib/config.js';
+import { validateToken, fetchProvisionedConfig } from '../lib/auth.js';
+import { detectEditors, writeMcpConfig } from '../lib/editor.js';
+import { ensureSensingMcpBundle, controlBundleReady, sensingBundleReady, McpBundleError, } from '../lib/mcp-bundle.js';
+import { loadInstallEnv } from '../lib/load-env.js';
+import { join } from 'path';
+import { homedir } from 'os';
+const ROBRAIN_MCP_DIR = join(homedir(), '.robrain', 'mcp');
+function resolveRepoRoot(opts) {
+    return opts.repoRoot ?? process.env.ROBRAIN_REPO;
+}
+function prepareMcpBundles(opts) {
+    const repoRoot = resolveRepoRoot(opts);
+    if (!repoRoot && !sensingBundleReady(ROBRAIN_MCP_DIR)) {
+        console.log(chalk.red('\n  ✗ Sensing MCP bundle missing.'));
+        console.log(chalk.dim('    Expected: ') + join(ROBRAIN_MCP_DIR, 'sensing', 'dist', 'index.js'));
+        console.log(chalk.dim('\n    Fix: from your robrain clone run ') + chalk.cyan('pnpm install') + chalk.dim(' + ') + chalk.cyan('pnpm build'));
+        console.log(chalk.dim('    Then reinstall with: ') + chalk.cyan('robrain install --repo-root /path/to/robrain'));
+        console.log(chalk.dim('    (or set ') + chalk.cyan('ROBRAIN_REPO') + chalk.dim(' to that path)\n'));
+        process.exit(1);
+    }
+    if (!repoRoot && sensingBundleReady(ROBRAIN_MCP_DIR))
+        return;
+    try {
+        ensureSensingMcpBundle(repoRoot, ROBRAIN_MCP_DIR);
+    }
+    catch (e) {
+        if (e instanceof McpBundleError) {
+            console.log(chalk.red(`\n  ✗ ${e.message}\n`));
+            process.exit(1);
+        }
+        throw e;
+    }
+}
+export async function installCommand(opts) {
+    loadInstallEnv(resolveRepoRoot(opts));
+    console.log();
+    console.log(chalk.bold('  RoBrain') + chalk.dim(' — institutional memory for AI coding agents'));
+    console.log(chalk.dim('  by roryplans.ai\n'));
+    // ── Self-hosted mode — skip Rory Plans auth entirely ──────
+    if (opts.selfHosted) {
+        prepareMcpBundles(opts);
+        return installSelfHosted(opts);
+    }
+    prepareMcpBundles(opts);
+    // ── Cloud mode — authenticate with Rory Plans ─────────────
+    let token = opts.token ?? readConfig().token;
+    if (!token) {
+        console.log(chalk.dim('  Get your token at: ') + chalk.cyan('https://roryplans.ai/settings/api\n'));
+        const { inputToken } = await prompts({
+            type: 'password',
+            name: 'inputToken',
+            message: 'Rory Plans API token:',
+        });
+        if (!inputToken) {
+            console.log(chalk.red('\n  ✗ No token provided. Exiting.'));
+            process.exit(1);
+        }
+        token = inputToken;
+    }
+    // ── Step 2: Validate token ─────────────────────────────────
+    const spinner = ora({ text: 'Connecting to roryplans.ai...', color: 'green' }).start();
+    const authResult = await validateToken(token);
+    if (!authResult.ok) {
+        spinner.fail(chalk.red(`Authentication failed: ${authResult.error}`));
+        console.log(chalk.dim('\n  Create an account at https://roryplans.ai'));
+        process.exit(1);
+    }
+    spinner.succeed(`Authenticated as ${chalk.bold(authResult.email)}`);
+    // ── Step 3: Fetch provisioned config ───────────────────────
+    spinner.start('Fetching provisioned API config...');
+    const provisioned = await fetchProvisionedConfig(token);
+    if (!provisioned) {
+        spinner.fail('Could not fetch provisioned config. Contact support@roryplans.ai');
+        process.exit(1);
+    }
+    spinner.succeed('API endpoints configured');
+    // ── Step 4: Embedding provider ─────────────────────────────
+    let embeddingProvider = provisioned.embeddingProvider;
+    let embeddingKey = '';
+    if (!embeddingProvider) {
+        console.log();
+        const { provider } = await prompts({
+            type: 'select',
+            name: 'provider',
+            message: 'Choose embedding provider (for semantic search):',
+            choices: [
+                { title: 'OpenAI  text-embedding-3-small (~$0.00002/1k tokens)', value: 'openai' },
+                { title: 'Voyage  voyage-3-lite (fast, cheap alternative)', value: 'voyage' },
+                { title: 'Cohere  embed-english-v3.0 (higher quality)', value: 'cohere' },
+            ],
+        });
+        embeddingProvider = provider;
+        const keyName = {
+            openai: 'OPENAI_API_KEY',
+            voyage: 'VOYAGE_API_KEY',
+            cohere: 'COHERE_API_KEY',
+        }[embeddingProvider] ?? 'EMBEDDING_API_KEY';
+        embeddingKey = process.env[keyName] ?? '';
+        if (embeddingKey) {
+            console.log(chalk.dim(`  Using ${keyName} from environment`));
+        }
+        else {
+            const { key } = await prompts({
+                type: 'password',
+                name: 'key',
+                message: `${keyName}:`,
+            });
+            embeddingKey = key;
+        }
+    }
+    // ── Step 5: Detect / select editors ───────────────────────
+    const detected = detectEditors();
+    let editorsToConfig = detected;
+    if (opts.editor) {
+        editorsToConfig = detected.filter(e => e.editor === opts.editor);
+        if (editorsToConfig.length === 0) {
+            // Force the specified editor even if not detected
+            const configPaths = {
+                'claude-code': join(homedir(), '.claude.json'),
+                'cursor': join(homedir(), '.cursor', 'mcp.json'),
+            };
+            const configPath = configPaths[opts.editor];
+            if (configPath) {
+                editorsToConfig = [{
+                        editor: opts.editor,
+                        configPath,
+                        label: opts.editor,
+                    }];
+            }
+        }
+    }
+    else if (detected.length === 0) {
+        console.log(chalk.yellow('\n  No AI editors detected. Configuring Claude Code by default.'));
+        editorsToConfig = [{
+                editor: 'claude-code',
+                configPath: join(homedir(), '.claude.json'),
+                label: 'Claude Code',
+            }];
+    }
+    else if (detected.length > 1) {
+        console.log();
+        const { chosen } = await prompts({
+            type: 'multiselect',
+            name: 'chosen',
+            message: 'Configure RoBrain for which editors?',
+            choices: detected.map(e => ({ title: e.label, value: e.editor, selected: true })),
+        });
+        editorsToConfig = detected.filter(e => chosen.includes(e.editor));
+    }
+    // ── Step 6: Write MCP configs ──────────────────────────────
+    spinner.start('Writing MCP configuration...');
+    const includeControl = controlBundleReady(ROBRAIN_MCP_DIR);
+    const mcpOpts = {
+        sensingMcpPath: join(ROBRAIN_MCP_DIR, 'sensing', 'dist', 'index.js'),
+        controlMcpPath: join(ROBRAIN_MCP_DIR, 'control', 'dist', 'index.js'),
+        anthropicKey: process.env.ANTHROPIC_API_KEY ?? '',
+        perceptionUrl: provisioned.perceptionUrl,
+        perceptionKey: provisioned.perceptionKey,
+        planningUrl: provisioned.planningUrl,
+        planningKey: provisioned.planningKey,
+        embeddingProvider: embeddingProvider ?? 'openai',
+        embeddingKey,
+        includeControl,
+    };
+    for (const editor of editorsToConfig) {
+        writeMcpConfig(editor.configPath, mcpOpts);
+    }
+    if (!includeControl) {
+        console.log(chalk.yellow('  ⚠ robrain-control was not registered — no Control MCP bundle under ~/.robrain/mcp/control.\n' +
+            '    OSS/manual retrieval: use robrain inject. Rory Plans cloud supplies Control for auto-injection.'));
+        console.log();
+    }
+    // ── Step 7: Save local config ──────────────────────────────
+    writeConfig({
+        token,
+        email: authResult.email,
+        perceptionUrl: provisioned.perceptionUrl,
+        perceptionKey: provisioned.perceptionKey,
+        planningUrl: provisioned.planningUrl,
+        planningKey: provisioned.planningKey,
+        embeddingProvider: embeddingProvider ?? 'openai',
+        installedAt: new Date().toISOString(),
+        version: '0.1.0',
+    });
+    spinner.succeed('MCP servers configured');
+    // ── Done ───────────────────────────────────────────────────
+    console.log();
+    console.log(chalk.green('  ✓ RoBrain installed successfully\n'));
+    console.log(chalk.dim('  Configured for: ') + editorsToConfig.map(e => e.label).join(', '));
+    console.log();
+    console.log(chalk.bold('  Next step:') + chalk.dim(' initialize your project memory'));
+    console.log(chalk.dim('  Run in your project root: ') + chalk.cyan('robrain init-project'));
+    console.log();
+    // Check if ANTHROPIC_API_KEY is set — needed by Sensing
+    if (!process.env.ANTHROPIC_API_KEY) {
+        console.log(chalk.yellow('  ⚠ ANTHROPIC_API_KEY not found in environment.'));
+        console.log(chalk.dim('  Add it to repo-root `.env`, your shell profile, or the MCP config env block, then re-run install if needed.'));
+        console.log();
+    }
+}
+// ── Self-hosted install ────────────────────────────────────────
+// Skips Rory Plans auth. Points Sensing MCP at a local
+// Perception instance started with pnpm docker:up.
+async function installSelfHosted(opts) {
+    const perceptionUrl = opts.perceptionUrl ?? 'http://localhost:3001';
+    console.log(chalk.bold('  Self-hosted mode\n'));
+    console.log(chalk.dim('  Sensing MCP will connect to: ') + chalk.cyan(perceptionUrl));
+    console.log(chalk.dim('  Make sure Perception is running: ') + chalk.cyan('pnpm docker:up\n'));
+    const envProvider = process.env.EMBEDDING_PROVIDER;
+    let provider;
+    if (envProvider === 'openai' || envProvider === 'voyage' || envProvider === 'cohere') {
+        provider = envProvider;
+        console.log(chalk.dim(`  Using EMBEDDING_PROVIDER from environment (${provider})`));
+        console.log(chalk.dim('  Must match the repo-root `.env` used by `pnpm docker:up`.\n'));
+    }
+    else {
+        const { provider: choice } = await prompts({
+            type: 'select',
+            name: 'provider',
+            message: 'Embedding provider (must match repo-root `.env` for `pnpm docker:up`):',
+            choices: [
+                { title: 'OpenAI  text-embedding-3-small', value: 'openai' },
+                { title: 'Voyage  voyage-3-lite', value: 'voyage' },
+                { title: 'Cohere  embed-english-v3.0', value: 'cohere' },
+            ],
+        });
+        provider = choice;
+    }
+    const keyName = { openai: 'OPENAI_API_KEY', voyage: 'VOYAGE_API_KEY', cohere: 'COHERE_API_KEY' }[provider] ?? 'EMBEDDING_API_KEY';
+    let embKey = process.env[keyName] ?? '';
+    if (embKey) {
+        console.log(chalk.dim(`  Using ${keyName} from environment`));
+    }
+    else {
+        const answer = await prompts({ type: 'password', name: 'embKey', message: `${keyName}:` });
+        embKey = answer.embKey;
+    }
+    let anthropicKey = process.env.ANTHROPIC_API_KEY ?? '';
+    if (anthropicKey) {
+        console.log(chalk.dim('  Using ANTHROPIC_API_KEY from environment'));
+    }
+    else {
+        const answer = await prompts({ type: 'password', name: 'anthropicKey', message: 'ANTHROPIC_API_KEY (for Sensing classifiers):' });
+        anthropicKey = answer.anthropicKey;
+    }
+    // Detect editors
+    const detected = detectEditors();
+    const editorsToConfig = detected.length > 0 ? detected : [{
+            editor: 'claude-code',
+            configPath: join(homedir(), '.claude.json'),
+            label: 'Claude Code',
+        }];
+    const spinner = ora('Writing MCP configuration...').start();
+    const mcpOpts = {
+        sensingMcpPath: join(ROBRAIN_MCP_DIR, 'sensing', 'dist', 'index.js'),
+        controlMcpPath: join(ROBRAIN_MCP_DIR, 'control', 'dist', 'index.js'),
+        anthropicKey,
+        perceptionUrl,
+        perceptionKey: '',
+        planningUrl: '', // no Planning in self-hosted OSS
+        planningKey: '',
+        embeddingProvider: provider,
+        embeddingKey: embKey,
+        includeControl: false,
+    };
+    for (const editor of editorsToConfig) {
+        writeMcpConfig(editor.configPath, mcpOpts);
+    }
+    mergeConfig({
+        perceptionUrl,
+        embeddingProvider: provider,
+        installedAt: new Date().toISOString(),
+        version: '0.1.0',
+        selfHosted: true,
+    });
+    spinner.succeed('MCP servers configured for self-hosted mode');
+    console.log();
+    console.log(chalk.green('  ✓ RoBrain (self-hosted) installed\n'));
+    console.log(chalk.dim('  Perception: ') + chalk.cyan(perceptionUrl));
+    console.log(chalk.dim('  Planning + Control injection: ') + chalk.yellow('not available in self-hosted OSS'));
+    console.log();
+    console.log(chalk.dim('  Context retrieval: use ') + chalk.cyan('robrain inject') + chalk.dim(' to get context for manual paste'));
+    console.log();
+    console.log(chalk.bold('  Next: ') + chalk.dim('run ') + chalk.cyan('robrain init-project') + chalk.dim(' in your repo root'));
+    console.log();
+    console.log(chalk.dim('  Want automatic injection without pasting?'));
+    console.log(chalk.dim('  → ') + chalk.cyan('roryplans.ai') + chalk.dim(' — Control MCP handles it automatically'));
+    console.log();
+}
+//# sourceMappingURL=install.js.map

package/dist/commands/install.js.map

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

package/dist/commands/review.d.ts

@@ -0,0 +1,9 @@
+interface ReviewOptions {
+    session?: string;
+    all?: boolean;
+    history?: boolean;
+    limit?: number;
+}
+export declare function reviewCommand(opts: ReviewOptions): Promise<void>;
+export {};
+//# sourceMappingURL=review.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../../src/commands/review.ts"],"names":[],"mappings":"AAmBA,UAAU,aAAa;IACrB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,GAAG,CAAC,EAAM,OAAO,CAAA;IACjB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,KAAK,CAAC,EAAI,MAAM,CAAA;CACjB;AAkBD,wBAAsB,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CA6JtE"}

package/dist/commands/review.js

@@ -0,0 +1,299 @@
+// src/commands/review.ts
+// ─────────────────────────────────────────────────────────────
+// robrain review [--session last|SESSION_ID] [--all] [--limit N]
+//
+// Shows decisions captured in recent sessions so developers can
+// review what the system stored, edit wrong decisions, and delete
+// hallucinated ones before they pollute future injections.
+//
+// This is the trust layer — developers should never have to rely
+// on memories they've never seen.
+// ─────────────────────────────────────────────────────────────
+import chalk from 'chalk';
+import ora from 'ora';
+import prompts from 'prompts';
+import { readConfig, isAuthenticated } from '../lib/config.js';
+import { gatherProjectInfo } from '../lib/project.js';
+import { cwd } from 'process';
+export async function reviewCommand(opts) {
+    console.log();
+    if (!isAuthenticated()) {
+        console.log(chalk.red('  ✗ Not authenticated. Run: robrain install'));
+        process.exit(1);
+    }
+    const config = readConfig();
+    const info = gatherProjectInfo(cwd());
+    const percUrl = config.perceptionUrl;
+    const percKey = config.perceptionKey ?? '';
+    if (!percUrl) {
+        console.log(chalk.red('  ✗ Perception URL not configured. Run: robrain install'));
+        process.exit(1);
+    }
+    // ── Fetch decisions from Perception ───────────────────────
+    const spinner = ora({ text: 'Fetching stored decisions...', color: 'green' }).start();
+    const limit = opts.limit ?? 20;
+    const params = new URLSearchParams({
+        project_id: info.id,
+        limit: String(limit),
+        ...(opts.session && opts.session !== 'last' && { session_id: opts.session }),
+        ...(opts.all ? { all: 'true' } : { recent: 'true' }),
+        ...(opts.history ? { history: 'true' } : {}),
+    });
+    let decisions = [];
+    try {
+        const res = await fetch(`${percUrl}/decisions?${params}`, {
+            headers: percKey ? { 'Authorization': `Bearer ${percKey}` } : {},
+        });
+        if (!res.ok) {
+            spinner.fail(`Could not fetch decisions (${res.status})`);
+            process.exit(1);
+        }
+        const data = await res.json();
+        decisions = data.decisions ?? [];
+    }
+    catch {
+        spinner.fail('Could not reach Perception API');
+        process.exit(1);
+    }
+    spinner.stop();
+    if (decisions.length === 0) {
+        console.log(chalk.dim(`  No decisions stored yet for ${chalk.bold(info.name)}.`));
+        console.log(chalk.dim('  Run a Claude Code session to start capturing memory.\n'));
+        return;
+    }
+    // ── Display header ─────────────────────────────────────────
+    console.log(chalk.bold(`  Memory review — ${info.name}`));
+    console.log(chalk.dim(`  ${decisions.length} decision${decisions.length === 1 ? '' : 's'} · Project ID: ${info.id}`));
+    if (opts.history) {
+        console.log(chalk.dim('  Showing full history including superseded decisions\n'));
+    }
+    else {
+        console.log(chalk.dim('  Showing active decisions only · use --history to see full lifecycle\n'));
+    }
+    // ── Display each decision ──────────────────────────────────
+    for (let i = 0; i < decisions.length; i++) {
+        const d = decisions[i];
+        const index = chalk.dim(`[${i + 1}/${decisions.length}]`);
+        const date = new Date(d.created_at).toLocaleDateString('en-US', { month: 'short', day: 'numeric', year: 'numeric' });
+        const conf = d.confidence >= 0.9 ? chalk.green('high')
+            : d.confidence >= 0.6 ? chalk.yellow('medium')
+                : chalk.red('low');
+        // Lifecycle state
+        const isSuperseded = !!d.invalidated_at;
+        const statusLabel = isSuperseded
+            ? chalk.dim('  ↩ SUPERSEDED')
+            : d.conflict_flag
+                ? chalk.yellow('  ⚠ CONFLICT — needs resolution')
+                : null;
+        if (statusLabel)
+            console.log(statusLabel);
+        // Decision text — dim if superseded
+        const decisionText = isSuperseded
+            ? chalk.dim(`  ${index} ${d.decision}`)
+            : `  ${index} ${chalk.bold(d.decision)}`;
+        console.log(decisionText);
+        if (d.rationale) {
+            console.log(chalk.dim(`     because: `) + (isSuperseded ? chalk.dim(d.rationale) : d.rationale));
+        }
+        if (d.rejected.length > 0) {
+            const vetoes = d.rejected.map(r => `${chalk.dim(r.option)} ${chalk.dim(`(${r.reason})`)}`).join(', ');
+            console.log(chalk.dim(`     rejected: `) + vetoes);
+        }
+        if (d.files_affected.length > 0) {
+            console.log(chalk.dim(`     files:    `) + d.files_affected.slice(0, 3).join(', ') + (d.files_affected.length > 3 ? ` +${d.files_affected.length - 3} more` : ''));
+        }
+        // Lifecycle info
+        if (d.supersedes_id) {
+            console.log(chalk.dim(`     ↩ replaces: `) + chalk.dim(`earlier decision (${d.supersedes_id.slice(0, 8)}...)`));
+        }
+        if (isSuperseded && d.invalidated_at) {
+            const supersededDate = new Date(d.invalidated_at).toLocaleDateString('en-US', { month: 'short', day: 'numeric', year: 'numeric' });
+            console.log(chalk.dim(`     ↪ superseded: ${supersededDate}`));
+        }
+        console.log(chalk.dim(`     ${date} · confidence: `) + conf + chalk.dim(` · scope: ${d.scope}`));
+        // Skip per-decision prompt for superseded decisions in history mode
+        if (isSuperseded) {
+            console.log();
+            continue;
+        }
+        // ── Per-decision inline action ─────────────────────────
+        const { action } = await prompts({
+            type: 'select',
+            name: 'action',
+            message: 'Action:',
+            choices: [
+                { title: '✔  Accept — looks correct', value: 'accept' },
+                { title: '✏️  Edit — fix decision text', value: 'edit' },
+                { title: '❌ Reject — delete this', value: 'reject' },
+                ...(d.conflict_flag
+                    ? [{ title: '⚠️  Resolve conflict', value: 'resolve' }]
+                    : []),
+                { title: '⏭  Skip remaining', value: 'skip_all' },
+            ],
+        });
+        console.log();
+        if (!action || action === 'skip_all')
+            break;
+        if (action === 'edit') {
+            await editDecisionInline(d, percUrl, percKey, info.id);
+        }
+        if (action === 'reject') {
+            await rejectDecisionInline(d, percUrl, percKey);
+        }
+        if (action === 'resolve') {
+            await resolveConflictInline(d, percUrl, percKey, info.id);
+        }
+        // 'accept' — no action needed, move to next
+    }
+    console.log(chalk.green('  ✓ Review complete\n'));
+}
+// ── Inline: edit a single decision ────────────────────────────
+function normalizedRationale(value) {
+    if (value == null)
+        return null;
+    const t = value.trim();
+    return t === '' ? null : t;
+}
+async function editDecisionInline(d, percUrl, percKey, projectId) {
+    const { newDecision } = await prompts({
+        type: 'text',
+        name: 'newDecision',
+        message: 'Corrected decision:',
+        initial: d.decision,
+    });
+    if (newDecision == null) {
+        console.log(chalk.dim('  Cancelled.'));
+        return;
+    }
+    const trimmedDecision = newDecision.trim();
+    if (trimmedDecision === '') {
+        console.log(chalk.dim('  Cancelled.'));
+        return;
+    }
+    const priorRationale = normalizedRationale(d.rationale);
+    const { newRationale } = await prompts({
+        type: 'text',
+        name: 'newRationale',
+        message: 'Corrected rationale (blank removes; unchanged text keeps current):',
+        initial: d.rationale ?? '',
+    });
+    // Cancelled rationale step — keep prior rationale; decision text may still have changed.
+    let correctedRationale;
+    if (newRationale == null) {
+        correctedRationale = priorRationale;
+    }
+    else if (newRationale.trim() === '') {
+        correctedRationale = null;
+    }
+    else {
+        correctedRationale = newRationale.trim();
+    }
+    const decisionChanged = trimmedDecision !== d.decision.trim();
+    const rationaleChanged = correctedRationale !== priorRationale;
+    if (!decisionChanged && !rationaleChanged) {
+        console.log(chalk.dim('  No change made.'));
+        return;
+    }
+    const spinner = ora('Saving correction...').start();
+    try {
+        const res = await fetch(`${percUrl}/corrections`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...(percKey ? { 'Authorization': `Bearer ${percKey}` } : {}),
+                'X-Project-Id': projectId,
+                'X-Session-Id': 'robrain-review-cli',
+            },
+            body: JSON.stringify({
+                decision_id: d.id,
+                corrected_decision: trimmedDecision,
+                corrected_rationale: correctedRationale,
+                invalidate: true,
+                source: 'user_correction',
+            }),
+        });
+        res.ok
+            ? spinner.succeed(chalk.green('✔ Decision updated'))
+            : spinner.fail('Could not save correction');
+    }
+    catch {
+        spinner.fail('Could not reach Perception API');
+    }
+}
+// ── Inline: reject (invalidate) a single decision ─────────────
+async function rejectDecisionInline(d, percUrl, percKey) {
+    const { confirm } = await prompts({
+        type: 'confirm',
+        name: 'confirm',
+        message: chalk.yellow(`Reject "${d.decision.slice(0, 60)}"? It won't be injected in future sessions.`),
+        initial: false,
+    });
+    if (!confirm) {
+        console.log(chalk.dim('  Skipped.'));
+        return;
+    }
+    const spinner = ora('Rejecting...').start();
+    try {
+        const res = await fetch(`${percUrl}/corrections`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...(percKey ? { 'Authorization': `Bearer ${percKey}` } : {}),
+            },
+            body: JSON.stringify({
+                decision_id: d.id,
+                invalidate: true,
+                source: 'user_correction',
+            }),
+        });
+        res.ok
+            ? spinner.succeed(chalk.green('❌ Decision rejected — won\'t appear in future sessions'))
+            : spinner.fail('Could not reject decision');
+    }
+    catch {
+        spinner.fail('Could not reach Perception API');
+    }
+}
+// ── Inline: resolve a conflict ─────────────────────────────────
+async function resolveConflictInline(d, percUrl, percKey, projectId) {
+    const { resolution } = await prompts({
+        type: 'select',
+        name: 'resolution',
+        message: 'Resolve conflict:',
+        choices: [
+            { title: '✔  Keep this — it\'s correct', value: 'keep' },
+            { title: '❌ Reject this — older decision stands', value: 'invalidate' },
+        ],
+    });
+    if (!resolution)
+        return;
+    const spinner = ora('Resolving...').start();
+    try {
+        const res = await fetch(`${percUrl}/corrections`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                ...(percKey ? { 'Authorization': `Bearer ${percKey}` } : {}),
+                'X-Project-Id': projectId,
+                'X-Session-Id': 'robrain-review-cli',
+            },
+            body: JSON.stringify({
+                decision_id: d.id,
+                invalidate: resolution === 'invalidate',
+                source: 'user_correction',
+            }),
+        });
+        if (res.ok) {
+            resolution === 'keep'
+                ? spinner.succeed(chalk.green('✔ Conflict resolved — decision kept'))
+                : spinner.succeed(chalk.green('❌ Conflict resolved — decision rejected'));
+        }
+        else {
+            spinner.fail('Could not resolve conflict');
+        }
+    }
+    catch {
+        spinner.fail('Could not reach Perception API');
+    }
+}
+//# sourceMappingURL=review.js.map