@ipul-labs/forge 1.16.7 → 1.17.0

package/{bin → lib/bin}/forge-agent.js

@@ -1,4 +1,12 @@
 #!/usr/bin/env node
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
 import { existsSync } from "node:fs";
 import path from "node:path";
 import { projectRoot, parsePort, readPkg } from "./cli/utils.js";
@@ -21,17 +29,15 @@ import { cmdIssue } from "./cli/issue.js";
 import { cmdCreateIssue } from "./cli/createIssue.js";
 import { startRepl } from "./cli/repl.js";
 import { cmdUpdate } from "./cli/update.js";
-
 async function cmdUse(argv) {
-	const repoId = argv[1];
-	if (!repoId) {
-		return cmdRepos(["repos", "list"]);
-	}
-	return cmdRepos(["repos", "set-default", repoId]);
+    const repoId = argv[1];
+    if (!repoId) {
+        return cmdRepos(["repos", "list"]);
+    }
+    return cmdRepos(["repos", "set-default", repoId]);
 }
-
 function usage() {
-	process.stdout.write(`
+    process.stdout.write(`
 forge — AI-powered code change & deploy control panel
 
 Usage
@@ -96,110 +102,103 @@ Examples
 
 `);
 }
-
 async function cmdVersion() {
-	const pkg = await readPkg();
-	console.log(pkg.version);
+    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"));
+    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(__rewriteRelativeImportExtension(path.join(projectRoot, "server.ts")));
 }
-
 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];
-
-	if (!cmd) return startRepl(dispatch);
-
-	return dispatch(argv);
+    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];
+    if (!cmd)
+        return startRepl(dispatch);
+    return dispatch(argv);
 }
-
 async function dispatch(argv) {
-	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 "create-issue":
-			return cmdCreateIssue(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 "use":
-			return cmdUse(argv);
-		case "update":
-			return cmdUpdate();
-		case "version":
-		case "--version":
-		case "-v":
-			return cmdVersion();
-		case "help":
-		case "--help":
-		case "-h":
-			usage();
-			return;
-		default:
-			console.error(`Unknown command: ${cmd}\n`);
-			usage();
-			process.exit(1);
-	}
+    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 "create-issue":
+            return cmdCreateIssue(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();
+        case "use":
+            return cmdUse(argv);
+        case "update":
+            return cmdUpdate();
+        case "version":
+        case "--version":
+        case "-v":
+            return cmdVersion();
+        case "help":
+        case "--help":
+        case "-h":
+            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);
+    console.error(err.stack || err.message || err);
+    process.exit(1);
 });
+//# sourceMappingURL=forge-agent.js.map

package/lib/bin/forge-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"forge-agent.js","sourceRoot":"","sources":["../../bin/forge-agent.ts"],"names":[],"mappings":"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"}

package/lib/server/forge/core/ForgeAgent.d.ts

@@ -0,0 +1,260 @@
+/**
+ * server/forge/core/ForgeAgent.ts
+ *
+ * Orchestrates the full Forge pipeline across one or more repositories.
+ *
+ *   analyzeIssue  → identify files across all repos → fetch contents → propose fix
+ *   applyFix      → group changes by repo → per repo: branch + commit + MR
+ *   refineIssue   → re-run pass 2 with feedback; reuses prior file paths per-repo
+ *   ciFixIssue    → target fix at CI failure logs
+ *
+ * Progress is reported via an optional onProgress callback so that
+ * the calling route can stream SSE events to the client.
+ *
+ * Multi-repo model
+ * ────────────────
+ * - `primaryProject` is the repo where the issue lives.
+ * - `secondaryProjects` are additional repos the fix can span (full-stack).
+ * - The AI sees every repo's file tree in pass 1 and tags files with repo id.
+ * - In pass 2 it proposes changes tagged with the repo they target.
+ * - `applyFix` groups by repo and creates one branch + MR per repo.
+ */
+import type { ScmProvider } from "./providers/base.ts";
+import type { CreateMRParams } from "./providers/base.ts";
+import type { NormalIssue, NormalMR } from "./providers/types.ts";
+import type { AnalysisResult, ForgeChange, ForgeEvent } from "./types.ts";
+/** Constructor options for ForgeAgent. */
+interface ForgeAgentOptions {
+    project?: string;
+    secondaryProjects?: string[];
+    agent?: string;
+}
+/** A { repo, path } entry from the AI's file selection. */
+interface FileEntry {
+    repo: string;
+    path: string;
+}
+/** A repo's file-tree result from _fetchAllTrees. */
+interface RepoTree {
+    repo: string;
+    files: string[];
+}
+/** A file fetched from a repo (repo + path + content). */
+interface FileContent {
+    repo: string;
+    path: string;
+    content: string;
+}
+/** The raw result from proposeFix / refine calls. */
+interface ProposeResult {
+    title?: string;
+    explanation?: string;
+    changes?: RawChange[];
+    removals?: Array<{
+        file: string;
+        what: string;
+    }>;
+    cost?: number;
+    serviceTier?: string;
+    inputTokens?: number;
+    outputTokens?: number;
+    cacheCreationTokens?: number;
+    cacheReadTokens?: number;
+    rateLimit?: unknown;
+}
+/** A raw change from the model before normalisation. */
+interface RawChange {
+    file: string;
+    action: "create" | "modify" | "delete";
+    proposed?: string;
+    summary?: string;
+    repo?: string;
+}
+/** An enriched change after normalisation (with repo + original). */
+interface EnrichedChange extends RawChange {
+    repo: string;
+    original: string | null;
+}
+/** The analysis result with optional removals. */
+interface EnrichedAnalysisResult extends AnalysisResult {
+    removals?: Array<{
+        file: string;
+        what: string;
+    }>;
+}
+/** Options bag with optional AbortSignal. */
+interface SignalOpts {
+    signal?: AbortSignal;
+}
+/** The result of the analysis "kind" argument. */
+type AnalysisKind = "fresh" | "new" | "update" | "retry";
+/** Result from applying changes to a single repo. */
+interface ApplicationResult {
+    repo: string;
+    branchName: string;
+    mr: NormalMR | null;
+    pipelineUrl: string | null;
+}
+/** Validation state passed to refine. */
+interface ValidationState {
+    passed: boolean;
+    steps: Array<{
+        step: string;
+        passed: boolean;
+        output?: string;
+    }>;
+    logs: string[];
+}
+export declare class ForgeAgent {
+    primaryProject: string;
+    secondaryProjects: string[];
+    allRepos: string[];
+    agent: string;
+    providers: Map<string, ScmProvider>;
+    provider: ScmProvider;
+    constructor(opts?: ForgeAgentOptions);
+    _provider(repo: string): ScmProvider;
+    get _agentLabel(): "OpenClaw" | "Claude";
+    get _isMultiRepo(): boolean;
+    _fetchAllTrees(emit: (evt: ForgeEvent) => void): Promise<RepoTree[]>;
+    _fetchFiles(entries: FileEntry[], emit: (evt: ForgeEvent) => void): Promise<FileContent[]>;
+    /**
+     * Normalises raw file entries coming back from the model.
+     * The schema now asks for `{ repo, path }` objects, but older prompts /
+     * smaller models occasionally return plain strings — default those to the
+     * primary repo.
+     */
+    _normalizeFileSelections(rawEntries: unknown[]): FileEntry[];
+    _validateSelections(entries: FileEntry[], repoTrees: RepoTree[]): {
+        valid: FileEntry[];
+        skipped: string[];
+    };
+    /** Enforces the per-repo and total caps, preserving model order. */
+    _capSelections(entries: FileEntry[], issueKind: string): FileEntry[];
+    _normalizeChanges(rawChanges: RawChange[] | undefined, fileContents: FileContent[]): EnrichedChange[];
+    /**
+     * Runs the full analysis pipeline for an issue across all configured repos.
+     *
+     * @param {number} issueIid
+     * @param {(event: ProgressEvent|LogEvent|ResultEvent|ErrorEvent) => void} [onProgress]
+     * @param {string} [model]
+     * @param {string} [ciContext]
+     * @param {string} [userPrompt]
+     * @returns {Promise<AnalysisResult>}
+     */
+    analyzeIssue(issueIid: number, onProgress: ((evt: ForgeEvent) => void) | undefined, model: string | undefined, ciContext: string | undefined, userPrompt: string | undefined, kind?: AnalysisKind, opts?: SignalOpts, previousChanges?: ForgeChange[] | null): Promise<EnrichedAnalysisResult>;
+    /**
+     * Re-runs pass 2 with reviewer feedback and the prior proposed changes as
+     * additional context. Reuses the previous files (per-repo) — no new file
+     * discovery.
+     */
+    refineIssue(issueIid: number, previousChanges: ForgeChange[] | null, feedback: string, onProgress: ((evt: ForgeEvent) => void) | undefined, model: string | undefined, ciContext: string | undefined, validationState: ValidationState | null, claudeSessionId: string | null, opts?: SignalOpts): Promise<EnrichedAnalysisResult | {
+        kind: string;
+        answer: string;
+    }>;
+    /**
+     * Shared tail for both ciFix-style proposeFix results and directive refine
+     * results: normalises changes, emits the result + usage events, and returns
+     * the AnalysisResult so callers can still await it.
+     */
+    _emitRefineResult(propose: ProposeResult, fileContents: FileContent[], issue: NormalIssue, emit: (evt: ForgeEvent) => void, label: string): EnrichedAnalysisResult;
+    /**
+     * Targeted fix for a CI pipeline failure. Uses the CI logs as the primary
+     * signal for file selection instead of the issue description.
+     */
+    ciFixIssue(issueIid: number, ciContext: string, onProgress: ((evt: ForgeEvent) => void) | undefined, model: string | undefined, opts?: SignalOpts): Promise<{
+        issue: NormalIssue;
+        mrTitle: string;
+        explanation: string;
+        reasoning: string;
+        changes: EnrichedChange[];
+        repos: string[];
+    }>;
+    /**
+     * Asks the model whether the diffs in a merged MR actually fix the issue.
+     * The issue lives in the primary repo; the MR is fetched from whichever
+     * provider created it.
+     */
+    checkResolution(issueIid: number, mrIid: number, repo?: string): Promise<import("./types.ts").AgentResponse>;
+    /**
+     * Applies an approved analysis: creates one branch + commit + MR per repo
+     * that has changes. Primary repo is always processed first so its MR exists
+     * before any secondary MRs that cross-reference it.
+     *
+     * @param {AnalysisResult} analysis
+     * @returns {Promise<{ applications: ApplicationResult[] }>}
+     */
+    applyFix(analysis: EnrichedAnalysisResult): Promise<{
+        applications: ApplicationResult[];
+    }>;
+    /**
+     * Pushes a new commit to an existing branch in a specific repo (e.g. to fix
+     * a failing pipeline without creating a new MR). Only affects the one repo.
+     *
+     * @param {string} branchName
+     * @param {AnalysisResult} analysis
+     * @param {string} [repo]  Defaults to primary.
+     */
+    commitToBranch(branchName: string, analysis: EnrichedAnalysisResult, repo?: string): Promise<{
+        repo: string;
+        branchName: string;
+    }>;
+    /**
+     * Opens an MR for a branch that was previously pushed via deployBranch.
+     * Used when a test-deploy pipeline goes green and the user wants to promote
+     * the change to a real MR.
+     *
+     * @param {string} branchName
+     * @param {string} repo
+     * @param {number} issueIid
+     * @returns {Promise<ApplicationResult>}
+     */
+    promoteBranchToMR(branchName: string, repo: string, issueIid: number): Promise<ApplicationResult>;
+    /**
+     * Pushes a fix as a new branch per repo without opening MRs. Used for the
+     * "Deploy to Test" flow where a branch pipeline deploys to a test namespace.
+     *
+     * @param {AnalysisResult} analysis
+     * @returns {Promise<{ applications: ApplicationResult[] }>}
+     */
+    deployBranch(analysis: EnrichedAnalysisResult): Promise<{
+        applications: ApplicationResult[];
+    }>;
+    /**
+     * Resolves each change's `repo` against the SCM (does the file actually
+     * exist there?) so we don't try to commit to the wrong repo when the
+     * model omitted or guessed `c.repo` wrong. Mirror of the validator's
+     * auto-attribution; returns a flat changes array with corrected repo.
+     * Falls back to the input on attribution failure so we never block apply
+     * on a flaky API call.
+     */
+    _correctAttribution(changes: ForgeChange[]): Promise<ForgeChange[]>;
+    _groupChangesByRepo(changes: ForgeChange[]): Map<string, ForgeChange[]>;
+    /** Primary always first, secondaries after in allRepos order. */
+    _orderedRepos(grouped: Map<string, ForgeChange[]>): string[];
+    _applyToRepo(repo: string, changes: ForgeChange[], analysis: EnrichedAnalysisResult, priorApplications: ApplicationResult[]): Promise<ApplicationResult>;
+    /**
+     * Creates a branch, tolerating the case where it already exists — the whole
+     * point of intent-based names is that multiple applies/refines reuse the
+     * same branch. GitLab returns 400 "Branch already exists"; other providers
+     * may use different strings, so we match loosely.
+     */
+    _ensureBranch(provider: ScmProvider, branchName: string, ref: string): Promise<unknown>;
+    /**
+     * Opens an MR for the given branch, or returns the existing open one if
+     * the user is re-applying to a branch that already has an MR attached.
+     * Source-branch match is exact; label updates are intentionally skipped on
+     * the reuse path to keep this idempotent.
+     */
+    _ensureMR(provider: ScmProvider, mrSpec: CreateMRParams): Promise<NormalMR>;
+    _repoShortLabel(repo: string): string;
+    _buildMRDescription(issue: {
+        iid: number;
+    }, explanation: string, changes: ForgeChange[], opts?: {
+        isPrimary?: boolean;
+        repo?: string;
+        priorApplications?: ApplicationResult[];
+    }): string;
+}
+export {};
+//# sourceMappingURL=ForgeAgent.d.ts.map

package/lib/server/forge/core/ForgeAgent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ForgeAgent.d.ts","sourceRoot":"","sources":["../../../../server/forge/core/ForgeAgent.ts"],"names":[],"mappings":"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"}