cognitive-core 0.1.0 → 0.2.0

package/dist/memory/team-experience.js

@@ -0,0 +1,355 @@
+/**
+ * Team Experience Memory - Storage for team trajectories and analysis results
+ *
+ * Stores complete team execution records (TeamTrajectory + analysis)
+ * for retrieval during future team formation and analysis.
+ * The team-level analog of ExperienceMemory.
+ */
+import { JsonStore } from '../utils/storage.js';
+import { findTopK } from '../utils/similarity.js';
+/**
+ * TeamExperienceMemory - Store and retrieve team execution experiences.
+ * Parallel to ExperienceMemory but for team-level data.
+ */
+export class TeamExperienceMemory {
+    experienceStore;
+    teamPlaybookStore;
+    rolePlaybookStore;
+    metaObservationStore;
+    metaStrategyStore;
+    initialized = false;
+    constructor(baseDir) {
+        this.experienceStore = new JsonStore(baseDir, 'team-experiences', {
+            autoSaveInterval: 60000,
+            pretty: true,
+        });
+        this.teamPlaybookStore = new JsonStore(baseDir, 'team-playbooks', {
+            autoSaveInterval: 60000,
+            pretty: true,
+        });
+        this.rolePlaybookStore = new JsonStore(baseDir, 'role-playbooks', {
+            autoSaveInterval: 60000,
+            pretty: true,
+        });
+        this.metaObservationStore = new JsonStore(baseDir, 'team-meta-observations', {
+            autoSaveInterval: 60000,
+            pretty: true,
+        });
+        this.metaStrategyStore = new JsonStore(baseDir, 'team-meta-strategies', {
+            autoSaveInterval: 60000,
+            pretty: true,
+        });
+    }
+    async init() {
+        if (this.initialized)
+            return;
+        await Promise.all([
+            this.experienceStore.init(),
+            this.teamPlaybookStore.init(),
+            this.rolePlaybookStore.init(),
+            this.metaObservationStore.init(),
+            this.metaStrategyStore.init(),
+        ]);
+        this.initialized = true;
+    }
+    // === TEAM EXPERIENCES ===
+    /**
+     * Store a team experience (trajectory + optional analysis).
+     */
+    async storeTeamExperience(params) {
+        await this.init();
+        const experience = {
+            id: params.teamTrajectory.id,
+            teamTrajectory: params.teamTrajectory,
+            analysis: params.analysis,
+            createdAt: new Date(),
+            usageCount: 0,
+        };
+        this.experienceStore.set(experience.id, experience);
+        await this.experienceStore.save(experience.id);
+        return experience;
+    }
+    /**
+     * Get a team experience by ID.
+     */
+    async getTeamExperience(id) {
+        await this.init();
+        return this.experienceStore.get(id);
+    }
+    /**
+     * Find team experiences similar to a given objective.
+     */
+    async findSimilarTeamExperiences(query, options) {
+        await this.init();
+        const k = options?.k ?? 4;
+        let experiences = this.experienceStore.values();
+        if (options?.domain) {
+            experiences = experiences.filter((e) => e.teamTrajectory.domain === options.domain);
+        }
+        if (options?.topology) {
+            experiences = experiences.filter((e) => e.teamTrajectory.topologyType === options.topology);
+        }
+        if (options?.successOnly) {
+            experiences = experiences.filter((e) => e.teamTrajectory.outcome.success);
+        }
+        return findTopK(query, experiences, (e) => e.teamTrajectory.objective, k).map(({ item, score }) => ({ experience: item, score }));
+    }
+    /**
+     * Get all team experiences.
+     */
+    async getAllTeamExperiences() {
+        await this.init();
+        return this.experienceStore.values();
+    }
+    /**
+     * Record usage of a team experience (for value-based pruning).
+     */
+    async recordTeamExperienceUsage(id) {
+        await this.init();
+        const existing = this.experienceStore.get(id);
+        if (existing) {
+            existing.usageCount++;
+            existing.lastAccessedAt = new Date();
+            this.experienceStore.set(id, existing);
+        }
+    }
+    /**
+     * Count team experiences.
+     */
+    async countTeamExperiences() {
+        await this.init();
+        return this.experienceStore.size();
+    }
+    // === TEAM PLAYBOOKS ===
+    /**
+     * Store a team playbook.
+     */
+    async storeTeamPlaybook(playbook) {
+        await this.init();
+        this.teamPlaybookStore.set(playbook.id, playbook);
+        await this.teamPlaybookStore.save(playbook.id);
+    }
+    /**
+     * Find matching team playbooks for a given task context.
+     */
+    async findMatchingTeamPlaybooks(options) {
+        await this.init();
+        const k = options.k ?? 5;
+        let playbooks = this.teamPlaybookStore.values();
+        // Filter by domain if specified
+        if (options.domain) {
+            playbooks = playbooks.filter((p) => p.applicability.domains.includes(options.domain));
+        }
+        // Filter by topology if specified
+        if (options.topology) {
+            playbooks = playbooks.filter((p) => p.composition.topology === options.topology);
+        }
+        // Filter by complexity if specified
+        if (options.complexity) {
+            playbooks = playbooks.filter((p) => p.applicability.complexityLevels.includes(options.complexity));
+        }
+        // Score by task type similarity if provided
+        if (options.taskType) {
+            return findTopK(options.taskType, playbooks, (p) => p.applicability.taskTypes.join(' '), k).map(({ item, score }) => ({ playbook: item, score }));
+        }
+        // Return all matching, scored by confidence
+        return playbooks
+            .sort((a, b) => b.confidence - a.confidence)
+            .slice(0, k)
+            .map((p) => ({ playbook: p, score: p.confidence }));
+    }
+    /**
+     * Update a team playbook by adding a refinement.
+     */
+    async updateTeamPlaybook(id, refinement) {
+        await this.init();
+        const existing = this.teamPlaybookStore.get(id);
+        if (!existing)
+            return false;
+        existing.evolution.refinements.push({
+            ...refinement,
+            addedAt: new Date(),
+        });
+        existing.updatedAt = new Date();
+        this.teamPlaybookStore.set(id, existing);
+        await this.teamPlaybookStore.save(id);
+        return true;
+    }
+    /**
+     * Update a role playbook by adding a refinement.
+     */
+    async updateRolePlaybook(id, refinement) {
+        await this.init();
+        const existing = this.rolePlaybookStore.get(id);
+        if (!existing)
+            return false;
+        existing.evolution.refinements.push({
+            ...refinement,
+            addedAt: new Date(),
+        });
+        existing.updatedAt = new Date();
+        this.rolePlaybookStore.set(id, existing);
+        await this.rolePlaybookStore.save(id);
+        return true;
+    }
+    /**
+     * Get all team playbooks.
+     */
+    async getTeamPlaybooks() {
+        await this.init();
+        return this.teamPlaybookStore.values();
+    }
+    /**
+     * Count team playbooks.
+     */
+    async countTeamPlaybooks() {
+        await this.init();
+        return this.teamPlaybookStore.size();
+    }
+    // === ROLE PLAYBOOKS ===
+    /**
+     * Store a role playbook.
+     */
+    async storeRolePlaybook(playbook) {
+        await this.init();
+        this.rolePlaybookStore.set(playbook.id, playbook);
+        await this.rolePlaybookStore.save(playbook.id);
+    }
+    /**
+     * Find role playbooks matching a given role + team context.
+     */
+    async findMatchingRolePlaybooks(options) {
+        await this.init();
+        const k = options.k ?? 3;
+        let playbooks = this.rolePlaybookStore.values();
+        // Filter by role
+        playbooks = playbooks.filter((p) => p.role === options.role);
+        // Filter by topology
+        if (options.topology) {
+            playbooks = playbooks.filter((p) => p.teamContext.topologies.includes(options.topology));
+        }
+        // Filter by domain
+        if (options.domain) {
+            playbooks = playbooks.filter((p) => p.teamContext.domains.includes(options.domain));
+        }
+        // Score by task type similarity if provided
+        if (options.taskType) {
+            return findTopK(options.taskType, playbooks, (p) => p.teamContext.taskTypes.join(' '), k).map(({ item, score }) => ({ playbook: item, score }));
+        }
+        return playbooks
+            .sort((a, b) => b.confidence - a.confidence)
+            .slice(0, k)
+            .map((p) => ({ playbook: p, score: p.confidence }));
+    }
+    /**
+     * Get all role playbooks.
+     */
+    async getRolePlaybooks() {
+        await this.init();
+        return this.rolePlaybookStore.values();
+    }
+    /**
+     * Count role playbooks.
+     */
+    async countRolePlaybooks() {
+        await this.init();
+        return this.rolePlaybookStore.size();
+    }
+    // === META-OBSERVATIONS ===
+    /**
+     * Record a team meta-observation.
+     */
+    async recordMetaObservation(observation) {
+        await this.init();
+        this.metaObservationStore.set(observation.id, observation);
+        await this.metaObservationStore.save(observation.id);
+    }
+    /**
+     * Get all team meta-observations.
+     */
+    async getMetaObservations() {
+        await this.init();
+        return this.metaObservationStore.values();
+    }
+    /**
+     * Count team meta-observations.
+     */
+    async countMetaObservations() {
+        await this.init();
+        return this.metaObservationStore.size();
+    }
+    // === META-STRATEGIES ===
+    /**
+     * Store a team meta-strategy.
+     */
+    async storeMetaStrategy(strategy) {
+        await this.init();
+        this.metaStrategyStore.set(strategy.id, strategy);
+        await this.metaStrategyStore.save(strategy.id);
+    }
+    /**
+     * Get team meta-strategies matching given conditions.
+     */
+    async getMatchingMetaStrategies(context) {
+        await this.init();
+        let strategies = this.metaStrategyStore.values();
+        if (context.domains && context.domains.length > 0) {
+            strategies = strategies.filter((s) => s.condition.domains.some((d) => context.domains.includes(d)));
+        }
+        return strategies;
+    }
+    /**
+     * Get all team meta-strategies.
+     */
+    async getMetaStrategies() {
+        await this.init();
+        return this.metaStrategyStore.values();
+    }
+    /**
+     * Count team meta-strategies.
+     */
+    async countMetaStrategies() {
+        await this.init();
+        return this.metaStrategyStore.size();
+    }
+    // === AGGREGATE STATS ===
+    /**
+     * Get statistics about team memory contents.
+     */
+    async getStats() {
+        await this.init();
+        const [experiences, teamPlaybooks, rolePlaybooks, observations, strategies] = await Promise.all([
+            this.countTeamExperiences(),
+            this.countTeamPlaybooks(),
+            this.countRolePlaybooks(),
+            this.countMetaObservations(),
+            this.countMetaStrategies(),
+        ]);
+        return {
+            teamExperienceCount: experiences,
+            teamPlaybookCount: teamPlaybooks,
+            rolePlaybookCount: rolePlaybooks,
+            metaObservationCount: observations,
+            metaStrategyCount: strategies,
+        };
+    }
+    /**
+     * Close all stores.
+     */
+    async close() {
+        await Promise.all([
+            this.experienceStore.close(),
+            this.teamPlaybookStore.close(),
+            this.rolePlaybookStore.close(),
+            this.metaObservationStore.close(),
+            this.metaStrategyStore.close(),
+        ]);
+    }
+}
+/**
+ * Create a TeamExperienceMemory instance.
+ */
+export function createTeamExperienceMemory(baseDir) {
+    return new TeamExperienceMemory(baseDir);
+}
+//# sourceMappingURL=team-experience.js.map

