@svenroth-ai/shipwright 0.28.0 → 0.29.0

package/server/dist/core/session-info/subagents.js

@@ -0,0 +1,92 @@
+/*
+ * Subagent list for a session: `<session>/subagents/agent-<id>.jsonl` plus its
+ * `.meta.json` (agentType, description, toolUseId, spawnDepth, parentAgentId
+ * for depth 2, model). Joined on agentId.
+ *
+ * "Finished" comes from the `<task-notification>` the PARENT received — for a
+ * depth-2 agent the parent is the depth-1 agent, so notifications are pooled
+ * across the session file AND every agent file. The notification's own
+ * `<result>` is often only a pointer ("delivered as a message"), so `answer`
+ * is the last assistant text of the agent's own file. An agent with no
+ * notification and a stale mtime is `finished-stale` (killed session, crash).
+ */
+import { readSmallRegularFile } from "./small-file.js";
+export const SUBAGENT_STALE_MS = 10 * 60 * 1000;
+/** An agent blocked inside an unanswered tool call (long test run, permission prompt) gets far longer. */
+export const SUBAGENT_PENDING_STALE_MS = 60 * 60 * 1000;
+const RESUME_SLACK_MS = 2000;
+const s = (v) => (typeof v === "string" && v ? v : null);
+async function readMeta(p) {
+    try {
+        // A symlinked meta file is never followed; meta files are tiny, refuse anything else.
+        const text = await readSmallRegularFile(p, 64 * 1024);
+        if (text === null)
+            return {};
+        const o = JSON.parse(text);
+        return o && typeof o === "object" ? o : {};
+    }
+    catch {
+        return {};
+    }
+}
+export async function buildSubagents(files, subFacts, parent, now) {
+    const notifs = new Map(parent.notifications);
+    const toolUses = new Map(parent.agentToolUses);
+    // Deterministic precedence: the sorted file order, never scan-completion order.
+    const ordered = files.map((f) => subFacts.get(f.agentId)).filter((x) => !!x);
+    for (const f of ordered) {
+        for (const [k, v] of f.notifications)
+            notifs.set(k, v);
+        for (const [k, v] of f.agentToolUses)
+            toolUses.set(k, v);
+    }
+    const results = new Map(parent.toolResults);
+    for (const f of ordered)
+        for (const [k, v] of f.toolResults)
+            results.set(k, v);
+    const metas = await Promise.all(files.map((f) => readMeta(f.metaPath)));
+    const out = [];
+    for (const [idx, file] of files.entries()) {
+        const meta = metas[idx];
+        const facts = subFacts.get(file.agentId);
+        const n = notifs.get(file.agentId) ?? null;
+        const toolUseId = s(meta.toolUseId) ?? n?.toolUseId ?? null;
+        const tu = toolUseId ? toolUses.get(toolUseId) : undefined;
+        const startedAt = facts?.firstTs ?? null;
+        const lastTs = facts?.lastTs ?? null;
+        const tr = toolUseId && !tu?.background ? results.get(toolUseId) : undefined;
+        const doneAt = Date.parse(n?.at ?? tr?.at ?? "");
+        // A resumed agent keeps writing after its earlier notification: it is running again,
+        // but only while its file is still being written. A quiet resumed agent has the same
+        // staleness budget as any other (otherwise a finished agent that wrote once after its
+        // notification would show as running forever).
+        const staleMs = facts && facts.pendingUse.size > 0 ? SUBAGENT_PENDING_STALE_MS : SUBAGENT_STALE_MS;
+        const quiet = now - file.mtimeMs > staleMs;
+        const resumedAfterNotice = !!(n || tr) && !!lastTs && Number.isFinite(doneAt) && Date.parse(lastTs) > doneAt + RESUME_SLACK_MS;
+        const resumed = resumedAfterNotice && !quiet;
+        const state = resumed ? "running" : resumedAfterNotice ? "finished-stale" : n || tr ? "finished" : quiet ? "finished-stale" : "running";
+        const status = resumed ? null : n?.status ?? (tr ? (tr.isError ? "failed" : (tr.status ?? "completed")) : null);
+        const wall = startedAt && lastTs && Date.parse(lastTs) >= Date.parse(startedAt) ? Date.parse(lastTs) - Date.parse(startedAt) : null;
+        out.push({
+            agentId: file.agentId,
+            agentType: s(meta.agentType),
+            description: s(meta.description) ?? tu?.description ?? null,
+            toolUseId,
+            spawnDepth: typeof meta.spawnDepth === "number" ? meta.spawnDepth : null,
+            parentAgentId: s(meta.parentAgentId),
+            model: s(meta.model) ?? facts?.model ?? null,
+            prompt: tu?.prompt ?? null,
+            answer: facts?.lastAssistantText ?? null,
+            startedAt,
+            endedAt: state === "running" ? null : lastTs,
+            durationMs: state === "running" ? null : (n?.durationMs ?? tr?.durationMs ?? wall),
+            state,
+            status,
+            tokens: resumed ? null : (n?.tokens ?? tr?.tokens ?? null),
+            toolUses: resumed ? null : (n?.toolUses ?? tr?.toolUses ?? null),
+        });
+    }
+    out.sort((a, b) => (a.startedAt ?? "").localeCompare(b.startedAt ?? ""));
+    return out;
+}
+//# sourceMappingURL=subagents.js.map

