codecane 1.0.202 → 1.0.204

package/dist/checkpoints/checkpoint-manager.d.ts

@@ -4,25 +4,48 @@ import { AgentState } from '../common/types/agent-state';
  */
 export interface Checkpoint {
     agentStateString: string;
+    /** Promise resolving to the git commit hash for this checkpoint */
     fileStateIdPromise: Promise<string>;
+    /** Number of messages in the agent's history at checkpoint time */
     historyLength: number;
     id: number;
     timestamp: number;
+    /** User input that triggered this checkpoint */
     userInput: string;
 }
 /**
- * Simple in-memory checkpoint manager for agent states
+ * Manages checkpoints of agent state and file state using git operations in a worker thread.
+ * Each checkpoint contains both the agent's conversation state and a git commit
+ * representing the state of all tracked files at that point.
  */
 export declare class CheckpointManager {
     checkpoints: Array<Checkpoint>;
     private bareRepoPath;
-    enabled: boolean;
-    getBareRepoPath(): string;
+    disabledReason: string | null;
+    /** Worker thread for git operations */
+    private worker;
     /**
-     * Add a new checkpoint
-     * @param agentState - The agent state to checkpoint
-     * @param userInput - The user input associated with this checkpoint
-     * @returns The ID of the created checkpoint
+     * Initialize or return the existing worker thread
+     * @returns The worker thread instance
+     */
+    private initWorker;
+    /**
+     * Execute an operation in the worker thread with timeout handling
+     * @param message - The message describing the operation to perform
+     * @returns A promise that resolves with the operation result
+     * @throws Error if the operation fails or times out
+     */
+    private runWorkerOperation;
+    /**
+     * Get the path to the bare git repository used for storing file states
+     * @returns The bare repo path
+     */
+    private getBareRepoPath;
+    /**
+     * Add a new checkpoint of the current agent and file state
+     * @param agentState - The current agent state to checkpoint
+     * @param userInput - The user input that triggered this checkpoint
+     * @returns The created checkpoint, or null if checkpointing is disabled
      */
     addCheckpoint(agentState: AgentState, userInput: string): Promise<Checkpoint | null>;
     /**
@@ -30,6 +53,11 @@ export declare class CheckpointManager {
      * @returns The most recent checkpoint or null if none exist
      */
     getLatestCheckpoint(): Checkpoint | null;
+    /**
+     * Restore the file state from a specific checkpoint
+     * @param id - The ID of the checkpoint to restore
+     * @returns True if restoration succeeded, false if checkpoint not found
+     */
     restoreCheckointFileState(id: number): Promise<boolean>;
     /**
      * Clear all checkpoints
@@ -41,11 +69,5 @@ export declare class CheckpointManager {
      * @returns A formatted string representation of all checkpoints
      */
     getCheckpointsAsString(detailed?: boolean): string;
-    /**
-     * Get detailed information about a specific checkpoint
-     * @param id The checkpoint ID
-     * @returns A formatted string with detailed information about the checkpoint, or an error message if not found
-     */
-    getCheckpointDetails(id: number): string;
 }
 export declare const checkpointManager: CheckpointManager;

package/dist/checkpoints/checkpoint-manager.js

@@ -1,17 +1,70 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.checkpointManager = exports.CheckpointManager = void 0;
+const path_1 = require("path");
 const picocolors_1 = require("picocolors");
