unspoken_add
Mark a transcript word that was never spoken in the recording, so captions and verification stop expecting it. Address by word index or phrase.
Instructions
Mark a word the transcript holds and the recording never said.
Whisper transcribes straight across a retake splice and emits words from
both takes interleaved, so words appear in the index that nobody said.
They are in the transcript and nowhere else — not the audio, not the
render — so captions draw them and verify expects them.
This writes a mark beside the transcript and never touches the transcript
itself: word indices must not renumber, or every cue pointing at one would
move. Captions, caption_view and verify all stop expecting the word;
no audio, timing or shot changes, because the seconds around it are the
take that was kept. Echoes the word it resolved to, plus three either side.
Addressed by word_index or phrase — but unlike cue_add, a phrase
resolving to more than one word is refused rather than bound to an edge:
unspoken addresses exactly one word, and picking a side of a wider match
would silently mark the wrong one half the time. Narrow the phrase, or
pass occurrence= if it is disambiguation rather than width.
Prefer unspoken_detect to find them: it is evidence rather than reading,
and reading for sense provably misses the grammatical ones.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | No | The project directory to act on. Omit it — the usual case — when this server is bound to a project (started as `proofcut -C DIR mcp`, or inside a project; `ping` says which): it then resolves to that one bound project, a relative path resolves against it, and a path outside it is refused by name. Unbound, `path` is the whole address and omitting it refuses rather than guessing. | |
| after | No | A forward cursor over a phrase's matches: any match at or before this word index is skipped. -1, the default, means from the start. | |
| phrase | No | Address it by wording instead — but unlike `cue_add`, a phrase matching more than one word is refused rather than bound to an edge: a mark addresses exactly one word. | |
| clip_id | Yes | The transcript holding the word. | |
| occurrence | No | Disambiguate a phrase by count when it matches more than once, **1-based** in transcript order among the matches after `after`: 1 is the first, 2 the second. Unset, an ambiguous phrase is refused — listing every candidate's range and text — rather than guessed at. | |
| word_index | No | The word to mark. Give this or `phrase`. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||