@cat-factory/orchestration 0.172.1 → 0.174.0

package/dist/modules/pipelines/pipelineShape.d.ts

@@ -1,4 +1,5 @@
 import type { PipelineAvailability, StepGating, StepOptions, TesterQualityConfig } from '@cat-factory/kernel';
+import type { AgentKindRegistry } from '@cat-factory/agents';
 /**
  * How a run was LAUNCHED, threaded into {@link ExecutionService.start} so the launch-constraint
  * gate can reject a `'manual'` start of a `'recurring'`-only pipeline (and vice versa). A retry
@@ -34,21 +35,40 @@ export declare function pipelineHasEnabledBugIntake(agentKinds: string[], enable
  *    validation enforces exactly that adjacency: a companion's nearest preceding enabled step
  *    must be one of its targets. (The engine still reviews the nearest preceding target, but
  *    that target is now guaranteed to be the immediate predecessor.)
- *  - {@link assertValidGating}: a step gated on the task estimate must be a companion (the
- *    only kind it is safe to skip — skipping a producer would starve its downstream steps),
- *    must set at least one axis threshold (or it would always skip), and needs a
- *    `task-estimator` to have run before it (or the gate has nothing to consult).
+ *  - {@link assertValidGating}: a step gated on the task estimate must declare itself GATABLE
+ *    (`isGatableKind` — a kind whose output later steps read as context rather than depend on
+ *    structurally), must not also carry a human approval gate, must set at least one axis
+ *    threshold (or it would always skip), and needs a `task-estimator` to have run before it (or
+ *    the gate has nothing to consult).
  *  - {@link assertValidTesterQualityGating}: the test quality-control companion's optional
  *    estimate gate lives on the Tester step itself (not a companion row), so it is validated
  *    separately — but under the same "threshold set + estimator earlier" rules, since a
  *    QC gate with no estimator would silently never gate.
+ *
+ * Each check takes the whole shape rather than the two or three arrays it happens to read today:
+ * the gating check needed `gates` + the kind registry after the estimate-gating rules were
+ * generalised past companions, and threading those as further positional parameters through one
+ * of four otherwise-similar signatures is how these drift apart.
  */
 export interface PipelineShape {
     agentKinds: string[];
     enabled?: boolean[];
+    /**
+     * The per-step HUMAN approval gate flags. Read by {@link assertValidGating} to refuse a step
+     * that carries both a human gate and an estimate gate — the estimate may ADD a human
+     * checkpoint, never cancel one a pipeline author asked for.
+     */
+    gates?: boolean[];
     gating?: (StepGating | null)[];
     testerQuality?: (TesterQualityConfig | null)[];
     stepOptions?: (StepOptions | null)[];
+    /**
+     * The app-owned agent-kind registry, so a DEPLOYMENT-registered kind's own `gatable` flag is
+     * honoured. Absent ⇒ built-in kinds only, which is correct for a caller validating a built-in
+     * catalog (the kernel seed test) but would wrongly refuse a registered gatable kind at a
+     * boundary that has the registry — so both real boundaries (builder save, run start) pass it.
+     */
+    agentKindRegistry?: AgentKindRegistry;
 }
 export declare function validatePipelineShape(pipeline: PipelineShape): void;
 /**
@@ -58,7 +78,7 @@ export declare function validatePipelineShape(pipeline: PipelineShape): void;
  * since both boundaries share this validation) rather than failing deep in dispatch. A DISABLED
  * skill step never runs, so it imposes no requirement.
  */
-export declare function assertValidSkillSteps(agentKinds: string[], enabled?: boolean[], stepOptions?: (StepOptions | null)[]): void;
+export declare function assertValidSkillSteps({ agentKinds, enabled, stepOptions }: PipelineShape): void;
 /**
  * A companion step is only valid when the step IMMEDIATELY before it (over the enabled
  * subset) produces output it is allowed to review (a step whose kind is in the companion's
@@ -68,23 +88,35 @@ export declare function assertValidSkillSteps(agentKinds: string[], enabled?: bo
  * producer and its companion". Companions are surfaced in the builder as toggles attached to
  * their producer and run immediately after it, so adjacency is required.
  */