package/server/dist/core/session-info/subagents.js.map

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

package/server/dist/core/session-info/test-fixtures.d.ts

@@ -0,0 +1,50 @@
+export declare const SESSION = "11111111-2222-4333-8444-555555555555";
+export declare const WIN_CWD = "C:\\proj\\repo";
+export declare const ts: (n: number) => string;
+export declare const jl: (...objs: unknown[]) => string;
+export declare const assistant: (n: number, opts?: {
+    usage?: [number, number, number];
+    model?: string;
+    blocks?: unknown[];
+    cwd?: string;
+    sidechain?: boolean;
+}) => {
+    type: string;
+    isSidechain: boolean;
+    timestamp: string;
+    cwd: string;
+    message: {
+        role: string;
+        model: string;
+        usage: {
+            input_tokens: number;
+            cache_read_input_tokens: number;
+            cache_creation_input_tokens: number;
+            output_tokens: number;
+        } | undefined;
+        content: unknown[];
+    };
+};
+export declare const toolUse: (name: string, input: Record<string, unknown>, id?: string) => {
+    type: string;
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+};
+export declare const notification: (agentId: string, toolUseId: string, status: string, durationMs?: number) => string;
+export declare const userNotif: (n: number, text: string) => {
+    type: string;
+    timestamp: string;
+    message: {
+        role: string;
+        content: string;
+    };
+};
+export interface Layout {
+    projectsDir: string;
+    sessionPath: string;
+    subDir: string;
+}
+export declare function makeLayout(): Layout;
+export declare function writeAgent(l: Layout, agentId: string, meta: Record<string, unknown>, lines: unknown[]): string;
+//# sourceMappingURL=test-fixtures.d.ts.map

package/server/dist/core/session-info/test-fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-fixtures.d.ts","sourceRoot":"","sources":["../../../src/core/session-info/test-fixtures.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,OAAO,yCAAyC,CAAC;AAC9D,eAAO,MAAM,OAAO,mBAAmB,CAAC;AAExC,eAAO,MAAM,EAAE,GAAI,GAAG,MAAM,WAA4D,CAAC;AACzF,eAAO,MAAM,EAAE,GAAI,GAAG,MAAM,OAAO,EAAE,WAAyD,CAAC;AAE/F,eAAO,MAAM,SAAS,GACpB,GAAG,MAAM,EACT,OAAM;IAAE,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,EAAE,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,OAAO,CAAA;CAAO;;;;;;;;;;;;;;;;CActH,CAAC;AAEH,eAAO,MAAM,OAAO,GAAI,MAAM,MAAM,EAAE,OAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,WAAqC;;;;;CAKzG,CAAC;AAEH,eAAO,MAAM,YAAY,GAAI,SAAS,MAAM,EAAE,WAAW,MAAM,EAAE,QAAQ,MAAM,EAAE,mBAAiB,WACsO,CAAC;AAEzU,eAAO,MAAM,SAAS,GAAI,GAAG,MAAM,EAAE,MAAM,MAAM;;;;;;;CAAmF,CAAC;AAErI,MAAM,WAAW,MAAM;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,UAAU,IAAI,MAAM,CAKnC;AAED,wBAAgB,UAAU,CACxB,CAAC,EAAE,MAAM,EACT,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,KAAK,EAAE,OAAO,EAAE,GACf,MAAM,CAKR"}

