@ipul-labs/forge 1.16.8 → 1.17.0

package/lib/server/forge/core/validator/fs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.d.ts","sourceRoot":"","sources":["../../../../../server/forge/core/validator/fs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,wBAAsB,MAAM,CAAC,CAAC,EAAE,MAAM,oBAErC"}

package/{server → lib/server}/forge/core/validator/fs.js

@@ -1,9 +1,14 @@
 /**
  * Tiny fs helpers shared by clone / overlay / project-type detection.
  */
-
 import fs from "node:fs/promises";
-
 export async function exists(p) {
-	try { await fs.access(p); return true; } catch { return false; }
+    try {
+        await fs.access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
 }
+//# sourceMappingURL=fs.js.map

package/lib/server/forge/core/validator/fs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs.js","sourceRoot":"","sources":["../../../../../server/forge/core/validator/fs.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAElC,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,CAAS;IACrC,IAAI,CAAC;QAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,KAAK,CAAC;IAAC,CAAC;AACjE,CAAC"}

package/lib/server/forge/core/validator/overlay.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Overlay proposed changes onto the cloned working tree, and read formatter
+ * rewrites back into the analysis so committed text matches what was validated.
+ */
+import type { ForgeChange, ForgeEvent } from "../types.ts";
+export declare function overlayChanges(dir: string, changes: ForgeChange[], emit: (event: ForgeEvent) => void): Promise<void>;
+/**
+ * After a formatter step (npm run format, go fmt …), re-read the overlayed
+ * files. If the formatter rewrote any of them, mutate `c.proposed` in place
+ * and emit a `changes_formatted` event so the frontend can sync.
+ */
+export declare function readbackFormatted(dir: string, changes: ForgeChange[], emit: (event: ForgeEvent) => void): Promise<void>;
+//# sourceMappingURL=overlay.d.ts.map

package/lib/server/forge/core/validator/overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.d.ts","sourceRoot":"","sources":["../../../../../server/forge/core/validator/overlay.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE3D,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,iBAkB1G;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,iBAkB7G"}

package/lib/server/forge/core/validator/overlay.js

@@ -0,0 +1,53 @@
+/**
+ * Overlay proposed changes onto the cloned working tree, and read formatter
+ * rewrites back into the analysis so committed text matches what was validated.
+ */
+import fs from "node:fs/promises";
+import path from "node:path";
+export async function overlayChanges(dir, changes, emit) {
+    emit({ type: "progress", step: "overlay", status: "running" });
+    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 });
+            emit({ type: "log", step: "overlay", message: `- ${c.file}` });
+        }
+        else {
+            await fs.mkdir(path.dirname(full), { recursive: true });
+            await fs.writeFile(full, c.proposed);
+            emit({ type: "log", step: "overlay", message: `+ ${c.file} (${c.action})` });
+        }
+    }
+    emit({ type: "step_result", step: "overlay", passed: true });
+}
+/**
+ * After a formatter step (npm run format, go fmt …), re-read the overlayed
+ * files. If the formatter rewrote any of them, mutate `c.proposed` in place
+ * and emit a `changes_formatted` event so the frontend can sync.
+ */
+export async function readbackFormatted(dir, changes, emit) {
+    const updated = [];
+    for (const c of changes) {
+        if (c.action === "delete")
+            continue;
+        try {
+            const after = await fs.readFile(path.join(dir, c.file), "utf8");
+            if (after !== c.proposed) {
+                c.proposed = after;
+                updated.push({ file: c.file, proposed: after });
+            }
+        }
+        catch {
+            // File may have been removed or renamed by the formatter
+            // (uncommon for prettier/eslint --fix); skip silently.
+        }
+    }
+    if (updated.length) {
+        emit({ type: "changes_formatted", files: updated });
+    }
+}
+//# sourceMappingURL=overlay.js.map