package/dist/memory/team-experience.js.map

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

package/dist/memory/temporal-compressor.d.ts

@@ -0,0 +1,126 @@
+/**
+ * TemporalCompressor — Adaptive memory compression.
+ *
+ * Experiences flow through Hot → Warm → Cold → Evicted tiers
+ * based on their accessScore (from Phase 0).
+ *
+ * Compression levels:
+ * - Hot:  Full fidelity (all data preserved)
+ * - Warm: Strip solutionOutput to key steps only
+ * - Cold: Replace key steps with single-paragraph summary
+ * - Evicted: Remove entirely (after ensuring pattern captured in ReasoningBank)
+ *
+ * Hysteresis: An experience must stay below a threshold for 2 consecutive
+ * compression passes before demotion, preventing oscillation from a
+ * single retrieval hit.
+ */
+import type { Experience } from '../types/index.js';
+import type { SqlitePersistence } from '../persistence/index.js';
+/**
+ * Configuration for temporal compression
+ */
+export interface TemporalCompressorConfig {
+    /** accessScore above this = hot (default: 0.5) */
+    hotThreshold: number;
+    /** accessScore above this = warm (default: 0.2) */
+    warmThreshold: number;
+    /** accessScore below this = evict (default: 0.05) */
+    evictionThreshold: number;
+    /** Prevent oscillation between tiers (default: 0.05) */
+    hysteresis: number;
+}
+/**
+ * Result of a compression pass
+ */
+export interface CompressionResult {
+    /** IDs moved to a hotter tier (rare, via hysteresis) */
+    promoted: string[];
+    /** IDs moved to a colder tier */
+    demoted: string[];
+    /** IDs recommended for eviction */
+    evicted: string[];
+    /** IDs that stayed in the same tier */
+    unchanged: string[];
+    /** The modified experiences (for batch updating) */
+    updates: Map<string, Partial<Experience>>;
+}
+/**
+ * TemporalCompressor — evaluates and compresses experiences based on access scores
+ */
+export declare class TemporalCompressor {
+    private config;
+    private persistence?;
+    /**
+     * Track experiences that were below demotion threshold on the previous pass.
+     * Hysteresis: only demote after 2 consecutive passes below threshold.
+     */
+    private pendingDemotion;
+    constructor(options?: Partial<TemporalCompressorConfig>, persistence?: SqlitePersistence);
+    /**
+     * Evaluate and compress experiences based on their access scores.
+     * Returns a CompressionResult describing all tier changes.
+     */
+    compress(experiences: Experience[]): Promise<CompressionResult>;
+    /**
+     * Load persisted pending demotions. Call after persistence is initialized.
+     */
+    loadPersistedState(): void;
+    /**
+     * Compress a single experience from hot → warm.
+     * Strips solutionOutput to key steps only.
+     */
+    compressToWarm(experience: Experience): Experience;
+    /**
+     * Compress a single experience from warm → cold.
+     * Replaces key steps with a single-paragraph summary.
+     */
+    compressToCold(experience: Experience): Experience;
+    /**
+     * Determine the target tier for a given access score.
+     */
+    private computeTargetTier;
+    /**
+     * Numeric ordering for tiers (higher = hotter).
+     */
+    private tierOrder;
+    /**
+     * Get the next colder tier.
+     */
+    private nextColderTier;
+    /**
+     * Get the next hotter tier.
+     */
+    private nextHotterTier;
+    /**
+     * Get the threshold needed for promotion from a tier (with hysteresis).
+     */
+    private getPromotionThreshold;
+    /**
+     * Handle a demotion with hysteresis.
+     * Only demote after 2 consecutive passes below threshold.
+     */
+    private handleDemotion;
+    /**
+     * Promote an experience to a hotter tier.
+     * Note: data can't be un-compressed, but the tier changes.
+     */
+    private promoteTier;
+    /**
+     * Extract key steps from a solution output.
+     * Looks for tool calls, error messages, and outcome-relevant actions.
+     */
+    private extractKeySteps;
+    /**
+     * Estimate the original step count from an experience.
+     */
+    private estimateStepCount;
+    /**
+     * Generate a one-paragraph summary for cold tier.
+     */
+    private generateSummary;
+}
+/**
+ * Create a TemporalCompressor
+ */
+export declare function createTemporalCompressor(options?: Partial<TemporalCompressorConfig>, persistence?: SqlitePersistence): TemporalCompressor;
+//# sourceMappingURL=temporal-compressor.d.ts.map

