@ipul-labs/forge 1.16.8 → 1.17.0

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

@@ -0,0 +1,67 @@
+/**
+ * server/forge/core/jobs.js
+ *
+ * Unified in-memory job store with event buffering + multi-subscriber replay.
+ *
+ * Why this exists: SSE endpoints like refine / ci-fix / validate / analyze
+ * run a long task and stream events to one EventSource. If the browser
+ * reloads or React re-mounts the component, that stream dies. Before this
+ * module, the job also died — its state was deleted the moment the stream
+ * was consumed, so there was nothing to reconnect to.
+ *
+ * With this store:
+ *   1. `createJob(type, runner)` starts the runner immediately in the
+ *      background and buffers every event it emits.
+ *   2. `subscribe(id, handler)` replays the buffer synchronously, then wires
+ *      the handler to future events until the job is terminal.
+ *   3. A reconnecting client gets the full history on reconnect and then
+ *      live events — identical to if it had been watching all along.
+ *
+ * Process-restart survival is out of scope for v1 (Map is in-memory only).
+ */
+import type { ForgeEvent, JobRecord, JobSnapshot } from "./types.ts";
+/**
+ * Create and start a job. `runner` is an async function that receives
+ * `(send, signal)` — any value it returns is captured as `doneResult`.
+ * A terminal `done`, `error`, or `cancelled` event is emitted automatically
+ * when runner settles; runners must not emit those themselves.
+ *
+ * The `signal` is an `AbortSignal` that fires when a client calls `cancelJob`.
+ * Runners should forward it to any subprocess / fetch / SDK call that
+ * supports AbortSignal so the underlying work actually stops (and API/CLI
+ * costs aren't incurred for work the user no longer wants).
+ */
+interface CreateJobOptions {
+    idPrefix?: string;
+    onComplete?: (result: {
+        status: string;
+        result: unknown;
+    }) => void;
+    meta?: Record<string, unknown>;
+}
+export declare function createJob(type: string, runner: (send: (event: ForgeEvent) => void, signal: AbortSignal) => Promise<unknown>, { idPrefix, onComplete, meta }?: CreateJobOptions): string;
+/**
+ * Cancel a running job. Aborts the signal, emits a terminal `cancelled`
+ * event, and marks the job non-running. No-op if the job is already
+ * terminal or doesn't exist — returns whether a cancel was actually issued.
+ */
+export declare function cancelJob(id: string): boolean;
+export declare function getJob(id: string): JobRecord;
+/**
+ * Replay buffered events to `handler`, then subscribe for live events until
+ * the job reaches terminal state. Returns an `unsubscribe` function, or
+ * `null` if the job doesn't exist.
+ *
+ * The terminal `done`/`error` event is part of the buffered replay — callers
+ * that want to end the response on terminal should check for it inside
+ * their handler.
+ */
+export declare function subscribe(id: string, handler: (event: ForgeEvent) => void): () => void;
+/**
+ * Public status snapshot — safe to send to clients. Excludes the event
+ * buffer (potentially large) and subscribers (not serialisable).
+ */
+export declare function snapshot(id: string): JobSnapshot | null;
+export declare function findActiveByMeta(key: string, value: unknown): JobSnapshot;
+export {};
+//# sourceMappingURL=jobs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../../../server/forge/core/jobs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAyBrE;;;;;;;;;;GAUG;AACH,UAAU,gBAAgB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IACnE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,wBAAgB,SAAS,CACxB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,EACpF,EAAE,QAAe,EAAE,UAAU,EAAE,IAAI,EAAE,GAAE,gBAAqB,UAuD5D;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,WAiBnC;AAED,wBAAgB,MAAM,CAAC,EAAE,EAAE,MAAM,aAEhC;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,cAczE;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAavD;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,eAO3D"}

package/lib/server/forge/core/jobs.js

