@svenroth-ai/shipwright 0.24.1-next.0

package/server/dist/types/project.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Mirror of `client/src/types/project.ts` — keep in sync.
+ *
+ * Server's wire-shape view of Project. Server-derived fields (`mode`,
+ * `hasPreview`, `adopted`, `synthesized`) ARE produced server-side
+ * and forwarded to the client; the duplication is therefore a clean
+ * boundary, not redundancy.
+ *
+ * Drift between the two copies surfaces at the JSON boundary. The
+ * `no-cross-package-imports.test.ts` drift-guard prevents
+ * re-introduction of cross-package imports.
+ *
+ * See ADR-080 + `.shipwright/planning/iterate/2026-05-09-tsc-baseline-fix.md`.
+ */
+import type { KanbanStatus } from "./task.js";
+import type { AutonomyOption } from "./settings.js";
+export type ProjectStatus = "active" | "archived" | "error";
+/**
+ * Iterate 14.0 — derived on the server from shipwright_run_config.json
+ * by getProjectMode(). Drives WebUI affordances:
+ *   pipeline   → default SDLC flow (phase dropdown visible, standard header)
+ *   iterate    → pipeline finished, further work is iteration (no phase dropdown)
+ *   standalone → no run_config present (ad-hoc project, info message shown)
+ */
+export type ProjectMode = "pipeline" | "iterate" | "standalone";
+export interface ProjectSettings {
+    phaseToStatusMapping?: Record<string, KanbanStatus>;
+    claudePluginDirs?: string[];
+    autonomy?: AutonomyOption;
+    envVars?: Record<string, string>;
+    /** Iterate 14.8.2 — custom project color for the Kanban strip. */
+    color?: string;
+}
+export interface Project {
+    id: string;
+    name: string;
+    path: string;
+    profile: string;
+    status: ProjectStatus;
+    lastActive: string;
+    settings?: ProjectSettings;
+    createdAt: string;
+    /**
+     * Server-derived from shipwright_run_config.json via getProjectMode().
+     * Present in API responses; not stored in projects.json.
+     */
+    mode?: ProjectMode;
+    /**
+     * Iterate 14.1 — server-derived flag, true when the project's profile
+     * declares a `dev_server.command`. Drives the Preview button in the
+     * KanbanPage header. Present in API responses; not stored in projects.json.
+     */
+    hasPreview?: boolean;
+    /**
+     * 2026-04-23 — server-derived, true iff `<path>/shipwright_run_config.json`
+     * exists. Drives visibility of the one-shot `adopt` phase in NewIssueModal:
+     * once a project is adopted, the Adopt option disappears because
+     * `/shipwright-adopt` refuses to run a second time. Synthesized and
+     * adopt-less projects come back as `false`. Present in API responses;
+     * not stored in projects.json.
+     */
+    adopted?: boolean;
+    /**
+     * Iterate 3 section 02 — true for the synthesized "Unassigned" pseudo-
+     * project (id = "unassigned"). ProjectManager.getAll() appends this row
+     * on the fly when any task references a non-real project. Never
+     * persisted to projects.json. Client renders muted + suppresses edit /
+     * delete affordances. ADR-037.
+     */
+    synthesized?: boolean;
+}
+//# sourceMappingURL=project.d.ts.map

package/server/dist/types/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../src/types/project.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEpD,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;AAE5D;;;;;;GAMG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,SAAS,GAAG,YAAY,CAAC;AAEhE,MAAM,WAAW,eAAe;IAC9B,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IACpD,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,cAAc,CAAC;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,kEAAkE;IAClE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;;;OAOG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB"}

package/server/dist/types/project.js

@@ -0,0 +1,16 @@
+/**
+ * Mirror of `client/src/types/project.ts` — keep in sync.
+ *
+ * Server's wire-shape view of Project. Server-derived fields (`mode`,
+ * `hasPreview`, `adopted`, `synthesized`) ARE produced server-side
+ * and forwarded to the client; the duplication is therefore a clean
+ * boundary, not redundancy.
+ *
+ * Drift between the two copies surfaces at the JSON boundary. The
+ * `no-cross-package-imports.test.ts` drift-guard prevents
+ * re-introduction of cross-package imports.
+ *
+ * See ADR-080 + `.shipwright/planning/iterate/2026-05-09-tsc-baseline-fix.md`.
+ */
+export {};
+//# sourceMappingURL=project.js.map

package/server/dist/types/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../src/types/project.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG"}

