@thispointon/kondi-chat 0.1.2

package/bin/kondi-chat.js

@@ -0,0 +1,72 @@
+#!/usr/bin/env node
+
+import { execFileSync, execSync } from "node:child_process";
+import { existsSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const projectRoot = join(__dirname, "..");
+const version = "0.1.2";
+
+const arg = process.argv[2];
+
+if (arg === "--version" || arg === "-V") {
+  console.log(`kondi-chat ${version}`);
+  process.exit(0);
+}
+
+if (arg === "--help" || arg === "-h") {
+  console.log(`kondi-chat ${version} — terminal coding agent that picks a different model per phase`);
+  console.log("");
+  console.log("Usage:");
+  console.log("  kondi-chat                          Launch the TUI (default)");
+  console.log("  kondi-chat --prompt \"…\"              Run a single turn non-interactively");
+  console.log("  kondi-chat --resume                 Resume the latest session in this dir");
+  console.log("  kondi-chat --sessions               List saved sessions for this dir");
+  console.log("");
+  console.log("Non-interactive flags:");
+  console.log("  --prompt \"…\"                        Prompt text (required for non-interactive)");
+  console.log("  --pipe                              Read additional context from stdin");
+  console.log("  --json                              Emit structured JSON output instead of text");
+  console.log("  --max-iterations N                  Cap agent-loop iterations (overrides profile)");
+  console.log("  --max-cost N                        Cap per-turn USD (overrides profile)");
+  console.log("  --auto-approve TOOL                 Auto-approve a specific tool (e.g. run_command)");
+  console.log("                                      Can be repeated. Chained shell commands still");
+  console.log("                                      drop to confirm; always-confirm patterns still");
+  console.log("                                      block.");
+  console.log("  --dangerously-skip-permissions      Bypass all permission gates. Be sure.");
+  console.log("");
+  console.log("Session:");
+  console.log("  --resume [ID]                       Resume latest or specific session");
+  console.log("  --sessions                          List sessions");
+  console.log("  --cwd PATH                          Operate as if launched from PATH");
+  console.log("");
+  console.log("Inside the TUI: /help, /mode, /use, /cost, /routing, /undo, /loop, /council");
+  console.log("Exit codes: 0 ok · 1 error · 2 max iterations · 3 max cost · 5 permission denied");
+  console.log("");
+  console.log("Docs: https://github.com/thisPointOn/kondi-chat#readme");
+  process.exit(0);
+}
+
+const tuiBinary = join(projectRoot, "tui", "target", "release", "kondi-tui");
+
+if (existsSync(tuiBinary)) {
+  try {
+    execFileSync(tuiBinary, process.argv.slice(2), { stdio: "inherit" });
+  } catch (e) {
+    process.exit(e.status ?? 1);
+  }
+} else {
+  // Run the Node backend from the user's current working directory — NOT from
+  // the install dir. Setting cwd: projectRoot here would make the agent operate
+  // on the kondi-chat install instead of the user's project, which was the
+  // common failure mode for any install where the TUI binary download failed.
+  try {
+    execSync(`npx tsx ${join(projectRoot, "src", "cli", "backend.ts")} ${process.argv.slice(2).join(" ")}`, {
+      stdio: "inherit",
+    });
+  } catch (e) {
+    process.exit(e.status ?? 1);
+  }
+}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@thispointon/kondi-chat",
+  "version": "0.1.2",
+  "description": "Multi-model AI coding CLI with intelligent routing, budget profiles, and council deliberation",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "kondi-chat": "./bin/kondi-chat.js"
+  },
+  "files": [
+    "src/",
+    "bin/",
+    "scripts/",
+    "package.json",
+    "LICENSE",
+    "!src/**/*.test.ts"
+  ],
+  "scripts": {
+    "postinstall": "node scripts/postinstall.cjs",
+    "chat:tui": "cd tui && cargo run --release",
+    "build:tui": "cd tui && cargo build --release",
+    "start": "npx tsx src/cli/backend.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/thisPointOn/kondi-chat"
+  },
+  "keywords": [
+    "ai",
+    "cli",
+    "coding",
+    "multi-model",
+    "llm",
+    "agent",
+    "claude",
+    "gpt",
+    "deepseek"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "tsx": "^4.0.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.2"
+  }
+}

