cognitive-core 0.0.2 → 0.1.2

package/dist/surfacing/skill-publisher.js

@@ -0,0 +1,197 @@
+/**
+ * Skill Publisher
+ *
+ * Converts cognitive-core Playbooks to skill-tree's Skill format and
+ * writes them directly to a StorageAdapter. Handles the Playbook → Skill
+ * conversion at the publish boundary.
+ */
+import { getPlaybookSuccessRate } from '../types/playbook.js';
+/**
+ * Convert a Playbook to a Skill
+ */
+export function convertPlaybookToSkill(playbook) {
+    const totalUses = playbook.evolution.successCount + playbook.evolution.failureCount;
+    const successRate = getPlaybookSuccessRate(playbook);
+    // Build solution text from guidance
+    let solution = playbook.guidance.strategy;
+    if (playbook.guidance.tactics.length > 0) {
+        solution += '\n\nTactics:\n' + playbook.guidance.tactics.map((t, i) => `${i + 1}. ${t}`).join('\n');
+    }
+    if (playbook.guidance.steps?.length) {
+        solution += '\n\nSteps:\n' + playbook.guidance.steps.map((s, i) => `${i + 1}. ${s}`).join('\n');
+    }
+    // Build verification text
+    const verification = playbook.verification.successIndicators.length > 0
+        ? playbook.verification.successIndicators.join('. ')
+        : 'Verify the approach worked as expected.';
+    // Build notes from anti-patterns and refinements
+    const notesParts = [];
+    if (playbook.applicability.antiPatterns.length > 0) {
+        notesParts.push('Do NOT use when: ' + playbook.applicability.antiPatterns.join('; '));
+    }
+    if (playbook.verification.failureIndicators.length > 0) {
+        notesParts.push('Watch for: ' + playbook.verification.failureIndicators.join('; '));
+    }
+    if (playbook.evolution.refinements.length > 0) {
+        notesParts.push('Refinements:\n' + playbook.evolution.refinements.map(r => `- In ${r.context}: ${r.addition}`).join('\n'));
+    }
+    if (playbook.verification.rollbackStrategy) {
+        notesParts.push('Rollback: ' + playbook.verification.rollbackStrategy);
+    }
+    // Build trigger conditions
+    const triggerConditions = extractTriggerConditions(playbook);
+    // Build description for semantic matching
+    const description = playbook.applicability.situations[0]
+        ?? `${playbook.name}: ${playbook.guidance.strategy.slice(0, 100)}`;
+    // Estimate tokens (rough: 4 chars per token)
+    const fullText = [playbook.name, solution, verification, ...notesParts].join(' ');
+    const tokenEstimate = Math.ceil(fullText.length / 4);
+    return {
+        id: playbook.id,
+        name: playbook.name,
+        version: playbook.evolution.version,
+        description,
+        problem: playbook.applicability.situations.join('. '),
+        triggerConditions,
+        solution,
+        verification,
+        examples: playbook.guidance.codeExample
+            ? [{ scenario: playbook.applicability.situations[0] ?? playbook.name, before: '', after: playbook.guidance.codeExample }]
+            : [],
+        notes: notesParts.length > 0 ? notesParts.join('\n\n') : undefined,
+        author: 'cognitive-core',
+        tags: playbook.applicability.domains,
+        status: 'active',
+        metrics: {
+            usageCount: totalUses,
+            successRate,
+            lastUsed: playbook.evolution.lastUsed,
+            feedbackScores: [],
+            averageConfidence: playbook.confidence,
+        },
+        source: {
+            type: 'extracted',
+            sessionId: playbook.evolution.createdFrom[0],
+            importedAt: playbook.createdAt,
+        },
+        serving: {
+            summary: description.length > 150 ? description.slice(0, 147) + '...' : description,
+            tokenEstimate,
+        },
+        createdAt: playbook.createdAt,
+        updatedAt: playbook.updatedAt,
+    };
+}
+/**
+ * Extract trigger conditions from playbook applicability
+ */
+function extractTriggerConditions(playbook) {
+    const triggers = [];
+    // Add situation-based triggers
+    for (const situation of playbook.applicability.situations) {
+        triggers.push({
+            type: 'context',
+            value: situation,
+            description: 'Situation trigger',
+        });
+    }
+    // Add explicit triggers with type detection
+    for (const trigger of playbook.applicability.triggers) {
+        let type = 'keyword';
+        if (trigger.toLowerCase().includes('error') || /^[A-Z]{2,}\d+/.test(trigger)) {
+            type = 'error';
+        }
+        else if (trigger.startsWith('/') || trigger.includes('*')) {
+            type = 'pattern';
+        }
+        triggers.push({
+            type,
+            value: trigger,
+            description: 'Explicit trigger',
+        });
+    }
+    return triggers;
+}
+/**
+ * SkillPublisher - Manages publishing graduated playbooks to skill-tree storage
+ */
+export class SkillPublisher {
+    storage;
+    publishedIds = new Set();
+    constructor(storage) {
+        this.storage = storage;
+    }
+    /**
+     * Publish a playbook as a skill to skill-tree storage
+     */
+    async publishPlaybook(playbook) {
+        const skill = convertPlaybookToSkill(playbook);
+        try {
+            const existing = await this.storage.getSkill(skill.id);
+            await this.storage.saveSkill(skill);
+            this.publishedIds.add(skill.id);
+            return {
+                published: true,
+                skillId: skill.id,
+                version: skill.version,
+                isUpdate: existing !== null,
+            };
+        }
+        catch (error) {
+            return {
+                published: false,
+                skillId: skill.id,
+                version: skill.version,
+                isUpdate: false,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    /**
+     * Publish multiple playbooks
+     */
+    async publishPlaybooks(playbooks) {
+        const results = [];
+        for (const playbook of playbooks) {
+            results.push(await this.publishPlaybook(playbook));
+        }
+        return results;
+    }
+    /**
+     * Deprecate a skill in storage
+     */
+    async deprecateSkill(skillId, reason) {
+        try {
+            const existing = await this.storage.getSkill(skillId);
+            if (!existing) {
+                return { deprecated: false, skillId, error: 'Skill not found' };
+            }
+            existing.status = 'deprecated';
+            existing.notes = (existing.notes ? existing.notes + '\n\n' : '') + `Deprecated: ${reason}`;
+            existing.updatedAt = new Date();
+            await this.storage.saveSkill(existing);
+            this.publishedIds.delete(skillId);
+            return { deprecated: true, skillId };
+        }
+        catch (error) {
+            return {
+                deprecated: false,
+                skillId,
+                error: error instanceof Error ? error.message : String(error),
+            };
+        }
+    }
+    /**
+     * Check if a playbook has been published
+     */
+    isPublished(playbookId) {
+        return this.publishedIds.has(playbookId);
+    }
+    /**
+     * Get count of published skills
+     */
+    getPublishedCount() {
+        return this.publishedIds.size;
+    }
+}
+//# sourceMappingURL=skill-publisher.js.map

package/dist/surfacing/skill-publisher.js.map

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

package/dist/surfacing/sqlite-storage-adapter.d.ts

@@ -0,0 +1,42 @@
+/**
+ * SQLite Storage Adapter for skill-tree
+ *
+ * Implements skill-tree's StorageAdapter interface using better-sqlite3,
+ * providing persistent skill storage for the learn → graduate → publish loop.
+ *
+ * Follows the same SQLite patterns used by src/embeddings/vector-store.ts:
+ * CREATE IF NOT EXISTS, prepared statements, INSERT OR REPLACE.
+ */
+import type { Skill, StorageAdapter, SkillVersion, SkillLineage } from 'skill-tree';
+/**
+ * SQLite-backed StorageAdapter for skill-tree.
+ *
+ * Stores skills in a `skills` table with JSON columns for nested objects
+ * (tags, metrics, triggerConditions, etc.). Version history is tracked in
+ * a separate `skill_versions` table. Dates are stored as ISO strings.
+ */
+export declare class SqliteStorageAdapter implements StorageAdapter {
+    private db;
+    private initialized;
+    constructor(dbPath: string);
+    initialize(): Promise<void>;
+    getSkill(id: string): Promise<Skill | null>;
+    saveSkill(skill: Skill): Promise<void>;
+    listSkills(filter?: {
+        tags?: string[];
+        status?: string[];
+    }): Promise<Skill[]>;
+    deleteSkill(id: string): Promise<boolean>;
+    getVersionHistory(skillId: string): Promise<SkillVersion[]>;
+    getLineage(skillId: string): Promise<SkillLineage | null>;
+    searchSkills(query: string): Promise<Skill[]>;
+    /**
+     * Close the database connection. Call when Atlas is shutting down.
+     */
+    close(): void;
+    /**
+     * Convert a database row to a Skill object, parsing JSON columns and dates.
+     */
+    private rowToSkill;
+}
+//# sourceMappingURL=sqlite-storage-adapter.d.ts.map

package/dist/surfacing/sqlite-storage-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-storage-adapter.d.ts","sourceRoot":"","sources":["../../src/surfacing/sqlite-storage-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAmCpF;;;;;;GAMG;AACH,qBAAa,oBAAqB,YAAW,cAAc;IACzD,OAAO,CAAC,EAAE,CAAoB;IAC9B,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,EAAE,MAAM;IAMpB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAiD3B,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC;IAK3C,SAAS,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC;IAqDtC,UAAU,CAAC,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAyB7E,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMzC,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAe3D,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAWzD,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAanD;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,OAAO,CAAC,UAAU;CA2BnB"}

package/dist/surfacing/sqlite-storage-adapter.js

@@ -0,0 +1,207 @@
+/**
+ * SQLite Storage Adapter for skill-tree
+ *
+ * Implements skill-tree's StorageAdapter interface using better-sqlite3,
+ * providing persistent skill storage for the learn → graduate → publish loop.
+ *
+ * Follows the same SQLite patterns used by src/embeddings/vector-store.ts:
+ * CREATE IF NOT EXISTS, prepared statements, INSERT OR REPLACE.
+ */
+import Database from 'better-sqlite3';
+/**
+ * SQLite-backed StorageAdapter for skill-tree.
+ *
+ * Stores skills in a `skills` table with JSON columns for nested objects
+ * (tags, metrics, triggerConditions, etc.). Version history is tracked in
+ * a separate `skill_versions` table. Dates are stored as ISO strings.
+ */
+export class SqliteStorageAdapter {
+    db;
+    initialized = false;
+    constructor(dbPath) {
+        this.db = new Database(dbPath);
+        // Enable WAL mode for better concurrent read performance
+        this.db.pragma('journal_mode = WAL');
+    }
+    async initialize() {
+        if (this.initialized)
+            return;
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS skills (
+        id TEXT PRIMARY KEY,
+        name TEXT NOT NULL,
+        version TEXT NOT NULL,
+        description TEXT,
+        problem TEXT,
+        solution TEXT NOT NULL,
+        verification TEXT,
+        notes TEXT,
+        author TEXT,
+        status TEXT NOT NULL DEFAULT 'active',
+        tags TEXT NOT NULL DEFAULT '[]',
+        trigger_conditions TEXT NOT NULL DEFAULT '[]',
+        examples TEXT NOT NULL DEFAULT '[]',
+        metrics TEXT NOT NULL DEFAULT '{}',
+        source TEXT NOT NULL DEFAULT '{}',
+        serving TEXT NOT NULL DEFAULT '{}',
+        created_at TEXT NOT NULL,
+        updated_at TEXT NOT NULL
+      )
+    `);
+        this.db.exec(`
+      CREATE TABLE IF NOT EXISTS skill_versions (
+        skill_id TEXT NOT NULL,
+        version TEXT NOT NULL,
+        skill_snapshot TEXT NOT NULL,
+        changelog TEXT NOT NULL DEFAULT '',
+        content_hash TEXT NOT NULL DEFAULT '',
+        created_at TEXT NOT NULL,
+        PRIMARY KEY (skill_id, version)
+      )
+    `);
+        this.db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_skills_status ON skills(status)
+    `);
+        this.db.exec(`
+      CREATE INDEX IF NOT EXISTS idx_skills_name ON skills(name)
+    `);
+        this.initialized = true;
+    }
+    async getSkill(id) {
+        const row = this.db.prepare('SELECT * FROM skills WHERE id = ?').get(id);
+        return row ? this.rowToSkill(row) : null;
+    }
+    async saveSkill(skill) {
+        const transaction = this.db.transaction(() => {
+            // Upsert the skill
+            const stmt = this.db.prepare(`
+        INSERT OR REPLACE INTO skills
+          (id, name, version, description, problem, solution, verification, notes,
+           author, status, tags, trigger_conditions, examples, metrics, source,
+           serving, created_at, updated_at)
+        VALUES
+          (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+      `);
+            stmt.run(skill.id, skill.name, skill.version, skill.description ?? null, skill.problem ?? null, skill.solution, skill.verification ?? null, skill.notes ?? null, skill.author ?? null, skill.status, JSON.stringify(skill.tags ?? []), JSON.stringify(skill.triggerConditions ?? []), JSON.stringify(skill.examples ?? []), JSON.stringify(skill.metrics ?? {}), JSON.stringify(skill.source ?? {}), JSON.stringify(skill.serving ?? {}), toISOString(skill.createdAt), toISOString(skill.updatedAt));
+            // Record version snapshot
+            const versionStmt = this.db.prepare(`
+        INSERT OR IGNORE INTO skill_versions
+          (skill_id, version, skill_snapshot, changelog, content_hash, created_at)
+        VALUES (?, ?, ?, ?, ?, ?)
+      `);
+            versionStmt.run(skill.id, skill.version, JSON.stringify(skill), '', hashSkill(skill), toISOString(skill.updatedAt));
+        });
+        transaction();
+    }
+    async listSkills(filter) {
+        let query = 'SELECT * FROM skills WHERE 1=1';
+        const params = [];
+        if (filter?.status?.length) {
+            const placeholders = filter.status.map(() => '?').join(',');
+            query += ` AND status IN (${placeholders})`;
+            params.push(...filter.status);
+        }
+        query += ' ORDER BY updated_at DESC';
+        const rows = this.db.prepare(query).all(...params);
+        let skills = rows.map(r => this.rowToSkill(r));
+        // Post-filter by tags (JSON array column — filter in JS for simplicity)
+        if (filter?.tags?.length) {
+            skills = skills.filter(s => filter.tags.some(tag => s.tags?.includes(tag)));
+        }
+        return skills;
+    }
+    async deleteSkill(id) {
+        const result = this.db.prepare('DELETE FROM skills WHERE id = ?').run(id);
+        // Keep version history for lineage tracking
+        return result.changes > 0;
+    }
+    async getVersionHistory(skillId) {
+        const rows = this.db.prepare('SELECT * FROM skill_versions WHERE skill_id = ? ORDER BY created_at ASC').all(skillId);
+        return rows.map(row => ({
+            skillId: row.skill_id,
+            version: row.version,
+            skill: JSON.parse(row.skill_snapshot),
+            changelog: row.changelog,
+            contentHash: row.content_hash,
+            createdAt: new Date(row.created_at),
+        }));
+    }
+    async getLineage(skillId) {
+        const versions = await this.getVersionHistory(skillId);
+        if (versions.length === 0)
+            return null;
+        return {
+            rootId: skillId,
+            versions,
+            forks: [], // Forks are not tracked in this adapter
+        };
+    }
+    async searchSkills(query) {
+        // Simple LIKE-based search across name, description, and solution
+        const rows = this.db.prepare(`
+      SELECT * FROM skills
+      WHERE name LIKE ? OR description LIKE ? OR solution LIKE ? OR problem LIKE ?
+      ORDER BY updated_at DESC
+    `).all(`%${query}%`, `%${query}%`, `%${query}%`, `%${query}%`);
+        return rows.map(r => this.rowToSkill(r));
+    }
+    /**
+     * Close the database connection. Call when Atlas is shutting down.
+     */
+    close() {
+        this.db.close();
+    }
+    /**
+     * Convert a database row to a Skill object, parsing JSON columns and dates.
+     */
+    rowToSkill(row) {
+        const metrics = JSON.parse(row.metrics);
+        return {
+            id: row.id,
+            name: row.name,
+            version: row.version,
+            description: row.description ?? '',
+            problem: row.problem ?? '',
+            solution: row.solution,
+            verification: row.verification ?? '',
+            notes: row.notes ?? undefined,
+            author: row.author ?? 'unknown',
+            status: row.status,
+            tags: JSON.parse(row.tags),
+            triggerConditions: JSON.parse(row.trigger_conditions),
+            examples: JSON.parse(row.examples),
+            metrics: {
+                ...metrics,
+                lastUsed: metrics.lastUsed ? new Date(metrics.lastUsed) : undefined,
+            },
+            source: JSON.parse(row.source),
+            serving: JSON.parse(row.serving),
+            createdAt: new Date(row.created_at),
+            updatedAt: new Date(row.updated_at),
+        };
+    }
+}
+/**
+ * Safely convert a Date or string to ISO string.
+ */
+function toISOString(value) {
+    if (value instanceof Date)
+        return value.toISOString();
+    if (typeof value === 'string')
+        return value;
+    return new Date().toISOString();
+}
+/**
+ * Simple content hash for version tracking.
+ */
+function hashSkill(skill) {
+    const content = `${skill.name}:${skill.solution}:${skill.version}`;
+    let hash = 0;
+    for (let i = 0; i < content.length; i++) {
+        const char = content.charCodeAt(i);
+        hash = ((hash << 5) - hash) + char;
+        hash |= 0;
+    }
+    return Math.abs(hash).toString(36);
+}
+//# sourceMappingURL=sqlite-storage-adapter.js.map

package/dist/surfacing/sqlite-storage-adapter.js.map

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

package/dist/surfacing/team-skill-library.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Team Skill Library
+ *
+ * Tiered surfacing of team playbooks and role playbooks for
+ * team formation decisions and agent role guidance injection.
+ *
+ * The team-level analog of SkillLibrary.
+ *
+ * Responsibilities:
+ * - Rank team playbooks by relevance, confidence, and success rate
+ * - Rank role playbooks for each role in a recommended team
+ * - Format role guidance for injection into agent system prompts
+ * - Record team outcome feedback to update playbook evolution
+ * - Tier management: promote/demote team playbooks based on track record
+ */
+import type { TeamPlaybook, RolePlaybook } from '../types/index.js';
+import type { TeamExperienceMemory } from '../memory/team-experience.js';
+export interface TeamSkillLibraryConfig {
+    /** Promotion criteria for core team playbooks */
+    promotion: {
+        minConfidence: number;
+        minSuccessCount: number;
+        minSuccessRate: number;
+    };
+    /** Maximum items to surface */
+    limits: {
+        maxCoreTeamPlaybooks: number;
+        maxRolePlaybooksPerRole: number;
+        maxTokensForGuidance: number;
+    };
+    /** Demotion criteria */
+    demotion: {
+        failureThreshold: number;
+        minConfidenceToRetain: number;
+    };
+}
+/**
+ * A team playbook with ranking scores.
+ */
+export interface RankedTeamPlaybook {
+    playbook: TeamPlaybook;
+    relevanceScore: number;
+    successRate: number;
+    /** Combined ranking score */
+    rankScore: number;
+}
+/**
+ * A role playbook with ranking scores.
+ */
+export interface RankedRolePlaybook {
+    playbook: RolePlaybook;
+    relevanceScore: number;
+    successRate: number;
+    rankScore: number;
+}
+/**
+ * Team outcome feedback for the evolution loop.
+ */
+export interface TeamOutcomeFeedback {
+    /** Which team playbook was used */
+    playbookId: string;
+    /** Team trajectory ID (optional) */
+    teamTrajectoryId?: string;
+    /** Whether the team succeeded */
+    success: boolean;
+    /** Quality of the outcome */
+    quality: 'excellent' | 'good' | 'acceptable' | 'poor';
+    /** Optional notes */
+    notes?: string;
+    /** Observed metrics */
+    metrics?: {
+        coordinationOverhead?: number;
+        parallelismRatio?: number;
+        timeToFirstOutput?: number;
+    };
+}
+/**
+ * Role outcome feedback.
+ */
+export interface RoleOutcomeFeedback {
+    /** Which role playbook was used */
+    playbookId: string;
+    /** Whether the role was effective */
+    success: boolean;
+    /** Quality assessment */
+    quality: 'excellent' | 'good' | 'acceptable' | 'poor';
+}
+/**
+ * Team skills organized for injection.
+ */
+export interface TeamAgentSkills {
+    /** Core team playbooks (highest confidence, always surfaced) */
+    coreTeamPlaybooks: TeamPlaybook[];
+    /** Matched team playbooks for this specific task */
+    matchedTeamPlaybooks: TeamPlaybook[];
+    /** Role playbooks organized by role */
+    rolePlaybooks: Map<string, RolePlaybook[]>;
+    /** Estimated token count */
+    totalTokenEstimate: number;
+}
+export declare class TeamSkillLibrary {
+    private memory;
+    private config;
+    private coreTeamPlaybooks;
+    private lastRefresh;
+    private consecutiveFailures;
+    constructor(memory: TeamExperienceMemory, config?: Partial<TeamSkillLibraryConfig>);
+    /**
+     * Refresh core team playbook tiers based on current state.
+     */
+    refreshTiers(): Promise<{
+        promoted: string[];
+        demoted: string[];
+        coreCount: number;
+    }>;
+    private meetsPromotionCriteria;
+    private meetsDemotionCriteria;
+    /**
+     * Find and rank team playbooks for a task.
+     */
+    findMatchingTeamPlaybooks(query: {
+        taskType?: string;
+        domain?: string;
+        topology?: string;
+        complexity?: string;
+        k?: number;
+    }): Promise<RankedTeamPlaybook[]>;
+    /**
+     * Find and rank role playbooks for a specific role.
+     */
+    findRolePlaybooks(role: string, context: {
+        topology?: string;
+        taskType?: string;
+        domain?: string;
+    }): Promise<RankedRolePlaybook[]>;
+    /**
+     * Get team skills organized for agent context.
+     */
+    getSkillsForTeam(query: {
+        description: string;
+        domain: string;
+        complexity?: string;
+        roles: string[];
+        topology?: string;
+    }): Promise<TeamAgentSkills>;
+    /**
+     * Format role guidance for injection into an agent's system prompt.
+     */
+    formatRoleGuidance(role: string, rolePlaybooks: RolePlaybook[]): string;
+    /**
+     * Format team playbook summary for team formation context.
+     */
+    formatTeamPlaybookSummary(playbooks: TeamPlaybook[]): string;
+    /**
+     * Record team playbook outcome feedback.
+     * Updates evolution stats and recalculates confidence.
+     */
+    recordTeamOutcome(feedback: TeamOutcomeFeedback): Promise<void>;
+    /**
+     * Record role playbook outcome feedback.
+     */
+    recordRoleOutcome(feedback: RoleOutcomeFeedback): Promise<void>;
+    getCoreTeamPlaybooks(): TeamPlaybook[];
+    getLastRefresh(): Date | null;
+    getStats(): {
+        coreTeamPlaybookCount: number;
+        lastRefresh: Date | null;
+        consecutiveFailures: Record<string, number>;
+    };
+    private computeRankScore;
+    private recalculateConfidence;
+    private recalculateRoleConfidence;
+    private updateAvgMetrics;
+    private estimateTokens;
+}
+/**
+ * Create a TeamSkillLibrary instance.
+ */
+export declare function createTeamSkillLibrary(memory: TeamExperienceMemory, config?: Partial<TeamSkillLibraryConfig>): TeamSkillLibrary;
+//# sourceMappingURL=team-skill-library.d.ts.map

package/dist/surfacing/team-skill-library.d.ts.map

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