@bretwardjames/ghp-core 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,885 @@
+/**
+ * Core types for GitHub Projects V2 API
+ *
+ * This module provides both:
+ * - Raw GraphQL response types (ProjectV2, ProjectV2Item, etc.) for full API access
+ * - Normalized types (ProjectItem, Project) for simplified usage
+ */
+/**
+ * Interface for providing authentication tokens.
+ * Implement this to integrate with different auth systems (CLI, VSCode, etc.)
+ */
+interface TokenProvider {
+    getToken(): Promise<string | null>;
+}
+/**
+ * Options for GitHubAPI constructor
+ */
+interface GitHubAPIOptions {
+    /** Provider for authentication tokens */
+    tokenProvider: TokenProvider;
+    /** Callback for authentication errors (scope issues, SSO, etc.) */
+    onAuthError?: (error: AuthError) => void;
+}
+/**
+ * Authentication error with details about what went wrong
+ */
+interface AuthError extends Error {
+    type: 'INSUFFICIENT_SCOPES' | 'SSO_REQUIRED' | 'TOKEN_EXPIRED' | 'UNKNOWN';
+    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
+ */
+interface GitOptions {
+    /** Working directory for git commands. Defaults to process.cwd() */
+    cwd?: string;
+}
+/**
+ * Information about a GitHub repository
+ */
+interface RepoInfo {
+    owner: string;
+    name: string;
+    fullName: string;
+}
+/**
+ * A simplified project representation
+ */
+interface Project {
+    id: string;
+    title: string;
+    number: number;
+    url: string;
+}
+/**
+ * A normalized project item for display purposes
+ */
+interface ProjectItem {
+    id: string;
+    title: string;
+    number: number | null;
+    type: 'issue' | 'pull_request' | 'draft';
+    issueType: string | null;
+    status: string | null;
+    statusIndex: number;
+    state: 'open' | 'closed' | 'merged' | null;
+    assignees: string[];
+    labels: Array<{
+        name: string;
+        color: string;
+    }>;
+    repository: string | null;
+    url: string | null;
+    projectId: string;
+    projectTitle: string;
+    fields: Record<string, string>;
+}
+/**
+ * Status field information for a project
+ */
+interface StatusField {
+    fieldId: string;
+    options: Array<{
+        id: string;
+        name: string;
+    }>;
+}
+/**
+ * Full issue details including body and comments
+ */
+interface IssueDetails {
+    title: string;
+    body: string;
+    state: string;
+    type: 'issue' | 'pull_request';
+    createdAt: string;
+    author: string;
+    labels: Array<{
+        name: string;
+        color: string;
+    }>;
+    comments: Array<{
+        author: string;
+        body: string;
+        createdAt: string;
+    }>;
+    totalComments: number;
+}
+/**
+ * A repository collaborator
+ */
+interface Collaborator {
+    login: string;
+    name: string | null;
+}
+/**
+ * An issue reference (for autocomplete)
+ */
+interface IssueReference {
+    number: number;
+    title: string;
+    state: string;
+}
+/**
+ * Raw GitHub Project V2 from GraphQL
+ */
+interface ProjectV2 {
+    id: string;
+    title: string;
+    number: number;
+    url: string;
+    closed?: boolean;
+    shortDescription?: string | null;
+    owner?: {
+        login: string;
+        __typename: 'User' | 'Organization';
+    };
+    fields?: {
+        nodes: ProjectV2Field[];
+    };
+}
+/**
+ * A field in a GitHub Project V2
+ */
+interface ProjectV2Field {
+    __typename: string;
+    id: string;
+    name: string;
+    options?: Array<{
+        id: string;
+        name: string;
+        color?: string;
+    }>;
+}
+/**
+ * A saved view in a GitHub Project (Board, Table, or Roadmap layout)
+ */
+interface ProjectV2View {
+    id: string;
+    name: string;
+    number: number;
+    layout: 'BOARD_LAYOUT' | 'TABLE_LAYOUT' | 'ROADMAP_LAYOUT';
+    groupByFields?: {
+        nodes: Array<{
+            __typename: string;
+            id: string;
+            name: string;
+            options?: Array<{
+                id: string;
+                name: string;
+                color?: string;
+            }>;
+        }>;
+    };
+    verticalGroupByFields?: {
+        nodes: Array<{
+            __typename: string;
+            id: string;
+            name: string;
+        }>;
+    };
+    sortByFields?: {
+        nodes: Array<{
+            __typename: string;
+            field: {
+                id: string;
+                name: string;
+            };
+            direction: 'ASC' | 'DESC';
+        }>;
+    };
+    filter?: string | null;
+}
+/**
+ * Extended project info with views and fields
+ */
+interface ProjectWithViews extends ProjectV2 {
+    views: ProjectV2View[];
+    fields: {
+        nodes: ProjectV2Field[];
+    };
+}
+/**
+ * Raw project item from GraphQL
+ */
+interface ProjectV2Item {
+    id: string;
+    type: 'ISSUE' | 'PULL_REQUEST' | 'DRAFT_ISSUE';
+    content: ProjectItemContent | null;
+    fieldValues: FieldValueConnection;
+}
+/**
+ * Content of a project item (Issue, PR, or Draft)
+ */
+interface ProjectItemContent {
+    __typename: 'Issue' | 'PullRequest' | 'DraftIssue';
+    title: string;
+    number?: number;
+    url?: string;
+    state?: 'OPEN' | 'CLOSED' | 'MERGED';
+    merged?: boolean;
+    issueType?: {
+        name: string;
+    } | null;
+    repository?: {
+        name: string;
+        owner?: {
+            login: string;
+        };
+    };
+    assignees?: {
+        nodes: Array<{
+            login: string;
+            avatarUrl?: string;
+        }>;
+    };
+    labels?: {
+        nodes: Array<{
+            name: string;
+            color: string;
+        }>;
+    };
+}
+/**
+ * Connection wrapper for field values
+ */
+interface FieldValueConnection {
+    nodes: FieldValue[];
+}
+/**
+ * Union type for all field value types
+ */
+type FieldValue = SingleSelectFieldValue | TextFieldValue | DateFieldValue | NumberFieldValue | IterationFieldValue;
+interface SingleSelectFieldValue {
+    __typename: 'ProjectV2ItemFieldSingleSelectValue';
+    name: string;
+    field: {
+        name: string;
+    };
+}
+interface TextFieldValue {
+    __typename: 'ProjectV2ItemFieldTextValue';
+    text: string;
+    field: {
+        name: string;
+    };
+}
+interface DateFieldValue {
+    __typename: 'ProjectV2ItemFieldDateValue';
+    date: string;
+    field: {
+        name: string;
+    };
+}
+interface NumberFieldValue {
+    __typename: 'ProjectV2ItemFieldNumberValue';
+    number: number;
+    field: {
+        name: string;
+    };
+}
+interface IterationFieldValue {
+    __typename: 'ProjectV2ItemFieldIterationValue';
+    title: string;
+    startDate: string;
+    duration: number;
+    field: {
+        name: string;
+    };
+}
+interface ProjectsQueryResponse {
+    viewer: {
+        login: string;
+        projectsV2: {
+            nodes: ProjectV2[];
+        };
+    };
+}
+interface ProjectItemsQueryResponse {
+    node: {
+        items: {
+            pageInfo: {
+                hasNextPage: boolean;
+                endCursor: string | null;
+            };
+            nodes: ProjectV2Item[];
+        };
+    };
+}
+/**
+ * Configuration for connecting to a GitHub Project
+ */
+interface ProjectConfig {
+    owner: string;
+    projectNumber: number;
+    type: 'user' | 'organization';
+}
+/**
+ * Label information with optional color
+ */
+interface LabelInfo {
+    name: string;
+    color: string | null;
+}
+/**
+ * Field information with value and color
+ */
+interface FieldInfo {
+    value: string;
+    color: string | null;
+}
+/**
+ * Assignee information
+ */
+interface AssigneeInfo {
+    login: string;
+    avatarUrl: string | null;
+}
+
+/**
+ * GitHub API client for Projects V2.
+ *
+ * This class is auth-agnostic - it uses a TokenProvider interface to get
+ * authentication tokens, making it work with both CLI and IDE environments.
+ *
+ * @example CLI usage:
+ * ```typescript
+ * const api = new GitHubAPI({
+ *   tokenProvider: {
+ *     async getToken() {
+ *       const { stdout } = await exec('gh auth token');
+ *       return stdout.trim();
+ *     }
+ *   },
+ *   onAuthError: (err) => { console.error(err.message); process.exit(1); }
+ * });
+ * ```
+ *
+ * @example VSCode usage:
+ * ```typescript
+ * const api = new GitHubAPI({
+ *   tokenProvider: {
+ *     async getToken() {
+ *       const session = await vscode.authentication.getSession('github', ['project']);
+ *       return session?.accessToken ?? null;
+ *     }
+ *   }
+ * });
+ * ```
+ */
+
+declare class GitHubAPI {
+    private graphqlWithAuth;
+    private tokenProvider;
+    private onAuthError?;
+    username: string | null;
+    constructor(options: GitHubAPIOptions);
+    /**
+     * Handle authentication errors by calling the error handler or throwing
+     */
+    private handleAuthError;
+    /**
+     * Authenticate with GitHub using the token provider
+     */
+    authenticate(): Promise<boolean>;
+    get isAuthenticated(): boolean;
+    /**
+     * Get the current token (for REST API calls)
+     */
+    getToken(): Promise<string | null>;
+    /**
+     * Get projects linked to a repository
+     */
+    getProjects(repo: RepoInfo): Promise<Project[]>;
+    /**
+     * Get items from a project
+     */
+    getProjectItems(projectId: string, projectTitle: string): Promise<ProjectItem[]>;
+    /**
+     * Get the Status field info for a project
+     */
+    getStatusField(projectId: string): Promise<StatusField | null>;
+    /**
+     * Get project views
+     */
+    getProjectViews(projectId: string): Promise<Array<{
+        name: string;
+        filter: string | null;
+    }>>;
+    /**
+     * Update an item's status
+     */
+    updateItemStatus(projectId: string, itemId: string, fieldId: string, optionId: string): Promise<boolean>;
+    /**
+     * Find an item by issue number across all projects for this repo
+     */
+    findItemByNumber(repo: RepoInfo, issueNumber: number): Promise<ProjectItem | null>;
+    /**
+     * Get all fields for a project
+     */
+    getProjectFields(projectId: string): Promise<Array<{
+        id: string;
+        name: string;
+        type: string;
+        options?: Array<{
+            id: string;
+            name: string;
+        }>;
+    }>>;
+    /**
+     * Set a field value on a project item
+     */
+    setFieldValue(projectId: string, itemId: string, fieldId: string, value: {
+        text?: string;
+        number?: number;
+        singleSelectOptionId?: string;
+    }): Promise<boolean>;
+    /**
+     * Create a new issue
+     */
+    createIssue(repo: RepoInfo, title: string, body?: string): Promise<{
+        id: string;
+        number: number;
+    } | null>;
+    /**
+     * Add an issue to a project
+     */
+    addToProject(projectId: string, contentId: string): Promise<string | null>;
+    /**
+     * Get full issue details including body and comments
+     */
+    getIssueDetails(repo: RepoInfo, issueNumber: number): Promise<IssueDetails | null>;
+    /**
+     * Add a comment to an issue or PR
+     */
+    addComment(repo: RepoInfo, issueNumber: number, body: string): Promise<boolean>;
+    /**
+     * Get repository collaborators (for @ mention suggestions)
+     */
+    getCollaborators(repo: RepoInfo): Promise<Collaborator[]>;
+    /**
+     * Get recent issues (for # reference suggestions)
+     */
+    getRecentIssues(repo: RepoInfo, limit?: number): Promise<IssueReference[]>;
+    /**
+     * Get the active label name for a user
+     */
+    getActiveLabelName(): string;
+    /**
+     * Ensure a label exists in the repository, create if it doesn't
+     */
+    ensureLabel(repo: RepoInfo, labelName: string, color?: string): Promise<boolean>;
+    /**
+     * Add a label to an issue
+     */
+    addLabelToIssue(repo: RepoInfo, issueNumber: number, labelName: string): Promise<boolean>;
+    /**
+     * Remove a label from an issue
+     */
+    removeLabelFromIssue(repo: RepoInfo, issueNumber: number, labelName: string): Promise<boolean>;
+    /**
+     * Find all issues with a specific label
+     */
+    findIssuesWithLabel(repo: RepoInfo, labelName: string): Promise<number[]>;
+    /**
+     * Get available issue types for a repository
+     */
+    getIssueTypes(repo: RepoInfo): Promise<Array<{
+        id: string;
+        name: string;
+    }>>;
+    /**
+     * Set the issue type on an issue
+     */
+    setIssueType(repo: RepoInfo, issueNumber: number, issueTypeId: 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';
+ *
+ * const DATA_DIR = join(homedir(), '.config', 'ghp-cli');
+ * const LINKS_FILE = join(DATA_DIR, 'branch-links.json');
+ *
+ * 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);
+ * ```
+ */
+
+/**
+ * Manages branch-issue links using a pluggable storage adapter.
+ */
+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;
+    /**
+     * 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
+     */
+    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>;
+    /**
+     * 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>;
+    /**
+     * 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>;
+}
+/**
+ * Create an in-memory storage adapter for testing.
+ */
+declare function createInMemoryAdapter(): StorageAdapter & {
+    links: BranchLink[];
+};
+
+/**
+ * Git utility functions for working with local repositories.
+ *
+ * All functions accept an optional `options.cwd` parameter to specify
+ * the working directory. This makes the library usable in both CLI
+ * contexts (process.cwd()) and IDE contexts (workspace folder).
+ */
+
+/**
+ * Detect the GitHub repository from the current directory's git remote
+ */
+declare function detectRepository(options?: GitOptions): Promise<RepoInfo | null>;
+/**
+ * Get the current git branch
+ */
+declare function getCurrentBranch(options?: GitOptions): Promise<string | null>;
+/**
+ * Check if there are uncommitted changes
+ */
+declare function hasUncommittedChanges(options?: GitOptions): Promise<boolean>;
+/**
+ * Check if a branch exists locally
+ */
+declare function branchExists(branchName: string, options?: GitOptions): Promise<boolean>;
+/**
+ * Create and checkout a new branch
+ */
+declare function createBranch(branchName: string, options?: GitOptions): Promise<void>;
+/**
+ * Checkout an existing branch
+ */
+declare function checkoutBranch(branchName: string, options?: GitOptions): Promise<void>;
+/**
+ * Pull latest from origin
+ */
+declare function pullLatest(options?: GitOptions): Promise<void>;
+/**
+ * Fetch from origin
+ */
+declare function fetchOrigin(options?: GitOptions): Promise<void>;
+/**
+ * Get number of commits behind origin
+ */
+declare function getCommitsBehind(branch: string, options?: GitOptions): Promise<number>;
+/**
+ * Get number of commits ahead of origin
+ */
+declare function getCommitsAhead(branch: string, options?: GitOptions): Promise<number>;
+/**
+ * Check if working directory is a git repository
+ */
+declare function isGitRepository(options?: GitOptions): Promise<boolean>;
+/**
+ * Get the root directory of the git repository
+ */
+declare function getRepositoryRoot(options?: GitOptions): Promise<string | null>;
+/**
+ * Sanitize a string for use in a branch name
+ */
+declare function sanitizeForBranchName(str: string): string;
+/**
+ * Generate a branch name from a pattern
+ */
+declare function generateBranchName(pattern: string, vars: {
+    user: string;
+    number: number | null;
+    title: string;
+    repo: string;
+}, maxLength?: number): string;
+/**
+ * Get the default branch name (main or master)
+ */
+declare function getDefaultBranch(options?: GitOptions): Promise<string>;
+
+/**
+ * URL parsing utilities for GitHub repositories and issues.
+ */
+
+/**
+ * Parse a GitHub URL into owner and repo name.
+ * Supports both SSH and HTTPS formats.
+ *
+ * @example
+ * parseGitHubUrl('git@github.com:owner/repo.git')
+ * // => { owner: 'owner', name: 'repo', fullName: 'owner/repo' }
+ *
+ * @example
+ * parseGitHubUrl('https://github.com/owner/repo')
+ * // => { owner: 'owner', name: 'repo', fullName: 'owner/repo' }
+ */
+declare function parseGitHubUrl(url: string): RepoInfo | null;
+/**
+ * Parse a GitHub issue/PR URL to extract repo and number.
+ *
+ * @example
+ * parseIssueUrl('https://github.com/owner/repo/issues/123')
+ * // => { owner: 'owner', repo: 'repo', number: 123, type: 'issue' }
+ */
+declare function parseIssueUrl(url: string): {
+    owner: string;
+    repo: string;
+    number: number;
+    type: 'issue' | 'pull';
+} | null;
+/**
+ * Build a GitHub issue URL from components.
+ */
+declare function buildIssueUrl(owner: string, repo: string, number: number): string;
+/**
+ * Build a GitHub pull request URL from components.
+ */
+declare function buildPullRequestUrl(owner: string, repo: string, number: number): string;
+/**
+ * Build a GitHub repository URL from components.
+ */
+declare function buildRepoUrl(owner: string, repo: string): string;
+/**
+ * Build a GitHub project URL from components.
+ */
+declare function buildProjectUrl(owner: string, projectNumber: number): string;
+/**
+ * Build an organization project URL.
+ */
+declare function buildOrgProjectUrl(org: string, projectNumber: number): string;
+
+/**
+ * GraphQL query strings for GitHub Projects V2 API.
+ *
+ * These queries are extracted for reusability and testability.
+ * Each query is a template string that can be used with @octokit/graphql.
+ */
+/**
+ * Query to get the current authenticated user
+ */
+declare const VIEWER_QUERY = "\n    query {\n        viewer {\n            login\n        }\n    }\n";
+/**
+ * Query to get projects linked to a repository
+ */
+declare const REPOSITORY_PROJECTS_QUERY = "\n    query($owner: String!, $name: String!) {\n        repository(owner: $owner, name: $name) {\n            projectsV2(first: 20) {\n                nodes {\n                    id\n                    title\n                    number\n                    url\n                }\n            }\n        }\n    }\n";
+/**
+ * Query to get the repository ID
+ */
+declare const REPOSITORY_ID_QUERY = "\n    query($owner: String!, $name: String!) {\n        repository(owner: $owner, name: $name) {\n            id\n        }\n    }\n";
+/**
+ * Query to get project items with all field values
+ */
+declare const PROJECT_ITEMS_QUERY = "\n    query($projectId: ID!) {\n        node(id: $projectId) {\n            ... on ProjectV2 {\n                items(first: 100) {\n                    nodes {\n                        id\n                        fieldValues(first: 20) {\n                            nodes {\n                                __typename\n                                ... on ProjectV2ItemFieldSingleSelectValue {\n                                    name\n                                    field { ... on ProjectV2SingleSelectField { name } }\n                                }\n                                ... on ProjectV2ItemFieldTextValue {\n                                    text\n                                    field { ... on ProjectV2Field { name } }\n                                }\n                                ... on ProjectV2ItemFieldNumberValue {\n                                    number\n                                    field { ... on ProjectV2Field { name } }\n                                }\n                                ... on ProjectV2ItemFieldDateValue {\n                                    date\n                                    field { ... on ProjectV2Field { name } }\n                                }\n                                ... on ProjectV2ItemFieldIterationValue {\n                                    title\n                                    field { ... on ProjectV2IterationField { name } }\n                                }\n                            }\n                        }\n                        content {\n                            __typename\n                            ... on Issue {\n                                title\n                                number\n                                url\n                                state\n                                issueType { name }\n                                assignees(first: 5) { nodes { login } }\n                                labels(first: 10) { nodes { name color } }\n                                repository { name }\n                            }\n                            ... on PullRequest {\n                                title\n                                number\n                                url\n                                state\n                                merged\n                                assignees(first: 5) { nodes { login } }\n                                labels(first: 10) { nodes { name color } }\n                                repository { name }\n                            }\n                            ... on DraftIssue {\n                                title\n                            }\n                        }\n                    }\n                }\n            }\n        }\n    }\n";
+/**
+ * Query to get project fields (including status options)
+ */
+declare const PROJECT_FIELDS_QUERY = "\n    query($projectId: ID!) {\n        node(id: $projectId) {\n            ... on ProjectV2 {\n                fields(first: 30) {\n                    nodes {\n                        __typename\n                        ... on ProjectV2Field {\n                            id\n                            name\n                        }\n                        ... on ProjectV2SingleSelectField {\n                            id\n                            name\n                            options { id name }\n                        }\n                        ... on ProjectV2IterationField {\n                            id\n                            name\n                        }\n                    }\n                }\n            }\n        }\n    }\n";
+/**
+ * Query to get project views
+ */
+declare const PROJECT_VIEWS_QUERY = "\n    query($projectId: ID!) {\n        node(id: $projectId) {\n            ... on ProjectV2 {\n                views(first: 20) {\n                    nodes {\n                        name\n                        filter\n                    }\n                }\n            }\n        }\n    }\n";
+/**
+ * Mutation to update a project item field value
+ */
+declare const UPDATE_ITEM_FIELD_MUTATION = "\n    mutation($projectId: ID!, $itemId: ID!, $fieldId: ID!, $value: ProjectV2FieldValue!) {\n        updateProjectV2ItemFieldValue(input: {\n            projectId: $projectId\n            itemId: $itemId\n            fieldId: $fieldId\n            value: $value\n        }) {\n            projectV2Item { id }\n        }\n    }\n";
+/**
+ * Legacy mutation for updating single select field (status)
+ */
+declare const UPDATE_ITEM_STATUS_MUTATION = "\n    mutation($projectId: ID!, $itemId: ID!, $fieldId: ID!, $optionId: String!) {\n        updateProjectV2ItemFieldValue(input: {\n            projectId: $projectId\n            itemId: $itemId\n            fieldId: $fieldId\n            value: { singleSelectOptionId: $optionId }\n        }) {\n            projectV2Item { id }\n        }\n    }\n";
+/**
+ * Mutation to create a new issue
+ */
+declare const CREATE_ISSUE_MUTATION = "\n    mutation($repositoryId: ID!, $title: String!, $body: String) {\n        createIssue(input: {\n            repositoryId: $repositoryId\n            title: $title\n            body: $body\n        }) {\n            issue {\n                id\n                number\n            }\n        }\n    }\n";
+/**
+ * Mutation to add an item to a project
+ */
+declare const ADD_TO_PROJECT_MUTATION = "\n    mutation($projectId: ID!, $contentId: ID!) {\n        addProjectV2ItemById(input: {\n            projectId: $projectId\n            contentId: $contentId\n        }) {\n            item { id }\n        }\n    }\n";
+/**
+ * Query to get full issue details including comments
+ */
+declare const ISSUE_DETAILS_QUERY = "\n    query($owner: String!, $name: String!, $number: Int!) {\n        repository(owner: $owner, name: $name) {\n            issueOrPullRequest(number: $number) {\n                __typename\n                ... on Issue {\n                    title\n                    body\n                    state\n                    createdAt\n                    author { login }\n                    labels(first: 10) { nodes { name color } }\n                    comments(first: 50) {\n                        totalCount\n                        nodes {\n                            author { login }\n                            body\n                            createdAt\n                        }\n                    }\n                }\n                ... on PullRequest {\n                    title\n                    body\n                    state\n                    createdAt\n                    author { login }\n                    labels(first: 10) { nodes { name color } }\n                    comments(first: 50) {\n                        totalCount\n                        nodes {\n                            author { login }\n                            body\n                            createdAt\n                        }\n                    }\n                }\n            }\n        }\n    }\n";
+/**
+ * Query to get issue/PR node ID
+ */
+declare const ISSUE_NODE_ID_QUERY = "\n    query($owner: String!, $name: String!, $number: Int!) {\n        repository(owner: $owner, name: $name) {\n            issueOrPullRequest(number: $number) {\n                ... on Issue { id }\n                ... on PullRequest { id }\n            }\n        }\n    }\n";
+/**
+ * Mutation to add a comment
+ */
+declare const ADD_COMMENT_MUTATION = "\n    mutation($subjectId: ID!, $body: String!) {\n        addComment(input: { subjectId: $subjectId, body: $body }) {\n            commentEdge {\n                node { id }\n            }\n        }\n    }\n";
+/**
+ * Query to get repository collaborators
+ */
+declare const COLLABORATORS_QUERY = "\n    query($owner: String!, $name: String!) {\n        repository(owner: $owner, name: $name) {\n            collaborators(first: 50) {\n                nodes { login name }\n            }\n            assignableUsers(first: 50) {\n                nodes { login name }\n            }\n        }\n    }\n";
+/**
+ * Query to get recent issues
+ */
+declare const RECENT_ISSUES_QUERY = "\n    query($owner: String!, $name: String!, $limit: Int!) {\n        repository(owner: $owner, name: $name) {\n            issues(first: $limit, orderBy: { field: UPDATED_AT, direction: DESC }) {\n                nodes {\n                    number\n                    title\n                    state\n                }\n            }\n        }\n    }\n";
+/**
+ * Query to check if a label exists
+ */
+declare const LABEL_EXISTS_QUERY = "\n    query($owner: String!, $name: String!, $labelName: String!) {\n        repository(owner: $owner, name: $name) {\n            label(name: $labelName) {\n                id\n            }\n        }\n    }\n";
+/**
+ * Query to get issue and label IDs for adding labels
+ */
+declare const ISSUE_AND_LABEL_QUERY = "\n    query($owner: String!, $name: String!, $number: Int!, $labelName: String!) {\n        repository(owner: $owner, name: $name) {\n            issue(number: $number) {\n                id\n            }\n            label(name: $labelName) {\n                id\n            }\n        }\n    }\n";
+/**
+ * Mutation to add labels to an issue
+ */
+declare const ADD_LABELS_MUTATION = "\n    mutation($issueId: ID!, $labelIds: [ID!]!) {\n        addLabelsToLabelable(input: { labelableId: $issueId, labelIds: $labelIds }) {\n            clientMutationId\n        }\n    }\n";
+/**
+ * Mutation to remove labels from an issue
+ */
+declare const REMOVE_LABELS_MUTATION = "\n    mutation($issueId: ID!, $labelIds: [ID!]!) {\n        removeLabelsFromLabelable(input: { labelableId: $issueId, labelIds: $labelIds }) {\n            clientMutationId\n        }\n    }\n";
+/**
+ * Query to find issues with a specific label
+ */
+declare const ISSUES_WITH_LABEL_QUERY = "\n    query($owner: String!, $name: String!, $labels: [String!]) {\n        repository(owner: $owner, name: $name) {\n            issues(first: 10, labels: $labels, states: [OPEN]) {\n                nodes {\n                    number\n                }\n            }\n        }\n    }\n";
+/**
+ * Query to get available issue types for a repository
+ */
+declare const ISSUE_TYPES_QUERY = "\n    query($owner: String!, $name: String!) {\n        repository(owner: $owner, name: $name) {\n            issueTypes(first: 20) {\n                nodes {\n                    id\n                    name\n                }\n            }\n        }\n    }\n";
+/**
+ * Query to get issue node ID for updating
+ */
+declare const ISSUE_FOR_UPDATE_QUERY = "\n    query($owner: String!, $name: String!, $number: Int!) {\n        repository(owner: $owner, name: $name) {\n            issue(number: $number) {\n                id\n            }\n        }\n    }\n";
+/**
+ * Mutation to update issue type
+ */
+declare const UPDATE_ISSUE_TYPE_MUTATION = "\n    mutation($issueId: ID!, $issueTypeId: ID!) {\n        updateIssue(input: { id: $issueId, issueTypeId: $issueTypeId }) {\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;
+declare const queries_ADD_TO_PROJECT_MUTATION: typeof ADD_TO_PROJECT_MUTATION;
+declare const queries_COLLABORATORS_QUERY: typeof COLLABORATORS_QUERY;
+declare const queries_CREATE_ISSUE_MUTATION: typeof CREATE_ISSUE_MUTATION;
+declare const queries_ISSUES_WITH_LABEL_QUERY: typeof ISSUES_WITH_LABEL_QUERY;
+declare const queries_ISSUE_AND_LABEL_QUERY: typeof ISSUE_AND_LABEL_QUERY;
+declare const queries_ISSUE_DETAILS_QUERY: typeof ISSUE_DETAILS_QUERY;
+declare const queries_ISSUE_FOR_UPDATE_QUERY: typeof ISSUE_FOR_UPDATE_QUERY;
+declare const queries_ISSUE_NODE_ID_QUERY: typeof ISSUE_NODE_ID_QUERY;
+declare const queries_ISSUE_TYPES_QUERY: typeof ISSUE_TYPES_QUERY;
+declare const queries_LABEL_EXISTS_QUERY: typeof LABEL_EXISTS_QUERY;
+declare const queries_PROJECT_FIELDS_QUERY: typeof PROJECT_FIELDS_QUERY;
+declare const queries_PROJECT_ITEMS_QUERY: typeof PROJECT_ITEMS_QUERY;
+declare const queries_PROJECT_VIEWS_QUERY: typeof PROJECT_VIEWS_QUERY;
+declare const queries_RECENT_ISSUES_QUERY: typeof RECENT_ISSUES_QUERY;
+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_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_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 };