What’s new in Speech Layer

Commit messages must never name panes, callsigns, or clients - subjects and bodies are public via the speechlayer.com changelog, so use <pane> and generic wording instead

Document boss-pane task handoff routing in the mailbox AGENTS.md

Bounce-worker hardening for set -e + pipefail - grep with no match inside command-substitution assignments (Exec line parse, workspace count) would abort the detached worker before verification and the orch/boss report

New 'speechlayer kill' takes the whole herdr fleet down in order - helper daemons (orch-watcher, callsign-sync, pane-healer, fanfare, keys-guard, compaction-guard), stray pi procs (own ancestor chain excluded), speechlayer window, then 'herdr server stop' last since it kills every pane PTY - voice stack (whisper-voice-daemon, say/TTS, OpenRC services) deliberately untouched - verified no cron/OpenRC/watchdog respawns the fleet, so it stays down until the Desktop shortcut / speechlayer-session-open reopens it

New 'speechlayer bounce' is a full simulated reboot - snapshots pre-state, then a setsid+nohup fully-detached bounce-worker (stdio to /dev/null) kills the fleet, re-runs the exact XDG autostart Exec lines (herdr-server, callsign-sync, fanfare, keys-guard, pane-healer, compaction-guard, session-open; %-codes expanded, Hidden/disabled skipped) so restart and reboot can never drift apart, then verifies herdr status green + helpers + window and logs to /tmp/speechlayer-bounce.log, and reports the result to the orch + boss agents with retry

README + AGENTS warn never to pkill speechlayer processes (half-kills the voice stack, leaves the fleet running) - use 'speechlayer kill' / 'speechlayer bounce' instead

Say-pocket-impl aplay gets a deep ring buffer (--buffer-time, PK_APLAY_BUFFER_US default 500 ms) so CPU storms cannot starve playback into jitter between scheduler slices

Cpulimit added to PKGS_CORE (hard duty-cycle cap behind training/selfthrottle.py) and INSTALL.md documents the self-throttle stack

Llm() gguf picker now uses find -printf + sort instead of ls -t (mtime order across both dirs)

Per-channel message origin breakdown from pi session logs

Voice-barge playback-start grace (~1.1s) so a wake word spoken as say begins cannot kill it

Fix cross-project reply leak (turn binding + resolution gate + mailbox handoff)

Training/generation self-throttle now enforces a hard CPU duty-cycle cap - selfthrottle.py spawns a sibling 'cpulimit -l <TRAIN_CPU_CAP|30> -p <self>' before nice/pin, because nice 15 + core pinning alone still let 3 pinned gen_samples.py hold load >20 and jitter say (live retest 2026-09-04); SIGSTOP/SIGCONT throttling composes with nice/affinity since it is orthogonal to scheduler priority

Self-spawned cpulimit must never get -i (include-children) - cpulimit is a child of its own target and -i makes it SIGSTOP itself, parking the target in state T forever; verified and documented in selfthrottle.py and speechlayer.md

Nice-guard now also spawns a NICE_GUARD_CPU_CAP% (default 30, 0 disables) cpulimit on discovered training-class pythons that did not self-cap - belt and suspenders; procs already carrying a cpulimit are detected by cmdline probe and skipped so two cyclers never compound on one pid

Burner at cap 30 holds ~29-31% and TRAIN_CPU_CAP=50 holds ~47-52% with nice 15 + pinning + thread caps all applied, duplicate-tag flock still refuses (exit 1), per-shard locks still coexist, TRAIN_ALLOW_MULTI=1 still bypasses, real gen_samples.py launches show 'cap=30% (cpulimit pid N)' in the banner

Speech Layer TTS CPU Protection and tts/README CPU priority sections describe the cap layer, TRAIN_CPU_CAP/NICE_GUARD_CPU_CAP knobs, and the -i self-stop gotcha

Broken-pane session recovery procedure (boss touch-loop incident 2026-09-04)

Addressed 'tell <pane> stop talking / be quiet / shut up' now toggles /say off on that pane immediately - addressing the pane by name is the consent, so no yes/no question is asked

Addressed 'tell <pane> start talking / speak up' toggles /say on immediately

Both acknowledgements state how to reverse it ('<pane> muted, say tell <pane> start talking to unmute' / '<pane> unmuted, say tell <pane> stop talking to mute')

STT-mangled toggle phrases ('stop talk', 'stop talk start talking again') now match the toggle intent instead of being delivered to the pane as chat text

The yes/no confirmation pattern stays available for other flows - it is no longer wired into this toggle

