@cat-factory/contracts 0.240.0 → 0.242.0

package/dist/gate-config.d.ts

@@ -0,0 +1,134 @@
+import * as v from 'valibot';
+/**
+ * The most approvals one gate may demand. A bound rather than an open number because the quorum
+ * is counted against DISTINCT workspace identities: a pipeline asking for more approvers than a
+ * board plausibly has is a run that parks forever, and the author gets told at save time instead
+ * of discovering it mid-delivery.
+ */
+export declare const MAX_GATE_APPROVALS = 10;
+/**
+ * WHO may resolve a step's human approval gate (approve / request changes / reject).
+ *
+ * Both axes are ADDITIVE — an actor qualifies by holding a listed role OR by being a listed
+ * user — because the two express different intents ("any admin" vs "these two people") and a
+ * policy routinely wants both. An absent/empty policy means today's behaviour: anyone the
+ * workspace RBAC gate already admitted to write (member and above) may resolve the gate.
+ *
+ * This NARROWS the member tier; it never widens anything. A viewer still cannot resolve a gate
+ * (the RBAC write floor refuses the request before this is consulted), and a workspace `admin`
+ * is always permitted regardless of what the policy lists — an admin can cancel the run or edit
+ * the pipeline outright, so denying them here would buy no safety and would deadlock a run whose
+ * named approvers have left the board.
+ */
+export declare const gateApproverPolicySchema: v.ObjectSchema<{
+    /** Workspace roles whose holders may resolve the gate. Absent/empty ⇒ no role rule. */
+    readonly roles: v.OptionalSchema<v.ArraySchema<v.PicklistSchema<readonly ["admin", "member", "viewer"], undefined>, undefined>, undefined>;
+    /** Specific workspace members (`usr_*`) who may resolve the gate. Absent/empty ⇒ no user rule. */
+    readonly userIds: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+}, undefined>;
+export type GateApproverPolicy = v.InferOutput<typeof gateApproverPolicySchema>;
+/**
+ * A step's gate configuration, stored at `stepOptions[i].gateConfig`.
+ *
+ * Every field is optional and absent means the shipped default, so a pipeline that configures
+ * nothing persists no `gateConfig` at all and behaves exactly as it did before this existed.
+ */
+export declare const stepGateConfigSchema: v.ObjectSchema<{
+    /**
+     * Who may resolve this step's human approval gate. Ignored (and refused at pipeline save) on a
+     * step that carries no approval gate — a policy on an ungated step reads as a checkpoint that
+     * silently does not exist.
+     */
+    readonly approvers: v.OptionalSchema<v.ObjectSchema<{
+        /** Workspace roles whose holders may resolve the gate. Absent/empty ⇒ no role rule. */
+        readonly roles: v.OptionalSchema<v.ArraySchema<v.PicklistSchema<readonly ["admin", "member", "viewer"], undefined>, undefined>, undefined>;
+        /** Specific workspace members (`usr_*`) who may resolve the gate. Absent/empty ⇒ no user rule. */
+        readonly userIds: v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>;
+    }, undefined>, undefined>;
+    /**
+     * How many DISTINCT permitted approvals the gate needs before the run advances. Absent ⇒ 1
+     * (today's behaviour). Each approval is recorded on the gate; a second approval from the same
+     * identity replaces the first rather than counting twice.
+     *
+     * A quorum above 1 needs identities to count, so it is only meaningful on a deployment with
+     * authentication enabled: with auth off every caller is the same unattributed actor and the
+     * gate would never reach two.
+     */
+    readonly minApprovals: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 10, undefined>]>, undefined>;
+    /**
+     * The step's parameters for its own REGISTERED gate kind (a `ci` / `conflicts` /
+     * `post-release-health` step, or a deployment's own gate), validated at pipeline save and at
+     * run start against the descriptor fields that gate registered. Threaded onto the live gate
+     * state, so a gate reads its knobs off the STEP instead of the engine or the workspace merge
+     * preset.
+     *
+     * Refused at save on a step whose kind registers no gate, and on a field the gate does not
+     * declare: an unread key is indistinguishable from a typo'd one, and both look to whoever
+     * typed them like configuration that took effect.
+     */
+    readonly fields: v.OptionalSchema<v.RecordSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 80, undefined>]>, v.UnionSchema<[v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>, v.MaxLengthAction<string[], 50, undefined>]>, v.BooleanSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>, undefined>;
+}, undefined>;
+export type StepGateConfig = v.InferOutput<typeof stepGateConfigSchema>;
+/**
+ * A registered gate's own config form, as projected to the SPA on the workspace snapshot: the
+ * gate's step `kind` plus the descriptor fields it declared. The pipeline builder renders these
+ * through the SAME `DescriptorFields` component every other descriptor form uses, so a
+ * deployment's gate gets an authoring form with no frontend change — the "ambient" half of the
+ * per-step gate config.
+ *
+ * Absent from the snapshot when no registered gate declares any fields, so the stock product
+ * carries nothing.
+ */
+export declare const gateConfigFormSchema: v.ObjectSchema<{
+    /** The step `agentKind` this gate is registered for. */
+    readonly kind: v.StringSchema<undefined>;
+    /** The gate's declared parameters (deployment-authored English labels, rendered verbatim). */
+    readonly fields: v.ArraySchema<v.ObjectSchema<{
+        readonly key: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 80, undefined>]>;
+        readonly label: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>;
+        readonly help: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 300, undefined>]>, undefined>;
+        readonly placeholder: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 200, undefined>]>, undefined>;
+        readonly required: v.OptionalSchema<v.BooleanSchema<undefined>, undefined>;
+        readonly options: v.OptionalSchema<v.ArraySchema<v.ObjectSchema<{
+            readonly value: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>;
+            readonly label: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 120, undefined>]>;
+        }, undefined>, undefined>, undefined>;
+        readonly default: v.OptionalSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>;
+        readonly defaultValues: v.OptionalSchema<v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>, v.MaxLengthAction<string[], 50, undefined>]>, undefined>;
+        readonly showWhen: v.OptionalSchema<v.ObjectSchema<{
+            readonly key: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>]>;
+            readonly equals: v.OptionalSchema<v.UnionSchema<[v.StringSchema<undefined>, v.BooleanSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>;
+            readonly includes: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+        }, undefined>, undefined>;
+        readonly maxLength: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 2000, undefined>]>, undefined>;
+        readonly min: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly max: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly type: v.OptionalSchema<v.PicklistSchema<["text", "password", "select", "number", "checkbox", "textarea", "checkbox-group", "path"], undefined>, undefined>;
+    }, undefined>, undefined>;
+}, undefined>;
+export type GateConfigForm = v.InferOutput<typeof gateConfigFormSchema>;
+/**
+ * One recorded approval on a gate: who cleared it and when. Kept as a list rather than a count
+ * so a quorum can be counted against DISTINCT identities (re-clicking approve is idempotent) and
+ * so the run detail can name the people who signed off rather than showing an anonymous tally.
+ *
+ * `actorId` is a `usr_*` id for a signed-in person, the public-API key id for an integration, and
+ * {@link UNATTRIBUTED_GATE_ACTOR} on a deployment running with auth disabled — three cases the
+ * quorum treats identically (one slot each) and the UI labels differently.
+ */
+export declare const gateApprovalRecordSchema: v.ObjectSchema<{
+    readonly actorId: v.StringSchema<undefined>;
+    /** Display label snapshotted at approval time (login/name, or the key's label). */
+    readonly actorLabel: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
+    /** Epoch ms the approval was recorded. */
+    readonly at: v.NumberSchema<undefined>;
+}, undefined>;
+export type GateApprovalRecord = v.InferOutput<typeof gateApprovalRecordSchema>;
+/**
+ * The actor id recorded when a deployment resolves a gate with no workspace identity behind the
+ * request (auth disabled). Named rather than an empty string so a reader can tell "nobody was
+ * signed in" from "the field was never written", and so every such approval collapses onto ONE
+ * quorum slot instead of silently satisfying a multi-approver gate.
+ */
+export declare const UNATTRIBUTED_GATE_ACTOR = "unattributed";
+//# sourceMappingURL=gate-config.d.ts.map