package/lib/server/forge/core/validator/overlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlay.js","sourceRoot":"","sources":["../../../../../server/forge/core/validator/overlay.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,GAAW,EAAE,OAAsB,EAAE,IAAiC;IAC1G,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;IACxC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YAChE,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACnE,CAAC;QACD,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC3B,MAAM,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;YACnC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAChE,CAAC;aAAM,CAAC;YACP,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACxD,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC;YACrC,IAAI,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;QAC9E,CAAC;IACF,CAAC;IACD,IAAI,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,GAAW,EAAE,OAAsB,EAAE,IAAiC;IAC7G,MAAM,OAAO,GAAG,EAAE,CAAC;IACnB,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACzB,IAAI,CAAC,CAAC,MAAM,KAAK,QAAQ;YAAE,SAAS;QACpC,IAAI,CAAC;YACJ,MAAM,KAAK,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;YAChE,IAAI,KAAK,KAAK,CAAC,CAAC,QAAQ,EAAE,CAAC;gBAC1B,CAAC,CAAC,QAAQ,GAAG,KAAK,CAAC;gBACnB,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;YACjD,CAAC;QACF,CAAC;QAAC,MAAM,CAAC;YACR,yDAAyD;YACzD,uDAAuD;QACxD,CAAC;IACF,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACpB,IAAI,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;IACrD,CAAC;AACF,CAAC"}

package/lib/server/forge/core/validator/projectType.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Per-repo project-type resolution.
+ *
+ * Resolution order (strongest → weakest signal):
+ *   1. configStore — the user's explicit choice in Settings → Repositories.
+ *      Honoured verbatim when not "auto".
+ *   2. Changeset extensions — what the user is actually editing. Safe to
+ *      trust as the primary signal because auto-attribution upstream
+ *      guarantees that only repos that actually own a change ever reach
+ *      this resolver. A polyglot repo with a root `package.json` and a
+ *      nested Go module still classifies as Go when the changeset is `.go`.
+ *   3. Root marker — `go.mod` / `package.json` at the repo root.
+ *   4. Shallow tree scan — last resort, walks one level to find a nested
+ *      marker (monorepo layouts).
+ *   5. Fallback — Node.
+ */
+import type { ForgeChange } from "../types.ts";
+export declare const SUPPORTED_TYPES: string[];
+export declare function resolveProjectType(repoId: string, dir: string, changes: ForgeChange[]): Promise<string>;
+//# sourceMappingURL=projectType.d.ts.map

package/lib/server/forge/core/validator/projectType.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projectType.d.ts","sourceRoot":"","sources":["../../../../../server/forge/core/validator/projectType.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,eAAO,MAAM,eAAe,UAAiB,CAAC;AAuD9C,wBAAsB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,mBAc3F"}

package/lib/server/forge/core/validator/projectType.js

