Skip to content

Evenfire is an intelligence layer platform for running LLM agents that take real actions, on your infrastructure

TypeScript

docs(workflow-recipes): state what each path deletes and leaves pending

Alfredo Lopez73f21674345f
diff --git a/workflow-recipes/package-lock.json b/workflow-recipes/package-lock.json
index 3142b3539..6292a22bc 100644
--- a/workflow-recipes/package-lock.json
+++ b/workflow-recipes/package-lock.json
@@ -1,12 +1,12 @@
{
"name": "workload-recipes-controller",
- "version": "0.1.430",
+ "version": "0.1.431",
"lockfileVersion": 3,
"requires": true,
"packages": {
"": {
"name": "workload-recipes-controller",
- "version": "0.1.430",
+ "version": "0.1.431",
"license": "SEE LICENSE IN LICENSE",
"dependencies": {
"@aws-sdk/client-s3": "^3.1009.0",
diff --git a/workflow-recipes/package.json b/workflow-recipes/package.json
index d7bbc15b4..3e428c63d 100644
--- a/workflow-recipes/package.json
+++ b/workflow-recipes/package.json
@@ -1,6 +1,6 @@
{
"name": "workload-recipes-controller",
- "version": "0.1.430",
+ "version": "0.1.431",
"description": "Workload Recipes Controller (WRC) - WorkloadRecipe lifecycle management and MCP server interface",
"main": "dist/main.js",
"engines": {
diff --git a/workflow-recipes/src/workflow/workflowReconciler.ts b/workflow-recipes/src/workflow/workflowReconciler.ts
index 433f31039..492fbdc5d 100644
--- a/workflow-recipes/src/workflow/workflowReconciler.ts
+++ b/workflow-recipes/src/workflow/workflowReconciler.ts
@@ -3079,17 +3079,37 @@ export class WorkflowReconciler {
* reconcile() pass or the finalizer's label sweep, the legacy policy for the
* next reconcile() pass.
*
- * What each path may delete (verdict = Codex/Grok eligibility; it governs
- * only the proxy lanes, every other catalog lane follows the spec alone):
+ * What each path does to a run-lane policy (verdict = Codex/Grok
+ * eligibility; it governs only the proxy lanes, every other catalog lane
+ * follows the spec alone; legacy = `<recipe>-mcp-servers-egress-internet`):
*
- * | path | proxy required | proxy uncertain | proxy retired | other lane, not desired |
- * | reconcile() pass | applied | kept if live | pruned | pruned |
- * | mid-run retry (this) | applied | kept if live | kept | kept |
- * | terminal teardown | kept | kept | kept | kept |
+ * | path | proxy required | proxy uncertain | proxy retired | other lane, not desired | legacy |
+ * | reconcile() pass | applied | kept if live | pruned | pruned | deleted |
+ * | mid-run retry (this) | applied | kept if live | kept | kept | kept |
+ * | terminal teardown | kept | kept | kept | kept | kept |
+ * | finalizer | deleted | deleted | deleted | deleted | only if labeled |
+ *
+ * What a failed write leaves behind, per path:
+ *
+ * | path | on failure |
+ * | reconcile() pass | apply terminating/contended: `RetryPending`, requeue. Non-404 DELETE (prune or legacy) or a failed LIST: `PrunePending`, no requeue |
+ * | mid-run retry (this) | apply still pending: marker kept, progress requeue. Apply threw: marker kept, transient requeue. A pending prune is carried over |
+ * | terminal teardown | a pending apply is dropped; a pending prune is kept (`PrunePending`) |
+ * | finalizer | a non-404 DELETE is logged by `safeDelete` and not rethrown, so the finalizer completes |
*
* A desired lane is applied on both apply paths; an uncertain verdict never
- * creates a proxy. Terminal teardown deletes compute pods, not policies; the
- * finalizer deletes every recipe policy.
+ * creates a proxy. Terminal teardown deletes a run-scoped run's compute pods
+ * and its cross-namespace transport workloads, and, for every terminal
+ * recipe, revokes `<recipe>-coordinator-to-gfs` unless the run completed and
+ * that policy may open; that policy is outside the run-lane catalog. It
+ * deletes no run-lane policy. The finalizer deletes a fixed list of run-lane
+ * names and sweeps by the recipe labels in the sandbox and mcp-server
+ * namespaces; the legacy policy has no name-based delete there and goes only
+ * if it carries those labels.
+ *
+ * reconcile(), and so its prune, also runs while the run's pods are live:
+ * the WRC falls through to it for a run in `initializing` or `recovering`,
+ * and for any in-progress run while transport network readiness is pending.
*/
async retryRunLaneNetworkPolicies(
recipeName: string,