package/dist/gate-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate-config.d.ts","sourceRoot":"","sources":["../src/gate-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAiC5B;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,KAAK,CAAA;AAEpC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,wBAAwB;IACnC,uFAAuF;;IAEvF,kGAAkG;;aAElG,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAE/E;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;IAC/B;;;;OAIG;;QAlBH,uFAAuF;;QAEvF,kGAAkG;;;IAkBlG;;;;;;;;OAQG;;IAIH;;;;;;;;;;OAUG;;aAEH,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEvE;;;;;;;;;GASG;AACH,eAAO,MAAM,oBAAoB;IAC/B,wDAAwD;;IAExD,8FAA8F;;;;;;;;;;;;;;;;;;;;;;;aAE9F,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEvE;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB;;IAEnC,mFAAmF;;IAEnF,0CAA0C;;aAE1C,CAAA;AACF,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,wBAAwB,CAAC,CAAA;AAE/E;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,iBAAiB,CAAA"}

package/dist/gate-config.js

@@ -0,0 +1,134 @@
+import * as v from 'valibot';
+import { descriptorFieldSchema, descriptorFieldValuesSchema } from './form-fields.js';
+import { workspaceRoleSchema } from './workspace-members.js';
+// ---------------------------------------------------------------------------
+// PER-STEP GATE CONFIGURATION.
+//
+// A pipeline's human checkpoints were a bare `gates: boolean[]` — the step either paused for
+// "a human" or it did not. There was nowhere to say WHICH humans, HOW MANY of them, or what a
+// registered gate's own knobs should be for THIS step, so every gate's parameters had to be
+// hard-coded in the engine (or lifted into the workspace-wide merge preset, which is the wrong
+// grain: a preset is per task, a gate is per step).
+//
+// This module is the config that rides beside the flag, on the extensible `StepOptions` bag
+// (`stepOptions[i].gateConfig`), so it needs no column and no migration. It carries two
+// deliberately different halves:
+//
+//   - The PLATFORM-ENFORCED half ({@link gateApproverPolicySchema} + `minApprovals`). Who may
+//     resolve the step's human approval gate, and how many distinct approvals advance the run.
+//     Typed here rather than left opaque because the BACKEND enforces it and the SPA renders
+//     it: both have to agree about what an approver set means.
+//   - The GATE-DECLARED half (`fields`). A bag validated against the descriptor form the gate
+//     itself registered (`GateRegistry.register(kind, factory, { configFields })`), so a
+//     deployment's own gate carries its own parameters without the platform learning them.
+//     This is the "ambient" part: the authoring form, the validation and the runtime all derive
+//     from that ONE declaration. It rides the repo's existing descriptor-form vocabulary
+//     (`form-fields.ts`) rather than a gate-only schema language, so a gate's config form is
+//     collected, validated, frozen and rendered by exactly the machinery an initiative preset's
+//     form and a custom task type's brief already use.
+//
+// Design record: `backend/docs/adr/0038-per-step-gate-config.md`.
+// ---------------------------------------------------------------------------
+/**
+ * The most approvals one gate may demand. A bound rather than an open number because the quorum
+ * is counted against DISTINCT workspace identities: a pipeline asking for more approvers than a
+ * board plausibly has is a run that parks forever, and the author gets told at save time instead
+ * of discovering it mid-delivery.
+ */
+export const MAX_GATE_APPROVALS = 10;
+/**
+ * WHO may resolve a step's human approval gate (approve / request changes / reject).
+ *
+ * Both axes are ADDITIVE — an actor qualifies by holding a listed role OR by being a listed
+ * user — because the two express different intents ("any admin" vs "these two people") and a
+ * policy routinely wants both. An absent/empty policy means today's behaviour: anyone the
+ * workspace RBAC gate already admitted to write (member and above) may resolve the gate.
+ *
+ * This NARROWS the member tier; it never widens anything. A viewer still cannot resolve a gate
+ * (the RBAC write floor refuses the request before this is consulted), and a workspace `admin`
+ * is always permitted regardless of what the policy lists — an admin can cancel the run or edit
+ * the pipeline outright, so denying them here would buy no safety and would deadlock a run whose
+ * named approvers have left the board.
+ */
+export const gateApproverPolicySchema = v.object({
+    /** Workspace roles whose holders may resolve the gate. Absent/empty ⇒ no role rule. */
+    roles: v.optional(v.array(workspaceRoleSchema)),
+    /** Specific workspace members (`usr_*`) who may resolve the gate. Absent/empty ⇒ no user rule. */
+    userIds: v.optional(v.array(v.string())),
+});
+/**
+ * A step's gate configuration, stored at `stepOptions[i].gateConfig`.
+ *
+ * Every field is optional and absent means the shipped default, so a pipeline that configures
+ * nothing persists no `gateConfig` at all and behaves exactly as it did before this existed.
+ */
+export const stepGateConfigSchema = v.object({
+    /**
+     * Who may resolve this step's human approval gate. Ignored (and refused at pipeline save) on a
+     * step that carries no approval gate — a policy on an ungated step reads as a checkpoint that
+     * silently does not exist.
+     */
+    approvers: v.optional(gateApproverPolicySchema),
+    /**
+     * How many DISTINCT permitted approvals the gate needs before the run advances. Absent ⇒ 1
+     * (today's behaviour). Each approval is recorded on the gate; a second approval from the same
+     * identity replaces the first rather than counting twice.
+     *
+     * A quorum above 1 needs identities to count, so it is only meaningful on a deployment with
+     * authentication enabled: with auth off every caller is the same unattributed actor and the
+     * gate would never reach two.
+     */
+    minApprovals: v.optional(v.pipe(v.number(), v.integer(), v.minValue(1), v.maxValue(MAX_GATE_APPROVALS))),
+    /**
+     * The step's parameters for its own REGISTERED gate kind (a `ci` / `conflicts` /
+     * `post-release-health` step, or a deployment's own gate), validated at pipeline save and at
+     * run start against the descriptor fields that gate registered. Threaded onto the live gate
+     * state, so a gate reads its knobs off the STEP instead of the engine or the workspace merge
+     * preset.
+     *
+     * Refused at save on a step whose kind registers no gate, and on a field the gate does not
+     * declare: an unread key is indistinguishable from a typo'd one, and both look to whoever
+     * typed them like configuration that took effect.
+     */
+    fields: v.optional(descriptorFieldValuesSchema),
+});
+/**
+ * A registered gate's own config form, as projected to the SPA on the workspace snapshot: the
+ * gate's step `kind` plus the descriptor fields it declared. The pipeline builder renders these
+ * through the SAME `DescriptorFields` component every other descriptor form uses, so a
+ * deployment's gate gets an authoring form with no frontend change — the "ambient" half of the
+ * per-step gate config.
+ *
+ * Absent from the snapshot when no registered gate declares any fields, so the stock product
+ * carries nothing.
+ */
+export const gateConfigFormSchema = v.object({
+    /** The step `agentKind` this gate is registered for. */
+    kind: v.string(),
+    /** The gate's declared parameters (deployment-authored English labels, rendered verbatim). */
+    fields: v.array(descriptorFieldSchema),
+});
+/**
+ * One recorded approval on a gate: who cleared it and when. Kept as a list rather than a count
+ * so a quorum can be counted against DISTINCT identities (re-clicking approve is idempotent) and
+ * so the run detail can name the people who signed off rather than showing an anonymous tally.
+ *
+ * `actorId` is a `usr_*` id for a signed-in person, the public-API key id for an integration, and
+ * {@link UNATTRIBUTED_GATE_ACTOR} on a deployment running with auth disabled — three cases the
+ * quorum treats identically (one slot each) and the UI labels differently.
+ */
+export const gateApprovalRecordSchema = v.object({
+    actorId: v.string(),
+    /** Display label snapshotted at approval time (login/name, or the key's label). */
+    actorLabel: v.optional(v.string()),
+    /** Epoch ms the approval was recorded. */
+    at: v.number(),
+});
+/**
+ * The actor id recorded when a deployment resolves a gate with no workspace identity behind the
+ * request (auth disabled). Named rather than an empty string so a reader can tell "nobody was
+ * signed in" from "the field was never written", and so every such approval collapses onto ONE
+ * quorum slot instead of silently satisfying a multi-approver gate.
+ */
+export const UNATTRIBUTED_GATE_ACTOR = 'unattributed';
+//# sourceMappingURL=gate-config.js.map

