@svenroth-ai/shipwright 0.24.1-next.0

package/server/dist/routes/diagnostics.js

@@ -0,0 +1,143 @@
+/*
+ * GET /api/diagnostics — external-launch health + version gate.
+ *
+ * Exposes the CLI version + supported-range, number of tracked sessions,
+ * last-scan timestamp (set by the heartbeat probe), and per-launcher
+ * availability (Copy is always available; Terminal/VSCode/Desktop are
+ * explicitly labeled as v2+).
+ *
+ * Round-3 plan integration: UI's Diagnostics page reads this and surfaces
+ * a persistent banner when the installed CLI is out-of-range.
+ */
+import { spawnSync } from "node:child_process";
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { Hono } from "hono";
+import { MIN_SUPPORTED_CLI } from "../core/cli-compat.js";
+const PATH_SAMPLE_LIMIT = 8;
+/**
+ * Stable wire-protocol identity for the Command Center. The npx bootstrapper
+ * matches on this exact string before treating a listener on :3847 as a
+ * Shipwright server (a foreign process that happens to answer
+ * `/api/diagnostics` is otherwise indistinguishable by version alone).
+ */
+export const APP_NAME = "shipwright-command-center";
+/**
+ * Read the server's own version from `server/package.json`. Memoized —
+ * the value is fixed for the process lifetime. Resolves two levels up from
+ * this module (`dist/routes/…` → `server/`, `src/routes/…` → `server/`),
+ * which holds for both the built and the tsx-run layouts. Never throws:
+ * a missing/garbled package.json degrades to `"unknown"` rather than 500ing
+ * the diagnostics route the operator relies on to debug.
+ */
+let cachedAppVersion;
+export function readAppVersion() {
+    if (cachedAppVersion !== undefined)
+        return cachedAppVersion;
+    try {
+        const pkgPath = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "../../package.json");
+        const parsed = JSON.parse(readFileSync(pkgPath, "utf-8"));
+        cachedAppVersion =
+            typeof parsed.version === "string" && parsed.version.length > 0
+                ? parsed.version
+                : "unknown";
+    }
+    catch {
+        cachedAppVersion = "unknown";
+    }
+    return cachedAppVersion;
+}
+function buildClaudeCliDiagnostic() {
+    const isWin = process.platform === "win32";
+    const lookup = isWin ? "where" : "which";
+    let whereOutput = "";
+    try {
+        const r = spawnSync(lookup, ["claude"], { encoding: "utf-8", shell: false });
+        whereOutput = (r.stdout ?? "").trim();
+    }
+    catch {
+        whereOutput = "";
+    }
+    const sep = isWin ? ";" : ":";
+    const pathRaw = process.env.PATH ?? "";
+    const pathEntries = pathRaw.length > 0 ? pathRaw.split(sep) : [];
+    const pathSample = pathEntries.slice(0, PATH_SAMPLE_LIMIT);
+    const checkedFallbacks = [];
+    if (isWin) {
+        const userProfile = process.env.USERPROFILE ?? "";
+        const appData = process.env.APPDATA ?? "";
+        const localAppData = process.env.LOCALAPPDATA ?? "";
+        const programFiles = process.env.ProgramFiles ?? "";
+        if (userProfile) {
+            checkedFallbacks.push(path.join(userProfile, ".local", "bin", "claude.exe"));
+            checkedFallbacks.push(path.join(userProfile, ".local", "bin", "claude.cmd"));
+        }
+        if (appData) {
+            checkedFallbacks.push(path.join(appData, "npm", "claude.cmd"));
+            checkedFallbacks.push(path.join(appData, "npm", "claude.exe"));
+        }
+        if (localAppData) {
+            checkedFallbacks.push(path.join(localAppData, "Microsoft", "WinGet", "Links", "claude.exe"));
+        }
+        if (programFiles) {
+            checkedFallbacks.push(path.join(programFiles, "Claude Code", "claude.exe"));
+        }
+    }
+    else {
+        const home = process.env.HOME ?? "";
+        if (home) {
+            checkedFallbacks.push(path.posix.join(home, ".local", "bin", "claude"));
+            checkedFallbacks.push(path.posix.join(home, ".npm-global", "bin", "claude"));
+        }
+        checkedFallbacks.push("/usr/local/bin/claude");
+        checkedFallbacks.push("/opt/homebrew/bin/claude");
+    }
+    // Annotate which candidates exist on disk — the operator immediately
+    // sees "this one exists but PATH lookup didn't find it" vs "none of
+    // the curated paths exist".
+    const annotated = checkedFallbacks.map((p) => `${p} (${existsSync(p) ? "exists" : "missing"})`);
+    const overrideRaw = process.env.SHIPWRIGHT_CLAUDE_BIN?.trim();
+    const envOverride = overrideRaw
+        ? `${overrideRaw} (${existsSync(overrideRaw) ? "exists" : "missing"})`
+        : null;
+    return { whereOutput, pathSample, checkedFallbacks: annotated, envOverride };
+}
+export function createDiagnosticsRoutes(args) {
+    const app = new Hono();
+    const appVersion = args.appVersion ?? readAppVersion();
+    app.get("/api/diagnostics", (c) => {
+        const v = args.versionInfo();
+        const tasks = args.store.list();
+        const byState = {};
+        for (const t of tasks) {
+            byState[t.state] = (byState[t.state] ?? 0) + 1;
+        }
+        const claudeCli = {
+            raw: v.raw,
+            parsed: v.parsed,
+            supported: v.supported,
+            minSupported: MIN_SUPPORTED_CLI,
+        };
+        if (!v.supported) {
+            claudeCli.diagnostic = buildClaudeCliDiagnostic();
+        }
+        const snapshot = {
+            app: { name: APP_NAME, version: appVersion },
+            claudeCli,
+            sessions: {
+                total: tasks.length,
+                byState,
+            },
+            launchers: {
+                copy: { available: true },
+                terminal: { available: false, reason: "deferred to v2 (variant-a narrow)" },
+                vscode: { available: false, reason: "deferred to v2 (variant-a narrow)" },
+                desktop: { available: false, reason: "awaiting Claude Desktop URL scheme" },
+            },
+        };
+        return c.json(snapshot);
+    });
+    return app;
+}
+//# sourceMappingURL=diagnostics.js.map

