cognitive-core 0.2.4 → 0.3.1

package/dist/learning/compound-bootstrap/workspace-analyzer.js

@@ -0,0 +1,379 @@
+/**
+ * Workspace Analyzer
+ *
+ * Deterministic extraction of domain signals from a workspace:
+ * README, package manifests, directory structure, test patterns.
+ * No LLM calls — pure parsing and pattern matching.
+ */
+import { readFile, readdir } from 'node:fs/promises';
+import { join, extname } from 'node:path';
+const MANIFEST_FILES = {
+    'package.json': parsePackageJson,
+    'Cargo.toml': parseCargoToml,
+    'go.mod': parseGoMod,
+    'requirements.txt': parseRequirementsTxt,
+    'pyproject.toml': parsePyprojectToml,
+};
+const README_FILES = ['README.md', 'README', 'README.rst', 'README.txt'];
+const CONTRIBUTING_FILES = ['CONTRIBUTING.md', 'CONTRIBUTING'];
+export async function analyzeWorkspace(workspacePath) {
+    const analysis = {
+        languages: [],
+        frameworks: [],
+        dependencies: [],
+        structurePatterns: [],
+        testCommands: [],
+        setupCommands: [],
+        readmeObservations: [],
+    };
+    const entries = await safeReaddir(workspacePath);
+    if (!entries)
+        return analysis;
+    // 1. Parse manifest files
+    for (const [filename, parser] of Object.entries(MANIFEST_FILES)) {
+        if (entries.includes(filename)) {
+            const content = await safeReadFile(join(workspacePath, filename));
+            if (content) {
+                const partial = parser(content);
+                mergeAnalysis(analysis, partial);
+            }
+        }
+    }
+    // 2. Parse README
+    for (const readme of README_FILES) {
+        if (entries.includes(readme)) {
+            const content = await safeReadFile(join(workspacePath, readme));
+            if (content) {
+                analysis.readmeObservations.push(...extractReadmeObservations(content));
+                analysis.testCommands.push(...extractCommands(content, 'test'));
+                analysis.setupCommands.push(...extractCommands(content, 'install|setup|build|start'));
+                break;
+            }
+        }
+    }
+    // 3. Parse CONTRIBUTING
+    for (const contrib of CONTRIBUTING_FILES) {
+        if (entries.includes(contrib)) {
+            const content = await safeReadFile(join(workspacePath, contrib));
+            if (content) {
+                analysis.readmeObservations.push(...extractReadmeObservations(content));
+                analysis.testCommands.push(...extractCommands(content, 'test'));
+                break;
+            }
+        }
+    }
+    // 4. Scan directory structure
+    analysis.structurePatterns.push(...detectStructurePatterns(entries));
+    // 5. Infer languages from file extensions
+    analysis.languages.push(...inferLanguages(entries));
+    analysis.languages = [...new Set(analysis.languages)];
+    // Deduplicate
+    analysis.frameworks = [...new Set(analysis.frameworks)];
+    analysis.testCommands = [...new Set(analysis.testCommands)];
+    analysis.setupCommands = [...new Set(analysis.setupCommands)];
+    return analysis;
+}
+function parsePackageJson(content) {
+    try {
+        const pkg = JSON.parse(content);
+        const result = {
+            languages: ['typescript', 'javascript'],
+            frameworks: [],
+            dependencies: [],
+            projectName: pkg.name,
+            testCommands: [],
+            setupCommands: [],
+        };
+        const allDeps = {};
+        for (const [name, version] of Object.entries(pkg.dependencies ?? {})) {
+            allDeps[name] = [version, 'runtime'];
+        }
+        for (const [name, version] of Object.entries(pkg.devDependencies ?? {})) {
+            allDeps[name] = [version, 'dev'];
+        }
+        for (const [name, [version, type]] of Object.entries(allDeps)) {
+            result.dependencies.push({
+                name,
+                version: version.replace(/^[\^~>=<]/, ''),
+                type,
+                ecosystem: 'npm',
+            });
+        }
+        // Detect frameworks from dependencies
+        const depNames = new Set(Object.keys(allDeps));
+        if (depNames.has('react') || depNames.has('react-dom'))
+            result.frameworks.push('react');
+        if (depNames.has('next'))
+            result.frameworks.push('next');
+        if (depNames.has('express'))
+            result.frameworks.push('express');
+        if (depNames.has('fastify'))
+            result.frameworks.push('fastify');
+        if (depNames.has('vue'))
+            result.frameworks.push('vue');
+        if (depNames.has('svelte'))
+            result.frameworks.push('svelte');
+        if (depNames.has('angular') || depNames.has('@angular/core'))
+            result.frameworks.push('angular');
+        if (depNames.has('vitest'))
+            result.frameworks.push('vitest');
+        if (depNames.has('jest'))
+            result.frameworks.push('jest');
+        if (depNames.has('mocha'))
+            result.frameworks.push('mocha');
+        // Extract scripts
+        if (pkg.scripts?.test)
+            result.testCommands.push(`npm test`);
+        if (pkg.scripts?.build)
+            result.setupCommands.push(`npm run build`);
+        if (pkg.scripts?.start)
+            result.setupCommands.push(`npm start`);
+        // Detect TypeScript
+        if (depNames.has('typescript') || depNames.has('ts-node')) {
+            result.languages = ['typescript'];
+        }
+        return result;
+    }
+    catch {
+        return {};
+    }
+}
+function parseCargoToml(content) {
+    const result = {
+        languages: ['rust'],
+        frameworks: [],
+        dependencies: [],
+        testCommands: ['cargo test'],
+        setupCommands: ['cargo build'],
+    };
+    const depSection = /\[dependencies\]([\s\S]*?)(?:\[|$)/;
+    const match = content.match(depSection);
+    if (match) {
+        const lines = match[1].split('\n');
+        for (const line of lines) {
+            const depMatch = line.match(/^(\S+)\s*=\s*"([^"]+)"/);
+            if (depMatch) {
+                result.dependencies.push({
+                    name: depMatch[1],
+                    version: depMatch[2],
+                    type: 'runtime',
+                    ecosystem: 'cargo',
+                });
+            }
+        }
+    }
+    // Detect frameworks
+    const depNames = result.dependencies.map((d) => d.name);
+    if (depNames.includes('actix-web'))
+        result.frameworks.push('actix');
+    if (depNames.includes('axum'))
+        result.frameworks.push('axum');
+    if (depNames.includes('tokio'))
+        result.frameworks.push('tokio');
+    if (depNames.includes('rocket'))
+        result.frameworks.push('rocket');
+    return result;
+}
+function parseGoMod(content) {
+    const result = {
+        languages: ['go'],
+        frameworks: [],
+        dependencies: [],
+        testCommands: ['go test ./...'],
+        setupCommands: ['go build'],
+    };
+    const lines = content.split('\n');
+    let inRequire = false;
+    for (const line of lines) {
+        if (line.trim() === 'require (') {
+            inRequire = true;
+            continue;
+        }
+        if (line.trim() === ')') {
+            inRequire = false;
+            continue;
+        }
+        if (inRequire) {
+            const match = line.trim().match(/^(\S+)\s+(\S+)/);
+            if (match) {
+                result.dependencies.push({
+                    name: match[1],
+                    version: match[2],
+                    type: 'runtime',
+                    ecosystem: 'go',
+                });
+            }
+        }
+        const moduleMatch = line.match(/^module\s+(\S+)/);
+        if (moduleMatch) {
+            result.projectName = moduleMatch[1];
+        }
+    }
+    return result;
+}
+function parseRequirementsTxt(content) {
+    const result = {
+        languages: ['python'],
+        frameworks: [],
+        dependencies: [],
+        testCommands: ['pytest'],
+    };
+    for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#'))
+            continue;
+        const match = trimmed.match(/^([a-zA-Z0-9_-]+)(?:[=<>!~]+(.+))?/);
+        if (match) {
+            result.dependencies.push({
+                name: match[1],
+                version: match[2],
+                type: 'runtime',
+                ecosystem: 'pip',
+            });
+        }
+    }
+    const depNames = result.dependencies.map((d) => d.name.toLowerCase());
+    if (depNames.includes('django'))
+        result.frameworks.push('django');
+    if (depNames.includes('flask'))
+        result.frameworks.push('flask');
+    if (depNames.includes('fastapi'))
+        result.frameworks.push('fastapi');
+    if (depNames.includes('pytest'))
+        result.frameworks.push('pytest');
+    return result;
+}
+function parsePyprojectToml(content) {
+    const result = {
+        languages: ['python'],
+        frameworks: [],
+        dependencies: [],
+    };
+    // Extract project name
+    const nameMatch = content.match(/name\s*=\s*"([^"]+)"/);
+    if (nameMatch)
+        result.projectName = nameMatch[1];
+    // Extract dependencies from [project.dependencies]
+    const depsSection = content.match(/\[project\]\s*[\s\S]*?dependencies\s*=\s*\[([\s\S]*?)\]/);
+    if (depsSection) {
+        const depLines = depsSection[1].split('\n');
+        for (const line of depLines) {
+            const match = line.trim().match(/"([a-zA-Z0-9_-]+)(?:[=<>!~]+(.+))?"/);
+            if (match) {
+                result.dependencies.push({
+                    name: match[1],
+                    version: match[2],
+                    type: 'runtime',
+                    ecosystem: 'pip',
+                });
+            }
+        }
+    }
+    return result;
+}
+function extractReadmeObservations(content) {
+    const observations = [];
+    const lines = content.split('\n');
+    for (let i = 0; i < lines.length && observations.length < 10; i++) {
+        const line = lines[i].trim();
+        // Extract "note:", "important:", "warning:" callouts
+        if (/^>\s*(note|important|warning|caution|tip):/i.test(line)) {
+            observations.push(line.replace(/^>\s*/, ''));
+        }
+        // Extract gotcha-style sentences
+        if (/\b(gotcha|caveat|known issue|workaround|breaking change)\b/i.test(line) &&
+            line.length > 20 &&
+            line.length < 200) {
+            observations.push(line);
+        }
+    }
+    return observations;
+}
+function extractCommands(content, keyword) {
+    const commands = [];
+    const codeBlockRegex = /```(?:sh|bash|shell|zsh|console)?\n([\s\S]*?)```/g;
+    let match;
+    while ((match = codeBlockRegex.exec(content)) !== null) {
+        const block = match[1];
+        for (const line of block.split('\n')) {
+            const trimmed = line.replace(/^\$\s*/, '').trim();
+            if (trimmed && new RegExp(keyword, 'i').test(trimmed) && trimmed.length < 200) {
+                commands.push(trimmed);
+            }
+        }
+    }
+    return commands.slice(0, 5);
+}
+function detectStructurePatterns(entries) {
+    const patterns = [];
+    const entrySet = new Set(entries);
+    if (entrySet.has('src'))
+        patterns.push('src/ directory (source code)');
+    if (entrySet.has('tests') || entrySet.has('test') || entrySet.has('__tests__'))
+        patterns.push('dedicated test directory');
+    if (entrySet.has('docs') || entrySet.has('doc'))
+        patterns.push('documentation directory');
+    if (entrySet.has('.github'))
+        patterns.push('GitHub workflows/CI');
+    if (entrySet.has('docker-compose.yml') || entrySet.has('Dockerfile'))
+        patterns.push('Docker containerization');
+    if (entrySet.has('packages') || entrySet.has('apps'))
+        patterns.push('monorepo structure');
+    if (entrySet.has('.env.example') || entrySet.has('.env.template'))
+        patterns.push('environment variable configuration');
+    return patterns;
+}
+function inferLanguages(entries) {
+    const langs = [];
+    const extensions = new Set(entries.map((e) => extname(e).toLowerCase()));
+    if (extensions.has('.ts') || extensions.has('.tsx'))
+        langs.push('typescript');
+    if (extensions.has('.js') || extensions.has('.jsx'))
+        langs.push('javascript');
+    if (extensions.has('.py'))
+        langs.push('python');
+    if (extensions.has('.rs'))
+        langs.push('rust');
+    if (extensions.has('.go'))
+        langs.push('go');
+    if (extensions.has('.java'))
+        langs.push('java');
+    if (extensions.has('.rb'))
+        langs.push('ruby');
+    return langs;
+}
+function mergeAnalysis(target, source) {
+    if (source.languages)
+        target.languages.push(...source.languages);
+    if (source.frameworks)
+        target.frameworks.push(...source.frameworks);
+    if (source.dependencies)
+        target.dependencies.push(...source.dependencies);
+    if (source.structurePatterns)
+        target.structurePatterns.push(...source.structurePatterns);
+    if (source.testCommands)
+        target.testCommands.push(...source.testCommands);
+    if (source.setupCommands)
+        target.setupCommands.push(...source.setupCommands);
+    if (source.readmeObservations)
+        target.readmeObservations.push(...source.readmeObservations);
+    if (source.projectName && !target.projectName)
+        target.projectName = source.projectName;
+}
+async function safeReadFile(path) {
+    try {
+        return await readFile(path, 'utf-8');
+    }
+    catch {
+        return undefined;
+    }
+}
+async function safeReaddir(path) {
+    try {
+        return await readdir(path);
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=workspace-analyzer.js.map

package/dist/learning/compound-bootstrap/workspace-analyzer.js.map

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

package/dist/learning/consolidation-coordinator.d.ts

@@ -0,0 +1,49 @@
+/**
+ * ConsolidationCoordinator — decides *when* a dream runs (Phase B).
+ *
+ * Standalone by design: it operates on a `SqlitePersistence` handle and a
+ * `dream` function, not on Atlas internals. The same coordinator therefore
+ * drives all triggers — an in-process idle timer, an explicit API call, and
+ * (later) a separate cron process — so the cadence + single-flight policy lives
+ * in one place. The work a dream performs is identical regardless of trigger;
+ * the coordinator only decides timing.
+ */
+import type { SqlitePersistence } from '../persistence/index.js';
+import type { DreamResult } from './unified-pipeline.js';
+/** A function that drains the queue and consolidates. */
+export type DreamFn = (opts?: {
+    drainAll?: boolean;
+}) => Promise<DreamResult>;
+export interface ConsolidationCoordinatorConfig {
+    /** Pending-row count at/above which a dream is due. */
+    countThreshold: number;
+    /** Oldest-pending age (ms) at/above which a dream is overdue. */
+    maxStalenessMs: number;
+}
+export declare class ConsolidationCoordinator {
+    private persistence;
+    private dreamFn;
+    private config;
+    private running;
+    constructor(persistence: SqlitePersistence, dreamFn: DreamFn, config?: Partial<ConsolidationCoordinatorConfig>);
+    /**
+     * Cadence policy: a dream is due when there is pending work AND either the
+     * backlog has reached `countThreshold` or the oldest pending row has aged
+     * past `maxStalenessMs`. Reads the durable signals the queue already exposes.
+     */
+    shouldDream(now?: Date): boolean;
+    /**
+     * Dream only if the cadence policy says it's due. Returns null when not due
+     * or when a dream is already in flight (single-flight).
+     */
+    maybeDream(now?: Date): Promise<DreamResult | null>;
+    /**
+     * Force a dream now, bypassing the cadence policy (explicit API). Returns
+     * null if a dream is already running (single-flight).
+     */
+    dream(): Promise<DreamResult | null>;
+    isRunning(): boolean;
+    updateConfig(config: Partial<ConsolidationCoordinatorConfig>): void;
+}
+export declare function createConsolidationCoordinator(persistence: SqlitePersistence, dreamFn: DreamFn, config?: Partial<ConsolidationCoordinatorConfig>): ConsolidationCoordinator;
+//# sourceMappingURL=consolidation-coordinator.d.ts.map

package/dist/learning/consolidation-coordinator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consolidation-coordinator.d.ts","sourceRoot":"","sources":["../../src/learning/consolidation-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD,yDAAyD;AACzD,MAAM,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,KAAK,OAAO,CAAC,WAAW,CAAC,CAAC;AAE9E,MAAM,WAAW,8BAA8B;IAC7C,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,iEAAiE;IACjE,cAAc,EAAE,MAAM,CAAC;CACxB;AAOD,qBAAa,wBAAwB;IACnC,OAAO,CAAC,WAAW,CAAoB;IACvC,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,OAAO,CAAS;gBAGtB,WAAW,EAAE,iBAAiB,EAC9B,OAAO,EAAE,OAAO,EAChB,MAAM,CAAC,EAAE,OAAO,CAAC,8BAA8B,CAAC;IAOlD;;;;OAIG;IACH,WAAW,CAAC,GAAG,GAAE,IAAiB,GAAG,OAAO;IAS5C;;;OAGG;IACG,UAAU,CAAC,GAAG,GAAE,IAAiB,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAKrE;;;OAGG;IACG,KAAK,IAAI,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAU1C,SAAS,IAAI,OAAO;IAIpB,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,8BAA8B,CAAC,GAAG,IAAI;CAGpE;AAED,wBAAgB,8BAA8B,CAC5C,WAAW,EAAE,iBAAiB,EAC9B,OAAO,EAAE,OAAO,EAChB,MAAM,CAAC,EAAE,OAAO,CAAC,8BAA8B,CAAC,GAC/C,wBAAwB,CAE1B"}

package/dist/learning/consolidation-coordinator.js

@@ -0,0 +1,75 @@
+/**
+ * ConsolidationCoordinator — decides *when* a dream runs (Phase B).
+ *
+ * Standalone by design: it operates on a `SqlitePersistence` handle and a
+ * `dream` function, not on Atlas internals. The same coordinator therefore
+ * drives all triggers — an in-process idle timer, an explicit API call, and
+ * (later) a separate cron process — so the cadence + single-flight policy lives
+ * in one place. The work a dream performs is identical regardless of trigger;
+ * the coordinator only decides timing.
+ */
+const DEFAULT_CONFIG = {
+    countThreshold: 10,
+    maxStalenessMs: 3_600_000,
+};
+export class ConsolidationCoordinator {
+    persistence;
+    dreamFn;
+    config;
+    running = false;
+    constructor(persistence, dreamFn, config) {
+        this.persistence = persistence;
+        this.dreamFn = dreamFn;
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Cadence policy: a dream is due when there is pending work AND either the
+     * backlog has reached `countThreshold` or the oldest pending row has aged
+     * past `maxStalenessMs`. Reads the durable signals the queue already exposes.
+     */
+    shouldDream(now = new Date()) {
+        if (!this.persistence.isInitialized)
+            return false;
+        const pending = this.persistence.countPendingDreamRows();
+        if (pending === 0)
+            return false;
+        if (pending >= this.config.countThreshold)
+            return true;
+        const oldest = this.persistence.getOldestPendingDreamEnqueuedAt();
+        return !!oldest && now.getTime() - oldest.getTime() >= this.config.maxStalenessMs;
+    }
+    /**
+     * Dream only if the cadence policy says it's due. Returns null when not due
+     * or when a dream is already in flight (single-flight).
+     */
+    async maybeDream(now = new Date()) {
+        if (this.running || !this.shouldDream(now))
+            return null;
+        return this.dream();
+    }
+    /**
+     * Force a dream now, bypassing the cadence policy (explicit API). Returns
+     * null if a dream is already running (single-flight).
+     */
+    async dream() {
+        if (this.running)
+            return null;
+        this.running = true;
+        try {
+            return await this.dreamFn({ drainAll: true });
+        }
+        finally {
+            this.running = false;
+        }
+    }
+    isRunning() {
+        return this.running;
+    }
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+}
+export function createConsolidationCoordinator(persistence, dreamFn, config) {
+    return new ConsolidationCoordinator(persistence, dreamFn, config);
+}
+//# sourceMappingURL=consolidation-coordinator.js.map

package/dist/learning/consolidation-coordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consolidation-coordinator.js","sourceRoot":"","sources":["../../src/learning/consolidation-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAeH,MAAM,cAAc,GAAmC;IACrD,cAAc,EAAE,EAAE;IAClB,cAAc,EAAE,SAAS;CAC1B,CAAC;AAEF,MAAM,OAAO,wBAAwB;IAC3B,WAAW,CAAoB;IAC/B,OAAO,CAAU;IACjB,MAAM,CAAiC;IACvC,OAAO,GAAG,KAAK,CAAC;IAExB,YACE,WAA8B,EAC9B,OAAgB,EAChB,MAAgD;QAEhD,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,cAAc,EAAE,GAAG,MAAM,EAAE,CAAC;IACjD,CAAC;IAED;;;;OAIG;IACH,WAAW,CAAC,MAAY,IAAI,IAAI,EAAE;QAChC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,aAAa;YAAE,OAAO,KAAK,CAAC;QAClD,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,qBAAqB,EAAE,CAAC;QACzD,IAAI,OAAO,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QAChC,IAAI,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc;YAAE,OAAO,IAAI,CAAC;QACvD,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,+BAA+B,EAAE,CAAC;QAClE,OAAO,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;IACpF,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU,CAAC,MAAY,IAAI,IAAI,EAAE;QACrC,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QACxD,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC9B,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAChD,CAAC;gBAAS,CAAC;YACT,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACvB,CAAC;IACH,CAAC;IAED,SAAS;QACP,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,YAAY,CAAC,MAA+C;QAC1D,IAAI,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC;IAC9C,CAAC;CACF;AAED,MAAM,UAAU,8BAA8B,CAC5C,WAA8B,EAC9B,OAAgB,EAChB,MAAgD;IAEhD,OAAO,IAAI,wBAAwB,CAAC,WAAW,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AACpE,CAAC"}

package/dist/learning/convention-distiller.d.ts

@@ -0,0 +1,84 @@
+/**
+ * ConventionDistiller — LLM-backed distillation of correction signals into
+ * scoped, standing convention items (PR-D3).
+ *
+ * Design mirrors TrajectoryDistiller (PR-D1):
+ *   - One LLM call per correction batch, temperature 0 for determinism.
+ *   - Results cached by sha256(canonical-correction-form + PROMPT_VERSION).
+ *   - self-check rubric: at least 2 of 3 criteria must pass.
+ *   - Malformed or ambiguous corrections → null (never fabricate a rule).
+ *
+ * Prompt frame differs from the playbook distiller:
+ *   "What standing preference or convention does this correction imply,
+ *    and what is its scope?"
+ *
+ * Evidence threshold (enforced by KnowledgeBank.upsertConvention):
+ *   - 'instruction' type → binding immediately (evidenceCount=1 suffices)
+ *   - 'edit-diff' | 'rejection' → binding only after evidenceCount >= 2
+ *
+ * SessionBank transcript harvesting is OUT OF SCOPE for this PR.
+ * Follow-up hook: wire CorrectionEvent extraction from SessionBank transcripts
+ * into the trajectory ingestion path (trajectory-sources/session-bank.ts).
+ */
+import type { LLMProvider } from '../agents/types.js';
+import type { CorrectionEvent } from '../types/trajectory.js';
+import type { ConventionScope } from '../types/knowledge.js';
+import type { KnowledgeNote } from '../types/knowledge.js';
+import type { SqlitePersistence } from '../persistence/sqlite-persistence.js';
+export declare const CONVENTION_DISTILLER_PROMPT_VERSION = "v1";
+export interface ConventionDistillerConfig {
+    /**
+     * Pinned model identifier. Temperature is always 0 for determinism.
+     * Default: 'claude-sonnet-4-5'
+     */
+    model?: string;
+    /**
+     * Max tokens for the distillation response. Default: 800.
+     */
+    maxTokens?: number;
+}
+export interface DistilledConvention {
+    conventionText: string;
+    scope: ConventionScope;
+    rationale: string;
+    /** True when this correction was 'instruction' type (immediate binding) */
+    immediateBinding: boolean;
+}
+export declare class ConventionDistiller {
+    private readonly llm;
+    private readonly persistence;
+    private readonly config;
+    constructor(llm: LLMProvider, persistence?: SqlitePersistence, config?: Partial<ConventionDistillerConfig>);
+    /**
+     * Distill one or more correction events into a convention item.
+     *
+     * Returns null when:
+     *   - The LLM returns malformed JSON / fails the self-check rubric.
+     *   - The LLM call itself throws.
+     *   - The correction content is too ambiguous to form a standing rule.
+     *
+     * The caller is responsible for storing the result via
+     * KnowledgeBank.upsertConvention() which handles the evidence threshold.
+     */
+    distill(corrections: CorrectionEvent[], context?: {
+        taskDescription?: string;
+        domain?: string;
+    }): Promise<DistilledConvention | null>;
+    /**
+     * Distill corrections and convert directly to a KnowledgeNote ready for
+     * KnowledgeBank.upsertConvention().
+     *
+     * Returns null on any distillation failure.
+     */
+    distillToNote(corrections: CorrectionEvent[], context?: {
+        taskDescription?: string;
+        domain?: string;
+    }): Promise<KnowledgeNote | null>;
+    /**
+     * Build the cache key for a set of corrections.
+     * Exposed for testing.
+     */
+    buildCacheKey(corrections: CorrectionEvent[]): string;
+}
+export declare function createConventionDistiller(llm: LLMProvider, persistence?: SqlitePersistence, config?: Partial<ConventionDistillerConfig>): ConventionDistiller;
+//# sourceMappingURL=convention-distiller.d.ts.map

package/dist/learning/convention-distiller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convention-distiller.d.ts","sourceRoot":"","sources":["../../src/learning/convention-distiller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAM9E,eAAO,MAAM,mCAAmC,OAAO,CAAC;AAMxD,MAAM,WAAW,yBAAyB;IACxC;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA0BD,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,eAAe,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAMD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAc;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgC;IAC5D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsC;gBAG3D,GAAG,EAAE,WAAW,EAChB,WAAW,CAAC,EAAE,iBAAiB,EAC/B,MAAM,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC;IAO7C;;;;;;;;;;OAUG;IACG,OAAO,CACX,WAAW,EAAE,eAAe,EAAE,EAC9B,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GACtD,OAAO,CAAC,mBAAmB,GAAG,IAAI,CAAC;IAmEtC;;;;;OAKG;IACG,aAAa,CACjB,WAAW,EAAE,eAAe,EAAE,EAC9B,OAAO,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GACtD,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC;IAsBhC;;;OAGG;IACH,aAAa,CAAC,WAAW,EAAE,eAAe,EAAE,GAAG,MAAM;CAItD;AAMD,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,WAAW,EAChB,WAAW,CAAC,EAAE,iBAAiB,EAC/B,MAAM,CAAC,EAAE,OAAO,CAAC,yBAAyB,CAAC,GAC1C,mBAAmB,CAErB"}