cognitive-core 0.1.0 → 0.2.0

package/dist/workspace/templates/knowledge-extraction.js

@@ -0,0 +1,246 @@
+/**
+ * Knowledge Extraction Template
+ *
+ * Extracts factual knowledge from agent trajectories using the
+ * AgenticTaskTemplate pattern. Routes simple trajectories to the
+ * heuristic KnowledgeExtractor, and complex ones to an agent.
+ *
+ * - Short successful trajectories (≤5 steps) → heuristic fallback
+ * - Medium trajectories (5-15 steps) → lightweight agent
+ * - Long or failed trajectories → standard agent
+ */
+import { KnowledgeExtractor } from '../../learning/knowledge-extractor.js';
+import { serializeKnowledgeNote } from '../../utils/frontmatter.js';
+// Output is ExtractedKnowledge (from types/knowledge.ts)
+// ============================================================
+// Template Implementation
+// ============================================================
+export const knowledgeExtractionTemplate = {
+    taskType: 'knowledge-extraction',
+    domain: 'knowledge-extraction',
+    description: 'Extract factual knowledge from agent trajectories — observations, entity updates, and cross-references',
+    // === COMPLEXITY ASSESSMENT ===
+    assessComplexity(input) {
+        const { trajectory } = input;
+        // Short successful trajectories → heuristic (KnowledgeExtractor is fine)
+        if (trajectory.steps.length <= 5 && trajectory.outcome.success) {
+            return 'heuristic';
+        }
+        // Very short trajectories even if failed → lightweight
+        if (trajectory.steps.length <= 3) {
+            return 'lightweight';
+        }
+        // Failed trajectories benefit from semantic analysis
+        if (!trajectory.outcome.success) {
+            return 'standard';
+        }
+        // Long trajectories need agent to identify what's worth extracting
+        if (trajectory.steps.length > 15) {
+            return 'standard';
+        }
+        return 'lightweight';
+    },
+    // === HEURISTIC FALLBACK ===
+    async heuristicFallback(input) {
+        const extractor = new KnowledgeExtractor();
+        return extractor.extract(input.trajectory, input.analysis, {
+            existingEntities: input.existingEntities,
+        });
+    },
+    // === WORKSPACE SETUP ===
+    async prepareWorkspace(input, handle) {
+        const { trajectory, analysis, existingEntities, relatedNotes } = input;
+        // Write trajectory context
+        await handle.writeJson('input', 'context.json', {
+            taskId: trajectory.task.id,
+            taskDomain: trajectory.task.domain,
+            taskDescription: trajectory.task.description,
+            outcome: {
+                success: trajectory.outcome.success,
+                partialScore: trajectory.outcome.partialScore,
+                errorInfo: trajectory.outcome.errorInfo,
+            },
+            stepCount: trajectory.steps.length,
+            wallTimeSeconds: trajectory.wallTimeSeconds,
+            llmCalls: trajectory.llmCalls,
+        });
+        // Write steps as JSONL
+        await handle.writeJsonl('input', 'steps.jsonl', trajectory.steps.map((step, i) => ({
+            index: i,
+            thought: step.thought,
+            action: step.action,
+            observation: step.observation,
+            metadata: step.metadata,
+            attributionScore: step.attributionScore,
+        })));
+        // Write pre-computed analysis
+        await handle.writeJson('input', 'analysis.json', {
+            success: analysis.success,
+            keySteps: analysis.keySteps,
+            errorPatterns: analysis.errorPatterns,
+            abstractable: analysis.abstractable,
+        });
+        // Write existing entities for reference
+        await handle.writeJson('resources', 'existing-entities.json', {
+            entities: existingEntities,
+        });
+        // Write related knowledge notes as markdown files
+        for (const note of relatedNotes.slice(0, 20)) {
+            const filename = `${note.frontmatter.id}.md`;
+            const content = serializeKnowledgeNote(note);
+            await handle.writeRaw('resources', `related-notes/${filename}`, content);
+        }
+    },
+    // === PROMPT ===
+    buildTaskPrompt(input) {
+        const { trajectory } = input;
+        const outcomeStr = trajectory.outcome.success ? 'SUCCESSFUL' : 'FAILED';
+        return [
+            `Extract factual knowledge from this ${outcomeStr} agent trajectory (${trajectory.steps.length} steps, domain: ${trajectory.task.domain}).`,
+            '',
+            'Read the trajectory from input/context.json, input/steps.jsonl, and input/analysis.json.',
+            'Reference existing entities in resources/existing-entities.json.',
+            'Review related knowledge notes in resources/related-notes/ to avoid duplicates.',
+            '',
+            'Extract the following types of knowledge:',
+            '',
+            '1. **Observations**: Atomic facts learned from this trajectory.',
+            '   - Error patterns and their fixes',
+            '   - Configuration requirements and constraints',
+            '   - Tool/library behaviors discovered',
+            '   - Causal relationships (what caused what)',
+            '',
+            '2. **Entity Updates**: New information about known entities.',
+            '   - If an entity already exists (see existing-entities.json), produce an update',
+            '   - Include the evidence source (trajectory ID)',
+            '',
+            '3. **Links**: Relationships between knowledge notes.',
+            '   - Use relations: related-to, depends-on, caused-by, led-to, uses, supports',
+            '',
+            'Write your extraction to output/extraction.json with this schema:',
+            '```json',
+            '{',
+            '  "observations": [',
+            '    {',
+            '      "title": "string",',
+            '      "body": "string (markdown)",',
+            '      "domain": ["string"],',
+            '      "entities": ["string"],',
+            '      "tags": ["string"],',
+            '      "confidence": 0.3',
+            '    }',
+            '  ],',
+            '  "entityUpdates": [',
+            '    {',
+            '      "entityId": "string (kebab-case slug)",',
+            '      "section": "string (markdown section to append)",',
+            '      "trajectoryId": "string"',
+            '    }',
+            '  ],',
+            '  "links": [',
+            '    {',
+            '      "from": "string (note ID)",',
+            '      "to": "string (note ID)",',
+            '      "relation": "string"',
+            '    }',
+            '  ]',
+            '}',
+            '```',
+            '',
+            'Guidelines:',
+            '- Each observation should be a single atomic fact',
+            '- Confidence should be 0.3 for single-observation facts',
+            '- Use kebab-case for entity IDs (e.g., "prisma", "next-js")',
+            '- Only extract knowledge that is genuinely useful for future tasks',
+        ].join('\n');
+    },
+    // === SKILLS & RESOURCES ===
+    getSkills() {
+        return [];
+    },
+    getResources() {
+        return [];
+    },
+    // === OUTPUT ===
+    outputConfig: {
+        files: [
+            {
+                path: 'extraction.json',
+                format: 'json',
+                required: true,
+                description: 'Extracted knowledge: observations, entity updates, and links',
+            },
+        ],
+    },
+    async collectOutput(handle) {
+        const raw = await handle.readJson('output', 'extraction.json');
+        const data = raw;
+        // Parse observations into KnowledgeNote format
+        const rawObs = Array.isArray(data.observations) ? data.observations : [];
+        const observations = [];
+        for (const obs of rawObs) {
+            if (typeof obs !== 'object' || obs === null)
+                continue;
+            const o = obs;
+            const { createObservation } = await import('../../types/knowledge.js');
+            observations.push(createObservation({
+                title: String(o.title ?? 'Untitled'),
+                body: String(o.body ?? ''),
+                domain: Array.isArray(o.domain)
+                    ? o.domain.map(String)
+                    : ['unknown'],
+                entities: Array.isArray(o.entities) ? o.entities.map(String) : [],
+                tags: Array.isArray(o.tags) ? o.tags.map(String) : [],
+                confidence: typeof o.confidence === 'number' ? o.confidence : 0.3,
+                source: { origin: 'extracted' },
+            }));
+        }
+        // Parse entity updates
+        const rawUpdates = Array.isArray(data.entityUpdates)
+            ? data.entityUpdates
+            : [];
+        const entityUpdates = rawUpdates
+            .filter((u) => typeof u === 'object' && u !== null)
+            .map((u) => ({
+            entityId: String(u.entityId ?? ''),
+            section: String(u.section ?? ''),
+            trajectoryId: String(u.trajectoryId ?? ''),
+        }));
+        // Parse links
+        const rawLinks = Array.isArray(data.links) ? data.links : [];
+        const links = rawLinks
+            .filter((l) => typeof l === 'object' && l !== null)
+            .map((l) => ({
+            from: String(l.from ?? ''),
+            to: String(l.to ?? ''),
+            relation: String(l.relation ?? 'related-to'),
+        }));
+        return {
+            observations,
+            entityUpdates,
+            contradictions: [],
+            links,
+            playbookLinks: [],
+        };
+    },
+    async processOutput(_output, _input, _context) {
+        // No-op: caller handles applying the extraction via applyExtraction()
+    },
+    // === COMPUTE ===
+    computeRequirements: {
+        mode: 'local',
+        complexity: 'lightweight',
+    },
+    getComputeRequirements(_input, complexity) {
+        return {
+            mode: 'local',
+            complexity,
+            timeout: complexity === 'standard' ? 180_000 : 60_000,
+        };
+    },
+    // === CONFIG ===
+    agentType: 'claude-code',
+    timeout: 120_000,
+    captureToolCalls: true,
+};
+//# sourceMappingURL=knowledge-extraction.js.map

