@intentius/chant 0.124.54 → 0.124.55
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/__fixtures__/estate-ledger.d.ts +13 -0
- package/dist/__fixtures__/estate-ledger.d.ts.map +1 -0
- package/dist/__fixtures__/estate-ledger.js +67 -0
- package/dist/__fixtures__/oidc-emulator.d.ts +11 -1
- package/dist/__fixtures__/oidc-emulator.d.ts.map +1 -1
- package/dist/__fixtures__/oidc-emulator.js +26 -2
- package/dist/__fixtures__/product-words.d.ts +78 -0
- package/dist/__fixtures__/product-words.d.ts.map +1 -0
- package/dist/__fixtures__/product-words.js +43 -0
- package/dist/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
- package/dist/__golden__/wave-loop/op-by-apply-hold.json +20 -4
- package/dist/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
- package/dist/__golden__/wave-loop/op-by-apply-pass.json +10 -2
- package/dist/__golden__/wave-loop/op-by-apply-skip.json +10 -2
- package/dist/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
- package/dist/__golden__/wave-loop/op-discover-rest.json +44 -12
- package/dist/__golden__/wave-loop/op-discover-wide.json +12 -3
- package/dist/__golden__/wave-loop/op-held-on.json +28 -7
- package/dist/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
- package/dist/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
- package/dist/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
- package/dist/__golden__/wave-loop/op-hooks-held.json +26 -8
- package/dist/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
- package/dist/__golden__/wave-loop/op-hooks-pass.json +22 -6
- package/dist/__golden__/wave-loop/op-hooks-share.json +20 -7
- package/dist/__golden__/wave-loop/op-outcome-held.json +12 -3
- package/dist/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
- package/dist/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
- package/dist/__golden__/wave-loop/op-outcome-replan.json +16 -5
- package/dist/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
- package/dist/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
- package/dist/__golden__/wave-loop/op-overridden.json +28 -7
- package/dist/__golden__/wave-loop/op-per-run.json +20 -4
- package/dist/__golden__/wave-loop/op-point.json +18 -4
- package/dist/__golden__/wave-loop/op-pr-review.json +10 -2
- package/dist/__golden__/wave-loop/op-spend-change-only.json +10 -2
- package/dist/__golden__/wave-loop/op-spend.json +10 -2
- package/dist/__golden__/wave-loop/op-wave-commands.json +56 -13
- package/dist/__golden__/wave-loop/op-wide.json +20 -4
- package/dist/bucket-check/azure.d.ts +108 -0
- package/dist/bucket-check/azure.d.ts.map +1 -0
- package/dist/bucket-check/azure.js +258 -0
- package/dist/bucket-check/fixtures/azure.json +153 -0
- package/dist/bucket-check/fixtures/gcs.json +148 -0
- package/dist/bucket-check/fixtures/s3.json +277 -0
- package/dist/bucket-check/gcs.d.ts +77 -0
- package/dist/bucket-check/gcs.d.ts.map +1 -0
- package/dist/bucket-check/gcs.js +202 -0
- package/dist/bucket-check/index.d.ts +48 -0
- package/dist/bucket-check/index.d.ts.map +1 -0
- package/dist/bucket-check/index.js +44 -0
- package/dist/bucket-check/s3.d.ts +116 -0
- package/dist/bucket-check/s3.d.ts.map +1 -0
- package/dist/bucket-check/s3.js +362 -0
- package/dist/bucket-check/types.d.ts +66 -0
- package/dist/bucket-check/types.d.ts.map +1 -0
- package/dist/bucket-check/types.js +31 -0
- package/dist/bucket-check/wire.d.ts +27 -0
- package/dist/bucket-check/wire.d.ts.map +1 -0
- package/dist/bucket-check/wire.js +32 -0
- package/dist/bucket-check.d.ts +6 -0
- package/dist/bucket-check.d.ts.map +1 -0
- package/dist/bucket-check.js +5 -0
- package/dist/capabilities/templates.d.ts.map +1 -1
- package/dist/capabilities/templates.js +1 -2
- package/dist/change-set.d.ts.map +1 -1
- package/dist/change-set.js +2 -3
- package/dist/ci-agent.d.ts +381 -0
- package/dist/ci-agent.d.ts.map +1 -0
- package/dist/ci-agent.js +833 -0
- package/dist/ci-control.d.ts +42 -0
- package/dist/ci-control.d.ts.map +1 -0
- package/dist/ci-control.js +42 -0
- package/dist/ci-estate/delivery.d.ts +137 -0
- package/dist/ci-estate/delivery.d.ts.map +1 -0
- package/dist/ci-estate/delivery.js +311 -0
- package/dist/ci-estate/overdue.d.ts +34 -0
- package/dist/ci-estate/overdue.d.ts.map +1 -0
- package/dist/ci-estate/overdue.js +58 -0
- package/dist/ci-estate/page.d.ts +134 -0
- package/dist/ci-estate/page.d.ts.map +1 -0
- package/dist/ci-estate/page.js +233 -0
- package/dist/ci-estate/rows.d.ts +118 -0
- package/dist/ci-estate/rows.d.ts.map +1 -0
- package/dist/ci-estate/rows.js +126 -0
- package/dist/ci-estate.d.ts +68 -0
- package/dist/ci-estate.d.ts.map +1 -0
- package/dist/ci-estate.js +83 -0
- package/dist/ci-handover.d.ts +29 -5
- package/dist/ci-handover.d.ts.map +1 -1
- package/dist/ci-handover.js +50 -16
- package/dist/ci-identity.d.ts +82 -7
- package/dist/ci-identity.d.ts.map +1 -1
- package/dist/ci-identity.js +87 -15
- package/dist/ci-product-words.d.ts +290 -0
- package/dist/ci-product-words.d.ts.map +1 -0
- package/dist/ci-product-words.js +373 -0
- package/dist/ci-product.d.ts +82 -0
- package/dist/ci-product.d.ts.map +1 -0
- package/dist/ci-product.js +78 -0
- package/dist/cli/commands/audit.d.ts +2 -2
- package/dist/cli/commands/audit.d.ts.map +1 -1
- package/dist/cli/commands/audit.js +3 -2
- package/dist/cli/commands/carve.js +2 -2
- package/dist/cli/commands/init.d.ts +2 -0
- package/dist/cli/commands/init.d.ts.map +1 -1
- package/dist/cli/commands/init.js +1 -1
- package/dist/cli/handlers/agent.d.ts +17 -0
- package/dist/cli/handlers/agent.d.ts.map +1 -0
- package/dist/cli/handlers/agent.js +114 -0
- package/dist/cli/handlers/approve-confirm.d.ts +84 -0
- package/dist/cli/handlers/approve-confirm.d.ts.map +1 -0
- package/dist/cli/handlers/approve-confirm.js +142 -0
- package/dist/cli/handlers/approve.d.ts.map +1 -1
- package/dist/cli/handlers/approve.js +19 -1
- package/dist/cli/handlers/build.d.ts.map +1 -1
- package/dist/cli/handlers/build.js +43 -1
- package/dist/cli/handlers/ci-check.d.ts +3 -0
- package/dist/cli/handlers/ci-check.d.ts.map +1 -0
- package/dist/cli/handlers/ci-check.js +34 -0
- package/dist/cli/handlers/ci-forge-check.d.ts +3 -0
- package/dist/cli/handlers/ci-forge-check.d.ts.map +1 -0
- package/dist/cli/handlers/ci-forge-check.js +89 -0
- package/dist/cli/handlers/fan-out.js +4 -0
- package/dist/cli/handlers/gate-pending.d.ts +11 -0
- package/dist/cli/handlers/gate-pending.d.ts.map +1 -0
- package/dist/cli/handlers/gate-pending.js +44 -0
- package/dist/cli/handlers/init.d.ts.map +1 -1
- package/dist/cli/handlers/init.js +1 -0
- package/dist/cli/handlers/ledger.js +1 -1
- package/dist/cli/handlers/lifecycle-drift.d.ts +6 -2
- package/dist/cli/handlers/lifecycle-drift.d.ts.map +1 -1
- package/dist/cli/handlers/lifecycle-drift.js +7 -2
- package/dist/cli/handlers/lock.d.ts.map +1 -1
- package/dist/cli/handlers/lock.js +64 -5
- package/dist/cli/handlers/notify-relay.d.ts +15 -0
- package/dist/cli/handlers/notify-relay.d.ts.map +1 -0
- package/dist/cli/handlers/notify-relay.js +130 -0
- package/dist/cli/handlers/pr-env.d.ts.map +1 -1
- package/dist/cli/handlers/pr-env.js +42 -11
- package/dist/cli/handlers/pr.d.ts +38 -3
- package/dist/cli/handlers/pr.d.ts.map +1 -1
- package/dist/cli/handlers/pr.js +653 -205
- package/dist/cli/handlers/promote.d.ts.map +1 -1
- package/dist/cli/handlers/promote.js +21 -2
- package/dist/cli/handlers/release.d.ts.map +1 -1
- package/dist/cli/handlers/release.js +3 -0
- package/dist/cli/handlers/run-wave.d.ts +8 -0
- package/dist/cli/handlers/run-wave.d.ts.map +1 -1
- package/dist/cli/handlers/run-wave.js +71 -1
- package/dist/cli/handlers/run.d.ts +6 -1
- package/dist/cli/handlers/run.d.ts.map +1 -1
- package/dist/cli/handlers/run.js +86 -1
- package/dist/cli/handlers/serve.d.ts.map +1 -1
- package/dist/cli/handlers/serve.js +10 -1
- package/dist/cli/main.d.ts +11 -1
- package/dist/cli/main.d.ts.map +1 -1
- package/dist/cli/main.js +124 -13
- package/dist/cli/mcp/ledger-tools.d.ts +36 -0
- package/dist/cli/mcp/ledger-tools.d.ts.map +1 -0
- package/dist/cli/mcp/ledger-tools.js +122 -0
- package/dist/cli/mcp/product-tools.d.ts +78 -0
- package/dist/cli/mcp/product-tools.d.ts.map +1 -0
- package/dist/cli/mcp/product-tools.js +93 -0
- package/dist/cli/mcp/read-only.d.ts +34 -0
- package/dist/cli/mcp/read-only.d.ts.map +1 -0
- package/dist/cli/mcp/read-only.js +61 -0
- package/dist/cli/mcp/report-tools.d.ts +48 -0
- package/dist/cli/mcp/report-tools.d.ts.map +1 -0
- package/dist/cli/mcp/report-tools.js +128 -0
- package/dist/cli/mcp/server.d.ts +28 -1
- package/dist/cli/mcp/server.d.ts.map +1 -1
- package/dist/cli/mcp/server.js +86 -15
- package/dist/cli/mcp-config.d.ts +9 -2
- package/dist/cli/mcp-config.d.ts.map +1 -1
- package/dist/cli/mcp-config.js +8 -3
- package/dist/cli/parse-args.d.ts.map +1 -1
- package/dist/cli/parse-args.js +57 -3
- package/dist/cli/registry.d.ts +35 -0
- package/dist/cli/registry.d.ts.map +1 -1
- package/dist/cloud-lister/sigv4.d.ts +42 -7
- package/dist/cloud-lister/sigv4.d.ts.map +1 -1
- package/dist/cloud-lister/sigv4.js +72 -22
- package/dist/components/adoption.d.ts +69 -0
- package/dist/components/adoption.d.ts.map +1 -0
- package/dist/components/adoption.js +93 -0
- package/dist/components/apply-lease.d.ts +19 -0
- package/dist/components/apply-lease.d.ts.map +1 -0
- package/dist/components/apply-lease.js +41 -0
- package/dist/components/capability.d.ts +122 -5
- package/dist/components/capability.d.ts.map +1 -1
- package/dist/components/capability.js +14 -6
- package/dist/components/check-hooks.d.ts +113 -0
- package/dist/components/check-hooks.d.ts.map +1 -0
- package/dist/components/check-hooks.js +192 -0
- package/dist/components/ci-services.d.ts +57 -0
- package/dist/components/ci-services.d.ts.map +1 -0
- package/dist/components/ci-services.js +61 -0
- package/dist/components/cli-support.d.ts +13 -0
- package/dist/components/cli-support.d.ts.map +1 -1
- package/dist/components/cli-support.js +10 -2
- package/dist/components/driver.d.ts +20 -3
- package/dist/components/driver.d.ts.map +1 -1
- package/dist/components/driver.js +24 -4
- package/dist/components/fan-out-run.d.ts +12 -0
- package/dist/components/fan-out-run.d.ts.map +1 -1
- package/dist/components/fan-out-run.js +56 -16
- package/dist/components/groups.d.ts.map +1 -1
- package/dist/components/groups.js +19 -2
- package/dist/components/pr-env-ledger.d.ts +32 -0
- package/dist/components/pr-env-ledger.d.ts.map +1 -0
- package/dist/components/pr-env-ledger.js +39 -0
- package/dist/components/pr-env-ports.d.ts +12 -0
- package/dist/components/pr-env-ports.d.ts.map +1 -1
- package/dist/components/pr-env-ports.js +13 -3
- package/dist/components/pr-env-run.d.ts +6 -0
- package/dist/components/pr-env-run.d.ts.map +1 -1
- package/dist/components/pr-env-run.js +3 -2
- package/dist/components/pr-environment.d.ts +31 -3
- package/dist/components/pr-environment.d.ts.map +1 -1
- package/dist/components/pr-environment.js +25 -7
- package/dist/components/pr-pipeline.d.ts +169 -3
- package/dist/components/pr-pipeline.d.ts.map +1 -1
- package/dist/components/pr-pipeline.js +184 -9
- package/dist/components/pr-policy.d.ts +26 -2
- package/dist/components/pr-policy.d.ts.map +1 -1
- package/dist/components/pr-policy.js +41 -7
- package/dist/components/pr-run.d.ts +63 -0
- package/dist/components/pr-run.d.ts.map +1 -1
- package/dist/components/pr-run.js +82 -3
- package/dist/components/pr-targets.d.ts +24 -0
- package/dist/components/pr-targets.d.ts.map +1 -0
- package/dist/components/pr-targets.js +48 -0
- package/dist/components/product-pipeline.d.ts +217 -0
- package/dist/components/product-pipeline.d.ts.map +1 -0
- package/dist/components/product-pipeline.js +193 -0
- package/dist/components/promote.d.ts +6 -0
- package/dist/components/promote.d.ts.map +1 -1
- package/dist/components/promote.js +4 -1
- package/dist/components/release-compile.d.ts +22 -1
- package/dist/components/release-compile.d.ts.map +1 -1
- package/dist/components/release-compile.js +85 -0
- package/dist/components/release-promote.d.ts +15 -1
- package/dist/components/release-promote.d.ts.map +1 -1
- package/dist/components/release-promote.js +67 -2
- package/dist/components/repo-lock.d.ts +27 -0
- package/dist/components/repo-lock.d.ts.map +1 -0
- package/dist/components/repo-lock.js +49 -0
- package/dist/components/row-lease.d.ts +84 -0
- package/dist/components/row-lease.d.ts.map +1 -0
- package/dist/components/row-lease.js +110 -0
- package/dist/components/wave-plan.d.ts +34 -0
- package/dist/components/wave-plan.d.ts.map +1 -1
- package/dist/components/wave-plan.js +54 -2
- package/dist/control/applied.d.ts +89 -0
- package/dist/control/applied.d.ts.map +1 -0
- package/dist/control/applied.js +175 -0
- package/dist/control/consumers.d.ts +78 -0
- package/dist/control/consumers.d.ts.map +1 -0
- package/dist/control/consumers.js +172 -0
- package/dist/control/dispatch.d.ts +334 -0
- package/dist/control/dispatch.d.ts.map +1 -0
- package/dist/control/dispatch.js +519 -0
- package/dist/control/edges.d.ts +75 -0
- package/dist/control/edges.d.ts.map +1 -0
- package/dist/control/edges.js +133 -0
- package/dist/control/reconcile.d.ts +120 -0
- package/dist/control/reconcile.d.ts.map +1 -0
- package/dist/control/reconcile.js +178 -0
- package/dist/control/records.d.ts +187 -0
- package/dist/control/records.d.ts.map +1 -0
- package/dist/control/records.js +307 -0
- package/dist/discovery/sandbox/bundle.d.ts.map +1 -1
- package/dist/discovery/sandbox/bundle.js +25 -1
- package/dist/engine-facts.d.ts.map +1 -1
- package/dist/engine-facts.js +1 -2
- package/dist/exit-codes.d.ts +48 -0
- package/dist/exit-codes.d.ts.map +1 -0
- package/dist/exit-codes.js +49 -0
- package/dist/forge-check/check.d.ts +63 -0
- package/dist/forge-check/check.d.ts.map +1 -0
- package/dist/forge-check/check.js +139 -0
- package/dist/forge-check/contract.d.ts +152 -0
- package/dist/forge-check/contract.d.ts.map +1 -0
- package/dist/forge-check/contract.js +118 -0
- package/dist/forge-check/forge.d.ts +42 -0
- package/dist/forge-check/forge.d.ts.map +1 -0
- package/dist/forge-check/forge.js +338 -0
- package/dist/forge-check/index.d.ts +24 -0
- package/dist/forge-check/index.d.ts.map +1 -0
- package/dist/forge-check/index.js +23 -0
- package/dist/forge-check/pulumi.d.ts +44 -0
- package/dist/forge-check/pulumi.d.ts.map +1 -0
- package/dist/forge-check/pulumi.js +184 -0
- package/dist/forge-check/read-only.d.ts +26 -0
- package/dist/forge-check/read-only.d.ts.map +1 -0
- package/dist/forge-check/read-only.js +53 -0
- package/dist/forge-check/trust.d.ts +94 -0
- package/dist/forge-check/trust.d.ts.map +1 -0
- package/dist/forge-check/trust.js +532 -0
- package/dist/forge-check/types.d.ts +80 -0
- package/dist/forge-check/types.d.ts.map +1 -0
- package/dist/forge-check/types.js +18 -0
- package/dist/forge-check.d.ts +6 -0
- package/dist/forge-check.d.ts.map +1 -0
- package/dist/forge-check.js +5 -0
- package/dist/gate-decision.d.ts +1 -0
- package/dist/gate-decision.d.ts.map +1 -1
- package/dist/gate-decision.js +2 -0
- package/dist/gate-policy.d.ts +47 -1
- package/dist/gate-policy.d.ts.map +1 -1
- package/dist/gate-policy.js +50 -2
- package/dist/index.d.ts +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -0
- package/dist/lexicon.d.ts +106 -6
- package/dist/lexicon.d.ts.map +1 -1
- package/dist/lifecycle/adoption-file.d.ts +24 -0
- package/dist/lifecycle/adoption-file.d.ts.map +1 -1
- package/dist/lifecycle/adoption-file.js +1 -2
- package/dist/lifecycle/cloud-index.d.ts.map +1 -1
- package/dist/lifecycle/cloud-index.js +1 -2
- package/dist/lifecycle/gate-applied.d.ts +6 -0
- package/dist/lifecycle/gate-applied.d.ts.map +1 -1
- package/dist/lifecycle/gate-ledger.d.ts +29 -0
- package/dist/lifecycle/gate-ledger.d.ts.map +1 -1
- package/dist/lifecycle/gate-ledger.js +11 -1
- package/dist/lifecycle/gate-pending-by-plan.d.ts +75 -0
- package/dist/lifecycle/gate-pending-by-plan.d.ts.map +1 -0
- package/dist/lifecycle/gate-pending-by-plan.js +96 -0
- package/dist/lifecycle/gated-request-digest.d.ts +28 -0
- package/dist/lifecycle/gated-request-digest.d.ts.map +1 -0
- package/dist/lifecycle/gated-request-digest.js +35 -0
- package/dist/lifecycle/gated-request.d.ts +126 -0
- package/dist/lifecycle/gated-request.d.ts.map +1 -0
- package/dist/lifecycle/gated-request.js +205 -0
- package/dist/lifecycle/identity-match.d.ts +15 -0
- package/dist/lifecycle/identity-match.d.ts.map +1 -1
- package/dist/lifecycle/identity-match.js +11 -6
- package/dist/lifecycle/index-diff.d.ts +40 -0
- package/dist/lifecycle/index-diff.d.ts.map +1 -1
- package/dist/lifecycle/index-diff.js +1 -2
- package/dist/lifecycle/index-document.d.ts.map +1 -1
- package/dist/lifecycle/index-document.js +1 -2
- package/dist/lifecycle/index-import.d.ts +4 -1
- package/dist/lifecycle/index-import.d.ts.map +1 -1
- package/dist/lifecycle/index-import.js +29 -32
- package/dist/lifecycle/ledger-read.d.ts.map +1 -1
- package/dist/lifecycle/ledger-read.js +7 -3
- package/dist/lifecycle/lock-rows.d.ts +76 -0
- package/dist/lifecycle/lock-rows.d.ts.map +1 -0
- package/dist/lifecycle/lock-rows.js +140 -0
- package/dist/lifecycle/query.d.ts +50 -3
- package/dist/lifecycle/query.d.ts.map +1 -1
- package/dist/lifecycle/query.js +97 -6
- package/dist/lifecycle/release-catalog-site.d.ts +66 -0
- package/dist/lifecycle/release-catalog-site.d.ts.map +1 -0
- package/dist/lifecycle/release-catalog-site.js +232 -0
- package/dist/lifecycle/release-catalog.d.ts +201 -0
- package/dist/lifecycle/release-catalog.d.ts.map +1 -0
- package/dist/lifecycle/release-catalog.js +198 -0
- package/dist/lifecycle/release-changelog.d.ts +41 -0
- package/dist/lifecycle/release-changelog.d.ts.map +1 -0
- package/dist/lifecycle/release-changelog.js +38 -0
- package/dist/lifecycle/release-cut.d.ts +1 -0
- package/dist/lifecycle/release-cut.d.ts.map +1 -1
- package/dist/lifecycle/release-cut.js +1 -1
- package/dist/lifecycle/release-ledger.d.ts +16 -0
- package/dist/lifecycle/release-ledger.d.ts.map +1 -1
- package/dist/lifecycle/release-ledger.js +10 -0
- package/dist/lifecycle/release-publish.d.ts +43 -22
- package/dist/lifecycle/release-publish.d.ts.map +1 -1
- package/dist/lifecycle/release-read.d.ts.map +1 -1
- package/dist/lifecycle/release-read.js +3 -0
- package/dist/lifecycle/release-status.d.ts +86 -0
- package/dist/lifecycle/release-status.d.ts.map +1 -0
- package/dist/lifecycle/release-status.js +136 -0
- package/dist/lifecycle/resource-lock.d.ts +120 -0
- package/dist/lifecycle/resource-lock.d.ts.map +1 -0
- package/dist/lifecycle/resource-lock.js +317 -0
- package/dist/lifecycle/retention.d.ts.map +1 -1
- package/dist/lifecycle/retention.js +3 -0
- package/dist/lifecycle/run-ledger.d.ts.map +1 -1
- package/dist/lifecycle/run-ledger.js +9 -1
- package/dist/lifecycle/snapshot-store-s3.d.ts +36 -3
- package/dist/lifecycle/snapshot-store-s3.d.ts.map +1 -1
- package/dist/lifecycle/snapshot-store-s3.js +9 -44
- package/dist/lifecycle/snapshot-store.d.ts.map +1 -1
- package/dist/lifecycle/snapshot-store.js +1 -2
- package/dist/lifecycle/target-lock.d.ts +15 -0
- package/dist/lifecycle/target-lock.d.ts.map +1 -1
- package/dist/lifecycle/target-lock.js +25 -10
- package/dist/mcp/types.d.ts +7 -0
- package/dist/mcp/types.d.ts.map +1 -1
- package/dist/notify-product.d.ts +43 -0
- package/dist/notify-product.d.ts.map +1 -0
- package/dist/notify-product.js +58 -0
- package/dist/notify-relay.d.ts +197 -0
- package/dist/notify-relay.d.ts.map +1 -0
- package/dist/notify-relay.js +321 -0
- package/dist/notify.d.ts +44 -4
- package/dist/notify.d.ts.map +1 -1
- package/dist/notify.js +77 -14
- package/dist/object-store/azure-blob.d.ts +129 -0
- package/dist/object-store/azure-blob.d.ts.map +1 -0
- package/dist/object-store/azure-blob.js +341 -0
- package/dist/object-store/common.d.ts +108 -0
- package/dist/object-store/common.d.ts.map +1 -0
- package/dist/object-store/common.js +80 -0
- package/dist/object-store/errors.d.ts +28 -0
- package/dist/object-store/errors.d.ts.map +1 -0
- package/dist/object-store/errors.js +21 -0
- package/dist/object-store/from-env.d.ts +18 -0
- package/dist/object-store/from-env.d.ts.map +1 -0
- package/dist/object-store/from-env.js +22 -0
- package/dist/object-store/gcs.d.ts +106 -0
- package/dist/object-store/gcs.d.ts.map +1 -0
- package/dist/object-store/gcs.js +393 -0
- package/dist/object-store/index.d.ts +9 -0
- package/dist/object-store/index.d.ts.map +1 -0
- package/dist/object-store/index.js +8 -0
- package/dist/object-store/s3.d.ts +146 -0
- package/dist/object-store/s3.d.ts.map +1 -0
- package/dist/object-store/s3.js +306 -0
- package/dist/op/activities/converge.d.ts.map +1 -1
- package/dist/op/activities/converge.js +2 -1
- package/dist/op/activities/index.d.ts +1 -1
- package/dist/op/activities/index.d.ts.map +1 -1
- package/dist/op/activities/index.js +1 -1
- package/dist/op/activities/review-agent.d.ts +55 -2
- package/dist/op/activities/review-agent.d.ts.map +1 -1
- package/dist/op/activities/review-agent.js +65 -5
- package/dist/op/gate.d.ts +29 -1
- package/dist/op/gate.d.ts.map +1 -1
- package/dist/op/gate.js +59 -23
- package/dist/op/generate-pipeline.d.ts.map +1 -1
- package/dist/op/generate-pipeline.js +7 -1
- package/dist/op/index.d.ts +12 -1
- package/dist/op/index.d.ts.map +1 -1
- package/dist/op/index.js +7 -1
- package/dist/op/op-waves-after-plan.d.ts +137 -0
- package/dist/op/op-waves-after-plan.d.ts.map +1 -0
- package/dist/op/op-waves-after-plan.js +163 -0
- package/dist/op/op-waves-capability-spec.d.ts +55 -0
- package/dist/op/op-waves-capability-spec.d.ts.map +1 -0
- package/dist/op/op-waves-capability-spec.js +94 -0
- package/dist/op/op-waves-capability.d.ts +197 -0
- package/dist/op/op-waves-capability.d.ts.map +1 -0
- package/dist/op/op-waves-capability.js +311 -0
- package/dist/op/op-waves-events.d.ts +54 -0
- package/dist/op/op-waves-events.d.ts.map +1 -0
- package/dist/op/op-waves-events.js +122 -0
- package/dist/op/op-waves-notify.d.ts +7 -1
- package/dist/op/op-waves-notify.d.ts.map +1 -1
- package/dist/op/op-waves-notify.js +35 -16
- package/dist/op/op-waves-release-port.d.ts +18 -0
- package/dist/op/op-waves-release-port.d.ts.map +1 -0
- package/dist/op/op-waves-release-port.js +61 -0
- package/dist/op/op-waves-release.d.ts +92 -0
- package/dist/op/op-waves-release.d.ts.map +1 -0
- package/dist/op/op-waves-release.js +97 -0
- package/dist/op/op-waves-run.d.ts +175 -4
- package/dist/op/op-waves-run.d.ts.map +1 -1
- package/dist/op/op-waves-run.js +981 -41
- package/dist/op/op-waves-stand-down.d.ts +60 -0
- package/dist/op/op-waves-stand-down.d.ts.map +1 -0
- package/dist/op/op-waves-stand-down.js +97 -0
- package/dist/op/op-waves.d.ts +152 -8
- package/dist/op/op-waves.d.ts.map +1 -1
- package/dist/op/op-waves.js +161 -17
- package/dist/op/runtime.d.ts +91 -0
- package/dist/op/runtime.d.ts.map +1 -1
- package/dist/op/runtime.js +19 -0
- package/dist/op/stage-hooks.d.ts +45 -7
- package/dist/op/stage-hooks.d.ts.map +1 -1
- package/dist/op/stage-hooks.js +61 -3
- package/dist/op/steward-beside.d.ts.map +1 -1
- package/dist/op/steward-beside.js +2 -1
- package/dist/op/types.d.ts +2 -2
- package/dist/op/types.d.ts.map +1 -1
- package/dist/op/types.js +3 -2
- package/dist/otlp-metrics.d.ts +38 -0
- package/dist/otlp-metrics.d.ts.map +1 -0
- package/dist/otlp-metrics.js +82 -0
- package/dist/otlp.d.ts +249 -0
- package/dist/otlp.d.ts.map +1 -0
- package/dist/otlp.js +426 -0
- package/dist/override-gate.d.ts.map +1 -1
- package/dist/override-gate.js +5 -0
- package/dist/policy-packs.d.ts +69 -0
- package/dist/policy-packs.d.ts.map +1 -0
- package/dist/policy-packs.js +205 -0
- package/dist/policy-source.d.ts +51 -0
- package/dist/policy-source.d.ts.map +1 -0
- package/dist/policy-source.js +103 -0
- package/dist/pr-forge.d.ts +40 -0
- package/dist/pr-forge.d.ts.map +1 -1
- package/dist/pr-forge.js +92 -0
- package/dist/pr-loop.d.ts +149 -11
- package/dist/pr-loop.d.ts.map +1 -1
- package/dist/pr-loop.js +283 -44
- package/dist/pr-post.d.ts +16 -0
- package/dist/pr-post.d.ts.map +1 -1
- package/dist/pr-post.js +26 -1
- package/dist/pr-report-url.d.ts +32 -4
- package/dist/pr-report-url.d.ts.map +1 -1
- package/dist/pr-report-url.js +46 -5
- package/dist/pr-requires.d.ts +13 -2
- package/dist/pr-requires.d.ts.map +1 -1
- package/dist/pr-requires.js +14 -0
- package/dist/release-floors.d.ts +1 -1
- package/dist/release-floors.js +1 -1
- package/dist/run-event.d.ts +26 -1
- package/dist/run-event.d.ts.map +1 -1
- package/dist/run-event.js +4 -1
- package/dist/sorted-json.d.ts +10 -0
- package/dist/sorted-json.d.ts.map +1 -0
- package/dist/sorted-json.js +14 -0
- package/dist/terraform/credentials.d.ts +59 -0
- package/dist/terraform/credentials.d.ts.map +1 -0
- package/dist/terraform/credentials.js +149 -0
- package/dist/utils.d.ts +1 -4
- package/dist/utils.d.ts.map +1 -1
- package/dist/utils.js +1 -9
- package/dist/wave-runtime.d.ts +1 -1
- package/dist/wave-runtime.js +2 -2
- package/dist/wave-runtime.mjs +390 -285
- package/dist/workspace/chant-migrations/chud-lexicon-exit.d.ts.map +1 -1
- package/dist/workspace/chant-migrations/chud-lexicon-exit.js +4 -1
- package/dist/workspace/ci-lock-grain.d.ts +12 -0
- package/dist/workspace/ci-lock-grain.d.ts.map +1 -0
- package/dist/workspace/ci-lock-grain.js +27 -0
- package/dist/workspace/ci-run.d.ts +2 -1
- package/dist/workspace/ci-run.d.ts.map +1 -1
- package/dist/workspace/ci-run.js +6 -3
- package/dist/workspace/declaration.d.ts +16 -4
- package/dist/workspace/declaration.d.ts.map +1 -1
- package/dist/workspace/declaration.js +5 -2
- package/dist/workspace/declaration.schema.json +27 -3
- package/dist/workspace/drift-cli.d.ts.map +1 -1
- package/dist/workspace/drift-cli.js +8 -3
- package/dist/workspace/exit-cli.d.ts +1 -1
- package/dist/workspace/exit-cli.d.ts.map +1 -1
- package/dist/workspace/exit-cli.js +2 -1
- package/dist/workspace/import-fetch.d.ts +4 -2
- package/dist/workspace/import-fetch.d.ts.map +1 -1
- package/dist/workspace/import-fetch.js +4 -2
- package/dist/workspace/import-init.d.ts.map +1 -1
- package/dist/workspace/import-init.js +4 -2
- package/dist/workspace/ledger.schema.json +7 -3
- package/dist/workspace/lineage-upgrade-cli.d.ts +1 -1
- package/dist/workspace/lineage-upgrade-cli.d.ts.map +1 -1
- package/dist/workspace/lineage-upgrade-cli.js +2 -1
- package/dist/workspace/pr-report.schema.json +74 -3
- package/dist/workspace/promote.d.ts +1 -1
- package/dist/workspace/promote.d.ts.map +1 -1
- package/dist/workspace/promote.js +2 -1
- package/dist/workspace/records-cli.d.ts +2 -2
- package/dist/workspace/records-cli.d.ts.map +1 -1
- package/dist/workspace/records-cli.js +3 -2
- package/dist/workspace/release-catalog.schema.json +277 -0
- package/dist/workspace/run-event.schema.json +18 -1
- package/dist/workspace/work-cli.d.ts +3 -1
- package/dist/workspace/work-cli.d.ts.map +1 -1
- package/dist/workspace/work-cli.js +7 -2
- package/dist/workspace/workspace-run.d.ts.map +1 -1
- package/dist/workspace/workspace-run.js +2 -1
- package/package.json +21 -1
- package/src/__fixtures__/estate-ledger.ts +101 -0
- package/src/__fixtures__/oidc-emulator.ts +31 -2
- package/src/__fixtures__/product-words.ts +44 -0
- package/src/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
- package/src/__golden__/wave-loop/op-by-apply-hold.json +20 -4
- package/src/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
- package/src/__golden__/wave-loop/op-by-apply-pass.json +10 -2
- package/src/__golden__/wave-loop/op-by-apply-skip.json +10 -2
- package/src/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
- package/src/__golden__/wave-loop/op-discover-rest.json +44 -12
- package/src/__golden__/wave-loop/op-discover-wide.json +12 -3
- package/src/__golden__/wave-loop/op-held-on.json +28 -7
- package/src/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
- package/src/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
- package/src/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
- package/src/__golden__/wave-loop/op-hooks-held.json +26 -8
- package/src/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
- package/src/__golden__/wave-loop/op-hooks-pass.json +22 -6
- package/src/__golden__/wave-loop/op-hooks-share.json +20 -7
- package/src/__golden__/wave-loop/op-outcome-held.json +12 -3
- package/src/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
- package/src/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
- package/src/__golden__/wave-loop/op-outcome-replan.json +16 -5
- package/src/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
- package/src/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
- package/src/__golden__/wave-loop/op-overridden.json +28 -7
- package/src/__golden__/wave-loop/op-per-run.json +20 -4
- package/src/__golden__/wave-loop/op-point.json +18 -4
- package/src/__golden__/wave-loop/op-pr-review.json +10 -2
- package/src/__golden__/wave-loop/op-spend-change-only.json +10 -2
- package/src/__golden__/wave-loop/op-spend.json +10 -2
- package/src/__golden__/wave-loop/op-wave-commands.json +56 -13
- package/src/__golden__/wave-loop/op-wide.json +20 -4
- package/src/bucket-check/azure.ts +307 -0
- package/src/bucket-check/bucket-check.test.ts +210 -0
- package/src/bucket-check/fixtures/azure.json +153 -0
- package/src/bucket-check/fixtures/gcs.json +148 -0
- package/src/bucket-check/fixtures/s3.json +277 -0
- package/src/bucket-check/gcs.ts +257 -0
- package/src/bucket-check/index.ts +61 -0
- package/src/bucket-check/s3.ts +433 -0
- package/src/bucket-check/types.ts +75 -0
- package/src/bucket-check/wire.ts +50 -0
- package/src/bucket-check.ts +5 -0
- package/src/capabilities/templates.test.ts +2 -3
- package/src/capabilities/templates.ts +1 -2
- package/src/cdk/advise.test.ts +1 -1
- package/src/change-set-bundle.test.ts +0 -1
- package/src/change-set.ts +2 -3
- package/src/ci-agent.test.ts +348 -0
- package/src/ci-agent.ts +1026 -0
- package/src/ci-control.ts +174 -0
- package/src/ci-estate/delivery.ts +433 -0
- package/src/ci-estate/overdue.ts +81 -0
- package/src/ci-estate/page.ts +343 -0
- package/src/ci-estate/rows.ts +251 -0
- package/src/ci-estate.test.ts +281 -0
- package/src/ci-estate.ts +176 -0
- package/src/ci-handover.ts +67 -16
- package/src/ci-identity-database.test.ts +55 -0
- package/src/ci-identity-pulumi.test.ts +163 -0
- package/src/ci-identity-targets.test.ts +6 -2
- package/src/ci-identity.ts +124 -22
- package/src/ci-product-words.test.ts +101 -0
- package/src/ci-product-words.ts +536 -0
- package/src/ci-product.ts +174 -0
- package/src/ci-shared-reads.test.ts +145 -0
- package/src/cli/commands/audit.test.ts +1 -1
- package/src/cli/commands/audit.ts +3 -2
- package/src/cli/commands/carve.test.ts +1 -1
- package/src/cli/commands/carve.ts +2 -2
- package/src/cli/commands/init.ts +3 -1
- package/src/cli/component-wave-args.test.ts +16 -0
- package/src/cli/handlers/agent.ts +126 -0
- package/src/cli/handlers/approve-confirm.test.ts +276 -0
- package/src/cli/handlers/approve-confirm.ts +200 -0
- package/src/cli/handlers/approve.ts +18 -1
- package/src/cli/handlers/build.test.ts +7 -0
- package/src/cli/handlers/build.ts +44 -1
- package/src/cli/handlers/ci-check.ts +33 -0
- package/src/cli/handlers/ci-forge-check.ts +91 -0
- package/src/cli/handlers/fan-out.test.ts +10 -10
- package/src/cli/handlers/fan-out.ts +5 -0
- package/src/cli/handlers/gate-pending.ts +46 -0
- package/src/cli/handlers/init.ts +1 -0
- package/src/cli/handlers/ledger.ts +1 -1
- package/src/cli/handlers/lifecycle-drift.ts +7 -2
- package/src/cli/handlers/lock.test.ts +29 -2
- package/src/cli/handlers/lock.ts +66 -6
- package/src/cli/handlers/notify-relay.ts +130 -0
- package/src/cli/handlers/pr-before-merge.test.ts +2 -1
- package/src/cli/handlers/pr-deploy-inputs.test.ts +7 -7
- package/src/cli/handlers/pr-env.ts +48 -11
- package/src/cli/handlers/pr-plan-targets.test.ts +155 -0
- package/src/cli/handlers/pr-waves-blocked.test.ts +5 -0
- package/src/cli/handlers/pr-waves.test.ts +8 -2
- package/src/cli/handlers/pr.test.ts +8 -8
- package/src/cli/handlers/pr.ts +655 -205
- package/src/cli/handlers/promote.test.ts +5 -5
- package/src/cli/handlers/promote.ts +22 -2
- package/src/cli/handlers/release.ts +2 -0
- package/src/cli/handlers/run-components-exit.test.ts +7 -7
- package/src/cli/handlers/run-wave.ts +65 -1
- package/src/cli/handlers/run.test.ts +6 -4
- package/src/cli/handlers/run.ts +86 -1
- package/src/cli/handlers/serve.ts +10 -1
- package/src/cli/main.ts +126 -13
- package/src/cli/mcp/ledger-tools.ts +126 -0
- package/src/cli/mcp/product-tools.test.ts +123 -0
- package/src/cli/mcp/product-tools.ts +129 -0
- package/src/cli/mcp/read-only.test.ts +134 -0
- package/src/cli/mcp/read-only.ts +68 -0
- package/src/cli/mcp/report-tools.ts +135 -0
- package/src/cli/mcp/server.test.ts +5 -4
- package/src/cli/mcp/server.ts +90 -16
- package/src/cli/mcp-config.ts +8 -3
- package/src/cli/parse-args.ts +42 -2
- package/src/cli/registry.ts +35 -0
- package/src/cloud-lister/sigv4.ts +80 -23
- package/src/components/adoption.test.ts +140 -0
- package/src/components/adoption.ts +141 -0
- package/src/components/apply-lease.ts +49 -0
- package/src/components/capability.ts +130 -6
- package/src/components/check-hooks.test.ts +66 -0
- package/src/components/check-hooks.ts +252 -0
- package/src/components/ci-services.test.ts +51 -0
- package/src/components/ci-services.ts +83 -0
- package/src/components/cli-support.ts +23 -2
- package/src/components/driver.test.ts +3 -3
- package/src/components/driver.ts +38 -5
- package/src/components/fan-out-run.ts +68 -18
- package/src/components/groups.ts +17 -2
- package/src/components/pr-comment-preview.test.ts +54 -0
- package/src/components/pr-env-ledger.test.ts +9 -0
- package/src/components/pr-env-ledger.ts +43 -0
- package/src/components/pr-env-ports.ts +29 -4
- package/src/components/pr-env-run-bundle.test.ts +8 -0
- package/src/components/pr-env-run.test.ts +19 -0
- package/src/components/pr-env-run.ts +12 -2
- package/src/components/pr-environment.test.ts +29 -0
- package/src/components/pr-environment.ts +39 -7
- package/src/components/pr-pipeline.test.ts +15 -0
- package/src/components/pr-pipeline.ts +274 -9
- package/src/components/pr-policy.ts +45 -7
- package/src/components/pr-run.test.ts +1 -1
- package/src/components/pr-run.ts +121 -5
- package/src/components/pr-targets.test.ts +35 -0
- package/src/components/pr-targets.ts +45 -0
- package/src/components/product-pipeline.test.ts +200 -0
- package/src/components/product-pipeline.ts +341 -0
- package/src/components/promote.ts +10 -1
- package/src/components/release-compile.ts +87 -1
- package/src/components/release-promote.ts +65 -1
- package/src/components/repo-lock.ts +52 -0
- package/src/components/row-lease.test.ts +490 -0
- package/src/components/row-lease.ts +167 -0
- package/src/components/wave-plan-policy.test.ts +19 -0
- package/src/components/wave-plan.ts +78 -4
- package/src/control/__fixtures__/consumers/apps/consumers.json +15 -0
- package/src/control/__fixtures__/consumers/infra/consumers.json +23 -0
- package/src/control/applied.test.ts +148 -0
- package/src/control/applied.ts +191 -0
- package/src/control/consumers.test.ts +129 -0
- package/src/control/consumers.ts +192 -0
- package/src/control/control.test.ts +302 -0
- package/src/control/dispatch.ts +699 -0
- package/src/control/edges.test.ts +112 -0
- package/src/control/edges.ts +164 -0
- package/src/control/note-checkout.test.ts +91 -0
- package/src/control/reconcile.ts +250 -0
- package/src/control/records.ts +395 -0
- package/src/discovery/sandbox/bundle.ts +25 -1
- package/src/engine-facts.test.ts +2 -3
- package/src/engine-facts.ts +1 -2
- package/src/exit-codes.test.ts +31 -0
- package/src/exit-codes.ts +55 -0
- package/src/forge-check/check.ts +155 -0
- package/src/forge-check/contract.ts +215 -0
- package/src/forge-check/forge-check.test.ts +427 -0
- package/src/forge-check/forge.ts +318 -0
- package/src/forge-check/index.ts +43 -0
- package/src/forge-check/pulumi.ts +192 -0
- package/src/forge-check/read-only.ts +56 -0
- package/src/forge-check/trust.ts +527 -0
- package/src/forge-check/types.ts +78 -0
- package/src/forge-check.ts +5 -0
- package/src/gate-decision-bundle.test.ts +13 -0
- package/src/gate-decision.ts +3 -0
- package/src/gate-policy.ts +92 -3
- package/src/gated-waves-bundle.test.ts +0 -1
- package/src/index.ts +2 -0
- package/src/lexicon.ts +95 -6
- package/src/lifecycle/adoption-file.ts +1 -2
- package/src/lifecycle/cloud-index.test.ts +2 -3
- package/src/lifecycle/cloud-index.ts +1 -2
- package/src/lifecycle/control-entries-ledger.test.ts +70 -0
- package/src/lifecycle/gate-applied.ts +6 -0
- package/src/lifecycle/gate-ledger.ts +36 -1
- package/src/lifecycle/gate-pending-by-plan.test.ts +69 -0
- package/src/lifecycle/gate-pending-by-plan.ts +133 -0
- package/src/lifecycle/gated-request-digest.ts +49 -0
- package/src/lifecycle/gated-request-ledger.test.ts +53 -0
- package/src/lifecycle/gated-request.ts +280 -0
- package/src/lifecycle/identity-match.ts +25 -6
- package/src/lifecycle/index-diff.ts +1 -2
- package/src/lifecycle/index-document.ts +1 -2
- package/src/lifecycle/index-import.test.ts +14 -0
- package/src/lifecycle/index-import.ts +54 -34
- package/src/lifecycle/ledger-read.ts +7 -3
- package/src/lifecycle/lock-rows.test.ts +109 -0
- package/src/lifecycle/lock-rows.ts +167 -0
- package/src/lifecycle/publish-target-context.test.ts +108 -0
- package/src/lifecycle/query.test.ts +2 -3
- package/src/lifecycle/query.ts +109 -7
- package/src/lifecycle/release-catalog-site.test.ts +142 -0
- package/src/lifecycle/release-catalog-site.ts +291 -0
- package/src/lifecycle/release-catalog.test.ts +193 -0
- package/src/lifecycle/release-catalog.ts +353 -0
- package/src/lifecycle/release-changelog.test.ts +70 -0
- package/src/lifecycle/release-changelog.ts +71 -0
- package/src/lifecycle/release-cut.ts +2 -2
- package/src/lifecycle/release-ledger.ts +20 -0
- package/src/lifecycle/release-publish.ts +45 -22
- package/src/lifecycle/release-read.ts +2 -0
- package/src/lifecycle/release-status.test.ts +186 -0
- package/src/lifecycle/release-status.ts +176 -0
- package/src/lifecycle/resource-lock.test.ts +175 -0
- package/src/lifecycle/resource-lock.ts +354 -0
- package/src/lifecycle/retention.ts +2 -0
- package/src/lifecycle/run-ledger.ts +7 -1
- package/src/lifecycle/snapshot-store-s3.ts +9 -45
- package/src/lifecycle/snapshot-store.ts +1 -2
- package/src/lifecycle/target-lock.ts +24 -9
- package/src/mcp/types.ts +7 -0
- package/src/notify-product.ts +76 -0
- package/src/notify-relay.test.ts +213 -0
- package/src/notify-relay.ts +407 -0
- package/src/notify.ts +95 -14
- package/src/object-store/azure-blob.ts +374 -0
- package/src/object-store/common.ts +133 -0
- package/src/object-store/errors.ts +26 -0
- package/src/object-store/from-env.ts +36 -0
- package/src/object-store/gcs.ts +436 -0
- package/src/object-store/index.ts +8 -0
- package/src/object-store/object-store.test.ts +130 -0
- package/src/object-store/s3.ts +350 -0
- package/src/op/activities/converge.ts +2 -1
- package/src/op/activities/index.ts +1 -1
- package/src/op/activities/review-agent.open.test.ts +78 -0
- package/src/op/activities/review-agent.test.ts +13 -0
- package/src/op/activities/review-agent.ts +89 -5
- package/src/op/gate.ts +81 -22
- package/src/op/generate-pipeline.ts +7 -1
- package/src/op/index.ts +21 -0
- package/src/op/op-waves-after-plan.test.ts +276 -0
- package/src/op/op-waves-after-plan.ts +238 -0
- package/src/op/op-waves-capability-spec.ts +113 -0
- package/src/op/op-waves-capability.test.ts +217 -0
- package/src/op/op-waves-capability.ts +370 -0
- package/src/op/op-waves-events.ts +135 -0
- package/src/op/op-waves-notify-words.test.ts +149 -0
- package/src/op/op-waves-notify.ts +41 -16
- package/src/op/op-waves-pull-request.test.ts +142 -0
- package/src/op/op-waves-release-port.ts +64 -0
- package/src/op/op-waves-release.test.ts +209 -0
- package/src/op/op-waves-release.ts +133 -0
- package/src/op/op-waves-run-record.test.ts +32 -0
- package/src/op/op-waves-run.ts +1142 -49
- package/src/op/op-waves-stand-down.test.ts +240 -0
- package/src/op/op-waves-stand-down.ts +108 -0
- package/src/op/op-waves-trace.test.ts +205 -0
- package/src/op/op-waves.test.ts +112 -0
- package/src/op/op-waves.ts +261 -20
- package/src/op/runtime.ts +104 -0
- package/src/op/stage-hooks-hold-record.test.ts +41 -0
- package/src/op/stage-hooks.ts +91 -12
- package/src/op/steward-beside.ts +2 -1
- package/src/op/types.ts +3 -2
- package/src/otlp-metrics.ts +96 -0
- package/src/otlp.test.ts +243 -0
- package/src/otlp.ts +544 -0
- package/src/override-gate-bundle.test.ts +2 -0
- package/src/override-gate.ts +4 -0
- package/src/policy-packs.ts +230 -0
- package/src/policy-source.test.ts +256 -0
- package/src/policy-source.ts +112 -0
- package/src/pr-forge.ts +123 -0
- package/src/pr-loop-bundle.test.ts +6 -2
- package/src/pr-loop-words.test.ts +155 -0
- package/src/pr-loop.ts +371 -52
- package/src/pr-post.ts +32 -1
- package/src/pr-report-url.ts +62 -6
- package/src/pr-requires.test.ts +37 -1
- package/src/pr-requires.ts +16 -2
- package/src/product-subpaths-plain-node.e2e.test.ts +211 -0
- package/src/release-floors.ts +1 -1
- package/src/run-event.ts +29 -1
- package/src/sorted-json.ts +17 -0
- package/src/stage-hooks-bundle.test.ts +8 -0
- package/src/terraform/credentials.test.ts +77 -0
- package/src/terraform/credentials.ts +162 -0
- package/src/utils.ts +2 -11
- package/src/wave-loop-golden.test.ts +2 -1
- package/src/wave-runtime.ts +2 -2
- package/src/workspace/chant-migrations/chud-lexicon-exit.ts +4 -1
- package/src/workspace/ci-lock-grain.test.ts +31 -0
- package/src/workspace/ci-lock-grain.ts +30 -0
- package/src/workspace/ci-report-url.test.ts +1 -1
- package/src/workspace/ci-run.test.ts +1 -1
- package/src/workspace/ci-run.ts +6 -3
- package/src/workspace/declaration.schema.json +27 -3
- package/src/workspace/declaration.test.ts +1 -1
- package/src/workspace/declaration.ts +26 -10
- package/src/workspace/drift-cli.ts +8 -3
- package/src/workspace/exit-cli.ts +2 -1
- package/src/workspace/import-fetch.ts +4 -2
- package/src/workspace/import-init.ts +4 -2
- package/src/workspace/ledger.schema.json +7 -3
- package/src/workspace/lineage-upgrade-cli.ts +2 -1
- package/src/workspace/pr-report.schema.json +74 -3
- package/src/workspace/promote.ts +2 -1
- package/src/workspace/records-cli.ts +3 -2
- package/src/workspace/release-catalog.schema.json +277 -0
- package/src/workspace/run-event.schema.json +18 -1
- package/src/workspace/work-cli.ts +8 -2
- package/src/workspace/workspace-run.ts +2 -1
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* A release's changelog from its conventional commits (#4597, terragucci#1289
|
|
3
|
+
* bundle B). {@link releaseChangelog} groups the commits a version shipped
|
|
4
|
+
* into breaking changes, features, fixes and the rest, each with its sha and
|
|
5
|
+
* subject, and names the bump they imply, in the shape the release catalog
|
|
6
|
+
* takes (`CatalogChangelogInput`, ./release-catalog.ts).
|
|
7
|
+
*
|
|
8
|
+
* The bump follows terragucci's `bumpFor` (`publish/semver.ts`): a `type!:`
|
|
9
|
+
* subject or a `BREAKING CHANGE` (or `BREAKING-CHANGE`) footer is a major,
|
|
10
|
+
* `feat` a minor, and anything else a patch, since a changed component is
|
|
11
|
+
* always published at a new version. terragucci can call this behind its
|
|
12
|
+
* feature-detect once chant ships it.
|
|
13
|
+
*
|
|
14
|
+
* Pure: the caller reads the commits (`git log`) and passes them in.
|
|
15
|
+
*/
|
|
16
|
+
import type { CatalogChangelogEntry, ChangelogKind, ReleaseBump } from "./release-catalog";
|
|
17
|
+
|
|
18
|
+
/** One commit: its sha and its full message, subject first. */
|
|
19
|
+
export interface ChangelogCommit {
|
|
20
|
+
sha: string;
|
|
21
|
+
message: string;
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
/** The changelog of one release. */
|
|
25
|
+
export interface ReleaseChangelog {
|
|
26
|
+
/** The bump the commits imply. */
|
|
27
|
+
bump: ReleaseBump;
|
|
28
|
+
/** Every commit, in the order given, with its group. */
|
|
29
|
+
entries: CatalogChangelogEntry[];
|
|
30
|
+
/** The entries of each group, in the order given. */
|
|
31
|
+
groups: Record<ChangelogKind, CatalogChangelogEntry[]>;
|
|
32
|
+
}
|
|
33
|
+
|
|
34
|
+
const HEADER = /^(\w+)(?:\(([^)]*)\))?(!)?:\s*(.*)$/;
|
|
35
|
+
const BREAKING_FOOTER = /^BREAKING[ -]CHANGE:/m;
|
|
36
|
+
|
|
37
|
+
/** The group, scope and description of one commit message. A subject that is not conventional is `other`, kept whole. */
|
|
38
|
+
export function classifyCommit(message: string): { kind: ChangelogKind; scope?: string; subject: string } {
|
|
39
|
+
const subject = message.split("\n", 1)[0]!.trim();
|
|
40
|
+
const m = HEADER.exec(subject);
|
|
41
|
+
const breaking = BREAKING_FOOTER.test(message) || (m !== null && m[3] === "!");
|
|
42
|
+
if (!m) return { kind: breaking ? "breaking" : "other", subject };
|
|
43
|
+
const type = m[1]!;
|
|
44
|
+
const scope = m[2] ? m[2].trim() : undefined;
|
|
45
|
+
const kind: ChangelogKind = breaking ? "breaking" : type === "feat" ? "feat" : type === "fix" ? "fix" : "other";
|
|
46
|
+
return { kind, ...(scope ? { scope } : {}), subject: m[4]!.trim() || subject };
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
/** The bump a set of commit messages implies, as terragucci's `bumpFor` decides it. */
|
|
50
|
+
export function changelogBump(messages: readonly string[]): ReleaseBump {
|
|
51
|
+
let bump: ReleaseBump = "patch";
|
|
52
|
+
for (const message of messages) {
|
|
53
|
+
const subject = message.split("\n", 1)[0]!;
|
|
54
|
+
if (/^\w+(\([^)]*\))?!:/.test(subject) || BREAKING_FOOTER.test(message)) return "major";
|
|
55
|
+
if (/^feat(\([^)]*\))?:/.test(subject)) bump = "minor";
|
|
56
|
+
}
|
|
57
|
+
return bump;
|
|
58
|
+
}
|
|
59
|
+
|
|
60
|
+
/** Group `commits` and name their bump. */
|
|
61
|
+
export function releaseChangelog(commits: readonly ChangelogCommit[]): ReleaseChangelog {
|
|
62
|
+
const groups: Record<ChangelogKind, CatalogChangelogEntry[]> = { breaking: [], feat: [], fix: [], other: [] };
|
|
63
|
+
const entries: CatalogChangelogEntry[] = [];
|
|
64
|
+
for (const c of commits) {
|
|
65
|
+
const { kind, scope, subject } = classifyCommit(c.message);
|
|
66
|
+
const entry: CatalogChangelogEntry = { kind, sha: c.sha, subject, ...(scope ? { scope } : {}) };
|
|
67
|
+
entries.push(entry);
|
|
68
|
+
groups[kind].push(entry);
|
|
69
|
+
}
|
|
70
|
+
return { bump: changelogBump(commits.map((c) => c.message)), entries, groups };
|
|
71
|
+
}
|
|
@@ -362,7 +362,7 @@ export interface CutPlan {
|
|
|
362
362
|
/** The digest already cut under `label`, or this digest when it is already cut: the cut would then write no new release. */
|
|
363
363
|
alreadyCut: string | null;
|
|
364
364
|
/** Each environment's target: its params, and its templates by component and path. */
|
|
365
|
-
targets: Array<{ env: string; params: ReleaseTarget["params"]; templates: Array<{ component: string | null; path: string }
|
|
365
|
+
targets: Array<{ env: string; params: ReleaseTarget["params"]; templates: Array<{ component: string | null; path: string }>; trees?: ReleaseTarget["trees"] }>;
|
|
366
366
|
/** The components whose artifacts would be built, and the environment each is built in. */
|
|
367
367
|
build: Array<{ component: string; env: string }>;
|
|
368
368
|
/** The components whose artifacts would be carried from an earlier release. */
|
|
@@ -434,7 +434,7 @@ export async function planRelease(req: CutRequest): Promise<CutPlan> {
|
|
|
434
434
|
label: req.label,
|
|
435
435
|
releaseDigest,
|
|
436
436
|
alreadyCut,
|
|
437
|
-
targets: targets.map((t) => ({ env: t.env, params: t.params, templates: t.templates.map(({ component, path }) => ({ component, path })) })),
|
|
437
|
+
targets: targets.map((t) => ({ env: t.env, params: t.params, templates: t.templates.map(({ component, path }) => ({ component, path })), ...(t.trees ? { trees: t.trees } : {}) })),
|
|
438
438
|
build,
|
|
439
439
|
reused: p.reused,
|
|
440
440
|
publishSteps: [...steps.values()],
|
|
@@ -33,6 +33,7 @@ import { warnOnLegacyDigests, withoutReadFlags, type LegacyDigestFlag } from "./
|
|
|
33
33
|
import { appendReleaseRecordLine, readReleaseLedgerLines, listLedgerEnvironments as gitListLedgerEnvironments, type LedgerLocation } from "./git";
|
|
34
34
|
import { parseReleaseLedger, validateReleaseRecord } from "./release-read";
|
|
35
35
|
import type { GateResolutionRecord } from "./gate-ledger";
|
|
36
|
+
import { NEXT_RELEASE } from "../release-floors";
|
|
36
37
|
|
|
37
38
|
// The pure readers live apart, so a bundle can import them without git (#3865).
|
|
38
39
|
export { validateReleaseRecord, parseReleaseLedger, releaseLedgerLines, readReleaseRecords, listReleaseEnvironmentsOn } from "./release-read";
|
|
@@ -75,6 +76,13 @@ export const RUN_ORIGIN_CHANT_FLOOR = "0.124.30";
|
|
|
75
76
|
/** The first chant that writes `runOrigin.jobId` and `runOrigin.attempt`, for a forge job that ran `chant ci run` (#4156). */
|
|
76
77
|
export const RUN_ORIGIN_JOB_FLOOR = "0.124.32";
|
|
77
78
|
|
|
79
|
+
/**
|
|
80
|
+
* The first chant that writes and reads `releaseVersion` on a release record
|
|
81
|
+
* (#4595). A record from an older chant has none, and a reader lists it by
|
|
82
|
+
* digest.
|
|
83
|
+
*/
|
|
84
|
+
export const RELEASE_VERSION_FLOOR = NEXT_RELEASE;
|
|
85
|
+
|
|
78
86
|
/**
|
|
79
87
|
* The gate resolution that admitted a deploy (#4020): the gate's address in the
|
|
80
88
|
* gate ledger (`_gates/<op>.jsonl`, `op` and `gate`) and when the resolution
|
|
@@ -260,6 +268,16 @@ export interface ReleaseRecord {
|
|
|
260
268
|
* ({@link isApplyRecord}).
|
|
261
269
|
*/
|
|
262
270
|
digestKind?: ReleaseDigestKind;
|
|
271
|
+
/**
|
|
272
|
+
* Optional: the version the publish gave this release (#4595), such as a
|
|
273
|
+
* module's `1.4.0` or a package's `2.0.0-rc.1`, when the component has
|
|
274
|
+
* versions of its own. `version` is taken by the record's schema version,
|
|
275
|
+
* so the field has this name. Written from {@link RELEASE_VERSION_FLOOR};
|
|
276
|
+
* absent on older records and on deploys that name no version. The
|
|
277
|
+
* release catalog (./release-catalog.ts) lists a version by it, and a
|
|
278
|
+
* record without one by its digest.
|
|
279
|
+
*/
|
|
280
|
+
releaseVersion?: string;
|
|
263
281
|
}
|
|
264
282
|
|
|
265
283
|
/** What a release record's `digest` names when it is not an artifact digest (#4274). */
|
|
@@ -400,6 +418,8 @@ export async function appendReleaseRecord(
|
|
|
400
418
|
opts?: { cwd?: string },
|
|
401
419
|
): Promise<{ commit: string; record: ReleaseRecord }> {
|
|
402
420
|
const missing = validateReleaseRecord(input);
|
|
421
|
+
// #4595: a version, when given, is a non-empty string, so a reader never sees `""` or a number.
|
|
422
|
+
if (input.releaseVersion !== undefined && (typeof input.releaseVersion !== "string" || input.releaseVersion.length === 0)) missing.push("releaseVersion");
|
|
403
423
|
if (missing.length > 0) throw new InvalidReleaseRecordError(missing);
|
|
404
424
|
|
|
405
425
|
// `flags` are read-side only (#2514); a record passed back in never persists them.
|
|
@@ -141,17 +141,25 @@ export type PublishFetch = (
|
|
|
141
141
|
init: { method: string; headers: Record<string, string>; body?: Uint8Array | string; redirect?: "follow" | "manual" },
|
|
142
142
|
) => Promise<{ ok: boolean; status: number; headers: { get(name: string): string | null }; text(): Promise<string> }>;
|
|
143
143
|
|
|
144
|
-
/**
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
144
|
+
/**
|
|
145
|
+
* The part of a target's context every kind of target is given, whatever it
|
|
146
|
+
* publishes (#4602). A release target gets {@link PublishContext}, which adds
|
|
147
|
+
* the release; a target outside `release.publish`, such as the terraform
|
|
148
|
+
* lexicon's module targets, extends this with its own fields (a module
|
|
149
|
+
* version, its archive) and implements `PublishTarget<ItsContext, string>`,
|
|
150
|
+
* reusing {@link PublishTargetError}, {@link PublishFetch}, {@link PublishDeps}
|
|
151
|
+
* and the credential helpers in ./publish-credentials.ts.
|
|
152
|
+
*/
|
|
153
|
+
export interface PublishContextBase {
|
|
154
|
+
/** The directory the declaration's paths are relative to. */
|
|
154
155
|
cwd: string;
|
|
156
|
+
/** The environment credentials are read from. */
|
|
157
|
+
env: NodeJS.ProcessEnv;
|
|
158
|
+
/** Masks credentials; every line a target logs and every error it throws goes through it. */
|
|
159
|
+
redactor: Redactor;
|
|
160
|
+
/** Print one line of progress. The line is redacted. */
|
|
161
|
+
log(line: string): void;
|
|
162
|
+
provenance: ProvenanceCheck;
|
|
155
163
|
/**
|
|
156
164
|
* The tag a reveal points at what was staged, in place of the target's
|
|
157
165
|
* own: npm's dist-tag (default `latest`) and the OCI tags. Null for the
|
|
@@ -159,12 +167,18 @@ export interface PublishContext {
|
|
|
159
167
|
* ({@link NPM_STAGE_TAG}) and OCI by digest.
|
|
160
168
|
*/
|
|
161
169
|
tag: string | null;
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
|
|
166
|
-
|
|
167
|
-
|
|
170
|
+
}
|
|
171
|
+
|
|
172
|
+
/** What a release target is given to plan and to publish. */
|
|
173
|
+
export interface PublishContext extends PublishContextBase {
|
|
174
|
+
release: Release;
|
|
175
|
+
label: string | null;
|
|
176
|
+
/** The tag the cut made for the release, `release/<label>` or `release/<member>/<label>`, or null for a release with no label. */
|
|
177
|
+
releaseTag: string | null;
|
|
178
|
+
/** The cut whose signature the provenance statement carries (#4049), or null when none is known. */
|
|
179
|
+
cut?: PublishCut | null;
|
|
180
|
+
/** The member's directory, which the declaration's paths are relative to. */
|
|
181
|
+
cwd: string;
|
|
168
182
|
/**
|
|
169
183
|
* Whether a target with no SBOM source refuses (`publish-sbom-missing`),
|
|
170
184
|
* as under the `supply-chain` group (#4168). False or absent: it publishes
|
|
@@ -185,6 +199,9 @@ export class PublishTargetError extends Error {
|
|
|
185
199
|
}
|
|
186
200
|
}
|
|
187
201
|
|
|
202
|
+
/** The kinds `release.publish` declares and `createPublishTargets` makes. */
|
|
203
|
+
export type ReleasePublishKind = "npm" | "oci" | "forge";
|
|
204
|
+
|
|
188
205
|
/** The npm dist-tag a set of packages is staged under before `latest` moves (#4048), as chant's own releases do (#3903). */
|
|
189
206
|
export const NPM_STAGE_TAG = "next";
|
|
190
207
|
|
|
@@ -196,10 +213,16 @@ export const NPM_STAGE_TAG = "next";
|
|
|
196
213
|
* (./publish-declaration.ts) and made by `createPublishTargets`
|
|
197
214
|
* (./publish-targets.ts). A new kind of target is a new member of the
|
|
198
215
|
* declaration's union and a factory that returns this interface.
|
|
216
|
+
*
|
|
217
|
+
* The context is a type parameter (#4602): a target that publishes something
|
|
218
|
+
* other than a cut release, such as a module version, implements
|
|
219
|
+
* `PublishTarget<C, K>` over its own context `C`, which extends
|
|
220
|
+
* {@link PublishContextBase}, with its own `kind` names `K`. Such targets are
|
|
221
|
+
* made by their own code, never by `createPublishTargets`.
|
|
199
222
|
*/
|
|
200
|
-
export interface PublishTarget {
|
|
201
|
-
/** The declaration's `type
|
|
202
|
-
kind:
|
|
223
|
+
export interface PublishTarget<C extends PublishContextBase = PublishContext, K extends string = ReleasePublishKind> {
|
|
224
|
+
/** The declaration's `type`: one of {@link ReleasePublishKind} under `release.publish`, any name for a target outside it. */
|
|
225
|
+
kind: K;
|
|
203
226
|
/** A name for messages, such as `npm (2 packages)`. */
|
|
204
227
|
name: string;
|
|
205
228
|
/** Where it publishes, for the line printed before it runs. */
|
|
@@ -219,7 +242,7 @@ export interface PublishTarget {
|
|
|
219
242
|
* {@link PublishTargetError}. The dry run prints what it returns, and a
|
|
220
243
|
* publish plans every target before any of them publishes.
|
|
221
244
|
*/
|
|
222
|
-
plan(ctx:
|
|
245
|
+
plan(ctx: C): Promise<PublishItem[]>;
|
|
223
246
|
/**
|
|
224
247
|
* Put every item where the target publishes, where no consumer resolves it
|
|
225
248
|
* yet (#4048): npm under the `next` dist-tag, OCI by digest with no tag
|
|
@@ -228,7 +251,7 @@ export interface PublishTarget {
|
|
|
228
251
|
* again and comes back `present`, so a stage run again after a failure
|
|
229
252
|
* sends only what is missing. Throws {@link PublishTargetError}.
|
|
230
253
|
*/
|
|
231
|
-
stage(ctx:
|
|
254
|
+
stage(ctx: C): Promise<StagedTarget>;
|
|
232
255
|
/**
|
|
233
256
|
* The one last step that makes what {@link stage} put out visible: npm
|
|
234
257
|
* moves `latest` (or `ctx.tag`) package by package in the declared order,
|
|
@@ -236,7 +259,7 @@ export interface PublishTarget {
|
|
|
236
259
|
* publishes the draft (GitLab: creates the release with its links). Run
|
|
237
260
|
* again, it moves nothing that already moved. Throws {@link PublishTargetError}.
|
|
238
261
|
*/
|
|
239
|
-
reveal(ctx:
|
|
262
|
+
reveal(ctx: C, staged: StagedTarget): Promise<PublishedTarget>;
|
|
240
263
|
}
|
|
241
264
|
|
|
242
265
|
/** The targets the member at `cwd` declares under `release.publish` in its `chant.config.ts`. */
|
|
@@ -46,6 +46,8 @@ export function parseReleaseLedger(lines: readonly string[]): { records: Release
|
|
|
46
46
|
malformed++;
|
|
47
47
|
continue;
|
|
48
48
|
}
|
|
49
|
+
// #4595: a `releaseVersion` that is not a non-empty string is dropped; the record still reads, listed by digest.
|
|
50
|
+
if ("releaseVersion" in parsed && (typeof parsed.releaseVersion !== "string" || parsed.releaseVersion.length === 0)) delete (parsed as { releaseVersion?: unknown }).releaseVersion;
|
|
49
51
|
records.push(flagLegacyDigest(parsed, [parsed.digest, parsed.manifestDigest, parsed.inputDigest]));
|
|
50
52
|
} catch {
|
|
51
53
|
malformed++;
|
|
@@ -0,0 +1,186 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Release status records (#4596): append, the latest line per digest wins,
|
|
3
|
+
* the member prefix, `--no-record`, and `chant ledger release_status`
|
|
4
|
+
* listing the table.
|
|
5
|
+
*/
|
|
6
|
+
import { afterEach, describe, expect, test } from "vitest";
|
|
7
|
+
import { execFileSync } from "node:child_process";
|
|
8
|
+
import { mkdirSync, mkdtempSync, realpathSync, rmSync, writeFileSync } from "node:fs";
|
|
9
|
+
import { tmpdir } from "node:os";
|
|
10
|
+
import { dirname, join } from "node:path";
|
|
11
|
+
import { NEXT_RELEASE } from "../release-floors";
|
|
12
|
+
import { gitLedgerReadPort } from "./git";
|
|
13
|
+
import { readLedgerTable } from "./ledger-read";
|
|
14
|
+
import { clearMemberLedgerCache } from "./member-ledger";
|
|
15
|
+
import { resetNoRecordLedger } from "./no-record";
|
|
16
|
+
import { LEDGER_RELEASE_STATUS_FLOOR, loadQueryData, QUERY_TABLES } from "./query";
|
|
17
|
+
import { buildReleaseCatalog } from "./release-catalog";
|
|
18
|
+
import type { ReleaseRecord } from "./release-ledger";
|
|
19
|
+
import {
|
|
20
|
+
appendReleaseStatus,
|
|
21
|
+
catalogStatusInputs,
|
|
22
|
+
parseReleaseStatus,
|
|
23
|
+
readReleaseStatus,
|
|
24
|
+
readReleaseStatusOn,
|
|
25
|
+
RELEASE_STATUS_FLOOR,
|
|
26
|
+
ReleaseStatusError,
|
|
27
|
+
statusOf,
|
|
28
|
+
type ReleaseStatusInput,
|
|
29
|
+
} from "./release-status";
|
|
30
|
+
|
|
31
|
+
const scratch: string[] = [];
|
|
32
|
+
afterEach(() => {
|
|
33
|
+
delete process.env.CHANT_NO_RECORD;
|
|
34
|
+
resetNoRecordLedger();
|
|
35
|
+
clearMemberLedgerCache();
|
|
36
|
+
for (const d of scratch.splice(0)) rmSync(d, { recursive: true, force: true });
|
|
37
|
+
});
|
|
38
|
+
|
|
39
|
+
function git(args: string[], cwd: string): string {
|
|
40
|
+
return execFileSync("git", ["-c", "commit.gpgsign=false", ...args], { cwd, encoding: "utf-8", stdio: ["ignore", "pipe", "pipe"] }).trim();
|
|
41
|
+
}
|
|
42
|
+
|
|
43
|
+
function repo(files: Record<string, string> = { "README.md": "fixture\n" }): string {
|
|
44
|
+
const root = realpathSync(mkdtempSync(join(tmpdir(), "chant-release-status-")));
|
|
45
|
+
scratch.push(root);
|
|
46
|
+
for (const [path, text] of Object.entries(files)) {
|
|
47
|
+
mkdirSync(dirname(join(root, path)), { recursive: true });
|
|
48
|
+
writeFileSync(join(root, path), text);
|
|
49
|
+
}
|
|
50
|
+
git(["init", "-q", "-b", "main"], root);
|
|
51
|
+
git(["config", "user.email", "test@chant.dev"], root);
|
|
52
|
+
git(["config", "user.name", "Test"], root);
|
|
53
|
+
git(["add", "-A"], root);
|
|
54
|
+
git(["commit", "-q", "-m", "init"], root);
|
|
55
|
+
return root;
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
function branchFiles(root: string): string[] {
|
|
59
|
+
try {
|
|
60
|
+
return git(["ls-tree", "-r", "--name-only", "chant/lifecycle"], root).split("\n").filter(Boolean).sort();
|
|
61
|
+
} catch {
|
|
62
|
+
return [];
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
|
|
66
|
+
const status = (over: Partial<ReleaseStatusInput> = {}): ReleaseStatusInput => ({
|
|
67
|
+
component: "vpc/aws",
|
|
68
|
+
env: "registry",
|
|
69
|
+
digest: "sha256:v2",
|
|
70
|
+
releaseVersion: "2.0.0",
|
|
71
|
+
status: "deprecated",
|
|
72
|
+
reason: "use 2.1.0",
|
|
73
|
+
replacement: "2.1.0",
|
|
74
|
+
actor: "ana",
|
|
75
|
+
timestamp: "2026-10-20T00:00:00.000Z",
|
|
76
|
+
...over,
|
|
77
|
+
});
|
|
78
|
+
|
|
79
|
+
describe("release status floors", () => {
|
|
80
|
+
test("are the next release", () => {
|
|
81
|
+
expect(RELEASE_STATUS_FLOOR).toBe(NEXT_RELEASE);
|
|
82
|
+
expect(LEDGER_RELEASE_STATUS_FLOOR).toBe(NEXT_RELEASE);
|
|
83
|
+
});
|
|
84
|
+
});
|
|
85
|
+
|
|
86
|
+
describe("appendReleaseStatus (#4596)", () => {
|
|
87
|
+
test("refuses a record the reader would skip, before any git runs", async () => {
|
|
88
|
+
await expect(appendReleaseStatus(status({ status: "gone" as never }), { cwd: "/nonexistent" })).rejects.toBeInstanceOf(ReleaseStatusError);
|
|
89
|
+
await expect(appendReleaseStatus(status({ actor: "" }), { cwd: "/nonexistent" })).rejects.toBeInstanceOf(ReleaseStatusError);
|
|
90
|
+
await expect(appendReleaseStatus(status({ reason: "" }), { cwd: "/nonexistent" })).rejects.toBeInstanceOf(ReleaseStatusError);
|
|
91
|
+
});
|
|
92
|
+
|
|
93
|
+
test("appends one line beside releases.jsonl and reads it back", async () => {
|
|
94
|
+
const root = repo();
|
|
95
|
+
const { record } = await appendReleaseStatus(status(), { cwd: root });
|
|
96
|
+
expect(record.version).toBe(1);
|
|
97
|
+
expect(branchFiles(root)).toEqual(["registry/release-status.jsonl"]);
|
|
98
|
+
const { records, malformed } = await readReleaseStatus("registry", { cwd: root });
|
|
99
|
+
expect(malformed).toBe(0);
|
|
100
|
+
expect(records).toEqual([record]);
|
|
101
|
+
});
|
|
102
|
+
|
|
103
|
+
test("the latest line per digest wins, and a restore is one more line", async () => {
|
|
104
|
+
const root = repo();
|
|
105
|
+
await appendReleaseStatus(status({ status: "yanked", timestamp: "2026-10-20T00:00:00.000Z" }), { cwd: root });
|
|
106
|
+
await appendReleaseStatus(status({ status: "active", reason: "fixed upstream", replacement: undefined, actor: "bo", timestamp: "2026-10-21T00:00:00.000Z" }), { cwd: root });
|
|
107
|
+
await appendReleaseStatus(status({ digest: "sha256:v1", releaseVersion: "1.0.0", status: "deprecated", timestamp: "2026-10-21T00:00:00.000Z" }), { cwd: root });
|
|
108
|
+
const { records } = await readReleaseStatus("registry", { cwd: root });
|
|
109
|
+
expect(records).toHaveLength(3);
|
|
110
|
+
expect(statusOf(records, "vpc/aws", "sha256:v2")).toMatchObject({ status: "active", record: { actor: "bo" } });
|
|
111
|
+
expect(statusOf(records, "vpc/aws", "sha256:v1").status).toBe("deprecated");
|
|
112
|
+
expect(statusOf(records, "vpc/aws", "sha256:never")).toEqual({ status: "active" });
|
|
113
|
+
expect(statusOf(records, "other", "sha256:v2")).toEqual({ status: "active" });
|
|
114
|
+
});
|
|
115
|
+
|
|
116
|
+
test("a tie in time goes to the later line", () => {
|
|
117
|
+
const lines = [status({ status: "yanked" }), status({ status: "deprecated" })].map((s) => JSON.stringify({ version: 1, ...s })).join("\n");
|
|
118
|
+
expect(statusOf(parseReleaseStatus(lines).records, "vpc/aws", "sha256:v2").status).toBe("deprecated");
|
|
119
|
+
});
|
|
120
|
+
|
|
121
|
+
test("a malformed line is counted and skipped", () => {
|
|
122
|
+
const good = JSON.stringify({ version: 1, ...status() });
|
|
123
|
+
const { records, malformed } = parseReleaseStatus(`${good}\n{\n${JSON.stringify({ version: 2, ...status() })}\n${JSON.stringify({ version: 1, ...status({ status: "gone" as never }) })}\n`);
|
|
124
|
+
expect(records).toHaveLength(1);
|
|
125
|
+
expect(malformed).toBe(3);
|
|
126
|
+
});
|
|
127
|
+
|
|
128
|
+
test("writes under the member prefix of cwd", async () => {
|
|
129
|
+
const CONFIG = JSON.stringify({ lexicons: ["terraform"] });
|
|
130
|
+
const root = repo({
|
|
131
|
+
"chant.workspace.json": JSON.stringify({ name: "acme", schema: 1, members: [{ name: "modules", dir: "modules", kind: "chant" }] }),
|
|
132
|
+
"modules/chant.config.json": CONFIG,
|
|
133
|
+
});
|
|
134
|
+
await appendReleaseStatus(status(), { cwd: join(root, "modules") });
|
|
135
|
+
expect(branchFiles(root)).toEqual(["_members/modules/registry/release-status.jsonl"]);
|
|
136
|
+
expect((await readReleaseStatus("registry", { cwd: join(root, "modules") })).records).toHaveLength(1);
|
|
137
|
+
expect((await readReleaseStatus("registry", { cwd: root, member: "modules" })).records).toHaveLength(1);
|
|
138
|
+
expect((await readReleaseStatus("registry", { cwd: root })).records).toEqual([]);
|
|
139
|
+
});
|
|
140
|
+
|
|
141
|
+
test("with --no-record the line reads back in process and the branch is unchanged", async () => {
|
|
142
|
+
const root = repo();
|
|
143
|
+
process.env.CHANT_NO_RECORD = "1";
|
|
144
|
+
await appendReleaseStatus(status(), { cwd: root });
|
|
145
|
+
expect((await readReleaseStatus("registry", { cwd: root })).records).toHaveLength(1);
|
|
146
|
+
expect(branchFiles(root)).toEqual([]);
|
|
147
|
+
});
|
|
148
|
+
});
|
|
149
|
+
|
|
150
|
+
describe("the release_status table (#4596)", () => {
|
|
151
|
+
test("chant query loads every line", async () => {
|
|
152
|
+
const root = repo();
|
|
153
|
+
await appendReleaseStatus(status({ status: "yanked" }), { cwd: root });
|
|
154
|
+
await appendReleaseStatus(status({ status: "active", reason: undefined, replacement: undefined, releaseVersion: undefined, timestamp: "2026-10-22T00:00:00.000Z" }), { cwd: root });
|
|
155
|
+
const { data, malformed } = await loadQueryData([{ member: null, port: gitLedgerReadPort({ cwd: root }) }]);
|
|
156
|
+
expect(malformed.release_status).toBe(0);
|
|
157
|
+
expect(QUERY_TABLES.release_status.map(([c]) => c)).toEqual(["member", "env", "component", "digest", "release_version", "status", "reason", "replacement", "actor", "timestamp"]);
|
|
158
|
+
expect(data.release_status).toEqual([
|
|
159
|
+
{ member: null, env: "registry", component: "vpc/aws", digest: "sha256:v2", release_version: "2.0.0", status: "yanked", reason: "use 2.1.0", replacement: "2.1.0", actor: "ana", timestamp: "2026-10-20T00:00:00.000Z" },
|
|
160
|
+
{ member: null, env: "registry", component: "vpc/aws", digest: "sha256:v2", release_version: null, status: "active", reason: null, replacement: null, actor: "ana", timestamp: "2026-10-22T00:00:00.000Z" },
|
|
161
|
+
]);
|
|
162
|
+
});
|
|
163
|
+
|
|
164
|
+
test("chant ledger release_status lists it, filtered", async () => {
|
|
165
|
+
const root = repo();
|
|
166
|
+
await appendReleaseStatus(status({ status: "yanked" }), { cwd: root });
|
|
167
|
+
await appendReleaseStatus(status({ digest: "sha256:v1", releaseVersion: "1.0.0" }), { cwd: root });
|
|
168
|
+
const doc = await readLedgerTable("release_status", [{ member: null, port: gitLedgerReadPort({ cwd: root }) }], { where: ["status=yanked"] });
|
|
169
|
+
if (!("rows" in doc)) throw new Error(JSON.stringify(doc));
|
|
170
|
+
expect(doc.table).toBe("release_status");
|
|
171
|
+
expect(doc.total).toBe(2);
|
|
172
|
+
expect(doc.rows.map((r) => r.digest)).toEqual(["sha256:v2"]);
|
|
173
|
+
});
|
|
174
|
+
});
|
|
175
|
+
|
|
176
|
+
describe("catalogStatusInputs", () => {
|
|
177
|
+
test("feeds the release catalog", async () => {
|
|
178
|
+
const root = repo();
|
|
179
|
+
await appendReleaseStatus(status({ status: "yanked", reason: "breaks routes" }), { cwd: root });
|
|
180
|
+
const { records } = await readReleaseStatusOn(gitLedgerReadPort({ cwd: root }), "registry");
|
|
181
|
+
const release: ReleaseRecord = { version: 1, component: "vpc/aws", env: "registry", digest: "sha256:v2", releaseVersion: "2.0.0", gitSha: "a".repeat(40), runId: "r1", timestamp: "2026-10-01T00:00:00.000Z", actor: "ci" };
|
|
182
|
+
const catalog = buildReleaseCatalog({ releases: [release], statuses: catalogStatusInputs(records) }, { generatedAt: "2026-10-27T00:00:00.000Z" });
|
|
183
|
+
expect(catalog.components[0].versions[0].status).toMatchObject({ state: "yanked", reason: "breaks routes", replacement: "2.1.0" });
|
|
184
|
+
expect(catalog.components[0].latest).toBeNull();
|
|
185
|
+
});
|
|
186
|
+
});
|
|
@@ -0,0 +1,176 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Release status records (#4596, terragucci#1289 bundle B): deprecate, yank
|
|
3
|
+
* and restore a release, one line per change at
|
|
4
|
+
* `<env>/release-status.jsonl`, beside the `releases.jsonl` it speaks about.
|
|
5
|
+
*
|
|
6
|
+
* The latest line per digest wins, so a restore is one more line with
|
|
7
|
+
* `status: "active"` and nothing is ever rewritten. Any identity that may
|
|
8
|
+
* publish may append one (ruling C, 2026-10-27): there is no approval gate,
|
|
9
|
+
* and the record carries the actor and the reason instead.
|
|
10
|
+
*
|
|
11
|
+
* Writes go through `appendLedgerLine` (./git.ts), so they land under the
|
|
12
|
+
* member prefix of `cwd` and honour `--no-record` (`CHANT_NO_RECORD`), as the
|
|
13
|
+
* writers of #4551 do. Nothing here pushes: the caller runs
|
|
14
|
+
* `pushLifecycleReport` after, the two-step shape every ledger here uses.
|
|
15
|
+
*
|
|
16
|
+
* The parse and the reads over a {@link LedgerReadPort} are pure. git is
|
|
17
|
+
* loaded only by {@link appendReleaseStatus} and {@link readReleaseStatus},
|
|
18
|
+
* so `chant query` (./query.ts) and a product bundle read the table without
|
|
19
|
+
* it.
|
|
20
|
+
*/
|
|
21
|
+
import { NEXT_RELEASE } from "../release-floors";
|
|
22
|
+
import type { LedgerReadPort } from "./ledger-port";
|
|
23
|
+
import type { LedgerLocation } from "./git";
|
|
24
|
+
import type { CatalogStatusInput, ReleaseStatusValue } from "./release-catalog";
|
|
25
|
+
|
|
26
|
+
/** The first chant that writes and reads `<env>/release-status.jsonl`, and lists the `release_status` table (#4596). */
|
|
27
|
+
export const RELEASE_STATUS_FLOOR = NEXT_RELEASE;
|
|
28
|
+
|
|
29
|
+
/** The file a status record is appended to, in its environment's directory. */
|
|
30
|
+
export const RELEASE_STATUS_FILE = "release-status.jsonl";
|
|
31
|
+
|
|
32
|
+
/** The statuses a record may set. */
|
|
33
|
+
export const RELEASE_STATUSES = ["active", "deprecated", "yanked"] as const satisfies readonly ReleaseStatusValue[];
|
|
34
|
+
|
|
35
|
+
/** One status change for one release. */
|
|
36
|
+
export interface ReleaseStatusRecord {
|
|
37
|
+
/** Schema version of the line. */
|
|
38
|
+
version: 1;
|
|
39
|
+
/** The component the release belongs to (`ReleaseRecord.component`). */
|
|
40
|
+
component: string;
|
|
41
|
+
/** The environment whose ledger holds the release, and this line. */
|
|
42
|
+
env: string;
|
|
43
|
+
/** The release's digest, the key the latest line is taken by. */
|
|
44
|
+
digest: string;
|
|
45
|
+
/** The release's version (`ReleaseRecord.releaseVersion`), when known. */
|
|
46
|
+
releaseVersion?: string;
|
|
47
|
+
/** `deprecated` and `yanked` mark the release; `active` restores it. */
|
|
48
|
+
status: ReleaseStatusValue;
|
|
49
|
+
/** Why, in the actor's words. */
|
|
50
|
+
reason?: string;
|
|
51
|
+
/** The version to move to instead. */
|
|
52
|
+
replacement?: string;
|
|
53
|
+
/** Who set it. */
|
|
54
|
+
actor: string;
|
|
55
|
+
/** ISO-8601 time it was set, given by the caller. */
|
|
56
|
+
timestamp: string;
|
|
57
|
+
}
|
|
58
|
+
|
|
59
|
+
/** The fields a caller gives; `version` is filled in. */
|
|
60
|
+
export type ReleaseStatusInput = Omit<ReleaseStatusRecord, "version">;
|
|
61
|
+
|
|
62
|
+
/** A status record the reader would skip, so it is never appended. */
|
|
63
|
+
export class ReleaseStatusError extends Error {
|
|
64
|
+
constructor(message: string) {
|
|
65
|
+
super(message);
|
|
66
|
+
this.name = "ReleaseStatusError";
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
|
|
70
|
+
const REQUIRED = ["component", "env", "digest", "actor", "timestamp"] as const;
|
|
71
|
+
const OPTIONAL = ["releaseVersion", "reason", "replacement"] as const;
|
|
72
|
+
|
|
73
|
+
/** Why `value` is not a status record, one line per problem; empty when it is one. */
|
|
74
|
+
export function releaseStatusProblems(value: unknown): string[] {
|
|
75
|
+
if (value === null || typeof value !== "object" || Array.isArray(value)) return ["not an object"];
|
|
76
|
+
const r = value as Record<string, unknown>;
|
|
77
|
+
const problems: string[] = [];
|
|
78
|
+
if (r.version !== 1) problems.push("version is not 1");
|
|
79
|
+
for (const k of REQUIRED) if (typeof r[k] !== "string" || (r[k] as string).length === 0) problems.push(`${k} is missing`);
|
|
80
|
+
for (const k of OPTIONAL) if (r[k] !== undefined && (typeof r[k] !== "string" || (r[k] as string).length === 0)) problems.push(`${k} is not a non-empty string`);
|
|
81
|
+
if (!(RELEASE_STATUSES as readonly unknown[]).includes(r.status)) problems.push(`status is not one of ${RELEASE_STATUSES.join(", ")}`);
|
|
82
|
+
return problems;
|
|
83
|
+
}
|
|
84
|
+
|
|
85
|
+
/** Parse a `release-status.jsonl` text, oldest first. A line that is not a record is counted and skipped. */
|
|
86
|
+
export function parseReleaseStatus(text: string | null): { records: ReleaseStatusRecord[]; malformed: number } {
|
|
87
|
+
const records: ReleaseStatusRecord[] = [];
|
|
88
|
+
let malformed = 0;
|
|
89
|
+
for (const line of (text ?? "").split("\n").map((l) => l.trim()).filter(Boolean)) {
|
|
90
|
+
try {
|
|
91
|
+
const parsed = JSON.parse(line) as unknown;
|
|
92
|
+
if (releaseStatusProblems(parsed).length > 0) {
|
|
93
|
+
malformed++;
|
|
94
|
+
continue;
|
|
95
|
+
}
|
|
96
|
+
records.push(parsed as ReleaseStatusRecord);
|
|
97
|
+
} catch {
|
|
98
|
+
malformed++;
|
|
99
|
+
}
|
|
100
|
+
}
|
|
101
|
+
return { records, malformed };
|
|
102
|
+
}
|
|
103
|
+
|
|
104
|
+
/**
|
|
105
|
+
* The latest record per component and digest: the newest `timestamp`, ties
|
|
106
|
+
* going to the later line. Keyed `<component>\0<digest>`; use
|
|
107
|
+
* {@link statusOf} to look one up.
|
|
108
|
+
*/
|
|
109
|
+
export function latestReleaseStatus(records: readonly ReleaseStatusRecord[]): Map<string, ReleaseStatusRecord> {
|
|
110
|
+
const latest = new Map<string, ReleaseStatusRecord>();
|
|
111
|
+
for (const r of records) {
|
|
112
|
+
const key = `${r.component}\u0000${r.digest}`;
|
|
113
|
+
const cur = latest.get(key);
|
|
114
|
+
if (!cur || r.timestamp >= cur.timestamp) latest.set(key, r);
|
|
115
|
+
}
|
|
116
|
+
return latest;
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
/**
|
|
120
|
+
* The status of one release: the latest record for its component and
|
|
121
|
+
* digest, or `active` with no record when none was ever set.
|
|
122
|
+
*/
|
|
123
|
+
export function statusOf(
|
|
124
|
+
records: readonly ReleaseStatusRecord[],
|
|
125
|
+
component: string,
|
|
126
|
+
digest: string,
|
|
127
|
+
): { status: ReleaseStatusValue; record?: ReleaseStatusRecord } {
|
|
128
|
+
const record = latestReleaseStatus(records).get(`${component}\u0000${digest}`);
|
|
129
|
+
return record ? { status: record.status, record } : { status: "active" };
|
|
130
|
+
}
|
|
131
|
+
|
|
132
|
+
/** The records as the release catalog's status input (./release-catalog.ts). */
|
|
133
|
+
export function catalogStatusInputs(records: readonly ReleaseStatusRecord[]): CatalogStatusInput[] {
|
|
134
|
+
return records.map((r) => ({
|
|
135
|
+
component: r.component,
|
|
136
|
+
digest: r.digest,
|
|
137
|
+
...(r.releaseVersion ? { version: r.releaseVersion } : {}),
|
|
138
|
+
status: r.status,
|
|
139
|
+
...(r.reason ? { reason: r.reason } : {}),
|
|
140
|
+
...(r.replacement ? { replacement: r.replacement } : {}),
|
|
141
|
+
actor: r.actor,
|
|
142
|
+
timestamp: r.timestamp,
|
|
143
|
+
}));
|
|
144
|
+
}
|
|
145
|
+
|
|
146
|
+
/** Every status record of `environment` the port holds, oldest first. */
|
|
147
|
+
export async function readReleaseStatusOn(port: LedgerReadPort, environment: string): Promise<{ records: ReleaseStatusRecord[]; malformed: number }> {
|
|
148
|
+
return parseReleaseStatus(await port.read(environment, RELEASE_STATUS_FILE));
|
|
149
|
+
}
|
|
150
|
+
|
|
151
|
+
/**
|
|
152
|
+
* Append one status record to `<env>/release-status.jsonl` under the member
|
|
153
|
+
* prefix of `opts.cwd`. Refuses a record the reader would skip, before any
|
|
154
|
+
* git runs. Does not push.
|
|
155
|
+
*/
|
|
156
|
+
export async function appendReleaseStatus(input: ReleaseStatusInput, opts?: { cwd?: string }): Promise<{ commit: string; record: ReleaseStatusRecord }> {
|
|
157
|
+
const record: ReleaseStatusRecord = { version: 1, ...input };
|
|
158
|
+
const problems = releaseStatusProblems(record);
|
|
159
|
+
if (problems.length > 0) throw new ReleaseStatusError(`not a release status record: ${problems.join("; ")}`);
|
|
160
|
+
const { appendLedgerLine } = await import("./git");
|
|
161
|
+
const label = record.releaseVersion ?? record.digest;
|
|
162
|
+
const commit = await appendLedgerLine(record.env, RELEASE_STATUS_FILE, JSON.stringify(record), `Release status: ${record.component} ${label} ${record.status}`, opts);
|
|
163
|
+
return { commit, record };
|
|
164
|
+
}
|
|
165
|
+
|
|
166
|
+
/**
|
|
167
|
+
* Every status record of `environment` on the local `chant/lifecycle`,
|
|
168
|
+
* oldest first, for the member `location` resolves to. Never fetches.
|
|
169
|
+
*/
|
|
170
|
+
export async function readReleaseStatus(
|
|
171
|
+
environment: string,
|
|
172
|
+
location?: LedgerLocation,
|
|
173
|
+
): Promise<{ records: ReleaseStatusRecord[]; malformed: number }> {
|
|
174
|
+
const { readBlobFromPath } = await import("./git");
|
|
175
|
+
return parseReleaseStatus(await readBlobFromPath(environment, RELEASE_STATUS_FILE, location));
|
|
176
|
+
}
|