lance-context 0.1.0 → 1.0.1

package/dist/worktree/worktree-manager.js

@@ -0,0 +1,407 @@
+/**
+ * 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 * as fs from 'fs';
+import * as path from 'path';
+import { exec } from 'child_process';
+import { promisify } from 'util';
+const execAsync = promisify(exec);
+/**
+ * Manages git worktrees for parallel agent isolation.
+ */
+export class WorktreeManager {
+    projectPath;
+    worktreesDir;
+    constructor(projectPath) {
+        this.projectPath = projectPath;
+        this.worktreesDir = path.join(projectPath, '.git', 'agent-worktrees');
+    }
+    /**
+     * Ensure the worktrees directory exists.
+     */
+    async ensureWorktreesDir() {
+        if (!fs.existsSync(this.worktreesDir)) {
+            fs.mkdirSync(this.worktreesDir, { recursive: true });
+        }
+    }
+    /**
+     * Generate a worktree name from options.
+     */
+    generateName(options) {
+        if (options.issueId) {
+            return `${options.issueId}-${options.shortName}`;
+        }
+        return options.shortName;
+    }
+    /**
+     * Generate a branch name from options.
+     */
+    generateBranchName(options) {
+        const prefix = options.prefix || 'feature';
+        const name = this.generateName(options);
+        return `${prefix}/${name}`;
+    }
+    /**
+     * Detect the package manager used in a directory.
+     */
+    async detectPackageManager(dir) {
+        // Check for lock files in order of preference
+        const lockFiles = [
+            { file: 'bun.lockb', manager: 'bun' },
+            { file: 'pnpm-lock.yaml', manager: 'pnpm' },
+            { file: 'yarn.lock', manager: 'yarn' },
+            { file: 'package-lock.json', manager: 'npm' },
+        ];
+        for (const { file, manager } of lockFiles) {
+            if (fs.existsSync(path.join(dir, file))) {
+                return manager;
+            }
+        }
+        // Check if package.json exists at all
+        if (fs.existsSync(path.join(dir, 'package.json'))) {
+            return 'npm'; // Default to npm if package.json exists but no lock file
+        }
+        return null;
+    }
+    /**
+     * Install dependencies in a directory.
+     */
+    async installDependencies(dir, packageManager) {
+        const startTime = Date.now();
+        const manager = packageManager || (await this.detectPackageManager(dir));
+        if (!manager) {
+            return { success: true, time: 0 }; // No package.json, nothing to install
+        }
+        const commands = {
+            npm: 'npm install',
+            yarn: 'yarn install',
+            pnpm: 'pnpm install',
+            bun: 'bun install',
+        };
+        try {
+            await execAsync(commands[manager], {
+                cwd: dir,
+                env: { ...process.env, CI: 'true' }, // Suppress interactive prompts
+            });
+            return { success: true, time: Date.now() - startTime };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return { success: false, time: Date.now() - startTime, error: message };
+        }
+    }
+    /**
+     * Get the current branch name.
+     */
+    async getCurrentBranch() {
+        try {
+            const { stdout } = await execAsync('git branch --show-current', { cwd: this.projectPath });
+            return stdout.trim() || 'main';
+        }
+        catch {
+            return 'main';
+        }
+    }
+    /**
+     * Get the default base branch (main or master).
+     */
+    async getDefaultBaseBranch() {
+        try {
+            // Check if main exists
+            await execAsync('git rev-parse --verify main', { cwd: this.projectPath });
+            return 'main';
+        }
+        catch {
+            try {
+                // Check if master exists
+                await execAsync('git rev-parse --verify master', { cwd: this.projectPath });
+                return 'master';
+            }
+            catch {
+                // Default to whatever the current branch is
+                return this.getCurrentBranch();
+            }
+        }
+    }
+    /**
+     * Check if a branch exists.
+     */
+    async branchExists(branchName) {
+        try {
+            await execAsync(`git rev-parse --verify ${branchName}`, { cwd: this.projectPath });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Create a new worktree for isolated agent work.
+     */
+    async createWorktree(options) {
+        await this.ensureWorktreesDir();
+        const name = this.generateName(options);
+        const worktreePath = path.join(this.worktreesDir, name);
+        const branchName = this.generateBranchName(options);
+        // Check if worktree already exists
+        if (fs.existsSync(worktreePath)) {
+            return {
+                success: false,
+                error: `Worktree "${name}" already exists at ${worktreePath}`,
+            };
+        }
+        // Check if branch already exists
+        if (await this.branchExists(branchName)) {
+            return {
+                success: false,
+                error: `Branch "${branchName}" already exists. Use a different short_name or issue_id.`,
+            };
+        }
+        // Determine base branch
+        const baseBranch = options.baseBranch || (await this.getDefaultBaseBranch());
+        try {
+            // Create worktree with a new branch
+            await execAsync(`git worktree add -b ${branchName} "${worktreePath}" ${baseBranch}`, {
+                cwd: this.projectPath,
+            });
+            // Get worktree info
+            const info = await this.getWorktreeInfo(name);
+            if (!info) {
+                return {
+                    success: false,
+                    error: 'Worktree created but failed to get info',
+                };
+            }
+            // Install dependencies if requested (default: true)
+            let depsInstalled = false;
+            let depsInstallTime;
+            if (options.installDeps !== false) {
+                const installResult = await this.installDependencies(worktreePath, options.packageManager);
+                depsInstalled = installResult.success;
+                depsInstallTime = installResult.time;
+                if (!installResult.success) {
+                    // Don't fail the worktree creation, just note the issue
+                    console.error(`[worktree] Dependency installation failed: ${installResult.error}`);
+                }
+            }
+            return {
+                success: true,
+                worktree: info,
+                depsInstalled,
+                depsInstallTime,
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                success: false,
+                error: `Failed to create worktree: ${message}`,
+            };
+        }
+    }
+    /**
+     * Get information about a specific worktree.
+     */
+    async getWorktreeInfo(name) {
+        const worktreePath = path.join(this.worktreesDir, name);
+        if (!fs.existsSync(worktreePath)) {
+            return null;
+        }
+        try {
+            // Get branch name
+            const { stdout: branchOutput } = await execAsync('git branch --show-current', {
+                cwd: worktreePath,
+            });
+            const branch = branchOutput.trim();
+            // Get current commit (short hash)
+            const { stdout: commitOutput } = await execAsync('git rev-parse --short HEAD', {
+                cwd: worktreePath,
+            });
+            const commit = commitOutput.trim();
+            // Check if dirty (uncommitted changes)
+            let dirty = false;
+            try {
+                const { stdout: statusOutput } = await execAsync('git status --porcelain', {
+                    cwd: worktreePath,
+                });
+                dirty = statusOutput.trim().length > 0;
+            }
+            catch {
+                dirty = false;
+            }
+            // Get ahead/behind count relative to origin
+            let ahead = 0;
+            let behind = 0;
+            try {
+                // Get the default base branch for comparison
+                const baseBranch = await this.getDefaultBaseBranch();
+                const { stdout: aheadBehindOutput } = await execAsync(`git rev-list --left-right --count ${baseBranch}...HEAD`, { cwd: worktreePath });
+                const [behindStr, aheadStr] = aheadBehindOutput.trim().split('\t');
+                behind = parseInt(behindStr, 10) || 0;
+                ahead = parseInt(aheadStr, 10) || 0;
+            }
+            catch {
+                // Ignore errors - ahead/behind may not be available
+            }
+            // Get creation time from directory stat
+            let createdAt;
+            try {
+                const stats = fs.statSync(worktreePath);
+                createdAt = stats.birthtime;
+            }
+            catch {
+                // Ignore
+            }
+            return {
+                name,
+                path: worktreePath,
+                branch,
+                commit,
+                valid: true,
+                dirty,
+                ahead,
+                behind,
+                createdAt,
+            };
+        }
+        catch {
+            // Worktree exists but git commands failed - may be in invalid state
+            return {
+                name,
+                path: worktreePath,
+                branch: '',
+                commit: '',
+                valid: false,
+                dirty: false,
+                ahead: 0,
+                behind: 0,
+            };
+        }
+    }
+    /**
+     * List all agent worktrees.
+     */
+    async listWorktrees() {
+        if (!fs.existsSync(this.worktreesDir)) {
+            return { worktrees: [], count: 0 };
+        }
+        const entries = fs.readdirSync(this.worktreesDir, { withFileTypes: true });
+        const worktrees = [];
+        for (const entry of entries) {
+            if (entry.isDirectory()) {
+                const info = await this.getWorktreeInfo(entry.name);
+                if (info) {
+                    worktrees.push(info);
+                }
+            }
+        }
+        // Sort by creation time (newest first)
+        worktrees.sort((a, b) => {
+            if (a.createdAt && b.createdAt) {
+                return b.createdAt.getTime() - a.createdAt.getTime();
+            }
+            return a.name.localeCompare(b.name);
+        });
+        return { worktrees, count: worktrees.length };
+    }
+    /**
+     * Remove a worktree.
+     */
+    async removeWorktree(options) {
+        const worktreePath = path.join(this.worktreesDir, options.name);
+        if (!fs.existsSync(worktreePath)) {
+            return {
+                success: false,
+                error: `Worktree "${options.name}" does not exist`,
+            };
+        }
+        // Get info before removal to know the branch name
+        const info = await this.getWorktreeInfo(options.name);
+        const branchName = info?.branch;
+        // Check if dirty and force not specified
+        if (info?.dirty && !options.force) {
+            return {
+                success: false,
+                branch: branchName,
+                error: `Worktree "${options.name}" has uncommitted changes. Use force=true to remove anyway.`,
+            };
+        }
+        try {
+            // Remove the worktree
+            const forceFlag = options.force ? '--force' : '';
+            await execAsync(`git worktree remove ${forceFlag} "${worktreePath}"`, {
+                cwd: this.projectPath,
+            });
+            // Optionally delete the branch
+            let branchDeleted = false;
+            if (options.deleteBranch && branchName) {
+                try {
+                    await execAsync(`git branch -D ${branchName}`, { cwd: this.projectPath });
+                    branchDeleted = true;
+                }
+                catch (error) {
+                    // Branch deletion failed - not critical
+                    console.error(`[worktree] Failed to delete branch ${branchName}:`, error);
+                }
+            }
+            return {
+                success: true,
+                branch: branchName,
+                branchDeleted,
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                success: false,
+                branch: branchName,
+                error: `Failed to remove worktree: ${message}`,
+            };
+        }
+    }
+    /**
+     * Prune stale worktree entries from git.
+     */
+    async pruneWorktrees() {
+        await execAsync('git worktree prune', { cwd: this.projectPath });
+    }
+}
+/**
+ * Format worktree info for display.
+ */
+export function formatWorktreeInfo(info) {
+    const parts = [];
+    parts.push(`## Worktree: ${info.name}`);
+    parts.push(`**Path:** ${info.path}`);
+    parts.push(`**Branch:** ${info.branch}`);
+    parts.push(`**Commit:** ${info.commit}`);
+    parts.push(`**Status:** ${info.valid ? (info.dirty ? 'dirty' : 'clean') : 'invalid'}`);
+    if (info.ahead > 0 || info.behind > 0) {
+        parts.push(`**Ahead/Behind:** +${info.ahead}/-${info.behind}`);
+    }
+    if (info.createdAt) {
+        parts.push(`**Created:** ${info.createdAt.toISOString()}`);
+    }
+    return parts.join('\n');
+}
+/**
+ * Format list of worktrees for display.
+ */
+export function formatWorktreeList(result) {
+    if (result.count === 0) {
+        return 'No agent worktrees found.';
+    }
+    const parts = [];
+    parts.push(`Found ${result.count} worktree(s):\n`);
+    for (const wt of result.worktrees) {
+        const status = wt.valid ? (wt.dirty ? '(dirty)' : '(clean)') : '(invalid)';
+        const aheadBehind = wt.ahead > 0 || wt.behind > 0 ? ` [+${wt.ahead}/-${wt.behind}]` : '';
+        parts.push(`- **${wt.name}** on \`${wt.branch}\` ${status}${aheadBehind}`);
+        parts.push(`  Path: ${wt.path}`);
+    }
+    return parts.join('\n');
+}
+//# sourceMappingURL=worktree-manager.js.map

package/dist/worktree/worktree-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-manager.js","sourceRoot":"","sources":["../../src/worktree/worktree-manager.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,SAAS,EAAE,MAAM,MAAM,CAAC;AAWjC,MAAM,SAAS,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;AAElC;;GAEG;AACH,MAAM,OAAO,eAAe;IACT,WAAW,CAAS;IACpB,YAAY,CAAS;IAEtC,YAAY,WAAmB;QAC7B,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,iBAAiB,CAAC,CAAC;IACxE,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,kBAAkB;QAC9B,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;YACtC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IAED;;OAEG;IACK,YAAY,CAAC,OAA8B;QACjD,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,GAAG,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;QACnD,CAAC;QACD,OAAO,OAAO,CAAC,SAAS,CAAC;IAC3B,CAAC;IAED;;OAEG;IACK,kBAAkB,CAAC,OAA8B;QACvD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,SAAS,CAAC;QAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QACxC,OAAO,GAAG,MAAM,IAAI,IAAI,EAAE,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,oBAAoB,CAAC,GAAW;QACpC,8CAA8C;QAC9C,MAAM,SAAS,GAAqD;YAClE,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,KAAK,EAAE;YACrC,EAAE,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE;YAC3C,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE;YACtC,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,KAAK,EAAE;SAC9C,CAAC;QAEF,KAAK,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,SAAS,EAAE,CAAC;YAC1C,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;gBACxC,OAAO,OAAO,CAAC;YACjB,CAAC;QACH,CAAC;QAED,sCAAsC;QACtC,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC;YAClD,OAAO,KAAK,CAAC,CAAC,yDAAyD;QACzE,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,mBAAmB,CACvB,GAAW,EACX,cAA+B;QAE/B,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAE7B,MAAM,OAAO,GAAG,cAAc,IAAI,CAAC,MAAM,IAAI,CAAC,oBAAoB,CAAC,GAAG,CAAC,CAAC,CAAC;QACzE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,sCAAsC;QAC3E,CAAC;QAED,MAAM,QAAQ,GAAmC;YAC/C,GAAG,EAAE,aAAa;YAClB,IAAI,EAAE,cAAc;YACpB,IAAI,EAAE,cAAc;YACpB,GAAG,EAAE,aAAa;SACnB,CAAC;QAEF,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE;gBACjC,GAAG,EAAE,GAAG;gBACR,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,+BAA+B;aACrE,CAAC,CAAC;YACH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE,CAAC;QACzD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;QAC1E,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,gBAAgB;QACpB,IAAI,CAAC;YACH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,2BAA2B,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;YAC3F,OAAO,MAAM,CAAC,IAAI,EAAE,IAAI,MAAM,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,oBAAoB;QACxB,IAAI,CAAC;YACH,uBAAuB;YACvB,MAAM,SAAS,CAAC,6BAA6B,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;YAC1E,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,CAAC;gBACH,yBAAyB;gBACzB,MAAM,SAAS,CAAC,+BAA+B,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;gBAC5E,OAAO,QAAQ,CAAC;YAClB,CAAC;YAAC,MAAM,CAAC;gBACP,4CAA4C;gBAC5C,OAAO,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACjC,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,YAAY,CAAC,UAAkB;QACnC,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,0BAA0B,UAAU,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;YACnF,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAAC,OAA8B;QACjD,MAAM,IAAI,CAAC,kBAAkB,EAAE,CAAC;QAEhC,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QACxC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QACxD,MAAM,UAAU,GAAG,IAAI,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;QAEpD,mCAAmC;QACnC,IAAI,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YAChC,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,aAAa,IAAI,uBAAuB,YAAY,EAAE;aAC9D,CAAC;QACJ,CAAC;QAED,iCAAiC;QACjC,IAAI,MAAM,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,EAAE,CAAC;YACxC,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,WAAW,UAAU,2DAA2D;aACxF,CAAC;QACJ,CAAC;QAED,wBAAwB;QACxB,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,CAAC,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC,CAAC;QAE7E,IAAI,CAAC;YACH,oCAAoC;YACpC,MAAM,SAAS,CAAC,uBAAuB,UAAU,KAAK,YAAY,KAAK,UAAU,EAAE,EAAE;gBACnF,GAAG,EAAE,IAAI,CAAC,WAAW;aACtB,CAAC,CAAC;YAEH,oBAAoB;YACpB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;YAC9C,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO;oBACL,OAAO,EAAE,KAAK;oBACd,KAAK,EAAE,yCAAyC;iBACjD,CAAC;YACJ,CAAC;YAED,oDAAoD;YACpD,IAAI,aAAa,GAAG,KAAK,CAAC;YAC1B,IAAI,eAAmC,CAAC;YAExC,IAAI,OAAO,CAAC,WAAW,KAAK,KAAK,EAAE,CAAC;gBAClC,MAAM,aAAa,GAAG,MAAM,IAAI,CAAC,mBAAmB,CAAC,YAAY,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;gBAC3F,aAAa,GAAG,aAAa,CAAC,OAAO,CAAC;gBACtC,eAAe,GAAG,aAAa,CAAC,IAAI,CAAC;gBAErC,IAAI,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;oBAC3B,wDAAwD;oBACxD,OAAO,CAAC,KAAK,CAAC,8CAA8C,aAAa,CAAC,KAAK,EAAE,CAAC,CAAC;gBACrF,CAAC;YACH,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,QAAQ,EAAE,IAAI;gBACd,aAAa;gBACb,eAAe;aAChB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,8BAA8B,OAAO,EAAE;aAC/C,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,eAAe,CAAC,IAAY;QAChC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QAExD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC;YACH,kBAAkB;YAClB,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,SAAS,CAAC,2BAA2B,EAAE;gBAC5E,GAAG,EAAE,YAAY;aAClB,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC;YAEnC,kCAAkC;YAClC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,SAAS,CAAC,4BAA4B,EAAE;gBAC7E,GAAG,EAAE,YAAY;aAClB,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC;YAEnC,uCAAuC;YACvC,IAAI,KAAK,GAAG,KAAK,CAAC;YAClB,IAAI,CAAC;gBACH,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,MAAM,SAAS,CAAC,wBAAwB,EAAE;oBACzE,GAAG,EAAE,YAAY;iBAClB,CAAC,CAAC;gBACH,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC;YACzC,CAAC;YAAC,MAAM,CAAC;gBACP,KAAK,GAAG,KAAK,CAAC;YAChB,CAAC;YAED,4CAA4C;YAC5C,IAAI,KAAK,GAAG,CAAC,CAAC;YACd,IAAI,MAAM,GAAG,CAAC,CAAC;YACf,IAAI,CAAC;gBACH,6CAA6C;gBAC7C,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC;gBACrD,MAAM,EAAE,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,SAAS,CACnD,qCAAqC,UAAU,SAAS,EACxD,EAAE,GAAG,EAAE,YAAY,EAAE,CACtB,CAAC;gBACF,MAAM,CAAC,SAAS,EAAE,QAAQ,CAAC,GAAG,iBAAiB,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACnE,MAAM,GAAG,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;gBACtC,KAAK,GAAG,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;YACtC,CAAC;YAAC,MAAM,CAAC;gBACP,oDAAoD;YACtD,CAAC;YAED,wCAAwC;YACxC,IAAI,SAA2B,CAAC;YAChC,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;gBACxC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAC;YAC9B,CAAC;YAAC,MAAM,CAAC;gBACP,SAAS;YACX,CAAC;YAED,OAAO;gBACL,IAAI;gBACJ,IAAI,EAAE,YAAY;gBAClB,MAAM;gBACN,MAAM;gBACN,KAAK,EAAE,IAAI;gBACX,KAAK;gBACL,KAAK;gBACL,MAAM;gBACN,SAAS;aACV,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,oEAAoE;YACpE,OAAO;gBACL,IAAI;gBACJ,IAAI,EAAE,YAAY;gBAClB,MAAM,EAAE,EAAE;gBACV,MAAM,EAAE,EAAE;gBACV,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,KAAK;gBACZ,KAAK,EAAE,CAAC;gBACR,MAAM,EAAE,CAAC;aACV,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa;QACjB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;YACtC,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QACrC,CAAC;QAED,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3E,MAAM,SAAS,GAAmB,EAAE,CAAC;QAErC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;gBACxB,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACpD,IAAI,IAAI,EAAE,CAAC;oBACT,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC;QACH,CAAC;QAED,uCAAuC;QACvC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACtB,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;gBAC/B,OAAO,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;YACvD,CAAC;YACD,OAAO,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QACtC,CAAC,CAAC,CAAC;QAEH,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc,CAAC,OAA8B;QACjD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QAEhE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;YACjC,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,aAAa,OAAO,CAAC,IAAI,kBAAkB;aACnD,CAAC;QACJ,CAAC;QAED,kDAAkD;QAClD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACtD,MAAM,UAAU,GAAG,IAAI,EAAE,MAAM,CAAC;QAEhC,yCAAyC;QACzC,IAAI,IAAI,EAAE,KAAK,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAClC,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,UAAU;gBAClB,KAAK,EAAE,aAAa,OAAO,CAAC,IAAI,6DAA6D;aAC9F,CAAC;QACJ,CAAC;QAED,IAAI,CAAC;YACH,sBAAsB;YACtB,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;YACjD,MAAM,SAAS,CAAC,uBAAuB,SAAS,KAAK,YAAY,GAAG,EAAE;gBACpE,GAAG,EAAE,IAAI,CAAC,WAAW;aACtB,CAAC,CAAC;YAEH,+BAA+B;YAC/B,IAAI,aAAa,GAAG,KAAK,CAAC;YAC1B,IAAI,OAAO,CAAC,YAAY,IAAI,UAAU,EAAE,CAAC;gBACvC,IAAI,CAAC;oBACH,MAAM,SAAS,CAAC,iBAAiB,UAAU,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;oBAC1E,aAAa,GAAG,IAAI,CAAC;gBACvB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,wCAAwC;oBACxC,OAAO,CAAC,KAAK,CAAC,sCAAsC,UAAU,GAAG,EAAE,KAAK,CAAC,CAAC;gBAC5E,CAAC;YACH,CAAC;YAED,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,UAAU;gBAClB,aAAa;aACd,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACvE,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,MAAM,EAAE,UAAU;gBAClB,KAAK,EAAE,8BAA8B,OAAO,EAAE;aAC/C,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc;QAClB,MAAM,SAAS,CAAC,oBAAoB,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IACnE,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAkB;IACnD,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,KAAK,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACxC,KAAK,CAAC,IAAI,CAAC,aAAa,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IACrC,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACzC,KAAK,CAAC,IAAI,CAAC,eAAe,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;IAEvF,IAAI,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CAAC,sBAAsB,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IACjE,CAAC;IAED,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACnB,KAAK,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC7D,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAA2B;IAC5D,IAAI,MAAM,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,2BAA2B,CAAC;IACrC,CAAC;IAED,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,KAAK,iBAAiB,CAAC,CAAC;IAEnD,KAAK,MAAM,EAAE,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC;QAC3E,MAAM,WAAW,GAAG,EAAE,CAAC,KAAK,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QACzF,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC,CAAC;QAC3E,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;IACnC,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lance-context",
-  "version": "0.1.0",
+  "version": "1.0.1",
   "description": "MCP plugin for semantic code search using LanceDB - gives AI coding agents deep context from your entire codebase",
   "main": "dist/index.js",
   "type": "module",
@@ -11,11 +11,22 @@
     "build": "tsc",
     "start": "node dist/index.js",
     "dev": "tsx src/index.ts",
-    "test": "echo \"Error: no test specified\" && exit 1",
-    "prepublishOnly": "npm run build"
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src",
+    "lint:fix": "eslint src --fix",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\"",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist coverage .lance-context",
+    "prepublishOnly": "npm run build",
+    "prepare": "husky",
+    "postinstall": "node scripts/postinstall.js || true"
   },
   "files": [
     "dist",
+    "scripts",
     "README.md"
   ],
   "repository": {
@@ -40,14 +51,37 @@
   "dependencies": {
     "@lancedb/lancedb": "^0.22.3",
     "@modelcontextprotocol/sdk": "^1.0.0",
-    "glob": "^13.0.0"
+    "@vscode/tree-sitter-wasm": "^0.3.0",
+    "glob": "^13.0.0",
+    "minimatch": "^10.1.1",
+    "web-tree-sitter": "^0.26.3",
+    "zod": "^4.3.6"
   },
   "devDependencies": {
+    "@commitlint/cli": "^20.3.1",
+    "@commitlint/config-conventional": "^20.3.1",
+    "@eslint/js": "^9.39.2",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
     "@types/node": "^22.0.0",
+    "@vitest/coverage-v8": "^4.0.16",
+    "eslint": "^9.39.2",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.7",
+    "prettier": "^3.8.1",
+    "semantic-release": "^25.0.2",
     "tsx": "^4.0.0",
-    "typescript": "^5.7.0"
+    "typescript": "^5.7.0",
+    "typescript-eslint": "^8.53.1",
+    "vitest": "^4.0.16"
   },
   "engines": {
     "node": ">=20.0.0"
+  },
+  "lint-staged": {
+    "src/**/*.ts": [
+      "eslint --fix",
+      "prettier --write"
+    ]
   }
 }

package/scripts/postinstall.js

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+
+/**
+ * Postinstall script to register lance-context with Claude Code MCP configuration.
+ * This runs after npm install and adds lance-context as a global MCP server.
+ */
+
+import { execSync } from 'child_process';
+
+function main() {
+  // Check if claude CLI is available
+  try {
+    execSync('claude --version', { stdio: 'ignore' });
+  } catch {
+    console.log('[lance-context] Claude Code CLI not found, skipping MCP registration.');
+    console.log('[lance-context] To manually register, run:');
+    console.log('  claude mcp add --scope user --transport stdio lance-context -- npx -y lance-context');
+    return;
+  }
+
+  // Check if lance-context is already registered
+  try {
+    const result = execSync('claude mcp get lance-context 2>/dev/null', { encoding: 'utf-8' });
+    if (result.includes('lance-context')) {
+      console.log('[lance-context] Already registered with Claude Code.');
+      return;
+    }
+  } catch {
+    // Not registered, continue with registration
+  }
+
+  // Register lance-context with Claude Code
+  try {
+    console.log('[lance-context] Registering with Claude Code...');
+    execSync(
+      'claude mcp add --scope user --transport stdio lance-context -- npx -y lance-context',
+      { stdio: 'inherit' }
+    );
+    console.log('[lance-context] Successfully registered with Claude Code!');
+    console.log('[lance-context] Restart Claude Code to use semantic code search.');
+  } catch (error) {
+    console.log('[lance-context] Failed to register with Claude Code:', error.message);
+    console.log('[lance-context] To manually register, run:');
+    console.log('  claude mcp add --scope user --transport stdio lance-context -- npx -y lance-context');
+  }
+}
+
+main();