@svenroth-ai/shipwright 0.24.1-next.0

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

@@ -0,0 +1,231 @@
+/*
+ * external/tasks/lifecycle.ts — POST /tasks/:id/fork, /close, /backlog +
+ * DELETE /tasks/:id.
+ *
+ * fork — clone a task with a parent linkage + emit fresh launch commands.
+ * close — `state → done` (terminal).
+ * backlog — `state → draft` (FR-01.32, move back to Backlog column).
+ * delete — drop the task + cascade-clear scrollback + snapshot.
+ *
+ * ADR-068-A1 + ADR-087 — DELETE cascade-clears scrollback files +
+ * snapshot files. Best-effort; the task delete is the authoritative
+ * privacy boundary.
+ *
+ * CLAUDE.md rule 6 — backlog's `store.persist` returns 409 on ELOCKED
+ * (proper-lockfile contention).
+ */
+import { buildCopyCommands } from "../../core/launcher.js";
+import { isBacklogSourceState, } from "../../core/sdk-sessions-store.js";
+import { normalizeTitle, withLiveSession } from "../_shared/helpers.js";
+import { isBoardColumn } from "../../core/board-column.js";
+export function registerTasksLifecycle(app, deps) {
+    const { store, ptyManager, scrollbackClearBestEffort, snapshotClearBestEffort, } = deps;
+    app.post("/api/external/tasks/:id/fork", async (c) => {
+        const parent = store.get(c.req.param("id"));
+        if (!parent)
+            return c.json({ error: "Parent task not found" }, 404);
+        const body = await c.req.json().catch(() => ({}));
+        // D22/F27 — validate a PROVIDED (non-blank) fork title with the same rule
+        // PATCH applies BEFORE creating the child, so an invalid title (embedded
+        // newlines / over-length) is rejected up-front instead of leaving an
+        // orphan child row behind (the pre-fix normalizeTitle throw in
+        // buildCopyCommands 500'd AFTER store.create). An absent / blank title
+        // keeps the "<parent> — fork" default.
+        let title = `${parent.title} — fork`;
+        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;
+        }
+        const child = store.create({
+            title,
+            cwd: parent.cwd,
+            pluginDirs: parent.pluginDirs,
+            parentTaskId: parent.taskId,
+            parentSessionUuid: parent.sessionUuid,
+            // Section 02 — forks inherit the parent's projectId.
+            projectId: parent.projectId,
+        });
+        const commands = buildCopyCommands({
+            sessionUuid: child.sessionUuid,
+            cwd: child.cwd,
+            fork: true,
+            parentSessionUuid: parent.sessionUuid,
+            pluginDirs: child.pluginDirs,
+            title: child.title,
+        });
+        store.patch(child.taskId, {
+            state: "awaiting_external_start",
+            launchedAt: new Date().toISOString(),
+        });
+        await store.persist();
+        return c.json({
+            task: withLiveSession(store.get(child.taskId), ptyManager),
+            commands,
+        });
+    });
+    app.post("/api/external/tasks/:id/close", async (c) => {
+        const task = store.get(c.req.param("id"));
+        if (!task)
+            return c.json({ error: "Task not found" }, 404);
+        // iterate-2026-06-17 — sync boardColumn so a prior manual drag can't
+        // strand the closed card outside Done (AC-6).
+        const updated = store.patch(task.taskId, { state: "done", boardColumn: "done" });
+        await store.persist();
+        return c.json({ task: withLiveSession(updated, ptyManager) });
+    });
+    // iterate-2026-05-17-move-to-backlog (FR-01.32) — move an In-Progress
+    // task back to the Backlog column (`state → draft`). A pure registry-
+    // state flip, sibling of /close: the JSONL and shipwright_run_config.json
+    // are NOT touched. Every history field is preserved; only `state` changes.
+    app.post("/api/external/tasks/:id/backlog", async (c) => {
+        const task = store.get(c.req.param("id"));
+        if (!task)
+            return c.json({ error: "Task not found" }, 404);
+        // Already in the Backlog → idempotent no-op.
+        if (task.state === "draft") {
+            return c.json({ task: withLiveSession(task, ptyManager) });
+        }
+        // Explicit allowlist of the five In-Progress states.
+        if (!isBacklogSourceState(task.state)) {
+            return c.json({ error: "backlog_invalid_state", state: task.state }, 409);
+        }
+        const updated = store.patch(task.taskId, { state: "draft", boardColumn: "backlog" });
+        try {
+            await store.persist();
+        }
+        catch (err) {
+            if (err?.code === "ELOCKED") {
+                return c.json({ error: "sdk-sessions.json is locked, retry" }, 409);
+            }
+            throw err;
+        }
+        return c.json({ task: withLiveSession(updated, ptyManager) });
+    });
+    // iterate-2026-05-31-reopen-done-task — counterpart of /backlog for the
+    // terminal `done` state. Re-opens a done task (`state → draft`). `done` is
+    // the only legal source: In-Progress states use /backlog, and the flip
+    // preserves every history field — sessionUuid + firstJsonlObservedAt
+    // survive, so the card renders Resume (continue the completed session), not
+    // a fresh Launch. Same pure registry-state flip as /backlog: JSONL +
+    // shipwright_run_config.json are NOT touched.
+    //
+    // board-drag-done-reopen — an optional `column` lands the reopened card in
+    // the dropped column (a Done card dragged / menu-moved OUT of Done) instead
+    // of always Backlog, so the move doesn't strand it "done" + locked. Omitted
+    // → Backlog (the ⋯-menu "Reopen" action's historical home). This route IS
+    // allowed to set state (it's a lifecycle command); rule 23 only forbids
+    // /column from doing so.
+    app.post("/api/external/tasks/:id/reopen", async (c) => {
+        const task = store.get(c.req.param("id"));
+        if (!task)
+            return c.json({ error: "Task not found" }, 404);
+        const body = (await c.req.json().catch(() => ({})));
+        let column = "backlog";
+        if (body.column !== undefined) {
+            if (!isBoardColumn(body.column)) {
+                return c.json({ error: "invalid_column", column: body.column ?? null }, 400);
+            }
+            column = body.column;
+        }
+        // Already in the Backlog (draft) → idempotent. Still honor an explicit
+        // target column (a multi-tab reopen race) rather than dropping the move.
+        if (task.state === "draft") {
+            if (body.column === undefined || task.boardColumn === column) {
+                return c.json({ task: withLiveSession(task, ptyManager) });
+            }
+            const moved = store.patch(task.taskId, { boardColumn: column });
+            try {
+                await store.persist();
+            }
+            catch (err) {
+                if (err?.code === "ELOCKED") {
+                    return c.json({ error: "sdk-sessions.json is locked, retry" }, 409);
+                }
+                throw err;
+            }
+            return c.json({ task: withLiveSession(moved, ptyManager) });
+        }
+        if (task.state !== "done") {
+            return c.json({ error: "reopen_invalid_state", state: task.state }, 409);
+        }
+        const updated = store.patch(task.taskId, { state: "draft", boardColumn: column });
+        try {
+            await store.persist();
+        }
+        catch (err) {
+            if (err?.code === "ELOCKED") {
+                return c.json({ error: "sdk-sessions.json is locked, retry" }, 409);
+            }
+            throw err;
+        }
+        return c.json({ task: withLiveSession(updated, ptyManager) });
+    });
+    // iterate-2026-06-17-board-dnd-status-decouple — set the sticky,
+    // user-owned board-column override ONLY. `state`, JSONL, and run-config
+    // are NEVER touched: the board column is decoupled from session liveness,
+    // so a live task can be parked in any column and still offer Resume. This
+    // is the canonical command path for drag-and-drop; the menu lifecycle
+    // routes above sync boardColumn inline so a prior drag can't strand a card.
+    app.post("/api/external/tasks/:id/column", async (c) => {
+        const task = store.get(c.req.param("id"));
+        if (!task)
+            return c.json({ error: "Task not found" }, 404);
+        const body = (await c.req.json().catch(() => ({})));
+        if (!isBoardColumn(body.column)) {
+            return c.json({ error: "invalid_column", column: body.column ?? null }, 400);
+        }
+        const updated = store.patch(task.taskId, { boardColumn: body.column });
+        try {
+            await store.persist();
+        }
+        catch (err) {
+            if (err?.code === "ELOCKED") {
+                return c.json({ error: "sdk-sessions.json is locked, retry" }, 409);
+            }
+            throw err;
+        }
+        return c.json({ task: withLiveSession(updated, ptyManager) });
+    });
+    app.delete("/api/external/tasks/:id", async (c) => {
+        const taskId = c.req.param("id");
+        const deleted = store.delete(taskId);
+        if (!deleted)
+            return c.json({ error: "Task not found" }, 404);
+        await store.persist();
+        // D01/F01 — tear down the live embedded pty FIRST. `kill` is awaited so
+        // the teardown's shell-stopped marker (.log) + finalize snapshot writes
+        // LAND before the clears below wipe them; the pty is then dead, so
+        // nothing re-creates the secret-bearing artifacts after the privacy wipe.
+        if (ptyManager.kill) {
+            try {
+                await ptyManager.kill(taskId);
+            }
+            catch {
+                /* best-effort — never block the delete on pty teardown */
+            }
+        }
+        // ADR-068-A1: cascade-clean scrollback files. Best-effort.
+        if (scrollbackClearBestEffort) {
+            try {
+                await scrollbackClearBestEffort(taskId);
+            }
+            catch {
+                /* best-effort */
+            }
+        }
+        // ADR-087 MEDIUM-B1: cascade-clean snapshot file. Best-effort —
+        // task delete is the authoritative privacy boundary.
+        if (snapshotClearBestEffort) {
+            try {
+                await snapshotClearBestEffort(taskId);
+            }
+            catch {
+                /* best-effort */
+            }
+        }
+        return c.json({ ok: true });
+    });
+}
+//# sourceMappingURL=lifecycle.js.map

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

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

