@ipul-labs/forge 1.16.8 → 1.17.0

package/lib/bin/cli/serverClient.js

@@ -0,0 +1,111 @@
+/**
+ * CLI → Server API client.
+ *
+ * Tries the running Forge server first. If the server is unreachable,
+ * returns { available: false } so callers can fall back to direct
+ * ForgeAgent calls (offline mode).
+ *
+ * Every method mirrors a server endpoint. SSE-streaming endpoints
+ * (analyze, refine, ci-fix, validate) return an async iterator of
+ * parsed events plus the jobId so the caller can cancel.
+ */
+const DIM = "\x1b[2m";
+const RESET = "\x1b[0m";
+const GREEN = "\x1b[32m";
+const YELLOW = "\x1b[33m";
+function baseUrl() {
+    const port = process.env.PORT ?? 5001;
+    return `http://localhost:${port}/api/forge`;
+}
+function headers() {
+    const token = process.env.FORGE_TOKEN;
+    return {
+        "Content-Type": "application/json",
+        ...(token ? { Authorization: `Bearer ${token}` } : {}),
+    };
+}
+export const SERVER_MODE = `${GREEN}●${RESET} ${DIM}server${RESET}`;
+export const LOCAL_MODE = `${YELLOW}●${RESET} ${DIM}local${RESET}`;
+export async function isServerAvailable() {
+    try {
+        const res = await fetch(`${baseUrl()}/status`, {
+            headers: headers(),
+            signal: AbortSignal.timeout(2000),
+        });
+        return res.ok;
+    }
+    catch {
+        return false;
+    }
+}
+export async function postJson(path, body = {}) {
+    const res = await fetch(`${baseUrl()}${path}`, {
+        method: "POST",
+        headers: headers(),
+        body: JSON.stringify(body),
+    });
+    if (!res.ok) {
+        const err = (await res.json().catch(() => ({})));
+        throw new Error(err.error || `Server returned ${res.status}`);
+    }
+    return res.json();
+}
+export async function getJson(path) {
+    const res = await fetch(`${baseUrl()}${path}`, { headers: headers() });
+    if (!res.ok) {
+        const err = (await res.json().catch(() => ({})));
+        throw new Error(err.error || `Server returned ${res.status}`);
+    }
+    return res.json();
+}
+/**
+ * Start a job-based SSE stream. Returns { jobId, events } where events
+ * is an async generator yielding parsed event objects.
+ */
+export function streamJob(path, body = {}) {
+    const token = process.env.FORGE_TOKEN ?? "";
+    let jobId = null;
+    const events = (async function* () {
+        const startRes = await fetch(`${baseUrl()}${path}`, {
+            method: "POST",
+            headers: headers(),
+            body: JSON.stringify(body),
+        });
+        if (!startRes.ok) {
+            const err = (await startRes.json().catch(() => ({})));
+            throw new Error(err.error || `Server returned ${startRes.status}`);
+        }
+        const { jobId: id } = (await startRes.json());
+        jobId = id;
+        const streamUrl = `${baseUrl()}/jobs/${id}/stream?token=${encodeURIComponent(token)}`;
+        const streamRes = await fetch(streamUrl);
+        if (!streamRes.ok)
+            throw new Error(`Stream failed: ${streamRes.status}`);
+        const reader = streamRes.body.getReader();
+        const decoder = new TextDecoder();
+        let buffer = "";
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            buffer += decoder.decode(value, { stream: true });
+            let nl;
+            while ((nl = buffer.indexOf("\n\n")) !== -1) {
+                const chunk = buffer.slice(0, nl).trim();
+                buffer = buffer.slice(nl + 2);
+                if (!chunk.startsWith("data: "))
+                    continue;
+                const json = chunk.slice(6);
+                try {
+                    const evt = JSON.parse(json);
+                    yield evt;
+                    if (evt.type === "done" || evt.type === "error" || evt.type === "cancelled")
+                        return;
+                }
+                catch { }
+            }
+        }
+    })();
+    return { get jobId() { return jobId; }, events };
+}
+//# sourceMappingURL=serverClient.js.map

package/lib/bin/cli/serverClient.js.map

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

package/lib/bin/cli/session.d.ts

