@intentius/chant 0.124.55 → 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/ci-agent.d.ts.map +1 -1
- package/dist/ci-agent.js +1 -2
- 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.map +1 -1
- package/dist/ci-control.js +3 -4
- package/dist/ci-estate.d.ts +24 -0
- package/dist/ci-estate.d.ts.map +1 -1
- package/dist/ci-estate.js +1 -2
- package/dist/ci-identity.d.ts.map +1 -1
- package/dist/ci-identity.js +2 -3
- 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 +7 -1
- package/dist/ci-product-words.d.ts.map +1 -1
- package/dist/ci-product-words.js +38 -4
- package/dist/ci-product.d.ts +35 -0
- package/dist/ci-product.d.ts.map +1 -1
- package/dist/ci-product.js +38 -3
- 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/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 +81 -0
- 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.map +1 -1
- package/dist/cli/handlers/ci-check.js +38 -9
- 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/pr.d.ts +5 -0
- package/dist/cli/handlers/pr.d.ts.map +1 -1
- package/dist/cli/handlers/pr.js +259 -4
- package/dist/cli/handlers/run-wave.js +89 -1
- package/dist/cli/main.d.ts.map +1 -1
- package/dist/cli/main.js +56 -2
- package/dist/cli/parse-args.d.ts.map +1 -1
- package/dist/cli/parse-args.js +107 -0
- package/dist/cli/registry.d.ts +38 -0
- package/dist/cli/registry.d.ts.map +1 -1
- package/dist/components/adoption.d.ts.map +1 -1
- package/dist/components/adoption.js +1 -2
- package/dist/components/capability.d.ts +37 -0
- package/dist/components/capability.d.ts.map +1 -1
- package/dist/components/capability.js +25 -0
- package/dist/components/check-hooks.d.ts +4 -1
- package/dist/components/check-hooks.d.ts.map +1 -1
- 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.map +1 -1
- package/dist/components/ci-services.js +1 -2
- package/dist/components/driver.d.ts +12 -0
- package/dist/components/driver.d.ts.map +1 -1
- package/dist/components/driver.js +35 -1
- package/dist/components/groups.d.ts.map +1 -1
- package/dist/components/groups.js +4 -3
- package/dist/components/pr-env-ledger.d.ts.map +1 -1
- package/dist/components/pr-env-ledger.js +1 -2
- package/dist/components/pr-environment.d.ts +1 -1
- package/dist/components/pr-environment.d.ts.map +1 -1
- package/dist/components/pr-environment.js +1 -1
- package/dist/components/pr-pipeline.d.ts +129 -3
- package/dist/components/pr-pipeline.d.ts.map +1 -1
- package/dist/components/pr-pipeline.js +153 -17
- package/dist/components/pr-run.d.ts +8 -0
- package/dist/components/pr-run.d.ts.map +1 -1
- package/dist/components/pr-run.js +9 -4
- package/dist/components/product-pipeline.d.ts +35 -2
- package/dist/components/product-pipeline.d.ts.map +1 -1
- package/dist/components/product-pipeline.js +24 -5
- package/dist/components/wave-plan.d.ts +8 -0
- package/dist/components/wave-plan.d.ts.map +1 -1
- package/dist/components/wave-plan.js +18 -2
- 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/exit-codes.d.ts +7 -1
- package/dist/exit-codes.d.ts.map +1 -1
- package/dist/exit-codes.js +7 -1
- package/dist/lexicon.d.ts +46 -0
- package/dist/lexicon.d.ts.map +1 -1
- package/dist/lifecycle/gate-ledger.d.ts.map +1 -1
- package/dist/lifecycle/gate-ledger.js +2 -3
- package/dist/lifecycle/gated-request.d.ts.map +1 -1
- package/dist/lifecycle/gated-request.js +1 -2
- package/dist/lifecycle/query.d.ts.map +1 -1
- package/dist/lifecycle/query.js +4 -5
- package/dist/lifecycle/release-catalog.d.ts.map +1 -1
- package/dist/lifecycle/release-catalog.js +1 -1
- package/dist/lifecycle/release-ledger.d.ts.map +1 -1
- package/dist/lifecycle/release-ledger.js +1 -2
- package/dist/lifecycle/release-status.d.ts +20 -0
- package/dist/lifecycle/release-status.d.ts.map +1 -1
- package/dist/lifecycle/release-status.js +1 -22
- 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/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/index.d.ts +1 -1
- package/dist/op/index.d.ts.map +1 -1
- package/dist/op/index.js +1 -1
- package/dist/op/op-waves-capability-spec.d.ts +8 -0
- package/dist/op/op-waves-capability-spec.d.ts.map +1 -1
- package/dist/op/op-waves-capability-spec.js +21 -0
- package/dist/op/op-waves-release.d.ts.map +1 -1
- package/dist/op/op-waves-release.js +1 -2
- package/dist/op/op-waves-run.d.ts +7 -2
- package/dist/op/op-waves-run.d.ts.map +1 -1
- package/dist/op/op-waves-run.js +96 -4
- package/dist/op/op-waves-stand-down.d.ts.map +1 -1
- package/dist/op/op-waves-stand-down.js +1 -2
- package/dist/op/op-waves.d.ts +35 -0
- package/dist/op/op-waves.d.ts.map +1 -1
- package/dist/op/op-waves.js +46 -6
- package/dist/op/runtime.d.ts +4 -0
- package/dist/op/runtime.d.ts.map +1 -1
- package/dist/op/runtime.js +2 -3
- package/dist/otlp.d.ts.map +1 -1
- package/dist/otlp.js +1 -2
- package/dist/parallelism.d.ts +17 -0
- package/dist/parallelism.d.ts.map +1 -0
- package/dist/parallelism.js +33 -0
- package/dist/policy-source.d.ts.map +1 -1
- package/dist/policy-source.js +1 -2
- package/dist/pr-forge.d.ts.map +1 -1
- package/dist/pr-forge.js +56 -39
- package/dist/pr-loop.d.ts +9 -0
- package/dist/pr-loop.d.ts.map +1 -1
- package/dist/pr-loop.js +22 -3
- 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 +70 -1
- package/dist/pr-post.d.ts.map +1 -1
- package/dist/pr-post.js +116 -5
- package/dist/pr-report-url.d.ts.map +1 -1
- package/dist/pr-report-url.js +1 -2
- package/dist/release-floors.d.ts +1 -1
- package/dist/release-floors.js +1 -1
- package/dist/run-event.d.ts.map +1 -1
- package/dist/run-event.js +1 -2
- 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/wave-runtime.mjs +340 -327
- package/dist/workspace/ci-lock-grain.d.ts +5 -0
- package/dist/workspace/ci-lock-grain.d.ts.map +1 -1
- package/dist/workspace/ci-lock-grain.js +1 -7
- package/dist/workspace/ci-run.d.ts.map +1 -1
- package/dist/workspace/ci-run.js +5 -1
- package/dist/workspace/pr-report.schema.json +5 -0
- package/package.json +1 -1
- package/src/ci-agent.ts +1 -2
- 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 +3 -4
- package/src/ci-estate.ts +1 -2
- package/src/ci-identity-database.test.ts +2 -3
- package/src/ci-identity-targets.test.ts +1 -3
- package/src/ci-identity.ts +2 -3
- 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.ts +35 -6
- package/src/ci-product.ts +55 -3
- 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/cli/handlers/audit-log.ts +74 -0
- package/src/cli/handlers/build-pr-loop-flags.test.ts +98 -0
- package/src/cli/handlers/build.ts +69 -0
- 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 +38 -8
- package/src/cli/handlers/e2e-safe-run.ts +27 -0
- 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.ts +228 -4
- package/src/cli/handlers/run-wave.ts +79 -1
- package/src/cli/main.test.ts +1 -1
- package/src/cli/main.ts +56 -2
- package/src/cli/parse-args.ts +77 -0
- package/src/cli/registry.ts +38 -0
- package/src/components/adoption.ts +1 -2
- package/src/components/capability.ts +50 -0
- package/src/components/check-hooks.ts +4 -1
- package/src/components/check-steps.test.ts +70 -0
- package/src/components/check-steps.ts +158 -0
- package/src/components/ci-services.ts +1 -2
- package/src/components/driver.ts +35 -1
- package/src/components/groups.ts +4 -2
- package/src/components/plan-flags.test.ts +46 -0
- package/src/components/pr-comment-preview-targets.test.ts +34 -0
- package/src/components/pr-env-ledger.ts +1 -2
- package/src/components/pr-env-run-bundle.test.ts +0 -20
- package/src/components/pr-environment.ts +1 -1
- package/src/components/pr-pipeline-runners.test.ts +80 -0
- package/src/components/pr-pipeline.ts +232 -17
- package/src/components/pr-run.ts +17 -6
- package/src/components/pr-stale-job.test.ts +34 -0
- package/src/components/product-pipeline.ts +50 -8
- package/src/components/wave-plan.ts +18 -2
- 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/exit-codes.test.ts +3 -2
- package/src/exit-codes.ts +7 -1
- package/src/gate-decision-bundle.test.ts +0 -2
- package/src/lexicon.ts +48 -0
- package/src/lifecycle/control-entries-ledger.test.ts +2 -3
- package/src/lifecycle/gate-ledger.ts +2 -3
- package/src/lifecycle/gated-request.ts +1 -2
- package/src/lifecycle/query.ts +4 -5
- package/src/lifecycle/release-catalog.test.ts +3 -4
- package/src/lifecycle/release-catalog.ts +1 -1
- package/src/lifecycle/release-ledger.ts +1 -2
- package/src/lifecycle/release-status.test.ts +3 -4
- package/src/lifecycle/release-status.ts +1 -2
- package/src/lifecycle/wave-plans.ts +33 -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/index.ts +2 -0
- package/src/op/op-waves-after-plan.test.ts +12 -0
- package/src/op/op-waves-capability-spec.ts +20 -0
- package/src/op/op-waves-parallelism.test.ts +89 -0
- package/src/op/op-waves-pull-request.test.ts +78 -1
- package/src/op/op-waves-release.ts +1 -2
- package/src/op/op-waves-run.ts +94 -4
- package/src/op/op-waves-stand-down.ts +1 -2
- package/src/op/op-waves.ts +63 -6
- package/src/op/runtime.ts +6 -3
- package/src/otlp.ts +1 -2
- package/src/parallelism.test.ts +38 -0
- package/src/parallelism.ts +33 -0
- package/src/policy-source.ts +1 -2
- package/src/pr-forge-bundle.test.ts +1 -1
- package/src/pr-forge.ts +54 -35
- package/src/pr-loop-bundle.test.ts +1 -1
- package/src/pr-loop-narrowed.test.ts +63 -0
- package/src/pr-loop.ts +30 -3
- 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 +159 -5
- package/src/pr-report-url.ts +1 -2
- package/src/product-subpaths-plain-node.e2e.test.ts +1 -0
- package/src/release-floors.ts +1 -1
- package/src/run-event.ts +1 -2
- package/src/scheduled-op-cloud.ts +68 -0
- package/src/stage-hooks-bundle.test.ts +0 -2
- package/src/workspace/ci-lock-grain.ts +1 -2
- package/src/workspace/ci-run.ts +5 -1
- package/src/workspace/pr-report.schema.json +5 -0
package/src/ci-product.ts
CHANGED
|
@@ -21,7 +21,7 @@ import { OTLP_EXPORTER_FLOOR } from "./otlp";
|
|
|
21
21
|
* words })`, the lexicons' `ciSetup`, and the member detail sections of the
|
|
22
22
|
* note (#4573).
|
|
23
23
|
*/
|
|
24
|
-
export const CI_PRODUCT_FLOOR =
|
|
24
|
+
export const CI_PRODUCT_FLOOR = "0.124.55";
|
|
25
25
|
|
|
26
26
|
export {
|
|
27
27
|
activeProductWords,
|
|
@@ -64,7 +64,7 @@ export {
|
|
|
64
64
|
export { driftNotifyFields, productNotifySource, productNotifyWords, productSendOptions, type DriftNotifyInput } from "./notify-product";
|
|
65
65
|
|
|
66
66
|
/** The first chant with `chant notify relay` and the notify relay buttons (#4611). */
|
|
67
|
-
export const NOTIFY_RELAY_FLOOR =
|
|
67
|
+
export const NOTIFY_RELAY_FLOOR = "0.124.55";
|
|
68
68
|
|
|
69
69
|
/**
|
|
70
70
|
* The first chant whose product pipeline has the comment preview
|
|
@@ -72,7 +72,7 @@ export const NOTIFY_RELAY_FLOOR = NEXT_RELEASE;
|
|
|
72
72
|
* `components pr-plan` takes `--target` (#4620). A product feature-detects
|
|
73
73
|
* `prCommentPreviewJob` and this constant together.
|
|
74
74
|
*/
|
|
75
|
-
export const PR_PREVIEW_FLOOR =
|
|
75
|
+
export const PR_PREVIEW_FLOOR = "0.124.55";
|
|
76
76
|
export {
|
|
77
77
|
decideRelayClick,
|
|
78
78
|
handleRelayRequest,
|
|
@@ -116,6 +116,58 @@ export { CI_SERVICES_FLOOR, engineServices, githubServices, gitlabServices, serv
|
|
|
116
116
|
export { renderPrNote, prStatusContext, prApproveCommand, prApproveCommands, prApproveTargets, prMergeSentence, type PrMemberDetail } from "./pr-loop";
|
|
117
117
|
export { upsertPlanNote } from "./pr-post";
|
|
118
118
|
|
|
119
|
+
/**
|
|
120
|
+
* The approval status before merge (#4630): under a `pr-review` wave, the
|
|
121
|
+
* op waves generators add a job that posts `<product>/approval` on each
|
|
122
|
+
* open pull request's head. A product feature-detects on
|
|
123
|
+
* `APPROVAL_STATUS_FLOOR`.
|
|
124
|
+
*/
|
|
125
|
+
export const APPROVAL_STATUS_FLOOR = NEXT_RELEASE;
|
|
126
|
+
/**
|
|
127
|
+
* The approval status for `pull-request` waves too (#4630, 2026-10-28
|
|
128
|
+
* ruling): the generators add the record-plans and approval-status jobs for
|
|
129
|
+
* a spec whose waves take the pull request's own approval, and the status
|
|
130
|
+
* reads that approval's coverage of each wave's change set. A product such
|
|
131
|
+
* as plywood, whose waves all take `approval: pull-request`, feature-detects
|
|
132
|
+
* on this floor.
|
|
133
|
+
*/
|
|
134
|
+
export const APPROVAL_STATUS_PULL_REQUEST_FLOOR = NEXT_RELEASE;
|
|
135
|
+
export { opWavesPostsApprovalStatus } from "./op/op-waves";
|
|
136
|
+
export { approvalStatusOf, headWaveHolds, postApprovalStatus, postOpenApprovalStatuses, type ApprovalStatus, type ApprovalStatusInput } from "./op/approval-status";
|
|
137
|
+
|
|
138
|
+
/**
|
|
139
|
+
* Responses to pipeline events (#4629): a refused wave's diff, a failed
|
|
140
|
+
* apply's triage and the pull request description check, in the product's
|
|
141
|
+
* words. `productPipelineJobs(forge, env, { words, respond, decide })` turns
|
|
142
|
+
* them on and off; a product feature-detects on `CI_RESPOND_FLOOR`.
|
|
143
|
+
*/
|
|
144
|
+
export const CI_RESPOND_FLOOR = NEXT_RELEASE;
|
|
145
|
+
|
|
146
|
+
/**
|
|
147
|
+
* `chant build --pr-loop` carries `--merge auto --merge-token-env <VAR>
|
|
148
|
+
* [--merge-method <m>]` (#4636), `--respond <list>`, `--decide-backend` and
|
|
149
|
+
* `--decide-model` (#4629) into the generated pull request jobs. Before it
|
|
150
|
+
* the build parsed them and wrote jobs without them; a product that writes
|
|
151
|
+
* its pull request jobs with the build feature-detects on this floor.
|
|
152
|
+
*/
|
|
153
|
+
export const PR_LOOP_BUILD_FLAGS_FLOOR = NEXT_RELEASE;
|
|
154
|
+
export {
|
|
155
|
+
CI_RESPOND_DEFAULTS,
|
|
156
|
+
CI_RESPOND_ENV,
|
|
157
|
+
CI_RESPONSES,
|
|
158
|
+
parseRespondList,
|
|
159
|
+
renderRefusedDiff,
|
|
160
|
+
renderTriage,
|
|
161
|
+
respondList,
|
|
162
|
+
resolveResponses,
|
|
163
|
+
type CiRespondEvent,
|
|
164
|
+
type CiResponses,
|
|
165
|
+
type DescriptionFinding,
|
|
166
|
+
type FailedApply,
|
|
167
|
+
type RefusedDiff,
|
|
168
|
+
} from "./ci-respond";
|
|
169
|
+
export { respondDescription, respondOpWave, respondPrApply, triageOfOpWave, triageOfPrReport, refusedOfOpWave, refusedOfPrReport } from "./ci-respond-run";
|
|
170
|
+
|
|
119
171
|
/**
|
|
120
172
|
* Run one chant command line in this process with the product's words
|
|
121
173
|
* (ruling C): what a product's bin calls for every command its verbs map
|
|
@@ -0,0 +1,291 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Where the responses of #4629 hook in: a `pr-apply` report, an op wave
|
|
3
|
+
* job's outcome, and the plan-note job's report. Each reads what the run
|
|
4
|
+
* already has (the report, the run's result, the change sets stored on
|
|
5
|
+
* `chant/lifecycle`) and posts through `./ci-respond.ts`. Nothing here
|
|
6
|
+
* throws or changes an exit code.
|
|
7
|
+
*/
|
|
8
|
+
|
|
9
|
+
import type { ChangeSetDocument } from "./change-set";
|
|
10
|
+
import { activeProductWords, notifyWaveLabel, type CiProductWords } from "./ci-product-words";
|
|
11
|
+
import { CHANT_EXIT } from "./exit-codes";
|
|
12
|
+
import type { PrForge } from "./pr-forge";
|
|
13
|
+
import type { PrReport } from "./pr-loop";
|
|
14
|
+
import type { OpWavesSpec } from "./op/op-waves";
|
|
15
|
+
import type { RunOpWaveResult } from "./op/op-waves-run";
|
|
16
|
+
import type { OpWaveOutcome } from "./op/op-waves-notify";
|
|
17
|
+
import {
|
|
18
|
+
changeSetDiff,
|
|
19
|
+
checkDescription,
|
|
20
|
+
DESCRIPTION_QUESTION,
|
|
21
|
+
digestDiff,
|
|
22
|
+
postResponse,
|
|
23
|
+
renderRefusedDiff,
|
|
24
|
+
renderTriage,
|
|
25
|
+
resolveResponses,
|
|
26
|
+
respondMarker,
|
|
27
|
+
type CiResponses,
|
|
28
|
+
type DescriptionAsk,
|
|
29
|
+
type DescriptionFinding,
|
|
30
|
+
type FailedApply,
|
|
31
|
+
type RefusedDiff,
|
|
32
|
+
type RespondPlace,
|
|
33
|
+
type RespondPost,
|
|
34
|
+
} from "./ci-respond";
|
|
35
|
+
|
|
36
|
+
/** Reads a change set stored under its digest; undefined when none is stored or it cannot be read. */
|
|
37
|
+
export type ChangeSetReader = (digest: string) => Promise<ChangeSetDocument | undefined>;
|
|
38
|
+
|
|
39
|
+
/** The ledger's reader: `chant/lifecycle`'s `_change-sets`, loaded on first call. */
|
|
40
|
+
export const ledgerChangeSetReader: ChangeSetReader = async (digest) => {
|
|
41
|
+
try {
|
|
42
|
+
const { readStoredChangeSet } = await import("./lifecycle/change-set-store");
|
|
43
|
+
const read = await readStoredChangeSet(digest);
|
|
44
|
+
return read.status === "found" ? read.document : undefined;
|
|
45
|
+
} catch {
|
|
46
|
+
return undefined;
|
|
47
|
+
}
|
|
48
|
+
};
|
|
49
|
+
|
|
50
|
+
const log = (line: string): void => {
|
|
51
|
+
process.stderr.write(line + "\n");
|
|
52
|
+
};
|
|
53
|
+
|
|
54
|
+
// ---------------------------------------------------------------------------
|
|
55
|
+
// pr-apply
|
|
56
|
+
// ---------------------------------------------------------------------------
|
|
57
|
+
|
|
58
|
+
/** How a `pr-apply` post names the change. */
|
|
59
|
+
function applyLabel(report: Pick<PrReport, "pr" | "member" | "op">, words: CiProductWords): string {
|
|
60
|
+
const what = report.pr !== null ? `the ${words.verbs.apply[0]} of pull request ${report.pr}` : `the ${words.verbs.apply[0]} of ${report.op}`;
|
|
61
|
+
return report.member ? `${what} (${report.member})` : what;
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
/** A failed `pr-apply` report as a triage, or undefined when it did not fail. */
|
|
65
|
+
export function triageOfPrReport(report: PrReport, words: CiProductWords = activeProductWords()): FailedApply | undefined {
|
|
66
|
+
if (report.stage !== "apply" || report.status !== "failed") return undefined;
|
|
67
|
+
const members = report.members.filter((m) => m.status === "failed").map((m) => ({ member: m.member, ...(m.error ? { error: m.error } : {}) }));
|
|
68
|
+
return {
|
|
69
|
+
label: applyLabel(report, words),
|
|
70
|
+
exitCode: 1,
|
|
71
|
+
members,
|
|
72
|
+
...(members.length === 0 && report.message ? { error: report.message } : {}),
|
|
73
|
+
};
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
/** A refused `pr-apply` report as a refused diff, or undefined when it was not refused for a moved plan or a holder. */
|
|
77
|
+
export async function refusedOfPrReport(report: PrReport, read: ChangeSetReader = ledgerChangeSetReader, words: CiProductWords = activeProductWords()): Promise<RefusedDiff | undefined> {
|
|
78
|
+
if (report.stage !== "apply" || report.status !== "refused") return undefined;
|
|
79
|
+
const label = applyLabel(report, words);
|
|
80
|
+
if (report.refusal === "plan-changed" || report.refusal === "wave-plan-changed") {
|
|
81
|
+
const approvedDigest = report.approval.approved ?? null;
|
|
82
|
+
const approved = approvedDigest ? await read(approvedDigest) : undefined;
|
|
83
|
+
return { label, reason: "moved", approved: approvedDigest, current: report.digest, members: changeSetDiff(approved, report.changeSet) };
|
|
84
|
+
}
|
|
85
|
+
if (report.refusal === "locked") return { label, reason: "held", approved: report.digest, current: report.digest, members: [], ...(report.message ? { detail: firstLine(report.message) } : {}) };
|
|
86
|
+
return undefined;
|
|
87
|
+
}
|
|
88
|
+
|
|
89
|
+
/** The responses a `pr-apply` report calls for, posted on its pull request. */
|
|
90
|
+
export async function respondPrApply(
|
|
91
|
+
forge: Pick<PrForge, "upsertComment" | "trackIssue"> | undefined,
|
|
92
|
+
report: PrReport,
|
|
93
|
+
given?: CiResponses,
|
|
94
|
+
opts: { read?: ChangeSetReader; env?: Record<string, string | undefined>; words?: CiProductWords } = {},
|
|
95
|
+
): Promise<RespondPost[]> {
|
|
96
|
+
if (!forge || report.pr === null) return [];
|
|
97
|
+
const responses = resolveResponses(given, opts.env, log);
|
|
98
|
+
const words = opts.words ?? activeProductWords();
|
|
99
|
+
const place = `${report.op}:${report.env}${report.member ? `:${report.member}` : ""}`;
|
|
100
|
+
const posts: RespondPost[] = [];
|
|
101
|
+
try {
|
|
102
|
+
if (responses["apply-failed"] === "triage") {
|
|
103
|
+
const triage = triageOfPrReport(report, words);
|
|
104
|
+
if (triage) posts.push(await postResponse(forge, "apply-failed", place, { pr: report.pr }, renderTriage(triage, words)));
|
|
105
|
+
}
|
|
106
|
+
if (responses["wave-refused"] === "diff") {
|
|
107
|
+
const refused = await refusedOfPrReport(report, opts.read, words);
|
|
108
|
+
if (refused) posts.push(await postResponse(forge, "wave-refused", place, { pr: report.pr }, renderRefusedDiff(refused, words)));
|
|
109
|
+
}
|
|
110
|
+
} catch (err) {
|
|
111
|
+
posts.push({ posted: false, warning: `the responses were not posted: ${err instanceof Error ? err.message : String(err)}` });
|
|
112
|
+
}
|
|
113
|
+
for (const p of posts) if (p.warning) log(p.warning);
|
|
114
|
+
return posts;
|
|
115
|
+
}
|
|
116
|
+
|
|
117
|
+
// ---------------------------------------------------------------------------
|
|
118
|
+
// op waves
|
|
119
|
+
// ---------------------------------------------------------------------------
|
|
120
|
+
|
|
121
|
+
/** What a failed op wave job's run record says failed, or undefined when it did not fail. */
|
|
122
|
+
export function triageOfOpWave(spec: OpWavesSpec, k: number, outcome: OpWaveOutcome, words: CiProductWords = activeProductWords()): FailedApply | undefined {
|
|
123
|
+
const name = spec.waves[k - 1]?.name;
|
|
124
|
+
const label = notifyWaveLabel(words, { k, ...(name ? { name } : {}), spec: spec.name });
|
|
125
|
+
if (outcome.error !== undefined) return { label, exitCode: CHANT_EXIT.failed, members: [], error: outcome.error };
|
|
126
|
+
const result = outcome.result;
|
|
127
|
+
if (result.exitCode !== CHANT_EXIT.failed) return undefined;
|
|
128
|
+
const members = result.failed.map((target) => {
|
|
129
|
+
const t = result.targets?.[target];
|
|
130
|
+
return { member: target, ...(t?.error ? { error: t.error } : {}), ...(t?.failedResources?.length ? { resources: [...t.failedResources] } : {}) };
|
|
131
|
+
});
|
|
132
|
+
const hooks = result.hooks.filter((h) => h.outcome === "failed").map((h) => `${h.moment} hook ${h.name}${h.target ? ` (${h.target})` : ""} failed`);
|
|
133
|
+
return { label, exitCode: result.exitCode, members, ...(members.length === 0 && hooks.length > 0 ? { error: hooks.join("\n") } : {}) };
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
/** A refused op wave job (moved, held or declined) as a refused diff, or undefined when it was not refused. */
|
|
137
|
+
export async function refusedOfOpWave(spec: OpWavesSpec, k: number, result: RunOpWaveResult, read: ChangeSetReader = ledgerChangeSetReader, words: CiProductWords = activeProductWords()): Promise<RefusedDiff | undefined> {
|
|
138
|
+
const name = spec.waves[k - 1]?.name;
|
|
139
|
+
const label = notifyWaveLabel(words, { k, ...(name ? { name } : {}), spec: spec.name });
|
|
140
|
+
const d = result.decision;
|
|
141
|
+
if (result.exitCode === CHANT_EXIT.moved) {
|
|
142
|
+
// The share job refused the runs whose plan moved since the decision: the decision's digests against the plans the job read.
|
|
143
|
+
const approved: Record<string, string | null> = Object.fromEntries((d?.members ?? []).filter((m) => result.moved.includes(m.member)).map((m) => [m.member, m.planDigest ?? null]));
|
|
144
|
+
const current = Object.fromEntries(result.moved.map((t) => [t, result.plans?.[t]?.planDigest ?? null]));
|
|
145
|
+
for (const t of result.moved) if (!(t in approved)) approved[t] = null;
|
|
146
|
+
return { label, reason: "moved", approved: d?.digest ?? null, current: null, members: digestDiff(approved, current) };
|
|
147
|
+
}
|
|
148
|
+
if (result.exitCode === CHANT_EXIT.waiting && d?.via === undefined && d?.coveredBy?.digest && d.coveredBy.digest !== d.digest) {
|
|
149
|
+
// Under `pull-request` approvals a wave whose plan the approved change set no longer covers waits at its own gate.
|
|
150
|
+
const [approved, current] = await Promise.all([read(d.coveredBy.digest), read(d.digest)]);
|
|
151
|
+
return { label, reason: "moved", approved: d.coveredBy.digest, current: d.digest, members: changeSetDiff(approved, current, d.members.map((m) => m.member)) };
|
|
152
|
+
}
|
|
153
|
+
if (result.exitCode === CHANT_EXIT.held && result.outcome?.outcome === "held") {
|
|
154
|
+
const holder = result.outcome.holder;
|
|
155
|
+
return { label, reason: "held", approved: d?.digest ?? null, current: d?.digest ?? null, members: [], ...(holder ? { detail: `held by ${holder.run}` } : result.outcome.reason ? { detail: result.outcome.reason } : {}) };
|
|
156
|
+
}
|
|
157
|
+
if (result.exitCode === CHANT_EXIT.declined && d?.refused?.reason === "point") {
|
|
158
|
+
const answer = d.point?.answer?.answer;
|
|
159
|
+
return { label, reason: "declined", approved: d.digest, current: d.digest, members: [], detail: `${d.point?.name ?? "the point"} answered ${JSON.stringify(answer ?? null)}` };
|
|
160
|
+
}
|
|
161
|
+
return undefined;
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
/** The forge and place an op wave job posts on: its pull request when it has one, else a tracking issue. */
|
|
165
|
+
export async function opWavePlace(forge: Pick<PrForge, "pullRequestFor">, result: RunOpWaveResult | undefined, head: string | undefined): Promise<RespondPlace | undefined> {
|
|
166
|
+
const pr = result?.decision?.review?.pr ?? pullRequestOfOpName(result?.decision?.op);
|
|
167
|
+
if (pr !== undefined) return { pr };
|
|
168
|
+
if (head) {
|
|
169
|
+
try {
|
|
170
|
+
const found = await forge.pullRequestFor(head);
|
|
171
|
+
if (found !== null) return { pr: found };
|
|
172
|
+
} catch {
|
|
173
|
+
/* fall through to the issue */
|
|
174
|
+
}
|
|
175
|
+
}
|
|
176
|
+
return undefined;
|
|
177
|
+
}
|
|
178
|
+
|
|
179
|
+
/** `pr-12` and `pr-12-<member>` name pull request 12. */
|
|
180
|
+
function pullRequestOfOpName(op: string | undefined): number | undefined {
|
|
181
|
+
const m = op ? /^pr-(\d+)(?:-|$)/.exec(op) : null;
|
|
182
|
+
return m ? Number(m[1]) : undefined;
|
|
183
|
+
}
|
|
184
|
+
|
|
185
|
+
/**
|
|
186
|
+
* The responses an op wave job's outcome calls for (#4629): the spec's
|
|
187
|
+
* `respond`, over `CHANT_RESPOND`. Posted on the pull request the wave
|
|
188
|
+
* applies (its review, its `pr-<n>` op, or the one that merged `head`),
|
|
189
|
+
* else on a tracking issue per spec and wave.
|
|
190
|
+
*/
|
|
191
|
+
export async function respondOpWave(
|
|
192
|
+
spec: OpWavesSpec,
|
|
193
|
+
k: number,
|
|
194
|
+
outcome: OpWaveOutcome,
|
|
195
|
+
opts: { forge?: Pick<PrForge, "upsertComment" | "trackIssue" | "pullRequestFor">; head?: string; read?: ChangeSetReader; env?: Record<string, string | undefined>; words?: CiProductWords } = {},
|
|
196
|
+
): Promise<RespondPost[]> {
|
|
197
|
+
const forge = opts.forge;
|
|
198
|
+
if (!forge) return [];
|
|
199
|
+
const responses = resolveResponses(spec.respond, opts.env, log);
|
|
200
|
+
const words = opts.words ?? activeProductWords();
|
|
201
|
+
const posts: RespondPost[] = [];
|
|
202
|
+
try {
|
|
203
|
+
const triage = responses["apply-failed"] === "triage" ? triageOfOpWave(spec, k, outcome, words) : undefined;
|
|
204
|
+
const refused = responses["wave-refused"] === "diff" && outcome.result ? await refusedOfOpWave(spec, k, outcome.result, opts.read, words) : undefined;
|
|
205
|
+
if (!triage && !refused) return [];
|
|
206
|
+
const place = `${spec.name}:wave-${k}`;
|
|
207
|
+
const where = (await opWavePlace(forge, outcome.result, opts.head)) ?? { issue: `${words.product}: ${spec.name} wave ${k}` };
|
|
208
|
+
if (triage) posts.push(await postResponse(forge, "apply-failed", place, where, renderTriage(triage, words)));
|
|
209
|
+
if (refused) posts.push(await postResponse(forge, "wave-refused", place, where, renderRefusedDiff(refused, words)));
|
|
210
|
+
} catch (err) {
|
|
211
|
+
posts.push({ posted: false, warning: `the responses were not posted: ${err instanceof Error ? err.message : String(err)}` });
|
|
212
|
+
}
|
|
213
|
+
for (const p of posts) if (p.warning) log(p.warning);
|
|
214
|
+
return posts;
|
|
215
|
+
}
|
|
216
|
+
|
|
217
|
+
// ---------------------------------------------------------------------------
|
|
218
|
+
// plan note: description check
|
|
219
|
+
// ---------------------------------------------------------------------------
|
|
220
|
+
|
|
221
|
+
/** The description check's settings: the decide backend and model, and the threshold. */
|
|
222
|
+
export interface DescriptionCheckSettings {
|
|
223
|
+
ask: DescriptionAsk;
|
|
224
|
+
threshold?: number;
|
|
225
|
+
}
|
|
226
|
+
|
|
227
|
+
/**
|
|
228
|
+
* The description check on a plan report's change set (#4629), from the
|
|
229
|
+
* plan-note job: the pull request's title and body read from the forge,
|
|
230
|
+
* the finding posted as its own comment. A clear answer edits an earlier
|
|
231
|
+
* finding away. Never throws.
|
|
232
|
+
*/
|
|
233
|
+
export async function respondDescription(
|
|
234
|
+
forge: Pick<PrForge, "upsertComment" | "findComment" | "trackIssue" | "pullRequestHead" | "findPullRequest">,
|
|
235
|
+
report: Pick<PrReport, "pr" | "env" | "member" | "changeSet" | "status">,
|
|
236
|
+
settings: DescriptionCheckSettings,
|
|
237
|
+
words: CiProductWords = activeProductWords(),
|
|
238
|
+
): Promise<DescriptionFinding | undefined> {
|
|
239
|
+
if (report.pr === null || report.status === "nothing") return undefined;
|
|
240
|
+
try {
|
|
241
|
+
const head = await forge.pullRequestHead?.(report.pr);
|
|
242
|
+
const pull = head ? await forge.findPullRequest(head.branch) : undefined;
|
|
243
|
+
if (!pull) {
|
|
244
|
+
log(`description check: could not read pull request ${report.pr}'s title and description`);
|
|
245
|
+
return undefined;
|
|
246
|
+
}
|
|
247
|
+
const finding = await checkDescription({ doc: report.changeSet, title: pull.title, description: pull.body ?? "", ask: settings.ask, ...(settings.threshold !== undefined ? { threshold: settings.threshold } : {}), words });
|
|
248
|
+
const place = `${report.env}${report.member ? `:${report.member}` : ""}`;
|
|
249
|
+
if (finding.status === "flagged" && finding.body) {
|
|
250
|
+
const posted = await postResponse(forge, "description", place, { pr: report.pr }, finding.body);
|
|
251
|
+
if (posted.warning) log(posted.warning);
|
|
252
|
+
} else if (finding.status === "clear") {
|
|
253
|
+
// An earlier finding on this pull request no longer holds: say so in its place.
|
|
254
|
+
if (await forge.findComment(report.pr, respondMarker("description", place))) {
|
|
255
|
+
await postResponse(forge, "description", place, { pr: report.pr }, `The description now covers what the ${words.verbs.plan[0]} destroys and replaces.`);
|
|
256
|
+
}
|
|
257
|
+
} else if (finding.status === "error") {
|
|
258
|
+
log(`description check: the decide service did not answer: ${finding.reason}`);
|
|
259
|
+
}
|
|
260
|
+
return finding;
|
|
261
|
+
} catch (err) {
|
|
262
|
+
log(`description check: ${err instanceof Error ? err.message : String(err)}`);
|
|
263
|
+
return undefined;
|
|
264
|
+
}
|
|
265
|
+
}
|
|
266
|
+
|
|
267
|
+
/**
|
|
268
|
+
* A {@link DescriptionAsk} over a `decide.backends` entry: the Noul
|
|
269
|
+
* question posted to the backend's `/v1/systemone`. The backend's module
|
|
270
|
+
* loads on first call.
|
|
271
|
+
*/
|
|
272
|
+
export function backendDescriptionAsk(backend: import("./op/decide-config").DecideBackend, opts: { name: string; model: string; cwd: string; env?: NodeJS.ProcessEnv; transport?: typeof fetch }): DescriptionAsk {
|
|
273
|
+
return async (state) => {
|
|
274
|
+
const { postQuestion } = await import("./op/decide-backend");
|
|
275
|
+
const { model, answer } = await postQuestion(
|
|
276
|
+
backend,
|
|
277
|
+
opts.name,
|
|
278
|
+
{ point: "description", backend: opts.name, model: opts.model, question: { type: "noul", instructions: DESCRIPTION_INSTRUCTIONS, criteria: { ...DESCRIPTION_CRITERIA } }, state: state as unknown as Record<string, unknown> },
|
|
279
|
+
{ cwd: opts.cwd, ...(opts.env ? { env: opts.env } : {}), ...(opts.transport ? { transport: opts.transport } : {}) },
|
|
280
|
+
);
|
|
281
|
+
if (answer.type !== "noul" || typeof answer.noul !== "number") throw new Error(`${opts.name} answered the description question with a ${answer.type} answer, not a noul`);
|
|
282
|
+
return { model, probability: answer.noul, ...(answer.reason ? { reason: answer.reason } : {}) };
|
|
283
|
+
};
|
|
284
|
+
}
|
|
285
|
+
|
|
286
|
+
const DESCRIPTION_INSTRUCTIONS: string = DESCRIPTION_QUESTION.instructions;
|
|
287
|
+
const DESCRIPTION_CRITERIA: Record<string, string> = DESCRIPTION_QUESTION.criteria;
|
|
288
|
+
|
|
289
|
+
function firstLine(text: string): string {
|
|
290
|
+
return text.split("\n")[0]!.trim();
|
|
291
|
+
}
|
|
@@ -0,0 +1,264 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* #4629: the responses to a refused wave, a failed apply and a pull request
|
|
3
|
+
* description, posted through fake forges in the product's words.
|
|
4
|
+
*/
|
|
5
|
+
|
|
6
|
+
import { readFileSync } from "node:fs";
|
|
7
|
+
import { join } from "node:path";
|
|
8
|
+
import { describe, expect, test } from "vitest";
|
|
9
|
+
import type { ChangeSetDocument, ChangeSetEntry } from "./change-set";
|
|
10
|
+
import { assertProductWords } from "./ci-product-words";
|
|
11
|
+
import { checkDescription, changeSetDiff, parseRespondList, renderRefusedDiff, renderTriage, resolveResponses, respondList, respondMarker, CI_RESPOND_ENV } from "./ci-respond";
|
|
12
|
+
import { refusedOfOpWave, refusedOfPrReport, respondDescription, respondOpWave, respondPrApply, triageOfOpWave, triageOfPrReport } from "./ci-respond-run";
|
|
13
|
+
import { CHANT_EXIT } from "./exit-codes";
|
|
14
|
+
import type { PrReport } from "./pr-loop";
|
|
15
|
+
import type { OpWavesSpec } from "./op/op-waves";
|
|
16
|
+
import type { RunOpWaveResult } from "./op/op-waves-run";
|
|
17
|
+
import { productPipelineJobs } from "./components/product-pipeline";
|
|
18
|
+
import { parseOpWavesSpec } from "./op/op-waves-run";
|
|
19
|
+
import { assertOpWavesSpec } from "./op/op-waves";
|
|
20
|
+
|
|
21
|
+
const REPORT = JSON.parse(readFileSync(join(import.meta.dirname, "__fixtures__", "pr-loop", "pr-plan.golden.json"), "utf-8")) as PrReport;
|
|
22
|
+
const PLYWOOD = assertProductWords({ product: "plywood", verbs: { plan: ["preview", "previewed"], apply: ["update", "updated"] }, noun: ["stack", "stacks"], stages: { plan: "preview", apply: "up" } });
|
|
23
|
+
|
|
24
|
+
type Posted = { kind: "comment"; pr: number; marker: string; body: string } | { kind: "issue"; marker: string; title: string; body: string };
|
|
25
|
+
|
|
26
|
+
function fakeForge(kind: "github" | "gitlab" | "forgejo", pull?: { title: string; body: string }) {
|
|
27
|
+
const posted: Posted[] = [];
|
|
28
|
+
const forge = {
|
|
29
|
+
kind,
|
|
30
|
+
host: kind === "github" ? "github.com" : kind === "gitlab" ? "gitlab.com" : "codeberg.org",
|
|
31
|
+
async upsertComment(pr: number, marker: string, body: string) {
|
|
32
|
+
const at = posted.findIndex((p) => p.kind === "comment" && p.pr === pr && p.marker === marker);
|
|
33
|
+
if (at >= 0) posted[at] = { kind: "comment", pr, marker, body };
|
|
34
|
+
else posted.push({ kind: "comment", pr, marker, body });
|
|
35
|
+
return { action: at >= 0 ? "updated" : "created", id: posted.length } as const;
|
|
36
|
+
},
|
|
37
|
+
async findComment(pr: number, marker: string) {
|
|
38
|
+
const found = posted.find((p) => p.kind === "comment" && p.pr === pr && p.marker === marker);
|
|
39
|
+
return found ? { id: 1, body: found.body } : undefined;
|
|
40
|
+
},
|
|
41
|
+
async trackIssue(marker: string, finding: { title: string; body: string } | null) {
|
|
42
|
+
if (finding) posted.push({ kind: "issue", marker, title: finding.title, body: finding.body });
|
|
43
|
+
return { action: "opened", number: 7 } as const;
|
|
44
|
+
},
|
|
45
|
+
async pullRequestFor() {
|
|
46
|
+
return null;
|
|
47
|
+
},
|
|
48
|
+
async pullRequestHead(pr: number) {
|
|
49
|
+
return { sha: "a".repeat(40), branch: `feature-${pr}`, open: true, sameRepo: true };
|
|
50
|
+
},
|
|
51
|
+
async findPullRequest(head: string) {
|
|
52
|
+
return pull ? { number: 12, title: pull.title, body: pull.body, head } : undefined;
|
|
53
|
+
},
|
|
54
|
+
};
|
|
55
|
+
return { forge, posted };
|
|
56
|
+
}
|
|
57
|
+
|
|
58
|
+
function entry(member: string, address: string, action: ChangeSetEntry["action"], after?: unknown): ChangeSetEntry {
|
|
59
|
+
return { member, lexicon: "terraform", planner: "terraform", address, type: address.split(".")[0]!, action, attributes: after === undefined ? [] : [{ path: "value", after }] } as unknown as ChangeSetEntry;
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
function doc(digest: string, members: Record<string, string | null>, entries: ChangeSetEntry[]): ChangeSetDocument {
|
|
63
|
+
const actions = { create: 0, update: 0, replace: 0, delete: 0, read: 0, "no-op": 0, forget: 0 };
|
|
64
|
+
for (const e of entries) actions[e.action]++;
|
|
65
|
+
return {
|
|
66
|
+
...REPORT.changeSet,
|
|
67
|
+
digest,
|
|
68
|
+
members: Object.entries(members).map(([member, planDigest]) => ({ member, lexicon: "terraform", planner: "terraform", status: planDigest ? "planned" : "failed", planDigest })),
|
|
69
|
+
entries,
|
|
70
|
+
summary: { ...REPORT.changeSet.summary, actions },
|
|
71
|
+
} as ChangeSetDocument;
|
|
72
|
+
}
|
|
73
|
+
|
|
74
|
+
const SPEC: OpWavesSpec = { name: "plywood-up", op: "plywood-up", plan: ["./bin/plan", "{target}", "{plan}"], waves: [{ name: "prod", runs: [{ target: "app" }, { target: "db" }] }] } as unknown as OpWavesSpec;
|
|
75
|
+
|
|
76
|
+
describe("the responses list (#4629)", () => {
|
|
77
|
+
test("parses, defaults and round-trips", () => {
|
|
78
|
+
expect(parseRespondList("wave-refused=off,description=check")).toEqual({ "wave-refused": "off", description: "check" });
|
|
79
|
+
expect(parseRespondList("apply-failed=maybe")).toEqual({ error: expect.stringContaining("triage or off") });
|
|
80
|
+
expect(parseRespondList("drift=off")).toEqual({ error: expect.stringContaining("no event") });
|
|
81
|
+
expect(resolveResponses(undefined, {})).toEqual({ "wave-refused": "diff", "apply-failed": "triage", description: "off" });
|
|
82
|
+
expect(resolveResponses({ description: "check" }, { [CI_RESPOND_ENV]: "apply-failed=off" })).toEqual({ "wave-refused": "diff", "apply-failed": "off", description: "check" });
|
|
83
|
+
expect(respondList({ "wave-refused": "diff", "apply-failed": "off" })).toBe("apply-failed=off");
|
|
84
|
+
});
|
|
85
|
+
|
|
86
|
+
test("an op waves spec takes respond, and refuses a description check or a bad mode", () => {
|
|
87
|
+
const ok = { ...SPEC, respond: { "apply-failed": "off" } };
|
|
88
|
+
expect(() => assertOpWavesSpec(ok as OpWavesSpec)).not.toThrow(/respond/);
|
|
89
|
+
expect(() => assertOpWavesSpec({ ...SPEC, respond: { description: "check" } } as unknown as OpWavesSpec)).toThrow(/plan-note job/);
|
|
90
|
+
expect(() => assertOpWavesSpec({ ...SPEC, respond: { "wave-refused": "loud" } } as unknown as OpWavesSpec)).toThrow(/diff or off/);
|
|
91
|
+
expect(parseOpWavesSpec(JSON.stringify(ok), "spec").respond).toEqual({ "apply-failed": "off" });
|
|
92
|
+
});
|
|
93
|
+
});
|
|
94
|
+
|
|
95
|
+
describe("a refused wave posts the diff between the approved plan and the new one (#4629)", () => {
|
|
96
|
+
const approved = doc("jcs1-sha256:aaa", { app: "jcs1-sha256:p1", db: "jcs1-sha256:d1" }, [entry("app", "aws_s3_bucket.logs", "update", "v1"), entry("db", "aws_db_instance.main", "update", 1)]);
|
|
97
|
+
const current = doc("jcs1-sha256:bbb", { app: "jcs1-sha256:p2", db: "jcs1-sha256:d1" }, [entry("app", "aws_s3_bucket.logs", "replace", "v2"), entry("app", "aws_iam_role.r", "create", "x"), entry("db", "aws_db_instance.main", "update", 1)]);
|
|
98
|
+
|
|
99
|
+
test("member by member and entry by entry", () => {
|
|
100
|
+
const diff = changeSetDiff(approved, current);
|
|
101
|
+
expect(diff).toEqual([
|
|
102
|
+
{
|
|
103
|
+
member: "app",
|
|
104
|
+
approved: "jcs1-sha256:p1",
|
|
105
|
+
current: "jcs1-sha256:p2",
|
|
106
|
+
changes: [
|
|
107
|
+
{ address: "aws_iam_role.r", now: "create", attributes: ["value"] },
|
|
108
|
+
{ address: "aws_s3_bucket.logs", was: "update", now: "replace", attributes: ["value"] },
|
|
109
|
+
],
|
|
110
|
+
},
|
|
111
|
+
]);
|
|
112
|
+
const text = renderRefusedDiff({ label: "wave 1 (prod) of plywood-up", reason: "moved", approved: approved.digest, current: current.digest, members: diff }, PLYWOOD);
|
|
113
|
+
expect(text).toContain("Wave 1 (prod) of plywood-up updated nothing");
|
|
114
|
+
expect(text).toContain("Stack whose plan differs");
|
|
115
|
+
expect(text).toContain("`aws_s3_bucket.logs` update -> replace: value");
|
|
116
|
+
});
|
|
117
|
+
|
|
118
|
+
for (const kind of ["github", "gitlab", "forgejo"] as const) {
|
|
119
|
+
test(`pr-apply refused for a moved plan posts on the pull request (${kind})`, async () => {
|
|
120
|
+
const { forge, posted } = fakeForge(kind);
|
|
121
|
+
const report = { ...REPORT, stage: "apply", status: "refused", refusal: "plan-changed", digest: current.digest, approval: { status: "changed", approved: approved.digest }, changeSet: current } as PrReport;
|
|
122
|
+
const read = async (d: string) => (d === approved.digest ? approved : undefined);
|
|
123
|
+
expect((await refusedOfPrReport(report, read, PLYWOOD))?.members.map((m) => m.member)).toEqual(["app"]);
|
|
124
|
+
const posts = await respondPrApply(forge, report, undefined, { read, env: {}, words: PLYWOOD });
|
|
125
|
+
expect(posts).toEqual([{ posted: true }]);
|
|
126
|
+
expect(posted).toHaveLength(1);
|
|
127
|
+
expect(posted[0]).toMatchObject({ kind: "comment", pr: 12, marker: respondMarker("wave-refused", "pr-12:prod") });
|
|
128
|
+
expect(posted[0]!.body).toContain("updated nothing: its plans changed after the approval");
|
|
129
|
+
// Twice posts once: the comment is found again by its marker.
|
|
130
|
+
await respondPrApply(forge, report, undefined, { read, env: {}, words: PLYWOOD });
|
|
131
|
+
expect(posted).toHaveLength(1);
|
|
132
|
+
});
|
|
133
|
+
}
|
|
134
|
+
|
|
135
|
+
test("a share job that refused moved runs posts their digests; off posts nothing", async () => {
|
|
136
|
+
const result = {
|
|
137
|
+
exitCode: CHANT_EXIT.moved,
|
|
138
|
+
applied: [],
|
|
139
|
+
failed: [],
|
|
140
|
+
moved: ["app"],
|
|
141
|
+
hooks: [],
|
|
142
|
+
decision: { op: "pr-12", digest: "jcs1-sha256:set", members: [{ member: "app", planDigest: "jcs1-sha256:p1" }] },
|
|
143
|
+
plans: { app: { planDigest: "jcs1-sha256:p2" } },
|
|
144
|
+
} as unknown as RunOpWaveResult;
|
|
145
|
+
const refused = await refusedOfOpWave(SPEC, 1, result, async () => undefined, PLYWOOD);
|
|
146
|
+
expect(refused).toMatchObject({ reason: "moved", members: [{ member: "app", approved: "jcs1-sha256:p1", current: "jcs1-sha256:p2" }] });
|
|
147
|
+
const { forge, posted } = fakeForge("github");
|
|
148
|
+
await respondOpWave(SPEC, 1, { result }, { forge, env: {}, words: PLYWOOD, read: async () => undefined });
|
|
149
|
+
expect(posted).toHaveLength(1);
|
|
150
|
+
expect(posted[0]).toMatchObject({ kind: "comment", pr: 12 });
|
|
151
|
+
const quiet = fakeForge("github");
|
|
152
|
+
await respondOpWave({ ...SPEC, respond: { "wave-refused": "off" } }, 1, { result }, { forge: quiet.forge, env: {}, words: PLYWOOD });
|
|
153
|
+
expect(quiet.posted).toHaveLength(0);
|
|
154
|
+
});
|
|
155
|
+
|
|
156
|
+
test("a held wave and a declined wave say why; with no pull request the post goes to a tracking issue", async () => {
|
|
157
|
+
const held = { exitCode: CHANT_EXIT.held, applied: [], failed: [], moved: [], hooks: [], outcome: { outcome: "held", holder: { run: "pr-9-171" } }, decision: { op: "plywood-up", digest: "jcs1-sha256:set", members: [] } } as unknown as RunOpWaveResult;
|
|
158
|
+
const { forge, posted } = fakeForge("gitlab");
|
|
159
|
+
await respondOpWave(SPEC, 1, { result: held }, { forge, env: {}, words: PLYWOOD, read: async () => undefined });
|
|
160
|
+
expect(posted[0]).toMatchObject({ kind: "issue", title: "plywood: plywood-up wave 1" });
|
|
161
|
+
expect(posted[0]!.body).toContain("another run holds what it changes (held by pr-9-171)");
|
|
162
|
+
const declined = { exitCode: CHANT_EXIT.declined, applied: [], failed: [], moved: [], hooks: [], decision: { op: "plywood-up", digest: "d", members: [], refused: { reason: "point", runs: ["app"] }, point: { name: "release-ok", answer: { answer: false } } } } as unknown as RunOpWaveResult;
|
|
163
|
+
expect(await refusedOfOpWave(SPEC, 1, declined, async () => undefined, PLYWOOD)).toMatchObject({ reason: "declined", detail: "release-ok answered false" });
|
|
164
|
+
});
|
|
165
|
+
});
|
|
166
|
+
|
|
167
|
+
describe("a failed apply posts the members and resources that failed with the engine's error (#4629)", () => {
|
|
168
|
+
for (const kind of ["github", "gitlab", "forgejo"] as const) {
|
|
169
|
+
test(`from an op wave's run record (${kind})`, async () => {
|
|
170
|
+
const result = {
|
|
171
|
+
exitCode: CHANT_EXIT.failed,
|
|
172
|
+
applied: ["app"],
|
|
173
|
+
failed: ["db"],
|
|
174
|
+
moved: [],
|
|
175
|
+
hooks: [],
|
|
176
|
+
decision: { op: "pr-12", digest: "d", members: [] },
|
|
177
|
+
targets: { db: { startedAt: "2026-10-28T00:00:00Z", durationMs: 5, error: "error: creating RDS instance: InvalidParameterValue", failedResources: ["aws_db_instance.main"] } },
|
|
178
|
+
} as unknown as RunOpWaveResult;
|
|
179
|
+
const triage = triageOfOpWave(SPEC, 1, { result }, PLYWOOD);
|
|
180
|
+
expect(triage).toEqual({ label: "wave 1 (prod) of plywood-up", exitCode: 1, members: [{ member: "db", error: "error: creating RDS instance: InvalidParameterValue", resources: ["aws_db_instance.main"] }] });
|
|
181
|
+
const { forge, posted } = fakeForge(kind);
|
|
182
|
+
await respondOpWave(SPEC, 1, { result }, { forge, env: {}, words: PLYWOOD });
|
|
183
|
+
expect(posted).toHaveLength(1);
|
|
184
|
+
expect(posted[0]!.body).toContain("Stack that did not update");
|
|
185
|
+
expect(posted[0]!.body).toContain("failed resources: `aws_db_instance.main`");
|
|
186
|
+
expect(posted[0]!.body).toContain("InvalidParameterValue");
|
|
187
|
+
});
|
|
188
|
+
}
|
|
189
|
+
|
|
190
|
+
test("from a pr-apply report, and turned off by CHANT_RESPOND", async () => {
|
|
191
|
+
const report = { ...REPORT, stage: "apply", status: "failed", members: [{ ...REPORT.members[0]!, status: "failed", error: "Error: 403 AccessDenied" }, REPORT.members[1]!] } as PrReport;
|
|
192
|
+
expect(triageOfPrReport(report, PLYWOOD)?.members).toEqual([{ member: "a", error: "Error: 403 AccessDenied" }]);
|
|
193
|
+
expect(renderTriage(triageOfPrReport(report, PLYWOOD)!, PLYWOOD)).toContain("The update of pull request 12 failed (exit 1).");
|
|
194
|
+
const on = fakeForge("forgejo");
|
|
195
|
+
await respondPrApply(on.forge, report, undefined, { env: {}, words: PLYWOOD });
|
|
196
|
+
expect(on.posted).toHaveLength(1);
|
|
197
|
+
const off = fakeForge("forgejo");
|
|
198
|
+
await respondPrApply(off.forge, report, undefined, { env: { [CI_RESPOND_ENV]: "apply-failed=off" }, words: PLYWOOD });
|
|
199
|
+
expect(off.posted).toHaveLength(0);
|
|
200
|
+
});
|
|
201
|
+
|
|
202
|
+
test("a wave that applied posts nothing", () => {
|
|
203
|
+
expect(triageOfOpWave(SPEC, 1, { result: { exitCode: 0, applied: ["app"], failed: [], moved: [], hooks: [] } as unknown as RunOpWaveResult })).toBeUndefined();
|
|
204
|
+
});
|
|
205
|
+
});
|
|
206
|
+
|
|
207
|
+
describe("the description check posts its finding without approving or gating (#4629)", () => {
|
|
208
|
+
const destroying = doc("jcs1-sha256:ccc", { app: "jcs1-sha256:p1" }, [entry("app", "aws_s3_bucket.logs", "delete"), entry("app", "aws_iam_role.app", "replace", "x"), entry("app", "aws_sqs_queue.q", "update", 1)]);
|
|
209
|
+
|
|
210
|
+
test("a confident yes names the destroys and replacements the text leaves out", async () => {
|
|
211
|
+
const asked: unknown[] = [];
|
|
212
|
+
const finding = await checkDescription({
|
|
213
|
+
doc: destroying,
|
|
214
|
+
title: "Rotate the app role",
|
|
215
|
+
description: "Replaces aws_iam_role.app with a new trust policy.",
|
|
216
|
+
ask: async (state) => {
|
|
217
|
+
asked.push(state);
|
|
218
|
+
return { model: "noul-1", probability: 0.93 };
|
|
219
|
+
},
|
|
220
|
+
words: PLYWOOD,
|
|
221
|
+
});
|
|
222
|
+
expect(finding.status).toBe("flagged");
|
|
223
|
+
expect(finding.unmentioned).toEqual(["app: aws_s3_bucket.logs"]);
|
|
224
|
+
expect(finding.body).toContain("approves nothing and never blocks a merge");
|
|
225
|
+
expect(asked[0]).toMatchObject({ plan: { counts: { delete: 1, replace: 1, update: 1, create: 0 }, destroys: ["app: aws_s3_bucket.logs"], replacements: ["app: aws_iam_role.app"] } });
|
|
226
|
+
});
|
|
227
|
+
|
|
228
|
+
test("below the threshold, with nothing destructive, or with no service answer, nothing is flagged", async () => {
|
|
229
|
+
expect((await checkDescription({ doc: destroying, title: "", description: "", ask: async () => ({ model: "m", probability: 0.4 }) })).status).toBe("clear");
|
|
230
|
+
expect((await checkDescription({ doc: REPORT.changeSet, title: "", description: "", ask: async () => { throw new Error("not asked"); } })).status).toBe("skipped");
|
|
231
|
+
expect((await checkDescription({ doc: destroying, title: "", description: "", ask: async () => { throw new Error("connection refused"); } })).status).toBe("error");
|
|
232
|
+
});
|
|
233
|
+
|
|
234
|
+
for (const kind of ["github", "gitlab", "forgejo"] as const) {
|
|
235
|
+
test(`the plan-note job posts the finding as its own comment (${kind})`, async () => {
|
|
236
|
+
const { forge, posted } = fakeForge(kind, { title: "Tidy logging", body: "" });
|
|
237
|
+
const finding = await respondDescription(forge, { ...REPORT, changeSet: destroying }, { ask: async () => ({ model: "noul-1", probability: 0.9 }) }, PLYWOOD);
|
|
238
|
+
expect(finding?.status).toBe("flagged");
|
|
239
|
+
expect(posted).toEqual([expect.objectContaining({ kind: "comment", pr: 12, marker: respondMarker("description", "prod") })]);
|
|
240
|
+
// A later clear answer replaces the finding in place.
|
|
241
|
+
await respondDescription(forge, { ...REPORT, changeSet: destroying }, { ask: async () => ({ model: "noul-1", probability: 0.1 }) }, PLYWOOD);
|
|
242
|
+
expect(posted).toHaveLength(1);
|
|
243
|
+
expect(posted[0]!.body).toContain("The description now covers");
|
|
244
|
+
});
|
|
245
|
+
}
|
|
246
|
+
});
|
|
247
|
+
|
|
248
|
+
describe("the product pipeline carries the responses (#4629)", () => {
|
|
249
|
+
test("CHANT_RESPOND on the apply and note jobs, the backend on the note line, respond on the waves spec", () => {
|
|
250
|
+
const jobs = productPipelineJobs("github", "prod", {
|
|
251
|
+
words: { product: "plywood" },
|
|
252
|
+
applyBeforeMerge: true,
|
|
253
|
+
respond: { "apply-failed": "off", description: "check" },
|
|
254
|
+
decide: { backend: "laya", model: "noul-1" },
|
|
255
|
+
});
|
|
256
|
+
expect(jobs.applyBeforeMerge?.env[CI_RESPOND_ENV]).toBe("apply-failed=off,description=check");
|
|
257
|
+
expect(jobs.applyBeforeMerge?.run.env[CI_RESPOND_ENV]).toBe("apply-failed=off,description=check");
|
|
258
|
+
expect(jobs.post.env[CI_RESPOND_ENV]).toBe("apply-failed=off,description=check");
|
|
259
|
+
expect(jobs.post.command).toContain('--decide-backend "laya" --decide-model "noul-1"');
|
|
260
|
+
expect(() => productPipelineJobs("github", "prod", { words: { product: "plywood" }, applyBeforeMerge: true, respond: { description: "check" } })).toThrow(/decide/);
|
|
261
|
+
const waves = productPipelineJobs("gitlab", "prod", { words: { product: "plywood", op: "plywood-up" }, waves: SPEC, respond: { "wave-refused": "off" } });
|
|
262
|
+
expect(waves.waves?.spec.respond).toEqual({ "wave-refused": "off" });
|
|
263
|
+
});
|
|
264
|
+
});
|