@variantree/watcher 0.1.0

package/dist/differ.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @variantree/watcher — Message Differ
+ *
+ * Detects new messages between consecutive reads of a session file.
+ * Keeps a simple count per session file — only emits messages beyond
+ * what was seen last time.
+ */
+import type { Message } from '@variantree/core';
+export declare class MessageDiffer {
+    private lastCount;
+    /**
+     * Given the current full list of messages, return only the ones
+     * that are new since the last call to diff().
+     */
+    diff(messages: Message[]): Message[];
+    reset(): void;
+}
+//# sourceMappingURL=differ.d.ts.map

package/dist/differ.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"differ.d.ts","sourceRoot":"","sources":["../src/differ.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAEhD,qBAAa,aAAa;IACxB,OAAO,CAAC,SAAS,CAAK;IAEtB;;;OAGG;IACH,IAAI,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE;IAMpC,KAAK,IAAI,IAAI;CAGd"}

package/dist/differ.js

@@ -0,0 +1,23 @@
+/**
+ * @variantree/watcher — Message Differ
+ *
+ * Detects new messages between consecutive reads of a session file.
+ * Keeps a simple count per session file — only emits messages beyond
+ * what was seen last time.
+ */
+export class MessageDiffer {
+    lastCount = 0;
+    /**
+     * Given the current full list of messages, return only the ones
+     * that are new since the last call to diff().
+     */
+    diff(messages) {
+        const newMessages = messages.slice(this.lastCount);
+        this.lastCount = messages.length;
+        return newMessages;
+    }
+    reset() {
+        this.lastCount = 0;
+    }
+}
+//# sourceMappingURL=differ.js.map

package/dist/differ.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"differ.js","sourceRoot":"","sources":["../src/differ.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,OAAO,aAAa;IAChB,SAAS,GAAG,CAAC,CAAC;IAEtB;;;OAGG;IACH,IAAI,CAAC,QAAmB;QACtB,MAAM,WAAW,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACnD,IAAI,CAAC,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC;QACjC,OAAO,WAAW,CAAC;IACrB,CAAC;IAED,KAAK;QACH,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC;IACrB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @variantree/watcher — Public API
+ */
+export { VariantreeWatcher } from './watcher.js';
+export type { WatcherOptions } from './watcher.js';
+export { MessageDiffer } from './differ.js';
+export { NodeStorage } from './node/storage.js';
+export { GitSnapshotProvider } from './node/git-snapshot.js';
+export { launchOpenCodeSession } from './node/session-launcher.js';
+export type { LaunchResult } from './node/session-launcher.js';
+export { ALL_TOOLS, ensureProjectInstructions, registerAllMcp, } from './tools/index.js';
+export type { ToolIntegration, SessionAdapter } from './tools/index.js';
+export { OpenCodeAdapter, mergeAgentsMd } from './tools/opencode/index.js';
+export { ClaudeCodeAdapter } from './tools/claudecode/index.js';
+export { syncConversation } from './sync.js';
+export { VARIANTREE_MARKER, mergeInstructions } from './tools/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAGnD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAG5C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAG7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAG/D,OAAO,EACL,SAAS,EACT,yBAAyB,EACzB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGxE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAG3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAGhE,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAG7C,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,23 @@
+/**
+ * @variantree/watcher — Public API
+ */
+// Core watcher
+export { VariantreeWatcher } from './watcher.js';
+// Message differ
+export { MessageDiffer } from './differ.js';
+// Node.js storage + snapshot
+export { NodeStorage } from './node/storage.js';
+export { GitSnapshotProvider } from './node/git-snapshot.js';
+// Session launcher
+export { launchOpenCodeSession } from './node/session-launcher.js';
+// Tool integrations
+export { ALL_TOOLS, ensureProjectInstructions, registerAllMcp, } from './tools/index.js';
+// OpenCode (primary adapter — used by MCP server and CLI directly)
+export { OpenCodeAdapter, mergeAgentsMd } from './tools/opencode/index.js';
+// Claude Code
+export { ClaudeCodeAdapter } from './tools/claudecode/index.js';
+// Shared sync (adapter-agnostic — works with OpenCode, Claude Code, etc.)
+export { syncConversation } from './sync.js';
+// Backwards-compat re-export (old import path: adapters/opencode)
+export { VARIANTREE_MARKER, mergeInstructions } from './tools/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,eAAe;AACf,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGjD,iBAAiB;AACjB,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,6BAA6B;AAC7B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAE7D,mBAAmB;AACnB,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGnE,oBAAoB;AACpB,OAAO,EACL,SAAS,EACT,yBAAyB,EACzB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAG1B,mEAAmE;AACnE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE3E,cAAc;AACd,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AAEhE,0EAA0E;AAC1E,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C,kEAAkE;AAClE,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/node/blob-store.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @variantree/watcher — Node.js BlobStore
+ *
+ * Stores content-addressed blobs in .variantree/blobs/<hash>
+ */
+import type { SnapshotStorage } from '@variantree/core';
+export declare class NodeBlobStore implements SnapshotStorage {
+    private readonly blobsDir;
+    constructor(workspacePath: string);
+    private blobPath;
+    writeBlob(hash: string, content: Buffer | Uint8Array): Promise<void>;
+    readBlob(hash: string): Promise<Uint8Array | null>;
+    hasBlob(hash: string): Promise<boolean>;
+    deleteBlob(hash: string): Promise<void>;
+}
+//# sourceMappingURL=blob-store.d.ts.map

package/dist/node/blob-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blob-store.d.ts","sourceRoot":"","sources":["../../src/node/blob-store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD,qBAAa,aAAc,YAAW,eAAe;IACnD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAEtB,aAAa,EAAE,MAAM;IAIjC,OAAO,CAAC,QAAQ;IAKV,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAMpE,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC;IASlD,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASvC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAK9C"}

package/dist/node/blob-store.js

@@ -0,0 +1,47 @@
+/**
+ * @variantree/watcher — Node.js BlobStore
+ *
+ * Stores content-addressed blobs in .variantree/blobs/<hash>
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+export class NodeBlobStore {
+    blobsDir;
+    constructor(workspacePath) {
+        this.blobsDir = path.join(workspacePath, '.variantree', 'blobs');
+    }
+    blobPath(hash) {
+        // Split into 2-char prefix dir for better filesystem performance
+        return path.join(this.blobsDir, hash.slice(0, 2), hash.slice(2));
+    }
+    async writeBlob(hash, content) {
+        const p = this.blobPath(hash);
+        await fs.mkdir(path.dirname(p), { recursive: true });
+        await fs.writeFile(p, content);
+    }
+    async readBlob(hash) {
+        try {
+            const buf = await fs.readFile(this.blobPath(hash));
+            return new Uint8Array(buf);
+        }
+        catch {
+            return null;
+        }
+    }
+    async hasBlob(hash) {
+        try {
+            await fs.access(this.blobPath(hash));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    async deleteBlob(hash) {
+        try {
+            await fs.unlink(this.blobPath(hash));
+        }
+        catch { /* already gone */ }
+    }
+}
+//# sourceMappingURL=blob-store.js.map

