@intentius/chant 0.124.54 → 0.124.56
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/__fixtures__/estate-ledger.d.ts +13 -0
- package/dist/__fixtures__/estate-ledger.d.ts.map +1 -0
- package/dist/__fixtures__/estate-ledger.js +67 -0
- package/dist/__fixtures__/oidc-emulator.d.ts +11 -1
- package/dist/__fixtures__/oidc-emulator.d.ts.map +1 -1
- package/dist/__fixtures__/oidc-emulator.js +26 -2
- package/dist/__fixtures__/product-words.d.ts +78 -0
- package/dist/__fixtures__/product-words.d.ts.map +1 -0
- package/dist/__fixtures__/product-words.js +43 -0
- package/dist/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
- package/dist/__golden__/wave-loop/op-by-apply-hold.json +20 -4
- package/dist/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
- package/dist/__golden__/wave-loop/op-by-apply-pass.json +10 -2
- package/dist/__golden__/wave-loop/op-by-apply-skip.json +10 -2
- package/dist/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
- package/dist/__golden__/wave-loop/op-discover-rest.json +44 -12
- package/dist/__golden__/wave-loop/op-discover-wide.json +12 -3
- package/dist/__golden__/wave-loop/op-held-on.json +28 -7
- package/dist/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
- package/dist/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
- package/dist/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
- package/dist/__golden__/wave-loop/op-hooks-held.json +26 -8
- package/dist/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
- package/dist/__golden__/wave-loop/op-hooks-pass.json +22 -6
- package/dist/__golden__/wave-loop/op-hooks-share.json +20 -7
- package/dist/__golden__/wave-loop/op-outcome-held.json +12 -3
- package/dist/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
- package/dist/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
- package/dist/__golden__/wave-loop/op-outcome-replan.json +16 -5
- package/dist/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
- package/dist/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
- package/dist/__golden__/wave-loop/op-overridden.json +28 -7
- package/dist/__golden__/wave-loop/op-per-run.json +20 -4
- package/dist/__golden__/wave-loop/op-point.json +18 -4
- package/dist/__golden__/wave-loop/op-pr-review.json +10 -2
- package/dist/__golden__/wave-loop/op-spend-change-only.json +10 -2
- package/dist/__golden__/wave-loop/op-spend.json +10 -2
- package/dist/__golden__/wave-loop/op-wave-commands.json +56 -13
- package/dist/__golden__/wave-loop/op-wide.json +20 -4
- package/dist/bucket-check/azure.d.ts +108 -0
- package/dist/bucket-check/azure.d.ts.map +1 -0
- package/dist/bucket-check/azure.js +258 -0
- package/dist/bucket-check/fixtures/azure.json +153 -0
- package/dist/bucket-check/fixtures/gcs.json +148 -0
- package/dist/bucket-check/fixtures/s3.json +277 -0
- package/dist/bucket-check/gcs.d.ts +77 -0
- package/dist/bucket-check/gcs.d.ts.map +1 -0
- package/dist/bucket-check/gcs.js +202 -0
- package/dist/bucket-check/index.d.ts +48 -0
- package/dist/bucket-check/index.d.ts.map +1 -0
- package/dist/bucket-check/index.js +44 -0
- package/dist/bucket-check/s3.d.ts +116 -0
- package/dist/bucket-check/s3.d.ts.map +1 -0
- package/dist/bucket-check/s3.js +362 -0
- package/dist/bucket-check/types.d.ts +66 -0
- package/dist/bucket-check/types.d.ts.map +1 -0
- package/dist/bucket-check/types.js +31 -0
- package/dist/bucket-check/wire.d.ts +27 -0
- package/dist/bucket-check/wire.d.ts.map +1 -0
- package/dist/bucket-check/wire.js +32 -0
- package/dist/bucket-check.d.ts +6 -0
- package/dist/bucket-check.d.ts.map +1 -0
- package/dist/bucket-check.js +5 -0
- package/dist/capabilities/templates.d.ts.map +1 -1
- package/dist/capabilities/templates.js +1 -2
- package/dist/change-set.d.ts.map +1 -1
- package/dist/change-set.js +2 -3
- package/dist/ci-agent.d.ts +381 -0
- package/dist/ci-agent.d.ts.map +1 -0
- package/dist/ci-agent.js +832 -0
- package/dist/ci-audit/attribution.d.ts +111 -0
- package/dist/ci-audit/attribution.d.ts.map +1 -0
- package/dist/ci-audit/attribution.js +194 -0
- package/dist/ci-audit/audit-log.d.ts +144 -0
- package/dist/ci-audit/audit-log.d.ts.map +1 -0
- package/dist/ci-audit/audit-log.js +149 -0
- package/dist/ci-audit/index.d.ts +12 -0
- package/dist/ci-audit/index.d.ts.map +1 -0
- package/dist/ci-audit/index.js +12 -0
- package/dist/ci-audit/unrecorded.d.ts +74 -0
- package/dist/ci-audit/unrecorded.d.ts.map +1 -0
- package/dist/ci-audit/unrecorded.js +95 -0
- package/dist/ci-audit.d.ts +3 -0
- package/dist/ci-audit.d.ts.map +1 -0
- package/dist/ci-audit.js +2 -0
- package/dist/ci-control.d.ts +42 -0
- package/dist/ci-control.d.ts.map +1 -0
- package/dist/ci-control.js +41 -0
- package/dist/ci-estate/delivery.d.ts +137 -0
- package/dist/ci-estate/delivery.d.ts.map +1 -0
- package/dist/ci-estate/delivery.js +311 -0
- package/dist/ci-estate/overdue.d.ts +34 -0
- package/dist/ci-estate/overdue.d.ts.map +1 -0
- package/dist/ci-estate/overdue.js +58 -0
- package/dist/ci-estate/page.d.ts +134 -0
- package/dist/ci-estate/page.d.ts.map +1 -0
- package/dist/ci-estate/page.js +233 -0
- package/dist/ci-estate/rows.d.ts +118 -0
- package/dist/ci-estate/rows.d.ts.map +1 -0
- package/dist/ci-estate/rows.js +126 -0
- package/dist/ci-estate.d.ts +92 -0
- package/dist/ci-estate.d.ts.map +1 -0
- package/dist/ci-estate.js +82 -0
- package/dist/ci-handover.d.ts +29 -5
- package/dist/ci-handover.d.ts.map +1 -1
- package/dist/ci-handover.js +50 -16
- package/dist/ci-identity.d.ts +82 -7
- package/dist/ci-identity.d.ts.map +1 -1
- package/dist/ci-identity.js +86 -15
- package/dist/ci-job-guard.d.ts +139 -0
- package/dist/ci-job-guard.d.ts.map +1 -0
- package/dist/ci-job-guard.js +287 -0
- package/dist/ci-jobs.d.ts +7 -0
- package/dist/ci-jobs.d.ts.map +1 -1
- package/dist/ci-jobs.js +7 -0
- package/dist/ci-product-words.d.ts +296 -0
- package/dist/ci-product-words.d.ts.map +1 -0
- package/dist/ci-product-words.js +407 -0
- package/dist/ci-product.d.ts +117 -0
- package/dist/ci-product.d.ts.map +1 -0
- package/dist/ci-product.js +113 -0
- package/dist/ci-respond-run.d.ts +73 -0
- package/dist/ci-respond-run.d.ts.map +1 -0
- package/dist/ci-respond-run.js +247 -0
- package/dist/ci-respond.d.ts +189 -0
- package/dist/ci-respond.d.ts.map +1 -0
- package/dist/ci-respond.js +285 -0
- package/dist/cli/commands/audit.d.ts +2 -2
- package/dist/cli/commands/audit.d.ts.map +1 -1
- package/dist/cli/commands/audit.js +3 -2
- package/dist/cli/commands/carve.js +2 -2
- package/dist/cli/commands/init.d.ts +2 -0
- package/dist/cli/commands/init.d.ts.map +1 -1
- package/dist/cli/commands/init.js +1 -1
- package/dist/cli/handlers/agent.d.ts +17 -0
- package/dist/cli/handlers/agent.d.ts.map +1 -0
- package/dist/cli/handlers/agent.js +114 -0
- package/dist/cli/handlers/approve-confirm.d.ts +84 -0
- package/dist/cli/handlers/approve-confirm.d.ts.map +1 -0
- package/dist/cli/handlers/approve-confirm.js +142 -0
- package/dist/cli/handlers/approve.d.ts.map +1 -1
- package/dist/cli/handlers/approve.js +19 -1
- package/dist/cli/handlers/audit-log.d.ts +12 -0
- package/dist/cli/handlers/audit-log.d.ts.map +1 -0
- package/dist/cli/handlers/audit-log.js +81 -0
- package/dist/cli/handlers/build.d.ts +7 -0
- package/dist/cli/handlers/build.d.ts.map +1 -1
- package/dist/cli/handlers/build.js +124 -1
- package/dist/cli/handlers/ci-check-job.d.ts +11 -0
- package/dist/cli/handlers/ci-check-job.d.ts.map +1 -0
- package/dist/cli/handlers/ci-check-job.js +27 -0
- package/dist/cli/handlers/ci-check.d.ts +3 -0
- package/dist/cli/handlers/ci-check.d.ts.map +1 -0
- package/dist/cli/handlers/ci-check.js +63 -0
- package/dist/cli/handlers/ci-forge-check.d.ts +3 -0
- package/dist/cli/handlers/ci-forge-check.d.ts.map +1 -0
- package/dist/cli/handlers/ci-forge-check.js +89 -0
- package/dist/cli/handlers/e2e-safe-run.d.ts +12 -0
- package/dist/cli/handlers/e2e-safe-run.d.ts.map +1 -0
- package/dist/cli/handlers/e2e-safe-run.js +23 -0
- package/dist/cli/handlers/fan-out.js +4 -0
- package/dist/cli/handlers/gate-pending.d.ts +11 -0
- package/dist/cli/handlers/gate-pending.d.ts.map +1 -0
- package/dist/cli/handlers/gate-pending.js +44 -0
- package/dist/cli/handlers/init.d.ts.map +1 -1
- package/dist/cli/handlers/init.js +1 -0
- package/dist/cli/handlers/ledger.js +1 -1
- package/dist/cli/handlers/lifecycle-drift.d.ts +6 -2
- package/dist/cli/handlers/lifecycle-drift.d.ts.map +1 -1
- package/dist/cli/handlers/lifecycle-drift.js +7 -2
- package/dist/cli/handlers/lock.d.ts.map +1 -1
- package/dist/cli/handlers/lock.js +64 -5
- package/dist/cli/handlers/notify-relay.d.ts +15 -0
- package/dist/cli/handlers/notify-relay.d.ts.map +1 -0
- package/dist/cli/handlers/notify-relay.js +130 -0
- package/dist/cli/handlers/pr-env.d.ts.map +1 -1
- package/dist/cli/handlers/pr-env.js +42 -11
- package/dist/cli/handlers/pr.d.ts +43 -3
- package/dist/cli/handlers/pr.d.ts.map +1 -1
- package/dist/cli/handlers/pr.js +908 -205
- package/dist/cli/handlers/promote.d.ts.map +1 -1
- package/dist/cli/handlers/promote.js +21 -2
- package/dist/cli/handlers/release.d.ts.map +1 -1
- package/dist/cli/handlers/release.js +3 -0
- package/dist/cli/handlers/run-wave.d.ts +8 -0
- package/dist/cli/handlers/run-wave.d.ts.map +1 -1
- package/dist/cli/handlers/run-wave.js +160 -2
- package/dist/cli/handlers/run.d.ts +6 -1
- package/dist/cli/handlers/run.d.ts.map +1 -1
- package/dist/cli/handlers/run.js +86 -1
- package/dist/cli/handlers/serve.d.ts.map +1 -1
- package/dist/cli/handlers/serve.js +10 -1
- package/dist/cli/main.d.ts +11 -1
- package/dist/cli/main.d.ts.map +1 -1
- package/dist/cli/main.js +178 -13
- package/dist/cli/mcp/ledger-tools.d.ts +36 -0
- package/dist/cli/mcp/ledger-tools.d.ts.map +1 -0
- package/dist/cli/mcp/ledger-tools.js +122 -0
- package/dist/cli/mcp/product-tools.d.ts +78 -0
- package/dist/cli/mcp/product-tools.d.ts.map +1 -0
- package/dist/cli/mcp/product-tools.js +93 -0
- package/dist/cli/mcp/read-only.d.ts +34 -0
- package/dist/cli/mcp/read-only.d.ts.map +1 -0
- package/dist/cli/mcp/read-only.js +61 -0
- package/dist/cli/mcp/report-tools.d.ts +48 -0
- package/dist/cli/mcp/report-tools.d.ts.map +1 -0
- package/dist/cli/mcp/report-tools.js +128 -0
- package/dist/cli/mcp/server.d.ts +28 -1
- package/dist/cli/mcp/server.d.ts.map +1 -1
- package/dist/cli/mcp/server.js +86 -15
- package/dist/cli/mcp-config.d.ts +9 -2
- package/dist/cli/mcp-config.d.ts.map +1 -1
- package/dist/cli/mcp-config.js +8 -3
- package/dist/cli/parse-args.d.ts.map +1 -1
- package/dist/cli/parse-args.js +164 -3
- package/dist/cli/registry.d.ts +73 -0
- package/dist/cli/registry.d.ts.map +1 -1
- package/dist/cloud-lister/sigv4.d.ts +42 -7
- package/dist/cloud-lister/sigv4.d.ts.map +1 -1
- package/dist/cloud-lister/sigv4.js +72 -22
- package/dist/components/adoption.d.ts +69 -0
- package/dist/components/adoption.d.ts.map +1 -0
- package/dist/components/adoption.js +92 -0
- package/dist/components/apply-lease.d.ts +19 -0
- package/dist/components/apply-lease.d.ts.map +1 -0
- package/dist/components/apply-lease.js +41 -0
- package/dist/components/capability.d.ts +159 -5
- package/dist/components/capability.d.ts.map +1 -1
- package/dist/components/capability.js +39 -6
- package/dist/components/check-hooks.d.ts +116 -0
- package/dist/components/check-hooks.d.ts.map +1 -0
- package/dist/components/check-hooks.js +192 -0
- package/dist/components/check-steps.d.ts +74 -0
- package/dist/components/check-steps.d.ts.map +1 -0
- package/dist/components/check-steps.js +102 -0
- package/dist/components/ci-services.d.ts +57 -0
- package/dist/components/ci-services.d.ts.map +1 -0
- package/dist/components/ci-services.js +60 -0
- package/dist/components/cli-support.d.ts +13 -0
- package/dist/components/cli-support.d.ts.map +1 -1
- package/dist/components/cli-support.js +10 -2
- package/dist/components/driver.d.ts +32 -3
- package/dist/components/driver.d.ts.map +1 -1
- package/dist/components/driver.js +59 -5
- package/dist/components/fan-out-run.d.ts +12 -0
- package/dist/components/fan-out-run.d.ts.map +1 -1
- package/dist/components/fan-out-run.js +56 -16
- package/dist/components/groups.d.ts.map +1 -1
- package/dist/components/groups.js +23 -5
- package/dist/components/pr-env-ledger.d.ts +32 -0
- package/dist/components/pr-env-ledger.d.ts.map +1 -0
- package/dist/components/pr-env-ledger.js +38 -0
- package/dist/components/pr-env-ports.d.ts +12 -0
- package/dist/components/pr-env-ports.d.ts.map +1 -1
- package/dist/components/pr-env-ports.js +13 -3
- package/dist/components/pr-env-run.d.ts +6 -0
- package/dist/components/pr-env-run.d.ts.map +1 -1
- package/dist/components/pr-env-run.js +3 -2
- package/dist/components/pr-environment.d.ts +32 -4
- package/dist/components/pr-environment.d.ts.map +1 -1
- package/dist/components/pr-environment.js +26 -8
- package/dist/components/pr-pipeline.d.ts +297 -5
- package/dist/components/pr-pipeline.d.ts.map +1 -1
- package/dist/components/pr-pipeline.js +329 -18
- package/dist/components/pr-policy.d.ts +26 -2
- package/dist/components/pr-policy.d.ts.map +1 -1
- package/dist/components/pr-policy.js +41 -7
- package/dist/components/pr-run.d.ts +71 -0
- package/dist/components/pr-run.d.ts.map +1 -1
- package/dist/components/pr-run.js +91 -7
- package/dist/components/pr-targets.d.ts +24 -0
- package/dist/components/pr-targets.d.ts.map +1 -0
- package/dist/components/pr-targets.js +48 -0
- package/dist/components/product-pipeline.d.ts +250 -0
- package/dist/components/product-pipeline.d.ts.map +1 -0
- package/dist/components/product-pipeline.js +212 -0
- package/dist/components/promote.d.ts +6 -0
- package/dist/components/promote.d.ts.map +1 -1
- package/dist/components/promote.js +4 -1
- package/dist/components/release-compile.d.ts +22 -1
- package/dist/components/release-compile.d.ts.map +1 -1
- package/dist/components/release-compile.js +85 -0
- package/dist/components/release-promote.d.ts +15 -1
- package/dist/components/release-promote.d.ts.map +1 -1
- package/dist/components/release-promote.js +67 -2
- package/dist/components/repo-lock.d.ts +27 -0
- package/dist/components/repo-lock.d.ts.map +1 -0
- package/dist/components/repo-lock.js +49 -0
- package/dist/components/row-lease.d.ts +84 -0
- package/dist/components/row-lease.d.ts.map +1 -0
- package/dist/components/row-lease.js +110 -0
- package/dist/components/wave-plan.d.ts +42 -0
- package/dist/components/wave-plan.d.ts.map +1 -1
- package/dist/components/wave-plan.js +72 -4
- package/dist/control/applied.d.ts +89 -0
- package/dist/control/applied.d.ts.map +1 -0
- package/dist/control/applied.js +175 -0
- package/dist/control/consumers.d.ts +78 -0
- package/dist/control/consumers.d.ts.map +1 -0
- package/dist/control/consumers.js +172 -0
- package/dist/control/dispatch.d.ts +334 -0
- package/dist/control/dispatch.d.ts.map +1 -0
- package/dist/control/dispatch.js +519 -0
- package/dist/control/edges.d.ts +75 -0
- package/dist/control/edges.d.ts.map +1 -0
- package/dist/control/edges.js +133 -0
- package/dist/control/reconcile.d.ts +120 -0
- package/dist/control/reconcile.d.ts.map +1 -0
- package/dist/control/reconcile.js +178 -0
- package/dist/control/records.d.ts +187 -0
- package/dist/control/records.d.ts.map +1 -0
- package/dist/control/records.js +307 -0
- package/dist/discovery/sandbox/bundle.d.ts.map +1 -1
- package/dist/discovery/sandbox/bundle.js +25 -1
- package/dist/e2e-harness/bucket.d.ts +21 -0
- package/dist/e2e-harness/bucket.d.ts.map +1 -0
- package/dist/e2e-harness/bucket.js +61 -0
- package/dist/e2e-harness/claim.d.ts +70 -0
- package/dist/e2e-harness/claim.d.ts.map +1 -0
- package/dist/e2e-harness/claim.js +98 -0
- package/dist/e2e-harness/driver.d.ts +64 -0
- package/dist/e2e-harness/driver.d.ts.map +1 -0
- package/dist/e2e-harness/driver.js +243 -0
- package/dist/e2e-harness/forgejo.d.ts +77 -0
- package/dist/e2e-harness/forgejo.d.ts.map +1 -0
- package/dist/e2e-harness/forgejo.js +205 -0
- package/dist/e2e-harness/git.d.ts +32 -0
- package/dist/e2e-harness/git.d.ts.map +1 -0
- package/dist/e2e-harness/git.js +67 -0
- package/dist/e2e-harness/index.d.ts +22 -0
- package/dist/e2e-harness/index.d.ts.map +1 -0
- package/dist/e2e-harness/index.js +48 -0
- package/dist/e2e-harness/jobs.d.ts +8 -0
- package/dist/e2e-harness/jobs.d.ts.map +1 -0
- package/dist/e2e-harness/jobs.js +34 -0
- package/dist/e2e-harness/pins.d.ts +45 -0
- package/dist/e2e-harness/pins.d.ts.map +1 -0
- package/dist/e2e-harness/pins.js +44 -0
- package/dist/e2e-harness/ports.d.ts +113 -0
- package/dist/e2e-harness/ports.d.ts.map +1 -0
- package/dist/e2e-harness/ports.js +4 -0
- package/dist/e2e-harness/reports.d.ts +45 -0
- package/dist/e2e-harness/reports.d.ts.map +1 -0
- package/dist/e2e-harness/reports.js +57 -0
- package/dist/e2e-harness/safe-run-cli.d.ts +17 -0
- package/dist/e2e-harness/safe-run-cli.d.ts.map +1 -0
- package/dist/e2e-harness/safe-run-cli.js +43 -0
- package/dist/e2e-harness/safe-run.d.ts +61 -0
- package/dist/e2e-harness/safe-run.d.ts.map +1 -0
- package/dist/e2e-harness/safe-run.js +172 -0
- package/dist/e2e-harness/scenario.d.ts +11 -0
- package/dist/e2e-harness/scenario.d.ts.map +1 -0
- package/dist/e2e-harness/scenario.js +89 -0
- package/dist/e2e-harness/schemas/demo-cycle.schema.json +282 -0
- package/dist/e2e-harness/schemas/demo-step.schema.json +245 -0
- package/dist/e2e-harness/schemas/e2e-claim-row.schema.json +33 -0
- package/dist/e2e-harness/schemas/e2e-claims.schema.json +18 -0
- package/dist/e2e-harness/schemas/e2e-scenario.schema.json +150 -0
- package/dist/e2e-harness/schemas/index.d.ts +191 -0
- package/dist/e2e-harness/schemas/index.d.ts.map +1 -0
- package/dist/e2e-harness/schemas/index.js +62 -0
- package/dist/e2e-harness/stack.d.ts +124 -0
- package/dist/e2e-harness/stack.d.ts.map +1 -0
- package/dist/e2e-harness/stack.js +207 -0
- package/dist/e2e-harness/steps.d.ts +11 -0
- package/dist/e2e-harness/steps.d.ts.map +1 -0
- package/dist/e2e-harness/steps.js +22 -0
- package/dist/e2e-harness.d.ts +3 -0
- package/dist/e2e-harness.d.ts.map +1 -0
- package/dist/e2e-harness.js +2 -0
- package/dist/engine-facts.d.ts.map +1 -1
- package/dist/engine-facts.js +1 -2
- package/dist/exit-codes.d.ts +54 -0
- package/dist/exit-codes.d.ts.map +1 -0
- package/dist/exit-codes.js +55 -0
- package/dist/forge-check/check.d.ts +63 -0
- package/dist/forge-check/check.d.ts.map +1 -0
- package/dist/forge-check/check.js +139 -0
- package/dist/forge-check/contract.d.ts +152 -0
- package/dist/forge-check/contract.d.ts.map +1 -0
- package/dist/forge-check/contract.js +118 -0
- package/dist/forge-check/forge.d.ts +42 -0
- package/dist/forge-check/forge.d.ts.map +1 -0
- package/dist/forge-check/forge.js +338 -0
- package/dist/forge-check/index.d.ts +24 -0
- package/dist/forge-check/index.d.ts.map +1 -0
- package/dist/forge-check/index.js +23 -0
- package/dist/forge-check/pulumi.d.ts +44 -0
- package/dist/forge-check/pulumi.d.ts.map +1 -0
- package/dist/forge-check/pulumi.js +184 -0
- package/dist/forge-check/read-only.d.ts +26 -0
- package/dist/forge-check/read-only.d.ts.map +1 -0
- package/dist/forge-check/read-only.js +53 -0
- package/dist/forge-check/trust.d.ts +94 -0
- package/dist/forge-check/trust.d.ts.map +1 -0
- package/dist/forge-check/trust.js +532 -0
- package/dist/forge-check/types.d.ts +80 -0
- package/dist/forge-check/types.d.ts.map +1 -0
- package/dist/forge-check/types.js +18 -0
- package/dist/forge-check.d.ts +6 -0
- package/dist/forge-check.d.ts.map +1 -0
- package/dist/forge-check.js +5 -0
- package/dist/gate-decision.d.ts +1 -0
- package/dist/gate-decision.d.ts.map +1 -1
- package/dist/gate-decision.js +2 -0
- package/dist/gate-policy.d.ts +47 -1
- package/dist/gate-policy.d.ts.map +1 -1
- package/dist/gate-policy.js +50 -2
- package/dist/index.d.ts +1 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +2 -0
- package/dist/lexicon.d.ts +152 -6
- package/dist/lexicon.d.ts.map +1 -1
- package/dist/lifecycle/adoption-file.d.ts +24 -0
- package/dist/lifecycle/adoption-file.d.ts.map +1 -1
- package/dist/lifecycle/adoption-file.js +1 -2
- package/dist/lifecycle/cloud-index.d.ts.map +1 -1
- package/dist/lifecycle/cloud-index.js +1 -2
- package/dist/lifecycle/gate-applied.d.ts +6 -0
- package/dist/lifecycle/gate-applied.d.ts.map +1 -1
- package/dist/lifecycle/gate-ledger.d.ts +29 -0
- package/dist/lifecycle/gate-ledger.d.ts.map +1 -1
- package/dist/lifecycle/gate-ledger.js +10 -1
- package/dist/lifecycle/gate-pending-by-plan.d.ts +75 -0
- package/dist/lifecycle/gate-pending-by-plan.d.ts.map +1 -0
- package/dist/lifecycle/gate-pending-by-plan.js +96 -0
- package/dist/lifecycle/gated-request-digest.d.ts +28 -0
- package/dist/lifecycle/gated-request-digest.d.ts.map +1 -0
- package/dist/lifecycle/gated-request-digest.js +35 -0
- package/dist/lifecycle/gated-request.d.ts +126 -0
- package/dist/lifecycle/gated-request.d.ts.map +1 -0
- package/dist/lifecycle/gated-request.js +204 -0
- package/dist/lifecycle/identity-match.d.ts +15 -0
- package/dist/lifecycle/identity-match.d.ts.map +1 -1
- package/dist/lifecycle/identity-match.js +11 -6
- package/dist/lifecycle/index-diff.d.ts +40 -0
- package/dist/lifecycle/index-diff.d.ts.map +1 -1
- package/dist/lifecycle/index-diff.js +1 -2
- package/dist/lifecycle/index-document.d.ts.map +1 -1
- package/dist/lifecycle/index-document.js +1 -2
- package/dist/lifecycle/index-import.d.ts +4 -1
- package/dist/lifecycle/index-import.d.ts.map +1 -1
- package/dist/lifecycle/index-import.js +29 -32
- package/dist/lifecycle/ledger-read.d.ts.map +1 -1
- package/dist/lifecycle/ledger-read.js +7 -3
- package/dist/lifecycle/lock-rows.d.ts +76 -0
- package/dist/lifecycle/lock-rows.d.ts.map +1 -0
- package/dist/lifecycle/lock-rows.js +140 -0
- package/dist/lifecycle/query.d.ts +50 -3
- package/dist/lifecycle/query.d.ts.map +1 -1
- package/dist/lifecycle/query.js +97 -7
- package/dist/lifecycle/release-catalog-site.d.ts +66 -0
- package/dist/lifecycle/release-catalog-site.d.ts.map +1 -0
- package/dist/lifecycle/release-catalog-site.js +232 -0
- package/dist/lifecycle/release-catalog.d.ts +201 -0
- package/dist/lifecycle/release-catalog.d.ts.map +1 -0
- package/dist/lifecycle/release-catalog.js +198 -0
- package/dist/lifecycle/release-changelog.d.ts +41 -0
- package/dist/lifecycle/release-changelog.d.ts.map +1 -0
- package/dist/lifecycle/release-changelog.js +38 -0
- package/dist/lifecycle/release-cut.d.ts +1 -0
- package/dist/lifecycle/release-cut.d.ts.map +1 -1
- package/dist/lifecycle/release-cut.js +1 -1
- package/dist/lifecycle/release-ledger.d.ts +16 -0
- package/dist/lifecycle/release-ledger.d.ts.map +1 -1
- package/dist/lifecycle/release-ledger.js +9 -0
- package/dist/lifecycle/release-publish.d.ts +43 -22
- package/dist/lifecycle/release-publish.d.ts.map +1 -1
- package/dist/lifecycle/release-read.d.ts.map +1 -1
- package/dist/lifecycle/release-read.js +3 -0
- package/dist/lifecycle/release-status.d.ts +106 -0
- package/dist/lifecycle/release-status.d.ts.map +1 -0
- package/dist/lifecycle/release-status.js +115 -0
- package/dist/lifecycle/resource-lock.d.ts +120 -0
- package/dist/lifecycle/resource-lock.d.ts.map +1 -0
- package/dist/lifecycle/resource-lock.js +317 -0
- package/dist/lifecycle/retention.d.ts.map +1 -1
- package/dist/lifecycle/retention.js +3 -0
- package/dist/lifecycle/run-ledger.d.ts.map +1 -1
- package/dist/lifecycle/run-ledger.js +9 -1
- package/dist/lifecycle/snapshot-store-s3.d.ts +36 -3
- package/dist/lifecycle/snapshot-store-s3.d.ts.map +1 -1
- package/dist/lifecycle/snapshot-store-s3.js +9 -44
- package/dist/lifecycle/snapshot-store.d.ts.map +1 -1
- package/dist/lifecycle/snapshot-store.js +1 -2
- package/dist/lifecycle/target-lock.d.ts +15 -0
- package/dist/lifecycle/target-lock.d.ts.map +1 -1
- package/dist/lifecycle/target-lock.js +25 -10
- package/dist/lifecycle/wave-plans.d.ts +23 -7
- package/dist/lifecycle/wave-plans.d.ts.map +1 -1
- package/dist/lifecycle/wave-plans.js +9 -2
- package/dist/mcp/types.d.ts +7 -0
- package/dist/mcp/types.d.ts.map +1 -1
- package/dist/notify-product.d.ts +43 -0
- package/dist/notify-product.d.ts.map +1 -0
- package/dist/notify-product.js +58 -0
- package/dist/notify-relay.d.ts +197 -0
- package/dist/notify-relay.d.ts.map +1 -0
- package/dist/notify-relay.js +321 -0
- package/dist/notify.d.ts +44 -4
- package/dist/notify.d.ts.map +1 -1
- package/dist/notify.js +77 -14
- package/dist/object-store/azure-blob.d.ts +129 -0
- package/dist/object-store/azure-blob.d.ts.map +1 -0
- package/dist/object-store/azure-blob.js +341 -0
- package/dist/object-store/common.d.ts +108 -0
- package/dist/object-store/common.d.ts.map +1 -0
- package/dist/object-store/common.js +80 -0
- package/dist/object-store/errors.d.ts +28 -0
- package/dist/object-store/errors.d.ts.map +1 -0
- package/dist/object-store/errors.js +21 -0
- package/dist/object-store/from-env.d.ts +18 -0
- package/dist/object-store/from-env.d.ts.map +1 -0
- package/dist/object-store/from-env.js +22 -0
- package/dist/object-store/gcs.d.ts +106 -0
- package/dist/object-store/gcs.d.ts.map +1 -0
- package/dist/object-store/gcs.js +393 -0
- package/dist/object-store/index.d.ts +9 -0
- package/dist/object-store/index.d.ts.map +1 -0
- package/dist/object-store/index.js +8 -0
- package/dist/object-store/s3.d.ts +146 -0
- package/dist/object-store/s3.d.ts.map +1 -0
- package/dist/object-store/s3.js +306 -0
- package/dist/op/activities/converge.d.ts.map +1 -1
- package/dist/op/activities/converge.js +2 -1
- package/dist/op/activities/index.d.ts +1 -1
- package/dist/op/activities/index.d.ts.map +1 -1
- package/dist/op/activities/index.js +1 -1
- package/dist/op/activities/review-agent.d.ts +55 -2
- package/dist/op/activities/review-agent.d.ts.map +1 -1
- package/dist/op/activities/review-agent.js +65 -5
- package/dist/op/approval-status.d.ts +103 -0
- package/dist/op/approval-status.d.ts.map +1 -0
- package/dist/op/approval-status.js +197 -0
- package/dist/op/gate.d.ts +29 -1
- package/dist/op/gate.d.ts.map +1 -1
- package/dist/op/gate.js +59 -23
- package/dist/op/generate-pipeline.d.ts.map +1 -1
- package/dist/op/generate-pipeline.js +7 -1
- package/dist/op/index.d.ts +12 -1
- package/dist/op/index.d.ts.map +1 -1
- package/dist/op/index.js +7 -1
- package/dist/op/op-waves-after-plan.d.ts +137 -0
- package/dist/op/op-waves-after-plan.d.ts.map +1 -0
- package/dist/op/op-waves-after-plan.js +163 -0
- package/dist/op/op-waves-capability-spec.d.ts +63 -0
- package/dist/op/op-waves-capability-spec.d.ts.map +1 -0
- package/dist/op/op-waves-capability-spec.js +115 -0
- package/dist/op/op-waves-capability.d.ts +197 -0
- package/dist/op/op-waves-capability.d.ts.map +1 -0
- package/dist/op/op-waves-capability.js +311 -0
- package/dist/op/op-waves-events.d.ts +54 -0
- package/dist/op/op-waves-events.d.ts.map +1 -0
- package/dist/op/op-waves-events.js +122 -0
- package/dist/op/op-waves-notify.d.ts +7 -1
- package/dist/op/op-waves-notify.d.ts.map +1 -1
- package/dist/op/op-waves-notify.js +35 -16
- package/dist/op/op-waves-release-port.d.ts +18 -0
- package/dist/op/op-waves-release-port.d.ts.map +1 -0
- package/dist/op/op-waves-release-port.js +61 -0
- package/dist/op/op-waves-release.d.ts +92 -0
- package/dist/op/op-waves-release.d.ts.map +1 -0
- package/dist/op/op-waves-release.js +96 -0
- package/dist/op/op-waves-run.d.ts +182 -6
- package/dist/op/op-waves-run.d.ts.map +1 -1
- package/dist/op/op-waves-run.js +1076 -44
- package/dist/op/op-waves-stand-down.d.ts +60 -0
- package/dist/op/op-waves-stand-down.d.ts.map +1 -0
- package/dist/op/op-waves-stand-down.js +96 -0
- package/dist/op/op-waves.d.ts +187 -8
- package/dist/op/op-waves.d.ts.map +1 -1
- package/dist/op/op-waves.js +203 -19
- package/dist/op/runtime.d.ts +95 -0
- package/dist/op/runtime.d.ts.map +1 -1
- package/dist/op/runtime.js +18 -0
- package/dist/op/stage-hooks.d.ts +45 -7
- package/dist/op/stage-hooks.d.ts.map +1 -1
- package/dist/op/stage-hooks.js +61 -3
- package/dist/op/steward-beside.d.ts.map +1 -1
- package/dist/op/steward-beside.js +2 -1
- package/dist/op/types.d.ts +2 -2
- package/dist/op/types.d.ts.map +1 -1
- package/dist/op/types.js +3 -2
- package/dist/otlp-metrics.d.ts +38 -0
- package/dist/otlp-metrics.d.ts.map +1 -0
- package/dist/otlp-metrics.js +82 -0
- package/dist/otlp.d.ts +249 -0
- package/dist/otlp.d.ts.map +1 -0
- package/dist/otlp.js +425 -0
- package/dist/override-gate.d.ts.map +1 -1
- package/dist/override-gate.js +5 -0
- package/dist/parallelism.d.ts +17 -0
- package/dist/parallelism.d.ts.map +1 -0
- package/dist/parallelism.js +33 -0
- package/dist/policy-packs.d.ts +69 -0
- package/dist/policy-packs.d.ts.map +1 -0
- package/dist/policy-packs.js +205 -0
- package/dist/policy-source.d.ts +51 -0
- package/dist/policy-source.d.ts.map +1 -0
- package/dist/policy-source.js +102 -0
- package/dist/pr-forge.d.ts +40 -0
- package/dist/pr-forge.d.ts.map +1 -1
- package/dist/pr-forge.js +146 -37
- package/dist/pr-loop.d.ts +158 -11
- package/dist/pr-loop.d.ts.map +1 -1
- package/dist/pr-loop.js +302 -44
- package/dist/pr-merge.d.ts +64 -0
- package/dist/pr-merge.d.ts.map +1 -0
- package/dist/pr-merge.js +78 -0
- package/dist/pr-post.d.ts +86 -1
- package/dist/pr-post.d.ts.map +1 -1
- package/dist/pr-post.js +141 -5
- package/dist/pr-report-url.d.ts +32 -4
- package/dist/pr-report-url.d.ts.map +1 -1
- package/dist/pr-report-url.js +45 -5
- package/dist/pr-requires.d.ts +13 -2
- package/dist/pr-requires.d.ts.map +1 -1
- package/dist/pr-requires.js +14 -0
- package/dist/release-floors.d.ts +1 -1
- package/dist/release-floors.js +1 -1
- package/dist/run-event.d.ts +26 -1
- package/dist/run-event.d.ts.map +1 -1
- package/dist/run-event.js +3 -1
- package/dist/scheduled-op-cloud.d.ts +32 -0
- package/dist/scheduled-op-cloud.d.ts.map +1 -0
- package/dist/scheduled-op-cloud.js +69 -0
- package/dist/sorted-json.d.ts +10 -0
- package/dist/sorted-json.d.ts.map +1 -0
- package/dist/sorted-json.js +14 -0
- package/dist/terraform/credentials.d.ts +59 -0
- package/dist/terraform/credentials.d.ts.map +1 -0
- package/dist/terraform/credentials.js +149 -0
- package/dist/utils.d.ts +1 -4
- package/dist/utils.d.ts.map +1 -1
- package/dist/utils.js +1 -9
- package/dist/wave-runtime.d.ts +1 -1
- package/dist/wave-runtime.js +2 -2
- package/dist/wave-runtime.mjs +405 -287
- package/dist/workspace/chant-migrations/chud-lexicon-exit.d.ts.map +1 -1
- package/dist/workspace/chant-migrations/chud-lexicon-exit.js +4 -1
- package/dist/workspace/ci-lock-grain.d.ts +17 -0
- package/dist/workspace/ci-lock-grain.d.ts.map +1 -0
- package/dist/workspace/ci-lock-grain.js +21 -0
- package/dist/workspace/ci-run.d.ts +2 -1
- package/dist/workspace/ci-run.d.ts.map +1 -1
- package/dist/workspace/ci-run.js +10 -3
- package/dist/workspace/declaration.d.ts +16 -4
- package/dist/workspace/declaration.d.ts.map +1 -1
- package/dist/workspace/declaration.js +5 -2
- package/dist/workspace/declaration.schema.json +27 -3
- package/dist/workspace/drift-cli.d.ts.map +1 -1
- package/dist/workspace/drift-cli.js +8 -3
- package/dist/workspace/exit-cli.d.ts +1 -1
- package/dist/workspace/exit-cli.d.ts.map +1 -1
- package/dist/workspace/exit-cli.js +2 -1
- package/dist/workspace/import-fetch.d.ts +4 -2
- package/dist/workspace/import-fetch.d.ts.map +1 -1
- package/dist/workspace/import-fetch.js +4 -2
- package/dist/workspace/import-init.d.ts.map +1 -1
- package/dist/workspace/import-init.js +4 -2
- package/dist/workspace/ledger.schema.json +7 -3
- package/dist/workspace/lineage-upgrade-cli.d.ts +1 -1
- package/dist/workspace/lineage-upgrade-cli.d.ts.map +1 -1
- package/dist/workspace/lineage-upgrade-cli.js +2 -1
- package/dist/workspace/pr-report.schema.json +79 -3
- package/dist/workspace/promote.d.ts +1 -1
- package/dist/workspace/promote.d.ts.map +1 -1
- package/dist/workspace/promote.js +2 -1
- package/dist/workspace/records-cli.d.ts +2 -2
- package/dist/workspace/records-cli.d.ts.map +1 -1
- package/dist/workspace/records-cli.js +3 -2
- package/dist/workspace/release-catalog.schema.json +277 -0
- package/dist/workspace/run-event.schema.json +18 -1
- package/dist/workspace/work-cli.d.ts +3 -1
- package/dist/workspace/work-cli.d.ts.map +1 -1
- package/dist/workspace/work-cli.js +7 -2
- package/dist/workspace/workspace-run.d.ts.map +1 -1
- package/dist/workspace/workspace-run.js +2 -1
- package/package.json +21 -1
- package/src/__fixtures__/estate-ledger.ts +101 -0
- package/src/__fixtures__/oidc-emulator.ts +31 -2
- package/src/__fixtures__/product-words.ts +44 -0
- package/src/__golden__/wave-loop/op-by-apply-after-fails.json +10 -2
- package/src/__golden__/wave-loop/op-by-apply-hold.json +20 -4
- package/src/__golden__/wave-loop/op-by-apply-ignored.json +10 -2
- package/src/__golden__/wave-loop/op-by-apply-pass.json +10 -2
- package/src/__golden__/wave-loop/op-by-apply-skip.json +10 -2
- package/src/__golden__/wave-loop/op-discover-rest-stops.json +22 -6
- package/src/__golden__/wave-loop/op-discover-rest.json +44 -12
- package/src/__golden__/wave-loop/op-discover-wide.json +12 -3
- package/src/__golden__/wave-loop/op-held-on.json +28 -7
- package/src/__golden__/wave-loop/op-hooks-apply-fails.json +22 -6
- package/src/__golden__/wave-loop/op-hooks-fail-after-apply.json +22 -6
- package/src/__golden__/wave-loop/op-hooks-fail-before-apply.json +4 -2
- package/src/__golden__/wave-loop/op-hooks-held.json +26 -8
- package/src/__golden__/wave-loop/op-hooks-hold-before-apply.json +18 -4
- package/src/__golden__/wave-loop/op-hooks-pass.json +22 -6
- package/src/__golden__/wave-loop/op-hooks-share.json +20 -7
- package/src/__golden__/wave-loop/op-outcome-held.json +12 -3
- package/src/__golden__/wave-loop/op-outcome-replan-approved.json +16 -5
- package/src/__golden__/wave-loop/op-outcome-replan-forever.json +48 -21
- package/src/__golden__/wave-loop/op-outcome-replan.json +16 -5
- package/src/__golden__/wave-loop/op-outcome-stood-down.json +12 -3
- package/src/__golden__/wave-loop/op-outcome-unreadable.json +12 -3
- package/src/__golden__/wave-loop/op-overridden.json +28 -7
- package/src/__golden__/wave-loop/op-per-run.json +20 -4
- package/src/__golden__/wave-loop/op-point.json +18 -4
- package/src/__golden__/wave-loop/op-pr-review.json +10 -2
- package/src/__golden__/wave-loop/op-spend-change-only.json +10 -2
- package/src/__golden__/wave-loop/op-spend.json +10 -2
- package/src/__golden__/wave-loop/op-wave-commands.json +56 -13
- package/src/__golden__/wave-loop/op-wide.json +20 -4
- package/src/bucket-check/azure.ts +307 -0
- package/src/bucket-check/bucket-check.test.ts +210 -0
- package/src/bucket-check/fixtures/azure.json +153 -0
- package/src/bucket-check/fixtures/gcs.json +148 -0
- package/src/bucket-check/fixtures/s3.json +277 -0
- package/src/bucket-check/gcs.ts +257 -0
- package/src/bucket-check/index.ts +61 -0
- package/src/bucket-check/s3.ts +433 -0
- package/src/bucket-check/types.ts +75 -0
- package/src/bucket-check/wire.ts +50 -0
- package/src/bucket-check.ts +5 -0
- package/src/capabilities/templates.test.ts +2 -3
- package/src/capabilities/templates.ts +1 -2
- package/src/cdk/advise.test.ts +1 -1
- package/src/change-set-bundle.test.ts +0 -1
- package/src/change-set.ts +2 -3
- package/src/ci-agent.test.ts +348 -0
- package/src/ci-agent.ts +1025 -0
- package/src/ci-audit/__fixtures__/cloudtrail-lookup-bucket.json +37 -0
- package/src/ci-audit/__fixtures__/cloudtrail-writes-window.json +59 -0
- package/src/ci-audit/attribution.ts +260 -0
- package/src/ci-audit/audit-log.ts +220 -0
- package/src/ci-audit/ci-audit.test.ts +175 -0
- package/src/ci-audit/index.ts +15 -0
- package/src/ci-audit/unrecorded.ts +140 -0
- package/src/ci-audit.ts +2 -0
- package/src/ci-control.ts +173 -0
- package/src/ci-estate/delivery.ts +433 -0
- package/src/ci-estate/overdue.ts +81 -0
- package/src/ci-estate/page.ts +343 -0
- package/src/ci-estate/rows.ts +251 -0
- package/src/ci-estate.test.ts +281 -0
- package/src/ci-estate.ts +175 -0
- package/src/ci-handover.ts +67 -16
- package/src/ci-identity-database.test.ts +54 -0
- package/src/ci-identity-pulumi.test.ts +163 -0
- package/src/ci-identity-targets.test.ts +3 -1
- package/src/ci-identity.ts +123 -22
- package/src/ci-job-guard.test.ts +154 -0
- package/src/ci-job-guard.ts +319 -0
- package/src/ci-jobs.ts +8 -0
- package/src/ci-product-comment-targets.test.ts +45 -0
- package/src/ci-product-words.test.ts +101 -0
- package/src/ci-product-words.ts +565 -0
- package/src/ci-product.ts +226 -0
- package/src/ci-respond-run.ts +291 -0
- package/src/ci-respond.test.ts +264 -0
- package/src/ci-respond.ts +412 -0
- package/src/ci-shared-reads.test.ts +145 -0
- package/src/cli/commands/audit.test.ts +1 -1
- package/src/cli/commands/audit.ts +3 -2
- package/src/cli/commands/carve.test.ts +1 -1
- package/src/cli/commands/carve.ts +2 -2
- package/src/cli/commands/init.ts +3 -1
- package/src/cli/component-wave-args.test.ts +16 -0
- package/src/cli/handlers/agent.ts +126 -0
- package/src/cli/handlers/approve-confirm.test.ts +276 -0
- package/src/cli/handlers/approve-confirm.ts +200 -0
- package/src/cli/handlers/approve.ts +18 -1
- package/src/cli/handlers/audit-log.ts +74 -0
- package/src/cli/handlers/build-pr-loop-flags.test.ts +98 -0
- package/src/cli/handlers/build.test.ts +7 -0
- package/src/cli/handlers/build.ts +113 -1
- package/src/cli/handlers/ci-check-job.test.ts +114 -0
- package/src/cli/handlers/ci-check-job.ts +33 -0
- package/src/cli/handlers/ci-check.ts +63 -0
- package/src/cli/handlers/ci-forge-check.ts +91 -0
- package/src/cli/handlers/e2e-safe-run.ts +27 -0
- package/src/cli/handlers/fan-out.test.ts +10 -10
- package/src/cli/handlers/fan-out.ts +5 -0
- package/src/cli/handlers/gate-pending.ts +46 -0
- package/src/cli/handlers/init.ts +1 -0
- package/src/cli/handlers/ledger.ts +1 -1
- package/src/cli/handlers/lifecycle-drift.ts +7 -2
- package/src/cli/handlers/lock.test.ts +29 -2
- package/src/cli/handlers/lock.ts +66 -6
- package/src/cli/handlers/notify-relay.ts +130 -0
- package/src/cli/handlers/pr-before-merge.test.ts +2 -1
- package/src/cli/handlers/pr-deploy-inputs.test.ts +7 -7
- package/src/cli/handlers/pr-env.ts +48 -11
- package/src/cli/handlers/pr-plan-comment-targets.test.ts +166 -0
- package/src/cli/handlers/pr-plan-flags.test.ts +161 -0
- package/src/cli/handlers/pr-plan-targets.test.ts +155 -0
- package/src/cli/handlers/pr-waves-blocked.test.ts +5 -0
- package/src/cli/handlers/pr-waves.test.ts +8 -2
- package/src/cli/handlers/pr.test.ts +8 -8
- package/src/cli/handlers/pr.ts +879 -205
- package/src/cli/handlers/promote.test.ts +5 -5
- package/src/cli/handlers/promote.ts +22 -2
- package/src/cli/handlers/release.ts +2 -0
- package/src/cli/handlers/run-components-exit.test.ts +7 -7
- package/src/cli/handlers/run-wave.ts +144 -2
- package/src/cli/handlers/run.test.ts +6 -4
- package/src/cli/handlers/run.ts +86 -1
- package/src/cli/handlers/serve.ts +10 -1
- package/src/cli/main.test.ts +1 -1
- package/src/cli/main.ts +180 -13
- package/src/cli/mcp/ledger-tools.ts +126 -0
- package/src/cli/mcp/product-tools.test.ts +123 -0
- package/src/cli/mcp/product-tools.ts +129 -0
- package/src/cli/mcp/read-only.test.ts +134 -0
- package/src/cli/mcp/read-only.ts +68 -0
- package/src/cli/mcp/report-tools.ts +135 -0
- package/src/cli/mcp/server.test.ts +5 -4
- package/src/cli/mcp/server.ts +90 -16
- package/src/cli/mcp-config.ts +8 -3
- package/src/cli/parse-args.ts +119 -2
- package/src/cli/registry.ts +73 -0
- package/src/cloud-lister/sigv4.ts +80 -23
- package/src/components/adoption.test.ts +140 -0
- package/src/components/adoption.ts +140 -0
- package/src/components/apply-lease.ts +49 -0
- package/src/components/capability.ts +180 -6
- package/src/components/check-hooks.test.ts +66 -0
- package/src/components/check-hooks.ts +255 -0
- package/src/components/check-steps.test.ts +70 -0
- package/src/components/check-steps.ts +158 -0
- package/src/components/ci-services.test.ts +51 -0
- package/src/components/ci-services.ts +82 -0
- package/src/components/cli-support.ts +23 -2
- package/src/components/driver.test.ts +3 -3
- package/src/components/driver.ts +73 -6
- package/src/components/fan-out-run.ts +68 -18
- package/src/components/groups.ts +21 -4
- package/src/components/plan-flags.test.ts +46 -0
- package/src/components/pr-comment-preview-targets.test.ts +34 -0
- package/src/components/pr-comment-preview.test.ts +54 -0
- package/src/components/pr-env-ledger.test.ts +9 -0
- package/src/components/pr-env-ledger.ts +42 -0
- package/src/components/pr-env-ports.ts +29 -4
- package/src/components/pr-env-run-bundle.test.ts +2 -14
- package/src/components/pr-env-run.test.ts +19 -0
- package/src/components/pr-env-run.ts +12 -2
- package/src/components/pr-environment.test.ts +29 -0
- package/src/components/pr-environment.ts +40 -8
- package/src/components/pr-pipeline-runners.test.ts +80 -0
- package/src/components/pr-pipeline.test.ts +15 -0
- package/src/components/pr-pipeline.ts +498 -18
- package/src/components/pr-policy.ts +45 -7
- package/src/components/pr-run.test.ts +1 -1
- package/src/components/pr-run.ts +138 -11
- package/src/components/pr-stale-job.test.ts +34 -0
- package/src/components/pr-targets.test.ts +35 -0
- package/src/components/pr-targets.ts +45 -0
- package/src/components/product-pipeline.test.ts +200 -0
- package/src/components/product-pipeline.ts +383 -0
- package/src/components/promote.ts +10 -1
- package/src/components/release-compile.ts +87 -1
- package/src/components/release-promote.ts +65 -1
- package/src/components/repo-lock.ts +52 -0
- package/src/components/row-lease.test.ts +490 -0
- package/src/components/row-lease.ts +167 -0
- package/src/components/wave-plan-policy.test.ts +19 -0
- package/src/components/wave-plan.ts +96 -6
- package/src/control/__fixtures__/consumers/apps/consumers.json +15 -0
- package/src/control/__fixtures__/consumers/infra/consumers.json +23 -0
- package/src/control/applied.test.ts +148 -0
- package/src/control/applied.ts +191 -0
- package/src/control/consumers.test.ts +129 -0
- package/src/control/consumers.ts +192 -0
- package/src/control/control.test.ts +302 -0
- package/src/control/dispatch.ts +699 -0
- package/src/control/edges.test.ts +112 -0
- package/src/control/edges.ts +164 -0
- package/src/control/note-checkout.test.ts +91 -0
- package/src/control/reconcile.ts +250 -0
- package/src/control/records.ts +395 -0
- package/src/discovery/sandbox/bundle.ts +25 -1
- package/src/e2e-harness/__project__/chant.config.ts +4 -0
- package/src/e2e-harness/__project__/src/compose.ts +33 -0
- package/src/e2e-harness/bucket.ts +69 -0
- package/src/e2e-harness/claim.test.ts +150 -0
- package/src/e2e-harness/claim.ts +140 -0
- package/src/e2e-harness/driver.test.ts +304 -0
- package/src/e2e-harness/driver.ts +294 -0
- package/src/e2e-harness/forgejo.ts +267 -0
- package/src/e2e-harness/git.ts +96 -0
- package/src/e2e-harness/index.ts +50 -0
- package/src/e2e-harness/jobs.ts +35 -0
- package/src/e2e-harness/pins.ts +52 -0
- package/src/e2e-harness/ports.ts +130 -0
- package/src/e2e-harness/reports.ts +79 -0
- package/src/e2e-harness/safe-run-cli.test.ts +102 -0
- package/src/e2e-harness/safe-run-cli.ts +54 -0
- package/src/e2e-harness/safe-run.ts +198 -0
- package/src/e2e-harness/scenario.ts +89 -0
- package/src/e2e-harness/schemas/README.md +62 -0
- package/src/e2e-harness/schemas/demo-cycle.schema.json +282 -0
- package/src/e2e-harness/schemas/demo-step.schema.json +245 -0
- package/src/e2e-harness/schemas/e2e-claim-row.schema.json +33 -0
- package/src/e2e-harness/schemas/e2e-claims.schema.json +18 -0
- package/src/e2e-harness/schemas/e2e-scenario.schema.json +150 -0
- package/src/e2e-harness/schemas/index.ts +220 -0
- package/src/e2e-harness/schemas.test.ts +145 -0
- package/src/e2e-harness/stack.test.ts +124 -0
- package/src/e2e-harness/stack.ts +306 -0
- package/src/e2e-harness/steps.ts +30 -0
- package/src/e2e-harness.ts +2 -0
- package/src/engine-facts.test.ts +2 -3
- package/src/engine-facts.ts +1 -2
- package/src/exit-codes.test.ts +32 -0
- package/src/exit-codes.ts +61 -0
- package/src/forge-check/check.ts +155 -0
- package/src/forge-check/contract.ts +215 -0
- package/src/forge-check/forge-check.test.ts +427 -0
- package/src/forge-check/forge.ts +318 -0
- package/src/forge-check/index.ts +43 -0
- package/src/forge-check/pulumi.ts +192 -0
- package/src/forge-check/read-only.ts +56 -0
- package/src/forge-check/trust.ts +527 -0
- package/src/forge-check/types.ts +78 -0
- package/src/forge-check.ts +5 -0
- package/src/gate-decision-bundle.test.ts +11 -0
- package/src/gate-decision.ts +3 -0
- package/src/gate-policy.ts +92 -3
- package/src/gated-waves-bundle.test.ts +0 -1
- package/src/index.ts +2 -0
- package/src/lexicon.ts +143 -6
- package/src/lifecycle/adoption-file.ts +1 -2
- package/src/lifecycle/cloud-index.test.ts +2 -3
- package/src/lifecycle/cloud-index.ts +1 -2
- package/src/lifecycle/control-entries-ledger.test.ts +69 -0
- package/src/lifecycle/gate-applied.ts +6 -0
- package/src/lifecycle/gate-ledger.ts +35 -1
- package/src/lifecycle/gate-pending-by-plan.test.ts +69 -0
- package/src/lifecycle/gate-pending-by-plan.ts +133 -0
- package/src/lifecycle/gated-request-digest.ts +49 -0
- package/src/lifecycle/gated-request-ledger.test.ts +53 -0
- package/src/lifecycle/gated-request.ts +279 -0
- package/src/lifecycle/identity-match.ts +25 -6
- package/src/lifecycle/index-diff.ts +1 -2
- package/src/lifecycle/index-document.ts +1 -2
- package/src/lifecycle/index-import.test.ts +14 -0
- package/src/lifecycle/index-import.ts +54 -34
- package/src/lifecycle/ledger-read.ts +7 -3
- package/src/lifecycle/lock-rows.test.ts +109 -0
- package/src/lifecycle/lock-rows.ts +167 -0
- package/src/lifecycle/publish-target-context.test.ts +108 -0
- package/src/lifecycle/query.test.ts +2 -3
- package/src/lifecycle/query.ts +109 -8
- package/src/lifecycle/release-catalog-site.test.ts +142 -0
- package/src/lifecycle/release-catalog-site.ts +291 -0
- package/src/lifecycle/release-catalog.test.ts +192 -0
- package/src/lifecycle/release-catalog.ts +353 -0
- package/src/lifecycle/release-changelog.test.ts +70 -0
- package/src/lifecycle/release-changelog.ts +71 -0
- package/src/lifecycle/release-cut.ts +2 -2
- package/src/lifecycle/release-ledger.ts +19 -0
- package/src/lifecycle/release-publish.ts +45 -22
- package/src/lifecycle/release-read.ts +2 -0
- package/src/lifecycle/release-status.test.ts +185 -0
- package/src/lifecycle/release-status.ts +175 -0
- package/src/lifecycle/resource-lock.test.ts +175 -0
- package/src/lifecycle/resource-lock.ts +354 -0
- package/src/lifecycle/retention.ts +2 -0
- package/src/lifecycle/run-ledger.ts +7 -1
- package/src/lifecycle/snapshot-store-s3.ts +9 -45
- package/src/lifecycle/snapshot-store.ts +1 -2
- package/src/lifecycle/target-lock.ts +24 -9
- package/src/lifecycle/wave-plans.ts +33 -5
- package/src/mcp/types.ts +7 -0
- package/src/notify-product.ts +76 -0
- package/src/notify-relay.test.ts +213 -0
- package/src/notify-relay.ts +407 -0
- package/src/notify.ts +95 -14
- package/src/object-store/azure-blob.ts +374 -0
- package/src/object-store/common.ts +133 -0
- package/src/object-store/errors.ts +26 -0
- package/src/object-store/from-env.ts +36 -0
- package/src/object-store/gcs.ts +436 -0
- package/src/object-store/index.ts +8 -0
- package/src/object-store/object-store.test.ts +130 -0
- package/src/object-store/s3.ts +350 -0
- package/src/op/activities/converge.ts +2 -1
- package/src/op/activities/index.ts +1 -1
- package/src/op/activities/review-agent.open.test.ts +78 -0
- package/src/op/activities/review-agent.test.ts +13 -0
- package/src/op/activities/review-agent.ts +89 -5
- package/src/op/approval-status.test.ts +134 -0
- package/src/op/approval-status.ts +235 -0
- package/src/op/gate-review.test.ts +2 -1
- package/src/op/gate.ts +81 -22
- package/src/op/generate-pipeline.ts +7 -1
- package/src/op/index.ts +23 -0
- package/src/op/op-waves-after-plan.test.ts +288 -0
- package/src/op/op-waves-after-plan.ts +238 -0
- package/src/op/op-waves-capability-spec.ts +133 -0
- package/src/op/op-waves-capability.test.ts +217 -0
- package/src/op/op-waves-capability.ts +370 -0
- package/src/op/op-waves-events.ts +135 -0
- package/src/op/op-waves-notify-words.test.ts +149 -0
- package/src/op/op-waves-notify.ts +41 -16
- package/src/op/op-waves-parallelism.test.ts +89 -0
- package/src/op/op-waves-pull-request.test.ts +219 -0
- package/src/op/op-waves-release-port.ts +64 -0
- package/src/op/op-waves-release.test.ts +209 -0
- package/src/op/op-waves-release.ts +132 -0
- package/src/op/op-waves-run-record.test.ts +32 -0
- package/src/op/op-waves-run.ts +1235 -52
- package/src/op/op-waves-stand-down.test.ts +240 -0
- package/src/op/op-waves-stand-down.ts +107 -0
- package/src/op/op-waves-trace.test.ts +205 -0
- package/src/op/op-waves.test.ts +112 -0
- package/src/op/op-waves.ts +320 -22
- package/src/op/runtime.ts +107 -0
- package/src/op/stage-hooks-hold-record.test.ts +41 -0
- package/src/op/stage-hooks.ts +91 -12
- package/src/op/steward-beside.ts +2 -1
- package/src/op/types.ts +3 -2
- package/src/otlp-metrics.ts +96 -0
- package/src/otlp.test.ts +243 -0
- package/src/otlp.ts +543 -0
- package/src/override-gate-bundle.test.ts +2 -0
- package/src/override-gate.ts +4 -0
- package/src/parallelism.test.ts +38 -0
- package/src/parallelism.ts +33 -0
- package/src/policy-packs.ts +230 -0
- package/src/policy-source.test.ts +256 -0
- package/src/policy-source.ts +111 -0
- package/src/pr-forge-bundle.test.ts +1 -1
- package/src/pr-forge.ts +175 -33
- package/src/pr-loop-bundle.test.ts +7 -3
- package/src/pr-loop-narrowed.test.ts +63 -0
- package/src/pr-loop-words.test.ts +155 -0
- package/src/pr-loop.ts +398 -52
- package/src/pr-merge.test.ts +100 -0
- package/src/pr-merge.ts +105 -0
- package/src/pr-post-stale.test.ts +163 -0
- package/src/pr-post.ts +190 -5
- package/src/pr-report-url.ts +61 -6
- package/src/pr-requires.test.ts +37 -1
- package/src/pr-requires.ts +16 -2
- package/src/product-subpaths-plain-node.e2e.test.ts +212 -0
- package/src/release-floors.ts +1 -1
- package/src/run-event.ts +28 -1
- package/src/scheduled-op-cloud.ts +68 -0
- package/src/sorted-json.ts +17 -0
- package/src/stage-hooks-bundle.test.ts +6 -0
- package/src/terraform/credentials.test.ts +77 -0
- package/src/terraform/credentials.ts +162 -0
- package/src/utils.ts +2 -11
- package/src/wave-loop-golden.test.ts +2 -1
- package/src/wave-runtime.ts +2 -2
- package/src/workspace/chant-migrations/chud-lexicon-exit.ts +4 -1
- package/src/workspace/ci-lock-grain.test.ts +31 -0
- package/src/workspace/ci-lock-grain.ts +29 -0
- package/src/workspace/ci-report-url.test.ts +1 -1
- package/src/workspace/ci-run.test.ts +1 -1
- package/src/workspace/ci-run.ts +10 -3
- package/src/workspace/declaration.schema.json +27 -3
- package/src/workspace/declaration.test.ts +1 -1
- package/src/workspace/declaration.ts +26 -10
- package/src/workspace/drift-cli.ts +8 -3
- package/src/workspace/exit-cli.ts +2 -1
- package/src/workspace/import-fetch.ts +4 -2
- package/src/workspace/import-init.ts +4 -2
- package/src/workspace/ledger.schema.json +7 -3
- package/src/workspace/lineage-upgrade-cli.ts +2 -1
- package/src/workspace/pr-report.schema.json +79 -3
- package/src/workspace/promote.ts +2 -1
- package/src/workspace/records-cli.ts +3 -2
- package/src/workspace/release-catalog.schema.json +277 -0
- package/src/workspace/run-event.schema.json +18 -1
- package/src/workspace/work-cli.ts +8 -2
- package/src/workspace/workspace-run.ts +2 -1
|
@@ -0,0 +1,233 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The estate page (#4612): one self-contained `estate.html` and its
|
|
3
|
+
* `estate.json`, from the ledger rows (./rows.ts) and nothing else, with a
|
|
4
|
+
* section per member. Lifted from terragucci's report/estate.ts, whose
|
|
5
|
+
* page is built from its reports bucket. The fields keep that file's names
|
|
6
|
+
* (`projects`, `totals`, `waiting`, `drifted`, `failed`, `recent`) and its
|
|
7
|
+
* schema name under the product's words (`terragucci.estate/v1`), so a
|
|
8
|
+
* product that adds its own sections (terragucci's inventory, versions,
|
|
9
|
+
* states and graph) adds them to the same objects.
|
|
10
|
+
*
|
|
11
|
+
* Per member it shows the waves of the newest commit an op wave applied,
|
|
12
|
+
* each wave's jobs and gate, how long a waiting wave has waited, the newest
|
|
13
|
+
* drift check and whether its schedule is overdue, and the live pull
|
|
14
|
+
* request environments. Below that the newest runs across the estate, and
|
|
15
|
+
* the delivery metrics (./delivery.ts).
|
|
16
|
+
*/
|
|
17
|
+
import { samePlanDigest } from "../lifecycle/plan-digest.js";
|
|
18
|
+
import { CHANT_WORDS } from "../ci-product-words.js";
|
|
19
|
+
import { duration, spanLabel, DORA_FILE } from "./delivery.js";
|
|
20
|
+
/** `<product>.estate/v1`. */
|
|
21
|
+
export const estateSchema = (words = CHANT_WORDS) => `${words.product}.estate/v1`;
|
|
22
|
+
/** How many of the newest runs the page lists. */
|
|
23
|
+
export const RECENT_RUNS = 20;
|
|
24
|
+
/** The files the page writes. */
|
|
25
|
+
export const ESTATE_FILES = { page: "estate.html", json: "estate.json", dora: DORA_FILE };
|
|
26
|
+
const at = (iso) => (iso ? Date.parse(iso) || 0 : 0);
|
|
27
|
+
const secondsSince = (iso, now) => Math.max(0, Math.round((now.getTime() - at(iso)) / 1000));
|
|
28
|
+
function waveRun(w, rows) {
|
|
29
|
+
const gated = w.status === "gated" || w.status === "waiting";
|
|
30
|
+
const spent = !gated && rows.approved.some((a) => a.member === w.member && a.op === w.spec && w.digest !== undefined && samePlanDigest(a.planDigest, w.digest));
|
|
31
|
+
const since = gated ? pendingSince(w, rows) ?? w.ended : undefined;
|
|
32
|
+
return {
|
|
33
|
+
project: w.member,
|
|
34
|
+
commit: w.commit ?? "",
|
|
35
|
+
stage: w.spec,
|
|
36
|
+
wave: w.wave,
|
|
37
|
+
...(w.share !== undefined ? { share: w.share } : {}),
|
|
38
|
+
finished: w.ended,
|
|
39
|
+
roots: new Set([...w.applied, ...w.failed, ...w.moved, ...w.blocked]).size,
|
|
40
|
+
changed: w.applied.length,
|
|
41
|
+
failed: w.failed.length,
|
|
42
|
+
refused: w.moved.length,
|
|
43
|
+
...(gated ? { approval: "waiting", waiting_since: since } : spent ? { approval: "approved" } : {}),
|
|
44
|
+
...(w.applied.length > 0 && w.failed.length === 0 ? { applied: w.ended } : {}),
|
|
45
|
+
...(w.runUrl ? { job_url: w.runUrl } : {}),
|
|
46
|
+
status: w.status,
|
|
47
|
+
run: w.id,
|
|
48
|
+
};
|
|
49
|
+
}
|
|
50
|
+
/** When the gate a waiting job stopped at first asked for this digest. */
|
|
51
|
+
function pendingSince(w, rows) {
|
|
52
|
+
const asked = rows.gates
|
|
53
|
+
.filter((g) => g.kind === "pending" && g.member === w.member && g.op === w.spec && w.digest !== undefined && g.planDigest !== undefined && samePlanDigest(g.planDigest, w.digest))
|
|
54
|
+
.sort((a, b) => at(a.timestamp) - at(b.timestamp))[0];
|
|
55
|
+
return asked?.timestamp;
|
|
56
|
+
}
|
|
57
|
+
function driftRun(d) {
|
|
58
|
+
const changed = d.drifted ? d.roots.length || 1 : 0;
|
|
59
|
+
return { project: d.member, commit: d.commit ?? "", stage: d.op, finished: d.ended, roots: d.roots.length, changed, refused: 0, ...(d.runUrl ? { job_url: d.runUrl } : {}), status: d.status, run: d.id };
|
|
60
|
+
}
|
|
61
|
+
const newest = (xs) => xs.reduce((a, x) => (!a || at(x.ended) > at(a.ended) ? x : a), undefined);
|
|
62
|
+
/** The pull request environments still live: an `up` that applied with no later `down` that destroyed it. */
|
|
63
|
+
function livePrEnvs(lines) {
|
|
64
|
+
const by = new Map();
|
|
65
|
+
for (const l of [...lines].sort((a, b) => at(a.timestamp) - at(b.timestamp))) {
|
|
66
|
+
if (l.kind === "up" && l.result === "applied")
|
|
67
|
+
by.set(l.env, l);
|
|
68
|
+
else if (l.kind === "down" && l.result !== "incomplete")
|
|
69
|
+
by.delete(l.env);
|
|
70
|
+
}
|
|
71
|
+
return [...by.values()].sort((a, b) => a.pr - b.pr).map((l) => ({ pr: l.pr, env: l.env, ...(l.commit ? { commit: l.commit } : {}), applied: l.timestamp, ...(l.expiresAt ? { expires: l.expiresAt } : {}), ...(l.runUrl ? { run_url: l.runUrl } : {}) }));
|
|
72
|
+
}
|
|
73
|
+
/** One member's section. */
|
|
74
|
+
export function memberState(member, rows, now, overdue = []) {
|
|
75
|
+
const waves = rows.waves.filter((w) => w.member === member && w.job !== "decide");
|
|
76
|
+
const checks = rows.drift.filter((d) => d.member === member);
|
|
77
|
+
const envs = livePrEnvs(rows.prEnvs.filter((p) => p.member === member));
|
|
78
|
+
const late = overdue.filter((o) => o.member === member);
|
|
79
|
+
const extra = { ...(late.length ? { overdue: [...late] } : {}), ...(envs.length ? { ephemeral: envs } : {}) };
|
|
80
|
+
if (waves.length === 0 && checks.length === 0)
|
|
81
|
+
return { project: member, status: rows.members.includes(member) ? "ok" : "no-index", waiting: [], drifted: 0, failed: 0, ...extra };
|
|
82
|
+
// The newest commit that ran a wave holds the member's apply state; an older commit's waiting wave is behind it.
|
|
83
|
+
const last = newest(waves);
|
|
84
|
+
let apply;
|
|
85
|
+
const waiting = [];
|
|
86
|
+
if (last) {
|
|
87
|
+
const byJob = new Map();
|
|
88
|
+
for (const w of waves.filter((x) => (x.commit ?? "") === (last.commit ?? ""))) {
|
|
89
|
+
const k = `${w.spec}/${w.wave}/${w.share ?? w.group ?? 0}`;
|
|
90
|
+
const held = byJob.get(k);
|
|
91
|
+
if (!held || at(w.ended) > at(held.ended))
|
|
92
|
+
byJob.set(k, w);
|
|
93
|
+
}
|
|
94
|
+
const jobs = [...byJob.values()].sort((a, b) => a.wave - b.wave || (a.share ?? 0) - (b.share ?? 0));
|
|
95
|
+
const runs = jobs.map((w) => waveRun(w, rows));
|
|
96
|
+
apply = { commit: last.commit ?? "", waves: runs };
|
|
97
|
+
for (const [i, r] of runs.entries()) {
|
|
98
|
+
if (r.approval !== "waiting")
|
|
99
|
+
continue;
|
|
100
|
+
const since = r.waiting_since ?? r.finished;
|
|
101
|
+
waiting.push({ project: member, wave: r.wave ?? 0, commit: r.commit, since, age_seconds: secondsSince(since, now), ...(jobs[i].gate ? { gate: jobs[i].gate } : {}) });
|
|
102
|
+
}
|
|
103
|
+
}
|
|
104
|
+
const check = newest(checks);
|
|
105
|
+
const drift = check ? driftRun(check) : undefined;
|
|
106
|
+
return {
|
|
107
|
+
project: member,
|
|
108
|
+
status: "ok",
|
|
109
|
+
...(drift ? { drift } : {}),
|
|
110
|
+
...(apply ? { apply } : {}),
|
|
111
|
+
waiting,
|
|
112
|
+
drifted: drift?.changed ?? 0,
|
|
113
|
+
failed: apply ? apply.waves.reduce((n, w) => n + (w.failed ?? 0), 0) : 0,
|
|
114
|
+
...extra,
|
|
115
|
+
};
|
|
116
|
+
}
|
|
117
|
+
/** The estate page's data from the ledger rows. */
|
|
118
|
+
export function buildEstate(rows, dora, options = {}) {
|
|
119
|
+
const now = options.now ?? new Date();
|
|
120
|
+
const members = options.members ?? rows.members;
|
|
121
|
+
const projects = members.map((m) => memberState(m, rows, now, options.overdue));
|
|
122
|
+
const recent = [
|
|
123
|
+
...rows.waves.filter((w) => w.job !== "decide").map((w) => waveRun(w, rows)),
|
|
124
|
+
...rows.drift.map(driftRun),
|
|
125
|
+
]
|
|
126
|
+
.filter((r) => members.includes(r.project))
|
|
127
|
+
.sort((a, b) => at(b.finished) - at(a.finished))
|
|
128
|
+
.slice(0, RECENT_RUNS);
|
|
129
|
+
const ephemeral = projects.reduce((n, p) => n + (p.ephemeral?.length ?? 0), 0);
|
|
130
|
+
return {
|
|
131
|
+
schema: estateSchema(options.words),
|
|
132
|
+
generated: now.toISOString(),
|
|
133
|
+
source: "ledger",
|
|
134
|
+
totals: {
|
|
135
|
+
projects: projects.length,
|
|
136
|
+
waiting: projects.reduce((n, p) => n + p.waiting.length, 0),
|
|
137
|
+
drifted_projects: projects.filter((p) => p.drifted > 0).length,
|
|
138
|
+
drifted_roots: projects.reduce((n, p) => n + p.drifted, 0),
|
|
139
|
+
failed_roots: projects.reduce((n, p) => n + p.failed, 0),
|
|
140
|
+
unreadable: Object.values(options.malformed ?? {}).reduce((n, x) => n + x, 0),
|
|
141
|
+
overdue: projects.reduce((n, p) => n + (p.overdue?.length ?? 0), 0),
|
|
142
|
+
...(ephemeral ? { ephemeral } : {}),
|
|
143
|
+
},
|
|
144
|
+
projects,
|
|
145
|
+
recent,
|
|
146
|
+
...(dora ? { dora: { file: DORA_FILE, generated: dora.generated, deployments: dora.estate.deployments } } : {}),
|
|
147
|
+
};
|
|
148
|
+
}
|
|
149
|
+
// ── the page ────────────────────────────────────────────────────────────────
|
|
150
|
+
/** HTML text escaped. */
|
|
151
|
+
export const esc = (s) => s.replace(/&/g, "&").replace(/</g, "<").replace(/>/g, ">").replace(/"/g, """);
|
|
152
|
+
const rate = (r) => (r === null ? "none" : `${Math.round(r * 1000) / 10}%`);
|
|
153
|
+
function doraRow(name, m) {
|
|
154
|
+
const l = m.lead_time;
|
|
155
|
+
const split = l.changes ? `<br><small>before the gate ${duration(l.before_gate_seconds)}, at the gate ${duration(l.at_gate_seconds)}, after it ${duration(l.after_gate_seconds)}</small>` : "";
|
|
156
|
+
const c = m.change_failure;
|
|
157
|
+
const r = m.restore;
|
|
158
|
+
return `<tr><td>${name}</td><td>${m.per_week} <small>(${m.deployments} in ${spanLabel(m.span_seconds)})</small></td><td>${duration(l.median_seconds)}${split}</td><td>${rate(c.rate)} <small>(${c.failed} failed, ${c.drifted} drifted, of ${c.applies})</small></td><td>${duration(r.median_seconds)} <small>(${r.restored} restored${r.open ? `, <span class="warn">${r.open} open</span>` : ""})</small></td></tr>`;
|
|
159
|
+
}
|
|
160
|
+
/** The delivery section: the definitions, each member's numbers and the estate's, and a row per week. terragucci's renderDoraSection. */
|
|
161
|
+
export function renderDeliverySection(dora, link = esc) {
|
|
162
|
+
const weeks = dora.estate.trend.map((w) => `<tr><td>${esc(w.week)}</td><td>${w.deployments}</td><td>${w.applies}</td><td>${w.failures}</td><td>${duration(w.lead_time_seconds)}</td><td>${duration(w.restore_seconds)}</td></tr>`);
|
|
163
|
+
return `<p>The newest ${dora.weeks} weeks, from the workspace ledger${dora.audit ? "" : `. <span class="warn">The ledger holds no apply record yet, so only drift counts.</span>`}</p>
|
|
164
|
+
<dl class="defs">
|
|
165
|
+
<dt>Deployment frequency</dt><dd>Applied waves per week, over the span the history covers: from now back to the oldest apply, or to the window's start when the history is older, and at least a day. Beside each rate is the span it divides by. Infrastructure ships less often than an application, so read it as a trend rather than against a tier.</dd>
|
|
166
|
+
<dt>Lead time</dt><dd>The median time from a change's first plan to its wave applied: before the gate (the plan to the wave reaching its gate, or to the apply when no gate held it), at the gate (until the approval), and after it (until applied).</dd>
|
|
167
|
+
<dt>Change failure rate</dt><dd>Failed applies, plus applied waves whose targets drifted within ${duration(dora.drift_window_seconds)}, over all applies. A refused wave is the gate working and does not count.</dd>
|
|
168
|
+
<dt>Time to restore</dt><dd>The median time from a failed apply to the next apply of those targets, and from drift found to the next drift check that found none.</dd>
|
|
169
|
+
</dl>
|
|
170
|
+
<div class="scroll"><table id="dora"><tr><th>Member</th><th>Deployments per week</th><th>Lead time</th><th>Change failure rate</th><th>Time to restore</th></tr>
|
|
171
|
+
${[doraRow("<b>Estate</b>", dora.estate), ...dora.projects.map((p) => doraRow(link(p.project), p))].join("\n")}
|
|
172
|
+
</table></div>
|
|
173
|
+
<h3>By week</h3>
|
|
174
|
+
<div class="scroll"><table id="dora-weeks"><tr><th>Week of</th><th>Deployments</th><th>Applies</th><th>Failed changes</th><th>Lead time</th><th>Time to restore</th></tr>
|
|
175
|
+
${weeks.join("\n")}
|
|
176
|
+
</table></div>`;
|
|
177
|
+
}
|
|
178
|
+
const CSS = `body{font:14px/1.45 system-ui,sans-serif;margin:0 auto;padding:16px;max-width:1100px;color:#1d1d1f;background:#fff}
|
|
179
|
+
h1{font-size:22px}h2{font-size:18px;margin-top:28px}h3{font-size:15px}
|
|
180
|
+
table{border-collapse:collapse;width:100%}td,th{border-bottom:1px solid #ddd;padding:4px 8px;text-align:left;vertical-align:top}
|
|
181
|
+
.scroll{overflow-x:auto}.warn{color:#b42318}.ok{color:#067647}small{color:#555}
|
|
182
|
+
dl.defs dt{font-weight:600;margin-top:6px}dl.defs dd{margin-left:16px}
|
|
183
|
+
section.member{border-top:2px solid #eee;margin-top:20px}
|
|
184
|
+
@media (prefers-color-scheme:dark){body{color:#eee;background:#141414}td,th{border-color:#333}small{color:#aaa}section.member{border-color:#333}.warn{color:#f97066}.ok{color:#47cd89}}`;
|
|
185
|
+
const shortSha = (s) => esc(s.slice(0, 12));
|
|
186
|
+
function runCells(r) {
|
|
187
|
+
const what = r.wave !== undefined ? `${esc(r.stage)} wave ${r.wave}${r.share !== undefined ? ` share ${r.share}` : ""}` : esc(r.stage);
|
|
188
|
+
const state = r.approval === "waiting" ? `<span class="warn">waiting since ${esc(r.waiting_since ?? r.finished)}</span>` : r.failed ? `<span class="warn">${r.failed} failed</span>` : esc(r.status);
|
|
189
|
+
const job = r.job_url ? ` <a href="${esc(r.job_url)}">job</a>` : "";
|
|
190
|
+
return `<td>${what}</td><td>${shortSha(r.commit)}</td><td>${esc(r.finished)}</td><td>${r.changed ?? 0} of ${r.roots}${r.refused ? `, ${r.refused} moved` : ""}</td><td>${state}${job}</td>`;
|
|
191
|
+
}
|
|
192
|
+
function memberHtml(p, words, extra) {
|
|
193
|
+
const parts = [`<section class="member" id="${esc(`member-${p.project}`)}"><h2>${esc(p.project)}</h2>`];
|
|
194
|
+
if (p.status === "no-index")
|
|
195
|
+
parts.push(`<p>The ledger holds no run for this ${esc(words.noun[0])} yet.</p>`);
|
|
196
|
+
for (const o of p.overdue ?? [])
|
|
197
|
+
parts.push(`<p class="warn">${esc(o.message)}</p>`);
|
|
198
|
+
if (p.waiting.length)
|
|
199
|
+
parts.push(`<ul>${p.waiting.map((w) => `<li class="warn">wave ${w.wave} waits${w.gate ? ` at ${esc(w.gate)}` : ""}, for ${duration(w.age_seconds)}</li>`).join("")}</ul>`);
|
|
200
|
+
if (p.apply) {
|
|
201
|
+
parts.push(`<h3>Waves of ${shortSha(p.apply.commit)}</h3><div class="scroll"><table><tr><th>Wave</th><th>Commit</th><th>Finished</th><th>Applied</th><th>State</th></tr>`);
|
|
202
|
+
for (const w of p.apply.waves)
|
|
203
|
+
parts.push(`<tr>${runCells(w)}</tr>`);
|
|
204
|
+
parts.push(`</table></div>`);
|
|
205
|
+
}
|
|
206
|
+
if (p.drift)
|
|
207
|
+
parts.push(`<p>Newest drift check: ${esc(p.drift.stage)} at ${esc(p.drift.finished)}, ${p.drifted ? `<span class="warn">${p.drifted} drifted</span>` : `<span class="ok">no drift</span>`}${p.drift.job_url ? ` <a href="${esc(p.drift.job_url)}">job</a>` : ""}.</p>`);
|
|
208
|
+
if (p.ephemeral?.length)
|
|
209
|
+
parts.push(`<h3>Pull request environments</h3><ul>${p.ephemeral.map((e) => `<li>${esc(e.env)} (pull request ${e.pr})${e.expires ? `, expires ${esc(e.expires)}` : ""}</li>`).join("")}</ul>`);
|
|
210
|
+
if (extra)
|
|
211
|
+
parts.push(extra(p));
|
|
212
|
+
parts.push(`</section>`);
|
|
213
|
+
return parts.join("\n");
|
|
214
|
+
}
|
|
215
|
+
/** The page: a summary, a section per member, the newest runs, the delivery metrics and the product's own sections. */
|
|
216
|
+
export function renderEstateHtml(estate, dora, words = CHANT_WORDS, sections = {}) {
|
|
217
|
+
const t = estate.totals;
|
|
218
|
+
const link = (project) => `<a href="#${esc(`member-${project}`)}">${esc(project)}</a>`;
|
|
219
|
+
const summary = `<p>${t.projects} ${esc(t.projects === 1 ? words.noun[0] : words.noun[1])}, ${t.waiting} waiting, ${t.drifted_projects} drifted, ${t.failed_roots} failed, ${t.overdue} overdue drift checks. Built ${esc(estate.generated)} from the workspace ledger.</p>`;
|
|
220
|
+
const recent = `<h2>Newest runs</h2><div class="scroll"><table><tr><th>${esc(words.noun[0])}</th><th>Run</th><th>Commit</th><th>Finished</th><th>Applied</th><th>State</th></tr>
|
|
221
|
+
${estate.recent.map((r) => `<tr><td>${link(r.project)}</td>${runCells(r)}</tr>`).join("\n")}
|
|
222
|
+
</table></div>`;
|
|
223
|
+
return `<!doctype html>
|
|
224
|
+
<html lang="en"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>${esc(words.product)} estate</title><style>${CSS}</style></head>
|
|
225
|
+
<body><h1>${esc(words.product)} estate</h1>
|
|
226
|
+
${summary}
|
|
227
|
+
${estate.projects.map((p) => memberHtml(p, words, sections.member)).join("\n")}
|
|
228
|
+
${recent}
|
|
229
|
+
${dora ? `<h2>Delivery</h2>\n${renderDeliverySection(dora, link)}` : ""}
|
|
230
|
+
${(sections.sections ?? []).map((s) => `<h2>${esc(s.title)}</h2>\n${s.html}`).join("\n")}
|
|
231
|
+
</body></html>
|
|
232
|
+
`;
|
|
233
|
+
}
|
|
@@ -0,0 +1,118 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The ledger rows the estate reads (#4612), read once from the tables of
|
|
3
|
+
* the read contract (`../lifecycle/query.ts`): `runs`, `gates`, `applies`
|
|
4
|
+
* and `pr_envs`. Every reader in this directory takes the same
|
|
5
|
+
* {@link EstateRows}, so a Terraform member and a Pulumi member go through
|
|
6
|
+
* one code path: both apply through `chant run wave`, whose job writes one
|
|
7
|
+
* run record with its `wave` field (#4551), and both record drift as a run
|
|
8
|
+
* whose `Drift` outcome says what it found.
|
|
9
|
+
*
|
|
10
|
+
* Nothing here reads git or a bucket. The caller loads the tables with
|
|
11
|
+
* `loadQueryData` (or {@link readEstateLedger} in ../ci-estate.ts), or
|
|
12
|
+
* builds them by hand in a test.
|
|
13
|
+
*/
|
|
14
|
+
import type { QueryData } from "../lifecycle/query.js";
|
|
15
|
+
import { type OpRunWave } from "../op/runtime.js";
|
|
16
|
+
/** The tables the estate reads. A full `QueryData` is one. */
|
|
17
|
+
export type EstateTables = Pick<QueryData, "runs" | "gates" | "applies" | "pr_envs">;
|
|
18
|
+
/** How the rows are read. */
|
|
19
|
+
export interface EstateRowOptions {
|
|
20
|
+
/** The name of a ledger read outside a workspace, whose rows have `member` NULL. Default `default`. */
|
|
21
|
+
project?: string;
|
|
22
|
+
/**
|
|
23
|
+
* Ops whose runs are drift checks. Default: a run whose labels carry
|
|
24
|
+
* `Watch=true` (a WatchOp) or whose outcomes carry a boolean `Drift`.
|
|
25
|
+
*/
|
|
26
|
+
driftOps?: readonly string[];
|
|
27
|
+
/**
|
|
28
|
+
* Ops whose plain runs (not op wave jobs) count as applies: an `ok` run
|
|
29
|
+
* applied, a `fail` run failed. Default none, since an op wave job already
|
|
30
|
+
* records each apply with its targets.
|
|
31
|
+
*/
|
|
32
|
+
deployOps?: readonly string[];
|
|
33
|
+
}
|
|
34
|
+
/** One op wave job that applied or tried to, from its run record. */
|
|
35
|
+
export interface WaveJob {
|
|
36
|
+
member: string;
|
|
37
|
+
id: string;
|
|
38
|
+
spec: string;
|
|
39
|
+
wave: number;
|
|
40
|
+
name: string;
|
|
41
|
+
job: OpRunWave["job"];
|
|
42
|
+
share?: number;
|
|
43
|
+
group?: string;
|
|
44
|
+
digest?: string;
|
|
45
|
+
status: string;
|
|
46
|
+
started: string;
|
|
47
|
+
ended: string;
|
|
48
|
+
commit?: string;
|
|
49
|
+
runUrl?: string;
|
|
50
|
+
applied: string[];
|
|
51
|
+
failed: string[];
|
|
52
|
+
moved: string[];
|
|
53
|
+
blocked: string[];
|
|
54
|
+
outcome?: OpRunWave["outcome"];
|
|
55
|
+
/** The gate the job waited at, when it did. */
|
|
56
|
+
gate?: string;
|
|
57
|
+
}
|
|
58
|
+
/** One drift check, from its run record. */
|
|
59
|
+
export interface DriftRun {
|
|
60
|
+
member: string;
|
|
61
|
+
id: string;
|
|
62
|
+
op: string;
|
|
63
|
+
status: string;
|
|
64
|
+
started: string;
|
|
65
|
+
ended: string;
|
|
66
|
+
/** What the check found: `true` drift, `false` none, undefined when it says nothing (a failed check). */
|
|
67
|
+
drifted?: boolean;
|
|
68
|
+
/** The roots or stacks it found drifted, from a `DriftedRoots` outcome; empty means any of the member's. */
|
|
69
|
+
roots: string[];
|
|
70
|
+
commit?: string;
|
|
71
|
+
runUrl?: string;
|
|
72
|
+
}
|
|
73
|
+
/** A gate ledger line. */
|
|
74
|
+
export interface GateLine {
|
|
75
|
+
member: string;
|
|
76
|
+
op: string;
|
|
77
|
+
gate: string;
|
|
78
|
+
kind: "pending" | "resolution";
|
|
79
|
+
timestamp: string;
|
|
80
|
+
planDigest?: string;
|
|
81
|
+
resolvedBy?: string;
|
|
82
|
+
commit?: string;
|
|
83
|
+
}
|
|
84
|
+
/** An apply under an approval, from `_gates/<op>/applied.jsonl`. */
|
|
85
|
+
export interface ApprovedApply {
|
|
86
|
+
member: string;
|
|
87
|
+
op: string;
|
|
88
|
+
gate: string;
|
|
89
|
+
planDigest: string;
|
|
90
|
+
approvedAt: string;
|
|
91
|
+
approvedBy?: string;
|
|
92
|
+
timestamp: string;
|
|
93
|
+
result?: string;
|
|
94
|
+
}
|
|
95
|
+
/** A pull request environment line. */
|
|
96
|
+
export interface PrEnvLine {
|
|
97
|
+
member: string;
|
|
98
|
+
kind: "up" | "down";
|
|
99
|
+
pr: number;
|
|
100
|
+
env: string;
|
|
101
|
+
result?: string;
|
|
102
|
+
commit?: string;
|
|
103
|
+
timestamp: string;
|
|
104
|
+
expiresAt?: string;
|
|
105
|
+
runUrl?: string;
|
|
106
|
+
}
|
|
107
|
+
/** The rows, read. */
|
|
108
|
+
export interface EstateRows {
|
|
109
|
+
members: string[];
|
|
110
|
+
waves: WaveJob[];
|
|
111
|
+
drift: DriftRun[];
|
|
112
|
+
gates: GateLine[];
|
|
113
|
+
approved: ApprovedApply[];
|
|
114
|
+
prEnvs: PrEnvLine[];
|
|
115
|
+
}
|
|
116
|
+
/** Read the tables into the shapes the estate uses. Malformed JSON cells read as absent. */
|
|
117
|
+
export declare function estateRows(tables: EstateTables, options?: EstateRowOptions): EstateRows;
|
|
118
|
+
//# sourceMappingURL=rows.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"rows.d.ts","sourceRoot":"","sources":["../../src/ci-estate/rows.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,126 @@
|
|
|
1
|
+
import { opRunWaveOf } from "../op/runtime.js";
|
|
2
|
+
const str = (v) => (typeof v === "string" && v !== "" ? v : undefined);
|
|
3
|
+
function parsed(v) {
|
|
4
|
+
if (typeof v !== "string")
|
|
5
|
+
return undefined;
|
|
6
|
+
try {
|
|
7
|
+
return JSON.parse(v);
|
|
8
|
+
}
|
|
9
|
+
catch {
|
|
10
|
+
return undefined;
|
|
11
|
+
}
|
|
12
|
+
}
|
|
13
|
+
const record = (v) => (v && typeof v === "object" && !Array.isArray(v) ? v : {});
|
|
14
|
+
const strings = (v) => (Array.isArray(v) ? v.filter((x) => typeof x === "string") : []);
|
|
15
|
+
/** The member a row belongs to: the member whose root it applied when the run names one, else the ledger's. */
|
|
16
|
+
function memberOf(row, project) {
|
|
17
|
+
return str(row.root_member) ?? str(row.member) ?? project;
|
|
18
|
+
}
|
|
19
|
+
/** Whether a run is a drift check. */
|
|
20
|
+
function isDrift(row, driftOps) {
|
|
21
|
+
if (driftOps)
|
|
22
|
+
return driftOps.includes(String(row.op));
|
|
23
|
+
const labels = record(parsed(row.labels));
|
|
24
|
+
const outcomes = record(parsed(row.outcomes));
|
|
25
|
+
return labels.Watch === "true" || typeof outcomes.Drift === "boolean";
|
|
26
|
+
}
|
|
27
|
+
/** Read the tables into the shapes the estate uses. Malformed JSON cells read as absent. */
|
|
28
|
+
export function estateRows(tables, options = {}) {
|
|
29
|
+
const project = options.project ?? "default";
|
|
30
|
+
const waves = [];
|
|
31
|
+
const drift = [];
|
|
32
|
+
for (const r of tables.runs) {
|
|
33
|
+
const member = memberOf(r, project);
|
|
34
|
+
const started = str(r.started) ?? "";
|
|
35
|
+
const ended = str(r.ended) ?? started;
|
|
36
|
+
const status = str(r.status) ?? "fail";
|
|
37
|
+
const at = { ...(str(r.git_sha) ? { commit: str(r.git_sha) } : {}), ...(str(r.run_url) ? { runUrl: str(r.run_url) } : {}) };
|
|
38
|
+
const wave = opRunWaveOf(parsed(r.wave));
|
|
39
|
+
if (wave) {
|
|
40
|
+
if (wave.job === "decide") {
|
|
41
|
+
// A deciding job applies nothing; its time is when the wave was first planned.
|
|
42
|
+
waves.push({ member, id: String(r.id), spec: wave.spec, wave: wave.number, name: wave.name, job: wave.job, ...(wave.digest ? { digest: wave.digest } : {}), status, started, ended, ...at, applied: [], failed: [], moved: [], blocked: [] });
|
|
43
|
+
continue;
|
|
44
|
+
}
|
|
45
|
+
waves.push({
|
|
46
|
+
member,
|
|
47
|
+
id: String(r.id),
|
|
48
|
+
spec: wave.spec,
|
|
49
|
+
wave: wave.number,
|
|
50
|
+
name: wave.name,
|
|
51
|
+
job: wave.job,
|
|
52
|
+
...(wave.share !== undefined ? { share: wave.share } : {}),
|
|
53
|
+
...(wave.group !== undefined ? { group: wave.group } : {}),
|
|
54
|
+
...(wave.digest ? { digest: wave.digest } : {}),
|
|
55
|
+
status,
|
|
56
|
+
started,
|
|
57
|
+
ended,
|
|
58
|
+
...at,
|
|
59
|
+
applied: [...wave.applied],
|
|
60
|
+
failed: [...wave.failed],
|
|
61
|
+
moved: [...wave.moved],
|
|
62
|
+
blocked: Object.keys(wave.blocked ?? {}),
|
|
63
|
+
...(wave.outcome ? { outcome: wave.outcome } : {}),
|
|
64
|
+
...(str(r.gate) ? { gate: str(r.gate) } : {}),
|
|
65
|
+
});
|
|
66
|
+
continue;
|
|
67
|
+
}
|
|
68
|
+
if (isDrift(r, options.driftOps)) {
|
|
69
|
+
const outcomes = record(parsed(r.outcomes));
|
|
70
|
+
drift.push({
|
|
71
|
+
member,
|
|
72
|
+
id: String(r.id),
|
|
73
|
+
op: String(r.op),
|
|
74
|
+
status,
|
|
75
|
+
started,
|
|
76
|
+
ended,
|
|
77
|
+
...(typeof outcomes.Drift === "boolean" ? { drifted: outcomes.Drift } : {}),
|
|
78
|
+
roots: strings(outcomes.DriftedRoots),
|
|
79
|
+
...at,
|
|
80
|
+
});
|
|
81
|
+
continue;
|
|
82
|
+
}
|
|
83
|
+
if (options.deployOps?.includes(String(r.op)) && (status === "ok" || status === "fail")) {
|
|
84
|
+
// A plain apply Op: one target, the member's root.
|
|
85
|
+
const target = str(r.root_member) ?? String(r.op);
|
|
86
|
+
waves.push({ member, id: String(r.id), spec: String(r.op), wave: 1, name: String(r.op), job: "wave", status, started, ended, ...at, applied: status === "ok" ? [target] : [], failed: status === "fail" ? [target] : [], moved: [], blocked: [] });
|
|
87
|
+
}
|
|
88
|
+
}
|
|
89
|
+
const gates = tables.gates.map((g) => ({
|
|
90
|
+
member: memberOf(g, project),
|
|
91
|
+
op: String(g.op),
|
|
92
|
+
gate: String(g.gate),
|
|
93
|
+
kind: g.kind === "pending" ? "pending" : "resolution",
|
|
94
|
+
timestamp: str(g.timestamp) ?? "",
|
|
95
|
+
...(str(g.plan_digest) ? { planDigest: str(g.plan_digest) } : {}),
|
|
96
|
+
...(str(g.resolved_by) ? { resolvedBy: str(g.resolved_by) } : {}),
|
|
97
|
+
...(str(g.git_sha) ? { commit: str(g.git_sha) } : {}),
|
|
98
|
+
}));
|
|
99
|
+
const approved = tables.applies
|
|
100
|
+
.filter((a) => str(a.plan_digest) && str(a.approved_at))
|
|
101
|
+
.map((a) => ({
|
|
102
|
+
member: memberOf(a, project),
|
|
103
|
+
op: String(a.op),
|
|
104
|
+
gate: String(a.gate),
|
|
105
|
+
planDigest: str(a.plan_digest),
|
|
106
|
+
approvedAt: str(a.approved_at),
|
|
107
|
+
...(str(a.approved_by) ? { approvedBy: str(a.approved_by) } : {}),
|
|
108
|
+
timestamp: str(a.timestamp) ?? str(a.approved_at),
|
|
109
|
+
...(str(a.result) ? { result: str(a.result) } : {}),
|
|
110
|
+
}));
|
|
111
|
+
const prEnvs = tables.pr_envs
|
|
112
|
+
.filter((p) => (p.kind === "up" || p.kind === "down") && typeof p.pr === "number")
|
|
113
|
+
.map((p) => ({
|
|
114
|
+
member: str(p.env_member) ?? memberOf(p, project),
|
|
115
|
+
kind: p.kind,
|
|
116
|
+
pr: p.pr,
|
|
117
|
+
env: String(p.env),
|
|
118
|
+
...(str(p.result) ? { result: str(p.result) } : {}),
|
|
119
|
+
...(str(p.git_sha) ? { commit: str(p.git_sha) } : {}),
|
|
120
|
+
timestamp: str(p.timestamp) ?? "",
|
|
121
|
+
...(str(p.expires_at) ? { expiresAt: str(p.expires_at) } : {}),
|
|
122
|
+
...(str(p.run_url) ? { runUrl: str(p.run_url) } : {}),
|
|
123
|
+
}));
|
|
124
|
+
const members = [...new Set([...waves, ...drift, ...gates, ...approved, ...prEnvs].map((x) => x.member))].sort();
|
|
125
|
+
return { members, waves, drift, gates, approved, prEnvs };
|
|
126
|
+
}
|
|
@@ -0,0 +1,92 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* `@intentius/chant/ci-estate` (#4612): the estate page, overdue drift
|
|
3
|
+
* checks and delivery metrics, shared by the CI products built on chant
|
|
4
|
+
* (terragucci, plywood, sql-yodeler).
|
|
5
|
+
*
|
|
6
|
+
* Everything is read from the workspace ledger through the read contract's
|
|
7
|
+
* tables (`runs`, `gates`, `applies`, `pr_envs`; ./lifecycle/query.ts), so
|
|
8
|
+
* a Terraform member and a Pulumi member come out of the same code:
|
|
9
|
+
*
|
|
10
|
+
* - {@link ledgerOverdue}: each member whose scheduled drift check missed
|
|
11
|
+
* its window, by chant's two-fires rule, in the product's words.
|
|
12
|
+
* - {@link buildDelivery}: the four DORA metrics, written as `dora.json` in
|
|
13
|
+
* terragucci's shape, and {@link deliveryGauges} for OTLP
|
|
14
|
+
* ({@link sendOtlpGauges}, ./otlp-metrics.ts).
|
|
15
|
+
* - {@link buildEstate} and {@link renderEstateHtml}: `estate.json` and
|
|
16
|
+
* `estate.html`, a section per member, with room for a product's own
|
|
17
|
+
* sections.
|
|
18
|
+
* - {@link writeEstate}: all three files to the report store (`ci.reportUrl`,
|
|
19
|
+
* ./pr-report-url.ts, #4554), and the gauges when an endpoint is set.
|
|
20
|
+
*
|
|
21
|
+
* A product feature-detects this entry until the chant release that carries
|
|
22
|
+
* {@link CI_ESTATE_FLOOR} is its floor: `buildLedgerEstate` present means the
|
|
23
|
+
* rest is too. Before it, the product keeps its own estate code.
|
|
24
|
+
*/
|
|
25
|
+
import { type CiProductWords } from "./ci-product-words.js";
|
|
26
|
+
import type { QueryLoad } from "./lifecycle/query.js";
|
|
27
|
+
import type { ReportPut } from "./pr-report-url.js";
|
|
28
|
+
import { type OtlpGaugesSent } from "./otlp-metrics.js";
|
|
29
|
+
import type { OtlpFetch } from "./otlp.js";
|
|
30
|
+
import { type Dora } from "./ci-estate/delivery.js";
|
|
31
|
+
import { type DriftSchedule, type LedgerOverdue } from "./ci-estate/overdue.js";
|
|
32
|
+
import { type Estate, type EstateSections } from "./ci-estate/page.js";
|
|
33
|
+
import { type EstateRowOptions, type EstateRows, type EstateTables } from "./ci-estate/rows.js";
|
|
34
|
+
/** The first chant with `@intentius/chant/ci-estate` (#4612). */
|
|
35
|
+
export declare const CI_ESTATE_FLOOR = "0.124.55";
|
|
36
|
+
export { estateRows, type ApprovedApply, type DriftRun, type EstateRowOptions, type EstateRows, type EstateTables, type GateLine, type PrEnvLine, type WaveJob } from "./ci-estate/rows.js";
|
|
37
|
+
export { appliesOf, buildDelivery, deliveryGauges, doraMetricNames, doraSchema, driftIncidents, duration, median, spanLabel, weekStart, DORA_FILE, DORA_MIN_SPAN_SECONDS, DORA_WEEKS, DRIFT_WINDOW_SECONDS, type DeliveryGauge, type DeliveryOptions, type Dora, type DoraLeadTime, type DoraMetrics, type DoraProject, type DoraWeek, type DriftIncident, } from "./ci-estate/delivery.js";
|
|
38
|
+
export { ledgerOverdue, type DriftSchedule, type LedgerOverdue, type LedgerOverdueOptions } from "./ci-estate/overdue.js";
|
|
39
|
+
export { buildEstate, esc, estateSchema, memberState, renderDeliverySection, renderEstateHtml, ESTATE_FILES, RECENT_RUNS, type Estate, type EstateOptions, type EstatePrEnv, type EstateProject, type EstateRun, type EstateSections, type EstateWaiting, } from "./ci-estate/page.js";
|
|
40
|
+
export { otlpMetricsBody, otlpMetricsFromEnv, sendOtlpGauges, type OtlpGauge, type OtlpGaugesSent, type OtlpMetricsConfig } from "./otlp-metrics.js";
|
|
41
|
+
export interface LedgerEstateInput extends EstateRowOptions {
|
|
42
|
+
/** The tables, as `loadQueryData` returned them (a `QueryLoad`), or the tables alone. */
|
|
43
|
+
load: QueryLoad | EstateTables;
|
|
44
|
+
words?: Pick<CiProductWords, "product" | "stages" | "noun">;
|
|
45
|
+
now?: Date;
|
|
46
|
+
/** The members, in order. Default every member the ledger names. */
|
|
47
|
+
members?: readonly string[];
|
|
48
|
+
/** The scheduled drift checks to judge. Default none. */
|
|
49
|
+
schedules?: readonly DriftSchedule[];
|
|
50
|
+
/** When a member's schedule began, for one with no check on record. */
|
|
51
|
+
added?: (op: string, member: string) => string | undefined;
|
|
52
|
+
/** A commit's time in milliseconds, or null; given, a change's lead time starts no later than its commit. */
|
|
53
|
+
commitTime?: (commit: string) => number | null;
|
|
54
|
+
}
|
|
55
|
+
export interface LedgerEstate {
|
|
56
|
+
rows: EstateRows;
|
|
57
|
+
estate: Estate;
|
|
58
|
+
dora: Dora;
|
|
59
|
+
overdue: LedgerOverdue[];
|
|
60
|
+
}
|
|
61
|
+
/** The estate, the metrics and the overdue checks from one read of the ledger. */
|
|
62
|
+
export declare function buildLedgerEstate(input: LedgerEstateInput): LedgerEstate;
|
|
63
|
+
/** The three files by name: `estate.json`, `estate.html` and `dora.json`. */
|
|
64
|
+
export declare function estateFiles(e: Pick<LedgerEstate, "estate" | "dora">, words?: Pick<CiProductWords, "product" | "noun">, sections?: EstateSections): Record<string, string>;
|
|
65
|
+
export interface WriteEstateOptions {
|
|
66
|
+
/** The report store's put (`reportPut(parseReportUrl(ci.reportUrl))`). */
|
|
67
|
+
put: ReportPut;
|
|
68
|
+
/** The key prefix below the report URL. Default `estate`. */
|
|
69
|
+
prefix?: string;
|
|
70
|
+
words?: Pick<CiProductWords, "product" | "noun">;
|
|
71
|
+
sections?: EstateSections;
|
|
72
|
+
/** Files a product adds beside the three, by name. */
|
|
73
|
+
extra?: Record<string, string>;
|
|
74
|
+
/** The environment the OTLP endpoint is read from. Default `process.env`. */
|
|
75
|
+
env?: NodeJS.ProcessEnv;
|
|
76
|
+
fetch?: OtlpFetch;
|
|
77
|
+
}
|
|
78
|
+
export interface WriteEstateResult {
|
|
79
|
+
/** The keys written, below the report URL. */
|
|
80
|
+
keys: string[];
|
|
81
|
+
/** The gauges: sent, or why not. Absent when no metrics endpoint is set. */
|
|
82
|
+
metrics?: OtlpGaugesSent;
|
|
83
|
+
}
|
|
84
|
+
/** Write the page, its JSON and `dora.json` to the report store, and send the gauges when an endpoint is set. */
|
|
85
|
+
export declare function writeEstate(e: Pick<LedgerEstate, "estate" | "dora">, options: WriteEstateOptions): Promise<WriteEstateResult>;
|
|
86
|
+
/**
|
|
87
|
+
* Load the tables from the ledgers at `cwd`: every member's in a workspace,
|
|
88
|
+
* else the project's own, from the local `chant/lifecycle` branch, as
|
|
89
|
+
* `chant query` reads them. It never fetches.
|
|
90
|
+
*/
|
|
91
|
+
export declare function readEstateLedger(cwd: string, members?: readonly string[]): Promise<QueryLoad>;
|
|
92
|
+
//# sourceMappingURL=ci-estate.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"ci-estate.d.ts","sourceRoot":"","sources":["../src/ci-estate.ts"],"names":[],"mappings":"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"}
|