konsilio 0.3.0

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

@@ -0,0 +1,43 @@
+/**
+ * Persona Service
+ *
+ * Provides persona creation and management.
+ * Designed for dependency injection to enable testing.
+ */
+import type { Logger } from '../logger.js';
+import type { CacheService } from './cache.service.js';
+import type { PromptService } from './prompt.service.js';
+import type { Persona } from '../personas/schemas.js';
+/**
+ * PersonaService - Creates and manages personas
+ */
+export declare class PersonaService {
+    private readonly deps;
+    private readonly expertRules;
+    private readonly workflowRules;
+    private readonly cacheTtlMs;
+    constructor(deps: {
+        promptService: PromptService;
+        cacheService?: CacheService;
+        logger: Logger;
+    });
+    /**
+     * Create multiple expert personas
+     * Used by: CouncilService for expert analysis phase
+     */
+    createExperts(personaIds: string[], model: string): Persona[];
+    /**
+     * Create lead persona for consolidation phase
+     * Used by: CouncilService for extraction, critique, decision, synthesis phases
+     */
+    createLead(phase: 'extraction' | 'critique' | 'decision' | 'synthesis'): Persona;
+    /**
+     * Get available persona IDs from prompts directory
+     * Used by: CLI for listing available personas
+     */
+    getAvailablePersonaIds(): string[];
+    /**
+     * Create a single expert persona
+     */
+    createExpert(personaId: string, model: string): Persona;
+}

package/build/services/persona.service.js

@@ -0,0 +1,93 @@
+/**
+ * Persona Service
+ *
+ * Provides persona creation and management.
+ * Designed for dependency injection to enable testing.
+ */
+import { Expert } from '../personas/expert.js';
+import { Lead } from '../personas/lead.js';
+/**
+ * PersonaService - Creates and manages personas
+ */
+export class PersonaService {
+    deps;
+    expertRules;
+    workflowRules;
+    cacheTtlMs = 300_000; // 5 minutes
+    constructor(deps) {
+        this.deps = deps;
+        // Load rules once at construction (they rarely change)
+        this.expertRules = deps.promptService.loadCoreRules();
+        this.workflowRules = deps.promptService.loadWorkflowRules();
+    }
+    /**
+     * Create multiple expert personas
+     * Used by: CouncilService for expert analysis phase
+     */
+    createExperts(personaIds, model) {
+        return personaIds.map(id => this.createExpert(id, model));
+    }
+    /**
+     * Create lead persona for consolidation phase
+     * Used by: CouncilService for extraction, critique, decision, synthesis phases
+     */
+    createLead(phase) {
+        const cacheKey = `lead:${phase}`;
+        // Check cache
+        const cached = this.deps.cacheService?.get(cacheKey);
+        if (cached) {
+            this.deps.logger.debug('Lead persona loaded from cache', { phase });
+            return cached;
+        }
+        const lead = new Lead({
+            phase,
+            workflowRules: this.workflowRules,
+            promptService: this.deps.promptService,
+        });
+        // Cache the lead
+        this.deps.cacheService?.set(cacheKey, lead, this.cacheTtlMs);
+        return lead;
+    }
+    /**
+     * Get available persona IDs from prompts directory
+     * Used by: CLI for listing available personas
+     */
+    getAvailablePersonaIds() {
+        // These are the persona IDs that have markdown files
+        return [
+            'security',
+            'performance',
+            'ux-dx',
+            'devops',
+            'typescript',
+            'graph-dba',
+            'node-fullstack',
+            'dev-tooling',
+            'distributed-systems',
+            'test-architect',
+        ];
+    }
+    /**
+     * Create a single expert persona
+     */
+    createExpert(personaId, model) {
+        const cacheKey = `expert:${personaId}:${model}`;
+        // Check cache
+        const cached = this.deps.cacheService?.get(cacheKey);
+        if (cached) {
+            this.deps.logger.debug('Expert persona loaded from cache', { personaId });
+            return cached;
+        }
+        const expert = new Expert({
+            personaId,
+            model,
+            expertRules: this.expertRules,
+            workflowRules: this.workflowRules,
+            promptService: this.deps.promptService,
+        });
+        // Cache the expert
+        this.deps.cacheService?.set(cacheKey, expert, this.cacheTtlMs);
+        return expert;
+    }
+}
+//# sourceMappingURL=persona.service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"persona.service.js","sourceRoot":"","sources":["../../src/services/persona.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAE3C;;GAEG;AACH,MAAM,OAAO,cAAc;IAMN;IALF,WAAW,CAAS;IACpB,aAAa,CAAS;IACtB,UAAU,GAAG,OAAO,CAAC,CAAC,YAAY;IAEnD,YACmB,IAIhB;QAJgB,SAAI,GAAJ,IAAI,CAIpB;QAED,uDAAuD;QACvD,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,aAAa,CAAC,aAAa,EAAE,CAAC;QACtD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,iBAAiB,EAAE,CAAC;IAC9D,CAAC;IAED;;;OAGG;IACH,aAAa,CAAC,UAAoB,EAAE,KAAa;QAC/C,OAAO,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED;;;OAGG;IACH,UAAU,CAAC,KAA2D;QACpE,MAAM,QAAQ,GAAG,QAAQ,KAAK,EAAE,CAAC;QAEjC,cAAc;QACd,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,CAAU,QAAQ,CAAC,CAAC;QAC9D,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,gCAAgC,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YACpE,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC;YACpB,KAAK;YACL,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,aAAa;SACvC,CAAC,CAAC;QAEH,iBAAiB;QACjB,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAE7D,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;OAGG;IACH,sBAAsB;QACpB,qDAAqD;QACrD,OAAO;YACL,UAAU;YACV,aAAa;YACb,OAAO;YACP,QAAQ;YACR,YAAY;YACZ,WAAW;YACX,gBAAgB;YAChB,aAAa;YACb,qBAAqB;YACrB,gBAAgB;SACjB,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,SAAiB,EAAE,KAAa;QAC3C,MAAM,QAAQ,GAAG,UAAU,SAAS,IAAI,KAAK,EAAE,CAAC;QAEhD,cAAc;QACd,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,CAAU,QAAQ,CAAC,CAAC;QAC9D,IAAI,MAAM,EAAE,CAAC;YACX,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;YAC1E,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC;YACxB,SAAS;YACT,KAAK;YACL,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,aAAa,EAAE,IAAI,CAAC,aAAa;YACjC,aAAa,EAAE,IAAI,CAAC,IAAI,CAAC,aAAa;SACvC,CAAC,CAAC;QAEH,mBAAmB;QACnB,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;QAE/D,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

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

