@ipul-labs/forge 1.13.0

package/server/forge/core/providers/github.js

@@ -0,0 +1,349 @@
+/**
+ * server/forge/core/providers/github.js
+ *
+ * GitHub REST API v3 implementation of ScmProvider.
+ * Multi-file commits use the Git Data API (blob → tree → commit → ref).
+ *
+ * Required env vars:
+ *   GITHUB_TOKEN  — personal access token (repo + workflow scopes)
+ *   GITHUB_OWNER  — default org or user, e.g. "ipul-labs"
+ *   GITHUB_REPO   — default repository name, e.g. "web-app"
+ *
+ * Optional:
+ *   GITHUB_BASE_BRANCH  — default target branch (default: "main")
+ */
+
+import { getConnection } from "../configStore.js";
+import { ScmProvider } from "./base.js";
+
+export class GitHubProvider extends ScmProvider {
+	/**
+	 * @param {string} [repo]  "owner/repo" format — overrides env vars
+	 */
+	constructor(repo) {
+		super();
+		if (repo && repo.includes("/")) {
+			const [owner, repoName] = repo.split("/");
+			this._owner = owner;
+			this._repo = repoName;
+		} else {
+			this._owner = process.env.GITHUB_OWNER ?? "";
+			this._repo = repo ?? process.env.GITHUB_REPO ?? "";
+		}
+		this._base = "https://api.github.com";
+		this._defaultBranch = process.env.GITHUB_BASE_BRANCH ?? "main";
+	}
+
+	get name() { return "github"; }
+	get supportsRebase() { return false; }
+
+	// ─── Internal helpers ──────────────────────────────────────────────────────
+
+	_headers() {
+		return {
+			Authorization: `Bearer ${getConnection("github").token}`,
+			Accept: "application/vnd.github+json",
+			"X-GitHub-Api-Version": "2022-11-28",
+			"Content-Type": "application/json",
+		};
+	}
+
+	_repoBase() {
+		return `${this._base}/repos/${this._owner}/${this._repo}`;
+	}
+
+	async _req(path, options = {}) {
+		const url = path.startsWith("http") ? path : `${this._repoBase()}${path}`;
+		const res = await fetch(url, {
+			...options,
+			headers: { ...this._headers(), ...options.headers },
+		});
+		if (res.status === 204) return null;
+		if (!res.ok) {
+			const text = await res.text().catch(() => "");
+			throw new Error(`GitHub ${res.status} on ${path}: ${text}`);
+		}
+		return res.json();
+	}
+
+	// ─── Normalizers ──────────────────────────────────────────────────────────
+
+	/** GitHub issues map closely to NormalIssue */
+	_issue(raw) {
+		return {
+			iid: raw.number,
+			title: raw.title,
+			description: raw.body ?? null,
+			labels: (raw.labels ?? []).map((l) => l.name),
+			author: { name: raw.user?.login ?? "" },
+			created_at: raw.created_at,
+			web_url: raw.html_url,
+		};
+	}
+
+	/** GitHub PRs → NormalMR. GitHub has no server-side rebase API. */
+	_mr(raw) {
+		return {
+			iid: raw.number,
+			title: raw.title,
+			web_url: raw.html_url,
+			source_branch: raw.head?.ref ?? "",
+			target_branch: raw.base?.ref ?? "",
+			state: raw.merged_at ? "merged" : raw.state,
+			has_conflicts: raw.mergeable === false,
+			rebase_in_progress: false,
+			merge_status: raw.mergeable_state ?? "",
+			detailed_merge_status: null,
+			draft: raw.draft ?? false,
+			head_pipeline: raw.head?.sha
+				? null  // populated separately via getCheckRuns if needed
+				: null,
+			author: { name: raw.user?.login ?? "" },
+			created_at: raw.created_at,
+			merged_at: raw.merged_at ?? null,
+		};
+	}
+
+	/** GitHub Actions workflow runs → NormalPipeline */
+	_pipeline(raw) {
+		return {
+			id: raw.id,
+			status: this._runStatus(raw),
+			web_url: raw.html_url,
+			created_at: raw.created_at,
+		};
+	}
+
+	_runStatus(run) {
+		if (run.conclusion) return run.conclusion;   // success / failure / cancelled
+		if (run.status === "in_progress") return "running";
+		return run.status ?? "unknown";
+	}
+
+	/** GitHub Actions jobs → NormalJob */
+	_job(raw) {
+		return {
+			id: raw.id,
+			name: raw.name,
+			stage: raw.workflow_name ?? "",
+			status: raw.conclusion ?? raw.status ?? "unknown",
+			web_url: raw.html_url,
+			duration: raw.completed_at && raw.started_at
+				? Math.round((new Date(raw.completed_at) - new Date(raw.started_at)) / 1000)
+				: null,
+		};
+	}
+
+	_diff(raw) {
+		return {
+			old_path: raw.previous_filename ?? raw.filename,
+			new_path: raw.filename,
+			diff: raw.patch ?? "",
+			new_file: raw.status === "added",
+			renamed_file: raw.status === "renamed",
+			deleted_file: raw.status === "removed",
+		};
+	}
+
+	// ─── Issues ───────────────────────────────────────────────────────────────
+
+	async listOpenIssues() {
+		const raw = await this._req(
+			`/issues?state=open&sort=updated&per_page=25&pulls=false`,
+		);
+		// GitHub returns PRs as issues; filter them out
+		return (raw ?? []).filter((i) => !i.pull_request).map((i) => this._issue(i));
+	}
+
+	async getIssue(iid) {
+		const raw = await this._req(`/issues/${iid}`);
+		return this._issue(raw);
+	}
+
+	async createIssue(title, description = "") {
+		const raw = await this._req("/issues", {
+			method: "POST",
+			body: JSON.stringify({ title, body: description }),
+		});
+		return this._issue(raw);
+	}
+
+	async updateIssue(iid, { title, description }) {
+		const raw = await this._req(`/issues/${iid}`, {
+			method: "PATCH",
+			body: JSON.stringify({ title, body: description }),
+		});
+		return this._issue(raw);
+	}
+
+	async closeIssue(iid) {
+		const raw = await this._req(`/issues/${iid}`, {
+			method: "PATCH",
+			body: JSON.stringify({ state: "closed" }),
+		});
+		return this._issue(raw);
+	}
+
+	// ─── Repository ───────────────────────────────────────────────────────────
+
+	async getFileTree(srcPath = "src", ref = this._defaultBranch) {
+		// Use recursive tree API — much faster than walking
+		const data = await this._req(`/git/trees/${ref}?recursive=1`);
+		return (data.tree ?? [])
+			.filter((item) => item.type === "blob")
+			.filter((item) => item.path.startsWith(srcPath + "/") || item.path === srcPath)
+			.filter((item) => /\.(ts|tsx|js|jsx|json|css|yaml|yml|md)$/.test(item.path))
+			.map((item) => item.path);
+	}
+
+	async getFileContent(filePath, ref = this._defaultBranch) {
+		const encoded = encodeURIComponent(filePath);
+		const data = await this._req(`/contents/${encoded}?ref=${ref}`);
+		return Buffer.from(data.content, "base64").toString("utf-8");
+	}
+
+	// ─── Mutations ────────────────────────────────────────────────────────────
+
+	async createBranch(branchName, ref = this._defaultBranch) {
+		// Resolve ref to SHA
+		const refData = await this._req(`/git/refs/heads/${ref}`);
+		const sha = refData.object.sha;
+		return this._req("/git/refs", {
+			method: "POST",
+			body: JSON.stringify({ ref: `refs/heads/${branchName}`, sha }),
+		});
+	}
+
+	/**
+	 * Multi-file commit using GitHub Git Data API.
+	 * @param {string} branch
+	 * @param {string} message
+	 * @param {import('./base.js').CommitAction[]} actions
+	 */
+	async commitFiles(branch, message, actions) {
+		// 1. Get current HEAD
+		const refData = await this._req(`/git/refs/heads/${branch}`);
+		const headSha = refData.object.sha;
+
+		// 2. Get base tree SHA from commit
+		const commitData = await this._req(`/git/commits/${headSha}`);
+		const baseTreeSha = commitData.tree.sha;
+
+		// 3. Create blobs for each file (skip deletes)
+		const treeEntries = await Promise.all(
+			actions.map(async (action) => {
+				if (action.action === "delete") {
+					return { path: action.file_path, mode: "100644", type: "blob", sha: null };
+				}
+				const blob = await this._req("/git/blobs", {
+					method: "POST",
+					body: JSON.stringify({ content: action.content, encoding: "utf-8" }),
+				});
+				return { path: action.file_path, mode: "100644", type: "blob", sha: blob.sha };
+			}),
+		);
+
+		// 4. Create new tree
+		const tree = await this._req("/git/trees", {
+			method: "POST",
+			body: JSON.stringify({ base_tree: baseTreeSha, tree: treeEntries }),
+		});
+
+		// 5. Create commit
+		const newCommit = await this._req("/git/commits", {
+			method: "POST",
+			body: JSON.stringify({ message, tree: tree.sha, parents: [headSha] }),
+		});
+
+		// 6. Update ref
+		return this._req(`/git/refs/heads/${branch}`, {
+			method: "PATCH",
+			body: JSON.stringify({ sha: newCommit.sha }),
+		});
+	}
+
+	async createMR({ sourceBranch, targetBranch = this._defaultBranch, title, description = "" }) {
+		const raw = await this._req("/pulls", {
+			method: "POST",
+			body: JSON.stringify({
+				head: sourceBranch,
+				base: targetBranch,
+				title,
+				body: description,
+			}),
+		});
+		return this._mr(raw);
+	}
+
+	// ─── PR queries ───────────────────────────────────────────────────────────
+
+	async listAllForgeMRs(state = "open") {
+		const ghState = state === "open" ? "open" : "closed";
+		const all = await this._req(`/pulls?state=${ghState}&per_page=50`);
+		const forge = (all ?? []).filter((pr) => pr.head?.ref?.startsWith("forge/"));
+		// GitHub rolls merged + closed-without-merge into `state=closed`; split
+		// them apart on merged_at so the UI tabs stay meaningful.
+		const filtered =
+			state === "merged" ? forge.filter((pr) => pr.merged_at)
+				: state === "closed" ? forge.filter((pr) => !pr.merged_at)
+					: forge;
+		return filtered.map((pr) => this._mr(pr));
+	}
+
+	async listForgeMRsForIssue(issueIid) {
+		const all = await this._req("/pulls?state=open&per_page=50");
+		return (all ?? [])
+			.filter((pr) => pr.head?.ref?.startsWith(`forge/issue-${issueIid}-`))
+			.map((pr) => this._mr(pr));
+	}
+
+	async listMergedForgeMRsForIssue(issueIid) {
+		const all = await this._req("/pulls?state=closed&per_page=50");
+		return (all ?? [])
+			.filter((pr) => pr.merged_at && pr.head?.ref?.startsWith(`forge/issue-${issueIid}-`))
+			.map((pr) => this._mr(pr));
+	}
+
+	async getMR(mrIid) {
+		const raw = await this._req(`/pulls/${mrIid}`);
+		return this._mr(raw);
+	}
+
+	async getMRDiffs(mrIid) {
+		const raw = await this._req(`/pulls/${mrIid}/files?per_page=100`);
+		return (raw ?? []).map((f) => this._diff(f));
+	}
+
+	// rebaseMR not supported — supportsRebase is false
+
+	// ─── CI / Pipelines (GitHub Actions) ─────────────────────────────────────
+
+	async getMRPipelines(mrIid) {
+		const pr = await this._req(`/pulls/${mrIid}`);
+		const sha = pr.head?.sha;
+		if (!sha) return [];
+		const data = await this._req(`/actions/runs?head_sha=${sha}&per_page=10`);
+		return (data.workflow_runs ?? []).map((r) => this._pipeline(r));
+	}
+
+	async getPipeline(pipelineId) {
+		const raw = await this._req(`/actions/runs/${pipelineId}`);
+		return this._pipeline(raw);
+	}
+
+	async getPipelineJobs(pipelineId) {
+		const data = await this._req(`/actions/runs/${pipelineId}/jobs`);
+		return (data.jobs ?? []).map((j) => this._job(j));
+	}
+
+	async getJobTrace(jobId) {
+		const url = `${this._repoBase()}/actions/jobs/${jobId}/logs`;
+		const res = await fetch(url, { headers: this._headers() });
+		if (!res.ok) {
+			const text = await res.text().catch(() => "");
+			throw new Error(`GitHub ${res.status} on jobs/${jobId}/logs: ${text}`);
+		}
+		// GitHub redirects to a pre-signed S3 URL; fetch follows it automatically
+		return res.text();
+	}
+}