package/server/dist/core/session-info/test-fixtures.js

@@ -0,0 +1,43 @@
+/* Fixture builders for the session-info tests — synthetic JSONL in Claude's real shapes. */
+import { mkdirSync, mkdtempSync, writeFileSync } from "node:fs";
+import { tmpdir } from "node:os";
+import path from "node:path";
+export const SESSION = "11111111-2222-4333-8444-555555555555";
+export const WIN_CWD = "C:\\proj\\repo";
+export const ts = (n) => new Date(Date.UTC(2026, 9, 30, 10, 0, n)).toISOString();
+export const jl = (...objs) => objs.map((o) => JSON.stringify(o)).join("\n") + "\n";
+export const assistant = (n, opts = {}) => ({
+    type: "assistant",
+    isSidechain: opts.sidechain ?? false,
+    timestamp: ts(n),
+    cwd: opts.cwd ?? WIN_CWD,
+    message: {
+        role: "assistant",
+        model: opts.model ?? "claude-opus-4",
+        usage: opts.usage
+            ? { input_tokens: opts.usage[0], cache_read_input_tokens: opts.usage[1], cache_creation_input_tokens: opts.usage[2], output_tokens: 9 }
+            : undefined,
+        content: opts.blocks ?? [{ type: "text", text: `reply ${n}` }],
+    },
+});
+export const toolUse = (name, input, id = `toolu_${name}_${Math.random()}`) => ({
+    type: "tool_use",
+    id,
+    name,
+    input,
+});
+export const notification = (agentId, toolUseId, status, durationMs = 5000) => `<task-notification>\n<task-id>${agentId}</task-id>\n<tool-use-id>${toolUseId}</tool-use-id>\n<status>${status}</status>\n<summary>x</summary>\n<result>delivered as a message</result>\n<usage><subagent_tokens>1234</subagent_tokens><tool_uses>7</tool_uses><duration_ms>${durationMs}</duration_ms></usage>\n</task-notification>`;
+export const userNotif = (n, text) => ({ type: "user", timestamp: ts(n), message: { role: "user", content: text } });
+export function makeLayout() {
+    const projectsDir = mkdtempSync(path.join(tmpdir(), "sessinfo-"));
+    const enc = path.join(projectsDir, "C--proj-repo");
+    mkdirSync(path.join(enc, SESSION, "subagents"), { recursive: true });
+    return { projectsDir, sessionPath: path.join(enc, `${SESSION}.jsonl`), subDir: path.join(enc, SESSION, "subagents") };
+}
+export function writeAgent(l, agentId, meta, lines) {
+    const p = path.join(l.subDir, `agent-${agentId}.jsonl`);
+    writeFileSync(p, jl(...lines));
+    writeFileSync(path.join(l.subDir, `agent-${agentId}.meta.json`), JSON.stringify(meta));
+    return p;
+}
+//# sourceMappingURL=test-fixtures.js.map

package/server/dist/core/session-info/test-fixtures.js.map

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

package/server/dist/core/session-info/types.d.ts

