Add a send key that presses Return after the paste

[dinooo13]

What

Press a second chord, Right Option by default, at any point while the push-to-talk key is held, and Return follows the pasted text. That sends a chat message or runs a terminal command without a second trip to the keyboard. The send key is recorded in Settings like the push-to-talk key. An empty chord in settings.json turns it off.

Behaviour

• The send press latches for the rest of the recording, so the release order of the two keys does not matter. The latch resets on the next press.
• The send key is swallowed only while the push-to-talk chord is engaged, so an app never sees a stray Cmd+Return mid-dictation. When the chord is not engaged, the key passes through untouched.
• The 120 s watchdog release never submits: a lost key-up must not send a message unattended.
• Short taps, cancelled recordings and empty transcripts paste nothing and press nothing.
• Settings warn when the send key is part of the push-to-talk chord, since it could never be pressed separately.

Where

• HotkeyChordTracker gains submitKey and isSubmitArmed; HotkeyEvent.released carries submit: Bool.
• DictationCoordinator threads the flag from the release into TextOutput.insert(_:submit:).
• PasteboardOutput posts Return from a detached task 50 ms after Cmd+V, with no modifier flags, so it stays off the release-to-paste path and a still-held Option cannot turn it into Option+Return.
• Settings.submitKey, a second recorder row in Settings, README FAQ and the CLAUDE.md decisions table.

Benchmark

Skipped on purpose. The change threads a flag through finish and insert and the engine call is untouched; the benchmark only times engine.transcribe, so it could not show a difference. A real dictation on this branch logged release-to-paste 0.288 s for 9.9 s of audio with engine 0.212 s, in line with the M1 baseline.

Tests

swift test: 84 tests pass, including 10 new tracker tests and 5 new coordinator tests. Verified live with Fn as the push-to-talk key and Left Control as the send key.

Implementation was drafted by OpenCode running GLM 5.3 Flash from a written spec and reviewed by hand.

🤖 Generated with Claude Code