package/server/dist/routes/diagnostics.js.map

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

package/server/dist/routes/grade.d.ts

@@ -0,0 +1,13 @@
+import { Hono } from "hono";
+import { type GradeOutcome } from "../core/grade-runner.js";
+export declare function createGradeRoutes(args?: {
+    /** Runner override (test seam) — defaults to the real spawn runner. */
+    runGrade?: (input: {
+        target: string;
+    }, deps?: {
+        timeoutMs?: number;
+    }) => Promise<GradeOutcome>;
+    /** Per-grade timeout override (test seam). */
+    timeoutMs?: number;
+}): Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+//# sourceMappingURL=grade.d.ts.map

package/server/dist/routes/grade.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"grade.d.ts","sourceRoot":"","sources":["../../src/routes/grade.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,EAAY,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAMtE,wBAAgB,iBAAiB,CAAC,IAAI,CAAC,EAAE;IACvC,uEAAuE;IACvE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,IAAI,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/F,8CAA8C;IAC9C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,8EAqBA"}

package/server/dist/routes/grade.js

@@ -0,0 +1,45 @@
+/*
+ * POST /api/wizard/grade — the read-only Grade door route (A09b, FR-01.53).
+ *
+ * Runs `shipwright-grade`'s `grade.py <target> --format json` via
+ * `core/grade-runner.ts` (shell:false, fixed python binary, validated target)
+ * and returns the plugin's real `ReportModel` — or an HONEST degraded state.
+ * Grade registers NO project and writes NOTHING (a bare grade is read-only);
+ * this is a pure observer route, so it is POST only for a request body, never a
+ * mutation.
+ *
+ * Response contract — 200 for EVERY grade OUTCOME (the discriminated union
+ * carries the state, so the client renders an honest card for each and never
+ * has to distinguish an HTTP error from a grade state):
+ *   { status: "report-ready", model }        — the raw ReportModel (client-guarded)
+ *   { status: "grade-failed", reason }        — TargetError / non-zero exit
+ *   { status: "engine-unavailable", reason, repairCommand }
+ *   { status: "shape-unrecognised", reason }  — non-JSON output
+ * A structurally-invalid REQUEST (no target) is the one 4xx.
+ */
+import { Hono } from "hono";
+import { runGrade } from "../core/grade-runner.js";
+function isObject(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+export function createGradeRoutes(args) {
+    const app = new Hono();
+    const run = args?.runGrade ?? runGrade;
+    app.post("/api/wizard/grade", async (c) => {
+        let body;
+        try {
+            body = await c.req.json();
+        }
+        catch {
+            return c.json({ status: "grade-failed", reason: "The request wasn't valid JSON." }, 400);
+        }
+        const target = isObject(body) ? body.target : undefined;
+        if (typeof target !== "string" || target.trim().length === 0) {
+            return c.json({ status: "grade-failed", reason: "No repo was given." }, 400);
+        }
+        const outcome = await run({ target }, { timeoutMs: args?.timeoutMs });
+        return c.json(outcome);
+    });
+    return app;
+}
+//# sourceMappingURL=grade.js.map

package/server/dist/routes/grade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grade.js","sourceRoot":"","sources":["../../src/routes/grade.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,EAAE,QAAQ,EAAqB,MAAM,yBAAyB,CAAC;AAEtE,SAAS,QAAQ,CAAC,CAAU;IAC1B,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,IAKjC;IACC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,GAAG,GAAG,IAAI,EAAE,QAAQ,IAAI,QAAQ,CAAC;IAEvC,GAAG,CAAC,IAAI,CAAC,mBAAmB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QACxC,IAAI,IAAa,CAAC;QAClB,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QAC5B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,gCAAgC,EAAE,EAAE,GAAG,CAAC,CAAC;QAC3F,CAAC;QACD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;QACxD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7D,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,oBAAoB,EAAE,EAAE,GAAG,CAAC,CAAC;QAC/E,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;QACtE,OAAO,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACzB,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC"}

package/server/dist/routes/profiles.d.ts

@@ -0,0 +1,25 @@
+import { Hono } from "hono";
+export interface ProfileSummary {
+    name: string;
+    label?: string;
+    description?: string;
+}
+export interface ProfilesRouteDeps {
+    profilesDir?: string;
+    readdirSync?: (path: string) => string[];
+    loadProfile?: (name: string, dir: string) => {
+        name?: string;
+        label?: string;
+        description?: string;
+    } | null;
+}
+/**
+ * Iterate 14.4 — GET /api/profiles
+ *
+ * Lists all profile JSON files in `shared/profiles/` as ProfileSummary
+ * objects, sorted alphabetically by `name`. Files starting with `_` are
+ * skipped (internal/disabled). Malformed JSON is logged and skipped — the
+ * route never 500s on a single bad file.
+ */
+export declare function createProfilesRoutes(deps?: ProfilesRouteDeps): Hono;
+//# sourceMappingURL=profiles.d.ts.map

package/server/dist/routes/profiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.d.ts","sourceRoot":"","sources":["../../src/routes/profiles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAI5B,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;IACzC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,KAAK;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC7G;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,GAAE,iBAAsB,GAAG,IAAI,CA8CvE"}

package/server/dist/routes/profiles.js

@@ -0,0 +1,58 @@
+import { Hono } from "hono";
+import { readdirSync } from "node:fs";
+import { loadProfile, getProfilesDir } from "../core/profile-loader.js";
+/**
+ * Iterate 14.4 — GET /api/profiles
+ *
+ * Lists all profile JSON files in `shared/profiles/` as ProfileSummary
+ * objects, sorted alphabetically by `name`. Files starting with `_` are
+ * skipped (internal/disabled). Malformed JSON is logged and skipped — the
+ * route never 500s on a single bad file.
+ */
+export function createProfilesRoutes(deps = {}) {
+    const app = new Hono();
+    const dir = deps.profilesDir ?? getProfilesDir();
+    const readdir = deps.readdirSync ?? ((p) => readdirSync(p));
+    const load = deps.loadProfile ?? loadProfile;
+    app.get("/api/profiles", (c) => {
+        let entries;
+        try {
+            entries = readdir(dir);
+        }
+        catch (err) {
+            console.error(JSON.stringify({
+                level: "warn",
+                message: "Failed to read profiles directory",
+                dir,
+                error: String(err),
+            }));
+            return c.json({ data: [] });
+        }
+        const profiles = [];
+        for (const file of entries) {
+            if (!file.endsWith(".json"))
+                continue;
+            if (file.startsWith("_"))
+                continue;
+            const name = file.replace(/\.json$/, "");
+            const data = load(name, dir);
+            if (!data) {
+                console.error(JSON.stringify({
+                    level: "warn",
+                    message: "Skipping malformed or unreadable profile",
+                    file,
+                }));
+                continue;
+            }
+            profiles.push({
+                name: data.name ?? name,
+                ...(data.label !== undefined && { label: data.label }),
+                ...(data.description !== undefined && { description: data.description }),
+            });
+        }
+        profiles.sort((a, b) => a.name.localeCompare(b.name));
+        return c.json({ data: profiles });
+    });
+    return app;
+}
+//# sourceMappingURL=profiles.js.map

package/server/dist/routes/profiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profiles.js","sourceRoot":"","sources":["../../src/routes/profiles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAcxE;;;;;;;GAOG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAA0B,EAAE;IAC/D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,IAAI,cAAc,EAAE,CAAC;IACjD,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,IAAI,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IACpE,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC;IAE7C,GAAG,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC,EAAE,EAAE;QAC7B,IAAI,OAAiB,CAAC;QACtB,IAAI,CAAC;YACH,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;gBAC3B,KAAK,EAAE,MAAM;gBACb,OAAO,EAAE,mCAAmC;gBAC5C,GAAG;gBACH,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC;aACnB,CAAC,CAAC,CAAC;YACJ,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAC9B,CAAC;QAED,MAAM,QAAQ,GAAqB,EAAE,CAAC;QACtC,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;YAC3B,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAAE,SAAS;YACtC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,SAAS;YACnC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;YACzC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;YAC7B,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;oBAC3B,KAAK,EAAE,MAAM;oBACb,OAAO,EAAE,0CAA0C;oBACnD,IAAI;iBACL,CAAC,CAAC,CAAC;gBACJ,SAAS;YACX,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI;gBACvB,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;gBACtD,GAAG,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,IAAI,CAAC,WAAW,EAAE,CAAC;aACzE,CAAC,CAAC;QACL,CAAC;QAED,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACtD,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC"}

package/server/dist/routes/projects.d.ts

@@ -0,0 +1,20 @@
+import { Hono } from "hono";
+import type { ProjectManager } from "../core/project-manager.js";
+export interface ProjectRouteDeps {
+    existsSync: (path: string) => boolean;
+    mkdirSync: (path: string, opts?: {
+        recursive: boolean;
+    }) => void;
+    writeFileSync: (path: string, data: string) => void;
+    renameSync: (from: string, to: string) => void;
+}
+export declare function createProjectRoutes(projectManager: ProjectManager, fsDeps?: ProjectRouteDeps, 
+/**
+ * iterate-2026-07-06-project-delete-cascades-tasks — invoked AFTER a
+ * successful project delete to cascade-remove that project's tasks (so no
+ * orphaned "Unassigned" bucket lingers). Returns the count removed. Wired
+ * in index.ts to `cascadeDeleteProjectTasks`; omitted in unit tests that
+ * don't exercise the cascade.
+ */
+onProjectDeleted?: (projectId: string) => number | Promise<number>): Hono;
+//# sourceMappingURL=projects.d.ts.map

package/server/dist/routes/projects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"projects.d.ts","sourceRoot":"","sources":["../../src/routes/projects.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAIjE,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACtC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IACjE,aAAa,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI,CAAC;CAChD;AAyBD,wBAAgB,mBAAmB,CACjC,cAAc,EAAE,cAAc,EAC9B,MAAM,CAAC,EAAE,gBAAgB;AACzB;;;;;;GAMG;AACH,gBAAgB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GACjE,IAAI,CAoEN"}

package/server/dist/routes/projects.js

@@ -0,0 +1,105 @@
+/*
+ * /api/projects/* — minimal CRUD. Plan D'' Sub-iterate 3 simplification:
+ * no more fileWatcher + eventStore + sseManager side-effects (all removed
+ * with the chat/pipeline runtime).
+ *
+ * The wizard's "pipeline" project endpoint and initial-phase spawning are
+ * gone — projects are plain metadata registrations. Pipeline mode is a
+ * follow-up iterate once external-launch ships.
+ */
+import { Hono } from "hono";
+import { AppError } from "../middleware/error-handler.js";
+import { normalizeFsPath } from "../core/normalize-fs-path.js";
+// One-double-click-to-VS-Code: emitted into <project.path>/.shipwright-webui/
+// on POST /api/projects. Relative `..` keeps the file portable across machines
+// and survives directory renames. Idempotent — never overwrites a file the
+// user may have customized.
+const WORKSPACE_CONTENT = JSON.stringify({
+    folders: [{ path: ".." }],
+    settings: {
+        "terminal.integrated.defaultLocation": "editor",
+        "explorer.compactFolders": false,
+    },
+}, null, 2);
+function slugifyProjectName(name) {
+    return name
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "");
+}
+export function createProjectRoutes(projectManager, fsDeps, 
+/**
+ * iterate-2026-07-06-project-delete-cascades-tasks — invoked AFTER a
+ * successful project delete to cascade-remove that project's tasks (so no
+ * orphaned "Unassigned" bucket lingers). Returns the count removed. Wired
+ * in index.ts to `cascadeDeleteProjectTasks`; omitted in unit tests that
+ * don't exercise the cascade.
+ */
+onProjectDeleted) {
+    const app = new Hono();
+    app.get("/api/projects", (c) => c.json({ data: projectManager.getAll() }));
+    app.get("/api/projects/:id", (c) => {
+        const project = projectManager.getById(c.req.param("id"));
+        if (!project)
+            throw new AppError("Project not found", 404);
+        return c.json({ data: project });
+    });
+    app.post("/api/projects", async (c) => {
+        const body = await c.req.json();
+        // Strip a paste-artifact surrounding quote pair BEFORE the fs probes and
+        // create() below run against it — a quoted path would otherwise fail
+        // existsSync, mkdir a garbage relative directory, and (once stored) feed a
+        // broken `cd ''\''…'\'''` prefix into the launch command. See
+        // core/normalize-fs-path.ts.
+        if (typeof body.path === "string")
+            body.path = normalizeFsPath(body.path);
+        if (!body.name || !body.path) {
+            throw new AppError("name and path are required", 400);
+        }
+        if (fsDeps) {
+            if (!fsDeps.existsSync(body.path)) {
+                fsDeps.mkdirSync(body.path, { recursive: true });
+            }
+            const webuiDir = `${body.path}/.shipwright-webui`;
+            if (!fsDeps.existsSync(webuiDir)) {
+                fsDeps.mkdirSync(webuiDir, { recursive: true });
+            }
+            const slug = slugifyProjectName(String(body.name));
+            if (slug.length > 0) {
+                const workspacePath = `${webuiDir}/${slug}.code-workspace`;
+                if (!fsDeps.existsSync(workspacePath)) {
+                    // Atomic temp+rename mirrors sdk-sessions-store.ts convention.
+                    const tmpPath = `${workspacePath}.tmp`;
+                    fsDeps.writeFileSync(tmpPath, WORKSPACE_CONTENT);
+                    fsDeps.renameSync(tmpPath, workspacePath);
+                }
+            }
+        }
+        const project = projectManager.create(body);
+        return c.json({ data: project }, 201);
+    });
+    app.patch("/api/projects/:id", async (c) => {
+        const body = await c.req.json();
+        // Same paste-artifact guard as POST, for path edits via the settings UI.
+        if (typeof body.path === "string")
+            body.path = normalizeFsPath(body.path);
+        const updated = projectManager.update(c.req.param("id"), body);
+        if (!updated)
+            throw new AppError("Project not found", 404);
+        return c.json({ data: updated });
+    });
+    app.delete("/api/projects/:id", async (c) => {
+        const id = c.req.param("id");
+        // Throws AppError(404) when the id is unknown — the cascade below is
+        // skipped in that case (the throw short-circuits to the error handler).
+        projectManager.delete(id);
+        // iterate-2026-07-06-project-delete-cascades-tasks — cascade-remove the
+        // project's tasks so no orphaned "Unassigned" bucket survives. Without
+        // this the tasks keep a dangling projectId and the projects list keeps
+        // synthesizing a phantom, un-clearable Unassigned row.
+        const deletedTaskCount = onProjectDeleted ? await onProjectDeleted(id) : 0;
+        return c.json({ ok: true, deletedTaskCount });
+    });
+    return app;
+}
+//# sourceMappingURL=projects.js.map

