githubnext/chopinPublic

Let's compose rich plans together

[Design] Redesign research components

enhancementtriage/human-response
MA

Base branch: main Branch: maggie/redesign-research-components Depends on: None

## Goal Redesign the complete research request family so entry, progress, failure, cancellation, and ready states feel like one polished workflow.

## Context From Planning - Every research component in `/design-audit#authored-content` currently feels underdesigned and needs a dedicated pass. - Research requests are inline durable cards, not standalone channels. Their identity survives failure, cancellation, and retry. - This is a human-reviewed design task; lifecycle semantics are already established and must be preserved.

## Current Behavior The research composer and `SidecarCard`-based lifecycle cards expose the necessary data and actions but have weak hierarchy, inconsistent action placement, and little visual continuity between queued, searching, analyzing, writing, publishing, failed, cancelled, and ready states.

## Desired Behavior Create a cohesive research composer and lifecycle-card family with clear progress, source/report metadata, calm loading states, legible recovery actions, and strong continuity from request to child document.

## Acceptance Criteria - [ ] The audit covers composer empty/drafted/submitting/blocked/error states and every durable request stage: queued, searching, analyzing, writing, publishing, failed, cancelled, and ready. - [ ] State changes retain a stable card identity and do not visually imply a new request on retry. - [ ] Cancel, retry, remove, and open-child actions have consistent placement and hierarchy appropriate to each stage. - [ ] Ready state clearly presents title, summary, source count, Planner provenance, and navigation to the ordinary child document. - [ ] Loading/progress treatment respects reduced motion and does not rely on animation alone. - [ ] Existing persistence-before-publication, observational-read, retry, cancellation, and child-publication behavior remains unchanged. - [ ] Maggie approves the audit specimens before production migration.

## Verification Commands - `bun run types` - `bun run ci` - `bun test packages/editor` - `bun run e2e`

## Primary Surfaces - `/design-audit#authored-content` - Research composer and lifecycle cards in `packages/editor` - Parent document research request and child-document navigation

## Expected PR Checks - Repo required checks

## Report Requirements - Complete lifecycle state matrix - Before/after screenshots at normal and narrow widths - Reduced-motion and keyboard evidence - Confirmation that request identity and publication semantics are unchanged

## Implementation Notes - A pending request remains an inline card with no URL, sidebar row, Conversation, or Decisions. - Failure, cancellation, and retry preserve request identity; reads must not restart terminal work. - Publication remains idempotent and persistent before the ready card or navigation row appears.

## Stop Conditions - The design implies a new product workflow such as standalone research workspaces or grandchildren. - A visual change requires altering durable lifecycle or publication ordering.

  1. lavaman131referenced this in [Design] Research and references with assistant-ui Elements #310last month on GitHub

  2. lavaman131referenced this in [Design] Rebuild the workflow run card with assistant-ui Elements #307last month on GitHub

  3. lavaman131referenced this in [Design] Replace the composer @ mention picker with assistant-ui mentions #308last month on GitHub

  4. lavaman131referenced this in [Design] Conversation controls with assistant-ui Elements: message queue, stopped run, error state #309last month on GitHub

  5. lavaman131referenced this in [Design] Decisions display with assistant-ui Elements (option list, question flow) #311last month on GitHub

  6. github-actions[bot]botadded label enhancementlast month on GitHub

  7. github-actions[bot]botadded label triage/human-responselast month on GitHub