Skip to content

v0.9.0: finish underwater receipt settling and phase-aware ambient motion #4357

Description

@Hmbown

Problem

The underwater TUI has a coherent still-state contract, but three finishing behaviors remain: receipt settling, phase-aware depth, and a one-shot fish response to active work. These must not reintroduce motion while waiting for input, reviewing an approval, or using reduced motion.

Expected behavior

  • Completed work receipts settle into history with a short, deterministic cascade rather than popping into place.
  • Ombre/depth treatment reflects the current phase without reducing text contrast or changing layout geometry.
  • Fish perform a single flee response when active work begins, then return to ambient behavior without looping.
  • Waiting, approval, stopped, and reduced-motion states remain still.
  • Resize and narrow-terminal behavior do not jitter or shift ownership of interactive rows.

Likely files

  • crates/tui/src/tui/ocean.rs
  • crates/tui/src/tui/underwater.rs
  • crates/tui/src/tui/motion/
  • crates/tui/src/tui/history.rs
  • docs/MOTION_CONTRACT.md

Acceptance criteria

  • Each behavior is driven by explicit phase transitions and deterministic time inputs.
  • No continuous animation occurs during waiting, approval, stopped, or reduced-motion states.
  • Receipt settling preserves ordering, deduplication, and counts.
  • 80x24 and 100x32 terminal captures show no layout jitter or contrast regression.
  • Unit/snapshot coverage exercises normal and reduced-motion paths.

Metadata

Metadata

Assignees

No one assigned

    Labels

    agent-readyBody is self-sufficient per docs/AGENT_RUNNER.md; a remote agent may claim itbugSomething isn't workingdocumentationImprovements or additions to documentationenhancementNew feature or requestreliabilityReliability, flaky behavior, retries, fallbacks, and robustnesstuiTerminal UI behavior, rendering, or interactionuxUser experience, interaction, or presentation polishv0.9.0Targeting v0.9.0

    Projects

    Status
    Done

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions