cognitive-core 0.1.0 → 0.2.0

package/dist/learning/knowledge-extractor.js.map

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

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

@@ -0,0 +1,61 @@
+/**
+ * LoopCoordinator — Coordinates instant (hot) and background (cold) learning
+ *
+ * Every trajectory flows through the InstantLoop immediately. The coordinator
+ * tracks a pending count and signals when the existing batch pipeline should
+ * run. It does NOT own the batch pipeline — Atlas does — but it provides the
+ * `shouldRunBatch()` check and accumulation count.
+ */
+import type { Trajectory } from '../types/index.js';
+import type { SqlitePersistence } from '../persistence/index.js';
+import { InstantLoop, type InstantLoopResult } from './instant-loop.js';
+/**
+ * LoopCoordinator configuration
+ */
+export interface LoopCoordinatorConfig {
+    /** Trajectories needed before recommending a batch run (default: 10) */
+    batchThreshold?: number;
+    /** Log a warning if the instant loop exceeds this budget in ms (default: 200) */
+    maxInstantLatencyMs?: number;
+}
+/**
+ * LoopCoordinator — hot + cold learning coordination
+ */
+export declare class LoopCoordinator {
+    private instantLoop;
+    private config;
+    private pendingCount;
+    private _onLatencyWarning;
+    private persistence?;
+    constructor(instantLoop: InstantLoop, config?: LoopCoordinatorConfig, persistence?: SqlitePersistence);
+    /**
+     * Called on every trajectory completion.
+     * Runs the instant loop and increments the pending batch count.
+     */
+    onTrajectoryComplete(trajectory: Trajectory): Promise<InstantLoopResult>;
+    /**
+     * Check whether the batch pipeline should run.
+     */
+    shouldRunBatch(): boolean;
+    /**
+     * Reset the pending count (called after a batch run completes).
+     */
+    resetPendingCount(): void;
+    /**
+     * Load persisted pending count. Call after persistence is initialized.
+     */
+    loadPersistedState(): void;
+    /**
+     * Get the current pending trajectory count.
+     */
+    getPendingCount(): number;
+    /**
+     * Register a callback for latency budget warnings.
+     */
+    onLatencyWarning(callback: (durationMs: number) => void): void;
+}
+/**
+ * Create a LoopCoordinator
+ */
+export declare function createLoopCoordinator(instantLoop: InstantLoop, config?: LoopCoordinatorConfig, persistence?: SqlitePersistence): LoopCoordinator;
+//# sourceMappingURL=loop-coordinator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loop-coordinator.d.ts","sourceRoot":"","sources":["../../src/learning/loop-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAExE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iFAAiF;IACjF,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,MAAM,CAAkC;IAChD,OAAO,CAAC,YAAY,CAAK;IACzB,OAAO,CAAC,iBAAiB,CAA+C;IACxE,OAAO,CAAC,WAAW,CAAC,CAAoB;gBAGtC,WAAW,EAAE,WAAW,EACxB,MAAM,CAAC,EAAE,qBAAqB,EAC9B,WAAW,CAAC,EAAE,iBAAiB;IAkBjC;;;OAGG;IACG,oBAAoB,CACxB,UAAU,EAAE,UAAU,GACrB,OAAO,CAAC,iBAAiB,CAAC;IAkB7B;;OAEG;IACH,cAAc,IAAI,OAAO;IAIzB;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAQzB;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAS1B;;OAEG;IACH,eAAe,IAAI,MAAM;IAIzB;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;CAG/D;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,WAAW,EACxB,MAAM,CAAC,EAAE,qBAAqB,EAC9B,WAAW,CAAC,EAAE,iBAAiB,GAC9B,eAAe,CAEjB"}

package/dist/learning/loop-coordinator.js