Permanent fix for say CPU starvation - training/generation scripts self-throttle at launch via training/selfthrottle.py (nice 15, pin to cores 0..nproc-3 leaving two audio cores, OMP/BLAS thread caps, per-shard single-instance flock) wired into gen_samples.py, train-hey-speechlayer.py and train-kapish.py before any heavy import

Nice-guard moved into the repo as core/nice-guard.sh (~/.local/bin/nice-guard is now a symlink, autostart unchanged) and extended to renice + pin tts312/wakeword-train venv pythons and speechlayer/training scripts

Say-pocket-daemon self-applies nice -10 at startup via the new root helper system/linux/speechlayer-audio-rt + sudoers rule (sudo system/linux/install-audio-rt.sh once), graceful logged fallback to nice 0 without it; fix_pocket_tts re-applies on speechlayer restart

Nice-guard watchdog renices top unprotected CPU hogs to +15 (training class also pinned) whenever load exceeds nproc-1 while the say queue is active

Speech Layer TTS CPU Protection section, tts/README CPU priority section

Addressed 'tell <pane> stop talking / be quiet / shut up' offer now re-opens the mic for the answer instead of leaving the daemon deaf until the offer TTL expired

Every yes/no confirmation times out after eight seconds of silence only and defaults to no, and any real speech resets the window

A spoken yes or no is consumed by the pending confirmation gate, never typed into the pane as a chat message

Whisper hallucinating 'yes' or 'music playing' from a quiet room no longer confirms the mute - noise probes never early-cut, a whole-probe gate plus a silence-anchor buffer trim keep the fiction out of the transcript, and a low-confidence sidecar lets the gate refuse it

Internals documents the reusable yes/no spoken confirmation pattern so other flows (spawn-offer, pane-close) can adopt it

Per-pane 'stop talking' now confirms before muting - the discriminant is whether the pane was addressed by name

Bare shut up / stop talking / be quiet keeps the existing global soft cut, no question, no state change

Addressed 'tell <pane> stop talking / be quiet / shut up' barges the current say with the short offer 'Tell <pane> not to respond verbally from now on?' and waits for yes or no

Yes runs /say off on the addressed pane (persistent mute); no or TTL expiry changes nothing

Tell <pane> start talking / speak up runs /say on directly with no confirm

Say-off consent reuses the spawn-offer pending state (kind=say_off on the shared file, pane_id pinned) with yes/no resolved against the offer, never parsed as a fresh tell; arm timestamp persisted so the spoken answer lands in a separate daemon process; legacy spawn-offer schema unchanged for the phone bridge

Add a callsign respell to the user respell dictionary

Privacy index never seeds English function words as names (From: The client-site no longer masks every 'the' thread-wide)

Stopword-class tokens are never replaced at masking time, whatever a legacy store entry says

Load-time migration purges seeded names whose token is a stopword or NEVER word and evicts their orphaned fakes (live store: 1 entry cleaned, name:the)

Migrate CLI command rewrites the store and reports the purge count

The client-site seeds surname only, a sentence of pure function words masks nothing, legacy store with name:the migrates clean

Herdr early-cut no longer fires on a structured tell - a comma or other separator from a mid-sentence breath pause keeps listening instead of stopping the recording (the 'read me out' cut)

Adaptive silence/speech threshold learned per mic source from whisper probe verdicts (WVD_ADAPTIVE_THRESH, default on) so quiet laptop-mic speech is no longer invisible to every energy guard

Learned threshold is clamped between a small floor and the old fixed 150, persists per mic source, and feeds the silence wall, its recheck, both trailing-pause guards, and the transcript-silence energy guard

Internals env table documents the adaptive threshold knobs

Respell Shoplight to shoplite (project name) in the proper-nouns dictionary

Respell pain to pane unconditionally (Whisper mishear in herdr context; real-word tradeoff accepted)

Extract terminator probe into named configurable strategy (WVD_TERM_MATCH_MODE, default trailing - no behavior change)

Silence auto-stop docs now match the 8 s WVD_SILENCE_S code default (was documented as 30 s in wake-words, internals, README, speechlayer)

SpeechLayer mic-route keeps pinned Shokz USB through standby instead of falling back to the laptop internal mic

Sticky USB pin written on ensure, wiped only on true USB disconnect (card gone), re-picked on USB reappear

Speech Layer-mix.sh mic_source now prefers the sticky USB source while its card is still listed

Render correct favicon.svg (blue bubble + waveform) at 180x180, transparent

Flood-fill only outside bubble, keep white shirt glyph intact

Also install speechlayer.png to hicolor when writing desktop shortcut

Install icon to hicolor + reference by name (survives DE icon-cache reloads)

Add speechlayer-session-open to symlink set (repairs bin targets after renames)

No-op idempotent re-link for pre-existing targets