@@ -0,0 +1,94 @@
+/**
+ * Per-repo project-type resolution.
+ *
+ * Resolution order (strongest → weakest signal):
+ *   1. configStore — the user's explicit choice in Settings → Repositories.
+ *      Honoured verbatim when not "auto".
+ *   2. Changeset extensions — what the user is actually editing. Safe to
+ *      trust as the primary signal because auto-attribution upstream
+ *      guarantees that only repos that actually own a change ever reach
+ *      this resolver. A polyglot repo with a root `package.json` and a
+ *      nested Go module still classifies as Go when the changeset is `.go`.
+ *   3. Root marker — `go.mod` / `package.json` at the repo root.
+ *   4. Shallow tree scan — last resort, walks one level to find a nested
+ *      marker (monorepo layouts).
+ *   5. Fallback — Node.
+ */
+import fs from "node:fs/promises";
+import path from "node:path";
+import * as configStore from "../configStore.js";
+import { exists } from "./fs.js";
+export const SUPPORTED_TYPES = ["node", "go"];
+const GO_EXTS = new Set([".go"]);
+const NODE_EXTS = new Set([".js", ".jsx", ".ts", ".tsx", ".mjs", ".cjs"]);
+function detectFromChanges(changes) {
+    let go = 0;
+    let node = 0;
+    for (const c of changes ?? []) {
+        const ext = path.extname(c.file ?? "").toLowerCase();
+        if (GO_EXTS.has(ext))
+            go++;
+        else if (NODE_EXTS.has(ext))
+            node++;
+    }
+    if (go > 0 && node === 0)
+        return "go";
+    if (node > 0 && go === 0)
+        return "node";
+    return null;
+}
+async function detectFromRoot(dir) {
+    const hasGo = await exists(path.join(dir, "go.mod"));
+    const hasNode = await exists(path.join(dir, "package.json"));
+    if (hasGo && !hasNode)
+        return "go";
+    if (hasNode && !hasGo)
+        return "node";
+    if (hasGo && hasNode)
+        return "go"; // both at root — prefer the more specific toolchain.
+    return null;
+}
+async function detectFromShallowScan(dir) {
+    let hasGo = false;
+    let hasNode = false;
+    try {
+        const entries = await fs.readdir(dir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            if (entry.name.startsWith(".") || entry.name === "node_modules" || entry.name === "vendor")
+                continue;
+            const sub = path.join(dir, entry.name);
+            if (!hasGo && (await exists(path.join(sub, "go.mod"))))
+                hasGo = true;
+            if (!hasNode && (await exists(path.join(sub, "package.json"))))
+                hasNode = true;
+            if (hasGo && hasNode)
+                break;
+        }
+    }
+    catch {
+        // readdir failed — fall through with whatever we already have.
+    }
+    if (hasGo && !hasNode)
+        return "go";
+    if (hasNode && !hasGo)
+        return "node";
+    if (hasGo)
+        return "go";
+    return null;
+}
+export async function resolveProjectType(repoId, dir, changes) {
+    const repos = (configStore.get().repos ?? []);
+    const cfg = repos.find((r) => r.id === repoId);
+    const configured = cfg?.projectType;
+    if (configured && configured !== "auto")
+        return configured;
+    // Auto-attribution already filtered out misattributed changes upstream,
+    // so the changeset here genuinely reflects this repo's diff. Trust it.
+    return (detectFromChanges(changes)
+        ?? (await detectFromRoot(dir))
+        ?? (await detectFromShallowScan(dir))
+        ?? "node");
+}
+//# sourceMappingURL=projectType.js.map

package/lib/server/forge/core/validator/projectType.js.map

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

package/lib/server/forge/core/validator/runners/go.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Go runner: emits Go-canonical step names so the UI shows what's actually
+ * being run instead of forcing Node-isms onto the toolchain.
+ *
+ *   fmt   → go fmt ./...        (rewrites .go files; readback feeds the diff)
+ *   vet   → go vet ./...        (replaced by golangci-lint when installed)
+ *   build → go build ./...      (compile + type check)
+ *   test  → go test -race -count=1 ./...
+ *
+ * Module location: `go` commands need to run inside the directory containing
+ * the relevant go.mod. Monorepos commonly nest the module under e.g.
+ * `services/api/go.mod`, so we walk up from a changed .go file (and shallow-
+ * scan the clone) to find it. Multi-module repos with several go.mod files
+ * are out of scope for v1 — we use whichever module the changeset hits first.
+ */
+import type { ForgeChange, ForgeEvent } from "../../types.ts";
+import type { StepResult } from "../cmd.ts";
+export declare const STEP_ORDER: string[];
+export declare const FIXABLE_STEPS: string[];
+export declare function runGoRepo(cloneDir: string, changes: ForgeChange[], emit: (event: ForgeEvent) => void): Promise<Record<string, StepResult>>;
+//# sourceMappingURL=go.d.ts.map