package/dist/node/blob-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blob-store.js","sourceRoot":"","sources":["../../src/node/blob-store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,MAAM,OAAO,aAAa;IACP,QAAQ,CAAS;IAElC,YAAY,aAAqB;QAC/B,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;IACnE,CAAC;IAEO,QAAQ,CAAC,IAAY;QAC3B,iEAAiE;QACjE,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAY,EAAE,OAA4B;QACxD,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC9B,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,IAAY;QACzB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;YACnD,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAY;QACxB,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;YACrC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,IAAY;QAC3B,IAAI,CAAC;YACH,MAAM,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QACvC,CAAC;QAAC,MAAM,CAAC,CAAC,kBAAkB,CAAC,CAAC;IAChC,CAAC;CACF"}

package/dist/node/fs-adapter.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @variantree/watcher — Node.js FileSystemAdapter
+ *
+ * Implements FileSystemAdapter using Node.js fs module.
+ * Respects .gitignore and always skips .variantree/, node_modules/, .git/.
+ */
+import type { FileSystemAdapter } from '@variantree/core';
+export declare class NodeFileSystem implements FileSystemAdapter {
+    private gitignorePatterns;
+    private loadGitignore;
+    private shouldIgnore;
+    listFiles(rootPath: string): Promise<string[]>;
+    readFile(filePath: string): Promise<Uint8Array>;
+    writeFile(filePath: string, content: Buffer | Uint8Array): Promise<void>;
+    deleteFile(filePath: string): Promise<void>;
+}
+//# sourceMappingURL=fs-adapter.d.ts.map

