Step 10: Front-end research

kayg commented

2026-09-21 17:13:43 +00:00

Owner

Cited web research: libghostty WebAssembly vs xterm.js; Bklit charts in Svelte 5; svelte-sonner with Svelte 5; accessible drag-reorder for Svelte 5.

Step 10 in docs/PLAN.md. Done when: docs/research/front-end.md written

Cited web research: libghostty WebAssembly vs xterm.js; Bklit charts in Svelte 5; svelte-sonner with Svelte 5; accessible drag-reorder for Svelte 5. Step 10 in docs/PLAN.md. Done when: docs/research/front-end.md written

kayg commented

2026-09-21 17:16:17 +00:00

Author

Owner

Starting step 10 front-end research.

branch: research-frontend
base head: 6d38283ea725a91559569839642aa85240856972 (dev)
owned file: docs/research/front-end.md
scope: cited research for terminal engines, Bklit charts, svelte-sonner, accessible sidebar drag-reordering, and virtualization in Svelte 5

Starting step 10 front-end research. - branch: `research-frontend` - base head: `6d38283ea725a91559569839642aa85240856972` (`dev`) - owned file: `docs/research/front-end.md` - scope: cited research for terminal engines, Bklit charts, svelte-sonner, accessible sidebar drag-reordering, and virtualization in Svelte 5

kayg commented

2026-09-21 17:34:50 +00:00

Author

Owner

Step 10 summary — front-end research, checked 2026-09-21:

Area	Recommendation
Terminal	Build a repo-owned async xterm-compatible subset; start a pinned `ghostty-web@0.4.0`/Ghostty WASM backend, with `@xterm/xterm@6.0.0` + WebGL `0.19.0` fallback until IME, WASM-memory, and multi-instance soak tests pass.
Charts	Use Bklit line/area registry source in a lazy React island behind a Svelte wrapper; no static React import and measure the chart chunk in production.
Toasts	Use `svelte-sonner@1.2.1` at the root with tokenized theming and polite live regions by default.
Reordering	Use `@dnd-kit/svelte@0.5.0` plus a visible Move action menu; own nested-tree semantics and announcements in our model.
Tables/logs	Use `@tanstack/svelte-virtual@3.13.39` with fixed-height logs, a bounded ring buffer, and frame-coalesced ingestion; measure the 10k-lines/s gate.

The full evidence report is committed at 2baad42 in docs/research/front-end.md. docs/contracts.md is referenced by the operating contract but is absent in this branch. The required scripts/verify fast entry point is also absent in this branch; it returned exit 127, so only git diff --check passed locally.

Step 10 summary — front-end research, checked 2026-09-21: | Area | Recommendation | | --- | --- | | Terminal | Build a repo-owned async xterm-compatible subset; start a pinned `ghostty-web@0.4.0`/Ghostty WASM backend, with `@xterm/xterm@6.0.0` + WebGL `0.19.0` fallback until IME, WASM-memory, and multi-instance soak tests pass. | | Charts | Use Bklit line/area registry source in a lazy React island behind a Svelte wrapper; no static React import and measure the chart chunk in production. | | Toasts | Use `svelte-sonner@1.2.1` at the root with tokenized theming and polite live regions by default. | | Reordering | Use `@dnd-kit/svelte@0.5.0` plus a visible Move action menu; own nested-tree semantics and announcements in our model. | | Tables/logs | Use `@tanstack/svelte-virtual@3.13.39` with fixed-height logs, a bounded ring buffer, and frame-coalesced ingestion; measure the 10k-lines/s gate. | The full evidence report is committed at `2baad42` in `docs/research/front-end.md`. `docs/contracts.md` is referenced by the operating contract but is absent in this branch. The required `scripts/verify fast` entry point is also absent in this branch; it returned exit 127, so only `git diff --check` passed locally.

kayg commented

2026-09-21 17:35:11 +00:00

Author

Owner

Finished step 10 on branch research-frontend.

Head: 2baad4281837fca2512b33fff997b4a45b16cd7b
Deliverable: docs/research/front-end.md
Working tree: clean.

Verification:

$ git diff --check
(no output; exit 0)

$ scripts/verify fast
/bin/bash: line 1: scripts/verify: No such file or directory
exit 127

The repository’s prescribed verification entry point is not present in this branch; no replacement gate was invented for this documentation-only job.

Finished step 10 on branch `research-frontend`. Head: `2baad4281837fca2512b33fff997b4a45b16cd7b` Deliverable: `docs/research/front-end.md` Working tree: clean. Verification: ```text $ git diff --check (no output; exit 0) $ scripts/verify fast /bin/bash: line 1: scripts/verify: No such file or directory exit 127 ``` The repository’s prescribed verification entry point is not present in this branch; no replacement gate was invented for this documentation-only job.

kayg commented

2026-09-21 17:36:09 +00:00

Author

Owner

Orchestrator: read and accepted. Merged to dev; later steps (terminal, charts, tables, sidebar reordering) build on these recommendations. Step 10 done.

kayg referenced this issue from a commit

2026-09-21 17:36:10 +00:00

Merge front-end research (step 10, #6)

kayg referenced this issue

2026-09-22 08:15:29 +00:00

Handover: start here (orchestrator on the dev VM) #16

Rows
Columns

Step 10: Front-end research #6