# Integrações Nativas do Transcript Implementation Plan

> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development (recommended) or superpowers:executing-plans to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.

**Goal:** Implementar as integrações que faltavam no MVP: gerenciador real do modelo GGUF, captura de áudio WAV, execução CrispASR, hotkey global e inserção/cópia com fallback cross-platform.

**Architecture:** Manter cada integração atrás de um módulo pequeno. A UI chama comandos Tauri, os comandos consultam `ManagedAppState`, e integrações dependentes de SO retornam mensagens explícitas quando o ambiente limita a automação.

**Tech Stack:** Tauri 2, Rust, CPAL, hound, reqwest, Tauri global-shortcut plugin, TypeScript.

---

## Task 1: Model manager real

**Files:**
- Modify: `src-tauri/src/models/mod.rs`
- Modify: `src-tauri/src/ui_commands.rs`
- Modify: `src-tauri/Cargo.toml`

- [x] Add URL de download do Hugging Face e resolução de diretório local.
- [x] Add validação por existência e tamanho mínimo/esperado.
- [x] Add comando `download_default_model` com escrita em arquivo temporário e rename atômico.
- [x] Testar status notInstalled/ready sem baixar o arquivo real.

## Task 2: Captura real de áudio

**Files:**
- Modify: `src-tauri/src/audio/mod.rs`
- Modify: `src-tauri/src/app_state.rs`
- Modify: `src-tauri/src/ui_commands.rs`
- Modify: `src-tauri/Cargo.toml`

- [x] Implementar gravador CPAL que escreve WAV via hound.
- [x] Manter stream vivo em thread de gravação e guardar handles seguros no estado.
- [x] Stop finaliza WAV e retorna caminho.
- [x] Manter teste unitário de máquina de estados.

## Task 3: Execução CrispASR

**Files:**
- Modify: `src-tauri/src/transcription/crispasr.rs`
- Modify: `src-tauri/src/ui_commands.rs`
- Modify: `src-tauri/tauri.conf.json`

- [x] Resolver binário padrão `parakeet-main` para o modelo v3.
- [x] Executar `parakeet-main -m <model> -f <audio> -t <threads>`.
- [x] Capturar stdout/stderr e retornar erro claro.
- [x] Parsear stdout como texto simples; JSON fica para evolução futura se o sidecar for configurado para isso.

## Task 4: Hotkey global

**Files:**
- Modify: `src-tauri/Cargo.toml`
- Modify: `src-tauri/src/lib.rs`

- [x] Adicionar `tauri-plugin-global-shortcut`.
- [x] Registrar `Ctrl+Shift+Space` no setup.
- [x] Ao pressionar, emitir evento `transcript://toggle-recording` para a UI.

## Task 5: Inserção/cópia cross-platform

**Files:**
- Modify: `src-tauri/src/injection/mod.rs`
- Modify: `src-tauri/src/ui_commands.rs`
- Modify: `src-tauri/Cargo.toml`

- [x] Adicionar clipboard backend com `arboard`.
- [x] Implementar `request_insert_text` que sempre coloca o texto no clipboard.
- [x] Retornar mensagens por plataforma/display server.
- [x] Manter Wayland como parcial/manual.

## Task 6: UI, CI e docs

**Files:**
- Modify: `src/app.ts`
- Modify: `src/app.test.ts`
- Modify: `.github/workflows/*.yml`
- Modify: `README.md`

- [x] Mostrar status de modelo e botão de download.
- [x] Reagir ao evento de hotkey.
- [x] Atualizar CI Linux com `libasound2-dev`.
- [x] Rodar verificação final completa.

## Verification

Run:

```bash
npm run typecheck
npm run test -- --run
npm run build
cargo test --manifest-path src-tauri/Cargo.toml
npm run tauri:build
```

Expected: todos passam; build Windows gera MSI/NSIS no ambiente atual.