package/dist/node/fs-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-adapter.d.ts","sourceRoot":"","sources":["../../src/node/fs-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAgB1D,qBAAa,cAAe,YAAW,iBAAiB;IACtD,OAAO,CAAC,iBAAiB,CAAyB;YAEpC,aAAa;IAc3B,OAAO,CAAC,YAAY;IA4Bd,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAsB9C,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAK/C,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxE,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAKlD"}

package/dist/node/fs-adapter.js

@@ -0,0 +1,110 @@
+/**
+ * @variantree/watcher — Node.js FileSystemAdapter
+ *
+ * Implements FileSystemAdapter using Node.js fs module.
+ * Respects .gitignore and always skips .variantree/, node_modules/, .git/.
+ */
+import fs from 'node:fs/promises';
+import path from 'node:path';
+const ALWAYS_SKIP = new Set([
+    'node_modules',
+    '.variantree',
+    '.venv',
+    'venv',
+    '.git',
+    '.DS_Store',
+    'dist',
+    'opencode.json',
+    '.opencode',
+    '.vscode',
+    '.idea',
+]);
+export class NodeFileSystem {
+    gitignorePatterns = null;
+    async loadGitignore(rootPath) {
+        if (this.gitignorePatterns)
+            return this.gitignorePatterns;
+        try {
+            const raw = await fs.readFile(path.join(rootPath, '.gitignore'), 'utf8');
+            this.gitignorePatterns = raw
+                .split('\n')
+                .map((l) => l.trim())
+                .filter((l) => l && !l.startsWith('#'));
+        }
+        catch {
+            this.gitignorePatterns = [];
+        }
+        return this.gitignorePatterns;
+    }
+    shouldIgnore(relativePath, patterns) {
+        const parts = relativePath.split(path.sep);
+        // Skip if any path segment is in ALWAYS_SKIP
+        for (const part of parts) {
+            if (ALWAYS_SKIP.has(part))
+                return true;
+        }
+        // Simple gitignore matching: check if filename or relative path matches a pattern
+        const basename = parts[parts.length - 1];
+        for (const pattern of patterns) {
+            if (pattern.endsWith('/')) {
+                // Directory pattern
+                const dirName = pattern.slice(0, -1);
+                if (parts.includes(dirName))
+                    return true;
+            }
+            else if (pattern.startsWith('*.')) {
+                // Extension glob
+                const ext = pattern.slice(1); // e.g. ".log"
+                if (basename.endsWith(ext))
+                    return true;
+            }
+            else if (pattern.includes('/')) {
+                // Path pattern
+                if (relativePath.startsWith(pattern))
+                    return true;
+            }
+            else {
+                // Exact name match
+                if (basename === pattern || parts.includes(pattern))
+                    return true;
+            }
+        }
+        return false;
+    }
+    async listFiles(rootPath) {
+        const patterns = await this.loadGitignore(rootPath);
+        const results = [];
+        const walk = async (dir) => {
+            const entries = await fs.readdir(dir, { withFileTypes: true });
+            for (const entry of entries) {
+                const full = path.join(dir, entry.name);
+                const rel = path.relative(rootPath, full);
+                if (this.shouldIgnore(rel, patterns))
+                    continue;
+                if (entry.isDirectory()) {
+                    await walk(full);
+                }
+                else {
+                    results.push(rel);
+                }
+            }
+        };
+        await walk(rootPath);
+        return results;
+    }
+    async readFile(filePath) {
+        const buf = await fs.readFile(filePath);
+        return new Uint8Array(buf);
+    }
+    async writeFile(filePath, content) {
+        await fs.mkdir(path.dirname(filePath), { recursive: true });
+        await fs.writeFile(filePath, content);
+    }
+    async deleteFile(filePath) {
+        try {
+            await fs.unlink(filePath);
+        }
+        catch { /* already gone */ }
+    }
+}
+//# sourceMappingURL=fs-adapter.js.map

package/dist/node/fs-adapter.js.map

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

