@intentius/chant 0.124.27 → 0.124.29

package/README.md

@@ -4,7 +4,7 @@ Core package for [chant](https://intentius.io/chant/) — a type system for oper
 
 This package provides the lexicon-agnostic foundation that all chant lexicons build on. It includes the type system (Declarables, Intrinsics, Parameters, Outputs), the discovery and build pipeline, the semantic lint engine, the CLI, template import, and reusable codegen infrastructure for lexicon authors (runtime factories, naming strategies, generation and packaging pipelines, LSP providers).
 
-Install it alongside a lexicon to start declaring infrastructure as typed TypeScript.
+Install it alongside a lexicon to start declaring infrastructure as TypeScript.
 
 ```bash
 npm install --save-dev @intentius/chant @intentius/chant-lexicon-aws

package/dist/__golden__/wave-loop/fan-out-gated.json

@@ -64,6 +64,7 @@
         "timestamp": "2026-10-11T00:00:00.000Z",
         "expiresAt": "2026-10-13T00:00:00.000Z",
         "description": "wave 1 of 3: net",
+        "gitSha": "1111111111111111111111111111111111111111",
         "planDigest": "jcs1-sha256:95bbd78ad48471cefeb1cb32a3f308abde40b2d299eac36ab86b0614f23bcccf"
       },
       "waves": [
@@ -136,6 +137,7 @@
           "timestamp": "2026-10-11T00:00:00.000Z",
           "expiresAt": "2026-10-13T00:00:00.000Z",
           "description": "wave 1 of 3: net",
+          "gitSha": "1111111111111111111111111111111111111111",
           "planDigest": "jcs1-sha256:95bbd78ad48471cefeb1cb32a3f308abde40b2d299eac36ab86b0614f23bcccf"
         }
       ],
@@ -234,6 +236,7 @@
         "timestamp": "2026-10-11T00:00:00.000Z",
         "expiresAt": "2026-10-13T00:00:00.000Z",
         "description": "wave 2 of 3: a, b",
+        "gitSha": "1111111111111111111111111111111111111111",
         "planDigest": "jcs1-sha256:f56bc903abaf2bb2f593fcb6f83b48322c7079deed286c1439d2a4e0310e2bdd"
       },
       "waves": [
@@ -407,6 +410,7 @@
           "timestamp": "2026-10-11T00:00:00.000Z",
           "expiresAt": "2026-10-13T00:00:00.000Z",
           "description": "wave 2 of 3: a, b",
+          "gitSha": "1111111111111111111111111111111111111111",
           "planDigest": "jcs1-sha256:f56bc903abaf2bb2f593fcb6f83b48322c7079deed286c1439d2a4e0310e2bdd"
         }
       ],
@@ -479,6 +483,7 @@
         "timestamp": "2026-10-11T00:00:00.000Z",
         "expiresAt": "2026-10-13T00:00:00.000Z",
         "description": "wave 1 of 3: net",
+        "gitSha": "1111111111111111111111111111111111111111",
         "planDigest": "jcs1-sha256:95bbd78ad48471cefeb1cb32a3f308abde40b2d299eac36ab86b0614f23bcccf"
       },
       "waves": [
@@ -553,6 +558,7 @@
           "timestamp": "2026-10-11T00:00:00.000Z",
           "expiresAt": "2026-10-13T00:00:00.000Z",
           "description": "wave 1 of 3: net",
+          "gitSha": "1111111111111111111111111111111111111111",
           "planDigest": "jcs1-sha256:95bbd78ad48471cefeb1cb32a3f308abde40b2d299eac36ab86b0614f23bcccf"
         }
       ],
@@ -625,6 +631,7 @@
         "timestamp": "2026-10-11T00:00:00.000Z",
         "expiresAt": "2026-10-11T02:00:00.000Z",
         "description": "the release",
+        "gitSha": "1111111111111111111111111111111111111111",
         "planDigest": "jcs1-sha256:95bbd78ad48471cefeb1cb32a3f308abde40b2d299eac36ab86b0614f23bcccf"
       },
       "waves": [
@@ -697,6 +704,7 @@
           "timestamp": "2026-10-11T00:00:00.000Z",
           "expiresAt": "2026-10-11T02:00:00.000Z",
           "description": "the release",
+          "gitSha": "1111111111111111111111111111111111111111",
           "planDigest": "jcs1-sha256:95bbd78ad48471cefeb1cb32a3f308abde40b2d299eac36ab86b0614f23bcccf"
         }
       ],

package/dist/__golden__/wave-loop/fan-out-no-members.json

@@ -565,6 +565,7 @@
         "timestamp": "2026-10-11T00:00:00.000Z",
         "expiresAt": "2026-10-13T00:00:00.000Z",
         "description": "wave 1 of 3: net",
+        "gitSha": "1111111111111111111111111111111111111111",
         "planDigest": ""
       },
       "waves": [
@@ -627,6 +628,7 @@
           "timestamp": "2026-10-11T00:00:00.000Z",
           "expiresAt": "2026-10-13T00:00:00.000Z",
           "description": "wave 1 of 3: net",
+          "gitSha": "1111111111111111111111111111111111111111",
           "planDigest": ""
         }
       ],
@@ -725,6 +727,7 @@
         "timestamp": "2026-10-11T00:00:00.000Z",
         "expiresAt": "2026-10-13T00:00:00.000Z",
         "description": "wave 2 of 3: a, b",
+        "gitSha": "1111111111111111111111111111111111111111",
         "planDigest": "jcs1-sha256:f56bc903abaf2bb2f593fcb6f83b48322c7079deed286c1439d2a4e0310e2bdd"
       },
       "waves": [
@@ -888,6 +891,7 @@
           "timestamp": "2026-10-11T00:00:00.000Z",
           "expiresAt": "2026-10-13T00:00:00.000Z",
           "description": "wave 2 of 3: a, b",
+          "gitSha": "1111111111111111111111111111111111111111",
           "planDigest": "jcs1-sha256:f56bc903abaf2bb2f593fcb6f83b48322c7079deed286c1439d2a4e0310e2bdd"
         }
       ],

package/dist/__golden__/wave-loop/fan-out-only.json

@@ -119,6 +119,7 @@
         "timestamp": "2026-10-11T00:00:00.000Z",
         "expiresAt": "2026-10-13T00:00:00.000Z",
         "description": "wave 1 of 3: net",
+        "gitSha": "1111111111111111111111111111111111111111",
         "planDigest": "jcs1-sha256:95bbd78ad48471cefeb1cb32a3f308abde40b2d299eac36ab86b0614f23bcccf"
       },
       "waves": [
@@ -191,6 +192,7 @@
           "timestamp": "2026-10-11T00:00:00.000Z",
           "expiresAt": "2026-10-13T00:00:00.000Z",
           "description": "wave 1 of 3: net",
+          "gitSha": "1111111111111111111111111111111111111111",
           "planDigest": "jcs1-sha256:95bbd78ad48471cefeb1cb32a3f308abde40b2d299eac36ab86b0614f23bcccf"
         }
       ],
@@ -269,6 +271,7 @@
         "timestamp": "2026-10-11T00:00:00.000Z",
         "expiresAt": "2026-10-13T00:00:00.000Z",
         "description": "wave 2 of 3: a, b",
+        "gitSha": "1111111111111111111111111111111111111111",
         "planDigest": "jcs1-sha256:f56bc903abaf2bb2f593fcb6f83b48322c7079deed286c1439d2a4e0310e2bdd"
       },
       "waves": [
@@ -351,6 +354,7 @@
           "timestamp": "2026-10-11T00:00:00.000Z",
           "expiresAt": "2026-10-13T00:00:00.000Z",
           "description": "wave 2 of 3: a, b",
+          "gitSha": "1111111111111111111111111111111111111111",
           "planDigest": "jcs1-sha256:f56bc903abaf2bb2f593fcb6f83b48322c7079deed286c1439d2a4e0310e2bdd"
         }
       ],
@@ -432,6 +436,7 @@
         "timestamp": "2026-10-11T00:00:00.000Z",
         "expiresAt": "2026-10-13T00:00:00.000Z",
         "description": "wave 2 of 3: b",
+        "gitSha": "1111111111111111111111111111111111111111",
         "planDigest": "jcs1-sha256:cdbfa0d8006aa5a0b18a4cd6ca51375882107ad8395f4f12e0f2ae19a95a5483"
       },
       "waves": [
@@ -504,6 +509,7 @@
           "timestamp": "2026-10-11T00:00:00.000Z",
           "expiresAt": "2026-10-13T00:00:00.000Z",
           "description": "wave 2 of 3: b",
+          "gitSha": "1111111111111111111111111111111111111111",
           "planDigest": "jcs1-sha256:cdbfa0d8006aa5a0b18a4cd6ca51375882107ad8395f4f12e0f2ae19a95a5483"
         }
       ],

package/dist/__golden__/wave-loop/op-by-apply-hold.json

@@ -104,6 +104,7 @@
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
             "description": "wave 1 (prod): 1 run, gate never, approval ledger, held by before-apply hook lag (t1)",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:bd002be383b5e5991600692d985c09fb3ff0bc3370a8264d1ea8f118518dcc1e"
           },
           "recorded": true,
@@ -122,6 +123,7 @@
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
             "description": "wave 1 (prod): 1 run, gate never, approval ledger, held by before-apply hook lag (t1)",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:bd002be383b5e5991600692d985c09fb3ff0bc3370a8264d1ea8f118518dcc1e"
           }
         ],

package/dist/__golden__/wave-loop/op-cost-member.json

@@ -53,6 +53,7 @@
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
             "description": "wave 1 (layer): 2 runs, gate always, approval ledger",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:138f28c4ef2e87abe7454a8f47db147636932e106e166a399866b5bf470a21af"
           },
           "recorded": true,
@@ -71,6 +72,7 @@
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
             "description": "wave 1 (layer): 2 runs, gate always, approval ledger",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:138f28c4ef2e87abe7454a8f47db147636932e106e166a399866b5bf470a21af"
           }
         ],
@@ -181,6 +183,7 @@
         "timestamp": "2026-10-11T00:00:00.000Z",
         "expiresAt": "2026-10-13T00:00:00.000Z",
         "description": "wave 1 (layer): 2 runs, gate always, approval ledger",
+        "gitSha": "1111111111111111111111111111111111111111",
         "planDigest": "jcs1-sha256:138f28c4ef2e87abe7454a8f47db147636932e106e166a399866b5bf470a21af"
       },
       "recorded": true,

package/dist/__golden__/wave-loop/op-held-on-before-apply.json

@@ -140,6 +140,7 @@
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
             "description": "move the queues",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "sha256:qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqq"
           }
         ],

package/dist/__golden__/wave-loop/op-held-on.json

@@ -110,6 +110,7 @@
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
             "description": "move the queues",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "sha256:qqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqqq"
           }
         ],
@@ -250,6 +251,7 @@
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
             "description": "move the topics",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "sha256:tttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttttt"
           }
         ],

package/dist/__golden__/wave-loop/op-hooks-held.json

@@ -112,6 +112,7 @@
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
             "description": "wave 1 (prod): 2 runs, gate never, approval ledger, held by after-plan hook check (t2)",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:52d1b04601e89971eab0e24094024707e878042be4b79ad476d6230ac5ef383f"
           },
           "recorded": true,
@@ -152,6 +153,7 @@
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
             "description": "wave 1 (prod): 2 runs, gate never, approval ledger, held by after-plan hook check (t2)",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:52d1b04601e89971eab0e24094024707e878042be4b79ad476d6230ac5ef383f"
           }
         ],

package/dist/__golden__/wave-loop/op-hooks-hold-before-apply.json

@@ -95,6 +95,7 @@
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
             "description": "wave 1 (prod): 2 runs, gate never, approval ledger, held by before-apply hook lag",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:52d1b04601e89971eab0e24094024707e878042be4b79ad476d6230ac5ef383f"
           },
           "recorded": true,
@@ -113,6 +114,7 @@
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
             "description": "wave 1 (prod): 2 runs, gate never, approval ledger, held by before-apply hook lag",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:52d1b04601e89971eab0e24094024707e878042be4b79ad476d6230ac5ef383f"
           }
         ],

package/dist/__golden__/wave-loop/op-hooks-refused-at-base.json

@@ -45,6 +45,7 @@
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
             "description": "wave 1 (prod): 2 runs, gate never, approval ledger, held by the hooks at base cannot be run (waves.json at bbbbbbbbbbbb: `hooks.before.plan[0].command` must be a command as argv, a non-empty array of strings.)",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:52d1b04601e89971eab0e24094024707e878042be4b79ad476d6230ac5ef383f"
           },
           "recorded": true,
@@ -63,6 +64,7 @@
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
             "description": "wave 1 (prod): 2 runs, gate never, approval ledger, held by the hooks at base cannot be run (waves.json at bbbbbbbbbbbb: `hooks.before.plan[0].command` must be a command as argv, a non-empty array of strings.)",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:52d1b04601e89971eab0e24094024707e878042be4b79ad476d6230ac5ef383f"
           }
         ],
@@ -138,6 +140,7 @@
         "timestamp": "2026-10-11T00:00:00.000Z",
         "expiresAt": "2026-10-13T00:00:00.000Z",
         "description": "wave 1 (prod): 2 runs, gate never, approval ledger, held by the hooks at base cannot be run (waves.json at bbbbbbbbbbbb: `hooks.before.plan[0].command` must be a command as argv, a non-empty array of strings.)",
+        "gitSha": "1111111111111111111111111111111111111111",
         "planDigest": "jcs1-sha256:52d1b04601e89971eab0e24094024707e878042be4b79ad476d6230ac5ef383f"
       },
       "recorded": true,

package/dist/__golden__/wave-loop/op-hooks-share.json

@@ -113,6 +113,7 @@
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
             "description": "wave 1 (prod): 2 runs, gate never, approval ledger, held by after-plan hook check (t2)",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:52d1b04601e89971eab0e24094024707e878042be4b79ad476d6230ac5ef383f"
           },
           "recorded": true,
@@ -153,6 +154,7 @@
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
             "description": "wave 1 (prod): 2 runs, gate never, approval ledger, held by after-plan hook check (t2)",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:52d1b04601e89971eab0e24094024707e878042be4b79ad476d6230ac5ef383f"
           }
         ],
@@ -254,6 +256,7 @@
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
             "description": "wave 1 (prod): 2 runs, gate never, approval ledger, held by after-plan hook check (t2)",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:52d1b04601e89971eab0e24094024707e878042be4b79ad476d6230ac5ef383f"
           },
           "recorded": true,

package/dist/__golden__/wave-loop/op-per-run.json

@@ -80,6 +80,7 @@
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
             "description": "wave 2 (staging): 1 run, gate on-destructive, approval ledger",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:121fce9fb501cc2872d4239f620d465480edef5fcbe86d290f3b17c017231e8d"
           },
           "recorded": true,
@@ -98,6 +99,7 @@
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
             "description": "wave 2 (staging): 1 run, gate on-destructive, approval ledger",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:121fce9fb501cc2872d4239f620d465480edef5fcbe86d290f3b17c017231e8d"
           }
         ],
@@ -146,6 +148,7 @@
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
             "description": "wave 2 (staging): 1 run, gate on-destructive, approval ledger",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:121fce9fb501cc2872d4239f620d465480edef5fcbe86d290f3b17c017231e8d"
           },
           "recorded": true,
@@ -164,6 +167,7 @@
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
             "description": "wave 2 (staging): 1 run, gate on-destructive, approval ledger",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:121fce9fb501cc2872d4239f620d465480edef5fcbe86d290f3b17c017231e8d"
           }
         ],
@@ -257,6 +261,7 @@
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
             "description": "wave 2 (staging): 1 run, gate always, approval ledger",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:121fce9fb501cc2872d4239f620d465480edef5fcbe86d290f3b17c017231e8d"
           },
           "recorded": true,
@@ -275,6 +280,7 @@
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
             "description": "wave 2 (staging): 1 run, gate always, approval ledger",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:121fce9fb501cc2872d4239f620d465480edef5fcbe86d290f3b17c017231e8d"
           }
         ],
@@ -508,6 +514,7 @@
         "timestamp": "2026-10-11T00:00:00.000Z",
         "expiresAt": "2026-10-13T00:00:00.000Z",
         "description": "wave 2 (staging): 1 run, gate always, approval ledger",
+        "gitSha": "1111111111111111111111111111111111111111",
         "planDigest": "jcs1-sha256:121fce9fb501cc2872d4239f620d465480edef5fcbe86d290f3b17c017231e8d"
       },
       "recorded": true,

package/dist/__golden__/wave-loop/op-pr-review.json

@@ -56,6 +56,7 @@
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
             "description": "wave 2 (staging): 1 run, gate on-destructive, approval pr-review",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:121fce9fb501cc2872d4239f620d465480edef5fcbe86d290f3b17c017231e8d"
           }
         ],
@@ -70,6 +71,7 @@
             "approver": {
               "kind": "human"
             },
+            "gitSha": "hhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhh",
             "note": "approved by the review of #7 at hhhhhhhhhhhh: github:erin",
             "url": "https://example.test/pr/7",
             "review": {
@@ -125,6 +127,7 @@
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
             "description": "wave 2 (staging): 1 run, gate on-destructive, approval pr-review",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:121fce9fb501cc2872d4239f620d465480edef5fcbe86d290f3b17c017231e8d"
           },
           "recorded": true,
@@ -149,6 +152,7 @@
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
             "description": "wave 2 (staging): 1 run, gate on-destructive, approval pr-review",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:121fce9fb501cc2872d4239f620d465480edef5fcbe86d290f3b17c017231e8d"
           }
         ],
@@ -198,6 +202,7 @@
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
             "description": "wave 2 (staging): 1 run, gate on-destructive, approval pr-review",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:121fce9fb501cc2872d4239f620d465480edef5fcbe86d290f3b17c017231e8d"
           },
           "recorded": true,
@@ -225,6 +230,7 @@
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
             "description": "wave 2 (staging): 1 run, gate on-destructive, approval pr-review",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:121fce9fb501cc2872d4239f620d465480edef5fcbe86d290f3b17c017231e8d"
           }
         ],
@@ -378,6 +384,7 @@
         "timestamp": "2026-10-11T00:00:00.000Z",
         "expiresAt": "2026-10-13T00:00:00.000Z",
         "description": "wave 2 (staging): 1 run, gate on-destructive, approval pr-review",
+        "gitSha": "1111111111111111111111111111111111111111",
         "planDigest": "jcs1-sha256:121fce9fb501cc2872d4239f620d465480edef5fcbe86d290f3b17c017231e8d"
       },
       "recorded": true,

package/dist/__golden__/wave-loop/op-sealed.json

@@ -39,6 +39,7 @@
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
             "description": "wave 2 (staging): 1 run, gate on-destructive, approval sealed",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:121fce9fb501cc2872d4239f620d465480edef5fcbe86d290f3b17c017231e8d"
           },
           "recorded": true,
@@ -57,6 +58,7 @@
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
             "description": "wave 2 (staging): 1 run, gate on-destructive, approval sealed",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:121fce9fb501cc2872d4239f620d465480edef5fcbe86d290f3b17c017231e8d"
           }
         ],
@@ -115,6 +117,7 @@
         "timestamp": "2026-10-11T00:00:00.000Z",
         "expiresAt": "2026-10-13T00:00:00.000Z",
         "description": "wave 2 (staging): 1 run, gate on-destructive, approval sealed",
+        "gitSha": "1111111111111111111111111111111111111111",
         "planDigest": "jcs1-sha256:121fce9fb501cc2872d4239f620d465480edef5fcbe86d290f3b17c017231e8d"
       },
       "recorded": true,

package/dist/__golden__/wave-loop/op-spend.json

@@ -50,6 +50,7 @@
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
             "description": "wave 2 (staging): 1 run, gate on-destructive, approval ledger",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:121fce9fb501cc2872d4239f620d465480edef5fcbe86d290f3b17c017231e8d"
           }
         ],
@@ -114,6 +115,7 @@
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
             "description": "wave 2 (staging): 1 run, gate on-destructive, approval ledger",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:121fce9fb501cc2872d4239f620d465480edef5fcbe86d290f3b17c017231e8d"
           },
           "recorded": true,
@@ -132,6 +134,7 @@
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
             "description": "wave 2 (staging): 1 run, gate on-destructive, approval ledger",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:121fce9fb501cc2872d4239f620d465480edef5fcbe86d290f3b17c017231e8d"
           }
         ],

package/dist/__golden__/wave-loop/op-wave-commands.json

@@ -82,6 +82,7 @@
             "gate": "wave-1",
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:e8c434b396fbbce2b501a5fb746548ad4db81a26543b4dc2c757ec148379f853",
             "neverOverMcp": true
           },
@@ -110,6 +111,7 @@
             "gate": "wave-1",
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:e8c434b396fbbce2b501a5fb746548ad4db81a26543b4dc2c757ec148379f853",
             "neverOverMcp": true
           }
@@ -299,6 +301,7 @@
             "gate": "wave-1",
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:e8c434b396fbbce2b501a5fb746548ad4db81a26543b4dc2c757ec148379f853",
             "neverOverMcp": true
           },
@@ -333,6 +336,7 @@
             "gate": "wave-1",
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:e8c434b396fbbce2b501a5fb746548ad4db81a26543b4dc2c757ec148379f853",
             "neverOverMcp": true
           }
@@ -743,6 +747,7 @@
             "gate": "wave-1",
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:e8c434b396fbbce2b501a5fb746548ad4db81a26543b4dc2c757ec148379f853",
             "neverOverMcp": true
           },
@@ -1150,6 +1155,7 @@
             "gate": "wave-1",
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:e8c434b396fbbce2b501a5fb746548ad4db81a26543b4dc2c757ec148379f853",
             "neverOverMcp": true
           },
@@ -1662,6 +1668,7 @@
         "gate": "wave-1",
         "timestamp": "2026-10-11T00:00:00.000Z",
         "expiresAt": "2026-10-13T00:00:00.000Z",
+        "gitSha": "1111111111111111111111111111111111111111",
         "planDigest": "jcs1-sha256:e8c434b396fbbce2b501a5fb746548ad4db81a26543b4dc2c757ec148379f853",
         "neverOverMcp": true
       },

package/dist/__golden__/wave-loop/op-wide-waiting.json

@@ -49,6 +49,7 @@
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
             "description": "wave 3 (prod): 3 runs, gate always, approval ledger",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:106d25f35ee6bc02e9aa253d0b2633a764396833c82e0c5ec5a4ad83a2a85b4e"
           },
           "recorded": true,
@@ -67,6 +68,7 @@
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
             "description": "wave 3 (prod): 3 runs, gate always, approval ledger",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:106d25f35ee6bc02e9aa253d0b2633a764396833c82e0c5ec5a4ad83a2a85b4e"
           }
         ],
@@ -125,6 +127,7 @@
             "timestamp": "2026-10-11T00:00:00.000Z",
             "expiresAt": "2026-10-13T00:00:00.000Z",
             "description": "wave 3 (prod): 3 runs, gate always, approval ledger",
+            "gitSha": "1111111111111111111111111111111111111111",
             "planDigest": "jcs1-sha256:106d25f35ee6bc02e9aa253d0b2633a764396833c82e0c5ec5a4ad83a2a85b4e"
           },
           "recorded": true,
@@ -221,6 +224,7 @@
         "timestamp": "2026-10-11T00:00:00.000Z",
         "expiresAt": "2026-10-13T00:00:00.000Z",
         "description": "wave 3 (prod): 3 runs, gate always, approval ledger",
+        "gitSha": "1111111111111111111111111111111111111111",
         "planDigest": "jcs1-sha256:106d25f35ee6bc02e9aa253d0b2633a764396833c82e0c5ec5a4ad83a2a85b4e"
       },
       "recorded": true,

package/dist/build-params.d.ts

@@ -68,6 +68,30 @@ export interface BuildParamsInput {
     fromFile?: Record<string, unknown>;
     /** The process environment, consulted only for a parameter that declares an `env` mapping, and only once `cli`/`fromFile` have no value for it. */
     env?: Record<string, string | undefined>;
+    /**
+     * The workspace flags that back parameters in this build's environment
+     * (#4024), read by `./flag-params.ts`. A flag-backed parameter takes the
+     * flag's value for the environment, recorded with `source: "flag:<id>"`,
+     * ahead of its `env` mapping and its default. Absent outside a workspace
+     * and without `--env`.
+     */
+    flags?: BuildParamFlags;
+}
+/** The flags that back parameters in one environment (#4024). */
+export interface BuildParamFlags {
+    /** The environment the build is for. */
+    env: string;
+    /** Each flag-backed parameter by name: the flag's name, and its value in `env` (undefined when the flag gives it none). */
+    byParam: Record<string, {
+        flag: string;
+        value: BuildParamValue | undefined;
+    }>;
+    /**
+     * The environment has a gate (#4024's precedence rule): a `--param`,
+     * `--params-file` or env-var value for a flag-backed parameter is refused,
+     * so no path flips a flag around the gate.
+     */
+    gated?: boolean;
 }
 /** Result of resolving a project's declared parameters against one build invocation's inputs. */
 export interface BuildParamsResolution {
@@ -86,7 +110,11 @@ export interface BuildParamsResolution {
  * Resolve a project's declared build-time parameters against one build's
  * supplied inputs. Precedence per parameter, most to least specific:
  * `cli` (`--param name=value`) > `fromFile` (`--params-file`) > the
- * parameter's own declared `env` mapping (only if set) > `def.default`.
+ * parameter's own declared `env` mapping (only if set) > a workspace flag's
+ * value for the build's environment (`input.flags`, #4024) > `def.default`.
+ * When `input.flags.gated` is set, a flag-backed parameter takes none of the
+ * first three: a value from any of them is a build error, so a flag can't be
+ * flipped around the environment's gate.
  *
  * A parameter with no declared `default` and no value from any source is a
  * build error, not a silently-`undefined` value — a build-time parameter
@@ -103,6 +131,11 @@ export interface BuildParamsResolution {
  * `process.env.X || undefined`.
  */
 export declare function resolveBuildParams(defs: BuildParamsConfig | undefined, input: BuildParamsInput): BuildParamsResolution;
+/**
+ * The build error for a flag-backed parameter that `around` (`--param`,
+ * `--params-file` or an env var) set in an environment with a gate (#4024).
+ */
+export declare function flagGateRefusal(name: string, flag: string, env: string, around: string): string;
 /** Project the resolved provenance records down to a plain `{ name: value }` map — what actually gets bound to `params.<name>` (see ./params.ts). */
 export declare function buildParamValues(provenance: readonly BuildParamProvenance[]): Record<string, BuildParamValue>;
 //# sourceMappingURL=build-params.d.ts.map

package/dist/build-params.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"build-params.d.ts","sourceRoot":"","sources":["../src/build-params.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEzD;;;;;;;;;;;;;;;;;GAiBG;AAEH,6FAA6F;AAC7F,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+GAA+G;IAC/G,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACtC,mIAAmI;IACnI,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IAClC;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,6EAA6E;AAC7E,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAE9D,gIAAgI;AAChI,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,mJAAmJ;IACnJ,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC1C;AAED,iGAAiG;AACjG,MAAM,WAAW,qBAAqB;IACpC,sHAAsH;IACtH,UAAU,EAAE,oBAAoB,EAAE,CAAC;IACnC;;;;;;OAMG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AA2BD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,SAAS,EAAE,KAAK,EAAE,gBAAgB,GAAG,qBAAqB,CAiEtH;AAED,qJAAqJ;AACrJ,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,SAAS,oBAAoB,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAE7G"}
+{"version":3,"file":"build-params.d.ts","sourceRoot":"","sources":["../src/build-params.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEzD;;;;;;;;;;;;;;;;;GAiBG;AAEH,6FAA6F;AAC7F,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;AAExD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+GAA+G;IAC/G,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACtC,mIAAmI;IACnI,OAAO,CAAC,EAAE,eAAe,CAAC;IAC1B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;IAClC;;;;;;;OAOG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IACb;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,kFAAkF;IAClF,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,6EAA6E;AAC7E,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAE9D,gIAAgI;AAChI,MAAM,WAAW,gBAAgB;IAC/B,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,mJAAmJ;IACnJ,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC;;;;;;OAMG;IACH,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAED,iEAAiE;AACjE,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,GAAG,EAAE,MAAM,CAAC;IACZ,2HAA2H;IAC3H,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,eAAe,GAAG,SAAS,CAAA;KAAE,CAAC,CAAC;IAC9E;;;;OAIG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,iGAAiG;AACjG,MAAM,WAAW,qBAAqB;IACpC,sHAAsH;IACtH,UAAU,EAAE,oBAAoB,EAAE,CAAC;IACnC;;;;;;OAMG;IACH,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AA2BD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,SAAS,EAAE,KAAK,EAAE,gBAAgB,GAAG,qBAAqB,CAqFtH;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE/F;AAED,qJAAqJ;AACrJ,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,SAAS,oBAAoB,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAE7G"}