package/dist/gate-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gate-config.js","sourceRoot":"","sources":["../src/gate-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAC5B,OAAO,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,kBAAkB,CAAA;AACrF,OAAO,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAE5D,8EAA8E;AAC9E,+BAA+B;AAC/B,EAAE;AACF,6FAA6F;AAC7F,8FAA8F;AAC9F,4FAA4F;AAC5F,+FAA+F;AAC/F,oDAAoD;AACpD,EAAE;AACF,4FAA4F;AAC5F,wFAAwF;AACxF,iCAAiC;AACjC,EAAE;AACF,8FAA8F;AAC9F,+FAA+F;AAC/F,6FAA6F;AAC7F,+DAA+D;AAC/D,8FAA8F;AAC9F,yFAAyF;AACzF,2FAA2F;AAC3F,gGAAgG;AAChG,yFAAyF;AACzF,6FAA6F;AAC7F,gGAAgG;AAChG,uDAAuD;AACvD,EAAE;AACF,kEAAkE;AAClE,8EAA8E;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAA;AAEpC;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,uFAAuF;IACvF,KAAK,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;IAC/C,kGAAkG;IAClG,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;CACzC,CAAC,CAAA;AAGF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C;;;;OAIG;IACH,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,wBAAwB,CAAC;IAC/C;;;;;;;;OAQG;IACH,YAAY,EAAE,CAAC,CAAC,QAAQ,CACtB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAC/E;IACD;;;;;;;;;;OAUG;IACH,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,2BAA2B,CAAC;CAChD,CAAC,CAAA;AAGF;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC3C,wDAAwD;IACxD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,8FAA8F;IAC9F,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,qBAAqB,CAAC;CACvC,CAAC,CAAA;AAGF;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,mFAAmF;IACnF,UAAU,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAClC,0CAA0C;IAC1C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;CACf,CAAC,CAAA;AAGF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,cAAc,CAAA"}