package/server/dist/types/run-config-v2.d.ts

@@ -0,0 +1,172 @@
+export type RunPhase = "project" | "design" | "plan" | "build" | "test" | "security" | "changelog" | "deploy";
+export declare const RUN_PHASES: readonly RunPhase[];
+export type SplitMode = "none" | "per_split" | null;
+export type RunStatus = "in_progress" | "complete" | "failed" | "needs_validation";
+/**
+ * Pipeline execution mode (schema field `run_config.mode`).
+ *
+ *  - `single_session` — the /shipwright-run master drives every phase via a
+ *    phase-runner subagent in ONE conversation; the sole supported FRESH-write
+ *    mode (SS8, 2026-07-08). Runs on every surface.
+ *  - `multi_session`  — each phase is its own external UUID-bound Claude
+ *    session (pre-SS1 behaviour). DEPRECATED, retained for back-compat.
+ *
+ * OPTIONAL on disk (NOT in the schema's `required`): a mode-less legacy config
+ * reads as `DEFAULT_RUN_MODE`. Mirrors shared/schemas/run_config.v2.schema.json.
+ */
+export type RunMode = "multi_session" | "single_session";
+export declare const RUN_MODES: readonly RunMode[];
+/**
+ * Absent-read fallback for `mode`. MUST equal the schema `default` and the
+ * framework's `config_io.run_mode` absent-read so a consumer applying schema
+ * defaults never silently reinterprets a mode-less legacy run.
+ */
+export declare const DEFAULT_RUN_MODE: RunMode;
+export type PhaseTaskStatus = "backlog" | "awaiting_launch" | "in_progress" | "done" | "failed" | "skipped";
+export declare const TERMINAL_PHASE_TASK_STATUSES: readonly PhaseTaskStatus[];
+export interface RunConditions {
+    securityEnabled: boolean;
+    splitMode: SplitMode;
+    aikidoClientIdPresent: boolean;
+}
+export interface PhaseTaskResult {
+    ok?: boolean;
+    artifacts?: string[];
+    [extra: string]: unknown;
+}
+export interface PhaseTask {
+    phaseTaskId: string;
+    phase: RunPhase;
+    splitId: string | null;
+    sessionUuid: string;
+    version: number;
+    status: PhaseTaskStatus;
+    title: string;
+    description?: string;
+    slashCommand: string;
+    launchCommandHint?: string;
+    prerequisites: string[];
+    claimedBySessionUuid?: string | null;
+    claimAttemptedAt?: string | null;
+    executionCount: number;
+    createdAt: string;
+    awaitingLaunchAt?: string | null;
+    startedAt?: string | null;
+    completedAt?: string | null;
+    result?: PhaseTaskResult | null;
+    errors?: string[];
+}
+export interface RunConfigV2 {
+    schemaVersion: 2;
+    runId: string;
+    scope: "full_app" | "extension";
+    profile?: string | null;
+    autonomy: "guided" | "autonomous";
+    /** OPTIONAL; absent → DEFAULT_RUN_MODE via resolveRunMode(). See RunMode. */
+    mode?: RunMode;
+    deploy_target: string;
+    pipeline: RunPhase[];
+    runConditions: RunConditions;
+    splits_frozen: string[];
+    status: RunStatus;
+    completed_phase_task_ids: string[];
+    phase_tasks: PhaseTask[];
+    phase_history?: Record<string, unknown>;
+    iterate_history?: unknown[];
+    created_at: string;
+    updated_at?: string;
+    validation_issues?: unknown[];
+    validation_notes?: unknown[];
+    last_compliance_update?: Record<string, unknown>;
+    [extra: string]: unknown;
+}
+export declare const RUN_ID_PATTERN: RegExp;
+export declare const PHASE_TASK_ID_PATTERN: RegExp;
+export declare const SLASH_COMMAND_PATTERN: RegExp;
+export declare const SESSION_UUID_PATTERN: RegExp;
+/**
+ * Constrained character class for `splitId` when used in shell-interpolated
+ * positions (specifically the `--name` argument). The underlying value on
+ * disk can be any string per the schema, but we refuse to interpolate
+ * anything outside this class to keep shell escaping bullet-proof on all
+ * three target shells (PS / cmd / POSIX). Plan A7.
+ */
+export declare const SPLIT_ID_SAFE_PATTERN: RegExp;
+/**
+ * `Run-{shortRunId}` label. `shortRunId` is the 4-char hex slice after the
+ * "run-" prefix. Falls back to the full runId when the shape ever drifts
+ * (review O #15) so the label stays informative rather than truncated.
+ */
+export declare function formatRunLabel(runId: string): string;
+/**
+ * Build the `--name` value for a phase-task launch:
+ *   "Run-{shortRunId} / {phase}[ / {splitId}]"
+ *
+ * `splitId` is validated against SPLIT_ID_SAFE_PATTERN; if it fails we throw
+ * rather than emit a name that might break shell escaping. Phase is enum-
+ * bounded by the type system already.
+ */
+export declare function buildPhaseTaskName(args: {
+    runId: string;
+    phase: RunPhase;
+    splitId: string | null;
+}): string;
+/**
+ * `readyToLaunchTasks[]` derivation: every phase_task whose status is
+ * `awaiting_launch` AND every prerequisite is in
+ * `completed_phase_task_ids[]`. Order = array order. Pure function — used
+ * by the reader to produce a UX hint, NOT used for state mutation
+ * decisions (the framework's state machine is the authority).
+ */
+export declare function deriveReadyToLaunchTasks(config: RunConfigV2): PhaseTask[];
+export declare function isTerminalPhaseTaskStatus(s: PhaseTaskStatus): boolean;
+export declare function isRunMode(v: unknown): v is RunMode;
+/**
+ * Resolve a run's execution mode. Absent OR unrecognised → DEFAULT_RUN_MODE
+ * ("multi_session") — matching the schema note that "an unrecognised value is
+ * also read as multi_session so a typo can't select an unbuilt path". Stays
+ * defensive even though the reader already drops unrecognised values.
+ */
+export declare function resolveRunMode(config: {
+    mode?: RunMode;
+}): RunMode;
+/**
+ * Parse the raw `mode` value off a run-config for the reader. Valid → the mode;
+ * absent/null → `{}` (no warning; consumers default via resolveRunMode); an
+ * UNRECOGNISED value → a warning and NO mode (the reader NEVER rejects the
+ * config over `mode`, so a typo can't select an unbuilt path). Lives next to
+ * the RunMode type instead of growing the at-ceiling run-config-reader.
+ */
+export declare function parseRunMode(raw: unknown): {
+    mode?: RunMode;
+    warnings: string[];
+};
+/**
+ * Standard run-config torn-read backoff schedule (ms). The orchestrator writes
+ * the config atomically (rename); on Windows the brief rename window can throw
+ * EBUSY/EPERM/EACCES or yield a partial JSON parse. The reader retries on this
+ * schedule before falling back to its last-good cache.
+ */
+export declare const RUN_CONFIG_RETRY_DELAYS_MS: readonly number[];
+/**
+ * A torn read is retryable when it is a SyntaxError (partial JSON caught mid
+ * write) OR an EBUSY/EPERM/EACCES fs error (Windows rename window). ENOENT is
+ * deliberately NOT retryable — a truly-absent file is a stable state.
+ */
+export declare function isRetryableTornRead(err: unknown): boolean;
+export type RetryOutcome<T> = {
+    ok: true;
+    value: T;
+} | {
+    ok: false;
+    error: unknown;
+};
+/**
+ * Retry an async fs op on retryable torn-read errors using the standard
+ * backoff. Resolves `{ ok:true, value }` on success, or `{ ok:false, error }`
+ * once the budget is exhausted or a non-retryable error is hit. Lives next to
+ * the RunConfig types (not inline in the reader) because run-config-reader.ts
+ * is at its bloat ceiling — same rationale as parseRunMode. F15.
+ */
+export declare function retryTornRead<T>(op: () => Promise<T>, wait: (ms: number) => Promise<void>, delays?: readonly number[]): Promise<RetryOutcome<T>>;
+//# sourceMappingURL=run-config-v2.d.ts.map

