Shared memory and context tools for agentic work.
Code Rooms
# v1tals — m1nd — 2026-07-23b (bulletin 3b — the UI/design/perf half)
> **Sibling bulletin.** A parallel session landed `2026-07-23.md` (bulletin 3 — the release-era
> backend window: CI contract pin healed, IDE-INTEGRATIONS trued, debt flat through +1,477 lines)
> while this one was in flight. Both are honest and complementary, so both stand — house precedent
> `2026-07-21` + `2026-07-21b`. **This half is the LIVE one**: the manual adversarial browser drive
> and the deep design pattern-architect pass, executed against a running owner with the real graph —
> the two debts bulletins 1-2 deferred twice. Read `2026-07-23.md` for the backend/release axes and
> this file for the UI, design, ergonomics and transfer-performance axes.
> Triggered by the 5-merges standard (`.vitals-due` rang at 7 merges since bulletin 2 — the
> 1.5.0 era: #391 Windows healing + security fix, #389 MCP tool-schema P0, #390 first-run
> honesty, #388/#393/#394 release chain, #395 PRD re-freeze). Scope: `main` @ `82df89ee`.
> **This bulletin pays the two debts the previous bulletins deferred twice**: the manual
> adversarial browser drive and the deep design pattern-architect pass — both executed on a
> live isolated owner with the real graph (16.8k nodes). Production :1338 untouched.
## Scores & trend
| Eixo | Nota | Trend | Evidência (1-3) |
|---|---|---|---|
| 0 · Era-coerência dos docs | **A−** | held | Doc-coupling law honored in BOTH behavioral PRs (#390 fixed code + every agent surface same-PR; #391 landed the fs contract in AGENTS.md:32-42). PRD re-freeze digest agrees six ways (guard script, ci.yml, release.yml, proof, branch name). Dings: README carried two stale 1.4.x claims (fixed inline), i18n READMEs are TWO majors behind (1.2.0 — batch), the dated-HANDOFF antipattern keeps accreting. |
| 1 · Dívida técnica | **C+** (backend) | ↑ slight | A remarkably clean era: monolith growth was 100% proof-tests/hardening (server.rs +181 = ~31 production + ~150 test lines; layer_handlers **=0**), the era ADDED a cohesive module (`legacy_snapshot_adoption.rs`, 416 lines, zero unwraps in production paths) and REMOVED a stub (Windows peek allow-root). Hygiene held at **zero** TODO/FIXME/HACK. Standing liability unchanged: 3 monoliths >11k lines; **new lever found: server.rs is 43% inline `mod tests` (6,161 lines) — extraction would nearly halve it, zero semantic change**. |
| 2 · E2E real | **A−** | drive finally done | Suites match exactly (unit 646/646 · e2e 31/31 in 45.7s). Adversarial drive on the live 16.8k graph: deep-link restore ✓, garbage-route fallback ✓, back ✓, 10-route thrash settles in 15ms, **zero console errors across the whole drive**. Two real finds: map cold-load spins forever with no error state when the engine is unreachable (BuildMapView.tsx:343); one unreproduced modal-backdrop → `#/hall` anomaly (needs deterministic repro before it counts as a bug). |
| 3 · Gosto de design | **B+** | pass finally done | The Universe empty state is genuinely Things/Arc-class ("An empty sky." — serif italic, warm paper, violet dots; dead-on the owner's register). Named deltas from the ruler: TopBar sprays internal telemetry (DRIFT/SRC-BIN-BND/FROZEN/GEN) across primary chrome — Linear would tuck it in a popover; internal hex IDs leak into human surfaces (card headers, panel INPUTS, tree kind-lens); weak tree typographic hierarchy; empty-state copy repeats itself and leaks agent verbs to humans. |
| 4 · Ergonomia / 5 stati | **B** | ↓ honest | The drive saw what suites can't: 4 of 5 stati honest and tested, BUT the map cold-load lacks its error state (the one 5-stati violation found live); the tree "kind" lens mounts **16,769 unvirtualized DOM nodes** (469,540px tall — works at 16.8k, zero headroom at 50k); "16,646 hidden by filters" shown with zero user filters (lens ≠ filter mislabel); **isolation bleed**: a fresh `--runtime-dir` owner still reads production `mission_local.json` (21 prod missions in a clean owner); mobile 375px is desktop crushed (only responsive code in the UI: 2 spans in TopBar). |
| 5 · Animações | **A−** | ↑ | Motion is a disciplined, TESTED contract: exactly one ambient animation + one panel slide; `prefers-reduced-motion` kill-switch asserted by `palette-render.test.tsx §4A.5`. Anti-gratuitous, matches the calm register. (Live media-emulation not exposed by the driver — graded on source + passing test, declared.) |
| 6 · Performance | **B−** (retrieval A · transfer C) | split | Retrieval excellent on the real graph: north **270ms** median, seek **46ms**, ingest 5.1s/16.8k nodes — far under the 2s SLO. Transfer is the finding: `/api/graph/snapshot` = **27 MB uncompressed** re-fetched per cold load (≈160 MB in one session), JS bundle 652 KB uncompressed, ~6 pollers with **no in-flight guard** (19 stacked requests under a stalled server). Biggest single lever in the repo: server-side compression. |
## Transversal finding — the installed binary is 1.4.0
`~/.m1nd/bin/m1nd-mcp --version` → `1.4.0 (b59a1c2-dirty)`; the UI's own drift badge shows
`SRC/BIN/BND 1.5.0/1.4.0/0.1.0` live. The 1.5.0 era is published but NOT yet installed on this
machine (consistent with PATHOS checkpoint 31's post-tag item zero — the governed GENESIS). The
live-drive findings were re-verified against 1.5.0 SOURCE where it mattered (no tree
virtualization and no mobile layout are both still true in source) — actionable, not stale.
## Fixes dispatched
**Inline, done this checkup (eixos 0-1 pass):**
- `1da73cfd` — README version claims trued to 1.5.0 (2 lines).
**Surgical batch — LANDED on this branch (5 of 6; gates: UI 656/0 (+10 new) · e2e 33/33 (+2 new) ·
cargo test/clippy/fmt clean):**
| Fix | Result |
|---|---|
| 1 · HTTP compression | `55b73b5f` — tower-http gzip layer (feature was already enabled, zero new crates; SSE excluded by predicate). **Snapshot 33.92 MB → 1.86 MB (−94.5%, 18.3×)**, negotiated-never-forced, 2 tests pin it. |
| 2 · Poller guards | `bbd3552d` — pure `pollGuard.ts` + `usePoller.ts` (in-flight guard, hidden-tab pause, AbortSignal); 4 hooks rewired; test proves 19 ticks under a hung server issue ZERO extra requests. Declared residue: 6 more pollers share the pattern (TopBar health incl. the literal observed symptom, App.tsx, InstancesPanel) — follow-up chip spawned, out of this batch's scope. |
| 3 · Map cold-load | `37ec6690` — ~10s slow-note + Retry + honest error branch (`MapStatusScreen.tsx`), mirroring the scan-wait; the 5-stati violation found live is closed, tests pin all three screens. |
| 4 · Mailbox isolation | **DEFERRED AS OWNER DECISION (correctly, not forced):** root-caused — the mission box is repo-side BY DESIGN (`<repo>/.m1nd/inbox.jsonl`, project-scoped per the M7b/MEDULLA §9.2 model), resolved at ≥5 coordinated read+write+bell+sweep sites. `--runtime-dir` forking the mailbox is a semantic/PRD change; a read-only half-fix would desync post-vs-read. Needs the owner to decide if isolated owners should fork the box. |
| 5 · Copy honesty | `2f902a17` — "hidden by **lens**" when no filter is active (tested rule), map empty-state deduped, agent verb moved from body copy to tooltip. |
| 6 · Hash canonicalize | `394d843e` — load-path already canonicalized; the REAL gap was popstate (backing into junk left it in the bar, proven RED with a probe) — fixed in the shell's popstate handler; e2e +2. |
**Batch specs registered for the NEXT cycle (design/scale — need owner taste or real design):**
- Virtualize the Living Tree flat lenses (16.7k DOM today; freezes at ~50k) — `LivingTree.tsx`.
- TopBar telemetry → status popover (the anti-HUD register) — `ManifestStatus.tsx`.
- Humanize IDs on human surfaces (resolve `sb_` inputs to names; hide hex in headers) — `BlockPanel.tsx`.
- Mobile breakpoint (single-pane + overlay detail; fit-to-viewport map) — `App.tsx` + views.
- Extract server.rs inline `mod tests` (6,161 lines) to a sibling — the highest-leverage monolith cut.
- i18n README sync (7 translations at 1.2.0) + a translation-refresh step in the release ritual.
## For the next bulletin to watch
1. Installed-binary drift (1.4.0 vs published 1.5.0) — resolves with the governed GENESIS.
2. The unreproduced modal→`#/hall` anomaly — needs a deterministic repro attempt.
3. i18n front-door drift (escalates to process gap if still stale at bulletin 4).
4. `M1ND-10-HANDOFF-20260719.md` dated-filename antipattern (accreting 07-20/07-23 content).
5. server.rs test-module ratio (43% and climbing with every dogfood fix).
6. `enclave_authority.rs` 2,089/2,500 watch line.
7. Windows source-edit Known gap (~22 red) — declared for 1.5.0, still open.