@@ -0,0 +1,96 @@
+/**
+ * LoopCoordinator — Coordinates instant (hot) and background (cold) learning
+ *
+ * Every trajectory flows through the InstantLoop immediately. The coordinator
+ * tracks a pending count and signals when the existing batch pipeline should
+ * run. It does NOT own the batch pipeline — Atlas does — but it provides the
+ * `shouldRunBatch()` check and accumulation count.
+ */
+/**
+ * LoopCoordinator — hot + cold learning coordination
+ */
+export class LoopCoordinator {
+    instantLoop;
+    config;
+    pendingCount = 0;
+    _onLatencyWarning = null;
+    persistence;
+    constructor(instantLoop, config, persistence) {
+        this.instantLoop = instantLoop;
+        this.config = {
+            batchThreshold: config?.batchThreshold ?? 10,
+            maxInstantLatencyMs: config?.maxInstantLatencyMs ?? 200,
+        };
+        this.persistence = persistence;
+        // Load persisted pending count
+        if (persistence?.isInitialized) {
+            const saved = persistence.getSystemState('loop_coordinator');
+            if (saved) {
+                this.pendingCount = saved.pendingCount;
+            }
+        }
+    }
+    /**
+     * Called on every trajectory completion.
+     * Runs the instant loop and increments the pending batch count.
+     */
+    async onTrajectoryComplete(trajectory) {
+        const result = await this.instantLoop.process(trajectory);
+        this.pendingCount++;
+        if (this.persistence) {
+            this.persistence.setSystemState('loop_coordinator', { pendingCount: this.pendingCount });
+        }
+        // Warn if instant loop exceeded latency budget
+        if (result.durationMs > this.config.maxInstantLatencyMs) {
+            if (this._onLatencyWarning) {
+                this._onLatencyWarning(result.durationMs);
+            }
+        }
+        return result;
+    }
+    /**
+     * Check whether the batch pipeline should run.
+     */
+    shouldRunBatch() {
+        return this.pendingCount >= this.config.batchThreshold;
+    }
+    /**
+     * Reset the pending count (called after a batch run completes).
+     */
+    resetPendingCount() {
+        this.pendingCount = 0;
+        if (this.persistence) {
+            this.persistence.setSystemState('loop_coordinator', { pendingCount: 0 });
+        }
+    }
+    /**
+     * Load persisted pending count. Call after persistence is initialized.
+     */
+    loadPersistedState() {
+        if (this.persistence?.isInitialized) {
+            const saved = this.persistence.getSystemState('loop_coordinator');
+            if (saved) {
+                this.pendingCount = saved.pendingCount;
+            }
+        }
+    }
+    /**
+     * Get the current pending trajectory count.
+     */
+    getPendingCount() {
+        return this.pendingCount;
+    }
+    /**
+     * Register a callback for latency budget warnings.
+     */
+    onLatencyWarning(callback) {
+        this._onLatencyWarning = callback;
+    }
+}
+/**
+ * Create a LoopCoordinator
+ */
+export function createLoopCoordinator(instantLoop, config, persistence) {
+    return new LoopCoordinator(instantLoop, config, persistence);
+}
+//# sourceMappingURL=loop-coordinator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loop-coordinator.js","sourceRoot":"","sources":["../../src/learning/loop-coordinator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAgBH;;GAEG;AACH,MAAM,OAAO,eAAe;IAClB,WAAW,CAAc;IACzB,MAAM,CAAkC;IACxC,YAAY,GAAG,CAAC,CAAC;IACjB,iBAAiB,GAA0C,IAAI,CAAC;IAChE,WAAW,CAAqB;IAExC,YACE,WAAwB,EACxB,MAA8B,EAC9B,WAA+B;QAE/B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG;YACZ,cAAc,EAAE,MAAM,EAAE,cAAc,IAAI,EAAE;YAC5C,mBAAmB,EAAE,MAAM,EAAE,mBAAmB,IAAI,GAAG;SACxD,CAAC;QACF,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAE/B,+BAA+B;QAC/B,IAAI,WAAW,EAAE,aAAa,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,WAAW,CAAC,cAAc,CAA2B,kBAAkB,CAAC,CAAC;YACvF,IAAI,KAAK,EAAE,CAAC;gBACV,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;YACzC,CAAC;QACH,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,oBAAoB,CACxB,UAAsB;QAEtB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAC1D,IAAI,CAAC,YAAY,EAAE,CAAC;QAEpB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,kBAAkB,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QAC3F,CAAC;QAED,+CAA+C;QAC/C,IAAI,MAAM,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAAE,CAAC;YACxD,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;gBAC3B,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;YAC5C,CAAC;QACH,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,cAAc;QACZ,OAAO,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC;IACzD,CAAC;IAED;;OAEG;IACH,iBAAiB;QACf,IAAI,CAAC,YAAY,GAAG,CAAC,CAAC;QAEtB,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACrB,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,kBAAkB,EAAE,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC,CAAC;QAC3E,CAAC;IACH,CAAC;IAED;;OAEG;IACH,kBAAkB;QAChB,IAAI,IAAI,CAAC,WAAW,EAAE,aAAa,EAAE,CAAC;YACpC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,cAAc,CAA2B,kBAAkB,CAAC,CAAC;YAC5F,IAAI,KAAK,EAAE,CAAC;gBACV,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;YACzC,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,QAAsC;QACrD,IAAI,CAAC,iBAAiB,GAAG,QAAQ,CAAC;IACpC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,WAAwB,EACxB,MAA8B,EAC9B,WAA+B;IAE/B,OAAO,IAAI,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;AAC/D,CAAC"}

