@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.
- package/AGENTS.md +475 -16
- package/README.md +25 -19
- package/demos.json +14 -9
- package/dist/cli.js +54900 -26771
- package/example-carve/README.md +19 -23
- package/example-carve/app/package.json +1 -1
- package/example-carve/app/src/carved.ts +3 -3
- package/example-carve/carve-report.json +1 -1
- package/example-carve/{legacy-tf → tf-root}/terraform.tfstate +1 -1
- package/example-choudoufu-estate/README.md +7 -0
- package/example-choudoufu-estate/chant.workspace.json +1 -1
- package/example-choudoufu-estate/scripts/choudoufu-down.sh +2 -1
- package/example-choudoufu-estate/scripts/choudoufu-up.sh +10 -3
- package/example-terraform-estate/README.md +32 -5
- package/example-terraform-estate/chant.workspace.json +1 -1
- package/example-terraform-estate/recorded/adoption/platform.json +72 -0
- package/example-terraform-estate/recorded/adoption/prod.json +224 -0
- package/example-terralith/README.md +1 -1
- package/example-three-cloud/README.md +111 -18
- package/example-three-cloud/aws/Pulumi.yaml +15 -0
- package/example-three-cloud/aws/index.ts +174 -0
- package/example-three-cloud/aws/package-lock.json +2725 -0
- package/example-three-cloud/aws/package.json +14 -0
- package/example-three-cloud/aws/tsconfig.json +17 -0
- package/example-three-cloud/azure/main.tf +48 -0
- package/example-three-cloud/azure/site.tf +104 -0
- package/example-three-cloud/chant.config.json +9 -0
- package/example-three-cloud/chant.workspace.json +30 -4
- package/example-three-cloud/dns/chant.config.ts +26 -1
- package/example-three-cloud/dns/src/records.component.ts +32 -6
- package/example-three-cloud/package-lock.json +48 -27
- package/example-three-cloud/package.json +8 -6
- package/example-three-cloud/scripts/emulators-up.sh +28 -1
- package/example-three-cloud/scripts/front-door.ts +679 -86
- package/package.json +13 -6
- package/web/adopt-pulumi.js +114 -0
- package/web/adopt-pulumi.test.js +28 -0
- package/web/adopt.js +203 -0
- package/web/adopt.test.js +27 -0
- package/web/app.js +614 -19
- package/web/carve-steps.js +1 -1
- package/web/carve-steps.test.js +2 -2
- package/web/change-set-overlay.js +12 -5
- package/web/change-set-overlay.test.js +22 -0
- package/web/drift-stream.js +241 -0
- package/web/drift-stream.test.js +146 -0
- package/web/edge-weight.d.ts +1 -1
- package/web/edge-weight.js +5 -1
- package/web/edge-weight.test.js +19 -0
- package/web/embed.js +2 -2
- package/web/event-help-modal.js +18 -12
- package/web/event-help-modal.test.js +28 -1
- package/web/graph-query.js +180 -0
- package/web/graph-query.test.js +49 -0
- package/web/graph.html +107 -0
- package/web/index-diff.js +109 -0
- package/web/index-diff.test.js +39 -0
- package/web/index.html +55 -0
- package/web/kiosk-ask-layout.js +85 -0
- package/web/kiosk-ask-layout.test.js +83 -0
- package/web/kiosk-ask-tips.js +477 -0
- package/web/kiosk-ask-tips.test.js +372 -0
- package/web/kiosk-ask.js +774 -0
- package/web/kiosk-ask.test.js +593 -0
- package/web/kiosk-banner.js +108 -0
- package/web/kiosk-banner.test.js +72 -0
- package/web/kiosk-center-cards.test.js +110 -0
- package/web/kiosk-estate-scene.js +267 -0
- package/web/kiosk-estate-scene.test.js +21 -0
- package/web/kiosk-event-help.js +4 -1
- package/web/kiosk-graph-pane.js +63 -0
- package/web/kiosk-graph-pane.test.js +105 -0
- package/web/kiosk-light-frame.js +197 -0
- package/web/kiosk-light.js +547 -0
- package/web/kiosk-light.test.js +297 -0
- package/web/kiosk-member-kind.test.js +140 -0
- package/web/kiosk-metrics.js +7 -4
- package/web/kiosk-modal-sticky.test.js +2 -1
- package/web/kiosk-popover.js +4 -1
- package/web/kiosk-refit.test.js +81 -0
- package/web/kiosk-reset.js +49 -0
- package/web/kiosk-reset.test.js +11 -0
- package/web/kiosk-shot.js +40 -2
- package/web/kiosk-shot.test.js +23 -1
- package/web/kiosk-side.js +296 -0
- package/web/kiosk-side.test.js +249 -0
- package/web/kiosk-vendor.js +85 -7
- package/web/kiosk-vendor.test.js +9 -9
- package/web/kiosk-watch.js +20 -4
- package/web/kiosk-watch.test.js +15 -1
- package/web/kiosk.html +153 -1
- package/web/kiosk.js +252 -27
- package/web/kiosk.test.js +25 -1
- package/web/member-kind.js +31 -0
- package/web/small-stage.test.js +4 -0
- package/web/template-apps.js +245 -0
- package/web/template-apps.test.js +252 -0
- package/web/templates.js +285 -0
- package/web/templates.test.js +155 -0
- package/web/terragucci-change.js +30 -13
- package/web/terragucci-lifecycle.js +112 -62
- package/web/terragucci-lifecycle.test.js +29 -1
- package/web/terragucci-timeline.js +39 -2
- package/web/terragucci-timeline.test.js +42 -1
- package/web/tool-mark.js +4 -4
- package/web/tool-mark.test.js +1 -1
- package/web/vendors/atmos.svg +1 -0
- package/web/vendors/chant.svg +1 -0
- package/web/vendors/choudoufu.svg +1 -0
- package/web/vendors/terragrunt.svg +9 -0
- package/web/vendors/terragucci.svg +1 -0
- package/example-three-cloud/aws/chant.config.ts +0 -8
- package/example-three-cloud/aws/site.component.ts +0 -13
- package/example-three-cloud/aws/src/site.ts +0 -27
- package/example-three-cloud/azure/chant.config.ts +0 -1
- package/example-three-cloud/azure/src/site.component.ts +0 -13
- package/example-three-cloud/azure/src/site.ts +0 -18
- package/web/vendors/choudoufu-128.png +0 -0
- package/web/vendors/choudoufu-64.png +0 -0
- /package/example-carve/{legacy-tf → tf-root}/cdn.tf +0 -0
- /package/example-carve/{legacy-tf → tf-root}/compute.tf +0 -0
- /package/example-carve/{legacy-tf → tf-root}/floci-override.tf.disabled +0 -0
- /package/example-carve/{legacy-tf → tf-root}/modules/cdn/main.tf +0 -0
- /package/example-carve/{legacy-tf → tf-root}/naming.tf +0 -0
- /package/example-carve/{legacy-tf → tf-root}/network.tf +0 -0
- /package/example-carve/{legacy-tf → tf-root}/observability.tf +0 -0
- /package/example-carve/{legacy-tf → tf-root}/outputs.tf +0 -0
- /package/example-carve/{legacy-tf → tf-root}/storage.tf +0 -0
- /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
|
-
|
|
31
|
-
|
|
32
|
-
|
|
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
|
|
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`
|
|
59
|
-
|
|
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
|
-
|
|
450
|
-
`/
|
|
451
|
-
|
|
452
|
-
|
|
453
|
-
|
|
454
|
-
|
|
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
|
|
508
|
+
## Terraform and chant: `behold carve <report.json>`
|
|
503
509
|
|
|
504
|
-
`chant carve advise`
|
|
505
|
-
|
|
506
|
-
|
|
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
|
|
533
|
-
|
|
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
|
|
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
|
|
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": "
|
|
84
|
-
"state": "
|
|
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
|
|
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
|
|
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.
|
|
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": {
|