v0.9: redesign the Workbench UI/UX

[jameswei]

Summary

• redesign the local Workbench around Documents, Corpora, preparation rounds, and learner-focused lifecycle stages
• add coherent evidence and artifact inspection, readable comparisons, canonical rule guidance, and EN/zh-CN UI
• preserve explicit decisions, immutable records, trusted-local behavior, and the existing CLI lifecycle
• align learning material, public documentation, roadmap, release notes, and version metadata at 0.9.0

Scope

This is the single atomic v0.9 UI/UX redesign PR. It adds no compatibility layer, persisted schema, public API, hosted service, generalized graph or status model, or new diagnosis/refinement behavior.

Verification

• 379 unit tests passed under Node.js 24.18.1
• 17 model-free integration tests passed
• post-fix focused UI tests: 9 passed
• post-fix affected Workbench integration tests: 14 passed
• Workbench asset and static-site validators passed
• compile, lock/version, JavaScript syntax, and diff checks passed
• fresh final integration review: PASS with zero findings

[Copilot]

Pull request overview

This PR delivers the v0.9.0 Workbench UI/UX redesign, shifting the local Workbench from a record-dashboard layout to a document- and corpus-centered learning workflow with staged navigation, stronger offline/same-origin guarantees, and bilingual (EN/zh-CN) UI—while preserving the existing trusted-local boundary and immutable record lifecycle.

Changes:

• Introduces a new Workbench projection/payload that exposes package version, canonical rule/reference data, and document/corpus groupings with preparation rounds.
• Updates the Workbench server and asset validator to support the redesigned UI contracts, including duplicate-source “reactivation” behavior.
• Aligns tests and documentation (learning materials, site, roadmap, release notes, version metadata) to v0.9.0 behavior and terminology.

Reviewed changes

Copilot reviewed 30 out of 33 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
uv.lock	Bumps locked package version to 0.9.0.
tools/validate_workbench_assets.py	Updates offline/same-origin and accessibility validation contracts for the new shell/modals and fetch wrapper expectations.
tests/unit/test_workbench_ui_contract.py	Replaces prior UI contract suite with new shell/stage/reader/locale/refresh/rehydration contract coverage.
tests/unit/test_workbench_relationship_resolution.py	Adjusts relationship/detail assertions to match new projection/detail computation paths.
tests/unit/test_workbench_record_detail_contracts.py	Updates record detail contract expectations for refined CORPUS artifact exposure and split scenarios.
tests/unit/test_workbench_projection.py	Validates new projection keys (package_version/reference/documents/corpora), ordering, and stricter integrity constraints.
tests/unit/test_workbench_lifecycle.py	Updates lifecycle tests for redesigned state handling and actionability rules.
tests/unit/test_workbench_lifecycle_http.py	Updates guided route expectations for renamed/retargeted guided IDs.
tests/unit/test_workbench_actionable_workspace.py	Updates actionable-subject assertions to match new workspace acceptance rules.
tests/unit/test_observation_jobs_http.py	Adds/updates HTTP coverage for duplicate guided/upload reactivation behavior and lease ordering.
tests/integration/test_workbench_lifecycle_journey.py	Splits lifecycle journey into explicit approval vs rejection flows using shared helper.
tests/integration/test_workbench_integration.py	Updates integration expectations for new payload structure and stricter snapshot preservation on failed refresh.
src/tiny_corpus_workbench/workbench_server.py	Adds reactivation handling for duplicate source identity submissions; updates upload handling to check for reactivation before storing inputs.
src/tiny_corpus_workbench/workbench_records.py	Expands allowed artifact roles/media types for corpus report assets and changes CORPUS listing behavior.
src/tiny_corpus_workbench/workbench_projection.py	Adds v0.9 projection schema (package version, canonical rule reference, documents/corpora presentation, preparation rounds) and enforces new integrity rules.
src/tiny_corpus_workbench/workbench_assets/workbench.css	Replaces prior styling with the redesigned stable shell, responsive layout, readers/modals/toast styling, and updated contracts.
src/tiny_corpus_workbench/workbench_assets/index.html	Replaces prior record-dashboard DOM with the new shell (Documents/Corpora nav, stage stepper, inspector tabs, modals, toast, canonical footer link).
src/tiny_corpus_workbench/application/workbench.py	Adjusts candidate validation to fit the new projection integrity rules (validate roots without requiring standalone projections).
src/tiny_corpus_workbench/init.py	Bumps package version constant to 0.9.0.
site/index.html	Updates public site copy to describe the redesigned Workbench experience (Documents/Corpora, stages, bilingual UI).
README.md	Updates product description, usage narrative, and version milestone framing to v0.9 redesign.
pyproject.toml	Bumps project version to 0.9.0.
learning/README.md	Updates learning hub step description to reflect stages/rounds through revision.
learning/observe-extraction.md	Updates Workbench entry instructions and stage/inspector guidance.
learning/diagnose-with-evidence.md	Updates Workbench equivalence wording and NO_FINDINGS guidance.
learning/control-document-revision.md	Updates Workbench decision UX wording (choose + record decision).
learning/complete-document-lifecycle.md	Rewrites the guided exercise for the redesigned shell/stages/readers/localization/recovery semantics.
docs/roadmap.md	Adds v0.9 milestone and refines v0.8 scope wording to match the redesign plan.
docs/releases/v0.9.0.md	Adds v0.9.0 release note describing scope, boundaries, and key UX changes.
docs/plans/v0.9-workbench-ui-ux-redesign.md	Adds the detailed v0.9 plan/acceptance criteria and verification guidance.
docs/local-visual-workbench.md	Updates the Workbench guide to match the redesigned UI structure, contracts, and recovery semantics.
CURRENT.md	Updates handoff snapshot to v0.9.0 capabilities and invariants.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.