docs(workbench): reconcile living docs with shipped state (#754)
Bring the four living workbench docs up to date with what actually shipped, and document the TruncatedCell full-content reveal. - README: route count 14 -> 16; add Lived Life (Evidence) and CORE-Logos (Substrate) to the shipped-surfaces table; full Trace tab list; add the TruncatedCell reveal to cross-cutting; link the visual-evidence handoff; bump status date. - UI-UX-GUIDE: §12 now reflects the built read-only /logos reader vs the unbuilt Studio; §13 moves the cognitive-pipeline visualizer, field/ versor_condition reader, and identity-continuity items from "absent" to "shipped"; new §14 documents the truncated-cell reveal pattern + the <a>/<Link> non-nesting boundary; bump date. - ui-component-map: add TruncatedCell to shared data viewers. - design-system: add the Truncated Cell Reveal shared-component note. Docs only; no code change. Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
Shay
GitHub
parent
87d4b2fb9a
commit
7945bffc86
4 changed files with 80 additions and 19 deletions
|
|
@ -187,6 +187,15 @@ Defines:
|
|||
|
||||
---
|
||||
|
||||
## Visual Evidence / Handoff
|
||||
|
||||
- `../handoff/workbench-truncated-cell-visual-evidence-2026-06-14.md` — captured
|
||||
screenshots confirming the `TruncatedCell` full-content reveal (popover +
|
||||
copy + modal) across the proposal queue, the trace propagation edges, and the
|
||||
single-column selection rails.
|
||||
|
||||
---
|
||||
|
||||
# Core Principles
|
||||
|
||||
## Replay before persuasion
|
||||
|
|
@ -212,7 +221,7 @@ mutation capability.
|
|||
|
||||
---
|
||||
|
||||
# Current Status (2026-06-13)
|
||||
# Current Status (2026-06-14)
|
||||
|
||||
The Workbench is shipped and well past the W-026…W-031 planning era. The
|
||||
read-only local API + React UI are real; W-026 (read-only API) through W-031
|
||||
|
|
@ -220,9 +229,13 @@ read-only local API + React UI are real; W-026 (read-only API) through W-031
|
|||
mastery revamp (11 routes + the Replay Moment), and the Wave M worthiness arc.
|
||||
|
||||
**Wave M is complete** — Phase B (calibrated-learning surfaces), Phase C
|
||||
(cognition legibility), Phase D (guided tour + evidence bundles), and the B4
|
||||
leeway producer all merged. Phase E (robustness; continuous) and the parallel
|
||||
tracks (CORE-Logos Studio, the universal proposal envelope) remain.
|
||||
(cognition legibility, incl. the trace Field reader), Phase D (guided tour +
|
||||
evidence bundles), and the B4 leeway producer all merged. Since then the
|
||||
always-on heartbeat has added a continuous **Lived Life** surface and a
|
||||
read-only **CORE-Logos** reader (identity / lexicon / glosses / morphology /
|
||||
alignment / safety). Phase E (robustness; continuous) and the parallel tracks
|
||||
(the CORE-Logos *Studio* mutation/patch-forge path, the universal proposal
|
||||
envelope) remain.
|
||||
|
||||
Doctrine is unchanged: read-only first, allowlisted execution only
|
||||
(`/evals/run`, ratify, `/demos/{id}/run`), every surface a real backend reader
|
||||
|
|
@ -230,22 +243,23 @@ Doctrine is unchanged: read-only first, allowlisted execution only
|
|||
|
||||
## Shipped surfaces
|
||||
|
||||
14 registry-driven routes (`src/app/routes.ts`), grouped by section:
|
||||
16 registry-driven routes (`src/app/routes.ts`), grouped by section:
|
||||
|
||||
| Section | Routes |
|
||||
|---|---|
|
||||
| Converse | **Chat** |
|
||||
| Cognition | **Trace** (Pipeline / Field / Bundle / Surfaces / Grounding / Verdicts tabs), **Contemplation** (staged learning loop) |
|
||||
| Cognition | **Trace** (Pipeline / Field / Bundle / Surfaces / Grounding / Verdicts / Metadata / Raw tabs), **Contemplation** (staged learning loop) |
|
||||
| Determinism | **Tour** (guided determinism narrative), **Replay** (hash-to-hash), **Demos** (Demo Theater) |
|
||||
| Evidence | **Proposals** (+ HITL ratification), **Runs** (+ identity continuity), **Vault**, **Audit** |
|
||||
| Evidence | **Proposals** (+ HITL ratification), **Runs** (+ identity continuity), **Lived Life** (always-on heartbeat), **Vault**, **Audit** |
|
||||
| Discipline | **Evals** (wrong=0 ledger), **Calibration** (gold-tether arena, Wilson floor vs θ) |
|
||||
| Substrate | **Packs** |
|
||||
| Substrate | **Packs**, **CORE-Logos** (read-only pack reader) |
|
||||
| Settings | **Settings** (landing / density / inspector prefs) |
|
||||
|
||||
Cross-cutting: Evidence Address (URL = subject, `?inspect=`), Evidence Chain
|
||||
Rail, command palette + registry-driven keyboard help, per-turn pipeline /
|
||||
field / leeway / bundle evidence, doctrine gates (hexScan, schemaDrift,
|
||||
enumCoverage, route conformance, golden-file DAG layout).
|
||||
field / leeway / bundle evidence, full-content reveal for truncated table cells
|
||||
(`TruncatedCell` — hover/focus popover + copy + modal), doctrine gates (hexScan,
|
||||
schemaDrift, enumCoverage, route conformance, golden-file DAG layout).
|
||||
|
||||
---
|
||||
|
||||
|
|
|
|||
|
|
@ -1,7 +1,8 @@
|
|||
# CORE Workbench UI/UX Guide
|
||||
|
||||
Date: 2026-06-13
|
||||
Status: Wave M B3.5 guide
|
||||
Date: 2026-06-14
|
||||
Status: Wave M B3.5 guide (post-Wave-M reconciliation: Lived Life, CORE-Logos
|
||||
reader, trace Field reader, and the truncated-cell reveal)
|
||||
|
||||
## 1. What Workbench Is And Is Not
|
||||
|
||||
|
|
@ -179,17 +180,44 @@ non-zero wrong.
|
|||
Today, Packs exposes manifest/checksum/determinism metadata. It is the current
|
||||
Substrate neighborhood for language/runtime pack inspection.
|
||||
|
||||
The planned CORE-Logos Studio is not built yet. It should enter as read-only
|
||||
readers and proposal-only draft artifacts before any ratification-enabled
|
||||
handler family is admitted.
|
||||
A read-only **CORE-Logos** route (`/logos`) is now built: Overview, Identity,
|
||||
Lexicon, Glosses, Morphology, Alignment, and Safety tabs over CORE-Logos pack
|
||||
evidence. The fuller CORE-Logos *Studio* — proposal-only draft artifacts and a
|
||||
patch-forge / holonomy handler family — is not built; it must enter as
|
||||
proposal-only drafts before any ratification-enabled handler family is admitted.
|
||||
|
||||
## 13. Known Absences And Follow-Up Items
|
||||
|
||||
- Full Phase C cognitive pipeline visualizer is absent.
|
||||
- Field substrate / `versor_condition` reader is absent.
|
||||
- Identity continuity route is absent.
|
||||
- Full B4 leeway annotations are not admitted; B4a nullable
|
||||
`LeewayEvidence` read models exist first.
|
||||
- CORE-Logos Studio route is not built.
|
||||
- The CORE-Logos *Studio* (proposal-only draft + patch-forge / holonomy
|
||||
handlers) is not built; only the read-only `/logos` reader exists.
|
||||
- Universal proposal artifact envelope is designed, not implemented as a UI
|
||||
substrate.
|
||||
- Phase E (robustness; continuous) is ongoing.
|
||||
|
||||
Reconciled (previously listed as absent, now shipped):
|
||||
|
||||
- Cognitive pipeline visualizer — the Trace **Pipeline** tab renders the stage
|
||||
rail, propagation edges, and per-stage detail.
|
||||
- Field substrate / `versor_condition` reader — the Trace **Field** tab and the
|
||||
**Lived Life** surface read per-beat closure as evidence (never repaired).
|
||||
- Identity continuity — the **Lived Life** route plus Runs identity-continuity
|
||||
verdicts.
|
||||
|
||||
## 14. Table / Rail Cell Full-Content Reveal
|
||||
|
||||
Every cell that truncates a dense value (ids, digests, sources, paths, prompts,
|
||||
stage names) uses the shared `TruncatedCell` component. It keeps the compact
|
||||
display but attaches one hover/focus-revealed trigger that opens an accessible
|
||||
popover with 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.
|
||||
|
||||
Applies across the proposal queue, eval wrong=0 case ledger, CORE-Logos
|
||||
contents, proposal artifacts, trace propagation edges, and the single-column
|
||||
selection rails. Digests keep `DigestBadge` (already copy + full-value `title`).
|
||||
A row that is an `<a>`/`<Link>` (e.g. Runs `TurnRefRow`) keeps its anchor
|
||||
semantics and is reached by navigation rather than nesting an interactive
|
||||
trigger. See `../handoff/workbench-truncated-cell-visual-evidence-2026-06-14.md`
|
||||
for captured evidence.
|
||||
|
|
|
|||
|
|
@ -48,6 +48,18 @@ 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`
|
||||
|
|
|
|||
|
|
@ -267,6 +267,13 @@ Failures should be easier to inspect than successes.
|
|||
- `DigestValue`
|
||||
- `MetadataTable`
|
||||
- `Timestamp`
|
||||
- `TruncatedCell` — every truncated table/rail cell. Keeps the compact display
|
||||
but attaches one hover/focus-revealed trigger that opens an accessible popover
|
||||
with the full value (selectable) + copy, and "Open full view" → modal for long
|
||||
values. `stopPropagation` keeps the reveal independent of row selection. Used
|
||||
across proposal queue, eval case ledger, CORE-Logos contents, proposal
|
||||
artifacts, trace propagation edges, and the single-column selection rails.
|
||||
Digests keep `DigestBadge` (already copy + full-value title).
|
||||
|
||||
## UX Principle
|
||||
|
||||
|
|
|
|||
Loading…
Reference in a new issue