@@ -0,0 +1,77 @@
+export interface SessionContextInfo {
+    /** input + cache_read + cache_creation of the newest non-synthetic assistant message; null when none seen. */
+    tokens: number | null;
+    model: string | null;
+    /** Timestamp of the message the numbers came from. */
+    at: string | null;
+    /** A compaction happened AFTER that message, so `tokens` is stale. */
+    compactedSince: boolean;
+    /** The compactor's own post-compaction estimate; only set while `compactedSince`, null when it recorded none. */
+    tokensAfterCompaction: number | null;
+}
+export interface SessionCompactionInfo {
+    /** Compactions seen inside the scanned window. */
+    count: number;
+    last: {
+        at: string | null;
+        preTokens: number | null;
+        postTokens: number | null;
+    } | null;
+}
+export interface SessionOutputFile {
+    /** Absolute, normalised against the cwd of the entry that wrote it. */
+    path: string;
+    tool: "Write" | "Edit" | "NotebookEdit" | "MultiEdit";
+    firstAt: string | null;
+    lastAt: string | null;
+    /** Agent id when a subagent produced it; null for the session itself. */
+    agentId: string | null;
+}
+export interface SessionRemoteControl {
+    /** A LIVE process of this session currently has a bridge session. */
+    active: boolean;
+    /** A bridge-session record exists in the JSONL — it was enabled at least once. */
+    onceEnabled: boolean;
+    pid: number | null;
+}
+export type SubagentState = "running" | "finished" | "finished-stale";
+export interface SessionSubagent {
+    agentId: string;
+    agentType: string | null;
+    description: string | null;
+    toolUseId: string | null;
+    spawnDepth: number | null;
+    /** Set for depth-2 agents (a reviewer spawned by a sub-iterate). */
+    parentAgentId: string | null;
+    model: string | null;
+    prompt: string | null;
+    /** Last assistant text of the agent's own file (the notification's result is often just a pointer). */
+    answer: string | null;
+    startedAt: string | null;
+    endedAt: string | null;
+    durationMs: number | null;
+    state: SubagentState;
+    /** completed | failed | killed | stopped, from the parent's task-notification; null without one. */
+    status: string | null;
+    tokens: number | null;
+    toolUses: number | null;
+}
+export interface SessionInfoScan {
+    /** True when the session file was larger than the scan window; older history is not reflected. */
+    truncated: boolean;
+    scannedBytes: number;
+    sizeBytes: number;
+    /** Outputs / subagents beyond the caps (MAX_OUTPUTS, MAX_SUBAGENTS) that were not returned. */
+    outputsTruncated: number;
+    subagentsTruncated: number;
+}
+export interface SessionInfo {
+    sessionUuid: string;
+    context: SessionContextInfo;
+    compaction: SessionCompactionInfo;
+    outputs: SessionOutputFile[];
+    remoteControl: SessionRemoteControl;
+    subagents: SessionSubagent[];
+    scan: SessionInfoScan;
+}
+//# sourceMappingURL=types.d.ts.map

package/server/dist/core/session-info/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/session-info/types.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,kBAAkB;IACjC,8GAA8G;IAC9G,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,sDAAsD;IACtD,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,sEAAsE;IACtE,cAAc,EAAE,OAAO,CAAC;IACxB,iHAAiH;IACjH,qBAAqB,EAAE,MAAM,GAAG,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,qBAAqB;IACpC,kDAAkD;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;CACzF;AAED,MAAM,WAAW,iBAAiB;IAChC,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,cAAc,GAAG,WAAW,CAAC;IACtD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,yEAAyE;IACzE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,qEAAqE;IACrE,MAAM,EAAE,OAAO,CAAC;IAChB,kFAAkF;IAClF,WAAW,EAAE,OAAO,CAAC;IACrB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED,MAAM,MAAM,aAAa,GAAG,SAAS,GAAG,UAAU,GAAG,gBAAgB,CAAC;AAEtE,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,oEAAoE;IACpE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,uGAAuG;IACvG,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,aAAa,CAAC;IACrB,oGAAoG;IACpG,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,kGAAkG;IAClG,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,+FAA+F;IAC/F,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,kBAAkB,CAAC;IAC5B,UAAU,EAAE,qBAAqB,CAAC;IAClC,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAC7B,aAAa,EAAE,oBAAoB,CAAC;IACpC,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,IAAI,EAAE,eAAe,CAAC;CACvB"}

package/server/dist/core/session-info/types.js

@@ -0,0 +1,14 @@
+/*
+ * Wire shapes of GET /api/external/tasks/:id/session-info (campaign
+ * mission-desktop-style, M2). READ-ONLY view derived from Claude's own files
+ * (CLAUDE.md DO-NOT #1) — nothing here is ever written back.
+ *
+ * Outputs are ATTEMPTED-then-not-rejected writes: a tool_use whose result is_error is retracted.
+ * Runtime: Claude only (Codex tasks have no such JSONL and answer status "missing").
+ *
+ * Deliberately absent: a context PERCENTAGE and a context WINDOW SIZE. The
+ * window depends on the model/plan and is not recorded in the JSONL; inventing
+ * one would be a guess dressed as a fact. Consumers show the raw token count.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/server/dist/core/session-info/types.js.map

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

package/server/dist/core/stack-profiles-create.d.ts

@@ -0,0 +1,31 @@
+import { type StackProfileDeps } from "./stack-profiles.js";
+export type StackProfileScope = "project" | "user";
+export type CreateOutcome = {
+    status: "created";
+    name: string;
+    path: string;
+} | {
+    status: "invalid-request";
+    reason: string;
+} | {
+    status: "exists";
+    reason: string;
+} | {
+    status: "failed";
+    reason: string;
+};
+export interface CreateStackProfileInput {
+    from: string;
+    name: string;
+    scope: StackProfileScope;
+    /** Required for scope "project" (destination). For scope "user" it only widens the
+     *  collision check + validation to that project's own profiles. */
+    projectRoot?: string;
+}
+export interface CreateStackProfileDeps extends StackProfileDeps {
+    userProfilesDir?: string;
+}
+export declare function userProfilesDir(deps?: Pick<CreateStackProfileDeps, "userProfilesDir" | "homeDir">): string;
+export declare function validateNewProfileName(name: unknown): string | null;
+export declare function createStackProfileFromBundled(input: CreateStackProfileInput, deps?: CreateStackProfileDeps): Promise<CreateOutcome>;
+//# sourceMappingURL=stack-profiles-create.d.ts.map