package/scripts/demo.tape

@@ -0,0 +1,49 @@
+# kondi-chat demo — record with: vhs scripts/demo.tape
+#
+# Produces demo.gif: one coding turn routed across multiple models,
+# then /cost and /routing to show what happened.
+#
+# Requires: vhs (https://github.com/charmbracelet/vhs) and `kondi-chat`
+# on PATH (npm i -g, or alias it to the built binary). Run from the repo
+# root. Sleep values are first guesses — record once, then tune them to
+# your actual turn latency before committing the GIF.
+
+Output demo.gif
+
+Set Shell "bash"
+Set FontSize 14
+Set Width 1200
+Set Height 720
+Set Theme "Dracula"
+Set TypingSpeed 55ms
+Set Padding 24
+
+# ── Launch the TUI ──────────────────────────────────────────────
+Hide
+Type "kondi-chat"
+Enter
+Sleep 5s
+Show
+Sleep 2s
+
+# ── One coding turn — should route plan / execute / reflect ─────
+Type "add a /health endpoint to the server with a test"
+Sleep 800ms
+Enter
+
+# The turn: investigation → plan → execute → reflect, each phase
+# routed to a different model. Tune to your real turn time.
+Sleep 45s
+
+# ── Show the cost breakdown ─────────────────────────────────────
+Type "/cost"
+Enter
+Sleep 6s
+
+# ── Show the per-tier routing decisions ─────────────────────────
+Type "/routing"
+Enter
+Sleep 7s
+
+# Tail padding so the GIF doesn't cut off abruptly.
+Sleep 2s

package/scripts/postinstall.cjs

@@ -0,0 +1,103 @@
+#!/usr/bin/env node
+
+/**
+ * postinstall — downloads the prebuilt Rust TUI binary for the current
+ * platform from the matching GitHub release.
+ *
+ * Runs automatically on `npm install -g @thispointon/kondi-chat`. If the download
+ * fails (no internet, unsupported platform, no matching release), the
+ * package still works — bin/kondi-chat.js falls back to running the
+ * Node backend directly (no TUI, just stdio). The binary is optional
+ * for functionality; it's required for the terminal UI.
+ *
+ * Platform → artifact name mapping matches the release workflow matrix
+ * in .github/workflows/release.yml.
+ */
+
+const { execSync } = require('child_process');
+const fs = require('fs');
+const path = require('path');
+const https = require('https');
+const http = require('http');
+
+const REPO = 'thisPointOn/kondi-chat';
+
+// Map Node's os.platform()+os.arch() to the GitHub release artifact name.
+const PLATFORM_MAP = {
+  'linux-x64':    'kondi-tui-linux-x64',
+  'linux-arm64':  'kondi-tui-linux-arm64',
+  'darwin-x64':   'kondi-tui-darwin-x64',
+  'darwin-arm64': 'kondi-tui-darwin-arm64',
+  'win32-x64':    'kondi-tui-win32-x64.exe',
+};
+
+function getPlatformKey() {
+  return `${process.platform}-${process.arch}`;
+}
+
+function getVersion() {
+  const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, '..', 'package.json'), 'utf-8'));
+  return pkg.version;
+}
+
+function download(url) {
+  return new Promise((resolve, reject) => {
+    const get = url.startsWith('https') ? https.get : http.get;
+    get(url, { headers: { 'User-Agent': 'kondi-chat-postinstall' } }, (res) => {
+      // Follow redirects (GitHub sends 302 to CDN).
+      if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+        return download(res.headers.location).then(resolve, reject);
+      }
+      if (res.statusCode !== 200) {
+        return reject(new Error(`HTTP ${res.statusCode} for ${url}`));
+      }
+      const chunks = [];
+      res.on('data', (c) => chunks.push(c));
+      res.on('end', () => resolve(Buffer.concat(chunks)));
+      res.on('error', reject);
+    }).on('error', reject);
+  });
+}
+
+async function main() {
+  const key = getPlatformKey();
+  const artifact = PLATFORM_MAP[key];
+
+  if (!artifact) {
+    console.log(`[kondi-chat] No prebuilt TUI binary for ${key}. The Node backend will run without the TUI.`);
+    console.log(`[kondi-chat] To build from source: cd tui && cargo build --release`);
+    return;
+  }
+
+  const version = getVersion();
+  const tag = `v${version}`;
+  const url = `https://github.com/${REPO}/releases/download/${tag}/${artifact}`;
+  const destDir = path.join(__dirname, '..', 'tui', 'target', 'release');
+  const isWindows = process.platform === 'win32';
+  const destFile = path.join(destDir, isWindows ? 'kondi-tui.exe' : 'kondi-tui');
+
+  // Skip if the binary already exists (source build or prior install).
+  if (fs.existsSync(destFile)) {
+    console.log(`[kondi-chat] TUI binary already exists at ${destFile}, skipping download.`);
+    return;
+  }
+
+  console.log(`[kondi-chat] Downloading TUI binary for ${key}...`);
+  console.log(`[kondi-chat] ${url}`);
+
+  try {
+    const data = await download(url);
+    fs.mkdirSync(destDir, { recursive: true });
+    fs.writeFileSync(destFile, data);
+    if (!isWindows) {
+      fs.chmodSync(destFile, 0o755);
+    }
+    console.log(`[kondi-chat] TUI binary installed (${(data.length / 1024 / 1024).toFixed(1)} MB).`);
+  } catch (err) {
+    console.log(`[kondi-chat] Could not download TUI binary: ${err.message}`);
+    console.log(`[kondi-chat] The Node backend will run without the TUI.`);
+    console.log(`[kondi-chat] To build from source: cd tui && cargo build --release`);
+  }
+}
+
+main();