package/server/dist/types/run-config-v2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-config-v2.d.ts","sourceRoot":"","sources":["../../src/types/run-config-v2.ts"],"names":[],"mappings":"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"}

package/server/dist/types/run-config-v2.js

@@ -0,0 +1,169 @@
+/*
+ * Hand-rolled mirror of the framework's `run_config.v2.schema.json`.
+ *
+ * Source (authoritative): shared/schemas/run_config.v2.schema.json
+ * in the sister `shipwright` repo (merged 2026-04-25 as commit 7d402d3).
+ *
+ * Why hand-rolled instead of codegen:
+ *   - keeps webui's dependency surface minimal (no JSON-Schema validator)
+ *   - matches the per-row fault-isolation pattern used by sdk-sessions-store
+ *
+ * Drift safety net: server/src/test/fixtures/run-config-v2-sample.json holds
+ * a real orchestrator-produced sample. The reader-test asserts every required
+ * field is recognized — when the framework grows the schema, that test fails
+ * and forces a deliberate update on this side.
+ *
+ * ADR ref: agent_docs/decision_log.md ADR-001 (multi-session lifecycle).
+ */
+export const RUN_PHASES = [
+    "project",
+    "design",
+    "plan",
+    "build",
+    "test",
+    "security",
+    "changelog",
+    "deploy",
+];
+export const RUN_MODES = [
+    "multi_session",
+    "single_session",
+];
+/**
+ * Absent-read fallback for `mode`. MUST equal the schema `default` and the
+ * framework's `config_io.run_mode` absent-read so a consumer applying schema
+ * defaults never silently reinterprets a mode-less legacy run.
+ */
+export const DEFAULT_RUN_MODE = "multi_session";
+export const TERMINAL_PHASE_TASK_STATUSES = [
+    "done",
+    "failed",
+    "skipped",
+];
+// ---------- format helpers (used by route + UI) ----------
+export const RUN_ID_PATTERN = /^run-[0-9a-f]{8}$/;
+export const PHASE_TASK_ID_PATTERN = /^ptk-[0-9a-f]{4,}$/;
+export const SLASH_COMMAND_PATTERN = /^\/shipwright-(project|design|plan|build|test|security|changelog|deploy)$/;
+export const SESSION_UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+/**
+ * Constrained character class for `splitId` when used in shell-interpolated
+ * positions (specifically the `--name` argument). The underlying value on
+ * disk can be any string per the schema, but we refuse to interpolate
+ * anything outside this class to keep shell escaping bullet-proof on all
+ * three target shells (PS / cmd / POSIX). Plan A7.
+ */
+export const SPLIT_ID_SAFE_PATTERN = /^[A-Za-z0-9._-]{1,64}$/;
+/**
+ * `Run-{shortRunId}` label. `shortRunId` is the 4-char hex slice after the
+ * "run-" prefix. Falls back to the full runId when the shape ever drifts
+ * (review O #15) so the label stays informative rather than truncated.
+ */
+export function formatRunLabel(runId) {
+    if (!RUN_ID_PATTERN.test(runId))
+        return runId;
+    return `Run-${runId.slice(4, 8)}`;
+}
+/**
+ * Build the `--name` value for a phase-task launch:
+ *   "Run-{shortRunId} / {phase}[ / {splitId}]"
+ *
+ * `splitId` is validated against SPLIT_ID_SAFE_PATTERN; if it fails we throw
+ * rather than emit a name that might break shell escaping. Phase is enum-
+ * bounded by the type system already.
+ */
+export function buildPhaseTaskName(args) {
+    const label = formatRunLabel(args.runId);
+    if (args.splitId === null || args.splitId === undefined) {
+        return `${label} / ${args.phase}`;
+    }
+    if (!SPLIT_ID_SAFE_PATTERN.test(args.splitId)) {
+        throw new Error(`splitId ${JSON.stringify(args.splitId)} contains characters outside [A-Za-z0-9._-]`);
+    }
+    return `${label} / ${args.phase} / ${args.splitId}`;
+}
+/**
+ * `readyToLaunchTasks[]` derivation: every phase_task whose status is
+ * `awaiting_launch` AND every prerequisite is in
+ * `completed_phase_task_ids[]`. Order = array order. Pure function — used
+ * by the reader to produce a UX hint, NOT used for state mutation
+ * decisions (the framework's state machine is the authority).
+ */
+export function deriveReadyToLaunchTasks(config) {
+    const completed = new Set(config.completed_phase_task_ids);
+    return config.phase_tasks.filter((t) => t.status === "awaiting_launch" &&
+        t.prerequisites.every((p) => completed.has(p)));
+}
+export function isTerminalPhaseTaskStatus(s) {
+    return TERMINAL_PHASE_TASK_STATUSES.includes(s);
+}
+export function isRunMode(v) {
+    return v === "multi_session" || v === "single_session";
+}
+/**
+ * Resolve a run's execution mode. Absent OR unrecognised → DEFAULT_RUN_MODE
+ * ("multi_session") — matching the schema note that "an unrecognised value is
+ * also read as multi_session so a typo can't select an unbuilt path". Stays
+ * defensive even though the reader already drops unrecognised values.
+ */
+export function resolveRunMode(config) {
+    return isRunMode(config.mode) ? config.mode : DEFAULT_RUN_MODE;
+}
+/**
+ * Parse the raw `mode` value off a run-config for the reader. Valid → the mode;
+ * absent/null → `{}` (no warning; consumers default via resolveRunMode); an
+ * UNRECOGNISED value → a warning and NO mode (the reader NEVER rejects the
+ * config over `mode`, so a typo can't select an unbuilt path). Lives next to
+ * the RunMode type instead of growing the at-ceiling run-config-reader.
+ */
+export function parseRunMode(raw) {
+    if (isRunMode(raw))
+        return { mode: raw, warnings: [] };
+    if (raw === undefined || raw === null)
+        return { warnings: [] };
+    return {
+        warnings: [`mode ${JSON.stringify(raw)} not recognized; treating as ${DEFAULT_RUN_MODE}`],
+    };
+}
+// ---------- torn-read retry (server-side; used by run-config-reader) ----------
+/**
+ * Standard run-config torn-read backoff schedule (ms). The orchestrator writes
+ * the config atomically (rename); on Windows the brief rename window can throw
+ * EBUSY/EPERM/EACCES or yield a partial JSON parse. The reader retries on this
+ * schedule before falling back to its last-good cache.
+ */
+export const RUN_CONFIG_RETRY_DELAYS_MS = [50, 150, 450];
+const RETRYABLE_FS_CODES = new Set(["EBUSY", "EPERM", "EACCES"]);
+/**
+ * A torn read is retryable when it is a SyntaxError (partial JSON caught mid
+ * write) OR an EBUSY/EPERM/EACCES fs error (Windows rename window). ENOENT is
+ * deliberately NOT retryable — a truly-absent file is a stable state.
+ */
+export function isRetryableTornRead(err) {
+    if (err instanceof SyntaxError)
+        return true;
+    const code = err?.code;
+    return Boolean(code && RETRYABLE_FS_CODES.has(code));
+}
+/**
+ * Retry an async fs op on retryable torn-read errors using the standard
+ * backoff. Resolves `{ ok:true, value }` on success, or `{ ok:false, error }`
+ * once the budget is exhausted or a non-retryable error is hit. Lives next to
+ * the RunConfig types (not inline in the reader) because run-config-reader.ts
+ * is at its bloat ceiling — same rationale as parseRunMode. F15.
+ */
+export async function retryTornRead(op, wait, delays = RUN_CONFIG_RETRY_DELAYS_MS) {
+    let lastError = null;
+    for (let attempt = 0; attempt <= delays.length; attempt++) {
+        try {
+            return { ok: true, value: await op() };
+        }
+        catch (err) {
+            lastError = err;
+            if (!isRetryableTornRead(err) || attempt === delays.length)
+                break;
+            await wait(delays[attempt] ?? 0);
+        }
+    }
+    return { ok: false, error: lastError };
+}
+//# sourceMappingURL=run-config-v2.js.map

