cognitive-core 0.0.1 → 0.1.0

package/dist/learning/usage-inference.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Playbook Usage Inference
+ * Infers which playbooks were used and whether they helped
+ * from trajectory analysis (no explicit agent reporting needed)
+ */
+import type { Trajectory, Playbook } from '../types/index.js';
+/**
+ * Result of playbook usage inference
+ */
+export interface PlaybookUsageResult {
+    playbookId: string;
+    playbookName: string;
+    /** Did agent follow this playbook? */
+    wasUsed: boolean;
+    /** How confident are we it was used? */
+    usageConfidence: number;
+    /** Did it lead to success? */
+    wasSuccessful: boolean;
+    /** Which trajectory steps matched */
+    matchedSteps: number[];
+    /** Relevant context for refinement */
+    context?: string;
+}
+/**
+ * Configuration for usage inference
+ */
+export interface UsageInferenceConfig {
+    /** Minimum similarity for tactic matching */
+    tacticMatchThreshold: number;
+    /** Minimum tactics matched to consider playbook used */
+    minTacticsMatchRatio: number;
+    /** Minimum confidence to report as used */
+    minUsageConfidence: number;
+}
+/**
+ * Playbook Usage Inference
+ * Analyzes trajectories to determine if playbooks were used
+ */
+export declare class PlaybookUsageInference {
+    private config;
+    constructor(config?: Partial<UsageInferenceConfig>);
+    /**
+     * Analyze trajectory to infer playbook usage
+     */
+    inferUsage(trajectory: Trajectory, injectedPlaybooks: Playbook[]): Promise<PlaybookUsageResult[]>;
+    /**
+     * Match trajectory steps against playbook guidance
+     */
+    private matchStepsToPlaybook;
+    /**
+     * Match steps against playbook strategy (when no tactics)
+     */
+    private matchAgainstStrategy;
+    /**
+     * Extract keywords from text
+     */
+    private extractKeywords;
+    /**
+     * Check if word is a stop word
+     */
+    private isStopWord;
+    /**
+     * Determine if playbook application was successful
+     */
+    private inferSuccess;
+    /**
+     * Extract relevant context for potential refinement
+     */
+    private extractRelevantContext;
+    /**
+     * Batch analyze multiple trajectories
+     */
+    inferUsageBatch(trajectories: Array<{
+        trajectory: Trajectory;
+        injectedPlaybooks: Playbook[];
+    }>): Promise<Map<string, PlaybookUsageResult[]>>;
+}
+/**
+ * Create a playbook usage inference instance
+ */
+export declare function createUsageInference(config?: Partial<UsageInferenceConfig>): PlaybookUsageInference;
+//# sourceMappingURL=usage-inference.d.ts.map

package/dist/learning/usage-inference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-inference.d.ts","sourceRoot":"","sources":["../../src/learning/usage-inference.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAQ,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAGpE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,wCAAwC;IACxC,eAAe,EAAE,MAAM,CAAC;IACxB,8BAA8B;IAC9B,aAAa,EAAE,OAAO,CAAC;IACvB,qCAAqC;IACrC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,sCAAsC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAaD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,6CAA6C;IAC7C,oBAAoB,EAAE,MAAM,CAAC;IAC7B,wDAAwD;IACxD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,2CAA2C;IAC3C,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAQD;;;GAGG;AACH,qBAAa,sBAAsB;IACjC,OAAO,CAAC,MAAM,CAAuB;gBAEzB,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC;IAIlD;;OAEG;IACG,UAAU,CACd,UAAU,EAAE,UAAU,EACtB,iBAAiB,EAAE,QAAQ,EAAE,GAC5B,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAmCjC;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAkE5B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IA6B5B;;OAEG;IACH,OAAO,CAAC,eAAe;IAQvB;;OAEG;IACH,OAAO,CAAC,UAAU;IAgDlB;;OAEG;IACH,OAAO,CAAC,YAAY;IAuCpB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA4B9B;;OAEG;IACG,eAAe,CACnB,YAAY,EAAE,KAAK,CAAC;QAClB,UAAU,EAAE,UAAU,CAAC;QACvB,iBAAiB,EAAE,QAAQ,EAAE,CAAC;KAC/B,CAAC,GACD,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,mBAAmB,EAAE,CAAC,CAAC;CAU/C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GACrC,sBAAsB,CAExB"}

package/dist/learning/usage-inference.js

