cognitive-core 0.1.0 → 0.1.2

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

@@ -0,0 +1,165 @@
+import { execFile } from 'node:child_process';
+export class EntireGitReader {
+    repoPath;
+    branch;
+    constructor(options) {
+        this.repoPath = options.repoPath;
+        this.branch = options.branch ?? 'entire/checkpoints/v1';
+    }
+    /** Check if the orphan branch exists in this repo */
+    async branchExists() {
+        try {
+            await this.git(['rev-parse', '--verify', this.branch]);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * List all checkpoint directories.
+     * Returns paths like ["a3/b2c4d5e6f7", "f1/0a9b8c7d6e5f", ...]
+     */
+    async listCheckpoints() {
+        // First list shard directories (2-char hex prefixes)
+        let shardOutput;
+        try {
+            shardOutput = await this.git([
+                'ls-tree',
+                '--name-only',
+                this.branch,
+            ]);
+        }
+        catch {
+            return [];
+        }
+        const shards = shardOutput
+            .split('\n')
+            .map((s) => s.trim())
+            .filter((s) => s.length > 0);
+        // For each shard, list checkpoint subdirectories
+        const checkpoints = [];
+        for (const shard of shards) {
+            try {
+                const innerOutput = await this.git([
+                    'ls-tree',
+                    '--name-only',
+                    this.branch,
+                    shard + '/',
+                ]);
+                const entries = innerOutput
+                    .split('\n')
+                    .map((e) => e.trim())
+                    .filter((e) => e.length > 0);
+                checkpoints.push(...entries);
+            }
+            catch {
+                // Skip shards that fail to list
+            }
+        }
+        return checkpoints;
+    }
+    /**
+     * List session subdirectories within a checkpoint.
+     * Returns numeric session indices like ["0", "1"].
+     */
+    async listSessions(checkpointPath) {
+        try {
+            const output = await this.git([
+                'ls-tree',
+                '--name-only',
+                this.branch,
+                checkpointPath + '/',
+            ]);
+            return output
+                .split('\n')
+                .map((e) => e.trim())
+                .filter((e) => e.length > 0)
+                // Extract just the directory name from the full path
+                .map((e) => {
+                const parts = e.split('/');
+                return parts[parts.length - 1];
+            })
+                // Keep only numeric directories (sessions), skip "tasks", "metadata.json" etc.
+                .filter((e) => /^\d+$/.test(e));
+        }
+        catch {
+            return [];
+        }
+    }
+    /** Read a single file from the orphan branch */
+    async readFile(path) {
+        return this.git(['show', `${this.branch}:${path}`]);
+    }
+    /**
+     * Read multiple files in batch.
+     * Returns Map<path, content>. Missing files are omitted.
+     */
+    async readFiles(paths) {
+        const result = new Map();
+        // Use parallel readFile calls (git show is fast for individual files)
+        const settled = await Promise.allSettled(paths.map(async (path) => {
+            const content = await this.readFileOrNull(path);
+            return { path, content };
+        }));
+        for (const entry of settled) {
+            if (entry.status === 'fulfilled' && entry.value.content !== null) {
+                result.set(entry.value.path, entry.value.content);
+            }
+        }
+        return result;
+    }
+    /** Read a file, returning null if it doesn't exist */
+    async readFileOrNull(path) {
+        try {
+            return await this.readFile(path);
+        }
+        catch {
+            return null;
+        }
+    }
+    /** Get the HEAD commit SHA of the orphan branch */
+    async getBranchHead() {
+        try {
+            const sha = await this.git(['rev-parse', this.branch]);
+            return sha.trim();
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Find the Entire-Checkpoint trailer value for a given commit.
+     * Returns the checkpoint ID or null.
+     */
+    async getCheckpointTrailer(commitSha) {
+        try {
+            const output = await this.git([
+                'log',
+                '--format=%(trailers:key=Entire-Checkpoint,valueonly)',
+                commitSha,
+                '-1',
+            ]);
+            const value = output.trim();
+            return value || null;
+        }
+        catch {
+            return null;
+        }
+    }
+    // ── Private ──────────────────────────────────────────────────
+    git(args) {
+        return new Promise((resolve, reject) => {
+            execFile('git', ['-C', this.repoPath, ...args], { maxBuffer: 100 * 1024 * 1024 }, // 100MB for large transcripts
+            (error, stdout, stderr) => {
+                if (error) {
+                    reject(new Error(`git ${args[0]} failed: ${stderr || error.message}`));
+                }
+                else {
+                    resolve(stdout);
+                }
+            });
+        });
+    }
+}
+//# sourceMappingURL=git-reader.js.map

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

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

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

@@ -0,0 +1,5 @@
+export { SessionBank } from './session-bank.js';
+export { EntireGitReader, type GitReaderOptions } from './git-reader.js';
+export { EntireTranscriptParser, type ParsedMetadata, } from './parser.js';
+export type { SessionRecord, SessionMetadata, TranscriptMessage, ContentBlock, TextBlock, ToolUseBlock, ToolResultBlock, SessionSummary, TokenUsage, Attribution, SessionSource, CheckpointRef, SessionQuery, SessionQueryResult, ProcessingLogEntry, SessionBankOptions, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/session-bank/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACzE,OAAO,EACL,sBAAsB,EACtB,KAAK,cAAc,GACpB,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,SAAS,EACT,YAAY,EACZ,eAAe,EACf,cAAc,EACd,UAAU,EACV,WAAW,EACX,aAAa,EACb,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/session-bank/index.js

@@ -0,0 +1,4 @@
+export { SessionBank } from './session-bank.js';
+export { EntireGitReader } from './git-reader.js';
+export { EntireTranscriptParser, } from './parser.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/session-bank/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,eAAe,EAAyB,MAAM,iBAAiB,CAAC;AACzE,OAAO,EACL,sBAAsB,GAEvB,MAAM,aAAa,CAAC"}

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

@@ -0,0 +1,39 @@
+import type { SessionRecord, SessionMetadata, TranscriptMessage, SessionSummary, TokenUsage, Attribution, CheckpointRef } from './types.js';
+export interface ParsedMetadata {
+    sessionId: string;
+    checkpointId: string;
+    metadata: SessionMetadata;
+    summary?: SessionSummary;
+    tokenUsage: TokenUsage;
+    attribution?: Attribution;
+}
+export declare class EntireTranscriptParser {
+    /**
+     * Parse a full session from its component files.
+     */
+    parseSession(metadataJson: string, transcriptJsonl: string, checkpointPath: string, sessionIndex: string): SessionRecord;
+    /**
+     * Parse per-session metadata.json (fast path — no transcript).
+     */
+    parseMetadata(metadataJson: string): ParsedMetadata;
+    /**
+     * Parse a JSONL transcript into structured messages.
+     * Tolerant of malformed lines — skips them silently.
+     */
+    parseTranscript(jsonlContent: string): TranscriptMessage[];
+    /**
+     * Parse chunked transcripts (full.jsonl.001, .002, etc.)
+     */
+    parseChunkedTranscript(chunks: string[]): TranscriptMessage[];
+    /**
+     * Parse the root checkpoint summary to discover session subdirectories.
+     */
+    parseCheckpointSummary(metadataJson: string, checkpointPath: string): CheckpointRef;
+    private parseTranscriptLine;
+    private parseContentBlock;
+    private parseTokenUsage;
+    private parseSummary;
+    private parseAttribution;
+    private checkpointIdFromPath;
+}
+//# sourceMappingURL=parser.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../src/session-bank/parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,eAAe,EACf,iBAAiB,EAEjB,cAAc,EACd,UAAU,EACV,WAAW,EACX,aAAa,EACd,MAAM,YAAY,CAAC;AAwFpB,MAAM,WAAW,cAAc;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,eAAe,CAAC;IAC1B,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,UAAU,EAAE,UAAU,CAAC;IACvB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED,qBAAa,sBAAsB;IACjC;;OAEG;IACH,YAAY,CACV,YAAY,EAAE,MAAM,EACpB,eAAe,EAAE,MAAM,EACvB,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,MAAM,GACnB,aAAa;IAoBhB;;OAEG;IACH,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,cAAc;IA6BnD;;;OAGG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,iBAAiB,EAAE;IAoB1D;;OAEG;IACH,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,iBAAiB,EAAE;IAK7D;;OAEG;IACH,sBAAsB,CACpB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,GACrB,aAAa;IAehB,OAAO,CAAC,mBAAmB;IAwD3B,OAAO,CAAC,iBAAiB;IAuBzB,OAAO,CAAC,eAAe;IAiCvB,OAAO,CAAC,YAAY;IAcpB,OAAO,CAAC,gBAAgB;IAWxB,OAAO,CAAC,oBAAoB;CAQ7B"}

package/dist/session-bank/parser.js

@@ -0,0 +1,231 @@
+export class EntireTranscriptParser {
+    /**
+     * Parse a full session from its component files.
+     */
+    parseSession(metadataJson, transcriptJsonl, checkpointPath, sessionIndex) {
+        const parsed = this.parseMetadata(metadataJson);
+        const transcript = this.parseTranscript(transcriptJsonl);
+        return {
+            sessionId: parsed.sessionId,
+            checkpointId: parsed.checkpointId,
+            metadata: parsed.metadata,
+            transcript,
+            summary: parsed.summary,
+            tokenUsage: parsed.tokenUsage,
+            attribution: parsed.attribution,
+            source: {
+                branch: 'entire/checkpoints/v1',
+                checkpointPath,
+                sessionIndex,
+            },
+        };
+    }
+    /**
+     * Parse per-session metadata.json (fast path — no transcript).
+     */
+    parseMetadata(metadataJson) {
+        const raw = JSON.parse(metadataJson);
+        const tokenUsage = this.parseTokenUsage(raw.token_usage);
+        const summary = raw.summary ? this.parseSummary(raw.summary) : undefined;
+        const attribution = raw.initial_attribution
+            ? this.parseAttribution(raw.initial_attribution)
+            : undefined;
+        return {
+            sessionId: raw.session_id ?? '',
+            checkpointId: raw.checkpoint_id ?? '',
+            metadata: {
+                cliVersion: raw.cli_version ?? '',
+                strategy: raw.strategy === 'auto-commit' ? 'auto-commit' : 'manual-commit',
+                createdAt: raw.created_at ? new Date(raw.created_at) : new Date(0),
+                branch: raw.branch ?? '',
+                agent: raw.agent ?? '',
+                filesTouched: raw.files_touched ?? [],
+                isTask: raw.is_task ?? false,
+                toolUseId: raw.tool_use_id,
+                checkpointTranscriptStart: raw.checkpoint_transcript_start ?? 0,
+            },
+            summary,
+            tokenUsage,
+            attribution,
+        };
+    }
+    /**
+     * Parse a JSONL transcript into structured messages.
+     * Tolerant of malformed lines — skips them silently.
+     */
+    parseTranscript(jsonlContent) {
+        const messages = [];
+        const lines = jsonlContent.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i].trim();
+            if (!line)
+                continue;
+            try {
+                const raw = JSON.parse(line);
+                const msg = this.parseTranscriptLine(raw, i);
+                if (msg)
+                    messages.push(msg);
+            }
+            catch {
+                // Skip malformed lines
+            }
+        }
+        return messages;
+    }
+    /**
+     * Parse chunked transcripts (full.jsonl.001, .002, etc.)
+     */
+    parseChunkedTranscript(chunks) {
+        const combined = chunks.join('\n');
+        return this.parseTranscript(combined);
+    }
+    /**
+     * Parse the root checkpoint summary to discover session subdirectories.
+     */
+    parseCheckpointSummary(metadataJson, checkpointPath) {
+        const raw = JSON.parse(metadataJson);
+        const sessions = raw.sessions ?? [];
+        const checkpointId = this.checkpointIdFromPath(checkpointPath);
+        return {
+            checkpointId,
+            sessionIds: [], // populated later from per-session metadata
+            path: checkpointPath,
+            sessionCount: sessions.length,
+        };
+    }
+    // ── Private helpers ──────────────────────────────────────────
+    parseTranscriptLine(raw, lineIndex) {
+        // Map Entire CLI's "human" → "user", keep "assistant" as-is.
+        // Also support the role field nested under message.role.
+        let role;
+        if (raw.type === 'user' || raw.type === 'human') {
+            role = 'user';
+        }
+        else if (raw.type === 'assistant') {
+            role = 'assistant';
+        }
+        else if (raw.type === 'tool_result') {
+            // Real Entire CLI emits tool_result as a top-level JSONL line.
+            // Wrap it as a user message containing a tool_result block.
+            const toolResultBlock = {
+                type: 'tool_result',
+                toolUseId: raw.tool_use_id ?? '',
+                content: typeof raw.content === 'string'
+                    ? raw.content
+                    : Array.isArray(raw.content)
+                        ? raw.content
+                            .filter((b) => b.type === 'text')
+                            .map((b) => b.text ?? '')
+                            .join('\n')
+                        : '',
+                isError: raw.is_error,
+            };
+            return {
+                role: 'user',
+                uuid: raw.uuid ?? `line-${lineIndex}`,
+                content: [toolResultBlock],
+                lineIndex,
+            };
+        }
+        else {
+            return null;
+        }
+        // UUID may not be present in real Entire CLI output
+        const uuid = raw.uuid ?? `line-${lineIndex}`;
+        const rawContent = raw.message?.content;
+        let content;
+        if (typeof rawContent === 'string') {
+            content = [{ type: 'text', text: rawContent }];
+        }
+        else if (Array.isArray(rawContent)) {
+            content = rawContent
+                .map((block) => this.parseContentBlock(block))
+                .filter((b) => b !== null);
+        }
+        else {
+            content = [];
+        }
+        return { role, uuid, content, lineIndex };
+    }
+    parseContentBlock(raw) {
+        switch (raw.type) {
+            case 'text':
+                return { type: 'text', text: raw.text ?? '' };
+            case 'tool_use':
+                return {
+                    type: 'tool_use',
+                    id: raw.id ?? '',
+                    name: raw.name ?? '',
+                    input: raw.input ?? {},
+                };
+            case 'tool_result':
+                return {
+                    type: 'tool_result',
+                    toolUseId: raw.tool_use_id ?? '',
+                    content: raw.content ?? '',
+                    isError: raw.is_error,
+                };
+            default:
+                return null;
+        }
+    }
+    parseTokenUsage(raw) {
+        if (!raw) {
+            return {
+                inputTokens: 0,
+                cacheCreationTokens: 0,
+                cacheReadTokens: 0,
+                outputTokens: 0,
+                apiCallCount: 0,
+                total: 0,
+            };
+        }
+        const inputTokens = raw.input_tokens ?? 0;
+        const cacheCreationTokens = raw.cache_creation_tokens ?? 0;
+        const cacheReadTokens = raw.cache_read_tokens ?? 0;
+        const outputTokens = raw.output_tokens ?? 0;
+        const apiCallCount = raw.api_call_count ?? 0;
+        const subagentUsage = raw.subagent_usage?.map((s) => this.parseTokenUsage(s));
+        return {
+            inputTokens,
+            cacheCreationTokens,
+            cacheReadTokens,
+            outputTokens,
+            apiCallCount,
+            subagentUsage,
+            total: inputTokens + cacheCreationTokens + cacheReadTokens + outputTokens,
+        };
+    }
+    parseSummary(raw) {
+        return {
+            intent: raw.intent ?? '',
+            outcome: raw.outcome ?? '',
+            learnings: {
+                repoPatterns: raw.learnings?.repo_patterns ?? [],
+                codeFindings: raw.learnings?.code_findings ?? [],
+                workflowPractices: raw.learnings?.workflow_practices ?? [],
+            },
+            frictionPoints: raw.friction_points ?? [],
+            openItems: raw.open_items ?? [],
+        };
+    }
+    parseAttribution(raw) {
+        return {
+            agentLinesAdded: raw.agent_lines_added ?? 0,
+            humanAdditions: raw.human_additions ?? 0,
+            humanModifications: raw.human_modifications ?? 0,
+            humanRemovals: raw.human_removals ?? 0,
+            totalCommittedLines: raw.total_committed_lines ?? 0,
+            agentContribution: raw.agent_contribution ?? 0,
+        };
+    }
+    checkpointIdFromPath(path) {
+        // Path is "<shard>/<rest>" → checkpoint ID is shard + rest
+        const parts = path.split('/');
+        if (parts.length >= 2) {
+            return parts[0] + parts[1];
+        }
+        return path;
+    }
+}
+//# sourceMappingURL=parser.js.map

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

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

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

@@ -0,0 +1,35 @@
+import type { SessionRecord, CheckpointRef, SessionQuery, SessionQueryResult, SessionBankOptions, ProcessingLogEntry } from './types.js';
+export declare class SessionBank {
+    private reader;
+    private parser;
+    private stateDir;
+    private cacheEnabled;
+    private available;
+    private initialized;
+    private cachedBranchHead;
+    private sessionCache;
+    private checkpointCache;
+    private processingState;
+    constructor(options?: SessionBankOptions);
+    init(): Promise<void>;
+    isAvailable(): boolean;
+    close(): Promise<void>;
+    listCheckpoints(): Promise<CheckpointRef[]>;
+    discover(): Promise<SessionRecord[]>;
+    count(query?: SessionQuery): Promise<number>;
+    query(query?: SessionQuery): Promise<SessionQueryResult>;
+    getBySessionId(sessionId: string): Promise<SessionRecord | undefined>;
+    getByCheckpointId(checkpointId: string): Promise<SessionRecord[]>;
+    getByCommit(commitSha: string): Promise<SessionRecord[]>;
+    markProcessed(sessionId: string, metadata?: Record<string, unknown>): Promise<void>;
+    isProcessed(sessionId: string): boolean;
+    getProcessingLog(): ProcessingLogEntry[];
+    invalidateCache(): void;
+    private ensureInitialized;
+    private ensureCacheValid;
+    private filterByMetadata;
+    private loadTranscript;
+    private loadProcessingState;
+    private saveProcessingState;
+}
+//# sourceMappingURL=session-bank.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-bank.d.ts","sourceRoot":"","sources":["../../src/session-bank/session-bank.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,kBAAkB,EAClB,kBAAkB,EACnB,MAAM,YAAY,CAAC;AAiBpB,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,YAAY,CAAU;IAE9B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,WAAW,CAAS;IAG5B,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,YAAY,CAAoC;IACxD,OAAO,CAAC,eAAe,CAAgC;IAGvD,OAAO,CAAC,eAAe,CAGrB;gBAEU,OAAO,CAAC,EAAE,kBAAkB;IAYlC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B,WAAW,IAAI,OAAO;IAIhB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAMtB,eAAe,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IA8B3C,QAAQ,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;IAuDpC,KAAK,CAAC,KAAK,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC;IAO5C,KAAK,CAAC,KAAK,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,kBAAkB,CAAC;IA+CxD,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC;IAOrE,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAgCjE,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC;IAQxD,aAAa,CACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC;IAWhB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIvC,gBAAgB,IAAI,kBAAkB,EAAE;IAMxC,eAAe,IAAI,IAAI;IAQvB,OAAO,CAAC,iBAAiB;YAQX,gBAAgB;IAU9B,OAAO,CAAC,gBAAgB;YA+CV,cAAc;YAiDd,mBAAmB;YA8BnB,mBAAmB;CAsBlC"}