package/dist/memory/temporal-compressor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal-compressor.d.ts","sourceRoot":"","sources":["../../src/memory/temporal-compressor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAEjE;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,aAAa,EAAE,MAAM,CAAC;IACtB,qDAAqD;IACrD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,wDAAwD;IACxD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,iCAAiC;IACjC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,mCAAmC;IACnC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,uCAAuC;IACvC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,oDAAoD;IACpD,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC;CAC3C;AASD;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,WAAW,CAAC,CAAoB;IAExC;;;OAGG;IACH,OAAO,CAAC,eAAe,CAA0B;gBAErC,OAAO,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,EAAE,WAAW,CAAC,EAAE,iBAAiB;IAaxF;;;OAGG;IACG,QAAQ,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAiErE;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAS1B;;;OAGG;IACH,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU;IAgBlD;;;OAGG;IACH,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,UAAU;IAmBlD;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAOzB;;OAEG;IACH,OAAO,CAAC,SAAS;IAQjB;;OAEG;IACH,OAAO,CAAC,cAAc;IAQtB;;OAEG;IACH,OAAO,CAAC,cAAc;IAQtB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAQ7B;;;OAGG;IACH,OAAO,CAAC,cAAc;IAgCtB;;;OAGG;IACH,OAAO,CAAC,WAAW;IAOnB;;;OAGG;IACH,OAAO,CAAC,eAAe;IAkDvB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAazB;;OAEG;IACH,OAAO,CAAC,eAAe;CAiBxB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,EAC3C,WAAW,CAAC,EAAE,iBAAiB,GAC9B,kBAAkB,CAEpB"}