@within-7/minto 0.1.6 → 0.2.0

package/dist/services/checkpointManager.js

@@ -0,0 +1,386 @@
+import { randomUUID } from "crypto";
+import {
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  writeFileSync,
+  unlinkSync,
+  readdirSync
+} from "fs";
+import { join, dirname } from "path";
+import { getCwd } from "../utils/state.js";
+import { execFileNoThrow } from "../utils/execFileNoThrow.js";
+class CheckpointManager {
+  checkpoints = /* @__PURE__ */ new Map();
+  fileChangeTracker = [];
+  checkpointDir;
+  maxCheckpoints;
+  constructor(options) {
+    this.checkpointDir = options?.checkpointDir ?? join(getCwd(), ".minto", "checkpoints");
+    this.maxCheckpoints = options?.maxCheckpoints ?? 50;
+    if (!existsSync(this.checkpointDir)) {
+      mkdirSync(this.checkpointDir, { recursive: true });
+    }
+    this.loadCheckpoints();
+  }
+  /**
+   * Create a new checkpoint
+   */
+  async createCheckpoint(description, options) {
+    const id = randomUUID();
+    const timestamp = Date.now();
+    const lastCheckpoint = this.getLastCheckpoint();
+    let gitCommit;
+    let gitBranch;
+    if (options?.includeGit !== false) {
+      try {
+        gitCommit = await this.getCurrentGitCommit();
+        gitBranch = await this.getCurrentGitBranch();
+      } catch {
+      }
+    }
+    const checkpoint = {
+      id,
+      timestamp,
+      description,
+      messageCount: 0,
+      // Will be updated by caller
+      fileChanges: [...this.fileChangeTracker],
+      gitCommit,
+      gitBranch,
+      parentId: lastCheckpoint?.id,
+      metadata: {
+        cwd: getCwd(),
+        tags: options?.tags
+      }
+    };
+    this.checkpoints.set(id, checkpoint);
+    this.saveCheckpoint(checkpoint);
+    this.fileChangeTracker = [];
+    this.pruneOldCheckpoints();
+    return checkpoint;
+  }
+  /**
+   * Restore to a checkpoint
+   */
+  async restore(checkpointId, options = {}) {
+    const checkpoint = this.checkpoints.get(checkpointId);
+    if (!checkpoint) {
+      return {
+        success: false,
+        checkpointId,
+        restoredFiles: [],
+        error: `Checkpoint not found: ${checkpointId}`
+      };
+    }
+    const restoredFiles = [];
+    let backupId;
+    if (options.createBackup) {
+      const backup = await this.createCheckpoint(
+        `Backup before restore to ${checkpoint.description}`
+      );
+      backupId = backup.id;
+    }
+    if (options.dryRun) {
+      return {
+        success: true,
+        checkpointId,
+        restoredFiles: checkpoint.fileChanges.map((f) => f.path),
+        backupId
+      };
+    }
+    if (options.restoreFiles !== false) {
+      try {
+        for (const change of checkpoint.fileChanges) {
+          await this.restoreFileChange(change);
+          restoredFiles.push(change.path);
+        }
+      } catch (error) {
+        return {
+          success: false,
+          checkpointId,
+          restoredFiles,
+          error: error instanceof Error ? error.message : String(error),
+          backupId
+        };
+      }
+    }
+    let gitRestored = false;
+    if (options.restoreGit && checkpoint.gitCommit) {
+      try {
+        await this.restoreGitState(checkpoint.gitCommit);
+        gitRestored = true;
+      } catch (error) {
+        return {
+          success: false,
+          checkpointId,
+          restoredFiles,
+          gitRestored: false,
+          error: `Git restore failed: ${error instanceof Error ? error.message : String(error)}`,
+          backupId
+        };
+      }
+    }
+    return {
+      success: true,
+      checkpointId,
+      restoredFiles,
+      gitRestored,
+      backupId
+    };
+  }
+  /**
+   * Track a file change
+   */
+  trackFileChange(change) {
+    this.fileChangeTracker.push({
+      ...change,
+      timestamp: Date.now()
+    });
+  }
+  /**
+   * Get all checkpoints
+   */
+  getCheckpoints() {
+    return Array.from(this.checkpoints.values()).sort(
+      (a, b) => b.timestamp - a.timestamp
+    );
+  }
+  /**
+   * Get checkpoint by ID
+   */
+  getCheckpoint(id) {
+    return this.checkpoints.get(id);
+  }
+  /**
+   * Get the most recent checkpoint
+   */
+  getLastCheckpoint() {
+    const checkpoints = this.getCheckpoints();
+    return checkpoints[0];
+  }
+  /**
+   * Get checkpoints by tag
+   */
+  getCheckpointsByTag(tag) {
+    return this.getCheckpoints().filter((cp) => cp.metadata.tags?.includes(tag));
+  }
+  /**
+   * Delete a checkpoint
+   */
+  deleteCheckpoint(id) {
+    const checkpoint = this.checkpoints.get(id);
+    if (!checkpoint) return false;
+    this.checkpoints.delete(id);
+    const filePath = join(this.checkpointDir, `${id}.json`);
+    if (existsSync(filePath)) {
+      unlinkSync(filePath);
+    }
+    return true;
+  }
+  /**
+   * Get checkpoint history (chain from current to first)
+   */
+  getCheckpointHistory(checkpointId) {
+    const history = [];
+    let current = this.checkpoints.get(checkpointId);
+    while (current) {
+      history.push(current);
+      current = current.parentId ? this.checkpoints.get(current.parentId) : void 0;
+    }
+    return history;
+  }
+  /**
+   * Get pending file changes (not yet checkpointed)
+   */
+  getPendingChanges() {
+    return [...this.fileChangeTracker];
+  }
+  /**
+   * Clear pending file changes
+   */
+  clearPendingChanges() {
+    this.fileChangeTracker = [];
+  }
+  /**
+   * Get diff between two checkpoints
+   */
+  getDiff(fromId, toId) {
+    const fromCheckpoint = this.checkpoints.get(fromId);
+    const toCheckpoint = this.checkpoints.get(toId);
+    if (!fromCheckpoint || !toCheckpoint) {
+      return { addedFiles: [], modifiedFiles: [], deletedFiles: [] };
+    }
+    const history = this.getCheckpointHistory(toId);
+    const fromIndex = history.findIndex((cp) => cp.id === fromId);
+    if (fromIndex === -1) {
+      return { addedFiles: [], modifiedFiles: [], deletedFiles: [] };
+    }
+    const relevantCheckpoints = history.slice(0, fromIndex);
+    const allChanges = relevantCheckpoints.flatMap((cp) => cp.fileChanges);
+    const addedFiles = [];
+    const modifiedFiles = [];
+    const deletedFiles = [];
+    for (const change of allChanges) {
+      switch (change.type) {
+        case "create":
+          addedFiles.push(change.path);
+          break;
+        case "modify":
+          modifiedFiles.push(change.path);
+          break;
+        case "delete":
+          deletedFiles.push(change.path);
+          break;
+      }
+    }
+    return {
+      addedFiles: [...new Set(addedFiles)],
+      modifiedFiles: [...new Set(modifiedFiles)],
+      deletedFiles: [...new Set(deletedFiles)]
+    };
+  }
+  /**
+   * Load checkpoints from disk
+   */
+  loadCheckpoints() {
+    if (!existsSync(this.checkpointDir)) return;
+    try {
+      const files = readdirSync(this.checkpointDir);
+      for (const file of files) {
+        if (!file.endsWith(".json")) continue;
+        try {
+          const filePath = join(this.checkpointDir, file);
+          const content = readFileSync(filePath, "utf-8");
+          const checkpoint = JSON.parse(content);
+          this.checkpoints.set(checkpoint.id, checkpoint);
+        } catch {
+        }
+      }
+    } catch {
+    }
+  }
+  /**
+   * Save checkpoint to disk
+   */
+  saveCheckpoint(checkpoint) {
+    const filePath = join(this.checkpointDir, `${checkpoint.id}.json`);
+    writeFileSync(filePath, JSON.stringify(checkpoint, null, 2), "utf-8");
+  }
+  /**
+   * Prune old checkpoints to stay within limit
+   */
+  pruneOldCheckpoints() {
+    const checkpoints = this.getCheckpoints();
+    if (checkpoints.length <= this.maxCheckpoints) return;
+    const toDelete = checkpoints.slice(this.maxCheckpoints);
+    for (const checkpoint of toDelete) {
+      this.deleteCheckpoint(checkpoint.id);
+    }
+  }
+  /**
+   * Restore a file change
+   */
+  async restoreFileChange(change) {
+    const fullPath = join(getCwd(), change.path);
+    switch (change.type) {
+      case "create":
+        if (existsSync(fullPath)) {
+          unlinkSync(fullPath);
+        }
+        break;
+      case "modify":
+        if (change.originalContent !== void 0) {
+          const dir = dirname(fullPath);
+          if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+          }
+          writeFileSync(fullPath, change.originalContent, "utf-8");
+        }
+        break;
+      case "delete":
+        if (change.originalContent !== void 0) {
+          const dir = dirname(fullPath);
+          if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+          }
+          writeFileSync(fullPath, change.originalContent, "utf-8");
+        }
+        break;
+    }
+  }
+  /**
+   * Get current git commit hash
+   */
+  async getCurrentGitCommit() {
+    try {
+      const result = await execFileNoThrow("git", ["rev-parse", "HEAD"]);
+      if (result.code === 0 && result.stdout) {
+        return result.stdout.trim();
+      }
+      return void 0;
+    } catch {
+      return void 0;
+    }
+  }
+  /**
+   * Get current git branch
+   */
+  async getCurrentGitBranch() {
+    try {
+      const result = await execFileNoThrow("git", [
+        "rev-parse",
+        "--abbrev-ref",
+        "HEAD"
+      ]);
+      if (result.code === 0 && result.stdout) {
+        return result.stdout.trim();
+      }
+      return void 0;
+    } catch {
+      return void 0;
+    }
+  }
+  /**
+   * Restore git state to a specific commit
+   */
+  async restoreGitState(commit) {
+    await execFileNoThrow("git", ["stash"]);
+    const result = await execFileNoThrow("git", ["checkout", commit]);
+    if (result.code !== 0) {
+      throw new Error(`Failed to checkout commit ${commit}: ${result.stderr}`);
+    }
+  }
+}
+let managerInstance = null;
+function getCheckpointManager() {
+  if (!managerInstance) {
+    managerInstance = new CheckpointManager();
+  }
+  return managerInstance;
+}
+function resetCheckpointManager() {
+  managerInstance = null;
+}
+async function createCheckpoint(description, options) {
+  return getCheckpointManager().createCheckpoint(description, options);
+}
+async function restoreCheckpoint(checkpointId, options) {
+  return getCheckpointManager().restore(checkpointId, options);
+}
+function trackFileChange(change) {
+  getCheckpointManager().trackFileChange(change);
+}
+function getCheckpoints() {
+  return getCheckpointManager().getCheckpoints();
+}
+export {
+  CheckpointManager,
+  createCheckpoint,
+  getCheckpointManager,
+  getCheckpoints,
+  resetCheckpointManager,
+  restoreCheckpoint,
+  trackFileChange
+};
+//# sourceMappingURL=checkpointManager.js.map

