Add a real demo recording, and stop spoken punctuation doubling up

The README now opens with a 26-second recording of the app actually
working: a real voice into a real microphone, Parakeet on the GPU, the
local gemma3:4b cleanup, and the real injection path typing into a text
field. The millisecond figures on screen are the measured times from
that take, and the opening example is now one of those scenes rather
than an invented one.

tools/record_demo.py rebuilds it, and prefers a human recording in
docs/images/_voice/ over synthesized speech, falling back to Windows
SAPI so the harness still runs on a machine with no recordings.
tools/record_my_voice.py captures those three lines in the right format.
The recordings themselves are gitignored: they are the author's voice,
not project data.

Recording the first scene surfaced a real bug. Parakeet usually
punctuates the sentence itself, so saying "question mark" at the end of
an already-terminated sentence produced "by Friday??". Runs of terminal
punctuation now collapse to the mark the speaker actually asked for,
while a deliberate ellipsis is left alone.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

Author: DatafyingTech

.gitattributes

@@ -17,5 +17,7 @@
 
 # Binary assets: never touch these.
 *.png   binary
+*.gif   binary
+*.mp4   binary
 *.wav   binary
 *.ico   binary

README.md

@@ -18,10 +18,19 @@ Everything runs on your own machine. No account, no subscription, no cloud, no w
 
 ## What it does
 
-You hold **Ctrl+Win**, say *"um so can you send Sarah the report by Friday, no wait, make that Monday"*,
-and let go. About half a second later this lands in your email, chat box, or code editor:
+![LocalFlow in action](docs/images/demo.gif)
 
-> Can you send Sarah the report by Monday?
+*Nothing here is staged. A real person speaking into a real microphone, transcribed by Parakeet on
+the GPU, cleaned up by a local gemma3:4b, and typed into the text field by the real injection code.
+The millisecond figures on screen are the actual measured times from that take. Reproduce it with
+`python -m tools.record_demo`.*
+
+You hold **Ctrl+Win**, say *"send a report to Mark, no no wait, I meant to say send it to Sarah and
+CC me"*, and let go. Under half a second later, this lands in your email, chat box, or code editor:
+
+> Send a report to Sarah and CC me.
+
+That is the second scene in the recording above, and it took 394 ms end to end.
 
 The filler words are gone. The punctuation and capitals are there. It understood that you corrected
 yourself and kept only what you meant. It never left your computer.

docs/images/demo.gif

@@ -155,6 +155,15 @@ def spoken_punctuation(text: str) -> str:
             text = re.sub(rf"[\s,]*{pat}[\s,]*", _lit(sym), text, flags=re.IGNORECASE)
         else:  # spaced
             text = re.sub(rf"[\s,]*{pat}[\s,]*", _lit(" " + sym + " "), text, flags=re.IGNORECASE)
+    # The ASR often punctuates for us, so a spoken "question mark" at the end of a sentence
+    # it already ended lands as "Friday??". Collapse a run of terminal marks to the last one
+    # the speaker actually asked for.
+    def _collapse(m: re.Match[str]) -> str:
+        run = m.group(0)
+        return run if run == "..." else run[-1]  # keep a deliberate ellipsis
+
+    text = re.sub(r"[.!?]{2,}", _collapse, text)
+    text = re.sub(r",\s*([.!?])", r"
", text)
     return text
 
 

docs/images/demo.mp4

@@ -462,3 +462,11 @@ def test_backtrack_new_triggers(cfg, raw, expected):
 def test_apply_backtrack_disabled(cfg):
     cfg["backtrack"] = False
     assert cleanup.apply_backtrack("a scratch that b", cfg) == ("a scratch that b", 0)
+
+def test_spoken_punctuation_does_not_double_up(cfg):
+    # Parakeet often punctuates the sentence itself, so a spoken "question mark" on the end
+    # of an already-terminated sentence used to produce "Friday??".
+    assert clean("hey Sarah comma can you send me that report by Friday question mark",
+                 cfg).text == "Hey Sarah, can you send me that report by Friday?"
+    assert clean("Are we done? question mark", cfg).text == "Are we done?"
+    assert clean("this is a test period", cfg).text == "This is a test."