feat(viz): P3 — holon-viz-wasm crate + TypeScript/esbuild build step

- holon-viz-wasm: 8 wasm-bindgen filter/query functions for client-side
  graph filtering (text, z_layer, semantic_type, edge label, stats)
- TypeScript build pipeline: esbuild + @types/cytoscape, hand-authored
  src/types.ts, legacy JS wrapped for incremental migration
- Justfile: build-wasm, ui-install, ui-build, ui-typecheck, ui-watch
- PRD-HANDOVER.md: all P1-P3 viz backlog items now shipped

Author: Claude Sonnet (coordinator)

.b00t/tasks.json

@@ -14,10 +14,11 @@
       "id": 2,
       "title": "Add autorun + UX test automation with countdown timer",
       "description": "ledgrrr window has white screen. Need autorun with countdown timer (10s idle). UX test automation script parametrizes the countdown. Auto-stay-active after 10s idle.",
-      "status": "pending",
+      "status": "in-progress",
       "priority": 1,
       "tags": [],
-      "created_at": "2026-05-03T17:36:40Z"
+      "created_at": "2026-05-03T17:36:40Z",
+      "updated_at": "2026-05-13T14:40:54Z"
     },
     {
       "id": 3,
@@ -94,4 +95,4 @@
     }
   ],
   "version": "1"
-}
+}

Cargo.lock

@@ -20,6 +20,7 @@ members = [
   "kani-proofs",
   "crates/holon-viz",
   "crates/ledgerr-model-server",
+  "crates/holon-viz-wasm",
 ]
 resolver = "2"
 

Cargo.toml

@@ -119,6 +119,28 @@ test-holon-viz:
 test-holon-viz-fast:
     powershell.exe -NoProfile -ExecutionPolicy Bypass -File "D:\Projects\l3dg3rr\scripts\test-holon-viz.ps1" -SkipBuild
 
+# Build WASM package for holon-viz filtering
+build-wasm:
+    cd crates/holon-viz-wasm && wasm-pack build --target web --out-dir pkg
+
+# ─── UI build (TypeScript / esbuild) ──────────────────────────────────────────
+
+# Install UI dependencies
+ui-install:
+    cd crates/ledgerr-host/ui && npm install
+
+# Build UI TypeScript bundle
+ui-build: ui-install
+    cd crates/ledgerr-host/ui && npm run build
+
+# Type-check UI
+ui-typecheck: ui-install
+    cd crates/ledgerr-host/ui && npm run typecheck
+
+# Watch UI for development
+ui-watch:
+    cd crates/ledgerr-host/ui && npm run watch
+
 # ─── Local model assets ───────────────────────────────────────────────────────
 
 # Install Microsoft Foundry Local on Windows, then print version and service status.

Justfile

@@ -124,13 +124,13 @@ Priority legend: **P1** = current sprint / unblocked, **P2** = next sprint, **P3
 | ~~P2~~ | ~~`MutationRecord` dead code~~ | Shipped 2026-05-14. Unified into canonical owned struct in `workbook.rs`; `append_mutation_record()` wired; `classify.rs` re-exports. 3 call sites converted. |
 | ~~P2~~ | ~~Seed ↔ `HasVisualization` gap detector~~ | Shipped 2026-05-14. `seed_typed_nodes_cover_all_has_visualization_impls` in `holon-viz/src/type_graph.rs`; 23 typed_node IDs checked. Also fixed seed gap: MetaCtx and Disposition were missing. |
 | ~~P2~~ | ~~Rhai DSL validation~~ | Shipped 2026-05-14. `all_viz_spec_rhai_dsl_has_valid_syntax` in `ledger-core/src/iso_objects.rs`; 22/22 pass. Fixed 12 invalid DSL strings (reserved keywords, struct literals, tuple syntax). |
