@ipul-labs/forge 1.13.0

package/bin/cli/doctor.js

@@ -0,0 +1,161 @@
+import { existsSync } from "node:fs";
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import React, { useEffect, useState } from "react";
+import Spinner from "ink-spinner";
+import { h, Box, Text, useApp, runApp } from "./ink.js";
+import { projectRoot } from "./utils.js";
+
+const execFileP = promisify(execFile);
+
+function CheckRow({ name, status, message }) {
+	const label = name.padEnd(18);
+	if (status === "pending") {
+		return h`<${Box}>
+			<${Text} color="gray">○ ${label} </>
+			<${Text} dimColor>queued</>
+		</>`;
+	}
+	if (status === "running") {
+		return h`<${Box}>
+			<${Text} color="cyan"><${Spinner} type="dots"/></>
+			<${Text}> ${label} </>
+			<${Text} dimColor>checking…</>
+		</>`;
+	}
+	if (status === "pass") {
+		return h`<${Box}>
+			<${Text} color="green">✓</>
+			<${Text}> ${label} </>
+			<${Text} dimColor>${message ?? ""}</>
+		</>`;
+	}
+	return h`<${Box}>
+		<${Text} color="red">✘</>
+		<${Text}> ${label} </>
+		<${Text} color="red">${message ?? ""}</>
+	</>`;
+}
+
+function Doctor({ checks, onDone }) {
+	const { exit } = useApp();
+	const [rows, setRows] = useState(() =>
+		checks.map((c) => ({ name: c.name, status: "pending", message: "" })),
+	);
+	const [done, setDone] = useState(null);
+
+	useEffect(() => {
+		let cancelled = false;
+		(async () => {
+			let failed = 0;
+			for (let i = 0; i < checks.length; i++) {
+				if (cancelled) return;
+				setRows((s) =>
+					s.map((row, idx) => (idx === i ? { ...row, status: "running" } : row)),
+				);
+				try {
+					const msg = await checks[i].fn();
+					if (cancelled) return;
+					setRows((s) =>
+						s.map((row, idx) =>
+							idx === i ? { ...row, status: "pass", message: msg } : row,
+						),
+					);
+				} catch (err) {
+					if (cancelled) return;
+					setRows((s) =>
+						s.map((row, idx) =>
+							idx === i
+								? { ...row, status: "fail", message: err.message || String(err) }
+								: row,
+						),
+					);
+					failed += 1;
+				}
+			}
+			setDone({ failed });
+		})();
+		return () => {
+			cancelled = true;
+		};
+	}, []);
+
+	useEffect(() => {
+		if (!done) return;
+		onDone(done.failed);
+		exit();
+	}, [done]);
+
+	return h`<${Box} flexDirection="column">
+		${rows.map((r, i) =>
+			h`<${CheckRow} key=${i} name=${r.name} status=${r.status} message=${r.message} />`,
+		)}
+	</>`;
+}
+
+export async function cmdDoctor() {
+	const checks = [
+		{
+			name: "node >= 20",
+			fn: () => {
+				const major = parseInt(process.versions.node.split(".")[0], 10);
+				if (major < 20) throw new Error(`found ${process.versions.node}`);
+				return process.versions.node;
+			},
+		},
+		{
+			name: "git",
+			fn: async () => {
+				const { stdout } = await execFileP("git", ["--version"]);
+				return stdout.trim();
+			},
+		},
+		{
+			name: "claude CLI",
+			fn: async () => {
+				const { stdout } = await execFileP("claude", ["--version"]);
+				return stdout.trim();
+			},
+		},
+		{
+			name: "FORGE_TOKEN",
+			fn: () => {
+				if (!process.env.FORGE_TOKEN) throw new Error("not set (run: forge-agent init)");
+				return "set";
+			},
+		},
+		{
+			name: "config file",
+			fn: async () => {
+				const p =
+					process.env.FORGE_CONFIG_PATH ??
+					path.join(os.homedir(), ".forge", "config.json");
+				if (!existsSync(p)) throw new Error(`missing at ${p}`);
+				const cfg = JSON.parse(await fs.readFile(p, "utf8"));
+				const n = cfg.repos?.length ?? 0;
+				return `${p} (${n} repo${n === 1 ? "" : "s"})`;
+			},
+		},
+		{
+			name: "frontend build",
+			fn: () => {
+				const spa = path.join(projectRoot, "dist", "index.html");
+				if (!existsSync(spa)) throw new Error("not built (run: npm run build:app)");
+				return "dist/";
+			},
+		},
+	];
+
+	let failed = 0;
+	await runApp(
+		h`<${Doctor} checks=${checks} onDone=${(n) => (failed = n)} />`,
+	);
+
+	if (failed) {
+		process.stderr.write(`\n${failed} check${failed === 1 ? "" : "s"} failed.\n`);
+		process.exit(1);
+	}
+}