package/server/dist/types/run-config-v2.js.map

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

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

@@ -0,0 +1,25 @@
+/**
+ * Mirror of `client/src/types/settings.ts` — keep in sync.
+ *
+ * Server's wire-shape view of GlobalSettings. Drift between the two
+ * copies surfaces at the JSON boundary. The
+ * `no-cross-package-imports.test.ts` drift-guard prevents
+ * re-introduction of cross-package imports.
+ *
+ * See ADR-080 + `.shipwright/planning/iterate/2026-05-09-tsc-baseline-fix.md`.
+ */
+export type AutonomyOption = "guided" | "autonomous";
+export interface GlobalSettings {
+    port: number;
+    maxConcurrent: number;
+    heartbeatIntervalMs: number;
+    claudeCliPath?: string;
+    defaultProfile?: string;
+    defaultAutonomy?: AutonomyOption;
+    phaseToStatusMapping?: Record<string, string>;
+    /** Iterate 14.8.2 — concrete model id used as the default for new tasks. */
+    defaultModel?: string;
+    /** Iterate 14.8.2 — permission mode used as the default for new tasks. */
+    defaultMode?: string;
+}
+//# sourceMappingURL=settings.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings.d.ts","sourceRoot":"","sources":["../../src/types/settings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,YAAY,CAAC;AAErD,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,eAAe,CAAC,EAAE,cAAc,CAAC;IACjC,oBAAoB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9C,4EAA4E;IAC5E,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0EAA0E;IAC1E,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB"}

