/** * GitHubProvider — IssueProvider implementation using gh CLI. */ import { execFile } from "node:child_process"; import { promisify } from "node:util"; import { writeFile, unlink } from "node:fs/promises"; import { join } from "node:path"; import { tmpdir } from "node:os"; import { type IssueProvider, type Issue, type StateLabel, STATE_LABELS, LABEL_COLORS, } from "./provider.js"; const execFileAsync = promisify(execFile); type GhIssue = { number: number; title: string; body: string; labels: Array<{ name: string }>; state: string; url: string; }; function toIssue(gh: GhIssue): Issue { return { iid: gh.number, title: gh.title, description: gh.body ?? "", labels: gh.labels.map((l) => l.name), state: gh.state, web_url: gh.url, }; } export class GitHubProvider implements IssueProvider { private repoPath: string; constructor(opts: { repoPath: string }) { this.repoPath = opts.repoPath; } private async gh(args: string[]): Promise { const { stdout } = await execFileAsync("gh", args, { cwd: this.repoPath, timeout: 30_000 }); return stdout.trim(); } async ensureLabel(name: string, color: string): Promise { try { await this.gh(["label", "create", name, "--color", color.replace(/^#/, "")]); } catch (err) { if (!(err as Error).message?.includes("already exists")) throw err; } } async ensureAllStateLabels(): Promise { for (const label of STATE_LABELS) await this.ensureLabel(label, LABEL_COLORS[label]); } async createIssue(title: string, description: string, label: StateLabel, assignees?: string[]): Promise { const tempFile = join(tmpdir(), `devclaw-issue-${Date.now()}.md`); await writeFile(tempFile, description, "utf-8"); try { const args = ["issue", "create", "--title", title, "--body-file", tempFile, "--label", label]; if (assignees?.length) args.push("--assignee", assignees.join(",")); const url = await this.gh(args); const match = url.match(/\/issues\/(\d+)$/); if (!match) throw new Error(`Failed to parse issue URL: ${url}`); return this.getIssue(parseInt(match[1], 10)); } finally { try { await unlink(tempFile); } catch { /* ignore */ } } } async listIssuesByLabel(label: StateLabel): Promise { try { const raw = await this.gh(["issue", "list", "--label", label, "--state", "open", "--json", "number,title,body,labels,state,url"]); return (JSON.parse(raw) as GhIssue[]).map(toIssue); } catch { return []; } } async getIssue(issueId: number): Promise { const raw = await this.gh(["issue", "view", String(issueId), "--json", "number,title,body,labels,state,url"]); return toIssue(JSON.parse(raw) as GhIssue); } async transitionLabel(issueId: number, from: StateLabel, to: StateLabel): Promise { const issue = await this.getIssue(issueId); const stateLabels = issue.labels.filter((l) => STATE_LABELS.includes(l as StateLabel)); const args = ["issue", "edit", String(issueId)]; for (const l of stateLabels) args.push("--remove-label", l); args.push("--add-label", to); await this.gh(args); } async closeIssue(issueId: number): Promise { await this.gh(["issue", "close", String(issueId)]); } async reopenIssue(issueId: number): Promise { await this.gh(["issue", "reopen", String(issueId)]); } hasStateLabel(issue: Issue, expected: StateLabel): boolean { return issue.labels.includes(expected); } getCurrentStateLabel(issue: Issue): StateLabel | null { return STATE_LABELS.find((l) => issue.labels.includes(l)) ?? null; } async hasMergedMR(issueId: number): Promise { try { const raw = await this.gh(["pr", "list", "--state", "merged", "--json", "title,body"]); const prs = JSON.parse(raw) as Array<{ title: string; body: string }>; const pat = `#${issueId}`; return prs.some((pr) => pr.title.includes(pat) || (pr.body ?? "").includes(pat)); } catch { return false; } } async getMergedMRUrl(issueId: number): Promise { try { const raw = await this.gh(["pr", "list", "--state", "merged", "--json", "number,title,body,url,mergedAt", "--limit", "20"]); const prs = JSON.parse(raw) as Array<{ number: number; title: string; body: string; url: string; mergedAt: string }>; const pat = `#${issueId}`; return prs.find((pr) => pr.title.includes(pat) || (pr.body ?? "").includes(pat))?.url ?? null; } catch { return null; } } async addComment(issueId: number, body: string): Promise { const tempFile = join(tmpdir(), `devclaw-comment-${Date.now()}.md`); await writeFile(tempFile, body, "utf-8"); try { await this.gh(["issue", "comment", String(issueId), "--body-file", tempFile]); } finally { try { await unlink(tempFile); } catch { /* ignore */ } } } async healthCheck(): Promise { try { await this.gh(["auth", "status"]); return true; } catch { return false; } } }