package/server/dist/routes/projects.js.map

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

package/server/dist/routes/readiness.d.ts

@@ -0,0 +1,11 @@
+import { Hono } from "hono";
+import { type ClaudeVersionInfo } from "../core/cli-compat.js";
+import { probeReadiness } from "../core/readiness-probe.js";
+export declare function createReadinessRoutes(args: {
+    versionInfo: () => ClaudeVersionInfo;
+    /** Memo window; defaults to 15s. A test seam. */
+    ttlMs?: number;
+    /** Probe override (test seam) — defaults to the real fs + spawn probe. */
+    probe?: typeof probeReadiness;
+}): Hono<import("hono/types").BlankEnv, import("hono/types").BlankSchema, "/">;
+//# sourceMappingURL=readiness.d.ts.map

package/server/dist/routes/readiness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness.d.ts","sourceRoot":"","sources":["../../src/routes/readiness.ts"],"names":[],"mappings":"AAoBA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,EAAqB,KAAK,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAClF,OAAO,EAAE,cAAc,EAAwB,MAAM,4BAA4B,CAAC;AAElF,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAC1C,WAAW,EAAE,MAAM,iBAAiB,CAAC;IACrC,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,KAAK,CAAC,EAAE,OAAO,cAAc,CAAC;CAC/B,8EAgCA"}

