chore: Refactor CLI and Governance Anchors (#926 )

* docs: consolidate governance anchors and clean up test registries

* refactor(cli): decompose cli into dedicated modules

* test: fix broken test baselines and formatting

* docs: add domain boundary READMEs for governance anchors

* test: update baseline for determination lane

* test: fix capability_pass expectation

* test: fix CORE_SHOWCASE_SKIP_BUDGET enforcement

* chore: cleanup CLI extraction and unreachable code

2026-07-03 12:34:56 -07:00

2.9 KiB

Raw Permalink Blame History

Workbench Design System v1

This document records the Branch 1 substrate for ADR-0162, cross-referenced with ADR-0160 and ADR-0161.

The implementation lives in workbench-ui/. The preview page is /preview:

cd workbench-ui && pnpm install && pnpm preview

Branch 1 is intentionally static and read-only. It adds no backend, no API client, no route shell beyond /preview, and no runtime mutation surface.

Token Substrate

Tokens are defined in workbench-ui/src/design/tokens/tokens.css and mirrored to typed TypeScript by workbench-ui/scripts/generate-tokens.ts. The build prehook regenerates tokens.ts; the token test fails if CSS and TypeScript diverge.

The theme is dark-only. Fonts are self-hosted from workbench-ui/public/fonts/ and referenced through local @font-face rules only.

Badge Tables

Badge components live under workbench-ui/src/design/components/badges/. Each component accepts a typed enum value, never an arbitrary string.

Badge	Values	Source
`EpistemicStateBadge`	15	`core/epistemic_state.py`
`NormativeClearanceBadge`	4	`core/epistemic_state.py`
`ReviewStateBadge`	4	`teaching/proposals.py`
`GroundingSourceBadge`	6	ADR-0162 Branch 1 contract
`TraceHashBadge`	copyable digest	ADR-0153 / ADR-0160

scripts/dump-enums.py performs a read-only AST walk over the Python enum sources. pnpm test:enum-coverage regenerates workbench-ui/enum-snapshot.json and asserts exact UI coverage so engine enum drift fails loudly at build/test time.

JSON Viewer

StableJsonViewer preserves raw source spans for strings and numbers, renders object keys in deterministic lexicographic order, copies JSON Pointer paths, renders a source-byte SHA-256 badge, supports side-by-side leaf diffs, and refuses inline rendering above 16 MiB.

Truncated Cell Reveal

TruncatedCell (workbench-ui/src/design/components/TruncatedCell/) is the shared affordance for any table or rail cell that truncates a dense value (post Branch-1; it composes the Radix popover/dialog primitives the later waves added). The compact display is kept, with one hover/focus-revealed trigger that opens an accessible popover showing the full value (selectable) plus one-click copy; long/multiline values also offer "Open full view" into a modal. The trigger calls stopPropagation, so revealing a value never selects the surrounding row. Digests keep DigestBadge, which already copies the full value and shows it in title.

Motion And Keyboard

All motion uses tokenized durations/easing. prefers-reduced-motion: reduce collapses tokenized durations to instant.

The preview page installs the Branch 1 keyboard baseline:

Cmd+K / Ctrl+K opens the stub command palette.
Esc closes overlays.
Interactive primitives use --color-focus-ring.
Preview tab order follows DOM order.

2.9 KiB Raw Permalink Blame History