@@ -0,0 +1,261 @@
+/**
+ * Playbook Usage Inference
+ * Infers which playbooks were used and whether they helped
+ * from trajectory analysis (no explicit agent reporting needed)
+ */
+import { textSimilarity } from '../utils/similarity.js';
+const DEFAULT_CONFIG = {
+    tacticMatchThreshold: 0.5,
+    minTacticsMatchRatio: 0.3,
+    minUsageConfidence: 0.4,
+};
+/**
+ * Playbook Usage Inference
+ * Analyzes trajectories to determine if playbooks were used
+ */
+export class PlaybookUsageInference {
+    config;
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Analyze trajectory to infer playbook usage
+     */
+    async inferUsage(trajectory, injectedPlaybooks) {
+        const results = [];
+        for (const playbook of injectedPlaybooks) {
+            const matchResult = this.matchStepsToPlaybook(trajectory.steps, playbook);
+            const wasUsed = matchResult.matched &&
+                matchResult.confidence >= this.config.minUsageConfidence;
+            const wasSuccessful = wasUsed
+                ? this.inferSuccess(trajectory, playbook, matchResult)
+                : false;
+            const context = wasUsed
+                ? this.extractRelevantContext(trajectory, playbook, matchResult)
+                : undefined;
+            results.push({
+                playbookId: playbook.id,
+                playbookName: playbook.name,
+                wasUsed,
+                usageConfidence: matchResult.confidence,
+                wasSuccessful,
+                matchedSteps: matchResult.matchedSteps,
+                context,
+            });
+        }
+        return results;
+    }
+    /**
+     * Match trajectory steps against playbook guidance
+     */
+    matchStepsToPlaybook(steps, playbook) {
+        const tactics = playbook.guidance.tactics;
+        if (tactics.length === 0) {
+            // No tactics to match - check strategy
+            const strategyMatch = this.matchAgainstStrategy(steps, playbook);
+            return {
+                matched: strategyMatch.confidence > 0.3,
+                matchedTactics: 0,
+                totalTactics: 0,
+                matchedSteps: strategyMatch.matchedSteps,
+                confidence: strategyMatch.confidence,
+            };
+        }
+        const matchedSteps = [];
+        let matchedTactics = 0;
+        // Try to match each tactic to trajectory steps
+        for (const tactic of tactics) {
+            const tacticWords = this.extractKeywords(tactic);
+            for (let i = 0; i < steps.length; i++) {
+                if (matchedSteps.includes(i))
+                    continue;
+                const step = steps[i];
+                const stepText = `${step.thought ?? ''} ${step.action}`.toLowerCase();
+                const stepWords = this.extractKeywords(stepText);
+                // Check word overlap
+                const overlap = tacticWords.filter((w) => stepWords.includes(w)).length;
+                const overlapRatio = overlap / Math.max(tacticWords.length, 1);
+                // Also check semantic similarity
+                const similarity = textSimilarity(tactic, stepText);
+                if (overlapRatio >= this.config.tacticMatchThreshold ||
+                    similarity >= this.config.tacticMatchThreshold) {
+                    matchedTactics++;
+                    matchedSteps.push(i);
+                    break;
+                }
+            }
+        }
+        const matchRatio = matchedTactics / tactics.length;
+        const matched = matchRatio >= this.config.minTacticsMatchRatio;
+        // Calculate confidence based on match ratio and step coverage
+        const stepCoverage = matchedSteps.length / Math.max(steps.length, 1);
+        const confidence = matched ? (matchRatio * 0.7 + stepCoverage * 0.3) : 0;
+        return {
+            matched,
+            matchedTactics,
+            totalTactics: tactics.length,
+            matchedSteps,
+            confidence,
+        };
+    }
+    /**
+     * Match steps against playbook strategy (when no tactics)
+     */
+    matchAgainstStrategy(steps, playbook) {
+        const strategy = playbook.guidance.strategy;
+        const strategyWords = this.extractKeywords(strategy);
+        const matchedSteps = [];
+        for (let i = 0; i < steps.length; i++) {
+            const step = steps[i];
+            const stepText = `${step.thought ?? ''} ${step.action}`.toLowerCase();
+            const stepWords = this.extractKeywords(stepText);
+            const overlap = strategyWords.filter((w) => stepWords.includes(w)).length;
+            const similarity = textSimilarity(strategy, stepText);
+            if (overlap >= 2 || similarity >= 0.4) {
+                matchedSteps.push(i);
+            }
+        }
+        const confidence = matchedSteps.length > 0
+            ? Math.min(0.6, matchedSteps.length / steps.length + 0.2)
+            : 0;
+        return { confidence, matchedSteps };
+    }
+    /**
+     * Extract keywords from text
+     */
+    extractKeywords(text) {
+        return text
+            .toLowerCase()
+            .replace(/[^\w\s]/g, ' ')
+            .split(/\s+/)
+            .filter((w) => w.length > 2 && !this.isStopWord(w));
+    }
+    /**
+     * Check if word is a stop word
+     */
+    isStopWord(word) {
+        const stopWords = new Set([
+            'the',
+            'a',
+            'an',
+            'and',
+            'or',
+            'but',
+            'is',
+            'are',
+            'was',
+            'were',
+            'be',
+            'been',
+            'have',
+            'has',
+            'had',
+            'do',
+            'does',
+            'did',
+            'will',
+            'would',
+            'could',
+            'should',
+            'can',
+            'to',
+            'of',
+            'in',
+            'for',
+            'on',
+            'with',
+            'at',
+            'by',
+            'from',
+            'as',
+            'then',
+            'that',
+            'this',
+            'these',
+            'those',
+            'you',
+            'your',
+            'they',
+            'their',
+        ]);
+        return stopWords.has(word);
+    }
+    /**
+     * Determine if playbook application was successful
+     */
+    inferSuccess(trajectory, playbook, matchResult) {
+        // Primary: Check trajectory outcome
+        if (!trajectory.outcome.success) {
+            return false;
+        }
+        // Check if success indicators are present
+        const successIndicators = playbook.verification.successIndicators;
+        if (successIndicators.length > 0) {
+            const outcomeText = JSON.stringify(trajectory.outcome).toLowerCase();
+            const hasIndicator = successIndicators.some((indicator) => outcomeText.includes(indicator.toLowerCase()));
+            if (hasIndicator)
+                return true;
+        }
+        // Check if failure indicators are absent
+        const failureIndicators = playbook.verification.failureIndicators;
+        if (failureIndicators.length > 0) {
+            const trajectoryText = trajectory.steps
+                .map((s) => `${s.action} ${s.observation ?? ''}`)
+                .join(' ')
+                .toLowerCase();
+            const hasFailureIndicator = failureIndicators.some((indicator) => trajectoryText.includes(indicator.toLowerCase()));
+            if (hasFailureIndicator)
+                return false;
+        }
+        // Default to trajectory success with high match confidence
+        return matchResult.confidence >= 0.5;
+    }
+    /**
+     * Extract relevant context for potential refinement
+     */
+    extractRelevantContext(trajectory, _playbook, _matchResult) {
+        // Look for context in task metadata
+        const metadata = trajectory.task.metadata ?? {};
+        if (metadata.fileType)
+            return `${metadata.fileType} files`;
+        if (metadata.framework)
+            return `${metadata.framework} project`;
+        if (metadata.language)
+            return `${metadata.language} codebase`;
+        // Check for specific patterns in steps
+        const allText = trajectory.steps
+            .map((s) => `${s.thought ?? ''} ${s.action} ${s.observation ?? ''}`)
+            .join(' ')
+            .toLowerCase();
+        if (allText.includes('monorepo'))
+            return 'monorepo';
+        if (allText.includes('typescript'))
+            return 'typescript';
+        if (allText.includes('react'))
+            return 'react';
+        if (allText.includes('node'))
+            return 'nodejs';
+        if (allText.includes('python'))
+            return 'python';
+        // Fall back to domain
+        return trajectory.task.domain || undefined;
+    }
+    /**
+     * Batch analyze multiple trajectories
+     */
+    async inferUsageBatch(trajectories) {
+        const results = new Map();
+        for (const { trajectory, injectedPlaybooks } of trajectories) {
+            const usage = await this.inferUsage(trajectory, injectedPlaybooks);
+            results.set(trajectory.id, usage);
+        }
+        return results;
+    }
+}
+/**
+ * Create a playbook usage inference instance
+ */
+export function createUsageInference(config) {
+    return new PlaybookUsageInference(config);
+}
+//# sourceMappingURL=usage-inference.js.map