package/src/audit/analytics.ts

@@ -0,0 +1,261 @@
+/**
+ * Analytics — aggregated cost and usage data across sessions.
+ *
+ * Reads all ledger files from .kondi-chat/ and builds summaries
+ * by day, model, provider, and phase. Persists a rolling summary
+ * so it doesn't have to re-read old files.
+ */
+
+import { readFileSync, writeFileSync, existsSync, readdirSync } from 'node:fs';
+import { join } from 'node:path';
+import type { LedgerEntry } from '../types.ts';
+
+// ---------------------------------------------------------------------------
+// Types
+// ---------------------------------------------------------------------------
+
+export interface DailySummary {
+  date: string; // YYYY-MM-DD
+  totalCalls: number;
+  totalInputTokens: number;
+  totalOutputTokens: number;
+  totalCostUsd: number;
+  byModel: Record<string, ModelDaySummary>;
+  byProvider: Record<string, ProviderDaySummary>;
+}
+
+export interface ModelDaySummary {
+  calls: number;
+  inputTokens: number;
+  outputTokens: number;
+  costUsd: number;
+}
+
+export interface ProviderDaySummary {
+  calls: number;
+  inputTokens: number;
+  outputTokens: number;
+  costUsd: number;
+  models: string[];
+}
+
+export interface AnalyticsSummary {
+  period: string;
+  days: number;
+  totalCalls: number;
+  totalInputTokens: number;
+  totalOutputTokens: number;
+  totalCostUsd: number;
+  byModel: Record<string, ModelDaySummary>;
+  byProvider: Record<string, ProviderDaySummary>;
+  dailyBreakdown: DailySummary[];
+}
+
+// ---------------------------------------------------------------------------
+// Analytics
+// ---------------------------------------------------------------------------
+
+export class Analytics {
+  private storageDir: string;
+  private summaryPath: string;
+  private dailyData: Map<string, DailySummary> = new Map();
+
+  constructor(storageDir: string) {
+    this.storageDir = storageDir;
+    this.summaryPath = join(storageDir, 'analytics.json');
+    this.load();
+  }
+
+  /** Rebuild analytics from all ledger files */
+  rebuild(): void {
+    this.dailyData.clear();
+
+    const files = readdirSync(this.storageDir)
+      .filter(f => f.endsWith('-ledger.json'));
+
+    for (const file of files) {
+      try {
+        const entries: LedgerEntry[] = JSON.parse(
+          readFileSync(join(this.storageDir, file), 'utf-8')
+        );
+        for (const entry of entries) {
+          this.addEntry(entry);
+        }
+      } catch {
+        // Skip corrupt files
+      }
+    }
+
+    this.save();
+  }
+
+  /** Add a single entry (for live updates during a session) */
+  addEntry(entry: LedgerEntry): void {
+    const date = entry.timestamp.slice(0, 10); // YYYY-MM-DD
+    let day = this.dailyData.get(date);
+    if (!day) {
+      day = {
+        date,
+        totalCalls: 0,
+        totalInputTokens: 0,
+        totalOutputTokens: 0,
+        totalCostUsd: 0,
+        byModel: {},
+        byProvider: {},
+      };
+      this.dailyData.set(date, day);
+    }
+
+    day.totalCalls++;
+    day.totalInputTokens += entry.inputTokens;
+    day.totalOutputTokens += entry.outputTokens;
+    day.totalCostUsd += entry.costUsd;
+
+    // By model
+    if (!day.byModel[entry.model]) {
+      day.byModel[entry.model] = { calls: 0, inputTokens: 0, outputTokens: 0, costUsd: 0 };
+    }
+    day.byModel[entry.model].calls++;
+    day.byModel[entry.model].inputTokens += entry.inputTokens;
+    day.byModel[entry.model].outputTokens += entry.outputTokens;
+    day.byModel[entry.model].costUsd += entry.costUsd;
+
+    // By provider
+    if (!day.byProvider[entry.provider]) {
+      day.byProvider[entry.provider] = { calls: 0, inputTokens: 0, outputTokens: 0, costUsd: 0, models: [] };
+    }
+    day.byProvider[entry.provider].calls++;
+    day.byProvider[entry.provider].inputTokens += entry.inputTokens;
+    day.byProvider[entry.provider].outputTokens += entry.outputTokens;
+    day.byProvider[entry.provider].costUsd += entry.costUsd;
+    if (!day.byProvider[entry.provider].models.includes(entry.model)) {
+      day.byProvider[entry.provider].models.push(entry.model);
+    }
+  }
+
+  /** Get summary for the last N days (default 30) */
+  getSummary(days = 30): AnalyticsSummary {
+    const now = new Date();
+    const cutoff = new Date(now.getTime() - days * 86400000);
+    const cutoffStr = cutoff.toISOString().slice(0, 10);
+
+    const filtered = [...this.dailyData.values()]
+      .filter(d => d.date >= cutoffStr)
+      .sort((a, b) => a.date.localeCompare(b.date));
+
+    const totals: AnalyticsSummary = {
+      period: `Last ${days} days`,
+      days: filtered.length,
+      totalCalls: 0,
+      totalInputTokens: 0,
+      totalOutputTokens: 0,
+      totalCostUsd: 0,
+      byModel: {},
+      byProvider: {},
+      dailyBreakdown: filtered,
+    };
+
+    for (const day of filtered) {
+      totals.totalCalls += day.totalCalls;
+      totals.totalInputTokens += day.totalInputTokens;
+      totals.totalOutputTokens += day.totalOutputTokens;
+      totals.totalCostUsd += day.totalCostUsd;
+
+      for (const [model, data] of Object.entries(day.byModel)) {
+        if (!totals.byModel[model]) {
+          totals.byModel[model] = { calls: 0, inputTokens: 0, outputTokens: 0, costUsd: 0 };
+        }
+        totals.byModel[model].calls += data.calls;
+        totals.byModel[model].inputTokens += data.inputTokens;
+        totals.byModel[model].outputTokens += data.outputTokens;
+        totals.byModel[model].costUsd += data.costUsd;
+      }
+
+      for (const [provider, data] of Object.entries(day.byProvider)) {
+        if (!totals.byProvider[provider]) {
+          totals.byProvider[provider] = { calls: 0, inputTokens: 0, outputTokens: 0, costUsd: 0, models: [] };
+        }
+        totals.byProvider[provider].calls += data.calls;
+        totals.byProvider[provider].inputTokens += data.inputTokens;
+        totals.byProvider[provider].outputTokens += data.outputTokens;
+        totals.byProvider[provider].costUsd += data.costUsd;
+        for (const m of data.models) {
+          if (!totals.byProvider[provider].models.includes(m)) {
+            totals.byProvider[provider].models.push(m);
+          }
+        }
+      }
+    }
+
+    return totals;
+  }
+
+  /** Format for display */
+  format(days = 30): string {
+    const s = this.getSummary(days);
+    if (s.totalCalls === 0) return 'No usage data yet.';
+
+    const lines: string[] = [
+      `═══ Usage Analytics (${s.period}) ═══`,
+      `Total: ${s.totalCalls} calls | ${s.totalInputTokens.toLocaleString()}in / ${s.totalOutputTokens.toLocaleString()}out | $${s.totalCostUsd.toFixed(4)}`,
+      '',
+      'By Provider:',
+    ];
+
+    for (const [provider, data] of Object.entries(s.byProvider).sort((a, b) => b[1].costUsd - a[1].costUsd)) {
+      lines.push(`  ${provider.padEnd(15)} ${data.calls} calls  ${data.inputTokens.toLocaleString().padStart(10)}in  ${data.outputTokens.toLocaleString().padStart(10)}out  $${data.costUsd.toFixed(4)}`);
+    }
+
+    lines.push('', 'By Model:');
+    for (const [model, data] of Object.entries(s.byModel).sort((a, b) => b[1].costUsd - a[1].costUsd)) {
+      lines.push(`  ${model.slice(0, 30).padEnd(32)} ${data.calls} calls  ${data.inputTokens.toLocaleString().padStart(10)}in  ${data.outputTokens.toLocaleString().padStart(10)}out  $${data.costUsd.toFixed(4)}`);
+    }
+
+    if (s.dailyBreakdown.length > 0) {
+      lines.push('', 'Daily (by model):');
+      for (const day of s.dailyBreakdown.slice(-7)) { // Last 7 days
+        lines.push(`  ${day.date}  ${day.totalCalls} calls  $${day.totalCostUsd.toFixed(4)}`);
+        const models = Object.entries(day.byModel).sort((a, b) => b[1].costUsd - a[1].costUsd);
+        for (const [model, data] of models) {
+          lines.push(`    ${model.slice(0, 26).padEnd(28)} ${data.calls} calls  ${data.inputTokens.toLocaleString().padStart(9)}in  ${data.outputTokens.toLocaleString().padStart(7)}out  $${data.costUsd.toFixed(4)}`);
+        }
+      }
+      if (s.dailyBreakdown.length > 7) {
+        lines.push(`  ... ${s.dailyBreakdown.length - 7} earlier days`);
+      }
+    }
+
+    return lines.join('\n');
+  }
+
+  /** Export all data as JSON */
+  exportAll(): string {
+    return JSON.stringify({
+      exportedAt: new Date().toISOString(),
+      daily: [...this.dailyData.values()].sort((a, b) => a.date.localeCompare(b.date)),
+    }, null, 2);
+  }
+
+  // ── Persistence ──────────────────────────────────────────────────
+
+  private load(): void {
+    if (!existsSync(this.summaryPath)) {
+      this.rebuild();
+      return;
+    }
+    try {
+      const data = JSON.parse(readFileSync(this.summaryPath, 'utf-8'));
+      for (const day of data.daily || []) {
+        this.dailyData.set(day.date, day);
+      }
+    } catch {
+      this.rebuild();
+    }
+  }
+
+  save(): void {
+    writeFileSync(this.summaryPath, JSON.stringify({
+      daily: [...this.dailyData.values()].sort((a, b) => a.date.localeCompare(b.date)),
+    }, null, 2));
+  }
+}