@luckydraw/cumulus 0.5.1

package/dist/lib/revert.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Revert orchestrator: truncates conversation history, cleans derived data
+ * (embeddings, summaries), and optionally restores git state.
+ */
+import type { HistoryStore } from './history.js';
+import { type GitSnapshot, type RestoreResult } from './snapshots.js';
+export interface RevertResult {
+    success: boolean;
+    removedCount: number;
+    removedIds: string[];
+    gitResult?: RestoreResult;
+    error?: string;
+}
+export interface RevertOptions {
+    restoreGit?: boolean;
+    gitSnapshot?: GitSnapshot;
+}
+/**
+ * Execute a full revert: truncate history, clean embeddings/summaries,
+ * and optionally restore git state.
+ */
+export declare function executeRevert(historyStore: HistoryStore, targetMessageId: string, options?: RevertOptions): Promise<RevertResult>;
+//# sourceMappingURL=revert.d.ts.map

package/dist/lib/revert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"revert.d.ts","sourceRoot":"","sources":["../../src/lib/revert.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAmB,KAAK,WAAW,EAAE,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGvF,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAsB,aAAa,CACjC,YAAY,EAAE,YAAY,EAC1B,eAAe,EAAE,MAAM,EACvB,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,CAAC,CAoEvB"}

package/dist/lib/revert.js

@@ -0,0 +1,75 @@
+/**
+ * Revert orchestrator: truncates conversation history, cleans derived data
+ * (embeddings, summaries), and optionally restores git state.
+ */
+import * as fs from 'fs/promises';
+import { getEmbeddingsPath } from './embeddings.js';
+import { restoreSnapshot } from './snapshots.js';
+import { loadSummaries, saveSummaries } from './summarizer.js';
+/**
+ * Execute a full revert: truncate history, clean embeddings/summaries,
+ * and optionally restore git state.
+ */
+export async function executeRevert(historyStore, targetMessageId, options) {
+    const threadPath = historyStore.threadPath;
+    // 1. Truncate history
+    let removedIds;
+    try {
+        removedIds = await historyStore.truncateTo(targetMessageId);
+    }
+    catch (err) {
+        return {
+            success: false,
+            removedCount: 0,
+            removedIds: [],
+            error: err instanceof Error ? err.message : 'Failed to truncate history',
+        };
+    }
+    const removedSet = new Set(removedIds);
+    // 2. Clean embeddings: remove entries for deleted messages
+    try {
+        const embeddingsPath = getEmbeddingsPath(threadPath);
+        const content = await fs.readFile(embeddingsPath, 'utf-8');
+        const data = JSON.parse(content);
+        const originalCount = data.entries.length;
+        data.entries = data.entries.filter(e => !removedSet.has(e.messageId));
+        if (data.entries.length !== originalCount) {
+            await fs.writeFile(embeddingsPath, JSON.stringify(data), 'utf-8');
+        }
+    }
+    catch {
+        // Embeddings file may not exist - not an error
+    }
+    // 3. Clean summaries: remove summaries that cover removed messages
+    try {
+        const summaryFile = await loadSummaries(threadPath);
+        if (summaryFile) {
+            // Get new last index from the kept messages
+            const keptMessages = await historyStore.getAll();
+            const newLastIndex = keptMessages.length - 1;
+            const originalCount = summaryFile.summaries.length;
+            summaryFile.summaries = summaryFile.summaries.filter(s => s.fromIndex <= newLastIndex);
+            summaryFile.lastMessageIndex = Math.min(summaryFile.lastMessageIndex, newLastIndex);
+            summaryFile.updatedAt = Date.now();
+            if (summaryFile.summaries.length !== originalCount ||
+                summaryFile.lastMessageIndex !== newLastIndex) {
+                await saveSummaries(summaryFile, threadPath);
+            }
+        }
+    }
+    catch {
+        // Summary cleanup failure is non-fatal
+    }
+    // 4. Restore git state if requested
+    let gitResult;
+    if (options?.restoreGit && options.gitSnapshot) {
+        gitResult = await restoreSnapshot(options.gitSnapshot);
+    }
+    return {
+        success: true,
+        removedCount: removedIds.length,
+        removedIds,
+        gitResult,
+    };
+}
+//# sourceMappingURL=revert.js.map

package/dist/lib/revert.js.map

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

package/dist/lib/session.d.ts