+const worker_threads_1 = require("worker_threads");
 const project_file_tree_1 = require("../common/project-file-tree");
 const file_manager_1 = require("./file-manager");
 const project_files_1 = require("../project-files");
 /**
- * Simple in-memory checkpoint manager for agent states
+ * Manages checkpoints of agent state and file state using git operations in a worker thread.
+ * Each checkpoint contains both the agent's conversation state and a git commit
+ * representing the state of all tracked files at that point.
  */
 class CheckpointManager {
     checkpoints = [];
     bareRepoPath = null;
-    enabled = true;
+    disabledReason = null;
+    /** Worker thread for git operations */
+    worker = null;
+    /**
+     * Initialize or return the existing worker thread
+     * @returns The worker thread instance
+     */
+    initWorker() {
+        if (!this.worker) {
+            // NOTE: Uses the built worker-script-project-context.js within dist.
+            // So you need to run `bun run build` before running locally.
+            const workerPath = __filename.endsWith('.ts')
+                ? (0, path_1.join)(__dirname, '../../dist', 'workers/checkpoint-worker.js')
+                : (0, path_1.join)(__dirname, '../workers/checkpoint-worker.js');
+            this.worker = new worker_threads_1.Worker(workerPath);
+        }
+        return this.worker;
+    }
+    /**
+     * Execute an operation in the worker thread with timeout handling
+     * @param message - The message describing the operation to perform
+     * @returns A promise that resolves with the operation result
+     * @throws Error if the operation fails or times out
+     */
+    async runWorkerOperation(message) {
+        const worker = this.initWorker();
+        return new Promise((resolve, reject) => {
+            const timeoutMs = 30000; // 30 seconds timeout
+            const handler = (response) => {
+                if (response.success) {
+                    resolve(response.result);
+                }
+                else {
+                    reject(new Error(response.error));
+                }
+                worker.off('message', handler);
+            };
+            worker.on('message', handler);
+            worker.postMessage(message);
+            // Add timeout
+            setTimeout(() => {
+                worker.off('message', handler);
+                reject(new Error('Worker operation timed out'));
+            }, timeoutMs);
+        });
+    }
+    /**
+     * Get the path to the bare git repository used for storing file states
+     * @returns The bare repo path
+     */
     getBareRepoPath() {
         if (!this.bareRepoPath) {
             this.bareRepoPath = (0, file_manager_1.getBareRepoPath)((0, project_files_1.getProjectRoot)());
@@ -19,22 +72,21 @@ class CheckpointManager {
         return this.bareRepoPath;
     }
     /**
-     * Add a new checkpoint
-     * @param agentState - The agent state to checkpoint
-     * @param userInput - The user input associated with this checkpoint
-     * @returns The ID of the created checkpoint
+     * Add a new checkpoint of the current agent and file state
+     * @param agentState - The current agent state to checkpoint
+     * @param userInput - The user input that triggered this checkpoint
+     * @returns The created checkpoint, or null if checkpointing is disabled
      */
     async addCheckpoint(agentState, userInput) {
-        if (!this.enabled) {
+        if (this.disabledReason !== null) {
             return null;
         }
-        // Use incremental ID starting at 1
         const id = this.checkpoints.length + 1;
         const projectDir = (0, project_files_1.getProjectRoot)();
         const bareRepoPath = this.getBareRepoPath();
         const relativeFilepaths = (0, project_file_tree_1.getAllFilePaths)(agentState.fileContext.fileTree);
         if (relativeFilepaths.length >= project_file_tree_1.DEFAULT_MAX_FILES) {
-            this.enabled = false;
+            this.disabledReason = 'Project too large';
             return null;
         }
         const needToStage = await (0, file_manager_1.hasUnsavedChanges)({
@@ -46,7 +98,8 @@ class CheckpointManager {
             return null;
         }
         const fileStateIdPromise = needToStage
-            ? (0, file_manager_1.storeFileState)({
+            ? this.runWorkerOperation({
+                type: 'store',
                 projectDir,
                 bareRepoPath,
                 message: `Checkpoint ${id}`,
@@ -54,14 +107,13 @@ class CheckpointManager {
             })
             : (0, file_manager_1.getLatestCommit)({ bareRepoPath });
         const checkpoint = {
-            agentStateString: JSON.stringify(agentState), // Deep clone to prevent reference issues
+            agentStateString: JSON.stringify(agentState),
             fileStateIdPromise,
             historyLength: agentState.messageHistory.length,
             id,
             timestamp: Date.now(),
             userInput,
         };
-        // Add to map
         this.checkpoints.push(checkpoint);
         return checkpoint;
     }
@@ -70,10 +122,18 @@ class CheckpointManager {
      * @returns The most recent checkpoint or null if none exist
      */
     getLatestCheckpoint() {
+        if (this.disabledReason !== null) {
+            return null;
+        }
         return this.checkpoints.length === 0
             ? null
             : this.checkpoints[this.checkpoints.length - 1];
     }
+    /**
+     * Restore the file state from a specific checkpoint
+     * @param id - The ID of the checkpoint to restore
+     * @returns True if restoration succeeded, false if checkpoint not found
+     */
     async restoreCheckointFileState(id) {
         const checkpoint = this.checkpoints[id - 1];
         if (!checkpoint) {
@@ -81,7 +141,8 @@ class CheckpointManager {
         }
         const relativeFilepaths = (0, project_file_tree_1.getAllFilePaths)(JSON.parse(checkpoint.agentStateString).fileContext
             .fileTree);
-        await (0, file_manager_1.restoreFileState)({
+        await this.runWorkerOperation({
+            type: 'restore',
             projectDir: (0, project_files_1.getProjectRoot)(),
             bareRepoPath: this.getBareRepoPath(),
             commit: await checkpoint.fileStateIdPromise,
@@ -101,6 +162,9 @@ class CheckpointManager {
      * @returns A formatted string representation of all checkpoints
      */
     getCheckpointsAsString(detailed = false) {
+        if (this.disabledReason !== null) {
+            return (0, picocolors_1.red)(`Checkpoints not enabled: ${this.disabledReason}`);
+        }
         if (this.checkpoints.length === 0) {
             return (0, picocolors_1.yellow)('No checkpoints available.');
         }
@@ -115,41 +179,13 @@ class CheckpointManager {
             lines.push(`${(0, picocolors_1.cyan)((0, picocolors_1.bold)(`#${checkpoint.id}`))} ${(0, picocolors_1.gray)(`[${formattedDate}]`)}:`);
             lines.push(`  ${(0, picocolors_1.blue)('Input')}: ${userInput}`);
             if (detailed) {
-                // Add more details about the agent state if needed
                 const messageCount = checkpoint.historyLength;
                 lines.push(`  ${(0, picocolors_1.blue)('Messages')}: ${messageCount}`);
-                // You can add more detailed information here as needed
-                // For example, file context information, etc.
             }
             lines.push(''); // Empty line between checkpoints
         });
         return lines.join('\n');
     }
-    /**
-     * Get detailed information about a specific checkpoint
-     * @param id The checkpoint ID
-     * @returns A formatted string with detailed information about the checkpoint, or an error message if not found
-     */
-    getCheckpointDetails(id) {
-        const checkpoint = this.checkpoints[id - 1];
-        if (!checkpoint) {
-            return (0, picocolors_1.cyan)(`\nCheckpoint #${id} not found.`);
-        }
-        const lines = [
-            (0, picocolors_1.cyan)(`Detailed information for checkpoint #${id}:`),
-        ];
-        const date = new Date(checkpoint.timestamp);
-        const formattedDate = date.toLocaleString();
-        lines.push(`${(0, picocolors_1.blue)('Created at')}: ${formattedDate}`);
-        if (checkpoint.userInput) {
-            lines.push(`${(0, picocolors_1.blue)('User input')}: ${checkpoint.userInput}`);
-        }
-        // Display more detailed information about the agent state
-        const messageCount = checkpoint.historyLength;
-        lines.push(`${(0, picocolors_1.blue)('Message history')}: ${messageCount} messages`);
-        // You could add more detailed information here as needed
-        return lines.join('\n');
-    }
 }
 exports.CheckpointManager = CheckpointManager;
 // Export a singleton instance for use throughout the application

package/dist/checkpoints/checkpoint-manager.js.map

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

package/dist/checkpoints/file-manager.d.ts

@@ -1,21 +1,52 @@
+import fs from 'fs';
+/**
+ * Generates a unique path for storing the bare git repository based on the project directory.
+ * Uses SHA-256 hashing to create a unique identifier.
+ * @param dir - The project directory path to hash
+ * @returns The full path where the bare repo should be stored
+ */
 export declare function getBareRepoPath(dir: string): string;
+/**
+ * Checks if there are any uncommitted changes in the working directory.
+ * First attempts to use native git commands, falling back to isomorphic-git if unavailable.
+ * @param projectDir - The working tree directory path
+ * @param bareRepoPath - The bare git repository path
+ * @param relativeFilepaths - Array of file paths relative to projectDir to check
+ * @returns Promise resolving to true if there are uncommitted changes, false otherwise
+ */
 export declare function hasUnsavedChanges({ projectDir, bareRepoPath, relativeFilepaths, }: {
     projectDir: string;
     bareRepoPath: string;
     relativeFilepaths: Array<string>;
 }): Promise<boolean>;
+/**
+ * Gets the hash of the latest commit in the repository.
+ * First attempts to use native git commands, falling back to isomorphic-git if unavailable.
+ * @param bareRepoPath - The bare git repository path
+ * @returns Promise resolving to the commit hash
+ */
 export declare function getLatestCommit({ bareRepoPath, }: {
     bareRepoPath: string;
 }): Promise<string>;
+/**
+ * Initializes a bare git repository for tracking file changes.
+ * Creates the repository if it doesn't exist, otherwise uses the existing one.
+ * Makes an initial commit of the current file state.
+ * @param projectDir - The working tree directory path
+ * @param relativeFilepaths - Array of file paths relative to projectDir to track
+ */
 export declare function initializeCheckpointFileManager({ projectDir, relativeFilepaths, }: {
     projectDir: string;
     relativeFilepaths: Array<string>;
 }): Promise<void>;
 /**
- * Stores the current state of all files in the project as a git commit
- * (git add . && git commit)
- * @param message The commit message to use for this file state
- * @returns A promise that resolves to the id hash that can be used to restore this file state
+ * Creates a new commit with the current state of all tracked files.
+ * Stages all changes and creates a commit with the specified message.
+ * @param projectDir - The working tree directory path
+ * @param bareRepoPath - The bare git repository path
+ * @param message - The commit message
+ * @param relativeFilepaths - Array of file paths relative to projectDir to commit
+ * @returns Promise resolving to the new commit's hash
  */
 export declare function storeFileState({ projectDir, bareRepoPath, message, relativeFilepaths: relativeFilepaths, }: {
     projectDir: string;
@@ -24,12 +55,13 @@ export declare function storeFileState({ projectDir, bareRepoPath, message, rela
     relativeFilepaths: Array<string>;
 }): Promise<string>;
 /**
- * Resets the index and working directory to the specified commit.
- * (git reset --hard)
- * TODO redo this jsdoc
- * @param dir - The working tree directory path.
- * @param gitdir - The git directory path (typically the .git folder).
- * @param commit - The commit hash to reset to.
+ * Restores the working directory and index to match the specified commit.
+ * Equivalent to `git reset --hard`
+ * First attempts to use native git commands, falling back to isomorphic-git if unavailable.
+ * @param projectDir - The working tree directory path
+ * @param bareRepoPath - The bare git repository path
+ * @param commit - The commit hash to restore to
+ * @param relativeFilepaths - Array of file paths relative to projectDir to restore
  */
 export declare function restoreFileState({ projectDir, bareRepoPath, commit, relativeFilepaths, }: {
     projectDir: string;
@@ -37,3 +69,4 @@ export declare function restoreFileState({ projectDir, bareRepoPath, commit, rel
     commit: string;
     relativeFilepaths: Array<string>;
 }): Promise<void>;
+export { fs };