@camaradesuk/git-worktree-tools 1.12.0 → 1.14.0

package/dist/lib/worktree-setup.js

@@ -0,0 +1,114 @@
+/**
+ * Worktree parent directory auto-setup
+ *
+ * When worktreeParent resolves to a path inside the repo, automatically:
+ * 1. Create the directory (with confirmation in interactive mode)
+ * 2. Add it to .gitignore
+ */
+import fs from 'fs';
+import path from 'path';
+import { logger } from './logger.js';
+import { promptConfirm } from './prompts.js';
+/**
+ * Check if a path is inside the repo root
+ */
+function isInsideRepo(dirPath, repoRoot) {
+    let resolved = path.resolve(dirPath);
+    let resolvedRoot = path.resolve(repoRoot);
+    if (process.platform === 'win32') {
+        resolved = resolved.toLowerCase();
+        resolvedRoot = resolvedRoot.toLowerCase();
+    }
+    return resolved.startsWith(resolvedRoot + path.sep) || resolved === resolvedRoot;
+}
+/**
+ * Get the relative path from repo root for gitignore entry.
+ * Always uses forward slashes regardless of platform (.gitignore standard).
+ */
+function getGitignoreEntry(dirPath, repoRoot) {
+    return path.relative(repoRoot, dirPath).replace(/\\/g, '/');
+}
+/**
+ * Check if a gitignore entry already exists
+ */
+function gitignoreContains(gitignorePath, entry) {
+    if (!fs.existsSync(gitignorePath)) {
+        return false;
+    }
+    const content = fs.readFileSync(gitignorePath, 'utf8');
+    const regex = new RegExp(`^\\/?${entry.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}\\s*$`, 'm');
+    return regex.test(content);
+}
+/**
+ * Add an entry to .gitignore
+ */
+function addToGitignore(gitignorePath, entry) {
+    let content = '';
+    if (fs.existsSync(gitignorePath)) {
+        content = fs.readFileSync(gitignorePath, 'utf8');
+    }
+    const addition = `# git-worktree-tools worktree directory\n${entry}\n`;
+    const trimmed = content.trimEnd();
+    content = trimmed ? trimmed + '\n\n' + addition : addition;
+    fs.writeFileSync(gitignorePath, content, 'utf8');
+}
+/**
+ * Ensure the worktree parent directory exists and is gitignored (if inside repo).
+ *
+ * Only acts when the resolved parent dir is inside the repo root.
+ * In interactive mode, prompts for confirmation before making changes.
+ * In non-interactive mode, proceeds automatically.
+ */
+export async function ensureWorktreeParentDir(options) {
+    const { resolvedParentDir, repoRoot, interactive } = options;
+    const result = {
+        created: false,
+        gitignoreUpdated: false,
+        declined: false,
+    };
+    // Only act for in-repo directories
+    if (!isInsideRepo(resolvedParentDir, repoRoot)) {
+        return result;
+    }
+    const dirExists = fs.existsSync(resolvedParentDir);
+    const gitignorePath = path.join(repoRoot, '.gitignore');
+    const gitignoreEntry = getGitignoreEntry(resolvedParentDir, repoRoot);
+    // If parent dir IS the repo root, relative path is empty — nothing to gitignore
+    if (!gitignoreEntry) {
+        return result;
+    }
+    const alreadyIgnored = gitignoreContains(gitignorePath, gitignoreEntry);
+    // Nothing to do
+    if (dirExists && alreadyIgnored) {
+        return result;
+    }
+    // Prompt in interactive mode
+    if (interactive && (!dirExists || !alreadyIgnored)) {
+        const actions = [];
+        if (!dirExists) {
+            actions.push(`create \`${gitignoreEntry}/\``);
+        }
+        if (!alreadyIgnored) {
+            actions.push(`add \`${gitignoreEntry}\` to .gitignore`);
+        }
+        const confirmed = await promptConfirm(`Will ${actions.join(' and ')}. Continue?`, true);
+        if (!confirmed) {
+            result.declined = true;
+            return result;
+        }
+    }
+    // Create directory
+    if (!dirExists) {
+        fs.mkdirSync(resolvedParentDir, { recursive: true });
+        result.created = true;
+        logger.info(`Created worktree directory: ${gitignoreEntry}/`);
+    }
+    // Update .gitignore
+    if (!alreadyIgnored) {
+        addToGitignore(gitignorePath, gitignoreEntry);
+        result.gitignoreUpdated = true;
+        logger.info(`Added ${gitignoreEntry} to .gitignore`);
+    }
+    return result;
+}
+//# sourceMappingURL=worktree-setup.js.map

