Dodaios is an open-source agent OS for your desktop: it runs your coding agents, browser and apps by voice or chat, on your own machine. Formerly Personal Jarvis.
Python agent-orchestrationai-agentai-coding-assistantclaude-codecoding-agentcomputer-usedesktop-applocal-firstmcppersonal-jarvisvoice-assistantvoice-coding
chore(docs): drop dangling AGENTS.md section pointers and BUGS.md references (#775)
Ruben Lütked56c44f571d4
diff --git a/.gitignore b/.gitignoreindex 6a4c02f0df..28ddd86c47 100644--- a/.gitignore+++ b/.gitignore@@ -211,7 +211,7 @@ Desktop.ini# ...except the security-github skill: RETIRED 2026-08-05. It orchestrated the# depersonalized public-release push — a staging build, a parallel clone, a# frontend build, and a sub-agent that read every tracked file hunting for-# personal data, on every push. A push is `git push` now (AGENTS.md §2). The+# personal data, on every push. A push is `git push` now. The# ignore rules stay as a tombstone so a stray local copy can never be# versioned; do not re-add the skill without the maintainer's say-so..claude/skills/security-github/@@ -450,7 +450,7 @@ docs/reports/*marketing-readiness*# The file that defines what must never be public was itself the most complete# public inventory of that data. distribution-denylist.txt has withheld# `scripts/ci/privacy_gate/**` since the build-a-snapshot era, but that era ended-# when releasing became a plain `git push` (AGENTS.md §2), so nothing filtered+# when releasing became a plain `git push`, so nothing filtered# them any more and they stayed live on the public default branch.## They remain on disk: the local pre-push docs scan and strip_and_scan.py stilldiff --git a/docs/marketplace/publishing-plan.md b/docs/marketplace/publishing-plan.mdindex b6d32c4972..229961dfd6 100644--- a/docs/marketplace/publishing-plan.md+++ b/docs/marketplace/publishing-plan.md@@ -146,7 +146,7 @@ on emitting both `plugins[]` and `skills[]`.### Path 1 — `jarvis plugin …` (the CLI) · **Recommended first**-The contract already demands it (AGENTS.md §5: a feature is a REST route+The contract already demands it (a feature is a REST routeplus an auto-CLI), the audience already has Dodaios installed, and it costszero infrastructure.diff --git a/docs/os-parity.md b/docs/os-parity.mdindex a31d98faf4..be234b51cf 100644--- a/docs/os-parity.md+++ b/docs/os-parity.md@@ -1480,8 +1480,8 @@ procedural draft grants no tool permission and activates no registry triggers.## Maintenance- Fixing a gap: remove its row (git history keeps the record).-- Landing a new Windows-only implementation: add a row (required by- AGENTS.md §3) with impact, evidence, and off-Windows behavior.+- Landing a new Windows-only implementation: add a row+ with impact, evidence, and off-Windows behavior.- Re-audit cadence: rerun the five-area sweep after any release that touchesplatform seams (`dodaios/platform/`, `dodaios/cu/actuate/`, `dodaios/vision/`,`dodaios/audio/`, `dodaios/missions/isolation/`).diff --git a/docs/screen-context.md b/docs/screen-context.mdindex d0f513f989..d44ba9196a 100644--- a/docs/screen-context.md+++ b/docs/screen-context.md@@ -78,7 +78,7 @@ handle.Screen Context sits in its own package, `dodaios/screen_context/`, above theplatform seam and below the brain. It imports platform modules; nothing in`dodaios/platform/` imports it. That direction is the 8-layer dependency rule-(AGENTS.md §5) and it is what keeps the package testable without a display.+ and it is what keeps the package testable without a display.```voice session / bar / REST / brain tool@@ -205,7 +205,7 @@ visual signal succeeded.**Ambiguity does not capture, and does not silently drop the turn either.**`AMBIGUOUS` produces a question, in the resolved output language, through theone resolver (`dodaios/core/turn_language.py`) — never a per-layer phrase table-(AGENTS.md §1). The user's next turn resolves it; a bare "yes" inside the+. The user's next turn resolves it; a bare "yes" inside theconfirmation window promotes the *previous* utterance to `SCREEN`.### 3.1 Intent classification@@ -356,7 +356,7 @@ which asks macOS once per episode; only a live grant lets the capture continue(ADR-0038, `docs/macos-permissions.md`).Every denial produces a message that names the exact setting to change and is-recoverable in-app (AGENTS.md §3) — never a stack trace, never a silent no-op.+recoverable in-app — never a stack trace, never a silent no-op.### 4.2 Privacy rules@@ -518,7 +518,7 @@ patterns on, monitor-wide denylist check, 120 s TTL, nothing on disk), and everykey remains readable and writable through the REST surface and therefore through`jarvis api screen-context get-settings|put-settings`. A settings card that asksa non-technical user to write regular expressions before a feature works is a-card they switch off instead of using; the CLI-first contract (AGENTS.md §5) is+card they switch off instead of using; the CLI-first contract iswhat makes hiding it safe rather than lossy.### Wave 5 — OCR supplement ✅ *implemented*diff --git a/docs/supply-chain/threat-model.md b/docs/supply-chain/threat-model.mdindex f49cb5fa51..352057384b 100644--- a/docs/supply-chain/threat-model.md+++ b/docs/supply-chain/threat-model.md@@ -993,7 +993,7 @@ over a failure.(`python3-xlib`, `uvloop`'s Linux wheel, etc.). Windows desktopinstalls that pass through `installer.py --with-desktop` will hit afailed `pip install --require-hashes` on those transitive deps. The- cloud-first VPS path is the binding doctrine (AGENTS.md §"Cloud-First+ cloud-first VPS path is the binding doctrine (Philosophy"); Windows desktop is a power-user extra. Wave 6.1 willship a separate `requirements-windows.txt` generated under Windowscontainerization.diff --git a/dodaios/agentic_ide/agent_transcript.py b/dodaios/agentic_ide/agent_transcript.pyindex 01a61be6c1..3e7f367b9c 100644--- a/dodaios/agentic_ide/agent_transcript.py+++ b/dodaios/agentic_ide/agent_transcript.py@@ -552,7 +552,7 @@ def _codex_first_user_text(session_id: str, home: Path | None) -> str | None:#: Which CLIs keep a record this module can read. Absence is not a failure — a#: CLI without an entry degrades to "watch the live pane", honestly and without-#: an error (AGENTS.md §3).+#: an error._READERS: dict[str, Callable[[str, Path | None], list[Turn] | None]] = {"claude": _claude_turns,"codex": _codex_turns,diff --git a/dodaios/agentic_ide/conversation.py b/dodaios/agentic_ide/conversation.pyindex 8f8b2e2d37..2e5c21faa6 100644--- a/dodaios/agentic_ide/conversation.py+++ b/dodaios/agentic_ide/conversation.py@@ -25,7 +25,7 @@ shape:Whatever language the conversation happened in is kept verbatim. It is inputDATA for the writer, not output: the brief the writer produces from it is-English like every other artifact (AGENTS.md §1).+English like every other artifact."""from __future__ import annotationsdiff --git a/dodaios/agentic_ide/fanout.py b/dodaios/agentic_ide/fanout.pyindex 2c2fa06afc..151ab60c71 100644--- a/dodaios/agentic_ide/fanout.py+++ b/dodaios/agentic_ide/fanout.py@@ -175,7 +175,7 @@ class Delivery:The spoken layer localizes from THIS, never from ``reason`` — an Englishsentence pasted into a German answer is exactly the mixed-language output- the per-turn resolver exists to prevent (AGENTS.md, runtime output+ the per-turn resolver exists to prevent (runtime outputlanguage)."""reason: str = ""diff --git a/dodaios/agentic_ide/library.py b/dodaios/agentic_ide/library.pyindex 14b4fb5d82..23d005293f 100644--- a/dodaios/agentic_ide/library.py+++ b/dodaios/agentic_ide/library.py@@ -360,7 +360,7 @@ def ensure_project(path: str | Path, *, name: str | None = None) -> Project:#: What the one project-less holder is called on screen. English because every-#: artifact is (AGENTS.md §1); it is a name, not a translated label.+#: artifact is; it is a name, not a translated label.SCRATCH_NAME = "Sessions"diff --git a/dodaios/agentic_ide/prompt_blueprint.py b/dodaios/agentic_ide/prompt_blueprint.pyindex 6d48f7ff50..4f46b24fb0 100644--- a/dodaios/agentic_ide/prompt_blueprint.py+++ b/dodaios/agentic_ide/prompt_blueprint.py@@ -61,7 +61,7 @@ made the receiving agent behave *worse*:picks the set and only that set is injected.The composed prompt is always English. The recipient is a coding agent working-in a repository whose artifacts are English (AGENTS.md §1); a prompt in the+in a repository whose artifacts are English; a prompt in thespoken language pulls same-language commit messages and comments after it. The*spoken readback* to the user is unaffected — that stays in the turn'sresolved output language.diff --git a/dodaios/agentic_ide/seat_switch.py b/dodaios/agentic_ide/seat_switch.pyindex a160d482af..a504a71ab9 100644--- a/dodaios/agentic_ide/seat_switch.py+++ b/dodaios/agentic_ide/seat_switch.py@@ -361,7 +361,7 @@ def choose_seat(if account.id in leaving or _identity(snapshot) in leaving_logins:continue# A subscription only: an API-key login bills per token, and nothing- # the user did not start may spend a key (AGENTS.md §2).+ # the user did not start may spend a key.if not snapshot.connected or snapshot.mode != "subscription":continueif is_exhausted(account.id):diff --git a/dodaios/agentic_ide/task_kind.py b/dodaios/agentic_ide/task_kind.pyindex 9196f81e90..cf9016dfea 100644--- a/dodaios/agentic_ide/task_kind.py+++ b/dodaios/agentic_ide/task_kind.py@@ -22,7 +22,7 @@ guess.The German, Spanish and European Portuguese stems here are speech-recognition *input vocabulary*:the words a person actually says when handing work to an agent. They are-matching data, not prose (see AGENTS.md §1, closed list item 3), and each such+matching data, not prose (closed list item 3), and each suchline carries an inline marker."""from __future__ import annotationsdiff --git a/dodaios/api_family_quota_state.py b/dodaios/api_family_quota_state.pyindex 6722499e05..c98b56a829 100644--- a/dodaios/api_family_quota_state.py+++ b/dodaios/api_family_quota_state.py@@ -16,7 +16,7 @@ family walk (``_api_key_family_viable``) skips the family. A successful runclears it immediately, and the cooldown self-expires so a reset cap isre-probed.-Fingerprint binding (in-app recoverability, AGENTS.md §3): the cooldown is+Fingerprint binding (in-app recoverability): the cooldown isbound to the credential that failed. Saving a NEW key in the API-Keys viewchanges the fingerprint and lifts the block instantly — no restart, no wait.A check without a current fingerprint is conservative: the cooldown holds.diff --git a/dodaios/board/bio_brain.py b/dodaios/board/bio_brain.pyindex 69e0504018..8c85fcf66c 100644--- a/dodaios/board/bio_brain.py+++ b/dodaios/board/bio_brain.py@@ -13,8 +13,7 @@ auslegen"):keeps the old bio and the next board event tries again. It never slides ontoa per-token API key.* **Key-only install** (no subscription ever connected): today's frontier- chain, unchanged, so a single-key download keeps a working bio (AGENTS.md- "any single key must work").+ chain, unchanged, so a single-key download keeps a working bio.* ``[board.bio].override_provider/override_model`` is the user's deliberatepin and is honoured as-is in both modes, even when it names a keyedprovider: it is the only way the bio bills a per-token key while adiff --git a/dodaios/brain/ack_brain/generator.py b/dodaios/brain/ack_brain/generator.pyindex 8052d1ee6e..8384f72370 100644--- a/dodaios/brain/ack_brain/generator.py+++ b/dodaios/brain/ack_brain/generator.py@@ -68,7 +68,7 @@ _TOKEN_RE = re.compile(r"\b[\w']+\b", re.UNICODE)# Back-compat re-export. This module used to own a private de/en-only# top-100-word heuristic (``_TOP_DE`` / ``_TOP_EN``), which is exactly the-# per-layer language re-derivation AGENTS.md §1 forbids: it scored the German+# per-layer language re-derivation the project rule forbids: it scored the German# ack "Moment, in Ordnung." as English (the bare token "in" was in the English# set) and dropped it, and it classified every Spanish ack containing "no" as# English and dropped that too — the user simply heard nothing. The tables are@@ -326,7 +326,7 @@ class AckGenerator:# (i) output-language sanity check. ``language`` is ALREADY this turn's# resolved output language (``resolve_output_language``, resolved once- # by the pipeline) — this layer must never re-derive it (AGENTS.md §1).+ # by the pipeline) — this layer must never re-derive it.# ``validate_output_language`` blocks only on a high-confidence# mismatch; short, ambiguous, or name-only acks come back# ``indeterminate`` and PASS. Dropping user-facing output on a languagediff --git a/dodaios/brain/ack_brain/spawn_announcement.py b/dodaios/brain/ack_brain/spawn_announcement.pyindex def0166105..85a9eabcd9 100644--- a/dodaios/brain/ack_brain/spawn_announcement.py+++ b/dodaios/brain/ack_brain/spawn_announcement.py@@ -488,7 +488,7 @@ class SpawnAnnouncementComposer:return None# ``lang`` is already this turn's resolved output language — validate# against it through the single resolver, never a local detector- # (AGENTS.md §1). Only a high-confidence mismatch rejects; an+ #. Only a high-confidence mismatch rejects; an# indeterminate verdict keeps the announcement, since staying silent on# a language guess is worse than an odd-sounding one.if validate_output_language(trimmed, resolved_language=lang).should_block:diff --git a/dodaios/brain/background_policy.py b/dodaios/brain/background_policy.pyindex 9135b3d24c..afbe0ec062 100644--- a/dodaios/brain/background_policy.py+++ b/dodaios/brain/background_policy.py@@ -18,8 +18,7 @@ connected once keeps the install in subscription mode fortreated as a key-only install again.An install that never connected a subscription is unaffected: its keys stay-usable for background work, so a single-key download keeps a working product-(AGENTS.md "any single key must work").+usable for background work, so a single-key download keeps a working product.Provider membership comes from the provider cards' billing mode, never a namelist (AP-21), so a new subscription CLI or local runtime joins by shipping adiff --git a/dodaios/brain/evidence_gate.py b/dodaios/brain/evidence_gate.pyindex fad149730a..c8b0d66baa 100644--- a/dodaios/brain/evidence_gate.py+++ b/dodaios/brain/evidence_gate.py@@ -219,7 +219,7 @@ _REFUSAL_EN: dict[str, str] = {_REFUSAL_EN_FALLBACK = "I have no data access for that right now."# Spoken Spanish voice replies (TTS-safe, deterministic). All locales are-# equal (AGENTS.md §1): a Spanish-speaking user gets the refusal in Spanish,+# equal: a Spanish-speaking user gets the refusal in Spanish,# not the English table because no Spanish one existed._REFUSAL_ES: dict[str, str] = {"calendar": "Ahora mismo no tengo acceso a tu calendario.", # i18n-allow@@ -259,7 +259,7 @@ def _refusal_language(resolved: object, text: str) -> str:"""Which language the deterministic refusal is spoken in.The turn's ALREADY-resolved output language wins outright — this module- must never re-derive it (AGENTS.md §1: one resolver,+ must never re-derive it (one resolver,``resolve_output_language``, decides for all layers). It used to sniff theutterance with a private de/en-only heuristic, so an explicit``brain.reply_language`` pin was ignored: a Spanish-pinned user asking indiff --git a/dodaios/brain/manager.py b/dodaios/brain/manager.pyindex 6893d78fc8..d359a8e840 100644--- a/dodaios/brain/manager.py+++ b/dodaios/brain/manager.py@@ -3887,7 +3887,7 @@ class BrainManager:if persona_block:parts.append(persona_block)- # User's own standing-instructions file (AGENTS.md / CLAUDE.md equivalent),+ # User's own standing-instructions file (CLAUDE.md equivalent),# named after the assistant (e.g. Assistant.md). Distinct from the persona: the# user writes personal preferences here, and the block is framed so they# refine behaviour but never override safety/confirmations. Read fresh each@@ -12037,7 +12037,7 @@ class BrainManager:return agg.text# ONE output-language resolution for every honesty phrase this turn- # (AGENTS.md §1: one resolver decides the turn for ALL layers). The two+ # (one resolver decides the turn for ALL layers). The two# guards below used to resolve separately with DIFFERENT defaults# ("de" here, DEFAULT_LOCALE there), so an undetectable turn could speak# a German evidence fallback followed by an English honesty phrase in thediff --git a/dodaios/brain/ollama_pull.py b/dodaios/brain/ollama_pull.pyindex a31a9e7067..a1bc9a2b9a 100644--- a/dodaios/brain/ollama_pull.py+++ b/dodaios/brain/ollama_pull.py@@ -114,7 +114,7 @@ class RecommendedModel:#: When a maintainer last checked the shortlist against the live library.#: Surfaced in the download panel ("Shortlist reviewed …") and enforced by#: ``tests/integration/test_ollama_catalog_is_current.py``: a review older-#: than twelve months fails the suite, because AGENTS.md §4 forbids shipping a+#: than twelve months fails the suite, because the project rule forbids shipping a#: year-old local default. Bump it in the same commit that refreshes the list.CURATED_REVIEWED_ON = datetime.date(2026, 8, 24)diff --git a/dodaios/brain/output_filter.py b/dodaios/brain/output_filter.pyindex 45cf6d87cb..db52130781 100644--- a/dodaios/brain/output_filter.py+++ b/dodaios/brain/output_filter.py@@ -197,7 +197,7 @@ TOOL_CALL_INLINE_RE = re.compile(#: its closing brace and leaves a bare "}" standing in the spoken sentence#: ("Ich öffne Spotify. }"). One level covers every envelope this codebase#: emits; deeper nesting is not expressible in a regex and is out of scope for-#: a filter that must stay regex-only (AGENTS.md §5).+#: a filter that must stay regex-only._TOOL_JSON_INNER = r"(?:[^{}]|\{[^{}]*\})"TOOL_JSON_RE = re.compile(r"\{" + _TOOL_JSON_INNER + r"*?"diff --git a/dodaios/brain/router.py b/dodaios/brain/router.pyindex 396702d287..506b08b39f 100644--- a/dodaios/brain/router.py+++ b/dodaios/brain/router.py@@ -146,7 +146,7 @@ class RouterBrain:# ------------------------------------------------------------------def _output_locale(self, utterance: str) -> str:- """The turn's output language, via the ONE resolver (AGENTS.md §1.3).+ """The turn's output language, via the ONE resolver.Anything Jarvis says to the user (clarifying questions, the tool ack,the completion marker) resolves through ``resolve_output_language``,diff --git a/dodaios/brain/wiki_relevance.py b/dodaios/brain/wiki_relevance.pyindex b1cf28c31b..3935d03a05 100644--- a/dodaios/brain/wiki_relevance.py+++ b/dodaios/brain/wiki_relevance.py@@ -44,7 +44,7 @@ is the strict coverage bar plus the framing contract, no longer a refusal tosearch. The router brain additionally holds the ``wiki-recall`` tool and canlook something up deliberately when the injected context is not enough.-Languages: the matcher carries de/en/es tokens as equal peers (AGENTS.md §1+Languages: the matcher carries de/en/es tokens as equal peers (closed-list item 3 — speech-recognition input vocabulary, matching data ratherthan prose). Input is case-, umlaut- and accent-folded before matching, sothe German and Spanish spellings of a word reach the same pattern whether ordiff --git a/dodaios/brain/wiki_relevance_vocab.py b/dodaios/brain/wiki_relevance_vocab.pyindex b665a5a921..46348b9aae 100644--- a/dodaios/brain/wiki_relevance_vocab.py+++ b/dodaios/brain/wiki_relevance_vocab.py@@ -3,7 +3,7 @@MATCHING DATA, NOT PROSE. Every token below is a fragment the speechrecogniser may literally produce, which a classifier must contain in order torecognise the corresponding utterance — the same category as the router,-navigation-intent and wake-trigger vocabularies (AGENTS.md §1, closed-list+navigation-intent and wake-trigger vocabularies (closed-listitem 3). Translating these tokens would make the gate deaf in that language.All tokens are written PRE-FOLDED: lower-case, no umlauts, no accents, sharp-sdiff --git a/dodaios/codex_app_server.py b/dodaios/codex_app_server.pyindex 46edb9cd8a..7a53de76e6 100644--- a/dodaios/codex_app_server.py+++ b/dodaios/codex_app_server.py@@ -1600,8 +1600,7 @@ def _login_required_reason_code() -> CodexSubscriptionReasonCode:On a headless Linux host the interactive browser login is impossible, soinviting it would only produce an error toast after the click — the- pre-click truth there is ``lifecycle_unavailable`` (visible degradation,- AGENTS.md §3). The same holds for a graphical Linux desktop that ships no+ pre-click truth there is ``lifecycle_unavailable`` (visible degradation). The same holds for a graphical Linux desktop that ships noterminal able to host the login for its full lifetime. An EXISTING loginstill reports ready on such hosts."""diff --git a/dodaios/control/cancel.py b/dodaios/control/cancel.pyindex e901aebf3c..9f380c8e56 100644--- a/dodaios/control/cancel.py+++ b/dodaios/control/cancel.py@@ -200,7 +200,7 @@ class KillSwitch:"""Re-publish a `KillRequested` event onto another bus.Useful when `DesktopApp._run_backend` starts a second bus- (Brain-Factory bus, see AGENTS.md) and the KillSwitch is subscribed+ (Brain-Factory bus) and the KillSwitch is subscribedonly on the UI bus. Call once at startup:async def _forward(ev):diff --git a/dodaios/core/config.py b/dodaios/core/config.pyindex 4707c36986..9822fa08de 100644--- a/dodaios/core/config.py+++ b/dodaios/core/config.py@@ -2026,7 +2026,7 @@ class JarvisAgentHarnessConfig(BaseModel):⚠️ INERT TODAY (2026-06-28): Jarvis-Agent is NOT a registered harness —there is no ``jarvis_agent`` (formerly ``openclaw``) entry-point inpyproject.toml (Welle-4 removed the subprocess- worker, ~92% hang; see docs/BUGS.md). This block is a Wave-2 schema stub:+ worker, ~92% hang). This block is a Wave-2 schema stub:setting ``enabled = true`` has NO effect — the harness cannot be dispatchedand "start a subagent" routes to ``spawn_worker`` regardless. The boot pathlogs a warning when ``enabled`` is true but the harness is unregistereddiff --git a/dodaios/core/device.py b/dodaios/core/device.pyindex 513487bdbc..fd9d73617a 100644--- a/dodaios/core/device.py+++ b/dodaios/core/device.py@@ -3,7 +3,7 @@Single source of truth for the question "which compute device may this componentuse?". Dodaios is cloud-first: the baseline user is on a headless``python:3.11-slim`` VPS with no GPU, never the maintainer's CUDA workstation-(AGENTS.md §3, ``docs/adr/0024-cpu-first-device-selection.md``). So the DEFAULT+(``docs/adr/0024-cpu-first-device-selection.md``). So the DEFAULTis always CPU, and a GPU is used only when a component BOTH (a) is EXPLICITLYasked for one via config, AND (b) has a VERIFIED capability to run it.diff --git a/dodaios/core/entry_points.py b/dodaios/core/entry_points.pyindex 2c1bc2553e..cba0c0cee9 100644--- a/dodaios/core/entry_points.py+++ b/dodaios/core/entry_points.py@@ -19,7 +19,7 @@ which is why :func:`entry_points_for` exists.Caching for the life of the process is correct rather than merely convenient:the catalogue only changes when a distribution is installed or removed, and anew entry-point does not take effect in an already-running interpreter anyway-(hence AGENTS.md §10's ``pip install -e . --no-deps`` followed by a restart).+(hence the documented ``pip install -e . --no-deps`` followed by a restart).:func:`invalidate` is provided for the one case that does need it — a test, oran in-process install that wants the next read to see new plugins.diff --git a/dodaios/core/registry.py b/dodaios/core/registry.pyindex 3dd9d52524..61ea214cf3 100644--- a/dodaios/core/registry.py+++ b/dodaios/core/registry.py@@ -78,7 +78,7 @@ def load(group: str, name: str, protocol: type[Protocol] | None = None) -> type[)ep = candidates[0]- # Plugins must not import dodaios.* (structural purity, AGENTS.md §5), yet+ # Plugins must not import dodaios.* (structural purity), yet# several read credentials straight from the OS keyring. The HOST therefore# prepares the process-wide backend before handing over: on macOS this# installs the single-vault-item wrapper (BUG-103) so a plugin's directdiff --git a/dodaios/core/review/spawns.py b/dodaios/core/review/spawns.pyindex 51c0e599fa..f4a09f0380 100644--- a/dodaios/core/review/spawns.py+++ b/dodaios/core/review/spawns.py@@ -61,7 +61,7 @@ DEFAULT_REVIEWER_BUDGET_USD = 0.05# ----------------------------------------------------------------------## Candidate names for the Jarvis-Agent worker harness, in preference order.-# ``jarvis_agent`` is the canonical name (AGENTS.md §4 rename); ``openclaw``+# ``jarvis_agent`` is the canonical name (rename); ``openclaw``# is the pre-rename back-compat alias, mirroring the# ``AliasChoices("jarvis_agent", "openclaw")`` pattern already used for the# ``[harness.jarvis_agent]`` config block (dodaios/core/config.py). Neither isdiff --git a/dodaios/core/turn_language.py b/dodaios/core/turn_language.pyindex 629f8b9492..a51f6f9f09 100644--- a/dodaios/core/turn_language.py+++ b/dodaios/core/turn_language.py@@ -808,8 +808,7 @@ def resolve_output_language(preamble, spawn announcements, every canned status / error / clarify /timeout / provider-down phrase, the deterministic Computer-Use readbacks,and the TTS voice pin — must resolve language through THIS function so no- layer can diverge from another (AGENTS.md "Runtime Output Language";- 2026-06-18 forensic).+ layer can diverge from another (2026-06-18 forensic).It is :func:`resolve_conversation_language` narrowed to the languageswith translated phrases: a supported language is itself; a languagediff --git a/dodaios/costs/cli_usage_index.py b/dodaios/costs/cli_usage_index.pyindex 5cbb882715..6b5630c0d4 100644--- a/dodaios/costs/cli_usage_index.py+++ b/dodaios/costs/cli_usage_index.py@@ -191,7 +191,7 @@ COST_READER_FOR_HARNESS: dict[str, str] = {# GLM runs the Claude Code binary against z.ai with the same config# directory, so its sessions land in ~/.claude and are read — and priced —# as Claude Code. Attributing them to z.ai needs a config dir of their own- # at spawn (docs/BUGS.md BUG-178, still open).+ # at spawn (BUG-178, still open)."glm": AGENT_CLAUDE,}HARNESSES_WITHOUT_LOCAL_TRANSCRIPT: dict[str, str] = {diff --git a/dodaios/dictation/cleanup.py b/dodaios/dictation/cleanup.pyindex cf82630467..20ac40e7aa 100644--- a/dodaios/dictation/cleanup.py+++ b/dodaios/dictation/cleanup.py@@ -48,7 +48,7 @@ from dataclasses import dataclass# i18n-allow: the tables below are speech-recognition vocabulary — the literal# German/Spanish tokens a matcher must contain to recognise a German or Spanish-# hesitation sound. Matching data, not prose (AGENTS.md §1, category 3).+# hesitation sound. Matching data, not prose (category 3).#: Hesitation sounds per language. Keys are lowercase two-letter codes.#: Multi-word entries are matched as a phrase.diff --git a/dodaios/dictation/local_preview.py b/dodaios/dictation/local_preview.pyindex 807d0168a0..d12485396f 100644--- a/dodaios/dictation/local_preview.py+++ b/dodaios/dictation/local_preview.py@@ -25,7 +25,7 @@ a model that takes 800 ms turns the preview into a lagging distraction. TheFINAL text is never produced here — it always comes from the configuredprovider, so the words that land in the user's document are the good ones.-Degrades honestly (AGENTS.md §3): on a host without ``faster_whisper`` — a base+Degrades honestly: on a host without ``faster_whisper`` — a baseor headless install — this reports unavailable and the caller falls back to thebudgeted cloud preview. No GPU is required either; the engine picks CPU and thecaller simply sees a slower preview.diff --git a/dodaios/dictation/merge.py b/dodaios/dictation/merge.pyindex 437470867d..7662ec0d08 100644--- a/dodaios/dictation/merge.py+++ b/dodaios/dictation/merge.py@@ -26,8 +26,7 @@ Chinese, Japanese, Thai, Lao, Khmer and Burmese are written without spacesbetween words, so a token-based overlap search finds nothing there and atoken-based join inserts spaces a reader of those scripts would call wrong. Thesearch falls back to characters, and the join asks the two boundary characters-whether a space belongs between them. No language is the default one-(AGENTS.md §1).+whether a space belongs between them. No language is the default one.Pure functions over strings: no model, no I/O, no configuration."""@@ -243,7 +242,7 @@ def transcript_token_count(text: str) -> int:scripts written with spaces, characters for the space-free scripts (anideograph or kana is roughly one spoken syllable). Counting a Chinesesentence as "one word" would make every Chinese transcript look truncated,- and no language is the default one (AGENTS.md §1).+ and no language is the default one."""total = 0for token in _normalize(text).split():diff --git a/dodaios/dictation/polish_client.py b/dodaios/dictation/polish_client.pyindex 8637c38af7..b804b358ae 100644--- a/dodaios/dictation/polish_client.py+++ b/dodaios/dictation/polish_client.py@@ -295,7 +295,7 @@ POLISH_FAMILIES: Final[tuple[PolishFamily, ...]] = (base_url="https://api.openai.com/v1",secret_candidates=("openai_api_key",),# ``gpt-4.1-nano`` sat here from a 2025 catalog and is more than a year- # old — never a default (AGENTS.md §3). Both ids below are the ones+ # old — never a default. Both ids below are the ones# ``dodaios.brain.model_catalog`` carries as current for this provider# and ``tests/unit/brain/test_current_model_catalogs.py`` pins, so the# wording pass and the brain cannot drift apart on what OpenAI serves.diff --git a/dodaios/dictation/polish_guards.py b/dodaios/dictation/polish_guards.pyindex ad7ff31a0d..49203f778b 100644--- a/dodaios/dictation/polish_guards.py+++ b/dodaios/dictation/polish_guards.py@@ -220,7 +220,7 @@ _META_PREFIX_RE: Final[re.Pattern[str]] = re.compile(# i18n-allow: the two non-English tables below are language-frequency DATA — the# literal German and Spanish tokens a rarity classifier must contain in order to# decide that a German or Spanish word is ordinary rather than a proper noun.-# Matching data, not prose (AGENTS.md §1, category 3), exactly like the filler+# Matching data, not prose (category 3), exactly like the filler# tables in dodaios/dictation/cleanup.py.## Only tokens of _RARE_MIN_CHARS or more are ever looked up, so short functiondiff --git a/dodaios/memory/wiki/contact_mirror.py b/dodaios/memory/wiki/contact_mirror.pyindex fc38359400..19951f410e 100644--- a/dodaios/memory/wiki/contact_mirror.py+++ b/dodaios/memory/wiki/contact_mirror.py@@ -8,7 +8,7 @@ owners, separated by HTML-comment markers:belongs to the mirror. It is rewritten verbatim on every sync.- Everything outside the block (curator-learned facts, manual notes) ispreserved byte-for-byte — clobbering it would be the classic restore-trap- bug class (docs/BUGS.md).+ bug class.Privacy rule (spec §Non-Goals): phone numbers, e-mail addresses and streetaddresses are deliberately NOT mirrored. The vault is broadly searched anddiff --git a/dodaios/missions/capacity.py b/dodaios/missions/capacity.pyindex 94a3329d8e..d2254046cc 100644--- a/dodaios/missions/capacity.py+++ b/dodaios/missions/capacity.py@@ -23,8 +23,7 @@ Who is "pinned" (subject to all of the above): an install with a realsubscription — the sticky signal :mod:`dodaios.brain.background_policy` uses forbackground work, or a positive login probe right now. An install that neverconnected a subscription keeps its cross-family fallback chain, its API keys-are its primary, and it never parks for capacity (AGENTS.md "any single key-must work", AP-22). The paid-fallback setting has no effect there.+are its primary, and it never parks for capacity (AP-22). The paid-fallback setting has no effect there.Every decision — dispatch, resume, retry, critic — goes through:func:`decide_route`.diff --git a/dodaios/missions/critic/runner.py b/dodaios/missions/critic/runner.pyindex 25c25f6eeb..9a30a7eefd 100644--- a/dodaios/missions/critic/runner.py+++ b/dodaios/missions/critic/runner.py@@ -1623,7 +1623,7 @@ class CriticRunner:# Any other provider (grok / gemini / openrouter / unset) falls back to# the direct claude critic. The Jarvis-Agent worker subprocess critic path was# removed alongside the Jarvis-Agent worker — it shared the ~92% nested-- # claude hang failure mode (see docs/BUGS.md). The direct claude CLI+ # claude hang failure mode. The direct claude CLI# path is the proven critic surface.## Use the claude critic model from `choose_critic_model` (`model`) here —diff --git a/dodaios/missions/init.py b/dodaios/missions/init.pyindex ab224c4ea4..23f71f74e0 100644--- a/dodaios/missions/init.py+++ b/dodaios/missions/init.py@@ -1619,7 +1619,7 @@ async def bootstrap_missions(# The legacy ``"subjarvis"`` kind (the legacy ``openclaw-claude`` alias /# unknown provider / unset default) routed to the Jarvis-Agent# subprocess worker, which was removed (it caused the ~92%- # nested-claude hang; see docs/BUGS.md).+ # nested-claude hang).# Open-source AP-22/AP-23: try the user's ACTUAL provider family before# the Claude last resort, so an openrouter/gemini/openai-only downloader# is not dead-ended on the absent `claude` binary. A subscriptiondiff --git a/dodaios/missions/voice/readback.py b/dodaios/missions/voice/readback.pyindex 104e26263a..889908ce88 100644--- a/dodaios/missions/voice/readback.py+++ b/dodaios/missions/voice/readback.py@@ -253,7 +253,7 @@ READBACK_TEMPLATES: Final[dict[TemplateKey, dict[Lang, list[str]]]] = { # i18n-# (2026-05-27 hardening finding #7). Keys are the reasons emitted by the# orchestrator / recovery sweep; the DE and EN sets must stay in parity.# Keyed by language CODE (str), not the render-API ``Lang`` literal: ``es`` is-# an equal supported product-surface language (AGENTS.md §1) and MUST be able+# an equal supported product-surface language and MUST be able# to carry a phrase here even though the ``MissionReadback`` render methods# themselves still default to the de/en ``Lang`` surface (widening that whole# API to ``es`` is a separate, larger task). Lookups use ``.get(language, {})``diff --git a/dodaios/missions/workers/provider_chain.py b/dodaios/missions/workers/provider_chain.pyindex 1cc5873feb..76b1c08927 100644--- a/dodaios/missions/workers/provider_chain.py+++ b/dodaios/missions/workers/provider_chain.py@@ -307,7 +307,7 @@ def _build_worker_cmd(the worker class this argv fed was deleted with the direct-workermigration; only ``tests/missions/test_provider_chain_argv.py`` and thespike script still exercise it. Kept as read-compat surface per the- AGENTS.md §4 glossary (do not delete together with the aliases).+ the project glossary (do not delete together with the aliases).`binary` accepts either a single executable path (legacy contract,used by existing tests that pin one string) or the full argv prefixdiff --git a/dodaios/plugins/stt/fwhisper.py b/dodaios/plugins/stt/fwhisper.pyindex 694838609b..55ca90f999 100644--- a/dodaios/plugins/stt/fwhisper.py+++ b/dodaios/plugins/stt/fwhisper.py@@ -209,7 +209,7 @@ _CUDA_DLL_PACKAGE_DIRS: Final[tuple[tuple[str, tuple[str, ...]], ...]] = (#: together) and installed from inside the app by#: :func:`dodaios.speech.local_install.start_gpu_libraries_install`, because a#: GPU that the app cannot reach is not something a person should have to fix-#: in a terminal (AGENTS.md §2, credentials-and-capabilities recoverable in-app).+#: in a terminal (credentials-and-capabilities recoverable in-app).GPU_LIBRARY_PACKAGES: Final[tuple[str, ...]] = ("nvidia-cublas-cu12>=12.4,<13","nvidia-cudnn-cu12>=9,<10",diff --git a/dodaios/plugins/stt/groq_api.py b/dodaios/plugins/stt/groq_api.pyindex b7bb648d45..008f3191a4 100644--- a/dodaios/plugins/stt/groq_api.py+++ b/dodaios/plugins/stt/groq_api.py@@ -309,7 +309,7 @@ class GroqWhisperAPI:# RuntimeError. This plugin deliberately does NOT raise that# shared type — it is the one STT plugin held to a total# ``dodaios.*``-import ban outside its own plugin package- # (AGENTS.md §5, pinned by tests/contract/test_stt_protocol.py).+ # (pinned by tests/contract/test_stt_protocol.py).# It already emits the classifiable shape, so there is nothing to# gain and a purity contract to lose. Do not "unify" this line.# (Never start a comment line here with ``# type:`` — mypy readsdiff --git a/dodaios/plugins/stt/transcript_filter.py b/dodaios/plugins/stt/transcript_filter.pyindex f18e4af839..2f411ce557 100644--- a/dodaios/plugins/stt/transcript_filter.py+++ b/dodaios/plugins/stt/transcript_filter.py@@ -153,7 +153,7 @@ _WORD_RE = re.compile(r"\w+", re.UNICODE)# i18n-allow: the table below is speech-recognition vocabulary — the literal# tokens a matcher must contain to recognise a mis-transcription. Matching-# data, not prose (AGENTS.md §1, category 3).+# data, not prose (category 3).#: Known mis-transcriptions, per language. Replacement is whole-word and#: case-insensitive; the replacement inherits nothing from the source casing.diff --git a/dodaios/plugins/tool/create_artifact.py b/dodaios/plugins/tool/create_artifact.pyindex 57205e4da4..dc7f5bc0eb 100644--- a/dodaios/plugins/tool/create_artifact.py+++ b/dodaios/plugins/tool/create_artifact.py@@ -83,7 +83,7 @@ def _turn_language(ctx: Any, args: dict[str, Any]) -> str:The turn's resolved output language wins (stamped by the tool-use loop via``resolve_output_language``); the brain's own ``language`` guess is next;the ambient answer last. This layer never re-derives a language from the- utterance (AGENTS.md §2).+ utterance."""config = getattr(ctx, "config", None)stamped = ""diff --git a/dodaios/plugins/tool/delegate_to_agent.py b/dodaios/plugins/tool/delegate_to_agent.pyindex 8d74ae5fa0..8e47e9638c 100644--- a/dodaios/plugins/tool/delegate_to_agent.py+++ b/dodaios/plugins/tool/delegate_to_agent.py@@ -58,7 +58,7 @@ def _lang(args: dict[str, Any], ctx: Any) -> str:"""The turn's output language: ``ctx.config["output_language"]`` as thetool-use loop stamps it (decided once per turn by ``turn_language.py``),else a ``turn_language`` argument, else the ambient answer language. This- layer never re-derives a language from the utterance (AGENTS.md §1)."""+ layer never re-derives a language from the utterance."""config = getattr(ctx, "config", None) or {}value = (str(diff --git a/dodaios/plugins/tool/profile_update.py b/dodaios/plugins/tool/profile_update.pyindex e89048591a..ad69a1f2ca 100644--- a/dodaios/plugins/tool/profile_update.py+++ b/dodaios/plugins/tool/profile_update.py@@ -43,7 +43,7 @@ log = logging.getLogger(__name__)# Canonical field allow-list per cluster. The tool refuses fields outside this# map so the brain cannot write fields the Knowledge matrix never renders (that-# would be silent multi-layer enum drift — BUG-008 class, AGENTS.md §recurring+# would be silent multi-layer enum drift — BUG-008 class# bugs #2). It must stay BYTE-FOR-BYTE in sync with ProfileView.tsx's# CLUSTER_FIELD_KEYS (the UI is the authority for what is visible). The parity is# pinned by test_profile_update.py::test_canonical_fields_match_matrix_ui.diff --git a/dodaios/plugins/tool/spawn_worker.py b/dodaios/plugins/tool/spawn_worker.pyindex ad5b354e48..a20054240a 100644--- a/dodaios/plugins/tool/spawn_worker.py+++ b/dodaios/plugins/tool/spawn_worker.py@@ -59,8 +59,7 @@ def _readback_lang(turn_language: str | None) -> str:The turn's resolved output language wins (stamped by the tool-use loop via``resolve_output_language`` — see ``execute``). Only when the turn carriesnone does this fall back to the ambient answer (reply-language pin →- default locale); this layer never re-derives a language from the utterance- (AGENTS.md §1).+ default locale); this layer never re-derives a language from the utterance."""lang = (turn_language or "").strip().lower()return lang or resolve_ambient_language()diff --git a/dodaios/realtime/session.py b/dodaios/realtime/session.pyindex 255a84a064..4dd4c4a4da 100644--- a/dodaios/realtime/session.py+++ b/dodaios/realtime/session.py@@ -1459,7 +1459,7 @@ _DELEGATE_BRIDGE_TEXTS: dict[str, tuple[str, ...]] = i18n_catalog.variant_table(#: Why the call is ending when NO voice engine could be opened. Carries every#: supported locale, resolved through the session's one language resolver-#: (AGENTS.md §1 runtime rule 3) — never a de/en-only table and never a+#: — never a de/en-only table and never a#: per-layer default. Deliberately two distinct causes rather than one generic#: apology: "it did not come up in time" and "it could not be reached" send the#: user to different places, and the whole point of speaking here is that the@@ -1519,7 +1519,7 @@ def _pick_delegate_bridge_text(language: str) -> str:#: abandoned. One short, honest sentence: the user needs to know the work#: stopped, because a silent cancellation is indistinguishable from a session#: that simply ignored them — which is the failure this whole path exists to-#: end. Same locale coverage as every other runtime pool (AGENTS.md §1).+#: end. Same locale coverage as every other runtime pool._INTERRUPT_ACK_TEXTS: dict[str, tuple[str, ...]] = i18n_catalog.variant_table("realtime.interrupt_ack_texts")@@ -2839,7 +2839,7 @@ class RealtimeVoiceSession:utterance it was computed for.Every ``[skills]`` knob travels with it. Reading only some of the- section is a silent config switch (AGENTS.md §7).+ section is a silent config switch."""key = str(text or "").strip()if not key:diff --git a/dodaios/runs/analyzer.py b/dodaios/runs/analyzer.pyindex ab6b26cf6e..c03f22b239 100644--- a/dodaios/runs/analyzer.py+++ b/dodaios/runs/analyzer.py@@ -47,7 +47,7 @@ from dodaios.sessions.models import VoiceEventRow, VoiceSessionRow# Per-phase SLO budget in ms. Phases not listed have no gate (always SLO_OK).# Budgets mirror the documented voice SLOs: wake->ACK < 1.2s, intent->ACK < 3.0s,-# router decision < 150ms (AGENTS.md "Optimistic Execution").+# router decision < 150ms._PHASE_SLO_MS: dict[str, float] = {"intent_decision": 150.0,"ack_first_audio": 1200.0,diff --git a/dodaios/screen_context/intent.py b/dodaios/screen_context/intent.pyindex 5fd8a39741..699e70867a 100644--- a/dodaios/screen_context/intent.py+++ b/dodaios/screen_context/intent.py@@ -13,7 +13,7 @@ call and no network. An LLM classifier here would sit on the voice path (AP-9),and it would make "did it look at my screen, and why?" unanswerable after thefact — ``IntentVerdict.evidence`` exists so that question always has an answer.-**Every supported locale is equal** (AGENTS.md §1): de, en, es and pt are matched+**Every supported locale is equal**: de, en, es and pt are matchedsimultaneously rather than selected by the session locale, because a bilingualuser mixes them inside one sentence and a locale-gated matcher would go deaf onthe half it did not pick. Adding a locale is a data entry below, not code.@@ -207,7 +207,7 @@ _END = r"\s*(?:$|[.?!;:])"# Filler particles a spoken deictic may trail before the clause ends. These are# the only tokens allowed between the pronoun and the end — anything else makes-# it a determiner. Matching data, not prose (AGENTS.md §1 category 3).+# it a determiner. Matching data, not prose._EN_TAIL = r"(?:\s+(?:then|exactly|now|again|here|there|really))*"_DE_TAIL = ( # i18n-allow: German speech-input matching datar"(?:\s+(?:denn|eigentlich|jetzt|gerade|genau|nochmal|noch\s+mal"@@ -734,7 +734,7 @@ def classify(text: str, *, locale: str = "") -> IntentVerdict:# One entry per supported locale, keyed by the BCP-47 base tag. Adding a locale# means adding a line here AND to the matcher above — never a de/en-only table-# (AGENTS.md §1.3). The phrasing is deliberately a yes/no question about+#. The phrasing is deliberately a yes/no question about# looking, so a bare "yes" in the next turn is a complete answer.# i18n-allow: this IS the runtime multilingual product surface (§1 category 1)_CLARIFY_QUESTION: dict[str, str] = {diff --git a/dodaios/screen_context/service.py b/dodaios/screen_context/service.pyindex 386f82713a..55b7d4f520 100644--- a/dodaios/screen_context/service.py+++ b/dodaios/screen_context/service.py@@ -382,7 +382,7 @@ class ScreenContextService:``locale`` must be the ALREADY-RESOLVED output language for this turn(``dodaios.core.turn_language.resolve_output_language``). This servicenever derives a language itself — a second derivation is exactly the- mid-session language flip AGENTS.md §1.3 forbids.+ mid-session language flip the project rule forbids.``force`` skips classification for callers that are not a conversationturn (the REST endpoint, an explicit bar button). It never skipsdiff --git a/dodaios/screen_context/turn.py b/dodaios/screen_context/turn.pyindex d7b8b5ae6a..6c43c170b6 100644--- a/dodaios/screen_context/turn.py+++ b/dodaios/screen_context/turn.py@@ -240,7 +240,7 @@ async def screen_context_for_turn(``locale`` must already be resolved via``dodaios.core.turn_language.resolve_output_language`` — this function neverderives a language, so a clarifying question cannot flip the conversation's- language mid-session (AGENTS.md §1.3).+ language mid-session.An appshot waiting for the next message (``dodaios.appshot``) is thisturn's picture, unless the utterance asks for a fresh appshot. Automateddiff --git a/dodaios/screen_context/uitext.py b/dodaios/screen_context/uitext.pyindex 28ba59cd36..c732e03fa3 100644--- a/dodaios/screen_context/uitext.py+++ b/dodaios/screen_context/uitext.py@@ -14,7 +14,7 @@ OCR therefore runs only when all three hold simultaneously:* a backend is actually installed.That last condition is why OCR is not a dependency. The base install stays-torch-free (AGENTS.md §3), so this module *probes* for a backend and degrades+torch-free, so this module *probes* for a backend and degradeswith a named reason when there is none — it never pulls one in."""from __future__ import annotationsdiff --git a/dodaios/self_build/code/builder.py b/dodaios/self_build/code/builder.pyindex 8021bdae67..4d79701392 100644--- a/dodaios/self_build/code/builder.py+++ b/dodaios/self_build/code/builder.py@@ -246,7 +246,7 @@ def compose_prompt("- Keep the change as small as the issue needs, and add or update tests for it.","- Follow the repository's own instruction files shown in the brief.","- Do not touch CI config (.github and the like), deployment, secrets, .env files or "- "the instruction files (AGENTS.md, CLAUDE.md). A change that does is thrown away.",+ "the instruction files (CLAUDE.md). A change that does is thrown away.","- Do not push, open pull requests, comment on GitHub, change git remotes or switch ""branches; Dodaios checks your work and does that.","- Run the tests before you finish; they must pass: " + "; ".join(tests) + ".",diff --git a/dodaios/sessions/models.py b/dodaios/sessions/models.pyindex d10f6c2a11..1b4c472c48 100644--- a/dodaios/sessions/models.py+++ b/dodaios/sessions/models.py@@ -46,7 +46,7 @@ KNOWN_HANGUP_REASONS: frozenset[str] = frozenset()"""Known ``VoiceSessionEnded.hangup_reason`` values. Extend when thespeech pipeline introduces a new value — tests catch drift, not-Pydantic. See ADR-0009 / BUGS.md BUG-008 for history."""+Pydantic. See ADR-0009 for history."""HangupReason: TypeAlias = str"""Corresponds to ``VoiceSessionEnded.hangup_reason`` (events.py).diff --git a/dodaios/setup/prefetch.py b/dodaios/setup/prefetch.pyindex 844dba14a0..f03b43b5f5 100644--- a/dodaios/setup/prefetch.py+++ b/dodaios/setup/prefetch.py@@ -8,7 +8,7 @@ models are needed.Every step is best-effort: a failed download prints an honest note and theruntime's lazy download remains the safety net — a flaky mirror must never-brick an install (AGENTS.md section 3). Works headless: no audio device,+brick an install. Works headless: no audio device,GPU, or keyring is touched, only the on-disk model caches."""from __future__ import annotationsdiff --git a/dodaios/skills/builtin/dodaios-doc-author/references/templates.md b/dodaios/skills/builtin/dodaios-doc-author/references/templates.mdindex 1b6c986c41..f0746e34e9 100644--- a/dodaios/skills/builtin/dodaios-doc-author/references/templates.md+++ b/dodaios/skills/builtin/dodaios-doc-author/references/templates.md@@ -116,7 +116,7 @@ related:## Verification # REQUIRED<Concrete test confirming the steps succeeded. Verify-before-ship-mandate from AGENTS.md §0.>+project mandate>```bashpytest tests/<file>::<test_name>@@ -428,7 +428,7 @@ mandates):| ID | Anti-pattern | Why it's bad ||---|---|---|-| **AP-J-1** | **How-to without a verification section** | Violates the verify-before-ship mandate (AGENTS.md §0). The doc delivers steps but no test. |+| **AP-J-1** | **How-to without a verification section** | Violates the verify-before-ship mandate. The doc delivers steps but no test. || **AP-J-2** | **Germanized code identifier** ("der Hirn-Verwalter" instead of ``BrainManager``) | Breaks the user preference. Identifiers are standard Python English. || **AP-J-3** | **Voice example without a language tag** ("Jarvis, mach X" — without a hint whether DE or EN) | Bilingual default means both are equivalent — the example must be clearly attributed. || **AP-J-4** | **TODO/FIXME/TBD in the body when ``status: active``** | If it's a stub: ``status: draft`` in the frontmatter — otherwise the status lies. |diff --git a/dodaios/skills/relevance.py b/dodaios/skills/relevance.pyindex fa3fbfdb88..73117f9b7a 100644--- a/dodaios/skills/relevance.py+++ b/dodaios/skills/relevance.py@@ -251,7 +251,7 @@ def normalize_text(text: str) -> str:#: Cyrillic, Greek, Hebrew, Arabic or CJK, so every fuzzy name lookup below#: failed closed for those scripts and a skill authored by voice in such a#: language was reachable only by its exact key — the very BUG-158 failure,-#: left open for most of the world. All locales are equal (AGENTS.md §1).+#: left open for most of the world. All locales are equal._NAME_TOKEN_RE = re.compile(r"[^\W_]+", re.UNICODE)diff --git a/dodaios/speech/interrupt_intent.py b/dodaios/speech/interrupt_intent.pyindex fba7950a1e..b4daf742cb 100644--- a/dodaios/speech/interrupt_intent.py+++ b/dodaios/speech/interrupt_intent.py@@ -23,7 +23,7 @@ Design rulesmodel call here would add exactly the latency barge-in exists to remove(AP-9/AP-11), and prompt compliance is not a correctness boundary(BUG-047 class rule).-* **Every locale equal** (AGENTS.md §1). German, English and Spanish carry the+* **Every locale equal**. German, English and Spanish carry thesame vocabulary depth; adding a locale means adding its tokens, neverspecial-casing a "default" language.* **Whole-utterance anchored.** A stop token only counts at the START of thediff --git a/dodaios/speech/local_models.py b/dodaios/speech/local_models.pyindex 28a8d3134f..13306e7325 100644--- a/dodaios/speech/local_models.py+++ b/dodaios/speech/local_models.py@@ -15,7 +15,7 @@ independent facts a local path needs:* **engine** — is the inference runtime importable in THIS interpreter(``faster_whisper`` / ``sherpa_onnx``)? Both are opt-in extras the cloud-first- base install deliberately omits (AGENTS.md section 3), so on a fresh install+ base install deliberately omits, so on a fresh installthe honest answer is "no".* **model** — are the weights on disk? An installed engine with no weights isnot readiness; it is a download away from it, and saying so is the whole@@ -490,7 +490,7 @@ WHISPER_VOICE_MODEL = "large-v3"#: pip requirement for the CTranslate2-backed Whisper engine. Torch-free,#: cross-platform wheels; the cloud-first base install omits it on purpose-#: (AGENTS.md section 3), which is why it can be installed from inside the app.+#:, which is why it can be installed from inside the app.FASTER_WHISPER_PACKAGE = "faster-whisper>=1.0"#: pip requirement for the ONNX-Runtime speech stack (Apache-2.0, torch-free,diff --git a/dodaios/speech/pipeline.py b/dodaios/speech/pipeline.pyindex 7851c879d9..1e124bea3d 100644--- a/dodaios/speech/pipeline.py+++ b/dodaios/speech/pipeline.py@@ -473,7 +473,7 @@ _REALTIME_UNAVAILABLE_PHRASE: dict[str, str] = i18n_catalog.table("speech.realti# Honest, cause-aware messaging (live complaint 2026-06-30). The old single# phrase ("Sorry, I couldn't finish the answer in time.") explained NOTHING:# a slow MCP/plugin tool hung ~35 s, the turn timed out, and Jarvis apologised-# for "taking too long" with no reason. Honesty over guessing (AGENTS.md §1.4):+# for "taking too long" with no reason. Honesty over guessing:# • TOOL-STALL — the turn was beheaded mid-tool-loop (no first audio frame,# i.e. the assistant was blocked waiting on a tool/stage that never# returned) OR a desktop (computer_use) tool was demonstrably active when@@ -485,7 +485,7 @@ _REALTIME_UNAVAILABLE_PHRASE: dict[str, str] = i18n_catalog.table("speech.realti# Both are short, TTS-clean (``_speak`` does not scrub — no em-dash, two short# sentences), and carry all supported locales (de/en/es/pt). String-only: NO LLM# call in this timeout/scrub path (AP-11). Resolved through the ONE output--# language decision via ``_resolve_timeout_phrase`` below (AGENTS.md §1 — no+# language decision via ``_resolve_timeout_phrase`` below (— no# per-layer language re-derivation)._TIMEOUT_TOOL_STALL_PHRASE: dict[str, str] = i18n_catalog.table("speech.timeout_tool_stall")@@ -564,7 +564,7 @@ def _resolve_timeout_phrase(site: str, lang: str, *, tool_active: bool) -> str:"""Pick the honest, cause-aware timeout phrase for ``site``.Resolves language through the ONE shared decision (``_phrase_lang``) — never- a per-layer re-derivation (AGENTS.md §1). String-only, no LLM call (AP-11).+ a per-layer re-derivation. String-only, no LLM call (AP-11).Names a tool cause when the turn was beheaded mid-tool-loop (no first frame)or a desktop tool was active; otherwise honestly admits no answer was found."""@@ -1129,7 +1129,7 @@ def resolve_dictation_language(*, pinned: str, reported: str, text: str) -> str:text while the setting said the cleanup was on.Everything resolves through the canonical resolver's helpers — no layer- invents its own detection (AGENTS.md §1).+ invents its own detection."""pin = str(pinned or "").strip().lower()if pin not in ("", "auto"):@@ -1140,7 +1140,7 @@ def resolve_dictation_language(*, pinned: str, reported: str, text: str) -> str:# Points 2 and 3 above live in the canonical resolver, which the voice# lane's transcript filter reads too — one decision, not two copies- # that drift the first time either is touched (AGENTS.md §1).+ # that drift the first time either is touched.code = resolve_transcript_language(tag, text)if code != "unknown":if code != normalize_language_tag(tag):@@ -11373,7 +11373,7 @@ class SpeechPipeline:**Every refusal is announced**, not just logged: each one publishes a``DictationRefused`` carrying a stable reason token and a finishedEnglish sentence. Before that, a refused shortcut produced a- ``log.info`` in a file the desktop app cannot display (AGENTS.md §9), so+ ``log.info`` in a file the desktop app cannot display, sothe key simply did nothing and the user had no way to learn why. Theboolean return is unchanged, so every existing caller (hotkey edge, WShandler, REST route) keeps working; ``True`` from the handover path@@ -17199,7 +17199,7 @@ class SpeechPipeline:returncleaned = scrubbed.cleaned.strip()if not cleaned:- # Never swallow output silently (AGENTS.md §7): the answer+ # Never swallow output silently: the answer# loses a clause here, so the drop has to be visible.dropped_sentences.append(sentence)log.warning(diff --git a/dodaios/ui/web/agentic_ide_routes.py b/dodaios/ui/web/agentic_ide_routes.pyindex be919434f8..d86cba2d70 100644--- a/dodaios/ui/web/agentic_ide_routes.py+++ b/dodaios/ui/web/agentic_ide_routes.py@@ -5791,7 +5791,7 @@ def _tool_model_option() -> PromptWriterOption:)# Plain ASCII separator: this label is rendered in the desktop UI but also# printed by `jarvis api agentic-ide prompt-writer`, and a terminal's- # encoding is not ours to assume (AGENTS.md §5, Windows defaults to cp1252).+ # encoding is not ours to assume (Windows defaults to cp1252).detail = f"{_provider_label(provider)}"if model:detail = f"{detail} - {model}"diff --git a/dodaios/ui/web/chat_library_routes.py b/dodaios/ui/web/chat_library_routes.pyindex 3324ea0827..de9da7a6e1 100644--- a/dodaios/ui/web/chat_library_routes.py+++ b/dodaios/ui/web/chat_library_routes.py@@ -23,8 +23,7 @@ Neither does any of this return message CONTENT. A chat row is a title, anagent, a timestamp and a one-line preview; opening the conversation is aseparate call against the coding CLI's own transcript. So this router has noBrain dependency, no session dependency and no filesystem cost beyond a few-small JSON reads — it works headless and on a fresh install with no keys at all-(AGENTS.md §3).+small JSON reads — it works headless and on a fresh install with no keys at all.``exists`` on a project is reported rather than acted on. A folder can bemissing because an external drive is unplugged or a network share is late, anddiff --git a/dodaios/ui/web/dictation_routes.py b/dodaios/ui/web/dictation_routes.pyindex 49c1ca7736..e415ee3f37 100644--- a/dodaios/ui/web/dictation_routes.py+++ b/dodaios/ui/web/dictation_routes.py@@ -24,7 +24,7 @@ sidecar with them — a "deleted" dictation the app still holds a recording ofwould be a quiet lie.Why REST and not only the WebSocket command the chat mic button uses: under the-CLI-first contract (AGENTS.md §5) a capability that exists only in the UI is not+CLI-first contract a capability that exists only in the UI is notfinished. Mounting this router also makes every action a``jarvis api dictation <op>`` command for free — and *that* is the documentedfallback on Wayland, where the compositor owns global shortcuts and the app@@ -406,7 +406,7 @@ class StartBody(BaseModel):description=(# No assistant name here on purpose: this description is served in# /docs and in the generated CLI help, and a user-visible string- # never carries a fixed brand (AGENTS.md §4). The sentence is about+ # never carries a fixed brand. The sentence is about# this app's own window, so it needs no name at all."auto = follow [dictation].target (insert, unless this app's own ""window is the one in front); insert = always paste into the app "diff --git a/dodaios/ui/web/dictionary_routes.py b/dodaios/ui/web/dictionary_routes.pyindex af6f902a4f..7c62e4e58b 100644--- a/dodaios/ui/web/dictionary_routes.py+++ b/dodaios/ui/web/dictionary_routes.py@@ -13,7 +13,7 @@ An entry is one canonical ``word`` plus optional ``misheard`` variants — seecorrector live-reloads on file change), so no restart is required.Like the Contacts/Socials endpoints this router has **no Brain dependency**,-so it works headless / with MockBrain (open-source universality, AGENTS.md §3).+so it works headless / with MockBrain (open-source universality)."""from __future__ import annotationsdiff --git a/dodaios/ui/web/screen_context_routes.py b/dodaios/ui/web/screen_context_routes.pyindex 02d346c125..ca90a1aea1 100644--- a/dodaios/ui/web/screen_context_routes.py+++ b/dodaios/ui/web/screen_context_routes.py@@ -11,8 +11,7 @@ Endpoints (mounted by the WebServer in ``_build_app()``):GET /api/screen-context/settings → the [screen_context] block.PUT /api/screen-context/settings → change one or more keys.-Why REST and not only an internal service: under the CLI-first contract-(AGENTS.md §5) a capability that exists only inside the voice path is not+Why REST and not only an internal service: under the CLI-first contract a capability that exists only inside the voice path is notfinished. Mounting this router makes every action a``jarvis api screen-context <op>`` command, which is also how the feature isverified on a machine with no display — ``status`` answers honestly instead ofdiff --git a/dodaios/ui/web/server.py b/dodaios/ui/web/server.pyindex 18f34f5857..375bc0f487 100644--- a/dodaios/ui/web/server.py+++ b/dodaios/ui/web/server.py@@ -652,7 +652,7 @@ class WebServer:# dodaios/ui/web/update_routes.py; refuses to self-reset a dev checkout.app.include_router(update_router)# Share-safe cross-device setup report (read-only) — names why THIS- # install behaves differently from another device (AGENTS.md §3 triage).+ # install behaves differently from another device (triage).app.include_router(setup_report_router)# Starter plans + the one-time "all set" readiness note.app.include_router(starter_plan_router)diff --git a/dodaios/ui/web/settings_routes.py b/dodaios/ui/web/settings_routes.pyindex 24895f4eac..f9eafa8d3b 100644--- a/dodaios/ui/web/settings_routes.py+++ b/dodaios/ui/web/settings_routes.py@@ -613,7 +613,7 @@ async def put_ui_language(body: UiLanguageBody, request: Request) -> dict[str, o# painted from config BEFORE the web view loads anything (a light app inside a# black frame is visible for the whole boot), the choice must survive a cleared# web store, and every user-facing action in this project ships as a REST route-# so it becomes a `jarvis api settings ...` command (AGENTS.md §5, CLI-first).+# so it becomes a `jarvis api settings ...` command (CLI-first).## "system" is stored as intent, not as a resolved value: the frontend re-reads# the OS preference live, so flipping the OS theme flips the app with it.@@ -855,7 +855,7 @@ def put_music_settings(body: MusicSettingsBody, request: Request) -> dict[str, o# The accepted set is EVERY language the recogniser understands, shared with# dictation through one constant (AP-4): what Jarvis can hear is a wider question# than the three locales it speaks back in, and capping it at those three locked-# out every other speaker on earth (AGENTS.md §3).+# out every other speaker on earth.# ----------------------------------------------------------------------_STT_LANGUAGES: tuple[str, ...] = RECOGNITION_LANGUAGE_CHOICES@@ -1286,7 +1286,7 @@ def _local_speech_ready() -> bool:# ``faster-whisper`` powers the ``stt_match`` wake path — the ONLY local way to# detect an arbitrary, user-invented wake phrase. It is a torch-FREE opt-in# package (ctranslate2 CPU wheels, cross-platform) that the cloud-first base-# install deliberately omits (AGENTS.md §3). Historically it was dropped from+# install deliberately omits. Historically it was dropped from# every extra (2026-05-18, "Groq Whisper API is the new default"), so a fresh# install could not use a custom wake word at all and silently degraded to the# bundled "Hey Rhasspy" model. This endpoint pulls the package from INSIDE the@@ -1705,7 +1705,7 @@ def set_wake_activation(body: WakeActivationBody, request: Request) -> dict[str,async def download_wake_model(request: Request) -> dict[str, object]:"""Provision (or repair) the per-language Vosk wake model in-app.- Recoverable-in-app contract (AGENTS.md §3): a user whose Vosk model is+ Recoverable-in-app contract: a user whose Vosk model isabsent/dead gets a working reliable wake engine without editing jarvis.toml.Never 500s on a fetch failure — returns a clear message and the runtime lazynet (``_heavy_backend_bg``'s one-shot provision) remains the backstop.diff --git a/dodaios/ui/web/setup_report_routes.py b/dodaios/ui/web/setup_report_routes.pyindex abede07395..00a4347192 100644--- a/dodaios/ui/web/setup_report_routes.py+++ b/dodaios/ui/web/setup_report_routes.py@@ -1,6 +1,6 @@"""Cross-device setup report — makes "why is THIS install different?" a 2-minute read.-The most expensive cross-device misdiagnosis (AGENTS.md §3, device-parity+The most expensive cross-device misdiagnosis (device-paritytriage ritual): a feature "missing" on a second machine is usually not a codebug but an invisible setup difference — a key that exists only on the dev box,a tier that quietly crossed to a fallback family, a wake word never set.diff --git a/dodaios/ui/web/workspace_clis_routes.py b/dodaios/ui/web/workspace_clis_routes.pyindex d63abb0ccd..b84a68cead 100644--- a/dodaios/ui/web/workspace_clis_routes.py+++ b/dodaios/ui/web/workspace_clis_routes.py@@ -15,7 +15,7 @@ Mount alongside the other routers::this app will start in a terminal. That is exactly what the user is asking forwhen they type it into the form themselves — and exactly what must not happenbecause a model decided it would be helpful. The metadata keeps the generated-CLI and the tool broker asking first (AGENTS.md §5, AP-14).+CLI and the tool broker asking first (AP-14)."""from __future__ import annotationsdiff --git a/dodaios/ui/window_watchdog.py b/dodaios/ui/window_watchdog.pyindex ad8517521e..e55f3a7719 100644--- a/dodaios/ui/window_watchdog.py+++ b/dodaios/ui/window_watchdog.py@@ -345,7 +345,7 @@ class BlankWindowPolicy:# ---------------------------------------------------------------------------#: One entry per reason per language. German, Spanish, Chinese and Portuguese are product surface-#: (AGENTS.md §1): this page is shown TO the user, and it cannot reach the+#:: this page is shown TO the user, and it cannot reach the#: bundle's i18n — the bundle is exactly what failed to load. The language is#: picked in the page from ``navigator.language``, the same way#: ``frontend/index.html`` picks it, so both blank-window paths speak alike.diff --git a/dodaios/voice/action_phrases.py b/dodaios/voice/action_phrases.pyindex 88eb8342a8..3071f0c955 100644--- a/dodaios/voice/action_phrases.py+++ b/dodaios/voice/action_phrases.py@@ -64,7 +64,7 @@ def resolve_ambient_language() -> str:no user utterance to detect a language from, so the ONE resolver is fed theonly honest inputs there are: the explicit ``brain.reply_language`` pin, andotherwise ``DEFAULT_LOCALE``. This layer never guesses beyond that- (AGENTS.md §1 — one resolver decides, no layer re-derives). Mirrors+ (— one resolver decides, no layer re-derives). Mirrors``dodaios/cu/indicator/controller.py::_resolve_hint_language``, which needsthe same answer for the same reason."""@@ -273,7 +273,7 @@ def _is_speakable_observation(text: str | None) -> bool:#: Failure families OUR OWN tools emit, mapped to a spoken sentence per-#: language. Tool error strings are English by contract (AGENTS.md §1: the+#: language. Tool error strings are English by contract (the#: model rephrases them for the user), but the rephrasing model is not always#: there — no ``[ack_brain]`` provider, a dead key, an exhausted quota, the#: breaker open. Live 2026-08-20: the Gemini flash slot answered 404 (stalediff --git a/dodaios/voice/instant_ack.py b/dodaios/voice/instant_ack.pyindex a75d8f5bb7..3fb9eda01f 100644--- a/dodaios/voice/instant_ack.py+++ b/dodaios/voice/instant_ack.py@@ -32,7 +32,7 @@ Design constraints, each of which killed an earlier attempt:canned "On it." — so the ACTION pool is deliberately empty and the classis marked ``contextual``.-German/Spanish/Portuguese strings below are runtime voice output (AGENTS.md §1).+German/Spanish/Portuguese strings below are runtime voice output."""from __future__ import annotations@@ -227,7 +227,7 @@ _POOLS: dict[WorkClass, dict[str, tuple[str, ...]]] = {),},# ``{agent}`` is the wake-word-derived agent brand ("<Name>-Agent"),- # rendered by the caller — never a hardcoded product name (AGENTS.md §4).+ # rendered by the caller — never a hardcoded product name.WorkClass.MISSION: {"de": ( # i18n-allow: localized runtime voice output"Das gebe ich einem {agent} weiter.", # i18n-allowdiff --git a/dodaios/voice/parked_results.py b/dodaios/voice/parked_results.pyindex d099dae902..867199d8cd 100644--- a/dodaios/voice/parked_results.py+++ b/dodaios/voice/parked_results.py@@ -16,7 +16,7 @@ module is the ONE vocabulary both voice engines and the text surfaces share:abandons by name.* :func:`classify_wait_query` — the closed multilingual vocabulary for thetwo things a user says INTO a wait: "how far are you?" (progress) and "what- came out of it?" (result). Regex only, every locale equal (AGENTS.md §1),+ came out of it?" (result). Regex only, every locale equal,a miss stays native.* :func:`reanchor` — the short spoken/written prefix that ties a resultdelivered after other exchanges back to the request it answers.diff --git a/dodaios/voice/tool_confirmation.py b/dodaios/voice/tool_confirmation.pyindex 7668115578..04ec5fc876 100644--- a/dodaios/voice/tool_confirmation.py+++ b/dodaios/voice/tool_confirmation.py@@ -14,7 +14,7 @@ response``) resolves it on turn N+1. This module owns only the deterministicPHRASING — no LLM call (AP-11), no I/O. The yes/no classifier is shared with theself-mod flow (``dodaios.voice.echo_confirmation``).-Runtime Output Language doctrine (AGENTS.md): every spoken phrase table carries+Runtime Output Language doctrine: every spoken phrase table carriesde / en / es; an unrecognised tag resolves through ``DEFAULT_LOCALE`` — never anempty string (AD-OE6 zero-silent-drop), never a per-layer hardcoded constant."""diff --git a/install/installer.py b/install/installer.pyindex 2c13fe0c7c..e42cd37b52 100644--- a/install/installer.py+++ b/install/installer.py@@ -503,7 +503,7 @@ def step_models(*, full_profile: bool, dry_run: bool) -> None:# The download step's exit code alone is not proof: a skipped or cache-served# model can still leave "done" looking complete. So don't stop at rc — VERIFY# what actually landed on disk and print a per-model truth. Read-only +- # best-effort: this never bricks the install (AGENTS.md section 3).+ # best-effort: this never bricks the install.# run_noted, not run_quiet: with the HF progress bars silenced inside the# prefetch itself, its output is a handful of milestone lines ("downloading# wake model … ~40 MB", "speech model 'base': ready") — streaming them asdiff --git a/scripts/crossplatform/signoff_probe.py b/scripts/crossplatform/signoff_probe.pyindex adb1ce8245..7e3904e17d 100644--- a/scripts/crossplatform/signoff_probe.py+++ b/scripts/crossplatform/signoff_probe.py@@ -38,7 +38,7 @@ import argparseimport sysfrom dataclasses import dataclass-# cp1252 is the Windows console default (AGENTS.md "Windows specifics"); this+# cp1252 is the Windows console default; this# script prints check-mark / arrow glyphs, so force UTF-8 to avoid a# UnicodeEncodeError on the maintainer's box.try: # pragma: no cover - depends on the console stream typediff --git a/scripts/diagnostics/dictation_e2e_probe.py b/scripts/diagnostics/dictation_e2e_probe.pyindex 023ce9fedb..ea51b26f26 100644--- a/scripts/diagnostics/dictation_e2e_probe.py+++ b/scripts/diagnostics/dictation_e2e_probe.py@@ -59,7 +59,7 @@ Exit codes3 nothing failed but something stayed NOT_PROVEN.This is a diagnostic, not a product surface, so it deliberately lives outside-the CLI-first REST contract (AGENTS.md §5). Cross-platform by capability probe:+the CLI-first REST contract. Cross-platform by capability probe:Windows, macOS and Linux/X11 press the key; Wayland and headless hosts refusewith a reason instead of pretending."""diff --git a/tests/contract/test_stt_protocol.py b/tests/contract/test_stt_protocol.pyindex b5c061390b..c0c67ddee3 100644--- a/tests/contract/test_stt_protocol.py+++ b/tests/contract/test_stt_protocol.py@@ -104,7 +104,7 @@ _ALLOWED_PLUGIN_IMPORT_ROOT = "dodaios.plugins.stt."def test_groq_plugin_has_no_jarvis_imports():- """The Groq plugin must not import the app core (AGENTS.md section 5).+ """The Groq plugin must not import the app core.Its own plugin group is the single exception — see:data:`_ALLOWED_PLUGIN_IMPORT_ROOT`.diff --git a/tests/fakes/__init__.py b/tests/fakes/__init__.pyindex bd054fd981..bea8866701 100644--- a/tests/fakes/__init__.py+++ b/tests/fakes/__init__.py@@ -1,6 +1,6 @@"""Test fakes — drop-in implementations for plugin protocols.-Convention (AGENTS.md): "fakes over mocks". Every plugin protocol has+Convention: "fakes over mocks". Every plugin protocol hasat least one FakeXxxProvider/FakeXxxProcess with scripted responses; testswork against the fakes instead of ``unittest.mock``."""diff --git a/tests/fakes/fake_global_hotkeys.py b/tests/fakes/fake_global_hotkeys.pyindex 166ea4b0a5..903b2c3c25 100644--- a/tests/fakes/fake_global_hotkeys.py+++ b/tests/fakes/fake_global_hotkeys.py@@ -1,6 +1,6 @@"""FakeGlobalHotkeys — drop-in stand-in for the ``global_hotkeys`` module.-Convention (AGENTS.md): fakes over mocks. The real ``global_hotkeys`` package+Convention: fakes over mocks. The real ``global_hotkeys`` packageregisters Windows-wide low-level keyboard hooks via ``win32api`` and spawns anOS polling thread — neither of which can run on a headless Linux CI box (thecloud-first VPS doctrine). This fake replicates the *observable contract* ofdiff --git a/tests/fakes/fake_hotkey_backend.py b/tests/fakes/fake_hotkey_backend.pyindex d270008bc6..4ac3f63b72 100644--- a/tests/fakes/fake_hotkey_backend.py+++ b/tests/fakes/fake_hotkey_backend.py@@ -1,6 +1,6 @@"""FakeHotkeyBackend — drop-in stand-in for a ``HotkeyBackend`` (AD-6 seam).-Convention (AGENTS.md): fakes over mocks. This fake satisfies the+Convention: fakes over mocks. This fake satisfies the``dodaios.trigger.backends.HotkeyBackend`` ``Protocol`` and records the lifecyclecalls so a test can prove ``HotkeyTrigger`` drives the backend correctly(register → start → stop → unregister) without touching any OS or optionaldiff --git a/tests/fakes/fake_tcc.py b/tests/fakes/fake_tcc.pyindex 163671e443..862c25dcc7 100644--- a/tests/fakes/fake_tcc.py+++ b/tests/fakes/fake_tcc.py@@ -33,7 +33,7 @@ Fidelity ledger. Each simulated behaviour carries one of two labels, here andin the code. Nobody can run macOS in this sandbox, so nothing below is"verified on a real Mac"; a behaviour marked ``documented`` is stated by Apple,one marked ``unverified`` is community-observed or inferred from this repo's-own bug history (docs/BUGS.md) and must not be quoted as fact.+own bug history and must not be quoted as fact.* Microphone: tri-state status, prompt only while ``not_determined``, thecompletion handler reports the current answer when already decided; missingdiff --git a/tests/fakes/fake_telephony_stack.py b/tests/fakes/fake_telephony_stack.pyindex be413c39bc..fe84e87908 100644--- a/tests/fakes/fake_telephony_stack.py+++ b/tests/fakes/fake_telephony_stack.py@@ -1,6 +1,6 @@"""Deterministic fakes for the telephony STT -> Brain -> TTS seams.-Convention (AGENTS.md): fakes over mocks. These let the telephony session loop+Convention: fakes over mocks. These let the telephony session loopand the media-stream integration test run with no model download, no API keyand no real socket.diff --git a/tests/integration/test_ollama_catalog_is_current.py b/tests/integration/test_ollama_catalog_is_current.pyindex 577d08c592..b9db28b00e 100644--- a/tests/integration/test_ollama_catalog_is_current.py+++ b/tests/integration/test_ollama_catalog_is_current.py@@ -150,7 +150,7 @@ def _assert_model_is_current(model_id: str, registry: httpx.Client) -> None:def test_the_shortlist_was_reviewed_within_twelve_months() -> None:- """AGENTS.md §4: nothing a year old ships as a local default. The review+ """nothing a year old ships as a local default. The reviewdate is printed in the panel, so it must be both true and recent — theper-tag checks above catch a retired tag, this catches a list nobody haslooked at."""diff --git a/tests/missions/test_voice_readback.py b/tests/missions/test_voice_readback.pyindex 5eef6894eb..2fafe2cf84 100644--- a/tests/missions/test_voice_readback.py+++ b/tests/missions/test_voice_readback.py@@ -140,7 +140,7 @@ def test_render_failed_maps_missing_source_checkout_to_capability_phrase() -> Nodef test_git_setup_reasons_carry_spanish() -> None:- """AGENTS.md §1: Spanish is an equal supported product-surface language,+ """Spanish is an equal supported product-surface language,so every portable workspace-setup reason added here must carry an ``es``phrase rather than perpetuating the de/en-only gap."""from dodaios.missions.voice.readback import FAILURE_REASON_PHRASESdiff --git a/tests/missions/workers/test_api_family_quota_state.py b/tests/missions/workers/test_api_family_quota_state.pyindex 32b0819229..efc2cf1973 100644--- a/tests/missions/workers/test_api_family_quota_state.py+++ b/tests/missions/workers/test_api_family_quota_state.py@@ -7,7 +7,7 @@ remembered that, so every retry re-picked gemini — the healthy openrouter keyone slot further in the SAME loop was never reached. This is the genericAPI-family mirror of ``claude_quota_state`` / ``codex_quota_state``, keyed byprovider slug and FINGERPRINTED: saving a NEW key in the API-Keys view lifts-the cooldown instantly (in-app recoverability, AGENTS.md §3), while the same+the cooldown instantly (in-app recoverability), while the samedead key stays skipped until the cooldown self-expires."""from __future__ import annotationsdiff --git a/tests/unit/agentic_ide/test_chat_library_routes.py b/tests/unit/agentic_ide/test_chat_library_routes.pyindex 0e69863c99..9a9734131d 100644--- a/tests/unit/agentic_ide/test_chat_library_routes.py+++ b/tests/unit/agentic_ide/test_chat_library_routes.py@@ -197,7 +197,7 @@ def test_creating_a_chat_starts_nothing(client: TestClient, tmp_path: Path) -> Ndef test_destructive_routes_declare_themselves(client: TestClient) -> None:- """The danger flag is what keeps a delete out of an unattended yes (AGENTS.md §5)."""+ """The danger flag is what keeps a delete out of an unattended yes."""schema = client.get("/openapi.json").json()["paths"]for path in (diff --git a/tests/unit/agentic_ide/test_fanout_route.py b/tests/unit/agentic_ide/test_fanout_route.pyindex 073d8e645f..b5b5a66e16 100644--- a/tests/unit/agentic_ide/test_fanout_route.py+++ b/tests/unit/agentic_ide/test_fanout_route.py@@ -1,7 +1,7 @@"""The REST surface for running a fleet: spawn, split, deliver.Why this route exists at all, given the voice path already works: the CLI-first-contract (AGENTS.md §5) says a capability that lives only in the voice path is+contract says a capability that lives only in the voice path isnot done. Speaking is how the maintainer uses this, but the same fleet has tobe startable from the terminal, from a script, and from the workspace UI — andone route is also what keeps those three from growing three different ideas ofdiff --git a/tests/unit/agentic_ide/test_intent_phrasebook.py b/tests/unit/agentic_ide/test_intent_phrasebook.pyindex c01de6df9f..ec87638fa1 100644--- a/tests/unit/agentic_ide/test_intent_phrasebook.py+++ b/tests/unit/agentic_ide/test_intent_phrasebook.py@@ -25,7 +25,7 @@ Two properties make this a phrasebook rather than a wishlist:miss. The unrelated block is what keeps the widening honest.German and Spanish utterances here are speech-recognition input vocabulary —-the words a person literally says — not prose (AGENTS.md §1, closed list item+the words a person literally says — not prose (closed list item3). They are the content under test."""from __future__ import annotationsdiff --git a/tests/unit/agentic_ide/test_intent_portuguese.py b/tests/unit/agentic_ide/test_intent_portuguese.pyindex f5665003d3..af2f45c951 100644--- a/tests/unit/agentic_ide/test_intent_portuguese.py+++ b/tests/unit/agentic_ide/test_intent_portuguese.py@@ -1,7 +1,7 @@"""European Portuguese speech input reaches the same workspace intents as theother supported locales — and ordinary Portuguese sentences stay out of them.-Every utterance below is spoken input under test (AGENTS.md §1 list #4).+Every utterance below is spoken input under test (list #4)."""from __future__ import annotationsdiff --git a/tests/unit/agentic_ide/test_last_prompt_route.py b/tests/unit/agentic_ide/test_last_prompt_route.pyindex 768984d9e9..c1f94894ff 100644--- a/tests/unit/agentic_ide/test_last_prompt_route.py+++ b/tests/unit/agentic_ide/test_last_prompt_route.py@@ -8,7 +8,7 @@ an emulator that never painted, a socket reconnecting, a CLI redrawing itsinput box out of view. The user's honest reading of that is that nothinghappened.-It is also the CLI-first half (AGENTS.md §5): the same proof has to be+It is also the CLI-first half: the same proof has to beavailable from a terminal and a script, not only from the pane's own overlay."""diff --git a/tests/unit/agentic_ide/test_pane_activity_parity.py b/tests/unit/agentic_ide/test_pane_activity_parity.pyindex e0789dfb3d..bca9eca96d 100644--- a/tests/unit/agentic_ide/test_pane_activity_parity.py+++ b/tests/unit/agentic_ide/test_pane_activity_parity.py@@ -3,7 +3,7 @@The words a pane can be in ("working", "waiting", …) cross four layers: thePython literal that produces them, the Pydantic field that ships them, theTypeScript union that types them and the label map that turns each one into-something a person reads. AGENTS.md §5 exists because a value added to one layer+something a person reads. that rule exists because a value added to one layerand forgotten in another is this repo's most-repeated bug — and the failure modehere is quiet: an unknown word reaches a `Record` lookup, the badge rendersnothing, and a pane silently loses its status.diff --git a/tests/unit/agentic_ide/test_pane_notifications_route.py b/tests/unit/agentic_ide/test_pane_notifications_route.pyindex 565b13c003..84e7418cae 100644--- a/tests/unit/agentic_ide/test_pane_notifications_route.py+++ b/tests/unit/agentic_ide/test_pane_notifications_route.py@@ -1,4 +1,4 @@-"""The bell's REST surface — the CLI-first half (AGENTS.md §5).+"""The bell's REST surface — the CLI-first half.The panel in the header is one client of this. The other is a terminal: thesame three questions ("what stopped?", "stop counting these", "throw themdiff --git a/tests/unit/audio/test_devices.py b/tests/unit/audio/test_devices.pyindex a54fa610d8..f7c336cfa9 100644--- a/tests/unit/audio/test_devices.py+++ b/tests/unit/audio/test_devices.py@@ -13,7 +13,7 @@ Guards for :mod:`dodaios.audio.devices`:first; input: MME first), tolerating the MME truncation; an unknown nameyields None so callers can fall back to auto-headset.3. **Headless safety** — no sounddevice / a failing query degrades to an- empty list / None, never raises (python:3.11-slim contract, AGENTS.md §3).+ empty list / None, never raises (python:3.11-slim contract)."""from __future__ import annotationsdiff --git a/tests/unit/brain/test_ack_brain/conftest.py b/tests/unit/brain/test_ack_brain/conftest.pyindex 205c06abbc..eece9165a2 100644--- a/tests/unit/brain/test_ack_brain/conftest.py+++ b/tests/unit/brain/test_ack_brain/conftest.py@@ -4,7 +4,7 @@ A FakeAckProvider implements the :class:`AbstractAckProvider` protocolwithout any network or SDK dependency. Tests can script its responsesper-utterance (or globally) and inspect call recordings afterwards.-Per project policy (AGENTS.md "Testing-Konventionen"), tests use Fakes+Per project policy, tests use Fakesrather than ``unittest.mock`` for protocol-level dependencies. TheFakes live here so they can be shared across the integration suitewithout duplication.diff --git a/tests/unit/brain/test_ack_brain/test_output_language_gate.py b/tests/unit/brain/test_ack_brain/test_output_language_gate.pyindex c541b9eb96..9e95e7994d 100644--- a/tests/unit/brain/test_ack_brain/test_output_language_gate.py+++ b/tests/unit/brain/test_ack_brain/test_output_language_gate.py@@ -12,7 +12,7 @@ the ack exists to bridge:to pass.The gate now validates against the turn's ALREADY-resolved output language-through ``dodaios.core.turn_language`` (AGENTS.md §1: one resolver for every+through ``dodaios.core.turn_language`` (one resolver for everylayer), which fails open on anything indeterminate and covers de/en/es equally.A genuine, high-confidence mismatch must still be blocked."""diff --git a/tests/unit/brain/test_evidence_gate_refusal_language.py b/tests/unit/brain/test_evidence_gate_refusal_language.pyindex db56d796db..d771c7ff39 100644--- a/tests/unit/brain/test_evidence_gate_refusal_language.py+++ b/tests/unit/brain/test_evidence_gate_refusal_language.py@@ -10,7 +10,7 @@ choose the refusal language. Two consequences:back to English.The refusal is user-facing speech, so it must follow the ONE resolver like-every other layer (AGENTS.md §1). ``check_evidence_domain`` now takes the+every other layer. ``check_evidence_domain`` now takes thealready-resolved ``language``; the utterance is only consulted when a calleromits it."""@@ -46,7 +46,7 @@ def _refuse(text, *, language=""):def test_every_locale_has_a_complete_refusal_table():- """All locales are equal: no table may lag another (AGENTS.md §1)."""+ """All locales are equal: no table may lag another."""assert set(_REFUSAL_PT) == set(_REFUSAL_ES) == set(_REFUSAL_DE) == set(_REFUSAL_EN)assert all(text.strip() for text in _REFUSAL_ES.values())assert all(text.strip() for text in _REFUSAL_PT.values())diff --git a/tests/unit/brain/test_honesty_language_parity.py b/tests/unit/brain/test_honesty_language_parity.pyindex c3275d02b4..b8a55b32b9 100644--- a/tests/unit/brain/test_honesty_language_parity.py+++ b/tests/unit/brain/test_honesty_language_parity.py@@ -7,7 +7,7 @@ On a turn whose language cannot be detected (a bare product name, "42", agrunt) the user could get a German refusal followed by an English honestyphrase in the same breath.-AGENTS.md §1: ONE resolver decides the turn for ALL layers, and every locale is+ONE resolver decides the turn for ALL layers, and every locale isequal — no layer may pin its own default."""from __future__ import annotationsdiff --git a/tests/unit/brain/test_manager_spoken_phrases_pt.py b/tests/unit/brain/test_manager_spoken_phrases_pt.pyindex 8c5d2df194..f02b8eb884 100644--- a/tests/unit/brain/test_manager_spoken_phrases_pt.py+++ b/tests/unit/brain/test_manager_spoken_phrases_pt.py@@ -69,7 +69,7 @@ def test_spoken_reply_language_pin_and_detection() -> None:def test_spoken_reply_language_agrees_with_the_turn_resolver(pin: str, conversation: str, text: str) -> None:- """Canned phrases and the router resolve ONE language per turn (AGENTS.md)."""+ """Canned phrases and the router resolve ONE language per turn."""from dodaios.core.turn_language import DEFAULT_LOCALE, resolve_output_languagem = _manager(pin)diff --git a/tests/unit/brain/test_wiki_relevance_planning_gate.py b/tests/unit/brain/test_wiki_relevance_planning_gate.pyindex 26c4a561a2..6a0a883c7b 100644--- a/tests/unit/brain/test_wiki_relevance_planning_gate.py+++ b/tests/unit/brain/test_wiki_relevance_planning_gate.py@@ -24,7 +24,7 @@ from dodaios.brain.wiki_relevance import should_consult_memory@pytest.mark.parametrize("utterance",[- # de (AGENTS.md §1, closed-list item 4 — speech input under test)+ # de (closed-list item 4 — speech input under test)"Was soll ich heute Abend machen?", # i18n-allow: German input under test"Wie komme ich am besten nach Berlin?", # i18n-allow: German input under test"Hast du Ideen fuer das Wochenende?", # i18n-allow: German input under testdiff --git a/tests/unit/commands/test_registry_parity.py b/tests/unit/commands/test_registry_parity.pyindex 1cb43a7f60..cd5af8c36f 100644--- a/tests/unit/commands/test_registry_parity.py+++ b/tests/unit/commands/test_registry_parity.py@@ -224,7 +224,7 @@ def test_registry_dicts_are_json_serializable_and_small() -> None:@pytest.mark.parametrize("locale", ["de", "en", "es", "pt"])def test_every_command_has_voice_aliases_for_all_supported_locales(locale) -> None:- """Supported languages are equal (AGENTS.md §1) — no de/en-only bias."""+ """Supported languages are equal — no de/en-only bias."""for cmd in get_registry():assert cmd.voice_aliases.get(locale), (f"{cmd.id}: missing {locale} voice alias"diff --git a/tests/unit/core/test_secret_locked_keyring.py b/tests/unit/core/test_secret_locked_keyring.pyindex a6d6e174c1..e09c813293 100644--- a/tests/unit/core/test_secret_locked_keyring.py+++ b/tests/unit/core/test_secret_locked_keyring.py@@ -9,7 +9,7 @@ engaged for ``fail.Keyring`` was skipped, ``keyring.set_password`` raised``KeyringLocked``, and ``set_secret`` returned False. The in-app POST``/secrets/{key}`` route turns that into HTTP 500, so pasting a key in the UIfailed and nothing persisted. A locked/unusable OS keyring must degrade to the-file store at RUNTIME, keeping the "recoverable in-app" guarantee (AGENTS.md §3).+file store at RUNTIME, keeping the "recoverable in-app" guarantee."""from __future__ import annotationsdiff --git a/tests/unit/dictation/test_delivery_gates.py b/tests/unit/dictation/test_delivery_gates.pyindex 14f6243dab..2f71b9f8f7 100644--- a/tests/unit/dictation/test_delivery_gates.py+++ b/tests/unit/dictation/test_delivery_gates.py@@ -39,7 +39,7 @@ from dodaios.speech.pipeline import SpeechPipeline, _is_silence_hallucinationBYTES_PER_SECOND = 16_000 * 2# German fixtures. A transcript reproduces the speaker's own words, so the-# dictated German IS the thing under test here (AGENTS.md §1, list #4).+# dictated German IS the thing under test here (list #4).DE_SENTENCE = "Er hat gesagt, dass er das Dokument gleich schickt." # i18n-allow: fixtureDE_THANKS = "Vielen Dank für das Update" # i18n-allow: fixturediff --git a/tests/unit/dictation/test_polish_parity.py b/tests/unit/dictation/test_polish_parity.pyindex e6f8a2bea1..cc8262ec57 100644--- a/tests/unit/dictation/test_polish_parity.py+++ b/tests/unit/dictation/test_polish_parity.py@@ -1,6 +1,6 @@"""Cross-layer parity guards for the two vocabularies the polish pass added (AP-4).-AGENTS.md §5 asks for this test PREEMPTIVELY, before a value has drifted, because+the project rule asks for this test PREEMPTIVELY, before a value has drifted, becausethe five-layer drift bug (BUG-008) has recurred four times in this repo and everyrecurrence looked different on the surface. Two vocabularies started crossinglayers when the wording pass landed, and neither had a guard:@@ -329,7 +329,7 @@ def test_the_language_tab_says_the_transcript_leaves_the_machine() -> None:def test_the_privacy_sentence_hardcodes_no_product_name() -> None:- """AGENTS.md §4: a visible product name is derived from the wake word.+ """a visible product name is derived from the wake word.The sentence talks about "your speech recognition" and "the model you pick"on purpose — naming the app would be a hardcoded brand, and naming adiff --git a/tests/unit/dictation/test_translate.py b/tests/unit/dictation/test_translate.pyindex ac15b9d3f3..7e474a0496 100644--- a/tests/unit/dictation/test_translate.py+++ b/tests/unit/dictation/test_translate.py@@ -57,7 +57,7 @@ from dodaios.dictation.polish_prompt import RAW_OPEN_DELIMITER# The German below is the MATERIAL under test, not prose: a translation test# needs text in a language other than the target, and the language detector the# guards run on knows de/en/es — so the fixture has to be one of those to-# exercise the check at all (AGENTS.md §1, allowed category 4).+# exercise the check at all (allowed category 4).GERMAN = ("also ich glaube wir sollten den bericht am dienstag rausschicken" # i18n-allow)@@ -817,7 +817,7 @@ def test_the_openai_wording_models_come_from_the_verified_catalog() -> None:"""The wording pass and the brain must not disagree about what OpenAI serves.This family's default sat on a 2025 model id for long enough that nobody- noticed (AGENTS.md §3 forbids a default that old). Tying both ids to the+ noticed (forbids a default that old). Tying both ids to thecurated roster the brain already keeps current means the next refresh ofthat roster cannot leave this pass behind — and a removal there fails hereinstead of 404-ing at dictation time.diff --git a/tests/unit/docs/test_adr_uniqueness.py b/tests/unit/docs/test_adr_uniqueness.pyindex 73c589750e..e094673ab3 100644--- a/tests/unit/docs/test_adr_uniqueness.py+++ b/tests/unit/docs/test_adr_uniqueness.py@@ -24,7 +24,7 @@ _NUMBER_RE = re.compile(r"^(\d{4})-")# Legacy duplicates that pre-date this test. Adding to this list MUST# be accompanied by an ADR explaining why a renumber was not feasible-# (typically: published inbound links from AGENTS.md, BUGS.md, or other+# (typically: published inbound links from other# ADRs). The Wave-4 doc flags these for a follow-up renumber sweep._ALLOWED_DUPLICATES: frozenset[str] = frozenset({"0009", # awareness-architecture + self-healing-worker-criticdiff --git a/tests/unit/memory/wiki/test_session_rollup_brain_call.py b/tests/unit/memory/wiki/test_session_rollup_brain_call.pyindex ba83485afb..b5550419c3 100644--- a/tests/unit/memory/wiki/test_session_rollup_brain_call.py+++ b/tests/unit/memory/wiki/test_session_rollup_brain_call.py@@ -4,7 +4,7 @@ These tests pin the **call shape** between the rollup worker and the Brainprotocol. They fail loudly the moment a future refactor reverts to theold positional / kwarg-based signature that broke production from2026-05-13 onward (``GeminiBrain.complete() got an unexpected keyword-argument 'max_tokens'`` — see BUGS.md B8).+argument 'max_tokens'``).The fake matches the production contract from ``dodaios/core/protocols.py``:diff --git a/tests/unit/plugins/stt/test_stt_error_classification.py b/tests/unit/plugins/stt/test_stt_error_classification.pyindex 8a064d7eef..59e7493ddd 100644--- a/tests/unit/plugins/stt/test_stt_error_classification.py+++ b/tests/unit/plugins/stt/test_stt_error_classification.py@@ -143,8 +143,7 @@ def _raise_from_gemini(status: int, headers: dict[str, str] | None = None) -> Ba#: Every cloud STT plugin, by provider id. The behaviour these share is a#: CAPABILITY — "the pipeline can read a status off my failure" — not a type#: (AP-21). Groq reaches it through ``httpx.HTTPStatusError`` because that-#: plugin may not import ``dodaios.*`` at all, not even lazily (AGENTS.md §5,-#: pinned by tests/contract/test_stt_protocol.py); the other three reach it+#: plugin may not import ``dodaios.*`` at all, not even lazily (#: pinned by tests/contract/test_stt_protocol.py); the other three reach it#: through the shared ``STTHTTPError``. Both satisfy the consumer, which is the#: only thing that decides whether a user's turn survives a 429._RAISERS = {diff --git a/tests/unit/plugins/stt/test_transcript_filter.py b/tests/unit/plugins/stt/test_transcript_filter.pyindex 7218f7d8d7..6805d8e23e 100644--- a/tests/unit/plugins/stt/test_transcript_filter.py+++ b/tests/unit/plugins/stt/test_transcript_filter.py@@ -1,8 +1,7 @@"""Transcript cleanup filter — ``dodaios.plugins.stt.transcript_filter``.The German and Spanish strings in this file are the speech under test: a filter-that removes German hesitation sounds cannot be tested in English (AGENTS.md §1,-allowed category 4).+that removes German hesitation sounds cannot be tested in English (allowed category 4)."""from __future__ import annotationsdiff --git a/tests/unit/plugins/stt/test_transcript_filter_parity.py b/tests/unit/plugins/stt/test_transcript_filter_parity.pyindex 412731a214..187be0ec2e 100644--- a/tests/unit/plugins/stt/test_transcript_filter_parity.py+++ b/tests/unit/plugins/stt/test_transcript_filter_parity.py@@ -12,7 +12,7 @@ Two failure modes this pins, both of which are invisible until a user reports``raw_text`` turns the user's filler switch into a no-op (AP-31) and makeswake judge an edited transcript (AP-27).-The German fixtures are the speech under test (AGENTS.md §1, category 4).+The German fixtures are the speech under test (category 4)."""from __future__ import annotationsdiff --git a/tests/unit/realtime/test_protocol.py b/tests/unit/realtime/test_protocol.pyindex bc7c7cc985..4cb0301f6f 100644--- a/tests/unit/realtime/test_protocol.py+++ b/tests/unit/realtime/test_protocol.py@@ -78,7 +78,7 @@ def test_event_can_mark_a_self_initiated_interruption():def test_no_event_language_field_defaults_to_one_particular_language():- """AGENTS.md §1: supported locales are equal, so a language field whose+ """supported locales are equal, so a language field whosepublisher omitted it must fall back to the SHARED default.These defaults were the literal "de", so any event published without adiff --git a/tests/unit/realtime/test_session.py b/tests/unit/realtime/test_session.pyindex d91d48e0ad..8c34587492 100644--- a/tests/unit/realtime/test_session.py+++ b/tests/unit/realtime/test_session.py@@ -9121,7 +9121,7 @@ async def test_a_handshake_resource_exhausted_says_busy_not_unreachable():@pytest.mark.asyncioasync def test_the_handshake_notice_follows_the_pinned_reply_language():- """One resolver decides, here as everywhere (AGENTS.md §1 runtime rule 1).+ """One resolver decides, here as everywhere.Every supported locale is equal: a Spanish-pinned user must not be told inEnglish (or German) that the call is ending.diff --git a/tests/unit/realtime/test_session_skills_roster.py b/tests/unit/realtime/test_session_skills_roster.pyindex 68b51a441a..11feae6e0d 100644--- a/tests/unit/realtime/test_session_skills_roster.py+++ b/tests/unit/realtime/test_session_skills_roster.py@@ -134,7 +134,7 @@ def test_the_session_instructions_name_every_installed_skill(def test_the_compact_profile_also_names_the_skills(skills_root: Path) -> None:"""A small self-hosted brain gets a shorter roster, never no roster —- provider parity is not optional (AGENTS.md §3)."""+ provider parity is not optional."""_install(skills_root)instructions = session_module._session_instructions(diff --git a/tests/unit/speech/test_dictation_lifecycle_events.py b/tests/unit/speech/test_dictation_lifecycle_events.pyindex ee52e4314f..d1ef483e7c 100644--- a/tests/unit/speech/test_dictation_lifecycle_events.py+++ b/tests/unit/speech/test_dictation_lifecycle_events.py@@ -4,7 +4,7 @@ Before this, the only signals a dictation produced were the live transcript andthe completion — both at or after the END. A surface therefore could not show"listening" until the first partial arrived (a partial interval plus an STTround-trip later, and never at all for a short press), and a refused start was-a ``log.info`` in a file the desktop app cannot display (AGENTS.md §9), so the+a ``log.info`` in a file the desktop app cannot display, so theshortcut simply did nothing with no way to learn why.Pinned here:diff --git a/tests/unit/speech/test_dictation_no_audio_dropped.py b/tests/unit/speech/test_dictation_no_audio_dropped.pyindex 3d8cbfc85c..33c3ce90ee 100644--- a/tests/unit/speech/test_dictation_no_audio_dropped.py+++ b/tests/unit/speech/test_dictation_no_audio_dropped.py@@ -296,7 +296,7 @@ async def test_fillers_are_removed_even_when_the_provider_names_no_language(pipe._record_dictation = _no_history # type: ignore[method-assign]- # The German hesitation sounds ARE the input under test (AGENTS.md §1 #4):+ # The German hesitation sounds ARE the input under test:# the filler rules are per-language, so proving they ran needs a sentence# in a language that has rules.spoken = "Also ähm ich wollte äh kurz Bescheid sagen" # i18n-allow: input under testdiff --git a/tests/unit/speech/test_dictation_recognition_language.py b/tests/unit/speech/test_dictation_recognition_language.pyindex a5fdaafe2e..027fd39ac6 100644--- a/tests/unit/speech/test_dictation_recognition_language.py+++ b/tests/unit/speech/test_dictation_recognition_language.py@@ -47,7 +47,7 @@ class TestWhatTheRecogniserIsAskedFor:assert resolve_recognition_language(pinned="auto", session_language=" ES ") == "es"def test_every_supported_language_is_carried_the_same_way(self):- """No de/en bias — a locale is a locale (AGENTS.md §1)."""+ """No de/en bias — a locale is a locale."""for code in ("de", "en", "es"):assert (resolve_recognition_language(pinned="auto", session_language=code)diff --git a/tests/unit/speech/test_speak_playback_timeout.py b/tests/unit/speech/test_speak_playback_timeout.pyindex a93d2dbb61..b7efc5136b 100644--- a/tests/unit/speech/test_speak_playback_timeout.py+++ b/tests/unit/speech/test_speak_playback_timeout.py@@ -952,8 +952,7 @@ async def test_timeout_phrase_resolves_in_input_language() -> None:def test_cause_aware_timeout_tables_cover_de_en_es() -> None:- """Both new cause-aware tables must carry every supported locale (AGENTS.md- §1): an es speaker must never fall back to the wrong language."""+ """Both new cause-aware tables must carry every supported locale: an es speaker must never fall back to the wrong language."""for table in (_TIMEOUT_TOOL_STALL_PHRASE, _TIMEOUT_NO_ANSWER_PHRASE):assert {"de", "en", "es"} <= set(table), tablefor value in table.values():diff --git a/tests/unit/speech/test_stream_sentence_filter.py b/tests/unit/speech/test_stream_sentence_filter.pyindex 16243afbc6..ccfff2a549 100644--- a/tests/unit/speech/test_stream_sentence_filter.py+++ b/tests/unit/speech/test_stream_sentence_filter.py@@ -264,7 +264,7 @@ async def test_filtered_sentence_never_interrupts_a_healthy_answer(assert spoken == ["Der Bericht ist fertig.", "Sonst noch was?"]assert FALLBACK_PHRASES["de"] not in spoken- # ... and the drop is on the record (AGENTS.md §7: nothing swallowed).+ # ... and the drop is on the record (nothing swallowed).dropped = [r for r in caplog.records if "DROPPED" in r.getMessage()]assert len(dropped) == 1assert _POISON in dropped[0].getMessage()diff --git a/tests/unit/test_claude_auth.py b/tests/unit/test_claude_auth.pyindex 3b83b89568..6537fef592 100644--- a/tests/unit/test_claude_auth.py+++ b/tests/unit/test_claude_auth.py@@ -705,7 +705,7 @@ def test_the_default_dir_is_recognised_without_a_hardcoded_separator("""Built from Path.home(), so the home fallback is not Windows-only.A hand-written "~/.claude" string is a per-OS guess about the separator;- this repo ships the same behaviour on macOS and Linux (AGENTS.md §3).+ this repo ships the same behaviour on macOS and Linux."""home = tmp_path / "home"monkeypatch.setattr(Path, "home", classmethod(lambda _cls: home))diff --git a/tests/unit/test_recognition_languages.py b/tests/unit/test_recognition_languages.pyindex f968c5e0ed..2cefda5ab6 100644--- a/tests/unit/test_recognition_languages.py+++ b/tests/unit/test_recognition_languages.py@@ -12,7 +12,7 @@ user sees an option that will not save.locales the product *speaks*. But what Jarvis can understand is a differentquestion from what it can answer in, and capping recognition at three languagesmeant a Mandarin, Japanese or Arabic speaker could not dictate at all. That is-the maintainer's-config-is-the-baseline mistake in miniature (AGENTS.md §3), so+the maintainer's-config-is-the-baseline mistake in miniature, sothe floor is asserted, not assumed."""from __future__ import annotationsdiff --git a/tests/unit/ui/dodaiosbar/test_mode_parity.py b/tests/unit/ui/dodaiosbar/test_mode_parity.pyindex b0a9a22c85..eb545b95ef 100644--- a/tests/unit/ui/dodaiosbar/test_mode_parity.py+++ b/tests/unit/ui/dodaiosbar/test_mode_parity.py@@ -103,7 +103,7 @@ def test_the_tk_surface_still_rejects_an_unknown_mode() -> None:@pytest.mark.parametrize("mode", modes.MODES)def test_the_ipc_proxy_accepts_and_forwards_every_mode(mode: str) -> None:"""The macOS proxy must put every mode on the wire, or the feature is- Windows/Linux-only — a silent OS-parity hole (AGENTS.md §3)."""+ Windows/Linux-only — a silent OS-parity hole."""proxy = subprocess_mod.SubprocessBarOverlay.__new__(subprocess_mod.SubprocessBarOverlay)sent: list[dict] = []proxy._send = sent.append # type: ignore[method-assign]diff --git a/tests/unit/ui/web/test_dictation_polish_routes.py b/tests/unit/ui/web/test_dictation_polish_routes.pyindex 6213eecad5..2b03207113 100644--- a/tests/unit/ui/web/test_dictation_polish_routes.py+++ b/tests/unit/ui/web/test_dictation_polish_routes.py@@ -421,7 +421,7 @@ def test_the_dry_run_never_500s_when_the_pass_is_unreachable(def test_the_dry_run_is_reachable_from_the_cli_surface(app: FastAPI) -> None:"""Tagged ``dictation``, so it becomes a ``jarvis api dictation`` command- for free — the CLI-first contract (AGENTS.md §5)."""+ for free — the CLI-first contract."""spec = app.openapi()["paths"]["/api/dictation/polish/test"]["post"]assert spec["tags"] == ["dictation"]diff --git a/tests/unit/ui/web/test_dictation_routes.py b/tests/unit/ui/web/test_dictation_routes.pyindex a31d5b2c66..f85c10ef80 100644--- a/tests/unit/ui/web/test_dictation_routes.py+++ b/tests/unit/ui/web/test_dictation_routes.py@@ -780,7 +780,7 @@ def _described_strings(node: Any) -> Iterator[str]:def test_no_openapi_description_hardcodes_an_assistant_name(app: FastAPI) -> None:- """AGENTS.md §4: a user-visible string never carries a fixed brand.+ """a user-visible string never carries a fixed brand.These descriptions are user-visible twice over — the /docs page and thegenerated ``jarvis api dictation --help`` — so a sentence naming thediff --git a/tests/unit/ui/web/test_keybind_action_ts_parity.py b/tests/unit/ui/web/test_keybind_action_ts_parity.pyindex 970f1d073c..ef6c7fec9e 100644--- a/tests/unit/ui/web/test_keybind_action_ts_parity.py+++ b/tests/unit/ui/web/test_keybind_action_ts_parity.py@@ -37,7 +37,7 @@ _FRONTEND = _REPO_ROOT / "dodaios" / "ui" / "web" / "frontend" / "src"_HOTKEY_TS = _FRONTEND / "hooks" / "useHotkey.ts"_LOCALES = _FRONTEND / "i18n" / "locales"-#: The locales the product ships. All of them are equal (AGENTS.md §1) — a key+#: The locales the product ships. All of them are equal — a key#: that exists only in English is a bug for every other user, not a nicety.SUPPORTED_LOCALES = ("de", "en", "es")diff --git a/tests/unit/ui/web/test_section_id_parity.py b/tests/unit/ui/web/test_section_id_parity.pyindex 6324325dcc..3799dbeb2e 100644--- a/tests/unit/ui/web/test_section_id_parity.py+++ b/tests/unit/ui/web/test_section_id_parity.py@@ -8,7 +8,7 @@ of the merged voice section, and a ``nav.*`` string in every locale.TypeScript catches almost none of that. ``as const satisfies readonlySectionId[]`` only rejects an array entry that is missing from the union —-never a union member missing from the array (docs/BUGS.md, the recurring+never a union member missing from the array (the recurringenum-drift class). A tab id that never reaches ``MainView`` renders a blankpane. An id missing from ``matchIds`` un-highlights the sidebar row while theuser is standing on it. A missing locale key prints "nav.voice_language" at@@ -232,7 +232,7 @@ def test_every_voice_section_id_has_a_nav_key_in_every_locale() -> None:def test_the_merged_sidebar_row_carries_the_brand_token_not_a_name() -> None:- """AGENTS.md §4 — the user-visible brand is derived from the wake word.+ """the user-visible brand is derived from the wake word.``nav.voice`` is the one label of this section that reaches the sidebar, soa hardcoded product name here would show up for every user regardless ofdiff --git a/tests/unit/ui/web/test_setup_report_routes.py b/tests/unit/ui/web/test_setup_report_routes.pyindex 3d37cbc8da..d6b39e4795 100644--- a/tests/unit/ui/web/test_setup_report_routes.py+++ b/tests/unit/ui/web/test_setup_report_routes.py@@ -1,7 +1,7 @@"""REST-route tests for the cross-device setup report.The report exists to name why one install behaves differently from another-(AGENTS.md §3 device-parity triage), so the tests pin its three contracts:+(device-parity triage), so the tests pin its three contracts:1. Share-safety: credentials appear strictly as presence BOOLEANS — a reportmust be pasteable into an issue without scrubbing.diff --git a/tests/unit/voice/test_echo_confirmation_es.py b/tests/unit/voice/test_echo_confirmation_es.pyindex 1cf7735e31..aa3974dd01 100644--- a/tests/unit/voice/test_echo_confirmation_es.py+++ b/tests/unit/voice/test_echo_confirmation_es.py@@ -1,6 +1,6 @@"""Spanish coverage for ``echo_confirmation.classify_response``.-Runtime Output Language doctrine (AGENTS.md): the yes/no classifier must cover+Runtime Output Language doctrine: the yes/no classifier must coverde/en/es. Before this, ``language="es"`` silently fell into the German branch, soa Spanish "sí"/"no" was misclassified as "unknown" — an es-pinned user could notconfirm or veto a consequential action by voice. Veto keeps priority over confirmdiff --git a/tests/unit/voice/test_echo_confirmation_pt.py b/tests/unit/voice/test_echo_confirmation_pt.pyindex 24099b2f6e..c609df8537 100644--- a/tests/unit/voice/test_echo_confirmation_pt.py+++ b/tests/unit/voice/test_echo_confirmation_pt.py@@ -1,6 +1,6 @@"""European Portuguese coverage for ``echo_confirmation.classify_response``.-Runtime Output Language doctrine (AGENTS.md): the yes/no classifier must cover+Runtime Output Language doctrine: the yes/no classifier must coverevery supported language. Without its own branch ``language="pt"`` would fallinto the German patterns, so a Portuguese "sim"/"não" would read as "unknown"and a pt-pinned user could not confirm or veto a consequential action by voice.diff --git a/tests/unit/web/test_local_only_install_has_every_tier.py b/tests/unit/web/test_local_only_install_has_every_tier.pyindex f01d5e12c7..4ece94d38e 100644--- a/tests/unit/web/test_local_only_install_has_every_tier.py+++ b/tests/unit/web/test_local_only_install_has_every_tier.py@@ -1,6 +1,6 @@"""A download whose only hardware is their own must reach every tier.-Personal Jarvis is aimed at an arbitrary downloader (AGENTS.md section 3), and+Personal Jarvis is aimed at an arbitrary downloader, anda meaningful share of them will not enter a single cloud credential — that isthe whole point of the local providers. For those installs "mostly local" isnot a state the product should have: one keyless gap means the voice mode, thediff --git a/ui/orb/bus_bridge.py b/ui/orb/bus_bridge.pyindex 125a1f5351..7442d687a6 100644--- a/ui/orb/bus_bridge.py+++ b/ui/orb/bus_bridge.py@@ -2048,7 +2048,7 @@ class OrbBusBridge:"""The dictation shortcut was pressed and DECLINED — say so on screen.This is the whole reported bug. Every refusal used to end as a- ``log.info`` in a file the desktop app cannot open (AGENTS.md §9: the+ ``log.info`` in a file the desktop app cannot open (thewindow is a WebView with no dev tools), so on the maintainer'sconfiguration — one wake word, ``session_idle_timeout_s = 0``, no hangupkey — a voice conversation stayed open all day and from then on EVERY