package/dist/learning/maintenance-scheduler.d.ts

@@ -0,0 +1,141 @@
+/**
+ * MaintenanceScheduler — Circadian-style duty-gated maintenance scheduling.
+ *
+ * Inspired by ruvector's CircadianController (ruvector-nervous-system/routing/circadian.rs).
+ * Gates background maintenance work using configurable triggers:
+ *
+ *   - 'manual': Only runs when explicitly requested
+ *   - 'afterNBatches': Runs after N batch cycles complete
+ *   - 'periodic': Runs on a time interval
+ *
+ * Maintenance tasks are deferred during active batch processing to avoid
+ * contention. A duty-factor model ensures maintenance doesn't starve
+ * the primary learning pipeline.
+ */
+/**
+ * Maintenance trigger mode.
+ */
+export type MaintenanceMode = 'manual' | 'afterNBatches' | 'periodic';
+/**
+ * Configuration for the MaintenanceScheduler.
+ */
+export interface MaintenanceSchedulerConfig {
+    /** Trigger mode (default: 'afterNBatches') */
+    mode: MaintenanceMode;
+    /** For 'afterNBatches' mode: batches between maintenance runs (default: 5) */
+    batchInterval: number;
+    /** For 'periodic' mode: milliseconds between runs (default: 3600000 = 1h) */
+    intervalMs: number;
+    /** Skip maintenance if a batch is currently running (default: true) */
+    deferDuringBatch: boolean;
+    /** Maximum queued maintenance tasks before dropping oldest (default: 10) */
+    maxQueueSize: number;
+}
+/**
+ * A maintenance task that can be scheduled.
+ */
+export interface MaintenanceTask {
+    /** Unique name for this task (e.g., 'knowledge-defrag', 'temporal-compression') */
+    name: string;
+    /** Priority (higher = run first) */
+    priority: number;
+    /** The async work to perform */
+    execute: () => Promise<MaintenanceTaskResult>;
+}
+/**
+ * Result of a maintenance task execution.
+ */
+export interface MaintenanceTaskResult {
+    taskName: string;
+    success: boolean;
+    durationMs: number;
+    details?: Record<string, unknown>;
+}
+/**
+ * Result of a full maintenance cycle.
+ */
+export interface MaintenanceCycleResult {
+    /** Whether the cycle actually ran (false if deferred or not due) */
+    ran: boolean;
+    /** Reason the cycle was skipped, if applicable */
+    skipReason?: 'not_due' | 'batch_in_progress' | 'manual_mode' | 'queue_empty';
+    /** Results from each task that ran */
+    taskResults: MaintenanceTaskResult[];
+    /** Total duration of the cycle in ms */
+    totalDurationMs: number;
+    /** Timestamp of this cycle */
+    timestamp: Date;
+}
+/**
+ * MaintenanceScheduler — duty-gated background maintenance scheduling.
+ */
+export declare class MaintenanceScheduler {
+    private config;
+    private registeredTasks;
+    private batchesSinceLastMaintenance;
+    private lastMaintenanceTime;
+    private isBatchRunning;
+    private cycleHistory;
+    constructor(config?: Partial<MaintenanceSchedulerConfig>);
+    /**
+     * Register a maintenance task.
+     * Tasks are sorted by priority (descending) before execution.
+     */
+    registerTask(task: MaintenanceTask): void;
+    /**
+     * Unregister a maintenance task by name.
+     */
+    unregisterTask(name: string): void;
+    /**
+     * Signal that a batch cycle has completed.
+     * For 'afterNBatches' mode, this increments the counter.
+     */
+    onBatchComplete(): void;
+    /**
+     * Signal that a batch is starting (for deferral logic).
+     */
+    onBatchStart(): void;
+    /**
+     * Signal that a batch has finished running.
+     */
+    onBatchEnd(): void;
+    /**
+     * Check whether maintenance should run now.
+     */
+    shouldRunMaintenance(): boolean;
+    /**
+     * Run a maintenance cycle.
+     * Executes all registered tasks in priority order.
+     *
+     * Can be called manually regardless of mode — bypasses trigger checks.
+     */
+    runMaintenance(options?: {
+        force?: boolean;
+    }): Promise<MaintenanceCycleResult>;
+    /**
+     * Get the list of registered tasks.
+     */
+    getRegisteredTasks(): readonly MaintenanceTask[];
+    /**
+     * Get maintenance cycle history.
+     */
+    getCycleHistory(): readonly MaintenanceCycleResult[];
+    /**
+     * Get the number of batches since last maintenance.
+     */
+    getBatchesSinceLastMaintenance(): number;
+    /**
+     * Get current configuration.
+     */
+    getConfig(): Readonly<MaintenanceSchedulerConfig>;
+    /**
+     * Update configuration.
+     */
+    updateConfig(config: Partial<MaintenanceSchedulerConfig>): void;
+    private skipResult;
+}
+/**
+ * Create a MaintenanceScheduler.
+ */
+export declare function createMaintenanceScheduler(config?: Partial<MaintenanceSchedulerConfig>): MaintenanceScheduler;
+//# sourceMappingURL=maintenance-scheduler.d.ts.map