package/dist/lib/worktree-setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-setup.js","sourceRoot":"","sources":["../../src/lib/worktree-setup.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAoB7C;;GAEG;AACH,SAAS,YAAY,CAAC,OAAe,EAAE,QAAgB;IACrD,IAAI,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,IAAI,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1C,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,QAAQ,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;QAClC,YAAY,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC;IAC5C,CAAC;IACD,OAAO,QAAQ,CAAC,UAAU,CAAC,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,QAAQ,KAAK,YAAY,CAAC;AACnF,CAAC;AAED;;;GAGG;AACH,SAAS,iBAAiB,CAAC,OAAe,EAAE,QAAgB;IAC1D,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AAC9D,CAAC;AAED;;GAEG;AACH,SAAS,iBAAiB,CAAC,aAAqB,EAAE,KAAa;IAC7D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QAClC,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IACvD,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAC3F,OAAO,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC7B,CAAC;AAED;;GAEG;AACH,SAAS,cAAc,CAAC,aAAqB,EAAE,KAAa;IAC1D,IAAI,OAAO,GAAG,EAAE,CAAC;IACjB,IAAI,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QACjC,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IACnD,CAAC;IAED,MAAM,QAAQ,GAAG,4CAA4C,KAAK,IAAI,CAAC;IACvE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAClC,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,OAAO,GAAG,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC3D,EAAE,CAAC,aAAa,CAAC,aAAa,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;AACnD,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,OAAoC;IAEpC,MAAM,EAAE,iBAAiB,EAAE,QAAQ,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC;IAE7D,MAAM,MAAM,GAA+B;QACzC,OAAO,EAAE,KAAK;QACd,gBAAgB,EAAE,KAAK;QACvB,QAAQ,EAAE,KAAK;KAChB,CAAC;IAEF,mCAAmC;IACnC,IAAI,CAAC,YAAY,CAAC,iBAAiB,EAAE,QAAQ,CAAC,EAAE,CAAC;QAC/C,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,SAAS,GAAG,EAAE,CAAC,UAAU,CAAC,iBAAiB,CAAC,CAAC;IACnD,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;IACxD,MAAM,cAAc,GAAG,iBAAiB,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;IAEtE,gFAAgF;IAChF,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,cAAc,GAAG,iBAAiB,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;IAExE,gBAAgB;IAChB,IAAI,SAAS,IAAI,cAAc,EAAE,CAAC;QAChC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,6BAA6B;IAC7B,IAAI,WAAW,IAAI,CAAC,CAAC,SAAS,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;QACnD,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,OAAO,CAAC,IAAI,CAAC,YAAY,cAAc,KAAK,CAAC,CAAC;QAChD,CAAC;QACD,IAAI,CAAC,cAAc,EAAE,CAAC;YACpB,OAAO,CAAC,IAAI,CAAC,SAAS,cAAc,kBAAkB,CAAC,CAAC;QAC1D,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,aAAa,CAAC,QAAQ,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;QAExF,IAAI,CAAC,SAAS,EAAE,CAAC;YACf,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC;YACvB,OAAO,MAAM,CAAC;QAChB,CAAC;IACH,CAAC;IAED,mBAAmB;IACnB,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,EAAE,CAAC,SAAS,CAAC,iBAAiB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QACrD,MAAM,CAAC,OAAO,GAAG,IAAI,CAAC;QACtB,MAAM,CAAC,IAAI,CAAC,+BAA+B,cAAc,GAAG,CAAC,CAAC;IAChE,CAAC;IAED,oBAAoB;IACpB,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,cAAc,CAAC,aAAa,EAAE,cAAc,CAAC,CAAC;QAC9C,MAAM,CAAC,gBAAgB,GAAG,IAAI,CAAC;QAC/B,MAAM,CAAC,IAAI,CAAC,SAAS,cAAc,gBAAgB,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/lib/worktree-utils.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Shared worktree utilities used by lswt, cleanpr, and other tools
+ */
+/**
+ * Options for PR number extraction
+ */
+export interface ExtractPrNumberOptions {
+    /** Configured worktree naming pattern */
+    worktreePattern?: string;
+}
+/**
+ * Extract PR number from a worktree path using config-aware pattern matching.
+ *
+ * Resolution chain:
+ * 1. Configured pattern (if provided)
+ * 2. Default pattern ({repo}.pr{number})
+ *
+ * For async extraction with gh CLI fallback, use extractPrNumberAsync.
+ */
+export declare function extractPrNumber(worktreePath: string, options?: ExtractPrNumberOptions): number | null;
+/**
+ * Extract PR number with gh CLI fallback.
+ *
+ * Resolution chain:
+ * 1. Configured pattern
+ * 2. Default pattern
+ * 3. gh CLI: look up branch from git worktree list, query gh pr list --head <branch>
+ */
+export declare function extractPrNumberAsync(worktreePath: string, options?: ExtractPrNumberOptions & {
+    cwd?: string;
+}): Promise<number | null>;
+//# sourceMappingURL=worktree-utils.d.ts.map

package/dist/lib/worktree-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree-utils.d.ts","sourceRoot":"","sources":["../../src/lib/worktree-utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAQH;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,yCAAyC;IACzC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AA8BD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,sBAA2B,GACnC,MAAM,GAAG,IAAI,CA8Bf;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CACxC,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,sBAAsB,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAO,GACtD,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA4BxB"}