package/lib/server/forge/core/validator/runners/go.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"go.d.ts","sourceRoot":"","sources":["../../../../../../server/forge/core/validator/runners/go.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAK5C,eAAO,MAAM,UAAU,UAAiE,CAAC;AACzF,eAAO,MAAM,aAAa,UAA2B,CAAC;AAkDtD,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,uCA+B1G"}

package/lib/server/forge/core/validator/runners/go.js

@@ -0,0 +1,99 @@
+/**
+ * Go runner: emits Go-canonical step names so the UI shows what's actually
+ * being run instead of forcing Node-isms onto the toolchain.
+ *
+ *   fmt   → go fmt ./...        (rewrites .go files; readback feeds the diff)
+ *   vet   → go vet ./...        (replaced by golangci-lint when installed)
+ *   build → go build ./...      (compile + type check)
+ *   test  → go test -race -count=1 ./...
+ *
+ * Module location: `go` commands need to run inside the directory containing
+ * the relevant go.mod. Monorepos commonly nest the module under e.g.
+ * `services/api/go.mod`, so we walk up from a changed .go file (and shallow-
+ * scan the clone) to find it. Multi-module repos with several go.mod files
+ * are out of scope for v1 — we use whichever module the changeset hits first.
+ */
+import fs from "node:fs/promises";
+import path from "node:path";
+import { runCmd, runStep } from "../cmd.js";
+import { exists } from "../fs.js";
+import { readbackFormatted } from "../overlay.js";
+// Public step contract for the orchestrator → frontend handshake.
+export const STEP_ORDER = ["clone", "install", "overlay", "fmt", "vet", "build", "test"];
+export const FIXABLE_STEPS = ["vet", "build", "test"];
+async function which(bin) {
+    const r = await runCmd("which", [bin]);
+    return r.code === 0;
+}
+async function findGoModDir(cloneDir, changes) {
+    // Walk up from the first changed .go file looking for the nearest go.mod.
+    const goChange = (changes ?? []).find((c) => path.extname(c.file ?? "").toLowerCase() === ".go");
+    if (goChange) {
+        let cur = path.dirname(path.join(cloneDir, goChange.file));
+        while (cur.startsWith(cloneDir)) {
+            if (await exists(path.join(cur, "go.mod")))
+                return cur;
+            const parent = path.dirname(cur);
+            if (parent === cur)
+                break;
+            cur = parent;
+        }
+    }
+    if (await exists(path.join(cloneDir, "go.mod")))
+        return cloneDir;
+    // Shallow scan for monorepos with no .go changes (e.g. an MR that only
+    // touches a config file but the module is in a subdir).
+    try {
+        const entries = await fs.readdir(cloneDir, { withFileTypes: true });
+        for (const entry of entries) {
+            if (!entry.isDirectory())
+                continue;
+            if (entry.name.startsWith(".") || entry.name === "node_modules" || entry.name === "vendor")
+                continue;
+            const sub = path.join(cloneDir, entry.name);
+            if (await exists(path.join(sub, "go.mod")))
+                return sub;
+        }
+    }
+    catch {
+        // fall through
+    }
+    return null;
+}
+async function ensureInstalled(goDir, emit) {
+    emit({ type: "progress", step: "install", status: "running" });
+    emit({ type: "log", step: "install", message: "Running go mod download…" });
+    const r = await runCmd("go", ["mod", "download"], { cwd: goDir }, (l) => emit({ type: "log", step: "install", message: l }));
+    if (r.code !== 0)
+        throw new Error(`go mod download failed (code ${r.code})`);
+    emit({ type: "step_result", step: "install", passed: true });
+}
+export async function runGoRepo(cloneDir, changes, emit) {
+    const goDir = await findGoModDir(cloneDir, changes);
+    if (!goDir) {
+        throw new Error("Couldn't locate a go.mod in the clone — repo doesn't look like a Go module.");
+    }
+    const rel = path.relative(cloneDir, goDir) || ".";
+    if (rel !== ".")
+        emit({ type: "log", step: "overlay", message: `Go module rooted at ${rel}` });
+    await ensureInstalled(goDir, emit);
+    const results = {};
+    results.fmt = await runStep(goDir, "fmt", "go", ["fmt", "./..."], emit);
+    if (results.fmt.passed)
+        await readbackFormatted(cloneDir, changes, emit);
+    // `go vet` is the baseline. If the repo (or developer) has golangci-lint
+    // installed, prefer it — it covers gofmt, vet, staticcheck, errcheck, and
+    // more in a single pass and is the de-facto community standard.
+    if (await which("golangci-lint")) {
+        results.vet = await runStep(goDir, "vet", "golangci-lint", ["run", "./..."], emit);
+    }
+    else {
+        results.vet = await runStep(goDir, "vet", "go", ["vet", "./..."], emit);
+    }
+    results.build = await runStep(goDir, "build", "go", ["build", "./..."], emit);
+    // -race catches data races; -count=1 disables the test cache so we always
+    // re-execute against the overlayed source. Both are standard Go CI practice.
+    results.test = await runStep(goDir, "test", "go", ["test", "-race", "-count=1", "./..."], emit);
+    return results;
+}
+//# sourceMappingURL=go.js.map

