@thispointon/kondi-chat 0.1.2

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

@@ -0,0 +1,153 @@
+/**
+ * CLI Session Export
+ *
+ * After a CLI pipeline run, exports a session file bundling the pipeline,
+ * all referenced councils, and all deliberation artifacts. The GUI can
+ * discover and import these files to make CLI results browsable.
+ *
+ * Output: ~/.local/share/kondi/sessions/<pipelineId>-<timestamp>.json
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+import os from 'node:os';
+import type { Pipeline } from '../pipeline/types';
+import type { KondiSession, KondiSessionCouncilData } from '../pipeline/types';
+
+const SESSIONS_DIR = path.join(os.homedir(), '.local', 'share', 'kondi', 'sessions');
+
+/** localStorage key prefixes — must match the store modules exactly */
+const KEYS = {
+  pipelines: 'mcp-pipelines',
+  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 ExportExecutionInfo {
+  status: 'completed' | 'failed';
+  startedAt: string;
+  completedAt: string;
+  durationMs: number;
+  workingDirectory: string;
+}
+
+/**
+ * Export a CLI pipeline session to a JSON file.
+ *
+ * Reads all relevant data from the file-backed localStorage shim
+ * and writes a self-contained session file the GUI can import.
+ */
+export function exportSession(
+  pipelineId: string,
+  storage: Storage,
+  execution: ExportExecutionInfo,
+): string | null {
+  try {
+    // 1. Load pipeline from store
+    const pipelinesRaw = storage.getItem(KEYS.pipelines);
+    if (!pipelinesRaw) {
+      console.error('[SessionExport] No pipelines found in storage');
+      return null;
+    }
+    const pipelinesData = JSON.parse(pipelinesRaw);
+    const pipelines: Pipeline[] = pipelinesData.pipelines || [];
+    const pipeline = pipelines.find(p => p.id === pipelineId);
+    if (!pipeline) {
+      console.error('[SessionExport] Pipeline not found:', pipelineId);
+      return null;
+    }
+
+    // 2. Collect council IDs from step artifacts
+    const councilIds = new Set<string>();
+    for (const stage of pipeline.stages) {
+      for (const step of stage.steps) {
+        if (step.artifact?.metadata?.councilId) {
+          councilIds.add(step.artifact.metadata.councilId);
+        }
+      }
+    }
+
+    // 3. Load councils
+    const councilsRaw = storage.getItem(KEYS.councils);
+    const councilsData = councilsRaw ? JSON.parse(councilsRaw) : { councils: [] };
+    const allCouncils = councilsData.councils || [];
+    const councils = allCouncils.filter((c: any) => councilIds.has(c.id));
+
+    // 4. For each council, collect all associated localStorage keys
+    const councilData: Record<string, KondiSessionCouncilData> = {};
+
+    for (const councilId of councilIds) {
+      // Ledger index
+      const ledgerIndexRaw = storage.getItem(KEYS.ledgerIndex(councilId));
+      const ledgerIndex = ledgerIndexRaw ? JSON.parse(ledgerIndexRaw) : null;
+
+      // Ledger chunks — read until we get 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);
+          }
+        }
+      }
+
+      // 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));
+
+      councilData[councilId] = {
+        ledgerIndex: 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) : [],
+      };
+    }
+
+    // 5. Build session object
+    // Override pipeline.status with the definitive execution outcome —
+    // the executor's store update and the export can race, so trust
+    // the explicitly-passed execution status.
+    const session: KondiSession = {
+      version: 1,
+      exportedAt: new Date().toISOString(),
+      source: 'cli',
+      pipeline: { ...pipeline, source: 'cli', status: execution.status },
+      councils,
+      councilData,
+      execution,
+    };
+
+    // 6. Write to sessions directory
+    fs.mkdirSync(SESSIONS_DIR, { recursive: true });
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const filename = `${pipelineId}-${timestamp}.json`;
+    const filePath = path.join(SESSIONS_DIR, filename);
+    fs.writeFileSync(filePath, JSON.stringify(session, null, 2), 'utf-8');
+
+    console.log(`[SessionExport] Session exported to: ${filePath}`);
+    return filePath;
+  } catch (err) {
+    console.error('[SessionExport] Failed to export session:', err);
+    return null;
+  }
+}