package/bin/cli/init.js

@@ -0,0 +1,306 @@
+import { existsSync } from "node:fs";
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { randomBytes } from "node:crypto";
+import React, { useEffect, useState } from "react";
+import TextInput from "ink-text-input";
+import SelectInput from "ink-select-input";
+import { h, Box, Text, useApp, runApp } from "./ink.js";
+import { projectRoot } from "./utils.js";
+
+const SCM_OPTIONS = [
+	{ label: "gitlab", value: "gitlab" },
+	{ label: "github", value: "github" },
+	{ label: "azuredevops", value: "azuredevops" },
+];
+
+const YESNO = [
+	{ label: "no, abort", value: "no" },
+	{ label: "yes, overwrite", value: "yes" },
+];
+
+const ADD_REPO_YESNO = [
+	{ label: "no, that's all", value: "no" },
+	{ label: "yes, add another", value: "yes" },
+];
+
+function Field({ label, hint, children }) {
+	return h`<${Box} flexDirection="column" marginBottom=${1}>
+		<${Box}>
+			<${Text} color="cyan">? </>
+			<${Text}>${label}</>
+			${hint ? h`<${Text} dimColor>  (${hint})</>` : null}
+		</>
+		<${Box} marginLeft=${2}>${children}</>
+	</>`;
+}
+
+function Summary({ field, value }) {
+	return h`<${Box}>
+		<${Text} color="green">✓ </>
+		<${Text}>${field}: </>
+		<${Text} dimColor>${value}</>
+	</>`;
+}
+
+function InitWizard({ envPath, hasExisting, force, onDone }) {
+	const { exit } = useApp();
+	const generatedToken = React.useMemo(() => randomBytes(24).toString("hex"), []);
+
+	const [step, setStep] = useState(hasExisting && !force ? "overwrite" : "token");
+	const [data, setData] = useState({
+		token: "",
+		port: "",
+		scm: "gitlab",
+		repos: [],
+		scmToken: "",
+	});
+	const [input, setInput] = useState("");
+	const [savedPaths, setSavedPaths] = useState(null);
+	const [error, setError] = useState(null);
+
+	useEffect(() => {
+		if (step === "abort") {
+			onDone({ aborted: true });
+			exit();
+		} else if (step === "done") {
+			onDone({ ok: true, savedPaths });
+			exit();
+		} else if (step === "error") {
+			onDone({ error });
+			exit(error);
+		}
+	}, [step]);
+
+	useEffect(() => {
+		if (step !== "save") return;
+		(async () => {
+			try {
+				await fs.writeFile(
+					envPath,
+					`FORGE_TOKEN=${data.token}\nPORT=${data.port}\nNODE_ENV=production\n`,
+					"utf8",
+				);
+				const { patch } = await import(
+					path.join(projectRoot, "server/forge/core/configStore.js")
+				);
+				await patch({
+					repos: data.repos.map((id) => ({ id, label: id })),
+					connections: { [data.scm]: { token: data.scmToken } },
+				});
+				const cfgPath =
+					process.env.FORGE_CONFIG_PATH ??
+					path.join(os.homedir(), ".forge", "config.json");
+				setSavedPaths({ envPath, cfgPath });
+				setStep("done");
+			} catch (err) {
+				setError(err);
+				setStep("error");
+			}
+		})();
+	}, [step]);
+
+	if (step === "overwrite") {
+		return h`<${Box} flexDirection="column">
+			<${Text}>forge-agent init</>
+			<${Box} marginTop=${1}>
+				<${Text} color="yellow">! </>
+				<${Text}>${envPath} exists — overwrite?</>
+			</>
+			<${Box} marginLeft=${2}>
+				<${SelectInput}
+					items=${YESNO}
+					onSelect=${(item) => {
+						if (item.value === "yes") setStep("token");
+						else setStep("abort");
+					}} />
+			</>
+		</>`;
+	}
+
+	if (step === "token") {
+		return h`<${Box} flexDirection="column">
+			<${Text}>forge-agent init</>
+			<${Box} marginTop=${1}/>
+			<${Field} label="FORGE_TOKEN" hint="press Enter to use generated">
+				<${TextInput}
+					value=${input}
+					placeholder=${generatedToken}
+					onChange=${setInput}
+					onSubmit=${(v) => {
+						const value = v || generatedToken;
+						setData((d) => ({ ...d, token: value }));
+						setInput("");
+						setStep("port");
+					}} />
+			</>
+		</>`;
+	}
+
+	if (step === "port") {
+		return h`<${Box} flexDirection="column">
+			<${Summary} field="FORGE_TOKEN" value=${maskToken(data.token)} />
+			<${Field} label="PORT" hint="default 5001">
+				<${TextInput}
+					value=${input}
+					placeholder="5001"
+					onChange=${setInput}
+					onSubmit=${(v) => {
+						const value = v || "5001";
+						setData((d) => ({ ...d, port: value }));
+						setInput("");
+						setStep("scm");
+					}} />
+			</>
+		</>`;
+	}
+
+	if (step === "scm") {
+		return h`<${Box} flexDirection="column">
+			<${Summary} field="FORGE_TOKEN" value=${maskToken(data.token)} />
+			<${Summary} field="PORT" value=${data.port} />
+			<${Field} label="SCM provider" hint="↑/↓ to choose">
+				<${SelectInput}
+					items=${SCM_OPTIONS}
+					onSelect=${(item) => {
+						setData((d) => ({ ...d, scm: item.value }));
+						setStep("repo");
+					}} />
+			</>
+		</>`;
+	}
+
+	if (step === "repo") {
+		const isFirst = data.repos.length === 0;
+		const label = isFirst ? "Primary repo" : `Additional repo #${data.repos.length + 1}`;
+		const hint = isFirst
+			? "group/repo (this becomes the default)"
+			: "group/repo for cross-repo fixes";
+		return h`<${Box} flexDirection="column">
+			<${Summary} field="FORGE_TOKEN" value=${maskToken(data.token)} />
+			<${Summary} field="PORT" value=${data.port} />
+			<${Summary} field="SCM provider" value=${data.scm} />
+			${data.repos.map((r, i) =>
+				h`<${Summary} key=${i} field=${i === 0 ? "Primary repo" : `Repo #${i + 1}`} value=${r} />`,
+			)}
+			<${Field} label=${label} hint=${hint}>
+				<${TextInput}
+					value=${input}
+					onChange=${setInput}
+					onSubmit=${(v) => {
+						const trimmed = v.trim();
+						if (!trimmed) {
+							if (isFirst) return; // primary required, stay on step
+							setStep("scmToken");
+							return;
+						}
+						setData((d) => ({ ...d, repos: [...d.repos, trimmed] }));
+						setInput("");
+						setStep("repoMore");
+					}} />
+			</>
+		</>`;
+	}
+
+	if (step === "repoMore") {
+		return h`<${Box} flexDirection="column">
+			<${Summary} field="FORGE_TOKEN" value=${maskToken(data.token)} />
+			<${Summary} field="PORT" value=${data.port} />
+			<${Summary} field="SCM provider" value=${data.scm} />
+			${data.repos.map((r, i) =>
+				h`<${Summary} key=${i} field=${i === 0 ? "Primary repo" : `Repo #${i + 1}`} value=${r} />`,
+			)}
+			<${Field} label="Add another repo?" hint="enables cross-repo fixes (e.g. web-app + api)">
+				<${SelectInput}
+					items=${ADD_REPO_YESNO}
+					onSelect=${(item) => {
+						if (item.value === "yes") setStep("repo");
+						else setStep("scmToken");
+					}} />
+			</>
+		</>`;
+	}
+
+	if (step === "scmToken") {
+		return h`<${Box} flexDirection="column">
+			<${Summary} field="FORGE_TOKEN" value=${maskToken(data.token)} />
+			<${Summary} field="PORT" value=${data.port} />
+			<${Summary} field="SCM provider" value=${data.scm} />
+			${data.repos.map((r, i) =>
+				h`<${Summary} key=${i} field=${i === 0 ? "Primary repo" : `Repo #${i + 1}`} value=${r} />`,
+			)}
+			<${Field} label=${`${data.scm} token`}>
+				<${TextInput}
+					value=${input}
+					onChange=${setInput}
+					mask="*"
+					onSubmit=${(v) => {
+						setData((d) => ({ ...d, scmToken: v }));
+						setInput("");
+						setStep("save");
+					}} />
+			</>
+		</>`;
+	}
+
+	if (step === "save") {
+		return h`<${Box}>
+			<${Text} color="cyan">… </>
+			<${Text}>Writing config…</>
+		</>`;
+	}
+
+	if (step === "done") {
+		return h`<${Box} flexDirection="column">
+			<${Box}>
+				<${Text} color="green">✓ </>
+				<${Text}>Wrote ${savedPaths?.envPath}</>
+			</>
+			<${Box}>
+				<${Text} color="green">✓ </>
+				<${Text}>Wrote ${savedPaths?.cfgPath}</>
+			</>
+			<${Box} marginTop=${1}>
+				<${Text} dimColor>${`Configured ${data.repos.length} repo${data.repos.length === 1 ? "" : "s"} (primary: ${data.repos[0] ?? "none"}).`}</>
+			</>
+			<${Box}>
+				<${Text} dimColor>${"Next: forge-agent doctor   |   forge-agent issues   |   forge-agent start"}</>
+			</>
+		</>`;
+	}
+
+	if (step === "abort") {
+		return h`<${Text} dimColor>Aborted.</>`;
+	}
+
+	if (step === "error") {
+		return h`<${Box}>
+			<${Text} color="red">✘ </>
+			<${Text}>${error?.message || String(error)}</>
+		</>`;
+	}
+
+	return null;
+}
+
+function maskToken(t) {
+	if (!t) return "";
+	if (t.length <= 8) return "*".repeat(t.length);
+	return `${t.slice(0, 4)}…${t.slice(-4)}`;
+}
+
+export async function cmdInit({ force }) {
+	const envPath = path.join(process.cwd(), ".env");
+	const hasExisting = existsSync(envPath);
+
+	let outcome = { ok: false };
+	await runApp(
+		h`<${InitWizard}
+			envPath=${envPath}
+			hasExisting=${hasExisting}
+			force=${force}
+			onDone=${(o) => (outcome = o)} />`,
+	);
+	if (outcome.error) process.exit(1);
+}