@@ -0,0 +1,59 @@
+/**
+ * Prompt Service
+ *
+ * Loads prompt content from markdown files.
+ * Designed for dependency injection to enable testing.
+ */
+import type { Logger } from '../logger.js';
+export interface PromptServiceConfig {
+    /** Root directory for prompt files */
+    promptsDir?: string;
+}
+export interface PersonaPromptData {
+    id: string;
+    name: string;
+    emoji: string;
+    focusAreas: string[];
+    domains?: string[];
+    antiPatterns: string[];
+}
+/**
+ * PromptService - Loads prompt content from markdown files
+ */
+export declare class PromptService {
+    private readonly promptsDir;
+    private readonly logger;
+    constructor(config: PromptServiceConfig | undefined, logger: Logger);
+    /**
+     * Load persona prompt data from markdown file
+     */
+    loadPersonaPromptData(personaId: string): PersonaPromptData;
+    /**
+     * Load consolidation phase prompt from markdown file
+     */
+    loadConsolidationPhase(phase: 'extraction' | 'critique' | 'decision' | 'synthesis'): string;
+    /**
+     * Load expert rules from markdown file
+     */
+    loadCoreRules(): string;
+    /**
+     * Load workflow rules from markdown file
+     */
+    loadWorkflowRules(): string;
+    /**
+     * Parse persona prompt data from markdown content
+     */
+    private parsePersonaPromptData;
+    /**
+     * Extract YAML frontmatter from markdown content
+     */
+    private extractYamlFrontmatter;
+    /**
+     * Extract anti-patterns from markdown content
+     */
+    private extractAntiPatterns;
+    /**
+     * Default prompt data when file not found
+     */
+    private getDefaultPersonaPromptData;
+}

