cognitive-core 0.2.1 → 0.2.3

package/dist/learning/pipeline.d.ts

@@ -1,116 +0,0 @@
-import type { Trajectory, LearningConfig } from '../types/index.js';
-import type { TrajectoryWithAnalysis } from '../types/trajectory-source.js';
-import type { MemorySystem } from '../memory/system.js';
-import { type AnalysisResult } from './analyzer.js';
-import type { SqlitePersistence } from '../persistence/index.js';
-import type { AgenticTaskRunner } from '../workspace/runner.js';
-/**
- * Result of processing a single trajectory
- */
-export interface ProcessResult {
-    trajectoryId: string;
-    stored: boolean;
-    analysis: AnalysisResult;
-    abstractable: boolean;
-    playbookExtracted: boolean;
-}
-/**
- * Result of batch learning
- */
-export interface BatchResult {
-    trajectoriesProcessed: number;
-    playbooksExtracted: number;
-    experiencesPruned: number;
-    experiencesCompressed: {
-        promoted: number;
-        demoted: number;
-        evicted: number;
-    };
-    experiencesClustered: number;
-    successRate: number;
-}
-/**
- * Learning Pipeline
- * Orchestrates trajectory analysis, playbook extraction, and memory updates
- */
-/**
- * Feature flags for optional ruvector-inspired subsystems in the batch pipeline.
- */
-export interface PipelineFeatureOptions {
-    /** Enable temporal compression (Hot/Warm/Cold/Evict) in batch pipeline (default: true) */
-    enableTemporalCompression?: boolean;
-    /** Enable experience clustering via ReasoningBank in batch pipeline (default: true) */
-    enableReasoningBank?: boolean;
-}
-export declare class LearningPipeline {
-    private analyzer;
-    private playbookExtractor;
-    private temporalCompressor;
-    private reasoningBank;
-    private memory;
-    private config;
-    private taskRunner;
-    private accumulated;
-    private accumulatedAnalyses;
-    private lastBatchTime;
-    constructor(memory: MemorySystem, config?: Partial<LearningConfig>, featureOptions?: PipelineFeatureOptions, persistence?: SqlitePersistence);
-    /**
-     * Load persisted state for internal components (TemporalCompressor, ReasoningBank).
-     * Call after persistence is initialized.
-     */
-    loadPersistedState(): void;
-    /**
-     * Set the agentic task runner for workspace-based analysis.
-     * When set, analysis tasks are delegated to templates (with heuristic fallback).
-     */
-    setTaskRunner(runner: AgenticTaskRunner): void;
-    /**
-     * Process a single trajectory.
-     * Set skipStore to true if the caller already stored the experience
-     * (e.g., via InstantLoop / LoopCoordinator).
-     */
-    processTrajectory(trajectory: Trajectory, options?: {
-        skipStore?: boolean;
-    }): Promise<ProcessResult>;
-    /**
-     * Run trajectory analysis via the workspace template.
-     * The template's assessComplexity() routes simple cases to heuristicFallback()
-     * (which calls the existing TrajectoryAnalyzer), so this is safe for all inputs.
-     */
-    private analyzeWithTemplate;
-    /**
-     * Check if batch learning should run
-     */
-    shouldRunBatch(): boolean;
-    /**
-     * Run batch learning on accumulated trajectories
-     */
-    runBatchLearning(): Promise<BatchResult>;
-    /**
-     * Run playbook extraction via the workspace template.
-     * Falls back to heuristic extractor on failure.
-     */
-    private extractPlaybooks;
-    /**
-     * Get accumulated trajectory count
-     */
-    getAccumulatedCount(): number;
-    /**
-     * Get accumulated trajectories with their analyses.
-     * Read-only view — does not clear the accumulator.
-     */
-    getAccumulated(): TrajectoryWithAnalysis[];
-    /**
-     * Clear accumulated trajectories
-     */
-    clearAccumulated(): void;
-    /**
-     * Update configuration
-     */
-    updateConfig(config: Partial<LearningConfig>): void;
-}
-/**
- * Create a learning pipeline
- */
-export declare function createLearningPipeline(memory: MemorySystem, config?: Partial<LearningConfig>, featureOptions?: PipelineFeatureOptions, persistence?: SqlitePersistence): LearningPipeline;
-//# sourceMappingURL=pipeline.d.ts.map