package/bin/cli/ink.js

@@ -0,0 +1,57 @@
+import React, { useEffect } from "react";
+import htm from "htm";
+import SelectInput from "ink-select-input";
+import { Box, Text, Newline, render, useApp, useInput } from "ink";
+
+export const h = htm.bind(React.createElement);
+export { Box, Text, Newline, render, useApp, useInput, React };
+
+/**
+ * Render an Ink component, resolve when it exits via useApp().exit().
+ * If the component calls exit(err), the promise rejects with that error.
+ */
+export async function runApp(element) {
+	const instance = render(element);
+	try {
+		await instance.waitUntilExit();
+	} finally {
+		instance.unmount();
+	}
+}
+
+const CONFIRM_ITEMS = [
+	{ label: "no", value: "no" },
+	{ label: "yes", value: "yes" },
+];
+
+/**
+ * Yes/no confirmation prompt. Defaults to "no" (cursor on the safe option).
+ * Calls onSelect(true) on yes, onSelect(false) on no.
+ *
+ * Bypass it programmatically by setting `bypassYes={true}` — fires onSelect(true)
+ * once on mount, doesn't render an interactive picker. Lets `--yes` callers
+ * reuse the same component.
+ */
+export function Confirm({ message, onSelect, bypassYes = false }) {
+	useEffect(() => {
+		if (bypassYes) onSelect(true);
+	}, [bypassYes]);
+	if (bypassYes) {
+		return h`<${Box}>
+			<${Text} color="green">✓ </>
+			<${Text}>${message}</>
+			<${Text} dimColor> (--yes)</>
+		</>`;
+	}
+	return h`<${Box} flexDirection="column" marginTop=${1}>
+		<${Box}>
+			<${Text} color="yellow">? </>
+			<${Text}>${message}</>
+		</>
+		<${Box} marginLeft=${2}>
+			<${SelectInput}
+				items=${CONFIRM_ITEMS}
+				onSelect=${(item) => onSelect(item.value === "yes")} />
+		</>
+	</>`;
+}