@@ -0,0 +1,8 @@
+export declare function cmdSession(argv: string[]): Promise<void>;
+/**
+ * Top-level `forge show [<iid>]` — re-renders the cached analysis from
+ * the session through the same Ink view as live analyze. Resolves <iid> via
+ * positional arg or HEAD pointer.
+ */
+export declare function cmdShow(argv: string[]): Promise<void>;
+//# sourceMappingURL=session.d.ts.map

package/lib/bin/cli/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../bin/cli/session.ts"],"names":[],"mappings":"AAgNA,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,iBAQ9C;AAED;;;;GAIG;AACH,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,iBA+B3C"}

package/lib/bin/cli/session.js

@@ -0,0 +1,212 @@
+import { h, Box, Text, runApp } from "./ink.js";
+import { getFlag } from "./utils.js";
+import { cleanAll, cleanSession, getHead, listSessions, readAnalysis, readState, resolveSessionTarget, sessionDir, } from "./sessionStore.js";
+function relTime(iso) {
+    if (!iso)
+        return "";
+    const ms = Date.now() - new Date(iso).getTime();
+    if (Number.isNaN(ms) || ms < 0)
+        return "";
+    const s = Math.floor(ms / 1000);
+    if (s < 60)
+        return `${s}s ago`;
+    const m = Math.floor(s / 60);
+    if (m < 60)
+        return `${m}m ago`;
+    const h = Math.floor(m / 60);
+    if (h < 24)
+        return `${h}h ago`;
+    return `${Math.floor(h / 24)}d ago`;
+}
+function SessionsTable({ sessions, head }) {
+    if (sessions.length === 0) {
+        return h `<${Box} flexDirection="column">
+			<${Text} dimColor>No sessions yet.</>
+			<${Text}>${"Run: forge analyze <iid>"}</>
+		</>`;
+    }
+    const rows = sessions.map((s) => {
+        const isHead = head && head.repo === s.repo && head.iid === s.iid;
+        return {
+            marker: isHead ? "*" : " ",
+            ref: `${s.repo}#${s.iid}`,
+            phase: s.phase ?? "?",
+            when: relTime(s.updatedAt),
+        };
+    });
+    const wRef = Math.max(3, ...rows.map((r) => r.ref.length));
+    const wPhase = Math.max(5, ...rows.map((r) => r.phase.length));
+    return h `<${Box} flexDirection="column" marginTop=${1}>
+		${rows.map((r, i) => h `<${Box} key=${i}>
+				<${Text} color=${r.marker === "*" ? "green" : undefined}>  ${r.marker}</>
+				<${Box} width=${wRef + 2}><${Text}> ${r.ref}</></>
+				<${Box} width=${wPhase + 2}><${Text} color="yellow">${r.phase}</></>
+				<${Text} dimColor>${r.when}</>
+			</>`)}
+		<${Box} marginTop=${1}>
+			<${Text} dimColor>${"* HEAD — commands without <iid> resume here"}</>
+		</>
+	</>`;
+}
+function SessionDetail({ state, analysisSummary }) {
+    return h `<${Box} flexDirection="column">
+		<${Box}>
+			<${Text} color="yellow">Session  </>
+			<${Text}>${state.repo}#${state.iid}</>
+		</>
+		<${Box}>
+			<${Text} color="yellow">Phase    </>
+			<${Text}>${state.phase ?? "?"}</>
+		</>
+		${state.primary
+        ? h `<${Box}>
+				<${Text} color="yellow">Primary  </>
+				<${Text}>${state.primary}</>
+			</>`
+        : null}
+		${state.secondaries?.length
+        ? h `<${Box}>
+				<${Text} color="yellow">Secondary</>
+				<${Text}> ${state.secondaries.join(", ")}</>
+			</>`
+        : null}
+		${state.branch
+        ? h `<${Box}>
+				<${Text} color="yellow">Branch   </>
+				<${Text}>${state.branch}</>
+			</>`
+        : null}
+		${state.mrIid
+        ? h `<${Box}>
+				<${Text} color="yellow">MR       </>
+				<${Text}>!${state.mrIid}</>
+			</>`
+        : null}
+		${state.lastError
+        ? h `<${Box}>
+				<${Text} color="red">Error    </>
+				<${Text}>${state.lastError}</>
+			</>`
+        : null}
+		<${Box} marginTop=${1}>
+			<${Text} dimColor>${`Created ${relTime(state.createdAt)} · Updated ${relTime(state.updatedAt)}`}</>
+		</>
+		${analysisSummary
+        ? h `<${Box} flexDirection="column" marginTop=${1}>
+				<${Text} dimColor>${"Cached analysis:"}</>
+				<${Text}>${`  ${analysisSummary.changes} change(s) · ${analysisSummary.repos} repo(s) · ${analysisSummary.mrTitle ?? "(no proposed title)"}`}</>
+			</>`
+        : h `<${Box} marginTop=${1}>
+				<${Text} dimColor>${"No cached analysis on disk."}</>
+			</>`}
+	</>`;
+}
+async function listCommand(argv) {
+    const json = argv.includes("--json");
+    const sessions = await listSessions();
+    if (json) {
+        process.stdout.write(`${JSON.stringify(sessions, null, 2)}\n`);
+        return;
+    }
+    const head = await getHead();
+    await runApp(h `<${SessionsTable} sessions=${sessions} head=${head} />`);
+}
+async function showCommand(argv) {
+    const json = argv.includes("--json");
+    const explicitIid = Number(argv[2]);
+    const explicitRepo = getFlag(argv, "--repo");
+    const target = await resolveSessionTarget({
+        explicitIid: Number.isInteger(explicitIid) && explicitIid > 0 ? explicitIid : null,
+        explicitRepo,
+    });
+    if (!target?.repo || !target?.iid) {
+        console.error("No session target. Pass an <iid>, set --repo, or run analyze first.");
+        process.exit(1);
+    }
+    const state = await readState(target.repo, target.iid);
+    if (!state) {
+        console.error(`No session at ${sessionDir(target.repo, target.iid)}`);
+        process.exit(1);
+    }
+    const analysis = await readAnalysis(target.repo, target.iid);
+    if (json) {
+        process.stdout.write(`${JSON.stringify({ state, analysis }, null, 2)}\n`);
+        return;
+    }
+    const summary = analysis
+        ? {
+            changes: analysis.changes?.length ?? 0,
+            repos: analysis.repos?.length ?? 0,
+            mrTitle: analysis.mrTitle ?? null,
+        }
+        : null;
+    await runApp(h `<${SessionDetail} state=${state} analysisSummary=${summary} />`);
+}
+async function cleanCommand(argv) {
+    if (argv.includes("--all")) {
+        await cleanAll();
+        process.stderr.write(`✓ Removed all sessions\n`);
+        return;
+    }
+    const explicitIid = Number(argv[2]);
+    const explicitRepo = getFlag(argv, "--repo");
+    const target = await resolveSessionTarget({
+        explicitIid: Number.isInteger(explicitIid) && explicitIid > 0 ? explicitIid : null,
+        explicitRepo,
+    });
+    if (!target?.repo || !target?.iid) {
+        console.error("No session target. Pass an <iid>, set --repo, or use --all to wipe everything.");
+        process.exit(1);
+    }
+    const removed = await cleanSession(target.repo, target.iid);
+    if (removed)
+        process.stderr.write(`✓ Removed ${target.repo}#${target.iid}\n`);
+    else
+        process.stderr.write(`Nothing to remove at ${target.repo}#${target.iid}\n`);
+}
+export async function cmdSession(argv) {
+    const sub = argv[1] ?? "list";
+    if (sub === "list" || sub === "ls")
+        return listCommand(argv);
+    if (sub === "show")
+        return showCommand(argv);
+    if (sub === "clean" || sub === "rm")
+        return cleanCommand(argv);
+    console.error(`Unknown subcommand: ${sub}`);
+    console.error("Subcommands: list, show, clean");
+    process.exit(1);
+}
+/**
+ * Top-level `forge show [<iid>]` — re-renders the cached analysis from
+ * the session through the same Ink view as live analyze. Resolves <iid> via
+ * positional arg or HEAD pointer.
+ */
+export async function cmdShow(argv) {
+    const explicitIid = Number(argv[1]);
+    const explicitRepo = getFlag(argv, "--repo");
+    const json = argv.includes("--json");
+    const target = await resolveSessionTarget({
+        explicitIid: Number.isInteger(explicitIid) && explicitIid > 0 ? explicitIid : null,
+        explicitRepo,
+    });
+    if (!target?.repo || !target?.iid) {
+        console.error("No session target. Pass an <iid>, or run analyze first to seed HEAD.");
+        process.exit(1);
+    }
+    const analysis = await readAnalysis(target.repo, target.iid);
+    if (!analysis) {
+        console.error(`No cached analysis at ${sessionDir(target.repo, target.iid)}.\n` +
+            `Run: forge analyze ${target.iid}`);
+        process.exit(1);
+    }
+    if (json) {
+        process.stdout.write(`${JSON.stringify(analysis, null, 2)}\n`);
+        return;
+    }
+    // Reuse analyze.js's ResultBlock by importing it lazily — keeps the
+    // dependency cycle simple (session.js depends on the analyze view, but
+    // analyze.js doesn't depend on session.js's UI).
+    const { renderCachedResult } = await import("./analyze.js");
+    await renderCachedResult(analysis);
+}
+//# sourceMappingURL=session.js.map