package/dist/learning/pipeline.d.ts.map

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

package/dist/learning/pipeline.js

@@ -1,288 +0,0 @@
-import { createAnalyzer, } from './analyzer.js';
-import { createPlaybookExtractor, } from './playbook-extractor.js';
-import { TemporalCompressor } from '../memory/temporal-compressor.js';
-import { ReasoningBank } from '../memory/reasoning-bank.js';
-import { trajectoryAnalysisTemplate } from '../workspace/templates/trajectory-analysis.js';
-import { playbookExtractionTemplate } from '../workspace/templates/playbook-extraction.js';
-export class LearningPipeline {
-    analyzer;
-    playbookExtractor;
-    temporalCompressor;
-    reasoningBank;
-    memory;
-    config;
-    // Optional agentic task runner for workspace-based analysis
-    taskRunner = null;
-    // Accumulated trajectories for batch learning
-    accumulated = [];
-    accumulatedAnalyses = [];
-    lastBatchTime = null;
-    constructor(memory, config, featureOptions, persistence) {
-        this.memory = memory;
-        this.config = {
-            creditStrategy: config?.creditStrategy ?? 'simple',
-            patternExtractor: config?.patternExtractor ?? 'llm',
-            minTrajectories: config?.minTrajectories ?? 10,
-            minHoursSinceLast: config?.minHoursSinceLast,
-            minSuccessRate: config?.minSuccessRate,
-            deduplicationThreshold: config?.deduplicationThreshold ?? 0.9,
-            maxExperiences: config?.maxExperiences ?? 1000,
-        };
-        this.analyzer = createAnalyzer(this.config.creditStrategy);
-        this.temporalCompressor = (featureOptions?.enableTemporalCompression ?? true)
-            ? new TemporalCompressor(undefined, persistence)
-            : null;
-        this.reasoningBank = (featureOptions?.enableReasoningBank ?? true)
-            ? new ReasoningBank(undefined, persistence)
-            : null;
-        this.playbookExtractor = createPlaybookExtractor({
-            minTrajectories: this.config.minTrajectories,
-            mergeThreshold: this.config.deduplicationThreshold,
-            minSuccessRate: this.config.minSuccessRate ?? 0.6,
-        });
-    }
-    /**
-     * Load persisted state for internal components (TemporalCompressor, ReasoningBank).
-     * Call after persistence is initialized.
-     */
-    loadPersistedState() {
-        this.temporalCompressor?.loadPersistedState();
-        this.reasoningBank?.loadPersistedState();
-    }
-    /**
-     * Set the agentic task runner for workspace-based analysis.
-     * When set, analysis tasks are delegated to templates (with heuristic fallback).
-     */
-    setTaskRunner(runner) {
-        this.taskRunner = runner;
-    }
-    /**
-     * Process a single trajectory.
-     * Set skipStore to true if the caller already stored the experience
-     * (e.g., via InstantLoop / LoopCoordinator).
-     */
-    async processTrajectory(trajectory, options) {
-        // Store in experience memory (unless already stored by instant loop)
-        if (!options?.skipStore) {
-            await this.memory.storeTrajectory(trajectory);
-        }
-        // Analyze: workspace-based when runner available, heuristic otherwise
-        let analysis;
-        if (this.taskRunner) {
-            analysis = await this.analyzeWithTemplate(trajectory);
-        }
-        else {
-            analysis = await this.analyzer.analyze(trajectory);
-        }
-        // Accumulate for batch learning
-        this.accumulated.push(trajectory);
-        this.accumulatedAnalyses.push(analysis);
-        return {
-            trajectoryId: trajectory.id,
-            stored: true,
-            analysis,
-            abstractable: analysis.abstractable,
-            playbookExtracted: false, // Playbooks are extracted in batch
-        };
-    }
-    /**
-     * Run trajectory analysis via the workspace template.
-     * The template's assessComplexity() routes simple cases to heuristicFallback()
-     * (which calls the existing TrajectoryAnalyzer), so this is safe for all inputs.
-     */
-    async analyzeWithTemplate(trajectory) {
-        try {
-            const result = await this.taskRunner.run(trajectoryAnalysisTemplate, {
-                trajectory,
-                creditStrategy: this.config.creditStrategy,
-            });
-            return result.output;
-        }
-        catch (error) {
-            // If workspace-based analysis fails, fall back to heuristic
-            console.error('Workspace-based trajectory analysis failed, falling back to heuristic:', error instanceof Error ? error.message : error);
-            return this.analyzer.analyze(trajectory);
-        }
-    }
-    /**
-     * Check if batch learning should run
-     */
-    shouldRunBatch() {
-        // Check minimum trajectories
-        if (this.accumulated.length < this.config.minTrajectories) {
-            return false;
-        }
-        // Check time since last batch
-        if (this.config.minHoursSinceLast && this.lastBatchTime) {
-            const hoursSinceLast = (Date.now() - this.lastBatchTime.getTime()) / (1000 * 60 * 60);
-            if (hoursSinceLast < this.config.minHoursSinceLast) {
-                return false;
-            }
-        }
-        // Check success rate
-        if (this.config.minSuccessRate) {
-            const successCount = this.accumulatedAnalyses.filter((a) => a.success).length;
-            const successRate = successCount / this.accumulated.length;
-            if (successRate < this.config.minSuccessRate) {
-                return false;
-            }
-        }
-        return true;
-    }
-    /**
-     * Run batch learning on accumulated trajectories
-     */
-    async runBatchLearning() {
-        if (this.accumulated.length === 0) {
-            return {
-                trajectoriesProcessed: 0,
-                playbooksExtracted: 0,
-                experiencesPruned: 0,
-                experiencesCompressed: { promoted: 0, demoted: 0, evicted: 0 },
-                experiencesClustered: 0,
-                successRate: 0,
-            };
-        }
-        // Extract playbooks: workspace-based when runner available, heuristic otherwise
-        let playbooksAdded = 0;
-        const existingPlaybooks = await this.memory.playbooks.getAll();
-        const playbookExtraction = await this.extractPlaybooks(existingPlaybooks);
-        // Add new playbooks
-        for (const playbook of playbookExtraction.new) {
-            const exists = await this.memory.playbooks.exists(playbook.name, this.config.deduplicationThreshold);
-            if (!exists) {
-                await this.memory.playbooks.add(playbook);
-                playbooksAdded++;
-            }
-        }
-        // Apply updates to existing playbooks
-        for (const update of playbookExtraction.updates) {
-            if (update.refinement) {
-                await this.memory.playbooks.addRefinement(update.id, update.refinement.context, update.refinement.addition, update.refinement.source);
-            }
-            if (update.newTrigger) {
-                const playbook = await this.memory.playbooks.get(update.id);
-                if (playbook && !playbook.applicability.triggers.includes(update.newTrigger)) {
-                    playbook.applicability.triggers.push(update.newTrigger);
-                    await this.memory.playbooks.add(playbook);
-                }
-            }
-            if (update.newAntiPattern) {
-                const playbook = await this.memory.playbooks.get(update.id);
-                if (playbook && !playbook.applicability.antiPatterns.includes(update.newAntiPattern)) {
-                    playbook.applicability.antiPatterns.push(update.newAntiPattern);
-                    await this.memory.playbooks.add(playbook);
-                }
-            }
-        }
-        // Temporal compression pass — run after extraction so full-fidelity
-        // experience data is available for playbook extraction before compression
-        let compressionEvicted = 0;
-        let compressionPromoted = 0;
-        let compressionDemoted = 0;
-        if (this.temporalCompressor) {
-            const allExperiences = await this.memory.experiences.getAll();
-            const compressionResult = await this.temporalCompressor.compress(allExperiences);
-            // Apply compression updates (tier changes, compressed data)
-            for (const [id, updates] of compressionResult.updates) {
-                await this.memory.experiences.update(id, updates);
-            }
-            // Evict experiences whose patterns should already be captured in clusters
-            for (const id of compressionResult.evicted) {
-                await this.memory.experiences.delete(id);
-            }
-            compressionEvicted = compressionResult.evicted.length;
-            compressionPromoted = compressionResult.promoted.length;
-            compressionDemoted = compressionResult.demoted.length;
-        }
-        // Re-cluster experiences in the ReasoningBank for faster retrieval.
-        // Uses post-compression experience set so clusters reflect current state.
-        const currentExperiences = await this.memory.experiences.getAll();
-        if (this.reasoningBank) {
-            this.reasoningBank.buildClusters(currentExperiences);
-        }
-        // Prune experiences if needed
-        const pruned = await this.memory.experiences.prune({
-            maxCount: this.config.maxExperiences,
-        });
-        // Calculate success rate
-        const successCount = this.accumulatedAnalyses.filter((a) => a.success).length;
-        const successRate = successCount / this.accumulated.length;
-        // Clear accumulated and update time
-        const trajectoriesProcessed = this.accumulated.length;
-        this.accumulated = [];
-        this.accumulatedAnalyses = [];
-        this.lastBatchTime = new Date();
-        return {
-            trajectoriesProcessed,
-            playbooksExtracted: playbooksAdded,
-            experiencesPruned: pruned.totalPruned + compressionEvicted,
-            experiencesCompressed: {
-                promoted: compressionPromoted,
-                demoted: compressionDemoted,
-                evicted: compressionEvicted,
-            },
-            experiencesClustered: currentExperiences.length,
-            successRate,
-        };
-    }
-    /**
-     * Run playbook extraction via the workspace template.
-     * Falls back to heuristic extractor on failure.
-     */
-    async extractPlaybooks(existingPlaybooks) {
-        if (this.taskRunner) {
-            try {
-                const result = await this.taskRunner.run(playbookExtractionTemplate, {
-                    trajectories: this.accumulated,
-                    analyses: this.accumulatedAnalyses,
-                    existingPlaybooks,
-                });
-                return result.output;
-            }
-            catch (error) {
-                console.error('Workspace-based playbook extraction failed, falling back to heuristic:', error instanceof Error ? error.message : error);
-            }
-        }
-        return this.playbookExtractor.extract(this.accumulated, this.accumulatedAnalyses, existingPlaybooks);
-    }
-    /**
-     * Get accumulated trajectory count
-     */
-    getAccumulatedCount() {
-        return this.accumulated.length;
-    }
-    /**
-     * Get accumulated trajectories with their analyses.
-     * Read-only view — does not clear the accumulator.
-     */
-    getAccumulated() {
-        return this.accumulated.map((trajectory, i) => ({
-            trajectory,
-            analysis: this.accumulatedAnalyses[i],
-        }));
-    }
-    /**
-     * Clear accumulated trajectories
-     */
-    clearAccumulated() {
-        this.accumulated = [];
-        this.accumulatedAnalyses = [];
-    }
-    /**
-     * Update configuration
-     */
-    updateConfig(config) {
-        this.config = { ...this.config, ...config };
-        if (config.creditStrategy) {
-            this.analyzer.setStrategy(config.creditStrategy);
-        }
-    }
-}
-/**
- * Create a learning pipeline
- */
-export function createLearningPipeline(memory, config, featureOptions, persistence) {
-    return new LearningPipeline(memory, config, featureOptions, persistence);
-}
-//# sourceMappingURL=pipeline.js.map