package/dist/learning/maintenance-scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maintenance-scheduler.d.ts","sourceRoot":"","sources":["../../src/learning/maintenance-scheduler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,eAAe,GAAG,UAAU,CAAC;AAEtE;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,8CAA8C;IAC9C,IAAI,EAAE,eAAe,CAAC;IACtB,8EAA8E;IAC9E,aAAa,EAAE,MAAM,CAAC;IACtB,6EAA6E;IAC7E,UAAU,EAAE,MAAM,CAAC;IACnB,uEAAuE;IACvE,gBAAgB,EAAE,OAAO,CAAC;IAC1B,4EAA4E;IAC5E,YAAY,EAAE,MAAM,CAAC;CACtB;AAUD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mFAAmF;IACnF,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,gCAAgC;IAChC,OAAO,EAAE,MAAM,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAC/C;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,oEAAoE;IACpE,GAAG,EAAE,OAAO,CAAC;IACb,kDAAkD;IAClD,UAAU,CAAC,EAAE,SAAS,GAAG,mBAAmB,GAAG,aAAa,GAAG,aAAa,CAAC;IAC7E,sCAAsC;IACtC,WAAW,EAAE,qBAAqB,EAAE,CAAC;IACrC,wCAAwC;IACxC,eAAe,EAAE,MAAM,CAAC;IACxB,8BAA8B;IAC9B,SAAS,EAAE,IAAI,CAAC;CACjB;AAED;;GAEG;AACH,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,eAAe,CAAyB;IAChD,OAAO,CAAC,2BAA2B,CAAK;IACxC,OAAO,CAAC,mBAAmB,CAAK;IAChC,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,YAAY,CAAgC;gBAExC,MAAM,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC;IAIxD;;;OAGG;IACH,YAAY,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI;IAOzC;;OAEG;IACH,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIlC;;;OAGG;IACH,eAAe,IAAI,IAAI;IAIvB;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,oBAAoB,IAAI,OAAO;IAiB/B;;;;;OAKG;IACG,cAAc,CAAC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAmDpF;;OAEG;IACH,kBAAkB,IAAI,SAAS,eAAe,EAAE;IAIhD;;OAEG;IACH,eAAe,IAAI,SAAS,sBAAsB,EAAE;IAIpD;;OAEG;IACH,8BAA8B,IAAI,MAAM;IAIxC;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,0BAA0B,CAAC;IAIjD;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,0BAA0B,CAAC,GAAG,IAAI;IAI/D,OAAO,CAAC,UAAU;CAYnB;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,MAAM,CAAC,EAAE,OAAO,CAAC,0BAA0B,CAAC,GAC3C,oBAAoB,CAEtB"}