package/server/dist/routes/readiness.js

@@ -0,0 +1,52 @@
+/*
+ * GET /api/readiness — the First-Contact readiness GATE (FR-01.51).
+ *
+ * Runs the shared preflight check set (`core/readiness-probe.ts`) once and
+ * memoises it for a short TTL: the probe test-runs `uv`/`python`/`git`
+ * `--version` (up to a few seconds each), and the wizard fetches this exactly
+ * once on mount, so a per-request re-probe would be wasteful without being any
+ * fresher. The Claude verdict is taken from the same live cli-compat probe the
+ * diagnostics route uses (`versionInfo()`), so a CLI upgrade is reflected on the
+ * next TTL window without a server restart.
+ *
+ * The probe is ASYNC (`execFile`) so it never blocks the event loop the live
+ * terminal WebSockets + transcript poll share; concurrent requests on a cold
+ * cache coalesce onto ONE in-flight probe rather than each spawning their own.
+ *
+ * This is deliberately a SEPARATE endpoint from `/api/diagnostics` — the
+ * bootstrapper polls diagnostics on every attach-vs-swap decision, and it must
+ * stay a cheap identity read, never a multi-second toolchain probe.
+ */
+import { Hono } from "hono";
+import { MIN_SUPPORTED_CLI } from "../core/cli-compat.js";
+import { probeReadiness } from "../core/readiness-probe.js";
+export function createReadinessRoutes(args) {
+    const app = new Hono();
+    const ttl = args.ttlMs ?? 15_000;
+    const probe = args.probe ?? probeReadiness;
+    let cached = null;
+    let inflight = null;
+    app.get("/api/readiness", async (c) => {
+        const now = Date.now();
+        const fresh = cached !== null && ttl > 0 && now - cached.at <= ttl;
+        if (fresh)
+            return c.json(cached.report);
+        // Cold/stale cache: start ONE probe and let concurrent requests await it,
+        // so a burst never fans out into N parallel toolchain probes.
+        if (!inflight) {
+            const v = args.versionInfo();
+            inflight = Promise.resolve(probe({ claude: { supported: v.supported, raw: v.raw, minSupported: MIN_SUPPORTED_CLI } }))
+                .then((report) => {
+                cached = { at: Date.now(), report };
+                return report;
+            })
+                .finally(() => {
+                inflight = null;
+            });
+        }
+        const report = await inflight;
+        return c.json(report);
+    });
+    return app;
+}
+//# sourceMappingURL=readiness.js.map

