wicked-crew 0.7.39 → 0.7.45

package/dist/team/key.d.ts

@@ -0,0 +1,5 @@
+/** `deterministic_key(parts)`: 32 lowercase hex characters. */
+export declare function deterministicKey(parts: readonly string[]): string;
+/** A team event's key: `deterministic_key(["team", eventType, runId, ...parts])` (DES-002 §6.1). */
+export declare function teamKey(eventType: string, runId: string, parts?: readonly string[]): string;
+//# sourceMappingURL=key.d.ts.map

package/dist/team/key.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key.d.ts","sourceRoot":"","sources":["../../src/team/key.ts"],"names":[],"mappings":"AASA,+DAA+D;AAC/D,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,CAOjE;AAED,oGAAoG;AACpG,wBAAgB,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,SAAS,MAAM,EAAO,GAAG,MAAM,CAE/F"}

package/dist/team/key.js

@@ -0,0 +1,21 @@
+// The team idempotency key, byte for byte as wicked-core's `crate::bus::deterministic_key`
+// computes it (DES-TEAMING-002 §4.1): SHA-256 over every part's UTF-8 bytes followed by one 0x00
+// byte (the last part is NUL-terminated too; this is not a `\0`-join), the first 16 bytes of the
+// digest as lowercase hex. Crew publishes no team event (DES-002 §7); this exists so a crew-side
+// reader can recompute a row's key, and so `tests/team-events.test.ts` pins the two
+// implementations to the same vectors.
+import { createHash } from 'node:crypto';
+/** `deterministic_key(parts)`: 32 lowercase hex characters. */
+export function deterministicKey(parts) {
+    const h = createHash('sha256');
+    for (const p of parts) {
+        h.update(Buffer.from(p, 'utf8'));
+        h.update(Buffer.from([0]));
+    }
+    return h.digest().subarray(0, 16).toString('hex');
+}
+/** A team event's key: `deterministic_key(["team", eventType, runId, ...parts])` (DES-002 §6.1). */
+export function teamKey(eventType, runId, parts = []) {
+    return deterministicKey(['team', eventType, runId, ...parts]);
+}
+//# sourceMappingURL=key.js.map

package/dist/team/key.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"key.js","sourceRoot":"","sources":["../../src/team/key.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,iGAAiG;AACjG,iGAAiG;AACjG,iGAAiG;AACjG,oFAAoF;AACpF,uCAAuC;AAEvC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,+DAA+D;AAC/D,MAAM,UAAU,gBAAgB,CAAC,KAAwB;IACvD,MAAM,CAAC,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QACjC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACpD,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,OAAO,CAAC,SAAiB,EAAE,KAAa,EAAE,QAA2B,EAAE;IACrF,OAAO,gBAAgB,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,CAAC,CAAC;AAChE,CAAC"}

package/dist/team/routes.d.ts

