@bretwardjames/ghp-core 0.1.2 → 0.1.4

package/README.md

@@ -0,0 +1,123 @@
+# GHP Tools
+
+A suite of tools for managing GitHub Projects from your terminal and editor.
+
+## What's Included
+
+| Package | Description |
+|---------|-------------|
+| **[@bretwardjames/ghp-cli](https://github.com/bretwardjames/ghp-cli)** | Command-line interface for GitHub Projects |
+| **[vscode-gh-projects](https://github.com/bretwardjames/vscode-gh-projects)** | VS Code / Cursor extension with visual boards |
+| **@bretwardjames/ghp-core** | Shared library (this package) |
+
+Both the CLI and extension share the same underlying library and are designed to work together.
+
+## Quick Install
+
+Install both the CLI and VS Code/Cursor extension with a single command:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/bretwardjames/ghp-core/main/install.sh | bash
+```
+
+This will:
+1. Install the `ghp` CLI globally via npm
+2. Install the VS Code/Cursor extension from the latest release
+
+### Manual Installation
+
+**CLI only:**
+```bash
+npm install -g @bretwardjames/ghp-cli
+```
+
+**Extension only:**
+Download the `.vsix` from [releases](https://github.com/bretwardjames/vscode-gh-projects/releases) and install:
+```bash
+code --install-extension gh-projects-*.vsix
+# or for Cursor:
+cursor --install-extension gh-projects-*.vsix
+```
+
+## Getting Started
+
+1. Authenticate with GitHub:
+   ```bash
+   ghp auth
+   ```
+
+2. View your assigned work:
+   ```bash
+   ghp work
+   ```
+
+3. Open VS Code/Cursor and find the GitHub Projects panel in the sidebar
+
+## Features
+
+### Shared Across Both Tools
+
+- **Branch Linking** - Link branches to issues, track which issues have active work
+- **Workflow Automation** - "Start Working" creates branches and updates status
+- **Project Board Views** - See your boards exactly as configured on GitHub
+- **Issue Templates** - Create issues using your repo's templates
+
+### CLI-Specific
+
+- **Shortcuts** - Define named filter combinations (`ghp plan bugs`)
+- **Slice Filters** - Filter by any field (`--slice Priority=High`)
+- **Workspace Config** - Share settings with your team via `.ghp/config.json`
+- **Simple List Output** - Integration with fzf, rofi, and other pickers
+
+### Extension-Specific
+
+- **Drag and Drop** - Move issues between columns visually
+- **Planning Board** - Full-screen kanban view
+- **Multi-Select** - Bulk operations on multiple items
+- **Real-Time Sync** - Stay in sync with GitHub
+
+## Configuration
+
+Both tools share the same configuration concepts. The CLI uses JSON files, the extension uses VS Code settings.
+
+### CLI Configuration (ghp-cli)
+
+```bash
+# View all settings with their sources
+ghp config --show
+
+# Edit user config (opens $EDITOR)
+ghp config
+
+# Edit workspace config (shared with team)
+ghp config -w
+
+# Set individual value
+ghp config mainBranch develop
+```
+
+**Config files:**
+- User: `~/.config/ghp-cli/config.json` (personal overrides)
+- Workspace: `.ghp/config.json` (committed, shared with team)
+
+Merge order: defaults -> workspace -> user
+
+### Extension Configuration (VS Code)
+
+Settings are in VS Code's settings UI under "GitHub Projects", or in your workspace `.vscode/settings.json`.
+
+## Links
+
+- [ghp-cli Documentation](https://github.com/bretwardjames/ghp-cli)
+- [VS Code Extension Documentation](https://github.com/bretwardjames/vscode-gh-projects)
+- [Report Issues](https://github.com/bretwardjames/ghp-core/issues)
+
+## Requirements
+
+- Node.js >= 18
+- GitHub account with Projects access
+- VS Code 1.85+ or Cursor (for extension)
+
+## License
+
+MIT

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);
 
@@ -1005,138 +1007,67 @@ var GitHubAPI = class {
 };
 
 // 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;
-  }
-  /**
-   * Get the full link info for a branch.
-   */
-  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();
+    const details = await this.api.getIssueDetails(repo, issueNumber);
+    if (!details) return null;
+    return parseBranchLink(details.body);
   }
   /**
-   * Check if a branch has a link.
+   * Check if an issue has a branch 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");
@@ -1324,7 +1255,6 @@ async function getDefaultBranch(options = {}) {
   buildRepoUrl,
   checkoutBranch,
   createBranch,
-  createInMemoryAdapter,
   detectRepository,
   fetchOrigin,
   generateBranchName,
@@ -1335,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
  */
@@ -527,120 +508,53 @@ declare class GitHubAPI {
 }
 
 /**
- * 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.
+     * Stores the link as a hidden comment in the issue body.
      */
-    link(branch: string, issueNumber: number, issueTitle: string, itemId: string, repo: string): Promise<void>;
+    link(repo: RepoInfo, issueNumber: number, branch: string): Promise<boolean>;
     /**
-     * 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.
      */
-    unlink(repo: string, issueNumber: number): Promise<boolean>;
-    /**
-     * Remove the link for a branch.
-     * @returns true if a link was removed, false if no link existed
-     */
-    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>;
+    getBranchForIssue(repo: RepoInfo, issueNumber: number): Promise<string | null>;
     /**
-     * Get the full link info for a branch.
+     * Check if an issue has a branch link.
      */
-    getLinkForBranch(repo: string, branch: string): Promise<BranchLink | null>;
-    /**
-     * Get the full link info for an issue.
-     */
-    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.
@@ -903,4 +817,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, 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
  */
@@ -527,120 +508,53 @@ declare class GitHubAPI {
 }
 
 /**
- * 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.
+     * Stores the link as a hidden comment in the issue body.
      */
-    link(branch: string, issueNumber: number, issueTitle: string, itemId: string, repo: string): Promise<void>;
+    link(repo: RepoInfo, issueNumber: number, branch: string): Promise<boolean>;
     /**
-     * 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.
      */
-    unlink(repo: string, issueNumber: number): Promise<boolean>;
-    /**
-     * Remove the link for a branch.
-     * @returns true if a link was removed, false if no link existed
-     */
-    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>;
+    getBranchForIssue(repo: RepoInfo, issueNumber: number): Promise<string | null>;
     /**
-     * Get the full link info for a branch.
+     * Check if an issue has a branch link.
      */
-    getLinkForBranch(repo: string, branch: string): Promise<BranchLink | null>;
-    /**
-     * Get the full link info for an issue.
-     */
-    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.
@@ -903,4 +817,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, 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

@@ -960,138 +960,67 @@ var GitHubAPI = class {
 };
 
 // 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;
-  }
-  /**
-   * Get the full link info for a branch.
-   */
-  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();
+    const details = await this.api.getIssueDetails(repo, issueNumber);
+    if (!details) return null;
+    return parseBranchLink(details.body);
   }
   /**
-   * Check if a branch has a link.
+   * Check if an issue has a branch 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";
@@ -1278,7 +1207,6 @@ export {
   buildRepoUrl,
   checkoutBranch,
   createBranch,
-  createInMemoryAdapter,
   detectRepository,
   fetchOrigin,
   generateBranchName,
@@ -1289,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.2",
+  "version": "0.1.4",
   "description": "Shared core library for GitHub Projects tools",
   "main": "dist/index.cjs",
   "module": "dist/index.js",