@intentius/behold 0.30.2 → 0.32.0

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.
Files changed (102) hide show
  1. package/AGENTS.md +791 -16
  2. package/README.md +78 -23
  3. package/THIRD_PARTY.md +6 -5
  4. package/demos.json +14 -9
  5. package/dist/cli.js +51926 -20221
  6. package/example-carve/README.md +19 -23
  7. package/example-carve/app/package.json +1 -1
  8. package/example-carve/app/src/carved.ts +3 -3
  9. package/example-carve/carve-report.json +1 -1
  10. package/example-carve/{legacy-tf → tf-root}/terraform.tfstate +1 -1
  11. package/example-choudoufu-estate/README.md +7 -0
  12. package/example-choudoufu-estate/chant.workspace.json +1 -1
  13. package/example-choudoufu-estate/scripts/choudoufu-down.sh +2 -1
  14. package/example-choudoufu-estate/scripts/choudoufu-up.sh +10 -3
  15. package/example-terraform-estate/README.md +32 -5
  16. package/example-terraform-estate/chant.workspace.json +1 -1
  17. package/example-terraform-estate/recorded/adoption/platform.json +72 -0
  18. package/example-terraform-estate/recorded/adoption/prod.json +224 -0
  19. package/example-three-cloud/README.md +111 -18
  20. package/example-three-cloud/aws/Pulumi.yaml +15 -0
  21. package/example-three-cloud/aws/index.ts +174 -0
  22. package/example-three-cloud/aws/package-lock.json +2725 -0
  23. package/example-three-cloud/aws/package.json +14 -0
  24. package/example-three-cloud/aws/tsconfig.json +17 -0
  25. package/example-three-cloud/azure/main.tf +48 -0
  26. package/example-three-cloud/azure/site.tf +104 -0
  27. package/example-three-cloud/chant.config.json +9 -0
  28. package/example-three-cloud/chant.workspace.json +30 -4
  29. package/example-three-cloud/dns/chant.config.ts +26 -1
  30. package/example-three-cloud/dns/src/records.component.ts +32 -6
  31. package/example-three-cloud/package-lock.json +48 -27
  32. package/example-three-cloud/package.json +8 -6
  33. package/example-three-cloud/scripts/emulators-up.sh +28 -1
  34. package/example-three-cloud/scripts/front-door.ts +679 -86
  35. package/package.json +26 -8
  36. package/schemas/graph/v1/graph.schema.json +140 -0
  37. package/web/adopt-pulumi.js +114 -0
  38. package/web/adopt-pulumi.test.js +28 -0
  39. package/web/adopt.js +203 -0
  40. package/web/adopt.test.js +27 -0
  41. package/web/app.js +367 -14
  42. package/web/boot-motion.js +6 -0
  43. package/web/carve-steps.js +1 -1
  44. package/web/carve-steps.test.js +2 -2
  45. package/web/change-set-overlay.js +12 -5
  46. package/web/change-set-overlay.test.js +22 -0
  47. package/web/cut-around.d.ts +30 -0
  48. package/web/cut-around.js +138 -0
  49. package/web/drift-stream.js +241 -0
  50. package/web/drift-stream.test.js +146 -0
  51. package/web/edge-weight.d.ts +8 -2
  52. package/web/edge-weight.js +38 -4
  53. package/web/edge-weight.test.js +55 -1
  54. package/web/graph-query.js +180 -0
  55. package/web/graph-query.test.js +49 -0
  56. package/web/graph.html +107 -0
  57. package/web/index-diff.js +109 -0
  58. package/web/index-diff.test.js +39 -0
  59. package/web/index.html +45 -20
  60. package/web/kiosk-ask-tips.js +15 -5
  61. package/web/kiosk-ask-tips.test.js +14 -1
  62. package/web/kiosk-estate-scene.js +72 -8
  63. package/web/kiosk-light-frame.js +1 -0
  64. package/web/kiosk-light.js +41 -3
  65. package/web/kiosk-member-kind.test.js +140 -0
  66. package/web/kiosk-popover.js +4 -1
  67. package/web/kiosk-side.js +296 -0
  68. package/web/kiosk-side.test.js +249 -0
  69. package/web/kiosk-watch.js +12 -0
  70. package/web/kiosk-watch.test.js +15 -1
  71. package/web/kiosk.html +47 -1
  72. package/web/kiosk.js +106 -7
  73. package/web/member-kind.js +31 -0
  74. package/web/neighbourhood.js +105 -0
  75. package/web/neighbourhood.test.js +131 -0
  76. package/web/outside-refs.js +515 -0
  77. package/web/outside-refs.test.js +249 -0
  78. package/web/template-apps.js +245 -0
  79. package/web/template-apps.test.js +252 -0
  80. package/web/templates.js +285 -0
  81. package/web/templates.test.js +155 -0
  82. package/web/terragucci-lifecycle.js +112 -62
  83. package/web/terragucci-lifecycle.test.js +29 -1
  84. package/web/terragucci-timeline.js +39 -2
  85. package/web/terragucci-timeline.test.js +42 -1
  86. package/web/theme-paint.js +14 -0
  87. package/example-three-cloud/aws/chant.config.ts +0 -8
  88. package/example-three-cloud/aws/site.component.ts +0 -13
  89. package/example-three-cloud/aws/src/site.ts +0 -27
  90. package/example-three-cloud/azure/chant.config.ts +0 -1
  91. package/example-three-cloud/azure/src/site.component.ts +0 -13
  92. package/example-three-cloud/azure/src/site.ts +0 -18
  93. /package/example-carve/{legacy-tf → tf-root}/cdn.tf +0 -0
  94. /package/example-carve/{legacy-tf → tf-root}/compute.tf +0 -0
  95. /package/example-carve/{legacy-tf → tf-root}/floci-override.tf.disabled +0 -0
  96. /package/example-carve/{legacy-tf → tf-root}/modules/cdn/main.tf +0 -0
  97. /package/example-carve/{legacy-tf → tf-root}/naming.tf +0 -0
  98. /package/example-carve/{legacy-tf → tf-root}/network.tf +0 -0
  99. /package/example-carve/{legacy-tf → tf-root}/observability.tf +0 -0
  100. /package/example-carve/{legacy-tf → tf-root}/outputs.tf +0 -0
  101. /package/example-carve/{legacy-tf → tf-root}/storage.tf +0 -0
  102. /package/example-carve/{legacy-tf → tf-root}/versions.tf +0 -0