package/server/dist/routes/readiness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readiness.js","sourceRoot":"","sources":["../../src/routes/readiness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,EAAE,iBAAiB,EAA0B,MAAM,uBAAuB,CAAC;AAClF,OAAO,EAAE,cAAc,EAAwB,MAAM,4BAA4B,CAAC;AAElF,MAAM,UAAU,qBAAqB,CAAC,IAMrC;IACC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC;IACjC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,cAAc,CAAC;IAC3C,IAAI,MAAM,GAAmD,IAAI,CAAC;IAClE,IAAI,QAAQ,GAAoC,IAAI,CAAC;IAErD,GAAG,CAAC,GAAG,CAAC,gBAAgB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QACpC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,MAAM,KAAK,IAAI,IAAI,GAAG,GAAG,CAAC,IAAI,GAAG,GAAG,MAAM,CAAC,EAAE,IAAI,GAAG,CAAC;QACnE,IAAI,KAAK;YAAE,OAAO,CAAC,CAAC,IAAI,CAAE,MAAsC,CAAC,MAAM,CAAC,CAAC;QAEzE,0EAA0E;QAC1E,8DAA8D;QAC9D,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,MAAM,CAAC,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YAC7B,QAAQ,GAAG,OAAO,CAAC,OAAO,CACxB,KAAK,CAAC,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,YAAY,EAAE,iBAAiB,EAAE,EAAE,CAAC,CAC3F;iBACE,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;gBACf,MAAM,GAAG,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC;gBACpC,OAAO,MAAM,CAAC;YAChB,CAAC,CAAC;iBACD,OAAO,CAAC,GAAG,EAAE;gBACZ,QAAQ,GAAG,IAAI,CAAC;YAClB,CAAC,CAAC,CAAC;QACP,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC;QAC9B,OAAO,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACxB,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC"}