package/server/dist/core/stack-profiles-create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-profiles-create.d.ts","sourceRoot":"","sources":["../../src/core/stack-profiles-create.ts"],"names":[],"mappings":"AAoBA,OAAO,EAKL,KAAK,gBAAgB,EACtB,MAAM,qBAAqB,CAAC;AAM7B,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,MAAM,CAAC;AAEnD,MAAM,MAAM,aAAa,GACrB;IAAE,MAAM,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,MAAM,EAAE,iBAAiB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,iBAAiB,CAAC;IACzB;uEACmE;IACnE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB;IAC9D,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAWD,wBAAgB,eAAe,CAAC,IAAI,GAAE,IAAI,CAAC,sBAAsB,EAAE,iBAAiB,GAAG,SAAS,CAAM,GAAG,MAAM,CAM9G;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,IAAI,CASnE;AAED,wBAAsB,6BAA6B,CACjD,KAAK,EAAE,uBAAuB,EAC9B,IAAI,GAAE,sBAA2B,GAChC,OAAO,CAAC,aAAa,CAAC,CAUxB"}

package/server/dist/core/stack-profiles-create.js

@@ -0,0 +1,128 @@
+/*
+ * stack-profiles-create.ts — "create a custom profile from a bundled one".
+ *
+ * The ONLY write surface of the stack-profile feature, and deliberately tiny:
+ * it copies a bundled profile's JSON under a NEW name into the project's
+ * `.shipwright/profiles/` or the user's `~/.shipwright/profiles/`
+ * (`SHIPWRIGHT_USER_PROFILES_DIR` overrides, same as the resolver). Rules:
+ *   - the name is validated against the resolver's own NAME_RE and must be
+ *     unused in EVERY source — shadowing a bundled profile is the resolver's
+ *     "same-name shadow" regression case, so the UI never creates one;
+ *   - `wx` open — an existing file is never overwritten (race-safe, no
+ *     check-then-write window);
+ *   - the result is validated through the resolver; a copy it rejects is
+ *     removed again, so a failed create leaves nothing behind.
+ */
+import { promises as fsp } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { MAX_PROFILE_NAME_LENGTH, isProfileNameShape, listStackProfiles, validateStackProfile, } from "./stack-profiles.js";
+/** Names the resolver reserves as sentinels, never real profiles. */
+const RESERVED = new Set(["generic", "detecting", "custom"]);
+const WINDOWS_DEVICE = /^(con|prn|aux|nul|com[1-9]|lpt[1-9])$/;
+function samePath(a, b) {
+    if (typeof a !== "string")
+        return false;
+    const norm = (x) => (process.platform === "win32" ? path.resolve(x).toLowerCase() : path.resolve(x));
+    return norm(a) === norm(b);
+}
+/** Names being created right now - two concurrent creates of one name never both run. */
+const inFlight = new Set();
+export function userProfilesDir(deps = {}) {
+    return (deps.userProfilesDir ??
+        (process.env.SHIPWRIGHT_USER_PROFILES_DIR?.trim() || undefined) ??
+        path.join(deps.homeDir ?? os.homedir(), ".shipwright", "profiles"));
+}
+export function validateNewProfileName(name) {
+    if (typeof name === "string" && name.length > MAX_PROFILE_NAME_LENGTH) {
+        return `Keep the name under ${MAX_PROFILE_NAME_LENGTH + 1} characters.`;
+    }
+    if (!isProfileNameShape(name)) {
+        return "Use lowercase letters, digits and dashes only (it must start with a letter or digit).";
+    }
+    if (RESERVED.has(name) || WINDOWS_DEVICE.test(name))
+        return `“${name}” is reserved — pick another name.`;
+    return null;
+}
+export async function createStackProfileFromBundled(input, deps = {}) {
+    if (typeof input.name === "string" && inFlight.has(input.name)) {
+        return { status: "exists", reason: `“${input.name}” is already being created.` };
+    }
+    inFlight.add(input.name);
+    try {
+        return await createUnlocked(input, deps);
+    }
+    finally {
+        inFlight.delete(input.name);
+    }
+}
+async function createUnlocked(input, deps) {
+    const nameProblem = validateNewProfileName(input.name);
+    if (nameProblem)
+        return { status: "invalid-request", reason: nameProblem };
+    if (input.scope === "project" && !input.projectRoot) {
+        return { status: "invalid-request", reason: "A project profile needs a project." };
+    }
+    const listed = await listStackProfiles({ projectRoot: input.projectRoot }, deps);
+    if (listed.status !== "ok") {
+        return { status: "failed", reason: listed.status === "failed" ? listed.reason : "The profile resolver isn't available." };
+    }
+    const source = listed.report.profiles.find((p) => p.name === input.from && p.source === "bundled");
+    if (!source || !source.valid) {
+        return { status: "invalid-request", reason: `“${input.from}” isn't a usable built-in profile.` };
+    }
+    if (listed.report.profiles.some((p) => p.name === input.name)) {
+        return { status: "exists", reason: `A profile called “${input.name}” already exists.` };
+    }
+    let content;
+    try {
+        const data = JSON.parse(await fsp.readFile(source.path, "utf-8"));
+        content = `${JSON.stringify({ ...data, name: input.name }, null, 2)}\n`;
+    }
+    catch (err) {
+        return { status: "failed", reason: `Couldn't read the built-in profile: ${String(err)}` };
+    }
+    const dir = input.scope === "project"
+        ? path.join(input.projectRoot, ".shipwright", "profiles")
+        : userProfilesDir(deps);
+    const target = path.join(dir, `${input.name}.json`);
+    try {
+        await fsp.mkdir(dir, { recursive: true });
+        // DO-NOT #10: a symlinked .shipwright / profiles dir must not redirect the write.
+        if (input.scope === "project") {
+            const rel = path.relative(await fsp.realpath(input.projectRoot), await fsp.realpath(dir));
+            if (rel.startsWith("..") || path.isAbsolute(rel)) {
+                return { status: "failed", reason: "The project's profiles folder points outside the project, so nothing was written." };
+            }
+        }
+        await fsp.writeFile(target, content, { encoding: "utf-8", flag: "wx" });
+    }
+    catch (err) {
+        if (err.code === "EEXIST") {
+            return { status: "exists", reason: `A profile called “${input.name}” already exists.` };
+        }
+        return { status: "failed", reason: `Couldn't write the profile: ${String(err)}` };
+    }
+    const checked = await validateStackProfile({ name: input.name, projectRoot: input.projectRoot }, deps);
+    // A copy stays ONLY on the resolver's explicit "valid" for THIS very file. Any
+    // other outcome (invalid, unreachable, timeout, newer contract, or the resolver
+    // resolving the name to a different file) removes the file this request created
+    // (wx guarantees it is ours) and says exactly why.
+    const sameFile = checked.status === "ok" && checked.report.valid && "path" in checked.report && samePath(checked.report.path, target);
+    if (!sameFile) {
+        const why = checked.status !== "ok"
+            ? "the resolver couldn't be reached to check it"
+            : !checked.report.valid
+                ? "error" in checked.report ? checked.report.error : "the resolver rejected it"
+                : "the resolver resolved that name to a different profile";
+        try {
+            await fsp.rm(target, { force: true });
+        }
+        catch {
+            return { status: "failed", reason: `The new profile didn't validate (${why}) and couldn't be removed — delete ${target} by hand.` };
+        }
+        return { status: "failed", reason: `The new profile didn't validate (${why}), so it was removed again.` };
+    }
+    return { status: "created", name: input.name, path: target };
+}
+//# sourceMappingURL=stack-profiles-create.js.map