package/src/council-engine/configs/councils/analysis.json

@@ -0,0 +1,101 @@
+{
+  "name": "Code Analysis Council",
+  "type": "analysis",
+  "personas": [
+    {
+      "name": "Lead Analyst",
+      "role": "manager",
+      "provider": "anthropic-api",
+      "model": "claude-sonnet-4-5-20250929",
+      "avatar": "\ud83d\udd0d",
+      "systemPrompt": "You are the lead code analyst. You coordinate a thorough review of the codebase, synthesizing findings from multiple perspectives into prioritized, actionable improvement recommendations. You distinguish between critical issues and nice-to-haves.",
+      "traits": [
+        "analytical",
+        "decisive",
+        "prioritization-focused"
+      ],
+      "stance": "neutral",
+      "suppressPersona": true
+    },
+    {
+      "name": "Security Auditor",
+      "role": "consultant",
+      "provider": "openai-api",
+      "avatar": "\ud83d\udee1\ufe0f",
+      "systemPrompt": "You are a security-focused code auditor. You look for injection vulnerabilities, auth bypasses, data leaks, insecure defaults, and OWASP top 10 issues. You rate findings by severity and exploitability.",
+      "traits": [
+        "paranoid",
+        "thorough",
+        "severity-aware"
+      ],
+      "stance": "critic",
+      "domain": "application security",
+      "model": "gpt-4o"
+    },
+    {
+      "name": "Performance Engineer",
+      "role": "consultant",
+      "provider": "anthropic-api",
+      "model": "claude-sonnet-4-5-20250929",
+      "avatar": "\u26a1",
+      "systemPrompt": "You are a performance engineer. You identify bottlenecks, unnecessary allocations, N+1 queries, missing caching opportunities, and code that won't scale. You think in terms of hot paths and real-world load patterns.",
+      "traits": [
+        "metrics-driven",
+        "efficiency-focused",
+        "practical"
+      ],
+      "stance": "advocate",
+      "domain": "performance optimization"
+    },
+    {
+      "name": "Code Quality Reviewer",
+      "role": "consultant",
+      "provider": "openai-api",
+      "avatar": "\u2728",
+      "systemPrompt": "You review code for maintainability, readability, and structural quality. You identify dead code, duplicated logic, missing abstractions, inconsistent patterns, poor naming, and test gaps. You suggest concrete refactoring paths.",
+      "traits": [
+        "quality-obsessed",
+        "pattern-aware",
+        "constructive"
+      ],
+      "stance": "critic",
+      "domain": "code quality and maintainability",
+      "model": "gpt-4o"
+    },
+    {
+      "name": "Report Writer",
+      "role": "worker",
+      "provider": "anthropic-api",
+      "model": "claude-sonnet-4-5-20250929",
+      "avatar": "\ud83d\udccb",
+      "systemPrompt": "You compile analysis findings into a structured report: executive summary, critical issues, improvement recommendations (prioritized by impact/effort), and suggested next steps. Be specific \u2014 cite file paths and line numbers.",
+      "traits": [
+        "organized",
+        "precise",
+        "clear"
+      ],
+      "temperature": 0.2,
+      "suppressPersona": true
+    }
+  ],
+  "orchestration": {
+    "maxRounds": 3,
+    "maxRevisions": 2,
+    "contextTokenBudget": 100000,
+    "summarizeAfterRound": 2,
+    "consultantExecution": "parallel",
+    "bootstrapContext": true,
+    "evolveContext": true
+  },
+  "output": {
+    "format": "full",
+    "sessionExport": true
+  },
+  "expectedOutput": "A prioritized analysis report with findings categorized by severity, specific file/line references, and actionable improvement recommendations.",
+  "decisionCriteria": [
+    "All critical issues are identified with clear evidence",
+    "Recommendations are prioritized by impact and effort",
+    "Findings include specific file paths and code references",
+    "Report distinguishes must-fix from nice-to-have"
+  ]
+}

package/src/council-engine/configs/councils/code-planning.json