Transparent PNG background (only bubble opaque)

Mark ~/Desktop shortcut as trusted (no more Unrusted application launcher prompt)

Write ~/Desktop/Speech Layer.desktop with favicon icon (no more broken pi-surf-session-open)

Favicon assets vendored under assets/favicon/ for desktop + web parity

Wake word renamed to hey_speechlayer.onnx (was hey_marvin_v0.1)

Friendly labels in notifications (no raw model names or scores)

Personal speechlayer=speechlayer alias

Os-adapters leftover identifier

Rename leftover speechlayer identifiers in live docs

Rebrand speechlayer -> speechlayer: tree move, identifiers, paths

Rename pi-surf family to speechlayer/surfagent; drop surfagent force-loading

Wharton now respells to speechlayer in all STT entry points (wharton → speechlayer)

The service-pane registry, spawn wrapper, and scaffold are live - code owns routing and never-do gates, prose owns domain behavior - and mailbox is migrated as the first citizen

Voice say-that-again now falls back to the pane text store when the audio ring is empty, and the say queue daemon no longer lets a leaked SAY_TAG from its launching shell suppress all replay capture

Voice routing now asks nemotron instead of ling, and a leftover kimi pin in the environment was brought in line with it

The hey-speechlayer voice window now opens as speechlayer instead of pi-surf, and everything that looks for the window by name was updated to match

A pasted clipboard image path can no longer end up in the window title

Revert "- [x] Rename: The hey-speechlayer voice window now opens as speechlayer instead of pi-surf, and everything that looks for the window by name was updated to match"

The hey-speechlayer voice window now opens as speechlayer instead of pi-surf, and everything that looks for the window by name was updated to match

A pasted clipboard image path can no longer end up in the window title

The voice status and restart readouts now say speech layer instead of voice infrastructure

Voice barge-in no longer loops a replayed sentence, the replay plays through unless you stop it

Replay now sets a marker while a re-spoken clip is on the speaker so the barge-in detector leaves it alone

Voice commands like say that again and say off no longer get typed into a pane as chat text, they run the speech control and answer aloud

Replayed speech no longer interrupts itself in a loop when you talk over it

Fix spoken repeat command not firing when a source tag is attached. Saying "say that again" with the trailing origin tag (the "[voice]" the inject path adds, or the phone "[xmpp]"/"[email]" tags) left a stray trailing word after the brackets were stripped, and that broke the whole-utterance match so the repeat never happened and the words were typed as prose instead. The same fragility hit every whole-utterance voice command (new/delete/compact session, shift-tab, thinking level, clear). The transform now strips a trailing voice/email/xmpp tag word before matching commands, while leaving real command words alone (so "close pane", "cycle thinking", "new voice" still work). Verified: "say that again [voice]" now triggers the repeat, and "please say that again for me [voice]" still passes through as prose.

Barge-in during a spoken agent summary now stops the whole readout, not just the sentence. The energy/wake barge-in was wired to say --skip (cut only the playing sentence, leave the rest of the summary queued). Switched it to say --skip-group, which also drops the still-queued sentences that share the playing summary's group. Other panes' queued speech is untouched, and an ungrouped utterance still just skips the current sentence. Hard shut-up (say --stop) is unchanged.

Rewrite leg follows the pane router to inclusionai/ling-3.0-flash so both cloud paths share one model. Extend the reasoning-off gate in _post_chat to cover ling (it was nemotron-only); with effort none ling matches nemotron on rewrite, without it ling returns NONE. Keep reasoning effort none. Revert: SL_REWRITE_MODEL=nvidia/nemotron-3-nano-30b-a3b

Swap nemotron for inclusionai/ling-3.0-flash (reasoning effort none + max_tokens 8 mandatory; thinking on returns empty). Needle POST shape already correct (query/panes), no fix needed. Update the rewrite-model comment in wvd-herdr-control to note the router diverged. Revert: SL_ROUTER_MODEL=nvidia/nemotron-3-nano-30b-a3b

Remove stale .bak copies next to live dictate/herdr scripts, and make the whisper-server model overridable via WHISPER_MODEL (default ggml-base.en.bin) instead of a hardcoded path; fix the WHDISPER_MODEL typo in speechlayer.md

Keep HTML email links so the LLM sees the actual URLs.

Local first, one cloud model, no more wrong-pane injections.

Reminders no longer talk over Speech Layer: one speech queue, and the ding waits its turn.

Stop cutting mid-sentence on "tell my browser" and trailing please.

Whisper-voice-daemon: recheck recent audio before silence wall-timeout cuts (fix mid-sentence cut-outs under CPU load); load canonical cancel phrases from speechlayer_cancel_phrases.py