package/lib/bin/cli/session.js.map

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

package/lib/bin/cli/sessionStore.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Session store for the ship workflow.
+ *
+ *   ~/.forge/sessions/<canonical-repo>/<iid>/
+ *     analysis.json   — last cached ForgeAgent.analyzeIssue result
+ *     state.json      — { phase, primary, secondaries, branch?, mrIid?, ... }
+ *     events.ndjson   — append-only log of every event we received
+ *
+ *   ~/.forge/sessions/HEAD
+ *     — single line: "<canonical-repo>/<iid>" of the most recently touched
+ *       session. Used so subsequent commands without an explicit <iid> can
+ *       resume the current unit of work, in the spirit of git's HEAD.
+ *
+ * Override the root with FORGE_SESSIONS_PATH (test isolation).
+ */
+import type { AnalysisResult, ForgeEvent } from "../../server/forge/core/types.ts";
+import type { SessionState } from "./types.ts";
+export declare const PHASES: Readonly<{
+    ANALYZED: "analyzed";
+    REFINED: "refined";
+    VALIDATED: "validated";
+    APPLIED: "applied";
+    WATCHING: "watching";
+    MERGED: "merged";
+    RESOLVED: "resolved";
+    CLOSED: "closed";
+}>;
+/**
+ * Resolve the on-disk directory for a session. Repo is canonicalised so
+ * "iplayulisten/web-app" and "gitlab:iplayulisten/web-app" map to the
+ * same folder.
+ */
+export declare function sessionDir(repo: string, iid: number | string): string;
+export declare function writeAnalysis(repo: string, iid: number | string, analysis: AnalysisResult): Promise<void>;
+export declare function readAnalysis(repo: string, iid: number | string): Promise<AnalysisResult | null>;
+export declare function readState(repo: string, iid: number | string): Promise<SessionState | null>;
+export declare function updateState(repo: string, iid: number | string, partial: Partial<SessionState>): Promise<SessionState>;
+export declare function appendEvent(repo: string, iid: number | string, evt: ForgeEvent | Record<string, unknown>): Promise<void>;
+export declare function setHead(repo: string, iid: number | string): Promise<void>;
+/**
+ * Return { repo, iid } of the HEAD session, or null.
+ */
+export declare function getHead(): Promise<{
+    repo: string;
+    iid: number;
+}>;
+/**
+ * Walk the on-disk tree and return every session it finds. Sorted by
+ * updatedAt descending (most recent first).
+ */
+export declare function listSessions(): Promise<SessionState[]>;
+export declare function cleanSession(repo: string, iid: number | string): Promise<boolean>;
+export declare function cleanAll(): Promise<void>;
+/**
+ * Resolve a session target from CLI argv. Honours an explicit positional iid
+ * or HEAD as fallback. Returns { repo, iid } or null.
+ *
+ *   forge show              → HEAD
+ *   forge show 42           → primary repo + iid 42
+ *   forge show 42 --repo X  → repo X + iid 42
+ */
+export declare function resolveSessionTarget({ explicitIid, explicitRepo }: {
+    explicitIid: number | null;
+    explicitRepo: string | null | undefined;
+}): Promise<{
+    repo: string;
+    iid: number;
+}>;
+//# sourceMappingURL=sessionStore.d.ts.map

