Files
redis-gui-foundation/plans/2026-03-31-hac-30-inspector-readability.md
Senior Frontend Engineer b6cbe5a47e docs(project): refresh baseline verification artifacts
Check in the PM product requirements, refreshed QA acceptance evidence, shared execution split plans, and current-phase status notes so the repo matches the current delivery baseline.

Co-Authored-By: Paperclip <noreply@paperclip.ing>
2026-03-31 10:15:39 +00:00

47 lines
1.7 KiB
Markdown

# HAC-30 Inspector Readability
Date: 2026-03-31
Owner: Senior Frontend Engineer
Issue: HAC-30
## Goal
Improve inspector readability and operator understanding without changing backend contracts or pulling next-phase scope into the current desktop-v1 slice.
## Scope
- clarify current inspector state for live, demo, loading, and missing-key paths
- make value-surface semantics explicit for string and structured types
- keep next-step operator guidance visible near the inspector surface
- expose key facts in a stable summary card instead of relying on scattered badges and support copy
- add focused frontend tests for the readability helper
## Non-Goals
- no Add Key expansion
- no delete execution contract
- no non-string edit support
- no visual-theme refresh
- no bilingual UI pass
## Delivery Shape
1. Add a shared inspector-readability helper that maps selected key, live record, runtime mode, and edit capability into:
- inspect status
- value-surface title and description
- next-step operator guidance
- key facts
2. Use that helper in `apps/desktop/src/App.tsx` to:
- show an explicit inspector status badge
- add a semantic summary block above the value surface
- replace the previous generic support note with summary and facts cards
3. Revalidate frontend tests and production build.
## Acceptance
- inspector makes live string, structured read-only, demo fallback, loading, and missing-key paths visibly distinct
- operators can identify scope, type, TTL state, value shape, and write path without inferring them from raw payload text
- no backend contract change is required
- `pnpm --filter @redis-gui/desktop test` passes
- `pnpm run desktop:build` passes