@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
|
@@ -0,0 +1,407 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* `chant notify relay` (#4611): approve a waiting gate from chat.
|
|
3
|
+
*
|
|
4
|
+
* With `notify.relay` set, a waiting event's Slack message carries Approve
|
|
5
|
+
* and Decline buttons, and its Teams card the reply `approve <token>`
|
|
6
|
+
* (`./notify.ts`). The token is the waiting event's id, source, time, gate
|
|
7
|
+
* and digest, signed with the relay key. Slack posts a click to the relay's
|
|
8
|
+
* `/slack`, signed with the Slack app's signing secret; a Teams outgoing
|
|
9
|
+
* webhook posts the reply to `/teams`, signed with its HMAC key. The relay:
|
|
10
|
+
*
|
|
11
|
+
* 1. refuses a request whose chat signature does not verify (401), and a
|
|
12
|
+
* Slack request more than five minutes old;
|
|
13
|
+
* 2. refuses a token the relay key did not sign, or one older than its
|
|
14
|
+
* maximum age, so only a button chant's notify posted approves anything;
|
|
15
|
+
* 3. maps the chat user to a principal: the signers file at base lists
|
|
16
|
+
* `slack:<team>/<user>` or `teams:<aad object id>` on that person's line.
|
|
17
|
+
* A user no line lists is refused, and so is the relay's own principal;
|
|
18
|
+
* 4. finds the standing pending fact at the token's gate whose plan or
|
|
19
|
+
* change set is the token's digest. A digest that moved, or a gate
|
|
20
|
+
* approved already, approves nothing;
|
|
21
|
+
* 5. refuses the requester of a gated request (#4551), whose own approval
|
|
22
|
+
* never counts;
|
|
23
|
+
* 6. records the approval as `chant approve <op> <gate> --plan <digest>
|
|
24
|
+
* --actor <principal> --relayed-by <relay>` does, with every rule that
|
|
25
|
+
* command applies: the decision point, `identity.gates` (the relay holds
|
|
26
|
+
* no key, so a sealed gate is refused), the gate policy and the push.
|
|
27
|
+
*
|
|
28
|
+
* Decline records nothing and says who declined. The type-the-name prompt
|
|
29
|
+
* of `chant approve` (#4575) is for a terminal; a signed click is the
|
|
30
|
+
* person's confirmation here. The relay starts no job: the resume job
|
|
31
|
+
* applies the wave once the approval stands.
|
|
32
|
+
*/
|
|
33
|
+
|
|
34
|
+
import { createHmac, timingSafeEqual } from "node:crypto";
|
|
35
|
+
import { createServer, type IncomingMessage, type Server } from "node:http";
|
|
36
|
+
import type { CiProductWords } from "./ci-product-words";
|
|
37
|
+
import type { GatedRequest } from "./lifecycle/gated-request-digest";
|
|
38
|
+
import { readRelayToken, RELAY_APPROVE_ACTION, RELAY_DECLINE_ACTION, type RelayRef } from "./notify";
|
|
39
|
+
|
|
40
|
+
/** The relay's settings, by environment variable. */
|
|
41
|
+
export const RELAY_ENV = {
|
|
42
|
+
/** The key the notify buttons are signed with: the variable `notify.relay` names on the sending side. */
|
|
43
|
+
key: "CHANT_RELAY_KEY",
|
|
44
|
+
slackSecret: "SLACK_SIGNING_SECRET",
|
|
45
|
+
teamsSecret: "TEAMS_WEBHOOK_SECRET",
|
|
46
|
+
/** The principal recorded as `relayedBy`. Default `<product>-relay`. */
|
|
47
|
+
principal: "CHANT_RELAY_PRINCIPAL",
|
|
48
|
+
/** How old a button may be, in seconds. */
|
|
49
|
+
maxAge: "CHANT_RELAY_MAX_AGE",
|
|
50
|
+
host: "CHANT_RELAY_HOST",
|
|
51
|
+
port: "CHANT_RELAY_PORT",
|
|
52
|
+
/** Comma-separated address prefixes a Slack response_url may have. */
|
|
53
|
+
slackResponse: "CHANT_RELAY_SLACK_RESPONSE",
|
|
54
|
+
} as const;
|
|
55
|
+
|
|
56
|
+
/** Slack's own reply hosts: hooks.slack.com, and GovSlack's. */
|
|
57
|
+
export const SLACK_RESPONSE_PREFIXES = ["https://hooks.slack.com/", "https://hooks.slack-gov.com/"];
|
|
58
|
+
const SLACK_WINDOW_S = 5 * 60;
|
|
59
|
+
/** Where the relay listens by default: loopback, so it is reachable only through what the operator puts in front of it. */
|
|
60
|
+
export const DEFAULT_RELAY_HOST = "127.0.0.1";
|
|
61
|
+
export const DEFAULT_RELAY_PORT = 8787;
|
|
62
|
+
|
|
63
|
+
// ── chat signatures ──────────────────────────────────────────────────────
|
|
64
|
+
|
|
65
|
+
const header = (h: Record<string, string | undefined>, name: string): string | undefined => h[name] ?? h[name.toLowerCase()];
|
|
66
|
+
|
|
67
|
+
const same = (a: string, b: string): boolean => {
|
|
68
|
+
const x = Buffer.from(a);
|
|
69
|
+
const y = Buffer.from(b);
|
|
70
|
+
return x.length === y.length && timingSafeEqual(x, y);
|
|
71
|
+
};
|
|
72
|
+
|
|
73
|
+
/** `v0=<hex>`: Slack's signature, HMAC-SHA256 of `v0:<timestamp>:<raw body>` with the app's signing secret. */
|
|
74
|
+
export const slackSignature = (secret: string, timestamp: string, raw: string): string => `v0=${createHmac("sha256", secret).update(`v0:${timestamp}:${raw}`).digest("hex")}`;
|
|
75
|
+
|
|
76
|
+
/** Why a Slack request is refused, or null when it verifies and is recent. */
|
|
77
|
+
export function verifySlackRequest(headers: Record<string, string | undefined>, raw: string, secret: string | undefined, now: number = Date.now()): string | null {
|
|
78
|
+
if (!secret) return `${RELAY_ENV.slackSecret} is empty, so no Slack request can be verified`;
|
|
79
|
+
const ts = header(headers, "x-slack-request-timestamp") ?? "";
|
|
80
|
+
const sig = header(headers, "x-slack-signature") ?? "";
|
|
81
|
+
if (!/^\d+$/.test(ts) || !sig) return "the request is not signed";
|
|
82
|
+
if (Math.abs(now / 1000 - Number(ts)) > SLACK_WINDOW_S) return "the request is more than five minutes old";
|
|
83
|
+
return same(sig, slackSignature(secret, ts, raw)) ? null : "the signature does not verify";
|
|
84
|
+
}
|
|
85
|
+
|
|
86
|
+
/** `HMAC <base64>`: a Teams outgoing webhook's signature, HMAC-SHA256 of the raw body with the key Teams gave (base64). */
|
|
87
|
+
export const teamsSignature = (secret: string, raw: string): string => `HMAC ${createHmac("sha256", Buffer.from(secret, "base64")).update(raw).digest("base64")}`;
|
|
88
|
+
|
|
89
|
+
/** Why a Teams request is refused, or null when it verifies. */
|
|
90
|
+
export function verifyTeamsRequest(headers: Record<string, string | undefined>, raw: string, secret: string | undefined): string | null {
|
|
91
|
+
if (!secret) return `${RELAY_ENV.teamsSecret} is empty, so no Teams request can be verified`;
|
|
92
|
+
const auth = header(headers, "authorization") ?? "";
|
|
93
|
+
if (!auth.startsWith("HMAC ")) return "the request is not signed";
|
|
94
|
+
return same(auth, teamsSignature(secret, raw)) ? null : "the signature does not verify";
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
// ── clicks ───────────────────────────────────────────────────────────────
|
|
98
|
+
|
|
99
|
+
/** One click or reply, read from a verified request. */
|
|
100
|
+
export interface RelayClick {
|
|
101
|
+
app: "slack" | "teams";
|
|
102
|
+
/** `slack:<team>/<user>` or `teams:<aad object id>`: what the signers file lists. */
|
|
103
|
+
chatUser: string;
|
|
104
|
+
/** The name chat shows, for the reply. */
|
|
105
|
+
display: string;
|
|
106
|
+
action: "approve" | "decline";
|
|
107
|
+
/** The signed button value. */
|
|
108
|
+
token: string;
|
|
109
|
+
responseUrl?: string;
|
|
110
|
+
thread?: string;
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
/** A Slack `block_actions` payload (the form field `payload`), or why the relay does not read it. */
|
|
114
|
+
export function slackRelayClick(raw: string): RelayClick | { error: string } {
|
|
115
|
+
let p: any;
|
|
116
|
+
try {
|
|
117
|
+
p = JSON.parse(new URLSearchParams(raw).get("payload") ?? "");
|
|
118
|
+
} catch {
|
|
119
|
+
return { error: "the request carries no Slack payload" };
|
|
120
|
+
}
|
|
121
|
+
if (p?.type !== "block_actions") return { error: `a Slack ${String(p?.type)} payload is not a button click` };
|
|
122
|
+
const team = p.user?.team_id ?? p.team?.id;
|
|
123
|
+
const user = p.user?.id;
|
|
124
|
+
if (typeof team !== "string" || typeof user !== "string") return { error: "the click names no Slack user" };
|
|
125
|
+
const a = Array.isArray(p.actions) ? p.actions[0] : undefined;
|
|
126
|
+
const action = a?.action_id === RELAY_APPROVE_ACTION ? "approve" : a?.action_id === RELAY_DECLINE_ACTION ? "decline" : undefined;
|
|
127
|
+
if (!action) return { error: `the button ${String(a?.action_id)} is not chant's` };
|
|
128
|
+
if (typeof a.value !== "string" || !a.value) return { error: "the button carries no reference" };
|
|
129
|
+
const thread = p.container?.message_ts ?? p.message?.ts;
|
|
130
|
+
return {
|
|
131
|
+
app: "slack",
|
|
132
|
+
chatUser: `slack:${team}/${user}`,
|
|
133
|
+
display: String(p.user?.username ?? p.user?.name ?? user),
|
|
134
|
+
action,
|
|
135
|
+
token: a.value,
|
|
136
|
+
...(typeof p.response_url === "string" ? { responseUrl: p.response_url } : {}),
|
|
137
|
+
...(typeof thread === "string" ? { thread } : {}),
|
|
138
|
+
};
|
|
139
|
+
}
|
|
140
|
+
|
|
141
|
+
/** A Teams message's words, with its mention and markup dropped. */
|
|
142
|
+
const teamsWords = (text: string): string[] =>
|
|
143
|
+
text
|
|
144
|
+
.replace(/<at>[^<]*<\/at>/gi, " ")
|
|
145
|
+
.replace(/<[^>]+>/g, " ")
|
|
146
|
+
.replace(/ /gi, " ")
|
|
147
|
+
.replace(/&/gi, "&")
|
|
148
|
+
.trim()
|
|
149
|
+
.split(/\s+/)
|
|
150
|
+
.filter(Boolean);
|
|
151
|
+
|
|
152
|
+
/** A Teams outgoing webhook's message, `@<relay> approve|decline <token>`, or why it is not one. */
|
|
153
|
+
export function teamsRelayClick(raw: string): RelayClick | { error: string } {
|
|
154
|
+
let m: any;
|
|
155
|
+
try {
|
|
156
|
+
m = JSON.parse(raw);
|
|
157
|
+
} catch {
|
|
158
|
+
return { error: "the request is not a Teams message" };
|
|
159
|
+
}
|
|
160
|
+
const user = m?.from?.aadObjectId;
|
|
161
|
+
if (typeof user !== "string" || !user) return { error: "the message names no Teams user" };
|
|
162
|
+
const [verb, token, extra] = teamsWords(String(m.text ?? ""));
|
|
163
|
+
if ((verb !== "approve" && verb !== "decline") || !token || extra !== undefined) return { error: "reply approve or decline, then the reference from the message: approve <reference>" };
|
|
164
|
+
return { app: "teams", chatUser: `teams:${user}`, display: String(m.from?.name ?? user), action: verb, token };
|
|
165
|
+
}
|
|
166
|
+
|
|
167
|
+
// ── who clicked ──────────────────────────────────────────────────────────
|
|
168
|
+
|
|
169
|
+
const CHAT_ID = /^(slack|teams):/;
|
|
170
|
+
const norm = (s: string): string => s.normalize("NFKC").trim().toLowerCase();
|
|
171
|
+
|
|
172
|
+
/**
|
|
173
|
+
* The principal a chat user maps to: the signers file line that lists the
|
|
174
|
+
* chat id gives the line's first principal that is not a chat id. Undefined
|
|
175
|
+
* when no line lists it, or lines listing it name different principals.
|
|
176
|
+
*/
|
|
177
|
+
export function relayPrincipalFor(signers: ReadonlyArray<{ principal: string; line: number }>, chatUser: string): string | undefined {
|
|
178
|
+
const id = norm(chatUser);
|
|
179
|
+
const lines = new Map<number, string[]>();
|
|
180
|
+
for (const s of signers) lines.set(s.line, [...(lines.get(s.line) ?? []), norm(s.principal)]);
|
|
181
|
+
const found = new Set<string>();
|
|
182
|
+
for (const principals of lines.values()) {
|
|
183
|
+
if (!principals.includes(id)) continue;
|
|
184
|
+
const p = principals.find((x) => !CHAT_ID.test(x));
|
|
185
|
+
if (p) found.add(p);
|
|
186
|
+
}
|
|
187
|
+
return found.size === 1 ? [...found][0] : undefined;
|
|
188
|
+
}
|
|
189
|
+
|
|
190
|
+
// ── deciding ─────────────────────────────────────────────────────────────
|
|
191
|
+
|
|
192
|
+
/** A standing pending fact the token's digest matched. */
|
|
193
|
+
export interface RelayPending {
|
|
194
|
+
op: string;
|
|
195
|
+
gate: string;
|
|
196
|
+
/** The digest the fact asks an approval of: its plan's, else its change set's. */
|
|
197
|
+
digest: string;
|
|
198
|
+
environment?: string;
|
|
199
|
+
/** On a gated request (#4551): the request, whose requester may not approve it. */
|
|
200
|
+
request?: GatedRequest;
|
|
201
|
+
}
|
|
202
|
+
|
|
203
|
+
/** What the relay reads and writes, so a test stands in for the repo. */
|
|
204
|
+
export interface RelayDeps {
|
|
205
|
+
/** The signers file at base, and its path for the refusal. */
|
|
206
|
+
signers(): Promise<{ signers: ReadonlyArray<{ principal: string; line: number }>; path: string }>;
|
|
207
|
+
/** The standing pending facts whose plan or change set is `digest`. */
|
|
208
|
+
pending(digest: string): Promise<RelayPending[]>;
|
|
209
|
+
/** Record the approval as `chant approve` does. `error` is why it refused. */
|
|
210
|
+
approve(input: { op: string; gate: string; digest: string; environment?: string; actor: string; relayedBy: string }): Promise<{ ok: true } | { ok: false; error: string }>;
|
|
211
|
+
/** Who the relay records as `relayedBy`. */
|
|
212
|
+
principal: string;
|
|
213
|
+
words: CiProductWords;
|
|
214
|
+
now?: () => Date;
|
|
215
|
+
}
|
|
216
|
+
|
|
217
|
+
export interface RelaySettings {
|
|
218
|
+
/** The relay key: buttons it did not sign are refused. */
|
|
219
|
+
key?: string;
|
|
220
|
+
slackSecret?: string;
|
|
221
|
+
teamsSecret?: string;
|
|
222
|
+
maxAgeSeconds?: number;
|
|
223
|
+
slackResponse?: string[];
|
|
224
|
+
}
|
|
225
|
+
|
|
226
|
+
/** The relay's answer to a click, and the line for the thread. */
|
|
227
|
+
export interface RelayAnswer {
|
|
228
|
+
ok: boolean;
|
|
229
|
+
/** What the relay did: `approved`, `declined`, or the refusal's kind. */
|
|
230
|
+
outcome: "approved" | "declined" | "bad-reference" | "stale" | "ineligible" | "moved" | "refused";
|
|
231
|
+
text: string;
|
|
232
|
+
/** The gate's op, when the click reached one. */
|
|
233
|
+
op?: string;
|
|
234
|
+
gate?: string;
|
|
235
|
+
principal?: string;
|
|
236
|
+
}
|
|
237
|
+
|
|
238
|
+
/** Decide a click and record what it approves. Never throws: an error is the answer's text. */
|
|
239
|
+
export async function decideRelayClick(click: RelayClick, settings: RelaySettings, deps: RelayDeps): Promise<RelayAnswer> {
|
|
240
|
+
const words = deps.words;
|
|
241
|
+
const checked = readRelayToken(settings.key, click.token, { ...(deps.now ? { now: deps.now() } : {}), ...(settings.maxAgeSeconds !== undefined ? { maxAgeSeconds: settings.maxAgeSeconds } : {}) });
|
|
242
|
+
if (!checked.ok) return { ok: false, outcome: /old|future/.test(checked.reason) ? "stale" : "bad-reference", text: `Refused: ${checked.reason}. Nothing was ${click.action === "approve" ? "approved" : "declined"}.` };
|
|
243
|
+
const ref: RelayRef = checked.ref;
|
|
244
|
+
try {
|
|
245
|
+
const { signers, path } = await deps.signers();
|
|
246
|
+
const principal = relayPrincipalFor(signers, click.chatUser);
|
|
247
|
+
if (!principal) {
|
|
248
|
+
return { ok: false, outcome: "ineligible", gate: ref.gate, text: `Refused: ${click.display} (${click.chatUser}) is not mapped to a principal in ${path} at base, so nothing was recorded. A maintainer adds ${click.chatUser} to that person's line.` };
|
|
249
|
+
}
|
|
250
|
+
if (norm(principal) === norm(deps.principal)) {
|
|
251
|
+
return { ok: false, outcome: "ineligible", gate: ref.gate, principal, text: `Refused: ${principal} is the relay, and the relay never approves.` };
|
|
252
|
+
}
|
|
253
|
+
if (click.action === "decline") {
|
|
254
|
+
return { ok: true, outcome: "declined", gate: ref.gate, principal, text: `${ref.gate} declined by ${principal} for ${ref.digest}. Nothing was recorded; the gate keeps waiting.` };
|
|
255
|
+
}
|
|
256
|
+
const standing = (await deps.pending(ref.digest)).filter((p) => p.gate === ref.gate);
|
|
257
|
+
if (standing.length === 0) {
|
|
258
|
+
return { ok: false, outcome: "moved", gate: ref.gate, principal, text: `Not approved: ${ref.gate} does not wait for ${ref.digest}. The plan moved since this message, or it was approved already. Read the plan waiting now and approve its digest.` };
|
|
259
|
+
}
|
|
260
|
+
if (standing.length > 1) {
|
|
261
|
+
return { ok: false, outcome: "refused", gate: ref.gate, principal, text: `Not approved: ${ref.gate} waits for ${ref.digest} under ${standing.map((p) => p.op).join(", ")}, so the click names no one gate. Approve at a shell with the op named.` };
|
|
262
|
+
}
|
|
263
|
+
const pending = standing[0]!;
|
|
264
|
+
if (pending.request && norm(pending.request.by) === norm(principal)) {
|
|
265
|
+
return { ok: false, outcome: "ineligible", op: pending.op, gate: pending.gate, principal, text: `Refused: ${principal} made the request, and a requester's own approval does not count. Someone else approves it.` };
|
|
266
|
+
}
|
|
267
|
+
const recorded = await deps.approve({ op: pending.op, gate: pending.gate, digest: pending.digest, ...(pending.environment !== undefined ? { environment: pending.environment } : {}), actor: principal, relayedBy: deps.principal });
|
|
268
|
+
if (!recorded.ok) return { ok: false, outcome: "refused", op: pending.op, gate: pending.gate, principal, text: `Not approved: ${recorded.error}` };
|
|
269
|
+
return {
|
|
270
|
+
ok: true,
|
|
271
|
+
outcome: "approved",
|
|
272
|
+
op: pending.op,
|
|
273
|
+
gate: pending.gate,
|
|
274
|
+
principal,
|
|
275
|
+
text: `${pending.gate} on ${pending.op} approved by ${principal}, relayed by ${deps.principal}, for ${pending.digest} and no other plan. The resume job starts the ${words.stages.apply} once the gate passes.`,
|
|
276
|
+
};
|
|
277
|
+
} catch (e) {
|
|
278
|
+
return { ok: false, outcome: "refused", gate: ref.gate, text: `Not recorded: ${(e as Error).message}` };
|
|
279
|
+
}
|
|
280
|
+
}
|
|
281
|
+
|
|
282
|
+
// ── HTTP ─────────────────────────────────────────────────────────────────
|
|
283
|
+
|
|
284
|
+
export interface RelayRequest {
|
|
285
|
+
method: string;
|
|
286
|
+
path: string;
|
|
287
|
+
headers: Record<string, string | undefined>;
|
|
288
|
+
body: string;
|
|
289
|
+
}
|
|
290
|
+
|
|
291
|
+
export interface RelayResponse {
|
|
292
|
+
status: number;
|
|
293
|
+
headers: Record<string, string>;
|
|
294
|
+
body: string;
|
|
295
|
+
}
|
|
296
|
+
|
|
297
|
+
/** The part of `fetch` the relay posts Slack replies with. */
|
|
298
|
+
export type RelayFetch = (url: string, init: { method: string; headers: Record<string, string>; body: string }) => Promise<{ ok: boolean; status: number }>;
|
|
299
|
+
|
|
300
|
+
const json = (status: number, body: unknown): RelayResponse => ({ status, headers: { "content-type": "application/json" }, body: JSON.stringify(body) });
|
|
301
|
+
const plain = (status: number, body: string): RelayResponse => ({ status, headers: { "content-type": "text/plain" }, body });
|
|
302
|
+
|
|
303
|
+
/**
|
|
304
|
+
* One request: `POST /slack`, `POST /teams`, `GET /healthz`. A Slack answer
|
|
305
|
+
* goes to the click's response_url, in the message's thread, when that is
|
|
306
|
+
* Slack's; a Teams answer is the reply Teams posts under the message.
|
|
307
|
+
*/
|
|
308
|
+
export async function handleRelayRequest(
|
|
309
|
+
req: RelayRequest,
|
|
310
|
+
settings: RelaySettings,
|
|
311
|
+
deps: RelayDeps,
|
|
312
|
+
options: { post?: RelayFetch; log?: (line: string) => void; now?: number } = {},
|
|
313
|
+
): Promise<RelayResponse> {
|
|
314
|
+
const log = options.log ?? (() => {});
|
|
315
|
+
const path = req.path.split("?")[0]!;
|
|
316
|
+
if (req.method === "GET" && path === "/healthz") return plain(200, "ok");
|
|
317
|
+
if (req.method !== "POST" || (path !== "/slack" && path !== "/teams")) return plain(404, "not found");
|
|
318
|
+
if (path === "/slack") {
|
|
319
|
+
const refused = verifySlackRequest(req.headers, req.body, settings.slackSecret, options.now);
|
|
320
|
+
if (refused) {
|
|
321
|
+
log(`slack: refused a request: ${refused}`);
|
|
322
|
+
return plain(401, refused);
|
|
323
|
+
}
|
|
324
|
+
const click = slackRelayClick(req.body);
|
|
325
|
+
if ("error" in click) return plain(400, click.error);
|
|
326
|
+
const answer = await decideRelayClick(click, settings, deps);
|
|
327
|
+
log(`slack: ${click.chatUser} ${click.action}: ${answer.outcome}: ${answer.text}`);
|
|
328
|
+
if (click.responseUrl) {
|
|
329
|
+
const allowed = settings.slackResponse ?? SLACK_RESPONSE_PREFIXES;
|
|
330
|
+
if (!allowed.some((p) => click.responseUrl!.startsWith(p))) log(`slack: the response_url is not Slack's (${allowed.join(", ")}); no reply was posted`);
|
|
331
|
+
else {
|
|
332
|
+
try {
|
|
333
|
+
const post = options.post ?? ((url, init) => globalThis.fetch(url, init));
|
|
334
|
+
const r = await post(click.responseUrl, { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify({ response_type: "in_channel", replace_original: false, ...(click.thread ? { thread_ts: click.thread } : {}), text: answer.text }) });
|
|
335
|
+
if (!r.ok) log(`slack: the reply answered ${r.status}`);
|
|
336
|
+
} catch (e) {
|
|
337
|
+
log(`slack: the reply did not land (${(e as Error).message})`);
|
|
338
|
+
}
|
|
339
|
+
}
|
|
340
|
+
}
|
|
341
|
+
return plain(200, "");
|
|
342
|
+
}
|
|
343
|
+
const refused = verifyTeamsRequest(req.headers, req.body, settings.teamsSecret);
|
|
344
|
+
if (refused) {
|
|
345
|
+
log(`teams: refused a request: ${refused}`);
|
|
346
|
+
return plain(401, refused);
|
|
347
|
+
}
|
|
348
|
+
const click = teamsRelayClick(req.body);
|
|
349
|
+
if ("error" in click) return json(200, { type: "message", text: click.error });
|
|
350
|
+
const answer = await decideRelayClick(click, settings, deps);
|
|
351
|
+
log(`teams: ${click.chatUser} ${click.action}: ${answer.outcome}: ${answer.text}`);
|
|
352
|
+
return json(200, { type: "message", text: answer.text });
|
|
353
|
+
}
|
|
354
|
+
|
|
355
|
+
/** The largest request body the relay reads. Slack and Teams send a few kilobytes. */
|
|
356
|
+
const MAX_BODY = 256 * 1024;
|
|
357
|
+
|
|
358
|
+
function readBody(req: IncomingMessage): Promise<string> {
|
|
359
|
+
return new Promise((resolve, reject) => {
|
|
360
|
+
const chunks: Buffer[] = [];
|
|
361
|
+
let size = 0;
|
|
362
|
+
req.on("data", (c: Buffer) => {
|
|
363
|
+
size += c.length;
|
|
364
|
+
if (size > MAX_BODY) {
|
|
365
|
+
reject(new Error("the request body is too large"));
|
|
366
|
+
req.destroy();
|
|
367
|
+
} else chunks.push(c);
|
|
368
|
+
});
|
|
369
|
+
req.on("end", () => resolve(Buffer.concat(chunks).toString("utf8")));
|
|
370
|
+
req.on("error", reject);
|
|
371
|
+
});
|
|
372
|
+
}
|
|
373
|
+
|
|
374
|
+
/** Start the relay's HTTP server on `host:port` (port 0 picks a free one). Resolves once it listens. */
|
|
375
|
+
export async function startRelayServer(
|
|
376
|
+
settings: RelaySettings,
|
|
377
|
+
deps: RelayDeps,
|
|
378
|
+
options: { host?: string; port?: number; post?: RelayFetch; log?: (line: string) => void } = {},
|
|
379
|
+
): Promise<{ server: Server; url: string; close: () => Promise<void> }> {
|
|
380
|
+
const server = createServer((req, res) => {
|
|
381
|
+
void (async () => {
|
|
382
|
+
let out: RelayResponse;
|
|
383
|
+
try {
|
|
384
|
+
const body = await readBody(req);
|
|
385
|
+
const headers: Record<string, string | undefined> = {};
|
|
386
|
+
for (const [k, v] of Object.entries(req.headers)) headers[k.toLowerCase()] = Array.isArray(v) ? v[0] : v;
|
|
387
|
+
out = await handleRelayRequest({ method: req.method ?? "GET", path: req.url ?? "/", headers, body }, settings, deps, { ...(options.post ? { post: options.post } : {}), ...(options.log ? { log: options.log } : {}) });
|
|
388
|
+
} catch (e) {
|
|
389
|
+
out = plain(400, (e as Error).message);
|
|
390
|
+
}
|
|
391
|
+
res.writeHead(out.status, out.headers);
|
|
392
|
+
res.end(out.body);
|
|
393
|
+
})();
|
|
394
|
+
});
|
|
395
|
+
const host = options.host ?? DEFAULT_RELAY_HOST;
|
|
396
|
+
await new Promise<void>((resolve, reject) => {
|
|
397
|
+
server.once("error", reject);
|
|
398
|
+
server.listen(options.port ?? DEFAULT_RELAY_PORT, host, () => resolve());
|
|
399
|
+
});
|
|
400
|
+
const address = server.address();
|
|
401
|
+
const port = typeof address === "object" && address ? address.port : options.port ?? DEFAULT_RELAY_PORT;
|
|
402
|
+
return {
|
|
403
|
+
server,
|
|
404
|
+
url: `http://${host.includes(":") ? `[${host}]` : host}:${port}`,
|
|
405
|
+
close: () => new Promise<void>((resolve) => server.close(() => resolve())),
|
|
406
|
+
};
|
|
407
|
+
}
|
package/src/notify.ts
CHANGED
|
@@ -28,7 +28,7 @@
|
|
|
28
28
|
* `./notify-verify.ts` (`./notify-bundle.test.ts`).
|
|
29
29
|
*/
|
|
30
30
|
|
|
31
|
-
import { createHash, randomUUID } from "node:crypto";
|
|
31
|
+
import { createHash, createHmac, randomUUID, timingSafeEqual } from "node:crypto";
|
|
32
32
|
import { DEFAULT_HEADER_PREFIX, signWebhook, webhookHeaderNames } from "./notify-verify";
|
|
33
33
|
|
|
34
34
|
export { DEFAULT_HEADER_PREFIX, DEFAULT_TOLERANCE_SECONDS, signWebhook, verifyWebhook, webhookHeaderNames } from "./notify-verify";
|
|
@@ -184,8 +184,69 @@ function facts(e: NotifyEvent): { title: string; value: string; link?: string }[
|
|
|
184
184
|
return out;
|
|
185
185
|
}
|
|
186
186
|
|
|
187
|
-
|
|
188
|
-
|
|
187
|
+
// ── relay buttons (#4611) ────────────────────────────────────────────────
|
|
188
|
+
|
|
189
|
+
/** The Slack buttons' action ids, which `chant notify relay` reads. */
|
|
190
|
+
export const RELAY_APPROVE_ACTION = "chant-approve";
|
|
191
|
+
export const RELAY_DECLINE_ACTION = "chant-decline";
|
|
192
|
+
|
|
193
|
+
/** What a relay button carries: the waiting event it was posted for, signed with the relay key. */
|
|
194
|
+
export interface RelayRef {
|
|
195
|
+
/** The event's `id`, `source` and `at`. */
|
|
196
|
+
id: string;
|
|
197
|
+
source: string;
|
|
198
|
+
at: string;
|
|
199
|
+
gate: string;
|
|
200
|
+
digest: string;
|
|
201
|
+
}
|
|
202
|
+
|
|
203
|
+
const relayMac = (key: string, payload: string): string => createHmac("sha256", key).update(`chant-relay.${payload}`, "utf8").digest("hex");
|
|
204
|
+
|
|
205
|
+
/** The ref of a waiting event a relay can approve, or undefined for any other event. */
|
|
206
|
+
export function relayRefOf(e: NotifyEvent): RelayRef | undefined {
|
|
207
|
+
if (e.event !== "waiting" || !e.digest || !e.wave?.gate) return undefined;
|
|
208
|
+
return { id: e.id, source: e.source, at: e.at, gate: e.wave.gate, digest: e.digest };
|
|
209
|
+
}
|
|
210
|
+
|
|
211
|
+
/** `<base64url JSON>.<hex HMAC>`: the button value, signed with `key` so the relay knows its own notify posted it. */
|
|
212
|
+
export function relayToken(key: string, ref: RelayRef): string {
|
|
213
|
+
const payload = Buffer.from(JSON.stringify({ v: 1, ...ref }), "utf8").toString("base64url");
|
|
214
|
+
return `${payload}.${relayMac(key, payload)}`;
|
|
215
|
+
}
|
|
216
|
+
|
|
217
|
+
/** The ref a token carries when `key` signed it, or why it is refused. A ref older than `maxAgeSeconds` is stale. */
|
|
218
|
+
export function readRelayToken(key: string | undefined, token: string, options: { now?: Date; maxAgeSeconds?: number } = {}): { ok: true; ref: RelayRef } | { ok: false; reason: string } {
|
|
219
|
+
if (!key) return { ok: false, reason: "the relay has no key to check the button with" };
|
|
220
|
+
const [payload, mac, extra] = token.split(".");
|
|
221
|
+
if (!payload || !mac || extra !== undefined) return { ok: false, reason: "the button carries no chant notify reference" };
|
|
222
|
+
const expected = Buffer.from(relayMac(key, payload));
|
|
223
|
+
const given = Buffer.from(mac);
|
|
224
|
+
if (given.length !== expected.length || !timingSafeEqual(given, expected)) return { ok: false, reason: "the button was not signed with this relay's key" };
|
|
225
|
+
let ref: Partial<RelayRef> & { v?: unknown };
|
|
226
|
+
try {
|
|
227
|
+
ref = JSON.parse(Buffer.from(payload, "base64url").toString("utf8"));
|
|
228
|
+
} catch {
|
|
229
|
+
return { ok: false, reason: "the button's reference is not JSON" };
|
|
230
|
+
}
|
|
231
|
+
if (ref.v !== 1 || [ref.id, ref.source, ref.at, ref.gate, ref.digest].some((v) => typeof v !== "string" || v === "")) return { ok: false, reason: "the button's reference is not a chant.notify/v1 waiting event" };
|
|
232
|
+
const at = Date.parse(ref.at!);
|
|
233
|
+
const now = (options.now ?? new Date()).getTime();
|
|
234
|
+
const maxAge = options.maxAgeSeconds ?? DEFAULT_RELAY_MAX_AGE_SECONDS;
|
|
235
|
+
if (!Number.isFinite(at) || at - now > 5 * 60_000) return { ok: false, reason: "the event's time is in the future" };
|
|
236
|
+
if (now - at > maxAge * 1000) return { ok: false, reason: `the event is more than ${String(maxAge)}s old; approve from the newer message, or at a shell` };
|
|
237
|
+
return { ok: true, ref: { id: ref.id!, source: ref.source!, at: ref.at!, gate: ref.gate!, digest: ref.digest! } };
|
|
238
|
+
}
|
|
239
|
+
|
|
240
|
+
/** How old a relay button may be, in seconds: a day, a gate's default timeout. */
|
|
241
|
+
export const DEFAULT_RELAY_MAX_AGE_SECONDS = 24 * 60 * 60;
|
|
242
|
+
|
|
243
|
+
/** What a chat message adds for the relay: the signed button value. */
|
|
244
|
+
export interface RelayButtons {
|
|
245
|
+
token: string;
|
|
246
|
+
}
|
|
247
|
+
|
|
248
|
+
/** A Slack incoming webhook's body: one mrkdwn text, with the approve command as code and the links as links. With `relay`, Approve and Decline buttons (#4611). */
|
|
249
|
+
export function slackMessage(e: NotifyEvent, relay?: RelayButtons): { text: string; blocks?: unknown[] } {
|
|
189
250
|
const lines = [`*${notifyHeadline(e)}*`];
|
|
190
251
|
for (const f of facts(e)) {
|
|
191
252
|
if (f.title === "Review and approve") lines.push(`${f.title}: <${f.link}|pull request ${e.approve!.review!.pr}>, then run it again`);
|
|
@@ -193,12 +254,21 @@ export function slackMessage(e: NotifyEvent): { text: string } {
|
|
|
193
254
|
else if (f.link) lines.push(`${f.title}: <${f.link}>`);
|
|
194
255
|
else lines.push(`${f.title}: ${f.value}`);
|
|
195
256
|
}
|
|
196
|
-
|
|
257
|
+
const text = lines.join("\n");
|
|
258
|
+
if (!relay) return { text };
|
|
259
|
+
const button = (label: string, action: string, style?: string) => ({ type: "button", text: { type: "plain_text", text: label }, action_id: action, value: relay.token, ...(style ? { style } : {}) });
|
|
260
|
+
return {
|
|
261
|
+
text,
|
|
262
|
+
blocks: [
|
|
263
|
+
{ type: "section", text: { type: "mrkdwn", text } },
|
|
264
|
+
{ type: "actions", elements: [button("Approve", RELAY_APPROVE_ACTION, "primary"), button("Decline", RELAY_DECLINE_ACTION)] },
|
|
265
|
+
],
|
|
266
|
+
};
|
|
197
267
|
}
|
|
198
268
|
|
|
199
|
-
/** A Teams incoming webhook's body (a Workflows webhook): one Adaptive Card, with buttons that open the review page and the run. */
|
|
200
|
-
export function teamsMessage(e: NotifyEvent): Record<string, unknown> {
|
|
201
|
-
const all = facts(e);
|
|
269
|
+
/** A Teams incoming webhook's body (a Workflows webhook): one Adaptive Card, with buttons that open the review page and the run. With `relay`, the reply that approves through the relay (#4611). */
|
|
270
|
+
export function teamsMessage(e: NotifyEvent, relay?: RelayButtons): Record<string, unknown> {
|
|
271
|
+
const all = [...facts(e), ...(relay ? [{ title: "Approve in chat", value: `mention the relay and reply: approve ${relay.token}` }] : [])];
|
|
202
272
|
const actions = [
|
|
203
273
|
...(e.approve?.review ? [{ type: "Action.OpenUrl", title: "Review and approve", url: e.approve.review.url }] : []),
|
|
204
274
|
...(e.run?.url ? [{ type: "Action.OpenUrl", title: "Open the run", url: e.run.url }] : []),
|
|
@@ -236,22 +306,28 @@ export interface NotifyConfig {
|
|
|
236
306
|
teams?: string;
|
|
237
307
|
/** The events to send. Default: all of them. */
|
|
238
308
|
events?: NotifyEventKind[];
|
|
309
|
+
/**
|
|
310
|
+
* The variable holding the key `chant notify relay` checks buttons with
|
|
311
|
+
* (#4611). Set, a waiting event's Slack message carries Approve and
|
|
312
|
+
* Decline buttons, and its Teams card the reply that approves.
|
|
313
|
+
*/
|
|
314
|
+
relay?: string;
|
|
239
315
|
}
|
|
240
316
|
|
|
241
317
|
const VARIABLE = /^[A-Za-z_][A-Za-z0-9_]*$/;
|
|
242
|
-
const SETTINGS = ["webhook", "key", "slack", "teams", "events"];
|
|
318
|
+
const SETTINGS = ["webhook", "key", "slack", "teams", "events", "relay"];
|
|
243
319
|
|
|
244
320
|
/** The first problem with a {@link NotifyConfig}, or undefined. `where` prefixes the message. */
|
|
245
321
|
export function notifyConfigProblem(value: unknown, where = "notify"): string | undefined {
|
|
246
322
|
if (typeof value !== "object" || value === null || Array.isArray(value)) return `${where}: expected { webhook, key, slack, teams, events }`;
|
|
247
323
|
const v = value as Record<string, unknown>;
|
|
248
324
|
for (const k of Object.keys(v)) if (!SETTINGS.includes(k)) return `${where}.${k}: unknown setting (expected ${SETTINGS.join(", ")})`;
|
|
249
|
-
for (const k of ["webhook", "key", "slack", "teams"] as const) {
|
|
325
|
+
for (const k of ["webhook", "key", "slack", "teams", "relay"] as const) {
|
|
250
326
|
const n = v[k];
|
|
251
327
|
if (n === undefined) continue;
|
|
252
328
|
if (typeof n !== "string" || !VARIABLE.test(n)) {
|
|
253
|
-
const what = k === "key" ? "signing key" : "URL";
|
|
254
|
-
return `${where}.${k}: the name of the environment variable that holds the ${what}, never the ${k === "key" ? "key" : "URL"} itself`;
|
|
329
|
+
const what = k === "key" ? "signing key" : k === "relay" ? "relay key" : "URL";
|
|
330
|
+
return `${where}.${k}: the name of the environment variable that holds the ${what}, never the ${k === "key" || k === "relay" ? "key" : "URL"} itself`;
|
|
255
331
|
}
|
|
256
332
|
}
|
|
257
333
|
if (v.webhook !== undefined && v.key === undefined) return `${where}.key: a webhook needs a signing key; name the variable that holds it`;
|
|
@@ -266,7 +342,7 @@ export function notifyConfigProblem(value: unknown, where = "notify"): string |
|
|
|
266
342
|
/** The environment variables a configuration names, for a pipeline to map its secrets into. */
|
|
267
343
|
export function notifyVariables(config: NotifyConfig | undefined): string[] {
|
|
268
344
|
if (!config) return [];
|
|
269
|
-
return [config.webhook, config.key, config.slack, config.teams].filter((n): n is string => typeof n === "string" && n !== "");
|
|
345
|
+
return [config.webhook, config.key, config.slack, config.teams, config.relay].filter((n): n is string => typeof n === "string" && n !== "");
|
|
270
346
|
}
|
|
271
347
|
|
|
272
348
|
/** The request {@link sendNotify} posts to the webhook: the event as JSON, signed with `key` over `<timestamp>.<body>`. */
|
|
@@ -392,7 +468,12 @@ export async function sendNotify(config: NotifyConfig | undefined, event: Notify
|
|
|
392
468
|
return webhookRequest(event, key, { ...(options.now !== undefined ? { now: options.now } : {}), ...(options.prefix ? { prefix: options.prefix } : {}), ...(options.userAgent ? { userAgent: options.userAgent } : {}) });
|
|
393
469
|
});
|
|
394
470
|
}
|
|
395
|
-
|
|
396
|
-
|
|
471
|
+
// #4611: a waiting event's buttons, when the relay's key is set.
|
|
472
|
+
const ref = relayRefOf(event);
|
|
473
|
+
const relayKey = config.relay ? env[config.relay] : undefined;
|
|
474
|
+
if (config.relay && ref && !relayKey) log(`notify: ${config.relay} is not set, so the message carries no relay buttons`);
|
|
475
|
+
const buttons = ref && relayKey ? { token: relayToken(relayKey, ref) } : undefined;
|
|
476
|
+
if (config.slack) await deliver("slack", config.slack, () => json(options.render?.slack ? options.render.slack(event) : slackMessage(event, buttons)));
|
|
477
|
+
if (config.teams) await deliver("teams", config.teams, () => json(options.render?.teams ? options.render.teams(event) : teamsMessage(event, buttons)));
|
|
397
478
|
return out;
|
|
398
479
|
}
|