@thispointon/kondi-chat 0.1.2

package/src/council-engine/cli/council-artifacts.ts

@@ -0,0 +1,230 @@
+/**
+ * CLI Council Artifact Writer
+ *
+ * Writes council deliberation artifacts to disk using node:fs.
+ * Supports 5 output formats: full, abbreviated, output-only, json, none.
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+import type { Council } from '../council/types';
+import { buildFullDeliberation, buildAbbreviatedSummary } from '../services/deliberationSummary';
+import { getDecision, getLatestOutput } from '../council/context-store';
+import { getAllEntries } from '../council/ledger-store';
+import type { OutputFormat } from './council-config';
+
+// ============================================================================
+// Helpers (mirrored from deliberationSaveService.ts, Tauri-free)
+// ============================================================================
+
+function sanitizeName(name: string): string {
+  return name
+    .toLowerCase()
+    .replace(/[^a-z0-9_-]/g, '_')
+    .replace(/_+/g, '_')
+    .replace(/^_|_$/g, '')
+    .slice(0, 50);
+}
+
+function timestampSlug(): string {
+  const d = new Date();
+  const pad = (n: number) => String(n).padStart(2, '0');
+  return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}_${pad(d.getHours())}-${pad(d.getMinutes())}-${pad(d.getSeconds())}`;
+}
+
+function resolveOutputDir(workingDir: string, councilName: string, overrideDir?: string): string {
+  if (overrideDir) {
+    return path.resolve(overrideDir);
+  }
+  const safeName = sanitizeName(councilName);
+  const ts = timestampSlug();
+  const base = workingDir.replace(/\/$/, '');
+  return `${base}/.kondi/outputs/${safeName}_${ts}`;
+}
+
+function ensureDir(dir: string): void {
+  fs.mkdirSync(dir, { recursive: true });
+}
+
+function writeFile(filePath: string, content: string): void {
+  ensureDir(path.dirname(filePath));
+  fs.writeFileSync(filePath, content, 'utf-8');
+}
+
+// ============================================================================
+// Format Writers
+// ============================================================================
+
+function writeFull(council: Council, outputDir: string): string[] {
+  const files: string[] = [];
+
+  // deliberation.md
+  const deliberationMd = buildFullDeliberation(council);
+  const deliberationPath = path.join(outputDir, 'deliberation.md');
+  writeFile(deliberationPath, deliberationMd);
+  files.push(deliberationPath);
+
+  // decision.md
+  const decision = getDecision(council.id);
+  let decisionMd = `# Decision\n\n`;
+  if (decision) {
+    decisionMd += decision.content;
+    if (decision.acceptanceCriteria) {
+      decisionMd += `\n\n## Acceptance Criteria\n\n${decision.acceptanceCriteria}`;
+    }
+  } else {
+    decisionMd += 'No decision recorded.';
+  }
+  const decisionPath = path.join(outputDir, 'decision.md');
+  writeFile(decisionPath, decisionMd);
+  files.push(decisionPath);
+
+  // output.md
+  const output = getLatestOutput(council.id);
+  let outputMd = `# Output\n\n`;
+  if (output) {
+    outputMd += output.content;
+  } else {
+    outputMd += 'No output recorded.';
+  }
+  const outputPath = path.join(outputDir, 'output.md');
+  writeFile(outputPath, outputMd);
+  files.push(outputPath);
+
+  return files;
+}
+
+function writeAbbreviated(council: Council, outputDir: string): string[] {
+  const summaryMd = buildAbbreviatedSummary(council);
+  const summaryPath = path.join(outputDir, 'summary.md');
+  writeFile(summaryPath, summaryMd);
+  return [summaryPath];
+}
+
+function writeOutputOnly(council: Council, outputDir: string): string[] {
+  const output = getLatestOutput(council.id);
+  let outputMd = `# Output\n\n`;
+  if (output) {
+    outputMd += output.content;
+  } else {
+    outputMd += 'No output recorded.';
+  }
+  const outputPath = path.join(outputDir, 'output.md');
+  writeFile(outputPath, outputMd);
+  return [outputPath];
+}
+
+function writeJson(council: Council, outputDir: string): string[] {
+  const entries = getAllEntries(council.id);
+  const decision = getDecision(council.id);
+  const output = getLatestOutput(council.id);
+
+  const result = {
+    council: {
+      id: council.id,
+      name: council.name,
+      topic: council.topic,
+      createdAt: council.createdAt,
+      status: council.status,
+      totalTokensUsed: council.totalTokensUsed,
+      personas: council.personas.map(p => ({
+        id: p.id,
+        name: p.name,
+        provider: p.provider,
+        model: p.model,
+        role: p.preferredDeliberationRole,
+      })),
+    },
+    deliberation: {
+      rounds: council.deliberationState?.currentRound ?? 0,
+      revisions: council.deliberationState?.revisionCount ?? 0,
+      phase: council.deliberationState?.currentPhase,
+      entryCount: entries.length,
+    },
+    entries: entries.map(e => ({
+      timestamp: e.timestamp,
+      author: e.authorPersonaId,
+      entryType: e.entryType,
+      round: e.roundNumber,
+      content: e.content,
+      tokensUsed: e.tokensUsed,
+      latencyMs: e.latencyMs,
+    })),
+    decision: decision ? {
+      content: decision.content,
+      acceptanceCriteria: decision.acceptanceCriteria,
+    } : null,
+    output: output ? {
+      content: output.content,
+      version: output.version,
+    } : null,
+  };
+
+  const jsonPath = path.join(outputDir, 'council-result.json');
+  writeFile(jsonPath, JSON.stringify(result, null, 2));
+  return [jsonPath];
+}
+
+// ============================================================================
+// Public API
+// ============================================================================
+
+export interface WriteArtifactsOpts {
+  format: OutputFormat;
+  outputDir?: string;
+  workingDir: string;
+}
+
+/**
+ * Write council artifacts to disk.
+ * Returns array of written file paths (empty for 'none' format).
+ */
+export function writeCouncilArtifacts(council: Council, opts: WriteArtifactsOpts): string[] {
+  if (opts.format === 'none') return [];
+
+  const outputDir = resolveOutputDir(opts.workingDir, council.name, opts.outputDir);
+
+  switch (opts.format) {
+    case 'full':
+      return writeFull(council, outputDir);
+    case 'abbreviated':
+      return writeAbbreviated(council, outputDir);
+    case 'output-only':
+      return writeOutputOnly(council, outputDir);
+    case 'json':
+      return writeJson(council, outputDir);
+    default:
+      return writeFull(council, outputDir);
+  }
+}
+
+/**
+ * Build structured JSON result for --json-stdout output.
+ */
+export function buildJsonResult(council: Council, artifactPaths: string[], executionInfo: {
+  status: 'completed' | 'failed';
+  durationMs: number;
+  error?: string;
+}): object {
+  const entries = getAllEntries(council.id);
+  const decision = getDecision(council.id);
+  const output = getLatestOutput(council.id);
+
+  return {
+    status: executionInfo.status,
+    durationMs: executionInfo.durationMs,
+    error: executionInfo.error,
+    council: {
+      id: council.id,
+      name: council.name,
+      topic: council.topic,
+      totalTokensUsed: council.totalTokensUsed,
+      rounds: council.deliberationState?.currentRound ?? 0,
+      revisions: council.deliberationState?.revisionCount ?? 0,
+      entryCount: entries.length,
+    },
+    decision: decision?.content ?? null,
+    output: output?.content ?? null,
+    artifacts: artifactPaths,
+  };
+}