@@ -0,0 +1,86 @@
+{
+  "name": "Code Planning Council",
+  "type": "code_planning",
+  "personas": [
+    {
+      "name": "Architect",
+      "role": "manager",
+      "provider": "anthropic-api",
+      "model": "claude-sonnet-4-5-20250929",
+      "avatar": "\ud83c\udfd7\ufe0f",
+      "systemPrompt": "You are a senior software architect. You decompose problems into clear, actionable implementation plans. You consider dependencies, interfaces, and sequencing. You push back on vague requirements and demand clarity before committing to a plan.",
+      "traits": [
+        "analytical",
+        "systematic",
+        "pragmatic"
+      ],
+      "stance": "neutral",
+      "suppressPersona": true
+    },
+    {
+      "name": "Systems Thinker",
+      "role": "consultant",
+      "provider": "openai-api",
+      "avatar": "\ud83e\udde0",
+      "systemPrompt": "You are a systems design consultant. You think about how components interact, where failure modes hide, and what the second-order effects of design decisions are. You challenge assumptions about scalability, complexity, and maintenance burden.",
+      "traits": [
+        "holistic",
+        "contrarian",
+        "thorough"
+      ],
+      "stance": "critic",
+      "domain": "system architecture",
+      "model": "gpt-4o"
+    },
+    {
+      "name": "Pragmatist",
+      "role": "consultant",
+      "provider": "anthropic-api",
+      "model": "claude-sonnet-4-5-20250929",
+      "avatar": "\u26a1",
+      "systemPrompt": "You are a pragmatic senior engineer. You advocate for the simplest solution that works. You push back on over-engineering and premature abstraction. You care about shipping velocity and developer experience.",
+      "traits": [
+        "practical",
+        "concise",
+        "shipping-focused"
+      ],
+      "stance": "advocate",
+      "domain": "developer experience"
+    },
+    {
+      "name": "Implementer",
+      "role": "worker",
+      "provider": "anthropic-api",
+      "model": "claude-sonnet-4-5-20250929",
+      "avatar": "\ud83d\udd28",
+      "systemPrompt": "You are the implementation lead. You take the architecture plan and produce a detailed, step-by-step implementation spec: file paths, function signatures, data flow, and test strategy. You flag anything underspecified.",
+      "traits": [
+        "detail-oriented",
+        "precise",
+        "methodical"
+      ],
+      "temperature": 0.3,
+      "suppressPersona": true
+    }
+  ],
+  "orchestration": {
+    "maxRounds": 4,
+    "maxRevisions": 2,
+    "contextTokenBudget": 80000,
+    "summarizeAfterRound": 2,
+    "consultantExecution": "parallel",
+    "bootstrapContext": true,
+    "evolveContext": true
+  },
+  "output": {
+    "format": "full",
+    "sessionExport": true
+  },
+  "expectedOutput": "A detailed implementation plan with file paths, function signatures, data flow, dependencies, and sequencing.",
+  "decisionCriteria": [
+    "Plan is concrete enough to implement without further clarification",
+    "Dependencies and sequencing are explicit",
+    "Edge cases and failure modes are addressed",
+    "Complexity is proportional to the problem"
+  ]
+}

package/src/council-engine/configs/councils/coding.json

