@happyvertical/repos 0.74.8

package/AGENT.md

@@ -0,0 +1,33 @@
+# @happyvertical/repos
+
+<!-- BEGIN AGENT:GENERATED -->
+## Purpose
+Standardized repository interface for GitHub, GitLab, Bitbucket, and Azure DevOps
+
+## Package Map
+- Package: `@happyvertical/repos`
+- Hierarchy path: `@happyvertical/sdk > packages > repos`
+- Workspace position: `22 of 30` local packages
+- Internal dependencies: `@happyvertical/graphql`
+- Internal dependents: `@happyvertical/github-actions`, `@happyvertical/projects`
+- Knowledge graph files: `AGENT.md`, `metadata.json`, `ecosystem-manifest.json`
+
+## Build & Test
+```bash
+pnpm --filter @happyvertical/repos build
+pnpm --filter @happyvertical/repos test
+pnpm --filter @happyvertical/repos clean
+```
+
+## Agent Correction Loops
+- If module resolution or export errors mention a workspace dependency, build the dependency first (`pnpm --filter @happyvertical/graphql build`) and then rerun `pnpm --filter @happyvertical/repos build`.
+- If tests or exports fail after API, type, or bundle changes, run `pnpm --filter @happyvertical/repos clean` followed by `pnpm --filter @happyvertical/repos build` and `pnpm --filter @happyvertical/repos test`.
+- If failures span multiple packages or Turborepo ordering looks wrong, run `pnpm build` and `pnpm typecheck` from the repo root before retrying package-scoped commands.
+
+## Ecosystem Relationships
+- Provides: Standardized repository interface for GitHub, GitLab, Bitbucket, and Azure DevOps
+- Implements: none
+- Requires: @happyvertical/graphql, js-yaml
+- Stability: stable (Primary package surface is described as implemented and production-oriented.)
+<!-- END AGENT:GENERATED -->
+

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright <2025> <Happy Vertical Corporation>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,111 @@
+# @happyvertical/repos
+
+Standardized repository interface for GitHub, GitLab, Bitbucket, and Azure DevOps.
+
+## Installation
+
+```bash
+pnpm add @happyvertical/repos
+```
+
+## Claude Code Context
+
+Install Claude Code context files for AI-assisted development:
+
+```bash
+npx have-repos-context
+```
+
+This copies the package's `AGENT.md` documentation and `metadata.json` metadata to your project's `.claude/` directory, enabling Claude to provide better assistance when working with this package.
+
+## Usage
+
+```typescript
+import { getRepository } from '@happyvertical/repos';
+
+// Create a GitHub repository client
+const repo = await getRepository({
+  type: 'github',
+  owner: 'happyvertical',
+  repo: 'sdk',
+  token: process.env.GITHUB_TOKEN
+});
+
+// Get issue
+const issue = await repo.getIssue(352);
+
+// Add labels
+await repo.addLabels(352, ['type: feature', 'priority: high', 'size: xl']);
+
+// Post comment
+await repo.addComment(352, '## 🤖 AI Triage\n\n**Type**: feature...');
+
+// Search for duplicates
+const duplicates = await repo.searchIssues('kanban automation', {
+  state: 'open',
+  labels: ['type: feature'],
+});
+```
+
+## Features
+
+- **Platform-agnostic**: Works with GitHub, GitLab, Bitbucket, Azure DevOps
+- **Type-safe**: Full TypeScript support
+- **Consistent API**: Same interface across all platforms
+- **Factory pattern**: Simple `getRepository()` function
+- **Comprehensive**: Issues, PRs, labels, comments, assignments, search
+
+## API
+
+### Issues
+
+- `getIssue(number)` - Get issue details
+- `createIssue(data)` - Create new issue
+- `updateIssue(number, data)` - Update issue
+- `closeIssue(number)` - Close issue
+
+### Labels
+
+- `addLabels(issueNumber, labels)` - Add labels to issue
+- `removeLabel(issueNumber, label)` - Remove label from issue
+- `createLabel(label)` - Create repository label
+- `updateLabel(name, label)` - Update existing label
+- `listLabels()` - List all repository labels
+
+### Comments
+
+- `addComment(issueNumber, body)` - Add comment to issue
+- `updateComment(commentId, body)` - Update existing comment
+- `deleteComment(commentId)` - Delete comment
+- `listComments(issueNumber)` - List all comments on issue
+
+### Assignments
+
+- `assignIssue(issueNumber, assignees)` - Assign users to issue
+- `unassignIssue(issueNumber, assignees)` - Unassign users from issue
+
+### Pull Requests
+
+- `getPullRequest(number)` - Get PR details
+- `createPullRequest(data)` - Create new PR
+- `mergePullRequest(number, method)` - Merge PR
+
+### Search
+
+- `searchIssues(query, filters)` - Search issues with filters
+
+### Node IDs (for Projects V2)
+
+- `getIssueNodeId(issueNumber)` - Get GraphQL node ID for issue
+- `getPRNodeId(prNumber)` - Get GraphQL node ID for PR
+
+## Supported Platforms
+
+- ✅ **GitHub** - Full support
+- ⏳ **GitLab** - Coming soon
+- ⏳ **Bitbucket** - Coming soon
+- ⏳ **Azure DevOps** - Coming soon
+
+## License
+
+MIT