package/src/council-engine/cli/council-config.ts

@@ -0,0 +1,178 @@
+/**
+ * CLI Council Config Loader
+ *
+ * Loads council configuration from JSON files with auto-discovery.
+ * Search order: explicit --config path, cwd/council.json, ~/.config/kondi/council.json
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import type { CouncilStepType } from '../pipeline/types';
+
+// ============================================================================
+// Config Schema
+// ============================================================================
+
+export type OutputFormat = 'full' | 'abbreviated' | 'output-only' | 'json' | 'none';
+
+export interface CouncilPersonaConfig {
+  name: string;
+  role: 'manager' | 'worker' | 'consultant' | 'reviewer';
+  provider?: string;
+  model?: string;
+  avatar?: string;
+  systemPrompt?: string;
+  traits?: string[];
+  stance?: 'advocate' | 'critic' | 'neutral' | 'wildcard';
+  domain?: string;
+  temperature?: number;
+  suppressPersona?: boolean;
+  toolAccess?: 'full' | 'none';
+}
+
+export interface CouncilConfigFile {
+  name: string;
+  task?: string;
+  type?: CouncilStepType;
+  personas: CouncilPersonaConfig[];
+  orchestration?: {
+    maxRounds?: number;
+    maxRevisions?: number;
+    contextTokenBudget?: number;
+    summarizeAfterRound?: number;
+    summaryMode?: string;
+    consultantExecution?: 'sequential' | 'parallel';
+    evolveContext?: boolean;
+    bootstrapContext?: boolean;
+  };
+  output?: {
+    format?: OutputFormat;
+    directory?: string;
+    sessionExport?: boolean;
+  };
+  expectedOutput?: string;
+  decisionCriteria?: string[];
+  testCommand?: string;
+  maxDebugCycles?: number;
+  maxReviewCycles?: number;
+}
+
+// ============================================================================
+// CLI Args (parsed externally, merged here)
+// ============================================================================
+
+export interface CouncilCliArgs {
+  configPath?: string;
+  councilJsonPath?: string;
+  task?: string;
+  type?: CouncilStepType;
+  workingDir?: string;
+  model?: string;
+  provider?: string;
+  outputFormat?: OutputFormat;
+  outputDir?: string;
+  noSessionExport?: boolean;
+  noCache?: boolean;
+  dryRun?: boolean;
+  quiet?: boolean;
+  jsonStdout?: boolean;
+}
+
+// ============================================================================
+// Loader
+// ============================================================================
+
+const SEARCH_PATHS = [
+  () => path.join(process.cwd(), 'council.json'),
+  () => path.join(os.homedir(), '.config', 'kondi', 'council.json'),
+];
+
+export function loadCouncilConfig(configPath?: string): CouncilConfigFile | null {
+  // Explicit path
+  if (configPath) {
+    const resolved = path.resolve(configPath);
+    if (!fs.existsSync(resolved)) {
+      throw new Error(`Config file not found: ${resolved}`);
+    }
+    return parseAndValidate(resolved);
+  }
+
+  // Auto-discovery
+  for (const getPath of SEARCH_PATHS) {
+    const p = getPath();
+    if (fs.existsSync(p)) {
+      return parseAndValidate(p);
+    }
+  }
+
+  return null;
+}
+
+function parseAndValidate(filePath: string): CouncilConfigFile {
+  const raw = fs.readFileSync(filePath, 'utf-8');
+  let parsed: any;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    throw new Error(`Invalid JSON in config file: ${filePath}`);
+  }
+
+  // Validate required fields
+  if (!parsed.name || typeof parsed.name !== 'string') {
+    throw new Error(`Config file missing required "name" field: ${filePath}`);
+  }
+  if (!Array.isArray(parsed.personas) || parsed.personas.length === 0) {
+    throw new Error(`Config file must have at least one persona: ${filePath}`);
+  }
+  for (const p of parsed.personas) {
+    if (!p.name || !p.role) {
+      throw new Error(`Each persona must have "name" and "role": ${filePath}`);
+    }
+    const validRoles = ['manager', 'worker', 'consultant', 'reviewer'];
+    if (!validRoles.includes(p.role)) {
+      throw new Error(`Invalid persona role "${p.role}" for "${p.name}". Must be: ${validRoles.join(', ')}`);
+    }
+  }
+
+  return parsed as CouncilConfigFile;
+}
+
+// ============================================================================
+// Merge config with CLI args (CLI wins)
+// ============================================================================
+
+export interface ResolvedCouncilConfig {
+  config: CouncilConfigFile;
+  task: string;
+  type: CouncilStepType;
+  workingDir?: string;
+  model?: string;
+  provider?: string;
+  outputFormat: OutputFormat;
+  outputDir?: string;
+  sessionExport: boolean;
+  dryRun: boolean;
+  quiet: boolean;
+  jsonStdout: boolean;
+}
+
+export function mergeConfigWithArgs(
+  config: CouncilConfigFile,
+  args: CouncilCliArgs,
+): ResolvedCouncilConfig {
+  return {
+    config,
+    task: args.task || config.task || config.name,
+    type: args.type || config.type || 'council',
+    workingDir: args.workingDir,
+    model: args.model,
+    provider: args.provider,
+    outputFormat: args.outputFormat || config.output?.format || 'full',
+    outputDir: args.outputDir || config.output?.directory,
+    sessionExport: args.noSessionExport ? false : (config.output?.sessionExport ?? true),
+    dryRun: args.dryRun || false,
+    quiet: args.quiet || false,
+    jsonStdout: args.jsonStdout || false,
+  };
+}

package/src/council-engine/cli/council-session-export.ts

@@ -0,0 +1,116 @@
+/**
+ * CLI Council Session Export
+ *
+ * Exports a standalone council session for GUI import.
+ * Parallel to session-export.ts but council-focused (no pipeline wrapper).
+ *
+ * Output: ~/.local/share/kondi/sessions/council-<councilId>-<timestamp>.json
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+
+const SESSIONS_DIR = path.join(os.homedir(), '.local', 'share', 'kondi', 'sessions');
+
+/** localStorage key conventions — must match store modules */
+const KEYS = {
+  councils: 'mcp-councils',
+  ledgerIndex: (id: string) => `ledger-index-${id}`,
+  ledgerChunk: (id: string, n: number) => `ledger-chunk-${id}-${n}`,
+  context: (id: string) => `context-${id}`,
+  contextHistory: (id: string) => `context-history-${id}`,
+  contextPatches: (id: string) => `context-patches-${id}`,
+  decision: (id: string) => `decision-${id}`,
+  plan: (id: string) => `plan-${id}`,
+  directive: (id: string) => `directive-${id}`,
+  outputs: (id: string) => `outputs-${id}`,
+};
+
+interface CouncilExecutionInfo {
+  status: 'completed' | 'failed';
+  startedAt: string;
+  completedAt: string;
+  durationMs: number;
+  workingDirectory?: string;
+}
+
+/**
+ * Export a standalone council session to a JSON file.
+ * Reads all council data from the file-backed localStorage shim.
+ */
+export function exportCouncilSession(
+  councilId: string,
+  storage: Storage,
+  execution: CouncilExecutionInfo,
+): string | null {
+  try {
+    // Load council from store
+    const councilsRaw = storage.getItem(KEYS.councils);
+    const councilsData = councilsRaw ? JSON.parse(councilsRaw) : { councils: [] };
+    const allCouncils = councilsData.councils || [];
+    const council = allCouncils.find((c: any) => c.id === councilId);
+    if (!council) {
+      console.error('[CouncilSessionExport] Council not found:', councilId);
+      return null;
+    }
+
+    // Collect ledger data
+    const ledgerIndexRaw = storage.getItem(KEYS.ledgerIndex(councilId));
+    const ledgerIndex = ledgerIndexRaw ? JSON.parse(ledgerIndexRaw) : null;
+
+    const ledgerChunks: Record<number, any[]> = {};
+    if (ledgerIndex) {
+      const chunkCount = ledgerIndex.chunkCount ?? 0;
+      for (let n = 0; n <= chunkCount; n++) {
+        const chunkRaw = storage.getItem(KEYS.ledgerChunk(councilId, n));
+        if (chunkRaw) {
+          ledgerChunks[n] = JSON.parse(chunkRaw);
+        }
+      }
+    }
+
+    // Collect context artifacts
+    const contextRaw = storage.getItem(KEYS.context(councilId));
+    const contextHistoryRaw = storage.getItem(KEYS.contextHistory(councilId));
+    const contextPatchesRaw = storage.getItem(KEYS.contextPatches(councilId));
+    const decisionRaw = storage.getItem(KEYS.decision(councilId));
+    const planRaw = storage.getItem(KEYS.plan(councilId));
+    const directiveRaw = storage.getItem(KEYS.directive(councilId));
+    const outputsRaw = storage.getItem(KEYS.outputs(councilId));
+
+    const councilData = {
+      ledgerIndex,
+      ledgerChunks,
+      context: contextRaw ? JSON.parse(contextRaw) : null,
+      contextHistory: contextHistoryRaw ? JSON.parse(contextHistoryRaw) : [],
+      contextPatches: contextPatchesRaw ? JSON.parse(contextPatchesRaw) : [],
+      decision: decisionRaw ? JSON.parse(decisionRaw) : null,
+      plan: planRaw ? JSON.parse(planRaw) : null,
+      directive: directiveRaw ? JSON.parse(directiveRaw) : null,
+      outputs: outputsRaw ? JSON.parse(outputsRaw) : [],
+    };
+
+    // Build session
+    const session = {
+      version: 1,
+      exportedAt: new Date().toISOString(),
+      source: 'cli-council',
+      council,
+      councilData: { [councilId]: councilData },
+      execution,
+    };
+
+    // Write to sessions directory
+    fs.mkdirSync(SESSIONS_DIR, { recursive: true });
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const filename = `council-${councilId}-${timestamp}.json`;
+    const filePath = path.join(SESSIONS_DIR, filename);
+    fs.writeFileSync(filePath, JSON.stringify(session, null, 2), 'utf-8');
+
+    return filePath;
+  } catch (err) {
+    console.error('[CouncilSessionExport] Failed to export session:', err);
+    return null;
+  }
+}