package/dist/learning/pipeline.js.map

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

package/references/agent-workspace/CLAUDE.md

@@ -1,74 +0,0 @@
-# CLAUDE.md
-
-## Project overview
-
-`agent-workspace` is a TypeScript library for managing filesystem workspaces used by AI agents. It provides structured directory layouts, typed readers/writers (JSON, JSONL, Markdown with YAML frontmatter, raw text), and output validation with structured error collection.
-
-## Commands
-
-- `npm test` — run all tests (vitest)
-- `npm run test:watch` — run tests in watch mode
-- `npm run build` — build with tsup (outputs to `dist/`)
-- `npm run typecheck` — type-check without emitting
-
-## Architecture
-
-```
-src/
-  index.ts          ← public API, re-exports everything
-  types.ts          ← all shared types (Schema, OutputSpec, ValidationResult, etc.)
-  manager.ts        ← WorkspaceManager: create, list, cleanup, pruneStale
-  handle.ts         ← WorkspaceHandle: section-scoped I/O facade over readers/writers
-  validation.ts     ← validateOutput: non-throwing batch output checker
-  readers/
-    json.ts         ← readJson, readJsonl, readJsonDir
-    markdown.ts     ← readMarkdown (with YAML frontmatter parsing via `yaml` package)
-    raw.ts          ← readRaw, listFiles
-  writers/
-    json.ts         ← writeJson, writeJsonl
-    markdown.ts     ← writeMarkdown (with YAML frontmatter serialization)
-    raw.ts          ← writeRaw, copyDir, symlink
-
-tests/
-  readers.test.ts   ← standalone reader function tests
-  writers.test.ts   ← standalone writer function tests
-  handle.test.ts    ← WorkspaceHandle round-trip and section tests
-  manager.test.ts   ← WorkspaceManager lifecycle tests
-  validation.test.ts ← validateOutput tests
-  errors.test.ts    ← comprehensive parse/validation error behavior tests
-```
-
-## Key design decisions
-
-- **Two error strategies**: Reader functions **throw** on errors (for try/catch recovery). `validateOutput` **collects** errors into `{ valid, errors }` (for batch checking). Never mix these — readers always throw, validation never throws.
-- **Schema interface**: `{ parse(data: unknown): T }` — deliberately minimal so it works with Zod, Joi, or any custom implementation. `parse` must throw on invalid data.
-- **Section-scoped I/O**: `WorkspaceHandle` methods take a section name (`'input'`, `'output'`, `'resources'`, `'scratch'`, or custom) as the first argument. `handle.dir(section)` throws synchronously if the section is unknown.
-- **Default dirs**: `input`, `output`, `resources`, `scratch` are always created. Additional dirs are specified at `manager.create()` time.
-- **Workspace metadata**: Each workspace writes `.workspace.json` with `{ id, taskType, createdAt, dirs }`. The manager uses this to reconstruct handles when listing.
-
-## Conventions
-
-- ESM-first (`"type": "module"` in package.json), dual CJS/ESM output via tsup.
-- All file path parameters in readers/writers are relative to the `dir` argument. Writers auto-create parent directories via `fs.mkdir({ recursive: true })`.
-- Tests use temp directories (`os.tmpdir()` + `fs.mkdtemp`) and clean up in `afterEach`.
-- No external dependencies except `yaml` for YAML parsing/serialization.
-- TypeScript strict mode. Target ES2022.
-
-## Error message contracts
-
-Error messages are intentionally detailed to support agent re-prompting:
-
-- `readJson` on bad JSON: native `JSON.parse` SyntaxError
-- `readJson` schema failure: the schema's own error message (e.g., Zod's)
-- `readJsonl` schema failure: `"JSONL validation failed at line N: <schema error>"`
-- `handle.dir()` unknown section: `'Unknown section "X". Available: input, output, ...'`
-- `validateOutput` errors: `{ path: string, message: string }` — path identifies the file, message describes the issue
-
-## Testing
-
-The test suite has 101 tests across 6 files. When adding new functionality:
-
-- Add happy-path tests to the relevant existing test file (`readers.test.ts`, `handle.test.ts`, etc.)
-- Add error/throw behavior tests to `errors.test.ts`
-- All reader error paths must be tested: missing file, malformed content, schema rejection
-- Validation tests must verify that errors are **collected** (not thrown) and include both `path` and `message`