Files
RuView/dashboard/src/components/nv-app-store.ts
ruv 39ec05edcb feat(dashboard): nvsim Vite+Lit dashboard with WASM transport + App Store [ADR-092]
End-to-end implementation of the operator dashboard for the nvsim
NV-diamond magnetometer simulator. Vite 5 + TypeScript strict + Lit 3,
~93 KB gzipped JS budget, runs the *real* nvsim Rust crate compiled to
wasm32-unknown-unknown inside a dedicated Web Worker.

Validated end-to-end with `npx agent-browser`:
- WASM module boots, build version + magic 0xC51A_6E70 reported
- Reference witness verifies byte-identical to Proof::EXPECTED_WITNESS_HEX
  cc8de9b01b0ff5bd97a6c17848a3f156c174ea7589d0888164a441584ec593b4
- Pipeline runs at ~1.88 kHz on x86_64 dev hardware (4500x over Cortex-A53)
- Zero browser console errors; only Lit dev-mode warning (expected)

## nvsim crate (additive)
- New `wasm` feature flag with wasm-bindgen 0.2 / serde-wasm-bindgen 0.6
- src/wasm.rs: WasmPipeline wrapper + referenceSceneJson +
  expectedReferenceWitnessHex + referenceWitness + hexWitness exports
- crate-type = ["cdylib", "rlib"] so native + wasm both build
- rand = { default-features = false } drops getrandom OS-entropy path,
  preserving the crate's WASM-ready posture
- Native: 50/50 tests still pass, witness unchanged

## dashboard/ (new package)
- Vite 5 + TypeScript strict, Lit 3 elements, signals-based store
- 12 Lit components mirroring the mockup zones (rail, topbar, sidebar,
  scene SVG with draggable sources + NV crystal, inspector tabs
  Signal/Frame/Witness, console with REPL + filter tabs, settings
  drawer, modals, ⌘K command palette, debug HUD, toast, app-store)
- IndexedDB persistence (theme, density, motion, app activations)
- WasmClient → Web Worker → wasm-pack-built nvsim WASM module
- NvsimClient TS interface — same shape covers future WsClient transport
- MagFrame parser (60-byte LE layout matching nvsim::frame)

## App Store (ADR-092 §14a — added during impl)
- Catalog of all 65 wifi-densepose-wasm-edge modules + nvsim
- 13 categories with event-ID-range labels
- Per-app metadata: id/name/category/crate/summary/events/budget/
  status/adr/tags
- Fuzzy search, category + status filters, IndexedDB-backed activation
- ADR-092 §14a documents the registry contract and per-app schema

## Build pipeline
- wasm-pack build crates/nvsim --target web outputs to
  dashboard/public/nvsim-pkg/ (60 KB pkg, 162 KB unoptimized .wasm)
- npm run build → 93 KB gzip JS, well under 300 KB budget
- ts.config strict, npx tsc --noEmit clean
- Vite worker correctly loads WASM via dynamic import resolving
  against worker origin

## E2E validation
- agent-browser open → 4-zone grid renders correctly in dark theme
- Run button → live B-vector trace, |B| readout updates, FPS counter
- App Store → all 66 apps listed with toggles, fuzzy search filters
  to "Ghost hunter" on "ghost" query
- Witness verify → green check, console logs "determinism gate ✓"
- Console errors: zero (only expected Lit dev-mode warning)

Co-Authored-By: claude-flow <ruv@ruv.net>
2026-04-26 19:22:04 -04:00

284 lines
10 KiB
TypeScript