package/server/dist/types/settings.js

@@ -0,0 +1,12 @@
+/**
+ * Mirror of `client/src/types/settings.ts` — keep in sync.
+ *
+ * Server's wire-shape view of GlobalSettings. Drift between the two
+ * copies surfaces at the JSON boundary. The
+ * `no-cross-package-imports.test.ts` drift-guard prevents
+ * re-introduction of cross-package imports.
+ *
+ * See ADR-080 + `.shipwright/planning/iterate/2026-05-09-tsc-baseline-fix.md`.
+ */
+export {};
+//# sourceMappingURL=settings.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"settings.js","sourceRoot":"","sources":["../../src/types/settings.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG"}

package/server/dist/types/task.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Mirror of `client/src/types/task.ts` — keep in sync.
+ *
+ * Server's wire-shape view of Task. Drift between the two copies
+ * surfaces at the JSON boundary (consumer-side compile or runtime
+ * contract failure). The `no-cross-package-imports.test.ts`
+ * drift-guard prevents re-introduction of `from "../../../client/..."`
+ * imports.
+ *
+ * See ADR-080 + `.shipwright/planning/iterate/2026-05-09-tsc-baseline-fix.md`.
+ */
+export type KanbanStatus = "backlog" | "in_progress" | "in_review" | "done" | "failed" | "cancelled"
+/**
+ * @deprecated Iterate 14.9 — no longer returned by deriveKanbanStatus.
+ * Interrupted tasks keep their phase's natural column (e.g. test →
+ * in_review) and TaskCard derives the pause/Resume affordance from
+ * task.status + task.orphanReason directly. Kept in the union for
+ * type-level back-compat with buckets and phase-mapping configs.
+ */
+ | "interrupted";
+export type TaskStatus = "pending" | "running" | "waiting" | "done" | "failed" | "orphaned" | "interrupted" | "cancelled";
+export type PhaseToStatusMapping = Record<string, KanbanStatus>;
+export interface Task {
+    id: string;
+    projectId: string;
+    title: string;
+    description: string;
+    intent?: string;
+    priority?: string;
+    complexity?: string;
+    status: TaskStatus;
+    kanbanStatus: KanbanStatus;
+    currentPhase?: string;
+    requestedPhase?: string;
+    sessionId: string;
+    /**
+     * Real Claude Code CLI `session_id` captured from the `system/init`
+     * NDJSON event on first spawn. Persisted via `session_captured` events
+     * so that 14.7.0's "interrupted" path can `--resume <claudeSessionId>`
+     * after a server restart. Undefined until Claude emits `system/init`.
+     */
+    claudeSessionId?: string;
+    /**
+     * Last `task_orphaned.detail` observed. `stale_on_startup` means the
+     * server was restarted while the task was running (resumable if a
+     * claudeSessionId is also present). `process_dead` means the CLI
+     * exited abnormally mid-turn (not resumable).
+     */
+    orphanReason?: string;
+    pid?: number;
+    exitCode?: number;
+    createdAt: string;
+    updatedAt: string;
+}
+//# sourceMappingURL=task.d.ts.map

