cognitive-core 0.0.2 → 0.1.2

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/session-bank/git-reader.d.ts

@@ -0,0 +1,39 @@
+export interface GitReaderOptions {
+    repoPath: string;
+    branch?: string;
+}
+export declare class EntireGitReader {
+    private repoPath;
+    private branch;
+    constructor(options: GitReaderOptions);
+    /** Check if the orphan branch exists in this repo */
+    branchExists(): Promise<boolean>;
+    /**
+     * List all checkpoint directories.
+     * Returns paths like ["a3/b2c4d5e6f7", "f1/0a9b8c7d6e5f", ...]
+     */
+    listCheckpoints(): Promise<string[]>;
+    /**
+     * List session subdirectories within a checkpoint.
+     * Returns numeric session indices like ["0", "1"].
+     */
+    listSessions(checkpointPath: string): Promise<string[]>;
+    /** Read a single file from the orphan branch */
+    readFile(path: string): Promise<string>;
+    /**
+     * Read multiple files in batch.
+     * Returns Map<path, content>. Missing files are omitted.
+     */
+    readFiles(paths: string[]): Promise<Map<string, string>>;
+    /** Read a file, returning null if it doesn't exist */
+    readFileOrNull(path: string): Promise<string | null>;
+    /** Get the HEAD commit SHA of the orphan branch */
+    getBranchHead(): Promise<string | null>;
+    /**
+     * Find the Entire-Checkpoint trailer value for a given commit.
+     * Returns the checkpoint ID or null.
+     */
+    getCheckpointTrailer(commitSha: string): Promise<string | null>;
+    private git;
+}
+//# sourceMappingURL=git-reader.d.ts.map

package/dist/session-bank/git-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-reader.d.ts","sourceRoot":"","sources":["../../src/session-bank/git-reader.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,gBAAgB;IAKrC,qDAAqD;IAC/C,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;IAStC;;;OAGG;IACG,eAAe,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAyC1C;;;OAGG;IACG,YAAY,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAwB7D,gDAAgD;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAI7C;;;OAGG;IACG,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAoB9D,sDAAsD;IAChD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAQ1D,mDAAmD;IAC7C,aAAa,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAS7C;;;OAGG;IACG,oBAAoB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAiBrE,OAAO,CAAC,GAAG;CAgBZ"}

package/dist/session-bank/git-reader.js

@@ -0,0 +1,165 @@
+import { execFile } from 'node:child_process';
+export class EntireGitReader {
+    repoPath;
+    branch;
+    constructor(options) {
+        this.repoPath = options.repoPath;
+        this.branch = options.branch ?? 'entire/checkpoints/v1';
+    }
+    /** Check if the orphan branch exists in this repo */
+    async branchExists() {
+        try {
+            await this.git(['rev-parse', '--verify', this.branch]);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * List all checkpoint directories.
+     * Returns paths like ["a3/b2c4d5e6f7", "f1/0a9b8c7d6e5f", ...]
+     */
+    async listCheckpoints() {
+        // First list shard directories (2-char hex prefixes)
+        let shardOutput;
+        try {
+            shardOutput = await this.git([
+                'ls-tree',
+                '--name-only',
+                this.branch,
+            ]);
+        }
+        catch {
+            return [];
+        }
+        const shards = shardOutput
+            .split('\n')
+            .map((s) => s.trim())
+            .filter((s) => s.length > 0);
+        // For each shard, list checkpoint subdirectories
+        const checkpoints = [];
+        for (const shard of shards) {
+            try {
+                const innerOutput = await this.git([
+                    'ls-tree',
+                    '--name-only',
+                    this.branch,
+                    shard + '/',
+                ]);
+                const entries = innerOutput
+                    .split('\n')
+                    .map((e) => e.trim())
+                    .filter((e) => e.length > 0);
+                checkpoints.push(...entries);
+            }
+            catch {
+                // Skip shards that fail to list
+            }
+        }
+        return checkpoints;
+    }
+    /**
+     * List session subdirectories within a checkpoint.
+     * Returns numeric session indices like ["0", "1"].
+     */
+    async listSessions(checkpointPath) {
+        try {
+            const output = await this.git([
+                'ls-tree',
+                '--name-only',
+                this.branch,
+                checkpointPath + '/',
+            ]);
+            return output
+                .split('\n')
+                .map((e) => e.trim())
+                .filter((e) => e.length > 0)
+                // Extract just the directory name from the full path
+                .map((e) => {
+                const parts = e.split('/');
+                return parts[parts.length - 1];
+            })
+                // Keep only numeric directories (sessions), skip "tasks", "metadata.json" etc.
+                .filter((e) => /^\d+$/.test(e));
+        }
+        catch {
+            return [];
+        }
+    }
+    /** Read a single file from the orphan branch */
+    async readFile(path) {
+        return this.git(['show', `${this.branch}:${path}`]);
+    }
+    /**
+     * Read multiple files in batch.
+     * Returns Map<path, content>. Missing files are omitted.
+     */
+    async readFiles(paths) {
+        const result = new Map();
+        // Use parallel readFile calls (git show is fast for individual files)
+        const settled = await Promise.allSettled(paths.map(async (path) => {
+            const content = await this.readFileOrNull(path);
+            return { path, content };
+        }));
+        for (const entry of settled) {
+            if (entry.status === 'fulfilled' && entry.value.content !== null) {
+                result.set(entry.value.path, entry.value.content);
+            }
+        }
+        return result;
+    }
+    /** Read a file, returning null if it doesn't exist */
+    async readFileOrNull(path) {
+        try {
+            return await this.readFile(path);
+        }
+        catch {
+            return null;
+        }
+    }
+    /** Get the HEAD commit SHA of the orphan branch */
+    async getBranchHead() {
+        try {
+            const sha = await this.git(['rev-parse', this.branch]);
+            return sha.trim();
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Find the Entire-Checkpoint trailer value for a given commit.
+     * Returns the checkpoint ID or null.
+     */
+    async getCheckpointTrailer(commitSha) {
+        try {
+            const output = await this.git([
+                'log',
+                '--format=%(trailers:key=Entire-Checkpoint,valueonly)',
+                commitSha,
+                '-1',
+            ]);
+            const value = output.trim();
+            return value || null;
+        }
+        catch {
+            return null;
+        }
+    }
+    // ── Private ──────────────────────────────────────────────────
+    git(args) {
+        return new Promise((resolve, reject) => {
+            execFile('git', ['-C', this.repoPath, ...args], { maxBuffer: 100 * 1024 * 1024 }, // 100MB for large transcripts
+            (error, stdout, stderr) => {
+                if (error) {
+                    reject(new Error(`git ${args[0]} failed: ${stderr || error.message}`));
+                }
+                else {
+                    resolve(stdout);
+                }
+            });
+        });
+    }
+}
+//# sourceMappingURL=git-reader.js.map

package/dist/session-bank/git-reader.js.map

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