-| P2 | `HasVisualization` trait wiring | Wire `HasVisualization` implementations from `ledger-core/src/iso_objects.rs` into Cytoscape node metadata (ZLayer → node color, SemanticType → node shape) |
-| P3 | `holon-viz-wasm` crate | `wasm-bindgen` on `VizGraph` for client-side filtering (e.g., filter-by-kind). Add when filter UX is a P1 item. Do not add speculatively. |
-| P3 | TypeScript build step for UI | `cytoscape@3` has built-in TS types; add `esbuild` build step to `ui/` when ready |
+| ~~P2~~ | ~~`HasVisualization` trait wiring~~ | Shipped 2026-05-14. `z_layer`/`semantic_type` on `TypeNode`/`CytoscapeNodeData`; 21 types annotated; `z_layer` CSS selectors in `main.js`. |
+| ~~P3~~ | ~~`holon-viz-wasm` crate~~ | Shipped 2026-05-14. `crates/holon-viz-wasm` — 8 `wasm-bindgen` filter/query functions; native `#[test]`s + `wasm_bindgen_test` suite; `just build-wasm` recipe. |
+| ~~P3~~ | ~~TypeScript build step for UI~~ | Shipped 2026-05-14. `crates/ledgerr-host/ui/` — esbuild + TypeScript + `@types/cytoscape`; `ui-build`/`ui-typecheck`/`ui-watch` recipes; hand-authored `src/types.ts`; legacy JS wrapped during incremental migration. |
 
 ---
 
-*Last updated: 2026-05-13 (PM-4 session)*
+*Last updated: 2026-05-14 (P3 viz infrastructure session)*
 
 ---
 
@@ -265,6 +265,28 @@ Both are tooling constraints, not delegation failures. Coordinator did inline Py
 - CDP test `just test-holon-viz-fast` — **7/7 PASS**: 47 nodes, 21 z_layer-typed, 57 edges, hierarchy confirmed
 
 ### Backlog Status
-All P2 items shipped. Only P3 items remain (holon-viz-wasm, TS build step).
+All P2 items shipped. P3 items remaining (holon-viz-wasm, TS build step).
+
+---
+
+## Session Log — 2026-05-14 (P3 viz infrastructure session)
+
+### Shipped
+
+| Item | Details |
+|------|---------|
+| **`holon-viz-wasm` crate** | `crates/holon-viz-wasm/` — new workspace member. 8 `wasm-bindgen` filter functions: `filter_nodes_by_text`, `filter_nodes_by_z_layer`, `filter_nodes_by_semantic_type`, `filter_edges_by_label`, `get_unique_edge_labels`, `get_unique_z_layers`, `get_unique_semantic_types`, `get_graph_stats`. All stateless (JSON in → JSON out). 6 native `#[test]`s + 5 `wasm_bindgen_test` browser tests. `just build-wasm` recipe. |
+| **TypeScript/esbuild build step** | `crates/ledgerr-host/ui/` — `package.json` (esbuild + typescript + @types/cytoscape), `tsconfig.json`, `build.mjs` (esm bundle, CDN externals), `src/types.ts` (hand-authored `CytoscapeGraph` interfaces), `src/main.ts` (legacy wrapper). `main.js` renamed to `main-legacy.js`; esbuild produces new `main.js` (91.6kb, functionally identical). Justfile: `ui-install`, `ui-build`, `ui-typecheck`, `ui-watch`. |
+
+### Build Status
+- `cargo check -p holon-viz-wasm` — clean
+- `cargo check -p holon-viz` — clean
+- `cargo check -p ledgerr-host --bin host-tauri` — clean
+- `npm run build` — 212ms, 91.6kb output
+- `npm run typecheck` — clean
+- `just check-drift` — all 3 artifacts pass
+
+### Backlog Status
+All P1–P3 viz items shipped. Post-MVP viz roadmap complete.
 
-*Last updated: 2026-05-14 (KerML codegen session)*
+*Last updated: 2026-05-14 (P3 viz infrastructure session)*

PRD-HANDOVER.md

@@ -0,0 +1,24 @@
+[package]
+name = "holon-viz-wasm"
+version.workspace = true
+edition.workspace = true
+license.workspace = true
+description = "WASM bindings for holon-viz graph filtering — client-side Cytoscape graph queries compiled to WebAssembly"
+repository = "https://github.com/PromptExecution/ledgrrr"
+
+[lib]
+crate-type = ["cdylib", "rlib"]
+
+[dependencies]
+wasm-bindgen = "0.2"
+holon-viz = { path = "../holon-viz" }
+serde.workspace = true
+serde_json.workspace = true
+js-sys = "0.3"
+web-sys = { version = "0.3", features = ["console"] }
+
+[dev-dependencies]
+wasm-bindgen-test = "0.3"
+
+[lints.rust]
+unsafe_code = "deny"