cognitive-core 0.1.0 → 0.1.2

package/dist/session-bank/session-bank.js

@@ -0,0 +1,326 @@
+import { readFile, writeFile, mkdir } from 'node:fs/promises';
+import { join } from 'node:path';
+import { EntireGitReader } from './git-reader.js';
+import { EntireTranscriptParser } from './parser.js';
+export class SessionBank {
+    reader;
+    parser;
+    stateDir;
+    cacheEnabled;
+    available = false;
+    initialized = false;
+    // Cache
+    cachedBranchHead = null;
+    sessionCache = new Map();
+    checkpointCache = null;
+    // Processing state
+    processingState = {
+        entries: [],
+        sessionIds: new Set(),
+    };
+    constructor(options) {
+        const repoPath = options?.repoPath ?? process.cwd();
+        const branch = options?.branch ?? 'entire/checkpoints/v1';
+        this.stateDir = options?.stateDir ?? join(repoPath, '.atlas', 'session-bank');
+        this.cacheEnabled = options?.cache ?? true;
+        this.reader = new EntireGitReader({ repoPath, branch });
+        this.parser = new EntireTranscriptParser();
+    }
+    // ── Lifecycle ──────────────────────────────────────────────────
+    async init() {
+        this.available = await this.reader.branchExists();
+        await this.loadProcessingState();
+        if (this.available) {
+            this.cachedBranchHead = await this.reader.getBranchHead();
+        }
+        this.initialized = true;
+    }
+    isAvailable() {
+        return this.available;
+    }
+    async close() {
+        await this.saveProcessingState();
+    }
+    // ── Discovery (metadata-only, fast) ───────────────────────────
+    async listCheckpoints() {
+        this.ensureInitialized();
+        if (!this.available)
+            return [];
+        await this.ensureCacheValid();
+        if (this.checkpointCache)
+            return this.checkpointCache;
+        const checkpointPaths = await this.reader.listCheckpoints();
+        const refs = [];
+        for (const path of checkpointPaths) {
+            try {
+                const rootMeta = await this.reader.readFileOrNull(`${path}/metadata.json`);
+                if (rootMeta) {
+                    const ref = this.parser.parseCheckpointSummary(rootMeta, path);
+                    refs.push(ref);
+                }
+            }
+            catch {
+                // Skip corrupt checkpoints
+            }
+        }
+        if (this.cacheEnabled) {
+            this.checkpointCache = refs;
+        }
+        return refs;
+    }
+    async discover() {
+        this.ensureInitialized();
+        if (!this.available)
+            return [];
+        const refs = await this.listCheckpoints();
+        const sessions = [];
+        for (const ref of refs) {
+            const sessionIndices = await this.reader.listSessions(ref.path);
+            for (const idx of sessionIndices) {
+                const cacheKey = `${ref.path}/${idx}`;
+                const cached = this.sessionCache.get(cacheKey);
+                if (cached) {
+                    sessions.push(cached.record);
+                    continue;
+                }
+                try {
+                    const metaJson = await this.reader.readFile(`${ref.path}/${idx}/metadata.json`);
+                    const parsed = this.parser.parseMetadata(metaJson);
+                    const record = {
+                        sessionId: parsed.sessionId,
+                        checkpointId: parsed.checkpointId,
+                        metadata: parsed.metadata,
+                        transcript: [], // lazy — not loaded during discover
+                        summary: parsed.summary,
+                        tokenUsage: parsed.tokenUsage,
+                        attribution: parsed.attribution,
+                        source: {
+                            branch: 'entire/checkpoints/v1',
+                            checkpointPath: ref.path,
+                            sessionIndex: idx,
+                        },
+                    };
+                    if (this.cacheEnabled) {
+                        this.sessionCache.set(cacheKey, {
+                            record,
+                            hasTranscript: false,
+                        });
+                    }
+                    sessions.push(record);
+                }
+                catch {
+                    // Skip sessions with unreadable metadata
+                }
+            }
+        }
+        return sessions;
+    }
+    async count(query) {
+        const sessions = await this.discover();
+        return this.filterByMetadata(sessions, query).length;
+    }
+    // ── Querying (loads transcripts on demand) ────────────────────
+    async query(query) {
+        this.ensureInitialized();
+        if (!this.available)
+            return { sessions: [], total: 0 };
+        // Discover all sessions (metadata only)
+        let sessions = await this.discover();
+        // Apply metadata-based filters first
+        sessions = this.filterByMetadata(sessions, query);
+        const total = sessions.length;
+        // Sort
+        const sort = query?.sort ?? 'newest';
+        sessions.sort((a, b) => {
+            const diff = a.metadata.createdAt.getTime() - b.metadata.createdAt.getTime();
+            return sort === 'newest' ? -diff : diff;
+        });
+        // Apply limit
+        if (query?.limit && query.limit > 0) {
+            sessions = sessions.slice(0, query.limit);
+        }
+        // Load transcripts for matching sessions
+        const fullSessions = await Promise.all(sessions.map((s) => this.loadTranscript(s)));
+        // Apply search filter (requires transcript)
+        let result = fullSessions;
+        if (query?.search) {
+            const needle = query.search.toLowerCase();
+            result = result.filter((s) => s.transcript.some((msg) => msg.role === 'user' &&
+                msg.content.some((b) => b.type === 'text' &&
+                    b.text.toLowerCase().includes(needle))));
+        }
+        return { sessions: result, total };
+    }
+    async getBySessionId(sessionId) {
+        const sessions = await this.discover();
+        const match = sessions.find((s) => s.sessionId === sessionId);
+        if (!match)
+            return undefined;
+        return this.loadTranscript(match);
+    }
+    async getByCheckpointId(checkpointId) {
+        // Derive path from checkpoint ID
+        const shard = checkpointId.slice(0, 2);
+        const rest = checkpointId.slice(2);
+        const path = `${shard}/${rest}`;
+        const sessionIndices = await this.reader.listSessions(path);
+        const sessions = [];
+        for (const idx of sessionIndices) {
+            try {
+                const metaJson = await this.reader.readFile(`${path}/${idx}/metadata.json`);
+                const transcriptJsonl = await this.reader.readFileOrNull(`${path}/${idx}/full.jsonl`);
+                const record = this.parser.parseSession(metaJson, transcriptJsonl ?? '', path, idx);
+                sessions.push(record);
+            }
+            catch {
+                // Skip sessions with errors
+            }
+        }
+        return sessions;
+    }
+    async getByCommit(commitSha) {
+        const checkpointId = await this.reader.getCheckpointTrailer(commitSha);
+        if (!checkpointId)
+            return [];
+        return this.getByCheckpointId(checkpointId);
+    }
+    // ── Processing Tracking ───────────────────────────────────────
+    async markProcessed(sessionId, metadata) {
+        const entry = {
+            sessionId,
+            processedAt: new Date(),
+            metadata,
+        };
+        this.processingState.entries.push(entry);
+        this.processingState.sessionIds.add(sessionId);
+        await this.saveProcessingState();
+    }
+    isProcessed(sessionId) {
+        return this.processingState.sessionIds.has(sessionId);
+    }
+    getProcessingLog() {
+        return [...this.processingState.entries];
+    }
+    // ── Cache Management ──────────────────────────────────────────
+    invalidateCache() {
+        this.sessionCache.clear();
+        this.checkpointCache = null;
+        this.cachedBranchHead = null;
+    }
+    // ── Private helpers ───────────────────────────────────────────
+    ensureInitialized() {
+        if (!this.initialized) {
+            throw new Error('SessionBank not initialized. Call init() first.');
+        }
+    }
+    async ensureCacheValid() {
+        if (!this.cacheEnabled)
+            return;
+        const currentHead = await this.reader.getBranchHead();
+        if (currentHead !== this.cachedBranchHead) {
+            this.invalidateCache();
+            this.cachedBranchHead = currentHead;
+        }
+    }
+    filterByMetadata(sessions, query) {
+        if (!query)
+            return sessions;
+        let result = sessions;
+        if (query.since) {
+            const since = query.since.getTime();
+            result = result.filter((s) => s.metadata.createdAt.getTime() >= since);
+        }
+        if (query.before) {
+            const before = query.before.getTime();
+            result = result.filter((s) => s.metadata.createdAt.getTime() < before);
+        }
+        if (query.branch) {
+            result = result.filter((s) => s.metadata.branch === query.branch);
+        }
+        if (query.agent) {
+            result = result.filter((s) => s.metadata.agent === query.agent);
+        }
+        if (query.strategy) {
+            result = result.filter((s) => s.metadata.strategy === query.strategy);
+        }
+        if (query.hasSummary !== undefined) {
+            result = result.filter((s) => (s.summary !== undefined) === query.hasSummary);
+        }
+        if (query.unprocessedOnly) {
+            result = result.filter((s) => !this.isProcessed(s.sessionId));
+        }
+        return result;
+    }
+    async loadTranscript(session) {
+        // Check if transcript is already loaded
+        if (session.transcript.length > 0)
+            return session;
+        const cacheKey = `${session.source.checkpointPath}/${session.source.sessionIndex}`;
+        const cached = this.sessionCache.get(cacheKey);
+        if (cached?.hasTranscript)
+            return cached.record;
+        const basePath = `${session.source.checkpointPath}/${session.source.sessionIndex}`;
+        // Try single file first
+        let transcriptContent = await this.reader.readFileOrNull(`${basePath}/full.jsonl`);
+        if (transcriptContent === null) {
+            // Try chunked format
+            const chunks = [];
+            for (let i = 1;; i++) {
+                const chunkNum = String(i).padStart(3, '0');
+                const chunk = await this.reader.readFileOrNull(`${basePath}/full.jsonl.${chunkNum}`);
+                if (chunk === null)
+                    break;
+                chunks.push(chunk);
+            }
+            if (chunks.length > 0) {
+                transcriptContent = chunks.join('\n');
+            }
+        }
+        const transcript = transcriptContent
+            ? this.parser.parseTranscript(transcriptContent)
+            : [];
+        const fullRecord = { ...session, transcript };
+        if (this.cacheEnabled) {
+            this.sessionCache.set(cacheKey, {
+                record: fullRecord,
+                hasTranscript: true,
+            });
+        }
+        return fullRecord;
+    }
+    async loadProcessingState() {
+        try {
+            const raw = await readFile(join(this.stateDir, 'processed.json'), 'utf-8');
+            const data = JSON.parse(raw);
+            const entries = (data.entries ?? []).map((e) => ({
+                sessionId: e.sessionId,
+                processedAt: new Date(e.processedAt),
+                metadata: e.metadata,
+            }));
+            this.processingState = {
+                entries,
+                sessionIds: new Set(entries.map((e) => e.sessionId)),
+            };
+        }
+        catch {
+            // No existing state — start fresh
+            this.processingState = { entries: [], sessionIds: new Set() };
+        }
+    }
+    async saveProcessingState() {
+        try {
+            await mkdir(this.stateDir, { recursive: true });
+            await writeFile(join(this.stateDir, 'processed.json'), JSON.stringify({
+                entries: this.processingState.entries.map((e) => ({
+                    sessionId: e.sessionId,
+                    processedAt: e.processedAt.toISOString(),
+                    metadata: e.metadata,
+                })),
+            }, null, 2), 'utf-8');
+        }
+        catch {
+            // Best-effort persistence
+        }
+    }
+}
+//# sourceMappingURL=session-bank.js.map