@@ -0,0 +1,65 @@
+export interface SessionChunk {
+    index: number;
+    content: string;
+    tokenEstimate: number;
+}
+export interface SessionSearchResult {
+    sessionId: string;
+    isCurrentSession: boolean;
+    content_snippet: string;
+    score: number;
+    chunkIndex: number;
+}
+/**
+ * Manages a single session document — an append-only markdown file
+ * that accumulates conversation context, chunked and embedded for
+ * semantic search alongside regular messages.
+ */
+export declare class SessionManager {
+    readonly sessionId: string;
+    readonly sessionsDir: string;
+    readonly sessionPath: string;
+    readonly embeddingsPath: string;
+    readonly startedAt: number;
+    private exchangeCount;
+    private threadName;
+    constructor(sessionsDir: string, threadName: string, existingSessionId?: string);
+    getSessionId(): string;
+    /**
+     * Create the session file with its header.
+     */
+    initialize(): Promise<void>;
+    /**
+     * Append an exchange to the session document.
+     * Does not re-embed — that happens lazily at search time.
+     */
+    appendExchange(userMsg: string, assistantMsg: string): Promise<void>;
+    /**
+     * Read the session file and chunk it on exchange boundaries,
+     * accumulating exchanges until the chunk reaches ~DEFAULT_CHUNK_SIZE tokens.
+     */
+    getChunks(): Promise<SessionChunk[]>;
+    /**
+     * Generate embeddings for new/changed chunks.
+     * Only the last chunk can change (since we only append),
+     * so we invalidate and regenerate it if needed.
+     */
+    generateMissingEmbeddings(): Promise<void>;
+    /**
+     * Search this session's chunks against a query embedding.
+     */
+    search(queryEmbedding: number[], threshold?: number): Promise<SessionSearchResult[]>;
+    /**
+     * Search ALL session docs in a sessions directory.
+     * Generates missing embeddings for each session before searching.
+     */
+    static searchAllSessions(sessionsDir: string, queryEmbedding: number[], currentSessionId: string, threshold?: number): Promise<SessionSearchResult[]>;
+    /**
+     * Reconstruct chunk content from parts given a chunk index.
+     * Mirrors the chunking logic in getChunks().
+     */
+    private static getChunkContent;
+    private loadEmbeddings;
+    private saveEmbeddings;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/lib/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/lib/session.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,mBAAmB;IAClC,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,qBAAa,cAAc;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,UAAU,CAAS;gBAEf,WAAW,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,MAAM;IAS/E,YAAY,IAAI,MAAM;IAItB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC;;;OAGG;IACG,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAM1E;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IA4C1C;;;;OAIG;IACG,yBAAyB,IAAI,OAAO,CAAC,IAAI,CAAC;IAiChD;;OAEG;IACG,MAAM,CACV,cAAc,EAAE,MAAM,EAAE,EACxB,SAAS,GAAE,MAA2B,GACrC,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAyBjC;;;OAGG;WACU,iBAAiB,CAC5B,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EAAE,EACxB,gBAAgB,EAAE,MAAM,EACxB,SAAS,GAAE,MAA2B,GACrC,OAAO,CAAC,mBAAmB,EAAE,CAAC;IA+EjC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;YA8BhB,cAAc;YAed,cAAc;CAuB7B"}

package/dist/lib/session.js

@@ -0,0 +1,289 @@
+import * as fs from 'fs/promises';
+import * as path from 'path';
+import { nanoid } from 'nanoid';
+import { estimateTokens } from './context-budget.js';
+import { cosineSimilarity, embeddingsAvailable, getEmbeddingProvider, } from './embeddings.js';
+const DEFAULT_CHUNK_SIZE = 4000; // tokens
+const EXCHANGE_DELIMITER = '\n## Exchange ';
+const SEMANTIC_THRESHOLD = 0.3;
+/**
+ * Manages a single session document — an append-only markdown file
+ * that accumulates conversation context, chunked and embedded for
+ * semantic search alongside regular messages.
+ */
+export class SessionManager {
+    sessionId;
+    sessionsDir;
+    sessionPath;
+    embeddingsPath;
+    startedAt;
+    exchangeCount = 0;
+    threadName;
+    constructor(sessionsDir, threadName, existingSessionId) {
+        this.sessionId = existingSessionId ?? `ses_${nanoid(8)}`;
+        this.sessionsDir = sessionsDir;
+        this.threadName = threadName;
+        this.sessionPath = path.join(sessionsDir, `${this.sessionId}.md`);
+        this.embeddingsPath = path.join(sessionsDir, `${this.sessionId}.embeddings.json`);
+        this.startedAt = Date.now();
+    }
+    getSessionId() {
+        return this.sessionId;
+    }
+    /**
+     * Create the session file with its header.
+     */
+    async initialize() {
+        await fs.mkdir(this.sessionsDir, { recursive: true });
+        const header = `# Session on thread "${this.threadName}" | ${new Date(this.startedAt).toISOString()}\n`;
+        await fs.writeFile(this.sessionPath, header, 'utf-8');
+    }
+    /**
+     * Append an exchange to the session document.
+     * Does not re-embed — that happens lazily at search time.
+     */
+    async appendExchange(userMsg, assistantMsg) {
+        this.exchangeCount++;
+        const block = `${EXCHANGE_DELIMITER}${this.exchangeCount}\nUser: ${userMsg}\nAssistant: ${assistantMsg}\n`;
+        await fs.appendFile(this.sessionPath, block, 'utf-8');
+    }
+    /**
+     * Read the session file and chunk it on exchange boundaries,
+     * accumulating exchanges until the chunk reaches ~DEFAULT_CHUNK_SIZE tokens.
+     */
+    async getChunks() {
+        let content;
+        try {
+            content = await fs.readFile(this.sessionPath, 'utf-8');
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return [];
+            throw error;
+        }
+        // Split on exchange delimiters, keeping the delimiter with the section
+        const parts = content.split(/(?=\n## Exchange )/);
+        const chunks = [];
+        let currentLines = [];
+        let currentTokens = 0;
+        for (const part of parts) {
+            const partTokens = estimateTokens(part);
+            if (currentTokens + partTokens > DEFAULT_CHUNK_SIZE && currentLines.length > 0) {
+                chunks.push({
+                    index: chunks.length,
+                    content: currentLines.join(''),
+                    tokenEstimate: currentTokens,
+                });
+                currentLines = [];
+                currentTokens = 0;
+            }
+            currentLines.push(part);
+            currentTokens += partTokens;
+        }
+        // Final chunk
+        if (currentLines.length > 0) {
+            chunks.push({
+                index: chunks.length,
+                content: currentLines.join(''),
+                tokenEstimate: currentTokens,
+            });
+        }
+        return chunks;
+    }
+    /**
+     * Generate embeddings for new/changed chunks.
+     * Only the last chunk can change (since we only append),
+     * so we invalidate and regenerate it if needed.
+     */
+    async generateMissingEmbeddings() {
+        if (!(await embeddingsAvailable()))
+            return;
+        const chunks = await this.getChunks();
+        if (chunks.length === 0)
+            return;
+        const existing = await this.loadEmbeddings();
+        const provider = getEmbeddingProvider();
+        const newEntries = [];
+        for (const chunk of chunks) {
+            const key = `ses:${this.sessionId}:${chunk.index}`;
+            const isLastChunk = chunk.index === chunks.length - 1;
+            if (existing.has(key) && !isLastChunk) {
+                // Earlier chunks are immutable, skip
+                continue;
+            }
+            // Last chunk may have grown — re-embed it
+            const [embedding] = await provider.embed([chunk.content]);
+            newEntries.push({
+                messageId: key,
+                embedding: embedding,
+                timestamp: new Date().toISOString(),
+            });
+        }
+        if (newEntries.length > 0) {
+            await this.saveEmbeddings(newEntries);
+        }
+    }
+    /**
+     * Search this session's chunks against a query embedding.
+     */
+    async search(queryEmbedding, threshold = SEMANTIC_THRESHOLD) {
+        const embeddings = await this.loadEmbeddings();
+        const chunks = await this.getChunks();
+        const results = [];
+        for (const chunk of chunks) {
+            const key = `ses:${this.sessionId}:${chunk.index}`;
+            const embedding = embeddings.get(key);
+            if (!embedding)
+                continue;
+            const score = cosineSimilarity(queryEmbedding, embedding);
+            if (score >= threshold) {
+                results.push({
+                    sessionId: this.sessionId,
+                    isCurrentSession: true,
+                    content_snippet: chunk.content.slice(0, 300),
+                    score,
+                    chunkIndex: chunk.index,
+                });
+            }
+        }
+        return results;
+    }
+    /**
+     * Search ALL session docs in a sessions directory.
+     * Generates missing embeddings for each session before searching.
+     */
+    static async searchAllSessions(sessionsDir, queryEmbedding, currentSessionId, threshold = SEMANTIC_THRESHOLD) {
+        let files;
+        try {
+            files = await fs.readdir(sessionsDir);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return [];
+            throw error;
+        }
+        // Generate missing embeddings for all session .md files
+        const sessionFiles = files.filter(f => f.endsWith('.md'));
+        for (const file of sessionFiles) {
+            const sid = file.replace('.md', '');
+            const manager = new SessionManager(sessionsDir, '', sid);
+            await manager.generateMissingEmbeddings();
+        }
+        const embeddingFiles = files.filter(f => f.endsWith('.embeddings.json'));
+        // Also pick up freshly generated embedding files
+        try {
+            const refreshedFiles = await fs.readdir(sessionsDir);
+            const newEmbFiles = refreshedFiles.filter(f => f.endsWith('.embeddings.json') && !embeddingFiles.includes(f));
+            embeddingFiles.push(...newEmbFiles);
+        }
+        catch {
+            // ignore
+        }
+        const results = [];
+        for (const file of embeddingFiles) {
+            const sessionId = file.replace('.embeddings.json', '');
+            const embeddingsPath = path.join(sessionsDir, file);
+            const sessionPath = path.join(sessionsDir, `${sessionId}.md`);
+            let embeddingsData;
+            try {
+                const content = await fs.readFile(embeddingsPath, 'utf-8');
+                embeddingsData = JSON.parse(content);
+            }
+            catch {
+                continue;
+            }
+            // Load session content for snippets
+            let sessionContent;
+            try {
+                sessionContent = await fs.readFile(sessionPath, 'utf-8');
+            }
+            catch {
+                continue;
+            }
+            // Split into chunks to get snippet for matching chunk
+            const parts = sessionContent.split(/(?=\n## Exchange )/);
+            for (const entry of embeddingsData.entries) {
+                const score = cosineSimilarity(queryEmbedding, entry.embedding);
+                if (score < threshold)
+                    continue;
+                // Parse chunk index from key (ses:sessionId:chunkIndex)
+                const keyParts = entry.messageId.split(':');
+                const chunkIndex = parseInt(keyParts[2] ?? '0', 10);
+                // Reconstruct which parts belong to this chunk
+                const chunkContent = this.getChunkContent(parts, chunkIndex);
+                results.push({
+                    sessionId,
+                    isCurrentSession: sessionId === currentSessionId,
+                    content_snippet: chunkContent.slice(0, 300),
+                    score,
+                    chunkIndex,
+                });
+            }
+        }
+        return results.sort((a, b) => b.score - a.score);
+    }
+    /**
+     * Reconstruct chunk content from parts given a chunk index.
+     * Mirrors the chunking logic in getChunks().
+     */
+    static getChunkContent(parts, targetChunkIndex) {
+        let chunkIndex = 0;
+        let currentLines = [];
+        let currentTokens = 0;
+        for (const part of parts) {
+            const partTokens = estimateTokens(part);
+            if (currentTokens + partTokens > DEFAULT_CHUNK_SIZE && currentLines.length > 0) {
+                if (chunkIndex === targetChunkIndex) {
+                    return currentLines.join('');
+                }
+                chunkIndex++;
+                currentLines = [];
+                currentTokens = 0;
+            }
+            currentLines.push(part);
+            currentTokens += partTokens;
+        }
+        if (chunkIndex === targetChunkIndex) {
+            return currentLines.join('');
+        }
+        return '';
+    }
+    // -- Private embedding I/O --
+    async loadEmbeddings() {
+        try {
+            const content = await fs.readFile(this.embeddingsPath, 'utf-8');
+            const data = JSON.parse(content);
+            const map = new Map();
+            for (const entry of data.entries) {
+                map.set(entry.messageId, entry.embedding);
+            }
+            return map;
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                return new Map();
+            throw error;
+        }
+    }
+    async saveEmbeddings(newEntries) {
+        const provider = getEmbeddingProvider();
+        const existing = await this.loadEmbeddings();
+        // Merge: new entries overwrite existing keys (for last-chunk re-embedding)
+        for (const entry of newEntries) {
+            existing.set(entry.messageId, entry.embedding);
+        }
+        const data = {
+            version: 1,
+            model: provider.name,
+            dimensions: provider.dimensions,
+            entries: Array.from(existing.entries()).map(([messageId, embedding]) => ({
+                messageId,
+                embedding,
+                timestamp: new Date().toISOString(),
+            })),
+        };
+        await fs.mkdir(path.dirname(this.embeddingsPath), { recursive: true });
+        await fs.writeFile(this.embeddingsPath, JSON.stringify(data), 'utf-8');
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/lib/session.js.map

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

package/dist/lib/snapshots.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Git snapshot capture and restore for conversation revert.
+ * Captures HEAD, branch, and working tree state before each turn.
+ */
+export interface GitSnapshot {
+    /** Current HEAD commit hash */
+    head: string;
+    /** Current branch name */
+    branch: string;
+    /** Stash ref for uncommitted changes (undefined if clean tree) */
+    stash?: string;
+}
+/**
+ * Check if the current directory is inside a git repository.
+ */
+export declare function isGitRepo(cwd?: string): Promise<boolean>;
+/**
+ * Capture a snapshot of the current git state: HEAD, branch, and working tree.
+ * Uses `git stash create -u` to capture uncommitted changes (including untracked files)
+ * without modifying the working tree.
+ *
+ * Never throws - returns null if not in a git repo or on failure.
+ */
+export declare function captureSnapshot(cwd?: string): Promise<GitSnapshot | null>;
+export interface RestoreResult {
+    success: boolean;
+    warning?: string;
+    error?: string;
+}
+/**
+ * Restore git state from a snapshot.
+ * 1. Checkout the branch
+ * 2. Reset to the snapshot HEAD
+ * 3. Apply stashed changes if any
+ *
+ * If only stash apply fails, returns success with a warning.
+ */
+export declare function restoreSnapshot(snapshot: GitSnapshot, cwd?: string): Promise<RestoreResult>;
+//# sourceMappingURL=snapshots.d.ts.map

package/dist/lib/snapshots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshots.d.ts","sourceRoot":"","sources":["../../src/lib/snapshots.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH,MAAM,WAAW,WAAW;IAC1B,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAiBD;;GAEG;AACH,wBAAsB,SAAS,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAG9D;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAsB/E;AAED,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;GAOG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,CAiCjG"}

package/dist/lib/snapshots.js

@@ -0,0 +1,99 @@
+/**
+ * Git snapshot capture and restore for conversation revert.
+ * Captures HEAD, branch, and working tree state before each turn.
+ */
+import { execFile } from 'child_process';
+import { promisify } from 'util';
+const execFileAsync = promisify(execFile);
+/**
+ * Run a git command, returning stdout trimmed. Returns null on failure.
+ */
+async function git(args, cwd) {
+    try {
+        const { stdout } = await execFileAsync('git', args, {
+            cwd: cwd ?? process.cwd(),
+            timeout: 10_000,
+        });
+        return stdout.trim();
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Check if the current directory is inside a git repository.
+ */
+export async function isGitRepo(cwd) {
+    const result = await git(['rev-parse', '--is-inside-work-tree'], cwd);
+    return result === 'true';
+}
+/**
+ * Capture a snapshot of the current git state: HEAD, branch, and working tree.
+ * Uses `git stash create -u` to capture uncommitted changes (including untracked files)
+ * without modifying the working tree.
+ *
+ * Never throws - returns null if not in a git repo or on failure.
+ */
+export async function captureSnapshot(cwd) {
+    try {
+        if (!(await isGitRepo(cwd)))
+            return null;
+        const head = await git(['rev-parse', 'HEAD'], cwd);
+        if (!head)
+            return null;
+        const branch = await git(['rev-parse', '--abbrev-ref', 'HEAD'], cwd);
+        if (!branch)
+            return null;
+        // git stash create -u: creates a stash commit without removing changes.
+        // Returns empty string if working tree is clean.
+        const stash = await git(['stash', 'create', '-u'], cwd);
+        return {
+            head,
+            branch,
+            ...(stash ? { stash } : {}),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Restore git state from a snapshot.
+ * 1. Checkout the branch
+ * 2. Reset to the snapshot HEAD
+ * 3. Apply stashed changes if any
+ *
+ * If only stash apply fails, returns success with a warning.
+ */
+export async function restoreSnapshot(snapshot, cwd) {
+    try {
+        if (!(await isGitRepo(cwd))) {
+            return { success: false, error: 'Not a git repository' };
+        }
+        // Checkout the branch
+        const checkoutResult = await git(['checkout', snapshot.branch], cwd);
+        if (checkoutResult === null) {
+            return { success: false, error: `Failed to checkout branch: ${snapshot.branch}` };
+        }
+        // Reset to the snapshot HEAD
+        const resetResult = await git(['reset', '--hard', snapshot.head], cwd);
+        if (resetResult === null) {
+            return { success: false, error: `Failed to reset to: ${snapshot.head}` };
+        }
+        // Apply stashed changes if any
+        if (snapshot.stash) {
+            const stashResult = await git(['stash', 'apply', snapshot.stash], cwd);
+            if (stashResult === null) {
+                return {
+                    success: true,
+                    warning: 'Code restored to commit, but uncommitted changes could not be re-applied.',
+                };
+            }
+        }
+        return { success: true };
+    }
+    catch {
+        return { success: false, error: 'Unexpected error during restore' };
+    }
+}
+//# sourceMappingURL=snapshots.js.map

package/dist/lib/snapshots.js.map

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