-export declare function assertValidCompanionPlacement(agentKinds: string[], enabled?: boolean[]): void;
+export declare function assertValidCompanionPlacement({ agentKinds, enabled }: PipelineShape): void;
 /**
  * Validate every ENABLED step that carries enabled estimate gating. A disabled gated step
- * never runs, so it imposes no requirement; an enabled one must satisfy all three rules:
+ * never runs, so it imposes no requirement; an enabled one must satisfy all four rules:
+ *
+ *  1. The gated step's kind must be GATABLE ({@link isGatableKind}). Gating means "skip this
+ *     step when the task is light", which is safe for a kind whose output later steps read as
+ *     CONTEXT (a design proposal, a research note, an extra verification pass) and unsafe for one
+ *     some other mechanism reads STRUCTURALLY — `merger` (whose mere presence in `instance.steps`
+ *     is what makes a committing kind deliver via a PR), `deployer` (which provisions the
+ *     environment its consumer reads), `conflicts`/`ci` (the guards), `bug-intake` (the run's
+ *     subject). Gatability is declared per kind rather than derived from a category, because the
+ *     answer is a property of what the kind produces and who reads it.
  *
- *  1. The gated step must be a COMPANION kind. Gating means "skip this step when the task is
- *     light", and skipping is only safe for a dependent companion — skipping a producer
- *     (coder / spec-writer / architect) would leave its downstream steps (tester, merger,
- *     …) running against output that was never produced. (The consensus-gating sibling can
- *     degrade to the standard agent; step-gating removes the step, so it is companion-only.)
- *  2. It must set at least one axis threshold. With none, the axis loop in
+ *     This rule used to be "must be a COMPANION", on the reasoning that skipping a producer would
+ *     starve downstream steps. The old catalog disproved it: `pl_simple` shipped with no architect
+ *     and no spec-writer, `pl_quick` with no reviewer.
+ *  2. It must NOT also carry a human approval gate (`gates[i]`). The estimate may ADD a human
+ *     checkpoint — that is what gating a `human-review` step on risk does — but it may never
+ *     CANCEL an approval pause the pipeline author asked for, which is what an estimate-gated
+ *     human-gated step would do below its threshold. A model's own triage must not be able to
+ *     decide that nobody needs to look.
+ *  3. It must set at least one axis threshold. With none, the axis loop in
  *     `shouldRunGatedStep` never matches, so a step with an estimate would ALWAYS skip — the
  *     opposite of the usual intent — making the toggle a silent footgun.
- *  3. An enabled `task-estimator` must run earlier in the chain, or the gate has no estimate
+ *  4. An enabled `task-estimator` must run earlier in the chain, or the gate has no estimate
  *     to consult.
  */
-export declare function assertValidGating(agentKinds: string[], enabled?: boolean[], gating?: (StepGating | null)[]): void;
+export declare function assertValidGating({ agentKinds, enabled, gates, gating, agentKindRegistry, }: PipelineShape): void;
 /**
  * Validate every ENABLED Tester step whose test quality-control companion carries an enabled
  * estimate gate. The QC gate lives on the Tester step itself (not a companion), so it is
@@ -94,7 +126,7 @@ export declare function assertValidGating(agentKinds: string[], enabled?: boolea
  * estimate to consult). The QC companion being enabled/disabled itself imposes no requirement —
  * only an enabled GATE does.
  */
