lance-context 0.1.0 → 1.0.1

package/dist/utils/concurrency.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Process items in parallel with controlled concurrency.
+ * Unlike Promise.all which starts all promises at once, this limits
+ * how many are running at any time.
+ *
+ * @param items - Items to process
+ * @param fn - Async function to apply to each item
+ * @param concurrency - Maximum number of concurrent operations (default: 10)
+ * @returns Promise resolving to results in the same order as items
+ *
+ * @example
+ * ```typescript
+ * const results = await mapWithConcurrency(
+ *   files,
+ *   async (file) => processFile(file),
+ *   10 // max 10 concurrent file operations
+ * );
+ * ```
+ */
+export declare function mapWithConcurrency<T, R>(items: T[], fn: (item: T, index: number) => Promise<R>, concurrency?: number): Promise<R[]>;
+/**
+ * Process items in batches, where each batch is processed in parallel.
+ * Useful when you want to process groups at a time with progress reporting.
+ *
+ * @param items - Items to process
+ * @param fn - Async function to apply to each item
+ * @param batchSize - Number of items per batch
+ * @param onBatchComplete - Optional callback after each batch completes
+ * @returns Promise resolving to results in the same order as items
+ */
+export declare function mapInBatches<T, R>(items: T[], fn: (item: T, index: number) => Promise<R>, batchSize?: number, onBatchComplete?: (completedCount: number, totalCount: number) => void): Promise<R[]>;
+//# sourceMappingURL=concurrency.d.ts.map

package/dist/utils/concurrency.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.d.ts","sourceRoot":"","sources":["../../src/utils/concurrency.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,EAAE,CAAC,EAC3C,KAAK,EAAE,CAAC,EAAE,EACV,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAC1C,WAAW,GAAE,MAAW,GACvB,OAAO,CAAC,CAAC,EAAE,CAAC,CAkBd;AAED;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAAC,CAAC,EAAE,CAAC,EACrC,KAAK,EAAE,CAAC,EAAE,EACV,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,EAC1C,SAAS,GAAE,MAAW,EACtB,eAAe,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,GACrE,OAAO,CAAC,CAAC,EAAE,CAAC,CAcd"}

package/dist/utils/concurrency.js

@@ -0,0 +1,57 @@
+/**
+ * Process items in parallel with controlled concurrency.
+ * Unlike Promise.all which starts all promises at once, this limits
+ * how many are running at any time.
+ *
+ * @param items - Items to process
+ * @param fn - Async function to apply to each item
+ * @param concurrency - Maximum number of concurrent operations (default: 10)
+ * @returns Promise resolving to results in the same order as items
+ *
+ * @example
+ * ```typescript
+ * const results = await mapWithConcurrency(
+ *   files,
+ *   async (file) => processFile(file),
+ *   10 // max 10 concurrent file operations
+ * );
+ * ```
+ */
+export async function mapWithConcurrency(items, fn, concurrency = 10) {
+    const results = new Array(items.length);
+    let currentIndex = 0;
+    async function processNext() {
+        while (currentIndex < items.length) {
+            const index = currentIndex++;
+            results[index] = await fn(items[index], index);
+        }
+    }
+    // Start 'concurrency' number of workers
+    const workers = Array(Math.min(concurrency, items.length))
+        .fill(null)
+        .map(() => processNext());
+    await Promise.all(workers);
+    return results;
+}
+/**
+ * Process items in batches, where each batch is processed in parallel.
+ * Useful when you want to process groups at a time with progress reporting.
+ *
+ * @param items - Items to process
+ * @param fn - Async function to apply to each item
+ * @param batchSize - Number of items per batch
+ * @param onBatchComplete - Optional callback after each batch completes
+ * @returns Promise resolving to results in the same order as items
+ */
+export async function mapInBatches(items, fn, batchSize = 10, onBatchComplete) {
+    const results = [];
+    for (let i = 0; i < items.length; i += batchSize) {
+        const batch = items.slice(i, i + batchSize);
+        const batchStartIndex = i;
+        const batchResults = await Promise.all(batch.map((item, idx) => fn(item, batchStartIndex + idx)));
+        results.push(...batchResults);
+        onBatchComplete?.(results.length, items.length);
+    }
+    return results;
+}
+//# sourceMappingURL=concurrency.js.map

