@intentius/behold 0.29.42 → 0.29.44

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 (68) hide show
  1. package/AGENTS.md +77 -0
  2. package/dist/cli.js +3969 -1918
  3. package/package.json +1 -1
  4. package/web/app.js +1463 -80
  5. package/web/carve-narration.js +33 -1
  6. package/web/chant-live-pace.js +138 -0
  7. package/web/chant-live-pace.test.js +116 -0
  8. package/web/chant-pr-marks.js +417 -39
  9. package/web/chant-pr-marks.test.js +208 -4
  10. package/web/collision-marks.js +124 -0
  11. package/web/collision-marks.test.js +89 -0
  12. package/web/cone.js +269 -0
  13. package/web/cone.test.js +213 -0
  14. package/web/dots-cards.js +362 -0
  15. package/web/dots-cards.test.js +303 -0
  16. package/web/dots-live.test.js +151 -1
  17. package/web/dots-lod.js +20 -0
  18. package/web/dots-lod.test.js +19 -1
  19. package/web/dots-scene.js +110 -10
  20. package/web/dots.js +489 -87
  21. package/web/embed.js +17 -1
  22. package/web/embed.test.js +19 -1
  23. package/web/event-help-modal.js +85 -3
  24. package/web/event-help-modal.test.js +85 -1
  25. package/web/feature-flags.js +143 -0
  26. package/web/feature-flags.test.js +96 -0
  27. package/web/index.html +33 -0
  28. package/web/kiosk-carve.js +59 -6
  29. package/web/kiosk-event-help-ui.js +150 -19
  30. package/web/kiosk-event-help.js +102 -15
  31. package/web/kiosk-event-help.test.js +58 -1
  32. package/web/kiosk-metrics.js +4 -3
  33. package/web/kiosk-runs.js +8 -5
  34. package/web/kiosk-shot.js +157 -3
  35. package/web/kiosk-shot.test.js +223 -1
  36. package/web/kiosk-source.js +43 -0
  37. package/web/kiosk-source.test.js +39 -0
  38. package/web/kiosk-story-gate.test.js +44 -0
  39. package/web/kiosk-track.js +312 -0
  40. package/web/kiosk-track.test.js +148 -0
  41. package/web/kiosk-unknown-step.test.js +58 -0
  42. package/web/kiosk-vendor.js +71 -4
  43. package/web/kiosk-vendor.test.js +103 -3
  44. package/web/kiosk-watch.js +154 -1
  45. package/web/kiosk-watch.test.js +53 -1
  46. package/web/kiosk.html +57 -22
  47. package/web/kiosk.js +566 -53
  48. package/web/kiosk.test.js +2 -1
  49. package/web/small-stage.test.js +150 -0
  50. package/web/terragucci-blocked.test.js +192 -0
  51. package/web/terragucci-change.js +197 -17
  52. package/web/terragucci-components-live.js +189 -13
  53. package/web/terragucci-live-pace.js +92 -0
  54. package/web/terragucci-wave-results.test.js +125 -0
  55. package/web/terralith.html +7 -7
  56. package/web/tg-outside.js +124 -0
  57. package/web/tg-outside.test.js +100 -0
  58. package/web/tg-read-pills.js +122 -0
  59. package/web/tg-read-pills.test.js +117 -0
  60. package/web/theme.js +13 -1
  61. package/web/theme.test.js +21 -1
  62. package/web/tooltip.js +19 -7
  63. package/web/tooltip.test.js +15 -0
  64. package/web/tours/terralith.json +4 -4
  65. package/web/trunk-lane.test.js +1 -1
  66. package/web/view-url.js +8 -2
  67. package/web/why.js +129 -1
  68. package/web/why.test.js +113 -1
package/AGENTS.md CHANGED
@@ -1099,6 +1099,83 @@ forget) with a tag above it, never a fill; it is opened from the "change set"
1099
1099
  link on a Trunk tab gate card and turned off from its tab. A public view
1100
1100
  refuses the route, as it refuses the lane.
1101
1101
 