package/dist/workspace/templates/knowledge-extraction.js.map

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

package/dist/workspace/templates/meta-reflection.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Meta-Reflection Template
+ *
+ * Replaces MetaLearner.generateReflection() with workspace-based
+ * semantic reflection that analyzes what worked and why.
+ *
+ * - Clear success with high confidence routing → heuristic fallback
+ * - Failures or uncertain outcomes → agent reflects on execution
+ */
+import type { Trajectory } from '../../types/index.js';
+import type { PlaybookMatch } from '../../memory/playbook.js';
+import type { AgenticTaskTemplate } from '../types.js';
+export interface MetaReflectionInput {
+    trajectory: Trajectory;
+    routingDecision: {
+        strategy: string;
+        confidence: number;
+        estimatedBudget: number;
+        reasoning: string;
+    };
+    playbooksUsed: PlaybookMatch[];
+}
+/**
+ * Simplified meta-reflection output.
+ * The full MetaObservation is constructed by the MetaLearner after
+ * receiving this output, so we only need the core reflection data.
+ */
+export interface MetaReflectionOutput {
+    /** Was the retrieval helpful, neutral, or misleading? */
+    retrievalQuality: 'helpful' | 'neutral' | 'misleading';
+    /** Overall outcome quality */
+    outcomeQuality: 'excellent' | 'good' | 'acceptable' | 'poor';
+    /** What worked well */
+    whatWorked: string[];
+    /** What failed or was suboptimal */
+    whatFailed: string[];
+    /** Suggestions for improvement */
+    suggestions: string[];
+    /** Whether decomposition was used */
+    decompositionUsed: boolean;
+    /** Whether backtracking occurred */
+    backtrackingOccurred: boolean;
+    /** Estimated refinement iterations */
+    refinementIterations: number;
+}
+export declare const metaReflectionTemplate: AgenticTaskTemplate<MetaReflectionInput, MetaReflectionOutput>;
+//# sourceMappingURL=meta-reflection.d.ts.map