package/dist/session-bank/session-bank.js.map

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

package/dist/session-bank/types.d.ts

@@ -0,0 +1,129 @@
+export interface TextBlock {
+    type: 'text';
+    text: string;
+}
+export interface ToolUseBlock {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+}
+export interface ToolResultBlock {
+    type: 'tool_result';
+    toolUseId: string;
+    content: string;
+    isError?: boolean;
+}
+export type ContentBlock = TextBlock | ToolUseBlock | ToolResultBlock;
+export interface TranscriptMessage {
+    /** Message role */
+    role: 'user' | 'assistant';
+    /** Unique message identifier */
+    uuid: string;
+    /** Content blocks (always an array, even for plain text) */
+    content: ContentBlock[];
+    /** Index in original JSONL file */
+    lineIndex: number;
+}
+export interface SessionSummary {
+    intent: string;
+    outcome: string;
+    learnings: {
+        repoPatterns: string[];
+        codeFindings: string[];
+        workflowPractices: string[];
+    };
+    frictionPoints: string[];
+    openItems: string[];
+}
+export interface TokenUsage {
+    inputTokens: number;
+    cacheCreationTokens: number;
+    cacheReadTokens: number;
+    outputTokens: number;
+    apiCallCount: number;
+    subagentUsage?: TokenUsage[];
+    /** Computed: sum of input + output + cache tokens */
+    total: number;
+}
+export interface Attribution {
+    agentLinesAdded: number;
+    humanAdditions: number;
+    humanModifications: number;
+    humanRemovals: number;
+    totalCommittedLines: number;
+    /** 0-1 percentage of agent contribution */
+    agentContribution: number;
+}
+export interface SessionMetadata {
+    cliVersion: string;
+    strategy: 'manual-commit' | 'auto-commit';
+    createdAt: Date;
+    branch: string;
+    agent: string;
+    filesTouched: string[];
+    isTask: boolean;
+    toolUseId?: string;
+    /** Line offset into the JSONL transcript */
+    checkpointTranscriptStart: number;
+}
+export interface SessionSource {
+    /** Orphan branch name */
+    branch: string;
+    /** Path on branch: "<id[:2]>/<id[2:]>" */
+    checkpointPath: string;
+    /** Session subdirectory index: "0", "1", etc. */
+    sessionIndex: string;
+    /** Git commit SHA on the orphan branch */
+    commitSha?: string;
+    /** Git commit SHA on the source branch linked via trailer */
+    linkedCommitSha?: string;
+}
+export interface SessionRecord {
+    sessionId: string;
+    checkpointId: string;
+    metadata: SessionMetadata;
+    transcript: TranscriptMessage[];
+    summary?: SessionSummary;
+    tokenUsage: TokenUsage;
+    attribution?: Attribution;
+    source: SessionSource;
+}
+export interface CheckpointRef {
+    checkpointId: string;
+    sessionIds: string[];
+    path: string;
+    sessionCount: number;
+}
+export interface SessionQuery {
+    since?: Date;
+    before?: Date;
+    branch?: string;
+    agent?: string;
+    search?: string;
+    strategy?: 'manual-commit' | 'auto-commit';
+    hasSummary?: boolean;
+    limit?: number;
+    sort?: 'newest' | 'oldest';
+    unprocessedOnly?: boolean;
+}
+export interface SessionQueryResult {
+    sessions: SessionRecord[];
+    total: number;
+}
+export interface ProcessingLogEntry {
+    sessionId: string;
+    processedAt: Date;
+    metadata?: Record<string, unknown>;
+}
+export interface SessionBankOptions {
+    /** Git repository path (default: process.cwd()) */
+    repoPath?: string;
+    /** Orphan branch name (default: 'entire/checkpoints/v1') */
+    branch?: string;
+    /** Directory to store processing state (default: '.atlas/session-bank') */
+    stateDir?: string;
+    /** Enable in-memory caching of parsed sessions (default: true) */
+    cache?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/session-bank/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/session-bank/types.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,UAAU,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,aAAa,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,YAAY,GAAG,eAAe,CAAC;AAItE,MAAM,WAAW,iBAAiB;IAChC,mBAAmB;IACnB,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,4DAA4D;IAC5D,OAAO,EAAE,YAAY,EAAE,CAAC;IACxB,mCAAmC;IACnC,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE;QACT,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,YAAY,EAAE,MAAM,EAAE,CAAC;QACvB,iBAAiB,EAAE,MAAM,EAAE,CAAC;KAC7B,CAAC;IACF,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAID,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,UAAU,EAAE,CAAC;IAC7B,qDAAqD;IACrD,KAAK,EAAE,MAAM,CAAC;CACf;AAID,MAAM,WAAW,WAAW;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,2CAA2C;IAC3C,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAID,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,eAAe,GAAG,aAAa,CAAC;IAC1C,SAAS,EAAE,IAAI,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,yBAAyB,EAAE,MAAM,CAAC;CACnC;AAID,MAAM,WAAW,aAAa;IAC5B,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,cAAc,EAAE,MAAM,CAAC;IACvB,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6DAA6D;IAC7D,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAID,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,eAAe,CAAC;IAC1B,UAAU,EAAE,iBAAiB,EAAE,CAAC;IAChC,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,MAAM,EAAE,aAAa,CAAC;CACvB;AAID,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB;AAID,MAAM,WAAW,YAAY;IAC3B,KAAK,CAAC,EAAE,IAAI,CAAC;IACb,MAAM,CAAC,EAAE,IAAI,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,eAAe,GAAG,aAAa,CAAC;IAC3C,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC3B,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,aAAa,EAAE,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC;CACf;AAID,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAID,MAAM,WAAW,kBAAkB;IACjC,mDAAmD;IACnD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB"}

package/dist/session-bank/types.js

@@ -0,0 +1,7 @@
+// ─── Session Bank Types ───────────────────────────────────────────────
+// Standalone types for reading Entire CLI checkpoint data.
+// Zero imports from cognitive-core — this module can be extracted into
+// its own package.
+// ─────────────────────────────────────────────────────────────────────
+export {};
+//# sourceMappingURL=types.js.map

package/dist/session-bank/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/session-bank/types.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,2DAA2D;AAC3D,uEAAuE;AACvE,mBAAmB;AACnB,wEAAwE"}

package/dist/surfacing/index.d.ts

@@ -1,2 +1,6 @@
 export { SkillLibrary, createSkillLibrary, type AgentSkills, type TierRefreshResult, } from './skill-library.js';
+export { TeamSkillLibrary, createTeamSkillLibrary, type TeamSkillLibraryConfig, type RankedTeamPlaybook, type RankedRolePlaybook, type TeamOutcomeFeedback, type RoleOutcomeFeedback, type TeamAgentSkills, } from './team-skill-library.js';
+export type { PublishResult, DeprecateResult, } from './publisher.js';
+export { SkillPublisher, convertPlaybookToSkill, } from './skill-publisher.js';
+export { SqliteStorageAdapter } from './sqlite-storage-adapter.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/surfacing/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/surfacing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/surfacing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,gBAAgB,EAChB,sBAAsB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,eAAe,GACrB,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EACV,aAAa,EACb,eAAe,GAChB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,cAAc,EACd,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/surfacing/index.js

@@ -1,2 +1,5 @@
 export { SkillLibrary, createSkillLibrary, } from './skill-library.js';
+export { TeamSkillLibrary, createTeamSkillLibrary, } from './team-skill-library.js';
+export { SkillPublisher, convertPlaybookToSkill, } from './skill-publisher.js';
+export { SqliteStorageAdapter } from './sqlite-storage-adapter.js';
 //# sourceMappingURL=index.js.map

package/dist/surfacing/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/surfacing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,kBAAkB,GAGnB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/surfacing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,kBAAkB,GAGnB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,gBAAgB,EAChB,sBAAsB,GAOvB,MAAM,yBAAyB,CAAC;AAOjC,OAAO,EACL,cAAc,EACd,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/surfacing/publisher.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Skill Publishing Types
+ *
+ * Result types for publishing graduated playbooks to skill-tree's
+ * StorageAdapter. cognitive-core imports Skill and StorageAdapter
+ * directly from skill-tree — no duplicate interfaces needed.
+ */
+/** Result of publishing a skill */
+export interface PublishResult {
+    published: boolean;
+    skillId: string;
+    version: string;
+    isUpdate: boolean;
+    error?: string;
+}
+/** Result of deprecating a skill */
+export interface DeprecateResult {
+    deprecated: boolean;
+    skillId: string;
+    error?: string;
+}
+//# sourceMappingURL=publisher.d.ts.map

package/dist/surfacing/publisher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"publisher.d.ts","sourceRoot":"","sources":["../../src/surfacing/publisher.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,mCAAmC;AACnC,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,oCAAoC;AACpC,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,OAAO,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/surfacing/publisher.js

@@ -0,0 +1,9 @@
+/**
+ * Skill Publishing Types
+ *
+ * Result types for publishing graduated playbooks to skill-tree's
+ * StorageAdapter. cognitive-core imports Skill and StorageAdapter
+ * directly from skill-tree — no duplicate interfaces needed.
+ */
+export {};
+//# sourceMappingURL=publisher.js.map

package/dist/surfacing/publisher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publisher.js","sourceRoot":"","sources":["../../src/surfacing/publisher.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

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

@@ -8,8 +8,10 @@
  * 3. Contextual - Injected based on task query
  * 4. On-Demand - Available via MCP tool
  */
+import type { StorageAdapter } from 'skill-tree';
 import type { Task, Playbook, SkillLibraryConfig } from '../types/index.js';
 import type { PlaybookLibrary } from '../memory/playbook.js';
+import { SkillPublisher } from './skill-publisher.js';
 /**
  * Skills organized for agent context
  */
@@ -47,11 +49,21 @@ export declare class SkillLibrary {
     private domainSkills;
     private lastRefresh;
     private consecutiveFailures;
+    private skillPublisher;
     constructor(playbooks: PlaybookLibrary, config?: Partial<SkillLibraryConfig>);
     /**
      * Merge configuration with defaults
      */
     private mergeConfig;
+    /**
+     * Set a skill-tree StorageAdapter for publishing graduated playbooks.
+     * When set, promoted playbooks are automatically saved as skills.
+     */
+    setPublisher(storage: StorageAdapter): void;
+    /**
+     * Get the skill publisher (if configured)
+     */
+    getPublisher(): SkillPublisher | null;
     /**
      * Refresh skill tiers based on current playbook state
      * Called periodically or after significant learning

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

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