package/server/dist/external/tasks/list-get.d.ts

@@ -0,0 +1,11 @@
+import type { Hono } from "hono";
+import { SessionWatcher } from "../../core/session-watcher.js";
+import { SdkSessionsStore } from "../../core/sdk-sessions-store.js";
+export declare function registerTasksListGet(app: Hono, deps: {
+    store: SdkSessionsStore;
+    watcher: SessionWatcher;
+    ptyManager: {
+        get(taskId: string): unknown;
+    };
+}): void;
+//# sourceMappingURL=list-get.d.ts.map

package/server/dist/external/tasks/list-get.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-get.d.ts","sourceRoot":"","sources":["../../../src/external/tasks/list-get.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAEjC,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AAMpE,wBAAgB,oBAAoB,CAClC,GAAG,EAAE,IAAI,EACT,IAAI,EAAE;IACJ,KAAK,EAAE,gBAAgB,CAAC;IACxB,OAAO,EAAE,cAAc,CAAC;IACxB,UAAU,EAAE;QAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;CAC9C,GACA,IAAI,CA2CN"}

package/server/dist/external/tasks/list-get.js

@@ -0,0 +1,50 @@
+/*
+ * external/tasks/list-get.ts — GET /api/external/tasks +
+ * GET /api/external/tasks/:id.
+ *
+ * Both endpoints augment serialized tasks with:
+ *   - `liveSession` (Iterate G ADR-095) — derived from
+ *     `ptyManager.get(taskId) !== undefined`.
+ *   - `lastJsonlSeenMtimeMs` (ADR-102) — a LIVE JSONL mtime overlaid on
+ *     the persisted store row so the header Resume-CTA gate is not fed a
+ *     stale value between transcript polls.
+ */
+import { withLiveJsonlMtime, withLiveSession, } from "../_shared/helpers.js";
+export function registerTasksListGet(app, deps) {
+    const { store, watcher, ptyManager } = deps;
+    app.get("/api/external/tasks", async (c) => {
+        // Section 02 — optional ?projectId=<id> filter. Unvalidated on read
+        // (unknown id → empty list, not 400) because an orphaned URL from a
+        // deleted project is a benign state, not a user error.
+        const filter = c.req.query("projectId");
+        // iterate-2026-08-16-v1-lead-fields-tag-filter — optional exact-match
+        // ?tag=<value> filter (leadwright triage-v1-v4a.md FR-04.09: a cheap
+        // lookup over the interface instead of scanning every session's JSONL).
+        // NOT an atomic/idempotent check-and-create (doubt-review finding,
+        // Stage 3): unlike findByPhaseTaskId()'s in-request check before
+        // store.create(), a GET-then-POST across two daemon requests has a
+        // TOCTOU race — duplicate-prevention across concurrent daemon writers
+        // is the CALLER's responsibility, not this filter's. c.req.query()
+        // takes only the FIRST value on a repeated param, matching ?projectId=.
+        // Applied BEFORE findManyByUuid so the per-session filesystem walk sees
+        // only the matched tasks.
+        const tagFilter = c.req.query("tag");
+        const all = store.list();
+        let filtered = filter ? all.filter((t) => t.projectId === filter) : all;
+        if (tagFilter)
+            filtered = filtered.filter((t) => t.tags?.includes(tagFilter));
+        const locs = await watcher.findManyByUuid(new Set(filtered.map((t) => t.sessionUuid.toLowerCase())));
+        const tasks = filtered.map((t) => withLiveJsonlMtime(withLiveSession(t, ptyManager), locs.get(t.sessionUuid.toLowerCase())?.mtimeMs));
+        return c.json({ tasks });
+    });
+    app.get("/api/external/tasks/:id", async (c) => {
+        const task = store.get(c.req.param("id"));
+        if (!task)
+            return c.json({ error: "Task not found" }, 404);
+        const loc = await watcher.findByUuid(task.sessionUuid);
+        return c.json({
+            task: withLiveJsonlMtime(withLiveSession(task, ptyManager), loc?.mtimeMs),
+        });
+    });
+}
+//# sourceMappingURL=list-get.js.map