package/lib/bin/cli/sessionStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sessionStore.d.ts","sourceRoot":"","sources":["../../../bin/cli/sessionStore.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAOH,OAAO,KAAK,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACnF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,eAAO,MAAM,MAAM;;;;;;;;;EASjB,CAAC;AASH;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,UAE5D;AAMD,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,QAAQ,EAAE,cAAc,iBAK/F;AAED,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAIrG;AAED,wBAAsB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAIhG;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,OAAO,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAc3H;AAED,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,iBAQ9G;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,iBAQ/D;AAED;;GAEG;AACH,wBAAsB,OAAO;;;GAU5B;AAED;;;GAGG;AACH,wBAAsB,YAAY,4BAsCjC;AAUD,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,oBASpE;AAED,wBAAsB,QAAQ,kBAI7B;AAED;;;;;;;GAOG;AACH,wBAAsB,oBAAoB,CAAC,EAAE,WAAW,EAAE,YAAY,EAAE,EAAE;IAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAA;CAAE;;;GAWhJ"}

package/lib/bin/cli/sessionStore.js

@@ -0,0 +1,196 @@
+/**
+ * Session store for the ship workflow.
+ *
+ *   ~/.forge/sessions/<canonical-repo>/<iid>/
+ *     analysis.json   — last cached ForgeAgent.analyzeIssue result
+ *     state.json      — { phase, primary, secondaries, branch?, mrIid?, ... }
+ *     events.ndjson   — append-only log of every event we received
+ *
+ *   ~/.forge/sessions/HEAD
+ *     — single line: "<canonical-repo>/<iid>" of the most recently touched
+ *       session. Used so subsequent commands without an explicit <iid> can
+ *       resume the current unit of work, in the spirit of git's HEAD.
+ *
+ * Override the root with FORGE_SESSIONS_PATH (test isolation).
+ */
+import { existsSync } from "node:fs";
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { canonicalRepoId } from "./utils.js";
+export const PHASES = Object.freeze({
+    ANALYZED: "analyzed",
+    REFINED: "refined",
+    VALIDATED: "validated",
+    APPLIED: "applied",
+    WATCHING: "watching",
+    MERGED: "merged",
+    RESOLVED: "resolved",
+    CLOSED: "closed",
+});
+function rootDir() {
+    return (process.env.FORGE_SESSIONS_PATH ??
+        path.join(os.homedir(), ".forge", "sessions"));
+}
+/**
+ * Resolve the on-disk directory for a session. Repo is canonicalised so
+ * "iplayulisten/web-app" and "gitlab:iplayulisten/web-app" map to the
+ * same folder.
+ */
+export function sessionDir(repo, iid) {
+    return path.join(rootDir(), canonicalRepoId(String(repo)), String(iid));
+}
+async function ensureDir(dir) {
+    await fs.mkdir(dir, { recursive: true, mode: 0o700 });
+}
+export async function writeAnalysis(repo, iid, analysis) {
+    const dir = sessionDir(repo, iid);
+    await ensureDir(dir);
+    const file = path.join(dir, "analysis.json");
+    await fs.writeFile(file, JSON.stringify(analysis, null, 2), { encoding: "utf8", mode: 0o600 });
+}
+export async function readAnalysis(repo, iid) {
+    const file = path.join(sessionDir(repo, iid), "analysis.json");
+    if (!existsSync(file))
+        return null;
+    return JSON.parse(await fs.readFile(file, "utf8"));
+}
+export async function readState(repo, iid) {
+    const file = path.join(sessionDir(repo, iid), "state.json");
+    if (!existsSync(file))
+        return null;
+    return JSON.parse(await fs.readFile(file, "utf8"));
+}
+export async function updateState(repo, iid, partial) {
+    const dir = sessionDir(repo, iid);
+    await ensureDir(dir);
+    const file = path.join(dir, "state.json");
+    const now = new Date().toISOString();
+    const prev = (await readState(repo, iid)) ?? {
+        repo: canonicalRepoId(String(repo)),
+        iid: Number(iid),
+        phase: "unknown",
+        createdAt: now,
+    };
+    const next = { ...prev, ...partial, updatedAt: now };
+    await fs.writeFile(file, JSON.stringify(next, null, 2), { encoding: "utf8", mode: 0o600 });
+    return next;
+}
+export async function appendEvent(repo, iid, evt) {
+    const dir = sessionDir(repo, iid);
+    await ensureDir(dir);
+    await fs.appendFile(path.join(dir, "events.ndjson"), `${JSON.stringify({ ts: new Date().toISOString(), ...evt })}\n`, "utf8");
+}
+export async function setHead(repo, iid) {
+    const root = rootDir();
+    await fs.mkdir(root, { recursive: true });
+    await fs.writeFile(path.join(root, "HEAD"), `${canonicalRepoId(String(repo))}/${iid}\n`, "utf8");
+}
+/**
+ * Return { repo, iid } of the HEAD session, or null.
+ */
+export async function getHead() {
+    const file = path.join(rootDir(), "HEAD");
+    if (!existsSync(file))
+        return null;
+    const raw = (await fs.readFile(file, "utf8")).trim();
+    const lastSlash = raw.lastIndexOf("/");
+    if (lastSlash <= 0)
+        return null;
+    const repo = raw.slice(0, lastSlash);
+    const iid = Number(raw.slice(lastSlash + 1));
+    if (!Number.isInteger(iid) || iid <= 0)
+        return null;
+    return { repo, iid };
+}
+/**
+ * Walk the on-disk tree and return every session it finds. Sorted by
+ * updatedAt descending (most recent first).
+ */
+export async function listSessions() {
+    const root = rootDir();
+    if (!existsSync(root))
+        return [];
+    const out = [];
+    const repoDirs = await safeReadDir(root);
+    for (const repoEntry of repoDirs) {
+        if (!repoEntry.isDirectory())
+            continue;
+        // Repos may be nested one level (e.g. "iplayulisten/web-app").
+        const repoLevel1 = path.join(root, repoEntry.name);
+        const repoSubdirs = await safeReadDir(repoLevel1);
+        for (const sub of repoSubdirs) {
+            if (!sub.isDirectory())
+                continue;
+            const candidatePath = path.join(repoLevel1, sub.name);
+            // Two layouts:
+            //  a) repoLevel1/<iid>/state.json     (single-segment repo)
+            //  b) repoLevel1/<sub>/<iid>/state.json (two-segment repo)
+            if (existsSync(path.join(candidatePath, "state.json"))) {
+                const state = JSON.parse(await fs.readFile(path.join(candidatePath, "state.json"), "utf8"));
+                out.push(state);
+                continue;
+            }
+            const iidEntries = await safeReadDir(candidatePath);
+            for (const iidEntry of iidEntries) {
+                if (!iidEntry.isDirectory())
+                    continue;
+                const stateFile = path.join(candidatePath, iidEntry.name, "state.json");
+                if (!existsSync(stateFile))
+                    continue;
+                const state = JSON.parse(await fs.readFile(stateFile, "utf8"));
+                out.push(state);
+            }
+        }
+    }
+    out.sort((a, b) => (b.updatedAt ?? "").localeCompare(a.updatedAt ?? ""));
+    return out;
+}
+async function safeReadDir(dir) {
+    try {
+        return await fs.readdir(dir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+}
+export async function cleanSession(repo, iid) {
+    const dir = sessionDir(repo, iid);
+    if (!existsSync(dir))
+        return false;
+    await fs.rm(dir, { recursive: true, force: true });
+    const head = await getHead();
+    if (head && canonicalRepoId(head.repo) === canonicalRepoId(String(repo)) && head.iid === Number(iid)) {
+        await fs.rm(path.join(rootDir(), "HEAD"), { force: true });
+    }
+    return true;
+}
+export async function cleanAll() {
+    const root = rootDir();
+    if (!existsSync(root))
+        return;
+    await fs.rm(root, { recursive: true, force: true });
+}
+/**
+ * Resolve a session target from CLI argv. Honours an explicit positional iid
+ * or HEAD as fallback. Returns { repo, iid } or null.
+ *
+ *   forge show              → HEAD
+ *   forge show 42           → primary repo + iid 42
+ *   forge show 42 --repo X  → repo X + iid 42
+ */
+export async function resolveSessionTarget({ explicitIid, explicitRepo }) {
+    if (Number.isInteger(explicitIid) && explicitIid > 0) {
+        // repo defaults to HEAD's repo if available, else explicitRepo, else
+        // the configStore primary. Keeps `show 42` working when there's a
+        // prior HEAD that was on the same repo.
+        if (explicitRepo)
+            return { repo: explicitRepo, iid: explicitIid };
+        const head = await getHead();
+        if (head)
+            return { repo: head.repo, iid: explicitIid };
+        return { repo: null, iid: explicitIid };
+    }
+    return await getHead();
+}
+//# sourceMappingURL=sessionStore.js.map

package/lib/bin/cli/sessionStore.js.map

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