package/dist/workspace/templates/meta-reflection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"meta-reflection.d.ts","sourceRoot":"","sources":["../../../src/workspace/templates/meta-reflection.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,KAAK,EACV,mBAAmB,EAEpB,MAAM,aAAa,CAAC;AAMrB,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,UAAU,CAAC;IACvB,eAAe,EAAE;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,MAAM,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,aAAa,EAAE,aAAa,EAAE,CAAC;CAChC;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,yDAAyD;IACzD,gBAAgB,EAAE,SAAS,GAAG,SAAS,GAAG,YAAY,CAAC;IACvD,8BAA8B;IAC9B,cAAc,EAAE,WAAW,GAAG,MAAM,GAAG,YAAY,GAAG,MAAM,CAAC;IAC7D,uBAAuB;IACvB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,oCAAoC;IACpC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,kCAAkC;IAClC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,qCAAqC;IACrC,iBAAiB,EAAE,OAAO,CAAC;IAC3B,oCAAoC;IACpC,oBAAoB,EAAE,OAAO,CAAC;IAC9B,sCAAsC;IACtC,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAMD,eAAO,MAAM,sBAAsB,EAAE,mBAAmB,CACtD,mBAAmB,EACnB,oBAAoB,CAgJrB,CAAC"}

package/dist/workspace/templates/meta-reflection.js

