codehere 0.2.2 → 0.3.0-rc.1

package/dist/monitoring.js

@@ -2,11 +2,10 @@
  * Enterprise Monitoring & Health Check System
  * Ensures 24/7 operation visibility
  */
-import { existsSync, readFileSync, mkdirSync } from 'fs';
+import { existsSync, mkdirSync } from 'fs';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 import { cohereCircuitBreaker } from './error-handler.js';
-import { getEmbeddingsDbPath } from './infrastructure/storage/embeddings-path.js';
 class MetricsCollector {
     operations = {
         total: 0,
@@ -89,32 +88,6 @@ class MetricsCollector {
     }
 }
 export const metricsCollector = new MetricsCollector();
-/**
- * Check database health
- */
-function checkDatabase() {
-    try {
-        // Use per-repo embeddings database path
-        const pathInfo = getEmbeddingsDbPath(process.cwd());
-        const dbPath = pathInfo.dbPath;
-        if (!existsSync(dbPath)) {
-            return { status: 'warning', message: 'No embeddings database found (run "codehere index" to create one)' };
-        }
-        // Try to read database
-        const buffer = readFileSync(dbPath);
-        if (buffer.length === 0) {
-            return { status: 'warning', message: 'Database file is empty' };
-        }
-        return { status: 'ok', message: 'Database accessible' };
-    }
-    catch (error) {
-        // If check fails, treat as warning (not critical - database is optional)
-        return {
-            status: 'warning',
-            message: `Database check: ${error instanceof Error ? error.message : String(error)}`,
-        };
-    }
-}
 /**
  * Check API health
  */
@@ -127,7 +100,10 @@ function checkApi() {
         return { status: 'error', message: 'API circuit breaker is HALF_OPEN - recovering' };
     }
     // Check if any API key is configured
-    const hasKey = !!(process.env.ANTHROPIC_API_KEY || process.env.OPENAI_API_KEY || process.env.COHERE_API_KEY || process.env.OPENROUTER_API_KEY);
+    const hasKey = !!(process.env.ANTHROPIC_API_KEY ||
+        process.env.OPENAI_API_KEY ||
+        process.env.COHERE_API_KEY ||
+        process.env.OPENROUTER_API_KEY);
     if (!hasKey) {
         return { status: 'error', message: 'No API key configured' };
     }
@@ -194,24 +170,19 @@ function checkMemory() {
  * Perform health check
  */
 export function performHealthCheck() {
-    const dbCheck = checkDatabase();
     const apiCheck = checkApi();
     const fsCheck = checkFilesystem();
     const memCheck = checkMemory();
     const checks = {
-        database: dbCheck,
         api: apiCheck,
         filesystem: fsCheck,
         memory: memCheck,
     };
-    // Determine overall status
-    // Database warnings are non-fatal (embeddings are optional)
     let status = 'healthy';
-    if (dbCheck.status === 'error' || apiCheck.status === 'circuit_open' || fsCheck.status === 'error') {
+    if (apiCheck.status === 'circuit_open' || fsCheck.status === 'error') {
         status = 'unhealthy';
     }
-    else if (apiCheck.status === 'error' || memCheck.status === 'warning' || (dbCheck.status === 'warning' && apiCheck.status !== 'ok')) {
-        // Database warning alone doesn't degrade status, but combined with other issues it does
+    else if (apiCheck.status === 'error' || memCheck.status === 'warning') {
         status = 'degraded';
     }
     return {
@@ -230,10 +201,10 @@ export function getMetrics() {
  * Format health status for display
  */
 export function formatHealthStatus(health) {
-    const statusIcon = health.status === 'healthy' ? '✓' : health.status === 'degraded' ? '!' : '✗';
+    const statusIcon = health.status === 'healthy' ? '✓' : health.status === 'degraded' ? '⚠' : '✗';
     let output = `  ${statusIcon} ${health.status.toUpperCase()}\n\n`;
     for (const [component, check] of Object.entries(health.checks)) {
-        const icon = check.status === 'ok' ? '✓' : check.status === 'warning' ? '!' : '✗';
+        const icon = check.status === 'ok' ? '✓' : check.status === 'warning' ? '⚠' : '✗';
         output += `  ${icon} ${component.padEnd(12)} ${check.message}\n`;
     }
     return output;

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

@@ -2,22 +2,50 @@
  * Help Command
  * Provides contextual help for Codehere commands
  */
-import { colors, newline, } from '../../../ui.js';
+import { colors, newline } from '../../../ui.js';
 const COMMAND_INFO = {
-    // === Safety & Trust (no API key needed) ===
-    'hook': {
-        name: 'hook',
-        description: 'Install, manage, and monitor the safety hook for AI coding agents',
-        usage: 'codehere hook <action>',
+    // === 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 hook install',
-            'codehere hook status',
-            'codehere hook log',
-            'codehere hook uninstall',
+            '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': {
+    trust: {
         name: 'trust',
         description: 'Scan your project for security issues — instant score, no API key needed',
         usage: 'codehere trust [path] [options]',
@@ -35,9 +63,9 @@ const COMMAND_INFO = {
         ],
         related: ['report', 'hook'],
     },
-    'report': {
+    report: {
         name: 'report',
-        description: 'Generate a shareable security audit report for your project',
+        description: 'Generate a shareable markdown audit report',
         usage: 'codehere report [options]',
         examples: [
             'codehere report',
@@ -52,137 +80,64 @@ const COMMAND_INFO = {
         ],
         related: ['trust', 'status'],
     },
-    'status': {
+    status: {
         name: 'status',
-        description: 'Dashboard — what your AI agents have been doing',
+        description: 'Dashboard — sessions, blocked calls, audit trends',
         usage: 'codehere status [options]',
-        examples: [
-            'codehere status',
-            'codehere status --sessions',
-            'codehere status --json',
-        ],
+        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'],
     },
-    'serve': {
+    serve: {
         name: 'serve',
-        description: 'Start MCP server — expose codehere tools to AI desktop clients',
+        description: 'Start codehere as an MCP server (Claude Desktop, Cursor, Zed, etc.)',
         usage: 'codehere serve [options]',
-        examples: [
-            'codehere serve',
-            'codehere serve --show-config',
-        ],
+        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'],
     },
-    // === AI-Powered (needs API key) ===
-    'ask': {
-        name: 'ask',
-        description: 'Ask questions about your codebase using natural language',
-        usage: 'codehere ask "<question>"',
-        examples: [
-            'codehere ask "How does authentication work?"',
-            'codehere ask "What design patterns are used?"',
-        ],
-        related: ['explain', 'smart'],
-    },
-    'fix': {
-        name: 'fix',
-        description: 'Apply AI-powered fixes to your code with safety pipeline',
-        usage: 'codehere fix <file> "<instruction>"',
-        examples: [
-            'codehere fix src/api.ts "add input validation"',
-            'codehere fix src/auth.ts "switch to bcrypt hashing"',
-        ],
-        related: ['plan', 'trust'],
-    },
-    'explain': {
-        name: 'explain',
-        description: 'Get detailed explanations of code files or functions',
-        usage: 'codehere explain <filepath>',
-        examples: [
-            'codehere explain src/utils.ts',
-            'codehere explain src/services/auth.ts',
-        ],
-        related: ['ask', 'smart'],
-    },
-    'plan': {
-        name: 'plan',
-        description: 'Generate a step-by-step plan for complex tasks',
-        usage: 'codehere plan "<goal>" [options]',
-        examples: [
-            'codehere plan "implement user authentication"',
-            'codehere plan "refactor to dependency injection" --execute',
-        ],
-        options: [
-            { flag: '--execute', description: 'Execute the plan after generation' },
-        ],
-        related: ['orchestrate', 'fix'],
-    },
-    'orchestrate': {
-        name: 'orchestrate',
-        description: 'Orchestrate multi-agent workflows — plan, execute, validate',
-        usage: 'codehere orchestrate "<goal>" [options]',
-        examples: [
-            'codehere orchestrate "implement auth system"',
-            'codehere orchestrate "add logging across services" --mode full',
-        ],
-        options: [
-            { flag: '--mode <mode>', description: 'Mode: plan, execute, full (default: full)' },
-        ],
-        related: ['plan', 'smart'],
-    },
-    'index': {
-        name: 'index',
-        description: 'Build semantic index of your codebase for AI queries',
-        usage: 'codehere index [options]',
-        examples: [
-            'codehere index',
-            'codehere index --repo ./my-project',
-        ],
-        options: [
-            { flag: '--repo <path>, -r <path>', description: 'Repository path (default: current directory)' },
-        ],
-        related: ['ask'],
-    },
-    'setup': {
+    // === Configuration ===
+    setup: {
         name: 'setup',
-        description: 'Interactive setup wizard',
+        description: 'Interactive first-run setup wizard',
         usage: 'codehere setup [options]',
-        examples: [
-            'codehere setup',
-            'codehere setup --force',
-        ],
-        options: [
-            { flag: '--force, -f', description: 'Force reconfiguration' },
-        ],
+        examples: ['codehere setup', 'codehere setup --force'],
+        options: [{ flag: '--force, -f', description: 'Force reconfiguration' }],
         related: ['config', 'hook'],
     },
-    'config': {
+    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', 'cost'],
+        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'],
     },
-    'cost': {
-        name: 'cost',
-        description: 'View API cost tracking and budget status',
-        usage: 'codehere cost [action]',
+    completion: {
+        name: 'completion',
+        description: 'Generate bash, zsh, or fish completion script',
+        usage: 'codehere completion <shell>',
         examples: [
-            'codehere cost',
-            'codehere cost summary',
-            'codehere cost reset',
+            'codehere completion bash >> ~/.bashrc',
+            'codehere completion zsh > /usr/local/share/zsh/site-functions/_codehere',
+            'codehere completion fish > ~/.config/fish/completions/codehere.fish',
         ],
-        related: ['config', 'status'],
+        related: [],
     },
 };
 const ALL_COMMANDS = Object.keys(COMMAND_INFO);
@@ -196,7 +151,7 @@ function findSimilarCommands(input, maxResults = 3) {
         return [lowerInput];
     }
     // Calculate similarity scores
-    const scores = ALL_COMMANDS.map(cmd => {
+    const scores = ALL_COMMANDS.map((cmd) => {
         const lowerCmd = cmd.toLowerCase();
         // Exact substring match
         if (lowerCmd.includes(lowerInput) || lowerInput.includes(lowerCmd)) {
@@ -210,10 +165,10 @@ function findSimilarCommands(input, maxResults = 3) {
     });
     // Sort by score and return top matches
     return scores
-        .filter(s => s.score > 0.3)
+        .filter((s) => s.score > 0.3)
         .sort((a, b) => b.score - a.score)
         .slice(0, maxResults)
-        .map(s => s.cmd);
+        .map((s) => s.cmd);
 }
 /**
  * Simple Levenshtein distance calculation
@@ -221,7 +176,9 @@ function findSimilarCommands(input, maxResults = 3) {
 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));
+    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++)
@@ -234,8 +191,7 @@ function levenshteinDistance(str1, str2) {
             else {
                 dp[i][j] = Math.min(dp[i - 1][j] + 1, // deletion
                 dp[i][j - 1] + 1, // insertion
-                dp[i - 1][j - 1] + 1 // substitution
-                );
+                dp[i - 1][j - 1] + 1);
             }
         }
     }
@@ -253,7 +209,7 @@ function displayCommandHelp(commandName) {
         if (suggestions.length > 0) {
             newline();
             console.log(colors.bold('Did you mean:'));
-            suggestions.forEach(cmd => {
+            suggestions.forEach((cmd) => {
                 console.log(`  ${colors.cyan(`codehere help ${cmd}`)}`);
             });
             newline();
@@ -269,20 +225,20 @@ function displayCommandHelp(commandName) {
     console.log('  ' + colors.cyan(command.usage));
     newline();
     console.log(colors.bold('Examples'));
-    command.examples.forEach(example => {
+    command.examples.forEach((example) => {
         console.log(colors.dim('  $ ') + colors.cyan(example));
     });
     newline();
     if (command.options && command.options.length > 0) {
         console.log(colors.bold('Options'));
-        command.options.forEach(opt => {
+        command.options.forEach((opt) => {
             console.log('  ' + colors.cyan(opt.flag.padEnd(24)) + colors.dim(opt.description));
         });
         newline();
     }
     if (command.related && command.related.length > 0) {
         console.log(colors.bold('Related'));
-        command.related.forEach(related => {
+        command.related.forEach((related) => {
             console.log('  ' + colors.cyan(`codehere help ${related}`));
         });
         newline();
@@ -296,28 +252,29 @@ function printCmd(name, desc) {
 }
 function displayGeneralHelp() {
     newline();
-    console.log(colors.bold('codehere') + colors.dim(' — AI coding agent with built-in safety'));
+    console.log(colors.bold('codehere') + colors.dim(' — A PM for your AI coding agents'));
     newline();
-    console.log(colors.bold('Safety & Trust') + colors.dim(' (no API key needed)'));
-    for (const cmd of ['hook', 'trust', 'report', 'status', 'serve']) {
+    console.log(colors.bold('Delegate'));
+    for (const cmd of ['start', 'task', 'kill']) {
         printCmd(cmd, COMMAND_INFO[cmd].description);
     }
     newline();
-    console.log(colors.bold('AI-Powered') + colors.dim(' (needs API key)'));
-    for (const cmd of ['ask', 'fix', 'explain', 'plan', 'index']) {
+    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'));
-    printCmd('setup', COMMAND_INFO['setup'].description);
+    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 hook install') + colors.dim('   Start scanning every AI write'));
-    console.log(colors.dim('  2. ') + colors.cyan('codehere trust .') + colors.dim('       Scan your project (no API key)'));
-    console.log(colors.dim('  3. ') + colors.cyan('codehere setup') + colors.dim('         Configure AI provider'));
+    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)'));
     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 --all') + colors.dim(' to see all commands.'));
     newline();
 }
 /**

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

@@ -11,7 +11,7 @@
  *   codehere hook log              # Show recent audit log
  *   codehere hook log --tail 50    # Last 50 events
  */
-import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync, copyFileSync, unlinkSync, rmdirSync } from 'fs';
+import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync, copyFileSync, unlinkSync, rmdirSync, } from 'fs';
 import { join, dirname } from 'path';
 import { homedir } from 'os';
 import { fileURLToPath } from 'url';
@@ -33,7 +33,7 @@ function installSkills() {
     if (!existsSync(SKILLS_TARGET_DIR)) {
         mkdirSync(SKILLS_TARGET_DIR, { recursive: true });
     }
-    const files = readdirSync(sourceDir).filter(f => f.endsWith('.md'));
+    const files = readdirSync(sourceDir).filter((f) => f.endsWith('.md'));
     for (const file of files) {
         copyFileSync(join(sourceDir, file), join(SKILLS_TARGET_DIR, file));
     }
@@ -48,11 +48,12 @@ function uninstallSkills() {
         }
         rmdirSync(SKILLS_TARGET_DIR);
     }
-    catch { /* ignore */ }
+    catch {
+        /* ignore */
+    }
 }
 function skillsInstalled() {
-    return existsSync(SKILLS_TARGET_DIR) &&
-        readdirSync(SKILLS_TARGET_DIR).some(f => f.endsWith('.md'));
+    return existsSync(SKILLS_TARGET_DIR) && readdirSync(SKILLS_TARGET_DIR).some((f) => f.endsWith('.md'));
 }
 const SETTINGS_PATH = join(homedir(), '.claude', 'settings.json');
 // ── helpers ──────────────────────────────────────────────────────────────────
@@ -75,7 +76,7 @@ function writeSettings(settings) {
 function isInstalled(settings) {
     const hooks = (settings.hooks ?? {});
     const preToolUse = (hooks.PreToolUse ?? []);
-    return preToolUse.some(entry => entry.hooks?.some(h => h.command?.includes('codehere scan-tool')));
+    return preToolUse.some((entry) => entry.hooks?.some((h) => h.command?.includes('codehere scan-tool')));
 }
 // ── command ───────────────────────────────────────────────────────────────────
 export async function executeHookCommand(subcommand, options = {}) {
@@ -191,23 +192,22 @@ export async function executeHookCommand(subcommand, options = {}) {
             newline();
             // Show recent audit stats
             if (existsSync(AUDIT_FILE)) {
-                const lines = readFileSync(AUDIT_FILE, 'utf-8')
-                    .split('\n')
-                    .filter(Boolean)
-                    .slice(-1000); // last 1000 events
+                const lines = readFileSync(AUDIT_FILE, 'utf-8').split('\n').filter(Boolean).slice(-1000); // last 1000 events
                 if (lines.length > 0) {
-                    const entries = lines.map(l => {
+                    const entries = lines
+                        .map((l) => {
                         try {
                             return JSON.parse(l);
                         }
                         catch {
                             return null;
                         }
-                    }).filter(Boolean);
+                    })
+                        .filter(Boolean);
                     const total = entries.length;
                     const blocked = entries.filter((e) => e.blocked).length;
                     const critical = entries.filter((e) => (e.criticalFindings ?? 0) > 0).length;
-                    console.log(colors.bold('What it\'s seen') + colors.dim(' (last 1000 events):'));
+                    console.log(colors.bold("What it's seen") + colors.dim(' (last 1000 events):'));
                     console.log(`  ${colors.cyan(String(total))} tool calls scanned`);
                     console.log(`  ${blocked > 0 ? colors.red(String(blocked)) : colors.green('none')} blocked`);
                     console.log(`  ${critical > 0 ? colors.red(String(critical)) : colors.green('none')} with critical findings`);
@@ -219,7 +219,7 @@ export async function executeHookCommand(subcommand, options = {}) {
                 }
             }
             else {
-                console.log(colors.dim('  No events logged yet — run Claude Code and it\'ll start tracking.'));
+                console.log(colors.dim("  No events logged yet — run Claude Code and it'll start tracking."));
                 newline();
             }
             break;
@@ -231,10 +231,7 @@ export async function executeHookCommand(subcommand, options = {}) {
                 console.log(colors.dim('  Run `codehere hook install` first'));
                 return;
             }
-            const lines = readFileSync(AUDIT_FILE, 'utf-8')
-                .split('\n')
-                .filter(Boolean)
-                .slice(-tail);
+            const lines = readFileSync(AUDIT_FILE, 'utf-8').split('\n').filter(Boolean).slice(-tail);
             if (lines.length === 0) {
                 console.log(info('Audit log is empty'));
                 return;
@@ -245,12 +242,8 @@ export async function executeHookCommand(subcommand, options = {}) {
                 try {
                     const entry = JSON.parse(line);
                     const ts = new Date(entry.timestamp).toLocaleTimeString();
-                    const status = entry.blocked
-                        ? colors.red('[BLOCKED]')
-                        : colors.green('[ALLOW]  ');
-                    const risk = entry.riskScore > 0
-                        ? colors.yellow(` risk:${entry.riskScore}`)
-                        : '';
+                    const status = entry.blocked ? colors.red('[BLOCKED]') : colors.green('[ALLOW]  ');
+                    const risk = entry.riskScore > 0 ? colors.yellow(` risk:${entry.riskScore}`) : '';
                     const tool = colors.cyan(entry.toolName.padEnd(10));
                     const preview = entry.toolInput.substring(0, 60).replace(/\n/g, ' ');
                     console.log(`  ${ts}  ${status}  ${tool}${risk}  ${colors.dim(preview)}`);