package/dist/gate.d.ts

@@ -114,6 +114,16 @@ export declare const gateStepStateSchema: v.ObjectSchema<{
      * (failing → a helper is fixing) vs idle-passing. Set on every probe.
      */
     readonly lastVerdict: v.OptionalSchema<v.NullableSchema<v.PicklistSchema<["pass", "pending", "fail"], undefined>, undefined>, undefined>;
+    /**
+     * The step's own parameters for this gate (`stepOptions.gateConfig.fields`), copied onto the
+     * gate state ONCE on first entry alongside `maxAttempts` and validated, before it got here,
+     * against the descriptor fields the gate registered. This is how a gate reads a knob off the
+     * STEP rather than off the engine or the workspace-wide merge preset: `probe` receives the live
+     * gate state, so a registered gate reads `gateState.config` with no new plumbing per parameter.
+     *
+     * Absent ⇒ the gate's shipped defaults (which for the built-ins means the preset's values).
+     */
+    readonly config: v.OptionalSchema<v.NullableSchema<v.RecordSchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MinLengthAction<string, 1, undefined>, v.MaxLengthAction<string, 80, undefined>]>, v.UnionSchema<[v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, v.SchemaWithPipe<readonly [v.ArraySchema<v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.MaxLengthAction<string, 2000, undefined>]>, undefined>, v.MaxLengthAction<string[], 50, undefined>]>, v.BooleanSchema<undefined>, v.NumberSchema<undefined>], undefined>, undefined>, undefined>, undefined>;
     /**
      * Human-readable summary of the latest failing precheck (the failing CI checks /
      * the conflict reason) — the conclusion detail that used to be fed only to the

package/dist/gate.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../src/gate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAa5B;;;;;;;;;;;GAWG;AACH,2EAA2E;AAC3E,eAAO,MAAM,sBAAsB;;IAEjC,kFAAkF;;IAElF;;;OAGG;;IAEH;;;OAGG;;aAEH,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE3E;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;IAC5B,yFAAyF;;IAEzF,6CAA6C;;IAE7C;;;;;;OAMG;;IAEH,gEAAgE;;IAEhE;;;;;;;;OAQG;;IAEH;;;;;OAKG;;;QAlDH,kFAAkF;;QAElF;;;WAGG;;QAEH;;;WAGG;;;IA0CH,2FAA2F;;aAE3F,CAAA;AACF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAEjE,eAAO,MAAM,mBAAmB;;IAE9B,kEAAkE;;IAElE,gFAAgF;;IAEhF,gGAAgG;;IAEhG;;;;;OAKG;;IAEH;;;;;OAKG;;;;;;IAUH;;;OAGG;;IAEH;;;;;OAKG;;IAEH;;;;OAIG;;;QAvGH,kFAAkF;;QAElF;;;WAGG;;QAEH;;;WAGG;;;IA+FH;;;;;;OAMG;;IAEH;;;;;;OAMG;;IAEH;;;;;OAKG;;IAEH;;;;;;OAMG;;;;;;;;IAEH;;;;;OAKG;;QAxHH,yFAAyF;;QAEzF,6CAA6C;;QAE7C;;;;;;WAMG;;QAEH,gEAAgE;;QAEhE;;;;;;;;WAQG;;QAEH;;;;;WAKG;;;YAlDH,kFAAkF;;YAElF;;;eAGG;;YAEH;;;eAGG;;;QA0CH,2FAA2F;;;IA4F3F;;;;;OAKG;;IAEH;;;;;;OAMG;;IAEH;;;;OAIG;;IAEH;;;;;;OAMG;;IAEH;;;;;OAKG;;IAEH;;;;OAIG;;;;;aASH,CAAA;AACF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,mBAAmB,CAAC,CAAA"}
+{"version":3,"file":"gate.d.ts","sourceRoot":"","sources":["../src/gate.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAc5B;;;;;;;;;;;GAWG;AACH,2EAA2E;AAC3E,eAAO,MAAM,sBAAsB;;IAEjC,kFAAkF;;IAElF;;;OAGG;;IAEH;;;OAGG;;aAEH,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE3E;;;;GAIG;AACH,eAAO,MAAM,iBAAiB;IAC5B,yFAAyF;;IAEzF,6CAA6C;;IAE7C;;;;;;OAMG;;IAEH,gEAAgE;;IAEhE;;;;;;;;OAQG;;IAEH;;;;;OAKG;;;QAlDH,kFAAkF;;QAElF;;;WAGG;;QAEH;;;WAGG;;;IA0CH,2FAA2F;;aAE3F,CAAA;AACF,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,iBAAiB,CAAC,CAAA;AAEjE,eAAO,MAAM,mBAAmB;;IAE9B,kEAAkE;;IAElE,gFAAgF;;IAEhF,gGAAgG;;IAEhG;;;;;OAKG;;IAEH;;;;;OAKG;;;;;;IAUH;;;OAGG;;IAEH;;;;;;;;OAQG;;IAEH;;;;;OAKG;;IAEH;;;;OAIG;;;QAjHH,kFAAkF;;QAElF;;;WAGG;;QAEH;;;WAGG;;;IAyGH;;;;;;OAMG;;IAEH;;;;;;OAMG;;IAEH;;;;;OAKG;;IAEH;;;;;;OAMG;;;;;;;;IAEH;;;;;OAKG;;QAlIH,yFAAyF;;QAEzF,6CAA6C;;QAE7C;;;;;;WAMG;;QAEH,gEAAgE;;QAEhE;;;;;;;;WAQG;;QAEH;;;;;WAKG;;;YAlDH,kFAAkF;;YAElF;;;eAGG;;YAEH;;;eAGG;;;QA0CH,2FAA2F;;;IAsG3F;;;;;OAKG;;IAEH;;;;;;OAMG;;IAEH;;;;OAIG;;IAEH;;;;;;OAMG;;IAEH;;;;;OAKG;;IAEH;;;;OAIG;;;;;aASH,CAAA;AACF,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,mBAAmB,CAAC,CAAA"}

package/dist/gate.js

@@ -1,4 +1,5 @@
 import * as v from 'valibot';
+import { descriptorFieldValuesSchema } from './form-fields.js';
 import { releaseSignalSchema } from './release.js';
 // ---------------------------------------------------------------------------
 // Polling-GATE step state — the live loop state a `ci` / `conflicts` /
@@ -108,6 +109,16 @@ export const gateStepStateSchema = v.object({
      * (failing → a helper is fixing) vs idle-passing. Set on every probe.
      */
     lastVerdict: v.optional(v.nullable(v.picklist(['pass', 'pending', 'fail']))),