package/dist/claude-context.d.ts

@@ -0,0 +1 @@
+export { }

package/dist/cli/claude-context.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=claude-context.d.ts.map

package/dist/cli/claude-context.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+import { existsSync, mkdirSync, copyFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+const Dirname = dirname(fileURLToPath(import.meta.url));
+const pkgRoot = join(Dirname, "../..");
+const targetDir = join(process.cwd(), ".claude");
+if (!existsSync(targetDir)) {
+  mkdirSync(targetDir, { recursive: true });
+}
+const pkgName = "repos";
+const agentMdSrc = existsSync(join(pkgRoot, "AGENT.md")) ? join(pkgRoot, "AGENT.md") : join(pkgRoot, "CLAUDE.md");
+const metaSrc = existsSync(join(pkgRoot, "metadata.json")) ? join(pkgRoot, "metadata.json") : join(pkgRoot, ".claude-meta.json");
+if (existsSync(agentMdSrc)) {
+  copyFileSync(agentMdSrc, join(targetDir, `have-${pkgName}.md`));
+}
+if (existsSync(metaSrc)) {
+  copyFileSync(metaSrc, join(targetDir, `have-${pkgName}.meta.json`));
+}
+console.log(`✓ Installed @happyvertical/${pkgName} context to .claude/`);
+//# sourceMappingURL=claude-context.js.map

package/dist/cli/claude-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"claude-context.js","sources":["../../src/cli/claude-context.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * CLI script to install agent context for @happyvertical/repos\n * Run the published context installer binary for this package.\n */\nimport { copyFileSync, existsSync, mkdirSync } from 'node:fs';\nimport { dirname, join } from 'node:path';\nimport { fileURLToPath } from 'node:url';\n\nconst Dirname = dirname(fileURLToPath(import.meta.url));\nconst pkgRoot = join(Dirname, '../..');\nconst targetDir = join(process.cwd(), '.claude');\n\nif (!existsSync(targetDir)) {\n  mkdirSync(targetDir, { recursive: true });\n}\n\nconst pkgName = 'repos';\nconst agentMdSrc = existsSync(join(pkgRoot, 'AGENT.md'))\n  ? join(pkgRoot, 'AGENT.md')\n  : join(pkgRoot, 'CLAUDE.md');\nconst metaSrc = existsSync(join(pkgRoot, 'metadata.json'))\n  ? join(pkgRoot, 'metadata.json')\n  : join(pkgRoot, '.claude-meta.json');\n\nif (existsSync(agentMdSrc)) {\n  copyFileSync(agentMdSrc, join(targetDir, `have-${pkgName}.md`));\n}\n\nif (existsSync(metaSrc)) {\n  copyFileSync(metaSrc, join(targetDir, `have-${pkgName}.meta.json`));\n}\n\nconsole.log(`✓ Installed @happyvertical/${pkgName} context to .claude/`);\n"],"names":[],"mappings":";;;;AASA,MAAM,UAAU,QAAQ,cAAc,YAAY,GAAG,CAAC;AACtD,MAAM,UAAU,KAAK,SAAS,OAAO;AACrC,MAAM,YAAY,KAAK,QAAQ,IAAA,GAAO,SAAS;AAE/C,IAAI,CAAC,WAAW,SAAS,GAAG;AAC1B,YAAU,WAAW,EAAE,WAAW,KAAA,CAAM;AAC1C;AAEA,MAAM,UAAU;AAChB,MAAM,aAAa,WAAW,KAAK,SAAS,UAAU,CAAC,IACnD,KAAK,SAAS,UAAU,IACxB,KAAK,SAAS,WAAW;AAC7B,MAAM,UAAU,WAAW,KAAK,SAAS,eAAe,CAAC,IACrD,KAAK,SAAS,eAAe,IAC7B,KAAK,SAAS,mBAAmB;AAErC,IAAI,WAAW,UAAU,GAAG;AAC1B,eAAa,YAAY,KAAK,WAAW,QAAQ,OAAO,KAAK,CAAC;AAChE;AAEA,IAAI,WAAW,OAAO,GAAG;AACvB,eAAa,SAAS,KAAK,WAAW,QAAQ,OAAO,YAAY,CAAC;AACpE;AAEA,QAAQ,IAAI,8BAA8B,OAAO,sBAAsB;"}

