cognitive-core 0.0.2 → 0.1.0

package/dist/mcp/playbook-server.js

@@ -0,0 +1,427 @@
+/**
+ * MCP Playbook Server
+ * Exposes playbook retrieval via Model Context Protocol
+ *
+ * @deprecated This module is deprecated in favor of the CLI interface and SKILL.md approach.
+ * See /SKILL.md for instructions on how agents should interact with cognitive-core.
+ * Use the CLI at bin/cognitive-core instead of this MCP server.
+ *
+ * This server provides on-demand access to the full playbook library,
+ * allowing agents to search for specific guidance beyond what's in their
+ * system prompt.
+ */
+import { validateMCPArgs, MCPSearchPlaybooksSchema, MCPGetPlaybookDetailsSchema, MCPGetPlaybooksByDomainSchema, } from '../utils/validation.js';
+/**
+ * Default configuration
+ */
+const DEFAULT_CONFIG = {
+    enabled: true,
+    exposeResources: true,
+    exposeTools: true,
+    maxResults: 5,
+    minConfidence: 0.3,
+    includeRefinements: true,
+    enableDomainFiltering: true,
+};
+/**
+ * MCP Playbook Server
+ * Provides playbook search tools for agents
+ */
+export class PlaybookMCPServer {
+    playbooks;
+    config;
+    constructor(playbooks, _skillLibrary, config) {
+        this.playbooks = playbooks;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Get available MCP tools
+     */
+    getTools() {
+        return [
+            {
+                name: 'search_playbooks',
+                description: 'Search for playbooks that provide guidance for solving a problem. ' +
+                    'Returns strategies, tactics, and success indicators for matching playbooks.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        query: {
+                            type: 'string',
+                            description: 'Description of the problem or task to find playbooks for',
+                        },
+                        domain: {
+                            type: 'string',
+                            description: 'Optional domain to filter results (e.g., "code", "testing", "refactoring")',
+                        },
+                        maxResults: {
+                            type: 'number',
+                            description: 'Maximum number of playbooks to return (default: 5)',
+                        },
+                    },
+                    required: ['query'],
+                },
+            },
+            {
+                name: 'get_playbook_details',
+                description: 'Get detailed information about a specific playbook by ID, ' +
+                    'including full tactics, steps, refinements, and usage statistics.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        playbookId: {
+                            type: 'string',
+                            description: 'The ID of the playbook to retrieve',
+                        },
+                    },
+                    required: ['playbookId'],
+                },
+            },
+            {
+                name: 'list_domains',
+                description: 'List all domains that have playbooks available.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {},
+                },
+            },
+            {
+                name: 'get_playbooks_by_domain',
+                description: 'Get all playbooks for a specific domain.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        domain: {
+                            type: 'string',
+                            description: 'The domain to get playbooks for',
+                        },
+                        maxResults: {
+                            type: 'number',
+                            description: 'Maximum number of playbooks to return (default: 10)',
+                        },
+                    },
+                    required: ['domain'],
+                },
+            },
+        ];
+    }
+    /**
+     * Handle an MCP tool call
+     */
+    async handleToolCall(call) {
+        try {
+            switch (call.name) {
+                case 'search_playbooks':
+                    return await this.handleSearchPlaybooks(call.arguments);
+                case 'get_playbook_details':
+                    return await this.handleGetPlaybookDetails(call.arguments);
+                case 'list_domains':
+                    return await this.handleListDomains();
+                case 'get_playbooks_by_domain':
+                    return await this.handleGetPlaybooksByDomain(call.arguments);
+                default:
+                    return {
+                        content: [{ type: 'text', text: `Unknown tool: ${call.name}` }],
+                        isError: true,
+                    };
+            }
+        }
+        catch (error) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${error instanceof Error ? error.message : String(error)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    /**
+     * Handle search_playbooks tool call
+     */
+    async handleSearchPlaybooks(args) {
+        // Validate arguments
+        const validated = validateMCPArgs(MCPSearchPlaybooksSchema, args, 'search_playbooks');
+        const { query, domain } = validated;
+        const maxResults = validated.maxResults ?? this.config.maxResults;
+        const matches = await this.playbooks.findMatching(query, {
+            k: maxResults,
+            domains: domain ? [domain] : undefined,
+            minConfidence: this.config.minConfidence,
+            excludeAntiPatterns: true,
+        });
+        if (matches.length === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'No playbooks found matching your query. Try a different description or broader search terms.',
+                    },
+                ],
+            };
+        }
+        const results = matches.map((m) => this.formatPlaybookForSearch(m));
+        const formattedResults = results
+            .map((r) => this.formatSearchResultAsText(r))
+            .join('\n\n---\n\n');
+        return {
+            content: [{ type: 'text', text: formattedResults }],
+        };
+    }
+    /**
+     * Handle get_playbook_details tool call
+     */
+    async handleGetPlaybookDetails(args) {
+        // Validate arguments
+        const validated = validateMCPArgs(MCPGetPlaybookDetailsSchema, args, 'get_playbook_details');
+        const playbook = await this.playbooks.get(validated.playbookId);
+        if (!playbook) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Playbook not found: ${validated.playbookId}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const details = this.formatPlaybookDetails(playbook);
+        return {
+            content: [{ type: 'text', text: details }],
+        };
+    }
+    /**
+     * Handle list_domains tool call
+     */
+    async handleListDomains() {
+        const allPlaybooks = await this.playbooks.getAll();
+        const domains = new Set();
+        for (const playbook of allPlaybooks) {
+            for (const domain of playbook.applicability.domains) {
+                domains.add(domain);
+            }
+        }
+        const domainList = Array.from(domains).sort();
+        if (domainList.length === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: 'No domains found. Playbooks may not have domain assignments yet.',
+                    },
+                ],
+            };
+        }
+        const text = `Available domains:\n${domainList.map((d) => `  - ${d}`).join('\n')}`;
+        return {
+            content: [{ type: 'text', text }],
+        };
+    }
+    /**
+     * Handle get_playbooks_by_domain tool call
+     */
+    async handleGetPlaybooksByDomain(args) {
+        // Validate arguments
+        const validated = validateMCPArgs(MCPGetPlaybooksByDomainSchema, args, 'get_playbooks_by_domain');
+        const { domain } = validated;
+        const maxResults = validated.maxResults ?? 10;
+        const allPlaybooks = await this.playbooks.getAll();
+        const domainPlaybooks = allPlaybooks
+            .filter((p) => p.applicability.domains.includes(domain))
+            .sort((a, b) => b.confidence - a.confidence)
+            .slice(0, maxResults);
+        if (domainPlaybooks.length === 0) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `No playbooks found for domain: ${domain}`,
+                    },
+                ],
+            };
+        }
+        const formatted = domainPlaybooks
+            .map((p) => this.formatPlaybookSummary(p))
+            .join('\n\n');
+        return {
+            content: [{ type: 'text', text: formatted }],
+        };
+    }
+    /**
+     * Format playbook match for search results
+     */
+    formatPlaybookForSearch(match) {
+        const { playbook, score, matchType } = match;
+        const { successCount, failureCount } = playbook.evolution;
+        const totalUses = successCount + failureCount;
+        return {
+            id: playbook.id,
+            name: playbook.name,
+            confidence: playbook.confidence,
+            matchScore: score,
+            matchType,
+            strategy: playbook.guidance.strategy,
+            tactics: playbook.guidance.tactics,
+            successRate: totalUses > 0 ? successCount / totalUses : 0,
+            domains: playbook.applicability.domains,
+        };
+    }
+    /**
+     * Format search result as text
+     */
+    formatSearchResultAsText(result) {
+        const lines = [];
+        lines.push(`## ${result.name}`);
+        lines.push(`ID: ${result.id}`);
+        lines.push(`Match: ${Math.round(result.matchScore * 100)}% (${result.matchType})`);
+        lines.push(`Confidence: ${Math.round(result.confidence * 100)}%`);
+        lines.push(`Success Rate: ${Math.round(result.successRate * 100)}%`);
+        if (result.domains.length > 0) {
+            lines.push(`Domains: ${result.domains.join(', ')}`);
+        }
+        lines.push('');
+        lines.push(`**Strategy**: ${result.strategy}`);
+        if (result.tactics.length > 0) {
+            lines.push('**Tactics**:');
+            for (const tactic of result.tactics.slice(0, 5)) {
+                lines.push(`  - ${tactic}`);
+            }
+            if (result.tactics.length > 5) {
+                lines.push(`  ... and ${result.tactics.length - 5} more`);
+            }
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Format playbook summary
+     */
+    formatPlaybookSummary(playbook) {
+        const lines = [];
+        const { successCount, failureCount } = playbook.evolution;
+        const totalUses = successCount + failureCount;
+        const successRate = totalUses > 0 ? successCount / totalUses : 0;
+        lines.push(`## ${playbook.name}`);
+        lines.push(`ID: ${playbook.id}`);
+        lines.push(`Confidence: ${Math.round(playbook.confidence * 100)}%`);
+        lines.push(`Uses: ${totalUses} (${Math.round(successRate * 100)}% success)`);
+        lines.push('');
+        lines.push(`**Strategy**: ${playbook.guidance.strategy}`);
+        return lines.join('\n');
+    }
+    /**
+     * Format full playbook details
+     */
+    formatPlaybookDetails(playbook) {
+        const lines = [];
+        const { successCount, failureCount } = playbook.evolution;
+        const totalUses = successCount + failureCount;
+        const successRate = totalUses > 0 ? successCount / totalUses : 0;
+        lines.push(`# ${playbook.name}`);
+        lines.push(`ID: ${playbook.id}`);
+        lines.push(`Version: ${playbook.evolution.version}`);
+        lines.push(`Confidence: ${Math.round(playbook.confidence * 100)}%`);
+        lines.push(`Complexity: ${playbook.complexity}`);
+        lines.push(`Estimated Effort: ${playbook.estimatedEffort} steps`);
+        lines.push('');
+        // Applicability
+        lines.push('## Applicability');
+        if (playbook.applicability.situations.length > 0) {
+            lines.push('**When to use**:');
+            for (const sit of playbook.applicability.situations) {
+                lines.push(`  - ${sit}`);
+            }
+        }
+        if (playbook.applicability.triggers.length > 0) {
+            lines.push('**Triggers**:');
+            for (const trigger of playbook.applicability.triggers) {
+                lines.push(`  - ${trigger}`);
+            }
+        }
+        if (playbook.applicability.antiPatterns.length > 0) {
+            lines.push('**Avoid when**:');
+            for (const anti of playbook.applicability.antiPatterns) {
+                lines.push(`  - ${anti}`);
+            }
+        }
+        if (playbook.applicability.domains.length > 0) {
+            lines.push(`**Domains**: ${playbook.applicability.domains.join(', ')}`);
+        }
+        lines.push('');
+        // Guidance
+        lines.push('## Guidance');
+        lines.push(`**Strategy**: ${playbook.guidance.strategy}`);
+        if (playbook.guidance.tactics.length > 0) {
+            lines.push('**Tactics**:');
+            for (const tactic of playbook.guidance.tactics) {
+                lines.push(`  - ${tactic}`);
+            }
+        }
+        if (playbook.guidance.steps && playbook.guidance.steps.length > 0) {
+            lines.push('**Steps**:');
+            for (let i = 0; i < playbook.guidance.steps.length; i++) {
+                lines.push(`  ${i + 1}. ${playbook.guidance.steps[i]}`);
+            }
+        }
+        lines.push('');
+        // Verification
+        lines.push('## Verification');
+        if (playbook.verification.successIndicators.length > 0) {
+            lines.push('**Success indicators**:');
+            for (const ind of playbook.verification.successIndicators) {
+                lines.push(`  - ${ind}`);
+            }
+        }
+        if (playbook.verification.failureIndicators.length > 0) {
+            lines.push('**Failure indicators**:');
+            for (const ind of playbook.verification.failureIndicators) {
+                lines.push(`  - ${ind}`);
+            }
+        }
+        lines.push('');
+        // Statistics
+        lines.push('## Statistics');
+        lines.push(`- Total uses: ${totalUses}`);
+        lines.push(`- Success rate: ${Math.round(successRate * 100)}%`);
+        lines.push(`- Successes: ${successCount}`);
+        lines.push(`- Failures: ${failureCount}`);
+        lines.push('');
+        // Refinements (if enabled)
+        if (this.config.includeRefinements &&
+            playbook.evolution.refinements.length > 0) {
+            lines.push('## Context-Specific Refinements');
+            for (const ref of playbook.evolution.refinements) {
+                lines.push(`- **${ref.context}**: ${ref.addition}`);
+            }
+            lines.push('');
+        }
+        // Failure modes
+        if (playbook.evolution.failures.length > 0) {
+            lines.push('## Known Failure Modes');
+            for (const failure of playbook.evolution.failures.slice(0, 5)) {
+                lines.push(`- ${failure.context}: ${failure.failureMode}`);
+            }
+            lines.push('');
+        }
+        return lines.join('\n');
+    }
+    /**
+     * Get server info for MCP protocol
+     */
+    getServerInfo() {
+        return {
+            name: 'atlas-playbook-server',
+            version: '1.0.0',
+            description: 'MCP server providing access to the Atlas playbook library for on-demand guidance retrieval',
+        };
+    }
+}
+/**
+ * Create an MCP playbook server
+ */
+export function createPlaybookMCPServer(playbooks, skillLibrary, config) {
+    return new PlaybookMCPServer(playbooks, skillLibrary, config);
+}
+//# sourceMappingURL=playbook-server.js.map

package/dist/mcp/playbook-server.js.map

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

package/dist/memory/curated-loader.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Curated Playbook Loader
+ *
+ * Loads playbooks from JSON files on disk and manages them separately
+ * from runtime-extracted playbooks. Supports a --recreate workflow:
+ * drop all curated playbooks and reload from source files without
+ * losing extracted or imported playbooks.
+ *
+ * Inspired by Dash's separation of curated knowledge (file-loaded)
+ * vs learnings (runtime-discovered).
+ */
+import type { PlaybookLibrary } from './playbook.js';
+/**
+ * Schema for a curated playbook JSON file
+ */
+export interface CuratedPlaybookFile {
+    name: string;
+    applicability: {
+        situations: string[];
+        triggers?: string[];
+        antiPatterns?: string[];
+        domains: string[];
+    };
+    guidance: {
+        strategy: string;
+        tactics: string[];
+        steps?: string[];
+        codeExample?: string;
+    };
+    verification?: {
+        successIndicators?: string[];
+        failureIndicators?: string[];
+        rollbackStrategy?: string;
+    };
+    confidence?: number;
+    complexity?: 'simple' | 'moderate' | 'complex';
+    estimatedEffort?: number;
+    curatedBy?: string;
+}
+/**
+ * Result of a curated playbook load operation
+ */
+export interface CuratedLoadResult {
+    loaded: number;
+    skipped: number;
+    errors: Array<{
+        file: string;
+        error: string;
+    }>;
+    recreated: boolean;
+}
+/**
+ * Load curated playbooks from a directory of JSON files into the library.
+ *
+ * @param curatedDir - Directory containing curated playbook JSON files
+ * @param library - PlaybookLibrary to load into
+ * @param options.recreate - If true, delete existing curated playbooks before loading
+ */
+export declare function loadCuratedPlaybooks(curatedDir: string, library: PlaybookLibrary, options?: {
+    recreate?: boolean;
+}): Promise<CuratedLoadResult>;
+//# sourceMappingURL=curated-loader.d.ts.map

package/dist/memory/curated-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"curated-loader.d.ts","sourceRoot":"","sources":["../../src/memory/curated-loader.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE;QACb,UAAU,EAAE,MAAM,EAAE,CAAC;QACrB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;QACpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,OAAO,EAAE,MAAM,EAAE,CAAC;KACnB,CAAC;IACF,QAAQ,EAAE;QACR,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;QACjB,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,YAAY,CAAC,EAAE;QACb,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC7B,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;QAC7B,gBAAgB,CAAC,EAAE,MAAM,CAAC;KAC3B,CAAC;IACF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;IAC/C,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,eAAe,EACxB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CA2F5B"}

package/dist/memory/curated-loader.js

@@ -0,0 +1,106 @@
+/**
+ * Curated Playbook Loader
+ *
+ * Loads playbooks from JSON files on disk and manages them separately
+ * from runtime-extracted playbooks. Supports a --recreate workflow:
+ * drop all curated playbooks and reload from source files without
+ * losing extracted or imported playbooks.
+ *
+ * Inspired by Dash's separation of curated knowledge (file-loaded)
+ * vs learnings (runtime-discovered).
+ */
+import { readFile, readdir, stat } from 'node:fs/promises';
+import { join, relative } from 'node:path';
+import { existsSync } from 'node:fs';
+import { createPlaybook } from '../types/index.js';
+/**
+ * Load curated playbooks from a directory of JSON files into the library.
+ *
+ * @param curatedDir - Directory containing curated playbook JSON files
+ * @param library - PlaybookLibrary to load into
+ * @param options.recreate - If true, delete existing curated playbooks before loading
+ */
+export async function loadCuratedPlaybooks(curatedDir, library, options) {
+    const result = {
+        loaded: 0,
+        skipped: 0,
+        errors: [],
+        recreated: false,
+    };
+    if (!existsSync(curatedDir)) {
+        return result;
+    }
+    // Recreate: drop all curated playbooks first
+    if (options?.recreate) {
+        await library.deleteByOrigin('curated');
+        result.recreated = true;
+    }
+    // Find all JSON files in the directory (non-recursive)
+    const files = await readdir(curatedDir);
+    const jsonFiles = files.filter((f) => f.endsWith('.json'));
+    for (const file of jsonFiles) {
+        const filePath = join(curatedDir, file);
+        const fileStat = await stat(filePath);
+        if (!fileStat.isFile())
+            continue;
+        try {
+            const content = await readFile(filePath, 'utf-8');
+            const parsed = JSON.parse(content);
+            // Validate required fields
+            if (!parsed.name || !parsed.applicability || !parsed.guidance) {
+                result.errors.push({
+                    file,
+                    error: 'Missing required fields: name, applicability, guidance',
+                });
+                continue;
+            }
+            // Check if this curated playbook already exists (by name)
+            const existing = await library.getByName(parsed.name);
+            if (existing && !options?.recreate) {
+                result.skipped++;
+                continue;
+            }
+            const relativePath = relative(process.cwd(), filePath);
+            const provenance = {
+                origin: 'curated',
+                sourceFile: relativePath,
+                curatedBy: parsed.curatedBy,
+                recordedAt: new Date(),
+            };
+            const playbook = createPlaybook({
+                name: parsed.name,
+                applicability: {
+                    situations: parsed.applicability.situations,
+                    triggers: parsed.applicability.triggers ?? [],
+                    antiPatterns: parsed.applicability.antiPatterns ?? [],
+                    domains: parsed.applicability.domains,
+                },
+                guidance: {
+                    strategy: parsed.guidance.strategy,
+                    tactics: parsed.guidance.tactics,
+                    steps: parsed.guidance.steps,
+                    codeExample: parsed.guidance.codeExample,
+                },
+                verification: {
+                    successIndicators: parsed.verification?.successIndicators ?? [],
+                    failureIndicators: parsed.verification?.failureIndicators ?? [],
+                    rollbackStrategy: parsed.verification?.rollbackStrategy,
+                },
+                provenance,
+                confidence: parsed.confidence ?? 0.7, // Curated starts higher than extracted (0.3)
+                complexity: parsed.complexity ?? 'moderate',
+                estimatedEffort: parsed.estimatedEffort ?? 3,
+            });
+            await library.add(playbook);
+            result.loaded++;
+        }
+        catch (error) {
+            result.errors.push({
+                file,
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=curated-loader.js.map

package/dist/memory/curated-loader.js.map

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