+    /**
+     * The step's own parameters for this gate (`stepOptions.gateConfig.fields`), copied onto the
+     * gate state ONCE on first entry alongside `maxAttempts` and validated, before it got here,
+     * against the descriptor fields the gate registered. This is how a gate reads a knob off the
+     * STEP rather than off the engine or the workspace-wide merge preset: `probe` receives the live
+     * gate state, so a registered gate reads `gateState.config` with no new plumbing per parameter.
+     *
+     * Absent ⇒ the gate's shipped defaults (which for the built-ins means the preset's values).
+     */
+    config: v.optional(v.nullable(descriptorFieldValuesSchema)),
     /**
      * Human-readable summary of the latest failing precheck (the failing CI checks /
      * the conflict reason) — the conclusion detail that used to be fed only to the

package/dist/gate.js.map

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

package/dist/index.d.ts

@@ -5,6 +5,8 @@ export * from './entities.js';
 export * from './agent-failure-kinds.js';
 export * from './execution.js';
 export * from './step-decisions.js';
+export * from './gate-config.js';
+export * from './gate-approval.js';
 export * from './run-provenance.js';
 export * from './input-gate.js';
 export * from './human-verdict-gates.js';
@@ -103,6 +105,7 @@ export * from './vendor-credentials.js';
 export * from './api-keys.js';
 export * from './public-api-keys.js';
 export * from './public-api.js';
+export * from './public-evidence.js';
 export * from './debug-api.js';
 export * from './public-decisions.js';
 export * from './notification-webhooks.js';

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -5,6 +5,8 @@ export * from './entities.js';
 export * from './agent-failure-kinds.js';
 export * from './execution.js';
 export * from './step-decisions.js';
+export * from './gate-config.js';
+export * from './gate-approval.js';
 export * from './run-provenance.js';
 export * from './input-gate.js';
 export * from './human-verdict-gates.js';
@@ -103,6 +105,7 @@ export * from './vendor-credentials.js';
 export * from './api-keys.js';
 export * from './public-api-keys.js';
 export * from './public-api.js';
+export * from './public-evidence.js';
 export * from './debug-api.js';
 export * from './public-decisions.js';
 export * from './notification-webhooks.js';

package/dist/index.js.map

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

package/dist/initiative-preset.d.ts

@@ -34,6 +34,8 @@ export declare const initiativePresetFieldSchema: v.ObjectSchema<{
         readonly includes: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
     }, undefined>, undefined>;
     readonly maxLength: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 2000, undefined>]>, undefined>;
+    readonly min: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+    readonly max: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
     /** Field type; absent is treated as `text`. */
     readonly type: v.OptionalSchema<v.PicklistSchema<["text", "password", "select", "number", "checkbox", "textarea", "checkbox-group", "path"], undefined>, undefined>;
 }, undefined>;
