@intentius/chant 0.124.54 → 0.124.56
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 +832 -0
- package/dist/ci-audit/attribution.d.ts +111 -0
- package/dist/ci-audit/attribution.d.ts.map +1 -0
- package/dist/ci-audit/attribution.js +194 -0
- package/dist/ci-audit/audit-log.d.ts +144 -0
- package/dist/ci-audit/audit-log.d.ts.map +1 -0
- package/dist/ci-audit/audit-log.js +149 -0
- package/dist/ci-audit/index.d.ts +12 -0
- package/dist/ci-audit/index.d.ts.map +1 -0
- package/dist/ci-audit/index.js +12 -0
- package/dist/ci-audit/unrecorded.d.ts +74 -0
- package/dist/ci-audit/unrecorded.d.ts.map +1 -0
- package/dist/ci-audit/unrecorded.js +95 -0
- package/dist/ci-audit.d.ts +3 -0
- package/dist/ci-audit.d.ts.map +1 -0
- package/dist/ci-audit.js +2 -0
- package/dist/ci-control.d.ts +42 -0
- package/dist/ci-control.d.ts.map +1 -0
- package/dist/ci-control.js +41 -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 +92 -0
- package/dist/ci-estate.d.ts.map +1 -0
- package/dist/ci-estate.js +82 -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 +86 -15
- package/dist/ci-job-guard.d.ts +139 -0
- package/dist/ci-job-guard.d.ts.map +1 -0
- package/dist/ci-job-guard.js +287 -0
- package/dist/ci-jobs.d.ts +7 -0
- package/dist/ci-jobs.d.ts.map +1 -1
- package/dist/ci-jobs.js +7 -0
- package/dist/ci-product-words.d.ts +296 -0
- package/dist/ci-product-words.d.ts.map +1 -0
- package/dist/ci-product-words.js +407 -0
- package/dist/ci-product.d.ts +117 -0
- package/dist/ci-product.d.ts.map +1 -0
- package/dist/ci-product.js +113 -0
- package/dist/ci-respond-run.d.ts +73 -0
- package/dist/ci-respond-run.d.ts.map +1 -0
- package/dist/ci-respond-run.js +247 -0
- package/dist/ci-respond.d.ts +189 -0
- package/dist/ci-respond.d.ts.map +1 -0
- package/dist/ci-respond.js +285 -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/audit-log.d.ts +12 -0
- package/dist/cli/handlers/audit-log.d.ts.map +1 -0
- package/dist/cli/handlers/audit-log.js +81 -0
- package/dist/cli/handlers/build.d.ts +7 -0
- package/dist/cli/handlers/build.d.ts.map +1 -1
- package/dist/cli/handlers/build.js +124 -1
- package/dist/cli/handlers/ci-check-job.d.ts +11 -0
- package/dist/cli/handlers/ci-check-job.d.ts.map +1 -0
- package/dist/cli/handlers/ci-check-job.js +27 -0
- 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 +63 -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/e2e-safe-run.d.ts +12 -0
- package/dist/cli/handlers/e2e-safe-run.d.ts.map +1 -0
- package/dist/cli/handlers/e2e-safe-run.js +23 -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 +43 -3
- package/dist/cli/handlers/pr.d.ts.map +1 -1
- package/dist/cli/handlers/pr.js +908 -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 +160 -2
- 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 +178 -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 +164 -3
- package/dist/cli/registry.d.ts +73 -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 +92 -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 +159 -5
- package/dist/components/capability.d.ts.map +1 -1
- package/dist/components/capability.js +39 -6
- package/dist/components/check-hooks.d.ts +116 -0
- package/dist/components/check-hooks.d.ts.map +1 -0
- package/dist/components/check-hooks.js +192 -0
- package/dist/components/check-steps.d.ts +74 -0
- package/dist/components/check-steps.d.ts.map +1 -0
- package/dist/components/check-steps.js +102 -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 +60 -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 +32 -3
- package/dist/components/driver.d.ts.map +1 -1
- package/dist/components/driver.js +59 -5
- 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 +23 -5
- 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 +38 -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 +32 -4
- package/dist/components/pr-environment.d.ts.map +1 -1
- package/dist/components/pr-environment.js +26 -8
- package/dist/components/pr-pipeline.d.ts +297 -5
- package/dist/components/pr-pipeline.d.ts.map +1 -1
- package/dist/components/pr-pipeline.js +329 -18
- 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 +71 -0
- package/dist/components/pr-run.d.ts.map +1 -1
- package/dist/components/pr-run.js +91 -7
- 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 +250 -0
- package/dist/components/product-pipeline.d.ts.map +1 -0
- package/dist/components/product-pipeline.js +212 -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 +42 -0
- package/dist/components/wave-plan.d.ts.map +1 -1
- package/dist/components/wave-plan.js +72 -4
- 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/e2e-harness/bucket.d.ts +21 -0
- package/dist/e2e-harness/bucket.d.ts.map +1 -0
- package/dist/e2e-harness/bucket.js +61 -0
- package/dist/e2e-harness/claim.d.ts +70 -0
- package/dist/e2e-harness/claim.d.ts.map +1 -0
- package/dist/e2e-harness/claim.js +98 -0
- package/dist/e2e-harness/driver.d.ts +64 -0
- package/dist/e2e-harness/driver.d.ts.map +1 -0
- package/dist/e2e-harness/driver.js +243 -0
- package/dist/e2e-harness/forgejo.d.ts +77 -0
- package/dist/e2e-harness/forgejo.d.ts.map +1 -0
- package/dist/e2e-harness/forgejo.js +205 -0
- package/dist/e2e-harness/git.d.ts +32 -0
- package/dist/e2e-harness/git.d.ts.map +1 -0
- package/dist/e2e-harness/git.js +67 -0
- package/dist/e2e-harness/index.d.ts +22 -0
- package/dist/e2e-harness/index.d.ts.map +1 -0
- package/dist/e2e-harness/index.js +48 -0
- package/dist/e2e-harness/jobs.d.ts +8 -0
- package/dist/e2e-harness/jobs.d.ts.map +1 -0
- package/dist/e2e-harness/jobs.js +34 -0
- package/dist/e2e-harness/pins.d.ts +45 -0
- package/dist/e2e-harness/pins.d.ts.map +1 -0
- package/dist/e2e-harness/pins.js +44 -0
- package/dist/e2e-harness/ports.d.ts +113 -0
- package/dist/e2e-harness/ports.d.ts.map +1 -0
- package/dist/e2e-harness/ports.js +4 -0
- package/dist/e2e-harness/reports.d.ts +45 -0
- package/dist/e2e-harness/reports.d.ts.map +1 -0
- package/dist/e2e-harness/reports.js +57 -0
- package/dist/e2e-harness/safe-run-cli.d.ts +17 -0
- package/dist/e2e-harness/safe-run-cli.d.ts.map +1 -0
- package/dist/e2e-harness/safe-run-cli.js +43 -0
- package/dist/e2e-harness/safe-run.d.ts +61 -0
- package/dist/e2e-harness/safe-run.d.ts.map +1 -0
- package/dist/e2e-harness/safe-run.js +172 -0
- package/dist/e2e-harness/scenario.d.ts +11 -0
- package/dist/e2e-harness/scenario.d.ts.map +1 -0
- package/dist/e2e-harness/scenario.js +89 -0
- package/dist/e2e-harness/schemas/demo-cycle.schema.json +282 -0
- package/dist/e2e-harness/schemas/demo-step.schema.json +245 -0
- package/dist/e2e-harness/schemas/e2e-claim-row.schema.json +33 -0
- package/dist/e2e-harness/schemas/e2e-claims.schema.json +18 -0
- package/dist/e2e-harness/schemas/e2e-scenario.schema.json +150 -0
- package/dist/e2e-harness/schemas/index.d.ts +191 -0
- package/dist/e2e-harness/schemas/index.d.ts.map +1 -0
- package/dist/e2e-harness/schemas/index.js +62 -0
- package/dist/e2e-harness/stack.d.ts +124 -0
- package/dist/e2e-harness/stack.d.ts.map +1 -0
- package/dist/e2e-harness/stack.js +207 -0
- package/dist/e2e-harness/steps.d.ts +11 -0
- package/dist/e2e-harness/steps.d.ts.map +1 -0
- package/dist/e2e-harness/steps.js +22 -0
- package/dist/e2e-harness.d.ts +3 -0
- package/dist/e2e-harness.d.ts.map +1 -0
- package/dist/e2e-harness.js +2 -0
- package/dist/engine-facts.d.ts.map +1 -1
- package/dist/engine-facts.js +1 -2
- package/dist/exit-codes.d.ts +54 -0
- package/dist/exit-codes.d.ts.map +1 -0
- package/dist/exit-codes.js +55 -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 +152 -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 +10 -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 +204 -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 -7
- 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 +9 -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 +106 -0
- package/dist/lifecycle/release-status.d.ts.map +1 -0
- package/dist/lifecycle/release-status.js +115 -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/lifecycle/wave-plans.d.ts +23 -7
- package/dist/lifecycle/wave-plans.d.ts.map +1 -1
- package/dist/lifecycle/wave-plans.js +9 -2
- 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/approval-status.d.ts +103 -0
- package/dist/op/approval-status.d.ts.map +1 -0
- package/dist/op/approval-status.js +197 -0
- 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 +63 -0
- package/dist/op/op-waves-capability-spec.d.ts.map +1 -0
- package/dist/op/op-waves-capability-spec.js +115 -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 +96 -0
- package/dist/op/op-waves-run.d.ts +182 -6
- package/dist/op/op-waves-run.d.ts.map +1 -1
- package/dist/op/op-waves-run.js +1076 -44
- 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 +96 -0
- package/dist/op/op-waves.d.ts +187 -8
- package/dist/op/op-waves.d.ts.map +1 -1
- package/dist/op/op-waves.js +203 -19
- package/dist/op/runtime.d.ts +95 -0
- package/dist/op/runtime.d.ts.map +1 -1
- package/dist/op/runtime.js +18 -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 +425 -0
- package/dist/override-gate.d.ts.map +1 -1
- package/dist/override-gate.js +5 -0
- package/dist/parallelism.d.ts +17 -0
- package/dist/parallelism.d.ts.map +1 -0
- package/dist/parallelism.js +33 -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 +102 -0
- package/dist/pr-forge.d.ts +40 -0
- package/dist/pr-forge.d.ts.map +1 -1
- package/dist/pr-forge.js +146 -37
- package/dist/pr-loop.d.ts +158 -11
- package/dist/pr-loop.d.ts.map +1 -1
- package/dist/pr-loop.js +302 -44
- package/dist/pr-merge.d.ts +64 -0
- package/dist/pr-merge.d.ts.map +1 -0
- package/dist/pr-merge.js +78 -0
- package/dist/pr-post.d.ts +86 -1
- package/dist/pr-post.d.ts.map +1 -1
- package/dist/pr-post.js +141 -5
- 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 +45 -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 +3 -1
- package/dist/scheduled-op-cloud.d.ts +32 -0
- package/dist/scheduled-op-cloud.d.ts.map +1 -0
- package/dist/scheduled-op-cloud.js +69 -0
- 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 +405 -287
- 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 +17 -0
- package/dist/workspace/ci-lock-grain.d.ts.map +1 -0
- package/dist/workspace/ci-lock-grain.js +21 -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 +10 -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 +79 -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 +1025 -0
- package/src/ci-audit/__fixtures__/cloudtrail-lookup-bucket.json +37 -0
- package/src/ci-audit/__fixtures__/cloudtrail-writes-window.json +59 -0
- package/src/ci-audit/attribution.ts +260 -0
- package/src/ci-audit/audit-log.ts +220 -0
- package/src/ci-audit/ci-audit.test.ts +175 -0
- package/src/ci-audit/index.ts +15 -0
- package/src/ci-audit/unrecorded.ts +140 -0
- package/src/ci-audit.ts +2 -0
- package/src/ci-control.ts +173 -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 +175 -0
- package/src/ci-handover.ts +67 -16
- package/src/ci-identity-database.test.ts +54 -0
- package/src/ci-identity-pulumi.test.ts +163 -0
- package/src/ci-identity-targets.test.ts +3 -1
- package/src/ci-identity.ts +123 -22
- package/src/ci-job-guard.test.ts +154 -0
- package/src/ci-job-guard.ts +319 -0
- package/src/ci-jobs.ts +8 -0
- package/src/ci-product-comment-targets.test.ts +45 -0
- package/src/ci-product-words.test.ts +101 -0
- package/src/ci-product-words.ts +565 -0
- package/src/ci-product.ts +226 -0
- package/src/ci-respond-run.ts +291 -0
- package/src/ci-respond.test.ts +264 -0
- package/src/ci-respond.ts +412 -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/audit-log.ts +74 -0
- package/src/cli/handlers/build-pr-loop-flags.test.ts +98 -0
- package/src/cli/handlers/build.test.ts +7 -0
- package/src/cli/handlers/build.ts +113 -1
- package/src/cli/handlers/ci-check-job.test.ts +114 -0
- package/src/cli/handlers/ci-check-job.ts +33 -0
- package/src/cli/handlers/ci-check.ts +63 -0
- package/src/cli/handlers/ci-forge-check.ts +91 -0
- package/src/cli/handlers/e2e-safe-run.ts +27 -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-comment-targets.test.ts +166 -0
- package/src/cli/handlers/pr-plan-flags.test.ts +161 -0
- 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 +879 -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 +144 -2
- 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.test.ts +1 -1
- package/src/cli/main.ts +180 -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 +119 -2
- package/src/cli/registry.ts +73 -0
- package/src/cloud-lister/sigv4.ts +80 -23
- package/src/components/adoption.test.ts +140 -0
- package/src/components/adoption.ts +140 -0
- package/src/components/apply-lease.ts +49 -0
- package/src/components/capability.ts +180 -6
- package/src/components/check-hooks.test.ts +66 -0
- package/src/components/check-hooks.ts +255 -0
- package/src/components/check-steps.test.ts +70 -0
- package/src/components/check-steps.ts +158 -0
- package/src/components/ci-services.test.ts +51 -0
- package/src/components/ci-services.ts +82 -0
- package/src/components/cli-support.ts +23 -2
- package/src/components/driver.test.ts +3 -3
- package/src/components/driver.ts +73 -6
- package/src/components/fan-out-run.ts +68 -18
- package/src/components/groups.ts +21 -4
- package/src/components/plan-flags.test.ts +46 -0
- package/src/components/pr-comment-preview-targets.test.ts +34 -0
- 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 +42 -0
- package/src/components/pr-env-ports.ts +29 -4
- package/src/components/pr-env-run-bundle.test.ts +2 -14
- 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 +40 -8
- package/src/components/pr-pipeline-runners.test.ts +80 -0
- package/src/components/pr-pipeline.test.ts +15 -0
- package/src/components/pr-pipeline.ts +498 -18
- package/src/components/pr-policy.ts +45 -7
- package/src/components/pr-run.test.ts +1 -1
- package/src/components/pr-run.ts +138 -11
- package/src/components/pr-stale-job.test.ts +34 -0
- 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 +383 -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 +96 -6
- 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/e2e-harness/__project__/chant.config.ts +4 -0
- package/src/e2e-harness/__project__/src/compose.ts +33 -0
- package/src/e2e-harness/bucket.ts +69 -0
- package/src/e2e-harness/claim.test.ts +150 -0
- package/src/e2e-harness/claim.ts +140 -0
- package/src/e2e-harness/driver.test.ts +304 -0
- package/src/e2e-harness/driver.ts +294 -0
- package/src/e2e-harness/forgejo.ts +267 -0
- package/src/e2e-harness/git.ts +96 -0
- package/src/e2e-harness/index.ts +50 -0
- package/src/e2e-harness/jobs.ts +35 -0
- package/src/e2e-harness/pins.ts +52 -0
- package/src/e2e-harness/ports.ts +130 -0
- package/src/e2e-harness/reports.ts +79 -0
- package/src/e2e-harness/safe-run-cli.test.ts +102 -0
- package/src/e2e-harness/safe-run-cli.ts +54 -0
- package/src/e2e-harness/safe-run.ts +198 -0
- package/src/e2e-harness/scenario.ts +89 -0
- package/src/e2e-harness/schemas/README.md +62 -0
- package/src/e2e-harness/schemas/demo-cycle.schema.json +282 -0
- package/src/e2e-harness/schemas/demo-step.schema.json +245 -0
- package/src/e2e-harness/schemas/e2e-claim-row.schema.json +33 -0
- package/src/e2e-harness/schemas/e2e-claims.schema.json +18 -0
- package/src/e2e-harness/schemas/e2e-scenario.schema.json +150 -0
- package/src/e2e-harness/schemas/index.ts +220 -0
- package/src/e2e-harness/schemas.test.ts +145 -0
- package/src/e2e-harness/stack.test.ts +124 -0
- package/src/e2e-harness/stack.ts +306 -0
- package/src/e2e-harness/steps.ts +30 -0
- package/src/e2e-harness.ts +2 -0
- package/src/engine-facts.test.ts +2 -3
- package/src/engine-facts.ts +1 -2
- package/src/exit-codes.test.ts +32 -0
- package/src/exit-codes.ts +61 -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 +11 -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 +143 -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 +69 -0
- package/src/lifecycle/gate-applied.ts +6 -0
- package/src/lifecycle/gate-ledger.ts +35 -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 +279 -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 -8
- 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 +192 -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 +19 -0
- package/src/lifecycle/release-publish.ts +45 -22
- package/src/lifecycle/release-read.ts +2 -0
- package/src/lifecycle/release-status.test.ts +185 -0
- package/src/lifecycle/release-status.ts +175 -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/lifecycle/wave-plans.ts +33 -5
- 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/approval-status.test.ts +134 -0
- package/src/op/approval-status.ts +235 -0
- package/src/op/gate-review.test.ts +2 -1
- package/src/op/gate.ts +81 -22
- package/src/op/generate-pipeline.ts +7 -1
- package/src/op/index.ts +23 -0
- package/src/op/op-waves-after-plan.test.ts +288 -0
- package/src/op/op-waves-after-plan.ts +238 -0
- package/src/op/op-waves-capability-spec.ts +133 -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-parallelism.test.ts +89 -0
- package/src/op/op-waves-pull-request.test.ts +219 -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 +132 -0
- package/src/op/op-waves-run-record.test.ts +32 -0
- package/src/op/op-waves-run.ts +1235 -52
- package/src/op/op-waves-stand-down.test.ts +240 -0
- package/src/op/op-waves-stand-down.ts +107 -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 +320 -22
- package/src/op/runtime.ts +107 -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 +543 -0
- package/src/override-gate-bundle.test.ts +2 -0
- package/src/override-gate.ts +4 -0
- package/src/parallelism.test.ts +38 -0
- package/src/parallelism.ts +33 -0
- package/src/policy-packs.ts +230 -0
- package/src/policy-source.test.ts +256 -0
- package/src/policy-source.ts +111 -0
- package/src/pr-forge-bundle.test.ts +1 -1
- package/src/pr-forge.ts +175 -33
- package/src/pr-loop-bundle.test.ts +7 -3
- package/src/pr-loop-narrowed.test.ts +63 -0
- package/src/pr-loop-words.test.ts +155 -0
- package/src/pr-loop.ts +398 -52
- package/src/pr-merge.test.ts +100 -0
- package/src/pr-merge.ts +105 -0
- package/src/pr-post-stale.test.ts +163 -0
- package/src/pr-post.ts +190 -5
- package/src/pr-report-url.ts +61 -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 +212 -0
- package/src/release-floors.ts +1 -1
- package/src/run-event.ts +28 -1
- package/src/scheduled-op-cloud.ts +68 -0
- package/src/sorted-json.ts +17 -0
- package/src/stage-hooks-bundle.test.ts +6 -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 +29 -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 +10 -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 +79 -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
package/src/op/runtime.ts
CHANGED
|
@@ -21,6 +21,7 @@ import type { StepRecord, OpRunResult } from "./local-executor";
|
|
|
21
21
|
import type { WaitingPoint } from "./steward-points";
|
|
22
22
|
import type { GateResolutionRecord } from "../lifecycle/gate-ledger";
|
|
23
23
|
import type { RunOrigin } from "../lifecycle/release-ledger";
|
|
24
|
+
import type { CapabilityTraceSpan } from "../otlp";
|
|
24
25
|
import type { RunComponentsOptions, RunComponentsResult } from "../components/cli-support";
|
|
25
26
|
|
|
26
27
|
/**
|
|
@@ -205,6 +206,112 @@ export interface OpRunRecord {
|
|
|
205
206
|
* on a run nothing explained.
|
|
206
207
|
*/
|
|
207
208
|
failure?: OpRunFailureReason;
|
|
209
|
+
/**
|
|
210
|
+
* The op wave job this record is for (#4551): one record per `chant run
|
|
211
|
+
* wave` job, under the spec's name as `op`. Optional within contract 1,
|
|
212
|
+
* written by chant {@link OP_WAVE_RUN_RECORD_FLOOR} and newer; absent on
|
|
213
|
+
* every other run.
|
|
214
|
+
*/
|
|
215
|
+
wave?: OpRunWave;
|
|
216
|
+
}
|
|
217
|
+
|
|
218
|
+
/** Which op wave job a run record is for, and how it ended (#4551). */
|
|
219
|
+
export interface OpRunWave {
|
|
220
|
+
/** The spec's name, as `op` holds it. */
|
|
221
|
+
spec: string;
|
|
222
|
+
/** The wave the job was started for, 1-based. */
|
|
223
|
+
number: number;
|
|
224
|
+
/** That wave's name. */
|
|
225
|
+
name: string;
|
|
226
|
+
/** `wave` for a whole wave, `decide` for a wide wave's deciding job, `share` or `group` for its apply jobs. */
|
|
227
|
+
job: "wave" | "decide" | "share" | "group";
|
|
228
|
+
share?: number;
|
|
229
|
+
group?: string;
|
|
230
|
+
/** The set digest the job decided or applied under. Jobs of one wave join on it. */
|
|
231
|
+
digest?: string;
|
|
232
|
+
/** The job's exit code, as `chant run wave` exited (chant's exit-code table, #4553). */
|
|
233
|
+
exitCode: number;
|
|
234
|
+
/** Set when the apply applied nothing and nothing failed: another run held it, or it stood down for a newer one. */
|
|
235
|
+
outcome?: "held" | "stood-down";
|
|
236
|
+
/**
|
|
237
|
+
* The newer commit an apply stood down for (#4581), when chant found it
|
|
238
|
+
* on the branch itself (the spec's `standDown`). An apply command that
|
|
239
|
+
* wrote `stood-down` names none.
|
|
240
|
+
*/
|
|
241
|
+
supersededBy?: { branch: string; commit: string };
|
|
242
|
+
applied: string[];
|
|
243
|
+
failed: string[];
|
|
244
|
+
/** Runs a share job did not apply because their plan moved since the decision. */
|
|
245
|
+
moved: string[];
|
|
246
|
+
/** Runs a failure blocked, each with the run that blocked it. */
|
|
247
|
+
blocked?: Record<string, string>;
|
|
248
|
+
/**
|
|
249
|
+
* Each run target the job applied or tried to apply (#4555): when its
|
|
250
|
+
* apply started, how long it took, and what its capability knew about it
|
|
251
|
+
* (engine facts, and the resources it timed, such as plunge's provider
|
|
252
|
+
* calls and record writes). The same facts are the attributes and child
|
|
253
|
+
* spans of the target's span in the job's trace. Written by the same
|
|
254
|
+
* chant as `wave` itself.
|
|
255
|
+
*/
|
|
256
|
+
targets?: Record<string, OpRunWaveTarget>;
|
|
257
|
+
/**
|
|
258
|
+
* Each run the job planned, by target, when its plan carried policy rows
|
|
259
|
+
* or an after-plan hook in the job's process gave rows or files (#4614).
|
|
260
|
+
* Written by chant {@link OP_WAVE_AFTER_PLAN_FLOOR} and newer.
|
|
261
|
+
*/
|
|
262
|
+
plans?: Record<string, OpRunWavePlan>;
|
|
263
|
+
}
|
|
264
|
+
|
|
265
|
+
/** One policy check's row for a planned run (#4614): chant's `holds.policy`, or a product's own check. */
|
|
266
|
+
export interface OpRunPolicyRow {
|
|
267
|
+
/** Who checked: `ci.policy` for chant's wave hold, else the product's name for its own check. */
|
|
268
|
+
source: string;
|
|
269
|
+
/** `denied` denies the run (an override then counts), `held` holds the wave for a person; `passed` and `warned` change nothing. */
|
|
270
|
+
result: "passed" | "warned" | "denied" | "held";
|
|
271
|
+
/** The ids of the rules that denied, held or warned, sorted. */
|
|
272
|
+
rules: string[];
|
|
273
|
+
reason?: string;
|
|
274
|
+
}
|
|
275
|
+
|
|
276
|
+
/** One planned run of an op wave job (#4614). */
|
|
277
|
+
export interface OpRunWavePlan {
|
|
278
|
+
planDigest: string;
|
|
279
|
+
/** The policy rows of its plan: chant's `holds.policy` first, then each after-plan hook's. */
|
|
280
|
+
policy?: OpRunPolicyRow[];
|
|
281
|
+
/** Files an after-plan hook wrote for the run, relative to the job's directory, such as a product's plan view. */
|
|
282
|
+
files?: string[];
|
|
283
|
+
}
|
|
284
|
+
|
|
285
|
+
/** The first chant that runs an after-plan hook in the wave job's process and writes {@link OpRunWave.plans} (#4614). */
|
|
286
|
+
export const OP_WAVE_AFTER_PLAN_FLOOR = "0.124.55";
|
|
287
|
+
|
|
288
|
+
/** One run target's apply in an op wave job (#4555). */
|
|
289
|
+
export interface OpRunWaveTarget {
|
|
290
|
+
/** When its apply started, ISO-8601. */
|
|
291
|
+
startedAt: string;
|
|
292
|
+
durationMs: number;
|
|
293
|
+
/** Engine facts, as the trace writes them before the product's prefix. */
|
|
294
|
+
attributes?: Record<string, string | number | boolean>;
|
|
295
|
+
/** The pieces the engine timed. */
|
|
296
|
+
spans?: CapabilityTraceSpan[];
|
|
297
|
+
/** The engine's error, when the apply failed (#4629): what the failed-apply triage posts. */
|
|
298
|
+
error?: string;
|
|
299
|
+
/** The resources the engine reported failed (#4629), by name or id. */
|
|
300
|
+
failedResources?: string[];
|
|
301
|
+
}
|
|
302
|
+
|
|
303
|
+
/** The first chant that writes {@link OpRunRecord.wave}, a run record per op wave job (#4551). */
|
|
304
|
+
export const OP_WAVE_RUN_RECORD_FLOOR = "0.124.55";
|
|
305
|
+
|
|
306
|
+
/** `value` as an {@link OpRunWave}, or undefined when it is not one, so a reader drops a malformed field and keeps the record. */
|
|
307
|
+
export function opRunWaveOf(value: unknown): OpRunWave | undefined {
|
|
308
|
+
if (typeof value !== "object" || value === null || Array.isArray(value)) return undefined;
|
|
309
|
+
const v = value as Record<string, unknown>;
|
|
310
|
+
const names = (x: unknown): x is string[] => Array.isArray(x) && x.every((t) => typeof t === "string");
|
|
311
|
+
if (typeof v.spec !== "string" || !Number.isInteger(v.number) || typeof v.name !== "string" || !Number.isInteger(v.exitCode)) return undefined;
|
|
312
|
+
if (v.job !== "wave" && v.job !== "decide" && v.job !== "share" && v.job !== "group") return undefined;
|
|
313
|
+
if (!names(v.applied) || !names(v.failed) || !names(v.moved)) return undefined;
|
|
314
|
+
return v as unknown as OpRunWave;
|
|
208
315
|
}
|
|
209
316
|
|
|
210
317
|
/** Why a run failed, on {@link OpRunRecord.failure} and on the run's `run-settle` event (#4094). */
|
|
@@ -0,0 +1,41 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The hold file's `record` and `attachment`, and the finished file a
|
|
3
|
+
* recorded hold's re-run writes (#4623).
|
|
4
|
+
*/
|
|
5
|
+
import { describe, expect, test } from "vitest";
|
|
6
|
+
import { mkdtempSync, rmSync, writeFileSync } from "node:fs";
|
|
7
|
+
import { join } from "node:path";
|
|
8
|
+
import { tmpdir } from "node:os";
|
|
9
|
+
import { holdFinishedPath, readHoldFinished, readHoldRequest } from "./stage-hooks";
|
|
10
|
+
|
|
11
|
+
describe("recorded holds (#4623)", () => {
|
|
12
|
+
test("a hold file's record and attachment are read; a record that is not a boolean is refused", () => {
|
|
13
|
+
const dir = mkdtempSync(join(tmpdir(), "hold-record-"));
|
|
14
|
+
const logs: string[] = [];
|
|
15
|
+
const at = join(dir, "hold.json");
|
|
16
|
+
writeFileSync(at, JSON.stringify({ op: "tf-migrate", gate: "g", digest: "sha256:aa", record: true, attachment: "{}\n" }));
|
|
17
|
+
expect(readHoldRequest(at, (l) => logs.push(l), "hook")).toEqual({ op: "tf-migrate", gate: "g", digest: "sha256:aa", record: true, attachment: "{}\n" });
|
|
18
|
+
writeFileSync(at, JSON.stringify({ gate: "g", digest: "sha256:aa", record: "yes" }));
|
|
19
|
+
expect(readHoldRequest(at, (l) => logs.push(l), "hook")).toBeUndefined();
|
|
20
|
+
expect(logs.join("\n")).toContain("its record is not true or false");
|
|
21
|
+
rmSync(dir, { recursive: true, force: true });
|
|
22
|
+
});
|
|
23
|
+
|
|
24
|
+
test("the finished file keeps flat detail values and drops the rest; a missing or bad file reads as nothing", () => {
|
|
25
|
+
const dir = mkdtempSync(join(tmpdir(), "hold-finished-"));
|
|
26
|
+
const logs: string[] = [];
|
|
27
|
+
const at = join(dir, "hold-finished.json");
|
|
28
|
+
expect(readHoldFinished(at, (l) => logs.push(l), "hook")).toBeUndefined();
|
|
29
|
+
writeFileSync(at, JSON.stringify({ result: "failed", detail: { result: "failed", n: 2, ok: false, roots: ["a"], nested: { x: 1 } } }));
|
|
30
|
+
expect(readHoldFinished(at, (l) => logs.push(l), "hook")).toEqual({ result: "failed", detail: { result: "failed", n: 2, ok: false } });
|
|
31
|
+
expect(logs.join("\n")).toContain("roots, nested are not a string, number or boolean");
|
|
32
|
+
writeFileSync(at, JSON.stringify({ result: "done" }));
|
|
33
|
+
expect(readHoldFinished(at, (l) => logs.push(l), "hook")).toBeUndefined();
|
|
34
|
+
rmSync(dir, { recursive: true, force: true });
|
|
35
|
+
});
|
|
36
|
+
|
|
37
|
+
test("the finished file sits beside the hold file", () => {
|
|
38
|
+
expect(holdFinishedPath(".chant/op-waves/tf-apply/wave-1/hold.json")).toBe(".chant/op-waves/tf-apply/wave-1/hold-finished.json");
|
|
39
|
+
expect(holdFinishedPath("custom-hold")).toBe("custom-hold.finished.json");
|
|
40
|
+
});
|
|
41
|
+
});
|
package/src/op/stage-hooks.ts
CHANGED
|
@@ -9,7 +9,7 @@
|
|
|
9
9
|
import { spawn, spawnSync } from "node:child_process";
|
|
10
10
|
import { existsSync, readFileSync, rmSync } from "node:fs";
|
|
11
11
|
import { join } from "node:path";
|
|
12
|
-
import { opWaveHookRuns, type
|
|
12
|
+
import { opWaveHookRuns, type CiHookMoment, type OpWaveHook } from "./op-waves";
|
|
13
13
|
|
|
14
14
|
/** What one moment's hooks came to, before any hold on another gate is settled. */
|
|
15
15
|
export interface HookListOutcome {
|
|
@@ -38,11 +38,36 @@ export interface OpWaveHoldRequest {
|
|
|
38
38
|
description?: string;
|
|
39
39
|
/** Fields for the pending fact, as a plans file's `pending`. */
|
|
40
40
|
pending?: Record<string, unknown>;
|
|
41
|
+
/**
|
|
42
|
+
* chant records the held gate like a gated request (#4623): an applied
|
|
43
|
+
* line in `_gates/<op>/applied.jsonl` before the approved re-run, which
|
|
44
|
+
* spends the approval, and a finished line after it with the detail the
|
|
45
|
+
* re-run writes to `CHANT_HOLD_FINISHED`. A digest already applied under
|
|
46
|
+
* this gate does not run again.
|
|
47
|
+
*/
|
|
48
|
+
record?: boolean;
|
|
49
|
+
/**
|
|
50
|
+
* A file the request carries, such as a migration's proof, as text. chant
|
|
51
|
+
* stores it once at `_gates/<op>/requests/<digest>.json` before the
|
|
52
|
+
* pending fact, and the fact's `proof` is its SHA-256 (#4623).
|
|
53
|
+
*/
|
|
54
|
+
attachment?: string;
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
/**
|
|
58
|
+
* What a hook's approved re-run writes to `CHANT_HOLD_FINISHED` (#4623) when
|
|
59
|
+
* its hold asked chant to `record` the gate: how the work under the approval
|
|
60
|
+
* ended and the product's flat facts for the finished line. Without the
|
|
61
|
+
* file, the re-run's exit code says how it ended and the line has no detail.
|
|
62
|
+
*/
|
|
63
|
+
export interface OpWaveHoldFinished {
|
|
64
|
+
result: "applied" | "failed";
|
|
65
|
+
detail?: Record<string, string | number | boolean>;
|
|
41
66
|
}
|
|
42
67
|
|
|
43
68
|
/** One hook's run (#3762). */
|
|
44
69
|
export interface OpWaveHookOutcome {
|
|
45
|
-
moment:
|
|
70
|
+
moment: CiHookMoment;
|
|
46
71
|
name: string;
|
|
47
72
|
/** The run, for a `perRun` hook. */
|
|
48
73
|
target?: string;
|
|
@@ -58,6 +83,10 @@ export interface OpWaveHookRun {
|
|
|
58
83
|
op: string;
|
|
59
84
|
/** The run's plan file, once planned. */
|
|
60
85
|
plan?: string;
|
|
86
|
+
/** The run's plan digest, once planned (#4614). */
|
|
87
|
+
planDigest?: string;
|
|
88
|
+
/** The engine's plan document, once planned, when the run's plan names one (`artifact.planJson`, #4614). */
|
|
89
|
+
planJson?: string;
|
|
61
90
|
}
|
|
62
91
|
|
|
63
92
|
/** Runs one argv; returns its exit code. `env` is added to the job's environment. Injected so tests run no processes. */
|
|
@@ -83,10 +112,11 @@ export const spawnExecAsync: OpWaveAsyncExec = (argv, cwd, env) =>
|
|
|
83
112
|
/** Fill one argv template. A placeholder whose value is not given is left as it is. */
|
|
84
113
|
export function opWaveArgv(
|
|
85
114
|
template: readonly string[],
|
|
86
|
-
values: { op: string; wave: string; target?: string; plan?: string; runs?: string; plans?: string },
|
|
115
|
+
values: { op: string; wave: string; target?: string; plan?: string; planJson?: string; runs?: string; plans?: string },
|
|
87
116
|
): string[] {
|
|
88
117
|
const pairs: Array<[string, string | undefined]> = [
|
|
89
118
|
["{op}", values.op],
|
|
119
|
+
["{planJson}", values.planJson],
|
|
90
120
|
["{target}", values.target],
|
|
91
121
|
["{wave}", values.wave],
|
|
92
122
|
["{plans}", values.plans],
|
|
@@ -110,7 +140,7 @@ export function pendingFields(value: unknown, where: string): Record<string, unk
|
|
|
110
140
|
export interface OtherGateHold {
|
|
111
141
|
label: string;
|
|
112
142
|
name: string;
|
|
113
|
-
moment:
|
|
143
|
+
moment: CiHookMoment;
|
|
114
144
|
target?: string;
|
|
115
145
|
argv: string[];
|
|
116
146
|
env: Record<string, string>;
|
|
@@ -124,13 +154,55 @@ export function readHoldRequest(path: string, log: (line: string) => void, label
|
|
|
124
154
|
const r = JSON.parse(readFileSync(path, "utf-8")) as Partial<OpWaveHoldRequest>;
|
|
125
155
|
if (typeof r.gate !== "string" || r.gate === "" || typeof r.digest !== "string" || r.digest === "") throw new Error("it names no gate and digest");
|
|
126
156
|
if (r.op !== undefined && (typeof r.op !== "string" || r.op === "")) throw new Error("its op is not a name");
|
|
127
|
-
|
|
157
|
+
if (r.record !== undefined && typeof r.record !== "boolean") throw new Error("its record is not true or false");
|
|
158
|
+
if (r.attachment !== undefined && typeof r.attachment !== "string") throw new Error("its attachment is not text");
|
|
159
|
+
return {
|
|
160
|
+
gate: r.gate,
|
|
161
|
+
digest: r.digest,
|
|
162
|
+
...(r.op ? { op: r.op } : {}),
|
|
163
|
+
...(typeof r.description === "string" ? { description: r.description } : {}),
|
|
164
|
+
...(r.pending ? { pending: pendingFields(r.pending, `the hold ${label} wrote`) ?? {} } : {}),
|
|
165
|
+
...(r.record ? { record: true } : {}),
|
|
166
|
+
...(r.attachment !== undefined ? { attachment: r.attachment } : {}),
|
|
167
|
+
};
|
|
128
168
|
} catch (err) {
|
|
129
169
|
log(`${label} wrote a hold file that cannot be read (${err instanceof Error ? err.message : String(err)}), so it holds the wave on its set digest`);
|
|
130
170
|
return undefined;
|
|
131
171
|
}
|
|
132
172
|
}
|
|
133
173
|
|
|
174
|
+
/**
|
|
175
|
+
* Read what a hook's approved re-run wrote to `CHANT_HOLD_FINISHED` (#4623).
|
|
176
|
+
* Undefined when it wrote nothing; a file that is not one is logged and read
|
|
177
|
+
* as nothing. A detail value that is not a string, number or boolean is
|
|
178
|
+
* left out, so the finished line stays flat.
|
|
179
|
+
*/
|
|
180
|
+
export function readHoldFinished(path: string, log: (line: string) => void, label: string): OpWaveHoldFinished | undefined {
|
|
181
|
+
if (!existsSync(path)) return undefined;
|
|
182
|
+
try {
|
|
183
|
+
const r = JSON.parse(readFileSync(path, "utf-8")) as Partial<OpWaveHoldFinished>;
|
|
184
|
+
if (r.result !== "applied" && r.result !== "failed") throw new Error('its result is not "applied" or "failed"');
|
|
185
|
+
if (r.detail === undefined) return { result: r.result };
|
|
186
|
+
if (r.detail === null || typeof r.detail !== "object" || Array.isArray(r.detail)) throw new Error("its detail is not an object");
|
|
187
|
+
const detail: Record<string, string | number | boolean> = {};
|
|
188
|
+
const dropped: string[] = [];
|
|
189
|
+
for (const [key, value] of Object.entries(r.detail)) {
|
|
190
|
+
if (typeof value === "string" || typeof value === "boolean" || (typeof value === "number" && Number.isFinite(value))) detail[key] = value;
|
|
191
|
+
else dropped.push(key);
|
|
192
|
+
}
|
|
193
|
+
if (dropped.length > 0) log(`${label}: the finished detail's ${dropped.join(", ")} ${dropped.length === 1 ? "is" : "are"} not a string, number or boolean, so the finished line leaves ${dropped.length === 1 ? "it" : "them"} out`);
|
|
194
|
+
return { result: r.result, ...(Object.keys(detail).length > 0 ? { detail } : {}) };
|
|
195
|
+
} catch (err) {
|
|
196
|
+
log(`${label} wrote a finished file that cannot be read (${err instanceof Error ? err.message : String(err)}), so its exit code says how it ended`);
|
|
197
|
+
return undefined;
|
|
198
|
+
}
|
|
199
|
+
}
|
|
200
|
+
|
|
201
|
+
/** Where a hook's approved re-run writes how it ended (#4623): beside the hold file. */
|
|
202
|
+
export function holdFinishedPath(holdPath: string): string {
|
|
203
|
+
return /hold\.json$/.test(holdPath) ? holdPath.replace(/hold\.json$/, "hold-finished.json") : `${holdPath}.finished.json`;
|
|
204
|
+
}
|
|
205
|
+
|
|
134
206
|
/** Where hooks run: the wave they belong to and the job's tools. */
|
|
135
207
|
export interface HookPlace {
|
|
136
208
|
/** The spec's name and `op`. */
|
|
@@ -160,7 +232,7 @@ interface HookCall {
|
|
|
160
232
|
*/
|
|
161
233
|
function* hookListSteps(
|
|
162
234
|
at: Omit<HookPlace, "exec">,
|
|
163
|
-
moment:
|
|
235
|
+
moment: CiHookMoment,
|
|
164
236
|
hooks: readonly OpWaveHook[] | undefined,
|
|
165
237
|
runs: readonly OpWaveHookRun[],
|
|
166
238
|
runsPath: string,
|
|
@@ -183,8 +255,15 @@ function* hookListSteps(
|
|
|
183
255
|
const calls = hook.perRun
|
|
184
256
|
? mine.map((run) => ({
|
|
185
257
|
target: run.target as string | undefined,
|
|
186
|
-
argv: opWaveArgv(hook.command, { op: run.op, wave: waveName, target: run.target, runs: runsPath, ...(run.plan ? { plan: run.plan } : {}) }),
|
|
187
|
-
env: {
|
|
258
|
+
argv: opWaveArgv(hook.command, { op: run.op, wave: waveName, target: run.target, runs: runsPath, ...(run.plan ? { plan: run.plan } : {}), ...(run.planJson ? { planJson: run.planJson } : {}) }),
|
|
259
|
+
env: {
|
|
260
|
+
...env,
|
|
261
|
+
CHANT_TARGET: run.target,
|
|
262
|
+
...(run.plan ? { CHANT_PLAN: run.plan } : {}),
|
|
263
|
+
// #4614: the plan's digest and the engine's plan document, for a product that builds its report from chant's plans.
|
|
264
|
+
...(run.planDigest ? { CHANT_PLAN_DIGEST: run.planDigest } : {}),
|
|
265
|
+
...(run.planJson ? { CHANT_PLAN_JSON: run.planJson } : {}),
|
|
266
|
+
} as Record<string, string>,
|
|
188
267
|
}))
|
|
189
268
|
: [{ target: undefined, argv: opWaveArgv(hook.command, { op, wave: waveName, runs: runsPath }), env: env as Record<string, string> }];
|
|
190
269
|
for (const call of calls) {
|
|
@@ -230,7 +309,7 @@ function didNotRun(call: HookCall, err: unknown, log: (line: string) => void): n
|
|
|
230
309
|
*/
|
|
231
310
|
export function runHookList(
|
|
232
311
|
at: HookPlace,
|
|
233
|
-
moment:
|
|
312
|
+
moment: CiHookMoment,
|
|
234
313
|
hooks: readonly OpWaveHook[] | undefined,
|
|
235
314
|
runs: readonly OpWaveHookRun[],
|
|
236
315
|
runsPath: string,
|
|
@@ -254,7 +333,7 @@ export function runHookList(
|
|
|
254
333
|
/** {@link runHookList} with an exec that returns a promise (#4334). */
|
|
255
334
|
export async function runHookListAsync(
|
|
256
335
|
at: Omit<HookPlace, "exec"> & { exec: OpWaveAsyncExec },
|
|
257
|
-
moment:
|
|
336
|
+
moment: CiHookMoment,
|
|
258
337
|
hooks: readonly OpWaveHook[] | undefined,
|
|
259
338
|
runs: readonly OpWaveHookRun[],
|
|
260
339
|
runsPath: string,
|
|
@@ -337,7 +416,7 @@ function stageRun(out: HookListOutcome, name: string, keep = false): StageHooksR
|
|
|
337
416
|
* gate (`CHANT_HOLD`) is counted as a plain hold, unless `keepOtherGates` is
|
|
338
417
|
* set (#4323): then it comes back in `otherGates` for the caller to settle.
|
|
339
418
|
*/
|
|
340
|
-
export function runStageHooks(moment:
|
|
419
|
+
export function runStageHooks(moment: CiHookMoment, hooks: readonly OpWaveHook[] | undefined, options: RunStageHooksOptions): StageHooksRun {
|
|
341
420
|
const place = { ...stagePlace(options), exec: options.exec ?? spawnExec };
|
|
342
421
|
return stageRun(runHookList(place, moment, hooks, options.runs, options.runsFile, options.env), options.name, options.keepOtherGates);
|
|
343
422
|
}
|
|
@@ -348,7 +427,7 @@ export function runStageHooks(moment: OpWaveHookMoment, hooks: readonly OpWaveHo
|
|
|
348
427
|
* still run one after another. Give each concurrent call its own `holdFile`
|
|
349
428
|
* and `runsFile`.
|
|
350
429
|
*/
|
|
351
|
-
export async function runStageHooksAsync(moment:
|
|
430
|
+
export async function runStageHooksAsync(moment: CiHookMoment, hooks: readonly OpWaveHook[] | undefined, options: RunStageHooksAsyncOptions): Promise<StageHooksRun> {
|
|
352
431
|
const place = { ...stagePlace(options), exec: options.exec ?? spawnExecAsync };
|
|
353
432
|
return stageRun(await runHookListAsync(place, moment, hooks, options.runs, options.runsFile, options.env), options.name, options.keepOtherGates);
|
|
354
433
|
}
|
package/src/op/steward-beside.ts
CHANGED
|
@@ -20,6 +20,7 @@
|
|
|
20
20
|
* is how `workspace status` finds it under the steward.
|
|
21
21
|
*/
|
|
22
22
|
import { spawn } from "node:child_process";
|
|
23
|
+
import { CHANT_EXIT } from "../exit-codes";
|
|
23
24
|
import type { ActivityFn, ActivityProfile } from "./activity-registry";
|
|
24
25
|
import { runOpLocally, OpRunFailure } from "./local-executor";
|
|
25
26
|
import type { ActivityStep, OpConfig } from "./types";
|
|
@@ -64,7 +65,7 @@ export interface BesideHandle {
|
|
|
64
65
|
export type BesideLauncher = (start: BesideStart) => BesideHandle;
|
|
65
66
|
|
|
66
67
|
/** The exit code `chant run` gives a run that stopped at a gate or on an open decision point. */
|
|
67
|
-
const WAITING_EXIT =
|
|
68
|
+
const WAITING_EXIT = CHANT_EXIT.waiting;
|
|
68
69
|
|
|
69
70
|
/**
|
|
70
71
|
* Start `chant run <op>` as a process of its own: the same node, loader and
|
package/src/op/types.ts
CHANGED
|
@@ -10,6 +10,7 @@ import type { ActivityProfileName } from "./activity-profiles";
|
|
|
10
10
|
import type { StepOutputRef } from "./step-output-ref";
|
|
11
11
|
import type { GateApproval } from "./gate-approval";
|
|
12
12
|
import type { GatePoint } from "./gate-point";
|
|
13
|
+
import { CHANT_EXIT } from "../exit-codes";
|
|
13
14
|
|
|
14
15
|
export interface OpConfig {
|
|
15
16
|
/** Kebab-case identifier. Names the Op's output directory (`dist/ops/<name>/`), and is the name `chant run <name>` and another Op's `depends` refer to. */
|
|
@@ -78,8 +79,8 @@ export interface OpConfig {
|
|
|
78
79
|
failOn?: "drift";
|
|
79
80
|
}
|
|
80
81
|
|
|
81
|
-
/** The exit code `chant run` returns for a completed run that found drift, under `failOn: "drift"` or `--fail-on-drift` (#3675). */
|
|
82
|
-
export const DRIFT_EXIT_CODE =
|
|
82
|
+
/** The exit code `chant run` returns for a completed run that found drift, under `failOn: "drift"` or `--fail-on-drift` (#3675): `CHANT_EXIT.drift`. */
|
|
83
|
+
export const DRIFT_EXIT_CODE = CHANT_EXIT.drift;
|
|
83
84
|
|
|
84
85
|
/**
|
|
85
86
|
* The id under which a run's work lease is published to its steps (#2748):
|
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* OTLP gauges (#4612): the metrics half of chant's exporter (./otlp.ts,
|
|
3
|
+
* #4555, traces only), for the estate's delivery metrics. Same transport:
|
|
4
|
+
* OTLP/JSON over HTTP with `fetch`, no SDK, off with no endpoint. It reads
|
|
5
|
+
* the metrics variables the way ./otlp.ts reads the traces ones, and the
|
|
6
|
+
* way terragucci's src/telemetry.ts reads both:
|
|
7
|
+
*
|
|
8
|
+
* OTEL_EXPORTER_OTLP_ENDPOINT base URL; /v1/metrics is added
|
|
9
|
+
* OTEL_EXPORTER_OTLP_METRICS_ENDPOINT the metrics URL, used as given
|
|
10
|
+
* OTEL_EXPORTER_OTLP_HEADERS, OTEL_EXPORTER_OTLP_METRICS_HEADERS
|
|
11
|
+
* OTEL_METRICS_EXPORTER `none` turns metrics off
|
|
12
|
+
* OTEL_SDK_DISABLED=true turns them off
|
|
13
|
+
* OTEL_SERVICE_NAME, OTEL_RESOURCE_ATTRIBUTES
|
|
14
|
+
*
|
|
15
|
+
* The body is terragucci's `metricsBody`: one gauge data point each,
|
|
16
|
+
* grouped by name, so a collector that took terragucci's gauges takes these.
|
|
17
|
+
*/
|
|
18
|
+
import { CHANT_VERSION } from "./chant-version";
|
|
19
|
+
import { activeProductWords } from "./ci-product-words";
|
|
20
|
+
import { parseOtlpPairs, sendOtlp, type OtlpAttrs, type OtlpFetch, type OtlpTarget } from "./otlp";
|
|
21
|
+
|
|
22
|
+
/** One gauge: a value now, with its attributes. */
|
|
23
|
+
export interface OtlpGauge {
|
|
24
|
+
name: string;
|
|
25
|
+
unit: string;
|
|
26
|
+
description: string;
|
|
27
|
+
value: number;
|
|
28
|
+
attributes: Record<string, string>;
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
/** Where gauges go, from the environment, or why they do not. */
|
|
32
|
+
export interface OtlpMetricsConfig {
|
|
33
|
+
metrics?: OtlpTarget;
|
|
34
|
+
resource: OtlpAttrs;
|
|
35
|
+
skipped: string[];
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
/** The metrics settings from `env`, or undefined when no endpoint is set or the SDK is disabled. `service.name` defaults to the product's name. */
|
|
39
|
+
export function otlpMetricsFromEnv(env: NodeJS.ProcessEnv = process.env, opts: { product?: string } = {}): OtlpMetricsConfig | undefined {
|
|
40
|
+
if (env.OTEL_SDK_DISABLED?.trim().toLowerCase() === "true") return undefined;
|
|
41
|
+
const exporter = env.OTEL_METRICS_EXPORTER;
|
|
42
|
+
if (exporter !== undefined && exporter.trim() !== "" && !exporter.split(",").map((s) => s.trim()).includes("otlp")) return undefined;
|
|
43
|
+
const own = env.OTEL_EXPORTER_OTLP_METRICS_ENDPOINT?.trim();
|
|
44
|
+
const base = env.OTEL_EXPORTER_OTLP_ENDPOINT?.trim();
|
|
45
|
+
const url = own || (base ? `${base.replace(/\/+$/, "")}/v1/metrics` : undefined);
|
|
46
|
+
if (!url) return undefined;
|
|
47
|
+
const resource: OtlpAttrs = { ...parseOtlpPairs(env.OTEL_RESOURCE_ATTRIBUTES) };
|
|
48
|
+
resource["service.name"] = env.OTEL_SERVICE_NAME?.trim() || resource["service.name"] || (opts.product ?? activeProductWords().product);
|
|
49
|
+
const skipped: string[] = [];
|
|
50
|
+
const protocol = env.OTEL_EXPORTER_OTLP_METRICS_PROTOCOL ?? env.OTEL_EXPORTER_OTLP_PROTOCOL;
|
|
51
|
+
if (protocol === "grpc") skipped.push("metrics: chant sends OTLP over HTTP and the protocol is grpc; point it at the collector's HTTP port");
|
|
52
|
+
else if (!/^https?:\/\//.test(url)) skipped.push(`metrics: ${url} is not an http or https URL`);
|
|
53
|
+
if (skipped.length) return { resource, skipped };
|
|
54
|
+
return { metrics: { url, headers: { ...parseOtlpPairs(env.OTEL_EXPORTER_OTLP_HEADERS), ...parseOtlpPairs(env.OTEL_EXPORTER_OTLP_METRICS_HEADERS) } }, resource, skipped };
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
const attrList = (attrs: OtlpAttrs): { key: string; value: Record<string, unknown> }[] =>
|
|
58
|
+
Object.entries(attrs)
|
|
59
|
+
.filter((e): e is [string, string | number | boolean] => e[1] !== undefined)
|
|
60
|
+
.map(([key, v]) => ({ key, value: typeof v === "string" ? { stringValue: v } : typeof v === "boolean" ? { boolValue: v } : Number.isInteger(v) ? { intValue: String(v) } : { doubleValue: v } }));
|
|
61
|
+
|
|
62
|
+
/** The OTLP/JSON body for gauges, one data point each, grouped by name. `at` is the time in nanoseconds. */
|
|
63
|
+
export function otlpMetricsBody(gauges: readonly OtlpGauge[], resource: OtlpAttrs, at: bigint = BigInt(Date.now()) * 1_000_000n, version: string = CHANT_VERSION): unknown {
|
|
64
|
+
const byName = new Map<string, OtlpGauge[]>();
|
|
65
|
+
for (const g of gauges) byName.set(g.name, [...(byName.get(g.name) ?? []), g]);
|
|
66
|
+
return {
|
|
67
|
+
resourceMetrics: [{
|
|
68
|
+
resource: { attributes: attrList(resource) },
|
|
69
|
+
scopeMetrics: [{
|
|
70
|
+
scope: { name: "chant", version },
|
|
71
|
+
metrics: [...byName.values()].map((gs) => ({
|
|
72
|
+
name: gs[0]!.name,
|
|
73
|
+
unit: gs[0]!.unit,
|
|
74
|
+
description: gs[0]!.description,
|
|
75
|
+
gauge: { dataPoints: gs.map((g) => ({ attributes: attrList(g.attributes), timeUnixNano: String(at), asDouble: g.value })) },
|
|
76
|
+
})),
|
|
77
|
+
}],
|
|
78
|
+
}],
|
|
79
|
+
};
|
|
80
|
+
}
|
|
81
|
+
|
|
82
|
+
/** What sending gauges came to: how many went, or why none did. */
|
|
83
|
+
export type OtlpGaugesSent = { sent: number } | { problem: string };
|
|
84
|
+
|
|
85
|
+
/**
|
|
86
|
+
* Send gauges when the environment names a metrics endpoint. Undefined when
|
|
87
|
+
* it names none. Never throws: a collector that fails is the problem.
|
|
88
|
+
*/
|
|
89
|
+
export async function sendOtlpGauges(gauges: readonly OtlpGauge[], opts: { env?: NodeJS.ProcessEnv; fetch?: OtlpFetch; product?: string; version?: string } = {}): Promise<OtlpGaugesSent | undefined> {
|
|
90
|
+
const config = otlpMetricsFromEnv(opts.env ?? process.env, opts.product !== undefined ? { product: opts.product } : {});
|
|
91
|
+
if (!config) return undefined;
|
|
92
|
+
if (!config.metrics) return { problem: config.skipped.join("; ") };
|
|
93
|
+
if (gauges.length === 0) return { sent: 0 };
|
|
94
|
+
const problem = await sendOtlp(config.metrics, otlpMetricsBody(gauges, { ...config.resource, ...(opts.version ? { "service.version": opts.version } : {}) }), opts.fetch);
|
|
95
|
+
return problem ? { problem } : { sent: gauges.length };
|
|
96
|
+
}
|