History

Shay 0484b1708f feat(workbench-ui): add Apple UMA report card route		2026-06-24 14:54:52 -07:00
..
e2e	test(workbench): playwright smoke lane (ADR-0162 acceptance 5-7)	2026-06-12 12:05:28 -07:00
preview
public/fonts
scripts
src	feat(workbench-ui): add Apple UMA report card route	2026-06-24 14:54:52 -07:00
.gitignore
api-schema-snapshot.json	feat(workbench): Wave M Phase C legibility — pipeline record, contemplation, identity continuity	2026-06-13 15:44:31 -07:00
enum-snapshot.json	feat(workbench): CORE-Logos Studio LG-2 — /logos route shell + Overview/Identity/Safety	2026-06-14 12:12:47 -07:00
index.html
package.json	feat(workbench): design mastery pass — chain rail, typography, doctrine-as-tests (Wave R R1)	2026-06-12 13:18:44 -07:00
playwright.config.ts	test(workbench): playwright smoke lane (ADR-0162 acceptance 5-7)	2026-06-12 12:05:28 -07:00
pnpm-lock.yaml	feat(workbench): interaction substrate — list nav, virtualization, panel chrome, inspector resize, palette verbs (Wave R R0d)	2026-06-12 12:48:02 -07:00
postcss.config.js
README.md	docs(workbench): align UI catch-up plan and route docs (#890 )	2026-06-23 10:02:17 -07:00
schema-snapshot.json	feat(workbench): Lived Life surface — the always-on heartbeat made felt (read-only, persist-first)	2026-06-14 16:45:03 -07:00
tailwind.config.ts
tsconfig.json	feat(W-027): Workbench frontend shell — five-region grid + ten empty routes + live StatusFooter (ADR-0160 / ADR-0162) (#299 )	2026-05-26 12:09:12 -07:00
tsconfig.node.json
vite.config.ts	fix(workbench): exclude e2e/ from vitest collection	2026-06-12 12:07:57 -07:00

README.md

CORE Workbench UI

React/Vite/TypeScript frontend for CORE Workbench — a local operator/auditor UI over the deterministic engine. 16 registry-driven routes (src/app/routes.ts): chat; trace (per-turn pipeline / field-invariant / leeway / evidence-bundle tabs); contemplation; guided determinism tour; replay (hash-to-hash); demos; proposals + HITL ratification; evals (wrong=0 ledger); calibration (gold-tether arena); runs; lived-life; vault; packs; CORE-Logos; audit; and settings. Read-only by default, with allowlisted execution only.

Local development

# Terminal 1 — start the API (W-026)
uv run core workbench api

# Terminal 2 — start the frontend
cd workbench-ui
pnpm install
pnpm dev         # http://127.0.0.1:5173

Custom API URL

VITE_WORKBENCH_API_URL=http://127.0.0.1:9000 pnpm dev

Design system baseline

pnpm preview   # Serves dist/ on http://127.0.0.1:4173
# Navigate to /preview for the Branch 1 design-system baseline

Tests

pnpm test                # Vitest unit + component tests
pnpm test:enum-coverage  # Badge enum coverage (requires uv)
pnpm build               # TypeScript + Vite production build

Schema drift detection

The TypeScript types in src/types/api.ts mirror workbench/schemas.py. To check for drift after Python schema changes:

# From repo root
uv run python scripts/dump-api-schemas.py
# Then run: pnpm test (api.test.ts catches field-level drift)

Architecture

src/app/ — Shell, TopBar, LeftNav, StatusFooter, ApiErrorBoundary, and the route surfaces in src/app/<route>/. src/app/routes.ts is the single route registry (feeds App, LeftNav, command palette, shortcuts, and conformance).
src/api/ — apiFetch client, TanStack Query hooks.
src/types/ — TypeScript mirrors of Python schemas (src/types/api.ts).
src/routes/ — the Chat route entry.
src/design/ — design-system substrate (tokens, primitives, doctrine gates).

Catch-up doctrine

The Workbench is an evidence surface, not a mutation console. New UI work must only render backend-provided read models, committed artifacts, or existing allowlisted execution paths. Proposal-first construction evidence, residual-gated practice traces, generalization audit reports, and CORE-Logos pack evidence must remain diagnostic/read-only unless a later ADR admits a narrow handler path.

ADR cross-references

ADR-0160 — Workbench v1 architecture
ADR-0162 — Design substrate (Branch 1)
ADR-0156, ADR-0157, ADR-0158 — Engine-state checkpoint and reboot audit trail