When the phone and the headset both hear the same sentence, only one message reaches a chat pane - near-duplicate repeats within 90 seconds are dropped, and short replies like yes or Resume always still go through

Needle 2, a tiny on-device command model, tidies misheard voice commands (like 'even those out' becoming 'balance panes') with no internet call

The wake-word mic now follows whichever microphone is selected in sound settings, including headset plug and unplug, instead of staying stuck on the old one

If you start talking while a reply is playing, it pauses and finishes after you stop

Replies never start over an open mic, and stop or skip still cut through right away

The public changelog page now refreshes itself on every push, so it can no longer fall behind the real history

Every queued play re-checks the current speaker so headset and laptop no longer swap mid-burst

The play log now notes which speaker was used, so a future mix-up is one search away

Raise wake-record hard cap from 40s to 60s (SL_RECORD_S)

Pi compaction-freeze guard: watchdog daemon + install wiring

Say 'barge in' before a message to interrupt a busy pi pane (Esc) and submit fresh instead of queueing as a steer; works after a callsign ('tell features barge in …') and after a workspace route, and never triggers on mid-sentence 'barged in'

Say again now speaks on panes whose replies were never read out loud

Add 'speechlayer calibrate stop' - cancel an in-flight barge battery (SIGINT, SIGTERM after 3s); watcher untouched

Fix 'running but no state file' race + set -e mid-restart abort

Stop mid-sentence cutoffs (root-cause + hardening)

Spoken replies are kept as short audio clips, so say --replay and /say again play back exactly what you heard instead of generating it again

Keeping those clips is off by default and only starts once you turn it on, it never keeps more than five, and each pane only replays its own messages

Asking for a replay cuts whatever is playing and clears your own backlog, while other panes keep their queued messages and play right after

The talking queue, the always-ready pocket voice, and the skip-what-is-playing hotkey script now ship with the repo so a fresh install gets the whole setup

/say again replays your pane's last answers, and each workspace can have its own voice or stay muted

Wifi watchdog only nudges saved networks, never when wifi is already up, so phantom password popups stop

Voice commands now catch plural mis-hearings like cue bolts and fix them to client-site

Personal API keys (BYOK) now covered in README, INSTALL, speechlayer and AGENTS

Listen mode explains always-listen at boot and how talking over the agent becomes the next turn

Portability table lists the personal-keys file alongside the other per-machine settings

Add the Needle page that AGENTS.md already pointed to

Sensitive mode now pulls talk-over loopback knobs from one list

Residual floor can go up to 80k so big calibrations are not clamped away

Workspace voice map plus per-voice gain file after pane resolve

File export bakes gain so soft voices stay leveled off-play

Pocket engine through the warm daemon for phone TTS

Xmpp inject uses herdr agent prompt (atomic submit) with pane send-text plus Enter as fallback

Multi-step marker sequences paste via pane send-text since agent send is gone

Sticky default heals from legacy mac to herdr and auto-spins the my workspace home lane when it is missing

Ensure_agent_lane creates workspace, splits pane, and starts the pi agent for a callsign

Wait_idle requires a busy sighting or sustained idle so a mid-retry spinner never becomes the emailed reply

Screen scrape drops spinner glyphs, retry countdowns, error toasts, and the pi status bar

Reply comes from the session log and keeps waiting while the agent is still busy

Xmpp-outbox-drain pulls per-site commit outboxes over ssh and fans out to xmpp, ntfy, or webpush recipients

Drain restores curly quotes mangled into U+XXXX placeholders, raw JSON escapes, and common HTML entities

Xmpp-pi-bridge-ensure idempotent supervisor refreshes the D-Bus address and heals the pidfile

Xmpp-send-file sends attachments encrypted with XEP-0454 so the phone shows them inline

Per-directory project keys in keys.json with longest-prefix path match

Project key beats user default, then env, then bashrc per request

Speech Layer keys projects, emit, import-pi-sh, and --path/--cwd flags

Settings page lists project overrides and can save or remove them

Herder and listen treat project keys as personal on 401

Openrouter resolve reports project source via resolve_key_info

Brand import path in listen-intent so product name lookup does not crash

Peel doubled tell verb after respell so callsign still parses

README, AGENTS, INSTALL, speechlayer plus keys.json.example cover project keys

Pane rename comment matches agent prompt (send is gone)

Sticky only re-pins on a real focus edge so background tell keeps its target

Prefer unique agent name over duplicate pane label for sticky inject

Herdr docs use agent prompt, pane-first start, and barge-in stop order

Steering keeps open work; surfagent claim leases; agent prompt for phone inject

Install renders desktop Names and paths from product name and CLI name

