konsilio 0.3.0

package/build/server.d.ts

@@ -0,0 +1,24 @@
+#!/usr/bin/env node
+/**
+ * HTTP Server with Dependency Injection
+ *
+ * Provides:
+ * - /health - Health check for SQLite and OpenRouter connectivity
+ * - /analyze - Council analysis endpoint
+ *
+ * Uses correlation IDs for request tracing and structured JSON logging.
+ */
+import { IncomingMessage, ServerResponse } from 'node:http';
+import { Logger } from './logger.js';
+import { type AppServices } from './container.js';
+export interface ComponentHealth {
+    status: 'healthy' | 'unhealthy';
+    latencyMs: number;
+    error?: string;
+}
+export interface HealthCheckResult {
+    database: ComponentHealth;
+    openrouter: ComponentHealth;
+}
+export declare function createHttpServer(services: AppServices, logger: Logger): import("node:http").Server<typeof IncomingMessage, typeof ServerResponse>;
+export declare function main(): Promise<void>;

package/build/server.js

@@ -0,0 +1,181 @@
+#!/usr/bin/env node
+/**
+ * HTTP Server with Dependency Injection
+ *
+ * Provides:
+ * - /health - Health check for SQLite and OpenRouter connectivity
+ * - /analyze - Council analysis endpoint
+ *
+ * Uses correlation IDs for request tracing and structured JSON logging.
+ */
+// ─── Load .env for local development ─────────────────────────────────────────
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const envPath = resolve(__dirname, '..', '.env');
+if (existsSync(envPath)) {
+    const content = readFileSync(envPath, 'utf-8');
+    for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        const eqIdx = trimmed.indexOf('=');
+        if (eqIdx === -1)
+            continue;
+        const key = trimmed.slice(0, eqIdx).trim();
+        let value = trimmed.slice(eqIdx + 1).trim();
+        if ((value.startsWith('"') && value.endsWith('"')) || (value.startsWith("'") && value.endsWith("'"))) {
+            value = value.slice(1, -1);
+        }
+        if (!process.env[key])
+            process.env[key] = value;
+    }
+}
+import { createServer } from 'node:http';
+import { randomUUID } from 'node:crypto';
+import { createLogger } from './logger.js';
+import { getServices } from './container.js';
+import { config, validateConfig } from './config.js';
+// ─── HTTP Server ───
+export function createHttpServer(services, logger) {
+    const server = createServer(async (req, res) => {
+        const correlationId = randomUUID();
+        const log = logger.withCorrelationId(correlationId);
+        log.info('Request received', { method: req.method, url: req.url });
+        // Set default headers
+        res.setHeader('Content-Type', 'application/json');
+        res.setHeader('X-Correlation-Id', correlationId);
+        const url = req.url?.split('?')[0] ?? '/';
+        try {
+            if (url === '/health' && req.method === 'GET') {
+                await handleHealth(req, res, services, log);
+            }
+            else if (url === '/analyze' && req.method === 'POST') {
+                await handleAnalyze(req, res, services, log);
+            }
+            else {
+                res.statusCode = 404;
+                res.end(JSON.stringify({ error: 'Not Found', correlationId }));
+            }
+        }
+        catch (err) {
+            log.error('Request failed', { error: err instanceof Error ? err.message : String(err) });
+            res.statusCode = 500;
+            res.end(JSON.stringify({ error: 'Internal Server Error', correlationId }));
+        }
+    });
+    return server;
+}
+// ─── Route Handlers ───
+async function handleHealth(_req, res, services, log) {
+    log.debug('Health check started');
+    const [dbHealth, orHealth] = await Promise.all([
+        Promise.resolve(services.databaseService.checkHealth()),
+        services.openRouterService.checkHealth(),
+    ]);
+    const allHealthy = dbHealth.status === 'healthy' && orHealth.status === 'healthy';
+    const result = {
+        database: dbHealth,
+        openrouter: orHealth,
+    };
+    if (allHealthy) {
+        res.statusCode = 200;
+        log.info('Health check passed', { database: result.database.status, openrouter: result.openrouter.status });
+    }
+    else {
+        res.statusCode = 503;
+        log.warn('Health check failed', { database: result.database.status, openrouter: result.openrouter.status });
+    }
+    res.end(JSON.stringify({
+        status: allHealthy ? 'healthy' : 'unhealthy',
+        checks: result,
+    }, null, 2));
+}
+async function handleAnalyze(req, res, services, log) {
+    const body = await readBody(req);
+    let parsed;
+    try {
+        parsed = JSON.parse(body);
+    }
+    catch {
+        res.statusCode = 400;
+        res.end(JSON.stringify({ error: 'Invalid JSON body' }));
+        return;
+    }
+    if (!parsed.draft_plan?.trim()) {
+        res.statusCode = 400;
+        res.end(JSON.stringify({ error: 'draft_plan is required and cannot be empty' }));
+        return;
+    }
+    try {
+        const result = await services.councilService.run({
+            draftPlan: parsed.draft_plan,
+            techStack: parsed.tech_stack,
+            contextConstraints: parsed.context_constraints,
+        });
+        res.statusCode = 200;
+        res.end(JSON.stringify({
+            session_id: result.sessionId,
+            expert_reports: result.expertReports.map(r => ({
+                persona_id: r.personaId,
+                persona_name: r.personaName,
+                persona_emoji: r.personaEmoji,
+                structured_output: r.structuredOutput,
+                duration_ms: r.durationMs,
+                model_used: r.modelUsed,
+            })),
+            extraction_output: result.extractionOutput,
+            critique_output: result.critiqueOutput,
+            decision_output: result.decisionOutput,
+            synthesis_output: result.synthesisOutput,
+            final_blueprint: result.finalBlueprint,
+            consolidation_model: result.consolidationModel,
+            total_duration_ms: result.totalDurationMs,
+        }, null, 2));
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : 'Unknown error';
+        log.error('Analysis failed', { error: message });
+        res.statusCode = 500;
+        res.end(JSON.stringify({ error: message }));
+    }
+}
+function readBody(req) {
+    return new Promise((resolve, reject) => {
+        let body = '';
+        req.on('data', chunk => { body += chunk; });
+        req.on('end', () => resolve(body));
+        req.on('error', reject);
+    });
+}
+// ─── Main Entry Point ───
+export async function main() {
+    // Validate configuration
+    validateConfig();
+    // Create logger
+    const logger = createLogger(config.logLevel);
+    // Get services from container (async due to WASM loading)
+    const services = await getServices();
+    // Create HTTP server
+    const server = createHttpServer(services, logger);
+    server.listen(config.port, () => {
+        logger.info('Server started', { port: config.port, nodeEnv: config.nodeEnv });
+    });
+    // Graceful shutdown
+    process.on('SIGINT', () => {
+        logger.info('Shutting down (SIGINT)');
+        services.databaseService.close();
+        process.exit(0);
+    });
+    process.on('SIGTERM', () => {
+        logger.info('Shutting down (SIGTERM)');
+        services.databaseService.close();
+        process.exit(0);
+    });
+}
+// Run if executed directly
+if (import.meta.url === `file://${process.argv[1]}`) {
+    main();
+}
+//# sourceMappingURL=server.js.map