@@ -0,0 +1,135 @@
+/**
+ * Meta-Reflection Template
+ *
+ * Replaces MetaLearner.generateReflection() with workspace-based
+ * semantic reflection that analyzes what worked and why.
+ *
+ * - Clear success with high confidence routing → heuristic fallback
+ * - Failures or uncertain outcomes → agent reflects on execution
+ */
+// ============================================================
+// Template Implementation
+// ============================================================
+export const metaReflectionTemplate = {
+    taskType: 'meta-reflection',
+    domain: 'meta-reflection',
+    description: 'Reflect on task execution to generate meta-learning observations',
+    assessComplexity(input) {
+        // Clear success with high confidence → heuristic
+        if (input.trajectory.outcome.success &&
+            input.routingDecision.confidence > 0.8) {
+            return 'heuristic';
+        }
+        return 'lightweight';
+    },
+    async heuristicFallback(input) {
+        const { trajectory, routingDecision, playbooksUsed } = input;
+        const wasSuccessful = trajectory.outcome.success;
+        const actualEffort = trajectory.llmCalls ?? trajectory.steps.length;
+        const effortRatio = actualEffort / routingDecision.estimatedBudget;
+        return {
+            retrievalQuality: playbooksUsed.length === 0 ? 'neutral'
+                : wasSuccessful ? 'helpful' : 'neutral',
+            outcomeQuality: !wasSuccessful ? 'poor'
+                : effortRatio <= 0.5 ? 'excellent'
+                    : effortRatio <= 1.0 ? 'good'
+                        : effortRatio <= 2.0 ? 'acceptable' : 'poor',
+            whatWorked: wasSuccessful
+                ? [`${routingDecision.strategy} routing led to success`]
+                : [],
+            whatFailed: wasSuccessful
+                ? []
+                : [`${routingDecision.strategy} routing did not lead to success`],
+            suggestions: wasSuccessful ? [] : ['Consider alternative approaches'],
+            decompositionUsed: trajectory.steps.some(s => s.thought?.includes('break') || s.thought?.includes('step by step')),
+            backtrackingOccurred: false,
+            refinementIterations: 0,
+        };
+    },
+    async prepareWorkspace(input, handle) {
+        const { trajectory, routingDecision, playbooksUsed } = input;
+        await handle.writeJson('input', 'context.json', {
+            routing: routingDecision,
+            outcome: trajectory.outcome,
+            stepCount: trajectory.steps.length,
+            wallTimeSeconds: trajectory.wallTimeSeconds,
+            playbooksInjected: playbooksUsed.map(pm => ({
+                name: pm.playbook.name,
+                strategy: pm.playbook.guidance.strategy,
+                score: pm.score,
+                matchType: pm.matchType,
+            })),
+        });
+        await handle.writeJsonl('input', 'steps.jsonl', trajectory.steps.map((step, i) => ({
+            index: i,
+            thought: step.thought?.slice(0, 200),
+            action: step.action.slice(0, 200),
+            observation: step.observation?.slice(0, 200),
+        })));
+    },
+    buildTaskPrompt(input) {
+        const outcome = input.trajectory.outcome.success ? 'SUCCESSFUL' : 'FAILED';
+        return [
+            `Reflect on this ${outcome} task execution.`,
+            '',
+            'Read input/context.json for routing decision and outcome.',
+            'Read input/steps.jsonl for the execution trace.',
+            '',
+            'Analyze:',
+            '1. Was the retrieved knowledge helpful, neutral, or misleading?',
+            '2. What outcome quality level (excellent/good/acceptable/poor)?',
+            '3. What worked well? What failed?',
+            '4. What suggestions for future similar tasks?',
+            '5. Was decomposition used? Did backtracking occur?',
+            '',
+            'Write to output/reflection.json with this schema:',
+            '```json',
+            '{',
+            '  "retrievalQuality": "helpful" | "neutral" | "misleading",',
+            '  "outcomeQuality": "excellent" | "good" | "acceptable" | "poor",',
+            '  "whatWorked": ["..."],',
+            '  "whatFailed": ["..."],',
+            '  "suggestions": ["..."],',
+            '  "decompositionUsed": boolean,',
+            '  "backtrackingOccurred": boolean,',
+            '  "refinementIterations": number',
+            '}',
+            '```',
+        ].join('\n');
+    },
+    getSkills() { return []; },
+    getResources() { return []; },
+    outputConfig: {
+        files: [{
+                path: 'reflection.json',
+                format: 'json',
+                required: true,
+                description: 'Meta-reflection on task execution',
+            }],
+    },
+    async collectOutput(handle) {
+        const raw = await handle.readJson('output', 'reflection.json');
+        return {
+            retrievalQuality: (['helpful', 'neutral', 'misleading'].includes(String(raw.retrievalQuality))
+                ? raw.retrievalQuality : 'neutral'),
+            outcomeQuality: (['excellent', 'good', 'acceptable', 'poor'].includes(String(raw.outcomeQuality))
+                ? raw.outcomeQuality : 'poor'),
+            whatWorked: Array.isArray(raw.whatWorked) ? raw.whatWorked.map(String) : [],
+            whatFailed: Array.isArray(raw.whatFailed) ? raw.whatFailed.map(String) : [],
+            suggestions: Array.isArray(raw.suggestions) ? raw.suggestions.map(String) : [],
+            decompositionUsed: Boolean(raw.decompositionUsed),
+            backtrackingOccurred: Boolean(raw.backtrackingOccurred),
+            refinementIterations: typeof raw.refinementIterations === 'number'
+                ? raw.refinementIterations : 0,
+        };
+    },
+    async processOutput() { },
+    agentType: 'claude-code',
+    timeout: 120_000,
+    captureToolCalls: true,
+    computeRequirements: {
+        mode: 'local',
+        complexity: 'lightweight',
+    },
+};
+//# sourceMappingURL=meta-reflection.js.map