package/server/dist/external/tasks/list-get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-get.js","sourceRoot":"","sources":["../../../src/external/tasks/list-get.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,EACL,kBAAkB,EAClB,eAAe,GAChB,MAAM,uBAAuB,CAAC;AAE/B,MAAM,UAAU,oBAAoB,CAClC,GAAS,EACT,IAIC;IAED,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;IAE5C,GAAG,CAAC,GAAG,CAAC,qBAAqB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QACzC,oEAAoE;QACpE,oEAAoE;QACpE,uDAAuD;QACvD,MAAM,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QACxC,sEAAsE;QACtE,qEAAqE;QACrE,wEAAwE;QACxE,mEAAmE;QACnE,iEAAiE;QACjE,mEAAmE;QACnE,sEAAsE;QACtE,mEAAmE;QACnE,wEAAwE;QACxE,wEAAwE;QACxE,0BAA0B;QAC1B,MAAM,SAAS,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACrC,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;QACzB,IAAI,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACxE,IAAI,SAAS;YAAE,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;QAC9E,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,cAAc,CACvC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC,CAC1D,CAAC;QACF,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC/B,kBAAkB,CAChB,eAAe,CAAC,CAAC,EAAE,UAAU,CAAC,EAC9B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,EAAE,OAAO,CAC/C,CACF,CAAC;QACF,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3B,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,GAAG,CAAC,yBAAyB,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI;YAAE,OAAO,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,gBAAgB,EAAE,EAAE,GAAG,CAAC,CAAC;QAC3D,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACvD,OAAO,CAAC,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,kBAAkB,CAAC,eAAe,CAAC,IAAI,EAAE,UAAU,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC;SAC1E,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}

