glancey 2.0.0

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 glancey 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 GlanceyError 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>): GlanceyError;
+//# 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,YAAa,SAAQ,KAAK;IACrC,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,YAAY,CAGd"}

package/dist/utils/errors.js

@@ -0,0 +1,91 @@
+/**
+ * Error handling utilities for glancey MCP server.
+ *
+ * Provides structured error types, server-side logging, and debug mode support.
+ */
+/**
+ * Structured error with category and context
+ */
+export class GlanceyError extends Error {
+    category;
+    context;
+    constructor(message, category, context, cause) {
+        super(message);
+        this.name = 'GlanceyError';
+        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.GLANCEY_DEBUG === '1' || process.env.GLANCEY_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 ? `[glancey] [${toolName}]` : '[glancey]';
+    if (error instanceof GlanceyError) {
+        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 GlanceyError) {
+        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 GlanceyError(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/logger.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Structured logging utility for lance-context.
+ *
+ * Supports log levels (debug, info, warn, error) configured via environment variable.
+ */
+/** Available log levels in order of severity */
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'silent';
+/**
+ * Logger instance for structured logging.
+ */
+export declare const logger: {
+    /**
+     * Log debug information. Only shown when GLANCEY_LOG_LEVEL=debug.
+     */
+    debug(message: string, context?: string, data?: Record<string, unknown>): void;
+    /**
+     * Log informational messages. Default level.
+     */
+    info(message: string, context?: string, data?: Record<string, unknown>): void;
+    /**
+     * Log warning messages.
+     */
+    warn(message: string, context?: string, data?: Record<string, unknown>): void;
+    /**
+     * Log error messages.
+     */
+    error(message: string, context?: string, error?: unknown): void;
+    /**
+     * Get current log level.
+     */
+    getLevel(): LogLevel;
+    /**
+     * Check if debug logging is enabled.
+     */
+    isDebugEnabled(): boolean;
+};
+//# sourceMappingURL=logger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,gDAAgD;AAChD,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAoDtE;;GAEG;AACH,eAAO,MAAM,MAAM;IACjB;;OAEG;mBACY,MAAM,YAAY,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAQ9E;;OAEG;kBACW,MAAM,YAAY,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAQ7E;;OAEG;kBACW,MAAM,YAAY,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAQ7E;;OAEG;mBACY,MAAM,YAAY,MAAM,UAAU,OAAO,GAAG,IAAI;IAa/D;;OAEG;gBACS,QAAQ;IAIpB;;OAEG;sBACe,OAAO;CAG1B,CAAC"}

package/dist/utils/logger.js

@@ -0,0 +1,114 @@
+/**
+ * Structured logging utility for lance-context.
+ *
+ * Supports log levels (debug, info, warn, error) configured via environment variable.
+ */
+/** Numeric values for log level comparison */
+const LOG_LEVEL_VALUES = {
+    debug: 0,
+    info: 1,
+    warn: 2,
+    error: 3,
+    silent: 4,
+};
+/** Default log level when not configured */
+const DEFAULT_LOG_LEVEL = 'info';
+/** Prefix used for all log messages */
+const LOG_PREFIX = '[glancey]';
+/**
+ * Get the configured log level from environment.
+ */
+function getLogLevel() {
+    const envLevel = process.env.GLANCEY_LOG_LEVEL?.toLowerCase();
+    if (envLevel && envLevel in LOG_LEVEL_VALUES) {
+        return envLevel;
+    }
+    // Support legacy debug mode
+    if (process.env.GLANCEY_DEBUG === '1' || process.env.GLANCEY_DEBUG === 'true') {
+        return 'debug';
+    }
+    return DEFAULT_LOG_LEVEL;
+}
+/**
+ * Check if a log level should be output given current configuration.
+ */
+function shouldLog(level) {
+    const currentLevel = getLogLevel();
+    return LOG_LEVEL_VALUES[level] >= LOG_LEVEL_VALUES[currentLevel];
+}
+/**
+ * Format a log message with optional context.
+ */
+function formatMessage(level, message, context) {
+    const levelTag = level.toUpperCase().padEnd(5);
+    const contextTag = context ? `[${context}]` : '';
+    return `${LOG_PREFIX} ${levelTag} ${contextTag} ${message}`.trim();
+}
+/**
+ * Logger instance for structured logging.
+ */
+export const logger = {
+    /**
+     * Log debug information. Only shown when GLANCEY_LOG_LEVEL=debug.
+     */
+    debug(message, context, data) {
+        if (!shouldLog('debug'))
+            return;
+        console.error(formatMessage('debug', message, context));
+        if (data) {
+            console.error(`${LOG_PREFIX}       `, JSON.stringify(data, null, 2));
+        }
+    },
+    /**
+     * Log informational messages. Default level.
+     */
+    info(message, context, data) {
+        if (!shouldLog('info'))
+            return;
+        console.error(formatMessage('info', message, context));
+        if (data) {
+            console.error(`${LOG_PREFIX}       `, JSON.stringify(data, null, 2));
+        }
+    },
+    /**
+     * Log warning messages.
+     */
+    warn(message, context, data) {
+        if (!shouldLog('warn'))
+            return;
+        console.error(formatMessage('warn', message, context));
+        if (data) {
+            console.error(`${LOG_PREFIX}       `, JSON.stringify(data, null, 2));
+        }
+    },
+    /**
+     * Log error messages.
+     */
+    error(message, context, error) {
+        if (!shouldLog('error'))
+            return;
+        console.error(formatMessage('error', message, context));
+        if (error instanceof Error) {
+            console.error(`${LOG_PREFIX}       `, error.message);
+            if (getLogLevel() === 'debug' && error.stack) {
+                console.error(`${LOG_PREFIX}       `, error.stack);
+            }
+        }
+        else if (error !== undefined) {
+            console.error(`${LOG_PREFIX}       `, error);
+        }
+    },
+    /**
+     * Get current log level.
+     */
+    getLevel() {
+        return getLogLevel();
+    },
+    /**
+     * Check if debug logging is enabled.
+     */
+    isDebugEnabled() {
+        return shouldLog('debug');
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

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