# HyperTwist Handy Offline Dictation Shell Hierarchy Reconciliation - 2026-05-28

## Status

This document is the source-backed later-intake evaluation note for
`cjpais/Handy`.

It answers three narrow questions:

- does `Handy` displace the already landed HyperTwist speech-input, provider,
  or narration owner lanes
- what exact `Handy` slice is still worth retaining for HyperTwist
- where that retained slice belongs in the current production-line sequence

Result:

- `Handy` does not displace the landed HyperTwist speech stack
- the justified narrow `Handy` return path has now landed as bounded
  `Phase 6R-AJ`
- the retained slice is a narrower bounded external offline dictation shell,
  transcript-history, and output-routing adjunct
- no broader speech/provider packet opens by default beyond that bounded slice

This is a later permissive intake outside the already closed current curated
`75`-row board. It sharpens later retained queue truth without reopening the
closed board counts.

## Source basis

- `C:\HyperTwist\docs\HYPERTWIST_REPO_INTAKE_RETENTION_AND_PRODUCT_FIT_DOCTRINE_2026-05-14.md`
- `C:\HyperTwist\docs\REPO_LICENSE_TRACKING.md`
- `C:\HyperTwist\docs\v6_5_deep_manual_pack\HyperTwist\FEATURE_REGISTRY.md`
- `C:\HyperTwist\docs\v6_5_deep_manual_pack\HyperTwist\ROADMAP.md`
- `C:\Workspaces\HyperTwist\mirrors\permissive\cjpais\Handy\LICENSE`
- `C:\Workspaces\HyperTwist\mirrors\permissive\cjpais\Handy\README.md`
- `C:\Workspaces\HyperTwist\mirrors\permissive\cjpais\Handy\src-tauri\Cargo.toml`
- `C:\Workspaces\HyperTwist\mirrors\permissive\cjpais\Handy\src-tauri\src\main.rs`
- `C:\Workspaces\HyperTwist\mirrors\permissive\cjpais\Handy\src-tauri\src\transcription_coordinator.rs`
- `C:\Workspaces\HyperTwist\mirrors\permissive\cjpais\Handy\src-tauri\src\managers\audio.rs`
- `C:\Workspaces\HyperTwist\mirrors\permissive\cjpais\Handy\src-tauri\src\managers\transcription.rs`
- `C:\Workspaces\HyperTwist\mirrors\permissive\cjpais\Handy\src-tauri\src\managers\model.rs`
- `C:\Workspaces\HyperTwist\mirrors\permissive\cjpais\Handy\src-tauri\src\managers\history.rs`
- `C:\Workspaces\HyperTwist\mirrors\permissive\cjpais\Handy\src-tauri\src\commands\transcription.rs`
- `C:\Workspaces\HyperTwist\mirrors\permissive\cjpais\Handy\src-tauri\src\clipboard.rs`
- `C:\Workspaces\HyperTwist\mirrors\permissive\cjpais\Handy\src-tauri\src\actions.rs`
- `C:\Workspaces\HyperTwist\mirrors\permissive\cjpais\Handy\src-tauri\src\llm_client.rs`

## Outcome taxonomy

- repo-level outcome category:
  - `bounded later-retained slice now partially incorporated`
- realization class:
  - `narrower bounded slice`

## Exact kept capability families

The kept `Handy` value is narrow and upper-surface only:

- external hotkey, push-to-talk, and cancel-driven dictation lifecycle
- cross-platform microphone open, lazy-close, mute, and device-selection shell
  behavior above the current speech session stack
- transcript history, retention, and recall-list shell behavior
- paste, clipboard, typing, and script-oriented output-routing posture
- local model catalog, checksum, unload, and selection policy patterns above
  the current payload-custody lane
- optional post-process overlay behavior after transcript production

## Exact not-kept capability families

`Handy` is **not** promoted for:

- top-level provider/session ownership
- provider routing, BYOK custody, usage/cost, or billing shell ownership
- core native speech-input runtime ownership
- Python transcription-service ownership
- narration or voice-output ownership
- broad assistant-platform ownership
- broad tool-router or external action-platform ownership

## Cross-lane resolution

`Handy` does not beat the current stronger owners for the deeper speech stack:

- `ggml-org/whisper.cpp` remains the stronger current owner for the native
  offline speech-input runtime, microphone shell, permission/readiness shell,
  and payload-custody seam
- `SYSTRAN/faster-whisper` remains the stronger current owner for Python STT
  orchestration and service-lane posture
- first-party HyperTwist remains the stronger owner for provider-neutral
  provider/session contracts, provider routing, capture-route workflow/control,
  operator-facing shell posture, and provider-cost/billing shells
- `rhasspy/piper` and `coqui-ai/TTS` remain the voice-output rows

So the retained `Handy` slice is:

- `A1` only for the exact external dictation-shell, transcript-history, and
  output-routing adjunct lane
- `R1` because the repo is `MIT`
- `F2` because the retained value is narrow and bounded rather than a broad
  speech-platform takeover

## Product-fit verdict

`Handy` is product-adjacent and worth retaining, but only as a later
speech-adjacent adjunct.

It must never be mistaken for:

- the HyperTwist top-level speech/provider owner
- the broad speech-input runtime owner
- the default next speech/provider packet
- a generic assistant-platform donor

## Production-line sequence result

Current routing is:

- the row is no longer only hypothetical; the justified narrow return paths are
  now landed as bounded `Phase 6R-AJ`, `Phase 6R-AO`, and `Phase 6R-AU`
- that landed slice covers:
  - external dictation-shell profile/state
  - transcript-history and retention shell behavior
  - paste/clipboard/output-routing shell behavior
  - optional transcript post-process overlay posture
  - global-hotkey, mute, microphone-mode, and device-selection shell posture
  - local model catalog review posture above the landed payload-custody seam
  - payload-integrity review posture for local speech model payloads
  - unload-policy review posture for local speech model payloads
- it still does not reopen or displace the landed `whisper.cpp`,
  `faster-whisper`, or first-party provider-neutral speech lanes
- no broader speech/provider-adjacent first-party packet opens by default

If `Handy` reopens again later, it must now stay narrower still than the
landed `Phase 6R-AU` shell packet. Any follow-on must prove a remaining gap
above the already landed speech-input, provider, permission, capture-route,
payload-custody, narration, and operator-facing dictation-shell seams rather
than widening into actual model download/extract/unload execution ownership.

## Legal and custody result

- root code license: `MIT`
- mirror custody: permissive HyperTwist mirror
- no clean-room boundary is required
- model and payload review still remain separate from the code-license judgment