package/dist/node/git-snapshot.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @variantree/watcher — Git-backed Snapshot Provider
+ *
+ * Uses git as a hidden storage engine for workspace snapshots.
+ * Zero pollution of the user's git history:
+ *
+ *   - For git repos: stores snapshots as orphan commits under refs/variantree/,
+ *     invisible to git log, git branch, git push, and git stash list.
+ *   - For non-git repos: initializes a private repo inside .variantree/git/,
+ *     completely transparent to the user.
+ *
+ * Key trick: GIT_INDEX_FILE env var creates a temporary staging area so we
+ * never touch the user's actual index (staged changes are preserved).
+ */
+import type { SnapshotProvider, RestoreSummary, SnapshotDiff } from '@variantree/core';
+export declare class GitSnapshotProvider implements SnapshotProvider {
+    private gitDir;
+    private useInternalRepo;
+    private initPromise;
+    private cachedWorkspacePath;
+    constructor(workspacePath?: string);
+    capture(workspacePath: string, label: string): Promise<string>;
+    restore(workspacePath: string, ref: string): Promise<RestoreSummary>;
+    diff(workspacePath: string, ref: string): Promise<SnapshotDiff>;
+    diffRefs(refA: string, refB: string): Promise<SnapshotDiff>;
+    drop(ref: string): Promise<void>;
+    /**
+     * Get the number of files in a snapshot. Not part of the SnapshotProvider
+     * interface — convenience method for status display.
+     */
+    getSnapshotFileCount(ref: string): Promise<number>;
+    private ensureInit;
+    private _init;
+    /** Add a pattern to .git/info/exclude if not already present. */
+    private ensureExclude;
+    private buildEnv;
+    private git;
+    /** Read binary content from git (e.g., file blobs via `git show`). */
+    private gitBinary;
+    /** Parse the output of `git diff-tree -r --name-status`. */
+    private diffTreeParsed;
+    /** List all file paths in a snapshot tree. */
+    private listTreeFiles;
+    private requireWorkspacePath;
+}
+//# sourceMappingURL=git-snapshot.d.ts.map

package/dist/node/git-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-snapshot.d.ts","sourceRoot":"","sources":["../../src/node/git-snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAMH,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAoCvF,qBAAa,mBAAoB,YAAW,gBAAgB;IAC1D,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,mBAAmB,CAAuB;gBAEtC,aAAa,CAAC,EAAE,MAAM;IAQ5B,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAyB9D,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;IAiCpE,IAAI,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAY/D,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAqB3D,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAUtC;;;OAGG;IACG,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;YAU1C,UAAU;YASV,KAAK;IAsCnB,iEAAiE;YACnD,aAAa;IAc3B,OAAO,CAAC,QAAQ;YAYF,GAAG;IAajB,sEAAsE;IACtE,OAAO,CAAC,SAAS;IAqBjB,4DAA4D;YAC9C,cAAc;IAsB5B,8CAA8C;YAChC,aAAa;IAO3B,OAAO,CAAC,oBAAoB;CAM7B"}

package/dist/node/git-snapshot.js