package/server/dist/external/tasks/patch.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 registerTasksPatch(app: Hono, deps: {
+    store: SdkSessionsStore;
+    ptyManager: {
+        get(taskId: string): unknown;
+    };
+    getKnownProjectIds?: () => Set<string>;
+    getProjectById?: (id: string) => ExternalRouteProjectView | undefined;
+}): void;
+//# sourceMappingURL=patch.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"patch.d.ts","sourceRoot":"","sources":["../../../src/external/tasks/patch.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAGjC,OAAO,EACL,gBAAgB,EAEjB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAyBtE,wBAAgB,kBAAkB,CAChC,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,CAkMN"}

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

@@ -0,0 +1,192 @@
+/*
+ * external/tasks/patch.ts — PATCH /api/external/tasks/:id.
+ *
+ * Clear-vs-omit contract: a key PRESENT in the body is an update; an
+ * OMITTED key is untouched; `""` / `null` clears a scalar/enum; `[]`
+ * clears an array.
+ *
+ * Lifecycle gate (fail fast, before per-field validation): the five
+ * launch-shaping fields (description / phase / priority / complexityHint /
+ * autonomy) freeze once the task has started — see
+ * `core/task-editability.ts`. Unlike the other four, `autonomy` has no
+ * clear-to-empty state — it is always `guided` | `autonomous`.
+ *
+ * CLAUDE.md rule 6 — concurrent writers serialized by `proper-lockfile`;
+ * on lock contention → 409 `sdk-sessions.json is locked, retry`.
+ */
+import { isFieldEditable } from "../../core/task-editability.js";
+import { normalizeDescription, normalizePoFeedback, normalizeStringArray, normalizeTitle, validateProjectIdOrError, withLiveSession, } from "../_shared/helpers.js";
+import { validatePhaseForProject } from "./_phase-helpers.js";
+const PATCHABLE = [
+    "title",
+    "projectId",
+    "description",
+    "phase",
+    "priority",
+    "complexityHint",
+    "domain",
+    "tags",
+    "blockedBy",
+    "autonomy",
+    "poFeedback",
+];
+export function registerTasksPatch(app, deps) {
+    const { store, ptyManager, getKnownProjectIds, getProjectById } = deps;
+    app.patch("/api/external/tasks/:id", async (c) => {
+        const rawBody = await c.req.json().catch(() => ({}));
+        const body = rawBody && typeof rawBody === "object" && !Array.isArray(rawBody)
+            ? rawBody
+            : {};
+        const task = store.get(c.req.param("id"));
+        if (!task)
+            return c.json({ error: "Task not found" }, 404);
+        const present = PATCHABLE.filter((f) => f in body);
+        if (present.length === 0) {
+            return c.json({ error: "at_least_one_field_required" }, 400);
+        }
+        // Lifecycle gate.
+        const frozenViolations = present.filter((f) => !isFieldEditable(f, task));
+        if (frozenViolations.length > 0) {
+            return c.json({
+                error: "field_not_editable",
+                fields: frozenViolations,
+                detail: "These fields are frozen once the task has started: " +
+                    `${frozenViolations.join(", ")}.`,
+            }, 409);
+        }
+        const patch = {};
+        if ("title" in body) {
+            const r = normalizeTitle(body.title);
+            if (!r.ok)
+                return c.json({ error: r.error }, 400);
+            patch.title = r.value;
+        }
+        if ("projectId" in body) {
+            if (typeof body.projectId !== "string" || body.projectId.trim() === "") {
+                return c.json({ error: "projectId cannot be empty" }, 400);
+            }
+            const candidate = body.projectId.trim();
+            const validation = validateProjectIdOrError(candidate, getKnownProjectIds);
+            if (validation)
+                return c.json(validation, 400);
+            patch.projectId = candidate;
+        }
+        if ("description" in body) {
+            const r = normalizeDescription(body.description);
+            if (!r.ok) {
+                return c.json({ error: "invalid_description", detail: r.error }, 400);
+            }
+            patch.description = r.value;
+        }
+        if ("phase" in body) {
+            const raw = body.phase;
+            if (raw === "" || raw === null) {
+                patch.phase = undefined;
+                patch.phaseLabel = undefined;
+            }
+            else if (typeof raw === "string" && raw.trim()) {
+                const phaseResult = validatePhaseForProject(raw.trim(), patch.projectId ?? task.projectId, getProjectById);
+                if ("error" in phaseResult) {
+                    return c.json(phaseResult.error, 400);
+                }
+                patch.phase = phaseResult.phase;
+                patch.phaseLabel = phaseResult.phaseLabel;
+            }
+            else {
+                return c.json({ error: "invalid_phase", detail: "phase must be a string or empty" }, 400);
+            }
+        }
+        if ("priority" in body) {
+            const p = body.priority;
+            if (p === "" || p === null) {
+                patch.priority = undefined;
+            }
+            else if (p === "P0" || p === "P1" || p === "P2" || p === "P3") {
+                patch.priority = p;
+            }
+            else {
+                return c.json({
+                    error: "invalid_priority",
+                    detail: "priority must be P0–P3 or empty",
+                }, 400);
+            }
+        }
+        if ("complexityHint" in body) {
+            const ch = body.complexityHint;
+            if (ch === "" || ch === null) {
+                patch.complexityHint = undefined;
+            }
+            else if (ch === "small" || ch === "medium" || ch === "large") {
+                patch.complexityHint = ch;
+            }
+            else {
+                return c.json({
+                    error: "invalid_complexity_hint",
+                    detail: "complexityHint must be small | medium | large or empty",
+                }, 400);
+            }
+        }
+        if ("domain" in body) {
+            const d = body.domain;
+            if (d === "" || d === null) {
+                patch.domain = undefined;
+            }
+            else if (typeof d === "string") {
+                const trimmed = d.trim();
+                patch.domain = trimmed.length > 0 ? trimmed : undefined;
+            }
+            else {
+                return c.json({ error: "invalid_domain", detail: "domain must be a string" }, 400);
+            }
+        }
+        if ("tags" in body) {
+            if (!Array.isArray(body.tags)) {
+                return c.json({ error: "invalid_tags", detail: "tags must be an array of strings" }, 400);
+            }
+            patch.tags = normalizeStringArray(body.tags);
+        }
+        if ("blockedBy" in body) {
+            if (!Array.isArray(body.blockedBy)) {
+                return c.json({
+                    error: "invalid_blocked_by",
+                    detail: "blockedBy must be an array of strings",
+                }, 400);
+            }
+            // Dedup + drop empties + drop self-reference (external review #7).
+            patch.blockedBy = normalizeStringArray(body.blockedBy).filter((id) => id !== task.taskId);
+        }
+        if ("autonomy" in body) {
+            const a = body.autonomy;
+            if (a === "guided" || a === "autonomous") {
+                patch.autonomy = a;
+            }
+            else {
+                return c.json({
+                    error: "invalid_autonomy",
+                    detail: "autonomy must be guided or autonomous",
+                }, 400);
+            }
+        }
+        if ("poFeedback" in body) {
+            const r = normalizePoFeedback(body.poFeedback);
+            if (!r.ok) {
+                return c.json({ error: "invalid_po_feedback", detail: r.error }, 400);
+            }
+            patch.poFeedback = r.value;
+        }
+        store.patch(task.taskId, patch);
+        try {
+            await store.persist();
+        }
+        catch (err) {
+            if (err?.code === "ELOCKED") {
+                return c.json({ error: "sdk-sessions.json is locked, retry" }, 409);
+            }
+            throw err;
+        }
+        return c.json({
+            task: withLiveSession(store.get(task.taskId), ptyManager),
+        });
+    });
+}
+//# sourceMappingURL=patch.js.map

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

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

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