1102
+ ## Feature flags on the graph (#683)
1103
+
1104
+ `GET /api/workspace/flags` (src/feature-flags.ts) reads each member's
1105
+ `featureFlags` from `chant workspace status <env> --json` (chant#4024, floor
1106
+ `FEATURE_FLAGS_CHANT_FLOOR`, 0.124.29): per flag its `param`, `owner`, `work`
1107
+ with its state, `values` per environment and `stale`, the stale-flag lint's
1108
+ verdict (WSP118). It reads status in each environment of the promotion order
1109
+ for the waiting gates, and for each gate of a flagged member with a stored
1110
+ change set, `chant change-set show`, keeping the entries whose attribute
1111
+ `param:<param>` moves the flag's parameter (`waiting`, with before, after and
1112
+ the node chant mapped, which is null for a release's `chant:component`
1113
+ entry). chant names no graph node that reads a build parameter, so a flag
1114
+ marks every card of its member (`nodes: "member"`); behold infers no finer
1115
+ mapping. behold writes no flag record and has no flag write route: a waiting
1116
+ flip opens #681's change-set overlay for its gate, and otherwise `turnOn`
1117
+ carries the lines a person runs (`chant workspace records amend <id> --kind
1118
+ <kind> --set -` with the new values, then `git commit` of the record). The
1119
+ page (web/feature-flags.js) is the Flags tab and a tag under each flagged
1120
+ card in the environment the tab picks. Below the floor the route answers the
1121
+ refusal and `degraded`, and the graph draws no marks. A public view refuses
1122
+ the route. `src/feature-flags-chant.test.ts` reads the workspace
1123
+ `src/feature-flags-fixture.ts` makes through a real chant when
1124
+ `BEHOLD_TEST_CHANT_BIN` names one.
1125
+ ## The why chain (#682)
1126
+
1127
+ From chant 0.124.29 the intent document `GET /api/workspace/why` reads carries
1128
+ `trace` (chant#4023): for each commit chant walked, the work items its
1129
+ `Chant-Record` or `Chant-Lease` trailer names (judged linked, unlinked, wrong
1130
+ or merge), the work items whose window it fell in (listed apart, never a
1131
+ link), its ci tag, the release cut from it or containing it, that release's
1132
+ gate resolutions (who, channel, when, the plan and the change set stored
1133
+ under it) and its deploys per environment. Every link names its source
1134
+ record (`source: {ref, field, value}`: a commit, a tag ref, a work record's
1135
+ file, or `chant/lifecycle:<path>`), and the pane gives each as the `git show`
1136
+ line that opens it, with a copy button. A link chant found nothing for is
1137
+ drawn as missing, with chant's reason where it gives one, and `trace.reasons`
1138
+ (`ledger-unreadable`, `declaration-invalid`) as partial-read notices. behold
1139
+ adds each commit's subject and each work item's title from the same
1140
+ document's `nodes` and joins nothing: a commit names its release and deploys
1141
+ by id in the same trace. A release gate's change set is shown as `chant
1142
+ change-set show <digest> --member <member>`, since the overlay (#681) opens
1143
+ only a gate still waiting.
1144
+
1145
+ The floor is `WHY_TRACE_CHANT_FLOOR` (0.124.29, read "why chain"). Below it
1146
+ nothing is refused: the answer has `trace: null` and `chain: {full: false,
1147
+ floor, note}`, and the pane shows the decisions, runs and commits it always
1148
+ did with the note. `src/why-trace-schema/intent.schema.json` is chant's
1149
+ intent schema at 5d33a48e7; `src/__fixtures__/why-trace/` was recorded from
1150
+ chant main at that commit in the workspace `src/why-trace-fixture.ts` makes,
1151
+ and `src/why-trace-chant.test.ts` reads the same workspace through a real
1152
+ chant when `BEHOLD_TEST_CHANT_BIN` names one.
1153
+
1154
+ ## Collision marks (#684)
1155
+
1156
+ `GET /api/workspace/collisions` (src/collision-marks.ts) reads `overlap` from
1157
+ `chant workspace status <env> --json` (chant#4025, floor `OVERLAP_CHANT_FLOOR`,
1158
+ 0.124.29): the in-flight work items with a linked commit, and each pair of
1159
+ them that changed one file or that a waiting gate's change set reaches at one
1160
+ entry. An entry names its graph node (`<member>/<id>`), and that node is what
1161
+ the graph marks (`nodes`, each with the items colliding there and the entries
1162
+ behind it). Files two items both changed have no node, and neither does an
1163
+ entry chant mapped to none: both go in a side list (`files`, `unplaced`).
1164
+ `items` holds every in-flight item with `with`, the items it collides with
1165
+ (empty for most). `overlap` absent is an older chant (`no-overlap`), and
1166
+ `null` is no work kind declared or a failed read (`overlap-unavailable`); both
1167
+ are refusals worded apart. One status read, through the read contract. behold
1168
+ records, locks and refuses nothing. The page (web/collision-marks.js) is the
1169
+ Collisions tab, a dashed ring and a tag under each marked card, and the
1170
+ filter, "Show only colliding work": it hides every card that is not a marked
1171
+ node and every edge with an unmarked end, and lists only the items that
1172
+ collide. Below the floor the route answers the refusal and `degraded`, and
1173
+ the graph draws no marks. A public view refuses the route.
1174
+ `src/collision-marks-chant.test.ts` reads the workspace
1175
+ `src/collision-fixture.ts` makes through a real chant when
1176
+ `BEHOLD_TEST_CHANT_BIN` names one. `status.schema.json` in
1177
+ src/trunk-lane-schemas/ is chant main at e9c996e93.
1178
+
1102
1179
  ## Invariant
1103
1180
 
1104
1181
  If a request would have behold write to a cloud or to source directly, it's wrong.