Dual CLI symlink when the public name differs, keep speechlayer forever

Launchd Label prefix is data, templates stay com.speechlayer on disk

Mix sink name is MIX_SINK with speechlayer_mix default across audio helpers

Web templates plus render-brand write Speech Layer by default, speechlayer overlay ready

One runtime brand layer so Speech Layer and public speechlayer share one tree

Defaults stay Speech Layer (wake, config dir, URLs, spoken prompts) with fail-safe fallback

High-traffic surfaces read product name, wake phrase, and app name from the brand file/env

Speech Layer brand dumps the resolved values; inventory lists what still needs a wake-model choice

Per-user LLM provider keys in ~/.config/speechlayer/keys.json (600), user key beats server env key per request

Core/speechlayer_keys.py shared store + masked display + cheap key validation + auth-failure surfacing (marker + notify, never silent server billing)

Speech Layer keys status|set|clear|test|ui plus localhost :7782 settings web page (provider selector, password input, save/test/clear)

Wvd-herdr-control and wvd-listen-intent resolve OpenRouter keys via the BYOK store with strangler-safe env fallback

README BYOK section; install.sh warns with the speechlayer keys alternative

Resolve panes on non-active tabs of a workspace

Herdr 0.7.5 dropped agent send; inject path now uses agent prompt

AGENTS.md and wake-words herder-route notes match the new CLI

Stop treating bare 10/11-digit runs as phones

Drop postal code masking entirely

Speech Layer restart now revives a dead email-pi-bridge via email-pi-bridge-ensure (best-effort, cron remains primary supervisor)

Footer and logs count distinct identities, not hits

Shield and unshield phone XMPP sticky injects and replies

Shared store with email bridge and kill-switch XMPP_PRIVACY

Count shield replacements per message and log them

Tell agents that fake tokens are stand-ins to quote as-is

Footer replies with what Speech Layer shielded during LLM calls

Herd residual body verbs ask which pane, never spawn to or two

Fix client-site-two bug: body_starter includes to/too/two; herd-default routing for workspace-matched tells; block function-word callsigns.

Wake poke, CLI fast path, dead-air slimming, hold presynth

Install committed say/say-queue-daemon (wake.fifo 8ms claim, same-group ordering, recording-hold presynth, 40ms enqueue)

Hands-free auto-calibration battery + daemon self-barge detector

Spoken-prep leading-zero trim (PI-000018 -> PI-18); README: wake.fifo/same-group/presynth queue docs

Glue 'tilda/tilde slash foo' to ~/foo before flat pairs

Mask bare and keyword-anchored phone numbers with NANP validation

Mask payment cards, tax ids, and Canadian postal codes with stable fakes

Mask emails and phones to stable short fakes before prompts reach the LLM and restore them on replies

Seed names from mail headers and body anchors with separate first and last fakes

Shield injected prompts and unshield replies with a shared locked-down lookup file

Ask which pane when duplicate labels span workspaces

Silent deciders sticky then focused herd then unique agent name

Share the which-pane question and answer across voice and text

Mute or unmute the default sink with switch volume and goodnight phrases

Set Pocket voice across a whole workspace or a named pane

Queue by default, pane-scoped replay ring, and soft barge gating

Reconcile Pocket daemon pile-ups and durable HF cache on restart

Keep XMPP channel sticky separate from voice sticky and focus

Allow duplicate pane labels and keep agent names unique

Stop bare thinking words cutting mid-sentence dictation

Drop dead svn commit historical map note

Speak xmpp as x m p p

Currency, paths, URLs, emails, dates, emoji in speak-prep

Log respell diffs for training when raw ≠ fixed

Absorb trailing dots on a.m./p.m. clock forms

Fix a.m./p.m. trailing period after clock expand

Speak clock times without colon (14:30, 3pm)

Space month abbr expansions so Oct.17 reads clean

Month abbreviations speak as full names

Client-site-class fusions respelled as tell client-site

Degrees, ops, %, #N, units, e.g., cwd

Speak-prep dict (~ → roughly; digit.digit → point)

Successful tell no longer dual-dispatches into the focused pane

Mark tell committed before TTS; fire-and-forget say

Wall after commit counts handled; refuse tell-shaped fallthrough with voice retry

Free-form pi-surf prefers sticky pin over focused eyes

Evolve proper-nouns into a respell dictionary (pie/pi, user JSON)

Delete pi session runs /delete and confirms Yes

Agent inject keeps multi-Enter sleep order for confirms

Eyes/focus on also raises the herdr pi-surf window

Focus client-site cleaner lands on the cleaner pane

Tell body re-runs bare control grammar on target pane