package/dist/index.d.ts

@@ -0,0 +1,453 @@
+export declare interface Branch {
+    name: string;
+    sha: string;
+    protected: boolean;
+}
+
+declare interface Comment_2 {
+    id: string;
+    body: string;
+    author: User;
+    createdAt: Date;
+    updatedAt: Date;
+    url: string;
+}
+export { Comment_2 as Comment }
+
+/**
+ * Options for creating a repository from a template
+ */
+export declare interface CreateFromTemplateOptions {
+    /** The organization or user who will own the new repository */
+    owner: string;
+    /** The name for the new repository */
+    name: string;
+    /** A short description of the new repository */
+    description?: string;
+    /** Whether the new repository should be private (default: true) */
+    isPrivate?: boolean;
+    /** Whether to include all branches from the template (default: false, only default branch) */
+    includeAllBranches?: boolean;
+}
+
+export declare interface CreateIssueInput {
+    title: string;
+    body?: string;
+    labels?: string[];
+    assignees?: string[];
+}
+
+export declare interface CreatePRInput {
+    title: string;
+    body?: string;
+    headRef: string;
+    baseRef: string;
+    draft?: boolean;
+}
+
+/**
+ * Detect which template an issue was created from based on labels
+ *
+ * Matches issue labels against template labels to find the best match.
+ * Returns the template with the most matching labels.
+ *
+ * @param labels - Issue labels
+ * @param templates - Available templates
+ * @returns Matching template or undefined if no match
+ *
+ * @example
+ * ```typescript
+ * const templates = await fetchIssueTemplates(repo);
+ * const template = detectTemplateFromLabels(['bug', 'critical'], templates);
+ * if (template) {
+ *   const fields = parseIssueBody(issue.body, template);
+ * }
+ * ```
+ */
+export declare function detectTemplateFromLabels(labels: string[], templates: IssueTemplate[]): IssueTemplate | undefined;
+
+/**
+ * Fetch issue templates from a repository via GitHub API
+ *
+ * @param repo - Repository client implementing IRepository
+ * @returns Array of parsed issue templates
+ *
+ * @example
+ * ```typescript
+ * const repo = await getRepository({ type: 'github', owner: 'org', repo: 'name', token });
+ * const templates = await fetchIssueTemplates(repo);
+ * // [{ name: 'Bug Report', labels: ['bug'], body: [...] }, ...]
+ * ```
+ */
+export declare function fetchIssueTemplates(repo: IRepository): Promise<IssueTemplate[]>;
+
+/**
+ * Get a specific field value from an issue body
+ *
+ * @param body - The issue body markdown
+ * @param fieldIdOrLabel - Field ID (with template) or label (without template)
+ * @param template - Optional template for field ID lookup
+ * @returns Field value or undefined if not found
+ */
+export declare function getIssueField(body: string, fieldIdOrLabel: string, template?: IssueTemplate): string | undefined;
+
+/**
+ * Get a repository client instance
+ *
+ * This is the main entry point following the pattern from @happyvertical/files and @happyvertical/sql.
+ * It can accept either a configuration object or an existing repository instance.
+ *
+ * @param options - Repository configuration or existing repository instance
+ * @returns Promise resolving to repository interface
+ *
+ * @example
+ * ```typescript
+ * import { getRepository } from '@happyvertical/repos';
+ *
+ * // Create a GitHub repository client
+ * const repo = await getRepository({
+ *   type: 'github',
+ *   owner: 'happyvertical',
+ *   repo: 'sdk',
+ *   token: process.env.GITHUB_TOKEN
+ * });
+ *
+ * // Use the client
+ * const issue = await repo.getIssue(352);
+ * await repo.addLabels(352, ['type: feature', 'priority: high']);
+ *
+ * // Pass existing instance (returns it unchanged)
+ * const sameRepo = await getRepository(repo);
+ * ```
+ */
+export declare function getRepository(options: RepositoryConfig | IRepository): Promise<IRepository>;
+
+/**
+ * GitHub repository implementation
+ */
+export declare class GitHubRepository implements IRepository {
+    private rest;
+    private graphql;
+    private owner;
+    private repo;
+    constructor(config: RepositoryConfig);
+    getRepository(): Promise<Repository>;
+    getIssue(number: number): Promise<Issue>;
+    createIssue(data: CreateIssueInput): Promise<Issue>;
+    updateIssue(number: number, data: UpdateIssueInput): Promise<Issue>;
+    closeIssue(number: number): Promise<void>;
+    addLabels(issueNumber: number, labels: string[]): Promise<void>;
+    removeLabel(issueNumber: number, label: string): Promise<void>;
+    createLabel(label: Label): Promise<void>;
+    updateLabel(name: string, label: Label): Promise<void>;
+    listLabels(): Promise<Label[]>;
+    addComment(issueNumber: number, body: string): Promise<Comment_2>;
+    updateComment(commentId: string, body: string): Promise<Comment_2>;
+    deleteComment(commentId: string): Promise<void>;
+    listComments(issueNumber: number): Promise<Comment_2[]>;
+    assignIssue(issueNumber: number, assignees: string[]): Promise<void>;
+    unassignIssue(issueNumber: number, assignees: string[]): Promise<void>;
+    getPullRequest(number: number): Promise<PullRequest>;
+    createPullRequest(data: CreatePRInput): Promise<PullRequest>;
+    mergePullRequest(number: number, method?: MergeMethod): Promise<void>;
+    searchIssues(query: string, filters?: SearchFilters): Promise<Issue[]>;
+    getIssueNodeId(issueNumber: number): Promise<string>;
+    getPRNodeId(prNumber: number): Promise<string>;
+    createBranch(name: string, fromRef: string): Promise<Branch>;
+    deleteBranch(name: string): Promise<void>;
+    getBranch(name: string): Promise<Branch | null>;
+    markPRReady(prNumber: number): Promise<void>;
+    convertPRToDraft(prNumber: number): Promise<void>;
+    requestReview(prNumber: number, reviewers: string[]): Promise<void>;
+    triggerWorkflow(workflowId: string, ref: string, inputs?: Record<string, string>): Promise<void>;
+    findPRsForIssue(issueNumber: number): Promise<PullRequest[]>;
+    findIssueForPR(prNumber: number): Promise<Issue | null>;
+    getFileContent(path: string, ref?: string): Promise<string | null>;
+    listDirectoryFiles(path: string, ref?: string): Promise<string[]>;
+    /**
+     * Create a new repository from this repository as a template.
+     *
+     * Uses the GitHub "Generate" API: POST /repos/{template_owner}/{template_repo}/generate
+     * The current repository (this.owner/this.repo) is used as the template.
+     */
+    createRepositoryFromTemplate(options: CreateFromTemplateOptions): Promise<Repository>;
+}
+
+/**
+ * Repository interface - all repository implementations must implement this
+ */
+export declare interface IRepository {
+    getRepository(): Promise<Repository>;
+    getIssue(number: number): Promise<Issue>;
+    createIssue(data: CreateIssueInput): Promise<Issue>;
+    updateIssue(number: number, data: UpdateIssueInput): Promise<Issue>;
+    closeIssue(number: number): Promise<void>;
+    addLabels(issueNumber: number, labels: string[]): Promise<void>;
+    removeLabel(issueNumber: number, label: string): Promise<void>;
+    createLabel(label: Label): Promise<void>;
+    updateLabel(name: string, label: Label): Promise<void>;
+    listLabels(): Promise<Label[]>;
+    addComment(issueNumber: number, body: string): Promise<Comment_2>;
+    updateComment(commentId: string, body: string): Promise<Comment_2>;
+    deleteComment(commentId: string): Promise<void>;
+    listComments(issueNumber: number): Promise<Comment_2[]>;
+    assignIssue(issueNumber: number, assignees: string[]): Promise<void>;
+    unassignIssue(issueNumber: number, assignees: string[]): Promise<void>;
+    getPullRequest(number: number): Promise<PullRequest>;
+    createPullRequest(data: CreatePRInput): Promise<PullRequest>;
+    mergePullRequest(number: number, method?: MergeMethod): Promise<void>;
+    searchIssues(query: string, filters?: SearchFilters): Promise<Issue[]>;
+    getIssueNodeId(issueNumber: number): Promise<string>;
+    getPRNodeId(prNumber: number): Promise<string>;
+    createBranch(name: string, fromRef: string): Promise<Branch>;
+    deleteBranch(name: string): Promise<void>;
+    getBranch(name: string): Promise<Branch | null>;
+    markPRReady(prNumber: number): Promise<void>;
+    convertPRToDraft(prNumber: number): Promise<void>;
+    requestReview(prNumber: number, reviewers: string[]): Promise<void>;
+    triggerWorkflow(workflowId: string, ref: string, inputs?: Record<string, string>): Promise<void>;
+    findPRsForIssue(issueNumber: number): Promise<PullRequest[]>;
+    findIssueForPR(prNumber: number): Promise<Issue | null>;
+    getFileContent(path: string, ref?: string): Promise<string | null>;
+    listDirectoryFiles(path: string, ref?: string): Promise<string[]>;
+}
+
+export declare interface Issue {
+    number: number;
+    id: string;
+    title: string;
+    body: string;
+    state: 'open' | 'closed';
+    labels: Label[];
+    assignees: User[];
+    author: User;
+    createdAt: Date;
+    updatedAt: Date;
+    closedAt?: Date;
+    url: string;
+    commentsCount: number;
+}
+
+/**
+ * Issue template definition
+ */
+export declare interface IssueTemplate {
+    name: string;
+    description?: string;
+    title?: string;
+    labels?: string[];
+    assignees?: string[];
+    body: TemplateField[];
+}
+
+export declare interface Label {
+    name: string;
+    color: string;
+    description: string;
+}
+
+/**
+ * Load and parse an issue template from a YAML file
+ *
+ * @param yamlPath - Path to the YAML template file
+ * @returns Parsed issue template
+ *
+ * @example
+ * ```typescript
+ * const template = await loadIssueTemplate('.github/ISSUE_TEMPLATE/bug_report.yml');
+ * ```
+ */
+export declare function loadIssueTemplate(yamlPath: string): Promise<IssueTemplate>;
+
+export declare type MergeMethod = 'merge' | 'squash' | 'rebase';
+
+/**
+ * Parse an issue body into field values
+ *
+ * GitHub renders form fields as markdown sections:
+ * ```
+ * ### Label
+ *
+ * Content here
+ *
+ * ### Next Label
+ * ```
+ *
+ * Without a template, returns a Record<string, string> keyed by label.
+ * With a template, returns a Record<string, string> keyed by field ID.
+ *
+ * @param body - The issue body markdown
+ * @param template - Optional template for mapping labels to field IDs
+ * @returns Parsed fields as key-value pairs
+ *
+ * @example
+ * ```typescript
+ * // Without template - keyed by label
+ * const fields = parseIssueBody(issue.body);
+ * // { 'Description': '...', 'Steps to Reproduce': '...' }
+ *
+ * // With template - keyed by field ID
+ * const template = await loadIssueTemplate('.github/ISSUE_TEMPLATE/bug_report.yml');
+ * const fields = parseIssueBody(issue.body, template);
+ * // { description: '...', reproduction: '...' }
+ * ```
+ */
+export declare function parseIssueBody(body: string, template?: IssueTemplate): Record<string, string>;
+
+/**
+ * Parse an issue template from YAML content
+ *
+ * @param yamlContent - YAML content string
+ * @returns Parsed issue template
+ *
+ * @example
+ * ```typescript
+ * const template = parseIssueTemplate(`
+ * name: Bug Report
+ * body:
+ *   - type: textarea
+ *     id: description
+ *     attributes:
+ *       label: Description
+ * `);
+ * ```
+ */
+export declare function parseIssueTemplate(yamlContent: string): IssueTemplate;
+
+export declare interface PullRequest extends Issue {
+    headRef: string;
+    baseRef: string;
+    merged: boolean;
+    mergedAt?: Date;
+    mergeable: boolean;
+    draft: boolean;
+}
+
+/**
+ * Render fields into an issue body markdown string
+ *
+ * Without a template, uses field keys as labels.
+ * With a template, uses field IDs to look up labels and renders in template order.
+ *
+ * @param fields - Field values as key-value pairs
+ * @param template - Optional template for field ordering and labels
+ * @returns Markdown string for issue body
+ *
+ * @example
+ * ```typescript
+ * // Without template
+ * const body = renderIssueBody({
+ *   'Description': 'Bug description here',
+ *   'Steps to Reproduce': '1. Do X\n2. See error'
+ * });
+ *
+ * // With template
+ * const template = await loadIssueTemplate('.github/ISSUE_TEMPLATE/bug_report.yml');
+ * const body = renderIssueBody({
+ *   description: 'Bug description here',
+ *   reproduction: '1. Do X\n2. See error'
+ * }, template);
+ * ```
+ */
+export declare function renderIssueBody(fields: Record<string, string>, template?: IssueTemplate): string;
+
+export declare interface Repository {
+    owner: string;
+    name: string;
+    description: string;
+    defaultBranch: string;
+    url: string;
+    isPrivate: boolean;
+}
+
+/**
+ * Repository configuration
+ */
+export declare interface RepositoryConfig {
+    type: 'github' | 'gitlab' | 'bitbucket' | 'azure';
+    owner: string;
+    repo: string;
+    token: string;
+    baseUrl?: string;
+}
+
+export declare class RepositoryError extends Error {
+    code: RepositoryErrorCode;
+    statusCode?: number | undefined;
+    response?: unknown | undefined;
+    constructor(message: string, code: RepositoryErrorCode, statusCode?: number | undefined, response?: unknown | undefined);
+    static fromHTTPStatus(statusCode: number, message: string, response?: unknown): RepositoryError;
+    static networkError(message: string, cause?: Error): RepositoryError;
+    isRetryable(): boolean;
+}
+
+/**
+ * Repository error handling
+ */
+export declare enum RepositoryErrorCode {
+    NOT_FOUND = "NOT_FOUND",
+    UNAUTHORIZED = "UNAUTHORIZED",
+    FORBIDDEN = "FORBIDDEN",
+    RATE_LIMITED = "RATE_LIMITED",
+    VALIDATION_ERROR = "VALIDATION_ERROR",
+    NETWORK_ERROR = "NETWORK_ERROR",
+    UNKNOWN = "UNKNOWN"
+}
+
+export declare interface SearchFilters {
+    state?: 'open' | 'closed' | 'all';
+    labels?: string[];
+    author?: string;
+    assignee?: string;
+    limit?: number;
+    sort?: 'created' | 'updated' | 'comments';
+    order?: 'asc' | 'desc';
+}
+
+/**
+ * Template field definition - mirrors GitHub ISSUE_TEMPLATE YAML structure
+ */
+export declare interface TemplateField {
+    type: 'textarea' | 'input' | 'dropdown' | 'checkboxes' | 'markdown';
+    id?: string;
+    attributes: {
+        label: string;
+        description?: string;
+        placeholder?: string;
+        value?: string;
+        options?: string[];
+    };
+    validations?: {
+        required?: boolean;
+    };
+}
+
+/**
+ * Update a specific field in an issue body
+ *
+ * @param body - The issue body markdown
+ * @param fieldIdOrLabel - Field ID (with template) or label (without template)
+ * @param value - New value for the field
+ * @param template - Optional template for field ID lookup
+ * @returns Updated issue body markdown
+ */
+export declare function updateIssueField(body: string, fieldIdOrLabel: string, value: string, template?: IssueTemplate): string;
+
+export declare interface UpdateIssueInput {
+    title?: string;
+    body?: string;
+    state?: 'open' | 'closed';
+}
+
+/**
+ * Core types for repository operations
+ */
+export declare interface User {
+    login: string;
+    id: string;
+    type: 'User' | 'Bot';
+    avatarUrl?: string;
+    url?: string;
+}
+
+export { }