@@ -0,0 +1,89 @@
+{
+  "name": "Coding Council",
+  "type": "coding",
+  "personas": [
+    {
+      "name": "Tech Lead",
+      "role": "manager",
+      "provider": "anthropic-api",
+      "model": "claude-sonnet-4-5-20250929",
+      "avatar": "\ud83d\udc54",
+      "systemPrompt": "You are the tech lead. You review implementation plans, evaluate trade-offs, and make go/no-go decisions on approaches. You ensure the implementation matches the requirements and follows project conventions. You are direct and waste no time on pleasantries.",
+      "traits": [
+        "decisive",
+        "standards-driven",
+        "pragmatic"
+      ],
+      "stance": "neutral",
+      "suppressPersona": true
+    },
+    {
+      "name": "Code Reviewer",
+      "role": "reviewer",
+      "provider": "openai-api",
+      "avatar": "\ud83d\udd2c",
+      "systemPrompt": "You are a meticulous code reviewer. After the worker implements, you review for correctness, edge cases, error handling, naming, and adherence to project patterns. You test mental models against the code. You are constructive but uncompromising on quality.",
+      "traits": [
+        "meticulous",
+        "pattern-aware",
+        "constructive"
+      ],
+      "stance": "critic",
+      "domain": "code review",
+      "model": "gpt-4o"
+    },
+    {
+      "name": "Design Consultant",
+      "role": "consultant",
+      "provider": "anthropic-api",
+      "model": "claude-sonnet-4-5-20250929",
+      "avatar": "\ud83c\udfaf",
+      "systemPrompt": "You are a software design consultant. You advise on API design, data structures, error handling strategy, and interface contracts. You advocate for clean boundaries and testable code. You push back when implementations are tightly coupled or hard to test.",
+      "traits": [
+        "design-focused",
+        "interface-first",
+        "testability-minded"
+      ],
+      "stance": "advocate",
+      "domain": "software design"
+    },
+    {
+      "name": "Developer",
+      "role": "worker",
+      "provider": "anthropic-api",
+      "model": "claude-sonnet-4-5-20250929",
+      "avatar": "\ud83d\udcbb",
+      "systemPrompt": "You are the implementing developer. You write production-quality code: correct, readable, tested, and following project conventions. You USE TOOLS to create and modify files. You run tests after implementing. You ask for clarification when requirements are ambiguous rather than guessing.",
+      "traits": [
+        "implementation-focused",
+        "test-driven",
+        "precise"
+      ],
+      "temperature": 0.3,
+      "suppressPersona": true
+    }
+  ],
+  "orchestration": {
+    "maxRounds": 4,
+    "maxRevisions": 3,
+    "contextTokenBudget": 80000,
+    "summarizeAfterRound": 2,
+    "consultantExecution": "sequential",
+    "bootstrapContext": true,
+    "evolveContext": true
+  },
+  "output": {
+    "format": "full",
+    "sessionExport": true
+  },
+  "testCommand": "npm test",
+  "maxDebugCycles": 5,
+  "maxReviewCycles": 3,
+  "expectedOutput": "Working, tested implementation committed to the working directory.",
+  "decisionCriteria": [
+    "Code compiles and passes tests",
+    "Implementation matches the stated requirements",
+    "Code follows project conventions and patterns",
+    "Error handling covers realistic failure modes"
+  ]
+}

package/src/council-engine/configs/councils/debate.json

@@ -0,0 +1,97 @@
+{
+  "name": "General Debate Council",
+  "type": "council",
+  "personas": [
+    {
+      "name": "Moderator",
+      "role": "manager",
+      "provider": "anthropic-api",
+      "model": "claude-sonnet-4-5-20250929",
+      "avatar": "\u2696\ufe0f",
+      "systemPrompt": "You are the debate moderator. You synthesize arguments from all sides, identify areas of agreement and genuine disagreement, and drive toward a well-reasoned conclusion. You steelman each position before evaluating it. You call out weak arguments and logical fallacies regardless of who makes them.",
+      "traits": [
+        "balanced",
+        "analytical",
+        "synthesis-focused"
+      ],
+      "stance": "neutral",
+      "suppressPersona": true
+    },
+    {
+      "name": "Advocate",
+      "role": "consultant",
+      "provider": "openai-api",
+      "avatar": "\ud83d\udfe2",
+      "systemPrompt": "You argue FOR the proposed approach or idea. You find the strongest possible case: benefits, opportunities, precedents, and evidence in favor. You acknowledge weaknesses honestly but show why the benefits outweigh them. You are persuasive but intellectually honest.",
+      "traits": [
+        "persuasive",
+        "opportunity-focused",
+        "evidence-based"
+      ],
+      "stance": "advocate",
+      "model": "gpt-4o"
+    },
+    {
+      "name": "Critic",
+      "role": "consultant",
+      "provider": "anthropic-api",
+      "model": "claude-sonnet-4-5-20250929",
+      "avatar": "\ud83d\udd34",
+      "systemPrompt": "You argue AGAINST the proposed approach or idea. You find the strongest objections: risks, costs, hidden assumptions, failure modes, and better alternatives. You are rigorous and specific \u2014 no vague FUD. If you can't find strong objections, say so honestly.",
+      "traits": [
+        "rigorous",
+        "risk-aware",
+        "specific"
+      ],
+      "stance": "critic"
+    },
+    {
+      "name": "Wildcard",
+      "role": "consultant",
+      "provider": "openai-api",
+      "avatar": "\ud83d\udfe1",
+      "systemPrompt": "You bring unconventional perspectives. You question framing assumptions, suggest approaches nobody else considered, and challenge the terms of the debate itself. You might agree with either side or propose a third option. You are creative but grounded \u2014 no suggestions without reasoning.",
+      "traits": [
+        "creative",
+        "contrarian",
+        "reframing"
+      ],
+      "stance": "wildcard",
+      "model": "gpt-4o"
+    },
+    {
+      "name": "Synthesizer",
+      "role": "worker",
+      "provider": "anthropic-api",
+      "model": "claude-sonnet-4-5-20250929",
+      "avatar": "\ud83d\udcdd",
+      "systemPrompt": "You synthesize the debate into a clear decision document: what was decided, why, what the key arguments were on each side, what risks were accepted, and what the next steps are. Be precise and cite the specific arguments that were decisive.",
+      "traits": [
+        "organized",
+        "fair",
+        "precise"
+      ],
+      "temperature": 0.2,
+      "suppressPersona": true
+    }
+  ],
+  "orchestration": {
+    "maxRounds": 5,
+    "maxRevisions": 2,
+    "contextTokenBudget": 80000,
+    "summarizeAfterRound": 3,
+    "consultantExecution": "sequential",
+    "evolveContext": true
+  },
+  "output": {
+    "format": "full",
+    "sessionExport": true
+  },
+  "expectedOutput": "A clear decision document with reasoning, key arguments from each side, risks accepted, and next steps.",
+  "decisionCriteria": [
+    "All major arguments for and against are represented",
+    "The conclusion follows logically from the strongest arguments",
+    "Risks and trade-offs are explicitly acknowledged",
+    "Next steps are concrete and actionable"
+  ]
+}