package/dist/learning/maintenance-scheduler.js

@@ -0,0 +1,186 @@
+/**
+ * MaintenanceScheduler — Circadian-style duty-gated maintenance scheduling.
+ *
+ * Inspired by ruvector's CircadianController (ruvector-nervous-system/routing/circadian.rs).
+ * Gates background maintenance work using configurable triggers:
+ *
+ *   - 'manual': Only runs when explicitly requested
+ *   - 'afterNBatches': Runs after N batch cycles complete
+ *   - 'periodic': Runs on a time interval
+ *
+ * Maintenance tasks are deferred during active batch processing to avoid
+ * contention. A duty-factor model ensures maintenance doesn't starve
+ * the primary learning pipeline.
+ */
+const DEFAULT_CONFIG = {
+    mode: 'afterNBatches',
+    batchInterval: 5,
+    intervalMs: 3_600_000,
+    deferDuringBatch: true,
+    maxQueueSize: 10,
+};
+/**
+ * MaintenanceScheduler — duty-gated background maintenance scheduling.
+ */
+export class MaintenanceScheduler {
+    config;
+    registeredTasks = [];
+    batchesSinceLastMaintenance = 0;
+    lastMaintenanceTime = 0;
+    isBatchRunning = false;
+    cycleHistory = [];
+    constructor(config) {
+        this.config = { ...DEFAULT_CONFIG, ...config };
+    }
+    /**
+     * Register a maintenance task.
+     * Tasks are sorted by priority (descending) before execution.
+     */
+    registerTask(task) {
+        // Replace existing task with same name
+        this.registeredTasks = this.registeredTasks.filter(t => t.name !== task.name);
+        this.registeredTasks.push(task);
+        this.registeredTasks.sort((a, b) => b.priority - a.priority);
+    }
+    /**
+     * Unregister a maintenance task by name.
+     */
+    unregisterTask(name) {
+        this.registeredTasks = this.registeredTasks.filter(t => t.name !== name);
+    }
+    /**
+     * Signal that a batch cycle has completed.
+     * For 'afterNBatches' mode, this increments the counter.
+     */
+    onBatchComplete() {
+        this.batchesSinceLastMaintenance++;
+    }
+    /**
+     * Signal that a batch is starting (for deferral logic).
+     */
+    onBatchStart() {
+        this.isBatchRunning = true;
+    }
+    /**
+     * Signal that a batch has finished running.
+     */
+    onBatchEnd() {
+        this.isBatchRunning = false;
+    }
+    /**
+     * Check whether maintenance should run now.
+     */
+    shouldRunMaintenance() {
+        if (this.config.mode === 'manual')
+            return false;
+        if (this.config.deferDuringBatch && this.isBatchRunning)
+            return false;
+        if (this.registeredTasks.length === 0)
+            return false;
+        if (this.config.mode === 'afterNBatches') {
+            return this.batchesSinceLastMaintenance >= this.config.batchInterval;
+        }
+        if (this.config.mode === 'periodic') {
+            const now = Date.now();
+            return (now - this.lastMaintenanceTime) >= this.config.intervalMs;
+        }
+        return false;
+    }
+    /**
+     * Run a maintenance cycle.
+     * Executes all registered tasks in priority order.
+     *
+     * Can be called manually regardless of mode — bypasses trigger checks.
+     */
+    async runMaintenance(options) {
+        const start = Date.now();
+        // Check if we should run (unless forced)
+        if (!options?.force) {
+            if (this.config.deferDuringBatch && this.isBatchRunning) {
+                return this.skipResult('batch_in_progress', start);
+            }
+            if (this.registeredTasks.length === 0) {
+                return this.skipResult('queue_empty', start);
+            }
+        }
+        // Execute tasks in priority order
+        const taskResults = [];
+        for (const task of this.registeredTasks) {
+            const taskStart = Date.now();
+            try {
+                const result = await task.execute();
+                taskResults.push(result);
+            }
+            catch (error) {
+                taskResults.push({
+                    taskName: task.name,
+                    success: false,
+                    durationMs: Date.now() - taskStart,
+                    details: {
+                        error: error instanceof Error ? error.message : String(error),
+                    },
+                });
+            }
+        }
+        // Reset counters
+        this.batchesSinceLastMaintenance = 0;
+        this.lastMaintenanceTime = Date.now();
+        const result = {
+            ran: true,
+            taskResults,
+            totalDurationMs: Date.now() - start,
+            timestamp: new Date(),
+        };
+        this.cycleHistory.push(result);
+        if (this.cycleHistory.length > this.config.maxQueueSize) {
+            this.cycleHistory.shift();
+        }
+        return result;
+    }
+    /**
+     * Get the list of registered tasks.
+     */
+    getRegisteredTasks() {
+        return this.registeredTasks;
+    }
+    /**
+     * Get maintenance cycle history.
+     */
+    getCycleHistory() {
+        return this.cycleHistory;
+    }
+    /**
+     * Get the number of batches since last maintenance.
+     */
+    getBatchesSinceLastMaintenance() {
+        return this.batchesSinceLastMaintenance;
+    }
+    /**
+     * Get current configuration.
+     */
+    getConfig() {
+        return this.config;
+    }
+    /**
+     * Update configuration.
+     */
+    updateConfig(config) {
+        this.config = { ...this.config, ...config };
+    }
+    skipResult(reason, start) {
+        return {
+            ran: false,
+            skipReason: reason,
+            taskResults: [],
+            totalDurationMs: Date.now() - start,
+            timestamp: new Date(),
+        };
+    }
+}
+/**
+ * Create a MaintenanceScheduler.
+ */
+export function createMaintenanceScheduler(config) {
+    return new MaintenanceScheduler(config);
+}
+//# sourceMappingURL=maintenance-scheduler.js.map

