cognitive-core 0.0.2 → 0.1.0

package/dist/search/verification-runner.js

@@ -0,0 +1,440 @@
+/**
+ * Verification Runner
+ *
+ * Provides common verification patterns for evaluating solutions:
+ * - Command execution (bash/shell)
+ * - Test runner integration
+ * - Code linting/type checking
+ * - Custom verification functions
+ *
+ * Used with SolutionEvaluator to verify trajectory outcomes.
+ */
+import { execSync, spawn } from 'child_process';
+/**
+ * Common test runner configurations
+ */
+export const TestRunners = {
+    /** Node.js test runners */
+    vitest: (testPath) => ({
+        command: `npx vitest run ${testPath ?? ''} --reporter=json`,
+        timeout: 60000,
+        successOnZeroExit: true,
+        issueExtractor: extractVitestIssues,
+    }),
+    jest: (testPath) => ({
+        command: `npx jest ${testPath ?? ''} --json`,
+        timeout: 60000,
+        successOnZeroExit: true,
+        issueExtractor: extractJestIssues,
+    }),
+    mocha: (testPath) => ({
+        command: `npx mocha ${testPath ?? ''} --reporter json`,
+        timeout: 60000,
+        successOnZeroExit: true,
+    }),
+    /** Python test runners */
+    pytest: (testPath) => ({
+        command: `python -m pytest ${testPath ?? ''} --tb=short -q`,
+        timeout: 60000,
+        successOnZeroExit: true,
+        failurePattern: /FAILED|ERROR/,
+        issueExtractor: extractPytestIssues,
+    }),
+    /** Go test runner */
+    goTest: (testPath) => ({
+        command: `go test ${testPath ?? './...'} -v`,
+        timeout: 60000,
+        successOnZeroExit: true,
+        failurePattern: /--- FAIL:|FAIL\s+\w+/,
+    }),
+    /** Rust test runner */
+    cargoTest: (testPath) => ({
+        command: `cargo test ${testPath ?? ''} -- --nocapture`,
+        timeout: 120000,
+        successOnZeroExit: true,
+        failurePattern: /test .+ \.\.\. FAILED/,
+    }),
+    /** TypeScript type checking */
+    typescript: () => ({
+        command: 'npx tsc --noEmit',
+        timeout: 60000,
+        successOnZeroExit: true,
+        issueExtractor: extractTypescriptIssues,
+    }),
+    /** ESLint */
+    eslint: (path) => ({
+        command: `npx eslint ${path ?? '.'} --format json`,
+        timeout: 30000,
+        successOnZeroExit: true,
+        issueExtractor: extractEslintIssues,
+    }),
+};
+/**
+ * VerificationRunner - Executes verification commands and parses results
+ */
+export class VerificationRunner {
+    defaultCwd;
+    defaultTimeout;
+    defaultEnv;
+    constructor(options) {
+        this.defaultCwd = options?.cwd ?? process.cwd();
+        this.defaultTimeout = options?.timeout ?? 30000;
+        this.defaultEnv = options?.env ?? {};
+    }
+    /**
+     * Create a verification function from a command configuration
+     */
+    createVerifier(config) {
+        return async (trajectory, task) => {
+            // Interpolate command with trajectory/task values
+            const command = this.interpolateCommand(config.command, trajectory, task);
+            // Run the command
+            const result = await this.runCommand(command, {
+                cwd: config.cwd ?? this.defaultCwd,
+                env: { ...this.defaultEnv, ...config.env },
+                timeout: config.timeout ?? this.defaultTimeout,
+            });
+            // Determine success
+            let passed = false;
+            const combinedOutput = result.stdout + '\n' + result.stderr;
+            if (result.timedOut) {
+                passed = false;
+            }
+            else if (config.successOnZeroExit !== false && result.exitCode === 0) {
+                // Check success pattern if provided
+                if (config.successPattern) {
+                    passed = config.successPattern.test(combinedOutput);
+                }
+                else {
+                    passed = true;
+                }
+            }
+            else if (config.failurePattern) {
+                passed = !config.failurePattern.test(combinedOutput);
+            }
+            // Extract issues
+            let issues = [];
+            if (config.issueExtractor) {
+                issues = config.issueExtractor(combinedOutput, result.exitCode);
+            }
+            else if (!passed) {
+                // Default issue extraction
+                issues = this.extractDefaultIssues(combinedOutput, result.exitCode);
+            }
+            // Calculate confidence based on clarity of result
+            const confidence = result.timedOut
+                ? 0.5
+                : (config.successPattern || config.failurePattern || config.issueExtractor)
+                    ? 0.9
+                    : 0.7;
+            return {
+                passed,
+                confidence,
+                issues: issues.map((issue) => ({
+                    type: issue.type,
+                    description: issue.description,
+                    severity: issue.severity,
+                })),
+                details: result.timedOut
+                    ? 'Verification timed out'
+                    : `Exit code: ${result.exitCode}\n${combinedOutput.slice(0, 2000)}`,
+            };
+        };
+    }
+    /**
+     * Run a command and capture output
+     */
+    async runCommand(command, options) {
+        return new Promise((resolve) => {
+            const cwd = options.cwd ?? this.defaultCwd;
+            const timeout = options.timeout ?? this.defaultTimeout;
+            const env = { ...process.env, ...this.defaultEnv, ...options.env };
+            let stdout = '';
+            let stderr = '';
+            let timedOut = false;
+            const child = spawn(command, {
+                shell: true,
+                cwd,
+                env,
+            });
+            const timer = setTimeout(() => {
+                timedOut = true;
+                child.kill('SIGTERM');
+                // Force kill after 5 seconds if still running
+                setTimeout(() => child.kill('SIGKILL'), 5000);
+            }, timeout);
+            child.stdout.on('data', (data) => {
+                stdout += data.toString();
+            });
+            child.stderr.on('data', (data) => {
+                stderr += data.toString();
+            });
+            child.on('close', (code) => {
+                clearTimeout(timer);
+                resolve({
+                    stdout,
+                    stderr,
+                    exitCode: code ?? (timedOut ? 124 : 1),
+                    timedOut,
+                });
+            });
+            child.on('error', (error) => {
+                clearTimeout(timer);
+                resolve({
+                    stdout,
+                    stderr: stderr + '\n' + error.message,
+                    exitCode: 1,
+                    timedOut: false,
+                });
+            });
+        });
+    }
+    /**
+     * Run a command synchronously (for simple checks)
+     */
+    runCommandSync(command, options) {
+        const cwd = options?.cwd ?? this.defaultCwd;
+        const timeout = options?.timeout ?? this.defaultTimeout;
+        const env = { ...process.env, ...this.defaultEnv, ...options?.env };
+        try {
+            const output = execSync(command, {
+                cwd,
+                env,
+                timeout,
+                encoding: 'utf-8',
+                stdio: ['pipe', 'pipe', 'pipe'],
+            });
+            return {
+                stdout: output,
+                stderr: '',
+                exitCode: 0,
+                timedOut: false,
+            };
+        }
+        catch (error) {
+            const timedOut = error.killed && error.signal === 'SIGTERM';
+            return {
+                stdout: error.stdout?.toString() ?? '',
+                stderr: error.stderr?.toString() ?? error.message,
+                exitCode: error.status ?? 1,
+                timedOut,
+            };
+        }
+    }
+    /**
+     * Interpolate command with trajectory/task values
+     */
+    interpolateCommand(command, trajectory, task) {
+        return command
+            .replace(/\{\{taskId\}\}/g, task.id)
+            .replace(/\{\{domain\}\}/g, task.domain ?? '')
+            .replace(/\{\{trajectoryId\}\}/g, trajectory.id)
+            .replace(/\{\{solution\}\}/g, typeof trajectory.outcome.solution === 'string'
+            ? trajectory.outcome.solution
+            : '');
+    }
+    /**
+     * Extract default issues from output
+     */
+    extractDefaultIssues(output, exitCode) {
+        const issues = [];
+        if (exitCode !== 0) {
+            // Look for common error patterns
+            const errorMatch = output.match(/(?:error|Error|ERROR)[:\s]+(.+?)(?:\n|$)/);
+            const failMatch = output.match(/(?:fail|Fail|FAIL)[:\s]+(.+?)(?:\n|$)/);
+            if (errorMatch) {
+                issues.push({
+                    type: 'error',
+                    description: errorMatch[1].slice(0, 200),
+                    severity: 'critical',
+                });
+            }
+            else if (failMatch) {
+                issues.push({
+                    type: 'incorrect',
+                    description: failMatch[1].slice(0, 200),
+                    severity: 'major',
+                });
+            }
+            else {
+                issues.push({
+                    type: 'error',
+                    description: `Command failed with exit code ${exitCode}`,
+                    severity: 'major',
+                });
+            }
+        }
+        return issues;
+    }
+    /**
+     * Create a composite verifier that runs multiple verifications
+     */
+    createCompositeVerifier(configs) {
+        const verifiers = configs.map((config) => this.createVerifier(config));
+        return async (trajectory, task) => {
+            const results = [];
+            for (const verifier of verifiers) {
+                const result = await verifier(trajectory, task);
+                results.push(result);
+                // Fail fast on critical failure
+                if (!result.passed && result.issues?.some((i) => i.severity === 'critical')) {
+                    break;
+                }
+            }
+            // Aggregate results
+            const allPassed = results.every((r) => r.passed);
+            const avgConfidence = results.reduce((sum, r) => sum + r.confidence, 0) / results.length;
+            const allIssues = results.flatMap((r) => r.issues ?? []);
+            const details = results.map((r) => r.details).filter(Boolean).join('\n---\n');
+            return {
+                passed: allPassed,
+                confidence: avgConfidence,
+                issues: allIssues,
+                details,
+            };
+        };
+    }
+}
+/**
+ * Create a verification runner
+ */
+export function createVerificationRunner(options) {
+    return new VerificationRunner(options);
+}
+// Issue extractors for common test runners
+function extractVitestIssues(output, _exitCode) {
+    const issues = [];
+    try {
+        // Try to parse JSON output
+        const jsonMatch = output.match(/\{[\s\S]*"testResults"[\s\S]*\}/);
+        if (jsonMatch) {
+            const data = JSON.parse(jsonMatch[0]);
+            for (const testResult of data.testResults ?? []) {
+                for (const assertion of testResult.assertionResults ?? []) {
+                    if (assertion.status === 'failed') {
+                        issues.push({
+                            type: 'incorrect',
+                            description: `${assertion.fullName}: ${assertion.failureMessages?.[0]?.slice(0, 200) ?? 'Failed'}`,
+                            severity: 'major',
+                            file: testResult.name,
+                        });
+                    }
+                }
+            }
+        }
+    }
+    catch {
+        // Fall back to pattern matching
+        const failureMatches = output.matchAll(/FAIL\s+(.+?)\n.*?(\d+)\s+failed/g);
+        for (const match of failureMatches) {
+            issues.push({
+                type: 'incorrect',
+                description: `Test suite failed: ${match[1]}`,
+                severity: 'major',
+                file: match[1],
+            });
+        }
+    }
+    return issues;
+}
+function extractJestIssues(output, _exitCode) {
+    const issues = [];
+    try {
+        const jsonMatch = output.match(/\{[\s\S]*"testResults"[\s\S]*\}/);
+        if (jsonMatch) {
+            const data = JSON.parse(jsonMatch[0]);
+            for (const testResult of data.testResults ?? []) {
+                for (const assertion of testResult.assertionResults ?? []) {
+                    if (assertion.status === 'failed') {
+                        issues.push({
+                            type: 'incorrect',
+                            description: `${assertion.fullName}: ${assertion.failureMessages?.[0]?.slice(0, 200) ?? 'Failed'}`,
+                            severity: 'major',
+                            file: testResult.name,
+                        });
+                    }
+                }
+            }
+        }
+    }
+    catch {
+        const failureMatches = output.matchAll(/● (.+)/g);
+        for (const match of failureMatches) {
+            issues.push({
+                type: 'incorrect',
+                description: match[1].slice(0, 200),
+                severity: 'major',
+            });
+        }
+    }
+    return issues;
+}
+function extractPytestIssues(output, _exitCode) {
+    const issues = [];
+    // Match pytest failure lines
+    const failureMatches = output.matchAll(/FAILED\s+(.+?)(?:::|$)/g);
+    for (const match of failureMatches) {
+        issues.push({
+            type: 'incorrect',
+            description: `Test failed: ${match[1]}`,
+            severity: 'major',
+        });
+    }
+    // Match pytest errors
+    const errorMatches = output.matchAll(/ERROR\s+(.+?)(?:\n|$)/g);
+    for (const match of errorMatches) {
+        issues.push({
+            type: 'error',
+            description: match[1].slice(0, 200),
+            severity: 'critical',
+        });
+    }
+    return issues;
+}
+function extractTypescriptIssues(output, _exitCode) {
+    const issues = [];
+    // Match TypeScript error format: file(line,col): error TS####: message
+    const errorMatches = output.matchAll(/(.+?)\((\d+),\d+\):\s+error\s+TS\d+:\s+(.+?)(?:\n|$)/g);
+    for (const match of errorMatches) {
+        issues.push({
+            type: 'error',
+            description: match[3].slice(0, 200),
+            severity: 'critical',
+            file: match[1],
+            line: parseInt(match[2], 10),
+        });
+    }
+    return issues;
+}
+function extractEslintIssues(output, _exitCode) {
+    const issues = [];
+    try {
+        const data = JSON.parse(output);
+        for (const file of data) {
+            for (const message of file.messages ?? []) {
+                const severity = message.severity === 2 ? 'major' : 'minor';
+                issues.push({
+                    type: message.fatal ? 'error' : 'incorrect',
+                    description: `${message.ruleId}: ${message.message}`,
+                    severity,
+                    file: file.filePath,
+                    line: message.line,
+                });
+            }
+        }
+    }
+    catch {
+        // ESLint output wasn't JSON
+        const errorMatches = output.matchAll(/(\d+):\d+\s+error\s+(.+?)\s+(\S+)/g);
+        for (const match of errorMatches) {
+            issues.push({
+                type: 'error',
+                description: `${match[3]}: ${match[2]}`,
+                severity: 'major',
+                line: parseInt(match[1], 10),
+            });
+        }
+    }
+    return issues;
+}
+//# sourceMappingURL=verification-runner.js.map

