@bretwardjames/ghp-core 0.2.0-beta.1 → 0.2.0-beta.3

package/dist/index.cjs

@@ -38,6 +38,7 @@ __export(index_exports, {
   createBranch: () => createBranch,
   createWorktree: () => createWorktree,
   detectRepository: () => detectRepository,
+  extractIssueNumberFromBranch: () => extractIssueNumberFromBranch,
   fetchOrigin: () => fetchOrigin,
   formatConflict: () => formatConflict,
   generateBranchName: () => generateBranchName,
@@ -1340,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);
@@ -1457,12 +1477,18 @@ async function worktreeExists(worktreePath, options = {}) {
   const worktrees = await listWorktrees(options);
   return worktrees.some((wt) => wt.path === worktreePath);
 }
-function generateWorktreePath(basePath, repoName, identifier) {
+function generateWorktreePath(basePath, repoName, identifier, title) {
   const safeRepoName = sanitizeForPath(repoName);
-  const safeIdentifier = sanitizeForPath(String(identifier));
+  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}/${safeIdentifier}`;
+  return `${cleanBase}/${safeRepoName}/${dirName}`;
 }
 
 // src/sync.ts
@@ -1646,6 +1672,7 @@ function getDiffSummary(diff) {
   createBranch,
   createWorktree,
   detectRepository,
+  extractIssueNumberFromBranch,
   fetchOrigin,
   formatConflict,
   generateBranchName,

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
  */
@@ -692,13 +702,14 @@ declare function getWorktreeForBranch(branch: string, options?: GitOptions): Pro
  */
 declare function worktreeExists(worktreePath: string, options?: GitOptions): Promise<boolean>;
 /**
- * Generate a worktree path based on repo and branch info
+ * 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): string;
+declare function generateWorktreePath(basePath: string, repoName: string, identifier: string | number, title?: string): string;
 
 /**
  * URL parsing utilities for GitHub repositories and issues.
@@ -1042,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, type WorktreeInfo, branchExists, buildIssueUrl, buildOrgProjectUrl, buildProjectUrl, buildPullRequestUrl, buildRepoUrl, checkoutBranch, computeSettingsDiff, createBranch, createWorktree, detectRepository, 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 };
+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
  */
@@ -692,13 +702,14 @@ declare function getWorktreeForBranch(branch: string, options?: GitOptions): Pro
  */
 declare function worktreeExists(worktreePath: string, options?: GitOptions): Promise<boolean>;
 /**
- * Generate a worktree path based on repo and branch info
+ * 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): string;
+declare function generateWorktreePath(basePath: string, repoName: string, identifier: string | number, title?: string): string;
 
 /**
  * URL parsing utilities for GitHub repositories and issues.
@@ -1042,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, type WorktreeInfo, branchExists, buildIssueUrl, buildOrgProjectUrl, buildProjectUrl, buildPullRequestUrl, buildRepoUrl, checkoutBranch, computeSettingsDiff, createBranch, createWorktree, detectRepository, 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 };
+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

@@ -1268,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);
@@ -1385,12 +1404,18 @@ async function worktreeExists(worktreePath, options = {}) {
   const worktrees = await listWorktrees(options);
   return worktrees.some((wt) => wt.path === worktreePath);
 }
-function generateWorktreePath(basePath, repoName, identifier) {
+function generateWorktreePath(basePath, repoName, identifier, title) {
   const safeRepoName = sanitizeForPath(repoName);
-  const safeIdentifier = sanitizeForPath(String(identifier));
+  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}/${safeIdentifier}`;
+  return `${cleanBase}/${safeRepoName}/${dirName}`;
 }
 
 // src/sync.ts
@@ -1573,6 +1598,7 @@ export {
   createBranch,
   createWorktree,
   detectRepository,
+  extractIssueNumberFromBranch,
   fetchOrigin,
   formatConflict,
   generateBranchName,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bretwardjames/ghp-core",
-  "version": "0.2.0-beta.1",
+  "version": "0.2.0-beta.3",
   "description": "Shared core library for GitHub Projects tools",
   "main": "dist/index.cjs",
   "module": "dist/index.js",