History

Shay 2b13feab24 feat(workbench): Runs route — session evidence with trace cross-links (Wave R2) Replaces the RunsRoutePlaceholder with the real triad route over the R2-B /runs read substrate (#712). - TS mirrors RunSource/RunSummary/RunTurnRef/RunDetail; all three classes removed from NOT_YET_MIRRORED (drift gate now enforces them) - list pane: VirtualizedList + useListNavigation (j/k) + SearchInput; rows show source, session_id, turn_count, relative timestamp, a checkpoint badge (present + revision vs 'no checkpoint'), and any evidence_gap rendered honestly in-row (never hidden) - detail pane: Panel + TabBar (Turns / Manifest / Raw); every turn row is an anchor to /trace/<turn_id> (backend-provided trace_path) with the trace_hash as a DigestBadge — the cross-link is the point of this route; turn list pages via turn_limit ('Load more turns') - selection publishes the run subject (R2-S) and records /runs/<sessionId> in the URL (replace), pushRecentItem on visit - Runs row added to routeConformance MOUNT_ROUTES (loading 'Loading runs...', error 'No runs mutation occurred.', empty 'No runs recorded yet.' + core chat) - RunsRoute.test.tsx: list evidence, in-row gap, replace-mode URL select, trace cross-link hrefs, manifest tab, j/k keyboard spine Token-only styling (hexScan green); full vitest 339 green.		2026-06-12 20:58:55 -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): Runs route — session evidence with trace cross-links (Wave R2)	2026-06-12 20:58:55 -07:00
.gitignore
api-schema-snapshot.json	feat: implement CORE Workbench W3 Ratification Corridor	2026-06-03 20:13:36 -07:00
enum-snapshot.json
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
schema-snapshot.json	feat(workbench): sealed single-turn replay backend — GET /replay/{turn_id} (Wave R3)	2026-06-12 17:15:39 -07:00
tailwind.config.ts
tsconfig.json
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 UI for inspecting engine state, proposals, evals, and audit trails.

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)

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
src/api/ — apiFetch client, TanStack Query hooks
src/types/ — TypeScript mirrors of Python schemas
src/routes/ — Route placeholder components
src/design/ — Branch 1 design-system substrate (DO NOT MODIFY except EmptyState and CommandPalette)

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