package/dist/learning/usage-inference.js.map

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

package/dist/mcp/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @deprecated The MCP server is deprecated in favor of the CLI + SKILL.md approach.
+ * See /SKILL.md for agent instructions and use bin/cognitive-core CLI instead.
+ */
+export { PlaybookMCPServer, createPlaybookMCPServer, type MCPTool, type MCPToolCall, type MCPToolResult, type PlaybookSearchResult, } from './playbook-server.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,iBAAiB,EACjB,uBAAuB,EACvB,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,oBAAoB,GAC1B,MAAM,sBAAsB,CAAC"}

package/dist/mcp/index.js

@@ -0,0 +1,6 @@
+/**
+ * @deprecated The MCP server is deprecated in favor of the CLI + SKILL.md approach.
+ * See /SKILL.md for agent instructions and use bin/cognitive-core CLI instead.
+ */
+export { PlaybookMCPServer, createPlaybookMCPServer, } from './playbook-server.js';
+//# sourceMappingURL=index.js.map

package/dist/mcp/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EACL,iBAAiB,EACjB,uBAAuB,GAKxB,MAAM,sBAAsB,CAAC"}

package/dist/mcp/playbook-server.d.ts

@@ -0,0 +1,120 @@
+/**
+ * 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 type { PlaybookLibrary } from '../memory/playbook.js';
+import type { SkillLibrary } from '../surfacing/skill-library.js';
+import type { MCPServerConfig } from '../types/config.js';
+/**
+ * MCP Tool definition
+ */
+export interface MCPTool {
+    name: string;
+    description: string;
+    inputSchema: {
+        type: 'object';
+        properties: Record<string, unknown>;
+        required?: string[];
+    };
+}
+/**
+ * MCP Tool call request
+ */
+export interface MCPToolCall {
+    name: string;
+    arguments: Record<string, unknown>;
+}
+/**
+ * MCP Tool call result
+ */
+export interface MCPToolResult {
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}
+/**
+ * Search result for MCP
+ */
+export interface PlaybookSearchResult {
+    id: string;
+    name: string;
+    confidence: number;
+    matchScore: number;
+    matchType: string;
+    strategy: string;
+    tactics: string[];
+    successRate: number;
+    domains: string[];
+}
+/**
+ * MCP Playbook Server
+ * Provides playbook search tools for agents
+ */
+export declare class PlaybookMCPServer {
+    private playbooks;
+    private config;
+    constructor(playbooks: PlaybookLibrary, _skillLibrary?: SkillLibrary, config?: Partial<MCPServerConfig>);
+    /**
+     * Get available MCP tools
+     */
+    getTools(): MCPTool[];
+    /**
+     * Handle an MCP tool call
+     */
+    handleToolCall(call: MCPToolCall): Promise<MCPToolResult>;
+    /**
+     * Handle search_playbooks tool call
+     */
+    private handleSearchPlaybooks;
+    /**
+     * Handle get_playbook_details tool call
+     */
+    private handleGetPlaybookDetails;
+    /**
+     * Handle list_domains tool call
+     */
+    private handleListDomains;
+    /**
+     * Handle get_playbooks_by_domain tool call
+     */
+    private handleGetPlaybooksByDomain;
+    /**
+     * Format playbook match for search results
+     */
+    private formatPlaybookForSearch;
+    /**
+     * Format search result as text
+     */
+    private formatSearchResultAsText;
+    /**
+     * Format playbook summary
+     */
+    private formatPlaybookSummary;
+    /**
+     * Format full playbook details
+     */
+    private formatPlaybookDetails;
+    /**
+     * Get server info for MCP protocol
+     */
+    getServerInfo(): {
+        name: string;
+        version: string;
+        description: string;
+    };
+}
+/**
+ * Create an MCP playbook server
+ */
+export declare function createPlaybookMCPServer(playbooks: PlaybookLibrary, skillLibrary?: SkillLibrary, config?: Partial<MCPServerConfig>): PlaybookMCPServer;
+//# sourceMappingURL=playbook-server.d.ts.map

