codehere 0.8.0 → 1.0.2

package/dist/presentation/cli/commands/help-command.js

@@ -1,275 +1,44 @@
 /**
  * Help Command
- * Provides contextual help for Codehere commands
+ * Contextual help for the commands codehere ships: check and help.
  */
 import { colors, newline } from '../../../ui.js';
 const COMMAND_INFO = {
-    // === Delegate (the v0.3 PM surface) ===
-    start: {
-        name: 'start',
-        description: 'Open the task intake web UI at http://127.0.0.1:3773',
-        usage: 'codehere start [options]',
-        examples: ['codehere start', 'codehere start --port 3773', 'codehere start --no-open'],
-        options: [
-            { flag: '--port <n>', description: 'Port for the local UI (default: 3773)' },
-            { flag: '--no-open', description: "Don't auto-open the browser" },
-        ],
-        related: ['task', 'kill', 'status'],
-    },
-    task: {
-        name: 'task',
-        description: 'Spawn a task from the CLI (requires `codehere start` running)',
-        usage: 'codehere task <prompt> [options]',
-        examples: [
-            'codehere task "review src/auth.ts for SQL injection"',
-            'codehere task "add JSDoc to all exports" --agent codex',
-        ],
-        options: [
-            { flag: '--agent <id>', description: 'Agent ID: claude-code | codex | aider | opencode' },
-            { flag: '--cwd <path>', description: 'Absolute working directory for the agent' },
-        ],
-        related: ['start', 'kill'],
-    },
-    kill: {
-        name: 'kill',
-        description: 'Terminate a running task session',
-        usage: 'codehere kill <sessionId>',
-        examples: ['codehere kill abc123de-...'],
-        related: ['task', 'status'],
-    },
-    // === Safety & Trust (no API key, no agents needed) ===
-    hook: {
-        name: 'hook',
-        description: 'Install, manage, and monitor the safety hook for Claude Code',
-        usage: 'codehere hook <action>',
-        examples: ['codehere hook install', 'codehere hook status', 'codehere hook log', 'codehere hook uninstall'],
-        related: ['trust', 'status'],
-    },
-    trust: {
-        name: 'trust',
-        description: 'Scan your project for security issues — instant score, no API key needed',
-        usage: 'codehere trust [path] [options]',
-        examples: [
-            'codehere trust .',
-            'codehere trust src/api/',
-            'codehere trust --json',
-            'codehere trust --ci',
-            'codehere trust --badge',
-        ],
-        options: [
-            { flag: '--json', description: 'Output results as JSON' },
-            { flag: '--ci', description: 'Exit 1 if score drops below threshold' },
-            { flag: '--badge', description: 'Generate a shields.io badge for your README' },
-        ],
-        related: ['report', 'hook'],
-    },
-    report: {
-        name: 'report',
-        description: 'Generate a shareable markdown audit report',
-        usage: 'codehere report [options]',
-        examples: [
-            'codehere report',
-            'codehere report --simple',
-            'codehere report --json',
-            'codehere report --out audit.md',
-        ],
-        options: [
-            { flag: '--simple', description: 'Plain English report for non-technical readers' },
-            { flag: '--json', description: 'Machine-readable JSON output' },
-            { flag: '--out <file>', description: 'Write report to a file' },
-        ],
-        related: ['trust', 'status'],
-    },
-    status: {
-        name: 'status',
-        description: 'Dashboard — sessions, blocked calls, audit trends',
-        usage: 'codehere status [options]',
-        examples: ['codehere status', 'codehere status --sessions', 'codehere status --weekly', 'codehere status --json'],
-        options: [
-            { flag: '--sessions', description: 'Show session breakdown with risk levels' },
-            { flag: '--weekly', description: '7-day shareable agent-activity recap' },
-            { flag: '--json', description: 'Output as JSON' },
-            { flag: '--export <fmt>', description: 'Export raw audit feed (jsonl, json, csv, md)' },
-        ],
-        related: ['hook', 'trust', 'verify'],
-    },
-    verify: {
-        name: 'verify',
-        description: "Verify a session's Final Report against the recorded reality (catches optimistic claims)",
-        usage: 'codehere verify [session-id] [options]',
-        examples: ['codehere verify', 'codehere verify a1b2c3d4', 'codehere verify a1b2c3d4 --json'],
-        options: [{ flag: '--json', description: 'Machine-readable verdict for CI' }],
-        related: ['status', 'report', 'audit'],
-    },
-    audit: {
-        name: 'audit',
-        description: 'Inspect the hash-chained audit log · verify integrity or show one entry',
-        usage: 'codehere audit [verify|show <seq>] [options]',
-        examples: ['codehere audit', 'codehere audit verify', 'codehere audit verify --json', 'codehere audit show 42'],
-        options: [{ flag: '--json', description: 'Machine-readable output' }],
-        related: ['status', 'verify', 'hook'],
-    },
-    'context-source': {
-        name: 'context-source',
-        description: 'Connect external tools (Linear, Figma) via OAuth · list status · disconnect',
-        usage: 'codehere context-source [list|connect <provider>|disconnect <provider>]',
-        examples: [
-            'codehere context-source list',
-            'codehere context-source connect linear',
-            'codehere context-source connect figma --no-open',
-            'codehere context-source disconnect linear',
-        ],
-        options: [
-            { flag: '--json', description: 'Machine-readable output' },
-            { flag: '--no-open', description: 'For connect: print URL but skip auto-opening the browser' },
-        ],
-        related: ['serve', 'start'],
-    },
-    thread: {
-        name: 'thread',
-        description: 'Share or import a signed session bundle · local-first, no relay',
-        usage: 'codehere thread <export|import|keys|trust|untrust> [args] [options]',
+    check: {
+        name: 'check',
+        description: 'Re-run your tests and report what actually passed',
+        usage: 'codehere check [target] [options]',
         examples: [
-            'codehere thread export <session-id> --out my-task.codehere.json',
-            'codehere thread import my-task.codehere.json',
-            'codehere thread import my-task.codehere.json --trust',
-            'codehere thread keys',
-            'codehere thread trust <pubkey-b64> "alice@laptop"',
+            'codehere check',
+            'codehere check --base origin/main',
+            'codehere check --claim "added tests, all pass"',
+            'codehere check --proof',
         ],
         options: [
-            { flag: '--out <file>', description: 'For export: write to file (otherwise stdout)' },
-            { flag: '--trust', description: 'For import: trust the signer key then proceed' },
             { flag: '--json', description: 'Machine-readable output' },
+            { flag: '--proof', description: 'Paste-ready proof block for a pull request' },
+            { flag: '--claim <text>', description: "The AI's summary: test files it names that do not exist are flagged" },
+            { flag: '--base <ref>', description: 'Look for weakened tests in everything since this branch left <ref>' },
         ],
-        related: ['start', 'verify'],
-    },
-    serve: {
-        name: 'serve',
-        description: 'Start codehere as an MCP server (Claude Desktop, Cursor, Zed, etc.)',
-        usage: 'codehere serve [options]',
-        examples: ['codehere serve', 'codehere serve --show-config', 'codehere serve --port 8080'],
-        options: [
-            { flag: '--show-config', description: 'Print MCP config for Claude Desktop or Cursor' },
-            { flag: '--port <n>', description: 'Port (default: 3773)' },
-        ],
-        related: ['hook'],
-    },
-    // === Configuration ===
-    setup: {
-        name: 'setup',
-        description: 'Interactive first-run setup wizard',
-        usage: 'codehere setup [options]',
-        examples: ['codehere setup', 'codehere setup --force'],
-        options: [{ flag: '--force, -f', description: 'Force reconfiguration' }],
-        related: ['config', 'hook'],
-    },
-    config: {
-        name: 'config',
-        description: 'Manage configuration and preferences',
-        usage: 'codehere config [action] [key] [value]',
-        examples: ['codehere config', 'codehere config set temperature 0.5'],
-        related: ['setup'],
     },
-    health: {
-        name: 'health',
-        description: 'System health check — filesystem, memory, audit log accessible',
-        usage: 'codehere health [options]',
-        examples: ['codehere health', 'codehere health --json'],
-        options: [{ flag: '--json', description: 'Output as JSON' }],
-        related: ['status'],
-    },
-    completion: {
-        name: 'completion',
-        description: 'Generate bash, zsh, or fish completion script',
-        usage: 'codehere completion <shell>',
-        examples: [
-            'codehere completion bash >> ~/.bashrc',
-            'codehere completion zsh > /usr/local/share/zsh/site-functions/_codehere',
-            'codehere completion fish > ~/.config/fish/completions/codehere.fish',
-        ],
-        related: [],
+    help: {
+        name: 'help',
+        description: 'Show help for commands',
+        usage: 'codehere help [command]',
+        examples: ['codehere help', 'codehere help check'],
     },
 };
-const ALL_COMMANDS = Object.keys(COMMAND_INFO);
-/**
- * Find similar commands (for typo detection)
- */
-function findSimilarCommands(input, maxResults = 3) {
-    const lowerInput = input.toLowerCase();
-    // Exact match
-    if (COMMAND_INFO[lowerInput]) {
-        return [lowerInput];
-    }
-    // Calculate similarity scores
-    const scores = ALL_COMMANDS.map((cmd) => {
-        const lowerCmd = cmd.toLowerCase();
-        // Exact substring match
-        if (lowerCmd.includes(lowerInput) || lowerInput.includes(lowerCmd)) {
-            return { cmd, score: 10 };
-        }
-        // Levenshtein distance (simple)
-        const distance = levenshteinDistance(lowerInput, lowerCmd);
-        const maxLen = Math.max(lowerInput.length, lowerCmd.length);
-        const similarity = (maxLen - distance) / maxLen;
-        return { cmd, score: similarity * 5 };
-    });
-    // Sort by score and return top matches
-    return scores
-        .filter((s) => s.score > 0.3)
-        .sort((a, b) => b.score - a.score)
-        .slice(0, maxResults)
-        .map((s) => s.cmd);
-}
-/**
- * Simple Levenshtein distance calculation
- */
-function levenshteinDistance(str1, str2) {
-    const m = str1.length;
-    const n = str2.length;
-    const dp = Array(m + 1)
-        .fill(null)
-        .map(() => Array(n + 1).fill(0));
-    for (let i = 0; i <= m; i++)
-        dp[i][0] = i;
-    for (let j = 0; j <= n; j++)
-        dp[0][j] = j;
-    for (let i = 1; i <= m; i++) {
-        for (let j = 1; j <= n; j++) {
-            if (str1[i - 1] === str2[j - 1]) {
-                dp[i][j] = dp[i - 1][j - 1];
-            }
-            else {
-                dp[i][j] = Math.min(dp[i - 1][j] + 1, // deletion
-                dp[i][j - 1] + 1, // insertion
-                dp[i - 1][j - 1] + 1);
-            }
-        }
-    }
-    return dp[m][n];
-}
-/**
- * Display help for a specific command
- */
 function displayCommandHelp(commandName) {
     const command = COMMAND_INFO[commandName.toLowerCase()];
     if (!command) {
-        const suggestions = findSimilarCommands(commandName);
         newline();
         console.error(colors.red(`Command '${commandName}' not found.`));
-        if (suggestions.length > 0) {
-            newline();
-            console.log(colors.bold('Did you mean:'));
-            suggestions.forEach((cmd) => {
-                console.log(`  ${colors.cyan(`codehere help ${cmd}`)}`);
-            });
-            newline();
-        }
         console.log(colors.dim('Run') + ' ' + colors.cyan('codehere --help') + ' ' + colors.dim('to see all commands.'));
         newline();
         return;
     }
     newline();
-    console.log(colors.bold(command.name) + colors.dim(' — ' + command.description));
+    console.log(colors.bold(command.name) + colors.dim(' · ' + command.description));
     newline();
     console.log(colors.bold('Usage'));
     console.log('  ' + colors.cyan(command.usage));
@@ -286,50 +55,17 @@ function displayCommandHelp(commandName) {
         });
         newline();
     }
-    if (command.related && command.related.length > 0) {
-        console.log(colors.bold('Related'));
-        command.related.forEach((related) => {
-            console.log('  ' + colors.cyan(`codehere help ${related}`));
-        });
-        newline();
-    }
-}
-/**
- * Display general help (all commands overview)
- */
-function printCmd(name, desc) {
-    console.log('  ' + colors.cyan(name.padEnd(14)) + colors.dim(desc));
 }
 function displayGeneralHelp() {
     newline();
-    console.log(colors.bold('codehere') + colors.dim(' — A PM for your AI coding agents'));
+    console.log(colors.bold('codehere') + colors.dim(' · re-run the tests an AI says passed'));
     newline();
-    console.log(colors.bold('Delegate'));
-    for (const cmd of ['start', 'task', 'kill']) {
-        printCmd(cmd, COMMAND_INFO[cmd].description);
-    }
-    newline();
-    console.log(colors.bold('Safety & Trust') + colors.dim(' (no API key, no agents needed)'));
-    for (const cmd of ['hook', 'trust', 'report', 'status', 'serve']) {
-        printCmd(cmd, COMMAND_INFO[cmd].description);
-    }
-    newline();
-    console.log(colors.bold('Configuration'));
-    for (const cmd of ['setup', 'config', 'health', 'completion']) {
-        printCmd(cmd, COMMAND_INFO[cmd].description);
-    }
-    newline();
-    console.log(colors.bold('Getting Started'));
-    console.log(colors.dim('  1. ') + colors.cyan('codehere start') + colors.dim('         Open the task intake at :3773'));
-    console.log(colors.dim('  2. ') + colors.cyan('codehere hook install') + colors.dim('  Audit every Claude Code action'));
-    console.log(colors.dim('  3. ') + colors.cyan('codehere trust .') + colors.dim('       Scan your project (no API key)'));
+    console.log(colors.bold('Check'));
+    console.log('  ' + colors.cyan('check'.padEnd(14)) + colors.dim('Re-run your tests and report what actually passed'));
     newline();
-    console.log(colors.dim('Run ') + colors.cyan('codehere help <command>') + colors.dim(' for details on any command.'));
+    console.log(colors.dim('Run ') + colors.cyan('codehere help check') + colors.dim(' for its options.'));
     newline();
 }
-/**
- * Execute help command
- */
 export async function executeHelpCommand(commandName) {
     if (commandName) {
         displayCommandHelp(commandName);