@svenroth-ai/shipwright 0.24.1-next.0

package/server/dist/core/project-actions-loader.d.ts

@@ -0,0 +1,103 @@
+import type { ParamSchema } from "../types/action-schema.js";
+export interface ActionDefinition {
+    id: string;
+    label: string;
+    kind: "external_launch";
+    description?: string;
+    command_template: string;
+    /**
+     * iterate-2026-06-11-custom-action-slash-command — declared slash command
+     * for a CUSTOM action (any id outside new-task / new-iterate / new-pipeline)
+     * whose `command_template` uses `{task.initial_prompt}`. Lets the
+     * substituter fuse the slash command + description into ONE shell-quoted
+     * positional (the Claude CLI accepts only one `[prompt]` arg, so a separate
+     * `{task.description?}` token is silently dropped). Must match
+     * `SLASH_COMMAND_PATTERN` (validated at load time). Ignored for builtin ids.
+     */
+    slash_command?: string;
+    modal_fields?: string[];
+    /**
+     * Phase-independent CLI parameters (used by new-pipeline / new-iterate).
+     * Mutually independent from `phase_parameters` — actions normally use
+     * one or the other.
+     */
+    parameters?: ParamSchema[];
+    /**
+     * Phase-bound CLI parameters keyed by phase id (used by new-task).
+     * Schema lookup at launch time is `phase_parameters[selectedPhase]`.
+     * Keys must exist in `phases[].id`.
+     */
+    phase_parameters?: Record<string, ParamSchema[]>;
+}
+export interface PhaseDefinition {
+    id: string;
+    label: string;
+    color?: string;
+    /**
+     * iterate/v030-five-ux-fixes (P3) — when true, the New Task modal renders
+     * the AutonomyToggle for this phase. False / undefined hides the toggle
+     * because `--autonomous` has no semantic effect for that phase's slash
+     * command (e.g. /shipwright-changelog, /shipwright-deploy). Pipeline +
+     * Iterate modi ignore this flag and always render the toggle.
+     */
+    supports_autonomy?: boolean;
+}
+export interface PreviewSpec {
+    /** `"auto"` (default — follow profile.stack.frontend), `true`, or `false`. */
+    enabled: boolean | "auto";
+}
+export interface ResolvedActions {
+    schemaVersion: number;
+    defaults: {
+        autonomy: "guided" | "autonomous";
+    };
+    actions: ActionDefinition[];
+    phases: PhaseDefinition[];
+    preview: PreviewSpec;
+}
+export interface LoaderDiagnostic {
+    code: string;
+    path?: string;
+    detail?: string;
+}
+export interface LoadResult {
+    /** The resolved config (bundled default on miss / malformed). */
+    actions: ResolvedActions;
+    /** True when `.shipwright-webui/actions.json` was used; false when bundled default. */
+    fromUser: boolean;
+    diagnostics: LoaderDiagnostic[];
+}
+export interface LoaderDeps {
+    readFileSync?: (path: string, encoding: "utf-8" | "utf8") => string;
+    statSync?: (path: string) => {
+        mtimeMs: number;
+    };
+}
+/**
+ * Load (and cache) the bundled default. Runs once per process. A
+ * malformed bundled default is a startup-time failure — the whole
+ * server aborts because that's a build-level bug, not user input.
+ *
+ * Uses node's real `fs.readFileSync` regardless of the injected
+ * per-project deps — the bundled default is an installation asset, not
+ * something that belongs in a unit test's in-memory filesystem.
+ */
+export declare function loadBundledDefault(): ResolvedActions;
+/** Test helper — drops the bundled default + per-project cache. */
+export declare function clearActionsCache(): void;
+/**
+ * Targeted invalidation for a single project. Used by the upload + reset
+ * routes after they mutate `.shipwright-webui/actions.json`. Keeps the bundled-
+ * default singleton intact so other projects do not pay a re-parse cost
+ * on their next GET (review feedback: avoid global thundering-herd).
+ */
+export declare function clearActionsCacheForProject(projectPath: string): void;
+/**
+ * Load actions for a given project path. Returns the bundled default
+ * when the user file is missing / malformed; diagnostics carry any
+ * non-fatal warnings (route layer surfaces them as a chip).
+ */
+export declare function loadActionsForProject(projectPath: string, deps?: LoaderDeps): LoadResult;
+/** Non-test diagnostic accessor — lets index.ts report bundled-load age. */
+export declare function bundledDefaultLoadedAtMs(): number;
+//# sourceMappingURL=project-actions-loader.d.ts.map