@@ -0,0 +1,18 @@
+import { Hono } from "hono";
+import { SessionWatcher } from "../../core/session-watcher.js";
+import { SdkSessionsStore } from "../../core/sdk-sessions-store.js";
+import type { ExternalRouteProjectView } from "../_shared/helpers.js";
+export interface TasksRouterDeps {
+    store: SdkSessionsStore;
+    watcher: SessionWatcher;
+    ptyManager: {
+        get(taskId: string): unknown;
+        kill?(taskId: string): void | Promise<void>;
+    };
+    getKnownProjectIds?: () => Set<string>;
+    getProjectById?: (id: string) => ExternalRouteProjectView | undefined;
+    scrollbackClearBestEffort?: (taskId: string) => Promise<void>;
+    snapshotClearBestEffort?: (taskId: string) => Promise<void>;
+}
+export declare function createTasksRouter(deps: TasksRouterDeps): Hono;
+//# sourceMappingURL=routes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../src/external/tasks/routes.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAOtE,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,gBAAgB,CAAC;IACxB,OAAO,EAAE,cAAc,CAAC;IAGxB,UAAU,EAAE;QACV,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;QAC7B,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;KAC7C,CAAC;IACF,kBAAkB,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,CAAC,CAAC;IACvC,cAAc,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,wBAAwB,GAAG,SAAS,CAAC;IACtE,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;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,eAAe,GAAG,IAAI,CA0B7D"}

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