@@ -0,0 +1,196 @@
+/**
+ * The crew team surface (DES-TEAMING-002 T8): reads and commands over the engine. Commands go
+ * through the API, facts go on the bus (§4.0); crew publishes no team row.
+ *
+ *   GET  /runs/:id/team         the engine's persisted team state (`Core.runTeam`) joined with the
+ *                               run's `wicked.team.*` bus rows and the folded ledger each gate read
+ *   POST /runs/:id/plan         a plan edit: at a `plan_approval` gate the gate answer
+ *                               (`confirmGate … edit_plan`), otherwise a mid-run edit (`Core.proposePlan`)
+ *   POST /team/outbox/replay    `Core.replayTeamOutbox`: the team outbox onto the bus
+ *   GET  /catalog               the engine's phase catalog
+ *   POST /plans/preview         the launch's decision over a draft plan (`Core.previewPlan`)
+ *
+ * The live stream is the relay (`team/ws-relay.ts`). An addon without a binding answers 501.
+ */
+import type { FastifyInstance } from 'fastify';
+import { z } from 'zod';
+import type { CoreAdapter } from '../core/adapter.js';
+import type { RunTeamResponse, RunTeamView, TeamRow } from '../core/types.js';
+import { AuditLog } from '../api/audit.js';
+export declare const EditPlanSchema: z.ZodObject<{
+    plan: z.ZodObject<{
+        steps: z.ZodArray<z.ZodObject<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">>, "many">;
+        touch: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        override: z.ZodOptional<z.ZodObject<{
+            remove: z.ZodArray<z.ZodString, "many">;
+            reason: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            reason: string;
+            remove: string[];
+        }, {
+            reason: string;
+            remove: string[];
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        steps: z.objectOutputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    }, {
+        steps: z.objectInputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    }>;
+    requestId: z.ZodOptional<z.ZodString>;
+}, "strict", z.ZodTypeAny, {
+    plan: {
+        steps: z.objectOutputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    };
+    requestId?: string | undefined;
+}, {
+    plan: {
+        steps: z.objectInputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    };
+    requestId?: string | undefined;
+}>;
+export declare const PlanPreviewSchema: z.ZodObject<{
+    plan: z.ZodObject<{
+        steps: z.ZodArray<z.ZodObject<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">>, "many">;
+        touch: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        override: z.ZodOptional<z.ZodObject<{
+            remove: z.ZodArray<z.ZodString, "many">;
+            reason: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            reason: string;
+            remove: string[];
+        }, {
+            reason: string;
+            remove: string[];
+        }>>;
+    }, "strict", z.ZodTypeAny, {
+        steps: z.objectOutputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    }, {
+        steps: z.objectInputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    }>;
+    projectId: z.ZodOptional<z.ZodString>;
+    humanConfirm: z.ZodOptional<z.ZodString>;
+    repoRef: z.ZodOptional<z.ZodString>;
+    deliver: z.ZodOptional<z.ZodEnum<["pr", "none"]>>;
+}, "strict", z.ZodTypeAny, {
+    plan: {
+        steps: z.objectOutputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    };
+    deliver?: "pr" | "none" | undefined;
+    projectId?: string | undefined;
+    repoRef?: string | undefined;
+    humanConfirm?: string | undefined;
+}, {
+    plan: {
+        steps: z.objectInputType<{
+            catalog: z.ZodString;
+            id: z.ZodOptional<z.ZodString>;
+        }, z.ZodTypeAny, "passthrough">[];
+        override?: {
+            reason: string;
+            remove: string[];
+        } | undefined;
+        touch?: string[] | undefined;
+    };
+    deliver?: "pr" | "none" | undefined;
+    projectId?: string | undefined;
+    repoRef?: string | undefined;
+    humanConfirm?: string | undefined;
+}>;
+/** The run's `wicked.team.*` rows, by `event_id`, read through the engine that holds the bus
+ *  (core/bus.ts); `[]` when the bus is absent or unreadable. */
+export declare function busRows(busDbPath: string | undefined, runId: string): Promise<TeamRow[]>;
+/**
+ * The OPEN plan gate's own reading of the plan it holds: the newest `gate.opened{kind:"plan_approval"}`
+ * no `gate.decided` answered, with its `band` and `high_risk` (brainstorm idea 13 — a plan-approval
+ * trust order re-reads these before it answers). `undefined` when no plan gate is open or the row
+ * does not state both its band and a boolean `high_risk`: the caller fails closed.
+ */
+export declare function openPlanGateRisk(rows: readonly TeamRow[]): {
+    band: string;
+    highRisk: boolean;
+} | undefined;
+/**
+ * Join the bus rows onto the engine's snapshot. Rows with `ord: null` are the run's; the rest go
+ * to their unit. `gate.opened{kind:"unit_review"}.ledger_ref` is the only authority on which
+ * ledger a gate read: the `ledger.folded` row it names is the unit's `ledger`, and a fold for an
+ * attempt whose gate named another ledger is labelled `unused`.
+ */
+export declare function joinTeam(view: RunTeamView, rows: TeamRow[]): RunTeamResponse;
+export declare function registerTeamRoutes(app: FastifyInstance, adapter: CoreAdapter, security?: {
+    audit: AuditLog;
+}): void;
+//# sourceMappingURL=routes.d.ts.map

package/dist/team/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../src/team/routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAE/C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAGtD,OAAO,KAAK,EAKV,eAAe,EAEf,WAAW,EAEX,OAAO,EACR,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAO3C,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAEhB,CAAC;AAKZ,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAQnB,CAAC;AAwBZ;gEACgE;AAChE,wBAAsB,OAAO,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CAoB9F;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,CAgB1G;AAID;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,eAAe,CAsB5E;AAED,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,eAAe,EACpB,OAAO,EAAE,WAAW,EAEpB,QAAQ,GAAE;IAAE,KAAK,EAAE,QAAQ,CAAA;CAA+B,GACzD,IAAI,CA2JN"}

package/dist/team/routes.js

@@ -0,0 +1,274 @@
+/**
+ * The crew team surface (DES-TEAMING-002 T8): reads and commands over the engine. Commands go
+ * through the API, facts go on the bus (§4.0); crew publishes no team row.
+ *
+ *   GET  /runs/:id/team         the engine's persisted team state (`Core.runTeam`) joined with the
+ *                               run's `wicked.team.*` bus rows and the folded ledger each gate read
+ *   POST /runs/:id/plan         a plan edit: at a `plan_approval` gate the gate answer
+ *                               (`confirmGate … edit_plan`), otherwise a mid-run edit (`Core.proposePlan`)
+ *   POST /team/outbox/replay    `Core.replayTeamOutbox`: the team outbox onto the bus
+ *   GET  /catalog               the engine's phase catalog
+ *   POST /plans/preview         the launch's decision over a draft plan (`Core.previewPlan`)
+ *
+ * The live stream is the relay (`team/ws-relay.ts`). An addon without a binding answers 501.
+ */
+import { randomUUID } from 'node:crypto';
+import { z } from 'zod';
+import { PlanLaunchUnsupportedError, TeamUnsupportedError } from '../core/adapter.js';
+import { readBus } from '../core/bus.js';
+import { API_PREFIX } from '../api/api-prefix.js';
+import { AuditLog } from '../api/audit.js';
+import { LOCAL_ACTOR } from '../api/auth.js';
+import { PlanSchema, toLaunchPlan } from '../api/plan-schema.js';
+const V = API_PREFIX;
+// Exported for tests/wire-contract.test.ts (the request-direction drift guard).
+export const EditPlanSchema = z
+    .object({ plan: PlanSchema, requestId: z.string().min(1).max(128).optional() })
+    .strict();
+/** The engine's refusal of a gate edit when the paused run's open gate is not a plan approval:
+ *  the run is paused at another gate, so the edit is a mid-run one. */
+const NO_PLAN_GATE = /no plan_approval gate open/;
+export const PlanPreviewSchema = z
+    .object({
+    plan: PlanSchema,
+    projectId: z.string().min(1).optional(),
+    humanConfirm: z.string().min(1).optional(),
+    repoRef: z.string().min(1).optional(),
+    deliver: z.enum(['pr', 'none']).optional(),
+})
+    .strict();
+function message(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+const TERMINAL = new Set(['completed', 'cancelled', 'failed']);
+/** A run that is not a team run: no transport at all (not the "none" fallback), nothing to join. */
+function unteamed(runId, status) {
+    return {
+        runId,
+        teamed: false,
+        transport: null,
+        reason: null,
+        streamFloor: null,
+        planRev: null,
+        pending: null,
+        ended: TERMINAL.has(status),
+        units: [],
+        rows: [],
+    };
+}
+/** The run's `wicked.team.*` rows, by `event_id`, read through the engine that holds the bus
+ *  (core/bus.ts); `[]` when the bus is absent or unreadable. */
+export async function busRows(busDbPath, runId) {
+    if (busDbPath === undefined)
+        return [];
+    try {
+        // History: a finished run's rows stay readable past the bus TTL (nothing sweeps the daemon's bus).
+        const rows = await readBus(busDbPath, 'wicked.team.', { history: true });
+        return rows
+            .filter((r) => r.payload?.run_id === runId)
+            .map((r) => ({
+            event_id: r.event_id,
+            event_type: r.event_type,
+            payload: r.payload,
+            emitted_at: r.emitted_at,
+        }));
+    }
+    catch {
+        // No engine bus / an unreadable one: the engine's snapshot still answers.
+        return [];
+    }
+}
+/**
+ * The OPEN plan gate's own reading of the plan it holds: the newest `gate.opened{kind:"plan_approval"}`
+ * no `gate.decided` answered, with its `band` and `high_risk` (brainstorm idea 13 — a plan-approval
+ * trust order re-reads these before it answers). `undefined` when no plan gate is open or the row
+ * does not state both its band and a boolean `high_risk`: the caller fails closed.
+ */
+export function openPlanGateRisk(rows) {
+    const sorted = [...rows].sort((a, b) => a.event_id - b.event_id);
+    const payload = (r) => (r.payload ?? {});
+    const decided = new Set(sorted.filter((r) => r.event_type === 'wicked.team.gate.decided').map((r) => payload(r)['gate_id']));
+    const open = sorted
+        .filter((r) => r.event_type === 'wicked.team.gate.opened' && payload(r)['kind'] === 'plan_approval')
+        .filter((r) => !decided.has(payload(r)['gate_id']))
+        .pop();
+    if (open === undefined)
+        return undefined;
+    const band = payload(open)['band'];
+    const highRisk = payload(open)['high_risk'];
+    // Fail closed: a row that does not SAY its band and its risk is not a reading of them.
+    if (typeof band !== 'string' || band === '' || typeof highRisk !== 'boolean')
+        return undefined;
+    return { band, highRisk };
+}
+const fold = (ord, attempt) => `ledger.folded#${String(ord)}:${String(attempt)}`;
+/**
+ * Join the bus rows onto the engine's snapshot. Rows with `ord: null` are the run's; the rest go
+ * to their unit. `gate.opened{kind:"unit_review"}.ledger_ref` is the only authority on which
+ * ledger a gate read: the `ledger.folded` row it names is the unit's `ledger`, and a fold for an
+ * attempt whose gate named another ledger is labelled `unused`.
+ */
+export function joinTeam(view, rows) {
+    const read = new Map(); // "<ord>:<attempt>" → the ledger_ref its gate read
+    for (const r of rows) {
+        if (r.event_type === 'wicked.team.gate.opened' && r.payload.kind === 'unit_review') {
+            read.set(`${String(r.payload.ord)}:${String(r.payload.attempt)}`, r.payload.ledger_ref);
+        }
+    }
+    const labelled = rows.map((r) => {
+        if (r.event_type !== 'wicked.team.ledger.folded')
+            return r;
+        const key = `${String(r.payload.ord)}:${String(r.payload.attempt)}`;
+        return read.has(key) && read.get(key) !== fold(r.payload.ord, r.payload.attempt) ? { ...r, unused: true } : r;
+    });
+    const units = view.units.map((u) => {
+        const own = labelled.filter((r) => r.payload.ord === u.ord);
+        const used = own.find((r) => r.event_type === 'wicked.team.ledger.folded' && fold(r.payload.ord, r.payload.attempt) === u.ledgerRef);
+        const ledger = used !== undefined && used.event_type === 'wicked.team.ledger.folded' ? used.payload.ledger : null;
+        return { ...u, rows: own, ledger };
+    });
+    return { ...view, teamed: true, units, rows: labelled.filter((r) => r.payload.ord === null) };
+}
+export function registerTeamRoutes(app, adapter, 
+// Defaulted to a NOOP trail so a directly-driven route set never writes the real audit log.
+security = { audit: AuditLog.noop() }) {
+    const { audit } = security;
+    const actorOf = (req) => req.actor ?? LOCAL_ACTOR;
+    const unsupported = (err) => err instanceof TeamUnsupportedError || err instanceof PlanLaunchUnsupportedError;
+    const findRun = async (id) => (await adapter.sessionsDetail()).find((v) => v.session.id === id);
+    app.get(`${V}/runs/:id/team`, { config: { manifest: { responseType: 'RunTeamResponse', statusCodes: [200, 404, 501] } } }, async (req, reply) => {
+        const { id } = req.params;
+        try {
+            const run = await findRun(id);
+            if (run === undefined)
+                return reply.code(404).send({ error: 'Run not found' });
+            const view = await adapter.runTeam(id);
+            if (view === null)
+                return unteamed(id, run.session.status);
+            return joinTeam(view, await busRows(adapter.busDbPath, id));
+        }
+        catch (err) {
+            return reply.code(unsupported(err) ? 501 : 500).send({ error: message(err) });
+        }
+    });
+    app.post(`${V}/runs/:id/plan`, {
+        config: {
+            manifest: {
+                requestType: 'EditPlanBody',
+                responseType: 'EditPlanResponse',
+                // 409: the engine refused the edit (its reason); 501: the addon lacks the gate edit or
+                // Core.proposePlan.
+                statusCodes: [200, 400, 404, 409, 501],
+            },
+        },
+    }, async (req, reply) => {
+        const { id } = req.params;
+        const parsed = EditPlanSchema.safeParse(req.body);
+        if (!parsed.success) {
+            return reply.code(400).send({ error: 'Invalid request body', details: parsed.error.issues });
+        }
+        const run = await findRun(id);
+        if (run === undefined)
+            return reply.code(404).send({ error: 'Run not found' });
+        const plan = toLaunchPlan(parsed.data.plan);
+        if (run.session.status === 'awaiting_human') {
+            try {
+                // The edit IS the gate answer (T3): the engine proposes it (`plan.proposed{by:"human",
+                // kind:"edit"}`), floor-fills and accepts it, or refuses it and re-opens the gate.
+                const status = await adapter.confirmGate(id, true, undefined, 'edit_plan', undefined, plan);
+                // WHO answered the gate, like every other gate answer (POST /runs/:id/gate).
+                audit.record('gate.decided', actorOf(req), {
+                    runId: id,
+                    detail: { approve: true, action: 'edit_plan', planSteps: parsed.data.plan.steps.length, status },
+                });
+                // confirmGate resolves the engine's status token, a SessionStatus spelling.
+                const body = { status: status };
+                return body;
+            }
+            catch (err) {
+                // Paused at another gate (a unit gate, a team pause): no plan gate to answer, so the edit
+                // is a mid-run one, below. Every other refusal is the answer.
+                if (!NO_PLAN_GATE.test(message(err))) {
+                    return reply.code(unsupported(err) ? 501 : 409).send({ error: message(err) });
+                }
+            }
+        }
+        // T8 (c): a mid-run edit. The engine holds it for the run's next step boundary (ratchet and
+        // floor fill apply) and its author approved it, so no gate opens; the proposal says what it
+        // does to the run (band, high risk, the floor steps it adds). Idempotent by requestId: a body
+        // without one gets a fresh id minted for this POST, so only a caller-sent id makes a retry
+        // safe. The engine refuses a plan awaiting approval (edit it at the gate), a started deliver
+        // step, and a finished or unplanned run: each is a 409 carrying its reason.
+        const requestId = parsed.data.requestId ?? randomUUID();
+        try {
+            const proposal = await adapter.proposePlan(id, plan, requestId);
+            audit.record('plan.edit.proposed', actorOf(req), {
+                runId: id,
+                detail: {
+                    requestId,
+                    proposalId: proposal.proposal_id,
+                    duplicate: proposal.duplicate,
+                    planSteps: parsed.data.plan.steps.length,
+                    band: proposal.band,
+                    highRisk: proposal.high_risk,
+                    floorAdded: proposal.floor_added,
+                },
+            });
+            const body = proposal;
+            return body;
+        }
+        catch (err) {
+            return reply.code(unsupported(err) ? 501 : 409).send({ error: message(err) });
+        }
+    });
+    app.post(`${V}/team/outbox/replay`, { config: { manifest: { responseType: 'TeamOutboxReplayReport', statusCodes: [200, 409, 501] } } }, async (req, reply) => {
+        try {
+            const report = await adapter.replayTeamOutbox();
+            audit.record('team.outbox.replayed', actorOf(req), {
+                detail: { published: report.published.length, remaining: report.remaining },
+            });
+            return report;
+        }
+        catch (err) {
+            // The engine refuses when it has no bus or no state home: a state, not a bad request.
+            return reply.code(unsupported(err) ? 501 : 409).send({ error: message(err) });
+        }
+    });
+    app.get(`${V}/catalog`, { config: { manifest: { responseType: 'CatalogResponse', statusCodes: [200, 501] } } }, async (_req, reply) => {
+        try {
+            const body = { entries: await adapter.catalog() };
+            return body;
+        }
+        catch (err) {
+            return reply.code(unsupported(err) ? 501 : 500).send({ error: message(err) });
+        }
+    });
+    app.post(`${V}/plans/preview`, {
+        config: {
+            manifest: { requestType: 'PlanPreviewBody', responseType: 'PlanPreviewResponse', statusCodes: [200, 400, 501] },
+        },
+    }, async (req, reply) => {
+        const parsed = PlanPreviewSchema.safeParse(req.body);
+        if (!parsed.success) {
+            return reply.code(400).send({ error: 'Invalid request body', details: parsed.error.issues });
+        }
+        try {
+            // The preview is the launch's own decision, so it takes what the launch would: the repo
+            // (its graph scores the touch set) and, for a delivering launch, the deliver step. A plan
+            // launch delivers only on an explicit `deliver: "pr"` (POST /runs defaults a plan to none).
+            const d = parsed.data;
+            return await adapter.previewPlan(toLaunchPlan(d.plan), {
+                ...(d.projectId !== undefined ? { projectId: d.projectId } : {}),
+                ...(d.humanConfirm !== undefined ? { humanConfirm: d.humanConfirm } : {}),
+                ...(d.repoRef !== undefined ? { repoRef: d.repoRef } : {}),
+                deliver: d.deliver === 'pr',
+            });
+        }
+        catch (err) {
+            // The engine's refusal of the draft (compose, the override in auto mode, an unregistered
+            // repo, …) is the answer.
+            return reply.code(unsupported(err) ? 501 : 400).send({ error: message(err) });
+        }
+    });
+}
+//# sourceMappingURL=routes.js.map

package/dist/team/routes.js.map

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

package/dist/team/ws-relay.d.ts

@@ -0,0 +1,39 @@
+/**
+ * DES-TEAMING-002 §4.5 (seam T8) — the `wicked.team.*` → `/ws` relay.
+ *
+ * The engine publishes every team fact on the bus (§4.0, one owner per type, §7). This relay puts
+ * each new team row on the SAME `/ws` socket the studio already holds, as
+ * `{ type: 'teamEvent', event: <the bus row> }`, tagged `project_id` when the run's membership
+ * files it, as every CoreEvent frame is. No CoreEvent variant carries a team event, and crew never
+ * puts a team row on the bus (tests/team-no-publish.test.ts).
+ *
+ * READ-ONLY. The bus file is the engine's (T0), and crew reads it through the engine that holds it
+ * (`Core.busRead`, wicked-core#631, core/bus.ts) — crew opens no SQLite of its own. The relay is a
+ * tap with its cursor in memory, starting at the newest row (`latest`). Nothing is lost that
+ * matters: the bus is the durable record and `GET /runs/:id/team` reads it back, so a restart needs
+ * no stored cursor.
+ *
+ * Posture: loud, non-fatal. A bus no engine holds → one log line and `null`; `/ws` then
+ * carries no team frames. A read that fails (the engine mid-checkpoint) is logged and retried on
+ * the next poll.
+ */
+import type { CoreEvent } from '../core/types.js';
+/** The ONE envelope type this relay puts on `/ws` (api-types `TeamEventFrame`). */
+export declare const TEAM_EVENT_FRAME = "teamEvent";
+export interface TeamRelay {
+    stop(): Promise<void>;
+}
+export interface TeamRelayOptions {
+    /** The bus db the engine publishes on (the adapter's `busDbPath`). */
+    dbPath: string;
+    /** The project a run is filed under, if any. */
+    projectOf: (runId: string) => string | undefined;
+    /** Poll cadence, ms (tests shorten it). */
+    pollIntervalMs?: number;
+    /** Where frames go; defaults to every `/ws` client (tests capture them). */
+    broadcast?: (frame: CoreEvent) => void;
+    log?: (msg: string) => void;
+}
+/** Arm the relay; `null` (logged) when the bus cannot be opened. */
+export declare function startTeamWsRelay(opts: TeamRelayOptions): Promise<TeamRelay | null>;
+//# sourceMappingURL=ws-relay.d.ts.map

package/dist/team/ws-relay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-relay.d.ts","sourceRoot":"","sources":["../../src/team/ws-relay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAKlD,mFAAmF;AACnF,eAAO,MAAM,gBAAgB,cAAc,CAAC;AAE5C,MAAM,WAAW,SAAS;IACxB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,sEAAsE;IACtE,MAAM,EAAE,MAAM,CAAC;IACf,gDAAgD;IAChD,SAAS,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACjD,2CAA2C;IAC3C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,4EAA4E;IAC5E,SAAS,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACvC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;CAC7B;AAED,oEAAoE;AACpE,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CA8BxF"}

package/dist/team/ws-relay.js

@@ -0,0 +1,63 @@
+/**
+ * DES-TEAMING-002 §4.5 (seam T8) — the `wicked.team.*` → `/ws` relay.
+ *
+ * The engine publishes every team fact on the bus (§4.0, one owner per type, §7). This relay puts
+ * each new team row on the SAME `/ws` socket the studio already holds, as
+ * `{ type: 'teamEvent', event: <the bus row> }`, tagged `project_id` when the run's membership
+ * files it, as every CoreEvent frame is. No CoreEvent variant carries a team event, and crew never
+ * puts a team row on the bus (tests/team-no-publish.test.ts).
+ *
+ * READ-ONLY. The bus file is the engine's (T0), and crew reads it through the engine that holds it
+ * (`Core.busRead`, wicked-core#631, core/bus.ts) — crew opens no SQLite of its own. The relay is a
+ * tap with its cursor in memory, starting at the newest row (`latest`). Nothing is lost that
+ * matters: the bus is the durable record and `GET /runs/:id/team` reads it back, so a restart needs
+ * no stored cursor.
+ *
+ * Posture: loud, non-fatal. A bus no engine holds → one log line and `null`; `/ws` then
+ * carries no team frames. A read that fails (the engine mid-checkpoint) is logged and retried on
+ * the next poll.
+ */
+import { tapBus } from '../core/bus.js';
+import { broadcast as broadcastToWs } from '../events/bus.js';
+/** The scope guard: only team rows are relayed. */
+const RELAY_FILTER = 'wicked.team.**';
+/** The ONE envelope type this relay puts on `/ws` (api-types `TeamEventFrame`). */
+export const TEAM_EVENT_FRAME = 'teamEvent';
+/** Arm the relay; `null` (logged) when the bus cannot be opened. */
+export async function startTeamWsRelay(opts) {
+    const log = opts.log ?? (() => undefined);
+    const send = opts.broadcast ?? broadcastToWs;
+    let lastError = null;
+    try {
+        return await tapBus({
+            dbPath: opts.dbPath,
+            filter: RELAY_FILTER,
+            pollIntervalMs: opts.pollIntervalMs ?? 2000,
+            handler: (event) => {
+                lastError = null;
+                const runId = event.payload?.run_id;
+                const projectId = typeof runId === 'string' ? opts.projectOf(runId) : undefined;
+                send({
+                    type: TEAM_EVENT_FRAME,
+                    event,
+                    ...(projectId !== undefined ? { project_id: projectId } : {}),
+                });
+            },
+            // A failed read (the engine mid-checkpoint) is retried on the next poll; said once per
+            // distinct failure, not once per poll.
+            onError: (err) => {
+                if (message(err) !== lastError)
+                    log(`[team-relay] bus read failed (retrying): ${message(err)}`);
+                lastError = message(err);
+            },
+        });
+    }
+    catch (err) {
+        log(`[team-relay] cannot read the bus at ${opts.dbPath} — /ws carries no teamEvent frames: ${message(err)}`);
+        return null;
+    }
+}
+function message(err) {
+    return err instanceof Error ? err.message : String(err);
+}
+//# sourceMappingURL=ws-relay.js.map

package/dist/team/ws-relay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ws-relay.js","sourceRoot":"","sources":["../../src/team/ws-relay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,SAAS,IAAI,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAG9D,mDAAmD;AACnD,MAAM,YAAY,GAAG,gBAAgB,CAAC;AAEtC,mFAAmF;AACnF,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAW,CAAC;AAkB5C,oEAAoE;AACpE,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAsB;IAC3D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAS,EAAE,CAAC,SAAS,CAAC,CAAC;IAChD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,IAAI,aAAa,CAAC;IAC7C,IAAI,SAAS,GAAkB,IAAI,CAAC;IACpC,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,CAAC;YAClB,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,MAAM,EAAE,YAAY;YACpB,cAAc,EAAE,IAAI,CAAC,cAAc,IAAI,IAAI;YAC3C,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;gBACjB,SAAS,GAAG,IAAI,CAAC;gBACjB,MAAM,KAAK,GAAI,KAAK,CAAC,OAAuC,EAAE,MAAM,CAAC;gBACrE,MAAM,SAAS,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;gBAChF,IAAI,CAAC;oBACH,IAAI,EAAE,gBAAgB;oBACtB,KAAK;oBACL,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACjD,CAAC,CAAC;YAClB,CAAC;YACD,uFAAuF;YACvF,uCAAuC;YACvC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;gBACf,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,SAAS;oBAAE,GAAG,CAAC,4CAA4C,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBAChG,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;YAC3B,CAAC;SACF,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,GAAG,CAAC,uCAAuC,IAAI,CAAC,MAAM,uCAAuC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC7G,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,OAAO,CAAC,GAAY;IAC3B,OAAO,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;AAC1D,CAAC"}