@svenroth-ai/shipwright 0.24.1-next.0

package/server/dist/external/runs/routes.d.ts

@@ -0,0 +1,16 @@
+import { Hono } from "hono";
+import { type RunDataBundle } from "../../core/run-data-join.js";
+import type { ExternalRouteProjectView } from "../_shared/helpers.js";
+export interface RunsRouterDeps {
+    getProjectById?: (id: string) => ExternalRouteProjectView | undefined;
+    /**
+     * Reads + joins a project's event log into the run-data bundle. Defaults to
+     * the real reader; tests inject a stub so they don't touch the filesystem
+     * (the join's own semantics are covered in core/run-data-join.test.ts).
+     */
+    readRunData?: (projectRoot: string, opts?: {
+        runId?: string;
+    }) => RunDataBundle;
+}
+export declare function createRunsRouter(deps: RunsRouterDeps): Hono;
+//# sourceMappingURL=routes.d.ts.map

package/server/dist/external/runs/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../src/external/runs/routes.ts"],"names":[],"mappings":"AAyBA,OAAO,EAAE,IAAI,EAAgB,MAAM,MAAM,CAAC;AAE1C,OAAO,EAEL,KAAK,aAAa,EACnB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAEtE,MAAM,WAAW,cAAc;IAC7B,cAAc,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,wBAAwB,GAAG,SAAS,CAAC;IACtE;;;;OAIG;IACH,WAAW,CAAC,EAAE,CACZ,WAAW,EAAE,MAAM,EACnB,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,KACtB,aAAa,CAAC;CACpB;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI,CA6C3D"}

package/server/dist/external/runs/routes.js

@@ -0,0 +1,69 @@
+/*
+ * external/runs/routes.ts — read-only observer of a project's per-run facts,
+ * joined from the tracked event log (`<project.path>/shipwright_events.jsonl`).
+ * A02, campaign webui-wow-usability-2026-07-10 (consumes A01's reader).
+ *
+ * Owns:
+ *   GET /api/external/projects/:projectId/runs         (logbook list + pipeline agg)
+ *   GET /api/external/projects/:projectId/runs/:runId   (Record-rail detail)
+ *   GET /api/external/projects/:projectId/grade-trend   (grade_snapshot series)
+ *
+ * WebUI never writes the event log (CLAUDE.md rule 1 / rule 12 spirit). No
+ * POST/PATCH/PUT/DELETE handler exists; Hono 404s an undeclared method.
+ *
+ * Response shapes:
+ *   /runs        200 { status:"ok", runs, runCount, gradeTrend, pipelinePhaseDurations, skippedLines }
+ *   /runs/:runId 200 { status:"ok", run: RunDataJoin | null }
+ *                    — an UNKNOWN runId is a graceful `run: null` (200), NOT a
+ *                      404: the join degrades, never throws (spec AC1/AC2).
+ *   /grade-trend 200 { status:"ok", gradeTrend }
+ *   404 { error:"project_not_found", projectId } · 400 { error:"project_path_unavailable", projectId }
+ *
+ * An absent/unreadable log yields an ok payload with empty runs/[] (graceful).
+ * Sourced by core/run-data-join.ts (path-guarded, tolerant JSONL parse).
+ */
+import { Hono } from "hono";
+import { readRunData, } from "../../core/run-data-join.js";
+export function createRunsRouter(deps) {
+    const app = new Hono();
+    const { getProjectById } = deps;
+    const reader = deps.readRunData ??
+        ((projectRoot, opts) => readRunData(projectRoot, opts));
+    /** Resolve the project or return the matching error Response. */
+    const resolve = (c) => {
+        const projectId = c.req.param("projectId") ?? "";
+        const project = getProjectById?.(projectId);
+        if (!project) {
+            return c.json({ error: "project_not_found", projectId }, 404);
+        }
+        if (!project.path) {
+            return c.json({ error: "project_path_unavailable", projectId }, 400);
+        }
+        return { path: project.path };
+    };
+    app.get("/api/external/projects/:projectId/runs", (c) => {
+        const r = resolve(c);
+        if (r instanceof Response)
+            return r;
+        const bundle = reader(r.path);
+        return c.json({ status: "ok", ...bundle });
+    });
+    app.get("/api/external/projects/:projectId/runs/:runId", (c) => {
+        const r = resolve(c);
+        if (r instanceof Response)
+            return r;
+        const runId = c.req.param("runId");
+        const bundle = reader(r.path, { runId });
+        const run = bundle.runs.length > 0 ? bundle.runs[0] : null;
+        return c.json({ status: "ok", run });
+    });
+    app.get("/api/external/projects/:projectId/grade-trend", (c) => {
+        const r = resolve(c);
+        if (r instanceof Response)
+            return r;
+        const bundle = reader(r.path);
+        return c.json({ status: "ok", gradeTrend: bundle.gradeTrend });
+    });
+    return app;
+}
+//# sourceMappingURL=routes.js.map

package/server/dist/external/runs/routes.js.map

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

package/server/dist/external/tasks/_phase-helpers.d.ts

@@ -0,0 +1,37 @@
+import type { ExternalRouteProjectView } from "../_shared/helpers.js";
+/**
+ * iterate-2026-05-18-edit-task-dialog — validate a phase id against a
+ * project's actions catalog. Mirrors the inline POST /tasks phase
+ * branch; used by PATCH /tasks/:id when the Edit Task dialog changes a
+ * never-started task's phase. Returns the resolved id + label, or a
+ * structured error body for the route to emit with status 400.
+ */
+export declare function validatePhaseForProject(rawPhase: string, projectId: string, getProjectById: ((id: string) => ExternalRouteProjectView | undefined) | undefined): {
+    phase: string;
+    phaseLabel: string;
+} | {
+    error: Record<string, unknown>;
+};
+/**
+ * iterate/multi-session-run-orchestrator-v2 — Validates phase-task fields
+ * on the create-task body. Returns either resolved fields or a structured
+ * error tuple. Pure shape-check; cross-checks against the run-config
+ * happen in the launch route, which is the security boundary.
+ *
+ * Plan A6.5: shape-validate every field; the route enforces idempotency
+ * via store.findByPhaseTaskId().
+ */
+export type PhaseTaskCreateFields = {
+    phaseTaskId?: string;
+    runId?: string;
+    sessionUuid?: string;
+    parentRunMaster?: boolean;
+};
+export declare function resolvePhaseTaskCreateFields(body: Record<string, unknown>): PhaseTaskCreateFields | {
+    error: {
+        error: string;
+        detail?: string;
+    };
+    status: 400;
+};
+//# sourceMappingURL=_phase-helpers.d.ts.map

package/server/dist/external/tasks/_phase-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_phase-helpers.d.ts","sourceRoot":"","sources":["../../../src/external/tasks/_phase-helpers.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAEtE;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,CAAC,CAAC,EAAE,EAAE,MAAM,KAAK,wBAAwB,GAAG,SAAS,CAAC,GAAG,SAAS,GAEhF;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAwBrC;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,CAAC;AAEF,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAE3B,qBAAqB,GACrB;IAAE,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,MAAM,EAAE,GAAG,CAAA;CAAE,CAoE7D"}

package/server/dist/external/tasks/_phase-helpers.js

