Thisper/THISPER_IMPLEMENTATION_PLAN.md

Thisper Implementation Plan

This plan reflects the current repo state and the remaining work needed to close desktop Phase 2 before speech begins.

Completed Baseline

• Desktop text-to-text MVP is complete.
• The provider boundary exists and Gemini is integrated.
• Secure credential storage is implemented.
• Global shortcut and clipboard rewrite are implemented.
• Streaming rewrite is implemented.
• Tray and background lifecycle are implemented.
• Runtime observability is implemented locally in-memory.

Remaining To Close Phase 2

1. Validation

• Execute the legacy hardware validation checklist.
• Record actual observed results in LEGACY_HARDWARE_VALIDATION.md.

2. Licensing Policy

• Keep audit automation in place.
• Decide the commercial allowlist policy.
• Update Rust audit configuration to match that policy.

Current Desktop Contract

Main UI

• typed input and output panes
• explicit rewrite modes
• diff review
• copy output
• secure settings for the Gemini API key

Cross-App Utility

• Ctrl + Alt + R triggers selected-text rewrite
• default global mode is Preserve Voice
• selected text is only replaced after a complete rewrite succeeds
• app can remain hidden in the tray while the hotkey stays active

Tray Lifecycle

• closing the main window does not quit by default
• first close shows a tray hint
• later closes hide to tray
• tray menu supports show, rewrite, and quit

Queued Next

After Phase 2 is closed:

1. start the speech phase from PHASE3_SPEECH_PLAN.md
2. queue trust refinements such as protected terms and high-value detail preservation
3. revisit optimization work only after validation data exists