package/server/dist/routes/settings.d.ts

@@ -0,0 +1,13 @@
+import { Hono } from "hono";
+export interface SettingsDeps {
+    readFile: (path: string, encoding: string) => Promise<string>;
+    writeFile: (path: string, data: string) => Promise<void>;
+    existsSync: (path: string) => boolean;
+    mkdirSync: (path: string, opts?: {
+        recursive: boolean;
+    }) => void;
+    lock?: (path: string) => Promise<() => Promise<void>>;
+    ensureFile?: (path: string) => void;
+}
+export declare function createSettingsRoutes(settingsPath: string, deps: SettingsDeps): Hono;
+//# sourceMappingURL=settings.d.ts.map

package/server/dist/routes/settings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/routes/settings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG5B,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9D,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACzD,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACtC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,KAAK,IAAI,CAAC;IAIjE,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACtD,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACrC;AAQD,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE,YAAY,GACjB,IAAI,CA6DN"}

package/server/dist/routes/settings.js

@@ -0,0 +1,69 @@
+import { Hono } from "hono";
+const DEFAULT_SETTINGS = {
+    port: 3847,
+    maxConcurrent: 3,
+    heartbeatIntervalMs: 30000,
+};
+export function createSettingsRoutes(settingsPath, deps) {
+    const app = new Hono();
+    app.get("/api/settings", async (c) => {
+        if (!deps.existsSync(settingsPath)) {
+            return c.json({ data: DEFAULT_SETTINGS });
+        }
+        try {
+            const content = await deps.readFile(settingsPath, "utf-8");
+            return c.json({ data: { ...DEFAULT_SETTINGS, ...JSON.parse(content) } });
+        }
+        catch {
+            return c.json({ data: DEFAULT_SETTINGS });
+        }
+    });
+    app.put("/api/settings", async (c) => {
+        const body = await c.req.json();
+        const dir = settingsPath.substring(0, settingsPath.lastIndexOf("/"));
+        if (dir && !deps.existsSync(dir)) {
+            deps.mkdirSync(dir, { recursive: true });
+        }
+        // Ensure the file exists BEFORE acquiring the lock — proper-lockfile
+        // calls lstat on the target path and fails if it's missing. The
+        // first PUT against a fresh install has no settings.json yet.
+        if (deps.ensureFile)
+            deps.ensureFile(settingsPath);
+        // Read-merge-write must happen inside the lock; otherwise two
+        // concurrent PUTs would both read the same baseline and the second
+        // writer would silently drop the first writer's fields.
+        const rmw = async () => {
+            let existing = { ...DEFAULT_SETTINGS };
+            if (deps.existsSync(settingsPath)) {
+                try {
+                    const content = await deps.readFile(settingsPath, "utf-8");
+                    if (content.trim()) {
+                        existing = { ...existing, ...JSON.parse(content) };
+                    }
+                }
+                catch {
+                    // Malformed or empty — fall back to defaults.
+                }
+            }
+            const merged = { ...existing, ...body };
+            await deps.writeFile(settingsPath, JSON.stringify(merged, null, 2));
+            return merged;
+        };
+        let merged;
+        if (deps.lock) {
+            const release = await deps.lock(settingsPath);
+            try {
+                merged = await rmw();
+            }
+            finally {
+                await release();
+            }
+        }
+        else {
+            merged = await rmw();
+        }
+        return c.json({ data: merged });
+    });
+    return app;
+}
+//# sourceMappingURL=settings.js.map

package/server/dist/routes/settings.js.map

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

package/server/dist/routes/terminal-appearance.d.ts

@@ -0,0 +1,7 @@
+import { Hono } from "hono";
+export interface TerminalAppearanceRouteDeps {
+    /** Injected for tests; defaults to the real reader. */
+    readClaudeTheme?: () => Promise<string | null>;
+}
+export declare function createTerminalAppearanceRoutes(deps?: TerminalAppearanceRouteDeps): Hono;
+//# sourceMappingURL=terminal-appearance.d.ts.map

package/server/dist/routes/terminal-appearance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-appearance.d.ts","sourceRoot":"","sources":["../../src/routes/terminal-appearance.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG5B,MAAM,WAAW,2BAA2B;IAC1C,uDAAuD;IACvD,eAAe,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;CAChD;AAED,wBAAgB,8BAA8B,CAC5C,IAAI,GAAE,2BAAgC,GACrC,IAAI,CAUN"}