package/dist/workspace/templates/meta-reflection.js.map

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

package/dist/workspace/templates/playbook-extraction.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Playbook Extraction Template
+ *
+ * Replaces both PlaybookExtractor (heuristic) and LLMPlaybookExtractor
+ * with a unified workspace-based agentic extraction.
+ *
+ * - Small batches (<=3 trajectories) → heuristic fallback
+ * - Larger batches → agent semantically identifies patterns and creates playbooks
+ */
+import type { Trajectory, Playbook } from '../../types/index.js';
+import type { AnalysisResult } from '../../learning/analyzer.js';
+import type { ExtractedPlaybooks } from '../../learning/playbook-extractor.js';
+import type { AgenticTaskTemplate } from '../types.js';
+export interface PlaybookExtractionInput {
+    trajectories: Trajectory[];
+    analyses: AnalysisResult[];
+    existingPlaybooks: Playbook[];
+}
+export declare const playbookExtractionTemplate: AgenticTaskTemplate<PlaybookExtractionInput, ExtractedPlaybooks>;
+//# sourceMappingURL=playbook-extraction.d.ts.map

package/dist/workspace/templates/playbook-extraction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playbook-extraction.d.ts","sourceRoot":"","sources":["../../../src/workspace/templates/playbook-extraction.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,KAAK,EACV,kBAAkB,EACnB,MAAM,sCAAsC,CAAC;AAE9C,OAAO,KAAK,EACV,mBAAmB,EAEpB,MAAM,aAAa,CAAC;AAOrB,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,UAAU,EAAE,CAAC;IAC3B,QAAQ,EAAE,cAAc,EAAE,CAAC;IAC3B,iBAAiB,EAAE,QAAQ,EAAE,CAAC;CAC/B;AAQD,eAAO,MAAM,0BAA0B,EAAE,mBAAmB,CAC1D,uBAAuB,EACvB,kBAAkB,CAsMnB,CAAC"}