package/server/dist/core/project-actions-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-actions-loader.d.ts","sourceRoot":"","sources":["../../src/core/project-actions-loader.ts"],"names":[],"mappings":"AAiCA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAE7D,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,iBAAiB,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB;;;;OAIG;IACH,UAAU,CAAC,EAAE,WAAW,EAAE,CAAC;IAC3B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;CAClD;AAED,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;OAMG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,WAAW,WAAW;IAC1B,8EAA8E;IAC9E,OAAO,EAAE,OAAO,GAAG,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE;QACR,QAAQ,EAAE,QAAQ,GAAG,YAAY,CAAC;KACnC,CAAC;IACF,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,OAAO,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,iEAAiE;IACjE,OAAO,EAAE,eAAe,CAAC;IACzB,uFAAuF;IACvF,QAAQ,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,gBAAgB,EAAE,CAAC;CACjC;AAED,MAAM,WAAW,UAAU;IACzB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,MAAM,KAAK,MAAM,CAAC;IACpE,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAClD;AAwBD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,IAAI,eAAe,CAOpD;AAED,mEAAmE;AACnE,wBAAgB,iBAAiB,IAAI,IAAI,CAIxC;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAErE;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE,UAAe,GACpB,UAAU,CAiFZ;AAED,4EAA4E;AAC5E,wBAAgB,wBAAwB,IAAI,MAAM,CAEjD"}

package/server/dist/core/project-actions-loader.js