@@ -0,0 +1,185 @@
+/**
+ * server/forge/core/jobs.js
+ *
+ * Unified in-memory job store with event buffering + multi-subscriber replay.
+ *
+ * Why this exists: SSE endpoints like refine / ci-fix / validate / analyze
+ * run a long task and stream events to one EventSource. If the browser
+ * reloads or React re-mounts the component, that stream dies. Before this
+ * module, the job also died — its state was deleted the moment the stream
+ * was consumed, so there was nothing to reconnect to.
+ *
+ * With this store:
+ *   1. `createJob(type, runner)` starts the runner immediately in the
+ *      background and buffers every event it emits.
+ *   2. `subscribe(id, handler)` replays the buffer synchronously, then wires
+ *      the handler to future events until the job is terminal.
+ *   3. A reconnecting client gets the full history on reconnect and then
+ *      live events — identical to if it had been watching all along.
+ *
+ * Process-restart survival is out of scope for v1 (Map is in-memory only).
+ */
+const TTL_MS = 10 * 60 * 1000;
+const SWEEP_INTERVAL_MS = 60 * 1000;
+const jobs = new Map();
+let sweeper = null;
+function ensureSweeper() {
+    if (sweeper)
+        return;
+    sweeper = setInterval(() => {
+        const now = Date.now();
+        for (const [id, job] of jobs) {
+            if (job.expiresAt && job.expiresAt <= now && job.subscribers.size === 0) {
+                jobs.delete(id);
+            }
+        }
+    }, SWEEP_INTERVAL_MS);
+    sweeper.unref?.();
+}
+function newId(prefix) {
+    return `${prefix}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+}
+export function createJob(type, runner, { idPrefix = type, onComplete, meta } = {}) {
+    ensureSweeper();
+    const id = newId(idPrefix);
+    const controller = new AbortController();
+    const job = {
+        id,
+        type,
+        status: "running",
+        events: [],
+        doneResult: undefined,
+        error: null,
+        createdAt: Date.now(),
+        finishedAt: null,
+        expiresAt: null,
+        subscribers: new Set(),
+        controller,
+        meta: meta ?? {},
+    };
+    jobs.set(id, job);
+    const send = (event) => {
+        job.events.push(event);
+        for (const sub of job.subscribers) {
+            try {
+                sub(event);
+            }
+            catch { /* subscriber errors don't break fanout */ }
+        }
+    };
+    (async () => {
+        try {
+            const result = await runner(send, controller.signal);
+            if (job.status === "cancelled")
+                return;
+            job.doneResult = result ?? null;
+            job.status = "done";
+            send({ type: "done" });
+            onComplete?.({ status: "done", result });
+        }
+        catch (e) {
+            if (job.status === "cancelled")
+                return;
+            // If the runner threw because of our own abort, prefer the cancelled
+            // terminal over a misleading error event.
+            if (controller.signal.aborted) {
+                job.status = "cancelled";
+                send({ type: "cancelled" });
+                return;
+            }
+            job.status = "error";
+            job.error = (e instanceof Error ? e.message : null) ?? String(e);
+            send({ type: "error", message: job.error });
+        }
+        finally {
+            job.finishedAt = Date.now();
+            job.expiresAt = job.finishedAt + TTL_MS;
+        }
+    })();
+    return id;
+}
+/**
+ * Cancel a running job. Aborts the signal, emits a terminal `cancelled`
+ * event, and marks the job non-running. No-op if the job is already
+ * terminal or doesn't exist — returns whether a cancel was actually issued.
+ */
+export function cancelJob(id) {
+    const job = jobs.get(id);
+    if (!job)
+        return false;
+    if (job.status !== "running")
+        return false;
+    job.status = "cancelled";
+    try {
+        job.controller.abort();
+    }
+    catch { /* ignore */ }
+    // Emit the terminal *before* the runner's catch block runs, so reconnecting
+    // clients always see a cancellation event in the buffer.
+    job.events.push({ type: "cancelled" });
+    for (const sub of job.subscribers) {
+        try {
+            sub({ type: "cancelled" });
+        }
+        catch { /* ignore */ }
+    }
+    job.finishedAt = Date.now();
+    job.expiresAt = job.finishedAt + TTL_MS;
+    return true;
+}
+export function getJob(id) {
+    return jobs.get(id) ?? null;
+}
+/**
+ * Replay buffered events to `handler`, then subscribe for live events until
+ * the job reaches terminal state. Returns an `unsubscribe` function, or
+ * `null` if the job doesn't exist.
+ *
+ * The terminal `done`/`error` event is part of the buffered replay — callers
+ * that want to end the response on terminal should check for it inside
+ * their handler.
+ */
+export function subscribe(id, handler) {
+    const job = jobs.get(id);
+    if (!job)
+        return null;
+    for (const e of job.events) {
+        try {
+            handler(e);
+        }
+        catch { /* ignore */ }
+    }
+    if (job.status !== "running") {
+        return () => { };
+    }
+    job.subscribers.add(handler);
+    return () => { job.subscribers.delete(handler); };
+}
+/**
+ * Public status snapshot — safe to send to clients. Excludes the event
+ * buffer (potentially large) and subscribers (not serialisable).
+ */
+export function snapshot(id) {
+    const job = jobs.get(id);
+    if (!job)
+        return null;
+    return {
+        id: job.id,
+        type: job.type,
+        status: job.status,
+        createdAt: job.createdAt,
+        finishedAt: job.finishedAt,
+        error: job.error,
+        eventCount: job.events.length,
+        meta: job.meta,
+    };
+}
+export function findActiveByMeta(key, value) {
+    for (const job of jobs.values()) {
+        if (job.status === "running" && job.meta?.[key] === value) {
+            return snapshot(job.id);
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=jobs.js.map

package/lib/server/forge/core/jobs.js.map

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

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

@@ -0,0 +1,18 @@
+export declare function listDeployments(namespace: string): Promise<{
+    name: string;
+    namespace: string;
+    image: string;
+    replicas: {
+        desired: number;
+        ready: number;
+        available: number;
+        unavailable: number;
+        updated: number;
+    };
+    conditions: {
+        type: string;
+        status: string;
+        message: string;
+    }[];
+}[]>;
+//# sourceMappingURL=k8s.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"k8s.d.ts","sourceRoot":"","sources":["../../../../server/forge/core/k8s.ts"],"names":[],"mappings":"AA6DA,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM;;;;;;;;;;;;;;;;KAItD"}

package/lib/server/forge/core/k8s.js

@@ -0,0 +1,49 @@
+import * as k8s from "@kubernetes/client-node";
+let kc = new k8s.KubeConfig();
+function loadConfig() {
+    kc = new k8s.KubeConfig();
+    const token = process.env.K8S_CLUSTER_TOKEN;
+    const server = process.env.K8S_CLUSTER_SERVER;
+    if (token && server) {
+        kc.loadFromOptions({
+            clusters: [{ name: "cluster", server, skipTLSVerify: process.env.K8S_SKIP_TLS_VERIFY === "true" }],
+            users: [{ name: "admin", token }],
+            contexts: [{ name: "default", cluster: "cluster", user: "admin" }],
+            currentContext: "default",
+        });
+    }
+    else {
+        kc.loadFromDefault();
+    }
+}
+loadConfig();
+function getAppsApi() {
+    return kc.makeApiClient(k8s.AppsV1Api);
+}
+function formatDeployment(dep) {
+    const containers = dep.spec?.template?.spec?.containers || [];
+    const status = dep.status || {};
+    return {
+        name: dep.metadata?.name,
+        namespace: dep.metadata?.namespace,
+        image: containers[0]?.image || "unknown",
+        replicas: {
+            desired: dep.spec?.replicas || 0,
+            ready: status.readyReplicas || 0,
+            available: status.availableReplicas || 0,
+            unavailable: status.unavailableReplicas || 0,
+            updated: status.updatedReplicas || 0,
+        },
+        conditions: (status.conditions || []).map((c) => ({
+            type: c.type,
+            status: c.status,
+            message: c.message,
+        })),
+    };
+}
+export async function listDeployments(namespace) {
+    const api = getAppsApi();
+    const res = await api.listNamespacedDeployment({ namespace });
+    return (res.items || []).map(formatDeployment);
+}
+//# sourceMappingURL=k8s.js.map

package/lib/server/forge/core/k8s.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"k8s.js","sourceRoot":"","sources":["../../../../server/forge/core/k8s.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,yBAAyB,CAAC;AAc/C,IAAI,EAAE,GAAG,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;AAE9B,SAAS,UAAU;IAClB,EAAE,GAAG,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC;IAC1B,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAC5C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAE9C,IAAI,KAAK,IAAI,MAAM,EAAE,CAAC;QACrB,EAAE,CAAC,eAAe,CAAC;YAClB,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,KAAK,MAAM,EAAE,CAAC;YAClG,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YACjC,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;YAClE,cAAc,EAAE,SAAS;SACzB,CAAC,CAAC;IACJ,CAAC;SAAM,CAAC;QACP,EAAE,CAAC,eAAe,EAAE,CAAC;IACtB,CAAC;AACF,CAAC;AAED,UAAU,EAAE,CAAC;AAEb,SAAS,UAAU;IAClB,OAAO,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;AACxC,CAAC;AAED,SAAS,gBAAgB,CAAC,GAAkB;IAC3C,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,IAAI,EAAE,CAAC;IAC9D,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC;IAChC,OAAO;QACN,IAAI,EAAE,GAAG,CAAC,QAAQ,EAAE,IAAI;QACxB,SAAS,EAAE,GAAG,CAAC,QAAQ,EAAE,SAAS;QAClC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,SAAS;QACxC,QAAQ,EAAE;YACT,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,QAAQ,IAAI,CAAC;YAChC,KAAK,EAAE,MAAM,CAAC,aAAa,IAAI,CAAC;YAChC,SAAS,EAAE,MAAM,CAAC,iBAAiB,IAAI,CAAC;YACxC,WAAW,EAAE,MAAM,CAAC,mBAAmB,IAAI,CAAC;YAC5C,OAAO,EAAE,MAAM,CAAC,eAAe,IAAI,CAAC;SACpC;QACD,UAAU,EAAE,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAqD,EAAE,EAAE,CAAC,CAAC;YACrG,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,OAAO,EAAE,CAAC,CAAC,OAAO;SAClB,CAAC,CAAC;KACH,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,SAAiB;IACtD,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,wBAAwB,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;IAC9D,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AAChD,CAAC"}

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

@@ -0,0 +1,36 @@
+/**
+ * server/forge/core/localRepo.js
+ *
+ * Shared helpers for maintaining a shallow working clone of a repo under
+ * ~/.forge/cache/<repo>/ and overlaying proposed file changes onto it.
+ *
+ * Used by:
+ *   - validator.js → run lint/typecheck/test against the overlaid tree
+ *   - ForgeAgent.refineIssue → give the refine model real Read/Glob/Grep access
+ *     against the current state of the working tree (FORGE_REFINE_REPO_ACCESS)
+ *
+ * Scope matches validator v1: GitLab HTTPS clones only. GitHub / Azure DevOps
+ * raise a clear "not supported yet" error so the caller can fall back cleanly.
+ */
+import type { ForgeChange } from "./types.ts";
+export declare function cachePathFor(repo: string): string;
+/**
+ * Ensures the repo is cloned and reset to a clean branch at origin/main.
+ * Reuses any existing clone under ~/.forge/cache/<repo>/.
+ *
+ * @param {string} repo        Repo id (may carry a "gitlab:" prefix)
+ * @param {string} branchName  Workspace branch to check out
+ * @param {(msg: string) => void} [onLog]
+ * @returns {Promise<string>}  Absolute path to the working tree
+ */
+export declare function ensureWorkingTree(repo: string, branchName: string, onLog?: (msg: string) => void): Promise<string>;
+/**
+ * Writes proposed file contents into the working tree (or deletes files for
+ * action="delete"). Refuses paths that escape the clone directory.
+ *
+ * @param {string} dir
+ * @param {Array<{file: string, action: 'create'|'modify'|'delete', proposed?: string}>} changes
+ * @param {(msg: string) => void} [onLog]
+ */
+export declare function overlayChanges(dir: string, changes: ForgeChange[], onLog?: (msg: string) => void): Promise<void>;
+//# sourceMappingURL=localRepo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"localRepo.d.ts","sourceRoot":"","sources":["../../../../server/forge/core/localRepo.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AASH,OAAO,KAAK,EAAgB,WAAW,EAAE,MAAM,YAAY,CAAC;AAuE5D,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,UAExC;AAED;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,mBA+BtG;AAED;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,iBAgBtG"}

package/lib/server/forge/core/localRepo.js

@@ -0,0 +1,165 @@
+/**
+ * server/forge/core/localRepo.js
+ *
+ * Shared helpers for maintaining a shallow working clone of a repo under
+ * ~/.forge/cache/<repo>/ and overlaying proposed file changes onto it.
+ *
+ * Used by:
+ *   - validator.js → run lint/typecheck/test against the overlaid tree
+ *   - ForgeAgent.refineIssue → give the refine model real Read/Glob/Grep access
+ *     against the current state of the working tree (FORGE_REFINE_REPO_ACCESS)
+ *
+ * Scope matches validator v1: GitLab HTTPS clones only. GitHub / Azure DevOps
+ * raise a clear "not supported yet" error so the caller can fall back cleanly.
+ */
+import { spawn } from "child_process";
+import { writeFileSync, unlinkSync } from "fs";
+import fs from "fs/promises";
+import os from "os";
+import path from "path";
+import { getConnection } from "./configStore.js";
+const CACHE_ROOT = process.env.FORGE_VALIDATE_CACHE
+    ?? path.join(os.homedir(), ".forge", "cache");
+function runGit(args, opts = {}, onLog) {
+    return new Promise((resolve) => {
+        const proc = spawn("git", args, {
+            ...opts,
+            env: { ...process.env, ...(opts.env ?? {}), FORCE_COLOR: "0", NO_COLOR: "1", TERM: "dumb" },
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        const lines = [];
+        const collect = (buf) => {
+            for (const raw of buf.toString().split("\n")) {
+                const line = raw.replace(/\r$/, "");
+                if (!line)
+                    continue;
+                lines.push(line);
+                onLog?.(line);
+            }
+        };
+        proc.stdout.on("data", collect);
+        proc.stderr.on("data", collect);
+        proc.on("error", (err) => resolve({ code: -1, output: lines.join("\n"), error: err.message }));
+        proc.on("close", (code) => resolve({ code: code ?? -1, output: lines.join("\n"), error: null }));
+    });
+}
+async function exists(p) {
+    try {
+        await fs.access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function sanitizeRepo(repo) {
+    return repo.replace(/[^a-zA-Z0-9_./-]/g, "_");
+}
+function gitlabCloneUrl(project) {
+    return `https://gitlab.com/${project}.git`;
+}
+function createAskpassScript(token) {
+    const script = path.join(os.tmpdir(), `.forge-askpass-${process.pid}-${Date.now()}`);
+    writeFileSync(script, `#!/bin/sh\ncase "$1" in *Username*) echo oauth2;; *) echo "${token}";; esac\n`, { mode: 0o700 });
+    return script;
+}
+function gitEnvWithToken() {
+    const { token } = getConnection("gitlab");
+    if (!token)
+        throw new Error("GitLab token is required to clone the repo locally. Set it in Settings → Connections or via GITLAB_TOKEN env var.");
+    const askpass = createAskpassScript(token);
+    return {
+        env: {
+            GIT_ASKPASS: askpass,
+            GIT_TERMINAL_PROMPT: "0",
+        },
+        cleanup: () => { try {
+            unlinkSync(askpass);
+        }
+        catch { } },
+    };
+}
+function resolveCloneUrl(repoInput) {
+    const colon = repoInput.indexOf(":");
+    if (colon > 0) {
+        const prefix = repoInput.slice(0, colon).toLowerCase();
+        if (prefix === "gitlab")
+            return gitlabCloneUrl(repoInput.slice(colon + 1));
+        if (prefix === "github" || prefix === "azuredevops" || prefix === "azure") {
+            throw new Error(`Local clone for ${prefix} repos isn't supported yet — GitLab only.`);
+        }
+    }
+    return gitlabCloneUrl(repoInput);
+}
+export function cachePathFor(repo) {
+    return path.join(CACHE_ROOT, sanitizeRepo(repo));
+}
+/**
+ * Ensures the repo is cloned and reset to a clean branch at origin/main.
+ * Reuses any existing clone under ~/.forge/cache/<repo>/.
+ *
+ * @param {string} repo        Repo id (may carry a "gitlab:" prefix)
+ * @param {string} branchName  Workspace branch to check out
+ * @param {(msg: string) => void} [onLog]
+ * @returns {Promise<string>}  Absolute path to the working tree
+ */
+export async function ensureWorkingTree(repo, branchName, onLog) {
+    const dir = cachePathFor(repo);
+    const hasRepo = await exists(path.join(dir, ".git"));
+    const log = (m) => onLog?.(m);
+    const { env: gitEnv, cleanup } = gitEnvWithToken();
+    const envOpts = { env: { ...process.env, ...gitEnv } };
+    try {
+        if (!hasRepo) {
+            log(`Cloning ${repo} → ${dir}`);
+            await fs.mkdir(dir, { recursive: true });
+            const clone = await runGit(["clone", "--depth=1", resolveCloneUrl(repo), dir], envOpts, onLog);
+            if (clone.code !== 0)
+                throw new Error(`git clone failed (code ${clone.code})`);
+        }
+        else {
+            log(`Reusing clone at ${dir}`);
+        }
+        const fetch = await runGit(["fetch", "--depth=1", "origin", "main"], { cwd: dir, ...envOpts }, onLog);
+        if (fetch.code !== 0)
+            throw new Error(`git fetch failed (code ${fetch.code})`);
+        const reset = await runGit(["reset", "--hard", "origin/main"], { cwd: dir }, onLog);
+        if (reset.code !== 0)
+            throw new Error(`git reset failed (code ${reset.code})`);
+        await runGit(["clean", "-fd"], { cwd: dir }, onLog);
+        const checkout = await runGit(["checkout", "-B", branchName], { cwd: dir }, onLog);
+        if (checkout.code !== 0)
+            throw new Error(`git checkout ${branchName} failed (code ${checkout.code})`);
+        return dir;
+    }
+    finally {
+        cleanup();
+    }
+}
+/**
+ * Writes proposed file contents into the working tree (or deletes files for
+ * action="delete"). Refuses paths that escape the clone directory.
+ *
+ * @param {string} dir
+ * @param {Array<{file: string, action: 'create'|'modify'|'delete', proposed?: string}>} changes
+ * @param {(msg: string) => void} [onLog]
+ */
+export async function overlayChanges(dir, changes, onLog) {
+    const realBase = await fs.realpath(dir);
+    for (const c of changes) {
+        const full = path.resolve(dir, c.file);
+        if (!full.startsWith(realBase + path.sep) && full !== realBase) {
+            throw new Error(`Refusing to write outside clone dir: ${c.file}`);
+        }
+        if (c.action === "delete") {
+            await fs.rm(full, { force: true });
+            onLog?.(`- ${c.file}`);
+        }
+        else {
+            await fs.mkdir(path.dirname(full), { recursive: true });
+            await fs.writeFile(full, c.proposed ?? "");
+            onLog?.(`+ ${c.file} (${c.action})`);
+        }
+    }
+}
+//# sourceMappingURL=localRepo.js.map