package/build/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/build/services/cache.service.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Cache Service
+ *
+ * Simple in-memory cache with TTL support.
+ * Designed for dependency injection to enable testing.
+ */
+export interface CacheEntry<T> {
+    value: T;
+    expiresAt: number;
+}
+/**
+ * CacheService - In-memory TTL cache
+ */
+export declare class CacheService {
+    private cache;
+    private readonly defaultTtlMs;
+    constructor(defaultTtlMs?: number);
+    /**
+     * Get a value from cache if it exists and hasn't expired
+     */
+    get<T>(key: string): T | undefined;
+    /**
+     * Set a value in cache with optional TTL
+     */
+    set<T>(key: string, value: T, ttlMs?: number): void;
+    /**
+     * Delete a value from cache
+     */
+    delete(key: string): boolean;
+    /**
+     * Check if a key exists and hasn't expired
+     */
+    has(key: string): boolean;
+    /**
+     * Clear all expired entries
+     */
+    prune(): number;
+    /**
+     * Clear all entries
+     */
+    clear(): void;
+    /**
+     * Get cache statistics
+     */
+    stats(): {
+        size: number;
+        keys: string[];
+    };
+}

package/build/services/cache.service.js

@@ -0,0 +1,85 @@
+/**
+ * Cache Service
+ *
+ * Simple in-memory cache with TTL support.
+ * Designed for dependency injection to enable testing.
+ */
+/**
+ * CacheService - In-memory TTL cache
+ */
+export class CacheService {
+    cache = new Map();
+    defaultTtlMs;
+    constructor(defaultTtlMs = 60_000) {
+        this.defaultTtlMs = defaultTtlMs;
+    }
+    /**
+     * Get a value from cache if it exists and hasn't expired
+     */
+    get(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return undefined;
+        if (Date.now() > entry.expiresAt) {
+            this.cache.delete(key);
+            return undefined;
+        }
+        return entry.value;
+    }
+    /**
+     * Set a value in cache with optional TTL
+     */
+    set(key, value, ttlMs) {
+        const expiresAt = Date.now() + (ttlMs ?? this.defaultTtlMs);
+        this.cache.set(key, { value, expiresAt });
+    }
+    /**
+     * Delete a value from cache
+     */
+    delete(key) {
+        return this.cache.delete(key);
+    }
+    /**
+     * Check if a key exists and hasn't expired
+     */
+    has(key) {
+        const entry = this.cache.get(key);
+        if (!entry)
+            return false;
+        if (Date.now() > entry.expiresAt) {
+            this.cache.delete(key);
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Clear all expired entries
+     */
+    prune() {
+        const now = Date.now();
+        let pruned = 0;
+        for (const [key, entry] of this.cache.entries()) {
+            if (now > entry.expiresAt) {
+                this.cache.delete(key);
+                pruned++;
+            }
+        }
+        return pruned;
+    }
+    /**
+     * Clear all entries
+     */
+    clear() {
+        this.cache.clear();
+    }
+    /**
+     * Get cache statistics
+     */
+    stats() {
+        return {
+            size: this.cache.size,
+            keys: Array.from(this.cache.keys()),
+        };
+    }
+}
+//# sourceMappingURL=cache.service.js.map

package/build/services/cache.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.service.js","sourceRoot":"","sources":["../../src/services/cache.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAOH;;GAEG;AACH,MAAM,OAAO,YAAY;IACf,KAAK,GAAqC,IAAI,GAAG,EAAE,CAAC;IAC3C,YAAY,CAAS;IAEtC,YAAY,eAAuB,MAAM;QACvC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,GAAG,CAAI,GAAW;QAChB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAE7B,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO,SAAS,CAAC;QACnB,CAAC;QAED,OAAO,KAAK,CAAC,KAAU,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,GAAG,CAAI,GAAW,EAAE,KAAQ,EAAE,KAAc;QAC1C,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC;QAC5D,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;IAC5C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,GAAW;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,GAAW;QACb,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QAEzB,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACvB,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,MAAM,GAAG,CAAC,CAAC;QAEf,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,EAAE,CAAC;YAChD,IAAI,GAAG,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;gBAC1B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACvB,MAAM,EAAE,CAAC;YACX,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED;;OAEG;IACH,KAAK;QACH,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI;YACrB,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;SACpC,CAAC;IACJ,CAAC;CACF"}

package/build/services/council.service.d.ts

@@ -0,0 +1,111 @@
+/**
+ * Council Service - Two-Stage Consulting Pipeline
+ *
+ * Stage 1: Expert Analysis (parallel, prose output)
+ * Stage 2: Formatting (convert prose to structured JSON via FormatterService)
+ * Stage 3: Extraction (extract claims from expert reports)
+ * Stage 4: Critique (identify contradictions and weaknesses)
+ * Stage 5: Decision (accept/reject findings)
+ * Stage 6: Synthesis (assemble final blueprint)
+ */
+import type { Logger } from '../logger.js';
+import type { CouncilResult } from '../personas/schemas.js';
+import type { OpenRouterService } from './openrouter.service.js';
+import type { DatabaseService } from './database.service.js';
+import type { CacheService } from './cache.service.js';
+import type { PromptService } from './prompt.service.js';
+import type { PersonaService } from './persona.service.js';
+import type { FormatterService } from './formatter.service.js';
+export interface CouncilConfig {
+    enabledPersonaIds: string[];
+    models: {
+        experts: string;
+        lead: string;
+        formatter: string;
+    };
+    personaModels: Record<string, string>;
+    timeouts: {
+        expertMs: number;
+        leadMs: number;
+        formatterMs: number;
+    };
+    maxTokens: {
+        experts: number;
+        lead: number;
+    };
+    maxDraftPlanLength: number;
+    formatterMaxRetries: number;
+}
+export interface CouncilParams {
+    draftPlan: string;
+    techStack?: string;
+    contextConstraints?: string;
+}
+export interface CouncilOptions {
+    personaOverride?: string[];
+    personaModelsOverride?: Record<string, string>;
+    consolidationModelOverride?: string;
+    maxTokensOverride?: {
+        experts?: number;
+        lead?: number;
+    };
+}
+/**
+ * CouncilService - Orchestrates two-stage expert analysis and consolidation
+ */
+export declare class CouncilService {
+    private readonly deps;
+    constructor(deps: {
+        logger: Logger;
+        openRouterService: OpenRouterService;
+        databaseService: DatabaseService;
+        cacheService: CacheService;
+        promptService: PromptService;
+        personaService: PersonaService;
+        formatterService: FormatterService;
+        config: CouncilConfig;
+    });
+    /**
+     * Resolve the model for a specific persona using 3-tier resolution:
+     * 1. Per-run override (personaModelsOverride)
+     * 2. Persona-level default (config.personaModels)
+     * 3. Global default (config.models.experts)
+     */
+    private resolvePersonaModel;
+    /**
+     * Resolve the effective token limit for a role
+     */
+    private resolveMaxTokens;
+    /**
+     * Run a council analysis with two-stage consolidation
+     */
+    run(params: CouncilParams, options?: CouncilOptions, correlationId?: string): Promise<CouncilResult>;
+    /**
+     * Call an expert persona for prose analysis
+     */
+    private callExpert;
+    /**
+     * Stage 3: Extraction - Extract structured claims from expert reports
+     */
+    private runExtractionPhase;
+    /**
+     * Stage 4: Critique - Analyze for contradictions and weaknesses
+     */
+    private runCritiquePhase;
+    /**
+     * Stage 5: Decision - Accept/reject findings explicitly
+     */
+    private runDecisionPhase;
+    /**
+     * Stage 6: Synthesis - Assemble final blueprint from accepted findings
+     */
+    private runSynthesisPhase;
+    /**
+     * Build user message for expert analysis
+     */
+    private buildUserMessage;
+    /**
+     * Clean JSON output from LLM responses (strip markdown code fences)
+     */
+    private cleanJsonOutput;
+}