package/dist/search/verification-runner.js.map

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

package/dist/surfacing/index.d.ts

@@ -0,0 +1,2 @@
+export { SkillLibrary, createSkillLibrary, type AgentSkills, type TierRefreshResult, } from './skill-library.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/surfacing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,oBAAoB,CAAC"}

package/dist/surfacing/index.js

@@ -0,0 +1,2 @@
+export { SkillLibrary, createSkillLibrary, } from './skill-library.js';
+//# sourceMappingURL=index.js.map

package/dist/surfacing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/surfacing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,kBAAkB,GAGnB,MAAM,oBAAoB,CAAC"}

package/dist/surfacing/skill-library.d.ts

@@ -0,0 +1,158 @@
+/**
+ * Skill Library
+ * Tiered surfacing of playbooks for agent consumption
+ *
+ * Tiers:
+ * 1. Core Skills - Always in system prompt (highest confidence)
+ * 2. Domain Skills - Loaded when domain matches
+ * 3. Contextual - Injected based on task query
+ * 4. On-Demand - Available via MCP tool
+ */
+import type { Task, Playbook, SkillLibraryConfig } from '../types/index.js';
+import type { PlaybookLibrary } from '../memory/playbook.js';
+/**
+ * Skills organized for agent context
+ */
+export interface AgentSkills {
+    /** Core skills - always included */
+    core: Playbook[];
+    /** Domain-specific skills */
+    domain: Playbook[];
+    /** Task-specific contextual playbooks */
+    contextual: Playbook[];
+    /** Estimated token count */
+    totalTokenEstimate: number;
+}
+/**
+ * Result of refreshing skill tiers
+ */
+export interface TierRefreshResult {
+    /** Playbook IDs promoted to core */
+    promoted: string[];
+    /** Playbook IDs demoted from core */
+    demoted: string[];
+    /** Current core skill count */
+    coreCount: number;
+    /** Domain skill counts */
+    domainCounts: Record<string, number>;
+}
+/**
+ * Skill Library
+ * Manages tiered access to playbooks for agent consumption
+ */
+export declare class SkillLibrary {
+    private playbooks;
+    private config;
+    private coreSkills;
+    private domainSkills;
+    private lastRefresh;
+    private consecutiveFailures;
+    constructor(playbooks: PlaybookLibrary, config?: Partial<SkillLibraryConfig>);
+    /**
+     * Merge configuration with defaults
+     */
+    private mergeConfig;
+    /**
+     * Refresh skill tiers based on current playbook state
+     * Called periodically or after significant learning
+     */
+    refreshTiers(): Promise<TierRefreshResult>;
+    /**
+     * Check if a playbook qualifies for core skill status
+     */
+    private meetsPromotionCriteria;
+    /**
+     * Check if a core skill should be demoted
+     */
+    private meetsDemotionCriteria;
+    /**
+     * Get skills for agent system prompt
+     * Returns tiered skills based on task context
+     */
+    getSkillsForAgent(task: Task, options?: {
+        includeCore?: boolean;
+        includeDomain?: boolean;
+        includeContextual?: boolean;
+    }): Promise<AgentSkills>;
+    /**
+     * Estimate token count for playbooks
+     */
+    private estimateTokens;
+    /**
+     * Format skills for system prompt injection
+     */
+    formatForSystemPrompt(skills: AgentSkills): string;
+    /**
+     * Format a single playbook for prompt
+     */
+    private formatPlaybookForPrompt;
+    /**
+     * Record playbook usage outcome (inferred from trajectory)
+     * Called by learning pipeline after trajectory analysis
+     */
+    recordOutcome(playbookId: string, trajectoryId: string, success: boolean, context?: string): Promise<void>;
+    /**
+     * Get promotion candidates
+     */
+    getPromotionCandidates(): Promise<Playbook[]>;
+    /**
+     * Get demotion candidates
+     */
+    getDemotionCandidates(): Promise<Playbook[]>;
+    /**
+     * Get current core skills
+     */
+    getCoreSkills(): Playbook[];
+    /**
+     * Get domain skills
+     */
+    getDomainSkills(domain: string): Playbook[];
+    /**
+     * Get all domains with skills
+     */
+    getDomains(): string[];
+    /**
+     * Get statistics
+     */
+    getStats(): {
+        coreSkillCount: number;
+        domainSkillCounts: Record<string, number>;
+        lastRefresh: Date | null;
+        consecutiveFailures: Record<string, number>;
+    };
+    /**
+     * Get consecutive failure count for a playbook
+     */
+    getConsecutiveFailures(playbookId: string): number;
+    /**
+     * Reset consecutive failures for a playbook
+     */
+    resetConsecutiveFailures(playbookId: string): void;
+    /**
+     * Get all playbooks at risk of demotion
+     */
+    getAtRiskPlaybooks(): Array<{
+        playbook: Playbook;
+        consecutiveFailures: number;
+        failuresUntilDemotion: number;
+    }>;
+    /**
+     * Apply time-based decay to consecutive failures
+     * Reduces failure counts for playbooks that haven't been used recently
+     * @param decayAmount Amount to reduce failure count by (default: 1)
+     */
+    applyFailureDecay(decayAmount?: number): void;
+    /**
+     * Export consecutive failure state for persistence
+     */
+    exportFailureState(): Record<string, number>;
+    /**
+     * Import consecutive failure state from persistence
+     */
+    importFailureState(state: Record<string, number>): void;
+}
+/**
+ * Create a skill library
+ */
+export declare function createSkillLibrary(playbooks: PlaybookLibrary, config?: Partial<SkillLibraryConfig>): SkillLibrary;
+//# sourceMappingURL=skill-library.d.ts.map

package/dist/surfacing/skill-library.d.ts.map

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