Tell body runs cwd/nav control on target pane not chat paste

STT togel focus for tell-move-focus toggle

Home sticky channel is herdr not the home pane

Voice toggle for tells moving eyes focus

Fix show me bare eyes-on grammar

Voice eyes on/off for bare workspace and pane focus

Fold client-site's / client-site STT into client-site for tell routing

Sticky hold checked every tick so focus cannot keep the channel

Sticky hold reasserts herdr against focus steal

Handoff wait-scrape herdr reply to phone; re-pin sticky + hold

Focus sync skips sticky during hold so channel stays herdr

SMS herdr reply after wait; re-pin sticky

Fix bridge crash mangle on scrap path regex

STICKY machine line; instruct create to re-stick new pane

Short ensure herdr pane when missing

Confirm keyword yes/no never agent-sends the herdr pane

Default handoff to herdr pane via agent send

Keep rules/LLM rewrite path intact behind spawn-offer-clarify flip

Quoted my workspace and label-before-noun patterns

Live herd name in free text re-routes offer with held body

Never TUI dump mid-working; reject chrome junk

Keep live herd det words like my for inventory peel

Non-yes/no → rules then Needle/LLM rewrite route only

Consent stays keywords; wrong rewrite vectors never invent yes

Live-offer free-form asks speechlayer clarify path

Stop he eating hello

Forward speechlayer spawn-offer text to XMPP not echo inbound

Stop to/that hard split; long-comma English stays peel

Heal session D-Bus so Gajim remote can ack

Silent focus cutover repins sticky without phone spam

Sticky is channel not eyes address wins then manual focus

Herdr skill notes label equals agent callsign dual-write

Pane rename always dual-writes agent callsign (shim plus control)

Background callsign sync heals TUI renames upgrade-proof

Tell shell pane to launch pi types pi plus enter not prose

Move working directory force-relocates pi session and resumes

Keep change working directory as exit-pi shell-cd path

Folder nav resolves chat basenames and change-cwd phrases

Match change working directory / cwd / folder to name

Resolve short basenames under chat before zoxide

Never agent-send spawn yes/no residual or I don't know garbage

Wait for TTS and skip free-wake preroll on spawn oneshot

Peel hey speechlayer wake so spawn yes/no is not tell-to-speechlayer

Arm one-shot free-wake after spawn offer, cut on yes/no

Accept no thanks and wake-style yes/no on spawn offers

Typed Note-to-Self runs the same Speech Layer pipeline as voice notes

Peel my/the and trailing pane nouns on tell routes

Caption side-channel for current, last, queue, status.json

Queue daemon updates captions on play, skip, done, and cancel

Tell client-site pane launch pi route works despite STT mangling

Tall/tel aliases of tell and cube-old folds into client-site

Stop hyphen split and cwd-basename false pane on tell peel

Hey and yo aliases for tell with dual-use hey (filler vs route)

Sticky fallthrough on soft free-form, shared with phone target file

Unknown tell target offers spoken yes/no spawn (shared XMPP offer state)

Tell workspace pane message routes via live inventory longest match

Herdr agent inject (XMPP-style) for tell, herder route, and --inject CLI

Everyday make/create/new pane wording maps to ensure pane

Wvd_agent_inject helper; pi-surf-term prefers agent send over xdotool

Soft "speechlayer …" free-form gate with salvage before network and hard walls so blue never hangs

Ensure workspace and ensure pane create-if-missing then focus, including natural hybrid phrasing

Bash wvd_herdr_control wall plus {{SHIFTTAB}} marker wins in dictate scripts

Needle and herder-route ops, tts barge conf, phone mic and listen-path polish

Hold say playback while Speech Layer is recording so panes don't talk over the mic

Soft interrupt skips only the current utterance and keeps the rest of the queue

Wake and energy barge use skip; shut up still drains the whole queue

Track host say queue tools and say-summary extension with Speech Layer

Void guest shutdown check with default-device arecord proof; image retained

Void thin-guest L2 claim and burn-in scorecard (runit, on-target whisper, PA mix)

Rewrite DAEMON_HOME pyenv templates and ship alsa-plugins-pulseaudio on void

Dual-ship service trees with WVD default Pulse device fallback for Void asound

Force-distro/init/DE overrides and optional scrcpy on void and suse

Harden runit enable and systemd unit write for thin containers

Family dry-run matrix, container smokes, Level-3 residual scrub

Linux-family-matrix plus void and opensuse package smoke reports

Cross-host macos svc_status port heuristics and soft LAN path

Add macos-first-hour checklist with Darwin-safe probes

Gate first-hour and forced-macos status in adapter selfcheck

Point macOS install and resumption at first-hour playbook