package/README.md CHANGED
@@ -1,7 +1,20 @@
1
1
  # behold
2
2
 
3
- **A live control plane on [chant](https://github.com/INTENTIUS/chant).** Every
4
- substrate in one graph, coloured by drift. Then act through delegated, gated Ops.
3
+ **Your infrastructure repo as a graph, from the files.**
4
+
5
+ ```sh
6
+ npx @intentius/behold serve .
7
+ ```
8
+
9
+ Run it in a folder of Terraform and it finds each root and draws it as a box of resources, with an edge for each reference the configuration states. It needs no state file or cloud account, and it runs no `terraform` binary. It writes nothing into the folder it reads. Terraform roots are what it draws from files today. Kubernetes manifests in a plain directory and the edges between tools are coming. behold works beside the tools a repo already uses.
10
+
11
+ ![Two Terraform roots, app and net, drawn as boxes of resources with an edge for each reference](https://raw.githubusercontent.com/INTENTIUS/behold/main/docs/public/readme/two-roots.png)
12
+
13
+ ## With chant
14
+
15
+ Reads what chant records for terragucci and plywood.
16
+
17
+ Every substrate in one graph, coloured by drift. Then act through delegated, gated Ops.
5
18
 
6
19
  📖 **[Documentation](https://intentius.io/behold/)** starts with an agent prompt
7
20
  that gets you to a running graph without reading anything else first.
@@ -27,9 +40,9 @@ https://intentius.io/behold/using/agents/.
27
40
  Never deploy with the Deploy button, `POST /api/apply` or `POST /api/ci/dispatch`. Gate approvals stay mine as well (`/api/ops/:name/signal/:gate`, `/api/workspace/gates/approve`, `/api/operator/approve/:op/:gate`). Op runs (`/api/ops/:name/run`) and rollbacks (`/api/rollback`) are mine too. Leave `--auto-sync` off, and keep a `behold preview` or `--public` serve read-only.
28
41
  ```
29
42
 
30
- Where Argo CD shows one cluster's tree, behold shows the mixed-substrate estate:
31
- cloud drift on AWS, supply-chain drift on GitHub Actions, artifact presence on
32
- Helm. Each substrate's own kind of truth, in one picture.
43
+ behold shows the mixed-substrate estate: cloud drift on AWS, supply-chain drift
44
+ on GitHub Actions, artifact presence on Helm. An Argo CD cluster draws in the
45
+ same graph, with each substrate's own kind of truth in one picture.
33
46
 
34
47
  ```
35
48
  chant source ──build/lint──▶ graph IR ──behold──▶ live graph + drift + (delegated) actions
@@ -51,12 +64,13 @@ There's a whole catalog, and `behold demo --list` names the rest (`behold demo
51
64
  k8s` stands the same loop up on a throwaway k3d cluster: runtime Pods, field
52
65
  ownership; `behold demo argo-estate` needs nothing at all, being a three-project
53
66
  Argo CD estate, declared only, so it runs where Docker doesn't; `behold demo
54
- choudoufu-estate` is four tag-owned OpenTofu estates served composed, where a
67
+ choudoufu-estate` is four tag-owned OpenTofu estates served as one declared
68
+ workspace, where a
55
69
  card's colour is **ownership** (bound, unowned, pending) rather than "nothing
56
70
  changed": a resource whose attributes drifted out of band still carries its
57
71
  markers and is still green, so attribute drift is a separate read you ask for
58
- with ⌘K → "Re-check live with plan"; `behold demo carve` is the Terraform peel
59
- walkthrough, below). Two more need no Docker either: `behold demo
72
+ with ⌘K → "Re-check live with plan"; `behold demo carve` shows chant and
73
+ Terraform managing one account together, below). Two more need no Docker either: `behold demo
60
74
  terraform-estate` draws a multi-root Terraform estate boxed by root, and shows
61
75
  what behold refuses to infer, since one root reads a key the other declares and
62
76
  no edge is drawn between them; `behold demo flux-estate` is a GitOps estate on
@@ -129,6 +143,42 @@ To colour the graph by what is actually deployed, name an environment with
129
143
  for one specific demo project. `behold demo` and `serve --local` supersede it for
130
144
  every purpose; it is kept for compatibility and is not documented further.</sub>
131
145
 
146
+ ## Print the graph: `behold graph`
147
+
148
+ `behold graph [dir]` reads a directory and prints its graph, with no server
149
+ and no browser. A CI job, an editor or a script can take the output as it is.
150
+
151
+ ```sh
152
+ npx @intentius/behold graph ./infra --json | jq '.nodes | length'
153
+ npx @intentius/behold graph ./infra --ir -o graph.json --detail 3
154
+ ```
155
+
156
+ `--json` (the default) prints the `behold-graph/1` document. `--ir` prints the
157
+ unversioned `{ir, meta}` snapshot that `/api/graph` answers, without its SVG.
158
+ Neither holds an absolute path, and a card's source text is left out unless
159
+ you pass `--source`. A root that does not parse is one card in the output, as
160
+ it is in the browser.
161
+ `--svg [--theme light|dark]` writes the picture as one self-contained SVG file.
162
+
163
+ Two cuts print part of the graph. `--changed <base>..<head>` keeps what
164
+ changed between two commits (cards added, removed or changed, marked `diff` in
165
+ the document) and the cards within `--depth` hops of them (default 1), read
166
+ from `git archive` into a temporary directory, so the checkout is not touched
167
+ and a shallow clone works once both commits are fetched. A commit that only
168
+ reformats a file changes no card. Past `--budget` cards (default 60) the
169
+ neighbours fold into a count per box, then the cut becomes a table of counts.
170
+ `--around <id>[,<id>...]` keeps the named cards or boxes and what is within
171
+ `--depth` hops, `--up` or `--down` for one direction.
172
+
173
+ ```sh
174
+ npx @intentius/behold graph ./infra --changed origin/main...HEAD -o cut.json
175
+ npx @intentius/behold graph ./infra --around prod/prod/aws_vpc.main --depth 2
176
+ ```
177
+
178
+ The same command ships on its own as `@intentius/behold-graph`
179
+ (`npx @intentius/behold-graph ./infra`), a smaller install with none of the
180
+ server's dependencies; packages/graph/README.md has its budget.
181
+
132
182
  ## Export and host: a shareable, interactive snapshot
133
183
 
134
184
  `behold export` freezes whatever estate you're looking at into a **self-contained
@@ -448,15 +498,17 @@ The docs' terragucci page says what it shows.
448
498
 
449
499
  The demo is served at `/`: the live demo's page, else the first listed one.
450
500
  `/kiosk` redirects to `/`. The listed demos are the multi-state plan-and-apply
451
- ones, each at a path of its own (`/choudoufu-compose`, `/terragrunt-choudoufu`,
452
- `/atmos-choudoufu`, `/chant-compose`); one is listed once its tool has a published cycle
501
+ ones (`choudoufu-compose`, `terragrunt-choudoufu`, `atmos-choudoufu`,
502
+ `chant-compose`); one is listed once its tool has a published cycle
453
503
  (`cycles/<tool>/latest.json` beside `demo.json`) or is live, and
454
- `/api/terragucci/demos` says which. A page shows the demo's live run, or replays
455
- its latest cycle, under a banner with the example's name, its products, a link to
456
- its code in INTENTIUS/terragucci, and a switcher when more than one is listed.
504
+ `/api/terragucci/demos` says which. No demo has a page of its own: a tool's
505
+ path (`/choudoufu-compose`, `/terragrunt-choudoufu`, `/atmos-choudoufu`,
506
+ `/chant-compose`) redirects to `/` with a 302, so a link to one lands on
507
+ whichever demo `/` shows. The page shows that demo under a banner with the
508
+ example's name, the act, its products and a link to its code.
457
509
  The older tools' URLs (`/terraform`, `/terragrunt`, `/cdk-terrain`, `/choudoufu`,
458
- `/chant`, and the fan-out pages) redirect to `/`. Any other short path answers
459
- 404 with a link to the front page.
510
+ `/chant`, and the fan-out pages) redirect to `/` too. Any other short path
511
+ answers 404 with a link to the front page.
460
512
 
461
513
  In a declared workspace, the gates waiting on a person come from
462
514
  `chant workspace status <env> --json`, keyed `member/op/gate` the way arugula's
@@ -504,11 +556,11 @@ Documents are checked against terragucci's JSON Schemas when
504
556
  docs `using/terragucci`. `example-terragucci-reports/` is a bucket for
505
557
  terragucci's own example, written by terragucci's code.
506
558
 
507
- ## Terraform carve-out: `behold carve <report.json>`
559
+ ## Terraform and chant: `behold carve <report.json>`
508
560
 
509
- `chant carve advise` ranks a Terraform estate by **peelability**: how cleanly
510
- each resource could be carved into native chant source. `behold carve` draws
511
- that ranking: one card per resource, three panels (carve now / boundary work /
561
+ `chant carve advise` reads a Terraform estate and shows which resources chant
562
+ can also manage, and the work each handoff takes. `behold carve` draws that
563
+ report: one card per resource, three panels (carve now / boundary work /
512
564
  leave in Terraform) on the same `attrs._status` drift palette every other view
513
565
  uses, and the score arithmetic behind each rank in the inspect pane.
514
566
 
@@ -534,8 +586,8 @@ own `<address>.carve.json` manifests.
534
586
  npx @intentius/behold demo carve # no Docker, no cloud, no terraform binary
535
587
  ```
536
588
 
537
- Copies a half-migrated estate (a small chant project beside a Terraform one,
538
- both describing the same AWS account), installs the chant it will shell, runs
589
+ Copies a mixed estate (a small chant project beside a Terraform one, both on
590
+ the same AWS account), installs the chant it will shell, runs
539
591
  `chant carve advise` over the copy, and opens the banded graph with a six-step
540
592
  stepper on the panel's **Carve** tab:
541
593
 
@@ -555,7 +607,7 @@ stepper on the panel's **Carve** tab:
555
607
 
556
608
  The Emit step reports `chant lint`, not `chant build`: `build` fails on the
557
609
  emitted bucket (scored 84 by the advisor) on one rule: WAW042, a TLS-deny
558
- bucket policy the source Terraform never declared. The panel links the
610
+ bucket policy. Adding one in Terraform fixes it too. The panel links the
559
611
  reason. [example-carve/README.md](example-carve/README.md) has the estate's full story, the band table,
560
612
  and the offline/`--live` split.
561
613
 
@@ -721,7 +773,10 @@ Flux mark, a `Helm::Release` the Helm wheel. The corpus is vendored under
721
773
  `web/icons/` (30 kubernetes/community SVGs, 3 cncf/artwork marks for
722
774
  Flux/Argo/Helm, licensing in `THIRD_PARTY.md`) and mapped kind by kind in
723
775
  `src/icon-packs.ts`; a kind with no official icon falls through to pinhole's
724
- keyword heuristic rather than a wrong picture.
776
+ keyword heuristic rather than a wrong picture. The painter reads the corpus from
777
+ `src/icons.generated.ts`, which `npm run generate:icons` writes from `web/icons/`
778
+ and `npm run check:icons` holds to it, so `src/render.ts` reads no file and
779
+ bundles for a browser (`npm run check:browser-bundle`, #1069).
725
780
 
726
781
  dagre's layout is a good first draft, not a final one: drag a card to move
727
782
  it, grab a containment box's corner to resize it, and both survive a reload.
package/THIRD_PARTY.md CHANGED
@@ -36,11 +36,12 @@ into one document cannot collide. No geometry is touched; every path is byte-ide
36
36
  upstream. [`scripts/vendor-icons.mjs`](./scripts/vendor-icons.mjs) re-fetches the corpus at
37
37
  the pinned revision, and `--check` asserts the working tree still matches it.
38
38
 
39
- At render time one further step happens to the copy in memory, never to the file on disk:
40
- [`src/icon-packs.ts`](./src/icon-packs.ts) splices each body into the graph SVG without its
41
- root `<svg>`, so the remaining `inkscape:`/`sodipodi:` attributes — which that root declared
42
- the namespaces for — are dropped and `xlink:href` becomes the plain SVG 2 `href`. Editor
43
- state only; nothing that paints.
39
+ At build time one further step happens to a copy, never to the file on disk:
40
+ [`src/icon-svg.ts`](./src/icon-svg.ts) splits each body out of its root `<svg>`, so the
41
+ remaining `inkscape:`/`sodipodi:` attributes — which that root declared the namespaces for —
42
+ are dropped and `xlink:href` becomes the plain SVG 2 `href`. Editor state only; nothing that
43
+ paints. `npm run generate:icons` writes the result to `src/icons.generated.ts`, which is what
44
+ [`src/icon-packs.ts`](./src/icon-packs.ts) splices into the graph SVG.
44
45
 
45
46
  ## Flux, Argo and Helm project marks (`web/icons/cncf/`)
46
47
 
package/demos.json CHANGED
@@ -65,23 +65,25 @@
65
65
  },
66
66
  {
67
67
  "name": "terraform-estate",
68
- "description": "A multi-root Terraform estate, declared only: two roots applied separately (envs/prod and platform) plus the shared module both are built on — 37 cards boxed by root, module calls expanded into their own contents, and the two look-alike versions.tf files told apart. Shows what behold does NOT infer as clearly as what it draws: platform declares the KMS key and prod reads it back by alias, and no edge is drawn between them, because both ends carry the same unresolved interpolation (#381). Reads through chant's terraform lexicon (@intentius/chant-lexicon-terraform) and @cdktn/hcl2json, both installed with behold since #909 (an install that pruned them refuses with the line that puts them back); the copy is linked to the lexicon behold resolved, since chant reads a workspace's pinned kinds from beside the workspace. No cloud, no Docker, no terraform binary.",
68
+ "description": "A multi-root Terraform estate, declared only: two roots applied separately (envs/prod and platform) plus the shared module both are built on — 37 cards boxed by root, module calls expanded into their own contents, and the two look-alike versions.tf files told apart. Shows what behold does NOT infer as clearly as what it draws: platform declares the KMS key and prod reads it back by alias, and no edge is drawn between them, because both ends carry the same unresolved interpolation (#381). Reads through chant's terraform lexicon (@intentius/chant-lexicon-terraform) and @cdktn/hcl2json, both installed with behold since #909 (an install that pruned them refuses with the line that puts them back); the copy is linked to the lexicon behold resolved, since chant reads a workspace's pinned kinds from beside the workspace. No cloud, no Docker, no terraform binary. The Adopt tab offers each root adoption into choudoufu with chant workspace promote, from a recorded report per root (every resource, claimed or left out and why); nothing is started.",
69
69
  "source": "bundled",
70
70
  "dir": "example-terraform-estate",
71
71
  "requires": [],
72
- "serve": {}
72
+ "serve": {
73
+ "adoptRecorded": "recorded/adoption"
74
+ }
73
75
  },
74
76
  {
75
77
  "name": "carve",
76
- "description": "The peel walkthrough: a half-migrated estate — a chant project beside a Terraform one — scored by `chant carve advise`, then a six-step stepper that carves one S3 bucket across the line on camera (advise, pick, emit, bridge, handoff, done). Emit and bridge really run, into the demo copy; the destructive terraform commands stay yours to paste. No cloud, no Docker, no terraform binary.",
78
+ "description": "The carve walkthrough: a chant project beside a Terraform root, scored by `chant carve advise`, then a six-step handoff of one S3 bucket (advise, pick, emit, bridge, handoff, done). Emit and bridge really run, into the demo copy; the destructive terraform commands stay yours to paste. No cloud, no Docker, no terraform binary.",
77
79
  "source": "bundled",
78
80
  "dir": "example-carve",
79
81
  "requires": [],
80
82
  "serve": {
81
83
  "carve": {
82
84
  "report": "carve-report.json",
83
- "from": "legacy-tf",
84
- "state": "legacy-tf/terraform.tfstate",
85
+ "from": "tf-root",
86
+ "state": "tf-root/terraform.tfstate",
85
87
  "project": "app",
86
88
  "out": "app/carveout"
87
89
  }
@@ -89,7 +91,7 @@
89
91
  },
90
92
  {
91
93
  "name": "choudoufu-estate",
92
- "description": "A tag-owned estate: four choudoufu estates (an OpenTofu fork whose ownership is two AWS tags) served composed — the terralith applied to a scratch floci, three team estates whose declared resources are the monolith's (every card `owned by` it, dashed to its card), a cross-estate data-source edge, and a move plan whose `live-mv` lines you run by hand while behold previews with -dry-run and reads the receipt. A card's colour is ownership, not \"nothing changed\": attribute drift is a separate plan read, opt-in through ⌘K → \"Re-check live with plan\". Docker + choudoufu (0.16.0+, or a build from main) on PATH, and chant's terraform lexicon beside behold (it supplies the choudoufu kind; the copy is linked to it); provider download on first init. scripts/choudoufu-down.sh removes the container.",
94
+ "description": "A tag-owned estate: four choudoufu estates (an OpenTofu fork whose ownership is two AWS tags) served as the declared workspace in chant.workspace.json — the terralith applied to a scratch floci, three team estates whose declared resources are the monolith's (every card `owned by` it, dashed to its card), a cross-estate data-source edge, and a move plan whose `live-mv` lines you run by hand while behold previews with -dry-run and reads the receipt. A card's colour is ownership, not \"nothing changed\": attribute drift is a separate plan read, opt-in through ⌘K → \"Re-check live with plan\", or streamed one resource at a time through ⌘K → \"Stream drift card by card\". Docker + choudoufu (0.16.0+, or a build from main) on PATH, and chant's terraform lexicon beside behold (it supplies the choudoufu kind; the copy is linked to it); provider download on first init. scripts/choudoufu-down.sh removes the container.",
93
95
  "source": "bundled",
94
96
  "dir": "example-choudoufu-estate",
95
97
  "requires": [
@@ -99,6 +101,7 @@
99
101
  "setup": "bash scripts/choudoufu-up.sh",
100
102
  "serve": {
101
103
  "env": "live",
104
+ "workspace": true,
102
105
  "dirs": [
103
106
  "monolith",
104
107
  "team-a",
@@ -106,7 +109,7 @@
106
109
  "team-c"
107
110
  ],
108
111
  "spawnEnv": {
109
- "AWS_ENDPOINT_URL": "http://127.0.0.1:4650",
112
+ "AWS_ENDPOINT_URL": "http://127.0.0.1:${BEHOLD_CHOUDOUFU_FLOCI_PORT:-4650}",
110
113
  "AWS_ACCESS_KEY_ID": "test",
111
114
  "AWS_SECRET_ACCESS_KEY": "test",
112
115
  "AWS_REGION": "us-east-1",
@@ -131,12 +134,14 @@
131
134
  },
132
135
  {
133
136
  "name": "three-cloud",
134
- "description": "A website in three clouds behind Route 53: ECS on Fargate, Azure Container Apps and Cloud Run, each answering through a latency record guarded by a health check, as one chant workspace on the floci, floci-az and floci-gcp emulators. Turn Azure off and its record drops out of rotation; dns/ops/front-door.op.ts (or npm run front-door) applies it all, does that, and exports the page. Pulls three emulator images on first run.",
137
+ "description": "A website in three clouds behind Route 53: ECS on Fargate, Azure Container Apps and Cloud Run, each answering through a latency record guarded by a health check, as one chant workspace on the floci, floci-az and floci-gcp emulators, on three engines. The GCP site and dns are chant members, the Azure site is a choudoufu estate, and the AWS site is a Pulumi program on plunge. Turn Azure off and its record drops out of rotation; dns/ops/front-door.op.ts (or npm run front-door) applies it all, does that, and exports the page, and npm run change-set plans all four members into one change set with a part per engine. Docker, curl, choudoufu (or CHOUDOUFU_BIN) and plunge (or PLUNGE_BIN) on PATH, and chant main's core, terraform and pulumi lexicons linked (see the example's README); pulls three emulator images, the azurerm provider and pulumi-aws on first run.",
135
138
  "source": "bundled",
136
139
  "dir": "example-three-cloud",
137
140
  "requires": [
138
141
  "docker",
139
- "curl"
142
+ "curl",
143
+ "choudoufu",
144
+ "plunge"
140
145
  ],
141
146
  "setup": "bash scripts/emulators-up.sh",
142
147
  "serve": {