@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/pr-loop.ts
CHANGED
|
@@ -47,11 +47,14 @@
|
|
|
47
47
|
* `identity.gates` entry covers every member.
|
|
48
48
|
*/
|
|
49
49
|
|
|
50
|
-
import
|
|
50
|
+
import { NEXT_RELEASE } from "./release-floors";
|
|
51
|
+
import type { ChangeSetAction, ChangeSetDocument, ChangeSetEntry } from "./change-set";
|
|
52
|
+
import { parsePulumiUrn, pulumiMayAppearParent } from "./pulumi-urn";
|
|
51
53
|
import type { PrRequireOutcome } from "./pr-requires";
|
|
52
54
|
import { renderMigrationLines, type PrMigrationFile } from "./pr-migrations";
|
|
53
55
|
import { GITHUB_COMMENT_LIMIT, groupChangeSet, renderPlanSummaryMarkdown } from "./plan-summary";
|
|
54
|
-
import {
|
|
56
|
+
import { activeProductWords, approveLine, commentLine, isChantWords, overrideLine, productStatusContext, type CiProductWords } from "./ci-product-words";
|
|
57
|
+
import type { CrossStackEdge } from "./control/edges";
|
|
55
58
|
|
|
56
59
|
/** The schema a pull-request report names in `$schema`. */
|
|
57
60
|
export const PR_REPORT_SCHEMA_ID = "https://intentius.io/chant/schemas/workspace/pr-report/v1/pr-report.schema.json";
|
|
@@ -93,10 +96,19 @@ export const PR_REPORT_MIGRATIONS_FLOOR = "0.124.49";
|
|
|
93
96
|
export const PR_REPORT_READS_FLOOR = "0.124.52";
|
|
94
97
|
|
|
95
98
|
/** The first chant whose report can carry the `not-started` member status (ws-107, #4440). */
|
|
96
|
-
export const PR_REPORT_NOT_STARTED_FLOOR =
|
|
99
|
+
export const PR_REPORT_NOT_STARTED_FLOOR = "0.124.54";
|
|
97
100
|
|
|
98
101
|
/** The first chant whose report can carry `groups`, `fallbacks`, and a member's `group` and `groupOutcome` (ws-107, #4446). */
|
|
99
|
-
export const PR_REPORT_GROUPS_FLOOR =
|
|
102
|
+
export const PR_REPORT_GROUPS_FLOOR = "0.124.54";
|
|
103
|
+
|
|
104
|
+
/** The first chant whose report can carry `lockTargets` (#4552). */
|
|
105
|
+
export const PR_REPORT_LOCK_TARGETS_FLOOR = "0.124.55";
|
|
106
|
+
|
|
107
|
+
/** The first chant whose report carries {@link PrReport.narrowed} (#4626). */
|
|
108
|
+
export const PR_REPORT_NARROWED_FLOOR = NEXT_RELEASE;
|
|
109
|
+
|
|
110
|
+
/** The first chant whose report carries {@link PrReport.crossStackEdges} (#4617). */
|
|
111
|
+
export const PR_REPORT_CROSS_STACK_FLOOR = "0.124.55";
|
|
100
112
|
|
|
101
113
|
/** The gate a pull request's apply waits on, unless the pipeline names another. */
|
|
102
114
|
export const PR_APPLY_GATE = "pr-apply";
|
|
@@ -133,8 +145,13 @@ export const PR_STATUS_CONTEXTS = { plan: "chant/plan", apply: "chant/apply", re
|
|
|
133
145
|
/** A pull-request loop stage: plan on the pull request, then record (#4168) or, opted in, apply on merge. */
|
|
134
146
|
export type PrStage = keyof typeof PR_STATUS_CONTEXTS;
|
|
135
147
|
|
|
136
|
-
/**
|
|
137
|
-
|
|
148
|
+
/**
|
|
149
|
+
* A stage's status context: `chant/plan`, or `chant/plan/<member>` for a
|
|
150
|
+
* workspace member's pipeline. Under a product's words (#4550) the prefix and
|
|
151
|
+
* the stage word are the product's: `plywood/preview/shop-dev`.
|
|
152
|
+
*/
|
|
153
|
+
export function prStatusContext(stage: PrStage, member?: string, words: CiProductWords = activeProductWords()): string {
|
|
154
|
+
if (!isChantWords(words)) return productStatusContext(words, stage, member);
|
|
138
155
|
return member ? `${PR_STATUS_CONTEXTS[stage]}/${member}` : PR_STATUS_CONTEXTS[stage];
|
|
139
156
|
}
|
|
140
157
|
|
|
@@ -279,9 +296,13 @@ export interface PrRound {
|
|
|
279
296
|
/** The components planned again, in apply order. */
|
|
280
297
|
components: string[];
|
|
281
298
|
approval: PrApproval;
|
|
282
|
-
/**
|
|
283
|
-
|
|
284
|
-
|
|
299
|
+
/**
|
|
300
|
+
* `waiting`: no approval stands for `digest`. `plan-failed`: a member failed
|
|
301
|
+
* to plan, so the round did not apply. `held`: another run holds a row the
|
|
302
|
+
* round changes (#4594), so it did not apply; `message` names that run.
|
|
303
|
+
*/
|
|
304
|
+
status: "applied" | "failed" | "waiting" | "plan-failed" | "held";
|
|
305
|
+
/** With `waiting`: why an approval that stands does not count (`--require-review`). With `held`: the run holding the rows. */
|
|
285
306
|
message?: string;
|
|
286
307
|
/**
|
|
287
308
|
* The first approval covered this round's plan (#4419): no gate of its own was
|
|
@@ -436,6 +457,8 @@ export interface PrPolicyReport {
|
|
|
436
457
|
override?: { by: string; at: string; reason: string; digest: string };
|
|
437
458
|
/** While denied: the command that overrides the denial. */
|
|
438
459
|
overrideCommand?: string;
|
|
460
|
+
/** `ci.policy.source` as fetched (#4613): the shared repository, its ref, the commit read and the Rego directory. */
|
|
461
|
+
source?: { repo: string; ref: string; commit: string; path: string };
|
|
439
462
|
}
|
|
440
463
|
|
|
441
464
|
/**
|
|
@@ -538,6 +561,20 @@ export interface PrReport {
|
|
|
538
561
|
groups?: PrGroup[];
|
|
539
562
|
/** The components that could have grouped and did not, with why (#4446), sorted. Absent when none. Since {@link PR_REPORT_GROUPS_FLOOR}. */
|
|
540
563
|
fallbacks?: PrGroupFallback[];
|
|
564
|
+
/**
|
|
565
|
+
* A section per member that its lexicon rendered from its own part of the
|
|
566
|
+
* change set (#4573), placed under the member table: rows a resource table
|
|
567
|
+
* does not carry, such as a SQL member's statements and their class. Absent
|
|
568
|
+
* when no lexicon rendered one. Added within contract 1 by the chant that
|
|
569
|
+
* carries `CI_PRODUCT_FLOOR` (`@intentius/chant/ci-product`).
|
|
570
|
+
*/
|
|
571
|
+
details?: PrMemberDetail[];
|
|
572
|
+
/**
|
|
573
|
+
* The policy findings capabilities' plans carried (#4550), one entry per
|
|
574
|
+
* member with any. Absent when none did. Added within contract 1 by the
|
|
575
|
+
* chant that carries `CI_PRODUCT_FLOOR`.
|
|
576
|
+
*/
|
|
577
|
+
capabilityPolicy?: PrCapabilityPolicy[];
|
|
541
578
|
/** Component names: which changed, which run because they depend on one, and what the change touched that no component deploys. */
|
|
542
579
|
selection: {
|
|
543
580
|
changed: string[];
|
|
@@ -549,6 +586,33 @@ export interface PrReport {
|
|
|
549
586
|
};
|
|
550
587
|
members: PrMember[];
|
|
551
588
|
changeSet: ChangeSetDocument;
|
|
589
|
+
/**
|
|
590
|
+
* The names the pull request's target locks take under `ci.locks` (#4552,
|
|
591
|
+
* ruling D), sorted, when any member is on the resource lock grain: each
|
|
592
|
+
* such member's row keys, and the component name of every component with
|
|
593
|
+
* a member on another grain. `chant lock --from-report` locks these in
|
|
594
|
+
* place of `selection.waves`. Absent when no member is on the resource
|
|
595
|
+
* grain. Added within contract 1 by chant
|
|
596
|
+
* {@link PR_REPORT_LOCK_TARGETS_FLOOR}.
|
|
597
|
+
*/
|
|
598
|
+
lockTargets?: string[];
|
|
599
|
+
/**
|
|
600
|
+
* Plan stage (#4626): the addresses each component's plan was narrowed to
|
|
601
|
+
* with `pr-plan --target`, from the command line or the comment, by
|
|
602
|
+
* component. The note and the status say so. Absent when nothing was
|
|
603
|
+
* narrowed. Added within contract 1 by chant {@link PR_REPORT_NARROWED_FLOOR}.
|
|
604
|
+
*/
|
|
605
|
+
narrowed?: Record<string, string[]>;
|
|
606
|
+
/**
|
|
607
|
+
* The stacks outside the workspace a member reads (#4617, a Pulumi
|
|
608
|
+
* `StackReference` no step here applies, #4547), each marked stale,
|
|
609
|
+
* current or unknown from the control repo's entries and apply records
|
|
610
|
+
* (`./control/edges.ts`). The plan job marks every one unknown, since it
|
|
611
|
+
* reads no control repo; the job that posts the note marks them again
|
|
612
|
+
* from a checkout of it. Absent when no member reads one. Added within
|
|
613
|
+
* contract 1 by chant {@link PR_REPORT_CROSS_STACK_FLOOR}.
|
|
614
|
+
*/
|
|
615
|
+
crossStackEdges?: CrossStackEdge[];
|
|
552
616
|
/**
|
|
553
617
|
* The stage hooks the job ran (#4288), in order. Absent when it ran none.
|
|
554
618
|
* Added within contract 1 by chant {@link PR_REPORT_HOOKS_FLOOR}.
|
|
@@ -568,6 +632,29 @@ export interface PrReport {
|
|
|
568
632
|
beforeMerge?: PrBeforeMerge;
|
|
569
633
|
}
|
|
570
634
|
|
|
635
|
+
/**
|
|
636
|
+
* A policy engine's findings a capability's plan carried for one member
|
|
637
|
+
* (#4550, from chant#4541's `pulumi-up`: CrossGuard in the preview job).
|
|
638
|
+
* `denied`: the capability refused the plan (`policyDenied`), so the stage
|
|
639
|
+
* exits 7. Otherwise the findings are advisory and the note lists them.
|
|
640
|
+
*/
|
|
641
|
+
export interface PrCapabilityPolicy {
|
|
642
|
+
member: string;
|
|
643
|
+
denied: boolean;
|
|
644
|
+
denials: Array<{ rule: string; message: string }>;
|
|
645
|
+
holds: Array<{ rule: string; message: string }>;
|
|
646
|
+
warnings: string[];
|
|
647
|
+
}
|
|
648
|
+
|
|
649
|
+
/** One member's detail section (#4573): markdown lines its lexicon rendered. */
|
|
650
|
+
export interface PrMemberDetail {
|
|
651
|
+
member: string;
|
|
652
|
+
/** The section's summary line. Default: the member's name. */
|
|
653
|
+
title?: string;
|
|
654
|
+
/** Markdown lines. A table, a list, or both; chant adds nothing inside. */
|
|
655
|
+
lines: string[];
|
|
656
|
+
}
|
|
657
|
+
|
|
571
658
|
/** The counts a member's entries add up to. */
|
|
572
659
|
export function memberCounts(doc: Pick<ChangeSetDocument, "summary">, member: string): PrMemberCounts {
|
|
573
660
|
const by = doc.summary.byMember[member] ?? {};
|
|
@@ -586,51 +673,90 @@ export function memberHoleReasons(report: Pick<PrReport, "changeSet">, member: s
|
|
|
586
673
|
return [...new Set((m?.holes ?? []).map((h) => h.reason))];
|
|
587
674
|
}
|
|
588
675
|
|
|
589
|
-
/**
|
|
590
|
-
|
|
676
|
+
/**
|
|
677
|
+
* The approve command a reviewer runs for this report's digest: the product's
|
|
678
|
+
* approve line under its words (#4550). `target` fills the template's
|
|
679
|
+
* `{target}` (#4601): the member the line approves, such as sql-yodeler's
|
|
680
|
+
* environment.
|
|
681
|
+
*/
|
|
682
|
+
export function prApproveCommand(report: Pick<PrReport, "op" | "gate" | "digest"> & { target?: string }, approver = "<you>", words: CiProductWords = activeProductWords()): string {
|
|
683
|
+
if (!isChantWords(words)) return approveLine(words, { op: report.op, gate: report.gate, digest: report.digest, approver, sign: true, ...(report.target !== undefined ? { target: report.target } : {}) });
|
|
591
684
|
return `chant approve ${report.op} ${report.gate} --plan ${report.digest} --approver ${approver} --sign`;
|
|
592
685
|
}
|
|
593
686
|
|
|
687
|
+
/**
|
|
688
|
+
* The targets the product's approve line names (#4601), one line each: none
|
|
689
|
+
* when its template has no `{target}`; else the workspace member the report
|
|
690
|
+
* is for, else each member in the report, else the environment.
|
|
691
|
+
*/
|
|
692
|
+
export function prApproveTargets(report: Pick<PrReport, "env"> & Partial<Pick<PrReport, "member" | "members">>, words: CiProductWords = activeProductWords()): string[] {
|
|
693
|
+
if (!words.approve.includes("{target}")) return [];
|
|
694
|
+
if (report.member) return [report.member];
|
|
695
|
+
const names = [...new Set((report.members ?? []).map((m) => m.member))];
|
|
696
|
+
return names.length > 0 ? names : [report.env];
|
|
697
|
+
}
|
|
698
|
+
|
|
699
|
+
/** Every approve command the report asks for: one per {@link prApproveTargets}, or the one line when the template names no target. */
|
|
700
|
+
export function prApproveCommands(
|
|
701
|
+
report: Pick<PrReport, "op" | "gate" | "digest" | "env"> & Partial<Pick<PrReport, "member" | "members">>,
|
|
702
|
+
approver = "<you>",
|
|
703
|
+
words: CiProductWords = activeProductWords(),
|
|
704
|
+
): string[] {
|
|
705
|
+
const targets = prApproveTargets(report, words);
|
|
706
|
+
if (targets.length === 0) return [prApproveCommand(report, approver, words)];
|
|
707
|
+
return targets.map((target) => prApproveCommand({ op: report.op, gate: report.gate, digest: report.digest, target }, approver, words));
|
|
708
|
+
}
|
|
709
|
+
|
|
594
710
|
/**
|
|
595
711
|
* The refusal when the approved digest is not the planned one: both digests,
|
|
596
712
|
* that nothing applied, and how to close it.
|
|
597
713
|
*/
|
|
598
|
-
export function describePlanChanged(report: Pick<PrReport, "op" | "gate" | "digest" | "approval">): string {
|
|
714
|
+
export function describePlanChanged(report: Pick<PrReport, "op" | "gate" | "digest" | "approval"> & Partial<Pick<PrReport, "env" | "member" | "members">>): string {
|
|
715
|
+
const approve = report.env !== undefined ? prApproveCommands({ ...report, env: report.env }).join("; ") : prApproveCommand(report);
|
|
599
716
|
return (
|
|
600
717
|
`The plan changed after review, so nothing was applied. ` +
|
|
601
718
|
`approved: ${report.approval.approved ?? "(none)"}; planned now: ${report.digest}. ` +
|
|
602
|
-
`Read the new plan, and if it is right, approve it: ${
|
|
719
|
+
`Read the new plan, and if it is right, approve it: ${approve}; then run the apply again.`
|
|
603
720
|
);
|
|
604
721
|
}
|
|
605
722
|
|
|
606
723
|
const short = (sha: string): string => sha.slice(0, 12);
|
|
607
724
|
const code = (s: string): string => "`" + s.replaceAll("`", "'") + "`";
|
|
608
725
|
|
|
609
|
-
|
|
610
|
-
|
|
611
|
-
|
|
612
|
-
applied
|
|
613
|
-
|
|
614
|
-
|
|
615
|
-
|
|
616
|
-
|
|
617
|
-
}
|
|
726
|
+
/** A member's status in the note, in the product's verbs (#4550): chant's `planned`, plywood's `previewed`. */
|
|
727
|
+
function statusWords(words: CiProductWords): Record<PrMemberStatus, string> {
|
|
728
|
+
const [plan, planned] = words.verbs.plan;
|
|
729
|
+
const [apply, applied] = words.verbs.apply;
|
|
730
|
+
return {
|
|
731
|
+
planned,
|
|
732
|
+
"plan-failed": `${plan} failed`,
|
|
733
|
+
applied,
|
|
734
|
+
failed: `${apply} failed`,
|
|
735
|
+
blocked: "blocked",
|
|
736
|
+
waiting: "waiting on its new plan",
|
|
737
|
+
"not-started": "not started",
|
|
738
|
+
};
|
|
739
|
+
}
|
|
618
740
|
|
|
619
|
-
|
|
741
|
+
const capital = (w: string): string => w.charAt(0).toUpperCase() + w.slice(1);
|
|
742
|
+
|
|
743
|
+
function headline(report: PrReport, words: CiProductWords): string {
|
|
620
744
|
const n = report.members.length;
|
|
621
|
-
const members = `${n}
|
|
745
|
+
const members = `${n} ${words.noun[n === 1 ? 0 : 1]}`;
|
|
746
|
+
const [plan, planned] = words.verbs.plan;
|
|
747
|
+
const applied = words.verbs.apply[1];
|
|
622
748
|
switch (report.status) {
|
|
623
749
|
case "nothing":
|
|
624
|
-
return
|
|
750
|
+
return `Nothing to ${plan}: no component deploys what this change touches.`;
|
|
625
751
|
case "planned":
|
|
626
|
-
return
|
|
752
|
+
return `${capital(planned)} ${members}.`;
|
|
627
753
|
case "recorded":
|
|
628
754
|
return `Recorded the plan of ${members} on merge. Nothing applied: a release that carries this commit deploys it.`;
|
|
629
755
|
case "plan-failed":
|
|
630
756
|
if (report.hooks?.some((h) => h.outcome === "failed")) return "A hook failed, so nothing can apply.";
|
|
631
|
-
return
|
|
757
|
+
return `${isChantWords(words) ? "Planning" : `The ${plan}`} failed for ${report.members.filter((m) => m.status === "plan-failed").length} of ${members}, so nothing can apply.`;
|
|
632
758
|
case "applied":
|
|
633
|
-
return
|
|
759
|
+
return `${capital(applied)} ${members}.`;
|
|
634
760
|
case "failed": {
|
|
635
761
|
const blocked = report.members.filter((m) => m.status === "blocked").length;
|
|
636
762
|
const notStarted = report.members.filter((m) => m.status === "not-started").length;
|
|
@@ -639,14 +765,14 @@ function headline(report: PrReport): string {
|
|
|
639
765
|
case "wave-applied": {
|
|
640
766
|
const applied = (report.waves ?? []).filter((w) => w.status === "applied").map((w) => w.wave);
|
|
641
767
|
const total = report.selection.waves.length;
|
|
642
|
-
return
|
|
768
|
+
return `${capital(words.verbs.apply[1])} wave ${applied.at(-1) ?? "?"} of ${total}. The next wave runs in its own job.`;
|
|
643
769
|
}
|
|
644
770
|
case "refused": {
|
|
645
771
|
const waiting = report.waves?.find((w) => w.status === "waiting");
|
|
646
772
|
return waiting ? `Wave ${waiting.wave} waits at its gate ${code(waiting.gate)}; nothing in it applied.` : "The apply refused.";
|
|
647
773
|
}
|
|
648
774
|
case "waiting":
|
|
649
|
-
return
|
|
775
|
+
return `${capital(applied)} ${report.members.filter((m) => m.status === "applied").length} of ${members}; ${report.members.filter((m) => m.status === "waiting").length} wait on an approval of the plan made after their upstream applied.`;
|
|
650
776
|
}
|
|
651
777
|
}
|
|
652
778
|
|
|
@@ -655,6 +781,27 @@ function headline(report: PrReport): string {
|
|
|
655
781
|
* component that failed, and that the rest went on. Undefined when nothing
|
|
656
782
|
* is blocked.
|
|
657
783
|
*/
|
|
784
|
+
/**
|
|
785
|
+
* The cross-stack edges (#4617): a table of each stack outside the
|
|
786
|
+
* workspace a member reads, its owner and its mark, and a line naming the
|
|
787
|
+
* stale ones, whose reader holds outputs that may have changed since.
|
|
788
|
+
*/
|
|
789
|
+
function crossStackLines(report: Pick<PrReport, "crossStackEdges">): string[] {
|
|
790
|
+
const edges = report.crossStackEdges ?? [];
|
|
791
|
+
if (edges.length === 0) return [];
|
|
792
|
+
const day = (iso?: string): string => (iso ? iso.replace(/\.\d+Z$/, "Z") : "never");
|
|
793
|
+
const out = ["", "| Reader | Reads stack | Owner | Edge | Why |", "|---|---|---|---|---|"];
|
|
794
|
+
for (const e of edges) {
|
|
795
|
+
const why = e.ownerApplied ? `${e.why} (owner applied ${day(e.ownerApplied.at)} at ${code(e.ownerApplied.sha.slice(0, 12))}, reader updated ${day(e.lastUpdate)})` : e.why;
|
|
796
|
+
out.push(`| ${code(e.member)} | ${code(e.stack)} | ${e.owner ? code(e.owner) : "?"} | ${e.status} | ${why} |`);
|
|
797
|
+
}
|
|
798
|
+
const stale = edges.filter((e) => e.status === "stale");
|
|
799
|
+
if (stale.length > 0) {
|
|
800
|
+
out.push("", `Stale: ${stale.map((e) => `${code(e.member)} reads ${code(e.stack)}`).join("; ")}. The owner applied since the reader last updated, so this plan reads its outputs as they are now and the reader's last update read older ones.`);
|
|
801
|
+
}
|
|
802
|
+
return out;
|
|
803
|
+
}
|
|
804
|
+
|
|
658
805
|
function blockedLine(members: readonly PrMember[]): string | undefined {
|
|
659
806
|
const byRoot = new Map<string, Set<string>>();
|
|
660
807
|
for (const m of members) {
|
|
@@ -731,6 +878,31 @@ function policyLines(report: PrReport): string[] {
|
|
|
731
878
|
return out;
|
|
732
879
|
}
|
|
733
880
|
|
|
881
|
+
/**
|
|
882
|
+
* The findings capabilities' plans carried (#4550), in the product's words:
|
|
883
|
+
* a denial with the product's override line, then each advisory finding as
|
|
884
|
+
* a row.
|
|
885
|
+
*/
|
|
886
|
+
function capabilityPolicyLines(report: PrReport, words: CiProductWords): string[] {
|
|
887
|
+
const all = report.capabilityPolicy ?? [];
|
|
888
|
+
if (all.length === 0) return [];
|
|
889
|
+
const out: string[] = [];
|
|
890
|
+
for (const p of all.filter((x) => x.denied)) {
|
|
891
|
+
out.push("", `The policy in ${code(p.member)}'s ${words.verbs.plan[0]} denied it, so nothing can apply:`, ...p.denials.map((d) => `- ${code(d.rule)}: ${d.message}`));
|
|
892
|
+
if (p.denials.length > 0) out.push("", `A person the overriders file at base lists may override it: ${code(overrideLine(words, { op: "policy-override", gate: report.gate, target: p.member, rules: p.denials.map((d) => d.rule) }))}`);
|
|
893
|
+
}
|
|
894
|
+
const rows = all.flatMap((p) => [
|
|
895
|
+
...(p.denied ? [] : p.denials).map((d) => [p.member, d.rule, "denied", d.message]),
|
|
896
|
+
...p.holds.map((d) => [p.member, d.rule, "advisory", d.message]),
|
|
897
|
+
...p.warnings.map((w) => [p.member, "", "warning", w]),
|
|
898
|
+
]);
|
|
899
|
+
if (rows.length > 0) {
|
|
900
|
+
out.push("", `| ${capital(words.noun[0])} | Rule | Finding | Message |`, "|---|---|---|---|");
|
|
901
|
+
for (const [m, rule, kind, message] of rows) out.push(`| ${code(m!)} | ${rule ? code(rule) : ""} | ${kind} | ${message!.replaceAll("|", "\\|").replaceAll("\n", " ")} |`);
|
|
902
|
+
}
|
|
903
|
+
return out;
|
|
904
|
+
}
|
|
905
|
+
|
|
734
906
|
/** Who a wave applied or waits under, as a table cell. */
|
|
735
907
|
function waveApproval(w: PrWave): string {
|
|
736
908
|
const whose = w.approval === "pull-request" ? "the pull request's" : "its own";
|
|
@@ -743,7 +915,7 @@ function waveApproval(w: PrWave): string {
|
|
|
743
915
|
* saying which approval it applied under, then for a wave that waits the
|
|
744
916
|
* reason its plan moved and the approve command for its new plan.
|
|
745
917
|
*/
|
|
746
|
-
function waveLines(report: PrReport, approver: string): string[] {
|
|
918
|
+
function waveLines(report: PrReport, approver: string, words: CiProductWords): string[] {
|
|
747
919
|
const waves = report.waves ?? [];
|
|
748
920
|
if (waves.length === 0) return [];
|
|
749
921
|
const out = ["", "| Wave | Components | Status | Approval |", "|---:|---|---|---|"];
|
|
@@ -757,7 +929,7 @@ function waveLines(report: PrReport, approver: string): string[] {
|
|
|
757
929
|
`Read wave ${w.wave}'s plan, ${code(w.digest)}, and approve it with:`,
|
|
758
930
|
"",
|
|
759
931
|
"```",
|
|
760
|
-
|
|
932
|
+
...waveApproveCommands(report, w, approver, words),
|
|
761
933
|
"```",
|
|
762
934
|
"",
|
|
763
935
|
"Then run the wave's apply job again.",
|
|
@@ -766,7 +938,38 @@ function waveLines(report: PrReport, approver: string): string[] {
|
|
|
766
938
|
return out;
|
|
767
939
|
}
|
|
768
940
|
|
|
769
|
-
|
|
941
|
+
/** A waiting wave's approve lines: one per component when the product's template names `{target}` (#4601). */
|
|
942
|
+
function waveApproveCommands(report: PrReport, w: PrWave, approver: string, words: CiProductWords): string[] {
|
|
943
|
+
const targets = words.approve.includes("{target}") ? (w.components.length > 0 ? w.components : [report.env]) : [];
|
|
944
|
+
if (targets.length === 0) return [prApproveCommand({ op: report.op, gate: w.gate, digest: w.digest }, approver, words)];
|
|
945
|
+
return targets.map((target) => prApproveCommand({ op: report.op, gate: w.gate, digest: w.digest, target }, approver, words));
|
|
946
|
+
}
|
|
947
|
+
|
|
948
|
+
/**
|
|
949
|
+
* The note's sentence on what the merge does with the plan (#4601), by the
|
|
950
|
+
* product's apply mode. chant's words keep chant's sentence, which covers
|
|
951
|
+
* the record on merge and the opt-in apply on merge alike.
|
|
952
|
+
*/
|
|
953
|
+
export function prMergeSentence(report: Pick<PrReport, "gate">, words: CiProductWords = activeProductWords()): string {
|
|
954
|
+
const applied = words.verbs.apply[1];
|
|
955
|
+
switch (words.applyMode) {
|
|
956
|
+
case "on-merge": {
|
|
957
|
+
if (words.approval === "per-wave") {
|
|
958
|
+
return `On merge the waves are ${applied} in order, each under an approval of its own gate for its own plan. A wave whose plan moved since this note waits at its gate for a new approval.`;
|
|
959
|
+
}
|
|
960
|
+
const waveGate = words.gateName.replace("{gate}", report.gate).replace("{k}", "<k>");
|
|
961
|
+
return `On merge the waves are ${applied} in order under this approval, each while its plan is one this approval covers. A wave whose plan moved waits at its own gate, ${code(waveGate)}, for an approval of its own.`;
|
|
962
|
+
}
|
|
963
|
+
case "before-merge": {
|
|
964
|
+
const comment = commentLine(words, "apply");
|
|
965
|
+
return `Before merge, ${comment ? code(comment) : "the apply job"} runs this plan once the pull request is approved, mergeable and green, and only while the plan is still this one; if it moved, the apply refuses and names both digests. The merge records what was ${applied}.`;
|
|
966
|
+
}
|
|
967
|
+
case "release":
|
|
968
|
+
return "On merge the plan is recorded, and a release deploys it. With apply on merge it applies if the plan is still this one; if it moved, the apply refuses and names both digests.";
|
|
969
|
+
}
|
|
970
|
+
}
|
|
971
|
+
|
|
972
|
+
function approvalLines(report: PrReport, approver: string, words: CiProductWords): string[] {
|
|
770
973
|
const a = report.approval;
|
|
771
974
|
if (report.status === "nothing") return [];
|
|
772
975
|
if (a.status === "approved") return [`Approved by ${(a.approvedBy ?? []).map(code).join(", ")} for this digest.`];
|
|
@@ -775,33 +978,129 @@ function approvalLines(report: PrReport, approver: string): string[] {
|
|
|
775
978
|
? [`An approval stands for ${code(a.approved ?? "(none)")}, not for this digest: the plan changed since it was approved.`]
|
|
776
979
|
: [report.stage === "record" ? "No approval stands for this plan. The release gate decides before it deploys." : "Not approved yet."];
|
|
777
980
|
if (report.stage === "plan" && report.status === "planned") {
|
|
981
|
+
const commands = prApproveCommands(report, approver, words);
|
|
778
982
|
lines.push(
|
|
779
983
|
"",
|
|
780
|
-
"A reviewer who approved this pull request approves the plan with:",
|
|
984
|
+
commands.length > 1 ? `A reviewer who approved this pull request approves each ${words.noun[0]}'s plan with:` : "A reviewer who approved this pull request approves the plan with:",
|
|
781
985
|
"",
|
|
782
986
|
"```",
|
|
783
|
-
|
|
987
|
+
...commands,
|
|
784
988
|
"```",
|
|
785
989
|
"",
|
|
786
|
-
|
|
990
|
+
prMergeSentence(report, words),
|
|
787
991
|
);
|
|
788
992
|
}
|
|
789
993
|
return lines;
|
|
790
994
|
}
|
|
791
995
|
|
|
996
|
+
/**
|
|
997
|
+
* One row of the note for a change-set entry the planner marked `mayAppear`
|
|
998
|
+
* (#4548): a resource a component registers inside an `apply()` that the
|
|
999
|
+
* preview could not run, so it is known only when the apply runs.
|
|
1000
|
+
*/
|
|
1001
|
+
export interface PrMayAppearRow {
|
|
1002
|
+
member: string;
|
|
1003
|
+
/**
|
|
1004
|
+
* The component resource that registers it, as `<type> <name>`. Only the
|
|
1005
|
+
* type when the entry names no single component (its URN carries the parent
|
|
1006
|
+
* type chain, not the parent's name), and `the stack` when it has none.
|
|
1007
|
+
*/
|
|
1008
|
+
component: string;
|
|
1009
|
+
/** The resource, as `<type> <name>`; absent on the entry that stands for whatever the component may register. */
|
|
1010
|
+
resource?: string;
|
|
1011
|
+
/** The entry's action: `create` for the stand-in entry, else what the plan says about a resource the last deployment holds. */
|
|
1012
|
+
action: ChangeSetAction;
|
|
1013
|
+
}
|
|
1014
|
+
|
|
1015
|
+
const typeAndName = (urn: string): string => {
|
|
1016
|
+
const p = parsePulumiUrn(urn);
|
|
1017
|
+
return p ? `${p.type} ${p.name}` : urn;
|
|
1018
|
+
};
|
|
1019
|
+
|
|
1020
|
+
/**
|
|
1021
|
+
* The note's rows for the `mayAppear` entries of a change set, sorted by
|
|
1022
|
+
* member and component. A stand-in entry (`pulumiMayAppearAddress`) names its
|
|
1023
|
+
* component from its own address. Any other entry names the component whose
|
|
1024
|
+
* stand-in entry in the same member sits on its parent type chain, when one
|
|
1025
|
+
* does; else the type of its parent.
|
|
1026
|
+
*/
|
|
1027
|
+
export function prMayAppearRows(doc: Pick<ChangeSetDocument, "entries">): PrMayAppearRow[] {
|
|
1028
|
+
const flagged = new Map<string, Array<{ urn: string; chain: string }>>();
|
|
1029
|
+
for (const e of doc.entries) {
|
|
1030
|
+
if (e.mayAppear !== true) continue;
|
|
1031
|
+
const parent = pulumiMayAppearParent(e.address);
|
|
1032
|
+
const parsed = parent ? parsePulumiUrn(parent) : undefined;
|
|
1033
|
+
if (!parent || !parsed) continue;
|
|
1034
|
+
flagged.set(e.member, [...(flagged.get(e.member) ?? []), { urn: parent, chain: parsed.qualifiedType }]);
|
|
1035
|
+
}
|
|
1036
|
+
const componentOf = (e: ChangeSetEntry): string => {
|
|
1037
|
+
const parsed = parsePulumiUrn(e.address);
|
|
1038
|
+
if (!parsed) return "the stack";
|
|
1039
|
+
const parents = parsed.parentTypes.join("$");
|
|
1040
|
+
const under = (flagged.get(e.member) ?? []).filter((c) => parents === c.chain || parents.startsWith(`${c.chain}$`));
|
|
1041
|
+
// The nearest component: the longest chain that holds the entry.
|
|
1042
|
+
const longest = Math.max(-1, ...under.map((c) => c.chain.length));
|
|
1043
|
+
const nearest = under.filter((c) => c.chain.length === longest);
|
|
1044
|
+
if (nearest.length === 1) return typeAndName(nearest[0].urn);
|
|
1045
|
+
return parsed.parentTypes.at(-1) ?? "the stack";
|
|
1046
|
+
};
|
|
1047
|
+
const rows: PrMayAppearRow[] = [];
|
|
1048
|
+
for (const e of doc.entries) {
|
|
1049
|
+
if (e.mayAppear !== true) continue;
|
|
1050
|
+
const parent = pulumiMayAppearParent(e.address);
|
|
1051
|
+
rows.push(parent ? { member: e.member, component: typeAndName(parent), action: e.action } : { member: e.member, component: componentOf(e), resource: typeAndName(e.address), action: e.action });
|
|
1052
|
+
}
|
|
1053
|
+
const key = (r: PrMayAppearRow) => `${r.member}\u0000${r.component}\u0000${r.resource === undefined ? "" : `\u0001${r.resource}`}`;
|
|
1054
|
+
return rows.sort((a, b) => (key(a) < key(b) ? -1 : key(a) > key(b) ? 1 : 0));
|
|
1055
|
+
}
|
|
1056
|
+
|
|
1057
|
+
/**
|
|
1058
|
+
* The words of one may-appear row's last cell. `apply` is the product's word
|
|
1059
|
+
* for the apply (a fixed slot, #4550): plywood's is `up`.
|
|
1060
|
+
*/
|
|
1061
|
+
export function prMayAppearText(row: PrMayAppearRow, apply = "apply"): string {
|
|
1062
|
+
if (row.resource === undefined) return `may register at ${apply}`;
|
|
1063
|
+
if (row.action === "delete") return `planned to delete, and may register again at ${apply}`;
|
|
1064
|
+
return `missing from the preview, and may register at ${apply}`;
|
|
1065
|
+
}
|
|
1066
|
+
|
|
1067
|
+
/**
|
|
1068
|
+
* The may-appear lines of the note (#4548): a row per `mayAppear` entry,
|
|
1069
|
+
* naming the component resource that registers it.
|
|
1070
|
+
*/
|
|
1071
|
+
function mayAppearLines(report: PrReport, apply: string): string[] {
|
|
1072
|
+
const rows = prMayAppearRows(report.changeSet);
|
|
1073
|
+
if (rows.length === 0) return [];
|
|
1074
|
+
const out = [
|
|
1075
|
+
"",
|
|
1076
|
+
`Registered inside an \`apply()\` the preview could not run, so known only at ${apply}:`,
|
|
1077
|
+
"",
|
|
1078
|
+
"| Member | Component resource | Resource | At " + apply + " |",
|
|
1079
|
+
"|---|---|---|---|",
|
|
1080
|
+
];
|
|
1081
|
+
for (const r of rows) out.push(`| ${code(r.member)} | ${code(r.component)} | ${r.resource === undefined ? "any resource it registers" : code(r.resource)} | ${prMayAppearText(r, apply)} |`);
|
|
1082
|
+
return out;
|
|
1083
|
+
}
|
|
1084
|
+
|
|
792
1085
|
/**
|
|
793
1086
|
* The pull-request note: the stage's headline, a row per member, the digest
|
|
794
1087
|
* and the approval, then the grouped plan summary (#3188) in whatever room
|
|
795
1088
|
* `limit` leaves. The note starts with {@link prNoteMarker}, so the same
|
|
796
|
-
* comment is updated by every push and by the apply.
|
|
1089
|
+
* comment is updated by every push and by the apply. `applyWord` is the
|
|
1090
|
+
* product's word for the apply in the may-appear rows (#4548), `apply` by
|
|
1091
|
+
* default.
|
|
797
1092
|
*/
|
|
798
|
-
export function renderPrNote(report: PrReport, options: { limit?: number; approver?: string } = {}): string {
|
|
1093
|
+
export function renderPrNote(report: PrReport, options: { limit?: number; approver?: string; applyWord?: string; words?: CiProductWords } = {}): string {
|
|
799
1094
|
const limit = options.limit ?? GITHUB_COMMENT_LIMIT;
|
|
1095
|
+
// #4550: the product's words in chant's sentences (ruling D: fixed slots).
|
|
1096
|
+
const words = options.words ?? activeProductWords();
|
|
1097
|
+
const STATUS_WORDS = statusWords(words);
|
|
1098
|
+
const noun = words.noun[0];
|
|
800
1099
|
const out: string[] = [
|
|
801
1100
|
prNoteMarker(report.env, report.member),
|
|
802
|
-
`###
|
|
1101
|
+
`### ${words.product} ${words.stages[report.stage]} for ${code(report.env)}${report.member ? ` in ${noun} ${code(report.member)}` : ""}`,
|
|
803
1102
|
"",
|
|
804
|
-
`${headline(report)} Head ${code(short(report.head))}, measured from ${code(short(report.base))}.`,
|
|
1103
|
+
`${headline(report, words)} Head ${code(short(report.head))}, measured from ${code(short(report.base))}.`,
|
|
805
1104
|
];
|
|
806
1105
|
if (report.message) out.push("", `> ${report.message.split("\n").join("\n> ")}`);
|
|
807
1106
|
for (const o of report.overdue ?? []) out.push("", `Warning: ${o.message}`);
|
|
@@ -809,7 +1108,7 @@ export function renderPrNote(report: PrReport, options: { limit?: number; approv
|
|
|
809
1108
|
out.push("", `Resumed under the same approval: ${report.resumed.applied.map(code).join(", ")} applied in an earlier attempt and did not run again.`);
|
|
810
1109
|
}
|
|
811
1110
|
if (report.members.length > 0) {
|
|
812
|
-
out.push("",
|
|
1111
|
+
out.push("", `| ${capital(noun)} | Component | Status | Create | Update | Replace | Delete |`, "|---|---|---|---:|---:|---:|---:|");
|
|
813
1112
|
for (const m of report.members) {
|
|
814
1113
|
const holes = memberHoleReasons(report, m.member);
|
|
815
1114
|
// #4463: a member planned with stand-in values says so, naming them.
|
|
@@ -820,6 +1119,8 @@ export function renderPrNote(report: PrReport, options: { limit?: number; approv
|
|
|
820
1119
|
(m.groupOutcome === "partial" ? ", applied in part" : m.groupOutcome === "no-changes" ? ", no changes" : "") +
|
|
821
1120
|
(m.inputsMoved?.length ? `, inputs from ${m.inputsMoved.join(", ")} moved` : "") +
|
|
822
1121
|
(placeholders.length > 0 ? `, previewed with placeholders for ${placeholders.map(code).join(", ")}` : "") +
|
|
1122
|
+
// #4626: a member whose plan was narrowed says to what.
|
|
1123
|
+
(report.narrowed?.[m.component] ? `, narrowed to ${report.narrowed[m.component]!.map(code).join(", ")}` : "") +
|
|
823
1124
|
(holes.length > 0 ? `; ${holes.length > 2 ? `${holes[0]}; and ${holes.length - 1} more, listed under Holes` : holes.join("; ")}` : "");
|
|
824
1125
|
// A member whose plan has holes and no entries says nothing about what
|
|
825
1126
|
// it changes, so its counts are unknown, not zero (#4084).
|
|
@@ -828,13 +1129,16 @@ export function renderPrNote(report: PrReport, options: { limit?: number; approv
|
|
|
828
1129
|
out.push(`| ${code(m.member)} | ${m.component} | ${status} | ${n("create")} | ${n("update")} | ${n("replace")} | ${n("delete")} |`);
|
|
829
1130
|
}
|
|
830
1131
|
if (report.members.some((m) => m.inputsMoved?.length)) {
|
|
831
|
-
out.push("",
|
|
1132
|
+
out.push("", `A ${noun} whose inputs moved ${words.verbs.apply[1]} the plan it was approved with. The next run plans it against the new values.`);
|
|
832
1133
|
}
|
|
833
1134
|
}
|
|
1135
|
+
out.push(...narrowedLines(report, words));
|
|
1136
|
+
out.push(...mayAppearLines(report, options.applyWord ?? words.stages.apply));
|
|
834
1137
|
const blocked = blockedLine(report.members);
|
|
835
1138
|
if (blocked) out.push("", blocked);
|
|
1139
|
+
out.push(...crossStackLines(report));
|
|
836
1140
|
out.push(...groupLines(report));
|
|
837
|
-
out.push(...waveLines(report, options.approver ?? "<you>"));
|
|
1141
|
+
out.push(...waveLines(report, options.approver ?? "<you>", words));
|
|
838
1142
|
// #4288: the hooks that did not pass, by name; a passed hook is a count.
|
|
839
1143
|
const hooks = report.hooks ?? [];
|
|
840
1144
|
if (hooks.length > 0) {
|
|
@@ -843,6 +1147,7 @@ export function renderPrNote(report: PrReport, options: { limit?: number; approv
|
|
|
843
1147
|
out.push("", `Hooks: ${passed} passed${other.length > 0 ? `; ${other.join("; ")}` : ""}.`);
|
|
844
1148
|
}
|
|
845
1149
|
out.push(...policyLines(report));
|
|
1150
|
+
out.push(...capabilityPolicyLines(report, words));
|
|
846
1151
|
out.push(...renderMigrationLines(report.migrations));
|
|
847
1152
|
if (report.selection.unclaimed.length > 0) {
|
|
848
1153
|
out.push("", `Changed, and deployed by no component: ${report.selection.unclaimed.map(code).join(", ")}.`);
|
|
@@ -883,28 +1188,67 @@ export function renderPrNote(report: PrReport, options: { limit?: number; approv
|
|
|
883
1188
|
if (r.notCovered) out.push("", `Round ${r.round}'s plan is not covered by the approval of ${code(report.digest)}: ${r.notCovered}.`);
|
|
884
1189
|
if (r.status === "waiting") {
|
|
885
1190
|
if (r.message) out.push("", `> ${r.message}`);
|
|
886
|
-
out.push("", `${what}. Not approved yet. Approve it, then run the apply again with the same \`--resume\` record:`, "", "```", prApproveCommand({ op: report.op, gate: r.gate, digest: r.digest }, options.approver ?? "<you>"), "```");
|
|
1191
|
+
out.push("", `${what}. Not approved yet. Approve it, then run the apply again with the same \`--resume\` record:`, "", "```", prApproveCommand({ op: report.op, gate: r.gate, digest: r.digest }, options.approver ?? "<you>", words), "```");
|
|
887
1192
|
} else {
|
|
888
1193
|
out.push("", `${what}: ${r.status === "applied" ? `applied, approved by ${(r.approval.approvedBy ?? []).map(code).join(", ")}` : r.status === "plan-failed" ? "a member failed to plan" : "the apply failed"}.`);
|
|
889
1194
|
}
|
|
890
1195
|
}
|
|
891
1196
|
if (report.status !== "nothing") {
|
|
892
|
-
out.push("", `Plan digest: ${code(report.digest)}`, "", ...approvalLines(report, options.approver ?? "<you>"));
|
|
1197
|
+
out.push("", `Plan digest: ${code(report.digest)}`, "", ...approvalLines(report, options.approver ?? "<you>", words));
|
|
893
1198
|
}
|
|
894
1199
|
// #4003: with a gate per wave, a later wave's plan on merge may differ from this one.
|
|
895
1200
|
if (report.stage === "plan" && report.status === "planned" && report.waveGate) {
|
|
896
|
-
out.push("", `On merge each wave after the first is planned again once the waves before it apply, and a wave whose plan moved stops at its own gate, ${code(
|
|
1201
|
+
out.push("", `On merge each wave after the first is planned again once the waves before it apply, and a wave whose plan moved stops at its own gate, ${code(words.gateName.replace("{gate}", report.waveGate).replace("{k}", "<k>"))}, for approval.`);
|
|
897
1202
|
}
|
|
898
|
-
|
|
1203
|
+
let head = out.join("\n") + "\n";
|
|
1204
|
+
// #4573: each member's lexicon-rendered section, kept within the comment limit with room left for the summary.
|
|
1205
|
+
head += memberDetailSections(report, limit - [...head].length - 400, noun);
|
|
899
1206
|
if (report.status === "nothing" || report.changeSet.members.length === 0) return head;
|
|
900
1207
|
const room = limit - [...head].length - 1;
|
|
901
1208
|
if (room < 400) return head;
|
|
902
1209
|
return head + "\n" + renderPlanSummaryMarkdown(groupChangeSet(report.changeSet), { limit: room, command: "chant change-set summary .chant/pr/change-set.json" });
|
|
903
1210
|
}
|
|
904
1211
|
|
|
1212
|
+
/**
|
|
1213
|
+
* The member detail sections (#4573), each in a `<details>` block under the
|
|
1214
|
+
* member it belongs to. A section that does not fit in `room` is left out
|
|
1215
|
+
* and named, so the note stays within the forge's comment limit.
|
|
1216
|
+
*/
|
|
1217
|
+
function memberDetailSections(report: PrReport, room: number, noun: string): string {
|
|
1218
|
+
const out: string[] = [];
|
|
1219
|
+
let used = 0;
|
|
1220
|
+
const left: string[] = [];
|
|
1221
|
+
for (const d of report.details ?? []) {
|
|
1222
|
+
if (d.lines.length === 0) continue;
|
|
1223
|
+
const block = ["", `<details><summary>${d.title ?? `${capital(noun)} ${code(d.member)}`}</summary>`, "", ...d.lines, "", "</details>"].join("\n");
|
|
1224
|
+
const size = [...block].length;
|
|
1225
|
+
if (used + size > room - 200) {
|
|
1226
|
+
left.push(d.member);
|
|
1227
|
+
continue;
|
|
1228
|
+
}
|
|
1229
|
+
used += size;
|
|
1230
|
+
out.push(block);
|
|
1231
|
+
}
|
|
1232
|
+
if (left.length > 0) out.push("", `Left out to keep this note within the comment limit: the detail of ${left.map(code).join(", ")}. The report artifact carries it.`);
|
|
1233
|
+
return out.length > 0 ? out.join("\n") + "\n" : "";
|
|
1234
|
+
}
|
|
1235
|
+
|
|
1236
|
+
/**
|
|
1237
|
+
* The note's line for a narrowed plan (#4626): which of the plan's
|
|
1238
|
+
* components were narrowed and to how many addresses, and that the plan on
|
|
1239
|
+
* merge is of each whole, in the product's words.
|
|
1240
|
+
*/
|
|
1241
|
+
function narrowedLines(report: PrReport, words: CiProductWords): string[] {
|
|
1242
|
+
const narrowed = Object.entries(report.narrowed ?? {}).filter(([, a]) => a.length > 0);
|
|
1243
|
+
if (narrowed.length === 0) return [];
|
|
1244
|
+
const each = narrowed.map(([c, a]) => `${code(c)} to ${a.map(code).join(", ")}`).join("; ");
|
|
1245
|
+
return ["", `This ${words.verbs.plan[0]} was narrowed with \`--target\`: ${each}. The approval binds the narrowed plan. On merge each ${words.noun[0]} is ${words.verbs.plan[1]} whole.`];
|
|
1246
|
+
}
|
|
1247
|
+
|
|
905
1248
|
/** A commit status's description, at most 140 characters (GitHub's limit). */
|
|
906
|
-
export function prStatusDescription(report: PrReport): string {
|
|
1249
|
+
export function prStatusDescription(report: PrReport, words: CiProductWords = activeProductWords()): string {
|
|
907
1250
|
const n = report.members.length;
|
|
1251
|
+
const many = (k: number): string => `${k} ${words.noun[k === 1 ? 0 : 1]}`;
|
|
908
1252
|
const sum = report.members.reduce(
|
|
909
1253
|
(acc, m) => ({ change: acc.change + m.counts.create + m.counts.update + m.counts.replace, destroy: acc.destroy + m.counts.delete + m.counts.replace }),
|
|
910
1254
|
{ change: 0, destroy: 0 },
|
|
@@ -917,17 +1261,19 @@ export function prStatusDescription(report: PrReport): string {
|
|
|
917
1261
|
break;
|
|
918
1262
|
case "planned": {
|
|
919
1263
|
const unknown = report.members.filter((m) => memberHoleReasons(report, m.member).length > 0).length;
|
|
920
|
-
|
|
1264
|
+
// #4626: a narrowed plan says so in its status.
|
|
1265
|
+
const narrowed = Object.values(report.narrowed ?? {}).filter((a) => a.length > 0).length;
|
|
1266
|
+
text = `${many(n)}${narrowed > 0 ? ` (${narrowed} narrowed with --target)` : ""}: ${sum.change} to change, ${sum.destroy} to destroy or replace${unknown > 0 ? `, ${unknown} with holes` : ""}${digest}`;
|
|
921
1267
|
break;
|
|
922
1268
|
}
|
|
923
1269
|
case "plan-failed":
|
|
924
|
-
text = `a
|
|
1270
|
+
text = `a ${words.noun[0]} failed to ${words.verbs.plan[0]}${digest}`;
|
|
925
1271
|
break;
|
|
926
1272
|
case "recorded":
|
|
927
|
-
text = `recorded ${n}
|
|
1273
|
+
text = `recorded ${many(n)}: ${report.approval.status === "approved" ? "the approved plan" : report.approval.status === "changed" ? "the plan differs from the approved one" : "no approval for this plan"}${digest}`;
|
|
928
1274
|
break;
|
|
929
1275
|
case "applied":
|
|
930
|
-
text =
|
|
1276
|
+
text = `${words.verbs.apply[1]} ${many(n)}${digest}`;
|
|
931
1277
|
break;
|
|
932
1278
|
case "wave-applied": {
|
|
933
1279
|
const last = (report.waves ?? []).filter((w) => w.status === "applied").at(-1);
|