Multi-family (debian/Mint) path, models seed step, on-target whisper wrappers

KDE/Cinnamon/dconf-cli hotkeys and never transplant cross-distro whisper bins

Ship wakeword-models seed including hey_speechlayer verifier

Mint walkthrough, portability claim calibrated, debian-family QEMU burn-in

Add install-macos first-boot helper and optional indicator launchd unit

Ship skhd and Hammerspoon hotkey examples under system/macos

Prefer TMPDIR for SL_RUNTIME_DIR on Darwin in env.sh

Make fetch-deps cmake jobs work without Linux nproc

Point README and portability at the macOS install path

Route dictate RECORD_DEVICE through audio_fallback_device for CoreAudio default

Ship rumps menu-bar indicator skeleton and wire Darwin CLI check or fix

Add dictate and indicator gates to adapter selfcheck

Update macOS install resumption and progress for residual scrub

A5 pipewire PASS on Fedora QEMU with stream-measure ratio 0.998

Pull alsa-plugins-pulseaudio so Fedora arecord pulse devices work

Skip indicator check and restart when tray helper is not installed

Session-heal polls for speechlayer mix and re-bounces daemon if arecord missing

Keep speechlayer mix ensure after pulse recover when headless has no real mic

Guest-validate PULSE_SERVER unset recover on Ubuntu QEMU restart

Record Ubuntu QEMU systemd burn-in scorecard and partial gates

Unset PULSE_SERVER before pulseaudio start after kill so restart can recover

Lower TTS energy cancel so hot speaker mon no longer zeros talk-over residual

Fire residual barge on soft speaker monitor under high mic instead of hard skip

Trial barge knobs need two chunks residual 2500 and ratio thr 3.5

Require switch model to alias so bare model names stay prose

Preflight complete herdr commands in listen mode before the LLM

Fuzzy workspace match and richer voice targets for STT near-misses

Accept cubald-style client-site mishears in proper-noun rewrite

Add standalone kapish terminator model trainer

Freeze Artix Level-3 campaign work at host-gated stop-line

List single-host burn-in tickets and regression bar for adapters

Make status fix and session-heal accept pipewire-pulse without a pulseaudio process

Refuse ha commands on Darwin and route speechlayer test capture through adapters

Document A4 user units and expand Fedora dnf package list

Extend adapter-selfcheck for CLI residual gates

Add Linux adapter selfcheck covering macos force and launchd templates

Point resumption install and progress at the selfcheck regression bar

Add launchd installer so macOS templates are a real writer not just docs sed

Scaffold Windows inject HTTP shim and WSL2 platform overrides after W0

Point macos install and progress at launchd installer and Option C door

Add stream measure script with ratio and cadence gates for A5 and W0

Record Artix Pulse golden numbers for pipewire and WSLg comparison

Spell out WSLg W0 operator procedure without claiming a pass yet

Route macos beep pid check and speaker mon through adapters

Teach speechlayer CLI Darwin-safe status restart and session-heal paths

Skip the indicator cleanly when rumps is not installed

Add macOS resumption door for real macOS hardware burn-in next

Mark Option A A2 and A3 complete and fill INSTALL systemd install pointers

Document OpenRC versus systemd sudoers as mutually exclusive

Expand systemd Level 2 slices A1 to A6 and link them from INSTALL

Route speechlayer managed service control through SL_SVC without OpenRC-only copy

Write svc-backend on systemd install and sketch Fedora packages

Draft user unit and systemctl sudoers examples off by default

Spell out systemd Level 2 burn-in path unit gaps and first boot checklist

Scaffold macOS adapters for capture inject notify svc and paths

Add raw PCM capture helper that keeps the recording loop shape

Ship untested launchd templates and macOS install TCC notes

Opt-in systemd verbs via SL_SVC without auto-detecting init

Record Option B decision readiness table and half-contract review

Campaign brief for OS backends orchestrator after Phase 4 product close

Stop soft mon from free-firing ratio barge mid long readouts without killing real talk-over

Fix tts-barge set clamps that capped spk_k below real bleed and ratio thr at three

Count only real python daemon processes so supervise and grep noise stop false multi-daemon warnings

Free-wake idle gap so amber can show between turns without killing barge or wake

Seed free-wake recordings from the always-on PCM pre-roll so first words are not clipped

Mark Phase 4 executed, platform readiness table, listen free-wake idle and pre-roll notes

Stop free-wake from rearming while TTS still plays without killing barge or wake

Blank free-wake WAV during spoken acks so switching is not reheard as a new command

Drop command-shaped listen acks and herdr switch TTS plus short-window herdr dedupe

Ship always-on listen mode with CLI, rearm, intent LLM and plan executor