package/bin/cli/issue.js

@@ -0,0 +1,116 @@
+import path from "node:path";
+import React, { useEffect, useState } from "react";
+import Spinner from "ink-spinner";
+import { h, Box, Text, useApp, runApp } from "./ink.js";
+import { getFlag, projectRoot, resolvePrimaryRepo } from "./utils.js";
+
+function IssueDetail({ issue, repo }) {
+	const labels = (issue.labels ?? []).join(", ");
+	return h`<${Box} flexDirection="column">
+		<${Box}>
+			<${Text} color="yellow">#${issue.iid} </>
+			<${Text} bold>${issue.title}</>
+		</>
+		<${Box}>
+			<${Text} dimColor>${`${repo} · ${issue.author?.name ?? "unknown"} · ${issue.created_at ?? ""}`}</>
+		</>
+		${labels
+			? h`<${Box}>
+				<${Text} dimColor>labels: </>
+				<${Text}>${labels}</>
+			</>`
+			: null}
+		${issue.web_url
+			? h`<${Box}>
+				<${Text} dimColor>${issue.web_url}</>
+			</>`
+			: null}
+		<${Box} marginTop=${1}>
+			<${Text} dimColor>${"─── description ───"}</>
+		</>
+		<${Box} marginTop=${1}>
+			<${Text}>${issue.description ?? "(no description)"}</>
+		</>
+		<${Box} marginTop=${1}>
+			<${Text} dimColor>${`Next: forge-agent ship ${issue.iid}`}</>
+		</>
+	</>`;
+}
+
+function IssueView({ iid, repo, onDone }) {
+	const { exit } = useApp();
+	const [issue, setIssue] = useState(null);
+	const [error, setError] = useState(null);
+	const [done, setDone] = useState(null);
+
+	useEffect(() => {
+		if (!done) return;
+		onDone(done);
+		exit();
+	}, [done]);
+
+	useEffect(() => {
+		(async () => {
+			try {
+				const { createProvider } = await import(
+					path.join(projectRoot, "server/forge/core/providers/index.js")
+				);
+				const provider = createProvider(repo);
+				const i = await provider.getIssue(iid);
+				setIssue(i);
+				setDone({ ok: true });
+			} catch (err) {
+				setError(err);
+				setDone({ ok: false, error: err });
+			}
+		})();
+	}, []);
+
+	if (error) {
+		return h`<${Box}>
+			<${Text} color="red">${`✘ ${error.message ?? String(error)}`}</>
+		</>`;
+	}
+	if (!issue) {
+		return h`<${Box}>
+			<${Text} color="cyan"><${Spinner} type="dots"/></>
+			<${Text}>${` Fetching issue #${iid} from ${repo}…`}</>
+		</>`;
+	}
+	return h`<${IssueDetail} issue=${issue} repo=${repo} />`;
+}
+
+export async function cmdIssue(argv) {
+	const iid = Number(argv[1]);
+	if (!Number.isInteger(iid) || iid <= 0) {
+		console.error("Usage: forge-agent issue <iid> [--repo <id>]");
+		process.exit(1);
+	}
+	const repo = (await resolvePrimaryRepo(argv)) ?? null;
+	if (!repo) {
+		console.error(
+			"No repo. Pass --repo <group/repo>, set FORGE_GITLAB_PROJECT, or run `forge-agent init`.",
+		);
+		process.exit(1);
+	}
+	const json = argv.includes("--json");
+	if (json) {
+		const { createProvider } = await import(
+			path.join(projectRoot, "server/forge/core/providers/index.js")
+		);
+		try {
+			const i = await createProvider(repo).getIssue(iid);
+			process.stdout.write(`${JSON.stringify(i, null, 2)}\n`);
+		} catch (err) {
+			process.stdout.write(`${JSON.stringify({ error: err.message })}\n`);
+			process.exit(2);
+		}
+		return;
+	}
+
+	let outcome = { ok: false };
+	await runApp(
+		h`<${IssueView} iid=${iid} repo=${repo} onDone=${(o) => (outcome = o)} />`,
+	);
+	if (!outcome.ok) process.exit(2);
+}