@bretwardjames/ghp-core 0.2.0-beta.0 → 0.2.0-beta.2

package/dist/index.cjs

@@ -36,10 +36,13 @@ __export(index_exports, {
   checkoutBranch: () => checkoutBranch,
   computeSettingsDiff: () => computeSettingsDiff,
   createBranch: () => createBranch,
+  createWorktree: () => createWorktree,
   detectRepository: () => detectRepository,
+  extractIssueNumberFromBranch: () => extractIssueNumberFromBranch,
   fetchOrigin: () => fetchOrigin,
   formatConflict: () => formatConflict,
   generateBranchName: () => generateBranchName,
+  generateWorktreePath: () => generateWorktreePath,
   getAllBranches: () => getAllBranches,
   getCommitsAhead: () => getCommitsAhead,
   getCommitsBehind: () => getCommitsBehind,
@@ -49,9 +52,11 @@ __export(index_exports, {
   getLocalBranches: () => getLocalBranches,
   getRemoteBranches: () => getRemoteBranches,
   getRepositoryRoot: () => getRepositoryRoot,
+  getWorktreeForBranch: () => getWorktreeForBranch,
   hasDifferences: () => hasDifferences,
   hasUncommittedChanges: () => hasUncommittedChanges,
   isGitRepository: () => isGitRepository,
+  listWorktrees: () => listWorktrees,
   normalizeVSCodeSettings: () => normalizeVSCodeSettings,
   parseBranchLink: () => parseBranchLink,
   parseGitHubUrl: () => parseGitHubUrl,
@@ -59,6 +64,7 @@ __export(index_exports, {
   pullLatest: () => pullLatest,
   queries: () => queries_exports,
   removeBranchLinkFromBody: () => removeBranchLinkFromBody,
+  removeWorktree: () => removeWorktree,
   resolveConflicts: () => resolveConflicts,
   sanitizeForBranchName: () => sanitizeForBranchName,
   setBranchLinkInBody: () => setBranchLinkInBody,
@@ -66,7 +72,8 @@ __export(index_exports, {
   toVSCodeSettings: () => toVSCodeSettings,
   useCli: () => useCli,
   useCustom: () => useCustom,
-  useVSCode: () => useVSCode
+  useVSCode: () => useVSCode,
+  worktreeExists: () => worktreeExists
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -405,7 +412,7 @@ var REMOVE_LABELS_MUTATION = `
 var ISSUES_WITH_LABEL_QUERY = `
     query($owner: String!, $name: String!, $labels: [String!]) {
         repository(owner: $owner, name: $name) {
-            issues(first: 10, labels: $labels, states: [OPEN]) {
+            issues(first: 10, labels: $labels, states: [OPEN, CLOSED]) {
                 nodes {
                     number
                 }
@@ -1158,6 +1165,7 @@ var BranchLinker = class {
 // src/git-utils.ts
 var import_child_process = require("child_process");
 var import_util = require("util");
+var import_os = require("os");
 
 // src/url-parser.ts
 function parseGitHubUrl(url) {
@@ -1210,6 +1218,28 @@ function buildOrgProjectUrl(org, projectNumber) {
 }
 
 // src/git-utils.ts
+function sanitizeForPath(input) {
+  return String(input).replace(/\.\./g, "_").replace(/[;&|`$(){}[\]<>!]/g, "").replace(/\s+/g, "-").replace(/[^a-zA-Z0-9_\-./]/g, "_");
+}
+function validateBranchName(branch) {
+  if (!branch || branch.trim().length === 0) {
+    throw new Error("Branch name cannot be empty");
+  }
+  const dangerousChars = /[`$\\!;|&<>(){}[\]'"]/;
+  if (dangerousChars.test(branch)) {
+    throw new Error(`Branch name contains invalid characters: ${branch}`);
+  }
+  const gitInvalidChars = /[\s~^:?*\[\\]/;
+  if (gitInvalidChars.test(branch)) {
+    throw new Error(`Branch name contains invalid git characters: ${branch}`);
+  }
+  if (branch.includes("..")) {
+    throw new Error(`Branch name cannot contain '..': ${branch}`);
+  }
+  if (/^[./]|[./]$/.test(branch)) {
+    throw new Error(`Branch name cannot start or end with '/' or '.': ${branch}`);
+  }
+}
 var execAsync = (0, import_util.promisify)(import_child_process.exec);
 async function execGit(command, options = {}) {
   const cwd = options.cwd || process.cwd();
@@ -1311,6 +1341,25 @@ function generateBranchName(pattern, vars, maxLength = 60) {
   }
   return branch;
 }
+function extractIssueNumberFromBranch(branchName) {
+  const patterns = [
+    /\/(\d+)-/,
+    // user/123-title
+    /^(\d+)-/,
+    // 123-title
+    /-(\d+)-/,
+    // feature-123-title
+    /[/#](\d+)$/
+    // ends with #123 or /123
+  ];
+  for (const pattern of patterns) {
+    const match = branchName.match(pattern);
+    if (match) {
+      return parseInt(match[1], 10);
+    }
+  }
+  return null;
+}
 async function getLocalBranches(options = {}) {
   try {
     const { stdout } = await execGit('git branch --format="%(refname:short)"', options);
@@ -1357,6 +1406,90 @@ async function getDefaultBranch(options = {}) {
   }
   return "master";
 }
+function validatePath(path) {
+  if (!path || path.trim().length === 0) {
+    throw new Error("Path cannot be empty");
+  }
+  const dangerousChars = /[`$;|&<>(){}[\]'"\n\r]/;
+  if (dangerousChars.test(path)) {
+    throw new Error(`Path contains invalid characters: ${path}`);
+  }
+}
+async function createWorktree(worktreePath, branch, options = {}) {
+  validateBranchName(branch);
+  validatePath(worktreePath);
+  const localExists = await branchExists(branch, options);
+  if (localExists) {
+    await execGit(`git worktree add "${worktreePath}" "${branch}"`, options);
+  } else {
+    try {
+      await execGit(`git worktree add "${worktreePath}" -b "${branch}" "origin/${branch}"`, options);
+    } catch {
+      await execGit(`git worktree add -b "${branch}" "${worktreePath}"`, options);
+    }
+  }
+}
+async function removeWorktree(worktreePath, options = {}, force = false) {
+  validatePath(worktreePath);
+  const forceFlag = force ? "--force" : "";
+  await execGit(`git worktree remove ${forceFlag} "${worktreePath}"`, options);
+}
+async function listWorktrees(options = {}) {
+  try {
+    const { stdout } = await execGit("git worktree list --porcelain", options);
+    const worktrees = [];
+    const entries = stdout.trim().split("\n\n");
+    for (const entry of entries) {
+      if (!entry.trim()) continue;
+      const lines = entry.split("\n");
+      const info = {
+        isMain: false,
+        branch: null
+      };
+      for (const line of lines) {
+        if (line.startsWith("worktree ")) {
+          info.path = line.substring(9);
+        } else if (line.startsWith("HEAD ")) {
+          info.head = line.substring(5);
+        } else if (line.startsWith("branch ")) {
+          info.branch = line.substring(7).replace(/^refs\/heads\//, "");
+        } else if (line === "bare") {
+          info.isMain = true;
+        }
+      }
+      if (worktrees.length === 0) {
+        info.isMain = true;
+      }
+      if (info.path && info.head) {
+        worktrees.push(info);
+      }
+    }
+    return worktrees;
+  } catch {
+    return [];
+  }
+}
+async function getWorktreeForBranch(branch, options = {}) {
+  const worktrees = await listWorktrees(options);
+  return worktrees.find((wt) => wt.branch === branch) || null;
+}
+async function worktreeExists(worktreePath, options = {}) {
+  const worktrees = await listWorktrees(options);
+  return worktrees.some((wt) => wt.path === worktreePath);
+}
+function generateWorktreePath(basePath, repoName, identifier, title) {
+  const safeRepoName = sanitizeForPath(repoName);
+  let dirName;
+  if (title && typeof identifier === "number") {
+    const titleSlug = sanitizeForBranchName(title).substring(0, 35).replace(/-$/, "");
+    dirName = `${identifier}-${titleSlug}`;
+  } else {
+    dirName = sanitizeForPath(String(identifier));
+  }
+  const expandedBase = basePath.startsWith("~") ? basePath.replace("~", (0, import_os.homedir)()) : basePath;
+  const cleanBase = expandedBase.replace(/\/+$/, "");
+  return `${cleanBase}/${safeRepoName}/${dirName}`;
+}
 
 // src/sync.ts
 var SYNCABLE_KEYS = [
@@ -1537,10 +1670,13 @@ function getDiffSummary(diff) {
   checkoutBranch,
   computeSettingsDiff,
   createBranch,
+  createWorktree,
   detectRepository,
+  extractIssueNumberFromBranch,
   fetchOrigin,
   formatConflict,
   generateBranchName,
+  generateWorktreePath,
   getAllBranches,
   getCommitsAhead,
   getCommitsBehind,
@@ -1550,9 +1686,11 @@ function getDiffSummary(diff) {
   getLocalBranches,
   getRemoteBranches,
   getRepositoryRoot,
+  getWorktreeForBranch,
   hasDifferences,
   hasUncommittedChanges,
   isGitRepository,
+  listWorktrees,
   normalizeVSCodeSettings,
   parseBranchLink,
   parseGitHubUrl,
@@ -1560,6 +1698,7 @@ function getDiffSummary(diff) {
   pullLatest,
   queries,
   removeBranchLinkFromBody,
+  removeWorktree,
   resolveConflicts,
   sanitizeForBranchName,
   setBranchLinkInBody,
@@ -1567,5 +1706,6 @@ function getDiffSummary(diff) {
   toVSCodeSettings,
   useCli,
   useCustom,
-  useVSCode
+  useVSCode,
+  worktreeExists
 });

package/dist/index.d.cts

@@ -629,6 +629,16 @@ declare function generateBranchName(pattern: string, vars: {
     title: string;
     repo: string;
 }, maxLength?: number): string;
+/**
+ * Extract issue number from a branch name.
+ * Supports common patterns:
+ * - user/123-feature-name
+ * - feature/123-something
+ * - 123-fix-bug
+ * - fix-123-something
+ * - ends with #123 or /123
+ */
+declare function extractIssueNumberFromBranch(branchName: string): number | null;
 /**
  * Get all local branches
  */
@@ -645,6 +655,61 @@ declare function getAllBranches(options?: GitOptions): Promise<string[]>;
  * Get the default branch name (main or master)
  */
 declare function getDefaultBranch(options?: GitOptions): Promise<string>;
+/**
+ * Information about a git worktree
+ */
+interface WorktreeInfo {
+    /** Absolute path to the worktree directory */
+    path: string;
+    /** Commit SHA the worktree is at */
+    head: string;
+    /** Branch name (without refs/heads/ prefix), or null if detached */
+    branch: string | null;
+    /** Whether this is the main worktree (the original repo) */
+    isMain: boolean;
+}
+/**
+ * Create a new worktree for a branch
+ * @param worktreePath - Path where the worktree will be created
+ * @param branch - Branch to checkout in the worktree
+ * @param options - Git options (cwd determines the source repository)
+ */
+declare function createWorktree(worktreePath: string, branch: string, options?: GitOptions): Promise<void>;
+/**
+ * Remove a worktree
+ * @param worktreePath - Path to the worktree to remove
+ * @param options - Git options
+ * @param force - Force removal even if worktree has uncommitted changes
+ */
+declare function removeWorktree(worktreePath: string, options?: GitOptions, force?: boolean): Promise<void>;
+/**
+ * List all worktrees for the repository
+ * @param options - Git options
+ * @returns Array of worktree information
+ */
+declare function listWorktrees(options?: GitOptions): Promise<WorktreeInfo[]>;
+/**
+ * Get worktree for a specific branch
+ * @param branch - Branch name to find
+ * @param options - Git options
+ * @returns Worktree info if found, null otherwise
+ */
+declare function getWorktreeForBranch(branch: string, options?: GitOptions): Promise<WorktreeInfo | null>;
+/**
+ * Check if a worktree exists at the given path
+ * @param worktreePath - Path to check
+ * @param options - Git options
+ */
+declare function worktreeExists(worktreePath: string, options?: GitOptions): Promise<boolean>;
+/**
+ * Generate a worktree path based on repo and issue info
+ * @param basePath - Base directory for worktrees (e.g., ~/.ghp/worktrees)
+ * @param repoName - Repository name
+ * @param identifier - Issue number or branch name to use as identifier
+ * @param title - Optional title to create a descriptive directory name (e.g., "123-fix-auth-bug")
+ * @returns Full path to the worktree directory
+ */
+declare function generateWorktreePath(basePath: string, repoName: string, identifier: string | number, title?: string): string;
 
 /**
  * URL parsing utilities for GitHub repositories and issues.
@@ -937,7 +1002,7 @@ declare const REMOVE_LABELS_MUTATION = "\n    mutation($issueId: ID!, $labelIds:
 /**
  * Query to find issues with a specific label
  */
-declare const ISSUES_WITH_LABEL_QUERY = "\n    query($owner: String!, $name: String!, $labels: [String!]) {\n        repository(owner: $owner, name: $name) {\n            issues(first: 10, labels: $labels, states: [OPEN]) {\n                nodes {\n                    number\n                }\n            }\n        }\n    }\n";
+declare const ISSUES_WITH_LABEL_QUERY = "\n    query($owner: String!, $name: String!, $labels: [String!]) {\n        repository(owner: $owner, name: $name) {\n            issues(first: 10, labels: $labels, states: [OPEN, CLOSED]) {\n                nodes {\n                    number\n                }\n            }\n        }\n    }\n";
 /**
  * Query to get available issue types for a repository
  */
@@ -988,4 +1053,4 @@ declare namespace queries {
   export { queries_ADD_COMMENT_MUTATION as ADD_COMMENT_MUTATION, queries_ADD_LABELS_MUTATION as ADD_LABELS_MUTATION, queries_ADD_TO_PROJECT_MUTATION as ADD_TO_PROJECT_MUTATION, queries_COLLABORATORS_QUERY as COLLABORATORS_QUERY, queries_CREATE_ISSUE_MUTATION as CREATE_ISSUE_MUTATION, queries_ISSUES_WITH_LABEL_QUERY as ISSUES_WITH_LABEL_QUERY, queries_ISSUE_AND_LABEL_QUERY as ISSUE_AND_LABEL_QUERY, queries_ISSUE_DETAILS_QUERY as ISSUE_DETAILS_QUERY, queries_ISSUE_FOR_UPDATE_QUERY as ISSUE_FOR_UPDATE_QUERY, queries_ISSUE_NODE_ID_QUERY as ISSUE_NODE_ID_QUERY, queries_ISSUE_TYPES_QUERY as ISSUE_TYPES_QUERY, queries_LABEL_EXISTS_QUERY as LABEL_EXISTS_QUERY, queries_PROJECT_FIELDS_QUERY as PROJECT_FIELDS_QUERY, queries_PROJECT_ITEMS_QUERY as PROJECT_ITEMS_QUERY, queries_PROJECT_VIEWS_QUERY as PROJECT_VIEWS_QUERY, queries_RECENT_ISSUES_QUERY as RECENT_ISSUES_QUERY, queries_REMOVE_LABELS_MUTATION as REMOVE_LABELS_MUTATION, queries_REPOSITORY_ID_QUERY as REPOSITORY_ID_QUERY, queries_REPOSITORY_PROJECTS_QUERY as REPOSITORY_PROJECTS_QUERY, queries_UPDATE_ISSUE_BODY_MUTATION as UPDATE_ISSUE_BODY_MUTATION, queries_UPDATE_ISSUE_MUTATION as UPDATE_ISSUE_MUTATION, queries_UPDATE_ISSUE_TYPE_MUTATION as UPDATE_ISSUE_TYPE_MUTATION, queries_UPDATE_ITEM_FIELD_MUTATION as UPDATE_ITEM_FIELD_MUTATION, queries_UPDATE_ITEM_STATUS_MUTATION as UPDATE_ITEM_STATUS_MUTATION, queries_VIEWER_QUERY as VIEWER_QUERY };
 }
 
-export { type AssigneeInfo, type AuthError, BranchLinker, CLI_TO_VSCODE_MAP, type Collaborator, type ConflictChoices, type ConflictResolution, DEFAULT_VALUES, type DateFieldValue, type FieldInfo, type FieldValue, type FieldValueConnection, GitHubAPI, type GitHubAPIOptions, type GitOptions, type IssueDetails, type IssueReference, type IterationFieldValue, type LabelInfo, type NumberFieldValue, type Project, type ProjectConfig, type ProjectItem, type ProjectItemContent, type ProjectItemsQueryResponse, type ProjectV2, type ProjectV2Field, type ProjectV2Item, type ProjectV2View, type ProjectWithViews, type ProjectsQueryResponse, type RepoInfo, type ResolvedSettings, SETTING_DISPLAY_NAMES, SYNCABLE_KEYS, type SettingConflict, type SettingsDiff, type SettingsSource, type SingleSelectFieldValue, type StatusField, type SyncableSettingKey, type SyncableSettings, type TextFieldValue, type TokenProvider, VSCODE_TO_CLI_MAP, branchExists, buildIssueUrl, buildOrgProjectUrl, buildProjectUrl, buildPullRequestUrl, buildRepoUrl, checkoutBranch, computeSettingsDiff, createBranch, detectRepository, fetchOrigin, formatConflict, generateBranchName, getAllBranches, getCommitsAhead, getCommitsBehind, getCurrentBranch, getDefaultBranch, getDiffSummary, getLocalBranches, getRemoteBranches, getRepositoryRoot, hasDifferences, hasUncommittedChanges, isGitRepository, normalizeVSCodeSettings, parseBranchLink, parseGitHubUrl, parseIssueUrl, pullLatest, queries, removeBranchLinkFromBody, resolveConflicts, sanitizeForBranchName, setBranchLinkInBody, skip, toVSCodeSettings, useCli, useCustom, useVSCode };
+export { type AssigneeInfo, type AuthError, BranchLinker, CLI_TO_VSCODE_MAP, type Collaborator, type ConflictChoices, type ConflictResolution, DEFAULT_VALUES, type DateFieldValue, type FieldInfo, type FieldValue, type FieldValueConnection, GitHubAPI, type GitHubAPIOptions, type GitOptions, type IssueDetails, type IssueReference, type IterationFieldValue, type LabelInfo, type NumberFieldValue, type Project, type ProjectConfig, type ProjectItem, type ProjectItemContent, type ProjectItemsQueryResponse, type ProjectV2, type ProjectV2Field, type ProjectV2Item, type ProjectV2View, type ProjectWithViews, type ProjectsQueryResponse, type RepoInfo, type ResolvedSettings, SETTING_DISPLAY_NAMES, SYNCABLE_KEYS, type SettingConflict, type SettingsDiff, type SettingsSource, type SingleSelectFieldValue, type StatusField, type SyncableSettingKey, type SyncableSettings, type TextFieldValue, type TokenProvider, VSCODE_TO_CLI_MAP, type WorktreeInfo, branchExists, buildIssueUrl, buildOrgProjectUrl, buildProjectUrl, buildPullRequestUrl, buildRepoUrl, checkoutBranch, computeSettingsDiff, createBranch, createWorktree, detectRepository, extractIssueNumberFromBranch, fetchOrigin, formatConflict, generateBranchName, generateWorktreePath, getAllBranches, getCommitsAhead, getCommitsBehind, getCurrentBranch, getDefaultBranch, getDiffSummary, getLocalBranches, getRemoteBranches, getRepositoryRoot, getWorktreeForBranch, hasDifferences, hasUncommittedChanges, isGitRepository, listWorktrees, normalizeVSCodeSettings, parseBranchLink, parseGitHubUrl, parseIssueUrl, pullLatest, queries, removeBranchLinkFromBody, removeWorktree, resolveConflicts, sanitizeForBranchName, setBranchLinkInBody, skip, toVSCodeSettings, useCli, useCustom, useVSCode, worktreeExists };

package/dist/index.d.ts

@@ -629,6 +629,16 @@ declare function generateBranchName(pattern: string, vars: {
     title: string;
     repo: string;
 }, maxLength?: number): string;
+/**
+ * Extract issue number from a branch name.
+ * Supports common patterns:
+ * - user/123-feature-name
+ * - feature/123-something
+ * - 123-fix-bug
+ * - fix-123-something
+ * - ends with #123 or /123
+ */
+declare function extractIssueNumberFromBranch(branchName: string): number | null;
 /**
  * Get all local branches
  */
@@ -645,6 +655,61 @@ declare function getAllBranches(options?: GitOptions): Promise<string[]>;
  * Get the default branch name (main or master)
  */
 declare function getDefaultBranch(options?: GitOptions): Promise<string>;
+/**
+ * Information about a git worktree
+ */
+interface WorktreeInfo {
+    /** Absolute path to the worktree directory */
+    path: string;
+    /** Commit SHA the worktree is at */
+    head: string;
+    /** Branch name (without refs/heads/ prefix), or null if detached */
+    branch: string | null;
+    /** Whether this is the main worktree (the original repo) */
+    isMain: boolean;
+}
+/**
+ * Create a new worktree for a branch
+ * @param worktreePath - Path where the worktree will be created
+ * @param branch - Branch to checkout in the worktree
+ * @param options - Git options (cwd determines the source repository)
+ */
+declare function createWorktree(worktreePath: string, branch: string, options?: GitOptions): Promise<void>;
+/**
+ * Remove a worktree
+ * @param worktreePath - Path to the worktree to remove
+ * @param options - Git options
+ * @param force - Force removal even if worktree has uncommitted changes
+ */
+declare function removeWorktree(worktreePath: string, options?: GitOptions, force?: boolean): Promise<void>;
+/**
+ * List all worktrees for the repository
+ * @param options - Git options
+ * @returns Array of worktree information
+ */
+declare function listWorktrees(options?: GitOptions): Promise<WorktreeInfo[]>;
+/**
+ * Get worktree for a specific branch
+ * @param branch - Branch name to find
+ * @param options - Git options
+ * @returns Worktree info if found, null otherwise
+ */
+declare function getWorktreeForBranch(branch: string, options?: GitOptions): Promise<WorktreeInfo | null>;
+/**
+ * Check if a worktree exists at the given path
+ * @param worktreePath - Path to check
+ * @param options - Git options
+ */
+declare function worktreeExists(worktreePath: string, options?: GitOptions): Promise<boolean>;
+/**
+ * Generate a worktree path based on repo and issue info
+ * @param basePath - Base directory for worktrees (e.g., ~/.ghp/worktrees)
+ * @param repoName - Repository name
+ * @param identifier - Issue number or branch name to use as identifier
+ * @param title - Optional title to create a descriptive directory name (e.g., "123-fix-auth-bug")
+ * @returns Full path to the worktree directory
+ */
+declare function generateWorktreePath(basePath: string, repoName: string, identifier: string | number, title?: string): string;
 
 /**
  * URL parsing utilities for GitHub repositories and issues.
@@ -937,7 +1002,7 @@ declare const REMOVE_LABELS_MUTATION = "\n    mutation($issueId: ID!, $labelIds:
 /**
  * Query to find issues with a specific label
  */
-declare const ISSUES_WITH_LABEL_QUERY = "\n    query($owner: String!, $name: String!, $labels: [String!]) {\n        repository(owner: $owner, name: $name) {\n            issues(first: 10, labels: $labels, states: [OPEN]) {\n                nodes {\n                    number\n                }\n            }\n        }\n    }\n";
+declare const ISSUES_WITH_LABEL_QUERY = "\n    query($owner: String!, $name: String!, $labels: [String!]) {\n        repository(owner: $owner, name: $name) {\n            issues(first: 10, labels: $labels, states: [OPEN, CLOSED]) {\n                nodes {\n                    number\n                }\n            }\n        }\n    }\n";
 /**
  * Query to get available issue types for a repository
  */
@@ -988,4 +1053,4 @@ declare namespace queries {
   export { queries_ADD_COMMENT_MUTATION as ADD_COMMENT_MUTATION, queries_ADD_LABELS_MUTATION as ADD_LABELS_MUTATION, queries_ADD_TO_PROJECT_MUTATION as ADD_TO_PROJECT_MUTATION, queries_COLLABORATORS_QUERY as COLLABORATORS_QUERY, queries_CREATE_ISSUE_MUTATION as CREATE_ISSUE_MUTATION, queries_ISSUES_WITH_LABEL_QUERY as ISSUES_WITH_LABEL_QUERY, queries_ISSUE_AND_LABEL_QUERY as ISSUE_AND_LABEL_QUERY, queries_ISSUE_DETAILS_QUERY as ISSUE_DETAILS_QUERY, queries_ISSUE_FOR_UPDATE_QUERY as ISSUE_FOR_UPDATE_QUERY, queries_ISSUE_NODE_ID_QUERY as ISSUE_NODE_ID_QUERY, queries_ISSUE_TYPES_QUERY as ISSUE_TYPES_QUERY, queries_LABEL_EXISTS_QUERY as LABEL_EXISTS_QUERY, queries_PROJECT_FIELDS_QUERY as PROJECT_FIELDS_QUERY, queries_PROJECT_ITEMS_QUERY as PROJECT_ITEMS_QUERY, queries_PROJECT_VIEWS_QUERY as PROJECT_VIEWS_QUERY, queries_RECENT_ISSUES_QUERY as RECENT_ISSUES_QUERY, queries_REMOVE_LABELS_MUTATION as REMOVE_LABELS_MUTATION, queries_REPOSITORY_ID_QUERY as REPOSITORY_ID_QUERY, queries_REPOSITORY_PROJECTS_QUERY as REPOSITORY_PROJECTS_QUERY, queries_UPDATE_ISSUE_BODY_MUTATION as UPDATE_ISSUE_BODY_MUTATION, queries_UPDATE_ISSUE_MUTATION as UPDATE_ISSUE_MUTATION, queries_UPDATE_ISSUE_TYPE_MUTATION as UPDATE_ISSUE_TYPE_MUTATION, queries_UPDATE_ITEM_FIELD_MUTATION as UPDATE_ITEM_FIELD_MUTATION, queries_UPDATE_ITEM_STATUS_MUTATION as UPDATE_ITEM_STATUS_MUTATION, queries_VIEWER_QUERY as VIEWER_QUERY };
 }
 
-export { type AssigneeInfo, type AuthError, BranchLinker, CLI_TO_VSCODE_MAP, type Collaborator, type ConflictChoices, type ConflictResolution, DEFAULT_VALUES, type DateFieldValue, type FieldInfo, type FieldValue, type FieldValueConnection, GitHubAPI, type GitHubAPIOptions, type GitOptions, type IssueDetails, type IssueReference, type IterationFieldValue, type LabelInfo, type NumberFieldValue, type Project, type ProjectConfig, type ProjectItem, type ProjectItemContent, type ProjectItemsQueryResponse, type ProjectV2, type ProjectV2Field, type ProjectV2Item, type ProjectV2View, type ProjectWithViews, type ProjectsQueryResponse, type RepoInfo, type ResolvedSettings, SETTING_DISPLAY_NAMES, SYNCABLE_KEYS, type SettingConflict, type SettingsDiff, type SettingsSource, type SingleSelectFieldValue, type StatusField, type SyncableSettingKey, type SyncableSettings, type TextFieldValue, type TokenProvider, VSCODE_TO_CLI_MAP, branchExists, buildIssueUrl, buildOrgProjectUrl, buildProjectUrl, buildPullRequestUrl, buildRepoUrl, checkoutBranch, computeSettingsDiff, createBranch, detectRepository, fetchOrigin, formatConflict, generateBranchName, getAllBranches, getCommitsAhead, getCommitsBehind, getCurrentBranch, getDefaultBranch, getDiffSummary, getLocalBranches, getRemoteBranches, getRepositoryRoot, hasDifferences, hasUncommittedChanges, isGitRepository, normalizeVSCodeSettings, parseBranchLink, parseGitHubUrl, parseIssueUrl, pullLatest, queries, removeBranchLinkFromBody, resolveConflicts, sanitizeForBranchName, setBranchLinkInBody, skip, toVSCodeSettings, useCli, useCustom, useVSCode };
+export { type AssigneeInfo, type AuthError, BranchLinker, CLI_TO_VSCODE_MAP, type Collaborator, type ConflictChoices, type ConflictResolution, DEFAULT_VALUES, type DateFieldValue, type FieldInfo, type FieldValue, type FieldValueConnection, GitHubAPI, type GitHubAPIOptions, type GitOptions, type IssueDetails, type IssueReference, type IterationFieldValue, type LabelInfo, type NumberFieldValue, type Project, type ProjectConfig, type ProjectItem, type ProjectItemContent, type ProjectItemsQueryResponse, type ProjectV2, type ProjectV2Field, type ProjectV2Item, type ProjectV2View, type ProjectWithViews, type ProjectsQueryResponse, type RepoInfo, type ResolvedSettings, SETTING_DISPLAY_NAMES, SYNCABLE_KEYS, type SettingConflict, type SettingsDiff, type SettingsSource, type SingleSelectFieldValue, type StatusField, type SyncableSettingKey, type SyncableSettings, type TextFieldValue, type TokenProvider, VSCODE_TO_CLI_MAP, type WorktreeInfo, branchExists, buildIssueUrl, buildOrgProjectUrl, buildProjectUrl, buildPullRequestUrl, buildRepoUrl, checkoutBranch, computeSettingsDiff, createBranch, createWorktree, detectRepository, extractIssueNumberFromBranch, fetchOrigin, formatConflict, generateBranchName, generateWorktreePath, getAllBranches, getCommitsAhead, getCommitsBehind, getCurrentBranch, getDefaultBranch, getDiffSummary, getLocalBranches, getRemoteBranches, getRepositoryRoot, getWorktreeForBranch, hasDifferences, hasUncommittedChanges, isGitRepository, listWorktrees, normalizeVSCodeSettings, parseBranchLink, parseGitHubUrl, parseIssueUrl, pullLatest, queries, removeBranchLinkFromBody, removeWorktree, resolveConflicts, sanitizeForBranchName, setBranchLinkInBody, skip, toVSCodeSettings, useCli, useCustom, useVSCode, worktreeExists };

package/dist/index.js

@@ -339,7 +339,7 @@ var REMOVE_LABELS_MUTATION = `
 var ISSUES_WITH_LABEL_QUERY = `
     query($owner: String!, $name: String!, $labels: [String!]) {
         repository(owner: $owner, name: $name) {
-            issues(first: 10, labels: $labels, states: [OPEN]) {
+            issues(first: 10, labels: $labels, states: [OPEN, CLOSED]) {
                 nodes {
                     number
                 }
@@ -1092,6 +1092,7 @@ var BranchLinker = class {
 // src/git-utils.ts
 import { exec } from "child_process";
 import { promisify } from "util";
+import { homedir } from "os";
 
 // src/url-parser.ts
 function parseGitHubUrl(url) {
@@ -1144,6 +1145,28 @@ function buildOrgProjectUrl(org, projectNumber) {
 }
 
 // src/git-utils.ts
+function sanitizeForPath(input) {
+  return String(input).replace(/\.\./g, "_").replace(/[;&|`$(){}[\]<>!]/g, "").replace(/\s+/g, "-").replace(/[^a-zA-Z0-9_\-./]/g, "_");
+}
+function validateBranchName(branch) {
+  if (!branch || branch.trim().length === 0) {
+    throw new Error("Branch name cannot be empty");
+  }
+  const dangerousChars = /[`$\\!;|&<>(){}[\]'"]/;
+  if (dangerousChars.test(branch)) {
+    throw new Error(`Branch name contains invalid characters: ${branch}`);
+  }
+  const gitInvalidChars = /[\s~^:?*\[\\]/;
+  if (gitInvalidChars.test(branch)) {
+    throw new Error(`Branch name contains invalid git characters: ${branch}`);
+  }
+  if (branch.includes("..")) {
+    throw new Error(`Branch name cannot contain '..': ${branch}`);
+  }
+  if (/^[./]|[./]$/.test(branch)) {
+    throw new Error(`Branch name cannot start or end with '/' or '.': ${branch}`);
+  }
+}
 var execAsync = promisify(exec);
 async function execGit(command, options = {}) {
   const cwd = options.cwd || process.cwd();
@@ -1245,6 +1268,25 @@ function generateBranchName(pattern, vars, maxLength = 60) {
   }
   return branch;
 }
+function extractIssueNumberFromBranch(branchName) {
+  const patterns = [
+    /\/(\d+)-/,
+    // user/123-title
+    /^(\d+)-/,
+    // 123-title
+    /-(\d+)-/,
+    // feature-123-title
+    /[/#](\d+)$/
+    // ends with #123 or /123
+  ];
+  for (const pattern of patterns) {
+    const match = branchName.match(pattern);
+    if (match) {
+      return parseInt(match[1], 10);
+    }
+  }
+  return null;
+}
 async function getLocalBranches(options = {}) {
   try {
     const { stdout } = await execGit('git branch --format="%(refname:short)"', options);
@@ -1291,6 +1333,90 @@ async function getDefaultBranch(options = {}) {
   }
   return "master";
 }
+function validatePath(path) {
+  if (!path || path.trim().length === 0) {
+    throw new Error("Path cannot be empty");
+  }
+  const dangerousChars = /[`$;|&<>(){}[\]'"\n\r]/;
+  if (dangerousChars.test(path)) {
+    throw new Error(`Path contains invalid characters: ${path}`);
+  }
+}
+async function createWorktree(worktreePath, branch, options = {}) {
+  validateBranchName(branch);
+  validatePath(worktreePath);
+  const localExists = await branchExists(branch, options);
+  if (localExists) {
+    await execGit(`git worktree add "${worktreePath}" "${branch}"`, options);
+  } else {
+    try {
+      await execGit(`git worktree add "${worktreePath}" -b "${branch}" "origin/${branch}"`, options);
+    } catch {
+      await execGit(`git worktree add -b "${branch}" "${worktreePath}"`, options);
+    }
+  }
+}
+async function removeWorktree(worktreePath, options = {}, force = false) {
+  validatePath(worktreePath);
+  const forceFlag = force ? "--force" : "";
+  await execGit(`git worktree remove ${forceFlag} "${worktreePath}"`, options);
+}
+async function listWorktrees(options = {}) {
+  try {
+    const { stdout } = await execGit("git worktree list --porcelain", options);
+    const worktrees = [];
+    const entries = stdout.trim().split("\n\n");
+    for (const entry of entries) {
+      if (!entry.trim()) continue;
+      const lines = entry.split("\n");
+      const info = {
+        isMain: false,
+        branch: null
+      };
+      for (const line of lines) {
+        if (line.startsWith("worktree ")) {
+          info.path = line.substring(9);
+        } else if (line.startsWith("HEAD ")) {
+          info.head = line.substring(5);
+        } else if (line.startsWith("branch ")) {
+          info.branch = line.substring(7).replace(/^refs\/heads\//, "");
+        } else if (line === "bare") {
+          info.isMain = true;
+        }
+      }
+      if (worktrees.length === 0) {
+        info.isMain = true;
+      }
+      if (info.path && info.head) {
+        worktrees.push(info);
+      }
+    }
+    return worktrees;
+  } catch {
+    return [];
+  }
+}
+async function getWorktreeForBranch(branch, options = {}) {
+  const worktrees = await listWorktrees(options);
+  return worktrees.find((wt) => wt.branch === branch) || null;
+}
+async function worktreeExists(worktreePath, options = {}) {
+  const worktrees = await listWorktrees(options);
+  return worktrees.some((wt) => wt.path === worktreePath);
+}
+function generateWorktreePath(basePath, repoName, identifier, title) {
+  const safeRepoName = sanitizeForPath(repoName);
+  let dirName;
+  if (title && typeof identifier === "number") {
+    const titleSlug = sanitizeForBranchName(title).substring(0, 35).replace(/-$/, "");
+    dirName = `${identifier}-${titleSlug}`;
+  } else {
+    dirName = sanitizeForPath(String(identifier));
+  }
+  const expandedBase = basePath.startsWith("~") ? basePath.replace("~", homedir()) : basePath;
+  const cleanBase = expandedBase.replace(/\/+$/, "");
+  return `${cleanBase}/${safeRepoName}/${dirName}`;
+}
 
 // src/sync.ts
 var SYNCABLE_KEYS = [
@@ -1470,10 +1596,13 @@ export {
   checkoutBranch,
   computeSettingsDiff,
   createBranch,
+  createWorktree,
   detectRepository,
+  extractIssueNumberFromBranch,
   fetchOrigin,
   formatConflict,
   generateBranchName,
+  generateWorktreePath,
   getAllBranches,
   getCommitsAhead,
   getCommitsBehind,
@@ -1483,9 +1612,11 @@ export {
   getLocalBranches,
   getRemoteBranches,
   getRepositoryRoot,
+  getWorktreeForBranch,
   hasDifferences,
   hasUncommittedChanges,
   isGitRepository,
+  listWorktrees,
   normalizeVSCodeSettings,
   parseBranchLink,
   parseGitHubUrl,
@@ -1493,6 +1624,7 @@ export {
   pullLatest,
   queries_exports as queries,
   removeBranchLinkFromBody,
+  removeWorktree,
   resolveConflicts,
   sanitizeForBranchName,
   setBranchLinkInBody,
@@ -1500,5 +1632,6 @@ export {
   toVSCodeSettings,
   useCli,
   useCustom,
-  useVSCode
+  useVSCode,
+  worktreeExists
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bretwardjames/ghp-core",
-  "version": "0.2.0-beta.0",
+  "version": "0.2.0-beta.2",
   "description": "Shared core library for GitHub Projects tools",
   "main": "dist/index.cjs",
   "module": "dist/index.js",
@@ -16,6 +16,12 @@
   "files": [
     "dist"
   ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
   "keywords": [
     "github",
     "projects",
@@ -38,10 +44,5 @@
     "@types/node": "^20.10.0",
     "tsup": "^8.0.0",
     "typescript": "^5.3.2"
-  },
-  "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts",
-    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
-    "typecheck": "tsc --noEmit"
   }
-}
+}