package/dist/mcp/playbook-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playbook-server.d.ts","sourceRoot":"","sources":["../../src/mcp/playbook-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAiB,MAAM,uBAAuB,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAQ1D;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,IAAI,EAAE,QAAQ,CAAC;QACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QACpC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;KACrB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAeD;;;GAGG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,MAAM,CAAkB;gBAG9B,SAAS,EAAE,eAAe,EAC1B,aAAa,CAAC,EAAE,YAAY,EAC5B,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC;IAMnC;;OAEG;IACH,QAAQ,IAAI,OAAO,EAAE;IAuErB;;OAEG;IACG,cAAc,CAAC,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC;IA8B/D;;OAEG;YACW,qBAAqB;IA2CnC;;OAEG;YACW,wBAAwB;IA6BtC;;OAEG;YACW,iBAAiB;IA6B/B;;OAEG;YACW,0BAA0B;IAsCxC;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAkB/B;;OAEG;IACH,OAAO,CAAC,wBAAwB;IA6BhC;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAgB7B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAwG7B;;OAEG;IACH,aAAa,IAAI;QACf,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,EAAE,MAAM,CAAC;KACrB;CAQF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,eAAe,EAC1B,YAAY,CAAC,EAAE,YAAY,EAC3B,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,GAChC,iBAAiB,CAEnB"}