@cat-factory/orchestration 0.288.6 → 0.289.0

package/dist/modules/execution/environmentDispatch.logic.js

@@ -0,0 +1,60 @@
+import { runsAgainstEphemeralEnvironment } from '@cat-factory/agents';
+// ---------------------------------------------------------------------------
+// The last guard between "this run provisioned no reachable environment" and an agent being told
+// to test one.
+//
+// The prompt for a step in ephemeral-environment mode says "test against the environment
+// described above" and then prints `URL: (pending)`. Those two are contradictory, and the same
+// prompt's bail-out instruction ("if you cannot run a meaningful test at all, set abort") is not
+// a bound: the run this guard was written for reasoned "rather than abort with nothing, I
+// exercised the change against the actual deployment artifacts locally", reconstructed the
+// Dockerfile's stages by hand, tested THAT, and returned `greenlight: true` with the environment
+// recorded as skipped. On a task whose entire brief was "stand up the API", the single unverified
+// thing was the deliverable.
+//
+// That rationalization is predictable and will recur, which is the argument for refusing in the
+// engine rather than for a sterner prompt: a step told to test a URL it was not given has no good
+// move. The deployer's readiness wait is what normally makes this unreachable; this covers what a
+// wait cannot (an environment that expired mid-run, a chain with no `deployer` in it at all).
+// ---------------------------------------------------------------------------
+/**
+ * The refusal for an env-consuming step with no reachable environment, or null when there is
+ * nothing to refuse.
+ *
+ * Keyed off the SAME predicate the prompt branches on ({@link runsAgainstEphemeralEnvironment}),
+ * so the guard and the instructions cannot disagree about which steps are in ephemeral mode: one
+ * keyed off a near-miss condition would either refuse a step the prompt was going to let stand up
+ * its own infra, or let through the exact case it exists to catch.
+ *
+ * The `environment` failure kind (not `preflight`) because that is where the fix is: the
+ * provisioning that did not finish, or the environment that went away.
+ */
+export function environmentDispatchRefusal(context) {
+    if (!runsAgainstEphemeralEnvironment(context))
+        return null;
+    if (context.environment?.url)
+        return null;
+    const status = context.environment?.status;
+    // An environment that exists but is not reachable and one that was never provisioned are
+    // different faults with different fixes — the provider in the first case, the CHAIN (a tester
+    // with no `deployer` ahead of it) in the second — so they carry different codes rather than one
+    // "no environment" catch-all.
+    if (!status) {
+        return {
+            kind: 'job_failed',
+            error: 'No ephemeral environment was provisioned for this service.',
+            failureKind: 'environment',
+            detail: 'This step runs against an ephemeral environment, and this run provisioned none. A ' +
+                'service declaring kubernetes/custom provisioning needs a `deployer` step ahead of its tester.',
+            reason: 'environment_missing',
+        };
+    }
+    return {
+        kind: 'job_failed',
+        error: 'The ephemeral environment for this step is not reachable.',
+        failureKind: 'environment',
+        detail: `The service's environment is '${status}' and carries no URL, so there is no address to test against.`,
+        reason: 'environment_not_ready',
+    };
+}
+//# sourceMappingURL=environmentDispatch.logic.js.map

package/dist/modules/execution/environmentDispatch.logic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environmentDispatch.logic.js","sourceRoot":"","sources":["../../../src/modules/execution/environmentDispatch.logic.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,+BAA+B,EAAE,MAAM,qBAAqB,CAAA;AAGrE,8EAA8E;AAC9E,iGAAiG;AACjG,eAAe;AACf,EAAE;AACF,yFAAyF;AACzF,+FAA+F;AAC/F,iGAAiG;AACjG,0FAA0F;AAC1F,2FAA2F;AAC3F,iGAAiG;AACjG,kGAAkG;AAClG,6BAA6B;AAC7B,EAAE;AACF,gGAAgG;AAChG,kGAAkG;AAClG,kGAAkG;AAClG,8FAA8F;AAC9F,8EAA8E;AAE9E;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,0BAA0B,CAAC,OAAwB;IACjE,IAAI,CAAC,+BAA+B,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAA;IAC1D,IAAI,OAAO,CAAC,WAAW,EAAE,GAAG;QAAE,OAAO,IAAI,CAAA;IACzC,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,MAAM,CAAA;IAC1C,yFAAyF;IACzF,8FAA8F;IAC9F,gGAAgG;IAChG,8BAA8B;IAC9B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,IAAI,EAAE,YAAY;YAClB,KAAK,EAAE,4DAA4D;YACnE,WAAW,EAAE,aAAa;YAC1B,MAAM,EACJ,oFAAoF;gBACpF,+FAA+F;YACjG,MAAM,EAAE,qBAAqB;SAC9B,CAAA;IACH,CAAC;IACD,OAAO;QACL,IAAI,EAAE,YAAY;QAClB,KAAK,EAAE,2DAA2D;QAClE,WAAW,EAAE,aAAa;QAC1B,MAAM,EAAE,iCAAiC,MAAM,+DAA+D;QAC9G,MAAM,EAAE,uBAAuB;KAChC,CAAA;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cat-factory/orchestration",
-  "version": "0.288.6",
+  "version": "0.289.0",
   "description": "Delivery-workflow engine for the Agent Architecture Board (execution, bootstrap, pipelines, board, boardScan, requirements, and composition root).",
   "repository": {
     "type": "git",
@@ -24,19 +24,19 @@
     "access": "public"
   },
   "dependencies": {
-    "@cat-factory/agents": "0.145.3",
-    "@cat-factory/caching": "0.20.49",
-    "@cat-factory/contracts": "0.332.0",
-    "@cat-factory/integrations": "0.166.15",
-    "@cat-factory/kernel": "0.321.3",
-    "@cat-factory/prompt-fragments": "1.1.11",
-    "@cat-factory/sandbox": "0.12.22",
-    "@cat-factory/spend": "0.16.20",
-    "@cat-factory/workspaces": "0.28.37",
+    "@cat-factory/agents": "0.146.0",
+    "@cat-factory/caching": "0.20.50",
+    "@cat-factory/contracts": "0.333.0",
+    "@cat-factory/integrations": "0.166.16",
+    "@cat-factory/kernel": "0.322.0",
+    "@cat-factory/prompt-fragments": "1.1.12",
+    "@cat-factory/sandbox": "0.12.23",
+    "@cat-factory/spend": "0.16.21",
+    "@cat-factory/workspaces": "0.28.38",
     "ai": "^7.0.77"
   },
   "devDependencies": {
-    "@cat-factory/sandbox-fixtures": "0.8.13",
+    "@cat-factory/sandbox-fixtures": "0.8.14",
     "typescript": "7.0.2",
     "vitest": "^4.1.11"
   },