@@ -0,0 +1,161 @@
+/*
+ * Project-scoped actions.json loader with bundled-default fallback.
+ *
+ * Iterate 3 section 03 — plan.md § 2.1 + ADR-036/039.
+ *
+ * Precedence (verbatim from the spec):
+ *   1. `<project.path>/.shipwright-webui/actions.json` if present and parseable.
+ *   2. Otherwise the bundled `webui/server/src/config/default-actions.json`.
+ *
+ * A malformed user-side file does NOT break the server — the loader
+ * falls through to the bundled default and emits a non-blocking
+ * diagnostic in the returned `diagnostics` array (external review O24).
+ * The route handler surfaces it to the client; the user sees a chip but
+ * the Task Board stays usable.
+ *
+ * Caching follows `profile-loader.ts` — keyed by projectPath, invalidated
+ * on actions.json mtime change. Eliminates per-request JSON re-parse for
+ * happy-path projects.
+ *
+ * This module does NOT validate the placeholder allowlist or the schema
+ * itself. That is the route layer's job (via
+ * `actions-substitute.validateTemplate` + `validateActionsSchema`), so
+ * the loader stays pure I/O.
+ */
+import { readFileSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { fileURLToPath } from "node:url";
+import { dirname, resolve } from "node:path";
+import { checkContractVersion, ACTIONS_SCHEMA_VERSION, } from "./contract-version.js";
+const cache = new Map();
+/**
+ * Resolve the bundled default path: `webui/server/src/config/default-actions.json`.
+ * core → src → ../config/default-actions.json.
+ */
+function defaultPath() {
+    const __filename = fileURLToPath(import.meta.url);
+    const __dirname = dirname(__filename);
+    return resolve(__dirname, "..", "config", "default-actions.json");
+}
+let bundledDefault = null;
+let bundledDefaultLoadedAt = 0;
+/**
+ * Load (and cache) the bundled default. Runs once per process. A
+ * malformed bundled default is a startup-time failure — the whole
+ * server aborts because that's a build-level bug, not user input.
+ *
+ * Uses node's real `fs.readFileSync` regardless of the injected
+ * per-project deps — the bundled default is an installation asset, not
+ * something that belongs in a unit test's in-memory filesystem.
+ */
+export function loadBundledDefault() {
+    if (bundledDefault)
+        return bundledDefault;
+    const raw = readFileSync(defaultPath(), "utf-8");
+    const parsed = JSON.parse(raw);
+    bundledDefault = parsed;
+    bundledDefaultLoadedAt = Date.now();
+    return parsed;
+}
+/** Test helper — drops the bundled default + per-project cache. */
+export function clearActionsCache() {
+    cache.clear();
+    bundledDefault = null;
+    bundledDefaultLoadedAt = 0;
+}
+/**
+ * Targeted invalidation for a single project. Used by the upload + reset
+ * routes after they mutate `.shipwright-webui/actions.json`. Keeps the bundled-
+ * default singleton intact so other projects do not pay a re-parse cost
+ * on their next GET (review feedback: avoid global thundering-herd).
+ */
+export function clearActionsCacheForProject(projectPath) {
+    cache.delete(projectPath);
+}
+/**
+ * Load actions for a given project path. Returns the bundled default
+ * when the user file is missing / malformed; diagnostics carry any
+ * non-fatal warnings (route layer surfaces them as a chip).
+ */
+export function loadActionsForProject(projectPath, deps = {}) {
+    const read = deps.readFileSync ?? readFileSync;
+    const stat = deps.statSync ?? statSync;
+    const userPath = join(projectPath, ".shipwright-webui", "actions.json");
+    // mtime-based cache. mtimeMs = null = cached "no user file" branch.
+    let mtimeMs = null;
+    try {
+        mtimeMs = stat(userPath).mtimeMs;
+    }
+    catch {
+        mtimeMs = null;
+    }
+    const cached = cache.get(projectPath);
+    if (cached && cached.mtimeMs === mtimeMs) {
+        return {
+            actions: cached.data,
+            fromUser: cached.fromUser,
+            diagnostics: cached.diagnostics,
+        };
+    }
+    if (mtimeMs === null) {
+        // No user file — bundled default.
+        const bundled = loadBundledDefault();
+        const entry = {
+            data: bundled,
+            mtimeMs: null,
+            fromUser: false,
+            diagnostics: [],
+        };
+        cache.set(projectPath, entry);
+        return { actions: bundled, fromUser: false, diagnostics: [] };
+    }
+    // User file present — try to parse.
+    try {
+        const raw = read(userPath, "utf-8");
+        const parsed = JSON.parse(raw);
+        checkContractVersion({
+            artefact: ".shipwright-webui/actions.json",
+            path: userPath,
+            declared: parsed.schemaVersion,
+            knownMax: ACTIONS_SCHEMA_VERSION,
+            fieldName: "schemaVersion",
+        });
+        const entry = {
+            data: parsed,
+            mtimeMs,
+            fromUser: true,
+            diagnostics: [],
+        };
+        cache.set(projectPath, entry);
+        return { actions: parsed, fromUser: true, diagnostics: [] };
+    }
+    catch (err) {
+        const diag = {
+            code: "actions_file_malformed",
+            path: userPath,
+            detail: String(err).slice(0, 200),
+        };
+        const bundled = loadBundledDefault();
+        const entry = {
+            data: bundled,
+            mtimeMs,
+            fromUser: false,
+            diagnostics: [diag],
+        };
+        cache.set(projectPath, entry);
+        // Warn once on the server side so an operator sees it in logs too.
+        // Using plain console.warn to match project-manager style.
+        console.warn(JSON.stringify({
+            level: "warn",
+            message: "actions.json malformed; falling back to bundled default",
+            projectPath,
+            path: userPath,
+        }));
+        return { actions: bundled, fromUser: false, diagnostics: [diag] };
+    }
+}
+/** Non-test diagnostic accessor — lets index.ts report bundled-load age. */
+export function bundledDefaultLoadedAtMs() {
+    return bundledDefaultLoadedAt;
+}
+//# sourceMappingURL=project-actions-loader.js.map

package/server/dist/core/project-actions-loader.js.map

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

package/server/dist/core/project-manager.d.ts

@@ -0,0 +1,110 @@
+import type { Project } from "../types/project.js";
+import { type ProfileConfig } from "./profile-loader.js";
+/**
+ * Section 02 (iterate 3) — reserved projectId for the synthesized
+ * "Unassigned" pseudo-project bucket (ADR-037). Kept in sync with
+ * client/src/lib/projectIds.ts and server/src/core/sdk-sessions-store.ts
+ * (intentional duplication per conventions.md — the client, the store,
+ * and the project-manager don't import each other's copies).
+ */
+export declare const UNASSIGNED_PROJECT_ID = "unassigned";
+export interface ProjectManagerDeps {
+    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;
+    readdirSync: (path: string, opts?: {
+        withFileTypes: boolean;
+    }) => Array<{
+        name: string;
+        isDirectory: () => boolean;
+    }>;
+    lock?: (path: string) => Promise<() => Promise<void>>;
+    ensureFile?: (path: string) => void;
+    rename?: (from: string, to: string) => Promise<void>;
+    statSync?: (path: string) => {
+        mtimeMs: number;
+    };
+    readFileSync?: (path: string, encoding: "utf-8" | "utf8") => string;
+    loadProfile?: (profileName: string) => ProfileConfig | null;
+    /**
+     * Section 02 (iterate 3) — ADR-037. When provided, getAll() appends a
+     * synthesized "Unassigned" pseudo-project iff this set contains
+     * UNASSIGNED_PROJECT_ID OR any id not present in the persisted
+     * projects map. Wired in index.ts to
+     *   () => new Set(sessionsStore.list().map(t => t.projectId))
+     * so "is there an orphan bucket?" is computed fresh on every call.
+     * Omitted in unit tests that don't care about the synthesized row.
+     */
+    getTaskProjectIds?: () => Set<string>;
+}
+export declare class ProjectManager {
+    private registryPath;
+    private deps;
+    private projects;
+    private previewCapCache;
+    constructor(registryPath: string, deps: ProjectManagerDeps);
+    load(): Promise<void>;
+    create(data: Omit<Project, "id" | "createdAt" | "lastActive">): Project;
+    /**
+     * Iterate 14.0 — projects are serialized with a derived `mode` field
+     * read from shipwright_run_config.json on each call. Kept here (not in
+     * route handlers) so every consumer — REST, SSE broadcasts, etc. —
+     * sees consistent mode values without each one re-deriving.
+     *
+     * Iterate 14.1 — also injects `hasPreview` derived from the profile's
+     * dev_server.command entry. Same pattern as mode: server-derived so
+     * clients never re-derive it.
+     */
+    private withMode;
+    /**
+     * 2026-04-23 — true iff `<projectPath>/shipwright_run_config.json`
+     * exists. Drives the WebUI's visibility gate for the one-shot `adopt`
+     * phase (NewIssueModal filters that option when adopted=true). Cheap
+     * `existsSync` probe; no file read, no cache needed.
+     */
+    isAdopted(projectPath: string): boolean;
+    /**
+     * Iterate 14.1 — true when the project's profile (as written into
+     * shipwright_run_config.json by shipwright-run) declares a dev_server.
+     *
+     * Chain:
+     *   projectPath → shipwright_run_config.json.profile →
+     *   shared/profiles/{profile}.json.dev_server.command exists?
+     *
+     * Any missing link → false (no preview button). The cache key is
+     * projectPath, invalidated on run_config mtime change. profile-loader
+     * has its own separate mtime cache so the profile JSON is only re-read
+     * when the profile file itself changes.
+     *
+     * Public for direct use by the preview-route authorization check.
+     */
+    hasPreviewCapability(projectPath: string): boolean;
+    getAll(): Project[];
+    private buildSynthesizedUnassigned;
+    getById(id: string): Project | undefined;
+    update(id: string, patch: Partial<Project>): Project;
+    /**
+     * Iterate 10 — write the per-project autonomy setting into BOTH
+     * projects.json (in-memory + webui registry) AND the project's own
+     * `shipwright_run_config.json` so the Shipwright plugin chain
+     * (shipwright-project, shipwright-build, etc.) actually reads the
+     * same value. Prior to this, autonomy set via the webui Settings page
+     * was a silent placebo because the plugins load run_config.json
+     * directly, not projects.json.
+     *
+     * The run_config write merges with existing content so we don't
+     * clobber other fields. A missing file is created fresh with just
+     * the autonomy field. Write failures are logged but non-fatal —
+     * the in-memory update always succeeds so the UI stays responsive.
+     */
+    updateAutonomy(id: string, autonomy: "guided" | "autonomous"): Promise<Project>;
+    delete(id: string): void;
+    touchLastActive(id: string): void;
+    discover(directory: string): Project[];
+    private persist;
+    private persistLocked;
+}
+//# sourceMappingURL=project-manager.d.ts.map

package/server/dist/core/project-manager.d.ts.map

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