package/server/dist/types/task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.d.ts","sourceRoot":"","sources":["../../src/types/task.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,aAAa,GACb,WAAW,GACX,MAAM,GACN,QAAQ,GACR,WAAW;AACb;;;;;;GAMG;GACD,aAAa,CAAC;AAElB,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,SAAS,GACT,SAAS,GACT,MAAM,GACN,QAAQ,GACR,UAAU,GACV,aAAa,GACb,WAAW,CAAC;AAEhB,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAEhE,MAAM,WAAW,IAAI;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,UAAU,CAAC;IACnB,YAAY,EAAE,YAAY,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/server/dist/types/task.js

@@ -0,0 +1,13 @@
+/**
+ * Mirror of `client/src/types/task.ts` — keep in sync.
+ *
+ * Server's wire-shape view of Task. Drift between the two copies
+ * surfaces at the JSON boundary (consumer-side compile or runtime
+ * contract failure). The `no-cross-package-imports.test.ts`
+ * drift-guard prevents re-introduction of `from "../../../client/..."`
+ * imports.
+ *
+ * See ADR-080 + `.shipwright/planning/iterate/2026-05-09-tsc-baseline-fix.md`.
+ */
+export {};
+//# sourceMappingURL=task.js.map

package/server/dist/types/task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task.js","sourceRoot":"","sources":["../../src/types/task.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG"}