-export declare function assertValidTesterQualityGating(agentKinds: string[], enabled?: boolean[], testerQuality?: (TesterQualityConfig | null)[]): void;
+export declare function assertValidTesterQualityGating({ agentKinds, enabled, testerQuality, }: PipelineShape): void;
 /**
  * Enforce a pipeline's launch constraints (design §2 of the bug-triage pipeline):
  *

package/dist/modules/pipelines/pipelineShape.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipelineShape.d.ts","sourceRoot":"","sources":["../../../src/modules/pipelines/pipelineShape.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,oBAAoB,EACpB,UAAU,EACV,WAAW,EACX,mBAAmB,EACpB,MAAM,qBAAqB,CAAA;AAS5B;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAA;AAE9C;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,eAAe,CAAA;AAEjD;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAE9F;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,OAAO,CAAC,EAAE,OAAO,EAAE,CAAA;IACnB,MAAM,CAAC,EAAE,CAAC,UAAU,GAAG,IAAI,CAAC,EAAE,CAAA;IAC9B,aAAa,CAAC,EAAE,CAAC,mBAAmB,GAAG,IAAI,CAAC,EAAE,CAAA;IAC9C,WAAW,CAAC,EAAE,CAAC,WAAW,GAAG,IAAI,CAAC,EAAE,CAAA;CACrC;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAKnE;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,EAAE,EACpB,OAAO,CAAC,EAAE,OAAO,EAAE,EACnB,WAAW,CAAC,EAAE,CAAC,WAAW,GAAG,IAAI,CAAC,EAAE,GACnC,IAAI,CAUN;AAED;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,CAoB7F;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAAE,EACpB,OAAO,CAAC,EAAE,OAAO,EAAE,EACnB,MAAM,CAAC,EAAE,CAAC,UAAU,GAAG,IAAI,CAAC,EAAE,GAC7B,IAAI,CA0BN;AAED;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAC5C,UAAU,EAAE,MAAM,EAAE,EACpB,OAAO,CAAC,EAAE,OAAO,EAAE,EACnB,aAAa,CAAC,EAAE,CAAC,mBAAmB,GAAG,IAAI,CAAC,EAAE,GAC7C,IAAI,CAuBN;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,EAAE,EACpB,YAAY,EAAE,oBAAoB,GAAG,SAAS,EAC9C,MAAM,CAAC,EAAE,SAAS,EAClB,OAAO,CAAC,EAAE,OAAO,EAAE,GAClB,IAAI,CAkBN"}
+{"version":3,"file":"pipelineShape.d.ts","sourceRoot":"","sources":["../../../src/modules/pipelines/pipelineShape.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,oBAAoB,EACpB,UAAU,EACV,WAAW,EACX,mBAAmB,EACpB,MAAM,qBAAqB,CAAA;AAQ5B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAG5D;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAA;AAE9C;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,eAAe,CAAA;AAEjD;;;;GAIG;AACH,wBAAgB,2BAA2B,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,GAAG,OAAO,CAE9F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,MAAM,EAAE,CAAA;IACpB,OAAO,CAAC,EAAE,OAAO,EAAE,CAAA;IACnB;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,EAAE,CAAA;IACjB,MAAM,CAAC,EAAE,CAAC,UAAU,GAAG,IAAI,CAAC,EAAE,CAAA;IAC9B,aAAa,CAAC,EAAE,CAAC,mBAAmB,GAAG,IAAI,CAAC,EAAE,CAAA;IAC9C,WAAW,CAAC,EAAE,CAAC,WAAW,GAAG,IAAI,CAAC,EAAE,CAAA;IACpC;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAA;CACtC;AAED,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAKnE;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,aAAa,GAAG,IAAI,CAU/F;AAED;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAAC,EAAE,UAAU,EAAE,OAAO,EAAE,EAAE,aAAa,GAAG,IAAI,CAoB1F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,UAAU,EACV,OAAO,EACP,KAAK,EACL,MAAM,EACN,iBAAiB,GAClB,EAAE,aAAa,GAAG,IAAI,CA+BtB;AAED;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAAC,EAC7C,UAAU,EACV,OAAO,EACP,aAAa,GACd,EAAE,aAAa,GAAG,IAAI,CAuBtB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,wBAAwB,CACtC,UAAU,EAAE,MAAM,EAAE,EACpB,YAAY,EAAE,oBAAoB,GAAG,SAAS,EAC9C,MAAM,CAAC,EAAE,SAAS,EAClB,OAAO,CAAC,EAAE,OAAO,EAAE,GAClB,IAAI,CAkBN"}

package/dist/modules/pipelines/pipelineShape.js

@@ -1,5 +1,5 @@
 import { ValidationError } from '@cat-factory/kernel';
-import { companionTargets, isCompanionKind, SKILL_AGENT_KIND, TASK_ESTIMATOR_AGENT_KIND, } from '@cat-factory/agents';
+import { companionTargets, isCompanionKind, isGatableKind, SKILL_AGENT_KIND, TASK_ESTIMATOR_AGENT_KIND, } from '@cat-factory/agents';
 import { isTesterKind } from '../execution/ci.logic.js';
 /**
  * The `bug-intake` engine step pulls one issue from the schedule's configured tracker board, so
@@ -19,10 +19,10 @@ export function pipelineHasEnabledBugIntake(agentKinds, enabled) {
     return agentKinds.some((kind, i) => kind === BUG_INTAKE_AGENT_KIND && enabled?.[i] !== false);
 }
 export function validatePipelineShape(pipeline) {
-    assertValidCompanionPlacement(pipeline.agentKinds, pipeline.enabled);
-    assertValidGating(pipeline.agentKinds, pipeline.enabled, pipeline.gating);
-    assertValidTesterQualityGating(pipeline.agentKinds, pipeline.enabled, pipeline.testerQuality);
-    assertValidSkillSteps(pipeline.agentKinds, pipeline.enabled, pipeline.stepOptions);
+    assertValidCompanionPlacement(pipeline);
+    assertValidGating(pipeline);
+    assertValidTesterQualityGating(pipeline);
+    assertValidSkillSteps(pipeline);
 }
 /**
  * Every ENABLED `skill` step must name the skill it runs (`stepOptions[i].skillId`). The one
@@ -31,7 +31,7 @@ export function validatePipelineShape(pipeline) {
  * since both boundaries share this validation) rather than failing deep in dispatch. A DISABLED
  * skill step never runs, so it imposes no requirement.
  */
