@ipul-labs/forge 1.16.8 → 1.17.0

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

@@ -1,208 +0,0 @@
-/**
- * server/forge/core/providers/base.js
- *
- * Abstract base class that defines the interface every SCM provider must
- * implement.  Methods throw "not implemented" by default so subclasses get
- * a clear error rather than a silent no-op when something is missing.
- *
- * All data shapes returned by provider methods are normalised so that
- * ForgeAgent and routes.js never need to know which provider is active.
- *
- * Normalised shapes (JSDoc):
- *
- * @typedef {{ iid: number, title: string, description: string|null,
- *             labels: string[], author: { name: string },
- *             created_at: string, web_url: string }} NormalIssue
- *
- * @typedef {{ iid: number, title: string, web_url: string,
- *             source_branch: string, target_branch: string,
- *             state: string, has_conflicts: boolean,
- *             rebase_in_progress: boolean, merge_status: string,
- *             detailed_merge_status: string|null,
- *             draft: boolean,
- *             head_pipeline: { status: string, web_url: string }|null,
- *             author: { name: string }, created_at: string,
- *             merged_at: string|null,
- *             merge_commit_sha: string|null }} NormalMR
- *
- * @typedef {{ id: number, status: string, web_url: string,
- *             created_at: string }} NormalPipeline
- *
- * @typedef {{ id: number, name: string, stage: string, status: string,
- *             web_url: string, duration: number|null }} NormalJob
- *
- * @typedef {{ old_path: string, new_path: string, diff: string,
- *             new_file: boolean, renamed_file: boolean,
- *             deleted_file: boolean }} NormalDiff
- *
- * @typedef {{ action: 'create'|'modify'|'delete',
- *             file_path: string, content: string }} CommitAction
- *
- * @typedef {{ id: number, name: string,
- *             state: 'available'|'stopping'|'stopped'|string,
- *             external_url: string|null, ref: string|null,
- *             updated_at: string|null, web_url: string|null }} NormalEnvironment
- */
-
-export class ScmProvider {
-	/** @returns {string} Provider identifier */
-	get name() { return "base"; }
-
-	/** @returns {boolean} Whether the provider supports server-side rebase */
-	get supportsRebase() { return false; }
-
-	// ─── Issues ────────────────────────────────────────────────────────────────
-
-	/** @returns {Promise<NormalIssue[]>} */
-	async listOpenIssues() { throw new Error(`${this.name}: listOpenIssues not implemented`); }
-
-	/** @param {number|string} iid @returns {Promise<NormalIssue>} */
-	async getIssue(iid) { throw new Error(`${this.name}: getIssue not implemented`); }
-
-	/** @returns {Promise<NormalIssue>} */
-	async createIssue(title, description) { throw new Error(`${this.name}: createIssue not implemented`); }
-
-	/** @returns {Promise<NormalIssue>} */
-	async updateIssue(iid, { title, description }) { throw new Error(`${this.name}: updateIssue not implemented`); }
-
-	/** @returns {Promise<NormalIssue>} */
-	async closeIssue(iid) { throw new Error(`${this.name}: closeIssue not implemented`); }
-
-	// ─── Repository ────────────────────────────────────────────────────────────
-
-	/** @returns {Promise<string[]>} File paths */
-	async getFileTree(srcPath, ref) { throw new Error(`${this.name}: getFileTree not implemented`); }
-
-	/** @returns {Promise<string>} File content */
-	async getFileContent(filePath, ref) { throw new Error(`${this.name}: getFileContent not implemented`); }
-
-	// ─── Mutations ─────────────────────────────────────────────────────────────
-
-	async createBranch(branchName, ref) { throw new Error(`${this.name}: createBranch not implemented`); }
-
-	/** @param {string} branchName @returns {Promise<void>} */
-	async deleteBranch(branchName) { throw new Error(`${this.name}: deleteBranch not implemented`); }
-
-	/** @param {CommitAction[]} actions */
-	async commitFiles(branch, message, actions) { throw new Error(`${this.name}: commitFiles not implemented`); }
-
-	/** @returns {Promise<NormalMR>} */
-	async createMR({ sourceBranch, targetBranch, title, description }) { throw new Error(`${this.name}: createMR not implemented`); }
-
-	// ─── MR / PR queries ───────────────────────────────────────────────────────
-
-	/**
-	 * @param {"open"|"merged"|"closed"} [state="open"] Lifecycle filter
-	 * @returns {Promise<NormalMR[]>} Forge-created MRs in the requested state
-	 */
-	async listAllForgeMRs(_state = "open") { throw new Error(`${this.name}: listAllForgeMRs not implemented`); }
-
-	/** @returns {Promise<NormalMR[]>} Open Forge MRs for a specific issue */
-	async listForgeMRsForIssue(issueIid) { throw new Error(`${this.name}: listForgeMRsForIssue not implemented`); }
-
-	/** @returns {Promise<NormalMR[]>} Merged Forge MRs for a specific issue */
-	async listMergedForgeMRsForIssue(issueIid) { throw new Error(`${this.name}: listMergedForgeMRsForIssue not implemented`); }
-
-	/** @returns {Promise<NormalMR>} */
-	async getMR(mrIid) { throw new Error(`${this.name}: getMR not implemented`); }
-
-	/** @returns {Promise<NormalDiff[]>} */
-	async getMRDiffs(mrIid) { throw new Error(`${this.name}: getMRDiffs not implemented`); }
-
-	/** @returns {Promise<void>} */
-	async rebaseMR(mrIid) { throw new Error(`${this.name}: rebase not supported`); }
-
-	/** Merge the MR immediately. @returns {Promise<void>} */
-	async mergeMR(_mrIid) { throw new Error(`${this.name}: mergeMR not supported`); }
-
-	/** Close the MR without merging. @returns {Promise<void>} */
-	async closeMR(_mrIid) { throw new Error(`${this.name}: closeMR not supported`); }
-
-	/** Reopen a closed MR. @returns {Promise<void>} */
-	async reopenMR(_mrIid) { throw new Error(`${this.name}: reopenMR not supported`); }
-
-	/**
-	 * Toggle draft / work-in-progress state on the MR.
-	 * @param {number} _mrIid
-	 * @param {boolean} _draft true → mark as draft, false → mark as ready
-	 * @returns {Promise<void>}
-	 */
-	async setMRDraft(_mrIid, _draft) { throw new Error(`${this.name}: setMRDraft not supported`); }
-
-	// ─── CI / Pipelines ────────────────────────────────────────────────────────
-
-	/** @returns {Promise<NormalPipeline[]>} */
-	async getMRPipelines(mrIid) { throw new Error(`${this.name}: getMRPipelines not implemented`); }
-
-	/** @returns {Promise<NormalPipeline>} */
-	async getPipeline(pipelineId) { throw new Error(`${this.name}: getPipeline not implemented`); }
-
-	/** @returns {Promise<NormalJob[]>} */
-	async getPipelineJobs(pipelineId) { throw new Error(`${this.name}: getPipelineJobs not implemented`); }
-
-	/** @returns {Promise<string>} Plain-text log */
-	async getJobTrace(jobId) { throw new Error(`${this.name}: getJobTrace not implemented`); }
-
-	/** @returns {Promise<NormalPipeline[]>} Pipelines that ran on a specific commit SHA */
-	async getPipelinesBySha(_sha) { return []; }
-
-	/** @returns {Promise<NormalPipeline[]>} Pipelines that ran on a specific branch ref */
-	async getPipelinesByRef(_ref) { return []; }
-
-	/** @returns {Promise<string[]>} Branch names starting with the given prefix */
-	async listBranchesByPrefix(_prefix) { return []; }
-
-	/**
-	 * Count commits reachable from `toRef` but not from `fromRef`. Used to detect
-	 * stale / empty forge branches (aheadCount === 0 means the branch has no
-	 * pending changes vs. main). Return `null` when the provider can't compute it
-	 * so callers can distinguish "no divergence" from "unknown".
-	 *
-	 * @param {string} _fromRef base ref (typically "main")
-	 * @param {string} _toRef   ref under test (e.g. "forge/issue-10-…")
-	 * @returns {Promise<{aheadCount: number}|null>}
-	 */
-	async compareRefs(_fromRef, _toRef) { return null; }
-
-	/**
-	 * Scan recently merged MRs so callers can badge open issues whose fix
-	 * already shipped. Two attribution paths the consumer can use:
-	 *   1. `closedIssueIids` — issues named by `Closes #N` / `Fixes #N` /
-	 *      `Resolves #N` trailers in the MR description (primary signal).
-	 *   2. `sourceBranch` — the MR's source branch; lets the consumer recover
-	 *      issue IDs from branch names like `forge/issue-42-foo` when the MR
-	 *      description has no closing keyword.
-	 * Returned entries are NOT pre-filtered on `closedIssueIids` — drop noise
-	 * in the caller if you only want one of the two signals. One bulk call per
-	 * issue-list render — do NOT call per-issue.
-	 *
-	 * @param {number} _limit cap on MRs to scan (default 50)
-	 * @returns {Promise<Array<{mrIid: number, webUrl: string, mergedAt: string|null, sourceBranch: string|null, closedIssueIids: number[]}>>}
-	 */
-	async listRecentMergedMRIssueLinks(_limit) { return []; }
-
-	// ─── Environments (ephemeral review apps) ─────────────────────────────────
-
-	/**
-	 * List environments attached to a branch. Used to surface per-issue
-	 * ephemeral URLs + status next to the pipeline on the issue detail view.
-	 *
-	 * Implementations that don't support environments should return `[]` so
-	 * the UI simply doesn't render the section.
-	 *
-	 * @param {string} _branchName
-	 * @returns {Promise<NormalEnvironment[]>}
-	 */
-	async listEnvironmentsForBranch(_branchName) { return []; }
-
-	/**
-	 * Trigger teardown of an environment. GitLab supports this natively via the
-	 * environments/:id/stop action; GitHub has no equivalent and typically
-	 * needs a repository_dispatch event to a cleanup workflow. Implementations
-	 * that can't stop should throw so the caller can surface the limitation.
-	 *
-	 * @param {number|string} _envId
-	 * @returns {Promise<void>}
-	 */
-	async stopEnvironment(_envId) { throw new Error(`${this.name}: stopEnvironment not implemented`); }
-}

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

@@ -1,348 +0,0 @@
-/**
- * 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 = "", ref = this._defaultBranch) {
-		const data = await this._req(`/git/trees/${ref}?recursive=1`);
-		return (data.tree ?? [])
-			.filter((item) => item.type === "blob")
-			.filter((item) => !srcPath || item.path.startsWith(srcPath + "/") || item.path === srcPath)
-			.filter((item) => /\.(ts|tsx|js|jsx|json|css|yaml|yml|md|go|py|rs|java|rb|sh|toml)$/.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();
-	}
-}