@jacques-ai/server 0.0.7-alpha.1

package/dist/connection/worktree.js

@@ -0,0 +1,320 @@
+/**
+ * Worktree Management
+ *
+ * Creates, lists, inspects, and removes git worktrees for the project.
+ * Extends git-info.ts (read-only detection) with write operations.
+ *
+ * @module connection/worktree
+ */
+import { exec as execCb } from 'child_process';
+import { promisify } from 'util';
+import { existsSync } from 'fs';
+import * as path from 'path';
+import { platform } from 'process';
+const execAsync = promisify(execCb);
+/**
+ * Cross-platform shell quoting for command arguments.
+ * Windows cmd.exe uses double quotes; Unix shells use single quotes.
+ */
+function q(s) {
+    if (platform === 'win32') {
+        return `"${s.replace(/"/g, '\\"')}"`;
+    }
+    return `'${s.replace(/'/g, "'\\''")}'`;
+}
+// ─── Validation ───────────────────────────────────────────────
+const VALID_NAME_RE = /^[a-zA-Z0-9_-]+$/;
+export function validateWorktreeName(name) {
+    if (!name)
+        return 'Name is required';
+    if (!VALID_NAME_RE.test(name))
+        return 'Name must contain only letters, numbers, hyphens, and underscores';
+    if (name.length > 100)
+        return 'Name must be 100 characters or fewer';
+    return null;
+}
+/**
+ * Compute the worktree path: sibling to repo root with name suffix.
+ * e.g. /path/to/project → /path/to/project-<name>
+ */
+export function computeWorktreePath(repoRoot, name) {
+    const parent = path.dirname(repoRoot);
+    const base = path.basename(repoRoot);
+    return path.join(parent, `${base}-${name}`);
+}
+// ─── Create Worktree ──────────────────────────────────────────
+/**
+ * Create a new git worktree as a sibling directory.
+ *
+ * Runs `git worktree add -b <name> <path>` which creates both
+ * the worktree directory and a new branch.
+ */
+export async function createWorktree(options) {
+    const { repoRoot, name, baseBranch } = options;
+    // Validate name
+    const nameError = validateWorktreeName(name);
+    if (nameError) {
+        return { success: false, error: nameError };
+    }
+    // Validate repo root exists
+    if (!existsSync(repoRoot)) {
+        return { success: false, error: `Repository root does not exist: ${repoRoot}` };
+    }
+    // Compute target path
+    const worktreePath = computeWorktreePath(repoRoot, name);
+    // Check directory doesn't already exist
+    if (existsSync(worktreePath)) {
+        return { success: false, error: `Directory already exists: ${worktreePath}` };
+    }
+    // Build git command
+    const baseArg = baseBranch ? ` ${q(baseBranch)}` : '';
+    const cmd = `git -C ${q(repoRoot)} worktree add -b ${q(name)} ${q(worktreePath)}${baseArg}`;
+    try {
+        await execAsync(cmd, { timeout: 15000 });
+        return {
+            success: true,
+            worktreePath,
+            branch: name,
+        };
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.stderr || err.message : String(err);
+        // Detect common git errors
+        if (message.includes('already exists')) {
+            if (message.includes('branch')) {
+                return { success: false, error: `Branch '${name}' already exists` };
+            }
+            return { success: false, error: `Worktree or directory already exists for '${name}'` };
+        }
+        return { success: false, error: `Git worktree add failed: ${message.trim()}` };
+    }
+}
+// ─── List Worktrees ───────────────────────────────────────────
+/**
+ * List all worktrees for a repository.
+ * Prunes stale entries first, then wraps `git worktree list --porcelain`.
+ */
+export async function listWorktrees(repoRoot) {
+    try {
+        // Prune stale worktree entries (directories already removed)
+        try {
+            await execAsync(`git -C ${q(repoRoot)} worktree prune`, { timeout: 5000 });
+        }
+        catch {
+            // Prune failure is non-fatal
+        }
+        const { stdout } = await execAsync(`git -C ${q(repoRoot)} worktree list --porcelain`, { timeout: 5000 });
+        return parsePorcelainOutput(stdout, repoRoot);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Parse `git worktree list --porcelain` output into structured entries.
+ *
+ * Format:
+ *   worktree /path/to/main
+ *   HEAD abc123
+ *   branch refs/heads/main
+ *   (blank line)
+ *   worktree /path/to/other
+ *   HEAD def456
+ *   branch refs/heads/feature
+ *   (blank line)
+ */
+export function parsePorcelainOutput(output, repoRoot) {
+    const entries = [];
+    // Normalize \r\n to \n for cross-platform compatibility
+    const normalized = output.replace(/\r\n/g, '\n');
+    const blocks = normalized.trim().split('\n\n');
+    for (const block of blocks) {
+        if (!block.trim())
+            continue;
+        const lines = block.trim().split('\n');
+        let worktreePath = '';
+        let branch = null;
+        for (const line of lines) {
+            const trimmedLine = line.trim();
+            if (trimmedLine.startsWith('worktree ')) {
+                worktreePath = trimmedLine.slice('worktree '.length);
+            }
+            else if (trimmedLine.startsWith('branch ')) {
+                // refs/heads/main → main
+                branch = trimmedLine.slice('branch '.length).replace(/^refs\/heads\//, '');
+            }
+        }
+        if (worktreePath) {
+            const resolvedRoot = path.resolve(repoRoot);
+            const resolvedWorktree = path.resolve(worktreePath);
+            entries.push({
+                name: path.basename(worktreePath),
+                path: worktreePath,
+                branch,
+                isMain: resolvedWorktree === resolvedRoot,
+            });
+        }
+    }
+    return entries;
+}
+// ─── Worktree Status ─────────────────────────────────────────
+/**
+ * Detect the default branch for a repository (main or master).
+ * Tries `git symbolic-ref refs/remotes/origin/HEAD`, falls back to checking
+ * if 'main' or 'master' branch exists locally.
+ */
+export async function detectDefaultBranch(repoRoot) {
+    // Try symbolic-ref first (requires remote tracking)
+    try {
+        const { stdout } = await execAsync(`git -C ${q(repoRoot)} symbolic-ref refs/remotes/origin/HEAD`, { timeout: 5000 });
+        const ref = stdout.trim().replace(/^refs\/remotes\/origin\//, '');
+        if (ref)
+            return ref;
+    }
+    catch {
+        // No remote HEAD configured
+    }
+    // Fall back: check if 'main' branch exists
+    try {
+        await execAsync(`git -C ${q(repoRoot)} rev-parse --verify refs/heads/main`, { timeout: 5000 });
+        return 'main';
+    }
+    catch {
+        // 'main' doesn't exist
+    }
+    // Final fallback: assume 'master'
+    return 'master';
+}
+/**
+ * Check status of a single worktree: uncommitted changes and merge status.
+ */
+export async function checkWorktreeStatus(worktreePath, branch, defaultBranch, repoRoot) {
+    // Check for uncommitted changes
+    let hasUncommittedChanges = false;
+    try {
+        const { stdout } = await execAsync(`git -C ${q(worktreePath)} status --porcelain`, { timeout: 5000 });
+        hasUncommittedChanges = stdout.trim().length > 0;
+    }
+    catch {
+        // If status fails, assume clean
+    }
+    // Check if branch is merged into default branch.
+    // Three cases:
+    // 1. Branch is NOT an ancestor of default → has unmerged work → not merged
+    // 2. Branch IS an ancestor AND its tip is on default's first-parent line
+    //    → branch just points at an old mainline commit (no unique work) → not merged
+    // 3. Branch IS an ancestor AND its tip is NOT on default's first-parent line
+    //    → branch was merged via merge commit → merged
+    let isMergedToMain = false;
+    if (branch && branch !== defaultBranch) {
+        try {
+            // Step 1: is the branch an ancestor of the default branch?
+            await execAsync(`git -C ${q(repoRoot)} merge-base --is-ancestor ${q(branch)} ${q(defaultBranch)}`, { timeout: 5000 });
+            // Branch IS an ancestor — check if it was merged or is just at an old commit
+            const { stdout: tipOut } = await execAsync(`git -C ${q(repoRoot)} rev-parse ${q(branch)}`, { timeout: 5000 });
+            const branchTip = tipOut.trim();
+            // Step 2: check if branch tip is on default branch's first-parent line
+            let isOnFirstParentLine = false;
+            try {
+                const { stdout: fpCommits } = await execAsync(`git -C ${q(repoRoot)} rev-list --first-parent ${q(branchTip + '^..' + defaultBranch)}`, { timeout: 10000 });
+                isOnFirstParentLine = fpCommits.split('\n').some(h => h.trim() === branchTip);
+            }
+            catch {
+                // rev-list failed (e.g., root commit has no parent)
+                isOnFirstParentLine = false;
+            }
+            // On first-parent line → just at old mainline commit, not "merged"
+            // NOT on first-parent line → was merged via merge commit
+            isMergedToMain = !isOnFirstParentLine;
+        }
+        catch {
+            // is-ancestor failed → not merged
+            isMergedToMain = false;
+        }
+    }
+    return { hasUncommittedChanges, isMergedToMain };
+}
+/**
+ * List all worktrees with their status (uncommitted changes, merge status).
+ * Returns all worktrees including main.
+ */
+export async function listWorktreesWithStatus(repoRoot) {
+    const entries = await listWorktrees(repoRoot);
+    if (entries.length === 0)
+        return [];
+    const defaultBranch = await detectDefaultBranch(repoRoot);
+    const results = [];
+    for (const entry of entries) {
+        if (entry.isMain) {
+            // Main worktree: skip status check, always safe
+            results.push({
+                ...entry,
+                status: { hasUncommittedChanges: false, isMergedToMain: true },
+            });
+            continue;
+        }
+        const status = await checkWorktreeStatus(entry.path, entry.branch, defaultBranch, repoRoot);
+        results.push({ ...entry, status });
+    }
+    return results;
+}
+// ─── Remove Worktree ─────────────────────────────────────────
+/**
+ * Remove a git worktree and optionally delete its branch.
+ *
+ * Runs `git worktree remove <path>` with optional --force flag.
+ * If deleteBranch is true, also runs `git branch -d <branch>`.
+ */
+export async function removeWorktree(options) {
+    const { repoRoot, worktreePath, force, deleteBranch } = options;
+    // Validate repo root exists
+    if (!existsSync(repoRoot)) {
+        return { success: false, error: `Repository root does not exist: ${repoRoot}` };
+    }
+    // Validate worktree path exists
+    if (!existsSync(worktreePath)) {
+        return { success: false, error: `Worktree does not exist: ${worktreePath}` };
+    }
+    // Don't allow removing the main worktree
+    if (path.resolve(worktreePath) === path.resolve(repoRoot)) {
+        return { success: false, error: 'Cannot remove the main worktree' };
+    }
+    // Detect branch name before removal (needed for branch deletion)
+    let branchName = null;
+    if (deleteBranch) {
+        try {
+            const { stdout } = await execAsync(`git -C ${q(worktreePath)} rev-parse --abbrev-ref HEAD`, { timeout: 5000 });
+            branchName = stdout.trim() || null;
+        }
+        catch {
+            // Can't detect branch, skip branch deletion
+        }
+    }
+    // Remove the worktree
+    const forceFlag = force ? ' --force' : '';
+    const cmd = `git -C ${q(repoRoot)} worktree remove ${q(worktreePath)}${forceFlag}`;
+    try {
+        await execAsync(cmd, { timeout: 15000 });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.stderr || err.message : String(err);
+        if (message.includes('untracked') || message.includes('modified')) {
+            return { success: false, error: `Worktree has uncommitted changes. Use force to remove anyway.` };
+        }
+        return { success: false, error: `Git worktree remove failed: ${message.trim()}` };
+    }
+    // Optionally delete the branch
+    let branchDeleted = false;
+    if (deleteBranch && branchName) {
+        const branchFlag = force ? '-D' : '-d';
+        try {
+            await execAsync(`git -C ${q(repoRoot)} branch ${branchFlag} ${q(branchName)}`, { timeout: 5000 });
+            branchDeleted = true;
+        }
+        catch {
+            // Branch deletion failed (e.g., not fully merged with -d), but worktree removal succeeded
+        }
+    }
+    return { success: true, branchDeleted };
+}
+//# sourceMappingURL=worktree.js.map

package/dist/connection/worktree.js.map

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

package/dist/connection/worktree.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Tests for worktree module
+ */
+export {};
+//# sourceMappingURL=worktree.test.d.ts.map

package/dist/connection/worktree.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.test.d.ts","sourceRoot":"","sources":["../../src/connection/worktree.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/connection/worktree.test.js

@@ -0,0 +1,113 @@
+/**
+ * Tests for worktree module
+ */
+import { validateWorktreeName, computeWorktreePath, parsePorcelainOutput, } from './worktree.js';
+describe('validateWorktreeName', () => {
+    it('accepts valid names', () => {
+        expect(validateWorktreeName('feature')).toBeNull();
+        expect(validateWorktreeName('my-branch')).toBeNull();
+        expect(validateWorktreeName('fix_123')).toBeNull();
+        expect(validateWorktreeName('ABC-xyz-123')).toBeNull();
+    });
+    it('rejects empty names', () => {
+        expect(validateWorktreeName('')).toBe('Name is required');
+    });
+    it('rejects names with spaces', () => {
+        expect(validateWorktreeName('my branch')).toMatch(/letters, numbers/);
+    });
+    it('rejects names with special characters', () => {
+        expect(validateWorktreeName('feat/branch')).toMatch(/letters, numbers/);
+        expect(validateWorktreeName('feat.branch')).toMatch(/letters, numbers/);
+        expect(validateWorktreeName('feat@branch')).toMatch(/letters, numbers/);
+        expect(validateWorktreeName('feat!branch')).toMatch(/letters, numbers/);
+    });
+    it('rejects names over 100 characters', () => {
+        const longName = 'a'.repeat(101);
+        expect(validateWorktreeName(longName)).toMatch(/100 characters/);
+    });
+    it('accepts names of exactly 100 characters', () => {
+        const name = 'a'.repeat(100);
+        expect(validateWorktreeName(name)).toBeNull();
+    });
+});
+describe('computeWorktreePath', () => {
+    it('creates sibling directory with name suffix', () => {
+        expect(computeWorktreePath('/Users/dev/my-project', 'feature'))
+            .toBe('/Users/dev/my-project-feature');
+    });
+    it('handles repo roots with trailing slash-like naming', () => {
+        expect(computeWorktreePath('/home/user/app', 'hotfix'))
+            .toBe('/home/user/app-hotfix');
+    });
+    it('handles deeply nested repo roots', () => {
+        expect(computeWorktreePath('/a/b/c/d/repo', 'test'))
+            .toBe('/a/b/c/d/repo-test');
+    });
+});
+describe('parsePorcelainOutput', () => {
+    it('parses single worktree (main only)', () => {
+        const output = `worktree /Users/dev/project
+HEAD abc123def456
+branch refs/heads/main
+
+`;
+        const entries = parsePorcelainOutput(output, '/Users/dev/project');
+        expect(entries).toHaveLength(1);
+        expect(entries[0]).toEqual({
+            name: 'project',
+            path: '/Users/dev/project',
+            branch: 'main',
+            isMain: true,
+        });
+    });
+    it('parses multiple worktrees', () => {
+        const output = `worktree /Users/dev/project
+HEAD abc123
+branch refs/heads/main
+
+worktree /Users/dev/project-feature
+HEAD def456
+branch refs/heads/feature
+
+worktree /Users/dev/project-hotfix
+HEAD 789012
+branch refs/heads/hotfix
+
+`;
+        const entries = parsePorcelainOutput(output, '/Users/dev/project');
+        expect(entries).toHaveLength(3);
+        expect(entries[0].isMain).toBe(true);
+        expect(entries[0].branch).toBe('main');
+        expect(entries[1].isMain).toBe(false);
+        expect(entries[1].name).toBe('project-feature');
+        expect(entries[1].branch).toBe('feature');
+        expect(entries[2].isMain).toBe(false);
+        expect(entries[2].name).toBe('project-hotfix');
+        expect(entries[2].branch).toBe('hotfix');
+    });
+    it('handles detached HEAD (no branch line)', () => {
+        const output = `worktree /Users/dev/project
+HEAD abc123
+detached
+
+`;
+        const entries = parsePorcelainOutput(output, '/Users/dev/project');
+        expect(entries).toHaveLength(1);
+        expect(entries[0].branch).toBeNull();
+        expect(entries[0].isMain).toBe(true);
+    });
+    it('handles empty output', () => {
+        expect(parsePorcelainOutput('', '/some/path')).toEqual([]);
+        expect(parsePorcelainOutput('  \n  ', '/some/path')).toEqual([]);
+    });
+    it('strips refs/heads/ prefix from branch', () => {
+        const output = `worktree /Users/dev/project
+HEAD abc123
+branch refs/heads/feature/nested-branch
+
+`;
+        const entries = parsePorcelainOutput(output, '/Users/dev/project');
+        expect(entries[0].branch).toBe('feature/nested-branch');
+    });
+});
+//# sourceMappingURL=worktree.test.js.map

package/dist/connection/worktree.test.js.map

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

package/dist/focus-watcher.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Terminal Focus Watcher
+ *
+ * Monitors which terminal window is focused on macOS and sends
+ * focus hints to the Jacques server to update the active session.
+ *
+ * Supports:
+ * - iTerm2 (via ITERM_SESSION_ID)
+ * - Terminal.app (via TTY)
+ * - Other terminals (via window ID / PID)
+ */
+import type { Logger } from './logging/logger-factory.js';
+export interface FocusInfo {
+    app: string;
+    iterm_session_id?: string;
+    tty?: string;
+    window_id?: string;
+    terminal_pid?: number;
+}
+/**
+ * Get focus info for the currently active terminal
+ */
+export declare function getTerminalFocusInfo(): Promise<FocusInfo | null>;
+/**
+ * Build terminal key candidates from focus info, ordered by specificity.
+ * Returns multiple keys to try (e.g., ITERM key first, then TTY fallback)
+ * because discovered sessions may use TTY keys even when running in iTerm.
+ */
+export declare function buildTerminalKeysFromFocus(focus: FocusInfo): string[];
+/**
+ * Build a single terminal key from focus info (primary key for change detection)
+ */
+export declare function buildTerminalKeyFromFocus(focus: FocusInfo): string | null;
+export interface FocusWatcherCallbacks {
+    onFocusChange: (terminalKey: string | null, allKeys?: string[]) => void;
+    /** Return true if the watcher should retry matching even when the terminal key hasn't changed */
+    shouldRetry?: () => boolean;
+}
+export interface FocusWatcherOptions {
+    /** Suppress console output */
+    silent?: boolean;
+    /** Optional logger for dependency injection */
+    logger?: Logger;
+}
+/**
+ * Start watching for terminal focus changes
+ */
+export declare function startFocusWatcher(callbacks: FocusWatcherCallbacks, pollIntervalMs?: number, options?: FocusWatcherOptions): {
+    stop: () => void;
+};
+//# sourceMappingURL=focus-watcher.d.ts.map

package/dist/focus-watcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus-watcher.d.ts","sourceRoot":"","sources":["../src/focus-watcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;AAK1D,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AA2DD;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAuBtE;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,EAAE,CAYrE;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAGzE;AAED,MAAM,WAAW,qBAAqB;IACpC,aAAa,EAAE,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IACxE,iGAAiG;IACjG,WAAW,CAAC,EAAE,MAAM,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,mBAAmB;IAClC,8BAA8B;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,+CAA+C;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,qBAAqB,EAChC,cAAc,GAAE,MAA8B,EAC9C,OAAO,GAAE,mBAAwB,GAChC;IAAE,IAAI,EAAE,MAAM,IAAI,CAAA;CAAE,CA0DtB"}