@@ -0,0 +1,101 @@
+/*
+ * external/tasks/_phase-helpers.ts — phase-task shape validation +
+ * project-bound phase resolution. Extracted from routes.ts during C2.
+ */
+import { loadActionsForProject } from "../../core/project-actions-loader.js";
+import { PHASE_TASK_ID_PATTERN, RUN_ID_PATTERN, SESSION_UUID_PATTERN, } from "../../types/run-config-v2.js";
+/**
+ * iterate-2026-05-18-edit-task-dialog — validate a phase id against a
+ * project's actions catalog. Mirrors the inline POST /tasks phase
+ * branch; used by PATCH /tasks/:id when the Edit Task dialog changes a
+ * never-started task's phase. Returns the resolved id + label, or a
+ * structured error body for the route to emit with status 400.
+ */
+export function validatePhaseForProject(rawPhase, projectId, getProjectById) {
+    const project = projectId ? getProjectById?.(projectId) : undefined;
+    if (!project) {
+        return {
+            error: {
+                error: "phase_requires_project",
+                detail: "Phase cannot be validated without a real project — " +
+                    "unassigned tasks have no actions catalog.",
+            },
+        };
+    }
+    const loaded = loadActionsForProject(project.path || "");
+    const match = loaded.actions.phases.find((p) => p.id === rawPhase);
+    if (!match) {
+        return {
+            error: {
+                error: "invalid_phase",
+                detail: `Phase '${rawPhase}' is not in this project's actions catalog.`,
+                allowed: loaded.actions.phases.map((p) => p.id),
+            },
+        };
+    }
+    return { phase: match.id, phaseLabel: match.label };
+}
+export function resolvePhaseTaskCreateFields(body) {
+    const out = {};
+    const phaseTaskId = body.phaseTaskId;
+    const runId = body.runId;
+    const sessionUuid = body.sessionUuid;
+    const parentRunMaster = body.parentRunMaster;
+    if (phaseTaskId === undefined &&
+        runId === undefined &&
+        sessionUuid === undefined &&
+        parentRunMaster === undefined) {
+        return out;
+    }
+    if (phaseTaskId !== undefined) {
+        if (typeof phaseTaskId !== "string" || !PHASE_TASK_ID_PATTERN.test(phaseTaskId)) {
+            return {
+                error: {
+                    error: "invalid_phase_task_id",
+                    detail: "phaseTaskId must match /^ptk-[0-9a-f]{4,}$/",
+                },
+                status: 400,
+            };
+        }
+        out.phaseTaskId = phaseTaskId;
+    }
+    if (runId !== undefined) {
+        if (typeof runId !== "string" || !RUN_ID_PATTERN.test(runId)) {
+            return {
+                error: {
+                    error: "invalid_run_id",
+                    detail: "runId must match /^run-[0-9a-f]{8}$/",
+                },
+                status: 400,
+            };
+        }
+        out.runId = runId;
+    }
+    if (sessionUuid !== undefined) {
+        if (typeof sessionUuid !== "string" ||
+            !SESSION_UUID_PATTERN.test(sessionUuid)) {
+            return {
+                error: {
+                    error: "invalid_session_uuid",
+                    detail: "sessionUuid must be a valid uuid",
+                },
+                status: 400,
+            };
+        }
+        out.sessionUuid = sessionUuid;
+    }
+    if (parentRunMaster !== undefined) {
+        if (typeof parentRunMaster !== "boolean") {
+            return {
+                error: {
+                    error: "invalid_parent_run_master",
+                    detail: "parentRunMaster must be boolean",
+                },
+                status: 400,
+            };
+        }
+        out.parentRunMaster = parentRunMaster;
+    }
+    return out;
+}
+//# sourceMappingURL=_phase-helpers.js.map

package/server/dist/external/tasks/_phase-helpers.js.map

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

package/server/dist/external/tasks/create.d.ts

@@ -0,0 +1,12 @@
+import type { Hono } from "hono";
+import { SdkSessionsStore } from "../../core/sdk-sessions-store.js";
+import type { ExternalRouteProjectView } from "../_shared/helpers.js";
+export declare function registerTasksCreate(app: Hono, deps: {
+    store: SdkSessionsStore;
+    ptyManager: {
+        get(taskId: string): unknown;
+    };
+    getKnownProjectIds?: () => Set<string>;
+    getProjectById?: (id: string) => ExternalRouteProjectView | undefined;
+}): void;
+//# sourceMappingURL=create.d.ts.map

package/server/dist/external/tasks/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/external/tasks/create.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAGpE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAUtE,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,IAAI,EACT,IAAI,EAAE;IACJ,KAAK,EAAE,gBAAgB,CAAC;IACxB,UAAU,EAAE;QAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IAC7C,kBAAkB,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC;IACvC,cAAc,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,wBAAwB,GAAG,SAAS,CAAC;CACvE,GACA,IAAI,CAmJN"}

