@intentius/chant 0.124.52 → 0.124.55
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/audit/discover.d.ts.map +1 -1
- package/dist/audit/discover.js +3 -1
- package/dist/behaviour.d.ts +1 -1
- package/dist/behaviour.d.ts.map +1 -1
- 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 +65 -0
- package/dist/capabilities/templates.d.ts.map +1 -0
- package/dist/capabilities/templates.js +192 -0
- package/dist/capabilities/templates.json +145 -0
- package/dist/change-set-graph.d.ts +35 -3
- package/dist/change-set-graph.d.ts.map +1 -1
- package/dist/change-set-graph.js +60 -9
- package/dist/change-set.d.ts +65 -7
- package/dist/change-set.d.ts.map +1 -1
- package/dist/change-set.js +22 -12
- package/dist/ci-agent.d.ts +381 -0
- package/dist/ci-agent.d.ts.map +1 -0
- package/dist/ci-agent.js +833 -0
- package/dist/ci-control.d.ts +42 -0
- package/dist/ci-control.d.ts.map +1 -0
- package/dist/ci-control.js +42 -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 +68 -0
- package/dist/ci-estate.d.ts.map +1 -0
- package/dist/ci-estate.js +83 -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 +89 -9
- package/dist/ci-identity.d.ts.map +1 -1
- package/dist/ci-identity.js +91 -16
- package/dist/ci-product-words.d.ts +290 -0
- package/dist/ci-product-words.d.ts.map +1 -0
- package/dist/ci-product-words.js +373 -0
- package/dist/ci-product.d.ts +82 -0
- package/dist/ci-product.d.ts.map +1 -0
- package/dist/ci-product.js +78 -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/import-index.d.ts +52 -0
- package/dist/cli/commands/import-index.d.ts.map +1 -0
- package/dist/cli/commands/import-index.js +226 -0
- 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/commands/lint.d.ts.map +1 -1
- package/dist/cli/commands/lint.js +4 -2
- 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/build.d.ts.map +1 -1
- package/dist/cli/handlers/build.js +43 -1
- 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 +34 -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/components.d.ts.map +1 -1
- package/dist/cli/handlers/components.js +11 -2
- package/dist/cli/handlers/fan-out.d.ts.map +1 -1
- package/dist/cli/handlers/fan-out.js +20 -3
- 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/graph.d.ts.map +1 -1
- package/dist/cli/handlers/graph.js +22 -4
- package/dist/cli/handlers/index-cloud.d.ts +14 -0
- package/dist/cli/handlers/index-cloud.d.ts.map +1 -0
- package/dist/cli/handlers/index-cloud.js +22 -0
- package/dist/cli/handlers/index-diff.d.ts +18 -0
- package/dist/cli/handlers/index-diff.d.ts.map +1 -0
- package/dist/cli/handlers/index-diff.js +142 -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 +29 -0
- package/dist/cli/handlers/lifecycle-drift.d.ts.map +1 -0
- package/dist/cli/handlers/lifecycle-drift.js +69 -0
- package/dist/cli/handlers/lifecycle.d.ts.map +1 -1
- package/dist/cli/handlers/lifecycle.js +188 -28
- package/dist/cli/handlers/lock.d.ts.map +1 -1
- package/dist/cli/handlers/lock.js +64 -5
- package/dist/cli/handlers/misc.d.ts +9 -0
- package/dist/cli/handlers/misc.d.ts.map +1 -1
- package/dist/cli/handlers/misc.js +77 -0
- 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 +38 -3
- package/dist/cli/handlers/pr.d.ts.map +1 -1
- package/dist/cli/handlers/pr.js +668 -207
- package/dist/cli/handlers/promote.d.ts.map +1 -1
- package/dist/cli/handlers/promote.js +110 -17
- package/dist/cli/handlers/query.d.ts.map +1 -1
- package/dist/cli/handlers/query.js +28 -4
- 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 +71 -1
- 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/scenario.d.ts.map +1 -1
- package/dist/cli/handlers/scenario.js +8 -7
- package/dist/cli/handlers/search.d.ts +34 -4
- package/dist/cli/handlers/search.d.ts.map +1 -1
- package/dist/cli/handlers/search.js +216 -36
- 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 +179 -14
- 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/lifecycle-tools.d.ts.map +1 -1
- package/dist/cli/mcp/lifecycle-tools.js +3 -2
- 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/resource-handlers.d.ts.map +1 -1
- package/dist/cli/mcp/resource-handlers.js +4 -3
- 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/workspace-tools.js +1 -1
- 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 +112 -5
- package/dist/cli/registry.d.ts +54 -1
- package/dist/cli/registry.d.ts.map +1 -1
- package/dist/cloud-lister/aws.d.ts +35 -0
- package/dist/cloud-lister/aws.d.ts.map +1 -0
- package/dist/cloud-lister/aws.js +203 -0
- package/dist/cloud-lister/azure.d.ts +34 -0
- package/dist/cloud-lister/azure.d.ts.map +1 -0
- package/dist/cloud-lister/azure.js +129 -0
- package/dist/cloud-lister/common.d.ts +40 -0
- package/dist/cloud-lister/common.d.ts.map +1 -0
- package/dist/cloud-lister/common.js +83 -0
- package/dist/cloud-lister/credentials.d.ts +50 -0
- package/dist/cloud-lister/credentials.d.ts.map +1 -0
- package/dist/cloud-lister/credentials.js +86 -0
- package/dist/cloud-lister/fakes.d.ts +27 -0
- package/dist/cloud-lister/fakes.d.ts.map +1 -0
- package/dist/cloud-lister/fakes.js +50 -0
- package/dist/cloud-lister/gcp.d.ts +42 -0
- package/dist/cloud-lister/gcp.d.ts.map +1 -0
- package/dist/cloud-lister/gcp.js +143 -0
- package/dist/cloud-lister/guard.d.ts +49 -0
- package/dist/cloud-lister/guard.d.ts.map +1 -0
- package/dist/cloud-lister/guard.js +103 -0
- package/dist/cloud-lister/ids.d.ts +23 -0
- package/dist/cloud-lister/ids.d.ts.map +1 -0
- package/dist/cloud-lister/ids.js +42 -0
- package/dist/cloud-lister/index.d.ts +67 -0
- package/dist/cloud-lister/index.d.ts.map +1 -0
- package/dist/cloud-lister/index.js +102 -0
- package/dist/cloud-lister/kubernetes.d.ts +64 -0
- package/dist/cloud-lister/kubernetes.d.ts.map +1 -0
- package/dist/cloud-lister/kubernetes.js +276 -0
- package/dist/cloud-lister/markers.d.ts +31 -0
- package/dist/cloud-lister/markers.d.ts.map +1 -0
- package/dist/cloud-lister/markers.js +73 -0
- package/dist/cloud-lister/mask.d.ts +31 -0
- package/dist/cloud-lister/mask.d.ts.map +1 -0
- package/dist/cloud-lister/mask.js +74 -0
- package/dist/cloud-lister/sigv4.d.ts +64 -0
- package/dist/cloud-lister/sigv4.d.ts.map +1 -0
- package/dist/cloud-lister/sigv4.js +104 -0
- package/dist/cloud-lister/transport.d.ts +55 -0
- package/dist/cloud-lister/transport.d.ts.map +1 -0
- package/dist/cloud-lister/transport.js +86 -0
- package/dist/cloud-lister/types.d.ts +121 -0
- package/dist/cloud-lister/types.d.ts.map +1 -0
- package/dist/cloud-lister/types.js +24 -0
- package/dist/components/adoption.d.ts +69 -0
- package/dist/components/adoption.d.ts.map +1 -0
- package/dist/components/adoption.js +93 -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-plugin-loader.d.ts.map +1 -1
- package/dist/components/capability-plugin-loader.js +6 -0
- package/dist/components/capability-plugin.d.ts +9 -0
- package/dist/components/capability-plugin.d.ts.map +1 -1
- package/dist/components/capability.d.ts +337 -5
- package/dist/components/capability.d.ts.map +1 -1
- package/dist/components/capability.js +14 -6
- package/dist/components/check-hooks.d.ts +113 -0
- package/dist/components/check-hooks.d.ts.map +1 -0
- package/dist/components/check-hooks.js +192 -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 +61 -0
- package/dist/components/cli-support.d.ts +34 -0
- package/dist/components/cli-support.d.ts.map +1 -1
- package/dist/components/cli-support.js +67 -15
- package/dist/components/declared-reads.d.ts +38 -0
- package/dist/components/declared-reads.d.ts.map +1 -0
- package/dist/components/declared-reads.js +131 -0
- package/dist/components/deploy-units.d.ts.map +1 -1
- package/dist/components/deploy-units.js +4 -0
- package/dist/components/driver.d.ts +54 -4
- package/dist/components/driver.d.ts.map +1 -1
- package/dist/components/driver.js +90 -7
- package/dist/components/fan-out-run.d.ts +35 -1
- package/dist/components/fan-out-run.d.ts.map +1 -1
- package/dist/components/fan-out-run.js +138 -30
- package/dist/components/fan-out-support.d.ts +6 -0
- package/dist/components/fan-out-support.d.ts.map +1 -1
- package/dist/components/fan-out-support.js +4 -1
- package/dist/components/fan-out.d.ts +28 -0
- package/dist/components/fan-out.d.ts.map +1 -1
- package/dist/components/groups.d.ts +229 -0
- package/dist/components/groups.d.ts.map +1 -0
- package/dist/components/groups.js +777 -0
- package/dist/components/index.d.ts +6 -2
- package/dist/components/index.d.ts.map +1 -1
- package/dist/components/index.js +4 -0
- package/dist/components/plan-shape-conformance.d.ts +48 -0
- package/dist/components/plan-shape-conformance.d.ts.map +1 -0
- package/dist/components/plan-shape-conformance.js +122 -0
- 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 +39 -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 +31 -3
- package/dist/components/pr-environment.d.ts.map +1 -1
- package/dist/components/pr-environment.js +25 -7
- package/dist/components/pr-pipeline.d.ts +169 -3
- package/dist/components/pr-pipeline.d.ts.map +1 -1
- package/dist/components/pr-pipeline.js +184 -9
- 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 +104 -4
- package/dist/components/pr-run.d.ts.map +1 -1
- package/dist/components/pr-run.js +290 -41
- 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 +217 -0
- package/dist/components/product-pipeline.d.ts.map +1 -0
- package/dist/components/product-pipeline.js +193 -0
- package/dist/components/promote-rounds.d.ts +9 -0
- package/dist/components/promote-rounds.d.ts.map +1 -1
- package/dist/components/promote-rounds.js +23 -2
- package/dist/components/promote.d.ts +23 -0
- package/dist/components/promote.d.ts.map +1 -1
- package/dist/components/promote.js +39 -6
- 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-gate.d.ts +23 -1
- package/dist/components/release-gate.d.ts.map +1 -1
- package/dist/components/release-gate.js +97 -33
- 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/run-groups.d.ts +58 -0
- package/dist/components/run-groups.d.ts.map +1 -0
- package/dist/components/run-groups.js +78 -0
- package/dist/components/starter-plugin.d.ts +1 -0
- package/dist/components/starter-plugin.d.ts.map +1 -1
- package/dist/components/starter-plugin.js +6 -1
- package/dist/components/verbs/index.d.ts +1 -0
- package/dist/components/verbs/index.d.ts.map +1 -1
- package/dist/components/verbs/index.js +1 -0
- package/dist/components/verbs/member-outputs.d.ts +187 -0
- package/dist/components/verbs/member-outputs.d.ts.map +1 -0
- package/dist/components/verbs/member-outputs.js +218 -0
- package/dist/components/wave-plan.d.ts +34 -0
- package/dist/components/wave-plan.d.ts.map +1 -1
- package/dist/components/wave-plan.js +54 -2
- package/dist/config.d.ts +60 -0
- package/dist/config.d.ts.map +1 -1
- package/dist/config.js +27 -0
- 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/deep-observation.d.ts +1 -13
- package/dist/deep-observation.d.ts.map +1 -1
- package/dist/deep-observation.js +5 -22
- package/dist/discovery/sandbox/bundle.d.ts.map +1 -1
- package/dist/discovery/sandbox/bundle.js +25 -1
- package/dist/drift-record.d.ts +542 -0
- package/dist/drift-record.d.ts.map +1 -0
- package/dist/drift-record.js +886 -0
- package/dist/engine-facts.d.ts +144 -0
- package/dist/engine-facts.d.ts.map +1 -0
- package/dist/engine-facts.js +13 -0
- package/dist/exit-codes.d.ts +48 -0
- package/dist/exit-codes.d.ts.map +1 -0
- package/dist/exit-codes.js +49 -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/graph-ir.d.ts +153 -2
- package/dist/graph-ir.d.ts.map +1 -1
- package/dist/graph-ir.js +224 -6
- package/dist/graph-refs.d.ts +145 -0
- package/dist/graph-refs.d.ts.map +1 -1
- package/dist/graph-refs.js +305 -0
- package/dist/graph-schema/fixtures/adopt.json +15 -0
- package/dist/graph-schema/fixtures/choudoufu.engine-graph.json +169 -0
- package/dist/graph-schema/fixtures/index.json +68 -0
- package/dist/graph-schema/fixtures/plunge.engine-graph.json +158 -0
- package/dist/graph-schema/fixtures.d.ts +23 -0
- package/dist/graph-schema/fixtures.d.ts.map +1 -0
- package/dist/graph-schema/fixtures.js +246 -0
- package/dist/graph-schema/generate.d.ts +15 -0
- package/dist/graph-schema/generate.d.ts.map +1 -0
- package/dist/graph-schema/generate.js +267 -0
- package/dist/graph-schema/graph.schema.json +1387 -0
- package/dist/health.schema.json +2 -1
- package/dist/identity.d.ts.map +1 -1
- package/dist/identity.js +2 -0
- package/dist/index.d.ts +2 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +4 -0
- package/dist/instance-nodes.d.ts +159 -0
- package/dist/instance-nodes.d.ts.map +1 -0
- package/dist/instance-nodes.js +231 -0
- package/dist/lexicon.d.ts +178 -6
- package/dist/lexicon.d.ts.map +1 -1
- package/dist/lifecycle/adoption-file.d.ts +80 -0
- package/dist/lifecycle/adoption-file.d.ts.map +1 -0
- package/dist/lifecycle/adoption-file.js +122 -0
- package/dist/lifecycle/cloud-index.d.ts +186 -0
- package/dist/lifecycle/cloud-index.d.ts.map +1 -0
- package/dist/lifecycle/cloud-index.js +617 -0
- package/dist/lifecycle/derive-edges.d.ts +59 -0
- package/dist/lifecycle/derive-edges.d.ts.map +1 -0
- package/dist/lifecycle/derive-edges.js +126 -0
- 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 +11 -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 +205 -0
- package/dist/lifecycle/git.d.ts +10 -9
- package/dist/lifecycle/git.d.ts.map +1 -1
- package/dist/lifecycle/git.js +7 -1
- package/dist/lifecycle/identity-match.d.ts +148 -0
- package/dist/lifecycle/identity-match.d.ts.map +1 -0
- package/dist/lifecycle/identity-match.js +152 -0
- package/dist/lifecycle/index-diff.d.ts +264 -0
- package/dist/lifecycle/index-diff.d.ts.map +1 -0
- package/dist/lifecycle/index-diff.js +326 -0
- package/dist/lifecycle/index-document.d.ts +130 -0
- package/dist/lifecycle/index-document.d.ts.map +1 -0
- package/dist/lifecycle/index-document.js +188 -0
- package/dist/lifecycle/index-drift.d.ts +121 -0
- package/dist/lifecycle/index-drift.d.ts.map +1 -0
- package/dist/lifecycle/index-drift.js +178 -0
- package/dist/lifecycle/index-import.d.ts +171 -0
- package/dist/lifecycle/index-import.d.ts.map +1 -0
- package/dist/lifecycle/index-import.js +512 -0
- package/dist/lifecycle/index-join.d.ts +129 -0
- package/dist/lifecycle/index-join.d.ts.map +1 -0
- package/dist/lifecycle/index-join.js +248 -0
- package/dist/lifecycle/index.d.ts +4 -0
- package/dist/lifecycle/index.d.ts.map +1 -1
- package/dist/lifecycle/index.js +4 -0
- 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/observation-baseline.d.ts +61 -21
- package/dist/lifecycle/observation-baseline.d.ts.map +1 -1
- package/dist/lifecycle/observation-baseline.js +144 -19
- package/dist/lifecycle/observe.d.ts.map +1 -1
- package/dist/lifecycle/observe.js +6 -1
- package/dist/lifecycle/query.d.ts +94 -6
- package/dist/lifecycle/query.d.ts.map +1 -1
- package/dist/lifecycle/query.js +182 -9
- 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 +10 -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 +86 -0
- package/dist/lifecycle/release-status.d.ts.map +1 -0
- package/dist/lifecycle/release-status.js +136 -0
- package/dist/lifecycle/replay.d.ts +10 -3
- package/dist/lifecycle/replay.d.ts.map +1 -1
- package/dist/lifecycle/replay.js +10 -6
- 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/scenario.d.ts +4 -3
- package/dist/lifecycle/scenario.d.ts.map +1 -1
- package/dist/lifecycle/snapshot-store-fake.d.ts +9 -0
- package/dist/lifecycle/snapshot-store-fake.d.ts.map +1 -0
- package/dist/lifecycle/snapshot-store-fake.js +21 -0
- package/dist/lifecycle/snapshot-store-s3.d.ts +135 -0
- package/dist/lifecycle/snapshot-store-s3.d.ts.map +1 -0
- package/dist/lifecycle/snapshot-store-s3.js +219 -0
- package/dist/lifecycle/snapshot-store.d.ts +170 -0
- package/dist/lifecycle/snapshot-store.d.ts.map +1 -0
- package/dist/lifecycle/snapshot-store.js +831 -0
- package/dist/lifecycle/snapshot.d.ts +11 -0
- package/dist/lifecycle/snapshot.d.ts.map +1 -1
- package/dist/lifecycle/snapshot.js +18 -5
- 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/type-listing.d.ts +148 -0
- package/dist/lifecycle/type-listing.d.ts.map +1 -0
- package/dist/lifecycle/type-listing.js +166 -0
- package/dist/lint/component-checks.d.ts +15 -1
- package/dist/lint/component-checks.d.ts.map +1 -1
- package/dist/lint/component-checks.js +1 -0
- package/dist/lint/presets/relaxed.json +2 -1
- package/dist/lint/presets/strict.json +2 -1
- package/dist/lint/rules/__fixtures__/comp/comp008/fail/dns.component.d.ts +4 -0
- package/dist/lint/rules/__fixtures__/comp/comp008/fail/dns.component.d.ts.map +1 -0
- package/dist/lint/rules/__fixtures__/comp/comp008/fail/dns.component.js +13 -0
- package/dist/lint/rules/__fixtures__/comp/comp008/pass/dns.component.d.ts +4 -0
- package/dist/lint/rules/__fixtures__/comp/comp008/pass/dns.component.d.ts.map +1 -0
- package/dist/lint/rules/__fixtures__/comp/comp008/pass/dns.component.js +8 -0
- package/dist/lint/rules/comp/comp008-applies-signal-only-root.d.ts +33 -0
- package/dist/lint/rules/comp/comp008-applies-signal-only-root.d.ts.map +1 -0
- package/dist/lint/rules/comp/comp008-applies-signal-only-root.js +123 -0
- package/dist/lint/rules/comp/index.d.ts +2 -1
- package/dist/lint/rules/comp/index.d.ts.map +1 -1
- package/dist/lint/rules/comp/index.js +4 -1
- 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/observation.d.ts +19 -2
- package/dist/observation.d.ts.map +1 -1
- package/dist/observation.js +18 -1
- package/dist/op/activities/activity-contracts.d.ts +1 -1
- package/dist/op/activities/activity-contracts.js +1 -1
- package/dist/op/activities/change-set.d.ts +6 -4
- package/dist/op/activities/change-set.d.ts.map +1 -1
- package/dist/op/activities/change-set.js +4 -2
- 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/activity-failure.d.ts +27 -0
- package/dist/op/activity-failure.d.ts.map +1 -1
- package/dist/op/activity-failure.js +31 -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 +14 -2
- package/dist/op/index.d.ts.map +1 -1
- package/dist/op/index.js +8 -2
- package/dist/op/local-executor.d.ts +5 -1
- package/dist/op/local-executor.d.ts.map +1 -1
- package/dist/op/local-executor.js +22 -8
- 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 +55 -0
- package/dist/op/op-waves-capability-spec.d.ts.map +1 -0
- package/dist/op/op-waves-capability-spec.js +94 -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 +97 -0
- package/dist/op/op-waves-run.d.ts +175 -4
- package/dist/op/op-waves-run.d.ts.map +1 -1
- package/dist/op/op-waves-run.js +981 -41
- 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 +97 -0
- package/dist/op/op-waves.d.ts +152 -8
- package/dist/op/op-waves.d.ts.map +1 -1
- package/dist/op/op-waves.js +161 -17
- package/dist/op/runtime.d.ts +91 -0
- package/dist/op/runtime.d.ts.map +1 -1
- package/dist/op/runtime.js +19 -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 +426 -0
- package/dist/override-gate.d.ts.map +1 -1
- package/dist/override-gate.js +5 -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 +103 -0
- package/dist/pr-forge.d.ts +40 -0
- package/dist/pr-forge.d.ts.map +1 -1
- package/dist/pr-forge.js +92 -0
- package/dist/pr-loop.d.ts +205 -12
- package/dist/pr-loop.d.ts.map +1 -1
- package/dist/pr-loop.js +330 -41
- package/dist/pr-post.d.ts +16 -0
- package/dist/pr-post.d.ts.map +1 -1
- package/dist/pr-post.js +26 -1
- 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 +46 -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/pulumi-urn.d.ts +101 -0
- package/dist/pulumi-urn.d.ts.map +1 -0
- package/dist/pulumi-urn.js +131 -0
- package/dist/release-floors.d.ts +23 -0
- package/dist/release-floors.d.ts.map +1 -0
- package/dist/release-floors.js +22 -0
- package/dist/run-event.d.ts +26 -1
- package/dist/run-event.d.ts.map +1 -1
- package/dist/run-event.js +4 -1
- package/dist/sensitive-key.d.ts +23 -0
- package/dist/sensitive-key.d.ts.map +1 -0
- package/dist/sensitive-key.js +31 -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 +390 -285
- package/dist/workspace/adoption-report.d.ts +53 -0
- package/dist/workspace/adoption-report.d.ts.map +1 -0
- package/dist/workspace/adoption-report.js +76 -0
- package/dist/workspace/capabilities-contract.d.ts +7 -0
- package/dist/workspace/capabilities-contract.d.ts.map +1 -1
- package/dist/workspace/capabilities-contract.js +2 -1
- package/dist/workspace/capabilities.schema.json +98 -0
- package/dist/workspace/change-set.schema.json +42 -3
- 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-cloud-identity.d.ts +13 -1
- package/dist/workspace/ci-cloud-identity.d.ts.map +1 -1
- package/dist/workspace/ci-cloud-identity.js +30 -1
- package/dist/workspace/ci-lock-grain.d.ts +12 -0
- package/dist/workspace/ci-lock-grain.d.ts.map +1 -0
- package/dist/workspace/ci-lock-grain.js +27 -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 +6 -3
- package/dist/workspace/compose-graph.d.ts +10 -1
- package/dist/workspace/compose-graph.d.ts.map +1 -1
- package/dist/workspace/compose-graph.js +6 -1
- package/dist/workspace/conformance/index.d.ts +1 -1
- package/dist/workspace/conformance/index.d.ts.map +1 -1
- package/dist/workspace/conformance/index.js +6 -1
- 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 +81 -0
- package/dist/workspace/drift-cli.d.ts.map +1 -0
- package/dist/workspace/drift-cli.js +322 -0
- package/dist/workspace/drift.schema.json +672 -0
- 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/graph-cli.d.ts +2 -0
- package/dist/workspace/graph-cli.d.ts.map +1 -1
- package/dist/workspace/graph-cli.js +3 -0
- package/dist/workspace/graph.schema.json +72 -0
- 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/init.d.ts +5 -1
- package/dist/workspace/init.d.ts.map +1 -1
- package/dist/workspace/init.js +55 -9
- 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/nested-graph.d.ts.map +1 -1
- package/dist/workspace/nested-graph.js +2 -0
- package/dist/workspace/pr-report.schema.json +125 -5
- package/dist/workspace/promote-waves.d.ts +112 -0
- package/dist/workspace/promote-waves.d.ts.map +1 -0
- package/dist/workspace/promote-waves.js +290 -0
- package/dist/workspace/promote.d.ts +85 -3
- package/dist/workspace/promote.d.ts.map +1 -1
- package/dist/workspace/promote.js +349 -62
- package/dist/workspace/reason-codes.d.ts +12 -0
- package/dist/workspace/reason-codes.d.ts.map +1 -1
- package/dist/workspace/reason-codes.js +14 -0
- 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/search-contract.d.ts +3 -3
- package/dist/workspace/search-contract.d.ts.map +1 -1
- package/dist/workspace/search-contract.js +2 -0
- package/dist/workspace/search.schema.json +103 -5
- 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 +34 -1
- package/src/__fixtures__/drift-record/README.md +58 -0
- package/src/__fixtures__/drift-record/choudoufu-cone.ndjson +4 -0
- package/src/__fixtures__/drift-record/choudoufu-resource.ndjson +3 -0
- package/src/__fixtures__/drift-record/component-status-ledger.json +65 -0
- package/src/__fixtures__/drift-record/component-status.json +91 -0
- package/src/__fixtures__/drift-record/deep-diff.json +259 -0
- package/src/__fixtures__/drift-record/lifecycle-diff-live.json +825 -0
- package/src/__fixtures__/drift-record/live-diff.json +125 -0
- 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/audit/discover.e2e.test.ts +14 -0
- package/src/audit/discover.ts +3 -1
- package/src/behaviour.ts +1 -1
- 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.json +145 -0
- package/src/capabilities/templates.test.ts +211 -0
- package/src/capabilities/templates.ts +203 -0
- package/src/cdk/advise.test.ts +1 -1
- package/src/change-set-bundle.test.ts +82 -0
- package/src/change-set-graph.ts +80 -9
- package/src/change-set.test.ts +24 -0
- package/src/change-set.ts +76 -14
- package/src/ci-agent.test.ts +348 -0
- package/src/ci-agent.ts +1026 -0
- package/src/ci-control.ts +174 -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 +176 -0
- package/src/ci-handover.ts +67 -16
- package/src/ci-identity-database.test.ts +55 -0
- package/src/ci-identity-pulumi.test.ts +163 -0
- package/src/ci-identity-targets.test.ts +29 -2
- package/src/ci-identity.ts +134 -26
- package/src/ci-product-words.test.ts +101 -0
- package/src/ci-product-words.ts +536 -0
- package/src/ci-product.ts +174 -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/import-index.test.ts +117 -0
- package/src/cli/commands/import-index.ts +265 -0
- package/src/cli/commands/init.ts +3 -1
- package/src/cli/commands/lint.ts +4 -2
- 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/build.test.ts +7 -0
- package/src/cli/handlers/build.ts +44 -1
- package/src/cli/handlers/ci-check.ts +33 -0
- package/src/cli/handlers/ci-forge-check.ts +91 -0
- package/src/cli/handlers/components.test.ts +9 -0
- package/src/cli/handlers/components.ts +12 -2
- package/src/cli/handlers/fan-out.test.ts +10 -10
- package/src/cli/handlers/fan-out.ts +22 -3
- package/src/cli/handlers/gate-pending.ts +46 -0
- package/src/cli/handlers/graph.test.ts +42 -0
- package/src/cli/handlers/graph.ts +26 -4
- package/src/cli/handlers/index-cloud.ts +32 -0
- package/src/cli/handlers/index-diff.test.ts +68 -0
- package/src/cli/handlers/index-diff.ts +146 -0
- package/src/cli/handlers/init.ts +1 -0
- package/src/cli/handlers/ledger-root-member.test.ts +161 -0
- package/src/cli/handlers/ledger.ts +1 -1
- package/src/cli/handlers/lifecycle-drift.ts +73 -0
- package/src/cli/handlers/lifecycle.test.ts +33 -11
- package/src/cli/handlers/lifecycle.ts +205 -30
- package/src/cli/handlers/lock.test.ts +29 -2
- package/src/cli/handlers/lock.ts +66 -6
- package/src/cli/handlers/misc.ts +73 -0
- 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-targets.test.ts +155 -0
- package/src/cli/handlers/pr-waves-blocked.test.ts +42 -2
- 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 +669 -207
- package/src/cli/handlers/promote.test.ts +69 -5
- package/src/cli/handlers/promote.ts +103 -8
- package/src/cli/handlers/query.ts +27 -4
- package/src/cli/handlers/release.ts +2 -0
- package/src/cli/handlers/run-components-exit.test.ts +7 -7
- package/src/cli/handlers/run-declared-reads-cli.test.ts +187 -0
- package/src/cli/handlers/run-groups-cli.test.ts +229 -0
- package/src/cli/handlers/run-wave.ts +65 -1
- package/src/cli/handlers/run.test.ts +6 -4
- package/src/cli/handlers/run.ts +86 -1
- package/src/cli/handlers/scenario.test.ts +13 -0
- package/src/cli/handlers/scenario.ts +8 -7
- package/src/cli/handlers/search-index.test.ts +255 -0
- package/src/cli/handlers/search-json.test.ts +1 -1
- package/src/cli/handlers/search-ownership.test.ts +194 -0
- package/src/cli/handlers/search.ts +271 -38
- package/src/cli/handlers/serve.ts +10 -1
- package/src/cli/main.test.ts +7 -0
- package/src/cli/main.ts +182 -14
- package/src/cli/mcp/ledger-tools.ts +126 -0
- package/src/cli/mcp/lifecycle-tools.ts +3 -2
- 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/resource-handlers.ts +4 -3
- package/src/cli/mcp/server.test.ts +5 -4
- package/src/cli/mcp/server.ts +90 -16
- package/src/cli/mcp/workspace-tools.ts +1 -1
- package/src/cli/mcp-config.ts +8 -3
- package/src/cli/parse-args.ts +82 -4
- package/src/cli/registry.ts +54 -1
- package/src/cloud-lister/aws.test.ts +202 -0
- package/src/cloud-lister/aws.ts +226 -0
- package/src/cloud-lister/azure.test.ts +132 -0
- package/src/cloud-lister/azure.ts +142 -0
- package/src/cloud-lister/common.ts +115 -0
- package/src/cloud-lister/credentials.ts +110 -0
- package/src/cloud-lister/fakes.ts +66 -0
- package/src/cloud-lister/gcp.test.ts +121 -0
- package/src/cloud-lister/gcp.ts +159 -0
- package/src/cloud-lister/guard.test.ts +198 -0
- package/src/cloud-lister/guard.ts +111 -0
- package/src/cloud-lister/ids.ts +54 -0
- package/src/cloud-lister/index.ts +134 -0
- package/src/cloud-lister/kubernetes.test.ts +160 -0
- package/src/cloud-lister/kubernetes.ts +284 -0
- package/src/cloud-lister/markers.ts +74 -0
- package/src/cloud-lister/mask.ts +77 -0
- package/src/cloud-lister/shape.test.ts +81 -0
- package/src/cloud-lister/sigv4.ts +127 -0
- package/src/cloud-lister/transport.ts +118 -0
- package/src/cloud-lister/types.ts +135 -0
- package/src/components/adoption.test.ts +140 -0
- package/src/components/adoption.ts +141 -0
- package/src/components/apply-lease.ts +49 -0
- package/src/components/capability-plugin-loader.ts +4 -0
- package/src/components/capability-plugin.ts +10 -0
- package/src/components/capability.ts +359 -6
- package/src/components/check-hooks.test.ts +66 -0
- package/src/components/check-hooks.ts +252 -0
- package/src/components/ci-services.test.ts +51 -0
- package/src/components/ci-services.ts +83 -0
- package/src/components/cli-support.ts +92 -15
- package/src/components/declared-reads.test.ts +103 -0
- package/src/components/declared-reads.ts +134 -0
- package/src/components/deploy-units.ts +4 -0
- package/src/components/driver.test.ts +3 -3
- package/src/components/driver.ts +127 -9
- package/src/components/fan-out-run.ts +163 -33
- package/src/components/fan-out-support.ts +10 -1
- package/src/components/fan-out.ts +30 -0
- package/src/components/groups.test.ts +320 -0
- package/src/components/groups.ts +895 -0
- package/src/components/index.ts +42 -0
- package/src/components/plan-shape-conformance.ts +130 -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 +43 -0
- package/src/components/pr-env-ports.ts +29 -4
- package/src/components/pr-env-run-bundle.test.ts +10 -0
- 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 +39 -7
- package/src/components/pr-pipeline.test.ts +15 -0
- package/src/components/pr-pipeline.ts +274 -9
- package/src/components/pr-policy.ts +45 -7
- package/src/components/pr-run.test.ts +516 -3
- package/src/components/pr-run.ts +350 -44
- 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 +341 -0
- package/src/components/promote-rounds.ts +25 -2
- package/src/components/promote.ts +64 -5
- package/src/components/registry.test.ts +1 -1
- package/src/components/release-compile.ts +87 -1
- package/src/components/release-gate.ts +115 -30
- package/src/components/release-groups.test.ts +362 -0
- 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/run-groups.ts +113 -0
- package/src/components/starter-plugin.ts +6 -0
- package/src/components/verbs/index.ts +1 -0
- package/src/components/verbs/member-outputs.test.ts +205 -0
- package/src/components/verbs/member-outputs.ts +308 -0
- package/src/components/wave-plan-policy.test.ts +19 -0
- package/src/components/wave-plan.ts +78 -4
- package/src/config.ts +44 -0
- 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/deep-observation.ts +5 -23
- package/src/discovery/sandbox/bundle.ts +25 -1
- package/src/drift-record.test.ts +596 -0
- package/src/drift-record.ts +1206 -0
- package/src/engine-facts.guard.test.ts +111 -0
- package/src/engine-facts.test.ts +177 -0
- package/src/engine-facts.ts +153 -0
- package/src/exit-codes.test.ts +31 -0
- package/src/exit-codes.ts +55 -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 +13 -0
- package/src/gate-decision.ts +3 -0
- package/src/gate-policy.ts +92 -3
- package/src/gated-waves-bundle.test.ts +1 -0
- package/src/graph-ir-live.test.ts +92 -0
- package/src/graph-ir.ts +317 -7
- package/src/graph-refs.ts +416 -0
- package/src/graph-schema/fixtures/adopt.json +15 -0
- package/src/graph-schema/fixtures/choudoufu.engine-graph.json +169 -0
- package/src/graph-schema/fixtures/index.json +68 -0
- package/src/graph-schema/fixtures/plunge.engine-graph.json +158 -0
- package/src/graph-schema/fixtures.ts +267 -0
- package/src/graph-schema/generate.ts +263 -0
- package/src/graph-schema/graph-schema.test.ts +153 -0
- package/src/graph-schema/graph.schema.json +1387 -0
- package/src/health.schema.json +2 -1
- package/src/identity.ts +2 -0
- package/src/index.ts +4 -0
- package/src/instance-nodes.ts +288 -0
- package/src/lexicon.ts +171 -6
- package/src/lifecycle/__fixtures__/index-diff/20261026T120000Z-aaaaaaaaaaaa.json +149 -0
- package/src/lifecycle/__fixtures__/index-diff/20261026T130000Z-bbbbbbbbbbbb.json +127 -0
- package/src/lifecycle/adoption-file.test.ts +100 -0
- package/src/lifecycle/adoption-file.ts +153 -0
- package/src/lifecycle/cloud-index.test.ts +516 -0
- package/src/lifecycle/cloud-index.ts +735 -0
- package/src/lifecycle/control-entries-ledger.test.ts +70 -0
- package/src/lifecycle/derive-edges.test.ts +193 -0
- package/src/lifecycle/derive-edges.ts +182 -0
- package/src/lifecycle/gate-applied.ts +6 -0
- package/src/lifecycle/gate-ledger.ts +36 -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 +280 -0
- package/src/lifecycle/git.ts +10 -4
- package/src/lifecycle/identity-match.test.ts +308 -0
- package/src/lifecycle/identity-match.ts +276 -0
- package/src/lifecycle/index-diff.test.ts +198 -0
- package/src/lifecycle/index-diff.ts +475 -0
- package/src/lifecycle/index-document.test.ts +64 -0
- package/src/lifecycle/index-document.ts +298 -0
- package/src/lifecycle/index-drift.test.ts +191 -0
- package/src/lifecycle/index-drift.ts +304 -0
- package/src/lifecycle/index-import.test.ts +269 -0
- package/src/lifecycle/index-import.ts +654 -0
- package/src/lifecycle/index-join.test.ts +250 -0
- package/src/lifecycle/index-join.ts +304 -0
- package/src/lifecycle/index-store-load-bearing.test.ts +187 -0
- package/src/lifecycle/index.ts +4 -0
- 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/member-ledger.test.ts +25 -7
- package/src/lifecycle/observation-baseline.test.ts +72 -1
- package/src/lifecycle/observation-baseline.ts +190 -27
- package/src/lifecycle/observe.ts +6 -1
- package/src/lifecycle/publish-target-context.test.ts +108 -0
- package/src/lifecycle/query.test.ts +68 -1
- package/src/lifecycle/query.ts +208 -13
- 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 +193 -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 +20 -0
- package/src/lifecycle/release-publish.ts +45 -22
- package/src/lifecycle/release-read.ts +2 -0
- package/src/lifecycle/release-status.test.ts +186 -0
- package/src/lifecycle/release-status.ts +176 -0
- package/src/lifecycle/replay.test.ts +9 -5
- package/src/lifecycle/replay.ts +9 -5
- 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/scenario.ts +4 -3
- package/src/lifecycle/snapshot-store-fake.ts +29 -0
- package/src/lifecycle/snapshot-store-s3.ts +280 -0
- package/src/lifecycle/snapshot-store.test.ts +385 -0
- package/src/lifecycle/snapshot-store.ts +980 -0
- package/src/lifecycle/snapshot.test.ts +13 -0
- package/src/lifecycle/snapshot.ts +23 -6
- package/src/lifecycle/target-lock.ts +24 -9
- package/src/lifecycle/type-listing.test.ts +166 -0
- package/src/lifecycle/type-listing.ts +309 -0
- package/src/lint/component-checks.ts +17 -1
- package/src/lint/config.test.ts +3 -0
- package/src/lint/presets/relaxed.json +2 -1
- package/src/lint/presets/strict.json +2 -1
- package/src/lint/rules/__fixtures__/comp/comp008/fail/dns.component.ts +15 -0
- package/src/lint/rules/__fixtures__/comp/comp008/pass/dns.component.ts +10 -0
- package/src/lint/rules/comp/comp.test.ts +2 -1
- package/src/lint/rules/comp/comp008-applies-signal-only-root.ts +121 -0
- package/src/lint/rules/comp/comp008.test.ts +77 -0
- package/src/lint/rules/comp/index.ts +4 -1
- 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/observation-edges.test.ts +33 -0
- package/src/observation.ts +36 -1
- package/src/op/activities/activity-contracts.ts +1 -1
- package/src/op/activities/change-set.ts +8 -5
- 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/activity-failure.ts +36 -0
- package/src/op/gate.ts +81 -22
- package/src/op/generate-pipeline.ts +7 -1
- package/src/op/index.ts +23 -1
- package/src/op/local-executor.test.ts +80 -0
- package/src/op/local-executor.ts +27 -9
- package/src/op/op-waves-after-plan.test.ts +276 -0
- package/src/op/op-waves-after-plan.ts +238 -0
- package/src/op/op-waves-capability-spec.ts +113 -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-pull-request.test.ts +142 -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 +133 -0
- package/src/op/op-waves-run-record.test.ts +32 -0
- package/src/op/op-waves-run.ts +1142 -49
- package/src/op/op-waves-stand-down.test.ts +240 -0
- package/src/op/op-waves-stand-down.ts +108 -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 +261 -20
- package/src/op/runtime.ts +104 -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 +544 -0
- package/src/override-gate-bundle.test.ts +2 -0
- package/src/override-gate.ts +4 -0
- package/src/policy-packs.ts +230 -0
- package/src/policy-source.test.ts +256 -0
- package/src/policy-source.ts +112 -0
- package/src/pr-forge.ts +123 -0
- package/src/pr-loop-bundle.test.ts +9 -2
- package/src/pr-loop-words.test.ts +155 -0
- package/src/pr-loop.test.ts +43 -0
- package/src/pr-loop.ts +478 -50
- package/src/pr-post.ts +32 -1
- package/src/pr-report-url.ts +62 -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 +211 -0
- package/src/pulumi-urn.ts +151 -0
- package/src/release-floors.ts +22 -0
- package/src/run-event.ts +29 -1
- package/src/sensitive-key.ts +34 -0
- package/src/sorted-json.ts +17 -0
- package/src/stage-hooks-bundle.test.ts +8 -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/adoption-report.test.ts +61 -0
- package/src/workspace/adoption-report.ts +103 -0
- package/src/workspace/capabilities-contract.test.ts +4 -0
- package/src/workspace/capabilities-contract.ts +9 -1
- package/src/workspace/capabilities.schema.json +98 -0
- package/src/workspace/change-set.schema.json +42 -3
- package/src/workspace/chant-migrations/chud-lexicon-exit.ts +4 -1
- package/src/workspace/ci-cloud-identity.ts +31 -1
- package/src/workspace/ci-lock-grain.test.ts +31 -0
- package/src/workspace/ci-lock-grain.ts +30 -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 +6 -3
- package/src/workspace/compose-graph.test.ts +12 -0
- package/src/workspace/compose-graph.ts +12 -1
- package/src/workspace/conformance/conformance.e2e.test.ts +2 -1
- package/src/workspace/conformance/index.ts +6 -1
- 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.test.ts +65 -0
- package/src/workspace/drift-cli.ts +370 -0
- package/src/workspace/drift.schema.json +672 -0
- package/src/workspace/exit-cli.ts +2 -1
- package/src/workspace/graph-cli.ts +5 -0
- package/src/workspace/graph.schema.json +72 -0
- package/src/workspace/import-fetch.ts +4 -2
- package/src/workspace/import-init.ts +4 -2
- package/src/workspace/init.test.ts +38 -1
- package/src/workspace/init.ts +50 -8
- package/src/workspace/intent-gaps.test.ts +18 -2
- package/src/workspace/ledger.schema.json +7 -3
- package/src/workspace/lineage-upgrade-cli.ts +2 -1
- package/src/workspace/nested-graph.ts +1 -0
- package/src/workspace/pr-report.schema.json +125 -5
- package/src/workspace/promote-waves.test.ts +296 -0
- package/src/workspace/promote-waves.ts +340 -0
- package/src/workspace/promote.test.ts +158 -4
- package/src/workspace/promote.ts +400 -58
- package/src/workspace/reason-codes.test.ts +4 -1
- package/src/workspace/reason-codes.ts +14 -0
- 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/search-contract.ts +2 -0
- package/src/workspace/search.schema.json +103 -5
- package/src/workspace/work-cli.ts +8 -2
- package/src/workspace/workspace-run.ts +2 -1
|
@@ -0,0 +1,198 @@
|
|
|
1
|
+
// #4533 (moved from INTENTIUS/behold#1028): the diff of two index versions. Two fixture
|
|
2
|
+
// versions of one aws scope (./__fixtures__/index-diff/), the scope-mismatch refusal, a type
|
|
3
|
+
// unobserved in one read never reported as removed, edges, and reading versions through a store.
|
|
4
|
+
import { copyFileSync, mkdirSync, mkdtempSync, readFileSync } from "node:fs";
|
|
5
|
+
import { tmpdir } from "node:os";
|
|
6
|
+
import { join } from "node:path";
|
|
7
|
+
import { describe, expect, it } from "vitest";
|
|
8
|
+
import {
|
|
9
|
+
diffIndexVersionRefs,
|
|
10
|
+
diffIndexVersions,
|
|
11
|
+
indexAbsence,
|
|
12
|
+
IndexScopeMismatch,
|
|
13
|
+
NotAnIndexVersion,
|
|
14
|
+
parseIndexVersionRef,
|
|
15
|
+
readIndexVersionRef,
|
|
16
|
+
type IndexDiffDocument,
|
|
17
|
+
} from "./index-diff";
|
|
18
|
+
import { indexCoverageFor, type IndexDocument } from "./index-document";
|
|
19
|
+
import { createSnapshotStore } from "./snapshot-store";
|
|
20
|
+
|
|
21
|
+
const DIR = join(import.meta.dirname, "__fixtures__", "index-diff");
|
|
22
|
+
const V1 = "20261026T120000Z-aaaaaaaaaaaa.json";
|
|
23
|
+
const V2 = "20261026T130000Z-bbbbbbbbbbbb.json";
|
|
24
|
+
const SCOPE = "cloud/aws/000000000000/5c1f0e2a9b7d";
|
|
25
|
+
const load = (name: string): IndexDiffDocument => JSON.parse(readFileSync(join(DIR, name), "utf8")) as IndexDiffDocument;
|
|
26
|
+
const B = (n: string) => `aws/000000000000/us-east-1/AWS::S3::Bucket/${n}`;
|
|
27
|
+
const ROLE = "aws/000000000000/us-east-1/AWS::IAM::Role/app-role";
|
|
28
|
+
const QUEUE = "aws/000000000000/us-east-1/AWS::SQS::Queue/jobs";
|
|
29
|
+
|
|
30
|
+
describe("diffIndexVersions over two fixture versions", () => {
|
|
31
|
+
const d = diffIndexVersions(load(V1), load(V2), { fromVersion: V1, toVersion: V2 });
|
|
32
|
+
|
|
33
|
+
it("shows both stamps and the scope", () => {
|
|
34
|
+
expect(d.scopeKey).toBe(SCOPE);
|
|
35
|
+
expect(d.from).toMatchObject({ version: V1, observedAt: "2026-10-26T12:00:00Z" });
|
|
36
|
+
expect(d.to).toMatchObject({ version: V2, observedAt: "2026-10-26T13:00:00Z" });
|
|
37
|
+
expect(d.unchanged).toBe(false);
|
|
38
|
+
});
|
|
39
|
+
|
|
40
|
+
it("one changed property on the edited bucket, and nothing for the tag that did not move", () => {
|
|
41
|
+
expect(d.nodes.changed).toEqual([
|
|
42
|
+
{ key: B("web-logs"), kind: "AWS::S3::Bucket", listedType: "AWS::S3::Bucket", location: "us-east-1", properties: [{ path: "attrs.VersioningConfiguration.Status", before: "Suspended", after: "Enabled" }] },
|
|
43
|
+
]);
|
|
44
|
+
expect(d.counts.properties).toBe(1);
|
|
45
|
+
});
|
|
46
|
+
|
|
47
|
+
it("adds and removes nodes only where both reads listed the type", () => {
|
|
48
|
+
expect(d.nodes.added.map((n) => n.key)).toEqual([B("new-bucket")]);
|
|
49
|
+
expect(d.nodes.removed.map((n) => n.key)).toEqual([B("old-bucket")]);
|
|
50
|
+
});
|
|
51
|
+
|
|
52
|
+
it("edges: added, removed, and not observed when an end's type was not listed", () => {
|
|
53
|
+
expect(d.edges.added.map((e) => [e.from, e.to])).toEqual([[ROLE, B("new-bucket")]]);
|
|
54
|
+
expect(d.edges.removed.map((e) => [e.from, e.to])).toEqual([[ROLE, B("old-bucket")]]);
|
|
55
|
+
expect(d.edges.notObserved).toEqual([expect.objectContaining({ from: ROLE, to: QUEUE, side: "to", unobservedEnd: QUEUE, verdict: "read-failed" })]);
|
|
56
|
+
expect(d.edges.removed.some((e) => e.to === QUEUE)).toBe(false);
|
|
57
|
+
});
|
|
58
|
+
|
|
59
|
+
it("names the coverage verdict that moved", () => {
|
|
60
|
+
expect(d.coverage).toEqual([{ listedType: "AWS::SQS::Queue", location: "us-east-1", before: "listed", after: "read-failed" }]);
|
|
61
|
+
});
|
|
62
|
+
|
|
63
|
+
it("the reverse diff swaps added and removed, and the queue is first observed, never added", () => {
|
|
64
|
+
const r = diffIndexVersions(load(V2), load(V1));
|
|
65
|
+
expect(r.nodes.added.map((n) => n.key)).toEqual([B("old-bucket")]);
|
|
66
|
+
expect(r.nodes.removed.map((n) => n.key)).toEqual([B("new-bucket")]);
|
|
67
|
+
expect(r.nodes.notObserved).toEqual([expect.objectContaining({ key: QUEUE, side: "from", verdict: "read-failed" })]);
|
|
68
|
+
});
|
|
69
|
+
|
|
70
|
+
it("same digest: unchanged, nothing walked", () => {
|
|
71
|
+
const a = load(V1);
|
|
72
|
+
const u = diffIndexVersions(a, { ...a, graph: { nodes: [], edges: [] } });
|
|
73
|
+
expect(u.unchanged).toBe(true);
|
|
74
|
+
expect(u.counts.removed).toBe(0);
|
|
75
|
+
});
|
|
76
|
+
|
|
77
|
+
it("takes chant's own IndexDocument", () => {
|
|
78
|
+
const doc = load(V1) as unknown as IndexDocument;
|
|
79
|
+
expect(diffIndexVersions(doc, doc).unchanged).toBe(true);
|
|
80
|
+
});
|
|
81
|
+
});
|
|
82
|
+
|
|
83
|
+
describe("a scope mismatch", () => {
|
|
84
|
+
it("is refused by name, with both scope keys", () => {
|
|
85
|
+
const a = load(V1);
|
|
86
|
+
const b = load(V2);
|
|
87
|
+
b.stamp = { ...b.stamp, scopeKey: "cloud/aws/000000000000/0123456789ab" };
|
|
88
|
+
expect(() => diffIndexVersions(a, b)).toThrow(IndexScopeMismatch);
|
|
89
|
+
try {
|
|
90
|
+
diffIndexVersions(a, b);
|
|
91
|
+
} catch (e) {
|
|
92
|
+
expect((e as IndexScopeMismatch).code).toBe("index-scope-mismatch");
|
|
93
|
+
expect((e as Error).message).toContain(SCOPE);
|
|
94
|
+
expect((e as Error).message).toContain("cloud/aws/000000000000/0123456789ab");
|
|
95
|
+
}
|
|
96
|
+
});
|
|
97
|
+
|
|
98
|
+
it("a document of another shape is not an index version", () => {
|
|
99
|
+
expect(() => diffIndexVersions({ index: "v2" } as unknown as IndexDiffDocument, load(V1))).toThrow(NotAnIndexVersion);
|
|
100
|
+
});
|
|
101
|
+
});
|
|
102
|
+
|
|
103
|
+
describe("an unobserved type is never reported as removed", () => {
|
|
104
|
+
it("a type with no coverage entry in the later read is not observed, not removed", () => {
|
|
105
|
+
const b = load(V2);
|
|
106
|
+
b.coverage = b.coverage.filter((c) => c.listedType !== "AWS::S3::Bucket");
|
|
107
|
+
const d = diffIndexVersions(load(V1), b);
|
|
108
|
+
expect(d.nodes.removed).toEqual([]);
|
|
109
|
+
expect(d.nodes.notObserved.filter((n) => n.listedType === "AWS::S3::Bucket" && n.side === "to").map((n) => [n.key, n.verdict])).toEqual([[B("old-bucket"), "not-in-coverage"]]);
|
|
110
|
+
});
|
|
111
|
+
|
|
112
|
+
it("a wildcard entry speaks for every type and location; a wildcard read-failed does not", () => {
|
|
113
|
+
const b = load(V2);
|
|
114
|
+
b.coverage = [{ listedType: "*", location: "*", verdict: "listed" }];
|
|
115
|
+
expect(diffIndexVersions(load(V1), b).nodes.removed.map((n) => n.key)).toEqual([B("old-bucket"), QUEUE]);
|
|
116
|
+
b.coverage = [{ listedType: "*", location: "us-east-1", verdict: "read-failed" }];
|
|
117
|
+
const d = diffIndexVersions(load(V1), b);
|
|
118
|
+
expect(d.nodes.removed).toEqual([]);
|
|
119
|
+
expect(d.edges.removed).toEqual([]);
|
|
120
|
+
});
|
|
121
|
+
|
|
122
|
+
it("indexAbsence is indexCoverageFor's rule: exact over wildcard, listed means removed", () => {
|
|
123
|
+
const cov = [
|
|
124
|
+
{ listedType: "*", location: "*", verdict: "listed" },
|
|
125
|
+
{ listedType: "AWS::SQS::Queue", location: "*", verdict: "access-denied", detail: "no sqs:ListQueues" },
|
|
126
|
+
{ listedType: "AWS::SQS::Queue", location: "eu-west-1", verdict: "listed" },
|
|
127
|
+
];
|
|
128
|
+
expect(indexAbsence(cov, "AWS::SQS::Queue", "eu-west-1")).toEqual({ kind: "removed" });
|
|
129
|
+
expect(indexAbsence(cov, "AWS::SQS::Queue", "us-east-1")).toEqual({ kind: "not-observed", verdict: "access-denied", detail: "no sqs:ListQueues" });
|
|
130
|
+
expect(indexAbsence(cov, "AWS::S3::Bucket", "us-east-1")).toEqual({ kind: "removed" });
|
|
131
|
+
expect(indexAbsence([], "AWS::S3::Bucket", "us-east-1")).toEqual({ kind: "not-observed", verdict: "not-in-coverage" });
|
|
132
|
+
expect(indexCoverageFor(cov, "AWS::SQS::Queue", "us-east-1")?.verdict).toBe("access-denied");
|
|
133
|
+
});
|
|
134
|
+
});
|
|
135
|
+
|
|
136
|
+
describe("version references", () => {
|
|
137
|
+
it("parses <scopeKey>/<version>, <scopeKey>, and a bare version in another's scope", () => {
|
|
138
|
+
expect(parseIndexVersionRef(`${SCOPE}/${V1}`)).toEqual({ scopeKey: SCOPE, version: V1 });
|
|
139
|
+
expect(parseIndexVersionRef(`${SCOPE}/`)).toEqual({ scopeKey: SCOPE });
|
|
140
|
+
expect(parseIndexVersionRef(V2, SCOPE)).toEqual({ scopeKey: SCOPE, version: V2 });
|
|
141
|
+
expect(() => parseIndexVersionRef(V2)).toThrow(/no scope/);
|
|
142
|
+
});
|
|
143
|
+
});
|
|
144
|
+
|
|
145
|
+
/** A local store holding both fixture versions of one scope, and one version of another. */
|
|
146
|
+
function localStore() {
|
|
147
|
+
const cwd = mkdtempSync(join(tmpdir(), "chant-index-diff-"));
|
|
148
|
+
const scope = join(cwd, "store", "index", ...SCOPE.split("/"));
|
|
149
|
+
mkdirSync(scope, { recursive: true });
|
|
150
|
+
copyFileSync(join(DIR, V1), join(scope, V1));
|
|
151
|
+
copyFileSync(join(DIR, V2), join(scope, V2));
|
|
152
|
+
const other = join(cwd, "store", "index", "cloud", "aws", "000000000000", "0123456789ab");
|
|
153
|
+
mkdirSync(other, { recursive: true });
|
|
154
|
+
copyFileSync(join(DIR, V1), join(other, "20261026T140000Z-cccccccccccc.json"));
|
|
155
|
+
return createSnapshotStore({ store: "local", dir: "store" }, { cwd });
|
|
156
|
+
}
|
|
157
|
+
|
|
158
|
+
describe("reading versions through the store (#4519)", () => {
|
|
159
|
+
it("a scope alone diffs its last two versions", async () => {
|
|
160
|
+
const d = await diffIndexVersionRefs(localStore(), { scopeKey: SCOPE });
|
|
161
|
+
expect(d.from.version).toBe(V1);
|
|
162
|
+
expect(d.to.version).toBe(V2);
|
|
163
|
+
expect(d.counts.properties).toBe(1);
|
|
164
|
+
});
|
|
165
|
+
|
|
166
|
+
it("a scope's latest version, and a version the store lacks", async () => {
|
|
167
|
+
const store = localStore();
|
|
168
|
+
expect((await readIndexVersionRef(store, { scopeKey: SCOPE })).version).toBe(V2);
|
|
169
|
+
await expect(readIndexVersionRef(store, { scopeKey: SCOPE, version: "20261026T150000Z-dddddddddddd.json" })).rejects.toThrow(NotAnIndexVersion);
|
|
170
|
+
});
|
|
171
|
+
|
|
172
|
+
it("refuses two references under different scope paths before reading either", async () => {
|
|
173
|
+
await expect(
|
|
174
|
+
diffIndexVersionRefs(localStore(), { scopeKey: SCOPE, version: V1 }, { scopeKey: "cloud/aws/000000000000/0123456789ab", version: "20261026T140000Z-cccccccccccc.json" }),
|
|
175
|
+
).rejects.toMatchObject({ code: "index-scope-mismatch" });
|
|
176
|
+
});
|
|
177
|
+
|
|
178
|
+
it("a stored version whose stamp names another scope than its path is refused", async () => {
|
|
179
|
+
// The other scope path holds V1's document, whose stamp names SCOPE; its latest against
|
|
180
|
+
// a version of that path compares the stamps and refuses.
|
|
181
|
+
const store = localStore();
|
|
182
|
+
const other = await readIndexVersionRef(store, { scopeKey: "cloud/aws/000000000000/0123456789ab" });
|
|
183
|
+
const b = { ...load(V2), stamp: { ...load(V2).stamp, scopeKey: "cloud/aws/000000000000/0123456789ab" } };
|
|
184
|
+
expect(() => diffIndexVersions(other.doc, b)).toThrow(/different scopes/);
|
|
185
|
+
});
|
|
186
|
+
|
|
187
|
+
it("one version in a scope has nothing before it", async () => {
|
|
188
|
+
await expect(diffIndexVersionRefs(localStore(), { scopeKey: "cloud/aws/000000000000/0123456789ab" })).rejects.toThrow(/no version before/);
|
|
189
|
+
});
|
|
190
|
+
});
|
|
191
|
+
|
|
192
|
+
describe("the module", () => {
|
|
193
|
+
it("imports nothing outside chant core", () => {
|
|
194
|
+
const src = readFileSync(join(import.meta.dirname, "index-diff.ts"), "utf8");
|
|
195
|
+
const imports = [...src.matchAll(/from\s+"([^"]+)"/g)].map((m) => m[1]!);
|
|
196
|
+
expect(imports.every((i) => i.startsWith("./") || i.startsWith("../"))).toBe(true);
|
|
197
|
+
});
|
|
198
|
+
});
|
|
@@ -0,0 +1,475 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* What changed between two versions of one index scope (#4533, moved from
|
|
3
|
+
* INTENTIUS/behold#1028's src/graph-db/index-diff.ts under the ruling that
|
|
4
|
+
* behold is a control plane and every model lives in chant,
|
|
5
|
+
* INTENTIUS/behold#1024).
|
|
6
|
+
*
|
|
7
|
+
* A pure function over two index versions (./index-document.ts): nodes added
|
|
8
|
+
* and removed, properties changed, edges added and removed. It reads nothing
|
|
9
|
+
* and writes nothing; {@link readIndexVersionRef} and
|
|
10
|
+
* {@link diffIndexVersionRefs} load the two versions through a
|
|
11
|
+
* {@link SnapshotStore}, so every store kind (git ref, local, s3) diffs the
|
|
12
|
+
* same way.
|
|
13
|
+
*
|
|
14
|
+
* The lifecycle deep diff (./deep-diff.ts) compares a declared tree with a
|
|
15
|
+
* live one, and a live path no declaration claims is "unclaimed" there rather
|
|
16
|
+
* than a change. Two index versions are both observed, so this comparison is
|
|
17
|
+
* symmetric.
|
|
18
|
+
*
|
|
19
|
+
* Rules:
|
|
20
|
+
*
|
|
21
|
+
* - One scope per diff. Two versions whose `stamp.scopeKey` differ are
|
|
22
|
+
* refused by name with {@link IndexScopeMismatch}: a node missing from one
|
|
23
|
+
* could just be out of its scope.
|
|
24
|
+
* - A node is removed only when the later read listed its (type, location).
|
|
25
|
+
* Otherwise it is `not-observed` in that read, with the coverage verdict
|
|
26
|
+
* that says why. The other way round, a node is added only when the earlier
|
|
27
|
+
* read listed its (type, location). Coverage is looked up with
|
|
28
|
+
* {@link indexCoverageFor}, where `"*"` matches every type or location.
|
|
29
|
+
* {@link indexAbsence} is that rule on its own, for #4526's drift from an
|
|
30
|
+
* index, so both read "absent" the same way.
|
|
31
|
+
* - An edge is removed (or added) only when both its ends were observed in
|
|
32
|
+
* the read that lacks it; otherwise it is `not-observed`.
|
|
33
|
+
* - Properties: `kind`, and each leaf path of `attrs` (arrays compare as
|
|
34
|
+
* whole values). `tags` is compared only for a node whose `attrs` show no
|
|
35
|
+
* change, because a lister's tags are a projection of the listed
|
|
36
|
+
* properties: one tag edit is one changed property, not two. `facts` is
|
|
37
|
+
* never compared (its `observedAt` moves on every read).
|
|
38
|
+
* - Two versions with the same `stamp.digest` hold the same graph and
|
|
39
|
+
* coverage: the diff is `unchanged` and nothing is walked.
|
|
40
|
+
*/
|
|
41
|
+
import { indexCoverageFor, isIndexVersionName, type CoverageEntry, type IndexDocument } from "./index-document";
|
|
42
|
+
import type { SnapshotStore } from "./snapshot-store";
|
|
43
|
+
|
|
44
|
+
/** The first chant that exports the index diff and `chant index diff`. */
|
|
45
|
+
export const INDEX_DIFF_FLOOR = "0.124.54";
|
|
46
|
+
|
|
47
|
+
/**
|
|
48
|
+
* The words a comparison against an index uses (#4533, shared with #4526).
|
|
49
|
+
* `not-observed` is the drift record's word for the same thing
|
|
50
|
+
* (../drift-record.ts `DriftStatus`): the read could not say, and the
|
|
51
|
+
* coverage verdict says why.
|
|
52
|
+
*/
|
|
53
|
+
export type IndexChangeKind = "added" | "removed" | "changed" | "not-observed";
|
|
54
|
+
export const INDEX_CHANGE_KINDS: readonly IndexChangeKind[] = ["added", "removed", "changed", "not-observed"];
|
|
55
|
+
|
|
56
|
+
/** A coverage entry as the diff reads it: chant's `CoverageEntry`, or the same shape with any verdict string. */
|
|
57
|
+
export interface IndexDiffCoverageEntry {
|
|
58
|
+
listedType: string;
|
|
59
|
+
location: string;
|
|
60
|
+
verdict: CoverageEntry["verdict"] | (string & {});
|
|
61
|
+
detail?: string;
|
|
62
|
+
}
|
|
63
|
+
|
|
64
|
+
/** The parts of an index node the diff reads. An `IRNode` is one. */
|
|
65
|
+
export interface IndexDiffNode {
|
|
66
|
+
id: string;
|
|
67
|
+
kind: string;
|
|
68
|
+
lexicon?: string;
|
|
69
|
+
attrs?: Record<string, unknown>;
|
|
70
|
+
tags?: Record<string, string>;
|
|
71
|
+
listedType?: string;
|
|
72
|
+
location?: string;
|
|
73
|
+
nativeId?: string;
|
|
74
|
+
physicalId?: string;
|
|
75
|
+
}
|
|
76
|
+
|
|
77
|
+
/** The parts of an index edge the diff reads. An `IREdge` is one. */
|
|
78
|
+
export interface IndexDiffEdge {
|
|
79
|
+
from: string;
|
|
80
|
+
to: string;
|
|
81
|
+
kind?: string;
|
|
82
|
+
viaAttr?: string;
|
|
83
|
+
relation?: string;
|
|
84
|
+
origin?: string;
|
|
85
|
+
rule?: string;
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
/** The parts of an index version the diff reads. An {@link IndexDocument} is one. */
|
|
89
|
+
export interface IndexDiffDocument {
|
|
90
|
+
index: string;
|
|
91
|
+
stamp: { scopeKey: string; observedAt: string; completedAt?: string; digest: string; source?: { kind: string; name: string; version?: string } };
|
|
92
|
+
coverage: readonly IndexDiffCoverageEntry[];
|
|
93
|
+
graph: { nodes: readonly IndexDiffNode[]; edges: readonly IndexDiffEdge[] };
|
|
94
|
+
}
|
|
95
|
+
|
|
96
|
+
/** Two versions of different scopes. Refused by name, never diffed. */
|
|
97
|
+
export class IndexScopeMismatch extends Error {
|
|
98
|
+
readonly code = "index-scope-mismatch";
|
|
99
|
+
constructor(
|
|
100
|
+
readonly fromScopeKey: string,
|
|
101
|
+
readonly toScopeKey: string,
|
|
102
|
+
) {
|
|
103
|
+
super(
|
|
104
|
+
`refused: the two index versions have different scopes (${fromScopeKey} and ${toScopeKey}), and a node missing from one could just be out of its scope. Diff two versions of one scope.`,
|
|
105
|
+
);
|
|
106
|
+
this.name = "IndexScopeMismatch";
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
|
|
110
|
+
/** A document that is not an index version, or a reference no store holds. */
|
|
111
|
+
export class NotAnIndexVersion extends Error {
|
|
112
|
+
readonly code = "not-an-index-version";
|
|
113
|
+
constructor(message: string) {
|
|
114
|
+
super(message);
|
|
115
|
+
this.name = "NotAnIndexVersion";
|
|
116
|
+
}
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
export interface IndexDiffStamp {
|
|
120
|
+
scopeKey: string;
|
|
121
|
+
observedAt: string;
|
|
122
|
+
completedAt?: string;
|
|
123
|
+
digest: string;
|
|
124
|
+
source?: { kind: string; name: string; version?: string };
|
|
125
|
+
/** The version name, when the caller knows it. */
|
|
126
|
+
version?: string;
|
|
127
|
+
}
|
|
128
|
+
|
|
129
|
+
export interface IndexNodeRef {
|
|
130
|
+
key: string;
|
|
131
|
+
kind: string;
|
|
132
|
+
listedType: string;
|
|
133
|
+
location: string;
|
|
134
|
+
}
|
|
135
|
+
|
|
136
|
+
export interface IndexPropertyChange {
|
|
137
|
+
path: string;
|
|
138
|
+
before?: unknown;
|
|
139
|
+
after?: unknown;
|
|
140
|
+
}
|
|
141
|
+
|
|
142
|
+
export interface IndexNodeChanged extends IndexNodeRef {
|
|
143
|
+
properties: IndexPropertyChange[];
|
|
144
|
+
}
|
|
145
|
+
|
|
146
|
+
/** A node one read has and the other did not observe. `side` names the read that did not observe it. */
|
|
147
|
+
export interface IndexNodeNotObserved extends IndexNodeRef {
|
|
148
|
+
side: "from" | "to";
|
|
149
|
+
/** The coverage verdict for its (type, location) in that read, or `not-in-coverage`. */
|
|
150
|
+
verdict: string;
|
|
151
|
+
detail?: string;
|
|
152
|
+
}
|
|
153
|
+
|
|
154
|
+
export interface IndexEdgeRef {
|
|
155
|
+
from: string;
|
|
156
|
+
to: string;
|
|
157
|
+
kind: string;
|
|
158
|
+
viaAttr?: string;
|
|
159
|
+
relation: string;
|
|
160
|
+
origin?: string;
|
|
161
|
+
rule?: string;
|
|
162
|
+
}
|
|
163
|
+
|
|
164
|
+
export interface IndexEdgeNotObserved extends IndexEdgeRef {
|
|
165
|
+
side: "from" | "to";
|
|
166
|
+
/** The end whose (type, location) was not observed in that read. */
|
|
167
|
+
unobservedEnd: string;
|
|
168
|
+
verdict: string;
|
|
169
|
+
}
|
|
170
|
+
|
|
171
|
+
export interface IndexDiff {
|
|
172
|
+
diff: "v1";
|
|
173
|
+
scopeKey: string;
|
|
174
|
+
from: IndexDiffStamp;
|
|
175
|
+
to: IndexDiffStamp;
|
|
176
|
+
/** Same digest: same graph and coverage. */
|
|
177
|
+
unchanged: boolean;
|
|
178
|
+
nodes: {
|
|
179
|
+
added: IndexNodeRef[];
|
|
180
|
+
removed: IndexNodeRef[];
|
|
181
|
+
changed: IndexNodeChanged[];
|
|
182
|
+
notObserved: IndexNodeNotObserved[];
|
|
183
|
+
};
|
|
184
|
+
edges: {
|
|
185
|
+
added: IndexEdgeRef[];
|
|
186
|
+
removed: IndexEdgeRef[];
|
|
187
|
+
notObserved: IndexEdgeNotObserved[];
|
|
188
|
+
};
|
|
189
|
+
/** (type, location) pairs whose verdict moved between the reads. */
|
|
190
|
+
coverage: Array<{ listedType: string; location: string; before?: string; after?: string }>;
|
|
191
|
+
counts: { added: number; removed: number; changed: number; properties: number; notObserved: number; edgesAdded: number; edgesRemoved: number; edgesNotObserved: number };
|
|
192
|
+
}
|
|
193
|
+
|
|
194
|
+
export interface IndexDiffOptions {
|
|
195
|
+
/** Version names, for the stamps. */
|
|
196
|
+
fromVersion?: string;
|
|
197
|
+
toVersion?: string;
|
|
198
|
+
}
|
|
199
|
+
|
|
200
|
+
/** The inverse of index-document.ts encodeIndexSegment; a segment that is not percent-encoded comes back as it is. */
|
|
201
|
+
function decodeSegment(s: string): string {
|
|
202
|
+
try {
|
|
203
|
+
return decodeURIComponent(s);
|
|
204
|
+
} catch {
|
|
205
|
+
return s;
|
|
206
|
+
}
|
|
207
|
+
}
|
|
208
|
+
|
|
209
|
+
/**
|
|
210
|
+
* A node's (type, location): its own `listedType` and `location` (#4521
|
|
211
|
+
* writes both), else the path-style id's fourth and third segments
|
|
212
|
+
* (behold#1025 Q2, `<substrate>/<scopeId>/<location>/<listedType>/<nativeId>`),
|
|
213
|
+
* else its kind at every location.
|
|
214
|
+
*/
|
|
215
|
+
export function indexNodeTypeAndLocation(n: IndexDiffNode): { listedType: string; location: string } {
|
|
216
|
+
if (n.listedType && n.location) return { listedType: n.listedType, location: n.location };
|
|
217
|
+
const parts = n.id.split("/");
|
|
218
|
+
if (parts.length >= 5) return { listedType: n.listedType ?? decodeSegment(parts[3]!), location: n.location ?? decodeSegment(parts[2]!) };
|
|
219
|
+
return { listedType: n.listedType ?? n.kind, location: n.location ?? "*" };
|
|
220
|
+
}
|
|
221
|
+
|
|
222
|
+
/** What an index's coverage says about a (type, location) that holds no node. */
|
|
223
|
+
export type IndexAbsence = { kind: "removed" } | { kind: "not-observed"; verdict: string; detail?: string };
|
|
224
|
+
|
|
225
|
+
/**
|
|
226
|
+
* The rule for an absent node (#4533, shared with #4526): absent counts as
|
|
227
|
+
* gone (`removed`) only where the read's coverage says `listed` for the
|
|
228
|
+
* node's (type, location); anywhere else it is `not-observed`, with the
|
|
229
|
+
* verdict, or `not-in-coverage` when no entry speaks for it.
|
|
230
|
+
*/
|
|
231
|
+
export function indexAbsence(coverage: readonly IndexDiffCoverageEntry[], listedType: string, location: string): IndexAbsence {
|
|
232
|
+
const e = indexCoverageFor(coverage, listedType, location);
|
|
233
|
+
if (e?.verdict === "listed") return { kind: "removed" };
|
|
234
|
+
return e ? { kind: "not-observed", verdict: e.verdict, ...(e.detail ? { detail: e.detail } : {}) } : { kind: "not-observed", verdict: "not-in-coverage" };
|
|
235
|
+
}
|
|
236
|
+
|
|
237
|
+
function stampOf(doc: IndexDiffDocument, version?: string): IndexDiffStamp {
|
|
238
|
+
const s = doc.stamp;
|
|
239
|
+
return {
|
|
240
|
+
scopeKey: s.scopeKey,
|
|
241
|
+
observedAt: s.observedAt,
|
|
242
|
+
...(s.completedAt ? { completedAt: s.completedAt } : {}),
|
|
243
|
+
digest: s.digest,
|
|
244
|
+
...(s.source ? { source: s.source } : {}),
|
|
245
|
+
...(version ? { version } : {}),
|
|
246
|
+
};
|
|
247
|
+
}
|
|
248
|
+
|
|
249
|
+
function check(doc: IndexDiffDocument, which: string): void {
|
|
250
|
+
if (!doc || doc.index !== "v1" || typeof doc.stamp?.scopeKey !== "string" || !Array.isArray(doc.graph?.nodes)) {
|
|
251
|
+
throw new NotAnIndexVersion(`the ${which} document is not an index version (index: "v1" with a stamp and a graph)`);
|
|
252
|
+
}
|
|
253
|
+
}
|
|
254
|
+
|
|
255
|
+
const isPlain = (v: unknown): v is Record<string, unknown> => !!v && typeof v === "object" && !Array.isArray(v);
|
|
256
|
+
|
|
257
|
+
/** JSON with keys sorted, so equal values compare equal. */
|
|
258
|
+
function canon(v: unknown): string {
|
|
259
|
+
return JSON.stringify(v, (_k, x: unknown) => (isPlain(x) ? Object.fromEntries(Object.entries(x).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))) : x)) ?? "undefined";
|
|
260
|
+
}
|
|
261
|
+
|
|
262
|
+
/** Leaf paths of an object; arrays and scalars are leaves. */
|
|
263
|
+
function leaves(v: unknown, prefix: string, out: Map<string, unknown>): void {
|
|
264
|
+
if (isPlain(v) && Object.keys(v).length > 0) {
|
|
265
|
+
for (const [k, x] of Object.entries(v)) leaves(x, prefix ? `${prefix}.${k}` : k, out);
|
|
266
|
+
} else if (prefix) {
|
|
267
|
+
out.set(prefix, v);
|
|
268
|
+
}
|
|
269
|
+
}
|
|
270
|
+
|
|
271
|
+
function changedPaths(before: unknown, after: unknown, root: string): IndexPropertyChange[] {
|
|
272
|
+
const a = new Map<string, unknown>();
|
|
273
|
+
const b = new Map<string, unknown>();
|
|
274
|
+
leaves(before ?? {}, root, a);
|
|
275
|
+
leaves(after ?? {}, root, b);
|
|
276
|
+
const out: IndexPropertyChange[] = [];
|
|
277
|
+
for (const path of [...new Set([...a.keys(), ...b.keys()])].sort()) {
|
|
278
|
+
const x = a.get(path);
|
|
279
|
+
const y = b.get(path);
|
|
280
|
+
if (canon(x) === canon(y)) continue;
|
|
281
|
+
out.push({ path, ...(a.has(path) ? { before: x } : {}), ...(b.has(path) ? { after: y } : {}) });
|
|
282
|
+
}
|
|
283
|
+
return out;
|
|
284
|
+
}
|
|
285
|
+
|
|
286
|
+
/** The property changes of one node between two reads. */
|
|
287
|
+
export function indexNodePropertyChanges(before: IndexDiffNode, after: IndexDiffNode): IndexPropertyChange[] {
|
|
288
|
+
const out: IndexPropertyChange[] = [];
|
|
289
|
+
if (before.kind !== after.kind) out.push({ path: "kind", before: before.kind, after: after.kind });
|
|
290
|
+
const attrs = changedPaths(before.attrs, after.attrs, "attrs");
|
|
291
|
+
out.push(...attrs);
|
|
292
|
+
if (attrs.length === 0) out.push(...changedPaths(before.tags, after.tags, "tags"));
|
|
293
|
+
return out;
|
|
294
|
+
}
|
|
295
|
+
|
|
296
|
+
function edgeKey(e: IndexDiffEdge): string {
|
|
297
|
+
return [e.from, e.to, e.kind ?? "", e.viaAttr ?? "", e.relation ?? "reference"].join("\u0000");
|
|
298
|
+
}
|
|
299
|
+
|
|
300
|
+
function edgeRef(e: IndexDiffEdge): IndexEdgeRef {
|
|
301
|
+
return {
|
|
302
|
+
from: e.from,
|
|
303
|
+
to: e.to,
|
|
304
|
+
kind: e.kind ?? "",
|
|
305
|
+
...(e.viaAttr ? { viaAttr: e.viaAttr } : {}),
|
|
306
|
+
relation: e.relation ?? "reference",
|
|
307
|
+
...(e.origin ? { origin: e.origin } : {}),
|
|
308
|
+
...(e.rule ? { rule: e.rule } : {}),
|
|
309
|
+
};
|
|
310
|
+
}
|
|
311
|
+
|
|
312
|
+
const refOf = (n: IndexDiffNode): IndexNodeRef => ({ key: n.id, kind: n.kind, ...indexNodeTypeAndLocation(n) });
|
|
313
|
+
const byKey = <T>([a]: [string, T], [b]: [string, T]) => (a < b ? -1 : a > b ? 1 : 0);
|
|
314
|
+
|
|
315
|
+
/**
|
|
316
|
+
* What changed from `from` to `to`, two versions of one index scope.
|
|
317
|
+
* Throws {@link IndexScopeMismatch} when their scope keys differ, and
|
|
318
|
+
* {@link NotAnIndexVersion} for a document of another shape.
|
|
319
|
+
*/
|
|
320
|
+
export function diffIndexVersions(from: IndexDiffDocument, to: IndexDiffDocument, o: IndexDiffOptions = {}): IndexDiff {
|
|
321
|
+
check(from, "first");
|
|
322
|
+
check(to, "second");
|
|
323
|
+
if (from.stamp.scopeKey !== to.stamp.scopeKey) throw new IndexScopeMismatch(from.stamp.scopeKey, to.stamp.scopeKey);
|
|
324
|
+
const out: IndexDiff = {
|
|
325
|
+
diff: "v1",
|
|
326
|
+
scopeKey: from.stamp.scopeKey,
|
|
327
|
+
from: stampOf(from, o.fromVersion),
|
|
328
|
+
to: stampOf(to, o.toVersion),
|
|
329
|
+
unchanged: false,
|
|
330
|
+
nodes: { added: [], removed: [], changed: [], notObserved: [] },
|
|
331
|
+
edges: { added: [], removed: [], notObserved: [] },
|
|
332
|
+
coverage: [],
|
|
333
|
+
counts: { added: 0, removed: 0, changed: 0, properties: 0, notObserved: 0, edgesAdded: 0, edgesRemoved: 0, edgesNotObserved: 0 },
|
|
334
|
+
};
|
|
335
|
+
if (from.stamp.digest && from.stamp.digest === to.stamp.digest) {
|
|
336
|
+
out.unchanged = true;
|
|
337
|
+
return out;
|
|
338
|
+
}
|
|
339
|
+
|
|
340
|
+
const absence = (doc: IndexDiffDocument, n: IndexDiffNode): IndexAbsence => {
|
|
341
|
+
const { listedType, location } = indexNodeTypeAndLocation(n);
|
|
342
|
+
return indexAbsence(doc.coverage, listedType, location);
|
|
343
|
+
};
|
|
344
|
+
const unobserved = (n: IndexDiffNode, a: Extract<IndexAbsence, { kind: "not-observed" }>, side: "from" | "to"): IndexNodeNotObserved => ({
|
|
345
|
+
...refOf(n),
|
|
346
|
+
side,
|
|
347
|
+
verdict: a.verdict,
|
|
348
|
+
...(a.detail ? { detail: a.detail } : {}),
|
|
349
|
+
});
|
|
350
|
+
|
|
351
|
+
const before = new Map(from.graph.nodes.map((n) => [n.id, n]));
|
|
352
|
+
const after = new Map(to.graph.nodes.map((n) => [n.id, n]));
|
|
353
|
+
for (const [id, n] of [...before].sort(byKey)) {
|
|
354
|
+
const m = after.get(id);
|
|
355
|
+
if (m) {
|
|
356
|
+
const properties = indexNodePropertyChanges(n, m);
|
|
357
|
+
if (properties.length > 0) out.nodes.changed.push({ ...refOf(m), properties });
|
|
358
|
+
continue;
|
|
359
|
+
}
|
|
360
|
+
const a = absence(to, n);
|
|
361
|
+
if (a.kind === "removed") out.nodes.removed.push(refOf(n));
|
|
362
|
+
else out.nodes.notObserved.push(unobserved(n, a, "to"));
|
|
363
|
+
}
|
|
364
|
+
for (const [id, n] of [...after].sort(byKey)) {
|
|
365
|
+
if (before.has(id)) continue;
|
|
366
|
+
const a = absence(from, n);
|
|
367
|
+
if (a.kind === "removed") out.nodes.added.push(refOf(n));
|
|
368
|
+
else out.nodes.notObserved.push(unobserved(n, a, "from"));
|
|
369
|
+
}
|
|
370
|
+
|
|
371
|
+
// An edge's ends are looked up in either read: a removed edge's ends may be gone from `to`.
|
|
372
|
+
const nodeFor = (id: string): IndexDiffNode => after.get(id) ?? before.get(id) ?? { id, kind: "" };
|
|
373
|
+
const edgesIn = (doc: IndexDiffDocument) => new Map(doc.graph.edges.map((e) => [edgeKey(e), e]));
|
|
374
|
+
const ea = edgesIn(from);
|
|
375
|
+
const eb = edgesIn(to);
|
|
376
|
+
const classify = (e: IndexDiffEdge, lacking: IndexDiffDocument, side: "from" | "to", into: IndexEdgeRef[]) => {
|
|
377
|
+
for (const end of [e.from, e.to]) {
|
|
378
|
+
const a = absence(lacking, nodeFor(end));
|
|
379
|
+
if (a.kind === "not-observed") {
|
|
380
|
+
out.edges.notObserved.push({ ...edgeRef(e), side, unobservedEnd: end, verdict: a.verdict });
|
|
381
|
+
return;
|
|
382
|
+
}
|
|
383
|
+
}
|
|
384
|
+
into.push(edgeRef(e));
|
|
385
|
+
};
|
|
386
|
+
for (const [k, e] of [...ea].sort(byKey)) if (!eb.has(k)) classify(e, to, "to", out.edges.removed);
|
|
387
|
+
for (const [k, e] of [...eb].sort(byKey)) if (!ea.has(k)) classify(e, from, "from", out.edges.added);
|
|
388
|
+
|
|
389
|
+
const cov = new Map<string, { listedType: string; location: string; before?: string; after?: string }>();
|
|
390
|
+
for (const e of from.coverage) cov.set(`${e.listedType}\u0000${e.location}`, { listedType: e.listedType, location: e.location, before: e.verdict });
|
|
391
|
+
for (const e of to.coverage) {
|
|
392
|
+
const k = `${e.listedType}\u0000${e.location}`;
|
|
393
|
+
cov.set(k, { ...(cov.get(k) ?? { listedType: e.listedType, location: e.location }), after: e.verdict });
|
|
394
|
+
}
|
|
395
|
+
out.coverage = [...cov.values()]
|
|
396
|
+
.filter((c) => c.before !== c.after)
|
|
397
|
+
.sort((a, b) => (a.listedType + "\u0000" + a.location < b.listedType + "\u0000" + b.location ? -1 : 1));
|
|
398
|
+
|
|
399
|
+
out.counts = {
|
|
400
|
+
added: out.nodes.added.length,
|
|
401
|
+
removed: out.nodes.removed.length,
|
|
402
|
+
changed: out.nodes.changed.length,
|
|
403
|
+
properties: out.nodes.changed.reduce((s, c) => s + c.properties.length, 0),
|
|
404
|
+
notObserved: out.nodes.notObserved.length,
|
|
405
|
+
edgesAdded: out.edges.added.length,
|
|
406
|
+
edgesRemoved: out.edges.removed.length,
|
|
407
|
+
edgesNotObserved: out.edges.notObserved.length,
|
|
408
|
+
};
|
|
409
|
+
return out;
|
|
410
|
+
}
|
|
411
|
+
|
|
412
|
+
// ── Reading versions through the store (#4519) ──────────────────────
|
|
413
|
+
|
|
414
|
+
/** A parsed version reference: `<scopeKey>/<version>`, or `<scopeKey>` alone for its latest. */
|
|
415
|
+
export interface IndexVersionRef {
|
|
416
|
+
scopeKey: string;
|
|
417
|
+
/** Absent: the scope's latest version. */
|
|
418
|
+
version?: string;
|
|
419
|
+
}
|
|
420
|
+
|
|
421
|
+
/**
|
|
422
|
+
* Parse `<scopeKey>/<version>` or `<scopeKey>`. A bare version name (no
|
|
423
|
+
* scope) takes `inScope`'s scope, so `--against <version>` can name another
|
|
424
|
+
* version of the first argument's scope.
|
|
425
|
+
*/
|
|
426
|
+
export function parseIndexVersionRef(ref: string, inScope?: string): IndexVersionRef {
|
|
427
|
+
const trimmed = ref.replace(/^\/+|\/+$/g, "");
|
|
428
|
+
const slash = trimmed.lastIndexOf("/");
|
|
429
|
+
const last = slash < 0 ? trimmed : trimmed.slice(slash + 1);
|
|
430
|
+
if (isIndexVersionName(last)) {
|
|
431
|
+
if (slash >= 0) return { scopeKey: trimmed.slice(0, slash), version: last };
|
|
432
|
+
if (!inScope) throw new NotAnIndexVersion(`"${ref}" is a version name with no scope: name it as <scopeKey>/${last}`);
|
|
433
|
+
return { scopeKey: inScope, version: last };
|
|
434
|
+
}
|
|
435
|
+
if (!trimmed) throw new NotAnIndexVersion("an empty index version reference");
|
|
436
|
+
return { scopeKey: trimmed };
|
|
437
|
+
}
|
|
438
|
+
|
|
439
|
+
/** One version read from a store, with the name it is stored under. */
|
|
440
|
+
export interface StoredIndexVersion {
|
|
441
|
+
scopeKey: string;
|
|
442
|
+
version: string;
|
|
443
|
+
doc: IndexDocument;
|
|
444
|
+
}
|
|
445
|
+
|
|
446
|
+
/** Read one version (or a scope's latest) through the store. Throws {@link NotAnIndexVersion} when the store has none. */
|
|
447
|
+
export async function readIndexVersionRef(store: Pick<SnapshotStore, "kind" | "listIndex" | "readIndexAt">, ref: IndexVersionRef): Promise<StoredIndexVersion> {
|
|
448
|
+
const version = ref.version ?? (await store.listIndex(ref.scopeKey)).pop();
|
|
449
|
+
if (!version) throw new NotAnIndexVersion(`the ${store.kind} store holds no index version under ${ref.scopeKey}`);
|
|
450
|
+
const doc = await store.readIndexAt(ref.scopeKey, version);
|
|
451
|
+
if (!doc) throw new NotAnIndexVersion(`the ${store.kind} store holds no index version ${ref.scopeKey}/${version}`);
|
|
452
|
+
return { scopeKey: ref.scopeKey, version, doc };
|
|
453
|
+
}
|
|
454
|
+
|
|
455
|
+
/**
|
|
456
|
+
* Diff two stored versions. `to` absent: `from` names a scope (or a version
|
|
457
|
+
* in one), and the diff is the scope's last two versions, or the version
|
|
458
|
+
* before `from` against `from`. Two references under different scope paths
|
|
459
|
+
* are refused before either is read.
|
|
460
|
+
*/
|
|
461
|
+
export async function diffIndexVersionRefs(store: Pick<SnapshotStore, "kind" | "listIndex" | "readIndexAt">, from: IndexVersionRef, to?: IndexVersionRef): Promise<IndexDiff> {
|
|
462
|
+
let a = from;
|
|
463
|
+
let b = to;
|
|
464
|
+
if (!b) {
|
|
465
|
+
const versions = await store.listIndex(from.scopeKey);
|
|
466
|
+
const at = from.version ? versions.indexOf(from.version) : versions.length - 1;
|
|
467
|
+
if (at < 1) throw new NotAnIndexVersion(`the ${store.kind} store holds no version before ${from.version ?? "the latest"} under ${from.scopeKey}: name two versions`);
|
|
468
|
+
a = { scopeKey: from.scopeKey, version: versions[at - 1] };
|
|
469
|
+
b = { scopeKey: from.scopeKey, version: versions[at] };
|
|
470
|
+
}
|
|
471
|
+
if (a.scopeKey !== b.scopeKey) throw new IndexScopeMismatch(a.scopeKey, b.scopeKey);
|
|
472
|
+
const x = await readIndexVersionRef(store, a);
|
|
473
|
+
const y = await readIndexVersionRef(store, b);
|
|
474
|
+
return diffIndexVersions(x.doc, y.doc, { fromVersion: x.version, toVersion: y.version });
|
|
475
|
+
}
|