package/dist/utils/concurrency.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"concurrency.js","sourceRoot":"","sources":["../../src/utils/concurrency.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,KAAU,EACV,EAA0C,EAC1C,cAAsB,EAAE;IAExB,MAAM,OAAO,GAAQ,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,YAAY,GAAG,CAAC,CAAC;IAErB,KAAK,UAAU,WAAW;QACxB,OAAO,YAAY,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YACnC,MAAM,KAAK,GAAG,YAAY,EAAE,CAAC;YAC7B,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED,wCAAwC;IACxC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;SACvD,IAAI,CAAC,IAAI,CAAC;SACV,GAAG,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;IAE5B,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IAC3B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAAU,EACV,EAA0C,EAC1C,YAAoB,EAAE,EACtB,eAAsE;IAEtE,MAAM,OAAO,GAAQ,EAAE,CAAC;IAExB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,SAAS,EAAE,CAAC;QACjD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,CAAC;QAC5C,MAAM,eAAe,GAAG,CAAC,CAAC;QAC1B,MAAM,YAAY,GAAG,MAAM,OAAO,CAAC,GAAG,CACpC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,eAAe,GAAG,GAAG,CAAC,CAAC,CAC1D,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,GAAG,YAAY,CAAC,CAAC;QAC9B,eAAe,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Error handling utilities for lance-context MCP server.
+ *
+ * Provides structured error types, server-side logging, and debug mode support.
+ */
+/**
+ * Error categories for different failure modes
+ */
+export type ErrorCategory = 'validation' | 'indexing' | 'search' | 'embedding' | 'config' | 'git' | 'worktree' | 'internal';
+/**
+ * Structured error with category and context
+ */
+export declare class LanceContextError extends Error {
+    readonly category: ErrorCategory;
+    readonly context?: Record<string, unknown>;
+    constructor(message: string, category: ErrorCategory, context?: Record<string, unknown>, cause?: Error);
+}
+/**
+ * Check if debug mode is enabled via environment variable
+ */
+export declare function isDebugMode(): boolean;
+/**
+ * Log an error server-side with full context.
+ * Always logs to stderr for debugging purposes.
+ */
+export declare function logError(error: unknown, toolName?: string): void;
+/**
+ * Format an error for client response.
+ * In debug mode, includes stack traces. Otherwise, just the message.
+ */
+export declare function formatErrorResponse(error: unknown): string;
+/**
+ * Wrap an error with additional context, preserving the original error.
+ */
+export declare function wrapError(message: string, category: ErrorCategory, cause: unknown, context?: Record<string, unknown>): LanceContextError;
+//# sourceMappingURL=errors.d.ts.map

package/dist/utils/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,YAAY,GACZ,UAAU,GACV,QAAQ,GACR,WAAW,GACX,QAAQ,GACR,KAAK,GACL,UAAU,GACV,UAAU,CAAC;AAEf;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IACjC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAGzC,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,KAAK,CAAC,EAAE,KAAK;CAchB;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAErC;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAmBhE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAyB1D;AAED;;GAEG;AACH,wBAAgB,SAAS,CACvB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,aAAa,EACvB,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,iBAAiB,CAGnB"}

package/dist/utils/errors.js

@@ -0,0 +1,91 @@
+/**
+ * Error handling utilities for lance-context MCP server.
+ *
+ * Provides structured error types, server-side logging, and debug mode support.
+ */
+/**
+ * Structured error with category and context
+ */
+export class LanceContextError extends Error {
+    category;
+    context;
+    constructor(message, category, context, cause) {
+        super(message);
+        this.name = 'LanceContextError';
+        this.category = category;
+        this.context = context;
+        if (cause) {
+            this.cause = cause;
+            // Preserve original stack if available
+            if (cause.stack) {
+                this.stack = `${this.stack}\nCaused by: ${cause.stack}`;
+            }
+        }
+    }
+}
+/**
+ * Check if debug mode is enabled via environment variable
+ */
+export function isDebugMode() {
+    return process.env.LANCE_CONTEXT_DEBUG === '1' || process.env.LANCE_CONTEXT_DEBUG === 'true';
+}
+/**
+ * Log an error server-side with full context.
+ * Always logs to stderr for debugging purposes.
+ */
+export function logError(error, toolName) {
+    const prefix = toolName ? `[lance-context] [${toolName}]` : '[lance-context]';
+    if (error instanceof LanceContextError) {
+        console.error(`${prefix} ${error.category} error: ${error.message}`);
+        if (error.context) {
+            console.error(`${prefix} Context:`, JSON.stringify(error.context, null, 2));
+        }
+        if (error.stack) {
+            console.error(`${prefix} Stack trace:\n${error.stack}`);
+        }
+    }
+    else if (error instanceof Error) {
+        console.error(`${prefix} Error: ${error.message}`);
+        if (error.stack) {
+            console.error(`${prefix} Stack trace:\n${error.stack}`);
+        }
+    }
+    else {
+        console.error(`${prefix} Unknown error:`, error);
+    }
+}
+/**
+ * Format an error for client response.
+ * In debug mode, includes stack traces. Otherwise, just the message.
+ */
+export function formatErrorResponse(error) {
+    const debug = isDebugMode();
+    if (error instanceof LanceContextError) {
+        let response = `Error [${error.category}]: ${error.message}`;
+        if (debug) {
+            if (error.context) {
+                response += `\n\nContext: ${JSON.stringify(error.context, null, 2)}`;
+            }
+            if (error.stack) {
+                response += `\n\nStack trace:\n${error.stack}`;
+            }
+        }
+        return response;
+    }
+    if (error instanceof Error) {
+        let response = `Error: ${error.message}`;
+        if (debug && error.stack) {
+            response += `\n\nStack trace:\n${error.stack}`;
+        }
+        return response;
+    }
+    return `Error: ${String(error)}`;
+}
+/**
+ * Wrap an error with additional context, preserving the original error.
+ */
+export function wrapError(message, category, cause, context) {
+    const causeError = cause instanceof Error ? cause : new Error(String(cause));
+    return new LanceContextError(message, category, context, causeError);
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

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

package/dist/utils/type-guards.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Type guard for string arrays
+ */
+export declare function isStringArray(value: unknown): value is string[];
+/**
+ * Type guard for strings
+ */
+export declare function isString(value: unknown): value is string;
+/**
+ * Type guard for numbers
+ */
+export declare function isNumber(value: unknown): value is number;
+/**
+ * Type guard for booleans
+ */
+export declare function isBoolean(value: unknown): value is boolean;
+//# sourceMappingURL=type-guards.d.ts.map

package/dist/utils/type-guards.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.d.ts","sourceRoot":"","sources":["../../src/utils/type-guards.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,EAAE,CAE/D;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAE1D"}

package/dist/utils/type-guards.js

@@ -0,0 +1,25 @@
+/**
+ * Type guard for string arrays
+ */
+export function isStringArray(value) {
+    return Array.isArray(value) && value.every((v) => typeof v === 'string');
+}
+/**
+ * Type guard for strings
+ */
+export function isString(value) {
+    return typeof value === 'string';
+}
+/**
+ * Type guard for numbers
+ */
+export function isNumber(value) {
+    return typeof value === 'number' && !isNaN(value);
+}
+/**
+ * Type guard for booleans
+ */
+export function isBoolean(value) {
+    return typeof value === 'boolean';
+}
+//# sourceMappingURL=type-guards.js.map

package/dist/utils/type-guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-guards.js","sourceRoot":"","sources":["../../src/utils/type-guards.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;AAC3E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACpD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,OAAO,KAAK,KAAK,SAAS,CAAC;AACpC,CAAC"}

package/dist/worktree/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Git worktree management module for parallel agent isolation.
+ */
+export type { BranchPrefix, PackageManager, WorktreeInfo, CreateWorktreeOptions, CreateWorktreeResult, RemoveWorktreeOptions, RemoveWorktreeResult, ListWorktreesResult, } from './types.js';
+export { WorktreeManager, formatWorktreeInfo, formatWorktreeList } from './worktree-manager.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/worktree/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/worktree/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/worktree/index.js

@@ -0,0 +1,6 @@
+/**
+ * Git worktree management module for parallel agent isolation.
+ */
+// Manager
+export { WorktreeManager, formatWorktreeInfo, formatWorktreeList } from './worktree-manager.js';
+//# sourceMappingURL=index.js.map

package/dist/worktree/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/worktree/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAcH,UAAU;AACV,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/worktree/types.d.ts

@@ -0,0 +1,101 @@
+/**
+ * Types and interfaces for git worktree management.
+ * Enables parallel agent isolation through automatic worktree creation.
+ */
+/**
+ * Branch prefix types that follow .claude/rules.md conventions.
+ */
+export type BranchPrefix = 'feature' | 'fix' | 'refactor' | 'docs' | 'test';
+/**
+ * Package manager types for dependency installation.
+ */
+export type PackageManager = 'npm' | 'yarn' | 'pnpm' | 'bun';
+/**
+ * Information about a git worktree.
+ */
+export interface WorktreeInfo {
+    /** Worktree name (directory name within .git/agent-worktrees/) */
+    name: string;
+    /** Full path to the worktree directory */
+    path: string;
+    /** Branch name the worktree is on */
+    branch: string;
+    /** Current HEAD commit hash (short) */
+    commit: string;
+    /** Whether the worktree is valid/exists */
+    valid: boolean;
+    /** Whether there are uncommitted changes */
+    dirty: boolean;
+    /** Number of commits ahead of base branch */
+    ahead: number;
+    /** Number of commits behind base branch */
+    behind: number;
+    /** Timestamp when the worktree was created */
+    createdAt?: Date;
+}
+/**
+ * Options for creating a new worktree.
+ */
+export interface CreateWorktreeOptions {
+    /** Issue ID (e.g., "bd-123") - optional, used for naming */
+    issueId?: string;
+    /** Short descriptive name (e.g., "add-auth") - required */
+    shortName: string;
+    /** Branch prefix (default: "feature") */
+    prefix?: BranchPrefix;
+    /** Base branch to create from (default: current branch or main) */
+    baseBranch?: string;
+    /** Whether to install dependencies after creation (default: true) */
+    installDeps?: boolean;
+    /** Package manager to use (default: auto-detect) */
+    packageManager?: PackageManager;
+}
+/**
+ * Result from creating a worktree.
+ */
+export interface CreateWorktreeResult {
+    /** Whether the operation succeeded */
+    success: boolean;
+    /** Worktree info if successful */
+    worktree?: WorktreeInfo;
+    /** Error message if failed */
+    error?: string;
+    /** Whether dependencies were installed */
+    depsInstalled?: boolean;
+    /** Time taken to install dependencies (ms) */
+    depsInstallTime?: number;
+}
+/**
+ * Options for removing a worktree.
+ */
+export interface RemoveWorktreeOptions {
+    /** Worktree name to remove */
+    name: string;
+    /** Whether to also delete the branch (default: false) */
+    deleteBranch?: boolean;
+    /** Force removal even if dirty (default: false) */
+    force?: boolean;
+}
+/**
+ * Result from removing a worktree.
+ */
+export interface RemoveWorktreeResult {
+    /** Whether the operation succeeded */
+    success: boolean;
+    /** Branch name that was associated */
+    branch?: string;
+    /** Whether the branch was deleted */
+    branchDeleted?: boolean;
+    /** Error message if failed */
+    error?: string;
+}
+/**
+ * Result from listing worktrees.
+ */
+export interface ListWorktreesResult {
+    /** List of worktrees */
+    worktrees: WorktreeInfo[];
+    /** Total count */
+    count: number;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/worktree/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,KAAK,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAE5E;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAE7D;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,KAAK,EAAE,OAAO,CAAC;IACf,4CAA4C;IAC5C,KAAK,EAAE,OAAO,CAAC;IACf,6CAA6C;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,2CAA2C;IAC3C,MAAM,EAAE,MAAM,CAAC;IACf,8CAA8C;IAC9C,SAAS,CAAC,EAAE,IAAI,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,4DAA4D;IAC5D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,mEAAmE;IACnE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,qEAAqE;IACrE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,oDAAoD;IACpD,cAAc,CAAC,EAAE,cAAc,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,kCAAkC;IAClC,QAAQ,CAAC,EAAE,YAAY,CAAC;IACxB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0CAA0C;IAC1C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,8CAA8C;IAC9C,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,8BAA8B;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,mDAAmD;IACnD,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,sCAAsC;IACtC,OAAO,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,wBAAwB;IACxB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,kBAAkB;IAClB,KAAK,EAAE,MAAM,CAAC;CACf"}

package/dist/worktree/types.js

@@ -0,0 +1,6 @@
+/**
+ * Types and interfaces for git worktree management.
+ * Enables parallel agent isolation through automatic worktree creation.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/worktree/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/worktree/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

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

@@ -0,0 +1,80 @@
+/**
+ * Git worktree management for parallel agent isolation.
+ *
+ * Creates isolated workspaces in .git/agent-worktrees/ to allow multiple
+ * agents to work simultaneously without file conflicts.
+ */
+import type { PackageManager, WorktreeInfo, CreateWorktreeOptions, CreateWorktreeResult, RemoveWorktreeOptions, RemoveWorktreeResult, ListWorktreesResult } from './types.js';
+/**
+ * Manages git worktrees for parallel agent isolation.
+ */
+export declare class WorktreeManager {
+    private readonly projectPath;
+    private readonly worktreesDir;
+    constructor(projectPath: string);
+    /**
+     * Ensure the worktrees directory exists.
+     */
+    private ensureWorktreesDir;
+    /**
+     * Generate a worktree name from options.
+     */
+    private generateName;
+    /**
+     * Generate a branch name from options.
+     */
+    private generateBranchName;
+    /**
+     * Detect the package manager used in a directory.
+     */
+    detectPackageManager(dir: string): Promise<PackageManager | null>;
+    /**
+     * Install dependencies in a directory.
+     */
+    installDependencies(dir: string, packageManager?: PackageManager): Promise<{
+        success: boolean;
+        time: number;
+        error?: string;
+    }>;
+    /**
+     * Get the current branch name.
+     */
+    getCurrentBranch(): Promise<string>;
+    /**
+     * Get the default base branch (main or master).
+     */
+    getDefaultBaseBranch(): Promise<string>;
+    /**
+     * Check if a branch exists.
+     */
+    branchExists(branchName: string): Promise<boolean>;
+    /**
+     * Create a new worktree for isolated agent work.
+     */
+    createWorktree(options: CreateWorktreeOptions): Promise<CreateWorktreeResult>;
+    /**
+     * Get information about a specific worktree.
+     */
+    getWorktreeInfo(name: string): Promise<WorktreeInfo | null>;
+    /**
+     * List all agent worktrees.
+     */
+    listWorktrees(): Promise<ListWorktreesResult>;
+    /**
+     * Remove a worktree.
+     */
+    removeWorktree(options: RemoveWorktreeOptions): Promise<RemoveWorktreeResult>;
+    /**
+     * Prune stale worktree entries from git.
+     */
+    pruneWorktrees(): Promise<void>;
+}
+/**
+ * Format worktree info for display.
+ */
+export declare function formatWorktreeInfo(info: WorktreeInfo): string;
+/**
+ * Format list of worktrees for display.
+ */
+export declare function formatWorktreeList(result: ListWorktreesResult): string;
+//# sourceMappingURL=worktree-manager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-manager.d.ts","sourceRoot":"","sources":["../../src/worktree/worktree-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EACZ,qBAAqB,EACrB,oBAAoB,EACpB,qBAAqB,EACrB,oBAAoB,EACpB,mBAAmB,EACpB,MAAM,YAAY,CAAC;AAIpB;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;gBAE1B,WAAW,EAAE,MAAM;IAK/B;;OAEG;YACW,kBAAkB;IAMhC;;OAEG;IACH,OAAO,CAAC,YAAY;IAOpB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAM1B;;OAEG;IACG,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAuBvE;;OAEG;IACG,mBAAmB,CACvB,GAAG,EAAE,MAAM,EACX,cAAc,CAAC,EAAE,cAAc,GAC9B,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IA2B9D;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,MAAM,CAAC;IASzC;;OAEG;IACG,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC;IAiB7C;;OAEG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IASxD;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAuEnF;;OAEG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAmFjE;;OAEG;IACG,aAAa,IAAI,OAAO,CAAC,mBAAmB,CAAC;IA4BnD;;OAEG;IACG,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAyDnF;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;CAGtC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAkB7D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,mBAAmB,GAAG,MAAM,CAgBtE"}