package/server/dist/external/tasks/create.js

@@ -0,0 +1,139 @@
+/*
+ * external/tasks/create.ts — POST /api/external/tasks.
+ *
+ * iterate-20260423-chat-livetest-2 AC-B + iterate-2026-05-14 lead-foundation
+ * + iterate-2026-05-18-edit-task-dialog + multi-session-run-orchestrator-v2
+ * — see inline comments for the contract for each optional field.
+ */
+import { loadActionsForProject } from "../../core/project-actions-loader.js";
+import { normalizeFsPath } from "../../core/normalize-fs-path.js";
+import { normalizeDescription, normalizeTitle, readLeadCreateFields, validateProjectIdOrError, withLiveSession, } from "../_shared/helpers.js";
+import { resolvePhaseTaskCreateFields } from "./_phase-helpers.js";
+export function registerTasksCreate(app, deps) {
+    const { store, ptyManager, getKnownProjectIds, getProjectById } = deps;
+    app.post("/api/external/tasks", async (c) => {
+        const body = await c.req.json().catch(() => ({}));
+        // D22/F27 — a PROVIDED (non-blank) title is validated with the same rule
+        // PATCH applies (shared normalizeTitle: reject embedded newlines /
+        // over-length) so an automated writer can't persist a title that later
+        // 500s every Launch/Resume. An absent / whitespace-only title keeps the
+        // "Untitled task" default affordance.
+        let title = "Untitled task";
+        if (typeof body.title === "string" && body.title.trim()) {
+            const r = normalizeTitle(body.title);
+            if (!r.ok)
+                return c.json({ error: r.error }, 400);
+            title = r.value;
+        }
+        // normalizeFsPath strips a paste-artifact surrounding quote pair (a
+        // space-containing path copied from a shell context) before it reaches
+        // core/launcher.ts, which would otherwise shell-escape the literal quotes
+        // into a broken `cd ''\''…'\'''` prefix. Empty / quotes-only → process.cwd().
+        const rawCwd = typeof body.cwd === "string" ? normalizeFsPath(body.cwd) : "";
+        const cwd = rawCwd || process.cwd();
+        const pluginDirs = Array.isArray(body.pluginDirs)
+            ? body.pluginDirs.filter((p) => typeof p === "string")
+            : [];
+        // Section 02 (iterate 3) — allow callers to pass an explicit projectId
+        // at creation. Defaults to UNASSIGNED_PROJECT_ID via the store. Invalid
+        // ids are rejected symmetrically with PATCH so the TaskBoard inline
+        // form can't leak a stale project id from a deleted project.
+        let projectId;
+        if (typeof body.projectId === "string" && body.projectId.trim()) {
+            const candidate = body.projectId.trim();
+            const validation = validateProjectIdOrError(candidate, getKnownProjectIds);
+            if (validation)
+                return c.json(validation, 400);
+            projectId = candidate;
+        }
+        // 2026-04-23 — Phase persisted on CREATION when the project's actions
+        // catalog validates the id. Server derives phaseLabel from the
+        // catalog entry — client-sent label is intentionally dropped to avoid
+        // label drift when the UI caches stale actions.json.
+        //
+        // Reject (not silently drop) when phase is supplied without a
+        // resolvable project — the client has no way to discover which phases
+        // are valid without a catalog, so sending phase there is a bug.
+        let phase;
+        let phaseLabel;
+        const rawPhase = typeof body.phase === "string" && body.phase.trim()
+            ? body.phase.trim()
+            : undefined;
+        if (rawPhase) {
+            if (!projectId) {
+                return c.json({
+                    error: "phase_requires_project",
+                    detail: "Phase cannot be validated without a projectId — " +
+                        "unassigned tasks have no actions catalog.",
+                }, 400);
+            }
+            const project = getProjectById?.(projectId);
+            if (!project) {
+                return c.json({
+                    error: "phase_requires_project",
+                    detail: `Phase cannot be validated — project '${projectId}' has no resolvable catalog.`,
+                }, 400);
+            }
+            const loaded = loadActionsForProject(project.path || "");
+            const match = loaded.actions.phases.find((p) => p.id === rawPhase);
+            if (!match) {
+                return c.json({
+                    error: "invalid_phase",
+                    detail: `Phase '${rawPhase}' is not in this project's actions catalog.`,
+                    allowed: loaded.actions.phases.map((p) => p.id),
+                }, 400);
+            }
+            phase = match.id;
+            phaseLabel = match.label;
+        }
+        // iterate/multi-session-run-orchestrator-v2 — Phase-task linkage
+        // (review O #5/#6 + plan A4/A6.5). When the body carries phase-task
+        // metadata, validate the shapes here and reuse an existing
+        // non-terminal shadow if one already maps to the same phaseTaskId
+        // (idempotency for repeat Continue Pipeline clicks).
+        const phaseTaskRefs = resolvePhaseTaskCreateFields(body);
+        if ("error" in phaseTaskRefs) {
+            return c.json(phaseTaskRefs.error, phaseTaskRefs.status);
+        }
+        if (phaseTaskRefs.phaseTaskId) {
+            const existing = store.findByPhaseTaskId(phaseTaskRefs.phaseTaskId);
+            if (existing) {
+                return c.json({ task: withLiveSession(existing, ptyManager), reused: true });
+            }
+        }
+        // 2026-05-05 — Save-to-Backlog wiring. Persist the chosen action id at
+        // create-time so a later TaskCard "Launch" click can recover the right
+        // command_template. Catalog membership is not validated here — the
+        // /launch handler already rejects unknown ids (`unknown_action_id` 400).
+        const createActionId = typeof body.actionId === "string" && body.actionId.trim().length > 0
+            ? body.actionId.trim()
+            : undefined;
+        // iterate-2026-05-14 lead-foundation-task-schema, widened 2026-08-16 —
+        // six user-creatable routing fields land here with soft-drop semantics.
+        const leadFields = readLeadCreateFields(body);
+        // iterate-2026-05-18-edit-task-dialog — persist the description on
+        // create so "Save to Backlog" no longer drops it.
+        const descResult = normalizeDescription(body.description);
+        if (!descResult.ok) {
+            return c.json({ error: "invalid_description", detail: descResult.error }, 400);
+        }
+        const task = store.create({
+            title,
+            cwd,
+            pluginDirs,
+            projectId,
+            phase,
+            phaseLabel,
+            actionId: createActionId,
+            description: descResult.value,
+            sessionUuid: phaseTaskRefs.sessionUuid,
+            phaseTaskId: phaseTaskRefs.phaseTaskId,
+            runId: phaseTaskRefs.runId,
+            parentRunMaster: phaseTaskRefs.parentRunMaster,
+            ...leadFields,
+        });
+        await store.persist();
+        return c.json({ task: withLiveSession(task, ptyManager) });
+    });
+}
+//# sourceMappingURL=create.js.map

package/server/dist/external/tasks/create.js.map

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

package/server/dist/external/tasks/lifecycle.d.ts

@@ -0,0 +1,12 @@
+import type { Hono } from "hono";
+import { SdkSessionsStore } from "../../core/sdk-sessions-store.js";
+export declare function registerTasksLifecycle(app: Hono, deps: {
+    store: SdkSessionsStore;
+    ptyManager: {
+        get(taskId: string): unknown;
+        kill?(taskId: string): void | Promise<void>;
+    };
+    scrollbackClearBestEffort?: (taskId: string) => Promise<void>;
+    snapshotClearBestEffort?: (taskId: string) => Promise<void>;
+}): void;
+//# sourceMappingURL=lifecycle.d.ts.map

package/server/dist/external/tasks/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../../src/external/tasks/lifecycle.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAGjC,OAAO,EACL,gBAAgB,EAEjB,MAAM,kCAAkC,CAAC;AAI1C,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,IAAI,EACT,IAAI,EAAE;IACJ,KAAK,EAAE,gBAAgB,CAAC;IACxB,UAAU,EAAE;QACV,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAG7B,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAC7C,CAAC;IACF,yBAAyB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,uBAAuB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7D,GACA,IAAI,CAoNN"}