Show an amber listening state on the corner indicator while mode is armed

Fold known client-site mishears on every dictate herdr and phone path before routing

Document listen-mode harness files enter exit phrases and half-contract rules

Mark the OS-adapter split finished end-to-end so the plan matches the tree

Put every desktop notification under the single app name speechlayer so nothing collides with random voice daemons

Lock TTS energy-barge knobs so loud talk-over and hey speechlayer can interrupt without clipping clean playback

Age barge grace from first audio, not process start, so synthesize lag cannot burn the window

Keep a softer wake threshold even when energy barge is off so drowned speech still reaches hey speechlayer

Drop bare cancel as a cancel phrase so random prose no longer kills a recording

Prefer okay-go and kapish spelling variants for the mid-recording instant cut

Build the wake-word mic capture command through the OS adapter so the recording loop stays the same on every platform

Record and play audio through the OS adapter so capture tools can change without rewriting the scripts

Restart managed services through the OS adapter so Linux is not hard-wired into the CLI

Reclaim dead recording locks so a crashed capture cannot block the next wake forever

Let loud speech interrupt TTS playback, with knobs you can change without restarting

Treat Whisper's clipped 'her D' as 'herd d' so herd switching still works

Harden the keystroke-marker walker so unknown markers are dropped, not typed forever

Map full 'new session' phrases to /new after slash commands settle

Route every keystroke and window-focus call through the OS adapter so typing works the same on every platform

Preserve per-site xdotool flags including flag-less Escape and --delay 8 type

Revert bare 'go to <name>'; folder-noun required again (cd stays short form)

Accept bare 'go to <name>' (≤3 tokens) when not a herd/pane command

Harden folder resolve for whisper typos (client-site ≈ client-site) and TLD-ish tokens

Drop legacy project-as-herd entirely - project is filesystem-only now

Herds-and-folders.md voice cheat sheet (switch herd / folder nav / move session / resume pi)

Rebrand herdr workspaces as 'herd' (heard/workspace aliases), freeing 'project' for folder nav

Plain folder nav inside pi now exits pi then cds; only 'move session to X' uses pi /cd relocate

Add 'resume pi' -> pi -c

Add folder-navigation intent (go to folder / cd / go up|home|back) to wvd-herdr-control, zoxide-resolved, shell cd vs pi /cd

Send desktop notifications through the OS adapter so non-Linux backends can plug in

Note that notification app-names should be unified after the port, since the current ones are generic enough to clash with other apps

Record how the Linux dispatch layer was actually built, so the design matches the code

Add the per-OS dispatch layer with Linux implementations built in, ready for scripts to adopt

Add new-pane and pause keystroke macros so spoken herdr commands can open panes and let slash commands settle before submitting

Route all runtime state files through a single configurable directory instead of hardcoding /tmp

Inventory every OS-specific call site in the voice stack, grouped by adapter

Design the OS-adapter split (audio, keystrokes, notifications, services) with a step-by-step migration plan

Link the new portability design into the existing plan so the next phase is ready to start

Note that MATE hotkeys run the dconf action field not command, so a stale action still errors even when command looks right

Add scroll-in chat examples and modernize speechlayer landing page capabilities and privacy messaging

Add charming non-technical speechlayer landing page

Restructure speechlayer landing page; feature herdr voice control and TTS reply playback

Add plain-text ASCII-art landing page explaining speechlayer

Systemd StartLimitIntervalSec/Burst moved to [Unit] section (were silently ignored in [Service])

Debian/Ubuntu pkgs list drops bogus libnotify (aborted apt txn), adds python3-venv/pip + build-essential/cmake/git for whisper.cpp build

Venv installs use --no-deps so pip-freeze closures don't pull 3GB of nvidia CUDA wheels via misaki

Recreate broken venv lacking pip (failed earlier run left python3 but no pip)

Wake-word models missing is a warning not a verify failure (user-trained artifacts, not in repo)

Validated full install.sh systemd burn-in on Ubuntu 24.04 VM (all 4 units active, whisper.cpp built, transcription working)

Level-2/3 scrub - de-hardcode default install user, dual-ship systemd units

Phase 3b fully live - init.d copied, compat shims removed, full smoke matrix green

Root rename ~/scripts+~/.speechlayer -> ~/speechlayer with core/pi/net/training/media/lib subdirs

Accept 'panel' as spoken alias for pane

Phase 3a portability: SL_HOME parameterization

Phase 2 portability: install.sh + fetch-deps.sh

Phase 1 portability: system snapshots, requirements, models, INSTALL.md

Initial messy commit: ~/scripts + ~/.speechlayer as-is, pre-restructure