@@ -0,0 +1,282 @@
+/**
+ * @variantree/watcher — Git-backed Snapshot Provider
+ *
+ * Uses git as a hidden storage engine for workspace snapshots.
+ * Zero pollution of the user's git history:
+ *
+ *   - For git repos: stores snapshots as orphan commits under refs/variantree/,
+ *     invisible to git log, git branch, git push, and git stash list.
+ *   - For non-git repos: initializes a private repo inside .variantree/git/,
+ *     completely transparent to the user.
+ *
+ * Key trick: GIT_INDEX_FILE env var creates a temporary staging area so we
+ * never touch the user's actual index (staged changes are preserved).
+ */
+import { execFile, spawn } from 'node:child_process';
+import { promisify } from 'node:util';
+import path from 'node:path';
+import fs from 'node:fs/promises';
+const execAsync = promisify(execFile);
+/** Fallback excludes used only when a non-git project has no .gitignore. */
+const FALLBACK_EXCLUDES = [
+    'node_modules',
+    'dist',
+    '.venv',
+    'venv',
+    '.DS_Store',
+    '.idea',
+    '.vscode',
+    '__pycache__',
+].join('\n') + '\n';
+/** Always excluded from snapshots regardless of .gitignore. */
+const MANDATORY_EXCLUDES = '.variantree\n.git\n';
+/**
+ * Build the content for the internal repo's info/exclude file.
+ * If the workspace has a .gitignore, its patterns are used directly.
+ * Otherwise, fall back to a sensible default list.
+ */
+async function buildExcludeContent(workspacePath) {
+    try {
+        const gitignore = await fs.readFile(path.join(workspacePath, '.gitignore'), 'utf8');
+        return MANDATORY_EXCLUDES + '# from project .gitignore\n' + gitignore;
+    }
+    catch {
+        return MANDATORY_EXCLUDES + FALLBACK_EXCLUDES;
+    }
+}
+export class GitSnapshotProvider {
+    gitDir = null;
+    useInternalRepo = false;
+    initPromise = null;
+    cachedWorkspacePath = null;
+    constructor(workspacePath) {
+        if (workspacePath) {
+            this.cachedWorkspacePath = workspacePath;
+        }
+    }
+    // ─── Public API ─────────────────────────────────────────────────────────
+    async capture(workspacePath, label) {
+        await this.ensureInit(workspacePath);
+        const tmpIndex = path.join(this.gitDir, 'variantree-tmp-index');
+        const indexEnv = { GIT_INDEX_FILE: tmpIndex };
+        try {
+            await this.git(workspacePath, ['add', '-A'], indexEnv);
+            const tree = (await this.git(workspacePath, ['write-tree'], indexEnv)).trim();
+            const commit = (await this.git(workspacePath, [
+                'commit-tree', tree, '-m', `variantree: ${label}`,
+            ])).trim();
+            await this.git(workspacePath, [
+                'update-ref', `refs/variantree/${commit}`, commit,
+            ]);
+            return commit;
+        }
+        finally {
+            try {
+                await fs.unlink(tmpIndex);
+            }
+            catch { }
+        }
+    }
+    async restore(workspacePath, ref) {
+        await this.ensureInit(workspacePath);
+        const currentRef = await this.capture(workspacePath, '__restore_tmp__');
+        const summary = { written: [], deleted: [], skipped: [] };
+        try {
+            const changes = await this.diffTreeParsed(workspacePath, currentRef, ref);
+            for (const { status, filePath } of changes) {
+                const fullPath = path.join(workspacePath, filePath);
+                if (status === 'A' || status === 'M') {
+                    const content = await this.gitBinary(workspacePath, ['show', `${ref}:${filePath}`]);
+                    await fs.mkdir(path.dirname(fullPath), { recursive: true });
+                    await fs.writeFile(fullPath, content);
+                    summary.written.push(filePath);
+                }
+                else if (status === 'D') {
+                    try {
+                        await fs.unlink(fullPath);
+                    }
+                    catch { }
+                    summary.deleted.push(filePath);
+                }
+            }
+            const snapshotFiles = await this.listTreeFiles(workspacePath, ref);
+            const changedSet = new Set([...summary.written, ...summary.deleted]);
+            summary.skipped = snapshotFiles.filter(f => !changedSet.has(f));
+        }
+        finally {
+            await this.drop(currentRef);
+        }
+        return summary;
+    }
+    async diff(workspacePath, ref) {
+        await this.ensureInit(workspacePath);
+        const currentRef = await this.capture(workspacePath, '__diff_tmp__');
+        try {
+            return await this.diffRefs(ref, currentRef);
+        }
+        finally {
+            await this.drop(currentRef);
+        }
+    }
+    async diffRefs(refA, refB) {
+        const cwd = this.requireWorkspacePath();
+        await this.ensureInit(cwd);
+        const result = { added: [], modified: [], deleted: [], unchanged: [] };
+        const changes = await this.diffTreeParsed(cwd, refA, refB);
+        for (const { status, filePath } of changes) {
+            if (status === 'A')
+                result.added.push(filePath);
+            else if (status === 'M')
+                result.modified.push(filePath);
+            else if (status === 'D')
+                result.deleted.push(filePath);
+        }
+        const filesB = await this.listTreeFiles(cwd, refB);
+        const changedSet = new Set([...result.added, ...result.modified, ...result.deleted]);
+        result.unchanged = filesB.filter(f => !changedSet.has(f));
+        return result;
+    }
+    async drop(ref) {
+        const cwd = this.requireWorkspacePath();
+        try {
+            await this.git(cwd, ['update-ref', '-d', `refs/variantree/${ref}`]);
+        }
+        catch {
+            // Ref may not exist — safe to ignore
+        }
+    }
+    /**
+     * Get the number of files in a snapshot. Not part of the SnapshotProvider
+     * interface — convenience method for status display.
+     */
+    async getSnapshotFileCount(ref) {
+        const cwd = this.requireWorkspacePath();
+        await this.ensureInit(cwd);
+        const files = await this.listTreeFiles(cwd, ref);
+        return files.length;
+    }
+    // ─── Initialization ─────────────────────────────────────────────────────
+    async ensureInit(workspacePath) {
+        if (this.gitDir !== null)
+            return;
+        if (this.initPromise)
+            return this.initPromise;
+        this.cachedWorkspacePath = workspacePath;
+        this.initPromise = this._init(workspacePath);
+        return this.initPromise;
+    }
+    async _init(workspacePath) {
+        try {
+            const { stdout } = await execAsync('git', ['rev-parse', '--git-dir'], {
+                cwd: workspacePath,
+            });
+            this.gitDir = path.resolve(workspacePath, stdout.trim());
+            this.useInternalRepo = false;
+            // Ensure .variantree is excluded even if user hasn't added it to .gitignore
+            await this.ensureExclude(this.gitDir, '.variantree');
+        }
+        catch {
+            // Not inside a git repo — create a private one
+            const repoDir = path.join(workspacePath, '.variantree', 'git');
+            const dotGitDir = path.join(repoDir, '.git');
+            let needsInit = true;
+            try {
+                await fs.access(path.join(dotGitDir, 'HEAD'));
+                needsInit = false;
+            }
+            catch { }
+            if (needsInit) {
+                await fs.mkdir(repoDir, { recursive: true });
+                await execAsync('git', ['init', repoDir]);
+                const excludeDir = path.join(dotGitDir, 'info');
+                await fs.mkdir(excludeDir, { recursive: true });
+                await fs.writeFile(path.join(excludeDir, 'exclude'), await buildExcludeContent(workspacePath));
+            }
+            this.gitDir = dotGitDir;
+            this.useInternalRepo = true;
+        }
+    }
+    /** Add a pattern to .git/info/exclude if not already present. */
+    async ensureExclude(gitDir, pattern) {
+        const excludePath = path.join(gitDir, 'info', 'exclude');
+        try {
+            const content = await fs.readFile(excludePath, 'utf8');
+            if (content.includes(pattern))
+                return;
+            await fs.appendFile(excludePath, `\n${pattern}\n`);
+        }
+        catch {
+            await fs.mkdir(path.join(gitDir, 'info'), { recursive: true });
+            await fs.writeFile(excludePath, `${pattern}\n`);
+        }
+    }
+    // ─── Git Helpers ────────────────────────────────────────────────────────
+    buildEnv(workspacePath, extraEnv) {
+        const env = { ...process.env };
+        if (this.useInternalRepo) {
+            env.GIT_DIR = this.gitDir;
+            env.GIT_WORK_TREE = workspacePath;
+        }
+        if (extraEnv)
+            Object.assign(env, extraEnv);
+        return env;
+    }
+    async git(workspacePath, args, extraEnv) {
+        const { stdout } = await execAsync('git', args, {
+            cwd: workspacePath,
+            env: this.buildEnv(workspacePath, extraEnv),
+            maxBuffer: 100 * 1024 * 1024,
+        });
+        return stdout;
+    }
+    /** Read binary content from git (e.g., file blobs via `git show`). */
+    gitBinary(workspacePath, args, extraEnv) {
+        return new Promise((resolve, reject) => {
+            const chunks = [];
+            const proc = spawn('git', args, {
+                cwd: workspacePath,
+                env: this.buildEnv(workspacePath, extraEnv),
+            });
+            proc.stdout.on('data', (chunk) => chunks.push(chunk));
+            proc.stderr.on('data', () => { });
+            proc.on('close', (code) => {
+                if (code === 0)
+                    resolve(Buffer.concat(chunks));
+                else
+                    reject(new Error(`git ${args[0]} exited with code ${code}`));
+            });
+            proc.on('error', reject);
+        });
+    }
+    /** Parse the output of `git diff-tree -r --name-status`. */
+    async diffTreeParsed(workspacePath, refA, refB) {
+        const output = await this.git(workspacePath, [
+            'diff-tree', '-r', '--name-status', refA, refB,
+        ]);
+        return output
+            .trim()
+            .split('\n')
+            .filter(Boolean)
+            .map(line => {
+            const tab = line.indexOf('\t');
+            return {
+                status: line.charAt(0),
+                filePath: line.slice(tab + 1),
+            };
+        });
+    }
+    /** List all file paths in a snapshot tree. */
+    async listTreeFiles(workspacePath, ref) {
+        const output = (await this.git(workspacePath, [
+            'ls-tree', '-r', '--name-only', ref,
+        ])).trim();
+        return output ? output.split('\n') : [];
+    }
+    requireWorkspacePath() {
+        if (!this.cachedWorkspacePath) {
+            throw new Error('GitSnapshotProvider: no workspace path configured. Call capture() first or pass workspacePath to the constructor.');
+        }
+        return this.cachedWorkspacePath;
+    }
+}
+//# sourceMappingURL=git-snapshot.js.map