package/build/services/prompt.service.js

@@ -0,0 +1,209 @@
+/**
+ * Prompt Service
+ *
+ * Loads prompt content from markdown files.
+ * Designed for dependency injection to enable testing.
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/**
+ * PromptService - Loads prompt content from markdown files
+ */
+export class PromptService {
+    promptsDir;
+    logger;
+    constructor(config, logger) {
+        // Resolve prompts relative to project root (data/prompts/ at runtime)
+        // During development, falls back to src/prompts/ if data/prompts/ doesn't exist
+        const projectRoot = join(__dirname, '..', '..');
+        const dataPrompts = join(projectRoot, 'data', 'prompts');
+        const srcPrompts = join(__dirname, '..', 'prompts');
+        // Prefer data/prompts/ (runtime), fall back to src/prompts/ (development)
+        this.promptsDir = config?.promptsDir ?? (existsSync(dataPrompts) ? dataPrompts : srcPrompts);
+        this.logger = logger;
+    }
+    /**
+     * Load persona prompt data from markdown file
+     */
+    loadPersonaPromptData(personaId) {
+        const filePath = join(this.promptsDir, 'personas', `${personaId}.md`);
+        if (!existsSync(filePath)) {
+            this.logger.warn(`Persona prompt file not found: ${filePath}, using defaults`);
+            return this.getDefaultPersonaPromptData();
+        }
+        try {
+            const content = readFileSync(filePath, 'utf-8');
+            return this.parsePersonaPromptData(content);
+        }
+        catch (err) {
+            this.logger.error(`Failed to load persona prompt: ${personaId}`, {
+                error: err instanceof Error ? err.message : String(err),
+            });
+            return this.getDefaultPersonaPromptData();
+        }
+    }
+    /**
+     * Load consolidation phase prompt from markdown file
+     */
+    loadConsolidationPhase(phase) {
+        const filePath = join(this.promptsDir, 'consolidation', `${phase}.md`);
+        if (!existsSync(filePath)) {
+            this.logger.warn(`Consolidation phase file not found: ${filePath}`);
+            return '';
+        }
+        try {
+            return readFileSync(filePath, 'utf-8');
+        }
+        catch (err) {
+            this.logger.error(`Failed to load consolidation phase: ${phase}`, {
+                error: err instanceof Error ? err.message : String(err),
+            });
+            return '';
+        }
+    }
+    /**
+     * Load expert rules from markdown file
+     */
+    loadCoreRules() {
+        const filePath = join(this.promptsDir, 'expert-rules.md');
+        if (!existsSync(filePath)) {
+            this.logger.warn(`Expert rules file not found: ${filePath}`);
+            return '';
+        }
+        try {
+            return readFileSync(filePath, 'utf-8');
+        }
+        catch (err) {
+            this.logger.error('Failed to load expert rules', {
+                error: err instanceof Error ? err.message : String(err),
+            });
+            return '';
+        }
+    }
+    /**
+     * Load workflow rules from markdown file
+     */
+    loadWorkflowRules() {
+        const filePath = join(this.promptsDir, 'workflow-rules.md');
+        if (!existsSync(filePath)) {
+            this.logger.warn(`Workflow rules file not found: ${filePath}`);
+            return '';
+        }
+        try {
+            return readFileSync(filePath, 'utf-8');
+        }
+        catch (err) {
+            this.logger.error('Failed to load workflow rules', {
+                error: err instanceof Error ? err.message : String(err),
+            });
+            return '';
+        }
+    }
+    /**
+     * Parse persona prompt data from markdown content
+     */
+    parsePersonaPromptData(content) {
+        const metadata = this.extractYamlFrontmatter(content);
+        const antiPatterns = this.extractAntiPatterns(content);
+        return {
+            id: metadata.id,
+            name: metadata.name,
+            emoji: metadata.emoji,
+            focusAreas: metadata.focusAreas,
+            domains: metadata.domains,
+            antiPatterns,
+        };
+    }
+    /**
+     * Extract YAML frontmatter from markdown content
+     */
+    extractYamlFrontmatter(content) {
+        const match = content.match(/^---\r?\n([\s\S]*?)\r?\n---\r?\n/);
+        if (!match) {
+            this.logger.warn('No YAML frontmatter found in persona markdown file');
+            return { id: '', name: '', emoji: '', focusAreas: [] };
+        }
+        const yaml = match[1];
+        const result = {
+            id: '',
+            name: '',
+            emoji: '',
+            focusAreas: [],
+            domains: undefined,
+        };
+        // Simple YAML parsing for our specific format
+        const lines = yaml.split(/\r?\n/);
+        let currentKey = '';
+        let currentArray = [];
+        for (const line of lines) {
+            const trimmed = line.trim();
+            // Skip empty lines
+            if (!trimmed)
+                continue;
+            // Check if it's an array item
+            if (trimmed.startsWith('- ')) {
+                currentArray.push(trimmed.slice(2).trim());
+                continue;
+            }
+            // If we were building an array, save it and reset
+            if (currentKey && currentArray.length > 0) {
+                result[currentKey] = [...currentArray];
+                currentKey = '';
+                currentArray = [];
+            }
+            // Parse key: value
+            const colonIndex = trimmed.indexOf(':');
+            if (colonIndex > 0) {
+                const key = trimmed.slice(0, colonIndex).trim();
+                let value = trimmed.slice(colonIndex + 1).trim();
+                // Remove quotes if present
+                if ((value.startsWith('"') && value.endsWith('"')) ||
+                    (value.startsWith("'") && value.endsWith("'"))) {
+                    value = value.slice(1, -1);
+                }
+                if (value) {
+                    result[key] = value;
+                }
+                else {
+                    // Empty value means this is an array key
+                    currentKey = key;
+                    currentArray = [];
+                }
+            }
+        }
+        // Save any remaining array
+        if (currentKey && currentArray.length > 0) {
+            result[currentKey] = [...currentArray];
+        }
+        return result;
+    }
+    /**
+     * Extract anti-patterns from markdown content
+     */
+    extractAntiPatterns(content) {
+        // Find the Anti-Patterns section and extract list items
+        const match = content.match(/## Anti-Patterns\r?\n\r?\n([\s\S]*?)(?=\r?\n## |$)/);
+        if (!match)
+            return [];
+        return match[1]
+            .split(/\r?\n/)
+            .filter(line => line.startsWith('- '))
+            .map(line => line.slice(2).trim());
+    }
+    /**
+     * Default prompt data when file not found
+     */
+    getDefaultPersonaPromptData() {
+        return {
+            id: 'unknown',
+            name: 'Unknown Persona',
+            emoji: '?',
+            focusAreas: [],
+            domains: [],
+            antiPatterns: [],
+        };
+    }
+}
+//# sourceMappingURL=prompt.service.js.map

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

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

package/konsilio.schema.json

@@ -0,0 +1,140 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Konsilio Configuration",
+  "description": "Configuration file for the Konsilio Council of Experts MCP server",
+  "type": "object",
+  "properties": {
+    "$schema": {
+      "type": "string",
+      "description": "Path to this JSON schema file for IDE validation"
+    },
+    "personas": {
+      "type": "object",
+      "description": "Persona configuration for expert analysis",
+      "properties": {
+        "enabled": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "description": "Persona ID (e.g., security, performance, ux-dx, devops, or custom personas)"
+          },
+          "minItems": 2,
+          "description": "Expert personas to include in council consultations. Must have at least 2. Built-in personas: security, performance, ux-dx, devops, typescript, graph-dba, node-fullstack, dev-tooling, distributed-systems, test-architect"
+        }
+      },
+      "required": ["enabled"],
+      "additionalProperties": false
+    },
+    "constitution": {
+      "type": "string",
+      "description": "Path to optional constitution file with custom workflow rules"
+    },
+    "models": {
+      "type": "object",
+      "description": "Default model configuration for all personas",
+      "properties": {
+        "experts": {
+          "type": "string",
+          "description": "Default model for expert personas. Override per-persona with personaModels."
+        },
+        "lead": {
+          "type": "string",
+          "description": "Model for consolidation phases (extraction, critique, decision, synthesis)"
+        },
+        "formatter": {
+          "type": "string",
+          "description": "Model used to format prose into structured JSON"
+        }
+      },
+      "additionalProperties": false
+    },
+    "personaModels": {
+      "type": "object",
+      "description": "Per-persona model defaults. Maps personaId to model ID. Overrides models.experts for specific personas.",
+      "additionalProperties": {
+        "type": "string",
+        "description": "OpenRouter model ID for this persona"
+      },
+      "examples": [
+        {
+          "security": "openai/gpt-4o",
+          "performance": "anthropic/claude-sonnet-4"
+        }
+      ]
+    },
+    "timeouts": {
+      "type": "object",
+      "description": "Timeout configuration for API calls",
+      "properties": {
+        "expertMs": {
+          "type": "integer",
+          "minimum": 10000,
+          "description": "Timeout for expert analysis in milliseconds"
+        },
+        "leadMs": {
+          "type": "integer",
+          "minimum": 30000,
+          "description": "Timeout for consolidation phases in milliseconds"
+        },
+        "formatterMs": {
+          "type": "integer",
+          "minimum": 10000,
+          "description": "Timeout for formatting prose in milliseconds"
+        }
+      },
+      "additionalProperties": false
+    },
+    "maxTokens": {
+      "type": "object",
+      "description": "Token limits for API calls",
+      "properties": {
+        "experts": {
+          "type": "integer",
+          "minimum": 100,
+          "description": "Max tokens per expert analysis"
+        },
+        "lead": {
+          "type": "integer",
+          "minimum": 100,
+          "description": "Max tokens for consolidation phases"
+        }
+      },
+      "additionalProperties": false
+    },
+    "maxDraftPlanLength": {
+      "type": "integer",
+      "minimum": 1000,
+      "description": "Maximum length of draft plan input in characters"
+    },
+    "maxHistorySessions": {
+      "type": "integer",
+      "minimum": 1,
+      "maximum": 100,
+      "description": "Maximum number of session history entries to retain"
+    },
+    "databasePath": {
+      "type": "string",
+      "description": "Path to SQLite database file for session storage"
+    },
+    "cacheTtlSeconds": {
+      "type": "integer",
+      "minimum": 60,
+      "description": "Cache time-to-live in seconds for persona data"
+    },
+    "formatter": {
+      "type": "object",
+      "description": "Formatter service configuration",
+      "properties": {
+        "maxRetries": {
+          "type": "integer",
+          "minimum": 0,
+          "maximum": 10,
+          "description": "Maximum retries for formatting failures"
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "required": ["personas"],
+  "additionalProperties": false
+}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "konsilio",
+  "version": "0.3.0",
+  "description": "Konsilio MCP server runs draft plans through a multi-persona architectural review.",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "code-review",
+    "architecture",
+    "ai",
+    "multi-agent",
+    "expert-system",
+    "planning",
+    "consulting",
+    "blueprint"
+  ],
+  "homepage": "https://github.com/edzillion/konsilio#readme",
+  "bugs": {
+    "url": "https://github.com/edzillion/konsilio/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/edzillion/konsilio.git"
+  },
+  "license": "Unlicense",
+  "author": "edzillion",
+  "type": "module",
+  "exports": {
+    ".": "./build/index.js",
+    "./schema": "./konsilio.schema.json"
+  },
+  "main": "build/index.js",
+  "types": "./build/index.d.ts",
+  "bin": {
+    "konsilio": "build/index.js"
+  },
+  "files": [
+    "build/",
+    "konsilio.schema.json"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && node scripts/copy-assets.mjs",
+    "dev": "tsc --watch",
+    "start": "node build/index.js",
+    "start:server": "node build/server.js",
+    "inspect": "npx @modelcontextprotocol/inspector node /g/dev/konsilio/build/index.js",
+    "typecheck": "tsc --noEmit",
+    "history": "node build/cli/history.js",
+    "test": "vitest run --reporter=verbose",
+    "test-agent": "vitest run --reporter=json | jq \".testResults[] | {name, status, errors}\"",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.28.0",
+    "pino": "^10.3.1",
+    "sql.js": "^1.14.1",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/inspector": "^0.21.1",
+    "@types/node": "^25.5.0",
+    "@types/sql.js": "^1.4.11",
+    "@vitest/coverage-v8": "^4.1.2",
+    "typescript": "^6.0.2",
+    "vitest": "^4.1.2"
+  }
+}