package/src/council-engine/cli/kondi.ts

@@ -0,0 +1,98 @@
+#!/usr/bin/env -S npx tsx
+/**
+ * Kondi CLI — Multi-LLM Council Platform
+ *
+ * Usage:
+ *   kondi council [options]     Run a council deliberation
+ *   kondi pipeline [options]    Run a pipeline
+ *   kondi --help                Show help
+ *   kondi --version             Show version
+ */
+
+// Load .env if present (API keys)
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirnameLocal = dirname(fileURLToPath(import.meta.url));
+for (const envPath of [resolve(process.cwd(), '.env'), resolve(__dirnameLocal, '..', '..', '.env')]) {
+  if (existsSync(envPath)) {
+    for (const line of readFileSync(envPath, 'utf-8').split('\n')) {
+      const m = line.match(/^([A-Z_]+)=(.+)$/);
+      if (m && !process.env[m[1]]) process.env[m[1]] = m[2];
+    }
+    break;
+  }
+}
+
+const C = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  dim: '\x1b[2m',
+  cyan: '\x1b[36m',
+};
+
+function printHelp() {
+  console.log(`
+${C.bold}${C.cyan}Kondi${C.reset} — Multi-LLM Council Platform
+
+${C.bold}Commands:${C.reset}
+  council     Run a council deliberation
+  pipeline    Run a pipeline from JSON
+
+${C.bold}Usage:${C.reset}
+  kondi council --task "Review this code" --working-dir ./myapp
+  kondi council --config council.json
+  kondi council exported-council.json
+  kondi pipeline pipeline.json --working-dir ./project
+
+${C.bold}Options:${C.reset}
+  --help, -h       Show help (use "kondi council --help" for subcommand help)
+  --version, -v    Show version
+
+Run ${C.dim}kondi <command> --help${C.reset} for subcommand-specific options.
+`);
+}
+
+async function main() {
+  const subcommand = process.argv[2];
+
+  if (!subcommand || subcommand === '--help' || subcommand === '-h') {
+    printHelp();
+    process.exit(0);
+  }
+
+  if (subcommand === '--version' || subcommand === '-v') {
+    try {
+      const { readFileSync } = await import('node:fs');
+      const { join, dirname } = await import('node:path');
+      const { fileURLToPath } = await import('node:url');
+      const __dirname = dirname(fileURLToPath(import.meta.url));
+      const pkg = JSON.parse(readFileSync(join(__dirname, '..', '..', 'package.json'), 'utf-8'));
+      console.log(`kondi ${pkg.version || '0.0.0'}`);
+    } catch {
+      console.log('kondi 0.0.0');
+    }
+    process.exit(0);
+  }
+
+  // Strip the subcommand from argv so the sub-runner sees the right args
+  process.argv = [process.argv[0], process.argv[1], ...process.argv.slice(3)];
+
+  switch (subcommand) {
+    case 'council':
+      await import('./run-council');
+      break;
+    case 'pipeline':
+      await import('./run-pipeline');
+      break;
+    default:
+      console.error(`Unknown command: ${subcommand}`);
+      console.error(`Run "kondi --help" for available commands.`);
+      process.exit(1);
+  }
+}
+
+main().catch((err) => {
+  console.error('Unhandled error:', err);
+  process.exit(1);
+});