@sudocode-ai/local-server 0.1.0

package/dist/execution/worktree/manager.d.ts

@@ -0,0 +1,184 @@
+/**
+ * Worktree Manager
+ *
+ * Manages git worktrees for session isolation.
+ *
+ * WORKTREE ISOLATION:
+ * ===================
+ * Each worktree created by this manager is completely isolated from the main
+ * repository. This prevents race conditions and unexpected modifications during
+ * concurrent executions.
+ *
+ * Isolation is achieved through:
+ * 1. Local database (.sudocode/cache.db) in each worktree
+ * 2. Synced JSONL files with latest state (including uncommitted changes)
+ * 3. Claude config (.claude/config.json) that forces MCP to use local database
+ *
+ * Key Benefit: Multiple executions can run concurrently without interfering
+ * with each other or the main repository. All MCP/CLI operations in a worktree
+ * stay contained within that worktree.
+ *
+ * See setupWorktreeEnvironment() method for detailed implementation.
+ *
+ * @module execution/worktree/manager
+ */
+import type { WorktreeCreateParams, WorktreeConfig, WorktreeInfo } from "./types.js";
+import { type IGitCli } from "./git-cli.js";
+/**
+ * IWorktreeManager - Interface for worktree management
+ *
+ * Provides methods for creating, validating, and cleaning up git worktrees.
+ * Implementations must handle race conditions with locking.
+ */
+export interface IWorktreeManager {
+    /**
+     * Create a new worktree for a session
+     *
+     * @param params - Worktree creation parameters
+     * @returns Promise that resolves when worktree is created
+     * @throws WorktreeError if creation fails
+     */
+    createWorktree(params: WorktreeCreateParams): Promise<void>;
+    /**
+     * Ensure worktree exists, recreating if necessary
+     * Uses locking to prevent race conditions
+     *
+     * @param repoPath - Path to the main git repository
+     * @param branchName - Branch name for the worktree
+     * @param worktreePath - Where the worktree should exist
+     * @returns Promise that resolves when worktree exists
+     * @throws WorktreeError if ensure fails
+     */
+    ensureWorktreeExists(repoPath: string, branchName: string, worktreePath: string): Promise<void>;
+    /**
+     * Clean up a worktree (filesystem + git metadata)
+     *
+     * @param worktreePath - Path to the worktree to cleanup
+     * @param repoPath - Optional path to repository (will try to infer if not provided)
+     * @returns Promise that resolves when cleanup is complete
+     * @throws WorktreeError if cleanup fails
+     */
+    cleanupWorktree(worktreePath: string, repoPath?: string): Promise<void>;
+    /**
+     * Check if worktree is properly set up
+     * Validates both filesystem existence and git metadata registration
+     *
+     * @param repoPath - Path to the main git repository
+     * @param worktreePath - Path to check
+     * @returns Promise resolving to true if valid, false otherwise
+     */
+    isWorktreeValid(repoPath: string, worktreePath: string): Promise<boolean>;
+    /**
+     * List all worktrees for a repository
+     *
+     * @param repoPath - Path to the main git repository
+     * @returns Promise resolving to list of worktree info
+     * @throws WorktreeError if listing fails
+     */
+    listWorktrees(repoPath: string): Promise<WorktreeInfo[]>;
+    /**
+     * Get the current configuration
+     *
+     * @returns Current worktree configuration
+     */
+    getConfig(): WorktreeConfig;
+    /**
+     * Check if a path is a valid git repository
+     *
+     * @param repoPath - Path to check
+     * @returns Promise resolving to true if valid repo, false otherwise
+     */
+    isValidRepo(repoPath: string): Promise<boolean>;
+    /**
+     * List all branches in a repository
+     *
+     * @param repoPath - Path to the git repository
+     * @returns Promise resolving to array of branch names
+     */
+    listBranches(repoPath: string): Promise<string[]>;
+}
+/**
+ * WorktreeManager - Implementation of IWorktreeManager
+ *
+ * Manages git worktrees with proper locking, cleanup, and error recovery.
+ * Uses git CLI commands for reliability.
+ */
+export declare class WorktreeManager implements IWorktreeManager {
+    /** Per-path locks to prevent concurrent operations */
+    private locks;
+    /** Configuration loaded from .sudocode/config.json */
+    private config;
+    /** Git CLI wrapper */
+    private git;
+    /**
+     * Create a new WorktreeManager
+     *
+     * @param config - Worktree configuration
+     * @param git - Optional git CLI implementation (defaults to GitCli)
+     */
+    constructor(config: WorktreeConfig, git?: IGitCli);
+    /**
+     * Get or create a lock for a specific path
+     *
+     * @param path - Path to lock
+     * @returns Mutex for the path
+     */
+    private getLock;
+    createWorktree(params: WorktreeCreateParams): Promise<void>;
+    /**
+     * Setup isolated environment for worktree
+     *
+     * WORKTREE ISOLATION ARCHITECTURE:
+     * ================================
+     * Problem: Previously, MCP/CLI tools running in worktrees would search upward
+     * and find the main repository's database, causing race conditions and
+     * unexpected modifications to the main repo during execution.
+     *
+     * Solution: Each worktree gets its own isolated environment:
+     * - Local database (.sudocode/cache.db in worktree)
+     * - Synced JSONL files with latest state (including uncommitted changes)
+     * - Claude config that forces MCP to use the local database
+     *
+     * Benefits:
+     * - Worktree operations never affect main repository
+     * - Multiple executions can run concurrently without conflicts
+     * - Worktree gets consistent state (newly created issues are available)
+     * - Easy to inspect/debug worktree state after execution
+     *
+     * Flow:
+     * 1. Git creates worktree → checks out files from committed git tree
+     * 2. This method runs → copies latest JSONL (including uncommitted changes)
+     * 3. Initializes local DB from JSONL → worktree has complete state
+     * 4. Creates .claude/config.json → MCP uses local DB via env vars
+     * 5. Claude runs → all MCP operations stay in worktree
+     * 6. (Future) Merge worktree changes back to main after execution
+     *
+     * @param repoPath - Path to the main git repository
+     * @param worktreePath - Path to the worktree directory
+     */
+    private setupWorktreeEnvironment;
+    ensureWorktreeExists(repoPath: string, branchName: string, worktreePath: string): Promise<void>;
+    cleanupWorktree(worktreePath: string, repoPath?: string): Promise<void>;
+    isWorktreeValid(repoPath: string, worktreePath: string): Promise<boolean>;
+    listWorktrees(repoPath: string): Promise<WorktreeInfo[]>;
+    getConfig(): WorktreeConfig;
+    isValidRepo(repoPath: string): Promise<boolean>;
+    listBranches(repoPath: string): Promise<string[]>;
+    /**
+     * Recreate a worktree (internal method)
+     *
+     * @param repoPath - Path to repository
+     * @param branchName - Branch name
+     * @param worktreePath - Worktree path
+     */
+    private recreateWorktree;
+    /**
+     * Infer git repository path from a worktree
+     * Uses git rev-parse --git-common-dir
+     *
+     * @param worktreePath - Path to worktree
+     * @returns Repository path or undefined
+     */
+    private inferRepoPath;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/execution/worktree/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/execution/worktree/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAKH,OAAO,KAAK,EACV,oBAAoB,EACpB,cAAc,EACd,YAAY,EACb,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAU,KAAK,OAAO,EAAE,MAAM,cAAc,CAAC;AAKpD;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;OAMG;IACH,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5D;;;;;;;;;OASG;IACH,oBAAoB,CAClB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC,CAAC;IAEjB;;;;;;;OAOG;IACH,eAAe,CAAC,YAAY,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExE;;;;;;;OAOG;IACH,eAAe,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAE1E;;;;;;OAMG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAEzD;;;;OAIG;IACH,SAAS,IAAI,cAAc,CAAC;IAE5B;;;;;OAKG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhD;;;;;OAKG;IACH,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CACnD;AAED;;;;;GAKG;AACH,qBAAa,eAAgB,YAAW,gBAAgB;IACtD,sDAAsD;IACtD,OAAO,CAAC,KAAK,CAA4B;IAEzC,sDAAsD;IACtD,OAAO,CAAC,MAAM,CAAiB;IAE/B,sBAAsB;IACtB,OAAO,CAAC,GAAG,CAAU;IAErB;;;;;OAKG;gBACS,MAAM,EAAE,cAAc,EAAE,GAAG,CAAC,EAAE,OAAO;IAKjD;;;;;OAKG;IACH,OAAO,CAAC,OAAO;IAST,cAAc,CAAC,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;IAgEjE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;YACW,wBAAwB;IAkIhC,oBAAoB,CACxB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,IAAI,CAAC;IAkBV,eAAe,CACnB,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC,IAAI,CAAC;IA0FV,eAAe,CACnB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,OAAO,CAAC;IA6Bb,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAI9D,SAAS,IAAI,cAAc;IAIrB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI/C,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAIvD;;;;;;OAMG;YACW,gBAAgB;IAwE9B;;;;;;OAMG;YACW,aAAa;CA0B5B"}

package/dist/execution/worktree/types.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Worktree Types
+ *
+ * Type definitions for worktree management system.
+ *
+ * @module execution/worktree/types
+ */
+/**
+ * Worktree creation parameters
+ */
+export interface WorktreeCreateParams {
+    /** Path to the main git repository */
+    repoPath: string;
+    /** Branch name for the worktree */
+    branchName: string;
+    /** Where to create the worktree */
+    worktreePath: string;
+    /** Branch to base the new branch on */
+    baseBranch: string;
+    /** Whether to create the branch */
+    createBranch: boolean;
+    /** Commit SHA to branch from */
+    commitSha?: string;
+}
+/**
+ * Worktree information returned from git worktree list
+ */
+export interface WorktreeInfo {
+    /** Path to the worktree */
+    path: string;
+    /** Branch name */
+    branch: string;
+    /** Git commit hash */
+    commit: string;
+    /** Whether this is the main worktree */
+    isMain: boolean;
+    /** Whether the worktree is locked */
+    isLocked: boolean;
+    /** Reason for lock (if locked) */
+    lockReason?: string;
+}
+/**
+ * Worktree configuration (will be implemented in ISSUE-111)
+ * Placeholder type for now
+ */
+export interface WorktreeConfig {
+    /** Where to store worktrees */
+    worktreeStoragePath: string;
+    /** Auto-create branches for new sessions */
+    autoCreateBranches: boolean;
+    /** Auto-delete branches when session is cleaned up */
+    autoDeleteBranches: boolean;
+    /** Use sparse-checkout for worktrees */
+    enableSparseCheckout: boolean;
+    /** Patterns for sparse-checkout */
+    sparseCheckoutPatterns?: string[];
+    /** Branch naming prefix */
+    branchPrefix: string;
+    /** Cleanup orphaned worktrees on server startup */
+    cleanupOrphanedWorktreesOnStartup: boolean;
+}
+/**
+ * Worktree manager errors
+ */
+export declare class WorktreeError extends Error {
+    code: WorktreeErrorCode;
+    cause?: Error | undefined;
+    constructor(message: string, code: WorktreeErrorCode, cause?: Error | undefined);
+}
+export declare enum WorktreeErrorCode {
+    /** Git operation failed */
+    GIT_ERROR = "GIT_ERROR",
+    /** Worktree path already exists */
+    PATH_EXISTS = "PATH_EXISTS",
+    /** Worktree path not found */
+    PATH_NOT_FOUND = "PATH_NOT_FOUND",
+    /** Invalid path */
+    INVALID_PATH = "INVALID_PATH",
+    /** Branch not found */
+    BRANCH_NOT_FOUND = "BRANCH_NOT_FOUND",
+    /** Repository error */
+    REPOSITORY_ERROR = "REPOSITORY_ERROR",
+    /** Configuration error */
+    CONFIG_ERROR = "CONFIG_ERROR",
+    /** Locking error */
+    LOCK_ERROR = "LOCK_ERROR",
+    /** Cleanup failed */
+    CLEANUP_FAILED = "CLEANUP_FAILED"
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/execution/worktree/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/execution/worktree/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,mCAAmC;IACnC,YAAY,EAAE,OAAO,CAAC;IACtB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,2BAA2B;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,wCAAwC;IACxC,MAAM,EAAE,OAAO,CAAC;IAChB,qCAAqC;IACrC,QAAQ,EAAE,OAAO,CAAC;IAClB,kCAAkC;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,+BAA+B;IAC/B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,4CAA4C;IAC5C,kBAAkB,EAAE,OAAO,CAAC;IAC5B,sDAAsD;IACtD,kBAAkB,EAAE,OAAO,CAAC;IAC5B,wCAAwC;IACxC,oBAAoB,EAAE,OAAO,CAAC;IAC9B,mCAAmC;IACnC,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;IAClC,2BAA2B;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,iCAAiC,EAAE,OAAO,CAAC;CAC5C;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;IAG7B,IAAI,EAAE,iBAAiB;IACvB,KAAK,CAAC,EAAE,KAAK;gBAFpB,OAAO,EAAE,MAAM,EACR,IAAI,EAAE,iBAAiB,EACvB,KAAK,CAAC,EAAE,KAAK,YAAA;CAKvB;AAED,oBAAY,iBAAiB;IAC3B,2BAA2B;IAC3B,SAAS,cAAc;IACvB,mCAAmC;IACnC,WAAW,gBAAgB;IAC3B,8BAA8B;IAC9B,cAAc,mBAAmB;IACjC,mBAAmB;IACnB,YAAY,iBAAiB;IAC7B,uBAAuB;IACvB,gBAAgB,qBAAqB;IACrC,uBAAuB;IACvB,gBAAgB,qBAAqB;IACrC,0BAA0B;IAC1B,YAAY,iBAAiB;IAC7B,oBAAoB;IACpB,UAAU,eAAe;IACzB,qBAAqB;IACrB,cAAc,mBAAmB;CAClC"}

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import type Database from "better-sqlite3";
+import { TransportManager } from "./execution/transport/transport-manager.js";
+declare const app: import("express-serve-static-core").Express;
+declare let db: Database.Database;
+declare let transportManager: TransportManager;
+export default app;
+export { db, transportManager };
+//# 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":"AAOA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAgB3C,OAAO,EAAE,gBAAgB,EAAE,MAAM,4CAA4C,CAAC;AAkB9E,QAAA,MAAM,GAAG,6CAAY,CAAC;AAetB,QAAA,IAAI,EAAE,EAAG,QAAQ,CAAC,QAAQ,CAAC;AAE3B,QAAA,IAAI,gBAAgB,EAAG,gBAAgB,CAAC;AAkYxC,eAAe,GAAG,CAAC;AACnB,OAAO,EAAE,EAAE,EAAE,gBAAgB,EAAE,CAAC"}