@@ -153,6 +155,8 @@ export declare const initiativePresetDescriptorSchema: v.ObjectSchema<{
             readonly includes: v.OptionalSchema<v.StringSchema<undefined>, undefined>;
         }, undefined>, undefined>;
         readonly maxLength: v.OptionalSchema<v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.IntegerAction<number, undefined>, v.MinValueAction<number, 1, undefined>, v.MaxValueAction<number, 2000, undefined>]>, undefined>;
+        readonly min: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
+        readonly max: v.OptionalSchema<v.NumberSchema<undefined>, undefined>;
         /** Field type; absent is treated as `text`. */
         readonly type: v.OptionalSchema<v.PicklistSchema<["text", "password", "select", "number", "checkbox", "textarea", "checkbox-group", "path"], undefined>, undefined>;
     }, undefined>, undefined>;

package/dist/initiative-preset.d.ts.map

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

package/dist/observability.d.ts

@@ -603,12 +603,19 @@ export declare const agentToolCallSchema: v.ObjectSchema<{
     readonly agentKind: v.StringSchema<undefined>;
     /**
      * The dispatch (container job) the call was made in. One run's step can dispatch more
-     * than once (a re-run, a gate's fixer rounds, a Ralph iteration), and {@link seq} is
-     * only monotonic WITHIN a dispatch, so the trajectory orders by `(jobId, seq)` — never
-     * by `seq` alone, which would interleave two dispatches into one nonsensical sequence.
+     * than once (a re-run, a gate's fixer rounds, a Ralph iteration), so this is what
+     * narrows a read to ONE of them. It is NOT a sort key: a job id is a string
+     * (`<executionId>-<agentKind>`, plus `-<epoch>` past the first dispatch), so ordering by
+     * it sorts a run's dispatches by agent-kind spelling and its re-runs `-10` before `-2`.
+     * The trajectory orders by `(startedAt, seq, id)` server-side; see the
+     * `AgentToolCallRepository.listByExecution` contract in kernel.
      */
     readonly jobId: v.StringSchema<undefined>;
-    /** The call's 0-based ordinal within its dispatch: the trajectory order itself. */
+    /**
+     * The call's 0-based ordinal within its dispatch. It restarts at zero on every dispatch,
+     * so it separates the calls sharing a {@link startedAt} millisecond rather than ordering
+     * the run on its own.
+     */
     readonly seq: v.NumberSchema<undefined>;
     /** The tool the agent invoked (`edit_file`, `bash`, `todo`, …). */
     readonly tool: v.StringSchema<undefined>;

package/dist/observability.d.ts.map

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

package/dist/observability.js

@@ -405,12 +405,19 @@ export const agentToolCallSchema = v.object({
     agentKind: v.string(),
     /**
      * The dispatch (container job) the call was made in. One run's step can dispatch more
-     * than once (a re-run, a gate's fixer rounds, a Ralph iteration), and {@link seq} is
-     * only monotonic WITHIN a dispatch, so the trajectory orders by `(jobId, seq)` — never
-     * by `seq` alone, which would interleave two dispatches into one nonsensical sequence.
+     * than once (a re-run, a gate's fixer rounds, a Ralph iteration), so this is what
+     * narrows a read to ONE of them. It is NOT a sort key: a job id is a string
+     * (`<executionId>-<agentKind>`, plus `-<epoch>` past the first dispatch), so ordering by
+     * it sorts a run's dispatches by agent-kind spelling and its re-runs `-10` before `-2`.
+     * The trajectory orders by `(startedAt, seq, id)` server-side; see the
+     * `AgentToolCallRepository.listByExecution` contract in kernel.
      */
     jobId: v.string(),
-    /** The call's 0-based ordinal within its dispatch: the trajectory order itself. */
+    /**
+     * The call's 0-based ordinal within its dispatch. It restarts at zero on every dispatch,
+     * so it separates the calls sharing a {@link startedAt} millisecond rather than ordering
+     * the run on its own.
+     */
     seq: v.number(),
     /** The tool the agent invoked (`edit_file`, `bash`, `todo`, …). */
     tool: v.string(),