@intentius/behold 0.30.1 → 0.31.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 (129) hide show
  1. package/AGENTS.md +475 -16
  2. package/README.md +25 -19
  3. package/demos.json +14 -9
  4. package/dist/cli.js +54900 -26771
  5. package/example-carve/README.md +19 -23
  6. package/example-carve/app/package.json +1 -1
  7. package/example-carve/app/src/carved.ts +3 -3
  8. package/example-carve/carve-report.json +1 -1
  9. package/example-carve/{legacy-tf → tf-root}/terraform.tfstate +1 -1
  10. package/example-choudoufu-estate/README.md +7 -0
  11. package/example-choudoufu-estate/chant.workspace.json +1 -1
  12. package/example-choudoufu-estate/scripts/choudoufu-down.sh +2 -1
  13. package/example-choudoufu-estate/scripts/choudoufu-up.sh +10 -3
  14. package/example-terraform-estate/README.md +32 -5
  15. package/example-terraform-estate/chant.workspace.json +1 -1
  16. package/example-terraform-estate/recorded/adoption/platform.json +72 -0
  17. package/example-terraform-estate/recorded/adoption/prod.json +224 -0
  18. package/example-terralith/README.md +1 -1
  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 +13 -6
  36. package/web/adopt-pulumi.js +114 -0
  37. package/web/adopt-pulumi.test.js +28 -0
  38. package/web/adopt.js +203 -0
  39. package/web/adopt.test.js +27 -0
  40. package/web/app.js +614 -19
  41. package/web/carve-steps.js +1 -1
  42. package/web/carve-steps.test.js +2 -2
  43. package/web/change-set-overlay.js +12 -5
  44. package/web/change-set-overlay.test.js +22 -0
  45. package/web/drift-stream.js +241 -0
  46. package/web/drift-stream.test.js +146 -0
  47. package/web/edge-weight.d.ts +1 -1
  48. package/web/edge-weight.js +5 -1
  49. package/web/edge-weight.test.js +19 -0
  50. package/web/embed.js +2 -2
  51. package/web/event-help-modal.js +18 -12
  52. package/web/event-help-modal.test.js +28 -1
  53. package/web/graph-query.js +180 -0
  54. package/web/graph-query.test.js +49 -0
  55. package/web/graph.html +107 -0
  56. package/web/index-diff.js +109 -0
  57. package/web/index-diff.test.js +39 -0
  58. package/web/index.html +55 -0
  59. package/web/kiosk-ask-layout.js +85 -0
  60. package/web/kiosk-ask-layout.test.js +83 -0
  61. package/web/kiosk-ask-tips.js +477 -0
  62. package/web/kiosk-ask-tips.test.js +372 -0
  63. package/web/kiosk-ask.js +774 -0
  64. package/web/kiosk-ask.test.js +593 -0
  65. package/web/kiosk-banner.js +108 -0
  66. package/web/kiosk-banner.test.js +72 -0
  67. package/web/kiosk-center-cards.test.js +110 -0
  68. package/web/kiosk-estate-scene.js +267 -0
  69. package/web/kiosk-estate-scene.test.js +21 -0
  70. package/web/kiosk-event-help.js +4 -1
  71. package/web/kiosk-graph-pane.js +63 -0
  72. package/web/kiosk-graph-pane.test.js +105 -0
  73. package/web/kiosk-light-frame.js +197 -0
  74. package/web/kiosk-light.js +547 -0
  75. package/web/kiosk-light.test.js +297 -0
  76. package/web/kiosk-member-kind.test.js +140 -0
  77. package/web/kiosk-metrics.js +7 -4
  78. package/web/kiosk-modal-sticky.test.js +2 -1
  79. package/web/kiosk-popover.js +4 -1
  80. package/web/kiosk-refit.test.js +81 -0
  81. package/web/kiosk-reset.js +49 -0
  82. package/web/kiosk-reset.test.js +11 -0
  83. package/web/kiosk-shot.js +40 -2
  84. package/web/kiosk-shot.test.js +23 -1
  85. package/web/kiosk-side.js +296 -0
  86. package/web/kiosk-side.test.js +249 -0
  87. package/web/kiosk-vendor.js +85 -7
  88. package/web/kiosk-vendor.test.js +9 -9
  89. package/web/kiosk-watch.js +20 -4
  90. package/web/kiosk-watch.test.js +15 -1
  91. package/web/kiosk.html +153 -1
  92. package/web/kiosk.js +252 -27
  93. package/web/kiosk.test.js +25 -1
  94. package/web/member-kind.js +31 -0
  95. package/web/small-stage.test.js +4 -0
  96. package/web/template-apps.js +245 -0
  97. package/web/template-apps.test.js +252 -0
  98. package/web/templates.js +285 -0
  99. package/web/templates.test.js +155 -0
  100. package/web/terragucci-change.js +30 -13
  101. package/web/terragucci-lifecycle.js +112 -62
  102. package/web/terragucci-lifecycle.test.js +29 -1
  103. package/web/terragucci-timeline.js +39 -2
  104. package/web/terragucci-timeline.test.js +42 -1
  105. package/web/tool-mark.js +4 -4
  106. package/web/tool-mark.test.js +1 -1
  107. package/web/vendors/atmos.svg +1 -0
  108. package/web/vendors/chant.svg +1 -0
  109. package/web/vendors/choudoufu.svg +1 -0
  110. package/web/vendors/terragrunt.svg +9 -0
  111. package/web/vendors/terragucci.svg +1 -0
  112. package/example-three-cloud/aws/chant.config.ts +0 -8
  113. package/example-three-cloud/aws/site.component.ts +0 -13
  114. package/example-three-cloud/aws/src/site.ts +0 -27
  115. package/example-three-cloud/azure/chant.config.ts +0 -1
  116. package/example-three-cloud/azure/src/site.component.ts +0 -13
  117. package/example-three-cloud/azure/src/site.ts +0 -18
  118. package/web/vendors/choudoufu-128.png +0 -0
  119. package/web/vendors/choudoufu-64.png +0 -0
  120. /package/example-carve/{legacy-tf → tf-root}/cdn.tf +0 -0
  121. /package/example-carve/{legacy-tf → tf-root}/compute.tf +0 -0
  122. /package/example-carve/{legacy-tf → tf-root}/floci-override.tf.disabled +0 -0
  123. /package/example-carve/{legacy-tf → tf-root}/modules/cdn/main.tf +0 -0
  124. /package/example-carve/{legacy-tf → tf-root}/naming.tf +0 -0
  125. /package/example-carve/{legacy-tf → tf-root}/network.tf +0 -0
  126. /package/example-carve/{legacy-tf → tf-root}/observability.tf +0 -0
  127. /package/example-carve/{legacy-tf → tf-root}/outputs.tf +0 -0
  128. /package/example-carve/{legacy-tf → tf-root}/storage.tf +0 -0
  129. /package/example-carve/{legacy-tf → tf-root}/versions.tf +0 -0
