codehere 0.7.1 → 1.0.1

package/dist/ui.js

@@ -1,11 +1,5 @@
 import chalk from 'chalk';
-import ora from 'ora';
-import cliProgress from 'cli-progress';
-import boxen from 'boxen';
 import Table from 'cli-table3';
-import { existsSync } from 'fs';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
 let cachedCliStyle = null;
 export function getCliStyle() {
     if (cachedCliStyle)
@@ -27,24 +21,16 @@ export function printMinimalHeader(command, query) {
     }
     console.log();
 }
-// Minimal safety note (used at end of AI responses)
-export function printSafetyNote() {
-    console.log(colors.dim('Note: AI output may be inaccurate. Review before committing.'));
-}
-// Minimal context summary
-export function printContextSummary(files, maxShow = 3) {
-    if (files.length === 0)
-        return;
-    const unique = [...new Set(files)];
-    const shown = unique.slice(0, maxShow);
-    const more = unique.length - maxShow;
-    console.log(colors.dim('Context:'));
-    shown.forEach((f) => console.log(colors.dim(`  - ${f}`)));
-    if (more > 0) {
-        console.log(colors.dim(`  ... and ${more} more file${more > 1 ? 's' : ''}`));
-    }
-}
 // Professional color scheme - subtle and enterprise-ready