package/lib/server/forge/core/validator/runners/go.js.map

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

package/lib/server/forge/core/validator/runners/node.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Node runner: `npm ci` (lockfile-hash cached) followed by the standard
+ * format / lint / typecheck / test scripts. Missing scripts are skipped, not
+ * failed. The formatter step is read back so its rewrites flow into the
+ * proposal the user commits.
+ */
+import type { ForgeChange, ForgeEvent } from "../../types.ts";
+import type { StepResult } from "../cmd.ts";
+export declare const STEP_ORDER: string[];
+export declare const FIXABLE_STEPS: string[];
+export declare function runNodeRepo(dir: string, changes: ForgeChange[], emit: (event: ForgeEvent) => void): Promise<Record<string, StepResult>>;
+//# sourceMappingURL=node.d.ts.map

package/lib/server/forge/core/validator/runners/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../../../../server/forge/core/validator/runners/node.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAE9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAU5C,eAAO,MAAM,UAAU,UAAyF,CAAC;AACjH,eAAO,MAAM,aAAa,UAAgC,CAAC;AAuC3D,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,uCAsBvG"}

package/lib/server/forge/core/validator/runners/node.js

@@ -0,0 +1,75 @@
+/**
+ * Node runner: `npm ci` (lockfile-hash cached) followed by the standard
+ * format / lint / typecheck / test scripts. Missing scripts are skipped, not
+ * failed. The formatter step is read back so its rewrites flow into the
+ * proposal the user commits.
+ */
+import crypto from "node:crypto";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { runCmd, runStep } from "../cmd.js";
+import { exists } from "../fs.js";
+import { readbackFormatted } from "../overlay.js";
+import { runTddPrecheckNode } from "../tdd.js";
+const SCRIPTS = ["format", "lint", "typecheck", "test"];
+// Public step contract for the orchestrator → frontend handshake. `tdd_precheck`
+// sits before `test`; it only actually runs (and appears in the UI) when the
+// proposal bundles new test files with impl changes — see runTddPrecheckNode.
+export const STEP_ORDER = ["clone", "install", "overlay", "format", "lint", "typecheck", "tdd_precheck", "test"];
+export const FIXABLE_STEPS = ["lint", "typecheck", "test"];
+async function readPackageScripts(dir) {
+    try {
+        const raw = await fs.readFile(path.join(dir, "package.json"), "utf8");
+        return JSON.parse(raw).scripts ?? {};
+    }
+    catch {
+        return {};
+    }
+}
+async function ensureInstalled(dir, emit) {
+    const lockPath = path.join(dir, "package-lock.json");
+    if (!(await exists(lockPath)))
+        return; // not an npm-managed project — omit the row entirely.
+    const hashPath = path.join(dir, "node_modules", ".forge-lock-hash");
+    const lockContent = await fs.readFile(lockPath);
+    const lockHash = crypto.createHash("sha256").update(lockContent).digest("hex");
+    if (await exists(hashPath)) {
+        const stored = (await fs.readFile(hashPath, "utf8")).trim();
+        if (stored === lockHash)
+            return; // node_modules already matches; nothing to install.
+    }
+    emit({ type: "progress", step: "install", status: "running" });
+    emit({ type: "log", step: "install", message: "Running npm ci (first run for this lockfile may take a minute)…" });
+    const install = await runCmd("npm", ["ci", "--prefer-offline", "--no-audit", "--no-fund"], { cwd: dir }, (l) => emit({ type: "log", step: "install", message: l }));
+    if (install.code !== 0) {
+        throw new Error(`npm ci failed (code ${install.code})`);
+    }
+    await fs.mkdir(path.dirname(hashPath), { recursive: true });
+    await fs.writeFile(hashPath, lockHash);
+    emit({ type: "step_result", step: "install", passed: true });
+}
+export async function runNodeRepo(dir, changes, emit) {
+    await ensureInstalled(dir, emit);
+    const scripts = await readPackageScripts(dir);
+    const results = {};
+    // Only run (and thus only render) scripts the project actually defines —
+    // missing scripts are omitted from the UI rather than shown as "skipped".
+    for (const s of SCRIPTS) {
+        if (!scripts[s])
+            continue;
+        // TDD precheck runs only when the `test` script exists, a new test file
+        // is part of the proposal, and there's impl code to revert. It records
+        // its own step_result under `tdd_precheck`.
+        if (s === "test") {
+            const precheck = await runTddPrecheckNode(dir, changes, emit);
+            if (precheck)
+                results.tdd_precheck = precheck;
+        }
+        results[s] = await runStep(dir, s, "npm", ["run", "--silent", s], emit);
+        if (s === "format" && results[s].passed) {
+            await readbackFormatted(dir, changes, emit);
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=node.js.map

package/lib/server/forge/core/validator/runners/node.js.map

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

package/lib/server/forge/core/validator/tdd.d.ts

@@ -0,0 +1,30 @@
+/**
+ * TDD precheck: when a proposal adds *new* test files alongside impl changes,
+ * run just those tests with the impl reverted. If they pass, the tests don't
+ * actually exercise the new behavior — that's the gap we surface.
+ *
+ * Only fires when all three hold:
+ *   - at least one new test file (action === "create" on a test path)
+ *   - at least one non-test change (impl)
+ *   - the project has a `test` script
+ *
+ * The precheck reverts impl files via git (or `rm` for untracked creates),
+ * runs vitest scoped to the new test paths, then re-overlays impl so the
+ * downstream `test` step sees the full proposal.
+ */
+import type { ForgeChange, ForgeEvent } from "../types.ts";
+export declare function isNodeTestFile(filePath: string): boolean;
+export declare function partitionChangesNode(changes: ForgeChange[]): {
+    impl: ForgeChange[];
+    newTests: ForgeChange[];
+};
+/**
+ * @returns {Promise<null|{passed: boolean, exitCode: number}>} null when skipped.
+ */
+export declare function runTddPrecheckNode(dir: string, changes: ForgeChange[], emit: (event: ForgeEvent) => void): Promise<{
+    passed: boolean;
+    exitCode: number;
+    durationMs: number;
+    tail: string;
+}>;
+//# sourceMappingURL=tdd.d.ts.map

package/lib/server/forge/core/validator/tdd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tdd.d.ts","sourceRoot":"","sources":["../../../../../server/forge/core/validator/tdd.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAK3D,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,WAE9C;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,WAAW,EAAE;;;EAW1D;AA0BD;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI;;;;;GAsC9G"}

package/lib/server/forge/core/validator/tdd.js

@@ -0,0 +1,96 @@
+/**
+ * TDD precheck: when a proposal adds *new* test files alongside impl changes,
+ * run just those tests with the impl reverted. If they pass, the tests don't
+ * actually exercise the new behavior — that's the gap we surface.
+ *
+ * Only fires when all three hold:
+ *   - at least one new test file (action === "create" on a test path)
+ *   - at least one non-test change (impl)
+ *   - the project has a `test` script
+ *
+ * The precheck reverts impl files via git (or `rm` for untracked creates),
+ * runs vitest scoped to the new test paths, then re-overlays impl so the
+ * downstream `test` step sees the full proposal.
+ */
+import fs from "node:fs/promises";
+import path from "node:path";
+import { runCmd } from "./cmd.js";
+const TEST_FILE_RE_NODE = /\.(test|spec)\.[cm]?[jt]sx?$/;
+export function isNodeTestFile(filePath) {
+    return TEST_FILE_RE_NODE.test(filePath);
+}
+export function partitionChangesNode(changes) {
+    const impl = [];
+    const newTests = [];
+    for (const c of changes ?? []) {
+        if (isNodeTestFile(c.file)) {
+            if (c.action === "create")
+                newTests.push(c);
+        }
+        else {
+            impl.push(c);
+        }
+    }
+    return { impl, newTests };
+}
+async function revertImplOverlay(dir, impl) {
+    for (const c of impl) {
+        const full = path.join(dir, c.file);
+        if (c.action === "create") {
+            await fs.rm(full, { force: true });
+        }
+        else {
+            // modify or delete — restore the pre-overlay content from HEAD.
+            await runCmd("git", ["checkout", "--", c.file], { cwd: dir }, undefined);
+        }
+    }
+}
+async function reapplyImplOverlay(dir, impl) {
+    for (const c of impl) {
+        const full = path.join(dir, c.file);
+        if (c.action === "delete") {
+            await fs.rm(full, { force: true });
+        }
+        else {
+            await fs.mkdir(path.dirname(full), { recursive: true });
+            await fs.writeFile(full, c.proposed);
+        }
+    }
+}
+/**
+ * @returns {Promise<null|{passed: boolean, exitCode: number}>} null when skipped.
+ */
+export async function runTddPrecheckNode(dir, changes, emit) {
+    const { impl, newTests } = partitionChangesNode(changes);
+    if (newTests.length === 0 || impl.length === 0)
+        return null;
+    const testPaths = newTests.map((c) => c.file);
+    emit({ type: "progress", step: "tdd_precheck", status: "running" });
+    emit({
+        type: "log",
+        step: "tdd_precheck",
+        message: `Verifying ${newTests.length} new test file(s) fail without impl: ${testPaths.join(", ")}`,
+    });
+    await revertImplOverlay(dir, impl);
+    const start = Date.now();
+    const res = await runCmd("npx", ["vitest", "--run", "--reporter=default", ...testPaths], { cwd: dir }, (l) => emit({ type: "log", step: "tdd_precheck", message: l }));
+    await reapplyImplOverlay(dir, impl);
+    // TDD contract: without the impl, the new tests must fail (non-zero exit).
+    // Exit 0 means either the tests passed without the impl — they don't
+    // exercise the new behavior — or vitest found nothing to run.
+    const precheckPassed = res.code !== 0;
+    const tail = res.output.split("\n").slice(-60).join("\n");
+    emit({
+        type: "step_result",
+        step: "tdd_precheck",
+        passed: precheckPassed,
+        exitCode: res.code,
+        durationMs: Date.now() - start,
+        tail,
+        message: precheckPassed
+            ? `${newTests.length} new test(s) failed without implementation (good TDD).`
+            : `${newTests.length} new test(s) passed without the implementation change — they may not actually test the fix.`,
+    });
+    return { passed: precheckPassed, exitCode: res.code, durationMs: Date.now() - start, tail };
+}
+//# sourceMappingURL=tdd.js.map

package/lib/server/forge/core/validator/tdd.js.map

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