package/README.md CHANGED
@@ -27,9 +27,9 @@ https://intentius.io/behold/using/agents/.
27
27
  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
28
  ```
29
29
 
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.
30
+ behold shows the mixed-substrate estate: cloud drift on AWS, supply-chain drift
31
+ on GitHub Actions, artifact presence on Helm. An Argo CD cluster draws in the
32
+ same graph, with each substrate's own kind of truth in one picture.
33
33
 
34
34
  ```
35
35
  chant source ──build/lint──▶ graph IR ──behold──▶ live graph + drift + (delegated) actions
@@ -51,12 +51,13 @@ There's a whole catalog, and `behold demo --list` names the rest (`behold demo
51
51
  k8s` stands the same loop up on a throwaway k3d cluster: runtime Pods, field
52
52
  ownership; `behold demo argo-estate` needs nothing at all, being a three-project
53
53
  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
54
+ choudoufu-estate` is four tag-owned OpenTofu estates served as one declared
55
+ workspace, where a
55
56
  card's colour is **ownership** (bound, unowned, pending) rather than "nothing
56
57
  changed": a resource whose attributes drifted out of band still carries its
57
58
  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
59
+ with ⌘K → "Re-check live with plan"; `behold demo carve` shows chant and
60
+ Terraform managing one account together, below). Two more need no Docker either: `behold demo
60
61
  terraform-estate` draws a multi-root Terraform estate boxed by root, and shows
61
62
  what behold refuses to infer, since one root reads a key the other declares and