package/lib/server/forge/core/localRepo.js.map

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

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

@@ -0,0 +1,61 @@
+/**
+ * server/forge/core/openclawClient.js
+ *
+ * Communicates with a locally-running OpenClaw Gateway over HTTP.
+ * Configure with:
+ *   OPENCLAW_GATEWAY_URL  — e.g. http://192.168.x.x:18789 (Tailscale) or SSH tunnel
+ *   OPENCLAW_TOKEN        — Bearer token if your Gateway requires auth
+ *
+ * The Gateway runs on 127.0.0.1:18789 by default. Expose it remotely via:
+ *   Tailscale: bind to tailnet interface
+ *   SSH tunnel: ssh -N -L 18789:127.0.0.1:18789 user@host
+ */
+import type { NormalDiff } from "./providers/types.ts";
+import type { AgentResponse, ForgeChange, ForgeEvent } from "./types.ts";
+interface IssueInput {
+    iid?: number;
+    title?: string | null;
+    description?: string | null;
+    labels?: Array<string | {
+        name?: string;
+    }> | null;
+}
+interface FileContent {
+    repo?: string;
+    path: string;
+    content: string;
+}
+interface RepoTree {
+    repo: string;
+    files: string[];
+}
+interface ProposeFixOptions {
+    feedback?: string;
+    ciContext?: string;
+    userPrompt?: string;
+    repos?: string[];
+    promptRules?: string;
+    previousChanges?: ForgeChange[];
+}
+interface RefineOptions {
+    feedback?: string;
+    previousChanges?: ForgeChange[];
+    validationState?: unknown;
+    repos?: string[];
+    repoTrees?: RepoTree[];
+    repoAccessMode?: string;
+    promptRules?: string;
+    repoCwd?: string;
+    sessionId?: string;
+    resumeSession?: boolean;
+}
+interface GatewayCallOpts {
+    signal?: AbortSignal;
+    timeout?: number;
+}
+export declare function checkResolution(issue: IssueInput, diffs: NormalDiff[], model: string | undefined, opts?: GatewayCallOpts): Promise<AgentResponse>;
+export declare function identifyRelevantFiles(issue: IssueInput, fileTree: RepoTree[] | string[], model: string | undefined, opts?: GatewayCallOpts): Promise<AgentResponse>;
+export declare function proposeFix(issue: IssueInput, fileContents: FileContent[], options: ProposeFixOptions, model: string | undefined, opts?: GatewayCallOpts): Promise<AgentResponse>;
+export declare function refineOrAsk(issue: IssueInput, fileContents: FileContent[], options: RefineOptions, model: string | undefined, _onEvent: ((evt: ForgeEvent) => void) | undefined, opts?: GatewayCallOpts): Promise<AgentResponse>;
+export {};
+//# sourceMappingURL=openclawClient.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"openclawClient.d.ts","sourceRoot":"","sources":["../../../../server/forge/core/openclawClient.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAQH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEzE,UAAU,UAAU;IACnB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,MAAM,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI,CAAC;CAClD;AAED,UAAU,WAAW;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CAChB;AAED,UAAU,QAAQ;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,UAAU,iBAAiB;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,WAAW,EAAE,CAAC;CAChC;AAED,UAAU,aAAa;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,WAAW,EAAE,CAAC;IAChC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,UAAU,eAAe;IACxB,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAuFD,wBAAsB,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,aAAa,CAAC,CAI3J;AAED,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,aAAa,CAAC,CAI7K;AAED,wBAAsB,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,iBAAsB,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,aAAa,CAAC,CAI/L;AAED,wBAAsB,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,EAAE,OAAO,EAAE,aAAkB,EAAE,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC,GAAG,EAAE,UAAU,KAAK,IAAI,CAAC,GAAG,SAAS,EAAE,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,aAAa,CAAC,CAM/O"}