@cat-factory/contracts 0.285.0 → 0.287.0

package/dist/snapshot.js

@@ -298,22 +298,32 @@ export const workspaceSnapshotSchema = v.object({
      * (or absent → treated as 0) means an update is available. Static, workspace-independent;
      * built by the shared `WorkspaceService.snapshot()` (so it is automatically symmetric across
      * runtimes), but optional on the wire for forward-compatibility.
+     *
+     * OFFERED entries only: an INTERNAL pipeline is withheld here for the same reason it is withheld
+     * from `pipelines`. This map is not merely a version lookup — the health advisory reads its keys
+     * as the set of built-ins that EXIST, and derives "new built-ins available" as those keys minus
+     * the rows the SPA can see. An internal entry is in the first set and never in the second, so
+     * listing it would advertise a pipeline nobody may pick, permanently and un-dismissably.
      */
     pipelineCatalogVersions: v.optional(v.record(v.string(), v.number())),
     /**
-     * The catalog's own NAME for each id in `pipelineCatalogVersions`: the companion map, built from
-     * the same `seedPipelines()` read.
+     * The catalog's own NAME for each catalog id: the companion map, built from the same
+     * `seedPipelines()` read.
      *
-     * It exists for the one moment a catalog id has no stored row to read a name off: the "new
-     * built-ins available" advisory. Without it the SPA humanised the id, which is passable for a
-     * shipped built-in (`pl_review` → "review") and wrong for the case that made this reachable, a
+     * It exists for the moments a catalog id has no stored row to read a name off. The first is the
+     * "new built-ins available" advisory. Without it the SPA humanised the id, which is passable for
+     * a shipped built-in (`pl_review` → "review") and wrong for the case that made this reachable, a
      * deployment's own registered pipeline behind a reusable operation: `pl_org_introduce_api`
      * rendered as "org introduce api", offering the operation's pipeline under a name that appears
-     * nowhere else in the product.
+     * nowhere else in the product. The second is a task PINNED to an INTERNAL pipeline (the
+     * docs-refresh preset spawns onto one): the card that starts it has no library row to name.
+     *
+     * So this is a SUPERSET of `pipelineCatalogVersions` — a display dictionary for any catalog id
+     * the SPA may hold, where that map is the narrower "what may be offered". Do not index one by
+     * the other's keys; ask each for what it answers.
      *
      * A separate map rather than widening the versions record, because that record is a
-     * `Record<string, number>` the SPA compares numerically; the ids are identical by construction
-     * (one source, one pass), so a reader indexes either by the other's key.
+     * `Record<string, number>` the SPA compares numerically.
      */
     pipelineCatalogNames: v.optional(v.record(v.string(), v.string())),
     /**

package/dist/snapshot.js.map

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

package/dist/step-conditions.d.ts

@@ -0,0 +1,98 @@
+import * as v from 'valibot';
+/** The block `type` a service frame carries when it owns a rendered UI. */
+export declare const FRONTEND_BLOCK_TYPE = "frontend";
+/**
+ * Which half of a run's service scope a step needs:
+ *
+ *  - `frontend` — run only when the change touches a service declared as a frontend.
+ *  - `backend`  — run only when it touches a service that is NOT a frontend.
+ *
+ * A full-stack task (a frontend service plus an involved backend service, or vice versa) is in
+ * BOTH scopes, so a pipeline carrying both testers runs both on it.
+ */
+export declare const stepServiceScopeSchema: v.PicklistSchema<["frontend", "backend"], undefined>;
+export type StepServiceScope = v.InferOutput<typeof stepServiceScopeSchema>;
+/**
+ * A step's run condition: what has to be true of the run for this step to apply at all.
+ * Today the only axis is {@link stepServiceScopeSchema}; it is an OBJECT rather than a bare
+ * picklist so the next axis is a field beside it rather than a second per-step knob.
+ *
+ * Absent ⇒ unconditional, which is every step that does not declare one.
+ */
+export declare const stepRunConditionSchema: v.ObjectSchema<{
+    readonly serviceScope: v.PicklistSchema<["frontend", "backend"], undefined>;
+}, undefined>;
+export type StepRunCondition = v.InferOutput<typeof stepRunConditionSchema>;
+/**
+ * The service scope of a run: whether the services it may change include a frontend, a
+ * non-frontend, or both.
+ *
+ * BOTH FALSE is a real and distinct state — the run's services could not be resolved (a task
+ * outside any service frame) — and it is deliberately not spelled as an "unknown" flag, because
+ * every resolved frame contributes exactly one of the two: a scope with neither can only be an
+ * empty one. {@link stepConditionSatisfied} reads that state as "nothing to judge" and runs the
+ * step, the same fail-safe-to-thoroughness direction `onMissingEstimate: 'run'` takes.
+ *
+ * A MIXED scope (both halves true) is what this reduction exists to express, but no board state
+ * produces one today, and that is a property of the CONNECTION model rather than of this file: a
+ * run's frames are its own service frame plus the task's involved services, involved services must
+ * be connection neighbours, and only a `service`-type frame may declare a connection or be named as
+ * one (`serviceConnectionsError`, and the narrowing that drops the field on every other frame type).
+ * So a frontend frame has no neighbours in either direction, a frontend task can name no involved
+ * service, and every involved service is a non-frontend. Both halves stay because the reduction is
+ * the honest statement of "what does this run change" and it is the connection model, not this
+ * function, that would have to change to widen it. Do NOT re-derive the mixed case in a test by
+ * hand-building a board with a service connected to a frontend: that board cannot be saved.
+ */
+export interface RunServiceScope {
+    /** Some service in scope is declared `type: 'frontend'` — there is a UI to exercise. */
+    frontend: boolean;
+    /** Some service in scope is NOT a frontend — there is an API/service behind it. */
+    backend: boolean;
+}
+/**
+ * Reduce the service frames a run may change — its own service plus the task's involved
+ * services — into the {@link RunServiceScope} the step conditions read.
+ *
+ * Takes the FRAMES rather than the block, because "what does this run change" is the ancestry
+ * walk plus the involved-service resolution, and both already happen in the engine. Frames are
+ * deduped by the caller; passing the same frame twice changes nothing here.
+ */
+export declare function resolveRunServiceScope(frames: readonly {
+    type?: string | null;
+}[]): RunServiceScope;
+/**
+ * Why a run step finished as `skipped` rather than running — the three axes that can skip one,
+ * as a member the SPA maps to translated copy rather than prose the backend composed:
+ *
+ *  - `gated`      — the step's estimate gate was not met (the task scored below its thresholds).
+ *  - `condition`  — the step's {@link stepRunConditionSchema} did not match the run's service
+ *                   scope. The step still carries the condition, so a reader wanting the specific
+ *                   sentence ("no frontend in scope") reads `serviceScope` off it; this says only
+ *                   which axis fired, so the two can never disagree about the scope.
+ *  - `producer_skipped` — a COMPANION whose producer was itself skipped, so there is nothing for
+ *                   it to grade. Distinct from `gated` because the fix is different: the reader
+ *                   has to look at the producer, not at this step's own thresholds.
+ *  - `run_complete` — an earlier step ENDED the run (a `bug-intake` fire that found nothing to
+ *                   adopt), so everything after it was closed out untouched. Nothing about THIS
+ *                   step decided it, which is why it cannot borrow any of the three above.
+ *
+ * PERSISTED and CLOSED, so retiring a member does not remove it from stored runs: read it with
+ * {@link isStepSkipReason} and render an unrecognised value as "skipped" rather than crashing or
+ * guessing onto a current member.
+ */
+export declare const stepSkipReasonSchema: v.PicklistSchema<["gated", "condition", "producer_skipped", "run_complete"], undefined>;
+export type StepSkipReason = v.InferOutput<typeof stepSkipReasonSchema>;
+/**
+ * Narrow a persisted `skipReason` to a member this build still knows, DERIVED from the picklist's
+ * own options so adding a member cannot leave this behind. A stored run may name a member since
+ * retired, and a browser may hold a bundle older than the member it reads.
+ */
+export declare function isStepSkipReason(value: unknown): value is StepSkipReason;
+/**
+ * Whether a step carrying `condition` applies to a run of `scope`. An absent condition is
+ * unconditional; an unresolvable scope (see {@link RunServiceScope}) runs the step rather than
+ * silently dropping it.
+ */
+export declare function stepConditionSatisfied(condition: StepRunCondition | null | undefined, scope: RunServiceScope): boolean;
+//# sourceMappingURL=step-conditions.d.ts.map

package/dist/step-conditions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-conditions.d.ts","sourceRoot":"","sources":["../src/step-conditions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAuB5B,2EAA2E;AAC3E,eAAO,MAAM,mBAAmB,aAAa,CAAA;AAE7C;;;;;;;;GAQG;AACH,eAAO,MAAM,sBAAsB,sDAAsC,CAAA;AACzE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE3E;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB;;aAEjC,CAAA;AACF,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,sBAAsB,CAAC,CAAA;AAE3E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,eAAe;IAC9B,wFAAwF;IACxF,QAAQ,EAAE,OAAO,CAAA;IACjB,mFAAmF;IACnF,OAAO,EAAE,OAAO,CAAA;CACjB;AAED;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS;IAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,EAAE,GAC1C,eAAe,CAQjB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,oBAAoB,yFAK/B,CAAA;AACF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,WAAW,CAAC,OAAO,oBAAoB,CAAC,CAAA;AAEvE;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,cAAc,CAIxE;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,SAAS,EAAE,gBAAgB,GAAG,IAAI,GAAG,SAAS,EAC9C,KAAK,EAAE,eAAe,GACrB,OAAO,CAIT"}

package/dist/step-conditions.js

@@ -0,0 +1,109 @@
+import * as v from 'valibot';
+// ---------------------------------------------------------------------------
+// Per-step RUN CONDITIONS — the second axis on which a pipeline step can be
+// conditional, beside the task-estimate gating in `stepGatingSchema`.
+//
+// The two answer different questions and neither can express the other. Estimate
+// gating asks "is this task big enough to be worth the step", a judgement about
+// SIZE that only exists once a `task-estimator` has run. A run condition asks
+// "does this step apply to the kind of change this run makes at all", a fact about
+// the SERVICES the run touches that is knowable before the first dispatch and can
+// never be recovered from a score: a UI test on a task that changes no frontend is
+// not a cheap test, it is a test of nothing.
+//
+// The first case is the tester pair. A pipeline that wants both `tester-ui` and
+// `tester-api` should run the browser pass only where there is a UI in scope and
+// the API pass only where there is a service behind it — which is what lets ONE
+// build preset carry both testers and be right on a frontend task and on a backend
+// task, instead of the two near-identical presets it used to take. (A task in BOTH
+// scopes at once is what {@link RunServiceScope} would express; see the note there
+// for why no board state produces one yet.)
+// ---------------------------------------------------------------------------
+/** The block `type` a service frame carries when it owns a rendered UI. */
+export const FRONTEND_BLOCK_TYPE = 'frontend';
+/**
+ * Which half of a run's service scope a step needs:
+ *
+ *  - `frontend` — run only when the change touches a service declared as a frontend.
+ *  - `backend`  — run only when it touches a service that is NOT a frontend.
+ *
+ * A full-stack task (a frontend service plus an involved backend service, or vice versa) is in
+ * BOTH scopes, so a pipeline carrying both testers runs both on it.
+ */
+export const stepServiceScopeSchema = v.picklist(['frontend', 'backend']);
+/**
+ * A step's run condition: what has to be true of the run for this step to apply at all.
+ * Today the only axis is {@link stepServiceScopeSchema}; it is an OBJECT rather than a bare
+ * picklist so the next axis is a field beside it rather than a second per-step knob.
+ *
+ * Absent ⇒ unconditional, which is every step that does not declare one.
+ */
+export const stepRunConditionSchema = v.object({
+    serviceScope: stepServiceScopeSchema,
+});
+/**
+ * Reduce the service frames a run may change — its own service plus the task's involved
+ * services — into the {@link RunServiceScope} the step conditions read.
+ *
+ * Takes the FRAMES rather than the block, because "what does this run change" is the ancestry
+ * walk plus the involved-service resolution, and both already happen in the engine. Frames are
+ * deduped by the caller; passing the same frame twice changes nothing here.
+ */
+export function resolveRunServiceScope(frames) {
+    let frontend = false;
+    let backend = false;
+    for (const frame of frames) {
+        if (frame.type === FRONTEND_BLOCK_TYPE)
+            frontend = true;
+        else
+            backend = true;
+    }
+    return { frontend, backend };
+}
+/**
+ * Why a run step finished as `skipped` rather than running — the three axes that can skip one,
+ * as a member the SPA maps to translated copy rather than prose the backend composed:
+ *
+ *  - `gated`      — the step's estimate gate was not met (the task scored below its thresholds).
+ *  - `condition`  — the step's {@link stepRunConditionSchema} did not match the run's service
+ *                   scope. The step still carries the condition, so a reader wanting the specific
+ *                   sentence ("no frontend in scope") reads `serviceScope` off it; this says only
+ *                   which axis fired, so the two can never disagree about the scope.
+ *  - `producer_skipped` — a COMPANION whose producer was itself skipped, so there is nothing for
+ *                   it to grade. Distinct from `gated` because the fix is different: the reader
+ *                   has to look at the producer, not at this step's own thresholds.
+ *  - `run_complete` — an earlier step ENDED the run (a `bug-intake` fire that found nothing to
+ *                   adopt), so everything after it was closed out untouched. Nothing about THIS
+ *                   step decided it, which is why it cannot borrow any of the three above.
+ *
+ * PERSISTED and CLOSED, so retiring a member does not remove it from stored runs: read it with
+ * {@link isStepSkipReason} and render an unrecognised value as "skipped" rather than crashing or
+ * guessing onto a current member.
+ */
+export const stepSkipReasonSchema = v.picklist([
+    'gated',
+    'condition',
+    'producer_skipped',
+    'run_complete',
+]);
+/**
+ * Narrow a persisted `skipReason` to a member this build still knows, DERIVED from the picklist's
+ * own options so adding a member cannot leave this behind. A stored run may name a member since
+ * retired, and a browser may hold a bundle older than the member it reads.
+ */
+export function isStepSkipReason(value) {
+    return (typeof value === 'string' && stepSkipReasonSchema.options.includes(value));
+}
+/**
+ * Whether a step carrying `condition` applies to a run of `scope`. An absent condition is
+ * unconditional; an unresolvable scope (see {@link RunServiceScope}) runs the step rather than
+ * silently dropping it.
+ */
+export function stepConditionSatisfied(condition, scope) {
+    if (!condition)
+        return true;
+    if (!scope.frontend && !scope.backend)
+        return true;
+    return condition.serviceScope === 'frontend' ? scope.frontend : scope.backend;
+}
+//# sourceMappingURL=step-conditions.js.map

package/dist/step-conditions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-conditions.js","sourceRoot":"","sources":["../src/step-conditions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAA;AAE5B,8EAA8E;AAC9E,4EAA4E;AAC5E,sEAAsE;AACtE,EAAE;AACF,iFAAiF;AACjF,gFAAgF;AAChF,8EAA8E;AAC9E,mFAAmF;AACnF,kFAAkF;AAClF,mFAAmF;AACnF,6CAA6C;AAC7C,EAAE;AACF,gFAAgF;AAChF,iFAAiF;AACjF,gFAAgF;AAChF,mFAAmF;AACnF,mFAAmF;AACnF,mFAAmF;AACnF,4CAA4C;AAC5C,8EAA8E;AAE9E,2EAA2E;AAC3E,MAAM,CAAC,MAAM,mBAAmB,GAAG,UAAU,CAAA;AAE7C;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,UAAU,EAAE,SAAS,CAAC,CAAC,CAAA;AAGzE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,YAAY,EAAE,sBAAsB;CACrC,CAAC,CAAA;AA+BF;;;;;;;GAOG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAA2C;IAE3C,IAAI,QAAQ,GAAG,KAAK,CAAA;IACpB,IAAI,OAAO,GAAG,KAAK,CAAA;IACnB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,mBAAmB;YAAE,QAAQ,GAAG,IAAI,CAAA;;YAClD,OAAO,GAAG,IAAI,CAAA;IACrB,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAA;AAC9B,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC,QAAQ,CAAC;IAC7C,OAAO;IACP,WAAW;IACX,kBAAkB;IAClB,cAAc;CACf,CAAC,CAAA;AAGF;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ,IAAK,oBAAoB,CAAC,OAA6B,CAAC,QAAQ,CAAC,KAAK,CAAC,CACjG,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CACpC,SAA8C,EAC9C,KAAsB;IAEtB,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAA;IAC3B,IAAI,CAAC,KAAK,CAAC,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO;QAAE,OAAO,IAAI,CAAA;IAClD,OAAO,SAAS,CAAC,YAAY,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAA;AAC/E,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/contracts",
-  "version": "0.285.0",
+  "version": "0.287.0",
   "description": "Valibot wire contract shared between the Agent Architecture Board frontend and backend.",
   "repository": {
     "type": "git",