62
63
  no edge is drawn between them; `behold demo flux-estate` is a GitOps estate on
@@ -446,12 +447,17 @@ log, which the loop driver copies into the bucket under `runs/`. It needs
446
447
  `--terragucci`, asks only GETs, and has no control.
447
448
  The docs' terragucci page says what it shows.
448
449
 
449
- Each tool in the loop has a page of its own at `/<tool>`: `/terraform`,
450
- `/terragrunt`, `/cdk-terrain` and `/choudoufu` (behold#571). It shows that
451
- tool's scenario and runs alone, with a footer saying who makes the tool.
452
- While another tool's scenario runs, the page replays the tool's latest cycle at
453
- the pace it ran (`cycles/<tool>/latest.json` beside `demo.json`), and says so in
454
- a banner. Any other short path answers 404 with a link to `/kiosk`.
450
+ The demo is served at `/`: the live demo's page, else the first listed one.
451
+ `/kiosk` redirects to `/`. The listed demos are the multi-state plan-and-apply
452
+ ones, each at a path of its own (`/choudoufu-compose`, `/terragrunt-choudoufu`,
453
+ `/atmos-choudoufu`, `/chant-compose`); one is listed once its tool has a published cycle
454
+ (`cycles/<tool>/latest.json` beside `demo.json`) or is live, and
455
+ `/api/terragucci/demos` says which. A page shows the demo's live run, or replays
456
+ its latest cycle, under a banner with the example's name, its products, a link to
457
+ its code in INTENTIUS/terragucci, and a switcher when more than one is listed.
458
+ The older tools' URLs (`/terraform`, `/terragrunt`, `/cdk-terrain`, `/choudoufu`,
459
+ `/chant`, and the fan-out pages) redirect to `/`. Any other short path answers
460
+ 404 with a link to the front page.
455
461
 
456
462
  In a declared workspace, the gates waiting on a person come from
457
463
  `chant workspace status <env> --json`, keyed `member/op/gate` the way arugula's
@@ -499,11 +505,11 @@ Documents are checked against terragucci's JSON Schemas when
499
505
  docs `using/terragucci`. `example-terragucci-reports/` is a bucket for
500
506
  terragucci's own example, written by terragucci's code.
501
507
 
502
- ## Terraform carve-out: `behold carve <report.json>`
508
+ ## Terraform and chant: `behold carve <report.json>`
503
509
 
504
- `chant carve advise` ranks a Terraform estate by **peelability**: how cleanly
505
- each resource could be carved into native chant source. `behold carve` draws
506
- that ranking: one card per resource, three panels (carve now / boundary work /
510
+ `chant carve advise` reads a Terraform estate and shows which resources chant
511
+ can also manage, and the work each handoff takes. `behold carve` draws that
512
+ report: one card per resource, three panels (carve now / boundary work /
507
513
  leave in Terraform) on the same `attrs._status` drift palette every other view
508
514
  uses, and the score arithmetic behind each rank in the inspect pane.
509
515
 
@@ -529,8 +535,8 @@ own `<address>.carve.json` manifests.
529
535
  npx @intentius/behold demo carve # no Docker, no cloud, no terraform binary
530
536
  ```
531
537
 
532
- Copies a half-migrated estate (a small chant project beside a Terraform one,
533
- both describing the same AWS account), installs the chant it will shell, runs
538
+ Copies a mixed estate (a small chant project beside a Terraform one, both on
539
+ the same AWS account), installs the chant it will shell, runs
534
540
  `chant carve advise` over the copy, and opens the banded graph with a six-step
535
541
  stepper on the panel's **Carve** tab:
536
542
 
@@ -550,7 +556,7 @@ stepper on the panel's **Carve** tab:
550
556
 
551
557
  The Emit step reports `chant lint`, not `chant build`: `build` fails on the
552
558
  emitted bucket (scored 84 by the advisor) on one rule: WAW042, a TLS-deny
553
- bucket policy the source Terraform never declared. The panel links the
559
+ bucket policy. Adding one in Terraform fixes it too. The panel links the
554
560
  reason. [example-carve/README.md](example-carve/README.md) has the estate's full story, the band table,
555
561
  and the offline/`--live` split.
556
562
 
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": {