+// CLI color economy (DESIGN.md §5.2) — color carries MEANING, not decoration,
+// and is always redundant with a glyph + word so NO_COLOR / piped output stays
+// legible (chalk auto-disables on non-TTY and when NO_COLOR is set). The
+// semantic names below are the vocabulary CLI output should use; the raw chalk
+// names are kept for back-compat but new output uses meaning:
+//   verified = green (independently verified ONLY)   caught = red (a contradiction caught ONLY)
+//   warn = amber (budget/attention)                  evidence = dim (machine facts, metadata)
+//   identity = cyan (an agent/session id, sparingly) heading = bold (the one thing that matters)
+// Retired: magenta as decoration.
 export const colors = {
     success: chalk.green,
     error: chalk.red,
@@ -59,57 +45,33 @@ export const colors = {
     green: chalk.green,
     gray: chalk.gray,
     blue: chalk.blue,
+    // semantic economy — prefer these in new CLI output
+    verified: chalk.green,
+    caught: chalk.red,
+    warn: chalk.yellow,
+    evidence: chalk.dim,
+    identity: chalk.cyan,
+    heading: chalk.bold,
 };
-// Professional status symbols (ASCII only - enterprise-ready)
+// S19 glyph language (BINDING, shared with the web design tokens in
+// ui-page-v2): status = the sanctioned geometric set + ANSI color —
+// ✓ ✕ · — › ● ○ ⊘ — never emoji-as-icon, never pictographs in stdout/stderr.
 export const symbols = {
     success: '✓',
-    error: '✗',
-    warning: '⚠',
-    info: '→',
-    processing: '⟳',
-    arrow: '→',
-    dot: '•',
+    error: '✕',
+    warning: '!',
+    info: '›',
+    processing: '›',
+    arrow: '›',
+    dot: '·',
     check: '✓',
-    cross: '✗',
+    cross: '✕',
     pipe: '│',
     dash: '─',
     plus: '+',
     minus: '-',
     bullet: '•',
 };
-// Spinner helper - minimal text only with smooth transitions
-export function createSpinner(text) {
-    return ora({
-        text: colors.dim(text),
-        spinner: 'dots', // Smooth animated dots
-        color: 'cyan',
-        interval: 80, // Faster animation for better perceived performance
-    });
-}
-// Progress bar helper - clean and minimal with smooth transitions
-export function createProgressBar(total, format) {
-    const bar = new cliProgress.SingleBar({
-        format: format || colors.dim('Progress') + ' |{bar}| ' + colors.cyan('{percentage}%') + ' | {value}/{total}',
-        barCompleteChar: '\u2588', // Full block for smooth appearance
-        barIncompleteChar: '\u2591', // Light shade for incomplete
-        hideCursor: true,
-        clearOnComplete: true,
-        etaBuffer: 10, // Smooth ETA calculation
-        forceRedraw: true, // Force redraw for smooth updates
-    }, cliProgress.Presets.shades_classic);
-    bar.start(total, 0);
-    return bar;
-}
-// Professional box helper - minimal borders
-export function createBox(content, options) {
-    return boxen(content, {
-        padding: { top: 0, bottom: 0, left: 1, right: 1 },
-        margin: { top: 0, bottom: 1, left: 0, right: 0 },
-        borderStyle: 'single',
-        borderColor: 'gray',
-        ...options,
-    });
-}
 // Professional banner - clean and minimal
 export function createBanner(title, subtitle) {
     const width = Math.max(title.length, subtitle?.length || 0) + 4;
@@ -144,6 +106,13 @@ export function warning(message) {
 export function info(message) {
     return colors.blue(symbols.info + ' ' + message);
 }
+// Section heading (DESIGN.md §5.2) — the one structural line per block. Bold,
+// no color: color is reserved for meaning (verdict/identity), so a heading
+// earns emphasis from weight, not decoration. Legible with NO_COLOR (bold is
+// the fallback; the words carry it regardless).
+export function heading(message) {
+    return colors.heading(message);
+}
 // Create professional table - minimal styling
 export function createTable(headers, rows) {
     const table = new Table({
@@ -178,32 +147,10 @@ export function createTable(headers, rows) {
     rows.forEach((row) => table.push(row));
     return table;
 }
-// Format file path - subtle
-export function formatPath(path) {
-    return colors.cyan(path);
-}
 // Format number - bold
 export function formatNumber(num) {
     return colors.bold(num.toString());
 }
-// Format percentage - subtle
-export function formatPercent(value, total) {
-    if (total !== undefined) {
-        const percent = Math.round((value / total) * 100);
-        return colors.dim(`${percent}%`);
-    }
-    // If just a percentage value (0-100)
-    return colors.dim(`${value.toFixed(1)}%`);
-}
-// Format score (for search results) - color by relevance
-export function formatScore(score) {
-    const percent = Math.round(score * 100);
-    if (percent >= 50)
-        return colors.green(`${percent}%`);
-    if (percent >= 30)
-        return colors.yellow(`${percent}%`);
-    return colors.dim(`${percent}%`);
-}
 // Professional section header
 export function sectionHeader(title) {
     console.log(colors.bold(title));
@@ -215,46 +162,6 @@ export function newline(count = 1) {
         console.log();
     }
 }
-/**
- * Show a human-voice "you need an API key" message and exit.
- * Covers all supported providers — not just Cohere.
- */
-export function hasAnyApiKey() {
-    return !!(process.env.ANTHROPIC_API_KEY ||
-        process.env.OPENAI_API_KEY ||
-        process.env.COHERE_API_KEY ||
-        process.env.OPENROUTER_API_KEY ||
-        process.env.CODEHERE_AI_PROVIDER === 'local' ||
-        process.env.CODEHERE_FAKE_AI === '1');
-}
-export function requireApiKey() {
-    newline();
-    console.log(error('You need an API key to use this command.'));
-    newline();
-    console.log('  Fastest options:');
-    console.log(colors.cyan('    export ANTHROPIC_API_KEY=sk-ant-...') + colors.dim('   (Claude models — recommended)'));
-    console.log(colors.cyan('    export OPENAI_API_KEY=sk-...'));
-    console.log(colors.cyan('    export COHERE_API_KEY=...'));
-    console.log(colors.cyan('    export CODEHERE_AI_PROVIDER=local') + colors.dim('      (Ollama — no key needed)'));
-    newline();
-    console.log(colors.dim('  These work right now, no key needed:'));
-    console.log(colors.dim('    codehere trust .'));
-    console.log(colors.dim('    codehere hook status'));
-    console.log(colors.dim('    codehere serve'));
-    newline();
-    process.exit(1);
-}
-// Status indicator
-export function statusIndicator(status) {
-    const map = {
-        success: colors.green(symbols.success),
-        error: colors.red(symbols.error),
-        warning: colors.yellow(symbols.warning),
-        info: colors.blue(symbols.info),
-        processing: colors.cyan(symbols.processing),
-    };
-    return map[status];
-}
 // Gradient logo for "codehere" - coral → purple → blue
 export function createCodehereLogo() {
     const text = 'codehere';
@@ -288,115 +195,20 @@ export function createWelcomeMessage() {
     // Matches the positioning in `codehere --help` and `codehere help`. codehere
     // is the LAYER over your coding agents, not itself an agent — the old
     // "AI coding agent with built-in safety" line implied the opposite.
-    const tagline = 'A PM for your AI coding agents';
+    const tagline = 'Your AI coding agents: audited, cost-bounded, cross-vendor';
     return `
 ${colors.bold(logo)} ${colors.dim(version)}
 ${colors.dim(tagline)}
 `;
 }
-// Helper to get visual length (strip ANSI codes)
-function visualLength(str) {
-    // Remove ANSI escape codes
-    return str.replace(/\u001b\[[0-9;]*m/g, '').length;
-}
-// Enhanced welcome message for interactive session
-export function createSessionWelcome() {
-    const logo = createCodehereLogo();
-    const version = getVersionWithPrefix();
-    // Check if indexed (legacy check - uses global path for backward compatibility)
-    // Note: Active CLI flows use per-repo embeddings via getEmbeddingsDbPath()
-    let isIndexed = false;
-    try {
-        const __filename = fileURLToPath(import.meta.url);
-        const __dirname = dirname(__filename);
-        const agentDir = join(__dirname, '..');
-        const dbPath = join(agentDir, 'data', 'embeddings.sqlite');
-        isIndexed = existsSync(dbPath);
-    }
-    catch {
-        // Ignore errors - will default to not indexed
-    }
-    const width = 54;
-    const greeting = 'Hello there, code here!';
-    // Use subtle blue-gray for borders (like Claude Code)
-    const borderColor = chalk.hex('#6B7280'); // Subtle gray-blue
-    // Helper to create a line with proper padding
-    const createLine = (content) => {
-        const contentVisual = visualLength(content);
-        // Total width = left border (2) + content + padding + right border (2)
-        // So: width = 2 + contentVisual + padding + 2
-        // padding = width - contentVisual - 4
-        const padding = Math.max(0, width - contentVisual - 4);
-        return borderColor('│ ') + content + ' '.repeat(padding) + borderColor(' │\n');
-    };
-    let welcomeBox = '';
-    welcomeBox += borderColor('┌' + '─'.repeat(width - 2) + '┐\n');
-    // Header line with logo and version
-    const headerContent = colors.bold(logo) + ' ' + colors.dim(version);
-    welcomeBox += createLine(headerContent);
-    welcomeBox += borderColor('│') + ' '.repeat(width - 2) + borderColor('│\n');
-    // Greeting line
-    welcomeBox += createLine(greeting);
-    welcomeBox += borderColor('│') + ' '.repeat(width - 2) + borderColor('│\n');
-    // Tips section
-    const tipsHeader = 'Tips for getting started:';
-    welcomeBox += createLine(colors.yellow(tipsHeader));
-    if (!isIndexed) {
-        const tip1 = '  Run "index" to build your codebase search index';
-        welcomeBox += createLine(colors.dim(tip1));
-    }
-    else {
-        const tip1 = '  Try asking: "How does authentication work?"';
-        welcomeBox += createLine(colors.dim(tip1));
-    }
-    const tip2 = '  Type "help" to see all available commands';
-    welcomeBox += createLine(colors.dim(tip2));
-    welcomeBox += borderColor('│') + ' '.repeat(width - 2) + borderColor('│\n');
-    // Quick examples
-    const examplesHeader = 'Quick start:';
-    welcomeBox += createLine(colors.cyan(examplesHeader));
-    const example1 = '  • codehere hook install   — activate pre-execution scanning';
-    welcomeBox += createLine(colors.dim(example1));
-    const example2 = '  • codehere trust .        — score this codebase (no API key needed)';
-    welcomeBox += createLine(colors.dim(example2));
-    const example3 = '  • codehere report         — generate shareable audit report';
-    welcomeBox += createLine(colors.dim(example3));
-    welcomeBox += borderColor('└' + '─'.repeat(width - 2) + '┘');
-    return welcomeBox;
-}
 // ── Delight utilities ─────────────────────────────────────────────────────────
-const THINKING_MESSAGES = [
-    'On it...',
-    'Let me look...',
-    'Thinking...',
-    'One sec...',
-    'Reading your code...',
-    'Working through this...',
-    'Bear with me...',
-    'Pulling it together...',
-];
-const FAREWELL_MESSAGES = [
-    'See you later! 👋',
-    'Happy shipping!',
-    'Good luck out there.',
-    'Back to building.',
-    'See you on the next one.',
-    'Later! Go build something great.',
-    'Until next time.',
-];
 const CLEAN_SCAN_CELEBRATIONS = [
     'Perfect score. Nothing to worry about.',
-    'All clear — clean scan.',
+    'All clear · clean scan.',
     'Zero findings. Enjoy the green.',
     'Nothing suspicious. Carry on.',
     'Clean as a whistle.',
 ];
-export function randomThinkingMessage() {
-    return colors.dim(THINKING_MESSAGES[Math.floor(Math.random() * THINKING_MESSAGES.length)]);
-}
-export function randomFarewell() {
-    return info(FAREWELL_MESSAGES[Math.floor(Math.random() * FAREWELL_MESSAGES.length)]);
-}
 export function randomCleanScan() {
     return CLEAN_SCAN_CELEBRATIONS[Math.floor(Math.random() * CLEAN_SCAN_CELEBRATIONS.length)];
 }
@@ -420,11 +232,24 @@ export const SLASH_COMMANDS = [
     { name: 'permission', args: '<sub>', description: 'Manage .codehere/permissions.yaml allow/deny', noKey: true },
     { name: 'narrator', args: '', description: 'Customize the PM narrator prompt', noKey: true },
     { name: 'budget', args: '[set <amount>]', description: 'Daily spend budget', noKey: true },
+    {
+        name: 'team',
+        args: '[set-dir <path>|budget <usd>]',
+        description: "Merge each machine's spend into one team total · local-first",
+        noKey: true,
+    },
     // Safety + observability (no key)
     { name: 'hook', args: '[install|status]', description: 'Safety hook management', noKey: true },
     { name: 'trust', args: '[path]', description: 'Scan for vulnerabilities', noKey: true },
+    {
+        name: 'scan',
+        args: '[path]',
+        description: 'Is your app safe to ship? — the 1 thing that gets you hacked',
+        noKey: true,
+    },
+    { name: 'check', args: '[path]', description: 'Re-run your tests — proof, not the AI’s claim', noKey: true },
     { name: 'report', args: '[path]', description: 'Shareable security audit', noKey: true },
-    { name: 'status', args: '', description: 'Security dashboard — hook activity', noKey: true },
+    { name: 'status', args: '', description: 'Security dashboard · hook activity', noKey: true },
     {
         name: 'verify',
         args: '[session-id]',
@@ -432,6 +257,7 @@ export const SLASH_COMMANDS = [
         noKey: true,
     },
     { name: 'audit', args: '[verify|show]', description: 'Inspect the hash-chained audit log', noKey: true },
+    { name: 'search', args: '<query>', description: 'Search past sessions · every hit cites its evidence', noKey: true },
     {
         name: 'context-source',
         args: '[list|connect|disconnect]',
@@ -444,6 +270,7 @@ export const SLASH_COMMANDS = [
     { name: 'start', args: '', description: 'Open the dashboard at localhost:3773' },
     { name: 'serve', args: '', description: 'Run headless MCP server (no UI)', noKey: true },
     { name: 'task', args: '<prompt>', description: 'Delegate a task to a coding agent' },
+    { name: 'reply', args: '<id> <text>', description: 'Continue a goal · send a follow-up to a session' },
     { name: 'kill', args: '<sessionId>', description: 'Kill a running task' },
     // Utility (no key)
     { name: 'help', args: '', description: 'Command reference', noKey: true },
@@ -454,19 +281,4 @@ export const SLASH_COMMANDS = [
     { name: 'clear', args: '', description: 'Clear the screen', noKey: true, replOnly: true },
     { name: 'exit', args: '', description: 'Leave the session', noKey: true, replOnly: true },
 ];
-export function showSlashCommandMenu() {
-    newline();
-    console.log(colors.bold('  Slash commands'));
-    newline();
-    const maxNameLen = Math.max(...SLASH_COMMANDS.map((c) => c.name.length + c.args.length)) + 1;
-    for (const cmd of SLASH_COMMANDS) {
-        const signature = `/${cmd.name}${cmd.args ? ' ' + cmd.args : ''}`;
-        const pad = ' '.repeat(Math.max(0, maxNameLen + 2 - signature.length + 8));
-        const badge = cmd.noKey ? colors.dim(' (no key)') : '';
-        console.log(`  ${colors.cyan(signature)}${pad}${colors.dim(cmd.description)}${badge}`);
-    }
-    newline();
-    console.log(colors.dim('  Type any command with / prefix, or just ask a question directly.'));
-    newline();
-}
 //# sourceMappingURL=ui.js.map

package/dist/utils/version.js

@@ -43,10 +43,4 @@ export function getVersion() {
 export function getVersionWithPrefix() {
     return `v${getVersion()}`;
 }
-/**
- * Reset version cache (useful for testing)
- */
-export function resetVersionCache() {
-    cachedVersion = null;
-}
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "codehere",
-  "version": "0.7.1",
-  "description": "A PM for your AI coding agents. Delegate, orchestrate, and audit Claude Code, Codex, Aider, OpenCode, Gemini, and any user-configured CLI agent from one local web UI — every AI action traced, every file scored, every spawn warmed with project memory.",
+  "version": "1.0.1",
+  "description": "See what your AI coding agents cost, and prove what they actually did. Runs Claude Code, Codex, Aider, Gemini and OpenCode on your machine, records every action in a hash-chained log, and re-runs your tests instead of taking an agent's word for it.",
   "main": "dist/index.js",
   "type": "module",
   "bin": {
@@ -16,6 +16,10 @@
   "engines": {
     "node": ">=20"
   },
+  "os": [
+    "darwin",
+    "linux"
+  ],
   "scripts": {
     "prepare": "bash ../scripts/install-hooks.sh || true",
     "prebuild": "rm -rf dist",
@@ -29,15 +33,26 @@
     "test": "npm run build && vitest run",
     "test:watch": "vitest",
     "lint": "eslint src/ --ext .ts",
+    "knip": "knip",
+    "knip:gate": "node scripts/knip-gate.mjs",
+    "lint:tokens": "node scripts/ui-token-gate.mjs",
+    "arch:gate": "tsc --noEmit && eslint src/ --ext .ts && node scripts/knip-gate.mjs && node scripts/ui-token-gate.mjs",
     "format": "prettier --write 'src/**/*.ts' 'test/**/*.ts'",
     "format:check": "prettier --check 'src/**/*.ts' 'test/**/*.ts'",
     "sbom": "npm sbom --sbom-format=spdx --omit=dev",
     "pretag:check": "../scripts/pretag-npm-check.sh",
-    "cassette:record": "../scripts/capture-cassette.sh"
+    "cassette:record": "../scripts/capture-cassette.sh",
+    "e2e": "node test/e2e/run.mjs",
+    "e2e:live": "CODEHERE_E2E_LIVE=1 node test/e2e/run.mjs",
+    "degraded": "node scripts/degraded-matrix.mjs",
+    "inventory": "node scripts/inventory-drift.mjs"
   },
   "keywords": [
     "ai-coding-agents",
-    "agent-orchestration",
+    "verification",
+    "agent-audit",
+    "llm-cost",
+    "ai-cost-tracking",
     "audit-trail",
     "trust-scoring",
     "ai-safety",
@@ -62,27 +77,32 @@
   },
   "homepage": "https://codehere.uk",
   "dependencies": {
-    "@mohammednagy/graphify-ts": "^0.22.3",
-    "boxen": "^8.0.1",
     "chalk": "^5.3.0",
-    "cli-progress": "^3.12.0",
     "cli-table3": "^0.6.5",
     "commander": "^11.1.0",
     "dotenv": "^16.3.1",
-    "gray-matter": "^4.0.3",
-    "ora": "^7.0.1",
     "yaml": "^2.8.4"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",
-    "@types/cli-progress": "^3.11.5",
     "@types/node": "^20.19.25",
     "eslint": "^10.2.0",
+    "eslint-import-resolver-typescript": "^4.4.5",
+    "eslint-plugin-import-x": "^4.16.2",
+    "knip": "^6.16.1",
     "playwright": "^1.60.0",
     "prettier": "^3.8.3",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "typescript-eslint": "^8.58.2",
     "vitest": "^4.1.4"
+  },
+  "peerDependencies": {
+    "@mohammednagy/graphify-ts": "^0.22.3"
+  },
+  "peerDependenciesMeta": {
+    "@mohammednagy/graphify-ts": {
+      "optional": true
+    }
   }
 }

package/dist/domain/entities/task.js

@@ -1,61 +0,0 @@
-/**
- * Domain Entity: CodehereTask
- * Task and workflow entities for the 4-mode interaction model
- *
- * Phase 1: v0.5.0-alpha
- * See: .internal/ARCHITECTURE.md (internal docs)
- */
-/**
- * Task Mode - The interaction mode that created this task
- */
-export var TaskMode;
-(function (TaskMode) {
-    TaskMode["SUGGEST"] = "suggest";
-    TaskMode["PLAN"] = "plan";
-    TaskMode["RUN"] = "run";
-    TaskMode["REVIEW"] = "review";
-})(TaskMode || (TaskMode = {}));
-/**
- * Task Status - Current lifecycle state
- */
-export var TaskStatus;
-(function (TaskStatus) {
-    TaskStatus["CREATED"] = "created";
-    TaskStatus["PLANNED"] = "planned";
-    TaskStatus["RUNNING"] = "running";
-    TaskStatus["COMPLETED"] = "completed";
-    TaskStatus["FAILED"] = "failed";
-    TaskStatus["NEEDS_REVIEW"] = "needs_review";
-    TaskStatus["APPROVED"] = "approved";
-    TaskStatus["REJECTED"] = "rejected";
-    TaskStatus["CANCELLED"] = "cancelled";
-})(TaskStatus || (TaskStatus = {}));
-/**
- * Risk Tier - Risk level for operation
- */
-export var RiskTier;
-(function (RiskTier) {
-    RiskTier["T1"] = "t1";
-    RiskTier["T2"] = "t2";
-    RiskTier["T3"] = "t3";
-})(RiskTier || (RiskTier = {}));
-/**
- * Environment Mode - Data access boundaries
- */
-export var EnvironmentMode;
-(function (EnvironmentMode) {
-    EnvironmentMode["LOCAL"] = "local";
-    EnvironmentMode["ORG"] = "org";
-    EnvironmentMode["INTERNET"] = "internet";
-})(EnvironmentMode || (EnvironmentMode = {}));
-/**
- * Review Status
- */
-export var ReviewStatus;
-(function (ReviewStatus) {
-    ReviewStatus["NOT_REQUIRED"] = "not_required";
-    ReviewStatus["PENDING"] = "pending";
-    ReviewStatus["APPROVED"] = "approved";
-    ReviewStatus["REJECTED"] = "rejected";
-})(ReviewStatus || (ReviewStatus = {}));
-//# sourceMappingURL=task.js.map