@@ -0,0 +1,49 @@
+/*
+ * external/tasks/routes.ts — task lifecycle registration shell.
+ *
+ * Owns:
+ *   POST   /api/external/tasks                  (create.ts)
+ *   GET    /api/external/tasks                  (list-get.ts)
+ *   GET    /api/external/tasks/:id              (list-get.ts)
+ *   PATCH  /api/external/tasks/:id              (patch.ts)
+ *   POST   /api/external/tasks/:id/fork         (lifecycle.ts)
+ *   POST   /api/external/tasks/:id/close        (lifecycle.ts)
+ *   POST   /api/external/tasks/:id/backlog      (lifecycle.ts)
+ *   POST   /api/external/tasks/:id/reopen       (lifecycle.ts)
+ *   DELETE /api/external/tasks/:id              (lifecycle.ts)
+ *
+ * Per-endpoint handlers split into siblings to keep this shell ≤ 300 LOC.
+ */
+import { Hono } from "hono";
+import { registerTasksCreate } from "./create.js";
+import { registerTasksListGet } from "./list-get.js";
+import { registerTasksPatch } from "./patch.js";
+import { registerTasksLifecycle } from "./lifecycle.js";
+export function createTasksRouter(deps) {
+    const app = new Hono();
+    registerTasksCreate(app, {
+        store: deps.store,
+        ptyManager: deps.ptyManager,
+        getKnownProjectIds: deps.getKnownProjectIds,
+        getProjectById: deps.getProjectById,
+    });
+    registerTasksListGet(app, {
+        store: deps.store,
+        watcher: deps.watcher,
+        ptyManager: deps.ptyManager,
+    });
+    registerTasksPatch(app, {
+        store: deps.store,
+        ptyManager: deps.ptyManager,
+        getKnownProjectIds: deps.getKnownProjectIds,
+        getProjectById: deps.getProjectById,
+    });
+    registerTasksLifecycle(app, {
+        store: deps.store,
+        ptyManager: deps.ptyManager,
+        scrollbackClearBestEffort: deps.scrollbackClearBestEffort,
+        snapshotClearBestEffort: deps.snapshotClearBestEffort,
+    });
+    return app;
+}
+//# sourceMappingURL=routes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routes.js","sourceRoot":"","sources":["../../../src/external/tasks/routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAM5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AAiBxD,MAAM,UAAU,iBAAiB,CAAC,IAAqB;IACrD,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,mBAAmB,CAAC,GAAG,EAAE;QACvB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;QAC3C,cAAc,EAAE,IAAI,CAAC,cAAc;KACpC,CAAC,CAAC;IACH,oBAAoB,CAAC,GAAG,EAAE;QACxB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,CAAC,CAAC;IACH,kBAAkB,CAAC,GAAG,EAAE;QACtB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,kBAAkB,EAAE,IAAI,CAAC,kBAAkB;QAC3C,cAAc,EAAE,IAAI,CAAC,cAAc;KACpC,CAAC,CAAC;IACH,sBAAsB,CAAC,GAAG,EAAE;QAC1B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,yBAAyB,EAAE,IAAI,CAAC,yBAAyB;QACzD,uBAAuB,EAAE,IAAI,CAAC,uBAAuB;KACtD,CAAC,CAAC;IACH,OAAO,GAAG,CAAC;AACb,CAAC"}

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

@@ -0,0 +1,12 @@
+import { Hono } from "hono";
+import { SessionWatcher } from "../../core/session-watcher.js";
+import { SdkSessionsStore } from "../../core/sdk-sessions-store.js";
+export interface TranscriptRouterDeps {
+    store: SdkSessionsStore;
+    watcher: SessionWatcher;
+    ptyManager: {
+        get(taskId: string): unknown;
+    };
+}
+export declare function createTranscriptRouter(deps: TranscriptRouterDeps): Hono;
+//# sourceMappingURL=routes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../src/external/transcript/routes.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EACL,gBAAgB,EAGjB,MAAM,kCAAkC,CAAC;AAS1C,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,gBAAgB,CAAC;IACxB,OAAO,EAAE,cAAc,CAAC;IACxB,UAAU,EAAE;QAAE,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;CAC9C;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,oBAAoB,GAAG,IAAI,CA0JvE"}