package/dist/lib/worktree-utils.js

@@ -0,0 +1,101 @@
+/**
+ * Shared worktree utilities used by lswt, cleanpr, and other tools
+ */
+import * as path from 'path';
+import { DEFAULT_WORKTREE_PATTERN } from './constants.js';
+import * as github from './github.js';
+import * as git from './git.js';
+import { logger } from './logger.js';
+/**
+ * Convert a worktree naming pattern to a regex for PR number extraction.
+ * Replaces {number} with a capture group and other placeholders with .*
+ */
+function patternToRegex(pattern) {
+    if (!pattern.includes('{number}')) {
+        return null;
+    }
+    // Escape regex special characters first, then replace placeholders
+    let regexStr = pattern.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    // Now replace escaped placeholder sequences
+    regexStr = regexStr.replace('\\{repo\\}', '.*?');
+    regexStr = regexStr.replace('\\{number\\}', '(\\d+)');
+    regexStr = regexStr.replace('\\{branch\\}', '.*?');
+    regexStr = regexStr.replace('\\{slug\\}', '.*?');
+    // Anchor to full string
+    regexStr = `^${regexStr}$`;
+    try {
+        return new RegExp(regexStr);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Extract PR number from a worktree path using config-aware pattern matching.
+ *
+ * Resolution chain:
+ * 1. Configured pattern (if provided)
+ * 2. Default pattern ({repo}.pr{number})
+ *
+ * For async extraction with gh CLI fallback, use extractPrNumberAsync.
+ */
+export function extractPrNumber(worktreePath, options = {}) {
+    if (!worktreePath) {
+        return null;
+    }
+    const name = path.basename(worktreePath);
+    // 1. Try configured pattern
+    if (options.worktreePattern) {
+        const regex = patternToRegex(options.worktreePattern);
+        if (regex) {
+            const match = name.match(regex);
+            if (match) {
+                return parseInt(match[1], 10);
+            }
+        }
+    }
+    // 2. Try default pattern (skip if same as configured)
+    if (options.worktreePattern !== DEFAULT_WORKTREE_PATTERN) {
+        const defaultRegex = patternToRegex(DEFAULT_WORKTREE_PATTERN);
+        if (defaultRegex) {
+            const match = name.match(defaultRegex);
+            if (match) {
+                return parseInt(match[1], 10);
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Extract PR number with gh CLI fallback.
+ *
+ * Resolution chain:
+ * 1. Configured pattern
+ * 2. Default pattern
+ * 3. gh CLI: look up branch from git worktree list, query gh pr list --head <branch>
+ */
+export async function extractPrNumberAsync(worktreePath, options = {}) {
+    // Try synchronous extraction first
+    const syncResult = extractPrNumber(worktreePath, options);
+    if (syncResult !== null) {
+        return syncResult;
+    }
+    // 3. gh CLI fallback: find branch for this worktree, then query GitHub
+    try {
+        const worktrees = git.listWorktrees(options.cwd);
+        const resolvedPath = path.resolve(worktreePath);
+        const wt = worktrees.find((w) => path.resolve(w.path) === resolvedPath);
+        if (wt?.branch) {
+            logger.debug(`Falling back to gh CLI for PR extraction: branch=${wt.branch}`);
+            const prInfo = github.getPrByBranch(wt.branch, options.cwd);
+            if (prInfo) {
+                return prInfo.number;
+            }
+        }
+    }
+    catch (error) {
+        logger.debug('gh CLI fallback for PR extraction failed: %s', error instanceof Error ? error.message : String(error));
+    }
+    return null;
+}
+//# sourceMappingURL=worktree-utils.js.map

package/dist/lib/worktree-utils.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camaradesuk/git-worktree-tools",
-  "version": "1.12.0",
+  "version": "1.14.0",
   "description": "Git worktree workflow tools: create PRs, manage worktrees, sync configs. Cross-platform CLI for Windows, macOS, and Linux.",
   "type": "module",
   "main": "./dist/index.js",

package/schemas/worktreerc.schema.json

@@ -33,12 +33,12 @@
     "worktreePattern": {
       "type": "string",
       "default": "{repo}.pr{number}",
-      "description": "Worktree directory naming pattern. Placeholders: {repo}, {number}, {branch}, {slug} ({slug} is the branch name after the first '/', filesystem-safe)"
+      "description": "Worktree directory naming pattern. Placeholders: {repo}, {number}, {branch}, {slug}. {slug} is the branch name after the first '/', made filesystem-safe. Doubled or trailing separators (., -, _) are cleaned automatically."
     },
     "worktreeParent": {
       "type": "string",
       "default": "..",
-      "description": "Parent directory for worktrees (absolute or relative to repo root)"
+      "description": "Parent directory for worktrees (absolute or relative to repo root). When the resolved path is inside the repository, the directory will be auto-created and added to .gitignore."
     },
     "syncPatterns": {
       "type": "array",