-export function assertValidSkillSteps(agentKinds, enabled, stepOptions) {
+export function assertValidSkillSteps({ agentKinds, enabled, stepOptions }) {
     const isEnabled = (i) => enabled?.[i] !== false;
     for (let i = 0; i < agentKinds.length; i++) {
         if (agentKinds[i] !== SKILL_AGENT_KIND || !isEnabled(i))
@@ -50,7 +50,7 @@ export function assertValidSkillSteps(agentKinds, enabled, stepOptions) {
  * producer and its companion". Companions are surfaced in the builder as toggles attached to
  * their producer and run immediately after it, so adjacency is required.
  */
-export function assertValidCompanionPlacement(agentKinds, enabled) {
+export function assertValidCompanionPlacement({ agentKinds, enabled }) {
     const isEnabled = (i) => enabled?.[i] !== false;
     for (let i = 0; i < agentKinds.length; i++) {
         const kind = agentKinds[i];
@@ -72,20 +72,32 @@ export function assertValidCompanionPlacement(agentKinds, enabled) {
 }
 /**
  * Validate every ENABLED step that carries enabled estimate gating. A disabled gated step
- * never runs, so it imposes no requirement; an enabled one must satisfy all three rules:
+ * never runs, so it imposes no requirement; an enabled one must satisfy all four rules:
  *
- *  1. The gated step must be a COMPANION kind. Gating means "skip this step when the task is
- *     light", and skipping is only safe for a dependent companion — skipping a producer
- *     (coder / spec-writer / architect) would leave its downstream steps (tester, merger,
- *     …) running against output that was never produced. (The consensus-gating sibling can
- *     degrade to the standard agent; step-gating removes the step, so it is companion-only.)
- *  2. It must set at least one axis threshold. With none, the axis loop in
+ *  1. The gated step's kind must be GATABLE ({@link isGatableKind}). Gating means "skip this
+ *     step when the task is light", which is safe for a kind whose output later steps read as
+ *     CONTEXT (a design proposal, a research note, an extra verification pass) and unsafe for one
+ *     some other mechanism reads STRUCTURALLY — `merger` (whose mere presence in `instance.steps`
+ *     is what makes a committing kind deliver via a PR), `deployer` (which provisions the
+ *     environment its consumer reads), `conflicts`/`ci` (the guards), `bug-intake` (the run's
+ *     subject). Gatability is declared per kind rather than derived from a category, because the
+ *     answer is a property of what the kind produces and who reads it.
+ *
+ *     This rule used to be "must be a COMPANION", on the reasoning that skipping a producer would
+ *     starve downstream steps. The old catalog disproved it: `pl_simple` shipped with no architect
+ *     and no spec-writer, `pl_quick` with no reviewer.
+ *  2. It must NOT also carry a human approval gate (`gates[i]`). The estimate may ADD a human
+ *     checkpoint — that is what gating a `human-review` step on risk does — but it may never
+ *     CANCEL an approval pause the pipeline author asked for, which is what an estimate-gated
+ *     human-gated step would do below its threshold. A model's own triage must not be able to
+ *     decide that nobody needs to look.
+ *  3. It must set at least one axis threshold. With none, the axis loop in
  *     `shouldRunGatedStep` never matches, so a step with an estimate would ALWAYS skip — the
  *     opposite of the usual intent — making the toggle a silent footgun.
- *  3. An enabled `task-estimator` must run earlier in the chain, or the gate has no estimate
+ *  4. An enabled `task-estimator` must run earlier in the chain, or the gate has no estimate
  *     to consult.
  */
-export function assertValidGating(agentKinds, enabled, gating) {
+export function assertValidGating({ agentKinds, enabled, gates, gating, agentKindRegistry, }) {
     if (!gating)
         return;
     const isEnabled = (i) => enabled?.[i] !== false;
@@ -94,8 +106,11 @@ export function assertValidGating(agentKinds, enabled, gating) {
         if (!g?.enabled || !isEnabled(i))
             continue;
         const kind = agentKinds[i];
-        if (kind === undefined || !isCompanionKind(kind)) {
-            throw new ValidationError(`Step '${kind}' cannot be estimate-gated — only companion steps (reviewer / architect-companion / spec-companion) may be skipped on the estimate.`);
+        if (kind === undefined || !isGatableKind(kind, agentKindRegistry)) {
+            throw new ValidationError(`Step '${kind}' cannot be estimate-gated — its output is required by the rest of the run. Only a step whose result later steps read as context (a design, a review, an extra verification pass) may be skipped on the estimate.`);
+        }
+        if (gates?.[i] === true) {
+            throw new ValidationError(`Step '${kind}' carries a human approval gate, so it cannot also be estimate-gated — the estimate may add a human checkpoint but never remove one. Drop the approval gate to make the step conditional, or drop the estimate gate to keep it unconditional.`);
         }
         if (g.minComplexity === undefined && g.minRisk === undefined && g.minImpact === undefined) {
             throw new ValidationError(`Step '${kind}' is estimate-gated but sets no threshold — set at least one of complexity / risk / impact, or it would always be skipped.`);
@@ -117,7 +132,7 @@ export function assertValidGating(agentKinds, enabled, gating) {
  * estimate to consult). The QC companion being enabled/disabled itself imposes no requirement —
  * only an enabled GATE does.
  */
-export function assertValidTesterQualityGating(agentKinds, enabled, testerQuality) {
+export function assertValidTesterQualityGating({ agentKinds, enabled, testerQuality, }) {
     if (!testerQuality)
         return;
     const isEnabled = (i) => enabled?.[i] !== false;

package/dist/modules/pipelines/pipelineShape.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/orchestration",
-  "version": "0.172.1",
+  "version": "0.174.0",
   "description": "Delivery-workflow engine for the Agent Architecture Board (execution, bootstrap, pipelines, board, boardScan, requirements, and composition root).",
   "repository": {
     "type": "git",
@@ -25,20 +25,20 @@
   },
   "dependencies": {
     "ai": "^7.0.37",
-    "@cat-factory/agents": "0.89.1",
-    "@cat-factory/caching": "0.11.25",
-    "@cat-factory/contracts": "0.198.0",
-    "@cat-factory/integrations": "0.112.0",
-    "@cat-factory/kernel": "0.196.0",
-    "@cat-factory/prompt-fragments": "0.15.21",
-    "@cat-factory/sandbox": "0.11.10",
-    "@cat-factory/spend": "0.12.126",
-    "@cat-factory/workspaces": "0.21.3"
+    "@cat-factory/agents": "0.91.0",
+    "@cat-factory/caching": "0.11.27",
+    "@cat-factory/contracts": "0.200.0",
+    "@cat-factory/integrations": "0.113.1",
+    "@cat-factory/kernel": "0.198.0",
+    "@cat-factory/prompt-fragments": "0.15.23",
+    "@cat-factory/sandbox": "0.11.12",
+    "@cat-factory/spend": "0.12.128",
+    "@cat-factory/workspaces": "0.21.5"
   },
   "devDependencies": {
     "typescript": "7.0.2",
     "vitest": "^4.1.10",
-    "@cat-factory/sandbox-fixtures": "0.7.229"
+    "@cat-factory/sandbox-fixtures": "0.7.231"
   },
   "scripts": {
     "build": "tsc -b tsconfig.build.json",