package/dist/learning/maintenance-scheduler.js.map

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

package/dist/learning/meta-learner.d.ts

@@ -5,6 +5,7 @@
 import type { MetaObservation, MetaStrategy, Trajectory, RoutingDecisionType } from '../types/index.js';
 import type { MetaMemory } from '../memory/meta.js';
 import type { PlaybookMatch } from '../memory/playbook.js';
+import type { MetaReflectionOutput } from '../workspace/templates/meta-reflection.js';
 /**
  * Routing decision from the router
  */
@@ -40,6 +41,12 @@ export declare class MetaLearner {
      * Generate reflection from completed trajectory
      */
     generateReflection(trajectory: Trajectory, routing: RoutingDecision, playbooksUsed: PlaybookMatch[]): Promise<MetaObservation>;
+    /**
+     * Record a meta-observation from workspace-based reflection output.
+     * Bridges MetaReflectionOutput (from the meta-reflection template)
+     * into the MetaObservation storage format.
+     */
+    recordFromReflection(reflection: MetaReflectionOutput, trajectoryId: string, routing: RoutingDecision, playbookIds: string[], actualEffort: number): Promise<MetaObservation>;
     /**
      * Analyze accumulated observations and generate meta-strategies
      */

package/dist/learning/meta-learner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"meta-learner.d.ts","sourceRoot":"","sources":["../../src/learning/meta-learner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,UAAU,EAEV,mBAAmB,EAIpB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,wDAAwD;IACxD,4BAA4B,EAAE,MAAM,CAAC;IACrC,6DAA6D;IAC7D,0BAA0B,EAAE,MAAM,CAAC;IACnC,kDAAkD;IAClD,yBAAyB,EAAE,MAAM,CAAC;IAClC,6EAA6E;IAC7E,sBAAsB,EAAE,MAAM,CAAC;CAChC;AASD;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,gBAAgB,CAAK;gBAEjB,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC;IAKjE;;OAEG;IACG,kBAAkB,CACtB,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,eAAe,EACxB,aAAa,EAAE,aAAa,EAAE,GAC7B,OAAO,CAAC,eAAe,CAAC;IA4D3B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IA0BtC;;OAEG;IACG,aAAa,CACjB,WAAW,EAAE,eAAe,EAC5B,mBAAmB,EAAE,MAAM,EAAE,EAC7B,WAAW,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,eAAe,CAAC;IA8D3B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAsB9B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA8B7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAuB5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAgExB;;OAEG;IACH,OAAO,CAAC,eAAe;IAoEvB;;OAEG;IACH,OAAO,CAAC,8BAA8B;CAmDvC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,UAAU,EAChB,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,WAAW,CAEb"}
+{"version":3,"file":"meta-learner.d.ts","sourceRoot":"","sources":["../../src/learning/meta-learner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,YAAY,EACZ,UAAU,EAEV,mBAAmB,EAIpB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAGtF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,wDAAwD;IACxD,4BAA4B,EAAE,MAAM,CAAC;IACrC,6DAA6D;IAC7D,0BAA0B,EAAE,MAAM,CAAC;IACnC,kDAAkD;IAClD,yBAAyB,EAAE,MAAM,CAAC;IAClC,6EAA6E;IAC7E,sBAAsB,EAAE,MAAM,CAAC;CAChC;AASD;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,gBAAgB,CAAK;gBAEjB,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC;IAKjE;;OAEG;IACG,kBAAkB,CACtB,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,eAAe,EACxB,aAAa,EAAE,aAAa,EAAE,GAC7B,OAAO,CAAC,eAAe,CAAC;IA4D3B;;;;OAIG;IACG,oBAAoB,CACxB,UAAU,EAAE,oBAAoB,EAChC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,eAAe,EACxB,WAAW,EAAE,MAAM,EAAE,EACrB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,eAAe,CAAC;IA0C3B;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IA0BtC;;OAEG;IACG,aAAa,CACjB,WAAW,EAAE,eAAe,EAC5B,mBAAmB,EAAE,MAAM,EAAE,EAC7B,WAAW,EAAE,MAAM,EAAE,GACpB,OAAO,CAAC,eAAe,CAAC;IA8D3B;;OAEG;IACH,OAAO,CAAC,sBAAsB;IAsB9B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IA8B7B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAuB5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA6CxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAoEvB;;OAEG;IACH,OAAO,CAAC,8BAA8B;CAmDvC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,UAAU,EAChB,MAAM,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GAClC,WAAW,CAEb"}

package/dist/learning/meta-learner.js

@@ -3,6 +3,7 @@
  * Learns about learning - analyzes trajectories to improve routing and retrieval
  */
 import { createMetaObservation, createMetaStrategy } from '../types/index.js';
+import { detectRepeatedActions, extractToolNames } from '../utils/trajectory-helpers.js';
 const DEFAULT_CONFIG = {
     minObservationsForStrategies: 10,
     strategyGenerationInterval: 10,
@@ -66,6 +67,49 @@ export class MetaLearner {
         }
         return observation;
     }
+    /**
+     * Record a meta-observation from workspace-based reflection output.
+     * Bridges MetaReflectionOutput (from the meta-reflection template)
+     * into the MetaObservation storage format.
+     */
+    async recordFromReflection(reflection, trajectoryId, routing, playbookIds, actualEffort) {
+        const observation = createMetaObservation({
+            trajectoryId,
+            routing: {
+                decision: routing.strategy,
+                confidence: routing.confidence,
+                reasoning: routing.reasoning,
+            },
+            memoryUsage: {
+                experiencesRetrieved: 0,
+                playbooksApplied: playbookIds,
+                retrievalQuality: reflection.retrievalQuality,
+            },
+            execution: {
+                decompositionUsed: reflection.decompositionUsed,
+                refinementIterations: reflection.refinementIterations,
+                backtrackingOccurred: reflection.backtrackingOccurred,
+                toolsUsed: [],
+            },
+            outcome: {
+                success: reflection.outcomeQuality !== 'poor',
+                quality: reflection.outcomeQuality,
+                effortActual: actualEffort,
+                effortEstimate: routing.estimatedBudget,
+            },
+            lessons: {
+                whatWorked: reflection.whatWorked,
+                whatFailed: reflection.whatFailed,
+                suggestions: reflection.suggestions,
+            },
+        });
+        await this.meta.recordObservation(observation);
+        this.observationCount++;
+        if (this.observationCount % this.config.strategyGenerationInterval === 0) {
+            await this.learn();
+        }
+        return observation;
+    }
     /**
      * Analyze accumulated observations and generate meta-strategies
      */
@@ -214,28 +258,10 @@ export class MetaLearner {
      */
     analyzeExecution(trajectory) {
         const steps = trajectory.steps;
-        const toolsUsed = new Set();
-        let backtrackingOccurred = false;
-        // Collect tools used (extract from action)
-        for (const step of steps) {
-            // Try to extract tool name from action (e.g., "tool_use: Bash" or just "Bash")
-            const toolMatch = step.action.match(/^(?:tool_use:\s*)?(\w+)/);
-            if (toolMatch) {
-                toolsUsed.add(toolMatch[1]);
-            }
-        }
+        // Collect tools used
+        const toolsUsed = extractToolNames(steps);
         // Check for backtracking (similar actions repeated)
-        const actionCounts = new Map();
-        for (const step of steps) {
-            const normalized = step.action.toLowerCase().slice(0, 50);
-            actionCounts.set(normalized, (actionCounts.get(normalized) ?? 0) + 1);
-        }
-        for (const count of actionCounts.values()) {
-            if (count > 2) {
-                backtrackingOccurred = true;
-                break;
-            }
-        }
+        const backtrackingOccurred = detectRepeatedActions(steps, 3).length > 0;
         // Check for decomposition (multiple sub-tasks)
         const decompositionUsed = steps.some((s) => s.thought?.includes('break') ||
             s.thought?.includes('decompose') ||