package/dist/services/checkpointManager.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/services/checkpointManager.ts"],
+  "sourcesContent": ["/**\n * Checkpoint Manager\n *\n * Provides checkpoint and rollback capabilities for conversation state,\n * file changes, and git commits. Allows users to restore previous states.\n */\n\nimport { randomUUID } from 'crypto'\nimport {\n  existsSync,\n  mkdirSync,\n  readFileSync,\n  writeFileSync,\n  unlinkSync,\n  readdirSync,\n} from 'fs'\nimport { join, dirname } from 'path'\nimport { getCwd } from '@utils/state'\nimport { execFileNoThrow } from '@utils/execFileNoThrow'\n\n/**\n * File change record\n */\nexport interface FileChange {\n  /** File path */\n  path: string\n  /** Type of change */\n  type: 'create' | 'modify' | 'delete'\n  /** Original content (for modify/delete) */\n  originalContent?: string\n  /** New content (for create/modify) */\n  newContent?: string\n  /** Timestamp of change */\n  timestamp: number\n}\n\n/**\n * Checkpoint data\n */\nexport interface Checkpoint {\n  /** Unique checkpoint ID */\n  id: string\n  /** Creation timestamp */\n  timestamp: number\n  /** Description of this checkpoint */\n  description: string\n  /** Messages at this point */\n  messageCount: number\n  /** File changes since last checkpoint */\n  fileChanges: FileChange[]\n  /** Git commit hash (if available) */\n  gitCommit?: string\n  /** Git branch name */\n  gitBranch?: string\n  /** Parent checkpoint ID */\n  parentId?: string\n  /** Metadata */\n  metadata: {\n    /** Working directory */\n    cwd: string\n    /** User who created checkpoint */\n    createdBy?: string\n    /** Tags for categorization */\n    tags?: string[]\n  }\n}\n\n/**\n * Checkpoint restore options\n */\nexport interface RestoreOptions {\n  /** Restore file changes */\n  restoreFiles?: boolean\n  /** Restore git state */\n  restoreGit?: boolean\n  /** Create backup before restore */\n  createBackup?: boolean\n  /** Dry run (preview changes) */\n  dryRun?: boolean\n}\n\n/**\n * Restore result\n */\nexport interface RestoreResult {\n  /** Whether restore succeeded */\n  success: boolean\n  /** Restored checkpoint ID */\n  checkpointId: string\n  /** Files that were restored */\n  restoredFiles: string[]\n  /** Git restore result */\n  gitRestored?: boolean\n  /** Error message if failed */\n  error?: string\n  /** Backup checkpoint ID (if created) */\n  backupId?: string\n}\n\n/**\n * Checkpoint Manager for state tracking and rollback\n */\nexport class CheckpointManager {\n  private checkpoints: Map<string, Checkpoint> = new Map()\n  private fileChangeTracker: FileChange[] = []\n  private checkpointDir: string\n  private maxCheckpoints: number\n\n  constructor(options?: { checkpointDir?: string; maxCheckpoints?: number }) {\n    this.checkpointDir =\n      options?.checkpointDir ?? join(getCwd(), '.minto', 'checkpoints')\n    this.maxCheckpoints = options?.maxCheckpoints ?? 50\n\n    // Ensure checkpoint directory exists\n    if (!existsSync(this.checkpointDir)) {\n      mkdirSync(this.checkpointDir, { recursive: true })\n    }\n\n    // Load existing checkpoints\n    this.loadCheckpoints()\n  }\n\n  /**\n   * Create a new checkpoint\n   */\n  async createCheckpoint(\n    description: string,\n    options?: {\n      tags?: string[]\n      includeGit?: boolean\n    },\n  ): Promise<Checkpoint> {\n    const id = randomUUID()\n    const timestamp = Date.now()\n    const lastCheckpoint = this.getLastCheckpoint()\n\n    // Get git info if requested\n    let gitCommit: string | undefined\n    let gitBranch: string | undefined\n\n    if (options?.includeGit !== false) {\n      try {\n        gitCommit = await this.getCurrentGitCommit()\n        gitBranch = await this.getCurrentGitBranch()\n      } catch {\n        // Git not available or not a git repo\n      }\n    }\n\n    const checkpoint: Checkpoint = {\n      id,\n      timestamp,\n      description,\n      messageCount: 0, // Will be updated by caller\n      fileChanges: [...this.fileChangeTracker],\n      gitCommit,\n      gitBranch,\n      parentId: lastCheckpoint?.id,\n      metadata: {\n        cwd: getCwd(),\n        tags: options?.tags,\n      },\n    }\n\n    // Store checkpoint\n    this.checkpoints.set(id, checkpoint)\n    this.saveCheckpoint(checkpoint)\n\n    // Clear file change tracker\n    this.fileChangeTracker = []\n\n    // Prune old checkpoints if needed\n    this.pruneOldCheckpoints()\n\n    return checkpoint\n  }\n\n  /**\n   * Restore to a checkpoint\n   */\n  async restore(\n    checkpointId: string,\n    options: RestoreOptions = {},\n  ): Promise<RestoreResult> {\n    const checkpoint = this.checkpoints.get(checkpointId)\n    if (!checkpoint) {\n      return {\n        success: false,\n        checkpointId,\n        restoredFiles: [],\n        error: `Checkpoint not found: ${checkpointId}`,\n      }\n    }\n\n    const restoredFiles: string[] = []\n    let backupId: string | undefined\n\n    // Create backup if requested\n    if (options.createBackup) {\n      const backup = await this.createCheckpoint(\n        `Backup before restore to ${checkpoint.description}`,\n      )\n      backupId = backup.id\n    }\n\n    // Dry run mode - just return what would change\n    if (options.dryRun) {\n      return {\n        success: true,\n        checkpointId,\n        restoredFiles: checkpoint.fileChanges.map(f => f.path),\n        backupId,\n      }\n    }\n\n    // Restore files if requested\n    if (options.restoreFiles !== false) {\n      try {\n        for (const change of checkpoint.fileChanges) {\n          await this.restoreFileChange(change)\n          restoredFiles.push(change.path)\n        }\n      } catch (error) {\n        return {\n          success: false,\n          checkpointId,\n          restoredFiles,\n          error: error instanceof Error ? error.message : String(error),\n          backupId,\n        }\n      }\n    }\n\n    // Restore git state if requested\n    let gitRestored = false\n    if (options.restoreGit && checkpoint.gitCommit) {\n      try {\n        await this.restoreGitState(checkpoint.gitCommit)\n        gitRestored = true\n      } catch (error) {\n        return {\n          success: false,\n          checkpointId,\n          restoredFiles,\n          gitRestored: false,\n          error: `Git restore failed: ${error instanceof Error ? error.message : String(error)}`,\n          backupId,\n        }\n      }\n    }\n\n    return {\n      success: true,\n      checkpointId,\n      restoredFiles,\n      gitRestored,\n      backupId,\n    }\n  }\n\n  /**\n   * Track a file change\n   */\n  trackFileChange(change: Omit<FileChange, 'timestamp'>): void {\n    this.fileChangeTracker.push({\n      ...change,\n      timestamp: Date.now(),\n    })\n  }\n\n  /**\n   * Get all checkpoints\n   */\n  getCheckpoints(): Checkpoint[] {\n    return Array.from(this.checkpoints.values()).sort(\n      (a, b) => b.timestamp - a.timestamp,\n    )\n  }\n\n  /**\n   * Get checkpoint by ID\n   */\n  getCheckpoint(id: string): Checkpoint | undefined {\n    return this.checkpoints.get(id)\n  }\n\n  /**\n   * Get the most recent checkpoint\n   */\n  getLastCheckpoint(): Checkpoint | undefined {\n    const checkpoints = this.getCheckpoints()\n    return checkpoints[0]\n  }\n\n  /**\n   * Get checkpoints by tag\n   */\n  getCheckpointsByTag(tag: string): Checkpoint[] {\n    return this.getCheckpoints().filter(cp => cp.metadata.tags?.includes(tag))\n  }\n\n  /**\n   * Delete a checkpoint\n   */\n  deleteCheckpoint(id: string): boolean {\n    const checkpoint = this.checkpoints.get(id)\n    if (!checkpoint) return false\n\n    // Remove from memory\n    this.checkpoints.delete(id)\n\n    // Remove from disk\n    const filePath = join(this.checkpointDir, `${id}.json`)\n    if (existsSync(filePath)) {\n      unlinkSync(filePath)\n    }\n\n    return true\n  }\n\n  /**\n   * Get checkpoint history (chain from current to first)\n   */\n  getCheckpointHistory(checkpointId: string): Checkpoint[] {\n    const history: Checkpoint[] = []\n    let current = this.checkpoints.get(checkpointId)\n\n    while (current) {\n      history.push(current)\n      current = current.parentId\n        ? this.checkpoints.get(current.parentId)\n        : undefined\n    }\n\n    return history\n  }\n\n  /**\n   * Get pending file changes (not yet checkpointed)\n   */\n  getPendingChanges(): FileChange[] {\n    return [...this.fileChangeTracker]\n  }\n\n  /**\n   * Clear pending file changes\n   */\n  clearPendingChanges(): void {\n    this.fileChangeTracker = []\n  }\n\n  /**\n   * Get diff between two checkpoints\n   */\n  getDiff(\n    fromId: string,\n    toId: string,\n  ): {\n    addedFiles: string[]\n    modifiedFiles: string[]\n    deletedFiles: string[]\n  } {\n    const fromCheckpoint = this.checkpoints.get(fromId)\n    const toCheckpoint = this.checkpoints.get(toId)\n\n    if (!fromCheckpoint || !toCheckpoint) {\n      return { addedFiles: [], modifiedFiles: [], deletedFiles: [] }\n    }\n\n    // Collect all changes between checkpoints\n    const history = this.getCheckpointHistory(toId)\n    const fromIndex = history.findIndex(cp => cp.id === fromId)\n\n    if (fromIndex === -1) {\n      return { addedFiles: [], modifiedFiles: [], deletedFiles: [] }\n    }\n\n    const relevantCheckpoints = history.slice(0, fromIndex)\n    const allChanges = relevantCheckpoints.flatMap(cp => cp.fileChanges)\n\n    const addedFiles: string[] = []\n    const modifiedFiles: string[] = []\n    const deletedFiles: string[] = []\n\n    for (const change of allChanges) {\n      switch (change.type) {\n        case 'create':\n          addedFiles.push(change.path)\n          break\n        case 'modify':\n          modifiedFiles.push(change.path)\n          break\n        case 'delete':\n          deletedFiles.push(change.path)\n          break\n      }\n    }\n\n    return {\n      addedFiles: [...new Set(addedFiles)],\n      modifiedFiles: [...new Set(modifiedFiles)],\n      deletedFiles: [...new Set(deletedFiles)],\n    }\n  }\n\n  /**\n   * Load checkpoints from disk\n   */\n  private loadCheckpoints(): void {\n    if (!existsSync(this.checkpointDir)) return\n\n    try {\n      const files = readdirSync(this.checkpointDir)\n\n      for (const file of files) {\n        if (!file.endsWith('.json')) continue\n\n        try {\n          const filePath = join(this.checkpointDir, file)\n          const content = readFileSync(filePath, 'utf-8')\n          const checkpoint = JSON.parse(content) as Checkpoint\n          this.checkpoints.set(checkpoint.id, checkpoint)\n        } catch {\n          // Skip invalid checkpoint files\n        }\n      }\n    } catch {\n      // Directory read failed\n    }\n  }\n\n  /**\n   * Save checkpoint to disk\n   */\n  private saveCheckpoint(checkpoint: Checkpoint): void {\n    const filePath = join(this.checkpointDir, `${checkpoint.id}.json`)\n    writeFileSync(filePath, JSON.stringify(checkpoint, null, 2), 'utf-8')\n  }\n\n  /**\n   * Prune old checkpoints to stay within limit\n   */\n  private pruneOldCheckpoints(): void {\n    const checkpoints = this.getCheckpoints()\n\n    if (checkpoints.length <= this.maxCheckpoints) return\n\n    // Keep the most recent checkpoints\n    const toDelete = checkpoints.slice(this.maxCheckpoints)\n    for (const checkpoint of toDelete) {\n      this.deleteCheckpoint(checkpoint.id)\n    }\n  }\n\n  /**\n   * Restore a file change\n   */\n  private async restoreFileChange(change: FileChange): Promise<void> {\n    const fullPath = join(getCwd(), change.path)\n\n    switch (change.type) {\n      case 'create':\n        // To restore, we need to delete the created file\n        if (existsSync(fullPath)) {\n          unlinkSync(fullPath)\n        }\n        break\n\n      case 'modify':\n        // Restore original content\n        if (change.originalContent !== undefined) {\n          const dir = dirname(fullPath)\n          if (!existsSync(dir)) {\n            mkdirSync(dir, { recursive: true })\n          }\n          writeFileSync(fullPath, change.originalContent, 'utf-8')\n        }\n        break\n\n      case 'delete':\n        // Restore deleted file\n        if (change.originalContent !== undefined) {\n          const dir = dirname(fullPath)\n          if (!existsSync(dir)) {\n            mkdirSync(dir, { recursive: true })\n          }\n          writeFileSync(fullPath, change.originalContent, 'utf-8')\n        }\n        break\n    }\n  }\n\n  /**\n   * Get current git commit hash\n   */\n  private async getCurrentGitCommit(): Promise<string | undefined> {\n    try {\n      const result = await execFileNoThrow('git', ['rev-parse', 'HEAD'])\n      if (result.code === 0 && result.stdout) {\n        return result.stdout.trim()\n      }\n      return undefined\n    } catch {\n      return undefined\n    }\n  }\n\n  /**\n   * Get current git branch\n   */\n  private async getCurrentGitBranch(): Promise<string | undefined> {\n    try {\n      const result = await execFileNoThrow('git', [\n        'rev-parse',\n        '--abbrev-ref',\n        'HEAD',\n      ])\n      if (result.code === 0 && result.stdout) {\n        return result.stdout.trim()\n      }\n      return undefined\n    } catch {\n      return undefined\n    }\n  }\n\n  /**\n   * Restore git state to a specific commit\n   */\n  private async restoreGitState(commit: string): Promise<void> {\n    // Stash any uncommitted changes\n    await execFileNoThrow('git', ['stash'])\n\n    // Checkout the commit\n    const result = await execFileNoThrow('git', ['checkout', commit])\n\n    if (result.code !== 0) {\n      throw new Error(`Failed to checkout commit ${commit}: ${result.stderr}`)\n    }\n  }\n}\n\n// Singleton instance\nlet managerInstance: CheckpointManager | null = null\n\n/**\n * Get the checkpoint manager instance\n */\nexport function getCheckpointManager(): CheckpointManager {\n  if (!managerInstance) {\n    managerInstance = new CheckpointManager()\n  }\n  return managerInstance\n}\n\n/**\n * Reset the checkpoint manager instance (useful for testing)\n */\nexport function resetCheckpointManager(): void {\n  managerInstance = null\n}\n\n/**\n * Create a checkpoint\n */\nexport async function createCheckpoint(\n  description: string,\n  options?: {\n    tags?: string[]\n    includeGit?: boolean\n  },\n): Promise<Checkpoint> {\n  return getCheckpointManager().createCheckpoint(description, options)\n}\n\n/**\n * Restore to a checkpoint\n */\nexport async function restoreCheckpoint(\n  checkpointId: string,\n  options?: RestoreOptions,\n): Promise<RestoreResult> {\n  return getCheckpointManager().restore(checkpointId, options)\n}\n\n/**\n * Track a file change\n */\nexport function trackFileChange(change: Omit<FileChange, 'timestamp'>): void {\n  getCheckpointManager().trackFileChange(change)\n}\n\n/**\n * Get all checkpoints\n */\nexport function getCheckpoints(): Checkpoint[] {\n  return getCheckpointManager().getCheckpoints()\n}\n"],
+  "mappings": "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",
+  "names": []
+}