@ipul-labs/forge 1.13.0

package/bin/forge-agent.js

@@ -0,0 +1,174 @@
+#!/usr/bin/env node
+import { existsSync } from "node:fs";
+import path from "node:path";
+import { projectRoot, parsePort, readPkg } from "./cli/utils.js";
+import { cmdDoctor } from "./cli/doctor.js";
+import { cmdIssues } from "./cli/issues.js";
+import { cmdAnalyze } from "./cli/analyze.js";
+import { cmdInit } from "./cli/init.js";
+import { cmdRepos } from "./cli/repos.js";
+import { cmdSession, cmdShow } from "./cli/session.js";
+import { cmdValidate } from "./cli/validate.js";
+import { cmdApply } from "./cli/apply.js";
+import { cmdRefine } from "./cli/refine.js";
+import { cmdWatch } from "./cli/watch.js";
+import { cmdCiFix } from "./cli/cifix.js";
+import { cmdMerge } from "./cli/merge.js";
+import { cmdResolutionCheck } from "./cli/resolution.js";
+import { cmdClose } from "./cli/close.js";
+import { cmdShip } from "./cli/ship.js";
+import { cmdIssue } from "./cli/issue.js";
+
+function usage() {
+	process.stdout.write(`
+forge-agent — AI-powered code change & deploy control panel
+
+Usage
+  forge-agent <command> [options]
+
+Commands
+  ship <iid>           ★ End-to-end: analyze → review → validate → apply →
+                       watch CI → merge → watch deploy → close (gates at every
+                       state-changing step). Resumable via session.
+  init                 Interactive setup — writes .env + ~/.forge/config.json
+  start                Boot the Forge server at http://localhost:$PORT
+  repos                Manage configured repos (list | add | set-default | remove)
+  issues               List open issues (--label X, --mine, --limit N)
+  issue <iid>          Show full description, labels, author, web URL
+  analyze <iid>        Run issue analysis; caches result to ~/.forge/sessions
+  show [<iid>]         Re-render the cached analysis for <iid> (or HEAD)
+  refine [<iid>]       Iterate the cached analysis with feedback (--feedback "...")
+  validate [<iid>]     Run lint/typecheck/test against the cached proposal
+  apply [<iid>]        Push branch + open MR per repo (confirms by default)
+  watch [<iid>]        Poll the MR pipeline until it succeeds or fails
+  ci-fix [<iid>]       Re-analyse with failed-pipeline logs; push to existing branch
+  merge [<iid>]        Merge the MR (confirms by default; --auto arms auto-merge)
+  resolution-check     Verify the merged MR actually closes the issue
+  close [<iid>]        Close the issue (confirms by default)
+  session              Inspect cached sessions (list | show | clean)
+  doctor               Check prerequisites (node, git, claude CLI, token, config)
+  version              Print version
+  help                 Show this help
+
+Options
+  -p, --port <n>       Port for start (overrides $PORT; default 5001)
+  --repo <group/repo>  Primary repo for issues/analyze (overrides default)
+  --secondary <repo>   Additional repo for cross-repo analyze (repeatable)
+  --all-repos          Include every configured repo as a secondary
+  --model <id>         Claude model for analyze
+  --agent <name>       Agent backend for analyze: claude | openclaw (default claude)
+  --prompt <text>      Extra user prompt injected into analysis
+  --limit <n>          Cap issue count for issues
+  --json               JSON output (NDJSON for analyze; array for issues)
+  --quiet              Suppress progress; print only final result
+  --force              Overwrite existing files (init)
+  --yes                Skip the confirmation gate on apply (also: FORGE_YES=1)
+  --validate           Run validate before apply, refuse to apply if red
+  --feedback <text>    Refine feedback (refine command)
+
+Examples
+  forge-agent init
+  forge-agent start --port 5055
+  forge-agent repos add group/other-repo
+  forge-agent repos set-default group/other-repo
+  forge-agent issues --limit 10
+  forge-agent analyze 42 --repo group/repo
+  forge-agent analyze 42 --json | jq .
+  forge-agent doctor
+
+`);
+}
+
+async function cmdVersion() {
+	const pkg = await readPkg();
+	console.log(pkg.version);
+}
+
+async function cmdStart({ port }) {
+	process.env.NODE_ENV = process.env.NODE_ENV ?? "production";
+	if (port != null) process.env.PORT = String(port);
+
+	const spa = path.join(projectRoot, "dist", "index.html");
+	if (!existsSync(spa)) {
+		console.error("Frontend build not found. Run: npm run build:app");
+		process.exit(1);
+	}
+
+	await import(path.join(projectRoot, "server.js"));
+}
+
+async function main() {
+	try {
+		const { config } = await import("dotenv");
+		config({ quiet: true });
+	} catch {
+		/* dotenv optional at CLI load */
+	}
+
+	const argv = process.argv.slice(2);
+	const cmd = argv[0];
+	const flags = {
+		force: argv.includes("--force"),
+		port: parsePort(argv),
+	};
+
+	switch (cmd) {
+		case "init":
+			return cmdInit(flags);
+		case "start":
+			return cmdStart(flags);
+		case "repos":
+			return cmdRepos(argv);
+		case "issues":
+			return cmdIssues(argv);
+		case "issue":
+			return cmdIssue(argv);
+		case "analyze":
+			return cmdAnalyze(argv);
+		case "show":
+			return cmdShow(argv);
+		case "refine":
+			return cmdRefine(argv);
+		case "validate":
+			return cmdValidate(argv);
+		case "apply":
+			return cmdApply(argv);
+		case "watch":
+			return cmdWatch(argv);
+		case "ci-fix":
+		case "cifix":
+			return cmdCiFix(argv);
+		case "merge":
+			return cmdMerge(argv);
+		case "resolution-check":
+		case "resolution":
+			return cmdResolutionCheck(argv);
+		case "close":
+			return cmdClose(argv);
+		case "ship":
+			return cmdShip(argv);
+		case "session":
+			return cmdSession(argv);
+		case "doctor":
+			return cmdDoctor(flags);
+		case "version":
+		case "--version":
+		case "-v":
+			return cmdVersion();
+		case "help":
+		case "--help":
+		case "-h":
+		case undefined:
+			usage();
+			return;
+		default:
+			console.error(`Unknown command: ${cmd}\n`);
+			usage();
+			process.exit(1);
+	}
+}
+
+main().catch((err) => {
+	console.error(err.stack || err.message || err);
+	process.exit(1);
+});