package/server/dist/core/stack-profiles-create.js.map

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

package/server/dist/core/stack-profiles.d.ts

@@ -0,0 +1,49 @@
+import { type CliChildSpawnFn } from "./cli-child-spawn.js";
+import { type RunFn } from "./readiness-probe.js";
+import { type StackProfileListReport, type StackProfileValidateReport } from "../types/stack-profile-contract.js";
+export declare const STACK_PROFILE_CLI_TIMEOUT_MS = 20000;
+/** Mirror of the resolver's NAME_RE + a filename-safe length cap. A name that
+ *  fails this never reaches argv (a leading `-` would parse as an option). */
+export declare const PROFILE_NAME_RE: RegExp;
+export declare const MAX_PROFILE_NAME_LENGTH = 64;
+export declare function isProfileNameShape(name: unknown): name is string;
+export type StackProfileOutcome<T> = {
+    status: "ok";
+    report: T;
+} | {
+    status: "unsupported-contract";
+    version: string;
+} | {
+    status: "engine-unavailable";
+    reason: string;
+    repairCommand: string;
+} | {
+    status: "failed";
+    reason: string;
+};
+export interface StackProfileDeps {
+    run?: RunFn;
+    spawn?: CliChildSpawnFn;
+    existsFn?: (p: string) => boolean;
+    homeDir?: string;
+    baseEnv?: NodeJS.ProcessEnv;
+    scriptOverride?: string;
+    timeoutMs?: number;
+}
+/** The cache-owned resolver CLI (`SHIPWRIGHT_RESOLVE_PROFILE_SCRIPT` overrides
+ *  the location — isolated E2E stacks run with an ephemeral HOME). */
+export declare function resolveProfileScript(deps?: Pick<StackProfileDeps, "existsFn" | "homeDir" | "scriptOverride">): string | null;
+export declare function listStackProfiles(input: {
+    projectRoot?: string;
+}, deps?: StackProfileDeps): Promise<StackProfileOutcome<StackProfileListReport>>;
+/** Validate one profile by NAME (resolved through the normal lookup order). A
+ *  profile the resolver rejects is `{valid:false}` data, not a transport failure. */
+export declare function validateStackProfile(input: {
+    name: string;
+    projectRoot?: string;
+}, deps?: StackProfileDeps): Promise<StackProfileOutcome<StackProfileValidateReport | {
+    valid: false;
+    name: string;
+    error: string;
+}>>;
+//# sourceMappingURL=stack-profiles.d.ts.map