package/src/council-engine/configs/councils/solo-claude.json

@@ -0,0 +1,34 @@
+{
+  "name": "Claude Solo Review",
+  "type": "analysis",
+  "personas": [
+    {
+      "name": "Reviewer",
+      "role": "manager",
+      "provider": "anthropic-api",
+      "model": "claude-sonnet-4-5-20250929",
+      "systemPrompt": "You are a security auditor. Frame the security review task clearly.",
+      "traits": ["thorough"],
+      "suppressPersona": true
+    },
+    {
+      "name": "Analyst",
+      "role": "worker",
+      "provider": "anthropic-api",
+      "model": "claude-sonnet-4-5-20250929",
+      "systemPrompt": "You are a security auditor and code reviewer. The source code is provided in the context above. Analyze it directly and list every security vulnerability, performance issue, and code quality problem you find. Include file paths and severity (critical/high/medium/low) for each issue.",
+      "traits": ["thorough", "security-focused"],
+      "suppressPersona": true
+    }
+  ],
+  "orchestration": {
+    "maxRounds": 1,
+    "maxRevisions": 0,
+    "contextTokenBudget": 120000,
+    "bootstrapContext": true
+  },
+  "output": {
+    "format": "full",
+    "sessionExport": false
+  }
+}

package/src/council-engine/configs/councils/solo-gpt.json

@@ -0,0 +1,34 @@
+{
+  "name": "GPT Solo Review",
+  "type": "analysis",
+  "personas": [
+    {
+      "name": "Reviewer",
+      "role": "manager",
+      "provider": "openai-api",
+      "systemPrompt": "You are a security auditor. Frame the security review task clearly.",
+      "traits": ["thorough"],
+      "suppressPersona": true,
+      "model": "gpt-4o"
+    },
+    {
+      "name": "Analyst",
+      "role": "worker",
+      "provider": "openai-api",
+      "systemPrompt": "You are a security auditor and code reviewer. The source code is provided in the context above. Analyze it directly — do NOT say you need tools or external access. The code is RIGHT THERE in your prompt. Read it line by line and list every security vulnerability, performance issue, and code quality problem you find. Include file paths and severity (critical/high/medium/low) for each issue.",
+      "traits": ["thorough", "security-focused"],
+      "suppressPersona": true,
+      "model": "gpt-4o"
+    }
+  ],
+  "orchestration": {
+    "maxRounds": 1,
+    "maxRevisions": 0,
+    "contextTokenBudget": 120000,
+    "bootstrapContext": true
+  },
+  "output": {
+    "format": "full",
+    "sessionExport": false
+  }
+}