@bretwardjames/ghp-core 0.1.1 → 0.1.3

package/dist/index.cjs

@@ -30,7 +30,6 @@ __export(index_exports, {
   buildRepoUrl: () => buildRepoUrl,
   checkoutBranch: () => checkoutBranch,
   createBranch: () => createBranch,
-  createInMemoryAdapter: () => createInMemoryAdapter,
   detectRepository: () => detectRepository,
   fetchOrigin: () => fetchOrigin,
   generateBranchName: () => generateBranchName,
@@ -41,11 +40,14 @@ __export(index_exports, {
   getRepositoryRoot: () => getRepositoryRoot,
   hasUncommittedChanges: () => hasUncommittedChanges,
   isGitRepository: () => isGitRepository,
+  parseBranchLink: () => parseBranchLink,
   parseGitHubUrl: () => parseGitHubUrl,
   parseIssueUrl: () => parseIssueUrl,
   pullLatest: () => pullLatest,
   queries: () => queries_exports,
-  sanitizeForBranchName: () => sanitizeForBranchName
+  removeBranchLinkFromBody: () => removeBranchLinkFromBody,
+  sanitizeForBranchName: () => sanitizeForBranchName,
+  setBranchLinkInBody: () => setBranchLinkInBody
 });
 module.exports = __toCommonJS(index_exports);
 
@@ -75,6 +77,7 @@ __export(queries_exports, {
   REPOSITORY_ID_QUERY: () => REPOSITORY_ID_QUERY,
   REPOSITORY_PROJECTS_QUERY: () => REPOSITORY_PROJECTS_QUERY,
   UPDATE_ISSUE_BODY_MUTATION: () => UPDATE_ISSUE_BODY_MUTATION,
+  UPDATE_ISSUE_MUTATION: () => UPDATE_ISSUE_MUTATION,
   UPDATE_ISSUE_TYPE_MUTATION: () => UPDATE_ISSUE_TYPE_MUTATION,
   UPDATE_ITEM_FIELD_MUTATION: () => UPDATE_ITEM_FIELD_MUTATION,
   UPDATE_ITEM_STATUS_MUTATION: () => UPDATE_ITEM_STATUS_MUTATION,
@@ -430,6 +433,15 @@ var UPDATE_ISSUE_BODY_MUTATION = `
         }
     }
 `;
+var UPDATE_ISSUE_MUTATION = `
+    mutation($issueId: ID!, $title: String, $body: String) {
+        updateIssue(input: { id: $issueId, title: $title, body: $body }) {
+            issue {
+                id
+            }
+        }
+    }
+`;
 
 // src/github-api.ts
 function createAuthError(message, type, details) {
@@ -968,141 +980,94 @@ var GitHubAPI = class {
       return false;
     }
   }
+  /**
+   * Update an issue's title and/or body
+   */
+  async updateIssue(repo, issueNumber, updates) {
+    if (!this.graphqlWithAuth) throw new Error("Not authenticated");
+    try {
+      const issueResponse = await this.graphqlWithAuth(ISSUE_FOR_UPDATE_QUERY, {
+        owner: repo.owner,
+        name: repo.name,
+        number: issueNumber
+      });
+      if (!issueResponse.repository.issue) {
+        return false;
+      }
+      await this.graphqlWithAuth(UPDATE_ISSUE_MUTATION, {
+        issueId: issueResponse.repository.issue.id,
+        title: updates.title,
+        body: updates.body
+      });
+      return true;
+    } catch {
+      return false;
+    }
+  }
 };
 
 // src/branch-linker.ts
-var BranchLinker = class {
-  storage;
-  constructor(storage) {
-    this.storage = storage;
-  }
-  /**
-   * Load links from storage (handles both sync and async adapters)
-   */
-  async loadLinks() {
-    const result = this.storage.load();
-    return result instanceof Promise ? await result : result;
+var BRANCH_LINK_PATTERN = /<!--\s*ghp-branch:\s*(.+?)\s*-->/;
+function parseBranchLink(body) {
+  if (!body) return null;
+  const match = body.match(BRANCH_LINK_PATTERN);
+  return match ? match[1].trim() : null;
+}
+function setBranchLinkInBody(body, branch) {
+  const currentBody = body || "";
+  const tag = `<!-- ghp-branch: ${branch} -->`;
+  if (BRANCH_LINK_PATTERN.test(currentBody)) {
+    return currentBody.replace(BRANCH_LINK_PATTERN, tag);
+  } else {
+    return currentBody.trim() + "\n\n" + tag;
   }
-  /**
-   * Save links to storage (handles both sync and async adapters)
-   */
-  async saveLinks(links) {
-    const result = this.storage.save(links);
-    if (result instanceof Promise) {
-      await result;
-    }
+}
+function removeBranchLinkFromBody(body) {
+  if (!body) return "";
+  return body.replace(BRANCH_LINK_PATTERN, "").trim();
+}
+var BranchLinker = class {
+  api;
+  constructor(api) {
+    this.api = api;
   }
   /**
    * Create a link between a branch and an issue.
-   * If a link already exists for this branch or issue in this repo, it will be replaced.
+   * Stores the link as a hidden comment in the issue body.
    */
-  async link(branch, issueNumber, issueTitle, itemId, repo) {
-    const links = await this.loadLinks();
-    const filtered = links.filter(
-      (l) => !(l.repo === repo && (l.branch === branch || l.issueNumber === issueNumber))
-    );
-    filtered.push({
-      branch,
-      issueNumber,
-      issueTitle,
-      itemId,
-      repo,
-      linkedAt: (/* @__PURE__ */ new Date()).toISOString()
-    });
-    await this.saveLinks(filtered);
+  async link(repo, issueNumber, branch) {
+    const details = await this.api.getIssueDetails(repo, issueNumber);
+    if (!details) return false;
+    const newBody = setBranchLinkInBody(details.body, branch);
+    return this.api.updateIssueBody(repo, issueNumber, newBody);
   }
   /**
-   * Remove the link for an issue.
-   * @returns true if a link was removed, false if no link existed
+   * Remove the branch link from an issue.
    */
   async unlink(repo, issueNumber) {
-    const links = await this.loadLinks();
-    const filtered = links.filter(
-      (l) => !(l.repo === repo && l.issueNumber === issueNumber)
-    );
-    if (filtered.length === links.length) {
-      return false;
-    }
-    await this.saveLinks(filtered);
-    return true;
-  }
-  /**
-   * Remove the link for a branch.
-   * @returns true if a link was removed, false if no link existed
-   */
-  async unlinkBranch(repo, branch) {
-    const links = await this.loadLinks();
-    const filtered = links.filter(
-      (l) => !(l.repo === repo && l.branch === branch)
-    );
-    if (filtered.length === links.length) {
-      return false;
-    }
-    await this.saveLinks(filtered);
-    return true;
+    const details = await this.api.getIssueDetails(repo, issueNumber);
+    if (!details) return false;
+    const currentBranch = parseBranchLink(details.body);
+    if (!currentBranch) return false;
+    const newBody = removeBranchLinkFromBody(details.body);
+    return this.api.updateIssueBody(repo, issueNumber, newBody);
   }
   /**
    * Get the branch linked to an issue.
    */
   async getBranchForIssue(repo, issueNumber) {
-    const links = await this.loadLinks();
-    const link = links.find((l) => l.repo === repo && l.issueNumber === issueNumber);
-    return link?.branch || null;
+    const details = await this.api.getIssueDetails(repo, issueNumber);
+    if (!details) return null;
+    return parseBranchLink(details.body);
   }
   /**
-   * Get the full link info for a branch.
+   * Check if an issue has a branch link.
    */
-  async getLinkForBranch(repo, branch) {
-    const links = await this.loadLinks();
-    return links.find((l) => l.repo === repo && l.branch === branch) || null;
-  }
-  /**
-   * Get the full link info for an issue.
-   */
-  async getLinkForIssue(repo, issueNumber) {
-    const links = await this.loadLinks();
-    return links.find((l) => l.repo === repo && l.issueNumber === issueNumber) || null;
-  }
-  /**
-   * Get all links for a repository.
-   */
-  async getLinksForRepo(repo) {
-    const links = await this.loadLinks();
-    return links.filter((l) => l.repo === repo);
-  }
-  /**
-   * Get all links.
-   */
-  async getAllLinks() {
-    return this.loadLinks();
-  }
-  /**
-   * Check if a branch has a link.
-   */
-  async hasLinkForBranch(repo, branch) {
-    const link = await this.getLinkForBranch(repo, branch);
-    return link !== null;
-  }
-  /**
-   * Check if an issue has a link.
-   */
-  async hasLinkForIssue(repo, issueNumber) {
-    const link = await this.getLinkForIssue(repo, issueNumber);
-    return link !== null;
+  async hasLink(repo, issueNumber) {
+    const branch = await this.getBranchForIssue(repo, issueNumber);
+    return branch !== null;
   }
 };
-function createInMemoryAdapter() {
-  const adapter = {
-    links: [],
-    load() {
-      return [...this.links];
-    },
-    save(links) {
-      this.links = [...links];
-    }
-  };
-  return adapter;
-}
 
 // src/git-utils.ts
 var import_child_process = require("child_process");
@@ -1290,7 +1255,6 @@ async function getDefaultBranch(options = {}) {
   buildRepoUrl,
   checkoutBranch,
   createBranch,
-  createInMemoryAdapter,
   detectRepository,
   fetchOrigin,
   generateBranchName,
@@ -1301,9 +1265,12 @@ async function getDefaultBranch(options = {}) {
   getRepositoryRoot,
   hasUncommittedChanges,
   isGitRepository,
+  parseBranchLink,
   parseGitHubUrl,
   parseIssueUrl,
   pullLatest,
   queries,
-  sanitizeForBranchName
+  removeBranchLinkFromBody,
+  sanitizeForBranchName,
+  setBranchLinkInBody
 });

package/dist/index.d.cts

@@ -29,25 +29,6 @@ interface AuthError extends Error {
     requiredScopes?: string[];
     ssoUrl?: string;
 }
-/**
- * Interface for persisting branch-issue links.
- * Implement this for different storage backends (file system, VSCode state, etc.)
- */
-interface StorageAdapter {
-    load(): BranchLink[] | Promise<BranchLink[]>;
-    save(links: BranchLink[]): void | Promise<void>;
-}
-/**
- * A link between a git branch and a GitHub issue/item
- */
-interface BranchLink {
-    branch: string;
-    issueNumber: number;
-    issueTitle: string;
-    itemId: string;
-    repo: string;
-    linkedAt: string;
-}
 /**
  * Options for git operations
  */
@@ -517,123 +498,63 @@ declare class GitHubAPI {
      * Update an issue's body/description
      */
     updateIssueBody(repo: RepoInfo, issueNumber: number, body: string): Promise<boolean>;
+    /**
+     * Update an issue's title and/or body
+     */
+    updateIssue(repo: RepoInfo, issueNumber: number, updates: {
+        title?: string;
+        body?: string;
+    }): Promise<boolean>;
 }
 
 /**
- * Branch-issue linking with pluggable storage.
- *
- * The BranchLinker class manages associations between git branches and GitHub issues.
- * Storage is abstracted via the StorageAdapter interface, allowing different backends:
- * - File system (for CLI)
- * - VSCode workspaceState (for extensions)
- * - In-memory (for testing)
- *
- * @example CLI usage with file storage:
- * ```typescript
- * import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
- * import { homedir } from 'os';
- * import { join } from 'path';
+ * Branch-issue linking stored directly in GitHub issue bodies.
  *
- * const DATA_DIR = join(homedir(), '.config', 'ghp-cli');
- * const LINKS_FILE = join(DATA_DIR, 'branch-links.json');
+ * Links are stored as hidden HTML comments in the issue body:
+ * <!-- ghp-branch: feature/my-branch -->
  *
- * const fileAdapter: StorageAdapter = {
- *   load() {
- *     if (existsSync(LINKS_FILE)) {
- *       return JSON.parse(readFileSync(LINKS_FILE, 'utf-8'));
- *     }
- *     return [];
- *   },
- *   save(links) {
- *     if (!existsSync(DATA_DIR)) {
- *       mkdirSync(DATA_DIR, { recursive: true });
- *     }
- *     writeFileSync(LINKS_FILE, JSON.stringify(links, null, 2));
- *   }
- * };
- *
- * const linker = new BranchLinker(fileAdapter);
- * ```
- *
- * @example VSCode usage with workspaceState:
- * ```typescript
- * const vscodeAdapter: StorageAdapter = {
- *   load() {
- *     return context.workspaceState.get<BranchLink[]>('branchLinks', []);
- *   },
- *   save(links) {
- *     context.workspaceState.update('branchLinks', links);
- *   }
- * };
- *
- * const linker = new BranchLinker(vscodeAdapter);
- * ```
+ * This allows branch links to be shared across all consumers (CLI, VSCode, etc.)
+ * since they're stored on GitHub itself.
  */
 
 /**
- * Manages branch-issue links using a pluggable storage adapter.
+ * Parse the linked branch from an issue body.
+ */
+declare function parseBranchLink(body: string | null | undefined): string | null;
+/**
+ * Set or update the branch link in an issue body.
+ * Returns the updated body string.
+ */
+declare function setBranchLinkInBody(body: string | null | undefined, branch: string): string;
+/**
+ * Remove the branch link from an issue body.
+ * Returns the updated body string.
+ */
+declare function removeBranchLinkFromBody(body: string | null | undefined): string;
+/**
+ * Manages branch-issue links stored in GitHub issue bodies.
  */
 declare class BranchLinker {
-    private storage;
-    constructor(storage: StorageAdapter);
-    /**
-     * Load links from storage (handles both sync and async adapters)
-     */
-    private loadLinks;
-    /**
-     * Save links to storage (handles both sync and async adapters)
-     */
-    private saveLinks;
+    private api;
+    constructor(api: GitHubAPI);
     /**
      * Create a link between a branch and an issue.
-     * If a link already exists for this branch or issue in this repo, it will be replaced.
-     */
-    link(branch: string, issueNumber: number, issueTitle: string, itemId: string, repo: string): Promise<void>;
-    /**
-     * Remove the link for an issue.
-     * @returns true if a link was removed, false if no link existed
+     * Stores the link as a hidden comment in the issue body.
      */
-    unlink(repo: string, issueNumber: number): Promise<boolean>;
+    link(repo: RepoInfo, issueNumber: number, branch: string): Promise<boolean>;
     /**
-     * Remove the link for a branch.
-     * @returns true if a link was removed, false if no link existed
+     * Remove the branch link from an issue.
      */
-    unlinkBranch(repo: string, branch: string): Promise<boolean>;
+    unlink(repo: RepoInfo, issueNumber: number): Promise<boolean>;
     /**
      * Get the branch linked to an issue.
      */
-    getBranchForIssue(repo: string, issueNumber: number): Promise<string | null>;
-    /**
-     * Get the full link info for a branch.
-     */
-    getLinkForBranch(repo: string, branch: string): Promise<BranchLink | null>;
+    getBranchForIssue(repo: RepoInfo, issueNumber: number): Promise<string | null>;
     /**
-     * Get the full link info for an issue.
+     * Check if an issue has a branch link.
      */
-    getLinkForIssue(repo: string, issueNumber: number): Promise<BranchLink | null>;
-    /**
-     * Get all links for a repository.
-     */
-    getLinksForRepo(repo: string): Promise<BranchLink[]>;
-    /**
-     * Get all links.
-     */
-    getAllLinks(): Promise<BranchLink[]>;
-    /**
-     * Check if a branch has a link.
-     */
-    hasLinkForBranch(repo: string, branch: string): Promise<boolean>;
-    /**
-     * Check if an issue has a link.
-     */
-    hasLinkForIssue(repo: string, issueNumber: number): Promise<boolean>;
+    hasLink(repo: RepoInfo, issueNumber: number): Promise<boolean>;
 }
-/**
- * Create an in-memory storage adapter for testing.
- */
-declare function createInMemoryAdapter(): StorageAdapter & {
-    links: BranchLink[];
-};
 
 /**
  * Git utility functions for working with local repositories.
@@ -862,6 +783,10 @@ declare const UPDATE_ISSUE_TYPE_MUTATION = "\n    mutation($issueId: ID!, $issue
  * Mutation to update issue body/description
  */
 declare const UPDATE_ISSUE_BODY_MUTATION = "\n    mutation($issueId: ID!, $body: String!) {\n        updateIssue(input: { id: $issueId, body: $body }) {\n            issue {\n                id\n            }\n        }\n    }\n";
+/**
+ * Mutation to update issue title and/or body
+ */
+declare const UPDATE_ISSUE_MUTATION = "\n    mutation($issueId: ID!, $title: String, $body: String) {\n        updateIssue(input: { id: $issueId, title: $title, body: $body }) {\n            issue {\n                id\n            }\n        }\n    }\n";
 
 declare const queries_ADD_COMMENT_MUTATION: typeof ADD_COMMENT_MUTATION;
 declare const queries_ADD_LABELS_MUTATION: typeof ADD_LABELS_MUTATION;
@@ -883,12 +808,13 @@ declare const queries_REMOVE_LABELS_MUTATION: typeof REMOVE_LABELS_MUTATION;
 declare const queries_REPOSITORY_ID_QUERY: typeof REPOSITORY_ID_QUERY;
 declare const queries_REPOSITORY_PROJECTS_QUERY: typeof REPOSITORY_PROJECTS_QUERY;
 declare const queries_UPDATE_ISSUE_BODY_MUTATION: typeof UPDATE_ISSUE_BODY_MUTATION;
+declare const queries_UPDATE_ISSUE_MUTATION: typeof UPDATE_ISSUE_MUTATION;
 declare const queries_UPDATE_ISSUE_TYPE_MUTATION: typeof UPDATE_ISSUE_TYPE_MUTATION;
 declare const queries_UPDATE_ITEM_FIELD_MUTATION: typeof UPDATE_ITEM_FIELD_MUTATION;
 declare const queries_UPDATE_ITEM_STATUS_MUTATION: typeof UPDATE_ITEM_STATUS_MUTATION;
 declare const queries_VIEWER_QUERY: typeof VIEWER_QUERY;
 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_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 { 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, type BranchLink, BranchLinker, type Collaborator, 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 SingleSelectFieldValue, type StatusField, type StorageAdapter, type TextFieldValue, type TokenProvider, branchExists, buildIssueUrl, buildOrgProjectUrl, buildProjectUrl, buildPullRequestUrl, buildRepoUrl, checkoutBranch, createBranch, createInMemoryAdapter, detectRepository, fetchOrigin, generateBranchName, getCommitsAhead, getCommitsBehind, getCurrentBranch, getDefaultBranch, getRepositoryRoot, hasUncommittedChanges, isGitRepository, parseGitHubUrl, parseIssueUrl, pullLatest, queries, sanitizeForBranchName };
+export { type AssigneeInfo, type AuthError, BranchLinker, type Collaborator, 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 SingleSelectFieldValue, type StatusField, type TextFieldValue, type TokenProvider, branchExists, buildIssueUrl, buildOrgProjectUrl, buildProjectUrl, buildPullRequestUrl, buildRepoUrl, checkoutBranch, createBranch, detectRepository, fetchOrigin, generateBranchName, getCommitsAhead, getCommitsBehind, getCurrentBranch, getDefaultBranch, getRepositoryRoot, hasUncommittedChanges, isGitRepository, parseBranchLink, parseGitHubUrl, parseIssueUrl, pullLatest, queries, removeBranchLinkFromBody, sanitizeForBranchName, setBranchLinkInBody };

package/dist/index.d.ts

@@ -29,25 +29,6 @@ interface AuthError extends Error {
     requiredScopes?: string[];
     ssoUrl?: string;
 }
-/**
- * Interface for persisting branch-issue links.
- * Implement this for different storage backends (file system, VSCode state, etc.)
- */
-interface StorageAdapter {
-    load(): BranchLink[] | Promise<BranchLink[]>;
-    save(links: BranchLink[]): void | Promise<void>;
-}
-/**
- * A link between a git branch and a GitHub issue/item
- */
-interface BranchLink {
-    branch: string;
-    issueNumber: number;
-    issueTitle: string;
-    itemId: string;
-    repo: string;
-    linkedAt: string;
-}
 /**
  * Options for git operations
  */
@@ -517,123 +498,63 @@ declare class GitHubAPI {
      * Update an issue's body/description
      */
     updateIssueBody(repo: RepoInfo, issueNumber: number, body: string): Promise<boolean>;
+    /**
+     * Update an issue's title and/or body
+     */
+    updateIssue(repo: RepoInfo, issueNumber: number, updates: {
+        title?: string;
+        body?: string;
+    }): Promise<boolean>;
 }
 
 /**
- * Branch-issue linking with pluggable storage.
- *
- * The BranchLinker class manages associations between git branches and GitHub issues.
- * Storage is abstracted via the StorageAdapter interface, allowing different backends:
- * - File system (for CLI)
- * - VSCode workspaceState (for extensions)
- * - In-memory (for testing)
- *
- * @example CLI usage with file storage:
- * ```typescript
- * import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
- * import { homedir } from 'os';
- * import { join } from 'path';
+ * Branch-issue linking stored directly in GitHub issue bodies.
  *
- * const DATA_DIR = join(homedir(), '.config', 'ghp-cli');
- * const LINKS_FILE = join(DATA_DIR, 'branch-links.json');
+ * Links are stored as hidden HTML comments in the issue body:
+ * <!-- ghp-branch: feature/my-branch -->
  *
- * const fileAdapter: StorageAdapter = {
- *   load() {
- *     if (existsSync(LINKS_FILE)) {
- *       return JSON.parse(readFileSync(LINKS_FILE, 'utf-8'));
- *     }
- *     return [];
- *   },
- *   save(links) {
- *     if (!existsSync(DATA_DIR)) {
- *       mkdirSync(DATA_DIR, { recursive: true });
- *     }
- *     writeFileSync(LINKS_FILE, JSON.stringify(links, null, 2));
- *   }
- * };
- *
- * const linker = new BranchLinker(fileAdapter);
- * ```
- *
- * @example VSCode usage with workspaceState:
- * ```typescript
- * const vscodeAdapter: StorageAdapter = {
- *   load() {
- *     return context.workspaceState.get<BranchLink[]>('branchLinks', []);
- *   },
- *   save(links) {
- *     context.workspaceState.update('branchLinks', links);
- *   }
- * };
- *
- * const linker = new BranchLinker(vscodeAdapter);
- * ```
+ * This allows branch links to be shared across all consumers (CLI, VSCode, etc.)
+ * since they're stored on GitHub itself.
  */
 
 /**
- * Manages branch-issue links using a pluggable storage adapter.
+ * Parse the linked branch from an issue body.
+ */
+declare function parseBranchLink(body: string | null | undefined): string | null;
+/**
+ * Set or update the branch link in an issue body.
+ * Returns the updated body string.
+ */
+declare function setBranchLinkInBody(body: string | null | undefined, branch: string): string;
+/**
+ * Remove the branch link from an issue body.
+ * Returns the updated body string.
+ */
+declare function removeBranchLinkFromBody(body: string | null | undefined): string;
+/**
+ * Manages branch-issue links stored in GitHub issue bodies.
  */
 declare class BranchLinker {
-    private storage;
-    constructor(storage: StorageAdapter);
-    /**
-     * Load links from storage (handles both sync and async adapters)
-     */
-    private loadLinks;
-    /**
-     * Save links to storage (handles both sync and async adapters)
-     */
-    private saveLinks;
+    private api;
+    constructor(api: GitHubAPI);
     /**
      * Create a link between a branch and an issue.
-     * If a link already exists for this branch or issue in this repo, it will be replaced.
-     */
-    link(branch: string, issueNumber: number, issueTitle: string, itemId: string, repo: string): Promise<void>;
-    /**
-     * Remove the link for an issue.
-     * @returns true if a link was removed, false if no link existed
+     * Stores the link as a hidden comment in the issue body.
      */
-    unlink(repo: string, issueNumber: number): Promise<boolean>;
+    link(repo: RepoInfo, issueNumber: number, branch: string): Promise<boolean>;
     /**
-     * Remove the link for a branch.
-     * @returns true if a link was removed, false if no link existed
+     * Remove the branch link from an issue.
      */
-    unlinkBranch(repo: string, branch: string): Promise<boolean>;
+    unlink(repo: RepoInfo, issueNumber: number): Promise<boolean>;
     /**
      * Get the branch linked to an issue.
      */
-    getBranchForIssue(repo: string, issueNumber: number): Promise<string | null>;
-    /**
-     * Get the full link info for a branch.
-     */
-    getLinkForBranch(repo: string, branch: string): Promise<BranchLink | null>;
+    getBranchForIssue(repo: RepoInfo, issueNumber: number): Promise<string | null>;
     /**
-     * Get the full link info for an issue.
+     * Check if an issue has a branch link.
      */
-    getLinkForIssue(repo: string, issueNumber: number): Promise<BranchLink | null>;
-    /**
-     * Get all links for a repository.
-     */
-    getLinksForRepo(repo: string): Promise<BranchLink[]>;
-    /**
-     * Get all links.
-     */
-    getAllLinks(): Promise<BranchLink[]>;
-    /**
-     * Check if a branch has a link.
-     */
-    hasLinkForBranch(repo: string, branch: string): Promise<boolean>;
-    /**
-     * Check if an issue has a link.
-     */
-    hasLinkForIssue(repo: string, issueNumber: number): Promise<boolean>;
+    hasLink(repo: RepoInfo, issueNumber: number): Promise<boolean>;
 }
-/**
- * Create an in-memory storage adapter for testing.
- */
-declare function createInMemoryAdapter(): StorageAdapter & {
-    links: BranchLink[];
-};
 
 /**
  * Git utility functions for working with local repositories.
@@ -862,6 +783,10 @@ declare const UPDATE_ISSUE_TYPE_MUTATION = "\n    mutation($issueId: ID!, $issue
  * Mutation to update issue body/description
  */
 declare const UPDATE_ISSUE_BODY_MUTATION = "\n    mutation($issueId: ID!, $body: String!) {\n        updateIssue(input: { id: $issueId, body: $body }) {\n            issue {\n                id\n            }\n        }\n    }\n";
+/**
+ * Mutation to update issue title and/or body
+ */
+declare const UPDATE_ISSUE_MUTATION = "\n    mutation($issueId: ID!, $title: String, $body: String) {\n        updateIssue(input: { id: $issueId, title: $title, body: $body }) {\n            issue {\n                id\n            }\n        }\n    }\n";
 
 declare const queries_ADD_COMMENT_MUTATION: typeof ADD_COMMENT_MUTATION;
 declare const queries_ADD_LABELS_MUTATION: typeof ADD_LABELS_MUTATION;
@@ -883,12 +808,13 @@ declare const queries_REMOVE_LABELS_MUTATION: typeof REMOVE_LABELS_MUTATION;
 declare const queries_REPOSITORY_ID_QUERY: typeof REPOSITORY_ID_QUERY;
 declare const queries_REPOSITORY_PROJECTS_QUERY: typeof REPOSITORY_PROJECTS_QUERY;
 declare const queries_UPDATE_ISSUE_BODY_MUTATION: typeof UPDATE_ISSUE_BODY_MUTATION;
+declare const queries_UPDATE_ISSUE_MUTATION: typeof UPDATE_ISSUE_MUTATION;
 declare const queries_UPDATE_ISSUE_TYPE_MUTATION: typeof UPDATE_ISSUE_TYPE_MUTATION;
 declare const queries_UPDATE_ITEM_FIELD_MUTATION: typeof UPDATE_ITEM_FIELD_MUTATION;
 declare const queries_UPDATE_ITEM_STATUS_MUTATION: typeof UPDATE_ITEM_STATUS_MUTATION;
 declare const queries_VIEWER_QUERY: typeof VIEWER_QUERY;
 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_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 { 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, type BranchLink, BranchLinker, type Collaborator, 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 SingleSelectFieldValue, type StatusField, type StorageAdapter, type TextFieldValue, type TokenProvider, branchExists, buildIssueUrl, buildOrgProjectUrl, buildProjectUrl, buildPullRequestUrl, buildRepoUrl, checkoutBranch, createBranch, createInMemoryAdapter, detectRepository, fetchOrigin, generateBranchName, getCommitsAhead, getCommitsBehind, getCurrentBranch, getDefaultBranch, getRepositoryRoot, hasUncommittedChanges, isGitRepository, parseGitHubUrl, parseIssueUrl, pullLatest, queries, sanitizeForBranchName };
+export { type AssigneeInfo, type AuthError, BranchLinker, type Collaborator, 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 SingleSelectFieldValue, type StatusField, type TextFieldValue, type TokenProvider, branchExists, buildIssueUrl, buildOrgProjectUrl, buildProjectUrl, buildPullRequestUrl, buildRepoUrl, checkoutBranch, createBranch, detectRepository, fetchOrigin, generateBranchName, getCommitsAhead, getCommitsBehind, getCurrentBranch, getDefaultBranch, getRepositoryRoot, hasUncommittedChanges, isGitRepository, parseBranchLink, parseGitHubUrl, parseIssueUrl, pullLatest, queries, removeBranchLinkFromBody, sanitizeForBranchName, setBranchLinkInBody };

package/dist/index.js

@@ -30,6 +30,7 @@ __export(queries_exports, {
   REPOSITORY_ID_QUERY: () => REPOSITORY_ID_QUERY,
   REPOSITORY_PROJECTS_QUERY: () => REPOSITORY_PROJECTS_QUERY,
   UPDATE_ISSUE_BODY_MUTATION: () => UPDATE_ISSUE_BODY_MUTATION,
+  UPDATE_ISSUE_MUTATION: () => UPDATE_ISSUE_MUTATION,
   UPDATE_ISSUE_TYPE_MUTATION: () => UPDATE_ISSUE_TYPE_MUTATION,
   UPDATE_ITEM_FIELD_MUTATION: () => UPDATE_ITEM_FIELD_MUTATION,
   UPDATE_ITEM_STATUS_MUTATION: () => UPDATE_ITEM_STATUS_MUTATION,
@@ -385,6 +386,15 @@ var UPDATE_ISSUE_BODY_MUTATION = `
         }
     }
 `;
+var UPDATE_ISSUE_MUTATION = `
+    mutation($issueId: ID!, $title: String, $body: String) {
+        updateIssue(input: { id: $issueId, title: $title, body: $body }) {
+            issue {
+                id
+            }
+        }
+    }
+`;
 
 // src/github-api.ts
 function createAuthError(message, type, details) {
@@ -923,141 +933,94 @@ var GitHubAPI = class {
       return false;
     }
   }
+  /**
+   * Update an issue's title and/or body
+   */
+  async updateIssue(repo, issueNumber, updates) {
+    if (!this.graphqlWithAuth) throw new Error("Not authenticated");
+    try {
+      const issueResponse = await this.graphqlWithAuth(ISSUE_FOR_UPDATE_QUERY, {
+        owner: repo.owner,
+        name: repo.name,
+        number: issueNumber
+      });
+      if (!issueResponse.repository.issue) {
+        return false;
+      }
+      await this.graphqlWithAuth(UPDATE_ISSUE_MUTATION, {
+        issueId: issueResponse.repository.issue.id,
+        title: updates.title,
+        body: updates.body
+      });
+      return true;
+    } catch {
+      return false;
+    }
+  }
 };
 
 // src/branch-linker.ts
-var BranchLinker = class {
-  storage;
-  constructor(storage) {
-    this.storage = storage;
-  }
-  /**
-   * Load links from storage (handles both sync and async adapters)
-   */
-  async loadLinks() {
-    const result = this.storage.load();
-    return result instanceof Promise ? await result : result;
+var BRANCH_LINK_PATTERN = /<!--\s*ghp-branch:\s*(.+?)\s*-->/;
+function parseBranchLink(body) {
+  if (!body) return null;
+  const match = body.match(BRANCH_LINK_PATTERN);
+  return match ? match[1].trim() : null;
+}
+function setBranchLinkInBody(body, branch) {
+  const currentBody = body || "";
+  const tag = `<!-- ghp-branch: ${branch} -->`;
+  if (BRANCH_LINK_PATTERN.test(currentBody)) {
+    return currentBody.replace(BRANCH_LINK_PATTERN, tag);
+  } else {
+    return currentBody.trim() + "\n\n" + tag;
   }
-  /**
-   * Save links to storage (handles both sync and async adapters)
-   */
-  async saveLinks(links) {
-    const result = this.storage.save(links);
-    if (result instanceof Promise) {
-      await result;
-    }
+}
+function removeBranchLinkFromBody(body) {
+  if (!body) return "";
+  return body.replace(BRANCH_LINK_PATTERN, "").trim();
+}
+var BranchLinker = class {
+  api;
+  constructor(api) {
+    this.api = api;
   }
   /**
    * Create a link between a branch and an issue.
-   * If a link already exists for this branch or issue in this repo, it will be replaced.
+   * Stores the link as a hidden comment in the issue body.
    */
-  async link(branch, issueNumber, issueTitle, itemId, repo) {
-    const links = await this.loadLinks();
-    const filtered = links.filter(
-      (l) => !(l.repo === repo && (l.branch === branch || l.issueNumber === issueNumber))
-    );
-    filtered.push({
-      branch,
-      issueNumber,
-      issueTitle,
-      itemId,
-      repo,
-      linkedAt: (/* @__PURE__ */ new Date()).toISOString()
-    });
-    await this.saveLinks(filtered);
+  async link(repo, issueNumber, branch) {
+    const details = await this.api.getIssueDetails(repo, issueNumber);
+    if (!details) return false;
+    const newBody = setBranchLinkInBody(details.body, branch);
+    return this.api.updateIssueBody(repo, issueNumber, newBody);
   }
   /**
-   * Remove the link for an issue.
-   * @returns true if a link was removed, false if no link existed
+   * Remove the branch link from an issue.
    */
   async unlink(repo, issueNumber) {
-    const links = await this.loadLinks();
-    const filtered = links.filter(
-      (l) => !(l.repo === repo && l.issueNumber === issueNumber)
-    );
-    if (filtered.length === links.length) {
-      return false;
-    }
-    await this.saveLinks(filtered);
-    return true;
-  }
-  /**
-   * Remove the link for a branch.
-   * @returns true if a link was removed, false if no link existed
-   */
-  async unlinkBranch(repo, branch) {
-    const links = await this.loadLinks();
-    const filtered = links.filter(
-      (l) => !(l.repo === repo && l.branch === branch)
-    );
-    if (filtered.length === links.length) {
-      return false;
-    }
-    await this.saveLinks(filtered);
-    return true;
+    const details = await this.api.getIssueDetails(repo, issueNumber);
+    if (!details) return false;
+    const currentBranch = parseBranchLink(details.body);
+    if (!currentBranch) return false;
+    const newBody = removeBranchLinkFromBody(details.body);
+    return this.api.updateIssueBody(repo, issueNumber, newBody);
   }
   /**
    * Get the branch linked to an issue.
    */
   async getBranchForIssue(repo, issueNumber) {
-    const links = await this.loadLinks();
-    const link = links.find((l) => l.repo === repo && l.issueNumber === issueNumber);
-    return link?.branch || null;
+    const details = await this.api.getIssueDetails(repo, issueNumber);
+    if (!details) return null;
+    return parseBranchLink(details.body);
   }
   /**
-   * Get the full link info for a branch.
+   * Check if an issue has a branch link.
    */
-  async getLinkForBranch(repo, branch) {
-    const links = await this.loadLinks();
-    return links.find((l) => l.repo === repo && l.branch === branch) || null;
-  }
-  /**
-   * Get the full link info for an issue.
-   */
-  async getLinkForIssue(repo, issueNumber) {
-    const links = await this.loadLinks();
-    return links.find((l) => l.repo === repo && l.issueNumber === issueNumber) || null;
-  }
-  /**
-   * Get all links for a repository.
-   */
-  async getLinksForRepo(repo) {
-    const links = await this.loadLinks();
-    return links.filter((l) => l.repo === repo);
-  }
-  /**
-   * Get all links.
-   */
-  async getAllLinks() {
-    return this.loadLinks();
-  }
-  /**
-   * Check if a branch has a link.
-   */
-  async hasLinkForBranch(repo, branch) {
-    const link = await this.getLinkForBranch(repo, branch);
-    return link !== null;
-  }
-  /**
-   * Check if an issue has a link.
-   */
-  async hasLinkForIssue(repo, issueNumber) {
-    const link = await this.getLinkForIssue(repo, issueNumber);
-    return link !== null;
+  async hasLink(repo, issueNumber) {
+    const branch = await this.getBranchForIssue(repo, issueNumber);
+    return branch !== null;
   }
 };
-function createInMemoryAdapter() {
-  const adapter = {
-    links: [],
-    load() {
-      return [...this.links];
-    },
-    save(links) {
-      this.links = [...links];
-    }
-  };
-  return adapter;
-}
 
 // src/git-utils.ts
 import { exec } from "child_process";
@@ -1244,7 +1207,6 @@ export {
   buildRepoUrl,
   checkoutBranch,
   createBranch,
-  createInMemoryAdapter,
   detectRepository,
   fetchOrigin,
   generateBranchName,
@@ -1255,9 +1217,12 @@ export {
   getRepositoryRoot,
   hasUncommittedChanges,
   isGitRepository,
+  parseBranchLink,
   parseGitHubUrl,
   parseIssueUrl,
   pullLatest,
   queries_exports as queries,
-  sanitizeForBranchName
+  removeBranchLinkFromBody,
+  sanitizeForBranchName,
+  setBranchLinkInBody
 };

package/package.json

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