package/server/dist/core/stack-profiles.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stack-profiles.d.ts","sourceRoot":"","sources":["../../src/core/stack-profiles.ts"],"names":[],"mappings":"AAkBA,OAAO,EAAwB,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAClF,OAAO,EAAiD,KAAK,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAEjG,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAChC,MAAM,oCAAoC,CAAC;AAE5C,eAAO,MAAM,4BAA4B,QAAS,CAAC;AAEnD;8EAC8E;AAC9E,eAAO,MAAM,eAAe,QAAyB,CAAC;AACtD,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,IAAI,MAAM,CAEhE;AAED,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAC7B;IAAE,MAAM,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,CAAC,CAAA;CAAE,GAC3B;IAAE,MAAM,EAAE,sBAAsB,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACnD;IAAE,MAAM,EAAE,oBAAoB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,aAAa,EAAE,MAAM,CAAA;CAAE,GACvE;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzC,MAAM,WAAW,gBAAgB;IAC/B,GAAG,CAAC,EAAE,KAAK,CAAC;IACZ,KAAK,CAAC,EAAE,eAAe,CAAC;IACxB,QAAQ,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IAClC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;sEACsE;AACtE,wBAAgB,oBAAoB,CAClC,IAAI,GAAE,IAAI,CAAC,gBAAgB,EAAE,UAAU,GAAG,SAAS,GAAG,gBAAgB,CAAM,GAC3E,MAAM,GAAG,IAAI,CAOf;AAoED,wBAAsB,iBAAiB,CACrC,KAAK,EAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EAC/B,IAAI,GAAE,gBAAqB,GAC1B,OAAO,CAAC,mBAAmB,CAAC,sBAAsB,CAAC,CAAC,CAkBtD;AAED;qFACqF;AACrF,wBAAsB,oBAAoB,CACxC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EAC7C,IAAI,GAAE,gBAAqB,GAC1B,OAAO,CAAC,mBAAmB,CAAC,0BAA0B,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAwB1G"}