/* App Store — catalog of every WASM edge module + simulator app.
*
* Mirrors `wifi-densepose-wasm-edge`'s 60+ hot-loadable algorithms and
* the `nvsim` simulator. Each card is filterable by category, fuzzy
* name search, and maturity (available / beta / research). A toggle on
* each card flips activation in the live session — that drives the
* dashboard's event log when running. WS transport (future) pushes the
* activation set to the connected ESP32 mesh.
*
* ADR-092 §18.
*/
import { LitElement, html, css } from 'lit';
import { customElement, state } from 'lit/decorators.js';
import { signal, effect } from '@preact/signals-core';
import {
APPS, CATEGORIES, defaultActivations, fuzzyMatch,
type AppCategory, type AppManifest, type AppActivation,
} from '../store/apps';
import { kvGet, kvSet } from '../store/persistence';
import { pushLog } from '../store/appStore';
const activations = signal<AppActivation[]>(defaultActivations());
const query = signal<string>('');
const activeCat = signal<AppCategory | 'all'>('all');
const statusFilter = signal<'all' | 'available' | 'beta' | 'research'>('all');
(async () => {
const saved = await kvGet<AppActivation[]>('app-activations');
if (saved) activations.value = saved;
})();
effect(() => {
// Persist activations on change (post-load).
const v = activations.value;
if (v.length > 0) void kvSet('app-activations', v);
});
@customElement('nv-app-store')
export class NvAppStore extends LitElement {
@state() private renderTick = 0;
static styles = css`
:host {
display: block;
height: 100%;
overflow-y: auto;
background: radial-gradient(ellipse at 50% 30%, var(--bg-2) 0%, var(--bg-0) 70%);
padding: 24px;
}
.head {
display: flex; align-items: center; gap: 16px;
margin-bottom: 18px;
flex-wrap: wrap;
}
.ttl {
font-size: 22px; font-weight: 700; letter-spacing: -0.02em;
color: var(--ink);
flex: 1; min-width: 200px;
}
.ttl small {
font-size: 12.5px; font-weight: 400;
color: var(--ink-3); margin-left: 8px;
}
.search {
width: 320px; max-width: 100%;
padding: 8px 12px;
background: var(--bg-2);
border: 1px solid var(--line);
border-radius: 8px;
font-family: var(--mono);
font-size: 12.5px;
color: var(--ink); outline: none;
}
.search:focus { border-color: var(--accent); }
.filters {
display: flex; flex-wrap: wrap; gap: 6px;
margin-bottom: 18px;
}
.chip {
padding: 4px 10px;
background: var(--bg-2);
border: 1px solid var(--line);
border-radius: 999px;
font-size: 11.5px; color: var(--ink-3);
cursor: pointer;
font-family: var(--mono);
display: inline-flex; align-items: center; gap: 4px;
}
.chip:hover { color: var(--ink); border-color: var(--line-2); }
.chip.on { background: var(--bg-3); border-color: var(--accent); color: var(--ink); }
.chip .swatch {
width: 7px; height: 7px; border-radius: 50%;
}
.chip .count { color: var(--ink-3); font-size: 10px; }
.grid {
display: grid;
grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
gap: 12px;
}
.card {
background: var(--bg-2);
border: 1px solid var(--line);
border-radius: var(--radius);
padding: 12px 14px;
display: flex; flex-direction: column; gap: 6px;
transition: border-color 0.15s, transform 0.15s;
position: relative;
}
.card:hover { border-color: var(--line-2); transform: translateY(-1px); }
.card.active {
border-color: oklch(0.78 0.14 145 / 0.7);
background: linear-gradient(180deg, var(--bg-2) 0%, oklch(0.78 0.14 145 / 0.04) 100%);
}
.card-h {
display: flex; align-items: flex-start; gap: 8px;
margin-bottom: 2px;
}
.card-h .name {
font-size: 13.5px; font-weight: 600; color: var(--ink);
flex: 1; line-height: 1.3;
}
.card-h .swatch {
width: 10px; height: 10px; border-radius: 50%;
flex-shrink: 0; margin-top: 4px;
}
.summary {
font-size: 12px; color: var(--ink-2); line-height: 1.45;
flex: 1;
}
.meta {
display: flex; flex-wrap: wrap; gap: 4px; margin-top: 6px;
font-family: var(--mono); font-size: 10px;
}
.badge {
padding: 1px 6px; border-radius: 4px;
background: var(--bg-3); color: var(--ink-3);
border: 1px solid var(--line);
}
.badge.cat { color: var(--accent); border-color: oklch(0.78 0.14 70 / 0.3); }
.badge.status-available { color: var(--ok); border-color: oklch(0.78 0.14 145 / 0.4); }
.badge.status-beta { color: var(--warn); border-color: oklch(0.7 0.18 35 / 0.4); }
.badge.status-research { color: var(--accent-3); border-color: oklch(0.72 0.18 330 / 0.4); }
.badge.budget { color: var(--accent-2); border-color: oklch(0.78 0.12 195 / 0.3); }
.card-foot {
display: flex; align-items: center; gap: 8px;
padding-top: 8px; margin-top: 4px;
border-top: 1px solid var(--line);
font-size: 11px; color: var(--ink-3);
}
.toggle {
position: relative;
width: 32px; height: 18px;
background: var(--bg-3); border: 1px solid var(--line-2);
border-radius: 999px; cursor: pointer;
transition: background 0.15s;
flex-shrink: 0;
}
.toggle::after {
content: ''; position: absolute;
top: 1px; left: 1px;
width: 12px; height: 12px;
background: var(--ink-3); border-radius: 50%;
transition: transform 0.15s, background 0.15s;
}
.toggle.on { background: var(--accent); border-color: var(--accent); }
.toggle.on::after { background: #1a0f00; transform: translateX(14px); }
.events {
font-family: var(--mono); font-size: 10px; color: var(--ink-3);
flex: 1;
}
.empty {
padding: 40px;
text-align: center; color: var(--ink-3);
font-size: 13px;
}
`;
override connectedCallback(): void {
super.connectedCallback();
effect(() => { activations.value; query.value; activeCat.value; statusFilter.value; this.renderTick++; });
}
private isActive(id: string): boolean {
return activations.value.find((a) => a.id === id)?.active === true;
}
private toggle(app: AppManifest): void {
const next = activations.value.map((a) => a.id === app.id ? { ...a, active: !a.active, lastActivatedAt: Date.now() } : a);
activations.value = next;
pushLog(this.isActive(app.id) ? 'ok' : 'info', `app <span class="k">${app.id}</span> deactivated`);
}
private filtered(): AppManifest[] {
let list = APPS;
if (activeCat.value !== 'all') list = list.filter((a) => a.category === activeCat.value);
if (statusFilter.value !== 'all') list = list.filter((a) => a.status === statusFilter.value);
if (query.value.trim()) {
list = list
.map((a) => ({ a, s: fuzzyMatch(query.value, a) }))
.filter((x) => x.s > 0)
.sort((a, b) => b.s - a.s)
.map((x) => x.a);
}
return list;
}
private categoryCounts(): Record<string, number> {
const counts: Record<string, number> = { all: APPS.length };
for (const k of Object.keys(CATEGORIES)) counts[k] = 0;
for (const a of APPS) counts[a.category] = (counts[a.category] ?? 0) + 1;
return counts;
}
override render() {
const list = this.filtered();
const counts = this.categoryCounts();
const activeCount = activations.value.filter((a) => a.active).length;
return html`
<div class="head">
<div class="ttl">
App Store
<small>${APPS.length} edge apps · ${activeCount} active</small>
</div>
<input class="search" id="app-search" placeholder="Search by name, tag, or category…"
.value=${query.value}
@input=${(e: Event) => { query.value = (e.target as HTMLInputElement).value; }} />
</div>
<div class="filters">
<span class="chip ${activeCat.value === 'all' ? 'on' : ''}"
@click=${() => activeCat.value = 'all'}>
All<span class="count">${counts.all}</span>
</span>
${(Object.keys(CATEGORIES) as AppCategory[]).map((k) => html`
<span class="chip ${activeCat.value === k ? 'on' : ''}"
@click=${() => activeCat.value = k}>
<span class="swatch" style=${`background:${CATEGORIES[k].color}`}></span>
${CATEGORIES[k].label}
<span class="count">${counts[k] ?? 0}</span>
</span>
`)}
<span style="flex:1; min-width:8px"></span>
<span class="chip ${statusFilter.value === 'all' ? 'on' : ''}" @click=${() => statusFilter.value = 'all'}>any</span>
<span class="chip ${statusFilter.value === 'available' ? 'on' : ''}" @click=${() => statusFilter.value = 'available'}>available</span>
<span class="chip ${statusFilter.value === 'beta' ? 'on' : ''}" @click=${() => statusFilter.value = 'beta'}>beta</span>
<span class="chip ${statusFilter.value === 'research' ? 'on' : ''}" @click=${() => statusFilter.value = 'research'}>research</span>
</div>
${list.length === 0
? html`<div class="empty">No apps match the current filters.</div>`
: html`<div class="grid">${list.map((app) => this.card(app))}</div>`}
`;
}
private card(app: AppManifest) {
const active = this.isActive(app.id);
const cat = CATEGORIES[app.category];
return html`
<div class="card ${active ? 'active' : ''}" data-app-id=${app.id}>
<div class="card-h">
<span class="swatch" style=${`background:${cat.color}`}></span>
<span class="name">${app.name}</span>
</div>
<div class="summary">${app.summary}</div>
<div class="meta">
<span class="badge cat">${cat.label}</span>
<span class="badge status-${app.status}">${app.status}</span>
${app.budget ? html`<span class="badge budget">budget ${app.budget}</span>` : ''}
${app.adr ? html`<span class="badge">${app.adr}</span>` : ''}
${app.events?.length ? html`<span class="badge">events ${app.events.join('·')}</span>` : ''}
</div>
<div class="card-foot">
<span class="events">${app.crate}</span>
<span class="toggle ${active ? 'on' : ''}" role="switch"
aria-checked=${active}
data-app-toggle=${app.id}
@click=${() => this.toggle(app)}></span>
</div>
</div>
`;
}
}