# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

### Fixed

- 🚀 The API's health grace covers its measured boot on the Pi (`start_period` 60 s →
  180 s): a deploy applying one migration took 2 min 22 s from container start to the
  last worker ready, and `up --wait` reported a deploy that had succeeded as failed
  (`test_api_boot_budget_guard.py`).
- 🛑 A task cancelled while its database session closes now stops. Both session helpers
  (`get_db_context`, `get_db_session`) suppressed a cancellation landing during their
  shielded close, and the task carried on — measured on dev, a worker reload waited more
  than 36 minutes for the lifetime-metrics loop, asleep again after its `cancel()`. The
  close now runs to its end as one task the helper owns (`write_through_cancellation`),
  then the cancellation propagates; and a session is closed once, where
  `AsyncSession.__aexit__` used to start a second close beside the first
  (`test_session_cancellation.py`, `test_session_close_cancellation_pg.py`).
- 🛑 A chat turn cancelled while its tracked spend is written now ends cancelled. The
  stream's `finally` shielded the spend commit and caught the cancellation, logging it
  as « completed » — `shield` does not wait — so the turn ran on past its stream. The
  commit runs to its end (`orchestration/tracking_commit.py`), then the cancellation
  propagates; `test_no_swallowed_shield_cancellation_guard.py` refuses the shape anywhere
  under `src/` and flags the three sites fixed here on their former sources.
- 🔁 What ends a route reaches its database session. `get_db` delegated to
  `get_db_session` with `async for`, which forwards nothing: for every route depending on
  it, a failure never reached the rollback branch (its rollback, its
  `db_transaction_rollback_total{endpoint="fastapi"}` count, its classified log), and the
  session closed only when the garbage collector finalized the abandoned generator.
  `get_db` now enters it as a context manager — the « Tx Rollbacks » panel (dashboard 03)
  counts route failures from now on — and the unverified-account sweep, which iterated it
  too, opens `get_db_context()`; `test_no_iterated_session_dependency_guard.py` refuses
  the shape.
- 🔒 The unverified-account sweep no longer logs the addresses it deletes. It read them
  only to log them at INFO, cut to three characters and the whole domain under a comment
  calling them « hashed », and the runtime PII filter let them through: a masked address
  no longer matches its pattern, and `sample_emails` is no name it knows. The sweep logs
  the count, like the demo account purge, and reads no address (ADR-317).
- 🔒 The log PII filter withholds an address in every shape it takes. Measured on the
  filter, four went through to INFO: a full address inside a tuple, a set or a list of
  lists (only a list's strings and dicts were read); a masked one (`fir***@mail.test`,
  `f…@m….test`); one outside ASCII (`zoë@mail.test` whole, `andré.martin@…` keeping its
  first name); and any value under a name beyond four exact ones (`recipient_email`,
  `sample_emails`). Containers are read at every depth, the pattern takes every script
  and the masking marks (still linear, measured), and a field named for an address hashes
  its text whatever its shape — a count, a flag or an id under such a name stays.
- ⚡ An uploaded HEIC picture is converted and a PDF's text extracted off the event loop
  (`asyncio.to_thread`), like every other PDF reader. Measured on a workstation, the
  longest stall of the worker's loop fell from 0.9-1.2 s to under 20 ms for a
  12-megapixel HEIC, and from about 230 ms to about 20 ms for a 300-page PDF read to its
  last page; PyMuPDF holds the GIL during each call, so its longest one still bounds the
  stall.

## [3.7.0] - 2026-10-25

**A first name finds the person, what you shared shows where you shared it, any recording becomes minutes, and every step says what it did.**
A first name now reaches the one connection or relationship it designates — and a name
that fits several people is asked about, never guessed; a skill, a plugin or an MCP
server says who you shared it with and who it came from; a kept answer or a generated
file can be brought back into a discussion; a relationship's records line up on one
dated timeline; a WAV, MP3 or M4A recording becomes a meeting with its minutes; each
step of an answer counts its calls, results and failures; a phone call's report shows
what it cost; and the V15 audit is published: 7.9/10 on the committed version 3.6.0.

### Added

- 🧑‍🤝‍🧑 **A first name finds the person** (ADR-180, ADR-182 and ADR-185 amendments). One
  rule decides what a spoken name designates in any directory
  (`shared/name_resolution.resolve_name`): the folded full name first, then every word
  said as a whole word of the name — never a fragment, never an edit distance —, one
  identity resolved, several an ambiguity asked about with the candidates
  (`DISAMBIGUATION_REQUIRED`, at most five). The peer tools read the accepted
  connections only (`agents/peer/name_directory.resolve_connected_peer`); on a partial
  match the relationship list only SUBTRACTS — a person who is not connected and whom
  the name also designates turns the read into a question, a name designating only
  non-connected people is said (`not_a_connection`) — and a merge declared on the
  Relations page never picks an account. The three relationship read tools resolve
  against the relationship list, so an unknown name answers `NOT_FOUND` instead of an
  empty card; the workboard's assignment applies the same rule over the connections.
  The list the assistant reads admits an SMS sender only where the person let the
  assistant read their SMS, and the peer tools end their reads before consulting it
  (its SMS senders can ask the contacts provider, ADR-304). Guard:
  `test_name_resolution_single_rule_guard.py`.
- 🤝 **« Shared with » and « Received from » under a capability's line** (ADR-350
  amendment). Skills, plugins and MCP servers carry `shared_with` — the recipients a
  sender published each one to, newest share first, in one query per page
  (`shared/capability_shares`), a deactivated or erased recipient unnamed — drawn in a
  « Shared with (N) » disclosure, an incomplete share said so; a received copy keeps
  « Received from … · date ». Whether a sender may share again is ONE function,
  `reshare_allowed`: a published share is final for now — the door stays open, no index
  stands in its way —, asked at the preview AND at the send under the pair's lock (409
  `peers_capability_already_shared`, an installation in flight counted as given, the
  resumption of a partial share allowed); the recipient list leaves out who already has
  it. The assistant's native readers never see `shared_with`.
- ♻️ **A kept answer or a generated file back in the discussion** (ADR-295 amendment).
  `POST /attachments/from-bookmark` attaches a bookmark as the Markdown its knowledge
  document reads, whatever its projection's state; `POST /attachments/from-generated`
  copies a live generated image or document of the caller (an image within the upload
  bounds, a document with its text). Both are COPIES — uploads a reset removes and the
  TTL expires, the original untouched —, sharing one store with the knowledge-document
  door (`attachments/copy_store.py`). The « + » offers « A bookmark… » and « A generated
  file… »; a bookmark card and the gallery offer « Use in the discussion », a one-shot
  `?attach=` link that never sends anything.
- 🗓️ **A relationship's timeline** (ADR-185 amendment b). A collapsible section merges
  the card's dated records — open commitments, calls, memories, relayed messages, text
  messages — newest first on one line (`GET /relations/{name}/timeline` and
  `/lookup/person/timeline`): five keyset reads after one opaque cursor, so a record
  landing between two pages neither repeats nor drops one
  (`infrastructure/database/keyset.py`); the identity is the card's
  (`relations/identity_scope.py`), mails and appointments are merged within the card's
  own windows, and a forged cursor answers 400.
- 🎙️ **A meeting imported from a WAV, MP3 or M4A file** (ADR-258 amendment). An
  imported file is admitted like a recording, travels in chunks onto the same durable
  row (`uploading`, one per account, held by the database) and is processed like one:
  `GET /meetings/imports/limits`, `POST /meetings/imports`,
  `PUT /meetings/{id}/import/{sequence}`, `POST /meetings/{id}/import/complete`. Every
  bound is published before a byte is sent (`MEETINGS_IMPORT_MAX_MB`,
  `MEETINGS_IMPORT_CHUNK_MAX_MB`), the first chunk must start as the format it claims,
  ffmpeg reads it through that format's demuxer alone (`-f wav|mp3|mov`,
  `-enable_drefs 0`, local files only), the duration is measured — and refused past the
  cap — before any engine is paid, and an import silent for
  `MEETINGS_IMPORT_STALE_MINUTES` fails `import_incomplete`, its chunks deleted.
  `MEETINGS_IMPORT_ENABLED` switches it off; `meeting_imports_total{format,outcome}` on
  dashboard 27. « Import » sits beside « Record » on the meetings page and in the « + ».
- 🔢 **Each step says what it did** (ADR-133 amendment). A tool's line in the bubble and
  in the persisted trace counts its calls (« ×2 »), the results found and read, and its
  failures — live as each ReAct call finishes (`step_key`), and per tool for a pipeline
  plan, a FOR_EACH counted by its items (`streaming/tool_step_outcomes.py`); the item id
  format is declared once (`ExecutionStep.item_step_id`).

### Changed

- 🤖 **A JEV qualification reaches the model as a state, never as an instant** (ADR-351
  amendment). The data block and the text line carry the labels and `current` or
  `expired`, decided by the code when they are shown (`classification_view`): handed
  `valid_until` in UTC beside a clock in the person's zone, a model told the person a
  label valid for another hour had expired. « Unknown never means safe » now speaks of
  e-mails only, and the e-mail priority's reference time is given in the person's zone.
- 💬 A discussion bubble's buttons sit on the right, wrapping as one group.
- 🎙️ The meetings page offers « Record » and « Import » side by side.
- 🧭 The demonstrator's environment templates are laid out in themed sections under a
  table of contents (`docs/technical/DEMO_INSTANCE.md`).

### Fixed

- 💶 **A phone call's report shows what it cost** (ADR-290, ADR-301 and ADR-272
  amendments). Three paths archived a call's notification without the call's run id —
  the owner call's fallback, the third-party call's debrief, the reaper's re-dispatch —,
  so the bubble showed no cost although the synthesis had one: every call notification
  now leaves through one door (`telephony/call_notifications.py`, AST guard). A rewritten
  voice-session card tells the open tabs (ADR-320 signal), and a Live session's card
  restates its bill once the learning that follows the closing has spent.
- 📎 Attaching a knowledge document whose text cannot be read no longer leaves its copy
  on disk, and the copy is made once the document's read has ended — no transaction
  waits on the disk work.
- 🧪 The TOTP tests computed their code from a naive local time, wrong during the hour a
  clock change repeats; they read the UTC instant.

### Tests

- 🛡️ Guards: one name-resolution rule (`test_name_resolution_single_rule_guard.py`), one
  door for a call's notifications (`test_call_notification_door_guard.py`); the
  `streaming/service.py` size cap lowered from 1,303 to 1,245 logical lines after the
  step outcomes moved out.
- 🌐 Browser journeys for the step counts (live and from history), the meeting import,
  the relationship timeline, capability sharing and bringing a bookmark back, on desktop
  and phone widths.
- ⏱️ Testing Library's waits are calibrated for the coverage run like `testTimeout`
  (`asyncUtilTimeout` 5 s): under full parallelism with instrumentation the suite runs
  about five times slower, and an optimistic rollback missed the 1 s default once in
  two runs. The release history's landmark test scopes each role query to its own
  region instead of walking the whole history twice per series.
- 🔢 Test inventory: 53,211 backend tests collected across 3,559 files and 14,191
  frontend tests across 1,139 files.

### Documentation

- 📚 Amendments of ADR-133, ADR-180, ADR-182, ADR-185, ADR-258, ADR-272, ADR-290,
  ADR-295, ADR-301, ADR-350 and ADR-351; `TELEPHONY.md`, `MEETINGS.md`,
  `ATTACHMENTS_INTEGRATION.md`, `BOOKMARKS.md`, `PEER_CAPABILITY_TRANSFERS.md`,
  `EMAIL_EVENT_CLASSIFICATION.md` and `DEMO_INSTANCE.md`; the FAQ and the help corpus in
  six languages.
- 🔍 **The V15 audit is published**: 7.9/10 across 24 areas on the committed version
  3.6.0 (commit `3909d87c5`), 17 open findings — one major — and its register:
  AC-029 reopened, AC-039 closed, AC-041 and AC-043 to AC-049 new, AC-042 a positive
  control ([docs/audit/README.md](docs/audit/README.md)).

## [3.6.0] - 2026-10-24

**Password doors robots cannot hammer, tokens renewed once, every audit finding followed to its proof.**
A password reset now answers for one account — capped per account whoever asks, bound
to the password it would replace, never a way into an account that signs in with
Google; an operator can put Cloudflare Turnstile on sign-up, sign-in and reset; a
discussion left unanswered holds the next one for an hour, not a day; and the V14
audit's remediation wave lands — one refresh door for every OAuth token, a database
that bounds its own lock waits and idle transactions, a notification filed delivered
only once it is, alerts that reach their teams, and a public register that follows
every finding to its proof.

### Security

- 🔐 **A password reset answers for one account** (ADR-363). Who may receive a link
  is ONE decision (`auth/password_reset_policy.decide_reset`), applied when the link
  is asked for AND when it is used: a deleted account or an administrator receives
  nothing — the attempt is alerted instead —, an account that signs in with a
  provider and has no password receives a notice naming it, never a link that would
  create a password, and every other account a link. An account's e-mail budget holds
  whatever address asks (`PASSWORD_RESET_ACCOUNT_INTERVAL_SECONDS`,
  `PASSWORD_RESET_ACCOUNT_DAILY_MAX`, on the existing `RedisRateLimiter`, in a
  `USER_RUNTIME` key family a conversation reset never frees), the short window asked
  first so hammering the route cannot spend a victim's day. A link carries the
  account id and an HMAC of the stored password hash: a password changed since, or an
  account re-created at the address, retires it. The Security settings state the real
  way back (`password_recovery` on `GET /auth/step-up/status`, ADR-143 amendment).
  `password_reset_requests_total` and `password_reset_confirmations_total{outcome}`
  (every series present at zero), dashboard 09, two core alerts — `PasswordResetAbuse`
  and `RegistrationBurst`, their thresholds per environment
  (`ALERT_CORE_PASSWORD_RESET_THROTTLED_PER_HOUR`, `ALERT_CORE_REGISTRATIONS_PER_HOUR`) —
  with their runbooks, promtool cases and evidence recipes; a rate-limit `key_prefix`
  label carries no client address and no account id.
- 🗝️ **An administrator's way back is server-side** (ADR-363 amendment):
  `python -m scripts.data.set_password --email …` (`task db:set-password`) sets the
  password, then signs every device out. The first administrator of a self-hosted
  instance has a password and, under the new rule, no reset link: this is its way back.
- 🤖 **A Cloudflare Turnstile anti-robot check on the password doors** (ADR-364), off
  until the operator brings a widget (`TURNSTILE_ENABLED`, `TURNSTILE_SITE_KEY`,
  `TURNSTILE_SECRET_KEY`; the boot refuses the switch without both keys). Sign-up,
  sign-in and the reset request carry a token (`X-LIA-Turnstile-Response`), checked
  after the per-IP limiter (`auth/turnstile_gate.py`), valid only for THIS door on
  THIS instance's pages. `TurnstileClient` never raises and bounds each of its two
  attempts whole (`TURNSTILE_VERIFY_TIMEOUT_SECONDS`). When Cloudflare gives no usable
  answer only the sign-in proceeds —
  a tokenless one too, while the server's own view of Cloudflare confirms the outage
  (`TURNSTILE_REACHABILITY_TTL_SECONDS`, one shared probe); a sign-up or a reset
  request is refused `turnstile_unavailable`, a refused token `turnstile_failed`, and a
  testing key in production counts as no answer (`TurnstileUnavailable` alert,
  `ALERT_CORE_TURNSTILE_UNAVAILABLE_PER_15M`). The
  site key reaches the sign-in pages alone (`PublicAuthFeaturesResponse`), the widget
  runs `interaction-only` in the page's theme and language, the CSP admits Cloudflare's
  challenge host (ADR-098 amendment), and the privacy policy (v1.2) names the check in
  six languages.
- 📦 **The dependency advisories closed before the tag**: `zod` 4.6.7 (GHSA-mrhx-c7xc-m3w5,
  high, fixed from 4.6.6 — validation of an oversized constrained collection could exhaust
  memory), raised as the manifest's floor (ADR-331), and `vitest` / `@vitest/coverage-v8`
  4.1.12 for two moderate `@vitest/mocker` advisories (GHSA-qxg6-89mg-rqv8,
  GHSA-xp26-3454-mjgp) of the test toolchain, their two dependency-watch acceptances
  removed. Two repository tools no workspace audit reads were behind too: the landing
  film's Remotion project (`tools/lia-motion`) forces the same `zod` over Remotion's 4.5.4
  pin and floors `fast-uri` at 3.1.9 (four advisories) through npm `overrides`, and the
  wake-word GPU toolbox floors `brotli` at 1.2.1 (GHSA-9v8h-qqgm-4m35, critical, an
  out-of-bounds write in the decoder). In that toolbox, `datasets` (GHSA-379c-qx7v-6h59),
  Pillow and fsspec stay held by VoxCPM's and gradio's caps — a developer tool, never on
  the API's interpreter nor on the Pi.

### Added

- 💬 **A discussion left unanswered holds the next one for an hour, not a day**
  (ADR-358 and ADR-359 amendments): `DISCUSSION_ATTENTION_UNANSWERED_OPENING_MINUTES`
  (60; the 24-hour reply window is unchanged), the next publication supersedes an
  opening still pending — after binding any reply a channel archived meanwhile —, a run
  that never starts names why on its counter outcome and in `discussion_run_not_started`,
  and the activity panel says when LIA is waiting for your reply
  (`DiscussionActivity.awaiting_reply`).
- 📋 **A public register of the audit findings** (AC-031):
  `docs/audit/findings_register.json`, verified by `scripts/audit/findings_register.py`
  in `task lint:docs` — every AC finding of the reports exists in it, a closure or a
  remediation carries its proof — and `task release:check` refuses a P1 past its
  horizon unless deferred. This release remediates eighteen findings of the V14
  revision; they await the next audit's verification.
- 🧰 **The installer offers the anti-robot check** (ADR-364): on an instance reached on a
  public domain it asks for the Turnstile site key and secret key together — both or
  neither, hidden at the prompt, refused when they are Cloudflare's testing keys — writes
  them and `TURNSTILE_ENABLED=true` to the private `.env` alone, never re-asks them on a
  resume and keeps an operator's configuration on a run that skips them
  (`scripts/install/turnstile.py`).
- 📈 **The discussion tables are measured before any retention** (ADR-358 amendment,
  AC-034a): `proactive_discussion_table_rows` and `proactive_discussion_table_bytes`,
  drawn on dashboard 13, before a retention rule is decided.

### Changed

- 🔄 **One refresh door for every OAuth token** (ADR-302 amendment, AC-029; notes in
  ADR-021, ADR-029 and ADR-047). Legacy connectors, shared grants and Hue Remote renew
  through `connectors/oauth_refresh.py`: one exchange per token across callers and
  workers (a single flight in a worker, an owner-token claim across workers, a
  published verdict — an unexpected failure included), no transaction open across the
  provider call, a write conditioned on the token it started from and bounded in its
  wait for the row (`OAUTH_REFRESH_WRITE_LOCK_TIMEOUT_MS`), an `invalid_grant`
  re-verified before anyone is disconnected; a caller that owns its session reads
  (`read_connector_credentials`), then asks `fresh()`. `OAuthLock` and
  `OAuthGrantRuntime` are gone, `oauth_refresh_outcomes_total{kind,outcome}` and
  `oauth_refresh_flights_total{kind,how}` replace the lock series and
  `connector_token_refresh_total` on dashboard 10, and only `oauth_refresh_exchange.py`
  sends `grant_type=refresh_token` (guarded).
- 🗄️ **The database bounds its own waits** (ADR-304 amendment, AC-028): every
  application connection starts with `DATABASE_LOCK_TIMEOUT_MS` (30 s) and
  `DATABASE_IDLE_IN_TRANSACTION_TIMEOUT_MS` (5 min) (`database/server_bounds.py`; the
  migration engine carries none); each bound reached is counted
  (`db_bound_reached_total`), drawn on dashboard 03 and alerted (`DatabaseBoundReached`,
  with its evidence recipe).
- 📬 **A notification is delivered when it is** (ADR-263 amendment, AC-003):
  `NotificationResult.durably_delivered` — archived, pushed or sent on a channel, never
  an SSE event alone — is the one verdict. The five consumers that file « delivered »
  (the phone reapers, the return synthesis, the phone relay, peer messages,
  diagnostics) pass `require_durable=True`, count a failure on a session of their own
  and read the archive only after its commit (guard `test_durable_delivery_guard.py`).
- 🔔 **Alerts reach their teams** (ADR-119 amendment, A07, AC-004): ONE Alertmanager
  template whose optional blocks disappear when unconfigured; severity routes continue
  to the team receivers, deduplicated; an audience route no loaded alert reaches fails
  the build unless it is declared dormant with its reason — the security route is,
  until a loaded alert carries its component; `task test:alertmanager` runs the
  production image's real entrypoint against a routing matrix with amtool.
- 📊 **Every panel reads a produced series** (ADR-178 amendment, AC-006): a reverse
  guard, panel → producer, in `lint:observability`. Dashboard 26's cost and latency
  panels read two gauges the hourly rollup computes in PostgreSQL over the North Star's
  useful set (`product_outcome_cost_eur_mean`, `product_outcome_latency_p50_seconds`);
  dashboard 14 loses its two hybrid-search panels, whose producer left in v1.25.30
  (ADR-168), and its row becomes « BM25 Index Cache (RAG Spaces) ». The product
  freshness alert `ProductAggregatesStale` joins the loaded core (warning,
  `ALERT_CORE_PRODUCT_AGGREGATES_STALE_SECONDS`, its runbook); the three product
  behaviour alerts stay unloaded, re-decided by 2026-12-15 on a read-only measurement
  of production.
- 🧵 **Nothing blocking on the event loop** (AC-035): Ruff ASYNC2 enforced on `src`,
  its fifteen sites fixed; speech-to-text uploads stream through
  `infrastructure/multipart_upload.py`.
- 🧪 **The coverage floor holds where the code is executed** (ADR-113 amendment, AC-030,
  AC-032): the floor applies to the unit and integration suites together
  (`task test:backend:coverage`, combined strictly), the lines a change adds are held
  at the floor in CI (`task test:backend:diff-coverage`), and the doctrine is written
  once, in `GUIDE_TESTING.md`.
- 🌐 **Every new document is in English** (AC-039a): the frozen list of French
  documents only shrinks (`scripts/audit/doc_language.py`, in `task lint:docs`;
  `task docs:language:update` removes a translated or deleted document from it, never
  adds one).
- ⚙️ **An env template states the code's default, or why it differs** (AC-036, guard
  `test_env_template_parity_guard.py`): every line states the default, omits the key,
  or says why it differs (`# … — differs from default: <reason>`). `.env.example` and
  `.env.prod.example` now carry the values production runs: a configuration copied
  from them switches on, among others, account export, detached generation,
  self-diagnosis, the Live mode, Gmail push and push wakes, learned habits, open loops
  and moments, the register's hash chain, the sandbox's network runs and the ReAct
  cross-turn cache, with production's budgets and bounds — a discussion run may spend
  5.00 USD instead of 0.10, the radio 4 EUR a day instead of 2 —, while product
  analytics stays off, written as differing from production. The minimal template the
  installer starts from no longer switches detached chat generation off (ADR-117): a
  new guided installation runs it, like the code's default and production, and
  `BACKGROUND_RUNS_ENABLED=false` still brings back the inline path. A running
  instance's `.env` is untouched.

### Fixed

- 🚀 The web image's build no longer misses a module a type-checked test imports:
  `prepare-prod.ps1` stages them (`$webImportedModules`), and
  `test_prepare_prod_web_imports_guard.py` derives the list from the imports and refuses
  a stale entry.
- 🛑 The graceful shutdown waits, bounded, for the tasks it cancels (A05); Hue clients
  are closed on every path (A04); the Docker build context leaves out `.next-*` dists
  (A03); a refused rule set is cached with an exponential wait instead of being retried
  every pass (A16, reason `rules_refused`); the peer message delivery commits its reads
  before the model answers (ADR-304); error logs carry an error's type, never its text
  (ADR-317).
- 🧰 The pre-commit hook's `.env.example` check no longer asks for what a repository
  instrument reads: `scripts/audit/` reads its runner's environment (GitHub's
  `GITHUB_ACTIONS`, the `DIFF_COVERAGE_BASE` the CI hands the diff coverage), never an
  instance's, so it leaves the scan by location — a runtime read of the same name is
  still caught.

### Removed

- 🧹 `OAuthLock`, `OAuthGrantRuntime` and `OAUTH_LOCK_TIMEOUT_SECONDS`, with the five
  `oauth_lock_*` series and `connector_token_refresh_total`;
  `NotificationResult.success` and `error`; `cancel_all_background_tasks`; the finance
  alert route, its receiver, its e-mail template and `ALERTMANAGER_FINANCE_TEAM_EMAIL`
  — no loaded or dormant alert ever reached it (the dormant budget alerts carry
  `component: cost`), so the variable can leave an `.env.alerting`; the e-mail-only
  Alertmanager template, its Python validator and webhook matrix (superseded by
  `task test:alertmanager`); dashboard 14's two `memory_hybrid_search_*` panels; six
  dead MyPy codes and twelve unused ignores (A14a).

### Tests

- 🛡️ Guards for the findings register, the diff coverage, the coverage union, the
  durable delivery, the single refresh sender, the env template parity, the document
  language, the `as unknown as` ratchet (AC-037) and the web bundle's imports; a pytest
  watchdog (`faulthandler_timeout`) and `timeout-minutes` on every CI job (AC-033a); two
  tests that never ran now run (AC-033b); one CPU-growth oracle for every linearity
  guard (ADR-326 amendment, A12); five UI primitives back in the frontend coverage
  (A13, AC-040); `AssistantAvatar`'s decisions extracted (A15); the
  `conversations.service` MyPy override removed (A14b, partial).
- 🔢 `llms.txt` quotes its metric, ADR and release counts through the release tooling:
  three `CountSurface` entries in `scripts/release/version_surfaces.py`, kept by
  `task release:sync-counts` and refused stale by the version-surface guard — it still
  said 630 metrics, 360 ADRs and 286 releases.
- 🔢 Test inventory: 53,014 backend tests collected across 3,542 files and 14,114
  frontend tests across 1,128 files; the installer suite runs 285.

### Documentation

- 📚 ADR-363 and ADR-364, and amendments of ADR-021, ADR-029, ADR-047, ADR-098,
  ADR-113, ADR-119, ADR-143, ADR-178, ADR-263, ADR-302, ADR-304, ADR-326, ADR-358 and
  ADR-359; the `PasswordResetAbuse`, `RegistrationBurst` and `TurnstileUnavailable`
  runbooks; the authentication, security, CI/CD, diagnostics and proactive-discussions
  documents; the audit protocol and public report point at the register; the FAQ and
  its knowledge corpus, the privacy policy, the public presentations and the living
  maps, in six languages.
- 📏 Public counters re-measured at the source: 67,000+ inventoried tests, 634
  Prometheus metrics, 362 ADRs and 288 releases — `llms.txt` and the Story page's
  meta description now quote theirs through the release tooling.

## [3.5.1] - 2026-10-23

**Notifications that no longer repeat themselves.**
An SMS is now personal data like an email: a proactive message written while an
SMS sat in LIA's context is no longer set apart, so the next decision reads it
back again and the same birthday is announced once, not at every check.

### Fixed

- 🔁 **The same subject announced at every heartbeat tick** (ADR-357 amendment
  2026-10-23). A notification written while an SMS sat in the decision's context
  was marked private and withheld from the next decision's recent window — the
  only guard against repeating a subject the model had already raised. An SMS
  stays an unmentioned candidate for its whole summary window, so on an account
  that receives SMS nearly every notification was withheld: measured in
  production, 21 of the 24 notifications sent to the affected account since
  2026-10-20, and one birthday announced six times between 21:07 and 13:29 the
  next day, against one or two birthday notifications a day over the ninety days
  before. The same afternoon
  gave the counter-proof: the first unmarked announcement reached the window and
  the next decision chose another subject. The proactive discussions had the
  same blind spot: an opening an SMS informed never came back to their opening
  history.

### Changed

- 📱 **An SMS in view is treated like an email** (owner decision, ADR-357
  amendment). A heartbeat notification drawn from a context holding an SMS
  shows its words in the push, reaches the external channels, airs on Radio to
  a listener alone, is kept for conversational continuity, enriches an
  interest-centred notification and is read back by the next decision — like a
  notification drawn from mail. A proactive discussion is private when it
  touches a sensitive topic (health, relationships, finances…), whatever the
  source of its facts, and no longer because the run read an SMS. Unchanged:
  the separate assistant consent, the offering of unmentioned messages only, the
  mention bookkeeping after a successful delivery and the content-free reception
  push. Withdrawing the consent stops every new read; a notification already
  sent keeps its words, as one drawn from mail does once its connector is
  removed.

### Removed

- 🧹 The SMS private mode's plumbing: `heartbeat_notifications.sensitive_context`
  (migration `213b9ac595c5`, applied at startup), the window filter
  `get_recent_by_user(for_context=…)`, `sms_privacy`, the dispatcher's `privacy`
  parameter and `ProactiveTaskResult.privacy` (the dispatcher, the runner and the
  task result are back to their shape before the SMS lot),
  `proactive_discussions/privacy.py`, `OpeningDraft.sms_context` and its
  validator, the history's SMS exclusion and the Radio reader's marker filter
  (discussions never reach Radio: they are excluded by their type).

### Tests

- 🧪 Each change was first written as a failing test: a notification sent with an
  SMS in view is stored for continuity and read back by the recent window
  (PostgreSQL), the runner's own door delivers it with its words and to the
  external channels, an interest-centred notification is enriched with an SMS in
  view, a discussion run that read an SMS publishes an ordinary opening that
  returns as prior wording, and Radio reads a heartbeat archived with the retired
  marker like any other.

### Documentation

- 📚 The ADR-357 amendment and the ADR-358 note; the SMS ingestion and
  qualification documents, proactive discussions, Radio, the index, the README;
  the FAQ, the proactive-notifications and privacy articles and the How guide
  in six languages; the knowledge corpus.

## [3.5.0] - 2026-10-23

**Follow-ups read back from the cache, a first dashboard that starts simple, hand-overs that name both ends.**
On Claude, the next turn reads its whole history back from the provider's cache —
for an hour when a person is waiting — and every write is billed at its real
price; a new account opens on the weather and occasional exchanges; a ticket's
history says who held it before and after; the phone gets the whole width; and
the technical audit publishes its counter-review, 7.8/10.

### Added

- ⚡ **Claude's prompt cache across turns** (ADR-362). In a tool loop, the
  history's end becomes a read point: the next turn reads its whole history back
  instead of writing it again (measured on two generations: 439 tokens written
  against 1,685). In frequent exchanges, a turn a person waits for writes its two
  cross-turn read points — the static prefix and the history's end — for
  Claude's one-hour lifetime: after a seven-minute pause, the next turn's first
  call read 144,376 tokens back and cost 89 % less. The hour is billed at its own
  rate (2x the input price) through every pricing door. A streamed response
  names it at its start only, which a stream hook now keeps
  (`providers/anthropic_hooks.py`); a start that names nothing is counted
  (`llm_cache_write_breakdown_missing_total`) and alerted
  (`LLMCacheWriteLifetimeUnreported`, runbook and self-diagnosis evidence
  included). Each call records its cache writes (`token_usage_logs.cache_write_tokens`
  and `cache_write_extended_tokens`, migration `6b7fe9493921`), the Article-12
  technical extraction exports them and dashboard 05 draws the writes by
  lifetime. An earlier turn's thinking goes back to the Claude model that wrote
  it on a generation that keeps it without binding it to the conversation
  (`ClaudeSurface.preserves_prior_turn_thinking`); every other earlier block is
  removed under a named, counted reason. Two operator switches, both on:
  `PROMPT_CACHE_EXTENDED_TTL_ENABLED` and `PRIOR_TURN_THINKING_REPLAY_ENABLED`.
  `task llm:cache:probe` measures the design against the API under a USD budget.
- 🌤️ **A new account starts simple** (ADR-311 and ADR-307 amendments). One
  declaration, `auth/new_account_columns.py`, spread by the three sign-up doors —
  an e-mail registration, a first Google sign-in and the installer's first
  administrator — starts every new account in occasional exchanges and, where
  the instance serves the weather on its own key, on a dashboard showing the
  weather card alone; the other cards wait, switched off, in the grid settings.
  The starter checklist opens on the home address wherever the deployment can
  save one (`/config.features.home_address_enabled`), and a weather card that
  misses an address says so (`location_not_configured`) and points to the
  Location settings rather than to the connectors. Existing accounts keep what
  they had.
- 🔁 **Every hand-over in a ticket's history names both ends** (ADR-276
  amendment): « Held by: Me → LIA », written by one function
  (`workboard/history.holder_fields`) for the screen, the chat, a run handing a
  ticket back and a connection that ends; a ticket created straight for LIA or a
  connection names its first holder.

### Changed

- 📱 **The phone gets the whole width** (ADR-177 amendment). Below 880 px, a
  table, card or code bubble takes its whole column — a short answer stays a
  short bubble — under a stylesheet guard; an empty Home card shrinks to its
  title and its sentence; on a relationship card, every action button takes the
  sheet's full width, its label on the left.
- 🗺️ **Position, rearranged** (ADR-356 amendment). On a wide card the places sit
  in a column beside the map, centred on its height and scrolling inside it from
  the first place; the map offer is one centred block with its cost underneath;
  the stage takes the panel's corners; and the details window is placed again
  after every fit, so a first selection whose route arrives late no longer leaves
  it badly placed.
- ✉️ **Gmail previews read as text** (ADR-287 amendment): decoded once at the
  client's edge — « J&#39;ai » now reads « J'ai » — with a newsletter's invisible
  padding dropped and a word that legitimately carries a joiner left as written;
  a relationship's e-mail excerpt shows up to four lines.
- 🧩 **One repair chain for every structured-output door** (ADR-100 amendment).
  The auto-tool call — the only door of a Claude that refuses a forced tool — now
  repairs and counts like the forced one, and a JSON-mode answer repairs absent
  values too. On a model that forbids extras, an undeclared key holding nothing
  is dropped (`absent_values_dropped`) instead of refusing the whole answer: a
  query analysis refused for an empty note had sent its turn back to a
  conversation without tools.
- 🧱 Relationship and knowledge-space cards end on the same footer rule as the
  skill and MCP cards.

### Security

- 🔐 **Black ≥ 26.10.1 as a manifest floor** (ADR-331): CVE-2026-114134 lets the
  GitHub Action bundled with Black install a version read from an unvalidated
  `pyproject.toml` setting. LIA never runs that Action — Black comes from the
  development lockfile alone — but the dev lock carried the affected release,
  and the backend audit refuses it. Formatting is unchanged (7,476 files).

### Fixed

- 🔁 **A failed structured-output call is said as itself** (ADR-100 amendment
  2026-10-23). A provider error on the auto-tool door — a 503, a 529, a 429, a
  refused connection — used to become a cause-less « produced no valid tool
  call », counted as the model's rejection and invisible to the proactive
  discussions' backoff. It is now `StructuredOutputCallError`, raised from the
  provider's error by the three doors where a call fails and counted
  `call_failed` (dashboard 05). The retry wrapper leaves a client that retries by
  itself (the vendor SDK's `max_retries`) to its own attempts: one 503 costs three
  requests instead of nine. An unusable answer is still retried, and a client with
  no retry of its own keeps the wrapper's loop.
- 📈 The ReAct loop's model calls reach every Prometheus LLM metric: the node now
  hands them the per-node metrics handler every other node attaches.
- 🔇 A structured-output refusal no longer quotes the first 120 characters of the
  model's arguments at WARNING (ADR-317): the log names the parser's verdict and
  the schema paths, never a refused value.

### Removed

- 🧹 **Code no entry point reached** (ADR-194 amendment), proven by walking every
  caller up to a registered tool, a route or a job: 31 definitions of
  `formatters.py` (`ContactsFormatter`, three date formatters, ten Gmail
  extractors), the eleven functions of the former contact-detail path in
  `google_contacts_tools.py`, `agents/utils/email_enricher.py`, the four
  translated messages only they read, and the 66 tests that exercised nothing
  else. Nothing changes for a person: none of these paths ran.

### Tests

- 🧪 PostgreSQL proofs for the two cache-write columns and for the installer's
  first account starting like every new account; unit coverage of the Claude
  payload policy (the history read point, the lifetimes, the hour never placed
  after a caller's own breakpoint), the stream hook, the prior-thinking
  decisions, the cache horizon's scope across `astream_events`, the auto-tool
  repairs and the query-analysis door, the keyless ceiling, the starter
  checklist, the weather setup line, the hand-over history and the Position
  placements.
- 🛡️ New guards: a stylesheet test refusing any rule that narrows a phone bubble
  below its column and pinning the Position list's placement;
  `test_cache_write_reaches_every_price` holds every turn door to the hour's
  writes and names the cache horizon's one writer; two promtool cases for the new
  alert.

### Documentation

- 📚 ADR-362, and amendments of ADR-100, ADR-177, ADR-194, ADR-276, ADR-287,
  ADR-306, ADR-307, ADR-308, ADR-309, ADR-311 and ADR-356; the
  `LLMCacheWriteLifetimeUnreported` runbook; the LLM pricing, providers, prompts,
  ReAct, database schema, Grafana, briefing, workboard and connectors documents;
  the FAQ and its knowledge corpus, the public presentations — including two new
  animated cards on the *More* page — settings search and the living maps, in six
  languages.
- 🧭 **The technical audit publishes its counter-review.** The V14 revision of
  2026-10-22 re-examined every finding and score against the current code and
  lowers the published score from 8.0 to **7.8/10** (186.5/240) — eleven areas
  down, usability up — with 26 open findings (4 major, 11 moderate, 11 minor),
  12 of them new (AC-028 to AC-039), and the closures it could prove (AC-024 and
  AC-025, AC-021 presumed; nine findings of V13). The public report, README,
  Story and How guides, FAQ, knowledge corpus and `llms.txt` carry it, with its
  prioritized remediation plan.
- 📏 Public counters re-measured at the source: 66,000+ inventoried tests (52,397
  backend tests collected across 3,500 files, 13,948 frontend tests across 1,118),
  630 Prometheus metrics, 360 ADRs and 286 releases; the FAQ card of the Home
  page names its eleven cards again — it still said nine.

## [3.4.0] - 2026-10-22

**LIA speaks first, your texts join in, places show the way.**
Personal discussions LIA may open when you allow it, a private archive of the
SMS your phone relays, place details and a priced route on the Position card,
and scan protection shared by every API worker.

### Added

- 💬 **Proactive discussions** (ADR-358, ADR-359, ADR-360). Off until the person
  switches on *Allow LIA to start a discussion*, LIA may open a personal
  conversation of its own accord — an interest in a plan, encouragement, an open
  question — separate from notifications, which tell rather than invite a reply.
  The person sets the hours (across midnight if needed), a daily maximum, a
  pause, each allowed source, the sensitive topics and the topics to avoid; an
  opening offers four reactions (*Thanks, this resonates*, *Not now*, *Do not
  bring up this topic*, *This context is incorrect*). The derived context is
  visible: each element with its period and last reading can be allowed or not,
  deleted, purged or rebuilt, and the panel states the last rebuild, the last
  update and the last run — why it ended, what it read and interpreted, what it
  cost — with one plain sentence when a limit stops LIA. An archive, a logical
  opening and an outbox intent are published atomically, then delivered
  natively; human turns, approvals and alerts keep priority. Every model call
  and paid read is counted on the account under its quotas, within per-run,
  per-account-day and instance-day budgets; an opening informed by an SMS or a
  sensitive topic stays private (masked push, never an external channel), and
  each opening is an action of LIA's own initiative in the registers. The
  capability has its own switch; operator bounds are `DISCUSSION_*` settings.
- 📱 **Your SMS, relayed by your phone** (ADR-357). A write-only token per phone
  and an iPhone Shortcuts automation post each SMS to
  `POST /api/v1/ingest/message`; stable receipts tell stored, duplicate,
  conflict and invalid apart, item by item in a batch. **Settings › SMS** keeps
  an encrypted personal archive — search, sender threads, names resolved from
  your contacts, erasure — and recognised access secrets never reach storage.
  Assistant access is a separate consent, off by default; the chat,
  relationships, proactivity, the Radio and a phone call read bounded evidence
  under it. Immediate push stays content-free, the in-app notice names the
  sender, the Home card counts exactly and the personal export includes the
  readable SMS. Health ingestion keeps its contract.
- 🗺️ **Place details and a route on the Position card** (ADR-355, ADR-356). Each
  place carries one number, the same in the list and on its pin. Selecting it
  shows the details the answer already gathered — address, rating and reviews,
  phone, website, opening hours — with no new search, and one route: walking up
  to 2 km, otherwise driving, corrected once when the actual walk is longer,
  from the browser position when it is already allowed, else the dated last
  known location, else home. Each paid call is filed once under the existing
  pricing and quotas, refusals and cancellations included; desktop popups and
  phone dialogs show the same facts.
- 📇 **Address-book actions on a relationship card.** One button per email
  (*Email …*), postal address (*Directions to …*) and — when the telephony
  connector is active — number (*LIA call …*) prepares the request in the chat.
  On the contact card, an email opens the mail app, a whole number calls from
  the device and an address opens Google Maps.
- 🎫 **"My tickets" on the Home Workboard card** counts the tickets you hold; a
  ticket's last run keeps its cache and Google figures, and ticket costs show
  six decimals.
- 🧾 **The journal's last intervention** reads in the chat meter's vocabulary
  (IN, OUT, CACHE, GOOGLE, €), cached tokens stored apart.

### Changed

- 🧭 **Alerts and Activity share one header**: *Activity timeline* or *Received
  / To follow up*, *Action journal* and *Refresh*, which re-reads the counts and
  every open section. Proactive discussions and *My SMS* join the Alerts hub.
- 🎨 **One neutral line** draws panel borders and separators on the signed-in
  screens (guarded), panels alternate their backgrounds, page headings carry a
  rule, and a line separates sections inside a panel — never two panels.
- 🏷️ Shorter settings labels (*Proactive notifications*, *Memory*, *Limits
  admin*…); relationship rows are titled like an email — how long ago and when —
  and open on their direction, *Sent* or *Received*.
- 🤝 A capability shared with a connection is announced in the recipient's chat
  with the sender's name, and the share dialog confirms, warns or explains.
- 🔄 SMS pages and health data refresh in place, without a visible reload.
- 📦 The personal export includes the proactive-discussion records
  (observations, states, runs, deliveries, forget markers), internal tokens
  removed.

### Security

- 🛡️ **Scanners are banned across workers** (ADR-353). Distinct unknown-route
  404s and rejected login or MFA credentials from one client earn a temporary
  ban held in Redis and shared by every API worker; ordinary resource and
  session errors never count. Internal callers, exact health probes and
  `OPTIONS` stay admissible, and a Redis failure lets traffic through while the
  metrics, the degradation alert and the diagnostics say so (`HTTP_SCAN_*`).
- 🧭 **Every HTTP 429 names its client** (ADR-354): one WARNING completion event
  carries the canonical client IP, method, query-free path, status and duration
  — a retained log field, never a metric label.
- 🔐 **Three dependency advisories closed as manifest floors** (ADR-331):
  certifi ≥ 2026.10.18 (GHSA-6q48-6c7w-9gw2, the distrusted emSign roots),
  langgraph-checkpoint-postgres 3.1.3 with langgraph-checkpoint 4.3.0
  (GHSA-6hmw-9432-67qq, a dotted namespace label could reach another store
  namespace — LIA's labels never carry a dot) and setuptools ≥ 84.1.0 in the
  wake-word toolbox (GHSA-xmj3-9gf7-h52w).

### Fixed

- 🔒 **Handing a ticket to a connection no longer freezes the account.** Since
  v3.0.0 the assignment notice was sent inside the transaction that holds the
  account row, and the notice's own claim waited for it. Notices are now
  collected and dispatched after the commit through one door (AST guard), proven
  by a PostgreSQL lock-order test that fails on the old code.
- 🩺 **The egress probe names the failing step and confirms a cut** (ADR-361):
  resolution then connection, paced attempts, a slow or recovered probe is
  degraded and never paged — one lost DNS datagram no longer reads « platform
  cut off » (`DIAGNOSTICS_EGRESS_PROBE_*`).
- 🧯 **Every received alert records its incident again.** The open-incident
  upsert bound its partial-index predicate as a parameter, which a generic plan
  cannot match; the predicate is now one literal shared by model and repository.
- 🧩 A skill shared by a connection installs on its first receipt (the
  recipient's state is flushed before registration hooks read it).
- 🧪 ReAct validates tool arguments against their schema before running them; a
  deterministic provider 400 is no longer retried; too-short audio and a vendor
  403 keep their permanent classification; numeric millisecond timestamps are no
  longer read as ISO dates; quoted JSON-schema instance data leaves no log above
  DEBUG; LLM callbacks name the model they know.
- ⏱️ Startup reports a successful cache load as such and audits the effective
  LLM slots, logging a refusal rather than failing every slot; Ollama discovery
  runs only when a slot needs it; a routine whose owner is unavailable settles
  without running; a timeout keeps its typed outcome.
- 🙈 An inactive account sends no presence or profile-image request; a
  successful readability recovery and a valid medium-confidence routing log at
  their level.
- 🏠 The Home SMS card shows previews only in a complete bundle, re-checked
  against an erasure.
- 🔤 The journal search placeholder is translated in six languages (English only
  since v1.9.3), a misplaced SMS key no longer shows raw, and a disclosure's
  chevron follows its own block.
- ⌨️ **Deleting a sender's or a day's SMS keeps the keyboard in place** (audit
  V14, AC-024): the erase button records where the focus returns for every
  scope, not only a single message, so once the refresh removes the group the
  focus lands on the archive's own disclosure — never on a control the person
  chose meanwhile.
- 🔎 **Renamed administration panes stay findable by their full name** (audit
  V14, AC-025): the shortened titles (users, limits, usage export) keep their
  former names as search keywords in all six languages.

### Tests

- 🧪 PostgreSQL proofs for the screen hand-over lock order, the open-incident
  upsert under a generic plan, the discussion context retention and the new
  migrations; the discussion tick, revalidation and reservations are covered
  under injected clocks and concurrency.
- 🛡️ New guards: one assignment-notice door, the neutral line colour, refresh in
  place, i18n key placement; Playwright journeys for proactive discussions and
  their chat actions, the SMS archive, settings, Alerts, Home and relationships,
  and the Position details.
- 🎭 Browser journeys realigned on the interactions this release decided (audit
  V14, AC-021) without weakening their oracles: always-open Home rubriques,
  address-book actions beside the contact card, a share confirmed by its toast,
  two discussion-context panels, an SMS sender leading its words, call rows
  titled like mail, the badge measured by its pill; the Position layout is read
  in one frame. The fixtures now answer the connectors read a relationship makes.

### Documentation

- 📚 ADR-353 to ADR-361, `PROACTIVE_DISCUSSIONS.md`, the SMS ingestion,
  qualification and iPhone Shortcuts guides, the FAQ and its knowledge corpus in
  six languages, public presentations, settings search and the living maps.
- 📏 Public counters re-measured at the source: 1,003,000+ source lines, 58
  backend domains, 66,000+ inventoried tests (52,293 backend, 13,919 frontend),
  32 Grafana dashboards (847 panels), 327 catalogue tools, 93 model slots, 202
  prompt files; the proactive sources are fourteen and the Home page holds eleven
  cards since the SMS joined them. The Story page description no longer quotes
  the test and ADR counts of an earlier release.
- 🧭 **Technical audit V14 published**: 8.0/10 over 24 normalized areas
  (192/240, security out of scope), its 16 worksites — 3 major — published with
  it. The public report, README, Story and How guides, FAQ and knowledge corpus
  carry it, and the history now lists V12 (8.3) and V13 (7.3), which had not
  reached the public surfaces.

## [3.3.0] - 2026-10-19

**Find, share and locate.**
Full-text meeting-minutes search, independent capability copies between accepted
connections, advisory source labels shared with the assistant, and a Position
map before place details in every response format.

### Added

- 🔎 **Search meeting minutes before pagination.** Titles and complete current
  minutes participate in the same owner-scoped search as the result count.
  Accents and literal wildcard characters, cancelled requests and navigation
  back to the filtered list retain their tested behavior. No LLM call is added.
- 🤝 **Share skills, MCP servers and plugins with an accepted peer.** A reviewed,
  digest-bound package installs as an independently owned disabled copy, with
  sender/time provenance and native management. No credential, OAuth grant or
  approval exemption transfers. Durable claims, fencing, receipts and retention
  bound recovery and prevent retry from overwriting recipient changes. Enabled
  peer skills follow the explicitly accepted authored-policy exception; ordinary
  third-party imports retain isolation. See ADR-350 and the transfer guide.
- 🏷️ **Native advisory email and appointment labels.** Independent off-by-default
  JEV usages classify authorized visible evidence: email work/personal/spam/
  phishing-scam and one normal/urgent/critical priority; appointment work/personal.
  Unknown stays unlabelled, normal priority stays quiet, and the assistant reads
  the same accepted annotations. Owner/account/evidence/policy/time-bound cache
  identities and bounded coalescence preserve quotas and actual cost accounting.
  The red phishing badge has a finite attention halo and static reduced motion.
- 🗺️ **One Position card before selected native Google Places**, in Cards, HTML
  cards, HTML and Markdown. The card appears automatically; interactive Maps
  requires explicit cost-disclosed activation through the shared admission/SDK
  lifecycle. Missing coordinates/configuration and network failure retain usable
  source links; antimeridian and overlapping locations are covered. See ADR-352.
- 🏠 **Optional interactive Maps in the installer.** Hidden browser-key and
  Cloud-map-ID questions may both be skipped. A complete env-safe pair enters
  only the private environment, never public state, logs or LLM bootstrap.
  Reconfiguration preserves operator values; bootstrap resumption does not ask
  for environment credentials again. Production rejects demonstration IDs.
- 🎬 **Editable presentation-film sources and provenance.** The staged full-film
  scenes, deterministic timing tests, original recording receipts and offline
  score edit join the authoring tools. Preview packaging uses a configurable
  local origin; font and generated-music terms accompany the sources. No new
  paid media generation or runtime dependency is introduced.

### Fixed

- 🔒 **Native MCP and plugin management keep their closed metadata contracts.**
  Sender/time badges remain visible in settings; their UI provenance is excluded
  from assistant reads and confirmation snapshots. Existing MCP management
  operations stay usable, without relaxing validation or forwarding private data.
- 🩺 **CI PostgreSQL health probes use their declared database identity.**
  Readiness no longer creates misleading `role "root" does not exist` messages
  while reporting a healthy throwaway database.
- 🧮 **JEV accepts feasible cent-rounded probability mass consistently.** The
  common native validator and annotation policy preserve raw weights and
  conservatively cap concentration, rather than rejecting the provider's
  approximate sum or increasing a winner to fill missing mass. Invalid
  schemas/options/winners/mass still fail atomically and retain known bills.
- 🧠 **Semantic coverage is qualified separately from numerical validity.**
  Generic email questions distinguish reported severity from authentication,
  actual deceptive requests from security topics, and spam from unethical
  advertising. Fixed calibration, validation and post-freeze adversarial corpora
  pass without lowering confidence thresholds or changing expected answers.
  Critical holdout cases become displayable; no population-accuracy claim is made.
- 🗺️ **Unavailable Maps no longer reserve a blank stage.** Explicit browser-key
  and Cloud-map-ID configuration replaces a hidden server-key fallback. Paid
  maps survive theme changes without reconstruction and cannot publish into a
  superseding account context.
- 📊 **Analyzer metrics retain the model captured with their operation**, even
  when an administrator changes the slot while later context work is running.

- 🔑 **An installation no longer presents someone else's OpenAI organization.**
  `openai_organization_id` defaulted to a constant named for another setting, and
  that constant had held the maintainer's real organization id since v1.29.0. The
  adapter sends the setting as the `organization` of every OpenAI client, and
  `.env.min.prod.example` — the installer's template — declares no
  `OPENAI_ORGANIZATION_ID`, so every installation the installer wrote presented
  that organization with its own key. The setting now defaults to empty (an
  organization is sent only when the operator sets one); `openweathermap_api_key`
  borrowed the same kind of constant and defaults to empty too.
- 📱 **An Android shell no longer receives someone else's Firebase project.**
  `firebase_project_id` defaulted to the maintainer's project: an operator who
  set the app id, the API key and the sender id but no project id published a
  mixed set to every Android shell. It defaults to empty, and the push
  configuration is offered only with all four values. The unread
  `telegram_bot_username` setting, which held the maintainer's bot, is gone
  (the bot's name is discovered at startup).
### Removed

- 🧹 **The env settings of fourteen LLM slots, which nothing read** (ADR-244
  amendment 2026-10-18 b): the voice comment and the thirteen domain agents
  resolve through `LLM_DEFAULTS` and the admin overrides. 126 settings fields, 98
  constants (twelve still named `gpt-4.1-nano`, which retires on 2026-10-23), their
  ranges in `scripts/validate_config.py` and `scripts/validate_llm_config.py` — a
  validator no command ran and which no longer imported — are gone. Unknown
  variables are ignored, so a `.env` still carrying one keeps booting.
- 🧹 **Fourteen more LLM env families, and the unread fields of two others**: the
  planner, the semantic validator and pivot, the three HITL slots, the memory,
  interest, heartbeat, broadcast and query-agent slots; `response` and
  `query_analyzer` keep their timeout alone. 97 constants, their validators and
  the LLM keys `scripts/validate_config.py` checked go with them.
- 🧾 **`scripts/validate_config.py` checks only keys something reads**: 27 more
  (`ENABLE_*_MIDDLEWARE`, `*CIRCUIT_BREAKER_ENABLED`, `RATE_LIMIT_CONTACTS_*`,
  `ROUTER_*`, `TOOL_APPROVAL_ENABLED`, `SEMANTIC_VALIDATION_ENABLED`...) named
  settings nothing declares. The env examples no longer document
  `ENABLE_FALLBACK_MIDDLEWARE=false` (the fallback chain is on) nor
  `LANGCHAIN_CALLBACKS_BACKGROUND` (LangChain 1.x reads nothing), and the
  degraded-mode runbook switches capabilities off instead of writing variables
  that change nothing.

### Tests

- 🧪 Native fictional semantic evidence covers calibration, distinct validation
  and new multilingual adversarial observations, plus the actual service/Redis
  path. All historical and new attempts are reconciled with the real ledger.
- 🛡️ The 23 registered JEV usages exercise single, batch and mixed Choice/Noul
  transport contracts under valid rounded and malformed responses: 138 tests,
  including quota admission, atomic publication and one retained bill.

- 🛡️ `test_settings_default_family_guard.py`: a setting reads its default from a
  constant of its own family, or the pair is declared with its reason
  (shrink-only) — the shape that let a production organization id become a
  default.

### Documentation

- 📚 FAQ, release history, public presentations, relevant blog articles,
  settings search and FAQ-derived knowledge updated in six languages; living
  functional/technical maps and decision history include ADR-350–352. JEV's
  qualification record retains failed candidates and the limits of its evidence.

- 🔗 Seventeen broken relative links in four dated plans now resolve; the
  « effective production configuration » table of `GETTING_STARTED.md` names the
  models production runs (no slot runs `gpt-4.1-nano`), and the documents that
  described the removed settings point at the slot instead. `LLM_PROVIDERS.md`
  is rewritten around the one mechanism (code defaults + admin overrides) — its
  examples were `.env` blocks for settings that configured nothing — and the
  2026-08-06 spec no longer quotes production identifiers.

## [3.2.0] - 2026-10-18

**A FAQ for every feature.**
Ten new sections — the home page, Telegram, calculations and scripts, habits,
generated files and kept answers, the personal radio, LIA's psyche, the
transparency registers, administration and self-hosting — and the existing ones
completed: 491 questions in six languages, where there were 375.

**Voices that react, cues that fit.**
On the radio, a chuckle, a laugh or a sigh may open a turn of a discussion or a
debate, never the news read out. In a spoken comment a cue colours the news,
never how LIA's own act went. A four-voice debate is no longer refused whole: it
is split into takes the engine accepts.

**A switch holds in both execution modes.**
The tools a switched-off capability names leave the Pipeline planner and the
ReAct loop alike, a delegated sub-agent and a skill's ready-made plan included —
the Workboard, LIA connections, MCP servers and Skills switches still close their
pages alone —; the bookmark, the avatar's mood and the voice's prosody follow
their own switches.

**An installation you can change, a supervision that tells the truth.**
`./install.sh --reconfigure` changes a running installation without reinstalling
it, and the Google Gemini key becomes an optional question. The daily report
reads the alerts that fired, the latency alert measures only a person's wait, an
incident whose resolution was lost closes itself, and a slot's output budget is
held to what its model accepts.

### Added

- 🎙️ **The radio's voices react where a programme converses** ([ADR-324](docs/architecture/ADR-324-A-Personal-Radio-A-Grid-Decides-Models-Only-Write.md) decision 45):
  a chuckle, a laugh or a sigh may open a view or a transition of a discussion,
  a debate, the editorial, the opening or the sign-off — never the news read
  out — at most `RADIO_REACTIONS_MAX` (2) per programme, and only the sounds the
  station's voice performs. The editor silences one out of place and the line
  still airs. Measured on four model families (48 scripts): 11 discussions of
  12 reacted at the story's turns, no bulletin ever did, and the editor
  silenced the four reactions written on a fact line. ElevenLabs v4 and Gemini
  3.8 play the chuckle every time; Fish Audio's free model mostly as a short
  beat.
- 📊 **What the radio's voice cannot express is counted**:
  `radio_delivery_unrendered_total{dimension}` (energy, pace, tone, reaction),
  a new panel on dashboard 31. The segment already recorded it; nothing read it.
- ❓ **The FAQ covers every feature you can use**: ten new sections — the home
  page, Telegram, calculations and scripts, habits, generated files and kept
  answers, the personal radio, LIA's psyche, the transparency registers,
  administration and self-hosting — and the existing ones completed, in six
  languages: 491 questions, against 375. The radio, among others, had no
  section at all.
- 🔑 **The installer asks for an optional Google Gemini key** ([ADR-215](docs/architecture/ADR-215-Self-Host-Installer.md) amendment 2026-10-18):
  memory recall, every search by meaning and image analysis run on it. An
  empty answer skips it, and the final report names every capability left
  waiting for a key.
- ✨ **Two small-attentions cards with their animated scenes**: « Voices that
  react » — a commentator opens a reply with a chuckle, never a line of the
  news — and « The model's limit, in sight » — a budget above the model's cap
  flagged before saving, each request held to it. The page holds 100 cards.

### Changed

- 🗣️ **Each expression cue now says when it fits** ([ADR-345](docs/architecture/ADR-345-Fish-Audio-Served-Whole-One-Door-One-Allowance-Cues-Each-Engine-Reads.md) amendment 2026-10-17):
  the spoken comment's writer reads the meaning of every cue its voice
  performs, and keeps cues for the news — never for how its own act went (a
  confirmation, a failure, nothing found). Measured over four model families
  (336 comments each way): cues where nothing called for one fell from 34 % to
  25 % of the runs, cues that did not fit from 16 to 1, and the comments that
  call for a cue carry a fitting one 73 % of the time (53 % before). A comment
  that falls back to reading the answer, instead of the records it retained,
  now carries no cue at all, whatever its model writes. The example every
  cue-performing engine is shown is news (it was a confirmation of LIA's own
  act), and an engine that only pauses is no longer told about cues it
  cannot perform.
- 🎧 **Each engine that performs cues gets the expressions its vendor
  documents**, re-read on 2026-10-17: ElevenLabs Multilingual v2, Flash and
  Turbo pause with their SSML `<break>`; Gemini 3.8 hears a sentence's tone as
  that sentence's `style`; on every engine that plays it, « concerned » is played
  as concern rather than empathy.
  Verified on the vendors themselves: across 67 transcribed clips no cue was
  ever read aloud.
- 📰 **The daily operations report reads what actually happened** ([ADR-119](docs/architecture/ADR-119-Alerting-Reactivation-Minimal-Core.md) amendment 2026-10-18):
  it opens on a « Supervision LIA » section read from the systems that recorded
  the day — the alerts Prometheus fired, the alert chain's own health, the
  alerts active now, the incidents still open, container restarts and
  recreations, memory peaks, probe failures —, each source named when it cannot
  be read, never taken for silence — and a window in which a source recorded
  nothing reads « no measurement », never « nothing happened ». The tunnel
  section reads cloudflared's journal itself, counts each failed request once,
  by side (client gone, origin unreachable, other), groups an outage into its
  periods and reads traffic and HTTP codes from cloudflared's own counters;
  the Docker section presents itself as the dated snapshot it is. On production's report for
  2026-10-17 the old sections read « no restart, all stable » about a
  demonstrator API caught in a restart loop for six and a half hours, and
  counted 1,023 tunnel errors from log lines — two per failed request, client
  cancellations included.
- ⏱️ **The time-to-first-token alert measures a person's wait** ([ADR-119](docs/architecture/ADR-119-Alerting-Reactivation-Minimal-Core.md) amendment 2026-10-18):
  routines, tickets and call relays stream through the chat code and fed the
  latency histograms, so three morning routines fired `SSELatencyP95High`
  every morning from 2026-09-19 on. Only a turn a person waits for is observed
  now — one door, `streaming/latency_sli.py`, guarded by an AST test — and the
  rule evaluates only over at least `ALERT_CORE_SSE_TTFT_MIN_OBSERVATIONS` (20)
  turns in ten minutes: below that, a histogram's p95 is its slowest single
  turn.
- 🗣️ **The offline pages speak like the application**: the web offline page
  and the mobile shell's connection and offline screens address the reader
  in the familiar register in French, German and Chinese.

### Fixed

- 📅 **The catalogue states Google's latest shutdown dates** (migration `754351d42c74`):
  the Gemini 3.1 Flash TTS, 2.5 Flash and Pro TTS, 3.1 Flash Live and 2.5 Flash
  native-audio (12-2025) previews retire on 2026-11-17, so the administrator is
  warned to move to the 3.8 models; `gemini-2.5-flash-image` runs until
  2027-03-15, not the date already past it carried.
- 🎚️ **A switched-off capability leaves both execution modes** ([ADR-280](docs/architecture/ADR-280-Complete-Capability-Control.md) amendment 2026-10-18):
  its tools were removed from what the Pipeline planner sees and nothing else,
  so the ReAct loop still bound them — and the image and document tools, which
  read only the deployment flag, ran. The filter now applies once, to the
  turn's catalogue every reader shares — a delegated sub-agent included, whose
  default research tools searched the web with web search switched off, and a
  skill's ready-made plan, which the validator and the executor resolved from
  the global registry —; the image and document tools also refuse at their
  entry, and the administration panel says « in both execution modes ». The
  router's domain menu reads the same snapshot, so a domain whose every tool
  a switch withheld is no longer detected; the planner offers delegation
  only when the turn does; and a skill's plan judges each step with the
  turn's own resolver, never a stricter name match. The Workboard, LIA
  connections, MCP servers and Skills switches still close their pages
  alone, and the FAQ now says so. Reading the
  switches on every turn costs one cache read and at most one query: a switch
  nobody ever wrote is cached as absent instead of reaching the database each
  time.
- 🔖 **The bookmark follows the Bookmarks switch** ([ADR-282](docs/architecture/ADR-282-Message-Bookmarks.md) amendment 2026-10-18):
  switched off, the bubble kept offering a bookmark whose every click was
  refused. It now offers to keep nothing new, while an answer already kept
  keeps its mark and can be let go; what was kept stays readable,
  downloadable and deletable. The web reads every capability's effective
  state through one rule (`lib/capability-state.ts`).
- 🙂 **« Show emotional avatar » off returns every answer's face to neutral**:
  the switch only stopped the live mood, so every finished answer kept showing
  the mood stored with it.
- 🎙️ **The mood bends the voice only where the psyche is on** ([ADR-237](docs/architecture/ADR-237-voice-prosody-and-form.md) amendment 2026-10-18):
  the direct readout followed a mood frozen when the person switched the
  psyche off, and one who switched it off before any state existed was given
  one by their first readout (a spoken comment never bends the voice).
- 🔍 **Searches by meaning read the Gemini key set in LLM Configuration** ([ADR-069](docs/architecture/ADR-069-Gemini-Embedding-Migration.md) amendment 2026-10-18):
  memory recall, knowledge spaces, journals and interests read
  `GOOGLE_GEMINI_API_KEY` (else `GOOGLE_API_KEY`) from the environment, once.
  The administration key is now read first, at every call, so a key added
  there needs no restart — except for the tool ranking and the tool-context
  store's index, both built at boot.
- 🛠️ **`./install.sh --reconfigure` changes a running installation without reinstalling it** ([ADR-215](docs/architecture/ADR-215-Self-Host-Installer.md) amendment 2026-10-18):
  it fell through to a fresh install — every question asked again, the `.env`
  re-rendered from the template, the seeds re-armed, the images rebuilt, the
  typed provider keys replacing the stored ones. It now asks the routing and
  capability questions showing the answers in force, which Enter keeps;
  replaces each validated file in one atomic step after a private backup;
  recreates the containers without rebuilding; makes Caddy reread changed
  routes and stops the services of an option turned off; rewrites only the
  `.env` values the answers decide — every value it would change shown first,
  nothing applied until confirmed —; and, if the new stack does not come back
  ready or is interrupted (Ctrl-C, SIGTERM, SIGHUP, at any step of the swap),
  puts the previous files and stack back and checks them ready, logging the
  cause first and, should the restore itself fail, printing the exact
  Compose commands. Turning the sandbox on writes `DOCKER_GID` from the Docker
  socket's group. Moving a LAN install behind Caddy, impossible before, works.
- 📋 **The installer's final report names what stays degraded**: it was handed
  a hard-coded empty list. The bootstrap reports the capabilities left waiting
  for a key — from the keys the database holds, so a `--resume` that skips the
  optional key no longer reports a stored one missing — and the installer
  keeps that list for a later `--resume`.
- 🧭 **Nine messages named settings that moved**: the image-generation,
  health-data and two skill refusals, the two remote-dictation errors, the
  administrator's voice listing, the unserved image model and the voice-mode API
  description now point at the current place.
- 🌐 **Labels left in English are translated**: the reasoning fields of the
  administration's model dialog and the « other » slice of the register
  charts, in six languages.
- 🀄 **Chinese labels say what they mean**: the radio's brief (简讯) and news
  flash (插播快讯) no longer share one word; the columnist, the commentators and
  the automatic stop are named precisely; the workboard has one name
  (工作看板, where three alternated), « register » one word across the
  application (登记簿), the psyche keeps one word for the mood (情绪) and one
  for the emotions (情感), its tooltip included, and LIA's journals are 日记,
  never a log (日志).
- 🇩🇪 **German settings paths no longer read « Einstellungen › Einstellungen »**:
  the Preferences tab is « Präferenzen », and the FAQ paths name it — and the
  Konnektoren, Besprechungen and Verwaltung labels the German screens show.
- 📍 **The FAQ names the screens as they are**, in six languages: « LIA's
  journal » and « System RAG admin » instead of names they never had, and the
  workboard reached from My shortcuts or its settings section — it has no
  header entry.
- 📏 **A slot's output budget is held to what its model accepts** ([ADR-244](docs/architecture/ADR-244-LLM-Catalogue-Truth.md) amendment 2026-10-18):
  three production slots kept the 200,000-token budget chosen for their
  previous model when they moved to one whose output is capped at 128,000, and
  the provider refused every call — document generation failed. One rule
  (`infrastructure/llm/output_cap.py`) holds a slot's `max_tokens` to the
  output cap a vouched catalogue row declares — `imported` or `verified`, on a
  provider that enforces one, the column default only where a vendored registry
  states that very figure — read by the slot resolution, the client door and
  the admin metadata; in doubt the request goes as configured. The LLM
  configuration screen flags a slot whose budget exceeds its model's cap — a
  badge on its card, a warning under the field while it is edited — and saving
  is never refused: the stored figure stays the administrator's to correct.
- 💓 **A stray source label no longer costs a whole heartbeat decision** ([ADR-135](docs/architecture/ADR-135-Heartbeat-Interest-Quality.md) amendment 2026-10-18):
  one word outside the source vocabulary rejected the entire decision on every
  structured-output path, and production lost three heartbeat ticks of five
  for one account once its decision slot ran a model with reasoning on. Case,
  spaces and hyphens are now repaired and a word naming no source is dropped
  and counted in a log (`heartbeat_source_labels_dropped`); the published
  schema is unchanged byte for byte and only canonical labels are stored.
- 🦙 **An unreachable Ollama address no longer slows every admin save** ([ADR-267](docs/architecture/ADR-267-Ollama-Native-Provider-And-Discovered-Capabilities.md) amendment 2026-10-18):
  while a configured server stayed off, every configuration reload — each save
  of any slot, each cross-worker invalidation — waited the five-second
  discovery timeout (production: 16 timeouts in 17 minutes). An address that
  answered nothing is asked again at most once per
  `OLLAMA_DISCOVERY_RETRY_SECONDS` (600; `0` keeps the former behaviour); a
  changed address is still discovered at once, and the admin's model listing
  still asks the server.
- 🎙️ **A radio debate keeps its takes** ([ADR-345](docs/architecture/ADR-345-Fish-Audio-Served-Whole-One-Door-One-Allowance-Cues-Each-Engine-Reads.md) amendment 2026-10-18):
  the anchor and three commentators were planned as one take of four voices,
  which Fish Audio refuses whole (« Reference audio too long »), so the
  segment fell back to line-by-line synthesis. Each engine family declares how
  many voices a dialogue take holds (`TtsFamily.dialogue_max_voices`: three on
  Fish, measured 10 of 10 accepted at three and 5 of 5 refused at four) and the
  planner opens a new take where one more voice would pass it; over 20,000
  seeded scripts the plan is unchanged wherever no take passed the limit.
- 🧾 **An incident whose resolution was lost closes itself** ([DIAGNOSTICS_DOMAIN](docs/technical/DIAGNOSTICS_DOMAIN.md)):
  an alert incident stayed open as long as its « resolved » delivery was
  missing — one for 28 days. Each self-check tick now closes an alert incident
  Alertmanager no longer holds as firing and that has had no news for
  `DIAGNOSTICS_INCIDENT_SILENCE_CLOSE_SECONDS` (an hour by default), with an
  audit entry; a silenced or inhibited alert counts as active, an unreachable
  Alertmanager closes nothing — nor one restarted less than five minutes ago,
  which lists nothing until Prometheus re-sends what is firing —, and
  Alertmanager is read outside the database transaction. The audit append
  itself, refused by PostgreSQL, had never run and now does. A malformed
  telemetry URL is now an unavailable source, no longer an exception that
  ended the whole tick, and the diagnosis pump waits on Prometheus, Loki and
  the model with no transaction open (ADR-304).
- 🚀 **The production deploy no longer stops before building**: the new
  logwatch tests wrote a `__pycache__` beside the extensionless scripts, the
  deploy bundle copied it, and `deploy.sh`'s `cp services/*` under `set -e`
  exited at step 4/7. The loaders write no bytecode, the bundle drops
  bytecode, and the deploy copies regular files only — each layer pinned by
  a test.
- 🧮 **A pricing workbook exported in German, Spanish or Italian imports back**:
  the reader refused the WAHR/FALSCH, VERDADERO and VERO its own writer
  wrote. One declaration now serves both, round-trip tested in the six
  languages.
- 🦙 **An Ollama slot's own context window reaches the server** ([ADR-278](docs/architecture/ADR-278-Per-Slot-Context-Window.md)):
  the factory handed the adapter a key its merged configuration never held,
  so `num_ctx` fell back to the discovered window while the compaction
  threshold and the ReAct budget read the slot's own figure — what LIA
  accounted with was not what it requested.
- 🔁 **A rollback no longer reads every untouched capability as off**: a
  switch nobody ever wrote is cached as an absence under a key family the
  previous release never reads (`system:capability:v2:`); read by v3.1.1, the
  marker decoded as « off » until its five-minute expiry.
- 🎤 **The Live voice sample outlives the 2.5 TTS shutdown**: it now speaks
  through the one Gemini TTS client, on the person's own key, and defaults to
  `gemini-3.8-flash-tts`; the deprecated-model guard also holds the sample,
  Live, embedding, search and diarisation defaults. A deployment that pins
  `LIVE_VOICE_SAMPLE_MODEL` keeps its own model.
- 🧩 **A plugin's skill says where it is managed**: its refusal sent the model
  to the Skills section; it now names the Plugins section, from which such a
  skill leaves with its plugin.

### Security

- 🔒 **`re2js` 2.8.8** through a pnpm override (GHSA-gg6h-894w-4m9c, high:
  quadratic-time lookbehind matching), found by the dependency watch — reached
  only through `firebase` → `@firebase/firestore`, which LIA never imports.
- 🔒 **`filelock` 4.2.2** under a security floor in the wake-word toolbox's two
  manifests (GHSA-v4x8-3wr5-3wq8, high, and thirteen more advisories), pulled
  by torch and the Hugging Face stack; the toolbox never reaches production.
  One more Pillow 12.3.0 advisory there (GHSA-5x8w-8jj5-q52h, FlashPix) is
  accepted on the same condition as the twenty-one before it: gradio still
  caps Pillow below 13, and the toolbox decodes no image.

### Tests

- 🧪 `test_turn_catalogue_single_authority_guard.py` (AST) keeps one builder of
  the turn's catalogue: the snapshot every reader shares is set from
  `build_turn_catalogue` alone, and the unfiltered base is built nowhere else.
- 🧪 The FAQ section registry guard holds the six locales' sections, the display
  order and the icons equal — a section translated in six languages but absent
  from the order rendered nowhere, with no test red.
- 🧪 The latency door is AST-guarded: nothing but `latency_sli.py` observes the
  two latency histograms (time to first token, stream duration), and the alert
  rule's negative case (a routine morning) is pinned in `promtool` tests.
- 🧪 The incident reconciliation runs on a disposable PostgreSQL (four cases,
  the audit append included), and its silence window is held to at least twice
  the webhook's repeat interval.
- 🧪 **The agents suite no longer hangs**: its voice fake refused the spoken
  comment's new `speaks_of_records` keyword, so one sequence failed and
  another waited forever — the CI step would have run until GitHub's six-hour
  limit. The fake records the value, the harness waits at most five seconds,
  and it now drives the real batch read of the switches.
- 🧪 New pins: the pricing workbook's true/false words over six languages,
  the router's domain menu under switches, the skill plan's canonical
  resolution, the planner's delegation section, the radio's reaction cues
  (boot-checked complete), the Live sample through real ffmpeg, logwatch
  loaders that write no bytecode and the deploy copy that skips directories.
- 🧪 The output cap is tested at its three readers, the heartbeat labels on
  every structured-output path, the dialogue takes over 20,000 seeded scripts,
  the installer's reconfiguration from interruption to restoration, and the
  bookmark, avatar and prosody gates on and off.

### Documentation

- 📚 **The decisions follow the code**: amendments to ADR-069, ADR-119,
  ADR-135, ADR-215, ADR-237, ADR-244, ADR-267, ADR-280, ADR-282 and ADR-345
  (two), ADR-324 decision 45, each mirrored in the ADR index;
  DIAGNOSTICS_DOMAIN, LLM_CONFIG_ADMIN, RADIO, VOICE, LOCAL_EMBEDDINGS,
  METRICS_REFERENCE, GRAFANA_DASHBOARDS, the self-hosting and observability
  guides, GETTING_STARTED and three alert runbooks say what the code now does;
  `CLAUDE.md` gains three rules (a slot's output cap, the turn's catalogue
  filtered once, the latency SLI's single door).
- 🌍 **The public surfaces**: the README; in six languages, the How,
  philosophy and story guides (the turn's catalogue, the output cap, cues by
  meaning, the radio's reactions and takes, the latency SLI and the daily
  report, incident reconciliation, `--reconfigure`); the « How LIA works »
  cards, rebalanced under their shrink-only length caps; the landing's radio and
  voice cards; three blog articles (observability, LLM configuration
  governance, voice mode); the FAQ answers and the help corpus, checked
  against the code; the settings search lexicon; three bricks of the living
  maps.
- 🌐 **The six languages reviewed key by key**: UI labels quoted as the
  screens show them, the familiar register restored outside the legal pages
  (French, German, Spanish, Chinese), examples without dialable numbers,
  configurable values stated as defaults, the help corpus aligned with the
  English FAQ, and LIA's journals called 日记 in Chinese.
- 🔢 **Figures that had drifted are corrected or let go**: the How guide and the
  observability article counted 29 vital alerts where the core holds 31, and the
  « How LIA works » card 27 capabilities where the registry holds 34 — both
  figures leave the prose, which a guard cannot hold; the governance article
  counted 86 LLM configurations instead of 87.
- 📜 **GitHub recognises the AGPL-3.0 license**: `LICENSE` is now the verbatim
  text published by gnu.org — the header line placed above it kept GitHub from
  detecting the license — and the copyright line moves to the README's License
  section. `SECURITY.md` 1.2 names no release line in its supported versions and
  lists the code scanning CI actually runs (CodeQL).

## [3.1.1] - 2026-10-17

**On a phone, LIA's companion stays where you put it.**
The eyes no longer step away from buttons and headings or fold into a dot on
their own on a small screen: you drag them, or minimize them to their restore
dot, and they stay there whatever the page does underneath. On the radio, the
station's music sits lower under every voice. The image library moves to
Pillow 13.0.0, which closes twenty-one advisories published the day before.

### Added

- 🎵 **« The music makes way »**, a small-attentions card with its own animated
  scene: a voice row and a music row, the music dipping fast before the first
  word and rising slowly after the last.

### Changed

- 📱 **On a phone, you alone place the companion** ([ADR-240](docs/architecture/ADR-240-expressive-eyes-widget.md) amendment):
  below 1024 px the widget runs no avoidance and has no compact mode. The
  v3.1.0 placement re-solved its spot against every control and heading on
  each scroll, so it jumped while you scrolled, and it stayed a dot on every
  page but the chat. A drag, the arrow keys or the minimize button are now the
  only things that move or fold it; on a wide screen only the default spot —
  never one you chose — still steps off a control. The placement helper drops
  the panned-viewport offset that only the phone path read.
- 📻 **The radio's music steps back under the voices** ([ADR-324](docs/architecture/ADR-324-A-Personal-Radio-A-Grid-Decides-Models-Only-Write.md)):
  the music bed goes down to about −16.5 dB under every programme (−12 dB
  before), still in 0.35 s before the first word and back up in 1.2 s after
  the last.

### Removed

- 🧹 The « The companion makes room » card and its animated scene leave the
  small-attentions page, which keeps its 98 cards in six moments.

### Security

- 🔒 **Pillow 13.0.0** (security floor `Pillow>=13.0.0` in the API and sandbox
  manifests): twenty-one advisories from Pillow's own repository, one critical
  (GHSA-v9pv-5gc8-w2m6, multi-frame loaders reusing stale native storage) and
  nine high (JPEG and TIFF heap overflows, decompression-bomb bypasses). LIA
  decodes images a stranger can send — uploads, mail attachments, image edits —
  so the floor moves the runtime, dev and sandbox locks together; no API the
  code uses was removed, and `pillow-heif` and `python-pptx` accept the new
  line. The wake-word GPU toolbox alone keeps 12.3.0, because `gradio` (required
  by VoxCPM) caps Pillow below 13: it decodes no image and never reaches
  production, and each advisory is accepted there with that reason until
  `gradio` lifts its cap.

### Tests

- 🧪 The widget tests pin a phone where nothing moves the companion: a saved
  spot and the default corner stay unchanged, face whole, under a heading, a
  control, a scroll and a resize. The mobile settings smoke checks that the
  companion keeps its spot across scrolling while the search restores the
  settings rail, and the avoidance hook's tests keep the wide-screen default
  only.
- 🧪 Every authenticated end-to-end journey on a phone starts with the
  companion minimized and its dot moved aside, unless the spec stored a
  companion preference of its own (every companion spec does) — what a person
  reading and tapping would have done; at its default corner it covered a
  control in ten journeys. One helper file (`e2e/fixtures/companion.ts`) holds
  it, and the meetings and notifications fixtures reuse its `minimizeCompanion`.
- 🧪 The notifications layout checks read every box they compare in one frame
  and wait for the layout to settle: two separate reads could straddle a
  reflow, and the spec had gone flaky at 320, 390 and 1440 px for that alone.
- 🧰 `task test:e2e` blanks the telemetry and showroom build flags a developer
  `.env` sets, as CI does: baked on, telemetry posted `/product/events` from
  every page past the network guard and failed four settings journeys locally.

### Documentation

- 📚 ADR-240 records the 2026-10-17 decision, mirrored in the ADR index and in
  `docs/ARCHITECTURE.md`; ADR-324 states the new music level. The FAQ answer on
  LIA's eyes, the « How LIA works » radio card and the landing's radio card, the
  how and why guides, three blog articles (voice mode, security architecture,
  psyche engine), the help corpus and the functional map's radio brick say the
  same in the six languages.

## [3.1.0] - 2026-10-17

**Your mailbox drafts, managed from the conversation.**
LIA now keeps drafts in your own Gmail, Outlook or iCloud mailbox: it saves a
new one, prepares a reply or a forward as a draft, lists them, edits them and
moves them to the trash without asking, because nothing reaches anyone. Sending
a draft is the one act that asks first, on a card showing the draft as your
mailbox holds it.

**A fifth voice, Fish Audio, and voices that perform.**
Fish Audio joins the speech engines: five synthesis models, transcription for
the voice mode and the meetings, and a voice library administrators clone and
design into. A sentence heard is billed once, by the engine that spoke it; LIA
writes a few expressive cues where an engine performs them, and the radio voices
its exchanges in one take.

**An assistant that learns where it is reliable — from evidence, never from its own grade.**
LIA keeps a private experience per domain on two axes that are never merged:
what a turn verifiably achieved, and what you found useful. Where the evidence
is thin it checks once, asks one question or names what it could not verify;
its own mood score no longer passes for competence.

**A home page, settings and lists redrawn for reading.**
Today opens on the date and LIA's living face; meetings and calls read as
timelines; LIA's psyche is drawn; panels alternate their depth, a button keeps
its label while it waits, documents show their first page, and an error is
never shown as an empty list.

### Added

- 📮 **Mailbox drafts** ([ADR-344](docs/architecture/ADR-344-Mailbox-Drafts-Kept-Freely-Sent-After-One-Confirmation.md)):
  six tools over one client contract shared by Gmail, Outlook and iCloud —
  list (filtered by recipient, subject or words, limited to the number asked),
  create, prepare a reply (written by LIA from the received e-mail when you
  dictate nothing) or a forward, edit (by value or by instruction, the quoted
  message kept), and trash one, several or all of them, at most
  `EMAIL_DRAFTS_BULK_MAX` per call with what remains stated.
- 📤 **Sending a draft asks once:** the card shows the draft as the mailbox
  holds it; a draft edited in the mailbox since is not sent, and a change asked
  on the card is written to the draft before it leaves. Several drafts are
  confirmed as one lot.
- 🐟 **Fish Audio speaks** ([ADR-345](docs/architecture/ADR-345-Fish-Audio-Served-Whole-One-Door-One-Allowance-Cues-Each-Engine-Reads.md)):
  `s2.1-pro`, `s2.1-pro-free`, `s2-pro`, `s1` and `drama-3` on the voice and
  radio slots, billed per UTF-8 byte of the text, with output format, latency,
  speed and transport (HTTP or the real-time WebSocket, whose session is answered
  over HTTP when it falls silent) tuning; `s1` carries the retirement its vendor
  announced. The picker offers the account's own voices,
  the vendor's licensed ones and the public voices an administrator pinned after
  attesting the right to use them.
- 🎙️ **Fish Audio transcribes:** `transcribe-1` and `transcribe-1-pro` serve the
  voice mode's remote dictation and the meetings, speakers separated; a
  recording longer than one request takes moves to the next engine before it is
  uploaded.
- 🧬 **A voice library for administrators** (Settings › Administration › Voice
  library): clone a voice from recordings under a consent attestation filed in
  the audit log before anything leaves, design one from a description — a flat
  price (`FISHAUDIO_VOICE_DESIGN_COST_USD`) charged to the instance's daily
  budget —, rename or delete them; a voice a slot speaks with is never deleted.
  `FISHAUDIO_VOICE_CREATION_ENABLED` switches creation off (off on the
  demonstrator).
- 🎭 **Expressive cues where an engine performs them:** the spoken comment
  carries a few (a sigh, a laugh, a whisper) under one budget
  (`VOICE_EXPRESSIVE_CUES_MAX`) and each radio line one from its tone, written in
  each engine's own syntax — ElevenLabs v3 and v4, Fish Audio's S2 models, `s1`,
  `drama-3`, Gemini.
- 🎧 **The radio voices a dialogue in one take** on the engines that voice
  several speakers: each turn is placed by the vendor's timestamped stream, and
  a take that cannot be placed is voiced line by line.
- 🗣️ **LIA's voices are yours to choose** ([ADR-345](docs/architecture/ADR-345-Fish-Audio-Served-Whole-One-Door-One-Allowance-Cues-Each-Engine-Reads.md), amendment
  2026-10-14): in Settings › Voice mode, pick LIA's male and female voice among
  the voices of the engine that speaks in the chat, each list opening on the
  administrator's voice. The choice is kept per provider — a model change keeps
  it, a provider switched back to finds it — and applies to the voice comments and
  to what LIA reads aloud;
  the radio, live sessions and phone calls keep their own voices. It is part of
  your account's export, and erased with your account.
- 🌐 **The voices of your language, at a switch:** every voice picker — the
  administrator's voice slots, the radio's roles, LIA's voices — offers « only
  voices in my language, and multilingual ones », on by default, never hiding a
  voice already chosen.
- 🔊 **Hear a voice before you keep it:** choosing a voice for LIA or for one of
  the radio's roles plays a short sample of it at once, in your language, with
  one control to stop it or play it again; a newer choice cancels the previous
  sample, a radio that is playing pauses, and a meeting recording or a Live
  session keeps priority. Two doors serve it (`POST /voice/lia-voices/sample`,
  `POST /radio/voices/sample`): authenticated, capability-gated and rate-limited,
  they take no free text from the browser and bill the sample like any reading —
  the radio's budget counts it too.
- 📊 **Every failed step of a pipeline plan is counted under its typed code**
  ([ADR-346](docs/architecture/ADR-346-Advisory-Replanner-Retired-A-Pipeline-Failure-Is-Said-Never-Replayed.md)):
  `pipeline_step_failures_total{error_code}`, dashboard 07 « Pipeline Step
  Failures » — a failure that happens before a tool is called, such as a
  reference to an earlier step that could not be resolved, included: no tool
  metric and no register saw it.
- 🎙️ **The radio's commentators speak with the voices you choose** ([ADR-324](docs/architecture/ADR-324-A-Personal-Radio-A-Grid-Decides-Models-Only-Write.md)
  decision 43): the three commentators of debates and discussions get a voice each
  in the radio settings, automatic by default as before. A commentator never
  shares a voice with LIA, the anchor or another commentator: the settings grey those
  voices out and a save refuses them (`radio_voice_shared`).
- 🧭 **What a read tool finds reaches the answer** ([ADR-347](docs/architecture/ADR-347-Read-Tool-Data-Reaches-The-Pipeline-Answer-A-Declared-Failure-Is-Never-A-Success.md)): in the
  default mode the answer was written from a sentence about the data — « 2
  destinations » — while the travel times, the connections or the next page
  of a search sat beside it unread. The data now reaches it as in the
  autonomous mode: everything the cards do not already show, wrapped as
  third-party content, within a budget, every cut stated. Measured before:
  0 of 9 answers gave the travel times, 27 of 27 with the data.
- 🧭 **LIA learns where it is reliable, from evidence** ([ADR-348](docs/architecture/ADR-348-Efficacy-Learned-From-Evidence-Results-And-Usefulness-Kept-Apart.md)):
  seven domains — planning, information, emotional support, creativity,
  technical, social, organization — keep a private experience on two axes never
  merged: what a turn verifiably achieved (the final coverage of the requested
  outcomes, never an HTTP status) and the usefulness you expressed (👍/👎 on the
  final answer). An index exists only from five observations within ninety days.
  With that evidence, LIA may verify a point the turn left open, ask one
  clarifying question or name what it could not check — in the pipeline, the
  autonomous mode and the answer alike — and changes no model, permission,
  budget or confirmation. Settings › LIA's psyche shows « No index yet »,
  « Learning » or « Observed » with each axis' basis; the evidence is exported
  with your account and erased by a full psyche reset or a purge.
  `PSYCHE_EFFICACY_COLLECTION_ENABLED` and `PSYCHE_EFFICACY_INFLUENCE_ENABLED`
  switch each half off. A pilot: no gain is claimed before a held-out comparison.
- 🔊 **Gemini voices the chat too** ([ADR-345](docs/architecture/ADR-345-Fish-Audio-Served-Whole-One-Door-One-Allowance-Cues-Each-Engine-Reads.md)):
  a chat voice slot set to Gemini used to speak through Edge, because the chat
  could not record a token-billed voice; every speaking surface now records
  through one door, so the chat speaks with the voice configured.
- 🏠 **A home page that opens on your day:** the date is the page title and
  rolls over at midnight in your time zone; a compact welcome card carries
  LIA's live face, a one-click switch to the other avatar, the greeting and its
  cost; the radio, your shortcuts and « My dashboard » follow, and they still
  render when the briefing fails. LIA's briefing can be folded, listened to and
  cancelled while its voice loads, and says when a refresh failed. The agenda
  groups events by day on a timeline, each one an interval with its time-zone
  offset when a clock change falls inside; birthdays say the age, documents
  their type, the weather draws its sky, health colours its figures, and the
  workboard card counts the tickets held with your connections and previews the
  first two of each count. Consumption is one table, with input, output and
  cached tokens and the Google API requests.
- 🗓️ **Meetings and calls read as timelines:** grouped by local day and by
  period (night, morning, midday, afternoon, evening), with start and end
  times — an end is never guessed from a duration — and, for meetings, how the
  format was chosen, the indexing state and the engine that transcribed it.
- 🔔 **The alerts hub in two groups:** « Upcoming and to follow up » and
  « Already received », proposals answered by two visible buttons, full texts,
  and readable source names in the histories.
- 🧠 **LIA's psyche, drawn:** emotion rings around the mood, a pleasure ×
  arousal plane, the personality's Big Five pentagon, ring meters for the
  relationship, the drives, the new experience panel and an evolution chart on
  a true time axis — every instrument a labelled meter.
- 👁️ **A preview before you choose a display mode:** Settings › Display mode
  draws a sample answer in each format, and each mode says in one line what
  sets it apart — « Cards » keeps a classic paragraph beside the cards, « HTML +
  cards » composes a synthesis with a title and a takeaway around the same cards.
- 📄 **Generated documents show their first page:** in the gallery, a PDF shows
  its real first page and a text or Office file an excerpt labelled as such,
  loaded only when the card nears the screen.

### Changed

- 🔇 **The radio's second-model verification is off by default:** a listener
  who never chose gets no model check (`RADIO_VERIFICATION_DEFAULT=off`), since
  each check is billed and can delay the listening; « Verify the news » and
  « Verify everything » stay one choice away in the radio settings.
- 💶 **A sentence heard is billed once, by the engine that spoke it:** every
  speaking surface goes through one synthesis door and is recorded in that
  engine's own unit — characters, UTF-8 bytes, or the tokens a vendor reports.
- 🚦 **One request allowance per vendor account:** Fish Audio has its own
  (`FISHAUDIO_MAX_CONCURRENCY`) beside ElevenLabs', on one seam shared by every
  worker; every Fish Audio request — synthesis, transcription, voice design, the
  voice listing — takes a slot, so a request past the account's limit waits its
  turn within its own bound instead of meeting the vendor's refusal.
- 📌 **The pinned public Fish Audio voices are shared:** one list for the chat's
  and the radio's voice slots, the slots' former pins merged into it, under a
  ceiling the operator sets (`FISHAUDIO_PINNED_VOICES_MAX`). Pinning
  and unpinning take effect at once, the attestation is filed in the audit log
  before a pin is stored, and a voice a slot speaks with cannot be unpinned.
- ⏱️ **The ElevenLabs voices offered in the voice mode and radio settings are
  read from a ten-minute cache,** so a voice turn never waits on the vendor's
  listing; the administration's picker still reads the account live.
- 🧠 **LIA's self-rating no longer counts as competence** ([ADR-348](docs/architecture/ADR-348-Efficacy-Learned-From-Evidence-Results-And-Usefulness-Kept-Apart.md),
  [ADR-068](docs/architecture/ADR-068-Psyche-Engine.md) amendment 2026-10-16 b):
  the old self-efficacy score, fed by LIA's own rating of a conversation into
  « emotional support », and the caution it injected on « weak domains » are
  retired; the self-report keeps feeding the mood, the emotions and the
  relationship. Old scores stay readable and are not converted.
  `PSYCHE_SELF_EFFICACY_PRIOR_WEIGHT` has no effect any more.
- 🎙️ **The remote dictation cap names no vendor:**
  `ELEVENLABS_STT_MAX_AUDIO_DURATION_SECONDS` becomes
  `REMOTE_STT_MAX_AUDIO_DURATION_SECONDS` (the old name is still read), and
  `FISHAUDIO_STT_ENABLED` switches Fish Audio transcription off like its
  ElevenLabs sibling.
- 🎧 **Dialogue takes are bounded and counted:** `RADIO_DIALOGUE_MAX_BYTES`
  (`0` voices every line alone) and `radio_dialogue_takes_total` (dashboard 31);
  a Fish Audio socket answered over HTTP is counted by
  `voice_tts_transport_fallbacks_total` (dashboard 11).
- ⏸️ **A personal MCP server that fails to connect is paused** ([ADR-224](docs/architecture/ADR-224-Conformite-MCP-2026-07-28-SDK-v2.md),
  amendment 2026-10-13): it used to be retried at every turn, each attempt up to
  its timeout. The pause starts at `MCP_USER_FAILURE_PAUSE_BASE_SECONDS`, doubles
  up to `MCP_USER_FAILURE_PAUSE_MAX_SECONDS` and is shared by every worker; a
  success, an edit or a re-authorisation lifts it, and the manual test ignores it.
- 🗜️ **A compacted conversation keeps its identifiers** ([ADR-086](docs/architecture/ADR-086-Conversation-History-Compaction-v2.md),
  amendment 2026-10-13): an id, a URL or an address the summary dropped is
  written back under it, marked untrusted when it came from third-party content,
  up to `COMPACTION_IDENTIFIERS_REINSERT_MAX` per list.
- 🧩 **The step limits of the expert, browser and MCP loops count graph steps**
  ([ADR-083](docs/architecture/ADR-083-Sub-Agent-Delegation-React.md),
  amendment 2026-10-13 b): N steps buy N÷2 model calls, the last one writing the
  answer. The lowest accepted values rise — `SUBAGENT_DEFAULT_MAX_ITERATIONS` ≥ 2,
  `BROWSER_REACT_MAX_ITERATIONS` and `MCP_REACT_MAX_ITERATIONS` ≥ 4 —, and a
  `.env` below them now refuses to start.
- 🔐 **Mail servers must present a valid certificate:** LIA's own SMTP relay and
  iCloud's SMTP and IMAP verify the certificate and the host name before logging
  in, where `STARTTLS` used to accept any certificate. A relay with a
  self-signed certificate must be given a trusted one, or the verification and
  notification e-mails will not leave.
- 🌐 **Browser sessions are admitted atomically** ([ADR-059](docs/architecture/ADR-059-Browser-Control.md),
  amendment 2026-10-15): one Redis registry with per-entry expiry (Redis 7.4, as
  Compose and the installer ship), so a stale worker can no longer overwrite a
  newer context and every worker cleans its own idle ones.
- 🎨 **Panels read their depth:** a panel inside a panel takes the darker tone,
  then the lighter one again, in light, dark and absolute black alike, and a
  field takes the opposite tone of the panel it sits in.
- ⏳ **A button keeps its label while it waits:** it shows a small spinner,
  keeps its size and its focus, and ignores a second press; pagination,
  toolbars and row actions follow the same rule.
- ⚙️ **Settings, tidied:** absolute black is a fourth choice beside light, dark
  and system (no separate switch); the avatar saves itself as you choose, the
  last choice winning and a failure rolling back with Retry; the geolocation
  status is a badge beside its title; LIA's voice, the hands-free panel and the
  voice-mode description are grouped; avatar style moves to Features › Identity
  & Memory beside LIA Style, both redrawn; the connections, the consumption
  export, the knowledge spaces and the MCP servers are laid out as cards; the
  routines' week view starts closed; « Rich HTML » is « HTML » and « HTML Cards »
  « Cards »; in French the page is « Réglages » and in Spanish « Ajustes », like
  the navigation.
- 🏷️ **Shorter section names, the old ones still found:** seventeen settings
  sections take the name their menu shows — « Skill permissions », « My phone »,
  « Data export », « Usage export », « My favorites », « Live voice mode »… — in
  the six languages, the FAQ, the help corpus and the guides; the settings
  search still finds each one by its former name.
- 📱 **On a phone, the companion makes room:** LIA's eyes step away from the
  search field, buttons and headings, and shrink to a dot when there is no free
  space — your chosen spot is never overwritten. Opening a settings section
  moves the focus to it, and « Back » returns to the item you came from.
- 🧭 **Back where you were:** opening a person in Relations keeps the search,
  the filters and the scroll, accents are ignored and « Clear filters » is one
  tap; the meetings list keeps its page in the address, and « Back » from a
  meeting returns to it. The FAQ opens on its version history.
- 🔔 **The notifications hub is « Alerts »**, like its navigation entry (« Alertes »,
  « Hinweise », « Avisos », « Avvisi »).
- 🏗️ **Build and scan:** the image scan (`task security:scan:docker`) now fails on
  a HIGH or CRITICAL finding, and the web production image no longer copies the
  whole package store into its build stage.
- 🔒 **Next.js 16.4.1:** the web front moves to the release that closes the
  advisories published with it — two critical remote code executions and a
  denial of service through Server Actions, which the settings pages use — and
  `undici` gets a floor of 7.30.1. The new router's route prediction is switched
  off (`experimental.optimisticRouting`): the language middleware rewrites every
  default-language path, and a predicted route made a public page fetch its
  1.8 MB layout segment again several times a second; a browser test now names
  that loop.

### Removed

- 🧹 **The advisory re-planner** ([ADR-346](docs/architecture/ADR-346-Advisory-Replanner-Retired-A-Pipeline-Failure-Is-Said-Never-Replayed.md),
  superseding ADR-128): the analyzer that followed every failed pipeline plan
  advised retries and re-plans that nothing ever ran — measured in production,
  it called « transient » each failure of the week, none of which was. It goes
  with its two metrics and the `ADAPTIVE_REPLANNING_MAX_ATTEMPTS` and
  `ADAPTIVE_REPLANNING_EMPTY_THRESHOLD` settings (a line left in a `.env` is
  ignored). A failed step is stated in the answer, a passing outage is retried
  by the client that met it, a plan the validator rejects is re-planned before
  it runs, and the ReAct mode remains the one that corrects itself. The FAQ,
  the How guide, two blog articles and the README no longer describe a
  recovery that never ran.
- 📐 **Two plan step types that never ran** ([ADR-346](docs/architecture/ADR-346-Advisory-Replanner-Retired-A-Pipeline-Failure-Is-Said-Never-Replayed.md),
  amendment 2026-10-14): `REPLAN`, refused by the validator, and `HUMAN`,
  accepted then failed at execution. Nothing produced them but a skill
  template, and no production skill declares one. A test now holds the plan
  step types equal to what the executor runs.
- 🗑️ **The stale `apps/api/coverage.json`**, a February coverage report at
  39 % that nothing read; coverage JSON output is now ignored like the others.
- 🧹 **`BROWSER_MEMORY_LIMIT_MB` and the `browser_memory_bytes` gauge**, which
  nothing enforced or sampled ([ADR-059](docs/architecture/ADR-059-Browser-Control.md),
  amendment 2026-10-15); the dashboard shows the API workers' memory instead.
- 🗂️ **The « Why does LIA think this? » block under memories, interests and
  journal entries:** the lists show the entries and their editing actions; the
  references stay available through the API
  ([PROVENANCE_AND_CAPABILITIES](docs/technical/PROVENANCE_AND_CAPABILITIES.md)).
- ✂️ **Screen elements that repeated another one:** the recent-meetings block of
  the meetings settings and the templates shortcut of the meetings list (both
  stay reachable from Settings), the alerts hub's « Advanced settings » links,
  the home page's large photo hero.

### Fixed

- 🐳 **The development web container starts after a Next.js upgrade:** its
  entrypoint now checks that Next.js resolves at the version the manifest names
  before trusting its install marker, repairs from the frozen lockfile, and stops
  with the rebuild command when the repair fails — a stale image had served
  « You are offline » on a `MODULE_NOT_FOUND`.
- 🏷️ **The FAQ version history wears its emoji again:** the eleven releases from
  v2.1.0 to v3.1.0 had lost the emoji that opens every title, in all six
  languages; a test now holds every title since v1.20.12 to it.
- 🎚️ **The radio's voices survive a change of model:** they were kept per provider AND
  model, so every model change of the radio's voice slot handed you other voices — or
  automatic ones. They are kept per provider now, every model of which offers the same
  voices, and the choices made on an earlier model are still read.
- 💡 **A light, room or scene that does not exist is no longer « switched »:**
  the Hue commands answered a refused command as done, and LIA said so; they
  now answer that the target was not found, naming the ones that exist. Every
  connector tool is held to the same verdict ([ADR-347](docs/architecture/ADR-347-Read-Tool-Data-Reaches-The-Pipeline-Answer-A-Declared-Failure-Is-Never-A-Success.md)): a refusal
  is never turned into a success on its way to the answer.
- ✅ **A task that could not be marked as done is no longer filed as done:**
  completing a Google task answered in a legacy format no reader of the
  verdict could read, so a refused completion reached the actions LIA
  performed, and the tool metrics, as a success. It now reads as the failure
  it is, and every connector tool answers in the format that carries a
  verdict.
- 🔁 **A repeated action with one failed item keeps the others:** creating
  three reminders with one refused lost the confirmations of the two that
  were created; the answer now confirms them and states the one that failed.
- 🪞 **A person's 360° overview is read once** in the autonomous mode, where it
  arrived twice.
- ↩️ **A reply's confirmation shows, and sends to, whom it reaches:** a reply to
  all no longer loses its other recipients, a reply to your own message no
  longer goes back to you, and on Outlook and iCloud the card names the
  recipient.
- ✏️ **Asking to « add Paul in copy »** while reviewing an e-mail no longer
  replaces its recipient, and a name after an address in a recipient list is
  now resolved from your contacts.
- 💶 **The cost of « Modify » on a confirmation** is billed to the turn that
  asked it.
- 🔎 **An Outlook search keeps what names the mail** ([ADR-287](docs/architecture/ADR-287-Email-Content-First-Detail-Levels-Digests-And-Neutral-Message.md),
  amendment 2026-10-13): « Marie's unread mails » used to list every unread
  mail, because the sender was dropped whenever a date or the read state came
  with it (5 searches in 7 days of production), and a person's relationship
  sheet listed every mail since its date as exchanged with them. The query is
  now one request Graph accepts; what it cannot carry — dates and read state
  beside a search, the star — is checked on the page, and a thinner page says
  how many it set aside. The same holds for the drafts listing, so deleting
  « my drafts to Marie from last week » no longer reaches older ones.
- 📁 **An iCloud message is read, trashed, forwarded and opened from its own
  folder:** its id now carries a digest of the folder, so a message listed in
  Sent can no longer be confused with the inbox message of the same number,
  and a forward no longer reads the inbox alone.
- 🔐 **Outlook and iCloud accounts are no longer judged « not connected »** in
  pipeline mode ([ADR-184](docs/architecture/ADR-184-Published-Bounds-And-Non-Prescriptive-Verdicts.md),
  amendment 2026-10-13): a step's Google scopes are checked only when Google
  serves it, and a skill keeps the e-mail, calendar and contacts steps another
  provider serves.
- 🧩 **The draft renderers import on their own:** a script or worker importing
  them first no longer fails on a circular import.
- 🧭 **A step that ran and failed is no longer reported as « blocked »**
  ([ADR-184](docs/architecture/ADR-184-Published-Bounds-And-Non-Prescriptive-Verdicts.md),
  amendment 2026-10-14): its failure is told once, by the failures directive,
  where an authoritative « not connected » used to contradict it. « No
  connector is active for this » is now a typed failure that directive
  explains, in pipeline and ReAct mode alike, so « no mail service is
  connected » stays the answer when it is true.
- 🔌 **A tool of a provider you have not connected is no longer offered:** an
  Outlook account is no longer proposed Gmail's settings, labels and filters or
  Google Drive's files, in the chat or on a voice call, so a mail question is
  served by the mailbox that is connected.
- 📂 **A search in a folder of your own reads that folder**
  ([ADR-287](docs/architecture/ADR-287-Email-Content-First-Detail-Levels-Digests-And-Neutral-Message.md),
  amendment 2026-10-14): Outlook used to read the inbox instead, and iCloud
  looked for its trash under a name it does not use. A folder is now found by
  its role or its name whatever its case, and one that does not exist is said
  with the folders that do.
- ➖ **« Not from the newsletter » is honoured:** negated criteria — a sender,
  a subject, a date, the read state, the star, and on Outlook an attachment —
  used to be dropped from Outlook and iCloud searches, which then listed what
  was excluded.
- 🔑 **A confirmed action that could not run says why**
  ([ADR-303](docs/architecture/ADR-303-Tool-Failure-Restitution.md),
  amendment 2026-10-14): its result card used to show an internal code
  (« EXECUTION_FAILED », « CONFIRMATION_MISSING ») or the raw text of an
  error. It now reads a sentence in your language: a service no longer
  connected is named with where to reconnect it — Gmail for the vacation
  responder and filters, Google Drive for sheets and documents, a connector
  you or an administrator revoked —, a change saved before the failure says
  so before you retry, and a cancellation that came too late is no longer
  announced as done.
- 🔊 **Remote dictation goes to the engine the administrator configured**
  ([ADR-345](docs/architecture/ADR-345-Fish-Audio-Served-Whole-One-Door-One-Allowance-Cues-Each-Engine-Reads.md)): it used to be ElevenLabs whatever the `voice_transcription` slot
  named, « remote available » meant that an ElevenLabs key existed, and the cost
  was filed under ElevenLabs. The slot's provider now receives the audio, the
  voice settings name it — so the privacy notice says who receives it — and the
  cost is filed under it.
- 🆓 **A voice that was not served is no longer billed:** a surface whose
  configured engine could not be served speaks through Edge and costs nothing,
  where it used to record the configured engine's tariff.
- 🏷️ **A bracketed word in a text read aloud is no longer performed** as a cue
  by an engine that reads tags, and a `<|speaker:N|>` marker in someone else's
  words can no longer make another voice speak.
- 📦 **`eleven_v4` and `eleven_v4_turbo` reach upgraded instances:** they had
  joined the seed bundle without a migration.
- 📉 **A chat answer whose voice ran past its wait is counted**
  (`voice_fallback_total{reason="timeout"}`): it was voiced again through the
  direct path while the dashboard showed a clean turn.
- 🗣️ **The voice no longer reads LIA's internal tags aloud**
  ([ADR-253](docs/architecture/ADR-253-Per-Turn-Expressivity-Annotation.md),
  amendment 2026-10-14): a spoken conversation answer could end on « valence
  0.1, arousal 0.1… register warm… » — the self-assessment and tone tags the
  model appends, which the token stream let through attribute by attribute,
  whatever the speech engine. The stream now removes them across tokens, and
  the item selection that opens an answer built from your data with them.
- 🗣️ **A spoken comment names what the written answer chose**
  ([ADR-082](docs/architecture/ADR-082-Progressive-Sentence-Streaming.md),
  amendment 2026-10-14): after a search, the voice could announce a result the
  answer had left out — on a measured turn, the text proposed four places of
  twenty-two and the voice named another one, 5 replays in 5 — because the
  comment was written from every result the tools returned, at times before the
  answer had even begun. It now starts with the answer and speaks only of the
  results the answer kept, its lead first, in every domain; when the answer kept
  none, the voice reads the answer.
- 🔒 **A voice provider's refusal no longer carries its words**
  ([ADR-345](docs/architecture/ADR-345-Fish-Audio-Served-Whole-One-Door-One-Allowance-Cues-Each-Engine-Reads.md), amendment 2026-10-14): the
  ElevenLabs and OpenAI transcription clients kept up to 512 characters of the
  vendor's answer in their errors, ElevenLabs speech and its voice listing 200
  in their messages — and a validation refusal echoes the field it refused, the
  sentence being voiced included. A refusal now travels by its status and the vendor's code,
  and is logged by those facts; the build fails on any new excerpt of a response
  body in a client.
- 🗄️ **The administration's voice pickers no longer hold a database
  connection while a vendor lists its voices**
  ([ADR-304](docs/architecture/ADR-304-No-Transaction-Across-A-Network-Call.md)):
  each request authenticates on a session of its own, closed before the vendor
  is asked.
- 🔑 **A refused ElevenLabs key is named in dictation too:** the live dictation
  reported an unidentified HTTP error where the meeting transcription already
  said the key was refused; both now read the vendor's code.
- 🔊 **An OpenAI voice failure is read from its type:** a refusal whose message
  held « generate » was treated as a rate limit, a timeout as an HTTP error and
  a refused key as a missing one, and a request the vendor refused for good was
  tried again; it no longer is.
- 📊 **The « Voice Comment Tokens » panel shows the comment's tokens**
  (dashboard 11): it charted a metric only an uncalled function wrote; it now
  reads the tokens every spoken comment's model call records.
- 🔢 **The getting-started and observability guides quote the real metric
  count:** they said 606 and 419. Both figures are now held to the source by the
  release check, and the observability guide points at the dashboard catalogue
  instead of stale dashboard and runbook counts.
- 🧪 **The browser flatteners' linearity test no longer fails under a loaded
  suite:** it read one tick of the Windows thread clock (15.6 ms) as an infinite
  growth; it now reads CPU over batches of calls, alternating the two sizes,
  and decides on the median.
- 🧪 **The API's timed tests no longer fail on a loaded host:** two asynchronous
  tests ordered their steps with sleeps, which a starved event loop wakes in one
  iteration, and now wait on the events themselves; the machine-tag filter's
  linearity guard read the wall clock, which counts the wait for a processor as
  work (a linear filter read ×8.6 and ×10.2 with every core busy), and now reads
  the thread's CPU like the flatteners' guard, through a clock precise on
  Windows too (`tests/support/thread_clock.py`); a cold-import check's 30 s
  budget became the hang guard it was meant to be.
- 🧪 **The browser's source guards no longer fail on a loaded suite:** eleven
  guards read the whole `src/` tree inside a test, whose 15 s budget vitest
  checks only after a synchronous body returns, so it measured the host — four
  turned red on a clean tree, one file taking 49.6 s under coverage. They now
  read it once, at collection, through one scanner
  (`src/__tests__/source-scan.ts`) that refuses to run inside a test.
- 🧪 **The stored-file tests no longer pass a changed file off as intact on
  Windows:** nine cases rewrote a file with the same size right after observing
  it, and a stat identity cannot see a same-size write inside one tick of the
  filesystem's clock — the deletion cleanup's case failed 133 times in 500, the
  move staging's 232. They now write a LATER change, new bytes stamped past any
  tick (`tests/support/file_clock.py`): 0 failures in 500 each.
- 🔁 **A « for each » over names or places sends each one to its step:** a bare
  `$item` whose item was a string reached the step's parameters with its own
  quotes inside theirs, the parameters no longer parsed, and the step ran with
  the literal `$item` — found by a live proof on Docker dev, where three walking
  routes went to Google with destination `$item` and answered « no route ». The
  substitution now works on the parameters themselves: an object or a list
  arrives whole, a value inside a text reads as text, nothing is re-parsed.
- 🧪 **The integration suite is green again in CI:** the voice readout test
  merges real audio through ffmpeg, which the integration job now installs (the
  API images already ship it), and the Fish Audio key fence expects a person's
  voices under the provider, where they have been kept since the radio voices fix.
- 📻 **The radio says the name you gave your station** ([ADR-324](docs/architecture/ADR-324-A-Personal-Radio-A-Grid-Decides-Models-Only-Write.md),
  amendment 2026-10-14): the host used to welcome you to « LIA » whatever the
  station was called — measured on dev, nine openings in ten — because the
  writer was given the name only once, beside LIA's. It is now told the name
  wherever a programme names the station, and LIA as the assistant who runs it:
  ten openings in ten said the station's name.
- 🎨 **The stylesheet is built from the application's sources alone:** Tailwind
  also read the 1 064 test files (2 504 files in all, past the guard's bound);
  it now reads the 1 440 sources, which drops 22 rules no production file used.
  The guard's witnesses can no longer be produced by its own text.
- 🔢 **A « for each » step whose items failed no longer counts one failure
  too many** ([ADR-346](docs/architecture/ADR-346-Advisory-Replanner-Retired-A-Pipeline-Failure-Is-Said-Never-Replayed.md)):
  the loop's summary inherited its items' failure and was counted beside
  them, so one failed item was announced as two, two as three.
- 🧩 **The skill guide and the skill generator name the one step type a plan
  template runs, `TOOL`** ([ADR-346](docs/architecture/ADR-346-Advisory-Replanner-Retired-A-Pipeline-Failure-Is-Said-Never-Replayed.md), amendment 2026-10-14): the guide
  offered `REPLAN` and `HUMAN` in six languages and the generator `PARALLEL`
  and `RESPONSE`, none of which ran. Any other type now refuses the template
  before execution, and the request goes to the regular planner.
- 🎭 **Personalities have their character back** ([ADR-068](docs/architecture/ADR-068-Psyche-Engine.md),
  amendment 2026-10-16): the reference seed re-created the 14 stock
  personalities without their Big Five and mood profile, so on every instance
  seeded after the traits arrived, all of them reacted like « Normal ».
  Migration `b62a8d193f04` restores the profiles where no administrator set a
  value and aligns a psyche still at the neutral profile — mood, emotions and
  relationship untouched —, the seed check now refuses a profile without traits,
  and an account that never chose a personality follows the default one.
- 🔬 **A delegated expert that runs out of steps still delivers** ([ADR-083](docs/architecture/ADR-083-Sub-Agent-Delegation-React.md),
  amendment 2026-10-13 b): its last call writes the analysis from what it found,
  where it used to end on LangGraph's « Sorry, need more steps to process this
  request », reported as a success. Browser and MCP tasks say how far they got
  when they fail, an MCP task keeps the widgets it created, and a skill that
  produced no answer says why (`subagent_outcomes_total{agent_name,outcome}`,
  dashboard 19).
- 📏 **Both modes tell an expert's reach the same way** ([ADR-083](docs/architecture/ADR-083-Sub-Agent-Delegation-React.md),
  amendment 2026-10-13): the autonomous mode no longer delegates « analyse my
  e-mails » to an expert that cannot read them, and the instruction's size cap
  is enforced by the tool in both modes, before any model runs.
- 🚦 **Web searches wait out a provider's rate limit instead of failing**
  ([ADR-108](docs/architecture/ADR-108-BaseAPIKeyClient-Adoption.md),
  amendment 2026-10-13): a 429 on one person's Brave or Perplexity key opened a
  breaker every account shares and refused 13 searches of 15 in one run, read as
  « service unavailable ». It is now retried with jitter; when it persists it
  reads « rate limit » — the briefing's weather card included — and Perplexity
  failures are no longer counted as successes.
- ⏱️ **A tool LIA's own limiter refuses is a refusal** ([ADR-303](docs/architecture/ADR-303-Tool-Failure-Restitution.md),
  amendment 2026-10-13): it was recorded as a consulted source, a successful call
  and a productive iteration; it now states the limit, whose it is and when it
  lifts.
- 🔁 **A routine never asks a question nobody can see** ([ADR-263](docs/architecture/ADR-263-Execution-Authority-Chain-And-Effect-Register.md),
  [ADR-276](docs/architecture/ADR-276-Workboard.md),
  [ADR-298](docs/architecture/ADR-298-Sandbox-Egress-Toolbox.md), amendments
  2026-10-13): thirteen routine runs had stopped on a confirmation or a
  sandbox-network question that took your next message as its answer and held
  back later routines. A routine now refuses and says where to allow it; a
  ticket still asks.
- 🛑 **A routine or a ticket retried after a timeout never repeats what it did**
  ([ADR-276](docs/architecture/ADR-276-Workboard.md), amendment 2026-10-13 b,
  [ADR-265](docs/architecture/ADR-265-Routine-Week-Timeline-And-Run-History.md)):
  a retry replayed the whole turn, browser tasks included; it is refused once
  the register shows an action. A routine's reservation is held by its token,
  so the recovery never hands a live run to a second tick and a late settle
  never overwrites another tick's routine.
- 💬 **« LIA is already working on this conversation »** ([ADR-117](docs/architecture/ADR-117-Background-Chat-Runs.md),
  amendment 2026-10-13): while a ticket or a voice relay runs on your
  conversation, the chat says LIA is busy; it no longer attaches to a stream
  nobody writes or claims a Stop worked, and a message sent meanwhile says it
  was not sent.
- 📡 **Live streams through a compressing proxy** ([ADR-117](docs/architecture/ADR-117-Background-Chat-Runs.md),
  amendment 2026-10-15): event streams carry `Cache-Control: no-transform`, so a
  gzip proxy no longer holds the notifications and the chat until they end.
- 🔕 **Signing a device out also stops its notifications** ([ADR-144](docs/architecture/ADR-144-Device-Sessions.md),
  amendment 2026-10-13): the notification stream kept flowing to a revoked tab;
  it now closes with `session_revoked` and the page returns to the sign-in
  instead of reconnecting into refusals.
- 🗓️ **One scheduler, even after a lost lease** ([ADR-046](docs/architecture/ADR-046-Background-Job-Scheduling.md),
  [ADR-123](docs/architecture/ADR-123-Lifespan-Startup-Decomposition.md),
  amendments 2026-10-13): a worker that lost its lease kept running every job
  beside the new leader; it now pauses until it is re-elected, and a shutdown
  starts no job and stops the scheduler before what its jobs need.
- 🌍 **Web pages load on hosts without IPv6** ([ADR-326](docs/architecture/ADR-326-Linear-Flatteners-And-Pinned-Fetches.md),
  amendment 2026-10-13): the validated address was picked in hash order and could
  be an unreachable IPv6 one; the resolver's order is kept, and a refused
  connection moves to the next validated address.
- ✉️ **An e-mail is sent once:** sends, replies and forwards on Gmail, Outlook
  and iCloud are no longer retried after a lost acknowledgement, which could
  deliver them twice; a send some recipients refused says how many received it.
- 📎 **A forward never drops a file silently, and a reply honours Reply-To**
  ([ADR-344](docs/architecture/ADR-344-Mailbox-Drafts-Kept-Freely-Sent-After-One-Confirmation.md)):
  a file that cannot be downloaded refuses the forward before anything is
  written.
- 🗑️ **iCloud moves mail to its real trash:** found by its role, never a folder
  named « Trash », and without expunging what other mail apps had marked
  deleted; a « not found » answers at once instead of after seconds of retries.
- 🍏 **The iCloud connection test checks every service you selected** — mail,
  calendars, contacts — and says in your language whether the password, the
  certificate or the connection failed.
- 🔒 **A connector cannot be activated past a revocation** ([ADR-302](docs/architecture/ADR-302-OAuth-Grant-Par-Compte-Et-Consentement-Groupe.md),
  amendment 2026-10-15): an activation re-reads your account and the
  administrator's switch under locks once the provider has answered, and a
  provider key is written in one atomic step ([ADR-215](docs/architecture/ADR-215-Self-Host-Installer.md),
  amendment 2026-10-15).
- 📨 **« Send me this by e-mail » no longer asks for a recipient**, and « prepare
  a draft » no longer asks for content LIA writes itself: the missing-content
  check matched tool names by fragment.
- 📭 **A mailbox that could not be read is not « empty »:** when every message
  read fails, LIA says so instead of answering that you have no mail.
- 📲 **Long Telegram messages keep their formatting:** a long HTML message is
  split between tags, each part closing what it opened; parts used to be refused
  and resent as raw text with the tags visible.
- 🛡️ **The third-party content envelope holds in every spelling** ([ADR-167](docs/architecture/ADR-167-Content-Trust-Registry.md),
  amendment 2026-10-13): a closing tag written in another case, full-width or
  with invisible characters can no longer break out of it, and the injection scan
  reads the text as a model does.
- 🔑 **Secrets stay out of logs and answers** ([ADR-317](docs/architecture/ADR-317-A-Log-Line-Carries-Facts-Never-The-Words.md),
  amendments 2026-10-13 and 2026-10-15): provider keys, a quoted `Bearer` or
  `api_key` and card numbers are masked; connector, Places, Routes, geocoding,
  Microsoft Graph and telephony refusals carry their status and code, never the
  provider's text; a sandbox run or a network skill command removes a key the
  remote service echoed ([ADR-298](docs/architecture/ADR-298-Sandbox-Egress-Toolbox.md),
  amendment 2026-10-13 b); the web app no longer logs push tokens.
- 🖱️ **Browser refusals are typed** ([ADR-303](docs/architecture/ADR-303-Tool-Failure-Restitution.md),
  amendment 2026-10-14): a page that could not be read is no longer « empty »,
  and the browser agent's prompt names the click and fill argument as the tools
  do.
- 📉 **Compaction's token counts are recorded:** `compaction_cost_tokens_total`
  read 0 on every real call.
- 🔇 **The chat keeps speaking when its voice engine cannot be served:** Edge
  stood in with the configured engine's voice ids, which mean nothing to it, so
  the answer was silent; it now speaks with Edge's own voices.
- 📻 **The briefing's « Read aloud » reads the whole text** on an engine that
  returns raw audio: each sentence came back as its own file and the joined
  file played only the first; the sentences are now encoded as one MP3.
- 🛂 **A voice slot names a model its provider serves:** saving Fish Audio with
  an ElevenLabs model, a transcription model on a speech slot or a model priced
  in a unit the recorder cannot read is refused; such a slot used to be served
  as the vendor's default model while LIA priced it at another tariff.
- 🔐 **A voice-library act stops when its author loses the right to it**
  ([ADR-345](docs/architecture/ADR-345-Fish-Audio-Served-Whole-One-Door-One-Allowance-Cues-Each-Engine-Reads.md),
  amendments 2026-10-15): clone, design, save, rename, delete, pin and unpin
  re-read the administrator's role when they act, a designed voice is saved
  once, and a preview never goes to another vendor account than the one that
  generated it. Deleting a voice gives everyone who had chosen it the
  instance's voice back.
- 🎙️ **A meeting on a transcription account without credit fails at once**
  instead of retrying until its attempts run out.
- 🔄 **Briefing cards retry where they failed:** on a network or rate-limit
  error, « Retry » refreshes the card, where the agenda, mail and weather cards
  sent you to the connectors settings.
- 🧾 **An error is never an empty list:** meetings that could not load no
  longer read « No meeting yet », calls « hidden », plugins « No plugin
  installed » or the alerts counts « — »; each says it could not load, offers
  Retry and keeps the rows already shown. The scheduled section of the alerts
  shows different rows on each page.
- 🎧 **A second press cancels a briefing that is still loading its voice**,
  which could otherwise start playing late.
- 👀 **The Smiley companion keeps its 3D context** when the page re-mounts it,
  and a preferred spot just outside the margin no longer sends the companion to
  the opposite edge.
- 🌐 **Language and time zone follow the server's confirmation:** a refused
  change no longer stays displayed, and changing the language keeps the open
  settings section.
- 🧩 **A plugin manifest with an explicit `null` in an optional field is
  refused**, like a wrong type.

## [3.0.1] - 2026-10-13

**A portrait that reads everything LIA keeps about you, and lighter ReAct turns.**
The compiled portrait becomes an analysis of the person again, fed by nine
sources read whole, with a brief written as a summary of its own; a journal
change no longer erases it. ReAct binds fewer tools per turn, stops recovering
from pages it was never meant to finish, and hands the graph only what a turn
changed. API workers keep their vectors compact and freeze their startup heap.
Twenty-three dependency advisories are fixed or accepted with a written reason,
and the landing's use-case times are readable in the light theme.

### Added

- 🪞 **The portrait reads nine sources, whole** ([ADR-343](docs/architecture/ADR-343-Portrait-Reads-The-Whole-Material-And-Its-Brief-Is-A-Synthesis.md)):
  memories, interests, learned habits and relationship debriefs are joined by
  open loops, Workboard tickets, routines, reminders and kept answers, each
  offered through the shared seam with its own gates and an exact total. Five
  caps — three per source, a per-item clamp and a global character cap — give
  way to ONE bound, a share of the consolidation slot's context window
  (`JOURNAL_CONSOLIDATION_SOURCES_WINDOW_FRACTION`), and a cut is stated in the
  provenance and on the settings card.
- 🧠 **An analytical portrait with a real brief:** the consolidation reads the
  person across the sources on seven facets (posture, focus, context, rhythm,
  tension, interaction, uncertainty), names a pattern instead of listing its
  items, and writes the brief as its own two or three claims rather than a
  prefix of the full text. Every admitted reading is published; stored
  portraits are recompiled once under the new policy.
- 🧪 **Measurement tooling:** `scripts/journals/measure_portrait.py` measures
  the portrait on a seeded, inert persona with oracles shared with admission;
  `scripts/react/selection_corpus.json` replays tool selection over 45 questions;
  `scripts/ops/worker_census.py` counts what a live worker holds by types and
  sizes only.

### Changed

- 🛡️ **No model reviews the portrait's readings:** the second, semantic review
  call is removed (measured rejecting grounded readings even after two
  recalibrations of its criterion). What refuses
  invention is structural: a reading cites items of the current snapshot, a
  paragraph restating one item, a name the cited items carry or a figure,
  address or date in the prose is dropped. One model call per consolidation
  again.
- 🕰️ **A journal change marks the portrait stale, never empty:** the settings
  card says a recompilation is pending, the ambient block always carries its
  compilation date, and deleting entries withdraws only the readings they
  supported.
- 🔧 **Repaired before refused:** a claim or a maintenance action the snapshot
  cannot carry is repaired (a facet, an abstraction level) or dropped alone and
  counted; a single faulty item no longer voids a paid consolidation.
- 🎯 **ReAct binds a catalogue through its domain** ([ADR-293](docs/architecture/ADR-293-React-Tools-Bound-By-Relevance.md) amendment):
  a binding unit never rides the relevance tail, and a family of many units —
  the settings catalogue — is reached through its routed domain. Measured on
  real rankings: an agenda turn binds 67 tools instead of 140, a settings turn
  103 instead of 243. The application-settings prompt block is rendered only
  when a settings tool is bound; the tool cap's bound rises to 500.
- ⚡ **The graph input is the turn's diff** ([ADR-022](docs/architecture/ADR-022-LangGraph-State-Checkpointing.md) amendment):
  the restored state is no longer replayed whole into the graph, so unchanged
  channels take no new checkpoint version on every turn. What the model reads
  is untouched.
- 🔁 **A page cut at a tool's cap is not a gap** ([ADR-336](docs/architecture/ADR-336-Requested-Outcomes-Checked-Against-Canonical-Observations.md) amendment):
  only a failed read reaches the bounded recovery pass; requested outcomes and
  gaps the model declares keep their behaviour.
- 🧮 **Compact worker memory** ([ADR-283](docs/architecture/ADR-283-Worker-Memory-Anatomy.md) amendment):
  tool-selection vectors are `float32` arrays (about eight times smaller than
  Python float lists), a user's MCP vectors are parsed once per catalogue and
  worker (`MCP_SERVER_VECTOR_CACHE_MAX`), an MCP argument model is built once
  per schema (`MCP_ARGS_SCHEMA_CACHE_MAX`), the startup heap is frozen last in
  the lifespan, and a BM25 index is replaced when its corpus changes.
- 📉 **Leaner observability:** cAdvisor and postgres-exporter are scraped on
  keep-lists with lighter cAdvisor housekeeping ([ADR-333](docs/architecture/ADR-333-Linked-Signals-And-A-Pipeline-That-Watches-Itself.md) amendment);
  the public demonstrator runs two API workers.

### Fixed

- 🔒 **Dependency advisories:** aiohttp 3.14.4, dnspython 2.9.0, LangGraph
  1.2.14 with its SDK 0.4.6, OpenTelemetry 1.45.1, DOMPurify 3.4.17, i18next
  26.4.4 and Vite 8.3.4, each fix held by a floor in its manifest (ADR-331); the
  APScheduler advisory, unpatched upstream, is accepted with its reason — LIA
  uses the in-memory job store only. truststore 0.10.5 closes two TLS
  verification advisories published on release day.
- 🎬 **Landing films kept across deliveries:** the historical public films stay
  in the playlist after a new render, their bytes checked by fingerprint.
- 🎨 **Readable use-case times in the light theme:** the step times of the
  landing's use cases were bright cyan on light glass (1.7:1, found by axe on
  Firefox); a text cut of the accent cyan (`--cosmos-cyan-ink`) holds AA on
  every light ground, kept by the cosmos contrast guard.
- 🧭 **Weekly browser matrix green again:** the Firefox and WebKit run read
  Playwright's blind spots as product failures. A check an engine cannot expose
  (WebKit's intercepted cookies and multipart content, a redirect fulfilment, a
  subframe download outside Chromium) is asserted where it is observable and
  named elsewhere as an `engine-limit` annotation; headless Firefox gets a
  virtual display for WebGL, the companion sphere is measured at the page's own
  density, and a touch tap waits for the page to come to rest.
- 🐳 **API image:** runtime manual pages needed by package alternatives are
  retained, package installs are declared non-interactive, and CI image builds
  export to the cache only.
- 🗄️ **Schema comments** of the portrait columns describe what they hold since
  ADR-343 (migration `0ff858a07321`); a timing-sensitive unit test of the source
  worker renewals waits on its events instead of a fixed delay.

### Documentation and installation

- ADR-343 added; ADR-022, ADR-079, ADR-283, ADR-293, ADR-308, ADR-333 and
  ADR-336 amended; journals, ReAct execution, Grafana dashboards and the worker
  memory runbook updated; FAQ, guides, knowledge base and living maps follow.
- New settings are optional with defaults (`JOURNAL_CONSOLIDATION_SOURCES_WINDOW_FRACTION`,
  `MCP_SERVER_VECTOR_CACHE_MAX`, `MCP_ARGS_SCHEMA_CACHE_MAX`); five portrait
  source caps are removed. A fresh self-hosted install needs no new answer.

## [3.0.0] - 2026-10-12

**Requests connected to their context, with results you can inspect.** This
release brings supported application management into conversation, strengthens
structured outcome verification and publishes an editable product presentation.
Native companions, public explanations and operating documentation evolve
together. Experimental options retain their stated qualification limits.

### Added

- **Application management through conversation:** account-scoped tools inspect
  and change supported preferences and objects. Minor reversible settings use
  their declared policy; creations, deletion and sensitive operations request
  confirmation. Encrypted expiring commands retain actor, origin, operation
  digest, phase and current authority. Browser-native file, private-input and
  connector authorization continuations keep their existing controls (ADR-339).
- **Requested-outcome verification:** explicit obligations are checked against
  canonical structured observations, including values, operation, account and
  completeness. Drafts, opaque results and delegation announcements cannot
  prove execution. Compact verdicts survive checkpoints and reach bounded
  recovery and final synthesis (ADR-335, ADR-336).
- **Checkpointed ReAct reads:** eligible independent read segments run with
  bounded concurrency and publish results before later interruption. Exact,
  fresh, complete results can be reused within the same turn and authority
  context; mutations invalidate reuse. Unknown, interruptible, delegated and
  mutating calls keep sequential execution (ADR-337).
- **Live MCP contracts:** current input/output schemas, structured output,
  schema age and hashes travel with the callable contract. Administrative and
  user-owned targets preserve exact identity independently of public aliases;
  delegation is bound before policy, approval and invocation (ADR-338).
- **Native body volume:** reviewed original avatar artwork supplies bounded
  anatomical relief, alpha coverage, normals and facial projection under the
  existing rig. Graphics lifecycle and unavailable-resource fallbacks are
  explicit; full physical anatomy and arbitrary facial occlusion remain
  approximations (ADR-340).
- **Product film and complementary focuses:** editable HTML/CSS/Remotion
  construction, original electro-funk soundtrack provenance, complete native
  avatar catalogue, contextual male Lumo, display modes, reminders, Relations,
  populated planning, action register, administrative views and dedicated PWA
  sequence. Complete native screens remain stationary outside declared element
  focuses; crops preserve the original rows and geometry (ADR-341).
- **Exclusive Presentation player:** blue CTA before the guided demo, explicit
  full-film manifest descriptor, lazy fullscreen dialog, native controls,
  localized loading/error/retry states and background playback suspension.
  The neighboring registration CTA is removed. The film and checked editable
  construction are linked from README and release assets.
- **Optional one-time BIP campaign:** a deployment-scoped runtime identifier
  applies the companion style on the next authenticated browser visit, with
  persisted completion, later manual choices preserved, multitab coordination
  where available and storage-failure rollback. Empty remains the installation
  default; this is not a database avatar preference (ADR-342).

### Changed

- **Semantic context:** resolved references keep their value, kind and source
  through query intelligence and the shared Pipeline/ReAct argument guard.
  Dates and places cannot be silently treated as contacts. Tool dependencies
  require constructible canonical evidence rather than phantom producers.
- **JEV decisions:** native Choice/Noul criteria and bounded parameter-kind
  observations retain debug evidence and attribution. Deterministic compatibility,
  authorization and HITL stay in code. Parameter-kind assistance is opt-in and
  disabled by default; uncertain outcomes do not remove existing guards.
  Offline qualification findings are documented without inferring production
  gains (ADR-325 amendments).
- **Public content:** FAQ and end-user/admin release notes, relevant blog
  material, six-language durable presentations, knowledge exports and
  functional/technical/decision maps reflect the delivered features. Public
  explanations distinguish implemented safeguards and supported standards from
  certification claims.
- **Landing on phones:** spacing and separators clarify the assistant promise,
  journey benefits and three individually centered trust statements.
  Application screenshots share the Grafana carousel's presentation frame.
- **Model catalogue:** the repository's reviewed model/pricing seeds include
  the added Anthropic model records; configured instance slots remain the
  runtime authority rather than following a forced global retarget.

### Fixed

- The Presentation retry explicitly refreshes unavailable or outdated metadata,
  bypassing browser caches while coalescing and throttling origin requests.
- Memory extraction records a consent-sensitive revision and refuses stale
  writes after a concurrent revision or deletion. Routine generation uses a
  reservation that settles the current generation without racing another tick.
- Scheduled sandbox egress approvals retain their action buttons and pending
  state when messages synchronize after the scheduled run.
- Tool-result cards restore their terminal disclosure behavior; conversation
  history search and light-theme chip icon contrast retain readable native UI.
- Radio respects the first requested programme's priority. Existing commercial
  and editorial source controls remain in place.
- Voice sentence cleanup retains linear processing and removes native provider
  tags without reordering rendered audio.
- Its growth regression test measures current-thread CPU time to exclude
  descheduling under load, while preserving the wall-time ceiling, growth
  thresholds and a deliberately quadratic negative witness.
- Weather input distinguishes explicit from omitted dates, validates supported
  units and states accepted dates instead of silently replacing unreadable ones.
- Semantic taxonomy, enum examples and producer ownership are aligned with the
  actual executable registry rather than unavailable declarations.
- Deployment preserves SOPS UTF-8 text on Windows and regenerates the Docker
  group identity needed by the existing isolated skill runner. Sandbox Docker
  denial has an explicit availability outcome instead of a successful claim.
- Beat-map selection preserves bounded timing and an explicit analysis version;
  exported music and source provenance stay attached to their actual edit.

### Documentation and installation

- Added ADR-339 through ADR-342 and guides for application commands, native
  avatar volume, motion production and JEV semantic qualification. Updated
  affected implementation references and architecture maps.
- Version surfaces, changelog references and derived public counts use the
  repository's release tooling. Public test/source figures are fresh
  measurements, not projected counts.
- Installer and backend configuration contracts cover the delivered migrations,
  startup wiring and optional runtime UI setting. Clean-host candidate
  qualification and release promotion remain bound to exact image digests.

## [2.6.1] - 2026-10-06

**Une voix continue, un avatar maîtrisé et une interface à portée de main.**
Cette version fiabilise la restitution existante, le contrôle de la session Simli
et le placement des fenêtres sur mobile. L’avatar demeure expérimental : les
essais fournisseur et physiques Android/iOS restent à qualifier.

### Changed

- **Contrôle de la session avatar** : l’API possède le WebSocket fournisseur ;
  un ticket à usage unique remplace le jeton fournisseur dans le navigateur.
  Le jeton et la clé de fermeture restent chiffrés côté serveur. Signalisation
  et PCM traversent le relais ; le média WebRTC retourné reste fournisseur–navigateur.
  Présence validée, révocation du ticket et fermeture de la génération exacte
  permettent de réconcilier une session après rechargement sans prendre celle
  d’un autre onglet. Un arrêt brutal du serveur reste borné par le plafond fournisseur.
- **Présentation publique** : captures renouvelées avec données fictives,
  manifeste de révision et workflow de capture reproductible ; galerie, README,
  documentation, FAQ, présentations et cartes vivantes actualisés dans six langues.

### Fixed

- **Radio** : amorçage silencieux stéréo aligné sur les morceaux de la station,
  pour fiabiliser le démarrage natif sous WebKit. Le geste de lecture, les
  deux pistes et la protection contre une pause tardive sont conservés.
- **Couverture CI** : rapports backend XML et frontend JSON archivés
  dans GitHub Actions pendant sept jours, avec erreur explicite si le rapport
  manque. Les seuils restent imposés par les mêmes tâches locales et CI.
  Le lancement manuel de la même CI permet de qualifier le commit exact
  d’une branche de release lorsque `main` avance en parallèle.
- **Scan de secrets** : faux positifs historiques examinés individuellement
  et enregistrés par empreinte exacte de commit, fichier, règle et ligne ;
  scan complet conservé et détection d’une nouvelle valeur synthétique vérifiée.
- **Dépendances CSS** : correctifs de déni de service pour `source-map-js`
  ([GHSA-68fv-2mgg-jv7q](https://github.com/advisories/GHSA-68fv-2mgg-jv7q))
  et le parseur de sélecteurs utilisé par Typography
  ([GHSA-rj75-hqrm-r3gf](https://github.com/advisories/GHSA-rj75-hqrm-r3gf)).
  Résolution figée, compatibilité de génération CSS vérifiée et audits rejoués.
- **Avatar** : bouton d’arrêt conservé hors de la frontière d’erreur du chat,
  avec résultat confirmé ou en attente ; erreurs sûres, contrôle de présence
  et fermeture vérifiée avant libération du bail. Les traces de signalisation
  masquent le ticket de connexion.
- **Live et restitution** : file PCM bornée et cadencée par la lecture réelle
  pour les longues réponses ; ordre conservé, fin et annulation nettoyées,
  absence de reprise locale d’un préfixe potentiellement déjà audible.
- **Mobile et PWA** : placement de l’avatar, du compagnon et des raccourcis
  borné au viewport visuel, y compris clavier, rotation, zoom et panoramique.
  Les ajustements temporaires ne réécrivent pas la préférence ; instantanés
  géométriques stables et coordonnées finies évitent les boucles de rendu.
- **Galerie** : URLs de captures révisées et autorisation locale ciblée dans
  l’optimiseur d’images pour servir les images actualisées. Le lecteur agrandi
  est monté hors des sections animées pour couvrir tout le viewport.
- **Structure HTML** : badges en ligne, description composée des espaces RAG,
  commande d’activation des personnalités et attribut booléen des iframes
  respectent la sémantique HTML et évitent les avertissements de rendu React.
  Les descriptions des sources Radio séparent explicitement les mots annoncés.

### Tests

- **Radio** : format WAV, silence, durée, correspondance des canaux avec les
  morceaux livrés et résolution tardive de la lecture contrôlés ; parcours
  natifs avec lecture, redimensionnement et arrêt conservés.
- **Garde de croissance linéaire** : temps CPU du thread mesuré sur plusieurs
  appels et tailles alternées, avec médiane des ratios, pour distinguer le
  travail du code des variations de charge sous xdist ; plafond de durée réelle,
  témoins et seuils conservés. Le motif
  quadratique historique reste explicitement refusé.
- Contrats avatar PostgreSQL, Redis et WebSocket, arrêt et restitution,
  longues réponses Live, stabilité de disposition et préférences flottantes.
- Parcours navigateur hermétiques : clavier/PWA et avatar sur média simulé.
  Ils ne certifient ni mouvement des lèvres fournisseur ni compatibilité matérielle.
- Matrice Firefox/WebKit : sortie audio native virtuelle, STUN local et silence
  du pair synthétique ; thème chargé dès l’amorçage et assertions de phase
  compatibles avec l’horloge mise en pause, sans retirer les règles d’accessibilité.
  Horloges suspendues avant navigation, geste de lecture après montage de
  l’historique et alignement mesuré après les deux peintures différées.
  Captures de cartes dimensionnées à leur contenu après les contrôles axe,
  puis retour au viewport audité ; seuils, délais et règles conservés.
  Le compagnon conserve chaque frame active ; les périodes de repos sont
  avancées sous la limite du rig, avec la même durée virtuelle totale.
  La composition attend la réponse et la réouverture effective du formulaire
  avant de sélectionner une seconde carte archivée.
  Chromium utilise le navigateur complet épinglé en mode headless documenté,
  avec l’ensemble des règles axe, scénarios média et assertions géométriques.
- Isolation API conservée pendant la fermeture des navigateurs : requêtes en
  attente annulées, notifications de sortie bloquées et preuve par serveur local
  sur les trois moteurs. Les appels inattendus conservent leur erreur explicite.
  Une garde de transport par contexte couvre les envois keepalive détachés de
  Chromium et refuse les tunnels opaques sans remplacer le document d'échec.
  La vraie police d'icônes est épinglée et servie localement pendant les scans,
  avec provenance et licence, pour mesurer les glyphes sans dépendance au CDN.
  Les résultats axe complets traversent des blocs bornés avec contrôle de longueur
  et d’empreinte avant assemblage ; toute altération échoue explicitement.
  Les callbacks différés finissent dans leur test ; les attentes externes sont annulables.
  Les parcours de recherche chargent le thème du compte avant navigation ;
  le défilement vérifie séparément l’envoi et la fin des réponses immédiates ou différées.
- Opérations asynchrones des tests React attendues jusqu’à leur résultat ;
  interactions et changements de stores regroupés avec les mises à jour React.
- Installateur : présence avatar émise et alignée avec les Settings ;
  aucun nouveau service Compose, seed, réglage obligatoire ou parcours de boot.

Le contexte de build web exclut les artefacts temporaires de validation et de
capture ; un build de production sans cache conserve l’installation figée.

## [2.6.0] - 2026-10-05

**Un visage pour la voix, des sources plus lisibles et des coûts traçables.** L'avatar
parlant personnel Simli accompagne les commentaires vocaux et les conversations
Live, sur activation explicite et avec une seule restitution audible. Cette
intégration reste expérimentale : les essais physiques et la qualification de la
restitution réelle sont encore attendus. Les cartes identifient mieux leurs
sources, les nouvelles consignes permanentes sont épinglées et Radio distingue
l'information utile des sollicitations commerciales. La consommation conserve le
prix de chaque tentative rapportée par le fournisseur, y compris en cas d'échec.

### Added

- **Avatar parlant personnel Simli, expérimental** : connecteur à clé personnelle
  chiffrée, permission du compte désactivée par défaut, catalogue de visages et
  fenêtre flottante à trois tailles, déplaçable au clavier, au toucher et à la
  souris. Un port commun de restitution accompagne les commentaires et le Live
  direct ou délégué sans nouveau modèle ni synthèse. Le mode actif conserve la
  connexion ; la veille Live la ferme et le réveil en demande une nouvelle.
  Une session ouverte peut consommer des crédits personnels pendant le silence.
  Admission Redis partagée par clé, création sans reprise implicite, issue
  inconnue mise en quarantaine et renouvellement après fermeture vérifiée.
  Radio reste hors périmètre. [Conception proposée](docs/architecture/ADR-334-Personal-Speaking-Avatar-And-One-Audible-Output.md)
  et [qualification](docs/technical/SPEAKING_AVATAR.md).
- **Supprimer depuis une carte e-mail** : la composition prépare la confirmation
  existante avant mise à la corbeille. Le compte source est recontrôlé à la
  préparation, à la reprise et aux opérations fournisseur ; une ancienne carte
  n'obtient pas une permission de suppression nouvelle.
- **Deux usages JEV indépendants et désactivés par défaut** : présence de
  références personnelles avant résolution mémoire et refus complet d'une
  confirmation. Une décision incertaine conserve le parcours génératif et ne
  vaut jamais autorisation d'exécution.

### Changed

- **Consommation par tentative** : modèle, instant de début, tarifs et conversion
  USD/EUR sont retenus ensemble avant l'appel. Les tokens de cache, échecs payés,
  reprises et annulations sont comptabilisés sans repricer ni doubler une
  tentative. Les tâches hors conversation, les synthèses et les coûts d'instance
  suivent le même contrat ; une lecture manquante n'invente pas une consommation.
- **Qualifications JEV** : une opération conserve son instantané de routage et
  de prix sur tous ses lots. Le diagnostic distingue candidats, évalués,
  inconnus et omis, ainsi que la sélection native et son résultat applicatif.
  Les comparaisons de date et fuseau restent calculées dans le code ; les aperçus
  conservent les données canoniques et ne deviennent pas des actions.
- **Mémoire** : les nouvelles consignes permanentes sont épinglées dès leur
  création. La personne peut les corriger, les désépingler ou les supprimer ; les
  automatismes respectent l'épinglage et la protection de catégorie.
- **Présentation publique** : le catalogue fonctionnel est conservé sans la
  section redondante de cas d'usage. Présentations, FAQ, recherche des réglages,
  connaissances et cartes vivantes sont actualisées dans les six langues.

### Fixed

- **Radio** : filtrage des publicités, partenariats, promotions et invitations à
  acheter, sans supprimer factures, réservations, rendez-vous et véritables
  publications éditoriales. Caches éditoriaux séparés et lecture ciblée des
  sections nécessaires. Le PCM/µ-law TTS porte sa fréquence et son encodage avant
  FFmpeg ; l'annulation ne supprime pas un fichier final préexistant. Le bandeau
  ne dessine plus de bord noir autour du contenu.
- **Cartes MCP** : origine publique du serveur et méthode restent visibles,
  réponse sous un détail accessible, sans publier chemin, query ou identifiants
  de l'URL de connexion. Les réponses objet, tableau et scalaire restent
  consultables. Un cooldown partagé et borné absorbe les refus de débit sans
  transformer un rafraîchissement en rafale d'appels.
- **Météo** : codes du fournisseur et observation jour/nuit conduisent les
  pictogrammes, avec brouillard, vent et orage distincts, dans les observations,
  prévisions quotidiennes et horaires ; la traduction du texte ne choisit plus
  le symbole.
- **Voix et Live** : fin de production, silence, interruption, veille et reprise
  traversent la même frontière de sortie. Les files audio conservent l'ordre et
  nettoient leur propre média sans arrêter les pistes empruntées au fournisseur.
- **Confidentialité des diagnostics** : les messages internes et événements
  fournisseur passent par la rédaction des champs de contenu ; les traces de
  l'avatar ne conservent ni voix, transcription, clé ni URL signée.
- **Journal et facturation** : une consolidation conserve sa trace d'échec
  lorsque le modèle a répondu mais que l'enregistrement de facturation échoue ;
  elle ne crée pas d'acte pour un modèle qui n'a jamais répondu.
- **Installateur** : le parcours propose l'avatar comme intégration optionnelle,
  émet ses bornes cohérentes et conserve tous les choix après une reprise, y
  compris le diagnostic autonome qui revenait à sa valeur par défaut.
- **Démonstrateur** : sa construction et son exécution API utilisent la version
  et le commit du bundle déployé ; le pilote de production refuse une provenance
  absente au lieu de démarrer avec une identité de développement.
- **Dépendances** : plancher `asyncssh` relevé au correctif 2.24.1 de la
  traversée de chemins SFTP (GHSA-q8m6-9rfx-39rf) ; Starlette utilise l'import
  actuel de `BlockingPortal`, sans masquer l'avertissement AnyIO.
- **Veille des dépendances** : les dépôts déplacés conservent leur lecture
  authentifiée sur la même origine ; une redirection vers un autre hôte, port
  ou protocole ne reçoit jamais le credential. Les requêtes GitHub sont espacées
  entre workers, une coupure réseau bénéficie d'une seule reprise et toute
  source non lue reste un échec explicite du contrôle.

### Tests

- Régressions comportementales des cartes et de leur compte source, météo,
  cooldown MCP, mémoire épinglée, JEV par lots et facturation des appels payés
  interrompus ; mixage Radio sur vrais fichiers audio et transitions persistées.
  Le corpus navigateur conserve une horloge de référence fixe pour ses dates
  relatives ; la provenance démo est vérifiée par le shell et Compose réels.
- Avatar : admission et révocation, baux partagés, annulation, conversion PCM,
  interruption, renouvellement, une seule sortie audible et parcours navigateur
  avec un pair WebRTC local. Ces simulations ne prouvent pas le mouvement labial
  Simli ni la compatibilité physique Android/iOS, réservée aux essais du propriétaire.

## [2.5.0] - 2026-10-04

**Des cartes qui montrent tout ce qui a été reçu et des actions qui appartiennent à leur message, une application aux couleurs du cosmos, des signaux d'observabilité qui se répondent.** Les réponses porteuses de données deviennent des cartes déterministes qui affichent tout ce que la source a fourni sans rien inventer, gardent le détail complet derrière des dépliants accessibles, s'enrichissent de galeries, de comparaisons météo, d'aperçus de documents et d'itinéraires interactifs comptés, et permettent de répondre, transférer ou ajuster un rappel depuis la carte ([ADR-332](docs/architecture/ADR-332-Deterministic-Cards-Received-Facts-And-Message-Owned-Actions.md)) ; le modèle ne relit qu'une vue sémantique, jamais le HTML. Le fond animé de la page d'accueil s'étend à l'application, les surcouches adoptent un verre dépoli, le tableau de bord gagne une carte Workboard et les réglages se réorganisent ; une réponse gardée dit ses deux coûts. Dans Grafana, journaux, traces et métriques s'ouvrent les uns les autres et la chaîne d'observation se surveille elle-même ([ADR-333](docs/architecture/ADR-333-Linked-Signals-And-A-Pipeline-That-Watches-Itself.md)). La page d'accueil enchaîne deux vidéos, avec un bouton pour passer à la suivante.

### Added

- **Cartes déterministes des réponses** (ADR-332) : rendu serveur unique, adaptateurs typés par famille et primitives partagées (titre, texte complet, faits, dépliants natifs) ; un fait reçu est montré en entier et jamais inventé — absent, zéro et faux sont trois états, l'horloge source passe par un seul analyseur (`core/time_parsing.py`), la récurrence native de Microsoft reste native. E-mails (corps complet, pièces jointes, parties), contacts (toutes les organisations et leurs dates, téléphones, adresses, anniversaires, notes), agendas (alias visible, accès, rappels, tous les points de connexion d'une visioconférence, récurrence), tâches (notes, sous-tâches), fichiers (propriétaires, droits, vignettes fournies), lieux (photos attribuées en galerie plein écran, avis complets, horaires par période), trajets (étapes, transports, alternatives fournies, péages), météo (créneaux comparables), recherches (extraits complets, citations liées à leur source), Hue, tickets et résultats MCP (instantanés bornés, champs d'identifiants masqués). Ouvrir un détail n'appelle ni fournisseur, ni modèle, ni outil.
- **Aperçus de documents générés** : première page d'un PDF (agrandissable), extrait d'un CSV ou d'un classeur, premiers paragraphes d'un Word, couverture d'une présentation — lus sous les contrôles de propriétaire, de statut et d'expiration du fichier, dans un processus isolé et borné pour MuPDF, jamais mis en cache ni envoyés au modèle.
- **Itinéraires interactifs** : une carte de trajet s'ouvre en carte Google (SDK Maps JavaScript) sur la géométrie exacte du fournisseur, toutes les alternatives tracées, sélection mise en avant, fonds plan/satellite/hybride/relief ; activation explicite avec coût estimé, clé libérée seulement après admission authentifiée sous les plafonds du compte et de l'instance et une autorisation signée de courte durée, chaque construction enregistrée sous une exécution durable (aucun schéma ajouté). `GOOGLE_MAPS_BROWSER_API_KEY` (facultative, sinon `GOOGLE_API_KEY`) et le tarif `maps_javascript` du seed Google ; sans eux, aucune activation n'est offerte.
- **Répondre depuis une carte** : répondre, transférer un e-mail ou ajuster un rappel prépare la demande dans la zone de saisie avec une pastille de contexte ; le serveur relit la réponse d'origine, la source et le droit du compte au clic, et HITL, modification, reprise et nouvel essai revérifient la même liaison. Aucune action pour une source sans liaison structurelle de compte (Apple Mail).
- **Carte Workboard du tableau de bord** : comptes exacts (ce qui t'attend, ce que tient LIA, en retard, ouverts), chacun menant au tableau filtré, puis les premiers tickets qui t'attendent ; configurable comme les autres cartes, masquée quand l'instance éteint le Workboard (`BRIEFING_MAX_WORKBOARD_ITEMS`).
- **Les deux coûts d'une réponse gardée** (amendement ADR-282) : ce qu'elle a coûté à produire (la ligne de synthèse de son tour, retrouvée par le `run_id` copié au clic — colonne `message_bookmarks.run_id`, migration `b6e2d8f4a1c7`) et ce qu'a coûté son indexation, chacun nommé ; jamais un zéro que personne n'a mesuré.
- **Un bouton « Lire la vidéo suivante »** dans le cadre et le lecteur ancré de la page d'accueil, qui enchaîne désormais deux vidéos en boucle, chacune avec son crédit et sa carte des temps (amendement ADR-330).
- **La chaîne d'observation se surveille elle-même** (ADR-333) : Loki, Alloy, Tempo et Grafana scrutés sur une liste `keep` chacun (une vingtaine de séries), alerte `LogsNotDelivered` (recette, requête de catalogue, runbook, tests promtool), ligne « Observability pipeline » du tableau 16, garde `test_pipeline_keep_lists_guard`.

### Changed

- **Le fond animé de la page d'accueil derrière l'application** : le shell connecté et les pages de connexion portent `AppCosmos` ; l'en-tête et les panneaux restent pleins, le fil du chat est un verre léger entre ses bulles. Une seule matière de tuile (`DashboardTile`) pour les cartes du tableau de bord, et le code couleur des domaines (`lib/domain-tone`) colore aussi les puces du centre de notifications.
- **Un verre dépoli pour toutes les surcouches** (`lia-overlays.css`) : fenêtres, menus, listes, info-bulles, visionneuses et notifications (Sonner en mode `unstyled`), opaques sous transparence réduite ou couleurs forcées, focus rendu à l'élément d'origine.
- **Réglages réorganisés** : icônes des connecteurs et des domaines, santé (statistiques puis graphiques), réseau du bac à sable, serveurs MCP en deux colonnes avec leur description, appels récents repliés, compétences, espaces de connaissances gérés directement, habitudes et « Réunions » en sections repliables.
- **Le modèle lit une vue sémantique versionnée de chaque réponse** (`display/model_history.py`, `infrastructure/llm/message_view.py`), jamais le HTML des cartes : un corps d'e-mail retenu par le mode « métadonnées » ne revient plus au tour suivant par la carte.
- **Grafana : les signaux s'ouvrent les uns les autres** (ADR-333) — journal → trace (champ dérivé sur le `trace_id` JSON), trace → journaux et métriques (`$__tags` rétabli), latence → trace (stockage des exemplars sous `traceID`) ; `job` nomme le service compose ; chaque tableau s'ouvre sur 7 jours (journaux et traces sur 4 h) avec un menu « LIA dashboards » commun, tenu par `test_grafana_dashboard_conventions_guard` ; mémoire de production Prometheus 768 Mo, Loki 384 Mo avec cache de résultats.
- **Le scan de secrets suit tous les parents entrants** : les commits d'une branche fusionnée et le contenu d'une résolution de conflit sont scannés (`--diff-merges=first-parent`, `test_secret_scan_merge_lineage.py`).
- **La configuration Vitest est un module ESM natif** (`vitest.config.mts`).

### Fixed

- **Le coût d'indexation des documents des espaces de connaissances** est celui que l'embedder a facturé (`billed_embedding_usage`) : le tokenizer et la table de prix OpenAI de l'ingestion le sous-estimaient d'environ 7× pour chaque document indexé par Gemini.
- **La photo du compte Google** revient dans l'avatar du chat : une URL conservée pouvait servir la silhouette `default-user`, et Google signe une nouvelle URL à chaque connexion — elle est rafraîchie à chaque connexion Google ; une image potentiellement Google passe par le proxy (un avatar relatif répondait 500 sur dev).
- **Une phrase sans rien à prononcer** n'est plus envoyée au moteur TTS (facturée puis refusée) ; un échec TTS est journalisé par son code.
- **Tempo** : overrides au format scopé, adresse du worker, tolérance à la course rétention/poller (30 échecs par jour) ; **Grafana** : provisioning `plugins/` et `alerting/` valides, plus d'auto-traçage (59 % des spans) ; **l'API** : un span par requête et non par message ASGI (88 %) ; **Alertmanager** n'affiche plus d'adresse ; marqueur d'arrêt de Loki défini.
- **`PushWakeSweepStalled`** passait en attente avec 18 réveils servis sur 18 : chaque série fournisseur × issue est exportée à zéro dès l'import.
- **Un SKU Google tarifé à zéro est gratuit**, pas manquant ; les requêtes Gemini désactivent l'appel de fonctions automatique de google-genai (`ChatGeminiNoAfc`).
- **Les migrations** configurent la journalisation avant d'importer les modèles et n'appellent plus `fileConfig` ; un `ToolMessage` orphelin est journalisé en DEBUG.
- **La carte interactive atteint une instance mise à jour** : le tarif `maps_javascript` n'était que dans le seed, qu'une instance existante ne rejoue jamais — la carte y restait désactivée (mesuré sur la production) ; la migration `ef46f93d7745` l'ajoute là où aucun prix actif n'existe, sans toucher un prix saisi par un administrateur, et une garde exige qu'un tarif Google daté après l'audit du 23 septembre voyage par une migration.
- **`task test:e2e` tourne sur un poste Windows** : le `NODE_ENV=development` du `.env` chargé par le Taskfile faisait mourir le build géré au prérendu, le préfixe `PORT=` du serveur était un nom de programme pour `cmd.exe`, et le parcours du verre lisait la préférence de transparence du système hôte ; `lia-overlays.css` n'est plus importé deux fois.

### Tests

- Corpus de référence des cartes généré depuis les vrais producteurs (`tests/helpers/card_reference_cases.py`), refusant toute dérive entre le backend et le corpus que lisent le frontend et les parcours navigateur ; fidélité par domaine avec zéro, faux, absences, valeurs non finies et entrées hostiles ; 45 parcours hermétiques Chromium/Firefox/WebKit dont les détails natifs, la galerie, les itinéraires et la composition ; test de concurrence sur PostgreSQL jetable pour l'admission des cartes.
- Les parcours navigateur du tableau de bord et des réglages suivent la carte Workboard et les sections repliées ; deux suites d'intégration RAG fournissent `model_name` au calcul des coûts.
- Conventions des tableaux Grafana, listes `keep` de la chaîne d'observation, matrice des destinataires Alertmanager et redaction des requêtes Alloy gardées par des tests.

## [2.4.0] - 2026-10-03

**Des dépendances qui mûrissent avant d'entrer et ne reculent jamais, une télémétrie qui ne nomme personne, une page d'accueil qui respire.** Un programme complet de cycle de vie des dépendances ([ADR-331](docs/architecture/ADR-331-Dependency-Watch-And-A-Refresh-That-Never-Goes-Back.md)) : une veille hebdomadaire lit ce qu'aucune porte ne voyait (avis publiés par chaque projet, fins de vie, registres, moteur du navigateur), un rafraîchissement attend un délai de prudence et ne recule jamais, chaque entrée du build de production est épinglée par empreinte, et un scan de secrets précède chaque push. La pile d'observabilité passe sur des versions maintenues, Alloy remplace Promtail, et les métriques comme les traces nomment la route empruntée — jamais un nom ni une recherche. FastAPI 0.141, OpenTelemetry 1.44, webauthn 3, SQLAlchemy 2.0.54, React 19.3 et Playwright 1.63 entrent avec la preuve de ce qu'ils changent ; la matrice navigateurs (Chromium, Firefox, WebKit), rouge depuis onze semaines, repasse au vert et a trouvé deux vrais défauts d'interface. La page d'accueil gagne un fond animé « attention », un pied de page en verre dépoli posé sur la planète et une vidéo fondue dans la page, et chaque page publique peut mettre ses animations en pause ; « Dis LIA » est réentraîné et « LIA, stop » coupe désormais la voix de LIA.

### Added

- **Veille des dépendances** (ADR-331) : `task deps:watch` lit ce qu'aucune porte ne voit — les avis de sécurité que chaque dépendance publie dans son propre dépôt (la revue en a trouvé vingt absents de la base GitHub), les fins de vie, les faits des registres et le moteur du navigateur — contre des acceptations datées et motivées (`scripts/audit/dependency_watch_accepted.json`) ; le workflow hebdomadaire `dependency-watch.yml` ouvre ou met à jour UNE issue, et la veille est une étape de chaque release, jamais une porte de pull request. Un constat se corrige ou s'accepte avec une raison et une date de revue, jamais en silence.
- **Un rafraîchissement qui attend et ne recule jamais** (ADR-331) : `task deps:refresh` (remplace `deps:upgrade:all`) déplace le verrou Python sous un délai de prudence compté depuis la version EN PLACE — 5 jours pour un correctif, 14 pour une mineure, 60 pour une majeure, une mineure sous 1.0 comptant comme une majeure — et refuse tout recul de version, qu'un délai global d'uv aurait provoqué. Un correctif de sécurité transitif devient un plancher de manifeste (dix planchers posés). Dependabot suit la même doctrine : délais de prudence partout, alertes seules pour pip, regroupement docker-compose, suite e2e couverte.
- **Des gardes qui n'ont pas besoin du réseau** : chaque import déclaré dans un manifeste, chaque entrée de build épinglée, une image = une référence dans tous les fichiers compose et tous les workflows, un seul propriétaire par version (pnpm, promtool, uv, Node, l'image Playwright de la CI tenue égale au paquet e2e), et les étiquettes des images d'observabilité citées par la documentation tenues à leur source.
- **Scan de secrets avant chaque push** : `task security:secrets` exécute le gitleaks de la CI (même version, même configuration) sur ce que le push envoie, depuis le hook `pre-push` — un secret parti sur le dépôt distant ne se reprend pas.
- **Fond animé « attention + espace latent » de la page d'accueil** : un canevas posé derrière la page (`AttentionBackdrop`, `lib/landing/attention-background.ts`) dessine un nuage d'embeddings qui se regroupe au fil du défilement — un point de requête y allume ses plus proches voisins — et, à droite, une colonne de jetons où chaque section devient un repère ; son intensité suit le temps de la musique de la vidéo. Il monte quand le navigateur est au repos, perd sa colonne sous 768 px, se fige si ses images dépassent un budget de 5 ms et ne laisse rien au démontage. Les lignes du titre d'accueil battent chacune leur tour, le pied de page devient un bandeau de verre dépoli posé sur la planète de la dernière section, et la vidéo se fond dans la page par une fine bande et un halo rythmé, que la scène du lecteur (`.landing-video-stage`) rogne aux bords de la page (posé en coordonnées document, il élargissait le document de 14 % de la largeur du cadre).
- **Le CLI DevOps nomme son modèle et son effort** : `DEVOPS_CLAUDE_MODEL` et `DEVOPS_CLAUDE_EFFORT` sont transmis à chaque exécution (`--model`, `--effort`), en local comme en SSH, par une seule construction des arguments ; le CLI s'authentifie avec son PROPRE jeton longue durée (`CLAUDE_CODE_OAUTH_TOKEN`, créé par `claude setup-token`).
- **Mettre les animations en pause (WCAG 2.2.2)** : la nébuleuse, les nuages de la planète et le fond animé démarrent seuls et durent plus de cinq secondes ; chaque page publique porte désormais un bouton de pause (`MotionToggle`, `aria-pressed`, nom stable) — dans l'en-tête à partir de 1280 px (en dessous, la rangée de liens n'a pas la place : mesuré, il la faisait déborder de 33 à 49 px en français), dans le menu mobile et dans chaque pied de page. L'état tient en un attribut `data-motion="paused"` sur `<html>` (`lib/landing/motion-pause.ts`) : la feuille de style met en pause les animations de la portée cosmos, le canvas le lit à chaque image, les scènes de `/more` le partagent ; le choix est retenu pour le visiteur.
- **La matrice navigateurs exécute la suite** : `task test:e2e:browsers` lance les mêmes parcours sur Chromium, Firefox et WebKit, et le workflow hebdomadaire l'appelle au lieu de définir sa propre commande (la garde de parité CI le lit désormais).

### Changed

- **Kit MCP 2.2** : un serveur ajouté par une personne ne choisit plus ce que l'API va chercher — une référence `$ref` distante dans le schéma de résultat d'un outil n'est plus téléchargée (GHSA-rwrf-2pqf-9j8j) et une redirection vers une autre origine n'est plus suivie ; une référence interne au schéma et une redirection de barre oblique sur la même origine continuent de fonctionner, prouvées contre de vrais serveurs locaux.
- **Le navigateur de l'outil de navigation est le Chromium de Debian**, mis à jour avec la distribution (amendement [ADR-059](docs/architecture/ADR-059-Browser-Control.md)) ; un lancement raté est compté et le moteur journalisé au démarrage. **Une seule version de KaTeX** sert l'affichage des formules.
- **FastAPI 0.141.1 et OpenTelemetry 1.44** : depuis la 0.137, un routeur inclus est un nœud de l'arbre des routes ; trente modules de tests lisent les routes servies par un seul parcours (`tests/_routes.served_routes`), tenu par une garde AST.
- **webauthn 3.0.0, cbor2 6.1.4, SQLAlchemy 2.0.54** : les passkeys proposent Ed25519 en premier ; SQLAlchemy corrige un `UPDATE … RETURNING` désaligné sous concurrence et une connexion asyncio laissée ouverte après un échec d'initialisation.
- **Tous les jetons JWT passent par PyJWT** : un jeton d'identité sans destinataire est refusé, `at_hash` reste vérifié par LIA, et un lien de réinitialisation émis avant le déploiement s'ouvre après.
- **Observabilité sur des versions maintenues, épinglées par empreinte et répétées sur dev** : Prometheus 3.13.3, Alertmanager 0.34.1, Grafana 12.4.11, Loki 3.7.8, Tempo 2.10.8, exporteurs, cAdvisor et Portainer à jour. **Grafana Alloy remplace Promtail** (le service garde son nom `promtail` et la même configuration de masquage) : sans les positions héritées que Promtail réécrivait à chaque sauvegarde, sa mémoire passe de 255 Mio (la limite de production) à 110 Mio, et aucune statistique d'usage ne part chez l'éditeur.
- **Chaque entrée du build de production est épinglée** : PostgreSQL 16.15 avec pgvector 0.8.6, Redis 7.4.11, Python 3.14.7 (même empreinte que le bac à sable), Node 24.21.0 avec ses sommes de contrôle, révision et empreinte du modèle Whisper, CLI Claude Code 2.1.287 — jamais une version antérieure à celle que la production exécute. Le démonstrateur suit (Caddy 2.11.4, cloudflared 2026.9.3, Squid 6.14, Postfix 5.1.0, collecteur OpenTelemetry 0.161).
- **Versions rafraîchies sous délai** : 75 mouvements Python (PyMuPDF s'importe désormais sous son nom `pymupdf`, msgpack ≥ 1.2.3) et 34 dépendances npm directes, dont React 19.3.0 et eslint-config-next 16.3.5.
- **Les notes vocales Telegram sont décodées par ffmpeg**, sous-processus borné comme tous les autres chemins audio : la conversion des échantillons passe de 712 ms à 33 ms et ne bloque plus le serveur (amendement [ADR-241](docs/architecture/ADR-241-Python-3.14-Trixie-Migration.md)).
- **Playwright 1.63 et l'image `noble`** pour toute la suite e2e ; **zod** est configuré sans compilation à la volée (`@/lib/zod`, imposé par ESLint) : sa sonde `Function("")`, refusée par la CSP, était signalée comme une erreur JavaScript sous Firefox.
- **Boîte à outils du mot d'activation** : la commande d'arrêt s'entraîne désormais sous la forme « LIA, stop » ; les négatifs Multilingual LibriSpeech sont tirés locuteur par locuteur (quinze heures au plus chacun), la validation française compte 74 heures avec de la musique et de l'anglais jamais entendus à l'entraînement, un point de contrôle est noté aussi sur sa forme écrite la plus faible, et chaque banque et chaque cache enregistrent la recette ou les empreintes dont ils viennent, pour ne reconstruire que ce qui a changé.
- **« Dis LIA » réentraîné, « LIA, stop » pour couper la voix** (amendement [ADR-329](docs/architecture/ADR-329-Live-Standby-And-Multilingual-Wake-Word.md)) : décision du propriétaire, le rappel d'abord — manquer un vrai « Dis LIA » est pire qu'un rare déclenchement sur une phrase voisine. Le modèle français est réentraîné (voix naturelles régénérées depuis les seuls locuteurs d'entraînement, cible de fausses alarmes du dev publiée) et livré à un point de fonctionnement plus sensible ; la commande d'arrêt devient « LIA, stop » (`phrases.ts`, manifeste, empreintes de référence, textes publics ×6). Les deux modèles restent `no-go` au banc, donc en bêta, et le manifeste garde leurs mesures.
- **Le déploiement ne copie plus la session Claude du poste** sur le serveur (une session OAuth sur deux machines meurt au premier rafraîchissement) et avertit quand DevOps est actif sans jeton dédié.

### Removed

- `python-jose`, `ecdsa`, `rsa` et leurs stubs, avec la dernière exception tolérée par `pip-audit` (CVE-2024-23342) ; `pydub` et `audioop-lts` ; cinq dépendances npm jamais importées (devtools, headlessui, react-hook-form, autoprefixer, @hey-api/openapi-ts) ; l'image Promtail ; la tolérance d'avertissement `Connection._cancel` d'asyncpg et sa garde (F028), devenues inutiles avec SQLAlchemy 2.0.54 ; la tâche `deps:upgrade:all`.

### Security

- **Décompression bornée** : un corps de réponse compressé est lu sous un plafond ; un codage non demandé (brotli) est refusé avant tout décodage, comme une panne de transport que chaque appelant sait déjà traiter.
- **Aucun nom dans les métriques ni dans les traces** (prolonge [ADR-317](docs/architecture/ADR-317-A-Log-Line-Carries-Facts-Never-The-Words.md)) : la jauge des requêtes en cours, étiquetée avant le routage, gardait le chemin brut — un nom sous `/relations/{name}` restait une série Prometheus pour toute la vie du processus, et chaque scan en ouvrait une ; elle prend le gabarit que le routage choisira, lu sur les expressions du routeur. Les traces exportées à Tempo portaient la cible concrète (`http.target`, `http.url` avec sa chaîne de requête) : un crochet de l'instrumentation la réécrit au gabarit.
- **Un scan de secrets avant chaque push** (voir Added) et la correction de six constats gitleaks des lots (une fixture, un exemple, deux noms de sommes de contrôle).
- **`braces` (GHSA-vfj7-8cjw-p6xm, élevé, aucun correctif publié)** : atteint uniquement par le greffon Next.js d'ESLint (`fast-glob` → `micromatch`), en développement, sur des motifs que le dépôt écrit ; accepté par son identifiant dans `pnpm.auditConfig.ignoreGhsas` — jamais par un niveau d'audit abaissé — et inscrit avec sa raison et sa date de revue dans `docs/technical/CI_CD.md`.

### Fixed

- **L'exercice de restauration des sauvegardes échouait depuis le 29 juillet** (un rôle manquant) : il recrée les rôles source sans mot de passe et passe de nouveau.
- **Le Prometheus du démonstrateur interrogeait une cible inexistante** depuis la v1.29.0.
- **Les métriques HTTP perdaient le préfixe des routes** depuis FastAPI 0.137 (`/rag-spaces/{space_id}/documents` au lieu de `/api/v1/rag-spaces/{space_id}/documents`) : le libellé est le gabarit SERVI. Une mauvaise méthode répondait 500 au lieu de 405 et une trace était nommée d'après le chemin concret.
- **Une note vocale Telegram avait deux plafonds** : 120 secondes à l'entrée, puis celui de la transcription (60 secondes par défaut) — une note de 90 secondes recevait « je n'ai pas compris ». Un seul plafond désormais, le plus petit des deux, pour le refus (annoncé en secondes), et pour le décodage, qui s'arrête juste après lui quelle que soit la durée déclarée par l'expéditeur. Un ffmpeg absent ou qui dépasse son délai est une erreur de l'instance, plus « le fichier de l'expéditeur ».
- **Le bouton « Revenir en bas » du chat** restait collé à la fin de la conversation, hors de l'écran, puis sous la zone de saisie : il est dessiné au-dessus de la zone de saisie.
- **Le sélecteur de personnalité** mesurait 43,97 px de large sous WebKit pour une cible tactile de 44 px.
- **Le fond des pages cosmos** masquait la nébuleuse, les étoiles et le grain depuis leur création ; l'anneau de la vidéo ne s'était jamais dessiné ; la lueur du titre des cartes était rognée.
- **Contraste du thème clair** (relecture à froid du fond animé) : avec le ciel plus soutenu et la nébuleuse visible, l'encre atténuée tombait à 4,4:1 sur le verre du pied de page et 3,5:1 sous un trait du canvas, le badge « BETA » à 4,18:1 ; `--cosmos-mut` est réaccordé dans les deux thèmes et le badge passe au rouge 800 — mesuré au pixel après correction : liens du pied de page ≥ 5,9:1, badge 5,6:1. Une garde compose désormais le sol, le ciel, la lueur, le verre et le trait du canvas (`cosmos-contrast.guard.test.ts`).
- **Le fond animé ne bouge plus quand il doit être immobile** : sous mouvement réduit, en pause ou sur un appareil trop lent, il dessine une image fixe, redessinée seulement au changement de thème ou de mise en page — il suivait encore le défilement et le pointeur, et recalculait son graphe de voisins à 30 images/s, plus cher figé qu'animé. Sans `requestIdleCallback` (WebKit), il attend l'événement `load` au lieu de monter pendant l'hydratation ; aucune langue n'est plus écrite en dur dans le module.
- **Le rail des chapitres s'efface quand le pied de page arrive** : passé sous le verre, ses liens n'étaient plus cliquables (4 à 7 sur 7 selon la hauteur d'écran). La planète prolongée est rognée par une classe et non plus par `:has()`, absent de certains moteurs.
- **Une identité git de test** fuyait dans la configuration du dépôt de l'appelant.

### Tests

- Matrice navigateurs mesurée dans l'image de la CI : 1 089 parcours passés, 18 écartés nommément, aucun échec — causes établies avant correction (service worker hors des simulations réseau, sonde de zod refusée par la CSP, flux de notifications simulé en échec, media queries réévaluées après deux images, saisie effacée par l'hydratation, vidéo en boucle impossible sous le WebKit de Playwright).
- Cérémonie passkey de bout en bout sur les vraies bibliothèques (EdDSA, ES256, clone, origine étrangère, format non textuel, passkey synchronisée 0 → 0) ; contrat d'instrumentation OpenTelemetry sur une application imbriquée réelle ; libellé avant routage égal au routage de FastAPI sur 2 947 requêtes ; notes vocales Telegram (plafond, décodage borné, nature de la panne) ; fond animé et battement du titre ; script de déploiement (Pester). Une garde refuse un `filterwarnings` qui ignore sans nommer de message. Les tests du lecteur vidéo démontent avant de restaurer leurs simulations média : le « Not implemented: HTMLMediaElement.pause() » de jsdom ne sort plus à chaque passage.
- Le parcours e2e local redevient hermétique pour la vidéo de la page d'accueil : `task test:e2e` vide `LANDING_MEDIA_BASE_URL`, que le `.env` chargé par le Taskfile pouvait faire pointer vers le vrai hôte média de l'opérateur — chaque chargement de la page d'accueil sur ordinateur diffusait alors le vrai clip pendant 15 s et le parcours de l'en-tête dans les six langues dépassait son budget de 90 s.
- Le parcours du bloc de code coloré attend son rendu final : un bloc dont le langage est connu se dessine deux fois (un `<pre>` simple le temps que le coloriseur charge, puis le sien, un nouvel élément), et le parcours faisait parfois défiler ou mesurait le premier (7 exécutions sur 16 sous charge) ; il attend désormais les jetons Prism (64 exécutions sur 64).

## [2.3.0] - 2026-10-02

**Une session Live qui se met en veille au lieu de s'arrêter, « Dis LIA » entendu dans le navigateur, un heartbeat qui ne s'interdit plus rien.** Un silence endort une session Live : la connexion au fournisseur se ferme, rien n'est facturé, et la phrase ou un toucher la réveille avec le contexte de LIA ; seule la personne termine une session. Le mot d'activation est désormais un petit modèle entraîné, exécuté dans un worker du navigateur — en bêta et en français seulement pour l'instant — et « Stop » coupe la voix de LIA. Le heartbeat évalue chaque passage de sa fenêtre sans quota quotidien, le champ destinataire d'« Envoyer par e-mail » suggère tes contacts, l'alerte de connexion propose « Tout reconnecter », la page d'accueil gagne une vidéo et le blog des illustrations qui se chargent sans attendre.

### Added

- **Veille des sessions Live** ([ADR-329](docs/architecture/ADR-329-Live-Standby-And-Multilingual-Wake-Word.md)) : une session Live — déléguée ou directe, chez les trois fournisseurs — s'endort après le silence de son modèle, sur une page masquée au-delà de son délai de grâce, ou sur le bouton de la personne. Le navigateur ferme la connexion au fournisseur (rien ne tourne ni ne se facture) puis le déclare (`POST /live/sessions/{id}/standby`) ; l'enregistrement reste réclamé, vit jusqu'à `LIVE_STANDBY_MAX_SECONDS` (8 h par défaut) et passe du compte des sessions actives à l'ensemble `live:standby`. **Seule la personne termine une session.** Un réveil (`POST …/wake`, la phrase ou le bouton) ouvre une NOUVELLE connexion : refus dans l'ordre (déjà éveillée, plafond, cadence de création, plafond d'instance), setup re-rendu à l'instant du réveil par la fonction du démarrage (`setup_render.render_setup_inputs` : horloge, état intérieur, interrupteurs du moment), resynchronisation d'un agent dont les outils ont changé, puis création du jeton — un refus laisse la session endormie. Le plafond est décalé de la durée du sommeil : les dix minutes d'une session sont dix minutes ÉVEILLÉES. Deux tentatives de connexion (poignée de reprise, puis sans), puis retour en veille sous la raison `wake_failed`. Une session directe relaie ses échanges à chaque mise en veille (liste des tours vidée en une commande, chaque issue dans une liste à part) ; la carte de fin compte les veilles et cite le récapitulatif de chaque relais qui n'a pas pu s'exécuter. Durées, ligne de décision, histogramme et compteur du navigateur comptent le temps éveillé ; la facture du vendeur est lue sur toutes les conversations ouvertes par la session, entière ou absente. Navigateur : `LiveStandby` (`lib/live/standby.ts`), un bouton unique qui change de rôle (le focus clavier survit), une étape après chaque attente vérifie que la session est toujours celle du store, et un iPhone est invité à garder l'écran allumé. Métriques `live_session_standby_total`, `live_session_wakes_total`, jauge `live_sessions_standby` (trois panneaux, tableau de bord 30).
- **Mot d'activation entraîné, exécuté dans le navigateur — en bêta, en français** (ADR-329) : « Dis LIA » est un classifieur openWakeWord (melspectrogramme et plongement partagés, Apache-2.0, plus un classifieur d'environ 0,86 Mo par langue) exécuté par ONNX Runtime Web en WASM monothread dans un worker dédié — ni `SharedArrayBuffer` ni isolation inter-origines, donc aussi sur iOS et dans les coques natives. Chaque fichier est nommé par son SHA-256, vérifié (taille et empreinte) avant d'être exécuté, servi `immutable` ; le manifeste de la langue décrit fichiers, politique de détection, mesures et provenance de chaque entrée avec sa licence. `WAKE_MODEL_STATUS` déclare les langues livrées : le français seul, en `beta` (son banc n'atteint pas encore les seuils publiés, et le dit) ; une autre langue d'interface garde le badge au toucher et l'appui long, sans jamais demander le micro, et les réglages le disent. `useVoiceMode` écoute par `useWakeWord` ; `WakeListener` charge le modèle avant d'ouvrir le micro, le libère en pause et passe son flux vivant à l'enregistrement qui suit une détection.
- **« Stop » coupe la voix de LIA** (ADR-329) : un second classifieur sur les mêmes plongements, déclaré par le manifeste sous `commands`, coupe la lecture d'une réponse et rien d'autre (aucun enregistrement, aucun message). Dire « Dis LIA » pendant que LIA parle la coupe aussi avant d'ouvrir l'enregistrement.
- **Boîte à outils d'entraînement `scripts/wake-word/`** : deux images Docker épinglées (CPU, et GPU pour les voix VoxCPM2), positifs et quasi-homophones synthétisés par Piper et VoxCPM2, négatifs FLEURS, Multilingual LibriSpeech et MUSAN, chaque téléchargement épinglé par adresse immuable et SHA-256 (`sources.lock.json`), banc sur voix et corpus tenus à l'écart (rappel au propre et à 10/5 dB, rappel par forme écrite, faux déclenchements par heure sur la parole et la musique, latence) contre des seuils publiés avant l'entraînement. Procédure : [WAKE_WORD_TRAINING.md](docs/technical/WAKE_WORD_TRAINING.md). Tâches `wake:*`, `lint:wake` dans la CI.
- **Le champ destinataire suggère tes contacts** (amendement [ADR-321](docs/architecture/ADR-321-A-File-Or-An-Answer-Sent-By-E-Mail.md)) : dans tout dialogue « Envoyer par e-mail », taper un nom, un prénom (accents et ponctuation ignorés) ou un numéro de téléphone propose les contacts correspondants et insère leur ADRESSE. `GET /email-share/options` publie `recipient_suggestions`, `recipient_query_min_chars` et `recipient_suggestions_max` ; `GET /email-share/recipients?q=` répond pour UN destinataire, sous sa propre limite de débit. Chaque client de contacts lit le carnet entier (`list_email_directory`, parité Google/Microsoft/Apple, sous `EMAIL_SHARE_DIRECTORY_MAX_CONTACTS`, coupure déclarée), compacté et mis en cache dans la famille déclarée `contacts_directory` (USER_CACHE) avec un tampon de version, construit une seule fois entre workers, invalidé par toute écriture de contacts ; la correspondance (`recipient_match.py`) passe par `fold_name`, `fold_email` et les variantes de numéro du domaine téléphonie. Une lecture du carnet est une consultation au registre (surface `email_share`, rien sur un succès de cache), comptée par `email_share_recipient_directory_reads_total`. Le champ est un combobox WAI-ARIA (`RecipientCombobox`) ; Échap ferme la liste avant le dialogue.
- **« Tout reconnecter » dans l'alerte de connexion** (amendement [ADR-302](docs/architecture/ADR-302-OAuth-Grant-Par-Compte-Et-Consentement-Groupe.md)) : dès que deux connecteurs d'un même fournisseur sont en erreur, l'alerte et la fenêtre de reconnexion proposent le parcours groupé de « Mes connecteurs ». Le serveur dit ce qui est groupable (`bulk_reconnect_provider`, publié par la liste ET par le bilan de santé) ; hook et dialogue de choix de compte sortent des réglages (`hooks/useBulkReconnect.ts`, `components/connectors/BulkReconnectDialog.tsx`).
- **Table des utilisateurs de l'administration** : les 22 interrupteurs par compte en colonnes, déclarés une fois (`users/admin_columns.py`, ordre d'affichage, liste blanche des clés de tri appliquée par la route, `nulls last` puis `User.id`) ; colonnes e-mail et nom figées au défilement horizontal, date d'inscription, légende repliable, en-têtes triables.
- **Vidéo de la page d'accueil** ([ADR-330](docs/architecture/ADR-330-Landing-Media-Served-Without-Runtime-Work.md)) : `LANDING_MEDIA_BASE_URL` (lu à la requête, jamais compilé dans l'image) désigne le dossier d'un `manifest.json` ; sans lui, aucune section. Un seul élément `<video>` pour toute la visite (`LandingVideoHost`, monté par le layout `[lng]`) : cadré sur l'emplacement de la page d'accueil, amarré en bas à gauche quand sa musique joue hors champ ou sur une autre page publique, mis en pause et démonté à la connexion. Le son est voulu par défaut, avec repli muet si le navigateur le refuse. Les titres battent sur une carte des temps calculée hors ligne (`scripts/assets/encode_landing_video.py` : flux spectral calibré, temps forts de mesure votés localement), six effets légers (halo du cadre, logo, mots fantômes, point d'étape, rail des chapitres, teinte du dégradé) et les yeux de LIA qui sautent entre deux temps — rien sous `prefers-reduced-motion`. Crédit et mention « générée par IA » portés par le manifeste.
- **Illustrations du blog pré-générées** (ADR-330) : quatre largeurs WebP et une image sociale JPEG 1200×675 par article (`build-article-images.mjs`), servies telles quelles et donc cachées en bordure ; `ArticleIllustration` dessine un `<img srcset sizes>` et l'article précharge son illustration. 194 Mo de PNG quittent `public/` et l'image de production ; une garde refuse un article sans son jeu complet.

### Changed

- **Le heartbeat n'a plus de quota quotidien** ([ADR-328](docs/architecture/ADR-328-Heartbeat-Without-A-Daily-Quota.md), migration `3354f9ba30e2`) : chaque passage de la fenêtre horaire hors délais de récupération atteint la décision, qui reste le seul juge de la pertinence ; ni plafond, ni tirage probabiliste. Les bornes par jour deviennent optionnelles dans `EligibilityChecker` (les deux ou aucune) ; `skip_probabilistic_gate` disparaît ; les colonnes `heartbeat_min_per_day`, `heartbeat_max_per_day` et `heartbeat_push_enabled` (lue par personne depuis août) sont supprimées, une mise à jour qui les porte encore est ignorée. Les réveils par push et les moments anticipés ne sont plus refusés une fois « le maximum du jour » atteint. Les centres d'intérêt gardent leurs bornes.
- **Une session Live n'est plus terminée par le silence ni par une page masquée** : elle s'endort (voir Added). Les issues `idle_timeout` et `hidden` restent lisibles sur les cartes archivées.
- **Planétarium du hero éteint** (`LANDING_PLANETARIUM_ENABLED`), composant conservé ; l'introduction des cas d'usage occupe toute la largeur de sa colonne.
- **CSP** : `media-src` accepte `https:` (la vidéo vient de l'origine média déclarée par l'opérateur), comme `img-src` le faisait déjà.

### Removed

- **L'ancien mot d'activation Sherpa** (« OK Guy », anglais seul, Whisper tiny.en transcrit sur le fil principal) : module et hook, `keywords.txt`, trois scripts de téléchargement, l'étape `alpine:latest` du Dockerfile web qui téléchargeait 116 Mo sans empreinte, l'expérience webpack `asyncWebAssembly`, trois constantes mortes et les drapeaux miroirs du store. La transcription serveur (Sherpa-onnx Whisper Small) n'est pas concernée.

### Fixed

- **Le badge mains libres se réactive d'un clic** : désactivé par un appui long, il affichait un toast « Mode mains libres désactivé » que le toaster empilait en haut au centre, exactement au-dessus du badge — le clic suivant tombait sur le toast et le mode ne se rallumait pas. Les deux transitions sont désormais annoncées par une région `status` à côté du badge (lue par les lecteurs d'écran), l'icône et sa couleur montrant l'état ; parcours e2e `chat-handsfree-toggle.spec.ts`.
- **Radio : une ligne annulée finit d'écrire avant le nettoyage** : quand une ligne d'un segment échouait, ses sœurs étaient annulées alors que leur fichier s'écrivait encore dans un thread ; le nettoyage courait contre l'écriture (refusé sous Windows, fichier recréé après sa suppression ailleurs). L'annulation attend désormais la fin de l'écriture (`_write_file`).
- **Plafond de serveurs MCP par personne** : la borne codée à 20 refusait le démarrage d'une instance réglée à 50 ; la borne est une constante (`MCP_USER_MAX_SERVERS_PER_USER_MAX`, 100).
- **Session Live prolongée ou endormie** : les tours gardés, les issues des relais et le budget de consultations d'une session directe vivaient la durée de l'enregistrement à leur écriture ; une prolongation les perdait ou remettait le budget à zéro. Ils suivent désormais chaque changement de durée de l'enregistrement.
- **Test à retardement** : la carte de proposition de skill était testée avec une échéance fixée au 2026-10-01 ; l'échéance est désormais relative à l'horloge.

### Tests

- Mot d'activation : moteur, politique de détection (différentielle contre la formulation vectorisée de la boîte à outils), manifeste, worker, écouteur, parité des scores du navigateur avec la boîte à outils sur le vrai modèle français via ONNX Runtime Web (golden régénéré), garde des modèles livrés (fichiers, empreintes, statut tenu au verdict du banc dans les deux sens, aucun fichier orphelin), sonde mobile du worker. Veille Live : magasin de sessions sur Redis, porte de veille et de réveil, contrôleur et machine d'états, carte et bandeau, parcours e2e veille/réveil. Suggestions de destinataires, reconnexion groupée, colonnes et tri de la table d'administration (y compris PostgreSQL), heartbeat sans bornes, lecteur vidéo et carte des temps (lib, composants, parcours e2e avec politique d'autoplay émulée), illustrations du blog.

## [2.2.0] - 2026-09-30

**Une bibliothèque publique de skills, et des skills écrites ailleurs qui travaillent vraiment, tenues à l'écart de tes données.** On cherche une skill sur skills.sh, on la lit fichier par fichier avant de l'installer à un commit exact, on la met à jour quand sa source bouge ; une skill peut exécuter ses propres commandes — Python, Node, shell — dans une copie jetable de son dossier et rendre des fichiers, n'atteindre le réseau que par les hôtes permis, et une skill écrite par le chat n'entre dans tes skills que par ton clic. Claude Sonnet 5.5 et GPT-6.1 Sol rejoignent le catalogue.

### Added

- **Bibliothèque de skills** ([ADR-327](docs/architecture/ADR-327-Skill-Library-And-Third-Party-Skills.md)) : « Trouver des skills » dans Paramètres › Skills cherche sur skills.sh (recherche anonyme, `Portal` déclaré dans `PORTALS`) ou lit une adresse GitHub collée. L'aperçu résout la branche en un commit une seule fois ; installation et mise à jour renvoient ce commit : ce qui s'installe est ce qui a été lu. Listing récursif refusé s'il est tronqué, taille vérifiée avant le premier octet, chaque fichier comparé à son SHA de blob git, liens et sous-modules jamais suivis. Une mise à jour est un dossier dont l'arbre git a bougé, revue fichier par fichier ; une version qui change de nom est refusée (`skill_library_renamed`). Les audits publiés sont lus sous chaque nom possible et mis en commun ; à partir de `SKILL_LIBRARY_AUDIT_BLOCK_LEVEL` (`high`) l'installation est refusée. Chaque requête est validée et épinglée à chaque saut (ADR-326) ; `SKILL_LIBRARY_GITHUB_TOKEN` facultatif lève la limite anonyme de GitHub et n'atteint que `api.github.com`. Domaine `domains/skill_library/`, capacité `PlatformCapability.SKILL_LIBRARY` (éteinte sur le démonstrateur), `skill_library_operations_total` (tableau 19), onglets Rechercher / Adresse / Installées.
- **Skills tierces** (ADR-327) : `skills.provenance` (`system`, `authored`, `url`, `plugin`, `library` — migration `00c0324db6ae`) décidée une fois par requête par `skills/trust.py` (une requête qui n'a rien lié traite toute skill utilisateur en tierce). Une skill tierce est marquée dans les catalogues, sa priorité ignorée, jamais de `plan_template` ni de chargement permanent ; ses instructions ne s'exécutent que dans le runner isolé, qui ne lie que ses propres scripts et ressources — aucun connecteur, aucun outil d'import. Sa réponse passe par `untrusted_markdown` (aucune image distante, aucun HTML, rien d'invisible pour la personne), lue ailleurs elle arrive en contenu externe, et elle n'a jamais de cadre interactif.
- **`run_skill_command`** (ADR-327 lot 2) : une commande shell exécutée dans une COPIE du dossier de la skill, dans le conteneur jetable SEC-001 ; dossier et fichiers du tour entrent en un tar sur stdin, sortie, statut et fichiers de `out/` reviennent en un tar sur stdout — rien n'est monté. La commande est l'argument `$1` d'un amorçage constant. Ce qui revient est lu sous plafond ; un fichier garde son type seulement si son nom ET ses premiers octets concordent, une page écrite par la skill revient en texte, le reste est nommé et écarté. Les fichiers deviennent des fichiers générés de la personne (ADR-279). Réglages `SKILL_COMMAND_*`, `skill_commands_total`.
- **Réseau déclaré des commandes** (ADR-327 lot 3) : paramètre `hosts` décidé par la même règle que le Python éphémère (`egress/tool_path.authorize_network`) — `connector`, `operator`, `grant` ou `unknown`, acte `skill_command_network` au registre, `skill_command_egress_total`. Une skill tierce n'atteint jamais un connecteur ni un jeton, et la carte de question le dit. Un hôte inconnu n'est demandé que dans la boucle ReAct ; ailleurs le refus nomme le réglage. `POST /sandbox/egress-grants` et le formulaire « Autoriser un hôte » dans Paramètres › Réseau du bac à sable, soumis à `PYTHON_SANDBOX_EGRESS_ASK_ENABLED`. `SKILL_COMMAND_NETWORK_ENABLED` retire le réseau aux seules commandes.
- **Une skill écrite dans le chat est proposée, ton clic l'installe** (ADR-327) : l'outil d'import devient `mutation_policy="draft"` ; `SkillImportService.validate_files` applique toutes les vérifications sans rien écrire, la proposition est gardée dans Redis (famille conversation, `SKILL_PROPOSAL_TTL_SECONDS`, `SKILL_PROPOSALS_MAX_PER_USER` par script atomique) et la carte `SkillProposalCards` installe par `POST /skill-proposals/{id}/install` — réclamation à jeton, idempotente, `skill_proposal_stale` si la skill remplacée a changé depuis la carte, action `skill_proposal_install` au registre. Là où aucune carte n'est dessinée (ticket, canal) l'outil refuse et renvoie vers le chat. Une seule porte des cartes dans le flux (`agents/api/card_delivery.py`, `shared/pending_cards.py`), partagée avec les images et les documents.
- **Image dédiée du bac à sable** (`apps/api/Dockerfile.sandbox`) : Python épinglé par digest, Node 24 depuis l'image officielle épinglée (version et digest), bash, jq, zip, poppler, git, curl et les bibliothèques promises installées depuis un lock vérifié par hash (`requirements-sandbox.txt`, compilé sous le lock de dev) — sans client Docker, sans code de l'application, sans secret. Une déclaration unique (`skills/sandbox_toolbox.py`) nourrit l'invite et les tests ; `task sandbox:libraries:check` exécute chaque commande dans l'image comme un run la démarre. Construite par les tâches de dev, le déploiement et l'installateur local, publiée par la release comme troisième image avec son SBOM.
- **Claude Sonnet 5.5 et GPT-6.1 Sol** (amendement [ADR-306](docs/architecture/ADR-306-Claude-Request-Surface-And-Billed-Prompt-Cache.md)) : seed et migration `fc0147eeb095`. Sonnet 5.5 est une septième forme de réflexion (`between_tools`, famille `anthropic_between_tools`, lue dans la documentation de l'éditeur) ; GPT-6.1 Sol n'a pas d'interrupteur (`none` mesuré en 400, règle d'Astra) et forme sa propre famille de cache (`gpt-6.1`, écriture puis relecture mesurées). Les deux lignes précèdent les préfixes plus anciens qui les auraient captées.

### Changed

- **Noms de skills uniques par compte** (ADR-327 lot 0, migration `61b299a42af9`) : deux index uniques partiels et un CHECK `is_system ⇔ owner_id IS NULL`. Chaque recherche nomme sa portée (`get_system_by_name`, `get_exact`, `get_by_name_for_user`), la clé de cache porte le propriétaire, les suppressions se font par id. Une skill personnelle masque une skill système du même nom pour cette personne seule ; un import utilisateur ne peut toujours pas reprendre un nom système.
- **Les skills de plugin sont des skills tierces** : elles perdent leurs cadres et leurs images distantes (changement de comportement délibéré) ; une skill importée d'une adresse avant cette version est enregistrée `authored`.
- **Le jeton de remplacement en deux appels d'ADR-165 disparaît** : l'accord de la personne est désormais un clic sur la carte, plus la parole du modèle.
- **Hôtes opérateur par défaut** : les modèles `.env` listent `registry.npmjs.org`, `pypi.org`, `files.pythonhosted.org` et `github.com` dans `PYTHON_SANDBOX_EGRESS_HOSTS` — des registres qui n'acceptent aucun envoi anonyme. `SKILLS_SCRIPT_SANDBOX_IMAGE` pointe sur `lia-skill-sandbox`, `SKILLS_SCRIPT_SANDBOX_PYTHONPATH` est vide.
- **L'API n'embarque plus les bibliothèques du seul bac à sable** (pandas, phonenumbers, pycountry, segno, unidecode, xmltodict) ; la suite unitaire les importe toujours par `requirements-dev.txt`.
- **Les journaux du domaine users ne portent plus d'adresse e-mail** (garde AST `test_account_logs_carry_no_email_guard.py`) — l'adresse était déjà pseudonymisée par le filtre.
- Dépendances : actions GitHub (15 mises à jour), jsdom 30, @testing-library/jest-dom 7, types-pyasn1 ; lockfile pnpm réparé après deux fusions Dependabot parties de bases différentes. Les builds des coques mobiles se lancent aussi à la main.

### Fixed

- **Une skill proposée deux fois en ReAct** : la boucle avait déjà activé la skill ; le nœud de réponse relançait le runner. `react_activated_skills` (réinitialisé à chaque tour) est lu avant tout lancement.
- **Une skill tierce activée depuis la boucle tuée à 30 s** : `activate_skill_tool` rejoint la famille sous-agent de `compute_step_timeout`.
- **`companion_activity_unavailable` à chaque outil appelé par le runner de skill du nœud de réponse** : sans run, aucune activité n'est construite ni signalée.
- **`skill_name_dir_mismatch` sur chaque aperçu de la bibliothèque** : un manifeste lu dans un dossier temporaire n'est plus comparé au nom de dossier.
- Plugins : désinstallation et mise à jour suppriment par id, jamais par nom ; la synchronisation disque → base respecte l'activation du propriétaire et saute un dossier dont le propriétaire n'existe plus au lieu d'interrompre toute la synchronisation.
- Commandes de skill : `SKILL_COMMAND_MAX_CHARS` 16 000 (une page écrite par heredoc dépassait 4 000) ; la limite de débit devient un réglage (`SKILL_COMMAND_RATE_LIMIT_CALLS`, 12 par minute).
- Test d'habitudes instable : un oracle cherchait `bad` dans une clé portant un uuid4 hexadécimal.

### Security

- **Premier scan du périmètre CodeQL élargi** (amendement [ADR-326](docs/architecture/ADR-326-Linear-Flatteners-And-Pinned-Fetches.md)) : l'export Markdown échappe une barre oblique inverse devant une ponctuation et les crochets d'un lien dans la fonction unique d'échappement ; `--!>` ferme aussi un commentaire HTML dans la description d'un événement ; le workflow de qualification refuse un identifiant de run candidat qui n'est pas un run réussi de `release.yml` de ce dépôt, et les identifiants passent par l'environnement, jamais par expansion dans le script ; `simulate_live_call.py` vérifie TLS par défaut ; deux signalements ReDoS mesurés faux positifs sur les témoins de CodeQL, ajoutés aux gardes de croissance ; brace-expansion 5.0.12.
- **urllib3 2.8.0** (CVE-2026-97687, CVE-2026-97688, CVE-2026-97689, publiées le 2026-09-30) : TLS d'un proxy HTTPS séparé de celui de la cible, boucle infinie sur un flux Deflate suivi d'octets, taille de bloc chunked bornée en lecture en flux. Dépendance transitive, seul pin déplacé dans les trois lockfiles.
- **Next.js 16.3.6** (GHSA-vcvr-r3jv-pc5j, critique : exécution de code via `next/og` `ImageResponse`, que LIA n'utilise pas) et **@grpc/grpc-js 1.14.5** par override (GHSA-m9gg-hp2v-232j, transitif via Firebase), publiés le 2026-09-30.
- **DOMPurify 3.4.16** par override (GHSA-p98j-92pf-mc4p : un hook `afterSanitize` qui retire un nœud en mode `IN_PLACE` laissait armés les gestionnaires d'événements du sous-arbre détaché).

### Tests

- Noms par compte et installation de la bibliothèque sur PostgreSQL, magasin des propositions sur un vrai Redis, sorties de commande en base, image du bac à sable (chaque commande exécutée), confiance et `untrusted_markdown` (croissance linéaire), réseau des commandes, carte de proposition et dialogue de la bibliothèque (vitest + parcours e2e), migration des modèles sur PostgreSQL et garde de migration.

## [2.1.1] - 2026-09-30

**Un texte à la taille de chacun, des exports lisibles, et une lecture du web qui ne se laisse plus détourner.** La taille du texte devient une préférence du compte, une réponse téléchargée garde sa structure, les cartes e-mail retrouvent leur contenu, une routine météo ne se déclenche plus sur une prévision lointaine ou improbable, et chaque page que LIA lit l'est sur l'adresse que la vérification a vue.

### Added

- **Taille du texte, de 14 à 20 px** : section « Taille de police » sous Paramètres › Préférences › Personnalisation, avec aperçu et retour au défaut. Seul le texte change : la variable `--lia-text-scale` multiplie l'échelle Tailwind `--text-*`, le `body`, les jetons `--lia-text-*` et l'utilitaire `text-px-N`, qui remplace les 372 classes `text-[Npx]` ; panneaux, marges et icônes gardent leurs dimensions (`e2e/smoke/font-size-extremes.spec.ts` compare les boîtes à 14, 16 et 20 px, de 320 à 1440 px de large). Persistée dans `users.font_size` (migration `7b885c320074`, CHECK 14-20), appliquée partout par `FontPreferencesSync` ; un `null` explicite est refusé en 422 pour les quatre préférences d'affichage. `cn()` apprend que `text-px-N` est une taille, sans quoi tailwind-merge supprimait la couleur voisine.
- **Export Markdown fidèle des réponses HTML** (amendement [ADR-177](docs/architecture/ADR-177-Rich-HTML-Response-Components.md)) : `lib/html-markdown.ts` écrit un fragment HTML en GFM (titres, emphase, liens suivables, listes imbriquées, tableaux, code clôturé, citations) et traduit le vocabulaire LIA — callout → alerte GFM de même gravité, tuiles → tableau, `lia-kv` → « **Libellé** : valeur » avec la ponctuation du lecteur, carte → titre `###` et puces ; icônes, boutons et images proxifiées restent à l'écran. `lib/message-markdown.ts` ne réécrit que les régions HTML au sens de CommonMark : le Markdown du modèle, blocs de code citant du HTML compris, atteint le fichier octet pour octet. « Télécharger », « Envoyer par e-mail » ([ADR-321](docs/architecture/ADR-321-A-File-Or-An-Answer-Sent-By-E-Mail.md)) et l'export d'un bookmark ([ADR-282](docs/architecture/ADR-282-Message-Bookmarks.md)) écrivent ce texte ; le presse-papiers et le partage gardent l'aplatissement texte.

### Changed

- **Déclencheur météo des routines : Google Weather, 4 heures, plus de 50 %** (amendement [ADR-322](docs/architecture/ADR-322-One-Clock-Per-Routine.md)). L'horizon réel était de cinq jours, aucune probabilité n'était lue, la note ne portait pas de date et la source était le fournisseur de la personne. Désormais une seule règle (`ForecastAlertRule`, `detect_forecast_alert`) sert la carte et la routine ; la routine lit `open_platform_weather_client` (prédicat sans clé d'ADR-307) sur `get_hourly_forecast`, non échantillonné, sous `SCHEDULED_ACTIONS_WEATHER_HORIZON_HOURS` (4, 1-23) et `SCHEDULED_ACTIONS_WEATHER_MIN_PRECIPITATION_PERCENT` (50, strictement au-dessus) ; une cadence de vérification supérieure à l'horizon est refusée au démarrage. La note nomme l'heure, le jour, le fuseau, la probabilité et la source ; la règle est publiée (`weather_condition_rule`) et affichée au studio dans les six langues. Deux appels facturés par vérification au lieu de six. La carte du briefing revient à ses 24 heures documentées.
- **Recherche d'intérêts de la radio : un compte, deux bornes** (amendement [ADR-324](docs/architecture/ADR-324-A-Personal-Radio-A-Grid-Decides-Models-Only-Write.md)). `RADIO_INTEREST_TOPICS_MAX` passe à 5 et s'applique une seule fois, à la lecture des goûts : le rédacteur connaît exactement les sujets recherchés. Le bureau lit les sources et les trouvailles des recherches sous deux bornes (`news_candidates(limit=, interests_limit=)`), la seconde égale au plus que les recherches peuvent classer dans l'horizon — aucune histoire payée avec la clé de l'auditeur n'est plus écartée — et nulle quand la session ne porte aucun intérêt (écoute en compagnie, capacité coupée). Brave est interrogé sur les jours du bureau plutôt que sur la semaine.
- **CodeQL élargi** : les scripts déployés, l'infrastructure, les coques mobiles et les workflows entrent dans l'analyse (`codeql-config.yml`), trois exclusions de règles de sécurité sont retirées et `security.yml` analyse `python`, `javascript` et `actions`.

### Fixed

- **Cartes e-mail vides en niveau `metadata`** (amendement [ADR-287](docs/architecture/ADR-287-Email-Content-First-Detail-Levels-Digests-And-Neutral-Message.md)) : le niveau décide de ce que lit le modèle, jamais de ce que dessine la carte. Le corps retenu passe sous `FIELD_DISPLAY_ONLY` et `RegistryItemMeta.display` avant toute copie de charge ; les cartes le lisent par `data_registry/card_payload.py`, y compris depuis une référence résolue. La recherche Gmail respecte `headers_only` (sinon `format=full`), sa clé de cache nomme le format, et `EmailClientProtocol.SEARCH_HITS_ARE_WHOLE` évite de relire un résultat complet : N+1 requêtes Gmail à tous les niveaux au lieu de 2N+1 en `full`.

### Security

- **Aplatisseurs linéaires par construction** ([ADR-326](docs/architecture/ADR-326-Linear-Flatteners-And-Pinned-Fetches.md)) : 34 combinaisons super-linéaires sur 9 fonctions côté API et 11 côté navigateur, réduites à sept motifs racines puis réécrites — chaque portée appariée bornée (`MARKDOWN_SPAN_MAX_CHARS`, `MARKDOWN_CODE_SPAN_TICKS_MAX`), aucune classe de caractères partagée entre deux voisines. Une carte e-mail hostile de 32 Ko passe de 3 004 ms à 0,53 ms. `display/components/html_flatten.py` est extrait du module gelé ; la plage CJK de compatibilité, normalisée en U+8C48 dans deux copies privées, retrouve ses échappements.
- **Fetch épinglé contre le rebinding DNS** (ADR-326) : `UrlValidationResult.resolved_ips` et `pinned_stream` connectent à l'adresse vérifiée (nom dans `Host` et le SNI, punycode compris), sans suivi automatique des redirections ; l'outil de lecture de page valide chaque saut avant le suivant (`_read_html_following_redirects`), comme le collecteur de la radio et l'import de skills. `validate_resolved_url` est supprimé.
- **Pont Hue limité aux réseaux privés** (`HUE_BRIDGE_NETWORKS`), proxy d'image qui répond 400 à une URL invalide, cache d'embeddings des outils en 0o600, chemins de stockage des espaces résolus par `rag_spaces/storage_paths.py`.
- **`DEBUG=true` refusé au démarrage en production** (`Settings._refuse_debug_in_production`) : une exception non gérée répondrait avec son propre texte.

### Tests

- Croissance n/4n et équivalence exhaustive des aplatisseurs (API et jumeaux navigateur), projection vocale CJK, fetch épinglé (redirections internes, rebinding, IDNA), cinq types de condition sur cinq vérifications successives en PostgreSQL, règle météo (horizon, seuil strict, types, heure en cours), parité des clients e-mail et corps retenu jusqu'à la carte, export Markdown sur un corpus de réponses archivées et dans un vrai Chromium, taille du texte aux extrêmes.

## [2.1.0] - 2026-09-29

**Des choix plus lisibles, une démonstration plus concrète et une voix plus régulière.** LIA présente ses usages dans une vitrine remaniée et peut confier certaines décisions circonscrites à JEV, sous le contrôle de l'administrateur. Chaque usage reste facultatif ; les validations, les permissions et la confirmation des actions demeurent dans LIA.

### Added

- **Décisions natives JEV, activables usage par usage** ([ADR-325](docs/architecture/ADR-325-JEV-Bounded-Decisions-With-Hot-Switches-And-Accounted-Fallbacks.md)) : sélection du format de compte rendu, qualification de résultats déjà obtenus, consultation bornée, vérification radio, exclusion proposée dans une liste soumise à confirmation et observation des extractions. Une bascule générale conserve les préférences de chaque usage ; l'admin voit les appels, leur coût et leur durée dans le diagnostic.
- **Contrôle partagé de la synthèse ElevenLabs** : une borne par clé API, commune aux workers et aux surfaces vocales, évite de lancer simultanément plus de requêtes que le compte n'en autorise. Le lecteur web gère la file audio sans perdre l'ordre des séquences.

### Changed

- **Vitrine et démonstration** : parcours de fonctionnalités, scènes interactives et schéma d'architecture réorganisés pour expliquer les usages, la confirmation des actions et la confidentialité. Les réglages radio montrent plus clairement les sources, les voix, les programmes et la dépense.
- **Choix de modèle et comptabilité** : les décisions JEV utilisent un emplacement dédié, un tarif administré et des plafonds de dépense. Une décision incertaine ou indisponible repasse par le traitement existant ; une tentative payante et son repli sont tous deux comptés. Les observations d'extraction n'effacent aucune extraction existante.

### Fixed

- Les aperçus de pertinence ne retirent pas les résultats canoniques de la réponse finale ; une qualification documentaire ne prétend pas connaître le contenu d'un document entier à partir d'un extrait.
- Les exclusions proposées avant approbation ne peuvent jamais approuver une action ni élargir le périmètre soumis à la personne.
- La production vocale ElevenLabs ne dépasse plus la capacité configurée lorsque plusieurs workers ou usages la sollicitent ensemble ; les séquences déjà reçues restent ordonnées dans le navigateur.

### Tests

- Contrats de bascule et de repli, autorisations et dépenses JEV, corpus de qualification indépendants, concurrence ElevenLabs et file audio, parcours frontend des réglages et du diagnostic.

## [2.0.0] - 2026-09-28

**Une radio personnelle, des fichiers que l'on choisit de garder, et une conversation qui suit les événements sans rechargement.** Cette version rassemble les nouvelles façons d'écouter, de conserver et de partager le travail de LIA, avec des règles de langue et de vérification plus explicites.

### Added

- **Radio personnelle à la demande** ([ADR-324](docs/architecture/ADR-324-A-Personal-Radio-A-Grid-Decides-Models-Only-Write.md)) : journal du jour et actualités de sources identifiées, grille de programmes décidée par le code, rédaction et voix de synthèse, sources et dépense visibles, préférences de sujets, de voix et de vérification. L'antenne ne produit que pendant l'écoute, s'arrête au minuteur, et la capacité peut être désactivée par l'exploitant. Le démonstrateur public la garde désactivée.
- **Conservation sélective des fichiers générés** ([ADR-319](docs/architecture/ADR-319-A-Generated-File-Can-Be-Kept.md)) : images, documents et captures peuvent être gardés sans date d'expiration depuis la galerie, sous deux plafonds publiés par compte. Cesser de garder un fichier lui donne un nouveau délai de conservation ; la carte du chat relit son état actuel.
- **Envoi par e-mail d'un fichier ou d'une réponse** ([ADR-321](docs/architecture/ADR-321-A-File-Or-An-Answer-Sent-By-E-Mail.md)) : sujet et message facultatif, pièce jointe issue de la galerie ou réponse exportée en Markdown. La boîte connectée accepte des destinataires choisis ; le relais de LIA ne peut écrire qu'à l'adresse vérifiée du compte. Les limites réelles du chemin choisi sont affichées avant l'envoi.

### Changed

- **Conversation synchronisée** ([ADR-320](docs/architecture/ADR-320-The-Chat-Follows-The-Server-Without-A-Reload.md)) : les messages arrivés d'un autre onglet, appareil, canal, appel ou automatisation rejoignent le fil après validation en base. La fusion préserve les anciens messages chargés, la lecture et une action en cours ; la reconnexion rattrape les événements manqués.
- **Une seule horloge par routine** ([ADR-322](docs/architecture/ADR-322-One-Clock-Per-Routine.md)) : une routine suit soit son calendrier, soit une condition vérifiée périodiquement par LIA. Le studio montre les champs du mode choisi et les vérifications sans résultat ne créent plus d'exécution fictive.
- **Langue déclarée de bout en bout** ([ADR-323](docs/architecture/ADR-323-Declared-Language-Complete-Tables-English-For-The-Model.md)) : les chaînes visibles, les catalogues gettext et les tables multilingues sont vérifiés dans les six langues ; les instructions techniques destinées au modèle restent distinctes de la langue de la personne.

### Fixed

- Une carte de fichier ne conserve plus un délai périmé après conservation ou suppression ; le balayage des expirations ne peut plus effacer un fichier gardé entre lecture et suppression.
- L'historique du chat ne perd plus ses anciennes pages lors d'une mise à jour et ne dédouble plus une réponse arrivée hors du flux courant.
- Les pièces jointes sortantes utilisent un format MIME commun aux fournisseurs ; les erreurs de taille, de boîte déconnectée et de destinataire sont expliquées sur l'écran d'envoi.

### Tests

- Tests de concurrence PostgreSQL pour la conservation et les signaux après commit, contrats des fournisseurs d'e-mail, tests de fusion du chat, de planification des routines, de catalogues linguistiques et de la grille, des sources, des voix et du budget radio.

## [1.47.4] - 2026-09-25

**Ce qui doit être exact est calculé, et LIA relit ses propres registres ; la mémoire se consulte exprès, un e-mail à soi-même part sans brouillon, une image générée se partage avec une connexion, et les journaux ne gardent que des faits.**

**Six outils pour des réponses exactes et pour les propres registres de LIA** ([ADR-318](docs/architecture/ADR-318-Assistant-Tools-Exact-Answers-And-Own-Records.md)). Un modèle de langage prédit du texte ; il ne fait pas d'arithmétique. `calculate_tool` évalue une expression en décimal exact en parcourant un arbre `ast` — jamais exécuté —, refuse les infinis que `decimal` rend sans lever (`0 ** -1`, `ln(0)`) et dit quand il a dû arrondir ; `date_time_tool` compte une durée entre deux instants absolus — Python soustrait deux dates d'un même `tzinfo` sur leur heure murale, 24 h pour les 25 d'un changement d'heure — et les jours ouvrés sans déduire les jours fériés, en le disant ; `convert_currency_tool` lit le taux de référence de la BCE et sa date, une paire non publiée étant une `UnsupportedCurrencyError` et jamais une panne. `search_journal_tool` cherche dans les carnets (L0 exclu, plancher CONFIGURÉ plutôt qu'appris : l'injection ne gardait qu'une entrée pertinente sur six), `get_my_activity_tool` répond depuis les deux registres avec des totaux exacts et le filtre d'auteur des onglets, `find_generated_files_tool` retrouve un fichier de la galerie vivante et le montre comme les cartes mêmes du chat — dont la livraison ne dépend plus des drapeaux de génération. Le contrat de date passe dans `core/date_contract.py` ; chaque borne appliquée est un réglage énoncé dans la formulation que lisent à la fois le manifeste du planificateur et le schéma ReAct (épinglé par test).

**La mémoire long terme devient une recherche active, par une seule porte** ([ADR-313](docs/architecture/ADR-313-Long-Term-Memory-As-An-Active-Lookup.md)). `domains/memories/search.py` plonge une requête comme une CLÉ — sans les motifs de trivialité conversationnelle, qui entrent en collision avec des noms réels — et sert les souvenirs vivants au-dessus du plancher. Tous les appelants y passent : les faits mémoire du planificateur, de l'initiative et de la résolution de références, le rappel 360°, et les recherches du téléphone, qui servaient les dix souvenirs les plus RÉCENTS quelle que soit la question, faute de vecteur. Un domaine routable `memory` porte `search_memories_tool` : bornes publiées depuis leurs sources, préférence `memory_enabled` respectée, un souvenir sensible rendu avec sa nuance d'usage, un échec jamais lu comme « rien en mémoire » ; hors `PHONE_DOMAINS`, qui porte déjà son propre rappel.

**Un e-mail à soi-même ne demande pas de confirmation** ([ADR-314](docs/architecture/ADR-314-An-E-Mail-To-Oneself-Needs-No-Confirmation.md)). `send_email_to_me_tool` n'a pas de destinataire en paramètre : l'adresse de la boîte connectée telle que son fournisseur la déclare (`EmailClientProtocol.get_own_address`, parité épinglée sur les trois clients), sinon le relais de LIA vers l'adresse VÉRIFIÉE du compte. Déclaré `reversible`, il tourne dans une routine là où un brouillon est refusé. Une adresse tapée qui se trouve être la sienne passe toujours par `send_email_tool` et son brouillon — arbitrage du propriétaire : un destinataire qui sauterait parfois la confirmation serait une cible d'injection. Une seule résolution de contenu sert les deux outils d'envoi (`agents/emails/content_generation.py`).

**Un prompt d'image peut être réécrit, jamais dénaturé** ([ADR-315](docs/architecture/ADR-315-Image-Prompt-Enhancement.md)). Sur option de la personne (`users.image_generation_prompt_enhancement`, désactivée par défaut) et sauf retrait par l'exploitant (`IMAGE_PROMPT_ENHANCEMENT_ENABLED`, un seul lecteur partagé par l'outil et la route des options), un slot dédié `image_prompt_enhancement` réécrit la description d'une nouvelle image sous un prompt versionné tiré des guides des fournisseurs. Des contrôles déterministes — vide, au-delà de la borne publiée, texte entre guillemets perdu — et tout échec envoient le prompt d'ORIGINE : l'amélioration n'est jamais une porte. Une retouche n'est jamais réécrite ; le prompt envoyé au fournisseur est facturé et audité, la galerie garde les mots de la personne.

**Une image générée se partage avec une connexion, en copie** ([ADR-316](docs/architecture/ADR-316-Sharing-A-Generated-Image-With-A-Connection.md)). Le clic vaut confirmation, sans brouillon ni modèle : `POST /peers/connections/{id}/images` vérifie la connexion (acceptée, non bloquée) et l'image (générée, vivante, à l'expéditeur), tient deux quotas quotidiens sérialisés par expéditeur sous un verrou consultatif de transaction — prouvé en échec sans lui —, copie le fichier et écrit la ligne de galerie du destinataire (origine `generated_image`, durée de vie comptée depuis la réception, `shared_by_name`) et le registre `peer_image_shares` dans une même transaction, puis atteint au mieux le chat du destinataire sur une session à part. Les mots d'un tiers dans le chat de quelqu'un d'autre y sont cités À LA LETTRE (`domains/shared/markdown_literal`) : le chat rend le Markdown avec HTML brut et images `https:`, si bien qu'un commentaire non neutralisé pourrait charger une image de pistage ; la neutralisation passe par des références numériques de caractères, jamais par des antislashs, que l'étape mathématique du chat rend en formule (mesuré dans le navigateur).

**Une diffusion dit à qui elle s'adresse** ([ADR-312](docs/architecture/ADR-312-A-Broadcast-Says-Who-It-Was-Addressed-To.md)). Une diffusion ciblée était enregistrée SANS ses destinataires : la liste des non-lus la servait à tous les comptes à leur connexion suivante, et une sélection vide voulait dire tout le monde. `admin_broadcasts.audience` et `admin_broadcast_recipients` portent l'audience, RÉSOLUE avant l'écriture de la ligne ; une sélection qui ne vise aucun compte actif est refusée (400) ; le rattrapage lit le journal d'audit d'administration et n'avorte jamais sur une ligne malformée. `GET /notifications/admin/broadcasts` sert une page et son total exact, un échantillon borné des destinataires avec leur compte exact, l'instant d'expiration et le délai choisi, en quatre requêtes quelle que soit la taille de la page ; les jetons FCM sont lus une fois par groupe de langue — ils l'étaient un compte à la fois —, tous avant le premier appel réseau (ADR-304) : la livraison ne garde plus de transaction ouverte pendant que FCM répond.

**Une ligne de journal porte des faits, jamais les mots de la personne** ([ADR-317](docs/architecture/ADR-317-A-Log-Line-Carries-Facts-Never-The-Words.md)). La v1.47.3 en avait retiré six événements du tour ; ce programme couvre tout le reste. Mesuré avant tout changement : 438 valeurs au-dessus de DEBUG portaient les mots d'une personne, et `hide_parameters` seul retire la ligne de paramètres de SQLAlchemy mais pas ce que PostgreSQL CITE (`DETAIL`, l'entrée d'une conversion, le `CONTEXT` de psycopg), que chaque traceback transporte. Le filtre retire ces citations par leur forme fixe au-dessus de DEBUG, masque les clés des fournisseurs dans les URL (`key=`, `appid=`) à tous les niveaux, et sa liste de contournement est exactement l'enveloppe que la chaîne produit (`filename=` échappait à toutes les règles). Une erreur de base est journalisée par ses faits (`infrastructure/database/errors.py` : SQLSTATE, contrainte, table), chaque moteur masque ses paramètres, et `test_log_content_guard.py` refuse PAR LA VALEUR un aperçu ou une valeur dérivée d'un contenu, chaque exception portant sa raison écrite.

**Une réponse a deux sorties directes, et le panneau de débogage dit ce qui a réellement tourné.** Le menu « … » sous une réponse devient deux icônes : Télécharger (un fichier Markdown daté, en un clic) et Partager (la feuille de partage de l'appareil, puis les connexions, dont le choix préremplit la saisie au lieu d'envoyer — le relais suit la route ordinaire, confirmation comprise). Les libellés des actions effectuées ne sont plus coupés à 120 caractères (`EFFECT_LABEL_VALUE_MAX_CHARS`, lu à la réservation). Le panneau de débogage affiche le slot et le modèle réellement appelés — la fabrique estampille `llm_type` et le fournisseur SUR le modèle, là où tout apparaissait sous `agent_graph` —, le modèle demandé avec « Served as » quand le fournisseur répond sous un alias, des en-têtes de phase au-dessus des titres de section, et se redimensionne à la souris comme au clavier, la largeur retenue par appareil.

**Chaque outil dit ce qu'il fait pendant qu'il le fait.** Vingt-trois outils n'avaient pas de libellé de progression — tout le Workboard, la santé, les actions planifiées, les connexions, les appels, la recherche dans les espaces de connaissances — et le chat affichait une étape générique à leur place, alors qu'un article public affirmait que chaque outil avait le sien. Leurs libellés existent désormais dans les six langues, comme ceux des huit nouveaux outils, et `test_tool_step_label_guard.py` lit chaque `DisplayMetadata` d'outil dans le code SOURCE — un outil derrière un drapeau n'y échappe pas — et fait échouer la construction si l'un d'eux n'a pas son texte.

### Added

- **ADR-318** : `agents/calculation/` (`evaluator.py`, `dates.py`, manifestes), `agents/activity/`, `agents/journal/`, `agents/generated_file/`, `effects/activity.py`, `journals/search.py`, `core/date_contract.py`, `tools/{calculation,activity,journal_search,generated_files}_tools.py`, `tools/lookup_parameters.py`, `attachments/urls.py` ; réglages `CALCULATOR_EXPRESSION_MAX_CHARS`, `CALCULATOR_PRECISION_DIGITS`, `EFFECT_ACTIVITY_MAX_ACTIONS`, `EFFECT_ACTIVITY_WINDOW_DAYS`, `GENERATED_FILES_SEARCH_MAX_RESULTS`, `JOURNAL_SEARCH_MAX_RESULTS`.
- **ADR-313** : `memories/search.py` (`embed_lookup`, `search_memories`), domaine `memory` et `search_memories_tool`.
- **ADR-314** : `send_email_to_me_tool` (`tools/email_self_tools.py`, `emails/self_send_manifest.py`), `EmailClientProtocol.get_own_address` sur les trois clients, `emails/content_generation.py`.
- **ADR-315** : `image_generation/prompt_enhancement.py`, slot `image_prompt_enhancement` et prompt `image_prompt_enhancement_prompt.txt`, colonne `users.image_generation_prompt_enhancement` (mixin `users/image_generation_columns.py`, migration `79db1056a28e`), réglages `IMAGE_PROMPT_ENHANCEMENT_ENABLED` et `IMAGE_PROMPT_ENHANCEMENT_MAX_CHARS`, option « Améliorer automatiquement les prompts ».
- **ADR-316** : `peers/image_share.py`, route `POST /peers/connections/{id}/images`, table `peer_image_shares` et colonne `attachments.shared_by_name` (migration `fe0475369c8e`), `shared/markdown_literal.py`, `image_generation/delivery.py`, réglages `PEERS_IMAGE_SHARE_MAX_PER_DAY` et `PEERS_IMAGE_SHARE_MAX_PER_DAY_PER_PAIR` ; web : `ShareImageButton`, `ShareImageDialog`, `AssetShareControls`, `lib/peers/image-share.ts`.
- **ADR-312** : colonne `admin_broadcasts.audience` et table `admin_broadcast_recipients` (migration `a19e985e4ce5`), `notifications/broadcast_history.py`, route `GET /notifications/admin/broadcasts` ; web : `AdminBroadcastHistory`, `useBroadcastHistory`.
- **ADR-317** : `infrastructure/database/errors.py` (`database_error_fields`, `classify_database_error`), `observability/quoted_content.py`, `observability/log_facts.py` (`log_unreadable_text`, `url_host`).
- Interface : `ActionChipButton` (copier, garder, partager, télécharger), `ShareResponseActions`, `ResizableDebugPanel` et `stores/debugPanelStore.ts`, `debug/utils/{call-model,panel-width}.ts`, `lib/peers/{availability-context,recipients}` ; réglage `EFFECT_LABEL_VALUE_MAX_CHARS`.
- Libellés de progression de 31 outils (`execution.steps`) dans les six langues : les 23 qui n'en avaient pas et les huit nouveaux.
- Gardes : `test_tool_step_label_guard.py`, `test_log_content_guard.py`, `test_sql_parameters_hidden_guard.py` ; la garde des guides refuse un paragraphe collé à une règle `---` (un titre setext que la navigation ne voit pas) ; `doc_facts` lit aussi les guides publics du site (`FACT_ONLY_GLOBS`), qui citaient la pile technique hors de tout contrôle.

### Changed

- Documentation : ADR-312 à ADR-318, amendement d'ADR-263 (la borne des libellés d'effets), `ADR_INDEX.md`, `INDEX.md`, `PII_LOGGING_SECURITY.md`, `JOURNALS.md`, `LONG_TERM_MEMORY.md`, `PLANNER.md`, `AGENT_MANIFEST.md`, `ATTACHMENTS_INTEGRATION.md`, `IMAGE_GENERATION.md`, `DEBUG_PANEL.md`, `DATABASE_SCHEMA.md`, `TELEPHONY.md`, `TOOLS.md`, `AI_ACT_TRACEABILITY.md`, `HITL.md` (ce qui n'a rien à confirmer), `NOTIFICATIONS_FLOW.md` (le flux des annonces d'administration), `GRAFANA_DASHBOARDS.md` (les nouvelles lignes des tableaux 05 et 09), `LLM_CONFIG_ADMIN.md` (61 types), `ARCHITECTURE.md` et `GETTING_STARTED.md` (123 outils), `GUIDE_TOOL_CREATION.md`, `CLAUDE.md` et `AGENTS.md`, douze documents de `docs/knowledge/`, cartes vivantes (sept décisions, rôle de huit briques fonctionnelles, dans les six langues).
- Vitrines, dans les six langues : FAQ (sept nouvelles questions — partage d'image, amélioration du prompt d'image, e-mail à soi, calculs exacts, recherche dans le journal, journaux techniques du serveur, annonces ciblées — et sept réponses amendées : icônes Partager et Télécharger, exception de l'e-mail à soi dans l'envoi et les brouillons, page Registres et question « qu'as-tu fait ? », mémoire consultée exprès, fichiers retrouvés en le demandant), huit cartes de « Comment fonctionne LIA » (123 outils, calculs exacts, mémoire, carnets, registres, connexions, images, sécurité), landing (six fonctionnalités, carte RGPD, page Technique à seize cartes dont « Exact là où il le faut »), page Encore + (79 attentions : partage et export redessinés, nouvelle capsule « Une image, partagée en copie » avec sa scène animée), guides How, Why et Story, six articles du blog, lexique de recherche des réglages (annonces ciblées, partage d'image).
- Le libellé du menu de partage d'une réponse devient « Partager avec une connexion », comme le bouton de partage d'une image.
- Registre : les chaînes des espaces touchés par cette version — connexions, galerie et signets, amélioration du prompt, étapes du chat, libellés d'effets, diffusion — tutoient en français, en allemand, en espagnol et en chinois, comme le reste de l'application.

### Fixed

- Diffusion ciblée servie à tous les comptes à leur connexion suivante ; jetons FCM lus dans une transaction encore ouverte pendant l'envoi (ADR-304).
- Rappel mémoire du téléphone qui servait les derniers souvenirs au lieu de ceux qui répondent à la question.
- Libellés des actions effectuées coupés à 120 caractères ; slot `agent_graph` affiché pour tous les appels du panneau de débogage ; échec d'appel enregistré sous un modèle `unknown` plutôt que sous le modèle demandé.
- Page FAQ : la clé brute `faq.sections.plugins.description` affichée sous la section Plugins ; entrées sans accents (images en allemand, espagnol et italien ; contrôle du navigateur en français, espagnol et italien ; descriptions et titre de section) ; formats d'image annoncés PNG/WebP au lieu de PNG, JPEG ou WebP ; chemins erronés (page Registres, mémoire long terme, préférences d'images en espagnol) ; « LIA apprend à toi connaître », cinq « tu voyes » et un « tu n'appuyes » ; 132 guillemets allemands fermés par un guillemet droit ; ponctuation demi-chasse en chinois ; entrées en vouvoiement touchées par cette version.
- Interface espagnole : « Administracion », accents de la section Police, « limite de uso » ; « leggibilita » en italien.
- Blog : chargeur de prompts de repli qui n'existe plus, taille du cache LRU, variable `ROUTER_PROMPT_VERSION` inexistante ; « 115 outils couverts » qui n'était pas vrai ; chiffres périmés, mesurés contre le code : 61 rôles LLM (56 et 60 annoncés), 155 fichiers de prompts (78), 40 fichiers de FAQ dans l'espace système (18), 589 métriques (587), 39 modules de métriques (38), 29 alertes vitales (14), 25 types de données du registre (24), plus de 200 tests unitaires du Psyche Engine (158), une purge de compte sur plus de 50 tables (22) et une table de facturation conservée que la liste omettait ; les « 8 métriques Langfuse » décrivaient ce que la trace enregistre, pas les sept métriques Prometheus de l'intégration ; titre anglais « 16 agents » quand les autres langues disent « 20+ ».
- Allemand : une quarantaine de phrases cassées par l'ancien passage au tutoiement, qui avait aussi converti le « Sie » de la troisième personne (« Du funktionierst wieder » pour des widgets, « für du », « worum du gebetest hatten »…), dans la FAQ, son changelog, la page Encore +, le blog et le guide Why.
- Pile technique citée : les six guides How annonçaient Python 3.12+ et Next.js 16.2.10 (3.14 et 16.3.4 épinglés), LangChain Core 1.5.5, TypeScript 6.0.2, Tailwind 4.3.2, structlog et Playwright « latest » ; mêmes écarts dans `docs/INDEX.md`, `STACK_TECHNIQUE.md` (et `langchain-openai` 1.5.1) et `GUIDE_DEVELOPPEMENT.md`.
- 25 types de données dans la réponse de la FAQ sur la provenance et dans `docs/knowledge/15_privacy.md` ; 29 alertes vitales dans le guide How ; les documents techniques d'alerte renvoient à `alerts-core.yml` au lieu de répéter un « 14 » devenu faux ; `LANDING_PAGE.md` et `METRICS_REFERENCE.md` ne répètent plus des comptes de cartes, de scènes et de tableaux de bord devenus faux, et le flux des notifications n'annonce plus « deux types » au-dessus d'un tableau qui en liste cinq.

### Tests

- Backend : évaluateur, dates et outils de calcul, taux de change, recherche mémoire et journal (unitaires et PostgreSQL), activité (unitaires et PostgreSQL), fichiers générés, livraison des cartes d'image et de document, e-mail à soi et adresse de la boîte propre, amélioration du prompt d'image, partage d'image (unitaires et PostgreSQL, deux acteurs concurrents), audience et historique des diffusions (PostgreSQL et route), faits d'erreur de base (unitaires et PostgreSQL), citations retirées, filet de contenu du filtre, attribution du slot, gardes des journaux, des paramètres SQL et des libellés de progression.
- Frontend : `ShareResponseActions`, `ShareImageButton`, `ShareImageDialog`, `AssetShareControls`, `AdminBroadcastHistory`, `ResizableDebugPanel`, `debugPanelStore`, utilitaires du panneau de débogage, garde de la page Encore + (79 capsules), garde des guides (titres setext), câblage du changelog (v1.47.4 en tête) ; parcours Playwright `chat-answer-actions`, `chat-image-share`, `admin-broadcast-history`.
- Portes mesurées avant le commit : `task lint` vert (dont `doc_facts` : 149 occurrences citées, aucune dérive, guides publics compris) ; tests unitaires backend 30 253 passés, couverture 77,16 % pour un plancher de 74 % ; porte des marqueurs (32 725 tests collectés, aucun orphelin) ; 9 160 tests vitest dans 738 fichiers, seuils de couverture tenus (81,83 % des instructions, 76,74 % des branches) ; `tests/agents/` 1 122 passés ; les 46 nouveaux tests d'intégration verts sur un vrai PostgreSQL (Testcontainers) ; rejeu de la chaîne de migrations depuis une base vide avec équivalence structurelle et `alembic check` sans écart ; porte d'installation hermétique verte (assistant, artefacts de release, 24 scénarios Compose, contrats backend dont « un environnement valide démarre `Settings` ») ; tests du chemin de déploiement (151 Pester et la porte de disponibilité) ; 297 parcours Playwright + axe passés sur un build de production.

## [1.47.3] - 2026-09-24

**Chacun choisit le rythme de ses échanges ; l'historique d'un tour ReAct ne bouge plus en plein tour ; les journaux ne portent plus les mots de la personne.**

**Le rythme d'échanges appartient à la personne** ([ADR-311](docs/architecture/ADR-311-Exchange-Rhythm-Is-The-Persons-Choice.md), amendant ADR-308, ADR-309 et ADR-293). Un drapeau d'instance (`REACT_CROSS_TURN_CACHE_ENABLED`) décidait pour tout le monde de lier tous les outils, de placer le contexte du tour après la question et de faire tomber l'historique par blocs. Or le gain dépend de la façon dont une PERSONNE utilise LIA : des tours rapprochés relisent le précédent en cache, des tours espacés de plusieurs heures repaient chaque fois le premier appel plus lourd. Un nouveau menu **Réglages › Préférences › Personnalisation › « Préférences d'usage »**, fait pour accueillir d'autres réglages, offre deux choix : **échanges fréquents** (tous les outils, un premier message plus coûteux puis des suivants bien moins chers) et **échanges ponctuels** (outils choisis par pertinence, coût stable). Les trois effets voyagent ensemble parce que, mesuré sur le banc d'ADR-308 (396 tours réels), aucun ne paie seul : avec tous les outils, déplacer le contexte fait −42 % au lieu de +44 % sur DeepSeek, mais reste neutre sur Claude et coûte 3 points sur GPT-5.6 et 7 sur qwen3.7-plus ; sous la sélection par pertinence, deux tours successifs ne partagent qu'environ deux tiers de leurs outils et le préfixe casse avant le contexte. Le choix est stocké par compte (`users.exchange_rhythm`, migration `402dd18bbf2a`, nullable et non remplie) ; un compte qui n'a pas choisi suit `REACT_CROSS_TURN_CACHE_ENABLED`, devenu le défaut de l'opérateur, si bien qu'aucun déploiement ne change de comportement à la mise à jour. La valeur est lue UNE fois par tour : le service de flux lit le compte, le constructeur unique du contexte d'exécution résout le rythme effectif (`core/exchange_rhythm`, seul lecteur du réglage, garde AST), le routeur le publie dans l'état du tour, le setup et chaque appel le lisent (`react_turn_layout.frequent_exchanges`) ; une reprise HITL rentre dans le nœud interrompu, jamais dans le routeur, donc un tour garde le rythme avec lequel il a commencé. Les actions planifiées, les tickets du Workboard et les tours vocaux relayés suivent le rythme du compte.

**L'historique d'un tour ReAct ne bouge plus en plein tour** (amendement d'[ADR-309](docs/architecture/ADR-309-One-Prompt-Layout-For-Every-Cache-Mechanism.md)). Mesuré en production au premier matin sous le drapeau : les appels de boucle des routines ont coûté 0,275 € contre 0,17 à 0,19 € les jours précédents au même rythme. Les blocs d'historique se calaient sur la LONGUEUR du fil, que le réducteur d'état rogne par la tête à chaque résultat d'outil d'un long tour : sur une routine du fil principal, l'historique est passé de 121 à 85 messages et le premier message montré a bougé trois fois en plein tour. À chaque fois, le fournisseur n'a relu que le prompt et les outils (77 312 jetons) et a refacturé 94 403 à 152 869 jetons, soit 425 000 jetons non relus sur ce fil ; au tarif horaire exact, ces cassures ont coûté 0,089 € sur les routines de la matinée, presque tout le surcoût. Le nombre de tours gardés se calcule désormais par le seul compteur de tours de la conversation, compté depuis la fin, en tours entiers depuis leur question (`get_block_windowed_messages`) : un rognage de tête qui laisse les tours gardés en place ne change plus rien, et la fenêtre ne s'ouvre plus sur une réponse privée de sa question. Un fil qui garde tous ses tours reçoit exactement la vue d'avant ; si le réducteur a rogné dans le bloc, la boucle garde la fenêtre propre (5 tours).

**Les journaux ne portent plus les mots de la personne.** Mesuré en production sur sept jours (noms de champs et longueurs seulement) : `orphan_tool_message_removed` écrivait en WARNING les 100 premiers caractères d'un résultat d'outil (courriels, agenda, contacts), 330 fois ; `detected_interrupt_resumption` écrivait en INFO la réponse tapée par la personne, 11 fois. Ces deux événements, deux autres journaux de reprise HITL, le début de tour du routeur et le repli de rédaction d'un e-mail ne portent plus que des longueurs, sous une garde AST.

### Added

- **ADR-311** : `core/exchange_rhythm.py` (`ExchangeRhythm`, `effective_exchange_rhythm`), colonne `users.exchange_rhythm` (mixin `users/turn_preferences_columns.py` avec `execution_mode`, qui fait sortir `users/models.py` de son plafond de taille) et migration `402dd18bbf2a`, champ `LiaRuntimeContext.exchange_rhythm` et paramètre `user_exchange_rhythm` du constructeur, clé d'état `exchange_rhythm` publiée par le routeur, `react_turn_layout.frequent_exchanges`, paramètre `every_tool` de `ReactToolSelector.select`, paramètre `blocks` de `window_messages_for_react` ; `exchange_rhythm` dans `UserUpdate` (strict, chaînes exactes) et dans le profil (valeur EFFECTIVE) ; section de réglages `usage-preferences` (`UsagePreferencesSettings.tsx`, groupe radio natif, icône `UserCog`, recherche et raccourcis), `lib/exchange-rhythm.ts`, clés `settings.usage_preferences.*` dans les six langues.
- **Historique ReAct** : `block_window_turns` et `get_block_windowed_messages` (`utils/message_windowing.py`) ; l'événement `message_windowing_complete` porte `turn_id`, `turns_wanted`, `turns_available` et `turns_kept`.
- Gardes : seul `core/exchange_rhythm` lit `REACT_CROSS_TURN_CACHE_ENABLED` ; la liste web des rythmes est le vocabulaire du backend ; `test_turn_logs_carry_counts_guard.py` (six événements du tour, des longueurs jamais des mots).

### Changed

- `REACT_CROSS_TURN_CACHE_ENABLED` devient le rythme d'échanges d'un compte qui n'a pas choisi (description, `.env.example`, `.env.prod.example`, `GETTING_STARTED`) ; `get_windowed_messages` retrouve son code d'avant ADR-309 ; le sélecteur, la mise en page et l'historique de la boucle ne lisent plus aucun réglage, seulement l'état du tour.
- Documentation : ADR-311, amendements d'ADR-308 et d'ADR-309, `REACT_EXECUTION_MODE.md`, `CLAUDE.md` (un quatrième piège d'état : rien qui doive tenir un tour ne dérive de la longueur de `messages`), guide « How » dans les six langues, cartes vivantes (ADR-311, rôle de la brique ReAct).
- Le réglage dit où il agit : en mode ReAct, actions planifiées et Workboard compris (le mode Pipeline garde son propre planificateur et n'est pas concerné).
- Vitrines, dans les six langues : capsule « À ton rythme » de la page Encore + (78 attentions, icône métronome, scène animée : les mêmes quatre messages sous les deux rythmes), question 30 de la section Paramètres de la FAQ, carte « Mode d'Exécution ReAct » de « Comment fonctionne LIA » (sa longueur reste dans la fourchette des autres cartes), carte « Le coût, au centime » de la landing condensée (elle était deux fois plus longue que ses voisines et raccourcit en nommant le rythme), carte d'orchestration de la page Technique, guide « Philosophie » (ce que chacun configure, frugalité), article de blog sur le mode ReAct (l'option d'opérateur est devenue le choix de la personne), nouveautés v1.47.3.

### Fixed

- Premier message de l'historique ReAct qui bougeait en plein tour quand le réducteur rognait la tête du fil, cassant le cache du fournisseur après les outils ; fenêtre qui pouvait s'ouvrir sur une réponse sans sa question.
- Texte des résultats d'outils et réponses tapées écrits dans les journaux de production au-dessus du niveau DEBUG.
- Registre des pages publiques : les capsules de la page Encore + et les passages du blog qui vouvoyaient encore (français, allemand, espagnol, italien, chinois), deux titres de la page Technique et l'accroche du changelog de la landing tutoient comme le reste ; les « vous » pluriels adressés à deux personnes et les « Sie » qui désignent LIA restent. « Si te l'active » devient « Si tu l'actives » (capsule du coût et nouveautés v1.16.7).

### Tests

- Backend : `tests/unit/domains/agents/nodes/test_react_history_prefix_stability.py` (vrai nœud, vrai réducteur, tête rognée à chaque résultat d'outil ; rouge avant le correctif), `utils/test_block_windowing.py` (réécrit, propriété sur 400 fils aléatoires, résumé de compaction placé où la compaction le laisse, champs du journal), `nodes/test_react_exchange_rhythm_wiring.py`, `nodes/test_react_history_blocks_wiring.py`, `nodes/test_react_cross_turn_cache_wiring.py`, `nodes/test_router_state_isolation.py` (le routeur publie le rythme), `services/test_react_tool_selector_every_tool.py`, `core/test_exchange_rhythm.py`, `domains/users/test_exchange_rhythm_preference.py`, `test_turn_logs_carry_counts_guard.py` ; six mutations du fenêtrage appliquées à la main et toutes détectées ; relecture à froid indépendante (« prêt avec corrections », aucun point critique, points importants traités).
- Frontend : `components/settings/__tests__/UsagePreferencesSettings.test.tsx` (groupe radio natif, descriptions accessibles, enregistrement, erreur, désactivation pendant l'enregistrement) et les gardes des réglages (63 sections) ; la garde de la page Encore + (78 capsules, celle du rythme dans « Au quotidien » avec ses trois libellés de scène) et le câblage du changelog (v1.47.3 en tête).
- Preuve d'exécution sur Docker dev (compte jetable, supprimé ensuite) : migration `402dd18bbf2a` appliquée ; le profil publie le rythme EFFECTIF (`frequent`, défaut de l'instance) pendant que la colonne reste NULL ; « Échanges ponctuels » choisi dans la page de réglages → `PATCH /users/{id}` 200, valeur conservée après rechargement, puis retour aux échanges fréquents stocké en base ; la capsule animée de la page Encore + rendue en mouvement normal et réduit.
- Production, lecture seule : le compteur `current_turn_id` existe dans les checkpoints et avance d'un par exécution.
- Portes hors `ci:fast` : 286 parcours Playwright + axe passés sur un build de production (dont « /more sans débordement horizontal à 375 px, animations actives »), rejeu de la chaîne de migrations depuis une base vide avec équivalence structurelle et `alembic check` sans écart, porte d'installation hermétique verte (assistant, artefacts de release, 24 scénarios Compose, contrats backend dont « un environnement valide démarre `Settings` »), suite `tests/agents/` verte.

## [1.47.2] - 2026-09-24

**Ce que LIA entreprend finit obtenu ou dit ; chaque appel payé l'est au prix que le fournisseur facture ; aucune transaction n'attend plus un fournisseur.**

**Un tour ReAct est jugé sur son résultat** ([ADR-310](docs/architecture/ADR-310-ReAct-Turn-Judged-On-Its-Result.md), amendant ADR-248, ADR-303, ADR-298, ADR-284 et ADR-184). La boucle s'arrêtait dès que le modèle n'appelait plus d'outil : mesuré le 2026-09-23, une prévision revenue pour le mauvais jour (l'outil lisait « demain » comme aujourd'hui, sans rien dire) a donné « je n'ai pas pu l'obtenir » après 4 itérations sur les 70 que son budget permettait. Tout fait que la boucle a entrepris d'obtenir — la demande de la personne et chaque vérification croisée qu'elle a lancée — finit désormais obtenu, ou déclaré dans un bloc `<unresolved>` avec les échelons tentés, jamais lâché en silence ; un écart déclaré achète une passe de reprise bornée (`REACT_RECOVERY_PASSES_MAX`, 1 par défaut, `0` = coupé) par un nœud qui n'appelle aucun modèle (`nodes/react_recovery.py`), dont la consigne est montrée à chaque appel suivant sans jamais entrer dans `messages`. Un résultat qui répond à une AUTRE question est un obstacle comme une erreur, l'échelle est l'appel corrigé, puis une autre source nommée `(fallback)`, puis la déclaration ; les dates relatives deviennent ISO 8601 avant tout paramètre (ReAct, planificateur, initiative), et un outil ne remplace jamais une valeur qu'il ne sait pas lire : la météo la refuse (`INVALID_INPUT`, le format attendu, la date du jour) sous un contrat publié par UNE constante que lisent le manifeste ET le schéma `@tool`. Mesuré au banc (`task react:recovery:measure`, trois familles de modèles, 1,26 USD, aucun appel Anthropic) : faits obtenus **58/63 contre 50/63**, l'incident rejoué au bon jour **7/9 contre 3/9**, aucune passe ni aucun appel de plus sur un tour témoin propre ; `react_recovery_turns_total{outcome}` au tableau 20, ligne « Recovery » au panneau de debug.

**Un échec d'outil est DIT, jamais deviné** ([ADR-303](docs/architecture/ADR-303-Tool-Failure-Restitution.md), amendant ADR-184, ADR-182, ADR-185, ADR-248, ADR-254, ADR-263 et ADR-286). Mesuré en production : sur les tours où un outil avait échoué, 7 réponses sur 21 portaient un diagnostic de configuration inventé, contre 0 sur 142 tours propres — un briefing annonçait un matin sur deux que trois connecteurs `ACTIVE` n'étaient « pas configurés ». Quatre ruptures producteur/lecteur sont refermées : `AgentResultStatus` est binaire (`SUCCESS`/`ERROR`) et un plan partiel est un `SUCCESS` qui porte `AgentResult.failed_steps` ; la directive d'honnêteté lit la forme que l'exécuteur écrit (constantes partagées), nomme l'outil, publie le total exact et n'est plus conditionnée à `DIAGNOSTICS_ENABLED` ; en ReAct le verdict est STRUCTUREL (`ToolMessage.status="error"`, mesuré comme survivant au checkpoint) ; un prédicat de succès unique (`core/tool_outcome.explicit_success`) sert le registre, les métriques et la boucle — `track_tool_metrics` compte enfin `success="false"` sur un échec retourné (le taux valait 1,0 par construction et ses deux alertes ne pouvaient pas se déclencher : attendre une baisse du taux affiché, qui dit désormais la vérité), et un échec déclaré comme un résultat vide n'achètent plus d'itération. Une garde shrink-only interdit de classer une erreur par les mots de son message ; elle a trouvé une branche morte (« Max concurrent » contre « Maximum concurrent ») qui rapportait un pool de navigateur saturé comme une erreur de configuration.

**Aucune transaction ouverte pendant un appel réseau** ([ADR-304](docs/architecture/ADR-304-No-Transaction-Across-A-Network-Call.md), amendant ADR-261, ADR-301, ADR-263, ADR-119 et ADR-283). Quatre défauts vus en production le 2026-09-22 : le balayage des réveils poussés bloqué 14 minutes par une session `idle in transaction` de 863 s, des sessions de 11 à 330 s dans le briefing, le heartbeat, les moments, le contexte téléphonique et la vue relations, le webhook Telegram posé par N workers à la fois, une fermeture normale de session Live journalisée en ERROR. Un client connecteur n'est plus jamais construit sur `ConnectorService(db)` (garde exacte, sans liste d'exceptions) : une porte unique ouvre le client actif d'une catégorie dans une session courte et le ferme sur tous les chemins (`connectors/active_client.py`) ; un job qui garde sa session committe ses lectures avant chaque attente ; chaque opération de connecteur du tour de chat termine sa transaction ; le tampon `last_used_at` d'une clé API est une fusion JSONB atomique à part, sous `lock_timeout` ; le flux Drive poussé avance par comparer-et-échanger, par pages de 1 000, borné en pages et en temps, rebasé après des coupes répétées ; les réveils sont servis un par un sous un plafond (`PushWakeSweepStalled` surveille ceux mis en file et jamais servis) ; les rappels sont réclamés un par un (CC 27 → moins de 8) ; seul le leader pose le webhook Telegram ; les WebSockets tournent sur l'implémentation sans E/S d'uvicorn ; le tas V8 du conteneur web est borné sous sa limite (512M).

**La génération d'images devient multi-fournisseurs : un modèle déclare son offre, un client par fournisseur la sert** ([ADR-305](docs/architecture/ADR-305-Image-Model-Declares-Its-Offer.md), amendant ADR-184, ADR-272, ADR-279 et ADR-063). Une FAMILLE (`image_generation/families.py`) déclare les qualités, les tailles (liste fixe ou enveloppe d'aire), les paliers de facturation et la facturation de l'image de référence d'une retouche ; un modèle qu'aucune famille ne déclare n'est ni tarifé, ni proposé, ni choisi, ni exécuté. Qwen Image 3.0 rejoint OpenAI GPT Image (génération ET retouche, résultat téléchargé aussitôt sous liste d'hôtes, borné, signature PNG vérifiée). **Le modèle qui tourne est celui qui est tarifé** : la retouche OpenAI passe par `images.edit` sur le modèle configuré (le détour Responses exécutait le modèle par défaut du SDK et un modèle texte non compté). Une préférence est une INTENTION, résolue à l'exécution vers l'offre du modèle (qualité non offerte → la moins chère offerte, taille → même orientation et aire la plus proche) et publiée `effective_*` ; le format choisi (PNG, JPEG, WebP) est appliqué une fois pour tous les fournisseurs ; l'image de référence facturée est comptée ; une image facturée mais non livrée est comptée ; un échec du fournisseur est classé par son statut HTTP, jamais par sa formulation.

**Claude déclaré une fois ; le cache de prompt façonné et facturé comme le fournisseur le mesure ; une seule mise en page pour tout mécanisme de cache ; le cache ReAct inter-tours sous drapeau** ([ADR-306](docs/architecture/ADR-306-Claude-Request-Surface-And-Billed-Prompt-Cache.md), [ADR-309](docs/architecture/ADR-309-One-Prompt-Layout-For-Every-Cache-Mechanism.md), [ADR-308](docs/architecture/ADR-308-ReAct-Cross-Turn-Prompt-Cache.md)). Huit modèles Claude rejoignent le catalogue, et ce que chaque génération accepte — mesuré sur l'API — vit dans UNE table (`core/claude_surface.py` : échantillonnage refusé, `tool_choice` forcé refusé, six formes de réflexion, profondeur implicite, blocs de réflexion liés à leur conversation) que lisent les règles de raisonnement, l'adaptateur, la sortie structurée et l'administration. Le point d'arrêt du cache est posé sur le préfixe statique quelle que soit la forme du système (Anthropic, puis GPT-5.6/GPT-6 — sans lui chaque appel réécrivait tout son prompt), une écriture de cache est facturée à son prix sur chaque chemin (×1,25 chez Anthropic et OpenAI, garde AST sans liste d'exceptions), et une double facturation des lectures de cache sur quatre surfaces est close. ADR-309 applique une règle à tous les appels d'un tour — le stable avant le volatil, aucune écriture que personne ne relit : un appel unique envoie sa partie fixe en message système (analyseur, initiative, extractions de mémoire, d'intérêts et du journal, garde AST), la réponse envoie la conversation UNE fois et entière, Qwen 3.5/3.6 reçoivent des marqueurs explicites. ADR-308 ajoute `REACT_CROSS_TURN_CACHE_ENABLED` (désactivé par défaut) : tous les outils liés et le contexte du tour APRÈS la question, pour relire le préfixe d'un tour à l'autre (mesuré sur 396 tours réels : −18 % à −42 % par tour selon le mécanisme de cache, +18 % sur un modèle sans cache ; forme déclarée par fournisseur et vérifiée au démarrage ; tout repli compté).

**Des tarifs relus sur la page du fournisseur, et un cache de prix que chaque worker partage.** L'audit du 2026-09-23 a corrigé onze tarifs de jetons, neuf prix d'image et Street View Static (migration `d5f8b2a6c9e3`, qui ne remplace qu'une valeur livrée par LIA, jamais celle d'un administrateur) ; un appel Maps est rangé au SKU que sa REQUÊTE déclenche (Routes : l'itinéraire voiture par défaut est Enterprise ; une matrice est facturée par élément). **Une fenêtre tarifaire porte ses jours** (amendement d'ADR-223 et d'ADR-228, classeur v4, migration `e4a7c2f9b1d6`) : DeepSeek facture ses week-ends au tarif creux toute la journée, et chaque appel du samedi ou du dimanche dans les heures de pointe était valorisé au double. Nouveaux modèles au catalogue avec leurs tarifs (Qwen 3.6/3.7/3.8, Gemini 3.8 Flash, GPT-6, migration `f6c2a8e4b0d7` ; GPT-6 a gagné sa famille de raisonnement et l'éligibilité à l'API Responses). **Le cache des prix se reconstruit depuis la base au démarrage, et chaque écrivain publie l'invalidation après son commit** (amendement d'ADR-063) : un tarif modifié n'atteignait qu'un worker sur quatre, et un taux USD→EUR synchronisé n'atteignait aucun coût avant un redémarrage.

**Les connecteurs sans clé appartiennent à l'instance** ([ADR-307](docs/architecture/ADR-307-Keyless-Connectors-Belong-To-The-Instance.md)). Wikipédia, la navigation de pages, Google Places, Google Weather et Google Environment n'ont plus de ligne par compte ni d'entrée dans « Mes connecteurs » : un seul prédicat (`connectors/keyless.py` — interrupteur global de l'administrateur, clé de plateforme, `BROWSER_ENABLED`) dit s'ils servent tout le monde, et la migration `b2e6d0f4a8c1` rend ces services à chaque compte qui en avait coupé un, n'en avait jamais reçu ou en gardait un révoqué. Dans la catégorie météo, le fournisseur de la personne gagne et Google Weather est le défaut de l'instance.

**Sécurité : une identité fédérée ne donne aucun droit** (amendement d'[ADR-002](docs/architecture/ADR-002-BFF-Pattern-Authentication.md), incident du 2026-09-22). Rattacher un compte Google ne change plus jamais le statut d'un compte : une inscription en attente d'approbation ne s'active plus par une connexion Google sur la même adresse, et un compte bloqué ne se débloque plus ainsi ; l'adresse n'est crue que si Google s'en porte garant, la liaison d'une adresse jamais prouvée révoque le mot de passe et les sessions du déclarant puis notifie les administrateurs comme une vérification d'e-mail, un compte supprimé n'est jamais ranimé, et une personne dont le compte est inactif peut se déconnecter. **L'adresse de l'appelant n'a plus qu'un lecteur** (amendement d'[ADR-213](docs/architecture/ADR-213-L-Identite-De-L-Appelant-Vient-D-Un-En-Tete-Qu-Il-Ne-Peut-Pas-Ecrire.md)) : vingt et un sites (dix-neuf audits admin, l'adresse d'une session, le compartiment de limitation des événements produit) passent par `resolve_client_ip`, garde AST à l'appui, et les Server Actions transmettent `CF-Connecting-IP`. **Le logging est configuré avant l'application** (amendement d'ADR-027) : des lignes DEBUG d'outils portant leurs paramètres atteignaient les journaux de production à `LOG_LEVEL=INFO`.

**Les actes d'un tour sont rangés sous le tour, et dits comme les siens** (amendement d'[ADR-263](docs/architecture/ADR-263-Execution-Authority-Chain-And-Effect-Register.md) §23). Onze lecteurs lisaient le run id dans `configurable`, une clé qu'aucun écrivain n'écrit depuis ADR-231 : chaque effet direct était rangé sous le FIL, la carte « actions effectuées » n'apparaissait jamais, et la clé d'étape du pipeline se télescopait d'un tour à l'autre — en production le 2026-09-22, un rappel s'est vu servir le résultat d'un tour précédent au lieu d'être créé. Un lecteur unique (`core/run_config.run_id_of`) et une garde AST le tiennent ; les actes réussis d'un tour ReAct atteignent le modèle de réponse par une directive à part, comme ses propres actes (mesuré sur la vraie chaîne : 0/100 déni d'une image générée, contre 6/6 avant).

**Aussi.** La recherche d'agenda lit la fenêtre elle-même et trouve un mot du titre, du lieu, de l'organisateur ou des participants de la même façon chez Google, Microsoft et Apple, sans consulter les contacts ni cacher un mot ignoré (amendement d'ADR-101) ; le magasin de contexte garde autant d'éléments qu'une requête en rapporte (« le 4e » désigne enfin le 4e), et le bloc d'entités récentes a son propre budget (amendement d'ADR-147) ; un libellé d'effet se coupe au mot ; en mode Live, un agent ElevenLabs passe par WebRTC sur iPhone et iPad (le SDK du fournisseur ; le transport audio devient une propriété de la session, amendement d'ADR-300), le lecteur audio garde une marge sur iOS, la fin d'une session remonte des compteurs de lecture agrégés (aucun contenu), et une clé Gemini restreinte par adresse IP est expliquée au lieu d'échouer en silence.

### Added

- **ADR-310** : `agents/nodes/react_recovery.py`, prompt `react_recovery_directive.txt`, `agents/tools/weather_dates.py` (`FORECAST_DATE_DESCRIPTION`), réglage `REACT_RECOVERY_PASSES_MAX`, clé d'état `react_recovery_passes` (remise à zéro par `react_turn_reset()`), métrique `react_recovery_turns_total{outcome}` (tableau 20), ligne « Recovery » du panneau de debug, banc `apps/api/scripts/react/measure_recovery.py` (`task react:recovery:measure`), spec et plan sous `docs/superpowers/`.
- **ADR-303** : `core/tool_outcome.py` (`explicit_success`), constantes de champ partagées (`FIELD_SUCCESS`, `FIELD_ERROR`, `FIELD_ERROR_CODE`), `AgentResult.failed_steps`, gardes `test_agent_status_vocabulary_guard.py` et `test_no_message_substring_classification_guard.py` (baseline shrink-only).
- **ADR-304** : `connectors/active_client.py`, `connectors/session_scope.py` (`DetachedConnectorService`), `connectors/api_key_use.py`, `rag_spaces/drive_push.py`, `rag_spaces/drive_changes.py`, `infrastructure/startup/scheduler_telephony.py`, tâche `SCHEDULER_JOB_TELEGRAM_WEBHOOK`, réglages `RAG_DRIVE_CHANGES_PAGE_SIZE`, `RAG_DRIVE_PUSH_MAX_PAGES`, `RAG_DRIVE_PUSH_DRAIN_DEADLINE_SECONDS`, `RAG_DRIVE_PUSH_MAX_CONSECUTIVE_TRUNCATIONS`, `REMINDER_PROCESSING_STALE_TIMEOUT_MINUTES`, `PUSH_WAKE_SERVE_TIMEOUT_SECONDS`, constante `CONNECTOR_USE_STAMP_LOCK_TIMEOUT_MS` ; métriques `push_wakes_enqueued_total`, `rag_drive_push_drains_total` ; alerte noyau `PushWakeSweepStalled` (seuils, `promtool`, recette de preuves, runbook `docs/runbooks/alerts/PushWakeSweepStalled.md`) ; gardes `test_connector_client_on_session_guard.py`, `test_no_borrowed_session_entered_guard.py`.
- **ADR-305** : `image_generation/families.py`, `preferences.py`, `sizing.py`, `encoding.py`, `providers/{base,openai_images,openai_sdk,qwen_images,result_download}.py`, `infrastructure/utils/bounded_read.py` ; colonne `image_generation_pricing.cost_per_input_image_usd`, `ImageGenerationRecord.input_image_count` ; migration `a9d3f1c7e5b2` (+ seed, deux lignes de catalogue et douze tarifs Qwen) ; réglages `IMAGE_GENERATION_RESULT_DOWNLOAD_TIMEOUT_SECONDS`, `IMAGE_GENERATION_RESULT_MAX_MB`, `IMAGE_GENERATION_ENCODING_QUALITY` ; qualité « Standard » et coût de l'image de référence dans les réglages et l'administration.
- **ADR-306** : `core/claude_surface.py`, `infrastructure/llm/providers/{anthropic_kwargs,anthropic_payload,openai_payload}.py`, `UsageTokens.cache_write`, `CachedModelPrice.cache_write_multiplier`, `ReasoningProfile.implicit_level`, avertissement d'administration `thinkingBudgetImplicitBelowFloor` ; migration `c3e7a1f5d9b2` (huit modèles Claude, `verified`) ; gardes `test_claude_models_migration_guard.py`, `test_cache_write_reaches_every_price`.
- **ADR-307** : `connectors/keyless.py` (prédicat de l'instance, `_instance_default` du résolveur météo) ; migration `b2e6d0f4a8c1`.
- **ADR-308 / ADR-309** : `agents/nodes/react_turn_layout.py` (`CONTEXT_PLACEMENT`, vérifié au démarrage), `core/prompt_layout.py` (`split_at_marker`, `single_call_messages`), `infrastructure/llm/providers/qwen_chat.py` (`ChatQwenCached`), prompt `response_prompt_lines.txt` ; réglages `REACT_CROSS_TURN_CACHE_ENABLED`, `REACT_CROSS_TURN_CACHE_MAX_WINDOW_FRACTION`, `REACT_CROSS_TURN_HISTORY_BLOCK_FRACTION` ; métrique `react_cross_turn_cache_fallback_total{reason}` (tableau 20) ; garde `test_single_call_sites_guard.py`.
- **Tarifs et catalogue** : migrations `e4a7c2f9b1d6` (jours des fenêtres DeepSeek), `f6c2a8e4b0d7` (huit modèles de chat), `d5f8b2a6c9e3` (corrections des prix publiés), toutes miroirs du seed et gardées égales ; `routes_sku_suffix` et facturation par élément de la matrice Routes ; composant partagé `components/recurrence/WeekdayToggleGroup` et jours de chaque fenêtre dans le dialogue des tarifs LLM ; colonne `weekdays` du classeur tarifaire (format v4).
- **Sécurité et observabilité** : `auth/google_identity.py` (`GoogleSignInRefusedError`, `google_email_is_verified`), `infrastructure/observability/logging_bootstrap.py`, gardes `test_client_ip_single_resolver_guard.py`, `test_logging_configured_first_guard.py`, `test_run_id_single_reader_guard.py`.
- **Registre des effets** : `core/run_config.py` (`run_id_of`), `agents/services/performed_actions_directive.py`, prompt `response_directive_performed_actions.txt`, `core/text_clip.py` (`clip_on_word`).
- **Agenda et contexte** : `agents/calendar/event_search.py` (`filter_events`, `QUERY_CONTRACT`, `describe_search`), réglage `RESPONSE_RECENT_ENTITIES_MAX_ITEMS`.
- **Live** : `lib/live/transports/elevenlabs-webrtc.ts` (dépendance `@elevenlabs/client`), `audio_transport` sur le démarrage et la clé de session, `LiveAudioDiagnostics` à la clôture, hôte CSP `wss://livekit.rtc.elevenlabs.io`, message `key_ip_restricted`.

### Changed

- ReAct : `routing.py` lit `should_recover` dans sa branche « aucun appel d'outil » ; `react_nodes.py` compose le tour (`compose_turn_messages`), marque un échec d'outil `status="error"` et rapporte la reprise ; `react_tool_selector.py` lie tous les outils sous le drapeau (sinon la pertinence, extraite) ; `REACT_AGENT_MAX_TOOLS` borné à 400 ; prompts ReAct, planificateur et initiative : doctrine VERIFY, échelle de reprise, dates absolues.
- Réponse : la conversation part une fois, en messages entiers (le texte `<History>` a disparu), les sections gardent leur ordre, les actes réussis passent par leur directive ; `runtime_failures_directive` lit la forme de l'exécuteur ; `agent_results.py` restitue les échecs en une ligne localisée dans les six langues.
- Connecteurs, briefing, heartbeat, moments, téléphonie, relations, pairs, réunions, intérêts, journaux, Drive, rappels, notifications FCM, Telegram : sessions courtes et commits avant chaque attente (ADR-304) ; `ConcurrencySafeConnectorService` termine chaque opération ; la liste « Mes connecteurs », l'accueil guidé et les réglages ne proposent plus les services sans clé.
- LLM : `factory.py`, `providers/adapter.py`, `responses_adapter.py`, `reasoning/translate.py`, `structured_output.py`, `usage_metadata.py`, `token_capture.py`, `inference_params.py` lisent la surface Claude et le lecteur d'usage unique ; `core/reasoning_profiles.py` gagne les familles Claude et GPT-6.
- Tarification : `pricing_cache.py` (reconstruction depuis la base au démarrage, `refresh_and_publish_pricing_cache`, `load_published_pricing_cache`), `currency_sync.py`, `pricing_time_slots.py` (cercle de la semaine), `pricing_sheet*.py`, `tabular_io/writer.py`, `google_routes_client.py`, `google_api_tracker.py` (`units`).
- Images : `client.py`, `options_cache.py` (modèles servables seulement), `options_router.py` (`effective_*`), `pricing_service.py` (taux du cache de prix), `tracker.py`, `resize.py`, `llm_config` (liste du poste image = domaine image seul, `image_model_not_served`, `image_model_provider_mismatch`).
- Déploiement : `--ws websockets-sansio` sur les trois lancements de l'API ; conteneur web à 512M avec `NODE_OPTIONS=--max-old-space-size=320`, démonstrateur aligné ; `ContainerMemoryNearLimit` ne présente plus le working set comme la grandeur de l'OOM.
- Ratchets abaissés : complexité cyclomatique backend (320 → 311 fonctions à CC ≥ 15) et frontend, cycles de couplage (24 → 23, `image_generation<->llm_config` disparu), baselines de taille (`weather_tools.py` 922 → 820 lignes) ; plancher de couverture backend relevé à 74 % ; `task release:sync-counts` (309 ADR, 587 métriques).

### Fixed

- Une inscription en attente activée, ou un compte bloqué débloqué, par une connexion Google sur la même adresse ; `/auth/logout` refusé à un compte inactif ; audits admin, sessions et limitation des événements produit enregistrant l'adresse du proxy ou une adresse choisie par le visiteur ; lignes DEBUG d'outils (paramètres compris) dans les journaux de production.
- Diagnostics de configuration inventés sur un échec d'outil ; « Statut inconnu (failed) » sans le texte de l'erreur ; échecs ReAct jamais restitués ; taux de succès des outils à 1,0 par construction ; compétence désactivée sur un plan partiel ; un plan qui créait un rappel atteignant la réponse vide ; pool de navigateur saturé rapporté comme une erreur de configuration.
- Rappel servi depuis le registre d'un tour précédent au lieu d'être créé ; effets directs rangés sous le fil ; carte « actions effectuées » jamais affichée ; image générée niée par la réponse ReAct ; libellé d'effet coupé au milieu d'un mot.
- Prévision météo servie pour aujourd'hui quand on demandait « demain » dans une autre langue que l'anglais ; boucle ReAct abandonnant un fait qu'elle avait entrepris d'obtenir.
- Balayage des réveils poussés bloqué ; flux Drive relu deux fois ; sessions `idle in transaction` pendant les appels aux fournisseurs ; verrou de ligne tenu tout un tour par la lecture d'une clé API ; clé concurrente écrasée dans le JSONB des credentials ; client fermant la session de son appelant ; rappels verrouillés par lot pendant les générations ; conflit `setWebhook` Telegram à chaque déploiement ; webhook supprimé par un worker qui s'arrête ; `ConnectionClosedError` en ERROR à la fermeture normale d'une session Live ; conteneur web à 95 % de sa limite.
- Retouche OpenAI exécutant le modèle par défaut du SDK et un modèle texte non compté ; modèles d'image proposés sans client pour les servir ; image de référence gratuite ; second taux de change pour les images.
- Fenêtre de contexte de 200K prêtée à Opus 4.7/4.8 et aux modèles 4.6 (1M) ; point d'arrêt du cache posé sur les données du tour ; écriture de cache facturée au prix d'entrée ; lectures de cache facturées deux fois (heartbeat, boucles ouvertes, comptes rendus, débrief) ; message pair tarifé à zéro ; GPT-5.6/GPT-6 réécrivant tout leur prompt à chaque appel ; une clé de cache OpenAI par tour.
- Week-ends DeepSeek facturés au double ; onze tarifs de jetons, neuf prix d'image et Street View Static différents des pages des fournisseurs ; itinéraire voiture rangé au SKU Essentials ; matrice Routes facturée à la requête ; tarif ou taux modifié n'atteignant qu'un worker sur quatre, ou aucun ; rechargement du cache des prix laissant un worker à coût nul après un échec.
- Connecteurs sans clé coupés à jamais, jamais reçus avant le 2026-09-12 ou restés révoqués ; Google Weather et OpenWeatherMap actifs ensemble départagés par la date de mise à jour ; bandeau « Reconnecter » sur un 401/403 de la clé de plateforme ; sonde météo du heartbeat ne lisant qu'OpenWeatherMap.
- Recherche d'agenda cherchant un mot comme un contact (appel People inutile et avertissement faux) et rendant la fenêtre entière comme résultat ; « le 4e » désignant le 9e événement après une troncature renumérotée ; lecture d'agenda des réunions jamais enregistrée au registre des consultations.

### Tests

- Backend : `tests/unit/domains/agents/nodes/test_react_recovery{,_loop,_wiring}.py`, `test_react_failure_is_declared.py`, `test_react_turn_layout.py`, `test_react_cross_turn_cache_wiring.py`, `test_react_history_blocks_wiring.py`, `prompts/test_react_recovery_doctrine.py`, `prompts/test_absolute_dates_directive.py`, `formatters/test_tool_failure_restitution_prod_replay.py`, `services/test_performed_actions_directive.py`, `services/test_react_tool_selector_every_tool.py`, `tools/test_http_status_taxonomy.py`, `tools/test_browser_limit_markers.py`, `tools/test_calendar_event_search_tool.py`, `tools/test_image_generation_tools_flow.py`, `tools/test_tool_logger_follows_configuration.py`, `calendar/test_event_search.py`, `context/test_context_list_cap.py`, `utils/test_block_windowing.py`, `domains/image_generation/` (familles, préférences, tailles, encodage, trois clients), `domains/connectors/test_{active_client,keyless}.py`, `domains/rag_spaces/test_drive_{changes,push}.py`, `domains/push_channels/test_channel_ensure_session.py`, `infrastructure/llm/providers/test_{anthropic_payload,anthropic_adapter_surface,openai_payload,qwen_chat}.py`, `infrastructure/llm/reasoning/test_claude_translation.py`, `infrastructure/llm/test_structured_output_claude.py`, `infrastructure/scheduler/test_currency_sync.py`, `infrastructure/test_pricing_cache_startup.py`, `core/test_{tool_outcome,prompt_layout,run_config,text_clip,claude_surface,claude_reasoning_profiles,single_call_sites_guard}.py` et les gardes de migration (`test_{deepseek_peak_weekdays,new_chat_models,multi_provider_image,claude_models,published_price_corrections}_*guard.py`).
- Intégration (PostgreSQL et Redis réels) : `test_{deepseek_peak_weekdays,new_chat_models,multi_provider_image,claude_models,published_price_corrections,keyless_connectors}_migration.py`, `test_image_pricing_admin_routes.py`, `domains/connectors/test_{api_key_use_stamp,client_session_ownership,turn_connector_operations_pg}.py`, `domains/reminders/test_reminder_claims_pg.py`, `domains/push_channels/test_page_token_advance.py`, `domains/agents/effects/test_step_key_per_turn_db.py`, `test_auth_service_refactored.py` (`TestGoogleLinkNeverChangesStanding`, `TestGoogleEmailClaim`), `test_auth.py` (déconnexion d'un compte inactif), `test_llm_admin_routes.py` (publication de l'invalidation).
- Frontend : `components/recurrence/__tests__/WeekdayToggleGroup.test.tsx`, `lib/live/__tests__/elevenlabs-webrtc.test.ts`, lecteur PCM, micro et contrôleur Live, réglages et administration des images, tarifs LLM, connecteurs ; Playwright `e2e/smoke/admin-pricing-time-slot-days.spec.ts` (390 px).
- Preuves Docker dev : reprise ReAct sur la question de l'incident et météo « demain » au bon jour ; génération et retouche Qwen et OpenAI sur les vrais fournisseurs ; cache Claude et GPT-5.6 relu au centime ; migrations montées, descendues et remontées ; un même appel DeepSeek à 02:00 UTC 2,00 fois plus cher le mardi que le samedi ; `pg_stat_activity` avant et après.

## [1.47.1] - 2026-09-22

**Un compte, un consentement ; un compagnon qui suit ce que LIA fait réellement.**

### Added

- Google et Microsoft peuvent désormais relier ou reconnecter plusieurs services en un seul parcours de consentement, sur un compte fournisseur dont l'identité est vérifiée. Les autorisations sont conservées par compte et par application OAuth ; déconnecter un service ne coupe pas les autres. Le parcours individuel reste disponible, et les connexions existantes ne sont pas migrées sans choix explicite ([ADR-302](docs/architecture/ADR-302-OAuth-Grant-Par-Compte-Et-Consentement-Groupe.md)).
- Le compagnon expressif relie les activités effectivement exécutées, la tonalité de la réponse, l'heure locale et des données météo déjà mises en cache à son animation. Il conserve des poses statiques lorsque la réduction des mouvements est demandée, sans nouvel appel de modèle ou de fournisseur ([ADR-294](docs/architecture/ADR-294-A-Face-That-Never-Plays-The-Same-Twice.md)).

### Changed

- La sélection des outils et des skills traite plus précisément leurs déclarations et leurs représentations sémantiques ; les résultats de skills rejoignent le contexte de réponse sans être confondus avec une action accomplie. Les états vocaux et visuels restent alignés sur le déroulement réel du tour.
- La page d'accueil peut fournir au compagnon un contexte léger provenant du briefing existant ; ce contexte est éphémère et ne déclenche ni nouvelle consultation météo ni appel LLM.

### Fixed

- Les autorisations OAuth groupées ont une reprise, un renouvellement et une déconnexion cohérents entre services ; l'état du parcours est à usage unique, PKCE S256 est conservé et le jeton d'identité est vérifié avant d'associer un compte.
- Les chemins d'outils MCP, Live et ReAct ne doivent plus présenter une réponse structurée ou un appel d'outil abandonné comme une action exécutée ; les réponses et historiques restent interprétables après les sorties anticipées.
- Plusieurs défauts de synchronisation et d'affichage du compagnon ont été corrigés, notamment le respect des préférences de mouvement et le nettoyage du contexte éphémère.
- Le démonstrateur public conserve uniquement son cache non personnel de sélection d'outils entre redémarrages ; son premier amorçage dispose du temps nécessaire, et les métadonnées de ses pages utilisent son adresse publique réelle.

### Tests and operations

- Nouvelle migration `oauth_grants` additive : les credentials existants restent valides et non liés jusqu'à une autorisation groupée réussie. Tests unitaires, intégration et parcours navigateur ajoutés pour l'identité, le renouvellement, la reconnexion et le compagnon.
- Les nouvelles métriques d'outils et les tableaux de bord d'observabilité sont raccordés ; les URI de callback groupé sont documentées pour les installations qui activent Google ou Microsoft.
- Les jobs GitHub Actions utilisent un runner Ubuntu 24.04 explicite afin de conserver un environnement de qualification stable pendant la transition de `ubuntu-latest`.

## [1.47.0] - 2026-09-20

**Le mode Live : parler avec LIA en temps réel, sur sa propre clé, deux intelligences et une seule couture** ([ADR-299](docs/architecture/ADR-299-Live-Voice-Mode-Two-Intelligences-One-Seam.md), amendant ADR-070, ADR-245, ADR-258, ADR-263, ADR-272, ADR-280 et ADR-290). Une session vocale duplex, parole à parole, s'ouvre depuis l'icône vocale de l'en-tête sur un connecteur d'une NOUVELLE catégorie, `live`, que la personne active avec sa propre clé (Gemini Live, GPT-Live, ElevenLabs Agents) — rien de ce que le fournisseur facture n'est compté, stocké ni montré par la plateforme. **Le modèle vocal tient la conversation et DÉLÈGUE chaque demande de donnée ou d'action au moteur du chat** par UNE fonction `NON_BLOCKING`, `send_to_lia`, que le navigateur transforme en un `POST /chat/stream` ordinaire avec le cookie de la personne : le tour délégué tourne dans le graphe (HITL, registres, quotas, archive, apprentissage), se dessine dans le fil estampillé `live_session_id` + `spoken_text`, et le pont rend à la voix une réponse aplatie et bornée — ou la question en attente de LIA, qui EST la réponse ; la voix ne tient jamais un outil, une clé ni une ligne à elle. **Quatre faits MESURÉS avant de figer le design** (`task live:probe`) sont chacun une règle du code : la contrainte d'une clé éphémère ne verrouille PAS l'instruction système (l'API rend le `setup`, le navigateur le rejoue tel quel) ; une clé à usage unique consommée ne peut PAS se reconnecter (chaque reconnexion en frappe une fraîche pour le MÊME record, sur la poignée de reprise) ; le fournisseur ACCEPTE en silence un nom de voix inconnu (la voix est validée contre la liste vendored, datée, sourcée — jamais par lui) ; un WebSocket brut n'est accepté que par la méthode `BidiGenerateContentConstrained` avec le jeton en `access_token`. Une session par compte (revendication à jeton d'owner `live:session`, USER_RUNTIME ; `live:active` GLOBAL plafonne l'instance ; une limite de frappe), le record survit au plafond de `LIVE_SESSION_RECORD_GRACE_SECONDS` pour qu'une session allée au bout ferme ses livres. Un échange purement vocal est archivé à `turnComplete` en deux lignes visibles `live_turn` (injectées au tour écrit suivant comme les lignes proactives, `out_of_graph.py`) ; la session se clôt sur UNE carte `live_session_summary` dont la dépense est la SOMME des lignes `message_token_summary` des runs délégués — celle de LIA, dans le vocabulaire du compteur du chat ; une session est UNE ligne de décision, chaque tour délégué son propre run. Le niveau de réflexion n'est offert que sur l'échelle ADR-245 du modèle et refusé hors d'elle à l'écriture. Web : `LiveSessionController` (une classe sans React) derrière le fin `useLiveSession`, `useLiveHoldsMicrophone` étend la règle du propriétaire unique d'ADR-258 à la boucle du mot d'activation, `effectiveVoiceState` nourrit les yeux sans nouvelle entrée, la CSP n'autorise qu'UN hôte exact par fournisseur WebSocket.

**Un second fournisseur — une couture, deux fils — puis un troisième, et le mode direct** ([ADR-300](docs/architecture/ADR-300-A-Second-Live-Provider-One-Seam-Two-Wires.md), amendant ADR-299, ADR-245, ADR-184, ADR-185, ADR-263, ADR-272, ADR-260). GPT-Live a rejoint Gemini Live sans qu'une ligne du pont, du bandeau, des registres ou de la carte ne bouge : **un fournisseur DÉCLARE son fil, la couture ne branche jamais sur son nom** — `connection` (`token` : le navigateur ouvre le socket avec la clé du fournisseur ; `offer` : l'API frappe son PROPRE nonce à usage unique, gardé sur le record et consommé par `POST /live/sessions/{id}/offer`, qui échange le SDP du navigateur sur la clé de la personne) et `delegation_wire` (`tool` : `send_to_lia` ; `native` : `session.delegation.created` porte un id et un `offset_ms`, AUCUN texte — la demande est COMPOSÉE dans le navigateur depuis la transcription, `lib/live/request-composer.ts`). Le transport dérive ce dont la couture a besoin des signaux du fournisseur (`transports/openai-webrtc.ts` : la transcription de l'assistante EST sa parole), une voix que le point de synthèse ne sert pas est échantillonnée par le modèle live lui-même (`providers/openai_live_socket.py`, aussi la sonde d'activation). **La catégorie `live` est ADDITIVE** : les deux clés actives, les sessions sur le choix du compte (`users.live_preferences.provider` ; enregistrer un connecteur en fait celui des sessions), les réglages listent l'UNION des modèles groupés par marque — choisir un modèle EST choisir son fournisseur. La vague apporte aussi : UNE icône vocale d'en-tête (une bascule, ou un menu « Commentaires / Session Live (<marque>) »), pas de commentaire TTS sur un tour délégué, un échantillon de voix à chaque changement, la demande la plus récente qui gagne (une correction est un SECOND `toolCall`, mesuré), un connecteur qui se souvient de CHAQUE modèle sur lequel il a été réglé (`live/model_settings.py`), le silence et le plafond propres au MODÈLE (`0` = sans limite sous un avertissement de facturation, bornes publiées), un plafond illimité qui ROULE par tranches renouvelées en silence (`unlimited_cap`, `kind=rolling`), l'état intérieur de LIA dans le mandat et le registre de chaque réponse (ADR-253) porté à la voix comme NOTE DE LIVRAISON (`live_tone_lines.txt`). **`enableAffectiveDialog` de Gemini est mesuré HORS JEU** (un `setupComplete` puis 1007 à la première chose que le modèle doit répondre, parole comprise ; un test négatif l'épingle). **Le lecteur PCM est UN AudioWorklet qui lit une file, jamais un `AudioBufferSourceNode` par morceau** : Chrome 152.0.7977.83 rend parfois le début d'un morceau planifié comme un bloc répété ~100 fois — le « biiiip » de chaque session ; l'audio brut du fournisseur est propre. Les deux voix sont EXCLUSIVES (un démarrage Live coupe les réponses parlées, la case est refusée pendant une session), et une fermeture décidée par le fournisseur atteint le journal de l'API ET le toast du bandeau avec son code et sa raison. **Vague 3 — le coût de la session est MONTRÉ, jamais enregistré** : les relevés d'usage du fournisseur (Gemini `usageMetadata` par tour et par modalité, tout le contexte re-facturé ; GPT-Live `session.usage.updated` en secondes) sont repliés dans le navigateur (`lib/live/meter.ts`) et tarifés par le tarif que le démarrage publie (`LiveRates`, depuis le cache tarifaire), dessinés sous le dernier sous-titre derrière une barre latérale, avec la taille du contexte ; un coût qui aurait besoin d'un tarif non déclaré est indisponible, jamais partiel. **Un modèle live n'est offert et démarré que si la table tarifaire le déclare** (`domains/live/pricing.py`, `model_unpriced` ; la liste NOMME les non déclarés) : la table gagne la paire audio (`audio_input_unit_price` / `audio_output_unit_price`, les deux ou aucun, `per_1m_tokens` seulement ; migration `f1a3c5e7b9d2` + seed + classeur v3, gardés égaux). Un plafond de dépense par session, optionnel, est celui du CONNECTEUR (`session_budget_eur`, issue `budget_reached`). **Vague 4 — la session DIRECTE est la ligne du téléphone dans le navigateur** (décision « faire simple ») : troisième entrée du menu vocal là où `LiveModelCapabilities.direct_tools` est vrai (jamais un id de fournisseur), le modèle vocal tient LUI-MÊME les outils de LECTURE de LIA (le jeu dérivé du téléphone, ADR-290 lot 8, moins les interrupteurs de la personne, `direct_mandate.py`) et ne délègue jamais ; le mode est une colonne du RECORD (`LiveSessionRecord.mode`, `POST /live/sessions {mode}`, `mode_unsupported` ailleurs) ; UNE porte d'outils `POST /live/sessions/{id}/tools` (`tool_door.py`) sur le `run_live_tool` du téléphone généralisé en `VoiceToolHost` (surface `live_session`, le run id de la session, nœud `live_session_tool`), un budget de consultations par session (`LIVE_DIRECT_TOOL_CALLS_MAX`), chaque refus une phrase que la voix dit, `live_tool_calls_total` au tableau 30. **La prémisse du propriétaire mesurée sur une vraie session** : 55 déclarations font 35 864 des 40 312 caractères du setup et le premier tour facture 10 983 jetons de prompt contre 1 227 en délégué — une session directe achète de la latence, jamais de l'économie. **ElevenLabs Agents est le troisième fournisseur**, sur le premier fil : l'AGENT de la personne tient la place d'un modèle (`label` = son nom), tout sauf le prompt et les outils de LIA reste sur le portail (`portal_voice` : ni voix, ni échantillon, la sentinelle `agent` tenue égale à travers la pile), la clé est une URL signée sur le sous-protocole `convai`, la délégation un outil CLIENT bloquant ; `AgentSyncing` (avant la frappe : la permission d'override FUSIONNÉE dans le bloc de l'agent, les outils client de LIA créés une fois par empreinte, `tool_ids` = ceux de la personne + le jeu de CETTE session, UN jeu par KIND) ; mesuré sur l'agent du propriétaire : `source_info.source` est validé contre les noms du SDK et tout autre mot ferme 1008 APRÈS les métadonnées, les `items` d'un tableau exigent une `description` (422), une création refusée ANNULE ses sœurs avant le rollback (`TaskGroup`, jamais `gather` — 99 outils orphelins mesurés). **ElevenLabs a DEUX grilles et la table tarifaire n'en connaît qu'UNE** (règle du propriétaire) : l'API SIMPLE (STT/TTS au caractère — `eleven_v3_conversational` est une ligne `tts` à 0,05 USD les 1 000 caractères, migration `a4c8e1f7b3d5` + seed, gardés égaux) et l'API AGENTS (téléphonie et Live, à la minute de conversation plus le LLM, sur la clé de la personne seule — tarifée par personne chez nous) : `LiveProvider.billing` (`tariff` | `vendor`), `rates` nul au démarrage, l'horloge seule au compteur, aucun plafond, et la facture du fournisseur (`VendorBilling` : `cost_fiat`, les charges LLM et appel, les modèles facturés, la durée) MONTRÉE une fois à la fin — le fournisseur règle ses livres APRÈS la poignée de fermeture (mesuré : `in-progress` et aucun coût pendant que la trame de fermeture atterrit, la facture 0,3 s après), donc le transport attend l'événement de fermeture et la fin relit `LIVE_VENDOR_BILL_SETTLE_ATTEMPTS` fois. **Le menu vocal de l'en-tête suit les réglages Live** (`stores/revisionStore.ts` : un écrivain bumpe `live_connectors`, la requête du lecteur en dépend — la bascule vit dans le layout et ne se remonte jamais entre réglages et chat).

**Sessions vocales : une politique par mode, quelle que soit la ligne** ([ADR-301](docs/architecture/ADR-301-Voice-Sessions-One-Policy-Per-Mode.md), amendant ADR-290, ADR-299, ADR-300, ADR-272, ADR-263, ADR-185, ADR-184). Le téléphone (ADR-290) relayait la conversation à sa FIN quand le Live du navigateur déléguait chaque demande PENDANT ; les deux lignes partagent désormais un MODE — `delegated` « Live » (chaque demande un tour de chat de la personne au moment où elle la dit, avec HITL, registres, quotas, archive) et `direct` « Live direct » (la voix lit, n'agit sur rien, et les mots sont relayés à la fin comme le propre tour de la personne) — et la politique ne suit que le mode. **UNE clôture** (`infrastructure/scheduler/voice_session_closing.close_voice_session`), appelée par `POST /live/sessions/{id}/end` ET le webhook post-appel du téléphone : délégué archive les échanges purement vocaux, dessine la carte aux chiffres EXACTS, dépose la décision et apprend ; direct synthétise et relaie dans une tâche que la clôture possède et RÉÉCRIT la carte au règlement avec son coût relu. **Ce que les deux partagent est sorti des deux** : `domains/voice_sessions/` (`VoiceSession` à clé neutre — celle du téléphone `phone_call_<hex>` frappée là, pour que `telephony` la lise et jamais l'inverse —, `VoiceTranscript` avec les échanges délégués marqués EN ENTIER, la projection épinglée à `lib/live/delegation.ts` par UN corpus joué par pytest et vitest, les requêtes de résumé, le bloc de délégation de chaque mandat) et les runners `infrastructure/scheduler/` (`voice_relay` — l'ex-`self_call_relay` déplacé octet pour octet sous un golden —, `voice_delegation`). **Le mode Live du téléphone est la délégation du navigateur, côté serveur** : un outil webhook ASYNCHRONE `send_to_lia` du fournisseur (le nom, la description et le schéma du navigateur, `telephony/delegation_tool.py`), ni contexte ni consultation pour la voix (symétrie stricte), et `voice_delegation.delegate` reflète le pont TS règle pour règle — une demande vide ne coûte rien ; **la demande la plus récente gagne** par un marqueur Redis sondé par le pont qui tourne (deux webhooks peuvent atterrir sur deux workers ; prouvé sur Redis réel) ; **une question que LIA a posée EST le résultat** et la demande suivante REPREND le run qui l'a posée (`original_run_id`) ; le tour est celui de la PERSONNE (`spoken_by_person`) ; une attente au-delà de la borne du fournisseur laisse le tour tourner et la voix le dit. **Mesuré sur le vrai moteur du fournisseur avant d'être cru** (sans téléphone : le fournisseur joué en HTTP contre l'API dev, puis une conversation texte sur le mandat de production par tunnel, `task telephony:simulate:live` / `task telephony:probe:live`) : `execution_mode: async` + `pre_tool_speech: force` laissent la voix annoncer et poursuivre ; passé `response_timeout_secs` la réponse tardive est PERDUE, le pont répond donc `timed_out` la marge intérieure avant ; la transcription écrit un appel asynchrone comme une entrée d'agent VIDE avec `tool_calls`. **Le choix est celui de la personne, le mode effectif est dérivé et publié** (`users.phone_call_mode`, Live par défaut ; `phone_calls.call_mode`, le mode qu'un appel A COURU) : Live n'est disponible que là où l'hôte de la base de rappel est PUBLIC (`telephony/callback.py`, `TELEPHONY_CALLBACK_BASE_URL` pour un tunnel de dev), `GET /telephony/identity` publie `live_available` / la raison / `call_mode_effective`, un outil de délégation refusé par le fournisseur dégrade l'appel en DIRECT et le dit ; un appel que personne ne décroche n'a PAS de mode (« personne n'a répondu » / « la ligne a échoué », décidé AVANT le mode — un appel Live se fermait sans rien livrer). **`POST …/end` n'appelle aucun modèle** : la synthèse ET le tour relayé tournent dans la tâche possédée, `end` répond `scheduled` ou `empty` aussitôt (mesuré 0,026 s), le settle écrit le sort QUOI QU'IL LÈVE, chaque `RelayOutcome` a sa phrase (gardé des deux côtés), les mots qui n'ont pu devenir un tour gardent leur récapitulatif sur la carte. **L'admission d'une consultation est UNE séquence** (`agents/telephony/voice_lookup.serve_voice_lookup`) : offerte sous la porte, puis le budget de l'hôte (un outil refusé ne dépense rien), puis le run sous `VoiceToolHost` — le rappel du téléphone et la porte de session du navigateur lui tendent leur jeu offert, leur budget et leur façon de dire un refus ; un HITL parlé sur un outil mutable (non construit) s'insérera entre le budget et le run, jamais dans une porte. Les interrupteurs de domaine (`phone_disabled_domains`) gouvernent toute surface vocale directe, navigateur compris. **Un runner vocal ne tient aucune session de base pendant le tour** (la règle du runner du workboard) : mesuré 8,9 s d'`idle in transaction` avant, aucune après.

**Chaque euro que la plateforme paie pour une personne est tracé, affiché, attribué et compté pour elle — quelle que soit la modalité ou le chemin** (règle du propriétaire, [amendement d'ADR-272](docs/architecture/ADR-272-Every-Platform-Paid-Token-Answers-To-Both-Ceilings.md)). Pas les jetons du modèle seuls : chaque famille INSTANCE de `cost_bearers` — et Google Maps Platform avait des trous dans toutes les directions. **Un prédicat de persistance couvre CHAQUE famille que le traceur tient** : les deux portes de `TrackingContext` décidaient sur les enregistrements du modèle seuls, si bien qu'une consultation Places ou Routes d'un appel téléphonique ou d'une session Live directe (aucun appel de modèle) n'écrivait rien dans aucun des quatre grands livres (reproduit : 0,029 € tenu en mémoire, 0 persisté) ; `pending_families()` est LE prédicat, et une garde refuse un seau `_*_records` qu'il ne lit pas. **Un compteur n'échoue jamais ouvert** : `track_google_api_call` « ne faisait rien » sans traceur ambiant — 3 020 lignes d'usage sur dev, aucune hors d'un tour de chat, pendant que le heartbeat (Routes), le briefing (Google Weather : 8 appels facturés par rafraîchissement), les réunions (Geocoding) et les proxys d'images payaient ; il compte désormais `google_api_calls_unaccounted_total` (alerte `GoogleApiCallsUnaccounted`, attendue à 0, runbook). **Une surface hors tour ouvre sa propre comptabilité autour de l'acte ENTIER** (runner, briefing, enrichissement de réunion, géocodage du profil) par UNE porte, `infrastructure/proactive/tracking.out_of_turn_spend`, et **la route est déclarée** dans `domains/google_api/spend_roads.py`, sœur de `LLM_SPEND_ROADS`, gardée sur le graphe d'imports avec les portes vérifiées en appels AST. **Une image facturée est comptée là où Google la facture** — au proxy, sur le 200, par UN helper — jamais pré-comptée à la construction de l'URL, et jointe à son tour par un run id SIGNÉ sur (run id, compte). **Un seul chiffre pour ce qu'un run a coûté** : `MessageTokenSummary.billed_cost_eur` — la facture téléphonique et la carte live lisaient la colonne du modèle seule et tarifaient les consultations Maps à rien. **Seul ce que le fournisseur a SERVI est facturé** : les caractères d'une phrase TTS sont comptés quand son audio revient, jamais à l'envoi (mesuré : quatre flux refusés à chaque phrase avaient chacun enregistré un coût).

**Quatre défauts silencieux lus dans les journaux, et une porte qui tenait une session.** Le cache d'embeddings d'outils avait été écrit à 384 dimensions contre des requêtes à 1 536 (163 avertissements par tour : toute similarité valait 0, la sélection sémantique des outils ET le classement ReAct d'ADR-293 aveugles, sans erreur) — le hash porte `modèle:dimension` et une dimension inattendue est refusée au chargement. Le validateur sémantique SAUTAIT chaque tour depuis ADR-263 (`plan_approved=None` lu comme approuvé) — il ne saute que sur l'approbation EXPLICITE. Le compteur de repli HITL était incrémenté sans son label, l'exception rendait chaque réponse AMBIGUOUS un EDIT. Le certificat de dev était régénéré sur son ÂGE (tout certificat de plus de 30 jours, émis pour 365) — un avertissement TLS après chaque redémarrage mensuel ; il ne se renouvelle que sur expiration, SAN ou clé. Et **une session de base ne vit pas plus longtemps que les requêtes qu'elle sert** : une route qui STREAME authentifiait par une dépendance `yield` qui vit aussi longtemps que la réponse — mesuré : un backend PostgreSQL en `idle in transaction` PAR ONGLET ouvert, pour la vie de l'onglet ; les trois routes SSE authentifient par `get_current_active_session_for_stream` (une session à elles, fermée avant la route ; garde `test_streaming_routes_hold_no_session_guard.py`).

### Added

- **ADR-299 / ADR-300** : `domains/live/` (`service.py`, `router.py`, `schemas.py`, `session_store.py`, `connector_service.py`, `mandate.py`, `direct_mandate.py`, `tool_door.py`, `model_settings.py`, `preferences.py`, `pricing.py`, `vendor_bill.py`, `errors.py`, `providers/{protocol,gemini,openai_live,openai_live_socket,elevenlabs_live}.py`), `infrastructure/llm/providers/{gemini,openai,elevenlabs}_live_listing.py`, `infrastructure/media/{pcm,wav}.py`, `infrastructure/observability/metrics_live.py`, `core/config/live.py`, `core/i18n_live.py`, `users/live_preferences_columns.py`, `agents/services/orchestration/out_of_graph.py`, `stores/revisionStore.ts` ; connecteurs `GEMINI_LIVE`, `GPT_LIVE`, `ELEVENLABS_LIVE` (catégorie `live`, additive) ; capacité `PlatformCapability.LIVE` ; migrations `d7f2a4c6e8b1` (`users.live_preferences`), `f1a3c5e7b9d2` (paire audio de la tarification), `b7d1e3f5a9c2` (ligne `elevenlabs-agents`, retirée ensuite), `a4c8e1f7b3d5` (`eleven_v3_conversational` en ligne `tts`, la ligne plate désactivée) + seed + classeur tarifaire v3 ; prompts `live_system_prompt.txt`, `live_lines.txt`, `live_tone_lines.txt`, `live_direct_system_prompt.txt`, `live_direct_lines.txt` ; routes `/live/*` (sessions, credential, offer, extend, turns, tools, end, connectors, models, voices, config, preferences) ; familles Redis `live:session`, `live:active`, `live_tools`, `live_mint`, `live_sample`, `voice_delegation:newest` ; métriques `live_*` (tableau Grafana 30 « Live »), `live_tool_calls_total`, `live_direct_relay_total` ; réglages `LIVE_ENABLED` et `LIVE_*` (constantes, config, quatre `.env`) ; front `lib/live/` (`session-controller`, `session-machine`, `transport`, `transports/{gemini-ws,openai-webrtc,elevenlabs-ws}`, `delegation`, `request-composer`, `meter`, `meter-view`, `vendor-bill-view`, `mic-capture`, `pcm-player`, `activity-clock`, `providers`, `types`), `components/live/` (bandeau, sous-titres, compteur, carte de clôture, dialogue de prolongation, provenance des voix), `components/settings/{LiveModeSettings,LiveBudgetField,LiveDurationFields,CallModeField}.tsx`, `connectors/{LiveConnectorForm,LiveConnectorGroup}.tsx`, hooks `useLiveSession`, `useLiveAvailability`, `useLiveConnectorSettings`, `useLiveConnectorDraft`, `useLivePreferences`, `useVoiceSample`, `stores/liveStore.ts`, section « Mode Live » des réglages (registre, icône, disponibilité, lexique), CSP `LIVE_PROVIDER_CONNECT_SRC` ; scripts `apps/api/scripts/live/probe.py` (`task live:probe`).
- **ADR-301** : `domains/voice_sessions/` (`session.py`, `transcript.py`, `projection.py`, `summary.py`, `mandate.py`), `infrastructure/scheduler/{voice_session_closing,voice_relay,voice_delegation}.py`, `agents/telephony/voice_lookup.py`, `telephony/{callback,delegation_tool}.py`, prompts `telephony_self_live_system_prompt.txt`, `voice_delegation_block.txt`, `voice_relay_lines.txt` ; migration `c9e2a4b6d8f1` (`users.phone_call_mode`, `phone_calls.call_mode`) ; route `POST /telephony/tools/send_to_lia` ; réglages `TELEPHONY_CALLBACK_BASE_URL`, `TELEPHONY_DELEGATION_TIMEOUT_SECONDS`, `VOICE_DELEGATION_RUN_TIMEOUT_SECONDS`, `VOICE_DELEGATION_LEASE_WAIT_SECONDS` ; métriques `telephony_delegations_total`, `telephony_delegation_duration_seconds` (tableau 24) ; scripts `apps/api/scripts/telephony/{simulate_live_call,probe_live_call,probe_async_delegation}.py` (`task telephony:simulate:live`, `task telephony:probe:live`) ; front `CallModeField`, `useTelephonyIdentity.setCallMode`, badge « Live / Live direct » sur les appels, `LiveRelayFate`.
- **Amendement ADR-272** : `domains/google_api/spend_roads.py`, `connectors/media_attribution.py`, `infrastructure/proactive/tracking.out_of_turn_spend`, `media_proxy_router.serve_billed_image`, `MessageTokenSummary.billed_cost_eur` / `billed_cost_sql()`, métrique `google_api_calls_unaccounted_total`, alerte `GoogleApiCallsUnaccounted` (trois seuils, test `promtool`, recette de preuves, entrée du catalogue de requêtes, deux panneaux du tableau 05), runbook `docs/runbooks/alerts/GoogleApiCallsUnaccounted.md`.
- `core/session_dependencies.get_current_active_session_for_stream` ; garde `test_streaming_routes_hold_no_session_guard.py` ; `tests/unit/test_dev_certificate_rotation.py`.
- Accueil : FAQ « Mode Live » (section Mode Vocal), questions téléphonie (Live / Live direct), confidentialité et limites d'usage ; carte « Comment fonctionne LIA » du mode Live ; changelog FAQ `v1_47_0` ; article de blog « Mode vocal » complété ×6 ; guides how/why/story ×6 ; `docs/technical/LIVE_MODE.md`, `TELEPHONY.md` § « Live mode », `VOICE.md`, `CONNECTORS_PATTERNS.md`, `GRAFANA_DASHBOARDS.md`, `GETTING_STARTED.md`, `INDEX.md`, `ADR_INDEX.md`, `CLAUDE.md` / `AGENTS.md`, cinq specs sous `docs/superpowers/specs/`.

### Changed

- `agents/api/service.py`, `archive_first.py`, `archive_metadata.py`, `schemas.py`, `router.py` : un tour délégué porte `live_session_id` + `spoken_text`, `spoken_by_person`, les lignes hors graphe injectées par `out_of_graph.py` ; `hitl_classifier.py` compte son repli avec son label ; `semantic_validator_node.py` ne saute que sur `plan_approved is True` ; `tool_embeddings_cache.py` hache `modèle:dimension`.
- `chat/service.py` (`TrackingContext.pending_families()`), `chat/models.py`, `conversations/{repository,service}.py`, `product/repository.py`, `briefing/service.py`, `meetings/{enrichment,processing}.py`, `users/{geocoding,service,models,user_data_map}.py`, `connectors/{router,street_view}.py`, `agents/tools/{places,routes}_tools.py`, `infrastructure/proactive/runner.py`, `infrastructure/llm/spend_roads.py`, `usage_limits/cost_bearers.py` : la comptabilité hors tour, les images comptées au proxy, `billed_cost_eur` ; `google_api/service.py` supprimé (demi grand livre).
- Téléphonie : `owner_call.py` (clôture d'un appel sans réponse décidée AVANT le mode, mode effectif décidé avant les consultations et le contexte), `mandates.py` (`LIVE_SELF_MANDATE`, `mandate_for(kind, mode=)`), `client.py` (`get_agent`, `signed_url`, `patch_agent`, `first_refusal`), `live_tools.py` (`VoiceToolHost`, `function_declaration`, `TaskGroup`), `self_call_relay.py` et `live/{summary,learning}.py` supprimés ; `call_me` neutre au mode.
- `domains/llm/{models,schemas,service,router,pricing_sheet*,pricing_change_plan,pricing_import_service}.py`, `infrastructure/cache/pricing_cache.py`, `core/i18n_pricing_sheet.py` : la paire audio ; `core/reasoning_profiles.py` : famille `gemini_live` ; `feature_switches/registry.py`, `capabilities/service.py`, `system_settings/models.py` : capacité `live` ; `infrastructure/cache/key_families.py` ; `voice/sentence_streamer.py` : les caractères comptés une fois servis ; `voice/stt/openai_stt.py`.
- Web : `voice-toggle.tsx` (une icône, un menu à trois entrées), `ChatInput.tsx` / `ChatMessage.tsx` / `useChat.ts` / `chat-reducer.ts` (session live, carte de clôture, rechargement sur `live_relay`), `useEyesBehavior.ts` (`effectiveVoiceState`), `useVoiceMode.ts` (`useLiveHoldsMicrophone`), `useAppConfig.ts`, `useSettingsAvailability.ts`, `settings-sections.ts`, `settings-search.ts`, `capability-sections.ts`, `lib/csp.ts`, `lib/api-error.ts`, `lib/html-plain-text.ts`, `constants/connectors.ts`, `types/telephony.ts`, `UserConnectorsSection.tsx` (déconnexion d'un connecteur live déclarée au menu), `telephony/identity` (mode d'appel, panneau des domaines toujours dessiné).
- `infrastructure/ssl/` : `ssl-init` ne renouvelle le certificat de dev que sur expiration (`SSL_RENEW_BEFORE_DAYS`), SAN ou clé, et dit quel cas s'est appliqué.
- Ratchets abaissés : CC frontend (max 80 → 78), cycles de couplage (25 → 24, `google_api<->users` disparu), baselines de taille et de CC backend ; `task release:sync-counts` (300 ADR, 581 métriques).

### Fixed

- Consultations Places / Routes d'un appel téléphonique ou d'une session Live directe jamais persistées ; appels Google du heartbeat, du briefing, des réunions et des proxys d'images jamais comptés (ou pré-comptés) ; facture téléphonique et carte live sans les euros Maps.
- Sélection sémantique des outils et classement ReAct aveugles sur un cache d'embeddings à la mauvaise dimension ; validateur sémantique sautant chaque tour depuis ADR-263 ; réponse HITL ambiguë classée EDIT sur un compteur sans label ; base de dev sans les 18 lignes tarifaires météo (donnée).
- Un backend PostgreSQL `idle in transaction` par onglet ouvert (routes SSE authentifiées par une dépendance `yield`) ; 8,9 s de session tenue pendant un tour relayé.
- Certificat de dev régénéré sur son âge ; caractères TTS facturés pour des phrases jamais servies.
- Live : `mode` perdu à la relecture du record (chaque consultation refusée « pas une session directe ») ; un socket jamais ouvert rapporté « fermé par le fournisseur — close 1006 » ; la liste des tours d'une session directe non ré-expirée par une prolongation ; un `PATCH` d'agent ElevenLabs refusé laissant un jeu d'outils orphelin par tentative ; `source_info` fermant 1008 après les métadonnées ; « biiiip » du lecteur audio sous Chrome 152 ; contexte audio refusé laissant le micro ouvert ; `owner_confirmed` du modèle bloquant une carte à « scheduled » ; carte d'une session relayée dont les chiffres étaient remplacés par le tampon d'origine ; menu vocal de l'en-tête figé après un changement de fournisseur.
- Téléphone : un appel Live que personne ne décroche fermé sans notification ; un appel Live dégradé en direct APRÈS avoir sauté consultations et contexte ; prompt de relais qui exigeait un contrôle d'identité d'une session navigateur.

### Tests

- Backend : `tests/unit/domains/live/` (service, session store, providers Gemini / GPT-Live / ElevenLabs, socket, mandat, mode direct, préférences, tarification, budget, facture du fournisseur, vocabulaire à travers la pile), `tests/unit/domains/voice_sessions/` (session, transcription, corpus de projection partagé avec vitest, résumé, mandat), `infrastructure/scheduler/test_voice_{delegation,relay,relay_golden,session_archive,session_direct_relay,session_learning}.py`, `domains/telephony/test_{callback,delegation_tool}.py`, `domains/agents/telephony/test_voice_lookup.py`, `domains/google_api/test_google_spend_road_completeness.py`, `domains/connectors/test_{media_attribution,media_proxy_billing,live_key_verifier,gpt_live_key_verifier,live_connector_type}.py`, `domains/users/test_geocoding_accounting.py`, `domains/meetings/test_enrichment_accounting.py`, `domains/llm/test_{schemas,service}_audio_prices.py`, `core/test_{i18n_live,reasoning_profiles_live,session_dependencies_stream}.py`, `core/config/test_live_settings.py`, `test_live_pricing_migration_guard.py`, `test_streaming_routes_hold_no_session_guard.py`, `test_dev_certificate_rotation.py`, `nodes/test_semantic_validator_skips_only_on_explicit_approval.py`, `hitl/test_classifier_ambiguous_decision.py`, `orchestration/test_inject_out_of_graph.py` ; intégration `tests/integration/domains/live/test_live_trace_db.py`, `tests/integration/test_voice_delegation_redis.py`.
- Frontend : `lib/live/__tests__/` (contrôleur, machine, trois transports, délégation, compositeur, compteur, facture, micro, lecteur PCM, horloge, corpus de projection, fournisseurs), `components/live/__tests__/`, `components/settings/__tests__/LiveModeSettings`, `connectors/__tests__/Live*`, hooks `useLive*`, `useVoiceSample`, `stores/__tests__/{liveStore,revisionStore}` ; Playwright `chat-live-session{,-openai,-elevenlabs}.spec.ts`, `settings-live-header-menu.spec.ts` (le fournisseur joué par `page.routeWebSocket` sur le micro factice de Chromium).
- Preuves Docker dev : session Gemini réelle (déléguée et directe), GPT-Live par WebRTC, ElevenLabs sur l'agent du propriétaire (fil serveur et navigateur), appel Live simulé en HTTP et sur le vrai moteur par tunnel, lookup téléphonique factice dans les quatre grands livres, `pg_stat_activity` avant / après.

## [1.46.0] - 2026-09-18

**Le bac à sable devient une boîte à outils : un script atteint le web par UNE porte, avec des clés qu'il ne lit jamais, et une question qu'il ne peut pas sauter** ([ADR-298](docs/architecture/ADR-298-Sandbox-Egress-Toolbox.md), amendant ADR-249, ADR-263, ADR-280, ADR-284, ADR-288 et SEC-001). Le script Python éphémère d'ADR-249 tournait hors ligne : un pas qui demandait une API que nul outil ne couvre était une impasse, et « vérifie que ce service répond » une phrase que le modèle ne pouvait qu'inventer. Un run RÉSEAU rejoint désormais `lia-sandbox`, réseau `internal` dont le seul membre routé est iron-proxy 0.49.0, conteneur FRÈRE épinglé par digest (`infrastructure/sandbox-egress/`, amd64 et arm64) — une interception par variable d'environnement a été rejetée parce qu'un socket brut la contourne, la topologie ferme ce que la configuration ne peut que suggérer ; son autorité, sa clé et son jeu de règles sont frappés par son propre point d'entrée dans des volumes tmpfs (un conteneur d'init a été mesuré faux : Docker rend le tmpfs à sa sortie). **Chaque hôte déclaré a UN statut sur quatre** (`egress/hosts.py`) : `connector` DÉRIVÉ des classes de clients à clé (`egress/connectors.py` — Brave, Perplexity, OpenWeatherMap ; l'URL de base, la méthode et le nom de l'en-tête lus sur la classe, jamais retapés, la liste gardée par un parcours AST du paquet), `operator` (`PYTHON_SANDBOX_EGRESS_HOSTS`), `grant` (l'accord de la personne), `unknown`. **Une clé personnelle voyage en jeton** : le script lit `os.environ["LIA_KEY_<CONNECTEUR>"]`, un jeton `sbx_` frappé par run que le proxy ÉCHANGE contre la vraie clé sur cet hôte seul (transformation `secrets`) — jamais d'OAuth, jamais une clé d'instance, jamais la clé dans le conteneur ; les plages privées, le lien local, les métadonnées de nuage et les mappages IPv4-dans-IPv6 sont refusés à la connexion (`DENY_CIDRS`, un test de complétude). Le jeu de règles est rendu depuis un registre Redis des runs vivants (`egress/registry.py`, revendication à jeton d'owner par `infrastructure/locks/redis_claim.py`, famille `sandbox_egress` déclarée `GLOBAL`) et rechargé par l'API de gestion sous porteur (`POST /v1/reload` — toute route `/v1/*` répond 401 sans porteur, mesuré) ; un rechargement refusé est un run qui ne démarre pas. **Un run réseau est REVENDIQUÉ avant que le conteneur ne démarre** (`effects/in_turn_effects.py`, capacité `python_sandbox_network`, réglé depuis un résultat explicite) sous le commutateur `python_sandbox_egress` (ADR-280, lu À L'ACTE ; le recouvrement skill-sandbox l'allume avec le proxy qu'il démarre, le panneau d'administration reste le levier d'arrêt).

**Un hôte inconnu est DEMANDÉ, avec trois réponses, et la question se règle DANS la boucle.** Le tour rend une carte `SANDBOX_EGRESS` (`egress/draft.py` : les hôtes, le but que le modèle déclare, un COMPTE des données du tour — jamais les données) que la personne accepte **avec les données**, **sans les données** (stdin ne porte alors aucun item — `confirm_without_data`, la troisième action que le normaliseur web jetait) ou refuse ; la réponse devient un accord (`sandbox_egress_grants`, migration `c9e5a7b1d3f4`, unique par compte et hôte, `share_turn_data`, `last_used_at`, purgé avec le compte et déclaré dans la carte des données), au-delà de `PYTHON_SANDBOX_MAX_GRANTS_PER_USER` un accord ne vaut que pour son run (`one_shot`), et la portée d'un run est le MINIMUM sur ses hôtes. Mesuré par le propriétaire avant livraison : confiée d'abord au dispatch des brouillons, la question mettait fin au tour sur le résultat réseau seul (« compte les pièces jointes de mes cinq derniers mails, et vérifie httpbin.org » : httpbin vérifié, les mails jamais comptés) — le dispatch EXÉCUTE un brouillon et répond de son résultat, il ne reprend jamais la boucle. `nodes/react_egress_question.py` lève désormais l'interruption depuis le nœud, comme la confirmation d'un outil de mutation (même charge utile, même carte, mêmes trois boutons), enregistre l'accord à la reprise et ré-invoque LE MÊME appel sous la réponse (`tool_path.approved_for_call`, un `ContextVar` ouvert et fermé par le nœud, portée d'effet dérivée « approuvée par la carte ») ; une question ne coûte aucun run du tour ; le script ne quitte jamais la boucle (le rejeu — script et items — voyageait jusqu'au navigateur : retiré) ; et `interrupt()` remonte de l'INTÉRIEUR de l'appel, si bien que le filet « toute erreur d'outil devient un message » l'avalait — re-levé avant le filet. Mesuré après sur dev : question, « avec les données », ré-invocation, autocorrection d'un 415 par le modèle, les deux volets répondus en quatre itérations.

**Le prompt est mesuré avant d'être cru** (ADR-284). Dit « `LIA_KEY_X` dans l'en-tête », le modèle a envoyé le NOM de la variable comme valeur (422 Brave ×2, sans autocorrection) : la ligne épelle la lecture (`os.environ["…"]`) et le tour suivant a répondu 200. `<Computation>` v2 (`react_computation_prompt.txt`, `react_computation_network_prompt.txt`, `react_computation_lines.txt` par `parse_prompt_sections`) dit les QUATRE rôles — calculer, diagnostiquer, combler, transformer —, lit ses bornes des réglages (`{script_timeout_seconds}`, `{script_memory_mb}`, `{script_stdout_kb}`, `{python_sandbox_max_runs_per_turn}`, `{max_hosts}`, `{max_body_kb}`, `{network_timeout_seconds}`), n'est rendu que si l'outil est lié ET la capacité ouverte, et coûte 439 tokens sans réseau, 692 avec quatre hôtes (o200k). **Les bibliothèques qu'un prompt promet vivent dans UNE table** (`python_sandbox/libraries.py`, 22 en cinq groupes ; six étaient transitives, onze sont désormais épinglées DIRECTEMENT : `requests`, `beautifulsoup4`, `lxml`, `tabulate`, `icalendar`, `chardet`, `xmltodict`, `feedparser`, `phonenumbers`, `pycountry`, `unidecode`) et sont importées dans l'image construite (`task sandbox:libraries:check`, `--network none`, en CI sur l'image chargée sous `lia-api:local`). Le manifeste (`catalogue_manifests.py`) dit les rôles, les hôtes, la lecture du jeton et les bornes depuis les réglages. **Une liste dans l'état est un accumulateur** : `react_scripts` grossissait pour la vie du fil jusqu'à rejoindre `react_turn_reset()`.

**Ce que la personne voit et règle.** _Réglages › Réseau du bac à sable_ (`SandboxEgressSettings`, `useSandboxEgress` ; `GET /sandbox-egress/reachable` par `merge_reachable` — connecteurs actifs et hôtes opérateur, UNE dérivation partagée avec l'offre du tour, `egress/offer.py` — et `GET/PATCH/DELETE /sandbox-egress/grants`, page et total exact) : les hôtes joignables sans question, chaque accord avec sa portée basculable et sa révocation, optimistes avec retour arrière ; section gardée par `sandboxEgressEnabled` dans le lexique et le shell ; la carte HITL dessine son troisième bouton. Observabilité : `python_sandbox_egress_runs_total{outcome}`, `python_sandbox_egress_grants_total{decision}`, jauge `lia_python_sandbox_egress_enabled`, deux panneaux du tableau 20 dessinés en COMPTES (un `rate()` de quelques décisions humaines par jour lisait vide — signalé avec deux réponses en Prometheus et rien à l'écran), l'alerte `SandboxEgressProxyDown` sur une sonde blackbox de `/healthz` (le proxy n'expose aucune série en 0.49 — mesuré 404), un runbook, une recette de preuves et une entrée du catalogue de requêtes du diagnostic. `task sandbox:egress:probe` prouve onze faits sur Docker dev (topologie, échange du jeton, refus des plages, 401 sans porteur, rechargement).

**Installabilité.** Le recouvrement skill-sandbox monte `./infrastructure/sandbox-egress` dans le proxy et l'API attend que ce proxy soit sain : le paquet d'auto-hébergement ne l'embarquait pas, si bien qu'une installation depuis le paquet avec le bac à sable démarrait un proxy sans point d'entrée et une API qui n'arrivait jamais. Le répertoire rejoint `BUNDLE_DIRS`, et un test lit désormais CHAQUE montage relatif des fichiers Compose que le paquet embarque plutôt que de se souvenir de la liste — le même piège que les runbooks (ADR-266) et le catalogue des dépendances (v1.30.1). La question du bac à sable de l'installateur dit ce qu'elle démarre, et le guide d'auto-hébergement dit que le recouvrement allume la sortie (le levier d'arrêt est le panneau d'administration). **Le déploiement du mainteneur portait la TROISIÈME copie de cette liste** (`prepare-prod.ps1`, `$infraDirs`) et l'omission y a été mesurée en production le 2026-09-18 : Docker a créé le répertoire monté VIDE sur l'hôte, le proxy a redémarré en boucle sur « can't open entrypoint.sh », l'API a attendu sa santé et le site a répondu 502 jusqu'au redéploiement. `sandbox-egress` rejoint la liste et `deploy-prod.Tests.ps1` lit désormais les fichiers Compose eux-mêmes : tout répertoire `infrastructure/` qu'ils montent et que la liste oublie fait échouer la suite.

### Added

- **ADR-298** : `python_sandbox/egress/` (`hosts.py`, `connectors.py`, `grants.py`, `grants_repository.py`, `models.py`, `offer.py`, `proxy_client.py`, `publisher.py`, `registry.py`, `router.py`, `ruleset.py`, `run.py`, `schemas.py`, `service.py`, `tool_path.py`, `draft.py`), `python_sandbox/libraries.py`, `nodes/react_egress_question.py`, `nodes/react_drafts.py` (`extract_draft_info` extrait de `react_nodes`), `effects/in_turn_effects.py`, `infrastructure/locks/redis_claim.py` ; migration `c9e5a7b1d3f4` (`sandbox_egress_grants`) ; `DraftType.SANDBOX_EGRESS` (affichage, résumé, aperçu, `i18n_drafts` ×6) ; `PlatformCapability.PYTHON_SANDBOX_EGRESS` et `SystemSettingKey.CAPABILITY_PYTHON_SANDBOX_EGRESS_ENABLED` ; famille Redis `sandbox_egress` ; routes `/sandbox-egress/reachable` et `/sandbox-egress/grants` ; prompts `react_computation_network_prompt.txt`, `react_computation_lines.txt`, `react_computation_prompt.txt` v2 ; `infrastructure/sandbox-egress/` (`entrypoint.sh`, `ca.cnf`, `proxy.bootstrap.yaml`) ; service `egress`, réseau `lia-sandbox` et trois volumes tmpfs dans `docker-compose.skill-sandbox.yml` et `docker-compose.dev.yml` ; scripts `apps/api/scripts/sandbox_egress/{probe,libraries_check}.py`, tâches `sandbox:egress:probe` et `sandbox:libraries:check`, étape CI « Sandbox libraries import in the built image » (image chargée sous `lia-api:local`) ; réglages `PYTHON_SANDBOX_MAX_RUNS_PER_TURN`, `PYTHON_SANDBOX_EGRESS_{ENABLED,ASK_ENABLED,HOSTS,PROXY_URL,MANAGEMENT_URL,HEALTH_URL,RELOAD_TIMEOUT_SECONDS,MAX_BODY_BYTES}`, `PYTHON_SANDBOX_NETWORK_TIMEOUT_SECONDS`, `PYTHON_SANDBOX_MAX_HOSTS_PER_RUN`, `PYTHON_SANDBOX_MAX_GRANTS_PER_USER` (constantes, config, quatre `.env`) ; métriques `python_sandbox_egress_runs_total`, `python_sandbox_egress_grants_total`, `lia_python_sandbox_egress_enabled` (tableau 20, panneaux 71-72), alerte `SandboxEgressProxyDown` (trois seuils, test `promtool`), runbook `docs/runbooks/alerts/SandboxEgressProxyDown.md`, recette de preuves et entrée du catalogue de requêtes ; front `SandboxEgressSettings`, `useSandboxEgress`, `types/sandbox-egress.ts`, `useAppConfig.python_sandbox_egress_enabled`, section `sandbox-egress` (registre, icône, disponibilité, lexique) ; locales `settings.sandbox_egress.*`, `settings.search.keywords.sandbox-egress`, `capabilities.items.python_sandbox_egress` ×6.
- Dépendances : onze bibliothèques du bac à sable épinglées directement dans `requirements.txt` (deux lockfiles régénérés) ; `anyio` 4.12.1 → 4.14.2 dans les deux lockfiles (CVE-2026-63374, CVE-2026-64847 ; relevé par l'audit de dépendances de la CI).
- Paquet d'auto-hébergement : `infrastructure/sandbox-egress` dans `BUNDLE_DIRS` ; test `test_bundle_ships_every_bind_mount_of_the_compose_files_it_ships`. Déploiement : `sandbox-egress` dans `$infraDirs` de `prepare-prod.ps1` ; deux tests Pester (l'entrypoint mis en scène, et chaque répertoire `infrastructure/` monté par un fichier Compose embarqué présent dans la liste).
- Accueil : deux attentions `/more` (`network_question`, `network_grants`) avec leurs scènes ; FAQ `chat.q29`, `settings.q29`, `privacy.q15` ; changelog FAQ `v1_46_0` ; cartes « Réponses calculées » et « Sécurité » réécrites ; article de blog du mode ReAct complété ×6.

### Changed

- `python_sandbox_tools.run_python_tool` : paramètre `hosts` (vide = run hors ligne), un run n'est facturé qu'une fois le conteneur parti, `structured_data` porte le bloc réseau et la trace en `content_trust: untrusted` ; `skills/executor.py` : un run réseau rejoint `lia-sandbox` avec le proxy et l'autorité montés, `execute_source` refuse tout autre mode que `container`.
- `react_nodes` : `invoke_with_settlement` est la porte unique vers la coroutine d'un outil, `GraphInterrupt` re-levé avant le filet d'erreurs, `network_available` calculé au setup ; `react_prompt.build_system_prompt(state, computation=, network=)` ; `catalogue_manifests` réécrit avec les bornes depuis les réglages.
- `draft_executor_types.EXECUTORS_GATED_BY_THEIR_TOOL = {"tool_call"}` ; `approval_decision` canonise `confirm_without_data` en `confirm` + `share_turn_data: false` ; `hitl/schemas`, `hitl-payload.ts` et `HitlActionCard` portent la troisième action ; `hitl_draft_critique_prompt.txt` décrit la carte.
- `react_budget.react_turn_reset()` remet `react_scripts` ; `models.py` ne liste plus la clé à la main.
- `ruleset.DENY_CIDRS` gagne `0.0.0.0/8`, `::/128`, `64:ff9b::/96` ; `proxy.bootstrap.yaml` et le rendu partagent un en-tête.
- `effects/direct_client_callers.py` déclare le client du proxy ; `effects/gate.py`, `effects/runtime.py`, `startup/agents.py` (assert de complétude), `main.py`, `database/registry.py`, `shared_flight.py`, `users/user_data_map.py`, `account_deletion_service.py` alignés.
- Installateur : question `question.skill_sandbox` (en, fr) ; `GUIDE_SELF_HOSTING.md` § 4.6 ; `.env.example` et `.env.prod.example` disent que le recouvrement force le drapeau ; `.gitattributes` épingle `*.cnf` en LF.
- Hook pre-commit : un jeton `LIA_KEY_*` par run (lu par le conteneur enfant, jamais par l'API) n'est pas une variable de configuration — la vérification de `.env.example` l'exempte avec sa raison écrite.
- Docs : `REACT_EXECUTION_MODE.md` § « Network runs », `ADR_INDEX.md`, `INDEX.md`, `CLAUDE.md` / `AGENTS.md`, spec `docs/superpowers/specs/2026-09-18-sandbox-egress-toolbox-design.md` §12 (écarts mesurés).

### Fixed

- Une question egress posée au milieu d'un plan mettait fin au tour sur le résultat réseau seul (livraison intermédiaire, jamais publiée) ; le rejeu voyageait jusqu'au navigateur ; `react_scripts` s'accumulait pour la vie du fil.
- Le normaliseur HITL web jetait la troisième action d'une carte ; le prompt faisait envoyer le nom d'une variable comme secret.
- Les deux panneaux egress du tableau 20 lisaient vides sur quelques décisions par jour.
- Le paquet d'auto-hébergement n'embarquait pas le répertoire que le recouvrement skill-sandbox monte dans le proxy ; le déploiement du mainteneur (`prepare-prod.ps1`) non plus — mesuré en production : proxy sans point d'entrée, API jamais démarrée, 502.

### Tests

- Unitaires : `python_sandbox/egress/` (hôtes et statuts, dérivation des connecteurs par AST, accords — cap, `one_shot`, `mark_relied_grants` —, offre, `merge_reachable`, client du proxy, éditeur, registre Redis, routeur, jeu de règles contre `golden_ruleset.yaml` et complétude des plages refusées), `python_sandbox/test_libraries.py`, `nodes/test_react_egress_question.py` (16 : charge utile, lecture de la réponse, refus, accord avec et sans données, ré-invocation sous la portée approuvée, la boucle continue, l'interruption échappe au filet), `test_react_setup_network_offer.py`, `test_react_prompt_capabilities.py` (bloc réseau, coût), `tools/test_python_sandbox_network.py` et `test_python_sandbox_tool.py` (budget par run réel, hôte inconnu, aucun rejeu), `effects/test_in_turn_effects.py`, `locks/test_redis_claim.py`, `startup/test_sandbox_egress_boot.py`, `test_self_host_compose_contract.py` (seul membre routé, durcissement, clé jamais montée), `hitl/test_draft_critique_metadata.py` (le chunk egress), `feature_switches/test_capability_coverage.py`, `test_react_turn_reset_guard.py` ; intégration PostgreSQL `test_sandbox_egress_grants_db.py` (unicité, cap, purge).
- Front : `SandboxEgressSettings`, `useSandboxEgress`, `HitlActionCard` (trois actions), `hitl-payload`, `settings-search` (61 jetons), shell et rail ; e2e `settings-sandbox-egress` (trois parcours dont 320 px) et `chat-hitl-card` (la carte egress).
- Mesuré sur Docker dev : `task sandbox:egress:probe` 11/11, deux vrais tours ReAct par l'API HTTPS (Brave sous clé échangée, hôte inconnu demandé puis ré-invoqué), `task sandbox:libraries:check` 22/22 sur l'image dev.

## [1.45.2] - 2026-09-18

**Un document d'un espace de connaissances rejoint un message comme copie, espace en pause ou non** ([ADR-295](docs/architecture/ADR-295-Knowledge-Documents-As-Message-Attachments.md), amendant ADR-279, ADR-280, ADR-286, ADR-185). La recherche du chat ne lit que les espaces ACTIFS, si bien qu'un document indexé dans un espace en pause était inaccessible depuis une question — il fallait réactiver tout l'espace ou renvoyer le fichier. Le « + » du composeur devient un menu dès qu'il a une seconde entrée (un navigateur garde son sélecteur en un clic quand les espaces sont coupés, la coque Android garde son appareil photo) et liste les documents `ready` de CHAQUE espace de la personne (`GET /rag-spaces/documents`, monté AVANT `/{space_id}`, page et total exact, jokers LIKE échappés, borne publiée), un espace en pause badgé plutôt que caché. Le document choisi est COPIÉ par le mécanisme même des pièces jointes (`POST /attachments/from-knowledge-document`, `attachments/knowledge_copy.py`, la seule arête `attachments → rag_spaces`) : le fichier stocké sous un UUID neuf, copié en flux, le texte extrait par le pipeline des espaces (quinze formats, pas la liste image-et-PDF de l'envoi) sous `attachments_max_pdf_text_chars`, la ligne en `origin = upload` pour qu'une réinitialisation la retire comme tout ce que la personne a mis et que l'espace, son index et son fichier ne soient jamais touchés ; une ligne qui échoue retire sa copie. Seul un document `ready` est proposé (409 `document_not_ready`, traduit), les DEUX gardes de capacité portent la route, et **une coupe est énoncée au modèle** (`[truncated: the first N characters…]`) pour tout document joint, envois compris — ils étaient coupés en silence. Trouvé sur le chemin : les libellés de l'indice de pièce jointe vivaient en Python et étaient clés `zh` là où le canonique backend est `zh-CN` — chaque lecteur chinois recevait l'anglais ; ils viennent d'`APIMessages.attachment_hint_labels` par `normalize_language`. Mesuré sur dev : un `.docx` d'un espace EN PAUSE joint par le point d'accès, son chiffre cité exactement en pipeline ET en react, la réinitialisation retire la copie (404) et laisse le document de l'espace.

**Une pièce jointe de mail se lit : son texte quand elle en a un, le slot de vision sinon** ([ADR-296](docs/architecture/ADR-296-Mail-Attachments-Read-By-Text-Or-Vision.md), amendant ADR-286, ADR-287, ADR-272, ADR-275, ADR-184). `get_emails` listait les pièces jointes et s'arrêtait là. UNE porte de téléchargement sur les trois clients (`EmailClientProtocol.download_attachment` — Gmail dans `gmail_attachments_mixin.py`, l'unité extraite pour que le client gelé rétrécisse ; Graph par `/attachments` puis `contentBytes` ; IMAP par l'INDEX de partie que le normaliseur publie désormais), UNE sélection partagée (`clients/email_attachments.select_attachment`) : par identifiant, sinon par nom, un nom ambigu refusé avec ses candidats. **Un identifiant Gmail expire entre deux lectures d'un message** (mesuré sur une vraie boîte) : un identifiant périmé se résout par le nom, puis par l'unicité, sinon répond `DISAMBIGUATION_REQUIRED` avec les identifiants COURANTS — le manifeste dit au modèle de préférer le nom et de passer les deux. `agents/emails/attachment_content.py` lit des OCTETS et ne touche aucun client : type MIME par les octets magiques, `extract_text` en thread, une image ou un PDF sans couche texte rendu en pages PNG bornées et réduites pour `vision_analysis` — le raster lui-même borné (une page de 200 pouces de côté allouait 829 M pixels avant que Pillow ne refuse) — et un jeu de pages coupé ÉNONCÉ au modèle (`pages_cut`, `pages_total`). L'appel de vision est la dépense du TOUR (`invoke_with_instrumentation` sur le `RunnableConfig` du runtime, `short_answer_config`, `spend_blocked` → `skipped_quota`, tronqué → refus, prompt et scaffold en fichiers versionnés). `get_email_attachment_tool` (outil de lecture de l'agent e-mail, deux modes) borne le téléchargement — **la borne descend au client**, une partie que le listage annonce trop lourde est refusée avant qu'un octet ne circule — sert le texte en PARTIES sous `emails_body_part_tokens`, l'enveloppe en contenu externe, et nomme chaque refus. `vision_analysis` rejoint le Literal `LLMType`. Mesuré sur dev : un PDF Gmail de 632 Ko extrait en 55 625 caractères, un PNG de 77 Ko lu par le slot de vision configuré (`outcome=ok`).

**Un dossier Drive lié est un ARBRE, et une synchronisation au-delà du seuil dit son compte exact** ([ADR-297](docs/architecture/ADR-297-Drive-Folder-Is-A-Tree-And-The-Count-Is-Exact.md), amendant ADR-261, ADR-262, ADR-185, ADR-184, ADR-263, remplaçant la règle non récursive d'ADR-056). Drive liste un niveau par appel : une source n'indexait que les fichiers directs. UN parcours en largeur, borné deux fois (`RAG_DRIVE_MAX_FILES_PER_SYNC`, `RAG_DRIVE_MAX_FOLDERS_PER_WALK`) et qui dit sa coupe (`rag_spaces/drive_walk.py` : raccourci ni listé ni suivi, dossier atteint deux fois parcouru une fois, sous-dossier illisible compté et sauté, racine illisible = la seule erreur), partagé par la synchronisation et par `GET …/drive-sources/{id}/preflight`, qui classe chaque fichier avec les prédicats mêmes de l'ingestion (`is_supported_drive_file`, `is_unchanged`, extrait d'`ingest_drive_file`) sous le plafond de documents de l'espace et publie `to_index`, le seuil (`rag_drive_sync_confirm_threshold`, 10) et les bornes. **L'ensemble des dossiers parcourus voyage avec la source** (`rag_drive_sources.folder_ids`, JSONB, migration `b8d4f6c0e2a3`) : le push route sur cet ensemble et le laisse suivre le flux ; un lien IMBRIQUÉ est refusé (409 `drive_folder_nested`, ancêtres dans les deux sens) parce que deux sources se voleraient leurs documents. Le front demande le comptage AU CLIC — un seul en vol, la ligne occupée — et, au-delà du seuil, un dialogue énonce les chiffres exacts (« au moins » quand le parcours est coupé, les fichiers que l'espace ne peut plus tenir nommés) avant de poster la synchronisation. Mesuré sur dev contre un vrai Drive : six dossiers parcourus sous une borne de six, la coupe déclarée.

**Chaque lecture d'un espace atteint enfin le registre** (amendement ADR-297/ADR-263, trouvé après livraison). Le registre ne garde que ce qu'un collecteur publié ramasse, et AUCUN acte d'un espace — lien depuis les réglages, synchronisation de fond, push — n'en publiait : chaque `space_read` écrit depuis ADR-262 était jeté en silence (zéro ligne `space:*` sur dev, jamais). `space_read` ouvre son propre run (`consultation_collector`) quand `collector_is_active()` — sonde offerte au seam par le registre, même inversion que la fabrique — dit que personne ne l'a fait, et rejoint le tour sinon ; le sync de fond d'un libellé Gmail lit sous `space_read(SECTION_MAIL)`, miroir du Drive ; un refus de NOS règles (lien imbriqué, pas un dossier) est consigné `ok` — « failed » est le mot d'une source qui refuse. Mesuré : une ligne `space:mail` `scheduled` par acte.

**Les longues synthèses web se replient, le code reste dans sa carte.** En mode cartes HTML, `render_folded_synthesis` (`display/components/folded_synthesis.py`) remplace les deux formateurs dupliqués des cartes de recherche : une amorce de paragraphes entiers sous `WEB_SEARCH_SYNTHESIS_PREVIEW_CHARS` (un paragraphe seul trop long coupé à une frontière de phrase, jamais en milieu de mot, sans perte), le reste derrière le `<details>` « voir plus » de toutes les autres cartes. Et `MarkdownContent` route TOUT `pre>code` vers `CodeBlock` : défilement horizontal dans la carte, barre fine toujours visible (WebKit et Firefox), fondu sur le bord droit tant que la fin n'est pas atteinte, prouvé en e2e à 1280 et 390 px sur une clôture Markdown sans langage et sur un `pre>code` HTML enrichi.

**Les photos iPhone se décodent côté serveur.** `pillow-heif` rejoint l'image (roues cp314 vérifiées pour l'hôte, le conteneur et l'arm64 de production ; 5,3 Mo mesurés à l'import), enregistré paresseusement par `infrastructure/media/heif.py` aux trois sites qui ouvrent l'image d'un tiers — envoi, pièce jointe de mail, retouche d'image. Le routeur d'envoi promettait « HEIC converti en JPEG » depuis v1 sans codec derrière : la conversion fonctionne pour la première fois.

**Ce qu'une revue à froid a rendu au produit** : l'attribut `source` du contenu externe est échappé, monoligne et borné (un nom de pièce jointe `">` suivi d'un retour ligne plaçait du texte AVANT l'avertissement « non fiable » — au funnel, pour les quatorze appelants) ; le sélecteur du composeur énonce sa coupe de page (« 50 documents affichés sur 120 ») ; `CodeBlock` ne rend plus une image par jeton streamé quand rien n'a bougé.

### Added

- **ADR-295** : `attachments/knowledge_copy.py`, `rag_spaces/documents_router.py` (`AttachableDocument`, `AttachableDocumentsResponse`, `max_limit`), `RAGDocumentRepository.search_ready_for_user`, `APIMessages.attachment_hint_labels` ; route `POST /attachments/from-knowledge-document` (`KnowledgeDocumentAttachmentRequest`, gardes ATTACHMENTS + RAG_SPACES) ; front `KnowledgeDocumentPickerDialog`, `useAttachableDocuments` (`loading` dérivé, réponse tardive ignorée), `useFileUpload.addServerAttachment`, `lib/api-error.getApiErrorCode`, `ChatInput.knowledgeDocumentsEnabled` ; locales `chat.attachments.from_knowledge`, `chat.knowledge_picker.*` ×6.
- **ADR-296** : `connectors/clients/email_attachments.py` (`EmailAttachmentContent`, `select_attachment`, `ensure_within_bound`, `EmailAttachmentTooLargeError`), `gmail_attachments_mixin.py`, `EmailClientProtocol.download_attachment(max_bytes=)`, `agents/emails/attachment_content.py` (`Route`, `RenderedPages`, `read_attachment`), `attachment_manifest.py`, `tools/email_attachment_tools.py` ; prompts `email_attachment_vision_prompt.txt`, `email_attachment_vision_lines.txt` ; réglages `EMAIL_ATTACHMENT_MAX_MB`, `EMAIL_ATTACHMENT_VISION_MAX_PAGES`, `EMAIL_ATTACHMENT_IMAGE_MAX_EDGE`, `EMAIL_ATTACHMENT_RATE_LIMIT_MAX_CALLS`, `EMAIL_ATTACHMENT_RATE_LIMIT_WINDOW_SECONDS` (constantes, config, quatre `.env`) ; métrique `email_attachment_reads_total{route,outcome}` (tableau 10, panneau 51) ; `vision_analysis` dans `LLMType` ; locale `execution.steps.get_email_attachment` ×6.
- **ADR-297** : `rag_spaces/drive_walk.py` (`DriveTree`, `walk_drive_tree`), `drive_ingest.is_unchanged` / `routed_folder_ids` / `TouchedSource`, `drive_sync.preflight` / `ancestor_ids` / `DRIVE_FOLDER_NESTED_CODE`, `RAGDrivePreflightResponse`, route `GET /rag-spaces/{space_id}/drive-sources/{source_id}/preflight` ; migration `b8d4f6c0e2a3` (`rag_drive_sources.folder_ids`) ; constantes `RAG_DRIVE_MAX_FOLDERS_PER_WALK`, `RAG_DRIVE_MAX_ANCESTOR_DEPTH`, `GOOGLE_DRIVE_FOLDER_MIME`, `GOOGLE_DRIVE_SHORTCUT_MIME` ; réglage `RAG_DRIVE_SYNC_CONFIRM_THRESHOLD` (quatre `.env`) ; front `DriveSyncConfirmDialog`, `useDrivePreflight`, `useSourceActions.linkErrorKeys` ; locales `spaces.drive.link_nested`, `preflight_error`, `confirm.*` ×6.
- Registre : `consultation_sink.install_collector_probe` / `collector_is_active`, `rag_spaces/consultations._timed_read`.
- Synthèse repliée : `display/components/folded_synthesis.py` (`split_lead`, `format_synthesis_html`, `render_folded_synthesis`), constante `WEB_SEARCH_SYNTHESIS_PREVIEW_CHARS_DEFAULT`, réglage `WEB_SEARCH_SYNTHESIS_PREVIEW_CHARS`.
- Code : `lib/markdown-code-block.ts`, `CodeBlock` (`useScrollBoxOverflow`, `data-overflowing`, `data-scrolled-end`), classes `.code-scroll` / `.code-scroll-frame`.
- `infrastructure/media/heif.py` (`ensure_heif_support`), dépendance `pillow-heif` (manifeste et deux lockfiles).
- Dépendances : `soupsieve` 2.8.4 → 2.9.2 dans les deux lockfiles (CVE-2026-85999, CVE-2026-86000 ; relevé par l'audit de dépendances de la CI).
- Accueil : trois attentions `/more` (`knowledge_pick`, `code_scroll`, `sync_count`) avec leurs scènes ; FAQ `chat.q28`, `tool_examples_services.q19` ; changelog FAQ `v1_45_2` ; lexique `rag-spaces` enrichi ×6.

### Changed

- `MarkdownContent` : `pre` route tout bloc de code vers `CodeBlock`, `code` ne sert plus que l'inline ; `ComposerAttachmentsControl` porte le sélecteur de connaissances et devient un menu dès deux entrées.
- `web_search_card.py` et `search_result_card.py` appellent `render_folded_synthesis` ; leurs formateurs privés dupliqués sont retirés.
- `drive_sync` : la synchronisation de fond parcourt l'arbre sous `space_read`, persiste `folder_ids`, marque la source en erreur sur `DriveWalkError` ; `link_folder` lit dans le bloc et juge après (`_nested_folder_conflict`) ; `drive_ingest._touched_sources` route sur l'ensemble parcouru et le fait suivre le flux (`_FeedChange`, `_route_change`).
- `mail_sync.sync_label_background` lit sous `space_read(SECTION_MAIL)` ; `space_read` publie son propre run hors de tout collecteur.
- `attachments/service._convert_heic_to_jpeg`, `agents/emails/attachment_content._downscale`, `image_generation/resize.py` enregistrent le décodeur HEIF avant d'ouvrir l'image.
- `content_wrapper.wrap_external_content` échappe, aplatit et borne l'attribut `source`.
- `email_normalizer` publie `attachmentId = str(index)` pour l'IMAP ; `RAGDriveSourceCreate.folder_id` valide la forme d'un identifiant Drive.
- Gabarit `google_gmail_client.py` : 931 → 872 SLOC, plafond du ratchet abaissé.
- ADR-056 : la règle « non récursive » est remplacée par ADR-297 ; `ATTACHMENTS_INTEGRATION.md`, `REACT_EXECUTION_MODE.md`, `DATABASE_SCHEMA.md` alignés.

### Fixed

- Un document d'un espace en pause était inaccessible depuis le chat ; le texte d'un document joint était coupé en silence ; l'indice de pièce jointe servait l'anglais aux lecteurs chinois.
- Aucun outil n'ouvrait une pièce jointe de mail ; un identifiant Gmail périmé aurait échoué au lieu de se résoudre par le nom.
- Un dossier Drive n'indexait que ses fichiers directs ; un push sous un sous-dossier était invisible ; un dossier lié dans un autre aurait fait se voler leurs documents à deux sources.
- Chaque `space_read` depuis ADR-262 était jeté (aucun collecteur publié) ; le sync mail de fond n'enregistrait rien ; un refus de nos règles se consignait `failed`.
- Une longue synthèse web remplissait toute la carte ; une ligne de code débordait de la carte à droite.
- HEIC : la conversion annoncée depuis v1 n'avait aucun codec ; une page PDF géante rasterisait 829 M pixels avant refus.
- Un nom de pièce jointe pouvait fermer la balise du contenu externe ; le sélecteur cachait sa coupe de page ; un double clic sur Synchroniser parcourait le Drive deux fois ; `CodeBlock` re-rendait à chaque jeton.

### Tests

- Unitaires : `attachments/test_knowledge_copy` (copie, coupe, non prêt, orpheline retirée), `rag_spaces/test_documents_listing` (intégration PostgreSQL), `connectors/clients/test_email_attachments` (sélection, identifiant périmé, borne avant téléchargement ×3 clients), `agents/emails/test_attachment_content` (routes, raster borné, coupe de pages énoncée, HEIC), `test_email_attachment_tool`, `rag_spaces/test_drive_walk` / `test_drive_ingest_push` / `test_drive_sync_tree` / `test_drive_preflight` / `test_drive_sync` (lien refusé consigné `ok`), `test_space_consultations` (run propre / run rejoint), `test_mail_sync` (consultation du sync de fond), `display/test_folded_synthesis`, `utils/test_content_wrapper_injection` (attribut `source`), `attachments/test_service` (HEIC → JPEG).
- Front : `KnowledgeDocumentPickerDialog`, `useAttachableDocuments`, `useFileUpload`, `ChatInput`, `DriveSourcesList` (un comptage à la fois), `useSourceActions`, `api-error`, `MarkdownContent.code-blocks` ; e2e `chat-knowledge-attachment`, `spaces-drive-sync-confirm`, `chat-code-block-overflow` (1280 et 390 px).
- Mesuré sur Docker dev : B1 en pipeline et react, B2 texte et vision sur une vraie boîte, B5 sur un vrai Drive, une ligne `space:mail` par acte.

## [1.45.1] - 2026-09-17

**Une réponse conservée est indexée comme un document d'un espace de connaissances** ([ADR-291](docs/architecture/ADR-291-Kept-Answers-Knowledge-Space.md), amendant ADR-282). Un bookmark était une copie que la personne relisait et exportait ; il est désormais **projeté** dans un espace à elle, trouvé par RÔLE (`rag_spaces.kind = 'bookmarks'`, un par compte, créé au premier usage dans sa langue, actif par défaut, hors plafonds d'espaces et de documents — le plafond des bookmarks est la borne), jamais dans un espace système qui n'a pas de propriétaire. La forme est celle des réunions (ADR-258), pas celle d'une source synchronisée (ADR-262) : le bookmark est l'ENREGISTREMENT (`rag_document_id` `SET NULL`, `index_state` qui dit pourquoi il n'y a PAS de projection — `pending | indexed | error | deferred | disabled` —, `indexed_at`), le document Markdown sa projection (titre daté, demande citée ou ligne de notification, réponse ; une réponse `lia-response` convertie par `html_to_markdown`, UNE lecture de « comment le HTML devient du texte » — `markdownify(strip=["script","style"])` gardait le contenu des balises). Le document est l'autorité tant qu'il existe : l'état exposé est DÉRIVÉ, le coût rapporté une fois READY seulement. Une projection est **réclamée** avant tout effet (`claim_for_projection`, un UPDATE conditionnel ; un `pending` périmé est repris), chaque garde laisse un état honnête (capacités lues À L'APPEL → `disabled`, `spend_blocked` → `deferred`, un échec → `error`, en lettre morte, re-projeté en conservant de nouveau). Le rattrapage roule sur le tick du faucheur (`infrastructure/scheduler/rag_maintenance.py`, composé là parce que `rag_spaces → bookmarks` fermerait un cycle ; le faucheur passe D'ABORD), sert le lot **le moins récemment tenté** (par création, un compte sous quota affamait tous les autres) et ne sélectionne rien quand les capacités sont coupées ; un bookmark supprimé entre le commit de son document et celui du lien reprend le document (le nombre de lignes du lien dit que la ligne est partie). Le document d'une réponse conservée n'est ni déplaçable ni supprimable depuis l'espace (409 `document_managed_by_bookmarks`, UNE table `MANAGED_DOCUMENT_CODES` qui rend aussi le document d'un libellé immobile, comme ADR-262 l'énonçait), un espace géré par rôle n'est pas supprimable à la main (403 `space_managed_by_domain`, réunions comprises), `kind` est sur la forme de fil de l'espace. Tout nom d'affichage écrit par autrui passe par `rag_spaces/document_names.py` ; `process_document` ne journalise aucun nom à INFO.

**Le portrait lit quatre sources, et dit lesquelles** ([ADR-292](docs/architecture/ADR-292-Portrait-Reads-Four-Sources.md), amendant ADR-079, ADR-088, ADR-269, ADR-280). Souvenirs, centres d'intérêt, habitudes apprises et débriefs de relation entrent dans le prompt de consolidation comme MATIÈRE de la synthèse. `journals` n'importe aucun domaine source : `interests` et `relations` l'importent déjà, si bien que les sources sont OFFERTES par `domains/shared/portrait_sources.py` (vocabulaire clos `PORTRAIT_SOURCE_KEYS`, un `portrait_source.py` par domaine, le boot INSTALLE explicitement et refuse un registre incomplet — un module déjà importé ne câble rien). Un lecteur répond `used | empty | disabled | unavailable` avec un total EXACT, sous ses trois gardes lues à l'appel (plafond, interrupteur d'exploitant, préférence de la personne), et ne lève jamais : une source aveugle est NOMMÉE, jamais lue comme vide. L'assembleur lit UNE source à la fois sous `JOURNAL_CONSOLIDATION_*_MAX` et abandonne une section ENTIÈRE au-delà de `JOURNAL_CONSOLIDATION_SOURCES_MAX_CHARS`. Le prompt ne rend une section que si elle existe ; l'ÉTAPE 7 interdit de relister les faits, de citer une ligne mot pour mot et de nommer les sources — « une source absente de la SECTION 1 est INCONNUE, pas vide » — et les budgets du portrait sont `{portrait_full_tokens}` / `{portrait_brief_tokens}` depuis les réglages (un budget énoncé, pas un rognage : dépassement mesuré d'environ un tiers). La **provenance est persistée AVEC le portrait** (`users.journal_portrait_sources`, même UPDATE, intacte quand aucun portrait n'est revenu ; lue par `provenance_of`, tolérante ; classée et purgée avec le compte) et dessinée sous lui dans les réglages ; une source qui a bougé rouvre l'éligibilité (un `EXISTS` par `FreshnessProbe` installée, entrées en jointure externe). Les échafaudages d'usage et de santé rejoignent `journal_portrait_source_lines.txt` (ADR-284), `emotional_label` vit dans `memories/emotional_state.py`.

**La boucle ReAct lie ses outils par PERTINENCE, le planificateur garde son catalogue** ([ADR-293](docs/architecture/ADR-293-React-Tools-Bound-By-Relevance.md), amendant ADR-070, ADR-248, ADR-256, ADR-184). Le plafond coupait dans l'ordre d'ENREGISTREMENT : sur tout compte avec plus d'outils que le plafond, les mêmes familles tombaient à chaque tour quelle que soit la question — les outils MCP de la personne les premiers — et quatre-vingts schémas faisaient 95 % du premier appel, non comptés (331 jetons par schéma en moyenne, mesuré). **Un embedding, deux lecteurs** : les scores de domaine du planificateur sont inchangés, et du même vecteur `rank_tools` ordonne CHAQUE manifeste disponible ET chaque vecteur par requête sans manifeste (les outils individuels d'un serveur MCP itératif, qui n'ont qu'un manifeste `_task` — trouvé en revue à froid : classés depuis les manifestes seuls, ils ne pouvaient jamais se classer) dans `tool_selection_result["global_ranking"]` (`router_tool_scoring.score_tools_for_turn`, la seule couture ; `None` = aucun score, comme avant ; un tour actionnable sans domaine détecté est classé quand même). **La boucle lie par composition, et aucun nom d'outil n'est écrit nulle part** : les outils des domaines détectés, puis les `CATALOGUE_DOMAIN_COVERAGE_TOP_N` mieux classés de chaque autre famille (la constante de couverture du catalogue, partagée) — la porte de délégation d'un serveur MCP étendu à côté, sans siège, classée comme son meilleur outil —, puis les `REACT_TOOL_SEMANTIC_TOP_K` premiers de l'ordre ; le plafond reste le filet, par tri stable sur trois tiers ; sans classement ou avec K = 0, le comportement précédent au byte. Une liste « core » déclarée a été écrite puis REJETÉE : elle encodait l'usage d'un compte dans un produit multi-utilisateurs ; la couverture par famille le dit structurellement. Mesuré (rejeu anonymisé d'une semaine sur une instance de dev, K = 40) : 68 outils liés en médiane au lieu de tous, 22 488 jetons de schémas au lieu de 35 471, chaque outil appelé encore atteignable par sa famille ; sur le catalogue réel plus quatre serveurs MCP itératifs, 36/36 outils individuels classés, 4/4 portes liées. **Et la boucle sait ce que le pipeline sait** (amendement ADR-248) : `build_knowledge_block` monte le `<UserDocuments>` du pipeline — lu dans le lot que le routeur a préchargé, jamais consommé (`peek_response_context`) — là où la recherche se décide ; mesuré : une réponse conservée portant le fait atteignait le prompt de réponse tandis que la boucle, aveugle, dépensait ses itérations ailleurs.

**Le mode HTML enrichi est une page composée, pas une prose balisée** ([ADR-177](docs/architecture/ADR-177-Rich-HTML-Response-Components.md), deux amendements). D'abord la garde : la directive n'était injectée que sur un tour planificateur, par précaution pour la voix — sans tour planificateur, la réponse du chat est lue telle quelle par la synthèse progressive et lirait des balises — sans jamais lire la préférence vocale ; un compte en `html` dont la voix est désactivée recevait du Markdown sur chaque tour conversationnel (30 % des tours d'une semaine sur une instance de dev). La garde devient `display_mode == html and (route_to == planner or not voice_enabled)`, la préférence portée par `LiaRuntimeContext.voice_enabled` et lue par `voice_preference_of` — la même lecture que le coordinateur vocal, pour que la garde d'affichage et le déclencheur ne divergent jamais. Ensuite la directive elle-même, sur capture du propriétaire : des réponses outillées rendues en `<p>` + `dl.lia-kv`, « quasi identiques au Markdown ». Deux causes mesurées — l'heuristique « au plus 2-3 composants, une réponse concise est un `<p>` », et l'imitation de la forme des réponses précédentes de la conversation (après une première réponse en `lia-kv`, les suivantes restaient en `lia-kv` là où une conversation vierge donnait tuiles et colonnes). La directive impose une page COMPOSÉE pour toute réponse porteuse de données : une accroche avec le fait clé en `<strong>`, une section `<h2>` par facette dans le composant qui lui va (chiffres → tuiles, statuts → chips, métadonnées → `lia-kv` dans sa section jamais en corps entier, procédure → étapes, comparaison → colonnes ou table), un callout de clôture dès qu'il y a conseil, réserve ou suite — et une heuristique 3 : la forme suit LES DONNÉES de la réponse, jamais la forme des réponses précédentes. Seule une salutation, une réponse d'une phrase ou une question en retour reste un `<p>`. Mesuré après (conversation vierge, en pipeline comme en ReAct) : chaque réponse à données porte `<h2>` + callout + tuiles ou chips.

**Un document qui ne s'indexe pas dit pourquoi, dans la langue de la personne** ([ADR-055](docs/architecture/ADR-055-RAG-Spaces-Architecture.md), amendement). Mesuré en production : neuf PDF déposés dans un espace neuf, tous refusés « No text content extracted », le message brut en info-bulle — des scans sans couche texte, et le pipeline n'exécute aucune reconnaissance de caractères (vérifié dans le conteneur : un PDF texte s'extrait, un PDF image rend une chaîne vide). `rag_documents.error_code` porte un vocabulaire clos (`RAGDocumentErrorCode` : `file_missing`, `extraction_failed`, `scanned_pdf_no_text_layer`, `no_text_content`, `no_chunks`, `too_many_chunks`, `retries_exhausted` — la lettre morte du job durable), écrit par `_mark_document_error` à côté du message technique sur chaque échec et effacé par un succès ou une remise en file ; une extraction vide est classée par `classify_empty_extraction` (un PDF dont une page porte une image → scanné). Le front miroir le vocabulaire (`lib/rag-spaces/document-errors.ts`, tenu égal au dos par un test) et explique l'échec sous la ligne du document — le scan avec son remède : déposer le fichier sur Google Drive, l'ouvrir avec Google Docs (le texte est reconnu), puis ajouter ce Google Doc à l'espace par sa source Drive, qui l'importe en texte. Un échec sans code garde l'info-bulle. L'OCR lui-même n'est pas ajouté : une décision à part, laissée ouverte par écrit.

**Un visage qui ne rejoue jamais deux fois la même chose** ([ADR-294](docs/architecture/ADR-294-A-Face-That-Never-Plays-The-Same-Twice.md), amendant ADR-264, ADR-252, ADR-240). Mesuré sur le vrai widget dans un vrai Chromium : les saynètes n'étaient jamais vues (l'attente tirée UNE fois à la construction, sur l'horloge du rig, remise à zéro par chaque navigation ; un tirage tombé pendant une pensée perdu), 27 allumages de « l'encre » des sourcils et de la bouche en cinq minutes, chaque battement de bouche sur la même courbe, le sourcil épinglé au haut de la BOÎTE de l'œil, trois minuteurs indépendants produisant un événement facial toutes les cinq à huit secondes sans rythme. Désormais une saynète attend en temps de REPOS sur une horloge que l'hôte garde (`SketchClock`, une par document, jamais pour un aperçu ; la première après 20-40 s de repos, les suivantes 45-120 s ; les trois dernières jouées ne sont jamais retirées tout de suite ; toute saynète qui regarde de côté tourne la TÊTE après les yeux) ; les sourcils sont posés SUR l'œil (bord visible après échelle et paupière), ont du poids (épaisseur dérivée de leur hauteur et de leur arc, à encre constante), se froncent (`browX` par sourcil), mènent (groupe de dynamique propre, en avance sur l'œil à chaque préréglage) et suivent le sourire ; chaque sourcil a sa propre animation (une mimique d'un côté est écrite une fois et RETOURNÉE par l'hôte) ; la bouche glisse (`mouthX`) et **parle** : une parole GÉNÉRÉE, jamais bouclée (`rig/speech.ts` — syllabes, mots, respirations, une forme par mot, un mot accentué que les sourcils marquent et que la tête ponctue) ; aucune performance n'est identique (`choreo.warpTapes` : un rythme par performance, une gigue par canal) ; chaque mimique a sa propre détente ; les mimiques viennent en phrases, pas en cadence, et le visage RÉPOND aux yeux ; les transitions sont lissées (la traction de la pose monte progressivement à la passation, le clignement-masque tient fermé jusqu'après l'échange de visage). 61 canaux (`mouthA`, `browA×2` retirés ; `mouthX`, `browX×2`, `browS×2` ajoutés).

**Le catalogue de la page d'accueil est rééquilibré** : 46 → 58 capsules (douze découpes — rappel téléphonique, modèles de compte rendu, réponses conservées, visage d'humeur, réveil et moments proactifs, cycle des habitudes, routines conditionnelles, délégation du tableau, espaces par libellé Gmail, partages et retenue entre pairs ; le chapitre des pairs passe de une à trois cartes), une bande de longueur commune (rapport 1,4 entre la plus courte et la plus longue capsule française contre dix auparavant), tutoiement dans les six langues, et `catalog_hint` / `detail_hint` interpolent `{{count}}` depuis la longueur réelle du chapitre — les cinq comptes tapés à la main étaient faux.

### Added

- **ADR-291** : `bookmarks/{indexing,projection}.py`, `core/i18n_bookmarks.py`, `rag_spaces/document_names.py`, `infrastructure/scheduler/rag_maintenance.py` ; migration `d5e0a2b4f6c8` (`message_bookmarks.rag_document_id`, `index_state`, `indexed_at`, index sur `updated_at`) ; constantes `BOOKMARKS_SPACE_KIND`, `BOOKMARKS_DOCUMENT_CONTENT_TYPE`, `BOOKMARKS_DOCUMENT_EXTENSION`, `BOOKMARKS_DOCUMENT_NAME_EXCERPT_CHARS`, `RAG_DOCUMENT_NAME_MAX_CHARS` ; `kind` sur la forme de fil de l'espace, `index_state`, `indexed_at`, `index_usage` sur celle du bookmark ; métrique `bookmark_index_total{outcome}` (tableau 18) ; front `BookmarkCard` (état d'indexation et coût), `SpaceCard` (espace tenu par un rôle), types `BookmarkIndexState`.
- **ADR-292** : `domains/shared/portrait_sources.py`, `{memories,interests,habits,relations/debrief}/portrait_source.py`, `journals/portrait_sources.py`, `memories/emotional_state.py`, prompt `journal_portrait_source_lines.txt` ; migration `e6f1b3c5a7d9` (`users.journal_portrait_sources`, JSONB, classée SCRUBBED) ; réglages `JOURNAL_PORTRAIT_FULL_MAX_TOKENS`, `JOURNAL_PORTRAIT_BRIEF_MAX_TOKENS`, `JOURNAL_CONSOLIDATION_MEMORIES_MAX`, `JOURNAL_CONSOLIDATION_INTERESTS_MAX`, `JOURNAL_CONSOLIDATION_DEBRIEFS_MAX`, `JOURNAL_CONSOLIDATION_SOURCE_ITEM_MAX_CHARS`, `JOURNAL_CONSOLIDATION_SOURCES_MAX_CHARS` (constantes, config, quatre `.env`) ; métrique `journal_portrait_sources_total{source,status}` (tableau 23) ; front `PortraitCard`, `PortraitProvenance`, `useJournals` (provenance), six locales.
- **ADR-293** : `agents/nodes/router_tool_scoring.py` (`GLOBAL_RANKING_KEY`, `score_tools_for_turn`), `SemanticToolSelector.embed_query` / `rank_tools` / `select_tools(query_embedding=)`, `ReactToolSelector.select(ranking=)`, `bound_tool_tokens`, `react_context.build_setup_blocks` ; réglage `REACT_TOOL_SEMANTIC_TOP_K` (constante, config, quatre `.env`), constante `CATALOGUE_DOMAIN_COVERAGE_TOP_N` (lue par les deux modes) ; métriques `react_tools_bound`, `react_bound_tool_tokens` (tableau 20, panneaux 64-65) ; harnais `scripts/react/measure_tool_selection.py` et tâche `react:selection:measure` (rejoue les tours d'un exploitant à travers `ReactToolSelector.select`, n'en conserve aucun).
- **ADR-177** : `LiaRuntimeContext.voice_enabled`, `runtime_voice_enabled`, `build_runtime_context(user_voice_enabled=)`, `execute_graph_stream(user_voice_enabled=)`, `voice_stream_helpers.voice_preference_of` ; `html_response_directive.txt` réécrit (heuristiques 1-3, exemple canonique composé, 80 lignes).
- **ADR-055** : `RAGDocumentErrorCode`, `classify_empty_extraction`, `PDF_CONTENT_TYPE` ; migration `a7c3e5b9d1f2` (`rag_documents.error_code`) ; `error_code` sur `RAGDocumentResponse` et `RAGDocumentStatusResponse` ; front `lib/rag-spaces/document-errors.ts`, `DocumentRow` (phrase sous la ligne), locales `spaces.documents.errors.*` ×6.
- **ADR-294** : `eyes/rig/speech.ts` (parole générée), `SketchClock`, `choreo.warpTapes` / `withRelease` / `flipTapes`, `browStretchFor`, `maskBlinkTapes`, `rig.answerIn` ; canaux `mouthX`, `browX×2`, `browS×2` ; `.lia-eye-brow` ancré au bord visible (`eyes.css`).
- Accueil : douze capsules `landing.features.*` neuves (`telephony_callback`, `meeting_templates`, `bookmarks`, `mood_face`, `proactive_wake`, `proactive_moments`, `habits_lifecycle`, `conditional_routines`, `workboard_delegation`, `mail_label_spaces`, `peer_shares`, `peer_safety`) ×6, `catalog_hint` / `detail_hint` interpolés.

### Changed

- Le faucheur RAG (`rag_job_reaper`) et le rattrapage des bookmarks partagent un tick (`rag_maintenance_tick`), le faucheur d'abord ; `BookmarkService` réclame puis projette après commit ; `unprojected_ids` sert le lot le moins récemment tenté ; `set_index_state` rend le nombre de lignes.
- La consolidation des journaux lit les quatre sources et persiste la provenance dans le même UPDATE ; `journal_consolidation_prompt.txt` porte les sections sources en placeholders et l'ÉTAPE 7 ; l'éligibilité se rouvre quand une source a bougé.
- Le routeur délègue son scoring à `score_tools_for_turn` (classement sur tout tour planificateur avec pivot, scores de domaine sous domaines) ; le nœud de mise en place ReAct monte ses blocs par `build_setup_blocks` (mémoire, références, modèle utilisateur, directives des journaux, connaissances, compétences, dégradations, avis MCP) et journalise `bound_tool_tokens` et `has_knowledge_context` ; `normal_filtering._DOMAIN_COVERAGE_TOP_N` lit la constante partagée.
- `_should_inject_html_directive(display_mode, route_to, voice_enabled)` ; le panneau de debug ne construit sa section « sélection d'outils » que sur les scores calibrés du planificateur.
- `_mark_document_error(…, code=)` sur les six sites du pipeline ; `fail_or_retry_document` écrit `retries_exhausted` à la lettre morte et rien sur une reprise ; `requeue_documents_for_reindex` efface le code avec le message ; `GUIDE_RAG_SPACES.md` documente le vocabulaire et la limite des PDF scannés.
- Rig des yeux : groupe de dynamique `brow`, avance de la bouche 45 → 30 ms, aura à 100 ms, mélange de ressort à la passation (`SPRING_BLEND_MS`), marge de la bulle 1,25 → 1,5 em ; les mimiques en phrases (silence 8-16 s, suite 1,2-2,5 s un tiers du temps).
- `docs/technical/LANDING_PAGE.md` ne cite plus de nombre de fiches ; `.env.example` corrige le défaut affiché de `REACT_AGENT_MAX_TOOLS` (100, pas 25).

### Fixed

- Une réponse conservée n'était jamais cherchée : ni indexée, ni visible de la boucle ReAct (qui n'avait pas les connaissances du pipeline) ; le rattrapage par création affamait les autres comptes ; un bookmark supprimé pendant sa projection laissait un document orphelin ; un rollback après `flush` perdait le rendu (MissingGreenlet) ; `html_to_markdown` gardait le texte des `<script>`/`<style>`.
- Le plafond d'outils ReAct coupait toujours les mêmes familles (ordre d'enregistrement) ; les outils individuels d'un serveur MCP itératif n'étaient jamais classés ; la porte de délégation `_task` d'un serveur étendu tombait sous la pertinence ; un tour actionnable sans domaine détecté liait toute la liste ; un `tool_selection_result` ne portant que le classement vidait tout le panneau de debug du tour (KeyError attrapé un niveau plus haut).
- En mode `html`, un tour conversationnel d'un compte sans voix restait en Markdown ; des réponses outillées en `<p>` + `dl.lia-kv` se lisaient comme du Markdown.
- Un PDF scanné était refusé « No text content extracted », en anglais, sans cause ni remède ; le rejeu des migrations signalait un `modify_comment` sur la colonne neuve (commentaire miroir sur le modèle).
- Visage : saynètes jamais vues, encre des organes qui clignote, courbe de bouche apprise en une minute, sourcil flottant au-dessus d'un dôme de joie, événements faciaux sans rythme, nouveaux yeux révélés en plein morph ; `tapeSpringIn` imposait le ressort d'une bande AVANT sa première clé.
- Accueil : cinq comptes de capsules tapés à la main étaient faux ; une capsule de 1 529 caractères face à une de 159 alignait une rangée entière sur la plus haute.

### Tests

- Unitaires : `bookmarks/{test_indexing,test_models}`, `core/test_i18n_bookmarks`, `rag_spaces/{test_document_names,test_wire_shape_parity,test_document_error_codes}`, `scheduler/test_rag_maintenance`, `shared/test_portrait_sources`, `{memories,interests,habits,relations}/test_*portrait_source`, `journals/{test_portrait_sources_assembly,test_portrait_provenance_schema,test_consolidation_scaffolds}`, `startup/test_portrait_sources_boot`, `agents/nodes/{test_react_knowledge_parity,test_router_tool_scoring}`, `agents/services/{test_tool_selector_ranking,test_react_tool_selector_relevance}`, `streaming/test_debug_metrics_tool_selection`, `test_response_node_html_gating` (garde à trois signaux), `test_runtime_context` (champ et accesseur), `test_voice_gating` (`voice_preference_of`), `test_processing` (classification, code écrit et effacé), `test_html_directive_css_sync` (80 lignes ≤ 96) ; caractérisation `tests/agents` (le graphe reçoit la préférence vocale) ; intégration PostgreSQL bookmarks (collision, nombre de lignes du lien, le moins récemment tenté) et `rag_spaces/test_jobs_repository` (lettre morte nommée, reprise sans code, requeue effaçant le code).
- Front : `PortraitCard`, `PortraitProvenance`, `DocumentRow` (phrase traduite, repli sur l'info-bulle, code inconnu), `SpaceCard`, `useSpaceDocuments`, `catalog-hint`, `editorial-content-coverage` ; suite des yeux 515 → 546 tests sur 27 fichiers (`speech`, `sketches`, `choreo`, `organs`, `runtime`, `useEyesRig`…).
- Mesuré sur Docker dev : une réponse conservée retrouvée en ReAct (62 outils liés sur 114, bonne réponse en deux itérations) ; garde HTML sur deux tours conversationnels identiques (voix off → `lia-response`, voix on → Markdown) ; PDF image → `scanned_pdf_no_text_layer`, texte vide → `no_text_content` ; page composée sur quatre formes de question en pipeline et en ReAct.

## [1.45.0] - 2026-09-16

**Le téléphone devient un canal : LIA appelle la personne, et l'appel revient dans le chat comme son propre message** ([ADR-290](docs/architecture/ADR-290-Phone-As-A-Channel-Owner-Calls.md)). La téléphonie agentique d'ADR-127 appelait un tiers sous carte de confirmation, parce que la carte protège quelqu'un qui n'a rien demandé ; quand LIA appelle _la personne elle-même_, celle qui confirmerait est celle qui décroche — à condition que le numéro soit prouvé le sien. L'identité est donc un numéro déclaré dans les réglages (_Téléphonie · Mon identité_, affiché entier, chiffré comme l'adresse), puis **vérifié par un appel** où LIA lit un code que la personne retape (tentatives bornées, code lié au numéro, comparaison en temps constant, plafond horaire partagé avec tout appel payant) — jamais une correspondance de nom, et l'outil tiers refuse ce numéro. `call_me_tool` est `reversible` avec sa raison écrite, si bien qu'une routine peut le planifier (« appelle-moi à huit heures avec mon agenda »). Le **même** agent fournisseur sert trois mandats — le tiers cuit dans l'agent, le titulaire et la vérification envoyés en override par appel, rendu côté serveur (`mandates.py`, un mandat par `CallKind`, vérifié au boot) — et la permission d'override entre dans l'empreinte de l'agent, dont la synchronisation devient OBLIGATOIRE pour un override. L'appel emporte le contexte du chat sous budget de jetons (`self_call_context.py` : mémoires, agenda, rappels, boucles ouvertes, derniers échanges — sections dans un ordre déclaré, coupes annoncées, chaque lecture inscrite sur la surface `phone_call`), et la personne l'éteint d'un interrupteur. Quand l'appel finit, ce qui a été dit **revient comme le tour de la personne** : le transcript est synthétisé puis rejoué par le moteur hors-tour (`phone_relay_runner.py`, `StreamRequest.spoken_by_person`, origine `phone_call` VISIBLE) — mémoire, journaux et profil s'exécutent comme dans le chat, le message porte un badge téléphone, un brouillon produit attend sa confirmation dans le chat, les cartes se dessinent en `lia-card`. Le relais est **réclamé** `RELAYING` avant le tour et réglé par mise à jour conditionnelle ; une ligne périmée est rendue au faucheur de notifications ; **dix verdicts** (`RelayOutcome`) sont comptés, stockés et dessinés sur la liste des appels — dont `unanswered` et `call_failed`, ajoutés parce qu'en production un appel mort au décroché avait été rapporté comme « quelqu'un d'autre a répondu ».

**Le téléphone lit tout ce que le chat lit — et n'agit sur rien** (ADR-290, lots 7-8 ; décision du propriétaire, 2026-09-16). Derrière `TELEPHONY_LIVE_TOOLS_ENABLED`, l'agent vocal consulte LIA en direct pendant l'appel par des webhook tools rattachés à l'agent le temps de l'appel du titulaire — mesuré sur un appel réel, le fournisseur refuse `tool_ids` dans l'override par appel et la conversation meurt au décroché — puis détachés à la fin et encore avant tout appel tiers. Le rappel `POST /telephony/tools/{name}` n'a pas de session : il n'ouvre que pour un appel du titulaire vivant, avec un jeton DÉRIVÉ du secret de webhook, sous budget par appel, tout refus lisant « introuvable ». Quels outils ? Non plus une allowlist de trois noms mais une **règle sur le catalogue** (`derive_live_tool_specs`) : tout outil qui ne fait que lire (catégorie `search` ou politique `read` explicite — jamais le repli `readonly` où siège le bac à sable), pas `system`, hors exécuteur du pipeline, d'un domaine que le téléphone offre (`shared/phone_domains.PHONE_DOMAINS`, 22 domaines dans le vocabulaire du registre) et dont les paramètres obligatoires se disent à la voix — 55 outils sur le vrai catalogue (mails, agenda, disponibilités, tâches, rappels, contacts, fiche 360°, fichiers, documents, lieux, itinéraires, météo, workboard, web…), plus `recall_memories`, recherche NATIVE dans la mémoire que le chat injecte lui-même. Le résultat est **réduit à ce qu'une voix peut dire** avant la pagination d'ADR-286 (`voice_projection.py` : identifiants, liens et câblage retirés, une valeur imbriquée dite par sa forme parlée, une liste d'enregistrements comptée) — mesuré en production, quatre événements d'un week-end étaient renvoyés et l'agent n'en entendait qu'un, le JSON brut d'un seul mangeant le budget. Chaque euro d'un appel tombe sous **un run id dérivé de l'appel** (`telephony/spend.py`) — les recherches en direct sous un `TrackingContext` dont le callback voyage sur la config du runtime synthétique, la synthèse, le tour relayé — si bien que la ligne `message_token_summary` que le compteur du chat lit déjà est la facture de l'appel : sur la bulle de la réponse relayée, et sur la liste des appels (`usage`). C'est la facture de ce que LIA paie, et rien d'autre, par décision : le LLM vocal, la synthèse vocale, la reconnaissance et la ligne tournent sur la clé ElevenLabs de la personne (`cost_bearers`) et ne sont ni comptés ni affichés — mesuré sur un appel de 198 s, vingt fois plus que ce que LIA dépense. La personne **désactive des domaines** pour ses appels (`users.phone_disabled_domains`, l'ensemble DÉSACTIVÉ pour qu'un domaine offert plus tard soit actif par défaut ; un interrupteur par domaine dans _Mon identité_), le chemin de composition ne rattache que ce qui reste, et le rappel relit ses interrupteurs sur sa ligne à chaque appel. Le prompt du titulaire nomme les DOMAINES qu'il peut consulter, en mots. Et la **personnalité** configurée pour LIA parle aussi au téléphone (lot 9) : la même instruction que le chat, rendue dans le prompt du titulaire et passée en variable dynamique à l'agent tiers — elle colore la manière de parler, jamais ce que l'agent peut faire.

**Ce que l'agent vocal a dans la voix appartient au portail ElevenLabs** (ADR-290, deux mesures réelles en production). Le premier appel de vérification réel a été refusé : la synchronisation obligatoire épinglait un `llm`, et le fournisseur FUSIONNE un PATCH avec ce que l'agent stocke — ici le `reasoning_effort` choisi sur le portail — puis valide la paire (« Not supported reasoning effort »). Décision du propriétaire, élargie à la seconde mesure : le modèle et son effort de raisonnement, la langue, la voix, le format audio et le plafond de durée sont administrés sur le portail, pour l'agent, sans relancer l'application ; six réglages sont supprimés ; LIA n'envoie que ce qui lui est propre (nom, prompt, premier message, outils système, contrat `data_collection`, permission d'override pour les deux champs qu'un mandat rend par appel) et l'empreinte ne couvre que cela — un changement sur le portail ne déclenche jamais de synchronisation, une synchronisation n'écrase jamais le portail.

### Added

- **ADR-290** : `telephony/{phone_numbers,identity,verification,errors,mandates,payload,synthesis_usage,budget,self_call_context,self_call_relay,owner_call,live_tools,spend}.py`, `agents/telephony/{live_tools,live_tools_router,voice_projection}.py`, `agents/tools/telephony_self_tools.py` (`call_me_tool`), `shared/phone_domains.py`, `users/phone_identity_columns.py`, `infrastructure/scheduler/phone_relay_runner.py` ; routes `GET/PATCH /telephony/identity`, `PUT/DELETE /telephony/identity/number`, `POST /telephony/identity/verify`, `POST /telephony/identity/confirm`, `POST /telephony/tools/{name}` ; quatre migrations (`f1a6c8e4d2b3` identité, `a2b7d9f1c3e5` `call_kind`, `b3c8e0f2d4a6` index `RELAYING`, `c4d9f1a3e5b7` domaines désactivés) ; `CallKind {THIRD_PARTY, SELF, VERIFICATION}`, `NotificationStatus.RELAYING`, `ReturnSynthesisStatus.SKIPPED`, `RelayOutcome` (dix valeurs) ; `StreamRequest.spoken_by_person`, `RunOrigin.hidden` ; prompts `telephony_self_call_system_prompt`, `telephony_self_call_relay_prompt`, `telephony_verification_prompt`, `telephony_self_call_lines`, `telephony_live_tools`, `telephony_live_tool_lines` ; surface de consultation `phone_call` (une section par domaine).
- Réglages (constantes, config, quatre `.env`) : `TELEPHONY_VERIFICATION_CODE_LENGTH`, `TELEPHONY_VERIFICATION_CODE_TTL_SECONDS`, `TELEPHONY_VERIFICATION_MAX_ATTEMPTS`, `TELEPHONY_SELF_CONTEXT_MAX_TOKENS`, `TELEPHONY_RELAY_TRANSCRIPT_MAX_TOKENS`, `TELEPHONY_RELAY_TIMEOUT_SECONDS`, `TELEPHONY_RELAY_BUSY_RETRIES`, `TELEPHONY_RELAY_BUSY_DELAY_SECONDS`, `TELEPHONY_RELAY_MAX_AGE_MINUTES`, `TELEPHONY_LIVE_TOOLS_ENABLED`, `TELEPHONY_LIVE_TOOL_TIMEOUT_SECONDS`, `TELEPHONY_LIVE_TOOL_RESULT_MAX_TOKENS`, `TELEPHONY_LIVE_TOOL_MAX_CALLS_PER_CALL` ; constantes `TELEPHONY_LIVE_TOOL_DESCRIPTION_MAX_CHARS`, `TELEPHONY_LIVE_TOOL_PROVISIONING_CONCURRENCY` ; familles Redis `telephony_verify:`, `telephony_verify_attempts:`, `telephony_verify_starts:`, `telephony_live_tool:` (USER_RUNTIME).
- Métriques `telephony_relay_total{outcome}`, `telephony_live_tool_calls_total{tool,outcome}`, `telephony_live_tool_duration_seconds{tool}` — tableau 24, panneaux 10-13.
- Front : section _Téléphonie · Mon identité_ (`TelephonyIdentitySection`, `useTelephonyIdentity` : numéro, vérification en deux temps, interrupteur de contexte, un interrupteur par domaine), badge `PhoneOriginMark` sur le message relayé, bannière « LIA t'appelle », badges de mandat, de verdict de relais et facture cumulée sur la liste des appels ; types `TelephonyIdentity`, `TelephonyCallUsage`, `RelayOutcome` ; tonalités `relayOutcomeTone` ; lexique `telephony-identity` ; six locales.
- `client.set_agent_tool_ids`, `client.create_tool`, `client.delete_tool(force)`, `override_permissions()` ; `attach_live_tools` / `detach_live_tools` / `live_tools_attached` (métadonnée `live_tools_attached`) ; `extract_data_block(reshape=)` ; `auto_save(user_id=)` pour un outil hors graphe ; `ToolDependencies` sur le runtime synthétique.
- Phrases de retour en six langues : `relay_answered`, `relay_drafts_waiting`, `relay_unanswered`, `relay_call_failed`, `relay_not_owner`, `relay_empty`, `relay_pending_question`, `relay_busy`, `relay_quota_blocked`, `relay_failed`, `self_call_title` ; message `phone_domain_unknown`.

### Changed

- `TelephonyService.initiate_call` prend `kind`, `user_context`, `verification_code`, `live_tools` ; la synchronisation de l'agent est obligatoire pour un override (`agent_sync_failed`) ; `_arm_live_tools` rattache les outils avant un appel SELF et détache avant tout autre ; le mandat est lu par appel.
- `_agent_config_body` / `agent_config_fingerprint` ne portent que ce qui est à LIA : ni `llm`, ni `reasoning_effort`, ni `language`, ni `tts`, ni `asr`, ni `conversation.max_duration_seconds` ; l'override d'un appel = `{"agent": {"prompt": {"prompt"}, "first_message"}}`.
- `card_surface()` rend PLAIN sur une origine cachée seulement : un tour relayé (`phone_call`, visible) dessine des `lia-card`.
- `_is_live_owner_call` et le budget de recherches lisent `TELEPHONY_STALE_CALL_TIMEOUT_MINUTES` (le plafond de durée est celui du portail).
- Le prompt tiers reçoit `{{personality_profile}}` et nomme tout outil de recherche rattaché comme réservé aux appels du titulaire ; le prompt du titulaire porte `{personality_block}` et `{live_tools_block}` par domaines, sans plafond en minutes.
- `TELEPHONY_LIVE_TOOL_RESULT_MAX_TOKENS` 800 → 2 000 (dépensés en mots depuis la projection vocale), `TELEPHONY_LIVE_TOOL_MAX_CALLS_PER_CALL` 20 → 40.
- `TelephonyIdentityUpdateRequest` accepte `rich_context_enabled` et/ou `disabled_domains` ; `TelephonyIdentityResponse` publie `disabled_domains` et `available_domains` ; `TelephonyCallSummary` porte `call_kind`, `relay_outcome` et `usage`.
- `track_proactive_tokens` reçoit `run_id=` de la synthèse ; le relais et les recherches en direct partagent `phone_call_run_id(call_id)`.
- Plancher de couverture 72 → 73 (mesuré 75 %).

### Removed

- `TELEPHONY_AGENT_LLM_MODEL`, `TELEPHONY_AGENT_TTS_MODEL_ID`, `TELEPHONY_AGENT_VOICE_ID`, `TELEPHONY_AGENT_AUDIO_FORMAT`, `TELEPHONY_MAX_CALL_DURATION_SECONDS`, `TELEPHONY_SELF_CALL_MAX_DURATION_SECONDS`, `TELEPHONY_VERIFICATION_CALL_MAX_DURATION_SECONDS` et leurs constantes ; `vendor_language`, `MandateInputs.live_tool_ids`, l'allowlist `LIVE_TOOLS` typée à la main.

### Fixed

- Un appel mort au décroché était rapporté « quelqu'un d'autre a répondu » : `FAILED` → `CALL_FAILED`, `NO_ANSWER`/`VOICEMAIL` → `UNANSWERED`, chacun avec sa phrase, son libellé et sa tonalité.
- La synchronisation de l'agent refusait chaque appel de vérification (« Not supported reasoning effort ») : plus aucun réglage n'épingle un bouton du portail.
- Les outils en direct nommés dans l'override tuaient l'appel au décroché (« Tool IDs not attached to this agent ») : rattachement au niveau de l'agent.
- Un résultat d'agenda de quatre événements n'en montrait qu'un à l'agent vocal (JSON brut sous un budget de 800 jetons) : projection vocale puis pagination.
- Le code de vérification est lié au numéro (`numéro|code`) ; un chiffre non ASCII est refusé plutôt qu'une 500 ; « Rappeler » refusé par le plafond garde le code en cours ; un outil connecteur hors graphe reçoit `ToolDependencies` et `auto_save` connaît son utilisateur.
- Les derniers échanges d'un appel du titulaire sont aplatis en texte parlable (`markdown_to_plain_text`).

### Tests

- 28 fichiers de tests unitaires téléphonie/agents/scheduler (identité, vérification, mandats, composition, relais, appel du titulaire, outils en direct des deux moitiés, projection vocale, dépense, routeur de rappel, config) ; intégration `test_identity_verification.py` et `test_repository.py` ; front `TelephonyIdentitySection`, `TelephonyCallsSection`, `useTelephonyIdentity`, `useTelephonyCalls`, `status-tone`, `ChatMessage` (badge téléphone), `ActiveCallBanner`, `settings-search`.
- Mesuré en production (2026-09-16) : trois appels réels (vérification 19 s ; titulaire 179 s avec quatre recherches, relais `answered` en 38 s ; titulaire 198 s avec huit recherches) ; soixante webhook tools créés et rattachés sur un agent jetable sans plafond.

## [1.44.7] - 2026-09-16

**Un résultat d'outil arrive item par item, sous un budget de tokens, et la coupe est annoncée** ([ADR-286](docs/architecture/ADR-286-Tool-Result-Projected-Per-Item-Under-A-Token-Budget.md)). Relu depuis le checkpoint d'un tour ReAct « recherche mes 5 derniers emails » (2026-09-15), le bloc de données que le modèle recevait était un dump JSON coupé à 8 000 **caractères** — un littéral posé à la naissance du mode ReAct, jamais réglé, jamais annoncé, jamais testé. Un message Gmail `format=full` porte son arbre natif (en-têtes SMTP, parties MIME, corps base64 : 85 à 98 % de l'item, 12 000 à 130 000 caractères, tokenisé à 1,45 caractère par token) **avant** ses champs lisibles : les 8 000 caractères partaient dans les en-têtes et le base64 du premier e-mail, et le modèle ne lisait ni sujet, ni identifiant, ni date d'aucun message — sa propre pensée disait « payloads systématiquement tronqués après le 1er item ». Onze itérations au lieu d'une, ~74 000 tokens de contexte, une réponse fausse sur deux entrées sur cinq ; et ses trois replis étaient morts (la liste de contexte coupée pareil, le moteur de requête locale offert au ReAct sans son registre, la résolution de référence en `TypeError` depuis la v1.0.0). Désormais le résultat est **projeté item par item** : un item admis est complet, le bloc reste du JSON valide, les scalaires voyagent entiers, au moins un item passe ; le budget est en **tokens**, `min(REACT_TOOL_RESULT_MAX_TOKENS, fenêtre du slot × REACT_TOOL_RESULT_WINDOW_FRACTION)` ; la coupe est **dite** au modèle (combien sur combien, la voie vers le reste) après la balise de contenu externe, et **comptée** (`react_tool_result_truncated_total`, dashboard 20). L'arbre natif ne quitte plus le builder d'e-mails, le manifeste cesse de publier un chemin qu'aucun item n'a jamais porté, `local_query_engine_tool` est réservé au pipeline, `resolve_reference` répond.

**Le contenu d'un e-mail arrive propre, à trois niveaux de détail, condensé une fois par message** ([ADR-287](docs/architecture/ADR-287-Email-Content-First-Detail-Levels-Digests-And-Neutral-Message.md)). L'assistant raisonne sur le **contenu** de dix ou vingt e-mails — « résume mes non lus », « une synthèse des newsletters de la semaine », les routines et les notifications qui ont besoin du corps — et ce qu'il lisait était le format Gmail imité par les deux autres fournisseurs : un `payload.headers` fabriqué par Graph et par IMAP, un corps Outlook en HTML brut converti tard, un corps Apple aplati par une regex qui perdait paragraphes et liens ; chaque réponse d'un fil citait tout son historique, signature comprise ; un seul niveau de détail borné à 1 500 caractères, ni assez pour lire ni assez léger pour lister ; deux outils hérités que plus aucun catalogue n'offrait. Désormais les trois normaliseurs produisent **un vocabulaire neutre** (`EmailMessage` : corps texte, jamais HTML ni base64, une seule conversion), **la citation et la signature quittent le corps au bord du client** (marqueurs en six langues, gardiens pour un « Merci ! » nu et pour les réponses entrelacées ; mesuré 48/48 sur un corpus de 48 corps, contre 22/48 pour la bibliothèque tierce candidate, qui reste au dehors sur mesure), et `get_emails_tool` reçoit **`detail`** : `metadata` pour lister sans corps, `full` (défaut) pour lire un corps propre **paginé au paragraphe** (`body_part`/`body_parts`, jamais coupé en milieu de phrase), `summary` pour raisonner sur des **condensés** — l'essentiel, les points clés, les actions, la catégorie, l'importance — calculés **une fois par message** par un petit slot sans raisonnement, mis en cache trente jours, refusés par les plafonds de dépense, jamais inventés quand le modèle échoue. La pagination est opaque pour les trois fournisseurs, `result_size_estimate` est nommé estimation, et la carte d'e-mail dessine le condensé en six langues. Mesuré sur la vraie boîte en mode ReAct : « fais un résumé de mes 6 derniers emails » en deux itérations, six condensés, 3 934 tokens de résultat — et la mesure a trouvé que ces six appels n'atteignaient **aucun registre de dépense** (le `RunnableConfig` du tour n'était pas tendu à la porte structurée), ce qui est corrigé et testé.

**Plusieurs brouillons dans un tour se relisent un par un** ([ADR-288](docs/architecture/ADR-288-Independent-Drafts-Reviewed-One-At-A-Time.md)). Mesuré sur Docker dev le 2026-09-16 : « envoie un email à X pour lui dire que tout va bien et un email à Y pour penser à appeler Hua » produisait deux brouillons, **une** question sur le premier, et « Valider » envoyait les deux — le second jamais montré sur une carte, jamais modifiable ; « Modifier » ne réécrivait que le premier. La file des brouillons portait une sémantique de LOT écrite pour FOR_EACH et appliquée à tout tour à plusieurs brouillons, quel que soit le domaine, en pipeline comme en ReAct ; un lot mélangé rendait un événement en « 📧 Email » sans libellé. Désormais un lot n'est confirmé d'un bloc que s'il est **pré-approuvé** (les items d'un FOR_EACH que la personne a approuvé dans ce tour, d'un seul type) ; tout le reste se relit **un brouillon par interruption**, avec sa carte, son édition et sa position (« Brouillon 2 sur 3 », en six langues), les décisions étant exécutées ensemble après la dernière réponse, chacune sous son type — et un brouillon annulé est rapporté, jamais perdu en silence. Un ticket suit la même règle : l'approbation du premier le laisse passer, le second est redemandé.

**Un brouillon et son résultat sont décrits une fois et dessinés par surface** ([ADR-289](docs/architecture/ADR-289-Draft-Surfaces-Drawn-From-One-Description.md)). Dans le chat, la carte à confirmer et le compte rendu d'exécution sont désormais des cartes `lia-card` — en-tête, illustration, champs iconés, corps en bloc — dessinées avec les classes que les cartes de données utilisent déjà ; sur un ticket, rien ne change, le Markdown du lot 13 reste et il est identique au caractère près (le filet « golden » n'a pas bougé). Une suite de brouillons s'ouvre sur « N brouillons à relire » et la liste de ce que le tour a préparé, sans clic de plus. Et le compte rendu d'un lot dit enfin **à qui et quoi** : chaque ligne porte les champs clés de son type (destinataire, lieu, date, e-mail, téléphone…) et un extrait borné du texte envoyé.

### Added

- **ADR-289** : `drafts/card_spec.py` (`Row`, `Note`, `Block`, `CardSpec`, `ResultItem`, `ResultSpec`, `to_markdown_lines`), `drafts/card_html.py` (`CardSurface`, `card_surface`, `to_html_card`, `to_html_result`), `build_card_spec`, `describe_execution_result`, `HitlMessages.get_draft_sequence_summary`, `sequence_drafts` sur le payload de la première interruption d'une suite, `DRAFT_RESULT_EXCERPT_MAX_CHARS` ; tests `test_card_spec.py`, `test_card_html.py`, `test_result_renderer_cards.py`, les cas de sommaire dans `test_hitl_dispatch_sequence.py` et `test_draft_critique_sequence.py`, et la garde `test_interaction_registry_bindings.py` (chaque interaction HITL enregistrée est la CLASSE de son module — un helper glissé entre le décorateur et la classe avait enregistré une fonction, invisible à tout test unitaire, visible au seul démarrage du conteneur).
- **ADR-288** : `nodes/draft_sequence.py` (`decision_entry`, `advance_sequence`, `settle`, les clés d'état du brouillon), `is_pre_approved_lot` (`nodes/for_each_hitl_prep.py`), `pending_drafts_grouped` et `confirmed_drafts` dans `MessagesState`, `HitlMessages.get_draft_sequence_position`, `sequence_index`/`sequence_total` sur le payload de critique, `cancelled_count` dans le résultat de lot, `MIXED_BATCH_TYPE` ; tests `test_hitl_dispatch_sequence.py`, `test_pre_approved_lot.py`, `test_draft_executor_sequence_batch.py`, `test_result_renderer_sequence.py`, `test_draft_critique_sequence.py`.
- **ADR-287** : `EmailMessage` / `EmailAttachment` (`normalizers/email_message.py`), `html_to_text` / `strip_html_to_line` (`normalizers/html_text.py`), `trim_quoted_reply` / `clean_reply_body` (`normalizers/reply_trimming.py`), `EmailDetail` / `coerce_detail` / `paginate_body` / `apply_detail_level` (`agents/emails/detail_levels.py`), `EmailDigest` / `EmailDigestService` / `digest_cache_key` (`agents/emails/digest.py`), `get_emails_catalogue_manifest` v3.0.0 (`agents/emails/get_emails_manifest.py`), prompt `email_digest_prompt.txt`, slot LLM `email_digest` (registre, défauts, `LLMType`, seed SQL, six locales), famille Redis `email:digest`, compteur `email_digest_cache_total{result}` et ligne « Email digests (ADR-287) » du dashboard 10, libellés `L'essentiel` / `Points clés` / `À faire` ×6 (`core/i18n_v3.py`), `FIELD_BODY_PART` / `FIELD_BODY_PARTS`, réglages `EMAILS_BODY_PART_TOKENS`, `EMAILS_DIGEST_ENABLED`, `EMAILS_DIGEST_INPUT_MAX_TOKENS`, `EMAILS_DIGEST_CACHE_TTL_SECONDS`, `EMAILS_DIGEST_CONCURRENCY`, `EMAILS_TRIM_QUOTED_REPLIES` ; `scripts/emails/measure_reply_trimming.py` et `task emails:corpus:measure` ; tests `test_email_message_contract.py`, `test_reply_trimming.py` + corpus, `test_email_search_pagination.py`, `test_detail_levels.py`, `test_get_emails_tool_detail.py`, `test_digest.py`, `test_email_card_digest.py`.
- **ADR-286** : `render_data_block`, `extract_data_block`, `compose_tool_message`, `DataBlock` (`tools/react_tool_wrapper.py`), `tool_result_token_budget` et `tool_result_budget_note` (`utils/react_budget.py`), `_tool_result_budget` (`nodes/react_nodes.py`) ; réglages `REACT_TOOL_RESULT_MAX_TOKENS` et `REACT_TOOL_RESULT_WINDOW_FRACTION` ; compteur `react_tool_result_truncated_total{tool_name}` et panneau « Tool Result Budget Cuts (by tool) » ; tests `test_react_tool_result_projection.py`, `test_resolve_reference_success.py`, `TestBuildEmailsOutputDropsTheProviderTree`, `TestLocalQueryEngineIsPipelineOnly`.
- `CALENDAR_TOOL_DEFAULT_DAYS_AHEAD` (`calendar_tool_default_days_ahead`, 30 par défaut, section [35] des trois `.env`) : la fenêtre qu'un listing d'agenda couvre quand la personne ne nomme pas de fin ; `test_calendar_search_window.py` tient le réglage, sa publication sur les deux surfaces et la parité Apple.

### Changed

- `get_emails_tool` reçoit `detail`, `page_token` et `part` ; sa réponse porte `detail`, `result_size_estimate` et `next_page_token` ; `count` compte la page.
- `search_emails` des trois clients accepte `page_token` et `headers_only` (signature du protocole, garde de parité) ; Graph refuse un jeton hors de `api_base_url` ; IMAP n'écrit pas en cache une recherche `headers_only`.
- Les normaliseurs Graph et IMAP ne fabriquent plus de `payload` Gmail ; `subject`, `from`, `to`, `cc`, `date`, `rfc_message_id` sont des champs de premier niveau ; le corps Graph HTML est converti en texte à la frontière du client ; `HTMLToTextConverter` déménage dans `normalizers/html_text.py` (les liens longs sous une étiquette technique).
- Le corps d'un e-mail normalisé perd sa citation et sa signature (`EMAILS_TRIM_QUOTED_REPLIES`, vrai par défaut) pour tout lecteur — registre, condensé, heartbeat, espace RAG suivant un libellé ; la réponse et le transfert citent toujours l'original entier.
- `GmailFormatter._extract_body` lit le `body` normalisé tel quel ; `email_card` dessine le condensé entre l'aperçu et le corps et cesse de dessiner l'aperçu deux fois ; la réponse Apple porte `In-Reply-To`/`References` (le `Message-ID` normalisé).
- `emails_agent_prompt.txt` §1 et le planificateur décrivent les trois niveaux, les parties et l'estimation ; `EMAILS_BODY_MAX_LENGTH` ne borne plus ce que le modèle lit.
- Le contrat e-mail dit la même chose sur ses trois surfaces (manifeste, planificateur, prompt d'agent) : le courrier récent sans autre précision est la boîte de réception (`in:inbox`), un message précis ajoute `in:anywhere`, et `max_results` est le nombre demandé — mesuré 2026-09-15, la même demande listait deux dossiers différents selon le mode, et un résumé « des 6 derniers » en pipeline calculait vingt condensés (`test_get_emails_contract_surfaces.py`).
- Le bloc de données ReAct est enveloppé comme contenu externe sauf provenance INTERNE établie : un `structured_data` sans registre (`get_context_list`, `resolve_reference` — des corps d'e-mails) arrivait nu au modèle.
- Un message transféré n'est jamais rogné (préfixe de sujet en six langues ou bannière de transfert) : le texte sous le bloc d'en-têtes est le message ; 12 cas au corpus.
- `result_size_estimate` est l'estimation du fournisseur ou rien : Graph et IMAP publiaient la taille de la page comme une estimation (ADR-185).
- Le condensé dégrade au lieu d'échouer : un plafond fermé en cours de lot vaut `skipped_quota`, un Redis injoignable calcule sans cache, les lectures tiennent en un `mget`.
- `normalize_gmail_query` dit ce que les prompts disent : une requête vide, « inbox » ou « received » est un listing de la boîte de réception (`label:inbox`), une recherche sans portée reste hors envoyés et brouillons, archives comprises.
- Le plafond de sortie du condensé est celui du slot `email_digest` (édité par l'administrateur ; `short_answer_config(max_tokens=None)` garde le budget du slot) — la constante ne fait plus que semer le défaut.
- Les règles de profil de raisonnement déménagent dans `core/reasoning_profiles.py` (réexport conservé sous `infrastructure/llm/reasoning/profiles.py`) : `core` les lisait depuis `infrastructure`, une inversion de couche qui fermait un cycle d'import et faisait échouer un import à froid de `llm_config_helper`.
- Le plafond de sortie du condensé passe de 600 à 1 000 tokens (une newsletter dense en produit 550 à 600 en français ; un sur vingt fut coupé), le prompt demande des points clés d'une phrase, et la version de schéma du cache passe à 2.
- Le wrapper MCP du sous-agent (`_MCPReActWrapper`) passe par `compose_tool_message`, la même porte que `ReactToolWrapper`.
- `build_emails_output` retire `payload` (l'arbre Gmail brut) une fois la promotion des en-têtes et la conversion des dates faites ; `GetEmailDetailsTool` lit les champs promus.
- `local_query_engine_catalogue_manifest` déclare `execution_modes={pipeline}`.
- Le routeur étend `draft_turn_reset()` : un nouveau tour commence sans brouillon en relecture (l'enregistrement d'interruption expire après une heure, le checkpoint jamais — un brouillon périmé était re-présenté par le tour actionnable suivant). `filter_for_llm_context` aplatit une carte `lia-draft*` en texte pour le modèle. La surface est `PLAIN` aussi sur un canal externe (`plain_surface_ctx`, déclaré par le gestionnaire Telegram autour du flux) et pour l'affichage `markdown` ; le sommaire n'accompagne que la première présentation ; l'extrait porte les guillemets de sa langue (`EXCERPT_QUOTES`).
- `render_confirmation_card` et `render_execution_result` prennent une `surface` (défaut `PLAIN`) ; la question de critique et le nœud de réponse demandent `card_surface()`. Les renderers par type retournent des lignes décrites (`list[PreviewLine]`) au lieu de Markdown ; les tests qui les appelaient sérialisent la description.
- `hitl_dispatch_node` : une file de brouillons qui n'est pas un lot pré-approuvé se consomme un brouillon par interruption (`advance_sequence`), la dernière réponse règle tout (`settle`) ; les sorties terminales rapportent les brouillons restants comme annulés ; le nœud a rétréci (ratchet 756 → 698). `draft_executor._execute_confirmed_batch` saute et compte les entrées annulées, `total_count` est ce qui a été tenté, un lot sans type unique se déclare `batch`. `result_renderer` nomme chaque ligne d'un lot par son propre type et titre un lot mélangé en « actions ». L'orchestrateur et le nœud ReAct écrivent toujours `pending_drafts_grouped` et `confirmed_drafts`.
- La description de `EMAILS_BODY_MAX_LENGTH` lit sa constante ; les trois `.env` cessent d'annoncer trois défauts différents.
- La fenêtre par défaut d'un listing d'agenda est un réglage publié, plus un littéral : `get_events_tool` lisait `timedelta(days=30)` dans le code, annonçait « +30 days » sur deux surfaces et « max 100 » ou « max 50 » là où le plafond est `CALENDAR_TOOL_DEFAULT_MAX_RESULTS` ; le client Apple portait un second défaut (−30/+90 jours) qu'aucun des douze appelants de `list_events` n'atteint, tous passant les deux bornes. Le réglage est lu par l'outil et publié sur le manifeste (planificateur) et sur le schéma d'appel (ReAct) — dont les neuf paramètres de `get_events_tool` n'avaient aucune description : elles vivaient dans la docstring seule (sonde 2026-09-16 : 24 outils enregistrés dans cet état, 105 paramètres sur 427).

### Removed

- `OutputFieldSchema(path="emails[].headers")` du manifeste `get_emails_tool` — un chemin qu'aucun item construit n'a jamais porté.
- `search_emails_tool` et `get_email_details_tool` (`SearchEmailsTool`, `GetEmailDetailsTool`, ~790 lignes qu'aucun catalogue n'offrait plus), `EMAIL_TRUNCATION_RATIO` et `email_truncation_ratio`, `GmailFormatter._extract_body_truncated`, `_strip_html` du normaliseur IMAP, le repli d'aperçu dupliqué de `email_card`, la constante morte `DEFAULT_ACTIONS`.

### Fixed

- `resolve_reference` : `UnifiedToolOutput.action_success(data=…)` → `structured_data=` ; chaque résolution réussie levait `TypeError` depuis la v1.0.0.
- La dépense des condensés d'e-mail atteint le registre : la porte structurée reçoit le `RunnableConfig` du tour (six appels mesurés sans aucune ligne `token_usage_recorded` avant la correction).
- La réponse à un e-mail Apple porte `In-Reply-To` et `References` : les en-têtes fabriqués n'avaient jamais porté de `Message-ID`, le fil n'était jamais relié.

## [1.44.6] - 2026-09-15

**Un rappel arrive avec son texte** ([ADR-285](docs/architecture/ADR-285-Short-Answer-Without-Reasoning-And-One-Family-Declaration.md)). Le slot `response` de production est passé sur `deepseek-flash` — le nom que l'API DeepSeek donne désormais à son modèle phare (DeepSeek-V4.1-Flash ; `deepseek-v4-flash` est un alias retiré qu'elle accepte encore) — et le lendemain chaque rappel arrivait sous la forme « 🔔 » et rien d'autre. Mesuré en production, trois fois sur trois, par le vrai chemin de code : le générateur demandait 150 tokens, le fournisseur active la réflexion par défaut et la compte **dans** `max_tokens`, donc 150 tokens de chaîne de pensée cachée, `content` vide, `finish_reason = "length"`. Ce n'est propre ni au modèle ni au fournisseur — OpenAI, Anthropic et Gemini comptent aussi la réflexion dans le plafond — et le rappel n'avait fonctionné jusque-là que parce que `response` était sur un modèle qui ne réfléchit pas. **Une réponse courte se demande sans raisonnement** : `short_answer_config` prend la configuration du slot, résout son profil par la couture ADR-245 et déclare `none` là où le modèle peut s'arrêter, n'appliquant le budget de réponse que là — un plafond qui inclut la réflexion n'est pas un plafond sur la réponse. **Une réponse vide ou coupée est un refus** (ADR-275) : la phrase de repli écrite part, la dépense qui a eu lieu est conservée, l'avertissement nomme le modèle et ses tokens de réflexion. Mesuré sur Docker dev avec le modèle réel : 35 à 48 tokens de sortie, trois messages sur trois.

**Une famille de modèles se déclare une fois.** Derrière le symptôme, trois lecteurs reconnaissaient la famille DeepSeek à bascule par une copie privée d'un préfixe `deepseek-v4` — la règle de profil, la branche V4 de l'adaptateur, le détour `tool_choice` de la sortie structurée — et le nom courant passait au travers des trois : aucune échelle publiée à l'administration (ce qui avait étonné en créant la ligne), un `none` explicite qui n'envoyait pas `thinking: disabled`, le plafond V3 de 8 192 appliqué à un modèle qui sort 384 K (mesuré sur `heartbeat_message` : 10 000 → 8 192 en silence). `DEEPSEEK_THINKING_PREFIXES` est la déclaration, `is_deepseek_thinking_model` le prédicat que les trois lisent, un garde AST refuse toute recopie ; l'échelle devient celle que le vendeur documente, `none/low/high/max` ; le plafond de sortie se lit dans la ligne de catalogue (ADR-244). Le nom courant voyage par migration **et** par graine, tarifé par plages UTC, provenance `verified` comme la ligne de production ; un garde tient les deux sources égales. Et la neuvième copie de la lecture des métadonnées d'usage — qui lisait une clé que LangChain ne pose jamais — est remplacée par le lecteur unique : chaque rappel était facturé à un modèle sans nom, au prix zéro, sans crédit de cache, et la ligne de l'article 12 ne nommait aucun modèle.

**Un prompt énonce ce que le code impose, et rien d'autre** ([ADR-284](docs/architecture/ADR-284-Prompt-States-What-The-Code-Enforces.md)). L'audit des prompts a trouvé toutes les gardes vertes et, derrière elles, six endroits où le modèle lisait quelque chose de faux, chacun prouvé par assemblage du prompt réel puis mesuré sur Docker dev. Le générateur de questions HITL lisait `Tool name: {tool_name}` — trois placeholders sans producteur depuis la v1.0.0 — sans effet mesurable sur 24 questions réelles : une dette d'hygiène, traitée comme telle. Le prompt de réponse enveloppait `<RAGDocuments>` (« synthétise ») dans `<UserDocuments>` (« cite toujours ») et portait, à chaque tour sans contexte, 246 jetons d'enveloppes vides sous leur consigne, dans la queue jamais cachée ; une troisième consigne, dans l'en-tête RAG, décidait à la place des deux autres. Brave publiait `maximum=20/50` au planner et rognait à 10. Le bloc de délégation disait « 2-pass », « 4 outils dont Wikipedia », « timeout 120 » et le nom d'une variable d'environnement à la place de son nombre. `<Computation>` promettait un bac à sable là où il n'est pas enregistré. Le briefing tenait cinq autorités pour une fenêtre. Cinq règles, une garde chacune : tout `{placeholder}` a un producteur et un fichier contenant `{{` est rendu par `.format()` ; une consigne par contexte, dans le fichier, émise seulement quand le contenu existe ; la borne publiée est la borne imposée, depuis une constante ; un nombre vient d'un réglage et un fait du code qui l'applique ; la prose n'habite jamais un `.py`, un repli inline non plus — douze sites migrés, un parseur `clé|gabarit` pour trois copies, `load_prompt_with_fallback` supprimé. Corollaires : `get_language_name` normalise avant de nommer (`"zh"` rendait `"zh"`), quatre réglages `*_prompt_version` sans lecteur supprimés sous un garde, cinq lecteurs manuels de `usage_metadata` ramenés au lecteur unique — le heartbeat et la livraison entre pairs facturaient le cache deux fois.

### Added

- **ADR-285** : `DEEPSEEK_THINKING_PREFIXES` et `is_deepseek_thinking_model` (`reasoning/profiles.py`), `providers/deepseek_limits.py` (plafond de sortie lu dans le catalogue, 64 000 en repli), `short_answer_config` (`core/llm_config_helper.py`), `REMINDER_MESSAGE_MAX_TOKENS`, `model_name_of_response` et `reasoning_tokens_of` (`usage_metadata.py`), avertissement `reminder_message_empty` ; migration `e9b5d7f3a2c4` (ligne `deepseek-flash`, tarif et fenêtres UTC là où rien d'administré n'est actif, `low` appris aux échelles déclarées de la famille) ; ligne, tarif et fenêtres dans `llm_pricing_seed.sql` ; `deepseek-flash` dans la table des fenêtres de contexte ; gardes `test_deepseek_family.py` (famille, adaptateur, détour, graine, aucune recopie du préfixe), `test_deepseek_flash_migration_guard.py` (migration = graine), `test_reminder_message_generation.py`.
- **ADR-284** : dix-huit fichiers de prompts nouveaux (`response_context_sections.txt`, `rag_context_format.txt`, `smart_planner_subagent_delegation_prompt.txt`, `react_computation_prompt.txt`, `hitl_item_filter_prompt.txt`, `heartbeat_decision_user_prompt.txt`, `heartbeat_verified_facts_prompt.txt`, `psyche_legacy_compact_prompt.txt`, `interest_perplexity_system_prompt.txt`, `smart_planner_mcp_format_reference_prompt.txt` et huit fichiers de lignes `*_lines.txt`), `parse_prompt_sections` (`core/prompt_store.py`), `nodes/react_prompt.py`, `BriefingWindows` publié (`CardsResponse.windows`, `BriefingResponse.windows`), `BRAVE_WEB_SEARCH_MAX_COUNT` / `BRAVE_NEWS_SEARCH_MAX_COUNT` et `@rate_limit` sur les outils Brave (`BRAVE_RATE_LIMIT_CALLS`, `BRAVE_RATE_LIMIT_WINDOW`), `get_language_name` dans `core/i18n.py` ; gardes `test_prompt_placeholders_are_produced.py` (`RENDERED_BY`, `PROVIDER_TEMPLATE_SYNTAX`), `test_prompt_version_settings_have_readers.py`, `test_lot_b_prose_left_the_code.py`, `test_no_fallback_loader.py`, `test_response_prompt_sections.py`, `test_usage_metadata_single_reader.py`, `test_tool_messages_are_technical_english.py`, `test_brave_count_bounds.py`, `test_windows_published.py`, `test_embodied_lines_golden.py`, `test_i18n_language_name.py`, `test_prompt_store_sections.py`.
- Trois paragraphes du guide Technique (§12.4, §16.3, §23.4) ×6, une puce et une phrase de la page Philosophie ×6, une phrase de la Story ×6, trois entrées du changelog applicatif ×6, un paragraphe de la Q&R « profondeur de réflexion » et une puce de la Q&R « notifications push » ×6, `docs/knowledge/03` et `07`, `docs/technical/REMINDERS.md`, `NOTIFICATIONS_FLOW.md`, `LLM_PROVIDERS.md`, `LLM_PROVIDER_CONSTRAINTS.md`, `LLM_CONFIG_ADMIN.md`, `LLM_PRICING_MANAGEMENT.md`.

### Changed

- **Le rappel** demande sa phrase par `short_answer_config` (plus de `max_tokens=150` nu sur le slot), lit son usage par `tokens_from_response` / `model_name_of_response`, et tronque le corps de la notification selon `settings.proactive_notification_max_length` (un littéral 150 à côté du réglage).
- **La famille DeepSeek** : échelle `none/low/high/max` ; `_create_deepseek_llm` et `_is_v4_thinking_enabled` lisent le prédicat unique ; le plafond de sortie de la famille est `max_output_tokens` de la ligne ; l'aide `deepseek_v4` de l'administration dit que la réflexion est activée par défaut et facturée dans `max_tokens`.
- **Le nom courant** dans les quatre `.env` du démonstrateur (`DEMO_INSTANCE_LLM_MODEL`) et les cinq slots de `llm_config_seed.sql` ; `FALLBACK_MODELS` garde l'alias tant que la photo vendue des registres ne porte pas le nom courant (un garde refuse un repli qu'aucun registre ne connaît) ; `GETTING_STARTED.md` dit que ses tableaux nomment l'alias retiré.
- **Les prompts** (ADR-284) : `get_response_prompt` n'enveloppe ni n'échappe plus rien ; `rag_context_format.txt` nomme sans instruire ; les outils Brave rognent à la borne qu'ils publient ; le bloc de délégation et `<Computation>` lisent leurs nombres dans les réglages et ne promettent que ce que le tour peut exécuter ; les descriptions « Default N » du briefing sont dérivées des constantes ; les messages d'outil restants sont en anglais technique ; le préfixe statique de quatre prompts change (une invalidation du cache fournisseur, une fois).
- `PROACTIVE_NOTIFICATION_MAX_LENGTH` passe de 150 à 500 dans `.env.example` et `.env.prod.example` : le corps d'une notification proactive est prévisualisé sur cinq cents caractères, la borne haute du réglage.
- **Quatre réglages `*_prompt_version` sans lecteur** sont supprimés de la configuration, des constantes, des trois `.env` et de la documentation ; `load_prompt_with_fallback` est supprimé avec ses deux replis ; `ExecutionPlanLLMOutput` et `get_draft_update_labels` sont supprimés avec leurs tests.

### Fixed

- Un rappel arrivait sous la forme « 🔔 » sans texte sur un modèle qui réfléchit par défaut ; il était facturé à un modèle sans nom, au prix zéro, sans crédit de cache.
- `deepseek-flash` : aucune échelle de réflexion proposée à l'administration, un `none` explicite sans effet, un plafond de sortie de 8 192 au lieu de 384 000, aucune ligne de catalogue ni de tarif sur une instance mise à jour.
- Le générateur de questions HITL lisait trois placeholders jamais remplis ; le prompt de réponse portait 246 jetons d'enveloppes vides par tour nu et livrait `r={{x}}` ; Brave rognait à 10 une borne publiée à 20/50 ; le bloc de délégation et le bloc `<Computation>` promettaient ce que le tour ne pouvait pas faire ; le heartbeat et la livraison entre pairs facturaient le cache deux fois ; `get_language_name("zh")` rendait `"zh"`.

### Tests

- **400 tests** de plus côté serveur sur 18 fichiers (ADR-284 : placeholders produits, sections de réponse, prose hors du code, lecteur d'usage unique, bornes Brave, fenêtres du briefing, langue nommée, réglages lus, goldens psyche ; ADR-285 : famille, adaptateur, détour, graine, migration = graine, génération du rappel) et **2** côté navigateur (`BirthdaysCard`) ; les 33 prompts réécrits entre le 14 et le 15 septembre ont été remis en conformité avec les gardes (marqueur de cache, placeholders produits, règles gardées) sans en affaiblir aucun.
- Les suites comptent désormais 28 983 tests côté serveur sur 1 703 fichiers, 8 316 côté navigateur sur 652 fichiers et 271 (225 dans la suite par défaut) parcours Playwright ; `lint`, `test:backend:unit:fast` (26 686), `test:backend:agents` (1 127), `test:frontend`, `test:e2e` (225/225 sur le bundle de production), `test:install` (152 + 74 contrats) et `ci:fast` sont verts.

## [1.44.5] - 2026-09-12

**Une démo qui dit ce qu'elle offre.** La page qui ouvre le démonstrateur public énonçait ses limites en neuf lignes, dont « certaines fonctions sont coupées » — sans dire lesquelles. Elle liste désormais, sous les limitations et avant le bouton, ce qui y est activé et ce qui ne l'est pas, et cette liste n'est tenue par personne : chaque instance publie dans sa configuration publique (`GET /config`, bloc `capabilities`) l'état **effectif** de toutes ses capacités — plafond d'environnement ∧ commutateur d'opérateur, `feature_switches/public_state.py` — et l'instance qui annonce un démonstrateur lit cette configuration **côté serveur** (`product/demo_capabilities.py` : un GET borné vers l'origine du lien, cache par processus, un échec en cache aussi) et la relaie dans le payload du lien. La première architecture — une lecture depuis le navigateur du visiteur avec une origine `*` à l'edge — a été réfutée par la suite Playwright hermétique sur le bundle de production : la CSP du document n'autorise `connect-src` que vers l'API de l'instance (ADR-098), et élargir la politique d'une page publique pour une liste aurait été une décision de sécurité. Le relais coûte à la page zéro requête de plus, zéro ouverture CORS, et un démonstrateur muet se lit « n'a pas répondu », jamais comme une colonne « désactivé » vide.

**Un démonstrateur dont chaque plafond est décidé.** Son gabarit d'environnement déclarait treize plafonds sur vingt-sept ; les quatorze autres prenaient le défaut du code, si bien que le tableau de tickets, les réunions et le Python éphémère y tournaient activés sans décision — chacun derrière une porte close (préfixe absent de l'edge, pas de moteur de transcription, pas de socket Docker). Les quatre fichiers `.env` du démonstrateur décident désormais chaque capacité, activée ou coupée avec sa raison ; deux gardes refusent un `env_flag` du registre absent du gabarit et un désaccord entre gabarits dev et prod ; le recensement des routes atteignables monte les routeurs **sous les plafonds du gabarit** au lieu de ceux du processus de test — il tenait 57 routes de familles coupées pour « atteignables » et ne voyait pas `peers` — et il est devenu bidirectionnel : une route montée est exposée ou déclarée cachée avec sa raison (`HIDDEN_BY_DECISION`, `HIDDEN_PENDING_DECISION`, shrink-only). L'edge ouvre le tableau de tickets, les connexions entre comptes, la galerie, les bookmarks et la chronologie d'activité, et trois familles écrites `/x/*` — dont la vue d'ensemble `/x` répondait 404 — s'écrivent `/x*`.

**Un worker API a une anatomie déclarée et mesurée** ([ADR-283](docs/architecture/ADR-283-Worker-Memory-Anatomy.md)). Rien n'était une fuite ; chaque poste a été mesuré sur l'hôte, dans un processus jetable, avant d'être touché. Le superviseur uvicorn importait l'application pour une erreur précoce qu'il jetait ensuite : `python -m src.serve` pilote la même chaîne sans cet import (garde AST). Une bibliothèque lourde s'importe où elle sert (`LAZY_ONLY`, garde sur tout `src/`). Le STT gardait un recognizer par langue jamais demandée, dans un singleton par processus : le cache est borné (`VOICE_STT_MAX_RECOGNIZERS`), LRU, une éviction rend la mémoire — mesuré. Chaque worker publie ce qu'il tient (`lia_worker_memory_bytes{kind}`, `liveall`), deux panneaux sur le tableau 03 et l'alerte `ApiWorkerMemoryHigh` nomment le processus. Et le budget de connexions a un **plancher** : `ConnectionBudget.persistent_total`, un garde qui lit le compose et les deux profils `.env` (`plancher ≤ limite / 2`), pools 5 / 15 par worker, limite Postgres 2 Gio.

**Lire ses propres fichiers survit au plafond des téléversements** (ADR-279 amendé). Le commutateur d'opérateur respectait la règle ; l'inclusion du routeur `attachments` et l'enregistrement du balayage d'expiration restaient sous `attachments_enabled` — sur une instance aux envois coupés, un document généré était écrit et ne pouvait pas être ouvert, et n'aurait jamais expiré. Le routeur est monté quel que soit le plafond (la garde de capacité sur `POST /upload` suffit) et le balayage tourne pour les quatre producteurs de la table ; la génération de documents est activée sur le démonstrateur.

### Added

- **`GET /config` publie `capabilities`** (`feature_switches/public_state.py`) : chaque membre du registre avec `enabled` (plafond ∧ commutateur, un seul passage sur le magasin) et `family`, clé = vocabulaire i18n `capabilities.items.*`.
- **Le relais des capacités du démonstrateur** (`product/demo_capabilities.py` : origine du lien, `DEMO_CAPABILITIES_FETCH_TIMEOUT_SECONDS`, `DEMO_CAPABILITIES_CACHE_TTL_SECONDS`, cache négatif, jamais d'exception) et `capabilities` dans `GET /product/public-demo-link` ; côté web `lib/demo-capabilities.ts` (narrowing), `DemoCapabilityLists` (deux listes triées, phrase « n'a pas répondu »), l'invitation qui le lit, clés `showroom.live_invitation.capabilities.*` ×6, la spec `smoke/public-demo-showroom-invitation.spec.ts` dans `task test:e2e:showroom`.
- **ADR-283** : `src/serve.py` et le `CMD` de `Dockerfile.prod` ; `observability/process_memory.py` (`lia_worker_memory_bytes`), `voice_stt_recognizers_loaded`, l'échantillonneur démarré dans le lifespan et arrêté à l'arrêt, deux panneaux sur `03-infra-resources`, l'alerte `ApiWorkerMemoryHigh` (seuil `ALERT_CORE_API_WORKER_ANON_MB`, recette de preuve, runbook), `ConnectionBudget.persistent_total` ; réglages `VOICE_STT_MAX_RECOGNIZERS`, `WORKER_MEMORY_SAMPLE_INTERVAL` ; gardes `test_serve_launcher.py`, `test_lazy_heavy_imports_guard.py`, `test_sherpa_recognizer_cache.py`, `test_process_memory.py`, `test_worker_memory_sampler.py`, `test_postgres_memory_floor_guard.py` (les deux profils, le minimal complété des défauts du code).
- **Le démonstrateur décidé** : section `CAPABILITIES OFFERED` réécrite dans les quatre `.env` (27 plafonds), `tests/_demo_template.py`, `TestEveryCapabilityIsDecidedInTheTemplate` (complétude + parité dev/prod), recensement sous les plafonds du gabarit, tables `HIDDEN_BY_DECISION` / `HIDDEN_PENDING_DECISION` et leurs deux gardes, cinq sondes runtime dans `verify-demo-surface.sh`.
- **`test_router_mounted_whatever_the_ceiling.py`** : routeur `attachments` sous les deux valeurs du plafond, garde de téléversement présente, `add_job` du balayage hors de tout `if attachments_enabled` (AST).
- Une section 42 du guide Technique (« L'anatomie d'un processus ») ×6 avec son entrée de navigation, deux paragraphes de la page Philosophie ×6, une phrase de la Story ×6, quatre entrées du changelog applicatif ×6, une Q&R « Génération de documents » ×6, trois cartes « Comment fonctionne LIA » réécrites plus courtes ×6, `docs/knowledge/30` et `32`.

### Changed

- **`routes.py` monte le routeur `attachments` inconditionnellement** (`_include_attachments()`), et `schedulers.py` enregistre `attachment_cleanup` sans condition.
- **Le lanceur** : `CMD ["python", "-m", "src.serve", …]` ; **Postgres** : limite mémoire 2G dans `docker-compose.prod.yml` ; **défauts** : `DATABASE_POOL_SIZE_DEFAULT` 30 → 5, `DATABASE_MAX_OVERFLOW_DEFAULT` 30 → 15, `.env.prod.example` 20/10 → 5/15, **`.env.min.prod.example`** 20/10 → 5/15 (le profil de l'auto-hébergeur violait la règle du plancher à 55 %) ; `pdf_layout.py` importe PyMuPDF par accesseur ; `sherpa_stt.py` tient un `OrderedDict` borné.
- **Caddy du démonstrateur** : `habits`, `relations`, `health-metrics`, `image-generation` passent de `/x/*` (ou exact) à `/x*` ; `workboard/*`, `peers*`, `activity/*`, `generated-assets*`, `bookmarks*` ajoutés ; aucune ouverture CORS (garde : pas d'`Access-Control-Allow-Origin`).
- **`.env` du démonstrateur** : `DOCUMENT_GENERATION_ENABLED`, `WORKBOARD_ENABLED`, `PEERS_ENABLED` et onze autres à `true` ; `MEETINGS`, `MOMENTS`, `PYTHON_SANDBOX_TOOL` à `false` avec leur raison (moteur STT coupé, servi par le heartbeat coupé, pas de socket Docker).
- Le recensement des routes exposées ne liste plus 57 routes de familles que le démonstrateur coupe (pièces jointes, espaces, skills, heartbeat, MCP).
- La carte « Ce que cette instance propose » dit vingt-sept capacités ; `AppConfig.capabilities?` typé côté web.

### Fixed

- Sur le démonstrateur public : `POST /bookmarks` et la galerie répondaient 404 (préfixes jamais listés), `GET /relations`, `GET|DELETE /habits`, `GET|DELETE /health-metrics` et `/image-generation/options` répondaient 404 (forme `/x/*`), le tableau de tickets, les réunions et le Python éphémère tournaient activés par défaut derrière des portes closes.
- Un document généré n'était pas ouvrable, et n'expirait jamais, sur une instance aux téléversements coupés.
- Le superviseur tenait plusieurs centaines de mégaoctets sans servir ; le STT croissait à chaque langue demandée ; Postgres tournait à 95-99 % de son plafond chaque matin (ADR-283).

### Tests

- **83 tests** de plus côté serveur, **15** côté navigateur et **2 (dans la suite showroom, qui passe à 46 ; la suite par défaut reste à 225)** parcours Playwright — dont la spec de l'invitation, qui a **réfuté** la première architecture (lecture cross-origin bloquée par la CSP) avant qu'elle ne parte.
- Les suites comptent désormais 28 583 tests côté serveur sur 1 685 fichiers, 8 314 côté navigateur sur 651 fichiers et 271 (225 dans la suite par défaut) parcours Playwright ; `ci:fast`, `test:install`, `test:install:backend-contracts` et la suite showroom (29/29 en conteneur Playwright sur le bundle de production) sont verts.

## [1.44.4] - 2026-09-12

**Une réponse conservée appartient à la personne, pas à la conversation.** Une réponse de l'assistant n'existait que dans la conversation qui l'avait produite — une par compte, réinitialisée souvent — et ne se gardait qu'en la copiant ailleurs ou en téléchargeant un `.md`. Chaque bulle porte désormais un **bookmark** à côté de « copier » ([ADR-282](docs/architecture/ADR-282-Message-Bookmarks.md)). Un bookmark est une **copie, pas un pointeur** : la réponse (markdown ou document HTML enrichi, tel quel), la demande qui l'a produite et la date de la réponse sont copiées au clic, et les deux références gardées vers la conversation ne servent qu'à la bascule de la bulle tant qu'elle vit — réinitialisée, le bookmark reste entier. La demande est résolue **côté serveur**, sous le même prédicat de visibilité que le chat : jamais la question synthétique d'une exécution hors tour, et une notification envoyée de l'initiative de LIA ne garde aucune demande plutôt qu'une fausse.

**Un compte neuf démarre connecté.** Cinq connecteurs ne demandent rien à la personne — Wikipédia, la navigation de pages, Google Places, Google Météo, Google Environnement — et pourtant un nouveau compte devait trouver et presser cinq boutons avant que l'assistant puisse chercher un lieu ou la météo. Ils sont provisionnés à l'inscription, sur une liste que le backend déclare et que le frontend reflète (parité épinglée par un test), avec trois refus écrits : un type que l'administrateur a coupé, une clé de plateforme absente, la navigation désactivée. Les comptes existants ne sont pas touchés.

### Added

- **Les bookmarks de messages** ([ADR-282](docs/architecture/ADR-282-Message-Bookmarks.md), `docs/technical/BOOKMARKS.md`) : table `message_bookmarks` (migration `d8a4c6e2f7b1`, références en `SET NULL`, index unique **partiel** sur `(user_id, message_id)` pour une bascule idempotente), domaine `domains/bookmarks/` (modèle, requêtes, dépôt déclaré `VISIBLE_ONLY` dans `message_readers`, service, routeur, erreurs), routes `/bookmarks` (`POST` — 201, ou 200 quand la réponse était déjà conservée ; `GET` avec total exact, `max_limit` et `max_per_user` publiés ; `GET /state` ; `DELETE /{id}` ; `DELETE /by-message/{id}`), plafond `BOOKMARKS_MAX_PER_USER` refusé par une classe à part dont la phrase est traduite en six langues, section `[96]` des fichiers `.env`.
- **Une capacité `BOOKMARKS`** (famille `knowledge`, plafond `BOOKMARKS_ENABLED`) dont la garde porte sur le `POST` seul — lister, l'état, supprimer et exporter restent ouverts commutateur coupé (la doctrine d'ADR-279) — un nœud **compté** sur la carte des capacités pointant sur l'onglet de la section des fichiers, la table classée `USER_PURGED` + export `FULL` et purgée par `build_purge_statements`.
- **La bascule sur chaque bulle** (`BookmarkButton`, à côté de « copier », sur toute réponse archivée qui porte du texte, notifications proactives comprises) lit UN état pour tout le chat (`lib/bookmark-state-context.tsx`, `GET /bookmarks/state` une fois par montage, fusionné sous les clics déjà confirmés), optimiste avec retour arrière et la phrase du serveur pour les seuls refus traduits ; un second clic pendant l'écriture est ignoré.
- **Un onglet « Bookmarks »** dans « Mes fichiers générés » (quatrième onglet, lu depuis `?tab=` à l'arrivée), avec recherche sur les réponses et les demandes, total exact face au plafond, pagination, et une carte par réponse : date, demande citée, réponse rendue par le composant de la bulle (markdown et HTML enrichi), partage (détection de `navigator.share`), téléchargement `.md` par le chemin du chat avec la demande citée en tête, suppression après confirmation.
- **Le provisionnement des connecteurs sans clé** (`ConnectorType.get_keyless_types()`, `users/keyless_connectors_provisioning.py`) dans `provision_new_user`, jamais bloquant, lignes tamponnées `provisioned_by: signup_keyless` ; documenté dans `CONNECTORS_PATTERNS.md`.
- **Une soixante-sixième attention sur « Encore + »** — « Garder la réponse, effacer le chat » — avec sa scène ; deux questions de FAQ (conserver une réponse ; quels connecteurs sont actifs à l'inscription), deux cartes « Comment fonctionne LIA » complétées, deux descriptions de la landing, le lexique de recherche des réglages, en six langues.

### Changed

- **Le préfixe des notifications proactives est déclaré une fois** (`PROACTIVE_MESSAGE_TYPE_PREFIX` dans `core/constants.py`) et lu par ses cinq écrivains, au lieu de cinq f-strings.
- **Un nœud de la carte peut atterrir sur un ONGLET** d'une section qu'un autre nœud possède (`CAPABILITY_SECTION_TAB`, `tabOfCapability`, `settingsSectionHref(lng, token, tab)`) : `CAPABILITY_SECTION` reste une bijection — une section, un statut sur sa carte d'aperçu — et le garde backend lit les deux tables.
- **Les raisers d'un domaine vivent dans le domaine** (`bookmarks/errors.py`, sur la taxonomie centrale) parce que `core/exceptions.py` est gelé en taille — le précédent des pièces jointes et des réunions.
- **Le prompt de contenu des intérêts** exclut la publicité et les contenus sponsorisés.

### Tests

- **103 tests** de plus — 57 côté serveur (requêtes, service dont la course de deux clics, routeur, parité des formes de fil, provisionnement des connecteurs sans clé, parité backend/frontend de la liste sans clé, et dix tests d'intégration sur un vrai PostgreSQL : `SET NULL` à la suppression de la conversation, cascade du compte, index unique partiel, lectures visibles seulement, recherche échappée), 43 côté navigateur (état lu une fois et fusionné, bascule optimiste et retour arrière, double clic ignoré, phrase serveur limitée aux refus traduits, porte de la bulle jusqu'aux notifications proactives, onglet conditionnel et `?tab=`, cartes et export `.md`, tables de destination) et 3 parcours Playwright hermétiques (conserver puis retirer depuis la bulle, un bookmark détaché entier dans son onglet, aucune carte au-delà de 320 px) — joués en navigateur réel sur le bundle de production.
- Les gardes de complétude ont refusé pendant le lot et passent à la livraison : partition des capacités dans les deux sens, câblage de route, carte des capacités (nœud, destination, six libellés), carte des données, lecteurs de messages, ratchet de taille de `core/exceptions.py`.
- Les suites comptent désormais 28 500 tests côté serveur sur 1 676 fichiers, 8 299 côté navigateur sur 649 fichiers et 225 parcours Playwright ; le rejeu de la migration depuis une base vide et l'équivalence structurelle sont vérifiés, la couverture serveur mesurée à 74,3 % pour un plancher de 72.

## [1.44.3] - 2026-09-11

**Ce que LIA apprend d'une personne doit se vivre partout — et se vérifie à l'exécution.** Les habitudes (ADR-214) et les notifications proactives ont été auditées non sur le code mais sur docker dev, en simulant chaque parcours : un compte qui **bloque** une fenêtre apprise depuis son panneau, un balayage qui trouve la personne en réunion, un réveil poussé par Gmail, un interrupteur d'apprentissage coupé au milieu d'une conversation. Sept constats étaient structurels, et chacun porte sa simulation. Le premier : **bloquer une fenêtre ne changeait rien**. Le panneau modifie des lignes miroir, mais le bloc du battement, le scoring des ticks et le bloc ambiant lisaient le **profil** — la fenêtre bloquée continuait de guider les notifications. Un seul prédicat de consommation les sert désormais, et le statut d'une ligne atteint tous ses lecteurs.

**Le registre des consultations n'avait jamais vu un battement.** Le battement lit les sources dans `select_target` ; le collecteur du registre (ADR-263) était ouvert autour de `generate_content` : 824 passes en trente jours, **zéro ligne** — le cas exact où personne ne peut reconstituer ce qui a été lu. Le collecteur enveloppe désormais la passe entière, l'éligibilité comprise, puisque la garde « en réunion » y lit l'agenda ; mesuré après correctif, dix-sept lignes pour un tick réel.

**Et une habitude apprise n'avait ni cycle de vie, ni objet.** Le job nocturne la promeut, la rafraîchit, la garde ou la **rétrograde** — lignes actives seules, jamais dans le doute, et même pour un compte silencieux, qui est précisément le cas de la rétrogradation. L'offre d'une routine manquée est **déclarée** par la décision (`habit_offered`) plutôt que devinée sur une étiquette de sources que le modèle choisissait ; et elle **nomme la demande** — « veux-tu que je lance ta revue d'e-mails ? » — parce que l'intention de l'analyseur est désormais un histogramme borné **dans** la charge du ledger, jamais un fragment de sa clé. Enfin, la porte d'apprentissage ferme **toutes** les portes : le ledger, le détecteur d'initiative et l'amorçage lisent la même décision, fermée par défaut.

### Added

- **Un prédicat de consommation** ([ADR-214, amendement c](docs/architecture/ADR-214-Habitudes-Utilisateur-Apprentissage-Deterministe.md)) : `habits/consumption.py::load_consumable_profile` ne rend que les fenêtres dont la ligne miroir est **active** ; le bloc du battement, le scoring des ticks et le bloc ambiant le lisent tous les trois, et la clé d'une fenêtre n'a plus qu'un producteur (`window_keys.window_habit_key`).
- **Un cycle de vie tenu par le job nocturne** : `recurrence_sync.sync_recurring_habits` crée, rafraîchit, garde ou rétrograde une habitude apprise à partir du ledger de récurrences ; les dates d'offre sont préservées, la mise en sourdine d'une règle d'arrêt se lève à l'occurrence suivante, et une reprise le jour même est une reprise. Un compteur `recurring_habits_synced_total{action}` le dessine.
- **Une porte d'apprentissage, fermée par défaut** : `habits/learning_gate.py` est lue par l'écriture du ledger (issues `user_disabled` / `feature_disabled` comptées), par le détecteur d'initiative et par l'amorçage ; elle suit `HABITS_ENABLED` **et** le commutateur de capacité `habits`, lu à l'acte. Le panneau publie l'état de la suggestion de chat, et l'alerte `RecurrenceLedgerSilent` lit les deux conjoncts.
- **L'offre a un objet** : `immediate_intent` est enregistré comme histogramme borné dans la charge du ledger (`recurrence_store.record_intent` / `dominant_intent`, huit valeurs distinctes au plus, vocabulaire fermé `IMMEDIATE_INTENTS`) ; `usual_intent` atteint la ligne d'habitude, la section « MISSED ROUTINE » du prompt (« usually asks for a 'search' on 'email' ») et le panneau (« Recherche · E-mails — tous les jours ~08:30 »), en six langues.
- **La décision déclare son offre** : `HeartbeatDecision.habit_offered` (règle 24 du prompt versionné) remplace la lecture de l'étiquette `HABITS` dans `sources_used` ; un compteur `heartbeat_habit_offers_total{outcome}` distingue une offre déclarée d'une simple étiquette, et le tableau de bord du battement les dessine côte à côte.
- **Le scoring des ticks est une surface par balayage** (`habits/tick_scoring.py`, `TickSurface`) : le battement et le balayage d'intérêts déclarent chacun leurs champs de fenêtre et leur intervalle, épinglés sur leur vérificateur d'éligibilité ; le balayage d'intérêts passe désormais sous les **deux** portes — la garde « en réunion » et le rythme appris — que le battement appliquait seul.
- **Les sondes de disponibilité forment une table complète** (`heartbeat/source_availability.py`, treize sources, assertion de complétude au démarrage) : le panneau dit pour chaque source si elle est connectée, et pourquoi elle ne l'est pas ; les habitudes et le tableau de travail y gagnent leur glyphe.
- **Les dix-huit seuils du détecteur sont traduits** dans le panneau des habitudes, en six langues, avec la légende « sur cette instance LIA ne propose pas d'automatisation dans le chat » quand la suggestion est coupée.
- **Deux parcours Playwright hermétiques** — le panneau des habitudes (libellé nommant la demande habituelle, mise en pause, 320 px sans débordement) et le panneau proactif (treize sources dans l'ordre du serveur, note d'indisponibilité, refus des habitudes, genres de moments).
- **Une soixante-cinquième attention sur la page « Encore + »** — « En pause, c'est en pause » : une habitude mise en pause l'est pour les notifications, leur horaire et le contexte à la fois, avec sa scène animée (un statut, trois consommateurs qui s'éteignent ensemble) en six langues.
- **Un runbook pour `RecurrenceLedgerSilent`**, un rang et huit panneaux de plus sur le tableau de bord du battement (ticks différés par balayage et motif, échappées de rythme, synchronisations nocturnes, offres déclarées contre étiquetées), et cinq métriques sorties de la liste des aveugles.

### Changed

- **`habits` et `heartbeat` quittent la famille gardée par route** ([ADR-280, amendement](docs/architecture/ADR-280-Complete-Capability-Control.md)) pour la famille imposée au service : apprendre la nuit et consommer à chaque tick sont des **actes**, gardés là où ils se produisent ; ce qui a été appris — lecture, correction, suppression, réglages, historique, retours — reste ouvert commutateur coupé, comme les mémoires. Sur le routeur des habitudes, seules les deux routes qui agissent (`/recompute`, `/presence`) portent la garde.
- **Un réveil poussé contourne le rythme appris, jamais la réunion** ([ADR-281, précision](docs/architecture/ADR-281-Anticipated-Moments-And-Mail-Watches.md)) : le verdict d'agenda est partagé par les trois balayages et porte `next_start`, si bien que le rythme ne peut plus cacher un rendez-vous imminent — une échappée comptée `heartbeat_rhythm_escapes_total{task_type, reason}`.
- **La décision lit l'horloge de la personne** (`prompts.message_clock`) : le prompt du battement reçoit l'heure locale au fuseau du compte, pas l'heure UTC du serveur.
- **La dernière activité compte une présence** : `activity_probe.fetch_last_seen_at` lit le dernier ping de présence, et la présence est **activée par défaut** (`HABITS_PRESENCE_ENABLED=true`, `.env.example` et `.env.prod.example` alignés) — un rythme appris sur les seules requêtes de chat ignorait les heures où la personne lit sans écrire.
- **Le TTL d'un verrou de planificateur suit son intervalle** (`scheduler_lock.ttl_for_interval`, 90 % de l'intervalle, plancher trente secondes) pour le balayage des moments **et** le balayage de réveil, dont le verrou de cinq minutes faisait sauter un tick sur deux sous l'intervalle par défaut ; la garde de timing des verrous connaît les jobs à TTL dérivé.
- **L'amorçage et la synchronisation tournent avant le court-circuit « aucune activité »** du job nocturne : un compte silencieux au ledger expiré est le cas de la rétrogradation, et il était exactement celui que le raccourci sautait.
- **Un domaine non enregistré n'est pas actionnable** : `registry/domain_bounds.py::is_registered_domain` est le prédicat unique des deux producteurs — la capture des résultats produit et l'écriture du ledger.
- **`heartbeat_ticks_deferred_total` gagne `task_type`**, et le motif `feature_disabled` rejoint `recurrence_evaluation_skipped_total`.
- **Le guide du battement** décrit les treize sources, les sondes de disponibilité, l'horloge locale, la place du registre et le verdict d'agenda ; le catalogue Grafana passe le tableau 13 à trente-huit panneaux ; le fichier CLAUDE.md et son miroir `AGENTS.md` portent le pointeur de l'amendement.

### Fixed

- **Bloquer ou mettre en pause une fenêtre apprise ne changeait rien** au battement, au scoring des ticks ni au bloc ambiant : le statut vivait sur la ligne miroir et les trois consommateurs lisaient le profil. Prouvé sur docker dev : fenêtre bloquée depuis le panneau, tick servi, bloc ambiant muet.
- **Le registre des consultations était vide pour toute passe proactive** : collecteur ouvert autour de la mauvaise étape ; 824 passes, zéro ligne. Il enveloppe la passe entière, l'éligibilité comprise.
- **Une lecture d'agenda en échec se lisait comme un silence** : la garde « en réunion » déclarait `opened=[]` quand le calendrier ne répondait pas, et le test épinglait ce silence ; elle déclare désormais la section ouverte et `failed`.
- **Le routeur du battement gardait encore ses réglages au niveau routeur** : commutateur `heartbeat` coupé, le panneau répondait 403 — trouvé par le test fonctionnel T7, corrigé, et la garde de câblage épingle désormais habitudes **et** battement.
- **Le drapeau de suggestion de chat gouvernait le ledger** : couper la suggestion coupait l'apprentissage. Les deux sont séparés — la porte d'apprentissage décide du ledger, le drapeau ne décide que de la suggestion.
- **L'offre était tamponnée sur une étiquette** que le modèle choisissait : une décision étiquetée `HABITS` sans offre déclarée consommait le budget d'offres du jour. Seule la déclaration tamponne ; l'étiquette seule est comptée et journalisée.
- **La section « MISSED ROUTINE » portait des instructions** à côté des données ; elle ne porte plus que les faits, les instructions vivent dans la règle 24 du prompt versionné.
- **Le balayage de réveil sautait un tick sur deux** sous le TTL par défaut de son verrou, plus long que son intervalle.
- **La liste des calendriers Apple répondait 500** (mesuré en production sous `caldav` 3.x) : sur un client asynchrone, la propriété dépréciée `name` d'un calendrier rend une **coroutine**, jamais une chaîne — `getattr(cal, "name")` plaçait cette coroutine dans le champ `summary`, la validation refusait la réponse, et « Impossible de charger la liste » s'affichait à chaque connexion d'Apple Calendar, avec cent trente-neuf avertissements « coroutine never awaited » en trente jours. Le nom est lu par l'unique porte awaitable (`get_display_name()`), résolu par l'appelant et passé au normaliseur, qui reste synchrone à dessein ; un calendrier par défaut choisi par son nom se retrouve de nouveau.
- **Trois lectures `Any` et un import local** retirés du chemin des habitudes (consommation, sondes de disponibilité typées `User`, sonde d'activité) ; la complexité cyclomatique du dépôt baisse de 327 à 323 et la base de référence suit.

### Tests

- **202 tests** de plus — 186 côté serveur, 16 côté navigateur — dont l'intégration sur un vrai PostgreSQL pour la synchronisation nocturne (promotion, rafraîchissement, rétrogradation, dates d'offre préservées) et la consommation par statut de fenêtre ; les huit parcours fonctionnels (`T1` à `T8`) rejoués sur docker dev reconstruit, par les routes HTTP et un cookie de session, avec des comptes synthétiques nettoyés.
- **Le placement du collecteur est prouvé** par un test qui lit ce que l'éligibilité ouvre ; **le silence d'une lecture en échec** est refusé par le test qui l'épinglait hier.
- **Le vocabulaire des intentions est épinglé** aux clés de traduction (`useHabits.contract.test.ts`) ; le plancher de couverture `lines` du frontend monte de 77 à 78 (mesuré 79,40).

## [1.44.2] - 2026-09-11

**Le battement est périodique ; un moment est un instant.** Une réunion se termine à 15 h et la passe suivante tombe à 15 h 22, sur un lot où la personne n'est peut-être pas — et la fenêtre de calendrier du contexte commence à `now` et regarde devant elle, si bien qu'une réunion **terminée** est invisible à la décision. Les **moments anticipés** tiennent une table d'instants : un par compte et par source, revendiqué sous verrou avec un jeton de propriétaire, **revalidé** avant d'être servi (la réunion a pu être annulée, déclinée, la personne a pu déjà écrire), et servi sous l'éligibilité complète du battement en ne contournant que le lissage probabiliste et le rythme appris — parce qu'**un instant ne se reporte pas** : demander « comment ça s'est passé ? » deux heures plus tard, ce n'est plus le demander.

**Une veille attendait jusqu'à deux heures.** Le réveil poussé par Gmail tient déjà le delta ; il sert désormais les veilles « courrier attendu » à partir de ce delta, **avant** le verdict du pré-filtre — qui répond « est-ce que ça vaut un réveil » là où une veille répond « est-ce ce que j'attends » — et n'exécute jamais la routine lui-même : il avance son échéance, l'exécuteur reste seul juge. Et une routine finie se **ferme** enfin, au lieu de rester « active » pour toujours, indiscernable d'une pause.

**Et le ledger de récurrences n'avait jamais rien enregistré.** Mesuré en production : `user_habits` = 0 ligne pour l'instance entière, cinq semaines après la mise en service — 227 tours actionnables sur 14 jours, 0 écriture. Les deux lecteurs de la porte lisaient un attribut que `QueryIntelligence` ne déclare pas ; `getattr` rendait `None` sans rien signaler, et les 40 tests qui couvraient la porte construisaient exactement la clé que le lecteur attendait, jamais la forme que le producteur émet. Le correctif lit la décision du routeur, en vocabulaire fermé ; une garde de classe interdit la cinquième lecture morte ; et le silence est devenu une alerte.

### Added

- **Moments anticipés** ([ADR-281](docs/architecture/ADR-281-Anticipated-Moments-And-Mail-Watches.md)) : une table `proactive_moments`, unique sur `(compte, genre, source)` pour qu'une réunion ne produise jamais deux moments ; un registre de genres avec assertion de complétude au démarrage ; un seul balayage, gigué, dont le TTL de verrou est lié à son intervalle ; et le premier genre, **après une réunion** — une question ouverte, au plus deux faits, aucun jugement, jamais deux moments empilés ni la même question deux fois. La garde « en réunion » lit le calendrier derrière un cache Redis de verdict et **n'enregistre aucune consultation sur un hit** (Redis a répondu ; l'agenda n'a pas été ouvert), une lecture en échec se déclarant `failed` plutôt que lue comme un silence.
- **Le contrôle est livré avec la capacité** : une section « Moments anticipés » dans Réglages › Notifications proactives, **un interrupteur par genre** (lecture tolérante, écriture stricte), la capacité elle-même dans le panneau des commutateurs (ADR-280), un compteur `proactive_moments_total{kind,outcome}` et une latence « échéance → notification » dessinés sur le tableau de bord du battement, et `task moments:preflight` qui dit ce qu'un compte se verrait proposer maintenant — en lecture seule, sans écrire ni ligne, ni notification, ni consultation.
- **La puce « Surveiller » du briefing** crée une routine à condition « courrier de cet expéditeur » là où ses voisines ouvrent le chat — le chat ne sait pas rédiger une condition. Elle se clé sur l'**expéditeur**, jamais sur le sujet, se termine par la fin de série de la routine, et **lit ce que le compte tient déjà avant d'écrire** : deux courriers d'un même expéditeur sont ordinaires, et deux veilles identiques annonceraient une même réponse deux fois.
- **Une quatrième forme d'habitude, `intermittent`** : la _densité_ de jours distincts sur l'empan éligible décide de l'étiquette, jamais du verrou ; sous 0,6, l'habitude est « plusieurs fois par semaine vers {heure} » (six langues, suggestion et libellé), `days_of_week()` rend `[]` — aucun calendrier promis, et le battement n'en fabrique pas de créneau. Avant, un 3×/semaine détecté sortait « tous les jours vers 9 h ».
- **`RecurrenceLedgerSilent`** dans le cœur d'alertes chargé, avec son runbook et ses tests promtool : elle lit trois compteurs — les tours actionnables **humains** du routeur, les écritures **atterries** (incrémentées par l'écriture elle-même, `redis_unavailable`/`failed` sinon) et `feature_disabled` pour taire un ledger coupé par configuration. Sa première expression, revue le même jour, était juste sur la forme du bug et fausse dès le correctif.
- **Un harnais de calibration durable** (`task habits:calibration:measure`, protégé par `test_calibration_harness.py`) : populations denses et modérées ciblées, chacune avec son contrôle dispersé **à volume égal**, et une métrique de délai — taux de détection à J+14, 21, 28, 42, 56. L'ancien harnais était un scratchpad perdu ; les ancrages sont épinglés à vingt essais déterministes.
- **Garde de contrat `get_qi_attr`** : toute lecture littérale doit nommer un attribut déclaré de `QueryIntelligence`. Elle attrape les quatre lectures mortes et interdit la cinquième.

### Changed

- **Une routine finie se ferme** (`is_enabled = false`, `status = completed`) : `SeriesEnd` finissait déjà une série de trois façons, toutes sur le même déclencheur nul, mais rien ne fermait la **ligne**. Une colonne `expires_at` a été écrite puis **retirée** avant livraison — elle aurait été une seconde autorité sur la fin d'une routine à côté d'une `SeriesEnd` déjà stockée, validée, éditée dans le studio et racontée en six langues.
- **Les veilles sont servies au réveil, avant les portes** — le pré-contrôle « ce compte a-t-il une veille due » ne coûte qu'une requête bornée ; le réveil arme la prochaine lecture **au-delà** du TTL publié du cache de recherche Gmail, parce qu'un cache rempli avant l'arrivée du courrier répondrait « non satisfait » et que **ce verdict consomme l'armement**. Il ne fait qu'avancer une échéance, jamais ressusciter une série épuisée.
- **Recalibration des récurrences, mesurée** (amendement b d'ADR-214) : `RECURRENCE_WINDOW_DAYS` 28 → **35** (cinq créneaux hebdomadaires ; une semaine manquée ne tue plus le verrou : 71 % → 91 % de détection stable pour un rituel fiable à 90 %), `RECURRENCE_LOCK_MIN_OCCURRENCES` 8 → **6**, l'étiquetage attend un **empan calendaire** de dix jours et plus jamais quatorze jours distincts — un 3×/semaine n'en atteignait jamais quatorze sur vingt-huit, indétectable pour toujours ; un quotidien est reconnu à J+14 (98 %) au lieu de J+21. Un sens qui change prend un **nom nouveau** : `RECURRENCE_SHAPE_MIN_SPAN_DAYS` remplace `RECURRENCE_SHAPE_MIN_DAYS`, et l'ancienne clé est ignorée plutôt que réinterprétée. `HABITS_SELECTIVITY_MIN` 1,9 → **1,6** (détection à 35 % de bruit 84,7 → 97,3 %), l'exit d'hystérésis suit (1,36). Deux nouvelles clés, `RECURRENCE_DAILY_DENSITY_MIN` (0,6) et `RECURRENCE_INTERMITTENT_R_MIN` (0,9 — un arc de veille uniforme porte R ≈ 0,53 et franchissait 0,8 par chance dans 3 % des contrôles ; résidu 0,3 %). Le démarrage **refuse** `RECURRENCE_LEDGER_MAX_ENTRIES < RECURRENCE_WINDOW_DAYS`, qui tronquerait chaque fenêtre. La relaxation du rythme a été mesurée et **refusée** : 8-17 % de revendications permanentes sur un usage sans structure pour 35 % de détection.
- **Ce que le déploiement doit savoir** : un `.env` de production qui pinne explicitement ces seuils à leur valeur d'août tournerait la recalibration à moitié — étiquetage nouveau, volumes anciens. Les cinq lignes concernées sont nommées dans l'amendement.
- **La signature d'une récurrence reste le domaine primaire seul** : composer les domaines secondaires fragmenterait chaque clé — moins d'occurrences par signature, verrous plus lointains. Décision séparée, à mesurer avant d'être prise.
- **Les deux échecs du ledger sont loggués aux niveaux que la production expédie** (warning à l'écriture, error à la planification) : une ligne `debug` était une trace que personne ne pouvait lire.
- **La question d'un moment est posée par un prompt à elle**, qui ne demande que la question : l'évaluation de la réunion n'est jamais produite.
- **Sur téléphone, le titre d'un fichier généré tient sur deux lignes** avec césure des noms sans espace, au lieu d'une seule ligne à ellipse — le titre est ce qui identifie un document — et les onglets Images / Documents / Captures cèdent leur icône au mot sous `sm` plutôt que d'afficher « Docu… ».
- **`.env.prod.example` rattrape `.env.example`** : 66 clés lues en production y manquaient — les onze du réveil poussé (`PUSH_WAKE_*`, absentes depuis v1.40.0), les onze des moments, les douze de la détection de récurrences, les vingt-six des habitudes, les quatre des seuils adaptatifs, `NEXT_PUBLIC_PRESENCE_THROTTLE_MINUTES` et `DOCKER_GID` — chacune insérée dans SA section, à la place que `.env.example` lui donne, avec sa valeur et son commentaire ; et les vingt-quatre clés `SKILLS_URL_IMPORT_*` / `SKILLS_SCRIPT_*` / `PYTHON_SANDBOX_*` qui vivaient sous « [61] AGENT PLUGINS » rejoignent « [60] SKILLS ». Les trous voulus restent (clés de développement, outillage `[99]`/`[100]`), et le vrai lecteur du fichier rend le même dictionnaire pour toute clé déjà présente.
- **Deux dérives du guide du battement corrigées** : il annonçait un cooldown de 2 h (réel : 1 h) et 6 h de calendrier (réel : 4 h), et nommait un modèle précis à cinq endroits alors que le modèle réellement utilisé est celui que `llm_config_overrides` porte pour le poste (ADR-244).

### Fixed

- **Une conversation mourait au bout de six jours de mode ReAct** (amendement d'[ADR-256](docs/architecture/ADR-256-React-Budget-Conservation-And-Declared-Tool-Safety.md), mesuré en production) : `react_tool_seconds`, le temps passé dans les outils, était débité en `précédent + dépensé` et restitué par le point de reprise à chaque tour, mais la remise à zéro de début de tour — une liste de clés tenue à la main dans le routeur, écrite avant ADR-256 — ne le nommait pas. Sur un fil, le cumul est passé de 77 s à 913,8 s en six jours d'usage ordinaire ; à partir de là, chaque tour ReAct s'arrêtait à l'itération 1 (`tool_budget`), le modèle ayant bien émis `create_reminder_tool` et `create_event_tool`, tous deux abandonnés : trois relances, trois « ko », aucune erreur. `react_productive_iterations` (ADR-248) portait le même oubli dans l'autre sens et gonflait le budget adaptatif jusqu'au plafond dès les premiers tours ; une routine (un fil pour toute sa vie) et un ticket atteignaient le même mur, plus lentement. Ce qu'un tour commence avec est désormais **une déclaration**, `react_turn_reset()`, dépliée par le routeur, et un garde AST refuse toute clé lue par le prédicat d'arrêt qu'elle ne nomme pas. Aucune migration : le premier tour après déploiement repart de zéro dans chaque fil. Le mode pipeline n'était pas concerné (ses bornes sont à l'horloge murale, rien n'est additionné dans l'état).
- **Le ledger de récurrences n'écrivait rien** : `get_qi_attr(state, "intent")` lisait un attribut inexistant (le champ s'appelle `immediate_intent` et son vocabulaire ne contient de toute façon pas `action`) ; même mécanisme pour `secondary_domains`. `resolve_actionable_domain` lit désormais `routing_history[-1].intention` — la décision du routeur, la valeur même dont `product_outcomes.result_type` dérive, si bien qu'un tour que le tableau de bord compte comme une action est un tour que le ledger enregistre. Vingt-cinq clés résiduelles d'un seed antérieur défectueux, figées et indiscernables du vivant, ont été purgées avant le correctif ; le recalcul nocturne re-sème depuis les vrais tours.
- **Les galeries débordaient à droite sur téléphone** — image décentrée, titre coupé sans ellipse, bord droit du panneau coupé. La grille des cartes n'avait pas de colonne explicite sous `sm` : la colonne implicite `auto` prenait la largeur du titre en `nowrap`, soit une carte de **665 px dans un panneau de 254 px**. Le test 320 px existant était vert : il mesurait le défilement du document, or la section rogne, et il servait une carte au nom court. Sept autres grilles du même motif durcies (workboard, raccourcis, landing, showroom, usage).
- **Une vignette montre l'image entière** : `object-cover` remplissait la tuile en coupant ce qui ne tenait pas — sur une vignette dont le seul rôle est « est-ce le fichier que je cherche ? », la partie coupée est celle qui répond. Et **un document porte la marque de son type**, à la hauteur de la vignette, par la table que la carte du chat et la visionneuse partagent déjà : la carte de texte seul laissait une grille en dents de scie.
- **Une revendication abandonnée était immortelle** (revue à froid d'ADR-281, mesuré contre le vrai serveur) : un moment revendiqué puis jamais soldé n'était atteint par aucune instruction du module — encore là, intact, à +365 jours. `reclaim_stale` le rend à `pending` en lisant l'**âge de la revendication** (`MOMENTS_CLAIM_LEASE_MINUTES`, quinze minutes par défaut), jamais la fenêtre, si bien qu'il peut être **réessayé** tant qu'il vaut quelque chose.
- **La règle de chaîne ne voyait pas la réunion suivante** : la lecture s'arrêtait à `now`, une réunion pas encore commencée était absente, et LIA demandait « comment ça s'est passé ? » au milieu de la suivante — précisément ce que la règle de bloc existe pour empêcher. La fenêtre va jusqu'à `now + gap`, exactement aussi loin que la règle teste ; ce qui revient du futur ne sert que de brise-bloc.
- **La revalidation ne lisait pas le refus de participation**, que son propre docstring promettait : une réunion déclinée n'est pas une réunion qu'on a eue. Et le refus avait **deux implémentations** — la fonction partagée et une copie inline dans le scoreur, qui importait déjà ses briques ; une seule reste, vérifiée sur la source.
- **Deux avertissements de moins dans les suites** : la constante Starlette `HTTP_422_UNPROCESSABLE_ENTITY`, dépréciée, remplacée par `HTTP_422_UNPROCESSABLE_CONTENT` aux trois points qui l'écrivaient ; et un test des outils Contacts qui passait une chaîne à un champ `UUID` du contexte typé — onze avertissements Pydantic par exécution, venus du test seul.
- **Un faux négatif corrigé avant tout code** : le programme prévoyait un lot pour « la boucle de réponse à un moment » ; treize tests de caractérisation prouvent qu'elle existait déjà (`_inject_proactive_messages`), et le lot a été supprimé plutôt qu'écrit.

### Tests

- **462 tests** de plus — 394 côté serveur et 68 côté navigateur — dont l'intégration sur un vrai PostgreSQL : la revendication périmée reprise puis réessayée par deux acteurs indépendants, la fermeture d'une routine finie, le dépôt et la déduplication des moments. Les deux lectures de « ce courrier correspond-il ? » (ressource brute et projection d'affichage) sont **épinglées par un test d'accord sur onze courriers**, leur seule divergence légitime écrite plutôt que découverte.
- Le débordement de la galerie est **prouvé rouge sur l'ancien composant** : vingt-quatre cartes aux titres réels, le bord droit de chaque carte mesuré contre l'écran (660 px avant, 320 après) — l'oracle que le test précédent n'avait pas.
- Les ancrages de calibration sont **mesurés, pas supposés** : 300 essais par case dans le harnais, vingt essais déterministes épinglés en CI, et les contre-exemples refusés (relaxation du rythme, weekly assoupli) gardés dans le balayage pour que les tables montrent le coût refusé.

## [1.44.1] - 2026-09-10

**Un fichier produit par LIA appartient à la personne, pas à la conversation.** Images générées, rapports, présentations, captures de navigateur : tous étaient écrits dans la table des pièces jointes, **strictement indistinguables d'un téléversement**. Rien ne les listait — le seul chemin vers le rapport d'hier était la conversation qui l'avait produit — et « effacer cette conversation » effaçait aussi les images générées la semaine précédente, dans d'autres conversations. Trois galeries les rendent, l'échéance de rétention est dite **avant** qu'elle ne tombe, et une réinitialisation ne retire plus que ce que la personne a mis.

**Le panneau d'administration offrait douze capacités pendant que le produit en livrait vingt-cinq.** Le tableau de travail, les journaux, les habitudes, les notifications proactives, les connexions entre comptes, le profil psychologique, la mémoire à long terme, les débriefs de relation, le Python éphémère : **treize fonctionnalités qu'une personne vit et qu'un exploitant ne pouvait ni voir ni couper sans redéployer**. La partition est désormais vérifiée dans les deux sens — une fonctionnalité livrée sans commutateur refuse le démarrage, un commutateur que personne n'a décidé d'expédier aussi.

**Et une seule variable d'environnement décidait de la taille de contexte de tous les modèles Ollama à la fois** : mesuré en production, 128 000 jetons demandés pour un modèle de 4 milliards de paramètres comme pour un de 27. Elle est supprimée — la fenêtre est une colonne du poste configuré, pré-remplie par ce que le serveur dit du tag, et deux postes sur le même modèle peuvent légitimement différer.

### Added

- **Mes fichiers générés** ([ADR-279](docs/architecture/ADR-279-Generated-Assets-Gallery.md)) : trois galeries — images, documents, captures de navigateur — une seule montée à la fois. Chaque carte porte l'aperçu, le titre que le producteur connaît, la taille et **son échéance**, dont le ton passe au chaud six heures avant l'expiration. Recherche sur le titre et le nom de fichier, deux fenêtres de dates, quatre tris ; la page et son **total exact** sortent du même `WHERE`, et le plafond de page est publié dans la réponse parce qu'il est imposé. Sous `lg`, les filtres se replient derrière un résumé qui dit ce qu'ils retiennent.
- **Un commutateur par capacité** ([ADR-280](docs/architecture/ADR-280-Complete-Capability-Control.md)) : vingt-cinq, groupés en six familles **déclarées par le backend** — deux tables finiraient par ne plus être d'accord — dans l'ordre de la déclaration et jamais celui de la charge utile, une famille inconnue dessinée en dernier plutôt que perdue. Le panneau dit **où** un commutateur mord : sur la route, à un point d'étranglement interne, ou les deux.
- **La constellation des capacités gagne cinq étoiles** : fils ouverts, tableau de travail, rappels, fichiers générés, et une vraie entrée Relations — **sans compteur**, parce que la page Relations est une lentille sur les contacts et les messages et ne possède aucune ligne à compter.
- **La fenêtre de contexte appartient au poste configuré** ([ADR-278](docs/architecture/ADR-278-Per-Slot-Context-Window.md)) : colonne nullable, champ d'administration pré-rempli avec ce que le serveur déclare du tag et le maximum du modèle affiché en dessous. La découverte lit d'abord le listing, qui porte capacités **et** longueur de contexte pour tous les tags ; un tag que rien ne décrit ne reçoit plus de profil et il est **nommé** au lieu d'être publié « sans outils, sans pensée, plafonné ».
- **Le panneau de debug dit ce que le tour a vraiment fait** : un relevé par appel de modèle où **chaque clé est présente à chaque fois** — fournisseur, température, plafond de sortie, intention de raisonnement, empreinte des paramètres — avec `null` là où rien n'a été observé, plutôt qu'une clé absente qu'on lit comme un zéro. Les bornes ReAct, le motif d'arrêt, la fenêtre du poste, la section HITL dessinée sur une décision de brouillon, et une section **Registres** qui lit les effets, les traitements et les verdicts du tour en cours.
- **Les directives ne se suppriment plus, elles se corrigent** : une mémoire de catégorie procédurale — « appelle-moi par mon prénom », « réponds toujours en français » — est protégée de la suppression par la rétention, l'invalidation, la consolidation et l'extracteur. La modifier reste permis ; c'est la seule façon de changer une règle qu'on a soi-même posée.
- **Revenir d'où l'on vient depuis Réunions** : l'origine voyage en **jeton**, jamais en URL — une URL en paramètre est une redirection ouverte — et son vocabulaire est la table des destinations du tableau de bord, avec repli sur le chat.

### Changed

- **Une réinitialisation de conversation conserve les fichiers générés.** `delete_all_for_user` prend une famille d'origines et la réinitialisation passe « téléversements » : elle retire ce que la personne a mis, rien d'autre. Le TTL, lui, expire toujours tout — la galerie rend l'échéance visible, elle ne la repousse pas.
- **Téléverser et consulter sont deux capacités qui partagent une table** : la garde de capacité quitte le routeur des pièces jointes pour se poser sur la seule route d'envoi. Couper les téléversements ne ferme plus la porte sur des fichiers que la personne garde légitimement et ne l'empêche plus de les supprimer.
- **Pourquoi un fichier est parti est enregistré sur l'étiquette que le tableau de bord groupe déjà** — expiré, réinitialisation, supprimé par la personne — sans créer la moindre métrique : avant, vider sa galerie était indistinguable d'une réinitialisation de conversation.
- **Les points d'étranglement de service lisent la capacité à l'appel**, plus le drapeau d'environnement : un commutateur basculé après le démarrage prend effet sans redémarrage.
- **L'aperçu d'un résultat d'exécution a la même grammaire Markdown que la demande qui l'a précédé.** Le bloc ouvrait chaque champ par un saut dur **et** les joignait : une ligne vide par champ dans le chat, et la balise lue telle quelle sur un commentaire de ticket, qui ne rend rien.
- **Les filtres du tableau de travail se replient sous `lg`** derrière le compte exact de ce qu'ils retiennent, le même mécanisme que la galerie.

### Fixed

- **Une notion interne de LIA atteignait le SDK de cinq fournisseurs sur sept, et tuait chaque appel.** La fenêtre de contexte passait par le canal générique que chaque branche reforward à son client : `AsyncCompletions.create() got an unexpected keyword argument 'context_window'` sur DeepSeek, Anthropic, Gemini, Qwen et Perplexity — **indépendamment de toute configuration**, puisque la clé est toujours passée, `None` compris. Elle est consommée une fois, au point d'étranglement, puis remise **nommément** à la seule branche qui sait l'exprimer. Le garde de couture qui existait pour cette classe de défaut vérifiait le **type** des valeurs ; il vérifie désormais aussi les **clés**, sur les sept branches, avec et sans valeur.
- **Un modèle que le fournisseur a retiré demandait de réessayer.** Le code `410` ne figurait pas dans l'échelle de classification, donc un tag retiré tombait dans « inconnu », dont le texte se termine par « veuillez réessayer » — pour un modèle qui ne répondra plus jamais. `410` est le frère permanent de `404` : il prend la même catégorie, dont le message dit la seule chose utile et pointe l'écran où corriger.
- **La réinitialisation aurait délié du disque des fichiers dont la base garde la ligne** : la lecture des chemins ignorait le filtre d'origines que la suppression appliquait — les deux moitiés d'une même opération ne parlaient pas du même ensemble. Invisible à tout test unitaire.
- **Le même identifiant deux fois comptait deux suppressions pour un fichier.** L'écran envoie un ensemble, donc rien ne l'atteignait depuis l'application ; l'API est une surface publique et répond à ce qu'un client poste.
- **Supprimer le dernier fichier de la dernière page laissait une grille vide** sous un pagineur annonçant « page 3 sur 2 ».
- **La borne ReAct affichée n'était pas la borne imposée** : le panneau publiait le plafond dur quand la boucle s'arrête au budget de départ prolongé par sa productivité. Un tour arrêté à quatre itérations se lisait « 4/25 ».
- **Le panneau annonçait « appliqué sur les routes » d'une capacité gardée dans un service** : le champ nommait les routes et portait les deux.
- **Une étoile appelée « Relations » comptait des fils ouverts** et menait à leur section : une personne lisait « Relations : 4 » quand la figure était quatre fils non terminés.
- **La liste d'outils d'une capacité était livrée sans assertion de complétude** : un nom mal orthographié n'aurait rien filtré, en silence.
- **La carte des capacités tenait dix-huit contextes de session ouverts au même instant**, contre un pool de vingt plus dix de débordement : un seul chargement de page en prenait l'essentiel et un deuxième lecteur attendait. Onze millisecondes rachètent dix-sept sessions.
- **Une image produite par LIA ne s'affichait plus, alors que l'ouvrir la montrait.** L'application répond `Cross-Origin-Embedder-Policy: credentialless` : sous cette politique, une image intégrée servie par une AUTRE origine est demandée **sans identifiants**, le cookie de session n'atteint jamais l'API et elle répond 401. Une navigation de premier niveau n'est pas une sous-ressource — d'où l'asymétrie qui faisait lire une panne d'authentification comme un défaut de rendu. Le défaut n'était atteignable que depuis que ces URL sont résolues contre l'origine de l'API : une image de même origine porte toujours ses cookies. Une seule des quatre surfaces concernées portait l'attribut, posée là où la panne avait été rencontrée ; `apiImageProps` le donne maintenant à toutes, uniquement quand l'URL a réellement changé d'origine — une image étrangère échouerait un contrôle CORS qu'on n'a pas à lui demander. Une garde lit les sources et refuse la forme d'origine.

### Tests

- **734 tests** de plus — 573 côté serveur et 161 côté navigateur — dont l'intégration sur un vrai PostgreSQL : le rétro-remplissage de la migration prouvé sur des lignes héritées des quatre formes, la chaîne de commutation suivie de bout en bout par le vrai chemin d'audit, et le rétrécissement de la réinitialisation.
- La panne d'affichage est prouvée **sur la production elle-même** : les en-têtes de la page et de l'API mesurés côté à côte, et l'API répondant déjà `access-control-allow-credentials` pour l'origine de l'application — il ne manquait que la demande.
- La classification d'un modèle retiré est **prouvée contre le serveur réel** : l'exception que lève le client porte bien son code, et un test épingle cette forme — le substitut qu'utilisait la garde précédente répondait d'avance à la question posée.

## [1.44.0] - 2026-09-10

**Une unité de travail avec un cycle de vie, un porteur et un résultat.** Les tâches d'un fournisseur sont une liste sans cycle de vie ni porteur ; un rappel est une poussée à un instant, dont rien ne subsiste après la sonnerie ; une routine est une instruction répétée qui ne se termine jamais. Le **workboard** tient ce qu'aucune de ces surfaces ne tenait : UNE ligne par ticket, partagée par son propriétaire et son détenteur, à travers sept colonnes — et le détenteur peut être LIA, qui revendique alors un ticket par balayage, l'exécute hors tour et écrit ce qu'elle a fait.

**Rencontrant une action qu'elle ne peut pas mener seule, elle DEMANDE au lieu de refuser.** Hors tour, la porte des effets refusait aussi bien une confirmation qu'un brouillon ; un run de ticket, lui, peut porter la question à quelqu'un. La carte que le chat aurait montrée est écrite sur le ticket, et répondre tient en un commentaire — oui, non, ou ce qu'il faut changer. Ce qui a été montré est rejoué sous verrou d'empreinte : une approbation couvre cette action exacte et rien de plus large.

**Deux mesures ont dessiné la conception.** Une contrainte `CHECK` croisant deux colonnes qu'une action de clé étrangère peut modifier est violable quel que soit le sens des cascades — **invisible à vingt tests de modèle verts, trouvée au premier `DELETE FROM users` sur un vrai PostgreSQL**. Et le chunk de flux que le moteur d'exécution attendait n'est **émis par personne** : six lots verts durant, une demande de clarification se soldait en SUCCÈS.

### Added

- **Le workboard** ([ADR-276](docs/architecture/ADR-276-Workboard.md)) : un ticket porte un titre, une description, une priorité, des dates, des sous-tickets, des commentaires et une histoire, à travers sept colonnes dont six sont toujours à l'écran — « À confirmer » n'est dessinée que lorsqu'elle tient quelque chose. Le tableau de quelqu'un est « il le possède OU il le détient », prédicat écrit une seule fois et réutilisé par toutes les lectures, si bien que les deux côtés ne peuvent pas se contredire. Un ticket qu'on ne voit pas répond 404 comme un ticket qui n'existe pas.
- **LIA exécute les tickets qu'on lui confie.** Un balayage à la minute revendique **UN** ticket (`FOR UPDATE SKIP LOCKED` et un `UPDATE` conditionnel dans la même transaction, validée avant que le moindre travail commence — un worker qui en aurait pris cinq en abandonnerait cinq), l'exécute, puis solde depuis un résultat **EXPLICITE**, jamais depuis l'absence d'exception. Trois refus arrêtent un ticket revendiqué et **aucun n'est un échec** : compte inactif, plafond de quota, conversation occupée — les deux derniers rendent la revendication, restituent le run au budget du ticket et se journalisent « sauté ».
- **La confirmation hors du chat.** Le ticket porte le brouillon (`pending_action`), le commentaire de LIA est exactement la carte que le chat aurait montrée, et la dernière note du propriétaire est classée **sans appel modèle** par un lexique en six langues replié comme elle : approbation nue, refus nu, ou tout le reste — qui devient une consigne. **Envoyer le commentaire suffit** : le ticket repasse à LIA en « À faire », ses compteurs de tentative remis à zéro, sous le plafond de runs vérifié AVANT la relance.
- **Le rejeu tourne dans le graphe, sous verrou d'empreinte.** Le run publie l'identité de ce qu'il a montré (type de brouillon + empreinte du contenu) ; `decide_draft` laisse passer sur cette identité exacte et sur rien de plus large — identique, confirmé ; différent, nouvelle question avec le nouvel aperçu. Un lot de brouillons est UNE identité : c'est le lot entier qui est approuvé, pas son premier élément.
- **LIA relance d'elle-même ce qui le mérite**, avec le motif qui l'a fait remonter : échéance passée, échéance proche, question en attente depuis trop longtemps, résultat livré non validé. Le rétrécissement vit **en SQL** sous un tri explicite — un tableau peut porter des milliers de tickets et la décision en veut huit — le refroidissement démarre à la délivrance et non à la lecture, et un ticket arrêté est **cité**, jamais paraphrasé.
- **Réglages › Workboard est le tableau en un coup d'œil** : total, en retard, chez LIA, à votre décision, un compte exact par colonne, chacun un lien vers le tableau déjà réduit ; la capacité en jauge sous son plafond publié, et le coût dans le vocabulaire du compteur du chat.
- **Mes raccourcis** ([ADR-277](docs/architecture/ADR-277-Settings-Shortcuts-Dock.md)) : les sections de réglages que l'on fréquente, épinglées et présentes sur tous les écrans dans une capsule flottante. Ce qui est épinglé appartient au **COMPTE** et suit la personne d'un navigateur à l'autre ; où la capsule se trouve appartient à l'**APPAREIL**. La capsule se déplace, se replie en pastille, revient d'un clic, et dépliée depuis la moitié basse de l'écran elle grandit **vers le haut** pour ne jamais sortir du cadre.
- **Un tableau de bord Grafana** (29) avec les issues des runs, les rejeux (`workboard_replays_total{result}`), les notifications et le coût des lignes cachées (`lia_hidden_run_rows`, `lia_hidden_run_bytes`) — parce qu'une borne se mesure au lieu de se supposer.

### Changed

- **Le mode d'exécution est une colonne de la LIGNE.** Chaque ticket et chaque action planifiée porte le sien (`execution_mode`, NOT NULL, `react` par défaut), modifiable tout au long de sa vie et lu à la **prochaine** exécution. Le réglage d'instance qui décidait pour tout le monde est supprimé, sa constante et ses lignes `.env` avec : deux autorités sur une même question, c'est une de trop, et celle qui reste est celle que la personne voit.
- **La carte de confirmation a UN auteur, et c'est le renderer.** Elle était écrite par le modèle sous un prompt qui la décrivait, donc sa forme variait avec lui — des champs devenus paragraphes, un `---` affiché tel quel. `render_confirmation_card` la rend désormais et l'interaction la streame **avant** le premier jeton du modèle ; le prompt ne demande plus que la question. Même carte dans le chat et sur le ticket, moins de jetons, et le repli sans modèle la montre aussi.
- **L'aperçu d'un brouillon a UNE forme, et c'est du Markdown.** Une liste tient un champ par ligne sans balise là où le chat rend le Markdown, et s'aplatit proprement là où rien n'est rendu (`markdown_to_plain_text`, qui ne fait que RACCOURCIR, donc le plafond des commentaires tient toujours). La ponctuation entre un libellé et sa valeur voyage avec les LIBELLÉS — espace insécable avant le deux-points français, pleine chasse en chinois — au lieu d'être un `": "` qui publiait de la ponctuation anglaise dans six langues.
- **Chaque chose qu'un run dit est revendiquée à part** dans le registre des effets : la revendication était UNE par run, écrite pour des balayages qui ne parlent qu'une fois. La couture nomme désormais l'`occurrence`, et elle EXIGE le run qui a causé la notification au lieu d'y substituer un identifiant en silence.
- **Tout module qui interroge la table des messages hors de son repository DÉCLARE sa portée** (`conversations/message_readers.py`, garde AST) : onze lecteurs, `VISIBLE_ONLY` ou `WHOLE_RECORD` avec sa raison écrite. Le prédicat `hidden` du repository ne dit rien du `select` qu'un module écrit lui-même.
- **Toute métadonnée archivée d'un tour est construite par un `build_*_metadata`** (garde AST contre un dictionnaire écrit sur place) : un tour en archive TROIS, pas deux — la question de la personne, la réponse, et la question que LIA a posée au lieu de répondre.
- **Un filtre de rétrécissement est plus permissif que le décideur, jamais moins** : `core/sql_search.py` porte le repli d'accents en SQL, si bien que la recherche du tableau accepte ce que le décideur accepterait.
- **Le glisser-déposer s'arrête sous `lg`** : sur un téléphone un balayage change de colonne, un doigt posé n'importe où sur une carte ouvre son détail, et la colonne comme le porteur sont deux listes portées par la carte elle-même, chaque item avec son glyphe.

### Fixed

- **Une clarification se soldait en SUCCÈS.** Le moteur attendait un chunk `hitl_interrupt` qui n'est **émis par personne** ; il lit désormais l'interruption dans les chunks que le flux émet vraiment (`hitl_interrupt_metadata` → jetons de la question → `hitl_interrupt_complete`). Six lots verts avaient passé au-dessus.
- **La sonde de question pendante lisait le point de reprise LangGraph**, qui dit « interrompu » jusqu'à la prochaine entrée : lue là, tout ticket ultérieur du compte s'écartait pour une question que personne ne pouvait voir. Elle lit l'enregistrement Redis sur lequel le chat route déjà ses réponses.
- **La consolidation des journaux filtrait des rôles que la base n'écrit jamais** (`human`/`ai`) — morte depuis la v1.7.0 et invisible à tout test unitaire qui simule la session — et prenait l'heure UTC pour celle de la personne. Réparée, prouvée sur PostgreSQL en fuseau `Pacific/Kiritimati`.
- **`context_domain` sur un outil de lecture était inerte** sans `RegistryItemType`, `ContextTypeDefinition` enregistrée, `registry_updates` émis et `context_key` sur le manifeste : déclaré seul, il ne faisait rien, et une suppression confirmée laissait le ticket « courant ».
- **Neuf des vingt-six types de brouillon s'annonçaient `Draft (ticket_delete)`** — une valeur d'énumération, en anglais, dans les six langues, sur la carte demandant d'approuver une suppression. Table de dispatch avec garde de complétude au démarrage.
- **Tout aperçu de brouillon s'ouvrait sur une ligne vide** et chaque champ était séparé par deux : le rendu émettait `<br/>` en tête de ligne _et_ comme séparateur, alors que le chat rend le Markdown sans greffon de saut dur.
- **Un `ILIKE` sur l'aiguille brute écartait exactement les lignes que le repli d'accents existe pour attraper** : « reserver la salle » ne trouvait rien quand le tableau portait « Réserver la salle ».
- **Un statut lu APRÈS sa transition**, une libération à moitié commitée annonçant « 0 », un registre revendiquant une lecture qu'un drapeau avait empêchée, une source publiée sans libellé, un journal lu par son seul genre, une consigne envoyée sans sa donnée : sept défauts trouvés par la revue à froid du programme, chacun avec sa preuve.
- **Trois coutures de démarrage étaient câblées par un EFFET DE BORD D'IMPORT.** Chacune déclarait dans sa propre docstring qu'« un import que personne ne déclare est un import qui peut cesser d'avoir lieu », puis déclarait l'import et s'en remettait quand même à son effet de bord — qu'un cache de modules n'exécute qu'UNE fois par processus. Mesuré le 2026-09-10 : la garde de la couture de notification a refusé le démarrage dans un worker où la couture était parfaitement installable, l'adaptateur ayant seulement déjà été importé. Les trois étapes APPELLENT désormais leur installateur ; l'inversion de dépendance est intacte et la garde redevient ce qu'elle devait être — un refus quand personne n'a revendiqué la couture.
- **Un test qui remplace une globale de processus la remet.** Cinq globales étaient concernées — les trois coutures et les deux magasins par conversation (documents, images) — et deux tests verts en isolation échouaient dès que l'ordre aléatoire les plaçait sur le même worker. La restitution vit dans le conftest de la suite unitaire : la fuite est une propriété de la globale, pas du test qui l'a touchée.

### Tests

- **861 tests** couvrent le tableau — 613 côté serveur (dont l'intégration sur un vrai PostgreSQL : les quatre chemins de suppression, l'ordre des cascades, la libération transactionnelle) et 248 côté navigateur.
- **72 tests** couvrent les raccourcis épinglés et leur capsule, dont le dépliage vers le haut mesuré dans un vrai navigateur.
- Les parcours e2e du tableau mesurent ce que jsdom ne peut pas répondre : la géométrie des deux listes sur la carte téléphone, l'alignement de « En retard » sous la date, et le cadre du retard **dans les deux réglages de mouvement** — immobile et rouge sous `prefers-reduced-motion`, animé sinon.

## [1.43.2] - 2026-09-09

**Le prompt était soupçonné et n'était pas la cause : il demandait déjà plus que le renderer savait produire.** Mesuré : `python-pptx` par défaut, c'est le gabarit **4:3** et **2 layouts utilisés sur 11** ; Word, **4 styles nommés sur 164** ; le PDF, **aucune feuille de style**. Un jeu de douze diapositives était douze fois la même boîte grise, quoi que le prompt demande. Le modèle dit désormais ce qu'une chose EST — une séquence ordonnée, une citation, un avertissement, une ouverture de partie, une comparaison, des données — et le renderer la dessine avec les mécanismes natifs de chaque format.

**En regard, un défaut que personne ne voyait parce qu'il n'était visible qu'en développement : le lien de téléchargement d'un document généré ne partait jamais vers l'API.** Il était relatif, donc il visait l'origine du frontend — laquelle n'atteint l'API que là où un reverse proxy réécrit `/api/v1/*`. Sept autres surfaces partageaient la même erreur, dont les images générées, les captures d'écran et trois exports.

### Added

- **La facture appartient au renderer, le sens au modèle** ([ADR-274](docs/architecture/ADR-274-Document-Craft-Renderer-Owned-Model-Semantic.md)). Un vocabulaire SÉMANTIQUE — `numbered`, `quote`, `callout`, la légende d'un tableau, le genre d'une diapositive — jamais un catalogue de gabarits, jamais une identité visuelle. **Word** : styles nommés redéfinis (le lecteur peut tout restyler depuis sa galerie), champs `PAGE`/`NUMPAGES`, définition de numérotation multiniveau, sommaire, en-tête et pied. **PowerPoint** : **16:9 paysage**, un layout par genre — Titre, Ouverture de partie, Titre et contenu, Comparaison, tableau natif —, le numéro de diapositive en champ. **Excel** : colonnes TYPÉES par unanimité (un entier reste un entier, un code à zéro de tête reste du texte), format d'affichage par colonne, en-tête figé, Tableau nommé donc filtre et bandes. **PDF** : feuille de style, sommaire **sur sa propre page et à numéros EXACTS**, signets et liens.
- **Rien ne déborde, par construction.** `fit.py` mesure le texte avant de le poser, calibré contre PowerPoint 16 sur **54 combinaisons** : toute largeur moyenne de glyphe dans **[0,426 ; 0,493] em** compte les lignes exactement, et la hauteur × **1,05** transforme 18 sous-estimations en **zéro**. Ce qui ne tient pas est réduit jusqu'à 14 pt puis SCINDÉ en diapositives « Titre (2/3) » ; une puce trop longue est coupée aux fins de phrase, jamais rognée. `fit_text` de python-pptx a été mesuré faux d'un facteur deux.
- **Un glyphe pleine chasse vaut un em, par définition.** Toutes les mesures de calibration étaient latines : compter un idéogramme à 0,46 em mesurait une diapositive chinoise dense à **238 pt là où elle en prend 442** dans un cadre de 356 — et l'oracle de débordement était d'accord avec le renderer, puisque tous deux lisent le même module. PowerPoint tranche : **2 débordements dont un de 124,1 pt** avant, **0** après. La règle est une généralisation stricte (une chaîne latine mesure toujours `len × 0,46`), donc les 54 mesures tiennent sans être rejouées, et **une seule notion de largeur** sert désormais le compte de lignes, les poids de colonnes PowerPoint et la largeur des colonnes Excel.
- **Une sortie tronquée est un refus, jamais un sauvetage** ([ADR-275](docs/architecture/ADR-275-Truncated-Structured-Output-Is-A-Refusal.md)). `json_recovery` refermait la structure ouverte et l'objet raccourci VALIDAIT : mesuré, **12 coupures de rapport sur 100 et 14 de jeu de diapositives sur 100 devenaient des documents plus courts annoncés « générés avec succès »**, et une coupure qui ne validait pas était rejouée trois fois au plein tarif. Le verdict du fournisseur — cinq écritures selon l'adaptateur — est lu aux **trois** portes, et seulement une fois qu'aucune réponse complète n'existe : une charge utile que le fournisseur a analysée sans réparation est close, la refuser coûterait un document valide et une seconde facture.
- **`infrastructure/llm/output_truncation.py`** : une seule lecture de « le fournisseur s'est arrêté sur son budget de sortie ». Rien ne la rejoue — ni l'enveloppe de réessai, ni le validateur sémantique, ni le job de réunion, où toute `StructuredOutputError` était `transient=True` : une synthèse coupée était re-drivée jusqu'à épuisement du budget de tentatives. Une troncature est PERMANENTE (`synthesis_too_long`).
- **Un corpus de treize documents, mesuré par Office lui-même** (`task documents:corpus:measure`) : **0 débordement sur 69 diapositives**, toutes en 960 × 540 pt ; Word calcule ses champs (`Page 1 / 10`, et `第 1 页，共 7 页` sur le document chinois) ; le sommaire existe sur les documents longs et pas sur les courts ; Excel ouvre chaque classeur sans réparation. Un test prouve qu'un fichier s'ouvre ; il ne prouve pas qu'il est bien composé.

### Changed

- **Le budget de longueur suit la FAMILLE du document.** Mesuré avec `o200k_base` sur de grands documents réalistes : prose et diapositives convergent à **0,69 mot par jeton de sortie**, un classeur à **0,25** — les cellules courtes font dominer la structure JSON. Un facteur unique publiait donc un nombre **2,2× trop généreux pour un tableur**, et un modèle qui obéissait au budget qu'on venait de lui donner se faisait quand même couper : le piège d'ADR-184 retourné contre son auteur.
- **Toute incohérence est RÉPARÉE, aucune n'est refusée** : niveaux de titre bornés, blocs vides écartés, markdown qui a fui dans un paragraphe converti en ce qu'il est, numéros de titre écrits par le modèle retirés quand le renderer numérote, lignes de tableau inégales ÉLARGIES (tronquer perdrait ce que le modèle a écrit), en-têtes rendus uniques, et **les caractères que XML interdit supprimés** — python-docx et openpyxl les REFUSENT, si bien qu'un modèle recopiant un saut de page extrait d'un PDF tuait le rendu **après** que l'appel a été payé. La borne `level` est RETIRÉE du schéma : une borne fait échouer tout le document, trois fois payé, pour un seul titre.
- **Une liste que le modèle place dans `text` au lieu de `items` est lue pour ce qu'elle est.** Le repli l'aplatissait en une phrase portant un tiret parasite — et rendait la normalisation non idempotente, la seconde passe reconnaissant le markdown que la première avait détruit.
- **Les comptes rendus de réunion gagnent la facture et gardent leur forme** : ils épinglent `structure="plain"`, donc en-tête courant, pagination et tableaux soignés, sans l'appareil des documents longs.
- **Cinq registres indexés par le vocabulaire refusent désormais une table partielle au démarrage** (ADR-085) : les vocabulaires sont LUS du schéma (`BLOCK_KINDS`, `SLIDE_KINDS`), jamais retapés.
- **Le prompt d'écriture publie ce que le renderer applique** (ADR-184) : densité des diapositives, longueur des puces, seuil du sommaire et budget de longueur voyagent en placeholders lus des réglages. Coût mesuré : le prompt passe de **855 à 1 234 jetons**, les schémas de 193–431 à 259–597 ; l'estimation publiée du manifeste est relevée de 2 000 à 2 500 plutôt que laissée dériver.

### Fixed

- **Un document généré ne se téléchargeait pas.** Son lien était relatif (`/api/v1/attachments/{id}`), donc il visait l'origine du frontend, qui n'atteint l'API que là où un reverse proxy réécrit `/api/v1/*`. En développement il n'y en a pas : le relais Next visait `http://api:8000` alors que l'API dev n'écoute **qu'en HTTPS** (`socket hang up`), et le pointer en `https://` ne marche pas davantage — la réécriture refuse le certificat auto-signé (`DEPTH_ZERO_SELF_SIGNED_CERT`) là où le `fetch` de l'application l'accepte. **Sept autres surfaces partageaient l'erreur** : images générées, captures d'écran du navigateur, lecture du document dans la visionneuse, exports des intérêts, des journaux et des mémoires, URL d'ingestion santé affichées pour être copiées, et les ressources dans le markdown (photos de lieux, cartes statiques, vignettes Drive). Une seule fonction les couvre — `apiResourceUrl` — qui ne touche que les chemins `/api/v1` et retombe sur le chemin relatif quand aucune origine d'API n'est configurée : rien ne change pour un déploiement qui s'appuie sur son proxy.
- **Un tableau large débordait la page en PDF** : MuPDF dimensionne les colonnes d'après leur CONTENU et n'honore ni `width: 100%` ni `table-layout: fixed`, si bien qu'un tableau de douze colonnes atteignait **714 pt sur une page de 595**. Échelle de tailles mesurée, et la limite est ÉNONCÉE : au-delà de seize colonnes il déborde même à 5 pt. Trouvé en REGARDANT un document rendu, ni par un test ni par une revue de code.
- **L'en-tête et le pied d'un PDF chinois étaient illisibles** : la Story embarque une police CJK pour le CORPS, pas pour les tampons, et Helvetica n'a aucun idéogramme — le titre s'imprimait `······` et la pagination `· 1 ··· 1 ·`, sur chaque page, à côté d'un corps parfait. La police des tampons est choisie en demandant à Helvetica si elle a les glyphes : le fichier chinois passe de 3 917 à **3 900 Ko** (Helvetica s'en va) et un rapport de 500 blocs se rend toujours en 0,22 s.
- **`TOC Heading` hérite de `Heading 1`** : laissé tel quel, « Sommaire » devenait le chapitre 1 du sommaire qu'il introduit.
- **Excel REFUSE un classeur** dont un Tableau porte un en-tête vide ou dupliqué — openpyxl les écrit sans broncher.
- **MuPDF repeint un rectangle d'en-tête fantôme** en haut de chaque page de continuation quand un `th` porte un fond sous `border-collapse`.
- **Écrire une position HÉRITÉE de placeholder PowerPoint le fige à une hauteur nulle** : seules les formes portant leur propre transformation sont mises à l'échelle pour passer le gabarit en 16:9.
- **Le service de documents ne transmettait pas le propriétaire à la porte structurée** : `resolve_owner` lit `config.metadata.user_id`, que LangGraph ne remplit jamais (sondé — seul `thread_id` y est fusionné), donc un appelant « borné » accepté par son NOM ne portait aucun propriétaire.

### Security

- **`next` 16.2.11 → 16.3.4** — deux avis **critiques** signalés par `pnpm audit` sur la version épinglée : deux **exécutions de code à distance non authentifiées** (GHSA sur `next >=16.0.0 <16.3.3`). Dans la foulée, deux surcharges pnpm déjà présentes mais à un plancher trop bas sont relevées : `sharp` `>=0.35.0` → `>=0.35.4` (vulnérabilités libheif, atteint par `next`) et `js-yaml` `^4.3.1` → `^4.3.2` (`maxTotalMergeKeys` ne borne pas le temps de calcul pour des sources de fusion vides). L'audit passe de **2 critiques, 2 hautes et 3 modérées** à **2 modérées**, sous le seuil de la porte. Montée validée : lint, trois ratchets, `tsc` non incrémental, 7 642 tests et une construction de production complète (380 pages).
- **`httpx2` 2.10.0 → 2.12.0** — trois vulnérabilités signalées par `pip-audit` sur la version épinglée : **CVE-2026-84379** (les en-têtes de partie fournis via l'API `files=` sont sérialisés sans validation, donc un CR ou un LF y injecte des en-têtes de partie supplémentaires), **CVE-2026-84380** (un `Content-Length` ajouté d'office à côté d'un `Transfer-Encoding` fourni par l'appelant : deux cadrages contradictoires sur une même requête HTTP/1.1, primitive de désynchronisation) et **CVE-2026-84382** (chaque lecture réseau de 64 Kio était décompressée en une seule allocation, soit ~64 Mio au taux maximal de DEFLATE, y compris pour une réponse pourtant traitée en flux). Le plancher du manifeste passe de `>=2.5.0` à `>=2.12.0` : la borne porte sa raison, faute de quoi un futur recalcul de verrou pourrait redescendre. `httpx2` porte les transports MCP v2 et les classes d'authentification de LIA en héritent — 980 tests MCP rejoués sur la nouvelle version.

### Tests

- **395 tests** couvrent la génération documentaire, dont **74 mesures de calibration PowerPoint**, un corpus de treize documents relu par le lecteur natif de chaque format, l'idempotence de la normalisation épinglée sur tout le corpus, et une simulation de bout en bout (outil → service → renderer) incluant un jeu de diapositives chinois.
- **13 tests** couvrent la résolution des URL d'API, dont quatre qui vérifient qu'une ressource tierce, un `data:` ou un chemin non-API restent intacts.
- Chaque correctif a été **falsifié** — cassé volontairement pour vérifier que son oracle rougit —, cinq fois, dont une par PowerPoint lui-même.

## [1.43.1] - 2026-09-07

**« Actions menées d'elle-même » était vide par construction — quoi que LIA fasse.** Le registre des effets est alimenté par la porte des outils, et la proactivité n'appelle aucun outil : mesuré en production, **0 ligne sur 228 exécutions hors tour en quatorze jours**, alors que les surfaces conversationnelles étaient à 24/24, 22/22, 10/10. Et l'extraction censée rendre ce dossier en livrait un échantillon : **49 195 lignes réelles pour un plafond de 1 000 par source, soit 97,9 % de l'enregistrement d'inférence absent** de chaque téléchargement, sous un en-tête qui disait « tronqué » — ce qui ne répare rien.

**En regard, une capacité nouvelle : chaque relation a désormais un débrief écrit.** Une fiche empile dix sections ; personne ne lit dix sections. Ce que le lecteur cherche — où j'en suis avec cette personne, et qu'est-ce qu'il faut aborder — est une synthèse qu'aucun agrégat ne produit.

### Added

- **Un débrief quotidien par relation** ([ADR-269](docs/architecture/ADR-269-Relationship-Debrief.md)) : une synthèse écrite par le modèle en tête de la fiche — ce qui reste ouvert, ce qu'il faut faire ensuite, ce qui est bon à retenir — construite **au plus une fois par jour LOCAL**, **jamais par un ordonnanceur** (`relations_total` n'est pas borné) et jamais pendant un tour de chat : elle naît à l'ouverture de la carte. Trois reconstructions seulement sont légitimes — la langue, le périmètre, une demande explicite. L'assemblage des preuves 360° a été **extrait** de `get_person_overview_tool` vers `domains/relations/overview/` et l'outil en est devenu le premier consommateur : deux assemblages auraient créé deux autorités sur « qui est cette personne » (ADR-185). Le refactor est épinglé par un fichier doré capturé **avant** l'extraction — 18 cas de périmètre, charge utile et message comparés à l'octet.
- **Le débrief rejoint le bloc pair dans le chat, avec la directive INVERSE.** Le bloc pair affirme des faits EXACTS parce qu'il les lit dans le tour ; la même phrase au-dessus d'une synthèse datée serait une machine à affirmations fausses. Le gabarit dit qu'elle est datée, donne son ÂGE et non seulement sa date, et renvoie aux outils pour tout chiffre, tout compte et tout statut. Une correspondance de nom ambiguë n'injecte **rien** : l'annuaire contient toutes les relations jamais ouvertes, et un faux positif remettrait le dossier d'une personne sur une question qui en visait une autre. Réglable par compte depuis la page Relations, là où le résultat se voit.
- **Un troisième onglet de registre : « À l'initiative de LIA »** ([ADR-270](docs/architecture/ADR-270-Spend-Roads-And-Register-Authorship.md)) — ce que LIA a fait et lu de son propre chef, séparé de ce que la personne a déclenché. Une notification proactive est une ACTION : elle est désormais RÉCLAMÉE avant d'être envoyée puis close sur un résultat explicite (`effects/out_of_turn_effects.py`), comme tout effet depuis ADR-263.
- **Les surfaces qui lisent sans passer par un outil enregistrent enfin leurs consultations** : le briefing (9 sources), le débrief de relation (7), le balayage du heartbeat (16 — **824 exécutions en trente jours sans une seule ligne**), les centres d'intérêt et les espaces de connaissances. Chaque surface **déclare** son vocabulaire (`domains/shared/consultation_surfaces.py`) : personne ne le retranscrit, et l'assertion de démarrage vérifie les 31 capacités là où elle ne regardait que les outils.
- **`domains/shared/consultation_sink`** : le registre s'OFFRE, il ne va pas se chercher — `agents` importe `relations`, donc un domaine qui importerait `agents/effects` en retour refermerait un cycle, et un import local ne ferait que le cacher. La couture est NOMMÉE plutôt que `**Any`, pour qu'une faute de frappe sur un champ ne puisse pas écrire une ligne incomplète.
- **Le coût d'un artefact daté s'affiche sous lui** : un badge unique (`components/ui/llm-usage-badge`) sert les trois surfaces — synthèse du jour, carte d'accueil, débrief. Un coût nul est une AFFIRMATION : une ligne muette ne rend rien plutôt que « 0,00 € ».
- **Deux plafonds pour tout jeton payé par la plateforme** ([ADR-272](docs/architecture/ADR-272-Every-Platform-Paid-Token-Answers-To-Both-Ceilings.md)) : `usage_limits/enforcement.py` porte un unique lève-exception et sa jumelle non levante. Une requête REFUSE (429, code dédié, `Retry-After`) ; un traitement de fond RENONCE et journalise **« sauté »**, jamais « échoué » — un refus de quota n'est pas un échec de génération.
- **`infrastructure/llm/usage_guard.py`, une seule garde d'usage**, et `LLM_CHOKEPOINTS` nomme chaque porte. Deux refus qu'elle ne doit PAS faire : un appel sans propriétaire n'est jamais bloqué (sa borne est le registre d'instance), et `"system"` n'est pas un compte.
- **`infrastructure/utils/single_flight.py` et `shared_flight.py`** ([ADR-271](docs/architecture/ADR-271-One-Page-Load-One-Act-Of-Reading.md)) : le premier coalesce dans un processus, le second entre workers via une revendication Redis relâchée par son PROPRIÉTAIRE (comparer-et-supprimer sur un jeton). Ce n'est pas un cache : une exécution terminée n'est jamais resservie.
- **`infrastructure/llm/usage_metadata.py`** : lire les métadonnées d'usage d'un fournisseur avait **huit implémentations** qui divergeaient — une seule lisait `cache_read_input_tokens` d'Anthropic et une seule bornait à zéro, donc sept facturaient au plein tarif des prompts mis en cache et pouvaient calculer un nombre de jetons négatif.
- **`infrastructure/llm/spend_roads.py`** : où la dépense d'un module est enregistrée est DÉCLARÉ, jamais déduit. La comptabilité est ambiante — un nœud dépense par un contexte publié par un ancêtre — et répondre en lisant les fichiers a produit **neuf conclusions fausses en une seule session**, dans les deux sens. La garde lit des appels par AST et a repris **6 des 46 classements de l'auteur**.
- **`domains/usage_limits/cost_bearers.py`** : qui paie décide qui est facturé. `provider_api_keys` n'a pas de `user_id`, donc le modèle, la synthèse vocale, la reconnaissance, l'image et Maps tournent sur la clé du déploiement ; Perplexity, Brave, la météo et la téléphonie sur celle de la personne.

### Changed

- **Un chargement de la page d'accueil n'ouvre plus tes sources qu'une fois.** `/briefing/cards` et `/briefing/synthesis` partent en parallèle et construisaient chacun le lot des neuf sections : mesuré sur sept jours, **151 constructions dont 44 doublons — 39 % des chargements**, et **44 sur 44 concurrents**. Chaque connecteur était appelé deux fois et deux lots de consultations étaient déposés pour un seul acte de lecture. La cause racine est une QUESTION, pas une ligne de code : `/synthesis` demandait « ce lot contient-il quelque chose d'intéressant ? » au lieu de « ce lot a-t-il été construit ? » — la première ne distingue pas un cache froid d'une journée calme.
- **La coalescence tient aussi entre workers.** La production sert `WEB_CONCURRENCY=4`, donc les deux requêtes d'un chargement partagent un worker environ une fois sur quatre : lire le `CMD` du Dockerfile ne suffit pas à conclure qu'un service est mono-processus. Un worker REVENDIQUE la construction dans Redis, les autres attendent ce qu'il publie — l'attente est bornée, un attendant qui expire construit, tout échec se replie sur la construction, et un rafraîchissement FORCÉ n'attend jamais, puisque ce qu'un détenteur publie EST le cache qu'il demandait à contourner.
- **Aucune extraction de registre n'est plafonnée** ([ADR-273](docs/architecture/ADR-273-Complete-Register-Extractions.md)). Un curseur côté serveur (`infrastructure/database/export_stream.py`) remplace le plafond : un téléchargement ne tient plus qu'une partition, jamais un registre. Le compte est EXACT — un agrégat sur la statement même que le corps parcourt — et publié avant la première ligne, si bien qu'une extraction sans borne supérieure en reçoit une : l'instant de sa génération, NOMMÉ dans l'en-tête. `truncated: false` et `X-Register-Truncated` restent : abandonner la revendication ferait distinguer un fichier complet d'un fichier partiel par l'ABSENCE d'un avertissement.
- **Le téléchargement est gzippé quand le client l'accepte** — c'est du transport, donc le NOM du fichier ne change pas (mesuré : 113 349 o → 11 211 o, ×10,1).
- **Aucune lecture plafonnée sans `ORDER BY`.** Les cinq lectures portaient un `LIMIT` sans tri : PostgreSQL rendait les lignes les PLUS ANCIENNES — une extraction faite le 5 septembre couvrait janvier à mars et nommait des modèles que l'instance ne configure plus, sous un en-tête qui disait vrai en annonçant « plafonné ».
- **Réglages** : `EFFECT_TECHNICAL_EXPORT_MAX_ROWS` et `ARTICLE12_EXPORT_MAX_ROWS_PER_SOURCE` sont SUPPRIMÉS au profit de `EFFECT_EXPORT_BATCH_ROWS` — ce qui est borné est désormais la mémoire, jamais le contenu. Six réglages `RELATION_DEBRIEF_*` arrivent, tous avec un défaut.
- **La clé du cache de briefing porte la LANGUE** (`briefing:v2:<uid>:<lang>:<section>`), et `SECTION_REMINDERS_TTL_SECONDS` passe de 0 à 60 : une valeur sans TTL n'est jamais écrite, donc invisible pour tout lecteur qui ne lit que le cache — la section « rappels » restait à 0 et la branche de prompt qui la lit était inatteignable par un chargement ordinaire.
- **`_build_plan()`** remplace trois listes des neuf sections par une seule table de plan.
- **`core/prompt_store.py`** absorbe **trois copies** du lecteur de prompt par chemin, et `domains/shared/name_mentions.py` le détecteur de mention (sinon cycle `agents` ↔ `relations`).
- **`person_tools._resolve_provider_client` est supprimé** : il dupliquait `open_category_client` et rendait un client lié à une session **déjà fermée** — défaut latent sur le repli par nom.
- **La moitié fournisseur d'un aperçu n'est plus lue en entier pour être jetée** : jusqu'à **onze appels externes** étaient facturés contre un périmètre que le lecteur avait déjà restreint. Le rétrécissement demande un TROISIÈME statut, `NOT_REQUESTED` — « je n'ai pas regardé, exprès » n'est ni « je n'ai rien trouvé » ni « je n'ai pas pu regarder ».

### Fixed

- **Une notification proactive n'était consignée nulle part.** Le registre des effets est alimenté par la seule porte des outils et la proactivité n'en appelle aucun : `agent_effects` n'avait jamais porté une ligne `proactive` sur aucun déploiement, et « Actions menées d'elle-même » était vide **par construction** quoi que LIA fasse — la version la plus nette du trou, puisqu'une notification est le seul acte d'initiative qu'une personne éprouve réellement.
- **Cinq sites de dépense modèle sur 46 n'étaient bornés par rien** — `evaluation_pipeline`, `open_loop_extractor`, `briefing/llm`, `user_mcp/description_generation`, `reminder_notification`. Trois formes les ont produits : le registre nommait une ENVELOPPE au lieu de la porte (la fonction publique avait neuf appelants directs) ; la garde partagée SORTAIT avant de demander (drapeau `usage_limits_enabled`, absence de propriétaire) ; et un même refus avait deux réponses, l'une avec code et `Retry-After`, l'autre sans ni l'un ni l'autre.
- **Une dépense sans propriétaire n'atteignait aucun registre** : 84 traductions de personnalité entre décembre et février n'ont laissé de trace nulle part, pendant que le registre enregistrait 5 976 autres lignes sur 17 surfaces. Enregistrer n'est que la moitié d'un compte — l'autre est de DEMANDER d'abord, et quatre des cinq modules « instance » le faisaient, le cinquième non, invisiblement.
- **Un balayage d'intérêts interrogeait Brave, Perplexity et Wikipédia par leurs clients directs** : la même recherche était consignée quand une personne la demandait en conversation et muette quand LIA la lançait seule. Les 22 modules qui importent un client de connecteur sont désormais ÉNUMÉRÉS et classés un par un — deux classements étaient faux à la première passe, deux modules important le client Gmail pour ses seuls ANALYSEURS.
- **Un raccourci « rien n'a changé » ignorait la langue** : les preuves étant identiques, une reconstruction était revendiquée puis sautée, et le débrief serait resté dans l'ancienne langue pour toujours.
- **Une borne de schéma REFUSE, elle ne rogne pas** : `max_length=5` sur une liste faisait échouer toute la construction pour un modèle un peu bavard. Deux modèles désormais — un brouillon sans bornes, une conversion qui rogne, un corps borné.
- **Un échec de reconstruction détruisait le débrief précédent** : la clôture écrasait le corps. Trois clôtures distinctes désormais, chacune n'écrivant QUE ses colonnes — remplacer une synthèse utilisable par un panneau vide transforme « je n'ai pas pu actualiser » en « il n'y a rien ».
- **Un rendu périmé au changement de clé** : `useApiQuery` garde les données précédentes pendant le chargement, donc le hook du débrief décidait sur la personne d'AVANT.
- **`react_agent` n'avait de description dans aucune des 6 langues** — l'écran d'administration affichait la clé brute. Défaut préexistant ; une garde couvre maintenant les 59 types.
- **Le prompt d'écriture n'interdisait pas le markdown** alors que la carte rend du texte brut, et le nom stocké était la graphie de l'URL et non la canonique.
- **Une invalidation de cache devenue muette** : la clé de briefing a quatre constructeurs, dont un dans un autre domaine, et `redis.delete` sur une clé absente RÉUSSIT — l'invalidation par push échouait donc en silence.
- **`expunge_all` remplace la table d'identité de la session** et tue celle que le curseur ouvert est encore en train de remplir : la deuxième partition mourait sur « this identity map is no longer valid ». Les lignes sont détachées UNE PAR UNE. Invisible en test unitaire — un flux bouchonné n'a pas de table d'identité du tout.

### Tests

- Fichier doré `golden_overview_payloads.json` capturé **sur le code d'avant l'extraction** : 18 cas de périmètre, charge utile ET message comparés à l'octet — le motif à réutiliser pour tout refactor d'un chemin en production.
- `test_every_spend_site_is_bounded` parcourt les 46 sites déclarés et refuse un site qui n'atteint aucun plafond ; `test_usage_guard_at_every_chokepoint` refuse une porte non gardée ; `test_llm_spend_road_completeness` refuse une omission, une entrée périmée, une route « instance » sans raison écrite et une route dont le module ne fait pas ce qu'elle prétend.
- `test_cost_bearer_declaration` compare la déclaration à la somme que le quota applique réellement, **dans les deux sens** : une famille payée par la plateforme absente du plafond est une dépense que rien ne voit ; une famille payée par la personne présente dans le plafond la facture deux fois.
- `test_direct_client_callers` marche le graphe d'imports : 22 modules, chacun déclaré enregistreur, non-lecteur (avec la raison) ou dette — table de dette vide et shrink-only.
- Preuve d'exécution de la coalescence sur Docker : deux conteneurs, un seul Redis et un seul PostgreSQL, compte réel à 13 connecteurs, construction à froid mesurée à 963 ms. **6 chargements → 6 constructions ; couture neutralisée d'une ligne → 4 chargements, 8 constructions ; restaurée (sha256 identique) → 4/4.** Contrôles imprimés à chaque manche, parce que trois harnais antérieurs avaient été verts sur un comportement cassé.
- Preuve d'exécution des plafonds : compte au quota → modèle non appelé, salutation statique servie, aucun usage facturé ; instance en pause sans propriétaire → 429, `instance_budget_exhausted`, `Retry-After: 48 306 s`.
- Intégration PostgreSQL réelle sur les extractions en flux et sur la revendication du débrief — les deux pièges de flux ci-dessus n'étaient visibles que là.

## [1.43.0] - 2026-09-06

**Une routine et un rappel posaient la même question — « quand ? » — et deux moteurs y répondaient.** Les routines savaient dire « le lundi et le jeudi à 8h » ; les rappels ne savaient dire qu'un instant, une fois. Rien ne permettait « tous les trois jours », « le 2e mardi du mois », « toutes les deux heures entre 9h et 17h », ni de faire répéter un rappel. Un seul moteur répond désormais aux deux, et le post-it n'est plus une exception : `rearm_after` renvoie `None` pour une occurrence unique consommée, ce qui EST « supprimer après notification » — aucune branche nulle part ne demande « est-ce que ça se répète ».

**Et le moteur d'avant sautait un jour par an, dans 73 fuseaux.** Mesuré : APScheduler saute la journée entière quand le décalage change à minuit local — 72 créneaux perdus, 142 exécutions par an, `Europe/Paris` compris, sans rien dans les journaux.

### Added

- **Un moteur de récurrence unique** (`src/core/recurrence/`) : une récurrence est un PRODUIT — quels jours du calendrier × quels moments de la journée. `dateutil.rrule` énumère les jours, chaque moment est localisé avec `fold=0`, et le résultat est ordonné et dédoublonné PAR INSTANT (au passage à l'heure d'hiver, deux horloges murales tombent sur le même instant). Le paquet n'importe aucun domaine et **aucune configuration** : `core.constants` lit ses plafonds ici, donc y toucher à `core.config` referme une chaîne sur une configuration à moitié construite et plus rien ne démarre.
- **Un rappel peut se répéter.** Colonne `recurrence` JSONB, reprise en SQL pur depuis l'instant déjà stocké, et une section « Rappels » dans les réglages qui monte l'éditeur générique **sans une ligne de modification** — c'est la preuve de la généricité, pas une intention.
- **Les deux outils de chat parlent la même langue.** Un vocabulaire PLAT déclaré une fois et traduit une fois : `compact_schema` aplatit un objet imbriqué en les noms `parent.child` qu'il refuse ensuite, donc la surface parlée ne peut pas être le modèle stocké. Chaque outil publie les plafonds QU'IL applique (ADR-184) — 12 déclenchements par jour pour une routine, 48 pour un rappel — et un nombre hors bornes est RÉPARÉ par le clamp du planificateur, jamais rapporté comme un défaut.
- **La transcription est mesurée, pas supposée** : 18 familles de formulations × 6 langues. La moitié déterministe est un test unitaire ; la moitié fournisseur est un script (`task recurrence:corpus:measure`), parce qu'un test qui saute faute de clé est de la décoration (ADR-155). Mesuré le 2026-09-06 sur `gpt-5.6-luna` : **105/108 exactes (97 %)**, fr/en/es 18/18. L'oracle est les INSTANTS et non les paramètres — deux formulations qui déclenchent aux mêmes moments sont le même planning.
- **Une chronologie hebdomadaire des routines** et un historique par exécution (ADR-265) : une grille qui ne PEINT que, sans jamais relire le planning.

### Changed

- **Les jours sont énumérés, plus jamais délégués à un cron.** `dateutil.rrule` remplace `CronTrigger` sur les deux domaines ; l'équivalence est prouvée sur 76 518 comparaisons couvrant tous les fuseaux IANA, et les 26 écarts sont tous des créneaux que l'ancien moteur SAUTAIT.
- **`create_reminder_tool` déclare `mutation_policy="reversible"`** : il agit, et il héritait de `readonly` par un repli d'inférence (ADR-263).
- **Les formulaires de saisie sont regroupés** : deux questions nommées avec leur icône de thème pour un rappel — « ce qu'il faut faire », « quand » —, trois pour une routine, et l'intervalle, la fin de série et la date de départ repliés derrière « Options avancées » (8 champs visibles ramenés à 5). Le repli **s'ouvre de lui-même** sur toute valeur non par défaut, et le champ qui PORTE la réponse ne se replie jamais : pour une occurrence unique, la date d'ancrage EST la date du rappel.
- **`SettingsDisclosure` devient `ui/disclosure.tsx`** : aucune dépendance au domaine des réglages, et trois autres domaines l'importaient déjà. La garde de généricité de l'éditeur a refusé son import et a ainsi nommé une adresse fausse antérieure au chantier.

### Fixed

- **Un sélecteur de jours que le moteur IGNORAIT était accepté, stocké et affiché.** Une règle quotidienne déclarant les jours ouvrés sonnait aussi le week-end ; une règle mensuelle déclarant janvier et juillet se déclenchait douze fois par an. C'est le miroir d'ADR-184 : là une borne était appliquée sans être publiée, ici une valeur était publiée sans être appliquée — dans les deux cas le producteur croit avoir été obéi. Le modèle refuse désormais, la dictée RÉPARE les deux identités exactes (« tous les jours » restreint aux jours ouvrés EST la règle hebdomadaire) et la réparation est VISIBLE dans la confirmation.
- **Une phrase annuelle ne nommait que son premier mois et son premier jour** : « le 15 janvier et juillet » s'affichait « le 15 janvier », juillet se déclenchait et rien à l'écran ne le disait.
- **La marque du jour appartenait à la phrase, pas au nombre** : « Am 1 und 15. jedes Monats » en allemand — un seul ordinal pour deux. Défaut préexistant : toute routine mensuelle sur deux jours était déjà mal formulée en allemand et en chinois.
- **Une fonction qui documentait `Raises: RecurrenceError`** laissait Pydantic l'envelopper : sept familles de refus — « le 31 février », un jour de semaine à 9 — traversaient le `except` des deux outils, qui LEVAIENT au lieu de répondre, avec un message portant les noms de champs internes et une URL de documentation.
- **Le repli du prompt de notification contredisait le fragment versionné qu'il secourt** (il nommait la date de création sur chaque occurrence d'un rappel quotidien) **et faisait du texte de l'utilisateur une partie de son gabarit** : un rappel contenant une accolade levait `KeyError`, trois réessais, occurrence abandonnée.
- **La propagation d'un changement de fuseau attrapait ses erreurs mais pas ses transactions** : une instruction en échec empoisonne une transaction PostgreSQL, donc un rappel dont l'écriture échouait emportait au commit les routines déjà déplacées ET la mise à jour du profil. Un point de reprise par surface désormais.
- **Le ré-armement était calculé sur cinq sites identiques** dans l'exécuteur de routines — une règle en cinq copies se modifie en quatre.
- **Un filtre de sécurité qui ne s'exécutait pour aucun modèle réel** : le filtre des modèles de raisonnement de la branche OpenAI est intercepté par la voie Responses pour tout `gpt-4.1*`, `gpt-5*` et `o[1-9]*`. La protection qui TOURNE décidait sur l'effort demandé et non sur le modèle, donc un modèle de raisonnement sans intention configurée recevait `temperature` et `top_p` (mesuré sur l'API réelle : `top_p=1.0` toléré, `top_p=0.9` répond 400). Les deux voies lisent maintenant UN prédicat, et une garde exige qu'il n'ait qu'un lecteur.
- **Une largeur posée sur un champ ne borne pas ce que la ligne mesure** : `Input` s'enveloppe dans `FieldFrame`, qui est `w-full`, donc l'unité partait à 330 px du champ. Huit champs corrigés dans cinq écrans, et une garde qui s'auto-teste — trois versions successives de cette garde passaient alors que le défaut était dans l'arbre.
- **Une date de fin vidée bloquait le formulaire sans dire pourquoi**, et l'ancienne grille hebdomadaire ne dessinait pas la cellule du 30 mars.

### Tests

- 24 783 unitaires backend, 7 522 frontend, 864 d'intégration sur PostgreSQL réel, 15 parcours d'accessibilité, 149 de déploiement.
- Trois gardes neuves, chacune prouvée par réintroduction du défaut : un seul lecteur du motif de raisonnement, une largeur toujours portée par le conteneur, et la table des sélecteurs identique entre Python et TypeScript.
- Le corpus de transcription gèle 18 familles dans 6 langues ; la moitié déterministe tourne en CI, la moitié fournisseur est une mesure datée.

## [1.42.4] - 2026-09-05

**Les modèles qui tournent sur ta machine deviennent des modèles comme les autres.** Ollama était branché sur son pont de compatibilité OpenAI, et ce pont ne sait pas dire l'essentiel : couper la réflexion d'un modèle qui pense, fixer la fenêtre de contexte, séparer la pensée de la réponse. Mesuré le 2026-09-05 : un emplacement passé sur `qwen3.8:27b` mourait à l'instanciation à chaque tour, et le premier correctif — le pont rafistolé — rendait une réponse VIDE, douze jetons demandés et douze jetons de pensée. LIA parle désormais à Ollama dans sa propre langue, et c'est le serveur qui dit ce que chacun de ses modèles sait faire.

### Added

- **Ollama devient un fournisseur natif** ([ADR-267](docs/architecture/ADR-267-Ollama-Native-Provider-And-Discovered-Capabilities.md)) : LIA appelle `/api/chat` par `langchain-ollama` au lieu du pont OpenAI-compatible. Ce que le pont ne pouvait pas exprimer arrive enfin — `think` (couper la réflexion ou en choisir la profondeur), `num_ctx` (la fenêtre de contexte), `format` (JSON contraint par grammaire côté serveur), la trace de pensée séparée de la réponse, et l'usage sur chaque réponse.
- **Le serveur déclare ce que ses modèles savent faire** : une couche DÉCOUVERTE lit `/api/show` (outils, vision, pensée, longueur de contexte) et alimente le runtime ET l'écran d'administration. Elle survit à un rechargement du catalogue, gagne sur une ligne de catalogue homonyme, se rafraîchit quand l'adresse du serveur change et à chaque ouverture de la liste des modèles, et se vide quand le serveur ne répond plus — un modèle qu'il ne liste plus ne garde aucun profil.
- **Une échelle de réflexion déclarée par modèle** : complète pour un modèle qui pense, « aucune » seule pour les autres, inconnue pour un modèle jamais découvert. Une profondeur positive n'atteint donc jamais un modèle qui ne pense pas — ce que le serveur refuse en 400 — et l'écran d'administration n'offre que ce que l'API accepte.
- **`OLLAMA_NUM_CTX`** : la fenêtre de contexte que LIA demande et avec laquelle elle compte. Vide, c'est le maximum du modèle plafonné à 32 768. Sans elle, Ollama choisit selon la mémoire vidéo disponible et coupe le début d'un prompt trop long en silence.
- **`ChatOllamaTraced`** : le client publie ce qu'il envoie, sinon un appel Ollama entrait au registre Article 12 comme un nom de fournisseur et rien d'autre. `num_predict` devient la quatrième orthographe du plafond de sortie et `think` la quatrième forme de la réflexion.

### Fixed

- **N'importe quel emplacement LLM peut tourner sur Ollama** : les branches Ollama et Perplexity de l'adaptateur passaient l'objet de réflexion brut au client OpenAI, qui n'accepte qu'une chaîne — pour tout niveau stocké, y compris « défaut du fournisseur ». Comme 29 des 58 emplacements héritent d'un niveau par défaut, aucun choix d'administrateur ne pouvait l'éviter. Les deux branches passent par la couture unique ([ADR-245](docs/architecture/ADR-245-Reasoning-Unification.md)), et une garde parcourt chaque fournisseur × chaque niveau (`test_reasoning_seam_guard.py`).
- **La fenêtre de contexte est demandée, plus supposée** : le seuil de compaction lisait 51 200 — le défaut d'un modèle inconnu — face à un serveur qui alloue selon sa mémoire vidéo. Ce que LIA compte est désormais ce qu'elle demande : demandé 32 768, alloué 32 768, compté 32 768.
- **Le plafond de sortie atteint le serveur** (`num_predict`) : il partait sous un nom que le pont d'Ollama ne lit pas, donc aucune limite n'arrivait.
- **La trace de pensée ne mange plus la réponse** : elle arrive séparée et se diffuse dans le panneau de progression, comme pour DeepSeek.
- **L'URL Ollama est la racine du serveur** : le `/v1` hérité du pont est toléré et retiré par un seul lecteur (`providers/ollama_urls.py`), partagé par l'adaptateur et la découverte, qui divergeaient.
- **Plus de fausse alerte de comptage** : un appel diffusé sur Ollama se terminait sans usage à chaque tour et déclenchait `LLMCallsWithoutUsage` pour une dépense qui existe et vaut 0 €.
- **`extra_body` est fusionné, jamais assigné** sur les branches Qwen et DeepSeek : Qwen écrasait la valeur de la configuration avancée.

### Changed

- **`PROVIDER_USAGE_CAPABILITIES`** : Ollama passe de `excluded` à `native` ([ADR-220](docs/architecture/ADR-220-Comptabilite-Usage-LLM-Declaree.md) amendé) ; Perplexity reste seul exclu, pour la raison qui était la bonne (clé de l'utilisateur final).
- **La sortie structurée d'Ollama passe par son champ `format`** et non par un outil forcé, que le serveur n'implémente pas : `native_structured_method` est le seul choix de méthode pour les trois points d'appel.
- **`langchain-ollama` et `ollama` entrent dans le manifeste runtime** (lockfiles [ADR-112](docs/architecture/ADR-112-Universal-Lockfiles.md)) ; l'image API est reconstruite au déploiement.
- **L'installateur propose la racine du serveur** pour Ollama, plus le suffixe du pont.

### Tests

- `test_reasoning_seam_guard.py` : 7 fournisseurs × 8 niveaux, aucun constructeur ne reçoit l'objet de réflexion, tout kwarg est sérialisable — la garde qui aurait été rouge depuis la v1.32.0 (mutation-vérifiée : réintroduire le défaut rougit 13 tests).
- `test_ollama_family.py`, `test_ollama_chat.py`, `test_ollama_urls.py`, `test_ollama_discovered_profiles.py`, `test_model_capabilities_cache_discovered.py`, `test_structured_output_native_method.py`, `test_ollama_capabilities_refresh.py`, `test_provider_adapter_ollama_perplexity.py` : l'échelle par modèle, le client, l'URL, les profils découverts, la couche du cache, la méthode structurée, le rafraîchissement piloté par l'adresse.
- Frontend : l'écran d'administration offre le widget de réflexion sur un modèle pensant, l'échelle réduite sur un modèle qui ne pense pas, rien du tout quand le serveur est injoignable, et masque les deux pénalités inexprimables.
- Ratchets tenus sans relèvement : le client Ollama est EXTRAIT dans son module (`providers/ollama_chat.py`) plutôt que de faire grossir l'adaptateur, et les quatre fournisseurs à SDK dédié partagent une seule répartition.

## [1.42.3] - 2026-09-05

**Chaque tour de chat perdait son contexte RAG, et le diagnostic automatique disait « preuves insuffisantes ».** Mesuré le 2026-09-05 : cinq tours sur cinq sans contexte documentaire, le fournisseur d'embeddings répondant `500 INTERNAL` à chaque requête RAG — parce que `HumanMessage.text` est une SOUS-CLASSE de `str` que le SDK Gemini transforme en requête vide (`"content": {}`) ; le chemin mémoire ne survivait que parce qu'il tranche le texte. Et les quatre derniers diagnostics stockés concluaient tous sans cause, alors que Prometheus et Loki tenaient la réponse (ADR-266).

### Fixed

- **Le contexte RAG revient dans chaque tour** : l'entonnoir des embeddings Gemini (`GeminiRetrievalEmbeddings`) coerce chaque entrée en `str` exact — le même objet quand il l'est déjà — et le point d'extraction du dernier message fait de même ; pinné par des tests qui passent le vrai `TextAccessor` et une sous-classe nue au SDK factice. Présent au moins depuis le 8 juillet 2026 (identique sur google-genai 1.67.0 et 2.10.0 sous pydantic 2.13.4), invisible tant qu'aucun espace RAG utilisateur n'était actif.
- **Les runbooks atteignent enfin la production** : `prepare-prod.ps1` stage `docs/runbooks` à côté de `docs/knowledge` (test Pester sur le bundle) ; jusque-là le montage était un répertoire vide et `had_runbook` valait `false` sur tous les diagnostics. L'API compte les runbooks disponibles, le panneau d'administration dit quand il n'y en a aucun, et le démarrage avertit.
- **Une évidence sans `detail` vide** : un détail vide était cité par le modèle comme « le champ detail est vide » ; absent vaut mieux que blanc, et la fenêtre de mesure d'un contrôle Prometheus est désormais dans l'évidence.
- **Le bundle auto-hébergé embarque `docs/runbooks`** (`build_self_host_bundle.py`, test) : un auto-hébergeur avait le même montage vide qu'en production.

### Changed

- **Une seule table de suffixes d'unités** (`lib/diagnostics-units.ts`) pour les lignes de contrôle et le dossier de preuves du panneau Santé de la plateforme ; la durée de fonctionnement s'affiche en unité localisée (`Intl`, `47 min`, `2 h`, `3 j`) sans clé de traduction.
- **`docs/technical/GRAFANA_DASHBOARDS.md`** : comptes de panneaux des tableaux 05 et 16 réalignés sur les fichiers.

### Added

- **Le dossier de preuves du diagnostic** (ADR-266) : collecté AU MOMENT DU DIAGNOSTIC, une fois par incident après la porte budgétaire, selon une recette déclarée par clé de corrélation (`evidence_recipes.py`, assert au démarrage, test CI sur chaque alerte chargée et chaque événement nommé) — ventilations Prometheus (quatre requêtes de catalogue : issues, statuts, verdicts du régulateur, raisons de refus), extrait Loki borné, filtré côté client, en liste blanche et pseudonymisé, bloc runtime (version, commit, âge du processus). Chaque source dégrade seule : Loki indisponible coûte un extrait, jamais le diagnostic. Le prompt lit le dossier et distingue une source illisible du silence.
- **« Ce que le diagnosticien a lu »** : le dossier est stocké avec le diagnostic et rendu sous celui-ci dans le panneau d'administration — séries en puces avec leurs valeurs exactes, comptes de journal avec la tête de l'erreur, build et durée de fonctionnement ; une source aveugle est dite avec sa raison, jamais dessinée comme un zéro rassurant. Six langues.
- **`embedding_provider_errors_total{reason}`** : la NATURE d'un refus fournisseur (`http_429`, `http_500`, `permanent`…), classée par le même code que le réessai, câblée dans le tableau 05.
- **Une rangée « Self-Diagnostics » dans le tableau 16** : les cinq métriques du sous-système, aveugles depuis ADR-247, y sont câblées, plus les sources de preuves lues par diagnostic ; la baseline de couverture des métriques passe de 56 à 51 entrées.
- **Une 59e carte « Encore + »** : « Un diagnostic qui montre ses preuves », dans la section « Quand ça se passe mal », avec sa scène — le verdict, puis les preuves qui apparaissent ligne par ligne.

## [1.42.2] - 2026-09-05

**La page des routines ne montrait pas la semaine.** Les cartes suivaient l'ordre de la prochaine exécution — un ordre qui bouge chaque jour — et rien ne disait, pour lundi ou pour mercredi, ce qui s'était passé. Une couleur par créneau est une affirmation, et aucune donnée ne la portait : `scheduled_actions` ne garde qu'un `last_executed_at` et un `last_error` sans horodatage, et le registre des tours classe un tour planifié sous l'identifiant de sa conversation, pas de sa routine.

**Et une réunion pouvait rester « en traitement » pendant des heures.** Une synthèse en échec re-conduite toutes les quinze minutes, un membre d'enum nu lié en `NullType` qui annulait la transaction du marquage, un travailleur disparu que rien ne relevait — trois défauts derrière un seul symptôme.

### Added

- **La vue de la semaine des routines** (ADR-265) : une grille au-dessus de la liste, les heures en descendant et les jours en travers, chaque routine à son heure sur ses jours, numérotée dans l'ordre où elle se déclenche — le même numéro sur sa carte. Chaque cellule de la semaine en cours porte l'issue du dernier run qui a servi ce créneau : blanc non exécutée, vert exécutée, rouge en erreur, ambre proposée en attente d'accord, gris en pause ; anneau pour une routine conditionnelle, pulsation pendant une exécution. Une vraie `<table>` (sept en-têtes de colonne, vingt-quatre de ligne, légende nommant le fuseau), des puces `<button>` nommées « rang, titre, heure, état » qui amènent et focalisent la carte, un seul arrêt de tabulation et les flèches pour parcourir la grille. Le titre n'est jamais dupliqué en texte visible.
- **Un historique des exécutions** (`scheduled_action_runs`) : une ligne par tick, écrite par l'exécuteur AU RÉSULTAT dans la transaction du marquage, jamais avant — cinq issues, une par sortie (`success`, `failure`, `skipped_condition`, `proposed`, `skipped_hitl`), dans un savepoint et jamais bloquante pour la routine. La ligne porte le créneau SERVI : un run dû sert son instant dû, un « Tester » lancé après le créneau du jour le sert, lancé avant ne sert rien. CHECK réel sur l'issue (`create_constraint=True` explicite), rétention par réglage `SCHEDULED_ACTIONS_RUNS_RETENTION_DAYS`, purge à l'étape 0 de chaque tick.
- **`GET /scheduled-actions/week`** : la semaine en cours de chaque routine, calculée côté serveur avec le moteur cron qui arme les runs, depuis le lundi local de SON fuseau. Une cellule prend le DERNIER run dont `slot_at` est ÉGAL à l'instant du créneau — égalité, jamais fenêtre — d'où la réinitialisation au changement d'horaire et chaque lundi par construction. Déclarée avant `/{action_id}`, ordre épinglé par un test ; ajoutée à la surface publique du démonstrateur.
- **Les réunions reprennent là où elles en étaient** (amendement ADR-258) : chaque étape acquise est écrite sur la ligne réclamée dans l'instruction de battement de bail — audio normalisé, puis transcription chiffrée — et un claim relit ces points de contrôle avant de dépenser à nouveau ; une réunion sans audio nulle part est classée `audio_unavailable` plutôt que de brûler son budget. Le détail publie `attempts`, `max_attempts` et `worker_stale` ; la page affiche la tentative sur le budget, la raison de la tentative précédente, et une suppression quand le travailleur est parti (`delete_unless_leased`, l'horloge de la base décide).
- **Une réponse valide n'est plus jetée** : un appel d'outil rejeté pour ses `null` sur des champs à défaut est complété génériquement (`llm/tool_call_rescue.py`) avant d'abandonner, et la `parsing_error` écartée est lue pour nommer la vraie raison. Une tâche de fond qui échoue journalise sa trace complète.
- **Une 58e carte « Encore + »** : la semaine sur une grille, avec sa scène — les cellules se colorent au fil de la semaine et se vident le lundi.

### Changed

- **Les cartes de routines sont triées à l'affichage** par heure de déclenchement (heure, minute, titre en tri linguistique numérique, identifiant) : l'ordre `next_trigger_at` de l'API ne change pas, le hub, le briefing et l'outil d'automatisation le lisent. Une routine en pause garde son rang.
- **Le recalcul de fuseau couvre toutes les routines**, en pause comprises : `toggle` et `update` re-dérivent le déclencheur depuis le fuseau stocké, qui est désormais celui de l'utilisateur.
- **Un rafraîchissement n'est plus un premier chargement** : le hook dérive un `initialLoading` monotone, la section garde ses cartes montées et marque la région `aria-busy` pendant un sondage.
- **Le reaper des réunions** remet en file une ligne `processing` sans bail vivant, ou la classe `failed` avec `worker_lost` quand le budget est épuisé ; la rétention ne purge que l'audio des réunions `ready`, celui d'une réunion `failed` reste jusqu'à sa suppression.
- **HOW §16.3, WHY §2.2, la carte « Comment fonctionne LIA », la tuile d'accueil, le lexique de recherche des réglages, la FAQ (q8), le README, le guide technique et le guide API** décrivent la vue de la semaine ; les cartes « Battement autonome » et « Comptes rendus de réunion » ont été resserrées pour que la section tienne sous son plafond.

### Fixed

- **Chaque sondage démontait la liste des routines** (`loading` repasse à `true` à chaque refetch de `useApiQuery`) : spinner et cartes disparues deux fois par minute, tout `<details>` ouvert refermé.
- **Une routine en pause pendant un changement de fuseau gardait l'ancien fuseau** et se réveillait sur l'ancienne horloge.
- **APScheduler 3.11.2 sautait la journée entière** d'une routine 00:xx dans un fuseau dont le passage à l'heure d'été s'ouvre à minuit (Santiago, La Havane, Le Caire, Beyrouth…) — mesuré : 72 créneaux sautés sur 2 184, tous dans cette heure. `_next_fire` est l'unique lecteur du cron dans les helpers et rend le premier instant existant du jour sauté ; différentiel sur toutes les zones IANA : 15 684 identiques, 144 corrigés, zéro anomalie.
- **Toute transition d'une réunion est typée et prouvée en base** : les littéraux portent le type de la colonne (`_status_literal`), une garde AST refuse tout `case()` nu sous `src/`, et chaque transition du repository s'exécute sur PostgreSQL réel — l'incident du 2026-09-05 (33 secondes transcrites, `processing` pendant deux heures) est rejoué.

### Tests

- Backend : `test_schedule_helpers.py` (trou de minuit, différentiel contre le cron brut, `week_slots` / `local_day_slot` / `served_slot`), `test_runs.py`, `test_run_repository.py`, `test_week.py`, `test_router_week.py`, `test_service.py`, dix tests de l'exécuteur (une ligne par sortie, avant le commit, purge à l'étape 0), `tests/integration/domains/scheduled_actions/test_runs_pg.py` (CHECK réel, cascades, lecture, purge) ; réunions : `test_repository_jobs.py` (chaque transition sur PostgreSQL, l'incident rejoué), `test_processing_resume.py`, `test_repository_statements.py`, `test_synthesis_null_tolerance.py`, `test_service_projection.py`, la garde `test_no_bare_enum_in_sql_case_guard.py`.
- Frontend : `scheduled-actions.test.ts` (tri, numérotation, grille, tons, fuseaux, dates, focus itinérant), `useScheduledActions.test.ts` (semaine, premier chargement, refetch après mutation), `ScheduledActionsTimeline.test.tsx` (table, puces, états, jour courant, indisponibilité, clavier), `ScheduledActionsSettings.test.tsx` (ordre, rangs, repli, navigation, sondage sans démontage) ; parcours axe étendu aux cinq états de puce.
- Mesuré : backend 24 185 tests collectés sur 1 467 fichiers, frontend 7 382 tests sur 584 fichiers ; couverture frontend 78,72 / 74,00 / 75,99 / 79,45, plancher des branches relevé de 71 à 72.

## [1.42.1] - 2026-09-05

**Les yeux vivaient ; le reste du visage attendait.** Entre deux réponses, l'avatar clignait, regardait ailleurs, s'endormait — et ses sourcils et sa bouche restaient à leur pose, comme dessinés une fois pour toutes. Mesuré dans un navigateur sur le visage au repos : 0,47 px de mouvement pour la bouche, zéro pour les sourcils, pendant que les yeux respiraient. Un personnage dont seule la moitié du visage vit se lit comme un masque.

**Le mouvement appartient au rig, pas à la feuille de style.** ADR-264 amende ADR-252 : le sourcil gagne une arche et une présence discrète au repos ; une seule respiration porte la masse, les sourcils et la largeur de la bouche sur la même période ; le regard soulève les sourcils et un clignement les abaisse — couplés dans le rig, écrits en valeurs **absolues**, jamais en incréments, parce que le chemin rapide d'inactivité ne réécrit que les canaux qu'une boucle emprunte et qu'un `+=` y dérive toute la session (un test compare vingt mille petits pas à un seul). L'aléa de cette vie vient d'un flux semé séparé : un tirage sur `Math.random` à la construction décalait les séquences épinglées par les tests du widget.

### Added

- **Des sourcils et une bouche vivants** (ADR-264) : arche du sourcil (`browArc`), sourcils présents au repos, respiration commune à tout le visage, couplages regard → sourcils et clignement → sourcils, phrases de parole (une enveloppe à travers la fermeture, une ouverture bornée dans [0, 1]) et des sourcils qui ponctuent la parole sur un motif irrégulier.
- **Une vie propre de la bouche** (`rig/life.ts`) : neuf mimiques relatives — sourire en coin, hoquet de surprise, moue, « hmm », rictus, bouche en cœur, rire retenu, frémissement, claquement — tirées à une cadence de 6 à 14 s (une rafale une fois sur dix), ordonnancées par le rig avec attaque, maintien et relâchement, et une encre de sourcils qui accompagne chaque mimique.
- **Dix saynètes de 3 à 5 s** (`rig/sketches.ts`) sur un visage au repos, toutes les 45 à 120 s : la mouche, le double regard, l'éternuement, le bâillement-étirement, le hoquet, coucou, le vertige, l'assoupissement qui sursaute, le groove des sourcils, le regard soupçonneux. Priorité `tapes > saynète > motifs > base` ; tout changement d'expression interrompt la saynète et le visage est exactement là où il était, vérifié contre un rig jumeau.
- **Trois gestes d'inactivité** — pression des lèvres, coin tiré, tressaillement de sourcil — et les battements existants portent désormais le visage : un « perk » lève les sourcils, un plissement les fronce, une inclinaison esquisse un sourire en coin. Chaque geste joue à une taille tirée entre 0,85 et 1,15.
- **L'avatar sur la page d'accueil** (`LandingEyes`, ADR-240 §5) : chargé en `next/dynamic` sans SSR, apparence en capsules imposée, **une position par surface** (`landingPosition` dans le store) — un emplacement glissé sur l'accueil ne déplace jamais celui du chat —, aucun compte requis, petit et masquable sur téléphone.
- **Une 57e carte « Encore + »** : le visage qui vit entre deux réponses, avec sa scène — sourcils, yeux et bouche sur une même respiration.

### Changed

- **Les aperçus du sélecteur de style ne vivent plus** (`life={false}`) : un aperçu compare des silhouettes, et un éternuement en pleine comparaison n'en est pas une. La respiration et le maintien au repos restent.
- **Le rythme est calibré aux standards de l'animation** : après deux retours de relecture (« trop statique », puis « des tics nerveux »), les mimiques passent de rafales à une cadence de 6 à 14 s, et chaque bande a une attaque, un maintien et un relâchement remis à la dynamique de l'expression.
- Les modules qui écrivent des bandes partagent `rig/choreo.ts` (`relative`, `absolute`, `bothSides`, `mirrored`, `scaleTapes`) ; `gestures.ts`, `scripts.ts` et `life.ts` n'ont plus chacun leur copie.
- Le sourcil est dessiné comme une bande courbe dont la courbure suit `--rig-brow-arc` ; les rayons bas de la bouche suivent `--rig-mouth-arc`.
- **STORY ne raconte plus ses cycles après sa signature** : trois paragraphes de chronique subsistaient après la note finale, dans les six langues — retirés. Le terrain d'exercice nomme le personnage animé ; HOW §31 et WHY §7.2 décrivent la vie du visage au présent.
- La puce du chapitre 2 de la page d'accueil dit que le visage vit entre deux réponses ; en allemand elle disait « ton visage » (« Dein Gesicht ») pour « son visage » — corrigé.

### Fixed

- **Un `+=` sur un canal dérivé dérivait toute la session** : les contributions dérivées des sourcils sont écrites en valeurs absolues depuis le ressort et l'offset des boucles.
- Des planchers de sortie empêchent une bouche de largeur nulle et un œil aplati au-delà de la limite (`MOUTH_WIDTH_FLOOR`, `EYE_SQUASH_FLOOR`) ; l'ouverture de la bouche est bornée dans [0, 1].
- Un `-0` sortait des clés miroir des bandes (`mirrored`) — replié en `+ 0`.

### Tests

- Nouveaux : `life.test.ts` (budget en pixels : maintien mobile sous 2 px au repos, 3 px en travail, 0 sur `focused`), `mouth-life.test.ts`, `sketches.test.ts`, `choreo.test.ts`, `LandingEyes.test.tsx` ; `runtime.test.ts` compare 20 000 petits pas à un seul sur `neutral`, `sleep` et `thinking`.
- Preuves navigateur (harnais hermétique + Docker) : matrice 20 expressions × 6 styles, bandes gelées des mimiques et des saynètes, échantillonnage du rythme, position fixe au défilement et vrai glissement sur l'accueil.
- 583 fichiers, 7 305 tests frontend ; couverture 78,62 / 73,89 / 75,84 / 79,35 (planchers inchangés).

## [1.42.0] - 2026-09-05

**L'extraction unifiée n'était offerte qu'aux administrateurs.** La personne que les enregistrements CONCERNENT n'avait que les exports par registre : composer son propre fichier article 12 supposait de télécharger cinq documents et de les corréler à la main — exactement le travail que l'extraction existe pour éviter.

**Et les guides racontaient leurs bugs.** STORY « La preuve » avait grossi jusqu'à dix-neuf paragraphes, un par cycle de livraison : 19 646 caractères contre 1 000-3 200 pour toutes les autres sections du même document. Un lecteur qui arrive aujourd'hui n'a pas besoin de la chronique, il a besoin de savoir ce que la méthode établit.

### Added

- **L'extraction unifiée article 12 pour l'utilisateur** (`GET /effects/export/article12`) : les cinq enregistrements le concernant en un seul fichier, sous les onglets et dans aucun — il les traverse tous. La route ne déclare **aucun paramètre de compte** : la portée est la session, pas un défaut qu'un paramètre ajouté plus tard pourrait outrepasser. Le contrat est celui de l'administrateur — mêmes colonnes, mêmes exclusions, même pseudonymisation, l'identifiant du demandeur compris — pour que le fichier se joigne à une demande de portabilité ou à une réclamation sans retouche.
- **Un bandeau « Normes et standards respectés »** sous la grille de sécurité de la page d'accueil : RGPD, IA Act article 12, MCP, Agent Plugins, agentskills.io, OWASP Top 10, WebAuthn/FIDO2, OAuth 2.0 + PKCE, OpenTelemetry, Prometheus/OpenMetrics, Keep a Changelog, SemVer, WCAG 2.2 AA. Des noms propres, donc dans le code et non dans six fichiers de traduction qui dériveraient.
- **Une 56e carte « Encore + »** : la ligne du registre est écrite **avant** l'acte, et ne passe au vert que sur un résultat explicite. La scène anime l'ordre, pas l'issue.

### Changed

- **Les cinq lectures des registres sont partagées** (`technical_reads.py`), extraites du routeur d'administration le jour où une seconde surface est apparue : un routeur de lecteur qui importerait un routeur d'administration est le mauvais sens, et deux copies dériveraient le jour où un sixième enregistrement arrive. Une garde refuse qu'une route s'invente son propre aiguillage et vérifie que les deux signatures ne diffèrent QUE par la portée.
- **STORY, WHY et HOW énoncent des règles, pas la chronique de leurs bugs** : dix-neuf récits de cycle retirés de STORY §6, six de WHY §8.1, et la dernière « leçon » de HOW reformulée en la règle CSS qu'elle portait. Six langues.
- **La page d'accueil est rééquilibrée** : chapitre 6 ramené dans la bande des cinq autres (1 317 → 1 035 caractères en anglais), et les quatre blocs de sécurité qui allaient de 98 à 582 caractères tiennent maintenant entre 185 et 310 — la carte BFF répétait sa propre compartimentation en trois clauses successives.

### Fixed

- **La numérotation de WHY §6 était dupliquée** : deux 6.4 et deux 6.5, dans les six langues. Un lecteur qui citait « 6.4 » pouvait désigner l'une ou l'autre.
- **Deux pièges du script de déploiement**, hors périmètre mais bloquants : un avertissement de `wsl` sur stderr devenait une erreur terminante sous `ErrorActionPreference = "Stop"` alors que la commande réussissait ; et le repli scp envoyait les dix-huit entrées en une seule session que le pair réinitialisait — le « No such file or directory » affiché n'était qu'une conséquence de la coupure. Une session par entrée désormais, chacune avec le réessai existant.

### Tests

- Dix unitaires sur la route utilisateur : portée réelle des cinq lectures, absence de paramètre de compte, en-tête, pseudonymisation de son propre identifiant, et partage d'implémentation avec la surface admin.
- La surface publique du démonstrateur déclare la nouvelle route — sa garde l'a exigé sans qu'on la sollicite.
- 21 913 unitaires backend, 7 198 frontend (578 fichiers).

## [1.41.0] - 2026-09-05

**Un assistant qui agit à votre place doit pouvoir dire ce qu'il a fait, et ce qu'il a regardé pour le faire.** Cette version ajoute cette capacité au produit : deux registres tenus automatiquement — les **actions** et les **consultations** — plus trois enregistrements techniques qui complètent la traçabilité attendue par l'article 12 de l'IA Act (le tour lui-même, les paramètres de chaque appel de modèle, et les lacunes du registre). Rien n'est déclaratif : une action est inscrite **avant** d'avoir lieu et close **uniquement** sur un résultat explicite, la porte est installée sur la capacité au moment de son enregistrement, et le démarrage refuse une capacité qui ne déclare pas ce qu'elle doit à l'utilisateur.

**Les registres se lisent, s'exportent et se dessinent.** Un troisième onglet donne la forme de la période — dix séries agrégées côté serveur, jamais comptées dans le navigateur — et le même composant sert le lecteur pour son compte et l'exploitant pour un, plusieurs ou tous les comptes. L'export existe en trois formats, y compris le format technique, pour que le fichier d'un utilisateur soit transmissible tel quel.

**Trois défauts trouvés par relecture adversariale, après des portes vertes.** Un export plafonné rendait les lignes les **plus anciennes** faute de tri — il couvrait janvier et nommait des modèles retirés, tout en annonçant sincèrement « plafonné ». Un brouillon confirmé dont la revendication était perdue renvoyait un dictionnaire vide, que l'appelant présentait comme un **succès**. Et l'extraction article 12 — la lecture la plus large de l'application — annonçait « réservé aux administrateurs » dans sa documentation sans jamais le vérifier.

### Added

- **Registre des actions et registre des consultations** : une ligne par action (envoi, création, suppression) avec son résultat, sa confirmation et sa politique déclarée ; une ligne par capacité consultée, qui retient **le domaine, jamais la demande**. Deux registres et non une liste filtrée : ils comptent des choses différentes et ne s'additionnent jamais.
- **Une représentation graphique des registres** (`GET /effects/statistics`, `GET /admin/effects/statistics`) : dix séries, un onglet « Vue d'ensemble » pour l'utilisateur, la même vue pour l'administrateur sur un, plusieurs ou tous les comptes. Chaque figure porte le **total exact** de l'ensemble filtré, y compris ce que le top-12 a replié dans « autre ».
- **Un export technique pour l'utilisateur**, en plus du lisible et du CSV : le même contrat que celui de l'administrateur, pour qu'un fichier remis à un tiers ne soit pas un format à part.
- **Deux sujets « Sous le capot » sur la page d'accueil** : les registres de transparence, et le vocabulaire commun qui permet à une question de traverser les sources.

### Changed

- **Une série dit désormais ce que son chiffre signifie.** Trois natures — un compte, deux mesures empilées, une moyenne — parce qu'une somme de moyennes n'est pas une quantité et qu'un total qui ne couvre qu'une moitié d'une barre empilée est plus court que la barre. La latence moyenne est calculée **pondérée par les observations**, y compris pour la barre repliée.
- **Un nom d'outil tiers ne peut plus atteindre un axe** : le graphique des latences groupait sur la colonne brute, ce qui affichait sur l'écran de l'exploitant les serveurs MCP installés par un compte. Il se replie maintenant sur un mot, comme le registre des consultations le faisait déjà.
- **Les deux onglets des registres sont symétriques** : mêmes commandes aux mêmes endroits, filtre générique partagé, et un en-tête qui tient sur un téléphone.
- **La tuile du tableau de bord s'appelle « Registres »** : la surface avait cessé d'être un journal des actions seul.
- **La section « Sous le capot » est rééquilibrée et vulgarisée** : les articles allaient de 120 à 884 caractères, ils tiennent maintenant dans une même fourchette, dans le registre du reste du site et dans les six langues.

### Fixed

- **Une lecture plafonnée dit quel bout elle garde.** Les cinq lectures d'export portaient un `LIMIT` sans `ORDER BY` : PostgreSQL rendait les lignes les plus anciennes, si bien qu'un export lu le 2026-09-05 couvrait janvier à mars et nommait huit modèles que l'instance ne configure plus. Un assistant partagé trie du plus récent, plafonne, puis inverse.
- **Un brouillon confirmé n'annonce plus un succès qu'il ignore.** Quand la revendication est perdue sur une ligne sans résultat — une première tentative en échec, ou une gagnante encore en vol — la porte lève désormais une erreur explicite, traduite dans les six langues, au lieu de rendre un dictionnaire vide que l'appelant présentait comme « fait ».
- **L'extraction article 12 exige un administrateur.** Sa documentation l'affirmait, son code ne le vérifiait pas.
- **Les graphiques de l'administrateur et la vérification de chaîne inter-comptes répondaient 422 à toute requête bien formée** : le garde-fou `require_superuser` est un helper impératif à deux paramètres, et le câbler en `Depends` en faisait un paramètre de requête obligatoire — la route était donc morte, et ne vérifiait rien.
- **Une écriture de registre abandonnée n'est plus collectable en cours de route** : la tâche est retenue par le registre de tâches de fond du module, comme toute autre écriture différée.
- **L'entrée d'audit d'un démasquage décrit la requête réellement exécutée**, et non le paramètre non substitué.

### Tests

- Trois nouvelles suites : la porte sur les exécuteurs de brouillons (aucune couverture directe jusqu'ici), l'arithmétique du pliage des séries, et la route des statistiques administrateur exercée **à travers le vrai routeur** — le défaut ne vivait que dans le câblage, un test de handler serait resté vert.
- Trois gardes structurelles : aucune route d'administration sans contrôle réel (lecture AST d'un **appel**, pas d'une mention), aucun usage du helper impératif en dépendance, et aucun paramètre de requête obligatoire qu'un endpoint n'a pas déclaré.
- 21 900 tests unitaires backend verts, couverture 72,04 % (plancher 70) ; 7 191 tests frontend.

## [1.40.0] - 2026-09-03

**Trois boucles tournaient en silence, et une seule cause de plomberie les taisait.** Le push Google marchait — 802 notifications Gmail traitées en quinze jours, aucun jeton refusé — sans que rien n'en découle : leur unique lecteur invalidait des caches. Les habitudes observaient depuis des semaines sans jamais rien proposer. La boîte de propositions restait vide. L'audit a croisé les journaux, Redis et la base : **le « nouvelle conversation » effaçait toute clé Redis portant l'identifiant de l'utilisateur** — dont le registre des récurrences, l'ancre de lecture du courrier et les seuils adaptatifs. Cent soixante et un resets en cinquante-six jours : l'apprentissage n'a jamais eu quatorze jours devant lui.

**Une clé déclare désormais ce qu'elle est, et un reset ne purge que ce qu'il a créé** (ADR-260). Cinq portées — conversation, cache, apprentissage, exécution, global — une purge par famille au lieu d'un motif, et une famille inconnue est **conservée puis comptée** : garder une clé qu'on ne connaît pas coûte un cache manqué, la supprimer peut coûter des semaines. Deux gardes refusent le démarrage ou la construction si un préfixe échappe au registre.

**Un push provoque enfin une décision** (ADR-261). Une notification traitée met l'utilisateur en file — une tempête reste **un** réveil, daté du premier — et un balayage élu leader la sert **sous l'éligibilité complète** : fenêtre, quota, cooldowns, préférence de source. Seul le lissage aléatoire est contourné, parce qu'un réveil répond à un événement. Le delta du courrier est **prévisualisé sans être consommé** tant que le réveil n'est pas servi : un réveil refusé laisse le message au tour suivant. Un changement Drive réindexe exactement les fichiers touchés, et l'historique dit désormais si une notification répondait à un e-mail ou à l'horloge.

**Et un espace de connaissances peut suivre un libellé Gmail** (ADR-262). Indexer la boîte entière a été mesuré puis refusé : une seconde archive personnelle à protéger, un coût d'embedding dépensé sur des notifications et des listes, une recherche diluée par du texte que personne n'a choisi de garder. L'opt-in est donc le geste que l'utilisateur connaît déjà — poser un libellé. Un fil devient un document Markdown ; retirer le libellé retire le document.

### Added

- **Un registre des familles de clés Redis** (`infrastructure/cache/key_families.py`) : chaque famille déclare sa portée, la purge du reset lit le registre au lieu d'un motif, et l'apprentissage — registre des récurrences, ancre du courrier, seuils adaptatifs, dernières valeurs sûres du briefing, présence — survit désormais à une remise à zéro. « Tout oublier » et la suppression de compte restent, eux, totaux.
- **La présence en lecture comme quatrième source de rythme** (`HABITS_PRESENCE_ENABLED`, désactivée par défaut) : ouvrir l'application compte, un pouce sur une notification compte, **une notification envoyée ne compte jamais**. Au plus une heure retenue par heure locale, écrite directement dans le cumul durable ; la porte d'inactivité du heartbeat lit maintenant la dernière présence autant que la dernière connexion — deux comptes s'étaient tus faute de reconnexion.
- **Le réveil du heartbeat par une notification Google** (`PUSH_WAKE_ENABLED`, désactivé par défaut) : file de réveil, cooldown propre, pré-filtre **déterministe et publié** (libellé requis, catégories exclues, courrier de liste écarté ; invitation d'un tiers ou réponse en attente dans l'horizon), puis la décision pour cet utilisateur seul. Aucune règle « expéditeur favori » n'a été inventée : aucune adresse ne vit dans les relations, c'est une évolution énoncée, pas une approximation silencieuse.
- **La réindexation ciblée d'un dossier Drive** à partir des changements notifiés, sous le verrou de la synchronisation manuelle, par l'ingestion par fichier désormais partagée avec la synchronisation complète.
- **Une source « libellé Gmail » pour les espaces de connaissances** (`RAG_SPACES_MAIL_SYNC_ENABLED`, désactivée par défaut ; le chemin incrémental demande aussi `PUSH_WAKE_ENABLED`) : choisir un libellé parmi les siens, voir l'état de la synchronisation et le nombre exact de fils indexés, arrêter de le suivre en gardant ou en supprimant les documents. Un fil rend son sujet en titre, ses messages dans l'ordre, **les noms des pièces jointes seulement**, sous une taille bornée.
- **Deux migrations** : `a7c3e9b1d5f2` (horodatage des pouces, déclencheur `push`/`tick` sur les notifications) et `f1a2b3c4d5e6` (table `rag_mail_sources`, provenance de courrier sur les documents).
- **Quatre panneaux Grafana** pour la source e-mail, deux pour la purge du reset, quatre pour la présence et les réveils : aucune métrique de cette version n'est aveugle.

### Changed

- **Une seule définition durable du « tour humain »** (`habits/human_turns.py`), partagée par le détecteur de rythme, les bornes d'observation et l'amorçage du registre : `product_outcomes.channel = 'web'`, une colonne que le reset ne supprime pas. L'ancienne lecture — « pas de résumé de tokens, donc un humain » — prenait les tours du planificateur pour ceux de l'utilisateur et amorçait le registre avec les routines de LIA.
- **Les habitudes affichent la provenance d'un candidat** : « observé » ou « reconstruit depuis l'historique », parce qu'un compteur ne dit pas d'où il vient.
- **La carte d'une source synchronisée est unique** pour Drive et pour le courrier, et ses actions ne se révèlent plus au survol : elles sont visibles à toutes les tailles et se replient dans un menu nommé sur téléphone.
- **Les trois travaux durables d'une source** (bail, reprise, moisson) prennent la table en paramètre, validée contre une liste blanche de deux noms : un dossier Drive et un libellé Gmail se réparent par le même code.

### Fixed

- **Une remise à zéro de conversation ne détruit plus l'apprentissage.** C'est la correction dont dépendent les trois symptômes.
- **L'amorçage du registre des récurrences ne prend plus les tâches planifiées pour des habitudes** ; une suggestion de récurrence ignore désormais les tours automatisés, comme l'enregistrement le faisait déjà.
- **Un compte qui vit en lisant obtient enfin un profil** : les bornes d'observation ignoraient les pouces, et la présence n'a pas d'horodatage propre — un lecteur restait « sans activité » pour toujours.
- **Un identifiant de migration réutilisé faisait échouer Alembic pendant que la garde d'hygiène passait au vert** : elle indexait les révisions par identifiant, si bien qu'un doublon lui donnait « aucune révision ». Elle refuse maintenant un doublon comme une chaîne sans tête.
- **Le nom d'un document n'est plus de confiance** : avec la source e-mail il devient un sujet écrit par un tiers, et il partait tel quel dans un en-tête de téléchargement. Le nom stocké et l'en-tête sont assainis — au bénéfice aussi des fichiers importés et des comptes rendus.
- **Un delta de calendrier ne déforme plus le contrat des fournisseurs** : la lecture « ce qui a changé depuis » est une méthode Google dédiée, les autres agendas ne sachant pas la rendre.
- **Une réindexation Drive qui échoue le dit** au lieu de répondre « aucun dossier lié » — un verdict faux dans une métrique est pire qu'une métrique absente.

### Tests

- **189 tests backend et 32 tests frontend**, dont 26 fichiers backend et 4 fichiers frontend entièrement nouveaux, la plupart écrits avant le code : portée des familles de clés et complétude du registre au démarrage, purge réelle contre un vrai Redis (l'apprentissage survit, une famille inconnue survit, la suppression de compte ne laisse rien), prédicat du tour humain contre le vocabulaire du domaine, présence (limitation horaire, deux workers, heure d'été, changement de fuseau, Redis indisponible), file de réveil sur un vrai Redis (**une tempête de cinquante notifications = un réveil daté du premier ; deux balayages concurrents se partagent la file sans jamais servir le même utilisateur**), table de cas du pré-filtre, contexte « frais » qui ne consomme pas l'ancre, balayage et ses issues comptées, rendu d'un fil de courrier (ordre, texte préféré, noms des pièces jointes, taille bornée, sujet hostile), chemin incrémental (libellé posé, libellé retiré, ancre expirée), propriété d'un espace qui cache l'existence, et la carte de source partagée (actions nommées, jamais révélées au survol, refus d'une seconde synchronisation).
- **Rejeu complet des migrations depuis une base vide**, cycle descente/remontée et équivalence structurelle modèles ↔ schéma.
- **Complexité cyclomatique backend abaissée** (331 → 330 fonctions au-dessus du seuil), plafond reverrouillé.

## [1.39.1] - 2026-09-03

**Le modèle unique devient une bibliothèque, et le compte rendu choisit sa forme.** v1.39.0 livrait l'enregistrement de réunion avec **un** modèle par utilisateur et annonçait une bibliothèque pour plus tard : la voici (ADR-259). Trente modèles intégrés en sept catégories — réunions et équipes, transcriptions, analyses de conversation, commercial et conseil, technique, rendez-vous personnels, cours et formation — que l'utilisateur ajoute à ses modèles, adapte et décline. Quand il n'a rien choisi, **LIA choisit** à partir de ce qui a été dit, et la réunion affiche le format retenu, comment il l'a été et en une ligne pourquoi. Et un compte rendu déjà rédigé se réécrit dans un autre format depuis la transcription conservée : en place, ou en **nouveau compte rendu** issu de la même transcription, indexé comme son propre document.

**Une cinquième sorte de section : la transcription elle-même.** Les quatre formats existants résument tous ; aucun ne rendait l'échange, nettoyé ou professionnalisé. Le slot `meeting_synthesis` sort au plus 8 000 tokens (surcharge lisible en base) : une transcription entière n'y tient pas. Elle est donc réécrite **par parties**, chaque partie sous un budget de sortie dérivé de la configuration effective du slot, un index manquant scindant la partie une fois et une réponse trop courte étant retentée une fois. Ces modèles-là sont exclus du choix automatique : longs et facturés comme une réunion entière, ils restent un choix explicite.

**Quatre défauts d'ADR-258 sont tombés en chemin, tous trouvés en lisant le code.** Le compte rendu partait par le connecteur e-mail de l'utilisateur — donc pas du tout sans connecteur — alors que la plateforme dispose de `APPLICATION_SMTP_FROM` ; et cet envoi SMTP était **synchrone sur un chemin asynchrone**. Une régénération tuée net laissait la réunion sur « reconstruction » pour toujours, sans moissonneur. La coque du chat ignorait la hauteur du bandeau d'enregistrement : le composeur passait sous le pli pendant toute la réunion. Enfin, `rag_chunks.space_id` étant dénormalisé, déplacer un document sans ses morceaux l'aurait laissé répondre depuis son ancien espace — la raison pour laquelle le déplacement d'espaces de connaissances déplace la ligne, ses morceaux **et** son fichier, dans cet ordre.

### Added

- **La bibliothèque de modèles de compte rendu** (page `/dashboard/meetings/templates`) : « Mes modèles personnalisés » puis les modèles intégrés, chacun groupé par catégorie, **toutes repliées par défaut** et absentes quand vides. Un modèle intégré s'aperçoit et s'ajoute à ses modèles, seul ou par sélection ; un modèle personnel s'aperçoit, se modifie, se décline et se supprime, seul ou par sélection. L'ajout n'ouvre jamais de formulaire : l'utilisateur fait son marché, puis édite chez lui.
- **Une identité pour un modèle** (`TemplateRef` : `builtin:<clé>` ou `user:<uuid>`) que réunions, préférences et requêtes échangent à la place d'une ligne : un intégré n'a pas besoin d'exister en base, et un modèle supprimé laisse une référence dont les lecteurs savent se replier (l'instantané de sections et le nom conservés sur la réunion).
- **Le choix automatique du format** : une seule précédence — la référence de la réunion, puis le format par défaut de la préférence, puis le choix du modèle parmi les candidats sur un extrait de transcription au-dessus d'un seuil de confiance, puis l'intégré par défaut. Chaque issue est comptée (`meeting_template_selection_total{outcome}`, panneau Grafana) et **écrite sur la réunion** avec la raison énoncée par le modèle.
- **Une cinquième sorte de section, `transcript`** : l'échange réécrit tour par tour, découpé sous `MEETINGS_REWRITE_PART_CHARS`, chaque partie bornée par `MEETINGS_REWRITE_OUTPUT_SAFETY` de la fenêtre de sortie effective, une réponse suspecte retentée sous `MEETINGS_REWRITE_MIN_RATIO`.
- **Changer le format d'un compte rendu** (`POST /meetings/{id}/reformat`) : `replace` réécrit en place par la régénération durable, `new` crée une réunion dérivée (`source_meeting_id`, FK `SET NULL`) qui pointe sa source, s'indexe comme son propre document et affiche son propre coût. Le vocabulaire ne dit jamais « copie » : la transcription est la même, le compte rendu non.
- **Le format se choisit pendant l'enregistrement**, depuis le bandeau : la réunion le retient tout de suite, le store du recorder s'en souvient, un rechargement montre ce que le serveur détient.
- **Sélection et suppression groupée des réunions** (`POST /meetings/bulk-delete`) : chaque identifiant supprimé ou ignoré avec son code — une capture en cours ou un traitement ne se suppriment pas depuis la liste.
- **Lots de modèles** (`POST /meetings/templates/bulk-duplicate` et `bulk-delete`) : chaque référence créée ou supprimée, ou ignorée avec un code stable, le plafond respecté élément par élément, un nom déjà possédé numéroté « (2) ». Une suppression qui emporte le format par défaut le **remet à l'automatique et le dit**.
- **Espaces de connaissances : les documents deviennent manipulables** — télécharger un document, télécharger une sélection en une archive zip (noms d'origine dédoublonnés, `_missing.txt` pour ce qui manquait sur le disque, plafond `RAG_SPACES_ARCHIVE_MAX_MB`), déplacer des documents vers un autre espace, en supprimer plusieurs. Un lot rapporte chaque identifiant fait ou ignoré ; un document synchronisé depuis Drive ou issu d'une réunion reste où son propriétaire l'a mis, et rien ne bouge pendant une réindexation.
- **Migration `e0f1a2b3c4d5`** : `meeting_templates` gagne description, catégorie et clé d'origine et perd `is_default` ; `meeting_preferences` gagne le format par défaut ; `meetings` gagne référence, nom, mode de sélection, raison et réunion source. Aucune donnée à migrer : aucun modèle personnalisé n'existait, chaque compte démarre en automatique.
- **Trois réglages** `MEETINGS_TEMPLATE_AUTO_SELECT_ENABLED`, `MEETINGS_TEMPLATE_AUTO_MIN_CONFIDENCE`, `MEETINGS_MAX_USER_TEMPLATES` et un réglage `RAG_SPACES_ARCHIVE_MAX_MB`.

### Changed

- **Le compte rendu part de la plateforme** (`APPLICATION_SMTP_FROM`) vers l'adresse du compte, sujet « Compte rendu de réunion · Titre » ; le connecteur e-mail de l'utilisateur et son refus `email_connector_missing` disparaissent du chemin. L'échange SMTP passe par `asyncio.to_thread` et les journaux INFO ne portent plus ni destinataire ni sujet.
- **L'enregistrement quitte le « + » du composeur**, redevenu un sélecteur de fichiers : une bascule dans l'en-tête sur ordinateur (disque qui pulse pendant la capture), une entrée dynamique « Enregistrer / Arrêter » dans le menu du logo sur téléphone dont le déclencheur pulse en rouge, et le bandeau collant sur chaque page du tableau de bord.
- **L'éditeur de modèle se lit d'un coup d'œil** : chaque section affiche « Section N · titre · format », la consigne donnée à LIA se replie derrière un bouton nommé, et une section sans consigne s'ouvre d'elle-même — c'est du travail à faire, pas du détail.
- **Le sélecteur de personnalité n'affiche que son icône à toutes les largeurs** ; son nom vit dans le menu et dans le nom accessible.
- **Les listes de formats distinguent leurs catégories** : glyphe de catégorie et libellé en couleur de thème, séparateur entre les groupes, modèles indentés dessous.
- **Deux primitives partagées gagnent un état « refusé »** (`RowActions`, `SectionToolbar`) : un plafond atteint est énoncé (`aria-disabled`), le contrôle reste au clavier et déclenche quand même — c'est l'appelant qui explique, jamais un contrôle qui disparaît. La barre de sélection devient un primitif partagé (réunions, modèles, documents).

### Fixed

- **Une régénération tuée net ne bloque plus la réunion** : le moissonneur libère un bail expiré (`clear_stale_regenerations`) et la réunion redevient reconstructible.
- **Le composeur ne passe plus sous le pli pendant un enregistrement** : le bandeau publie sa hauteur mesurée (`--meeting-banner-h`) et la coque du chat la soustrait, comme elle le faisait déjà pour le bandeau de connecteur.
- **Un document déplacé emmène son index et son fichier** : la ligne, ses morceaux, puis le fichier ; un renommage qui échoue remet les deux en arrière et le rapporte pour ce document seul. Un fichier déjà absent du disque n'empêche plus le déplacement — l'index est ce que la recherche lit.
- **Une régénération lit le format DE LA RÉUNION**, plus le format par défaut courant de l'utilisateur : « Regénérer » ne change plus de forme dans le dos de son lecteur.
- **Le chemin d'accès d'un document a un seul constructeur** et une seule vérification de propriété (`document_access.py`), partagés par la lecture, la suppression, le téléchargement et le déplacement ; une archive qui échoue en cours d'écriture ne laisse plus son fichier temporaire.

### Tests

- **244 tests frontend et 765 tests backend couvrent les domaines touchés**, la plupart écrits avant le code : catalogue (complétude des trente modèles dans les six langues, bornes identiques à celles que le validateur applique), analyse des références, matrice de résolution du format (réunion, préférence, automatique, repli, désactivé), réécriture de transcription (découpe aux frontières de tour, index manquant, réponse trop courte), reformatage `replace` et `new` (audio non copié, coût de transcription resté sur la source, `SET NULL` à la suppression), lots de réunions, de modèles et de documents (chaque code d'exclusion), déplacement de document (morceaux, réversion sur échec de renommage, fichier absent), archive (noms dédoublonnés, manquants, plafond, nettoyage du temporaire), envoi hors boucle avec son en-tête `From`, garde de migration ; côté interface : bibliothèque (sections, catégories repliées, actions par ligne, sélections, plafond), page des modèles (ajout, suppression avec avertissement de préférence, aperçu, formulaire), dialogue de changement de format, panneau d'attente, filiation, sélecteur du bandeau, contrôle d'en-tête et entrée du menu mobile, lignes et barres des espaces de connaissances.
- **Preuve runtime dans les conteneurs de dev** (spec §8.1) : enregistrement PCM de 50 s → READY en 32 s avec un format choisi automatiquement et sa raison → nouveau compte rendu en transcription en 8 s avec son propre coût → remplacement en 4 s → courriel reçu par un puits SMTP local avec `From: <APPLICATION_SMTP_FROM>` → suppression groupée et projections RAG disparues ; côté espaces, deux dépôts, une archive, un téléchargement, un déplacement suivi de son fichier, une suppression groupée.
- **Ratchets relevés après amélioration** : seuils de couverture frontend 75/70/72/76 → **76/71/73/76** (mesuré 78,07 / 73,38 / 75,25 / 78,82) et plancher backend 68 % → **69 %** (mesuré 71,15 %).

## [1.39.0] - 2026-09-03

**Un geste, et une réunion devient un compte rendu.** Le bouton « + » du composeur — celui qui joignait déjà un fichier — enregistre une réunion avec le téléphone ou l'ordinateur comme micro ; à l'arrêt, LIA transcrit l'ensemble et rend un compte rendu à la structure de l'utilisateur (ADR-258). L'exigence était double : **fonctionner en PWA, proprement et sans à-coups**, et **la structure du compte rendu appartient à l'utilisateur** — un modèle par utilisateur, remis au défaut d'un clic, appliqué a posteriori par « Reconstruire ».

**Chaque hypothèse a été mesurée avant d'être conçue.** Le Whisper local tronquait tout au-delà de ~30 s sans le dire (la saisie vocale ne l'avait jamais vu : une commande est courte) ; les deux moteurs distants acceptent un fichier entier et séparent les voix ; Safari ne produit pas le même conteneur que Chrome ; les deux plateformes mobiles coupent le micro en arrière-plan ; la production tourne sur quatre workers. Le design en découle : des segments par fichier, du PCM imposé sur Apple, des fenêtres de parole pour le moteur local, un verrou d'écran, et la ligne `meetings` comme job durable (ADR-129).

**Puis la fonctionnalité a été conduite de bout en bout dans les conteneurs de dev, cinq fois.** Les preuves ont trouvé quatre défauts qu'aucune suite unitaire ne voyait : une relecture périmée après un `UPDATE` en masse (un arrêt répondait `status: recording`), l'absence de repli au traitement (une clé refusée mettait la réunion en échec alors qu'une clé OpenAI attendait), un coût « 0,00 € » pour un modèle sans tarif, et une projection RAG orpheline après suppression. Chacun a son test.

### Added

- **Enregistrement de réunion depuis le composeur** : deux sources audio derrière une interface (Opus par `MediaRecorder`, PCM brut par le worklet partagé avec la saisie vocale — le seul chemin sur Apple), le format décidé au démarrage par une fonction pure, des segments envoyés dans l'ordre avec reprise et attente hors ligne, une bannière dans la mise en page du tableau de bord (durée, niveau, segments partis, reprises), un garde du silence, une durée maximale, un verrou d'écran.
- **Le compte rendu structuré** : en-tête fixe (date, horaires, durée, lieu, participants) et sections du modèle utilisateur (paragraphe, puces, sujets, actions avec responsable et échéance) ; un appel structuré sur le slot `meeting_synthesis`, condensation par parties quand la transcription déborde la fenêtre du modèle, `repair_report` qui replie la réponse permissive dans le rapport strict ; édition, restauration de la version générée, reconstruction avec le modèle courant.
- **La chaîne de moteurs** : slot admin → ElevenLabs Scribe → OpenAI `gpt-4o-transcribe-diarize` → Whisper local **sans plafond de durée** (fenêtres VAD Silero ≤ 20 s dans `voice/stt/long_audio.py`, qui corrige aussi la troncature de la saisie vocale) ; le moteur et son prix par heure publiés avant le premier octet ; **la chaîne reparcourue au traitement** (`transcribe_with_fallback`) : une faute permanente d'un fournisseur passe au suivant, seuls le silence et les fautes transitoires arrêtent le parcours.
- **Un sérialiseur, trois sorties** : Markdown pour l'espace de connaissances « Réunions » (trouvé par rôle `rag_spaces.kind`, un document par réunion réécrit en place, supprimé avec la réunion), contenu sectionné pour le PDF (ADR-226), HTML pour l'e-mail par le connecteur de l'utilisateur ; notification `task_type="meeting"` avec sa carte dans le chat.
- **Chaque unité payante est comptée et affichée** : l'audio par les statistiques STT distantes, les tokens par `track_proactive_tokens` sous le `run_id` que porte le message archivé (régénérations comprises) ; la ligne garde la dépense propre au compte rendu (`synthesis_*`), la page affiche le total exact et sa décomposition, la liste le total, la carte du chat les deux unités et leur somme ; un modèle sans tarif administré donne `null`, jamais zéro (ADR-185).
- **Une destination « Réunions » dans l'en-tête**, entre Relations et Alertes, présente seulement là où l'instance active la fonction (`visibleDestinations`, une seule table pour la barre et le menu mobile) ; page liste avec total exact, page détail (faits, progression, échec avec relance, compte rendu, transcription), section de réglages (moteur, langue, rétention audio, modèle de compte rendu), commande `/meetings`, capacité de plateforme `MEETINGS`, tableau Grafana `27-meetings.json`, sept métriques.
- **Migration `meetings` / `meeting_templates` / `meeting_preferences`** + colonne `rag_spaces.kind` et `source_type=meeting` ; réglages `MEETINGS_*` (bloc `[87]`) et six réglages de fenêtrage vocal ; volume `meetings_data` ; export RGPD.
- **Les tarifs des deux moteurs STT OpenAI voyagent par migration** (`seed_meetings_stt_pricing`) : la production ne rejoue jamais le lot de seeds, une instance mise à jour aurait transcrit avec `gpt-4o-transcribe-diarize` sans pouvoir le refacturer ; la ligne de catalogue n'est insérée que si le modèle est inconnu, le tarif seulement si aucun tarif actif n'existe — un prix administré n'est jamais écrasé, et une garde tient la migration et le lot de seeds égaux ligne pour ligne.

### Changed

- **Le trombone du composeur devient un « + »** : il ouvre des actions, dont joindre un fichier ; 44 px de large sur téléphone, 40 au-delà, espacement réduit sur téléphone — la zone de saisie garde la largeur.
- **Le sélecteur de langue montre son drapeau seul à toutes les largeurs** et le titre de la personnalité attend `2xl` : sept libellés dans la barre ont été payés côté contrôles, pas côté destinations.
- **Le contexte React du recorder ne publie que l'état grossier** (`MeetingRecorderContextValue`) : le vumètre et les compteurs n'appartiennent qu'à la bannière, le composeur ne se re-rend plus plusieurs fois par seconde pendant une réunion.
- `startup/schedulers.py` reste sous 600 SLOC : les jobs réunions et la gigue vivent dans `scheduler_meetings.py` / `scheduler_jitter.py`.

### Fixed

- **Relecture périmée après une transition en masse** : l'accusé de segment lit `RETURNING`, toute relecture après transition expire la session (`MeetingService._fresh`).
- **Le plafond côté serveur est un arrêt, pas une panne** : un onglet ralenti qui rate le plafond client reçoit 413 `duration_cap_reached` ; la file d'envoi se déclare réglée à la séquence refusée et l'arrêt déclare ce que le serveur détient — aucune lacune inventée.
- **Une réunion Opus adoptée depuis un autre appareil ne reprend que dans le même conteneur** (`format_unavailable`), sinon Finaliser / Abandonner ; une régénération ne peut plus rester bloquée sur `synthesizing` ; un échec après `ready` (notification, indexation) est journalisé et compté, jamais requalifié en échec ; cinq codes d'erreur backend manquaient au frontend ; la vue des puces saute les lignes vides comme les autres rendus.

### Tests

- **~330 tests frontend et ~150 tests backend écrits avant le code** : machine à états du recorder sous fakes (démarrage, silence, plafond client et serveur, arrêt avec lacunes, hors ligne, reprise, réconciliation, adoption multi-appareil), file d'envoi (ordre, reprise, hors ligne, compte réglé après refus), sources audio, store persisté, bannière, fournisseur (contexte grossier), composeur, éditeurs, vue, réglages, pages liste et détail (quinze parcours), carte de chat avec coûts ; côté API : modèles, gabarits, store audio, résolution et exclusion des moteurs, transcription et repli, synthèse (réparation, condensation, coût), rendu, enrichissement, indexation, livraison, classification du job et régénération (dépense cumulée), notification (run_id et coûts), gardes du service (RETURNING, expiration, suppression de la projection), clients de fichiers ElevenLabs/OpenAI sous `httpx.MockTransport`, fenêtres VAD.
- **Cinq preuves runtime** contre les conteneurs de dev par le contrat HTTP (spec §8.1) : PCM → repli OpenAI → `ready`, WebM → Whisper local → `ready`, PDF, e-mail, édition, régénération avec dépense cumulée, suppression avec sa projection, message archivé portant `run_id` et coûts.

## [1.38.6] - 2026-09-02

**Cinq défauts de couture, trouvés en lisant la recherche plutôt que le code.** Une revue de littérature (299 articles arXiv triés, 12 retenus) a servi de grille de lecture : non pas pour importer une technique, mais pour poser au code des questions qu'il ne se posait pas. Chaque hypothèse a été validée par une preuve exécutable sur le code de production **avant** toute modification, et cinq défauts ont survécu à la contre-vérification. Tous ont la même forme — **deux sous-systèmes corrects chacun sous son ADR, composés en un comportement que personne ne possède** (ADR-257).

**Le plus grave était invisible parce qu'il traversait une frontière.** ADR-167 marque le texte écrit par un tiers — corps d'e-mail, description d'invitation, page web, résultat MCP — sur les deux surfaces qu'elle énumère. La compaction de l'historique était une **troisième** surface, jamais énumérée : elle résume ce texte marqué sous un prompt dont les neuf règles préservent identifiants, décisions et actions, et ne disent rien de la provenance ; puis le résultat est réémis en `SystemMessage`, c'est-à-dire dans le canal de plus haute autorité, que le fenêtrage ReAct retient précisément parce qu'il _est_ la mémoire compressée de la conversation. Mesuré de bout en bout avec un résumeur conforme : la demande d'un e-mail hostile ressortait comme fait établi, sans marquage. Le chemin de repli blanchissait aussi, en republiant l'URL de l'attaquant sous l'étiquette « Key identifiers preserved ».

**Le deuxième défaut était la conséquence d'un correctif juste.** ADR-248 a délibérément allongé les tours ReAct ; le plafond de messages en garde les 150 derniers. Un tour produisant deux messages par itération évince donc **sa propre question** à l'itération 75 — mesuré, invariant quelle que soit la longueur de l'historique. En aval, le fenêtrage se court-circuite (il cherche le dernier message humain) et aucun des sept blocs système du tour ne porte la question : le modèle terminait son travail sans énoncé de but.

### Added

- **La provenance survit à la compaction** (ADR-257) : un résumé produit à partir de messages portant du texte tiers **hérite** d'une bannière de provenance, calculée à l'écriture — jamais redéduite de ce qu'un modèle a bien voulu répéter. La teinte se propage aussi à travers la consolidation : une deuxième compaction ne peut pas blanchir ce que la première a signalé. Le prompt gagne une règle et une section de sortie « Third-Party Content (Untrusted) », où les demandes trouvées dans un contenu tiers sont rapportées attribuées à leur source, jamais reformulées en faits ou en actions à faire.
- **La bannière est posée APRÈS le marqueur de compaction, et c'est un contrat** : quatre lecteurs reconnaissent ce message par son préfixe ; un préfixe modifié aurait fait disparaître la mémoire compressée de la conversation en silence — exactement le défaut n° 4 qu'ADR-086 avait corrigé. Un test épingle la position.
- **Un tour ne perd jamais sa question** : le réducteur d'état ré-épingle le dernier message humain quand la troncature l'a évincé, sur ses **deux** branches (plafond en tokens et plafond en nombre), juste après les messages système de tête. Strictement sans effet sous les seuils. Le couplage entre `REACT_AGENT_MAX_ITERATIONS` et `MAX_MESSAGES_HISTORY` porte enfin un nom (`react_budget_exceeds_state_window` — éviction à ⌈plafond ÷ 2⌉, vérifiée sur cinq valeurs) et voyage avec l'avertissement, là où il mord.
- **Le contexte délivré à chaque itération est mesuré** : `react_delivered_context_tokens` et `react_context_window_utilization`, alimentés par le compteur mémoïsé du réducteur — aucun ré-encodage de l'historique inchangé sur le chemin chaud — et la fenêtre du modèle résolue par le même point de passage que le seuil de compaction (ADR-244). Deux panneaux Grafana associés. **Aucune politique de compression ne part avec cette version** : la boucle mesurait ses itérations et sa durée, jamais ce qui grossit vraiment ; la mesure décidera s'il faut agir.
- **Le validateur sémantique cherche ce qui manque** : une passe de couverture s'exécute avant l'arbre de décision — énumérer les exigences que la demande établit, puis vérifier que chacune a une étape qui la couvre. `missing_step` existait dans le schéma exposé au modèle et n'était décrit nulle part dans le prompt : aucune des neuf puces de l'arbre ne portait sur une absence. Deux boucliers évitent les faux positifs (une demande d'analyse appartient au LLM de réponse ; une demande qu'aucune capacité ne sert n'est pas une étape manquante), et un verdict route vers la re-planification **silencieuse** bornée — un verdict n'est pas un échec (ADR-184).
- **Le cache Anthropic couvre enfin l'historique** : un `cache_control` racine — le mode documenté pour les conversations multi-tours, dont le point de rupture avance tout seul — s'ajoute au découpage du prompt système, retenu si quatre points de rupture explicites existent déjà (400 documenté). Auparavant seul le bloc système statique était mis en cache, l'historique croissant de la boucle était refacturé plein tarif à chaque itération.
- **Une sonde d'effets de bord de la personnalisation** (`scripts/eval/personalization_probe.py`, outil opérateur, hors CI) : LIA injecte sept sources de personnalisation dans le prompt de réponse et n'en mesurait aucun effet. A/B avec et sans profil sur des scénarios figés FR/EN, trois nombres **chacun avec son seuil** — fuite de profil dans des tâches sans rapport (détection déterministe, jamais un juge), taux de bascule d'opinion vers celle de l'utilisateur (obtenu par une passe d'extraction, parce qu'un juge holistique vérifie la présence et rate l'absence), et écart de diversité des réponses.

### Changed

- **La trace d'exécution garde sa tête et dit le vrai compte** : la rétention gardait la queue seule, effaçant les **premières** actions du tour — celles qu'une instruction injectée déclencherait tôt dans une longue boucle — et affichait la longueur _tronquée_ comme nombre d'étapes. Une seule implémentation (`capTraceSteps`) partagée par le chemin direct et le rechargement, pour qu'une trace rechargée ne puisse jamais différer de celle qu'on vient de voir ; le total affiché inclut les étapes omises, dont le nombre exact est énoncé dans le panneau (six langues).
- **Les fichiers d'exemple s'alignent sur les défauts du code** (90 itérations, 300 s) : la divergence à trois valeurs disparaît. Le budget se gagne par la production (ADR-248), donc seul le travail productif atteint le plafond, et le coût reste borné par le temps de calcul, le budget d'outils (ADR-256) et les caches préfixe des fournisseurs ; un plafond à 15 recréerait le défaut qu'ADR-248 a corrigé.
- **La garde d'hygiène du cache de prompt inspecte tous les répertoires de version**, et non le seul `v1` : une variante future ne pourra pas perdre son marqueur de découpe en silence.

### Fixed

- **Le repli par troncature républiait des identifiants écrits par un tiers** comme identifiants de la conversation : URL et adresses extraites depuis l'intérieur d'un contenu marqué sont désormais listées à part, explicitement non fiables, et la reconnaissance est fail-closed — une balise ouverte sans sa fermeture teinte le message entier.
- **Le commentaire du code affirmait que le cache Anthropic était automatique au-delà de 1 024 tokens.** Il ne l'est jamais : la documentation du fournisseur exige des points de rupture explicites ou le champ racine. Le seuil minimal codé en dur à 4 096 (valeur d'une génération de modèles antérieure) devient une constante nommée, avec une formulation qui dit la vérité — le minimum varie de 512 à 4 096 selon le modèle.
- **Quatre commentaires `(default: N)` des fichiers d'environnement annonçaient des défauts que le code ne portait pas** (1000 contre 150, 10000000 contre 200000, 15 contre 90).

### Tests

- **~95 tests ajoutés, tous écrits avant le code qu'ils décrivent**, sur les chemins que la revue a ouverts : chaîne complète du blanchiment de provenance (marquage à l'entrée, entrée en compaction, absence de règle dans le prompt, perte en sortie, réinjection en message système), propagation de teinte par consolidation, séparation des identifiants par provenance, balise non fermée, ancre du tour sur les deux branches de troncature et son absence d'effet sous les seuils, court-circuit du fenêtrage, relation d'éviction vérifiée sur cinq plafonds, mesure du contexte délivré et survie de la boucle à un compteur défaillant, contrat de la passe de couverture, routage d'un `missing_step` vers la re-planification silencieuse y compris budget épuisé, charge utile Anthropic sur ses quatre cas (dont les quatre points de rupture), rétention tête+queue sur les deux chemins frontend, et le cœur pur de la sonde de personnalisation.

## [1.38.5] - 2026-09-02

**Un tour ReAct dépensait du temps que personne ne comptait.** Le budget de la boucle ne mesurait que le raisonnement — un nœud sur quatre — pendant que le mode pipeline bornait chaque outil et que le ReAct n'en bornait aucun : une délégation (sous-agent, tâche MCP itérative, navigateur) ouvrait sa propre boucle LLM derrière un seul appel d'outil et ne facturait rien à personne. Borne haute théorique d'un tour : une trentaine d'heures. ADR-256 rétablit la conservation : **ce qu'un tour dépense se compte, et se compte au bon endroit.**

**Et un serveur connecté ne savait pas dire à qui il parlait.** « Liste mes dépôts GitHub » finissait en « quel est ton nom d'utilisateur ? » — sur un serveur authentifié par OAuth au compte de l'utilisateur. Rien ne publiait ce fait au modèle : la description générée résumait les outils (« dépôts publics »), le toolset n'exposait aucun outil d'identité, et le sous-agent n'en savait pas plus. Le remède n'est pas une phrase de prompt — une première version affirmait « le serveur est déjà authentifié », ce qui est faux pour tout serveur sans authentification. **Un fait qui varie par serveur est une donnée** : il est dérivé de `auth_type` et voyage avec le serveur, jamais affirmé en prose.

**La même exigence d'honnêteté traverse le reste de la version** : un rafraîchissement OAuth qui recomposait les credentials en perdant `client_id` (le deuxième rafraîchissement mourait pour toujours en `400 invalid_request`), un serveur déconnecté qui disparaissait du monde du modèle au lieu d'être nommé avec son remède, un appel d'outil orphelin qui survivait à la réparation sous sa seconde forme sérialisée et bloquait la conversation, un timeout d'outil attribué à notre propre borne alors que l'outil avait échoué de lui-même.

### Added

- **Deux budgets de temps nommés, jamais un seul** (ADR-256) : le raisonnement garde sa borne (`REACT_AGENT_TIMEOUT_SECONDS`), le temps passé _dans_ les outils gagne la sienne (`REACT_TOOL_BUDGET_SECONDS`, 900 s). Les additionner a été mesuré puis rejeté : une seule délégation à sa borne pipeline (300 s) aurait consommé 100 % du budget de raisonnement et coupé des tours qui aboutissent aujourd'hui. Le prédicat d'arrêt reste unique — le routeur l'applique pour décider, la finalisation pour expliquer — et distingue `compute_budget` de `tool_budget`, parce qu'annoncer « le modèle a trop réfléchi » quand c'est un sous-agent qui a travaillé serait un diagnostic inventé.
- **Chaque outil ReAct est borné individuellement** par les mêmes familles de timeout que le pipeline — y compris une famille « appel MCP direct » alignée sur la borne que la couche MCP applique déjà (celle que l'utilisateur règle serveur par serveur, jusqu'à 120 s) : notre borne ne devient jamais la voix la plus stricte de la chaîne. Un `TimeoutError` levé par l'outil lui-même n'est pas annoncé comme notre coupure : l'écoulé décide de l'attribution.
- **Le plafond d'outils devient observable avant de mordre** : distribution du nombre d'outils résolus à chaque tour, compteur des tours plafonnés, et classification des appels vers un outil introuvable (`not_selected` : le plafond l'a écarté ; `unknown` : le modèle l'a inventé) — la fonction est totale, un nom malformé venu du modèle répond `unknown` au lieu de casser le tour. Panneaux Grafana associés.
- **L'affordance de compte, publiée comme une donnée** : un serveur MCP utilisateur dont le credential est celui de l'utilisateur (OAuth, bearer, clé personnelle) l'annonce partout où le modèle lit ses capacités — description de l'outil de délégation, manifeste du planificateur, variable `{auth_context}` du sous-agent, et générateur de description de domaine (qui ne peut plus écrire « publics » pour un serveur authentifié). Un serveur sans authentification ne publie rien : prétendre l'inverse serait une capacité inventée.
- **Les serveurs en attente de reconnexion sont nommés au modèle**, avec le remède : un serveur `auth_required` est filtré de l'enregistrement d'outils, donc sans ce bloc le modèle ne peut pas distinguer « cette capacité n'existe pas » de « cette capacité est à une reconnexion près » — et il affirmait la première au lieu de proposer la seconde.
- **La règle CAPABILITY TRUTH** dans la boucle ReAct : la liste d'outils attachée au tour fait seule autorité ; un refus passé n'est pas une preuve, un outil a pu être réparé, reconnecté ou ajouté depuis.
- **La boucle itérative retente une fois un sous-agent qui conclut sans avoir rien tenté** : le sous-agent n'existe que pour opérer les outils de son serveur, une conclusion à zéro appel d'outil a très probablement spéculé. Une seule retentative — la boucle n'achète pas des itérations avec des refus.
- **Barres de budget dans le panneau de débogage** : raisonnement et outils, deux lignes distinctes avec leurs bornes, rendues par un composant partagé ; un tour persisté avant cette version n'affiche pas une mesure qu'il n'a jamais prise.

### Changed

- **La description d'un outil de délégation parle le domaine de son serveur.** `bind_tools` sérialise l'instance, pas le manifeste : une copie qui ne changeait que le nom laissait le modèle face à « Execute a multi-step task on a user MCP server » pour la banque de l'utilisateur — et il répondait honnêtement « je n'y ai pas accès ». Corrigé sur les deux chemins, serveurs utilisateur et administrateur.
- **L'expansion itérative est additive** : exposer les outils individuels d'un serveur au modèle ReAct n'évince plus l'outil de délégation — seule affordance pour les demandes d'identité ou multi-étapes que les outils individuels ne savent pas exprimer.
- **Le sous-agent MCP restitue ses données** : son enveloppe interne renvoyait « N éléments trouvés » pendant que les lignes partaient au registre pour des cartes que l'utilisateur avait désactivées — le modèle décrivait alors, exactement, une architecture qui ne lui restituait rien. Même contrat que l'enveloppe externe : message, bloc de données borné, contenu tiers marqué non fiable.
- **Le journal du rafraîchissement OAuth porte le code d'erreur RFC** (liste blanche, jamais le corps brut) : son absence a coûté un contresens complet de diagnostic — un 400 causé par notre propre `client_id` manquant lu comme une expiration côté serveur.
- **Le budget d'itérations se gagne par la production** : l'allocation de départ (ADR-238) s'étend tant que la boucle produit des résultats ; un résultat en échec ou vide n'est pas de la production.

### Fixed

- **Le rafraîchissement OAuth recomposait les credentials sans `client_id`/`client_secret`/`issuer`** : chaque premier rafraîchissement réussissait puis amputait le blob, chaque deuxième mourait en `400 invalid_request` — signature mesurée sur deux services réels. L'échange ne possède que les champs de token : le dictionnaire stocké est désormais la base, jamais le résultat.
- **Un serveur marqué `auth_required` court-circuite immédiatement** avec un message actionnable, au lieu de rejouer à chaque appel la danse 401 → rafraîchissement → 400 (six requêtes vers l'endpoint de token dans un seul tour, mesurées).
- **Un appel d'outil orphelin a deux formes sérialisées, et la réparation n'en purgeait qu'une** : sous `responses/v1` et sur Anthropic, l'appel vit aussi en bloc typé dans le contenu du message, sérialisé indépendamment de `tool_calls`. Une conversation réparée en apparence continuait d'empoisonner le fournisseur à chaque tour. Les deux formes sont purgées, chaque réparation est comptée (`langgraph_history_repairs_total`).
- **La conversion Gemini des schémas imbriqués est épinglée par une garde** : l'avertissement « `$defs` is not supported » du connecteur est du bruit — mesuré, chaque champ imbriqué, chaque `required`, chaque `enum` survit au déréférencement — mais si une version future se mettait réellement à amputer les schémas, le test rougit avant que la production ne perde des champs d'extraction en silence.
- **Deux modules homonymes `react_budget`** (l'adaptatif d'ADR-238 et le nouveau) sont fusionnés en un seul, et le fenêtrage d'historique extrait dans son propre module — un fichier logique ne grossit pas, il se scinde.

### Tests

- **La suite atteint 20 313 tests unitaires backend et 6 693 frontend.** Sur ces chemins : signature deux-rafraîchissements de l'OAuth, budgets et routage `tool_budget` (un appel de modèle sépare la charge de la lecture, délibérément), sonde de totalité sur la classification d'outil introuvable (None, vide, entier, objet), parité de contexte partagé sous `asyncio.wait_for` mesurée sur Python 3.14, boot avec tous les feature flags actifs (un manifeste gaté OFF en test validerait un registre incomplet pour toujours), publication de l'affordance de compte sur ses quatre surfaces, hygiène de cache du prompt sous la nouvelle variable, et conversion Gemini des schémas imbriqués.

## [1.38.4] - 2026-09-02

**Un serveur MCP ajouté, une question simple, et l'assistante qui ne sait pas répondre.** « Liste mes comptes bancaires et leur solde », sur un serveur de finances qui expose exactement cet outil. Le routage était pourtant juste : la sélection sémantique élisait le bon serveur avec un score de 1,0. Ce qui manquait, c'était l'outil — **30 des 40 outils du serveur n'ont jamais été construits**, 270 fois en 72 heures, et pour toute trace un `warning` que personne ne lit.

**La cause tient dans une ligne de JSON.** Le serveur déclare ses paramètres optionnels ainsi : `"type": ["boolean", "null"]`. C'est légal depuis draft-04 et c'est la façon dominante d'écrire « optionnel » dans la nature. Une liste n'est pas hachable, et quatre points du code s'en servaient comme clé de dictionnaire. **Corriger le premier n'aurait rien changé** : en mode pipeline le crash se serait déplacé de la construction de l'adaptateur à celle du manifeste, dans le même `try`, une ligne plus bas. Deux lectures d'une même déclaration finissent toujours par diverger.

**En cherchant la conformité, on a trouvé pire que le crash.** La spécification MCP admet _tout_ mot-clé JSON Schema 2020-12 dans la déclaration d'un outil. Or le repli renvoyait « pas de schéma » dès qu'une **seule** propriété utilisait `$ref`, `anyOf` ou `allOf` — et ce repli, mesuré, publie l'outil au modèle sous la forme d'un `kwargs` opaque : ni noms de champs, ni descriptions, ni paramètres obligatoires. L'outil est listé et **inappelable**. Un serveur généré depuis Pydantic ou zod tombait donc entier.

**Et une confirmation manquait là où elle comptait le plus.** En mode itératif, tous les outils d'un serveur partagent un seul réglage de confirmation. Désactiver celle d'un serveur qu'on ne fait que consulter la désactivait aussi pour ses rares outils destructeurs — or aucun de `forget`, `cancel_subscription` ou `disconnect_institution` ne porte l'un des neuf verbes que l'heuristique de nom sait reconnaître. Tous étaient classés en lecture seule.

### Added

- **Une autorité unique sur ce que dit une déclaration** (ADR-255) : `infrastructure/mcp/json_schema.py`, lu par l'adaptateur d'outil **et** par le catalogue du planificateur, avec un test de parité qui compare les deux pour sept formes de déclaration. Toute fonction y est totale — elle ne lève jamais, parce que lever coûte un outil, et qu'un outil perdu est une capacité que l'utilisateur n'a plus sans en être averti.
- **La réduction complète de JSON Schema 2020-12** : déréférencement des `$ref` vers `$defs` et `definitions`, réduction d'`anyOf`/`oneOf`/`allOf`/`const`, inférence de type depuis un `enum`, garde de cycle et profondeur bornée. Un serveur généré montre désormais ses objets imbriqués avec leurs champs obligatoires, ses tableaux avec le type de leurs éléments, ses enums avec leur ensemble fermé.
- **Les contraintes déclarées rejoignent le vocabulaire existant** (doctrine ADR-184) : un `enum`, un minimum, un maximum ou une longueur déclarés par un serveur MCP héritent du rendu au planificateur, de la validation de plan et du clampage numérique que les outils natifs avaient depuis toujours — sans deuxième mécanisme. Coût mesuré : environ 175 caractères de catalogue pour un outil à sept paramètres.
- **`mcp_tool_registration_failures_total`**, avec deux panneaux dans le tableau de bord MCP. Un outil abandonné disparaissait sans compteur : aucun panneau ne pouvait le montrer, aucune alerte ne pouvait sonner. Les labels sont bornés par construction — le nom du serveur et celui de l'outil voyagent dans le journal, qui n'a pas de budget de séries.
- **Le nom lisible des outils**, quand le serveur en publie un : les écrans MCP affichent « Financial accounts » au lieu de `accounts__list_financial_accounts`, l'identifiant technique restant visible à côté puisque c'est lui qu'on retrouve dans les journaux et les règles.
- **Une confirmation forcée sur un outil déclaré destructeur**, même quand le serveur qui l'expose est réglé sans confirmation.

### Changed

- **Les annotations d'un serveur ne peuvent que resserrer une décision, jamais la relâcher.** La spécification est normative : un client **doit** considérer ces annotations comme non fiables. Une mutation déclarée est donc crue — au pire, un serveur menteur s'achète une confirmation de trop. Une prétention de lecture seule ne l'est pas, parce qu'une catégorie déclarée l'emporte sur l'heuristique de nom et retirerait l'outil du filet anti-mutation sur la parole d'un tiers.
- **Le chemin MCP administrateur protège désormais par outil**, à parité avec les chemins par utilisateur : un outil que le code ne sait pas adapter coûte son propre outil, plus l'ensemble des capacités MCP administrateur au démarrage.
- **Les trois événements de journal qui disaient la même chose** — un par chemin d'inscription — sont devenus `mcp_tool_registration_failed`, le chemin étant un champ. Une seule requête retrouve tous les outils abandonnés.
- **Les métriques MCP vivent dans `metrics_mcp.py`**, où sont les autres modules par domaine. Elles étaient logées dans le module des agents, qui atteignait son plafond de taille : la réponse est d'extraire un module cohésif, jamais de relever le plafond.
- **Les deux blocs de liste d'outils dupliqués** dans les réglages sont réunis, et la règle d'affichage — le titre mène, l'identifiant suit — vit dans un composant partagé par l'écran utilisateur et l'écran administrateur. Les deux copies avaient déjà divergé : l'une tronquait la description, l'autre non.

### Removed

- **`RuntimeContext.tool_input_schemas`** : écrit à chaque inscription d'outil, lu nulle part. Le consommateur annoncé par son commentaire, `MCPDirectCallStrategy`, n'a jamais existé.
- **Trois méthodes de service MCP sans aucun appelant** — `list_enabled_active`, `update_discovered_tools`, `update_connection_status` — vérifiées une par une sur l'ensemble du dépôt, code et tests compris.

### Fixed

- **Un type union faisait disparaître l'outil**, silencieusement, sur les quatre points qui le traitaient comme une clé de dictionnaire. La matrice de 43 cas dirigée par la spécification passe de 16 plantages à zéro.
- **Un `enum` a deux lecteurs qui n'attendent pas la même chose**, et les confondre déclenchait un re-planning injustifié. Le validateur de plan teste l'appartenance à l'ensemble : le sien garde donc le membre `null`, puisqu'il décrit ce que le serveur accepte. La déclaration envoyée au modèle le retire, la nullabilité y voyageant dans le type du champ. Défaut trouvé en revue, après que toutes les suites soient passées au vert.
- **Un motif `pattern` venu d'un serveur tiers n'atteint plus le validateur de plan**, qui le compilerait sur un chemin asynchrone : un motif que Python ne sait pas compiler, ou un backtracker catastrophique qu'aucun `except` n'interrompt, y gèlerait la boucle d'événements et tous les flux en cours. Il reste publié aux fournisseurs de modèles, qui se contentent de le lire.
- **La compaction d'un schéma refuse un `enum` ou un `required` qui ne sont pas des listes** : un serveur envoyant autre chose le poussait tel quel dans le prompt du planificateur, comme s'il s'agissait d'un ensemble fermé.
- **Un paramètre requis que le serveur déclare nullable le reste** : refuser une valeur que le serveur accepte rendrait ce client plus strict que le contrat qu'il implémente.
- **Une déclaration de propriété malformée ne coûte plus l'outil entier**, pas plus qu'un nom de champ que Pydantic refuse : la propriété dégrade, ses voisines survivent.

### Tests

- **+286 tests backend et +12 frontend** sur la chaîne MCP : la matrice de 43 formes de déclaration dirigée par la spécification, sept serveurs MCP réels rejoués de bout en bout, les extracteurs de métadonnées confrontés au **vrai modèle du SDK** et non à des doublures, la parité entre les deux consommateurs, et un oracle passant par le vrai validateur de plan pour l'enum nullable.
- **Un garde sur un couplage invisible** : publier une contrainte enveloppe le type dans `Annotated`, ce que la coercition d'arguments du planificateur ne doit pas remarquer. Pydantic dépouille aujourd'hui cette enveloppe ; rien ne le disait, et le jour où cela changerait, un objet JSON écrit dans un paramètre texte cesserait silencieusement d'être réparé.

## [1.38.3] - 2026-09-01

**Le volume n'a jamais été le problème, la concentration l'était.** En une heure de production, avec un à trois utilisateurs actifs, **11 appels d'embedding sur 24 ont échoué** — tous des `429 RESOURCE_EXHAUSTED` sur le quota par minute du fournisseur. Aucun tour de chat impliqué : rien que des tâches de fond. Et un rythme régulier de **quatre appels par minute passait sans une seule erreur**. La cause n'était donc pas la charge, elle était arithmétique : un déclencheur d'intervalle compte depuis le démarrage du planificateur, si bien que des périodes de 5, 15, 30 et 60 minutes s'alignent pour toujours. **Six tâches de fond partaient dans la même seconde, toutes les heures**, chacune faisant tourner un agent, chaque agent vectorisant.

**Ce qui se perdait ne se voyait pas.** Cinq sous-systèmes dégradaient en silence — le RAG, le journal, l'extraction de mémoire, l'indexation du message et le scoring d'outils du routeur. Les deux du milieu sont des pertes définitives : rien ne les rejoue. Les réponses continuaient d'arriver, normales ; l'assistante devenait discrètement moins intelligente.

**Trois mécanismes répondent, avec trois rôles distincts** — et le dire ainsi est le fond de l'affaire. Le **jitter** traite la cause : six tâches ne repartent plus ensemble. Le **lisseur** est l'assurance à l'échelle, pas le correctif de cet incident — six appels ne franchissent aucun plafond par minute, d'où une fenêtre volontairement **courte** (8 appels / 10 s), parce qu'un plafond par minute ne peut pas voir une rafale. Le **réessai** ramasse le résidu. Aucun des trois ne bloque : le lisseur expire ouvert, l'attente est bornée, et notre propre régulation ne doit jamais être la raison pour laquelle une réponse perd sa mémoire.

**Et « Santé de la plateforme » ne pouvait rien en voir**, parce que rien ne mesurait le _résultat_ d'un embedding — seulement ce qui touchait le fournisseur, ce qui devient le mauvais dénominateur dès qu'on réessaie : un échec rattrapé gonfle le taux d'erreur alors que rien n'a été perdu.

**Enfin, le diagnostic a cessé de dire « preuves insuffisantes ».** Le modèle n'était pas évasif, il était exact : on lui remettait un identifiant, un nombre et un détail court. **Un nombre sans son seuil ne peut pas être jugé** — 46 est un incident pour un check et anodin pour un autre, et rien ne disait lequel. Le dossier porte désormais l'unité, le verdict et les deux seuils. Et il est écrit **dans la langue de l'administrateur qui le lit**.

### Added

- **Un jitter sur chaque tâche d'intervalle** (ADR-254) : 15 % de la période, plancher à 5 s, toujours strictement sous la période. **18 tâches sur 19** en portent un ; la dix-neuvième — l'exécuteur d'actions planifiées — en est exemptée par écrit, parce qu'elle est ce qui fait arriver une action à l'heure demandée par l'utilisateur, et qu'on ne dépense pas une promesse visible pour lisser la charge d'un fournisseur.
- **Un lisseur de créneaux distribué** (`slot_waiter`) qui **compose** le `RedisRateLimiter` existant au lieu d'en ajouter un second : une seule fenêtre glissante, un seul script Lua, un seul jeu de métriques Redis. Il rend un verdict **typé** — `acquired`, `disabled`, `expired`, `unavailable` — parce que « lisseur saturé » et « Redis injoignable » appellent des actions opposées et qu'un booléen les confondrait. Mesuré dans le conteneur : 0,8 ms par acquisition, 0,0 ms pour obtenir le limiteur.
- **Un réessai sur les embeddings**, le seul chemin d'appel du dépôt qui n'en avait pas — le LLM, les outils, la compaction et les connecteurs en avaient tous un.
- **`embedding_call_outcomes_total`** : une ligne par opération logique, réessais repliés. C'est la question sur laquelle un exploitant agit — l'appelant a-t-il eu son vecteur ? — et l'alerte `EmbeddingOperationsFailing` la lit, avec son runbook.
- **`embedding_shaper_outcomes_total`** : le signal du jour où trois utilisateurs en deviennent trente. Un `expired` qui monte dit que le budget est devenu trop petit ; un `unavailable` dit que Redis est tombé et que plus rien n'est lissé.
- **Un check `embedding_failure_rate`** dans « Santé de la plateforme », dont le seuil d'avertissement est **plus bas** que celui des complétions : un embedding manqué est invisible pour l'utilisateur, la réponse part sans sa mémoire.
- **Un diagnostic par langue d'administrateur**, généré à l'écriture. Une tique de planificateur n'a pas de lecteur à qui demander sa langue ; l'écrire dans les langues que les administrateurs lisent est le seul moyen d'honorer « la langue de l'admin qui affiche » sans un appel LLM à chaque affichage. Avec un administrateur — le cas normal d'une instance auto-hébergée — cela fait exactement un appel.

### Changed

- **`retry_with_backoff` a désormais un cœur fonctionnel**, `retry_async`, auquel le décorateur délègue : une politique de backoff, un seul endroit. Il prend une **fabrique**, pas un awaitable, et c'est ce qui rend le reste possible — une coroutine ne s'attend qu'une fois, si bien qu'un point de couture tenant `client.aembed_query(...)` ne peut pas le réessayer.
- **Chaque tentative consulte le lisseur**, pas chaque opération : un réessai est un appel de plus sur un fournisseur qui vient d'en refuser un.
- **Le dossier de preuves d'un incident** porte l'unité, le verdict et les deux seuils franchis. Tout est déjà en main quand un check finit : l'enrichissement ne coûte aucune requête et ne peut pas échouer. Ce qu'il ne va délibérément **pas** chercher, c'est un extrait de journaux — c'est le travail de l'agent de diagnostic, à la demande, et une tique ne doit pas se mettre à dépendre de Loki.
- **Les trois requêtes de taux d'échec** passent par une construction unique au lieu d'être réécrites trois fois.
- **Le classificateur d'erreurs d'embedding est partagé** entre le réindexeur RAG et le client : deux classificateurs sur un même fournisseur, c'en est un qui dérive, et la dérive est silencieuse.

### Removed

- **`geo_lat` / `geo_lon` du contexte de chaque requête** : 1 099 lignes en une heure, dont 1 054 en INFO, ce que ce dépôt interdit pour une donnée de localisation. Nuance mesurée avant de conclure : deux couples distincts pour deux villes, donc de la géo-IP au niveau ville et non un relevé d'appareil. Et **zéro consommateur** — le compteur par pays, les deux panneaux du tableau géographique et jusqu'à la carte du monde lisent le pays et la ville.

### Fixed

- **Une cause non chaînée rendait aveugle le réessai appelant.** `MaxRetriesExceededError` gardait la dernière erreur en attribut seulement, et la levée sortait du `except` : la chaîne `__cause__` s'arrêtait là. L'indexeur système, qui a son propre réessai et classe en remontant cette chaîne pour lire le code de statut, redevenait donc **aveugle au 429** qu'il avait justement appris à rattraper — il ne s'en sortait plus que par chance textuelle.
- **`"500"` était une sous-chaîne** : un échec **permanent** disant « dépasse 1500 jetons » était classé transitoire et réessayé jusqu'à épuisement du budget — un échec dur transformé en échec lent. Les codes sont désormais bornés sur des frontières de mot et **dérivés** de la constante, où ils avaient déjà divergé : 408 y figurait, absent du repli textuel.
- **Le dénominateur des taux n'avait pas son `or vector(0)`.** Le numérateur l'avait depuis l'incident du 28 août ; le dénominateur portait le même trou, et il s'ouvre exactement là où vit une instance auto-hébergée au repos : rien n'a encore été vectorisé, donc aucune série, donc `unknown`, donc **une plateforme saine affichée dégradée**.
- **Le plafond de coût quotidien du diagnostic** ne fermait qu'une fois par incident, alors qu'un incident coûte désormais un appel par langue. Il ferme maintenant **avant chaque appel**, ce que le module disait déjà faire.
- **Le lisseur pouvait devenir sa propre charge** : un intervalle de sondage nul faisait tourner la boucle à vide contre Redis. Plancher posé.
- **Les locales brutes n'étaient pas normalisées** : deux administrateurs écrivant `fr` et `fr-FR` auraient payé deux fois la même génération, et un lecteur `zh` n'aurait jamais trouvé un diagnostic écrit en `zh-CN`.
- **Un agent au domaine non déclaré était invisible à sa garde.** `test_agent_names_follow_convention` parcourt le registre vers l'extérieur : par construction, il ne peut pas voir un agent dont le domaine n'y figure pas. La garde part désormais des agents.
- **Le compteur public de tests annonçait 28 000 à tort.** La version précédente l'a relevé sans documenter de re-mesure, sur un chiffre que la commande déclarée ne produit pas. Deux méthodes pour un nombre public, c'est un nombre que personne ne peut vérifier : la commande déclarée l'emporte et la valeur revient à 27 000. Un compteur montré à un visiteur est exact, ou il n'existe pas — et il a le droit de baisser quand le précédent était faux.

### Tests

- **Le lisseur contre le vrai Redis du conteneur**, pas un double : 8 créneaux accordés, les deux suivants retenus puis laissés passer, et le chemin « désactivé » qui ne touche pas Redis du tout.
- **Une garde de jitter** qui refuse toute tâche d'intervalle sans jitter ni exemption écrite, et qui vérifie qu'une exemption déclarée est réellement exercée — une exemption non exercée est un commentaire déguisé en règle.
- **La composition des deux couches de réessai** : une erreur fournisseur, le marqueur du client, l'enveloppe d'épuisement — et le code de statut encore lisible au bout.
- **Le faux positif de sous-chaîne**, prouvé par les trois formulations qui le déclenchaient.
- **Les deux côtés de la normalisation de langue**, y compris les deux codes canoniques du chinois qui diffèrent selon la couche.
- Plancher de couverture backend relevé de **67 % à 68 %** sur une mesure de 70,43 %, en gardant la marge de 2 points que la doctrine exige.

### Documentation

- **ADR-254** — la décision, ses mesures, et ce que la relecture a corrigé après coup.
- Un **runbook** pour la nouvelle alerte, qui commence par faire lire au lecteur le compteur du lisseur : il dit lequel des deux leviers actionner, et lequel ne servirait à rien.

## [1.38.2] - 2026-09-01

**Le visage souriait à tout, et la mesure dit pourquoi.** Après chaque réponse — une erreur, une explication technique, une liste de tâches — l'avatar affichait la même expression réjouie. Quatorze tours de production consécutifs, lus en base : l'émotion dominante de la psyché était `enthusiasm` sur **treize d'entre eux**, dans un mouchoir de **0,02**. Ce n'est pas un défaut de la psyché, c'est sa nature : **une psyché est un trait**, elle bouge lentement et c'est voulu. Le défaut était de lui demander de répondre d'un événement ponctuel, car un `argmax` sur un vecteur quasi constant est une constante.

**Le repli censé couvrir ce cas n'avait rien à dire non plus** : sur ces mêmes quatorze réponses, **neuf** ne contenaient ni « ! », ni emoji, ni bloc de code. Et le multiplicateur d'emphase qui en découlait mesurait de **0,94 à 1,21** — ±13 % sur deux groupes de canaux, sous une expression qui ne changeait jamais. Invisible par construction.

**Le modèle qui écrit la réponse déclare désormais lui-même son registre**, dans un vocabulaire qui appartient à l'animation et à rien d'autre : douze registres, douze visages réellement distincts. Une réponse technique ne sourit plus. Le marqueur voyage **en bande**, sur la même génération — aucun appel LLM supplémentaire — et il est filtré du flux avant qu'un seul caractère n'atteigne l'écran. Le motif n'est pas inventé : c'est exactement celui de l'auto-évaluation de la psyché, en production depuis des mois.

**La psyché garde ce qu'elle fait bien** : la famille d'humeur au repos — respiration, cadence de clignement, poids des gestes d'inactivité. Un trait colore un comportement de repos, jamais une réaction.

**Et la bouche cesse d'être un demi-cercle.** Sous deux yeux pleins et lumineux, un filet est un dessin au trait déguisé en écran de robot : la bouche devient une **forme pleine** dont la silhouette se déforme. Trois écarts au compas, mesurés dans un navigateur sur un vrai sourire — le dessus n'est jamais plat, les deux coins bas sont **différents** et penchent avec la bouche, et la forme s'élargit en se courbant.

### Added

- **Une annotation d'expressivité par tour** (ADR-253) : `<lia_tone register= intensity= accent=/>`, douze registres et six accents, déclarés par le modèle de réponse et livrés sur l'événement SSE `done`. Coupable par `EXPRESSIVITY_ENABLED` — coupée, le marqueur n'est jamais demandé, jamais analysé, et le prompt ne coûte rien.
- **Douze visages distincts** au lieu d'un seul : `factual` rend un visage neutre, `assured` un visage concentré, `apologetic` un visage désolé. Deux registres seulement sourient.
- **Un repli qui ne renvoie jamais rien.** Il lit la FORME de la réponse — longueur, blocs de code, densité de ponctuation, emoji — jamais les mots, si bien que les six locales se comportent à l'identique. Il parle **le même vocabulaire** que le marqueur déclaré : une seule table de registres, une seule courbe d'amplitude.
- **Un accent ponctuel** sur le registre : un clin d'œil, un hochement, une inclinaison, un soupir, une étincelle. Chacun tire sur un geste **déjà écrit et déjà testé** — l'accent nomme ce que le battement veut dire, le rig sait déjà le jouer.
- **Un décalage de départ par CANAL** (`CHANNEL_LEAD_MS`) : les coins de la bouche partent avant sa courbe, parce qu'un vrai sourire commence aux coins. Le décalage par groupe ne pouvait pas l'exprimer — les trois canaux vivent dans le même groupe.

### Changed

- **La bouche est une forme pleine, pas un trait.** Un seul élément porte tout le vocabulaire, là où trois se tenaient en phase à la main : la hauteur croît avec la courbe et l'ouverture, le bord supérieur s'aplatit quand la courbe se creuse, et un retournement suffit pour une moue. `mouthArc` est publié **sans unité**, parce que la feuille de style en a besoin comme hauteur _et_ comme ratio de rayon, et que CSS ne divise pas une longueur par une longueur.
- **L'amplitude jouée va de 0,82 à 1,70**, contre 0,94 à 1,21 auparavant — et le signal qui la pilote varie enfin. Le **registre plafonne** ce que l'intensité peut acheter : une réponse `factual` déclarée au maximum reste un visage neutre livré avec conviction.
- La règle de placement « avant le rappel final » est **factorisée** dans le chargeur de prompts. Elle était écrite deux fois, à l'identique, et une troisième l'aurait été.
- Le balayage des marqueurs en bande du flux SSE est **une seule fonction** pour les deux marqueurs, au lieu de deux gardes et deux sorties anticipées copiées l'une sur l'autre.

### Removed

- **La voie parallèle de réaction** : `deriveReaction`, `contentHeuristicExpression`, `responseEmphasis` et la table émotion→expression. Elles avaient leur propre idée du visage à afficher ; il n'y en a plus qu'une. Le type `ReactionSource` n'a plus de porte pour la psyché, ce qui en fait une garantie de compilation plutôt qu'une convention.

### Fixed

- **Une moue poussait vers le haut, dans le visage.** Retourner la forme autour de son bord haut envoie le dessin au-dessus de la ligne : mesuré au navigateur, toute bouche retournée mordait sur les yeux de **3,2 à 7,7 px** aux trois tailles, quand les autres dégageaient 5,5 à 13,8. Après correctif : **4,3 à 13,8 px**, positif partout.
- **Une étincelle restait collée au visage.** L'accessoire posé par un accent ne programmait pas son effacement, et l'atterrissage de l'expression suivante l'écrasait quelques millisecondes plus tard. Deux propriétaires pour un même état : il n'y en a plus qu'un, et une seule décision.
- **Un accent identique deux réponses de suite ne jouait qu'une fois.** Le front était calé sur la _valeur_ de l'accent, qui ne changeait pas ; il l'est désormais sur la réaction elle-même.
- **Un marqueur cité dans une réponse décidait du visage.** LIA se documente elle-même et peut citer le marqueur ; la **dernière** occurrence fait foi, puisque l'instruction dit qu'il vient après la réponse. Toutes restent retirées du texte : montrer du balisage à un lecteur est la pire des deux pannes.
- **Un conteneur refusait son point d'entrée en production** : le script d'Alertmanager est monté depuis l'hôte, qui ne porte pas le bit d'exécution. La commande passe désormais par l'interpréteur, et une garde d'hygiène refuse tout nouveau montage qui reposerait sur ce bit.

### Tests

- **47 tests backend** sur l'annotation : chaque étape partielle du marqueur, un registre inventé, une intensité hors bornes, un marqueur tronqué, la dernière occurrence contre une citée, l'expiration du registre par tour.
- **15 tests sur le balayage du flux** — un chemin qui n'en avait **aucun** avant cette version : chaque préfixe partiel des deux marqueurs, les deux dans le même jeton, et la prose laissée intacte.
- **Une garde de parité entre les deux moitiés du contrat** : le prompt propose exactement ce que le code accepte, et la copie TypeScript du vocabulaire suit la copie Python. Un registre ajouté d'un seul côté serait un visage qui n'arrive jamais, sans symptôme.
- 6 662 tests frontend verts ; couverture 77,37 / 72,53 / 74,34 / 78,00. Backend 21 584 collectés : **28 246 au total**, arrondi à la baisse à 28 000 sur la landing par contrat.
- Ratchets tenus sans qu'aucun plafond soit relevé : la complexité et la taille ont été rendues par **extraction**, et `response_node.py` finit plus petit qu'avant le chantier.

### Documentation

- **ADR-253** — la décision, avec les deux mesures qui la fondent et celle qui a corrigé sa première version : le marqueur n'arrive qu'**un tour sur huit**, exactement comme celui de la psyché, sur les mêmes tours. Un visage qui ne réagit qu'un tour sur huit étant un visage cassé, le repli a cessé de pouvoir ne rien renvoyer.
- **ADR-252** réaligné sur le dessin livré : la section qui décrivait des lèvres, une ouverture cerclée et une langue décrivait un code qui n'existe plus.

## [1.38.1] - 2026-08-30

**Cinquante-trois réglages, trente-sept dessins.** La page des réglages rendait chaque section avec la même icône bleue sur la même pastille bleue, et seize d'entre elles empruntaient en plus le dessin d'une autre — `Plug` servait quatre fois. Le regard n'avait donc qu'une seule forme répétée pour s'orienter dans une liste de cinquante-trois entrées.

**La couleur ne répare pas une forme répétée** : deux prises restent deux prises, même en deux couleurs. Cette version fait les deux choses séparément — un dessin propre par section, et une teinte par **groupe**, jamais par item : douze couleurs sont une carte que l'œil apprend, cinquante-trois seraient du bruit.

**C'est une dérogation assumée, la deuxième du produit** après le badge cyan des skills. Partout ailleurs la chrome suit l'accent choisi par l'utilisateur ; ici non, et c'est écrit dans le design system avec ses mesures. La couleur n'y est jamais un **état** : la ligne ouverte du rail garde l'accent, et le témoin de capacité reste une pastille pleine ou creuse — qui ne voit pas ces teintes ne perd rien.

### Added

- **Douze teintes de groupe** sur les icônes des réglages, en tokens `--color-settings-*` — cartes de la vue d'ensemble et lignes du rail. Des tokens et non des classes utilitaires, précisément pour que la garde de contraste les couvre : une palette fixe écrite en classes serait restée hors de sa portée.
- **Un glyphe propre pour quinze sections** qui partageaient celui d'une autre. Une seule exception subsiste, écrite dans le registre : les deux exports de consommation partagent un composant qui se branche sur son mode, et leur donner deux dessins imposerait une forme que la garde « exactement une icône par fichier » ne sait pas lire. Ils vivent dans des onglets différents.
- **`toneForSection`**, règle unique partagée par les deux listes — la carte et la ligne du rail ne peuvent plus diverger sur une section — avec repli sur l'accent pour un appelant hors table.

### Changed

- La garde de contraste couvre les **quinze palettes** (cinq accents × clair / sombre / OLED) sur **deux fonds** chacune : la pastille, et le rail nu où le glyphe n'en a pas. Pire cas mesuré **3,64** sur la pastille et **3,45** au survol, pour un plancher de 3,0 — le glyphe est un objet graphique non textuel (WCAG 1.4.11).
- La garde de distinction vérifie désormais **les deux modes**. Ce n'est pas de la symétrie : les deux clartés découpent des tranches différentes du gamut, et un jeu optimisé sur le seul thème clair laissait deux teintes à 0,113 en sombre — sous son propre plancher.
- **L'en-tête de la section ouverte garde l'accent**, délibérément : la règle propriétaire du 2026-08-05 veut qu'une icône de titre soit en couleur du thème. La conséquence est connue et acceptée — le glyphe change de couleur entre la liste et le volet, qui ne sont jamais affichés ensemble.

### Fixed

- **Six des vingt-quatre teintes sortaient du gamut sRGB** et étaient écrêtées en silence par le navigateur : ni la teinte ni le chroma écrits n'étaient rendus, et la promesse « aucun groupe ne paraît plus pâle qu'un autre » ne tenait pas pour celles-là. Cause mesurée : un chroma unique pour douze teintes, alors que le gamut n'est pas un cylindre — à clarté 55 %, un violet porte 0,25 là où un sarcelle plafonne à 0,09. Chaque teinte porte maintenant son propre maximum, moins 6 % de marge.
- **Deux couples de teintes étaient indiscernables** (0,116 d'écart pour un plancher de 0,12) : l'espacement régulier de 30° suppose une roue perceptuellement uniforme, ce qu'elle cesse d'être dès que le chroma suit le gamut. Les douze angles sont désormais **cherchés** sur le pire des deux modes — la paire la plus proche passe de 0,116 à **0,199**, et le contraste s'améliore au passage.
- **Deux glyphes empruntaient un sens déjà dépensé** : `ExternalLink` est l'affordance « ceci ouvre ailleurs » dans sept fichiers, et `Wrench` désigne un outil de l'agent dans le panneau HITL. Remplacés par `Signpost` et `Microscope`. `SquareTerminal` a été écarté pour une raison qu'aucune recherche textuelle ne montre : lucide l'a renommé depuis `TerminalSquare`, déjà utilisé — c'eût été un doublon **visuel**.

### Tests

- **Cinq tests pinnent la teinte là où elle est rendue**, et pas seulement là où elle est déclarée : la garde de contraste mesure la table de couleurs, ce qui resterait vrai si aucun composant ne l'appliquait jamais. Vérifiés en réinjectant le défaut — quatre rougissent si l'on annule le rendu, le cinquième si l'on teinte la ligne courante du rail.
- Les attentes sont **dérivées des tables** plutôt qu'écrites en dur : une section changeant de groupe garde le test vrai au lieu de le faire échouer pour la mauvaise raison.
- 6 409 tests frontend verts ; couverture 76,82 / 72,09 / 73,91 / 77,46 — `floor(mesuré − 2)` ne franchit aucun palier, les seuils restent 74/70/71/75. Backend 20 816 collectés : 27 225 au total, arrondi À LA BAISSE à 27 000 sur la landing par contrat.

### Documentation

- **ADR-251** — la décision et ce qu'elle a coûté : deux défauts distincts (la forme répétée, puis la couleur unique) corrigés séparément, une teinte par groupe et jamais par item, des tokens plutôt que des classes pour que la garde de contraste couvre la palette, et cinq alternatives écartées avec leur raison. Les deux intuitions démenties par la mesure y sont consignées comme telles.
- **Guide technique, section 35** dans les six langues — « Mesurer une couleur avant de la livrer ». Ce n'est pas un journal de version : la page explique une méthode, à savoir qu'un gamut n'est pas un cylindre et qu'un espacement régulier n'est pas un espacement perçu.
- **`docs/a11y/CONTRAST_TOKENS.md`** décrit désormais les **deux** palettes fixes du produit — le badge cyan des skills et les teintes de réglages — avec leurs mesures et la raison pour laquelle elles sont des tokens. La note de design system vivait dans `.claude/`, qui n'est pas livré : un lecteur du dépôt ne l'aurait jamais vue.
- **FAQ, « Comment retrouver un réglage rapidement ? »** dans les six langues : chercher n'est plus la seule réponse, puisqu'une section déjà visitée se retrouve à l'allure. La réponse dit aussi ce que la couleur ne fait pas.
- **Une carte de plus sur la page « Encore + »** (`settings_tones`, section « Quand tu cherches »), avec sa scène animée — qui **lit** la table des teintes au lieu de la recopier, et montre le vrai coupable : la prise qui servait quatre fois.
- **`docs/knowledge/03_settings.md`** réaligné sur l'interface réelle : la section décrivait encore « une trentaine de sections repliées réparties en onglets », état antérieur à ADR-227, et excluait de la recherche un onglet Administration qu'elle couvre désormais.

## [1.38.0] - 2026-08-29

**Trois plans faisaient encore autorité là où un seul devait suffire — et le quatrième mentait sur ce qu'il savait.** Cette version solde quatre chantiers qui partagent une même règle : une valeur a un endroit où on la lit, un nombre affiché est un nombre mesuré, et un verdict qu'on ne peut pas constater ne s'annonce pas.

**Le contexte d'exécution n'a plus qu'un seul plan** (ADR-231, dernière étape). Depuis v1.30.12, le contexte typé et l'ancien sac `configurable` coexistaient : la fondation était posée, les 43 fichiers qui lisaient le sac ne l'étaient pas. Ils lisent désormais le contexte typé, et le point de construction unique n'écrit plus dans le sac que `thread_id` — la plomberie LangGraph. Vider le **lecteur** sans vider l'**écrivain** aurait laissé les deux plans faisant autorité, et le plan non typé gagne toujours parce qu'il est le plus facile à atteindre.

**Le compteur mentait, et c'est la leçon la plus chère du lot.** Le scanner ne reconnaissait que les clés littérales : `configurable.get(FIELD_USER_ID)` n'était comptée nulle part. Il annonçait « 0 lecteur » alors que **huit fichiers** lisaient encore, dont un dans `infrastructure/`, hors du périmètre auquel personne ne pensait.

**Une métrique que personne ne peut voir est une métrique sur laquelle personne n'agit.** ADR-148 est le prix de l'avoir ignoré : une source de heartbeat tombant en silence a supprimé les signaux de santé sur **46,5 % des ticks pendant une semaine**, sans rien pour s'en apercevoir. Un ratchet mesure désormais la distance entre les métriques définies et les métriques atteignables : **490 définies, 433 câblées (88,4 %)**, les 57 restantes explicitement listées et cette liste ne peut que raccourcir.

**Et la psyché de LIA cesse d'être bloquée d'un côté du cadre.** Deux réglages livrés inertes en v1.25.14 attendaient une mesure de production pour être activés. Elle a été faite : **769 instantanés, 3 utilisateurs, 90 jours**. Le diagnostic tenait, et plus fort que la simulation ne le prévoyait.

### Added

- **Ratchet de couverture des métriques** (`task ratchet:metrics`) : toute métrique Prometheus définie dans le code doit être référencée par un panel Grafana, une règle d'enregistrement ou une alerte. Shrink-only, même doctrine que les ratchets de taille de fichier et de complexité : une métrique nouvellement aveugle fait rougir la CI, et une métrique devenue visible **doit** quitter la liste — sinon la prochaine aveugle prend sa place en silence.
- **Deux gardes shrink-only pour le contexte typé** : l'une refuse tout nouveau lecteur du sac `configurable`, l'autre épingle l'écriture au point de construction unique. Le scanner **découvre** maintenant les alias — toute constante de module valant une clé de contexte — au lieu d'en tenir la liste, et un test épingle cette résolution sur un fichier synthétique pour qu'elle survive à l'absence de vrai lecteur à attraper.
- **Une seule façon d'installer un contexte hors d'un run** (`tests/helpers/runtime_context.py`) : six fichiers de tests bricolaient chacun leur `ToolRuntime` avec `context=None`, donc n'exerçaient pas le vrai contrat. La connaissance des internes LangGraph vit désormais dans un seul endroit bruyamment nommé, épinglé par son propre test.
- **Deux panels Grafana** qui rendent visibles deux métriques qui ne l'étaient pas : les écritures de cache LLM ignorées, et la santé des sources de contexte du heartbeat — celle-là même dont l'absence a coûté ADR-148.
- **ADR-250** : ce qu'un code de sortie `ssh` dit, et surtout ce qu'il ne dit pas.

### Changed

- **La psyché est recentrée, sur mesure** (ADR-142, activation) : `PSYCHE_DOMINANCE_CENTER` passe de `0.0` à **`0.20`** et `PSYCHE_PROACTIVE_JOY_PULSE` de `true` à **`false`**, en défauts de code et sur toutes les surfaces `.env`. Mesuré en production : la part de dominance négative valait **0,0 %** sur 769 instantanés — aucune des 14 personnalités du catalogue ne se reposait sous zéro, ce qui rendait cinq humeurs inatteignables au repos ; et l'impulsion de joie couronnait la joie émotion dominante sur **31 % des tours** (45,5 % sur 30 jours, jusqu'à 100 % pour un utilisateur léger), quelle que soit l'évaluation réellement rapportée. Effet immédiat sur le catalogue vivant : **0/14 → 7/14** personnalités au repos sous zéro, écart de dominance ramené de [+0,063 ; +0,494] à [−0,137 ; +0,294], et `rasta` atteint `content`, une humeur jusque-là hors d'atteinte. `antagonist` reste assertif ; `cynic` glisse de `determined` à `neutral` — le compromis de fidélité au personnage que l'ADR avait annoncé. Remettre `0.0` / `true` restaure le comportement antérieur.
- **Le déploiement de production tourne détaché, et son verdict est lu** (ADR-250). Il tenait dans une session SSH bloquante, si bien que la survie de onze minutes de travail dépendait de la survie d'une connexion — et elle n'y survivait pas : tuer le client fait mourir le script distant par **SIGPIPE en ~6 secondes**, pas au bout des 6 min 15 de keepalive. Le pilote ne déduit donc plus rien d'un code de transport : il scrute un fichier que le distant a écrit. Un sondage qui échoue est réessayé, jamais converti en verdict.
- **`task deploy:prod` cesse de mentir.** Le skill `lia-deploy-prod` demandait par écrit d'ignorer une erreur de fin de déploiement — une consigne demandant à un humain d'ignorer une erreur n'est pas un contournement, c'est le défaut déplacé dans la prose. `ssh` propage fidèlement tout code distant **sauf 255**, qu'il emploie aussi pour ses propres échecs de transport. Six issues sont désormais distinguées parce que six conduites le sont : seul un code **écrit par le serveur** autorise à parler d'échec ; « déjà en cours », « interrompu » et « budget épuisé » n'en sont pas, et chacune imprime les commandes qui tranchent plus la consigne de **ne pas relancer** — l'étape 7 effacerait le staging sous un build en vol.
- L'attribution Langfuse d'un appel LLM de nœud lisait l'utilisateur dans le sac. `infrastructure/` ne pouvant pas importer `domains/`, elle lit maintenant l'identité sur son **propre** plan, que `create_instrumented_config` écrit elle-même : la couche d'observabilité ne dépend plus du contexte du graphe.
- Le sous-agent ReAct hérite du contexte parent **entier** au lieu d'une projection à 7 clés ; son `configurable` ne prétend plus rien.
- La découverte des suites Pester du déploiement se fait par **répertoire** et non par fichier nommé : un nouveau `*.Tests.ps1` n'était jamais exécuté, donc il suffisait d'en ajouter un pour croire la surface couverte alors que rien ne tournait.
- `GUIDE_DEPLOYMENT.md` documente la rétention réelle de l'observabilité (Loki 7 jours, Prometheus 15 jours ou 2 Go) et le piège associé : **un zéro hors rétention n'est pas « aucun événement »**. Vécu le 2026-08-29 — une requête sur une fenêtre vieille de cinq semaines a renvoyé 0 partout, y compris sur une période où 40 timeouts avaient été mesurés, d'où une conclusion erronée « Loki est en panne ». Toujours inclure une période de contrôle dont on sait qu'elle contient des événements.

### Fixed

- **Le secret de production déchiffré ne survit plus à l'exécution** (SEC-040). `PROD/.env` est la production **en clair** ; l'étape finale le supprime, mais elle ne s'exécutait que sur le chemin nominal alors que le pilote a 14 sorties prématurées. Or, tant que le déploiement se terminait sur un faux échec, **le chemin d'échec était le chemin nominal** : la fuite était systématique. Mesure du 2026-07-28 — **434 Mo de bundle** survivant à un déploiement qui avait pourtant abouti. Un `finally` de premier niveau couvre désormais toutes les sorties, avec une liste **exacte** et jamais un glob : `provenance.env` vit au même endroit, n'est pas un secret, et quatre tests le lisent. `-DryRun` en est exempt par contrat.
- **Un verdict distant valait toujours 0.** En guillemets doubles, le shell _externe_ expansait `$?` avant de passer la commande au shell interne, qui recevait déjà la réponse. Mesuré à l'exécution réelle : script sorti en 23, verdict portant 0. Aucune vérification de forme ne l'aurait vu — il a fallu exécuter.
- **Un second lancement concurrent détruisait le journal du déploiement en vol** (3 lignes → 0, le premier processus continuant d'écrire dans un inode délié). Les artefacts sont désormais nommés d'après l'exécution : il n'y a plus de fichier partagé à purger, donc plus rien à détruire.
- **`GetNewClosure()` gelait le code de sortie.** PowerShell recopie dans la portée d'une closure toute variable visible à sa création, **`$LASTEXITCODE` compris** : la lecture nue rend la valeur figée, pas celle que `ssh` vient de poser. Mesuré : `0` en lecture nue, `255` en lecture globale, pour le même appel. Le harnais le montrait en silence — un lancement dont la connexion tombait était rapporté **réussi**, soit exactement le verdict lu au mauvais endroit que ce lot supprime.
- La garde dorée de la psyché figeait le catalogue **semé**, pas le catalogue vivant : `antagonist` se repose à +0,494 en production contre +0,243 dans la migration de semis. La garde restait verte pendant que le catalogue dérivait ; le fait est désormais consigné, et la propriété d'encadrement n'est garantie que pour le catalogue semé.

### Tests

- **213 tests verts** sur le contexte typé, le ratchet de métriques et l'atteignabilité des humeurs : 4 preuves comportementales que les lecteurs migrés prennent bien la **valeur** du contexte (une garde de ratchet prouve qu'un fichier ne lit plus le sac, pas que son remplacement lit juste), 6 tests de ratchet dont celui qui refuse une clé cachée derrière une constante, 12 tests épinglant l'aide d'installation de contexte, et 14 tests pour le ratchet de métriques.
- **137 tests Pester** sur le chemin de déploiement, dont 43 pour les deux nouvelles bibliothèques. La suite hermétique parle maintenant le protocole détaché : la commande voyageant encodée, les assertions **décodent la charge** au lieu de reconnaître une ligne qui ne la porte plus — reconnaître le marqueur seul aurait prouvé que le pilote a appelé _quelque chose_.
- Trois nouveaux tests de psyché épinglent les défauts livrés à leurs valeurs activées et vérifient l'encadrement du catalogue sur le défaut lui-même, la caractérisation dorée continuant de figer la projection brute pour que la translation ne l'altère pas.

## [1.37.0] - 2026-08-29

**Le bac à sable n'avait jamais eu accès à ses propres bibliothèques.** `useradd -m` crée le répertoire personnel en `0700` : tout y était lisible, mais le compte non privilégié du bac à sable ne pouvait pas le **traverser**. Conséquence restée invisible depuis SEC-001 — le skill enrichi `qr-code` livré avec LIA ne pouvait pas charger `segno`, et les scripts éphémères d'ADR-249 ne voyaient que la bibliothèque standard alors que leur manifeste annonçait numpy et pandas. Trouvé en exécutant un **vrai** script sur le serveur de production, pas par un test : les tests unitaires simulent le démon, donc l'argv paraissait correct et les permissions n'étaient jamais exercées.

**Et un défaut de propagation que seule une relecture à froid pouvait voir.** Le budget de scripts et les données du tour voyageaient dans des `ContextVar`. Mesuré : un `.set()` effectué dans une tâche asyncio est **invisible** dans une tâche sœur — et un exécuteur de graphe est libre d'invoquer chaque nœud dans sa propre tâche. En production, le budget se serait réinitialisé à chaque itération et le script aurait toujours reçu une charge vide, pendant que tous les tests unitaires restaient verts, puisqu'ils s'exécutent dans une seule tâche.

### Fixed

- **Le compte du bac à sable peut enfin lire les paquets installés.** Le répertoire personnel devient traversable (`o+rx` uniquement, aucune écriture) : les paquets sont ceux de l'application, et le bac à sable n'a ni réseau, ni identifiants, ni système de fichiers inscriptible. Une garde lit désormais le Dockerfile — le seul endroit où la réponse existe.
- **L'état du graphe redevient la source de vérité** pour le budget de scripts et les données transmises ; la `ContextVar` n'est plus qu'un porteur d'invocation, chargé depuis l'état au début de chaque exécution de nœud et reversé à la fin. Trois tests exécutent désormais l'outil dans une **tâche séparée**, ce qu'aucun test précédent ne faisait.
- Un commentaire ne peut pas vivre à l'intérieur d'une continuation de ligne d'un `Dockerfile` : Docker lit le `&&` suivant comme une nouvelle instruction et refuse de construire l'image. Attrapé par la CI, que `ci:fast` ne peut pas anticiper puisqu'il ne construit aucune image.

### Changed

- **La FAQ « Comment fonctionne LIA » a été synthétisée** (demande du propriétaire) : 68 cartes, six langues, de 50 380 à 31 025 caractères en anglais, médiane 710 → 458, plus longue 1 533 → 640. Chaque carte garde son essentiel et son point le plus intéressant ; le détail vit dans les réponses de la FAQ, dans les guides et dans `docs/`. La dérive était silencieuse par nature — une phrase ajoutée par livraison, chacune justifiée — et `security` avait atteint 1 533 caractères une proposition à la fois. Un ratchet shrink-only la borne désormais, par locale et sur l'agrégat.
- **Deux compteurs publics disaient faux depuis quatre livraisons.** Les cinq guides `how` non chinois annonçaient « 245 ADRs » contre 248 réels, et les six situaient le changelog « v1.0 à v1.33.0 » alors que leurs propres sections décrivaient v1.37.0. La garde ne couvrait que la ligne de tableau : **un compteur en PROSE échappe à une garde de TABLEAU**. Les deux surfaces sont maintenant déclarées dans `version_surfaces.py` — 21 faits réparés mécaniquement, et une sixième occurrence échouera bruyamment au lieu de rejoindre le lot en silence.
- Le compteur d'outils de la page d'accueil passe de 102 à **107**, re-mesuré sur l'instance de production (`len(registry._tool_manifests)`). Quatre des cinq écarts précèdent cette version : la vignette n'avait pas été re-mesurée quand les outils de diagnostic sont arrivés. Le nombre d'agents, lui, ne bouge pas — l'agent du bac à sable est un **manifeste**, pas un constructeur.

### Tests

- 23 tests pour le lot : refus hors ReAct, drapeau, budget par tour **et sa survie d'une tâche à l'autre**, transmission des données depuis l'état, sortie marquée non fiable, trace d'erreur rendue au modèle, refus du mode bac à sable hérité, bornes de source et d'entrée, filtre de mode appliqué par ses trois lecteurs, rendu admin des scripts, et la traversabilité du répertoire de paquets.

## [1.36.0] - 2026-08-29

**L'assistante peut désormais écrire un script et l'exécuter pour répondre.** Un modèle répond de façon _plausible_ à l'arithmétique sur beaucoup de lignes, aux jointures par clé, aux durées entre fuseaux, à la déduplication — et rien, dans la réponse, ne permet de voir que c'est faux. En mode ReAct, quand une étape demande ce genre de travail, LIA écrit maintenant quelques lignes de Python et les exécute dans un bac à sable isolé, puis répond avec un résultat vérifiable au lieu d'un calcul de tête (ADR-249).

**Rien de tout cela n'a exigé un nouveau bac à sable.** Celui des skills existait déjà, durci (SEC-001) : un conteneur jetable par exécution, sans socket Docker, sans réseau, système de fichiers en lecture seule, uid non privilégié, toutes capacités abandonnées, mémoire, CPU et durée bornés. Mesuré sur le Raspberry Pi de production **avant** toute décision : 279 ms de démarrage à froid, 459 ms avec numpy — moins de 2 % du budget de 30 s. La seule vraie question était donc : le **modèle** peut-il écrire ce qui y tourne, et sous quelles règles.

### Added

- **`run_python_tool`** (ReAct uniquement) : l'agent écrit un script court et reçoit sa sortie. C'est un **complément, jamais une obligation** — le prompt lui dit ce qu'il fait mal et l'invite à calculer là, et lui dit tout aussi explicitement de ne pas s'en servir pour une recherche simple, un calcul à deux nombres ou ce qu'il sait répondre directement.
- **Les données du tour arrivent sur stdin**, en JSON : ce que les outils ont déjà collecté est référencé par le script au lieu d'être recopié dans sa source — recopier paierait les tokens deux fois et tronquerait précisément les gros cas qui justifient la fonctionnalité.
- **Les scripts sont visibles des administrateurs**, dans le panneau de debug : code, intention déclarée, verdict et tête de sortie. Nulle part ailleurs — les cacher n'achèterait aucune sécurité (le modèle les a écrits) et coûterait toute la vérifiabilité.
- `PYTHON_SANDBOX_TOOL_ENABLED` (défaut vrai, interrupteur d'urgence), un plafond de scripts par tour et une limite de débit par utilisateur.
- **`execution_modes` sur les manifestes d'outils** : une restriction de mode devient un contrat que tout lecteur applique, avec repli ouvert pour les manifestes qui ne déclarent rien.
- ADR-249, qui consigne les décisions, les mesures et l'exposition résiduelle assumée.

### Changed

- **`pandas` est ajouté et `numpy` enfin déclaré.** Décidé sur mesure, contre l'intuition de départ : l'image fait 3,76 Go donc pandas pèse ~1,5 %, et **toutes** ses dépendances dures étaient déjà présentes — le verrou s'est résolu sans montée de numpy. Au passage, `numpy` était importé par quatre modules applicatifs sans figurer dans aucun manifeste : une vraie violation d'entrée de build, corrigée.
- Le point d'entrée d'exécution du bac à sable est partagé entre skills et scripts éphémères : **une seule implémentation**, donc un seul jeu de drapeaux d'isolation — impossible de durcir un chemin et d'oublier l'autre.

### Fixed

- **Le bac à sable n'avait jamais accès aux bibliothèques tierces.** `useradd -m` crée `/home/appuser` en `0700`, or le bac à sable tourne en uid 65534 et son `PYTHONPATH` pointe dans ce répertoire : le chemin était bien dans `sys.path` et **tout import tiers levait `ModuleNotFoundError`**. Conséquence live et antérieure à cette version : le skill enrichi `qr-code` livré avec LIA ne pouvait pas importer `segno` en mode conteneur. Le répertoire personnel devient traversable (`o+rx` uniquement — les paquets sont ceux de l'application, et le bac à sable n'a ni réseau, ni identifiants, ni écriture). Trouvé en exécutant un vrai script en production, pas par les tests unitaires : ceux-ci simulent le démon, donc l'argv paraissait correct et les permissions n'étaient jamais exercées. Une garde lit désormais le Dockerfile, seul endroit où la réponse existe.

### Security

- **Le mode bac à sable hérité est refusé** pour du code écrit par un modèle : il n'isole que si l'API tourne en root, compromis acceptable pour un skill que l'utilisateur a installé, inacceptable pour du code produit en lisant un email. Échec fermé, jamais de repli silencieux.
- **Double interdiction du pipeline** : le manifeste retire l'outil du catalogue du planner ET l'outil revérifie le mode à l'appel. Une seule des deux aurait laissé le planner planifier une étape refusée ensuite — une impasse inventée pour l'utilisateur.
- La sortie du script est marquée **`untrusted`** avant de rentrer dans le contexte : c'est du code écrit par un modèle sur des données de tiers.

### Tests

- 33 tests : refus hors ReAct, drapeau, budget par tour, transmission des données, sortie marquée, trace d'erreur rendue au modèle pour réparation, refus du bac à sable hérité, bornes de source et d'entrée, filtre de mode appliqué par ses trois lecteurs, et rendu admin des scripts.

## [1.35.0] - 2026-08-28

**« Je plonge dans tes emails… donne-moi une minute, je te sors ça. » — et le tour s'arrêtait là.** Les logs contredisent la lecture évidente : LIA n'avait pas refusé d'agir, elle avait travaillé six itérations, appelé un outil à chacune, et s'était fait couper en plein vol par son budget. Ce que l'utilisateur recevait n'était pas un refus, c'était une **pensée en cours servie comme réponse** — avec, en prime, des appels d'outils abandonnés en silence et rien pour dire que la recherche avait été interrompue. Cette version corrige les trois défauts que ce seul tour a révélés (ADR-248).

**Et la règle que l'utilisateur avait mémorisée pour interdire exactement ce comportement n'avait aucun effet** — pour une raison structurelle, pas statistique : en mode ReAct, la mémoire long terme n'atteignait jamais la boucle. La clé d'état prévue pour cela était déclarée, lue, et écrite par personne dans tout le dépôt.

### Fixed

- **Un message porteur d'appels d'outils en attente n'est plus jamais une réponse.** Sur une sortie par plafond, ces appels ne s'exécuteront pas et le texte n'est que la narration de ce que le modèle allait faire. La finalisation publie désormais un message final **vide** — le chemin qu'emprunte déjà le handoff de brouillon — donc la synthèse repart des résultats réellement obtenus, et une directive versionnée impose de dire ce qui a été trouvé, d'annoncer l'interruption en une phrase, de proposer la suite, et **jamais d'annoncer un travail futur** : un tour se termine quand sa réponse part, il n'y a pas de traitement en arrière-plan. Cette directive n'est volontairement **pas** conditionnée au drapeau de diagnostic — dire la vérité sur son propre run relève de la qualité de réponse.
- **La condition d'arrêt de la boucle a une seule implémentation** (`react_exit_reason`), lue par le routeur pour décider et par la finalisation pour expliquer. Deux copies laissaient la boucle s'arrêter pour une raison que la réponse ne mentionnait jamais.
- **La mémoire long terme atteint enfin la boucle ReAct.** Le profil est injecté au setup par `build_psychological_profile` — **le même constructeur que le pipeline**, mêmes réglages, même filtre de trivialité, même préférence utilisateur. Une règle de comportement qui n'arrivait qu'au nœud de réponse pouvait reformuler une promesse, jamais la transformer en action.

### Changed

- **Le budget d'itérations s'achète avec des résultats.** L'allocation adaptative d'ADR-238 (fondée sur le nombre de domaines) devient l'allocation _initiale_ : le span dit la largeur d'une question, jamais la profondeur de la réponse, et une enquête mono-domaine recevait donc le minimum. Chaque fois que la boucle atteint son budget en l'ayant dépensé **productivement**, elle en gagne un bloc ; une boucle qui cesse de produire cesse d'être prolongée. Un résultat `success: false` ou vide n'est pas une production — sinon la boucle achèterait des itérations avec ses propres échecs. Le plafond dur et le budget de calcul restent inchangés.
- Suppression de la clé d'état morte `injected_memories` : déclarée, lue par le setup ReAct, écrite nulle part. Un crochet crédible qui ne branchait rien.
- L'assemblage du contexte ReAct devient `nodes/react_context.py` — un constructeur par bloc, chacun best-effort, chacun rendant `None` quand il n'a rien à dire. `react_nodes.py` repasse de 592 à 524 SLOC et le ratchet de complexité descend de 335 à 334.

### Added

- `REACT_PROGRESS_EXTENSION_ENABLED` (défaut vrai) et `REACT_ITERATIONS_PROGRESS_EXTENSION` (défaut 4) : de quoi revenir au comportement historique pour qui veut plafonner le coût.
- ADR-248, qui consigne les trois décisions et ce qu'elles coûtent.

### Tests

- 32 tests dédiés : parité mémoire (constructeur partagé, préférence utilisateur, message trivial, panne avalée sans casser le tour, clé morte réellement disparue), honnêteté de troncature (promesse jamais servie, raison transmise, prédicat unique partagé, directive hors drapeau) et budget de progression (extension méritée, boucle stérile non prolongée, plafond et interrupteur respectés, définition de la productivité).

## [1.34.1] - 2026-08-28

**Une catégorie entière de la mémoire long terme n'a jamais pu s'écrire.** Les « règles et directives » — ces consignes durables que l'utilisateur donne sur la manière de travailler (« réponds-moi plus brièvement ») — avaient leur écran, leurs six traductions, leur en-tête d'injection en deuxième priorité et leur prompt d'extraction. Il leur manquait la seule chose qui compte : le droit d'exister. Le parseur qui transforme la sortie du LLM en mémoire rejetait la catégorie que ce même prompt réclamait, et le rejet partait en `debug`. Le lecteur a été livré avec un écrivain qui ne pouvait pas réussir, et le silence a tenu des mois.

**Le vocabulaire a maintenant une seule autorité, confrontée au démarrage.** `MemoryCategory` est l'énumération que stocke la colonne ; trois surfaces la restatent parce qu'aucune ne peut la dériver — mesuré le 2026-08-28, `Literal[*tuple(...)]` fait dégrader le type en `Any` sous MyPy, donc la dérivation coûterait plus qu'elle ne rapporte. Les trois sont donc vérifiées au boot, doctrine ADR-085 : l'application refuse de démarrer sur la moindre dérive, dans les deux sens.

**Le même jour, l'auto-diagnostic a rencontré sa première vraie panne — et a nommé la mauvaise chose.** Une mise à jour automatique de l'hôte a coupé le routage IP : tous les conteneurs ont perdu Internet pendant que `/health` restait vert, que le DNS continuait de résoudre et que l'hôte, lui, sortait très bien. LIA a détecté la conséquence en six minutes (100 % d'échecs LLM, deux disjoncteurs ouverts, incident ouvert et administrateur notifié) mais rien dans l'instantané ne pouvait dire **pourquoi**. Cette version ajoute la sonde qui manquait, et deux gardes qui rendaient ce genre d'angle mort possible.

### Fixed

- **Les mémoires « règles et directives » (`procedural`, ADR-236) peuvent enfin être créées.** Les deux `Literal` — celui qu'`ExtractedMemory` valide et celui que l'outil de mémoire expose au modèle — ignoraient la catégorie. Toute mémoire procédurale proposée par l'extraction levait une `ValidationError` avalée en `debug` : aucune n'a jamais été créée, et le groupe n'apparaissait donc jamais dans l'écran, qui ne montre que les catégories non vides. Symétriquement, une ligne `procedural` déjà stockée aurait fait échouer le modèle de réponse de la liste — emportant TOUTES les mémoires de l'utilisateur, pas une carte.
- **`GET /memories/categories` publie les sept catégories**, contre six : le catalogue que lisent les clients pour décrire les catégories avait dérivé avec les deux `Literal`.
- **La catégorie d'une mémoire n'était plus jamais corrigible.** `supersede_with_update` accepte une nouvelle catégorie et le modèle peut en proposer une, mais l'extracteur transmettait les cinq autres champs révisables et **pas celui-là** : un mauvais classement était définitif. Mesuré en production le 2026-08-28 — deux consignes durables, impératives et adressées à l'assistante, restaient en `personal` et y seraient restées quel que soit le nombre de reformulations. Une garde structurelle compare désormais ce que le service accepte de réviser avec ce que l'appelant envoie vraiment.
- **Le prompt d'extraction tranche explicitement entre `personal` et `procedural`** (une instruction adressée à l'assistante n'est jamais `personal`, même quand le message contient aussi un reproche ou une attente) et autorise la correction de catégorie dans un `update` — sans quoi le mécanisme réparé n'aurait jamais été sollicité.
- **Une entrée d'extraction rejetée est journalisée en `warning`**, plus en `debug` — c'est ce niveau qui a rendu le défaut invisible, pas la dérive elle-même. **Sans jamais recopier ce qui a été soumis** : `str(ValidationError)` rend `input_value=…`, c'est-à-dire ici la phrase de l'utilisateur, et `warning` est au-dessus de la ligne où le contenu a le droit d'apparaître. Le champ fautif et le type d'échec sont journalisés, la valeur jamais — et `category`, dont la publication est tout l'intérêt de la ligne, n'est imprimée que si elle ressemble à un jeton de vocabulaire.
- **L'unité d'un contrôle de santé est publiée par l'API** au lieu d'être devinée côté client à partir de son identifiant, avec `%` en repli : la sonde ci-dessous, qui mesure des millisecondes, se serait affichée en pourcentage (doctrine ADR-184). Le formateur du panneau perd trois cas particuliers au passage.
- **Un contrôle enregistré sans sonde ne peut plus passer inaperçu** : il levait un `KeyError` en plein tick — aucun instantané, aucun verdict, une seule erreur de planificateur que personne ne lit.

### Added

- **Sonde de connectivité sortante** (`platform_egress`, `DIAGNOSTICS_EGRESS_PROBE_TARGET`) : une connexion TCP bornée par tick, sans TLS ni requête. La cible est **configurée, jamais par défaut** — la pointer sur un hôte que l'instance appelle déjà ne divulgue rien de neuf, alors qu'une constante choisirait un tiers à la place de l'hébergeur (même règle que `PUSH_RELAY_URL`). Non configurée, le contrôle est **absent** : `ok` revendiquerait une mesure que personne n'a prise, et `unknown` ferait passer toute installation par défaut en `degraded`. Un échec ouvre un incident nommé `platform_egress` et se résout tout seul au retour.
- `InProcessCheck.enabled_setting` : l'activation conditionnelle d'un contrôle devient déclarative, et l'assert de boot refuse une porte qu'aucun champ de configuration ne soutient.
- `assert_probe_coverage` (patron ADR-085) : un contrôle sans sonde — ou une sonde qu'aucun contrôle ne déclare — empêche le démarrage.
- Garde de complétude au démarrage (`_validate_memory_category_vocabulary`, patron ADR-085) : chacune des trois restatements est confrontée à `MemoryCategory`, avec le nom de la surface fautive dans le message. Une catégorie ajoutée à l'énumération et oubliée ailleurs empêche désormais le boot au lieu de disparaître.
- 29 tests de garde (`test_category_vocabulary_guard.py`) : parité des trois surfaces, aller-retour écriture/lecture sur chacune des sept catégories, accord du prompt d'extraction et de la liste du front, niveau de journalisation du rejet, et **exécution** de la garde de boot — dont un cas où une surface tronquée doit bien empêcher le démarrage.

### Changed

- Suppression de `MemorySchema`, classe morte : plus aucun appelant depuis le passage à `ExtractedMemory`, elle restatait le vocabulaire une quatrième fois (six catégories) et son docstring se déclarait utilisée par l'extraction. `memory_tools.py` passe de 195 à 93 lignes.
- L'analyse de la sortie d'extraction devient un module à part (`memory_extraction_parsing.py`) : une responsabilité — analyser, retenir, et **dire ce qui a été refusé sans le recopier**. `memory_extractor.py` repasse ainsi sous le plafond global de 600 SLOC et **sort du gel de taille** (47 fichiers gelés au lieu de 48).
- `docs/technical/LONG_TERM_MEMORY.md` décrit le schéma réellement validé et nomme l'énumération comme autorité du vocabulaire ; `DIAGNOSTICS_DOMAIN.md` et l'ADR-247 consignent l'incident et les trois décisions qu'il a produites.

### Tests

- 29 tests pour le vocabulaire de mémoire, 6 pour la journalisation sans donnée personnelle, 15 pour la sonde de sortie et la couverture des sondes, 6 côté front pour le rendu des unités — dont un cas par unité publiée et un cas d'unité inconnue, qui doit s'afficher sans suffixe plutôt qu'avec le mauvais.

## [1.34.0] - 2026-08-28

**LIA émettait 486 métriques, des logs structurés et un cœur d'alertes — et n'en lisait rien.** Instrumentée de partout, aveugle sur elle-même : un job de fond mort n'atteignait personne avant qu'un humain n'ouvre Grafana, une alerte partait en e-mail mais jamais vers l'assistante ni vers un administrateur dans le produit, et la classe de panne documentée « /health vert mais LangGraph mort » restait invisible par construction. Cette version ferme la boucle : LIA lit désormais sa propre télémétrie (ADR-247).

**Une panne connue façonne maintenant la réponse au lieu d'un timeout.** Un advisor à coût nul sur plateforme saine injecte les capacités dégradées dans le planner et ReAct (« Brave est coupé → utilise Perplexity »), et la synthèse de réponse reçoit les échecs du run sous forme **typée** — code d'erreur et tête de message, jamais un log brut — avec une directive d'honnêteté : dire ce qui a réussi, ce qui a échoué et pourquoi, proposer le contournement, ne jamais inventer un diagnostic (doctrines ADR-182/184 tenues).

**Tout est réservé aux administrateurs, et tout est borné.** Aucun langage de requête libre ne part d'un LLM : un catalogue de requêtes nommées (assert de complétude au boot) est le seul producteur de PromQL, un constructeur contraint le seul producteur de LogQL — plages et volumes plafonnés en constantes, parce que Loki sur le Pi a un historique d'OOM et qu'une injection doit être impossible à épeler. Le diagnostic LLM est plafonné par un budget USD quotidien atomique ; à 0, l'étape n'existe pas.

### Added

- **Sous-système d'auto-diagnostic** (`DIAGNOSTICS_ENABLED`, défaut faux — éteint, rien n'existe à l'exécution) : clients de lecture Prometheus/Loki/Alertmanager qui **ne lèvent jamais** (timeout court, disjoncteur par source, échec = résultat typé `unavailable` ; URL vide = source désactivée, une installation sans stack d'observabilité est inchangée).
- **Boucle d'auto-contrôle** (leader élu, cadence réglable) : registre déclaratif de contrôles — signaux dorés Prometheus + sondes in-process (PostgreSQL, Redis, disjoncteurs, vivacité de la boucle elle-même) qui continuent quand Prometheus est mort — vers des instantanés persistés aux valeurs exactes. `unknown` plafonne le verdict à `degraded` : être aveugle n'est pas être sain, et la cécité n'est pas une panne.
- **Mémoire d'incidents** à identité unique : le webhook Alertmanager (Bearer, fragments commités injectés par l'entrypoint, matrice rejouée en CI) et les verdicts critiques de l'auto-contrôle convergent vers UN incident ouvert par clé de corrélation (index unique partiel, upsert atomique sous concurrence webhook-vs-leader). Notification des superusers in-app/push — jamais d'e-mail, Alertmanager le fait déjà — derrière un cooldown atomique qui échoue ouvert.
- **Diagnostic LLM ancré sur les runbooks** : slot `diagnostician` dédié, preuves et runbook cités comme données, sortie structurée (diagnostic, cause probable, actions recommandées — des propositions pour l'admin, jamais exécutées), incident sauté = diagnostic NULL donc réessayé au tick suivant.
- **« LIA, diagnostique-toi »** : quatre outils de chat en lecture seule (santé, métrique du catalogue, logs bornés, incidents), check superuser à l'appel via une garde partagée extraite de l'outil DevOps ; bornes publiées dans les manifestes (doctrine ADR-184).
- **Section Réglages « Santé de la plateforme »** (administration, i18n ×6) : verdicts par contrôle avec valeurs exactes, alertes en cours, capacités dégradées avec leur alternative, incidents et diagnostics — comptes exacts partout, rafraîchissement sans démontage (`aria-busy`).
- **REST admin** `GET /admin/diagnostics/{overview,incidents,snapshots}` sous `require_superuser`, patron briefing (endpoints scindés, cache Redis court) — la vue d'ensemble est **la même implémentation** que l'outil de chat.
- Tables `health_snapshots` et `incidents` (GLOBAL : aucune donnée utilisateur, hors export RGPD et purge de compte), migration `a6b7c8d9e0f1`.

### Changed

- Le planner et le setup ReAct reçoivent un bloc « PLATFORM DEGRADATIONS » **seulement quand il est non vide** — zéro token sur plateforme saine, fail-open par construction.
- Le response node appuie sa synthèse d'échec sur `completed_steps` et les ToolMessages ReAct — délibérément **aucune clé d'état nouvelle** — via une directive versionnée dont le template est **injecté par l'appelant** : le graphe de domaines reste acyclique (diagnostics n'importe jamais agents, ratchet F009 au vert).
- La garde superuser des outils DevOps est extraite en `agents/tools/admin_gate.py` et partagée (factorisation, comportement identique, tests devops inchangés).
- L'entrypoint Alertmanager sait injecter le receiver LIA dans les trois modes (complet, email-only, minimal sans SMTP) depuis deux fragments commités — un auto-hébergeur sans SMTP garde ses incidents in-app.

### Fixed

- Le commentaire du `Dockerfile.prod` annonçait « API HTTPS » sur le port 8000 alors que le CMD ne porte aucun flag TLS (la terminaison est chez cloudflared) — le webhook Alertmanager dépend de ce fait, il est maintenant écrit juste.
- `run_failfast_validations` a été décomposé (CC 16 → helpers dédiés) en absorbant les deux nouveaux asserts de boot du catalogue et du registre de contrôles — le ratchet de complexité ne monte pas.

### Tests

- 168 tests unitaires backend neufs (clients télémétrie sous `MockTransport` avec les chemins timeout/5xx/JSON malformé/circuit ouvert, bornes et injections du catalogue et du builder LogQL, moteur aveugle-mais-vivant, upsert d'incident, webhook Bearer, budget du diagnostic, advisor fail-open, extraction typée, matrice Alertmanager ×{templates, webhook on/off}) ; 6 tests composant pour la section admin (premier chargement vs rafraîchissement, totaux exacts, indisponibilité dite au lieu de « aucune alerte »).

## [1.33.2] - 2026-08-27

**`task lint:docs` était vert pendant que six documents annonçaient six planchers de couverture différents, tous faux.** Le gate ne contrôlait que la navigation — les liens résolvent, les chemins de code existent — jamais ce que la documentation _affirme_. Une phrase bien formée et fausse lui était invisible. Elle ne l'est plus : chaque version et chaque seuil cité sont recalculés depuis la source qui les possède, et l'écart fait échouer le build. `docs/technical/CI_CD.md` certifiait au passage que le seuil avait « une seule source de vérité » — en citant la mauvaise valeur.

**Le guide d'auto-hébergement promettait une procédure de mise à jour qui n'existait dans aucun fichier.** Elle est écrite : sept étapes, la sauvegarde en **première** parce que les migrations s'appliquent au démarrage du conteneur et qu'aucun chemin retour n'existe, le ré-épinglage des images par digest depuis le manifeste de la nouvelle version, et un retour arrière qui rend le code précédent en quelques secondes. `./install.sh --resume` n'est pas ce chemin et refusera : c'est sa garde fail-closed qui fonctionne, pas un défaut.

**`AGENTS.md` — le fichier d'instructions que lit un second agent de code — avait silencieusement perdu la moitié des règles.** 22 sections contre 40, sans **aucune** des « Systemic Rules » : ni la règle de mutation JSONB, ni celle de l'`AsyncSession` partagée entre tâches concurrentes, ni le cliquet de taille de fichier. Un agent le lisant travaillait contre des règles que la CI fait échouer. Il est désormais **généré** depuis `CLAUDE.md` : une source, un miroir, une garde.

### Added

- **`scripts/audit/doc_facts.py`** — douze faits (plancher de couverture, Python, Node, Next.js, React, FastAPI, LangGraph, LangChain, Pydantic, SQLAlchemy, PostgreSQL, Redis) recalculés depuis les manifestes, `pyproject.toml`, le `Taskfile.yml` et la composition de production. Un document choisit sa précision mais jamais d'être précis et faux : `Next.js 16` passe, `LangGraph 1.0` contre un `1.2.11` épinglé échoue. Pour désigner la génération, la convention est `1.x` — rien à maintenir. Réparation mécanique : `task docs:fix-facts`.
- **`scripts/audit/agents_mirror.py`** — `AGENTS.md` devient le rendu généré de `CLAUDE.md`, régénéré par `task docs:sync-agents`. Le corps est copié verbatim, ce qui n'est correct que parce que les deux fichiers vivent à la racine et partagent donc la base de résolution de leurs liens : une garde le vérifie.
- **Détection des orphelins** dans `doc_audit.py` — un document vivant que personne ne lie est un document que personne n'ouvre, et c'est la forme qu'ont prise tous les doublons périmés d'ici avant de le devenir. `docs/knowledge/` (corpus RAG servi aux utilisateurs) et `docs/runbooks/alerts/` (atteints depuis l'annotation d'une alerte) sont exemptés **avec leur raison écrite**.
- **`task lint:docs:preview`** — le même audit, mais tel que la CI le verra _après_ `git add`. `lint:docs` décide de l'existence depuis l'index git pour que son verdict soit celui d'un clone frais ; le coût était une fausse alerte à chaque déplacement de document, simulée à la main deux fois auparavant. La prévisualisation lance les **deux** instruments : n'en rejouer qu'un blanchirait les liens d'un document déplacé sans vérifier les versions qu'il cite.
- **Les compteurs de `docs/INDEX.md`** rejoignent `version_surfaces.py` : l'index citait le nombre d'ADR **deux fois, avec deux valeurs fausses différentes**. `task release:sync-counts` les tient désormais.
- **La procédure de mise à jour d'une installation auto-hébergée** (`GUIDE_SELF_HOSTING.md`), reprise dans la FAQ système pour que LIA sache y répondre, et pointée depuis les notes de release publiées.
- **Trente compteurs des pages vitrines rejoignent `version_surfaces.py`.** Le tableau de métriques des guides `how` (six langues), le tableau de chiffres clés des guides `story` (six langues, ADR et versions) et deux compteurs écrits en prose plutôt qu'en tableau — c'est précisément ce qui les avait fait échapper à toute surface. `task release:sync-counts` les tient désormais.

### Changed

- **`docs/readme/` est dissous** (14 documents) : un dossier sans audience définie, d'où venait l'essentiel des doublons. Chacun est reparti chez son lecteur — `GUIDE_OBSERVABILITY`, `GUIDE_BENCHMARKING` (fusion du benchmark de latence et du test de charge, deux questions voisines et un seul dossier de scripts), `technical/ALERTING`, `PROMETHEUS_THRESHOLDS`, `GRAFANA_LANGFUSE_DASHBOARD`, `REMINDERS`, `SCRIPTS`, `TESTING_AGENTS`, `AGENT_API_MIXINS`, `runbooks/README`.
- **Deux documents redondants supprimés.** `technical/GRAPH_AND_AGENTS_ARCHITECTURE.md` : chacun de ses sujets avait un foyer plus autoritaire ailleurs, et sa table « Node Line Counts (**Current**) » se trompait de −87 % à +63 % — `approval_gate_node` y était annoncé à 821 lignes alors qu'il en fait 110, étant devenu un pass-through. `readme/README_TESTS.md` : statistiques fausses de 31 à 64 %, une section de 652 lignes recommandant des tests vocaux écrits depuis, et un conseil de **rejouer** un test instable avec un marker `timeout` que le dépôt n'installe pas — sous `--strict-markers`, le snippet enseigné échouait à coup sûr.
- **La lecture par tiers des dashboards Grafana** rejoint le catalogue qu'elle résumait : l'enveloppe qui les séparait avait dérivé une quatrième fois (25 dashboards annoncés, 26 réels).
- **Les runbooks Redis sont regroupés** sous `docs/runbooks/alerts/`, et le doublon de `RedisConnectionPoolExhaustion` disparaît : l'orphelin conseillait d'éditer un réglage que le runbook maintenu documente explicitement comme inexistant.
- **Sept documents datés remis dans `docs/superpowers/plans/`**, dont un plan d'implémentation resté à la racine du dépôt. `docs/plans/`, `docs/optim/` et `docs/metrics/` disparaissent.
- La doctrine du test instable est écrite dans `GUIDE_TESTING.md` : diagnostiquer (le test seul, puis son fichier, puis la suite sans parallélisme), jamais rejouer.

### Fixed

- **Une garde était vacante depuis ADR-151.** `test_coverage_threshold_has_a_single_source_of_truth` comparait `pyproject.toml` aux occurrences de `ci.yml` — or ADR-151 avait déplacé les commandes pytest dans le `Taskfile.yml`. La boucle itérait sur une liste vide et le test passait inconditionnellement ; les deux copies du seuil dans le Taskfile n'étaient gardées par rien. Réparée, avec une assertion de non-vacuité pour que la même disparition ne puisse pas se reproduire en silence.
- **Une trentaine de faits corrigés** : le plancher de couverture dans six documents, LangGraph annoncé 1.1.6 dans quatre et 1.0.4 dans deux autres, Next.js 16.2.10, FastAPI 0.135.1, Python 3.12, Node 20, Redis 7.2. `docs/technical/STACK_TECHNIQUE.md`, qui se déclare « référence officielle des versions », en portait trois.
- **`ARCHITECTURE_AGENT.md` enseignait un motif interdit** : son gabarit d'agent inlinait le prompt système en Python, ce que la règle systémique proscrit et qu'**aucun** des six builders de production ne fait. Remplacé par le motif réel (`load_prompt`) — le document se contredisait lui-même, sa section 12 documentant correctement les prompts versionnés.
- **`README_SCRIPTS.md` renvoyait vers une méthodologie qui n'a jamais existé** (`docs/optim/00_METHODOLOGY.md`, `docs/optim/iterations/`) et racontait l'avancement d'une campagne abandonnée. Le catalogue des scripts, lui, est réel et conservé.
- **Le guide `story` — la page où le projet annonce publiquement ce qu'il vaut — était le seul tableau de chiffres sous aucune garde.** Il affichait 240 ADR et 222 versions contre 245 et 228 réels, dans les six langues à la fois : six releases de dérive silencieuse sur la page dont l'argument est que le résultat est _mesuré_. Les quatre chiffres sont re-mesurés sous la méthode d'origine, jamais re-cadrés — lignes de code, domaines fonctionnels (43 → 44, `push_relay` est arrivé en v1.33.0), tests et compteurs dérivés.
- **Un chiffre à un mot de distance de sa garde.** `how.zh.md` écrit « N 篇 MADR 格式的 ADR » là où la surface déclarée lit « N 篇 ADR ». Le chinois est resté à 242 pendant que ses cinq frères traduits passaient à 245.
- Le catalogue d'alertes hérité (désactivé, ADR-119) porte **huit `runbook_url` vers un domaine fictif** ; le constat et la règle à appliquer à sa réactivation sont consignés dans `ALERTING.md`, à côté du blocage des seuils.

### Tests

- Trois nouvelles gardes (`test_doc_facts_guard`, `test_agents_mirror_guard`, `test_doc_orphan_guard`), chacune avec ses tests « qui gardent la garde » — anti-rot sur le volume scanné, exemptions justifiées et encore vivantes, sources plausibles. C'est précisément ce qui manquait à la garde vacante réparée ci-dessus.
- Le correcteur automatique n'édite **que** les positions que le rapport a listées. Une revue a montré qu'il rescannait le document avec ses propres règles et aurait réécrit dix-huit occurrences situées dans des blocs de code — dont un « PostgreSQL 10 » discutant `max_connections` et un « 3.0 » appartenant à OpenAPI. Il refuse aussi les éditions chevauchantes, et préserve les fins de ligne y compris dans le seul document du dépôt qui les mélange.
- **Une surface déclarée qui ne correspond à rien passait en silence.** La garde des compteurs itère sur les occurrences _trouvées_ : une regex fautive ne produit aucune occurrence, donc ne peut jamais échouer — tout en figurant dans la liste des déclarations comme un compteur gardé. C'est la même classe que la garde vacante réparée plus haut. Une assertion exige désormais que chaque surface corresponde au moins une fois, et elle a elle-même été vérifiée contre une surface volontairement cassée.
- **`task ci:fast` ne couvrait pas la porte installeur hermétique**, alors qu'elle ne demande aucun service et que la CI l'exécute. Un `ci:fast` vert a donc été suivi d'une CI rouge : `scripts/release/tests` construit un dépôt synthétique qui doit porter une occurrence de **chaque** surface déclarée, et les trente nouvelles n'y étaient pas. La fixture est complétée et la porte rejoint `ci:fast` — une porte que personne ne peut jouer avant de pousser n'est pas une porte (ADR-151).
- Couverture backend re-mesurée : **70,04 %** pour un plancher de 67 %. Le plancher reste à 67 % — le passer à 68 % laisserait 2,04 points, sous la marge d'environ 4 points que le guide conserve délibérément pour l'écart de mesure entre Windows et le runner Linux.

## [1.33.1] - 2026-08-27

**Les réglages de localisation vivent enfin là où ils habitent : une section « Localisation » autonome dans les Préférences.** La cascade de position (géolocalisation en direct > position mémorisée > adresse du domicile, ADR-219) a toujours été une donnée du compte utilisateur, jamais du connecteur — l'imbriquer sous la carte Google Places se lisait comme « partagé avec Google », ce qui n'a jamais été le cas.

### Changed

- **Localisation : section de réglages autonome** — la cascade de position quitte la carte du connecteur Google Places pour sa propre section sous Préférences, avec son icône, son lien profond (`?section=location`) et ses mots-clés de recherche dans les six langues. La carte Google Places ne garde que ce qui lui appartient.

### Fixed

- **La FAQ n'envoie plus les utilisateurs au mauvais endroit** — cinq réponses, réparties sur les six éditions historiquement divergentes de la FAQ, pointaient encore les réglages de localisation vers « Paramètres > Connecteurs > Google Places » ; chaque édition a reçu sa correction chirurgicale (les éditions allemande et italienne, qui décrivaient déjà un chemin autonome, correspondent enfin à la réalité). Trois miroirs `docs/knowledge/` réalignés, deux numérotations cassées (1./3.) réparées au passage.
- Deux clés de locale orphelines (`settings.location.home.clear`/`.save`), mortes depuis le passage des boutons d'adresse aux boutons-icônes, supprimées des six langues.

### Tests

- Les 21 tests de la section ont déménagé avec leurs composants (zéro cas perdu, un ajouté : l'écrin de section autonome) ; la garde du compteur de recherche passe de 51 à 52 avec sa justification datée. Suite frontend complète : 6327 tests verts ; porte de couverture (agrégat + globs ciblés) verte après le déplacement.

## [1.33.0] - 2026-08-26

**LIA a désormais ses applications natives Android et iOS — une seule app publiée par store, cliente de n'importe quel serveur auto-hébergé.** La WebView charge l'origine distante de VOTRE serveur, dont vous saisissez l'URL au premier lancement : l'interface n'est jamais dupliquée, les évolutions web arrivent sans mise à jour de l'app, et le contrat de session par cookie httpOnly — celui-là même qui rend la PWA sûre — est ce qui rend les coques possibles. Chaque affirmation de plateforme a été **mesurée, pas supposée** : un banc dédié pilote l'app réelle sur émulateur, scène par scène, du premier écran jusqu'à l'oubli du serveur.

**La connexion Google fonctionne dans l'app — et ferme au passage un contournement du second facteur.** Google refuse OAuth dans toute WebView : le flux part donc vers le navigateur système et revient par un lien `lia://`, échangé contre la session via un code à usage unique lié à un vérifieur que seule l'app détient (un lien intercepté ne vaut rien). En câblant ce chemin, un défaut préexistant est tombé : **se connecter via Google enjambait le TOTP** — un compte protégé par second facteur ne l'était pas sur ce chemin. Le jeton d'attente voyage désormais en cookie httpOnly et l'étape code s'impose partout.

**Un iPhone ne peut pas être notifié par le serveur auquel il est rattaché, et aucun réglage ne corrige cela.** FCM n'atteint un iPhone que par APNs, qui authentifie l'émetteur avec une clé délivrée à l'équipe Apple **propriétaire du bundle id** — l'éditeur de l'app, jamais l'auto-hébergeur. Et une clé `.p8` vaut pour _toutes_ les apps de l'équipe, donc elle ne peut pas être distribuée. Comme la PWA iOS, elle, reçoit déjà des notifications web, une app iOS muette aurait été **en retrait de ce que les utilisateurs ont déjà**.

**Android n'a pas ce problème, et la coque en profite pleinement.** FCM identifie un émetteur par _projet_, pas par éditeur : l'app initialise Firebase **au démarrage** avec les options que votre propre serveur publie, et vos notifications ne quittent jamais votre projet Firebase. Aucun `google-services.json` n'est embarqué — en embarquer un aurait lié chaque installation au projet de l'éditeur.

**Pour iOS, un relais de réveil qui ne porte rien.** Il émet une phrase fixe, sans paramètre, dans les six langues ; l'app va ensuite chercher le vrai contenu sur **votre** serveur. Il ne stocke rien du tout : la poignée _est_ le chiffré authentifié du jeton d'appareil, elle expire, et deux serveurs ne peuvent pas corréler les leurs. Ce qu'il apprend malgré tout est écrit dans le guide plutôt que taire : qu'un appareil a été réveillé, quand, et l'IP du serveur demandeur. `PUSH_RELAY_URL` n'a **aucun défaut** — pointer quelque part par défaut aurait été une décision de vie privée prise par une constante.

**Le doute n'efface jamais un appareil.** Un relais injoignable, un 429, une réponse illisible ou un identifiant que _nous_ avons mal saisi conservent la poignée. Seuls deux verdicts la jettent : « illisible » et « appareil disparu ». Garder une poignée morte coûte un appel HTTP par notification ; en jeter une vivante fait taire un téléphone jusqu'au prochain lancement — et une seule variable fausse de notre côté l'aurait fait à tout le monde d'un coup.

### Added

- **Les coques natives** (`apps/mobile/`, ADR-246) : Capacitor 8.5, projets natifs **générés** et surcouche versionnée (`native/`), écran de configuration et écran hors-ligne embarqués dans les six langues, sonde de santé et enregistrement au relais **natifs** (la page tourne sur l'origine du serveur de l'utilisateur — tout appel vers un autre hôte serait du cross-origin qu'aucune politique CORS ne peut couvrir pour tous les auto-hébergeurs). Android vide son magasin de cookies sur disque à chaque passage en arrière-plan (mesuré : sans cela, quitter l'app dans les ~30 s suivant la connexion la perdait).
- **Connexion native** (lot 1) : `native_challenge` sur `/auth/google/login`, retour `lia://auth-callback`, `POST /auth/native/callback` avec code à usage unique lié au vérifieur (Redis `GETDEL`) — et la fermeture du contournement TOTP sur la connexion fédérée, second facteur exigé même via Google.
- **Le banc de la coque** (`task mobile:verify:android`, intégré au workflow de sonde CI) : dix scènes sur l'app debug réelle via le socket devtools WebView, sans serveur — configuration, refus HTTPS, écran hors-ligne, liens profonds routés/refusés **à chaud et à froid**, permission, échappatoire. Il a trouvé trois défauts vivants avant son premier passage vert.
- **Le guide de publication** (`docs/guides/GUIDE_MOBILE_PUBLICATION.md`) : le lot stores pas à pas — comptes, signature, la clé APNs `.p8` téléchargeable une seule fois qui fait de l'éditeur l'opérateur du relais, formulaires des deux consoles, défense argumentée du risque de review Apple 4.2, et ce qui recommence à chaque mise à jour.
- **Les douze départs OAuth reviennent dans l'app** (ADR-246, lot 3) : connecteurs, serveurs MCP, connexion groupée, reconnexion. La décision « partir vers le navigateur système » est prise **une seule fois**, à la porte que les huit flux franchissaient déjà — ce qui a **supprimé** le cas particulier que la connexion avait acquis. Et le retour se souvient de la surface qui l'a ouvert, écrit dans l'état OAuth par la seule fonction du dépôt qui en construise un : un connecteur ajouté demain en hérite sans le savoir.
- **Push natif sur les deux coques** (ADR-246) : `GET /notifications/push-config` répond par plateforme, la couche web transmet la réponse **entière** au shell et ne lit jamais un champ spécifique à une plateforme. `useFCMToken` délègue l'acquisition et garde **une seule** implémentation de tout ce qui suit — enregistrement, état, liste des appareils.
- **Relais de réveil** (`domains/push_relay/`, `PUSH_RELAY_ENABLED`, faux par défaut) : deux points d'entrée, aucune base, aucune tâche planifiée. Client APNs en HTTP/2 avec JWT ES256 — `h2`, `httpx`, `pyjwt`, `cryptography` étaient déjà là, **zéro nouvelle dépendance**, et aucun SDK Firebase embarqué côté iOS.
- **Écran hors-ligne groupé** (`server.errorPath`) : indispensable sur iOS, qui n'a pas de service worker et affichait sinon l'erreur de WebKit dans l'application. Il propose un réessai qui **reconstruit le pont** et surtout un moyen d'**oublier** le serveur — une adresse mal saisie au premier lancement produisait sinon cet écran à chaque démarrage, sans autre remède que réinstaller.

### Changed

- **Le banc de vérification pilote désormais l'app réelle** (`task mobile:verify:android`) : dix scènes sur la coque debug, observées par le socket devtools WebView, sans aucun serveur — l'origine configurée est un nom `.invalid` (RFC 2606), donc l'échec de navigation EST l'oracle. Avant son premier passage vert, il a trouvé deux défauts vivants que la compilation, la CI et toutes les gardes statiques avaient bénis.
- Dix rappels de connecteurs construisaient leur redirection de succès à la main : ils en partagent une. Les trois marqueurs de résultat MCP étaient des fragments de requête tout faits (`"mcp_oauth=success"`), qu'un lien profond aurait encodés comme une seule valeur opaque — ce sont désormais un nom de paramètre et trois valeurs.
- La fabrique de limitation de débit par IP passe de `domains/auth/dependencies` à `infrastructure/rate_limiting/ip_limiter`, en gardant ses clés Redis **octet pour octet** : quatre domaines sans rapport importaient leur limiteur du domaine auth.

### Fixed

- **L'écran hors-ligne ne se chargeait jamais dans l'état configuré sur Android** : `CapConfig.Builder` part de rien (il ne lit pas capacitor.config.json) et `MainActivity` ne reportait pas `errorPath` — le seul état où il compte. iOS était immunisé, ce qui rendait le défaut invisible à toute vérification symétrique. Trouvé en CONCEVANT le banc ; gardé statiquement depuis.
- **Ses deux boutons étaient morts sur Android** : avec un serveur distant configuré, Capacitor n'injecte son pont que dans les documents de cette origine, jamais dans la page `errorPath` locale — `window.Capacitor` y était indéfini. La coque expose désormais une `JavascriptInterface` minimale (`LiaOffline`), verrouillée pour n'agir que depuis la page hors-ligne. Trouvé par le PREMIER passage du banc.
- **`registerPush` demandait la permission avant de lire la configuration** : un utilisateur dont le serveur n'offre aucun push se voyait réclamer une permission sans objet. La configuration se lit d'abord — le banc est resté suspendu à ce dialogue, attendant un doigt qui ne viendrait jamais.
- Une valeur _truthy_ n'est pas un flux natif. Appelés directement par des tests unitaires, les rappels OAuth reçoivent l'objet `Depends` en guise de défaut — et un `Depends` est truthy : lus mollement, ces tests et tout appelant direct futur auraient pris le chemin du lien profond en plein navigateur. Trouvé par un test MCP existant qui faisait exactement cela.
- **Un lien profond qui DÉMARRE l'app perdait la connexion** (Android) : `onNewIntent` ne couvre que l'app vivante, et le navigateur système peut récupérer la coque pendant l'OAuth (mémoire basse) — le retour arrivait alors sur l'intent de lancement, que rien ne lisait. iOS était immunisé d'origine, ce qui aveuglait tout contrôle symétrique. Le gestionnaire est partagé entre les deux portes et **consomme** l'intent (un `recreate()` l'aurait rejoué vers un code déjà dépensé). Prouvé par la scène « à froid » du banc, oracle logcat — la navigation vit ~200 ms, deux oracles devtools ont perdu cette course avant le bon.
- `refreshTokens` relisait `Notification.permission` après l'enrôlement et écrasait l'état qu'il venait d'établir — ce qui, dans une coque, répond `unsupported`. Un rafraîchissement ne doit pas défaire ce qu'il suit.

### Tests

- 78 tests unitaires neufs sur le programme : scellé Fernet du relais (15), client APNs (22), service et routeur du relais (25+), livraison relayée, configuration refusant de démarrer incomplète, marqueur de flux natif (connecteurs **et** MCP — les trois coutures MCP étaient les seules sans test direct, trouvé par la revue intégrale), en-tête `X-LIA-Native`, chemins natifs de `useFCMToken` et de `safe-navigation` (verrouillé à 100/100/100/100).
- Trois gardes de cohérence inter-couches, chacune **vérifiée rouge sur sabotage** : les quatre déclarations d'un lien profond (enum serveur, cartes des deux coques, intent-filter du manifest), la surface du greffon en quatre endroits dont trois échouent en silence, la parité six langues des pages embarquées (seul texte utilisateur que la porte i18n ne voit pas) et l'invariant JSON↔Builder d'`errorPath`.
- Planchers de couverture relevés : branches frontend 69 → 70, nouveaux périmètres `src/lib/native/**` et `src/lib/safe-navigation.ts`.

### Removed

- `_get_client_ip` et son test doublon : tous deux redisaient, moins complètement et sur une prémisse depuis réfutée, ce que `core/client_ip.py` documente déjà.

## [1.32.0] - 2026-08-27

**Demander à un modèle de réfléchir avait quatre formes, sept constructeurs et trois autorités qui devaient s'accorder. Il n'en reste qu'une.** La valeur stockée s'appelait `{"effort": "off"}` sur vingt et un slots et `{"effort": "none"}` sur six autres — la même instruction, écrite de deux façons. Sa _forme_ était choisie par une colonne du catalogue, et son interprétation par un `isinstance` dans le constructeur du fournisseur : quand les trois divergeaient, l'instanciation du modèle levait une exception **sur le chemin chaud**, pour une configuration que l'interface d'administration avait acceptée.

**Une intention, un traducteur.** `ReasoningIntent(level, budget_tokens, exclude_from_output)` remplace les quatre formes. L'échelle est ordinale et indépendante du fournisseur — `provider_default < none < minimal < low < medium < high < xhigh < max` — et ce que chaque modèle accepte est **dérivé** de son couple (fournisseur, modèle), le catalogue ne pouvant que restreindre cette échelle, jamais l'élargir. Le catalogue devient une optimisation au lieu d'un prérequis : un modèle inconnu fonctionne par coercition au lieu de faire échouer l'appel.

**La coercition est un contrat de sûreté, pas une commodité.** Les égalités tranchent **vers le haut** (le choix le moins cher sous-livre en silence, le plus cher se voit dans les coûts) ; `none` n'est **jamais** une cible de coercition ; et c'est `can_disable` — pas l'appartenance à l'échelle — qui gouverne l'extinction. Cette dernière règle n'est pas théorique : une ligne de catalogue restreint les _profondeurs_ qu'un modèle propose sans signifier « et on ne peut plus l'éteindre », si bien que lire l'échelle à cet endroit **activait** le raisonnement sur un `none` explicite. Chaque coercition est comptée et journalisée : ce n'est pas une erreur, mais le modèle ne fait pas ce que l'administrateur a demandé.

**Ce qui est proposé est exactement ce que l'API accepte.** L'écran de configuration recevait les colonnes du catalogue pendant que l'écriture validait autre chose — c'est ainsi que la liste déroulante en est venue à offrir `minimal` sur un modèle dont l'API le refuse. `/llm-config/metadata` publie désormais le profil **résolu**, calculé par la fonction qui valide et qui traduit.

**Et le travail des référentiels publics devient visible.** Deux registres publics vendorisés avaient corrigé 83 lignes du catalogue et enregistré, pour chacune, qui avait rempli ses capacités — sans que rien ne l'expose. Devant le tableau, la question est pourtant toujours la même : ce 8 192, est-ce une mesure ou le défaut de colonne que personne n'a curé ? Chaque ligne porte maintenant sa provenance, et un bandeau résume ce que les référentiels disent de l'installation.

### Added

- **Une seule forme stockée pour le raisonnement** (`ReasoningIntent`), traduite en kwargs par une fonction et une branche par famille de fournisseur. Ajouter un fournisseur, c'est une règle et un rendu ; aucune famille existante ne change.
- **Compteur de coercition** `llm_reasoning_coerced_total{model,from_level,to_level}` plus une ligne de journal : un niveau déplacé au démarrage d'un appel n'est plus invisible.
- **Profil de raisonnement publié** par `/llm-config/metadata` — famille, échelle acceptée, possibilité d'extinction, budget exprimable, exclusion du raisonnement de la réponse. Le widget d'administration est intégralement piloté par ce profil.
- **Provenance des capacités visible** sur l'écran Tarification LLM : un badge par ligne (`Non curé` / `Corroboré par référentiel` / `Vérifié par un humain`) et la date de retrait publiée par le fournisseur lorsqu'elle existe.
- **Bandeau « Sources des caractéristiques »** : répartition des provenances, verdict de comparaison avec les référentiels, retraits annoncés avec leur preuve (`annoncé`, `contredit`, `signalé`, `retiré`) et date de l'instantané. En lecture seule — appliquer une correction reste une migration relue.
- **Endpoint `GET /admin/llm/catalogue-status`** : le même verdict que `task llm:catalogue:sync`, calculé par le même code.
- **Le gabarit de raisonnement disparaît, des deux côtés.** Le classeur Excel écrit désormais l'identité de raisonnement dans les deux colonnes que le runtime lit vraiment (`is_reasoning_model`, `reasoning_enum_values`), et son import refuse une profondeur hors famille **en nommant celles qui auraient été acceptées** — une feuille de calcul ne sait pas afficher de cases, la garantie se déplace donc à l'import. Le mécanisme de gabarits qu'il remplace regroupait les modèles par leur échelle _stockée_ et non par famille : en copier un d'une autre famille retirait des profondeurs en silence. Il exigeait aussi un gabarit **pour créer un modèle qui ne raisonne pas**, faute d'autre canal d'écriture. Partent avec lui : l'endpoint `GET /admin/llm/reasoning-templates`, quatre méthodes de service, une exception, le champ `reasoning_template` et son validateur XOR, la colonne du classeur et son référentiel (`SCHEMA_VERSION` passe à 2).
- **L'échelle acceptée se coche, elle ne se tape plus.** Le formulaire Tarification LLM demandait à l'administrateur de _déclarer_ ce qu'un modèle accepte, alors que la colonne ne peut que **restreindre** une échelle dérivée du couple (fournisseur, modèle) — et n'est même pas lue quand aucune règle ne reconnaît le modèle. Le champ libre devient la liste des profondeurs de la famille, résolue en direct par le nouvel endpoint `GET /admin/llm/reasoning-family` (la **même** fonction que le traducteur et le validateur), et l'on décoche ce que ce modèle précis refuse. Deux erreurs deviennent irreprésentables : écrire un niveau qui n'existe pas — c'est ainsi que `off` était supprimé en silence par l'intersection — et copier l'échelle d'une **autre famille**, ce qui retirait des profondeurs sans le dire. Ce dernier cas reste possible via un gabarit, mais le panneau affiche désormais ce qu'il retirerait. Un modèle sans famille est annoncé comme tel, au lieu d'une liste vide qui ressemblait à un bug.
- **Contrôle d'instance avant déploiement** (`task llm:catalogue:preflight`, lecture seule) : il répond désormais à sept questions au lieu de trois, dont la seule qui compte vraiment avant une mise en production — **pour quels slots la profondeur demandée par l'administrateur serait corrigée par le runtime**. `DATABASE_URL` le vise, et il imprime les valeurs qu'il a supposées de son environnement, parce que seule la base est celle de la cible : les modèles par slot, le résumé et la chaîne de repli vivent dans le `.env` de l'instance. Une adresse injoignable donne une phrase, jamais une trace asyncio.

### Changed

- **Le vocabulaire des échelles déclarées est normalisé** : quatre lignes du catalogue déclaraient encore `off`, un niveau qui n'existe pas. L'intersection le supprimait silencieusement, laissant une échelle **sans interrupteur** — et seul `can_disable` remettait l'extinction. Migration `e4f5a6b7c8d9`, plus une garde qui interdit tout niveau hors échelle dans le seed.
- **Le second canal Anthropic disparaît** : `llm_config_overrides.effort` et `llm_models.effort_values` produisaient le même kwarg que `reasoning_effort`, et l'ordre du dictionnaire décidait du gagnant. Mesuré au retrait : aucun slot configuré ne l'utilisait.
- **Deux colonnes de catalogue supprimées** (`reasoning_widget`, `reasoning_budget_range`) avec le type énuméré qui n'avait plus qu'elles. Elles discriminaient les quatre formes stockées ; le formulaire continuait de les offrir à l'édition, ce qui est pire que leur absence — un champ que l'on peut curer et que rien ne lit. Le mode Custom se réduit à une seule saisie : l'échelle acceptée.
- **La règle de cohésion du catalogue est retirée** : sa dernière clause (`widget='none'` interdit une échelle) refusait précisément la ligne la plus utile qu'un opérateur puisse écrire.

### Fixed

- **Une échelle restreinte ne pouvait plus être élargie.** Le formulaire envoyait « aucune restriction » comme un `null`, or le service construit son jeu de changements avec `exclude_none` : la valeur était jetée en route et l'ancienne restriction survivait. Un réglage incapable d'exprimer sa propre valeur par défaut est un réglage cassé — la parade est celle que le prix caché vidé avait déjà reçue, une intention qui a sa propre forme (`clear_reasoning_enum_values`).
- **`provider_default` partait chez le fournisseur.** L'identité — « aucune profondeur demandée » — atteignait trois familles de rendu dès qu'une intention portait un budget sans niveau, produisant `{"effort": "provider_default"}`, valeur qu'aucune API n'accepte. Le test de matrice existant rendait ces combinaisons et n'assertait que la sérialisabilité JSON.
- **« Masquer le raisonnement » ne faisait rien** sans profondeur choisie : le court-circuit passait avant. L'interrupteur est indépendant dans l'interface et la valeur était acceptée à l'écriture.
- **Le journal DeepSeek affichait toujours `None`** : il lisait un attribut disparu au retypage, sur les vingt-sept slots concernés.
- **L'interface effaçait en silence** un override entier lorsqu'un budget hors bornes était saisi — le niveau choisi compris — alors que le champ est à l'écran avec ses bornes imprimées dessous.
- **`get_llm()` aurait levé une `AttributeError` à chaque appel** : un champ retiré était encore lu par la fabrique. Invisible pour MyPy, dont l'exemption `attr-defined` couvrait tout `src.infrastructure.llm.*` — exemption retirée (huit erreurs seulement, dont cinq réelles : les réglages sont plats, `settings.observability.X` n'existe pas).
- **L'entrée du conteneur d'API segfaultait** sur `alembic upgrade head` (debugpy × modules figés de Python 3.14) : l'API restait morte, ordonnanceur tournant.

### Tests

- **Équivalence golden** : les kwargs produits par le code d'avant sont figés et rejoués — **54 sur 54 identiques**. La migration, les seeds de référence et cette preuve partagent le même mapper, donc ils ne peuvent pas diverger sur ce qu'une valeur stockée voulait dire.
- **Contrat publié/appliqué** : chaque niveau proposé par `/llm-config/metadata` est accepté par le validateur, et chaque niveau retenu est refusé — sur tous les modèles des défauts de code plus cinq formes représentatives.
- **Simulation avant migration** sur la base réelle : 1 290 combinaisons (modèle × forme stockée), **0 divergence**.
- **Sept gardes vérifiées rouges** sur correctif annulé, dont deux qui étaient aveugles à la règle qu'elles prétendaient garder.

## [1.31.3] - 2026-08-23

**Le mode sombre gagne une seconde profondeur, et l'interface récupère des repères qu'elle avait perdus.** Le nouveau mode OLED pose un fond parfaitement noir — `oklch(0% 0 0)`, la valeur pour laquelle les pixels d'un écran OLED s'éteignent vraiment — et le bouton de l'en-tête devient circulaire : clair, sombre, noir absolu, puis clair de nouveau. Le passage se fait par une révélation en cercle qui s'ouvre depuis le bouton pressé, escamotée dès que le système signale une préférence pour un mouvement réduit.

**OLED est un raffinement du mode sombre, jamais un quatrième thème.** Cette décision de conception n'est pas cosmétique : la classe `dark` reste posée sur la page et l'attribut `data-oled` s'y ajoute. En faire une valeur de thème à part entière aurait retiré cette classe, et avec elle basculé neuf comparaisons internes vers leur branche claire — coloration syntaxique claire sur fond noir, diagrammes blancs, flocons invisibles — puis renvoyé tout le site public à sa variante claire. Seules six teintes neutres changent : chacun des cinq thèmes de couleur garde son accent, et les bordures conservent leur valeur sombre, qui se détache mieux sur du noir absolu que sur le gris d'origine.

**Les réglages retrouvent le mode « Système ».** Le cycle de l'en-tête n'offre que trois arrêts prévisibles, or « Système » est ce sur quoi démarre tout nouveau compte : sans un contrôle capable d'y revenir, une seule pression l'aurait perdu définitivement. Le panneau Apparence propose donc les quatre choix, et l'interrupteur « Noir absolu » n'y est actif qu'en mode sombre explicite — plutôt que d'épingler silencieusement un mode que l'utilisateur n'a pas demandé.

**Trois défauts corrigés étaient structurellement invisibles.** Trois cases à cocher portaient des classes qui ne produisent aucune règle CSS : elles n'avaient donc ni couleur d'accent ni anneau de focus, et une navigation au clavier y perdait toute trace du curseur. Le badge de compétence du chat affichait un texte à 1,39:1 contre un plancher de 4,5:1. Et l'enregistrement du mode d'affichage était refusé par le serveur pour la nouvelle valeur, avec un échec parfaitement muet : l'écran devenait noir, seul le rechargement suivant révélait la perte.

### Added

- **Mode OLED** : fond `oklch(0% 0 0)`, six teintes neutres recalibrées pour que rien ne se distingue moins qu'en mode sombre — carte sur fond 1,10 contre 1,09, bordure sur carte 1,51 contre 1,37. Vérifié sur les vingt-cinq paires de contraste des cinq thèmes de couleur.
- **Bouton de thème circulaire** : clair → sombre → OLED → clair. L'icône et le nom accessible annoncent la destination, pas l'état courant, et le cycle part de l'apparence réellement affichée — un compte resté sur « Système » avec un système sombre avançait auparavant sans que rien ne change à l'écran.
- **Sélecteur de mode d'affichage dans les réglages** : Clair, Sombre, Système, plus un interrupteur « Noir absolu » actif seulement en mode sombre explicite. Boutons radio natifs, donc navigation aux flèches et gestion du focus fournies par le navigateur.
- **Révélation circulaire au changement de thème** : ouverte depuis le contrôle pressé, désactivée sous préférence de mouvement réduit et absente des navigateurs sans l'API — une amélioration progressive, jamais une dépendance.
- **Sélection de texte aux couleurs du thème** : surligner du texte n'affiche plus le bleu du navigateur, étranger aux cinq palettes et particulièrement discordant sur fond noir.
- **Page « introuvable » dans les six langues**, avec un retour vers l'accueil de la langue en cours, et une frontière d'erreur de dernier recours pour le cas où la mise en page elle-même échoue.
- **Anti-scintillement au chargement** : le mode OLED et le thème de couleur sont appliqués avant le premier affichage. Le clignotement de l'accent, présent depuis l'introduction des thèmes, disparaît par la même occasion.

### Fixed

- **Anneau de focus absent sur trois cases à cocher** (connexion, inscription, acceptation des conditions) : les classes utilisées ne compilent vers aucune règle. Remplacées par une primitive commune adossée aux jetons du thème.
- **Badge de compétence illisible en mode clair** : 1,39:1 mesuré contre un plancher de 4,5:1. Le badge existait en deux exemplaires écrits à la main, déjà divergents ; il n'en reste qu'un, dont le contraste est vérifié sur les quinze palettes.
- **Reflet du badge figé sur le texte** sous préférence de mouvement réduit : arrêter l'animation laissait la bande lumineuse posée sur le libellé. Son intensité passe aussi de 0,25 à 0,15, l'ancienne valeur ramenant le pic à 3,93:1.
- **Texte atténué sous le seuil de lisibilité** : l'opacité la plus faible employée pour les intitulés de section mesurait 2,80:1 en clair et 3,61:1 en sombre. Supprimée de ses six emplacements.
- **Étiquette « Se souvenir de moi » invisible en mode sombre** sur le formulaire d'inscription, où la variante sombre manquait — le formulaire de connexion l'avait.
- **Enregistrement du mode d'affichage refusé par le serveur** : la nouvelle valeur n'était pas déclarée dans la liste des thèmes acceptés, si bien que chaque sauvegarde répondait une erreur de validation sans que rien ne le montre à l'écran.
- **Choix de mode explicite non restauré** au chargement lorsqu'il coïncidait avec ce que « Système » affichait déjà : les réglages annonçaient « Système » alors que le compte disait « Sombre ».
- **Changements de thème rapprochés** : trois pressions successives lançaient trois écritures concurrentes vers la même ligne, sans garantie d'ordre. Les écritures sont sérialisées et les états intermédiaires fusionnés.
- **En-tête du site public débordant en français** : à 880 px — exactement la largeur où les boutons « Se connecter » et « Rejoins la BETA » apparaissent — la rangée dépassait de 4 px. La cause n'était pas cette rangée (l'espagnol est plus large sans déborder) mais la navigation de gauche, dont les libellés français sont les plus longs : 503 px contre 449. L'espacement des liens est resserré d'un cran, ce qui rend au français la marge que l'ajout d'un lien lui avait prise.
- **Échec réseau lors de l'enregistrement du thème** : la promesse rejetée remontait jusqu'au gestionnaire de clic. L'échec reste journalisé, le changement local est conservé.

### Changed

- **Polices de caractères chargées à la demande** : les huit familles proposées au choix étaient toutes préchargées, soit 26 fichiers et 618 Ko téléchargés sur une page qui n'en affiche qu'une. Ramené à 3 fichiers et 162 Ko, rendu identique. La police par défaut reste préchargée.
- **Surfaces grises figées converties en jetons de thème** (panneaux d'erreur, formulaire de téléphonie) : elles ignoraient les cinq thèmes de couleur et seraient restées grises sur fond noir.
- **Pastille d'état des comptes dans l'administration** ramenée aux variantes de badge existantes, dont le contraste est vérifié, au lieu de trois paires de couleurs écrites à la main.

### Developer experience

- **Compilation du conteneur de développement** : Tailwind détecte ses sources depuis le dossier `apps/web` et transforme chaque fichier trouvé en dépendance de compilation, chacun coûtant un aller-retour de montage. Trois arborescences de preuve E2E oubliées — 33 938 fichiers, 96 % du balayage — portaient la première compilation de page à 10 min 32 s. Le périmètre est désormais borné aux sources, et ces arborescences sont exclues des trois côtés.
- **Rechargement à chaud du frontend** : le montage ne transmet pas les événements du système de fichiers de l'hôte, si bien qu'aucune modification n'atteignait le navigateur. Un intervalle de veille est introduit, réglé à 5 000 ms — un intervalle court n'est pas « plus réactif », il maintient le graphe de compilation invalidé et fait payer une reconstruction à chaque affichage.
- **Démarrage de l'API en développement** : le débogueur détourne la machinerie d'import de Python, ce qui entre en collision avec les modules figés de la version 3.14 et faisait échouer le conteneur au démarrage avec une erreur différente à chaque essai — toutes dans du code tiers, aucune dans le code applicatif. Mesuré sur quatre démarrages à froid : deux échecs sans le correctif, aucun avec.
- **Outillage des surfaces de release** : `task release:check` signale toute dérive de version ou de compteur, `task release:bump` écrit les surfaces mécaniques et réaligne les compteurs publiés. Une garde vérifie en intégration continue exactement ce que l'outil écrit.
- **Nouvelles gardes** : un contrôle de contraste étendu au mode OLED et au badge de compétence, un cliquet sur les opacités de texte dont le plancher est dérivé des palettes plutôt que codé en dur, et un contrat inter-couches qui compare la liste des modes acceptés par le serveur à celle que le frontend sait enregistrer.

## [1.31.2] - 2026-08-22

**La recherche documentaire retrouve ses réponses, dans les six langues** (ADR-242). La fusion qui combinait similarité sémantique et correspondance de mots-clés comportait deux défauts qui se composaient. D'une part le score BM25 était ramené au maximum du corpus : le « moins mauvais » appariement lexical recevait donc la note parfaite, quelle que soit sa faiblesse réelle — du bruit pur dès que la langue de la question diffère de celle des documents. D'autre part le seuil de pertinence était comparé à un score déjà rétréci par la pondération, si bien qu'un passage sans mot commun avec la question devait atteindre 0,786 de similarité pour franchir une barre documentée à 0,55 — au-dessus de la médiane d'une bonne réponse. Résultat mesuré sur la base réelle : **36 % des bonnes réponses franchissaient le seuil sémantique puis étaient écartées par la fusion**. La question « est-ce que mes données sont chiffrées ? » ne remontait aucun extrait, alors que cinq passages y répondaient.

**Le seuil porte désormais sur la similarité sémantique seule, et les mots-clés ne servent plus qu'à départager.** Un réglage qui s'appelle « score minimum » signifie enfin la même chose que la requête partage ou non le vocabulaire des documents. La correspondance lexicale conserve son rôle utile — faire remonter une occurrence exacte devant un quasi-ex æquo — mais elle ne peut plus ni faire entrer ni faire sortir un passage. Le seuil a été recalibré sur les six langues, à partir des corpus réels et de 740 questions écrites dans chacune : une valeur globale unique, parce que l'optimum s'est révélé identique partout.

**Le chinois était le plus touché, et pour une raison distincte** : le découpage en mots utilisé par la recherche par mots-clés considérait une phrase chinoise entière comme un seul mot. La recherche lexicale y était donc réduite à une correspondance de phrase exacte, c'est-à-dire à rien. Les écritures sans espaces (chinois, japonais, coréen) sont maintenant découpées en groupes de deux caractères ; les écritures latines sont inchangées.

### Added

- **Refus de démarrage sur une configuration d'embedding incohérente** : une dimension que la colonne de la base ne peut pas contenir faisait échouer chaque écriture en production, longtemps après le démarrage. L'application refuse désormais de démarrer, et le message dit quelle migration serait nécessaire.
- **Registre des capacités des modèles d'embedding** : un modèle non déclaré refuse le démarrage, et un modèle qui ignore la distinction question/document déclenche un avertissement explicite — la propriété sur laquelle tous les seuils de pertinence sont calibrés ne peut plus disparaître en silence.
- **Le seuil de pertinence est affiché dans le panneau de débogage** : il est tracé sur chaque barre de score et nommé dans le message « aucun extrait pertinent », de sorte que « pourquoi ce passage a-t-il été écarté » se lit sur place.

### Fixed

- **Recherche dans les espaces de connaissances** : rappel mesuré sur les corpus réels, questions écrites en langue native — français 0,525 → 0,867, anglais 0,883 → 0,950, allemand 0,533 → 0,883, espagnol 0,425 → 0,867, italien 0,450 → 0,842, chinois 0,208 → 0,817. Sur des documents rédigés en chinois, 0,075 → 0,887.
- **Moins de bruit, pas seulement plus de rappel** : un tour de conversation sans rapport avec les documents reçoit moins d'extraits qu'avant (1,25 → 0,88 en moyenne). La correction améliore les deux axes à la fois, elle n'échange pas l'un contre l'autre.
- **Découpage en mots des écritures sans espaces** : chinois, japonais et coréen sont découpés en groupes de deux caractères. La recherche par mots-clés seule passe de 0,062 à 0,487 de rappel sur un corpus chinois. Sortie strictement identique pour les six langues à écriture latine.
- **Coût des embeddings lu dans la grille tarifaire** au lieu d'un prix figé dans le code : changer de modèle ou de tarif se répercutait sur la facturation enregistrée mais pas sur les métriques ni les journaux, qui restaient bloqués sur l'ancien prix.
- **Estimation du nombre de jetons faussée pour le chinois** : la règle « quatre caractères par jeton » sous-comptait le chinois de 41 à 57 %, et l'ensemble multilingue de 15 %. L'estimation distingue désormais les écritures ; l'écart global tombe à 1 %.
- **Ré-indexations en ligne de commande sans grille tarifaire** : le plus gros lot d'embeddings que le déploiement exécute rapportait un coût nul faute d'avoir chargé les tarifs.
- **Score de pertinence hors de sa plage** : la note publiée pouvait dépasser 1 une fois le bonus lexical ajouté, alors que tous ses lecteurs — l'outil de recherche documentaire, la barre du panneau de débogage, la documentation du dépôt — annoncent une échelle de 0 à 1. Le classement conserve la valeur exacte, la note publiée reste bornée.

### Changed

- **`RAG_SPACES_HYBRID_ALPHA` remplacé par `RAG_SPACES_BM25_BONUS_WEIGHT`** (0,05) et **`RAG_SPACES_RETRIEVAL_MIN_SCORE` porté de 0,55 à 0,62**, désormais appliqué à la similarité sémantique. L'ancien réglage est supprimé plutôt que déprécié : un paramètre qui n'influence plus rien est un piège.
- **Paliers de couleur du panneau de débogage recalibrés** (0,75/0,68 au lieu de 0,70/0,50) : sous le seuil, plus rien ne peut s'afficher, si bien que l'ancien palier bas était devenu inatteignable et que presque tout apparaissait au vert.
- **Deux réglages morts supprimés** (`SEMANTIC_TOOL_SELECTOR_HARD_THRESHOLD` et `SOFT_THRESHOLD`) : documentés partout, lus par aucun chemin de code — la sélection d'outils se décide sur un score calibré, pas sur ces seuils.
- **`gemini-embedding-2` évalué puis écarté** : le modèle ignore la distinction question/document dont dépend toute la calibration, coûte 33 % de plus, et s'est révélé moins bon que le modèle actuel sur de la prose française monolingue — la forme de la plupart des documents déposés. La décision et ses mesures sont consignées pour être rouvertes si le besoin change.

## [1.31.1] - 2026-08-21

**L'écosystème Google s'élargit de onze surfaces, et la météo devient respirable** (spec 2026-08-21). Le programme couvre les capacités que les jetons déjà accordés autorisaient sans que LIA les exploite : groupes de contacts et « autres contacts » (People API), créneaux libres via freeBusy, delta exact de nouveaux mails (`history.list`), réglages de boîte Gmail avec répondeur d'absence et création de filtres sous confirmation, lecture ET écriture Sheets/Docs, visioconférence Meet/Teams à la création d'événement, vignettes Street View, filtrage d'URL par Web Risk avant toute navigation, et deux services plateforme nouveaux — Google Weather (alternative sans clé personnelle à OpenWeatherMap) et Google Environnement (qualité de l'air, prévisions polliniques). Chaque écriture passe par le circuit de confirmation existant : l'aperçu montre exactement ce qui sera écrit — la ligne du tableur, le texte du document, les mots du répondeur — et rien ne part avant approbation.

**Une demande de météo répond désormais aussi à la question qu'on ne pose pas.** Quand le connecteur Environnement est actif, « quel temps fait-il ? » rapporte aussi l'indice de qualité de l'air et les pollens en saison — sur la carte du chat, sur la prévision, et sur la carte d'accueil. Deux règles d'honnêteté gouvernent cet affichage, apprises du vrai payload : la catégorie affichée est celle que l'API elle-même publie (l'indice universel Google est inversé par rapport à l'échelle EPA — 100 signifie excellent), et un chiffre ne voyage jamais avec le libellé d'une autre échelle : l'indice national français publie « Moyen » sans valeur numérique, et c'est cette catégorie seule qui s'affiche plutôt qu'un nombre emprunté. La même règle s'applique à la carte d'un lieu, où la qualité de l'air répond à « on va au parc cet après-midi ? ».

**Le temps réel arrive enfin par notification plutôt que par sondage** (lot H, flags par phase). Les changements d'agenda et de Drive ouvrent des canaux `watch` vers un webhook vérifié ; les nouveaux mails passent par Pub/Sub. Les notifications invalident les caches concernés, avec anti-tempête, déduplication idempotente et purge des canaux orphelins ; le sondage reste le repli quand le push est désactivé ou périmé. Deux corrections de facturation accompagnent le programme : le SKU Places réellement déclenché par les masques de champs était sous-facturé (Pro au lieu d'Enterprise + Atmosphere), et une garde CI refuse désormais tout appel tracké sans ligne tarifaire.

### Added

- **Groupes de contacts et « autres contacts »** (lot C) : cibler un groupe entier par son nom (« envoie un mail au groupe famille »), retrouver une personne croisée sans l'avoir enregistrée. Comptes de membres exacts (agrégat API, jamais dérivés d'une page).
- **Créneaux libres** (lot B) : recherche de disponibilités sur une fenêtre, via freeBusy chez Google (moins de données lues que les événements eux-mêmes) et par projection début/fin minimisée chez les autres fournisseurs.
- **Visioconférence à la création d'événement** (lot A) : Meet chez Google, Teams chez Microsoft, ignoré proprement chez Apple. Le lien n'est annoncé que si le fournisseur l'a réellement créé.
- **Réglages Gmail** (lot I) : lecture du répondeur, des filtres et des alias ; activation/désactivation du répondeur d'absence et création de filtres, tous deux sous confirmation. Le scope `gmail.settings.basic` rejoint la demande d'autorisation (reconnexion Gmail nécessaire).
- **Sheets et Docs** (lot F) : lire le contenu d'un tableur ou d'un document pour répondre, puis y écrire sous confirmation — ajout de lignes ou mise à jour d'une plage, ajout de texte en fin de document. Aucun nouveau consentement (le jeton Drive suffit).
- **Google Weather et Google Environnement** (lot E) : deux services plateforme activables d'un interrupteur, sans clé personnelle. La météo Google est normalisée à la frontière du client, si bien que les dix-neuf surfaces qui consomment déjà la météo fonctionnent à l'identique quel que soit le fournisseur actif.
- **Qualité de l'air et pollens sur les cartes météo et lieu** : indice national privilégié quand il existe, catégorie de l'API affichée verbatim, types de pollen en saison seulement.
- **Filtrage d'URL par Google Web Risk** (lot D) : toute adresse que LIA s'apprête à ouvrir est vérifiée ; une adresse signalée est refusée avec un message localisé. Indisponibilité du service = navigation inchangée, jamais bloquée.
- **Vignettes Street View** (lot SV) : proposées quand l'imagerie existe réellement — la métadonnée gratuite est interrogée avant tout appel facturé.
- **Notifications push Google** (lot H) : canaux Calendar/Drive et Pub/Sub Gmail, registre en base, renouvellement planifié, invalidation ciblée des caches, purge des canaux orphelins. Désactivé par défaut.
- **Delta de nouveaux mails** (lot G) : le battement de cœur détecte les nouveaux messages par `history.list` ancré, au lieu de rejouer une requête à chaque tick.

### Fixed

- **Sous-facturation des recherches de lieux** : les masques de champs déclenchent le palier Enterprise + Atmosphere, pas le palier Pro qui était tarifé (25/40/40 $ au lieu de 17/32/32 $). Corrigé, avec une garde CI qui refuse tout appel tracké sans ligne tarifaire correspondante.
- **Données payées jamais affichées** : la carte d'un lieu recevait les attributs Enterprise + Atmosphere (services, parking, paiement, accessibilité, fourchette de prix exacte) mais une branche morte les jetait ; un lieu définitivement fermé pouvait aussi s'afficher comme un lieu normal.
- **Collision du cache de clients d'API** : la clé ne portait que l'utilisateur et le connecteur, si bien que deux classes de client partageant un jeton (Drive/Sheets/Docs, Gmail/réglages Gmail) pouvaient se voir servir l'instance de l'autre. Clé qualifiée par classe, garde dédiée.
- **Le travail de synchronisation des canaux push ne s'exécutait jamais au démarrage** : un déclencheur d'intervalle seul planifie sa première exécution un intervalle plus tard (six heures), et une API qui redémarre plus souvent que son intervalle n'ouvrait aucun canal. Même famille de défaut que l'ADR-178 ; corrigé par une première exécution ancrée après le démarrage, verrouillée par une garde.
- **Nom d'onglet contenant une apostrophe** : la notation A1 exige le doublement de l'apostrophe, sans quoi l'API refuse la lecture (`Bob's data`).
- **Titres d'événements en clair dans les journaux** : les exécutions de brouillon d'agenda écrivaient le titre au niveau INFO, contrairement à la règle interne sur les données personnelles.
- **Administration des connecteurs incomplète** : les deux services plateforme (Weather, Environnement) n'apparaissaient pas dans le panneau d'administration — un opérateur ne pouvait pas les désactiver. Ajoutés, avec une garde qui refuse toute future omission.
- **Traces du démonstrateur rejetées à chaque envoi** : son collecteur ne déclarait qu'un tuyau de métriques, si bien que le serveur acceptait la connexion sans jamais enregistrer le service de traces — chaque lot revenait en erreur dans les journaux. Le démonstrateur ne conserve aucune trace, par choix ; elles sont désormais acceptées et abandonnées explicitement, ce qui énonce le sort du signal au lieu de le laisser échouer. Une garde exige qu'un signal accepté ait toujours une destination déclarée.

### Changed

- **Rendu partagé pour la qualité de l'air et les pollens** : une implémentation unique sert la carte météo et la carte de lieu, pour que les règles d'honnêteté restent vraies aux deux endroits.
- **Une carte météo résiste à un contenu antérieur** : la page d'accueil met ses sections en cache jusqu'à une heure et un déploiement progressif peut servir une charge utile plus ancienne — les nouveaux champs sont lus défensivement.
- **Extraction structurelle** : les déclarations de manifestes d'agents quittent le chargeur du catalogue (659 → 343 lignes logiques), les enrichissements de carte de lieu (Street View, qualité de l'air) rejoignent un module cohésif, et la validation d'écriture de tableur est isolée — trois décompositions imposées par les cliquets de taille et de complexité, jamais un relèvement de plafond.
- **Tarification Google** : dix-huit points d'appel tarifés (météo, qualité de l'air, pollens, Street View, Web Risk et les variantes de recherche de lieux), documentés dans `GOOGLE_API.md`.
- **Chiffres publiés réalignés sur la mesure** : la page Récit annonçait encore 229 ADR, 210 versions et 23 900 tests, et le tableau de métriques du guide technique avait divergé d'une langue à l'autre. Tout est remesuré sur l'arbre publié — un tableau qui dérive par langue a cessé d'être une mesure. La ligne « fixtures réutilisables : 170+ », invérifiable dans les deux sens, cède la place au compte exact.

### Tests

- Suites complètes vertes : 20 478 tests backend collectés, 6 080 tests frontend, MyPy strict sur 1 216 fichiers, parité stricte des six langues.
- Nouvelles gardes de non-récurrence : clé de cache qualifiée par classe, première exécution du travail de synchronisation, couverture du panneau d'administration des connecteurs par rapport à la surface du backend, tarification seedée pour chaque appel tracké.
- Filet de caractérisation des aperçus de confirmation étendu aux cinq nouveaux types (répondeur, filtre, écriture de tableur, ajout au document), généré depuis l'implémentation puis épinglé au caractère près.
- Cas réels intégrés après mesure en production : indice national sans valeur numérique, charge utile de cache antérieure à l'enrichissement, nom d'onglet à apostrophe.

## [1.31.0] - 2026-08-21

**Le socle d'exécution passe à Python 3.14 et Debian trixie** (ADR-241). Toutes les surfaces d'exécution — venv de développement Windows, conteneur Docker dev, image de production arm64 rebâtie sur le Raspberry Pi 5, sandbox des skills et l'intégralité des jobs CI — convergent sur CPython 3.14 (build GIL standard) et `python:3.14-slim-trixie`. Le contrat devient mono-version (`requires-python = ">=3.14,<3.15"`) : le job CI `python-compat` (F041, Python 3.13) est retiré puisqu'il ne reste aucun second interpréteur à prouver, tandis que l'installateur self-host conserve son plancher 3.10 indépendant (ADR-215). La migration a été précédée d'un audit intégral : les 229 paquets épinglés des lockfiles universels vérifiés wheel par wheel sur PyPI pour les trois plateformes réellement installées (Windows x64, manylinux x86_64, manylinux aarch64), et la recompilation des locks prouvée par dry-run avant application — delta strictement égal à `+audioop-lts==0.2.2`, zéro version changée.

**Une régression silencieuse de longue date est fermée au passage.** Le module stdlib `audioop` ayant été retiré en Python 3.13, `import pydub` échouait déjà sur les postes de développement — la voie des messages vocaux Telegram (OGG → PCM → transcription) ne tenait en production que parce que Docker restait en 3.12, et aucun test ne l'aurait signalé. `audioop-lts` rejoint le manifeste, et trois gardes de non-récurrence verrouillent définitivement les deux classes de défaut révélées par l'audit : chaque surface encodant la version de l'interpréteur (pyproject, Dockerfiles, flags uv, PYTHONPATH sandbox, workflows) est asservie au plancher `requires-python` — falsifiée dans les deux sens avant adoption —, chaque dépendance native compilée doit s'importer sur l'interpréteur courant (audioop inclus), et la chaîne audio exacte de `_ogg_to_pcm_float` (ratecv/tomono/lin2lin) est épinglée par des tests hermétiques sans ffmpeg.

**Et le réveil d'une suite de charge endormie a débusqué un vrai défaut d'équité du limiteur de débit distribué.** Le membre du ZSET de la fenêtre glissante était le timestamp seul : deux requêtes tombant dans la même microseconde — routinier sous processus concurrents — entraient en collision, `ZADD` écrasait au lieu d'ajouter, `ZCARD` sous-comptait et le limiteur sur-admettait (mesuré 23/20 et 120/100 sur la suite multiprocess réelle, silencieusement skippée depuis novembre). Le membre est désormais unique par requête (préfixe timestamp conservé), la collision est épinglée par tests unitaires à horloge gelée, et la suite multiprocess tourne verte sous forkserver Linux comme sous spawn Windows.

### Fixed

- `import pydub` cassé sur tout interpréteur ≥ 3.13 (stdlib `audioop` retirée) — voie vocale Telegram menacée de casse silencieuse en production après migration ; corrigé par `audioop-lts==0.2.2` et prouvé de bout en bout sur l'image cible.
- **Rate limiter Redis : sur-admission sous rafales concurrentes** — member de fenêtre glissante non unique ; corrigé (`timestamp:uuid`), prouvé par la suite multiprocess réactivée (rouge avant, 3/3 verts ×2 plateformes après).
- **Provenance runtime en prod** — l'image portait la bonne identité de build (APP_VERSION/SHA) mais `env_file: .env` l'écrasait au `up` avec des valeurs d'exemple mortes (le pré-déploiement servait « 0.0.0-dev ») ; le `deploy.sh` généré réconcilie désormais `.env` avec `provenance.env` (upsert idempotent, sûr sous `set -e`, newline-safe), couvert par tests Pester dont l'exécution réelle du bloc.
- **Chemin de lancement Windows sans reload** — cassé silencieusement depuis le passage d'uvicorn aux `loop_factory` (la policy posée n'avait plus aucun effet, et la factory asyncio d'uvicorn retourne Proactor sur win32, que psycopg refuse) ; la branche `__main__` pilote désormais `Server.serve()` sous `SelectorEventLoop` explicite, prouvée contre le PostgreSQL réel et épinglée par tests. Le chemin `--reload` quotidien n'a jamais été touché (le subprocess de reload obtient déjà Selector).
- Une annotation `"ToolRuntime"` nue mais entre guillemets échappait à la garde ADR-231 (qui inspecte les nœuds AST, pas les chaînes) — paramétrée en `ToolRuntime[LiaRuntimeContext, Any]` comme partout ailleurs.
- La collecte pytest en conteneur crashait avant même l'esquive prévue « pas de racine monorepo » : `tests/conftest.py` supposait quatre niveaux de profondeur (`parents[3]`) inexistants sous le montage plat `/app`.

### Changed

- Yeux expressifs (ADR-240) : moteur d'inactivité affiné — respiration cadencée par famille d'humeur, regard piloté en variables CSS (`--gaze-x/y`), émotes flottantes extraites en composant dédié, couverture de branches des stores à 100 %.
- Dépendances : retrait de `passlib[bcrypt]`, `slowapi`, `types-passlib` (mortes — le hashing utilise bcrypt en direct depuis longtemps) et de leurs transitifs `limits` et `deprecated` ; `bcrypt==5.0.0` devient une déclaration directe du manifeste (il n'arrivait que par l'extra passlib). Cinq paquets de moins dans le runtime, zéro version changée (ADR-112).
- Dépréciations Python horizon 3.16 purgées : `inspect.iscoroutinefunction` (5 sites), `get_running_loop()` (4 sites), plus aucune API de policy d'event loop dans le dépôt. Warnings de la suite rapide : 1 151 → 35.
- Images API dev/prod : `python:3.12-slim-bookworm` → `python:3.14-slim-trixie` (7 `FROM`), dépôt apt Docker CE `bookworm` → `trixie`, et les cinq bibliothèques Chromium renommées par la transition time64 de Debian 13 (`libasound2t64`, `libcups2t64`, `libatk1.0-0t64`, `libatk-bridge2.0-0t64`, `libatspi2.0-0t64`).
- Contrat et outillage : `requires-python ">=3.14,<3.15"`, cibles black/ruff `py314`, mypy `python_version 3.14` (0 erreur sur 1 177 fichiers), lockfiles recompilés plancher 3.14 (ADR-112). Balayage mécanique : 408 corrections ruff auto-appliquées (UP037 en tête — PEP 649 rend les annotations entre guillemets inutiles) et 93 fichiers reformatés par black.
- CI : les 11 setups Python des trois workflows passent à `"3.14"` ; le job `python-compat` et son entrée `CI_ONLY` sont retirés.
- Sandbox skills : le PYTHONPATH par défaut suit l'interpréteur (`/home/appuser/.local/lib/python3.14/site-packages`), constante, exemples `.env` et tests alignés.

### Tests

- Trois nouveaux fichiers (39 tests) : garde des surfaces de version (source de vérité unique = plancher pyproject, exemption étroite et assertée du plancher 3.10 installateur), smoke d'import des ~31 wheels natifs (uvloop/httptools prouvés côté POSIX en conteneur), pipeline audio Telegram hermétique (48 kHz stéréo → 16 kHz mono 16-bit).
- `test_voice.py` dépollué : le hack module-level `sys.modules.setdefault("pydub", MagicMock())` (datant de l'époque où pydub était inimportable) contaminait toute la session pytest séquentielle — remplacé par des `patch("pydub.AudioSegment.from_ogg")` par test, scope-safe, désormais possibles puisque pydub s'importe réellement partout.
- Les 3 tests multiprocess du limiteur tournent à nouveau (le garde-fou `pytest._redis_available` n'était défini nulle part — skippés en silence depuis 2025-11, invisibles au guard des skips permanents) ; c'est leur réveil qui a débusqué le bug de sur-admission.
- 17 gardes repo-level convertis à `tests/_repo_paths.repo_root_or_skip()` (dont un `parents[6]` et une fonction maison dupliquée) : la collecte en conteneur passe de 16 erreurs à 0, 46 modules skippent proprement sous le montage plat `/app` ; comptes hôte/CI inchangés (296 verts).
- Nouveaux tests ciblés : unicité du request_id à horloge gelée (2), branche de lancement `__main__` win32 (2), upsert de provenance Pester (exécution réelle du bloc : remplacement, ajout, newline manquant, idempotence, no-op, sous `set -e`).
- Ratchet de complexité frontend verrouillé à la baisse (46 fonctions ≥ 15, max 59 — gain des vagues précédentes, doctrine shrink-only).
- Les tests multiprocess (rate limiter Redis) ont été exécutés réellement dans le conteneur 3.14 — compatibles avec le nouveau start method Linux par défaut (forkserver) ; suites complètes vertes sur 3.14 : 18 035 unitaires rapides, 1 126 agents, couverture 69,1 % (plancher 67 maintenu, marge < 2 pts).

## [1.30.16] - 2026-08-20

**L'assistant gagne un regard** (ADR-240). Deux yeux cartoon pleins habitent désormais la page de chat — un widget flottant, déplaçable au pointeur comme au clavier, redimensionnable, masquable en un point de rappel. Vingt expressions dérivées d'une chaîne de priorités pure (`erreur > question HITL > voix > interaction > réaction > notification > frappe > inactivité > humeur × heure`), toutes issues de **signaux qui existaient déjà** : la machine à états du chat, les étapes d'exécution SSE (réflexion vs recherche d'outil), la carte HITL, la machine vocale, les notifications, la psyché. Zéro endpoint, zéro migration, zéro appel LLM supplémentaire. La réaction à chaque réponse lit le **self-report émotionnel du tour** (le modèle qui a écrit la réponse l'évalue lui-même) avec un repli heuristique neutre en langue — ponctuation, émojis, structure, pleine chasse chinoise incluse — pour couvrir la course du calcul psyché et les comptes psyché-off.

**Une vie de personnage, pas une animation d'état.** Entre deux événements, les yeux vivent : clignements à cadence humaine (doubles occasionnels), errance du regard en saccades et coups d'œil qui balayent parfois la pièce, neuf gestes pondérés par famille d'humeur (un somnolent ne bondit jamais, un excité ne cligne jamais paresseusement), mini-scènes de songe et de rêverie, et — rarement, la rareté fait le gag — des facéties : échange de places en arc de cirque, entrechoc avec squash à l'impact, pirouette, tremblote gélatine. Les astuces d'atelier d'animation sont là : **blink de masquage** sur chaque changement d'expression, dynamiques d'arrivée par émotion (la tristesse s'installe en 950 ms, un réflexe claque en 190), émotes flottantes (« ? », « ! », « z » qui dérive, « … »), réveil en sursaut quand l'activité surprend des yeux endormis, écarquillement quand on attrape le widget. Toute la géométrie est en **morphs lisses** (aucun clipping — un œil mi-clos est un ovale plus court, jamais un rectangle), et un invariant testé garantit le retour exact à la position d'origine, quelles que soient les animations interrompues.

**Six regards au choix** — Réglages › Préférences › Personnalisation › Style des yeux. Cozmo (écrans lumineux, le défaut), Capsules, Billes, Amande, Traits kawaii, Anneaux à pupille mobile : six feuilles de recettes sur le même squelette, présentées avec des **aperçus vivants** (le neutre respire, la joie rebondit). Le registre est générique par construction : ajouter un style = un id, un bloc CSS scopé, six entrées de locale — un test de complétude refuse tout style incomplet, et un style persisté disparu retombe proprement sur le défaut.

**Le bandeau du chat s'allège.** Les yeux se posent par défaut entre le champ de recherche et le badge des connaissances RAG (repère responsive : la forme visible du contrôle gagne), re-mesurés en continu, avec un ordre de clamp qui interdit de recouvrir un contrôle — la classe de piège que les parcours navigateur ont attrapée deux fois. La pilule ambre « Traitement… » disparaît : cet état vit désormais dans les yeux, en plus riche (réfléchir, chercher, répondre sont trois regards différents) ; la pilule hors-ligne reste, elle dit quelque chose que les yeux ne disent pas. La courte phrase d'attente à côté des points de frappe disparaît aussi — le mouvement suffit.

### Added

- **Widget yeux expressifs** (`components/eyes/` : moteur pur à RNG/horloges injectés, rendu déclaratif, feuille d'animation `styles/eyes.css`, hooks comportement/drag/ancre/parallaxe) + `chatStatus` exposé par `useChat` (additif) + enregistrement du type d'étape dans le handler SSE `execution_step`.
- **Registre de styles d'yeux** (6 styles, complétude CSS+i18n testée) + **section Réglages « Style des yeux »** (aperçus animés par style, jeton de lien profond `eyes-style`, recherche des réglages et icône câblées, préférence d'affichage par appareil).
- **Vie idle complète** : gestes pondérés par humeur, saccades pendant la parole, mini-scènes (`IDLE_FLICKERS`), facéties (`swap`/`bump`/`spin`/`jelly`, ~6 % des tics), performances scriptées (réveil en sursaut), émotes flottantes, parallaxe curseur desktop à expiration.
- Préférences persistées du widget (visibilité, taille `auto` — petite mobile / grande desktop —, position en % viewport re-clampée, style) sous une clé localStorage documentée hors registre de purge SEC-035.

### Changed

- Position par défaut du widget ancrée entre recherche et badge RAG (mesure vivante : resize, ResizeObserver, battement), clamp prioritaire anti-recouvrement ; barre d'outils du widget sur survol/focus au desktop et sur tap au tactile (masquage auto, inerte quand cachée).

### Removed

- Pilule « Traitement… » du bandeau de chat (l'état vit dans les yeux ; la pilule hors-ligne, actionnable, reste) — clé `chat.input.status.processing` purgée des 6 locales.
- Phrase d'attente teintée par l'humeur à côté de l'indicateur de frappe (Lot 1-A5, v1.30.14) — retirée sur décision produit : l'indicateur parle par le mouvement seul ; clés `chat.ack.*` purgées des 6 locales.

### Fixed

- Oracle de test de l'indicateur de frappe rendu déterministe (la variante ✦ est une forme, pas une phrase — flaky 1/6 éliminé) ; garde de complétude des styles lue depuis le disque dans le corps du test (les imports CSS `?raw` sont vidés par le pipeline vitest ; une lecture top-level transformait l'échec en erreur de collecte illisible).

### Tests

- ~180 tests neufs (matrice exhaustive du moteur d'expressions, stores, chrome du widget, câblage par tour, ancrage double-repère avec clamp, registre de styles, section Réglages, invariant de retour du regard) — tous à RNG injecté et horloge épinglée, aucun n'attend une animation. Suites : 19 335 backend collectés (inchangé — release 100 % frontend), 6 038 vitest, suite e2e complète 185 parcours (chat, axe, réglages, parcours publics) contre le build de production, couverture frontend re-verrouillée (planchers 74/69/71/74).

## [1.30.15] - 2026-08-20

**Les logs de production deviennent un contrat.** Une analyse systémique de sept jours de journaux (Loki par tranches de 24 h, docker, base et métriques croisées) a recensé, qualifié puis traité **douze constats** — chacun vérifié par la donnée avant tout correctif, plusieurs hypothèses plausibles réfutées en route (le « 0 visiteur » du rapport du démonstrateur est un vrai zéro structurel : la pile était éteinte et le lien public désactivé — personne ne _pouvait_ s'inscrire ; le compte n'a jamais menti).

**Le temps réel n'épuise plus l'infrastructure** (incident du 14-15/08). Le churn EventSource d'un seul client mobile avait accumulé des dizaines de flux de notifications à moitié morts, chacun épinglant une connexion du pool Redis, jusqu'à dégrader SSE, caches et élection du scheduler pendant des heures — sans déclencher une seule alerte. Trois réponses d'un coup : un **plafond de flux par utilisateur** où le plus récent gagne (le flux évincé l'apprend par un événement `superseded` et se ferme ; la nouvelle connexion n'est jamais refusée — EventSource ne sait pas lire un statut HTTP, un refus nourrirait une boucle de retry aveugle) ; côté navigateur, un onglet visible reprend sa place immédiatement, un onglet caché attend d'être regardé ; et l'alerte `RedisConnectionPoolExhaustion` **renaît sur le signal direct** — l'ancienne vivait dans un fichier jamais chargé avec un seuil mathématiquement impossible (>142,5 sur un ratio borné à 100) : elle ne pouvait pas sonner, et n'a pas sonné.

**Une interruption n'est pas une panne.** Chaque approbation HITL était journalisée en ERROR par les décorateurs de métriques — traceback, contenu du brouillon et destinataires inclus (PII au niveau ERROR), compteur d'erreurs faussé. Le `GraphInterrupt` est désormais reconnu comme du contrôle de flux dans les quatre wrappers : DEBUG sans payload, aucun compteur consommé (le nœud repris est compté une fois, à sa complétion), propagation intacte. Même doctrine côté flux : le pseudo-nœud `__interrupt__` (delta en tuple **par conception**) cesse d'être signalé comme anomalie.

**Les bornes des fournisseurs sont réparées avant l'appel** (doctrine ADR-184). Brave rejette toute requête au-delà de 400 caractères ou 50 mots : la requête est désormais **tronquée au mot** au point de passage unique du client, et la borne est publiée dans la description des outils — le planner ne peut plus être blâmé d'ignorer une limite qu'on ne lui montrait pas. OpenWeatherMap répond 404 pour un lieu qu'il ne connaît pas : c'est un **verdict « aucun résultat »**, plus une exception — le repli Google Geocoding et le chemin « lieu introuvable » redeviennent atteignables au lieu d'un traceback brut offert au modèle. Et les recherches web adossées à Perplexity gagnent leur **famille de timeout dédiée** (60 s plancher / 180 s plafond, réglables) : le générique de 30 s tuait des synthèses légitimes en plein vol.

**Le funnel de la vitrine dit enfin la vérité.** La colonne `event_type` (32 caractères) était plus courte que le vocabulaire par-mission qu'elle devait stocker (39) : chaque INSERT échouait en silence depuis six semaines — colonne élargie, et une **garde dérivée** enum↔colonne rend la classe de bug impossible. Le clic vers l'instance libre devient un événement mesuré (`demo_live_clicked`) : « 0 inscription » et « personne n'a cliqué » seront enfin distinguables.

### Added

- **Plafond de flux SSE par utilisateur** (`notifications/stream_registry.py` : ZSET newest-wins, fail-open à chaque étage — une panne Redis dégrade en « pas de plafond », jamais en flux tué), événement `superseded`, réglage `SSE_MAX_STREAMS_PER_USER` (défaut 8 : l'app ouvre deux flux par onglet), reprise pilotée par la visibilité dans `useNotifications` et `BroadcastProvider` — et correction au passage du marqueur multi-onglets du health-check OAuth (supprimé seulement par le dernier flux).
- **Alerte core `RedisConnectionPoolExhaustion`** sur `MaxConnectionsError` au limiteur global (template + seuils ×3 environnements + cas promtool déclenchement/silence + runbook réécrit) ; `REDIS_MAX_CONNECTIONS` relevé à 200 en production.
- **Famille de timeout « web research »** (`unified_web_search_tool`, `perplexity_*`) : `WEB_RESEARCH_TOOL_TIMEOUT_SECONDS` / `MAX_WEB_RESEARCH_TOOL_TIMEOUT_SECONDS`, plancher opposable au planner comme les familles image/document.
- **Événement showroom `demo_live_clicked`** (enum + collecteur sans identifiant + clic CTA de l'invitation live) — le barreau amont du funnel vers l'instance libre.
- **Garde dérivée vocabulaire↔colonne** sur `product_events` (l'enum le plus long doit tenir dans `String(n)` lu du modèle — le test rougit avant que la production ne perde des lignes).

### Fixed

- **Interruptions HITL journalisées en ERROR avec PII** : carve-out `GraphInterrupt` dans les quatre wrappers de métriques (nœud/outil × async/sync) — DEBUG nom+durée seulement, compteurs intacts, propagation inchangée ; pseudo-nœud `__interrupt__` skippé dans le mode `updates` du streaming.
- **Recherche Brave en échec 422** sur requête verbeuse du planner : tronquage au mot aux bornes vendor (400 c. / 50 mots) au chokepoint client, borne publiée aux producteurs.
- **Géocodage OWM 404 traité en erreur inattendue** : `geocode()`/`reverse_geocode()` renvoient `[]` (verdict structurel, jamais du string-matching) — repli Google réactivé, plus de traceback dans le prompt.
- **Funnel showroom par-mission silencieusement perdu** : `product_events.event_type` élargi `String(32)` → `String(64)` (migration `8a9b0c1d2e3f`, rejouée depuis une base vierge ; downgrade purge-avant-rétrécir).
- **Bruit de boot et d'exploitation** : `get_calls_tool` enregistré avant son agent (l'agrégateur de manifestes passe après les blocs flag-gated, ordre verrouillé par test) ; répertoire `grafana/provisioning/alerting` livré (93 ERROR/7 j pour un dossier absent) ; logger `mcp.client.streamable_http` abaissé à ERROR (le DELETE de session non implémenté par un serveur tiers n'est pas notre warning).

### Changed

- Politique de timeout par famille extraite vers `orchestration/step_timeouts.py` (module pur, `parallel_executor` gelé fond de 2174 → 2158 SLOC — extraction, jamais relèvement de cap) ; en-têtes du cœur d'alerting dé-numérisés (les compteurs en dur dérivaient : « 12 » et « 14 » pour 17 règles réelles).

### Tests

- ~80 tests neufs (registre de flux et câblage éviction/marqueur, interrupts des quatre wrappers avec oracle anti-PII, clamp Brave aux bornes, verdicts 404 OWM, capacité colonne dérivée, familles de timeout, ordre d'enregistrement du catalogue, éviction côté front pilotée par visibilité, collecteur `demo_live_clicked`) + deux cas promtool (déclenchement type incident / silence sous seuil). Suites : 19 335 backend collectés, 5 869 vitest, couverture 68,84 % ≥ 67, lint complet vert, preuve runtime conteneur (boot sain, zéro bruit corrigé).

## [1.30.14] - 2026-08-20

**Le travail invisible devient visible** (ADR-234). LIA notifiait, consolidait, détectait, suivait — et rien ne le montrait. La nouvelle page **Activité** agrège en un fil chronologique unique tout ce que l'assistant a fait de sa propre initiative : notifications proactives, découvertes d'intérêts, notes de journal automatiques, habitudes détectées, engagements ouverts et clos, routines exécutées. Doctrine briefing (fetchers parallèles à session propre, zéro LangGraph, zéro table, zéro LLM) et comptage ADR-185 de bout en bout : totaux exacts `COUNT(*)` par type, cap par source **déclaré** (`truncated`), source en panne **listée** (`failed_kinds`) — jamais complétée en silence. Les rappels sont absents à dessein : un rappel délivré ne laisse aucune trace persistée, et un compte sans trace serait une invention.

**La mémoire vieillit sans réécrire l'histoire** (ADR-235). Les chemins automatiques de correction étaient destructifs : l'update d'extraction écrasait en place, la fusion de consolidation supprimait le perdant. Deux colonnes (`invalidated_at`, `superseded_by_id`) transforment chaque correction en **supersession** : l'ancien fait quitte le set actif en pointant son successeur, toutes les lectures filtrent les faits vivants (oracle : SQL compilé de chaque méthode du repository), la piste se purge après rétention. Le PATCH manuel garde son autorité — une correction de l'utilisateur n'est pas une évolution à historiser contre lui. Et chaque souvenir injecté porte désormais son **ancre de date** : « la semaine dernière, tu me disais… » devient possible, une référence par réponse au plus, jamais sur un souvenir sensible.

**L'assistant apprend COMMENT travailler pour son utilisateur** (ADR-236). Septième catégorie de mémoire `procedural` : une instruction durable explicite (« réponds plus court », « ne me propose plus X ») devient une règle injectée en tête de chaque conversation — lisible, éditable et supprimable dans le panneau Mémoires (catégorie « Règles et directives »). Une instruction contradictoire supersède l'ancienne au lieu de la dupliquer. La directive de **réparation** complète la boucle : une correction est reconnue une fois, sans sur-excuse, et appliquée dans la même réponse — le changement visible de comportement est l'excuse.

**La voix respire, et le briefing se lit à voix haute** (ADR-237). La prosodie ElevenLabs suit l'humeur vive du moteur psychologique (éveil → expressivité, bornes dures, bande morte anti-scintillement, flag) — les réglages administrés restent la base, l'humeur les infléchit sans jamais les remplacer. Le bouton **Écouter** de la synthèse du briefing lit le texte affiché (`POST /briefing/synthesis/audio`, borné en coût, tracké, bufferisé pour que l'échec soit une vraie erreur HTTP — un flux muet lève au lieu de répondre 200 vide). Pendant l'attente d'une réponse, une courte phrase d'accueil teintée par l'humeur remplace le silence. Deux constats vérifiés-déjà-satisfaits sont consignés pour ne jamais être re-proposés : les stades relationnels modulent déjà la forme, la clause `<InnerVoice>` module déjà longueur et chaleur.

**L'autonomie grandit dans le cadre** (ADR-238). La 6ᵉ section du hub Alertes, **Propositions**, expose les offres de routine non tranchées : accepter ouvre le chat prérempli (rien ne part sans l'utilisateur — HITL intact), refuser nourrit les signaux bayésiens existants — l'inbox est une **vue**, jamais une seconde autorité, en pull pur donc sans pression d'éligibilité. Le budget d'itérations ReAct devient **adaptatif** (opt-in) : le plafond configuré reste le plafond, le budget par tour suit l'étendue en domaines de la requête, et une complexité inconnue reçoit le plafond — on n'économise que sur le prouvé-simple. Le garde de répétition exige une phrase de diagnostic avant l'action suivante (Reflexion au coût zéro), et l'évidence de calibration des futurs seuils adaptatifs s'accumule (`adaptive_candidate_top_score{perimeter}`).

**La clôture est honnête** (ADR-239) : l'ambient événementiel est **requalifié déjà-satisfait** (les actions conditionnelles ADR-175 portent l'idempotence par empreinte et ne paient le LLM qu'au déclenchement ; la variante sans opt-in est rejetée au nom de la souveraineté), et chaque chantier réservé porte son déclencheur écrit — maquette pour les missions à jalons, taux de faux-succès mesuré pour le critic, revue de contenu pour les skills compilés et les goûts dérivés.

### Added

- **Page Activité** `/dashboard/activity` (domaine `activity/` en lecture pure : builders SQL testés par compilation, service à pannes partielles déclarées, flag `ACTIVITY_TIMELINE_ENABLED`) + portes d'entrée : CTA du hub Alertes et pied de la carte « Pour vous ».
- **Supersession mémoire** : migration `7f8a9b0c1d2e` (2 colonnes + index actif, rejouable depuis une base vierge), `supersede_with_update`/`invalidate_memory` avec gardes pinned/stale, purge de la piste (`MEMORY_INVALIDATED_RETENTION_DAYS`), census de la consolidation (`memory_consolidation_pairs_total{outcome}`).
- **Catégorie de mémoire `procedural`** (extraction à critères stricts, en-tête de section juste après les zones sensibles, complétude enum↔fichier assertée) + administration complète dans le panneau Mémoires (source unique `MEMORY_CATEGORIES`, sélecteurs factorisés).
- **Prosodie paramétrique** (`voice/prosody.py` pur, `VOICE_PSYCHE_PROSODY_ENABLED`) et **lecture audio du briefing** (`voice/text_readout.py` possède le readout complet : tracking, cycle de vie du service, sanitation) + bouton Écouter avec états jouer/arrêter et message d'échec dédié ×6.
- **Inbox Propositions** : `GET /heartbeat/offers` (offres non décidées, fenêtre `HEARTBEAT_OFFERS_WINDOW_DAYS`), 6ᵉ section du hub + 6ᵉ badge dans la lecture unique des compteurs, décision via le feedback existant (bump bayésien ADR-214 conservé).
- **Budget ReAct adaptatif** (`react_budget.py` pur, `REACT_ADAPTIVE_BUDGET_ENABLED` défaut off, clé d'état déclarée `react_max_iterations_effective`) + étape verbale Reflexion dans le garde de répétition.
- **Jalons d'habitudes** : `habits/streaks.py` pur (grâce aujourd'hui/hier, dates futures ignorées), `HABITS_STREAK_MILESTONES`, bloc série/record/prochain jalon dans le panneau Habitudes.
- **Provenance des initiatives** : champ `motivation` (structured output → handoff générique `PerRunHandoff[T]` → SSE + métadonnées archivées) affiché sous les puces de suivi.
- **Accusé psyché** : phrase d'attente modulée par la valence (`chat.ack.*` ×6) dans l'indicateur de frappe — zéro fetch, zéro LLM.
- **ADR-234 → ADR-239** (timeline, supersession, mémoire procédurale, prosodie+readout, inbox+budget, clôture).

### Fixed

- **Lecture audio muette répondue 200** : un readout sans chunk (provider TTS en échec — les erreurs par phrase sont avalées par conception en mode chat) lève désormais, n'est jamais facturé, et le front affiche une erreur explicite — l'absence d'exception n'est pas une preuve de livraison.
- **Badge Propositions « — » éternel** : la dataclass des compteurs du hub avait gagné `offers` mais pas le schéma de réponse API — attrapé par la revue visuelle, verrouillé par un test de complétude dataclass ⊆ schéma.
- **Nœud `memory` de la constellation en sur-comptage** : depuis la supersession, les faits invalidés restaient comptés — le nœud filtre le set actif (même chiffre que le panneau).
- **Libellé brut `memories.categories.procedural`** : l'insertion i18n avait atterri sous le mauvais parent JSON — corrigée ×6 avec assert par parse du chemin exact, et un test-filet charge désormais les 6 locales réelles contre `MEMORY_CATEGORIES`.
- **Cycle d'import `briefing↔chat`** introduit par le premier jet du readout — cassé par extraction vers le domaine voice (garde F009).

### Changed

- Les messages du garde de boucle ReAct exigent une phrase de diagnostic avant le changement d'approche ; l'extracteur mémoire supersède au lieu d'écraser ; la consolidation supersède au lieu de supprimer ; les en-têtes du profil psychologique gagnent la section « Règles de fonctionnement ».
- Surface anonyme du démonstrateur : `GET /heartbeat/offers` et `POST /briefing/synthesis/audio` consignées par décision écrite dans le garde des routes exposées.

### Tests

- ~155 tests neufs (fusion/pagination pure, mappers et SQL de la timeline, supersession et filtres du set actif, streaks, handoff de motivation, prosodie, readout muet, offres, budget adaptatif, complétude des schémas et des locales réelles). Ratchets CC (deux passages 340→339 par décomposition, jamais par relèvement) et taille (extraction `initiative_schemas.py`) tenus. Preuves d'exécution réelles en conteneur : timeline sur données de production dev, supersession en transaction rollbackée, revue visuelle navigateur desktop + mobile (0 px de débordement).

## [1.30.13] - 2026-08-19

**Les boucles d'auto-amélioration se referment** (ADR-232). Un contre-audit de production des quatre boucles cognitives — journal personnel, habitudes, notifications proactives, ontologie inter-domaines — a vérifié chaque hypothèse par les données (PostgreSQL, Prometheus, Loki) puis par simulation exécutée : rejeu hors ligne du détecteur de rythme sur le ledger réel, rejeu de l'extraction de journal avec le LLM de production, Monte-Carlo du tirage de quotas. Trois boucles tournaient à vide, chacune pour une raison différente — et deux hypothèses plausibles ont été **réfutées** avant tout correctif (le détecteur d'habitudes est statistiquement juste ; les resets de conversation n'affament pas l'auto-évaluation).

**Le garde « ne pas interrompre un utilisateur actif » n'avait jamais fonctionné.** Il lisait un attribut qui n'existe sur aucun modèle, se rabattait sur une classe inexistante, et avalait l'`ImportError` dans un `success()` — prouvé par exécution : un utilisateur ayant écrit à la seconde même était déclaré éligible sans une seule requête. Le test unitaire restait vert parce qu'il posait l'attribut fantôme sur un mock non spécifié. Le garde est reconstruit en **port injecté** (`ActivityProbe`), câblé aux deux planificateurs (épinglé par test), et un échec de sonde se propage désormais au comptage d'échecs visible du runner — jamais un silence.

**Le journal apprend enfin de l'utilisateur.** Zéro signal preuve/contradiction depuis avril, alors que chaque maillon existait : l'entonnoir mourait sur un taux d'injection de 10 % (seuil global 0,63 face à des scores massés à 0,53–0,61) et sur une consolidation qui s'affamait elle-même (plancher absolu de 3 entrées quand l'élagage ramène les journaux à 2 — portraits gelés depuis juin). Le rejeu avec LLM réel a mis le prompt hors de cause : section présente → signal émis → compteur appliqué. L'éligibilité devient **pilotée par delta** (du travail existe : jamais consolidé, ou une entrée touchée depuis le tampon), les IDs du tour précédent rejoignent le filtre anti-hallucination (un signal visant une directive hors préfiltre était silencieusement jeté), et un **clamp épistémique** interdit la confiance « haute » à une directive L0/L1 sans preuve — la promesse du docstring devient du code.

**Les seuils deviennent adaptatifs par utilisateur** (`infrastructure/adaptive/`). Un contrôleur générique apprend le seuil d'injection du journal par utilisateur sous quatre garde-fous : bornes dures (0,55–0,70), hystérésis (un pas de 0,01 par 24 h maximum), observabilité (compteur + valeur effective publiée), kill-switch. État consultatif Redis à TTL glissant (90 j) ; lecture en échec → défaut statique, périmètre inconnu → erreur bruyante. Convergence simulée sur la distribution de production réelle : 0,63 → 0,60, taux 10 % → 24 %, zéro oscillation sur quatre profils — puis validée de bout en bout par un tour de chat réel.

**La barre de détection des habitudes est publiée.** `n_eff` ne dépend que du calendrier (25,4 en semaine, 10,28 le week-end sur fenêtre pleine) : le plancher Wilson dominait silencieusement le `presence_min` affiché — barre réelle 0,572 en semaine contre **0,699 le week-end**. Une contrainte appliquée est une contrainte publiée (ADR-184) : `effective_presence_bar` (arrondi par excès — la publication ne sous-estime jamais) est exposée dans l'API et le panneau Réglages, et le recensement des barrières de rejet du détecteur (`habit_window_rejected_total{day_class,gate}`) rend « pourquoi zéro habitude » lisible depuis Grafana. Publication sans recalibration : l'autorité des seuils reste le harnais de simulation.

### Added

- **Contrôleur de seuils adaptatifs** (`infrastructure/adaptive/threshold_controller.py`) : registre de périmètres validé à l'import (famille ADR-085), maths pures séparées de l'I/O, réglages `ADAPTIVE_*` (kill-switch, fenêtre, pas, intervalle, TTL). Premier périmètre : `journal_injection`.
- **Entonnoir d'auto-évaluation instrumenté** : `journal_self_eval_total{stage}` (no_previous_ids | section_built | section_empty | signaled), signaux comptés AVANT le filtre anti-hallucination — un écart signalé/appliqué reste visible.
- **Recensement des rejets du détecteur de rythme** : `habit_window_rejected_total{day_class,gate}` émis par une variante à diagnostics du détecteur (sortie prouvée identique) ; `initiative_actions_rejected_total{reason}` sur la validation lecture-seule ; `journal_confidence_clamped_total{source}` sur le clamp.
- **`effective_presence_min` publié** par classe de jour (schéma API + panneau Réglages Habitudes, i18n ×6) — répond à « pourquoi aucune habitude ? » là où la question se pose.
- **Test d'intégrité inverse du graphe de domaines** : tout pont d'IDENTITÉ (person_name, email_address, phone_number, physical_address, coordinate) non déclaré doit être une adjacence ou une entrée d'allowlist motivée ; cliquet en valeurs absolues sur les annotations sémantiques (≥125 paramètres, ≥145 sorties, ≥71 types consommés).
- **Adjacences `event→email` et `task→contact`** (ponts d'identité réels) — l'initiative peut envisager les invitations après un travail calendrier, les personnes après un travail tâches.
- **ADR-232** (fermeture des boucles) et **ADR-233** (simplification de l'ontologie).

### Fixed

- **Garde d'activité proactive mort** (D-01) : reconstruit en `ActivityProbe` injecté lisant le dernier message humain réel (lignes automatisées exclues, borné à l'horizon du cooldown) ; le swallow `except Exception → success()` est supprimé ; tests réécrits sur le **vrai modèle** `User`.
- **Consolidation du journal auto-affamée** (B-03) : éligibilité pilotée par delta, `JOURNAL_CONSOLIDATION_MIN_ENTRIES` 3 → 1 (un plancher > 1 ré-affame les journaux post-élagage) ; pas de boucle de churn — le tampon est postérieur aux actions du run.
- **Signal d'auto-évaluation jeté comme halluciné** (B-01) : les IDs vérifiés du tour T-1 rejoignent l'ensemble connu du filtre.
- **Confiance « haute » sans preuve** (B-06) : clamp serveur sur L0/L1 à `evidence_count=0` (L2/L3 libres — leur preuve est la convergence inter-entrées) ; le signal de preuve du même update est appliqué avant le clamp.
- **Sélection de candidats proactifs inéquitable** (D-05 requalifié) : drapeau d'activation poussé en SQL + `ORDER BY random()` — l'ordre de heap n'affame plus silencieusement les comptes au-delà du batch ; le pré-filtre horaire SQL est **refusé avec motif** (une timezone corrompue tuerait le lot entier).
- **Clés Redis adaptatives orphelines** : TTL glissant 90 j (un compte supprimé n'en laisse plus).
- **Docstrings mensongers** : la « continuité temporelle » du contexte journal (désactivée par défaut) et la pureté de `rhythm.py` (désormais réelle : `ProfileVerdict` extrait vers `verdicts.py`, le module s'importe sans variable d'environnement — le harnais de recalibration redevient exécutable hors application).

### Changed

- **Ontologie sémantique élaguée** (ADR-233) : Wu & Palmer, subsomption transitive, graphe SKOS et accesseurs par catégorie/outil supprimés — zéro consommateur runtime ; la surface vivante (`get`, `get_all`, `get_by_domain`, `validate_hierarchy`) reste testée. Prose d'auto-évaluation extraite vers `prompts/v1/` (octet pour octet). Décision B-08 documentée aux deux sites : les injections planner/ReAct restent hors de la boucle évaluée par conception.
- **Requalifiés avec preuve, aucune action** : coût de décision heartbeat (le contexte portait déjà l'historique ; 75 % de skips = jugement informé à ~0,09 €/7 j), affordance des puces de feedback (rendue sur les deux chemins — l'écart est d'adoption), fraîcheur de la jauge de niveaux (artefact de redémarrage).

### Tests

- +80 tests neufs (entonnoir, diagnostics de barrières, clamp, éligibilité delta, sonde d'activité sur vrai modèle, sélection SQL, contrôleur adaptatif — bornes/hystérésis/TTL/périmètre inconnu, barre effective avec calibration épinglée, ponts d'identité, surface vivante de l'ontologie). Suites : 19 894 backend collectés (F006 : zéro orphelin), 5 816 frontend, E2E réel login → SSE → observation Redis.

## [1.30.12] - 2026-08-19

**Le contexte d'exécution devient typé** (ADR-231). Le « qui, où, avec quelles préférences » d'une conversation circulait dans un sac non typé de 17 clés, écrit en un point et lu dans 43 fichiers — quatre clés privées non publiées, et la même identité sous **deux noms et deux types** (`user_id` en UUID d'un écrivain, en chaîne d'un autre, plus un doublon `langgraph_user_id` justifié par une intégration jamais installée). Il devient une dataclass gelée, construite en un point, injectée en quatre, validée à l'entrée du graphe : un contexte absent ou malformé **échoue bruyamment** au lieu de dégrader en silence — y compris à la reprise d'une confirmation, où l'absence passait inaperçue (mesuré, pas supposé). Les 145 annotations d'outils sont paramétrées ; l'ordre des deux opérations a été mesuré sur les quatre quadrants, car l'ordre inverse aurait pollué chaque appel d'outil d'un avertissement Pydantic.

**Un sous-assistant hérite désormais de TOUT le contexte, pas de 6 clés sur 17.** La projection manuelle du sous-agent ReAct perdait en silence la géolocalisation consentie, le message d'origine, l'identité d'expéditeur et huit autres valeurs — latent tant que la liste blanche d'outils par défaut ne les lisait pas, mais cette liste est configurable. Le sous-agent **dérive** maintenant le contexte du parent : le prochain champ ajouté sera porté sans qu'aucun code ne change ici.

**Agent Server v0.13 : étudié à fond, refusé** (ADR-231). Cinq bloquants indépendants, chacun vérifié : licence Elastic 2.0 incompatible avec l'AGPL de LIA dans un modèle qui charge le graphe hôte dans le processus serveur ; aucune version stable (uniquement des release candidates) ; redondance intégrale avec les sous-systèmes déjà durcis ; un plan d'autorisation qui ignore sessions d'appareil, MFA et plafonds ; et 17 services déjà sur le Raspberry Pi 5. La moitié « contextes » de la question n'a jamais eu besoin du serveur : elle est dans le paquet MIT déjà installé.

### Added

- **`LiaRuntimeContext`** : dataclass gelée de 17 champs, identité `uuid.UUID` unique, les quatre anciennes clés privées (`__deps`, `__browser_context`, `__user_message`, `__side_channel_queue`) publiées en champs nommés et documentés. Construite par un builder unique ; lue via ContextVar (traverse `asyncio.gather`, `to_thread`, `create_task` — vérifié avant d'être adopté).
- **Garde CI « contrat de schéma d'outil »** : chaque outil enregistré (105) doit se convertir vers le schéma OpenAI, et aucun argument injecté (`runtime`, `config`, `state`, `store`, `tool_call_id`) ne doit atteindre le modèle. Aucun test ne couvrait ce que le LLM voit réellement ; la garde a été prouvée capable d'échouer par trois mutations injectées.
- **Garde CI « annotation nue »** sur tout `src/` : une annotation `ToolRuntime` non paramétrée provoquerait un avertissement Pydantic à chaque appel d'outil une fois le contexte peuplé — la forme fautive échoue désormais en CI.
- **ADR-231** : la décision Agent Server (cinq bloquants), le chantier contexte, et la liste des constats réfutés — pour qu'aucune session future ne « corrige » un non-problème mesuré comme sain.

### Fixed

- **Perte silencieuse d'auto-save** : les deux chemins de sortie du décorateur `auto_save_context` résolvaient le `ToolRuntime` différemment — le chemin JSON ignorait un runtime positionnel et sautait sa sauvegarde sans un mot. Une seule résolution factorisée sert les deux.
- **Repli de langue codé en dur** : le sous-runner ReAct retombait sur `"fr"` et `"UTC"` en littéraux — un utilisateur germanophone pouvait recevoir un sous-agent francophone. Les replis lisent la configuration canonique.
- **Branches legacy mortes** : `auto_save_context` lisait le store un niveau au-dessus de là où il est écrit — un chemin qui ne pouvait que rendre `None`, et que plus aucun outil n'empruntait (105 inspectés).
- **Docstrings mensongers** : trois docstrings exigeaient des paramètres supprimés, deux commentaires du même bloc se contredisaient sur le lieu d'exécution, et le commentaire du contexte prétendait alimenter des outils qui ne le voyaient pas.

### Changed

- **langchain-core 1.5.6 + langchain-openai 1.5.2** (montée couplée : 1.5.2 exige core ≥ 1.5.6). Le risque nommé — une méthode privée de `langchain-openai` surchargée par le correctif DeepSeek local — a été clos par comparaison directe des signatures, pas seulement par des tests verts.
- **Plancher de couverture backend 66 % → 67 %** (mesuré 69,04 %), propagé aux trois déclarations qui portent la valeur.
- Migration sans casse vérifiée dans les deux sens : un fil interrompu avant la bascule reprend après, et un fil démarré après reprend avant (rollback testé) ; le contexte n'est jamais écrit dans les checkpoints.

## [1.30.11] - 2026-08-19

**La grille tarifaire des modèles s'édite désormais dans un classeur, pas ligne par ligne** (ADR-228). Le catalogue compte 124 modèles, chacun portant 24 caractéristiques et un tarif à quatre dimensions ; il s'administrait une boîte de dialogue à la fois. Mettre à jour une grille complète — ce qu'un fournisseur impose deux ou trois fois par an — demandait 124 allers-retours. L'export produit un classeur Excel avec listes déroulantes, notice traduite et validations ; le réimport montre **le diff champ par champ avant d'écrire quoi que ce soit**, et n'écrit rien tant que l'administrateur n'a pas relu. Une ligne absente du fichier ne supprime jamais rien : un filtre Excel oublié ne peut pas vider un catalogue.

**Deux erreurs de facturation qui tournaient en production sont corrigées.** L'instruction du chantier a montré que « le » tarif d'un modèle n'était pas défini : quatre chemins de lecture choisissaient sans ordre déterministe, et deux d'entre eux pouvaient rendre des prix différents **au même instant, sur la même base** — mesuré à un facteur 4 sur un modèle, et jusqu'à un changement d'unité de facturation sur un autre. Par ailleurs, un modèle dont le nom porte une date était facturé au tarif de son modèle de base même lorsqu'il possédait le sien : `gpt-4o-2024-05-13` coûtait 2,50 au lieu de 5,00 en entrée. Les deux sont réparés, et une contrainte en base empêche désormais le premier de revenir.

**Le classeur dit ce qui est, pas ce qu'on croit.** Un modèle sans tarif actif est facturé zéro en silence : le fichier l'écrit noir sur blanc. Un tarif fenêtré — les heures creuses de DeepSeek — apparaît **sur la ligne qui porte le prix**, et non sur un onglet que personne n'a de raison d'ouvrir.

### Added

- **Export du catalogue LLM en classeur Excel** : 27 colonnes, listes déroulantes alimentées par les référentiels, notice d'utilisation et libellés traduits dans les six langues.
- **Import en masse avec aperçu obligatoire** : le diff est groupé par nature (créations, modifications, désactivations, réactivations), replié avec ses compteurs, et ne montre que ce qui bouge — les lignes inchangées sont comptées, jamais listées.
- **Colonnes de diagnostic** en lecture seule : un modèle sans tarif, un modèle à tarifs multiples ou un modèle facturé sous un autre nom le disent eux-mêmes.
- **Réactivation d'un modèle désactivé** : `deactivate` n'avait aucun inverse, et un modèle éteint ne pouvait plus être rallumé depuis l'application.
- **Effacement explicite d'un prix de cache** : le contrat d'écriture avalait silencieusement l'intention, sur un champ vide dans 73 des 206 tarifs actifs.
- **Socle générique d'import/export tabulaire** (`infrastructure/tabular_io`) : décliner le mécanisme à une autre administration revient à écrire une déclaration de colonnes, pas du code de format.

### Fixed

- **Sous-facturation en production** : un modèle au nom daté possédant son propre tarif était facturé à celui de son modèle de base (facteur 2 en entrée, 1,5 en sortie).
- **Résolution non déterministe du tarif actif** : les quatre chemins de lecture trient désormais explicitement, et une contrainte d'unicité partielle interdit deux tarifs actifs pour un même modèle.
- **Taux de change dupliqués** : la route d'administration ne désactivait qu'une seule des lignes actives avant d'en insérer une nouvelle — cause racine de trois taux actifs simultanés. L'invariant a désormais une seule implémentation, partagée avec le planificateur quotidien.
- **Journaux trompeurs** : trois événements annonçaient un fait inexact — un taux « remplacé » là où il était créé, un tarif « inchangé » alors qu'une version venait d'être écrite, et un fichier « applicable » que la réponse refusait.

### Changed

- **La barre de la section Tarification LLM passe par `SectionToolbar`** (ADR-208) : ajouter export et import à la rangée artisanale précédente aurait empilé quatre boutons sur un téléphone.
- **Le seed de tarifs invalide avant d'insérer** : son `ON CONFLICT` ne portait que sur la date d'effet, si bien qu'un rejeu laissait deux tarifs actifs.

## [1.30.10] - 2026-08-18

**La carte des capacités devient la source unique de l'état — et ne peut plus prendre du retard** (ADR-229). La page « Capacités » publiait treize nœuds figés : la génération d'images, celle de **documents** (v1.30.8), les **plugins** (v1.30.7), les **habitudes apprises** (v1.28.0), les serveurs MCP et la téléphonie n'y figuraient pas. La surface censée répondre « ce que ton assistant sait faire » était donc la moins à jour de l'application, et elle lisait les drapeaux d'environnement bruts — elle pouvait annoncer disponible ce qu'un administrateur venait de couper. Elle passe à **dix-neuf capacités**, compose désormais le plafond de déploiement AVEC l'interrupteur opérateur, et un **assert au démarrage** refuse de booter si une capacité nouvellement ajoutée n'a pas décidé de son sort sur la carte : une consigne écrite se périme, un assert non.

**Les cartes de la Vue d'ensemble des réglages disent enfin où en est chaque section** (ADR-229, suivi d'ADR-227 arbitré par le propriétaire). « Mémoire — active, 128 éléments », « Connecteurs — à configurer » : la ligne vient du même agrégat que la carte des capacités, et dans les mêmes mots. Une requête pour tout le hub, pas trente ; et un silence assumé pendant le chargement, en cas d'échec, ou pour une section dont l'agrégat ne dit rien — une carte qui afficherait « à configurer » avant tout comptage accuserait un compte d'être vide.

**Le journal des versions arrive sur la page vitrine.** Les dernières livraisons s'affichent désormais en clair sur l'accueil, avec un lien vers l'historique complet resté dans la FAQ : un visiteur voit que le produit bouge avant même de créer un compte. Les deux surfaces lisent la même liste — une version ne peut plus apparaître ici et manquer là-bas.

### Added

- **Six capacités sur la carte** : images, documents, plugins, habitudes, serveurs MCP, téléphonie — avec leurs libellés dans les six langues, leur emplacement sur la constellation et leur lien « pas suivant ».
- **Ligne d'état sur les cartes de la Vue d'ensemble des réglages**, `aria-hidden` (le nom accessible reste la destination).
- **Section « Nouveautés » sur la page vitrine** et son entrée de navigation, après « Encore + ».
- **Section « Plugins » dans la FAQ applicative** (quatre questions × six langues) : la fonctionnalité était livrée depuis v1.30.7 sans que la FAQ en parle.
- **Carte « Les réglages, côte à côte » sur la page « Encore + »**, avec sa scène animée.

### Changed

- **« MCP Applicatifs » et « Serveurs MCP » passent dans Fonctionnalités › Extensions & Données** : un serveur qui donne de nouveaux outils à l'assistant l'étend, là où un connecteur relie un compte personnel. Les adresses (`?section=`) ne changent pas.
- La disponibilité publiée par la carte des capacités est l'**effective** : une capacité coupée par un administrateur disparaît des deux surfaces, et n'est même plus interrogée en base.
- La bande des versions est un composant **serveur**, comme toutes les autres de la page vitrine : aucun coût de bundle client, et des notes de version indexables.
- Les connexions entre utilisateurs rejoignent la table déclarative des capacités (elles étaient un cas particulier en trois endroits) : leur décompte passe toujours par le dépôt qui possède la règle « acceptée, dans un sens ou dans l'autre » (ADR-185).
- La scène « chaque réglage a une adresse » de la page « Encore + » montrait une ligne d'accordéon qui se déplie — un écran qui n'existe plus ; elle montre maintenant qu'un rechargement retombe sur le même panneau ouvert. La scène de la constellation passe de cinq à douze étoiles sur deux anneaux, comme la carte réelle.

### Removed

- **Le mode accordéon de `SettingsSection`** : plus aucune surface de production ne le rendait depuis ADR-227 ; il ne survivait que dans le gréement des tests. La prop `collapsible` disparaît des 38 composants qui la transportaient, `BaseSettingsProps` la perd, et le contexte de mode de coquille devient inutile (−444 lignes nettes).

### Fixed

- **Les descriptions des cartes de la Vue d'ensemble n'étaient pas tronquées** : `line-clamp-2` et `block` se disputaient la même propriété CSS et `block` gagnait, si bien qu'une description longue (le retour haptique) gonflait toute sa rangée. Mesuré au navigateur ; les cartes ont désormais la hauteur régulière qu'elles annonçaient.
- **« 12 élément(s) », « 12 capacité(s) active(s) »** : les quatre décomptes de la carte des capacités passent en vrais pluriels dans les six langues — ils s'affichent maintenant sur deux surfaces au lieu d'une.
- Les instructions de la FAQ décrivaient encore l'ancienne page de réglages (« ouvre l'onglet Préférences », « déplie Fuseau horaire », « une trentaine de sections repliées sur plusieurs onglets ») — faux depuis v1.30.9, dans les six langues.
- `core/config/document_generation.py` documentait un opt-in par utilisateur qui n'a jamais existé sur le modèle `User` : la carte s'apprêtait à publier un état « dormant » que personne n'aurait pu allumer.

### Tests

- +28 frontend (5 730 sur 455 fichiers) : table capacité ↔ section et son inverse dérivé, ligne d'état du hub (compte exact, dormant, sans tally, silence au chargement / à l'échec / hors périmètre, nom accessible), section changelog de la vitrine, constructeurs de clés du changelog partagé, contrat unique de `SettingsSection`.
- Backend : garde de couverture de la carte des capacités (partition de l'énumération, raisons écrites, modèles réellement résolus, emplacements de la constellation, liens « pas suivant », six locales) et sondes des interrupteurs opérateur — 47 assertions.
- e2e : la Vue d'ensemble affiche ce que chaque section contient, depuis un agrégat mocké portant un état vivant et un état dormant.

## [1.30.9] - 2026-08-18

**Les Réglages passent en master-détail — le rail est la carte, le panneau est le territoire** (ADR-227). La page empilait 51 sections en accordéons repliés sur deux ou trois onglets : rien n'était scannable, aucune description n'était visible avant d'ouvrir, et naviguer signifiait défiler. Elle devient une coquille master-détail, le patron vers lequel Linear, Slack, Notion et Stripe ont convergé pour des réglages riches : un **rail permanent** liste chaque section visible — groupée, icônée, chaque réglage à un clic à tout instant — à côté d'un **panneau** qui affiche la section choisie, ouverte en entier ; sans sélection, une **Vue d'ensemble** présente toutes les sections en cartes avec leurs descriptions, enfin visibles. Sur téléphone, le rail devient l'écran d'accueil et une sélection l'échange contre le panneau avec retour — le drill-down attendu. La recherche rapide s'installe en tête de rail et couvre désormais **l'administration** (phase 2 d'ADR-172 réalisée : les 15 sections admin deviennent cherchables et adressables par lien profond, pour les administrateurs seulement) ; `?section=` devient l'état de sélection — recharger ou partager l'URL retombe sur le même panneau. L'honnêteté d'ADR-172 survit en mieux : une section légitimement absente (instance sans MFA, aucun appel passé…) affiche un état vide explicite dans le panneau au lieu d'un toast, et continue de guetter — une donnée qui répond tard remplace le message. Sous le capot, la page ne liste plus rien à la main : elle se rend depuis les tables existantes et deux registres à complétude vérifiée par le compilateur, les ~330 lignes de layouts dupliqués disparaissent, et **une seule section monte à la fois** — les requêtes d'une section partent à sa sélection, plus au chargement d'un onglet entier.

**Les documents générés s'ouvrent désormais dans l'application** (amendement ADR-226). Un clic sur une carte de document ouvre une visionneuse dans un nouvel onglet : les CSV en vrai tableau, le markdown par le pipeline assaini du chat, le texte tel quel ; les formats natifs (xlsx, docx, pptx) présentent un panneau honnête avec téléchargement — et les PDF continuent de s'ouvrir directement dans le lecteur du navigateur. L'interrupteur d'opt-in par utilisateur disparaît (décision produit : la capacité se pilote au niveau de l'instance, côté administration) — la colonne est retirée du modèle par migration, et la section de réglages correspondante avec elle.

### Added

- **Master-detail settings shell (ADR-227)**: `SettingsRail`, `SettingsPane`, `SettingsOverview`, shell-mode context (the 50 section components are unchanged), compile-complete icon + renderer registries proven against each section's source, phone drill-down, `?section=` as selection state, honest inline absence with continued polling, one-shot focus ratchet for search picks.
- **Administration reaches search and deep links** (ADR-172 phase 2): 15 admin tokens with superuser gating and localized keywords in six languages; the "administration is not indexed" notice is gone because it stopped being true.
- **Document viewer page** (ADR-226 amendment): generated documents open in-app per type (csv table, sanitized markdown, plain text, native-format panel with download); PDF keeps the browser's native viewer.

### Changed

- The settings page mounts ONE section at a time: a section's requests fire on selection instead of ~20 sections fetching on tab load; opening a section scrolls to the top of the pane (instant, `prefers-reduced-motion`-safe).
- The per-user document-generation opt-in is removed (instance capability remains); migration drops the column.

### Fixed

- A search pick no longer leaves a stale focus request: without the ratchet, every later rail selection re-stole focus onto the section card.
- Clicking "Settings" in the dashboard nav while a section pane is open now returns to the overview instead of silently doing nothing.
- Rail group labels shipped at 3.05:1 contrast during development and were caught by the blocking axe journey — hierarchy now comes from size and weight, never from fading the ink.

### Tests

- +133 frontend (5,710 across 453 files): shell model, rail, overview, pane (honest absence on a deterministically-gated section, focus ratchet), seven integrated page journeys, 106 registry-vs-source assertions; e2e rewritten for the new shell (deep-link URL contract, admin search journey, drill-down at 390 px, sticky rail, two new phone axe scans) and run green against the standalone production build.

## [1.30.8] - 2026-08-17

**LIA rédige de vrais documents — CSV, Excel, Word, PowerPoint, PDF, à la demande** (ADR-226). « Fais une recherche des derniers modèles LLM puis formalise dans un fichier CSV », « génère une présentation détaillée sur l'Alsace » : la réponse est désormais un **fichier fini**, livré en carte téléchargeable sous la réponse — nom signifiant, taille, échéance d'expiration explicite — et chaînable sur une recherche web faite dans la même requête. L'architecture décalque celle de la génération d'images : agent virtuel au catalogue, exposé aux deux modes d'exécution ; mais le « générateur externe » est ici un **slot LLM dédié** (`document_generation`, administrable dans la Configuration LLM comme les trente autres) appelé en sortie structurée typée par famille de format — tabulaire (csv/xlsx), sectionné (docx/pdf/md/txt), diapositives (pptx, notes de présentateur comprises) — puis un **moteur de rendu local pur** construit les octets exacts avec les bibliothèques déjà embarquées pour l'extraction RAG (openpyxl, python-docx, python-pptx, PyMuPDF) : zéro dépendance nouvelle, zéro service documentaire tiers. Les tableurs sont sûrs par construction — neutralisation prouvée de l'injection de formule (openpyxl stocke `=1+2` comme formule vivante), nombres négatifs préservés, BOM Excel, titres de feuilles assainis — et le prompt du rédacteur encode les bonnes pratiques documentaires par famille (colonnes atomiques et unités en en-tête, hiérarchie de sections, arc narratif de diapositives). Le fichier vit dans le socle attachments existant (même purge TTL que les images), les PDF s'ouvrent directement dans un onglet, l'opt-out est par utilisateur dans les Réglages et la capacité coupable par instance côté administration. Doctrine d'honnêteté intégrale : un rendu qui échoue après l'appel LLM payé retourne un échec explicite, jamais de carte fantôme ; une troncature de données sources est annoncée, jamais silencieuse.

**Le catalogue publie désormais les énumérations qu'il applique — la borne cachée disparaît d'une classe entière.** En câblant `doc_type`, la revue a montré que `_manifest_to_dict` publiait les bornes `min`/`max` et les `pattern` au planificateur mais **pas les contraintes `enum`** : un ensemble fermé appliqué par le validateur restait invisible de celui qui produit la valeur — exactement le piège que l'ADR-184 avait fermé pour les bornes numériques. Le chokepoint est corrigé pour tous les outils, présents et futurs ; l'ensemble des formats de `generate_document` est dérivé de l'enum du domaine, si bien que manifest et validateur ne peuvent plus diverger. Également dans cette version : les cartes de documents générés survivent au rechargement de page par le même sérialiseur unique que les cartes d'images (la classe de dérive entre chunk live et métadonnées archivées est fermée par construction), et la recherche des réglages connaît la nouvelle section dans les six langues.

### Added

- **Document generation domain (ADR-226)**: `generate_document` tool (csv, xlsx, docx, pptx, pdf, md, txt), dedicated `document_generation` LLM slot, per-format structured-output schemas, seven pure renderers round-trip-tested through the RAG readers, pending-card store + branchless delivery helpers, per-user opt-in, platform capability, dedicated executor timeout family, settings-search entry, FAQ section + feature card + knowledge file, six languages.
- PDF attachments (generated and uploaded) now serve inline and open in a browser tab; other documents keep the download disposition.

### Fixed

- `_manifest_to_dict` now publishes `enum` constraints to the planner (ADR-184 doctrine) — an enforced closed set was previously invisible to the model producing the value.
- Spreadsheet formula-injection surface closed at render time (proven on openpyxl), with signed-number exemption so legitimate negative values are never defaced.

### Tests

- +92 backend (schemas, sanitization, renderer round-trips, store, service, tool guards, wiring, serving disposition) and +15 frontend (document cards, reducer/history mapping, settings toggle, settings-search) — plus a hermetic Chromium E2E journey for the document cards, run green against the real standalone build.

## [1.30.7] - 2026-08-17

**LIA parle le standard Agent Plugins — les extensions portables de tout l'écosystème s'installent en un geste** (ADR-225). Le standard ouvert [agent-plugins.org](https://agent-plugins.org) (comité technique : AWS, Cursor, Microsoft, OpenAI, Vercel) définit un format de plugin portable — un manifeste, des skills au format agentskills.io, des serveurs MCP — adopté au lancement par ChatGPT, Codex, Cursor, GitHub Copilot, Kiro et VS Code. LIA devient un client conformant sous le profil incrémental de la spécification : un plugin publié pour ces outils s'installe dans LIA sans adaptation, par téléversement d'un zip ou depuis une URL https (mêmes gardes SSRF que l'import de skills), et apporte d'un coup ses skills et ses serveurs MCP streamable-http — chaque composant se comportant ensuite exactement comme son équivalent créé à la main (activation, HITL, sandbox, quotas). L'installation produit un **rapport exhaustif par composant** — installé, mis à jour, ignoré avec sa raison traduite, retiré — jamais de succès partiel silencieux : un serveur `stdio` (jamais lancé sur un serveur multi-utilisateur, par design) ou un endpoint HTTP non-loopback est _dit_ ignoré, pas prétendu installé. La mise à jour est un réimport (les composants disparus de la nouvelle version sont retirés, les identifiants OAuth configurés survivent), la désinstallation retire le plugin et tous ses composants d'un geste — et c'est le seul chemin : supprimer individuellement un skill ou un serveur appartenant à un plugin est refusé avec le pointeur vers la désinstallation, côté serveur comme côté interface. Nouvelle section « Plugins » dans les réglages (import, liste avec badges de composants, rapport, désinstallation), badge de provenance sur les serveurs MCP concernés, six langues. Au passage, un défaut réel du pipeline d'import de skills est corrigé : sur un hôte Windows, l'extraction d'un zip à dossier racine calculait son préfixe avec des antislashs et n'extrayait rien.

**La suppression de compte purge désormais aussi les fichiers de skills et de plugins.** Un trou préexistant, découvert par la revue de ce chantier : la purge RGPD effaçait les lignes en base et les répertoires de pièces jointes et de documents, mais laissait sur disque les skills importés de l'utilisateur — et aurait laissé ses plugins. Les deux arbres sont désormais supprimés avec le compte, la table des plugins installés rejoint la purge SQL explicite et la carte de classification des données (export complet : métadonnées de manifeste choisies par l'utilisateur, jamais de secrets — le standard les interdit dans les paquets). Au passage, deux correctifs d'assurance : le parcours hebdomadaire d'accessibilité ne rougit plus sur Firefox quand la page des réglages est encore en cours de mise en page (le défilement est réessayé jusqu'à prendre effet, au lieu d'un tir unique qui se faisait pincer à 0), et un garde exige désormais que chaque colonne du catalogue de tarifs LLM voyage dans la graine de référence — la perte silencieuse de colonnes à l'extraction (arrivée deux fois, dont les fenêtres horaires de la veille) devient un échec de test au lieu d'une absence muette sur le démonstrateur.

## [1.30.6] - 2026-08-17

**LIA parle la nouvelle génération du protocole MCP — sans abandonner personne** (ADR-224). La révision 2026-07-28 du Model Context Protocol rend le protocole sans état et condamne, par sa propre matrice de compatibilité, les clients d'ancienne génération face aux serveurs qui ne parlent que la nouvelle. LIA passe au SDK v2 en client **dual-era** : il parle la révision 2026-07-28 et retombe automatiquement sur l'ancien handshake face aux serveurs existants — chaque serveur MCP déjà déclaré, admin comme utilisateur, continue de fonctionner à l'identique (prouvé par exécution contre les deux générations de serveurs réels, puis au runtime contre des serveurs tiers réels couvrant chaque type d'authentification — OAuth2 compris). Et quand un serveur exige une révision que LIA ne parle pas, l'utilisateur lit désormais un diagnostic actionnable au lieu d'une erreur de transport brute enfouie dans trois couches d'`ExceptionGroup` ; LIA s'annonce enfin sous son nom et sa version dans le handshake, au lieu du `mcp/0.1.0` par défaut du SDK.

**Le flux OAuth des serveurs MCP applique les exigences 2026 — et le refus de l'utilisateur redevient un choix, pas une erreur.** Trois obligations de la nouvelle spécification d'autorisation sont implémentées : l'identité du serveur d'autorisation (`iss`, RFC 9207) est validée avant tout échange du code d'autorisation quand elle est présente ; les identifiants client sont liés au serveur qui les a émis — s'il change, LIA refuse de les réutiliser et se ré-enregistre automatiquement au lieu d'envoyer des secrets au mauvais interlocuteur ; et l'enregistrement dynamique déclare son type d'application. Chaque règle est assortie d'une tolérance explicite pour l'existant : un enregistrement antérieur sans issuer connu n'est jamais invalidé, un fournisseur qui n'émet pas `iss` fonctionne comme avant. Enfin, refuser le consentement sur la page du fournisseur ramenait l'utilisateur sur une erreur 422 brute ; il retrouve désormais ses réglages avec un message d'information dédié — un refus n'est pas une panne — dans les six langues.

## [1.30.5] - 2026-08-17

**La facturation LLM suit enfin l'heure du fournisseur** (ADR-223). DeepSeek facture ses modèles texte selon l'heure UTC — fenêtres pleines 01:00–04:00 et 06:00–10:00, tout le reste à moitié prix — et LIA appliquait le tarif plein 24 h/24 : chaque appel en heures creuses était survalorisé d'un facteur deux, démonstrateur public compris, dont le plafond de dépense quotidien lit précisément ce registre. Le catalogue de tarifs porte désormais des **plages horaires UTC optionnelles et génériques** (tout fournisseur, tout modèle texte, 1 à n fenêtres) : chaque fenêtre remplace les trois prix unitaires pendant sa plage, les prix de base s'appliquent partout ailleurs, et la résolution vit dans une implémentation unique consommée par les deux points de valorisation — l'appel est valorisé à son instant, celui que le fournisseur facture, et un message historique recalculé conserve le tarif de son heure d'origine. L'administrateur gère les fenêtres dans le dialogue des tarifs LLM (éditeur de plages avec rappel du fuseau local, validation du non-chevauchement — minuit enjambable —, badge « Horaire » dans le tableau) ; le tarif fenêtré DeepSeek officiel est embarqué dans les données de référence, si bien que le démonstrateur — dont la base se reconstruit à chaque démarrage — compte ce que la facture dit réellement, sans aucune saisie.

**Les formulaires de tarifs redeviennent utilisables au téléphone.** Sur mobile, la fenêtre de création/modification d'un modèle LLM était centrée avant d'être défilable : plus haute que l'écran, son haut passait au-dessus de l'origine du défilement et devenait inatteignable — impossible de saisir le nom du modèle, donc de créer ou modifier quoi que ce soit (mesuré à 390×844 : le titre à 349 pixels hors écran, la moitié de la course de défilement perdue). L'architecture de défilement est corrigée — l'arrière-plan défile, un conteneur intérieur centre les panneaux courts et grandit avec les longs — sur les trois dialogues d'administration des tarifs (LLM, API Google, images), dont deux ne défilaient pas du tout ; un panneau court reste parfaitement centré, et un test de régression épingle la structure.

## [1.30.4] - 2026-08-17

**L'assistant ne confirme plus jamais une action que ses propres outils ont refusée.** Un incident de production, mesuré à la requête près : un message relayé vers un proche, trois fois trop long pour la limite, a été refusé par l'outil — et la réponse a pourtant affiché « Message transmis — contenu intégral, sans modification », carte de succès à l'appui. La cause n'était pas le modèle : le chemin d'exécution des plans écrasait le verdict typé de tout outil au format unifié par un succès codé en dur. Le verdict est désormais propagé tel quel — échec, message, code d'erreur — ce qui réarme du même coup la couche d'honnêteté existante : un step échoué n'est plus compté comme « exécuté », le blocage redevient dicible avec sa cause, le refus de l'outil atteint la synthèse de réponse, et un échec ne s'enregistre plus comme contexte conversationnel. Deux défauts latents corrigés dans la foulée, débusqués par les tests du correctif eux-mêmes : un outil au format historique crashait sur un attribut absent (et devenait un échec silencieux), et un code d'erreur libre hors taxonomie levait une exception au lieu de dégrader proprement.

**Un message relayé trop long est maintenant refusé avec ses chiffres — avant d'échouer.** La limite de longueur des messages relayés (2 000 caractères, réglable par instance) était appliquée mais jamais énoncée : le planificateur épuisait ses re-planifications sur une contrainte qu'il ne peut pas réparer — le contenu est celui de l'utilisateur — puis posait une question générique sans rapport. La violation de longueur devient la première question posée, exacte et localisée dans les six langues (« Le contenu fait 6 149 caractères, mais la limite est de 2 000. Peux-tu le raccourcir, ou veux-tu que je le résume ? »). Le catalogue publie désormais la borne depuis le réglage lui-même — plus de valeur en dur qui divergerait silencieusement après un changement de configuration — et le manifest d'envoi déclare sa résolution du destinataire auto-suffisante : fini le détour par le carnet d'adresses qui fabriquait une fausse « opération en masse » pour un simple message à un proche connecté.

**Les confirmations d'opérations en masse disent le compte mesuré, accordé au singulier.** Le payload de confirmation FOR_EACH restituait le plafond théorique (« will execute 10 times ») là où la pré-exécution venait de mesurer un seul élément ; les claims sont réénoncés avec les comptes réels une fois les fournisseurs pré-exécutés — la décision de demander confirmation, elle, ne bouge jamais — et la carte accorde enfin le nombre (« 1 élément », plus jamais « 1 éléments »), dans les six langues. Au passage, le fichier d'orchestration qui portait cette préparation a été recentré : les cinq fonctions de préparation du HITL FOR_EACH vivent dans leur propre module, et le plafond de taille du fichier redescend de 910 à 680 lignes logiques.

## [1.30.3] - 2026-08-17

**Le build de production ne dépend plus de la météo de Google.** Deux images candidates ont échoué la veille sur des 404 de `fonts.gstatic.com` — Google avait tourné les versions hébergées de ses fichiers de polices pendant que le build les téléchargeait (vingt-huit erreurs par build, et un re-run comme seul palliatif). Les sept familles de caractères sont désormais **auto-hébergées** : les woff2 exacts (sous-ensemble latin, mêmes graisses, mêmes variables CSS — rendu inchangé) sont commités dans le dépôt et servis par `next/font/local`. Un garde de dérive interdit le retour de tout import `next/font/google` et vérifie l'existence de chaque fichier déclaré — une faute de chemin échoue au test, plus au build d'image.

**Le pipeline de release qualifiée atteint son premier bout-en-bout.** La qualification jetable de l'installeur self-host — jamais passée depuis sa création — a été réparée défaut par défaut, chacun mesuré sur une exécution réelle : l'échafaudage pré-créé par la préparation des volumes faisait passer le bundle pour un clone git (l'extraction des sources était sautée) ; les legs prebuilt se résolvaient silencieusement en mode local et la matrice qualifiait deux fois la même chose ; le harnais runtime n'était jamais en place (un `cp` avalé par `|| true`) ; le piège de nettoyage démontait la pile fraîchement vérifiée avant les sondes ; l'email du compte de test utilisait un TLD que le login rejette ; le catalogue de dépendances vivait hors de l'arbre embarqué du wizard ; et l'évidence de qualification produite était inconsommable par construction. Cette version embarque la chaîne réparée de bout en bout : candidat par digest → qualification hermétique multi-architecture → publication qualifiée.

## [1.30.2] - 2026-08-16

**L'écosystème LangChain/LangGraph rattrape cinq mois de correctifs — sur preuves, pas sur confiance.** Montée de langchain 1.3.9→1.3.15, langgraph 1.2.4→1.2.11, langchain-core 1.4.6→1.5.5, des quatre intégrations provider et des SDK openai 2.54.0 (dernier 2.x — la 3.x bascule sur HTTPX2 et n'installe plus httpx dont LIA dépend partout : exclusion délibérée, documentée) et anthropic 0.122.0. Chaque hypothèse a été validée **avant** de toucher au dépôt : résolution des dépendances à blanc, installation réelle en environnement jetable, 8 489 tests exécutés sous les versions cibles, simulations hors-réseau des quatre points d'intégration privés (round-trip DeepSeek, clé de cache Responses, `stream_usage` explicite), contrôle A/B contre les versions courantes. Bénéfices immédiats sur des composants que LIA exécute en production : le retry d'outils ne retente plus les erreurs définitives (appels payants économisés), les interrupts HITL traversent les couches de retry, la synthèse d'historique n'efface plus la conversation quand elle échoue, la régression des espaces de checkpoint des sous-graphes imbriqués (présente dans la version embarquée) est corrigée, et un stream SSE abandonné annule ses sous-graphes au lieu de continuer à consommer des jetons. Les reasoning tokens Anthropic entrent dans la comptabilité contractuelle d'ADR-220. Le patch local DeepSeek reste en place : le correctif attendu n'est toujours pas upstream — vérifié dans le code source du tag, pas dans les notes de release.

**~1 750 lignes de code HITL mort supprimées** (ADR-222). L'audit d'exploitation qui accompagnait la montée a révélé une seconde implémentation complète de la reprise HITL — jamais appelée par la production, maintenue verte par une cinquantaine de tests dédiés (« coverage target: 85%+ »), et dont la boucle de stream appauvrie aurait silencieusement perdu les événements de compaction si elle avait un jour servi. Classe, Protocol et tests supprimés ; les trois helpers réellement consommés sont conservés et le fichier sort de la liste des fichiers gelés du ratchet de taille. Une seule implémentation de la reprise subsiste : la dérive entre chemins devient structurellement impossible.

**La fenêtre de contexte lit enfin le catalogue administré.** Le déclencheur de synthèse d'historique et le dimensionnement de la compaction lisaient une table de fenêtres maintenue à la main — qui divergeait déjà du catalogue LLM que l'administrateur édite (même piège des « deux autorités » que la release DB-source-of-truth avait éliminé pour toutes les autres capacités). Le catalogue fait désormais foi, la table reste filet de sécurité. Au passage, un vrai bug latent corrigé : le profil natif des modèles (un dict depuis langchain 1.x) était lu comme un objet à attributs et dégradait silencieusement chaque profil à 8 192 jetons.

**Les outils payants ont un plafond d'appels par requête.** Générer une image, interroger Perplexity ou Brave est désormais borné par run (six outils couverts par défaut, réglable, validé au démarrage : une valeur malformée refuse de booter plutôt que de perdre une protection en silence — un test garantit même que chaque nom d'outil plafonné existe réellement dans le registre). L'agent qui atteint la borne reçoit un message explicatif et conclut proprement au lieu de boucler sur une API facturée.

## [1.30.1] - 2026-08-16

**Le comptage des jetons devient un contrat — il reposait sur la politesse du fournisseur** (ADR-220). Un contre-audit mené sur les données de production a réfuté le scénario catastrophe d'un audit interne (« les emplacements diffusés ne comptent aucun jeton ») : 510 appels sur 510 étaient bien comptés sur 30 jours. Mais la raison était pire que le défaut supposé : la requête ne demandait jamais le décompte, et DeepSeek l'envoyait **spontanément** — un comportement que rien ne demandait, que rien ne testait, que rien ne surveillait. Chaque fournisseur de chat déclare désormais son mode de comptage dans un registre vérifié au démarrage (l'application refuse de booter sur un fournisseur non déclaré), les clients demandent explicitement le décompte, et un appel payant qui se termine sans usage devient un compteur, un avertissement et une alerte à seuil zéro — plus jamais un log invisible.

**Le réglage de délai d'attente que l'administrateur voyait est enfin celui que le système applique** (ADR-221). Le champ « timeout » existait de l'écran d'administration jusqu'à la base de données, puis personne ne le lisait : les vraies bornes vivaient dans des variables d'environnement invisibles. Le réglage par emplacement atteint désormais le client de chaque fournisseur (borne réseau par tentative), les barrières existantes restent la borne d'expérience utilisateur, et **aucun défaut n'a été appliqué sans mesure** : six valeurs ont été relevées après confrontation aux latences réelles de 30 jours de production — deux emplacements dépassaient déjà l'ancienne valeur et auraient vu leurs appels coupés.

**Le tableau de bord disait « 0 action réussie » depuis toujours — c'était le thermomètre qui était cassé.** Le classement des résultats comparait l'intention du routeur à une valeur qu'aucun routeur n'a jamais émise : chaque action aboutie était comptée comme une simple réponse, jamais promue par la validation comportementale, et « résultats utiles confirmés » se réduisait aux routines. Le vocabulaire est aligné et verrouillé par un test de contrat des deux côtés, et une migration reclasse l'historique — l'intention archivée de chaque conversation permettait de le faire sans rien inventer.

**Une quinzaine de fausses alertes mémoire en quelques jours : une division par zéro qui criait à l'infini.** Sept conteneurs du démonstrateur n'avaient pas de limite mémoire ; la sonde publiait alors « limite = 0 », le ratio valait +∞ et passait le filtre. Le garde est déplacé sur le dénominateur (un conteneur sans limite est exclu du calcul, cas de test à l'appui), et les sept conteneurs reçoivent des plafonds dimensionnés sur leurs consommations mesurées — un garde exige désormais un plafond sur chaque service de l'enveloppe.

**Les pannes de configuration se nomment enfin.** Une clé API invalide, un crédit fournisseur épuisé ou un nom de modèle inexistant recevaient le message le plus vague — voire un « service saturé, réessayez » sur des erreurs que réessayer ne corrigera jamais (un message citant « 4290 tokens » suffisait à passer pour une saturation). La classification lit d'abord le code HTTP que le SDK expose, et trois nouvelles familles de messages dans les 6 langues pointent vers l'écran exact où se répare la panne.

### Added

- **Registre de comptabilité d'usage par fournisseur** (ADR-220) : `PROVIDER_USAGE_CAPABILITIES` déclare comment chaque fournisseur de chat compte ses jetons (demande explicite, natif, ou exclu — Ollama local et Perplexity sur clé utilisateur restent volontairement hors facturation) ; complétude vérifiée au démarrage, comportement de l'adaptateur épinglé à la déclaration par test.
- **Signal « appel sans comptage »** : compteur `llm_calls_without_usage_total`, avertissement aux deux points d'extraction, alerte `LLMCallsWithoutUsage` à seuil zéro avec runbook — la classe entière de trous de facturation silencieux devient visible en une heure.
- **Extraction JSON unifiée** `json_recovery` : une seule implémentation (consciente des chaînes et des échappements) pour récupérer le JSON des réponses en texte — clôtures tronquées réparées, virgules traînantes tolérées, prose avant/après, blocs de code — consommée par le rattrapage d'appel d'outil ET le repli JSON, avec le corpus de formes réelles comme contrat.
- **Trois familles de messages d'erreur dans les 6 langues** : clé refusée (401/403), crédit épuisé (402), modèle inexistant (404) — chacune nomme la panne et l'écran de réparation (chemins de navigation vérifiés contre les libellés réels de l'application), avec un journal opérateur dédié aux erreurs de configuration.
- **Migration de reclassement du tableau de bord** : les conversations dont l'intention archivée était « action » retrouvent leur vraie catégorie ; la validation comportementale promeut ensuite l'historique — le cycle en cours reflète ce qui a réellement été accompli.
- **Timeout transmis aux clients LLM** (ADR-221) : le réglage par emplacement (administrable) devient la borne transport par tentative sur les quatre SDK, chemin Responses API compris ; l'échappatoire `provider_config` garde la priorité.

### Changed

- **Demande de décompte portée par `stream_usage`** plutôt qu'injectée dans chaque requête : appliquée aux seules requêtes diffusées, ce qui fait disparaître par construction le rejet DashScope de `stream_options` hors streaming.
- **Six défauts de timeout relevés sur mesures** (p99 de 30 jours de production, consignés en commentaire à côté de chaque valeur) : réponse 60→120 s, planificateur 60→90 s, décision heartbeat et présentation d'intérêts 60→120 s (des appels au-delà de 60 s étaient observés), extraction de boucles ouvertes 45→90 s, extraction de références mémoire 30→45 s.
- **Classification d'erreur : le code HTTP décide d'abord**, les types d'exceptions SDK ensuite, les mots-clés en dernier recours — et un code numérique ne matche plus qu'en contexte HTTP (fini le « 503 » d'une borne de validation Pydantic lu comme une panne serveur).
- **Une traduction vide du pivot sémantique est un échec** : repli sur la requête d'origine (comme une exception), l'écriture en cache des résultats dégénérés est refusée et comptée — et les journaux de contenu redescendent au niveau debug.
- **Expression de l'alerte mémoire conteneur corrigée** : le garde « limite > 0 » porte sur le dénominateur — un conteneur sans limite est exclu au lieu de produire un ratio infini qui alerte en permanence.
- **Plafonds mémoire sur les sept conteneurs du démonstrateur** qui n'en avaient pas (dimensionnés sur les maxima mesurés sur 7 jours, la base tmpfs comptée dans son propre conteneur), avec un garde d'enveloppe qui exige un plafond sur chaque service.
- **Plancher de couverture backend relevé 65 → 66 %** (mesuré 68,03 % — le cliquet ne descend jamais, il monte quand le travail le permet).

### Fixed

- **« Actions réussies » figé à 0 sur le tableau de bord** : le classement comparait l'intention à « actionable », valeur jamais émise (le routeur dit « action ») — toute action aboutie était comptée comme simple réponse et « résultats utiles confirmés » se réduisait aux routines. Vocabulaire aligné, contrat épinglé des deux côtés, historique reclassé par migration.
- **Quinze fausses alertes « mémoire proche de la limite »** : ratio +∞ sur les conteneurs sans limite (x/0 passe un filtre « > 0 ») — garde déplacé sur le dénominateur, cas promtool prouvé rouge contre l'ancienne expression.
- **La branche « désactiver le streaming » était inatteignable** — et son unique appelant (notifications de rappel) croyait s'en servir, commentaire à l'appui : branche morte supprimée, le besoin réel (compter l'usage) est résolu à la racine par ADR-220.
- **Le rattrapage JSON échouait sur trois formes courantes** (prose après le JSON contenant une accolade, exemple JSON en fin de message, virgule traînante) — corrigé par l'extraction unifiée, les trois cas épinglés en non-régression.
- **Une réponse vide pouvait être mémorisée cinq minutes** et servie comme « intention en anglais » au routage d'outils — refusée à l'écriture, repli immédiat.
- **« Service saturé, réessayez » sur des pannes définitives** : un message d'erreur citant un nombre de jetons ou une borne de validation passait pour une saturation passagère — la lecture du code HTTP d'abord ferme la classe entière.
- **Requête utilisateur dans les journaux au niveau info** (pivot sémantique) — contenu redescendu à debug, conformément à la règle de confidentialité des journaux.
- **Deux réglages morts supprimés** : `router_llm_timeout_seconds` (défini depuis des années, lu nulle part — le routeur ne fait aucun appel LLM direct) et le module `OpenAIProvider` (259 lignes sans appelant, dont les tests simulaient de la couverture).

### Tests

- **18 369 tests backend collectés** (fast : 17 155 verts) et **5 476 tests frontend** (441 fichiers) ; couverture 68,03 % ≥ nouveau plancher 66 % ; MyPy strict sur 1 115 fichiers ; rejeu de la chaîne de migrations depuis une base vierge.
- **Les contrats qui manquaient existent désormais** : table provider × diffusion pour la demande de décompte (et le contrat langchain « l'auto-activation ne joue jamais avec une base_url » épinglé sur le paquet installé) ; corpus de 21 formes JSON dont les trois échecs historiques ; table de vérité (code HTTP × type × message) → catégorie d'erreur avec les faux positifs mesurés en non-régression ; précédence de l'échappatoire `provider_config` (le crash `TypeError` qu'elle provoquait est épinglé) ; câblage du suivi de jetons du générateur de questions HITL ; vocabulaire d'intention routeur ↔ produit verrouillé des deux côtés.
- **Deux cas promtool nouveaux** (conteneur sans limite silencieux ; appel sans usage qui alerte) et le garde d'enveloppe du démonstrateur étendu aux plafonds mémoire.

## [1.30.0] - 2026-08-16

**En déplacement, LIA répond enfin depuis là où vous êtes — plus jamais depuis votre domicile par défaut** (ADR-219). La dernière position connue existait depuis avril (chiffrée, opt-in, jamais historisée) mais une seule famille de fonctionnalités la lisait : les notifications proactives. Le chat, les actions planifiées, le briefing et les skills retombaient sur l'adresse personnelle dès que la position du navigateur mourait — ce qu'une PWA fait systématiquement après quelques heures d'inactivité. La cascade est désormais **une** et **partout** : position vivante du navigateur, sinon dernière position mémorisée (fraîche et consentie), sinon domicile. Les actions planifiées, qui n'ont jamais de navigateur, en héritent sans une ligne de code.

**Une position datée s'annonce datée — jamais présentée comme la position courante.** « Où suis-je ? » sans GPS vif répondait « activez la géolocalisation » ; la réponse vient maintenant de la dernière position mémorisée **avec son âge énoncé** (« d'après ta dernière position connue à 9 h 30… »). L'âge voyage dans le contrat de données (`as_of`), traverse l'outil, le contexte des skills et le prompt versionné : le modèle ne peut pas dire « tu es à… » sur un point d'il y a deux heures. Et « chez moi » ne sera jamais résolu par une position captée sur la route — le domicile garde sa branche.

**La PWA se réveille au lieu d'attendre qu'on la secoue.** Au retour au premier plan, la permission est re-vérifiée : encore accordée → la position se rafraîchit **silencieusement** et repart au serveur ; retombée (ce qu'iOS fait après inactivité) → une bannière s'affiche dès l'ouverture du chat, **avant** que vous tapiez quoi que ce soit, et son bouton fournit le geste que la feuille native exige. Le partage périodique de position ne dépend plus d'une page de réglages ouverte : il vit dans le socle authentifié, avec son étranglement de 30 minutes.

**Le réglage vit là où sont les autres sources de position.** L'opt-in « Mémoriser ma dernière position » a quitté les notifications proactives pour le connecteur Google Places, entre la géolocalisation en direct et l'adresse du domicile — l'ordre exact de la cascade. Transparence conservée : coordonnées stockées, date, fraîcheur, effacement immédiat.

**Quatre pannes de production diagnostiquées dans les journaux, quatre causes racines corrigées.** Le mode ReAct mourait en 400 sur Gemini dès qu'un outil MCP déclarait un tableau (le schéma perdait son type d'éléments — un seul outil empoisonnait la requête entière) ; les appels téléphoniques échouaient avec un « réessaie plus tard » mensonger alors qu'ElevenLabs avait durci son format de clés (le statut `auth_failed` dit maintenant la vraie réparation, dans les 6 langues) ; l'administration LLM renvoyait 422 quand le dialogue envoyait la forme de raisonnement du modèle précédent (coercition à la sauvegarde + validation backend même sans changement de modèle) ; et le déploiement écrivait `DOCKER_GID` dans un fichier que la bascule atomique jetait — les widgets de skills perdaient l'accès au socket Docker à chaque mise en production.

**Le démarrage multi-worker sur base vierge ne se bat plus contre lui-même.** Quatre workers exécutaient simultanément les migrations LangGraph sur une base neuve : violations de contraintes en cascade, boucle de respawn, un boot en 15-25 minutes. Un verrou consultatif PostgreSQL sérialise désormais la création du schéma — en **sondage non bloquant**, parce que la forme bloquante retenait un instantané dont `CREATE INDEX CONCURRENTLY` attendait la fin : un inter-blocage à trois mesuré en vrai. Boot à froid mesuré : 68 secondes, zéro échec. Et un fournisseur d'embeddings en panne dégrade la sélection sémantique d'outils au lieu de tuer l'application.

### Added

- **Cascade de localisation généralisée** (ADR-219) : la dernière position connue (opt-in, chiffrée, TTL 24 h) devient une source de premier rang pour le chat, les actions planifiées, le briefing et les skills — module dédié `location_resolution.py`, cascade implicite partagée `resolve_implicit_location` (navigateur > mémorisée > domicile).
- **Âge de position contractuel** : `ResolvedLocation.as_of`, publié par l'outil « où suis-je », suffixé dans le contexte des skills (`last_known <horodatage>`) et enseigné au modèle par le prompt versionné — une position mémorisée est toujours annoncée avec son âge.
- **Cycle de vie PWA** : rafraîchissement silencieux de la position au retour au premier plan (`visibilitychange`, restaurations bfcache), état `needsReactivation` quand la permission retombe, et bannière de réactivation proactive dans le chat (une fois par session, avant toute phrase).
- **Synchronisation globale de position** : hook monté dans le socle authentifié qui pousse la position au serveur (étranglement client 30 min au-dessus de l'étranglement serveur), indépendamment de la page visitée ; un échec de poussée ne consomme pas la fenêtre.
- **Réglage « Mémoire de position » sur le connecteur Google Places** : opt-in généralisé + panneau de transparence (coordonnées, date, fraîcheur, effacement), à la place du bloc météo des notifications proactives.
- **Statut téléphonique `auth_failed`** : classification structurelle des erreurs d'authentification ElevenLabs (sur le type d'erreur, jamais sur le texte), phrase honnête dans les 6 langues indiquant la vraie réparation (reconnecter avec une clé `sk_`).
- **Verrou de démarrage `setup_lock`** : sérialisation par verrou consultatif PostgreSQL (sondage `pg_try_advisory_lock`) de la création du schéma LangGraph entre workers — clés distinctes checkpointer/store, libération garantie sur connexions de pool réutilisées.

### Changed

- **Renommage assumé** : `weather_use_last_known_location` → `use_last_known_location`, `PATCH /auth/me/weather-location-preference` → `/auth/me/location-preference` (migration incluse) — un nom qui revendique une portée météo que le code n'a plus est une documentation mensongère.
- **Le seuil de distance de 50 km reste propre aux notifications proactives** : en conversation, au bureau à 5 km de chez vous, « restos dans le coin » utilise votre vraie position — la fraîcheur est le seul critère du chat.
- **Cinq recopies manuelles de « navigateur sinon domicile » factorisées** (outils lieux ×3, itinéraires ×2) vers la cascade partagée — et les manifests du planificateur disent la nouvelle vérité (l'outil de position n'« exige » plus la permission navigateur).
- **`runtime_helpers.py` sort de la liste des fichiers gelés** : l'extraction du module de localisation le ramène de 717 à 522 lignes logiques, sous le plafond global — plafonds de `places_tools` et `routes_tools` abaissés dans la foulée.
- **Seeds LLM régénérés depuis la production en pleine fidélité** : 123 modèles, 139 tarifs avec unité de facturation par ligne (les lignes à l'heure audio étaient perdues), 42 surcharges complètes (top_p, timeout, provider_config, effort) — planchers de vérification relevés 96→139 et 41→42.
- **L'échec d'initialisation sémantique dégrade au lieu de tuer le boot** : frontière de résilience explicite dans l'initialisation des services d'embeddings (un 429 fournisseur ne vaut pas un « Application startup failed » ×4 workers).

### Fixed

- **Mode ReAct × Gemini : un outil MCP à paramètre tableau tuait toute la requête** — le schéma généré perdait le type des éléments (`items: {}`), Gemini répondait 400 INVALID_ARGUMENT pour le bind entier. Les éléments sont désormais typés (validation inchangée), avec le vrai convertisseur Gemini comme oracle de test — et la régression jumelle sur la détection des listes optionnelles (`Annotated[list] | None`) corrigée avec lui.
- **Téléphonie : l'échec d'authentification était déguisé en panne passagère** — ElevenLabs a durci son format de clés entre le 4 et le 15 août ; « réessaie dans un instant » était un mensonge. Le statut `auth_failed` dit la vraie cause et la vraie réparation.
- **Administration LLM : 422 en boucle sur la forme de raisonnement** — le dialogue envoyait la forme du modèle précédent quand le catalogue n'avait pas les capacités du nouveau ; coercition au moment de la sauvegarde, validation backend même quand le modèle est omis, chaîne vide tolérée au merge (elle crashait la configuration).
- **Déploiement : `DOCKER_GID` écrit dans le mauvais `.env`** — l'étape écrivait dans l'arbre vivant que la bascule atomique (ADR-215) remplaçait ensuite ; les widgets de skills perdaient le socket Docker à chaque mise en production. L'écriture cible désormais l'arbre de préparation, celui que la bascule promeut.
- **Course de démarrage sur base vierge** : les workers perdants de la création du schéma LangGraph mouraient en violation de contrainte de catalogue et l'API bouclait en respawn — sérialisé par le verrou consultatif (voir Added), en sondage non bloquant pour ne pas inter-bloquer `CREATE INDEX CONCURRENTLY`.
- **Double demande GPS à chaque ouverture** : `pageshow` se déclenche aussi au chargement normal, où le montage rafraîchit déjà — seules les restaurations bfcache déclenchent désormais.

### Tests

- **18 254 tests backend collectés** (990 fichiers ; fast : 17 032 verts, 20 ignorés) et **5 475 tests frontend** (441 fichiers), tous verts ; MyPy strict sur 1 115 fichiers ; rejeu complet de la chaîne de migrations depuis une base vierge avec équivalence structurelle.
- **La cascade a son banc d'essai dédié** : 19 tests unitaires sur le point d'étranglement (chaque intention × chaque source × fraîcheur × opt-in), deux-sens sur le cycle de vie PWA (bfcache déclenche, chargement normal non), mode proactif de la bannière (priorité, geste, rejet par session), synchronisation globale (étranglement, échec sans tampon), et l'oracle Gemini réel pour les schémas d'outils MCP.
- **Ratchets améliorés, jamais relevés** : un fichier sort de la liste gelée des tailles, deux plafonds abaissés, complexité de la bannière décomposée en table de décision sous le seuil.

## [1.29.0] - 2026-08-08

**LIA s'installe chez vous, se montre sans mentir, et sait ce qu'elle a le droit de dépenser** (ADR-215 → ADR-218). Quatre décisions d'architecture qui répondent à quatre questions restées sans réponse : comment quelqu'un d'autre fait-il tourner ce projet, comment le voir avant de l'installer, combien une instance peut-elle dépenser, et qu'est-ce qu'un exploitant peut couper sans redéployer.

**Un installateur qui construit chez vous, et ne fait jamais confiance à une étiquette** (ADR-215). `./install.sh` pose un questionnaire dans votre langue et construit les images **depuis la source clonée** — c'est le défaut de la v1, parce qu'un artefact prébâti qui n'a pas été qualifié n'a pas sa place dans une installation. Le mode prébâti existe, mais il n'accepte que des références `repository@sha256:…` issues d'un manifeste signé `qualification="passed"` : **une étiquette mutable n'est jamais une entrée de l'installateur**. Les secrets entrent par **stdin uniquement** — un seul document JSON crée l'administrateur (à travers `validate_password_strict`, sans mot de passe par défaut) et chiffre les clés fournisseur dans une transaction unique ; rien ne passe par `argv`, rien n'atterrit dans l'état de reprise. Les données de référence s'appliquent en **une transaction, un seul `psql`, `ON_ERROR_STOP=1`**, suivies d'un fichier de vérification bloquant et d'un marqueur écrit dans la même transaction : une installation à moitié semée n'existe pas. Et `/ready` ne suffit jamais à déclarer l'installation réussie — un vérificateur sans secret contrôle la tête Alembic unique, le marqueur exact, les postconditions des données de référence, l'administrateur actif, les clés déchiffrables et la couverture fournisseur **sur la configuration effective après seeds**, celle que le premier message utilisera vraiment.

**Une instance sait enfin combien elle a le droit de dépenser** (ADR-216). LIA bornait ce qu'**un compte** consomme depuis mars ; elle ne bornait rien de ce qu'**une instance** dépense, et la vérification menée sur toute la base de code n'a trouvé aucun plafond global. Ce n'était pas un oubli mais une propriété : N comptes × leur quota est une dépense non bornée. Un registre journalier (`instance_daily_budget`, une ligne par jour UTC) reçoit le coût de chaque run par **UPSERT atomique avec arithmétique de colonne**, dans la transaction même qui persiste le résumé de tokens — mesuré en conteneur : trois runs concurrents de 0,30 € donnent exactement `0.900000 €` et `run_count = 3`. Le plafond se compose de deux bornes et **la plus petite gagne** : un opérateur peut resserrer ce que le déploiement autorise, jamais l'élargir, et l'interface affiche ce qui s'applique à côté de ce qui est saisi. Contrairement aux limites par utilisateur qui échouent ouvertes, une dépense inconnue échoue **fermée** : au pire un message de trop d'un côté, au pire tout le budget de l'autre. Le visiteur ne lit pas « contactez votre administrateur » quand c'est le déploiement qui est en pause : un code dédié traverse les deux chemins avec un `Retry-After` calculé jusqu'au prochain minuit UTC.

**Dix capacités se coupent depuis l'administration, en deux secondes, sans redéployer** (ADR-217). Dictée, synthèse vocale, images, téléversements, espaces documentaires, recherche web, navigation, compétences, MCP, téléphonie : chacune se déclare une fois, avec **le mode par lequel elle est réellement appliquée**. Trois modes, et le choix n'est pas cosmétique — les outils disparaissent du catalogue offert au planificateur, ou une dépendance de routeur refuse en 403 avec un code stable, ou un point d'étranglement interne coupe la source. La synthèse vocale n'a **aucune route** : elle naît dans le flux de chat, et la première rédaction qui la déclarait « appliquée par la route » était fausse — seule la vérification du câblage réel l'a montré. Deux gardes de démarrage recalculent la déclaration contre la réalité et ont immédiatement attrapé deux noms d'agents inventés. Le panneau affiche les deux bornes plus l'état appliqué : une capacité interdite par le déploiement porte un badge « Indisponible » et dit pourquoi, parce qu'un interrupteur qui ne change rien est un piège.

**Trois gardes qui recalculent ont trouvé trois failles que les tests verts ne pouvaient pas voir** (ADR-218). Les tests livrés avec chaque protection avaient tous la même forme : ils épinglaient ce que le code faisait le jour de la livraison — une liste écrite à la main ne décrit pas un système, elle décrit ce que son auteur en savait. **La synthèse vocale était facturée et ne comptait pas** : `tts_cost_eur` était publié dans le résumé de run, transmis au registre… et absent de la somme ; sur un démonstrateur où la voix est activable, le plafond était aveugle à ce qu'un visiteur essaie en premier. **`/auth/google/login` et son callback étaient publics** : l'acceptation des CGU avait été rendue obligatoire sur le chemin d'inscription, mais la création de compte par fournisseur passait à côté — un visiteur arrivant par là n'acceptait rien, et le document qui lui apprend que tout est effacé chaque nuit était précisément celui qu'il ne voyait jamais, pendant que son identité Google réelle atterrissait sur une instance publique. **Onze chemins du routeur des connecteurs liaient un identifiant réel sans aucune garde** — dont l'activation d'un mot de passe d'application iCloud. Chaque garde a ensuite été mise en défaut volontairement pour vérifier qu'elle rougissait.

**Six missions guidées montrent les mécanismes, et disent à chaque écran que c'est une démonstration.** `/demo` propose une mission par mécanisme différenciant — matinée surchargée, alerte proactive, mémoire longue, réservation téléphonique, briefing du jour, visite de la configuration. La réponse finale est rendue par le **vrai pipeline d'affichage** du chat, le reçu nomme chaque action et affiche un refus **comme un refus**, jamais comme un effet appliqué, et un tiroir de preuves renvoie au code exact. Les libellés « démonstration guidée », « données synthétiques », « aucune action externe » sont visibles à chaque phase et vérifiés par les parcours navigateur.

### Added

- **Installateur self-host** (`./install.sh`, ADR-215) : questionnaire stdlib en 6 langues, préflight hôte, génération d'environnement, matrice Compose (3 expositions × 2 modes × observabilité × bac à sable), reprise **fail-closed** par empreintes SHA-256 sans aucun secret, retour arrière par alias d'image, rapport final nommant les capacités dégradées faute de clé.
- **Chaîne de release self-host** : bundle déterministe (uid/gid 0, mtime 0), manifeste digest-only à qualification explicite, contexte source reproductible, SBOM frontend CycloneDX 1.5, promotion d'images **sans aucun rebuild** (l'étiquette sémantique est créée depuis les digests déjà qualifiés).
- **Plafond de dépense d'instance** (ADR-216) : registre journalier UTC, `INSTANCE_DAILY_BUDGET_EUR` côté déploiement, réglage d'administration à l'intérieur, carte d'administration montrant dépense/plafond/reste, code d'erreur dédié et `Retry-After` jusqu'à minuit UTC dans les 6 langues.
- **Magasin de réglages générique typé** (`system_settings/registry.py`) : une clé se déclare une fois (codec, défaut, cache) avec assert de complétude au démarrage (doctrine ADR-085) — les deux clés existantes coûtaient ~250 lignes dupliquées chacune.
- **Dix capacités de plateforme administrables** (ADR-217) : registre déclaratif, trois modes d'application (`agents`, `route_enforced`, `service_enforced`), filtrage du catalogue du planificateur, panneau d'administration affichant les deux bornes et l'état appliqué.
- **Trois plafonds de déploiement manquants créés** — `VOICE_TTS_ENABLED`, `WEB_SEARCH_ENABLED`, `BROWSER_ENABLED` — pour qu'aucune capacité ne soit l'exception sans borne.
- **Showroom guidé public** sur `/demo` : 6 missions, réponses rendues par le pipeline d'affichage de production, reçu d'exécution honorant les refus, tiroir de preuves, entonnoir télémétrique **par mission** (événements bornés, dérivés du registre — une mission sans ses deux événements échoue à l'import) et une rangée dédiée dans le tableau de bord produit.
- **Acceptation des CGU obligatoire à l'inscription**, horodatée et versionnée ; conditions d'utilisation rédigées dans les 6 langues.
- **Enveloppe de démonstration isolée** (ADR-218) : Compose dédié, réseaux cloisonnés, proxy de sortie à liste blanche, purge nocturne des comptes visiteurs, rapport quotidien, plafond d'inscriptions quotidien.
- **Surcouches Compose explicites** : le socket Docker devient **opt-in** (`docker-compose.skill-sandbox.yml`) et les montages de maintenance passent dans `docker-compose.devops.yml` — une installation générique tourne sans socket et sans compétences scriptées.

### Changed

- **L'image web de release est neutre vis-à-vis de l'hôte** : construite sans URL d'API ni nom de domaine ; l'origine canonique est résolue à la requête depuis une variable serveur validée, et les pages publiques dégradent proprement quand aucune origine n'est configurée.
- **`create_admin` ne connaît plus de mot de passe par défaut** : la robustesse est validée avant toute requête, la saisie passe par stdin ou `getpass`, et l'adresse est obligatoire.
- **Le point d'étranglement des limites d'usage** compose désormais le verdict d'instance **avant et en dehors** du cache par utilisateur, et **indépendamment** de `usage_limits_enabled` — borner un compte et borner une instance sont deux protections distinctes.
- **Le refus de liaison en mode démonstration remonte de `connectors/` vers `core/demo_mode.py`** : les deux refus (liaison de connecteur, connexion fédérée) relèvent d'une même règle, et un garde vivant dans un domaine ne pouvait voir que ce domaine — c'est la raison structurelle pour laquelle la faille OAuth avait survécu.
- **Le catalogue du planificateur rétrécit quand une capacité est coupée** : les plans restent exécutables et le prompt raccourcit, par le post-filtre `exclude_tools` qui existait déjà — un mécanisme, pas deux.
- **`/auth/features` publie `federated_signin_enabled`** et l'interface ne dessine plus un bouton que l'instance refuserait : un bouton mort est pire que pas de bouton.

### Fixed

- **La synthèse vocale était facturée sans jamais compter contre le plafond de dépense** — `tts_cost_eur` publié, transmis, et absent de la somme ; la transcription distante n'atteignait même pas le registre. Une garde AST lit désormais les familles de coût réellement publiées et exige que chacune soit comptée ou explicitement exclue **avec sa raison**.
- **La connexion Google contournait l'acceptation obligatoire des CGU** et exposait l'identité réelle du visiteur sur une instance publique — fermé en trois couches (bord, dépendance de routeur, interface).
- **Onze chemins du routeur des connecteurs liaient un identifiant réel sans garde**, dont `/apple/activate`, `/api-key/{id}/rotate` et `/philips-hue/pair` ; le recensement marche maintenant sur le routeur réel dans les deux sens — non classé ou classé-puis-démonté font rougir la CI.
- **`/metrics` ne répondait 404 que par accident** sur le démonstrateur (il ne vit pas sous `/api` et tombait dans le repli web) — refusé explicitement.
- **Le plafond d'inscriptions était un check-then-act** : `COUNT(*)` puis `INSERT`, mesuré à 37 comptes créés pour un plafond de 5 sous 40 requêtes simultanées. Remplacé par un UPSERT conditionnel `… WHERE signup_count < limit RETURNING` — le verrou de ligne PostgreSQL sérialise la décision et un refus ne consomme aucun créneau (mesuré : exactement 5).
- **La synthèse vocale locale ignorait le proxy de sortie** : `edge-tts` passe par aiohttp, qui ne découvre aucun proxy dans l'environnement — le proxy lui est désormais passé explicitement.
- **Le bundle de données de référence ne pouvait être appliqué par aucune installation** : la sentinelle véto posait une question jamais vraie (une table que la migration venait de remplir), l'image API n'embarquait pas les fichiers de seeds, et une réécriture sous Windows avait passé l'entrypoint en CRLF. Les trois corrigées, avec un garde qui vérifie tout Compose armant les seeds.
- **Un modèle non tarifé ne peut plus être provisionné** : un catalogue sans tarif comptait chaque appel à 0 €, ce qui transformait n'importe quel plafond en décor.
- **Un réglage lu nulle part est un piège, pas une option** — la réserve quotidienne de jetons du démonstrateur existait dans les réglages sans jamais être consommée ; elle est désormais lue, et ne peut que resserrer le plafond révisé.

### Tests

- **18 206 tests backend** (987 fichiers) et **5 448 tests frontend** (440 fichiers), tous verts. Le total baisse de 244 tests par rapport à la v1.28.0 : le prototype de démonstrateur agentique isolé (44 modules, 35 suites) a été retiré au profit de l'**image standard dans une enveloppe isolée**, qui démontre le produit réel plutôt qu'une réduction du produit.
- **Gardes qui recalculent** (ADR-218) : couverture des familles de coût par lecture AST du résumé de run, surface publique dérivée des routes réellement montées en modélisant l'ordre d'évaluation du bord, recensement exhaustif du routeur des connecteurs. Chacune vérifiée à l'envers, en la mettant en défaut volontairement.
- **Installateur** : matrice Compose réelle (`docker compose config`) sur 24 combinaisons, contrat Python 3.10, alignement du questionnaire sur les constantes du backend, workflow de qualification jetable, garde anti-survente interdisant « clé en main » / « zéro friction » sans preuve d'un profil mono-fournisseur.
- **Parité i18n stricte** sur les 6 langues et couverture frontend relevée aux nouveaux planchers mesurés.

## [1.28.0] - 2026-08-05

**LIA apprend vos habitudes — sans modèle entraîné, sans boîte noire, et sous votre contrôle total** (ADR-214). Le rythme d'activité (fenêtres horaires par classe de jour semaine/week-end) et les demandes récurrentes (« chaque lundi vers 9 h, les e-mails ») sont désormais appris par des **statistiques déterministes calibrées par simulation** : présence par jour (jamais par message — le comptage par message fabrique des faux positifs mesurés à 83-100 %), borne de Wilson à 99 %, cohérence split-half, hystérésis anti-clignotement. Résultat mesuré : **0 à 0,3 % de faux positifs** sur un usage sans habitude, détection à 98-100 % en 21-28 jours, désapprentissage en 9 jours. Chaque seuil appliqué est publié à l'utilisateur (doctrine ADR-184) : une habitude affichée est prouvée, ou elle n'existe pas.

**La validation ne s'est pas faite sur des données de synthèse : le détecteur a été exécuté sur les données réelles de production, et il a été pris en défaut avant d'être cru.** Une action programmée quotidienne écrivait un message « utilisateur » à 07:00 depuis 66 jours — le détecteur revendiquait « 06:00-08:00 » : le planning du planificateur de LIA, pas l'habitude de la personne. Toutes les sources d'activité passent désormais par une **liste blanche des sessions humaines** ; le métronome a disparu, les verdicts honnêtes sont tombés. Deuxième réfutation : la conversation étant éphémère (réinitialisable à volonté), les messages ne sont pas une source durable — l'activité s'agrège désormais sur l'union de **quatre sources durables** (messages vivants, résumés de runs, journal des réinitialisations — un geste humain par construction, 124 jours de présence retrouvés sur le compte principal — et une banque quotidienne qui survit à tout).

**Tout est visible, quantifié et réversible.** Le panneau Habitudes montre le profil par classe de jour avec une **répartition horaire sur 24 créneaux** (axe des heures, intensités normalisées), le **pourcentage de jours actifs**, une **barre de progression du déblocage** (jours d'observation acquis sur requis — le seuil affiché est le seuil appliqué), les **candidats en observation** (« 3/4 jours distincts » avant qu'une récurrence ne soit prouvée), et pour chaque habitude un bloc « Pourquoi ? » avec les **jours d'occurrence réels** et les seuils du détecteur. Pause, blocage définitif (jamais réappris), suppression unitaire ou totale, recalcul rétroactif immédiat — et un interrupteur maître, éteint par défaut.

**L'assistant s'en sert avec retenue.** Le rythme appris contextualise les réponses et le briefing, le heartbeat peut signaler une routine manquée (au plus une offre par jour, arrêt définitif après deux offres ignorées), et le minutage des notifications peut préférer vos fenêtres apprises — **sans jamais élargir vos bornes** : intersection vide, comportement inchangé, garanti par une règle anti-famine testée en géométrie complète.

### Added

- **Domaine `habits`** : détecteur de rythme pur (fenêtres 2-4 h par classe de jour, verdicts honnêtes `windows`/`diffuse`/`none`/`insufficient`/`sparse`), récurrences v2 (signature par domaines, verrous quotidien/jours-ouvrés/hebdomadaire à moyenne circulaire), promotion en habitudes persistées, job nightly avec saut de delta (ADR-214).
- **Panneau Habitudes** complet dans les réglages : profil, heatmap 24 créneaux avec axe des heures, progression de déblocage quantifiée, candidats en observation (plafond énoncé, jamais silencieux), explication par habitude (jours réels + seuils appliqués par type de détecteur), actions par ligne, recalcul immédiat, oubli total — six langues.
- **Sources durables** : agrégation par union max (messages ∪ résumés de runs ∪ réinitialisations ∪ banque quotidienne `user_activity_days`) — l'apprentissage est **rétroactif** dès l'activation et survit aux réinitialisations de conversation.
- **Réactions mesurées aux écarts** : routine manquée (offre de service, jamais une remarque de surveillance), heure inhabituelle, retour d'absence **relatif au rythme propre** de chacun — budgets ≤ 1/jour, cooldown 7 jours, arrêt après 2 non-adhésions.
- **Scoring déterministe du minutage** (drapeau dédié, éteint par défaut) : un tick de notification hors fenêtre apprise attend seulement s'il reste une occasion le jour même dans vos bornes — anti-famine garanti.
- **Reconstruction du registre de récurrences** depuis la vérité durable (`product_outcomes`) après toute perte Redis — même liste blanche humaine, écriture uniquement sur registre vide.
- **Boucle de retour** : le pouce sur une notification issue d'une habitude ajuste ses signaux — deux retours négatifs la mettent en sourdine.

### Changed

- **Le format du registre de récurrences** descend en infrastructure partagée (`recurrence_store`) — trois domaines lisaient la même clé Redis par littéraux dupliqués, plus aucun.
- **Le domaine du tour courant** est capturé au streaming et validé au producteur (`product_outcomes.domain` n'est plus `unknown`) — la télémétrie produit et l'apprentissage des récurrences partagent le même seam.
- **Les seeds SQL du dépôt reflètent l'état actuel de la production** (tarifs, catalogue de 122 modèles, configuration LLM, personnalités) — extraction en lecture seule, formats et clauses d'origine préservés.
- **`_extract_user_settings` du runner proactif** expose la préférence habitudes ; le gabarit d'environnement documente 24 nouveaux réglages calibrés (`HABITS_*`, `RECURRENCE_*`).

### Fixed

- **Les messages injectés par les actions programmées passaient pour de l'activité humaine** dans l'historique antérieur au marqueur — corrigé par la liste blanche de sessions sur toutes les sources, faux positif prouvé puis éliminé sur données réelles de production.
- **Le bouton « Recalculer maintenant » pouvait être un non-événement silencieux** : le saut de delta ne voyait pas un historique étendu vers l'arrière — le recalcul manuel force désormais le passage complet.
- **L'heure minuit (0) était lue comme une borne absente** par le scoring de minutage — un utilisateur en bornes nocturnes aurait vu ses notifications différées vers une fenêtre inatteignable.
- **L'explication d'une habitude récurrente publiait les seuils du détecteur de rythme** — des nombres que l'évaluation des verrous n'applique jamais ; chaque type publie désormais ses propres seuils (ADR-184).
- **Un échec de lecture pendant la reconstruction du registre n'empoisonne plus la transaction** du recalcul (savepoint).
- **La légende de progression disait « jours d'activité » pour un compte de jours d'observation** — reformulée dans les six langues.

### Tests

- **18 276 tests backend** et **5 048 tests frontend** : détecteur de rythme table-driven (géométrie des fenêtres, wrap minuit, hystérésis, clipping nouveau compte), récurrences v2 (verrous, split-half, promotion plafonnée), contrat de clé du registre épinglé sur ses trois lecteurs, sources durables (union max, banque alimentée avant tout saut), scoring de minutage (10 cas de géométrie, anti-famine, fail-open), candidats (plafond compté, tombstones exclus, Redis absent), seed (NX, caps, savepoint, liste blanche), panneau (23 cas dont axe des heures, progression, candidats, explication) — plus quatre gardes AST/CI reconduites.

## [1.27.14] - 2026-08-05

**Un déploiement ne dérange plus la pile qui sert** (ADR-211). Sept jours de logs de production relus ligne à ligne, et le défaut le plus grave n'était pas dans la liste de départ : le déploiement reconstruisait son répertoire **en place**, or un montage lié est résolu vers un **inode** à la création du conteneur. Supprimer le contenu du répertoire ne remplace donc pas les fichiers vus par les conteneurs en cours — cela détruit les inodes sous leurs pieds. Constaté **en direct, en plein déploiement** : l'API qui répondait aux utilisateurs voyait ses identifiants Firebase, sa base de connaissances et ses skills comme des **répertoires vides**, pendant les dix minutes du build. Les notifications push échouaient, la FAQ ne répondait plus, et rien ne reliait ces symptômes à leur cause. Le bundle est désormais déposé dans un répertoire d'attente puis basculé par **renommage** : un renommage préserve l'inode, donc les conteneurs encore vivants gardent des montages valides jusqu'à leur recréation délibérée. Les deux générations précédentes restent sur disque, prêtes pour un retour arrière immédiat.

**Les sauvegardes de base de données existent enfin.** La même suppression emportait les dumps PostgreSQL, dont le répertoire était configuré **à l'intérieur** de l'arborescence remplacée : mesuré le 5 août, il était vide et horodaté à l'heure exacte du déploiement. Le service de sauvegarde écrivait consciencieusement, depuis des mois, des fichiers qu'aucune restauration n'aurait pu utiliser — une rétention réelle nulle, que rien ne signalait. Les sauvegardes vivent maintenant hors de portée de tout déploiement, et le script prévient explicitement si la configuration les y ramène.

**Une conversation en cours n'est plus tuée à la hache.** Uvicorn attend la fin des connexions avant d'exécuter l'arrêt applicatif, mais un flux SSE ne se termine jamais de lui-même : l'attente était infinie, le drain des conversations n'était jamais atteint, et Docker tranchait après quatre-vingt-dix secondes. **Trente et un arrêts sur quarante-deux** se terminaient ainsi sur la semaine auditée ; ce déploiement s'est terminé sur **zéro**.

**Un verdict permanent ne se rejoue plus comme une panne passagère.** Un jeton de notification mort était retenté pendant trois jours parce que la classification lisait le _texte_ du message d'erreur au lieu de son _type_ — et le mot cherché n'apparaissait pas dans la réponse du fournisseur. La règle vaut désormais partout : un compte en attente d'activation reçoit la page qui explique l'attente au lieu d'une application qui semble cassée, et le plafond de requêtes ne se laisse plus contourner par un en-tête que l'appelant écrivait lui-même.

**La plateforme de logs survit aux questions qu'on lui pose.** Six champs à valeurs ouvertes étaient promus en index — dont un identifiant unique par requête — ce qui multiplie les flux conservés en mémoire : quatre arrêts brutaux de Loki en une semaine, dont deux déclenchés par une seule requête d'analyse. L'outil s'effondrait au moment précis où l'on en avait besoin. Ces champs restent parfaitement interrogeables, mais à la lecture. Au passage, le transport cesse d'écraser le contenu structuré des journaux qu'il transmet, et les catalogues de traduction du backend — absents de l'image de production depuis l'origine — sont enfin livrés.

### Added

- **Déploiement atomique** : dépôt dans un répertoire d'attente, bascule par renommage (l'inode est préservé, donc les conteneurs en service gardent leurs montages), deux générations conservées pour un retour arrière, purge au-delà (ADR-211).
- **Contenu de référence d'une installation neuve** accessible en production (personnalités, tarifs des modèles), protégé par deux conditions indépendantes : une intention explicite **et** une cible vérifiablement vide — le comptage ne déclenche plus rien, il ne fait que refuser.
- **Point de résolution unique de l'identité appelante**, préférant l'en-tête que l'appelant ne peut pas écrire ; la valeur est analysée avant d'être crue, et le résolveur ne peut jamais faire échouer une requête (ADR-213).
- **Concurrence bornée** pour le lot d'actions programmées, réglable par variable d'environnement (`SCHEDULED_ACTIONS_MAX_CONCURRENCY`) — la valeur 1 restaure exactement l'ancien comportement séquentiel.

### Changed

- **Politique de labels du transport de logs** : un seul champ borné reste indexé, les six champs à cardinalité ouverte se filtrent désormais à la lecture ; l'étape qui remplaçait la ligne par un seul champ est supprimée, et l'extraction se limite à ce que les étapes suivantes consomment (ADR-212).
- **Sévérité des événements d'authentification alignée sur leur origine** : une session expirée ou absente est un événement de cycle de vie, un identifiant refusé reste un signal de sécurité. Le code HTTP renvoyé est inchangé.
- **Répertoire des sauvegardes PostgreSQL déplacé hors de l'arborescence déployée**, dans les gabarits comme dans le compose ; le déploiement avertit si la configuration l'y ramène.
- **Quatre requêtes de tableaux de bord migrées** vers un filtrage à la lecture, conséquence de la politique de labels.

### Fixed

- **Le déploiement détruisait les fichiers montés dans les conteneurs en service** pendant toute la durée du build (identifiants Firebase, base de connaissances, skills système) — d'où les échecs récurrents d'initialisation des notifications et d'indexation de la FAQ (ADR-211).
- **Toutes les sauvegardes PostgreSQL étaient effacées à chaque déploiement** : le répertoire de dumps se trouvait dans l'arborescence remplacée. Rétention réelle nulle depuis la mise en place du service.
- **L'API n'était jamais arrêtée proprement** : un flux SSE ouvert bloquait indéfiniment la phase d'attente d'uvicorn, le drain des conversations en cours n'était jamais atteint et le conteneur était tué après quatre-vingt-dix secondes (31 arrêts sur ~42 sur sept jours).
- **Les catalogues de traduction du backend n'étaient pas livrés en production** : 167 chaînes utilisées sur 125 sites d'appel retombaient sur leur texte source, dans les six langues. Invisible en développement, qui monte l'arborescence complète.
- **Un jeton de notification définitivement invalide était retenté indéfiniment** — la classification comparait le texte du message d'erreur au lieu de son type. Le chemin de diffusion, lui, ne désactivait jamais aucun jeton : il se contentait de masquer la ligne de journal.
- **Le plafond global de requêtes était contournable** : la clé de comptage dérivait d'une adresse que l'appelant fournissait lui-même, si bien qu'en la faisant varier on obtenait un budget neuf à chaque requête. Les données de provenance en étaient également faussées.
- **Un compte en attente d'activation chargeait toute l'application authentifiée** pendant la redirection, ouvrant deux flux de notifications qui rejouaient cinq fois un refus permanent — un flux d'événements ne voit pas le code HTTP et traitait ce refus comme une coupure réseau.
- **Toute exception traversant une session de base de données était rapportée comme une erreur de base**, avec sa trace : 45 faux incidents en sept jours, dont aucun ne touchait la base de données.
- **Un réglage désactivé était signalé comme un avertissement à chaque appel de modèle** (828 occurrences en une semaine, deuxième avertissement le plus fréquent de la plateforme) — il est désormais annoncé une fois par processus.
- **Le contenu structuré des journaux était écrasé en transit** dès qu'une entrée portait un champ `message`, rendant illisible à l'analyse ce que l'application avait pourtant émis.
- **Un objet du registre de données revenait dégradé après reprise d'une conversation** : son type manquait à la liste d'autorisation du sérialiseur de points de reprise.
- **La porte de seeding pouvait interpréter un échec de lecture comme une base vide** et déclencher un remplissage destructeur : elle échoue désormais du côté sûr, et un comptage illisible refuse au lieu de procéder.

### Tests

- **18 128 tests backend** et **5 018 tests frontend** : budget d'arrêt dérivé des fichiers de déploiement, répertoires runtime de l'image (chaque répertoire doit être copié ou exempté avec sa raison), porte de seeding (prémisse destructive assertée, veto après intention, refus sur comptage illisible, montage en lecture seule), complétude de la liste d'autorisation **dérivée des annotations d'état**, classification des jetons de notification par type, politique de labels du transport **dérivée de la configuration** et vérification des tableaux de bord, classification des exceptions de session, annonce unique du réglage désactivé, résolution de l'identité appelante (topologie de production, IPv6, valeurs malformées, scopes incomplets), concurrence bornée du lot d'actions, coquille authentifiée non montée pour un compte en attente.
- **59 tests Pester** sur le pilote de déploiement, dont la fixture corrigée pour porter les catalogues de traduction.
- **Plancher de couverture frontend relevé** : instructions 70 → 71 (mesuré 73,33 / 69,40 / 69,50 / 73,93). Backend maintenu à 64 (mesuré 66,99 — le palier suivant laisserait 1,99 point, sous la marge de deux points que le dépôt s'impose).

## [1.27.13] - 2026-08-05

**Une action cliquée ne se rejoue plus toute seule** (ADR-210). Quatrième mode de défaillance des liens profonds du chat, mesuré en production : « Prépare une réponse au mail… », lancée depuis le tableau de bord, s'exécutait correctement — puis se **ré-exécutait à l'identique** à chaque retour sur la page chat (deux lignes identiques en base à 27 secondes d'écart, chacune suivie d'un « Annuler »). La cause n'était pas dans l'application mais dans ce qu'elle ne peut pas atteindre : depuis qu'un clic d'action est une vraie navigation (ADR-192), l'URL qui porte l'ordre est une **visite de premier rang dans l'historique du navigateur** — omnibox, sites les plus visités, restauration de session — et le nettoyage d'URL ne touche que l'entrée de session, jamais la base de visites. Trois durcissements successifs avaient policé le support ; chacun a été contourné par une nouvelle voie de résurrection. **L'idempotence se pose désormais au point de consommation** : chaque clic frappe un identifiant à usage unique, consommé dans un registre local borné au moment exact où l'URL est nettoyée. Une URL ressuscitée porte un identifiant déjà consommé : elle n'envoie rien et **dépose son texte en brouillon visible dans le composer** — jamais un envoi, jamais une disparition silencieuse. Les liens durables émis par le backend (« Lancer maintenant » d'une routine proposée) gardent leur contrat inverse, volontairement : chaque clic est un consentement, rejouable des jours plus tard.

**Le mode HTML enrichi ne peut plus écraser ses listes clé-valeur.** Le modèle a produit un markup parfaitement valide — un libellé long en clé, deux valeurs pour une clé — et la grille CSS l'a puni : la colonne des valeurs, dimensionnée par le contenu le plus large, était calculée à **0 pixel**, les métadonnées des e-mails s'égrenant caractère par caractère hors de la bulle. La colonne clé est désormais plafonnée par son contenu (jamais par l'espace libre), chaque valeur est épinglée dans sa colonne quel que soit le nombre de valeurs par clé, et la directive publie enfin la contrainte qu'elle attendait (une clé est un libellé court). Les messages déjà en base se réparent d'eux-mêmes à l'affichage — le HTML stocké est re-stylé, aucune migration.

**L'essentiel se voit désormais sur téléphone.** La **pastille de contexte** (jauge de compaction de la conversation) rejoint le centre du bandeau du chat, à droite de l'indicateur d'espaces de connaissances, **à toutes les largeurs** — elle était masquée sous 880 px. La section **Consommation** du tableau de bord s'ouvre dépliée : les chiffres se consultent sans un clic de plus, et le pli reste disponible. Et **Exporter** devient un bouton de premier rang sur Mémoire à long terme, Centres d'intérêt et Journaux personnels : replié dans le menu « ⋯ » du téléphone, il se lisait comme absent — la barre de section gagne un contrat d'épinglage (`pinned`), le menu ne garde que l'occasionnel et disparaît quand il serait vide, et la rangée se replie proprement sur les écrans de 360 px au lieu de déborder de sa carte.

### Fixed

- **Une action de carte du tableau de bord se ré-exécutait à chaque retour sur le chat** quand le navigateur ressuscitait l'URL du clic (historique, restauration de session) — l'intent est désormais à usage unique par construction ; rejouée, l'URL préremplit le composer au lieu d'envoyer (ADR-210).
- **Les listes clé-valeur du mode HTML enrichi rendaient leur colonne valeur à 0 px** dès qu'une clé était longue ou portait plusieurs valeurs — `fit-content(40%)` + colonnes explicites `dt`/`dd` ; les réponses déjà archivées se réaffichent correctement sans migration.
- **La pastille de contexte de conversation était invisible sur mobile** (masquée sous 880 px) — visible et centrée à toutes les largeurs, totaux dans son infobulle au tap.
- **Exporter ses mémoires, ses centres d'intérêt ou son journal exigeait d'ouvrir le menu « ⋯ » sur téléphone** — bouton épinglé en ligne à toutes les tailles sur les trois écrans.
- **À 360 px, la barre d'actions épinglée débordait du cadre de sa carte** — le groupe d'actions se replie en seconde rangée alignée à droite.

### Tests

- **18 041 tests backend** (985 fichiers) et **5 014 tests frontend** (+27) : registre d'intents consommés (FIFO borné, échec ouvert, corruption, inter-onglets), rejeu dégradé en brouillon jamais exposé un seul rendu, nonce unique par clic, contrat sans-identifiant préservé pour les liens backend, priorité du composer, épinglage des barres de section (composant + pose du drapeau par écran), Consommation dépliée.
- **Nouveau parcours hermétique sur bundle de production** `chat-intent-replay.spec.ts` : résurrection par chargement complet, aller-retour client par-dessus l'entrée empoisonnée du routeur, rechargement — une seule exécution ; contrat clic-=-consentement des liens sans identifiant épinglé. Mocks chat factorisés dans une fixture partagée.
- **Planchers de couverture frontend relevés** : branches 66 → 67, fonctions 66 → 67 (mesuré 72,79 / 69,12 / 69,11 / 73,35).

## [1.27.12] - 2026-08-05

**Le panneau de debug se lit désormais comme l'exécution elle-même** (ADR-209). Construit par itérations, il mentait sur la chronologie : la requête s'affichait après la décision de routage, les vagues _prévues_ après l'exécution _réelle_, et une liste de nœuds entretenue à la main rangeait tout nœud inconnu **après la réponse** — en mode ReAct, la boucle du modèle semblait s'exécuter après la réponse qu'elle avait produite. Chaque appel LLM (et chaque génération d'image) porte désormais une **position de départ ancrée sur la ligne de temps du run**, partagée entre le pipeline et ses tâches d'arrière-plan : la trace s'ordonne d'elle-même par ce qui s'est réellement passé, et un **waterfall** rend lisible d'un coup d'œil ce qui s'est exécuté en série ou en parallèle.

**La lecture suit sept phases numérotées, dans l'ordre du run** : requête, analyse du routeur, planification, exécution, contexte de la réponse, extractions d'arrière-plan, bilan transversal. Sur un tour conversationnel, les deux tiers des sections sont vides — elles se replient derrière un discret « N idle sections » par phase au lieu d'empiler des lignes mortes. Et chaque étape jusqu'ici invisible a gagné sa section : le **verdict du validateur sémantique** (informatif — un plan rejeté s'exécute quand même, la doctrine ADR-184 est écrite dans le panneau), la **boucle ReAct** face à sa borne d'itérations **publiée**, les portes **HITL** (interrompu / repris, avec la décision), la **compaction de contexte** (stratégie, tokens économisés), la **génération d'images** (que le backend émettait depuis longtemps sans aucun consommateur), la **dépense de synthèse vocale**, et le coût LLM de l'extraction d'engagements.

**Une seule grammaire de présentation remplace trois langues mélangées et une palette mono-thème.** Les statuts prennent leurs couleurs des jetons du design system — héritant de la garde de contraste des cinq thèmes en clair comme en sombre — quand l'ancien panneau mêlait des verts « sombre seulement » à des gris « clair seulement » ; les nœuds du pipeline portent des **familles d'identité bi-thèmes** (analyse, planification, exécution, ReAct, médias, extractions…) ; une barre de score unique dessine **son seuil de décision sur la barre** ; et une étape simplement non exécutée s'affiche en neutre — l'ancien badge rouge « FAIL N/A » accusait une absence.

**Identifier un problème prend cinq secondes.** Un canal d'anomalies collecte les signaux d'échec — étape ratée, planification en mode panique, zone de budget critique, plafond ReAct atteint, erreurs d'extraction — et **Zod y joue en détecteur** : un payload qui dévie de son contrat devient une alerte visible, jamais une section masquée. Le tout remonte sur l'en-tête de chaque requête, avec un **bandeau de synthèse scannable** (route, moteur, durée, tokens, coût total) qui permet de comparer les requêtes de l'historique sans en déplier une seule.

### Fixed

- **« Execution Times » plaçait les nœuds ReAct après la réponse** : l'ordre venait d'une liste manuelle qui apposait tout nœud inconnu à la fin — supprimée au profit de la chronologie ancrée au run.
- **Le tri chronologique du pipeline entrait en collision entre contextes** : le compteur `sequence` repart à 1 dans chaque tâche d'arrière-plan, l'appel n° 1 d'une extraction se mélangeait à celui du routeur.
- **Deux faux positifs du détecteur de schémas, trouvés en conditions réelles** : l'énumération de routage ignorait la route directe `response`, et deux champs jamais émis par le mécanisme de bascule conversation étaient exigés — un tour nominal s'affichait avec trois anomalies au lieu d'une.
- **Une action d'extraction inconnue s'affichait « CREATE »** : le repli silencieux inventait une action ; elle s'affiche désormais telle quelle, en neutre.
- **L'horodatage des requêtes était figé en `fr-FR`** ; il est désormais un « HH:MM:SS » 24 h déterministe, insensible à la locale du navigateur.
- **Le bouton de dépliage d'une requête n'exposait pas `aria-expanded`** ; l'état est annoncé.
- **Le panneau d'erreur du debug était illisible en thème clair** (jaunes calibrés sombre uniquement) ; il parle désormais les jetons `warning`.
- Purge du code mort accumulé : palettes de couleurs héritées, constantes sans consommateur, validateurs jamais branchés, liste de nœuds backend orpheline.

### Tests

- **18 041 tests backend collectés** (985 fichiers) et **4 987 tests frontend** — dont ~110 nouveaux sur le panneau : fondation des tons et familles de nœuds, barres de score, les 30 sections en ordre d'exécution, dérivations presence/anomalies, orchestrateur, détecteur de schémas rejoué sur un payload de production réel.
- **Planchers de couverture frontend relevés sur les quatre axes** : 68/62/64/69 → **70/66/66/71** (mesuré 72,66 / 68,76 / 68,98 / 73,22). Ratchet de complexité resserré : 50 → 48 hotspots. `chat/service.py` décroît de 39 SLOC (extraction `run_records.py`).
- Preuve runtime en conteneurs dev : requête réelle tracée de bout en bout, waterfall et compteur d'anomalies vérifiés dans les deux thèmes.

## [1.27.11] - 2026-08-04

**L'écart entre un libellé et son champ existait dans le code, jamais à l'écran.** La primitive d'étiquette restait sur le rendu `inline` du navigateur, et les marges verticales d'un élément inline sont **calculées mais jamais rendues** : trois recalibrages successifs de l'espacement ont changé le code sans changer un seul pixel, et chaque formulaire de l'application vivait depuis toujours avec ~3 px d'écart quel que soit le réglage. Le défaut est corrigé **à la primitive** — une étiquette est un bloc — et l'écart canonique a été arbitré **sur captures réelles** dans un navigateur piloté, mesuré au pixel après coup. Leçon consignée en doctrine : quand un réglage d'espacement n'a aucun effet visible, mesurer le `display` de l'élément avant de soupçonner la chaîne de livraison.

**Une rangée expose ses actions d'une seule façon** (ADR-208). Trois écrans à catégories — mémoire, centres d'intérêt, journaux — avaient trois grammaires : des boutons révélés au survol (sur lesquels un utilisateur clavier **tabulait sans rien voir**), un appui-n'importe-où ouvrant une boîte de dialogue plein écran dupliquée par écran, et des actions permanentes. Désormais : icônes toujours visibles dès la tablette, la suppression portant son rouge **au repos**, et sur téléphone un unique « ⋮ » ouvrant un menu léger — un appui de moins, et le déclencheur **nomme la rangée** pour un lecteur d'écran. Les barres de section suivent la même règle : « + Ajouter » garde son libellé à toutes les tailles, et **Exporter revient sur téléphone et tablette** — il était purement supprimé sous 1024 px.

**Une action a une altitude, et l'altitude choisit la forme** (ADR-207). Le bouton qui crée est plein et thémé partout ; « tout supprimer » est plein, rouge, et à la même taille que ses voisins ; l'icône de suppression d'une ligne porte son rouge sans attendre le pointeur ; le contour ne signifie plus qu'une chose — une vraie secondaire. Les étiquettes de compétences prennent leur couleur d'une table unique, et les cinq cartes « Télécharger CSV » alignent enfin leurs boutons sur une même ligne, côté utilisateur comme côté administration.

**Une primitive porte son contrat** (ADR-206). Un champ nommé l'est par un identifiant stable — plus jamais par le texte de son étiquette, qui change de langue et se répète entre champs homonymes ; une erreur de saisie est **annoncée** (`aria-invalid`, description additive), pas seulement rougie ; les primitives partagées parlent les six langues au lieu d'un anglais codé en dur ; un état vide propose une sortie ; et le halo de focus n'est plus **blanc sur thème sombre** — le jeton d'écart de l'anneau n'existait pas, huit composants le demandaient dans le vide.

**Les réglages se lisent comme un index.** Les Connexions passent de six blocs plats à cinq sections repliables icônées dont les badges disent ce qui attend à l'intérieur — les demandes en attente comprises — et les partages des deux directions s'affichent **en miroir**, les vôtres modifiables, les leurs en lecture seule alignée. Les Journaux replient leur configuration entière derrière une seule entrée et déplacent leurs boutons **sous** les catégories : on lit d'abord, on agit ensuite ; le contenu long se limite à trois lignes avec « Voir plus », les métriques d'expertise se replient, le niveau L0-L3 reste visible. Une routine annonce « **En semaine à 08:00** » au lieu d'énumérer cinq jours, montre sa prochaine exécution et replie le reste : sa carte passe d'environ huit lignes à trois. La météo en déplacement, elle aussi, se replie.

**Et une salve de netteté, écran par écran** : l'authentification par application (TOTP) s'active au **commutateur** comme toute fonctionnalité — l'allumer ouvre la cérémonie, le pouce ne bascule qu'à la confirmation du serveur ; les groupes de connecteurs se nomment « **Services** Google / Apple / Microsoft / externes » ; un export de données expiré dit **quand** il a été généré, quand il a expiré et quoi faire, un export prêt affiche sa taille et sa date limite ; « Déconnecter les autres appareils » porte le plein rouge des destructions de masse ; chaque carte du tableau de bord montre son icône dans la liste de personnalisation ; la puce de sélection d'un style se centre sur son icône ; la psyché s'active dans le même encadré que la mémoire. Deux règles gravées au passage : **un titre porte toujours une icône, à la couleur du thème** ; **un badge gris est réservé à l'inactif** — « Activé » est vert, « en attente » est bleu, « expiré » est gris.

**Les notifications poussées suivent désormais l'accord global, automatiquement.** Le réglage « notifications push » des notifications proactives faisait doublon avec l'activation générale — un second interrupteur qui pouvait rendre une fonctionnalité muette en silence. Il est retiré, et le serveur n'en tient plus compte : si le push est activé et la fonctionnalité active, elle notifie.

**Ce qui vient d'elle se voit, et ce qui doit tenir sur un téléphone y tient.** Dans le fil de conversation, une notification proactive porte un **léger fond rouge** — LIA qui prend la parole ne se lit plus comme LIA qui répond ; les messages relayés entre pairs gardent leur teinte bleue, la bulle d'erreur son verre neutre. Un souvenir épinglé s'encadre à la **couleur du thème**, l'épingle posée devant le texte sur la ligne de son icône — l'état se voit à toutes les tailles, plus seulement dans le menu d'actions. Les barres de section masquent l'icône de leurs boutons sur téléphone et raccourcissent leurs libellés — « Ajouter », « Effacer », « Importer », « URL », « Écrire », « Engagement » — pour que les trois actions d'une barre tiennent sur une ligne de 390 px. Les rangées d'engagements rejoignent la grammaire commune (icônes dès la tablette, « ⋮ » nommé sur téléphone), abandonnant quatre boutons artisanaux dont les couleurs de survol vivaient hors des jetons. Et une fiche de connexion encadre séparément « **ce que je partage** » et « **ce qu'il ou elle partage** », le côté du pair sur le lavis neutre des surfaces en lecture seule — les deux colonnes se lisaient comme une seule liste.

### Fixed

- **Au clavier, sur trois écrans, le focus se posait sur des boutons invisibles** : les actions révélées au survol ne se révélaient pas au focus. Le patron est supprimé, pas rafistolé.
- **Exporter ses mémoires ou ses centres d'intérêt était impossible sur téléphone et tablette** — le bouton était retiré sous 1024 px au lieu d'être replié.
- **Sept contrôles n'avaient aucun nom accessible** : la suppression d'un intérêt bloqué, l'édition et la suppression d'une entrée de journal, les quatre listes d'heures et de fréquence, l'interrupteur de la psyché.
- **Une icône passée à un libellé s'empilait au-dessus du texte** au lieu de le précéder — le socle CSS rend les icônes en bloc, le libellé ne les couchait pas en ligne.
- **Le compteur de mémoires était écrit en français dans le code**, quelle que soit la langue de l'interface ; il passe par les six locales et leurs pluriels.
- **Sept couleurs écrites à la main** — vert de copie, rouge d'interdiction, ambres d'avertissement, jauges — rejoignent les jetons du thème, couverts par le contrôle de contraste sur les cinq thèmes.
- **L'identifiant d'un champ dérivait de son étiquette** : deux champs homonymes partageaient un identifiant, qui changeait avec la langue. Il vient désormais d'un générateur stable.
- **La grille des réglages numériques des journaux et la puce des styles s'alignent** — les cellules mélangeaient deux espacements et la puce s'ancrait en haut.

### Tests

- Frontend 4 929 tests sur 402 fichiers (+99) ; 172 parcours navigateur hermétiques rejoués **contre un build de production**, 23 audits d'accessibilité — dont les scans des contenus repliés désormais ouverts avant l'analyse.
- Nouvelles gardes : l'étiquette est un bloc (les marges se rendent), les actions de rangée et barres de section (visibles, nommées, rouges au repos), les contrôles de fréquence nommés, la synthèse de planification, les tons `done`/`running`/`expired`, le contrat des champs sur le DOM rendu.
- Les quatre oracles TOTP réécrits pour le commutateur ; les tests des sections repliables ouvrent le repli avant chaque interaction.

### Documentation

- ADR-206 (une primitive porte son contrat), ADR-207 (une action a une altitude), ADR-208 (une rangée expose ses actions d'une seule façon) ; doctrine frontend enrichie de l'écart canonique, des icônes de titres et des badges gris.

## [1.27.10] - 2026-08-04

**Les compteurs des Alertes sont là avant que vous ouvriez quoi que ce soit.** Un badge sur un bloc replié existe pour qu'on choisisse quoi ouvrir ; il affichait `—` jusqu'au dépliage, si bien que le seul nombre qui sert à décider ne s'obtenait qu'en décidant. Les cinq totaux arrivent maintenant en **une seule lecture** — des agrégats sur colonnes indexées, pas les lignes elles-mêmes, qui attendent toujours l'ouverture. Une section qu'une instance a désactivée n'est pas comptée du tout : le hub ne l'affiche pas, la compter serait deux requêtes pour un badge invisible.

**Une priorité « haute » ne ressemble plus à une « moyenne ».** Les deux s'affichaient sur un fond pâle, et leurs deux teintes ne sont séparées que de **23 degrés** : sur un compte réel — 89 notifications hautes, 113 moyennes — le lecteur ne pouvait pas les distinguer. Ce n'est plus la teinte qui porte la hiérarchie mais la **densité** : « haute » est un fond plein, « moyenne » une teinte, « basse » reste neutre. La distinction tient même pour qui ne différencie pas les deux rouges, et même en niveaux de gris.

**Un statut nomme désormais une couleur, il ne l'écrit plus.** Trois écrans portaient chacun leur propre table de classes pour la même chose — une étiquette d'état. Écrites à la main, elles échappaient au contrôle de contraste qui vérifie chaque paire du système sur cinq thèmes en clair et en sombre. Une seule fonction décide maintenant, et un état que le serveur ajouterait plus tard s'affiche **neutre** plutôt qu'en rouge : afficher un niveau inconnu comme urgent serait une affirmation que personne n'a faite.

**Les boutons d'action se ressemblent enfin partout.** Le comptage a tranché : le style bordé est utilisé 137 fois dans l'application. Les actions d'une fiche de relation et les raccourcis des Alertes l'adoptent — un lecteur reconnaît une action à sa forme partout, ou nulle part.

**Un souvenir affiché sur une fiche de relation se clique.** Il y était en texte mort : le corriger ou le supprimer demandait de retrouver les réglages, puis la bonne section, à la main. Le lien mène à la section qui le contient — jamais à la ligne : la liste est paginée et filtrable, promettre d'atterrir sur ce souvenir précis serait faux dès qu'il est en deuxième page.

**Aussi** : les connexions entre pairs portent le rond à initiales du reste de l'application et leur nom en gras ; les icônes d'une fiche contact prennent une teinte par famille — joindre, dates, liens — ce qui rend visible une structure qui existait déjà ; l'objectif d'un appel se distingue de sa synthèse ; « envoyé » et « reçu » ont chacun leur couleur sur les messages relayés, les messages d'une fiche et les courriels ; les rendez-vous partagés et les courriels échangés ont enfin un compteur, comme leurs cinq voisines ; et tous les compteurs portent la couleur des autres badges de l'application.

**Sur un téléphone**, les blocs « Pourquoi LIA pense cela ? » et l'explication du poids d'un centre d'intérêt ne s'affichent plus : denses par nature, ils repoussaient hors de l'écran ce qu'on venait y lire.

### Fixed

- **Un objectif d'appel long se lisait comme du texte barré** : présenté en étiquette, il débordait d'une capsule dont la hauteur est fixe. Une étiquette est un mot, pas une phrase.
- **Le badge d'une section portait deux fonds superposés** — le composant qui l'accueille l'enveloppait déjà.
- **Le total d'un historique et le compteur qui le résume venaient de deux requêtes distinctes** écrivant deux fois le même filtre. Une seule implémentation désormais : la page délègue son total au compteur, et les deux ne peuvent plus diverger.
- **Une écriture de provenance sur un identifiant mal formé répondait « le serveur a cassé »** au lieu de « cela n'existe pas ».
- **Quatre suites de tests dépendaient de l'état global du processus** et rougissaient selon la répartition des workers : un registre d'agents réenregistré, et un journal figé avant sa capture — l'assertion se lisait « rien n'a été écrit », ce qui ressemble à un défaut de production sans en être un.

### Tests

- Backend 18 016 tests collectés sur 983 fichiers, frontend 4 830 ; 172 parcours navigateur, 23 audits d'accessibilité.
- Nouvelles gardes : distinction des trois priorités par la densité, teinte des compteurs, lien profond d'un souvenir, isolation des sondes de comptage et gate-keeper d'un sous-système désactivé.
- Le compteur d'un historique et le total de sa page sont vérifiés **contre un PostgreSQL réel** : même ensemble, même portée par compte, historique vide compris.

### Documentation

- ADR-205 (un statut nomme un ton, il n'écrit pas ses couleurs), et ADR-202 complété de la décision sur les compteurs repliés.

## [1.27.9] - 2026-08-04

**« Pourquoi LIA pense cela ? »** Un souvenir affirmait « vous préférez les réunions le matin » sans que personne — pas même vous — puisse savoir d'où cela venait. Sous chaque souvenir et chaque entrée de journal, un bloc replié montre désormais les signaux qui ont produit la conclusion, leur date, leur rôle, et un bouton **Corriger** qui ouvre l'édition. Ce qui est conservé est un **renvoi, jamais une copie** : le texte reste là où vous l'avez écrit. Supprimer une conversation ne fait donc pas revenir son contenu ici — le renvoi se vide et la ligne reste, datée : « ce signal a été supprimé ». L'inverse aurait fait disparaître jusqu'à la mention qu'une source ait existé, ce qui se lit comme « LIA a inventé cela ». La trace est **bornée à cinq signaux** par conclusion, et cette borne est **affichée** plutôt qu'appliquée en silence.

**Une destination « Alertes », pour ce qui vous a été adressé.** Messages relayés entre pairs, notifications proactives, notifications d'intérêt, rappels en attente, routines programmées : cinq flux qui vivaient repliés dans cinq panneaux de réglages différents. Savoir ce que LIA vous avait dit demandait donc d'ouvrir les réglages, de trouver le bon panneau parmi une trentaine et de déplier le bon bloc — cinq fois. Consulter était devenu une opération de configuration. Les cinq sections arrivent repliées **en affichant déjà leur nombre exact** — on choisit quoi ouvrir sans avoir à ouvrir pour le savoir — et se paginent par dix. Aucune liste n'est chargée tant que rien n'est déplié : seuls les cinq compteurs le sont, en une seule lecture. Les écrans de réglages restent la configuration détaillée et **tous leurs liens profonds restent valides** : rien n'est déplacé, rien n'est remplacé.

**Une carte du ciel de ce que LIA sait faire pour vous.** Chaque capacité est une étoile : pleine quand elle est active, en contour quand elle attend d'être allumée, et sa taille dit ce qu'elle contient. Le tracé qui les relie ne joint que les capacités actives, donc **sa forme est votre configuration** — personne d'autre n'a la même. Aucun niveau, aucun pourcentage d'avancement, aucune comparaison : « trois connecteurs reliés » est un fait, « 62 % » serait une compétition que personne n'a demandée. Le dessin est décoratif ; tout ce qui s'atteint est un vrai lien, nommé et utilisable au clavier. Un téléphone, ou une demande d'immobilité, reçoit la même carte en liste — mêmes données, même ordre, mêmes destinations : demander l'immobilité n'est pas demander moins d'information.

**Le poids d'un centre d'intérêt s'explique au lieu de se noter.** Le signal d'origine, la dernière mention, la dernière notification, les coefficients du calcul et le nombre de jours écoulés : de quoi refaire l'opération. Expliquer une incertitude est plus utile que d'en faire un score.

**Une option proposée au téléphone ne s'accepte plus toute seule.** Les suites d'un débrief d'appel **préremplissaient et envoyaient** le message d'un seul clic : un appel où l'interlocuteur avait avancé une date, un lieu ou un supplément tarifaire produisait donc un bouton qui vous engageait sur sa proposition. Elles préparent désormais le message sans l'envoyer, et ce que l'interlocuteur a réellement proposé est **affiché avant** les suites possibles — il était produit depuis des mois et n'était publié nulle part.

**Une seule gâchette d'action par ligne, et le libellé complet en bulle.** Les cartes du tableau de bord alignaient jusqu'à quatre pastilles d'action par ligne, prenant un quart à un tiers d'une largeur utile de 330 pixels — et le titre de l'élément était tronqué pour les payer. Un déclencheur unique réserve la même largeur quel que soit le nombre d'actions, donc **toutes les lignes de toutes les cartes ont enfin la même colonne de texte**.

**Aussi** : la section « Connexion LIA » d'une fiche de relation est désormais la dernière sur mobile, comme sur grand écran, et n'existe qu'une fois dans la page.

### Fixed

- **Votre avis sur une notification d'intérêt n'était jamais enregistré** : la carte archivée et la route d'enregistrement utilisaient deux identifiants différents pour la même notification. Corrigé aussi dans l'autre sens — un vote sur une carte marquait jusqu'ici **toutes** les cartes de la conversation comme jugées.
- **Le classement des centres d'intérêt et le poids affiché divergeaient** : deux fonctions portaient chacune leur propre taux de décroissance par défaut. Une seule source désormais.
- **Une écriture de provenance en échec empoisonnait la session** : l'exception était avalée mais l'appelant mourait sur l'instruction suivante. L'écriture est isolée dans un point de reprise — l'extraction qu'elle décrit survit intacte.
- **Un identifiant de souvenir mal formé répondait « le serveur a cassé »** au lieu de « cela n'existe pas », contrairement aux quatre routes voisines.
- **Une capacité sans décompte s'affichait « Active — 0 élément »**, ce qui se lit comme une capacité vide. La personnalité et la proactivité sont des interrupteurs : ils ne comptent rien, et le disent.
- **Trente et un endroits de l'interface ne peignaient rien, ou peignaient du noir.** Les infobulles des graphiques de santé et de personnalité, six dégradés et deux animations utilisaient une écriture de couleur héritée d'une version antérieure de Tailwind, invalide depuis la migration : un remplissage invalide retombe sur le noir, une déclaration invalide disparaît. Aucun test ne pouvait le voir — une étoile noire porte le même nom qu'une étoile bleue. Une garde lit désormais la feuille de style et refuse l'écriture morte.

### Tests

- Backend 18 002 tests collectés, frontend 4 808 ; 172 parcours navigateur, dont la carte des capacités, et 23 audits d'accessibilité.
- Nouvelles gardes : jetons de couleur Tailwind v4 sur toute l'interface, portée des jetons de la landing, géométrie de la constellation, isolation par point de reprise d'une écriture best-effort, et cohérence du taux de décroissance entre le classement et l'affichage.
- La provenance est vérifiée contre un PostgreSQL réel, pierre tombale comprise : dix scénarios, dont la suppression d'une conversation et celle d'un compte.

### Documentation

- ADR-201 (provenance bornée et pierre tombale), ADR-202 (ce qui se lit a sa propre destination), ADR-203 (aucune option acceptée à votre place), ADR-204 (expliquer vaut mieux que noter).

## [1.27.8] - 2026-08-03

**Votre pouce levé sur une notification proactive ne servait à rien.** La carte archivée dans le chat portait un identifiant fabriqué — `heartbeat_a3f2c1d8` — quand la route d'enregistrement attend un identifiant réel. Chaque vote partait donc en erreur, silencieusement avalée pour ne pas déranger. Résultat mesuré : **aucun retour n'avait jamais été enregistré**, et un tableau de bord lisant cette table en aurait conclu que personne ne jugeait jamais rien. L'identité est désormais décidée **avant l'envoi** et la même des deux côtés. Les cartes déjà archivées portent un identifiant qu'aucune route ne peut résoudre : leur bouton n'est plus affiché du tout, plutôt que d'offrir un geste qui n'enregistrerait rien.

**Une routine s'exécutait deux fois, une nuit par an.** Au passage à l'heure d'hiver, l'heure inscrite existe deux fois : « la prochaine exécution après maintenant » retombait sur la même heure, soixante minutes plus tard. Mesuré contre le planificateur réel sur les transitions 2026 de sept fuseaux : **54 doubles exécutions**, et l'heure touchée dépend du fuseau — Santiago est frappé à 23 h, pas à 2 h du matin. La règle est désormais celle du modèle lui-même : une heure par jour signifie **au plus une exécution par jour local**. Le bouton « tester maintenant » en est explicitement distingué : lui appliquer la même règle aurait _supprimé_ l'exécution du jour pour qui teste une routine de 8 h à 7 h.

**Être connecté à un service et se laisser interrompre par lui sont deux décisions.** Pour ne plus recevoir de relances liées au courrier, la seule voie documentée était de **déconnecter le connecteur** — ce qui retire aussi l'outil avec lequel on pose ses questions. Onze interrupteurs séparent maintenant les deux, un par source. Ils sont **tous actifs par défaut** et le refus est stocké, jamais l'autorisation : un compte existant ne change pas de comportement, et une source ajoutée plus tard est active tant que personne ne l'a refusée. Au passage, la santé — huitième source calculée par le serveur depuis des mois — n'était affichée nulle part.

**Un interrupteur allumé qui ne produit rien le dit maintenant.** Le conseil de départ lit l'agenda déjà récupéré : refuser l'agenda le rendait muet pour toujours, sans que rien ne l'explique. La dépendance est déclarée, vérifiée au démarrage dans les deux sens, et **publiée** au panneau, qui affiche « nécessite l'agenda » sur l'interrupteur concerné.

**Le chat vide propose ce que LIA sait déjà de votre journée.** Trois amorces génériques laissaient place à des propositions ancrées — un rendez-vous à préparer, un lot de courriels, un engagement qui attend, un rappel en cours. Rien n'est récupéré pour les produire : elles ne naissent que d'informations déjà connues, sans réveiller un connecteur ni dépenser un quota, et **un cache froid rend la liste vide** — cas ordinaire, pas dégradé, qui affiche alors les amorces génériques. Les rappels sont lus en direct : ils vivent en base locale, se lisent en moins de dix millisecondes, et c'est la seule source qu'un compte sans aucun connecteur puisse alimenter.

**Le tableau de bord ouvre sur ce que LIA a produit, pas sur ce qu'elle a consommé.** Quatre chiffres exacts — résultats confirmés utiles, actions abouties, routines exécutées, engagements clôturés — devant les messages, jetons et coûts, désormais repliés sous « Consommation ». Deux candidats ont été **écartés plutôt qu'estimés** : le « temps gagné », qu'aucune donnée ne mesure ici, et les « documents effectivement utilisés » — un extrait injecté dans un contexte n'est pas un document utilisé, et rien ne le consigne durablement. Une instance qui ne mesure pas ses résultats **le dit** au lieu d'afficher quatre zéros : « vous n'avez rien accompli » et « rien n'est compté » sont deux phrases différentes, et une seule serait vraie.

**Les réglages de proactivité montrent enfin ce qu'ils produisent.** Les dix dernières notifications proactives avec leur date, leur contenu, les sources utilisées et le verdict déjà donné — et, à l'identique, celles des centres d'intérêt. On pouvait jusqu'ici régler une fréquence et des sujets sans jamais voir ce que cela donnait. Une limite assumée : la table d'audit des intérêts ne conservait qu'une empreinte du message, jamais le texte. Il est gardé à partir de cette version ; les notifications antérieures s'affichent **sans leur paragraphe**, parce qu'une empreinte ne s'inverse pas et qu'un résumé reconstitué serait pire qu'une absence.

**Trois blocs se replient, et se replient fermés** — les onze interrupteurs, les deux historiques : le panneau devient un index qu'on ouvre plutôt qu'un mur qu'on parcourt. Replié ne veut pas dire caché mais **démonté** : un bloc fermé ne coûte aucune requête, et l'ouvrir en coûte exactement une. Le nombre de sources refusées reste porté par l'en-tête — replier ne doit pas dissimuler une décision.

**Partager une réponse avec un proche connecté.** Sous une bulle de l'assistant, le menu « … » propose les pairs acceptés ; le choix prépare la demande dans le composeur. Rien n'est envoyé depuis le navigateur : la transmission emprunte la route ordinaire — l'assistant, l'outil de relais, et la confirmation qu'il réclame.

**Les gestes d'un engagement sont là où vous le lisez.** Marquer fait, classer sans suite et corriger sont désormais sur la carte « Pour vous » du tableau de bord, avec le registre complet toujours à un clic. Les deux surfaces écrivent par le même chemin et partagent le même éditeur.

**Aussi** : le portrait de LIA se choisit par deux vignettes visibles plutôt que par un clic invisible sur toute l'image ; une routine se duplique, formulaire prérempli et titre suffixé, sans rien créer avant validation ; l'aperçu des cinq prochaines exécutions affiche l'heure **du fuseau de la routine** et signale les changements d'heure, les instants venant du planificateur et jamais d'une seconde lecture du cron dans le navigateur ; un rappel s'annule depuis sa carte, par identifiant exact plutôt que par ressemblance de texte ; la galerie de photos se parcourt entièrement au clavier ; « Créer un rappel », « Créer une routine » et « Ouvrir mes espaces » rejoignent les commandes rapides ; et un retour tactile bref accompagne les gestes sur mobile — **réglage distinct** des animations réduites, parce que vouloir une interface immobile n'est pas vouloir un téléphone muet.

### Fixed

- **Le libellé des routines était en anglais** pour les comptes allemand, espagnol, italien et chinois, dans un texte que le modèle relit.
- **Une notification d'agenda sans titre** s'affichait « Untitled » quelle que soit la langue demandée — et le test figeait ce comportement en réclamant du français.
- **Trois chiffres de résultats pouvaient se contredire** : comptés par trois requêtes séparées, les actions pouvaient dépasser le total qui les contient. Une seule passe désormais.
- **Le focus disparaissait** après l'annulation d'un rappel, la suppression d'une routine ou la clôture d'un engagement : le clavier retombait en haut de page.
- **Un commutateur d'activation de routine n'avait aucun nom** pour les lecteurs d'écran, et le nom du fuseau des occurrences n'atteignait pas le contraste minimum.
- **Un identifiant de suggestion inconnu** aurait inséré une clé technique dans le composeur ; une priorité inconnue s'affichait en clair dans l'historique.
- **Un titre de routine contenant un emoji** pouvait être tronqué au milieu du caractère lors d'une duplication.
- **Le menu de partage coûtait cinq requêtes par réponse affichée** — 120 appels mesurés sur une conversation de douze réponses. Il n'en coûte plus aucune tant qu'il reste fermé.
- **La carte « Pour vous » gardait un engagement déjà clôturé** à l'écran, si bien qu'un second clic échouait.

### Tests

- Backend 17 925 tests collectés, frontend 4 690 ; 158 parcours navigateur, 23 audits d'accessibilité.
- Planchers de couverture relevés : branches 61 → 62, fonctions 63 → 64, lignes 68 → 69 côté frontend.
- Nouvelles gardes : symétrie des suggestions et de la borne de titre avec le backend, coût réseau du menu de partage, débordement mobile de Relations dans les six langues, et blocs de réglages repliés.
- Le tableau de bord n'avait **jamais** été audité en accessibilité : la charge de test utilisée était impossible et l'écroulait derrière son garde-fou, si bien que l'audit rendait un rapport vert sur une page d'erreur.

### Infrastructure

- Les images de développement portent enfin un nom distinct de celles de production (`lia-api-dev`, `lia-web-dev`). Une construction de production locale écrasait silencieusement l'environnement de développement — deux occurrences.

## [1.27.7] - 2026-08-02

**L'assistant répondait par son propre diagnostic.** Quand un plan qui écrit épuise ses tentatives de correction, il refuse de l'exécuter — c'est un garde-fou, et il est juste — et demande à l'utilisateur de trancher. Sauf que la question posée était le **diagnostic interne**. Un compte en français a reçu `for_each pattern issue detected`, puis `Fabricated placeholder contact detail: step_2.to='jerome@example.com'` : du jargon, un chemin de code, et une adresse inventée qu'on pouvait croire tirée de son carnet d'adresses. Quatre fois en trente jours. Le commentaire du code affirmait que ces textes étaient déjà traduits ; c'était faux pour les cinq règles déterministes, dont la documentation dit elle-même qu'ils servent à la trace, pas à l'utilisateur. **Mais c'était vrai pour l'autre voie** : quand un modèle analyse le plan, il écrit quelque chose de précis et dans la bonne langue — « La date de début est incorrecte (samedi 18 à 9h30 demandé) » — et un test existant le protégeait à raison. Le premier correctif l'aurait détruit. Désormais **quinze questions, dans les six langues**, refusées au démarrage si l'une manque — et refusées aussi dans l'autre sens, ce qui a fait tomber deux questions écrites pour des noms que le code ne produit jamais : parfaitement traduites, parfaitement inatteignables, et qui se lisaient comme de la couverture. Enfin, **celui qui produit le texte déclare** s'il est montrable, plutôt que de laisser deviner en aval.

**Une adresse que vous aviez donnée ne se réinvente pas.** Vous fournissez un destinataire en clarification ; deux tours plus tard, l'assistant écrit à `jerome@example.com`. La valeur est désormais **reprise du plan précédent** au lieu d'être inventée. Cette réparation ne peut pas écraser un changement d'avis, et c'est ce qui la rend sûre : elle ne se déclenche pas parce qu'un paramètre a changé, mais parce qu'il porte une adresse de documentation — que personne ne demande jamais. Une vraie valeur, même nouvelle, n'est jamais touchée. **La simulation a tué deux défauts avant la moindre ligne livrée** : la règle ignorait les listes, donc pas les participants d'un événement — le cas le plus courant ; et elle n'épargnait pas les champs libres, donc elle **écrasait le corps d'un message déjà rédigé**. Trois hypothèses de diagnostic ont par ailleurs été **infirmées par la mesure** plutôt que confirmées par le raisonnement, dont une qui semblait évidente et n'aurait rien corrigé.

**Un verdict de validation ne survivait pas à une reprise de conversation.** Les modèles de validation sémantique ont changé de module le 17 juillet ; la liste d'autorisation du checkpoint désignait toujours l'ancien. Le sérialiseur compare le module **réel**, jamais un ré-export : à chaque reprise, le verdict revenait en dictionnaire nu au lieu de son type. En aval, le planificateur teste la présence d'un attribut — faux sur un dictionnaire — et **sautait silencieusement** la directive `FOR_EACH` sur un défaut de cardinalité. Autrement dit : l'utilisateur répondait à une question de clarification et perdait, sans le voir, la consigne que sa réponse devait déclencher. La forme dictionnaire n'est pas un accident de sérialisation — elle est **légitime**, le nœud de clarification la produit exprès ; les deux formes sont désormais lues par un accesseur unique. Une garde vérifie que chaque entrée de la liste désigne le module de **définition**, et qu'un verdict complet survit à un aller-retour réel.

**Un registre qui se remplit tout seul doit pouvoir être corrigé à la main.** Les engagements que LIA relève dans vos conversations — « je dois rappeler le plombier », « Marie me doit le devis » — étaient en lecture seule. Une phrase mal entendue restait mal écrite, et « d'ici vendredi » lu comme le mauvais vendredi restait le mauvais vendredi : la seule issue était de classer l'engagement sans suite, c'est-à-dire de **perdre** l'information plutôt que de la corriger. Le libellé et l'échéance sont désormais modifiables, depuis les réglages comme depuis la fiche d'une relation. **Le sens et l'interlocuteur, non** : les changer ne corrigerait pas cet engagement, cela en décrirait un autre — et ce qui fait la valeur du registre est qu'il reflète ce qui a été dit. La correction porte la même réclamation atomique que la clôture, propriété et statut dans la clause `WHERE`, si bien qu'un engagement déjà clos, expiré, ou appartenant à quelqu'un d'autre n'est jamais touché ; une modification vide est un non-événement plutôt qu'une écriture qui ne changerait que l'horodatage.

**Les actions d'un engagement vivent là où on y pense.** Marquer fait, relancer, classer sans suite : ces trois gestes n'existaient que dans un écran de réglages qui liste tout. Or le moment où l'on se dit « ah oui, je devais le rappeler » est celui où l'on regarde la fiche de la personne. Les trois actions, plus la correction, y sont désormais — et une relance ouvre le chat avec le message déjà rédigé, sans l'envoyer.

**« Boucles ouvertes » s'appelle « Engagements »**, et remonte des préférences vers Réglages → Fonctionnalités, à côté des centres d'intérêt. L'ancien nom décrivait le mécanisme — une boucle qu'on ouvre et qu'on ferme ; le nouveau nomme ce que l'utilisateur y trouve. Six langues, et les trois surfaces qui portaient l'ancien mot : les réglages, la FAQ, et le lexique de la recherche des réglages — où les deux termes **coexistent volontairement**, parce qu'un renommage qui efface l'ancien mot rend la section introuvable pour qui l'a connue sous son premier nom.

**Une fiche de relation répond d'abord à « de qui s'agit-il ».** Elle empilait ses blocs dans l'ordre où le code les avait écrits. Deux d'entre eux ont pourtant une place, et une seule : le carnet d'adresses **ouvre** — tout ce qui suit suppose déjà connue la personne dont il parle — et la connexion LIA **ferme**, parce que c'est une note _sur_ la relation et non l'un de ses contenus. L'ordre est verrouillé par un test qui lit l'ordre du **DOM** et non celui de la grille : c'est aussi celui qu'un lecteur d'écran annonce. Le carnet lui-même ne répond pas à une question mais à trois — comment joindre, quelles dates comptent, à qui la personne est liée — et se lit maintenant en trois groupes distincts plutôt qu'en une pile plate de lignes ; un groupe sans contenu ne dessine pas de cadre vide.

**Le garde-fou bâti pour ce cas n'avait jamais rien gardé.** Un sous-système entier — registre de schémas d'outils, extracteur, validateur de références, guide injecté au planificateur, ~1 900 lignes câblées du démarrage jusqu'au validateur de plan — existait précisément pour refuser `contacts[0].name` avant l'exécution. Il n'a **jamais rien rejeté, depuis le premier commit**, et pour deux raisons indépendantes : le registre est indexé sur les noms de **fonctions Python** quand un plan porte les noms de **manifeste** (aucun des deux ensembles ne rencontre l'autre : 3 clés contre 85 outils), et l'autre branche appelle une méthode qui n'a jamais existé, dont l'erreur est avalée par un `except` trop large. Mesuré : **0 rejet sur 254 références**, absurdités comprises ; en production sur 30 jours, **28 tentatives, 0 succès**. Le réparer coûtait plus cher que le supprimer, mesures à l'appui — la branche manifeste réparée rejette **63 chemins parfaitement légitimes sur 112** (`events[0].summary`, `emails[0].snippet`), la branche schéma **13 sur 35**, dont `contacts[0].name` lui-même, celui que le correctif de la veille venait de rendre vrai. Un validateur qui refuse le titre d'un événement coûte plus cher que pas de validateur du tout. Il est supprimé ; la vérité d'un chemin se vérifie désormais **avant la fusion**, en intégration continue, contre la sortie réelle de l'outil (ADR-194). La garde passe de 6 à **27 outils** — sur les 59 qui publient des chemins — et a immédiatement trouvé la suite du défaut : **sept manifestes mentaient**, toujours de la même façon, un outil adossé au registre annonçant à la racine ce qui vit sous sa clé de contexte. Les trois outils météo publiaient **7 chemins faux sur 7** plus 10 champs de sortie inexistants ; les deux outils Perplexity annonçaient `answer` et `citations` à la racine, plus un `confidence` et un `related_queries` que rien ne produit ; `list_task_lists_tool` promettait `task_lists[…]` là où l'exécution range sous `tasks`. Un huitième cas, `list_labels_tool`, annonçait un champ que seul un appel **filtré** renvoie : un chemin conditionnel ne peut pas être un contrat.

**Une seconde vague a doublé la couverture** — 36 des 59 outils qui publient des chemins, contre 6 au départ. Les outils qui fabriquent leur réponse à l'intérieur même de leur corps, sans couture où injecter un résultat, sont désormais vérifiés en **pilotant leur vraie exécution avec un fournisseur simulé** : aucune ligne de production déplacée, et le test couvre tout le chemin de l'outil plutôt que sa seule moitié mise en forme. Cinq menteurs de plus y sont tombés : les trois lectures Wikipédia annonçaient à la racine ce qui vit sous leur clé de contexte, les deux outils de rappel promettaient un `success` et un `message` que l'exécution ne produit pas, et l'itinéraire annonçait un décompte d'alternatives qu'il calcule sans jamais le remonter. Au passage, un test qui ouvrait une **vraie connexion base de données** — 21 secondes par exécution — a été ramené à moins d'une seconde.

**Et un chemin peut résoudre tout en mentant — sur son type.** La météo annonçait sa localisation comme une chaîne alors qu'elle rend un enregistrement complet, sa température horaire comme une chaîne alors que c'est un nombre, et les horaires d'ouverture d'un lieu comme un objet alors que l'API rend une liste de journées. Le planificateur lit ce type pour décider dans quoi il peut chaîner une valeur : annoncer un enregistrement là où vit une liste l'envoie échouer un cran plus tard qu'un mauvais chemin, mais tout aussi sûrement. Une troisième garde compare désormais chaque type publié au type réellement produit. Ce qui reste non couvert — 15 mutations à brouillon dont la sortie d'étape est le brouillon et non le résultat, 17 outils sans point d'entrée de formatage isolable — est **chiffré et daté** dans un dossier de dette, pas passé sous silence.

**Un plan incomplet est refusé tout de suite, plus accepté puis perdu en silence.** Une étape d'exécution doit nommer son agent et son outil. La règle existait mais ne s'appliquait pas : quand le champ était simplement absent, rien ne le vérifiait — ni à la création de l'étape, ni à celle du plan. L'étape passait donc, s'exécutait, et ne réapparaissait qu'à la reprise d'une conversation sauvegardée, où la relecture, elle, appliquait bien la règle : l'objet revenait alors sous une forme dégradée, **sans la moindre erreur signalée**, et cassait l'exécution loin de sa cause. La règle est désormais posée là où elle s'applique vraiment, pour tous les types d'étapes, avec un garde-fou qui refuse de démarrer si un nouveau type est ajouté sans qu'on ait tranché ce dont il a besoin. Mesuré avant d'y toucher : aucune des 163 étapes des 99 plans en base n'était concernée, donc aucune conversation existante n'est affectée.

**Le guide de création de skills décrivait des types d'étape qui n'existent pas.** Il annonçait `PARALLEL` et `RESPONSE` — que le moteur refuse — et passait sous silence `REPLAN` et `HUMAN`, qu'il accepte. Un skill écrit en suivant la documentation était donc rejeté à l'exécution, et la documentation en était la cause. Corrigé dans les six langues, avec la mention désormais explicite des champs obligatoires. Une vérification automatique compare maintenant le guide au moteur : si l'un des deux évolue sans l'autre, la construction s'arrête — la même discipline que celle appliquée aux couleurs et aux styles annoncés par l'assistant.

**Deux protections qui n'en étaient pas, retirées.** La première prétendait reconstruire un plan repris depuis la sauvegarde : elle ne pouvait ni se déclencher — l'objet revient déjà complet — ni réparer quoi que ce soit dans le cas contraire ; et sa moitié jumelle reconstruisait les verdicts en **effaçant leurs erreurs**, ce qui aurait vidé les blocages que l'assistant vous rapporte. La seconde était un module entier de 342 lignes qui n'a **jamais été appelé** depuis la création du dépôt, accompagné de 462 lignes de tests au vert qui lui donnaient l'apparence d'un composant vivant. Ce qui garantit réellement la propriété est une vérification d'intégration continue, pas du code qui rassure à la lecture.

**Les chiffres de cette livraison.** Treize manifestes corrigés, cinq modules supprimés, huit gardes ajoutées — et une méthode : chaque défaut a été **mesuré avant d'être réparé**, plusieurs hypothèses évidentes ayant été infirmées par la mesure plutôt que confirmées par le raisonnement. **17 803** tests backend collectés sur 955 fichiers, **4 487** frontend, **149** parcours navigateur.

### Added

- **Correction d'un engagement** — `PATCH /open-loops/{loop_id}` : libellé (1 à 500 caractères, jamais vide) et échéance. Un `clear_due_hint` explicite distingue « laisse l'échéance tranquille » de « il n'y a finalement pas d'échéance » — ce qu'un champ nullable ne sait pas exprimer avec `None` seul.
- **Les quatre gestes d'un engagement sur la fiche d'une relation** — fait, relancer, plus d'actualité, corriger. Le composant d'édition est partagé entre les réglages et la fiche : une correction ne peut pas se comporter différemment selon l'écran d'où on la fait.
- **Trois gardes de vérité des manifestes** (ADR-194) — un chemin publié doit être produit par l'exécution réelle de l'outil, une clé adressée par un `reference_example` doit être déclarée, et le **type** publié doit être celui que l'outil rend. Couverture portée de 6 à 36 des 59 outils qui publient des chemins.
- **Garde de la liste d'autorisation du checkpoint** — chaque entrée doit désigner le module où le type est **défini**, jamais un ré-export ; et un verdict complet doit survivre à un aller-retour de sérialisation réel.
- **Garde de synchronisation du guide de création de skills** — les types d'étape que le guide annonce sont comparés à ceux que le moteur accepte, dans les six langues.
- **Garde de complétude des questions de clarification** (ADR-195) — quinze questions, six langues, vérifiées dans les **deux** sens au démarrage : une question sans code qui la produise est aussi une erreur qu'un code sans question.
- **Dossier de dette chiffré** — `docs/plans/2026-08-02-dette-post-adr194.md` recense ce que les gardes ne couvrent pas encore, avec le coût et la raison de chaque report.

### Changed

- **« Boucles ouvertes » devient « Engagements »** dans les six langues, et la section passe de Réglages → Préférences à Réglages → Fonctionnalités, après « Centres d'intérêt ». Le lexique de la recherche des réglages garde les deux termes.
- **L'ordre de la fiche relation est un contrat** — la fiche contact ouvre la colonne de gauche, la connexion LIA la ferme, quel que soit le contenu du compte.
- **Le carnet d'adresses se lit en trois groupes** — joindre, dates, liens — au lieu d'une pile de lignes ; le métier passe en tête du bloc d'identité, le surnom derrière.
- **Douze manifestes cessent de mentir** — les trois outils météo, les deux Perplexity, les trois lectures Wikipédia, les deux outils de rappel, `list_task_lists_tool` et l'itinéraire : chemins publiés à la racine alors qu'ils vivent sous la clé de contexte, champs de sortie inexistants, décompte jamais remonté. `list_labels_tool` en retire un treizième, produit seulement sur appel filtré — un chemin conditionnel ne peut pas être un contrat.
- **Trois types publiés sont corrigés** — la localisation météo est un enregistrement et non une chaîne, la température horaire un nombre, les horaires d'ouverture d'un lieu une liste de journées.
- **La règle `FOR_EACH` ne suggère plus une collection que le plan ne produit pas** — quand aucune collection itérable n'existe, la demande est comptée et abandonnée plutôt que transformée en une consigne impossible ; quand il en existe une, c'est celle-là qui est suggérée.
- **Les contenus utilisateur quittent le niveau INFO** du validateur sémantique : les compteurs restent, les textes descendent en DEBUG.

### Fixed

- **L'assistant ne répond plus par son diagnostic interne** (ADR-195) — `for_each pattern issue detected` et `Fabricated placeholder contact detail: step_2.to='jerome@example.com'` étaient envoyés tels quels à un compte francophone. Quatre fois en trente jours.
- **Un paramètre fourni en clarification n'est plus réinventé** (ADR-195) — une adresse de documentation dans un plan corrigé est remplacée par la valeur que l'utilisateur avait donnée, listes comprises ; les champs libres déjà rédigés ne sont jamais touchés.
- **Un verdict de validation survit à la reprise d'une conversation** — la liste d'autorisation du checkpoint désignait un module abandonné le 17 juillet, si bien que le verdict revenait en dictionnaire nu et que la directive `FOR_EACH` était silencieusement sautée.
- **Une étape de plan sans agent ni outil est refusée à la création** — la règle existait mais ne s'appliquait qu'à la relecture d'un checkpoint, où elle dégradait l'objet sans signaler d'erreur. Mesuré avant correction : aucune des 163 étapes des 99 plans en base n'était concernée.
- **Le guide de création de skills décrivait `PARALLEL` et `RESPONSE`**, que le moteur refuse, et taisait `REPLAN` et `HUMAN`, qu'il accepte.
- **Le validateur de références approuvait tout** — supprimé, voir ADR-194.

### Removed

- `orchestration/reference_validator.py`, `tools/schema_registry.py`, `tools/schema_extractor.py`, `tools/schema_registration.py` et le guide de schémas injecté au planificateur (~1 900 lignes) — mesurés inertes depuis le premier commit, remplacés par des gardes d'intégration continue.
- `nodes/response_builders.py` (342 lignes) — jamais appelé depuis la création du dépôt, accompagné de 462 lignes de tests au vert.
- Les deux branches de reconstruction d'un plan et d'un verdict repris du checkpoint — l'une ne pouvait pas se déclencher, l'autre effaçait les erreurs qu'elle prétendait restaurer.

### Tests

- **17 803** tests backend collectés sur 955 fichiers, **4 487** frontend, **149** parcours navigateur hermétiques.
- Nouvelles suites : vérité et types des manifestes, producteur de chaque type de contexte, sources itérables d'un `FOR_EACH`, restauration de paramètres, synchronisation du guide skills, liste d'autorisation du checkpoint, questions de clarification dans les six langues, ordre de la fiche relation.

## [1.27.6] - 2026-08-02

**Une question sur une personne partait avec le nom d'une autre.** En production, un point 360° sur quelqu'un, puis la fiche d'une deuxième personne ouverte et lancée, envoyait la phrase de la **première** : quatre lignes identiques dans `conversation_messages` et trois HITS du cache de pivot sémantique, qui ne se produisent que si exactement la même chaîne arrive. La cause n'est pas dans le code applicatif : l'App Router **restaure les paramètres de recherche de l'entrée qu'il détient déjà** pour une route, si bien qu'un `router.push('/dashboard/chat?draft=…Paul…')` revenait en `?intent=…Marie…` — une URL que l'application est incapable de construire. Trois causes candidates ont été écartées par l'expérience, pas par le raisonnement : le pré-rendu statique (route forcée dynamique, défaut inchangé), notre propre nettoyage d'URL (une première visite sans requête, donc sans nettoyage, empoisonne quand même la suivante) et la réécriture i18n de la locale par défaut (identique en `en`, où aucune réécriture ne s'applique). Un lien profond de chat est désormais une **vraie navigation** : le navigateur redevient la seule autorité sur l'URL, et la page de chat démarre depuis la barre d'adresse (ADR-192). Le cas dangereux est le préremplissage : un lien `?draft=` qui revient en `?intent=` périmé n'affiche pas seulement le mauvais texte, il **exécute** une demande que l'utilisateur n'a jamais faite sur ce clic.

**Un domaine qui ne sait qu'écrire poussera à écrire.** « De quand date mon dernier appel à ma femme ? » était planifié en deux étapes : chercher le contact, puis **lui téléphoner pour le lui demander**. Seul l'échec d'une référence a arrêté le plan. Ce n'était pas un caprice du modèle mais la seule façon d'obéir : le prompt annonce `Primary domain: telephony`, et le catalogue de ce domaine ne contenait **qu'une capacité — écrire**. Trois capacités de lecture sont ajoutées, chacune dans le domaine qui en manquait : `get_calls_tool` (telephony), `get_open_loops_tool` (task), `get_peer_messages_tool` (peer). Elles ne sont **pas** rattachées à `contact_agent` par `serves_domains` : mesure à l'appui, rendre trois outils joignables depuis `contact` évinçait six outils de **mutation** des catalogues encombrés. Une capacité de lecture ne doit pas coûter une capacité d'écriture (ADR-193).

**Une lecture ne doit jamais produire un plan qui écrit.** Règle déterministe, avant tout appel de modèle : intention non mutative détectée + plan appelant un outil de mutation → plan invalide, retour au planificateur. Elle s'exécute avec les trois autres règles pré-LLM, donc **hors de portée** de l'exemption `well_formed_cross_domain_mutation` — laquelle dispensait de vérification tout plan à deux étapes bien chaîné se terminant par une mutation, c'est-à-dire exactement la forme fautive. Plus le plan était bien formé, moins il était vérifié.

**Un chemin publié est un chemin qui existe.** `get_contacts_tool` publiait `contacts[0].name` ; aucun de ses trois modes ne produisait ce champ. Le validateur de références **approuvait** pourtant ce chemin — il valide contre les `reference_examples` avant toute autre chose, si bien que le manifeste était la seule autorité, et qu'il mentait. Le champ `name` est promu dans le payload, ce qui répare du même geste la référence publiée, la résolution conversationnelle (« Marie » ne correspondait jamais) et l'étiquette des confirmations. `total` est remplacé par `count` — mesuré faux dans 13 déclarations sur 14 — ou retiré des manifestes qui ne le produisent pas.

**Le domaine d'un outil est déclaré, pas deviné.** `place_phone_call_tool` était rattaché au domaine `places` parce que son nom commence par `place_`. La règle censée détecter un plan qui abandonne son domaine primaire se déclenchait donc à tort sur **toute** demande d'appel, et restait muette sur le plan à deux étapes qui l'abandonnait vraiment.

**L'identité est pliée par le système, corrigée par l'utilisateur.** Le pliage de nom répond à « est-ce littéralement la même orthographe ». Il ne peut pas savoir que `0612345678` et `Alice Vernier` sont une seule relation, ni que « Papa » est « Jean Dupont ». Seul l'utilisateur le sait : la fusion est **manuelle et jamais proposée**, réversible, et affichée sur la fiche avec son annulation — une fusion que personne ne voit est une fusion que personne ne peut corriger. Elle ne touche **jamais** l'annuaire des pairs : une décision d'affichage prise par un utilisateur ne doit pas pouvoir rediriger un message vers un autre compte.

**Nommer un pair, c'est déjà savoir des choses sur lui.** Nommer une personne connectée ne corrigeait que le routage ; aucune donnée n'était injectée, si bien que l'assistant annonçait une recherche pour des faits déjà en base. Les trois blocs **locaux** (engagements, appels, messages relayés) sont désormais injectés — pas les souvenirs, déjà injectés par pertinence sémantique, ni les blocs adossés à un connecteur : un tour qui se contente de **nommer** quelqu'un ne doit pas déclencher d'appel externe.

**Et treize défauts de plus, trouvés en relisant le code plutôt qu'en exécutant les tests** — dont deux gardes qui ne gardaient rien : celle des liens profonds répondait OK sur l'appel multiligne (la forme que produit le formateur, donc celle de tous les sites existants), et celle des manifestes ne couvrait que 6 déclarations sur les 56 qui publient des chemins. Les 50 autres n'étaient vérifiées par personne — et six d'entre eux mentaient. **17 622** tests backend collectés, **4 474** frontend, **149** parcours navigateur.

### Added

- **Trois capacités de lecture du CRM** (ADR-193) — `get_calls_tool` (appels passés avec une personne : objectif, issue, résumé, date), `get_open_loops_tool` (engagements ouverts : qui doit quoi, depuis combien de temps), `get_peer_messages_tool` (messages relayés avec une personne connectée). Chacune projette le **même** `RelationsService.build_detail` que la fiche relation : une seule résolution d'identité, donc l'outil et la fiche ne peuvent pas diverger. Chacune publie sa borne (`limit`) et rend le **total exact** à côté de sa page.
- **Fusion manuelle de deux relations** (ADR-193) — nouveau panneau en bas de fiche : choisir une relation, la fusionner dans celle ouverte, et voir la liste de ce qui a été fusionné avec une annulation par ligne. Table d'alias **plate** (un alias ne pointe jamais vers un autre alias), si bien qu'une lecture est un seul lookup, sans chaîne à parcourir ni cycle à détecter — la compression de chemin est payée à l'écriture. **Aucun cycle ne peut être écrit** : la cible est résolue vers son canonique avant comparaison, donc fusionner en sens inverse est un no-op.
- **Enrichissement d'un pair nommé dans le tour** (ADR-193) — clé d'activation `PEER_CONTEXT_INJECTION_ENABLED` (désactivée par défaut). Le nom peut n'être nulle part dans ce que l'utilisateur a tapé (« ma femme ») : le pivot anglais et les références résolues le portent. La portée 360° de l'utilisateur décide quels blocs sont lisibles — une case décochée sur la fiche n'est pas injectée ici non plus.
- **Extrait de mail sur la fiche relation** — deux lignes au plus sous l'objet, plafonnées par `RELATIONS_PROVIDER_EMAIL_EXCERPT_MAX_CHARS` (220 par défaut) : « Re: Re: point » ne dit pas de quoi un échange parlait.
- **Plafonds de catalogue paramétrables** — `PLANNER_CATALOGUE_MAX_TOOLS` (10) et `PLANNER_CATALOGUE_PANIC_MAX_TOOLS` (15), avec une garde au démarrage : le plafond de secours n'est **jamais** inférieur au plafond nominal, sans quoi le filet offrirait moins que le chemin qui vient d'échouer.
- **Garde de cohérence des manifestes** — un `reference_example` qui adresse une clé que le manifeste ne déclare pas fait échouer la CI, sur **tout** le catalogue et non plus sur six outils.
- **Garde des liens profonds de chat** — un lien de chat ouvert par le routeur client fait échouer la CI, dans ses trois formes : appel multiligne, href passé par une variable, `push` comme `replace`.

### Changed

- **Le catalogue d'un domaine de lecture ne contient plus que des écritures** — voir les trois capacités ci-dessus.
- **Les adresses de la fiche sont pliées et dédupliquées avant d'être plafonnées** — deux places sur trois partaient en `Jean@x.com` + `jean@x.com`, soit six recherches de courrier pour une seule boîte, en évinçant une troisième adresse qui portait peut-être la vraie correspondance. L'adresse d'un pair qui a activé le partage est en outre **garantie de place** : elle est la seule identité que l'utilisateur a confirmée.
- **Un appel passé à un numéro brut ne crée plus une seconde relation** — le numéro est réglé, seule son étiquette est cherchée dans le carnet ; appeler « 0612345678 » et appeler « Alice Vernier » construisait deux relations pour une personne.
- **`relation_aliases` est classée dans la carte RGPD** — purgée à la suppression du compte et incluse dans l'export, comme les favoris.
- **Le cache de prompts passe de 32 à 256 entrées** — `prompts/v1/` en contient 89 et un seul tour en touche une dizaine : sous le jeu de travail, le LRU évinçait et le miss suivant était une lecture disque **synchrone** dans une coroutine, sur la boucle qui porte le flux SSE.

### Fixed

- **Un lien profond de chat revenait avec l'URL du précédent** (ADR-192) — voir l'entrée en tête.
- **Un `?draft=` pouvait revenir en `?intent=` et exécuter une demande jamais faite** (ADR-192).
- **`clearIntent` ne s'appliquait pas quand il était la seule navigation de la page** — le nettoyage passe par l'API History, que Next synchronise avec `useSearchParams` ; un rechargement ne réexécute plus la demande.
- **Six chemins publiés par trois outils Hue n'existaient pas dans le résultat** — `name`, `is_on`, `brightness` et `children` étaient annoncés à la racine alors que l'exécution les place dans `hues[]`, `rooms[]` et `scenes[]` (et nomme le dernier `children_count`). Un planificateur les suivant produisait `$steps.step_1.name` et mourait exactement comme le cas des contacts.
- **La résolution conversationnelle des contacts était structurellement morte** — les cinq `reference_fields` valaient `None`, si bien que « Marie » marquait 0,0 sur chaque élément et que la désambiguïsation proposait « Élément 1 » au lieu d'un nom.
- **Les extraits de mail Outlook étaient vides sur toute recherche** — les points d'entrée de liste sélectionnent `bodyPreview` et non `body` ; l'aperçu était présent dans la même charge utile, inutilisé. Seul le résumé est rempli : remplir le corps avec un aperçu tronqué ferait passer un extrait pour un message complet.
- **`_inject_peer_context` promettait sa propre frontière d'échec et convertissait l'UUID en dehors** — un identifiant malformé remontait par `asyncio.gather` et coûtait à l'utilisateur **toute sa réponse**, pour un enrichissement.
- **Six contrôles étaient sous le plancher tactile de 44 px** sur un écran de 390 px — dont la croix « réduire le compagnon » (16 px, invisible sans survol donc **inatteignable au doigt**, et pourtant cliquable) et son point de restauration (12 px, sous le plancher AA de 24 px). Les trois actions rapides de la fiche relation faisaient 30 px de haut.
- **`openChatDeepLink` n'était protégé que par une convention** — il vérifie désormais que l'href est un chemin interne, `//host` et `/\host` compris, que `startsWith('/')` laisse passer.

### Tests

- **17 622** tests backend collectés sur 947 fichiers (+207), **4 474** tests frontend (+27), **149** parcours navigateur hermétiques.
- Plancher de couverture backend relevé de **63 % à 64 %** (mesuré 66,10 %), palier annoncé au relèvement précédent.
- Nouveau verrou de couverture par dossier sur `src/components/relations/**` (91/91/92/92 pour 93,3 mesuré) : cette surface porte une décision qu'un rechargement ne défait pas.
- Le test des cibles tactiles devient **vert pour la première fois** : il échouait sur sa première assertion, si bien que les deux suivantes — dont la fiche 360°, son propre périmètre — n'étaient jamais évaluées. Il couvre désormais aussi l'état réduit du compagnon, qu'aucun parcours n'atteignait.

## [1.27.5] - 2026-08-01

**Un outil que le catalogue annonce et que l'exécuteur ne trouve pas.** En production, « fais-moi un point 360° sur Jérôme » répondait _« je n'ai pas réussi à remonter ses interactions récentes »_. Les journaux disent exactement ce qui s'est passé : `"tool": "get_person_overview_tool"` puis `"error": "Tool 'get_person_overview_tool' not found"`. Le planificateur avait raison — le catalogue annonçait l'outil. C'est le chargeur de modules qui n'importait jamais `person_tools`, ni `documents_tools`, ni `automation_tools` : **trois familles annoncées, zéro enregistrée**. Un manifeste sans outil est une promesse que l'exécuteur ne peut pas tenir, et c'est l'utilisateur qui reçoit l'échec. Une garde de CI compare désormais ce que le catalogue annonce à ce que le registre tient réellement, **après import**, comme au démarrage (ADR-190).

**Et même trouvé, l'outil aurait mal répondu.** Il cherchait le courrier par le **nom** de la personne et l'agenda par une requête texte : une recherche de courrier est appariée contre les en-têtes MIME, et `list_events(query=)` n'a aucune parité entre fournisseurs ni la moindre notion de « cette personne est participante ». Il délègue désormais aux services que la page Relations utilise, qui résolvent les **adresses** depuis votre propre carnet — même identité, même cache, si bien qu'un 360° demandé juste après l'ouverture d'une fiche ne coûte aucun appel fournisseur. La recherche par nom survit en **repli de dernier recours**, uniquement quand le carnet ne porte aucune adresse, et ses résultats sont marqués comme tels.

**La portée du point 360° se choisit, et ce choix est appliqué.** La demande quitte la page sous forme de lien de chat — du texte, et rien d'autre. Laisser le planificateur deviner la portée dans une phrase en aurait fait une suggestion : elle est enregistrée avant l'ouverture du chat, et l'outil la relit. Quelles sections, émission ou réception, participant ou organisateur, combien d'éléments — coché sur la fiche, honoré par l'assistant.

**Le meilleur outil du catalogue était éliminé sans que son score soit lu.** Un point 360° sur une personne connectée revenait amputé : ni engagements, ni appels, ni messages relayés. La cause n'était pas un caprice du modèle. L'outil 360° vit dans le domaine « contact », le filtrage écarte tout outil hors domaine **avant** de consulter la moindre pertinence, et la consigne donnée à l'analyseur envoie explicitement toute question sur un utilisateur connecté vers le domaine « pair » — en disant que le carnet d'adresses ne peut pas y répondre. Reproduit à l'identique : l'outil marquait **0,853**, le meilleur score de tout le catalogue face à des outils génériques à 0,000, et il n'atteignait jamais le planificateur. Quand ça marchait, c'est que le modèle était sorti de la consigne. Un outil peut désormais **déclarer les domaines depuis lesquels il est joignable**, et une seule implémentation répond à cette question pour tout le filtrage (ADR-191).

**Un clic n'est pas une phrase.** Vous appuyez sur un bouton, sur une fiche nommée, avec des cases cochées : le système détient cette certitude avant qu'aucun modèle ne soit consulté — puis il la transformait en prose française et dépensait trois étapes d'intelligence artificielle à tenter de la reconstituer. La demande porte désormais la **capacité invoquée**, en données, à côté de la phrase que vous lisez. Le navigateur nomme une capacité, jamais un outil ; le serveur décide lequel l'implémente, et seulement en lecture. Les autres appels d'outils du plan sont **conservés** : la garantie ajoute, elle ne remplace pas.

**La fiche contact cesse d'être un extrait.** Quatre champs sur douze est une fiche que le lecteur cesse de croire : elle porte désormais les treize blocs du carnet d'adresses. **17 415** tests backend, **4 447** frontend.

### Added

- **Point 360° paramétrable** (ADR-190) — nouvelle section en tête de fiche relation : cases par source (fiche contact, engagements, souvenirs, appels, messages relayés, emails, rendez-vous), distinction émission / réception pour les échanges, participant / organisateur pour les rendez-vous, et nombre maximal d'éléments par section (5 par défaut, plafond 25). Repliée par défaut, préremplie par votre choix précédent. Chaque champ est un ensemble d'**inclusions** : une liste vide veut dire « pas dans mon 360° », jamais « tout » — une portée qui grandirait quand on la vide dépenserait le quota qu'on venait d'économiser.
- **Fiche contact complète** — pseudonyme, fonction, anniversaire, note libre, adresses postales, relations familiales et professionnelles, liens, dates importantes et messageries s'ajoutent au nom, à l'organisation, aux emails et aux téléphones. Un bloc que le fournisseur ne stocke pas ne s'affiche **pas** : relations, liens, dates et messageries n'existent que chez Google, et un texte de remplacement se lirait comme « le carnet ne contient rien ». La fonction est lue dans le champ dédié **ou** dans le titre porté par l'organisation, sans quoi elle n'apparaîtrait jamais hors Google.
- **Garde de parité catalogue ↔ registre** — un manifeste annoncé sans outil enregistré fait échouer la CI. La classe entière du défaut de production est fermée, pas seulement son occurrence.
- **Un outil peut déclarer les domaines depuis lesquels il est joignable** (ADR-191) — jusqu'ici un outil n'existait que pour le domaine de son agent, et le filtrage l'écartait avant même de lire sa pertinence. Une valeur inconnue **refuse le démarrage** plutôt que de rendre l'outil silencieusement introuvable. Déclaré avec parcimonie : chaque domaine ajouté élargit l'éventail proposé pour **toutes** les requêtes de ce domaine.
- **Une capacité peut être invoquée directement** (ADR-191) — le bouton « point 360° » transmet, à côté de sa phrase, la capacité et la personne concernée. Le planificateur garantit alors qu'elle figure au plan, sans rien retirer de ce qu'il a lui-même prévu. Si le plan attend une clarification, **rien n'est semé** : une garantie qui écrase une question posée à l'utilisateur serait un défaut, pas une garantie.

### Changed

- **L'outil 360° lit la même chose que l'écran** — mêmes services, même résolution d'identité par adresse, même cache Redis. Demander « que sais-tu de cette personne » et ouvrir sa fiche ne peuvent plus donner deux réponses différentes.
- **Un seul point d'entrée pour lancer un point 360°** — le bouton de l'entête de fiche a été retiré : le lancement vit désormais à côté des cases qui le paramètrent. Un raccourci dans l'entête contournait le choix que la section existe pour offrir, et deux boutons peuvent diverger sur ce qui a été enregistré.
- **L'anniversaire reste une chaîne, pas une date** — un carnet d'adresses porte couramment un jour et un mois sans année ; en faire une date inventerait l'année manquante. La notation `--MM-JJ` de la RFC 6350 est transmise telle quelle et mise en forme selon votre langue à l'affichage.
- **Le rôle dans un rendez-vous n'est filtré que s'il est connu** — Apple n'expose aucun organisateur : y filtrer par rôle supprimerait **tous** les rendez-vous au lieu d'admettre que la distinction est inconnue.

### Fixed

- **Un point 360° sur un contact ne remontait ni ses emails, ni ses rendez-vous** — l'outil était catalogué mais son module n'était jamais importé, et deux autres familles d'outils (documents, automatisations) étaient dans le même cas.
- **Un pair connecté absent de votre carnet d'adresses n'avait ni mails ni rendez-vous** (ADR-191) — les sections de la fiche interrogent le courrier et l'agenda **par adresse**, et l'adresse ne venait que du carnet. Quelqu'un avec qui vous échangez **à travers LIA** se retrouvait donc sans aucune adresse à apparier. Si le pair a **activé le partage de son adresse**, celle-ci sert désormais à retrouver, dans **votre** courrier et **votre** agenda, les échanges et les rendez-vous où il est organisateur ou invité. Elle n'est jamais réaffichée. Cela vaut pour **toute** la fiche, et la page comme l'assistant passent par le même code — ils ne peuvent pas diverger.
- **Un rendez-vous de votre agenda était présenté comme celui du pair** (ADR-191) — quand le 360° annonçait honnêtement n'avoir trouvé aucun rendez-vous partagé, le plan appelait **aussi** l'agenda générique, qui renvoie vos prochains événements sans le moindre filtre sur la personne. L'assistant présentait alors « Goûter à la maison » dans le 360°, alors que le pair ne l'organise ni n'y participe. Une réponse sans rapport, posée à côté d'un manque annoncé, ne le complète pas : elle le contredit. Quand vous invoquez vous-même le point 360°, les outils que celui-ci recouvre déjà (agenda, mails, carnet) sont retirés du plan — sauf si une autre étape en dépend. Tout le reste (sous-agent, recherche web, tâches, rappels) demeure.
- **L'assistant disait « je n'ai aucune donnée sous la main » alors que l'outil venait de tout remonter** (ADR-191) — et c'est la cause de fond des points 360° incomplets. Deux canaux seulement atteignent la synthèse de réponse : le registre de données, alimenté uniquement par les outils qui déclarent une clé de contexte, et le message de l'outil. Le 360° n'a pas de clé de contexte — à dessein, le registre sérialise des **items** destinés au filtrage, une ligne tronquée chacun, ce qui ne convient pas au briefing d'une personne réparti sur neuf blocs. Et son message se réduisait à « aperçu construit pour X » : la preuve que l'outil avait tourné, et pas un seul fait. Les emails et rendez-vous parfois visibles venaient des outils génériques ; engagements, appels et messages relayés n'existent que dans cette charge — donc **jamais** vus. Le message porte désormais la charge complète, et ce qui n'a pas pu être lu est répété **en tête** plutôt qu'enfoui.
- **Un point 360° sur une personne connectée n'appelait pas l'outil 360°** (ADR-191) — il appelait trois outils génériques, structurellement incapables de lire vos engagements, vos appels et vos messages relayés. L'outil vit dans le domaine « contact », le filtrage écarte tout outil hors domaine **avant** de lire son score, et la consigne de l'analyseur envoie toute question sur une personne connectée vers le domaine « pair ». Mesuré : score **0,853**, le meilleur du catalogue, jamais présenté au planificateur. Corrigé sans élargir quoi que ce soit d'autre — un plan « pair » gagne **exactement un** outil, en lecture seule ; ajouter le domaine « contact » entier avait déjà cassé la production le 31 juillet.
- **Le deuxième point 360° d'affilée déclenchait le premier** — la demande était figée à l'ouverture de la page, alors qu'un second lien vers la même page en change l'adresse **sans** la recharger ; et l'adresse était réécrite par un mécanisme que le routeur ne voit pas, si bien qu'il continuait de servir la toute première demande. Lue en direct, effacée par le routeur, et seulement **une fois consommée**.
- **Le message de l'utilisateur disparaissait de l'écran** — l'envoi automatique partait avant que l'historique ait fini de se charger, et la liste venue du serveur — antérieure à l'envoi — écrasait la bulle qui venait d'apparaître. Le message était bien enregistré : il réapparaissait après un rafraîchissement. L'envoi attend désormais que l'historique soit posé, y compris quand ce chargement **échoue** : une demande qui ne part jamais est pire qu'une liste momentanément incomplète.
- **La demande restait dans l'adresse quand elle était le dernier paramètre** — donc un simple rafraîchissement la relançait. Débusqué par le parcours en navigateur écrit pour cette version : `?intent=X&conversation=42` se nettoyait, `?intent=X` seul ne se nettoyait pas — et c'est le cas courant. L'adresse de remplacement était construite depuis la route **interne**, alors que le segment de langue appartient au middleware : la cible se résolvait sur la page déjà affichée et rien n'était appliqué. Elle est désormais construite depuis la barre d'adresse réelle.
- **L'assistant ne recevait aucun total et sous-estimait donc tout** — la page affiche « 137 engagements » et remet une page de cinq ; l'outil ne transmettait que les cinq lignes, si bien que l'assistant répondait « tu as cinq engagements ouverts ». Chaque page transporte désormais son total **exact**, calculé par agrégat sur l'ensemble — sauf quand un filtre de direction a réduit la liste, auquel cas aucun total ne la décrit et aucun n'est transmis.
- **Une section illisible était rapportée comme une section vide** — un connecteur absent produisait à la fois une liste vide et une mention « indisponible » dans la même charge utile ; le modèle croit la liste, car une liste est une donnée et l'autre une mise en garde. Une section qui n'a pas pu être lue ne porte plus **aucune** clé.
- **Une recherche de souvenirs impossible était annoncée comme une absence de souvenirs** — quand aucun vecteur ne peut être calculé (fournisseur d'embeddings indisponible), l'assistant déclarait la personne sans souvenir attaché au lieu de dire qu'il n'avait pas pu regarder.
- **Le cache des sections fournisseur n'était pas versionné** — la fiche ayant changé de forme, une entrée écrite avant la mise à jour se serait relue avec tous les nouveaux blocs vides, affichant une fiche amputée pendant six heures après le déploiement.
- **Les adresses postales étaient coupées au milieu des mots sur mobile** — la césure agressive convenait à une ligne qui ne portait que des adresses e-mail ; elle rendait « 12 rue des Li-las » dès que la fiche a porté des adresses et des noms de personnes. Les liens trop longs continuent d'être coupés, eux, faute de quoi ils débordent l'écran.
- **La galerie de la page d'accueil pouvait planter sur une liste vide** — le calcul d'index divisait par le nombre de vues ; six langues alimentent ces inventaires et une seule lacune de contenu suffisait à emporter une page publique.
- **Le coût annoncé ignorait la copie** — la configuration et les fichiers d'exemple annonçaient deux recherches de courrier par adresse alors que la prise en compte du `cc` en avait fait trois.

### Tests

- **Backend 17 415** (+326) : parité catalogue ↔ registre après import, parseur de fiche complète (chaque bloc avec son libellé, fonction lue hors Google, anniversaire sans année conservé sans année, date d'événement formatée et non stringifiée, entrées malformées sans effet), modèle de portée (sélection vide ≠ tout, bornes publiées dans le schéma, forme illisible dégradée vers le défaut, forme partielle complétée, sélection vide stockée conservée), routes de portée déclarées avant l'attrape-tout, persistance JSONB par nouveau dictionnaire, et la matrice d'honnêteté de l'outil (totaux exacts, liste filtrée sans total, section illisible sans clé, recall indisponible ≠ absence). S'y ajoutent les oracles ADR-191, tous vérifiés **voyants** en retirant leur correctif : joignabilité sur le **registre réel** (retirer la déclaration en fait tomber six), canal de restitution de l'outil (six), préservation des messages à travers la normalisation (trois), câblage du nœud planificateur (deux), lecture des références `$steps` (deux), supersession et ses garde-fous, adresse d'un pair conditionnée à son partage, et rédaction du résumé de réponse dans les journaux.
- **Frontend 4 447** (+178) : rendu des treize blocs, libellés fournisseurs traduits avec repli sur le libellé brut, date partielle localisée sans année inventée, lien ouvert seulement en http(s), sélecteur de portée (toutes les sources offertes et préremplies, sens et rôles séparés, bornes respectées, champ vidé jamais ramené à zéro, refus de lancer sans source), enregistrement **avant** navigation prouvé par l'ordre des appels, absence du bouton d'entête, et la directive de capacité de bout en bout : lue depuis le lien, identité stable entre rendus, bornes du sujet respectées pour ne jamais faire échouer la requête entière, transportée jusqu'au corps HTTP et absente quand elle n'a pas lieu d'être.
- **Navigateur** — le test de reflow à 320 px ouvre désormais la fiche contact, avec une adresse longue et un lien trop large pour l'écran : sans cela il ne pouvait structurellement pas voir la classe de défaut qu'il est censé garder. Un nouveau parcours suit le lien 360° de bout en bout : la capacité atteint bien le corps de la requête, le message de l'utilisateur **survit** au chargement de l'historique, un second point 360° porte bien la seconde personne, et un lien ordinaire n'emporte aucune capacité.
- **Les oracles de joignabilité tournent sur le registre réel**, pas sur un double : retirer la déclaration en fait tomber six. Un test qui passe avant comme après le correctif ne prouve rien.

## [1.27.4] - 2026-07-31

**Une limite qu'on applique doit être dite — et un plan refusé n'est pas un échec.** « Donne mes 3 derniers emails reçus » répondait _« je n'ai pas pu les récupérer, la récupération a été bloquée par une limite… vérifie les paramètres du connecteur email »_. Les dix emails étaient là, lus, complets, sous les yeux du modèle au moment où il écrivait cette phrase — et le connecteur était sain. Douze requêtes consécutives mesurées en production : demander **3** emails produisait la panne trois fois sur quatre, demander 2, 4 ou 5 ne la produisait jamais. Trois couches ne s'accordaient pas, chacune corrigée à sa racine (ADR-184).

**La borne était appliquée mais jamais publiée.** Le catalogue remis au planificateur décrivait `max_results` comme un simple entier facultatif — sans sa limite, ni même la description qui la mentionne. Le manifeste, lui, la plafonnait à 10. Le prompt, de son côté, ordonnait un lot de « 20 à 50 » écrit en dur, avec pour exemple littéral _« les 3 emails les plus importants »_ — d'où la cardinalité 3 qui déclenchait la règle. Le modèle obéissait à la seule instruction qu'il avait, contre une limite qu'il n'avait aucun moyen de connaître, et le validateur le sanctionnait pour avoir obéi. **Une limite appliquée mais cachée n'est pas un contrat, c'est un piège.** Elle est désormais publiée, et la taille de lot vient d'un réglage — plus d'un nombre écrit dans une phrase. Vérifié en conditions réelles sur trois plafonds successifs (10, 20, 5) : le planificateur demande exactement ce que le catalogue annonce.

**Et le verdict du validateur ne vaut plus condamnation.** Un plan refusé s'exécute quand même — le routage n'a jamais lu ce verdict — et réussit le plus souvent, l'outil corrigeant lui-même la valeur hors limite. Depuis la v1.27.3, la couche d'honnêteté en déduisait pourtant « bloqué » et faisait annoncer un échec : le correctif d'ADR-182, retourné contre lui-même. Une capacité n'est déclarée bloquée que si elle n'a **rien produit**. **17 089** tests backend, **4 269** frontend.

### Added

- **Le catalogue publie les limites qu'il fait respecter** (ADR-184) — tout paramètre borné par son manifeste expose désormais sa limite basse et haute au planificateur, dans la forme compacte déjà utilisée pour les formats d'identifiants. Coût mesuré sur le catalogue réel d'un tour de messagerie : **neuf caractères**. En échange, le modèle cesse de dimensionner ses lots à l'aveugle : mesuré en conditions réelles, il demande 20 quand la limite est 20, et 5 quand elle est 5.
- **Écrêtage déterministe des valeurs hors limites** — un prompt correct reste une instruction donnée à un modèle qui n'est pas déterministe. Toute valeur numérique hors bornes est ramenée dans ses bornes au moment où l'étape est construite, exactement comme l'était déjà le plafond des itérations FOR_EACH : on corrige ce qui est mécaniquement corrigible, on le journalise, et on ne perd jamais un tour pour ça. Ne sont **pas** touchés les formats, les valeurs d'énumération, les types incorrects, les références inter-étapes et les gabarits — les réparer inventerait une intention que personne n'a exprimée. Nouveau compteur `planner_parameter_bounds_corrections_total` : un débit soutenu signale une consigne de prompt qui a débordé une limite configurée.

### Changed

- **La taille du lot large vient du paramétrage, plus du prompt** — le « 20 à 50 » écrit dans le texte est remplacé par le réglage `PLANNER_SEMANTIC_BROAD_BATCH`, celui-là même qu'utilisait déjà la correction automatique des critères sémantiques : une source de vérité au lieu de deux nombres libres de diverger. La consigne subordonne explicitement cette cible à la limite publiée par l'outil — quand la limite est plus basse que la cible, **c'est elle le lot large**.
- **Le contrat du validateur est explicite** — son verdict classe, il ne prononce pas d'échec. Ce qui prononce l'échec, c'est l'absence de résultat. Deux règles systémiques nouvelles dans les instructions du dépôt, pour que la classe ne se reforme pas ailleurs.

### Fixed

- **« Donne mes 3 derniers emails » annonçait un échec avec les emails en main** — le nœud de réponse disposait des dix messages (registre peuplé, outil en succès) et affirmait pourtant n'avoir rien pu récupérer, en désignant le connecteur email comme coupable. Un diagnostic inventé, exactement la classe que la v1.27.3 venait d'éliminer, pointant dans l'autre sens.
- **Le validateur pouvait écrire lui-même la violation qu'il rapporte** — la correction automatique d'un critère sémantique portait la taille de lot à sa valeur de réglage **sans consulter la limite du manifeste**. Avec une limite plus basse, elle fabriquait la violation de contrainte qu'elle est censée signaler, puis la réponse l'annonçait comme un échec. Ce mode est actif en production : le défaut était armé, pas théorique.
- **Un tour partiellement bloqué n'est plus annoncé comme un échec total** — quand une capacité échoue pendant qu'une autre produit, la réponse présente ce qu'elle a obtenu et signale ce qui a manqué, au lieu de tout nier.

### Tests

- **Backend 17 089** (+64) : écrêtage aux limites du manifeste (valeurs dans les bornes laissées intactes, booléens exclus — `True` est un entier en Python —, références inter-étapes et gabarits épargnés, bornes incohérentes non devinées, échec du registre sans conséquence, non-mutation de l'entrée), publication des limites au catalogue (y compris la coexistence avec les formats d'identifiants et le rejet d'une limite mal typée), lot large lu depuis le réglage et absence de tout nombre en dur dans le prompt, inventaire de ce qu'un tour a réellement exécuté (étape vide comptée comme exécutée, étape en échec non, plan altéré par un aller-retour de sérialisation sans effet), et la matrice complète verdict × exécution sur la directive d'échec.

## [1.27.3] - 2026-07-31

**La réponse dit ce qu'elle sait — et la lit sur les bonnes données.** Une question aussi simple que « Jérôme est-il dispo demain à 10 h ? » traversait quatre défauts empilés, chacun masquant le suivant : le connecteur du pair était cassé sans que personne ne le sache, le routage tirait au sort entre `peer` et l'agenda du demandeur, les créneaux lus n'atteignaient jamais le modèle qui rédige, et la lecture visait le calendrier `primary` alors que l'agenda vivait dans un calendrier nommé. Chacun est corrigé à sa racine et verrouillé par des tests (ADR-182). Au passage, un plan refusé par le validateur ne laisse plus le modèle **inventer** un diagnostic, un connecteur cassé devient visible en permanence pour son propriétaire, et la résolution du conteneur par défaut — écrite dix fois dans le dépôt — devient un helper unique. Côté confort : verre poli sur le pied du chat, raccourcis modifiables, et quatre réglages d'ergonomie.

**Et une panne qui n'en était pas une une fois sur deux.** « Résume ce mail et propose une réponse » échouait, puis réussissait trente minutes plus tard sans qu'une ligne ne change. La cause : la sélection des outils compare les mots-clés non pas à votre phrase, mais à une **traduction anglaise réécrite à chaque tour par un modèle**. « Summarize » ou « Find » — et l'outil de lecture passait de retenu à exclu. Le planificateur recevait alors « répondre à un mail » sans aucun moyen de lire un mail : aucun plan valide n'existait avant même qu'il ne commence. La correction ne touche pas au hasard, elle l'enjambe (ADR-183). **17 025** tests backend, **4 269** frontend.

### Added

- **Conscience des connexions au routage** (ADR-182) — les connexions acceptées de l'utilisateur sont injectées dans le prompt versionné de l'analyseur (bloc `CONNECTED USERS` + règle de désambiguïsation), pour que le modèle sache que ce nom désigne un **autre utilisateur** de l'instance et non un contact du carnet d'adresses. Doublé d'une garantie déterministe : quand un pair connecté est nommé et que le domaine répondu reste confusable (`event`/`task`/`contact`), `peer` est **ajouté** — jamais substitué, car « suis-je libre pour voir X ? » a légitimement besoin des deux. Accents pliés (mêmes sémantiques que les outils), frontières de mots, jetons de moins de trois caractères ignorés ; corrections comptées (`peer_domain_correction_total`) et journalisées **sans les noms** (PII).
- **Aveu d'échec fidèle quand le validateur refuse un plan** — nouvelle directive versionnée `response_directive_plan_blocked.txt` : la réponse énonce les capacités réellement bloquées et leur cause, avec interdiction explicite de généraliser (« aucun service n'est configuré » est nommément proscrit), de blâmer l'utilisateur, ou de faire passer une capacité manquante du demandeur pour une réponse sur la donnée d'un tiers. Généralisé à **tout** `ToolErrorCode` : un code non mappé dégrade vers une cause plus vague, jamais vers le silence. Un refus explicite de l'utilisateur (plan rejeté, brouillon annulé) garde la priorité.
- **Bandeau persistant de connecteur à reconnecter** — le modal d'alerte interrompt une fois puis se tait pendant des heures ; le bandeau, lui, reste tant que la panne dure, disparaît de lui-même à la reconnexion et n'est pas masquable. `role="status"` poli, nom accessible traduit, responsive, action directe quand un seul service est touché, lien profond vers les réglages au-delà.
- **Raccourcis du chat modifiables** — l'identifiant et le texte d'un `/raccourci` s'éditent en place (le contrôle de doublon exclut le raccourci en cours d'édition, sinon renommer le seul texte se heurterait à lui-même). Champs nommés par le raccourci qu'ils modifient, pour ne pas exposer deux champs homonymes à un lecteur d'écran.
- **Observabilité des notifications de santé OAuth non émises** — `oauth_health_notification_skipped` et son compteur par raison distinguent « silence volontaire » (fenêtre anti-spam, avec le temps restant) de « propriétaire indisponible ». Auparavant `error=5 notified=0` ne s'expliquait par aucune ligne.
- **Clôture du catalogue d'outils** (ADR-183) — une règle structurelle qui ne regarde jamais la demande : _si un outil retenu exige une donnée qu'il ne peut pas inventer, l'outil capable de la fournir doit être là_. Un éditeur de liens qui résout les références manquantes, pas une recherche qui devine. Elle est permissive — elle rend un plan correct **possible**, elle n'impose jamais une étape — et déterministe : une traduction malheureuse peut changer _quel_ outil de lecture est proposé, plus _s'il y en a un_. Croissance mesurée : **+1 outil**, borné à +2. Deux règles la rendent sûre : un outil ne se satisfait jamais lui-même (« répondre » produit aussi un identifiant de message — celui qu'il vient d'envoyer), et seul un outil de **lecture** fait une source (on ne déclenche pas un envoi pour découvrir un identifiant).

### Changed

- **Le domaine `peer` suit enfin son feature flag** — `peers_enabled` gatait déjà le routeur REST, les manifests et les modules d'outils, mais pas le chokepoint de disponibilité : une instance désactivée offrait au routeur un domaine dont tous les outils sont injoignables. Les trois domaines gatés par déploiement (`telephony`, `document`, `peer`) passent par une table unique.
- **Résolution du conteneur par défaut du propriétaire, mutualisée** — le bloc « lire la préférence chiffrée, la résoudre en identifiant, se replier » était écrit **dix fois** (calendar_tools ×4, briefing ×2, heartbeat ×2, tasks_tools, telephony). Un helper unique le porte, avec `owner_id` en paramètre explicite : une lecture croisée s'exécute sous le runtime du demandeur, résoudre l'identité ambiante lirait la préférence de la mauvaise personne — et paraîtrait correct dans tout test mono-utilisateur.
- **Ce que lit le modèle est rendu, pas annoncé** — les lectures croisées rendent les créneaux et les titres **dans** `summary_for_llm` : heures converties dans le fuseau du demandeur, entrées « journée entière » listées à part et décrites (un anniversaire ne bloque rien, un jour de congé si), cas vide explicite, listes tronquées qui **disent** qu'elles le sont.
- **Pied du chat en verre poli** — le composeur devient collant à l'intérieur de la zone de défilement, comme l'en-tête : le flou ne rend que ce qui passe derrière lui.
- **Ergonomie** — la recherche des réglages passe au-dessus de la barre d'onglets, le titre des cartes du tableau de bord s'aligne sur l'axe de son icône, les trois boutons d'import de skills se centrent entre le séparateur et le bord de la carte, et le sous-titre « Comment fonctionne LIA » redevient une phrase.
- **Le vocabulaire sémantique se déduit des outils, il ne se recopie plus** — les liens « qui produit ce type / qui le consomme » étaient tenus à la main dans l'ontologie et dérivaient à chaque outil ajouté : **une soixantaine de types** portaient une liste incomplète, ce qui désactivait silencieusement la protection qui en dépend. Ils sont désormais déduits des manifests au moment de leur usage. Effet mesuré sur le prompt : **+1 ligne**.
- **Un manifest décrivait des sorties qui n'existaient pas** — l'inventaire des lampes Hue annonçait un chemin de données que rien ne produisait : toute référence à ce chemin depuis une étape suivante ne résolvait rien. Le manifest dit maintenant la vérité, sans changement de comportement ni coût supplémentaire.
- **Cliquets resserrés** — quatre plafonds de taille abaissés (`calendar_tools` 1353→1318, `heartbeat` 753→705, `tasks_tools` 1055→1045, `query_analyzer_service` 1020→1018) et la complexité cyclomatique backend verrouillée à **343** (contre 345) : la mutualisation paie sa propre dette.

### Fixed

- **Une question sur la disponibilité d'un pair était un tirage au sort** — la même phrase, à l'octet près, a routé `peer` une fois sur quatre ; les trois autres planifiaient sur l'agenda et le carnet du **demandeur**, puis mouraient sur des scopes absents en répondant « aucun service n'est configuré ».
- **Les données lues n'atteignaient pas le modèle** — le routage réparé, l'outil lisait bien six créneaux… que le nœud de réponse ne recevait jamais : la charge utile vivait dans `structured_data` (références inter-étapes Jinja) alors que seul `message` est lu par le modèle qui rédige. L'assistant répondait donc, en toute exactitude, qu'il n'avait aucun détail.
- **On lisait le mauvais calendrier** — les lectures croisées étaient câblées en dur sur `primary` / `@default`. Mesuré : la préférence du pair valait `Famille`, son `primary` ne contenait que des anniversaires, et son rendez-vous de 10 h était invisible — **libre-alors-qu'occupé**, la forme la plus coûteuse de réponse fausse.
- **« Jamais connecté » et « accès cassé » ne sont plus la même phrase** — un pair dont l'accès OAuth vient de rompre était annoncé comme n'ayant aucun calendrier, ce qui envoyait le diagnostic dans la mauvaise direction. La distinction réutilise le prédicat qui alimente déjà la bannière de reconnexion (ADR-134).
- **Le verre poli du pied de chat était un no-op** — `ChatInput` peignait un fond opaque sur sa propre racine, recouvrant toute translucidité posée au-dessus.
- **Un instant malformé ne peut plus faire dire « libre »** — le test de journée entière mesurait la **longueur** de la date, or `YYYY-MM-DD` fait dix caractères… comme `not-a-date` : une charge utile douteuse basculait en « journée entière », vidait la liste des créneaux horaires et laissait affirmer que toutes les heures étaient libres. La date est désormais parsée.
- **« Résume ce mail et propose une réponse » échouait une fois sur deux** — la même demande, la même intention, deux issues. La sélection des outils note les candidats contre une traduction anglaise **régénérée à chaque tour par un modèle** : selon qu'elle commençait par « Summarize » ou par « Find », l'outil de lecture des mails passait de 0,010 à au-dessus du seuil. Sans lui, le planificateur devait écrire un plan de réponse sans pouvoir lire le message — et nommait un outil qui n'existe pas dans son catalogue. Corrigé à la racine par la clôture, qui ne dépend pas de la traduction.
- **Une table de correction de noms d'outils morte depuis la v1.0.0** — 24 corrections destinées à rattraper les anciens noms n'étaient jamais appliquées : la fonction s'arrêtait avant de les consulter dès que le nom se terminait par `_tool`… ce qui est le cas des 24 clés. Le même mauvais nom était donc réparé ou non selon un suffixe.
- **Un échec définitif n'est plus annoncé comme passager** — le mécanisme de reprise qualifiait de « transitoire, un nouvel essai serait justifié » l'échec d'un outil qui n'existe pas. Rejouer le plan à l'identique ne pouvait rien changer, et c'est cette ligne que l'on lit dans les journaux en cherchant la vraie cause — elle envoyait l'enquête dans le mur.

### Tests

- **Backend 17 025** (+217) : routage peer (unitaire + câblage dans l'analyseur), disponibilité des domaines par flag, blocages de plan sur **tout** le `ToolErrorCode`, rendu des résumés peer (fuseau, journée entière, troncature annoncée, cas vide), état du connecteur d'un pair sur les deux outils, résolution du conteneur par défaut du propriétaire, observabilité des notifications OAuth sautées — et pour la clôture du catalogue : l'incident de production rejoué avec ses scores exacts, les deux pièges qui auraient rendu le mécanisme inopérant (auto-satisfaction, mutation prise pour une source), les catalogues déjà corrects laissés intacts, le départage déterministe sans aucun score, l'invariante « aucune donnée exigée sans outil capable de la fournir » sur les 89 manifests, et l'arbitrage du plafond de taille (y compris l'interdiction d'évincer l'unique outil d'un domaine).
- **Frontend 4 269** (+19) : bandeau de santé des connecteurs (rôle et nom accessibles, clavier, état désactivé, publication de sa hauteur au shell du chat, absence de contrôle de masquage) et édition des raccourcis (renommage, collision avec soi-même, identifiant réservé, annulation).

## [1.27.2] - 2026-07-30

**L'espace public prend son identité — et répond au défilement, du héros à l'horizon.** Toute la vitrine (landing, Encore +, démo, Story, Philosophie, Technique, FAQ, blog, mentions) porte désormais l'identité **LIA Cosmos** (ADR-181) : fond cosmique, planétarium des fonctionnalités en orbite autour de la vraie démo, mots-repères géants qui dérivent derrière les chapitres, et **neuf chorégraphies distinctes pilotées par le scroll** — les preuves surgissent une à une, les cas d'usage se retournent en 3D, la journée s'épingle, l'architecture s'exécute comme une trace. Sombre par défaut (le thème clair reste à un clic, et a reçu sa propre passe de qualité), **tutoiement** sur toutes les surfaces publiques en français, allemand et espagnol, et **zéro dépendance d'animation ajoutée**. Côté application : six ajustements demandés (carte « Pour toi », pouce sur notification proactive, connecteurs en écran étroit, passkeys, appels récents, import de skills) et un défaut de mise en page corrigé **à la racine du composant accordéon partagé**, donc dans toute l'application. Frontend **4 250** tests.

### Added

- **Identité LIA Cosmos sur tout l'espace public** (ADR-181) — re-skin par scope CSS : la classe `.cosmos` redéfinit les jetons du design system, les sections réelles se rhabillent **sans une seule édition de composant de contenu** ; sous-scope `cosmos-calm` (fond atténué, cartes opaques, aucune chorégraphie) pour les sept pages de lecture. Primitives maison dans `components/landing/cosmic/` : `CosmicBackdrop`, `Planetarium` (8 fonctionnalités sur 3 ellipses), `GhostWord`, `PinnedScene`, `ScrollScrub`, `BlurReveal`, `GlowCard`, `TrustStat`, `useCosmosScroll`, `useCountUp` — **aucune dépendance nouvelle**.
- **Neuf chorégraphies pilotées par le scroll, réversibles** — une idée produit par animation : entrée orchestrée du héros, dérive des mots-repères, surgissement un-par-un des preuves, retournement 3D des cas d'usage, élévation de la galerie avec souligné qui se trace, apparition séquentielle du socle technique, « l'architecture s'exécute » (flux puis étapes des deux modes), journée épinglée qui avance avec le défilement, planète finale aux nuages vivants. Les scènes des six chapitres réutilisent **leurs propres délais d'origine** convertis en fenêtres de défilement : l'ordre de chaque scène est préservé, le scroll joue la partition dans les deux sens.
- **Sombre par défaut sur les surfaces publiques** — `CosmosDarkFirst` pose le thème avant le premier rendu quand aucune préférence n'est stockée ; le sélecteur de thème garde toujours le dernier mot et sa préférence est persistée.
- **Tutoiement des surfaces publiques en fr, de et es** — ~1 150 chaînes converties (l'italien l'était déjà, le chinois n'a pas la distinction) ; l'interlocuteur d'un exemple d'appel téléphonique reste vouvoyé — ce n'est pas l'utilisateur.
- **Gardes navigateur durables** — `landing-day-pin.spec.ts` mesure l'épinglage **pendant** un vrai défilement (doctrine ADR-171) ; `settings-connectors-overflow.spec.ts` verrouille « Mes connecteurs » à 320/360/390 px avec une charge réaliste ; le balayage axe couvre désormais la landing entière parcourue, dans les deux thèmes.

### Changed

- **Contraste des contrôles primaires, divergent par thème** — le bleu vif sous texte blanc mesurait 3,2:1 (sous le seuil AA de 4,5:1) : en thème sombre les boutons gardent le bleu vif avec un texte encre (≈5,5:1), en thème clair ils passent au bleu profond `#2c56c4` sous blanc (≈6,5:1), qui sert aussi de couleur de texte sur les pastilles teintées (≥4,9:1).
- **Carte « Pour toi » : seules les exécutions à venir sont affichées** — les exécutions passées restent dans la charge utile de l'API mais quittent la carte, qui répond désormais à « qu'est-ce qui va se passer ? ».
- **« Appels récents » se limite aux dix derniers** — la fenêtre est demandée au serveur (`?limit=10`), jamais tronquée côté client.
- **Boutons d'import de skills détachés** — Guide, Depuis une URL et Importer passent sous une ligne de séparation dédiée.
- **Planchers de couverture frontend relevés** — 66/60/61/67 → **67/60/62/67** (mesuré 69,3/62,8/64,5/69,9), doctrine du cliquet : ils ne redescendent jamais.

### Fixed

- **Débordement horizontal des accordéons sur écran étroit** — la ligne « Connecteurs Google connectés (5) [Connecté] » sortait de l'écran : le composant partagé `AccordionTrigger` était un élément `flex-1` **sans `min-w-0`**, donc incapable de rétrécir sous la largeur intrinsèque de sa rangée (le `truncate` intérieur ne peut rien y faire — le plancher vit sur l'élément flex lui-même). Corrigé dans le primitif : **tous les accordéons de l'application en bénéficient**, avec un garde navigateur à 320/360/390 px.
- **Un pouce sur une notification proactive n'affiche plus d'erreur** — le vote est optimiste et définitif côté interface ; un échec d'enregistrement est journalisé mais ne dérange plus l'utilisateur (une notification ancienne peut légitimement n'avoir plus de ligne côté serveur).
- **« Authentification forte » en vue mobile** — le bouton « Ajouter une passkey » passe **sous** le texte au lieu de le comprimer.
- **Cartes de connecteurs en écran étroit** — libellés et descriptions se replient dans la carte (`min-w-0`, `break-words`), icônes et boutons ne rétrécissent plus.
- **Badge BÊTA illisible en thème sombre** — la pastille rouge opaque du badge donnait 3,48:1 avec son texte : teinte de texte éclaircie (≈5,3:1).

### Removed

- **Routes de prévisualisation `/cosmos/*`** et leurs outils (sélecteur de previews, coquille de lecture) — la bascule remplace, il ne reste pas de code mort ; `HeroSection`, `CtaSection` et un baril d'exports inutilisé disparaissent avec elles.
- **Lune de la planète finale** — l'horizon garde la sphère et ses nuages.

### Tests

- Frontend **4 250** (+79) : primitives cosmiques (défilement, épinglage, dérive, planétarium, compteurs, synchronisation des délais de scène), composition de la landing et contrat de production restauré (redirection authentifiée, mesure produit, données structurées SEO), scope calme des sept pages de lecture, exécutions à venir seules, échec silencieux du vote proactif, fenêtre des appels récents.
- E2e : épinglage mesuré pendant le défilement, débordement des connecteurs à trois largeurs, balayage axe AA de la landing parcourue dans les deux thèmes (8 scans publics verts).

## [1.27.1] - 2026-07-30

**Les relations gagnent leur place — dans la barre de navigation, et dans le cœur.** La page Relations, jusqu'ici sans porte d'entrée, prend le créneau de navigation de « Connaissances » (qui reste à un clic dans le chat : son indicateur s'affiche désormais **toujours**, même sans aucun espace) et reçoit la refonte qu'elle méritait : avatars à initiales à teinte stable, pastilles de signaux colorées, **favoris persistés** (l'étoile résiste à l'expiration des signaux, en tête de liste avant le cap), bandes « Favoris / Autres » distinctes, filtre par nom, badge 🤝 pour les proches également connectés sur LIA, et une fiche 360° en cartes sectionnées. Les connexions entre utilisateurs gagnent leur **chapitre 06** sur la landing (« LIA vous relie à vos proches », scène animée du relais), la recherche des réglages apprend leurs synonymes naturels, et les cartes « Comment fonctionne LIA » cessent d'afficher leurs balises HTML littérales (14 cartes touchées). Backend **14 950** tests, frontend **4 171**.

### Added

- **Favoris de relations** — nouvelle table `relation_favorites` (une étoile par nom plié et par utilisateur, migration `a4b5c6d7e8f9`) : PUT/DELETE `/relations/favorites/{name}` idempotents, étoile optimiste avec réconciliation serveur, favoris injectés dans la vue d'ensemble même sans signal vivant et triés en tête avant le cap ; export RGPD et purge de compte couverts.
- **Refonte UX de la page Relations** — avatars à initiales (teinte stable par personne), pastilles engagements/appels colorées, bandes « Favoris » / « Autres relations » avec compteurs, filtre par nom dès neuf personnes, badge « LIA » sur les proches connectés (pont peers en lecture seule, désactivé avec le flag), fiche 360° : header d'identité (grand avatar, étoile, action « Préparer un point 360° »), sections en cartes avec ancienneté et dates relatives, souvenirs en notes.
- **« Relations » dans la navigation** — l'entrée « Connaissances » cède son créneau (desktop et menu mobile pilotés par la même table) ; l'indicateur Connaissances du chat s'affiche désormais **toujours**, y compris sans aucun espace — il devient la porte permanente de la page.
- **Chapitre 06 de la landing** — « LIA vous relie à vos proches » : trame éditoriale étendue à six chapitres (rail 01→06), scène animée du relais assistant-à-assistant (formulation validée, carte teintée, remise confirmée), trois bénéfices et « sous le capot », dans les six langues.

### Fixed

- **Les cartes « Comment fonctionne LIA » affichaient leurs balises** — quatorze cartes sur cinquante-quatre rendaient `<b>…</b>` littéralement (le rendu des cartes échappait le HTML que les réponses voisines interprétaient) : aligné sur le même contrat de rendu, avec un test qui épingle le bug.
- **La recherche des réglages ignorait les synonymes naturels des Connexions** — « proches », « peer », « social », « réseau social » et même « découverte » (le nom du réglage !) ne trouvaient rien : lexique enrichi dans les six langues, sondé en runtime (7/7 termes).
- **Apostrophes typographiques** — trois clés françaises préexistantes de la page Relations normalisées (U+2019).

### Tests

- +12 backend (14 950) : favoris dans la vue d'ensemble (tri en tête, survie au cap, survie sans signal), badge peers (avec et sans flag), pliage des noms à l'ajout/retrait, délégation et idempotence des endpoints, pont `list_accepted_peer_names` (pliage, déduplication, court-circuit) ; +26 frontend (4 171) : étoile sans ouverture (bouton sœur, `aria-pressed`), bandes et compteurs, filtre (les deux bandes, aucun résultat), badge peers, toggle optimiste en vol + réconciliation + rollback, fiche 360° (étoile, badge), indicateur Connaissances toujours rendu, cartes FAQ sans balise littérale.

## [1.27.0] - 2026-07-30

**LIA cesse d'être un assistant solitaire : deux utilisateurs d'une même instance peuvent désormais se connecter — et leurs assistants se parlent.** Le programme « Connexions entre utilisateurs » ([ADR-180](docs/architecture/ADR-180-Peer-Connections.md)) livre la découverte opt-in par nom exact, les demandes de connexion accept/refus (dans le chat comme dans les réglages), le blocage silencieux anti-harcèlement, et le cœur du dispositif : le **relais de messages assistant-à-assistant** — l'assistant du destinataire transmet le message avec SA personnalité, SA mémoire et SON contexte, en nommant l'expéditeur, dont l'assistant confirme la remise. Chaque connexion peut ouvrir des partages **en lecture seule** choisis champ par champ (disponibilités ou détails du calendrier, titres des tâches — rien n'est partagé par défaut, chaque accès est journalisé et re-vérifié à l'exécution). Trois défauts découverts au premier usage réel sont corrigés à la racine — le validateur sémantique jugeait le contenu français sur son pivot anglais, le discours indirect était relayé tel quel, un plan de disponibilité mourait sur des scopes Google hors sujet — et l'interface gagne sa signature **verre dépoli** : le flou est maintenant réel (les bulles glissent sous la vitre du header), généralisé aux dialogues, menus, tooltips et toasts. Backend **16 796** tests collectés (+145), frontend **4 159** (+65) ; planchers de couverture relevés (backend 63 %). Un ADR (180).

### Added

- **Connexions entre utilisateurs** ([ADR-180](docs/architecture/ADR-180-Peer-Connections.md)) — nouveau domaine `peers` complet : découverte opt-in par nom complet exact (repli accents/casse, fragment d'email masqué pour départager les homonymes, statut relationnel annoté dans les résultats), cycle de vie demande → acceptation/refus → retrait (les deux utilisateurs prévenus par leurs assistants), blocage **silencieux** (la connexion cesse, l'autre ne l'apprend jamais — bloqué, inconnu et cooldown répondent le même 404 octet pour octet), désactivation par flag `PEERS_ENABLED` (off par défaut).
- **Relais assistant-à-assistant** — `envoie/dis/demande à …` produit un brouillon confirmé (HITL) puis livré par l'assistant du destinataire dans sa langue et sa personnalité (profil psychologique, psyché, portrait), avec compteur de relais anti-abus ; le coût LLM de la livraison est imputé à l'**expéditeur** ; répondre = relayer un nouveau message (sans fil), et le message est formulé en **adresse directe** (« demande à X comment il va » → « comment vas-tu ? »).
- **Partages en lecture seule par connexion** — calendrier (disponibilités seules ou avec intitulés) et tâches (titres), dans les deux sens et visibles des deux côtés ; l'accès est re-validé au moment de chaque lecture, tracé dans un journal d'accès consultable, purgé par rétention ; export RGPD et purge de compte couvrent les deux côtés de chaque paire.
- **Section réglages « Connexions »** — recherche, note de contexte, demandes entrantes/sortantes, partages par connexion (select natif), blocages, journal d'accès, et l'affichage du **nom propre copiable** (le nom exact que vos proches doivent chercher — dit platement quand il est vide).
- **Actions rapides dans le chat** — sous un message relayé : Répondre (préremplit le composer, n'envoie jamais) et Bloquer (confirmation) ; sous une demande entrante : Accepter/Refuser en un clic, figés en verdict ; bulles et toasts push peer teintés pour se repérer d'un coup d'œil.
- **Signature verre dépoli généralisée** — dialogues et confirmations (`bg-background/85` + flou fort, arrière-plan flouté), menus, selects Radix, tooltips, panneau de recherche des réglages, toasts ; le header du chat perd son dégradé animé et devient une vitre réelle : le bloc header + recherche + bandeaux est **sticky dans le fil**, les bulles défilent dessous.
- **Observabilité peers** — `peers_events_total` (cycle de vie) et `peers_messages_total` (relais par issue) exposées Prometheus.

### Fixed

- **Le validateur sémantique jugeait le contenu sur le pivot anglais** — demander une réponse à un proche déclenchait des clarifications fantômes (langue du message, accents des noms, identifiant de fil inexistant) : le message ORIGINAL de l'utilisateur est désormais transmis au validateur et fait autorité pour le contenu, les noms et la langue ; le pivot anglais ne sert plus qu'à l'appariement de capacités.
- **Un plan de disponibilité mourait sur des scopes hors sujet** — le domaine `peer` déclarait `contact` en domaine lié, ce qui injectait les outils contacts Google dans le plan ; les scopes manquants invalidaient le plan ENTIER avec une réponse trompeuse (« aucun service configuré »). La résolution d'un nom de connexion n'utilise jamais le carnet d'adresses : lien retiré, outils peer marqués auto-suffisants.
- **Contrôles natifs illisibles en mode sombre** — aucune déclaration `color-scheme` n'existait : les panneaux d'options des selects, scrollbars et date pickers natifs restaient rendus en palette claire. Déclaré globalement (`:root` light, `.dark` dark) — tous les contrôles natifs suivent enfin le thème.
- **Carte de confirmation d'un relais mal composée** — le prompt de critique n'avait pas de gabarit `PEER_MESSAGE` (ligne vide entre le libellé et le message) : gabarit compact ajouté, message affiché verbatim et non tronqué.
- **L'effet de flou était déclaré mais invisible** — `backdrop-blur` ne floute que ce qui passe derrière la surface ; le header du chat étant hors du défilement, rien n'y passait jamais. Restructuré (sticky dans le conteneur de défilement), marges de scroll compensées, prouvé au navigateur (desktop + mobile 390 px).

### Tests

- +145 backend (16 796 collectés) : cycle de vie complet du domaine peers (neutralité octet-à-octet des gardes, transitions conditionnelles claim-once, re-dispatch unique sur course d'INSERT, quotas, revalidation à la livraison, imputation des tokens à l'expéditeur, contrat des codes d'erreur `peers_*`, annotation de statut discovery), 7 tests d'intégration PostgreSQL, contrat du prompt du validateur (l'original fait autorité), gabarit HITL ; +65 frontend (4 159) : hook `usePeerConnections`, 7 composants de la section, actions rapides du chat (préremplissage jamais d'envoi, gel en verdict, mapping des erreurs), bulle teintée, nom propre copiable, badge de statut discovery.
- E2E hermétique : parcours complet de la section Connexions (deep link, toggle, recherche, demande, acceptation, partages) + scan axe + viewport mobile sans débordement, rejoué sur build de production.
- Ratchets relevés : plancher de couverture backend 62 → **63 %** (réel 65,22 %) ; CC frontend et backend revenus à la baseline après décomposition des nouveaux points chauds.

## [1.26.4] - 2026-07-29

**Le retour d'appel parle enfin ta langue — et plus aucune configuration ne pourra l'étouffer en silence.** Un incident de production (second signalement utilisateur sur le même symptôme) livrait chaque compte-rendu d'appel téléphonique en anglais, sans le débrief structuré : la synthèse post-appel était le **seul chemin du dépôt** à contourner le chokepoint central de sortie structurée, si bien qu'un override admin vers deepseek-v4-flash en mode raisonnement prenait un 400 vendor (« Thinking mode does not support this tool_choice ») à chaque appel — et le fallback livrait le résumé brut d'ElevenLabs. Second défaut emboîté, révélé par la preuve runtime : le budget de 600 tokens, calibré avant l'ère du débrief ([ADR-174](docs/architecture/ADR-174-Call-Debrief-Persistence.md)), était **entièrement consommé par le raisonnement** même sur le chemin de secours. Cette version corrige les deux à la racine et ferme la classe entière ([ADR-179](docs/architecture/ADR-179-Structured-Output-Chokepoint-And-Thinking-Budget-Floor.md)) : garde AST repo-wide contre tout futur contournement, plancher systémique « thinking × budget » appliqué à la sauvegarde admin comme au boot, et un frontend qui cesse d'avaler les messages d'erreur explicites du backend. Prouvé au runtime sur la configuration exacte de l'incident : synthèse réelle en français, débrief peuplé, usage tracké. Backend **16 651** tests collectés (+25), frontend **4 094** (+11). Un ADR (179).

### Fixed

- **Retour d'appel en anglais sans débrief** ([ADR-179](docs/architecture/ADR-179-Structured-Output-Chokepoint-And-Thinking-Budget-Floor.md)) — `synthesize_return` passe désormais par le chokepoint `get_structured_output_with_retry` (bascule JSON-mode automatique sous DeepSeek V4 thinking, retry sur échec transitoire) au lieu d'un `with_structured_output` direct ; l'usage tokens (G-1) est capturé par le callback partagé, sémantique de facturation conservée (cache soustrait).
- **Budget de synthèse d'époque pré-débrief** — `telephony_synthesis` recalibré (`max_tokens` 600 → 5 000, timeout 20 s → 60 s, parité `heartbeat_decision`) : mesuré en conteneur, le raisonnement à effort `high` consommait l'intégralité des 600 tokens (contenu vide, puis JSON tronqué).
- **Le toast admin avalait les 422 structurées** — la sauvegarde d'une config LLM affiche désormais le message précis du backend : toast localisé ×6 avec les chiffres interpolés pour le plancher de raisonnement, `msg` backend en description pour les autres erreurs structurées (matrice de raisonnement incluse).

### Added

- **Verrou systémique « thinking × budget »** ([ADR-179](docs/architecture/ADR-179-Structured-Output-Chokepoint-And-Thinking-Budget-Floor.md)) — `LLM_THINKING_MAX_TOKENS_FLOOR` (défaut 4 000, paramétrable) : enregistrer une config dont le raisonnement consomme le budget de complétion (enum hors `none/off/minimal/low`, toggle Qwen activé, budget Gemini non nul) avec un `max_tokens` **effectif** sous le plancher est rejeté en 422 explicite — évalué sur la config fusionnée avec le même `merge_config` que le runtime (laisser le champ vide hérite du défaut : c'est exactement la forme de l'incident), au chemin d'écriture admin **et** au boot sur `LLM_DEFAULTS` (fail-fast).
- **Garde AST repo-wide** — tout appel direct `.with_structured_output(` hors du chokepoint `infrastructure/llm/structured_output.py` échoue la CI (`test_no_direct_structured_output_guard.py`, self-checks anti-rot ; prouvé rouge sur le site fautif avant correction, et sur lui seul).
- **`TokenCaptureHandler` partagé** (`infrastructure/llm/token_capture.py`) — consolide les deux copies privées divergentes (heartbeat lisait `usage_metadata`, open loops lisait `llm_output.token_usage`) : lecture des deux surfaces, fallback seulement, jamais de double comptage.

### Tests

- +25 backend (16 651 collectés) : contrat complet du plancher (formes enum/toggle/budget, bornes, héritage dans les deux sens au niveau service), garde AST auto-vérifiée, capture de tokens (deux surfaces, non-double-comptage, cumul des retries) ; +11 frontend (4 094) : les trois chemins du toast structuré, l'extracteur de détail, et des gardes lisant les six vraies locales pour épingler la survie des placeholders d'interpolation.
- Preuves runtime en conteneur dev : synthèse réelle sur la config exacte de l'incident (deepseek-v4-flash, effort high) → français, tutoiement, dates absolues, débrief peuplé, usage tracké ; 422 du verrou rejouée via le vrai service (vraie DB, vrai catalogue) ; boot fail-fast vert sur les 57 types LLM.

## [1.26.3] - 2026-07-29

**Le cockpit produit dit désormais la vérité, tout de suite.** L'audit du dashboard 26 en production a mis au jour trois défauts réels, tous corrigés : le rôle Grafana en lecture seule n'avait jamais reçu ses droits (créé avant les vues, et le script de runbook ne pouvait pas tourner — `apps/api/scripts/` manquait à la liste de transfert du déploiement) ; le rollup horaire **mourait de faim** (un job à intervalle seul ne tourne jamais quand l'API redémarre plus souvent que l'intervalle — mesuré : 4 démarrages, 0 tick, toutes les jauges vides) ; et des panels affichaient « Awaiting Phase 3/4 » alors que ces phases étaient livrées. Le premier rollup est désormais épinglé **2 minutes après le boot** (prouvé in-process), six panels lisent du **SQL exact** (médiane de profondeur, first-pass proxy, délai inscription→première valeur ACT-03, cohortes, santé des routines — trois nouvelles vues en lecture seule), la recherche et les Web Vitals sont **LIVE Prometheus**, et chaque texte d'attente restant énonce la raison actuelle vraie. Tests inchangés (16 626 backend, 4 083 frontend), 51 tests Pester du déploiement rejoués sur le script modifié.

### Fixed

- **Les droits du rôle Grafana n'étaient jamais appliqués en prod** — rôle créé avant les vues, puis runbook inexécutable : `apps/api/scripts/` absent de la liste blanche de transfert du déploiement (`prepare-prod.ps1` la copie désormais) ; droits appliqués en SQL direct sur l'instance, falsification re-prouvée (tables brutes refusées).
- **Le rollup produit ne tournait jamais** — `next_run_time` épingle le premier run ~2 min après le démarrage (`PRODUCT_ROLLUP_INITIAL_DELAY_MINUTES`) ; un redéploiement n'affame plus les jauges.
- **Panels périmés du dashboard 26** — plus aucun « Awaiting Phase 3/4 » : recherche réglages et Web Vitals (LCP/CLS) branchés sur leurs familles Prometheus livrées ; les textes restants disent la vraie raison (pipeline actif sans données encore validées, télémétrie désactivée, lignage run↔routine non enregistré).

### Added

- **Trois vues produit en lecture seule** (migration `d1e2f3a4b5c6`, 7 vues au total, droits via le script) — `product_routines_snapshot` (santé des routines depuis `scheduled_actions`), `product_time_to_first_value` (P50/P95 inscription→première valeur par cohorte hebdomadaire), `product_quality_daily` (produits/validés/corrigés/rejetés par jour) ; six panels du dashboard 26 passent en SQL exact (3/5/18/27/31/32).

## [1.26.2] - 2026-07-29

**LIA mesure désormais sa propre utilité — chez elle, sans plateforme tierce.** Jusqu'ici l'observabilité répondait « le système va-t-il bien ? » ; personne ne répondait à « combien de personnes obtiennent un résultat réellement utile ? ». Cette version livre le programme complet ([ADR-178](docs/architecture/ADR-178-Product-Value-Dashboard.md)) : un **26e dashboard Grafana** (42 panels) adossé à un modèle normatif de la valeur — un résultat n'est compté qu'une fois **validé E1** (👍 explicite) ou **E2** (action restée non corrigée une fenêtre comportementale complète, 24 h par défaut) ; le succès technique E3 seul est exclu de la North Star. La vérité vit dans PostgreSQL (états mutables : jamais dérivés de compteurs Prometheus) ; des gauges DB-backed la transportent ; Grafana lit les agrégats exacts via un rôle **en lecture seule** restreint à quatre vues (permission refusée sur les tables brutes, `statement_timeout` épinglé). Une **télémétrie client** optionnelle complète le funnel (pages publiques anonymes strictement bornées — aucun identifiant, jamais —, Web Vitals LCP/CLS, installation PWA, recherche des réglages), inerte sans son flag de build. Le **débrief d'appel** liste désormais les faits obtenus (`key_points`) — ce que l'appel a appris, pas seulement ce qu'il a fait — et sa purge redevient fiable (un débrief vide persiste en SQL NULL, plus en littéral JSONB `'null'`). Trois migrations, quatre vues SQL, un rôle PostgreSQL dédié, `alerts-product.yml` préparé (activation après 4 semaines de baseline, ADR-119). Tests frontend **4 072 → 4 083** (+11), backend collectés **16 584 → 16 626** (+42). Un ADR (178).

### Added

- **Cockpit produit — dashboard `26-product-value`** ([ADR-178](docs/architecture/ADR-178-Product-Value-Dashboard.md)) — 42 panels / 11 rows : scorecard exécutive (North Star, pénétration, activation, rétention D7, coût par résultat utile EUR, fraîcheur des agrégats), funnel d'activation, qualité agentique, HITL/brouillons, engagement (DAU/WAU avec caveat conversationnel explicite), connecteurs, routines/proactivité, performance perçue, coûts EUR, qualité des données. Trois états de panel : LIVE Prometheus (27 métriques existantes), gauges produit DB-backed, SQL exact PostgreSQL (médiane de profondeur, cohortes hebdomadaires).
- **Socle outcomes durable** (`domains/product/`) — tables `product_outcomes` (une par run, unique, E1/E2/E3 mutables) et `product_events` (journal borné, utilisateur nullable pour le pré-inscription) ; enregistrement best-effort hors chemin SSE ; rollup horaire leader-elected (backfill des coûts EUR depuis `message_token_summary`, promotions E2, purge à rétention paramétrable 180 j, refresh des gauges) ; purge GDPR câblée (`user_data_map` + service de suppression de compte).
- **Datasource PostgreSQL en lecture seule** — rôle `grafana_product_reader` créé par script idempotent (`task db:create-grafana-reader`) : mot de passe hors migrations, `statement_timeout` 10 s, `GRANT SELECT` sur quatre vues agrégées uniquement — l'accès aux tables brutes est refusé (prouvé), provisioning Grafana interpolé depuis l'environnement.
- **Télémétrie client bornée** (`POST /api/v1/product/events`) — auth optionnelle, rate-limit IP (proxy-aware), lots ≤ 20, schéma 100 % enums : funnel anonyme restreint (landing, inscription, démo, PWA — aucun identifiant stocké), Web Vitals LCP/CLS natifs (PerformanceObserver, échantillonnage configurable) et recherche des réglages (résultats/zéro/utilisé) vers des familles Prometheus bornées ; émetteur frontend fail-silent (sendBeacon au masquage de page), inerte sans `NEXT_PUBLIC_PRODUCT_TELEMETRY`.
- **Débrief d'appel : les points clés** ([ADR-174](docs/architecture/ADR-174-Call-Debrief-Persistence.md)) — champ `key_points` : les informations concrètes obtenues pendant l'appel (horaires, disponibilités, la réponse attendue), renseigné même sans suite actionnable ; affiché dans la carte de débrief, prompt de synthèse ajusté.
- **Alertes produit préparées** — `alerts-product.yml` (fraîcheur 2 h critique, chute North Star, chute succès E2E, pic de feedback négatif — gardes de volume, owner + runbook par alerte), volontairement NON monté avant 4 semaines de baseline (ADR-119).

### Changed

- **`stream_gates.py`** — les pré-contrôles du flux de chat (limite d'usage, capture de géolocalisation) sortent du module SSE gelé vers un module dédié ; le seam produit y reste un unique appel inconditionnel (la garde vit dans le helper).
- **Ratchet de taille verrouillé** — cap de `metrics_agents.py` abaissé (829 → 815) après l'amaigrissement mesuré.

### Fixed

- **Un débrief d'appel vide persistait comme littéral JSONB `'null'`** — `IS NOT NULL` répondait vrai sur un débrief absent (mesuré en prod) et la purge de rétention laissait un mensonge derrière elle ; la colonne passe en `none_as_null=True` (DDL inchangé).
- **Les seeds SQL ignoraient la configuration** — `task db:seed:sql*` codait en dur l'utilisateur et la base (`lia_admin`/`lia`) au lieu de `POSTGRES_USER`/`POSTGRES_DB` ; prouvé par exécution réelle.
- **Pointeurs de documentation périmés** — compte d'ADR et « ADR le plus récent » réalignés dans `docs/INDEX.md` (171 → 178) et `CLAUDE.md`.

### Tests

- **Backend +49 collectés** : vocabulaires bornés et dérivations (device/canal/type de résultat), gardes de cardinalité des métriques (labels interdits `job`/`user_id`/`run_id`, plafonds compteurs/histogrammes), service best-effort (flag off = zéro I/O, panne avalée, chokepoint `normalize_language` zh→zh-CN prouvé), endpoint d'ingestion (anonyme restreint, familles Prometheus, lots plafonnés) ; débrief `key_points` (backend + intégration).
- **Frontend 4 072 → 4 083** (+11) : émetteur inerte par défaut, forme bornée des lots, sendBeacon avec repli fetch, échecs réseau avalés, TrackView à l'affichage, signaux PWA câblés et décâblés au démontage ; entrée justifiée dans l'allowlist `fetch` (sémantique beacon).
- **Fuite d'environnement vitest neutralisée** — `NEXT_PUBLIC_PRODUCT_TELEMETRY` blanchie dans les deux tasks de test frontend (même classe que `NEXT_PUBLIC_API_URL`, documentée).

## [1.26.1] - 2026-07-29

**Le mode HTML enrichi cesse d'être du texte mis en gras et devient une mise en page.** Depuis sa création, le mode d'affichage « HTML enrichi » promettait des réponses soignées mais ne disposait que d'un vocabulaire minimal — des titres, des listes, deux encadrés non documentés. Cette version lui donne un vrai langage visuel ([ADR-177](docs/architecture/ADR-177-Rich-HTML-Response-Components.md)) : la directive expose désormais **sept composants** stylés par le design system — encadrés ×4 avec titre, badges avec icônes, sections dépliables, listes clé-valeur, colonnes responsives, étapes numérotées, tuiles de chiffres clés — plus les accents inline (`mark`, `kbd`, `abbr`) et la **coloration syntaxique** des blocs de code (classe `language-*` → Prism + bouton copier), le tout sous une règle de sobriété explicite (2-3 composants max par réponse : la prose mène, les composants appuient). L'enrichissement est purement déclaratif — prompt + CSS + allowlist, aucun nouveau chemin de code — et chaque classe que la directive annonce doit exister dans la feuille de style, sous peine d'échec CI (garde de synchronisation). En chemin, cinq défauts réels sont tombés : copier une réponse HTML collait du balisage brut (désormais : presse-papiers double saveur, texte lisible partout, partage et export `.md` aplatis) ; le surlignage de recherche cassait les ligatures d'icônes ; les retours à la ligne du HTML pretty-printé créaient des césures parasites ; le code inline était invisible en thème clair ; et les overrides de listes perdaient les classes du design system. Tests frontend **4 034 → 4 072** (+38), backend collectés **16 581 → 16 584** (+3), planchers de couverture relevés (65/59/60/66). Un ADR (177).

### Added

- **Vocabulaire de composants du mode HTML enrichi** ([ADR-177](docs/architecture/ADR-177-Rich-HTML-Response-Components.md)) — la directive `html_response_directive.txt` documente sept composants avec leurs classes exactes : callouts ×4 (`info`/`success`/`warning`/`error`, titre optionnel `.lia-callout__title`), chips `.lia-chip` (variantes couleur + icônes Material Symbols, exclues du TTS et des notifications), sections dépliables `details.lia-collapsible` (chevron animé, focus visible, sémantique native), listes clé-valeur `dl.lia-kv` (grille deux colonnes, repli mobile), colonnes `div.lia-columns` (`auto-fit`, empilement sous 240 px), étapes `ol.lia-steps` (compteurs stylés), tuiles `div.lia-stats`. Règle de sobriété intégrée au prompt ; budget de la directive plafonné à 96 lignes par test.
- **Coloration syntaxique en mode HTML** — la directive exige une classe `language-*` sur chaque bloc de code : le composant `CodeBlock` existant (Prism lazy, thème auto, bouton copier) s'active désormais aussi pour les réponses HTML.
- **Six tags inertes au schéma de sanitisation** — `mark`, `caption`, `abbr`, `time`, `figure`, `figcaption` (aucun n'est scriptable ; `script`/`iframe`/`form`/handlers restent interdits, ordre des plugins inchangé). Pinné dans les deux sens par les tests sanitize.
- **Garde de synchronisation directive↔CSS** (`test_html_directive_css_sync.py`) — toute classe `lia-*` annoncée par la directive doit être stylée dans `lia-components.css`, sinon la CI échoue : une classe non stylée est une fonctionnalité qui meurt invisiblement.
- **Copie double saveur des réponses HTML** — copier un message en mode HTML écrit désormais `text/html` (cibles riches) **et** `text/plain` aplati lisible (éditeurs), avec repli texte seul si `ClipboardItem` manque ; le partage natif et l'export `.md` passent par le même aplatisseur (`html-plain-text.ts`, miroir client des sémantiques `html_to_text` backend).
- **Parcours e2e du mode HTML** (`chat-html-mode-rendering.spec.ts`) — SSE mocké streamant un document riche par fragments coupés mi-balise : composants rendus en vrai DOM (jamais en texte source), dépliable opérable au clavier, zéro débordement horizontal desktop et 390 px.

### Changed

- **Directive HTML réécrite** — éléments de base étendus (`<caption>` de tableau, `<br>` pour les sauts volontaires, balises à la colonne 0), consigne d'adaptation composant↔contenu, et interdiction de style inline maintenue.
- **Polish du socle `.lia-response`** — tableaux zébrés avec survol distinct et légende, rythme vertical (première/dernière marge annulées), code inline sur un fond contrasté dans les deux thèmes, boîte de code legacy scopée `:has(> code)` pour laisser `CodeBlock` se styler seul.
- **Descriptions du mode d'affichage enrichies** — les réglages décrivent désormais les composants réels du mode HTML enrichi, dans les six langues.
- **Les overrides `ol`/`ul` préservent les classes du design system** — même contrat que `p`/`a` : `ol.lia-steps` garde sa classe (et ses compteurs stylés) au rendu.

### Fixed

- **Copier une réponse HTML collait du balisage brut** — `<div class="lia-response">…` arrivait tel quel dans le presse-papiers, le partage et l'export `.md` ; les trois surfaces produisent désormais du texte lisible (structure préservée : puces, clé : valeur, séparateurs de cellules).
- **Le surlignage de recherche cassait les icônes** — chercher un mot égal à un nom de ligature Material Symbols (« event », « mail »…) insérait un `<mark>` au milieu du texte de l'icône : la ligature se brisait et le mot brut s'affichait surligné. Les spans d'icônes sont désormais exclues du surlignage.
- **Césures parasites dans les réponses HTML** — les retours à la ligne du HTML pretty-printé étaient rendus comme des sauts de ligne durs (`whitespace-pre-wrap`) ; l'espace blanc est désormais insignifiant dans `.lia-response` (`<br>` reste le seul saut volontaire).
- **Code inline invisible en thème clair** — le fond du `code` inline (`--lia-surface`, blanc sur bulle blanche, mesuré au runtime) passe sur un token contrasté dans les deux thèmes.

### Tests

- **Frontend 4 034 → 4 072** (+38) : survie des six nouveaux tags et rejet des vecteurs d'attaque, rendu de chacun des sept composants classes incluses, routage `language-*` → CodeBlock, flux tronqué mi-balise sans fuite de texte source, aplatisseur multi-ligne (`html-plain-text`), presse-papiers double saveur avec replis, ligatures d'icônes préservées du surlignage. L'oracle `notification-preview` (27 tests) est passé **sans modification** à travers la refonte sur le module partagé.
- **Backend collectés 16 581 → 16 584** (+3) : garde de synchronisation directive↔CSS + invariants de la directive (interdiction de style inline, budget 96 lignes).
- **Planchers de couverture frontend relevés** : 64/58/58/65 → **65/59/60/66** (mesuré 67.60/61.82/62.46/68.16 — jamais baissés).

## [1.26.0] - 2026-07-29

**LIA cesse de se contenter de montrer ta journée et te laisse agir dessus.** Jusqu'ici le dashboard affichait, le chat répondait, et toute action repassait par une phrase tapée. Cette version transforme les surfaces de lecture en surfaces d'action — sans jamais court-circuiter les garde-fous : chaque écriture externe garde son approbation. Chaque carte du briefing gagne des actions immédiates (résumer un document, préparer une réponse à un mail non lu, marquer une tâche faite, reporter) qui soit **exécutent** par le pipeline normal ([ADR-173](docs/architecture/ADR-173-Card-Intent-Autosend.md)), soit **préremplissent** le composer quand les mots doivent rester les tiens. Sélectionner un passage d'une réponse fait apparaître une barre d'actions (une feuille par le bas en mobile) : expliquer, reformuler, traduire, transformer en tâche ou en rappel, mémoriser, ou poser une question. Les routines gagnent des **conditions** ([ADR-175](docs/architecture/ADR-175-Routine-Condition-Triggers.md)) — ne se déclencher que si une tâche est en retard, qu'un mail correspondant arrive, que la météo tourne, qu'un document atterrit dans Drive, ou qu'un événement approche — avec un mode **proposer d'abord** qui notifie au lieu d'agir. Un **CRM personnel** ([ADR-176](docs/architecture/ADR-176-Personal-CRM-Relations.md)) rassemble ce que LIA sait déjà de chaque personne (engagements ouverts, appels récents, faits mémorisés) en une vue 360°, atteinte depuis le Quick Access du dashboard — qui survit désormais à une panne du briefing, parce que la navigation n'est pas du contenu. Le débriefing d'appel s'enrichit ([ADR-174](docs/architecture/ADR-174-Call-Debrief-Persistence.md)), le dashboard dit la vérité sur la fraîcheur (mis à jour il y a _X_, servi du cache, dernière tentative, réessai en un clic), les connecteurs se lisent connecté-ou-non d'un coup d'œil, et l'indicateur de connaissances passe au centre du bandeau en pastille discrète. Deux bugs de « fonctionnalité invisible » ont été attrapés en revue et corrigés. Tests frontend **3 818 → 4 034** (+216), backend collectés **16 535 → 16 581** (+46). Quatre migrations, quatre ADR (173→176).

### Added

- **Actions immédiates sur les cartes du briefing** ([ADR-173](docs/architecture/ADR-173-Card-Intent-Autosend.md)) — chaque élément gagne des puces d'action, **frères** du bouton de ligne (jamais de bouton imbriqué, atteignables au clavier). Une action « exécuter » ouvre le chat sur `?intent=` et l'envoie par le pipeline normal — l'approbation HITL des écritures externes reste intacte ; une action « préremplir » (`?draft=`) laisse la main. Un quota atteint dégrade proprement en brouillon + toast. Cinq cartes couvertes (documents, mails, tâches, agenda, anniversaires).
- **Actions sur une sélection de texte dans le chat** (C-02) — sélectionner un passage d'une réponse fait flotter une barre (desktop) ou une feuille par le bas (mobile, maison, sans dépendance, non modale — la doctrine ADR-171 protège l'en-tête collant) : expliquer, reformuler, traduire, → tâche, → rappel, mémoriser, demander. La citation est **gelée** depuis l'instantané React (iOS efface la sélection au tap), et les boutons `preventDefault` au pointer-down pour ne pas replier la sélection avant le clic.
- **Studio de routines conditionnelles** ([ADR-175](docs/architecture/ADR-175-Routine-Condition-Triggers.md)) — une routine peut se déclencher sur un fait (`task_overdue`, `weather_change`, `mail_match`, `document_added`, `calendar_event`) plutôt qu'à heure fixe, avec un champ de requête là où il a du sens, et une case « proposer d'abord » qui notifie une proposition (`?intent=`) au lieu d'exécuter. Les évaluateurs lisent par les fetchers du briefing (caches Redis, coût borné), dédupliquent par empreinte de fait, et ne lèvent jamais (une panne de fournisseur = « non rempli », retenté au tick suivant).
- **CRM personnel — Relations** ([ADR-176](docs/architecture/ADR-176-Personal-CRM-Relations.md)) — un domaine en lecture seule (motif briefing, sans nouvelle table) agrège autour de chaque personne ses boucles ouvertes, ses appels récents et les mémoires qui la citent, en une vue 360°. La résolution d'identité est best-effort et **énoncée comme telle** (repli accent/casse → EXACT/NORMALISÉ, bandeau dès qu'une mémoire est rattachée). Atteint depuis le Quick Access du dashboard (pas de slot de nav, l'en-tête clippe à 5). Anniversaires/contacts = phase 2.
- **Raccourcis PWA sur l'écran d'accueil** (N-13) — installée, LIA propose des raccourcis (prochaine priorité, ajout rapide, appui-pour-parler `?voice=1`, briefing compact) et un pavé d'appui-pour-parler dédié.
- **Raccourcis « / » de chat personnalisables** — un administrateur définit ses propres commandes slash (colonne JSONB `chat_shortcuts`, migration `d4e5f6a7b8c9`), les identifiants des commandes intégrées restant réservés (`error_reserved`, `error_duplicate`, `error_invalid_id`).
- **Raccourci Connaissances dans la navigation** (R01) — les Espaces de connaissances rejoignent la barre de nav, et l'indicateur de connaissances actives du bandeau chat devient un menu d'activation/désactivation rapide par espace.
- **Débriefing d'appel enrichi** ([ADR-174](docs/architecture/ADR-174-Call-Debrief-Persistence.md)) — le retour d'appel porte désormais résultat, engagements, tâches, rappels, incertitudes et un brouillon de suivi en un geste (`ReturnProposal` v2, champs additifs ; la forme v1 reste valide ; colonne `phone_calls.debrief` JSONB, migration `e5f6a7b8c9d0`, purgée par le reaper avec le résumé).
- **Fraîcheur honnête du dashboard** (D-04) — chaque carte date sa donnée (mis à jour il y a _X_, servie du cache), affiche la dernière tentative sur erreur et propose un réessai par carte **sans LLM** (`/briefing/refresh-cards`) ; le badge survit à l'erreur.

### Changed

- **L'indicateur de connaissances passe au centre et devient homogène** — l'indicateur d'espaces RAG actifs était positionné en `absolute` et chevauchait la recherche quand le pavé « traitement » élargissait le côté gauche. L'en-tête du chat est refait en trois colonnes en flux (côtés `flex-1`, centre `shrink-0`) : centré quand les côtés s'équilibrent, il se **décale** sans jamais chevaucher. Le libellé « X espace(s) RAG actif(s) » devient un nom comptable homogène avec la nav « Connaissances », dans les six langues (fr « X connaissance(s) »), et la pastille de contexte adopte le même gabarit.
- **Distinction connecté/déconnecté homogène** (K01) — un connecteur replié se lit connecté / en erreur / non connecté d'un coup d'œil, grammaire visuelle unique plus une puce texte.
- **Alignement des puces d'action de carte** — le lien externe (Drive) rejoint le **même** conteneur que les puces (un seul écart, une seule ligne centrale, même gabarit) ; les trois contrôles d'une ligne partagent désormais un centre vertical identique.

### Fixed

- **La ligne « cartes à configurer » affichait des clés brutes** — `BriefingSetupHint` (introduit en v1.25.24) construisait `dashboard.briefing.sections.<carte>.title`, un chemin inexistant dans les six locales : tout compte neuf voyait `dashboard.briefing.sections.weather.title` au lieu de « Météo ». Chemin corrigé vers `cards.<carte>.title`, et une garde lit désormais les **vraies** locales pour vérifier que chaque titre de section résout dans les six langues.
- **La seule porte vers le CRM disparaissait quand le briefing tombait** — `TodayBriefing` faisait un early-return sur l'écran d'erreur qui emportait le Quick Access, or c'est l'unique entrée vers Relations (pas de slot de nav). L'écran d'erreur rend désormais le Quick Access : la navigation ne dépend plus du contenu.

### Tests

- **Frontend 3 818 → 4 034** (+216) : puces d'intention des cartes (exécuter vs préremplir), auto-envoi `?intent=`/`useAutoSendIntent`, sélection de texte (`useTextSelection` avec refus cross-scope, actions et guillemets typographiques par langue), fraîcheur des cartes (badge sur erreur), studio de conditions, CRM (liste + vue 360°), raccourcis de chat, distinction connecteurs, garde de résolution des titres de cartes dans les six locales.
- **Backend collectés 16 535 → 16 581** (+46) : service Relations (agrégation, identité best-effort déterministe), évaluateurs de conditions (jamais de `raise`, complétude au boot, dédup par empreinte), débrief téléphonie (v1/v2), raccourcis de chat, fraîcheur `stale`/`from_cache` du briefing.
- **Trois parcours e2e neufs** (`relations-crm`, `chat-selection-actions` avec Range réelle, `routine-studio-condition`) plus la sonde de reachability de l'en-tête sur six largeurs × trois langues (0 chevauchement, 0 rognage). mypy strict propre (999 fichiers), cliquets CC/a11y/hooks tenus.

## [1.25.33] - 2026-07-28

**Le bouton d'envoi annonçait une chose et en faisait une autre ; désormais tout le composer dit la vérité.** Champ vide, le bouton portait le libellé accessible « maintenir pour parler » tout en affichant l'icône d'envoi — et sans micro utilisable il restait **cliquable pour ne rien faire**. Il montre maintenant exactement ce qu'un appui fera : micro quand il parlerait, envoi quand il enverrait, désactivé quand il n'y a rien à faire — un seul libellé partagé entre l'aria et le texte visible, pour que la divergence d'origine ne puisse pas revenir. Autour de cette vérité, le composer a gagné le flux qui lui manquait : une capture d'écran se **colle** directement dans la conversation (Ctrl+V) par le pipeline exact du trombone — un collage mixte texte+image conserve **les deux** —, une vraie zone de dépôt remplace le simple anneau pendant un glisser-déposer, et chaque réponse gagne un menu **partager/exporter** : feuille de partage native là où le navigateur en offre une (détection de **capacité**, jamais de plateforme — Chrome/Edge Windows exposent `navigator.share`), export Markdown daté partout. L'animation du hero est devenue un moteur de timeline partagé qui anime désormais la landing **et** `/demo` en interactif — pastilles de scène, pause/relecture, scène choisie jouée une fois puis figée sur sa résolution — les contrôles vivant hors du `role="img"` décoratif. La mesure a corrigé deux mensonges au passage : le toast de PDF trop volumineux revendiquait la limite **image** (10 Mo) contre un plafond document de 20 Mo, et une animation qui ne se joue jamais (onglet caché, préférence de mouvement basculée en vol) pouvait figer l'icône d'envoi à la place du micro pour toujours. Tests frontend **3 769 → 3 818** (+49), backend 16 535 inchangés, cliquets abaissés (hooks 34→33, complexité 51→50).

### Added

- **Coller une capture d'écran dans le composer** — `Ctrl+V`/`Cmd+V` avec une image ou un PDF dans le presse-papiers téléverse par le pipeline existant (limites, aperçu, suppression inchangés). Règle fine mesurée sur les trois cas : fichiers seuls → téléversement et insertion bloquée ; texte seul → collage natif intact ; mixte → le texte se colle **et** les fichiers partent. Le filtre est celui du glisser-déposer (`image/*` + PDF), rien de plus permissif.
- **Partager ou exporter une réponse** — menu « … » dans la rangée d'actions de chaque réponse : « Partager » n'apparaît que si `navigator.share` existe (une annulation de la feuille est un non-événement, un échec réel un toast), « Télécharger en Markdown » partout — blob UTF-8, nom daté `lia-AAAA-MM-JJ-HH-mm.md`, accents préservés par le nettoyeur de noms partagé avec le téléchargement d'images. Absent des bulles sans texte (une réponse image seule n'a rien à exporter) et pendant le streaming.
- **« Personnaliser » à côté de « Tout rafraîchir »** — la grille du briefing était configurable depuis l'UXR Lot 5, mais la capacité vivait enfouie dans les réglages ; un lien discret (icône seule en mobile) mène droit à la section `briefing-grid`, et le CTA « toutes les cartes sont masquées » y mène désormais aussi au lieu de la page nue.
- **La démo devient interactive — et le hero aussi** — quatre pastilles de scène (`aria-pressed`, libellés existants réutilisés), pause/reprise, relecture, progression discrète ; la boucle automatique continue tant que personne n'interagit ; une scène choisie se joue une fois puis se fige sur sa frame de résolution. Sous `prefers-reduced-motion` : frames statiques par scène, zéro timer, contrôles d'animation masqués. Le hero de la landing monte le même composant avec son CTA masqué (`withCta={false}` — il a déjà le sien à côté).
- **Une vraie zone de dépôt** — overlay non interactif (`pointer-events-none`, compteur anti-scintillement conservé) : icône, « Déposez vos images ou PDF ici », bordure en pointillés — au lieu du seul anneau de focus.
- **Micro-célébration de fin d'onboarding** — six particules ✨ (0,8 s, échelonnées) autour de la coche, une seule fois par vie du compte (`celebrated_at`), keyframe existante réutilisée (déjà dans le kill-switch reduced-motion) plus garde JavaScript.

### Changed

- **La scrollbar du textarea n'existe plus sous le plafond de hauteur** — `overflow-y: hidden` jusqu'à 200 px (constante partagée par les trois sites couplés), bascule en `auto` exactement au plafond ; le flash de scrollbar entre la frappe et le redimensionnement disparaît, ainsi que l'artefact d'arrondi DPI signalé sur textarea vide.
- **Le moteur du mockup est extrait et unique** — `useMockupTimeline` (planification, pause/reprise avec temps consommé, gel manuel de fin d'acte) + `MockupStage` (le cadre) ; `ChatMockup` est **supprimé** (code mort après le transplant du hero), ses six comportements épinglés migrés dans la suite du composant interactif. La préférence de mouvement passe par `useSyncExternalStore` (SSR-propre, suit un basculement en direct).
- **« Elle appelle pour toi » devient « Elle appelle »** — dans les six langues : les quatre pastilles tiennent sur une ligne, et chaque pilule est insécable (`whitespace-nowrap`).
- **Les rejets de pièces jointes portent la limite qui s'applique** — `file_too_large` et `max_attachments` transportent leur plafond réel depuis le hook au lieu de nombres codés en dur dans le toast.

### Fixed

- **Le faux bouton « maintenir pour parler »** — voix non supportée + champ vide : le bouton restait cliquable et muet, avec une invitation à parler dans l'aria. C'est désormais un bouton d'envoi désactivé, comme il l'a toujours été de fait.
- **Le toast de PDF trop volumineux mentait** — il affichait « max 10 Mo » (la limite image) pour un document plafonné à 20 Mo.
- **L'icône d'envoi pouvait rester figée à la place du micro** — `animationend` ne se joue jamais si la keyframe est morte (onglet caché, reduced-motion basculé en vol, et jsdom/React 19 ne le délivre **jamais** — mesuré sur un `<div>` nu) : un timer de libération (700 ms) borne l'état, `onAnimationEnd` reste le chemin nominal.
- **`LANDING_PAGE.md` décrivait un composant supprimé** — cinq passages réalignés sur `InteractiveChatMockup` (tableau des composants, animations, gardes-fous, `/demo`, arborescence).

### Tests

- **49 tests frontend ajoutés** (3 769 → 3 818) : collage (fichiers seuls/texte seul/mixte/filtre/désactivé), table de vérité du bouton (micro offert, envoi désactivé, persistance du décollage, reduced-motion), overlay de dépôt, contrat d'erreur enrichi du hook d'upload, menu partager/exporter (détection de capacité, annulation silencieuse, échec réel, export daté zéro-paddé), bouton Personnaliser, célébration (6 particules, silence reduced-motion), moteur interactif (sélection, pause/reprise, relecture, gel de fin d'acte, frames statiques, nettoyage des timers), `withCta` du hero.
- **Deux passes e2e complètes sur bundle de production** — 110/110 avant puis après le transplant du hero (axe `/demo` et landing clair+sombre, garde d'overflow 375 px sur le cycle d'animation entier, journeys chat) ; preuve runtime dans le conteneur : pastilles, pause et CTA dans le HTML servi.
- **17 tests observés ROUGES avant chaque implémentation** (TDD strict) ; les gardes migrées de `ChatMockup.test` couvrent l'intégralité des six comportements du fichier supprimé.

## [1.25.32] - 2026-07-28

**La table qui rendait les réglages adressables en connaissait 17 sur 30.** La page Réglages empile ses sections en accordéons repliés ; depuis la v1.25.24 une table de liens profonds permettait d'en viser une par URL, et la v1.25.31 venait de rendre sa barre d'onglets réellement collante. Restait le cas du lecteur qui connaît le **nom** du réglage et rien d'autre. En construisant le champ de recherche, la table s'est révélée incomplète : la page rend **43** sections (30 pour l'utilisateur, 13 en administration) et la table en déclarait **17**. Les treize absentes sont précisément celles qu'un champ de recherche attire — Langue, Apparence, Fuseau horaire, Police, Mode d'affichage, Authentification forte, Mes appareils, Exporter mes données, Génération d'images, Boucles ouvertes, MCP application, Panneau de debug, Export de consommation. Un index bâti sur les 17 déclarées aurait rendu **zéro résultat** sur « thème », « langue » ou « mot de passe ». Deux gardes existaient pour tenir cette table, et **aucune ne regardait dans ce sens-là** : l'une dérivait le nom du composant du nom de fichier, si bien que `theme-selector.tsx` produisait une aiguille (`<theme-selector `) qui ne correspondait à rien — l'entrée était sautée et le test passait **à vide**. Trois autres défauts sont sortis de la mesure plutôt que de la relecture : **212 apostrophes courbes** en français rendaient « application d'authentification » introuvable au clavier, un contraste de **3,51:1** échouait le plancher AA sur une ligne de résultat, et la barre collante passait de 117 à **161 px** sans que la marge de défilement suive. Tests frontend **3 540 → 3 769** (+229), backend 16 535 inchangés.

### Added

- **Un champ « Rechercher un réglage », dans la barre collante** ([ADR-172](docs/architecture/ADR-172-Settings-Quick-Search.md)) — il indexe les **30 sections utilisateur** des deux onglets : titre, description et une liste de mots-clés rédigée dans les six langues. La recherche est insensible à la casse, aux accents et à la typographie, et le classement va du titre commençant par la requête jusqu'à la description, en départageant les égalités par l'ordre de la page. Choisir un résultat bascule l'onglet, déplie l'accordéon, fait défiler sous l'habillage collant et **pose le curseur sur la section** — ce dernier point uniquement pour la recherche : un lien `?section=`, un retour OAuth ou le raccourci portrait ne volent pas le focus, parce que personne ne l'a demandé à cet instant.
- **Les treize sections manquantes deviennent adressables** — la table passe de 17 à 30 jetons, dans l'ordre de la page. Ce sont autant de nouvelles adresses publiques (`?section=theme`, `?section=security-auth`…), donc des ajouts et jamais des renommages.
- **180 mots-clés de recherche, écrits langue par langue** — ce sont les mots que le lecteur tape et que ni le titre ni la description ne contiennent : « sombre », « 2FA », « TOTP », « RGPD » (DSGVO en allemand), « cron », « micro ». Mesuré avant de les écrire : aucun de ces termes ne trouvait quoi que ce soit. Les sigles d'usage international restent sous leur forme internationale, la traduction locale les accompagne.
- **Une garde de couverture d'index** (`settings-sections-coverage.guard.test.ts`) — tout composant rendu dans un panneau d'onglets doit être indexé, structurel, ou **explicitement différé avec une raison écrite**. Il n'y a pas de quatrième issue : une section ajoutée demain force une décision au moment où elle est ajoutée. Les 13 sections d'administration hors périmètre y sont **énumérées** et non résumées en une phrase — la liste est anti-pourrissement (une entrée que la page ne rend plus fait échouer le test), et la vider constitue à elle seule la phase suivante.
- **Une garde de résolution des pluriels** — les vérifications d'i18n prouvaient qu'une forme `_one`/`_other` existe et porte son `{{count}}`, pas que `t()` l'**atteint** : le suffixe est choisi par i18next depuis `Intl.PluralRules`, et le stub de test de tout le dépôt renvoie la clé. Un vrai i18next tourne désormais sur les six locales pour l'ensemble des pluriels épinglés — briefing, échéance des images, recherche. Falsifié en retirant une forme : `zh: settings.search.results_count did not resolve for count=1`.

### Changed

- **La marge de défilement des sections suit la barre qui a grandi** — la barre collante passe de 117 à 161 px en accueillant le champ. Mesuré dans Chromium plutôt que déduit : la barre s'étend de y 64 à 161, `scroll-margin-top` se résout à 176 px et une section liée atterrit à exactement 176, soit 15 px d'air. La contrepartie est une contrainte de forme, écrite là où elle s'applique : ce que la barre contient doit garder une **hauteur constante**, puisqu'une seule valeur sert les trente sections — résultats, compteurs et messages vivent donc dans une fenêtre en positionnement absolu.
- **Le défilement vers une section respecte enfin `prefers-reduced-motion`** — `scrollIntoView({behavior:'smooth'})` en JavaScript ignore cette préférence, ce que la fonction voisine du même fichier documentait déjà pour le changement d'onglet sans que le chemin des liens profonds en tienne compte.
- **Le normaliseur de recherche replie la typographie** — apostrophes courbes et espaces insécables rejoignent la forme que produit un clavier. Le repli est **un point de code pour un point de code**, et c'est une contrainte dure : `findNormalizedMatches` reconstitue les positions d'origine en sommant les longueurs caractère par caractère, si bien que les trois surligneurs bâtis dessus ne restent exacts qu'à cette condition. Le repli de ligatures (`ß`→`ss`) est écarté pour cette raison et traité en donnée, par un mot-clé allemand.
- **Une table remplace la chaîne de conditions qui dirigeait l'expansion** — le compilateur a prouvé que la branche « administration » était devenue inatteignable ; un `Record` indexé par onglet garde la correspondance **complète par le type**, si bien qu'un quatrième onglet ou les jetons d'administration à venir échouent à la compilation au lieu de déplier silencieusement le mauvais accordéon.

### Fixed

- **Deux gardes de la table de liens profonds passaient à vide** — le nom du composant se lit maintenant depuis son **export** et non depuis le nom de fichier, et l'absence d'un composant sur la page est une **erreur** au lieu d'un saut silencieux. Falsifié dans les deux sens avant correction : avec l'ancien code l'entrée `theme` tombait dans la branche « composant non rendu » et le test réussissait sans rien vérifier ; avec le nouveau, la même entrée mal placée échoue en nommant l'onglet réel.
- **La recherche ne trouvait pas « d'authentification »** — les six locales mélangent l'apostrophe courbe U+2019 et l'apostrophe ASCII (mesuré : **212** en français, 94 en italien, 16 en anglais), et la description de l'authentification forte porte la courbe. Le correctif vit dans le normaliseur partagé, donc il répare du même coup la recherche de la FAQ, qui butait sur les mêmes caractères.
- **Une ligne de résultat échouait le contraste AA** — `text-muted-foreground/80` mesurait 3,51:1 sur le fond du menu, sous le plancher de 4,5:1 exigé en 12 px. Le défaut a été trouvé par un scan d'accessibilité **avec la liste ouverte**, qu'il a fallu ajouter : le scan existant de la page ne voit jamais ce menu.
- **L'option parcourue au clavier pouvait sortir de la vue** — `aria-activedescendant` désigne l'option active **sans** déplacer le focus, ce qui laisse le curseur dans le champ mais prive le navigateur de tout défilement automatique : au-delà de la huitième, la flèche bas parcourait des lignes invisibles.
- **Une trentaine de fichiers de guide affichaient des métriques périmées** — la page « Diriger une IA qui code » annonçait 10 000 tests pour 20 304 mesurés, 120+ ADR pour 171, 120+ versions pour 180 et « près de 400 » métriques pour 447. Un chiffre sous-évalué de moitié reste un chiffre faux.

### Tests

- **229 tests frontend ajoutés** (3 540 → 3 769), dont **34 revendications de rappel mesurées dans les six langues** — « mot de passe » atteint l'authentification forte, « sombre » atteint l'apparence, « RGPD » atteint l'export, « 主题 » atteint le thème — et un plancher que rien ne doit franchir : dans chacune des six langues, **toute** section reste atteignable en tapant son propre titre.
- **Les gardes sont falsifiées, pas seulement vertes** — retirer `theme` de la table fait rougir la garde de couverture en nommant le composant ; déplacer une section d'un groupe fait rougir la garde de groupe ; retirer une forme plurielle de `zh` fait rougir la garde de pluriels. Une garde qui n'a jamais rougi sur le défaut qu'elle prétend couvrir ne prouve rien.
- **La revue a trouvé quatre défauts après que tous les contrôles étaient verts** — une fonction rendue morte par le lot lui-même et ses tests devenus vides de sens, un champ d'index jamais lu, l'absence de preuve que les pluriels se résolvent, et une branche superuser de l'expansion d'accordéon **jamais exercée en navigateur, ni avant ni après**. Les contrôles automatiques ne signalent aucune de ces quatre classes.

## [1.25.31] - 2026-07-28

**Trois en-têtes se déclaraient collants et aucun ne l'était.** La feuille de style posait `overflow-x: hidden` sur `body` ; or la spécification impose qu'un seul axe non-`visible` fasse **calculer l'autre à `auto`**. `body` devenait donc un conteneur de défilement — jamais défilé, puisque sa hauteur suit son contenu et que le défilement de page appartient au viewport — et tout descendant `position: sticky` s'y ancrait. Mesuré dans Chrome sur un élément réel : l'en-tête de `/privacy` valait **top −400 pour scrollY 400**, −1200 pour 1200, −2000 pour 2000. Il suivait le document au pixel près depuis l'origine du projet, sur le tableau de bord comme sur les pages légales, et la landing avait contourné le problème sans le diagnostiquer en passant son propre en-tête en `position: fixed`. Aucune garde ne mesurait une position **pendant** un défilement : c'est structurellement ce qui a laissé passer le défaut. Le réparer a rendu possible la barre d'onglets persistante des réglages — et a immédiatement révélé un second défaut de la même famille : à l'ouverture d'un menu de l'en-tête, Radix reposait `overflow: hidden` sur les deux axes pour verrouiller le défilement, l'en-tête sautait de nouveau hors de l'écran, et il fallait remonter tout en haut pour que le logo redevienne utilisable. Autour de cette réparation, quatre surfaces ont été densifiées ou remises d'équerre, dont deux défauts d'accessibilité qu'aucune capture d'écran ne montre : chaque section de réglages émettait **deux** titres au lieu d'un, et son chevron ne pivotait jamais. Tests frontend **3 491 → 3 540** (300 fichiers), backend 16 535 inchangés.

### Added

- **La barre d'onglets des réglages reste visible pendant le défilement** — la page empile une trentaine de sections repliées sur deux ou trois onglets ; passé quelques écrans, plus rien n'indiquait quel onglet était ouvert et changer d'onglet imposait de remonter. La barre se colle désormais sous l'en-tête. Elle conserve exactement la présentation d'origine — parts égales, contenu centré, icône, `text-sm` — à une chose près : le libellé ne peut plus **s'échapper** de son bouton. Mesuré avec la police réelle, trois colonnes égales réclament de 422 px (de) à 488 px (it) quand un téléphone de 390 px en offre 358 : `whitespace-nowrap` poussait « Einstellungen » hors de sa propre pastille et le dépassement était rogné au bord de l'écran, invisiblement. `min-w-0` plus `truncate` transforment cette coupe silencieuse en ellipsis explicite ; sur desktop, où rien ne dépasse, le changement est sans effet observable.
- **Une garde de navigation sur le défilement** (`settings-sticky-tabs.spec.ts`, 5 cas) — la barre survit à un défilement de 1 200 px, chaque onglet garde une part égale à un pixel près et son libellé à l'intérieur de son bouton dans les trois locales les plus longues, et une section atteinte par lien profond se pose **sous** l'habillage collant plutôt que dessous. Les deux gardes structurantes sont falsifiées : en réinjectant l'ancien `overflow`, la barre repart à **−1019** ; en rétablissant l'ancienne grille, le libellé allemand ressort de nouveau de sa pastille.
- **Une garde sur l'en-tête et les menus** (`mobile-nav.spec.ts`) — ouvrir le menu du logo depuis le milieu d'une page ne doit pas emporter l'en-tête. Aucun test de composant ne peut voir ce défaut : l'en-tête paraît correct tant que la page n'est pas défilée.

### Changed

- **Les deux grandes cartes d'accès rapide deviennent une barre** — « Aide » et « Réglages » sont deux destinations secondaires, placées juste avant le briefing, et elles coûtaient **208 px sur un téléphone** et 104 px sur un écran large pour dire deux mots. Elles tiennent maintenant dans **123 px** et **62 px** (mesurés), orbes décoratives et lévitation au survol supprimées, sans qu'aucun libellé ni sous-libellé ne soit perdu dans les six langues. La disposition est dictée par la mesure et non par le goût : « Einstellungen » fait 92 px en Inter 14 px/600, et deux segments côte à côte n'en laissent que 54 à 78 px à 320 px — les segments s'empilent donc sous `sm` et s'alignent au-dessus. Ce sont désormais des **liens** et non des boutons : clic milieu, ouverture dans un nouvel onglet, URL au survol et rôle annoncé correctement.
- **Les sections de réglages se resserrent sur mobile uniquement** — 24 px de marge intérieure deviennent 16 px sous `sm`, avec des icônes et un titre proportionnés ; au-delà, la densité est **strictement inchangée** (mesuré à 24 px sur les six locales). Les descriptions sont conservées intégralement, sans troncature.
- **Les groupes de réglages deviennent de vrais titres** — les six intitulés de groupe étaient des `<span>` : la page sautait de son `<h1>` aux `<h3>` des sections, sans rien entre les deux, et la navigation par titres d'un lecteur d'écran ne voyait aucun groupe. La structure est désormais h1 → h2 → h3, à style identique.
- **Les pouces des notifications rejoignent la barre d'actions** — ils vivaient dans la bulle, sous le texte, précédés d'une phrase entière (« Cette notification vous a-t-elle été utile ? »), ce qui donnait au même geste deux apparences selon le type de message. Ils sont maintenant des pastilles de la ligne d'actions, à droite de « copier », dans la même forme que ceux d'une réponse ordinaire — notifications proactives **et** notifications de centres d'intérêt. Un verdict déjà donné ne fait plus disparaître la ligne : la pastille choisie reste affichée pressée, mais **désactivée**, car un verdict proactif est définitif côté serveur là où celui d'une réponse se change à volonté. L'état survit aux rechargements et aux appareils sans un octet de code serveur : `feedback_value` était persisté depuis toujours et le frontend l'ignorait.
- **Les menus déroulants ne verrouillent plus le défilement** — ce sont des menus de navigation, pas des boîtes de dialogue. Neutraliser le verrou en CSS a été mesuré puis écarté : forcer `overflow: clip` rétablissait bien l'en-tête, mais laissait la page défiler derrière le menu et aurait affaibli le verrou des vraies modales.
- **Le bouton « Connecter » du tableau de bord devient « Services »** — il mène à la page des connecteurs, dont le titre parle de services. La clé i18n a été renommée avec lui plutôt que laissée à mentir sur son contenu.

### Fixed

- **`position: sticky` était inopérant dans toute l'application** ([ADR-171](docs/architecture/ADR-171-Sticky-Positioning-Repair.md)) — `body` clippe désormais en `clip` et non plus en `hidden` : `clip` clippe le même dépassement **sans** établir de scrollport, `overflow-y` reste `visible` et le collage se résout de nouveau contre le viewport. `html` garde `hidden`, propagé au viewport, si bien qu'un moteur qui ignorerait `clip` continue de clipper la page. Neutralité mesurée et non supposée : `scrollWidth − clientWidth` vaut **0 avant comme après**, y compris avec un enfant de 3 000 px injecté, donc les gardes de dépassement horizontal conservent leur verdict ; les éléments `position: fixed` gardent un rectangle identique ; les `sticky` vivant dans un conteneur à défilement interne — le bouton « revenir en bas » du chat, l'entête de l'aide au démarrage — n'étaient pas concernés.
- **Chaque section de réglages émettait deux titres au lieu d'un** — `Accordion.Header` de Radix rend déjà un `<h3>` autour de son déclencheur, et le composant en rendait un second **à l'intérieur du bouton**. Une trentaine de sections apparaissaient donc en double dans la liste des titres d'un lecteur d'écran, et un titre imbriqué dans un bouton est du contenu de flux là où seul du contenu de phrase est admis. Mesuré sur la page : **14 titres pour 14 sections**, contre 28 auparavant.
- **Le chevron d'une section ne pivotait jamais à l'ouverture** — le sélecteur de rotation visait `> div > svg.chevron` alors que le chevron est un enfant **direct** du déclencheur : il ne pouvait matcher dans aucun état. Le défaut est structurel, donc prouvable sans navigateur, et une garde vérifie désormais la forme du DOM dont dépend la règle.
- **Trois locales annonçaient un nombre de tests périmé** — le guide technique affichait encore 16 388 tests backend en allemand, espagnol et italien quand l'anglais, le français et le chinois disaient déjà 16 535 : la v1.25.30 n'avait mis à jour que la moitié des locales. Un chiffre faux dans trois langues sur six est un chiffre faux.
- **Une section entière du guide technique était inatteignable depuis le sommaire, dans les six langues** — et la correction publiée en v1.25.30 n'en traitait que la moitié visible. `GuideMarkdown` **jette** la table des matières du markdown (tout ce qui précède le premier `## 1.`) et attribue les ancres aux `<h2>` **par position**, depuis un tableau de code. Ce tableau portait **25 entrées pour 26 sections** : la §26 « Psyche Engine » se rendait avec `id={undefined}`, sans icône, et n'apparaissait dans aucun sommaire latéral — depuis le jour où elle a été écrite. Corriger la liste que lisent les humains sur GitHub, comme fait en v1.25.30, ne réparait rien pour les utilisateurs.

### Tests

- **49 tests frontend ajoutés** (3 491 → 3 540), chacun sur un symptôme observable plutôt que sur une classe CSS : les deux destinations de la barre d'accès rapide et leurs URL localisées, l'absence de contenu de flux dans un lien ou un bouton, le titre unique par section, la forme de DOM dont dépend la rotation du chevron, le niveau de titre des groupes, la sémantique d'onglet préservée sous l'habillage collant, et le verdict proactif qui doit rester celui que l'utilisateur a choisi — un booléen aurait affiché un pouce levé à qui venait de cliquer sur le pouce baissé.
- **La complexité cyclomatique de `ChatMessage` a baissé** (54 → 53) en sortant les pouces de la bulle ; le gain est verrouillé dans le cliquet, conformément à la doctrine qui veut qu'un plancher ne redescende jamais.
- **Un test qui pinnait l'ancien comportement a été réécrit, pas supprimé** — « masque la ligne après un vote » est devenu « affiche le verdict enregistré, pressé et désactivé », et un cas vérifie qu'un second clic n'atteint pas l'API.

## [1.25.30] - 2026-07-28

**Le texte écrit par un inconnu arrivait au modèle sans étiquette, et une boucle autonome facturait à son budget le temps où elle attendait un humain.** Une partie de ce que LIA place dans ses prompts n'est pas écrite par son utilisateur : le corps d'un email, la description d'une invitation rédigée par son organisateur, une page web, le résumé éditorial d'un lieu, le résultat d'un serveur MCP. Ce texte doit atteindre le modèle étiqueté **donnée à analyser**, jamais **instruction à suivre**. Le mécanisme qui existait était appliqué outil par outil, et la recherche exhaustive des appelants l'a invalidé comme stratégie : `perplexity_tools`, `brave_tools`, `mcp_react_tools` et `emails_tools` n'étaient pas couverts — ce dernier annonçant pourtant dans sa propre docstring qu'il renvoie _« FULL email content (body, headers, attachments) »_. Surtout, le contenu atteint le modèle par deux surfaces dont **aucune n'est un outil**, dont `generate_data_for_filtering`, qui s'exécute sur **tous** les tours produisant des données, dans les **deux** modes d'exécution. La provenance est désormais portée par la **donnée** : les 24 types du registre sont classés une fois, un type inconnu vaut _externe_, et le démarrage refuse un registre incomplet. Quatre autres défauts prouvés par l'exécution vivaient à côté : le prompt ReAct était réémis à chaque tour (**840 jetons × N**, cache de préfixe détruit, bloc envoyé passant de 6 143 à 18 409 caractères entre 1 et 5 tours), le délai d'attente de la boucle courait sur l'horloge murale et non sur le calcul (**2,01 s d'horloge pour 0,0102 s de calcul** mesurées sur un graphe réel), rien ne détectait un agent qui rappelle indéfiniment le même outil, et une recherche hybride mémoire annoncée à l'utilisateur **n'existait plus depuis la v1.14.0**. Tests backend **16 388 → 16 535** (873 fichiers), frontend 3 491.

### Added

- **La provenance du contenu est une propriété de la donnée** ([ADR-167](docs/architecture/ADR-167-Content-Trust-Registry.md)) — les 24 types du registre sont classés `INTERNAL` ou `EXTERNAL` dans une table unique, et le classement se lit ligne à ligne dans le prompt. Le choix par défaut est **fermé** : un type absent de la table, ou nul, vaut _externe_. Une carte météo que LIA calcule elle-même n'est pas de la même nature qu'une invitation dont le titre a été écrit par quelqu'un d'autre — et c'est bien le second cas qui domine, 15 types sur 24. Un assert de complétude au démarrage refuse de booter sur un type non classé, selon la doctrine [ADR-085](docs/architecture/ADR-085-Registry-Completeness-Assertions.md) : un nouveau type de donnée ne peut plus arriver silencieusement du côté « de confiance ».
- **Les motifs d'injection sont détectés, jamais assainis** — sept familles reconnues dans les six langues de l'application : rôle usurpé (`SYSTEM:` en milieu de paragraphe compris), détournement d'instruction, changement de persona, exfiltration de données, appel d'un outil LIA nommé dans du texte tiers, caractères Unicode invisibles, directive cachée dans un commentaire HTML. Le contenu part au modèle **inchangé**, accompagné d'une note qui nomme la famille : assainir reviendrait à modifier un email que l'utilisateur pourrait vouloir lire tel quel, et à se donner une garantie que le contournement suivant démentirait. La détection est bornée aux 20 000 premiers caractères, compte `prompt_injection_patterns_total{family, item_type, surface}`, et **ne journalise jamais le texte** — celui-ci est par construction contrôlé par l'attaquant et contient couramment les données de l'utilisateur.
- **Une garde d'absence de progrès sur la boucle autonome** ([ADR-170](docs/architecture/ADR-170-React-Compute-Budget-And-Loop-Guard.md)) — au `REACT_REPEATED_CALL_BLOCK_THRESHOLD`-ième (4 par défaut) appel **identique** dans un même tour, l'outil n'est pas exécuté et le modèle reçoit une consigne de changer d'approche ; au terminal (5), le tour se conclut. L'empreinte est un HMAC calé sur la clé de l'application, si bien qu'elle survit à une reprise HITL sur un autre worker, et **seuls l'empreinte et un compteur** sont conservés : ni le nom de l'outil ni ses arguments n'atterrissent dans le checkpoint PostgreSQL. La garde est placée **après** le saut d'idempotence, ce qui est exactement ce qui la rend sûre au rejeu — sans quoi une simple reprise aurait compté deux fois le même appel.
- **Un runbook pour l'alerte de mémoire conteneur** — l'annotation de l'alerte pointait vers `HighMemoryUsage.md`, qui documente une alerte de **nœud**. Le nouveau document explique pourquoi `working_set` et non `usage`, comment lire `memory.stat` du cgroup, et ce qu'il faut faire selon le service concerné.

### Changed

- **Les blocs système du tour ReAct sont de l'état, plus des messages** ([ADR-169](docs/architecture/ADR-169-React-System-Blocks-Are-State.md)) — ils vivent dans une clé d'état dédiée et sont recomposés en tête à chaque appel du modèle, au lieu d'être empilés dans l'historique. Le préfixe redevient **stable**, condition nécessaire au cache de préfixe des fournisseurs. Le schéma d'état passe en **1.4** avec une migration additive et idempotente ; le fenêtrage laisse passer le résumé de compaction, qu'une première tentative de correctif détruisait — la revue de ce correctif-là est ce qui a produit la bonne solution.
- **La boucle autonome se juge sur son calcul, plus sur l'horloge murale** — le budget cumule le temps réellement passé dans le nœud d'appel du modèle. Le temps que vous prenez pour approuver une action ne consomme plus rien, et `react_agent_duration_seconds` cesse de mesurer votre temps de réflexion. Un compteur séparé expose l'écart entre l'horloge et le calcul, pour que ce qui n'est pas facturé reste **visible**.
- **Le modèle de portrait mémoire rejoint les prompts versionnés** — deux gabarits jusque-là écrits en français dans du Python, contrairement à la règle qui veut que tout texte destiné au modèle vive dans `prompts/v1/`. Le rendu est figé **octet pour octet** par un test : une extraction de texte est exactement le genre de changement qui déplace une espace sans que personne le voie.
- **L'alerte de mémoire conteneur mesure ce que le noyau regarde** — `container_memory_usage_bytes` compte le page cache, que le noyau récupère avant de tuer quoi que ce soit. Prometheus est le pire cas : son TSDB mappe jusqu'à 2 Go de rétention dans un cgroup de 256 Mo, donc il **remplit sa limite par construction**. L'alerte sonnait en boucle sur un conteneur parfaitement sain (98,41 % pendant des semaines). Elle porte désormais sur `container_memory_working_set_bytes`, la grandeur qui décide de l'OOM, et la limite passe à **512 Mo** — elle avait été resserrée à 256 Mo en v1.13.1 sur un instantané à ~98 Mo, avant que la charge ne triple. Conséquence : une occurrence de cette alerte signale maintenant une vraie pression mémoire, et mérite d'être traitée plutôt qu'acquittée.
- **Node 24 LTS partout, y compris dans l'image API** — le dépôt était aligné sur la ligne 24 en cinq endroits (l'image web `node:24-alpine`, les cinq déclarations `node-version` des trois workflows, le verrou `engines` `>=24.0.0` rendu opposable par `engine-strict=true`, et l'hôte de développement), mais l'image API installait Node **22** : ce Node-là n'exécute que le CLI d'administration à distance, pas LIA, et il était donc passé sous le radar de l'alignement précédent. La version **flotte** désormais à l'intérieur de la ligne 24, comme ses deux bases voisines qui flottent déjà (`python:3.12-slim-bookworm`, `node:24-alpine`) : les correctifs de sécurité de la ligne arrivent sans intervention, là où une version écrite en dur dans un fichier que personne ne relit est exactement ce qui vient de casser la construction deux fois.
- **L'archive Node est désormais vérifiée, plus seulement téléchargée** — le `SHASUMS256.txt` publié par nodejs.org fournit à la fois le nom exact de l'archive à tirer **et** sa somme de contrôle ; c'est ce qui rend le flottement sûr. Aucune vérification d'intégrité n'existait auparavant : l'archive était acceptée sur la seule foi de TLS. Garde falsifiée dans les trois directions — archive altérée rejetée, ligne de somme absente rejetée, archive authentique acceptée. La procédure d'installation du guide DevOps suit la même mécanique, pour que ce qu'un humain exécute sur le Raspberry Pi soit ce que la construction exécute.

### Fixed

- **Une capacité annoncée à l'utilisateur n'existait plus depuis la v1.14.0** ([ADR-168](docs/architecture/ADR-168-Removal-Of-Dead-Hybrid-Memory-Search.md)) — le panneau de débogage affichait « recherche hybride : activée/désactivée » pour un moteur BM25 + pgvector qui n'avait **aucun appelant**. 421 lignes, 21 % de couverture, 100 lignes sur 127 jamais atteintes, importées à chaque démarrage. La mémoire long terme avait migré vers son propre modèle pgvector et le chemin hybride n'avait pas suivi. Le module, ses quatre réglages, ses deux métriques et l'affichage sont supprimés : afficher un interrupteur qui ne commande rien est pire que de ne rien afficher.
- **Le temps d'attente humain coupait le tour repris** — `interrupt()` lève, donc aucun horodatage n'est rafraîchi, et la reprise ré-entre au nœud interrompu sans rejouer le routeur où vivait la remise à zéro. Vérifié sur un graphe LangGraph réel : _routeur rejoué à la reprise ?_ **non**. Dès qu'une approbation dépassait 120 s, le tour repris était coupé au routage suivant, le dernier message portait encore ses appels d'outils et aucun contenu, la réponse était **re-synthétisée par un second appel LLM** et le travail multi-étapes était perdu.
- **Le prompt ReAct n'est plus dupliqué à chaque tour** — au troisième tour, 2 520 jetons de prompts identiques repartaient **à chaque appel de chaque itération**. Le fournisseur Anthropic rejetait par ailleurs la séquence dès le deuxième tour, un `SystemMessage` ne pouvant pas apparaître au milieu d'un historique.
- **Un test d'alerte échouait sur un artefact d'échantillonnage, pas sur la règle** — `SystemKnowledgeIndexationFailing` était évalué sur des points espacés d'une heure, or un sélecteur de plage PromQL est **ouvert à gauche** : le point initial sortait de la fenêtre `(0h, 6h]` à l'instant même de l'évaluation. Mesuré sur les mêmes données, `increase(...[6h])` vaut **1,2** avec un échantillon horaire et **2,0** au pas de 30 s réellement collecté. Les deux cas sont ré-échantillonnés au pas de production ; la règle, elle, était correcte.
- **L'intégration continue validait les alertes avec un moteur PromQL qui n'est pas celui de la production** — `promtool` **2.53.2** côté validation, Prometheus **3.0.0** côté exécution. Ce n'est pas théorique : le même fichier, les mêmes règles et les mêmes données donnaient `SUCCESS` d'un côté et `FAILED` de l'autre, l'extrapolation d'`increase()` ayant changé entre les deux majeures. Une règle pouvait donc franchir la CI et se comporter autrement en production. Les deux validateurs sont alignés sur la version de l'image, avec la consigne écrite de les bumper ensemble.
- **L'image de développement ne se construisait plus** — régression introduite par le correctif Node de la v1.25.29 et trouvée en construisant réellement l'image, ce que ce correctif-là n'avait pas fait. `gpg --dearmor` ne fonctionnait que parce que le script d'amorçage NodeSource installait `gnupg` **comme effet de bord** de sa propre installation ; retirer le script a donc emporté une dépendance que rien ne déclarait, et la couche échouait en `gpg: not found`. `gnupg` est désormais listé explicitement. L'image de production n'était pas touchée : elle l'installait déjà nommément. Une dépendance implicite est une dépendance que personne ne voit tant qu'elle ne disparaît pas.
- **Une affirmation fausse a été retirée de la documentation et des commentaires** — la v1.25.29 présentait le 403 de `deb.nodesource.com` comme définitif (« répond désormais 403 »). Vérification faite, l'endpoint répond de nouveau **200** : c'était une panne d'environ une heure le 2026-07-27, pas un retrait. Le correctif reste valable, mais pour la bonne raison — ce n'est pas que NodeSource ait disparu, c'est que `curl … | bash -` **ne peut pas** échouer bruyamment, si bien que n'importe quel hoquet amont produit silencieusement une image sans npm.

### Tests

- **146 tests ajoutés**, chacun sur un symptôme observable : les 24 types du registre classés un par un et l'assert de complétude qui refuse le boot, les sept familles d'injection prouvées dans les six langues **et** les faux positifs qu'elles ne doivent pas produire, le marquage sur les trois surfaces qui atteignent le modèle, l'ordre des lignes et la légende qui ne doit pas se lire comme un identifiant d'élément, la recomposition des blocs système sur six configurations de tour, et la garde anti-boucle au rejeu comme au premier passage.
- **Un défaut a été trouvé dans un test avant de l'être en production** — la légende de provenance commençait par `[EXT]`, or le prompt de réponse enseigne que « l'identifiant d'un élément est `[item_id]` en début de ligne » : la légende se serait lue comme un élément d'identifiant `EXT`. Reformulée avant tout envoi au modèle.
- **Une troisième surface a été découverte en cassant un test existant** — `build_recent_entities_context` réutilise `generate_data_for_filtering`, et son oracle comptait les lignes produites. La légende en ajoutait une : le test avait raison de rougir, et il a révélé un chemin que la recherche d'appelants n'avait pas remonté.

## [1.25.29] - 2026-07-27

**Bloquer un sujet ne l'empêchait pas de revenir, et un seul tour de conversation pouvait effacer un profil.** v1.25.28 avait refondu les deux prompts d'admission ; la mesure qui a suivi a montré que le prompt n'était qu'une moitié du problème. Sur la base de production, **7 des 10 centres d'intérêt créés en juillet ont été bloqués par l'utilisateur lui-même**, contre 0 sur les 25 antérieurs. En rejouant 45 fenêtres de conversation **réelles**, l'ancien prompt écrivait sur 16 d'entre elles — et l'une, une simple demande de localisation sur une carte, proposait **19 suppressions, soit la totalité du profil actif** : les suppressions ne portent aucun champ de confiance et n'étaient validées que sur l'UUID et la propriété. Trois défauts structurels vivaient à côté, indépendants de tout prompt. La déduplication n'interrogeait que les intérêts **actifs** : chronologie de production du 21 juillet, création à 12:51, **blocage par l'utilisateur à 19:14**, recréation par l'extracteur à **19:39** sous un libellé voisin — 0,9821 de similarité cosinus, très au-dessus du seuil de fusion, la ligne aurait fusionné si elle avait été visible. Les intérêts dormants étaient invisibles de la même façon, ce qui rendait leur branche de réactivation inatteignable. Et la fenêtre de comparaison valait 20 lignes pour 19 intérêts actifs. Mesuré sur deux modèles : bruit sur les négatifs **0,50 → 0,00**, rappel **0,75 → 1,00**, batterie _held-out_ comprise. Tests backend **16 293 → 16 388** (866 fichiers), frontend **3 473 → 3 491**.

### Added

- **Un plafond sur les actions destructrices d'une extraction** ([ADR-166](docs/architecture/ADR-166-Extraction-Admission-Doctrine.md)) — au-delà de `EXTRACTION_MAX_DELETES_PER_RUN` (2 par défaut), **toutes** les suppressions du lot sont écartées et comptées : un lot qui en propose dix-neuf n'est pas une intention utilisateur, c'est une génération qui déraille. Les créations et mises à jour du même lot sont **conservées** — elles sont récupérables et filtrées ailleurs, et perdre une création légitime parce que la même réponse contenait des suppressions serait un second défaut. La garde est partagée par la mémoire et les centres d'intérêt : la mémoire portait exactement la même mécanique, sur des données plus précieuses encore.
- **Un instrument de mesure de la sélectivité des extractions** — `scripts/measure_extraction_selectivity.py` rejoue une batterie de conversations issues de la production (les négatifs rejouent des intérêts que l'utilisateur a réellement bloqués, les positifs des intérêts vivants depuis des mois) et rapporte bruit, rappel, volume et coût en jetons. Une **seconde batterie held-out** porte les mêmes classes sur des sujets absents des prompts : sans elle, un score parfait ne mesurerait que la capacité d'un prompt à recopier ses propres exemples. C'est aussi ce qui permet de distinguer une régression d'une dérive de fournisseur — un cas limite mesuré à 1,00 puis à 0,00 quelques heures plus tard sur le modèle de production tient toujours à 1,00 sur un second modèle, avec l'ancien comme avec le nouveau prompt.
- **Les notifications de veille ont enfin des boutons de retour** — 914 notifications portaient `feedback_enabled` et disposaient d'un point d'entrée fonctionnel, mais **aucun composant ne les affichait** : seules les cartes de centres d'intérêt étaient traitées. Le contrat de la veille n'accepte que deux verdicts, sans « ne plus proposer » ; l'affichage suit le contrat plutôt que de copier l'autre carte.
- **Le verdict d'un retour rejoint enfin la piste d'audit** — 989 notifications d'intérêt portaient une colonne de retour vide **depuis toujours**, faute d'appelant. La carte transmet désormais l'identifiant de la notification dont elle provient, si bien que le verdict atterrit sur la bonne ligne — et jamais sur une ligne devinée : un retour donné depuis la liste des réglages n'en attribue aucune.
- **Deux gardes de doctrine sur les prompts d'admission** — les quatre fondements, les six classes d'exclusion, la règle de suppression et l'accord entre le plancher écrit et le plancher appliqué sont figés par des tests. Ils normalisent les espaces : c'est la doctrine qui est verrouillée, jamais la mise en forme.

### Changed

- **La déduplication des centres d'intérêt voit tous les statuts** — et décide **par statut** : bloqué → rien du tout, dormant → réactivation, actif → consolidation. `update` et `delete` sont refusés sur un intérêt bloqué, parce que supprimer la ligne **détruirait le blocage** et rouvrirait le sujet. La fenêtre de comparaison passe à 200 lignes et devient distincte de la liste montrée au modèle, qui reste bornée par son budget de jetons.
- **Le plancher de confiance passe de 0,6 à 0,75 et devient réglable** — le prompt ancre désormais son échelle sur le fondement qu'il sait nommer (0,95 passion déclarée ou pratique personnelle, 0,85 connaissance préalable, 0,75 approfondissement). Sur huit passes de batterie et 90 fenêtres rejouées, toute création émise valait 0,75, 0,85 ou 0,95 — jamais entre les deux : le plancher rend la règle écrite opposable sans écarter quoi que ce soit que le modèle produise réellement.
- **Le seuil de fusion reste à 0,89, et la raison est désormais écrite** — re-mesuré sur 16 couples réels de production, 0,83 fait jeu égal en nombre d'erreurs mais produit **deux fusions abusives** (`android`~`ios` à 0,857, deux villes à 0,890) là où 0,89 produit deux doublons rattrapables. Un doublon se corrige ; une fusion abusive détruit un intérêt distinct sans retour.
- **La boucle d'application des actions d'intérêt devient un module** — extraite du service d'extraction, qui **descend de 881 à 736** lignes logiques et perd son point chaud de complexité, la boucle devient une surface directement testable, ce qui est la condition pour couvrir sérieusement les décisions par statut.
- **Le marquage des retours devient commun aux deux familles de notifications** — la même mécanique masque les boutons après un verdict, sur la veille comme sur les centres d'intérêt ; sans elle, la même notification pouvait être notée à chaque rechargement de page.

### Fixed

- **Bloquer un centre d'intérêt l'empêche enfin de revenir** — c'est le signal de rejet le plus fort dont dispose un utilisateur, et il était défait 25 minutes plus tard sous un libellé voisin.
- **Un centre d'intérêt dormant est réactivé au lieu d'être dupliqué** — le code de réactivation existait depuis longtemps ; il était simplement inatteignable, faute de voir la ligne.
- **Deux créations proches dans un même lot ne passent plus toutes les deux** — la liste des candidats était figée avant la boucle, si bien qu'une création n'était jamais comparée à la précédente.
- **L'effort de raisonnement choisi par un administrateur n'est plus effacé** — l'interface n'envoie que les champs qui diffèrent du défaut, la colonne stockait alors `NULL`, et la fusion des configurations lisait « modèle changé, aucun effort fourni » comme « aucun raisonnement », au lieu de « garder le défaut ». Résultat : les trois extracteurs de fond tournaient sans le raisonnement que le code croyait leur donner. L'héritage exige désormais une **preuve** de compatibilité avec le nouveau modèle — un modèle inconnu retombe sur le comportement sûr d'avant.
- **Des données personnelles réelles ont été retirées du dépôt public** — l'adresse postale complète d'un tiers, un patronyme et quatre prénoms de proches répartis sur vingt emplacements (code, tests, ADR, README, changelog), le prénom d'un parent dans un contexte de décès, une commune de résidence et une adresse e-mail personnelle en clair. Tout est remplacé par des équivalents fictifs cohérents, sans affaiblir aucun test. Le garde-fou qui existait déjà pour cette classe (`test_no_infra_info_guard`) est désormais **armé** sur ces jetons : la classe ne peut plus revenir.
- **Une carte de veille n'emprunte plus ses libellés au domaine des centres d'intérêt** — chaque famille de notification porte les siens, dans les six langues.
- **L'image de production se construit à nouveau** — et le défaut n'est pas la panne, c'est le **mode de défaillance**. `curl -fsSL <url> | bash -` ne peut pas échouer bruyamment : un tube rapporte le code de sortie de sa **dernière** commande, donc quand `curl` échoue, `bash` lit une entrée vide et sort en 0. Le 2026-07-27, `deb.nodesource.com` a répondu **403** pendant environ une heure (il répond 200 depuis — c'était une panne, pas un retrait) ; cela a suffi : la couche réussissait, apt résolvait alors `nodejs` depuis Debian (18.x, qui n'embarque pas npm), et la construction mourait quatre couches plus loin sur `npm: not found`. Node est désormais installé depuis la distribution **officielle** de nodejs.org, en tenant compte de l'architecture pour que la construction multi-plateformes de la release continue de fonctionner — et `node -v && npm -v` s'exécute dans la **même** couche, si bien qu'un prochain hoquet amont fera échouer la construction au bon endroit au lieu de dégrader silencieusement en un Node sans npm.
- **Le téléchargement du modèle de reconnaissance vocale ne dégrade plus en silence** — la même classe de défaut, trouvée en corrigeant la précédente. `curl -L -o encoder.onnx` sans `--fail` écrit le **corps de l'erreur HTTP** dans le fichier : une page de maintenance du CDN produisait quelques centaines d'octets de HTML nommés `encoder.onnx`, la construction **réussissait**, et la reconnaissance vocale échouait à l'exécution sur une erreur d'analyse onnx incompréhensible. Aucune reprise n'était armée non plus, si bien qu'une seule coupure de flux sur un transfert de 107 Mo suffisait à tuer la construction — c'est exactement ce qui a fait rougir l'intégration continue. Les trois fichiers sont désormais tirés avec échec sur code HTTP, cinq reprises et un plancher de taille vérifié dans la même couche : le plancher rattrape le corps trop court qui revient malgré tout en 200, que `--fail` ne peut pas voir.

### Tests

- **95 tests ajoutés**, chacun sur un symptôme observable : le lot de dix-neuf suppressions, un sujet bloqué qu'une création tente de ressusciter, un dormant réactivé, un `update` qui viserait un bloqué, une écriture inter-locataires, deux créations jumelles dans un lot, l'effort de raisonnement conservé ou abandonné selon la compatibilité prouvée, et les deux contrats de retour de bout en bout.
- **Un oracle faux a été trouvé et corrigé trois fois** pendant la mesure — dont une fois où la réponse de l'assistant, laissée telle quelle après un renommage, rendait l'échange incohérent. Un scénario négatif n'est valide que si aucun fondement admissible n'y existe.
- **La revue du correctif a trouvé un défaut dans le correctif** — une création ne rejoignait pas le jeu de candidats, donc deux créations proches dans un même lot passaient toutes les deux.

## [1.25.28] - 2026-07-27

**Des conversations entières n'arrivaient jamais jusqu'à la mémoire, et rien ne pouvait le dire.** Deux questions — « les échanges simples alimentent-ils la mémoire, les centres d'intérêt et les journaux ? » et « peut-on faire modifier une skill ? » — ont ouvert un angle mort commun : chaque décision d'extraction était journalisée en `debug`, sans aucun agrégat. Quatre défauts y vivaient. Une conversation par Telegram n'a **jamais** alimenté un journal ni la psyché, quoi que l'utilisateur ait activé : le handler ne transmettait pas les deux préférences, les défauts de signature (`False`) s'appliquaient, et les colonnes valent pourtant `true` en base. Un échange menant à une action confirmée n'extrayait **rien du tout** : le tour riche s'arrête sur l'interruption avant le nœud de réponse, et le tour de confirmation sortait par un chemin rapide placé avant la planification — « envoie un mail à Marie pour lui dire que je déménage à Lyon » ne laissait aucune trace. À l'inverse, un refus faisait analyser par quatre extracteurs un message **fabriqué par le système**, avec le risque de l'écrire en mémoire. Et un contact nommé Fine, Cool ou Bien perdait tous ses souvenirs, en silence : l'heuristique qui écarte « ok » et « merci » s'appliquait aussi aux noms de personnes, et ces mots-là sont de vrais patronymes. Côté skills, le moteur d'écriture existait depuis [ADR-118](docs/architecture/ADR-118-Chat-Driven-Skill-Import.md) mais restait inatteignable : l'assistant ne pouvait pas lire un manifeste, une réécriture effaçait la vignette de la galerie, et son propre prompt lui ordonnait de renommer plutôt que de mettre à jour. Tests backend **16 159 → 16 293** (856 fichiers), frontend 3 473.

### Added

- **Modifier une skill en conversation** ([ADR-165](docs/architecture/ADR-165-Skill-Editing-By-Regeneration.md)) — « ajuste ma skill », « ajoute-lui une section », « corrige la formulation ». L'assistant lit le paquet courant, applique la demande par-dessus, et régénère **l'intégralité** du package sous le même nom : jamais un correctif ponctuel, parce que le manifeste, les scripts et les références doivent rester d'accord entre eux. Le premier appel est **refusé** et énumère ce que le remplacement ajouterait, remplacerait et surtout **supprimerait** ; il n'exécute qu'au second, muni d'un jeton dérivé du contenu. Ce jeton n'est pas un détail de forme : un simple drapeau aurait été une convention que le modèle est libre d'ignorer, alors qu'un condensé ne peut qu'avoir été **reçu** — et comme il couvre le contenu des fichiers, ce que l'utilisateur approuve est exactement ce qui sera écrit.
- **Le manifeste d'une skill devient lisible** — `read_skill_resource` sert désormais `SKILL.md` et `translations.json`. L'activation retire le frontmatter : sans cela, l'assistant n'avait jamais vu `description`, `category`, `priority`, `plan_template` ni `outputs`, et « ajuster » revenait à réécrire à l'aveugle en perdant ces champs. Les deux fichiers restent hors du catalogue de ressources, pour ne changer aucun prompt d'activation.
- **La cohérence d'un paquet skill est vérifiée** — un `outputs` annonçant une sortie interactive sans script, ou une ressource déclarée mais absente, est rejeté. Le générateur ne validait que le **texte** du manifeste, jamais le paquet réel ; l'édition rend ce mode de défaillance courant.
- **Toute décision d'extraction est comptée** ([ADR-164](docs/architecture/ADR-164-Post-Response-Extraction-Coverage.md)) — `post_response_extraction_scheduled_total{kind, outcome}` couvre les six sous-systèmes et huit issues. Une part durable de `trivial`, `user_disabled` ou `no_user` sur un sous-système signifie qu'il s'affame en silence : c'est précisément ce qu'aucun tableau de bord ne pouvait montrer.
- **Les acquiescements sont reconnus dans les six langues** — « ja », « gracias », « grazie », « 好的 » coûtaient jusqu'ici un calcul d'embedding et quatre appels LLM chacun. Trois mots sont **délibérément exclus** de la liste parce qu'ils sont aussi des patronymes attestés, et une garde de non-régression fige cette exclusion.

### Changed

- **Les deux entrées d'un canal partagent une seule résolution de préférences** — la duplication entre la route entrante et celle des rappels HITL _est_ la cause du défaut : quand les journaux et la psyché sont arrivés, seul le chat web a appris à les transmettre. Un résolveur unique la supprime, et deux fonctions du domaine perdent au passage de la complexité (14 → 11 et 18 → 16).
- **Les trois extracteurs partagent la recherche du dernier message utilisateur** — ils en portaient chacun une copie. Le helper commun centralise le marquage des messages fabriqués et **abaisse** les trois points chauds concernés (69 → 67, 76 → 74) au lieu de les grossir.
- **La limite d'imports de skills passe de 5 à 10 par minute** — une modification coûte deux appels depuis que la confirmation est en deux temps ; l'ancien budget n'autorisait que deux modifications et demie par minute.
- **Le prompt d'extraction des centres d'intérêt est refondu autour de fondements nommés** — un sujet pouvait être demandé, cherché ou cité et devenir un centre d'intérêt alors qu'il n'engageait en rien l'utilisateur. La création exige désormais de nommer **un** fondement parmi quatre — passion déclarée, pratique personnelle, connaissance préalable, approfondissement sur plusieurs tours — **et** de citer les mots de l'utilisateur qui le portent. Six classes d'exclusion sont énoncées comme classes et non comme exemples : le sujet d'une demande, une remarque sur l'assistant, le goût d'un tiers, un essai isolé, une action utilitaire, et tout ce que l'assistant a lui-même introduit. Le seuil de confiance est ancré sur le fondement plutôt que laissé au ressenti.
- **Le prompt de mémoire long terme distingue le sujet d'un échange de ce qu'il révèle** — ce qu'un utilisateur demande n'est pas ce qu'il est : interroger sur les trous noirs ne dit rien de lui. Sont désormais explicitement écartés le sujet de la demande, les faits propres à un tiers sans lien avec l'utilisateur, les affirmations sur l'état du monde qui seront fausses dans quelques mois, et ce qui est vrai de presque tout le monde. À l'inverse, un créneau **récurrent** devient une habitude qui mérite d'être retenue, là où un rendez-vous isolé reste de la logistique. Quatre quasi-erreurs réelles sont documentées dans le prompt comme contre-exemples.

### Fixed

- **Les journaux personnels et la psyché fonctionnent enfin sur les canaux externes** — Telegram, WhatsApp : ce que l'utilisateur a activé s'applique désormais partout. Les deux paramètres sont **obligatoires** côté handler, car un paramètre optionnel aurait reproduit l'omission au prochain appelant ajouté. Sans ligne utilisateur identifiée, rien n'est écrit.
- **Un échange menant à une action confirmée alimente à nouveau la mémoire, les intérêts et le journal** — la reprise d'un brouillon n'injecte aucun message, si bien que la demande d'origine est encore la dernière parole de l'utilisateur au moment où le chemin rapide s'exécutait : la correction est exacte, pas approximative.
- **Un refus n'est plus analysé comme une parole de l'utilisateur** — le message d'échafaudage injecté par la couche de reprise est marqué, et les trois extracteurs remontent au message réel. Le marquage passe par les métadonnées du message, jamais par une reconnaissance de son texte : cet échafaudage existe en six langues.
- **Un contact dont le nom ressemble à un acquiescement retrouve ses souvenirs** — l'heuristique de trivialité ne gouverne plus que ce que l'utilisateur a réellement tapé. Les appelants qui lui passaient un nom de personne ou une requête interne doivent désormais le déclarer explicitement, parce qu'un défaut silencieux est exactement ce qui a produit le défaut.
- **La langue de repli d'un rappel de canal n'est plus le français en dur** — elle suit la configuration, comme partout ailleurs.
- **Un nom propre a été retiré d'un index de documentation** — présent depuis v1.14.1 dans un dépôt public, il illustrait une correction de résolution relationnelle et a été remplacé par une formulation générique.
- **Suppression d'une fonction d'extraction sans aucun appelant** — ni dans le code, ni dans les tests.

### Tests

- **134 tests ajoutés** couvrant chaque défaut par son symptôme observable : les souvenirs d'un contact nommé Fine, la propagation des préférences aux trois sauts d'un canal, le tour de confirmation d'un brouillon, la cible d'extraction sur un refus, les six langues d'acquiescement, et les six refus de l'édition de skills.
- **Le correctif du chemin rapide a été falsifié** avant d'être retenu : retiré, le test échoue ; remis, il passe.
- **La revue du correctif a trouvé quatre défauts dans le correctif lui-même**, tous corrigés — dont un validateur qui aurait rejeté la skill système `skill-generator`, et une confirmation contournable en un seul appel.

## [1.25.27] - 2026-07-27

**Donner un volume au cache ne suffisait pas : au premier démarrage sur ce volume neuf, deux workers sont morts.** v1.25.26 avait fait survivre le cache d'embeddings d'outils au déploiement ; le démarrage suivant a montré ce que le volume seul ne règle pas. Le volume était vide, les **quatre** workers uvicorn ont tous manqué le cache et ont tous embarqué **les mêmes 713 textes du catalogue en même temps** — 2 852 contenus. Le fournisseur a répondu un `429` d'une nature différente de la précédente : « _Resource exhausted. Please try again later_ », lien Vertex AI, donc une saturation de **capacité** et non le quota nommé. Le sélecteur d'outils n'a aucun retry et son échec remonte hors du lifespan : `Application startup failed. Exiting.` à 11:37:26 et 11:37:27. Ils ne se sont pas dégradés, ils ont **quitté** — uvicorn les a respawnés et leurs remplaçants ont relu le cache que les survivants venaient d'écrire (pids 51/54 à 5 min 21 d'ancienneté contre 188/189 à 4 min 33), soit **~48 s à deux workers sur quatre**. Ce rétablissement fonctionne par accident : il exige qu'au moins un worker réussisse. Désormais un seul calcule, et les autres attendent son résultat. Tests backend **16 146 → 16 159** (854 fichiers), frontend 3 473.

### Added

- **Une revendication exclusive pour calculer les embeddings d'outils** ([ADR-163](docs/architecture/ADR-163-Tool-Embeddings-Cache-Claim.md)) — sur un défaut de cache, un worker prend le droit de calculer par `os.open(lock, O_CREAT | O_EXCL)` : c'est le système de fichiers qui désigne le gagnant, sans Redis ni base, entre processus qui ne partagent que le volume. Trois propriétés la rendent sûre plutôt que maligne. Un détenteur mort ne bloque pas un démarrage — une revendication trop vieille est volée, sans quoi un seul crash ferait attendre le délai complet à chaque démarrage suivant puis embarquer quand même. Un détenteur qui échoue **passe la main** : le relâchement vit dans un `finally`, donc les tentatives se sérialisent à 713 textes au lieu de se paralléliser à 2 852. Et perdre la coordination n'est jamais fatal : délai expiré ou verrou impossible, on calcule sans revendication — le comportement d'avant — et `miss_unclaimed` le dit sur un tableau de bord.
- **Quatre issues distinguées sur la métrique du cache** — `hit`, `hit_after_wait`, `miss`, `miss_unclaimed`. La troisième et la quatrième sont ce qui permettra de voir, sans fouiller les journaux, si la coordination a effectivement évité la rafale ou si elle a été perdue.

### Changed

- **Le cache d'embeddings d'outils a son propre module** — `tool_embeddings_cache` porte la résolution du chemin, la lecture, l'écriture atomique et la revendication. Ce n'est pas un rangement : le concern avait acquis ses propres modes de défaillance, et `tool_selector` **descend de 515 à 462** lignes logiques au passage, sans nouveau cycle d'import.
- **Le seuil de péremption d'une revendication est découplé du délai d'attente** — les deux échouent en sens **opposés** : attendre trop peu coûte un calcul inutile, juger périmée une revendication _vivante_ fait calculer deux workers à la fois, soit la rafale même. Une valeur unique était donc fausse, et un délai court rendait tout verrou instantanément périmé. La péremption vaut désormais `max(délai, 30 s)`.
- **Le délai par défaut est dérivé du budget de santé du conteneur, pas choisi au ressenti** — les attendeurs bloquent _dans_ le lifespan, donc avant qu'uvicorn ne serve. Le healthcheck tolère `start_period 60 s + 3 × 30 s` = 150 s, et un démarrage normal en prod prend déjà **~90 s** : il reste ~60 s de budget d'attente. Le défaut est **40 s**, soit ~3× les 14 s qu'un catalogue complet prend réellement, avec 20 s de marge. Un premier réglage à 90 s aurait mis le conteneur en `unhealthy` sur un démarrage.

### Fixed

- **Sur un volume neuf, la coordination attendait 90 s puis embarquait quand même** — quand le répertoire du cache n'existe pas encore, `os.open` sur le verrou lève `FileNotFoundError`, et le code y voyait « un pair est occupé ». Sur le cas de premier démarrage que cette correction existe précisément pour traiter, elle aurait donc été **pire que le défaut**. Trois issues sont maintenant distinguées là où il n'y en avait que deux : « je la tiens », « un autre la tient », « je ne peux pas la créer » — seule celle du milieu mérite qu'on attende.
- **Un emplacement impossible ne fait plus sonder dans le vide** — montage en lecture seule ou permissions refusées : on calcule immédiatement, au lieu d'attendre un pair qui n'apparaîtra jamais.
- **Un cache écrit entre la dernière lecture et l'acquisition est utilisé, pas recalculé** — un pair peut finir et relâcher pile dans cette fenêtre, précisément l'instant où plusieurs workers sondent. On y dépensait un embedding complet pour un résultat déjà sur disque.

### Tests

- **28 tests sur le module**, dont ceux qui pinnent les défauts ci-dessus : volume neuf revendiqué **immédiatement** (`slept == []`), emplacement en lecture seule qui dégrade sans sonder, revendication périmée volée **et** revendication vivante jamais volée, relais après échec du fournisseur, double vérification après acquisition, délai zéro qui rétablit le comportement d'avant.
- **La fatalité de l'échec du sélecteur est conservée, et la raison est écrite dans le code** — la rendre non fatale était la première idée, réfutée par les compteurs de production : 4 initialisations réussies, 2 échecs, 4 workers finalement sains. Un worker qui survit sans sélecteur saute le scoring sémantique **pour le reste de sa vie** (`router_node_v3` garde sur `is_initialized()`, et tous les outils du domaine partent au LLM sans classement), alors qu'un worker qui quitte revient pleinement fonctionnel. Mourir est la meilleure dégradation ici.
- **Une limite documentée plutôt que masquée** — la péremption compare une `mtime`, donc une horloge murale, sans source monotone possible. Un saut NTP vers l'avant peut faire passer une revendication vivante pour abandonnée. Ce qui rend l'heuristique acceptable est écrit dans le module : ses **deux** erreurs sont bornées par le comportement d'avant, donc aucune n'invente un mode de défaillance — elles renoncent à l'optimisation pour un démarrage.

## [1.25.26] - 2026-07-27

**Chaque démarrage payait quatre fois le même travail, et la trace disait « erreur de base de données ».** L'API tourne avec quatre workers uvicorn, et rien ne les coordonnait au démarrage : chacun réembarquait les **713 textes du catalogue d'outils** puis les **269 entrées de la FAQ**, soit **3 928 contenus en 72 requêtes** par démarrage — pour une charge dont l'empreinte n'avait pas changé depuis quatre jours. Le refus de quota qui s'ensuivait tombait **à +18 s** du démarrage, sur **11 démarrages sur 11** tracés en quatre jours, et se retrouvait journalisé sous la couche base de données : **69 refus de quota classés en `database_session_error`** avec pile complète, envoyant quiconque instruisait le problème dans la mauvaise couche. Pendant ce temps, l'entrelacement des quatre réindexations laissait **807 fragments pour 269 contenus distincts** — trois copies de chaque réponse — et comme la récupération trie par score puis tronque à cinq, la FAQ que LIA consulte sur elle-même ne rendait plus que **deux réponses distinctes sur cinq**. Aucun test, aucune métrique, aucun journal ne le disait. Après correction : **269 contenus en 10 requêtes** par démarrage, et le corpus dupliqué se répare au démarrage suivant. Tests backend **16 057 → 16 146** (853 fichiers), frontend **3 471 → 3 473**.

### Added

- **Un seul écrivain pour l'indexation de la connaissance système** ([ADR-162](docs/architecture/ADR-162-System-Knowledge-Indexation-Single-Writer.md)) — la ligne du space est revendiquée par `FOR UPDATE SKIP LOCKED` : exactement un worker indexe, les autres déclinent **immédiatement** plutôt que d'attendre, ce qui aurait ajouté les vingt secondes d'embedding à chaque démarrage. `populate_existing` n'est pas décoratif : l'appelant a déjà lu cette ligne, et sans lui SQLAlchemy rend son instance mémorisée avec l'empreinte périmée — le perdant d'une course réindexerait par-dessus le travail du gagnant.
- **Le cache d'embeddings d'outils survit au déploiement** — il vivait dans la couche inscriptible du conteneur, que `--force-recreate` détruit : **108 défauts de cache pour zéro succès sur 27 démarrages**. Il repose désormais sur un volume nommé, avec un chemin réglable ancré sur la racine applicative (le défaut résout sur le point de montage, donc rien à configurer) et une écriture par fichier temporaire puis renommage atomique — quatre workers écrivant quinze mégaoctets sur le même chemin, persister sans atomicité aurait transformé un dégât invisible en corruption durable.
- **Le corpus est compté, pas seulement haché** — une empreinte concordante ne suffit pas, et le supposer aurait figé le dégât : la production portait l'empreinte **correcte** sur 807 fragments. La péremption exige désormais l'empreinte **et** un fragment par entrée **et** un seul document (0,74 ms mesurés sur le Raspberry Pi), ce qui fait du prochain démarrage la réparation. Couvre aussi l'inverse — une insertion morte à mi-course, tout aussi invisible à une empreinte.
- **Une alerte quand la base de connaissance cesse d'être mise à jour** — `SystemKnowledgeIndexationFailing` rejoint le socle d'alerting ([ADR-119](docs/architecture/ADR-119-Alerting-Reactivation-Minimal-Core.md)) avec son runbook. Deux échecs en six heures, pas un : un refus transitoire se soigne au démarrage suivant, et le corpus qui sert entre-temps est le précédent, intact.
- **Le sort du cache d'outils est mesuré** — `tool_embeddings_cache_total{result}` rend visible sur un tableau de bord la classe de défaut qui s'était cachée vingt-sept démarrages durant, faute de pouvoir la lire autrement qu'en fouillant les journaux.

### Changed

- **On embarque avant de détruire** — les vecteurs sont calculés avant la première instruction destructrice. Un refus de quota ne coûte alors rien : aucune ligne supprimée, aucun verrou tenu pendant un appel réseau, le corpus précédent toujours servi. L'échange qui suit est une transaction inférieure à la seconde. Auparavant l'embedding tournait _dans_ la transaction destructrice, et seul un retour arrière sauvait le corpus.
- **Un retry borné là où attendre est acceptable** — le SDK Gemini construit son client sans options de retry, ce qui sélectionne sa stratégie « ne jamais réessayer » : un seul refus transitoire coûtait un cycle de péremption complet. Le retry est borné en tentatives **et** en budget de temps partagé, classé sur le code de statut porté par la chaîne des causes — jamais sur le texte d'un message, c'est ainsi qu'un changement de formulation chez un fournisseur transforme silencieusement un retry en échec définitif. Il ne vit que sur ce chemin de démarrage : un utilisateur qui attend une réponse ne doit pas patienter le temps d'une fenêtre de quota.
- **Les chiffres de la landing corrigés vers le bas** — la tuile « outils » affiche un nombre **exact**, sans « + » : annoncer 85 pour 82 réellement enregistrés était une sur-affirmation. Vérifié contre le runtime et non contre un grep seul (328 enregistrements pour quatre workers = 82). Au passage, le décompte de documentation se contredisait _dans le même fichier_ (280+ dans le tableau, 380+ en pied) alors que la mesure donne 405, et le décompte d'ADR sous-estimait à « 150+ ».

### Fixed

- **L'échec n'est plus classé sous la mauvaise couche** — l'exception s'échappait du contexte de session, qui journalisait `database_session_error` en ERREUR avec pile complète. Elle est désormais capturée _dans_ ce contexte : une ERREUR du domaine, un AVERTISSEMENT du démarrage, fin de l'histoire. Le garde-fou externe est conservé et testé — la FAQ système est optionnelle et ne doit jamais retenir un démarrage, y compris quand la session elle-même ne s'ouvre pas.
- **Le panneau d'administration annonçait une réindexation qui n'avait pas eu lieu** — l'interface ignore le message du serveur et compose son succès à partir du nombre de fragments : un corpus déjà à jour produisait donc « réindexé, 0 fragment ». La réponse porte maintenant l'issue de façon lisible par la machine, et une revendication refusée répond **409** au lieu de prétendre que tout est à jour. Trois messages distincts dans les six langues, là où il n'y en avait qu'un.
- **Une divergence de corpus n'est plus signalée cinq fois** — le rapport vivait dans le prédicat, appelé deux fois par indexation : à quatre workers, un seul événement produisait cinq avertissements identiques. Il est émis une fois, par le worker qui agit.
- **La course à la création n'est plus un échec** — sur une base neuve les quatre workers créent le space ; l'index unique partiel en laisse passer un, et les autres adoptent désormais sa ligne au lieu de journaliser une erreur. Le résultat est **relu** plutôt que déduit du code de statut : si le space n'existe toujours pas, l'échec était réel et remonte.
- **Une durée mesurée à l'horloge murale** — l'indexation observait sa durée dans un histogramme via `time.time()` : un ajustement d'horloge au démarrage, ce que fait un Raspberry Pi au réveil du réseau, y aurait enregistré une durée négative.

### Tests

- **La garde de propriété des volumes exige maintenant le `chown`, pas seulement le `mkdir`** — créer le point de montage ne suffit pas : `mkdir` dans un `RUN` s'exécute en `root`, Docker sème cette appartenance dans le volume, et c'est définitif. La garde vérifie qu'un `chown` vers l'utilisateur d'exécution suit la création, et distingue `COPY --chown=` — qui donne les droits de fichiers copiés et ne dit rien d'un répertoire hôte de volume. **Six falsifications** l'accompagnent, dont la reproduction exacte de la régression de production.
- **La concurrence est prouvée contre PostgreSQL réel** — deux puis quatre indexations simultanées ne laissent qu'un corpus, la revendication décline sans attendre, et le verrou est bien relâché par la validation. Une **falsification** retire la revendication et montre la duplication revenir. Un test reproduit l'état de production — corpus dupliqué sous une empreinte correcte — et prouve qu'un démarrage le répare.
- **Les sessions de test portent la configuration de l'application** — `expire_on_commit=False` et `autoflush=False`, là où SQLAlchemy vaut `True` pour les deux. La différence n'est pas cosmétique : c'est _pourquoi_ la revendication a besoin de `populate_existing`, et un test sur les réglages par défaut peut passer sur un comportement que la production n'a jamais.
- **Le step de démarrage avait zéro test** — neuf le couvrent : chaque issue journalisée une fois au bon niveau, la session quittée proprement après un échec, et le démarrage jamais bloqué, y compris quand la session ne s'ouvre pas ou que le retour arrière échoue lui-même.
- **L'atomicité de l'écriture du cache est vérifiée par son état observable** — jusqu'au renommage, le fichier visible est encore le précédent ; un échec d'écriture préserve le cache utilisable et ne laisse aucun résidu.

## [1.25.25] - 2026-07-27

**Six fois de suite, « crée une image réaliste d'un chat » n'a produit aucune image.** Quatre défauts indépendants se superposaient, chacun suffisant à faire échouer la demande à lui seul, et aucun ne laissait de trace lisible : l'analyseur écrivait la _chaîne_ `"null"` là où il voulait dire « aucune compétence », un plan vide jetait l'outil `generate_image` que le routeur venait pourtant d'élire avec un score de **1,0**, la qualité `high` demandait **138,3 s** mesurées sous un plafond générique de 120 s — donc impossible à n'importe quel réglage — et le volume des compétences appartenait à `root` depuis le 13 mars, ce qui cassait **tous** les imports, y compris depuis les réglages. Pendant ce temps, la même réponse s'affichait sur ordinateur et restait bloquée sur « Génération de la réponse… » sur téléphone, indéfiniment, alors que le serveur l'avait terminée et enregistrée. Et les quatorze compétences livrées affichaient une vignette vide : le code fonctionnait, les images n'avaient jamais été produites. Tests backend **15 954 → 16 057** (849 fichiers), frontend **3 460 → 3 471**.

### Added

- **Les compétences ont enfin leur aperçu** — les quatorze vignettes sont **générées**, pas dessinées à la main : un script versionné produit une esquisse de ce que la compétence _fabrique_ (une grille de mois, un motif QR, des cartes de prévisions), dans la palette que ses propres scripts rendent déjà. Géométrie pure, sans police, donc identique d'une machine à l'autre. Le nom de la compétence n'y figure pas : la fenêtre l'affiche juste au-dessus.
- **Un chien de garde sur le silence d'un flux** ([ADR-161](docs/architecture/ADR-161-SSE-Stall-Watchdog.md)) — la lecture d'un flux SSE n'avait aucune limite de temps. Quand le système d'exploitation d'un téléphone gèle un onglet, la promesse de lecture n'est ni tenue ni rompue : l'interface restait « en train de répondre » pour toujours, et le garde censé protéger un flux vivant verrouillait précisément la reprise qui l'aurait sauvée. Le budget vaut **six battements de cœur manqués** ; les minuteurs gelant avec l'onglet, il expire au réveil — exactement le moment utile.
- **Les détections de compétence retenues sont mesurées** — les compteurs ne décrivaient que ce qui était écarté. Le déclencheur du détournement n'a **jamais été reproduit** (0 fois sur 104 sondes contre 4 tours sur 6 en production, à état identique) : les détections conservées sont le seul signal qui permettra de l'instruire s'il revient. Les noms de compétences importées n'entrent pas dans l'étiquette — ce sont des noms libres, et une étiquette libre fait exploser le nombre de séries.

### Changed

- **Une compétence à script n'efface plus le plan du domaine, elle s'y ajoute** ([ADR-160](docs/architecture/ADR-160-Skill-Detection-Hygiene-And-Native-Plan-Cumulation.md)) — le plan vide était un choix délibéré : il évitait les appels d'API « parasites » qu'un planificateur déduit du domaine. Le prix réel s'est vu en production, où il a coûté la fonctionnalité demandée. Le planificateur produit désormais les étapes natives **et** la compétence s'exécute — c'est déjà ainsi que le nœud de réponse l'active, indépendamment du plan. Réversible par une variable d'environnement si les étapes natives s'avèrent être du bruit.
- **La famille image obtient son propre plafond** — plancher **180 s**, plafond **300 s**. Les autres familles à forte latence (navigateur, sous-agent, ReAct MCP) avaient déjà le leur ; l'image restait sous le plafond générique. Mesuré sur `gpt-image-2` : `medium 1024x1536` prend 47,2 s, `high 1024x1536` en prend 138,3 — au-dessus du plafond lui-même, ce qui rendait la haute qualité inatteignable quelle que soit la valeur du plancher.

### Fixed

- **Aucune compétence ne pouvait être importée depuis le 13 mars.** Le point de montage `data/skills/users` appartenait à `root` alors que l'application tourne sans privilèges. Docker ne transmet les droits de l'image à un volume que si le chemin **existe déjà** dans cette image ; celui-ci est ignoré par Git, donc absent, donc fabriqué par Docker en `root` — et une fois créé, un volume garde ce propriétaire à vie. Les deux gestes étaient nécessaires : corriger le volume existant _et_ créer le répertoire dans l'image pour les suivants. Le seul symptôme visible était une erreur d'outil au milieu d'une réponse.
- **L'analyseur écrivait « null » au lieu de ne rien écrire** — l'instruction dit, en prose, de laisser le champ nul, et la sortie structurée n'est pas stricte : le modèle écrivait les quatre caractères, qu'un test de vérité lit comme une compétence détectée. Mesuré sur **104 sondes** : entre 84 % et 100 % des analyses d'une simple demande d'image. La normalisation se fait désormais à l'entrée du parsing, une fois, plutôt qu'à chaque lecture — ce qui supprime au passage un journal affirmant avoir effacé une compétence jamais détectée.
- **Un nom de compétence inexistant pilotait le tour entier** — le routeur donne à ce champ une priorité absolue. En juillet, un nom halluciné n'avait atterri sur le bon chemin que **par accident**, parce qu'aucune compétence ne le portait. L'existence est maintenant vérifiée dans la portée du compte, avec repli permissif tant que le catalogue n'est pas chargé : un catalogue vide signifie « au démarrage », pas « aucune compétence ».
- **Une réponse terminée restait invisible sur téléphone** — le serveur enregistrait bien la réponse, mais le client ne quittait jamais l'état « en cours », donc ne tentait jamais de se rattacher au tour resté vivant en arrière-plan. Sur toute la période observée, **aucun** appel de reprise n'a été émis.

### Tests

- **Chaque garde a été falsifiée avant d'être conservée** : vignette retirée puis vignette modifiée d'un seul octet, volume absent du fichier de construction, et — pour la plus importante — la régression exacte que le cumul redoute, injectée dans le nœud de réponse pour vérifier qu'un seul test tombe.
- **Trois nouvelles gardes** : tout volume nommé doit être créé par l'image qui le monte, toute compétence doit livrer son aperçu et celui-ci doit correspondre à son générateur, et le contrat de sortie de l'analyseur est vérifié à la frontière.
- **Le plafond de taille de fichier a mordu** pendant le chantier : plutôt que de le relever, le contrat de sortie de l'analyseur est devenu un module à part et le plafond est **descendu** de 1 142 à 1 020.

## [1.25.24] - 2026-07-27

**Le produit était utilisable, mais pas toujours trouvable.** Sur un téléphone, sous 768 px, la barre de navigation disparaissait et rien ne la remplaçait : depuis le chat, les réglages et l'aide n'étaient atteignables qu'en tapant une URL. La checklist de démarrage pointait **six de ses sept entrées** vers la page de réglages nue — « choisir une personnalité » déposait l'utilisateur en haut de trente accordéons fermés. Sept des neuf cartes de l'accueil **ne rendent rien du tout** quand leur source n'est pas configurée : un compte neuf découvrait deux cartes vides et sept trous invisibles. Les quotas n'avertissaient jamais : rien, rien, rien, puis un mur, en pleine tâche. Les images générées étaient supprimées au bout d'un délai sans jamais le dire. Un tour en échec était un cul-de-sac : il fallait retrouver sa question et la retaper. Et en allemand à 768 px, le bouton de déconnexion se trouvait **235 px hors de l'écran**, rogné par un `overflow-x: hidden` qui faisait mesurer zéro à toutes les gardes de débordement existantes. Cette version est cette passe-là. Tests backend **15 877 → 15 954** (842 fichiers), frontend **2 832 → 3 460**, **97/97** parcours navigateur hermétiques, plafond de complexité backend **abaissé** (89 → 87).

### Added

- **Le logo devient la navigation sur téléphone** — sous `md`, il ouvre un menu vers les quatre destinations du bandeau au lieu d'être un lien « accueil » sans issue. Deux éléments exclusifs plutôt qu'un élément qui change de rôle : un lien à une largeur et un bouton à une autre ne peut annoncer ni l'un ni l'autre à une technologie d'assistance. La cible tactile passe à 44 px, la barre n'ayant pas la largeur d'un menu hamburger supplémentaire.
- **Dix-sept sections de réglages adressables** (`?section=…`) — la table est la source unique des cibles, et chaque entrée est vérifiée contre le composant qui la déclare : le fichier doit exister, déclarer la valeur d'accordéon annoncée, **et être rendu dans l'onglet que la table revendique**. Auparavant deux jetons seulement étaient compris.
- **Les cartes non configurées sont nommées** — une seule ligne discrète, chaque nom de carte pointant vers la section qui la configure. Jamais sept cartes promotionnelles : sur mobile la grille est déjà tout l'écran. Les cartes que l'utilisateur a lui-même masquées ne sont jamais mentionnées.
- **Avertissement de quota avant le mur** — le backend calculait déjà un état gradué (`warning` à 80 %, `critical` à 95 %) et six dimensions ; le chat n'en lisait que deux champs booléens. La dimension annoncée est la **contraignante** (le pourcentage le plus haut, puisque n'importe laquelle bloque le compte), et la date de réinitialisation n'est promise que pour une limite de cycle — une limite absolue ne se réinitialise pas.
- **Les images générées annoncent leur échéance** — la date vient du backend, jamais d'un « 24 h » écrit en dur : le TTL est configurable, une constante dans l'interface finirait par mentir. Un message sans échéance (historique antérieur) ne dit rien plutôt que de deviner.
- **Rejouer un tour en échec** — la bulle d'erreur épingle la question qui l'a produite, et le bouton rejoue **exactement** celle-là, pas le dernier texte utilisateur au moment du clic (une notification proactive peut s'être glissée entre les deux).
- **375 exemples de FAQ cliquables** dans les 6 langues — les phrases à puce déjà rédigées deviennent des boutons qui préremplissent la zone de saisie. Le HTML environnant garde son chemin de rendu, chaque commande devient un vrai `<button>` dont le texte est échappé par React : la posture XSS est strictement inchangée.
- **Trois amorces sur un chat vide**, choisies parce qu'elles aboutissent sur n'importe quel compte — sans connecteur, sans mémoire, sans historique.
- **Suivi des appels téléphoniques** — l'endpoint `GET /telephony/calls` existait depuis la livraison du domaine et n'était consommé par rien. Une section dédiée dans les réglages, et un bandeau pendant l'appel : le produit devenait totalement muet entre la confirmation et le compte rendu.
- **Neuf confirmations natives remplacées** — les actions les plus irréversibles du produit (supprimer un utilisateur, l'**effacer**, réécrire une table tarifaire) passaient par `window.confirm()`, qui ignore le thème, prend ses libellés au système d'exploitation et bloque le fil principal. La fermeture par Échap ou par clic extérieur vaut refus, jamais consentement.
- **Doctrine de visibilité mobile, rendue opposable** — une table déclare, pour chaque surface conditionnée à la largeur, si elle est bloquante, substituée ou réservée au bureau, avec sa raison écrite. Les tests la tiennent contre le code : chaque emplacement doit exister, porter la variante Tailwind du seuil annoncé, et une surface coûteuse doit être **montée conditionnellement**, pas simplement masquée en CSS — `display:none` monte quand même le composant, qui continue de requêter et de consommer la batterie.
- **Règle de priorité unique pour la bande sous le fil de conversation** — mesuré : une carte d'approbation en attente plus des suggestions de suivi occupaient 443 px d'une coquille de 716 px. Mais la hauteur n'est que le symptôme : LIA ne peut pas demander une confirmation _et_ proposer trois questions sans rapport au-dessus. L'arbitrage porte sur le sens, jamais sur des pixels — supprimer un bloc parce que la fenêtre est courte finirait par masquer un mur de quota sans explication.
- **Cliquet sur la troncature des traductions** ([ADR-158](docs/architecture/ADR-158-Locale-Content-Truncation-Ratchet.md)) — la parité de clés ne mesure pas ce qu'il y a derrière la clé : une locale qui remplace une réponse de 500 caractères par un résumé de 150 passait indéfiniment.
- **Atteignabilité des quatre thèmes du journal** ([ADR-159](docs/architecture/ADR-159-Journal-Theme-Reachability.md)) — deux des quatre thèmes n'avaient **aucune** entrée en base, en dev comme en production.

### Changed

- **Le validateur sémantique ne demande plus deux fois la même confirmation.** Il s'arrêtait sur « action irréversible » pour des actions qui portent déjà leur propre confirmation en aval — les dix-neuf types de brouillon montrent un aperçu et attendent un accord explicite avant d'exécuter. L'utilisateur devait **insister** pour être obéi. Le jugement porte désormais sur la structure du plan, jamais sur le caractère consécutif ressenti de l'action.
- **Le titre par défaut d'une conversation est localisé** dans les 6 langues, chacune avec sa convention de date (`26/07` en France, `07/26` aux États-Unis, `26.07` en Allemagne, `年月日` en Chine) — une seule forme se lirait comme une date fausse dans la moitié des langues.
- **La coquille du chat est dimensionnée sur la fenêtre dynamique** (`dvh`) — `100vh` est la hauteur qu'aurait la page si la barre d'adresse du navigateur était rétractée, c'est-à-dire pas l'état dans lequel une page se charge sur mobile : le bas du conteneur, donc la zone de saisie, se trouvait sous la ligne de flottaison. Un test interdit désormais toute contrainte de hauteur en `vh` seul.
- **Les avis de connecteur se condensent** quand ils partagent la même action — un jeton Google expiré invalide Gmail, Agenda et Drive d'un coup, soit trois lignes ambrées. Des actions différentes restent listées en entier : aucune phrase unique ne serait vraie des deux.
- **`brace-expansion` corrigé par un patch d'interopérabilité** ([ADR-157](docs/architecture/ADR-157-Patched-Brace-Expansion.md)) plutôt que par une exemption d'audit — l'alerte haute n'avait aucune version corrigée compatible avec la chaîne de linters.
- **Neuf modules frontend orphelins supprimés** ([ADR-156](docs/architecture/ADR-156-Removal-Of-Nine-Orphan-Frontend-Modules.md)) — 1 561 lignes de code et 592 de tests, dont **deux composants déjà cassés** : ils interrogeaient des clés i18n absentes des six locales, donc montés ils auraient affiché des identifiants bruts.
- **L'historique d'appels n'est plus rendu deux fois** — la nouvelle section et l'ancien encart du bloc connecteur affichaient les mêmes lignes sur la même page, et demandaient deux fois la même requête.

### Fixed

- **Un appel téléphonique refusé bloquait tous les suivants pendant quinze minutes.** Le fournisseur répond **HTTP 200 même lorsqu'il refuse de composer** (numéro émetteur non vérifié, crédit épuisé) : le refus est dans le corps, sous `success: false`. Ignoré, il laissait une ligne en `DIALING` que rien ne terminerait jamais — et, sans identifiant de conversation, une ligne que la sonde d'auto-réparation ne peut même pas interroger. Le message rendu distingue désormais le transitoire (« réessaie dans un instant ») du refus de configuration, où réessayer ne changerait rien.
- **La déconnexion était hors de l'écran sur tablette.** Entre 768 px et 1024 px le bandeau montrait simultanément la navigation et les libellés des contrôles ; en allemand, le bouton de déconnexion débordait de 235 px. Rien ne l'avait vu parce que `html { overflow-x: hidden }` rogne le débordement au lieu de produire un défilement : la garde de reflow existante mesurait **zéro sur 108 échantillons**. La nouvelle garde compare chaque contrôle à la fenêtre, par largeur et par langue.
- **La zone de saisie n'était pas alignée** — un `<textarea>` est un élément _inline_ : sa ligne de base ajoutait 6 px sous lui, si bien que son conteneur mesurait 54 px quand les trois contrôles voisins en faisaient 48. Mesuré en navigateur, pas assuré par une classe CSS.
- **L'indicateur d'espaces RAG était collé au bord droit** et pouvait recouvrir le badge d'écoute active ; les deux partagent désormais une rangée centrée, ce qui rend le chevauchement impossible par construction. Sous 640 px son nom accessible se réduisait au chiffre : un lecteur d'écran annonçait « 2 ».
- **Le titre de conversation restait français** pour tout le monde : la table localisée et le service étaient corrects, mais **un seul des quatre appelants** transmettait la langue — et pas celui du chat. Une garde AST refuse désormais tout appelant qui n'énonce pas la sienne.
- **Le second type de métadonnées de fin de flux avait pris du retard** — la même forme était réécrite à la main en six endroits, et la copie portée par l'action SSE ignorait le champ d'échéance ajouté ailleurs. Une déclaration unique remplace les six.
- **Le type des jetons de réglages ne protégeait rien** : déclaré sur un `Record<string, …>`, `keyof` s'effondrait en `string`, si bien qu'un lien profond mal orthographié compilait proprement jusqu'au lien mort. Corrigé par `satisfies` et une garde de type — le compilateur a immédiatement trouvé une erreur réelle dans les tests existants.
- **Une constante de planificateur orpheline** subsistait d'un contournement retiré, un test reconstruisait une table par expression régulière sur le code source au lieu de l'importer, et un commentaire justifiait une écriture par un comportement de session que le projet n'a pas.
- **Deux régressions de cliquet dans le travail livré** : un fichier passait de 1 051 à 1 061 SLOC pour un plafond de 1 052, et `initiate_call` franchissait le seuil de complexité. Corrigées par extraction — un sérialiseur partagé et l'interprétation de la réponse du fournisseur — jamais en relevant un plafond.
- **Quatre renvois de documentation** pointaient encore vers des modules supprimés.

### Tests

- **97 parcours navigateur hermétiques verts** sur un build de production servi dans le conteneur, serveur vérifié vivant avant et après la suite. Onze nouveaux fichiers e2e : accessibilité du bandeau par largeur **et par langue**, navigation mobile, substituts mobiles, liens profonds de réglages, avertissement de quota, alignement de la zone de saisie mesuré en pixels.
- **Frontend 2 832 → 3 460 tests** (296 fichiers), backend **15 877 → 15 954** (842 fichiers).
- **Une garde de placement des clés i18n** — la parité compare des ensembles de clés et reste aveugle à un bloc inséré dans la mauvaise section de la même façon dans les six locales : la parité passe pendant que l'écran affiche `usage_limits.warning.warning`. C'est arrivé pendant ce chantier, et seule une exécution en navigateur l'a montré.
- Chaque garde ajoutée a été **falsifiée** avant d'être conservée : on casse volontairement ce qu'elle protège et on vérifie qu'elle rougit.

## [1.25.23] - 2026-07-26

**Les tests qui ne tournaient pas — et les défauts qu'ils cachaient.** Dix fichiers de test portaient un `skipif` sur `OPENAI_API_KEY` au niveau module : **219 tests n'avaient jamais été exécutés**, sur le classifieur HITL, la reprise après approbation, l'exécuteur de brouillons et la construction du graphe. Un test sauté est vert, rien ne le signale. Réactivés, **142 revenaient au rouge** (125 échecs, 17 erreurs) contre 92 verts — écrits contre une API migrée depuis. Les réparer a exhumé des défauts bien réels : la voix coupait **tous les nombres en deux** (« il fait trois. » puis, dans un autre extrait audio, « cinq degrés »), un rappel était **perdu définitivement** si l'utilisateur atteignait sa limite d'usage à la minute du déclenchement, un utilisateur chinois recevait ses notifications en anglais, et la valeur qu'un utilisateur venait de corriger dans une confirmation disparaissait de la conversation pour tous les outils sauf un. Le job CI « agents » passe de **978 à 1 158 tests exécutés, zéro sauté**. Tests backend **15 331 → 15 877** (837 fichiers), frontend **2 729 → 2 832**, plancher de couverture **61 % → 62 %**.

### Added

- **Taxonomie d'action HITL** ([ADR-153](docs/architecture/ADR-153-HITL-Action-Taxonomy.md)) — le type annoncé au classifieur est désormais dérivé du **verbe** du nom d'outil, avec un repli par sous-chaîne ordonné destructif d'abord et sans aucun nom de domaine. Une assertion au démarrage refuse de booter si un type d'action peut être annoncé sans bloc d'exemples derrière lui : un repli silencieux sur le bloc générique est exactement ainsi qu'un classifieur cesse d'être contextuel sans que personne ne le voie.
- **`HitlResumeMessage` — les avis de reprise dans les 6 langues.** Trois phrases françaises codées en dur étaient diffusées **mot pour mot** à l'utilisateur lorsqu'un brouillon lui était représenté pour précision. La localisation est placée là où la langue est connue : le classifieur n'invente plus de question, il ne connaît pas la langue de l'utilisateur.
- **Points cardinaux du vent traduits** — une source unique renvoyant un code, résolu en 6 langues côté serveur comme côté client. Les deux tables qui coexistaient épelaient l'une en anglais, l'autre en français : la même mesure se lisait différemment selon la carte.
- **Trois blocs d'exemples few-shot** (`transfert`, `réponse`, `modification`) — une réponse à un e-mail n'a pas de destinataire, et les exemples d'envoi poussaient le modèle à proposer un paramètre que l'outil ne peut pas accepter.
- **Cinq gardes exécutables** : aucun module de test ne peut se désactiver en silence sur une clé de provider absente ([ADR-155](docs/architecture/ADR-155-No-Env-Skipped-Test-Suite.md)) ; aucun appel `fetch` brut ne peut réapparaître hors d'une liste justifiée ; aucun test ne peut fabriquer la forme d'erreur d'une bibliothèque que le projet n'utilise pas ; la partition des domaines filtrables en opération de série est vérifiée au démarrage ; et une section de FAQ ne peut plus déclarer un nombre de questions différent de celles réellement écrites — la boucle de rendu est bornée par ce compteur, si bien qu'une question ajoutée sans lui **ne s'affiche jamais**, dans les 6 langues et sans qu'aucun contrôle existant ne le voie.

### Changed

- **Frontière de phrase pour la synthèse vocale** ([ADR-154](docs/architecture/ADR-154-TTS-Sentence-Boundaries.md)) — un délimiteur ne ferme une phrase qu'en fin d'entrée ou suivi d'une espace. Un point collé au caractère suivant appartient au token, pas à la prose. Les deux découpeurs du pipeline vocal sont désormais épinglés par une table de cas partagée et par un test qui exige leur accord.
- **Les messages d'erreur du serveur atteignent l'utilisateur.** Vingt-et-un endroits lisaient la réponse sous la forme d'une bibliothèque que le projet n'utilise pas : tout détail renvoyé par l'API était remplacé par un texte générique. Un point de passage unique lit désormais l'enveloppe FastAPI sous ses trois formes, y compris la liste d'erreurs de validation qui s'affichait « [object Object] ».
- **`ProactiveMessages.notification_title` normalise la langue lui-même** — les appelants détiennent des locales brutes de toutes orthographes ; la sûreté ne doit pas dépendre de leur discipline.
- **Plancher de couverture backend porté à 62 %** (mesuré 64,1 %), les seuils frontend maintenus faute des deux points de marge exigés par la doctrine.
- **Code mort supprimé** : trois hooks frontend sans consommateur ([ADR-152](docs/architecture/ADR-152-Removal-Of-Orphan-Frontend-Hooks.md), 861 lignes), un filtre HITL dont le prédicat était `return False` en dur et dont l'option n'était passée par aucun appelant, et une table de 37 expressions régulières françaises qu'aucun chemin n'atteignait plus.

### Fixed

- **La voix coupait tous les nombres en deux.** Les deux découpeurs de phrases traitaient tout point comme une fin de phrase : « Il fait 3.5 degrés » était prononcé « il fait trois. » puis, **dans un extrait audio distinct**, « cinq degrés ». Idem pour les prix, les numéros de version et les URL. Sur le chemin progressif, le tampon grandit caractère par caractère : `"3."` y est un état transitoire parfaitement normal, et parler dessus revient à répondre avant d'avoir fini de lire.
- **Un rappel pouvait être perdu définitivement.** La sélection des rappels échus prend un bail en basculant la ligne en `PROCESSING`, et la requête suivante ne regarde que les `PENDING`. Deux sorties de boucle ne relâchaient pas ce bail : un utilisateur qui atteignait sa limite d'usage à la minute du déclenchement ne recevait jamais son rappel, sans erreur ni trace.
- **Un utilisateur chinois recevait ses notifications de rappel en anglais** — la table était indexée sur `zh` alors que la langue enregistrée est `zh-CN`. C'est la troisième occurrence de ce défaut ; la table centrale créée pour l'éliminer normalise désormais elle-même.
- **La correction saisie dans une confirmation disparaissait de la conversation.** La reformulation d'une modification était câblée sur un seul nom d'outil ; pour tous les autres elle produisait « exécute X avec les paramètres modifiés » — or ce message **remplace le tour de l'utilisateur** dans l'état, donc la valeur qu'il venait de donner n'existait plus.
- **Une suppression d'e-mail était annoncée au classifieur comme un envoi** — le nom de domaine « email » siégeait dans la branche du verbe « send », testée avant celle de « delete ». La règle de sûreté du prompt (sur une suppression, ne jamais approuver un doute) ne pouvait donc pas s'appliquer. Les outils de lecture d'e-mails étaient annoncés comme des envois pour la même raison.
- **Une réponse 5xx sans corps était traitée comme un succès** dans les deux clients HTTP : le retour anticipé sur corps vide précédait le contrôle de statut. L'appelant lisait un champ sur rien, ou affichait « aucune donnée » pour une panne.
- **Le panneau de personnalité ne survivait pas à une session expirée** — huit fonctions contournaient le client HTTP commun, donc ni redirection sur 401, ni délai d'expiration, et quatre lectures divergentes du message d'erreur.
- **Une confirmation de suppression de libellé ne nommait pas ce qu'elle supprimait** — le gabarit traduit existait dans les 6 langues, mais l'échelle de conditions n'avait pas de branche pour ce type.
- **Le filtrage d'une opération en série pouvait vider le registre ou abandonner un plan déjà confirmé** — les domaines dont l'identifiant est composite (itinéraires, positions, météo) régénéraient des identifiants introuvables.
- **La latitude 0 et la longitude 0 étaient perdues** — l'équateur et le méridien de Greenwich passaient pour des coordonnées absentes, et l'itinéraire retombait sur l'adresse textuelle.
- **Le taux de change était relu en base à chaque calcul de coût** — donc à chaque appel de modèle. La méthode estampillait le cache sans jamais y écrire la valeur, derrière un nom, une docstring et une machinerie d'invalidation qui décrivaient tous les trois un cache.
- **Un cap « N/A » s'affichait comme un vent de nord**, et une date de fin d'événement transmise sous une forme inattendue faisait disparaître toute la section agenda du briefing.

### Tests

- **219 tests réactivés** ([ADR-155](docs/architecture/ADR-155-No-Env-Skipped-Test-Suite.md)). Dix fichiers se désactivaient sur l'absence de clé de provider ; huit ont reçu un harnais hermétique (store LangGraph en mémoire, registre d'agents doublé, session TCM neutralisée), deux qui appellent réellement un modèle deux fois par test sont désormais marqués `e2e` — leur exclusion est **lisible dans la commande CI** au lieu d'être un silence. La liste d'exemption de la garde ADR-155 est vide ; en contrepartie la liste F006 (« aucun test ne tourne dans zéro job ») passe de 11 à 49 entrées — la dette ne grandit pas, elle **devient visible** : un test sauté sur clé absente restait collecté et sélectionné, donc compté comme couvert.
- L'invariant que six de ces tests protégeaient — le routeur écrit sa décision dans l'historique de routage, jamais dans la conversation — tient à la valeur de retour d'**une** fonction : il est désormais prouvé au niveau du nœud, en quelques millisecondes, sans piloter le graphe entier contre un vrai modèle.
- Chaque défaut a été **prouvé avant d'être corrigé** : la classification annoncée pour les 96 outils réellement enregistrés, le rappel laissé en `PROCESSING`, les phrases prononcées caractère par caractère pour reproduire le tampon qui se termine sur un point.
- Deux tests épinglaient un bug plutôt qu'un contrat : l'un exigeait qu'un message d'exception brut parte dans un prompt, l'autre exigeait le rappel statique de métriques qui **doublait le comptage des jetons**. Corrigés vers l'invariant réel, avec la raison écrite.

## [1.25.22] - 2026-07-25

**Second security wave — and a counter-audit of the first.** Three controls announced in v1.25.20 turned out not to exist. The rate-limit alert lived in a rule file Prometheus does not load _and_ that `prepare_config.sh` regenerates from a template, so it could never fire and would have vanished at the next deploy. The deploy's permission hardening ended in a bare `echo PERMS_HARDENED` that runs whether or not a single `chmod` succeeded — a check that could not fail. And the global rate limit was bypassable by prefixing any request with `/health`. Each is now real, each is verified rather than announced, and each carries an executable guard so the class cannot return. The wave also closed defects the audit never listed: an IDOR on push-token revocation, an HSTS header the API emitted with `includeSubDomains; preload` against the project's own written policy, an email address that escaped the PII filter whenever it appeared in free text, and the frontend published on every network interface while the other fifteen ports were loopback-only. Backend tests **15,031 → 15,331**.

### Added

- **`GlobalRateLimitDegraded` alert, in the file Prometheus actually loads** (SEC-016) — the vital core goes 13 → 14. Threshold `ALERT_CORE_RATE_LIMIT_DEGRADED_RPS` (0.01 req/s over 5 minutes, same in every environment), a linked runbook, and two promtool cases: one proving it fires under a real outage, one proving a single Redis hiccup does _not_ — which is what buys the threshold over a naive `> 0`.
- **Three executable guards closing the classes this wave exposed** — `test_alerts_core_guard.py` (the committed rule file must be its template's production render, every alert must link a runbook that exists and own a promtool case, the three threshold sets must declare the same keys); `test_compose_secret_scope_guard.py` (no service takes the full `.env` without a written reason, the web container receives no credential, every published port binds to loopback); and a deploy-driver case proving the hardening step refuses to continue on modes it did not obtain.
- **`navigateToAuthorizationUrl`** (SEC-002) — a single guarded entry point for the eight places that hand an API-supplied URL to `window.location`. A `javascript:` URL there does not navigate, it executes in the LIA origin. Defence in depth: the backend already validates MCP authorization endpoints, but the guard now protects the primitive rather than depending on every current and future endpoint remembering to.
- **`getExistingFcmToken`** — returns this device's push token without ever prompting, so logout can revoke it. `requestNotificationPermission` could not serve: it would pop a permission dialog at the exact moment someone signs out.
- **Frontend SBOM** (SEC-021) — the missing half of the inventory, built from `pnpm-lock.yaml` with the Trivy already in the pipeline (545 components, CycloneDX 1.7). Half an inventory answers "are we affected?" with "for Python, yes".
- Settings `TELEGRAM_UPDATE_DEDUP_TTL_SECONDS` (replay window for a Telegram `update_id`) and `HSTS_MAX_AGE` on the API side.

### Changed

- **HSTS is one ladder for both surfaces** (SEC-025) — the API hardcoded `max-age=31536000; includeSubDomains; preload` while the web app served a staged `max-age` from `HSTS_MAX_AGE`, and both directives are excluded by the project's own documented policy because they are near-irreversible. Both now read the same variable; the production step moves to 2592000 (one month). Removing the directives does not retract pins browsers already hold — those expire on their own — it stops adding more.
- **Trivy is blocking** (SEC-021) — it reported into the Security tab and passed unconditionally, which makes a scanner a dashboard rather than a gate. Measured at 0 findings across every severity before flipping it. What it reads (the pip manifest, pnpm without dev dependencies) stays narrower than what ships, deliberately: pip-audit already gates the lockfile and pnpm audit already covers dev dependencies.
- **The web container no longer receives the production secret set** (SEC-037) — `env_file: .env` handed a Next.js process the database credentials, the Fernet key, the JWT secret and every LLM and OAuth secret, none of which it uses. Replaced by the measured runtime need; the rule for extending it is that anything non-secret may be added freely, and a secret means the frontend is doing something it should ask the API to do.
- **Permission hardening is verified and blocking** (SEC-013) — the deploy reads the resulting modes back with `stat` and refuses to reach `docker compose up` when the production `.env` is not 0600 inside a 0700 directory. Continuing past a failed hardening means knowingly starting the platform with its secrets readable.

### Fixed

- **The deploy script accepted a `RemoteDir` that erases the server** (SEC-038) — the value is interpolated into `sudo rm -rf ~/$RemoteDir/*`, and its denylist accepted `..` (every home directory on the host), `.ssh`, `lia foo` (two targets) and a trailing newline. Replaced by an anchored single-segment allowlist, validated once before the first interpolation rather than next to the destructive command — the backup step at the previous stage ran unguarded.
- **The global rate limit could be bypassed by prefixing a request** (SEC-016) — exemptions matched with `startswith`, so `/healthz` or `/metrics-flood` crossed the API unlimited. They answer 404, but a 404 still costs a full middleware traversal at whatever rate the client can produce. Exemptions are now exact; the same latent pattern was removed from the body-size middleware before its list is ever filled.
- **Anyone could revoke someone else's push notifications** — `unregister_token` deleted by token value with no ownership filter, while its sibling `delete_token_by_id` had always scoped its delete to the user. Found while wiring the endpoint for logout.
- **Signing out left the device receiving the account's notifications** (SEC-039) — the push token outlived the session, so on a shared computer the next person read them on the lock screen. Revoked before `/auth/logout`, because that endpoint needs the session the logout is about to destroy.
- **The Telegram webhook read the request body before checking the secret** (SEC-024), and processed a redelivered update twice — the agent answered twice and a `/start <code>` consumed the OTP a second time. The header is verified first (it is a shared secret, not an HMAC over the payload), and each `update_id` is claimed in Redis, failing open if Redis is down.
- **Position and geolocation consent survived a logout** (SEC-034) — both keys are global, so on a shared browser profile account B read where account A was, and kept collecting position under a consent B never gave.
- **Chat images leaked the conversation URL** (SEC-027) — every image in the Markdown render path, and its JavaScript preload, now sends `referrerPolicy="no-referrer"`. Image sources are frequently third-party and often attacker-influenced.
- **An email address in free log text escaped the PII filter** (SEC-012) — the `event` field bypasses the full sanitizer to avoid mangling event names; the bypass now also pseudonymizes addresses, a shape no snake_case event name can contain.
- **The frontend was published on every network interface** (SEC-015) — reachable from the LAN without passing through Cloudflare, so without the WAF, the TLS termination or the access logs. It was the single exception among sixteen published ports.
- A Telegram payload that is valid JSON but not an object (`[]`, `null`, a number) raised inside the request handler and answered 500 — and a 500 is exactly what makes Telegram redeliver the same payload forever. Found in counter-review of this wave's own work.

### Tests

- **Backend 15,031 → 15,331**, frontend 2,567 → 2,729, deploy driver 47 → 50 Pester cases, plus two promtool cases on the new alert. The jump includes a parallel quality effort that landed in the same release: pure-helper extractions across the orchestrator, routes and briefing formatters, and a shared `api-error` module that gives the connector hooks and Server Actions one place to read FastAPI's error envelope.
- Every fix was **falsified**: the previous behaviour was restored and the test verified to fail. The old `RemoteDir` rule accepted 8 of 14 hostile values; a `> 0` alert threshold fires on the Redis hiccup the new one ignores; the `startswith` exemption let all 8 bypass paths through.
- The permission-hardening command was executed against a real POSIX filesystem (`644/755` → `600/700`) after Git Bash on NTFS reported a false failure — `chmod` does not apply there, which would have made the new blocking check look broken.

## [1.25.21] - 2026-07-25

**Generational RAG continuity** ([ADR-150](docs/architecture/ADR-150-RAG-Generational-Continuity.md)). Reindexing a space used to re-embed every document and drop each document's old chunks before writing the new ones, so for the whole reindex window that space returned nothing to search. The two generations now live side by side, a durable per-space serving pointer keeps every query answered by the old generation until the new one is fully built, and the switch is an atomic per-space flip — never a global freeze. Also in this release: the permanent test-skip allowlist is back to zero, the MyPy strict-exemption surface shrank 91 → 90, and the frontend cyclomatic-complexity baseline shrank 56 → 53. Backend tests **15,023 → 15,031**.

### Added

- **Generational RAG continuity** (AC-001) — a same-dimension embedding-model change keeps document search available throughout the reindex. `RAGChunk` carries no uniqueness constraint, so the old and new generations coexist; a durable `rag_spaces.serving_embedding_model` column (migration `c1d2e3f4a5b6`, `NULL` = steady state) records which generation each space serves. The reindex pins every space to the old model in the same atomic commit that persists its intent, `process_document` is driven by that pointer so the drain and the reaper never disturb the served generation, and each space flips to the new model atomically once its rebuild completes. A crash mid-reindex is resumed by `flip_pinned_spaces_if_ready` in the RAG job reaper. New metric `rag_reindex_space_flips_total` (`outcome=flipped|deferred|failed`).
- **`langgraph_state` metrics for the router and planner nodes** (AC-007) — `router_node_v3` and `planner_node_v3` now emit the state-update instrumentation the other graph nodes already carried, closing a blind spot in the pipeline's observability.

### Changed

- RAG retrieval groups spaces by the generation actually being served and embeds each query with that generation's model; the global "reindex in progress → skip retrieval" block is removed.
- During a generation swap, `process_document` deletes chunks by `(document, model)` rather than by document alone, so it never removes chunks of the generation still being served.
- A change of embedding **dimension** — which requires a new pgvector column — remains an explicit, documented maintenance window rather than a silent empty result (runbook: [GUIDE_RAG_SPACES](docs/guides/GUIDE_RAG_SPACES.md)).

### Fixed

- RAG semantic search is now wrapped per generation: an embedding or query failure logs `rag_semantic_search_failed`, counts `rag_retrieval_skipped_total{reason="semantic_search_error"}` and degrades to lexical results instead of failing the whole retrieval.
- `reset_rag_embeddings` clears the per-model embedding-client cache alongside the singleton and the query cache, so a reindex can no longer leave a stale client bound to a superseded model.

### Tests

- **8 real-PostgreSQL integration tests** for the generational path: the atomic flip, the crash-resume, and a served-generation query answered by the old model while the new one builds.
- Permanent test-skip allowlist **12 → 0** — the three "dead" connector skips were masking the uncovered `_handle_oauth_connector_callback` delegate branch (0 % covered); four behavioural tests replaced them before deletion.
- MyPy strict-exemption surface **91 → 90** (stale `unused-ignore` and `type: ignore[assignment]` removed) and the frontend cyclomatic-complexity baseline **56 → 53** (`hitl-utils.ts` decomposed into data-driven template tables, behaviour preserved, 20 tests).

## [1.25.20] - 2026-07-25

Security remediation of the 2026-07-13 audit ([ADR-149](docs/architecture/ADR-149-Security-Remediation-Wave-1.md)). Every finding was re-verified against the code before being treated — several were false positives, and the verification exhumed defects the audit had missed. Two controls turned out to be declared but never applied: a skill script inherited the API's Docker group, and the "global rate limit" was an object nothing ever consulted. Backend tests **14,847 → 15,023**.

### Added

- **Skill scripts run in a throwaway container** (SEC-001) — no Docker socket, `--network none`, read-only rootfs with a sized tmpfs, uid 65534, all capabilities dropped, memory/pids/CPU/file-size bounded. The privilege drop it replaces only isolated when the API ran as root; production runs as `appuser`, a member of the `docker` group that a child process inherits — socket included. The script SOURCE is passed inline (`python -c`) rather than mounted: the API is itself a container, so a bind would resolve against the host, and stdin stays free for the JSON payload every skill relies on. An unreachable daemon fails the execution; it never downgrades. Settings: `SKILLS_SCRIPT_SANDBOX`, `_IMAGE`, `_PYTHONPATH`, `_TMPFS_MB`.
- **A global HTTP rate limit that is actually enforced** (SEC-016) — `RateLimitMiddleware`, pure ASGI, backed by the shared `RedisRateLimiter` so the budget is common to the four uvicorn workers. Sized from measurement (a real browser session peaked at 67 req/min; default 300), probes exempt, fail-open when Redis is down with the blind window counted (`http_rate_limit_degraded_total`) and alerted (`GlobalRateLimitDegraded`).
- **Request bodies bounded before they are read** (SEC-031) — `BodySizeLimitMiddleware` refuses on the declared length when it can, and counts streamed bytes when it cannot. Endpoints used to materialise the payload before validating it — on the webhooks, before authenticating it. `Settings` now refuses to boot when the global ceiling sits below a configured upload limit, instead of shipping a remote-only 413 that no endpoint log explains.
- **Every DevOps task is confirmed before it runs** (FN-1) — `claude_server_task_tool` no longer executes: it returns a `DEVOPS_TASK` draft carrying the target server, the full task text and the model-authored `context`, and the SSH session happens in `execute_devops_task_draft` after approval. The draft is the only mechanism both execution modes honour — the pipeline ignores `hitl_required`, and ReAct would otherwise ask twice. Progress streaming is preserved through a `ContextVar` carrying the SSE queue into the executor.
- **Browser requests validated per destination** (SEC-032) — the interceptor checked nothing beyond the scheme and forwarded on exception, so a public page could redirect to loopback, a private range or the metadata service. Each request now resolves its host behind a bounded LRU+TTL verdict cache and fails closed. Behind `BROWSER_SSRF_ENFORCE`, report-only first.
- **Outbound MCP OAuth calls guarded at all five sites** (SEC-008/SEC-030), two of which the audit had not seen — the heuristic endpoint probes and the `WWW-Authenticate` probe. An AST guard now fails the build if any outbound call in that module is left unguarded.
- Profile-image fetching follows redirects **hop by hop** with a per-hop allowlist and a bounded read (SEC-026); the RAG upload proxy authenticates, admits, then reads a strictly bounded body over a single native transport (SEC-006); the static-map proxies require a session and carry their own budget (FN-5); the Telegram webhook refuses when no secret is configured, and the configuration refuses to start on a placeholder (SEC-024).
- Sensitive client storage is purged on logout **and on account change** (SEC-035), via an owner marker that also covers a session expiry followed by a different login.
- GPS parameters (`lat`, `lng`, `origin`, `dest`…) joined the sanitized query parameters, and the uvicorn access loggers are reclaimed so their URLs pass through the PII filter — `uvicorn.access` sets `propagate=False`, so those lines used to bypass it entirely.
- Executable guards for the classes found here: the sandbox argv contract and its fail-closed behaviour, tool-family import order in a fresh interpreter, body-ceiling/upload-ceiling consistency, and MCP outbound-call exhaustiveness.

### Changed

- The SlowAPI `Limiter` and its 429 handler are gone from `main.py`, together with the helpers only their own tests kept alive (`build_default_limit`, `resolve_endpoint_limit`, `get_rate_limit_message`) and the constants that became unreachable with them.
- `draft_executor` split into engine / registry population / leaf registry (`draft_executor_types`), so adding a draft type no longer grows the engine past its size cap.
- The RAG upload proxy reads its ceiling from `RAG_SPACES_MAX_FILE_SIZE_MB` — the same `.env` both containers load — instead of a hardcoded copy that would silently reject valid uploads once an operator raised the backend limit.
- `email` is no longer part of `UserUpdate` (SEC-005): the generic profile endpoint has no re-authentication, no proof of owning the new mailbox and no session revocation, so a stolen session could become a permanent takeover through the recovery flow.
- Dev Compose binds its published ports to loopback by default (SEC-015), with `DEV_BIND_HOST_APP` for the app ports when the dev app is reached from the LAN; the deploy script pins host-key checking and tightens the permissions of the credential directory it uploads (SEC-013/SEC-014).

### Fixed

- **A timed-out sandbox container outlived its own timeout.** Killing the `docker run` client does not stop the container, and a script that sleeps burns no CPU — so neither the CPU rlimit nor `--rm` reclaimed it. Each run now carries a unique name and the timeout path force-removes it, from the worker thread so the cleanup survives cancellation of the awaiting coroutine.
- **An import cycle silently removed the whole DevOps tool family at boot.** `drafts.service` imports `agents.tools.output`, which runs the tools package init, which conditionally imports the DevOps module — importing the draft service at module level closed the loop. The unit suite never saw it: importing the module directly takes the safe order.
- **The DevOps confirmation card hid the one field an injection would use.** `context` is model-authored and lands in the remote CLI's `--append-system-prompt`; it is now displayed in full alongside the task.
- **Admin rights were only checked when the draft was built.** An arbitrary delay separates that from the confirmation and a HITL decision can be replayed, so a revoked superuser still got their pending task executed. The check runs again at execution.
- The OAuth `state` is fingerprinted instead of logged verbatim (FN-3), and a daemon refusal (exit 125) is reported as a sandbox failure rather than handing the LLM our image names and daemon state.
- The DevOps guide contradicted itself on `max_turns` — advertised as a working cap in its configuration table, documented as never forwarded three sections below.

### Tests

- **176 new backend tests** covering the sandbox command contract and its fail-closed paths, the DevOps confirmation in both directions, the body-ceiling invariant at its exact boundary, and the import-order regression.
- Non-regression of the skills feature proven by differential rather than by assertion: the ten shipped scripts, executed in both modes with identical parameters, produce **byte-for-byte identical output on nine of ten** (the tenth uses `secrets`).
- The new guards were falsified before being trusted — reintroducing the import cycle reds two of three cases, and removing the outbound guards reds the AST check.

## [1.25.19] - 2026-07-24

Twenty-two silent defects, found by testing the safety mechanisms instead of trusting them. None of them raised, logged or failed a suite: an assistant that ran a bulk action without asking, proactive tool calls that could switch your lights, deleted mail resurfacing in an ordinary search, a rescheduled meeting duplicated instead of moved, and cached tokens billed twice. Backend tests **13,282 → 14,847**.

### Added

- **Twelve executable guards**, each carrying its own oracle rather than a frozen snapshot: connector-parity contract (the `Protocol` file is never imported at runtime, so nothing enforced it), LangGraph state-key declaration, `QueryIntelligence` serialization round-trip, locale-normalization AST guard, display-component XSS/robustness contract parameterized over the card registry, tool-mutation classification vs the declared catalogue category, no initiative-eligible tool is a mutation, the FOR_EACH gate agrees with the mutation oracle, and a cross-stack password-policy parity guard (the browser re-implements the rule; the constants are now pinned against it).
- `display/urls.py` — `safe_url` (scheme allowlist) and `safe_css_color` (hex/keyword allowlist), extracted so every card shares one sanitizer instead of inlining its own.
- `infrastructure/llm/strict_schema.py` — the OpenAI strict-mode schema analysis, extracted from `structured_output.py`.

### Changed

- Coverage gate **45 % → 59 %** (measured 62.79 % on the gated fast-unit subset); frontend thresholds 60/54/54/60 → 62/56/56/62. The margin is deliberate — the measurement is local (Windows) and CI runs on Linux, where a handful of branches differ.
- File-size ratchet re-locked on real gains: `formatters.py` cap 815 → 753, and `structured_output.py` leaves the frozen list entirely (531 SLOC, under the global 600 ceiling).
- `scope_detector` no longer keeps a private copy of the mutation verbs — it delegates to the single oracle, which also removes the drift that caused the FOR_EACH defect below.
- Seven tool manifests now DECLARE their category instead of letting it be inferred from the tool name (`apply_labels`, `complete_task`, `control_hue_light`/`_room`, `activate_hue_scene`, `run_skill_script`, `import_user_skill`).
- Docker build context: `.next-e2e` (2.5 GB), `.mypy_cache`, `htmlcov` and coverage artefacts are excluded — the Web context drops from ~2.9 GB to a few dozen MB.

### Fixed

- **A bulk action could run without ever asking.** Both production call sites pass `is_mutation=False` and let the gate auto-detect from the tool name, but `scope_detector` kept its own verb list, which had drifted from the canonical one: `reply` and `forward` were missing. A mutation needs confirmation from the first iteration, a read-only operation only from the tenth — so "reply to each of these 9 emails" sent **nine replies with no confirmation at all**. Same for forwards, label changes and reminder cancellations.
- **The assistant could act on its own.** The initiative phase (ADR-062) executes tools after a turn to enrich the answer, gated on a category that, absent an explicit declaration, is INFERRED FROM THE TOOL NAME and defaults unknown shapes to read-only. Seven mutating tools were therefore declared safe for proactive execution — including `control_hue_light` (a physical device) and `run_skill_script` (arbitrary code). The "defense in depth" check downstream re-used the very same list, so it verified nothing.
- **Deleted mail resurfaced in ordinary searches.** The trash-exclusion keywords contained the bare words `trash` and `deleted`, matched as substrings: searching "deleted invoices" silently dropped `-in:trash` and mixed trashed messages into the results as if they were live. The operator forms (`in:trash`, `label:TRASH` — what the tool teaches the model to emit) remain honoured, and a whole-query "trash" still maps to the operator.
- **"Reschedule my meeting" created a duplicate instead of moving it.** `reschedule` contains `schedule`, and create is tested before update, so the declared `reschedule` pattern was unreachable: the turn loaded the create tools and never `update_event_tool`. Verified exhaustively — that pair is the only such overlap across the four intent sets.
- **Cached tokens were billed twice.** Providers report an input total that already contains the cache reads; the modern extraction path subtracts them, the legacy path did not, so those tokens were charged at the full input rate on top of the discounted cached rate.
- **A valid plan was rejected as a "ghost dependency".** The check compares the second path segment against the producing step's result_key, but that segment is just as often a plain output FIELD — and `total` is listed in `get_contacts_tool`'s own reference examples. A legitimate reference was therefore refused, forcing a wasted replan.
- **A whole parameter type escaped validation.** `number` was missing from the type table; a type absent from that table is not "unknown, be careful" — it is skipped, and the constraint checks that follow are themselves type-guarded. `get_places_tool.min_rating` had no validation at all, and a string rating only failed inside the tool as `'<=' not supported between float and str`.
- **A tool result keyed `items` broke FOR_EACH in silence.** The polymorphic extractor tested `hasattr` before dict access, so `extract_value({"items": [...]}, "items")` returned the bound `dict.items` METHOD instead of the list — the iteration then ran over nothing, without an error.
- **`javascript:` reached an `href`, and a transit colour escaped its `style` attribute.** Card rendering had no URL-scheme allowlist and interpolated a provider-supplied colour raw: `#fff" onmouseover="…` closed the attribute and injected a handler (proven by parsing the output, not by inspection).
- **Apple/Microsoft connector asymmetries** — a 5xx response was handed to the vCard parser instead of raising (silent data loss on update), a failed delete returned success, `cached_at` was fabricated on every cache hit, and an Outlook folder label failed to match on case/spacing.
- **A locale variant could miss its own table** — seven ad-hoc normalizations (`locale.split("-")[0]`, `language[:2]`) bypassed the single chokepoint, so `zh` never resolved to the backend-canonical `zh-CN`.
- Descending sorts placed rows _missing_ the sort key FIRST instead of last, and `DISTINCT` went through a `set`, making result order non-deterministic between runs.
- Nesting-depth analysis for OpenAI strict mode did not follow `$ref`, and Pydantic v2 never inlines nested models — the measured depth was therefore always the shallow one.
- A pytest fixture closed the global psycopg pools on whichever loop the test ran on, including pools opened by an earlier test on another loop, producing a teardown error whenever the unit and agents scopes ran in a single invocation (CI runs them separately, so it only bit locally). It now closes only what the current test opened — which is what its own docstring already promised.

### Tests

- **1,565 new backend tests** across 26 batches, every one written against a behaviour that can fail silently. Each source fix followed the same discipline: a red test proving the defect on real data first, the correction second — never the reverse.
- Targeted coverage on the pieces that decide correctness: plan validation (schema gate, parameter types, conditions, dependency graph, `$steps` references), reference resolution, the entity registry reducer, the HITL resume builder, the draft post-approval sync, connector clients, display cards, Gmail query normalization, outbound-recipient validation, the password policy (which had none) and the LLM cost path.
- Deliberately NOT tested, with the reason recorded: the plan-approval modification path (`approval_gate_node` is an explicit pass-through) and the adaptive replanner (`advisory only, not wired` — no decision changes control flow). Testing them would inflate the number and protect nothing.

## [1.25.18] - 2026-07-24

Factual accuracy of answers (ADR-147/148): grounding on recent entities, weather told in the right time / place / language, correlated results that stop overwriting each other, and health signals that stop vanishing from the heartbeat.

### Added

- **Response grounding on recent entities** ([ADR-147](docs/architecture/ADR-147-Recent-Entities-Grounding.md)) — on a turn producing no `registry_updates`, `{data_for_filtering}` is empty and `<History>` deliberately drops `ToolMessage`, so the response LLM had **no authoritative structured data at all** and could only paraphrase earlier prose. Recent entities are now re-grounded from `state["registry"]` (zero I/O), selected by recency over the `agent_results` keys, capped by `TOOL_CONTEXT_MAX_ITEMS` with a logged truncation, and rendered in a dedicated `<RecentEntities>` prompt section placed AFTER the dynamic marker so the cacheable prefix stays intact. Explicitly non-authoritative (current-turn data wins) and skipped on REFERENCE turns, whose empty registry is an anti-leak fail-safe rather than a grounding hole. Tunable via `RESPONSE_RECENT_ENTITIES_MAX_TURN_AGE` (0 disables).
- **`<DataAuthority>` prompt rule** — forbids inventing an entity attribute, cites `<RecentEntities>` among the authorized sources, and mandates admitting a value that was requested but never received instead of filling it in.
- **Per-day health rollup** ([ADR-148](docs/architecture/ADR-148-Health-Daily-Rollup.md)) — `HealthSampleRepository.fetch_daily_stats` returns one row per UTC day carrying raw integer primitives `(total, count, minimum)`; every `BaselineKind` aggregation derives from them, and because the primitives are exact integers `total / count` is the same IEEE-754 operation as the in-Python `sum / len`, making the equivalence provable rather than merely observed.
- **`heartbeat_source_dropped_total{source,reason}`** — a heartbeat source that fails open leaves no trace in the notification; every drop is now counted and its duration logged (success and failure alike).
- Localized weather tool summaries across the 6 languages (`_WEATHER_SUMMARY_*` in `i18n_v3`), plus an explicit "no detailed forecast for this date" message distinct from the beyond-the-window wording.

### Changed

- Weather three-hour forecasts are mapped to the **user's timezone** before day-bucketing; the rendered `datetime_text` is local and always matches the epoch it ships with.
- The weather tool no longer keeps the request language on the instance — it rides along in the result payload (`_LANGUAGE_RESULT_KEY`), the singleton-state rule that prevents cross-user leaks under concurrency.
- Baselines, variations and the heartbeat health block read the per-day rollup instead of every raw sample: 6 queries / 30,662 rows per tick → 4 queries / ~500 rows. Measured on production-shaped volume: **353 ms → 7.0 ms (×50)**, and the event-loop stall the raw decode caused drops from 124 ms to 1.1 ms.
- `baseline.py` / `signals.py` expose every computation twice over ONE implementation (`*_from_stats` + raw-sample wrappers), so the 19 existing pure-function tests pass unchanged — the non-regression proof is structural, not incidental.
- Extractions to keep frozen files shrinking: `weather_formatting.py` (from `weather_tools`), `plan_predicates.py` (from `semantic_validator`), `health_metrics/heartbeat_signals.py` (from `service.py`, 582→495 SLOC) and `heartbeat/health_context.py` (from `context_aggregator.py`, whose ratchet cap **drops 783 → 753**). `detect_recent_variations` complexity 15 → 10.

### Fixed

- **A tool parameter resolving to nothing became the literal string `"null"`** — the `$item.field` placeholder sits inside the JSON quotes, so emitting `null` produced `"null"`, which every `if not value` guard accepts: production geocoded a town actually named null and answered with the weather of Cappaghnanool, Ireland. A sentinel now marks the missing field and is stripped after parsing, so the parameter reads as absent and the tool applies its own default (auto-geolocation here).
- **A correlated result could erase another one** — tools derive their registry id from content alone (weather → place + day), so two FOR_EACH parents sharing them produced the same id and the accumulator's `dict.update()` silently dropped the first. Measured in production: two appointments both emitting `weather_fee011`, registry stuck at 4 entries instead of 5, one card rendered without the data fetched for it. Ids are now derived per parent (SHA-256 over `item@parent`), deterministic across replays and resumed checkpoints.
- **A date beyond the forecast window returned a silent approximation** instead of an explicit answer, and a within-window date with no provider slot now gets its own message rather than the self-contradicting "only 5 days" wording.
- **Heartbeat health signals were dropped on 46.5 % of ticks** (40 timeouts / 86 decisions over 7 days, silently). PostgreSQL answered in 6.7 ms and the ORM added 58.8 ms — the cost was the per-row client-side decode (~29 µs/row), a synchronous burst that froze the worker's event loop for 483 ms in one stretch. The 2-second budget was being blown by nominal cost, not by a slow database; it is deliberately NOT raised, and its docstring no longer claims to protect against one.
- A single-step plan touching none of the primary domain now triggers semantic validation instead of being waved through; genuine consolidations and multi-step plans are unaffected, and unknown domains or unregistered tools fail open.
- Frontend test `AccountExportSettings` asserted a same-origin download link while merely _assuming_ `NEXT_PUBLIC_API_URL` was absent — green in CI (which sets it to `""` at the runner level), red in any developer shell. It now stubs the contract value explicitly.

### Tests

- Golden characterization net for the health baseline/variations pipeline (Feathers method, as ADR-122): 15 datasets × every `window_days` the tools can request (1..14) = 210 pinned service payloads, generated by running the pre-conversion implementation and passed **unchanged** after it. Sensitivity proven by mutation: `DAILY_AVG`→`min` fails 56 entries, the window boundary `<`→`<=` fails 136, and rounding the daily average fails 14 — that last one only caught once repeating-decimal datasets were added, the net having been numerically blind without them.
- Read-path guard on the heartbeat builder: the payload golden cannot see a regression that recomputes the same window twice (output identical, cost doubled), so the number and shape of repository calls is asserted separately — verified by reintroducing the duplicate read.
- Integration tests against a real PostgreSQL: rollup vs in-Python grouping field-for-field, UTC day bucketing across midnight, **session-timezone independence under UTC+14** (removing the explicit `timezone('UTC', …)` fails exactly this test — CI in UTC would never have noticed), window bounds, ordering, and user/kind isolation.
- New suites for weather hourly mapping and localized summaries, correlated-item identity, plan integrity guards, and the response grounding doctrine.

## [1.25.17] - 2026-07-23

Security & account program (D1/D2/D3/D5 — ADR-143/144/145/146): strong authentication, device sessions, GDPR export, offline PWA.

### Added

- **Passkeys (WebAuthn)** — discoverable credentials with conditional UI on the login form (`autocomplete="username webauthn"`) plus an explicit button; enrollment/rename/revocation in Settings > Security; py_webauthn ceremonies with single-use Redis challenges (GETDEL), sign-count clone detection, per-account cap, generic 401 on the whole anonymous path (no credential enumeration). ADR-143.
- **TOTP second factor** — authenticator-app enrollment (backend-rendered QR data-URI, secret revealed once), explicit matched-timestep anti-replay, 10 single-use backup codes (SHA-256 hashes at rest, revealed once, regenerable); two-step login via a single-use 5-min pending token (`/auth/mfa/verify`). ADR-143.
- **Step-up re-authentication** — sensitive actions (MFA management, revoke-others, export, password disabling) require a fresh re-auth within a 5-min window; typed `403 {"error": "step_up_required"}` contract (never a plain 401); verification by password, TOTP/backup code, allow-listed passkey ceremony, or a fresh Google re-sign-in for OAuth-only accounts; a fresh full login opens the window (sudo-mode semantics). Password sign-in can be disabled with ≥ 2 active passkeys (A8; email reset stays the recovery path). ADR-143.
- **"My devices" session management** — session payload v4 with deliberately bounded metadata (browser/OS families, /24-truncated IP, ≥ 15-min-grain last-seen), opaque sha256 display ids, per-device revocation, step-up-guarded revoke-others; a revoked session's SSE streams close within one keepalive tick (fail-open watcher). New-login push notification with FCM-token device attestation (a registered active token suppresses the alert; passkey logins never notify; every failure mode falls toward notifying) + per-user toggle. ADR-144.
- **Full-account GDPR export** — durable `account_export_jobs` consumed by a leader-elected `FOR UPDATE SKIP LOCKED` executor (crash-safe stale detection, 24 h retention sweep); metadata-driven builder over the total `user_data_map` classification (EXCLUDED secret tables unexportable BY CONSTRUCTION, column-verified redaction/decryption specs, JSON + readable Markdown, attachments/RAG sources ZIP_STORED, 2 GiB cap, atomic rename); step-up-guarded request, ownership-scoped download, "export ready" push ×6 languages. ADR-145.
- **Offline PWA** — unified service worker (historical `firebase-messaging-sw.js` URL kept for in-place registration updates): push + precached branded offline page (6 inline locales) + stale-while-revalidate for static assets; `/api/`, non-GET, cross-origin and SSE are never cached; `CACHE_VERSION` CI-locked to `package.json`; unconditional registration at app boot (previously only users who enabled push had a SW). ADR-146.
- **Total user-data classification** — `user_data_map.py` (50 tables + 76 users columns, purge/export policies) with a 10-test CI guard; deletion purge extended to `open_loops` and `phone_calls` (soft-deleted users never fire CASCADE).
- **`task dev:trust-cert`** — extracts the dev TLS certificate and trusts it (Windows `certutil`): Chromium refuses every WebAuthn ceremony on an untrusted certificate; documented with its three traps in GETTING_STARTED.
- CI guard `test_env_example_inline_comment_guard.py` — inline comments on EMPTY-valued env vars poison the runtime (docker compose AND Task dotenv pass the comment as the value); caught 33 pre-existing offenders on arrival, all fixed (+10 in local `.env`, including a `DOCKER_HOST` that broke every task-launched docker command).

### Changed

- Settings > Security redesigned as three standard collapsible `SettingsSection` cards (Strong authentication / My devices / Export my data) matching every other settings section.
- `create_session` stamps `step_up_at` at creation — right after signing in, no re-auth dialog for 5 minutes; this also un-deadlocks OAuth-only accounts enrolling their first factor.
- Metadata-driven purge: `build_purge_statements` now works on Table objects (no ORM imports) — the import-cycle ratchet SHRANK 31→25.
- Sessions no longer auto-refresh their TTL (fixed 7/30-day lifetime); dead `refresh_session` removed and the five false "auto-refresh" claims corrected.
- Export download link targets the API origin via the new `apiEndpointUrl()` helper (top-level navigation streaming to disk — archives are never fetched into a blob).

### Fixed

- Step-up dialog dead end for OAuth-only accounts (only "Cancel" shown): the account's identity provider is now advertised and usable as a step-up method, and an explanatory empty state replaced the bare Cancel.
- A mistyped password/code in the step-up dialog ejected the user to /login: `/auth/step-up/*` 401s are exempt from the api-client's global redirect (inline error + retry), pinned by `api-client.step-up-401.test.ts`.
- Export "Download archive" produced a dead `download.txt`: the href was relative to the frontend origin, which has no `/api/v1` routes.
- Concurrent export requests: the race loser hit the partial unique index as a raw 500 — now the same 400 as the pre-check.
- `docker compose` passes `KEY=   # comment` as the VALUE when the value is empty: the dev WebAuthn rpId became a comment string; fail-fast validator + comments moved above empty vars everywhere.
- Login-notification preference had no UI and the frontend never sent the FCM attestation token: both wired (Settings > My devices toggle; silent token resolution at login when push permission is already granted).

### Tests

- Backend 12,906 collected (fast suite 11,082 passed / 0 failed), MyPy strict clean (971 files); frontend 2,533 passed (259 files), tsc clean, a11y/react-hooks/CC ratchets hold (CC lowered 57→56); hermetic e2e 44/44 including a CDP virtual-authenticator passkey ceremony; 4 replay-checked migrations (head `b9d5f7a32c84`); runtime-proven on the dev stack (real TOTP enrollment, real passkey ceremony after trusting the dev cert, real export download).

## [1.25.16] - 2026-07-23

> **Ten UX refinements, six QA fixes, one adversarial review — the conversation surface grows up.** This release ships a complete UX program (10 lots, each landed with tests, gates and live runtime proof) plus the same-day QA feedback and a full staged-code review whose 12 findings were all fixed before this commit. The chat learns the manners of a mature messenger: a persistent per-user draft, ↑/↓ recall over the last ten sends, an action row under every answer (copy, feedback, and the execution trace docked at its right edge), tappable follow-up chips generated by the Initiative node, `/` slash commands with everyday shortcuts, and a **reading invariant** — a streaming answer never yanks a reader who scrolled up (an explicit own-send signal replaced two data-diff heuristics that both false-fired against the real engine; a gate-promise SSE e2e caught all three bugs unit tests could not). The dashboard becomes yours: the 9 briefing cards can be hidden and reordered (a hidden card is never fetched — the economy is server-side), a starter checklist exposes the instance's dormant capabilities, and the open-loops ledger gets a consult/close surface. LIA becomes installable: 6 localized PWA manifests, real icons, OS share-target into a chat draft, and a discreet install hint. Skills get a gallery (detail sheet, preview endpoint, declared output channels — the loader finally reads the `outputs:` field the generator had validated all along) and **install-from-URL** through the reused SSRF validator (https-only, DNS-resolved block ranges, no redirects, streamed cap, total transfer deadline, per-user rate limit) feeding the untouched hardened import pipeline. And the journal's compiled portrait now speaks the user's language — the English voice examples buried in the consolidation prompt were overriding the language instruction 150 lines above; the fix binds `{user_language}` at every generation point, proven by regenerating a real French portrait in place.

### Added

- **Chat input maturity (A7)** — per-user persistent draft (`lia.chatDraft.{userId}`, debounced, clamped at the backend cap, purged on logout, `?draft=` deep links persisted at consumption) and an ↑/↓ walk over the last 10 sent messages (consecutive-duplicate collapse; editing the recalled text returns the arrows to the caret; IME-safe).
- **Bubble action row (PERSO)** — copy + response feedback in flow at the bubble's bottom (the old overlay covered text on mobile), with the execution trace (« N steps · X s ») docked at the row's right edge and its panel expanding full-width (QA feedback).
- **Reading invariant + floating return (A3)** — live-geometry follow decision (`lib/chat-scroll.ts`, growth-compensated bottom detection), floating "back to bottom" button with an off-screen-responses badge (counted once per response, polite live region), history-view delegation to return-to-present; hermetic gate-promise SSE e2e (`chat-scroll-follow.spec.ts`).
- **Follow-up chips (A2)** — the Initiative node emits 0-3 sanitized suggestions (server-side clamp/dedupe, pop-once per-run handoff — the service state is a pre-run snapshot), carried in BOTH the SSE done chunk and the archived metadata; a chip click prefills, never sends.
- **Slash commands (A4)** — hand-built WAI-ARIA combobox on the native textarea (no cmdk), diacritic-insensitive filtering on localized label aliases, conversational commands prefill / local commands navigate; catalogue: resume, briefing, agenda, search + everyday shortcuts (emails, weather, weekend weather, tasks, reminders, news) + dialogue-flagged skills.
- **Briefing grid preferences (B4)** — hide/reorder the 9 dashboard cards (`users.briefing_preferences` JSONB, strict PUT schema + tolerant reader completing the canonical order); a hidden card short-circuits BEFORE any fetch or cache IO and refuses direct refresh (`section_hidden`); keyboard-first settings UI (↑/↓ buttons, polite position announcement AFTER the successful persist, drag-and-drop as pointer enhancement). `RefreshSectionLiteral` repaired from a silent 6/9 drift and completeness-pinned.
- **Starter checklist (A10)** — dismissible "getting started" card with live-detected items gated on instance flags (`/config` grows `channels/heartbeat/skills/open_loops_enabled`); only dismissal/celebration timestamps are persisted (`users.onboarding_checklist`, stamp-once on true transitions), pre-completed profiles are stamped silently.
- **Open-loops surface (B5)** — settings section listing the commitments ledger grouped by direction with one-tap Done / Relaunch-in-chat (draft prefill) / No-longer-relevant (`closed_reason=dismissed`, API-validated `Literal`); closure counters at the repository chokepoint (`open_loop_closures_total{reason}`); 404 = surface absent, transient failures get a retry affordance.
- **PWA installability + share (A6)** — 6 localized manifests (start_url, shortcuts ×3, separate any/maskable icon entries, structural parity pinned by test), real PNG icons + apple-touch-icon (iOS ignores SVG), per-locale `<link rel=manifest>` via `generateMetadata` (SEO fields byte-preserved and unit-guarded), OS share-target `GET /{lng}/share` composing a clamped chat draft (never auto-sent), and an install hint (≥3 visits, never in standalone, dismissible forever).
- **Skills gallery + install-from-URL (B12)** — card grid opening a detail sheet (localized description, declared channels with "text" fallback, `assets/preview.png` served by a dedicated endpoint with name-pattern traversal guard + size cap + admin-disabled 404, provenance warning on every non-admin skill); `POST /skills/import-from-url` (https-only, reused `web_fetch` SSRF validator, redirects refused, streamed size cap, TOTAL transfer deadline, per-user Redis rate limit, magic-byte/frontmatter sniffing, stable `url_*` error contract) feeding `SkillImportService.import_upload` verbatim; `skill_url_imports_total{outcome}`. The loader now surfaces the declarative `outputs:` frontmatter field (generator-parity pinned — recorded deviation from the planned `channels:` name: the vocabulary already existed).
- **Telephony in the connectors administration** — `elevenlabs_telephony` added to the frontend connector tables and the admin section (own category, i18n ×6); the backend enum had it since telephony P1.

### Fixed

- **Journal portrait/entries in English for non-English users** — the consolidation prompt's English voice examples ("I notice…") overrode the language instruction 150 lines above; `{user_language}` is now bound at every generation point (voice line, brief spec, JSON schema) and the introspection prompt hardened; proven by regenerating a real portrait in French in place.
- **Page-level scrollbar regression** — the Lot 3 `sr-only` live region (position:absolute, no positioned ancestor) escaped the thread scroller's clipping and stretched the BODY; fixed with a zero-height relative containing block.
- **Floating button inert after a quiet start** — the scroll listener now arms at pin-window expiry and on the first user gesture, not only when content overflowed during the window (review finding).
- **Checklist PATCH replay** — timestamps stamp on true transitions only; a retried/second-tab PATCH no longer rewrites history (and no longer commits).
- **Slash-menu highlight** — re-filtering returns the highlight to the first option instead of a clamped leftover position.
- **Day-of-release Next.js advisories** — four high-severity advisories published against Next 16 (App Router middleware/proxy bypass, Server Actions DoS + SSRF, rewrites SSRF — GHSA-6gpp-xcg3-4w24, GHSA-m99w-x7hq-7vfj, GHSA-89xv-2m56-2m9x et al.) red the blocking dependency audit; bumped to 16.2.11 (patch release), lockfile refreshed, high-level audit clean.
- **Review hardening** — total transfer deadline on URL imports (httpx timeouts are per-phase; a dripping server was unbounded in time), per-user rate limit on outbound fetches (failed imports consume no skill quota), preview 404 for admin-disabled system skills, chat-search focus scoped to its own `data-chat-search` marker, English-only API field descriptions, and the repo's infra-info guard caught a real private IP in a new SSRF test (replaced by a neutral RFC 1918 address).

### Changed

- `ExecutionTraceDisclosure` renders inside the action row (fragment, `ml-auto` toggle, full-width wrap panel) instead of a separate line under the bubble.
- `SkillsSettings` decomposed into `SkillGallery` / `SkillDetailModal` / `ImportFromUrlDialog` + top-level handler factories (frontend CC baseline locked LOWER: 51 files ≥15, was 52); `auth/router.py` growth refused by the SLOC ratchet — the checklist endpoint lives in its own `auth/checklist_router.py`.
- E2e scroll spec waits on observable geometry (`expect.poll`) instead of arbitrary sleeps (the two pin-window sleeps are structural and documented).

### Tests

- **10,972 backend** (fast suite; +66: outputs field + generator parity, URL-import SSRF matrix + total-deadline + endpoint passthrough + rate limit, preview guard, checklist stamp-once, briefing preferences/hidden sections, followup metadata, open-loops router) + **2,465 frontend** (249 files; +141 across chat-scroll decisions, input draft/history walk, slash commands/menu, follow-up chips, briefing grid, checklist, open loops, install hint, PWA manifests structural parity, gallery flow) — tsc clean non-incremental, a11y/react-hooks/CC ratchets hold (CC locked lower). Playwright: scroll-follow 2/2 (caught 3 real bugs during development) + full smoke 29/29 against the dev container. Two Alembic migrations (`briefing_preferences`, `onboarding_checklist`) replayed down+up in-container. Runtime proof for every lot on the dev stack, including real SSRF refusals (private IP 400, HTML 422, GitHub SKILL.md 409 through the S2 pipeline, oversized zip 413) with all four outcomes visible in `/metrics`.

## [1.25.15] - 2026-07-22

> **The showcase learns to fit in your hand.** The landing page claimed "responsive" while silently amputating itself on phones: the hero clipped its own CTAs, the whole layout **oscillated between 381px and 448px during the animation cycle** (the mockup's typing text inflated its grid track on every act — invisible on any static screenshot), and chapter 01 cut every benefit line mid-word at 412px for a 375px viewport. One root cause explains all of it — flex/grid children whose intrinsic min-content width widens the track (`truncate` without `min-w-0`, chip rows without wrap) while `html { overflow-x: hidden }` turns the overflow into silent clipping instead of a scrollbar. The fix is a doctrine, not a patch: `min-w-0` on every two-column track, wrap on every variable-count row — and a Playwright guard that replays the **full 79-second animation cycle in virtual time**, asserting the invariant at every beat (it promptly caught a fourth, unrelated bug: the carousel dots overflow the 320px WCAG reflow floor). The public FAQ sheds its unstyled-`<details>` look for the landing's own visual language — search, icon section rail, 51 questions instead of 13 — and the infamous 10,000-character "What can I ask LIA?" wall (8,883px tall on a phone) becomes twelve per-domain sub-accordions **without touching one translated word**: the grouping is a presentation-only parser whose test proves word-for-word equality across all 6 real locales (zh, whose q4 is a different answer, falls back untouched). The four-act hero animation gets its own shareable URL (`/demo` — no header, no auth redirect, zero new i18n keys) plus a 1080×1350 H.264 export for social feeds, and both redesigned pages join the axe gate: zero critical/serious violations, contrast included, light AND dark.

### Added

- **`/demo`** — the hero conversation animation as a standalone localized public page (6 languages, hreflang + canonical + OG, no header/footer/auth-redirect), built for social sharing and embeds; reuses existing copy only (`landing.meta.title` + `landing.chat_mockup.aria` — zero new translation keys). Registered in `PUBLIC_ROUTE_SEGMENTS` (the completeness guard caught the omission: a 401 would have bounced visitors to /login) and in the sitemap. A social MP4 export procedure ships in `docs/technical/LANDING_PAGE.md` (Playwright recordVideo — viewport MUST equal the video size, the mismatched-size rescale squeezes the frame — then ffmpeg H.264; artifacts under gitignored `exports/`).
- **Public FAQ redesign** (`/faq`) — landing visual language: accent-insensitive search (helpers extracted to `lib/faq-search.ts`, shared with the dashboard FAQ), chip anchor rail, icon section headers (`components/faq/faq-sections.ts` — shared registry), native `<details>` cards, `prose` answer typography (links were invisible before). Public scope grows from 2 sections/13 questions to **6 sections/51 questions** (getting started, connectors, telephony, voice, image generation, privacy — the pre-signup set), JSON-LD included.
- **`lib/faq-answer-groups.ts`** — presentation-only splitter turning `<br><br><strong>`-shaped mega-answers into per-domain collapsible groups (the 10.9k-char q4 renders 747px instead of 8,883px). Translation files byte-identical; `faq-answer-groups.test.ts` proves readable-text equality on all 6 locales and the zh fallback.
- **Landing mobile overflow guard** (`e2e/smoke/landing-mobile-overflow.spec.ts`) — at 375px: static, then across the whole hero animation cycle via the Playwright clock (79s virtual — the oscillation class is only visible with the timeline running), then per scrolled section; plus a 320px WCAG 1.4.10 reflow pass.
- **Public-pages axe gate** (`e2e/a11y/axe-public-pages.spec.ts`) — `/faq` (with a grouped answer open) and `/demo`, light and dark (the theme is localStorage-driven — `defaultTheme="light"` means OS-scheme emulation does nothing; the spec encodes the trap).

### Fixed

- **Hero clipped and unstable on phones** — the badge row (`whitespace-nowrap` version pill in a no-wrap flex) forced the column to 381px/343 available: version truncated, title off-center, subtitle cut mid-word, both CTAs bleeding off-screen; and the mockup's typing input (`truncate` without `min-w-0`) periodically snapped the whole hero to 448px during acts. Fixed with `flex-wrap` + `min-w-0` on both grid tracks and the mockup's inflating rows (input bar, backstage query pill and chips) — column now measures a constant 343px across the full cycle.
- **Chapter 01 text cut at the right edge** — the vignette's three-chip row (min-content 412px) and its truncated query pill (383px) widened the chapter grid track past the viewport; every benefit line rendered clipped. `min-w-0` on the `ChapterSection` grid items and the vignette chips/pill (chapters 02–05 were already clean; measured).
- **Carousel dots overflow the 320px reflow floor** — 12–15 × 24px dot targets in a no-wrap row (screenshots + slides carousels); found by the new guard's WCAG pass, fixed with `flex-wrap`.
- **Mobile hero typography** — h1 starts at `text-4xl` (was `text-5xl` on 343px), and the subtitle's forced `<br>`/`\n` breaks now apply only from the `mobile` breakpoint up (no more orphan words); desktop rendering pixel-identical.
- **React duplicate-key errors on the public FAQ** — identical bullet strings within a grouped answer collided as keys (caught in the runtime console during proof); index keys are correct for this static, never-reordered list.
- **`llms.txt` audit-score drift** — claimed 8.0/10 while the published audit (and the landing) say 8.3/10; metrics realigned with `LANDING_STATS`.

### Changed

- `FAQContent` (dashboard) now imports the shared search helpers and section-icon registry instead of owning them (−146 lines, behavior pinned by its existing suite).

### Tests

- **12,717 backend** (untouched) + **2,324 frontend** (233 files; +19: answer-groups parser ×13, public FAQ behavior ×6) — tsc clean non-incremental, a11y/react-hooks/CC ratchets hold. New Playwright evidence in the official image: overflow guard 3/3 (including the 79s virtual-time cycle), axe public pages 4/4 light+dark, zero critical/serious. Runtime proof on the dev container: hero column stable at 343px through the full cycle (was 381↔448px), zero in-flow element past the viewport on all 13 sections, grouped q4 at 747px (was 8,883px), desktop pixel-identical.

## [1.25.14] - 2026-07-22

> **The psyche becomes measurable — and the third fix ships with its own referee.** ADR-104 de-saturated the assistant's mood a month ago and promised a production re-measurement that was never instrumented; this release starts by paying that debt. A deterministic replay of the real engine plus a computation over the real 14-personality catalogue exposed two defects the previous pass could not see: the **dominance axis is structurally off-center** (all 14 personalities — including the one literally named _Dépressif_ — rest on the assertive side; five of the fourteen moods are unreachable at rest, and damping, being a homothety, can NEVER recenter them), and the **proactive joy pulse crowns an emotion the LLM never reported** (55% of ordinary-regime turns — the exact mechanism of the pride pulse ADR-104 removed). Both fixes ship as `.env` knobs **defaulting to today's behavior**: merging changes nothing, and a golden characterization test freezes all 14 resting points at 1e-9 to prove it. The missing instrument now exists (`measure_psyche.py`, read-only, runnable via `docker exec` in prod — its first dev-DB run confirmed the lock on live data: 4/14 moods, 100% single-octant, 99.3% dominant-emotion stickiness) and a CI reachability oracle replays a scripted conversation through the real engine so the properties become permanent rules instead of hand-tuned numbers. The kindalive project that triggered the investigation was examined mechanism by mechanism and **rejected on measurement** — its analytical lens (resting points need headroom on both sides) is what found the defect; its architecture added nothing. (ADR-142)

### Added

- **Psyche measurement instrument** (`apps/api/scripts/measure_psyche.py`): the ADR-104 baseline battery per user (distinct moods visited, PAD octant coverage, D<0/A<0 shares, dominant-emotion distribution with joy/pride flags, intensity ≥ 0.60 share, stickiness, co-active mean, post-idle magnitude) + live personality-catalogue resting table at current settings. Read-only, no PII, `--json-out` for before/after diffing; ships inside the api image (`apps/api/scripts/`, not repo-root `scripts/`).
- **`PSYCHE_DOMINANCE_CENTER`** (default `0.0` = inert): post-damping translation of the dominance resting point, threaded through all 6 baseline call sites. The activation candidate `0.20` is _derived_ from the measured catalogue mean (+0.216), not guessed; at that value 7/14 personalities rest D < 0 with the personality ordering exactly preserved and P/A untouched.
- **`PSYCHE_PROACTIVE_JOY_PULSE`** (default `true` = inert): gate on the sustained-quality joy pulse so the LLM-reported appraisal can own the emotion channel; `curiosity`/`enthusiasm` pulses (measured near-inert, legitimately scoped) are kept.
- **Mood-reachability CI guards** (`test_mood_reachability.py`): golden no-op characterization of the 14 catalogue resting PADs (frozen at 1e-9, actionable failure message), catalogue-straddle guard at the recommended center (≥ 5 personalities each side of D=0, ordering preserved), and a deterministic end-to-end oracle (30-turn scripted ordinary regime through the real engine: 3 moods/87% top at today's default, ≥ 5 moods/≤ 70% top at 0.20). The catalogue is loaded from the seeding migration via importlib — single source of truth, no duplicated table.
- **ADR-142** — full decision record with explicit epistemic caveats (synthetic-stream magnitudes vs production-confirmed facts), the measured activation procedure, and a readjustment decision matrix (character fidelity via `pad_dominance_override`, 0.15 fallback).

### Fixed

- **Honesty micro-fixes** (comments/docstrings only, zero behavior): `PsycheStateRepository.update` claimed "optimistic locking via updated_at" over a plain flush — the docstring now documents the actual flush semantics and the known pre/post-response writer race; `PsycheState` trait comments no longer claim independent evolution; `narrative_identity` and `trait_snapshot` Python comments state what the columns actually hold (weekly narrative; dynamic state, not Big Five) — SQL column comments kept verbatim to avoid model/DB drift, reconciliation deferred to the next periodic comment migration.

### Tests

- **12,717 backend** (10,893 fast-unit green incl. all ratchet guards; mypy strict clean on 945 files — plus explicit black/ruff/mypy on the new script, which sits outside the `src`/`tests` gate perimeter) + **2,305 frontend** (untouched, suite green as zero-impact proof). 24 new psyche tests (dominance-center unit ×5, joy-gate ×3, CI guards ×9, measurement aggregators ×12, minus shared fixtures); psyche domain suite 207 green. Runtime proof: script executed in-container against the dev DB; api container healthy after restart with both new settings loaded at their no-op values.

## [1.25.13] - 2026-07-22

> **The assistant learns to connect its domains.** One product analysis of the whole codebase yielded 17 cross-domain proposals; the six delivered lots (ADR-139/140/141) close the highest-value gaps. LIA now keeps a **commitments ledger**: "je dois rappeler le plombier" quietly becomes an open loop — extracted after the answer by a fifth background pass, nudged by the heartbeat with an anti-nag cooldown, closed the day you say "c'est fait" (flag OFF by default). "Fais-moi une revue de presse tous les matins" finally works **from the chat**: a confirmable draft creates the recurring automation, and a deterministic recurrence detector notices "same ask, same hour, three distinct days" and offers the automation before you think of it. The **user's documents become an active domain** — the planner can chain "compare the PDF quote with Paul's email" — and one call builds a **person-360 overview** (contact card + recent mails + shared events + memories, honestly partial per connector). The briefing grows from six to **nine cards**: "For you" (open loops + automations digest with the precise next run time), strictly pending/overdue **Tasks** (date-only local semantics — due today is never "overdue"), and latest-modified Drive **Documents** (summarize in chat, or open in Drive). The heartbeat gains birthdays with a proposed action chain, journals-grade dynamic memories, an anti-repetition window that finally sees reminders/automations/call reports, a traffic-aware **departure alert** ("pars vers 13:30 — 30 min de trajet"), locally-anchored interests ("expo à Lyon ce week-end") and a meeting-prep nudge — and a completed phone call now proposes the calendar entry it agreed on. Four successive "are you fully satisfied?" counter-reviews caught 15 real defects before release — among them a Redis budget key built on process-randomized `hash()`, six leaked httpx transports (three of them pre-existing in the heartbeat, one per source per cycle), and debug caches whose TTL eviction ran only on a read path that a debug-panel-less deployment never executes.

### Added

- **Open-loops commitments ledger** (ADR-139, `OPEN_LOOPS_ENABLED=false`): `open_loops` table + migration, post-response LLM extraction (dedup, per-user cap, conversational closure), 12th heartbeat source with due/stale nudge policy and per-loop cooldown, minimal REST surface (list + close), For-you card block, debug-panel section.
- **Chat-piloted automations** (ADR-140, creation always on; `RECURRENCE_SUGGESTION_ENABLED=false` for the detector): `create_scheduled_action` returns a confirmable SCHEDULED_ACTION draft (HITL card with localized schedule), `list`/`toggle` tools, Redis recurrence ledger (4-hour local buckets, distinct-days threshold, one-shot cooldown) surfacing an automation suggestion through the initiative slot.
- **Active knowledge layer** (ADR-141): routable `document` domain over the user's RAG spaces (`search_user_documents`, deployment-gated) and cross-domain `get_person_overview` (4 parallel sub-fetches on own sessions, `partial_failures` honesty).
- **Briefing 2.0 — nine cards**: « For you » (fuchsia; loops deep-link the chat with direction-aware intents; automations digest shows the **precise next execution time**, reminders formatting doctrine), **Tasks** (teal; multi-provider Google/Microsoft with preferred list; overdue-first; chat intents progress/reschedule), **Documents** (indigo; Drive modifiedTime desc; summarize-in-chat + external Drive link). Portrait-informed synthesis (`user_model_block`).
- **Heartbeat intelligence**: birthdays source with proposed action chain (message/call), dynamic second-pass memories (ADR-135 symmetry), extended anti-redundancy window covering reminders/scheduled-action results/call reports, traffic-aware departure advice (`HEARTBEAT_DEPARTURE_ENABLED=false`; Routes ETA, leave-by, per-(user,event) Redis cache), locally-anchored interest content (`INTERESTS_LOCAL_ANCHOR_ENABLED=false`), meeting-prep nudge (rule 21), post-call appointment suggestion appended to the telephony return.
- **Cross-domain chains guidance**: adjacency matrix completed (event↔task, email→file, document domain) + explicit chain few-shots in the planner and ReAct prompts (place→call, event→route+weather, email→file, task→event).
- **Debug panel**: Open Loop Extraction section; one aggregation chokepoint (`pop_background_extraction_debug`) so a new extraction family costs zero churn at the SSE emission site.
- **Chat header**: message search is left-aligned; the offline/processing pill sits left of it (hermetic Playwright guard pins the arrangement).

### Changed

- `related_domains` false comment fixed and matrix entries corrected (the initiative node's reverse lookup is now documented at the consumer).
- Initiative wrapper (`initiative_recurrence`) mounts the historical core untouched and merges the deterministic recurrence suggestion only when the LLM produced none.
- Geocoding moved to `connectors/geocoding.py` (heartbeat shim kept) — breaks the heartbeat↔interests runtime cycle; birthdays computation moved to `connectors/birthdays.py` (briefing wrapper keeps its section-status contract).
- `_validate_read_only` (initiative) now also drops exact duplicate (tool, parameters) actions — the LLM occasionally emitted the same weather check twice.

### Fixed

- **Transport leaks (6 sites)**: `person_tools` sub-fetches (×3), `connectors/birthdays` full scan, and the pre-existing heartbeat calendar/tasks/emails fetchers (one leaked httpx client per source per cycle) — all now `try/finally: close()`.
- **Departure ETA cache key** was built on Python's process-randomized `hash()` — every worker/restart missed the cache and re-paid the Routes call; now a pinned sha1 recipe.
- **Extraction debug caches** (journals + open loops) evicted stale entries only in `pop()` — a deployment that never opens the debug panel never pops, so the dict grew one entry per turn for the process lifetime; eviction now runs on the write path.
- Naive LLM `due_hint` timestamps are coerced to aware-UTC (timestamptz doctrine); the extraction prompt now demands an offset.
- `bump_nudged` enforces loop ownership in the WHERE clause (close_loop doctrine).
- `NoLocationAvailableError` is a silent expected gate for departure advice (was a warning every cycle); hardcoded `"fr"` fallback replaced by `settings.default_language`.
- Dead code removed (`OpenLoopStatusFilter`, unused `locality` parameter); recurrence-ledger docstrings realigned with the 4-hour bucket reality.

### Tests

- **12,688 backend** (10,867 unit green incl. all ratchet guards; migration replay-check OK; mypy strict clean on 945 files) + **2,305 frontend** (3 ratchets hold; i18n parity ×6). New suites: open loops (models/repository/router/extractor/wiring), recurrence ledger + suggestion wiring, scheduled-action draft golden, birthdays, departure advice, person/documents/automation tools, For-you/Tasks/Documents cards, provider-client lifecycle (briefing + heartbeat + person tools), header layout Playwright guard.

## [1.25.12] - 2026-07-22

> **Six quick wins move the daily surfaces from consultative to actionable.** The ⚙ execution trace used to die with the page: server-side capture now mirrors the live accumulator step for step (same reset, same per-key dedup, i18n keys only — the PII guard is structural, free text has no slot to land in) and the reloaded bubble shows the same "N steps · X s" disclosure the user watched live. The amber "Reconnect" banner used to fire only on the run that broke the connector; on every later run the tool just said "no connector" — resolution-time detection closes that gap, through two paths because the audit found the dominant one **returns** its error instead of raising it. History search stops lying by omission: accent-insensitive on both ends (`unaccent` was already installed — only the query never used it), match counter, in-bubble highlighting through a post-sanitize rehype plugin (the FAQ highlighter is `dangerouslySetInnerHTML` — unusable on LLM output), and a whole-history panel whose results jump into place with a keyset `+1 ms` cursor and an honest "back to present" path. The briefing cards become buttons that open the chat prefilled with a contextual intent; the compiled portrait — one of the product's most singular artifacts, buried three levels deep — gains a settings shortcut, a dashboard hint and an onboarding mention; and ordinary responses finally get the 👍/👎 the proactive notifications always had, wired into the journals' evidence/contradiction counters through an injected port — because the naïve import closed a domain cycle and the F009 guard said no. Two ratchets moved the right way: the streaming hotspot shrank under its frozen cap, and the frontend CC baseline was LOWERED (max 74 → 60).

### Added

- **Persisted execution trace (ADR-133 V2)** — `services/streaming/trace_capture.py` observes the exact chunks the frontend renders live, at the single per-chunk chokepoint of the streaming loop: reset + router seed on `router_decision`, one occurrence per `i18n_key` per turn (the live bubble early-returns on seen keys — a FOR_EACH shows ONE tool step, so does the persisted trace), `reasoning`/`tool_error` excluded, tail-keeping cap via `EXECUTION_TRACE_PERSIST_MAX_STEPS` (default 100 = frontend `MAX_TRACE_STEPS`). Attached branch-free at archive next to the widget persistence (`with_persisted_trace`, `FIELD_EXECUTION_TRACE`, `duration_ms`); hydrated by `lib/execution-trace-hydration.ts`, which re-resolves labels from the stored keys — same `ExecutionTrace` type, same disclosure component, zero render fork. A reloaded trace deliberately has no 💭 block: the reasoning stream is never persisted.
- **Reconnect banner at provider resolution (ADR-134 V2)** — `find_error_connector_type()` consults the same Redis-cached connector list as the resolver and reports a category connector stuck in `status=ERROR` (`REVOKED` deliberately ineligible: a chosen disconnection must not be nagged about). Two emission paths because `handle_tool_exception` is sync: `ConnectorNotEnabledError` is enriched **at raise time** (`build_connector_not_enabled_error` — HITL executes, tasks, contacts) and read by the classifier as a plain attribute; `ConnectorTool.execute`, which _returns_ its category error without raising, emits the notice directly (`emit_connector_notice`, now a public single emitter). Same SSE contract, same metric, same frontend banner.
- **Complete history search (QW-2)** — backend `unaccent(content) ILIKE unaccent(pattern)` with LIKE wildcards escaped ("50%" now matches the literal text); the contract-locking integration test rewritten to pin all three dimensions (case, accents both directions, literal wildcards). Frontend: instant accent-insensitive filter over the loaded window + "N results in loaded messages" counter; in-bubble `<mark class="lia-search-mark">` via `rehype-search-highlight` running after `rehypeKatex` (skips code/KaTeX; plain `indexOf` on the normalized text — user input is never a pattern; original characters stay marked: searching "reunion" highlights "RÉUNION"); "Search entire history" panel (keyset-paginated dated excerpts, React-segment highlighting, no HTML injection anywhere) with jump-to-result (`before = created_at + 1 ms`), an amber history-view banner, "back to present", and a send wrapper that returns to the present before a new turn lands. Mobile (< 880 px): a header 🔍 unfolds the input row. 15 i18n keys × 6 languages.
- **Actionable briefing cards (QW-9)** — mail, agenda, birthday and reminder items become real, labelled `<button>`s (the accessible name IS the intent) that open the chat prefilled through the onboarding `?draft=` deep-link, generalized (`chatDraftHref`): _"Résume-moi le mail « {sujet} » de {expéditeur} et propose une réponse"_, _"Prépare-moi pour « {titre} » de {heure}"_, _"Prépare un message d'anniversaire pour {nom}"_ — reminders open the chat plainly. The consumed `?draft=` is stripped from the URL (`history.replaceState`), which also fixes the onboarding's latent re-prefill on F5.
- **Portrait discoverability (QW-10)** — `?section=` generalized (value → tab + accordion + scroll, via stable `settings-section-<value>` anchors on `SettingsSection`); "What LIA understands about you" shortcut at the head of Identity & Memory (rendered only when a compiled portrait exists — no teaser), backed by a light `useJournalPortrait` hook gateable on the `journals_enabled` flag now exposed in the frontend `AppConfig` type; a discreet dashboard hint under the hero when the portrait was recompiled within 7 days (localStorage keyed by `compiled_at`, so a NEWER compilation re-surfaces it); a portrait mention on the onboarding Memory page.
- **Response feedback on ordinary responses (QW-5, ADR-138)** — `POST /conversations/me/messages/{id}/feedback`: verdict (+ optional 👎 comment) persisted by an atomic owner-scoped `jsonb_set` (the `mark_interest_feedback_submitted` pattern; foreign/non-assistant ids → 404, existence hidden). The `done` chunk carries `archived_message_id` (the archive precedes the done — verified), history rows carry `message_db_id`; the turn's `injected_journal_ids` are archived with the message (IDs only) so a later verdict feeds the evidence/contradiction counters of exactly the entries that shaped the answer — **first verdict only** (counters have no decrement path; changing the verdict updates the stored verdict, never re-feeds). A 👎 comment additionally lands as an L0 `user_correction` entry **without** consolidation (no LLM cost per thumb). Journal side-effects go through an injected port (`JournalFeedbackHooks` + `journals/feedback_hooks.py`, registered at startup): the direct import — even lazy — closed the `conversations↔journals` domain cycle and the F009 guard caught it. `response_feedback_total{verdict}` is the first direct satisfaction metric on ordinary responses. UI: 👍/👎 chips next to Copy (hover-revealed on desktop, visible on mobile, `aria-pressed` on the active verdict), hydrated cross-device, one-line "what went wrong?" unfolded on 👎 — and never an automatic regeneration.

### Fixed

- **Chat header hygiene (QW-12)** — the green "online" pill pulsed permanently while carrying information only in its rare states: the nominal state is now silent (offline and processing keep their pills). The conversation-totals banner no longer costs a full line: totals (TOTAL/IN/OUT/CACHE/GOOGLE, message count, cost) folded into the context pill's tooltip with the `tokens_display_enabled` gating intact. The now-orphaned `chat.input.status.online` key removed from the 6 locales.
- **LIKE wildcards in history search** — an unescaped `ilike(f"%{search}%")` made "50%" match any content containing "50"; `%`, `_` and `\` are literals now.
- **Onboarding `?draft=` re-prefilled the chat input on every reload** — the deep link is consumed at mount and stripped from the URL.
- **A cleared search field could resurrect its query for 300 ms** — the debounced highlight term is forced empty the instant the input empties (found by the hook's own test).
- **`conversations↔journals` runtime cycle** — introduced by the first QW-5 design (lazy import of journals from conversations), caught by the F009 domain-cycle ratchet, resolved with the injected port + startup registration; cycles stay at 31/31 baseline.

### Changed

- **Streaming chunk accounting consolidated** — the four per-branch metric blocks became one `_track_and_observe` chokepoint (metric + trace capture), and the `_get_chunk_event_type` if/elif chain became a lookup table: `streaming/service.py` shrank back under its frozen SLOC cap while gaining the capture.
- **`ChatMessage` decomposed** — proactive token-field resolution and the feedback gate extracted as pure helpers; the frontend CC baseline was **lowered** (max 74 → 60) and locked in.
- **History rows always carry `message_db_id`** — `toUiMessage` mirrors the live done metadata so live and reloaded bubbles share one feedback contract (the mapping contract test was updated accordingly).

### Tests

- Backend: **+34 net (12,468 collected)** — trace capture (16: reset/seed, per-key dedup, cap keeps the tail, PII exclusions, defensive copies), resolver error-status (9: ERROR match, REVOKED ineligible, legacy alias, category mismatch, lookup failure never masks), connector notice V2 additions in the ADR-134 suite (enriched/plain classification, direct emission), the search contract rewritten on the real DB (accents both directions, literal wildcards), response feedback (6 integration on the real DB: first-verdict counters, verdict change never re-feeds, 👎 comment → L0, journals-disabled, ownership/404, foreign/vanished ids skipped). Suite: 10,644 unit-fast green, cycles 31/31, lint + MyPy strict clean.
- Frontend: **+63** — trace hydration (10), search hook state machine (10: debounce, availability gating, pagination, error, jump `+1 ms`, return, send guard), results panel (7), rehype highlighter (9) + MarkdownContent integration (4), actionable cards (4, role/name oracles), portrait hint/shortcut (8 + 2), feedback buttons (4), context-pill totals (3). Suite: 2 282 green, tsc/ESLint/Prettier clean, a11y/react-hooks ratchets at baseline, i18n parity ×6.
- Runtime, on the dev Docker stack (dedicated QA account, real login): a weather turn's archived row carries the 6-step trace and the reloaded browser bubble shows it expanded; a forged `status=ERROR` Gmail row makes a real email turn emit the `tool_error {google_gmail, reconnect}` SSE chunk; a real turn's `done` carries `archived_message_id`, the posted 👎+comment is reread from the API, a foreign id 404s — and the verdict flipped from the browser lands in the database with `response_feedback_total{verdict="thumbs_up"} 1.0` on `/metrics`.

## [1.25.11] - 2026-07-21

> **A widget that fails now says why — and the interactive map finally works everywhere.** Asked from an iPhone, the map was a blank rectangle: the app-wide `COEP: require-corp` (needed once for the voice wake-word's `SharedArrayBuffer`) is only lifted by the Chromium-only `credentialless` iframe attribute — WebKit cancels the embed with **no event, no message, no log**. Behind that one symptom, measurement found a family. Widget payloads lived only in the browser's React state, so a reload — or the other device — showed grey "unavailable" boxes. The LLM imitated host-owned widget markup from its own history: duplicate and phantom widgets, proven **byte-for-byte** in production data. The skill sub-agent had no notion of the user's position: _"montre-moi où je suis"_ sent the literal words _"ma position"_ — then _"France"_ — as Google Maps search queries, while the geolocation permission prompt never fired for that phrasing in any of the 6 languages. And the analyzer's skill detection hijacked MCP-domain turns three times in a row: a diagram request drew the water cycle **on a Google Maps embed**, then spawned a parasite skill whose failed import dumped inline SVG into the chat — the third attempt only reached Excalidraw because the hallucinated skill name did not exist. Five hypotheses were refuted by measurement on the way; a Playwright bench replayed the **real 450 kB production payload** through the **real airlock shell** on both engines, light and dark; and that same bench destroyed a design assumption before it shipped — `document.open()` erases the Window's listeners, so the boot-failure relay hooks are installed _after_ `document.close()`, not before. Also in this cycle, shipped on `main` between the two releases: the security wave (16 alerts, 7 advisories), 109 npm updates, the six founding ADRs reconstituted, and a 215-file documentation realignment.

### Added

- **`COEP_MODE` (default `credentialless`, ADR-136)** — `resolveCoepMode()` in `src/lib/csp.ts`, env-switchable without rebuild, falling back to the default on any unrecognized value (a typo must never silently drop cross-origin isolation). Chromium keeps isolation, `SharedArrayBuffer` and the wake-word; WebKit loses an isolation it could never combine with external embeds anyway and falls back to push-to-talk — a degradation `isSherpaKwsSupported()` already handled.
- **Widget failure states** — `canEmbedOpaqueCrossOriginFrame()` refuses to render an embed the engine will reject (on Chromium the refusal is otherwise _invisible_: `load` fires on the error document); `useFrameLoadWatchdog` turns a dead frame into an actionable card (message, retry, navigable link) after `NEXT_PUBLIC_WIDGET_FRAME_TIMEOUT_MS`. Liveness is per family: a skill frame's document IS the widget (`load` suffices), an MCP App only proves itself by speaking the protocol (`ui/initialize` handshake) — the airlock shell always loads, so `load` says nothing there. The MCP notice is deliberately **non-destructive**: it renders above the frame, which stays mounted, and a late handshake clears it.
- **Airlock boot-failure relay (ADR-136)** — the shell installs `error` (capture phase — resource failures don't bubble) and `unhandledrejection` hooks after writing the widget document, and relays up to 5 length-capped `lia:widget-error` messages to the parent. The timeout notice shows the detail as **plain text only** (`mcp_apps.frame_error_detail`, 6 languages): a phone report now names the culprit — _"Widget script failed — its CDN imports may be unreachable"_ — without a Mac attached to it. Measured on both engines: an inline module whose static import fails emits an event with no message and no src, so the shell names the likeliest suspect itself.
- **Widgets travel with their message (ADR-137)** — `SKILL_APP`/`MCP_APP` payloads are persisted in `message_metadata.widgets` at archive time and rehydrated on history reads, merged _under_ the live registry. `DRAFT` is deliberately excluded (stale HITL state must not invite confirming an action the graph no longer knows). The per-widget budget is **measured, not estimated**: the first 64 kB figure was 7× too small — production logged a 473 kB Excalidraw payload — and is now 1 MB. Rehydating from the LangGraph checkpoint was rejected by measurement (LRU-capped registry, ~70/75 slots already used in production).
- **`is_system_skill` recomputed at read time, per user** — the flag grants `credentialless` + `allow-same-origin` and is never trusted from a persisted payload. `SkillsCache.entry_is_system` / `get_system_skill_names(user_id)` are the single predicate (`scope == "admin"`, the exact expression the DB sync already used), with the same override semantics as the write path: a user skill shadowing a system name must not have its widget re-promoted — a hole found by counter-review and pinned by test before it shipped.
- **Host-owned widget sentinels (ADR-137)** — `display/sentinel_filter.py` strips LLM-authored sentinel copies with `html.parser` (never a regex: sentinels nest `<div>`s) at three chokepoints: before canonical injection, in the ReAct history window (replaced by a placeholder — the imitation _prompt_ disappears and the tokens come back), and on the ReAct passthrough. `widget_sentinels_stripped_total{source}` tells whether the model still imitates instead of assuming it. Invariant pinned by test: N interactive widgets ⇔ N sentinels, proven non-vacuous by re-injecting the production duplicate.
- **User location for the skill runner** — `services/skill_location_context.py` resolves the position through the same `resolve_location()` chokepoint every location-aware tool uses (browser geolocation first, then home address) and feeds the versioned prompt's new `{user_location}` variable as a language-free `"lat,lon"` value; all wording lives in the prompt file, and the `"unknown"` sentinel coupling is pinned by test.
- **`frame.link_url` in the `SkillScriptOutput` contract** — the _user-facing_ URL for the fallback card, https-enforced like `url`. The Google Maps embed endpoint answers _"must be used in an iframe"_ when opened top-level; `render_map.py` now ships `google.com/maps?q=…` alongside it, and both fallbacks prefer it.
- **QUERY location phrases in both mirrors (6 languages)** — the frontend detector had no "where am I" category at all (backend had it, minus the imperative forms), so _"montre-moi où je suis"_ never triggered the just-in-time geolocation permission prompt. Both tables gain the imperative forms (`"où je suis"`, `"ma position"`, `"where i am"`, `"wo ich bin"`), and `GeolocationPrompt` reacts to the new category.
- **MCP-domain guard** (`services/analysis/skill_suppression.py`) — the analyzer LLM fills `domains` and `skill_name` in one output with no coherence guarantee, and the routing decider gave the skill absolute priority. The guard suppresses the detection when the _primary_ domain is an MCP domain, reusing the exact ADR-118 dialogue exemption the chat override applies (a mid-dialogue conversational answer keeps its dialogue skill; a fresh imperative request does not). Every suppression is logged and counted (`skill_detection_suppressed_total{reason}`).

### Fixed

- **Interactive map blank on every iOS browser** — `require-corp` + no `credentialless` in WebKit; verbatim engine message: _"Cancelled load … because it violates the resource's Cross-Origin-Resource-Policy response header"_. Root-caused on a Playwright bench with production headers replicated, engine × header matrix measured.
- **Widgets lost on reload or on the other device** — payloads were fed exclusively by the live SSE stream; verified in production: `message_metadata` carried only `run_id`/`intention`/`psyche_state`, and rendering real production content against an empty registry produced two grey error boxes and zero iframes.
- **Duplicate and phantom widgets** — production message `28eaa427` carried the same `data-registry-id` twice (two iframes mounted, byte-arithmetic reconciled to the stored length); two later replies embedded sentinels the backend never injected, pointing at a dead turn — one of them said "I don't have access to your position" _while displaying a map_.
- **Rehydrated widgets demoted on desktop** — the history filter read `is_system` on SkillsCache entries that only carry `scope` (the key exists only on the SQL table), so the system-skill set was always empty, every rehydrated frame lost its privileges, and the embed probe refused it ("Open in a browser"). The write path carried the same confusion with a permissive `True` default — a latent privilege escalation for user-imported skills, closed in the same change.
- **"Montre-moi où je suis" answered with maps of "ma position" and France** — the skill-bypass plan is empty (no tool runs, no collected data) and the sub-agent's four tools cannot resolve a position, so the model improvised search strings; it also ran the successful script twice (two widgets: the ADR-137 invariant faithfully rendered a double execution) and shipped its deliberation as the visible reply. The prompt now makes a successful script FINAL and the final message VERBATIM.
- **`resolve_location` silently dropped `LocationType.QUERY`** — the match had no branch for it, so "où suis-je" fell through to the "unreachable" `(None, None)`: no location _and_ no user-facing hint.
- **Diagram requests hijacked away from Excalidraw** — three consecutive production turns with `primary_domain=mcp_excalidraw` at 0.95 confidence were routed to `interactive-map`, then `skill-generator`, then a hallucinated `"mcp_excalidraw"` skill; only the third reached the MCP task, and only because the bypass failed on the non-existent name.
- **Dead fallback link** — "Open in a browser" opened the embed-only `frame_url`, which Google refuses top-level.
- **`react_result` dual-shape crash** — the state contract dict and the runner dataclass shared one `Any`-typed name; production run `117ce96f` died on `AttributeError: 'ReactSubAgentResult' object has no attribute 'get'`, collapsing the turn to a 98-character fallback. The runner branch now normalizes onto the single state contract, and the three annotations are `dict[str, Any] | None`.
- **Cross-turn skill-skip guard** — `_plan_already_produced_skill_app` scanned every past turn's results against a docstring that promised "the same turn": a widget produced at turn 47 silently suppressed the runner at every later turn (production run `d0fad28b`). Now scoped to the `{turn_id}:` prefix.
- **MCP frames rendered as a black slab in dark mode** — the iframe background was `--lia-bg`; an empty widget now shows the page through (`transparent`), on both widget families.
- **`Context type 'mcps' not registered` error-logged on every MCP tool result** — MCP manifests claimed `context_key="mcps"`, a context type that was never registered (MCP result shapes are heterogeneous per server), so the wave auto-save attempted a doomed save and error-logged it; the noise surfaced as soon as the MCP-domain guard let those turns reach the pipeline. The manifests now carry no `context_key` (the executor's designed no-context path); `"mcps"` keeps its display role (result cards, registry items) untouched.

- **`browser_screenshot_card_url` — SSE stream killed one statement before `done`** (CodeQL `py/uninitialized-local-variable`, the only `error`-level alert). Declared inside the `elif response_content.strip():` archive branch but read two levels up, in the done-metadata block. An assistant reply that streams no content skips that branch — there is no `else` — while the `if not hitl_interrupt_detected` guard above the read still passes. Declared next to `archived_assistant_msg_id`, at the level it is read from.
- **`interaction` — the HITL fallback crashed the request it was meant to rescue** (not reported by CodeQL; found with pyright). Assigned by the first statement of a `try` and read by that same try's handler, whose `except (AttributeError, KeyError, ValueError, RuntimeError)` does not catch `NameError`. Both `from_action_type` call sites take the same arguments, so a failure in one implies a failure in the other — the sentinel is declared ahead of both, and the handler now treats `None` explicitly via `suppress`.
- **Truncated `<style>`/`<script>` blocks leaked their raw body as prose**, on _both_ halves of the notification pipeline (`js/bad-tag-filter` on the frontend; invisible on the backend, where `py/bad-tag-filter` is excluded by config — the backend defect was established by executing both implementations, not assumed). These surfaces truncate, so a severed `<style>` keeps no `</style>`: tag-stripping removed the marker and a lock screen read `body{color:red;font-size:12px}`. The closing tag is now optional on both sides, with `(?<!/)` so a self-closing `<script src="x"/>` cannot swallow the document and a `\1` backreference so a `</script>` cannot close a `<style>`. Not an XSS on either side: output feeds escaped React children only.
- **FAQ `voice_mode` section rendered none of its six answers** — the key was absent from the section wiring in `FAQContent.tsx`.
- **A long conversation opened mid-history.** The component does not own its scrolling box (`scrollHeight === clientHeight` on its own node, so every `scrollTop` write is a no-op), and content keeps growing after first paint. `getScrollParent()` resolves the real scroller and the viewport is re-pinned for a 1500 ms window.

### Security

**The alert dashboard was not the perimeter.** A review of 15 code-scanning alerts and 5 advisories found **16 and 7** — and the two defects that actually broke behaviour were neither the `critical` nor the `high` ones. Alert #844 appeared mid-review, on code shipped the day before. Two advisories (`brace-expansion`, `js-yaml`) were in no dashboard at all — the first because _our own override_ pinned a vulnerable version. And a second `UnboundLocalError`, never reported by CodeQL, was found by auditing the class with a tool that could actually see it. What let this accumulate was a single flag: `pnpm audit` ran with `continue-on-error: true`, so a CRITICAL advisory lived on `main` for months under a green pipeline.

- **`pnpm audit` is blocking again** — `continue-on-error: true` removed from `security.yml`. That flag is how `websocket-driver` GHSA-xv26-6w52-cph6 (critical) survived on `main` under a green pipeline.
- **5 advisories patched via `pnpm.overrides`**: `websocket-driver` 0.7.4 → 0.7.5 (critical + moderate; production dependency via firebase but unreachable — only `firebase/app` and `firebase/messaging` are imported), `minimatch` 9.0.5 → 9.0.9 (3 high ReDoS, scoped `minimatch@9` so ESLint's 3.1.5 is untouched), `brace-expansion` → `^2.0.3` (our own override pinned the vulnerable 2.0.2), `js-yaml` → `^4.2.0`. `pnpm audit` goes from 5 findings to 1 low (dev-only, not executed).
- **CodeQL analysed every frontend test directory** — `**/tests/**` does not match `__tests__`, so 31 directories were scanned despite the stated intent, the origin of 9 of the 16 alerts. `**/__tests__/**` is now listed explicitly.
- **`SecuritySettings.algorithm` constrained to `Literal["HS256","HS384","HS512"]`.** The `CVE-2024-23342` pip-audit exemption claimed LIA "only verifies JWTs" — it signs them; what makes the ecdsa timing attack inert is HS256. `ALGORITHM` being a documented `.env` knob, the Literal is what stops a configuration change from silently invalidating a security exemption.
- **`lia_gender` cookie** gains `SameSite=Lax` and a protocol-conditional `Secure` (unconditional would drop it on a plain-HTTP dev origin).
- **`pyasn1` 0.6.3 → 0.6.4** (CVE-2026-59886, DoS via ASN.1 REAL float conversion) — the advisory landed the day of the release and the now-blocking `pip-audit` gate caught it before the tag went out: the flag removed in this very cycle did exactly what it exists for.

### Changed

- **The ReAct history window serves widget placeholders instead of raw sentinel markup** — the model no longer sees the pattern it was imitating, and the tokens the markup consumed come back.
- **The skill-runner prompt hardened** (versioned `skill_react_agent_prompt`) — a successful `run_skill_script` is FINAL (never re-run to "improve" a result; retry only after an explicit error, once), placeholder location strings are forbidden when `UserLocation` is `"unknown"`, and the final message is displayed VERBATIM (no narrated reasoning).
- **`widget_persist_max_bytes` default recalibrated 64 kB → 1 MB** — the original figure was reasoned from skill frames alone; production measured a 473 kB MCP widget being dropped, which resurfaced as "erreur de chargement de l'application" on every reload.
- **109 npm minor/patch updates**, with the root `vite` override realigned to 8.1.5. Dependabot does not read workspace-root overrides when bumping a workspace member, so its PR contradicted the override and could never pass `--frozen-lockfile` — a rebase clears the git conflict without fixing that.
- **6 GitHub Actions updated** (SHA-pinned).
- **`IntersectionObserver` test stub takes real constructor arguments** — 7 `js/superfluous-trailing-arguments` alerts came from CodeQL resolving the global to a stub with no constructor. The dropped callback is why `ChatMessageList.test.tsx` had to ship its own observer double. The `as unknown as` double cast is gone.

### Removed

- **8 dead `GuideLayout` exports** (`GuideSection`, `GuideSubSection`, `GuideP`, `GuideBold`, `GuideQuote`, `GuideTable`, `GuideList`, `GuideCode`) — `GuideToc` was the only one consumed.
- **A dead `return` in `rag_spaces/processing.py`** whose comment claimed mypy needed it for totality; mypy is clean without it.

### Documentation

- **ADR-136** (COEP posture + widget failure states) and **ADR-137** (host-owned sentinels + message persistence) — both carry their post-release complements: the measured engine × header matrix, the `is_system` vs `scope` defect with its glue-test lesson, the `link_url` contract, the boot-failure relay and the `document.open()` listener discovery.
- **ADR-075 / ADR-098 / `12_skills.md`** — the `frame.link_url` contract documented at its three homes; `GUIDE_DEBUGGING.md` and `GUIDE_MCP_INTEGRATION.md` already described `credentialless` — the code had drifted to `require-corp`, not the docs.
- `CI_CD.md` — Dependabot npm targets the workspace root, not `/apps/web` (the table was wrong); the two classes of unrebaseable Dependabot PR (pip lockfiles, override/workspace collision) are documented with the conduct to follow; the overrides table goes from 3 stale entries to the 14 real ones; CodeQL's `__tests__` blind spot is explained.
- `SECURITY.md` — how to read an advisory's real severity (`pnpm why --prod` from `apps/web/`, reachability), and the CodeQL remediation table gains the three rule classes met here.
- `AUTHENTICATION.md` — the `.env` example named three variables that do not exist (`JWT_SECRET_KEY`, `JWT_ALGORITHM`, `JWT_ACCESS_TOKEN_EXPIRE_MINUTES`); the real names are `SECRET_KEY` and `ALGORITHM`. New section on the HMAC constraint and what changing it would require.
- `NOTIFICATIONS_FLOW.md`, `VOICE.md` — block-element stripping with optional closing tag, and why the shared stripper makes it one fix for both surfaces.
- `CONVERSATION_HISTORY_PAGINATION.md` — initial positioning, the real scroll parent, and how the animated scroll used to race the pagination sentinel.
- `GUIDE_DEVELOPPEMENT.md` — new doctrine on possibly-unbound locals, including which tools detect the class (pyright) and which are blind to it (MyPy, Ruff).

#### Full documentation realignment (215 files audited, ADRs excluded)

Eight mechanically verifiable classes were audited with purpose-built detectors.
**Five of the eight detectors were wrong on first run** and were fixed before any
edit — one ignored the `apps/api/src/` prefix (136 false positives), one matched the
word "task" inside prose, one counted `node_exporter` metrics as ours, one confused
settings with metrics, one missed FastAPI's multi-line decorators, one never read the
"Tables complémentaires" section. Acting on their first output would have "fixed" a
sound codebase. Each was validated against a known-true case, and every correction
re-measured afterwards.

**Operationally dangerous defects — they mislead during an incident:**

- **`RedisConnectionPoolExhaustion.md`** instructed operators to edit
  `REDIS_POOL_SIZE`, `REDIS_POOL_MAX_OVERFLOW` and five more variables **that do not
  exist**. The only real knob is `REDIS_MAX_CONNECTIONS`. Editing a phantom variable
  mid-incident feels like acting.
- **Three alert runbooks cited metrics their own rule does not use** —
  `pkce_validation_failures_total` where the rule reads
  `oauth_pkce_validation_total{result="failed"}`, plus `AgentsRouterLatencyHigh` and
  `AgentsStreamingErrorRateHigh`. A wrong PromQL name returns nothing, **silently**.
- **`AgentsRouterLatencyHigh.md`** told operators to change `ROUTER_MODEL` in `.env`;
  models live in the database (`LLM_TYPES_REGISTRY`), and no such variable exists.

**Configuration that no longer matched the code:**

- **LLM API keys** were documented as `.env` entries across three guides, while the
  encrypted `provider_api_keys` table has been the sole source of truth since
  `migrate_env_keys_to_db` (March). Operators were setting ignored variables.
- **`SCHEDULED_ACTIONS_ENABLED` does not exist** — yet **`CLAUDE.md`** listed it among
  the feature flags, and two guides documented it. Scheduled actions are always wired.
- **~25 phantom environment variables** corrected or flagged: `HEARTBEAT_*` (4 wrong
  names), `MCP_EXCALIDRAW_*` (5, never implemented), Langfuse "Phase 3.1" features (3,
  with a non-existent `ab_testing/` module), `FCM_NOTIFICATIONS_ENABLED` → `FCM_ENABLED`,
  `MCP_APPS_MAX_HTML_SIZE` → `MCP_APP_MAX_HTML_SIZE` (singular), `ROUTER/PLANNER_MESSAGE_WINDOW_SIZE`,
  `VOICE_WAKE_WORD_ENABLED`, `OTEL_EXPORTER_OTLP_PROTOCOL`, `NEXT_PUBLIC_ENVIRONMENT`.
  `DATABASE_URL_SYNC` was documented as settable — it is a computed property.

**API routes — 25 corrections.** `GET /users/me` → `/auth/me`; `PATCH /users/me` →
`/users/{user_id}`; `/conversations/history` → `/conversations/me/messages`;
`/auth/password-reset/request` → `/auth/request-password-reset`; `/events/stream` →
`/notifications/stream`; `POST /chat` → `/agents/chat/stream`; `/app/tools/call` →
`/app/call-tool`; `/admin/mcp/servers` → `/mcp/servers`. Three endpoints do not exist at
all and now explain the real mechanism instead: `POST /conversations` (created implicitly
on first message), `/conversations/{id}/approve-plan` and `/reject-plan` (the HITL
decision travels through the chat stream), `/admin/system-settings/voice-mode`.

**Prometheus metrics.** `llm_calls_total` → `llm_api_calls_total`,
`llm_cost_usd_total` → `llm_cost_total`, `llm_tokens_total` → `llm_tokens_consumed_total`,
`langgraph_agent_node_duration_seconds` → `langgraph_stage_duration_seconds`,
`voice_duration_seconds` → `voice_tts_latency_seconds`. Metrics with no counterpart are
flagged in place — including four HITL ones `HITL.md` advertised as "kept for backward
compatibility" while they had been deleted.

**Clean by measurement:** zero invalid `task` command out of 121; zero dependency-version
drift (the single hit was a false positive comparing the `redis` Python library to the
`redis:7.4-alpine` image); zero phantom table — `DATABASE_SCHEMA.md` covers **50 of 50**
tables once `phone_calls` was added.

**Table-of-contents navigation was broken on ~30 documents — 199 anchors repaired.**
GitHub turns `## 🎯 Vue d'Ensemble` into `#-vue-densemble`: the emoji vanishes but the
space that followed it becomes a **leading dash**. The links omitted it, so every entry
in those tables of contents was dead. `AUTHENTICATION.md` got it right, which served as
the known-true case to prove the rule before touching anything. Four headings had also
been renamed without their links following.

**Two `docker` commands named containers that do not exist**: `docker logs lia-api-1`
(a compose-v1 generated name) and `docker logs lia-alertmanager` — the real ones carry a
`-dev`/`-prod` suffix, as `README_ALERTING.md` already did correctly.

**Clean by measurement, second batch:** 126 mermaid blocks, zero syntax anomaly; every
other container and compose service cited across the docs resolves.

**`ADR_INDEX.md`** now warns that 8 of its 135 file references point nowhere: `ADR-001`
and `ADR-002` under `docs/architecture/`, `ADR-003`–`ADR-006` under a `docs/archive/`
directory that does not exist. `git log --diff-filter=A` is empty for all of them — they
were never written, not deleted. Real ADR numbering starts at **ADR-007**, though other
documents cite the missing numbers ~68 times.

### Removed (documentation)

- **`docs/readme/README_WORKFLOW.md`** (1165 lines) — deleted rather than repaired, after auditing every section for content that was unique, true, and unavailable elsewhere. There was none. It described four workflows that no longer exist (`code-quality.yml`, `tests.yml`, `mixin-tests.yml`, `codeql.yml` — 403 lines) and ignored the three that do; its `ci.yml` section documented 3 of the 12 real jobs and prescribed `pip install -e ".[dev]"`, the exact opposite of ADR-112; it listed three deployment secrets that exist in no workflow while missing `TEST_FERNET_KEY` which does; its "global env vars" were wrong and missed `URLLIB3_NO_OVERRIDE`; its local-testing commands invoked `vulture` (not a dependency) and `ruff format` (never used here) while labelling Black "legacy" — Black being the canonical formatter enforced by the pre-commit hook; and three of its five suggested badges pointed at deleted workflows. A previous release had already "aligned it with reality" (see 1.21.x); it drifted again. `CI_CD.md` covers the subject correctly, and the duplication is what allowed the drift. History keeps the file.

### Tests

- **12,434 backend tests collected** (713 files, +92) and **2,219 frontend tests across 217 files** (+44); six ratchets at baseline, i18n parity across the 6 locales, MyPy strict clean on 914 files.
- **`FakeStreamingService` realigned on the production contract** — the streaming characterization double lacked `persistable_widgets`, which the archive path now reads (ADR-137); the drift surfaced as 8 CI failures in the agents suite, the one the fast pre-commit hook does not run. Mocks must carry the public attributes of what they replace.
- **The rlimit CPU-spin bound accounts for wall-vs-CPU drift** — RLIMIT_CPU counts CPU time while the assertion measures wall time; a loaded shared runner descheduled the spin to 8.2 s where the +5 margin allowed 8. The bound is now +10, still strictly below the 20 s subprocess timeout — the oracle (killed by SIGXCPU, not by the timeout) is unchanged.
- New suites: `test_system_skill_predicate.py` (through the **real loader** on a temp tree — the pure-function tests with synthetic frozensets are exactly what let the `is_system`/`scope` confusion ship), `test_sentinel_filter.py` (14 cases incl. nested divs and truncated sentinels), `test_widget_sentinel_invariant.py` (non-vacuity proven by re-injecting the production duplicate), `test_skill_location_context.py`, `test_skill_suppression.py` (the three production hijacks verbatim), `test_message_widgets.py`, plus the frontend watchdog/fallback/relay groups.
- **A Playwright bench replayed the real 450 kB production Excalidraw payload through the real airlock shell** with a faithful host emulation (progressive drip included): rendered on Chromium and WebKit, iPhone-emulated, light _and_ dark — refuting the dark-theme hypothesis with screenshots. The same bench with a deliberately broken payload proved the boot-failure relay on both engines, and caught two design errors before ship: a static iframe loses the `load` race a JSX-attached listener never loses, and `document.open()` erases the Window's listeners.

## [1.25.10] - 2026-07-20

> **Notifications stop leaking markup, and a long conversation opens where you left it.** A user reported reading `<div class="lia-response"><h2>` on a push notification. The wrapper was only the visible half. Scheduled-action notifications were built from the _token stream_ rather than the canonical post-processed content, so the push could disagree with the message the same click opens in chat — and a `<psyche_eval` tag split across two chunks could reach a lock screen. Tracing that leak surfaced a second one nobody had reported: Material Symbols icons render their **ligature name** as element text, so a data card read "event Déjeuner avec Marie" — and the voice engine, sharing the same stripper, _read "event" aloud_ before the sentence. Hardening the stripper then exposed the opposite failure: detection accepted a lone `<tag`, and single-letter element names collide with ordinary prose, so `if x<a and b>c` was silently mutilated into `if xc`. Separately, opening a long conversation landed the reader mid-history: the initial scroll was animated, and while it played the pagination sentinel was still on screen, fired a prepend, and the prepend suppressed the scroll-to-bottom — the longer the conversation, the wider the window and the more reliable the failure. Every fix here is pinned by a test **proven to fail without it**; two guards that could not be made to fail were deleted rather than shipped as false assurance, and one performance finding was **retracted** after re-measurement showed it was a lazy-import artifact, not backtracking.

### Added

- **`domains/agents/display/plain_text.py`** — the single place that answers "is this markup, and what does it read as in plain text?". Shared by the TTS engine and every notification surface, which have the same constraint: a voice that speaks `<div>` aloud and a lock screen that displays it are the same defect. Detection accepts markup on three signals — a matched tag pair, a void element (`<br>`, `<hr>`, `<img>`), or a tag carrying an attribute (which keeps a _truncated_ document detected).
- **`plain_text_for_notification()`** (`infrastructure/proactive/notification.py`) — flattens HTML, then Markdown links to `label (url)`, then collapses to the single line a notification body actually is. Callers must truncate _after_ it: truncating raw HTML cuts mid-tag and spends 26 of the default 150 characters on `<div class="lia-response">`.
- **`toPlainPreview()`** (`apps/web/src/lib/notification-preview.ts`) — the client-side half of the same guard, applied uniformly to the three toast families. Produces text rendered as escaped React children; it is a legibility helper, never a sanitizer.
- **`scheduled_action` notification titles** in `ProactiveMessages`, in the 6 languages.
- **`SCHEDULED_ACTIONS_SSE_PREVIEW_MAX_LENGTH`** — the SSE preview cap, previously a bare `500` at the call site.

### Changed

- **The scheduled-action executor consumes `content_replacement`**, the chunk carrying the canonical post-processed content (HTML cards, photo injection, psyche-tag cleanup), replacing the accumulated tokens exactly as `stream_chat_response` already did for archiving. The two had silently diverged.
- **The push budget follows `PROACTIVE_NOTIFICATION_MAX_LENGTH`** instead of a hardcoded `150` that happened to match it.
- **Initial chat positioning moved into a layout effect and made instant.** The container's `scroll-smooth` class animates every programmatic scroll — a plain `scrollTop` assignment included — so it is neutralised inline for the jump and restored immediately. Deliberately not `scrollIntoView({ behavior: 'instant' })`: `behavior` is a WebIDL enum, and a browser whose `ScrollBehavior` lacks `instant` throws a `TypeError` that, inside a layout effect, takes the whole conversation down.
- **`SCHEDULED_ACTIONS.md` corrected against the code** — it documented a Telegram dispatch and a Redis `SchedulerLock` that the executor does not have (the lock was removed as F003; it throttled a 60-second job to one run per five minutes).

### Fixed

- **Raw HTML in scheduled-action notifications**, on both surfaces: the FCM push body (rendered verbatim by the service worker) and the SSE toast description (rendered as escaped React children).
- **Notification content diverging from the archived message** — the body was built before post-processing, so the push and the chat could tell different stories, and a `psyche_eval` tag split across token chunks escaped the streaming-level filter documented as partial.
- **Material Symbols ligature names leaking as prose** — `<span class="material-symbols-outlined">event</span>` kept its text through the stripper. Fixed in the shared module, so the notification body and the **voice engine** are both clean; the latter was a pre-existing defect unrelated to the reported one.
- **Prose destroyed by over-eager HTML detection** — `if x<a and b>c`, `count<b et total>i` and `vector<i> v; map<p,tr> m;` were all treated as markup and stripped. Pre-existing on the TTS path; the notification work would have widened its blast radius.
- **Chinese users receiving English scheduled-action titles** — the executor kept a private table keyed `"zh"` while `User.language` is backend-canonical `"zh-CN"`, reproducing exactly the bug ADR-131 had already fixed elsewhere.
- **A long conversation opening mid-history instead of at its last message.**
- **Mixed German typography** in the how/why/story guides — 17 quotations opened with `„` and closed with a straight `"`.
- **Stale ADR counts in `how.zh.md`** — two occurrences said 124 while three others in the same file already said 128.

### Tests

- **12,342 backend tests collected** (705 files, +49) and **2,175 frontend tests across 215 files** (+28); frontend coverage 60.6 / 55.0 / 54.6 / 61.1, above every ratchet.
- New suites: `test_notification_plain_text.py` (detection, flattening, icon ligatures, linear scaling), `notification-preview.test.ts` (including `lastIndex` statefulness of the `g`-flagged patterns), and the initial-positioning group in `ChatMessageList.test.tsx`.
- `test_i18n_proactive.py` now **iterates the title table** instead of a hand-maintained tuple, and asserts every task type covers all 6 supported languages — the previous list would have silently skipped `scheduled_action`.
- Every fix was falsified by re-injecting the defect and confirming the matching test dies. Two guards survived that check and were **removed**: an `isPositioned` gate on the pagination observer (redundant — layout effects run before passive ones) and an ordering assertion that measured effect declaration order rather than the guard it claimed to protect.

## [1.25.9] - 2026-07-20

> **The frontend stops being the untested half — and the tests find real defects.** Frontend coverage was the oldest open finding of the audit (F010): 35.4 % of statements, 29.3 % of functions, with the data layer, the connector hooks and the whole voice/push chain simply mocked out of existence. This release closes it by risk rather than by file count — 40 new suites and 31 extended ones, **+645 tests in the new files alone**, bringing the suite to **2,147 tests across 214 files** and coverage to **60.5 / 54.9 / 54.5 / 60.9** (functions nearly doubled). The point was never the percentage. Writing tests that drive the real code instead of a mock surfaced **six production defects that no suite could have caught before**, each fixed at the source and pinned by a test proven to fail without its fix: two races in the connector preferences, an unguarded bulk-OAuth queue, a defensive branch the effects crashed before it could render, an unanchored auth route match, and a type that lied about what the backend actually sends. The accessibility work went the same way — the image viewer became a real modal dialog, and the review of that very change caught it stealing focus from keyboard users on every parent re-render. What did not change: no threshold was lowered, no rule suppressed, no oracle weakened. One coverage lock that had been calibrated from the wrong population (14.7 points of slack on functions) was tightened, and vitest's uncalibrated 5-second per-test default was measured and raised so a correct-but-slow test stops being reported as a failure.

### Added

- **Frontend test coverage, risk-first** — 40 new suites over the data layer
  (file upload, chat SSE transport, notifications, scheduled actions, memories,
  MCP servers, skills, journals, RAG space documents), the session boundary
  (`lib/auth`), the admin broadcast provider, the FAQ page, the admin sections,
  the connector provider hooks (three of which sat at 0 %), and the voice/push
  chain (WebSocket transport, push-to-talk state machine, FCM enrolment).
- **`waitForHydration` E2E fixture** (`apps/web/e2e/fixtures/hydration.ts`) —
  closes a **silent** failure class: a server-rendered form is fillable and
  clickable before React attaches its handlers, so submitting performs a native
  GET and the application logic never runs. No error, no request — the click
  simply does nothing. Production builds hydrate almost instantly, which is why
  this passes in CI and fails locally, until a slow runner makes it flake there
  too.
- **Focus trap and modal semantics on the shared image viewer** — the overlay is
  now a `dialog` named after the picture, takes focus on open, keeps Tab inside
  and returns focus to the thumbnail that opened it. `aria-modal` previously
  announced a containment nothing enforced.
- **Typed test helpers** — `mutateSpy()` / `setDataSpy<T>()` / `takeUpdater()`
  (`src/__tests__/api-mocks.ts`) and the `makeMessage` / `makeAttachment` /
  `makeLLMPricing` / `makeUsageLimitsUser` factories, so optimistic-update
  reducers can be proven without a single escape cast (rule F057).

### Changed

- **Coverage ratchets re-measured and tightened** — the global floor rises
  35/33/29/35 → 60/54/54/60, and eight per-area locks were added or raised. One
  existing lock (`settings/connectors/**/*.tsx`) had been derived from the whole
  directory aggregate — a different population from the one it guarded — leaving
  **14.7 points of slack on functions**; it is now measured on its own subset.
  Every lock was verified to sit within ~3 points of measured, and the tightened
  one was falsified (raised above measured) to prove the glob actually matches.
- **`testTimeout` calibrated to 15 s** (vitest default: 5 s, never examined
  here). The settings mega-forms drive real `userEvent` typing at ~29 ms per
  keystroke; under full-suite parallelism with coverage instrumentation that
  stretches ~5×, and the heaviest creation test ran 1.0 s alone yet timed out
  past 5 s in the full run — a passing test reported as a failure. Worst case
  measured across the suite is ~3.3 s. Same treatment already applied to
  `teardownTimeout`.
- **Node pinned to 24 across host, CI and Docker** — `engines.node` raised to
  `>=24` with `engine-strict=true`. The pre-commit hook runs on the host, so a
  drifting local Node silently stops reproducing CI; the install now fails
  instead.
- **`AdminUsersSection`'s row type renamed `AdminUserRow`** — `@/lib/auth`
  already exports a `User` with a different shape, and the test had to alias the
  import to tell them apart.

### Fixed

- **A connector preference load could overwrite what the user had just chosen** —
  the GET issued on mount resolved after the optimistic local write and clobbered
  it. Local edits now claim their value, and the claim is released on rollback so
  a still-in-flight load may legitimately fill the hole.
- **The same preference was requested twice** — `preferencesLoaded` can only be
  raised once the response is in, leaving the in-flight window unguarded; a
  parent re-render carrying a new `connectors` array (the optimistic add/remove
  produces one) re-entered and fired a second request.
- **The bulk-OAuth queue could silently drop a connector** — the redirect-resume
  pass and a user-initiated run both read-modify-write the same `localStorage`
  key; overlapping, the resume popped the entry the fresh run had just parked.
  The two are now mutually exclusive.
- **The image viewer stole focus from keyboard users** — introduced by the modal
  work in this very release and caught in review: the focus effect depended on
  `onClose`, an inline arrow at all five call sites, so every parent render (a
  streaming chat message renders constantly) yanked focus off whichever control
  the user had reached. The keyboard listener and focus ownership are now
  separate effects.
- **The message list's defensive branch was unreachable** — it renders an error
  card when `messages` is not an array, but the effects above it run first and
  crashed on `messages[0]` before the card could show.
- **The auth-page skip list matched by prefix** — `/^\/([a-z]{2}\/)?(login|register|oauth-callback)/`
  would have silently disabled the session check for any future route merely
  starting with one of those words (`/login-help`, `/register-invite`). No
  current route is affected; the anchor keeps the list a deliberate choice
  rather than a naming accident.
- **`PsycheHistoryEntry.trait_snapshot` misdeclared its own payload** — the index
  signature admitted numbers only, while the backend writes `active_emotions` as
  an emotion→intensity map. Consumers were reading it through casts; the type now
  mirrors what `PsycheService.process_post_response` actually persists, and the
  casts are gone.
- **Two backend unit tests failed intermittently under `-n auto --dist loadscope`**
  — surfaced by this release's gate runs: one full run clean, the next with two
  failures on identical code. The DB redirection installs a **process-wide**
  psycopg URL override (deliberately never undone) that `resolve_psycopg_url()`
  consults _before_ `settings`, so a test asserting the `settings → pool URL`
  contract by patching `settings` alone is silently handed the Testcontainers
  URL — if and only if that xdist worker had already run a DB-backed test.
  A new `psycopg_url_from_settings` fixture neutralizes the override for the
  duration of a test and, crucially, **restores** it: the three helper tests
  previously ended on `set_psycopg_url_override(None)`, which does not undo the
  override but destroys it, pointing every later DB test in that worker at the
  developer database. Proven by simulating a contaminated worker: identical
  failure signature without the fix, green with it.
- **Seven FAQ changelog versions had never rendered** — `v1_15` and `v1_20_17`
  through `v1_20_22` were written and translated into all 6 locales (so i18n
  parity passed) but were missing from the hardcoded `changelogVersionKeys`
  array that decides what the accordion displays. The same class had already
  hit `v1_21_8`/`v1_21_9` once. A new guard
  (`faq/__tests__/changelog-wiring.test.ts`) now fails on drift in **either**
  direction — content without wiring, or wiring without content — and also
  pins each entry's declared item `count` against the items actually written.
  It found these seven the first time it ran.
- **Dead code and stale contracts** — an unused `getEmotionalLabel` carrying five
  hardcoded French strings (a live namesake exists elsewhere), a `setIsSubmitting`
  in an error path the parent had already unmounted, a duplicated JSDoc block, and
  a doc pointer to a backend method that does not exist.

### Tests

- **2,147 vitest across 214 files** (40 new suites, 31 extended), coverage
  **60.49 / 54.86 / 54.50 / 60.94** (from 35.40 / 33.54 / 29.25 / 35.83).
- **26/26 hermetic Playwright** (Chromium smoke + axe journeys), including new
  browser-level assertions on the viewer's tab cycle — `user-event` only
  approximates tab order under jsdom.
- Every regression test in this release was **proven to fail against the
  unfixed code** before being kept; one that passed on both sides was deleted
  rather than shipped as false assurance.
- Static gates unchanged and green: `tsc --noEmit --incremental false`, ESLint,
  Prettier, and the a11y / react-hooks / complexity ratchets — all three sitting
  at exactly their baseline, with zero slack.

## [1.25.8] - 2026-07-19

> **Proactive notifications stop repeating themselves — and start saying something concrete.** A user report ("it's always the same interest, and the remarks are flat") turned into a measured investigation: over 45 days of production, **~14 of 20 interest-flavoured heartbeats centred on the same subject**, near-daily, and not one ever named an actual film, article or event. The causes were structural, not stylistic (ADR-135). First, the interest sample injected into the decision prompt was **hardcoded top-30%-by-weight**: the same handful of topics at every tick, ignoring the subject machinery ADR-131 had just built — the model could not rotate away from a fixed list. Second, the anti-redundancy window held 5 notifications (under two days) and exposed only _which sources_ fired, never _what was said_ — so the model had no way to know it had proposed the same thing ten evenings running; a bench proved this directly, watching it pivot away from one motif straight into another it had used the day before, sourced from memories. Third, the context injected topic **names only**: with no material, "have a look at a recent release" is the best any model can produce. The fix is mechanical where it can be and prompted only where it must: a subject-diverse sample (one interest per subject, least-recently-served first), a unified cross-flow ledger so a theme covered by _either_ proactive flow steps aside — with an explicit boundary keeping each flow's quota budget its own — a content-level anti-repetition window (10 notifications / 7 days, excerpts included, rule operating on topics rather than sources), and on-demand enrichment that fetches real facts through the existing content pipeline and names them, with deterministic source links. Every mechanism was benched on production data before a line was written; the schema risk was retired at 8/8, and the enrichment chain proved out end-to-end.

### Added

- **Subject-diverse interest sampling for heartbeat context** (ADR-135) —
  `pick_varied_sample` (in `domains/interests/selection.py`, reusing the ADR-131
  subject machinery) returns one interest per subject, subjects ordered
  least-recently-served first with the RNG only breaking exact ties. Extracted
  into `domains/heartbeat/interest_context.py` so the aggregator shrinks rather
  than grows (823 → 799 logical SLOC).
- **Unified cross-flow mention ledger** — an interest-centred heartbeat writes
  an `InterestNotification(source="heartbeat")` row, carrying the content
  embedding, so both proactive flows see the subject as served. The boundary is
  explicit and tested: eligibility queries (daily quota, global cooldown, runner
  pacing, cross-type burst check) exclude these rows via the new optional
  `EligibilityChecker.notification_filter` / `cross_type_filters`; selection,
  rarity, content dedup and GDPR erasure include them.
- **On-demand interest enrichment** — when the decision centres on an interest,
  real content is fetched through `InterestContentGenerator`
  (Perplexity → Brave → Wikipedia) under a hard timeout and deduplicated against
  that interest's recent notification embeddings, then injected as a VERIFIED
  FACTS block with a "name 1-2 concrete items, never invent, no raw URLs"
  contract; deterministic source links are appended afterwards. Fail-open at
  every step.
- **Five `.env` knobs** (`HEARTBEAT_INTEREST_SAMPLE_SIZE`,
  `HEARTBEAT_RECENT_WINDOW_COUNT`, `HEARTBEAT_RECENT_WINDOW_DAYS`,
  `HEARTBEAT_INTEREST_ENRICHMENT_ENABLED`,
  `HEARTBEAT_ENRICHMENT_TIMEOUT_SECONDS`) and the
  `heartbeat_enrichment_total{outcome}` metric (success | empty | error |
  disabled) so the fail-open rate is measurable in production.

### Changed

- **Anti-redundancy operates on content, not sources** — the window grows to 10
  notifications over 7 days and renders content excerpts; the decision prompt
  gains a two-level rule (source level, then topic/product/activity level,
  explicitly cross-source). A bench showed the content view is what unlocks real
  pivots: 2 notifies out of 4 runs versus 0 out of 7 without it.
- **Decision structured output extended and constrained** — `interest_topic`
  (copied verbatim from the injected sample, validated at runtime with a
  fail-open guard that drops anything else) and `sources_used` typed by the new
  `HeartbeatSourceLabel` Literal. The Literal is deliberately confined to the
  LLM output: the history API keeps `list[str]` so rows predating this release
  still serialize, pinned by a regression test.

### Fixed

- **Brave-served interest notifications were audited as "custom"** — 141 rows
  over 60 days carried the wrong source because `_map_source` never learned
  `"brave"`; every per-source statistic was skewed. `ContentSource.BRAVE` added
  and mapped.
- **FAQ and knowledge base claimed stale proactive values** — global cooldown
  advertised as 2h (actual: 1h) and "10 data sources" where the aggregator
  exposes 8; corrected in the 6 locales and in `docs/knowledge/`.
- **Telegram shutdown logged a spurious error on every restart** (out of scope,
  fixed in passing) — `Application.stop()` was called unconditionally while the
  webhook path never starts the application, producing an ERROR with a traceback
  at each dev restart. Guarded by `running`, with two regression tests.

### Tests

- ~30 new tests: varied sample (7, seeded RNG), extended decision schema (3 +
  legacy-serialization guard), content window (3 + updated contract test),
  eligibility filters (7, both directions plus defaults-unchanged), unified
  ledger (4, including embedding symmetry), enrichment (6, including fail-open,
  dedup symmetry and the metric), brave mapping (1), Telegram shutdown (2).
- Runtime proven in dev Docker: subject-diverse sample whose ordering matches
  the real serving timestamps, served subject stepping aside, full
  decision → enrichment → message cycle producing named facts with clickable
  sources, and the metric exposed on `/metrics`.

## [1.25.7] - 2026-07-19

> **The agentic core becomes visible, controllable, and honest about its failures.** LIA's most consequential moments — the ones where it acts on your behalf — were the least tangible: an approval was a sentence you had to type, the work behind an answer vanished the instant the reply began, and a broken connector surfaced only as a vague apology. This release turns each of those into something you can see and act on. **Approval cards** put a one-tap Confirm / Cancel — and now **Modify** — under any pending action, riding a deterministic structured decision that skips the LLM classifier entirely (byte-for-byte parity with the conversational path, fail-closed on any stale click); the typed and voice channels stay fully live beside them. The **execution trace** that used to be wiped at the first answer token now survives the response as a collapsed "N steps · Xs" line under the bubble, expandable into the grouped backstage — the same honesty the cost-per-message already gave, extended to _what LIA actually did_. When a tool breaks because a connector's OAuth access expired, an **actionable "Reconnect" banner** now appears in the chat, classified from typed exceptions (never string-matched) and linking straight to the fix. The **onboarding** stops being a slideshow: its pages now complete the tour and jump you into connecting a service or trying a real example. Along the way a cluster of latent HITL defects — each proven red before being fixed green — was closed: a clarification you cancelled used to loop forever, a cancelled run left an orphan pending interrupt, a stale detection cache mis-served the resume path, the tour re-opened on every navigation, a rejected OAuth refresh was mislogged as a decryption failure, and a resolved approval card lingered on screen after its outcome had already been spoken.

### Added

- **HITL approval cards (ADR-132)** — a pending action (tool confirmation,
  draft validation, destructive or FOR_EACH confirmation) renders a card above
  the input with backend-driven one-tap buttons. A structured `hitl_decision`
  rides the normal send and maps deterministically to the resume payload — no
  classifier call (`classifier_bypassed`), byte-for-byte parity with the
  natural-language path, fail-closed (`hitl_decision_stale`) on any
  stale/mismatched click. The card rehydrates after a reload via
  `GET /agents/hitl/pending`; the typed/voice reply channel stays fully
  functional beside it, in both Pipeline and ReAct modes.
- **Inline draft edit (ADR-132)** — the draft card's _Modify_ button opens an
  instructions field that routes the live modification loop (structured edit,
  classifier bypassed) and re-presents the revised draft for validation.
- **Execution trace per message (ADR-133)** — the agentic steps and live
  reasoning, previously wiped at the progress→answer flip, are captured and
  attached to the message: a collapsed "⚙ N steps · Xs" line under the answer
  expands into the steps grouped by category plus the reasoning. Session-only,
  100% frontend, no SSE contract change.
- **Actionable connector error notices (ADR-134)** — when a tool fails on a
  connector's expired or revoked OAuth (a typed `ConnectorTokenExpiredError`,
  or a 401/403 from the provider — classified by exception type, never by
  message text), a "Reconnect" banner appears in the chat and links to the
  connector settings; a 429 surfaces a rate-limit notice instead. New
  `connector_error_notices_total` metric; `HITL_DETECTION_CACHE_TTL_SECONDS`
  knob.
- **Actionable onboarding pages** — the connectors page gains a _Connect my
  services_ button and the examples page turns each command into a tap that
  prefills the chat (never auto-sent); both complete the tutorial first, then
  navigate.

### Changed

- **Execution trace line sits bottom-right** of the assistant bubble.
- **Resolved approval cards clear at end of turn** — a confirmed, cancelled or
  typed-reply card disappears once the reply lands (the answer is the
  feedback); an expired card stays until the next message.
- **Voice agent opening and spoken dates refined** — the telephony assistant
  opens without waiting for the callee's first turn, and states dates without
  the year the way people speak them.

### Fixed

- **The clarification loop was inescapable** — cancelling a clarification
  ("no, forget it") now aborts to a response instead of re-asking forever
  (new abort branch, conditional edge, self-cleaning flag; proven end-to-end).
- **A cancelled run left an orphan pending interrupt** — a cancelled background
  run now clears `pending_hitl` (a killed run preserves it, on purpose).
- **The HITL detection cache was never invalidated** — extracted to
  `utils/hitl_cache` with invalidation at the `HITLStore` save/delete
  chokepoint, bounded by the new TTL knob.
- **Onboarding re-opened endlessly** — finishing or skipping the tour now
  persists completion, so the dashboard layout stops re-mounting the dialog on
  every navigation.
- **A rejected OAuth refresh was mislogged as "decryption failed"** — the
  `invalid_grant` path now raises a typed `ConnectorTokenExpiredError` that
  reaches the agent layer intact instead of being swallowed by a broad
  `except`.

### Tests

- ~135 new unit and integration tests plus two hermetic Playwright journey
  specs: reducer transitions (HITL card lifecycle, execution-trace attach/cap,
  connector notices), SSE handler capture and interception, the approval-card /
  trace-disclosure / reconnect-banner / onboarding components, the
  structured-decision mapping matrix (confirm/cancel/edit parity, fail-closed),
  the connector-error-notice classifier, and the pending-HITL lifecycle. Every
  latent fix landed red-then-green; each feature was runtime-validated in dev
  Docker (approval click with `classifier_bypassed`, trace after a real run,
  reconnect banner on a deliberately corrupted token, draft edit re-presented,
  card cleared after resolution). Three new ADRs (132–134); frontend
  complexity, accessibility and file-size ratchets held without a raise.

## [1.25.6] - 2026-07-18

> **Interest notifications learn variety — every mechanism validated by measurement before a line of code.** Production data showed the problem was not the draw (already uniform) but pool composition: one perceived subject (AI), fragmented into 9 of 19 interests, captured ~50% of notifications. Three benches on the real prod snapshot settled the design (ADR-131): an embedding-cosine "semantic cooldown" was **refuted** (topic-embedding space is compressed — a false pair scores higher than a true one; only ≥ 0.95 is reliable), incremental LLM subject labeling was **refuted** (order-dependent drift, 89% agreement, one aberrant merge), while **batch** labeling measured 98.2% stable — so the `subject` label became derived data, recomputed wholesale by a scheduled job, never assigned at extraction. A 300-run simulation validated against production (uniform simulated 47.9% vs ~50% measured) picked variant **V5**: subject cooldown, then rarity draws at both the subject and interest level — the dominant family falls to ~33% and starvation drops from 0.8 to 0.3 interests/30 days, with fail-open at every stage and an instant `uniform` rollback knob. Along the way the audit closed real holes: the extraction dedup path silently disabled itself when embedding generation failed (how "Anthropic"/"anthropic" both existed), manual renames could collide or keep stale labels, and a nightly retro-merge (≥ 0.95 only — the measured reliable zone) now heals history while repointing the notification audit trail. Notifications also gained **deterministic source hyperlinks** (never LLM-generated — zero hallucinated URLs): markdown links in chat, a readable text conversion for FCM/Telegram. And a long-standing i18n bug died: proactive notification titles were keyed `zh` while `User.language` is backend-canonical `zh-CN` — Chinese users had been silently receiving English titles.

### Added

- **Subject-based variety selection (ADR-131)** — interests carry a derived
  `subject` label (nullable = "needs clustering"); selection groups candidates
  by subject, freezes recently notified subjects
  (`INTEREST_SUBJECT_COOLDOWN_HOURS`, 36h — a sibling in per-topic cooldown
  freezes its whole subject), then draws subject and member by rarity
  (`p ∝ mean_weight^β / (1+recent)^γ`, intra-subject `1/(1+recent)^γ`).
  Pure, injected-RNG implementation in `domains/interests/selection.py`;
  fail-open at every stage; `INTEREST_SELECTION_MODE=uniform` is the
  rebuild-free rollback.
- **Batch LLM subject clustering job** — one `interest_extraction`-typed call
  per user labels all active interests at once (index-keyed JSON protocol,
  defensive fail-open parsing): stale scan every 30 min (subject IS NULL) +
  nightly full re-cluster at 04:15 self-heals label drift. Incremental
  (per-extraction) labeling was empirically refuted and deliberately avoided.
- **Deterministic source hyperlinks in notifications** — citations from
  Perplexity/Brave/Wikipedia are appended after LLM presentation as markdown
  `[domain](url)` links (i18n label ×6, cap `INTEREST_SOURCES_MAX_LINKS`,
  0 disables); `markdown_links_to_plain` converts them to "domain (url)" for
  FCM push and Telegram (HTML-escaped surfaces).
- **Nightly retro-merge of duplicate interests** — case/whitespace variants and
  near-identical topics (cosine ≥ `INTEREST_MERGE_SIMILARITY_THRESHOLD`, 0.95)
  merge into the strongest row: signals summed, activity timestamps maxed,
  BLOCKED status preserved, notifications repointed (audit trail and rarity
  counts survive), subject reset for relabeling.
- **12 new `.env` knobs** for selection mode, subject cooldown, rarity
  exponents, lookback window, re-clustering cadence/batch, merge threshold,
  source-link cap and subject label length — plus **4 Prometheus metrics**
  (`interest_selection_total`, `interest_subject_recluster_total`,
  `interest_merge_total`, `interest_selection_eligible_subjects`).

### Changed

- **Interest selection docstrings and repository honesty** — `select_target`
  documents both modes (the historical "top 20%" claim was config-dead);
  `get_all_for_user` gains a deterministic `ORDER BY created_at DESC` and stops
  claiming a weight ordering SQL cannot produce; `InterestResponse` exposes the
  read-only `subject` field.
- **Interest content prompt** — source names are woven into the text but raw
  URLs are forbidden (clickable links are appended deterministically instead);
  the French `"Aucune"` fallback in English prompt scaffolding became
  `"(none)"`.
- **Proactive notification titles centralized** (`core/i18n_proactive.py`,
  `ProactiveMessages`) — replaces the inline per-task-type table in the
  dispatcher, per the backend i18n systemic rule.

### Fixed

- **Chinese users received English notification titles** — the dispatcher's
  titles table was keyed `zh` while `User.language` is backend-canonical
  `zh-CN`; the lookup silently fell back to English for every proactive title.
  Now served from `ProactiveMessages` with a zh-CN regression test.
- **Extraction dedup silently disabled on embedding failure** — when
  `generate_interest_embedding()` returned None at creation time, no check ran
  at all against interests that had embeddings (the hole that produced the
  "Anthropic"/"anthropic" production duplicate); the string fallback now
  applies whenever either side lacks a vector.
- **Topic renames bypassed dedup and kept stale subjects** — the extraction
  UPDATE action now consolidates into an existing case-insensitive topic match
  instead of renaming onto a duplicate, and any topic change (extraction or
  manual router update) resets the derived subject label for re-clustering.

### Tests

- ~40 new tests: pure selection algorithm (cooldown/fail-open/rarity
  statistics, seeded RNG), 30-day distribution regression (dominant subject
  < 40%, ≤ 2 starved interests), clustering parser robustness, duplicate-pair
  resolution (transitive chains), repository merge with real-database
  notification repointing (integration), source-link block (6 languages),
  zh-CN title regression, settings wiring. Migration `0ef84488b15c` passes the
  replay-from-zero gate; runtime validated in dev Docker (33 real interests
  clustered by the live LLM, selection dry-run, metrics exposed on `/metrics`).

## [1.25.5] - 2026-07-17

> **The phone assistant becomes trustworthy — and the planner learns to converge.** A full day of live-call debugging turns the agentic telephony feature from a promising prototype into a disciplined agent. On the call itself: the assistant now greets the instant the line opens (an empty first message caused a multi-second silent standoff), knows what day it is (a `current_datetime` anchor — "tomorrow" was being resolved to the wrong weekday out loud), speaks with a pinned French-capable voice over telephony-native `ulaw_8000` audio (the vendor's documented garble cause), runs on a **pinned thinking-free LLM** (the platform default, gemini-2.5-flash, was caught reciting its English reasoning aloud mid-call), and **hangs up** when the goal is met (the `end_call` system tool was never actually enabled). Above all it now has a **mandate boundary**: it never accepts an unrequested expense or commitment — even a 3€ cheese topping — it captures the offer and its price, defers to the user, and the post-call summary is required to be complete: every cost stated, every open point flagged for a call-back with instructions. Around the call, the machinery self-heals: the vendor agent re-syncs lazily on config drift (no more deactivate/reactivate), a stuck "call already active" row is closed by probing the vendor (including the deleted-agent 404 case, with a grace window so a freshly dialed call is never killed), and a deleted vendor agent is diagnosable in one log line. The second act is deeper: the "crée le rdv" follow-up after a call kept producing a next-hour default slot instead of the agreed Saturday 9:30 — the enriched context was correct, but the planner never _received_ its facts where models actually read them. Resolved facts now ride in the planner's **human message**; the semantic validator finally validates **single-step mutations** (they were skipped as "trivial" — the whole class was unguarded), survives a structured-output quirk with a one-shot retry (the prompt's last line contradicted the tool mandate: 0/3 → 6/6 tool calls after an A/B-proven fix), rejects fabricated placeholder contacts deterministically (RFC 2606 — `jane.doe@example.com` invented as an attendee), and when a replan is needed the planner is finally shown **its own previous plan** with a fix-don't-rebuild directive (it used to oscillate — fixing the date on one pass, losing it on the next). The last net: an invalid **mutation** plan that exhausts its replans is never silently executed anymore — LIA asks the user instead.

### Added

- **Instant greeting at pickup** — a short localized `first_message` (identity
  only, 6 languages) plays the moment the call connects; the LLM then continues
  with the objective and a first concrete question at the callee's first
  response. Closes the silent-standoff at call start (empty first message: agent
  and callee each waiting for the other) without reintroducing the
  stops-after-intro bug of a long static disclosure.
- **Temporal anchor for the voice agent** — a `current_datetime` dynamic
  variable (user timezone + language) plus a prompt rule to resolve every
  relative expression against it and restate dates absolutely out loud;
  objectives and post-call summaries are also required to use absolute dates
  ("samedi 18 juillet", never "demain" — an archived "tomorrow" goes stale).
- **Mandate boundary for calls** — the voice agent never accepts costs,
  upsells, substitutions or commitments beyond the stated objective (even
  small ones): it captures the exact offer and price, declines to decide, and
  announces a call-back. Two new structured fields (`additional_costs`,
  `pending_user_decision`) flow into the post-call synthesis, whose summary
  must state every cost and surface every deferred point with a
  how-do-you-want-to-proceed question.
- **Six deployment knobs for the vendor voice agent** (`.env`) —
  `TELEPHONY_AGENT_LLM_MODEL` (pinned `gpt-4o-mini`; the platform default is a
  thinking model observed leaking its English reasoning into speech),
  `TELEPHONY_AGENT_TTS_MODEL_ID` (flash v2.5 — required for non-English
  agents), `TELEPHONY_AGENT_VOICE_ID` (multilingual voice; the default English
  voice garbled French), `TELEPHONY_AGENT_AUDIO_FORMAT` (`ulaw_8000` both
  directions — Twilio's telephony-native format), `TELEPHONY_DEFAULT_COUNTRY_CODE`
  (national → E.164 dialing), `TELEPHONY_PROBE_NOT_FOUND_GRACE_SECONDS`.
- **Lazy vendor-agent re-sync** — the full agent config (prompt, greeting,
  voice, LLM, formats, data collection) is fingerprinted; any drift triggers an
  in-place PATCH on the next call. Prompt or settings changes no longer require
  deactivating/reactivating the connector.
- **Self-healing one-active-call guard** — a row stuck without its end-of-call
  webhook no longer blocks calls until a reaper tick: the guard probes the
  vendor conversation status inline and closes ended (`ended_no_webhook`),
  vanished (`conversation_gone` on 404, after a grace window that protects
  freshly dialed calls) or stale rows itself.
- **Planner receives its facts where models read them** — the
  analyzer-resolved facts (dates, people, places) now ride in the planner's
  human message with authority + language constraints
  (`services/planner/human_message.py`), on all four planning paths
  (single/multi-domain strategies + service fallbacks), with an
  anti-recurrence test forbidding any hand-rolled bare query message.
- **Replan convergence** — on a validation replan the planner is shown its own
  previous plan with an "apply ONLY the named fixes, keep everything else
  byte-for-byte" directive. Observed prod failure: it fixed the date on one
  pass and lost it on the next, because it was regenerating from scratch
  against a delta-only feedback.
- **Single-step mutation validation + safety net** — single-step plans were
  skipped as "trivial" by the semantic validator, leaving every one-shot
  create/update/send unguarded; they are now validated (reads stay exempt,
  `place_phone_call` stays draft-gated at zero extra cost), and an invalid
  mutation plan that exhausts its replans routes to a HITL clarification
  (questions synthesized from the localized issues) instead of being executed
  by the max-iterations bypass.
- **Deterministic fabricated-contact guard** — plan parameters carrying an
  RFC 2606 reserved-domain email (`…@example.com`, `.invalid`, `.test` as the
  final label) in a non-free-text mutation parameter are rejected pre-LLM with
  replanning feedback (resolve via a contacts step or omit); look-alike real
  domains (`test.com`, `invalid-corp.fr`) never false-positive.

### Fixed

- **Voice agent recited its English directives aloud** — the vendor-side LLM
  was never pinned and the platform default (gemini-2.5-flash, a thinking
  model) leaked its reasoning into speech on a real French call; the agent LLM
  is now explicitly pinned (PATCH contract verified against the vendor API).
- **"Un appel est déjà en cours" after a hung-up call** — deactivating the
  connector mid-call deletes the vendor agent _and its conversation_, so the
  end-of-call webhook could never arrive and the active row blocked calls for
  the full 15-minute stale threshold; a 404 conversation probe past the grace
  window now closes the row immediately.
- **Validator crashed open on deepseek** — the validation prompt's last line
  ("Respond in {language}") frontally contradicted its own never-answer-in-free-text
  mandate: the model froze into an empty answer (no tool call), 3/3 crashes
  reproduced, and the fail-open fallback silently passed invalid plans. The
  line now scopes the language to the tool payload's text fields (3/3 tool
  calls after the fix, A/B-proven) and a one-shot retry absorbs the residual
  empty-answer rate, with `raw_output_length` logged for the next diagnosis.
- **Follow-up "crée le rdv" created a wrong default event** — the full chain
  above (facts in human message + single-step validation + convergence +
  safety net); the prod failure sequence (three invalid plans, then the
  max-iterations bypass executing the wrong one) is closed at every link.
- **Vendor API errors were undiagnosable in prod** — `elevenlabs_api_error`
  now logs the truncated vendor detail (which names the offending field);
  the sync-PATCH 400 that kept the prod agent on a stale config was
  root-caused this way in one log line.
- **HITL confirmation fields glued on one line** — a deterministic stream
  normalizer inserts hard breaks (`<br/>`) into the critique stream
  (cross-chunk safe) instead of trusting the LLM to reproduce template tags;
  draft success details are hard-broken likewise.
- **Contact resolution misses** — provider search hits are unwrapped from
  their `{"person": …}` envelope (all three providers), the E.164
  `canonicalForm` is preferred over display formatting, national numbers gain
  the configured country code, and planner-appended annotations
  ("Léa Lemoine (my wife)") are stripped on an exact-first retry.
- **"call my wife" rejected as bulk operation** — FOR_EACH heuristics now
  match on word boundaries (the substring "all my" inside "c[all my]" tripped
  the bulk detector).
- **Telephony connector UX** — the whole configuration is one screen (key →
  validate → number → webhook secret → single Activate), editing the key
  invalidates the loaded numbers, call history stays visible after a
  disconnect (calls belong to the user, not the connector), and disconnecting
  invalidates the server-side connector cache (it used to keep serving the
  connector as active for up to 5 minutes).

### Changed

- **`telephony_agent` becomes the 56th admin-configurable LLM type** — the
  telephony domain is routable end-to-end (registry, router filtering under
  its feature flag, dedicated agent builder, admin UI label in 6 languages).
- **Validation domain models extracted** (`orchestration/validation_models.py`)
  and the planner human-message builder extracted
  (`services/planner/human_message.py`) — both under the file-size ratchet
  doctrine (caps only shrink, never bump).

> **The Grafana fleet becomes complete, readable and honest.** A full review of the observability dashboards — every one of ~590 panel queries executed live against the production Prometheus, every metric definition cross-referenced by AST against the code — followed by a complete remediation. Coverage first: **all 419 code-defined metrics are now referenced by at least one panel** (76 were orphaned, including three entire families of features running blind in production: Journals, Telephony, Today Briefing — each gets a dedicated dashboard, 23/24/25). Honesty second: error-rate recording rules returned _empty_ when there were **zero errors** — the healthiest state rendered as "No data" on the most-watched panels; seven rules now synthesize an explicit 0 (`or vector(0)`), and a nuanced `noValue` convention distinguishes a true zero (event counters) from a never-computed ratio (`n/a`) while core-throughput panels keep their silence as an outage signal. One real instrumentation corpse: `checkpoint_load_duration_seconds` had **never been emitted** — the wrapper instrumented `aget()`, a convenience helper the LangGraph runtime never calls (it calls `aget_tuple()`), and the tests patched a method the parent class doesn't even define; the override moved to the real entry point with a regression-locking test. Readability closes the pass: ~550 generated-then-reviewed panel descriptions (from the metrics' own help strings and recording-rule comments), sparse-histogram windows matched to each source's real cadence, Loki panels that survive zoom-out, the duplicate dashboard number resolved (Compaction moves to 22, deduplicated from the LLM-cost board), and the Langfuse row explicitly labeled as disabled-in-prod. Verified end-to-end: 0 query typos / 0 errors against both prod and dev, all 25 dashboards provisioning-loaded and visually checked in Grafana.

### Added

- **Three new dashboards for previously-blind active features** —
  `23 - Journals & User Model` (extraction volume/duration/errors, entry
  lifecycle by action/theme, consolidation levels & promotions, portrait age /
  feedback / injections), `24 - Telephony` (terminal call statuses, durations,
  T1 recovery reapers, HMAC-filtered webhooks), `25 - Today Briefing` (build
  duration by cache state, per-section outcomes, LLM invocations, refreshes).
- **Ten collapsed coverage rows on existing dashboards** — background runs
  ADR-117 + semantic layer ADR-120/121 (param-guard blocks, evidence expansion,
  leak detection/autocorrection) on 07; **per-stage TTFT latency breakdown**
  (`langgraph_stage_duration_seconds`, the LATENCY_PLAN instrument) + graph
  errors + reasoning-stream double-call guard on 15; tool-module import
  failures (a family-silently-missing detector, red above 0) on 16; LLM-cache
  cost savings + pricing-cache fallbacks on 05; OAuth deep metrics (callback
  errors, initiate/activation durations, refresh-lock lifecycle, API-key
  verification) and contacts/email query shapes on 10; attachments deep +
  registrations by provider on 09; conversation-repository health on 14; RAG
  job-reaper recoveries on 18; ingestion duplicates on 21. **Metric coverage:
  419/419** (from 343/419), recording-rule transitivity included.
- **Panel-rendering conventions** (documented in `GRAFANA_DASHBOARDS.md`) —
  nuanced `noValue`: `"0"` on rare-event counters (no series genuinely means
  zero events), `"n/a"` on ratios whose denominator can be empty (a 0 would
  claim a measurement that never happened), and **never** on core-throughput
  metrics whose absence must stay visible; quantile windows matched to source
  cadence (`[1h]` for sparse families, `increase[1d]` for the once-a-day
  histogram); systematic descriptions with an explicit "Empty panel = zero
  events in the window (healthy)" note on rare-event timeseries.

### Changed

- **Compaction dashboard consolidated as `22 - Compaction`** — resolves the
  duplicate `14-` numbering, absorbs the redundant compaction section from
  `05 - LLM Tokens & Cost`, and gains a 24h health headline (executions,
  truncation fallbacks, errors, writer-unavailable — red thresholds) plus the
  per-chunk LLM call duration and token cost-vs-savings panels.
- **~550 panel descriptions generated then reviewed** from the Prometheus help
  strings in the code and the recording-rule comment blocks — every panel now
  explains what it measures and how to read an empty state; the Langfuse row
  on 15 is explicitly titled "requires LANGFUSE_ENABLED — currently off in
  prod".
- **Sparse-histogram quantile windows widened** (55 queries) — RAG, voice,
  compaction, OAuth, HITL for-each, sub-agents, browser P50/P95 panels no
  longer blank out at long time ranges on a low-traffic deployment; Loki
  panels move from a fixed `[1m]` to `[$__auto]` (error logs were invisible
  at 7-day zoom); `user_daily_conversations` quantiles move to
  `increase(...[1d])` (observed ~once a day — structurally empty before).
- **`GRAFANA_DASHBOARDS.md` v4.4** — full 01-25 catalogue with real panel
  counts (it claimed "22 dashboards" in the header, "20" in the key-figures
  table and "18 files" in the file list simultaneously), rendering conventions,
  and the `or vector(0)` recording-rule doctrine.

### Fixed

- **`checkpoint_load_duration_seconds` never emitted (dead instrumentation)** —
  `InstrumentedAsyncPostgresSaver` overrode `aget()`, which the LangGraph
  runtime never calls: checkpoint loads go through `aget_tuple()`, and the
  base-class `aget` merely delegates to it. The instrumentation (duration
  histogram, operation counter, error categorization) moves to `aget_tuple`
  with the parent's exact signature — removing a return-type annotation that
  contradicted the parent, masked by `typing_cast` + `type: ignore`. The tests
  patched (and thereby created) a method `AsyncPostgresSaver` doesn't define,
  exercising a phantom path; they now patch the real parent method, and a
  regression test locks the entry point (`aget_tuple` overridden, `aget` not
  shadowed, convenience path instrumented transitively). The
  `checkpoint_load_duration:p95_5m` recording rule also aggregated by a label
  this histogram never carried.
- **Error-rate recording rules empty in the nominal state** — with zero 5xx
  (resp. zero DB errors, zero planner fallbacks, zero cache misses…) the
  numerator selector matched no series and `http_error_rate:5m`,
  `api:slo:error_budget:burn_rate_1h`, `db:slo:error_rate:5m`,
  `planner_filtered_cache_hit_rate:5m`,
  `planner_domain_filtering_low_confidence_rate:1h` and
  `business:tool_rejection_rate:1h_by_tool` rendered "No data" instead of 0
  on the Overview, SLO and HTTP boards — for `db:slo:error_rate` the empty
  numerator even emptied the denominator through vector-matched addition.
  Fixed with `or vector(0)` (label-preserving `or … * 0` where the rule
  groups by label); `promtool` green on all 86 rules.
- **Loki error panels empty at wide time ranges** — five panels queried
  `rate({job="api", level="error"}[1m])` with a fixed 1-minute log range:
  sparse error bursts fell between long-range sampling steps (verified against
  prod: ~700 error lines over 7 days, all invisible at default zoom).

### Tests

- Backend: **10,270 fast unit tests green** (15 checkpoint-metrics tests, of
  which a histogram-count oracle and the aget/aget_tuple regression lock);
  ruff + black (1,674 files) + mypy strict (897 files) clean.
- Observability: live audit executed against **production and dev Prometheus**
  (~665 queries incl. Loki): 0 metric typos, 0 query errors, 0 template-variable
  problems; 25/25 dashboards provisioning-loaded (Grafana API) and visually
  verified (health stats render 0-green, repaired burn-rate stat renders 0.00,
  new Journals board renders live dev data).

## [1.25.3] - 2026-07-16

> **The prompt layer gets a full engineering pass.** A senior-level review of all 84 versioned prompts (directives, robustness, LLM cache management) followed by a four-batch remediation. The headline fix: the HITL classifier's few-shot examples were **never reaching the LLM** — the `{{...}}` sentinel was de-escaped by `.format()` before the `.replace()` ran, so every approve/reject/edit classification shipped with a literal placeholder instead of ~2,800 tokens of action-type examples; a brace-free `[[...]]` sentinel plus real-file oracle tests close the class for good. The structural work: a **provider-agnostic prompt-cache convention** — static content first, one canonical `--- DYNAMIC CONTEXT ---` marker, per-request content after — generalized to 34 system prompts and enforced by shrink-only CI guards. The planner (the pipeline's most expensive prompt) goes from ~3% to **77% byte-stable cacheable prefix**; the infra layer owns provider specifics (Anthropic `cache_control` split, OpenAI `prompt_cache_key`, implicit prefix caches), so models can be swapped per prompt with no template change. Governance closes the rest: two orphaned prompts deleted, the `PromptName` Literal now bidirectionally synced to the files by CI, the emotional-safety directive extracted to versioned files with a sentinel-coupling lock, and HITL confirmation questions now follow the user's **personality** instead of a hardcoded sarcastic register.

### Added

- **Prompt-cache convention (provider-agnostic)** — every dynamic system prompt
  separates its static prefix from per-request content with the canonical
  `DYNAMIC_CONTEXT_MARKER`; templates stay model-neutral while the infra layer
  handles provider specifics. Reorganized accordingly: `smart_planner_prompt`
  (static rules first, 77% stable prefix, byte-identical across requests),
  the 4 ReAct prompts, all 17 domain-agent prompts, `memory_extraction`
  (runs on every user message), `interest_extraction`, `heartbeat` ×2,
  `initiative`; fully-static prompts (`compaction`, `semantic_validator`)
  opt in via a terminal marker.
- **CI guards for the prompt layer** (`tests/unit/domains/agents/prompts/`) —
  `test_prompt_cache_hygiene` (shrink-only `MARKER_REQUIRED` list, no active
  placeholder before the marker outside justified `ALLOWED_BEFORE_MARKER`
  exceptions, planner prefix byte-stability), `test_prompt_name_literal_sync`
  (Literal ↔ files, both directions), `test_memory_directive_sentinel`
  (emotional-safety literal coupling can no longer drift silently).
- **`memory_danger_directive` / `memory_normal_directive`** — the psychological
  -profile behavioral directives move from inline Python constants to versioned
  prompt files, per the prompts-in-files rule.

### Changed

- **Anthropic caching fallback inverted** (`factory.py`) — a system prompt
  without the marker no longer gets best-effort `cache_control` (it paid the
  125% cache-write premium on every call without ever hitting); OpenAI
  `prompt_cache_key` extraction (`responses_adapter.py`) now recognizes ONLY
  the canonical marker (literal tag mentions like `<TemporalContext>` in
  static rules no longer truncate the prefix at 12%).
- **HITL confirmation voice follows the personality** — `hitl_question_generator`
  and `hitl_plan_approval_question` derive their register from the injected
  personality (light/witty default preserved) instead of hardcoded
  "cynical genius / Bored/Sarcastic" tones; examples explicitly labeled as
  structure + default tone.
- **Language directives use human-readable names** ("French" instead of "fr")
  in the planner and ReAct prompts, matching the response prompt; language-keyed
  lookups in `prompts/__init__.py` now route through the central
  `normalize_language` chokepoint (a frontend-style bare `zh` no longer falls
  back to French).
- **Prompt hygiene** — 9 HTML doc-comment headers stripped from prompt files
  (dead tokens on every call); `PromptName` Literal resynced (3 ghosts removed,
  13 real files added); prompt docs realigned (`PROMPTS.md` caching doctrine,
  `GUIDE_PROMPTS.md` structural rule, `ROUTER.md`, `SMART_SERVICES.md`,
  `ARCHITECTURE_AGENT.md`, langfuse README, RouterLatency runbook);
  `CLAUDE.md` zh/zh-CN layer rule corrected (backend-canonical `zh-CN`,
  frontend `zh`, single chokepoint).

### Fixed

- **HITL classifier few-shot examples never injected** — `.format()` de-escaped
  the `{{EXAMPLES_PLACEHOLDER}}` sentinel before the `.replace()` ran, so the
  replace never matched: the classifier ran without its action-type examples
  and the LLM saw a literal placeholder. Brace-free `[[EXAMPLES_PLACEHOLDER]]`
  sentinel (replaced after `.format()`, as the examples contain single braces)
  - end-to-end oracle tests on the real files.
- **Two orphaned prompts deleted** (~3,500 tokens of dead weight) —
  `router_system_prompt_template.txt` (routing merged into QueryAnalyzer at
  the R1 latency optimization) and `smart_planner_multi_domain_prompt.txt`
  (superseded by the unified planner prompt), plus the call-free
  `get_smart_planner_multi_domain_prompt()` wrapper.
- **Flaky performance test** — `test_massive_history_truncation_performance`
  failed cold in isolation (one-off tiktoken BPE load counted inside the
  100ms budget) while passing after warm neighbors; an explicit warm-up call
  outside the measured window makes it deterministic (pre-existing defect,
  proven on HEAD).
- **Prompt copy defects** — duplicate rule numbering in `briefing_greeting`
  (a commented-out tone rule reinstated), version tag `(v1.17.2)` and `10h`
  francism removed from `heartbeat_decision`, garbled sentence-limit rule in
  `voice_comment` rephrased.
- **Release CI: qemu SIGILL on the arm64 web build** — the cross-arch Docker
  build (arm64 image emulated on the amd64 runner) flakily killed Next.js
  parallel static-generation workers (`qemu: uncaught target signal 4`),
  failing the release twice. Structural fix: `Dockerfile.prod` sets
  `NEXT_BUILD_CPUS=1` under emulation only (buildx `TARGETARCH != BUILDARCH`),
  which `next.config.ts` maps to a single build worker +
  `staticGenerationRetryCount: 3`; native builds keep full parallelism.

### Tests

- Backend: **10,232 fast unit + 971 agents tests green**; 14 new guard tests
  (cache hygiene, Literal sync, memory sentinel, HITL injection oracles,
  language normalization); full Docker boot + healthcheck verified; assembly
  proof: 78 prompts loaded, 31 restructured templates formatted with their
  exact call-site keys.

## [1.25.2] - 2026-07-16

> **The landing page now speaks the product's language.** Two-stage public-site overhaul, shipped with an executable zero-information-loss contract. First the hero: the old generic chat window becomes a **faithful miniature of the real app** (real user-left/assistant-right layout, live conversation token/€ bar, a request that visibly types itself in, Send morphing into Stop mid-stream) cycling through **four true acts** — parallel orchestration held by the HITL approval gate, a cross-domain proactive initiative carried through to the rescheduled event, a real **agentic phone call** (approval first, live call, written summary card), and a **skill mini-app forged in chat** from a voice request; while LIA "thinks", a glass pane reveals the **orchestration backstage** (an honest styling of the real debug panel / SSE execution steps) with live token/€ counting — pacing tuned for reading (glass 7–8.5 s, every note ≥ 4.5 s). Then the page: the 35-card features wall gives way to a **five-chapter narrative opened by LIA's own chat bubbles** (_LIA gets it done · LIA knows you · LIA notices before you · Nothing leaves without you · LIA grows with you_), each chapter carrying 3–4 benefits, a discreet "under the hood" line, a visual that **decomposes the hero animation** (backstage vignettes staged on scroll — never duplicating its four acts), and an **expandable catalog preserving every detailed feature card** (SEO-safe: collapsed content stays in the DOM). Commodities condense into one confident band ("And everything else, obviously."), trust gets a dedicated section (_LIA has nothing to hide_: per-message cost to the cent as a brand motif, the public 8.3/10 audit, open source, the AI-written/human-directed story) with a mid-page CTA at peak trust, the four personas become **four tabbed day-in-the-life timelines** (16 lived scenes), screenshots + the 15-slide deck merge into one tabbed gallery, and the engineering numbers move to "Under the hood" where their audience lives. Fully **transcreated in 6 languages** (never literally translated), WAI-ARIA tabs/disclosures, chapter scroll-spy rail, reduced-motion faithful.

### Added

- **Hero animation "backstage glass" (4 acts)** — `landing/mockup/` (timeline engine,
  app frame, per-act renderers, backstage figures); 72 i18n keys ×6; decorative
  `role="img"`, static act-1 render under `prefers-reduced-motion`; timeline +
  i18n-contract + behavioural render tests (32 tests).
- **Editorial landing narrative** — `landing/editorial/`: `chapters-data.ts`
  (single source of truth + `REQUIRED_FEATURE_KEYS` contract), 5 chapter
  sections with LIA-bubble titles, backstage vignettes (FOR*EACH fan-out,
  mail×agenda spark, skill forge — reusing the mockup keyframes, paused until
  scroll via `ScrollStage`), complementary chat scenes (morning briefing, HITL
  \_edit* round-trip), per-chapter expandable catalogs reusing the existing
  `landing.features.*` copy ×6, basics band with its own catalog, transparency
  section, 4-profile day timeline, tabbed gallery (`embedded` mode on the two
  carousels), chapter rail with scroll-spy, rewritten final CTA (LIA gets the
  last word), 6th real use case (telephony). ~175 new i18n keys ×6.
- **Anti-regression guards** — `editorial-content-coverage.test.ts`: the chapter
  catalogs + basics must form an exact partition of the 36 canonical feature
  cards (title/description/icon present ×6 locales — dropping a card now
  requires editing the contract); editorial i18n contract (referenced keys
  exist ×6, purged keys stay purged, `how_it_works.*` kept alive for the HowTo
  JsonLd); WAI-ARIA keyboard tests for the tabs and disclosures.

### Changed

- **TechSection** hosts the engineering-numbers strip (ex-proof tiles: agents,
  tools, providers, voice languages, tests, ADRs, releases) — re-targeted at
  its actual audience; `UseCasesSection` leads rewritten with featured bookends;
  header/footer/skip-link anchors repointed to `#features`; hero chevron
  follows. Sections whose content was re-homed are deleted (`ProofSection`,
  `HowItWorksSection`, `FeaturesSection`, `AudienceSection`, `RexSection`,
  `SecuritySection`) — their copy lives on in the chapters, catalogs,
  transparency band and day timeline.
- **Blog listing LCP** — the first visible row of cards now eager-loads its
  illustrations (`priority` prop on `BlogCard`), silencing the Next.js LCP
  warning on `/blog`.

### Fixed

- **`click` 8.3.1 → 8.4.2** (both universal lockfiles) — clears PYSEC-2026-2132
  (command injection in `click.edit()`); shipped earlier on main, credited here.
- **Dead `#how-it-works` footer anchor** repointed to `#features`.
- **ScrollStage effect** rewritten observer-only (no direct setState in effect
  body) — the strict react-hooks ratchet stays green.

### Tests

- Frontend: **1,303 vitest green** (56 new: mockup timelines/render 32,
  coverage+i18n contract 15, tabs/disclosure keyboard 9); clean
  non-incremental `tsc`; ESLint clean; a11y (0), react-hooks and complexity
  ratchets hold; strict 6-locale key parity (guard script green).

## [1.25.1] - 2026-07-16

> **Security hardening — audit Lot 1 remediation, transparent and zero-regression.** First wave of fixes from an independent security audit conducted on 2026-07-13. Every finding was verified against the real code before remediation (no material false positive); **no feature was removed** — each fix is a pure reinforcement shipped with tests and an executable anti-recurrence guard. Verified: Ruff + Black + MyPy strict + tsc + ESLint clean, 10,188 backend unit + 1,278 vitest + 27/27 hermetic deploy tests green, disclosure endpoint served live.

### Security

- **SEC-012 — credentials no longer reach the logs.** The central structlog PII
  filter now pseudonymizes opaque OAuth `state`/CSRF tokens (correlatable, non
  reversible), strips the values of sensitive URL query parameters
  (`?token=`/`?code=`/…) from any logged link, and redacts PKCE/`client_secret`/
  `id_token` fields — covering all ~34 `state=` log sites systemically. The
  verification/reset email logs also stop passing the signed URL (defense in
  depth). Guard: behavioral tests in `test_pii_filter.py`.
- **SEC-017 — RAG upload route-escape closed.** `apps/web/.../rag-upload/[spaceId]`
  rejects any non-UUID `spaceId` with `400` before reading the body or building
  the upstream URL, so an encoded `..%2f…` can no longer retarget another
  backend route. Guard: `route.test.ts` (no upstream request on rejection).
- **SEC-022 — version drift removed.** The root endpoint and OpenAPI schema now
  advertise the release version (`settings.app_version`) distinctly from the
  stable `/v1` API-contract constant, instead of a single confusing `1.0.0`.
  Guard: `test_version_consistency_guard.py`.
- **SEC-023 — working disclosure channel.** Added an RFC 9116
  `/.well-known/security.txt` and rewrote `SECURITY.md` to correct the supported
  versions (`1.x`), route reports to GitHub Security Advisories, and drop
  unverified control claims. Guard: `test_security_disclosure_guard.py`
  (future `Expires`, no dead domain / fictitious versions).
- **SEC-025 — HSTS on the frontend.** The public HTTPS responses now carry
  `Strict-Transport-Security` in production (env-tunable `HSTS_MAX_AGE`, starting
  short, without `includeSubDomains`/`preload`). Guard: `csp.test.ts`.
- **SEC-013 — production `.env` permissions hardened.** The deploy driver enforces
  `0600` on the remote `.env` inside a `0700` directory (plus the Claude CLI
  credentials) right before `docker compose up`. Guard: hermetic Pester test in
  `deploy-prod.Tests.ps1`.

## [1.25.0] - 2026-07-16

> **Audit V11 — fully revised framework, register cleared, and a test/CI foundation hardened at the root.** The technical audit moved to a **normalized framework**: 24 areas mapped to **ISO/IEC 25010:2023**, evaluated under **ISO/IEC 25040:2024** (architecture per ISO/IEC/IEEE 42010:2022, test processes per ISO/IEC/IEEE 29119-2:2021, structural quality per ISO/IEC 5055:2021, accessibility controlled against **WCAG 2.2 AA**), each score backed by **at least three executed evidence points**, a dedicated counter-analysis of false positives/negatives, and a plain arithmetic mean — **8.3/10 (199/240)**, security explicitly out of scope. Scores are **not comparable** with the pre-revision grid (8.5/10): the framework got stricter, and this very release closed **every previously-open major and minor finding** — the register now holds **7 moderate worksites (AC-001…AC-007), 0 major, 0 minor**, each published with evidence, closure criteria, effort and a ready-to-run resolution prompt. Full standalone report versioned at `docs/audit/AUDIT_CODEBASE_2026-07-16_CONSOLIDE_V11.html`; public summary and revised protocol in `docs/audit/`.

### Added

- **Audit V11 publication** — standalone HTML report (opinion, 24-area scorecard, executed-evidence register, positive controls, worksites with AI resolution prompts, counter-analysis, prioritization horizons, annexes) + rewritten public summary (`docs/audit/README.md`) + `AUDIT_PROTOCOL.md` aligned on the revised framework (anchored 0.5-step scale, arithmetic mean over 24 normalized areas, AC-numbered findings with major/moderate/minor levels and E1–E5 efforts, counter-analysis stage, dated referentials incl. WCAG 2.2).
- **Process-wide test-database redirection** (`tests/conftest.py::_redirect_process_db`) — integration tests now redirect _every_ DB entrypoint (settings, the module-level engine behind `get_db_context()`/`get_db_session()`, the LangGraph checkpointer & store pools via a new injectable `psycopg_pool_config` helper) to the test database, with a `DevDatabaseAccessError` guard that fails loudly on any developer-DB connection while Testcontainers is active. Contracts pinned in `test_db_redirection_contract.py` + `test_psycopg_pool_contract.py`.
- **Session-scoped LangGraph table provisioning** (`_provision_langgraph_tables`) — the checkpointer/store `CREATE INDEX CONCURRENTLY` migrations run once per session via the sync savers, when no test transaction is open; in-test `setup()` becomes a version check. Kills a whole-run freeze (server-side DDL deadlock against the per-test outer transaction) — regression pinned by a bounded test proven red/green.
- **Launcher-environment isolation** — `tests/conftest.py` scrubs every key declared in the repo-root `.env` before loading `.env.test`: the task runner's `dotenv: [.env]` no longer leaks the developer environment into test processes (observed: a ships-dark semantic-expansion flag rerouting 7 tests; `DEFAULT_CURRENCY=EUR` + a real currency API converting cost assertions at the **live** exchange rate). Contract proven red under simulated contamination (`test_env_isolation_contract.py`); shared pricing/semantic caches also reset around every test (`test_state_reset_contract.py`).
- **Testcontainers on Windows, at full speed** — `tc_host_override` forced to IPv4 loopback automatically (no manual env var) + URL normalization: the ~30× slow doomed-IPv6-first path is gone (measured 105.8 s → 3.5 s for 2 DB tests). Contract tests hold on Linux CI too.
- **`DATABASE_CONNECT_TIMEOUT`** setting — libpq/psycopg connection-establishment bound on the LangGraph pools (defense in depth against stalled TCP handshakes on freshly published Docker ports), shared through the new `psycopg_pool_config` helper (DRY conninfo + kwargs for checkpointer and store).
- **E2E dashboard-shell mocks** (`apps/web/e2e/fixtures/dashboard-shell.ts`) — 9 type-correct endpoint mocks (config, personalities, connector health, psyche, usage limits, voice ticket, RAG spaces) installed by `authenticate` under spec-level mocks; the 501 catch-all still fails any undeclared call loudly. The voice ticket deliberately answers 403 — a granted ticket opens a real WebSocket that Playwright cannot intercept and retry-storms the dev server.

### Changed

- **E2E proof runs target a production standalone server** — the managed CI web server now does `next build` → copy `.next/static` + `public/` into the standalone tree (same layout as `Dockerfile.prod`) → `node .next/standalone/apps/web/server.js` (`next start` does not work with `output: standalone`); local proof recipe documented (`NEXT_DIST_DIR=.next-e2e` next.config parameter so the build coexists with the running dev server; `NODE_ENV=production` required; `127.0.0.1` targets — the standalone server binds IPv4-only). Dev-server runs keep `workers: 1` (parallel on-demand compilation corrupts the webpack cache) and `a11y/scan.ts` now waits for the design-system tokens before any axe scan, aborting with an actionable error on an unstyled page — a degraded server can no longer produce phantom WCAG violations (the reported dark-mode `#9e9eff`-on-white "defect" was exactly that artifact; the dark palette is proven clean, **17/17 E2E including dark mode**).
- **`NEXT_PUBLIC_API_URL=""` is preserved** — five `||` fallbacks (including the root `env:` block of `next.config.ts`, inlined into the whole bundle) became `??`: an explicit empty string means same-origin relative `/api/v1` URLs through the BFF proxy (hermetic CI builds), only a truly absent variable gets the dev fallback. Contract proven red/green (`api-base-url-env.test.ts`).
- **Unit-suite network guard hardened** — `UnitTestNetworkError` now subclasses `OSError` so `socket.create_connection` callers close their just-created socket (the RuntimeError variant leaked sockets into `PytestUnraisableExceptionWarning` false-greens); real loopback I/O opened during an async unit test is closed on the test's own loop; `error::pytest.PytestUnraisableExceptionWarning` is a permanent hard gate.
- **Redis injection seams** — `PlanPatternLearner` and `KnowledgeEnrichmentService` take a `RedisProvider` constructor seam (client never cached on the singleton — `close_redis()` resets are honored); the shared rate limiter rebuilds its wrapper when the client identity changes. Isolation proven against a dead Redis port.

### Fixed

- **Windows integration bootstrap** — `caldav → niquests → urllib3-future` clobbered `urllib3` via a wheel overwrite plus a `.pth` re-clobbering every Python start, breaking docker-py/testcontainers on Windows (420+ silent skips reading as green). The editor opt-out (`URLLIB3_NO_OVERRIDE=1` + `--no-binary urllib3-future`) is encoded on all four install surfaces (Taskfile, Dockerfile.dev, Dockerfile.prod, CI), guarded by a namespace test, and `task test:backend:integration` gets an actionable DB-strategy preflight + `LIA_REQUIRE_DB=1` so mass skips can never fake green again.
- **Fresh-install production build** — `markdown-sanitize-schema.ts` imported `defaultSchema` from the undeclared transitive `hast-util-sanitize` (masked by hoisted local node_modules; `Module not found` on `pnpm install --frozen-lockfile`); switched to the official `rehype-sanitize@6` re-export, XSS pipeline byte-identical (38/38 sanitize/math tests).
- **15 obsolete permanent skips reactivated** — 7 Windows `skipif` (psycopg SelectorEventLoop is provided by the suite), 4 "checkpoint tables missing" (now provisioned), and 4 realigned on current contracts: PKCE authorization-URL assertions (S256 challenge, state echo, `redirect_uri` from settings), page-scoped `total_count`, reset-preserves-conversation (no soft delete), and invocation-boundary metrics callbacks (`enrich_config_with_node_metadata`). The main integration phase passes **579/579 with zero skips**; the skip allowlist shrank by 6 entries.
- **WCAG dark-mode false alarm** — the audited `#9e9eff` on `#ffffff` contrast failures were Chromium UA link colors on an unstyled page served by a degraded dev server (identical color pair across different design tokens — impossible for a real palette). No palette change was needed; the scan guard prevents recurrence.

### Tests

- Full campaign green at the audited snapshot: **~10,150 fast unit** (unraisable-exception hard gate), **972 agents**, **579 integration with zero skips** (Windows + Testcontainers, ~3.5 min), **1,222 vitest**, **17/17 Playwright E2E** against the standalone production build (axe blocking, dark mode, 320 px reflow, 200% zoom, keyboard), Alembic empty-DB replay, deployment harness 25/25, both production images built. New contracts: DB redirection (9), psycopg pool lifecycle, env isolation (2+2 red/green), testcontainers IPv4 (9+2), base-URL semantics (5), urllib3 namespace (4).

## [1.24.0] - 2026-07-13

> **Agentic telephony** — LIA can now place an outbound phone call on your behalf, hold a goal-directed, **read-only** conversation with a third party (e.g. check a contact's availability, pass along a message), and report back **asynchronously** in the chat with a summary and an optional one-click follow-up. Modeled as a **per-user connector** (Préférences → Mes Connecteurs) with full BYO: each user brings their own ElevenLabs API key + imported number, and calls are billed on their own accounts (no LIA-side cost metering — D-9). The whole flow reuses the existing **draft/HITL** machinery (you confirm the call before it dials) and the proactive-notification delivery. **Data protection is by capability, not by prompt**: the agent only ever receives a pre-fetched, minimized **free/busy** projection (busy time ranges only, never meeting titles/attendees/locations), so it physically cannot leak what it was never given; recording is disabled at the vendor API and the raw transcript is never persisted — only a minimized, expiring summary. Feature-flagged (`TELEPHONY_ENABLED`, **off by default**), 6 languages. Architecture: ADR-127; technical reference: `docs/technical/TELEPHONY.md`. Written à blanc against the documented ElevenLabs Agents API — the exact vendor request/response shapes are `spike:`-flagged and gated on a real ElevenLabs + Twilio account before go-live; every external-payload read is defensive. Dormant until activated — no impact on any existing feature, no DB migration to an existing table.

### Added

- **Agentic telephony connector** (`ELEVENLABS_TELEPHONY`, `apps/api/src/domains/telephony/`) — per-user BYO activation wizard (validate ElevenLabs key → pick a workspace number → configure the post-call webhook → provision a guardrailed LIA agent). API key + webhook HMAC secret stored **encrypted** in `credentials_encrypted` (never in JSONB); only non-secret ids in `connector_metadata`. Frontend wizard in _Préférences → Mes Connecteurs_ (`TelephonyConnectorForm`, `useTelephony`) + a call-history surface that omits the phone number.
- **`place_phone_call` draft tool + `DraftType.PHONE_CALL`** — resolves the callee (a raw international number is used as-is; a name is resolved against the active contacts provider), then produces an HITL draft (`draft_critique` → `draft_executor`) so you confirm callee + objective before LIA dials. Display registry + preview renderer + i18n (noun `call` / verb `placed`, 6 languages with gender agreement) guarded by a boot-time completeness assert (ADR-085 pattern).
- **Availability pre-fetch** (`availability.py`) — a minimized **free/busy** projection over the active calendar (`fields=["start","end"]` → busy ranges only), injected as the agent's `{{availability_summary}}` dynamic variable. Meeting details are never even fetched.
- **Post-call return path** — an unauthenticated `POST /telephony/webhook` with **foreign-filter → per-user HMAC verification** (Stripe-style timestamped signature, replay window) → fire-and-forget reconciliation; a single **tool-less** LLM call (`telephony_synthesis` type + versioned prompt, structured output) produces a factual summary + first-person proposal, delivered via `NotificationDispatcher`. Exactly-once via an atomic conditional UPDATE; one-active-call-per-user via a partial unique index.
- **Background reapers** — stale-call recovery (interval) + retention purge (daily, clears summary/structured_data past their TTL) registered in the scheduler; `GET /telephony/calls`.
- **Observability** — Prometheus `telephony_calls_total{status}`, `telephony_call_duration_seconds`, `telephony_webhook_ignored_total{reason}`; the synthesis LLM call's tokens are tracked via `track_proactive_tokens` (task type `phone_call`), consistent with briefing/heartbeat.
- **ADR-127** (Agentic Telephony) + `docs/technical/TELEPHONY.md` (architecture, security invariants, §17 setup runbook, spike list), cross-referenced in `docs/INDEX.md` + `docs/architecture/ADR_INDEX.md`.

### Changed

- All telephony backend strings centralized in `src/core/i18n_telephony.py` (6 languages, typed accessors); the ElevenLabs agent guardrail system prompt moved to the versioned `prompts/v1/telephony_agent_system_prompt.txt`. New `telephony_synthesis` LLM type in `LLM_TYPES_REGISTRY` + `LLM_DEFAULTS` + the factory `LLMType` literal + admin-UI description (6 languages).

### Fixed

- **Pre-release hardening** (caught by adversarial review of the à-blanc code, never shipped): crash-safe dial — the `dialing` row is committed **before** the vendor call and the DB transaction is never held across an external HTTP call, so a crash after dialing can't orphan a call whose post-call webhook could never reconcile; the `place_phone_call` draft factory was extracted to the telephony bounded context to keep the shared drafts service under the file-size ratchet; defensive structured-data extraction with the `ValidationError` logged by type only (never the offending value → no PII at WARNING).

### Tests

- **100+ backend unit tests + 8 integration tests on real PostgreSQL** (the F12 one-active-call partial index, `mark_completed` exactly-once, `recover_stale`/`purge_expired`, connector activation) — the `Enum(native_enum=False)` name/value predicate proven against Postgres in UPDATEs. Frontend: 6 `useTelephony` vitest tests. Contract test pins the agent's collected fields to `StructuredCallData`. File-size ratchet + black/ruff/mypy clean; i18n parity across the 6 locales; dev container boots healthy.

## [1.23.13] - 2026-07-11

> Companion presence, embodiment micro-interactions, and a documentation realignment. LIA gains a **floating mini-avatar** that follows across the dashboard (everywhere except chat, where the real avatar already lives) — resting as the current mood, "thinking" while a background run is active, badged when notifications are unread, minimizable to a dot. Around it, three grounded touches make the interface feel alive without decoration: a **time-aware empty-chat greeting**, a **proactive-notification avatar wobble** (live arrival only, never on history), and a **"just updated ✨" freshness badge** on briefing cards. The mood-colored bubble glow shipped in v1.23.12 was **retired** on user judgment after UAT. The release also folds in an already-landed documentation realignment (236 broken doc links → 0) and two dev-hygiene items (a committed `doc_audit.py` drift instrument, an infra-denylist false-positive fix). Every animation degrades to the previous behavior on asset failure, hidden psyche visuals, and `prefers-reduced-motion`. A real SSE reconnect-storm bug (inline callback identity) was found by driving the app end-to-end in the dev container and fixed. No backend feature change, no DB migration, no new dependency.

### Added

- **Companion presence** (`components/companion/CompanionPresence.tsx`, mounted in the dashboard layout) — a floating LIA mini-avatar on every dashboard page **except chat** (hidden there, where it also disables its SSE + polling so exactly one notifications connection is ever active). Three grounded states: **rest** (mood `AnimatedEmoji`, gentle float; classic "LIA" badge when psyche is off), **working** (a small `TypingIndicator` bubble driven by a gentle `GET /agents/runs/active` poll — ADR-117), and a **notification** count badge fed by a layout-level `useNotifications` subscription with a one-shot attention wobble on live arrival. Click → chat (and clears the badge); minimize → a discreet restore dot (session-scoped, never permanently hidden). Pure reuse of `AssistantAvatar` / `TypingIndicator` / `useNotifications` / `fetchActiveRun`.
- **Time-aware empty-chat greeting** — the hero emoji follows the user's local hour: ☕ morning (05–10), 👋 day (11–17), 🌛 evening (18–22), 😴 deep night (23–04), the last with a truthful "at night, LIA consolidates its memories" note grounded in the real nightly `memory_consolidation` / `memory_cleanup` jobs. Rendered through `AnimatedEmoji` (static-glyph fallback), behind a `mounted` gate that prevents any SSR hydration mismatch. New assets ☕/🌛/😴; one i18n key ×6.
- **Proactive-notification avatar wobble** — when a proactive/reminder/subagent/scheduled notification arrives **live** (freshness guard on the message timestamp, ±10 s), the assistant avatar plays a one-shot `lia-bell-ring`; history-loaded rows never wobble.
- **Briefing freshness badge** — the dormant `UpdatedAtBadge.showJustUpdated` ("mis à jour ✨") is now wired: a completed card refresh (`isRefreshing` true→false) lights it for ~1.6 s.
- **`scripts/audit/doc_audit.py`** — committed documentation-drift instrument: broken relative links + stale code-path references across `docs/`, classified LIVING / HISTORICAL / ROADMAP, exiting non-zero on any LIVING broken link; wired into `AUDIT_PROTOCOL.md` as a mandatory pre-publication step.

### Changed

- **Full documentation & schema realignment against v1.23.12** — 236 broken relative links driven to 0 across `docs/`, stale code-path references corrected, Mermaid schemas re-synced with the code (103 files).

### Removed

- **Mood-colored glow on the streaming bubble** (v1.23.12 W2) — retired on user judgment after UAT ("inutile et inesthétique"). The `.mood-glow` rule, its `--mood-color` wiring in `ChatMessage`, the 3 tests, and every showcase mention across the 6 locales were removed; particles, mood ping, cross-fade, living weather, landing mockup and the animated milestone toast are untouched.

### Fixed

- **Companion notification SSE reconnect storm** — an inline `onNotification` callback changed identity every render, making `useNotifications` tear down and rebuild its `EventSource` continuously (~200 requests). Stabilized with `useCallback`; the badge also now clears when the user reaches chat by any route, not only by clicking the companion. (Found by driving the app end-to-end, not by unit tests.)
- **Companion → chat navigation on clean (locale-less) URLs** — naive `pathname.split('/')[1]` locale extraction produced a malformed target; now reuses the layout's `getLanguageFromPath` / `buildLocalizedPath`, guarded by a regression test.
- **Infra-denylist pre-commit false positives** — byte coincidences inside regenerated binary assets (Mermaid PNG renders) matched short denylist tokens and aborted legitimate commits; `grep -I` now skips binary files.

### Tests

- **+13 frontend tests** — `greetingForHour` buckets, `isFreshProactive` window, companion helpers (`isChatRoute`, `deriveCompanionState`, `companionChatHref` incl. the clean-URL regression). Full suite green: 523 tests / 50 files, ESLint + `tsc --noEmit` clean, i18n parity ×6, and the four frontend features runtime-verified in the dev container (greeting emoji + no hydration warning, briefing badge cycle, companion rest / hidden-on-chat / click / minimize).

## [1.23.12] - 2026-07-11

> The wow batch — six targeted effects that push the living interface (v1.23.10) one notch further, selected for their delight-to-cost ratio. The psyche gains its strongest embodiment yet: the actively streaming bubble takes a thin border and soft halo **in LIA's current mood color**, and a whitelisted strong emotion (intensity ≥ 80 %) releases a one-shot burst of three particles from the avatar — rarity is the point. The moment LIA starts answering becomes cinematic (the execution steps cross-fade into the first tokens instead of being sharply replaced), the dormant weather keyframes finally come alive on the Today Briefing card, and the landing's hero conversation mockup is upgraded to product level — live breathing steps and a transient streaming caret, so visitors see the real thing. Same discipline as the parent batch: pure frontend, zero dependency, hard fallbacks, reduced-motion covered (with two cascade-level traps caught in self-review: CSS animation shorthands never share an element, and fill-mode animations are neutralized by duration, not `animation: none`).

### Added

- **Mood glow (chat)** — the assistant bubble being streamed carries `border-color` + halo driven by a `--mood-color` CSS variable (resolved from the same psyche snapshot as the avatar); double-class specificity so the glow survives the bubble's own hover styles; background-color kept in the transition list to preserve hover timing. Psyche gate respected; regular border the instant the stream completes.
- **Rare emotion particles (psyche)** — a change-only, never-on-mount burst of 3 rising particles when the live avatar's active emotion switches to a whitelisted one (✨ joy, 🌟 wonder/pride, ❤️ tenderness, 💖 gratitude, ⚡ enthusiasm, 💢 frustration) at intensity ≥ 0.8. History rows and reduced-motion never burst; particles are `opacity: 0` at rest so a disabled animation leaves nothing frozen.
- **Progress → answer cross-fade (chat)** — the markdown wrapper of the active message is keyed on the reducer's `streaming.phase`: exactly one remount per response (none per token, none at stream end, none on history), playing a 300 ms fade when the first real tokens replace the execution steps.
- **Living weather (Today Briefing)** — the dormant `lia-rain-drop` / `lia-sun-rays` keyframes are finally wired: falling 💧 on Rain/Drizzle/Thunderstorm, slower ❄ on Snow, a slow-rotating dashed amber halo on Clear — mapped defensively from `condition_code` (unknown codes animate nothing), decorative overlay only.
- **Product-level landing mockup** — the hero conversation demo now shows real live steps (staggered entrance, past step dims when the next lands, current one breathes twice then settles) and a transient 3-blink streaming caret on the Markdown reply; 1 new i18n key ×6 (`landing.chat_mockup.step_analyze`). Nested spans because two CSS animation classes on one element override each other (`animation` is a single shorthand property).
- **Animated milestone toast** — the relationship-milestone toast icon upgrades from static ✨ to the shared `AnimatedEmoji` (asset already self-hosted).

### Tests

- **+11 frontend tests** — mood-glow contract (active/inactive/gate-closed), cross-fade phase contract, and 6 particle-gating cases (whitelist, threshold, never-on-mount, history rows, reduced motion). Full suite green: 509 tests / 49 files, ESLint + `tsc --noEmit` clean, Prettier clean repo-wide on `src`, i18n parity ×6.

## [1.23.11] - 2026-07-11

> The structural-decoupling release (ADR-126). Audit cycle 3's coupling metrics exposed a textbook Stable Dependencies violation: **auth** — the most depended-upon domain of the backend (26 afferent domains) — itself depended on 14 domains and sat in 11 of the 31 bidirectional import cycles. Three behavior-preserving lots later, the boundary is clean: **auth = identity & sessions (a leaf: 2 outgoing edges, 0 incoming, 0 cycles); users = the User aggregate, profile and account lifecycle (the coherent hub)**. Zero behavior change by construction — no endpoint, wire contract, transaction topology or structlog event touched; the full backend suites ran green at every lot boundary and the `User` class moved byte-identically (proven by blob comparison against HEAD).

### Added

- **`scripts/audit/measure_coupling.py`** — the domain-coupling instrument (Ca/Ce/instability matrix + bidirectional-cycle list) is now committed, closing the audit-protocol "coupling measurement due" item. It reproduces the cycle-3 figures exactly (all-imports semantics, `TYPE_CHECKING` included) and adds runtime-only columns (`_rt`) — only runtime imports can produce circular-import failures, so the Stable Dependencies assessment reads those while the historical series stays comparable. `--detail <domain>` lists a domain's outgoing edges with exact `file:line` sites.
- **`users/AccountProvisioningService`** — the creation-side counterpart of `AccountDeletionService`: provisions skill activation states and default usage limits for new accounts (registration + OAuth creation). The two historical call sites had different transaction topologies (registration commits per step, the OAuth callback commits once at the end), preserved exactly via an explicit `commit_per_step` flag.
- **`src/core/geo_utils.py`** — `haversine_distance` promoted from the agents domain (pure math, no domain knowledge); the agents `distance` module keeps a compat alias, and the haversine test suite moved to `tests/unit/core/test_geo_utils.py`.
- **`get_provider_api_key()`** in `core/llm_config_helper.py` — core-level probe for provider API-key availability (used by the voice-mode STT capability check), replacing a direct domain import of the LLM-config cache.

### Changed

- **`User` ORM model moved from `auth/models.py` to `users/models.py`** (its historical re-export home) — byte-identical class body, ~84 import sites plus tests migrated mechanically, transitional shim deleted, model registration untouched (`import_all_models()`); no DB change of any kind (the `users` table never moved, no Alembic migration).
- **`user_location_service` moved from auth to users** (profile/location concern): the last-known-location cascade, its router endpoints' service and its unit tests now live in the users domain; the 4 external importers (agents chat geolocation, briefing weather, heartbeat proactive cascade, users home-deletion wipe) updated.
- **Account provisioning extracted out of `AuthService`** — `register()` and the OAuth user-creation path now delegate to `AccountProvisioningService`; existing auth unit tests pass unmodified (lazy imports preserved the source-level patch targets).
- Living docs updated to the new layout (`AUTHENTICATION.md`, `LAST_KNOWN_LOCATION` runbook, `GUIDE_TESTING.md`, audit protocol §6); historical ADRs left untouched (dated documents). New [ADR-126](docs/architecture/ADR-126-Auth-Users-Domain-Decoupling.md) documents the boundary, the measured before/after matrix and the accepted hub-cycle relocation trade-off.

### Fixed

- `auth/service.py` imported its own `User` model back through the users re-export (`auth → users → auth` indirection) — now imports it directly; the gratuitous `auth↔users` runtime cycle from that edge is gone.
- Dead borrowed-private-symbol import (`_haversine_distance` from agents internals) eliminated — the historical cross-domain private-helper case flagged by the audit.

### Metrics (measure_coupling.py, before → after)

- Ce(auth): **14 → 2** (users, shared) · runtime: **6 → 2** — target ≤3 met on the audit's own instrument.
- Ca(auth): **26 → 0** (sole remaining importer: `api/v1/routes.py`, outside the domain graph).
- Cycles involving auth: **11 → 0**. Hub pairs relocate to the users domain (raw totals 31→32 all-imports, 24→31 runtime-only: the former typing-only auth cycles re-form as honestly-runtime users↔X pairs — accidental hub → coherent lifecycle hub, the full trade-off is documented in ADR-126); no cycle outside the users hub was created.

### Tests

- +12 unit tests: `AccountProvisioningService` (5 — both commit topologies, feature-flag gate, default safety), `get_provider_api_key` (2), haversine suite relocated to core (13 moved, 1 constant test). Full suites green at every lot boundary (~9,265 unit / 140 integration / 969 agents on the final run set), MyPy strict 0 errors on 870 files, Docker boot verified per lot.

## [1.23.10] - 2026-07-11

> The living-interface release. LIA's frontend gains a coherent system of micro-interactions that makes the assistant feel alive without ever getting in the way: the Psyche Engine becomes _visible_ (the mood avatar is now a real animated face on the current reply, the ring pulses when the mood shifts, relationship milestones are celebrated), the pipeline's execution steps breathe while they run, and a dozen small touches (random typing-indicator shapes, streaming caret, animated personality emojis in the header, a living tab title for background runs) replace static chrome with motion that carries meaning. Everything is pure frontend polish behind hard fallbacks — every animation degrades to the previous behavior on asset failure, when psyche visuals are hidden, and under `prefers-reduced-motion` (where animated assets are not even fetched). No backend change, no DB migration, no new dependency, no new setting.
>
> **Asset note:** animations use Google's Noto Animated Emoji (CC BY 4.0), self-hosted under `apps/web/public/animated-emoji/` (23 WebP, ~10 MB, attribution LICENSE included). The original 512px encodes are shipped unmodified: a 128px Pillow re-encode was tried and reverted because it flattened the variable per-frame timings and made the animations visibly choppy.

### Added

- **`AnimatedEmoji` shared component** (`components/ui/animated-emoji.tsx`) — renders a self-hosted animated Noto WebP for any emoji glyph with three hermetic fallbacks: static glyph when animation is not requested, per-codepoint error memory on missing/corrupt assets, and no render (no fetch) under `prefers-reduced-motion`. Codepoints are derived at runtime from the glyph itself (variation selectors included, e.g. ⚖️ → `2696-fe0f`), so DB-managed emojis need no frontend registry.
- **Animated psyche avatar** — the mood smiley on the **latest assistant message only** is a live animated face; older messages keep their static mood snapshots (at most one permanent loop on screen) but **wake up while hovered**. Mood→codepoint mapping lives in `MOOD_COLORS` with an asset-completeness test (ADR-085 spirit: every mood must have its WebP on disk).
- **Animated personality emojis (header)** — the current personality's emoji lives permanently in the header trigger; menu items animate on hover/focus only (one loop at a time, assets fetched on demand). Best-effort by design: the 4 seeded emojis without a Noto animated version (🌴 ⚛️ 🥟 💰) keep their static glyph, silently.
- **Typing indicator variants** — 6 pure-CSS animations (wave, orbit, equalizer, sparkle ✦, breathe, typewriter), one picked at random per response; classic gray tint kept; static three dots under reduced motion (never a frozen shape).
- **Live execution steps** — the progress lines ("📋 Preparing the action plan…") now have a visual hierarchy: past steps dim to 55 %, the current one slides in and breathes until the next arrives. Built on a new typed `streaming.phase` (`'progress' | 'answer'`) field in the chat reducer FSM, threaded through every SSE handler dispatch.
- **Streaming caret** — a blinking caret marks the end of the text while answer tokens stream (answer phase only; hidden under reduced motion).
- **Living tab title** — while a run streams and the tab is hidden, the title alternates with "✦ LIA is writing…" (6 languages) and restores exactly on done/visibility/unmount — the visible companion of ADR-117 background runs.
- **Psyche made perceptible** — one-shot **mood-ring ping** (scale + brightness) when the live avatar's mood changes between replies; **relationship milestone toasts** (headless `PsycheMilestoneWatcher`: forward-only ORIENTATION → EXPLORATORY → AFFECTIVE → STABLE transitions, hydration-guarded so a page load never toasts, 6 languages).
- **Micro-touches** — send-button takeoff on submit, slow glimmer on the active skill badge ✦, animated 👋 greeting on the empty chat, hover-animated mood emoji on the settings psyche card.
- **`scripts/assets/fetch_noto_animated_emoji.py`** — one-shot fetcher for all animated assets: strict on the 14 mood codepoints (exit 1 on a missing one), best-effort on personality/UI emojis (`MISS` report, static glyph at runtime).

### Changed

- **`AssistantAvatar` refactored onto the shared `AnimatedEmoji`** (its inline img/fallback logic removed); `TypingIndicator` rewritten around the variant table; `ChatMessageList` computes the last assistant message id (`getLastAssistantMessageId`) to gate the single live animation.
- **Reduced-motion coverage extended** — the project's kill-switch is an explicit class list, not a wildcard: every new animation class is registered there, and the typing indicator swaps to static dots via `motion-reduce:` DOM classes rather than freezing mid-shape.
- **Briefing cards stagger** was evaluated and closed as a no-op: `BriefingCard` already ships `animate-in` entrances with a per-card `animationDelay` — documented in the batch spec instead of duplicating it.

### Tests

- **+45 frontend tests across 9 new/extended suites** — reducer `streaming.phase` transitions, `AnimatedEmoji` (derivation incl. variation selectors, override, error and reduced-motion fallbacks), `AssistantAvatar` (latest-only gating, hover-wake, mood ping incl. never-on-mount), `PersonalitySelector` trigger wiring, `getLastAssistantMessageId`, `PsycheMilestoneWatcher` (hydration guard, forward-only), `useLiveTabTitle` (fake timers, exact-restore), mood-asset completeness. Full frontend suite green (498 tests, 48 files), ESLint + `tsc --noEmit` clean, i18n parity across the 6 locales (4 new keys).

## [1.23.9] - 2026-07-11

> The complexity-reduction series reaches its second target (ADR-125). The cycle-3 audit re-ranked decomposition candidates by **cyclomatic complexity** and pointed at `Draft.get_detailed_preview` — a CC ≈ 93, 14-branch `elif` cascade rendering the HITL confirmation previews from inside a **models** module (data structures + heavy presentation logic: a double fault). The renderer now lives in a dedicated presentation module as a dispatch table of small per-type functions (max CC 9), extracted under a byte-identical golden characterization net that passed unmodified after the cut — the ADR-122 method, replayed. Three long-standing preview fallback defects were then fixed in the same delivery as separate, reviewed changes: the hardcoded French "(sans objet)" shown to every non-French user on subject-less email deletions is now localized in all 6 languages, a forwarded email without an added message no longer renders the literal string "None", and an empty reminder deletion no longer produces a blank preview. No DB migration, no new environment variable.

### Added

- **`drafts/preview_renderer.py` (ADR-125)** — dispatch table `_PREVIEW_RENDERERS` with one small renderer per `DraftType` (EMAIL and EMAIL_REPLY share `_render_email_send`; the forward renderer reuses it and appends attachments) plus three shared helpers factoring the "modified ✏️ / preserved" pattern of the update types. A **boot-time completeness assert** (`assert_preview_renderer_completeness`, ADR-085 pattern) is wired in `startup/registries.py` right after the display-registry gate — the app refuses to boot if a `DraftType` lacks a preview renderer — with a mirror unit test; the `get_summary` fallback remains as defense in depth.
- **Golden characterization net** (`test_detailed_preview_characterization.py` — 65 tests, 61 golden cases) pinning the EXACT preview string in full-string equality (the frontend confirmation cards render it verbatim): all 16 `DraftType`s with a net-completeness guard, MIXED modified/preserved cases that kill condition cross-wiring, key fallbacks (`from`/`from_addr`, `filename`/`name`, timed vs all-day), the sublabel truncation boundary, 6 languages, timezone conversion, and the unknown-type fallback. Goldens are generated by running the implementation — never written by hand — and every regeneration is diffed old-vs-new to prove it is surgical.
- **`scripts/audit/measure_cc.py`** — the committed per-function cyclomatic-complexity instrument (strict AST counting, standard library only, `measure_sloc.py` style), closing the audit protocol's "complexity instrument due" item. The protocol now documents that cycle-3 figures (ad-hoc, uncommitted counter) must not be compared with the committed instrument's across cycles.

### Changed

- **`drafts/models.py` 803 → 584 logical SLOC** — `get_detailed_preview` becomes a 2-line delegate (CC 1) and the file drops below the global 600-SLOC ceiling, **leaving the frozen-size registry entirely** (`task ratchet:update`, 55 frozen files remain). The new `preview_renderer.py` lands at 304 SLOC with a max per-function CC of 9 under the strictest counting.
- **Subject-less email deletions now store the raw truth** — the French placeholder was baked into the stored draft content at five layers (Gmail header extraction in the tool, tool→draft call, convenience-function default, input-model field default, renderer default); all five now store/pass `""`, and the localized fallback (new `no_subject` key in `DRAFT_PREVIEW_LABELS`, 6 languages) is applied at render time only. The post-execution message reuses the pre-existing subject-less variant of `APIMessages.email_moved_to_trash`.

### Fixed

- **Hardcoded French "(sans objet)" leaking to all languages** — deleting a subject-less email now shows "(no subject)" / "(sin asunto)" / "(kein Betreff)" / "(senza oggetto)" / "（无主题）" in the confirmation card, according to the user's language.
- **Forwarding an email without an added message rendered the literal string "None"** in the confirmation card body — it now renders empty, exactly like an explicitly empty body.
- **Deleting an empty reminder produced a blank confirmation preview** — it now renders the "?" fallback line, consistent with every other delete type.

### Tests

- The 65-test golden net passed **identically, unmodified** through the extraction; for the three deliberate fixes it was regenerated with a proven-surgical diff (exactly 3 goldens changed, 2 pinning cases added, the 56 others byte-identical). Full gates green: 9,242 unit tests, Ruff/Black/MyPy strict clean, file-size ratchet green with the lowered baseline, fresh Docker dev boot to healthy through the new completeness gate, and all 16 draft types rendered inside the dev container matching 61/61 goldens.

## [1.23.8] - 2026-07-10

> The unified error taxonomy reaches the whole backend (ADR-124, phase 2 of ADR-114). The 33 remaining raw `raise HTTPException` sites in routers, services and validation modules — untyped, invisible to Prometheus, unlogged by the central mechanism — are migrated to the centralized raisers and `BaseAPIException` subclasses of `src/core/exceptions.py`, with the external API contract proven byte-identical _before_ migration: every site was pinned by a contract test against its legacy behavior (status code, detail payload, headers), and the same assertions carried over green by inheritance. Review rule #18 ("centralized raisers only") now holds repo-wide: `grep "raise HTTPException" src/` returns **zero hits, no exemptions**. One deliberate, user-approved contract fix ships with it: inconsistent heartbeat settings now return a clear, localized 422 instead of a generic 500.

### Added

- **Contract test net for the router/service error edge** (`tests/unit/core/test_router_service_error_contract.py`, 47 tests — ADR-114 method). Per-site mapping pins written and green on the PRE-migration code, then strengthened to the typed exceptions; FastAPI edge parity renders each new class against its raw-`HTTPException` twin via `TestClient` (same status, same JSON, same headers, including `Retry-After` and `WWW-Authenticate: Bearer`); the HITL rate-limit path is exercised END-TO-END through the real SSE generator.
- **New exception classes in the central taxonomy** — `StructuredValidationError` (422 with a Pydantic-style `type/loc/msg/input/ctx` detail dict, serving the 9 LLM-config validation sites), `UnprocessableEntityError` (422, plain detail), `PayloadTooLargeError` (413), `BadGatewayError` (502 — distinct from the 503 `ExternalServiceError`), `GoneError` (410, dict-capable detail for tombstone endpoints); `RateLimitError` and `ResourceConflictError` gain structured-dict details and response headers (the `ConnectorValidationError` pattern). Six thin raisers cover the remaining sites (`raise_bearer_auth_failed`, `raise_admin_mcp_server_not_found`, `raise_llm_type_not_found`, `raise_scheduled_action_already_executing`, `raise_run_in_progress`, `raise_invalid_webhook_signature`).
- **CI non-recurrence guard** — the `code-hygiene` job gains a "raw HTTPException raises" grep check (warning for one release to absorb in-flight branches, then to be flipped to a hard error). Documented in `docs/technical/CI_CD.md`.

### Changed

- **`src/core/exceptions.py` restructured behind a façade (file-size ratchet arbitration)** — the module sat at 909/928 frozen logical SLOC with ~130 SLOC of additions to land. `BaseAPIException` moves to the internal `src/core/_exceptions_base.py` and the bounded-context families (memory store, interests, STT, WebSocket) to `src/core/exceptions_domains.py`; `src/core/exceptions.py` re-exports every name (explicit aliases), so **no consumer import changes anywhere**. Ratchet caps lowered, never to rise again: `core/exceptions.py` 928 → 848, `agents/api/router.py` 784 → 780.
- **Every migrated error path now feeds the central observability** — automatic structured logging plus `http_errors_total` / client-server error classification metrics on each raise (previously invisible raw raises). Log events are additive; the API payloads are unchanged.
- **HITL rate-limit site documented for what it really does** — the 429 raised inside the SSE `event_generator` has never reached the client as an HTTP 429: the generator converts it into an SSE `error` event (classified "transient") plus a `done` chunk. The site's misleading "Raise HTTP 429" comment is fixed, and the classification is proven identical for the legacy and typed exceptions across all 6 languages.

### Fixed

- **Inconsistent heartbeat settings now fail with a clear, localized 422** — the `heartbeat_min_per_day > heartbeat_max_per_day` guard used to be swallowed by the endpoint's `except Exception` and degraded into a generic 500 "Failed to update heartbeat settings". The 422 now reaches the client as intended, with the detail served in the user's language through `APIMessages` (6 languages, `zh` normalized via the canonical chokepoint; the English wording keeps the historical text).
- **Stale claims in code and docs corrected** — the `ingest_router` comment justifying raw 401s by a raiser limitation that ADR-114 had already removed; the `i18n_api_messages` module docstring teaching the raw-raise anti-pattern; the code snippets in `GUIDE_TELEGRAM_INTEGRATION.md`, `NEW_CHANNEL_CHECKLIST.md` and `AUTHENTICATION.md` that still showed raw raises for since-migrated sites.

### Tests

- 47 contract tests (pin → typed mapping, edge parity, real-generator HITL path, per-language heartbeat 422 including the `zh`→`zh-CN` normalization); the new `APIMessages` table is auto-covered by the backend i18n parity AST guard. Full gates green: 9,143 unit tests, 138 integration tests, MyPy strict on the whole backend (867 files), Ruff/Black clean, file-size ratchet green with lowered caps, fresh Docker dev boot to healthy (`/health`, `/ready`, zero boot errors).

## [1.23.7] - 2026-07-10

> The decomposition program reaches the backend's second monolith: application startup (ADR-123). A maintenance release — no user-facing feature change, no behavior change (verbatim extraction, boot log sequence byte-identical before/after), no DB migration. The `main.py` lifespan had grown to ~780 logical SLOC (1,133 raw lines) across 23 startup and 20 shutdown steps, with a boot order that is critical but was entirely implicit. Every step now lives in a typed function inside a new `src/infrastructure/startup/` package (one module per subsystem), and the lifespan becomes a readable ~25-call sequence in the exact historical order, headed by a comment documenting **why** that order is what it is. The lifespan remains the single orchestration point — the "Startup initialization" checklist is unchanged.

### Added

- **`src/infrastructure/startup/` package (ADR-123)** — seven subsystem modules, one typed function per contiguous segment of the historical boot sequence: `registries.py` (eager model imports, fail-fast completeness gates, tool schemas), `observability.py` (Prometheus metrics server, Langfuse, lifetime-metrics task), `caches.py` (Redis, pricing + config caches, ADR-063 invalidation subscriber), `agents.py` (checkpointer, AgentRegistry + ~16 agents, semantic tool selector, agent graph), `integrations.py` (MCP, per-user MCP pool, Telegram, currency sync, system RAG indexing), `schedulers.py` (single function: 15 job registrations + leader election, same single try/except), `shutdown.py` (single function: the 20-step teardown, ADR-117 drain first, Redis last) plus an explicit `StartupHandles` dataclass for the cross-`yield` state.
- **Startup order dependencies documented at the point of decision** — the lifespan's header comment spells out the eight ordering constraints that were previously implicit (models before any query; fail-fast gates before anything touches LLM/tools; Redis before pricing caches, leader election and the invalidation subscriber; LLM config/capabilities caches before any `get_llm()`; checkpointer before the registry; registry before MCP; MCP before the semantic selector so embeddings cover MCP tools; ALL scheduler jobs before `leader_elector.start()`) and the shutdown ordering (producer drain first, Redis closes last).

### Changed

- **`main.py` 1,399 → 322 raw lines (982 → 181 logical SLOC — off the ratchet frozen list; `file_size_baseline.json` updated via `task ratchet:update`).** Strict-identity extraction: same structlog **event names/levels/fields** (only the JSON `logger` field follows the new modules — ADR-122/B1 precedent), same per-step try/except exception tuples, same feature-flag guards, same `SCHEDULER_JOB_*` constants, lazy imports kept inside step bodies (identical import timing and `ImportError` surfaces, e.g. the playwright probe), and **partial-object semantics preserved** (a mid-step failure still returns the partially built registry/MCP manager that downstream steps and shutdown gates historically consume).
- **Wiring documentation follows the code** — the docs that tell you _where_ to register things now point at the new sites: `GUIDE_BACKGROUND_JOBS_APSCHEDULER.md` (jobs → `startup/schedulers.py::init_scheduler`, before `leader_elector.start()`), `GUIDE_MCP_INTEGRATION.md` / `GUIDE_AGENT_CREATION.md` / `TOOLS.md` (MCP startup → `startup/integrations.py::init_mcp`), `LLM_CONFIG_ADMIN.md` (config caches → `startup/caches.py`), `GUIDE_DEBUGGING.md`, `TIMEOUT_REGISTRY.md` (drain timeouts → `startup/shutdown.py`), and the CLAUDE.md runtime checklist items 3/6/7/9.

### Fixed

- **`health_metrics/kinds.py` docstring drift** — `agent_name` documentation pointed at `src.main.lifespan` for agent registration; it now points at `startup/agents.py::init_agent_registry` (docstring-contradicts-code is treated as a bug).
- **`test_config_constants.py` retargeted** — the static check that the scheduler registration site imports the centralized `CURRENCY_SYNC_*` / `SCHEDULER_JOB_*` constants now inspects `startup/schedulers.py` (same intent, new location).

### Tests

- Behavior identity proven, not assumed: a line-accounting script against `git show HEAD:` verified every original lifespan code line survives verbatim (explicit allowlist for docstring-ified step headers and typed pre-inits) with per-block order checks 14/14 green; a fresh Docker dev boot before/after produced **1,067 structlog events in a strictly identical sequence (empty diff)** — the 49 lifespan-driven events match name-for-name in order, `scheduler_elected_jobs_summary` lists the same 16 jobs in the same registration order, `/health` and `/ready` 200. Suites: 9,111 unit + 969 agents green, MyPy strict/Black/Ruff clean on the new package. Documented dev-env limitation (pre-existing, reproduced on the unmodified code): uvicorn `--reload` cannot complete a graceful shutdown while host SSE connections are open, so the shutdown sequence is pinned by the line-accounting check rather than a dev log capture.

## [1.23.6] - 2026-07-10

> Core-agent decomposition resumes on the streaming monolith (B2 #1, ADR-122) & structural quality guards. A maintenance release — no user-facing feature change, no behavior change (verbatim extraction under a characterization net, SSE event order and structlog event names byte-identical), no DB migration. The largest function of the backend — `AgentService._stream_with_new_services`, the 1,135-logical-SLOC SSE generator on the critical path of every chat turn — sheds its densest coupling: the full voice/TTS state machine moves behind an explicit typed seam. Two new guards make code-quality regressions structural: a file-size ratchet (logical files can only shrink) and a local infra-denylist check (pytest + pre-commit).

### Added

- **`VoiceStreamCoordinator` (new module `services/streaming/voice_coordinator.py`, ADR-122).** Owns the complete voice/TTS state machine previously inlined in the SSE generator: chat-mode progressive sentence streaming (started on the first `conversation` router decision), agent-mode parallel voice synthesis (started when the tool-result registry lands mid-stream), progressive audio emission during streaming, the three end-of-stream finalization paths (PATH 1 queue drain / PATH 2A direct TTS / PATH 2B Voice-LLM sync fallback), both TTS cost backfill passes, and the exact teardown semantics of the generator's three exits (nominal / GraphInterrupt fallback / exception). Explicit typed interface — a frozen `VoiceStreamContext` dataclass plus driving points — and the 11 former local state variables become private coordinator state.
- **`voice_stream_helpers.py`** — the stateless voice primitives moved verbatim (TTS text sanitization, the ADR-117 `_should_start_voice` listener gate, SSE audio-chunk formatting, the parallel queue pump, the chat-pipeline teardown). Split from the coordinator so both modules respect the new 600-logical-SLOC cap.
- **Golden characterization net for the SSE generator** (`tests/agents/test_agent_service_stream_characterization.py`, 11 scenarios — Feathers method, v1.21.15 precedent). Pins the exact ordered SSE chunk sequences and persistence side effects of `stream_chat_response` through faked collaborator seams: simple turn, tool turn with `content_replacement` REPLACE semantics, HITL interrupt (no `done` chunk), HITL resumption (pending-interrupt cleanup + `decision_type` patch), all three voice finalization paths, parallel-progressive voice mid-stream, GraphInterrupt fallback, mid-stream error (re-raise after the `error` chunk), and voice synthesis failure (`voice_error`). `background_runs_enabled` is frozen so the net pins the producer upstream of the ADR-117 broker. **The net passed identical and unmodified after the extraction.** The harness (fake orchestrator/streaming/tracker/voice seams) is reusable for the next B2 seams.
- **File-size ratchet guard** (`test_file_size_ratchet_guard.py`) — every `src/**/*.py` must stay under **600 logical SLOC** (tokenize + AST via `scripts/audit/measure_sloc.py`, the audit's own metric); 57 pre-existing larger files are frozen at their audited size +2% in `file_size_baseline.json` and may only shrink. `task ratchet:update` lowers caps (never raises, never adds); data modules are exempt. Doctrine in `GUIDE_DEVELOPPEMENT.md` and a CLAUDE.md systemic rule.
- **Local infra-denylist guard** (`test_no_infra_info_guard.py` + a pre-commit step) — both read an optional, git-ignored `apps/api/tests/.infra_denylist` and block its entries (whole-word, case-sensitive) from appearing in any tracked file. Only the `.example` is committed; CI and fresh clones are unaffected when the local file is absent.
- **Logwatch mail settings rendered from env at deploy time** — `logwatch.conf` becomes `logwatch.conf.template` (`${LOGWATCH_MAILTO}`/`${LOGWATCH_MAILFROM}`), rendered by `prepare-prod.ps1` from `.env` following the ADR-119 config-rendering pattern, with a fail-loud guard keeping the existing config when the vars are unset. `LOGWATCH_*` documented in both env templates.

### Changed

- **`AgentService._stream_with_new_services` decomposed: `service.py` 1,585 → 1,031 logical SLOC (−35 %).** The generator keeps the orchestration order; every voice concern is a one-line delegation to the coordinator. The `service.py` ratchet cap follows it down (1,617 → 1,052). SSE event order/content unchanged; structlog **event names** unchanged (only the JSON `logger` field follows the new modules, as in the B1 `DebugMetricsBuilder` precedent); no LangGraph state key touched. Two consumer test files repointed to the helpers module.
- **Pinned as-is (deliberately not fixed): the sync-path voice services (PATH 2A/2B) are never closed by the generator** — a potential keep-alive httpx pool leak, now localized in `finalize()` and marked `PINNED CURRENT BEHAVIOR` in the golden net; fixing it is a separate, deliberate behavior change.

### Fixed

- **Intermittent xdist flake rooted out** — `test_context_domain_manager.py` cleared the global `ContextTypeRegistry` without restoring it, leaking an empty registry to catalogue-validating tests landing later on the same worker; a module-level autouse snapshot/restore fixture closes it.
- **pytest warnings zeroed at their source** — (1) the deprecated session-scoped `event_loop_policy` fixture override migrates to the `pytest_asyncio_loop_factories` hook (single factory: Windows keeps the psycopg-v3 SelectorEventLoop, test IDs unchanged via `HIDDEN_PARAM`); the migration exposed two latent tests calling `asyncio.get_event_loop().run_until_complete(...)` from sync tests (fails when no current loop is left on the worker) — one becomes a proper async test, the other uses `asyncio.run`. (2) `SummarizationMiddleware` moves off the deprecated `max_tokens_before_summary`/`messages_to_keep` kwargs to `trigger=("tokens", …)`/`keep=("messages", …)` (production code, main + fallback paths). (3) `cache_set_json` moves off deprecated `redis.setex` to `set(key, value, ex=ttl)` — its 16 contract tests updated; the ~20 other `.setex(` call sites across connectors/domains are an identified follow-up sweep (argument-order swap, done separately with care). (4) The `starlette.testclient` httpx deprecation is filtered with a scoped, documented entry (the real fix is a pinned `httpx2` dependency migration via `task deps:lock` — tracked as debt). Remaining known noise: a non-deterministic GC-attributed `Connection._cancel` RuntimeWarning in the proactive-runner tests (same family as the documented `unclosed transport` filter).
- **v1.23.5 security note genericized** — the entry documenting the SSH-coordinate scrub still quoted the literal private IP it described removing; replaced with a neutral phrase (the RFC-5737 fixture value stays by design).

### Tests

- Characterization-first, again validated by construction: the golden net caught two wrong assumptions while being written (the `ChatStreamChunk.type` Literal, the unclosed sync-path voice services) and stayed green identically through the extraction. Suites: 969 agents + 9,097 fast-unit green, coverage gate replayed at 53 % (≥ 45), MyPy strict clean on the new modules, fresh Docker boot verified healthy (`Application startup complete`, 28 agents, `/api/v1/health` 200).

## [1.23.5] - 2026-07-10

> Security-hygiene release: production maintenance stops handling credentials, and the repository stops shipping real server coordinates. The post-deploy reindex runbook (`scripts/prod-reindex-gemini.sh`) instructed the operator to paste a **superuser session cookie** into a `curl` command run over SSH on the prod box — a replayable admin bearer token that lands in `~/.bash_history` (and its backups), defeating the `HttpOnly` flag the cookie is deliberately set with, even though the same script already held root-level `docker exec` access three steps above. RAG Spaces reindexation now runs fully in-container through a new CLI, consistent with the sibling embedding reindex. In the same pass, the real production SSH coordinates (host, port, username) were scrubbed from five tracked files and aligned to the repo's existing `<user>@<prod-host>` placeholder convention.

### Security

- **Reindex runbook no longer transmits a session cookie** — `scripts/prod-reindex-gemini.sh` step 5 printed a `curl -X POST /rag-spaces/admin/reindex -H "Cookie: session_id=…"` instruction, training the operator to exfiltrate an `HttpOnly` superuser cookie from the browser into shell history on the production host — a full-admin bearer token, replayable and long-lived, with only `SameSite=Lax` as CSRF defense. It is replaced by an in-container `docker exec … python scripts/reindex_rag_spaces.py` call: no HTTP round-trip, no cookie, consistent with steps 2-4 which already reindex via `docker exec` (the operator is already root-equivalent inside the box). (CWE-522 / CWE-532 / CWE-214.)
- **Real production SSH coordinates scrubbed from tracked files** — the real production host, SSH port and username appeared verbatim in five tracked files (the reindex script header, the `PublicEndpointDown` and `COMPACTION_v2` runbooks, a DevOps SSH test fixture, and a historical CHANGELOG note). They are aligned to the `<user>@<prod-host>` placeholder convention already used by `infrastructure/README.md` and `docker-compose.prod.yml`; the test fixture moves to RFC-5737 documentation values (`192.0.2.10`). Recon-only exposure (an RFC-1918 address behind the Cloudflare tunnel, LAN port refused externally), removed for hygiene. (CWE-200.)

### Added

- **`scripts/reindex_rag_spaces.py`** — CLI companion to `reindex_embeddings.py` that re-embeds every user RAG document with the currently configured model, in-container, to completion. It is the operational equivalent of `POST /rag-spaces/admin/reindex` without the HTTP layer or a session cookie; loads provider API keys from the DB (as the sibling script does) before embedding.
- **`run_in_background` flag on `start_reindexation`** — HTTP callers keep the detached fire-and-forget behaviour (default `True`); the CLI passes `False` so the process awaits `_reindex_all_documents` instead of exiting and killing the work mid-flight. Single source of truth for the setup/guard logic (Redis mutex, dimension `ALTER`, singleton reset) — no duplication.

### Tests

- 2 unit tests on the `run_in_background` branch: `False` awaits the reindex to completion and never detaches it; `True` (default) detaches via `safe_fire_and_forget` and never awaits inline. First direct coverage of `start_reindexation`. The DevOps SSH service fixture change is behaviour-neutral (assertions pin command structure, not the coordinates).

## [1.23.4] - 2026-07-10

> Hardening release closing the last gap in the tool protection policy. A full inventory of the 47 tool modules found that the image generation tools — among the most expensive per-call paid APIs in the catalogue — were the **only** family carrying neither `@track_tool_metrics` nor `@rate_limit`, with no client-layer limiter either (`ImageGenerationClient` is a standalone ABC, unlike Perplexity/Brave whose connector clients embed a Redis rate limiter). Their only guards were the usage-limits cost caps — per billing cycle and Redis-cached (~30 s TTL), so a runaway ReAct loop or a prompt-injection burst could overshoot them before they bite. Both tools now carry the full standard decorator stack, and the DevOps Claude CLI tool (a paid Claude run **plus** real actions on a remote server over SSH) gains its own per-user ceiling. Every threshold is settings-driven — tunable in production without rebuild.

### Added

- **Rate limiting + standard metrics on image generation** — `generate_image` and `edit_image` now carry `@track_tool_metrics` (`agent_tool_invocations` / `agent_tool_duration_seconds` under `image_generation_agent`) and a settings-driven per-user `@rate_limit` (sliding window, default **10 calls / 5 min**, tracked separately per tool). Exceeding the threshold short-circuits the tool **before** the paid API call with the standard `rate_limit_exceeded` payload (`retry_after_seconds` included) and increments `agent_tool_rate_limit_hits_total`. New settings: `IMAGE_GENERATION_RATE_LIMIT_CALLS` / `IMAGE_GENERATION_RATE_LIMIT_WINDOW`.
- **Rate limiting on the DevOps Claude CLI tool** — `claude_server_task_tool` (already metric-tracked, admin-only) gains a per-user `@rate_limit` (default **5 calls / 10 min**): each call is a paid Claude CLI run plus real SSH actions on a server; admin-only reduces exposure but not runaway risk, and each task lasts up to ~120 s wall-clock so the ceiling cannot hinder normal sequential admin use. New settings: `DEVOPS_RATE_LIMIT_CALLS` / `DEVOPS_RATE_LIMIT_WINDOW`.

### Fixed

- **Image generation was outside the tool protection policy** — the systemic rule "every tool carries `@track_tool_metrics` AND `@rate_limit`, especially tools hitting paid external APIs" cited image generation by name, yet the module had neither decorator and no protection at any other layer. Both execution paths are covered: the parallel executor injects the `ToolRuntime` the limiter keys on before its direct coroutine calls, and the ReAct loop gets it via standard LangChain injection.

### Tests

- 11 new unit tests (no DB, no network): threshold exceedance returns the standard `rate_limit_exceeded` payload anchored on `ToolErrorCode.RATE_LIMIT_EXCEEDED` for all three tools, `generate_image` / `edit_image` have independent per-tool sliding windows, the Prometheus hit counter fires exactly once per block, and thresholds are read from settings at call time (never hardcoded). Registry smoke green (96 tools); full fast suite **9,082 passed**.

## [1.23.3] - 2026-07-10

> The semantic layer becomes deterministic and fully wired, and every request gets faster. Three worksites land together. **Latency**: the router's semantic pivot now runs in parallel with memory resolution (**−1.1s p50 on the first token of every graph turn**, measured n=5), the response-context bundle is prefetched at router entry, and a new per-stage duration histogram makes the whole graph measurable in production. **Semantic reliability** ([ADR-120](docs/architecture/ADR-120-Semantic-Evidence-Expansion-And-Param-Guard.md), [ADR-121](docs/architecture/ADR-121-Semantic-Annotation-Backfill.md)): the recurring "route to my brother" failure — the plan sometimes geocoded the person's _name_ to a random location and cached the wrong route — is closed at three levels (deterministic person-reference evidence, a manifest-driven runtime guard in both execution modes, and an unresolvable-destination error in `get_route`), and the audit it triggered revealed that **73 of the 99 ontology types were consumed by no tool manifest**: ~130 annotations later, cross-domain chains like "email the attendees of this meeting" or "reply to the sender" are finally expressible. **Background-run robustness** (ADR-117 follow-up): a hard-killed producer (kill -9, OOM, power loss) can no longer leak TTL-less Redis keys nor leave subscribers waiting forever — orphaned streams now end with a clear, localized error. The measurement protocol behind the latency numbers ships in the repo (`scripts/perf/measure_ttft.py` + [docs/optim/LATENCY_PLAN.md](docs/optim/LATENCY_PLAN.md)).

### Added

- **Runtime semantic parameter guard ([ADR-120](docs/architecture/ADR-120-Semantic-Evidence-Expansion-And-Param-Guard.md))** — `semantic/param_guard.py`, manifest-driven, zero per-tool hardcode: a tool argument that is _exactly_ a person name resolved this turn on a parameter typed `physical_address`/`email_address` fails fast with a recoverable error BEFORE the paid API call, in both execution modes (parallel executor via `configurable.resolved_person_names` — sourced from state, the only conduit that survives a HITL resume — and the ReAct execute-tools node, before the HITL interrupt so users are never asked to approve a doomed call). Fail-open by design; metric `semantic_param_guard_blocks_total{tool_name,semantic_type,execution_mode}`.
- **Evidence-driven domain expansion under flag ([ADR-120](docs/architecture/ADR-120-Semantic-Evidence-Expansion-And-Param-Guard.md))** — `SEMANTIC_EXPANSION_EVIDENCE_DRIVEN_ENABLED` (ships dark): every referenced entity (person → `Contact`, previously-shown event/place/email → `CalendarEvent`/`Place`/`EmailMessage`) whose ontology `properties` provide a semantic type required by the selected domains' tools adds its provider domains to the planner catalogue — capped (`SEMANTIC_EXPANSION_MAX_ADDED_DOMAINS`), counted (`semantic_expansion_total{evidence_entity,added_domain}`), and anchored on the entity so "quel temps demain ?" never expands blindly. The evidence→entity mapping is completeness-asserted at boot (ADR-085 pattern). For person-only evidence the outcome is identical to the always-on historical path, keeping the future flag flip low-risk.
- **Semantic annotation back-fill ([ADR-121](docs/architecture/ADR-121-Semantic-Annotation-Backfill.md))** — an exhaustive inventory of the live catalogue (75 tools) found **31/224 parameters (14%) and 75/336 outputs (22%) semantically typed, with 73/99 ontology types consumed by no manifest**. ~130 one-line annotations across 15 manifest files later: **120/224 params (53%), 137/338 outputs (40%), 72/100 types consumed**. Flagship chains pinned by tests on the real manifests: event attendees → `send_email.to`, email sender → `create_event.attendees`, `route.destination` → weather/places location, place address → contact address. Campaign rule: no output annotated without verifying the path against the real tool payload (Jinja references execute on it) — which is how `emails[].from` was found NOT to exist (Gmail buries the sender in `payload.headers[]`, unaddressable): it is now promoted top-level in `build_emails_output`, mirroring the existing `subject` promotion.
- **`EmailMessage` ontology entity** — `properties = {sender: email_address, thread: thread_id, identifier: message_id}`: a referenced email becomes expansion evidence ("invite the sender of this email to the meeting").
- **Per-stage graph duration instrumentation** — `langgraph_stage_duration_seconds{stage,execution_mode,turn_kind}` histogram observed at the SSE chokepoint (buffered, flushed at turn end and HITL interrupts) plus a per-turn `graph_stage_durations` structured log (Loki-queryable where multiprocess Prometheus is unavailable); `agent_node_duration_seconds` extended to router/planner/ReAct nodes; TTFT/streaming/router/validator histogram buckets recalibrated to production (RPi5) scales.
- **Reproducible TTFT measurement protocol** — `scripts/perf/measure_ttft.py` (13 scenarios × pipeline/ReAct, cache-busting variants, HITL seed turns, per-stage and per-LLM-site `/metrics` deltas) and [docs/optim/LATENCY_PLAN.md](docs/optim/LATENCY_PLAN.md) (systemic baseline, stage×path matrix, decision log with before/after for every optimization).
- **Orphaned-run exit for background streams** (ADR-117 hard-kill follow-up) — the SSE relay now probes the conversation's heartbeated active-run lock during chunk silence: lock missing (or owned by another stream) for a full grace period → synthetic, localized `error` + `done{error, orphaned}` chunks instead of an infinite wait. The heartbeated lock is the liveness source of truth (a long LLM call is silent but alive), a probe failure is never treated as a missing lock, and `BACKGROUND_RUNS_ORPHAN_GRACE_SECONDS` is boot-validated ≥ 2× the producer heartbeat. Worst-case exit after a crash ≈ 70s in production.

### Changed

- **Router: semantic pivot ∥ memory resolution (latency R1)** — the English-pivot LLM call now overlaps the memory-resolution phase inside `analyze_full` (the phases are data-independent: memory embeds the original-language query). **Router stage −1.1s p50, 100% of graph turns**, both modes, zero behavioural drift (n=5 × 13 scenarios, 0 errors). The pivot task is cancelled best-effort if analysis fails first.
- **Response-context prefetch at router entry (latency R2)** — the response node's context bundle (personality, memory, TTS…) starts loading when the router starts instead of when the response node is reached (flag `RESPONSE_CONTEXT_PREFETCH_AT_ROUTER_ENABLED`, default on); the system-RAG part stays deferred to the response node because app-help detection doesn't exist yet at router time (`ResponseContextBundle.system_rag_deferred`). −0.1/−0.3s pre-first-token on conversational/ReAct turns in dev; larger expected in production.
- **Semantic pivot behind a flag (latency R3)** — `SEMANTIC_PIVOT_ENABLED` (default on, no behaviour change): the A/B run (135 vs 117 FR turns) showed zero intent/domain/route drift with the pivot off and ~zero latency delta post-R1 (the memory branch dominates) — the flag turns a future "−1 LLM call per turn" cost decision into a one-line flip once a broader corpus is validated.
- **Person-reference evidence made deterministic ([ADR-120](docs/architecture/ADR-120-Semantic-Evidence-Expansion-And-Param-Guard.md))** — the semantic-expansion trigger `has_person_reference` is now the union of three sources (memory-resolver mappings — person references by construction; Phase-1 extracted relational references, preserved even when resolution finds no memory fact via the new typed `MemoryResolution` result; analyzer-LLM person refs — the historical, intermittent signal that was previously the ONLY one consulted, in contradiction with the expansion service's documented contract). Evidence sources are logged and surfaced in the debug panel. One corrected domain list feeds the planner catalogue, the planner prompt's semantic-dependencies section AND the ReAct system prompt — the fix serves both modes.
- **Stream safety TTL from the first chunk** (ADR-117 hard-kill follow-up) — every chunk `XADD` now pipelines an `EXPIRE NX` in the same round-trip: the stream key carries a bounded safety TTL (`BACKGROUND_RUNS_STREAM_SAFETY_TTL_SECONDS`, boot-validated ≥ stream TTL) from its very first entry, self-re-arming, while `publish_end` keeps overwriting it with the short post-terminal TTL. A producer dying without its terminal marker can no longer leak a TTL-less key through the Redis AOF.

### Fixed

- **"Route to my brother" intermittently geocoding the person's name** — the exact failure chain (memory resolved the person but the analyzer omitted the person typing → no contact expansion → `get_route(destination="<person name>")` → arbitrary geocode → wrong route **cached 300s**) is closed at all three levels: deterministic evidence (above), the runtime guard (above), and `get_route` now returning a recoverable `destination_unresolved` error when a non-address destination that Places cannot find would otherwise be passed raw to the Routes API — nothing is cached on that path, and the error message steers the model to fetch the real address first. A Places _API failure_ still passes through (an outage is not evidence the destination is bad).
- **Listener counter crash window** (ADR-117 hard-kill follow-up) — `INCR` and `EXPIRE` ran as two separate Redis calls; a crash between them produced a TTL-less counter stuck >0, wrongly triggering paid voice synthesis for absent listeners forever. The increment is now a single Lua `EVAL` (symmetric with the existing decrement), which also saves a round-trip.
- **PII at INFO level** — resolved person-name mappings were logged in clear at INFO in the query analyzer; now counts at INFO, contents at DEBUG.
- **Semantic-linking tests ran against an empty registry** — the `agent_registry` fixture's docstring claimed manifests "auto-load"; they never did, so every historical Jinja2-suggestion test silently exercised the not-found path. The fixture now calls `initialize_catalogue()` and the new flagship-chain tests pin real suggestions on real manifests.
- **Dead code removed** — the never-wired `expand_domains_semantic` (threshold-based expansion) and its orphan setting `SEMANTIC_EXPANSION_THRESHOLD` (defined, read by nobody) are deleted, superseded by evidence-driven expansion; stale plural-vocabulary docstrings in the semantic module corrected to the singular domain registry; `TERMINAL_STATUSES` in the stream broker now includes `cancelled` (the tuple was documentation that lied).

### Tests

- **+52 tests** (suite at **9,093 passed**): person-evidence gate (E1/E2/E3 sources, entity mapping), runtime param guard (exact-match, list params, fail-open paths, config plumbing), `get_route` destination guard (marker + tool conversion + passthrough cases), evidence-driven expansion (entity anchoring, cap determinism, per-entity cases, boot-assert refusal), semantic-pivot overlap (R1 contract: memory gets the original query, analyzer the awaited translation, no orphaned task), system-RAG deferral, flagship semantic chains on real manifests, and an integration test for the orphaned-stream exit.

## [1.23.2] - 2026-07-10

> The alerting chain comes back to life ([ADR-119](docs/architecture/ADR-119-Alerting-Reactivation-Minimal-Core.md)). Alerting had been silently disabled since 2026-01-16 — ~71 maintained rules and 22 runbooks were dormant, nobody was notified of any incident (the only signal was the daily logwatch digest), and DORA MTTR was unmeasurable. This release ships a minimal viable core of **13 vital alerts** evaluated by Prometheus and delivered by **email** through a dedicated Alertmanager in production, proven end-to-end in dev (Redis stopped → `[CRITICAL]` email in the inbox in 3m30 → restart → `resolved` email). The audit that preceded the reactivation found the legacy thresholds **corrupted** (blind ×1.5/×3/×7.5 multipliers on bounded percentages — production disk alert at 147% usage, literally unfireable), which is why the core is a fresh, unit-tested rule set rather than a blanket re-enable.

### Added

- **13-alert core (`alerts-core.yml`)** — ServiceDown, DatabaseDown (`up` OR `pg_up`), RedisDown, DiskSpaceCritical, ContainerMemoryNearLimit, ContainerRestartLoop, HighErrorRate (with a **minimum-traffic guard** so low-volume periods can't fire 100%-of-2-requests noise), SSELatencyP95High (threshold set above the measured production TTFT baseline to catch degradation, not enforce an aspirational SLA), BackupFailed, PublicEndpointDown, CertificateExpirySoon, plus two meta-alerts (AlertmanagerDown, ObservabilityScrapeTargetMissing). Every alert annotates its runbook; thresholds are `ALERT_CORE_*` variables in `thresholds/{env}.env` rendered by the existing `prepare_config.sh` pipeline, and **descriptions reference the same template variables as expressions** — the displayed threshold can never drift from the firing threshold again.
- **Alertmanager in production** (`docker-compose.prod.yml`, 128M/0.25 cpu — RPi5-scale like the other sidecars): the pre-existing entrypoint renders the config from `ALERTMANAGER_*` env vars and auto-selects the **email-only** template when Slack/PagerDuty are unset; missing SMTP degrades to log-only instead of crashing. Grafana unified alerting deliberately stays unused (no `promtool test rules` equivalent, evaluation load on a tightly-sized Grafana, silent single point of failure).
- **blackbox-exporter** (64M/0.1 cpu, both compose files) probing what no existing exporter saw: the postgres-backup sidecar's healthcheck webhook (`BackupFailed` — ADR-109 restore capability at risk) and the public URL end-to-end through Cloudflare edge → cloudflared tunnel → web (`PublicEndpointDown`, `CertificateExpirySoon`). The public target is injected at Prometheus startup from `BLACKBOX_PUBLIC_PROBE_URL` (.env) into a file_sd file — the real domain never lands in the open-source repo; empty variable = probe disabled (dev default).
- **17 promtool unit tests** (`prometheus/tests/alerts_core_test.yml`) — 13 firing cases + 4 negative cases (disk below threshold, healthy Redis, the HighErrorRate traffic guard) asserting labels **and rendered annotations**, so the threshold values displayed in notifications are pinned to the expression values by CI-runnable tests.
- **4 new runbooks** — [RedisDown](docs/runbooks/alerts/RedisDown.md), [BackupFailed](docs/runbooks/alerts/BackupFailed.md), [PublicEndpointDown](docs/runbooks/alerts/PublicEndpointDown.md) (covers the recurring cloudflared-tunnel incident profile), [AlertmanagerDown](docs/runbooks/alerts/AlertmanagerDown.md) (the meta-alert that cannot email you by definition — assumed limitation documented, external dead-man's-switch listed as future hardening).

### Changed

- **Alertmanager configuration consolidated** under `infrastructure/observability/alertmanager/` — it lived in `apps/api/monitoring/` (mounted by dev) with a divergent orphaned copy under `prometheus/alertmanager/`; infra config does not belong to the API app. Line endings normalized to LF (the entrypoint is a POSIX sh script executed in-container). Never-loaded custom alert files regrouped under `infrastructure/observability/prometheus/alerts/`.
- **`prepare_config.sh`** now renders `alerts-core.yml` first (the only file Prometheus loads), labels the legacy renders as NOT loaded, and prefers the repo venv's Python (system python lacking jinja2/pyyaml made the script unusable on dev machines).
- **Alerting docs consolidated**: new canonical [README_ALERTING.md](docs/readme/README_ALERTING.md) (architecture, entrypoint mode-selection table, SMTP provider notes, routing/inhibitions, the 5 validation commands, troubleshooting — including the "Gmail filter moves alerts out of INBOX" trap observed during the E2E test); `README_ALERT_MANAGER2.md`, `README_PROMETHEUS_ALERTMANAGER.md` and `README_ALERTING_SMTP.md` (~3,575 lines describing dead mechanisms or duplicating legacy YAML) deleted; [README_PROMETHEUS_THRESHOLDS.md](docs/readme/README_PROMETHEUS_THRESHOLDS.md) rewritten around the live pipeline and the legacy-threshold corruption.
- **`.env` surfaces**: `BLACKBOX_PUBLIC_PROBE_URL` added to `.env.example` / `.env.prod.example`; `.env.min.prod` gains the minimal `[11] ALERTING` section (SMTP + recipient + probe URL) — the alerting chain is configurable from the minimal deployment file.

### Fixed

- **Legacy alert thresholds proven corrupted and quarantined** — the 2025-11 threshold generator applied blind environment multipliers (production ×1.5, staging ×3, development ×7.5) to bounded percentages: `DiskSpaceCritical` at **147%** disk usage in production (294% staging, 735% dev), CPU/memory at 142.5%, error rate at 30% instead of the documented 5%. Even if re-enabled, disk/CPU/memory/5xx alerting could never have fired. The legacy files stay unloaded with recalibration mandated before any group returns to `rule_files`; threshold-file headers now state it and `README_PROMETHEUS_THRESHOLDS.md` documents the corruption table.
- **Even the dev Alertmanager was a zombie** — the container ran but Prometheus neither loaded any alert rule nor targeted it (the shared `prometheus.yml` had the `alerting:` block commented out); dev now exercises the same chain as production, which is how the E2E proof was run.
- **Housekeeping of the living config directory** — 22 one-shot migration scripts, `.original/.production/.rendered` archives and analysis dumps deleted from `infrastructure/observability/prometheus/` (zero references outside historical docs, recoverable from git history); 126 lines of dead code (`THRESHOLD_MAPPING`) removed from `render_alerts.py`; legacy rendered rule files resynchronized with their templates.

## [1.23.1] - 2026-07-10

> The 360° technical audit becomes a public, reproducible artifact. `docs/audit/` now ships the full report — **8.4/10 across 24 areas** on the ISO/IEC 25010 grid, pinned to commit `182f3927` — together with the protocol that produces it (scope, depth, evidence requirements, scoring discipline, publication pipeline) and the committed measurement script. The landing proof band, README, FAQ, /story pages, SEO descriptions and knowledge base all point to it, and every published audit figure was refreshed from the stale 8.0/20-areas to 8.4/24 in the same sweep.

### Added

- **Public audit report — [docs/audit/README.md](docs/audit/README.md)**: 24-area scorecard with evidence highlights, the finding→ADR→release remediation-loop table (10 findings resolved in 48h, each shipped with its ADR), openly published worksites, DORA read-out, audit history, and a "Reproduce it yourself" section with the exact commands — including a transparency note documenting the test-isolation quirk the audit itself uncovered when running unit+agents in a single pytest process.
- **Reproducible audit protocol — [docs/audit/AUDIT_PROTOCOL.md](docs/audit/AUDIT_PROTOCOL.md)**: 7 non-negotiable invariants (commit pinning, evidence-only findings, counter-verification, executed suites, logical-SLOC metrics, register continuity, inline conduct), per-area minimum evidence sets for all 24 areas, anchored scoring discipline, and the 7-step constants-first publication pipeline — a future audit cycle is triggered by a single request and lands on every public surface. `CLAUDE.md` documentation pointers reference it.
- **`scripts/audit/measure_sloc.py`**: the official size-metrics tool — logical SLOC via tokenize + AST (docstrings, comments and blank lines excluded), file- and function-level, with the data-module exemption list (i18n tables, configuration, constants) that keeps "god file" scoring honest. Standard library only.
- **Landing — the audit tile is now a link**: the proof-band "360° technical audit" tile opens the full public report on GitHub (new `AUDIT_REPORT_URL` constant, `aria-label` in all 6 languages, keyboard-focus ring) instead of being a static figure.
- **README — audit surfaces**: a `360° audit 8.4/10` badge in the header block, an audit row in the Tests → Statistics table, and direct links from the "Built by an AI" section and the Performance note to the public report.

### Changed

- **All published audit figures moved to 8.4/10 across 24 areas** (previously 8.0/10 across 20): landing constants (`auditScore`, new `auditAreas`), proof-band tile values in the 6 locales, the "who wrote this code" FAQ answer ×6, the REX stats block (value and label) ×6, the /story pages ×6 — which now also link to the full report — the story SEO descriptions ×6, `docs/knowledge/01_getting_started.md`, and `docs/INDEX.md` (new audit entry).

### Fixed

- **19 stale audit-figure occurrences** on public surfaces still claiming 8.0/10 across 20 areas after the July 9 re-audit — FAQ answers, REX stats labels, story SEO meta-descriptions and the knowledge-base entry that feeds the in-app system FAQ (RAG) — found by the repository-wide sweep now mandated by the audit protocol's publication pipeline.

## [1.23.0] - 2026-07-09

> Chat-driven skill import (ADR-118): the skill-generator now delivers finished skills directly into "My Skills" — no more copy/paste of code blocks, manual folder assembly, or zip upload. The audit of the import pipeline this feature builds on uncovered and fixed a critical path-traversal vulnerability plus three more defects, and multi-turn skill dialogues finally keep their context (history forwarded to the skill runner + a `dialogue: true` frontmatter extension the chat override respects).

### Added

- **Direct skill import from chat ([ADR-118](docs/architecture/ADR-118-Chat-Driven-Skill-Import.md))** — new `import_user_skill` tool (available to the skill ReAct runner): the skill-generator's Phase 4 becomes validate → import → announce the skill by name (pointer to Settings › LIA Skills › My Skills); the imported skill is immediately active. Structured errors (invalid name, 409 conflict, quota) let the LLM fix and retry once; code-block delivery survives only as fallback. Gated by `SKILLS_CHAT_IMPORT_ENABLED` (default on), rate-limited 5/min/user, text-file extensions only.
- **`SkillImportService`** — single hardened pipeline shared by all import paths (user upload, admin upload, chat tool): staging in a temp directory, strict validation, then atomic swap into the live skills tree — a failed import can no longer damage an existing skill. Router endpoints become thin delegates (service-layer rule).
- **Multi-turn skill dialogues (S5)** — two complementary fixes. The skill ReAct runner (fresh sub-agent each turn, previously fed only the last user message) now receives the windowed conversation history in a `<conversation_history>` block with resume instructions. And the QueryAnalyzer's chat override — which cleared any detected `skill_name` on conversational turns (anti-contamination for one-shot skills) and thereby structurally killed dialogue flows — now preserves skills declaring the new `dialogue: true` frontmatter extension (the skill-generator does; a data-level test pins it). One-shot skills keep the anti-contamination behavior.
- **Import failure atomicity** — the previous version of a re-imported skill is parked during the disk swap and restored on any post-swap failure (DB registration/commit): a failed import can neither destroy an existing skill nor leave disk and DB diverging; a lost registration race answers 409 with the disk rolled back. Conflict/quota checks read both the DB (registration authority) and the cache (disk view); re-importing one's own skill at the quota cap is no longer wrongly rejected.
- **Anti-drift parity tests** — the skill-name contract (loader / import service / sandboxed `validate_skill.py`) and the generator's `VALID_AGENTS` vs `DOMAIN_REGISTRY` are pinned by CI tests: agent renames or additions now force a conscious generator-side decision instead of silently breaking generated plan_templates.

### Fixed

- **S1 — path traversal at skill import (critical)** — the frontmatter `name` was concatenated into the destination path without validation (`name: ../../system/x` overwrote a _system_ skill's SKILL.md for all users). Strict agentskills.io name validation now runs before any filesystem write, on every import path.
- **S2 — cross-scope name collision** — a user import reusing a system skill's name silently rewrote the system row's description (DB is the display source of truth) for everyone; reusing another user's name updated their row and left the importer without a `user_skill_state` (ghost skill). User imports that would shadow a system skill or collide with another user are rejected (409, existence not disclosed); re-importing one's own skill upserts.
- **S3 — zip expansion** — no decompressed-size/member-count guard (zip bomb) and `extractall` wrote whole multi-root archives while only one root was validated (could overwrite the user's other skills). Extraction is now bounded (`SKILLS_ZIP_MAX_DECOMPRESSED_KB`, `SKILLS_ZIP_MAX_FILES`), zip-slip-checked per member, and limited to the SKILL.md subtree; flat zips are keyed by the validated frontmatter name (fixes the `imported-skill/` collision between successive flat imports).
- **S4 — validation divergence** — the importer was lenient while the generator's `validate_skill.py` was strict ("will be REJECTED by the importer" was false). Both now enforce the same name contract.

## [1.22.0] - 2026-07-09

> Background chat runs (ADR-117): chat generation no longer depends on the HTTP connection. Before this release, closing the tab or navigating away mid-generation lost BOTH the user message and the in-progress answer (archiving only ran after graph completion, inside the SSE generator), and the tokens the provider had already billed were never recorded. A detached producer now finishes every run server-side through a per-run Redis Stream; returning users reattach to the live stream (full replay, then live tail); a stop button cancels cross-worker in ~1s, keeping and badging the partial answer. Shipped in three lots behind one flag (default off), each de-risked by executed POCs before a line of production code.

### Added

- **Background chat runs — durability ([ADR-117](docs/architecture/ADR-117-Background-Chat-Runs.md), Lot 1)** — a detached asyncio producer consumes the (already transport-agnostic) `stream_chat_response` generator and publishes every chunk to a per-run Redis Stream (`chat:run:{stream_id}`, MAXLEN-capped, TTL armed at the terminal marker); the SSE endpoint becomes a mere subscriber (short-block XREAD loop — a blocking XREAD ≥ the client `socket_timeout` raises `TimeoutError` on redis-py 8, proven by POC before design). The stream ALWAYS terminates (`completed`/`error`/`killed`, end-marker publication shielded on hard kill) so a subscriber can never hang; hard-killed runs archive their partial content flagged `interrupted`. `run_id` (billing, reused across HITL resumptions) and `stream_id` (transport, fresh per POST) are deliberately distinct — merging them broke HITL resumption on a stale end marker (caught in self-review, pinned by regression test). Flag-gated by `BACKGROUND_RUNS_ENABLED` (default **off** — instant rollback); technical doc: [BACKGROUND_RUNS.md](docs/technical/BACKGROUND_RUNS.md).
- **Live reattachment (ADR-117, Lot 2)** — per-conversation active-run registry (`SET NX EX` lock + producer heartbeat + zombie-safe conditional-release Lua): a concurrent send answers **HTTP 409** with the in-flight run's id instead of racing it. New endpoints `GET /agents/runs/active` and `GET /agents/runs/{stream_id}/stream` (ownership-checked with `hide_existence`; full replay without pacing, then live tail — the replay→live boundary is a `: replay-end` SSE transport comment, the chunk contract is untouched; stale voice-audio chunks dropped server-side during replay). The chat page silently reattaches at mount and on tab-visibility return; a 409 on send triggers auto-reattach with an info toast. During replay, `SSEHandlerContext.isReplay` suppresses out-of-reducer side effects (toasts, live audio) while the reducer rebuilds the in-progress bubble. Subscriber presence (`chat:listeners:{stream_id}`, TTL re-armed periodically by attached subscribers) gates every voice-synthesis start point: no TTS is generated for a run nobody is listening to (fail-open on Redis errors; a listener attaching mid-run gets voice for the remainder).
- **User cancellation (ADR-117, Lot 3)** — the send button morphs into a **stop button** while streaming; `POST /agents/runs/active/cancel` resolves the caller's own active run server-side and arms a cancel signal polled by a producer-side watcher (stop latency ≈ 1 s, works across workers — the producer may live in another process than the HTTP handler). Terminal status `cancelled` is distinct from `killed` in metrics and archive metadata; the producer synthesizes a standard `done` chunk carrying `metadata.cancelled` so attached subscribers close their normal SSE lifecycle; the partial answer is kept and badged "interrupted ⏸" (same metadata flag live and after reload); tokens already consumed stay billed. Cancellation is not a rollback: tools that already executed have acted.
- **Turn-start checkpoint repair (`sanitize_stale_dangling_tool_calls`)** — a cancelled/killed ReAct run can leave an `AIMessage` with unanswered `tool_calls` in the LangGraph checkpoint, which strict providers reject on the next turn ("tool_calls must be followed by tool messages" — poisoning proven by POC with unique call ids). Repaired at turn start in the router node via reducer operations (same-id replacement keeping answered calls and text; `RemoveMessage` for empty shells) — deliberately NEVER in the messages reducer, where an unanswered `tool_calls` is a legitimate mid-run state; HITL resumptions re-enter via `Command(resume)` without passing through the router, so pending approvals are unaffected. Replacements drop `additional_kwargs` on purpose (providers mirror raw tool_calls there, which would re-poison).
- **11 new settings** (`BackgroundRunsSettings`, all env-tunable, documented in the three `.env` example files) with a boot-time guard refusing a heartbeat period that would let the active-run lock flap (`> TTL/2`); **2 Prometheus metrics** (`chat_background_producers_active`, `chat_background_runs_total{status}`); structured events on every producer lifecycle transition; graceful-shutdown drain in the lifespan (producers first, then generic background tasks — wiring `wait_all_background_tasks`, present but dead until now) with `stop_grace_period: 90s` in both compose files.

### Changed

- **User message archived FIRST (ADR-117)** — the user message is persisted before graph execution starts (previously: after completion, inside the SSE generator — the root cause of message loss on disconnect), with its HITL flags patched at end of run; the three legacy end-of-run archiving cases collapse into one patch step. Scheduled/HITL-resumed turns deduplicate instead of double-archiving.
- **Billing honesty on interrupted runs (ADR-117)** — `TrackingContext.__aexit__` now commits token usage on EVERY exit path (shielded persist on `CancelledError`): a run killed by deploy, network loss or user cancellation records the tokens the provider actually billed. Previously an interrupted run left zero trace in token accounting.
- **SSE endpoint demoted to subscriber (ADR-117, flag on)** — `POST /agents/chat/stream` no longer executes the graph in the response generator: it spawns the detached producer, then serves the Redis Stream. Client disconnect stops the _subscription_, never the _generation_. Flag off = strictly the legacy path.

### Fixed

- **Chat turn lost on navigation/close during generation (ADR-117)** — the original defect: with the flag on, both the user message and the assistant answer now survive tab close, navigation, network loss and even an API restart mid-run (drain + partial archiving); the answer is waiting in the conversation on return, or resumes live if generation is still in flight.
- **Presence TTL expired during long attachments (ADR-117, caught in self-review)** — the listener counter's TTL was armed only at attach; on generations longer than the TTL, a continuously attached subscriber silently dropped out of the presence set and voice synthesis was wrongly skipped. Attached subscribers now re-arm the TTL periodically (~TTL/3); pinned by test.

### Verified

- **ADR-117 de-risked before implementation**: four executed POCs (detached-producer survival/cancel/reattach; Redis Streams throughput + the redis-py `socket_timeout` XREAD trap; LangGraph cancellation semantics including the dangling-`tool_calls` poisoning proof; worker recycling with/without lifespan drain) plus two Lot-2 POCs (lock semantics, replay pacing). Live E2E proofs on the dev stack for each lot: a disconnected run finishing server-side with DB rows and 7,207/666 tokens billed; HITL approval flow across the broker; API restart mid-run archiving the partial as `interrupted`; a 322-chunk replay followed by `: replay-end` and a live tail; 409 + auto-reattach on concurrent send; cancellation in ~1 s with `done{cancelled:true}`, lock released, the next message healthy, and the cancelled run billed 1,348/748 tokens.
- 8,960 backend unit tests + 24 dedicated integration tests green; 453 vitest tests green with ratchet thresholds active (threshold blocking demonstrated in both directions); tsc, eslint and prettier green over the whole frontend; black/ruff/mypy strict clean; i18n parity green (6 locales); both dev apps boot healthy (web chat 200, API `/health` 200 with PostgreSQL + Redis probes green).

## [1.21.26] - 2026-07-09

> Frontend test foundation (ADR-116). The product's most critical state machine — chat SSE streaming + HITL approval flows + voice mode — was protected only by `tsc`/`eslint` (19 test files for 448 sources), and the coverage tooling itself was fictional: `@vitest/coverage-v8` was never installed and the CI step ran `pnpm test -- --coverage`, whose flag pnpm silently swallows — no frontend coverage report had ever been produced or uploaded. The foundation lands in three layers (pure logic at 100%, hooks over scripted I/O, ratcheted thresholds that gate CI), writing the tests surfaced and fixed four user-facing bugs (an infinite voice "processing" spinner among them), and the SSE wire contract is now purged of its 8 never-emitted types and locked by an executable frontend↔backend symmetry invariant.

### Added

- **Frontend test foundation ([ADR-116](docs/architecture/ADR-116-Frontend-Test-Foundation.md))** — +234 vitest tests (200 → 434, 19 → 38 files). Layer 1 at **100% statements/branches/functions/lines**: `chat-reducer(-errors)` (every action and transition, input states deep-frozen so reducer immutability is proven, not assumed), all 19 SSE handlers (progress accumulation, HITL question streaming with its 3-level fallback ladder, token batching flush ordering, compaction interception), `psycheStore`/`voiceModeStore` (including persist/rehydration). Layer 2 — hooks over scripted I/O, no MSW: `useChat` drives scripted SSE chunk sequences through the REAL `processSSEChunk`→reducer pipeline (full turn, progress→answer replacement, **HITL interrupt→resume cycle**, error paths with token-flush ordering, geolocation interception, totals accumulation); `useVoiceMode` runs its whole machine (wake word → mic-stream reuse → VAD → transcription → TTS → back to listening) with zero real audio via fake `AudioContext`/`AudioWorkletNode`/`getUserMedia` and captured KWS/VAD/WebSocket callbacks; `useConversation` covers the backend→UI mapping, 404 soft paths and reset.
- **SSE contract symmetry test** (`sse-symmetry.test.ts`) — the backend `ChatStreamChunk` Literal is pinned in the test AND re-parsed from `apps/api/.../schemas.py` whenever the file is reachable (host + CI; skipped in the web dev container, which only mounts `apps/web`). Every contract type must have a frontend handler or a justified `ACKNOWLEDGED_UNHANDLED` entry (empty as of this release) — a new backend event type now fails frontend CI until the frontend takes an explicit decision.
- **Ratcheted coverage thresholds** in `vitest.config.ts` — reducers/sse-handlers/stores locked at 100 via per-glob thresholds, the three hooks at their measured values, plus a global floor; set just under measurement, only ever raised, never lowered (doctrine in the config header). Blocking proven both ways during the release (impossible floor → red; impossible glob → red; restored → green). Empirical note documented: on vitest 4.1 the global floor is computed over the whole `include` set — glob-matched files are NOT subtracted.
- **`hitl_streaming_fallback` awareness handler** — the backend emits this when the HITL question LLM stream fails and falls back to a template; the event had been dropping into a debug log as "unknown event type" for months. Now surfaced as a structured frontend warning (no UX change — the fallback question tokens that follow were always handled).
- **`@vitest/coverage-v8` 4.1.10** (devDependency, pinned to the vitest version) — the provider had never been installed; `pnpm test:coverage` crashed on a missing dependency.
- **[GUIDE_TESTING.md](docs/guides/GUIDE_TESTING.md) §18 "Tests Frontend (Vitest)"** — organization, commands (with the `pnpm test -- --coverage` trap documented), threshold doctrine, patterns (scripted chunk driver, deep-freeze, SSE symmetry, audio-less voice testing, SSR branches via `@vitest-environment node`) and known pitfalls (mock identity stability, `skipFull` text reporter).

### Changed

- **SSE wire contract purged (ADR-116)** — 8 never-emitted types removed from the backend Literal (`planner_metadata`, `planner_error`, `hitl_clarification_token/complete`, `hitl_question`, `hitl_rejection/_token/_complete`) together with their dead consumer branches: the router's e2e-metrics extraction (its `agents_count` had been frozen at 0 since `planner_metadata` stopped being emitted — re-feeding the complexity dimension from `execution_step` events is flagged as follow-up) and the Prometheus event-type mapping. Frontend side: phantom `SSEChunkType` entries that never existed in the contract (`node`, `tool_call`, `tool_result`, `metadata`, `content`), the zombie `planner_metadata` handler, ~60 lines of dead log branches in the SSE client, and four dead symbols (`PlannerMetadata`, `OrchestrationMetadata`, `SSE_CHUNK_TYPES`, `SSE_STATUS`). The Literal's docstring now names the symmetry test as its guard.
- **Frontend CI coverage is real** — the CI step runs the dedicated `pnpm test:coverage` script; `pnpm test -- --coverage` forwarded the literal `--` to vitest, which silently ignored the flag, so the Codecov upload (masked by `fail_ci_if_error: false`) had never received a report. The ratcheted thresholds now gate every push.
- **Prettier debt cleared** — all of `apps/web/src` passes `prettier --check` (pre-existing drift on 9 files, `csp.ts` and landing components included, resorbed).

### Fixed

- **Voice mode: infinite "processing" spinner on WebSocket drop** — the connection-drop recovery never fired: the service callbacks are wired once in `startRecording`, so the `state === 'processing'` guard read a stale render-time closure (still `'listening'`) and silently swallowed the drop. The guard now reads the CURRENT machine state from the store; a drop during transcription surfaces the error and returns to listening (a reconnection event is not treated as a drop).
- **Voice mode: unhandled rejection ~10s after every wake-word recording** — the setup-timeout promise was never consumed in the reused-stream + pre-warmed-WS flow (neither `Promise.race` executed), so its rejection fired unhandled into the console after each recording. Default handler attached and the timer disarmed in `finally` once setup completes.
- **Voice mode: `voiceModeStore.setError` corrupted the state machine** — `setError(null)` set the `state` key to literal `undefined` (zustand v5 `Object.assign` copies explicit undefined), and an error forced `'listening'` even with voice mode disabled. Now: error → `listening` if enabled / `idle` otherwise (the documented contract), clearing preserves the current state; `handleError`/`handleConnectionChange` no longer force a trailing `setState('listening')`, so the `state`/`isEnabled` pair stays consistent.
- **Chat stream errors now localized in all 6 languages** — error bubbles were rendered with a hardcoded French prefix (`Erreur de connexion:`) wrapping an English message for every user: the `ChatStreamError.i18nKey` mechanism (session expired, usage limit, 503, network…) had shipped with its keys present in all 6 locales but was never wired. `useChat` now resolves the key through `t()`, the pure reducer renders the payload verbatim, and the generic `errors.chat.connection_error` key is added to the 6 locales (strict parity kept).

### Verified

- 434 vitest tests green with thresholds active; threshold blocking demonstrated in both directions; tsc, eslint and prettier green over the whole frontend; 62 pytest SSE-streaming tests green; black/ruff/mypy strict clean on the touched backend files; i18n parity green (6 locales); both dev apps boot healthy (web chat 200, API `/health` 200 with PostgreSQL + Redis probes green).

## [1.21.25] - 2026-07-09

> Liveness/readiness probes done right (ADR-115), plus a dependency refresh. The audit finding was a dead contract: `GET /health` genuinely probed PostgreSQL and Redis, but probe failures only ever set the payload to `degraded` — the documented `503` branch was unreachable since inception, and no readiness signal existed at all. A consumer census (Docker healthchecks, Taskfile, monitoring scripts, runbooks, the `up{job="api"}` alert) confirmed nothing could depend on the dead branch, so the contract is now split honestly. The same doc-truth pass debunked the "E5 model loading" startup folklore with boot-log measurement, realigned the in-container DevOps doctrine with reality, and repaired `task health`, silently broken since the dev TLS migration.

### Added

- **`GET /ready` readiness probe (ADR-115)** — returns `200` + `status: ready` only when PostgreSQL **and** Redis answer their probe, `503` + `not_ready` otherwise. This is the endpoint for deploy verification, uptime/user-impact monitoring and post-incident checks. Excluded from HTTP request logging alongside `/health` and `/metrics` (`HTTP_LOG_EXCLUDE_PATHS`). Scope is deliberately PostgreSQL + Redis only: LangGraph subsystems can fail at startup with both probes green — the startup-log scan remains the compensating control, now documented everywhere the probes are.
- **[ADR-115](docs/architecture/ADR-115-Liveness-Readiness-Probes.md)** — the liveness/readiness doctrine, the probe-consumer census, and the rejected alternatives (resurrecting the 503, probing LangGraph per-request).
- 8 unit tests (`tests/unit/api/test_health_endpoints.py`) pinning the contract: all four dependency up/down combinations × both endpoints, probes mocked at their lookup points.

### Changed

- **`GET /health` is now an honest liveness probe** — the unreachable 503 branch is removed; the endpoint always returns `200` while the process serves requests, with per-dependency degradation in the payload (`status: healthy|degraded` + `checks`). Docker healthchecks stay on `/health` by design: restarting the API cannot fix a dependency outage, and a 503 would invite restart loops during incidents. The endpoint moved out of `main.py` into `src/api/health.py` — the module path `GUIDE_DEPLOYMENT.md` had been (fictionally) documenting all along.
- **Ops doc-truth sweep** — the compose `start_period: 60s` comment claimed "E5 model loading" (model replaced by Gemini embeddings long ago); boot-log measurement shows the real cost is Alembic migrations (~13s) + the full app import (~14s per process, ×4 workers in prod) — and Whisper STT is lazy-loaded, not part of boot. `GUIDE_DEPLOYMENT.md`'s fictional health-endpoint code sample replaced by the real three-endpoint contract; the ServiceDown runbook gains the canonical "which probe for what" table; post-mitigation verification in 3 runbooks (low-success-rate, HighCPUUsage, HighMemoryUsage) moved to `/ready`; `CLAUDE.server.md` drops two stale claims (prod runs **4 uvicorn workers**, not one; ADR-111 pools **do** recover after a PostgreSQL restart) and teaches the probe split; `getting_started.md` showed a `/health` payload that never existed.
- **`db_connection_pool_waiting_total`** — the `_total`-suffixed Gauge violates Prometheus naming conventions, but the name is referenced by Grafana dashboard 03 ("Connection Pool" panel); kept and documented at the definition site instead of silently blanking the panel.
- **Dependency refresh** (already merged on `main`, released here): redis-py 7.4.0 → 8.0.1 (server stays 7.4; typing fallout fixed at the source, three obsolete `cast(Awaitable)` workarounds removed), vite 7.3.5 → 8.1.3 + @vitejs/plugin-react 6 (vitest engine only; 200/200 vitest green), 40 frontend minor/patch bumps (Radix UI line, Dependabot #178), and five backend transitives via a surgical ADR-112 lock recompile (attrs 26.1, packaging 26.2, icalendar 7.2, rpds-py 2026.6.3, google-genai 2.10). Stack tables across README/guides/GUIDE\_\* aligned with the actual manifests (Node 24 sweep).

### Fixed

- **`docker-entrypoint.sh`** — `pg_isready` probed hardcoded `postgres/postgres/lia` while the rest of the script already used `${POSTGRES_*}`; now reads `${POSTGRES_HOST:-postgres}`, `${POSTGRES_USER:-postgres}`, `${POSTGRES_DB:-lia}` (fallbacks mirror the old literals so the image still boots outside compose, where an unset var would have looped forever). Header no longer claims to be dev-only — `Dockerfile.prod` runs the same script.
- **`task health` was silently broken since the dev TLS migration** — it curled `http://` against the HTTPS API and web, reporting "API down"/"Web down" with everything up. Now probes `https://` with `-fsk`, includes a readiness line, and avoids `curl -o /dev/null` (curl.exe on Windows cannot open `/dev/null` as an argument; the shell redirection is portable). All five service lines verified live.
- **`tests/core/test_logging_middleware.py`** — 5 tests had been failing since Starlette removed the `@app.route` decorator (invisible in CI: `tests/core/` is outside the fast-suite path); rebuilt on the `routes=[Route(...)]` constructor, 10/10 green.

### Verified

- 8,918 unit tests green (fast suite, pre-commit flags); live probe demo on the dev stack: `/health` 200 + `/ready` 200 → Redis stopped → `/health` 200 `degraded` + `/ready` **503** → Redis restarted → both 200; `docker compose config` valid (dev + prod); entrypoint exercised on a real boot (env-driven `pg_isready` confirmed); MyPy strict, ruff, black clean.

## [1.21.24] - 2026-07-09

> Security & code-scanning remediation. A full triage of the GitHub security surface (76 code-scanning alerts, 24 Dependabot alerts, 15 dependency PRs) traced every finding to one of three root causes instead of patching symptoms: a silently broken Security workflow (missing `actions: read` permission — every CodeQL/Trivy upload failed, freezing the main-branch alert baseline since May 11), a Dependabot npm ecosystem scoped to `apps/web` (structurally unable to update the workspace-root `pnpm-lock.yaml`, so every frontend PR failed `--frozen-lockfile`), and Dependabot's per-entry lock edits being incompatible with the ADR-112 hashed lockfiles (group PR #176 shipped an unresolvable lock). On top of the scan repair, the release closes the entire CodeQL `py/empty-except` class (193 live sites, not the 67 the stale scan reported) and fixes a same-day assistant incident: "give me my next N appointments" over-matching the daily-briefing skill, with hallucinated appointments in ReAct mode.

### Security

- **Consolidated dependency bumps (24 Dependabot alerts resolved)**: asyncssh 2.22.0→2.23.0 (GHSA-g794-3fmp-753h, `AuthorizedKeysFile %u` path traversal), langchain-anthropic 1.4.4→1.4.6 (GHSA-gr75-jv2w-4656), authlib 1.6.9→1.6.12 (3 GHSAs), nltk 3.9.3→3.10.0 (4 GHSAs), pygments 2.19.2→2.20.0 (ReDoS). Manifest security floors encoded for pyyaml (>=6.0.3), segno (>=1.6.6), python-pptx (>=1.0.2) — locks already compliant, zero resolution change. Locks regenerated via `task deps:upgrade` (uv, hashed, universal): surgical diff, exactly the 6 target packages. Supersedes Dependabot PRs #116, #132, #133, #150, #160, #172, #173, #174 and the broken group PR #176.
- **ecdsa alerts (Minerva timing attack, ×3) dismissed with rationale, not silently ignored**: no upstream fix exists (side-channels declared out of scope by the maintainer); not exploitable here — JWTs are HS256-only (`ALGORITHM=HS256`), `python-jose[cryptography]` routes EC to the `cryptography` backend, and an AST/grep audit found zero EC usage in `src/`. Consistent with the pre-existing pip-audit ignore documented in `Taskfile.yml` and `security.yml`.
- **Security workflow repaired** (`.github/workflows/security.yml`): `actions: read` granted (codeql-action/upload-sarif failed with "Resource not accessible by integration" on scheduled runs), `push: main` trigger added so the alert baseline refreshes on every merge instead of a weekly cron, concurrency group added. The 4 stale Trivy alerts (langchain-core, python-multipart, uuid, postcss — all long fixed in the locks) close on the first fresh scan.

### Fixed

- **Assistant: "my next N appointments" no longer answers with a daily briefing** — the query-analyzer over-matched the `briefing-quotidien` skill description on any agenda-flavored query (its D+2 agenda window structurally cannot answer "next N events"), and a trailing "Do NOT use for…" clause proved insufficient for the classifier. The skill description is rewritten trigger-first: a positive strict condition ("Trigger ONLY when the user explicitly asks for a briefing or a WHOLE-day overview"), with single-category requests explicitly excluded. Verified live in both pipeline and ReAct modes.
- **ReAct: tool cap no longer silently starves the detected domains** — `ReactToolSelector` truncated the resolved tool list positionally at `react_agent_max_tools` (observed live: 102→100 with the dropped names unlogged), so the very tools a query needed could vanish. The cap now keeps the detected domains' agents' tools first (stable partition via `DOMAIN_REGISTRY`) and emits a `react_tool_selector_capped` warning naming every dropped tool. 3 regression tests pin the behavior.
- **Dependabot npm scope** moved to the workspace root (`.github/dependabot.yml`): frontend update PRs now include the root `pnpm-lock.yaml` and can pass CI.
- **CodeQL misc alerts**: 2 implicit string concatenations parenthesized (journals extraction prompt list), 1 dead store removed (`_conn_status`, base OAuth client), 1 `str.format` surplus-argument mismatch made conditional (`tools/mixins.py`).

### Changed

- **Exception-swallowing doctrine enforced end-to-end**: all 193 `except: pass` handlers in `src/` replaced — 190 mechanically rewritten to `with contextlib.suppress(SpecificError):` (justification comments hoisted above the block, obsolete `# noqa: BLE001` / `# pragma: no cover` markers dropped), 3 multi-handler teardown sites (SSE keepalive, channels typing loop) restructured with `suppress()` nested inside the `try` — identical capture order, no empty handler left. New CI guard `apps/api/tests/unit/test_no_empty_except_guard.py` (same pattern as the timezone/JSONB guards) fails the build on any new empty handler; doctrine documented in `CLAUDE.md`.
- **Node.js 22 → 24 LTS** across the web Docker images (`Dockerfile.dev`, `Dockerfile.prod` build + runner stages) and CI (`node-version` in ci.yml/security.yml). Deliberate LTS-to-LTS move replacing Dependabot's node:26-alpine proposal (a non-LTS "current" release, unsuitable for the ARM64 production target). Verified: Next.js serving on Node v24.18.0, 200/200 vitest in-container.
- **GitHub Actions pins refreshed** (Dependabot #166 merged): checkout v7, codeql-action, trivy-action 0.36, docker build actions, setup-node/python — hash-pinned across ci/release/security workflows.

### Verified

- 8,921 backend unit tests green (0 failures), Ruff/Black/MyPy strict green over 848 source files, fresh AST scan reports zero remaining empty handlers, API Docker image rebuilt from the regenerated hash-verified lock and booted healthy (DB/Redis healthy, zero startup errors), web image serving under Node 24 with the full vitest suite green.

## [1.21.23] - 2026-07-08

> Connector client domain error contract (ADR-114). The 2026-07 audit flagged a layering defect: the connector _client_ layer — a domain layer — raised raw transport `HTTPException` at 28 sites across the OAuth bases (Google, Microsoft) and the Google-direct clients (Places, Routes, Geocoding, Microsoft To Do). Raw raises are untyped, invisible to Prometheus, unlogged by the central mechanism, and violate the "centralized raisers only" review rule. ADR-108 had already fixed the same defect in `BaseAPIKeyClient`; this release extends that contract to the whole OAuth family. The structural lever: `BaseAPIException` **is** an `HTTPException` subclass (ADR-002), so migrating to typed subclasses preserves the external API contract _by construction_ — same status codes, same `{"detail"}` payloads, same headers through FastAPI's native handler, both `isinstance(HTTPException)` code paths still true, `str(e)` format unchanged. No new exception handler was needed, and none was added.

### Added

- **`ConnectorAPIError`** (`core/exceptions.py`): the one new taxonomy class — upstream connector API errors forwarded with their original status code (a 403 from Google stays a 403; includes 5xx on the no-retry Routes/Geocoding paths). No existing class accepted a dynamic status code.
- **`headers` parameter on the exception taxonomy** (`BaseAPIException`, `AuthenticationError`, `ExternalServiceError`): typed exceptions can now carry HTTP response headers (`Retry-After` on circuit-open 503s, `X-Requires-Reconnect` on OAuth 401s) — previously expressible only by raw `HTTPException`. `RateLimitError` gains an optional `detail` override so client-side 429 messages stay byte-identical.
- **Contract test suite** (`tests/unit/connectors/test_connector_client_error_contract.py`, 34 tests): every one of the 28 migrated sites individually pinned (exception type + status code + byte-identical detail + headers), FastAPI edge parity (each typed exception rendered against its raw-`HTTPException` twin via `TestClient` — same status, same JSON, same headers), and tool-path classification (`handle_tool_exception` / `handle_connector_api_error`) proven unchanged.
- **ADR-114** (`docs/architecture/ADR-114-Connector-Client-Domain-Error-Contract.md`): the full mapping table, the documented divergence from ADR-108 (OAuth retry exhaustion stays a 503 `ExternalServiceError`, _not_ the plain `MaxRetriesExceededError` — the OAuth bases feed REST routes where a plain exception would become a 500 through `ErrorHandlerMiddleware`), and the pre-existing quirk kept as-is: the client-side 429 raised inside `_rate_limit()` is swallowed by the Redis-fallback `except Exception` and degrades to local throttling (shared with ADR-108's base; changing it would be a behavior change).

### Changed

- **28 raw `raise HTTPException` sites migrated** across `base_oauth_client.py` (×8: 401 invalidation, 4xx passthrough, network/retry exhaustion, client-side 429, circuit-open, refresh 404/400), `base_google_client.py` (×3, raw downloads path), `base_microsoft_client.py` (×4, nextLink pagination path), `google_places_client.py` (×6, incl. reverse geocoding), `google_routes_client.py` (×6, incl. route matrix), `microsoft_tasks_client.py` (×1). Every client error now feeds `http_errors_total` / `external_service_errors_total` and the central structured logging — new observability, zero API contract change.
- **Provider parity on the OAuth 401 message**: the inline French literal in the Google base (an i18n-rule violation, byte-identical to the central catalog's French default) is replaced by `APIMessages.connector_auth_invalid()`; the Microsoft base — whose message was missing the "reactivate the connector in settings" sentence — is aligned on the same catalog entry.
- **Error-detail hygiene**: upstream response bodies embedded in error details truncated to 200 chars (Places, Routes, Geocoding — they previously embedded the full upstream body, a PII/token-waste risk when relayed to the LLM and the frontend).
- **Geocoding log hygiene (no-PII rule)**: GPS coordinates moved from ERROR/WARNING/INFO log events to dedicated DEBUG events in `google_places_client.reverse_geocode` paths.

### Fixed

- **Pre-existing MyPy invariance in `raise_invalid_credentials`** surfaced by the new `headers` parameter (`**dict[str, str]` unpacking could bind `headers`): the log-context dict is now explicitly `dict[str, Any]`.
- **Lying docstrings and comments**: `Raises: HTTPException` docstrings across the migrated clients (incl. `google_gmail_client.send_email`) rewritten to the real typed exceptions; the two "may raise HTTPException — let it propagate" comments in `connectors/router.py` updated; ADR-023's dead reference to a non-existent `docs/technical/ERROR_HANDLING.md` removed.

### Docs

- **ADR-114** written; **ADR-023** amended (connector client layer aligned on the taxonomy; the 401/429/403 handlers and `classify_http_error` in `connectors/error_handlers.py` documented as having no production callers — the module's live surface is the OAuth-callback family); `ADR_INDEX.md` + `docs/INDEX.md` cross-referenced; guide stamps v1.21.23 (12 files) with drifted metrics fixed in all 6 locales (test-file count 559 → 560, zh exact ADR count 106 → 107).
- Out of scope, recorded in ADR-114 for phase 2: the 33 remaining raw `HTTPException` raises in routers/services (right layer, wrong idiom — llm_config ×14, health_metrics ×5, user_mcp ×4, heartbeat ×3, …) and the dead connector error handlers (S7 candidate).

### Tests

- New contract suite 34/34 green; connector unit suites 501 passed; full fast unit selection **8,904 passed / 0 failed**; connector integration structure tests 6/6; ruff/black/MyPy strict green on all touched files; fresh Docker boot to healthy with the OAuth `token_refresh` scheduler exercising the migrated code live (4/4 refreshes, 0 errors).
- **Event-loop stall tests hardened against machine-load flakiness** (`tests/helpers/event_loop.py`, caught by this release's pre-commit run): the absolute 150 ms stall threshold measured the _machine_, not the loop, when pytest-xdist saturates every core (the ticker coroutine itself gets starved by the OS scheduler). New `assert_workload_off_loop` helper: fast path under the absolute threshold, otherwise a calibration pass measures the same blocking workload run synchronously ON the loop and requires the async stall to stay under half of it — scheduler noise inflates both measurements alike, a regression to a synchronous implementation still fails. Applied to the 3 stall assertions (image resize, FCM send, FCM multicast).

## [1.21.22] - 2026-07-08

> Backend test suite rehabilitation (ADR-113). The 2026-07 audit found `tests/integration/` (250 tests) ran in **no** CI job — and a full local run proved it had silently rotted, exactly like the agents suite before it: 53 failures out of 243 selected. Thirteen Testcontainers-backed test files were misfiled under `tests/unit/` (the audit saw 10; inventory found 3 more, including `test_checkpointer.py` which ran _nowhere_: win32-skipped locally, `-m`-deselected in CI), ten of them quarantined by a `--ignore` list in ci.yml proven **100% redundant** — CI collection is byte-identical with and without it (8,916 tests both ways). Meanwhile the coverage gate sat at 43% while actual coverage measured 52.31% on the CI runner. Everything is reclassified, gated, repaired at the root, and the gate now ratchets. Bonus: the rehabilitated suite immediately caught a real product bug (every field-validator 422 turned into a 500).

### Added

- **`test-backend-integration` CI job** (`.github/workflows/ci.yml`): runs `pytest tests/integration/` (465 tests; `-m "not e2e and not benchmark and not multiprocess"`, `slow` included — those tests run nowhere else; `--no-cov`, the coverage gate belongs to the unit job) against the PostgreSQL (pgvector) + Redis service containers. Plumbing: the job sets **`TEST_DATABASE_URL`** — the only DB variable that survives the conftest's `load_dotenv(".env.test", override=True)` — and `tests/conftest.py::_detect_environment` now honors it explicitly, with the Testcontainers fallback unchanged; service credentials deliberately mirror `.env.test` (`test:test@localhost:5432/test_db`) so tests reading `settings.database_url` directly (LangGraph checkpointer) reach the same database. The dead "localhost optimization" branch (computed but never consumed) is deleted.
- **`tests/integration/conftest.py`**: autouse fixture purging the `auth:*` rate-limit buckets through the limiter's own Redis client before each test — the auth rate limiter (10 logins/min/IP, not gated by `RATE_LIMIT_ENABLED`) tripped as soon as the `authenticated_client`/`admin_client` fixtures chained real logins (~35 of the 53 failures, ONE root cause). The `RedisRateLimiter` singleton is also reset between tests alongside the Redis singletons (same event-loop-affinity hygiene).
- **pytest-xdist 3.8.0** (requirements-dev + lockfiles, ADR-112 flow): the pre-commit hook pytest step and `task test:backend:unit:fast` now run `-n auto --dist loadscope` — measured **734 s → 234 s** (12 min → 3 min 54 s) on the 8,916-test selection, whole hook under the 5-minute budget. CI commands unchanged.
- **ADR-113** (`docs/architecture/ADR-113-Backend-Test-Suite-Rehabilitation.md`): the full decision — reclassification, `--ignore` quarantines forbidden (a quarantined test never comes back; it also hides suite rot), TEST_DATABASE_URL design, failure taxonomy, coverage ratchet doctrine.

### Fixed

- **Every field-validator validation error returned a 500 instead of a 422** (`src/main.py`, product bug found by the rehabilitated suite): the custom `RequestValidationError` handler passed `exc.errors()` raw to `JSONResponse`, but Pydantic v2 embeds the original `ValueError` object in `ctx` — `json.dumps` crashed, so e.g. registering with a weak password answered "Internal Server Error" instead of the explicit message. Now `jsonable_encoder(exc.errors())`, matching FastAPI's default handler. Proven end-to-end on the running app (register with a short password → 422 with the detailed reason).
- **The 53 integration failures, repaired at the root** (no product-code workarounds): auth rate-limiter purge (see Added); `CREATE EXTENSION IF NOT EXISTS unaccent` added to the conftest engines, mirroring the Alembic migrations (admin user search 500'd without it); 4 hardcoded-English assertions made locale-aware via the `APIMessages` catalog (the API answers localized); ~10 obsolete tests rewritten against the current API — connector callbacks migrated to the `*_stateless` handlers, Gmail invalid-state contract (302 redirect with `connector_error`, not 400), `ModelPriceCreate` 14-field catalogue payloads with `LLMModel` joins, account-lifecycle pending-activation (email verification no longer activates), a `MissingGreenlet` on expired-attribute access, and the home-deletion cascade test seeded at the DB level (the PUT endpoint requires an active Google Places connector — absent in tests, its silent failure made the DELETE a no-op; the cascade itself was correct).
- **6 `llm_cache` tests skipped as "implementation changed" repaired, not deleted** (`tests/unit/infrastructure/cache/test_llm_cache_unit.py`): the code under test is alive — the 2 serialization tests now trigger the real failure path (`str()` raising: the safe dataclass conversion never calls `__reduce__` anymore), the 4 metrics tests patch the real import site (`metrics_agents`, in-function import) with an async `estimate_cost_usd`, and the `zero_tokens` test asserts real behavior instead of `assert True`. 22/22 green, 0 skips.

### Changed

- **Coverage gate ratcheted 43% → 45%** (pyproject addopts + ci.yml, kept in sync). Doctrine documented in GUIDE_TESTING.md: **+2 points per release, never lowered**, toward the audit's 75% target; raising requires ≥2 points of measured CI headroom (real coverage: 52.31% CI Linux / 52.14% local).
- **13 test files reclassified** `tests/unit/` → `tests/integration/` (subpaths preserved), stale headers rewritten, misleading `@pytest.mark.unit` markers dropped. Zero test loss: unit 9,169 → 8,947 and integration 250 → 472 (Σ constant); CI unit selection unchanged at 8,916.
- **Pre-commit hook aligned with the Taskfile** (`-m "not integration and not slow"` — the hook silently ran 15 slow-marked tests the Taskfile excluded); `task test:backend:unit:fast` gets `--no-cov` (it recomputed full coverage for nothing); `task test:backend:integration` now mirrors the CI job's marker expression and `task ci` includes it.

### Docs

- `CI_CD.md` rewritten where stale: the new job, the agents step (never documented), the removed `--ignore` list, the 45% gate, the pre-commit/CI alignment table. `GUIDE_TESTING.md`: ratchet doctrine + the Coverage and CI/CD sections rebuilt against the real `ci.yml` (they documented a fictional `tests.yml` with a 30% gate). README: CI diagram (integration + agents jobs), 8-job count, honest unit-test timing (~4 min parallel, was "~30s"), test totals refreshed (~11,000 across 559 files). Guide stamps v1.21.22 (12 files) + drifted facts fixed in all 6 locales (coverage 43→45, test totals, CI diagram, zh exact ADR count 105→106). `docs/INDEX.md`, `ADR_INDEX.md` cross-referenced.

### Tests

- Integration suite: **450 passed / 0 failed / 0 errors** (15 skips: 7 win32-conditional — proven 7/7 on Linux in a CI-faithful container sharing the dev PostgreSQL network namespace — and 8 pre-existing unconditional skips, now tracked as debt). Unit suite green at the 45% gate; agents suite unchanged (958 passed, 209 skipped). Known flake under watch: `test_list_users_as_admin` (1 spurious 401 in 6 file executions, unreproducible in isolation).
- Remaining debt recorded in ADR-113: auth routes don't resolve `Accept-Language` (always-French responses), password-validator messages hardcoded in French, `test_metrics_langgraph_state.py` module-skipped "not implemented", the 8 unconditional integration skips, and the agents suite's 209 API-key skips (strategy: deterministic fake-LLM provider for plumbing + nightly `llm_live` tier for the real-LLM core).

## [1.21.21] - 2026-07-08

> Timezone correctness, enforced end-to-end. The datetime doctrine (`core/time_utils.py`: every datetime timezone-aware; user-facing times in the user's preferred timezone) was documented and mostly followed — but not _enforced_: the CI AST guard only caught hardcoded `"Europe/Paris"` literals, and 8 naive-datetime sites survived in production code. The most visible one: in voice mode, the fallback for the spoken "current time" injected the server's naive clock (UTC in production) into the voice prompt, so the announced hour was wrong for any user outside UTC. All sites are fixed with explicit frames (user timezone for anything spoken/displayed, UTC for technical timestamps), and the guard now bans the entire bug class from the build.

### Added

- **Naive-datetime CI guard** (`tests/unit/test_no_hardcoded_timezone_guard.py`, new `TestNoNaiveDatetimeCalls` scan alongside the existing `"Europe/Paris"` scan): AST detection over all of `src/` of `datetime.now()` without a tz argument (including `now(None)` / `now(tz=None)`, and the aliased `dt.datetime.now()` form — SQLAlchemy's server-side `func.now()` correctly excluded), `*.utcnow()` (any receiver), and `date.today()` / `datetime.today()`. Explicit allow-list (`core/time_utils.py`, the doctrine module), actionable per-pattern failure messages, and two self-tests that fail if the scanner stops detecting synthetic violations (guard-rot protection, same model as the Paris scan). Docstring examples are intentionally out of scope (string constants, not calls).
- **`stream_voice_comment(user_timezone=...)`** (`domains/voice/service.py`): optional parameter threaded from both streaming call paths in `agents/api/service.py`, with the fallback resolution extracted into a testable `_resolve_prompt_datetime()` helper — provided `current_datetime` passes through verbatim; absent, the time resolves via `now_in_timezone(user_timezone)` (None → `DEFAULT_USER_DISPLAY_TIMEZONE`), never the server clock.
- **Voice service unit tests** (`tests/unit/domains/voice/test_service.py`, first tests for `VoiceCommentService`): pin the spoken-time contract on a frozen instant — a New York user at 12:00 UTC hears 08:00, not 12:00; empty string triggers the fallback like None; no timezone falls back to the central default.

### Fixed

- **Voice comment spoke the server's time** (`domains/voice/service.py`): the `current_datetime` fallback used naive `datetime.now().strftime(...)` — server UTC formatted as if it were the user's local time. Now resolved in the user's preferred timezone (see Added). Both production callers already passed a pre-formatted user-timezone datetime; the fallback no longer betrays them when it fires.
- **7 naive `datetime.now()` sites migrated to explicit frames**: HITL pending-interrupt cache TTL comparisons → `datetime.now(UTC)` (`agents/api/router.py`); relative-date display fallback → `datetime.now(parsed_dt.tzinfo or UTC)`, naive branch proven unreachable (`display/components/base.py`); Brave Search recency year → `datetime.now(UTC).year` + import hoisted to module level (`knowledge_enrichment_service.py`); route and weather registry-ID date components → `datetime.now(UTC)`, aligning `weather_tools.py` with its own payload dates (`routes_tools.py`, `weather_tools.py` ×2).
- **Latent server-date trap in briefing birthdays** (`briefing/formatters.py`): `upcoming_birthdays_from_connections(today=...)` defaulted to `date.today()` — the server's date, which marks yesterday's birthdays as "today" for users ahead of UTC. The parameter is now required in the user's local frame; the sole production caller and all tests already passed it explicitly.
- **Docstring examples contradicting real usage** (`graphs/base_agent_builder.py`): two examples showed `datetime.now().strftime(...)` where all 17 production agent builders pass `get_prompt_datetime_formatted` — examples now match reality.

### Docs

- **`GETTING_STARTED.md` fully rewritten (v4.0)**: every default is the production-proven configuration; new sections for external platform setup (Google/Microsoft/Apple/Telegram/…), feature configuration reference, LLM configuration rebuilt from the live production setup (54 slots), Python dependency management (ADR-112 lockfiles), testing, production deployment and final checklist; legacy v6.x numbering, dead env vars and obsolete sections removed.
- **`GUIDE_DEVELOPPEMENT.md`**: new "Dates & heures (doctrine timezone-aware)" subsection under Standards de Code — the doctrine, the canonical patterns, and the CI guard documented for contributors.
- **Living docs' snippets aligned on the doctrine** (13 files): `datetime.utcnow()` / naive `datetime.now()` replaced by `datetime.now(UTC)` (with import fixes) in `ARCHITECTURE.md`, `technical/{CONNECTORS_PATTERNS,HITL,LLM_PRICING_MANAGEMENT,LANGFUSE,OAUTH}.md`, `guides/{GUIDE_TESTING,GUIDE_DEPLOYMENT,GUIDE_BACKGROUND_JOBS_APSCHEDULER,GUIDE_PROMPTS}.md` and 4 runbooks. ADRs untouched (historical records); deliberate anti-examples kept.
- Guide stamps refreshed to v1.21.21 (12 how/why files); stale "91 ADRs" figure in `how.zh.md` aligned with the other 5 locales ("100+").

### Tests

- TDD sequence proven: extended guard red on exactly the 8 executable sites (no false positives across ~84k lines of `src/`), green after the fixes; scanner self-tests green.
- Full unit suite green post-fix: **8,912 passed, 0 failed** (the 259 skips are pre-existing Testcontainers-unavailable skips on the Windows host). Ruff/Black/MyPy strict clean on all touched files; API Docker boot verified (`Application startup complete`, container healthy).

## [1.21.20] - 2026-07-08

> Reproducible Python builds & dependency security (ADR-112). `Dockerfile.prod` ran `pip install -r requirements.txt` with ~20 loose pins and ~120 unconstrained transitive dependencies, so two builds of the same commit could ship different versions — measured drift: 88 packages diverging between the Windows dev venv and the Linux dev container, both installed from the same manifest (starlette 0.50.0 vs 1.3.1, google-genai 1.67 vs 2.10). Every environment now installs from committed universal lockfiles with SHA256 hash verification. Auditing the lockfile immediately paid off: it surfaced 17 vulnerable packages (25+ CVEs) that the CI dependency-audit job had never seen, because that job audited an _empty_ environment — all 17 upgraded, final audit clean.

### Added

- **Universal Python lockfiles** (`apps/api/requirements.lock.txt`, 195 runtime pins; `requirements-dev.lock.txt`, 236 pins compiled with `-c requirements.lock.txt` so runtime versions are bit-identical): compiled by `uv pip compile --universal --python-version 3.12 --generate-hashes` — one marker-annotated file valid for linux/amd64, linux/arm64 and Windows, installable by vanilla pip (`--require-hashes`); uv is a compile-time tool only, absent from the final image. `requirements.txt` / `requirements-dev.txt` become intent manifests (loose pins allowed).
- **`task deps:lock`** (stable regeneration — existing pins are preferences, only manifest changes move versions; proven no-op on unchanged input), **`task deps:upgrade -- <pkg>`** (targeted bump) and **`task deps:upgrade:all`**; `task setup:backend` installs the dev lock into the venv.
- **CI lockfile guard** (`scripts/check_requirements_lock.py`, new `code-hygiene` step): offline, deterministic check that every manifest requirement is pinned and satisfied in the locks and that the dev lock layers exactly on the runtime lock — a manifest edit without `task deps:lock` fails CI. Mutation-tested.
- **ADR-112** (tool decision uv vs pip-tools — pip-tools disqualified by single-platform resolution: this repo has Linux-only `uvloop` and Windows-only `pywin32` branches; hash strategy for multi-arch; aarch64/x86_64 cp312 wheel-coverage audit of all pinned versions; inconsistent-wheel-metadata pitfall).

### Changed

- **`Dockerfile.prod` / `Dockerfile.dev`** install from the lockfiles with hash verification; CI `lint-backend`/`test-backend` install `requirements-dev.lock.txt` (pip cache keyed on it); `prepare-prod.ps1` ships the runtime lock to `PROD/` for the on-Pi rebuild path.
- **pip-audit and SBOM now read the lockfile** (`task security:scan:backend`, `security.yml` dependency-audit, `release.yml` + `security.yml` SBOM jobs): the full transitive tree (~240 packages) is audited and inventoried, instead of the manifest's 74 declared packages — or worse (see Fixed).
- **17 vulnerable dependencies upgraded to fix versions** (25+ CVEs): aiohttp 3.13.3→3.14.1 (21 CVEs), starlette 0.50.0→1.3.1 (5 advisories), pyjwt 2.12.1→2.13.0 (5), cryptography 46.0.7→48.0.1, pillow 12.1.1→12.3.0, langchain 1.3.2→1.3.9 (GHSA), python-multipart→0.0.31, pydantic-settings→2.14.2, langsmith→0.9.8, mako→1.3.12, pyasn1→0.6.3, idna→3.18, urllib3→2.7.0, langgraph-sdk→0.4.2, msgpack→1.2.1, ecdsa→0.19.2, requests→2.34.2. The langchain fix forced a metadata-verified cascade: langgraph 1.2.2→1.2.4 and langchain-core 1.4.0→1.4.6 (langchain 1.3.9 minimums), langgraph-sdk ≥0.4.2 (langgraph 1.2.4 requirement), websockets 16.0→15.0.1 (langgraph-sdk caps <16). Full pin diff: exactly those 20 packages, nothing else. One deliberate ignore remains (ecdsa CVE-2024-23342 — timing attack on _signing_; LIA only verifies JWTs).

### Fixed

- **CI dependency audit & SBOM ran against an empty environment**: both `security.yml` jobs did `pip install -e .` on a pyproject that declares no dependencies, so `pip-audit` audited nothing (which is how 25+ CVEs accumulated unseen) and the weekly SBOM inventoried nothing. Both now operate on `requirements.lock.txt`.
- **`sherpa-onnx` wheel-metadata inconsistency**: the armv7l wheel declares no dependencies while the manylinux/win wheels require `sherpa-onnx-core==<same version>` — uv reads one metadata per version and omitted the core package, breaking hash-checked installs. `sherpa-onnx-core` is now declared explicitly in the manifest with a mandatory joint-upgrade note; a future mismatch fails loudly at install time.
- Stale docs and hints aligned with reality: `GUIDE_DEVELOPPEMENT.md` described a `pip install -e ".[dev]"` setup and pyproject-managed dependencies that never existed; `validate_config.py` and `STACK_TECHNIQUE.md` pointed at the manifest instead of the lock; `security-architecture.mmd`, `CI_CD.md`, `SECURITY.md` (including a dead `DEPENDENCIES.md` link), `README_WORKFLOW.md`, `GUIDE_API.md` updated.

### Tests

- Lockfile adoption validated with zero silent bumps: initial locks compiled under the tested venv's freeze as constraints (0 version drift; only additions: Linux-only `uvloop`, matching the dev container, and `sherpa-onnx-core`, matching the venv).
- Hash-verified install on a clean Python 3.13 venv — `pip check` clean, `pip freeze` byte-identical to the lock (235 = 236 pins − uvloop). Prod image (amd64) and dev image rebuilt from the locks; dev container healthy; in-image spot-checks equal the lock.
- After the CVE wave: 8,856 unit + 958 agents tests green on the upgraded tree (ADR-111 canaries included), final `pip-audit` clean, CI lockfile guard mutation-tested (fake pin bump and stale dev lock both fail).

## [1.21.19] - 2026-07-08

> LangGraph Postgres connection pooling (ADR-111). Lifts the #1 scalability bottleneck identified by the S2/A7 audit: the LangGraph checkpointer and store each ran on a _single_ persistent PostgreSQL connection per worker, and langgraph serializes every operation of a connection behind an instance-level `asyncio.Lock` — so all concurrent conversations of a worker queued on one mutex for every checkpoint read/write. Both now run on settings-driven `psycopg` async pools; checkpoint concurrency per worker goes from 1 to `max_size` (default 8). Bonus fix: a connection killed while idle (PostgreSQL restart) used to leave persistence broken until an API restart — pooled connections are now validated at checkout and replaced.

### Changed

- **LangGraph checkpointer & store on `AsyncConnectionPool`** (`domains/conversations/checkpointer.py`, `domains/agents/context/store.py`): the single persistent `AsyncConnection` per worker is replaced by a pool with identical connection kwargs (`autocommit=True`, `prepare_threshold=0`, `dict_row`), explicit deferred open with fail-fast boot semantics (`open=False` + `await pool.open(wait=True)`), checkout-time validation (`check=check_connection`, parity with SQLAlchemy `pool_pre_ping=True`), and leak-free error paths (a `setup()` failure closes the pool). Factory contracts, msgpack serde allowlist and the 5 `checkpoint_*` Prometheus metrics are unchanged.
- **Pool-aware `_cursor` override in `InstrumentedAsyncPostgresSaver`**: in `langgraph-checkpoint-postgres==3.1.0` (latest, unfixed on upstream `main` — [langgraph#7259](https://github.com/langchain-ai/langgraph/issues/7259)) only the _store_ bypasses the shared instance lock when running on a pool; the _saver_ holds it unconditionally, so a pool alone buys zero checkpoint concurrency. The override replicates the store's own pool-aware pattern with the upstream method body verbatim — single-connection behavior stays bit-for-bit identical. Safety argument recorded in ADR-111: 4 production workers already write concurrently to the same checkpoint tables with no cross-process lock, so the instance lock cannot be load-bearing for consistency. Two canary tests order the override's removal the day upstream ships the fix.
- Waiting behavior under saturation is now bounded and observable: beyond `max_size` concurrent operations, a checkout waits at most the pool timeout (30 s) then raises `PoolTimeout`, surfaced as `checkpoint_errors_total{error_type="timeout"}` — previously operations queued invisibly and indefinitely behind the lock.

### Added

- **4 settings** (`DatabaseSettings`, min/max cross-validated, defaults + full connection budget documented in `core/constants.py`): `LANGGRAPH_CHECKPOINT_POOL_MIN_SIZE=1` / `MAX_SIZE=8`, `LANGGRAPH_STORE_POOL_MIN_SIZE=1` / `MAX_SIZE=4` — per worker, in `.env.example` + `.env.prod.example`. The store max is deliberately smaller (`AsyncBatchedBaseStore` processes batches sequentially — its pool gain is resilience, not concurrency). **Rollback without redeploy**: `LANGGRAPH_CHECKPOINT_POOL_MAX_SIZE=1` reproduces the former fully-serialized behavior.
- **`psycopg-pool==3.3.1`** pinned explicitly (became a direct import).
- **ADR-111** (decision, upstream-trap analysis, cross-worker safety proof, connection budget — persistent baseline ≈130 of 197 usable; the worst-case overcommit predates this change and is dominated by the per-worker SQLAlchemy overflow, right-sizing recorded as follow-up).
- Docs aligned: `STATE_AND_CHECKPOINT.md` (which had documented a pool the code never had — the contradiction resolves in the doc's favor), cross-ref note in ADR-022, `STACK_TECHNIQUE.md`, `docs/INDEX.md`, `ADR_INDEX.md`.

### Fixed

- **Dead-connection lockup**: a checkpointer/store connection dropped while idle no longer disables conversation persistence until the API restarts — checkout validation replaces broken connections transparently.
- Legacy `tests/unit/test_checkpointer.py` now skips cleanly when the test-settings database URL is unreachable (same guard as `conftest._skip_if_db_unreachable`) instead of failing with connection errors in the dev container — pre-existing environmental failure, proven identical on the old code path; still runs in CI.

### Tests

- 3 new test files + 2 reworked: cross-platform mocked factory tests (pool config from settings, singleton, cleanup, setup-failure paths), behavioral lock tests (pooled `_cursor`s overlap — the test fails by timeout under upstream behavior; single-connection stays serialized), upstream canaries, real-PostgreSQL integration (20 concurrent compiled-graph invocations, all checkpoints persisted and resumable + 20 concurrent store put/get), and a parametrized before/after benchmark.
- Benchmark (dev container, PG on the same Docker network — the _least_ pool-favorable setting): 20 concurrent tasks × 5 rounds of aput+aget, **×1.10** at 4 KB payloads, **×1.42** at 64 KB; the speedup grows with the I/O-bound share.
- Non-regression: `tests/unit` 8,916 passed, `tests/agents` 958 passed (HITL replay/resumption suites included), MyPy strict on 848 files, Docker boot healthy with `pooled=true` on both factories.

## [1.21.18] - 2026-07-08

> Automated PostgreSQL backups with a tested restore (ADR-109). Closes the top operational risk from the 2026-07-07 360° audit: no backup tooling was versioned in the repository and the RPO was undefined. Production (Raspberry Pi 5) now gets scheduled `pg_dump` snapshots with three-tier rotation, every knob `.env`-driven, and — the actual point — a restore procedure that is _proven_, not declared: the release was validated by a real backup restored into a throwaway container with schema and row-count comparison. RPO goes from undefined to ≤ 24 h (tunable).

### Added

- **`postgres-backup` sidecar** (`prodrigestivill/postgres-backup-local:16-alpine`) in both compose files — ARM64 support verified on the image manifest, embedded `pg_dump` 16.10 matching the `pgvector:pg16` server, baked-in healthcheck (its status also reflects the last backup's exit code). Prod: host bind mount `POSTGRES_BACKUP_HOST_DIR` (chmod 700, created by `deploy.sh` _before_ `up`), 0.25 CPU / 128M limits. Dev: `postgres_backups` named volume (the image's rotation uses hardlinks, unreliable on Windows bind mounts).
- **`.env` section `[80] DATABASE BACKUP`** in the three templates (`.env.example`, `.env.prod.example`, `.env.min.prod`): `POSTGRES_BACKUP_SCHEDULE` (`@daily`), `KEEP_DAYS/WEEKS/MONTHS` (7/4/6), `HOST_DIR`, `EXTRA_OPTS`, `TZ` — compose-level defaults, nothing breaks if absent; deliberately no API Settings module (compose-only consumers, `GRAFANA_ADMIN_USER` pattern).
- **`POSTGRES_EXTRA_OPTS` pinned to `-Z6 --clean --if-exists`**: full database (no schema filter), gzip 6, self-cleaning statements — restore is a single command against a fresh container or the live database.
- **`verify-backup.sh`** (`infrastructure/docker/backup/`, shipped in the PROD bundle): restores the latest dump into a throwaway `pgvector:pg16` container and compares `alembic_version`, public-table count and reference row counts against the live source (live drift = WARN; SQL error / schema mismatch / empty restored table = FAIL). Reads dumps via `docker cp` — storage-type agnostic, works from Git Bash and the Pi.
- **Taskfile `backup:now` / `backup:verify`**, runbook `docs/runbooks/DATABASE_BACKUP_RESTORE.md` (manual backup, throwaway + production restore with the systemic aftermath: automatic alembic upgrade on API restart, Redis FLUSHALL, health check), and **ADR-109** (decision, alternatives — custom cron script, host cron, PITR — and accepted phase-2 gaps: off-site encrypted rclone copy, `attachments_data`/`skills_data` volumes, failure push-alerting).

### Changed

- **Landing hero refinements** (shipped on main since v1.21.17): one sentence per line in the hero copy and homogeneous execution-mode badges, across all 6 locales.
- `docs/INDEX.md` stale ADR counts corrected (93/99 → 102) and a "Runbooks — Opérations" section added (the operational runbooks were absent from the index).

### Tests

- Real backup triggered through the sidecar in the dev environment, restored into a throwaway container: **0 SQL errors**, `alembic_version` identical across repo `alembic heads` / live source / restore, 55 public tables on both sides, identical row counts on `users`, `conversations`, `conversation_messages`. `docker compose -f docker-compose.prod.yml config` renders without error; sidecar reached `healthy` (~240 s, first probe interval).

## [1.21.17] - 2026-07-08

> Public-showcase overhaul & anonymous-visitor fix. A frontend/documentation release — no backend change, no DB migration. Every public number was re-derived from the codebase and corrected across all six locales (the canonical `ProviderType` Literal counts 7 LLM providers, not 8 — "Mistral" was an Ollama-served model in the pricing seed); the landing page was redesigned around showing the product (animated three-scenario chat demo, engineering proof band, faithful two-mode diagram); a new `/story` field-report page documents how LIA is built (~100% AI-written code under human direction); and a production bug that silently ejected every anonymous visitor from the public pages to `/login` was found during runtime verification and fixed with a filesystem-completeness test.

### Added

- **`/story` field-report page (6 languages).** New public page on the /why–/how guide pattern (`story.{lng}.md`, TOC, hreflang, sitemap, robots, breadcrumb JsonLd): the method (written rulebook, blocking checks, deciding review, adversarial audits), the trade-offs, operations, the measured 8.0/10 / 20-area audit profile (strengths and planned weaknesses summarized — the full report is deliberately not published), and management convictions. Wired into the header nav (Présentation · Story · Philosophie · Technique · Blog · FAQ), both footers, and a new landing `RexSection` (quote, 4 durable KPIs, CTA).
- **Animated hero chat demo (`ChatMockup` v3).** The previously dead component now anchors the hero: three rotating scenarios, each mirroring a real display mode with its title-bar chip — HITL (humorous email, draft card, Send/Edit controls, approval), HTML cards (rich weather card + cross-domain proactive initiative bubble), Markdown (multi-agent place search, numbered-list reply). Timeout-driven loop, static single scenario under `prefers-reduced-motion`, `role="img"` with localized aria.
- **Landing proof band (`ProofSection`).** Replaces the stats strip, directly under the hero: 19+ agents · 76 tools · 7 providers · 99+ voice languages · 10,000+ tests · 100+ ADRs · 120+ releases · 8.0/10 audit, plus the field-report teaser. All figures verifiable in the repository; `LANDING_STATS` documents the canonical source of each number.
- **Today-briefing feature card** on the landing (the home-page briefing was absent from every showcase surface) and a rewritten homepage-screenshot caption naming it.
- **`isPublicPath()` + filesystem completeness test (31 tests).** The 401-handler public-route list is now a named, exported, documented constant; `api-client.public-routes.test.ts` pins public/protected behavior (with and without locale prefixes, anti-substring) and scans `app/[lng]/` so any new public page missing from the list fails CI instead of re-shipping the ejection bug.

### Changed

- **Landing redesign.** Split hero (copy + live demo, ambient gradients replacing the background image; version + update date kept as a freshness signal); two-mode diagram rebuilt to match the real LangGraph topology (entry → router fork, five numbered Pipeline steps with the approval step highlighted, ReAct reason→act→observe loop, "or" divider, streaming-response convergence); features grid compacted to rem-breakpoint 3-column layout (the custom px `mobile:` variant does not order reliably against `sm:` on the same property); use-cases zigzag replaced by featured-card + 2×2 grid; portrait-friendly screenshot frame; `FadeInOnScroll` threshold 0.15→0.01 + `rootMargin` (tall sections revealed thousands of px late); `AnimatedCounter` now SSRs the final value and localizes formatting; "Sous le capot" intro rewritten (orchestration-system positioning, no redundancy with the two-mode section).
- **French editorial voice unified to tutoiement** across the landing namespace (features, use cases, personas, security, CTA — the page previously mixed tu/vous within single sections); de/es/it/zh use-case descriptions rewritten from telegraphic fragments to full sentences; example 5 geography harmonized (Strasbourg everywhere, EN said Montpellier with a Strasbourg description).
- **Facts corrected on every public surface (×6 locales + README + guides + llms.txt + FAQ intro/sections + blog articles + docs/knowledge):** 7 LLM providers (title, names, meta descriptions, FAQ, admin-screenshot captions); 76 tools; 394 Prometheus metrics; 22 Grafana dashboards; 54 LLM config types (was "34"); 14 personalities; 100+ ADRs (README said 81); ~10,140 backend tests across 555 files; 169 vitest tests (was "41"); FAQ 200+ Q/A across 24 sections (was "119+/17"); embeddings documented as Gemini `gemini-embedding-001` on every consumer — memory, routing, interests, journals **and RAG spaces** (the FAQ, blog and knowledge base still billed RAG under OpenAI `text-embedding-3-small`); "100% local voice mode" reworded to local wake-word/STT (TTS is cloud); "zero API cost" hybrid-search claim removed; README stack table refreshed (12 stale versions); performance tables reframed honestly (TTFT row → first SSE event + LLM-cascade note in README and the six how guides).
- **`llms.txt` rewritten** (agents/tools/providers counts, two modes, briefing, psyche, journals, health, story link, correct GitHub URL) and **SEO JsonLd repaired**: `sameAs` pointed to a non-existent repo (`JeysWork/LIA`), `softwareVersion` was hardcoded to 1.8.2 (now `APP_VERSION`), WebSite description said 15 agents.
- **Guides refreshed and version-harmonized** (why 3.5 / how 2.6 across all six languages — es/it/zh had drifted one doc-version behind).

### Fixed

- **Anonymous visitors ejected from all public pages (production bug).** The root-layout `AuthProvider` probes `/auth/me` on every page; for anonymous visitors the 401 handler redirected to `/login` unless the path matched a public-route regex that only covered login/register/root — so `/why`, `/how`, `/blog` and `/faq` bounced every logged-out visitor (invisible to developers, whose browsers always carry a session cookie). Public list extended to all public pages and locked by the completeness test above.
- **Cloudflare Insights beacon blocked by CSP** (console error on every prod page): `static.cloudflareinsights.com` allowed in `script-src`, pinned as the single permitted external script host in `csp.test.ts` (ADR-098 policy+test discipline).
- **`landing.presentation.subtitle` said 13 slides; the carousel ships 15** (×6 locales).

### Removed

- **Dead landing components**: `HeroBackground` (hero image replaced by the live demo; the `useLiaGender` hook stays — dashboard + chat use it) and `StatsSection` (superseded by `ProofSection`); `landing.stats.*` and `landing.hero.cta_secondary` keys pruned from all six locales.

## [1.21.16] - 2026-07-07

> Dead-code remediation (S7, ADR-107) & API-key client consolidation (ADR-108). A maintenance release — no user-facing feature change, no DB migration. The 2026-07 audit's S7 finding (~5,800 lines of dead code) grew under investigation to ~13,600 lines across five clusters, each deletion proven safe by a layered method: all-scopes grep → AST import-graph startup-closure analysis → runtime "simulated deletion" (an import hook making the modules invisible while importing `src.main` and running the full suite) → per-cluster green-baseline / delete / green-suite / fresh-Docker-boot. The follow-up (ADR-108) hardened the previously unused `BaseAPIKeyClient` and migrated the three API-key connector clients onto it, characterization-first.

### Removed

- **v3 autonomy engines (dead since the v3.2 fusion).** `autonomous_executor.py`, `feedback_loop.py`, `relevance_engine.py`, the `agents/v3/` barrel, their inert Pydantic configs (`V3ExecutorConfig`/`V3RelevanceConfig`/`V3FeedbackLoopConfig`/`V3PromptConfig` + factories), 9 settings fields, 9 constants and 9 env vars in both templates. `V3RoutingConfig`, `V3DisplayConfig` and `i18n_v3.V3Messages` were proven live (query analyzer, display cards) and kept; `get_debug_thresholds()` lost its three dead sections.
- **Plan-level approval framework + ghost HITL orchestrator.** `plan_editor.py` (incl. `EnhancedPlanEditor`/`SecurePlanEditor`), the `services/approval/` strategies package, the four dead helpers of `approval_gate_node.py` (626 → 130 lines — the wired pass-through is kept, so re-enabling plan-level HITL later needs no graph rewiring), the dead schema classes (`PlanApprovalRequest`, `PlanModification`, `PlanApprovalDecision`, `ApprovalEvaluation`, `PlanApprovalAudit`), the never-written `approval_evaluation` state field — and **`hitl_orchestrator.py` (987 lines): a ghost service instantiated in `graph_management` but never accessed**, proven dead by running the full suite with the module blocked (only its own phantom tests failed), together with its `hitl/policies/` package. `PlanSummary`/`StepSummary`/`PlanApprovalInteraction` stay: they are the HITL registry's live fallback for unknown `action_type`s.
- **Smaller dead clusters.** The fluent `manifest_builder.py` (`ToolManifest` lives in `registry/catalogue.py`; the one TYPE_CHECKING import repointed), the parallel `state_keys.py` constants copy, the contacts-v2 `contacts_models.py`/`contacts_validators.py` and a stale debug script.
- **Dead observability.** 18 orphaned Prometheus metric definitions (labeled → they never emitted a series), 11 recording rules and 7 alert rules over now-absent metrics (`promtool` green, 86 rules left), 23 no-data panels from Grafana dashboards 07/08. Noted for a future pass: `alert_rules.yml` itself is not loaded by `prometheus.yml` (alerting disabled).
- **~10 phantom test files** (they exclusively covered removed code — live-code coverage unchanged), including `test_hitl_flows_e2e.py`, which patched a module deleted long before this work.
- **`i18n_v3` orphan block.** 7 `V3Messages` methods + 11 translation dicts only the removed engines consumed (−381 lines); module docstring updated.

### Added

- **`CircuitBreaker.check()` (public fail-fast gate).** The body of `__aenter__`, now shared with `protect()` (DRY) and used by the api-key, oauth and apple client bases instead of reaching into `cb._lock`/`_should_allow_request()`/`_reject_request()` — the apple base gains the lock, the real state, the `retry_after` hint and the rejected-call metric.
- **`ToolDependencies.aclose()`.** Closes every cached connector client (pooled `httpx.AsyncClient`) deterministically at end of run — wired in the success and error cleanup paths of `stream_chat_response` and in the contacts-warmup helper; the direct instantiation sites (web_search ×2, heartbeat context_aggregator + geocoding) got try/finally closes. Previously nothing ever called `close()`: sockets leaked until GC.
- **Characterization harness + 37 pinned-contract tests.** `tests/unit/connectors/characterization_harness.py` (httpx.MockTransport-based, implementation-agnostic: assertions hold whether headers are set at client construction or per request) and per-client characterization suites (Brave 13, OWM 14, Perplexity 10) written against the LEGACY implementations and kept verbatim through the migrations.
- **ADR-107 & ADR-108** (+ index entries): the remediation method, per-cluster proof, kept-alive boundaries, migration deltas.

### Changed

- **Brave, OpenWeatherMap and Perplexity clients migrated to `BaseAPIKeyClient`** with unchanged constructors, method signatures and error contracts: Brave keeps its None-on-error `search()`, OWM keeps its raising contract, list-returning `geo/1.0/*` endpoints and timezone-aware daily aggregation, Perplexity keeps its payload shape and empty-choices fallbacks. Gains: per-user Redis rate limiting (multi-worker correct; local time-based fallback when disabled), shared per-service circuit breaker, retry with backoff, connection pooling, per-client timeout settings honored via `_get_http_timeout()`.
- **`BaseAPIKeyClient` hardened before adoption.** Its six raw `HTTPException` raises became domain errors (`ExternalServiceError` for circuit-open and 401/403 — the `raise_google_api_error` model, feeding `external_service_errors_total`; `httpx.HTTPStatusError` for non-auth 4xx; `MaxRetriesExceededError` on exhaustion with the last error kept; `RateLimitError` client-side), `rate_limit_per_second` widened to `float` with `max(1, int(×60))` for the Redis window, `user_id: UUID | None` for system callers, `follow_redirects` class attr. Post-review hardenings: a non-numeric `Retry-After` (RFC 7231 HTTP-date) falls back to exponential backoff; a malformed body on a 200 is retried as a transient failure (then `MaxRetriesExceededError` keeping the decode error) — restoring the legacy retry-on-decode semantics.
- **Intentional migration deltas (documented):** 5xx responses are now retried before failing; retry exhaustion surfaces as `MaxRetriesExceededError` — the briefing weather fetch's `except` was synced and classifies from `last_error`; 401 surfaces as `ExternalServiceError` instead of `ValueError` (all consumers catch broadly — verified).
- **`scaffold.py`** template synced with the new base contract.

### Fixed

- **Pooled HTTP client socket leak** across every API-key client call site (see `ToolDependencies.aclose()` above).
- **Order-dependent circuit-breaker test failures (latent trap).** The process-global `CircuitBreakerRegistry` accumulated failures across tests and could open a shared breaker mid-file; the base and characterization suites now isolate it with an autouse `CircuitBreakerRegistry.clear()` fixture.
- **Stale docs-vs-code drift in touched files.** Docstrings describing removed behavior (HITLOrchestrator mentions in `api/service.py`/mixins, the `resumption_strategies` "approval_gate expects" comment, the `approval_schemas` module docstring, metrics comments) were corrected in the same change, per the "a docstring describing behavior the code does not have is a bug" rule.

### Tests

- Zero new failures at every checkpoint of the whole campaign (the suite grew from 10,054 to 10,147 passed as characterization/lifecycle tests were added; every pass-count delta exactly matches the phantom tests removed or the tests added). Ruff / Black clean repo-wide; MyPy strict green on all 848 source files; five fresh container boots to healthy; `/metrics` verified (kept metrics present, removed metrics absent); the three migrated clients smoke-tested inside the running container.

## [1.21.15] - 2026-07-07

> Core-agent decomposition (B1) & i18n/prompt debt hardening. A maintenance release — no user-facing feature change, no behavior change (verbatim extractions, prompt input byte-preserved), no DB migration. The 2026-07 audit flagged the three largest functions of the agent core (B1, "monoliths"); measured strictly (code lines, comments/docstrings excluded), only `response_node` (1516) and `stream_sse_chunks` (403) exceeded the ~300-line threshold and are decomposed here under a characterization-test safety net (Feathers). `parallel_executor` and `_handle_hitl_interrupt` already complied and were left untouched.

### Added

- **`DebugMetricsBuilder` (new module `services/streaming/debug_metrics_builder.py`).** The 730-line `StreamingService._add_debug_metrics_sections()` is extracted into a dedicated builder that assembles the ~16 debug-panel sections (token_budget, planner_intelligence, execution_timeline, tool_selection, LLM / Google-API / image-generation breakdowns, execution_waves, request_lifecycle, llm_pipeline, knowledge / memory / RAG / journal injections, skills). Per-section error isolation and the exact former assembly order are preserved (several sections enrich values written by earlier ones). `_add_debug_metrics_sections()` becomes a thin delegator.
- **Versioned prompt directives.** The two inline response-node system-prompt fragments (`<InitiativeSuggestion>`, `<ProactiveFindings>`) are moved to `prompts/v1/initiative_suggestion_directive.txt` and `prompts/v1/proactive_findings_directive.txt`, registered in the `PromptName` literal and loaded via `load_prompt()` — **byte-exact** with the previous inline text (round-trip verified, with regression guards).
- **~90 characterization / unit tests.** Golden-master coverage pinning the observable contract _before_ any extraction: the exact `state_update` key set per return path (nominal / draft fast-path / LLM timeout — the MessagesState "undeclared key dropped by the reducer" trap), ReAct passthrough, vision LLM switch, skill activation, HTML injection; every `DebugMetricsBuilder` section including per-section error isolation; and direct unit tests for the extracted pure helpers (knowledge-enrichment skip/await branches, psyche parse, plan-pattern learning, turn-context resolution, prompt assembly).

### Changed

- **`response_node` decomposed: 1516 → 293 code lines (−81 %), 27 single-responsibility module-level helpers.** Turn preamble, ReAct passthrough, agent-results normalization, registry filtering, conversation-history assembly, knowledge enrichment (launch/await), context injections, skill activation, prompt build, context resolution, domain detection, message prep, chain build, relevant-ids filtering, HTML rendering, business metrics, plan-pattern learning and the four post-response background extractions are now named helpers. The public node signature and the returned `state_update` key contract are unchanged.
- **`stream_sse_chunks` decomposed (403 → ~250 code lines).** The debug-panel emission and the post-stream registry emission are extracted into `_emit_debug_metrics` / `_emit_post_stream_registry` async generators.
- **`data_for_filtering` error marker centralized (i18n debt).** The inline French fallback marker is replaced by the English `DATA_FILTERING_GENERATION_ERROR_MARKER` constant — it is LLM-facing prompt content (never surfaced to the user), kept in English per the "LLM prompts are not translated" convention (`core/i18n.py`).

### Fixed

- **`debug_metrics_builder.py` was silently git-ignored.** The new production module matched the `.gitignore` `debug_*.py` scratch-script pattern, so it would not have been committed; `StreamingService` imports it lazily, so the admin debug panel would have crashed at runtime on a fresh checkout. A targeted `.gitignore` negation now tracks it.
- **Inline French / inline prompt scaffolding removed from Python (systemic-rule debt, surfaced by the decomposition).** LLM-facing text now lives in versioned prompt files; the error marker in a centralized constant.

### Tests

- Characterization-first (Feathers): the golden-master net stayed green _identically_ through every extraction and caught one self-introduced bug (a missing `run_id` argument). Ruff / Black / MyPy strict clean; full backend fast-unit and agents suites green; coverage rose on the touched modules (`response_node` 42 → 69 %, `streaming/service` 38 → 59 %, `DebugMetricsBuilder` 91 %).
- Docs: `docs/technical/DEBUG_PANEL_ARCHITECTURE.md` updated (stale `_add_debug_metrics_sections` reference → `DebugMetricsBuilder`; new _Metrics assembly_ section).

## [1.21.14] - 2026-07-07

> Latent-debt hardening (CA-1, CA-4, CA-5). A maintenance release closing three independent residual debts surfaced by the 2026-07 codebase audit — no user-facing feature change, prompt-free, no DB migration. Each item was fixed red-first (a failing test before the fix). Two are security/privacy hardening (PII no longer reaches INFO logs; JSON-LD SEO scripts can no longer be broken out of), one is a latency hardening (multi-MB file reads/writes no longer block the event loop).

### Added

- **13 field names added to the INFO-level PII redaction net (CA-1).** `pii_filter.CONTENT_FIELD_NAMES` is a field-name denylist redacted at INFO and above (contents allowed only at DEBUG — audit wave 2, C7). It missed several call-sites that logged raw user content at INFO: HITL decision / classifier / clarification replies (`user_message`, `user_response`, `original_user_response`, `clarification_response`, `original_content`, `reformulated_intent`), calendar / task titles (`summary`, `title`), reminder bodies and edited conversation messages (`content`, `new_content`, `original_content_preview`), uploaded document names (`original_filename`) and FOR_EACH bulk-operation exclusion text (`exclude_criteria`). All now redact at INFO / WARNING / ERROR and pass through at DEBUG (where email/token pattern-scrubbing still applies).
- **Systemic vitest guard against unescaped JSON-LD (CA-5).** A source-scanning test forbids any `dangerouslySetInnerHTML={{ __html: JSON.stringify(…) }}` (whitespace-tolerant, with a non-vacuity assertion) across `apps/web/src`, so a future SEO script that bypasses the escaping helper fails CI.
- **Off-event-loop regression tests (CA-4).** Five unit tests assert the file I/O runs on a worker thread (image generation, attachment upload + vision read, RAG upload, skill zip) and preserves behaviour — they go red if the `to_thread` wrapper is removed.

### Changed

- **Blocking file I/O offloaded off the event loop on hot / voluminous paths (CA-4).** Seven synchronous `read/write_bytes` / `read_text` calls on async request paths are now wrapped in `asyncio.to_thread`: generated-image PNG writes (`generate_image` / `edit_image`, via a new `_write_image_file` helper), attachment upload write + LLM vision image reads (`build_vision_message_async`), RAG document write + document text extraction, the admin/user skill endpoints (zip creation, SKILL.md read/write, import), and the response-node skill-resource read. Small cached config/registry reads were measured negligible and left synchronous.
- **JSON-LD serialization centralized through an escaping helper (CA-5).** All eight `<script type="application/ld+json">` sinks in `JsonLd.tsx` plus the blog-article page now render through `serializeJsonLd(schema)`, which JSON-stringifies the schema and rewrites every `<` to its `U+003C` JSON escape — so a `</script>` sequence can no longer survive in the emitted HTML.

### Fixed

- **PII could reach INFO logs (CA-1).** Uploaded file names, HITL replies, calendar/task titles, reminder and edited-message bodies, and bulk-operation exclusion text were logged verbatim at INFO — now redacted by the net. GDPR data-minimization: contents stay at DEBUG or redacted, counters/IDs remain at INFO.
- **`</script>` breakout in JSON-LD (CA-5).** SEO structured-data scripts injected `JSON.stringify(schema)` raw; a `</script>` sequence inside any app-compiled dynamic field (FAQ question, blog title/excerpt) would close the `<script>` element early and inject markup. Escaping `<` neutralizes every script-context breakout while keeping valid, round-trippable JSON-LD.
- **Event-loop stalls during image generation and RAG upload (CA-4).** A multi-MB PNG write, or a document write/read, ran synchronously on the event loop and froze concurrent requests (SSE included) for its duration; they now run off-loop.

### Tests

- Red-first for every item; Ruff / Black / MyPy strict clean (src); full backend fast unit suite and frontend suite green; i18n key parity across all 6 locales.
- Docs: `docs/technical/PII_LOGGING_SECURITY.md` extended with the CA-1 net additions and the ambiguous-field (`title`/`summary`/`content`) handling.

## [1.21.13] - 2026-07-07

> Math & LaTeX rendering in chat responses. A frontend-only rendering fix (prompt-nudge, no DB migration) that makes the mathematical and scientific formulas LIA writes actually render. The assistant emits its **entire** answer as HTML (`html_response_directive`), so every formula sits inside a raw HTML block. `remark-math` operates on the markdown AST, treats raw HTML blocks as opaque, and runs **before** `rehype-raw` expands them — so math buried in HTML (100% of real answers) was never tokenized and rendered as literal `$$ P(G) = \frac{…} $$` text. Two prior fix passes missed it because they only ever tested pure markdown. The fix moves dollar-math rendering to the hast level, after the HTML is expanded, covering both HTML-wrapped and pure-markdown paths uniformly.

### Added

- **`rehypeMathInText` rehype plugin (`apps/web/src/lib/rehype-math-in-text.ts`).** Runs at the hast level, after `rehype-raw` + `rehype-sanitize` and before `rehype-katex`, converting `$…$`/`$$…$$` found in text nodes into the `math-inline`/`math-display` marker spans `rehype-katex` consumes. Single left-to-right tokenizer: currency (`9$`) stays literal via MathJax delimiter rules; an unclosed `$$` (common mid-stream) is emitted as literal text — never mis-paired into an empty inline formula (no streaming flash); `<code>`/`<pre>` and existing math elements are skipped. Dependency-free (local structural hast types).
- **Regression coverage.** A verbatim production-message fixture (the full `<div class="lia-response">` with formula + callout + emoji list + `<em>`) in `MarkdownContent.math.test.tsx`, plus a dedicated plugin unit suite (`src/lib/__tests__/rehype-math-in-text.test.ts`, 10 tokenizer edge cases: currency, unclosed `$$`, escaped `\$`, adjacency, skip regions). The HTML-wrapped tests are the ones the two prior passes lacked.

### Changed

- **`remark-math` set to `singleDollarTextMath: false`.** It no longer touches single `$` (currency is never swallowed); all `$…$`/`$$…$$` rendering is owned by `rehypeMathInText`, which — unlike `remark-math` — also sees math inside the assistant's raw HTML. `remark-math` still handles ` ```math ` fences and markdown `$$`.
- **Response directive guidance (`html_response_directive.txt`).** The prompt now instructs inline `$…$` for formulas inside a sentence and `$$…$$` only for standalone display equations, and never for plain currency amounts.
- **Removed the fragile string-level currency escaping (net −90 lines).** `protectInlineMathDollars` / `escapeCurrencyDollars` / `spliceEscape` are deleted; their MathJax delimiter logic is relocated into the plugin. `normalizeMathDelimiters` (canonicalizing `\[`/`\(`/` ```latex ` → `$`/`$$`) is kept — it is required because CommonMark eats the `\[` backslash before the plugin would see it.

### Fixed

- **Math never rendered in real answers.** Any formula LIA wrote (`$$…$$` display, `$…$` inline) displayed as raw delimiter text because it lived inside the assistant's HTML, invisible to `remark-math`. It now renders as KaTeX (display formulas as a centered block, inline symbols in-line).
- **Latent stray backslash on currency inside HTML cards.** The removed string-level escaping turned `9$` into `9\$` inside opaque HTML blocks, surfacing a visible backslash; currency is now left literal.

### Tests

- ESLint + `tsc --noEmit` strict clean; full frontend suite green (163 tests) including the production fixture and the plugin edge-case suite; i18n key parity across all 6 locales.
- Docs: `ADR-093` (XSS boundary) extended with the new stage; `docs/technical/SECURITY.md`, `docs/INDEX.md`, `apps/web/CLAUDE.md` and the sanitize-schema comment updated to the four-plugin order.

## [1.21.12] - 2026-07-06

> HITL contract coherence. A confirmation-flow release that unifies Human-in-the-Loop across the two execution modes ([ADR-106 — HITL Contract Coherence](docs/architecture/ADR-106-HITL-Contract-Coherence.md)) — prompt-free, no DB migration. Confirmation had drifted into two trigger mechanisms wired inconsistently: the pipeline is entirely output-driven (a tool returns a draft → `draft_critique`), while ReAct additionally gated on `permissions.hitl_required` through a `react_tool_approval` interrupt that carried no `action_requests` — so it was never rendered (a silent hang) and never resumable. This surfaced through a batch confirmation that showed deletion wording for a batch of sends. Four coordinated fixes bring both modes onto one shared contract.

### Added

- **`hitl_required` consistency invariant (`test_hitl_required_consistency.py`).** A boot/CI test scans the full tool catalogue and asserts the set of `hitl_required=True` tools is a subset of an explicit allowlist (`delegate_to_sub_agent_tool` + user MCP mutation tools). A draft-based tool re-acquiring the flag now fails CI instead of shipping a ReAct hang. Model: the ADR-085 registry-completeness assert.
- **`item_recipient_field` on the draft display registry (ADR-085 extension).** Send-type drafts (`email` / `email_reply` / `email_forward`) declare `item_recipient_field="to"`, so a batch confirmation row renders the recipient (`📧 Email to <to> : <subject>`) — the discriminating field the frontend renders no card for. Localized `DRAFT_RECIPIENT_CONNECTOR` connector (6 languages); no new user-facing i18n strings otherwise.

### Changed

- **ReAct mutation gate unified onto `tool_confirmation` (ADR-106).** `react_execute_tools_node` now raises the shared `action_requests: [{type: "tool_confirmation", …}]` interrupt (rendered by the existing `ToolConfirmationInteraction` and persisted in Redis), and `_parse_approval_decision` gained a `tool_confirmation` branch returning `{"action": "confirm"|"cancel"}` — the shape both `hitl_dispatch._handle_tool_confirmation` and the ReAct gate expect. The bare `react_tool_approval` dialect is removed. A gated mutation defaults to _cancel_ on any non-approval (safety); ReAct executes only on an explicit confirm.
- **Batch draft-critique wording derived from the ADR-085 registry.** `_generate_batch_critique` computes destructiveness from `DraftDisplayConfig.verb_past_key == "deleted"`: deletes keep the irreversible warning + deletion question; sends / creates / updates get the neutral FOR_EACH confirmation question (no irreversible warning), consistent with the pipeline FOR_EACH flow. Both existing 6-language string tables are reused.
- **`hitl_required` corrected on four draft-based tools.** `delete_email_tool`, `delete_event_tool`, `delete_label_tool` and `cancel_reminder_tool` carried a stale `hitl_required=True` (a leftover from before they became draft-based) that routed them to the broken ReAct gate; set to `False`, aligning them with `delete_contact_tool` / `delete_task_tool`. The `_parse_approval_decision` fast-path approval/rejection word sets were consolidated into shared module constants.

### Fixed

- **Silent hang on ReAct mutations.** Deleting an email/event — or invoking any non-draft `hitl_required` tool (e.g. a user MCP mutation) — in ReAct mode suspended the graph with no confirmation rendered. It now renders a proper `tool_confirmation` and resumes correctly.
- **Deletion wording on non-delete batch confirmations.** A batch of sends (e.g. "send an email to A and B" in ReAct) showed "this action is irreversible / confirm this deletion?" under a _"Confirm sending"_ title, and never showed the recipient. Both are fixed.
- **Pipeline `tool_confirmation` resume mismatch.** The `tool_confirmation` type previously fell through to the generic `{"decision": "APPROVE"}` path, which `_handle_tool_confirmation` (reading `.get("action")`) silently treated as _cancel_; the new resume branch repairs it.

### Tests

- New: `test_hitl_required_consistency.py` (catalogue-wide invariant), `test_draft_critique_batch.py` (send vs delete wording + recipient), `test_tool_confirmation_resume.py` (confirm/cancel mapping), plus recipient cases in `test_hitl_item_preview.py`.
- Ruff / Black / MyPy strict clean; full unit suite green; i18n key parity across all 6 locales. New ADR-106; `docs/technical/HITL.md` updated with the unified contract.

## [1.21.11] - 2026-07-06

> Latent-debt hardening. A maintenance release that resolves four independent, isolated debts surfaced by the 2026-07 codebase audit — no user-facing feature change, prompt-free, no DB migration. Each item was fixed red-first (a failing test before the fix) and validated in isolation.

### Added

- **Rolling retention for `psyche_history` (N-201).** The Psyche Engine writes one history snapshot per message (plus reset markers); without a bound an active user accrued ~10k+ rows/year. A new `PsycheStateRepository.delete_snapshots_older_than` purges each user's snapshots older than a configurable rolling window on write, right after a new snapshot is created (in the fire-and-forget post-response task, off the SSE path). New setting `PSYCHE_HISTORY_RETENTION_DAYS` (default 90; `0` disables — keep forever). Uses the existing `ix_psyche_history_user_created` index; no migration. Verified by a unit wiring test, a no-op guard, and a live-DB integration test of the cap.
- **AST CI guard against hard-coded `"Europe/Paris"` (C3).** `apps/api/tests/unit/test_no_hardcoded_timezone_guard.py` fails the build on any exact `"Europe/Paris"` string constant outside the three legitimate data files (the central constant, the timezone-picker list, the schema examples) — mirroring the JSONB-mutation guard.

### Changed

- **Single-source timezone default (C3).** ~30 hard-coded `"Europe/Paris"` application defaults across 19 files (parameter defaults, `.get(...)` fallbacks, SQLAlchemy/Pydantic `default=`) now reference the central `DEFAULT_USER_DISPLAY_TIMEZONE`. Value-identical → no behaviour change, no migration; docstring examples showing the effective value are left as documentation.
- **One JSON-LLM parser (S10).** The strip-fences + trailing-comma logic reimplemented across six extractors (memory, journals ×2, interests, personalities, skills) now delegates to the central instrumented `extract_json_from_llm_response`, each keeping its own domain validation. The central parser gained strict-first-then-tolerant recovery: valid JSON — including URL-bearing strings — is never mutated; only on a decode failure are trailing commas, then `//` comments, repaired incrementally. Net −156 lines; the trailing-comma regex now exists in one place.

### Fixed

- **Superfluous LLM call in pre-planner query analysis (N-97).** `MemoryResolver.retrieve_and_resolve` no longer triggers an LLM reference-resolution call when the extraction step detected no anaphoric reference in the message (previously up to one wasted model call per turn on that path). Behaviour is unchanged when a reference is present (targeted resolution, with broad-facts fallback). The existing test that encoded the wasteful behaviour was corrected, and two regression guards were added.

### Tests

- New: `test_no_hardcoded_timezone_guard.py` (AST guard), `psyche/test_retention.py` (no-DB guards), `integration/domains/test_psyche_retention.py` (live-DB cap), JSON-tolerance cases in `test_json_parser.py`, MemoryResolver short-circuit + regression guards in `test_analysis_services.py`.
- Ruff / Black / MyPy strict clean; full unit suite green (8856 passed, 54 skipped); i18n key parity across all 6 locales. CLAUDE.md's timezone rule now references the new CI guard.

## [1.21.10] - 2026-07-05

> Psyche made perceptible. Prod telemetry showed the Psyche Engine was both **saturated** (pride dominated 61 % of turns, only 4 of 14 moods were ever reached, arousal/dominance ratcheted permanently positive) and **invisible** (a rich inner state was computed every turn but never surfaced in the wording). Two coordinated fixes: **de-saturation** of the dynamics ([ADR-104 — Psyche De-Saturation](docs/architecture/ADR-104-Psyche-De-Saturation.md)) so the mood actually varies and evolves, and **embodied expression** ([ADR-105 — Psyche Embodied Expression](docs/architecture/ADR-105-Psyche-Embodied-Expression.md)) so that variety is felt in the tone of every reply — and every proactive message (reminders, voice, heartbeat, interests). The state is shown, never announced (unless the user asks). Prompt-only change: no DB migration, no schema change; five new `.env` tuning knobs, all default-on.

### Added

- **Embodied psyche expression (A–E).** A new prompt injection (`format_embodied_prompt_injection`) replaces the old invisible directive block with a first-person inner-state frame: **(A)** a concrete voice grammar per mood (`MOOD_EXPRESSION_GRAMMAR`, one per 14 moods, boot-asserted complete), **(B)** authority for the mood to reshape the response form, **(C)** the state reframed from an invisible instruction into an embodied lead, **(D)** an explicit personality × mood reconciliation, **(E)** a widened surface (emotion lead directive, confidence hedging on weak domains, evolution awareness). The mood _may_ break the reply template; it is **never named** unless the user asks (the self-report path). New versioned prompts `psyche_embodied_frame.txt`, `psyche_embodied_faint.txt`, `psyche_embodied_proactive.txt` (added to the `PromptName` Literal).
- **Embodied expression on every proactive channel.** Reminders, heartbeat, voice comments, proactive interests and the fallback response now carry the same embodied inner voice (`psyche_embodied_proactive.txt`), so LIA sounds like the same evolving entity whether it answers or reaches out.
- **Five psyche tuning knobs** (all `.env` + `.env.prod`, default-on): `PSYCHE_EMBODIED_INJECTION`, `PSYCHE_AD_RELAXATION`, `PSYCHE_BASELINE_DAMPING`, `PSYCHE_EMOTION_DECAY_RATE`, `PSYCHE_EMOTION_MAX_ACTIVE` — so the psyche can be re-tuned from production without a rebuild once more data accrues.

### Changed

- **De-saturated mood dynamics** ([ADR-104](docs/architecture/ADR-104-Psyche-De-Saturation.md)). Baseline damping (`PSYCHE_BASELINE_DAMPING` = 0.75) pulls each personality's resting point off its extreme; an asymmetric anti-ratchet relaxation (`PSYCHE_AD_RELAXATION` = 0.15) gently lowers only the arousal/dominance axes sitting _above_ baseline, breaking the positive ratchet; emotion decay is faster (`0.3 → 0.4`/h) and at most 4 emotions stay active at once (`7 → 4`) to stop emotional-blob blending. The mood now traverses far more of the 14-label space and returns toward neutral between exchanges.
- **Pride is earned again.** The automatic pride pulse in the proactive-emotion computation was removed — pride (61 % of prod turns) now comes only from the LLM's own appraisal, not a hardcoded pulse.
- **Response scaffolding uses an `<InnerVoice>` frame** instead of the `<InnerState>` / `<PsycheContext>` wrapper in the main response prompt and every proactive caller; the guidelines grant the inner voice authority over form (`response_system_prompt_base.txt`).
- **Raised ReAct iteration configuration ceilings** so higher operator-set limits are accepted without a validation error: `react_agent_max_iterations` (≤ 30 → ≤ 100) and `mcp_react_max_iterations` (≤ 20 → ≤ 60). Defaults unchanged.

### Fixed

- **Stale "up to 7 simultaneous emotions" documentation.** The technical doc, the knowledge base and the interactive guides (EN/FR) claimed 7 concurrent emotions after the cap was lowered to 4 — corrected across all surfaces (a docstring/doc describing behaviour the code no longer has is a bug).

### Tests

- New `test_desaturation.py` (baseline damping, asymmetric relaxation, emotion cap, embodied + proactive template shape); `test_engine.py` / `test_service_summary.py` updated for the removed pride pulse and the new settings. 173 psyche deterministic tests plus the full fast unit suite green; Ruff / Black / MyPy strict clean; i18n key parity across all 6 locales.

## [1.21.9] - 2026-07-05

> Two-theme release. **HITL internationalization** ([ADR-103 — HITL Backend i18n](docs/architecture/ADR-103-HITL-Backend-i18n.md)): the Human-in-the-Loop layer was structurally French — non-French users hit hardcoded French strings in the approval / edit / refusal flows, and the response classifier was biased by French-only few-shot examples. **Domain-vocabulary single source** ([ADR-102 — Domain Vocabulary Single Source](docs/architecture/ADR-102-Domain-Vocabulary-Single-Source.md)): four derived tables compared a domain token against the wrong axis (singular name vs plural `result_key`), silently disabling the cross-domain reference bypass, goal inference, `$context.file` references and ordinal reference resolution. No DB schema change, no migration; one new `.env` behaviour toggle.

### Added

- **HITL backend internationalization (6 languages).** Approval reformulations (EDIT), the refusal steering message (REJECT) and the rejection summary fallback are localized to all six languages via `HitlMessages` (`get_reformulation` keyed by the new `ReformulationKind` StrEnum, `get_reject_enriched_message`, `get_user_refused_action`). The user's language is read from the checkpointed `MessagesState.user_language` at resume time (`resolve_user_language`, threaded as a parameter — never on `self`, concurrency-safe).
- **Classifier few-shot externalized to a versioned English prompt.** The HITL response classifier's few-shot examples moved from inline French Python to `prompts/v1/hitl_classifier_examples.txt` (one section per action type, cached loader), removing the French-only bias that skewed classification for non-FR users; the user's reply is now classified by intent structure, in any language. Added to the `PromptName` Literal.
- **Backend i18n parity guard.** `test_i18n_parity.py` (ADR-085 model) recursively scans the `core.i18n_*` modules and fails on any language-keyed table missing a language, and — for `dict[lang, dict[key]]` translation tables — on any key set diverging across languages (`i18n_patterns` keyword maps excluded, their keys are per-language words).
- **Domain-vocabulary parity guard.** `test_domain_vocabulary_parity.py` fails on any domain token off the `DOMAIN_REGISTRY`-derived vocabulary, axis-aware (singular name vs plural `result_key`) on the comparison tables, tolerant on the display tables.
- **`PLANNER_CROSS_DOMAIN_BYPASS_ENABLED`** setting (default on; prod kill switch, `.env` + `.env.prod`) gating the cross-domain reference LLM-bypass.

### Fixed

- **Cross-domain reference queries bypass the LLM planner again.** "the restaurant of this meeting" / "directions to that address" fell through to a full multi-domain LLM plan (~800 ms) because `CROSS_DOMAIN_MAPPINGS` compared a plural `places` against the singular `primary_domain` — a condition that never matched. The target is now the singular `place`, so the LLM-free shortcut fires again.
- **Follow-up file references resolve.** `$context.files.0` was rejected by the plan validator, whose allow-list carried the legacy `drive` token and omitted the real result_key `files`.
- **Ordinal reference resolution ("show me the 2nd one") no longer silently degrades** for file / weather / wikipedia / perplexity results — the turn-domain detection returns canonical result_keys (`files`, `weathers`, …) instead of legacy/singular tokens, so it matches `item.meta.domain`.
- **Goal-inference fast path revived.** `_GOAL_PATTERNS` matched plural domains (`contacts`) against the singular runtime domains, so it never fired; keys are singular (`contact`, `email`, `file`…) now.
- **No hardcoded French for non-FR users in the HITL flow.** Draft-modifier prompt scaffolding, the classifier action descriptions and its few-shot are English (LLM-facing; the output language stays the user's via the prompt instruction); every emitted/visible message is localized.
- **Missing Chinese translation.** `_DISPLAY_OPEN_NOW` ("Open now") had no `zh-CN` entry — surfaced and fixed by the new parity guard.
- **Misleading docstrings** in `detect_domain_from_item` claiming a `TYPE_TO_DOMAIN_MAP` mapping the source of truth does not have.

### Changed

- HITL EDIT reformulation kinds are a `ReformulationKind` StrEnum (no magic strings; an exhaustiveness test forbids a silently-empty message). The `$context` allow-list and the turn-domain detection map were promoted to registry-derived module constants (`VALID_CONTEXT_REFERENCE_DOMAINS`, `_DATA_KEY_TO_RESULT_KEY`).
- `resolve_user_language` is a public cross-module helper (was module-private); its checkpoint-read failure path now logs a structured warning instead of swallowing the exception.

### Tests

- Domain-vocabulary and HITL-i18n suites (parity guards, behavioural red-first, an end-to-end "no French for a German/Chinese user" guard). Full fast unit suite green; Ruff / Black / MyPy strict clean; Docker startup verified healthy.

## [1.21.8] - 2026-07-04

> Calendar-search hardening release: pipeline-mode calendar searches that worked in ReAct but failed randomly in Pipeline ("my next medical appointments", "the hotel particulier meeting") now succeed, and a cross-cutting API volumetry-cap bypass is closed. Architecture decision: [ADR-101 — Calendar Search Hardening](docs/architecture/ADR-101-Calendar-Search-Hardening.md). No DB schema change, no migration; new `.env` keys are a behaviour toggle and two cap knobs.

### Fixed

- **Calendar searches by topic or category now work in Pipeline mode.** Asking for "my medical appointments" or an event by a fuzzy/accented name ("hôtel particulier") could return nothing: Google Calendar's free-text `q` is a weak "contains" match — it never matches a medical appointment titled "Dentiste", and trips on accents/paraphrase. The calendar tool no longer sends free-text to that weak search — it keeps only a person resolved to an attendee email (a reliable, structured filter) and otherwise lists your events over the time window and filters the topic when answering (the same list-and-filter model the tasks tool already uses, and the behaviour that already made ReAct mode succeed). Gmail, Tasks, Contacts and Drive are untouched — their search is reliable and analysed per-API.
- **Upcoming/relative calendar queries no longer miss later events.** For an open query with no explicit date ("my next medical appointments", "my next 3 events") the planner sometimes invented a narrow end date (e.g. now + 2 days) that hid the very events you asked for. A new, reliable temporal signal from the query analyzer (validated 14/14 across the 6 languages) lets the validator drop such a hallucinated bound so the tool's own default window applies. Explicit dates and periods ("on August 15", "the next two days", "next week") are detected and preserved untouched.
- **External-API result volumetry is enforced everywhere (security).** The global per-request ceiling (`api_max_items_per_request`) was silently bypassed by five clients (Google Calendar, the three Apple clients, Microsoft Calendar), which built their page size directly — so the calendar could return an unbounded number of events regardless of the configured cap. All item search/list calls now route through the single `apply_max_items_limit` helper, and a new AST guard fails CI if any client ever forgets it again. Metadata enumerations (calendars, labels, task-lists) and the bulk contact sync are explicitly exempt.

### Added

- **`has_temporal_reference`** analyzer signal (threaded analyzer → QueryIntelligence → validator, with round-trip coverage) and a per-parameter **`search_role`** manifest role (`ParameterSchema`, typed `Literal`) driving the deterministic end-of-window date reset.
- **`test_max_items_cap_guard.py`** — AST guard enforcing the volumetry ceiling on every connector item search/list method.
- **`PLANNER_OPEN_QUERY_DATE_RESET`** setting (default on; prod kill switch) and the Prometheus counter `lia_planner_open_query_date_reset_total`.

### Changed

- **Result ceilings raised:** `API_MAX_ITEMS_PER_REQUEST` 10 → 25 and `CALENDAR_TOOL_DEFAULT_MAX_RESULTS` 10 → 25 (`.env` + `.env.prod`). Other domains keep their own key at 10 (they pass it explicitly, so `min(10, 25) = 10`), so their behaviour is unchanged.

### Removed

- **`GENERIC_CALENDAR_QUERY_TERMS`** hardcoded allow-list (superseded by the person-vs-free-text resolution) and dead `*_TOOL_DEFAULT_MAX_RESULTS = 50` / bare `API_MAX_ITEMS_PER_REQUEST` module constants (comment-only references; the effective caps are the Settings fields).

## [1.21.7] - 2026-07-04

> Regression-recovery & robustness release: fixes the collateral damage of the wave-3 strict CSP (voice input, the interactive-map skill and every third-party MCP App widget had stopped working), and closes a five-defect incident where a diagram request hung two minutes then rendered an unrelated map. Two architecture decisions: [ADR-098 — CSP Widget Airlock](docs/architecture/ADR-098-CSP-Widget-Airlock.md) (per-document policies so third-party widgets get their own permissive sandbox while the app policy stays strict) and [ADR-100 — Native Structured Output vs "Output JSON" Prompt Conflict](docs/architecture/ADR-100-Structured-Output-Prompt-Conflict-Guard.md) (a runtime rescue net + a prompt convention). Also removes a dead, misleading nginx config ([ADR-099](docs/architecture/ADR-099-Remove-Dead-Nginx-Config.md)). No DB schema change, no migration; new `.env` keys are timeout-tuning knobs.

### Fixed — regressions from the wave-3 CSP (ADR-098)

- **Voice input (push-to-talk) works again.** The v1.21.5 strict `Content-Security-Policy` omitted `blob:` from `script-src`, and — per CSP Level 3 — an `AudioWorklet` module (loaded from a `blob:` URL) is governed by `script-src`, not `worker-src` (which did allow `blob:`). Every voice-capture path (push-to-talk STT, wake-word and recording worklets, the Sherpa WASM glue loader) was blocked, so pressing-and-holding the send button raised "an error occurred during voice input". `blob:` is back in `script-src`. Root cause traced in the API logs: the WebSocket connected but received `total_bytes_received: 0`.
- **The interactive-map skill displays again.** Its Google Maps embed was blocked because the CSP declared no `frame-src`, so the directive fell back to `default-src 'self'`. An explicit `frame-src 'self' https://www.google.com` restores it.
- **Third-party MCP App widgets (Excalidraw, …) render again — via a dedicated sandbox.** These widgets load their runtime from external CDNs (esm.sh), which the strict CSP forbids; a `srcDoc` iframe inherits the parent policy with no way to relax it. Widgets now boot through a same-origin **airlock shell** (`public/widget-frame.html`) served with its own permissive CSP, while the main app keeps its strict policy. Isolation still comes from the iframe `sandbox` (opaque origin), not the CSP. The shell is hardened by five anti-abuse locks + `frame-ancestors 'self'`; both policies are extracted to `src/lib/csp.ts` and every feature-bearing directive is now pinned by non-regression tests (two CSP regressions had shipped blind precisely because the policy had no tests).

### Fixed — diagram-request incident (ADR-100)

- **Complex diagrams no longer time out.** MCP iterative `*_task` steps (the ReAct sub-agent loop behind Excalidraw) were clamped by the generic 120 s ceiling, but a single diagram-generation model call alone takes ~105 s — the agent was killed ~10 s before finishing, wasting the work. A dedicated timeout family now applies (`mcp_react_step_timeout_seconds` 300 s floor / `mcp_react_step_max_timeout_seconds` 600 s ceiling), and the plan-wide soft budget is raised 120 → 600 s so it dominates the longest step families.
- **No more off-topic fallback answers.** The planner had emitted a `skill_name` inconsistent with its own steps (`interactive-map` for a "draw a diagram" request), and the response node activated that skill even though the plan had totally failed — dressing a two-minute timeout up as "here is the map". Two guards: the planner now drops a `skill_name` that contradicts the query analysis or is absent from the catalog, and the response node no longer activates a plan's skill when the plan totally failed (the failure is surfaced instead).
- **Plan semantic validation restored.** The internal check that verifies a generated plan matches your request had silently stopped working (100 % failure): it forced a structured tool call while its prompt said "Output JSON only", and on the reasoning model that conflict made the answer come back as unparseable text, so validation failed open. Fixed at the root (prompt cleaned) and hardened everywhere by a **rescue net** that salvages structured output when any model answers in JSON text instead of calling the tool — protecting every internal component that relies on structured output. A full sweep cleaned three other prompts with the same latent conflict; five prompts that legitimately parse JSON by hand were left untouched.
- **Honest recovery logging.** The adaptive re-planner logged decisions ("retrying…") as if it acted on them, though automatic retry/re-planning is not wired yet; the logs are now honest and dead inline-French error strings (never displayed) were removed. Automatic recovery remains a documented, deliberately-deferred feature (see the `TODO(D4)` in `task_orchestrator_node.py`).

### Removed

- **Dead nginx reverse-proxy config deleted (ADR-099).** `infrastructure/nginx/` shipped with v1.0.0 and was never wired in any Compose file; its permissive CSP contradicted the real strict policy and cost real analysis time during the ADR-098 investigation. Production ingress is the host-level Cloudflare tunnel; `infrastructure/ssl/` (live dev-HTTPS cert generator) is kept.

## [1.21.6] - 2026-07-04

> Correctness-under-concurrency, GDPR & sandbox release: **wave 4 of the full-codebase audit** — the audit's most insidious class, defects that surface only under concurrency or in account-lifecycle scenarios (invisible to unit tests and static analysis). Reinforced protocol: on top of red-first, **every item carries a concurrency or integration test that reproduces the defect before the fix** — "no reproduction, no fix". Architecture decision: [ADR-097 — Concurrency, GDPR Purge & Skill Sandbox from the Wave-4 Audit](docs/architecture/ADR-097-Concurrency-GDPR-Sandbox-Wave4-Audit.md). No DB schema change, no migration; new `.env` keys are all opt-outable sandbox/tuning knobs.

### Fixed — correctness under concurrency

- **Shared SQLAlchemy session no longer raced under `asyncio.gather` (A5a).** SQLAlchemy forbids concurrent operations on one `AsyncSession`. `HealthMetricsService.compute_overview` gathered one summary per health kind on its shared session, and `heartbeat.ContextAggregator.aggregate` gathered 10 fetchers (8 on `self._db`) with `return_exceptions=True` — so concurrency errors were silently converted into `failed_sources`, dropping heartbeat context sources non-deterministically. `compute_overview` is now a sequential loop (two indexed queries); the aggregator gives **each gathered fetcher its own `get_db_context()` session** (`_with_fresh_session`, the pattern `briefing/fetchers.py` documents as CRITICAL). **Guard** (real Postgres, pooled engine so the fresh-session connection race actually reproduces): before, 7 heartbeat sources lost + `InvalidRequestError`; after, 0 lost.
- **Per-request state removed from singletons — cross-user leak closed (B6).** `SmartPlannerService` (a singleton) stored the caller's private `journal_context` on `self` and read it back after await points → user B's journal could land in user A's planner prompt. It is now an **explicit parameter** threaded through the planner, both LLM strategies and all three bypass strategies. `ConnectorTool.runtime` (singleton tool instances) → **task-local ContextVar** (bound/reset by `execute()`), closing a timezone/language leak between users. `SmartCatalogueService._metrics` → ContextVar (same approach as the already-migrated `panic_mode_used`). **Guard**: two interleaved user calls (a gate parks user A on an await while user B completes) proved the leak, then proved isolation.
- **Tool-call pairing preserved through history filtering (N-179b).** `MessageHistoryMiddleware` selected the "last 5 ToolMessages" and trimmed by tokens _per message_, detaching a ToolMessage from the AIMessage carrying its `tool_call`s → OpenAI/Anthropic 400. Filtering now groups messages into **atomic units** (an AIMessage with `tool_calls` + its ToolMessages travel together); a final `enforce_tool_message_pairing` net guarantees the provider contract in both directions even for already-corrupted histories. **Guard**: a 45-combination sweep of `(keep_last_n × max_tokens)` asserts a provider-valid sequence for every pressure.
- **Domain-agent datetime is per-invocation, token accounting is linear (N-183).** `build_generic_agent` rendered `{current_datetime}` once at BUILD time while agents are cached for the process lifetime (stale "now" after uptime) → a new `DynamicDatetimeMiddleware` re-renders it on every model call. The agent wrapper re-recorded the `usage_metadata` of _every_ AIMessage in the returned full-state on _every_ invocation (quadratic token accounting + inflated Prometheus tool counters) → it now records only messages posterior to entry (index diff). **Opportunistic fix**: `ContextEditingMiddleware` fell back to a dict-based edit (the removed `TruncateToolResult` API) whose objects lack `.apply()` — crashing _every_ model call of _every_ built agent (masked by the retry middleware as "Model call failed after 4 attempts"); now uses the real `ClearToolUsesEdit`.

### Security & privacy

- **Health data and ingestion tokens are purged on account deletion (A5b, GDPR).** `AccountDeletionService` purged 20+ tables but not `health_samples` / `health_metric_tokens`; the user row is soft-deleted so FK CASCADE never fired → physiological data (the most sensitive GDPR category) survived deletion and a deleted user's iPhone kept ingesting samples. Both tables join the purge (deleting the tokens also cuts off the device), `last_known_location_encrypted` / `_updated_at` are scrubbed alongside `home_location`, and — **defense in depth** — health-token authentication now joins `User` and requires `is_active AND NOT deleted` (a deactivated/deleted owner's token no longer authenticates even if a future flow forgets to revoke it). **Guard**: after deletion, 0 health/location rows remain and an ingestion write is refused (401); 7 integration tests.
- **Skill scripts can no longer reach the Docker socket, and are resource-bounded (A1/A2).** `run_skill_script` is open to every user and `SkillScriptExecutor` ran scripts as **root** with `/var/run/docker.sock` visible — full control of every container on the host — with no CPU/RAM/process/file-size ceiling. The proposed mount-namespace mask is impossible in the container (no `CAP_SYS_ADMIN`); instead each skill subprocess is **dropped to an unprivileged uid** (`setgroups([])` → `setgid` → `setuid` in `preexec_fn`, supplementary groups cleared first), making the root-owned socket unreachable and `RLIMIT_NPROC` effective. The same `preexec_fn` applies **RLIMIT_AS/NPROC/FSIZE/CPU**. The admin DevOps Claude CLI is untouched (separate code path, still root). **Guard** (in-container, as root): a non-dropped script opens the socket and lists containers; a dropped one is denied both; a CPU spin is killed, memory/file-size capped, fork storm contained.

### Changed — tooling

- **MyPy type-checks against the deployment target.** `pyproject.toml` sets `platform = "linux"` for mypy so the host pre-commit hook and the Linux CI runner resolve POSIX-only APIs (`resource`, `os.setuid`/`setgroups`) identically — closing the recurring host/Docker mypy divergence (Dev Container Pitfall #2). Verified: 0 errors across all 865 source files.

### Fixed — test infrastructure (unblocks the integration suite)

- A module-level Redis client bound its connection to the first test's event loop, crashing every later Redis-touching test with "Event loop is closed" — an autouse fixture now resets the singletons per test. `.env.test` pins `SESSION_COOKIE_SECURE=false` (the httpx test client never resends a `Secure` cookie, so session-authenticated endpoints 401'd). Five pre-existing rotted unit tests fixed (stale constant/model assertions, a raw-DBAPI-exception 500 in `/health`, a cookie-secure default that leaked the developer's `.env`).

## [1.21.5] - 2026-07-03

> Performance & hardening release: **wave 3 of the full-codebase audit** — three boundaries the earlier waves did not touch (the async/event-loop boundary, the network-exposure boundary, the XSS trust boundary) plus four localized performance/correctness fixes. Every item was **measured before/after** (latency or call count — no unquantified "should be faster") and driven red-first. Architecture decision: [ADR-096 — Performance, Network & Trust Boundaries from the Wave-3 Audit](docs/architecture/ADR-096-Performance-Boundary-Hardening-Wave3-Audit.md). Unlike waves 1–2 this one **does** carry a DB schema change (one JSONB column + migration) and two new `.env` keys — both performance caches, opt-outable.

### Performance — event loop no longer frozen by synchronous work

- **Synchronous work moved off the async event loop.** Three call sites ran blocking work inline on the loop, freezing _every_ concurrent coroutine (SSE streaming included) for its full duration: `firebase_admin.messaging.send` (FCM push + broadcast — measured **261 ms** single / **496 ms** for a 2-token broadcast), Pillow decode + LANCZOS + encode on image edit (**251 ms**), and two embedding calls (`embed_documents` in interests, `embed_query` in heartbeat). Firebase sends and the Pillow pipeline now run via `asyncio.to_thread` (new `resize_image_b64_async` wrapper); the embeddings use the native async API (`aembed_documents` / `aembed_query`). After: the loop stalls **11–12 ms** instead of 251–496 ms during the same operations. **Guard:** an event-loop stall test helper (`tests/helpers/event_loop.py`) measures the max scheduling gap while the workload runs — a regression that reintroduces blocking fails CI. Also corrected a docstring that claimed `asyncio.to_thread` on a path that did not use it.
- **Two hot-path scans parallelized.** `context/manager.list_active_domains` (on `resolve_reference`'s hot path) issued ~2 sequential store reads per registered domain → `asyncio.gather` per domain, registry order preserved (**631 → 63 ms** on a 10-domain bench). Gmail `search_emails` fetched each message's metadata one-by-one after the list call (the endpoint returns IDs only) → bounded `asyncio.gather` (concurrency from the new `EMAILS_SEARCH_FETCH_CONCURRENCY`, default 8; each fetch still passes the rate limiter), **331 → 62 ms** for 10 results, same payloads and order.

### Added — caching that removes repeated work

- **User display preferences are cached per worker.** `get_user_preferences` (used by 25+ tools, several times per plan) opened a DB session and queried `User` on **every** call. It now reads a per-worker TTL cache (`UserPreferencesCache`, default 5 min via the new `USER_PREFERENCES_CACHE_TTL_SECONDS`, `0` disables), invalidated immediately on profile update — **one User query per TTL window per user** instead of one per call. Same pattern as `LLMConfigOverrideCache`.
- **Admin broadcast translations are persisted.** A broadcast shown to a user whose language differs from the source was re-translated by an LLM on **every** read (login, tab focus). Translations are now stored in a new JSONB column `admin_broadcasts.message_translations`: filled for all recipient languages at send time, lazily backfilled on read for historical broadcasts (server-side atomic `coalesce(...) || :new` merge so concurrent backfills never lose a language). Reading an already-translated broadcast now costs **0 LLM calls**. A failed translation (fallback = source text) is never frozen into the cache.

### Security — trust & network boundaries

- **The dashboard greeting can no longer execute injected content.** The LLM-generated hero greeting was rendered via `dangerouslySetInnerHTML`; the greeting can echo third-party text (e.g. a calendar event titled `<img src=x onerror=alert(1)>`). It now renders as auto-escaped React children (like `BriefingSynthesis`) — hostile markup is inert. **Guard:** a component test asserts an `onerror` event title produces no element and no script execution.
- **Strict Content-Security-Policy added.** `next.config.ts` now sets a CSP header as defense-in-depth behind the React-escaping boundary: an injected `<script src>` or `eval()` is blocked even if a future rendering bug reintroduces raw HTML. It preserves the app's real needs — Sherpa-onnx WASM voice mode (`wasm-unsafe-eval`, `worker-src blob:`), Google Fonts, the separate API origin (`connect-src` derived from `NEXT_PUBLIC_API_URL` + its ws variant), and MCP/Skill `srcDoc` widgets. Verified in-browser: **0 violations** across login, dashboard (with a real LLM greeting), chat, landing and FAQ. (`'unsafe-inline'` remains in `script-src` — Next.js App Router ships inline bootstrap scripts and static headers cannot carry a per-request nonce; the header still blocks every external script origin and `eval`.)
- **Internal services no longer reachable from the LAN (production).** `docker-compose.prod.yml` published 13 ports on `0.0.0.0` (Postgres, Grafana, Prometheus, Loki, Tempo/OTLP, Portainer, cAdvisor, exporters). Docker inserts its iptables chain **before** ufw, so a `ufw deny` did not protect them. All internal services now bind to `127.0.0.1`; `cloudflared` remains the single public entry point (**13 → 1** published port — only `web`). Container-to-container traffic is unaffected (service names on the compose network). Documented in the new [infrastructure/README.md](infrastructure/README.md): the ufw-bypass mechanism, the `DOCKER-USER` chain as the supported hook, and SSH-tunnel access for admin tools.

### Fixed — locale & internationalization

- **Valid display locales for every language.** `get_user_preferences` derived the locale as `f"{lang}-{lang.upper()}"`, producing nonexistent locales `en-EN` and `zh-ZH` — the latter broke Chinese date formatting. Replaced by a `LANGUAGE_TO_LOCALE` mapping (`en → en-US`, `zh-CN → zh-CN`, …) with a boot-time completeness assert. The bug was duplicated inline in `emails_tools.py` (2 sites); all three now call one helper.

### Changed — admin LLM configuration

- **The personality translator is now a configurable LLM slot.** `PersonalityTranslationService` hardcoded provider/model/temperature/max*tokens and invoked the provider adapter with a `personality_translation` `llm_type` that **did not exist** in `LLM_TYPES_REGISTRY` — invisible in the admin \_LLM Configuration* UI and immune to DB overrides. It is now a registered slot (`LLM_TYPES_REGISTRY` + `LLM_DEFAULTS`, same gpt-4.1-nano defaults) routed through `get_llm()`, with its prompt moved to `prompts/v1/`. The slot appears in the admin UI (54 LLM types) and honors a DB override.

### Fixed — email reply robustness

- **Gmail reply body built before MIME construction.** `reply_email` called `set_payload(bytes)` on a `MIMEText` whose `Content-Transfer-Encoding` was already `base64`, relying on undocumented re-encoding behavior of the `email` package. The quoted body is now assembled **before** the `MIMEText` (parity with `apple_email` and `forward_email`). Note: the double-encoding defect did **not** reproduce on the runtimes in use (Python 3.12 container, 3.13 host) — recorded as hardening, not a user-visible bug fix; validated by a real dev send with accented text.

### Notes

- **DB schema change + migration:** `admin_broadcasts.message_translations` (JSONB), migration `admin_broadcast_translations_001` (single head). **Two new `.env` keys:** `USER_PREFERENCES_CACHE_TTL_SECONDS` (default 300, `0` disables) and `EMAILS_SEARCH_FETCH_CONCURRENCY` (default 8) — both performance caches, documented in `.env.example` and `.env.prod.example`.
- **Docs:** [ADR-096] (+ ADR index, docs INDEX), `infrastructure/README.md` (new — network exposure model + ufw/DOCKER-USER), `GUIDE_DEPLOYMENT.md` (network exposure section), `LLM_CONFIG_ADMIN.md` (registry now 54 types + `personality_translation`), FAQ application changelog (user/admin-facing subset, 6 languages).
- **Quality:** Ruff / Black / MyPy strict clean; backend **8687 unit tests green** (+~25 new, red-first) + agents suite green; frontend **123 tests green** (+3 XSS) + ESLint + `tsc` clean; i18n key parity across all 6 locales; Docker startup verified healthy (API + web) with the migration applied and CSP active.

[ADR-096]: docs/architecture/ADR-096-Performance-Boundary-Hardening-Wave3-Audit.md

## [1.21.4] - 2026-07-03

> Reliability & privacy release: **wave 2 of the full-codebase audit**

> Reliability & privacy release: **wave 2 of the full-codebase audit** — closes seven _systemic_ classes of near-zero-risk defect (not just their occurrences). Every class gets a permanent guard — a CI test, a Prometheus metric, or a written convention — so it cannot silently recur. Each fix was re-confirmed against the code, driven red-first, and validated diff-by-diff. Architecture decision: [ADR-095 — Systemic Guards from the Wave-2 Audit](docs/architecture/ADR-095-Systemic-Guards-Wave2-Audit.md). No DB schema change, no migration, no new `.env` key.

### Fixed — Data persistence (silent write loss)

- **In-place JSONB mutations are now persisted.** SQLAlchemy does not detect in-place mutation of a JSONB column (`obj.meta["k"] = v`, `obj.meta.update(...)`, `obj.list.extend(...)`) — it silently skips the UPDATE and the write is lost. Four real sites fixed by building a **new** container and reassigning: `connector.connector_metadata["last_used_at"]` (API-key connectors — the "last used" timestamp was never written), `connector_metadata.update(error_info)` on OAuth auth-failure invalidation (error diagnostics lost), and two psyche-state sites (`last_appraisal`, `active_emotions`). **Guard:** `tests/unit/test_jsonb_mutation_guard.py` parses every model's JSONB columns from their ASTs and fails CI on any in-place mutation of a same-named attribute anywhere in `src/` — the whole class is closed, not just the four sites.

### Fixed — Billing-cycle statistics (counter leak across silos)

- **No counter leaks across a billing-cycle boundary, whatever event crosses it.** Three code paths could roll the cycle over (a chat message, an STT call, a dashboard read) and each hand-reset a _different subset_ of counters — so the STT path leaked tokens/messages/Google/image/TTS from the previous cycle, the message path leaked STT, and the dashboard leaked image/STT/TTS. All three now delegate to a single `UserStatistics.reset_cycle()` that zeroes **every** `cycle_*` column by introspecting the model, so a future silo is reset automatically. **Guard:** a multi-silo test asserts that no old-cycle counter survives any of the three crossing events, plus a sentinel test that fails if a new `cycle_*` column is added without coverage. Also: the two remaining naive `datetime.utcnow()` (plan-approval schemas) → `datetime.now(UTC)`.

### Changed — Privacy: no PII at INFO and above (GDPR data-minimization)

- **Personal data removed from operational logs.** Home address + GPS coordinates, resolved contact names/emails, email recipients/subjects, memory-content previews, HITL display labels, Jinja result previews and raw tool params were logged at `INFO`/`WARNING`/`ERROR`. Per policy (counters/IDs at INFO; contents at DEBUG or redacted), the call sites in the seven cited modules were corrected (contents demoted to DEBUG twins where useful for support). **Guard:** a systemic net in `pii_filter.py` — a `CONTENT_FIELD_NAMES` set (recipients, subject, body, coordinates, resolved names, mappings, params, query text, …) is **redacted at INFO and above** and passes through only at DEBUG, driven by the structlog `method_name`. A future `subject=`/`lat=` accidentally logged at INFO can no longer leak. The sweep confirmed the net catches real leaks the per-module pass alone would have missed (Gmail **and** Outlook recipient/subject at INFO, planner/response resolved-name mappings, users-service home address). Documented in [PII_LOGGING_SECURITY.md](docs/technical/PII_LOGGING_SECURITY.md).

### Changed — Tool registry robustness (silent capability loss)

- **A broken tool module can no longer disappear silently.** Three `except Exception: _X_AVAILABLE = False` blocks in `tools/__init__.py` and the `_import_tool_modules` loop swallowed import errors — a renamed symbol or missing dependency silently removed an entire tool family from the registry (the class of bug that shipped as N-140). Now: `_import_tool_modules` **raises outside production** and increments a new `tool_module_import_failures_total{module}` Prometheus counter in production (resilience over crash); the conditional imports log + count instead of failing silently. **Guard:** a three-layer registry smoke test (`test_tool_registry_smoke.py`) that (1) imports every canonical module directly, (2) checks each family's sentinel tool is registered, and (3) **invokes all ~95 registered tools** with synthesized minimal args (network blocked, sleeps neutralized — 0.6 s) and rejects any programming error escaping the tool or classified inside its error payload. This immediately surfaced two latent bugs, now fixed: an unguarded `runtime.config` access when `runtime` is `None` (→ structured configuration error) and five bare `runtime.store` accesses in the email/calendar tools (→ `runtime and runtime.store`).

### Fixed — Internationalization

- **Chinese users get Chinese, not French.** The system carries two legitimate spellings for Chinese — `zh` (frontend locales/URLs) and `zh-CN` (backend `User.language`, i18n table keys). Two modules keyed their tables so that `language="zh"` never reached the `zh-CN` entries: `tools/labels.py` (contact field-type / relation labels) and `formatters/text_summary.py` (domain labels, which additionally used the inverse `zh` key). Both now normalize through a single chokepoint. The chokepoint itself is unified: the canonical `normalize_language` lives in `core/i18n.py`, and the former divergent copies (`agents/utils/i18n_location.py`, `core/i18n_drafts.py`) delegate to it — one implementation for the whole backend.
- **The last-resort fallback message is localized (6 languages).** When the pipeline _and_ the fallback LLM both fail, the emitted message was a hardcoded accent-less French string (`"Je n'ai pas trouve les informations demandees"`) shown to every user regardless of language. Replaced by `get_simple_fallback_message(language)` routed through the central `SSEErrorMessages` i18n mechanism (proper French diacritics + en/es/de/it/zh-CN); the streaming caller passes the user's language.

### Changed — Docstring honesty

- **Five docstrings that described behavior the code does not have, corrected** (code left intact per the wave's scope): `web_fetch_tools` ("streaming check" — the body is actually read in full, only headers are checked pre-download), `psyche/models` ("Cached in Redis" — the v1 marker key does not serve reads), `state_mutation` ("automatic rollback" — rollback is manual via `ctx.backup`), `parallel_executor` header ("~500 lines" on a 3875-line file), and `runtime_helpers` (a `recipient_resolution_enabled` feature toggle that no longer exists).

### Notes

- **No DB schema change, no Alembic migration, no new `.env` key.** New Prometheus metric only: `tool_module_import_failures_total`.
- **Docs**: [ADR-095] (+ ADR index), `PII_LOGGING_SECURITY.md` (content-field redaction section), `CLAUDE.md` (systemic-rule enforcement pointers), FAQ application changelog (user/admin-facing subset).
- **Quality**: Ruff / Black / MyPy strict clean; backend **8641 unit tests green** (+66 new) + **1069 agents tests green**; i18n key parity enforced across all 6 locales; Docker startup verified healthy with the full change set. Frontend untouched (backend-only release).

[ADR-095]: docs/architecture/ADR-095-Systemic-Guards-Wave2-Audit.md

## [1.21.3] - 2026-07-03

> Reliability release: **wave 1 of a full-codebase audit** — 14 confirmed, surgical, single-function fixes, each with a regression test written red-first — plus a hardening pass (dead-code removal [ADR-094], i18n, test-suite rehabilitation). No new user feature, no DB schema change, no migration.

### Fixed — Connected services

- **Apple Calendar events honor the requested timezone.** `_parse_iso_datetime` stamped naive datetimes as UTC _before_ `_apply_timezone` ran, and `_apply_timezone` ignored aware datetimes — so the `timezone` parameter never applied: a "10:00 Europe/Paris" event was created at 10:00 UTC (12:00 Paris in summer). Now: parse without stamping (`assume_utc=False`), apply the requested timezone, fall back to UTC only when none is requested. Covers create and update.
- **Microsoft Calendar search tolerates apostrophes.** A free-text `query` was interpolated into the OData `$filter` unescaped, so `contains(subject, 'l'anniversaire')` produced a malformed filter → Graph API 400. Single quotes are now doubled per the OData literal rule.
- **Google Tasks "list task lists" works again.** `get_settings.tasks_tool_default_max_results` (missing `()`) accessed the attribute on the `lru_cache` wrapper, raising `AttributeError` on **every** call — swallowed as a generic `INTERNAL_ERROR`. Fixed to `get_settings()`.
- **Static route maps render correctly.** The polyline encoder used `chr((value & 0x1F) | 0x20 + 63)` where `+` binds before `|` — corrupting every continuation chunk, so multi-segment routes encoded to invalid geometry. Corrected precedence; known-answer + round-trip-by-value tests added (the previous tests only checked structure/count, never encoded values).

### Fixed — Assistant behavior

- **Ambiguous Gmail labels ask instead of erroring.** The disambiguation dict returned by `execute_api_call` had no `label_id`, but `DeleteLabelDraftTool.format_registry_response` accessed `result["label_id"]` unconditionally → `KeyError` → generic error instead of the disambiguation question. The disambiguation path now short-circuits before draft creation across delete/apply/remove, reported as a non-success (`DISAMBIGUATION_REQUIRED`), not a false action success.
- **Stopping a ReAct exploration actually stops it.** Both ReAct tool wrappers caught `BaseException` and turned it into an `"ERROR: …"` string for the LLM — which also swallowed `asyncio.CancelledError`, so a user stop kept the loop iterating on a fake tool error. `except asyncio.CancelledError: raise` added before the catch-all in both wrappers.
- **Connector "not activated" messages are localized (6 languages).** `_format_connector_not_activated_error` / `_format_category_not_activated_error` (`tools/base.py`) hardcoded French — a CLAUDE.md violation (no inline language in LLM-facing scaffolding). Now routed through the central `APIMessages` mechanism in all 6 languages; the user language is read synchronously from the runtime config and passed as a parameter (never stored on the singleton tool's `self` — concurrency-safe).

### Fixed — User-configured MCP & HITL

- **User MCP servers respect "iterative mode" at creation.** `create_server` omitted `iterative_mode` from the repository payload, so a server created with iterative mode enabled was persisted as disabled.
- **HITL edit metadata persists.** `update_last_user_message` mutated and re-assigned the **same** dict object, so SQLAlchemy saw `current is original` and silently skipped the JSONB UPDATE when the message already had metadata — HITL EDIT metadata was lost. Now builds a new dict (`dict(...)`).

### Security & configuration

- **Account enumeration surface closed.** `GET /users/search/by-email` was reachable by any authenticated user; it is now superuser-only (`require_superuser`), consistent with the other admin user operations. No frontend consumer impacted.
- **Planner budget/steps `.env` overrides honored.** In `export_for_prompt_filtered`, `getattr(settings.planner_max_cost_usd, "planner_max_cost_usd", 50.0)` applied `getattr` to the _value_ (a float) — always serving the hardcoded 50.0/50, ignoring configuration. Both catalogue exporters now read `settings.planner_max_cost_usd` / `settings.planner_max_steps` directly; the misleading in-code defaults are gone (the real defaults, 2.0$ / 20 steps, live in `constants.py` via the `.env → settings → constants` chain).
- **Two hardcoded values become configurable.** `lifetime_metrics_update_interval` (DB→Prometheus gauge sync period) and `mcp_react_step_timeout_seconds` (wall-clock floor for `*_task` ReAct plan steps) were read via `getattr(settings, …, <literal>)` against **non-existent** fields — the literal was always served. Both are now real `Settings` fields with constants and `.env.example` entries.

### Changed — Reliability & dead-code removal

- **Registry LRU eviction no longer crashes on mixed forms.** `_get_item_timestamp` (`data_registry/state.py`) returned a `datetime` for `RegistryItem` objects but an ISO **string** for serialized dicts, so `sorted()` raised `TypeError` once the registry exceeded `registry_max_items` with both forms present (long conversations). The sort key is normalized to an aware UTC `datetime` in every case.
- **`QueryIntelligence` round-trips completely.** `reconstruct_query_intelligence` omitted `semantic_filter_terms` (serialized by `to_serializable_dict`), so the field silently reset to `()` after every HITL checkpoint resume. Restored (as a tuple), with a generic round-trip equality test over **all** serialized fields to catch future omissions.
- **LLM capability check unified.** Three ReAct LLM types declared `required_capabilities=["tool_calling"]` while the checker only knows `"tools"` (and silently returns True for unknown capabilities) — the capability was never verified. Unified on `"tools"`, plus a `KNOWN_MODEL_CAPABILITIES` completeness test so an unknown capability string fails loudly.
- **Web client stops leaking abort timers.** `createAbortSignal` used a bare `setTimeout(() => controller.abort(), timeout)` that was never cleared — a pending timer survived every completed request. Replaced with `AbortSignal.timeout()`.
- **Dead per-node windowing subsystem removed ([ADR-094]).** `get_router/planner/orchestrator_windowed_messages` had no call site (the router reads full state; token growth is already bounded by the `add_messages_with_truncate` reducer); their three settings/constants/`.env` entries and tests were transitively dead. Removed. `get_windowed_messages` (ReAct) and `get_response_windowed_messages` remain. Deliberate per-node windowing is deferred to the latency effort, with benchmarks.

### Tests & tooling

- **`tests/agents` rehabilitated and CI-gated.** The suite had silently rotted (83 stale failures + 7 errors — never run by any gate) because tool renames, an output-type migration, a merged contacts tool, an OData-vocabulary refonte and a fixture that cleared `ContextTypeRegistry` without restoring it all drifted the tests. Rewritten against current contracts (or deleted where the tested surface no longer exists, with rationale); a cross-test pollution bug and a Windows IPv6/Redis + cross-loop-singleton issue in the HITL e2e tests fixed. Now **1069 green** and wired into `task ci` + the GitHub workflow so it cannot rot unnoticed again.
- **Value-blind-test scanner.** `scripts/analyze_value_blind_tests.py` inventories tests whose assertions can't catch a value regression (the polyline class: structure-only tests hiding a broken computation) and, more actionably, flags files where **no** test makes a strong assertion. The one genuine gap it surfaced (`test_decorators.py` — 14 tests asserting only `tool_func is not None`) was rewritten with real behavioral assertions; result: **zero fully value-blind files**.
- **Dev**: uvicorn runs `--reload-dir src` in the dev container (the whole `apps/api` tree is bind-mounted, so test/coverage writes no longer trigger reload storms that could wedge the reloader).

### Notes

- **No DB schema change, no Alembic migration.** New `.env` keys (with sane defaults, no action required): `LIFETIME_METRICS_UPDATE_INTERVAL`, `MCP_REACT_STEP_TIMEOUT_SECONDS`; removed no-op keys: `ROUTER_/PLANNER_/ORCHESTRATOR_MESSAGE_WINDOW_SIZE`.
- **Docs**: ADR-094 (+ index), `MESSAGE_WINDOWING_STRATEGY.md`, `GUIDE_PERFORMANCE_TUNING.md`, `GUIDE_DEBUGGING.md` resynced to the removed helpers.
- **Quality**: Ruff / Black / MyPy strict clean; backend **8572 unit tests green** + **1069 agents tests green**, frontend **120 green**; Docker startup verified; every commit passed the full pre-commit hook.

[ADR-094]: docs/architecture/ADR-094-Remove-Dead-Per-Node-Windowing-Helpers.md

## [1.21.2] - 2026-07-03

> Architecture decision: [ADR-093 — Security Hardening: Trusted Proxy Chain & XSS Sanitization Boundary](docs/architecture/ADR-093-Security-Hardening-Proxy-XSS.md). Security & robustness release from a systemic audit of the remaining high-severity backlog, plus the math-rendering loop closed end to end. No DB schema change, no migration.

### Security — Trusted proxy chain (F1, ADR-093)

The prod API port was published on every host interface (`"8000:8000"`) — LAN clients could bypass Cloudflare entirely — and uvicorn ran without `--proxy-headers`: `request.client.host` was the Docker gateway for **every** request, so the per-IP rate limit was one shared global bucket (one aggressive client could 429 everyone; login brute-force was a global DoS vector), GeoIP always resolved "local" and logs carried no real IP. The auth path additionally read the raw spoofable `X-Forwarded-For`. Now, as one coupled invariant: ports `8000`/`9091` are loopback-bound (cloudflared = single public entry; compose-internal SSR/scrape traffic unaffected; Postgres 5432 left LAN-exposed by explicit user decision), uvicorn runs `--proxy-headers --forwarded-allow-ips="*"` (safe ONLY because of the loopback binding — documented at both sites), and `request.client.host` is the single client-IP source everywhere (raw XFF read removed).

### Security — XSS sanitization boundary on assistant markdown (FF-XSS, ADR-093)

The chat markdown pipeline ran `rehype-raw` with **no sanitizer** — the documented react-markdown XSS anti-pattern: the LLM can relay verbatim third-party HTML (email bodies, fetched pages, MCP output) that executed with the user's session. `rehype-sanitize` is now the boundary (`rehypeRaw → rehypeSanitize → rehypeKatex`), with a schema audited against every legitimate HTML producer: cards, callouts, action buttons (`data-*`), MCP sentinels, `tel:` links, inline styles — including freeing `className` on the 7 tags `defaultSchema` constrains (a live regression caught during visual validation: card titles lost their class and rendered as blue links). `script`/`iframe`/`form`/event handlers are dropped; legacy `<style>` blocks are stripped (pre-v1.21.0 messages); MCP/Skill Apps never go through markdown (sentinel → sandboxed widget). Frontend nonce-based CSP deferred as follow-up defense-in-depth.

### Fixed — Conversations stuck after LaTeX / MCP App turns (pre-existing)

`response_node` builds its prompt via `ChatPromptTemplate.from_messages`, which re-processes system strings as f-string templates — and the base system prompt embeds the conversation history **unescaped**. Any literal brace from history (LaTeX `\frac{d}{2}`, MCP App HTML/JSON) was parsed as a template variable: `{2}` raised `ValueError` and **every follow-up turn crashed** (observed: MCP App request hanging on "Generating response...", then no reply possible). `escape_braces()` applied, consistent with the three other injected blocks; regression tests reproduce the exact failure.

### Fixed — Math rendering, end to end

- **Inline `$…$` renders without breaking currency**: MathJax's standard delimiter rules applied as a deterministic preprocessor (opening `$` not followed by whitespace; closing `$` not preceded by whitespace nor followed by a digit) — `$A = \pi r^2$`, `$r^2$` render; `1,50$ … 9$`, `$5 and $6` stay literal, both correct on the same line. Code spans/fenced blocks are skipped (no visible backslash on `echo $PATH`).
- **Every notation the model picks renders**: ` ```latex `/` ```math ` fences and `\[…\]`/`\(…\)` are normalized to remark-math delimiters (` ```python ` stays code; inline-code syntax examples stay literal).
- **Emission specified**: the response prompt's math guideline itself showed delimiters wrapped in backticks — the model imitated it, emitting formulas as inline code. Rewritten with a correct in-text example and an explicit prohibition.

### Changed — Robustness & performance riders

- **State schema migrations wired (F7)**: the migration infrastructure (written since schema 1.0, zero callers) now runs on every checkpoint load; new 1.2→1.3 step formalizes the ADR-092 replay-safe HITL keys + `user_display_name`; `STATE_AND_CHECKPOINT.md` resynced with the restored discipline (any new state key ships with a migration step and a version bump).
- **State persistence by contract (F5)**: response-node ReAct passthrough (`agent_results`) and skill sub-agent registry items are returned in the state update (reducer-equivalent, audited) instead of relying on shared-reference mutation; a dead+inoperative routing-function mutation removed.
- **Pure-ASGI middleware stack (F28)**: RequestID, SecurityHeaders, Logging and ErrorHandler no longer spawn an anyio task-group + memory streams per request nor re-wrap every SSE chunk; identical contracts and ordering (duration = TTFB for streaming, documented); PrometheusMiddleware deliberately untouched (fresh v1.21.1 label contract). Middleware tests rewritten against the real ASGI stack (36 tests), hermetic to local `HTTP_LOG_LEVEL` overrides.
- **HITL token guard language-agnostic (FF2)**: the STREAM*DONE fallback matched three hardcoded French sentences (silently inoperative in the 5 other UI languages) — now structural (`hitl*` message-id prefix).

### Notes

- **No DB schema change, no Alembic migration.** No new env vars: the loopback binding + `forwarded-allow-ips="*"` pair is a deliberately non-configurable coupled invariant (documented in compose, Dockerfile and ADR-093). New frontend dependency: `rehype-sanitize@6`.
- **Docs**: ADR-093 (+ index entries), `SECURITY.md` (threat matrix + proxy-chain/XSS section), `RATE_LIMITING.md` (per-IP keys effective), `ARCHITECTURE.md` (middleware section resynced to pure-ASGI), `STATE_AND_CHECKPOINT.md` (v1.3 chain, wired).
- **Quality**: Ruff / Black / MyPy strict clean; backend **8518 unit tests green** (+17 new), frontend **118 green** (+18 new); middleware stack verified live in the container (headers, request-id, SSE); every commit passed the full pre-commit hook.
- **Post-deploy validation (prod)**: app reachable via the tunnel; `curl <prod-host>:8000` from the LAN refused; real public IPs in logs and GeoIP dashboards.

## [1.21.1] - 2026-07-02

> Architecture decision: [ADR-092 — Replay-Safe HITL Interrupts](docs/architecture/ADR-092-Replay-Safe-HITL-Interrupts.md). Fix release: LangGraph resume semantics re-execute the entire interrupted node, and the two HITL flows that looped around `interrupt()` in-node replayed their LLM/API side effects on every user decision. Both now follow the normative one-interrupt-per-node-execution pattern; the draft-editing UX gets three fixes discovered during in-app validation. No schema change, no migration.

### Fixed — Draft EDIT loop replayed past LLM modifications (replay-safe single-pass, ADR-092)

`hitl_dispatch_node._handle_draft_critique` looped around `interrupt()` in-node: on every resume, LangGraph re-executed the whole node, and every **past** `DraftModificationService.modify()` LLM call re-ran live (temp>0, non-deterministic) — after two edits and a confirm, the email actually sent could differ from the last version the user saw and approved, at O(n²) LLM cost. The handler is now **single-pass**: one `interrupt()` per node execution; `edit`/`replan`/`clarify` run their single LLM mutation, persist the updated draft plus loop keys (`pending_draft_critique`, `draft_edit_iteration`, `draft_clarification_question` — checkpointed BEFORE the next interrupt) and self-loop via `route_from_hitl_dispatch`. Terminal decisions reset the loop state. Invariant proven by a compiled replay harness (real node + real router + `InMemorySaver` + `Command(resume=...)` sequences): **the content executed is exactly the last content shown.**

### Fixed — FOR_EACH bulk confirmation re-fetched providers and re-ran item filters (dedicated `for_each_confirm` node)

The bulk-confirmation loop lived inside `task_orchestrator_node`: each user decision re-ran the provider pre-execution (real API calls — latency, quota, preview drift) and **every past LLM item-filter call**. The orchestrator now pre-executes providers ONCE, persists the full context in `for_each_hitl_ctx` (guarded by `plan_id` + `turn_id` so a ctx from an abandoned turn never matches; purged in the final result) and routes to the new **`for_each_confirm`** node — one interrupt per execution. APPROVE resumes from the persisted context with no re-fetch; EDIT runs the item filter once and persists cumulative `filtered_indices` (always mapping back to the original pre-executed items); REJECT / all-excluded / max-iterations produce the historical cancel result. Also declares two historically dropped state keys (`for_each_cancelled`, `cancellation_reason` — LangGraph silently drops updates to undeclared keys). Same replay-harness proof.

### Fixed — Draft editing UX (found during in-app validation of the above)

- **One chat bubble per re-presented draft**: the HITL SSE `message_id` was run-scoped (`hitl_{conversation}_{run}`), so every re-presented draft re-targeted and **overwrote the previous assistant bubble** (the frontend's `STREAM_START` is idempotent by id). The id now derives from the LangGraph `Interrupt.id` — unique per interrupt, stable across re-emission of the same pending interrupt (SSE reconnect), legacy fallback preserved. Live rendering now matches the archived history.
- **"Sign with my name" works**: neither the initial email generation nor the draft modifier knew the sender's identity — the LLM left `[Votre prénom]` placeholders (silent no-op edits) or invented a name. New shared `resolve_user_display_name()` (`src/core/user_display.py`: full_name → email local part; the briefing greeting now reuses it) flows from every entry point (web router, scheduled actions, Telegram channels) through the state (`user_display_name`, refreshed each turn like timezone/language) and `configurable` into the draft-modifier and email-content-generation prompts, with explicit no-placeholder/no-invention rules. Signature policy unchanged: none unless explicitly requested.
- **Clarify question finally displayed**: a `clarify` decision generated a question that was logged then dropped (and the payload field added mid-branch was consumed by nobody — branch-review finding). The question is now persisted in state, carried on the next interrupt payload, and `DraftCritiqueInteraction` streams it verbatim instead of the generic critique question; hardcoded French fallback replaced by the existing 6-language `get_hitl_clarification_generic_message()`.

### Fixed — Reliability & observability batch

- **Cancellation propagates**: `CancelledError` is re-raised at both parallel-executor stages (tool level and post-`gather` wave level — it is a `BaseException` in Python 3.12 and escaped the `isinstance(x, Exception)` filter), so closing the stream actually cancels in-flight FOR_EACH work.
- **`on_item_error="stop"` can stop**: parallel gather cannot halt mid-batch (post-failure mutations already ran) — "stop" plans now force the sequential path (`FOR_EACH_STOP_FORCES_SEQUENTIAL`, default true).
- **HTTP metric cardinality bounded**: request labels use the matched route template (`/api/v1/journals/{entry_id}`); unrouted requests collapse into `unmatched`; the pre-routing in-progress gauge gets an id-collapsing fallback (`{id}`); duration observed on exceptions too; `update_db_pool_metrics` moved off the per-request path into the 30s background updater. ⚠️ Grafana queries filtering on raw endpoint paths must switch to templates.
- **Token-tracking run-records bounded** (`RUN_RECORDS_MAX_RUNS`, oldest-run eviction — abandoned HITL runs used to accumulate forever).
- **User-timezone displays**: place-card "today"/next-opening, contact birthday age, Gmail `after:` default date and the two voice-status timestamps now use the user's timezone; `RenderContext` defaults centralized on `DEFAULT_USER_DISPLAY_TIMEZONE`.
- **Quiet prod boot**: Telegram `set_webhook` retries on `RetryAfter` and tolerates a peer worker having already set the identical URL (multi-worker flood at every deploy); embedding token persistence skips the pseudo-user "system" (invalid-UUID traceback).

### Notes

- **No schema change, no migration.** One new env var (optional, safe default): `FOR_EACH_STOP_FORCES_SEQUENTIAL` — documented in both `.env.example` files.
- **Docs**: ADR-092 (+ index entries), `HITL.md` v8.5 (replay-safe flows), `ARCHITECTURE_LANGRAPH.md` §2.6/§2.8.
- **Quality**: Ruff / Black / MyPy strict clean (863 files); full backend suite **8501 unit tests green** (+32 new, incl. two compiled replay harnesses and 17 rewritten metrics tests); dev API boot verified healthy (graph compiled with the new node); every commit passed the full pre-commit hook.

## [1.21.0] - 2026-07-02

> Architecture decisions: [ADR-090 — Semantic Layer Governance](docs/architecture/ADR-090-Semantic-Layer-Governance.md) and [ADR-091 — Response-Context Prefetch](docs/architecture/ADR-091-Response-Context-Prefetch.md). Feature release: latency campaign (perceived + real), semantic-layer overhaul feeding smarter proactive suggestions, ReAct turn-isolation fixes. No schema change, no migration.

### Added — Semantic layer governance: ontology ∪ manifests + test-enforced integrity (ADR-090)

Semantic type consumers are now the **union** of the ontology's editorial `used_in_tools` links and the `semantic_type` annotations on ToolManifest **parameters** (the live, rename-proof source — request-scoped, so MCP/user tools are covered), via the shared `collect_manifest_param_consumers()` helper used by both the planner and the initiative. An audit had found **12 phantom tool names (~50% of `used_in_tools`)** left over from the v3.2 tool renaming — silently killing initiative bridges (e.g. contact → get_places_tool) and injecting hallucination-prone names into the planner prompt. All fixed, and **5 test-enforced integrity locks** (`test_semantic_registry_integrity.py`) make that class of drift impossible: used_in_tools ∈ real manifests (difflib hint on failure), source_domains ∈ DOMAIN_REGISTRY (singular vocabulary locked), manifest semantic_types registered, internal ontology references resolve, and every taxonomy `related_domains` link justified by ≥1 type bridge (conscious allowlist: `(file,contact)`, `(reminder,contact)`). Enrichment rule going forward: annotate manifests, not `core_types.py`.

### Added — Initiative `<SemanticBridges>`: pre-computed connection candidates

The initiative node (ADR-062) now injects the cross-domain type map plus **pre-computed connection candidates** (types PRODUCED by the executed domains × adjacent read-only tools CONSUMING them, e.g. `physical_address (from contact results) → get_places_tool, get_route_tool`) into its prompt — the LLM judges concrete user value instead of having to rediscover every bridge alone (which only frontier reasoning models did reliably). Prompt-size guards (3 tools/type, 20 lines, explicit `(+N more)`), gated by `SEMANTIC_LINKING_ENABLED`, graceful fallbacks.

### Added — Latency campaign (ADR-091): response-context prefetch + 6 sibling optimizations

- **Response-context prefetch**: the response node's user-context injections (user-message embedding, long-term memory profile, user/system RAG, journal, portrait, psyche) are extracted into `services/response_context.py` and **prefetched from the initiative node**, overlapping the ~12s initiative LLM call in BOTH pipeline and ReAct modes (bounded process-local registry keyed by run_id; identical inline fallback on any miss — conversation turns byte-identical). ~0.5–2s off every initiative-enriched turn. `RESPONSE_CONTEXT_PREFETCH_ENABLED/MAX_ENTRIES/AWAIT_TIMEOUT_SECONDS`.
- **LLM instance cache** (`LLM_INSTANCE_CACHE_ENABLED`): `get_llm()` reuses client instances keyed by the fully resolved config — httpx pools stay alive, no TCP/TLS handshake per LLM call; cleared on API-key/capabilities reloads.
- **Reasoning-stream negative cache**: buffered structured-output paths that silently paid a **second full LLM call** when the reasoning stream yielded no terminal output (observed on query_analyzer: 2 LLM calls per turn, +1.3–2.5s TTFT) are learned at runtime per (provider, model, path) — at most one double call per combination per worker; `llm_reasoning_stream_double_call_total` counter; query_analyzer permanently excluded from reasoning streaming.
- **Non-blocking contacts warmup**: the 300–800ms People API warmup no longer blocks the request path (fire-and-forget, dedicated DB session; cache-miss fallback keeps results always correct).
- **RAG query-embedding cache + single-flight**: user-RAG and system-RAG retrievals of the same turn share one Gemini embedding call.
- **Reducer token-count memoization**: the messages-truncation reducer no longer re-encodes the full history through tiktoken on every state update (per-message-id cache, content-length guarded, bounded FIFO).
- **Frontend SSE token batching**: tokens coalesced per animation frame instead of one React render + full remark/rehype re-parse per token (O(N²) → O(N)); strict ordering preserved (any non-token chunk flushes first), reset/flush wired on stream start/error.
- **Rich-HTML CSS externalized**: the LLM no longer generates a ~550-token inline `<style>` block on every rich-HTML reply (~3–4s of streaming); the `.lia-response` rules now ship once in `lia-components.css` (byte-identical rules — old messages carrying the inline block render the same).

### Fixed — ReAct: previous turn's data re-displayed (cross-turn `current_turn_registry` leak)

Asking "how do I get to my brother's?" right after "my next 4 events" re-displayed the 4 events inside the route reply — through both the synthesis text and the SSE data cards. Nothing purged the per-turn registry at the start of a ReAct turn: the checkpoint-restored value from the previous turn seeded `react_execute_tools`' intra-turn accumulation, and the response node's ReAct passthrough re-tagged every item as current-turn data (bypassing the turn filter). Fixes: `react_setup_node` now returns `current_turn_registry: {}` (mirroring the pipeline's task_orchestrator overwrite that had never been ported to ReAct), and the passthrough no longer falls back to the cross-turn `registry`. HITL draft resumes and REFERENCE turns unaffected (dedicated paths preserved).

### Fixed — ReAct: approximate memory values used instead of exact lookups

Same scenario: the route was computed to "Montpellier, France" (city centre, from a memory fact) without ever calling `get_contacts_tool` for the brother's exact address — even though semantic expansion had made the contact domain available precisely for that. The ReAct system prompt now carries a generic PRECISION rule ("memory tells you WHO, tools give exact values — retrieve the exact value with the lookup tool BEFORE the consumer tool") and a `<CrossDomainDataTypes>` section fed by the same semantic dependencies the pipeline planner receives.

### Fixed — Skill badge visible for everyone (was debug-panel-only)

The activated-skill capture lived exclusively inside the debug-panel cache path, so the skill badge on assistant messages (a user-facing feature) only ever appeared for admins with the debug panel enabled. Capture extracted to an ungated `_capture_activated_skill()` (with stale-plan guard and ReAct exclusion) plus a Route-3 fallback that detects direct `activate_skill_tool` calls in the current turn's messages.

### Fixed — Reliability & hygiene batch

- **Redis rate limiter**: module-level shared singleton (was one instance per request/client — a Lua `SCRIPT LOAD` each time) + `NOSCRIPT` retry, ending the permanent fail-open after a Redis restart flushed the script cache; connector limiters move from the session DB to the cache DB (ephemeral 60s counters).
- **Fire-and-forget GC safety**: 5 bare `asyncio.create_task` call-sites (pattern learner ×2, Telegram webhook, scheduled-action test run, channels) migrated to `safe_fire_and_forget` (strong reference + exception logging).
- **Response language fallback**: the response prompt re-reads the user language from state (a hardcoded French fallback could leak into non-French replies).
- **Timezone centralization**: 9 scattered `"Europe/Paris"` literals replaced by `DEFAULT_USER_DISPLAY_TIMEZONE`, and the dangerous local homonym `prompts.DEFAULT_TIMEZONE` (diverging from `core/constants.DEFAULT_TIMEZONE` = UTC) removed.
- **`.env` parsing crash**: inline comment with quotes in `COMPACTION_INCLUDE_PREVIOUS_SUMMARIES` broke python-dotenv at boot (fixed in `.env*` examples too).
- **FOR_EACH HITL**: `decision` variable could be unbound when `api_max_items_per_request=0`.
- **Frontend HITL log**: `fallback_used` was always true in the completion log (read after buffer deletion).
- **Pre-existing test debt**: 15 provider tests repaired (API-key fixtures via LLMConfigOverrideCache, Anthropic token-counting API, ChatDeepSeekPatched symbol, `top_p` filtering), 5 env-polluted "flaky" tests hermetized (Taskfile `dotenv:` exports), 2 schema tests now read `CURRENT_SCHEMA_VERSION`.

### Notes

- **No schema change, no migration.** New env vars (all optional, safe defaults): `LLM_INSTANCE_CACHE_ENABLED`, `RESPONSE_CONTEXT_PREFETCH_ENABLED`, `RESPONSE_CONTEXT_PREFETCH_MAX_ENTRIES`, `RESPONSE_CONTEXT_PREFETCH_AWAIT_TIMEOUT_SECONDS` — documented in both `.env.example` files.
- **Docs**: ADR-090, ADR-091 (+ index entries), ADR-062 amended, `REACT_EXECUTION_MODE.md` (turn isolation & precision guidance section, TOC completed).
- **Quality**: Ruff / Black / MyPy strict clean; full backend suite **8469 unit tests green** (+~60 new); Vitest token-batching suite; dev API boot verified healthy after every batch; semantic bridges and ReAct prompt verified live in the running container.

## [1.20.22] - 2026-06-19

> Maintenance release on top of v1.20.21. Scheduled actions no longer feed long-term memory / interests / journal / psyche (only direct user inputs do); dev-only GeoIP build fix. No schema change, no migration.

### Fixed — Scheduled actions polluted long-term memory & interests (only direct user inputs should feed them)

When a scheduled action fired, its `action_prompt` (injected as a `HumanMessage`) was extracted into long-term memory **and** interests, as if the user had typed it. `response_node` already guarded its four post-response extractions (memory, interest, journal, psyche) behind an "automated source" check — but that check read `config["metadata"]["session_id"]` and tested the `scheduled_action_` prefix, and `enrich_config_with_callbacks()` (Langfuse instrumentation) **rebuilds** `config["metadata"]` from scratch, dropping the caller's `session_id` (re-exposed only as `langfuse_session_id`). The guard therefore always read `""` and never fired: the prefix detection was effectively dead code.

The source signal is now an explicit boolean `is_automated_source` threaded through `configurable`, which survives enrichment by construction (only `metadata`/`callbacks`/`tags` are overwritten — `configurable` is preserved). `scheduled_action_executor` passes `is_automated_source=True`; every other entry point (web chat, Telegram channel, voice — all direct user inputs) defaults to `False` and is unchanged. `response_node` computes the flag once and reuses it to gate all four extractions. Decoupled from both the Langfuse metadata internals and the fragile session-id-prefix convention. Proactive notifications (heartbeat, interests) were never affected — they do not run through `response_node`.

### Fixed — Dev build: stale GeoIP database date

`apps/api/Dockerfile.dev` still hard-coded `ARG DBIP_DATE=2026-03` for the DB-IP City Lite GeoIP download (the production Dockerfile was fixed in an earlier release, but the dev one was not); db-ip.com keeps only the last ~2 months online, so the URL returned an error page that `curl -L` saved and `gunzip` then rejected ("not in gzip format"), breaking `task dev` / `task dev:detach` (both use `--build`). The dev `geoip-downloader` stage now mirrors the production logic — resolve the latest available month at build time (current, then previous) with `curl -fsSL` — still overridable via `--build-arg DBIP_DATE=YYYY-MM`. Build-only change, no runtime impact.

### Tests

- `tests/unit/infrastructure/llm/test_instrumentation.py` — `configurable` (and the `is_automated_source` flag) survives `create_instrumented_config` / `enrich_config_with_callbacks` enrichment (the contract the guard relies on).
- `tests/agents/test_response_node.py` — all four post-response extractions (memory, interest, journal, psyche) skipped when `is_automated_source=True`; memory + interest scheduled when the flag is absent (direct user). Also corrects a stale pre-existing assertion (the error fallback is an `AIMessage`, not a `HumanMessage`).
- `tests/unit/infrastructure/scheduler/test_scheduled_action_executor.py` — the executor calls `stream_chat_response(is_automated_source=True)`.

### Notes

- **No schema change, no migration, no new env var.** New centralized constant `FIELD_IS_AUTOMATED_SOURCE`; no `.env` change (the flag is a per-request context attribute, not a tunable threshold).
- **Files**: `apps/api/src/core/field_names.py`, `apps/api/src/domains/agents/api/service.py`, `apps/api/src/domains/agents/services/orchestration/service.py`, `apps/api/src/domains/agents/nodes/response_node.py`, `apps/api/src/infrastructure/scheduler/scheduled_action_executor.py`, `apps/api/Dockerfile.dev`. **Docs**: `docs/technical/LONG_TERM_MEMORY.md`, `docs/technical/INTERESTS.md`, `docs/technical/SCHEDULED_ACTIONS.md`.
- **Quality**: Ruff / Black / MyPy strict clean; 34 unit tests green across the three affected files; dev API boots clean; GeoIP dev stage build verified.
- **Dev tooling**: `.github/hooks/pre-commit` OS detection now also recognises Cygwin (in addition to MSYS2 / win32), so the backend checks resolve the Windows `.venv/Scripts` venv regardless of which Windows-hosted unix shell runs the hook.

## [1.20.21] - 2026-06-03

> Architecture decision: [ADR-089 — Multi-Worker Prometheus Metrics (multiprocess aggregation)](docs/architecture/ADR-089-Prometheus-Multiprocess-Metrics.md). Security & maintenance release on top of v1.20.20.

### Security — 43 Dependabot vulnerabilities resolved (open alerts 43 → 0)

Frontend (`apps/web`, direct deps + root `pnpm.overrides`, lockfile regenerated): **next** 16.2.3 → 16.2.7 (26 advisories incl. the App-Router middleware/proxy bypass CVE-2026-45109 and the SSRF / DoS / CSP-nonce-XSS set), **eslint-config-next** bumped in lockstep, **mermaid** `^11.14` → `^11.15` (4), **postcss** `^8.5.9` → `^8.5.10` plus a `postcss` override forcing Next's transitive copy to 8.5.15 (CVE-2026-41305), **protobufjs** override `^7.5.5` → `^7.5.8` (8 advisories + `@protobufjs/utf8` 1.1.1), and a new **uuid** override `^11.1.1` (CVE-2026-41907). The pre-existing `protobufjs: ^7.5.5` override was itself pinning into the vulnerable range and is the reason these had no Dependabot PR.

Backend (`apps/api/requirements.txt`): **langchain-core** 1.2.31 → 1.4.0 (CVE-2026-44843, unsafe `load()` deserialization — not reachable in this codebase, defence-in-depth), **python-multipart** 0.0.26 → 0.0.30 (CVE-2026-42561, multipart-header DoS — auth-gated upload endpoints), shipped as the coherent LangChain / LangGraph / OpenAI / Anthropic / FastAPI ecosystem upgrade (PR #145: langchain 1.3.2, langgraph 1.2.2 + langgraph-checkpoint 4.1.1 / -postgres 3.1.0, openai 2.40, anthropic 0.105.2, fastapi 0.136.3, …). Real exposure of all 43 was assessed LOW/NEGLIGIBLE (SCA hygiene + hardening). Validated: 8431 backend unit tests green; the LangGraph checkpoint format is backward-compatible (no migration); a real prod smoke (OpenAI / DeepSeek / Gemini turns + checkpoint resume) ran clean.

### Fixed — Vitest suite green again (pre-existing breakage on `main`)

`compaction-handler.test.ts` crashed (`Cannot read properties of undefined (reading 'current')`) because its `buildContext()` mock omitted the `reasoningBufRef` field that the live-reasoning feature (v1.20.17) made required on the generic `execution_step` path. Test-only fix (production always supplies it via `useChat.ts`); the frontend suite (82 tests) is green again.

### Fixed — Prometheus metrics under multiple workers ([ADR-089](docs/architecture/ADR-089-Prometheus-Multiprocess-Metrics.md))

Prod runs `uvicorn --workers 4`. The metrics HTTP server (port 9091) was started in every worker, so only one bound it (the other three logged `Address already in use`) and the served endpoint exposed a **single worker's** registry — real-time counters/histograms were undercounted ~4× and three warnings appeared on every deploy. Metrics are now aggregated across workers via `prometheus_client` **multiprocess mode**: `PROMETHEUS_MULTIPROC_DIR` is set by `docker-entrypoint.sh` **only when `--workers` is used** (single-worker dev with `--reload` is unchanged), RAM-backed (`/dev/shm`), and **non-fatal** (falls back to single-process if the dir can't be created); the binding worker serves a `MultiProcessCollector` aggregate; `mark_process_dead` runs on lifespan shutdown (verified on `--limit-max-requests` recycle). The **45 Gauges** each received an explicit `multiprocess_mode` (26 `mostrecent`, 14 `livesum`, 4 `livemax`, 1 `livemin`) — without which the default `'all'` would expose one series per PID and break dashboards (×N).

Five pre-existing instrumentation issues were fixed alongside, all preserving the Grafana query contracts: `mcp_server_health` `livemax` → `livemin` (surfaces partial outages instead of hiding them), `lifetime_metrics_error_total` `Gauge` → real `Counter`, `channel_active_bindings` now refreshed from the DB by the lifetime-metrics updater (removing per-worker startup priming + `inc`/`dec`), `registry_size` → `mostrecent`, `circuit_breaker_*` → `livemax`.

### Notes

- **No schema change, no migration.** New env var: `PROMETHEUS_MULTIPROC_DIR` (auto-set by the entrypoint with `--workers`; RAM `/dev/shm`, overridable).
- **Docs**: [ADR-089](docs/architecture/ADR-089-Prometheus-Multiprocess-Metrics.md), `docs/technical/METRICS_REFERENCE.md`, `docs/readme/README_OBSERVABILITY.md`, `docs/guides/GUIDE_DEPLOYMENT.md`.
- **Tests / quality**: Ruff / Black / MyPy strict clean; multiprocess mechanism + end-to-end 2-worker app validated (0 `pid`-labelled series across 1874; `/dev/shm` footprint ~824 KB).

## [1.20.20] - 2026-06-02

> Architecture decision: [ADR-070 — ReAct Execution Mode](docs/architecture/ADR-070-ReAct-Execution-Mode.md), amendment 2026-06-02.

### Fixed — User MCP tools were unusable in ReAct mode (resolution asymmetry with the pipeline)

ReAct built its tool palette from the per-request manifests (`get_request_tool_manifests()`, correct) but resolved tool **instances** only through the process-global `tool_registry` (`get_tool`). **User** MCP tools are per-user and dynamic, so they are deliberately kept out of the global registry and held in the `user_mcp_tools_ctx` ContextVar — the pipeline executor already resolved them via a ContextVar fallback, but ReAct did not. Result: user MCP tools were silently dropped at selection (`react_tool_selector_skipped`, reason `manifest_without_registered_tool`) and the loop fell back to a generic web search, so user-configured MCP servers were effectively unusable in ReAct. Admin MCP tools (in the global registry) were unaffected.

A new shared resolver `src/domains/agents/tools/tool_resolution.py` is now the single source of truth — `resolve_tool_instance[_named]` / `resolve_tool_manifest[_named]`: global registry → LLM-hallucinated-suffix strip → user MCP ContextVar (exact then fuzzy), the `_named` variants returning the canonical name so callers that mutate `step.tool_name` stay in sync. It is consumed by ReAct (`ReactToolSelector`, `_rebuild_wrapped_tools`), the pipeline executor (`_get_tool_manifest_for_step`, `_execute_tool_step`, `_execute_tool` — three near-duplicate inline fallbacks unified) and display-metadata lookup (removing spurious `ToolManifestNotFound` warnings on user MCP tools). **HITL parity**: `ReactToolSelector` reads `hitl_required` from the in-hand manifest (the `agent_registry` does not know user MCP tools), so user MCP mutation tools keep their approval gate in ReAct.

### Added — Iterative user MCP servers expand to their individual tools in ReAct (`REACT_MCP_EXPAND_ITERATIVE_ENABLED`)

An iterative-mode user MCP server exposes a single opaque `mcp_user_{id}_task` manifest (designed for the single-shot planner, which delegates to a ReAct sub-agent — ADR-062). The ReAct loop **is itself iterative**, so that indirection only hid the descriptive individual tools and the LLM did not recognise the task tool, falling back to web search. `ReactToolSelector._expand_iterative_user_mcp` now replaces the task manifest with the server's individual tools (read from the ContextVar) so the model picks them by description — **except MCP App servers** (a tool with `app_resource_uri`, e.g. Excalidraw), which keep the task tool to retain their dedicated MCP-app prompt and the more capable `mcp_app_react_agent` model. Gated by the new `REACT_MCP_EXPAND_ITERATIVE_ENABLED` (default `True` = validated behaviour; `False` falls back to the task tool — instant rollback without redeploy). The pipeline keeps the task-tool → ReAct-sub-agent path unchanged.

### Fixed — MCP tools with unset optional parameters rejected by strictly-typed servers

Optional MCP parameters left unset are materialised as `None` by the Pydantic args schema (`Field(default=None)`) and were forwarded verbatim, making strictly-typed (e.g. Go-based) MCP servers reject the call (`parameter sort is not of type string, is <nil>` — observed on GitHub `search_repositories`). Both adapters (`UserMCPToolAdapter`, `MCPToolAdapter`) now drop `None`-valued arguments (`drop_none_values`) before the server call, per the MCP/JSON-RPC convention that an unset optional is omitted, not sent as null. Falsy-but-valid values (`False`, `0`, `""`) are preserved; non-recursive.

### Notes

- **No schema change, no migration, no new endpoint.** New env var: `REACT_MCP_EXPAND_ITERATIVE_ENABLED` (default `true`).
- **Files**: `apps/api/src/domains/agents/tools/tool_resolution.py` (new), `apps/api/src/domains/agents/services/react_tool_selector.py`, `apps/api/src/domains/agents/nodes/react_nodes.py`, `apps/api/src/domains/agents/orchestration/parallel_executor.py`, `apps/api/src/domains/agents/utils/execution_metadata.py`, `apps/api/src/infrastructure/mcp/{utils,tool_adapter,user_tool_adapter}.py`, `apps/api/src/core/{constants,config/agents}.py`, `.env.example`, `.env.prod.example`. **Docs**: [ADR-070](docs/architecture/ADR-070-ReAct-Execution-Mode.md) (amendment), `docs/technical/REACT_EXECUTION_MODE.md`, `docs/knowledge/11_mcp_servers.md`. **Tests**: `test_tool_resolution.py`, `test_react_tool_selector.py`, `test_react_nodes_tool_resolution.py`, `test_get_tool_manifest_for_step.py`, `test_mcp_arg_sanitization.py` (TDD, red→green); Ruff / Black / MyPy strict clean, 1186+ unit tests green.

## [1.20.19] - 2026-06-02

### Changed — Personal journal write discipline: restraint-first, grounded, no more over-generalisation or capability hallucinations

After the stratified-journal refactor (ADR-079), real usage surfaced a quality regression: the assistant produced journal entries that were frequently useless or actively harmful, with no clear user signal. Two reproducible failure modes — (1) **surface over-generalisation** (a single short user message produced a standing directive like "WHEN the user writes briefly → DO answer briefly without detail", which then stripped detail from every later answer — message length is not a request for less content), and (2) **capability hallucination** (after a tool returned empty, the assistant wrote a directive asserting it lacked access to the user's data, which then made it refuse to even try later). Root cause: a **systemic production bias** in both write prompts (the extraction prompt's "L0 sweep" / "0-`learnings` is a red flag" / distribution targets, and the consolidation prompt's _mandatory_ L2 synthesis), with no grounding or validity bar, amplified along a path where one weak inference becomes a forced L2 synthesis that feeds a portrait facet diffused to every channel.

The **extraction prompt** (`journal_introspection_prompt.txt`) is rewritten restraint-first (~311 → ~150 lines): default output is `[]`; an L1 directive now requires BOTH being **grounded in an explicit user signal you could quote** AND being **safe to obey blindly**; generic **hard prohibitions** name the error classes (never assert a limit on your own capabilities/access/tools — the toolset evolves and an empty result means "not found this time"; never generalise from a single surface feature; never project a third party's trait onto the user); **L0 becomes a capped release valve** (≤1/turn, default zero, private). A maintenance carve-out keeps pruning / confidence-demotion / `evidence_outcome` signalling welcome (the "write nothing" default governs creation only). The **consolidation prompt** is de-pressured (STEP 5 makes L2 synthesis conditional on genuine convergence — "zero L2 is the correct outcome when no convergence exists"; dedup gains a guard "never merge directives that prescribe different actions"; L0→L1 promotion requires recurrence). The **analyst persona** drops the thematic-diversity production nudge and hardens the quality gate.

### Added — Level-routed operational injection: only L1/L2 directives steer behaviour

The journal levels now have a distinct operational meaning. The operational injection chokepoint `build_journal_context` (response, planner, heartbeat, ReAct) carries **only L1/L2 behavioural directives** — `L0` (private raw feedstock managed by consolidation) and `L3` (already carried by the compiled portrait) are excluded by default via the new `JOURNAL_OPERATIONAL_INJECTION_EXCLUDE_LEVELS = ["L0", "L3"]`. `JournalEntryRepository.search_by_relevance` / `get_recent_for_user` gain an optional `exclude_levels` parameter whose **default `None` preserves the all-levels view** — extraction and consolidation call the repository directly and still see every level. The heartbeat's direct journal search (`context_aggregator.py`) now applies the same exclusion. This kills the read-path bug where an ambiguous L0 raw observation could masquerade as a directive, and stops the double-injection of L3 facets.

### Added — ReAct directive coherence + `JOURNAL_REACT_CONTEXT_MAX_ENTRIES`

The ReAct reasoning loop previously received only the L3 portrait brief, never the per-turn L1/L2 directives (which reached only the final response). A procedural directive ("verify Y before acting") therefore guided the pipeline planner but not the ReAct tool-calling reasoning. `react_setup_node` now injects, **once at setup**, a bounded set of L1/L2 directives — capped by **count, not characters** (`JOURNAL_REACT_CONTEXT_MAX_ENTRIES`, default 3; new `.env` setting, 0 disables), injected in full so a directive is never cut mid-sentence. Deferred self-evaluation stays anchored to `response_node`.

### Notes

- **No schema change, no migration** — the `level` column from ADR-079 is reused; the change is purely how levels are written and read. Validated in dev: sober output (3/4 conversations write nothing; the one entry was an L1 grounded in a quoted user statement).
- **Files**: `apps/api/src/domains/agents/prompts/v1/{journal_introspection_prompt,journal_consolidation_prompt,journal_analyst_persona}.txt`, `apps/api/src/domains/journals/{constants,repository,context_builder}.py`, `apps/api/src/domains/agents/nodes/react_nodes.py`, `apps/api/src/domains/heartbeat/context_aggregator.py`, `apps/api/src/core/{constants,config/journals}.py`, `.env.example`, `.env.prod.example`. **Docs**: [ADR-088](docs/architecture/ADR-088-Journal-Restraint-And-Level-Routed-Injection.md) (amends ADR-079), `docs/technical/JOURNALS.md`. **Tests**: `test_injection_level_routing.py` (default exclusion, explicit override, full-injection no truncation) + adjusted `test_analyst_persona.py`; Ruff / Black / MyPy strict clean, 223 journal+heartbeat unit tests green.

## [1.20.18] - 2026-06-02

### Fixed — HTML enriched display mode no longer drifts back to Markdown over multi-turn conversations

In the **HTML enriched** display mode, the first replies rendered correctly as rich HTML (`<div class="lia-response">`), but as the conversation grew the model drifted back to Markdown — in both execution modes (pipeline and ReAct) — without the user changing any setting. Root cause: `filter_for_llm_context` (which builds the response LLM's conversational history) treated prior assistant turns **asymmetrically** — previous HTML answers were erased to a `[Résultats affichés]` placeholder while Markdown answers were kept verbatim. Over multiple turns the visible history looked uniformly plain/Markdown, so the model inferred "Markdown = the norm" and overrode the HTML directive (a one-way ratchet: a single Markdown turn entering the context biased every following turn).

Fixed by **symmetric style neutralization** scoped to the HTML mode only: a new `neutralize_formatting` parameter (default `False`) on `filter_for_llm_context` rewrites every retained assistant answer to style-free text (Markdown **and** HTML stripped, content preserved), tagged with an explicit `[réponse précédente, mise en forme omise]` marker. The neutralization is **structural** — the Markdown is physically removed, so no style precedent survives regardless of how the model reads the marker. The response node enables the flag only when `user_display_mode == html`; the current turn's content to render is untouched. Default `False` → the `cards`/`markdown` modes, the planner path and all existing callers are byte-for-byte unchanged (zero regression); no effect on turn 1 (no history to neutralize).

Conservative stripping leaves content intact (`2*3`, `user_id`, dates, ordered-list numbers preserved). Files: `apps/api/src/core/constants.py` (`CONTEXT_PRIOR_ANSWER_UNFORMATTED_MARKER`, `CONTEXT_RESULTS_DISPLAYED_PLACEHOLDER`), `apps/api/src/domains/agents/utils/message_filters.py` (`_strip_markdown_syntax`, `_neutralize_assistant_formatting`), `apps/api/src/domains/agents/nodes/response_node.py`, `docs/technical/RESPONSE.md` (_Display Modes & History Style Neutralization_ section). **Tests**: `TestFilterForLlmContextNeutralizeFormatting` (neutralization, idempotence, HTML→prose, default unchanged, in-word punctuation preserved).

### Fixed — Token/cost double-counting of the proactive "initiative" LLM call

A proactive (`initiative`) LLM call appeared **twice** in the Debug Panel — one `INITIATIVE` row and one `UNKNOWN` row, identical tokens/cost/model — and the duplicate inflated not only the display but the per-message total (`MessageTokenSummary`), `token_usage_logs` (2 rows) and `user_statistics`. Diagnosed empirically (not assumed): the same LLM `run_id` fired `on_llm_end` twice with `parent_run_id=null` (the run was re-rooted), while every other node fired once with a real parent. Root cause (reproduced in a real LangGraph graph): on the reasoning-streaming path (`get_structured_output(reasoning_emit=…)` → `stream_reasoning_events`/`astream_events` over a tool-bound model), `enrich_config_with_node_metadata` flattens `config["callbacks"]` into a plain list, severing the inherited `CallbackManager` identity; combined with the `RunnableBinding` and Pregel's contextvar propagation, the run re-roots and the handler attaches via two lineages → `on_llm_end` ×2 (the 2nd, having lost the call context, attributed a phantom `node_name="unknown"`).

Fixed in two complementary layers: **(B) at the source** — a new `enrich_config_preserving_callbacks` enriches while preserving the `CallbackManager` (copy → swap the `MetricsCallbackHandler` → keep `parent_run_id` + inherited handlers), wired only on the reasoning path of `get_structured_output` (`if reasoning_emit is not None`) → a single firing, run not re-rooted, Prometheus + `node_name` attribution preserved (also stops the potential Langfuse duplicate on that path); **(A) defense-in-depth** — a **symmetric idempotency guard** records each LLM `run_id` once, on both `TokenTrackingCallback` (PostgreSQL/billing) and `MetricsCallbackHandler` (Prometheus), with an atomic check-and-mark (parallel-safe). The global `enrich_config_with_node_metadata` and the `ainvoke` path are unchanged (scope limited to the reasoning path).

Files: `apps/api/src/infrastructure/llm/invoke_helpers.py` (`enrich_config_preserving_callbacks`, shared `_ensure_node_metadata` helper), `apps/api/src/infrastructure/llm/structured_output.py` (reasoning → preserving / else → standard routing), `apps/api/src/infrastructure/observability/callbacks.py` (idempotency guards + provenance debug logs), `docs/technical/TOKEN_TRACKING_AND_COUNTING.md` (_Invariant: one `run_id` = one record_ section). **Tests**: `test_callbacks_token_dedup.py` (duplicate `on_llm_end` → 1 record/emit; distinct run_ids → 2), `test_reasoning_stream_binding_dup_repro.py` (flat-list double / preserving-fix / react-control, in a real Pregel graph), `test_structured_output_reasoning_enrich.py` (reasoning↔standard routing). Ruff / Black / MyPy strict clean. No DB migration, no new env var, no endpoint change.

## [1.20.17] - 2026-05-31

> Architecture decision: [ADR-087 — Native ChatOpenAI + Config-Driven Per-Provider Reasoning Strategy](docs/architecture/ADR-087-Native-ChatOpenAI-And-Per-Provider-Reasoning.md).

### Added — Live reasoning streaming, made config-driven across providers

Agents' chain-of-thought now streams to the progress UI for the providers and call paths where the API actually supports it: OpenAI (Responses API reasoning summary), DeepSeek (native `reasoning_content`), the ReAct loop, and structured-output nodes via an **auto-tool path** (`tool_choice="auto"` instead of a forced tool — a forced tool suppresses the summary on OpenAI and is rejected outright on Anthropic). Reasoning is now enabled **solely** by the per-model config built in the factory (`reasoning_builders`); `reasoning_stream` no longer injects any `thinking`/`include_thoughts`, so a "reasoning" block appears only for agents the admin actually enabled it on (no forced display).

### Added — Anthropic per-model extended-thinking configuration in "Configuration LLM"

Verified against Anthropic docs (2026-05): `claude-opus-4-6` / `claude-sonnet-4-6` use **adaptive** thinking (`reasoning_widget='enum'` with an `off` sentinel → `thinking={type:adaptive}` + effort); `claude-opus-4-5` / `claude-haiku-4-5` use **manual** thinking (`reasoning_widget='toggle_budget'`, budget 1024–16384 → `thinking={type:enabled,budget_tokens}`). The admin UI locks temperature/top_p when reasoning is enabled (Anthropic forbids custom sampling with thinking); the service forces them to `None` and the factory omits them at call time (defense in depth). `claude-haiku-4-5` becomes a reasoning model. A separate global `effort` control (Anthropic `output_config.effort`) is exposed for `claude-opus-4-5` only — orthogonal to `reasoning_effort` — validated against the model's `effort_values` (422 on an unsupported value). Migrations `anthropic_thinking_config_001` + `anthropic_global_effort_001` align existing databases; the seed carries the same values for fresh installs.

### Changed — OpenAI provider: native `ChatOpenAI` replaces the custom `ResponsesLLM`

Removed the ~1800-line custom `ResponsesLLM` in favor of native `ChatOpenAI(use_responses_api=True, output_version="responses/v1")`. `langchain-openai` ≥ 1.1 natively provides Responses-API caching, multi-turn, tool calls, structured output, reasoning-summary streaming and standard `usage_metadata`. The only remaining custom code is `ChatOpenAICached` (a ~1-method subclass) preserving LIA's static-prefix `prompt_cache_key` routing. Obsolete `ResponsesLLM` unit tests removed; native-adapter tests added.

### Fixed — Anthropic structured-output nodes no longer 400 when extended thinking is enabled

`with_structured_output` forces a `tool_choice`, which Anthropic rejects with _"Thinking may not be enabled when tool_choice forces tool use"_ — this broke `query_analyzer` (and any structured node) on a thinking-enabled Claude, degrading the whole turn. Structured output on such models now routes through the auto-tool path (the only API-supported combination); when the model declines the tool there is no forced-tool fallback (it would 400), so a clear `StructuredOutputError` is raised instead.

## [1.20.16] - 2026-05-30

### Fixed — Voice/TTS no longer reads HTML/Markdown formatting aloud in conversation mode

When text-to-speech is enabled and the user's response display mode is **HTML** (rich display), conversational turns were rendered as full HTML — wrapped in `<div class="lia-response">` with an inline `<style>` CSS block (per `html_response_directive`) — and that markup was streamed verbatim to the TTS engine via the progressive chat path, so the voice spoke tags and CSS aloud. The asymmetry the user reported (fine on tool/action turns, broken in pure conversation) is architectural: action turns voice a **separate clean commentary** via the Voice Comment LLM (built from the data registry), whereas conversational turns read the displayed reply directly.

Root cause fixed at the source: the rich-HTML directive is now injected **only for tool/data turns** — gated on the router's `route_to == "planner"`, which is the exact signal `RouterOutput.intention` is derived from (`"action" if route_to == "planner" else "conversation"`), so the display gate can never desync from the voice path's progressive-TTS trigger. Conversational turns (`route_to != "planner"`, incl. `REFERENCE_PURE`) stay plain Markdown, which the frontend renders identically (`ReactMarkdown` + `rehypeRaw`) in every display mode — so there is **no** display regression and **no** voice-pipeline change (the progressive low-latency TTS of ADR-082 is preserved). The `route_to` lookup reuses the canonical `get_qi_attr(state, "route_to", None)` helper (object- and dict-form safe), replacing two inline `isinstance`/`getattr` extractions.

### Added — Defense-in-depth: HTML never reaches the TTS engine on any path

The synchronous TTS entry points (`stream_direct_tts` and the `stream_voice_comment` context fallbacks) now route their text through `_sanitize_text_for_tts`, which strips HTML to speakable text via the existing `html_to_text` helper — but **only when real markup is detected** (recognised HTML element tags). Plain prose containing bare angle brackets (`x < 5 and y > 3`) or Markdown symbols is left untouched, avoiding the trap where `html_to_text`'s tag-stripping regex would otherwise delete `"< 5 and y >"`. This covers reference turns and post-LLM data-card injection, and guards against any future regression.

Files: `apps/api/src/domains/agents/nodes/response_node.py` (`_should_inject_html_directive`, `get_qi_attr`-based `route_to`), `apps/api/src/domains/agents/api/service.py` (`_looks_like_html`, `_sanitize_text_for_tts`, `_sanitize_and_truncate_for_tts`), `docs/technical/VOICE.md` (new _Plain-text input guarantee_ section). **Tests**: `tests/unit/domains/agents/nodes/test_response_node_html_gating.py` (directive gating per display-mode × route) and `tests/unit/agents/api/test_tts_text_sanitization.py` (HTML stripped; angle-bracket prose & Markdown preserved) — 20/20 green. Ruff / Black / MyPy clean; full app Docker startup verified healthy. No DB migration, no new env var, no endpoint change.

## [1.20.15] - 2026-05-29

### Fixed — Grafana dashboards: dozens of panels stuck on "No data" now resolve against the real production metrics

A panel-by-panel audit of every dashboard query against the **production** Prometheus (not the dev instance the 2026-04 audit used, where empty panels were merely un-exercised) surfaced a set of panels that could never render — independent of traffic — because their PromQL/LogQL referenced metric names, labels, or label values that do not exist in production. Fixes by dashboard:

- **05 — LLM Tokens & Cost**: the _API Errors / Rate Limit / Context Length / Content Filter_ panels queried `llm_api_calls_total{status="rate_limited"|"context_exceeded"|"content_filtered"}` (statuses that metric never carries) and grouped `by (provider)`/`error_type` (labels it does not have). Repointed to the dedicated, already-instrumented error metrics `llm_api_errors_total{provider,error_type}`, `llm_rate_limit_hit_total{provider,limit_type}`, `llm_context_length_exceeded_total{provider,model}`, `llm_content_filter_violations_total{provider}`.
- **06 — Logs & Traces**: the Loki _Router Decisions_ panel filtered `event="router_decision"` (no such event) → `event=~"router_(high|medium)_confidence|router_very_low_confidence_fallback"` (the events that actually carry `intention`+`confidence`); _Graph Exceptions_ filtered `event=~"graph_exception.*"` → `event="response_node_exception"` (the only site where `graph_exceptions_total` is incremented); _LLM Errors_ repointed to `llm_api_errors_total`.
- **18 — RAG Spaces**: embedding panels filtered `model=~"text-embedding-3.*"` (OpenAI) and `currency="usd"` while production emits `model="gemini-embedding-001"` and `currency="USD"` → removed the stale model filter, corrected the currency case.
- **09 — Conversations**: _Conversation Turns by Agent_ queried the `conversation_turns_total` **Histogram** as a Counter → fixed to the average `rate(_sum)/rate(_count)`.
- **08 — HITL**: _Resumption Total by Type_ grouped `by (interrupt_type)` (not a label of `hitl_resumption_total`) → `by (strategy)`.
- **14 — Registry & Checkpoints**: _Edit Iterations per Draft P95_ applied `histogram_quantile` to `registry_draft_edit_iterations_total_bucket` (a Counter, no buckets) → `rate(registry_draft_edit_iterations_total)`; removed the dead _Total Checkpoints_ panel.
- **16 — Recording Rules & Alerts Health**: the three `ALERTS{…}` panels referenced a series that does not exist while Prometheus alerting is disabled → repointed to live recording-rule health (`prometheus_rule_group_rules`, `prometheus_rule_evaluation_failures_total`, `prometheus_rule_group_last_duration_seconds`), then the now-redundant row was dropped (the dashboard already has a _Recording Rules Health_ section); _Semantic Validation Issues_ grouped `by (field, error_type)` → `by (issue_type)`.

### Added — Sub-agent execution metrics are now emitted ("Sub-agents & Skills" dashboard comes alive)

`metrics_subagent.py` was **defined but never imported and never incremented** (zero call sites), so the entire _Sub-agents & Skills_ dashboard was permanently dark. `ReactSubAgentRunner` — the single sub-agent execution path (ADR-083), shared by sub-agent delegation, browser, MCP and skill runners — now emits, defensively (a metric failure can never break the run): `subagent_spawned_total{agent_name,mode}`, `subagent_active_count`, `subagent_duration_seconds{agent_name}`, `subagent_tokens_in_total`/`subagent_tokens_out_total{agent_name}` (summed from each message's `usage_metadata`), and `subagent_errors_total{agent_name,error_type}`, labelled by the runner's `llm_type`.

### Fixed — Sub-agent active-count gauge no longer leaks

The run body is now wrapped in `try/finally` so `subagent_active_count` is **always** decremented after the spawn increment — including when setup (`get_llm` / `load_prompt` / `create_react_agent`) raises and the exception propagates to the caller. Without the `finally`, a setup failure would have leaked the gauge upward indefinitely. Guarded by a dedicated regression test.

### Removed — Deprecated and dead metric definitions (and their dashboard panels)

Nine never-emitted metric definitions (no call site, flagged for removal by the prior audit) were deleted together with the panels referencing them: `checkpoints_total` (per-`thread_id` cardinality risk), `cache_operation_duration_seconds` (redundant), `redis_connection_pool_size` (superseded by the `_current` gauges), the placeholder gauges `agent_routing_accuracy` / `agent_error_rate` / `agent_latency_p95_seconds` (no periodic calculator ever wired), and the sub-agent guard-rail metrics `subagent_token_budget_exceeded_total` / `subagent_killed_total` / `subagent_daily_tokens_consumed` (their mechanisms were removed in ADR-083 Phase 2; `subagent_daily_tokens_consumed` also carried a per-`user_id` PII/cardinality label).

Files: `apps/api/src/domains/agents/tools/react_runner.py`, `apps/api/src/infrastructure/observability/{metrics_subagent,metrics,metrics_business,metrics_registry,lifetime_metrics}.py`, `infrastructure/observability/grafana/dashboards/{05-llm-tokens-cost,06-logs-traces,08-hitl,09-conversations-users,14-registry-checkpoints,16-meta-health,18-rag-spaces,19-subagents-skills}.json`, `docs/technical/OBSERVABILITY_AGENTS.md`. **Tests**: `apps/api/tests/unit/domains/agents/tools/test_react_runner.py` — sub-agent spawn + active-count balance on success, on ainvoke error, and on setup-failure propagation. Ruff / Black / MyPy clean; 334 observability + runner unit tests green; every changed query validated against the production Prometheus/Loki. The LLM-error-taxonomy metrics (`llm_api_errors_total` et al.) were already instrumented in `callbacks.py::on_llm_error`. No DB migration, no new env var, no endpoint change.

## [1.20.14] - 2026-05-29

### Fixed — Voice mode now routes long-answer turns through the Voice Comment LLM again (not the displayed text)

When voice mode is on, the assistant is supposed to produce a **short, separate voice commentary** via the dedicated `voice_comment` LLM whenever the turn used tools — the displayed answer (which may be long, structured, contain widgets/cards/HTML) is read aloud verbatim _only_ in pure chitchat ("conversation" intent). The `chat_voice_streamer` introduced in v1.20.2 for chat-mode sentence streaming was being **started prematurely on a stale router decision**: at turn start, LangGraph "values" mode replays the checkpoint state, so `routing_history[-1]` carries the **previous** turn's `RouterOutput`. If that prior turn was `intention="conversation"`, the first `router_decision` SSE of the new turn surfaced the stale `"conversation"` label at ~300 ms, kicking off direct-TTS-of-displayed-text. By the time the new router actually concluded `intention="action"` and the registry filled with tool results, an existing guard (`chat_voice_drain_task is None`) blocked the Voice Comment LLM from taking over — so the voice kept reading the on-screen text instead of a commentary. Reproduced from prod traces.

### Changed — Symmetric stale-checkpoint guard on `routing_history`

`StreamingService` now captures a stable signature of `routing_history` (`length + last entry's intention/confidence/next_node/context_label`) on the **first** values chunk and suppresses every `router_decision` SSE emission as long as the signature still matches that baseline — i.e. until the current-turn router has appended a fresh `RouterOutput`. This is the exact pattern that already guarded `agent_results` (`_checkpoint_agent_results_ids` → `agent_results_changed` → `_capture_voice_context_registry`); the only asymmetry was that `routing_history` had no equivalent guard, which the fix corrects. No downstream consumer needs to know about the suppression — they see the correct fresh decision instead of the stale one.

Files: `apps/api/src/domains/agents/services/streaming/service.py`. Tests: `apps/api/tests/services/test_streaming_service.py` — adapted the two pre-existing router-decision tests to seed an empty-routing-history baseline first, plus a new regression test (`test_process_values_chunk_suppresses_stale_routing_from_checkpoint`) that reproduces the prod scenario (previous turn `intention=conversation` → current turn `intention=action`, only the fresh decision is emitted). 31/31 passing. No DB migration, no new env var.

### Added — Scroll-up pagination on conversation history (very long conversations stay reachable)

`GET /conversations/me/messages` previously returned the **50 newest messages, period** — no pagination, no scroll-back, no cursor. For conversations at the multi-million-token scale, the **start of the discussion was unreachable from the UI** even though every row was preserved in `conversation_messages` (the v2 compaction is checkpoint-only — never deletes messages). Endpoint now accepts `?before=<ISO datetime>` and replies with `has_more: bool` and `next_cursor: datetime | null`. Internally the service asks the repository for `limit + 1` rows so `has_more` is derived without a `COUNT(*)`. The existing composite index `ix_conversation_messages_conv_created (conversation_id, created_at DESC)` makes it an index-only seek per page regardless of conversation length — no migration needed.

UI: `ChatMessageList` renders a 1-px sentinel above the first message and binds an `IntersectionObserver` on the scroll container (`rootMargin: 200px 0 0 0`). When the sentinel enters view, the parent calls `loadOlderMessages(cursor)`; the older rows are **deduplicated by id** and prepended; a shared `wasPrependRef` flag tells the existing auto-scroll-to-bottom `useEffect` to **skip itself** for that cycle, and a `useLayoutEffect` offsets `scrollTop` by the new content height — so the viewport stays anchored exactly where the user was reading, with zero visible jump. Mutex ref + state guard prevents overlapping requests on fast scroll. The sentinel is suppressed while the client-side search filter is active (otherwise "no match in the loaded page" would conflate with "no match in remote history").

### Changed — Pagination bounds are env-configurable, not hardcoded

`Query(50, ge=1, le=200, …)` replaced by `Query(settings.conversation_history_default_limit, ge=1, le=settings.conversation_history_max_limit, …)`. The two settings live on `AdvancedSettings` (`src/core/config/advanced.py`) and read their defaults from `CONVERSATION_HISTORY_DEFAULT_LIMIT_DEFAULT` / `CONVERSATION_HISTORY_MAX_LIMIT_DEFAULT` in `constants.py`. `.env.example` and `.env.prod.example` document both: a deployer raising the default page size or the cap no longer needs a rebuild.

Files: `apps/api/src/core/{constants,config/advanced}.py`, `apps/api/src/domains/conversations/{repository,service,router,schemas}.py`, `apps/web/src/hooks/useConversation.ts`, `apps/web/src/components/chat/ChatMessageList.tsx`, `apps/web/src/app/[lng]/dashboard/chat/page.tsx`, the 6 locale files (new `chat.loading_older_messages`), `.env.example`, `.env.prod.example`. **Tests** — backend: `tests/unit/domains/conversations/test_messages_pagination.py` (4 router unit + 3 repo integration, includes `before+search` AND-composition); frontend: `tests/__tests__/useConversation.pagination.test.ts` (page order, before-forwarding, mutex, first-page-omits-before). Ruff / Black / MyPy clean; ESLint / `tsc --noEmit` / 82 vitest green; full conversations unit suite 35/35; i18n parity verified across the 6 locales. Docs: `docs/technical/CONVERSATION_HISTORY_PAGINATION.md` (new).

## [1.20.13] - 2026-05-22

### Fixed — Responses no longer fail or degrade with Gemini 3.x models

Gemini 3.x (e.g. `gemini-3.5-flash`, `gemini-3-pro-preview`) returns `AIMessage`/`AIMessageChunk.content` as a **list of content blocks** (`[{"type": "text", "text": "...", "index": 0}]`) instead of a plain string like earlier Gemini and every other provider. Several code paths assumed `str` and broke under Gemini 3.x:

- **SSE token streaming** aborted with a `ChatStreamChunk` `ValidationError`, surfacing to the user as _"Un problème est survenu lors de la génération de la réponse. Veuillez réessayer."_ — in **both** Pipeline and ReAct modes (they share the response-node token stream).
- **ReAct mode** additionally crashed in `format_conversation_history` (`'list' object has no attribute 'strip'`) whenever the conversation history contained Gemini-produced list-content messages. This is **independent of the response model**: a mixed-provider setup (Gemini driving the ReAct loop, another model synthesizing the response) was equally affected.
- Silent degradations elsewhere: skipped psyche-tag / registry-filtering / HTML-widget post-processing, garbled voice (TTS) output, distorted token counts, dropped tokens after a HITL resumption, email-draft generation, and the `structured_output` JSON-mode fallback.

### Changed — Canonical content-normalization primitive (DRY)

Introduced `coerce_content_to_text()` (`src/infrastructure/llm/message_text.py`): a single, defensive primitive that normalizes any message `.content` shape (`str`, Gemini 3.x `list[dict]` blocks, `None`, or anything else) to plain text, mirroring LangChain Core 1.2+ `BaseMessage.text` semantics (concatenate `text` blocks, ignore reasoning/thought-signature). Applied at the **shared chokepoints** — the SSE token formatter (`format_token_chunk`), `format_conversation_history` / `get_conversation_summary_for_logging`, and the `structured_output` JSON-mode fallback — so all their callers are protected, plus the remaining direct consumers. Four pre-existing bespoke `list → text` implementations (`react_finalize`, `react_runner`, `_extract_reasoning_detail`, the translation service) were consolidated onto it. **Non-destructive**: the source-of-truth messages stored in graph state are never mutated — normalization happens at the consumption boundary where a `str` is contractually required.

Files: `apps/api/src/infrastructure/llm/message_text.py` (new), `apps/api/src/infrastructure/llm/structured_output.py`, `apps/api/src/domains/agents/{services/streaming/service,nodes/response_node,nodes/react_nodes,nodes/router_node_v3,nodes/semantic_validator_node,nodes/planner_node_v3,services/fallback_response,services/query_analyzer_service,services/analysis/goal_inferrer,services/hitl/interactions/draft_critique,services/hitl/resumption_strategies,tools/emails_tools,tools/react_runner,utils/conversation_context,utils/message_filters,utils/token_utils}.py`, `apps/api/src/domains/{voice/service,briefing/llm,personalities/translation_service}.py`, `apps/api/src/infrastructure/scheduler/reminder_notification.py`. **Tests**: `tests/unit/infrastructure/llm/test_message_text.py` + regression tests reproducing both crashes (`test_streaming_service.py`, `test_conversation_context.py`); Ruff / Black / MyPy clean; 4447 unit tests green. **Docs**: `docs/technical/LLM_PROVIDER_CONSTRAINTS.md` (Gemini 3.x response content shape). No DB migration, no new env var, no endpoint change.

## [1.20.12] - 2026-05-21

### Added — Dormant interests are visible and manageable again (no more silent loss of control)

An interest decays over time (Bayesian weight × temporal decay); the nightly `cleanup_interests` job flips it to `status = "dormant"` once its effective weight stays below `0.5` for `interest_dormant_threshold_days` (15 days in prod), then deletes it after 90 days. `GET /interests` already returned dormant interests, but the Settings UI rendered only the `active` (grouped by category) and `blocked` buckets — `dormant` was filtered nowhere, so dormant interests were **invisible and uncontrollable** from the UI (yet still counted in the total) and were silently deleted at 90 days.

Dormant interests now render in a dedicated, visually-distinct "Dormant" accordion section (muted, moon badge — not struck-through like blocked ones) with full Edit / Delete control and an explicit **Reactivate** action. Reactivation resets the interest to a fresh state (`positive_signals = 1`, `negative_signals = 0`, `status = active`, `last_mentioned_at = now`, `dormant_since = None`) — mirroring `create()` via shared `INTEREST_INITIAL_*` constants — so its effective weight returns to ~0.75 (> the 0.5 dormancy threshold) and the nightly job won't immediately re-dormant it; this also sidesteps the temporal-decay dead zone (an old dormant cannot exceed the threshold through signals alone). New endpoint `POST /interests/{id}/reactivate` (ownership guard + `409` when the interest is not dormant); `dormant_count` added to `InterestListResponse`; the stats bar now breaks down as active / dormant / blocked.

### Added — Long-term memory now signals which memories are about to be forgotten

The nightly `cleanup_memories` job hard-deletes any non-pinned memory whose retention score (`weight_importance × importance + weight_recency × recency_factor`, minus a zero-usage penalty) falls below `memory_purge_threshold`, after a grace period. Memories stayed visible and pinnable, but the user had **no signal** of an impending purge — nothing prompted pinning before the irreversible deletion.

`MemoryResponse` now exposes a read-only `purge_risk` (`PurgeRiskLevel` enum: `protected` / `safe` / `at_risk` / `imminent`) and `retention_score`, computed on the fly. The Settings list flags `at_risk` / `imminent` (non-pinned) memories with an amber/red "may be forgotten" badge + tooltip inviting a pin. A new parameterizable `memory_purge_at_risk_margin` (default `0.1`) sets the band above the threshold flagged as `at_risk`. Read-only — the purge decision itself is unchanged.

### Changed — Retention scoring extracted to a pure domain module (Boy Scout)

`calculate_retention_score` and `should_purge` moved **verbatim** from `infrastructure/scheduler/memory_cleanup.py` into a new pure module `src/domains/memories/retention.py` (which also adds `RetentionConfig` and `classify_purge_risk`). The scheduler imports them back (`infrastructure → domain`, correct direction) and the API reuses the same functions — DRY, no behaviour change to the purge job, calibration tests preserved byte-for-byte (moved to `tests/unit/domains/memories/test_retention.py`).

Strictly additive — **no DB migration**, no existing endpoint signature changed, no scheduler trigger changed.

Files: `apps/api/src/core/{constants,config/agents,i18n_api_messages}.py`, `apps/api/src/domains/interests/{repository,router,schemas}.py`, `apps/api/src/domains/memories/{models,retention,schemas,router}.py`, `apps/api/src/infrastructure/scheduler/memory_cleanup.py`, `apps/web/src/hooks/{useInterests,useMemories}.ts`, `apps/web/src/components/settings/{InterestsSettings,MemorySettings}.tsx`, the 6 locale files, `.env.example` / `.env.prod.example`. **Tests** — `test_repository_reactivate.py`, `test_router_reactivate.py`, `test_retention.py`. Docs: `docs/knowledge/{08_interests,03_settings}.md`.

## [1.20.11] - 2026-05-21

### Added — ReAct mode now enriches answers with the proactive Initiative phase (ADR-070 / ADR-062 parity)

The Initiative phase — the post-execution step that, after the main answer, optionally runs read-only cross-domain lookups to enrich the reply (e.g. the weather and the drive time before an appointment) — only ran in Pipeline mode. In ReAct mode it was reachable _incidentally_ on the draft-confirmation path, but the nominal path (`react_finalize → response`) bypassed it, so an autonomous ReAct answer never received this enrichment.

ReAct now reaches Initiative on the nominal path too, reusing the existing `initiative_node` (its pre-filter reads `query_intelligence.domains`, its execution summary reads `current_turn_registry`, and the per-request tool manifests are all already populated in ReAct). Wiring: `react_finalize` routes through a new conditional edge `route_from_react_finalize` → `initiative` when `INITIATIVE_ENABLED` **and** the new `INITIATIVE_REACT_ENABLED` flag are set (default `false` — ship dark), otherwise straight to `response`. The ReAct **draft** path is intentionally not gated by the new flag, so default-off behaviour is byte-identical to before this release.

Two ReAct-specific adaptations live outside the node: (1) `route_from_initiative` short-circuits to `response` in ReAct (there is no orchestrator loop to re-evaluate against — exactly one enrichment pass); (2) `response_node` previously injected the ReAct answer only `if not agent_results`, which would have dropped it once Initiative wrote `{turn}:initiative` first — it now **merges** via `_merge_react_synthesis_result` (idempotent on `{turn}:react_agent`) so the answer and the proactive findings coexist. A ReAct-only `<ProactiveFindings>` prompt directive invites the response LLM to weave the findings (already present via `data_for_filtering`) into the reply; the suggestion uses the existing `<InitiativeSuggestion>` injection.

One robustness fix in the node itself: `_format_execution_summary` only handled registry items in `dict` form (their shape in the pipeline after a PostgreSQL checkpoint round-trip), but in ReAct the registry is built in-memory by `react_execute_tools` and the items are live Pydantic `RegistryItem` objects. The function skipped them all, so the summary collapsed to `"No execution results."` and the LLM declined to act (observed live: _"sans détails sur les rendez-vous"_, `should_act=false`). It now normalizes both shapes.

**Config** — new `INITIATIVE_REACT_ENABLED` (default `false`). **Tests** — `test_routing_react_initiative.py`, `test_response_node_react_merge.py`, `test_initiative_execution_summary.py`, `test_react_initiative_flow.py`. Docs: ADR-070 + ADR-062 amendments, `docs/ARCHITECTURE_LANGRAPH.md`, `docs/technical/REACT_EXECUTION_MODE.md`.

### Added — Configurable Today Briefing widget content limits (`BriefingSettings`)

The per-widget content limits of the Today Briefing home page were hard-coded constants. They are now env-overridable via a new `BriefingSettings` module added to the `Settings` MRO: `BRIEFING_MAX_AGENDA_ITEMS` (default raised **3 → 10**), `BRIEFING_AGENDA_LOOKAHEAD_HOURS`, `BRIEFING_MAX_MAILS_ITEMS`, `BRIEFING_MAX_BIRTHDAYS_ITEMS`, `BRIEFING_MAX_BIRTHDAYS_HORIZON_DAYS`, `BRIEFING_MAX_REMINDERS_ITEMS`, `BRIEFING_HEALTH_WINDOW_DAYS`, `BRIEFING_WEATHER_DAILY_FORECAST_DAYS`. Defaults live in `core/constants.py` (`BRIEFING_*_DEFAULT`) — not in the briefing domain — so `core/config` can import them without triggering the briefing package `__init__` (which would create a config↔domain circular import). The pure formatters stay pure: `daily_forecast_days` is threaded as a parameter, not read from `settings`.

**Tests** — `test_briefing_settings.py`. Docs: `docs/technical/BRIEFING_DOMAIN.md`, `.env.example` / `.env.prod.example`.

### Fixed — Today Briefing greeting now reflects the actual agenda (right day, named event)

The dashboard greeting (a one-sentence LLM line) received only an aggregate `agenda_count` and **no dates**, so it could neither tell that the only event was _tomorrow_ (it implied today) nor name it, and a raw count made it lump tomorrow's events into "this afternoon". The greeting now receives the upcoming events (≤ the agenda cap, next ~24 h) with a per-event day-aware start (`"15:00"` = today, `"demain 08:00"` = tomorrow); the prompt reacts to the day's shape (empty/busy, today vs tomorrow) and names an imminent event, without inventing counts. (Side fix found via this work: a literal `{…}` introduced in the prompt broke `str.format` and silently degraded the greeting to its static fallback — the prompt is now brace-safe and a regression test pins the `str.format` contract.)

**Tests** — `test_greeting_agenda_hint.py`.

### Fixed — Currency amounts (`$`) no longer rendered as broken LaTeX in chat and notifications

The markdown renderer (`MarkdownContent`) had KaTeX inline-math enabled with single-`$` delimiters, so a message containing two `$` (e.g. _"1,50$ … 9$"_ in an interest notification) had the span between them rendered as a math formula — spaces dropped, `*`→`∗`, `é`→`eˊ`. `remark-math` is now configured with `singleDollarTextMath: false`: a single `$` is literal text, while `$$…$$` display math still works for the rare intentional case.

### Fixed — Currency exchange-rate API endpoint corrected (Frankfurter `.dev/v1`)

`CURRENCY_API_URL_DEFAULT` pointed at `https://api.frankfurter.dev` while the code appends `/latest`; the `.dev` host returns 404 on `/latest` (it requires the versioned `/v1` prefix) and the legacy `.app` host now 301-redirects. The default is now `https://api.frankfurter.dev/v1`, restoring accurate USD→EUR LLM-cost conversion (it had been falling back to the stale DB rate). `CURRENCY_API_URL` is now documented in `.env.example` / `.env.prod.example`.

### Changed — Scheduler leader-election "lock busy" log demoted from warning to info

`_log_stale_lock_info` logged `scheduler_leader_stale_lock_detected` at **warning** on every `SETNX` miss — i.e. every non-leader worker start, and in dev with `--reload` every fresh PID seeing the previous process's still-valid lock. It is now `scheduler_leader_lock_busy` at **info** (the normal case); a genuinely stuck lock (TTL `-1`, no expiry) is escalated to `scheduler_leader_lock_no_expiry` at warning. `docs/guides/GUIDE_DEBUGGING.md` updated to match.

Files: `apps/api/src/core/config/{briefing,agents,advanced}.py`, `apps/api/src/core/constants.py`, `apps/api/src/domains/agents/graph.py`, `apps/api/src/domains/agents/nodes/{routing,initiative_node,response_node}.py`, `apps/api/src/domains/agents/prompts/v1/briefing_greeting_prompt.txt`, `apps/api/src/domains/briefing/{constants,fetchers,formatters,llm}.py`, `apps/api/src/infrastructure/external/currency_api.py`, `apps/api/src/infrastructure/scheduler/leader_elector.py`, `apps/web/src/components/chat/MarkdownContent.tsx`, plus the test files above and the docs noted per section.

## [1.20.10] - 2026-05-21

### Fixed — ReAct mode: the agent's internal reasoning no longer leaks into the reply, and the answer is no longer shown twice

In ReAct execution mode two regressions surfaced on the final answer. (1) The reply reproduced the agent's step-by-step scaffolding — e.g. _"**PLAN** … **OBSERVATION** … **CROSS-CHECK** … **RÉPONSE FINALE** …"_ — or the model adopted the agent's role outright (_"Je vais chercher l'adresse… il me faut ton point de départ… appel outil"_) instead of just answering. (2) The final text was streamed **twice** on screen before collapsing back to a single copy.

Root cause of (1) was twofold and converged on `response_node`. First, `react_setup_node` accumulates the full `react_agent_prompt` — including its `<Workflow>` PLAN/ACT/OBSERVE/CROSS-CHECK loop and the _"you operate in ReAct mode, call tools"_ role — as `SystemMessage`s in `state["messages"]`, and `filter_for_llm_context()` **kept all non-`__` SystemMessages**, so this internal scaffolding reached the response LLM and the (weaker, high-temperature) model either mimicked the reasoning structure or impersonated the agent. Second, the ReAct loop's clean final answer is handed to the response synthesizer via `agent_results[…]["data"]["react_synthesis"]`, but that entry carries **no `status` key**, so `_format_status_messages()` fell through to `"❓ react_agent: Statut inconnu (unknown)"` and the answer text was **silently dropped** — leaving the LLM with no authoritative reply to reformulate, so it reconstructed one from the polluted context. A controlled A/B (deepseek-v4-flash, temp 1.0) confirmed the trigger: with the ReAct scaffolding present in history the leak/role-confusion appeared in ~20 % of runs; with it removed, 0 %.

Root cause of (2): LangGraph `stream_mode="messages"` emits **both** the LLM's streaming token deltas (`AIMessageChunk`) **and** the complete post-processed `AIMessage` the node returns to the `messages` channel. The streaming layer forwarded both, so the whole reply was sent a second time and a post-loop `content_replacement` chunk then collapsed it — the "double then single" flash. The previous guard (checking `content_final_replacement` in state) could never fire for the current turn, because that flag is set by the response node only _after_ its own tokens have already streamed (the `values` snapshot arrives after the `messages` deltas). Confirmed in prod logs: streamed length was consistently ≈ `len(raw_content) + len(cleaned_content)` (≈ 2×).

The fix has three parts, all reusing existing structures. `filter_for_llm_context()` now **allowlists** only the compaction-summary `SystemMessage` (matched via a new `COMPACTION_SUMMARY_MARKER` constant centralized in `core/constants.py` and reused by `compaction_node` / `compaction_service`, replacing three duplicated literals) and drops every other `SystemMessage` as internal scaffolding — the compaction summary is preserved because it is the response LLM's sole carrier of compacted history (the `compaction_summary` state field is not re-injected into the prompt). `_format_status_messages()` now surfaces `data["react_synthesis"]` (keyed by a new shared `FIELD_REACT_SYNTHESIS` constant, eliminating the writer/reader literal drift that caused the silent drop) as the authoritative answer. `StreamingService._process_messages_chunk()` streams token deltas only (`AIMessageChunk`) and skips the complete returned `AIMessage` once deltas have been seen, with a non-streaming fallback that still emits the complete message when no delta occurred; this replaces the timing-broken `content_final_replacement` guard. Confirmed in dev logs: `response_duplicate_message_skipped{message_type="AIMessage"}` fires and the double is gone.

**Tests** — `test_agent_results_react_synthesis.py` (new: `react_synthesis` surfaced verbatim, turn filtering, no "Statut inconnu", empty-synthesis defence); `test_message_filters.py` (compaction summary kept, ReAct scaffolding dropped, Human/AI turns preserved, list-content `SystemMessage` dropped without crashing); `test_streaming_service.py` (delta streamed + flag set, complete message skipped after deltas, complete message emitted when no prior delta, consecutive deltas). 270+ unit tests green; Ruff / Black / MyPy clean.

Files: `apps/api/src/domains/agents/utils/message_filters.py`, `apps/api/src/domains/agents/formatters/agent_results.py`, `apps/api/src/domains/agents/services/streaming/service.py`, `apps/api/src/core/constants.py`, `apps/api/src/core/field_names.py`, `apps/api/src/domains/agents/nodes/response_node.py`, `apps/api/src/domains/agents/nodes/compaction_node.py`, `apps/api/src/domains/agents/services/compaction_service.py`, and the three test files above.

## [1.20.9] - 2026-05-20

### Fixed — ReAct mode: draft-based mutations now trigger HITL confirmation instead of hallucinating success (ADR-070 amendment)

In ReAct execution mode, asking the assistant to create/modify/reply/forward/delete (events, emails, contacts, tasks, …) made it answer _"C'est fait."_ without ever performing the action. Root cause: these mutation tools do not execute directly — they prepare a **draft** (`requires_confirmation=True`) that must be confirmed via HITL before the real action runs. The pipeline wires this through `task_orchestrator → hitl_dispatch (draft_critique) → response`, but the ReAct loop had no equivalent: `react_execute_tools` collected the draft into the `ReactToolWrapper`'s `_accumulated_drafts` (dead code, never consumed) and looped back to the model, which then interpreted the "draft prepared" tool result as completion. Only tools flagged `hitl_required` in their manifest (e.g. `delegate_to_sub_agent_tool`) reached an `interrupt()`; the draft-based tools (all create/update/delete across event·email·contact·task·file·label) silently fell through.

The fix gives ReAct the same draft-confirmation flow as the pipeline by reusing the existing nodes — no new HITL machinery. `react_execute_tools_node` now detects a prepared draft from the raw tool output (`tool_metadata.requires_confirmation`), extracts the executable payload from the draft's registry item (`payload["content"]` — the same source the pipeline's `DraftExecutor` consumes), and sets `pending_draft_critique` / `pending_drafts_queue` **always** (`None` / `[]` when no draft) so a stale value from a previous turn can never mis-route the loop (the router does not reset these). A new routing function `route_from_react_execute_tools` sends the turn to `hitl_dispatch` (the shared `NODE_DRAFT_CRITIQUE`) when a draft is pending and otherwise loops back to `react_call_model`; the existing `hitl_dispatch → initiative → response_node` path then runs the confirm/edit/cancel HITL and executes the confirmed draft via `execute_draft_if_confirmed`. Because confirmation lives in a node **downstream** of `react_execute_tools`, resume after the interrupt re-enters `hitl_dispatch` only — the draft tool is never re-run, so there are no duplicate drafts. ReAct completion metrics are preserved on this short-circuited path: a shared `_record_react_metrics` helper (also used by `react_finalize`) emits `react_agent_executions_total{status="draft"}` plus iterations/duration, and a minimal `react_agent_result` (empty `final_message`, so `response_node` synthesizes from the real draft-execution result rather than a passthrough) is set for debug. Reminder creation (`create_reminder_tool`) executes directly without a draft and is intentionally not gated — unchanged in both modes. The now-redundant `_accumulated_drafts` collector was removed from `ReactToolWrapper` (it also carried a latent bug — `draft_content` was read from `tool_metadata`, where it is empty rather than from the registry payload), leaving a single, correct draft-detection path at the node level.

**Tests** — 4 new routing cases (`test_routing_react.py`: draft → `hitl_dispatch`; no-draft / missing-key / empty-draft → `react_call_model`) and 7 new draft-detection cases (`test_react_nodes_draft.py`: object/dict registry-payload extraction, `requires_confirmation=false`, no `tool_metadata`, missing `draft_id`, missing content, `draft_id` absent from registry). The obsolete `test_collects_draft_metadata` wrapper test was removed alongside the dead `_accumulated_drafts` collector.

Files: `apps/api/src/domains/agents/nodes/react_nodes.py`, `apps/api/src/domains/agents/nodes/routing.py`, `apps/api/src/domains/agents/graph.py`, `apps/api/src/domains/agents/tools/react_tool_wrapper.py`, `apps/api/src/infrastructure/observability/metrics_agents.py`, `apps/api/tests/unit/domains/agents/nodes/test_routing_react.py`, `apps/api/tests/unit/domains/agents/nodes/test_react_nodes_draft.py` (new), `apps/api/tests/unit/domains/agents/tools/test_react_tool_wrapper.py`, `docs/architecture/ADR-070-ReAct-Execution-Mode.md`, `docs/ARCHITECTURE_LANGRAPH.md`, `docs/technical/REACT_EXECUTION_MODE.md`. Amendment: [`docs/architecture/ADR-070-ReAct-Execution-Mode.md`](docs/architecture/ADR-070-ReAct-Execution-Mode.md).

## [1.20.8] - 2026-05-20

### Fixed — Conversation-history compaction v2: hardening, observability, and user-visible truncation (ADR-086)

The compaction node — entry point of the LangGraph chat graph since F4 (2026-03) — caused a production hang on 2026-05-16 where one user could no longer send any message. Every request hit the compaction node, the LLM responded once after ~32 s, then went silent for ~93 s until the SSE stream was cancelled at 125 s with `Erreur de connexion: network error`. Re-tries reproduced the same hang because the partial state was never fully persisted. Forensic audit surfaced seven defects: `await llm.ainvoke()` had **no timeout** in `_summarize_chunk`; compaction ran synchronously at the graph entry-point and blocked the whole turn; the router-level `last_heartbeat` only pulsed **between** received chunks (never during a silent `await` — Cloudflare tunnel idle ~100 s closed the connection); prior `"compaction #N"` SystemMessages were excluded from `to_compact` and accumulated linearly; an `except Exception` branch silently produced `strategy="descriptive_fallback"` with a near-useless stub (`"[Previous conversation compacted — 48 messages…]"`) and was counted as a success; no retry on transient errors, no global budget, no signal to the frontend during the wait; the frontend had no `'compacting'` status and no UI hint that a summary was running.

**Resilience backend** — `apps/api/src/domains/agents/services/compaction_service.py` now wraps every LLM call in `asyncio.wait_for(per_chunk_timeout_seconds=35)`, retries on `ConnectionError` / `TimeoutError` via `tenacity.AsyncRetrying` with exponential backoff (`stop_after_attempt(3)`, `wait_exponential(multiplier=1.0, min=1.0, max=30)` — `min` aligned with the multiplier so the first retry actually waits one base unit instead of clamping to 0 per tenacity issue #175), and wraps the whole `compact()` in a global `asyncio.wait_for(global_timeout_seconds=120)`. On global-timeout or any unrecoverable error, the new `_truncation_fallback` produces an explicit, deterministic `SystemMessage` (`"[Older conversation truncated — N messages removed because the automatic summary could not complete (global_timeout). Key identifiers preserved: …]"`) instead of the silent `descriptive_fallback` stub that v1 emitted. The `descriptive_fallback` codepath is removed; `strategy="truncation"` is the explicit, user-visible substitute. New settings centralised in `agents.py` + `constants.py` and exposed in `.env.example` / `.env.prod.example`: `compaction_per_chunk_timeout_seconds`, `compaction_global_timeout_seconds`, `compaction_max_retries`, `compaction_retry_backoff_base_seconds`, `compaction_include_previous_summaries`. `should_compact()` reordered so a small-but-token-heavy conversation (e.g. 13 messages containing a single 6 K-token AIMessage with embedded tool data) still triggers compaction — the token count is the real signal, the `compaction_min_messages` floor is now only a fast-path for sub-threshold conversations.

**Prior-summary consolidation** — Previous `"compaction #N"` SystemMessages are now prepended to the merge step (recursive consolidation, opt-in via `compaction_include_previous_summaries=true`), preventing the linear accumulation observed in v1 where each turn appended a new summary on top of all the old ones. The node only removes the prior summaries from state if the merge **actually consolidated them** (`consolidated_previous_summaries=True`) — on truncation fallback or any path that didn't merge them, they are preserved so the conversation does not lose information v1 had retained. The strategy label `single_chunk_with_merge` was introduced to distinguish a one-chunk run that still ran a merge step from a true `multi_chunk` LLM workload — Grafana no longer over-estimates the multi_chunk rate. `_format_messages_for_summary` now serialises content blocks via `json.dumps` instead of `BaseMessage.text`, which on `ToolMessage` with `content: list[ContentBlock]` was leaking Python repr / JSON wrappers into the prompt and degrading the summary quality.

**SSE custom stream-mode signal** — The compaction node now emits `compaction_start` and `compaction_done` payloads via `langgraph.config.get_stream_writer()` through a new `stream_mode="custom"` (LangGraph 1.x). The orchestration layer's two `astream()` call sites were updated to include `"custom"` in their mode list. `StreamingService._process_custom_chunk` translates these payloads into `ChatStreamChunk(type="execution_step", metadata={step_type: "compaction", step_label: ...})`, folding `step_type` / `step_label` into the metadata dict to fit the existing schema. The node falls back to a no-op writer when `get_stream_writer` is missing or raises (older LangGraph, unit tests, graph executed without `stream_mode=["custom"]`) — the fallback is logged at WARNING **and** increments a new Counter `compaction_writer_unavailable_total{reason}` so silent degradation is now visible in Grafana. The `compaction_start` payload carries `estimated_duration_seconds` (heuristic derived from `COMPACTION_UI_ESTIMATE_*` constants: tokens-per-chunk × seconds-per-chunk, capped at the global-budget margin) and `is_resume`. The `compaction_done` payload carries `strategy`, `tokens_saved`, `duration_ms`.

**Concurrent SSE keepalive** — New module `apps/api/src/domains/agents/api/sse_keepalive.py` exposes `iter_with_keepalive(source, keepalive_interval_seconds)` which spawns **one** consumer task that drains the upstream into an `asyncio.Queue` and yields a `KeepalivePulse` sentinel on every `queue.get()` timeout (defaults to `SSE_HEARTBEAT_INTERVAL=15s`). The router serialises pulses as the SSE comment line `": heartbeat\n\n"`. Critically the single-consumer-task design preserves `ContextVar.set() / .reset()` stability (the earlier prototype spawned a fresh `asyncio.create_task(__anext__())` per iteration, which broke because each `__anext__()` ran in a brand-new Context and the tokens minted by the upstream's `__aenter__` could no longer be `.reset()` from the next iteration's Context). The `finally` block cancels the consumer, awaits it, swallows the expected `CancelledError` / `StopAsyncIteration`, and logs at DEBUG only on unexpected exceptions — full observability without leaking errors past the caller. The legacy router-level `last_heartbeat` check (which only pulsed between received chunks) is removed.

**User-visible frontend feedback** — New reducer transitions `STREAM_COMPACTION_START` / `STREAM_COMPACTION_DONE` set `status === 'compacting'` (folded into `useChat.isTyping` so the existing `disabled={isTyping || isUsageBlocked}` wire on `ChatInput` locks the textarea automatically). `handleCompactionStep` (in `apps/web/src/lib/sse-handlers/handlers.ts`) intercepts `execution_step` chunks carrying `metadata.step_type === 'compaction'` and drives a **morphing sonner toast** via a stable id (`COMPACTION_TOAST_ID = "compaction-progress"`): `toast.loading(t('chat.compaction.in_progress'))` on start, then `toast.success(t('chat.compaction.completed', {tokens}))` or `toast.warning(t('chat.compaction.truncated'))` on done. A first attempt placed a `<CompactionBanner>` inside `ChatMessageList` (sticky-top variant tested) but the dual `overflow-y: auto` boundary (scroll container + max-width wrapper) made the banner invisible at the default post-send scroll position. The pivot to a position-fixed sonner toast (decoupled from the chat scroll layout) is documented in the _Update_ section of ADR-086 — the SSE contract and reducer state are unchanged, only the rendering layer moved. New i18n keys `chat.compaction.{in_progress, completed, truncated}` added in all 6 locales (`fr` / `en` / `de` / `es` / `it` / `zh`), with `{{tokens}}` interpolation in the success copy. Dead key `chat.compaction.elapsed` removed (it had been retained for an inline-timer variant of the banner that the toast does not need).

**Context-usage pill** — Discreet 16-px SVG ring with `tokens / threshold` percentage in the chat header (between the voice-mode badge and the delete-conversation button). Colours shift across 4 tiers (green ≤ 50 %, amber ≤ 75 %, orange ≤ 90 %, rose > 90 %). The badge label is clamped at 100 % (we never display nonsensical inline values like _"150%"_); the tooltip displays the real ratio and uses the explicit `chat.context_usage.tooltip_overflow` copy when `ratio > 1` (_"compaction will run on your next message"_). The pill hydrates from server state on page load via a new helper `useChat.hydrateContextUsage(tokens, threshold)` consumed in `apps/web/src/app/[lng]/dashboard/chat/page.tsx`, fed by two new optional fields on `ConversationTotalsResponse` (`context_tokens` / `context_threshold`) populated by `ConversationService._compute_checkpoint_context_usage()`. That helper uses `checkpointer.aget_tuple(config)` (not `aget`) so the access goes through the canonical `CheckpointTuple` API instead of relying on the stale `aget` type-cast in `InstrumentedAsyncPostgresSaver` — a future LangGraph bump can no longer silently break the pill hydration. The token counter is the same `CompactionService._token_counter` the backend uses for decisions, so the pill and the compaction trigger agree on what the threshold is. Three i18n keys in `chat.context_usage.*` (tooltip / tooltip_compact / tooltip_overflow) localized in 6 languages with `{{tokens}}` / `{{threshold}}` / `{{percent}}` interpolation.

**Observability** — Five new Prometheus metrics in `apps/api/src/infrastructure/observability/metrics_compaction.py`: `compaction_chunk_timeouts_total` (per-chunk `asyncio.wait_for` triggers), `compaction_global_timeouts_total` (truncation fallback firings), `compaction_total_duration_seconds` (v2-aware histogram with buckets up to 180 s), `compaction_writer_unavailable_total{reason}` (no-op writer fallbacks), and the existing `compaction_executions_total{strategy}` now labels `single_chunk` / `multi_chunk` / `single_chunk_with_merge` / `truncation` / `noop` (the legacy `descriptive_fallback` is gone). New Grafana dashboard `infrastructure/observability/grafana/dashboards/14-compaction.json` (7 panels: strategy mix, latency p50/p95/p99, chunk timeouts, global timeouts, errors by type, skipped reasons, tokens saved). Structured logging on every defensive branch: `compaction_threshold_exceeded`, `compaction_chunk_timeout`, `compaction_global_timeout_fallback_to_truncation`, `compaction_writer_unavailable`, `compaction_node_applied`, `compaction_completed` with the full set of structured fields (token counts, strategy, duration, attempts).

**Operator runbook** — New transactional admin script `scripts/admin/reset_user_checkpoints.sql` that wipes a single user's LangGraph checkpoints (`checkpoints`, `checkpoint_blobs`, `checkpoint_writes`) inside a transaction with before/after counts, leaving application data (messages, conversations) untouched — the fastest recovery path for any future stuck-conversation report. The runbook itself is documented in `docs/technical/COMPACTION_v2.md` along with threshold-tuning guidance, the `/resume` forced-compaction command, Grafana diagnosis tips, and a Cloudflare-tunnel note clarifying that the 15 s SSE keepalive is sufficient to neutralize the ~100 s idle cut (no `cloudflared` configuration change required).

**Dependencies** — `tenacity==9.1.4` declared explicitly in `apps/api/requirements.txt` (was transitive via `langchain-core`). DeepSeek V4 family added to `MODEL_CONTEXT_WINDOWS` in `apps/api/src/core/config/llm.py` (`deepseek-v4-flash` / `deepseek-v4-pro` / `deepseek-v4-reasoner` / `deepseek-v4` → 1 M tokens) so the dynamic compaction threshold (`compaction_threshold_ratio × context_window`) is correct on V4 deployments instead of falling back to the 128 K default.

**Tests** — 25 new backend tests (`test_compaction_service_v2.py`: 9 cases including per-chunk timeout, retry-then-succeed, retry exhaustion, global-timeout fallback, unexpected-error fallback, single_chunk_with_merge label, prior-summary consolidation, ContextVar regression; `test_sse_keepalive.py`: 9 cases including a regression guard `test_contextvar_set_and_reset_survives_keepalives`; `test_custom_stream_mode_integration.py`: 1 end-to-end LangGraph custom-mode → StreamingService integration; `test_compaction_node.py`: 4 new cases on writer emission + RemoveMessage consolidation behaviour; `test_streaming_service.py`: 4 new `TestProcessCustomChunk` cases) and 25 new frontend tests (`chat-reducer.compaction.test.ts`: 6 cases on the new reducer transitions, `chat-reducer.context-usage.test.ts`: 7 cases on the hydration action, `compaction-handler.test.ts`: 5 cases including the non-compaction execution_step regression guard, `ContextUsagePill.test.tsx`: 7 cases including the badge-clamping regression on `ratio > 1`).

**Baseline integration-test sweep (2026-05-20)** — Took the opportunity to clear 19 pre-existing integration-test failures unrelated to compaction (4 stale `get_redis_session` mocks pointing at `base_google_client` instead of `base_oauth_client`; 1 hardcoded LLM provider list missing `qwen` / `gemini` — now derived from the canonical `ProviderType` Literal via `typing.get_args()`; 14 stale `get_global_registry` mocks pointing at `query_analyzer_service` instead of `agent_registry`, plus 9 `"contacts"` → `"contact"` assertions aligned with the singular canonical name in `core_types.source_domains`). No production code touched; all changes confined to `tests/integration/`. The post-sweep baseline (`BASELINE_KNOWN_FAILURES.md`) is now `64 passed, 0 failed, 172 skipped`.

Files: `apps/api/src/domains/agents/services/compaction_service.py`, `apps/api/src/domains/agents/nodes/compaction_node.py`, `apps/api/src/domains/agents/api/sse_keepalive.py` (new), `apps/api/src/domains/agents/services/streaming/service.py`, `apps/api/src/domains/agents/services/orchestration/service.py`, `apps/api/src/domains/agents/api/router.py`, `apps/api/src/domains/conversations/{router,schemas,service}.py`, `apps/api/src/infrastructure/observability/metrics_compaction.py`, `apps/api/src/core/{config/agents,constants,config/llm}.py`, `apps/api/requirements.txt`, `apps/web/src/components/chat/ContextUsagePill.tsx` (new), `apps/web/src/lib/sse-handlers/handlers.ts`, `apps/web/src/reducers/chat-reducer.ts`, `apps/web/src/types/chat-state.ts`, `apps/web/src/hooks/{useChat,useConversation}.ts`, `apps/web/src/app/[lng]/dashboard/chat/page.tsx`, 6 × `apps/web/locales/{lang}/translation.json`, `docs/architecture/ADR-086-Conversation-History-Compaction-v2.md` (new), `docs/technical/COMPACTION_v2.md` (new), `infrastructure/observability/grafana/dashboards/14-compaction.json` (new), `scripts/admin/reset_user_checkpoints.sql` (new). Architecture: [`docs/architecture/ADR-086-Conversation-History-Compaction-v2.md`](docs/architecture/ADR-086-Conversation-History-Compaction-v2.md). Runbook: [`docs/technical/COMPACTION_v2.md`](docs/technical/COMPACTION_v2.md).

## [1.20.7] - 2026-05-17

### Fixed — Pre-confirmation HITL preview rendering: unified across DraftCritique and ForEachConfirmation (ADR-085 extension)

After fixing the post-execution rendering, the **pre-confirmation** previews — the bullet list of items the user is about to mutate, shown before the destructive/for_each HITL question — were found to use two distinct codepaths that produced incoherent rows for the same scenario. For `Supprime tous mes rappels`:

```
# Path A — ForEachConfirmationInteraction          # Path B — DraftCritiqueInteraction (batch)
Rappel : Médecin le 17 mai 2026 à 19:00            🔔 Médecin 🔔 dimanche 17 mai 2026 à 19:00
```

Path A built rows from a generic `item_previews: list[dict]` joined by a localized connector (`"le"`/`"on"`/`"el"`/...) — **no emoji prefix**. Path B built rows via a ~100-line per-`draft_type` if/elif chain that injected the row emoji both as `main_label` prefix and inside the appended `detail_parts` — **duplicated 🔔** when the markdown bullet got flattened by the chat UI. And `_DESTRUCTIVE_CONFIRM_ACTION_TITLES` had no `reminder_delete` entry, so the title fell back to the generic _"Confirmation requise"_ instead of _"Confirmation de suppression"_ — same systemic oversight that motivated ADR-085.

Unified both paths to share a single registry-driven helper:

- New public function `apps/api/src/core/i18n_drafts.py::format_hitl_item_preview(draft_type, content, language, user_timezone)` consumes `DRAFT_DISPLAY_REGISTRY` (ADR-085) — emoji, ordered label-extraction fields, optional secondary datetime, localized capitalized noun via `DRAFT_RESULT_NOUNS`. Always renders the datetime with `include_day_name=True`. Output: `{emoji} {Noun_capitalized} : {label} - {datetime_with_day_name}` (Chinese uses its own word order template inherited from `RESULT_HEADER_TEMPLATES`).
- `DraftCritiqueInteraction._generate_batch_critique` — removed the ~100-line `_extract_batch_item_preview` if/elif chain; calls the helper directly. Defensive 6-field fallback (`subject/summary/title/name/content/label_name`) preserved for unregistered draft types.
- `ForEachConfirmationInteraction._build_item_previews_section` — added a `steps: list[dict[str, Any]] | None` parameter and a static helper `_steps_to_draft_type(steps)` that maps a FOR_EACH `tool_name` to a canonical `DraftType` string (`cancel_reminder_tool` → `"reminder_delete"`, `update_event_tool` → `"event_update"`, `send_email_tool` → `"email"`, etc.). When the mapping resolves, the unified helper is used; otherwise the legacy generic renderer remains intact (preserved for non-draft domains: places, weather, routes, web_fetch, mcp).
- `_DESTRUCTIVE_CONFIRM_ACTION_TITLES` — `reminder_delete` added in all 6 languages (`"Confirmation de suppression"` / `"Confirm deletion"` / `"Confirmar eliminación"` / `"Löschung bestätigen"` / `"Conferma eliminazione"` / `"确认删除"`).

Final rendering for `Supprime tous mes rappels` (both HITL paths converge):

```
⚠️ **Confirmation de suppression**

**Éléments concernés :**
- 🔔 Rappel : Médecin - dimanche 17 mai 2026 à 19:00
- 🔔 Rappel : Ramonage - jeudi 21 mai 2026 à 19:00
- 🔔 Rappel : Alsace - vendredi 22 mai 2026 à 19:00

⚠️ Cette action est irréversible.

**Confirmes-tu cette suppression ?**
```

Other domains inherit the same shape: `📅 Événement : Réunion équipe - lundi 20 mai 2026 à 10:00`, `📧 Email : Confirmation rdv jeudi - jeudi 16 mai 2026 à 14:00`, `👤 Contact : Marie Dupont`, `✅ Tâche : Préparer démo - mardi 20 mai 2026 à 17:00`.

**Backwards-compat preserved**: `HitlMessages.get_draft_emoji()` unchanged. The legacy generic FOR_EACH fallback (with `item_date_connector`) remains for non-draft domains. All existing tests in `tests/unit/domains/agents/` keep passing.

**Files**: MODIFY `apps/api/src/core/i18n_drafts.py` (+ `format_hitl_item_preview`), `apps/api/src/core/i18n_hitl.py` (+ `reminder_delete` × 6 languages in `_DESTRUCTIVE_CONFIRM_ACTION_TITLES`), `apps/api/src/domains/agents/services/hitl/interactions/draft_critique.py` (- `_extract_batch_item_preview`, refactor `_generate_batch_critique`), `apps/api/src/domains/agents/services/hitl/interactions/for_each_confirmation.py` (+ `_steps_to_draft_type`, refactor `_build_item_previews_section`). NEW tests `apps/api/tests/unit/domains/agents/drafts/test_hitl_item_preview.py` (119 parametrized cases) and `apps/api/tests/unit/domains/agents/drafts/test_for_each_draft_type_mapping.py` (25 cases). Architecture: `docs/architecture/ADR-085-Draft-Display-Registry.md` extension section.

---

### Fixed — Post-HITL confirmation rendering: from "Action exécutée avec succès" × N to a localized, structured result block (ADR-085)

`Supprime tous mes rappels` (3 reminders) used to render after confirmation as `✅ 3/3 / ✅ Action exécutée avec succès × 3` — no domain emoji, no per-item label, no datetime context, bland default message repeated. Forensic trace exposed **4 disjoint sources of per-`DraftType` knowledge** in the post-HITL rendering pipeline with hetereogeneous coverage (13/16, 15/16, 6/16, plus a hard-coded label-extraction chain), of which the recently-added `REMINDER_DELETE` type had only been registered in one. `file_delete` and `label_delete` silently suffered the same defect in batch mode — never spotted because never exercised under batch.

Replaced the 4 sources with a **single declarative registry** keyed by `DraftType` (`DRAFT_DISPLAY_REGISTRY` in `apps/api/src/domains/agents/drafts/display.py`) that captures, per type: the domain emoji, the ordered label-extraction fields, an optional secondary datetime key (e.g. `trigger_at` for reminders), the rich detail rows for single-confirm, and i18n keys driving header composition. `assert_registry_completeness()` is invoked at lifespan startup _and_ in a parametrized unit test — a new `DraftType` without a registered display config either fails to boot or fails the PR.

Localized **batch header now uses correct grammar in all 6 supported languages** (`apps/api/src/core/i18n_drafts.py`): two new tables (`DRAFT_RESULT_NOUNS` and `DRAFT_RESULT_VERBS_PAST`) encode noun forms (singular/plural + gender for fr/es/it) and past-participle forms (4 gender/number combinations for fr/es/it, invariant string for en/de/zh-CN). `RESULT_HEADER_TEMPLATES` handles Chinese's different word order (`已删除 3 个提醒`). `compose_result_header(success, total, noun_key, verb_past_key, language)` assembles `"3 rappels supprimés"` (fr m+plur), `"1 tâche créée"` (fr f+sing), `"3 reminders deleted"` (en invariant), `"3 Termine gelöscht"` (de invariant), `"3 attività create"` (it noun-invariant + verb agreement). Pluralization rule per language: French treats 0 and 1 as singular; English/Spanish/German/Italian treat 1 as singular and everything else as plural; Chinese is invariant.

Each batch row now carries both the **item label** (sourced via the registry's `item_label_fields` priority chain, with dotted notation for nested keys like `file.name` or `contact.names.0.displayName`) **and an optional contextual datetime** (`item_secondary_datetime_key` — e.g. `trigger_at` for reminders → ` — 16 mai à 14h00`). When extraction fails, a `draft_result_format_empty_label` warning is logged with the available content keys.

Final rendering for `Supprime tous mes rappels`:

```
🔔 ✅ 3 rappels supprimés
✅ **Faire les courses** — 16 mai à 14h00
✅ **Appeler Maman** — 17 mai à 09h00
✅ **Rendez-vous médecin** — 18 mai à 11h00
```

**Backwards-compat preserved**: `HitlMessages.get_draft_emoji()` keeps the same shape (becomes a one-line wrapper over the registry), the three external callsites in `draft_critique.py` are untouched, and `DRAFT_SUCCESS_MESSAGES` / `DRAFT_CANCEL_MESSAGES` are kept (still used by `Draft.get_summary()`), with the missing `reminder_delete` entry added in all 6 languages.

**Files**: NEW `apps/api/src/domains/agents/drafts/display.py`, MODIFY `apps/api/src/core/i18n_drafts.py` / `apps/api/src/core/i18n_hitl.py` / `apps/api/src/domains/agents/nodes/response_node.py` / `apps/api/src/main.py`, NEW tests `apps/api/tests/unit/domains/agents/drafts/test_display_registry.py` (~30 parametrized cases on `DraftType` × 6 languages) and `apps/api/tests/unit/domains/agents/nodes/test_format_draft_execution_result.py` (19 cases covering batch/single/cancel/error per type + per-language header snapshots). Architecture: `docs/architecture/ADR-085-Draft-Display-Registry.md`.

---

## [1.20.6] - 2026-05-15

### Added — Indexable vs Semantic criteria: universal planning principle + leak detector

Repeated diagnostics of "mes deux prochains rdv médicaux" surfaced a class of failures invisible to the existing validator: the planner LLM was passing semantic qualifiers (e.g. `medical`, `urgent`, `important`) as the `query` of literal-text-search tools (Google Calendar / Gmail / Notion-like stores), which then returned 0 hits or false positives, then no `web_searchs`/`events` card was rendered. Cause is twofold and **independent of any specific connector**:

- **Weaker / non-reasoning query analyzers** (`deepseek-v4-flash` without `reasoning_effort`) misclassified specific filtered queries as broad skill activations (e.g. `briefing-quotidien`) → `SkillBypassStrategy` short-circuited the LLM planner entirely → fixed 5-step generic plan with `max_results=5` and a 2-day window → 0 events of the requested category. Adding `reasoning_effort=high` fixed the skill misclassification but exposed the second failure mode.
- **Reasoning-enabled planners still leaked semantic terms into `query`** — e.g. `get_events_tool(query="medical", max_results=2, time_max=now+1y)` against a calendar API that indexes by title literals. The smart_planner prompt's pre-existing rule 4 ("Non-searchable field criteria → broad results, Response LLM filters") was too abstract and required an inference about each connector's indexing semantics that only top-tier reasoning models (e.g. `gpt-5.2`) reliably made.

A 3-layer defense addresses this generically, gated by a feature flag in `observe` mode for the rollout — **no plans are altered in production until metrics confirm safe activation in Phase 2**.

#### Layer 1 — Universal planning principle in the smart_planner prompt

New section `INDEXABLE vs SEMANTIC CRITERIA (universal planning principle)` in `apps/api/src/domains/agents/prompts/v1/smart_planner_prompt.txt`, placed before `PLANNING RULES` so it is a conceptual framing applied to every rule below. Generic, English (cohérent avec le pipeline post-`semantic_pivot`), agnostic au connecteur (Google / Microsoft / Apple / Notion / Slack / JIRA / futurs MCPs traités identiquement). Covers:

- The two-class taxonomy: **indexable** values (literal counterpart in a structured field — dates, IDs, sender, status, label id, location…) → tool parameter; **semantic** qualifiers (no literal counterpart — categories, priorities, quality/ranking, relative time without date) → Response LLM filtering downstream.
- A concept-level example list grouped by sub-class (`nature/category`, `priority/urgency`, `quality/ranking`, `relative time without a date`) explicitly marked non-exhaustive — bias on principle, not casuistic list.
- The **CARDINALITY × SEMANTIC trap**: "the N <semantic> X" → N is the FINAL count after Response filtering, not `max_results`. Bring back a 20–50 batch.
- Two **EXCEPTIONS** to preserve legitimate cases: (1) user explicitly cites the term as a literal string to match (quoted, "with X in the title/subject"), (2) tool description states it performs semantic/vector search on `query`.
- Interpolation placeholder `{semantic_filter_terms_hint}` — when empty renders as `(none)` to keep prompt-cache-friendly stable length; when non-empty lists the terms flagged by the query analyzer for the current request.

Prompt size impact: **~370 tokens added** — recovered by Anthropic/OpenAI prompt caches after the first call, so steady-state cost is null.

#### Layer 2 — Structured hint emitted by the query analyzer

New `semantic_filter_terms: list[str]` field on `QueryAnalysisOutput` (Pydantic, `default_factory=list` → schema rétro-compatible; if the LLM ignores it, comportement actuel préservé). Description explicitly frames this as a **probabilistic hint, NOT authoritative** — the planner still owns the decision. Propagated through `QueryAnalysisResult` → `QueryIntelligence.semantic_filter_terms: tuple[str, ...]` (frozen) → `ValidationContext.semantic_filter_terms`. Also cleared by the existing `chat_override` (same hygiene rationale as the existing `skill_name` clear, lines 1162-1173 of `query_analyzer_service.py`).

Corresponding new section in `query_analyzer_prompt.txt` (`INDEXABLE vs SEMANTIC HINT`) instructing the LLM what to emit: english-pivoted form, leave empty when user cites the term as a literal value, do NOT include indexable values. Cohérent avec la langue du pipeline post-`semantic_pivot`.

Metric `lia_planner_semantic_filter_terms_emitted_total{model, term_count_bucket}` (`1` / `2-3` / `4+`) records emission rate per model — drives the Phase 2 rollout decision.

#### Layer 3 — Universal validator (`observe` by default, `autocorrect` on flip)

New `_check_semantic_leak` method on `PlanValidator` in `apps/api/src/domains/agents/orchestration/validator.py`, invoked from `validate_execution_plan` for every step of every plan (single-domain, multi-domain, future strategies). Tool-agnostic: iterates over `TEXT_SEARCH_PARAM_NAMES` (`query`, `q`, `search`, `search_query`, `text`, `keywords`) on each TOOL step. Word-boundary match against the term set (split + strip on punctuation) to avoid substring false positives (`medical` ⊄ `medicalign`).

Mode-gated by `PLANNER_SEMANTIC_LEAK_MODE` (settings field `planner_semantic_leak_mode: Literal["off", "observe", "autocorrect"]`):

- `off` — kill switch.
- `observe` (default) — log + metric `lia_planner_semantic_leak_detected_total{tool_name, param_name, mode}`, plan untouched. **Zero regression guarantee for Phase 1 ship**.
- `autocorrect` — NULL the leaky parameter and bump `max_results` to `PLANNER_SEMANTIC_BROAD_BATCH` (default `25`, range `10-100`) **only when** the existing `max_results` is `< PLANNER_SEMANTIC_BROAD_BATCH_MIN` (= `20`). Already-broad values are preserved (test row covered). Emits the dedicated `lia_planner_semantic_leak_autocorrected_total{tool_name, param_name}` counter.

Two escape hatches honored by the validator (mirror the prompt exceptions): (1) any quote character in the param value (`"medical"` or `"urgent"` patterns) → skip (literal-match intent), (2) tool's manifest `text_search_mode != "literal"` → skip (the store performs semantic search natively).

Rollout strategy explicitly **observe → measure → autocorrect**: ship Layer 3 in `observe`, accumulate 1-2 weeks of `lia_planner_semantic_leak_detected_total{mode="observe"}` data, then flip via `.env` (no code redeploy) once leak frequency is confirmed and a manual sample shows no false positives.

#### New `ToolManifest.text_search_mode` (Layer 4, structural)

New field `text_search_mode: Literal["literal", "semantic", "hybrid"] = "literal"` on `ToolManifest` (`apps/api/src/domains/agents/registry/catalogue.py`). Default `"literal"` preserves the current behavior of every existing tool — **no tool needs to be updated to ship Phase 1**. Future MCP tools, Notion AI search, vector-search backends can declare `"semantic"` or `"hybrid"` to opt out of the leak detector cleanly. Documented in the field's inline comment with reference to the prompt section and the validator.

### Added — New env vars (4 settings, all tunable via `.env`)

| Variable                       | Default   | Range                             | Purpose                                                                                                     |
| ------------------------------ | --------- | --------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `PLANNER_SEMANTIC_LEAK_MODE`   | `observe` | `off` / `observe` / `autocorrect` | Validator behavior on a detected leak. Ship in `observe` for the rollout, flip to `autocorrect` in Phase 2. |
| `PLANNER_SEMANTIC_BROAD_BATCH` | `25`      | 10-100                            | `max_results` bump applied by `autocorrect`, only when the existing value is `< 20`.                        |

Constants centralised in `src/core/constants.py`: `TEXT_SEARCH_PARAM_NAMES` (frozenset of free-text query parameter names), `PLANNER_SEMANTIC_BROAD_BATCH_DEFAULT` (25), `PLANNER_SEMANTIC_BROAD_BATCH_MIN` (20). `.env.example` and `.env.prod.example` updated.

### Tests

- `tests/unit/domains/agents/orchestration/test_validator_semantic_leak.py` — 17 cases covering the 10-row regression matrix (generic listing without semantic filter, indexable filter such as `from:marc`, quoted literal `"urgent"`, semantic-search tool exception, target case `mes deux prochains rdv médicaux` in both `observe` and `autocorrect` modes, cardinality × semantic combo such as "the 3 most important emails from boss", mixed indexable + semantic, multi-step per-step independent detection, conservatism when no hint is emitted, word-boundary true positive on `medical clinic Paris` and absence of false positive on `medicalign software`) plus 3 mode-gating tests (`off` is a no-op, `observe` does not mutate the plan, `autocorrect` preserves an already-broad `max_results`) and 2 backward-compatibility tests (default `ValidationContext.semantic_filter_terms == ()`, full `validate_execution_plan` pipeline runs cleanly with no hint).
- Non-regression verified by running adjacent suites: 521 cases in `tests/unit/domains/agents/orchestration/` pass after the change, 276 in `tests/unit/domains/agents/registry/`, 60 across `tests/unit/domains/agents/services/` matching `planner` or `query_analyzer`. Docker `lia-api-dev` restarted cleanly (healthy after ~50 s, no startup exception related to the new code).

### Observability

- Three Prometheus counters in `src/infrastructure/observability/metrics_agents.py`: `lia_planner_semantic_filter_terms_emitted_total{model, term_count_bucket}`, `lia_planner_semantic_leak_detected_total{tool_name, param_name, mode}`, `lia_planner_semantic_leak_autocorrected_total{tool_name, param_name}`.
- New structured log events: `semantic_filter_terms_emitted` (query analyzer), `semantic_leak_in_plan` (validator), `semantic_leak_autocorrected` (validator). The leaky `query` value itself is **not logged** (potential PII); only the matched semantic terms, the step id, the param name, and the tool name appear in the warning.

### Refactor — Timeout configuration centralization (Vagues 1–5): 24 timeouts moved to Settings + `.env`, 2 magic numbers extracted, 1 orphan wired, 2 dead constants + 1 duplicate Field removed

Audit (V1 → V3 in [docs/technical/TIMEOUT_REGISTRY.md](docs/technical/TIMEOUT_REGISTRY.md)) inventoried ~80 timeouts across the backend (HTTP outbound, tools, DB, Redis, locks, scheduler, SSE, WebSocket, browser, voice, MCP, sub-agents, infra) and surfaced three classes of debt:

- **Hardcoded constants used in production paths** but never exposed to operators (no `Settings` Field, no `.env` entry) — required a Docker rebuild to tune. Examples: `HTTP_TIMEOUT_PERPLEXITY` (60 s), `DEFAULT_TOOL_TIMEOUT_SECONDS` (30 s), `BROWSER_TOOL_TIMEOUT_SECONDS` (300 s), `OAUTH_LOCK_TIMEOUT_SECONDS` (10 s), `MCP_OAUTH_HTTP_TIMEOUT_SECONDS` (10 s), 17 others.
- **Inline magic numbers** (`90.0` for image-generation tools, `120.0` for `claude_server_task_tool`) embedded in `parallel_executor._compute_step_timeout` without a named constant.
- **Orphans, duplicates, dead code, inverted cascades**: `task_orchestrator_execution_timeout_seconds` declared in `agents.py` + `.env.example` but **never read** at runtime; `http_timeout_currency_api` and `currency_api_timeout_seconds` shadowing each other (only the latter actually used by the Frankfurter client); `HTTP_TIMEOUT_PROMPT_REGISTRY` and `BACKGROUND_TASK_TIMEOUT_DEFAULT` defined in `constants.py` with zero call sites; `BRAVE_SEARCH_ENRICHMENT_TIMEOUT = 3.0 s` firing **before** the per-request `HTTP_TIMEOUT_BRAVE_SEARCH = 5.0 s` it was supposed to wrap (G2 cascade inversion).

LLM-call timeouts (`router`, `response`, `planner`, `query_analyzer`, etc.) are deliberately **out of scope** — they are governed per-LLM-type by the `llm_config` table and the Admin → Configuration LLM UI; per-row granularity does not fit env vars. Annex A of the registry cross-references them for reading.

The migration is split into five waves; each wave preserves the historical default value for every migrated entry — **no behavioural change of normal traffic** unless the operator overrides via `.env`. The only intentional behavioural changes are: (a) the Brave G2 cascade fix, (b) the wiring of the previously-orphan `task_orchestrator_execution_timeout_seconds` as a soft wave-scheduling cap.

#### Vague 1 — HTTP outbound (7 timeouts)

`HTTP_TIMEOUT_PERPLEXITY` (60.0), `HTTP_TIMEOUT_WEATHER` (10.0), `HTTP_TIMEOUT_WIKIPEDIA` (15.0), `HTTP_TIMEOUT_BRAVE_SEARCH` (5.0), `BRAVE_SEARCH_ENRICHMENT_TIMEOUT_SECONDS` (**3.0 → 8.0**, G2 fix), `OLLAMA_DISCOVERY_TIMEOUT_SECONDS` (5.0), `WEB_FETCH_TIMEOUT_SECONDS` (15.0). Migrated as Pydantic Fields in `connectors.py` / `agents.py` / `llm.py`. Consumers updated: `perplexity_client`, `openweathermap_client`, `wikipedia_client`, `brave_search_client`, `ollama_discovery`, `web_fetch_tools`, `response_node` (3 sites), `knowledge_enrichment_service` (2 sites). The Brave fix preserves the documented constraint `enrichment ≥ HTTP × 1.5`.

#### Vague 2 — Connectors / locks / SSE / scheduler (11 timeouts, 2 new modules)

Created `apps/api/src/core/config/scheduler.py` (`SchedulerSettings` — `scheduled_actions_execution_timeout_seconds`, `scheduled_actions_stale_timeout_minutes`) and `apps/api/src/core/config/locks.py` (`LocksSettings` — `oauth_lock_timeout_seconds`). Both added to the `Settings` MRO in `__init__.py` (positions 21 and 22). The remaining nine entries enriched existing modules: `connectors.py` (`http_timeout_connector_standard/long`, `http_timeout_sse_polling`, `hue_pairing_timeout_seconds`), `agents.py` (`http_timeout_conditional_eval`), `mcp.py` (`mcp_oauth_http_timeout_seconds`), `usage_limits.py` (`usage_limit_ws_idle_timeout_seconds`), `health_metrics.py` (`health_metrics_heartbeat_fetch_timeout_seconds`).

Consumers migrated to `settings.<field>`: `connectors/router.py` (5 sites), `base_api_key_client`, `parallel_executor` (conditional eval), `notifications/router`, `infrastructure/locks/oauth_lock` (`__init__` signature now takes `int | None` and resolves at call time to preserve testability), `mcp/auth.py`, `mcp/oauth_flow.py` (3 sites), `philips_hue_client`, `usage_limits/websocket`, `heartbeat/context_aggregator`, `scheduled_action_executor` (2 sites).

#### Vague 3 — Tool execution & extraction of inline magic numbers (8 settings)

`default_tool_timeout_seconds` / `max_tool_timeout_seconds` / `default_tool_timeout_ms` / `browser_tool_timeout_seconds` / `max_browser_tool_timeout_seconds` (all in `agents.py`), `browser_default_timeout_ms` (in `browser.py`, used by the catalogue manifest), and **two new constants** introduced for the magic-number extraction: `IMAGE_GENERATION_TOOL_TIMEOUT_SECONDS_DEFAULT = 90.0` (formerly inline `_IMAGE_TOOL_TIMEOUT_SECONDS`) → `image_generation_tool_timeout_seconds` Field in `image_generation.py`; `DEVOPS_CLAUDE_TOOL_TIMEOUT_SECONDS_DEFAULT = 120.0` (formerly inline `_DEVOPS_TOOL_TIMEOUT_SECONDS`) → `devops_claude_tool_timeout_seconds` Field in `devops.py`. Both new constants follow the new naming convention `<DOMAIN>_<USAGE>_TIMEOUT_<UNIT>_DEFAULT` (existing constants kept under their legacy names — boy-scout for new code only).

`parallel_executor._compute_step_timeout` rewritten to read every value from `settings` (sub-agent floor/ceiling already used `settings.subagent_tool_*` since ADR-083; now the same applies to generic / browser / image / devops). `catalogue_loader.py` reads `settings.default_tool_timeout_ms` (10 manifest sites) and `settings.browser_default_timeout_ms` (1 site) instead of the constants. The constants themselves remain in `constants.py` as the single source of truth for defaults consumed by Pydantic Fields and by the existing `test_parallel_executor_compute_step_timeout.py` matrix (no test rewrite needed).

#### Vague 4 — Hygiene

- Removed dead constants: `HTTP_TIMEOUT_PROMPT_REGISTRY` (defined in `constants.py:788`, **zero call sites**), `BACKGROUND_TASK_TIMEOUT_DEFAULT` (defined in `constants.py:832`, **zero call sites**).
- Resolved the **G1 currency_api duplicate**: removed `http_timeout_currency_api` Field (`connectors.py:343`), the matching constant `HTTP_TIMEOUT_CURRENCY_API` (`constants.py:784`), the env line `HTTP_TIMEOUT_CURRENCY_API` (both `.env.example` and `.env.prod.example`), and the `validate_config.py` range entry. The actually-used `currency_api_timeout_seconds` Field in `advanced.py` (read by `currency_api.py:65`) is the surviving setting. Notes left at the deleted call sites point at the resolution for archaeological clarity.

#### Vague 5 — Wiring `task_orchestrator_execution_timeout_seconds`

The Field was declared in `agents.py:466` and listed in both `.env` files since Sprint 17.4 but **never read**. Wired in `parallel_executor.execute_plan_parallel` as a **soft check at the start of each wave-scheduling iteration** (lines 1346–1370): when `time.time() - start_time` exceeds `settings.task_orchestrator_execution_timeout_seconds`, the loop breaks (no new wave is scheduled) but the in-flight wave is **never violently cancelled** — preserves sub-agents and browser flows that legitimately need their full per-step budget. A `parallel_execution_global_timeout` warning log records the breach with `elapsed_seconds`, `completed_count`, `total_steps`, and the configured timeout. Default 120 s preserved; HITL pauses do not count (LangGraph `interrupt()` exits the function and `start_time` is re-initialised on resume).

`hitl_max_wait_seconds` (declared, 900 s) remains intentionally **non-wired** — kept as an orphan Field documented in TIMEOUT_REGISTRY § 6, pending a product decision (auto-cancel HITL after N minutes vs. soft-watchdog log only vs. delete). Consumers who want this guard today must implement at the application layer.

### Added — TIMEOUT_REGISTRY.md (single source of documentation truth)

[`docs/technical/TIMEOUT_REGISTRY.md`](docs/technical/TIMEOUT_REGISTRY.md) — 12 sections covering every backend timeout with the conventions, every Field's range, default, consumer file, and notes on cascade relationships. Sections cover HTTP outbound (connectors, LLM provider discovery), database / cache, locks, tool execution (`parallel_executor`), conditional / micro-eval, SSE & WebSocket, scheduler, resilience / circuit breaker, agent-level (`react_agent_timeout_seconds`, the now-wired `task_orchestrator_execution_timeout_seconds`, `hitl_max_wait_seconds`), browser, devops. Annex A enumerates the LLM-call timeouts deliberately out of scope (managed by `llm_config` UI). Annex B mirrors the frontend-side timeouts (`apps/web/src/lib/constants.ts`, `apps/web/src/constants/timing.ts`). Annex C explicitly lists known gaps deferred to a future Vague 6: `postgres_statement_timeout`, `app_startup_timeout_seconds` / `app_shutdown_timeout_seconds`, `mcp_session_close_timeout_seconds`, sub-agent / browser / MCP nested-ReAct temporal guards, frontend chat SSE watchdog, APScheduler per-job timeout. The known-conflicts section documents G1 and G2 resolutions for posterity.

### Added — New env vars exposed by the centralization (24 settings, all tunable via `.env`)

Full alphabetical list (every entry has the same default as before — operators can now change them without rebuilding):

| Variable                                         | Default  | Range        | Purpose                                                                                |
| ------------------------------------------------ | -------- | ------------ | -------------------------------------------------------------------------------------- |
| `BRAVE_SEARCH_ENRICHMENT_TIMEOUT_SECONDS`        | `8.0`    | 2.0–60.0     | Wraps Brave cache lookup + HTTP. **Was 3.0 s** — raised to fix G2 inversion.           |
| `BROWSER_DEFAULT_TIMEOUT_MS`                     | `120000` | 30000–600000 | `browser_agent` catalogue manifest default (planner-facing display).                   |
| `BROWSER_TOOL_TIMEOUT_SECONDS`                   | `300.0`  | 30.0–1800.0  | Floor for `browser_task_tool` step timeout.                                            |
| `DEFAULT_TOOL_TIMEOUT_MS`                        | `30000`  | 1000–300000  | Catalogue manifest default for non-browser tools.                                      |
| `DEFAULT_TOOL_TIMEOUT_SECONDS`                   | `30.0`   | 1.0–300.0    | Generic-tool floor in `parallel_executor`.                                             |
| `DEVOPS_CLAUDE_TOOL_TIMEOUT_SECONDS`             | `120.0`  | 30.0–900.0   | `claude_server_task_tool` step floor (formerly inline magic).                          |
| `HEALTH_METRICS_HEARTBEAT_FETCH_TIMEOUT_SECONDS` | `2.0`    | 0.5–30.0     | Safety wrap on health-metrics fetch in heartbeat context.                              |
| `HTTP_TIMEOUT_BRAVE_SEARCH`                      | `5.0`    | 1.0–60.0     | Per-request HTTP timeout.                                                              |
| `HTTP_TIMEOUT_CONDITIONAL_EVAL`                  | `5.0`    | 1.0–30.0     | Jinja conditional evaluation in `parallel_executor`.                                   |
| `HTTP_TIMEOUT_CONNECTOR_LONG`                    | `30.0`   | 1.0–300.0    | Bulk fetches, attachment downloads.                                                    |
| `HTTP_TIMEOUT_CONNECTOR_STANDARD`                | `15.0`   | 1.0–120.0    | Standard connector HTTP ops.                                                           |
| `HTTP_TIMEOUT_PERPLEXITY`                        | `60.0`   | 1.0–180.0    | Perplexity API (deep queries).                                                         |
| `HTTP_TIMEOUT_SSE_POLLING`                       | `30.0`   | 5.0–120.0    | Long-poll on the notifications SSE endpoint.                                           |
| `HTTP_TIMEOUT_WEATHER`                           | `10.0`   | 1.0–60.0     | OpenWeatherMap.                                                                        |
| `HTTP_TIMEOUT_WIKIPEDIA`                         | `15.0`   | 1.0–60.0     | Wikipedia API.                                                                         |
| `HUE_PAIRING_TIMEOUT_SECONDS`                    | `30.0`   | 5.0–120.0    | Philips Hue Bridge pairing handshake.                                                  |
| `IMAGE_GENERATION_TOOL_TIMEOUT_SECONDS`          | `90.0`   | 10.0–600.0   | `generate_image` / `edit_image` step floor (formerly inline magic).                    |
| `MAX_BROWSER_TOOL_TIMEOUT_SECONDS`               | `600.0`  | 60.0–3600.0  | Hard ceiling for `browser_task_tool` (planner cannot exceed).                          |
| `MAX_TOOL_TIMEOUT_SECONDS`                       | `120.0`  | 30.0–600.0   | Hard ceiling for generic tools.                                                        |
| `MCP_OAUTH_HTTP_TIMEOUT_SECONDS`                 | `10`     | 1–60         | MCP OAuth 2.1 helper calls (discovery, token exchange, refresh).                       |
| `OAUTH_LOCK_TIMEOUT_SECONDS`                     | `10`     | 1–120        | Per-(user, connector) Redis lock acquisition for OAuth refresh.                        |
| `OLLAMA_DISCOVERY_TIMEOUT_SECONDS`               | `5.0`    | 1.0–60.0     | `/api/tags` + `/api/show` (NOT a chat completion).                                     |
| `SCHEDULED_ACTIONS_EXECUTION_TIMEOUT_SECONDS`    | `300`    | 30–1800      | Per-action wall-clock (already in `.env`, now in `SchedulerSettings`).                 |
| `SCHEDULED_ACTIONS_STALE_TIMEOUT_MINUTES`        | `10`     | 1–120        | `recover_stale_executing()` threshold (already in `.env`, now in `SchedulerSettings`). |
| `USAGE_LIMIT_WS_IDLE_TIMEOUT_SECONDS`            | `120`    | 30–600       | Idle close on the usage-limits live-update WebSocket.                                  |
| `WEB_FETCH_TIMEOUT_SECONDS`                      | `15.0`   | 1.0–120.0    | `fetch_web_page` tool single HTTP request.                                             |

`scripts/validate_config.py` updated with matching ranges in `INT_VARS` / `FLOAT_VARS` for every new entry. The cross-check `validate_config range == Pydantic Field range` is followed for the Vague 1–3 additions; legacy Fields (`http_timeout_oauth/token/external_api`, `currency_api_timeout_seconds`) keep their pre-migration `gt=0` upper-bound-less form — flagged for alignment in a future hardening pass (audit V3 § A3).

### Removed

- Constant `HTTP_TIMEOUT_PROMPT_REGISTRY` (`constants.py`) — dead code.
- Constant `HTTP_TIMEOUT_CURRENCY_API` (`constants.py`) — duplicate (G1).
- Constant `BACKGROUND_TASK_TIMEOUT_DEFAULT` (`constants.py`) — dead code.
- Field `http_timeout_currency_api` (`connectors.py`) — duplicate (G1). Surviving Field: `currency_api_timeout_seconds` in `advanced.py`.
- Env var `HTTP_TIMEOUT_CURRENCY_API` (both `.env.example` and `.env.prod.example`) — G1.
- Inline magic numbers `_IMAGE_TOOL_TIMEOUT_SECONDS = 90.0` and `_DEVOPS_TOOL_TIMEOUT_SECONDS = 120.0` from `parallel_executor.py` — extracted as named constants + Settings Fields (Vague 3).

### Tests

No test rewriting was necessary: `test_parallel_executor_compute_step_timeout.py` continues to import the constants (`BROWSER_TOOL_TIMEOUT_SECONDS`, `DEFAULT_TOOL_TIMEOUT_SECONDS`, `MAX_BROWSER_TOOL_TIMEOUT_SECONDS`, `MAX_TOOL_TIMEOUT_SECONDS`) as the assertion source — these constants now back the Settings Fields as defaults, so the test matrix passes unchanged. The previously-acknowledged audit V3 § A8 coverage gap is **closed** in this changeset: `tests/unit/domains/agents/orchestration/test_parallel_executor_global_timeout.py` adds two cases that prove the soft check at `parallel_executor.py:1360` (Vague 5 wiring) fires when budget is exceeded (counter increments with `plan_outcome=empty`, structured warning logged) and stays silent when budget is generous. The `parallel_execution_global_timeout_total` Counter was also added in `metrics_agents.py` and incremented at the break point.

### Audit V3 — known follow-ups (intentionally not in this changeset)

The 8-angle rigorous review (cascades, default-vs-range, validate_config-vs-Field, units, semantic duplicates, soft-check edge cases, HITL × timer, test coverage) flagged 8 errors and 8 warnings. Those that remain after the five waves:

- **Cascade browser/sub-agent step ceilings** (1800 / 900 s) can mathematically exceed the parent `task_orchestrator_execution_timeout_seconds` ceiling (600 s). Intentional (preserve sub-agents in flight) but the docstring should explicitly state the soft semantics.
- **`validate_config.py` ↔ Field Pydantic ranges**: realigned end-to-end. The 4 Vague-3 mismatches initially listed here (`DEFAULT_TOOL_TIMEOUT_MS/SECONDS`, `BROWSER_TOOL_TIMEOUT_SECONDS`, `MAX_BROWSER_TOOL_TIMEOUT_SECONDS`) were aligned on the Pydantic Field bounds (single source of enforcement truth). The 4 legacy `gt=0`-only Fields in `connectors.py` (`http_timeout_oauth`, `http_timeout_token`, `http_timeout_external_api`, `apple_connection_timeout`) were also tightened to `ge=1.0, le=60.0` (Apple: `le=120.0`) to match `validate_config.py`. `APPLE_CONNECTION_TIMEOUT` was added to `validate_config.FLOAT_VARS` for completeness. No remaining range divergence between Pydantic and `validate_config.py`.
- **Unit drift** between `default_tool_timeout_seconds` and `default_tool_timeout_ms`, and between `browser_tool_timeout_seconds` (300 s, executor) and `browser_default_timeout_ms` (120 s = 120 000 ms, manifest). No cross-validator.
- **DB column `user_mcp.timeout_seconds`** uses the constant `MCP_DEFAULT_TIMEOUT_SECONDS` as `server_default`, not `settings.mcp_tool_timeout_seconds` — overriding the env at runtime does not update the DB default.
- **Vague 5 soft-check edge cases**: steps not yet scheduled when the check fires generate **no `StepResult`** (silent skip rather than `TIMEOUT` error); no Prometheus metric; no test coverage.

These are tracked in TIMEOUT_REGISTRY.md and are explicit candidates for a future P1-hardening PR.

### Fixed — Gemini 3.x `response.content` shape: planner JSON parse error + 27 latent sites

Switching the `query_analyzer` and `planner` LLM types to `gemini-3.1-pro-preview` surfaced a `smart_planner_panic_failed` with `JSON decode error: Expecting property name enclosed in double quotes: line 1 column 3 (char 2)`. The pipeline degraded to a conversational fallback instead of executing the plan. Root cause: `langchain_google_genai/chat_models.py:933` wraps `response.content` as `list[dict]` (content blocks, like Anthropic) **specifically for Gemini 3.x** — condition `if thought_sig or _is_gemini_3_or_later(effective_model_name)`. Every other provider (Gemini 2.5, OpenAI, Anthropic, DeepSeek, Qwen, Perplexity, Ollama) keeps `response.content` as `str`.

Two pervasive patterns across the codebase silently broke on this shape:

- **Pattern A** — `str(response.content).strip()` (8 sites). `str(list[dict])` produces the **Python `repr()`** of the list (single-quoted keys/values), not valid JSON. The parser error signature (`char 2`) maps exactly to `[` then `{` then `'`.
- **Pattern B** — `X.content if isinstance(X.content, str) else str(X.content)` (20 sites). The `isinstance` branch correctly handles the `str` case, but the `else` branch produces the same Python-repr garbage as Pattern A. Looks defensive, isn't.

The planner failure was loud (JSON parser exception caught and surfaced as `panic_failed`). The other 27 sites would have manifested progressively as Gemini 3.x usage widened to other LLM types — corrupted token counts (`token_counter_service`), garbled message previews (`memory_extractor`, `extraction_service` ×2, `compaction_service`), broken HITL classification (`hitl_classifier`, `item_filter`, `draft_modifier`), wrong summaries (`compaction_service`, `psyche/service`, `heartbeat/prompts`), etc.

Fix: replaced all 28 occurrences with the **LangChain Core 1.2+ official `BaseMessage.text` property**, which handles both shapes — for `str` content it returns the string; for `list[dict]` content it concatenates the `text` blocks and ignores `thinking` blocks. The property returns a `TextAccessor` (a `str` subclass kept for backward compat with the deprecated `.text()` method form), so `isinstance(message.text, str) == True` and runtime behaviour is identical to `content` for the previously-working `str` case. Where MyPy strict mode could not reconcile `TextAccessor` with a later `str` reassignment or `str` return (6 sites), the read is wrapped in `str(...)` — runtime no-op since `TextAccessor` IS-A `str`.

Sites touched (28 occurrences across 21 files):

- `domains/agents/services/smart_planner_service.py` (×2 — single-domain + panic retry)
- `domains/agents/services/planner/strategies/{single_domain,multi_domain}.py`
- `domains/agents/services/compaction_service.py` (×3 — `_extract_identifiers`, `_format_messages_for_summary`, `_summarize_chunk`)
- `domains/agents/services/semantic_pivot_service.py` — also dropped a paranoid `hasattr(result, "content")` fallback since `BaseChatModel.ainvoke` always returns a `BaseMessage`
- `domains/agents/services/token_counter_service.py`
- `domains/agents/services/memory_extractor.py` (×2 — message formatting + LLM-result text)
- `domains/agents/services/hitl_classifier.py`, `…/hitl/item_filter.py`, `…/hitl/draft_modifier.py`
- `domains/agents/nodes/compaction_node.py`, `…/response_node.py`
- `domains/notifications/broadcast_service.py`
- `domains/user_mcp/service.py`
- `domains/journals/extraction_service.py` (×2), `…/consolidation_service.py`
- `domains/interests/services/extraction_service.py` (×2), `…/content_sources/llm_reflection_source.py`, `domains/interests/proactive_task.py`
- `domains/psyche/service.py` (×2 — `psyche_summary`, `psyche_narrative`)
- `domains/heartbeat/prompts.py`

Sites intentionally not touched:

- `domains/agents/nodes/react_nodes.py:551` — already has a custom block-text extractor (`" ".join(block.get("text", "") for block in last_message.content if isinstance(block, dict))`) that works correctly on Gemini 3.x.
- `domains/channels/inbound_handler.py:259` — `chunk` is a custom streaming object (`chunk.type` is `"token"`/`"content_replacement"`/`"error"`/…), not a LangChain `BaseMessage`; `.text` is not available.
- `domains/agents/utils/message_filters.py:251` — `str(msg.content)[:100]` in a debug-log preview; latent but cosmetic only.
- `infrastructure/llm/providers/responses_adapter.py:572/586/595/733` — outbound serialization of messages to the OpenAI Responses API payload, different semantics from reading an LLM response.
- `domains/agents/services/query_analyzer_service.py:1344` + `domains/agents/services/analysis/goal_inferrer.py:116` — defensive `if hasattr(msg, "content")` fallbacks on objects that may not be `BaseMessage`; outside the LLM-response hot path.

Validation: trace `617d5411-1ee6-4b08-9d50-550fe0deddc1` (2026-05-15 17:10) — full Gemini 3.1 Pro Preview pipeline runs end-to-end: `query_analyzer` → `planner_v3_success` (`steps=2`, `used_panic_mode=false`) → `task_orchestrator` → `initiative` → `response` → persist (19 400 tokens, 0.049 EUR). Same query before the fix: `smart_planner_panic_failed` → conversational fallback. Ruff, Black, MyPy strict all pass on the 21 modified files.

## [1.20.5] - 2026-05-14

### Fixed — Sub-agent delegation: vague outputs, runaway exploration, dilution by the response node

After the ADR-083 Phase 2 rewrite of `delegate_to_sub_agent_tool` onto `ReactSubAgentRunner`, observed runs of "as a senior analyst, use a specialized sub-agent" queries surfaced three failure modes that combined to make delegation produce **no measurable value over a direct answer**:

- **`GraphRecursionError` / 47-char final message** — `subagent_default_max_iterations` defaulted to `5`, which LangGraph spends on `2 × call_model + 2 × execute_tools + 1` supersteps. Sub-agents that batched 4-5 parallel searches in pass 1 then ran out of budget for the synthesis pass and exited with a near-empty `final_message` (one observed run: 9 iterations, 31 brave_search calls, **47 chars** returned). Default bumped to `10` (range `1–30`); the per-step ReAct loop now has headroom for ~3-4 tool rounds plus synthesis.
- **80+ tools exposed to the sub-agent** — `resolve_tools_for_subagent` was called with `allowed_tools=[]`, so it fell back to "everything except `SUBAGENT_DEFAULT_BLOCKED_TOOLS`" (~83 read-only tools). Faced with that catalogue, the sub-agent's ReAct loop burns its recursion budget exploring options instead of converging. New whitelist mode wired through `SUBAGENT_RESEARCH_TOOLS_WHITELIST` (default `brave_search_tool,fetch_web_page_tool`) — when set, the resolver becomes an allow-list and the sub-agent stays focused on factual verification.
- **`delegate_to_sub_agent_tool` step killed at 120 s** — the generic `MAX_TOOL_TIMEOUT_SECONDS = 120` is fine for a single API call but starves a slow-reasoning ReAct loop (deepseek with high effort, 3-4 tool rounds + synthesis can legitimately need 90-150 s). Pair of dedicated env vars added — `SUBAGENT_TOOL_TIMEOUT_SECONDS` floor (default `180`, range `30-600`) and `SUBAGENT_TOOL_MAX_TIMEOUT_SECONDS` ceiling (default `300`, range `60-900`) — wired through `parallel_executor._execute_step_with_timeout` via a `tool_name == "delegate_to_sub_agent_tool"` branch so other tools keep the global `MAX_TOOL_TIMEOUT_SECONDS = 120` (unchanged).
- **`response_node` compressing 26 KB of expert analysis to 2 KB and overlaying the principal's voice** — the `<ResponseGuidelines>` rule "do not list/detail results (handled by cards)" is correct for record lists (emails, events) but defeats the purpose of delegation when the payload is a multi-section expert analysis written specifically as the response body. New conditional `<SubAgentDeliveryOverride>` block in `response_system_prompt_base.txt` detects substantial textual analyses (markdown sections + expert voice + cited sources + several thousand characters) and switches the response node to verbatim restitution: no compression, no rewriting in the assistant's conversational personality voice, only a one-sentence intro and 2-3 follow-up suggestions allowed. For non-textual payloads (record lists, action confirmations), `<ResponseGuidelines>` apply unchanged.

### Changed — `subagent_react_prompt.txt` rewritten for delivery discipline

Previous prompt (~17 lines) stated "produce a concise factual analytical text" — too vague. The sub-agent was tempted to over-explore (31 brave_search calls in one observed run) and under-deliver (47-char final message in the same run, 203 chars in another). Rewrite (~65 lines) introduces:

- **Value contract**: "If a knowledgeable assistant could write the same thing without consulting you, you have failed. The bar is what an expert with 10+ years in this domain would produce."
- **Task calibration lexicon**: keywords like _analyse / étude / compte rendu / détaillé / approfondi_ trigger a multi-section structured report; _résumé / brief / concis_ triggers a tight condensation; _comparaison / vs / benchmark_ triggers parallel structure across dimensions. Depth modifiers win on ambiguous wording (e.g. "synthèse détaillée" → deeper form).
- **Epistemic rigor**: cite URLs for every numeric/factual claim, mark inferences explicitly ("Inference:", "Per my analysis:"), name gaps when sources are insufficient instead of fabricating, quote numbers/dates/names exactly.
- **Execution discipline**: 1-3 rounds of tool calls preferred, "5+ parallel searches in one round" called out as a tool-spam tell, "when you have enough material, STOP and write" — soft signal complementing the hard `recursion_limit` cap.
- **Negative voice anchor**: explicitly forbids the principal's conversational tone (sarcasm, orality, "tour de contrôle"/"vieux briscard" rhetoric, first-person banter). The sub-agent is a written expert document; the principal's voice is the principal's.
- **NO markdown tables** — tables are explicitly penalised in `Output style`. For comparisons or multi-dimensional data, the prompt mandates parallel bullet lists, one section per item with the same sub-headings, or inline structured prose. For numeric data, figures are integrated into prose with sources cited inline.
- **Pre-emit self-check** — 6-question checklist (sources cited? inferences marked? depth proportional? expert voice preserved? gaps named? endorsable by a senior practitioner?) before producing the final answer.
- **Explicit anti-patterns** — 7 documented failure modes (e.g. _"announcing 'Voici l'analyse complète' then delivering 47 characters"_) — LLMs exclude better than they prescribe.

### Added — New env vars (4 settings, all tunable via `.env`)

| Variable                            | Default                                 | Range                         | Purpose                                                                                                                |
| ----------------------------------- | --------------------------------------- | ----------------------------- | ---------------------------------------------------------------------------------------------------------------------- |
| `SUBAGENT_TOOL_TIMEOUT_SECONDS`     | `180.0`                                 | 30-600                        | Floor on `delegate_to_sub_agent_tool` step timeout. Replaces the generic 120 s.                                        |
| `SUBAGENT_TOOL_MAX_TIMEOUT_SECONDS` | `300.0`                                 | 60-900                        | Dedicated ceiling — operators can raise the sub-agent budget without touching the app-wide `MAX_TOOL_TIMEOUT_SECONDS`. |
| `SUBAGENT_RESEARCH_TOOLS_WHITELIST` | `brave_search_tool,fetch_web_page_tool` | snake_case CSV                | Tools the ReAct sub-agent may invoke. Empty = legacy blocklist-only behaviour.                                         |
| `SUBAGENT_DEFAULT_MAX_ITERATIONS`   | bumped `5 → 10`                         | 1-30 (ceiling raised from 15) | LangGraph `recursion_limit` of the sub-agent ReAct loop.                                                               |

A Pydantic `field_validator` on `subagent_research_tools_whitelist` rejects malformed values (dashes instead of underscores, semicolons instead of commas, leading digits, uppercase) with a clear error at config-load time — silent typo-induced empty whitelists would otherwise degrade the sub-agent to blocklist-only mode (the known cause of `GraphRecursionError`).

### Tests

- `tests/unit/test_subagent_settings.py` — 21 cases covering defaults (180/300/10), Pydantic ranges (rejected below 30 / above 600 for timeout, below 60 / above 900 for max timeout, above 30 for iterations), the `subagent_research_tools_whitelist_parsed` property (CSV parsing edge cases: trailing comma, whitespace-only entries, single value, empty input), and the new `field_validator` (rejects dashes, semicolons, uppercase, leading digits; accepts empty; accepts default).
- `tests/unit/domains/sub_agents/test_subagent_prompt.py` — 8 cases asserting the rewritten prompt contains the value contract ("materially better", "10+ years"), explicit `NO markdown tables` directive, the task calibration lexicon (analyse / synthèse / résumé / comparaison), the self-check protocol, and explicit anti-patterns. New case for the `<SubAgentDeliveryOverride>` block in `response_system_prompt_base.txt`.

### Documentation

- `docs/technical/SUB_AGENTS.md` — new env vars table (4 settings, ranges, rationale), new `Why dedicated timeout + whitelist` section explaining why the generic `MAX_TOOL_TIMEOUT_SECONDS` was insufficient and why the 80-tool catalogue starved the recursion budget, new `Response Node — Verbatim Delivery Override (2026-05-14)` section documenting the conditional `<SubAgentDeliveryOverride>` block.
- In-app FAQ (`apps/web/locales/*/translation.json`, 6 languages): new `faq.changelog.versions.v1_20_5` entry (3 user/admin items focused on observable quality improvement, no internal implementation details).
- `docs/GETTING_STARTED.md` compatibility line bumped to v1.20.5.
- `README.md` top banner updated to v1.20.5 (v1.20.4 demoted to a `<details>` block).
- Version bumped to `1.20.5` across `apps/api/pyproject.toml`, `apps/web/package.json`, `package.json`, and `apps/web/src/lib/version.ts` (`LAST_UPDATED = 2026-05-14T17:30:00`, shown on the landing page).

## [1.20.4] - 2026-05-12

### Fixed — Browser agent: model 404, premature step kill, AX-tree starvation

- **`claude-opus-4.6` (and `claude-opus-4.5`, `claude-sonnet-4.6`, `claude-haiku-4.5`) → `404 not_found_error`** — the LLM catalogue (`llm_models`, `llm_config_overrides`) and `domains/llm_config/constants.py` stored Anthropic 4.x model ids with a dot (`claude-opus-4.6`), but the Anthropic API only accepts the dashed form (`claude-opus-4-6`, …) — `core/config/llm.py` already used the dashed form. Any LLM type pointed at one of these (e.g. `browser_agent` after the admin picked "Claude Opus 4.6") crashed at instantiation. Renamed to the dashed form everywhere: pricing/config seeds, `mcp_app_react_agent` default, unit tests, frontend i18n strings (`claude-opus-4-5` template label), docs. New Alembic migration `rename_anthropic_model_ids_001` rewrites the existing `llm_models.model_name` / `llm_config_overrides.model` rows (idempotent regex `^(claude-[a-z]+-[0-9]+)\.([0-9]+)$` → `\1-\2`, reversible); DEV migrated, PROD updated via the equivalent in-transaction SQL.
- **`browser_task_tool` step killed mid-task** — the parallel executor wraps each tool step in `asyncio.wait_for(timeout=step.timeout_seconds or DEFAULT_TOOL_TIMEOUT_SECONDS)`, and `browser_task_tool` (a full nested ReAct loop) was absent from `_HIGH_LATENCY_TOOLS`, so the planner's 30/60/120 s `timeout_seconds` cancelled the loop before it could finish (observed step durations: exactly 30 009 / 60 020 / 120 009 ms, then `asyncio.CancelledError` inside `browser_task_tool`). Added `browser_task_tool` to `_HIGH_LATENCY_TOOLS` with a dedicated floor `BROWSER_TOOL_TIMEOUT_SECONDS = 300 s` and ceiling `MAX_BROWSER_TOOL_TIMEOUT_SECONDS = 600 s` (the generic `MAX_TOOL_TIMEOUT_SECONDS = 120 s` no longer applies to it).
- **Accessibility-tree truncation hid form controls** — `BROWSER_AX_TREE_MAX_TOKENS` code default raised `5000 → 15000` (new `BROWSER_AX_TREE_MAX_TOKENS_DEFAULT` constant, referenced from `BrowserSettings`); `.env.example` / `.env.prod.example` updated.

### Added — `BROWSER_REACT_MAX_ITERATIONS`

New env var (default 15, range 1–50) capping the `create_react_agent` `recursion_limit` of the browser agent loop run by `browser_task_tool` — mirrors `REACT_AGENT_MAX_ITERATIONS` / `MCP_REACT_MAX_ITERATIONS`. Constant `BROWSER_REACT_MAX_ITERATIONS_DEFAULT`, field `browser_react_max_iterations` on `BrowserSettings`, wired in `browser_tools.py` (was a hard-coded `15`); `.env.example` / `.env.prod.example` and `BROWSER_CONTROL.md` updated.

### Changed — Browser agent prompt (`prompts/v1/browser_agent_prompt.txt`)

Rewritten from web-research best practices (notably the `browser-use` agent prompt): explicit read-vs-transactional task modes, no fabricated query-param URLs, observe→act→verify loop with a mandatory snapshot after state-changing actions, stale-`[ref]` handling, autocomplete → click-the-suggestion (not Enter), `fill` only on real input controls (textbox/searchbox/combobox/spinbutton), cookie-banner/403/login obstacle handling, stuck-loop detection, stop-before-payment + report-only-facts. `browser_agent_prompt` added to the `PromptName` `Literal` (was missing — pre-existing gap).

### Fixed — `reasoning_effort` ↔ model coherence (robustness on model/provider change)

Switching a model/provider on an LLM type could leave a `reasoning_effort` whose **shape** no longer matched the new model's `reasoning_widget` (e.g. a DeepSeek `{"effort": "off"}` enum value left on a config whose effective model became the Qwen `toggle_budget` default — the admin UI rendered it as "thinking disabled", so it looked fine), which then crashed the typed reasoning builder at `get_llm()` time (`RuntimeError: ... must be ReasoningEffortToggleBudget, got ReasoningEffortEnum. Validation upstream is broken.`). Three layers now prevent this:

1. **Frontend** — the admin dialog normalizes `reasoning_effort` to the newly selected model on `model`/`provider` change: kept only if its shape fits the new `reasoning_widget` (and, for `enum`, the value is allowed), otherwise reset to `null`. New `coerceReasoningEffortForModel` / `reasoningEffortMatchesModel` in `components/settings/llm-config/reasoningHelpers.ts`.
2. **Write path** — `LLMConfigService.update_config` validates `reasoning_effort` against the **effective** model (`update.model`, or `LLM_DEFAULTS[llm_type].model` when the model override is `null`), rejecting an incompatible combination with `422` + structured `ctx`.
3. **Merge runtime** — `core/llm_config_helper.py::merge_config` → new `_reconcile_reasoning_effort` drops any still-incompatible `reasoning_effort` at merge time (stale override row, outdated seed, manual edit, a past bug), falling back to the model's default and logging `llm_config_reasoning_effort_dropped` — `get_llm()` degrades gracefully regardless of the drift's origin.

Shared non-raising predicate `reasoning_effort_matches_widget(caps, value)` (twin of `validate_reasoning_effort`) in `domains/llm_config/reasoning_validation.py` — one source of truth for "is this value valid for this model?", reused by layers 1 and 3.

### Fixed — Production build: stale GeoIP database date

`apps/api/Dockerfile.prod` hard-coded `ARG DBIP_DATE=2026-03` for the DB-IP City Lite GeoIP download; db-ip.com keeps only the last ~2 months online, so the URL started returning `404` ("not in gzip format" after `curl -L` wrote the error page) and `gunzip` failed the production image build. The `geoip-downloader` stage now resolves the latest available month at build time — current month, then the previous one — using `curl -fsSL` (so a 404 cleanly falls through to the next candidate); still overridable with `--build-arg DBIP_DATE=YYYY-MM`. Build-only change, no runtime impact.

### Tests

- `tests/unit/domains/llm_config/test_reasoning_validation.py::TestReasoningEffortMatchesWidget` — none/enum/budget_int/toggle_budget cases incl. the `{"effort": "off"}`-on-Qwen regression.
- `tests/unit/domains/llm_config/test_config_helper.py::TestEffectiveConfigReasoningReconciliation` — incompatible `reasoning_effort` override dropped, compatible kept, unknown model left untouched.
- `apps/web/src/components/settings/llm-config/__tests__/reasoningHelpers.test.ts` — 10 cases for `reasoningEffortShape` / `reasoningEffortMatchesModel` / `coerceReasoningEffortForModel`.
- `test_reasoning_validation.py` / `test_constants.py` / `test_llm_defaults_compliance.py` / `test_reasoning_builders.py` updated for the `claude-opus-4-6` etc. rename.

### Documentation

- `docs/technical/LLM_CONFIG_ADMIN.md` — new "Cohérence `reasoning_effort` ↔ modèle" section (the 3-layer guarantee), `reasoning_validation.py` / `ReasoningWidget.tsx` / `reasoningHelpers.ts` added to the file map, PUT-semantics note.
- `docs/technical/BROWSER_CONTROL.md` — `BROWSER_REACT_MAX_ITERATIONS` + browser step-timeout + `BROWSER_AX_TREE_MAX_TOKENS` notes; new "Agent prompt" section summarising the prompt's behavioural contract.
- In-app FAQ (`apps/web/locales/*/translation.json`, 6 languages): new `faq.changelog.versions.v1_20_4` entry (3 user/admin items); `faq.intro.features.browserControl` blurb refined (multi-step flow, stops at login/payment, reports a summary); `faq.sections.tool_examples_external` q18/q19 refined (multi-step example, "good to know" note, corrected timing). `docs/knowledge/06_external_services.md` propagated from the updated FAQ. `docs/GETTING_STARTED.md` compatibility line bumped to v1.20.4 (with v1.20.1–v1.20.4 highlights). `README.md` top banner updated to v1.20.4 (v1.20.3 demoted to a `<details>` block).
- `README.md` / `docs/technical/LLM_PRICING_TEMPLATES.md` / `docs/guides/GUIDE_CONFIG_ARCHITECTURE.md` / the 6 `apps/web/locales/*/translation.json` — `claude-opus-4.5` → `claude-opus-4-5` in prose/examples.
- Version bumped to `1.20.4` across `apps/api/pyproject.toml`, `apps/web/package.json`, `package.json`, and `apps/web/src/lib/version.ts` (`LAST_UPDATED = 2026-05-12T22:48:00`, shown on the landing page).

## [1.20.3] - 2026-05-08

### Fixed — Itinerary tool resilience against past timestamps

When the user asked "Quel itinéraire pour aller à mon prochain rdv ?", the planner correctly produced a 2-step plan (`get_events_tool` → `get_route_tool`) and the LLM legitimately passed the targeted event's start time as `arrival_time`. If that event had already started — e.g. an in-progress all-day reservation, or a meeting whose start was 30 minutes ago — Google Routes API rejected the call with `400 INVALID_ARGUMENT: "Timestamp must be set to a future time"`, the adaptive replanner retried twice with the same arguments, the step ended in `failed`, and `response_node` synthesised an answer with no route data: no HTML map card, no ETA, just a chatty fallback.

#### Cause

`get_route_tool` forwards `arrival_time` to `GoogleRoutesClient.compute_route` and (for non-TRANSIT modes) reuses it as a `departureTime` proxy to fetch traffic predictions for the same window. `_normalize_departure_time` in `google_routes_client.py` only handled formatting (timezone suffix, `T` separator) — neither tool nor client validated that the value was strictly in the future, which Google Routes mandates.

#### Fix

- New module-level helper `_clamp_to_future_iso(timestamp, *, buffer_seconds=60)` in `apps/api/src/domains/agents/tools/routes_tools.py`. Returns `(timestamp, was_clamped)`. Past values become `now + buffer` (UTC, ISO 8601); genuinely future values are returned unchanged so traffic prediction stays accurate; malformed inputs are returned as-is so Google's own error stays explicit; `None` flows through unchanged.
- Applied to both `departure_time` and `arrival_time` after `normalize_user_datetime` (timezone normalisation) and before the `effective_departure_time` proxy logic for non-TRANSIT modes. Naive timestamps that lost their tzinfo upstream are interpreted as UTC by the helper for safety.
- Each clamp emits a `route_timestamp_clamped_to_now` `WARNING` log with `field`, `original`, `clamped` for observability — surfaces planner mistakes (LLM passing past events) without breaking the user-facing flow.
- `google_routes_client.py` is unchanged; the past/future semantics live in the agent tool, where the timestamp's user-intent is known.

### Tests

6 new unit tests in `apps/api/tests/unit/domains/agents/tools/test_routes_arrival_time.py::TestClampToFutureIso` cover the clamp helper end-to-end:

- `test_returns_none_when_input_is_none` — `None` flows through unchanged
- `test_future_timestamp_is_left_intact` — future timestamps untouched (traffic accuracy preserved)
- `test_past_timestamp_is_clamped_to_now_with_buffer` — past ISO 8601 clamped to `now + 60s ± tolerance`
- `test_naive_past_timestamp_is_treated_as_utc_and_clamped` — defensive handling of naive datetimes
- `test_malformed_timestamp_is_returned_unchanged` — unparsable strings forwarded so the API surfaces the real error
- `test_arrival_time_at_event_already_started_is_clamped` — end-to-end regression for the exact scenario captured from prod logs

### Documentation

- `docs/technical/ROUTES.md` gains a "Past timestamp clamping (v1.20.3)" note next to the existing "Timezone handling" callout, documenting that arrival/departure times in the past are silently clamped to `now + 60 s` and that genuine future intents are preserved.

## [1.20.2] - 2026-05-08

### Added — Voice STT/TTS catalogue, per-message cost attribution, sentence streaming

A four-axis voice rework landing simultaneously: STT distant ElevenLabs, TTS catalogue-driven, per-message TTS cost attribution and sentence-level latency optimisation.

#### Schema (5 Alembic migrations 2026_05_07_0001..0005)

- `pricing_unit_enum` PostgreSQL ENUM added (`per_1m_tokens` / `per_audio_minute` / `per_audio_hour`); the three price columns on `llm_model_pricing` renamed (`input_unit_price`, `output_unit_price`, `cached_input_unit_price`) so the unit can be `per_audio_hour` for ElevenLabs Scribe ($0.22/h) without compromising the chat catalogue. Audit-friendly: prices are stored verbatim, not pre-converted (cf. [ADR-080](docs/architecture/ADR-080-Voice-STT-Remote-Pricing-Unit.md)).
- 5 nullable columns on `conversation_messages` for STT cost attribution: `stt_provider`, `stt_audio_duration_seconds`, `stt_cost_usd`, `stt_cost_eur`, `stt_usd_to_eur_rate`. Partial index `WHERE stt_provider IS NOT NULL` for the export query.
- 4 aggregates on `user_statistics`: `total_stt_audio_seconds`, `total_stt_cost_eur`, `cycle_stt_audio_seconds`, `cycle_stt_cost_eur`. Plus `users.voice_stt_mode VARCHAR(20)` (local/remote preference).
- `'edge'` value added to `llm_provider_enum` (dynamic `pg_attribute` loop migrating every dependent column). `system_settings.voice_tts_mode` row dropped — TTS now lives on `llm_config_overrides.voice_tts` (cf. [ADR-081](docs/architecture/ADR-081-Voice-TTS-Catalogue-Driven.md)).
- 6 nullable columns on `conversation_messages` for TTS cost attribution: `tts_provider`, `tts_model`, `tts_characters`, `tts_cost_usd`, `tts_cost_eur`, `tts_usd_to_eur_rate`. Partial index. Plus 4 aggregates on `user_statistics`: `total_tts_characters`, `total_tts_cost_eur`, `cycle_tts_characters`, `cycle_tts_cost_eur` — symmetric mirror of STT.

#### Voice STT — ElevenLabs Scribe as a remote provider (ADR-080)

- New `voice_transcription` LLM type (`kind=audio`) in `LLM_TYPES_REGISTRY`. Default `provider=elevenlabs, model=scribe_v2`; admin can switch via Configuration LLM. Free Sherpa-onnx Whisper local pipeline kept as the default `voice_stt_mode=local`.
- `SttServiceProtocol` + factory: `SherpaSttService` (local, free) and `ElevenLabsSttService` (remote, $0.22/h) implement the same `transcribe_pcm_int16_async(bytes, sample_rate, language)` interface. ElevenLabs accepts the raw Int16 LE 16 kHz mono buffer via `file_format=pcm_s16le_16` — no WAV wrapping.
- WebSocket ticket extended with `voice_stt_mode` so `/ws/audio` routes without re-querying the DB.
- Per-message STT cost surfaced as a discreet badge `🎤 X.Xs · €X.XXX` on the user bubble; persisted on `conversation_messages.stt_*`. Edge / Sherpa = NULL = no badge.
- Usage limits: `cycle_cost_eur` automatically includes STT via `add_stt_usage()`. Hard cap before each remote call → close 4029 if the cycle limit is hit.
- Push-to-talk decoupled from wake-word: the `voice_stt_mode` switch alone gates remote STT, regardless of `voice_mode_enabled`.
- New CSV exports: `consumption-summary` extended with STT columns; new dedicated `stt-usage` export (admin + user).

#### Voice TTS — catalogue-driven (ADR-081)

- New `voice_tts` LLM type (`kind=tts`) in `LLM_TYPES_REGISTRY`. Voice + provider-specific tuning live in `llm_config_overrides.voice_tts.provider_config` (JSONB), so a single admin form drives provider/model/voice/rate/pitch/volume/speed/voice_settings/output_format.
- Three providers seeded (Edge $0, OpenAI tts-1 / tts-1-hd $15-30, ElevenLabs eleven_multilingual_v2 / eleven_turbo_v2_5 / eleven_flash_v2_5 $50-100 — all per 1M characters). Edge stays free.
- Dynamic voice picker: `GET /admin/voice/voices?provider=X` returns curated lists for Edge/OpenAI and a live `GET /v1/voices` against the configured ElevenLabs account. `voices_read` scope required on the API key.
- Per-message TTS cost: badge `🔊 N chars` on the assistant bubble (paid providers only — Edge stays NULL = no badge). Persisted on `conversation_messages.tts_*` via a double-pass backfill (parallel during streaming + sync fallback after run cleanup) so both PATH 1 (parallel) and PATH 2 (sync direct_tts) populate the row.
- Legacy retired: `system_settings.voice_tts_mode`, the binary Standard/HD switch, the 14 `VOICE_TTS_*` env vars, the `AdminVoiceSettingsSection.tsx` component, and 13 `VOICE_TTS_*_DEFAULT` constants.
- New CSV exports: `consumption-summary` extended with TTS columns; new dedicated `tts-usage` export (admin + user). i18n keys aligned across the 6 supported locales.

#### Voice latency — sentence streaming (ADR-082)

- New `ProgressiveSentenceStreamer` (`apps/api/src/domains/voice/sentence_streamer.py`) — buffers a text token stream, dispatches a TTS task per complete sentence (`[.!?]+` boundary), enforces in-order delivery via `_pending: dict[int, VoiceAudioChunk]` + lock, skips failed slots without blocking the queue, idempotent end-of-stream sentinel.
- Chat mode: agents SSE loop watches `router_decision.intention=conversation` to spin up `VoiceCommentService.start_progressive_chat_stream(...)` and feeds it token-by-token. The user hears the first sentence ~1 s after the question instead of after the full response (~5 s on a 5-sentence response).
- Agent mode: `stream_voice_comment` rewritten to consume the voice-comment LLM via `astream()` (was `ainvoke()`), feeding each chunk into the streamer. First audio lands ~1.5 s after the registry is captured (was ~3.5 s).
- Persistent `httpx.AsyncClient` on `ElevenLabsTTSClient`: ~100–300 ms saved per sentence by skipping TLS handshake on calls #2..N within a request. `OpenAITTSClient` already pooled via the OpenAI SDK; Edge runs through the WebSocket-based `edge-tts` library.
- `_cleanup_chat_voice_pipeline()` helper invoked on every SSE generator exit path (HITL `GraphInterrupt`, top-level `except`, normal end) so the drain task and persistent httpx client are deterministically released.
- Configuration: `voice_chat_mode_max_sentences` clamp raised from `le=6` to `le=50` with an explicit description (3 default conversational, 10 educational, 50 functional ceiling).

### Tests

**46 new backend tests** across 4 dedicated files cover the v1.20.2 voice surface end-to-end:

- `apps/api/tests/unit/domains/voice/test_elevenlabs_stt.py` — **13 tests** on the ElevenLabs Scribe service: PCM Int16 transport (`pcm_s16le_16` payload), language-code filtering (6 LIA ISO-639-1 codes), HTTP error mapping (timeout, 429 with `Retry-After`, 5xx, 422), audio_duration_secs return + STTResult shape, empty-buffer short-circuit.
- `apps/api/tests/unit/domains/voice/test_stt_factory.py` — **11 tests** on the local-vs-remote factory: returns the singleton Sherpa for `mode='local'`, instantiates `ElevenLabsSttService` with the active `voice_transcription` override + ElevenLabs key for `mode='remote'`, raises `STTProviderError(elevenlabs_api_key_missing)` when key absent, `provider_config.base_url` parsing (regional residency override).
- `apps/api/tests/unit/domains/voice/test_sentence_streamer.py` — **12 tests** on `ProgressiveSentenceStreamer`: happy path, trailing flush, max_sentences cap, failed slot skipping, out-of-order arrival reordering, cancel_pending, empty stream, feed-after-close guard, on_chars_synthesized callback (called + throw swallowed), `first_audio_latency_seconds` property, MIME fallback for non-mp3 audio formats.
- `apps/api/tests/unit/infrastructure/test_pricing_cache_audio.py` — **10 tests** on `get_cached_cost_audio_usd_eur`: per_audio_hour math, per_audio_minute math, mismatched pricing_unit returns (0, 0) + warning, Decimal precision over varied durations (0.5 s / 1 s / 60 s / 3600 s), missing model in cache, EUR conversion via cached usd_eur_rate.

The 46 new tests run inside the existing pytest collection (9992 total tests) — no new markers, no new fixture files. Coverage includes the column rename refactor (input_unit_price / output_unit_price / cached_input_unit_price across 4 modified files in `tests/integration/test_llm_admin_routes.py`, `tests/unit/domains/llm/test_schemas_reasoning.py`, `tests/unit/domains/llm/test_service.py`, `tests/helpers/llm_helpers.py`) which keeps the ADR-080 schema migration verifiable.

### Changed

- `LLMTypeConfigUpdate.provider` Literal extended with `'elevenlabs'` and `'edge'` (PUT used to fail 422 on these providers).
- `TrackingContext` gains a `_tts_records: list[TTSUsageRecord]` bucket + `record_tts_call(provider, model, characters)`. The legacy `_track_tts_cost → record_node_tokens(node_name='tts_hd')` path retired (TTS no longer mixed in `token_usage_logs` with chat nodes).
- `archive_message` accepts 6 `tts_*` kwargs and `update_message_tts` is added on the repository for the post-voice backfill (TTS finalises after `archive_message` runs in the parallel mode).
- `TokenSummaryDTO` extended with `tts_cost_eur` so the SSE `done` chunk's consolidated `cost_eur` includes TTS — the live frontend badge sees the correct grand total without waiting for a reload.
- `tracker.commit()` early-return guard now checks `pending_tts > 0` too — without this, the sync-fallback voice flow (chat mode without parallel) would skip `_persist_to_database`.
- `LLMConfigOverrideCache` now persists `provider_config` (was already in the schema but the cache was missing it).
- `AUDIO_MIME_TYPES` and `DEFAULT_AUDIO_MIME_TYPE` extracted to `voice/schemas.py` (was duplicated between `voice/service.py` and `voice/sentence_streamer.py`).

### Fixed

- HTTP 402 on ElevenLabs library voices surfaced as a clear "ElevenLabs paid plan required" hint when a non-premade voice is selected on a free account.
- Prometheus counters on `ElevenLabsTTSClient` aligned on `["voice_name"]` / `["error_type", "voice_name"]` (the previous `provider`/`model` labels caused `Incorrect label names` runtime errors that silently broke every ElevenLabs synthesis).
- `voice_chunk_queue` race condition: when a chat-mode streamer was active and the registry appeared mid-stream, the agent-mode parallel task would create a new queue and silently drop the chat audio. Now mutually exclusive via `chat_voice_drain_task is None` guard.
- Sentinel duplicated when `cancel_pending()` and the last task's `done_callback` raced for the queue close — now flagged via `_sentinel_pushed`.
- `feed_task` (LLM streaming feeder) leaked on `CancelledError` and on `Exception` paths in `stream_voice_comment` — now cancelled and awaited via `_abort_voice_comment_pipeline`.
- `chat_voice_drain_task` leaked on `GraphInterrupt` (HITL fallback) — now cleaned up via the shared `_cleanup_chat_voice_pipeline` helper.

### Removed

- `system_settings.voice_tts_mode` row + DB enum entry.
- `VoiceTTSMode` Literal (`Literal["standard", "hd"]`) and the 14 settings on `VoiceSettings` it gated (`voice_tts_default_mode`, `voice_tts_standard_*` × 6, `voice_tts_hd_*` × 7).
- `REDIS_KEY_VOICE_TTS_MODE` constant; `VoiceTTSModeCache` Redis service; `get_voice_tts_mode()` / `invalidate_voice_tts_mode_cache()` module functions; `voice_tts_mode_cache_total` Prometheus counter.
- 13 `VOICE_TTS_*_DEFAULT` constants from `core/constants.py`.
- `apps/web/src/components/settings/AdminVoiceSettingsSection.tsx` (replaced by Configuration LLM admin form, type `voice_tts`).
- Two unused settings on `VoiceSettings` retired: `elevenlabs_stt_api_base_url` and `elevenlabs_stt_request_timeout_seconds`. The model, regional `base_url` and per-call timeout already live on `llm_config_overrides.voice_transcription` (admin UI), so the duplicate `.env` knobs were dead config. Both `.env.example` and `.env.prod.example` lines removed.

### Hardening — voice domain audit remediation

Follow-up pass on the voice rework above to close cost-defence gaps, structure provider errors, and align cross-cutting documentation with the catalogue-driven model.

- **Cost-spike defence: STT remote duration cap actually enforced.** The `ELEVENLABS_STT_MAX_AUDIO_DURATION_SECONDS` setting (default 300 s) was declared earlier in this same release but never checked at runtime. The WebSocket handler now rejects oversized clips before any provider call (close code 4002 with `audio_too_long` reason; explicit error chunk to the frontend). New constant `STT_BYTES_PER_SECOND_AT_16KHZ_INT16 = 32000` derives the duration from the raw byte buffer without parsing the PCM stream.
- **Cost-spike defence: STT remote kill switch wired.** `ELEVENLABS_STT_ENABLED=false` now actually disables remote STT at the WebSocket entry point — instant fallback to Sherpa-onnx local for incident response or quota emergencies. Previously the flag existed in config but was ignored.
- **Structured TTS errors across all 3 providers.** New `TTSProviderError` (`apps/api/src/domains/voice/exceptions.py`) mirrors `STTProviderError`. Edge / OpenAI / ElevenLabs clients now raise typed errors with stable codes (`api_key_missing`, `provider_timeout`, `provider_rate_limited`, `provider_http_error`, `provider_invalid_response`, `provider_network_error`); ElevenLabs HTTP 429 carries `retry_after_seconds` from the `Retry-After` header. `RuntimeError` removed from every TTS code path. Frontend toasts can now match on `code` for precise i18n.
- **`admin_router.py` raw `HTTPException` calls replaced** by centralized raisers (`raise_invalid_input` / `raise_external_service_fetch_error`) for consistency with the rest of the API surface.
- **Configurable sentence boundary in the streamer.** `ProgressiveSentenceStreamer.__init__` now accepts a `sentence_delimiters` argument; the regex is built per-instance via `_build_sentence_end_regex(delimiters)` and follows `settings.voice_sentence_delimiters` (admin-tunable). Latin punctuation (`.!?`), Chinese `。！？`, Arabic `؟` etc. all supported when configured.
- **Magic constants extracted.** `VOICE_TTS_MS_PER_CHAR_HEURISTIC = 80` now lives in `core/constants.py` as the single source of truth used by both `voice/service.py` and `voice/sentence_streamer.py` for the `duration_ms` UI hint. `voice_comment_prompt` added to the `PromptName` Literal so MyPy strict catches any future typo.

### Documentation

- New ADRs: [ADR-080](docs/architecture/ADR-080-Voice-STT-Remote-Pricing-Unit.md), [ADR-081](docs/architecture/ADR-081-Voice-TTS-Catalogue-Driven.md), [ADR-082](docs/architecture/ADR-082-Progressive-Sentence-Streaming.md).
- ADR-050 (legacy Voice TTS architecture) marked as superseded by ADR-081.
- [docs/technical/VOICE.md](docs/technical/VOICE.md) v4.1: catalogue-driven config + per-message attribution + sentence streaming sections.
- [ADR-039](docs/architecture/ADR-039-Cost-Optimization-Token-Management.md) enriched with a "Voice silos (TTS / STT) — separate cost surfaces" section that contrasts the chat token-tracking pipeline with the audio-billed (`per_audio_hour`) and character-billed (`per_1m_tokens`) silos used by STT and TTS.
- Catalogue-driven TTS narrative propagated across 12 how/why guides (en/fr/de/es/it/zh) — obsolete "Standard / HD" + "Gemini TTS" mentions retired in favour of the three-provider description (Edge / OpenAI / ElevenLabs).
- Cross-cutting docs realigned: `README.md`, `docs/ARCHITECTURE.md` (line 99 + voice-flow diagram), `docs/GETTING_STARTED.md` (feature/mode tables), `CONTRIBUTING.md` (config map), `docs/INDEX.md` (VOICE.md description), `docs/knowledge/03_settings.md` and `docs/knowledge/20_voice_mode.md` (user-facing voice description). `CLAUDE.md` ADR count updated (75 ADRs).
- Module docstring on `metrics_voice.py` rewritten for multi-provider TTS — explicitly explains why no `provider` label is added (Prometheus rejects extra labels post-instantiation; provider derivable from voice_id naming pattern).
- 6 locale files updated with parity for `tts_usage_title`, `tts_usage_description`, `voiceTts.*` keys.

## [1.20.1] - 2026-05-06

### Added — LLM admin: per-model sampling matrix + reasoning shape templates

Two complementary refinements on the admin LLM catalogue introduced in v1.19.0 ([ADR-078](docs/architecture/ADR-078-LLM-Catalogue-DB-Source-Of-Truth.md)). Both target the same principle: every form input must reflect what the API actually accepts ("raw truth"), and every behavioral group must be reusable as a template instead of re-typed by hand.

#### Schema

- New columns on `llm_models` (4 sampling caps, all NOT NULL with permissive `True` defaults): `supports_temperature`, `supports_top_p`, `supports_frequency_penalty`, `supports_presence_penalty`. Migration `2026_05_06_0002-llm_sampling_flags.py` backfills the verbatim 96-model matrix and reconciles `is_reasoning_model` with `reasoning_widget` (37 stale rows fixed).
- New columns on `llm_models` (5 reasoning shape fields, materialised in v1.20.0 prep): `kind` (chat / image / audio / realtime / tts / embedding), `reasoning_widget` (none / enum / budget_int / toggle_budget), `reasoning_enum_values` (JSONB list, when widget=enum), `reasoning_budget_range` (JSONB `{min, max, off_sentinel, dynamic_sentinel}`), `reasoning_doc_i18n_key`. Migration `2026_05_06_0001-llm_reasoning_overhaul.py` covers the rollout + 25 row deletions (retired/fictional models).

#### Configuration LLM dialog (admin)

- Sampling parameter sliders (`temperature`, `top_p`, `frequency_penalty`, `presence_penalty`) now appear or hide **per individual parameter** based on the selected model's DB caps, replacing the previous global `showSamplingParams` heuristic. Example: Anthropic 4.5+ models surface only the temperature slider; DeepSeek V4 surfaces all four; GPT-5 series surfaces none. The `reasoning_widget` value drives the widget shape (enum select, integer budget, or toggle+budget) so the dialog never lets the operator pick a value the API would reject.
- Card badges on the type list use `reasoning_widget !== 'none'` (instead of the bare `is_reasoning_model` flag) to decide whether to render `E:effort`, and `supports_temperature` to decide `T:temp` — covering the deepseek-reasoner edge case (always-on reasoning, no level control) without false positives.

#### Pricing LLM dialog (admin)

- New section **"Reasoning & sampling"** in the model add/edit modal. Layout: `kind` Select → 4 sampling toggles → `Is reasoning model` toggle that gates the reasoning-shape controls below.
- New endpoint `GET /admin/llm/reasoning-templates` returns the deduplicated set of unique reasoning shapes present in `llm_models` (~15 templates today, e.g. `enum [low/medium/high]` (14 models, like claude-opus-4.5), `enum [minimal/low/medium/high]` (5 models, like gpt-5), `toggle+budget 0..32768` (4 models, like qwen3-max), `no reasoning` (55 models)). The set self-enriches: any model created in Custom mode with a novel fingerprint becomes available as a template on subsequent calls.
- **Template mode (default)**: the admin picks a representative model from the dropdown — the 4 reasoning shape fields are snapshot-copied at create time. **Custom mode (advanced)** unlocks manual entry for disruptions / brand-new families. `kind`, the four `supports_*` sampling flags and `reasoning_doc_i18n_key` are always saved per model regardless of the template choice — keeping model nature, per-parameter API acceptance and tooltip key independent from the shared reasoning shape.
- At edit time, the modal pre-selects the template whose fingerprint matches the current row, or falls back to "Custom" if none matches.

#### Backend

- Service `LLMModelService.list_templates()` groups active rows by a 4-field fingerprint (`is_reasoning_model`, `reasoning_widget`, `reasoning_enum_values`, `reasoning_budget_range`) and returns one deterministic representative per group. The fingerprint is derived from a single source of truth `_TEMPLATE_FIELDS` so adding a 5th shape field requires no parallel edit.
- Schemas `ModelPriceCreate` / `ModelPriceUpdate` enforce template-mode XOR custom-mode at validation time. `model_validator(mode="after")` rejects mixing `reasoning_template` with explicit reasoning shape fields, and validates widget cohesion (`enum` requires `enum_values`, `budget_int`/`toggle_budget` requires `budget_range`, `none` forbids both).
- New `UnknownReasoningTemplateError(LookupError)` exception — subclass of `LookupError` so legacy `except LookupError` catches keep working, but the router catches it BEFORE plain `LookupError` to translate it to `400 invalid_input` (distinct from the `404 not_found` used when the model being updated does not exist, and from the `409 already_exists` raised on duplicate `model_name`).
- Audit log on create/update enriched with `kind`, `reasoning_template` (slug or null in Custom mode), `reasoning_widget` (post-update for forensic search). The structured log line follows.

### Changed

- `LLMModelRepository.create_model()` signature now requires the 9 new fields (`kind`, `reasoning_widget`, `reasoning_enum_values`, `reasoning_budget_range`, `reasoning_doc_i18n_key`, `supports_temperature`, `supports_top_p`, `supports_frequency_penalty`, `supports_presence_penalty`) as explicit kwargs. Test fixtures get a `_DEFAULT_REASONING_KWARGS` constant for the non-reasoning baseline.
- Frontend pricing form helpers (`buildReasoningSamplingPayload`, `fingerprintMatches`, `parseEnumValuesCsv`, `formatEnumValuesCsv`) extracted to `apps/web/src/components/settings/admin-llm-pricing-helpers.ts` so they can be unit-tested independently of the React component.

### Fixed

- **Configuration LLM sampling sliders** — Anthropic 4.5+ models (claude-opus-4.5, claude-sonnet-4.6, claude-haiku-4.5, claude-opus-4.6) used to hide the temperature slider whenever `reasoning_effort` was set; they now correctly expose only the temperature input (no top_p, no penalties) at all times. DeepSeek V4 family (`deepseek-v4-flash`, `deepseek-v4-pro`) used to hide all four sliders behind the `enum` widget; they now surface all four. Qwen 3.x toggle+budget models still expose temperature/top_p/presence_penalty but hide frequency_penalty (matrix-driven).
- **Pricing admin error semantics** — passing an unknown `reasoning_template` to `POST /admin/llm/pricing` or `PUT /admin/llm/pricing/{name}` previously surfaced `409 already_exists` (overloaded `except ValueError`). Now returns `400 invalid_input` with the original message ("reasoning_template 'X' does not exist in llm_models"), so the admin sees which template name was wrong.
- **Stale `is_reasoning_model` flag in the pre-PR seed** — 37 rows in `llm_models` had `reasoning_widget != 'none'` but `is_reasoning_model = false`. Migration `2026_05_06_0002` reconciles the two: `is_reasoning_model = (reasoning_widget != 'none') OR model_name = 'deepseek-reasoner'`. Special case kept for deepseek-reasoner (always-on reasoning with no level control: widget='none' but is_reasoning=true).

### Documentation

- New: `docs/technical/LLM_PRICING_TEMPLATES.md` — Template/Custom modes, snapshot semantics, fingerprint dedupe, FAQ on edge cases (deepseek-reasoner, doc_i18n_key exclusion, post-create template edits). Indexed in `docs/INDEX.md` under "Cost Tracking & Billing".
- Updated docstrings on `ModelPriceCreate` / `ModelPriceUpdate` / `_copy_from_template_row` / `create()` / `update()` — every Raises clause now lists which exception maps to which HTTP code (`ValueError → 409`, `LookupError → 404`, `UnknownReasoningTemplateError → 400`).

### Tests

- Backend: 33 new schema validators tests (`test_schemas_reasoning.py`), 21 service helper tests (`test_service_helpers.py`, pure — no DB), 10 router structural tests (`test_router.py`), 9 service integration tests extended (`test_service.py`). All run on Postgres in CI; pure tests run anywhere.
- Frontend: 27 vitest tests on the extracted helpers (`__tests__/admin-llm-pricing-helpers.test.ts`) covering Template / Custom / Non-reasoning branches of `buildReasoningSamplingPayload`, fingerprint matching, CSV round-trip.

## [1.20.0] - 2026-05-06

### Added — Stratified Journal Consciousness ([ADR-079](docs/architecture/ADR-079-Stratified-Journal-Consciousness.md))

The personal journal (introduced in [ADR-057](docs/architecture/ADR-057-Personal-Journals.md), refined by [ADR-064](docs/architecture/ADR-064-Journal-Analyst-Persona.md) and [ADR-069](docs/architecture/ADR-069-Gemini-Embedding-Migration.md)) becomes a stratified meta-cognition organ. Four abstraction levels, deferred self-evaluation, ambient diffusion of a compiled user-model portrait across eight flows where LIA speaks.

#### Schema

- New columns on `journal_entries` (all nullable / server_default — fully reversible): `level VARCHAR(2) DEFAULT 'L1'`, `confidence VARCHAR(10) DEFAULT 'medium'`, `evidence_count INT DEFAULT 0`, `contradiction_count INT DEFAULT 0`.
- New columns on `users` (nullable): `journal_portrait_full TEXT`, `journal_portrait_brief TEXT`, `journal_portrait_compiled_at TIMESTAMPTZ`.
- New `JournalEntrySource` value: `user_correction` (created by lever 2 feedback).
- New enums: `JournalEntryLevel` (L0/L1/L2/L3), `JournalEntryConfidence` (low/medium/high).
- Migration: `2026_05_05_journals_stratified.py` — single file, 3 logical steps, reversible.

#### Stratification

- **L0** — raw observation, pre-directive. Rare, ephemeral, ~200c.
- **L1** — operational directive `WHEN [context] → DO [action] (BECAUSE [evidence])`. Default at extraction, ~500c.
- **L2** — transversal pattern, synthesis of convergent L1 directives. Consolidation only, ~700c.
- **L3** — portrait facet (traits, current phase, contexts, contradictions, blind spots, evolution). Consolidation only, feeds the user-model portrait.
- L2/L3 are produced exclusively by consolidation through active topic clustering (STEP 5 of `journal_consolidation_prompt.txt`).

#### Deferred self-evaluation T → T+1

- `MessagesState` carries `injected_journal_ids` between turns (symmetric to `injected_memories`).
- `response_node` reads the previous turn's IDs at start, passes them to the post-conversation extractor, then writes the current turn's IDs to state.
- Extractor sees the directives that were just applied and the user's reaction in the same prompt; the LLM signals `evidence_outcome="evidence" | "contradiction"` on update actions.
- Service atomically increments `evidence_count` / `contradiction_count` (anti-hallucination layer 4: LLM never writes absolute counter values).
- Zero additional LLM calls — same extractor, just enriched prompt.

#### User-model portrait (ambient diffusion)

- Consolidation now produces, in the same LLM call (zero additional cost), a `portrait_full` (~200 tokens, conversation/planner) and `portrait_brief` (~60 tokens, secondary flows) persisted on the `users` table.
- New standalone builder `journals/portrait_builder.py:build_journal_user_model_block(user_id, format, flow)` — symmetric to `psyche/service.py:build_psyche_prompt_block`. Returns a `<UserModelContext>...</UserModelContext>` block or empty string with graceful degradation.
- Diffused across eight flows: 2 primary in full format (`response_node`, `planner_node_v3`) and 6 secondary in brief format (`react_setup_node`, `interests/proactive_task`, `scheduler/reminder_notification`, `voice/service`, `heartbeat/prompts`, `agents/services/fallback_response` sync + async).

#### User correction (three levers)

- **Lever 1** — edit/delete L3 source entries via existing CRUD; portrait recompiles next consolidation.
- **Lever 2** — `POST /journals/portrait/feedback` (free-text + optional highlighted section). Creates an L0 entry with `source=user_correction`, then triggers a synchronous consolidation (~5–10 s) that re-weights L3 entries with the user signal pinned at top of the prompt.
- **Lever 3** — `POST /journals/consolidate`. Bypasses cooldown; runs the standard consolidation pass on demand.
- Portrait itself is intentionally **not directly editable**.

#### API endpoints

- `POST /journals/consolidate` — manual consolidation (lever 3).
- `GET /journals/portrait` — read full + brief + `compiled_at`.
- `POST /journals/portrait/feedback` — submit correction (lever 2).
- `GET /journals/export` — now includes the compiled portrait under `portrait` key.
- `PATCH /journals/{id}` — accepts `level` and `confidence` for manual overrides.

#### Observability

- 11 new Prometheus metrics in `infrastructure/observability/metrics_journals.py`: `journal_entries_total{action,theme,source}`, `journal_extraction_duration_seconds{outcome}`, `journal_zero_injection_age_days`, `journal_evidence_total{outcome}`, `journal_consolidation_promotions_total{from_level,to_level}`, `journal_level_distribution{level}`, `journal_dedup_actions_total`, `journal_portrait_compile_duration_seconds`, `journal_portrait_present_total{flow,format}`, `journal_portrait_age_hours`, `journal_portrait_feedback_total{outcome}`.

#### Frontend

- `JournalsSettings.tsx`: dedicated section "Comment LIA te perçoit" with full/brief tabs (read-only), 🚩 feedback dialog, 🔄 manual consolidation button.
- Per-entry badges: confidence (low/medium/high), level (L0/L1/L2/L3), `uses` counter, `last_inj` date.
- Group-by toggle (Theme | Level), filter "show only entries never used", `level` and `confidence` editable in create/edit dialogs.
- New env var `NEXT_PUBLIC_JOURNAL_CONSOLIDATION_TIMEOUT_MS` (default 240 000 ms / 4 min) — configurable client timeout for the lever-3 button.

#### Internationalization

- ~38 new keys per locale (en / fr / de / es / it / zh) — confidence labels, level labels + descriptions, group-by, consolidate, portrait section, feedback dialog. Parity verified.

#### Cleanup

- Removed dead code: `journal_dedup_similarity_threshold` setting, `JOURNAL_EXTRACTION_RECENT_ENTRIES_FULL` constant, `archive_entry()` service method, `journal_merge_prompt.txt` orphan prompt. The historical write-time dedup guard (v1.12.1) was already retired in favor of mandatory dedup at consolidation (ADR-064 STEP 1, extended by ADR-079 active pairwise scan).
- `.env.example` / `.env.prod.example` updated.

#### GDPR

- Account deletion (`users/account_deletion_service.py:_mark_user_deleted`) now scrubs the three portrait columns alongside existing user data.
- Export endpoint enriched with the portrait payload.

#### Tests

- 50 new tests covering the stratified mechanism: 4 unit files (`test_models.py` extended, `test_portrait_builder.py`, `test_levels_promotions.py`, `test_self_evaluation.py`) and 1 integration file (`test_journal_full_cycle.py`, real Postgres). 86 unit tests + 8 integration tests passing in under 6 s.

### Changed — Prompt engineering pass on the journal LLM calls

- **Extraction prompt** (`journal_introspection_prompt.txt`):
  - Added a `STEP 0` to the decision tree explicitly handling ambiguous / not-yet-actionable signals → `L0` instead of forcing a half-baked `L1`.
  - Section 4 (abstraction levels) rewritten with three concrete `L0` examples and a "when in doubt → L0" rule.
  - Quality gate broadened to two clauses: "(a) will change my future response" OR "(b) weak signal worth tracking".
  - Self-audit (section 9) gains an "L0 sweep" step + a "downgrade fuzzy L1 to L0" check + a healthy distribution target across themes AND levels.
- **Both prompts** (`journal_introspection_prompt.txt`, `journal_consolidation_prompt.txt`):
  - Removed all language-specific examples (French / English mentions, "svp"/"stp", `"réunion"`, `"bon"`, `"concision et réponse ciblée"`, `"ton sobre face à la vulnérabilité"`). Replaced by language-agnostic equivalents — every input is now translated to English by the semantic pivot before reaching the LLM, so prompts must not anchor on a specific language.

### Fixed

- **Debug panel "Background Extraction" sub-section** — partial-update actions (where the LLM omits unchanged fields) used to display only the truncated UUID instead of the entry title/theme/mood. The backend now backfills the debug payload from the existing entry before streaming, so the panel reads `UPDATE 📓 Prefer concise replies` instead of `UPDATE 1ac9a75a`.
- **Manual consolidation timeout** — the new `/journals/consolidate` button is now backed by a configurable client timeout (`NEXT_PUBLIC_JOURNAL_CONSOLIDATION_TIMEOUT_MS`, default 4 min) so heavy reasoning models don't trip a premature client cancel.

## [1.19.1] - 2026-05-05

### Added — DeepSeek V4 family + parameterizable provider base URLs

DeepSeek released the V4 model family (`deepseek-v4-flash`, `deepseek-v4-pro`)
with first-class thinking-mode toggle: same model invoked with or without
chain-of-thought reasoning per request. This release wires V4 into the
admin-facing catalogue introduced in v1.19.0, with the necessary adapter
plumbing, a frontend constraints update, and a workaround for an
upstream `langchain-deepseek` bug.

#### Catalogue (admin-facing)

- **2 new entries** in the seed for fresh installs: `deepseek-v4-flash` and
  `deepseek-v4-pro` — both with `provider=deepseek`,
  `max_input_tokens=1_000_000`, `max_output_tokens=384_000`,
  `supports_tools=true`, `supports_structured_output=true`,
  `supports_streaming=true`, `is_reasoning_model=true`. Pricing seeded
  with the official DeepSeek tariffs (cache hit rate is unusually high:
  ~50× cheaper for flash, ~120× cheaper for pro).
- The seed now ships **121 chat models** (was 119); the trailing
  `RAISE WARNING` guard updated.
- Existing `deepseek-chat` (V3) and `deepseek-reasoner` (R1) entries
  preserved for backward compat — DeepSeek transparently routes those
  legacy names to V4 on their backend per upstream community
  confirmation, but admins are encouraged to deactivate them via the
  catalogue (`is_active=false`) once migrated to V4.

#### Adapter (`apps/api/src/infrastructure/llm/providers/adapter.py`)

- New branch in `_create_deepseek_llm` for V4: maps
  `reasoning_effort` from LIA's 6-level UI scale to DeepSeek's
  `extra_body.thinking.type` + `reasoning_effort` API fields.
  - `none` → `{"thinking": {"type": "disabled"}}`
  - `minimal`, `low`, `medium` → `{"thinking": {"type": "enabled"},
"reasoning_effort": "high"}`
  - `high`, `xhigh` → `{"thinking": {"type": "enabled"},
"reasoning_effort": "max"}`
- Sampling parameters (`temperature`, `top_p`, `frequency_penalty`,
  `presence_penalty`) are stripped locally when thinking is on — the
  V4 API silently ignores them otherwise; stripping makes the request
  log faithful to what the model actually consumes.
- `max_tokens` cap raised to 64 000 for V4 (matches the API
  documentation for the family).

#### Frontend (`apps/web/src/components/settings/AdminLLMConfigSection.tsx`)

- `getModelConstraints` deepseek case extended: V4 models gated on
  the catalogue's `is_reasoning_model` flag expose the
  `reasoning_effort` dropdown with `['none', 'low', 'medium', 'high']`.
- V3 deepseek-chat/deepseek-reasoner unchanged.

#### Provider base URLs are now per-deployment configurable

- New env vars `PERPLEXITY_BASE_URL` and `QWEN_BASE_URL` (consistent
  with the existing `OLLAMA_BASE_URL` convention).
- New helper `_get_base_url(provider)` in the adapter: env-first
  resolution with documented vendor defaults as fallback.
- Documented use cases: regional endpoints (e.g. Qwen US ↔ CN
  DashScope), self-hosted OpenAI-compatible gateways, mock servers
  for tests — all with no code change required.
- Templates updated: `.env.example`, `.env.prod.example`,
  `.env`, `.env.prod`. `.env.min.prod` deliberately skipped (its
  philosophy delegates provider configuration to the admin UI).

### Fixed

- **Structured output via forced `tool_choice` rejected by V4 with
  thinking on.** The DeepSeek API returns
  `400 - 'deepseek-reasoner does not support this tool_choice'` even
  for requests targeting `deepseek-v4-flash` / `deepseek-v4-pro`,
  because thinking-mode requests are routed to a reasoner-style
  backend that rejects forced tool selection. New helper
  `_is_v4_thinking_enabled(llm)` in `structured_output.py` detects
  this combination and **transparently downgrades to the JSON-mode
  fallback** (which uses `response_format={"type": "json_object"}`
  and does not use `tool_choice`). Schema conformance is enforced by
  Pydantic on our side. The fix is fully automatic — nodes that need
  structured output (`query_analyzer`, `semantic_validator`,
  `planner`, `hitl_classifier`...) now work with V4 thinking on.
- **`reasoning_content` round-trip in tool flows on V4.** The pinned
  `langchain-deepseek==1.0.1` (and current upstream master) does NOT
  inject prior `AIMessage.additional_kwargs["reasoning_content"]`
  back into the request payload's assistant messages. The DeepSeek
  V4 API rejects multi-turn tool flows that omit it with
  `400 invalid_request_error: 'The reasoning_content in the thinking
mode must be passed back to the API.'`. Six upstream PRs over six
  months attempting this fix have not been merged. Local subclass
  `ChatDeepSeekPatched`
  ([`apps/api/src/infrastructure/llm/providers/_deepseek_patched.py`](apps/api/src/infrastructure/llm/providers/_deepseek_patched.py))
  overrides `_get_request_payload` with the round-trip logic. The
  patch is unconditional (no-op when `additional_kwargs` is empty),
  so it has zero effect on V3 or thinking-disabled V4 calls. To be
  removed once `langchain-deepseek` ships the round-trip natively
  (tracking [issue #37178](https://github.com/langchain-ai/langchain/issues/37178)).
- **Misleading `reasoning_effort_unsupported_provider` warning for
  DeepSeek.** `LLMAgentConfig.validate_reasoning_effort` whitelisted
  only `{openai, anthropic, gemini, qwen}` and logged a misleading
  warning whenever `reasoning_effort` was set on a DeepSeek node.
  V4 supports `reasoning_effort` natively at the adapter level, so
  `deepseek` is now in the supported set and the warning message is
  reformulated to reflect the 5 thinking-capable providers.

### Tests + tooling

- 18 new unit tests in
  [`apps/api/tests/unit/infrastructure/llm/providers/test_deepseek_patched.py`](apps/api/tests/unit/infrastructure/llm/providers/test_deepseek_patched.py)
  covering the round-trip patch (7 tests), the V4 thinking mapping in
  the adapter (5 tests), and the `_is_v4_thinking_enabled` detector (6
  tests). All pass.
- Pre-commit hook still green.

### Documentation

- ADR-078 — _LLM Catalogue DB-Source-of-Truth_ — extended with a
  concrete _Adding a new provider_ worked example using DeepSeek V4
  to illustrate the catalogue extension pattern.
- New section in `docs/technical/LLM_PROVIDERS.md` —
  _DeepSeek V4 — `reasoning_content` round-trip patch_ — explains
  the upstream bug, the local fix, the criteria for removal, and
  cross-references issue #37178 / PR #37179.
- `docs/technical/LLM_PROVIDER_CONSTRAINTS.md` — new V4 row in the
  parameter compatibility table with footnote ⁶, plus a dedicated
  V4 subsection explaining the thinking-mode mapping, the
  `tool_choice` constraint and the JSON-mode fallback.
- README.md — _Supported LLM Providers_ table updated to list V4 as
  the recommended DeepSeek tier.

## [1.19.0] - 2026-05-05

### Added — LLM model catalogue becomes the source of truth in the database

The chat + image LLM catalogue used to live as frozen Python constants
(`MODEL_PROFILES`, `IMAGE_GENERATION_MODELS`, `REASONING_MODELS_PATTERN`).
Adding or tuning a model required a code change, a release, and a redeploy.
**The catalogue is now persisted in the database** — administrators can
declare new models and edit their full capability + pricing profile from
the admin UI, and every consumer (LangChain factory, agent constraints,
image options dropdowns) reads from the DB live, with no page refresh and
no worker restart.

#### New schema (`apps/api/src/domains/llm/models.py`)

- `llm_models` — catalogue table. One row per distinct `model_name`.
  - `provider` — `LLMProviderEnum` (openai, anthropic, deepseek, perplexity,
    ollama, gemini, qwen) — replaces the regex-based provider inference.
  - 8 capability columns: `max_input_tokens`, `max_output_tokens`,
    `supports_tools`, `supports_structured_output`, `supports_strict_mode`,
    `supports_streaming`, `supports_vision`, `is_reasoning_model`.
  - `is_active` for temporal versioning (deactivated rows preserve history).
- `llm_model_pricing` — pricing rows now FK to `llm_models.id` with
  `ondelete=RESTRICT`. The legacy `model_name` column is dropped — pricing
  joins through the catalogue. Composite uniqueness on
  `(model_id, effective_from)` enforces one rate per model per date.
- `image_generation_pricing` — gains a NOT NULL `provider` column
  (`LLMProviderEnum`) so image options can be grouped by provider and
  filtered by the same provider list as text models.

#### Migrations (3-step pattern, ADR-040)

- `2026_05_05_0001-llm_models_schema.py` — creates the new tables and
  adds nullable columns, no data movement.
- `2026_05_05_0002-llm_models_backfill.py` — backfills 47 known models
  from a frozen `MODELS_DATA` list (preserves capability profiles from
  the deleted `FALLBACK_PROFILES` dict).
- `2026_05_05_0003-llm_models_constraints.py` — flips backfilled columns
  to NOT NULL, drops legacy `llm_model_pricing.model_name`, adds the
  composite unique constraint.

All three are reversible with full `downgrade()` paths.

#### In-memory caches with cross-worker invalidation

- `ModelCapabilitiesCache` (singleton) — loads the active catalogue at
  boot from `llm_models` and exposes `get(model_name)` + `is_reasoning_model()`
  in O(1). Replaces the static `FALLBACK_PROFILES` dict (~750 lines deleted).
- `ImageOptionsCache` (singleton) — loads active rows from
  `image_generation_pricing`, groups them by provider, and exposes
  `QualityOption`, `SizeOption`, `ModelOptions` dataclasses for the
  preferences UI and the agent constraints.
- Both caches register reload handlers via the existing Pub/Sub
  invalidation bus (ADR-063). Any admin write triggers a Redis publish
  on `cache:invalidate:{model_capabilities,image_generation_options}`,
  every API worker reloads, every consumer (factory, options endpoint,
  responses adapter, reasoning detector) sees the new data immediately.

#### Backend service + admin endpoints

- `LLMModelService` (transactional create/update/deactivate) with three
  update modes: capabilities-only (no pricing change), pricing-only
  (capabilities frozen), and mixed (transactional). The pre-populated
  `pricing.model` relationship is preserved through `flush()` (no
  `db.refresh()` calls — defaults are all Python-side).
- `LLMModelRepository` extends `BaseRepository[LLMModel]`.
- `POST/PUT/DELETE /admin/llm/pricing` and `/admin/image/pricing`
  refactored to use the service + a `_invalidate_caches()` helper that
  emits the Pub/Sub message after every successful write.
- New endpoint `GET /api/v1/image-generation/options` — returns the
  current `ImageOptionsCache` content for the preferences screen.

#### Frontend admin form

- **Tarification LLM Texte** — full rewrite of `AdminLLMPricingSection`
  with a 3-section modal (Modèle / Capacités / Tarification) and 14
  fields. Provider is a `<Select>` driven by `LLMProviderEnum`. Each
  capability is a `<Switch>`.
- **Tarification LLM Image** — `AdminImagePricingSection` gains a
  `provider` field on the create/edit form and a `Provider` column in
  the table.
- **Configuration LLM (agents)** — `AdminLLMConfigSection.getModelConstraints`
  now consults the DB capabilities first (live from the cache) and falls
  back to the legacy regex only for unknown models. The
  `is_reasoning_model` toggle correctly disappears when an admin
  disables it on the catalogue, even on models where the regex still
  matched the name.
- **Préférences → Génération d'images** — `ImageGenerationSettings` is
  now driven by the new `useImageGenerationOptions` hook. Quality and
  size dropdowns rebuild themselves from the live catalogue, with price
  ranges shown next to each option.
- **Live invalidation across siblings** — new
  `apps/web/src/lib/catalogue-invalidation-context.tsx` Provider +
  hooks. After an admin write, the form emits a `model_capabilities`
  or `image_generation_options` event; the LLM Configuration section
  and the Image Generation Settings page (mounted as siblings under
  the dashboard) refetch automatically. **No page reload, no worker
  restart.**

#### Reasoning-model detection consolidated

Three call sites used to hardcode the same regex
(`REASONING_MODELS_PATTERN`) to decide whether a model was a reasoning
model. With the DB catalogue authoritative, `is_reasoning_model()`
short-circuits via the cache; the regex is kept as a fallback only for
brand-new models not yet in the catalogue. Affected files:
`AdminLLMConfigSection.getModelConstraints`,
`responses_adapter._is_reasoning_model`,
`adapter._prepare_provider_config`.

#### Seeds

- `infrastructure/database/seeds/llm_pricing_seed.sql` — rewritten to
  insert into `llm_models` (119 catalogue rows with conservative
  default capabilities) **then** into `llm_model_pricing` via
  `INSERT … SELECT … JOIN llm_models ON model_name`. Capabilities are
  refinable post-seed via the 14-field admin form.
- `infrastructure/database/seeds/image_generation_pricing_seed.sql` —
  every row gains `provider='openai'::llm_provider_enum` (today only
  OpenAI image models exist; the column is provider-ready for the
  future).

### Changed

- `model_profiles.py` — the static `FALLBACK_PROFILES` dict is removed
  (~750 lines). `get_model_profile()` now reads from the
  `ModelCapabilitiesCache` singleton.
- `LLMConfigService.get_provider_models()` reads from both caches
  (chat + image) for the admin metadata endpoint, replacing the
  hardcoded provider→models map.
- `main.py` lifespan registers the two new caches and their reload
  handlers in deterministic order.

### Fixed

- **Pricing PUT toast error on existing models** — the
  `lazy="raise"` relationship on `LLMModelPricing.model` was being
  invalidated by a `db.refresh(pricing)` call in the service layer
  after `flush()`. Removed the 3 unnecessary refreshes; defaults
  (`uuid4`, `datetime.now`) are all Python-side and the pre-populated
  `pricing.model` relationship survives `flush()`.
- **`is_reasoning_model` admin toggle ignored at runtime** — the
  reasoning-model detection had two extra hardcoded regex usages
  (`responses_adapter._is_reasoning_model`,
  `adapter._prepare_provider_config`) that bypassed the admin's
  intent. Both now consult the cache first and fall back to the
  regex only for unknown models.
- **`UserSkillState` mapper init failure at boot** —
  `sa_inspect(LLMModel).mapper.column_attrs` was triggering eager
  mapper configuration at module import time (before all domain
  models were loaded). Replaced with table-level introspection
  (`LLMModel.__table__.columns.keys()`) which has no side effect.
- **Pricing seed `id NOT NULL` violation** — `llm_model_pricing.id`
  has no DB default; the rewritten seed now provides
  `gen_random_uuid()` explicitly in the `INSERT … SELECT`.

### i18n (6 languages)

- 14 new keys for the admin LLM pricing form (provider label, 8
  capability labels, 4 pricing labels) + 5 keys for the section
  headers (Modèle / Capacités / Tarification + buttons), in
  fr/en/de/es/it/zh.
- 2 new keys for the image options metadata (`provider` column
  header + price range tooltip) in 6 languages.

### Tests + tooling

- All migrations are revertible and tested via the standard
  `alembic upgrade head` / `alembic downgrade -1` cycle.
- Pre-commit hook (host MyPy + Ruff + Black, host ESLint + tsc, i18n
  parity check across 4315 keys × 6 languages) green on the full
  branch.

### Documentation

- New ADR-078 — _LLM Catalogue DB-Source-of-Truth_ — documents the
  DB-as-source-of-truth pattern, the three-step migration strategy,
  the dual cache + Pub/Sub invalidation contract, and the React
  Context for cross-sibling invalidation.
- ADR-026 (LLM Model Selection Strategy) — section added on the
  catalogue source change.
- ADR-063 (Cross-Worker Cache Invalidation) — `model_capabilities`
  and `image_generation_options` added to the documented consumer
  list.
- `docs/knowledge/03_settings.md` and
  `docs/knowledge/21_image_generation.md` reflect the new admin
  surface and the live propagation behavior.

## [1.18.1] - 2026-04-23

### Changed — Today Briefing polish + screenshots refresh

- **Greeting now lives on the Hero card** — The LLM-generated greeting that
  used to sit as a standalone block above the Hero now overlays the LIA
  avatar, replacing the rotating random marketing taglines. The `<HeroLiaCard>`
  accepts an optional `greeting` prop (with `LLMUsageBadge` underneath
  showing tokens + EUR cost) and falls back to a static localized tagline
  while the LLM call is in flight, so the area is never empty.
  `BriefingGreeting` and `GreetingSkeleton` are no longer mounted by
  `<TodayBriefing>` (left in the codebase as exported components).
- **Per-card refresh button always visible on mobile** — `<BriefingCard>`
  used to hide its refresh icon until card hover (`opacity-0`
  `group-hover:opacity-100`), which is invisible on touch devices. Now
  visible by default on mobile and hover-revealed (with the +12° rotation
  affordance) only on `sm+` viewports.
- **Usage statistics show the lifetime starting date** — `UserStatistics`
  schema gains a `total_since: datetime` field, populated from
  `User.created_at` in the service layer (default factory keeps
  `model_validate` working when constructing from the ORM row). Frontend
  formats it via `Intl.DateTimeFormat` with the active locale and renders
  "since DD/MM/YYYY" under each StatCard total. New i18n key
  `dashboard.statistics.since` in 6 languages.
- **Section headings get illustrative icons** — `<TodayBriefing>` "Mon
  dashboard" gains a `Sunrise` icon (consistent with the Today Briefing
  feature card in the FAQ); `<UsageStatistics>` "Statistiques d'utilisation"
  gains a `BarChart3` icon. Both in `text-primary`, `aria-hidden="true"`,
  matching the existing typography (`text-base sm:text-lg font-semibold`).
- **Title typography parity** — `<UsageStatistics>` title now uses the
  same Tailwind typography as `<TodayBriefing>` "Mon dashboard" so the
  two main sections of the home page look like siblings rather than
  unrelated blocks.

### Changed — Screenshots refresh + cache-busting

- **12 dashboard screenshots refreshed** — README (`docs/assets/`) and
  landing (`apps/web/public/screenshots/`) now ship the v1.18.x captures
  from `LIA Pics/v2/` and `apps/web/public/screenshots/v2/` respectively.
  8 existing screenshots replaced (homepage, chat, settings-preferences,
  settings-features, settings-administration,
  settings-administration-oneclick, settings-administration-llm, faq) and
  4 new ones added: `chat-debug-panel`, `chat-interactive-skills`,
  `settings-features-memory`, `settings-features-psyche`.
- **Automatic cache-busting on landing screenshots** — `<ScreenshotsSection>`
  appends `?v={APP_VERSION}` to every `<Image src>` so the browser, the
  Next.js Image optimizer (`.next/cache/images`) and any upstream CDN
  re-fetch the new PNG at every release. No manual cache invalidation
  required. The README, served by GitHub directly, refreshes via the
  commit-driven CDN.
- **README v1.18.0 release paragraph translated to English** — the v1.18.0
  description was accidentally drafted in French; aligned with the rest
  of the README, no content change.

### Changed — Landing page descriptions condensed

- **"Skills with maps & mini-apps"** and **"Health data"** descriptions
  on the landing features grid were 4× longer than adjacent descriptions.
  Both rewritten to ~150 chars in 6 languages to match the typography of
  the rest of the grid (no information loss — the long-form details live
  in the FAQ and dedicated docs).

### Fixed

- The optional `greeting` / `isLoadingGreeting` props on `<HeroLiaCard>`
  are typed and default to `null`/`false` — calling `<HeroLiaCard />`
  without them keeps the previous random-tagline behavior, so any other
  caller that may instantiate the Hero outside the briefing flow is
  unaffected.

### i18n (6 languages)

- New key `dashboard.statistics.since` in fr/en/de/es/it/zh.
- 4 new caption keys `landing.screenshots.items.{chat_debug_panel,
chat_interactive_skills, settings_features_memory,
settings_features_psyche}` for the new screenshots in the carousel.
- v1_18_1 changelog entry added to `faq.changelog.versions.*` (6 items,
  user-facing only).

### Tests + tooling

- All 7401 unit tests pass.
- `BriefingGreeting` and `GreetingSkeleton` are no longer used by the
  layout but still exported (kept as a non-breaking deprecation cushion).

## [1.18.0] - 2026-04-23

### Added — Today Briefing : the home page becomes a daily ritual

The dashboard home page was a static stats display. It is now a **Today
briefing** — an LLM-generated greeting + contextual synthesis above a
6-card grid of operational data (weather, calendar, unread mails, upcoming
birthdays, active reminders, health metrics).

#### New bounded context `apps/api/src/domains/briefing/`

- **No LangGraph chain** — direct orchestration via `asyncio.gather` of the
  existing services (OpenWeatherMap, multi-provider calendar/email,
  GooglePeople, ReminderService, HealthMetricsService).
- **No DB model, no migration, no scheduler** — pure read orchestration.
- **Per-section Redis cache** with TTL aligned to each source's natural
  change rate: weather 1 h, agenda 10 min, mails 5 min, birthdays 24 h,
  reminders live, health 15 min.
- **6 source fetchers** — pure async functions, each independently failable.
  `ConnectorNotConfiguredError` → `NOT_CONFIGURED` (card hidden in UI).
  `ConnectorAccessError` → `ERROR` (CTA mapped via stable `error_code`).
- **2 LLM calls** (greeting + synthesis) on a single `briefing` slot in
  `LLM_TYPES_REGISTRY` (default `gpt-4.1-nano`, T=0.7, 500 tokens), with
  two distinct versioned prompts. Tokens tracked via existing
  `track_proactive_tokens(task_type="briefing")` (cached tokens correctly
  subtracted from `input_tokens` to avoid double-counting cost). Synthesis
  is skipped when fewer than 2 cards have OK data. Fallback localized
  greeting guarantees the page always renders if the LLM is down. Each
  `TextSection` payload carries an optional `LLMUsage` block
  (`tokens_in`, `tokens_out`, `tokens_cache`, `cost_eur`, `model_name`)
  computed via the in-memory pricing cache so the UI can surface real
  consumption next to the timestamp.

#### Endpoints

- `GET /api/v1/briefing/today` — assemble + return briefing (cache-aware).
- `POST /api/v1/briefing/refresh` — force-refresh selected sections (or
  `"all"`); LLM always regenerated for consistency.

#### Frontend (`apps/web/src/components/dashboard/`)

- **Generic `<BriefingCard>`** with 4 status states (OK / EMPTY / ERROR /
  NOT_CONFIGURED). Refresh button per card with overlay spinner. Optional
  `centerContent` prop vertically + horizontally centers OK content (used
  by Weather + Health).
- **`<BriefingSkeleton>`** mirrors the final layout for a seamless first paint.
- **`<BriefingSynthesis>` + `<BriefingGreeting>`** display a discreet
  `<LLMUsageBadge>` next to the timestamp — total tokens + EUR cost, with
  a tooltip detailing model + IN / OUT / CACHE breakdown. Synthesis also
  flashes a "mis à jour ✨" badge for 1.5 s after a refresh.
- **6 specific cards** : Weather, Agenda, Mails, Birthdays, Reminders, Health.
  - Weather forecast strip — weekday label derived client-side from
    `date_iso` via `Intl.DateTimeFormat` (locale-aware, replaces the
    C-locale `weekday_short` field that no longer ships in the API).
  - Health card — single CSS grid with `display: contents` on list items
    so the today / average separators line up vertically across metrics
    regardless of label widths. List semantics preserved.
- **`<HeroLiaCard>`** preserved verbatim (kept the marketing tagline).
- **`<QuickAccessCompact>`** — 2 compact cards (Help + Settings) replacing
  the previous 3 large cards. The "Security" card (no actionable purpose)
  has been removed.
- **`<UsageStatistics>`** — preserved verbatim (extracted to its own component).
- **Animations** : `animate-in fade-in slide-in-from-bottom-1` on cards with
  50 ms stagger; bouton refresh `animate-spin` during fetch, +12° rotation
  on hover. All wrapped in `motion-safe:` for `prefers-reduced-motion`.
- **Strict black/white per theme** — no decorative gradient. The chromatic
  warmth comes from the content (greeting/synthesis), not the decor.

#### Observability

- 4 new Prometheus metrics in `metrics_briefing.py`:
  `briefing_build_duration_seconds`, `briefing_section_status_total`,
  `briefing_refresh_requests_total`, `briefing_llm_invocations_total`.
- Single structured `briefing_built` log line per build with
  duration_ms + cache_state + sections_status.

#### i18n (6 languages)

- 16 new keys per locale under `dashboard.briefing.*` (en, fr, de, es, it, zh).
- 6 card-specific subsections with empty states, error CTAs, units.
- `usage_tokens` key uses i18next pluralization (`_one` / `_other`) so the
  inline LLM usage badge stays grammatically correct at any token count.

#### Tests + docs

- `tests/unit/domains/briefing/` — 30+ unit tests on formatters + service
  orchestration with mocked fetchers + LLM, including a happy-path test
  asserting that `LLMUsage` returned by the LLM helpers lands on
  `TextSection.usage` for both greeting and synthesis.
- `docs/technical/BRIEFING_DOMAIN.md` — full architecture + API + recipe
  to add a new card.
- `docs/architecture/ADR-077-Today-Briefing-Domain.md` — rationale for the
  separate bounded context + LangGraph bypass.

#### Cost & performance

- Latency: < 1 s on warm cache, < 2 s on cold cache (P95 target).
- LLM cost: ~ 0.005 cent per build, < 1 €/month total at 100 active users.
- Cache footprint: ~ 60 MB Redis at 1000 users.

---

## [1.17.2] - 2026-04-22

### Added — Health Metrics : agents + Heartbeat + Journal + Mémoire + extensibilité

La v1.17.1 a livré l'ingestion batch-upsert polymorphe, mais les données
santé restaient inertes pour la logique conversationnelle. La v1.17.2
les expose aux trois boucles centrales de LIA et pose les fondations
pour en ajouter facilement de nouvelles (sommeil, SpO2, calories…).

#### Registre central des kinds (`kinds.py`)

- Nouveau `HEALTH_KINDS: dict[str, HealthKindSpec]` — source unique de
  vérité pour les bornes physiologiques, la stratégie de merge intra-batch,
  la méthode d'agrégation, le type de baseline, et l'agent associé.
- Ingestion (`_validate_sample`), repository (`_merge_duplicate_samples`),
  aggregator (`_BucketAccumulator`) refactorisés pour lire ce registre —
  zéro branche `if kind ==` restante.
- Ajouter un kind = une entrée dans `kinds.py` + un nouveau pack de tools.

#### Baseline adaptive + détection de variations

- `baseline.py` — `compute_baseline()` avec sélection automatique
  `bootstrap` (médiane simple) jusqu'à 7 jours de données, puis `rolling`
  (médiane mobile 28 jours).
- `signals.py` — `detect_recent_variations()` (streaks directionnels) et
  `detect_notable_events()` (événements structurels, ex. inactivité).
- Seuils configurables via `.env` (`HEALTH_METRICS_BASELINE_MIN_DAYS`,
  `HEALTH_METRICS_VARIATION_MIN_DAYS`, `HEALTH_METRICS_VARIATION_MIN_DELTA_PCT`,
  `HEALTH_METRICS_VARIATION_DAILY_DELTA_PCT`).

#### Un agent `health_agent` avec 7 tools hand-crafted

Conforme au pattern 1 agent ↔ 1 domaine du codebase (cf. `email_agent`,
`event_agent`, `weather_agent`…). Sept tools sous un même
`health_agent`, tous construits via `build_generic_agent()` avec un
prompt unique versionné (`health_agent_prompt.txt` v1) et gatés par
`_check_user_toggle_or_error` qui retourne
`UnifiedToolOutput.failure(error_code="PERMISSION_DENIED")` si le toggle
utilisateur est désactivé :

- **Steps** — `get_steps_summary_tool`, `get_steps_daily_breakdown_tool`,
  `compare_steps_to_baseline_tool`.
- **Heart rate** — `get_heart_rate_summary_tool`,
  `compare_heart_rate_to_baseline_tool`.
- **Cross-kind** — `get_health_overview_tool`, `detect_health_changes_tool`.

Les tools de summary + overview utilisent **`time_min` / `time_max` ISO
8601** (même pattern que `calendar_tools.search_events_tool`) : le
planner extrait les deux bornes depuis les `resolved_references` du
QueryAnalyzer (« cette semaine » → `2026-04-20 to 2026-04-26` →
`time_min=2026-04-20`, `time_max=2026-04-26`) et les passe au tool.
Défaut côté service : `time_min` → aujourd'hui 00:00 UTC,
`time_max` → `datetime.now(UTC)`. Les valeurs factuelles (totaux,
moyennes, entrées par jour) sont inlinées dans le champ `message` de
l'`UnifiedToolOutput` pour être lues par le LLM Response (pattern
`weather_tools`).

#### Heartbeat — source `health_signals`

- `HeartbeatContext.health_signals` injecté dans `CURRENT CONTEXT` pour
  décisions proactives contextuelles. Fetch avec timeout 2 s + fallback
  silencieux pour ne jamais bloquer le gather.

#### Mémoire — `context_biometric` JSONB

- Nouvelle colonne optionnelle sur `memories` (migration `health_metrics_005`).
- Le memory_extractor injecte un `{health_context}` dans le prompt et
  persiste un blob `context_biometric` (deltas, tendances, événements
  uniquement — jamais de valeurs brutes) quand l'émotion dépasse un seuil.

#### Journal — extraction + consolidation

- Placeholders `{health_context}` (extraction) et `{health_signals_section}`
  (consolidation) injectés uniquement pour les utilisateurs opt-in.

#### Toggle utilisateur unique

- `User.health_metrics_agents_enabled` (migration `health_metrics_004`,
  default `false`). Un seul interrupteur gouverne les 4 intégrations :
  agents, Heartbeat, mémoire, journal.
- Nouvel endpoint `PATCH /auth/me/health-metrics-agents-preference`.
- Section « Assistant » dans **Réglages → Données santé** (6 langues).

#### Backward compatibility

- `HealthMetricAggregatePoint` conserve ses champs typés
  (`heart_rate_avg/min/max`, `steps_total`) et ajoute un
  `metrics_by_kind: dict[str, dict[str, int | float]] | None` additif —
  les kinds futurs apparaissent automatiquement dans cette clé sans
  casser le front existant.

### Fixed — Assistant santé : réponses fiables sur des plages temporelles naturelles

Quatre itérations de debug sur la même requête (« Combien de pas cette
semaine ? ») ont mis en évidence plusieurs défauts d'intégration, tous
corrigés en s'alignant sur les patterns existants du codebase plutôt
qu'en inventant du spécifique :

- **LLM Response ne voyait plus les données** — les tools retournaient
  des messages pauvres (« Steps breakdown over 7 days (8 days with
  data). ») sans inliner les valeurs, ce qui produisait la réponse
  trompeuse « Pas de données ». Les messages incluent désormais les
  chiffres factuels (totaux, moyennes, entrées par jour) dans le champ
  `UnifiedToolOutput.message`, pattern issu de `weather_tools`.
- **Paramètres temporels** — remplacement d'un enum `period` rigide
  par `time_min` / `time_max` ISO 8601 sur les tools summary +
  overview. Le `QueryAnalyzer` résolvait déjà « cette semaine » en
  plage de dates calendaire ; le tool ingère désormais directement
  ces bornes (pattern identique à `calendar_tools.search_events_tool`).
- **Sémantique de semaine** — la logique de fenêtre par défaut
  passait d'un rolling de 7 jours à une borne calendaire
  (aujourd'hui 00:00 UTC → maintenant) quand aucune borne n'est
  fournie, cohérent avec l'expérience frontend (`/aggregate`).
- **Pattern 1 agent ↔ 1 domaine** — consolidation de trois agents
  (`steps_agent`, `heart_rate_agent`, `health_overview_agent`) en un
  unique `health_agent` owning les 7 tools, conforme au reste du
  codebase (`email_agent`, `event_agent`, `weather_agent`…). Zéro
  modification des fichiers cœur (`agent_registry`, `router_node_v3`,
  `smart_catalogue_service`, `domain_taxonomy`).
- **Refactor `HealthMetricsRepository`** — split en deux classes
  héritant de `BaseRepository[T]` (`HealthSampleRepository`,
  `HealthMetricTokenRepository`), conforme au standard.
- **Parallélisation `compute_overview`** — passage de séquentiel à
  `asyncio.gather` pour les kinds enregistrés.

### Changed — Landing et FAQ : messaging générique plutôt qu'iPhone-centric

- Landing section « Données santé » repositionnée comme **API
  d'ingestion dédiée** (Raccourcis iOS, automatisation Android,
  intégration tierce, IoT) plutôt qu'exclusivement iPhone/Apple Santé.
  Titre, description et FAQ synchronisés dans les 6 langues
  (en/fr/de/es/it/zh).

## [1.17.1] - 2026-04-21

### Changed — Health Metrics : refonte en batch upsert polymorphe (BREAKING)

L'iPhone ne peut pas déclencher de manière fiable un automatisme horaire
(iOS exige que le téléphone soit déverrouillé), rendant le modèle v1.17.0
(un POST par heure avec `{data: {c, p, o}}`) structurellement fragile.
Refonte complète vers un modèle **batch quotidien avec upsert idempotent**
côté serveur.

#### BREAKING — Contrat d'API modifié

- Les endpoints `/api/v1/ingest/health` → **supprimés**, remplacés par
  deux endpoints par kind :
  - `POST /api/v1/ingest/health/steps`
  - `POST /api/v1/ingest/health/heart_rate`
- Le body `{"data": {"c": bpm, "p": steps, "o": source}}` → **remplacé**
  par un **tableau de samples auto-horodatés**
  `[{date_start, date_end, steps|heart_rate, o}, ...]` (ISO 8601 avec
  offset, normalisés UTC + tronqués à la seconde).
- L'ancien endpoint `DELETE /health-metrics?field=heart_rate|steps` (qui
  NULL-ait la colonne) → **remplacé** par `DELETE /health-metrics?kind=…`
  qui supprime les lignes de ce kind.
- L'ancienne table `health_metrics` (une ligne par POST) → **supprimée**
  et remplacée par la table polymorphe `health_samples(kind, date_start,
date_end, value, source)` avec `UniqueConstraint(user_id, kind,
date_start, date_end)` comme ancre d'idempotence. Migration `health_metrics_003`
  (DROP + CREATE, feature flag off en prod au moment de la coupure).

#### Added

- **Parser flexible** (`parser.py`) acceptant quatre formes d'enveloppe :
  tableau JSON canonique, NDJSON, `{"data": [...]}`, et le wrapping
  « Dictionnaire » iOS `{"<ndjson_blob>": {}}` (détecté par heuristique —
  clé unique avec `\n` + valeur vide). Aucune contrainte sur la forme du
  Raccourci côté utilisateur.
- **UPSERT PostgreSQL** via `INSERT ... ON CONFLICT ... DO UPDATE ...
RETURNING (xmax = 0)` qui discrimine inserts vs updates en un aller-retour.
  Re-sending le même batch n'insère aucune ligne en double.
- **Dedupe intra-batch avec arbitrage per-kind** — résout le bug
  `CardinalityViolationError` survenant quand iOS émet des samples overlap
  (Apple Watch + iPhone) pour la même période. Stratégies :
  - `steps` → **MAX** (Watch et iPhone comptent des sous-ensembles
    complémentaires du mouvement ; MAX approche la vérité terrain mieux
    que SUM double-compte ou AVG sous-compte).
  - `heart_rate` → **AVG** arrondi (fusion de deux capteurs visant le
    même signal physiologique).
  - Duplicats collapsés comptabilisés comme `updated` dans la réponse,
    warning log `health_batch_duplicates_collapsed`, counter Prometheus
    `health_samples_batch_duplicates_total{kind}`.
- **Validation mixte par échantillon** — chaque sample est accepté ou
  rejeté individuellement avec son index 0-based, les siblings valides
  sont persistés. La réponse liste `rejected[{index, reason}]` avec des
  motifs bornés (`out_of_range | malformed | missing_field | invalid_date`).
- **Aggregator polymorphe server-side** (`aggregator.aggregate_samples`) —
  SUM sur les samples `steps`, AVG/MIN/MAX sur les samples `heart_rate`,
  gaps préservés (`has_data=False`).
- **UI Réglages — fenêtre temporelle agrégée affichée** dans la section
  Statistiques pour lever l'ambiguïté UX « les stats ne bougent pas quand
  je change de période » (les stats HR sont invariantes quand toutes les
  données tiennent dans la plus petite fenêtre — affichage explicite des
  bornes from/to).

#### Fixed

- **Bug prod : 500 `CardinalityViolationError`** sur les ingestions de
  heart_rate/steps couvrant plusieurs heures (Apple Watch + iPhone
  émettent des samples avec le même `(date_start, date_end)`). Résolu par
  le dedupe intra-batch avec arbitrage per-kind décrit ci-dessus.
- **Tooltips recharts illisibles en mode sombre** — les tooltips par
  défaut utilisaient un fond blanc avec label gris hardcodés, rendant le
  label invisible en dark mode. Correction : branchement sur les variables
  CSS shadcn (`--popover`, `--popover-foreground`, `--border`,
  `--muted-foreground`) pour respecter le thème actif.

#### Config

- Rate limit par token relevé **5 → 60 req/h** par défaut (bursts au
  déverrouillage de l'iPhone), paramétrable via `HEALTH_METRICS_RATE_LIMIT_PER_HOUR`.
- Nouveau `HEALTH_METRICS_MAX_SAMPLES_PER_REQUEST=1000` — plafond de taille
  de batch avec `HTTP 413` au-delà.
- Source par défaut `unknown` → **`iphone`**.
- Nouvelle métrique `health_samples_batch_duplicates_total{kind}`.
- Métrique `health_metrics_ingested_total` → **remplacée** par
  `health_samples_upserted_total{kind, operation}` (insert | update).

#### Tests

- 65 tests unit (aggregator polymorphe, parser 4 formes, validation
  per-kind, `_normalize_datetime`, `_merge_duplicate_samples` arbitrage).
- Tests d'intégration : upsert idempotent, mixed validation, dedupe
  intra-batch avec assertions sur les valeurs attendues par kind (MAX=1200
  pour steps, AVG=78 pour HR).

#### Documentation

- ADR-076 (révisé) — décisions de refonte documentées.
- `docs/technical/HEALTH_METRICS.md` réécrit — nouveau contrat, dedupe,
  schéma polymorphe.
- `docs/guides/GUIDE_IPHONE_SHORTCUTS_HEALTH.md` réécrit — deux Shortcuts
  (steps + HR), format ISO 8601 obligatoire, failure modes.
- `docs/ARCHITECTURE.md` + `docs/architecture/ADR_INDEX.md` corrigés.
- `apps/web/src/data/guides/how.{6 langues}.md §23.12` + `why.{6
langues}.md §3.9` réécrits (vitrine technique + fonctionnelle).
- `README.md`, `CHANGELOG.md` (cette entrée), FAQ applicative 6 langues.

## [1.17.0] - 2026-04-21

### Added — Health Metrics ingestion (iPhone Shortcuts) + settings visualization

Nouveau domaine `health_metrics` derrière feature flag `HEALTH_METRICS_ENABLED=false`.

- **Endpoint d'ingestion authentifié par token** `POST /api/v1/ingest/health`
  (Bearer `hm_xxx`). Body : `{"data": {"c": heart_rate, "p": steps_since_previous, "o": source}}`.
  `p` est le nombre de pas enregistrés depuis le précédent envoi (PAS un compteur
  cumulatif quotidien). Horodatage server-side à réception, rate-limit Redis
  (5 req/h/token par défaut), validation mixte par champ (valeur hors plage →
  NULL + log warn sans bloquer les autres champs valides).
- **Tokens hashés (SHA-256) avec préfixe d'affichage** — valeur brute révélée
  une seule fois à la génération, révocables individuellement. Plusieurs tokens
  peuvent cohabiter (rotation). Table `health_metric_tokens` + migration
  `health_metrics_001`.
- **Table `health_metrics` (une ligne par POST)** avec colonnes nullables pour
  `heart_rate` / `steps` (mixed validation), `source` slugifié,
  `recorded_at` UTC, index `(user_id, recorded_at)`.
- **Endpoints utilisateur (session-auth)** : listing, agrégation
  (`period=hour|day|week|month|year`), suppression par champ (`UPDATE NULL`)
  ou globale (`DELETE`), gestion tokens (list/create/revoke).
- **Agrégation server-side** (`aggregator.py`) : SUM des `steps` par bucket
  (heure/jour/semaine/mois/année), AVG/MIN/MAX pour la fréquence cardiaque,
  gaps préservés (`has_data=False`) pour affichage honnête des trous d'envoi.
- **UI Réglages → Fonctionnalités → Données santé** : 4 blocs accordéon
  (ingestion API + tokens, graphiques, statistiques, gestion) avec charts
  `recharts` — courbe FC + barres pas + lignes pointillées moyenne période.
- **i18n 6 langues** (fr/en/de/es/it/zh) — namespace `healthMetrics.*`.
- **Observabilité** : 8 métriques Prometheus (ingested/rejected/auth/rate-limit/
  tokens/deletions + latency histogram) + dashboard Grafana 21 dédié.
- **Documentation** : ADR-076, `docs/technical/HEALTH_METRICS.md`, guide
  iPhone `docs/guides/GUIDE_IPHONE_SHORTCUTS_HEALTH.md`.

## [1.16.10] - 2026-04-20

### Observability Overhaul — 90+ dead metrics revived, 2 new dashboards, DB index optimizations

Cette itération cible la dette d'observabilité du stack : une partie significative
des métriques Prometheus déclarées n'étaient pas émises, deux pans de l'exécution
(sub-agents/skills et ReAct/browser) n'étaient couverts par aucun dashboard, et
les gauges DB-backed (DAU/WAU) n'avaient pas d'index dédié. Livraison en un seul
commit additif sans changement de contrat API.

#### Added

- **Instrumentation de 90+ métriques mortes** — 40 fichiers backend touchés,
  instrumentation défensive (`try/except Exception: pass`) pour que les failures
  Prometheus ne cassent jamais les chemins critiques. Exemples notables :
  router (`router_latency_seconds`, `router_confidence_score`,
  `router_fallback_total`, `router_data_presumption_total`),
  planner (`planner_plans_created_total`, `planner_plans_rejected_total`,
  `planner_domain_confidence_score`, `planner_retries_total`,
  `planner_retry_success_total`, `planner_retry_exhausted_total`),
  sub-agents (`subagent_token_budget_exceeded_total`),
  HITL (`hitl_clarification_requests_total`,
  `hitl_question_generation_duration_seconds`, `hitl_question_ttft_seconds`,
  `rejection_total`, `rejection_response_tokens`), OAuth
  (`oauth_token_exchange_duration_seconds`, `oauth_provider_errors_total`,
  `oauth_connector_activation_total`, `oauth_connector_activation_duration_seconds`,
  `oauth_lock_acquired/released/wait/contention/timeout_total`), connecteurs
  (`connector_api_requests_total`, `connector_api_duration_seconds`,
  `connector_api_errors_total` avec sanitization de paths URL pour borner la
  cardinalité), voice (`voice_comment_tokens_total`,
  `voice_interruptions_total`, `voice_preference_toggles_total`), browser
  (`browser_errors_total`, `mcp_react_invocations_total`,
  `mcp_react_iterations_histogram`), drafts (`registry_draft_actions_total`,
  `draft_edit_iterations_total`), initiative (`initiative_evaluations_total`,
  `initiative_duration_seconds`, `initiative_actions_total`), data-registry
  (`registry_size`, `registry_expired_total`), conversations
  (`conversation_message_archived_total`, `conversation_repository_queries_total`,
  `conversation_repository_errors_total`, `user_return_rate_total`,
  `user_daily_conversations_total`).
- **Dashboard 19 — Sub-agents & Skills** (20 panels, 5 rows) : activité
  sub-agents, token budget, skills execution, rich outputs (frames/images),
  clarifications, query patterns.
- **Dashboard 20 — ReAct & Browser** (22 panels, 5 rows) : invocations ReAct,
  iterations, browser tool errors, MCP React, trajectory analysis.
- **DB indexes** (migration `obs_indexes_001`) : `ix_conversations_updated_at`
  (DAU/WAU), `ix_conversations_created_at` (daily-conversations histogram),
  `ix_connectors_status` (connector_activation_rate gauge). Objectif : passer
  les queries du background updater de ~500ms (full scan) à <50ms.
- **FastAPI `RequestValidationError` handler** (`validation_errors_total`
  dashboard 16) : comptabilise les 422 par field + error_type, cap à 10
  erreurs/requête pour borner la cardinalité.
- **SQLAlchemy event listeners** sur `Connector` (`before_insert` / `after_insert`)
  pour mesurer la durée d'activation réelle (flush SQL → completion) sans
  intrusion dans les services.
- **Gauges DB-backed** : DAU (`user_active_daily_gauge`), WAU
  (`user_active_weekly_gauge`), Redis pool
  (`redis_connection_pool_size_current`,
  `redis_connection_pool_available_current`), taille table checkpoints
  (`checkpoints_table_size_bytes`), taux d'activation connecteur
  (`connector_activation_rate`).

#### Fixed

- **`planner_plans_created_total` labels mismatch** — la metric était déclarée
  avec `[execution_mode]` seul mais appelée avec `(execution_mode, agents_count)`,
  provoquant un `ValueError` silencieux dans le try/except. Argument
  `agents_count` retiré.
- **`hitl_question_ttft_seconds.observe()` sans `.labels()`** — bug pré-existant
  dans [question_generator.py:337](apps/api/src/domains/agents/services/hitl/question_generator.py#L337)
  corrigé par ajout de `.labels(type="tool_confirmation")`.
- **Cardinality bomb sur `connector_api_*{operation}`** — les labels recevaient
  des paths URL bruts (avec UUIDs, tokens, IDs numériques), explosant la mémoire
  Prometheus. Sanitizer segment-par-segment (regex UUID/id/hex_id/token, 12/12
  cas de test passants) en amont du `.labels()`.
- **Dashboards 19 et 20 complètement vides** — utilisation fautive de
  `collapsed: false` avec des panels imbriqués dans `row.panels[]` : Grafana
  exige une structure flat quand le row n'est pas collapsé. Script de flatten
  `flatten_dashboards_19_20.py` appliqué.
- **`Connector.is_active` inexistant** — la colonne DB est `status`, pas
  `is_active`. Requête `connector_activation_rate` corrigée pour utiliser
  `Connector.status == ConnectorStatus.ACTIVE`.
- **Label `ConnectorType.BRAVE_SEARCH`** dans `connector_activation_rate` au
  lieu de `brave_search` : `ctype.value` (au lieu de `str(ctype)`) pour exposer
  uniquement la valeur snake_case.
- **Imports erronés** : `user_daily_conversations_total` et
  `user_return_rate_total` étaient importés depuis
  `infrastructure.observability.metrics` mais déclarés dans `metrics_business`.
  Corrigés.
- **Double import** dans `proactive/runner.py` (`track_proactive_notification`
  et `track_proactive_tokens`) fusionnés en un seul bloc `from ... import (a, b)`.
- **Magic number `0.5`** pour le seuil de fallback router remplacé par
  `get_confidence_bucket(confidence) == "low"` pour rester aligné sur les
  buckets existants de `router_decisions_total{confidence_bucket}`.
- **Proactive runner** : les helpers `track_proactive_task_execution`,
  `track_proactive_notification`, `track_proactive_tokens`,
  `track_proactive_feedback` étaient définis dans `metrics_registry.py` mais
  jamais appelés — le runner utilisait `background_job_duration_seconds`
  comme proxy. Rebranchés.

#### Changed

- **README, docs/INDEX.md, docs/technical/GRAFANA_DASHBOARDS.md,
  docs/technical/METRICS_REFERENCE.md, docs/readme/README_OBSERVABILITY.md,
  docs/readme/README_GRAFANA_DASHBOARD.md** — passent à **20 dashboards /
  354+ panels** (contre 18/312) avec versions bumpées (4.0 → 4.1) et dates
  mises à jour.
- **MyPy strict** — event listeners `Connector` typés
  (`_SAMapper`, `_SAConnection`, `target: "Connector"`), plus d'`untyped-def`.
- **Ruff + Black** — 809 fichiers conformes, 0 erreur.

## [1.16.9] - 2026-04-20

### Chat UX Polish — LaTeX, syntax highlighting, history search, copy buttons, a11y

Cette itération concentre une quinzaine d'améliorations ciblées de l'expérience
chat, un correctif de bug, et le nettoyage du skill-generator pour garantir la
livraison exhaustive des fichiers d'un skill.

#### Added

- **Support LaTeX dans les réponses assistant** — `remark-math` + `rehype-katex`
  branchés dans [MarkdownContent.tsx](apps/web/src/components/chat/MarkdownContent.tsx).
  Syntaxe : `$inline$` et `$$block$$`. CSS KaTeX chargé globalement dans
  [[lng]/layout.tsx](apps/web/src/app/[lng]/layout.tsx). Le prompt
  `response_system_prompt_base.txt` encourage le LLM à utiliser LaTeX pour les
  expressions mathématiques.
- **Coloration syntaxique + copy button sur blocs de code** — nouveau composant
  [CodeBlock.tsx](apps/web/src/components/chat/CodeBlock.tsx) avec
  `react-syntax-highlighter` en lazy-load (`PrismAsyncLight`), thème automatique
  (one-dark / one-light via `next-themes`), 25 langages enregistrés à la
  demande, bouton copy avec toggle Copy → Check + toast.
- **Copy button sur messages assistant** — bouton copy discret en top-right de
  chaque bulle (hover-only desktop, toujours visible mobile) avec tooltip et
  toast i18n.
- **Dates relatives dans ChatMessage** — `formatTime` renvoie maintenant
  l'heure seule pour aujourd'hui, « Hier + heure » pour J-1, nom de jour + heure
  pour J-2 à J-6, format complet au-delà (via `Intl.RelativeTimeFormat` /
  `Intl.DateTimeFormat`, zéro dépendance supplémentaire).
- **Recherche dans l'historique de conversations** — `GET /conversations/me/messages?search=`
  accepte un substring via PostgreSQL `ILIKE` (case-insensitive, MVP
  accent-sensitive). Input de recherche dans le header du chat avec filtrage
  client-side pour feedback instantané.
- **Primitive Tooltip Radix** — nouveau composant [tooltip.tsx](apps/web/src/components/ui/tooltip.tsx)
  (preset shadcn), `TooltipProvider` monté dans le layout racine. Migration
  appliquée aux icônes prioritaires du chat (paperclip, copy, feedback 👍/👎/🚫,
  download image, remove attachment).
- **Accessibilité TypingIndicator** — `role="status"` + `aria-live="polite"` +
  `aria-label` localisé pour annoncer le streaming aux lecteurs d'écran.
- **Attributs mobiles natifs du textarea chat** — `autoCapitalize`,
  `autoCorrect`, `spellCheck`, `enterKeyHint="send"` pour une expérience
  clavier mobile standard (bouton « Envoyer » au lieu de « Return »).
- **InterestFeedback optimistic UI** — les boutons 👍/👎/🚫 disparaissent
  immédiatement au clic, avec toast de confirmation proactif. Le backend
  reste source de vérité en cas d'échec (bouton réapparaîtra au prochain
  reload).
- **Constantes `FIELD_TARGET_ID`, `FIELD_FEEDBACK_ENABLED`,
  `FIELD_FEEDBACK_SUBMITTED`, `FIELD_FEEDBACK_VALUE`** dans
  [`core/field_names.py`](apps/api/src/core/field_names.py) — centralisation
  des clés JSONB de la metadata des messages proactifs. Migration
  correspondante dans [notification.py](apps/api/src/infrastructure/proactive/notification.py)
  (boy scout rule).
- **Helpers `_fetch_language` / `_language_from_result`** sur
  `ConnectorTool` ([base.py](apps/api/src/domains/agents/tools/base.py)) +
  constante `_LANGUAGE_RESULT_KEY`. Factorise le pattern Option C utilisé
  par les 6 tools Hue pour propager la langue utilisateur de l'execute
  async vers le formatter sync sans s'appuyer sur un état d'instance
  partagé (les tool instances sont des singletons concurrents).
- **Tests unitaires** — 14 tests `test_hue_i18n.py` (helpers + formatage),
  5 tests `test_feedback_persistence.py` (intégration, isolation
  cross-tenant, NULL metadata, multi-messages), 4 tests
  `test_messages_search.py` (ILIKE, no-match, None, accent-sensitive MVP).

#### Fixed

- **Bug InterestFeedback boutons réaffichés au reload** — le clic sur 👍/👎/🚫
  persiste désormais dans `conversation_messages.message_metadata.feedback_submitted`
  via `ConversationRepository.mark_interest_feedback_submitted`. Au reload,
  le frontend lit `message.metadata?.feedback_submitted` — plus de
  réapparition cross-session / cross-device.
- **Weather erreurs localisées correctement** — dans les 3 tool variants,
  `language` est désormais overridé par la préférence utilisateur
  (`if user_lang: language = user_lang`) au lieu du défaut kwargs, et les
  6 sites `_()` propagent `language` à gettext (message "Unable to find
  location" / "Please specify a city" rendu en allemand / italien / etc.).
- **Hue tool messages localisés** — les 6 tools Philips Hue
  (list*lights/control_light/list_rooms/control_room/list_scenes/activate_scene)
  passent par `*(text, language)`avec propagation via`self.runtime`→`self.\_fetch_language()`. 126 entrées ajoutées aux 6 fichiers `.po`
(`fr/en/de/es/it/zh-CN`) et `.mo` recompilés.
- **Skill-generator livraison incomplète des fichiers** — `SKILL.md` du
  skill-generator renforcé : Phase 3 liste explicitement TOUS les types
  de fichiers à produire (scripts/_.py, references/_.md,
  translations.json), Phase 4 impose un protocole de livraison avec
  header de chemin avant chaque bloc de code, section "Delivery
  Checklist" ajoute une vérification finale comptant les resources
  déclarées vs livrées.
- **Prompt LaTeX KeyError runtime** — l'exemple initial
  `e^{-x}` déclenchait `KeyError: '-x'` dans `str.format()`. Remplacé
  par `a^2 + b^2 = c^2` (sans accolades) dans
  [response_system_prompt_base.txt](apps/api/src/domains/agents/prompts/v1/response_system_prompt_base.txt).

#### Removed

- **Image de fond + parallax sur la page chat** — suppression complète du
  hook `useDeviceParallax` (orphelin après cleanup) et de l'image de fond
  dans [[lng]/dashboard/chat/page.tsx](apps/web/src/app/[lng]/dashboard/chat/page.tsx).
  Interface chat plus épurée, performance mobile améliorée.

#### Dependencies

- Ajout : `remark-math@^6`, `rehype-katex@^7`, `katex@^0.16`,
  `@radix-ui/react-tooltip@^1.2`, `react-syntax-highlighter@^16` +
  `@types/react-syntax-highlighter` (frontend).
- Ajout dev : `polib` (backend — pour compiler les `.po` → `.mo` via
  `scripts/i18n/compile_translations.py`).

## [1.16.8] - 2026-04-20

### Rich Skill Outputs — Interactive Frames, Images & Runtime Conventions

Les skills ne sont plus limités à du texte. Cette release introduit un **contrat de sortie enrichi** (`SkillScriptOutput`) qui permet à un skill de retourner, en plus du texte, une **frame HTML interactive** (iframe sandboxée avec srcDoc ou URL externe) et/ou une **image statique**. Les trois champs sont indépendants et combinables — le script décide, l'application route. Le pipeline existant (Data Registry → SSE `registry_update` → sentinel HTML → composant React) a été répliqué pour les skills avec un nouveau type `SKILL_APP`, un sentinel dédié et un widget frontend `SkillAppWidget`. Cinq nouveaux skills systèmes illustrent le contrat (interactive-map, weather-dashboard, calendar-month, qr-code, pomodoro-timer, unit-converter, dice-roller). Le skill-generator et le guide utilisateur sont mis à jour en conséquence, avec documentation complète des conventions runtime (paramètres auto-injectés `_lang`/`_tz`, synchronisation thème/langue, auto-resize iframe, interactivité client-side sous CSP stricte).

#### Added

- **Contrat `SkillScriptOutput`** — modèle Pydantic (`src/domains/skills/script_output.py`) définissant le JSON écrit sur stdout par les scripts Python : champ `text` obligatoire, champs `frame` et `image` indépendants et combinables. `frame.html` XOR `frame.url` (srcDoc vs iframe externe), taille HTML bornée à `SKILLS_FRAME_MAX_HTML_BYTES = 200 KB`. Parser `parse_skill_stdout` tolérant : stdout non-JSON → dégradation en texte brut (rétrocompat totale).
- **Type `RegistryItemType.SKILL_APP`** et builder `build_skill_app_output` (`src/domains/skills/output_builder.py`) qui produit un `UnifiedToolOutput.data_success` avec `RegistryItem` typé, injection automatique d'un `<meta http-equiv="Content-Security-Policy">` strict pour les skills utilisateur (skills système exemptés — admin de confiance), et snippet auto-resize + theme-sync ajouté aux frames inline.
- **`SkillAppSentinel`** (`src/domains/agents/display/components/skill_app_sentinel.py`) — rendu HTML sous forme de `<div class="lia-skill-app" data-registry-id="…">` calqué sur `MCPAppSentinel`. Détecté côté React (`MarkdownContent.tsx`) et remplacé par `<SkillAppWidget>`.
- **`SkillAppWidget`** (`apps/web/src/components/chat/SkillAppWidget.tsx`) — rend séquentiellement `image` (via `ImageLightbox`) puis `frame` (iframe sandbox `allow-scripts allow-popups`, pas `allow-same-origin`, background transparent). Caption `text_summary` pour l'accessibilité.
- **Hook `useSkillAppBridge`** (`apps/web/src/hooks/useSkillAppBridge.ts`) — bridge `postMessage` minimaliste : `ui/initialize` (host info + theme + locale), `ui/notifications/size-changed` (resize iframe), `ui/open-link` (HTTPS only), push proactif de `ui/theme-changed` et `ui/locale-changed` sur iframe `load`, `MutationObserver` sur `<html class>` et `<html lang>` pour propagation live. **Délibérément sans** `tools/call`, `resources/read`, `ui/download-file` (attack surface réduite).
- **Auto-injection `_lang` et `_tz`** — `run_skill_script` enrichit automatiquement les paramètres du script avec la langue et le fuseau horaire de l'utilisateur, sans intervention du LLM ReAct.
- **Sept nouveaux skills systèmes** :
  - `interactive-map` (frame URL Google Maps embed) — affiche un lieu sur une carte.
  - `weather-dashboard` (frame HTML) — météo 5 jours avec icônes et gradients alignés OpenWeatherMap (11 groupes de conditions).
  - `calendar-month` (frame HTML) — vue mensuelle interactive d'un mois donné.
  - `qr-code` (image) — génération QR code via `segno` (pure-Python, bundled).
  - `pomodoro-timer` (frame HTML) — minuteur 25/5 interactif.
  - `unit-converter` (frame HTML) — conversion d'unités temps réel.
  - `dice-roller` (frame HTML) — lancer de dés avec animation, CSPRNG (`crypto.getRandomValues` + rejection sampling), re-roll depuis la frame.
- **Interactivité client-side** — pattern documenté : pas de `onclick` inline (CSP stricte), utilisation de `addEventListener` dans un `<script>`, CSPRNG pour les tirages aléatoires, animation via `cloneNode` + `replaceChild`.
- **Constante `SKILLS_FRAME_MAX_HTML_BYTES`** (`src/core/constants.py`) — borne supérieure de taille du HTML inline, enforced par validator Pydantic.
- **Dépendance `segno>=1.6.0`** dans `requirements.txt` — génération de QR codes pure-Python, sans Pillow.
- **Mise à jour skill-generator** (`data/skills/system/skill-generator/`) — nouvelle section "Runtime Conventions (Visualizer / Generator)" dans `SKILL.md`, sous-sections "Auto-injected parameters", "Theme & locale sync", "Iframe auto-resize", "Client-side interactivity" dans `references/format-specification.md`, chapitre 6 "Interactive Visualizer — canonical pattern" (skill `coin-flip` complet : SKILL.md + render_coin.py) dans `references/archetype-examples.md`. Exemple QR mis à jour avec `segno` (au lieu de `qrcode` + Pillow).
- **Mise à jour guide utilisateur** (`apps/web/src/components/settings/SkillGuideModal.tsx`) — nouvelle section "Localization, theming and runtime conventions" dans l'onglet Advanced avec 3 cartes explicatives (`_lang`/`_tz`, `data-theme`, auto-resize) + 2 exemples de code (Generator `segno`, Interactive `coin-flip`). Champs `outputs` et `compatibility` ajoutés à la liste des frontmatter fields. 17 nouvelles clés i18n par locale (6 langues).

#### Changed

- **Rendu conditionnel des widgets interactifs** — nouveau `INTERACTIVE_WIDGET_TYPES = frozenset({SKILL_APP, MCP_APP, DRAFT})` (`src/domains/agents/data_registry/models.py`). Le rendu dans `response_node` est désormais séparé en deux chemins : Path 1 (widgets interactifs) toujours injectés indépendamment du `user_display_mode` (HTML / Markdown / Cards), Path 2 (data cards) conditionnel sur le mode `CARDS`. Avant le fix, les frames de skills étaient invisibles pour les utilisateurs en mode "HTML enrichi" ou "Markdown".
- **Injection des instructions skill dans le prompt** — `skills_context` n'est plus interpolé dans `response_system_prompt_base.txt` mais injecté comme 2ᵉ message système dédié avec préfixe "SKILL INSTRUCTIONS CONTRACT (PRIORITY: HIGHEST)" et override explicite des `<ResponseGuidelines>`. L'effet de primauté (primacy-effect) du LLM honore désormais les `references/*.md` du skill actif au lieu des règles génériques.
- **Règle `<ResponseGuidelines>` enrichie** — directive ajoutée : quand un skill est actif, ses instructions l'emportent sur les formats par défaut.
- **Initiative proactive désactivée pendant l'exécution d'un skill** — évite les digressions cross-domaine du mode ReAct quand le skill est souverain sur sa réponse.
- **Auto-resize iframe via `getBoundingClientRect().bottom`** — remplace `Math.max(scrollHeight, offsetHeight)` qui incluait le viewport de l'iframe (frames météo systématiquement trop hautes). Pattern iframe-resizer. CSS reset avec `body{background:transparent!important}` pour que le thème de l'hôte soit visible.
- **Coercion des paramètres `run_skill_script`** — helper `_coerce_parameters(value: dict | str | None)` accepte désormais les chaînes JSON (contournement du modèle Qwen qui sérialise parfois `parameters` comme string). Évite les boucles infinies / `GraphRecursionError`.
- **Settings "Skills intégrées" et "Mes skills importées"** — sections collapsibles fermées par défaut (évite la surcharge visuelle quand l'utilisateur a beaucoup de skills). Chevron rotate -90° à l'état fermé.
- **Tables de traduction inline dans les skills** — `_WEEKDAYS_LONG/SHORT` et `_MONTHS_LONG/SHORT` pour les 6 langues (fr/en/es/de/it/zh), au lieu de `strftime` + `setlocale` (les locales POSIX ne sont pas installées dans le container).

#### Fixed

- **Frames skills invisibles en modes "HTML enrichi" / "Markdown"** — `user_display_mode != CARDS` court-circuitait toute injection HTML. Les widgets interactifs (SKILL_APP, MCP_APP, DRAFT) sont maintenant toujours rendus.
- **Frames météo en thème clair malgré l'app en thème sombre** — race condition : l'iframe émettait `ui/initialize` avant le mount du handler React. Fix : push proactif `ui/theme-changed` sur `load` event avec double `requestAnimationFrame`, `MutationObserver` en secours.
- **Dates météo affichées en anglais malgré la locale `fr`** — `strftime` tombait silencieusement en fallback US car `fr_FR.UTF-8` n'est pas installé dans le container. Tables de traduction inline par locale.
- **Dice-roller : même valeur pour 2 dés + pas d'animation + pas de re-roll** — `plan_template` figeait `notation: "1d6"` pour toutes les requêtes. Skill migré en A1 (script-only) avec parser regex tolérant. JS client avec CSPRNG + rejection sampling pour distribution uniforme.
- **Qwen : `parameters` envoyés comme string JSON → GraphRecursionError** — coercion automatique ajoutée.
- **Background iframe blanc en thème sombre** — CSS reset `body{background:transparent!important}` + `<iframe style="background:transparent">` + conversion des media queries `prefers-color-scheme` en sélecteurs `html[data-theme="dark"]` (plus fiable, synchronisé avec l'app).
- **Skill LLM ReAct n'appelle pas `run_skill_script`** — prompts reformulés pour généraliser : "use run_skill_script for validation, computation OR rich outputs".

#### Removed

- Aucune API publique retirée — rétrocompatibilité totale avec les scripts qui retournent du texte brut.

#### Documentation

- **`data/skills/system/skill-generator/SKILL.md`** — section "Runtime Conventions (Visualizer / Generator)" avec paramètres auto-injectés, thème via `[data-theme]`, `segno` pour QR, auto-resize, interactivité.
- **`data/skills/system/skill-generator/references/format-specification.md`** — section "Runtime Conventions" (4 sous-sections), frontmatter `outputs: [text|frame|image]`.
- **`data/skills/system/skill-generator/references/archetype-examples.md`** — chapitre 6 "Interactive Visualizer — canonical pattern" (skill `coin-flip` complet).
- **`data/skills/system/skill-generator/scripts/validate_skill.py`** — validation du frontmatter `outputs`, check de présence d'un script Python si `frame`/`image` déclaré, lint AST léger.
- **`apps/web/src/components/settings/SkillGuideModal.tsx`** — section "Localization, theming and runtime conventions" dans Advanced avec 3 cartes + 2 exemples.
- **`docs/guides/GUIDE_TOOL_CREATION.md`** — section "Rich Skill Outputs" ajoutée (schéma JSON, exemples, conventions, sécurité).
- **`docs/knowledge/12_skills.md`** — contrat `SkillScriptOutput` documenté.
- **`docs/technical/SKILLS_INTEGRATION.md`** — flow Data Registry pour skills, détails SKILL_APP.

## [1.16.7] - 2026-04-19

### Proactive Weather — Temperature Detection Fix + Travel Location (ADR-073)

Deux évolutions complémentaires du système de notifications proactives météo. D'abord, un **correctif du détecteur de chute de température** qui produisait des faux positifs quotidiens en confondant le cycle jour/nuit naturel avec un changement climatique réel : le code comparait la température courante avec chaque entrée forecast des 24 prochaines heures, donc une notification envoyée en fin d'après-midi flaggait systématiquement les températures nocturnes comme « chute ». Remplacé par une comparaison **moyenne du jour vs moyenne du lendemain** (bucketée par date locale), qui filtre naturellement le bruit diurne et capture les vraies transitions climatiques — chute **et** hausse désormais détectées. Ensuite, un **mécanisme de localisation en déplacement** (opt-in, chiffré, non historisé) pour que les notifications météo restent pertinentes quand l'utilisateur est loin de son domicile : la cascade `last_known (récent + > 50 km du domicile) > home` reproduit en mode asynchrone le comportement déjà exposé par le tool conversationnel `quelle météo` (cas implicite : `browser > home`).

#### Added

- **Détection de hausse de température (`temp_rise`)** en plus de `temp_drop` — comportement symétrique, même seuil `HEARTBEAT_WEATHER_TEMP_CHANGE_THRESHOLD`. Utile pour anticiper la tenue à prévoir pour le lendemain dans les deux sens.
- **Last-known location persistée côté serveur** — 3 colonnes ajoutées au modèle `User` : `last_known_location_encrypted` (Fernet JSON `{lat, lon, accuracy}`), `last_known_location_updated_at` (UTC), `weather_use_last_known_location` (opt-in, default `false`). Migration `last_known_loc_001`.
- **3 nouveaux endpoints `/auth/me/*`** :
  - `PATCH /weather-location-preference` — toggle opt-in (désactivation → wipe immédiat).
  - `PUT /last-location` — push d'une géolocalisation (403 si opt-out, 200 `throttled=True` si < 30 min depuis le dernier push).
  - `GET /last-location` — vue transparence RGPD avec flag `stale` basé sur le TTL configuré.
- **Service `UserLocationService`** avec la cascade `get_effective_location_for_proactive(user)` : retourne `(lat, lon, "home"|"last_known")`. Réutilise `_haversine_distance` existante et la clé Fernet globale.
- **Hook fire-and-forget dans `stream_chat_response`** — quand l'utilisateur a opt-in et que le frontend envoie une `BrowserGeolocation` dans le chat request, la position est persistée en arrière-plan via `safe_fire_and_forget`, sans bloquer la réponse. Opt-in et throttle 30 min enforcés côté serveur.
- **Reverse geocoding avec cache Redis** — `resolve_city_name(lat, lon, api_key)` dans `domains/heartbeat/geocoding.py` appelle l'API OpenWeatherMap reverse, cache Redis 30 jours sur bucket 3 décimales (≈100 m, partageable entre utilisateurs car coordonnées publiques). Le nom de ville est injecté dans le contexte du prompt `heartbeat_decision` (nouvelle règle 16 : obligation d'inclure la ville dans le message quand l'utilisateur est en déplacement, pour transparence).
- **Auto-wipe cascadé** — la suppression de `home_location` déclenche automatiquement le wipe de `last_known_location` : sans domicile comme référence, la cascade n'a plus de sens.
- **4 nouvelles constantes centralisées** dans `src/core/constants.py` — `LAST_KNOWN_LOCATION_TTL_HOURS_DEFAULT=24`, `_MIN_DISTANCE_KM_DEFAULT=50.0`, `_UPDATE_THROTTLE_MINUTES=30`, `_GEOCODE_CACHE_TTL_SECONDS=30j`.
- **2 settings `.env`** — `LAST_KNOWN_LOCATION_TTL_HOURS`, `LAST_KNOWN_LOCATION_MIN_DISTANCE_KM`.
- **3 métriques Prometheus** — `heartbeat_weather_location_source_total{source}`, `user_location_put_total{result}`, `user_location_geocode_total{result}`. Enregistrées au startup via l'import top-level du service.
- **UI `WeatherLocationBlock`** intégrée dans la section « Notifications proactives » (HeartbeatSettings) : toggle opt-in, note de confidentialité, alerte si geoloc navigateur désactivée, vue de la position stockée (coordonnées + fraîcheur + flag `stale`), bouton « Effacer maintenant ». 6 langues.
- **Tests** — 16 unitaires pour `UserLocationService` (update / throttle / forbidden / wipe / stale / cascade 5 branches), 9 pour `geocoding` (cache hit/miss, fallback API), 8 intégration pour les endpoints (opt-in/out, 403, throttle, DELETE home → wipe cascadé).
- **ADR-073** et runbook dédié (`docs/runbooks/LAST_KNOWN_LOCATION.md`).

#### Changed

- **`_detect_weather_changes` refondu côté température** — remplace la boucle `current.temp − entry.temp > threshold` qui générait des faux positifs nuit (ex : notif à 16h flaggait systématiquement la baisse nocturne à 2h du matin) par une comparaison **des moyennes quotidiennes** : entries bucketées par date locale → `avg_today` vs `avg_tomorrow` → déclenchement `temp_drop`/`temp_rise` si `|diff| > threshold`. Garde-fou : au moins 2 entries par bucket sinon la détection est skippée (protège contre les calculs biaisés près de minuit local). `expected_at` positionné à midi local du lendemain.
- **Forecast étendu à 48 h** (`cnt=8` → `cnt=16`) pour couvrir le lendemain complet quelle que soit l'heure d'envoi du heartbeat.
- **`_fetch_weather_with_changes` enrichi** — retourne désormais un tuple `(current, changes, source, city)` au lieu de `(current, changes)`. La source (`"home"`/`"last_known"`) et le nom de ville résolu sont propagés dans `HeartbeatContext` (nouveaux champs `weather_location_source`, `weather_location_city`) pour que le prompt LLM puisse mentionner explicitement la ville.
- **`HeartbeatContext.to_prompt_context()`** — la section CURRENT WEATHER inclut maintenant le nom de ville et un suffixe `(at home)` / `(away from home)` pour que le LLM n'ait aucune ambiguïté sur la localisation du forecast.
- **Prompts heartbeat v1** — nouvelle règle 16 dans `heartbeat_decision_prompt.txt` : obligation d'inclure la ville dans `message_draft` quand `weather_location_city` est disponible et source=`last_known`. Instruction de préservation de la ville dans `heartbeat_message_prompt.txt` lors de la réécriture de style.
- **UI settings** — la section « Localisation météo en déplacement » est intégrée dans la carte existante **Notifications proactives** (pas une nouvelle section), ce qui garde la page settings compacte et aligne la feature sur son contexte d'usage.

#### Fixed

- **Faux positifs `temp_drop` nocturnes** — les notifications « chute de température de X°C » apparaissaient quasi quotidiennement car la logique comparait la température de l'instant avec celle des heures à venir sur 24 h : toute entrée forecast nocturne déclenchait mécaniquement le seuil, même en l'absence de tout changement climatique. Remplacé par la comparaison des moyennes journalières qui lisse par nature le cycle jour/nuit (voir `Changed`).
- **Notifications météo non pertinentes en voyage** — quand l'utilisateur partait plusieurs jours loin de son domicile, les notifications heartbeat continuaient de parler du temps à son adresse `home`. Résolu par la cascade last-known opt-in (`> 50 km` + `< 24 h` de fraîcheur).
- **Counter `user_location_put_total{result="forbidden"}` pollué** — le hook chat appelait le service pour chaque message avec geoloc, même pour les utilisateurs non opt-in, incrémentant `forbidden` comme cas normal et masquant les vrais abus. Fix : check opt-in silencieux **avant** le service dans `update_user_location_fire_and_forget`. `forbidden` est désormais réservé aux appels explicites PUT en état opt-out (abus ou désync frontend).
- **Cohérence conversationnelle** — le tool météo implicite (`"quelle météo"`) utilisait déjà `browser > home` en runtime ; la notification proactive parlait exclusivement de `home`. Asymétrie supprimée : même logique des deux côtés, avec un browser persisté pour les jobs asynchrones.

#### Removed

- Aucune dépendance ajoutée, aucun package retiré.

#### Documentation

- **`docs/architecture/ADR-073-Last-Known-Location-Persistence.md`** — nouvelle ADR (scope, cascade, privacy-by-design, non-goals, alternatives rejetées).
- **`docs/architecture/ADR_INDEX.md`** — entrée ADR-073, compteur 72 → 73.
- **`docs/INDEX.md`** — compteur 72 → 73, arbre docs mis à jour.
- **`docs/runbooks/LAST_KNOWN_LOCATION.md`** — nouveau runbook (ops : wipe manuel, métriques attendues, troubleshooting, incident playbook).
- **`docs/technical/HEARTBEAT_AUTONOME.md`** — 2 settings `.env` ajoutés au tableau, nouveau champ user, nouvelle section « Location cascade (Phase 3 — ADR-073) », description `temp_drop`/`temp_rise` alignée sur la logique J vs J+1.

## [1.16.6] - 2026-04-18

### Long-Term Memory — Precision Overhaul

Refonte complète du pipeline mémoire long-terme (extraction + rétention + consolidation). Le prompt d'extraction manquait de critères explicites sur ce qui mérite d'être mémorisé et comment formuler les souvenirs pour un recall sémantique efficace. La formule de rétention combinait trois signaux dont un (`usage_count`) était toxique (éligibilité sémantique ≠ utilité réelle) et un autre (`recency_factor`) était cassé en pratique (la même constante servait de gate et de dénominateur, le facteur tombait à 0 au moment exact où l'évaluation devenait possible). Des doublons quasi-identiques s'accumulaient sans mécanisme de consolidation. Cette release adresse ces trois axes en bloc.

#### Added

- **Job `memory_consolidation` quotidien à 5 h UTC** — fusionne les paires de mémoires avec similarité cosine ≥ 0.9. Exclut les mémoires épinglées (côté SQL via `WHERE NOT (a.pinned OR b.pinned)`), les paires de catégories différentes, et les paires avec écart d'`emotional_weight` > 5. Cascade de sélection du survivor : `importance > content length (completeness) > created_at (recency)` — `usage_count` délibérément absent du critère. Plafond 50 paires/user/run. Lock Redis distribué pour multi-worker safety.
- **Tag `[PINNED]` dans le prompt d'extraction** — les mémoires verrouillées par l'utilisateur sont désormais annotées dans la section `EXISTING MEMORIES` et le LLM reçoit la règle explicite _"NEVER emit update or delete for them"_. Évite les actions rejetées downstream (économie de tokens output + moins de bruit dans les logs).
- **Détection active de contradictions factuelles** — règle explicite dans le prompt : _"if any existing memory refers to the SAME entity and the new fact changes/enriches/contradicts it → emit update"_. Couplé à un seuil de dédup élargi, attrape les corrections utilisateur ("je suis chez Meta maintenant") qui créaient auparavant des doublons contradictoires.
- **9 nouveaux settings Pydantic exposés via `.env`** :
  - Consolidation (5) : `MEMORY_CONSOLIDATION_ENABLED`, `MEMORY_CONSOLIDATION_HOUR`, `MEMORY_CONSOLIDATION_SIMILARITY_THRESHOLD`, `MEMORY_CONSOLIDATION_MAX_PAIRS_PER_USER`, `MEMORY_CONSOLIDATION_EMOTIONAL_DIFF_SKIP`.
  - Rétention (4) : `MEMORY_MIN_AGE_FOR_CLEANUP_DAYS`, `MEMORY_RECENCY_DECAY_DAYS`, `MEMORY_USAGE_PENALTY_AGE_DAYS`, `MEMORY_USAGE_PENALTY_FACTOR`.
- **2 settings dédup exposés (étaient constantes figées)** : `MEMORY_DEDUP_SEARCH_LIMIT`, `MEMORY_DEDUP_MIN_SCORE`.
- **Log structuré `memory_action_applied`** sur chaque `create`/`update`/`delete` mémoire avec `user_id`, `category`, `importance`, `emotional_weight`, `trigger_topic`, `content_preview`. Alimente Loki pour calibration fine.
- **26 tests unitaires** couvrant la calibration de la formule de rétention (importance 0.5 purgée à 30 j, importance 0.9 préservée, pénalité zero-usage), la cascade de sélection du survivor, les règles de skip, et le tag `[PINNED]`.

#### Changed

- **Prompt d'extraction entièrement réécrit** (`memory_extraction_prompt.txt`) — remplace l'ancienne structure ambiguë (règles monolithiques, _"Exact words only"_ absolutiste, catégories sans définitions) par :
  - Sections explicites `WHAT TO EXTRACT` (4 critères positifs : utilité durable, stabilité, unicité, actionabilité) et `WHAT NOT TO EXTRACT` (4 critères négatifs avec exemples).
  - Règle 2 assouplie : _"Facts exact, affect interpretable"_ — interprétation émotionnelle autorisée, inférences psychologiques toujours interdites.
  - Nouvelle règle `Semantic recallability` — formuler le `content` et le `trigger_topic` en concepts canoniques qui matcheront les requêtes futures.
  - Nouvelle règle `Content language` — produire dans la langue du message utilisateur (structures JSON en anglais).
  - Définitions précises des 6 catégories + règle de décomposition atomique en cas d'ambiguïté.
  - Bandes explicites pour `emotional_weight` (0 / ±1-2 / ±3-6 / ±7-10) et `importance` (0.3 / 0.5 / 0.7 / 0.9) avec ancres concrètes.
  - 3 few-shot examples (extraction nominale, rejet de bruit, correction contradictoire via `update`).
- **Formule de rétention refondue** — `score = 0.7 * importance + 0.3 * recency_factor` avec pénalité négative `score *= 0.5` si `usage_count == 0` et `age_days > 30`. L'ancienne formule `0.4 * usage_boost + 0.3 * importance + 0.3 * recency_boost` avait trois problèmes : `usage_count` était un signal toxique (éligibilité sémantique ≠ utilité réelle, taux de faux positifs), `recency_factor` était quasi systématiquement à 0 (bug de configuration), et `importance` à 0.3 de poids n'était pas assez dominant.
- **Gate d'éligibilité séparé du decay** — `MEMORY_MIN_AGE_FOR_CLEANUP_DAYS = 7` (protection nouveau-né) indépendant de `MEMORY_RECENCY_DECAY_DAYS = 45` (horizon de décroissance). Résout le bug où `recency_factor` valait toujours 0 dès qu'une mémoire devenait éligible.
- **Seuil de dédup extraction abaissé** 0.5 → 0.4 (`MEMORY_DEDUP_MIN_SCORE`) pour élargir la fenêtre de détection des contradictions factuelles sans surcoût LLM (seulement +50-100 tokens d'input par run, amortis par cache).
- **`logger.exception()` remplace `logger.error()`** dans les handlers globaux de `memory_cleanup.py` et `memory_consolidation.py` pour capturer la stack trace complète dans Loki.
- **Docstrings et noms de paramètres** — `max_age_days` renommé `min_age_for_cleanup_days` partout (repository + scheduler) pour refléter la vraie sémantique.

#### Fixed

- **`recency_factor` toujours à 0 en pratique** — `MEMORY_MAX_AGE_DAYS = 2` servait à la fois de gate d'éligibilité ET de dénominateur du decay linéaire. Conséquence : toute mémoire évaluée avait `recency_factor ≤ max(0, 1 - 2/2) = 0`. La formule reposait de facto uniquement sur `usage_count` (toxique). Corrigé par séparation des deux horizons.
- **Mémoires d'importance moyenne (0.5) jamais purgées** malgré leur âge — critère produit non respecté. Désormais purgées autour de 30 jours avec la formule recalibrée.
- **Corrections factuelles créaient des doublons contradictoires** — ex : mémoire existante _"Je travaille chez Google"_ + utilisateur dit _"J'ai changé, je suis chez Meta"_ → la dédup à 0.5 n'attrapait pas la relation (sémantiquement divergente), le LLM émettait `create` au lieu de `update`. Résolu par seuil élargi + règle de détection active dans le prompt.
- **Protections obsolètes dans la documentation ADR** (filtres par catégorie `sensitivity`, par `abs(emotional_weight) >= 7`, par `emotional_protection_threshold`) qui n'étaient **jamais implémentées** dans le code réel. Les docs citaient un système plus riche que la réalité. Harmonisé — seules les deux protections effectives restent documentées : `pinned = True` et grace period.
- **`existing_similar` debug loupait les contradictions** — seuil élargi de 0.5 à 0.4 fait apparaître les candidats quasi-contradictoires dans le debug panel pour calibration.

#### Removed

- **3 settings obsolètes** : `memory_max_age_days`, `memory_min_usage_count`, `memory_retention_weight_usage` — remplacés par la nouvelle modélisation.
- **Ordre de priorité des catégories** dans le prompt d'extraction — confusion initiale entre priorité d'affichage (dans le profil psycho) et priorité de classification (à l'extraction). Remplacé par des définitions précises + règle de décomposition atomique.
- **Règle _"Exact words only"_** du prompt d'extraction — remplacée par _"Facts exact, affect interpretable"_ pour permettre l'interprétation émotionnelle implicite tout en interdisant le diagnostic psychologique.

#### Documentation

- `docs/architecture/ADR-037-Semantic-Memory-Store.md` — formule de rétention et pointer vers `memory_consolidation.py` ajouté.
- `docs/architecture/ADR-042-Conversation-Lifecycle-Management.md` — formule de rétention et `_is_protected` simplifié (suppression des protections docs-only non implémentées).
- `docs/architecture/ADR-046-Background-Job-Scheduling.md` — ligne `memory_consolidation` dans le tableau des jobs + bloc `calculate_retention_score` / `should_purge` réécrit.
- `docs/ARCHITECTURE.md` — `memory_consolidation` ajouté à la liste des cron jobs APScheduler.
- `docs/guides/GUIDE_BACKGROUND_JOBS_APSCHEDULER.md` — exemples de settings alignés sur la nouvelle API.

## [1.16.5] - 2026-04-18

### Tool Context Manager — Two-Keys Simplification (ADR-072)

Refonte structurelle du Tool Context Manager : passage de 3 clés persistantes (`list` / `details` / `current`) à 2 clés (`list` + `current`). Le cache LRU `details` — vestige de l'époque où les tools de recherche renvoyaient des vues résumées — n'était plus lu en source primaire depuis que les tools unifiés (`get_events_tool`, etc.) retournent systématiquement le payload complet. Sa suppression élimine à la racine trois classes de bugs.

#### Fixed

- **Bug 1 — double auto_save avec pollution du cache `details`** : le décorateur `@auto_save_context` et `parallel_executor._auto_save_wave_contexts` sauvegardaient le même résultat deux fois. Lorsque le manifest n'avait plus de `context_save_mode` explicite, la seconde passe classifiait `get_events_tool` comme DETAILS (match sur `"get"`), polluant le cache. Résolu par un sentinel `_tcm_saved` dans `tool_metadata` que le parallel_executor respecte.
- **Bug 2 — `current_item` mauvais après création/update HITL** : `_set_current_item_after_execution` appelait `save_details` qui cherchait l'item par `primary_id_field="id"`, mais `execute_event_draft` retourne `event_id`. Le lookup échouait, l'item n'était pas indexé, et le fallback `indexed_items[-1]` pointait sur un ancien rdv du cache. Résolu par un appel direct à `set_current_item` (pas de primary_id lookup à l'écriture).
- **Bug 3 — `current_item` stale après évocation linguistique** : après création/update d'un rdv, `current` restait sur lui. Si l'utilisateur disait ensuite `"c'était quoi le premier rdv ?"` puis `"supprime ce rdv"`, `current` n'était pas actualisé par la résolution ordinale et la suppression ciblait l'ancien item. Résolu en rendant `ContextResolutionService` writer de `current_item` : toute résolution réussie met à jour le focus (1 item → set, N>1 → clear).
- **Bug 4 — `turn_type` convention mismatch** : `QueryIntelligence.turn_type` émettait `"REFERENCE_ACTION"` (UPPERCASE) tandis que les consumers comparaient contre `TURN_TYPE_REFERENCE = "reference"` (lowercase). Les turns de référence étaient silencieusement traités comme conversationnels, privant le response_node du `resolved_context` pour grounding. Résolu par helpers `is_reference_turn()` / `is_action_turn()` / `is_conversational_turn()` case-tolerant + normalisation `.lower()` à l'écriture dans le router.
- **Bug 5 — LIST stale après update/delete HITL** : les mutations HITL ne propagaient pas dans la LIST, qui contenait une version obsolète de l'item updated ou conservait un stub supprimé. Résolu par nouveau dispatcher `_sync_tcm_after_draft_execution` : create → set current ; update → set current + `update_item_in_list` ; delete → `remove_item_from_list` + safety-net clear current.

#### Changed

- **HITL update template — structure en 2 blocs étiquetés** : le template `hitl_draft_critique_prompt.txt` pour les drafts `*_update` a été réécrit. Plus d'étiquette auto-générée « Autres détails inchangés » contredite par un résumé qui incluait les valeurs modifiées. Deux blocs explicites maintenant : `{L_Modifications}` (seulement les champs qui changent, format `~~ancien~~ → nouveau`) et `{L_Full_post_update}` (snapshot complet post-update).
- **i18n HITL** : nouveaux labels `modifications` et `full_post_update` dans les 6 langues via `HitlMessages.get_draft_update_labels()`.
- **`ContextSaveMode` enum simplifié** : `{LIST, DETAILS, CURRENT, NONE}` → `{LIST, CURRENT, NONE}`.
- **`classify_save_mode` réduit à une règle** : mode explicite > défaut LIST (plus de patterns heuristiques sur le nom du tool).
- **`ToolContextManager.update_item_in_list()`** : nouvelle méthode symétrique à `remove_item_from_list`, remplace un item dans la liste par primary_id_field, préserve l'index 1-based.

#### Removed

- `save_details()`, `get_details()`, `ToolContextDetails` — remplacés par le design à 2 clés.
- `tool_context_details_max_items` (setting), `TOOL_CONTEXT_DETAILS_MAX_ITEMS` (constante) et son entrée dans `.env.example` — dead config après suppression du cache DETAILS.
- 2 fallbacks DETAILS dans `calendar_tools._resolve_calendar_id_from_context` et `hitl/parameter_enrichment` — remplacés par un lookup `list` + `current` secondaire.
- Décorateurs `@auto_save_context` redondants sur les tools legacy `search_events_tool`, `get_event_details_tool`, `search_emails_tool`, `get_email_details_tool` (déjà appliqués via `@connector_tool(context_domain=…)`).

#### Added

- `src/domains/agents/context/access.py` — helper `get_tcm_session(config) → TcmSession | None` qui centralise l'acquisition manager + store + user_id + session_id. Utilisé par `draft_executor` et `context_resolution_service`.
- `src/domains/agents/utils/turn_type.py` — helpers `is_reference_turn`, `is_action_turn`, `is_conversational_turn`, `normalize_turn_type` tolérants à la casse.
- Table canonique `_DOMAIN_ID_KEYS` dans `draft_executor.py` — source unique pour la dérivation de `_DRAFT_TYPE_TO_ID_KEYS`.

#### Documentation

- `docs/architecture/ADR-072-TCM-Two-Keys-Simplification.md` — nouvel ADR détaillant la décision, les 5 bugs résolus, les follow-ups 2026-04 (post-HITL list maintenance, turn_type unification, HITL template 2-blocs).
- `docs/architecture/ADR_INDEX.md` — entrée ADR-072 ajoutée.
- `docs/architecture/ADR-030-Context-Resolution-Follow-up.md` — note follow-up 2026-04 sur le two-keys design.
- `docs/ARCHITECTURE_AGENT.md` — section 16 (TCM) réécrite pour le design 2-clés + suppression des exemples `save_details` / `get_details`.
- `docs/INDEX.md` — compteur ADR mis à jour (72).
- `docs/technical/AGENT_MANIFEST.md` — `context_save_mode` documenté comme LIST/CURRENT/NONE.
- FAQ changelog (6 langues) mis à jour avec l'entrée v1.16.5.

## [1.16.4] - 2026-04-15

### Skill Identification — Semantic-Only, Unified

Replaced the domain-overlap heuristic by a unified semantic identification path. The `QueryAnalyzer` now reads all active skills (deterministic and non-deterministic) and picks the one whose description semantically matches the user's intent. `SkillBypassStrategy`, the planner guard, and the routing decider all consume that single signal.

Root cause addressed: on 2026-04-15 a production briefing request identified the correct skill semantically but still missed emails/tasks/reminders because the bypass required domain overlap that the `QueryAnalyzer` had partially classified as `web_search`.

#### Changed

- **`SkillBypassStrategy`**: `can_handle` is now a minimal presence check on `QueryIntelligence.detected_skill_name`; `plan` performs a user-scoped lookup via `SkillsCache.get_by_name_for_user(name, user_id)`, verifies the skill is deterministic and active, then builds the plan. No domain-overlap maths anywhere.
- **`_has_potential_skill_match` (planner guard)**: returns `True` whenever a skill has been identified, regardless of type. No cache lookup, no domain analysis.
- **QueryAnalyzer catalogue**: the deterministic-skill filter was removed from the visible set — the LLM can now identify any active skill by description. User/admin isolation preserved via `SkillsCache.get_for_user`.
- **QueryAnalyzer prompt**: strengthened instruction to match on whole-intent semantic alignment, not keyword presence; explicit warning that action compositions are not skill invocations unless a skill covers that composition; explicit separation of `skill_name` from `primary_domain`/`secondary_domains` to avoid LLM field confusion.
- **`RoutingDecider`**: new Rule 1 — when `detected_skill_name` is set, route to the planner regardless of the domains list (closes the hole where the LLM stored the skill in `skill_name` only and left domains empty, causing the previous "no domains → response" fallback to skip the planner entirely).

#### Fixed

- **`reconstruct_query_intelligence`** (pre-existing bug revealed by the refactor): the helper that rebuilds a `QueryIntelligence` from its serialized state dict was missing two fields — `detected_skill_name` and `is_app_help_query` — so the bypass and app-help guard could see `None` after checkpoint round-trips. Both fields are now correctly propagated.

#### Removed

- `plan_template.max_missing_domains` field (no longer read; leftover occurrences in user YAMLs are silently ignored).
- `SKILLS_EARLY_DETECTION_MAX_MISSING_DOMAINS` constant in `src/core/constants.py`.
- Removed `max_missing_domains: 2` from `briefing-quotidien` system skill.
- UI guide field, translations and YAML example reference for `max_missing_domains` (SkillGuideModal + 6 locales).

#### Documentation

- `docs/technical/SKILLS_INTEGRATION.md` — rewrote the "Deterministic Bypass" and "Early Detection Guard" sections; removed the `max_missing_domains` table row.
- `docs/technical/HITL.md` — updated the Skill Guard Bypass paragraph.
- `docs/knowledge/12_skills.md` — simplified the user-facing explanation of skill matching.
- Added ADR-071: Skill Semantic Identification (replaces the domain-overlap matching with a single semantic signal).
- Updated FAQ changelog (6 languages) with v1.16.4 entries.

## [1.16.3] - 2026-04-10

### Skill Bypass Relaxed Matching & Scope-Aware Filtering

Deterministic skill templates (e.g., daily briefing) were never triggered via `SkillBypassStrategy` because the `QueryAnalyzer` didn't detect all template domains for composite queries. The bypass required exact domain coverage (0 missing), while the early detection guard allowed 1 missing — a gap that caused the LLM planner to generate plans without email steps.

#### Fixed

- **Skill bypass now uses relaxed domain matching**: `SkillBypassStrategy.can_handle()` and `plan()` aligned with `_has_potential_skill_match()` — both now allow up to N missing domains instead of requiring exact coverage. The threshold is configurable per skill via `plan_template.max_missing_domains` (falls back to global `SKILLS_EARLY_DETECTION_MAX_MISSING_DOMAINS` constant, default: 1).
- **Scope-aware step filtering**: Template steps whose tools require OAuth scopes the user hasn't granted are filtered out before building the execution plan. This avoids a validation-fail → replan round-trip for users without a given connector (e.g., no Gmail → email step removed gracefully). `depends_on` references to removed steps are sanitized (shallow-copy to avoid cache mutation).
- **`oauth_scopes` injected into `RunnableConfig.configurable`**: `planner_node_v3` now injects `oauth_scopes` from state into the configurable dict, making them available to bypass strategies without interface changes.

### Daily Briefing Skill Enrichment

#### Added

- **Reminders in daily briefing**: New `get_reminders` step added to `briefing-quotidien` skill template using `reminder_agent` / `list_reminders_tool` (no OAuth required). Pending reminders are displayed between Emails and Notes sections. Empty section is hidden.
- **Per-skill `max_missing_domains`**: New optional field in `plan_template` YAML. The briefing skill sets `max_missing_domains: 2` to tolerate 2 undetected domains out of 5 (email + reminder often missed by QueryAnalyzer for "briefing" queries).

### Random Analyzing Phrases Restored

#### Changed

- **Router decision step shows random personality phrases**: Restored `getRandomAnalyzingMessage()` for the initial `router_decision` step, picking from the i18n `analyzingMessages` array (~30 witty phrases per language). All subsequent steps (planner, execution, HITL) keep their descriptive i18n labels.

### Documentation

- Updated `docs/technical/SKILLS_INTEGRATION.md` with relaxed matching, scope-aware filtering, `max_missing_domains` field, `reminder_agent` tool reference, and updated briefing example.
- Updated `docs/knowledge/12_skills.md` with skill matching and scope filtering documentation.
- Updated `apps/web/src/components/settings/SkillGuideModal.tsx` with `max_missing_domains` in example and field legend.
- Added `guide_modal_plan_field_max_missing_domains` i18n key in all 6 languages.
- Updated FAQ changelog (6 languages) with v1.16.3 entries.

## [1.16.2] - 2026-04-10

### Progressive Execution Step Display

Real-time visibility of execution steps during both Pipeline and ReAct modes. Previously, pipeline mode only showed a random "analyzing" phrase, and ReAct mode showed generic "Executing tool..." / "Reasoning..." messages. Steps are now accumulated and displayed persistently until the response arrives.

#### Added

- **Pipeline step visibility via LangGraph "updates" stream mode**: Added `stream_mode="updates"` to `graph.astream()`. Every pipeline node (router, planner, semantic_validator, approval_gate, task_orchestrator, response) now emits an `execution_step` SSE event with emoji + i18n label. Previously, only router_decision was visible — planner, semantic_validator, approval_gate, and task_orchestrator were completely invisible because they don't update the `messages` state key.
- **Per-tool execution steps in Pipeline mode**: When task_orchestrator completes, tool names are extracted from the ExecutionPlan and emitted as individual `execution_step` events (e.g., "📅 Retrieving events...", "🌤️ Fetching weather...").
- **Per-tool execution steps in ReAct mode**: When react_call_model produces an AIMessage with tool_calls, individual `execution_step` events are emitted for each tool using the catalogue's DisplayMetadata.
- **Reasoning detail in ReAct mode**: AIMessage content from react_call_model is extracted, truncated to 120 chars, and included as a `detail` field in the execution_step event.
- **Accumulated step display**: Frontend accumulates execution steps in a multi-line progress message (each step persists) instead of replacing each step. Capped at 10 visible steps with "... N previous steps" indicator.
- **Deduplication by i18n_key**: `emittedStepKeysRef` (Set) prevents duplicate step display between `router_decision`/`planner_metadata` handlers and `execution_step` events from "updates" mode.
- **52 new i18n keys for tool execution steps** (6 languages): Contacts CRUD, Calendar events, Emails/Labels, Tasks, Reminders, Drive files, Places, Routes, Weather, Wikipedia, Web Search (Brave/Perplexity/unified), Browser actions (nested), Hue smart lights, Image generation, Context tools, Knowledge base, DevOps, Sub-agents.

#### Fixed

- **`planner_metadata` SSE events were dead code**: Backend defined the event type in schema but never emitted it. Frontend handler existed but never received data. Pipeline steps now work via "updates" mode execution_step events.
- **3 orphaned i18n keys replaced**: `search_contacts`, `list_contacts`, `get_contact_details` → replaced with catalogue-aligned `get_contacts`, etc.
- **Singular pluralization**: Added `previous_steps_one`/`previous_steps_other` i18n plural forms for step cap indicator.

#### Changed

- **`_process_messages_chunk()` simplified**: Node transition detection removed (delegated to "updates" mode). Method now only handles token streaming from response node.
- **`getProgressMessage('router_decision')` uses real i18n step text**: Replaced random funny analyzing phrases with `execution.steps.router_decision` label for consistency with accumulated step display.

### Psyche Context Injection Consolidation

Systematic migration of all prompts from **string concatenation** to **template variable injection** for psyche context. Previously, psyche blocks were appended after template formatting via string concat, leaving them outside the XML structure. All prompts now use `{psyche_context}` placeholders resolved **before** `template.format()`.

#### Changed

- **6 prompt templates restructured with XML semantic blocks**: `fallback_response_prompt.txt`, `heartbeat_message_prompt.txt`, `voice_comment_prompt.txt`, `reminder_prompt.txt`, `interest_content_prompt.txt`, `response_system_prompt_base.txt` — all now use typed XML blocks (`<Personality purpose="voice-identity">`, `<InnerState purpose="tone-calibration">`, `<TaskContext purpose="grounding">`, `<ReminderContext purpose="what-to-remind">`, `<SourceMaterial purpose="content-to-present">`, `<Memory purpose="personalization">`, `<UserContext purpose="decision-filter">`, `<JournalContext purpose="behavioral-continuity">`, `<WebSearchContext purpose="factual-enrichment">`, `<UserDocuments purpose="personal-knowledge">`, `<AppKnowledge purpose="product-support">`) for LLM clarity. Each block includes explicit usage directives and fallback behavior when empty.
- **5 service files refactored**: `fallback_response.py`, `heartbeat/prompts.py`, `interests/proactive_task.py`, `voice/service.py`, `scheduler/reminder_notification.py` — psyche block resolved before template formatting.
- **3 service files cleaned**: `initiative_node.py`, `emails_tools.py`, `sub_agents/executor.py` — removed psyche injection entirely (non-pertinent contexts: analytical decisions, factual synthesis, user email content).
- **Memory extraction prompt overhauled**: Exhaustive temporal reference rules covering days, periods, times, months with concrete conversion examples. Explicit blacklist of relative terms ("today", "tomorrow", "next week", "soon", "recently", etc.).

#### Fixed

- **Proactive notification emotion projection** (user-facing): Notifications attributed the assistant's emotional state to the user (e.g., "Ta détermination du jour mérite mieux qu'un e-mail en suspens"). Root cause: psyche context was injected without usage directive, and the LLM conflated the assistant's inner state with the user's. Fixed via triple protection: safety guardrail in `build_psyche_prompt_block()`, `<InnerState>` wrapper directives in each prompt, and removal of psyche from non-user-facing prompts.
- **Dead instruction in heartbeat prompt**: Removed reference to "journal observations" that were not available in the message generation phase (journal entries are only in the decision phase context).

### Debug Panel Reorganization

#### Added

- **6 logical section groups with persistent headers**: Sections reorganized into — Request Analysis, Planning & Execution, Intelligent Mechanisms, Context Injection, Background Extraction, LLM & API Pipeline. Each group has a visible `SectionGroupHeader` separator.
- **Always-visible empty sections**: New `EmptySection` shared component replaces `return null` in all 15 conditional sections. Sections now always render with an "N/A" badge and placeholder content when no data is available, instead of disappearing entirely.

#### Fixed

- **6 accordion value mismatches**: EmptySection `value` props corrected to match their AccordionItem counterparts (hyphen vs underscore inconsistencies: `request-lifecycle`→`request_lifecycle`, `llm-pipeline`→`llm_pipeline`, etc.).
- **3 title inconsistencies**: EmptySection titles harmonized with AccordionTrigger titles (`Journal Injection`→`Personal Journals`, `RAG Injection`→`RAG Knowledge Spaces`, `Google API Calls`→`Google API`).
- **Circular import in EmptySection**: Changed `import { SectionBadge } from '../shared'` to direct import from `'./badges/SectionBadge'` to avoid barrel re-export cycle.

### Documentation

- Updated `docs/technical/REACT_EXECUTION_MODE.md` with streaming step visibility details.
- Updated `docs/ARCHITECTURE_LANGRAPH.md` with "updates" stream mode and per-tool events.
- Updated `docs/architecture/ADR-018-SSE-Streaming-Pattern.md` with execution_step event structure.
- Updated `docs/technical/PSYCHE_ENGINE.md` with template variable consolidation, injection point cleanup, and safety guardrail.
- Updated `docs/technical/DEBUG_PANEL_ARCHITECTURE.md` with 6-group section organization and EmptySection component.
- Updated `docs/architecture/ADR-068-Psyche-Engine.md` with v3 template variable injection pattern.
- Updated `docs/technical/PROMPTS.md` with psyche context via template variables pattern.
- Updated `docs/knowledge/02_chat.md` with execution step visibility user documentation.
- Updated `docs/knowledge/03_settings.md` with absolute temporal memory extraction.
- Updated `docs/knowledge/09_proactive_notifications.md` with tone calibration note.
- Updated `docs/knowledge/22_psyche.md` with non-projection guarantee.
- Updated `docs/technical/LONG_TERM_MEMORY.md` with 7-rule extraction prompt documentation.
- Updated `README.md` with 6-group debug panel table and psyche safety guardrail.
- Updated FAQ changelog (6 languages) with v1.16.2 entries (5 items incl. tone consistency and temporal memory).

## [1.16.1] - 2026-04-09

### Homogeneous LLM Config Resolution

Systematic enforcement that all runtime LLM configuration reads go through the centralized `get_llm_config_for_agent()` helper, which merges code defaults (`LLM_DEFAULTS`) with admin DB overrides (`LLMConfigOverrideCache`). Previously, several code paths read `settings.*_llm_*` directly, silently ignoring admin UI configuration changes.

#### Fixed

- **Interest content presentation bypass** (CRITICAL): `_present_content()` in `proactive_task.py` manually constructed `LLMAgentConfig` from 8 `settings.interest_content_llm_*` fields and called `get_llm("response", config_override=...)` — completely bypassing DB overrides. With Qwen provider, this caused truncated notifications (thinking mode consuming output tokens). Replaced with `get_llm("interest_content")`.
- **Stale model name in interest logging**: `settings.interest_content_llm_model` replaced with `get_llm_config_for_agent(settings, "interest_content").model` for accurate token tracking metadata.
- **Stale model name in heartbeat logging**: `settings.heartbeat_message_llm_model` and `settings.heartbeat_decision_llm_model` replaced with centralized config resolution.
- **Stale model in voice metrics**: Prometheus metric label `settings.voice_llm_model` replaced with centralized config resolution.
- **Semantic validator provider fallback**: `settings.semantic_validator_llm_provider` replaced with `get_llm_config_for_agent(settings, "semantic_validator").provider`.
- **Summarization middleware context window**: `settings.response_llm_model` fallback replaced with `get_llm_config_for_agent(settings, "response").model` for correct context window calculation.

### Documentation

- Updated `docs/technical/LLM_CONFIG_ADMIN.md` with runtime enforcement guarantee.
- Updated FAQ changelog (6 languages) with v1.16.1 entries.
- Updated docstring examples in `base_agent_builder.py` to show centralized config pattern.

## [1.16.0] - 2026-04-09

### ReAct Execution Mode (ADR-070)

User-toggleable alternative to the pipeline mode. The ReAct pattern enables iterative reasoning: the LLM observes each tool result, reasons about the next step, and decides whether to act again or finalize. Implemented as 4 custom nodes in the parent LangGraph graph (not a subgraph), with native HITL support via `interrupt()`.

#### Added

- **ReAct 4-node loop**: `react_setup` → `react_call_model` ↔ `react_execute_tools` → `react_finalize` → response.
- **Frontend toggle**: Zap icon in chat header, user preference persisted in DB (`users.execution_mode` column).
- **Timeout enforcement**: `react_start_time` in state + hard timeout check in routing function.
- **Skills in ReAct**: Filtered L1 skills catalogue injected as SystemMessage in `react_setup_node`. The 3 existing skill tools (`activate_skill_tool`, `run_skill_script`, `read_skill_resource`) are available.
- **Debug panel**: 4 ReAct nodes registered in `DEFAULT_NODE_METADATA` with i18n (6 languages).
- **Prometheus metrics**: 5 ReAct-specific metrics (`executions_total`, `iterations`, `duration_seconds`, `tools_called_total`, `hitl_interrupts_total`).
- **Initiative via prompt**: CROSS-CHECK step integrated in the ReAct workflow prompt (autonomous, no separate LLM call).
- **Alembic migration**: `execution_mode_001` adds `execution_mode` column to users table.

#### Fixed

- **Token tracking for OpenAI Responses API with tools**: `_fallback_to_chat_completions()` in `ResponsesLLM` now extracts `usage_metadata` from Chat Completions response and sets it on the AIMessage. Previously, all tokens from react_call_model were lost when using OpenAI models.
- **Node breakdown aggregation**: Token tracking summary now sums tokens across multiple executions of the same node (dict accumulation instead of overwrite). Fixes incorrect cost display for multi-iteration ReAct.
- **`current_turn_registry` merge**: Each ReAct iteration now merges with existing registry items from previous iterations, preventing loss of data cards.
- **Frontend `STREAM_START` idempotent**: Reducer checks for existing message before creating a new one. Prevents empty response display on first ReAct message.
- **`handleContentReplacement` simplified**: Always dispatches `STREAM_START` (safe with idempotent reducer) to guarantee `currentMessageId` is set.
- **ADR reference correction**: All 25+ code references changed from ADR-069 (Gemini Embedding) to ADR-070 (ReAct).
- **Test fixtures**: `execution_mode="pipeline"` added to `UserFactory`, test auth service, and user service factories.
- **LLM defaults count**: Test updated 48 → 49 for `react_agent` type.

### Documentation

- Created `docs/technical/REACT_EXECUTION_MODE.md` — comprehensive technical documentation.
- Updated `docs/INDEX.md`, `docs/ARCHITECTURE_LANGRAPH.md`, `docs/technical/GRAPH_AND_AGENTS_ARCHITECTURE.md`, `docs/technical/ROUTER.md`, `docs/technical/PLANNER.md`, `README.md` with ReAct references and diagrams.
- Updated FAQ changelog (6 languages) with v1.16.0 entries.

## [1.15.3] - 2026-04-10

### Similarity Threshold Calibration for Gemini Embedding-001

Comprehensive calibration of all 8 similarity thresholds using realistic test datasets (80 memories + 30 queries, 30 journal entries + 20 queries, 25 RAG chunks + 15 queries, 50 interest topics, 30 content articles, 16 journal dedup pairs). Precision/Recall/F1 analysis at each threshold to find optimal trade-off between noise (token waste) and recall (missed matches).

#### Changes

- **MEMORY_MIN_SEARCH_SCORE** (0.70 → 0.65): Previous value cut valid matches like "birthday" (0.666), "work" (0.654). New value: F1=0.519, avg 1.8 results/query with 80-memory bank. Cuts all unrelated noise (max 0.618).
- **MEMORY_RELEVANCE_THRESHOLD** (0.70 → 0.72): Purge protection now targets p75 of match scores (0.735). Only strongly relevant memories increment usage_count.
- **JOURNAL_CONTEXT_MIN_SCORE** (0.75 → 0.63): Previous value missed 4/12 matches. New value: F1=0.638, avg 1.1 entry/query. Journal behavioral directives match at 0.58–0.75 range.
- **JOURNAL_DEDUP_SIMILARITY_THRESHOLD** (0.75 → 0.87): Previous value was far too low for doc↔doc symmetric comparisons. New value: F1=0.889 (P=0.800, R=1.000). Catches all true duplicate entries while avoiding false merges on related-but-different content.
- **INTEREST_DEDUP_SIMILARITY_THRESHOLD** (0.82 → 0.89): New value: P=1.000, R=0.667, F1=0.800. Zero false merges — distinct interests like "Italian cuisine" vs "Japanese cuisine" (0.881) correctly kept separate.
- **INTEREST_CONTENT_SIMILARITY_THRESHOLD** (0.81 → 0.90): Clear separation gap — duplicate content scores 0.95+, different content max 0.84. Previous value blocked legitimate new articles.
- **QUERY_ENGINE_SIMILARITY_THRESHOLD** (0.85 → 0.93): SequenceMatcher string-based (not embeddings). Avoids false positives like "same name, different email domain" (0.922).
- **RAG_SPACES_RETRIEVAL_MIN_SCORE** (0.60 → 0.55): Hybrid score (0.7×semantic + 0.3×BM25) compresses the range. Semantic-only best F1 at 0.67 ≈ 0.55 hybrid.

#### Calibration Scripts

- New `scripts/test_similarity_thresholds_v2.py` — Large-scale calibration script with realistic user profile data (81 memories, 30 journal directives, 25 RAG chunks, 20 interests, 15 recent articles). Computes P/R/F1 at every threshold for each domain.

### LLM Configuration Alignment

#### Changes

- **Power tier adjustments** — `memory_extraction`, `interest_extraction`, `journal_extraction`: HIGH (orange) → MEDIUM (blue). `mcp_react_agent`: CRITICAL (red) → HIGH (orange). `mcp_app_react_agent`: CRITICAL (red) → HIGH (orange).
- **LLM defaults aligned with production config** — Code defaults (`LLM_DEFAULTS`) now reflect proven production configuration:
  - `memory_extraction`: qwen/qwen3.5-plus → openai/gpt-5.4-mini, reasoning_effort: low
  - `interest_extraction`: qwen/qwen3.5-plus → openai/gpt-5.4-mini, reasoning_effort: low
  - `journal_extraction`: qwen/qwen3.5-plus → openai/gpt-5.4-mini, reasoning_effort: low
  - `mcp_react_agent`: anthropic/claude-opus-4-6 → qwen/qwen3.6-plus, temp 0.2, max_tokens 20000, reasoning_effort: medium
  - `mcp_app_react_agent`: anthropic/claude-opus-4-6 → qwen/qwen3.6-plus, temp 0.5
  - `heartbeat_decision`, `interest_content`, `journal_consolidation`: reasoning_effort: none → low

### Documentation

- Updated `docs/technical/LONG_TERM_MEMORY.md` with calibrated threshold values.
- Updated `docs/technical/JOURNALS.md` with calibrated threshold values.
- Updated `docs/technical/INTERESTS.md` with calibrated threshold values.
- Updated `docs/technical/LLM_CONFIG_ADMIN.md` with updated power tiers and default models.
- Updated `docs/technical/LLM_PROVIDERS.md` with updated extraction LLM defaults.
- Updated FAQ changelog (6 languages) with v1.15.3 entries.
- Fixed missing v1.15.2 and v1.15.1 changelog version keys in FAQContent.tsx.

## [1.15.2] - 2026-04-09

### Psyche Engine v2 — Enriched Emotional Intelligence

#### New Features

- **Expanded emotion palette (16 → 22)**: Six new emotions — playfulness, protectiveness, relief, nervousness, wonder, resolve — with PAD-validated vectors (min distance ≥ 0.122).
- **Graduated directives**: Prompt injection now scales across 4 intensity levels (compact → medium → rich → reinforced) based on PAD magnitude, with a lighter usage directive for low-intensity states.
- **Serenity floor**: Baseline steadiness directive when no emotion is significantly active, modulated by Neuroticism trait.
- **Emotional anchor**: Grounding directive when strong negative emotions threaten a spiral, modulated by Conscientiousness trait.
- **Narrative transitions**: Six transition templates (reunion, valence shifts, arousal shifts, emotion-specific) replace the mechanical EVOLUTION block.
- **Multi-emotion self-report**: LLM reports 1-3 simultaneous emotions per message (backward compatible with v1 single-emotion format).
- **Computed resonance**: Emotional alignment metric [-1, +1] between user valence and assistant emotion, feeding relationship warmth and trust.
- **Proactive emotions**: Pre-response emotion pulses from drives and context (curiosity for new users, enthusiasm for high engagement, pride for domain confidence) with anti-inflation guards.
- **Enriched avatar tooltip**: Multi-emotion display with intensity bars, mood intensity label, and drive indicators on hover.

#### Improvements

- Consolidated 12 existing behavioral directives (3 mood + 7 emotion + 2 relationship) from descriptive to imperative style.
- Fixed Pattern B compact block wording ("follow each emotion's directive" → "let each named emotion color specific moments").
- Fixed 2 color duplicates in PsycheHistory (surprise/pride shared amber, determination/frustration shared red).
- Enriched PsycheStateSummary with mood_intensity, active_emotions list, and drive values for richer SSE metadata.
- Added structured logging for proactive emotion injection and resonance computation.
- Updated PsycheEducation with 22-emotion table and 5 new educational sections (multi-emotion, proactive, serenity floor, anchor, resonance, transitions).
- Updated all 6 locale files (fr, en, de, es, it, zh) with ~25 new keys and ~10 updated keys each.
- Updated documentation: PSYCHE_ENGINE.md, ADR-068, 22_psyche.md with v2 enhancements.

#### Tests

- 158 unit tests (87 existing + 71 new) covering all v2 features.
- New guard test preventing descriptive directive patterns ("Show", "Let", "You are").

## [1.15.1] - 2026-04-08

### Fixed

- **MCP ReAct Step Timeout** — The parallel executor step timeout for MCP iterative (ReAct) tools was defaulting to 60s, insufficient for multi-iteration Opus-based ReAct agents (read_me + create_view takes ~55-90s). The planner's `timeout_seconds` override only matched the legacy `mcp_excalidraw_create_view` tool name, not the new `mcp_excalidraw_task` iterative tool name. Now all tools ending with `_task` (MCP iterative suffix) get a minimum timeout of 120s via `max(planner_timeout, 120)`, regardless of what the planner LLM specifies.
- **MCP App Registry Filtering** — Interactive MCP App widgets (Excalidraw diagrams, etc.) were silently dropped by the response node's intelligent filtering. When the LLM returned `<relevant_ids>` for search results, `filter_registry_by_relevant_ids()` removed all items not in the list — including MCP App items that are not search results. Now items of type `MCP_APP` and `DRAFT` are protected from intelligent filtering and always preserved in the registry, alongside initiative-protected items.
- **LLM Config Defaults** — `mcp_app_react_agent` LLM config: temperature reduced from 0.2 to 0.0 for deterministic output, max_tokens adjusted from 20000 to 16000, reasoning_effort from "medium" to "low".

### Documentation

- Updated ADR-062 with MCP ReAct timeout and registry protection amendments.
- Updated MCP_INTEGRATION.md with step timeout configuration for iterative tools.
- Updated GUIDE_MCP_INTEGRATION.md with timeout requirements section.
- Updated ARCHITECTURE_LANGRAPH.md with protected registry items in response node.
- Updated knowledge base `11_mcp_servers.md` with timeout information.
- Updated FAQ changelog (6 languages) with v1.15.1 entries.

## [1.15.0] - 2026-04-08

### Added

- **User MCP ReAct Iterative Mode** — User-configured MCP servers with `iterative_mode=true` now delegate to a ReAct sub-agent (same as admin MCP). The planner sees a single `mcp_user_{id}_task` tool per server; the ReAct agent reads documentation first, then executes tools iteratively with error recovery. Shared factory `build_mcp_react_task_manifest()` eliminates manifest duplication between admin and user MCP paths.
- **MCP App Dedicated LLM** — New LLM type `mcp_app_react_agent` (category: Domain Agents) auto-selected for MCP servers with interactive widgets (`app_resource_uri`). Defaults to Opus for complex multi-step workflows (e.g., Excalidraw). Regular MCP servers continue using `mcp_react_agent`. Detection is automatic via `_has_mcp_app_tools()` — no configuration needed.
- **3-Phase Memory Reference Resolution** — `MemoryResolver` now uses a 3-phase architecture: Phase 1 (LLM nano extracts personal references like "ma femme", "mon frère" from the query), Phase 2 (per-reference targeted memory search in parallel with higher similarity threshold), Phase 3 (LLM resolves references using targeted facts). Phase 1 and broad memory retrieval run concurrently. Produces higher similarity scores than embedding the full query, reducing noise. New LLM type: `memory_reference_extraction`. New prompt: `memory_reference_extraction_prompt.txt`.
- **Initiative Eligibility Field** — New `initiative_eligible: bool | None` field on `ToolManifest` for fine-grained control over which tools are available during the initiative phase. New `is_initiative_eligible()` function replaces the coarser `is_read_only_tool()` heuristic. ~30 catalogue manifests annotated with `initiative_eligible=False` (web search, browser, context, structural listing tools).
- **Error Classification System** — New centralized `SSEErrorMessages._classify_error()` classifier with categories: `transient` (overload, rate limit), `content_filter` (provider safety blocks), `timeout`, and `unknown`. New localized user messages for `content_filter` and `timeout` errors across all 6 languages.
- **Query Analyzer LLM Timeout** — New `query_analyzer_llm_timeout_seconds` setting (default: 10s) with `asyncio.wait_for()` guard on the query analyzer LLM call.

### Changed

- **Unified Planner Prompt** — `smart_planner_prompt.txt` now serves both single-domain and multi-domain queries via `is_multi_domain` / `primary_domain` parameters. `get_smart_planner_multi_domain_prompt()` is a backward-compatible wrapper. Eliminates the duplicated `smart_planner_multi_domain_prompt.txt` template.
- **Token Optimization — Prompts** — Compressed `query_analyzer_prompt.txt` (~50%), `response_system_prompt_base.txt` (~45%), `initiative_prompt.txt` (~30%), `for_each_directive_prompt.txt` (~70%), `smart_planner_prompt.txt` (~35%). Empty optional sections (skills, RAG, journal, knowledge) no longer inject empty XML tags.
- **Token Optimization — Catalogue & Initiative** — Catalogue JSON now uses compact separators (no indent). Initiative tool format uses one-line-per-tool with inline params (~70% reduction).
- **Initiative Cross-Domain Only** — Initiative node now excludes already-executed domains from adjacent tool search, ensuring only cross-domain enrichment checks are performed.
- **Reminder Cancellation Requires Confirmation** — `cancel_reminder` tool now has `hitl_required=True`, requiring user confirmation before cancelling reminders.
- **Error Message Security Hardening** — All SSE error messages no longer leak exception type names or technical details to end users. Error type metadata in stream chunks replaced with generic `"stream_error"`.
- **Resolved Context ID Aliases** — `ResolvedContext.to_prompt_context()` now injects tool-parameter aliases for ID fields (e.g., `id` → `event_id`, `resourceName` → `resource_name`), reducing planner hallucination of `$steps` references for pre-resolved entities.
- **Weather Date Formatting** — Removed `date_formatted` from weather API payloads; card components now use `format_full_date()` with user's language for locale-aware display.
- **Catalogue Descriptions Streamlined** — Tool descriptions for calendar, email, contacts, and tasks use compact `USAGE` format replacing verbose `MODES` sections. ID parameters reference `$steps or CONTEXT` instead of generic descriptions.
- **Contact Search Fallback** — `GetContactDetailsTool` now retries failed batch fetches as name searches, handling cases where the planner puts names in `resource_names` instead of real IDs.
- **MCP Excalidraw LLM Dead Code Cleanup** — Removed unused `mcp_excalidraw_llm_*` settings (~80 lines in `config/mcp.py`, 8 constants) left over from pre-ADR-062 iterative builder. Renamed LLM type `mcp_excalidraw` → `mcp_app_react_agent` in admin panel. Removed `MCP_EXCALIDRAW_STEP_TIMEOUT_SECONDS` env var.

### Fixed

- **Resolved Context Restoration** — `get_query_intelligence_from_state()` now restores `resolved_context` from its separate state key when reconstructing `QueryIntelligence` from dict. Previously, `resolved_context` was always `None` after reconstruction, causing the planner to miss pre-resolved entity IDs for REFERENCE_ACTION turns.
- **Initiative Turn Filtering** — `_format_execution_summary()` now filters `agent_results` by `current_turn_id`, preventing stale data from previous turns leaking into the initiative prompt.
- **Plural Demonstrative Patterns** — `ReferenceResolver.DEMONSTRATIVE_PATTERNS` now includes `\bthese\s+\w+` and `\bthose\s+\w+` for plural demonstrative detection (e.g., "delete these emails").
- **Localized Date Parsing** — Weather tools now parse localized date strings (e.g., "jeudi 09 avril 2026") via `_parse_localized_date()` with support for FR, EN, DE, ES, IT month names. Handles cases where the planner outputs dates in the user's language instead of ISO format.
- **Context Resolution Demonstratives** — Context resolver now receives the semantic pivot query (which preserves demonstratives like "these/this/that") instead of the QA's `english_query` (which resolves them away), fixing demonstrative detection for REFERENCE_ACTION turns.
- **HITL Nested Error Localization** — Nested HITL Redis save errors now use `SSEErrorMessages.generic_error()` with user language instead of hardcoded French message.
- **Chat Reducer Error Prefix** — Frontend chat reducer no longer prepends "Erreur:" to error messages (backend messages are already localized).
- **For Each Heuristics** — `_get_plural_collection_hints()` and `_get_collection_key_for_domain()` now derive from `DOMAIN_REGISTRY` instead of hardcoded lists, preventing drift when new domains are added.
- **User MCP `iterative_mode` Not Returned** — `_server_to_response()` in user MCP router was missing `iterative_mode=server.iterative_mode`, always returning `False` to the frontend regardless of the DB value. Toggle appeared non-functional.
- **MCP Admin Servers Not Loading (DEV)** — `.env` line `MCP_SERVERS_CONFIG_PATH=  # comment` had inline comment parsed as file path value, causing `mcp_config_file_not_found` → `mcp_no_servers_configured` at startup. "MCP Applicatifs" section was invisible in Preferences.
- **MCP ReAct Error Recovery** — `_MCPReActWrapper._arun()` now catches all exceptions (including `ExceptionGroup` from anyio/MCP SDK) and returns error messages as strings to the ReAct agent instead of crashing the sub-agent loop. The ReAct agent can now reason about MCP tool errors and retry with corrected parameters. Affects all MCP iterative servers (admin + user).

### Documentation

- Updated MEMORY_RESOLUTION.md with 3-phase architecture.
- Updated PROMPTS.md with new prompt file and unified planner.
- Updated AGENT_MANIFEST.md and tool creation guides with `initiative_eligible` field.
- Updated ADR-062 with initiative eligibility and cross-domain-only amendments.
- Updated ADR-023 with `_classify_error()` and new error categories.
- Updated LLM_CONFIG_ADMIN.md with `memory_reference_extraction` LLM type.
- Updated SMART_SERVICES.md with unified planner prompt.
- Updated FAQ changelog (6 languages) with `memory_reference_extraction` i18n key.
- Updated MCP_INTEGRATION.md with user MCP iterative mode support.
- Updated ADR-062 with user MCP ReAct sub-agent extension.
- Updated GUIDE_MCP_INTEGRATION.md with user MCP iterative mode section.
- Updated LLM_CONFIG constants: renamed `mcp_excalidraw` → `mcp_app_react_agent`, moved to Domain Agents category.
- Updated knowledge base `11_mcp_servers.md` with iterative mode explanation.

## [1.14.5] - 2026-04-07

### Changed

- **HITL Streamlining — Approval Gate Passthrough** — Plan-level HITL approval (`plan_approval`) is now auto-approved. Every mutation already has its own downstream HITL (FOR_EACH confirmation for bulk operations, draft critique for individual actions), making plan-level approval redundant. Eliminates the triple-confirmation UX for deletions (plan_approval + for_each_confirmation + draft_critique → single for_each_confirmation).
- **HITL Streamlining — FOR_EACH Cancel = Draft Cancel** — Refusing a FOR_EACH HITL confirmation now produces the same "OK, annulé" fast-path response as refusing a draft critique, instead of falling through to initiative + response nodes with a broken error message.
- **Initiative Skip After HITL Resolution** — Initiative node now short-circuits immediately when a HITL interaction (draft critique, entity disambiguation, tool confirmation) was just resolved. Avoids a wasted LLM call (~8s) evaluating post-execution enrichment on an already-confirmed/refused action.
- **Action-Specific HITL Titles** — Destructive confirmation dialogs now display action-specific titles ("Confirmation de suppression", "Confirmation d'envoi", etc.) instead of the generic "Confirmation requise", across all 6 languages. Applied to both batch draft critique and individual destructive confirm interactions.
- **Planner Prompt — Forbidden Tools List** — Smart planner prompt now explicitly lists forbidden hallucinated tools (`resolve_reference`, `get_context_list`, `get_context`, `resolve_context`, `lookup_reference`) with clear instruction to use resolved context IDs directly. Reduces replanning caused by hallucinated tool rejections.
- **FOR_EACH Directive — Mandatory Fetch Step** — FOR_EACH directive prompt now explicitly states the retrieval step must always be included, even when items appear in resolved context, because the runtime FOR_EACH engine only works with `$steps` references.

### Fixed

- **Hallucinated Parameter Defense** — Parallel executor now strips unknown parameters (e.g., `order`, `order_by`) from tool calls before execution, using `inspect.signature()` to validate against the tool's actual function signature. Prevents `TypeError` crashes that silently failed entire execution plans when the planner LLM hallucinated non-existent parameters.
- **Resolved Context Header Clarification** — Resolved context header in planner prompts updated from vague "DO NOT call any resolution tool" to explicit "use their IDs directly in parameters, DO NOT create any resolve/context/reference step", reducing planner hallucination of `resolve_reference` tool.

### Documentation

- Updated HITL technical documentation with approval gate passthrough, FOR_EACH cancel behavior, and action-specific titles.
- Updated ADR-062 with initiative skip after HITL resolution.
- Updated LangGraph architecture documentation.
- Updated FAQ changelog (6 languages) with HITL streamlining features.

## [1.14.4] - 2026-04-03

### Added

- **Tool Embeddings Disk Cache** — Semantic tool selector now persists computed embeddings to a JSON cache file (`tool_embeddings_cache.json`). On startup, if tool descriptions/keywords and embedding model haven't changed (SHA-256 content hash), embeddings are loaded from disk instead of calling the Gemini API. Eliminates ~2–5 s startup latency and avoids unnecessary API cost on every restart. Cache auto-invalidates when tools or model change.
- **Qwen 3.6-plus Model Support** — New `qwen3.6-plus` model added to context windows, model profiles, and LLM pricing seed. Agentic-focused upgrade of qwen3.5-plus with vision support and 1M context window.
- **Cached Input Pricing** — `cost_per_1m_cached_input` field added to `ModelProfile` dataclass and populated for all major providers (OpenAI, Anthropic, Google, DeepSeek, Qwen). Enables more accurate cost tracking for providers that offer prompt caching discounts.

### Changed

- **Provider-Agnostic Structured Output** — Migrated 4 services from `llm.with_structured_output()` to the centralized `get_structured_output()` helper: `initiative_node`, `hitl_classifier`, `query_analyzer_service`, and `evaluation_pipeline`. Uses `get_llm_config_for_agent()` to resolve provider dynamically, ensuring reliable JSON extraction across OpenAI, Anthropic, Google, and Qwen providers.
- **Initiative Items Protected from Response Filtering (ADR-062)** — Initiative node now propagates `registry_ids` in its results. Response node collects these IDs and re-injects initiative items after intelligent filtering, preventing proactive suggestions from being silently dropped when the response LLM filters registry entries.
- **LLM Pricing Seed — Fixed Timestamps** — All `pricing_date` values in `llm_pricing_seed.sql` changed from `NOW()` to fixed `'2026-01-01T00:00:00Z'` for reproducible seeding across environments.
- **Model Pricing Updates** — Corrected pricing for Qwen 3.5-plus (input: $0.40→$0.115), Qwen 3.5-flash (input: $0.10→$0.029), Qwen-max (input: $1.20→$0.359), and Perplexity sonar models (aligned to current API pricing).

### Documentation

- Updated FAQ changelog (6 languages) with tool cache and initiative protection features.
- Updated technical documentation for structured output migration and model profiles.

## [1.14.3] - 2026-04-03

### Added

- **Response Display Mode Preference** — New tri-mode selector in Settings > Personalization: **HTML Cards** (structured visual cards for contacts, events, emails, weather — default), **Rich HTML** (LLM generates beautifully formatted HTML responses with headings, callouts, tables, styled typography), or **Markdown** (plain text). Single `response_display_mode` field replaces previous approach. Full pipeline wiring: User model → API endpoint (`PATCH /auth/me/display-mode-preference`) → LangGraph configurable → response_node conditional logic.
- **HTML Response Directive Prompt** — New versioned prompt `html_response_directive.txt` injected before FINAL REMINDER when display mode is "html". Instructs LLM to output rich HTML with scoped `<style>` block using CSS variables (`--lia-*`) for automatic dark/light theme compatibility. Includes callout components (info, success, warning, error), styled tables, blockquotes, and semantic markup.
- **Display Mode Constants** — `RESPONSE_DISPLAY_MODE_CARDS/HTML/MARKDOWN/DEFAULT/CHOICES` centralized in `src/core/constants.py`.

### Changed

- **Simplified Display Preferences** — Consolidated two boolean fields (`cards_display_enabled` + `html_response_enabled`) into a single `response_display_mode` enum string ("cards"/"html"/"markdown"). Single PATCH endpoint, single configurable key, single schema pair. Migration preserves existing user preferences via data migration.

### Documentation

- Updated FAQ changelog (6 languages) with display mode preference feature.
- Updated `docs/knowledge/03_settings.md` with display mode section.

## [1.14.2] - 2026-04-03

### Added

- **Skill Mechanism #2 — QueryAnalyzer + ReactSubAgentRunner** — Skills without `plan_template` can now be activated reliably. The `QueryAnalyzer` detects skills via the L1 catalogue (`{available_skills}`) in its prompt and sets `skill_name` in its structured output. The `response_node` reads `detected_skill_name` from state and activates based on nature: scripts → isolated `ReactSubAgentRunner` (LLM `mcp_react_agent` + `skill_react_agent_prompt`); resources only → Python load + L2 passive injection (0 extra LLM call); neither → L2 passive injection only. Works identically for both planner and response routes.
- **Skill ReAct Agent Prompt** — New `skill_react_agent_prompt.txt` for the ReAct sub-agent that executes skill scripts in an isolated loop with tool calls (`activate_skill`, `run_skill_script`, `read_skill_resource`).

### Fixed

- **Skill Script Executor — Docker Compatibility** — `unshare -rn` network isolation now has a runtime availability check (`_unshare_available()`) with graceful fallback, fixing crashes in Docker/non-Linux environments.
- **Skill Script Executor — debugpy Process Isolation** — Script execution uses `env -i` for clean environment to prevent debugpy from hooking into child processes.
- **Skill Script Executor — Absolute Paths** — Resolved relative path failures when using `env -i` by converting all paths to `.resolve()` absolute form.
- **ReactSubAgentRunner — Anthropic Content Normalization** — Anthropic models returning list content blocks (instead of plain strings) are now normalized to string before processing.
- **QueryAnalyzer — plan_template None Guard** — `plan_template` field can be `None` (not just absent) — now uses `(x or {}).get()` pattern to avoid `AttributeError`.
- **QueryAnalyzer — ConfigDict Extra Ignore** — Added `ConfigDict(extra="ignore")` to protect structured output parsing from unexpected fields.
- **Skill Tools — Combined stdout+stderr** — Script failure error messages now include both stdout and stderr output instead of losing stdout on `SCRIPT_ERROR`.

### Documentation

- **SKILLS_INTEGRATION.md** — Full rewrite of the activation section with 5 detailed mechanisms, updated architecture diagram, and ReactSubAgentRunner documentation.
- **ARCHITECTURE.md** — Updated Skills System section with unified activation strategies (QueryAnalyzer detection, planner pre-activation, deterministic bypass).
- Updated docs/knowledge/12_skills.md with new activation mechanisms.

## [1.14.1] - 2026-04-02

### Changed

- **Gemini Embedding Migration** — Migrated all embedding operations (memories, journals, interests, RAG) from OpenAI `text-embedding-3-small` to Google `gemini-embedding-001` with asymmetric `RETRIEVAL_QUERY`/`RETRIEVAL_DOCUMENT` task types. Fixes critical multilingual retrieval regression where unrelated same-language texts scored 0.25–0.35 (language bias), making it impossible to discriminate relevant memories from noise. Gemini with task types produces proper query→document alignment for all 6 supported languages (fr, en, de, es, it, zh). (ADR-069)
- **Dual-Vector Search Strategy** — Added `keyword_embedding` column to `memories` and `journal_entries` tables. Content and keywords (trigger_topic / search_hints) are now embedded separately, with search using `LEAST(dist_content, dist_keyword)`. Restores the multi-field matching behavior from the old LangGraph AsyncPostgresStore that was lost during the PostgreSQL migration (v1.13.6).
- **Dedicated Embedding Singletons** — Each domain now has its own independently configurable embedding singleton: `get_memory_embeddings()`, `get_journal_embeddings()`, `get_interest_embeddings()`, `get_rag_embeddings()`, with dedicated env vars (`MEMORY_EMBEDDING_MODEL`, `JOURNAL_EMBEDDING_MODEL`, `INTEREST_EMBEDDING_MODEL`, `RAG_SPACES_EMBEDDING_MODEL`).
- **GeminiRetrievalEmbeddings Wrapper** — New `GeminiRetrievalEmbeddings` class wrapping `GoogleGenerativeAIEmbeddings` with automatic task_type injection, Prometheus metrics tracking, and DB cost persistence for user billing.

### Fixed

- **Memory Reference Resolution** — "ma femme" and "mon fils" now correctly resolve to actual contact names (e.g., "Léa Lemoine", "Noé Lemoine") when sending emails or performing actions. Previously, the combination of OpenAI embedding language bias and query dilution on long sentences caused memory search to fail silently.
- **Memory Search Query Language** — Pre-planner memory search now uses the original user query (in their language) instead of the English-translated query, improving cosine similarity for same-language memory matching.
- **HITL Email Delete Support** — Added `email_delete` draft summary i18n strings for all 6 languages in HITL confirmation flows.

### Documentation

- **ADR-069** — Gemini Embedding Migration architectural decision record. Documents rationale, scope, migration strategy, and alternatives considered.
- Updated ADR_INDEX.md, docs/INDEX.md, `.env.example`, `.env.prod.example` with Gemini embedding configuration.
- Updated all stale OpenAI/TrackedOpenAIEmbeddings references across ~20 files to Gemini/GeminiRetrievalEmbeddings.

## [1.14.0] - 2026-04-02

### Added

- **Psyche Engine — Dynamic Psychological State** — Complete 5-layer emotional intelligence system for the assistant: Big Five personality traits (Layer 1, permanent) → PAD mood space with 14 distinct moods (Layer 2, hours) → 16 discrete emotions with cross-suppression and diminishing returns (Layer 3, minutes) → 4-stage relationship progression (Layer 4, weeks) → curiosity/engagement drives and self-efficacy (Layer 5, per-session). ALMA-inspired architecture, self-report via hidden `<psyche_eval/>` tag (zero extra LLM call). 87 unit tests.
- **Emotional Avatar** — Mood-responsive emoji avatar on assistant messages in chat. Displays the current mood with colored ring. Tooltip shows mood, PAD values, active emotion, and relationship stage. Historical avatars persisted per-message via `message_metadata.psyche_state`.
- **Psyche Settings UI** — 4-section settings panel (Comprendre la psyché, État de la psyché, Historique, Réglages) with icons. Interactive education guide (7 subsections: overview, traits, mood, emotions, relationship, drives, expressivity/stability) with descriptive tables for 14 moods and 16 emotions. PAD bars with axis labels and polarity indicators. Ring gauges for relationship metrics. Big Five horizontal colored bars.
- **Psyche History Dashboard** — 4-tab recharts visualization: Mood (PAD lines), Emotions (dynamic per-emotion area chart), Relationship (depth/warmth/trust), Drives (curiosity/engagement/emotion intensity). Time range selector (24h/7d/30d/90d). Reset markers as red dashed vertical lines.
- **Evolution Awareness** — LLM receives `EVOLUTION:` block in `<PsycheDirectives>` showing mood/emotion shifts since last message, giving the assistant continuity awareness.
- **Personality Sync** — Changing personality automatically syncs Big Five traits and recomputes PAD baseline via `sync_traits_from_personality()`. Frontend refetches state after personality change.
- **Psyche Token Tracking** — LLM-generated summary (`GET /psyche/summary`) now tracks token usage via `track_proactive_tokens()`, ensuring costs are attributed to user billing.
- **Reset Snapshots** — Soft/full resets create `reset_soft`/`reset_full` history snapshots, displayed as visual markers on the history chart.
- **Drives Education Section** — New "Motivations" section in Comprendre la psyché explaining curiosity, engagement, and self-efficacy. Translated in 6 languages.

### Changed

- **Psyche enabled by default** — `PSYCHE_ENABLED=true` in `.env.example`, `user.psyche_enabled` default changed to `true` with migration for existing users.
- **Prompt Directives Overhaul** — All injected context blocks in `response_system_prompt_base.txt` now carry inline operational directives (how to use the data) instead of passive data dumps. Applied to: TemporalContext, History, Psychological_profile, JournalContext, PsycheContext, KnowledgeEnrichment, RAGDocuments, AppKnowledge, ResolvedReferences, AnticipatedNeeds. Same treatment applied to 7 other prompt files (planners, router, query analyzer, initiative, reminder, interest content, psyche summary/narrative).
- **PsycheStateSummary Redesign** — PAD bars with colored axes (sky/amber/violet), polarity labels, and numeric values. SVG ring gauges for relationship metrics. Big Five as horizontal colored bars. Refresh button fetches both LLM summary and state data.
- **Reset Descriptions Clarified** — Soft/full reset descriptions now use explicit "Resets: X, Y. Keeps: Z" format in all 6 languages. Buttons uniform width.
- **Settings Page Reorder** — Psyché de LIA placed directly below Style de LIA. Education section ordered Layer 1→5.
- **i18n Psyche Education** — ~80+ translation keys for psyche education guide completed in all 6 languages (en, fr, de, es, it, zh). Includes mood directives, emotion directives, drives, settings explanation.

### Fixed

- **`_push_with_headroom()` Saturation Fix** — Diminishing returns helper prevents PAD axis saturation at ±1.0 boundaries. 10 dedicated unit tests.
- **`classify_mood()` DRY Refactoring** — Extracted nearest-centroid mood classification as `PsycheEngine.classify_mood()` static method. Eliminated code duplication between `compile_expression_profile` and `process_post_response`.

### Documentation

- **ADR-068** — Psyche Engine architectural decision record. Updated with 16 emotions, 87 tests.
- **PSYCHE_ENGINE.md** — Complete technical & functional documentation (14 sections, scenarios, token cost breakdown). Updated with evolution awareness, avatar persistence, personality sync, token tracking, drives education, refreshed UI descriptions, 10 env vars.
- Updated ADR_INDEX.md, docs/INDEX.md, 16 guide files, README.md with v1.14.0 references.

## [1.13.10] - 2026-04-01

### Fixed

- **Calendar-to-Routes Timezone Bug** — Fixed 2-hour offset in route arrival time calculations when routing to calendar events. The `event["date"]` cross-domain binding field was set **before** `convert_event_dates_in_payload()`, causing the raw UTC value from Google Calendar API (e.g., `13:00:00Z`) to be passed as `arrival_time` to the route tool instead of the converted local time (`15:00:00+02:00`). The field assignment is now correctly placed after timezone conversion. (`mixins.py`)
- **`datetime.utcnow()` Eradication** — Replaced all 6 remaining `datetime.utcnow()` calls with timezone-aware `now_utc()` from centralized `time_utils.py`. Affected files: `calendar_tools.py` (3 occurrences — search time_min/time_max defaults and days_ahead), `google_tasks_client.py` (task completion timestamp), `plan_editor.py` (audit timestamp), `schema_registry.py` (registration timestamp). Eliminates class of bugs where naive datetimes could be misinterpreted as local time.
- **`normalize_user_datetime()` Docstring Correction** — Removed incorrect example claiming UTC input `"21:00:00Z"` would be converted to `"22:00:00+01:00"` (actual behavior: hour is preserved as local intent, producing `"21:00:00+01:00"`). Added explicit warning that this function must NOT be called with API-returned UTC datetimes — use `convert_to_user_timezone()` instead. (`time_utils.py`)

### Documentation

- Updated 16 guide files (why, how, privacy, terms — 6 languages) with v1.13.10 version reference.
- Updated `docs/technical/ROUTES.md` with v1.13.10 timezone fix details and cross-domain binding caveat.

## [1.13.9] - 2026-04-01

### Added

- **Admin Pagination — Page Size Selector** — All 5 admin tables (Users, Usage Limits, LLM Pricing, Google API Pricing, Image Generation Pricing) now feature a page size selector (10/20/50/100, default 20) with total items count display. Shared `<Pagination>` component enriched with `pageSize`, `onPageSizeChange`, `totalItems`, and `loading` props. (`pagination.tsx`, all Admin\*Section components)
- **Admin Users — Full Column Sorting** — All 23 data columns in the admin users table are now sortable, including statistics (messages, tokens, cost), resource counts (connectors, skills, MCP servers, scheduled actions, RAG spaces), preferences (language, voice, memory, tokens display), usage blocked status, and last message date. Backend `getattr()` sorting replaced with a 3-tier mapping: User model fields, COALESCE-wrapped UserStatistics expressions, and labeled subquery columns. (`repository.py`, `AdminUsersSection.tsx`)
- **Admin Users — Memories & Interests Sortable** — Memory count and interest count moved from service-layer batch queries to SQL subqueries in the repository, enabling server-side sorting. Previously unsortable icon columns now clickable. (`repository.py`, `service.py`)
- **Image Generation Pricing — gpt-image-1.5 & gpt-image-1-mini** — Added 18 pricing entries (9 per model: 3 qualities × 3 sizes) for OpenAI's new image models. Applied to both DEV and PROD databases. Seed file already contained the data. (`image_generation_pricing_seed.sql`)

### Fixed

- **Admin Users Sort Consistency** — Fixed inconsistent sort order on statistics columns where NULL values (users without UserStatistics row from LEFT JOIN) appeared mixed with zero values. All statistics sort expressions now wrapped with `func.coalesce(..., 0)` and `nulls_last()` applied to all ORDER BY directions. (`repository.py`)
- **CodeQL — 4 Path Injection Alerts** — `_cleanup_attachment_files()` and `_cleanup_rag_files()` in account deletion service now validate resolved paths with `Path.resolve()` + `is_relative_to()` to block path traversal. (`account_deletion_service.py`)
- **CodeQL — 2 Empty Except Alerts** — Added `logger.debug()` to `except ValueError` and `except json.JSONDecodeError` blocks in memory extractor instead of silent `pass`. (`memory_extractor.py`)

### Changed

- **Admin Pagination UX** — Admin users pagination changed from centered variant (no total) to justified layout with total count, matching usage limits pattern. Default page size reduced from 100 to 20 for all admin tables. (`AdminUsersSection.tsx`, `constants.ts`)

### Documentation

- Updated 16 guide files (why, how, privacy, terms — 6 languages) with v1.13.9 version reference.

## [1.13.8] - 2026-03-31

### Fixed

- **28 CI Test Failures** — Updated unit tests for v1.13.7 account lifecycle changes: mock `_get_memory_counts_batch`/`_get_interests_counts_batch` in search tests, set `deleted_at` on mock users for GDPR soft-delete prerequisite, add `is_deleted=False` to session dependency mocks, update prompt assertion for rewritten journal introspection prompt, fix memory extractor `_parse_items` to reject create actions with missing content/category.
- **4 CodeQL Alerts** — Fixed 3 empty-except blocks (calendar_tools, runtime_helpers, devops_ssh_service) with structured logging. Fixed incomplete URL substring sanitization in event_card.py — replaced `"meet.google.com" in location` with `_is_meet_url()` using `urlparse` for proper domain validation.
- **3 Dependency Vulnerabilities** — Fixed brace-expansion CVE-2024-4068 (medium, zero-step sequence DoS) and CVE-2025-5889 (low, ReDoS) via pnpm override pinned to 2.0.2. Fixed cryptography DNS constraint enforcement (low) via PR #75 bump to 46.0.6.

### Documentation

- **docs/technical/CI_CD.md** — New "Dependency Vulnerability Remediation (pnpm Overrides)" section with rules and override table
- **docs/technical/SECURITY.md** — New "Dependency Vulnerability Management" section covering strategy, CodeQL remediation patterns, URL validation best practice. Revision date updated.

## [1.13.7] - 2026-03-31

### Added

- **Account Lifecycle (4-State Model)** — New account lifecycle: Active → Deactivated → Deleted → Erased (GDPR). Soft-delete purges all personal data (22 tables, LangGraph store/checkpoints, Redis caches, physical files) while preserving billing history (token_usage_logs, user_statistics, google_api_usage_logs). User row kept with email/name for billing contact. ADR-067 documented. (`src/domains/users/account_deletion_service.py`, `src/domains/auth/models.py`)
- **Account Deletion API** — New `DELETE /api/v1/users/admin/{user_id}/delete-account` endpoint for admin soft-delete with precondition enforcement (must be deactivated first). Returns purge counts per table. (`src/domains/users/router.py`)
- **Admin Panel Delete/Erase Buttons** — Deactivated users show "Delete" button (soft-delete), deleted users show "Erase (GDPR)" button (hard-delete). Status badge distinguishes Active/Inactive/Deleted with distinct colors. (`AdminUsersSection.tsx`)
- **Centralized Usage Limit Pre-Check** — New `is_user_blocked_for_llm()` static method combines usage limit check + Prometheus metrics + structured logging in one call. Applied to all LLM-consuming background jobs. (`src/domains/usage_limits/service.py`)
- **Account Status in Usage Limit Enforcement** — `_compute_status()` now checks `is_active` and `deleted_at` as priority 0 (before manual blocks and usage limits). New `BLOCKED_ACCOUNT` status in `UsageLimitStatus` enum. Integrated into `check_user_allowed()` at all 3 code paths (cache hit, DB with limits, DB without limits).

### Changed

- **Background Task Protection (7 jobs)** — All LLM-consuming and connector-related background jobs now filter out inactive/deleted/blocked users: ProactiveTaskRunner (SQL filter), scheduled_action_executor (+is_active check + is_user_blocked_for_llm), reminder_notification (+is_active check), journal_consolidation (+deleted_at filter), token_refresh (JOIN User filter), OAuth health check (+deleted_at filter), session_dependencies (+is_deleted rejection).
- **GDPR Hard-Delete Precondition** — `delete_user_gdpr()` now requires user to be soft-deleted first (`deleted_at IS NOT NULL`). Enforces sequential lifecycle.
- **Usage Limit Cache Invalidation on Deactivation** — `update_user_activation()` now invalidates usage limit Redis cache immediately when deactivating a user, preventing stale cache from allowing LLM calls during the TTL window.
- **LLM Config Auto-Clean reasoning_effort** — When admin changes an LLM type's model to a non-reasoning model (gpt-4.1-\*), `reasoning_effort` is automatically cleared. Validator returns `None` instead of warning for non-reasoning OpenAI models. 29 stale `reasoning_effort` values cleaned from LLM_DEFAULTS constants.
- **OAuth Health Check Filtering** — Now excludes deactivated users (`is_active=False`), deleted users (`deleted_at IS NOT NULL`), and usage-blocked users (`is_usage_blocked=True`) from health check queries.

### Fixed

- **philips_hue Enum Mismatch** — Fixed `LookupError: 'philips_hue' is not among the defined enum values` in `GET /api/v1/connectors/admin/global-config`. Migration had inserted lowercase value; corrected to uppercase `PHILIPS_HUE` in production DB.
- **Journal Consolidation UsageLimitExceeded** — Added pre-check before expensive DB queries and prompt building. Previously, the limit was only checked inside `invoke_with_instrumentation()` after all preparatory work was done.
- **Scheduled Action Executor Unprotected** — Was the only LLM-consuming background job with no user status check and no usage limit pre-check. Now has both.
- **admin_broadcasts FK Constraint** — Added `ondelete="SET NULL"` to `sent_by` FK (was missing, would cause FK violation on GDPR hard-delete).
- **google_api_usage_logs FK Preservation** — Changed FK from `CASCADE` to `SET NULL` to preserve billing history when user row is hard-deleted.
- **ConversationMessage.user_id Bug** — Fixed incorrect `DELETE WHERE user_id` on `conversation_messages` table which has no `user_id` column (only `conversation_id`). Now uses subquery via conversation_id.

### Documentation

- **ADR-067** — Account Lifecycle (Active / Deactivated / Deleted / Erased)
- **docs/INDEX.md**, **docs/architecture/ADR_INDEX.md** — Cross-referenced

## [1.13.6] - 2026-03-30

### Added

- **Centralized User Message Embedding Service** — Computes the user message embedding once per conversation turn and caches by text hash. Shared across memory injection, journal injection, memory extraction, and journal extraction. Reduces from 5 redundant embedding API calls to 1 per turn. Includes triviality filter that skips extraction entirely on trivial messages ("ok", "merci", "👍"). (`src/infrastructure/llm/user_message_embedding.py`)
- **Memory PostgreSQL Migration** — Migrated long-term memory storage from LangGraph AsyncPostgresStore to a dedicated SQLAlchemy model (`Memory`) with pgvector HNSW index. Unified with journal's PostgreSQL + pgvector pattern. Full CRUD via `MemoryRepository` and `MemoryService`. Alembic migration + data migration script. ADR-066 documented. (`src/domains/memories/models.py`, `repository.py`, `service.py`)
- **Memory Extraction Create/Update/Delete** — Memory extraction can now update or delete existing memories (micro-consolidation), not just create. LLM sees existing memories with UUIDs and decides actions. Anti-hallucination ID validation. Pinned memories protected from extraction modifications.
- **Interest Extraction Create/Update/Delete** — Interest extraction aligned on the same create/update/delete pattern as memory and journal. LLM can update topics or delete interests the user no longer cares about. Updated prompt, schema, parser, and debug panel.
- **Journal Extraction Semantic Pre-filter** — Replaces `get_all_active()` (all entries) with semantic top-10 + 3 recent. Reduces input tokens from ~7,500 to ~2,500 per extraction call.
- **Debug Panel Reorganization** — Sections reorganized into "Context Injection" (memory, RAG, knowledge, journal) and "Background Extraction" (memory, journal, interest) groups. New `JournalExtractionSection` as separate accordion. Shared `ActionBadge` component for consistent CREATE/UPDATE/DELETE display across all extraction sections.

### Changed

- **Prompt Optimization** — Memory extraction prompt reduced by 65% (1,784→620 tokens), journal introspection by 60% (1,280→508), journal analyst persona by 63% (305→113). Same directives, denser format. Interest extraction prompt rewritten with create/update/delete actions.
- **Emotional State Computation** — Migrated from `semantic_store.py` (LangGraph Items) to `emotional_state.py` (Memory ORM objects). Same DANGER/COMFORT/NEUTRAL algorithm.
- **Memory Cleanup Scheduler** — Rewritten to use `MemoryRepository` instead of LangGraph store. Same retention algorithm (usage + importance + recency).
- **Memory Router** — Rewritten from LangGraph store operations to `MemoryService`. Memory IDs changed from `mem_<12hex>` to UUID format (frontend compatible — uses opaque strings).

### Fixed

- **Journal Third-Party Projection** — Added anti-pattern directive preventing the journal from attributing traits to the user based on third-party subjects ("son's exam postponed" ≠ user procrastinating).
- **Journal Dedup Guard Removed** — Redundant post-extraction LLM merge call removed. The LLM now sees entries with IDs via semantic pre-filter and handles update/delete directly, eliminating unnecessary embedding + LLM calls.
- **Debug Panel Memory Detection Crash** — Fixed `Cannot read properties of undefined (reading 'toFixed')` error when extraction returned update/delete actions without importance/emotional_weight fields.
- **Interest Extraction Confidence Filter** — Fixed confidence threshold blocking delete/update actions (confidence is N/A for non-create actions).

### Documentation

- **ADR-066** — Memory Storage Migration from LangGraph Store to PostgreSQL Custom
- **docs/INDEX.md**, **docs/architecture/ADR_INDEX.md** — Cross-referenced
- **PromptName Literal** — Added 5 missing prompt names (memory + planner prompts)

## [1.13.5] - 2026-03-29

### Added

- **Debug Panel — Memory Detection Section** — New debug panel section showing memories extracted and stored in long-term memory from each user message. Displays: extracted memories with category, emotional weight (-10/+10), importance score, trigger topic, and storage status (success/failure); existing similar memories found during deduplication with semantic similarity scores; LLM metadata (model, input/output/cached tokens). Header badge shows `stored/extracted` count and dedup matches. Mirrors the Interest Detection pattern. (`apps/api/src/domains/agents/services/memory_extractor.py`, `apps/web/src/components/debug/components/sections/MemoryDetectionSection.tsx`)
- **Memory Extraction Debug Cache** — Module-level TTL cache (`_memory_extraction_debug_cache`) in `memory_extractor.py` captures debug data from `extract_memories_background()` keyed by `parent_run_id`. Consumed by `streaming_service.py` via `get_memory_extraction_debug(run_id)` after `await_run_id_tasks` completes. TTL 120s, max 100 entries, lazy eviction on read. 5 unit tests for cache/consume/TTL/size semantics.

### Changed

- **DRY — `getEmotionalLabel` Factorized** — Emotional weight label helper (TRAUMA/NEG/NEU/POS/TRES+) extracted from `MemoryInjectionSection.tsx` and `MemoryDetectionSection.tsx` into shared `formatters.ts`. Both sections now import from the centralized utility.

### Fixed

- **Conversation Deletion — Nested Transaction Error** — `ConversationService.delete_conversation()` wrapped store cleanup SQL in a redundant `async with db.begin()` block, causing `InvalidRequestError` ("A transaction is already begun on this Session") when the session already had an active implicit transaction. Removed the nested `begin()` and executed raw SQL directly on the existing session. (`apps/api/src/domains/conversations/service.py`)

### Documentation

- **6 files updated** — `DEBUG_PANEL_ARCHITECTURE.md` (Memory Detection cache mechanism), `LONG_TERM_MEMORY.md` (troubleshooting point 5: Memory Detection section), `CHANGELOG.md`, `README.md`, version bumps in 16 guide files.

## [1.13.4] - 2026-03-29

### Changed

- **Memory Optimization — E5 → OpenAI Embeddings** — Replaced local E5 model (intfloat/multilingual-e5-small, 384 dims) with OpenAI text-embedding-3-small (1536 dims) for memory search, tool routing, and interest deduplication. Eliminates sentence-transformers + PyTorch CPU from each worker, saving ~1 GB RAM per worker. New `memory_embeddings.py` singleton follows journal/RAG embedding pattern. Alembic migration drops `store_vectors` (auto-recreated by LangGraph with new dimensions) and nulls interest embeddings. Reindex script (`scripts/reindex_embeddings.py`) for post-deploy re-embedding.
- **Memory Optimization — Playwright Lazy Init** — Browser agent Chromium instances no longer launched at startup. Pool initialized on first browser tool call, saving ~1.5 GB RAM at boot (24 Chromium processes eliminated). Cleanup job uses safe no-op function compatible with scheduler leader election pattern.
- **Memory Optimization — Uvicorn Worker Recycling** — Added `--limit-max-requests 10000 --limit-max-requests-jitter 1000` to prevent Python memory fragmentation accumulation across workers.
- **API RAM Usage** — Reduced from 6.73 GB (84% of 8 GB limit) to 2.64 GB (33%) on Raspberry Pi 5 production server. Combined savings: ~4 GB.
- **Embedding Similarity Thresholds** — All E5-calibrated thresholds recalibrated for OpenAI embeddings (more discriminative score distribution). Memory search: 0.88→0.45, hybrid: 0.5→0.4, interest dedup: 0.90→0.75, content dedup: 0.85→0.70. No more hardcoded magic numbers — all thresholds use settings or centralized constants.
- **LLM Configuration Defaults** — `LLM_DEFAULTS` in code aligned with production-tuned settings (44 entries). Strategy: gpt-4.1-nano (domain agents), gpt-4.1-mini (routing), claude-sonnet-4-6 (extraction), qwen3.5-plus (planning), gpt-5.4 (advanced). New SQL seed `llm_config_seed.sql` for fresh installations.
- **Docker Compose** — Removed `HF_HOME`, `TRANSFORMERS_CACHE` env vars and `huggingface_cache` volume from both dev and prod compose files.
- **Dockerfile** — Removed PyTorch CPU override install (no longer needed without sentence-transformers).

### Fixed

- **WebSearchCard Synthesis Border** — Removed left border on AI synthesis block (`with_border=False`) per design intent.
- **WebSearchCard Source Badge Icons** — Source indicator icons (Perplexity, Brave, Wikipedia) now inherit white color in active state instead of being overridden by `lia-icon` default color.
- **networkx Dependency** — Added explicit `networkx==3.6.1` to requirements.txt (was a transitive dependency of sentence-transformers/torch, now needed directly by SemanticIntentDetector type registry).

### Removed

- **sentence-transformers** — Removed from requirements.txt (was pulling PyTorch + ~700 MB in Docker image).
- **Local E5 Embeddings** — `LocalE5Embeddings` class, `get_local_embeddings()`, `preload_embedding_model()` removed from `local_embeddings.py`. File retained for `cosine_similarity()` utility only.
- **HuggingFace Cache** — `huggingface_cache` Docker volume removed (E5 model no longer downloaded at runtime).

### Documentation

- **52 files updated** — All references to E5/local embeddings replaced across README, CLAUDE.md, 6 locale files, 12 landing guides, 20+ technical docs, 8 ADRs. ADR-049 marked as SUPERSEDED. `LOCAL_EMBEDDINGS.md` rewritten as migration notice.

## [1.13.3] - 2026-03-29

### Added

- **Skills Guide Redesign** — Complete rewrite of the in-app skill creation guide with 3 tabbed sections: Fundamentals (3 archetypes, L1/L2/L3 activation model, best practices), Create (SKILL.md format, frontmatter fields, Prompt Expert & Advisory examples, folder structure, references/scripts/assets usage, import process), Advanced (plan templates with auto-trigger, complete agent & tool catalogue with parameters and types organized by category via accordion, Python scripts, internal skill tools). 210 translation keys across 6 languages. (`apps/web/src/components/settings/SkillGuideModal.tsx`)
- **Skills Guide Button Enhancement** — Guide button promoted from subtle text link to prominent outlined Button with primary color, repositioned alongside Import for responsive smartphone layout (stacks vertically on mobile). (`apps/web/src/components/settings/SkillsSettings.tsx`)
- **Admin Users — New Columns** — 5 new columns in user administration: Skills count (user-imported), MCP servers count, Scheduled actions count, RAG spaces count, and Usage blocked status. All counts fetched via efficient correlated subqueries in a single SQL statement. (`apps/api/src/domains/users/repository.py`, `apps/api/src/domains/users/schemas.py`, `apps/web/src/components/settings/AdminUsersSection.tsx`)
- **Admin Limits — Sortable Columns** — Email and Blocked columns now support click-to-sort (asc/desc) with arrow indicators. Backend `GET /usage-limits/admin/users` endpoint extended with `sort_by` and `sort_order` query parameters. (`apps/api/src/domains/usage_limits/router.py`, `apps/api/src/domains/usage_limits/repository.py`, `apps/web/src/components/settings/AdminUsageLimitsSection.tsx`)

### Changed

- **Multi-Provider Naming** — Domain taxonomy display names and descriptions updated from Google-specific ("Google Calendar", "Gmail", "Google Contacts", "Google Drive", "Google Tasks") to provider-agnostic ("Calendar", "Email", "Contacts", "Drive / Files", "Tasks") reflecting the multi-provider connector abstraction (Google, Microsoft, Apple). Updated in: domain taxonomy, skill guide tool catalogue, skill-generator references. (`apps/api/src/domains/agents/registry/domain_taxonomy.py`, `data/skills/system/skill-generator/references/tool-catalogue.md`, `data/skills/system/skill-generator/references/format-specification.md`)

### Fixed

- **PlaceCard Crash Fix** — `_get_next_open_time` method signature was accidentally removed during dead code cleanup, causing `AttributeError` and silent render failure for all place cards. Restored method definition. (`apps/api/src/domains/agents/display/components/place_card.py`)
- **EmailCard Layout** — Sender name `font-weight: 400` (was 500). Date + status icons displayed above sender name. Labels + attachments + thread count merged on same chip line above subject. `chip-row` `margin-bottom` added for spacing below badges.
- **EventCard Polish** — Removed separator line under chips. Year stripped from date chip. Extra vertical margin before location.
- **RouteCard Map Full-Width** — Reverted to original `lia-route__map-link` / `lia-route__map-image` CSS classes instead of generic `lia-card-hero` (which didn't compensate border-left properly). Removed `max-height` constraint on hero images.
- **RouteCard Badges Reorder** — Line 1: arrival + suggested departure. Line 2: traffic + duration + distance. Removed separator under badges. Departure chip shows time only (strips day name).
- **PlaceCard Badges Reorder** — Type + price + distance + stars on same line. Open/closed + opening/closing time on separate line. Added `_get_closing_time()` method + `V3Messages.get_closes_at()` i18n (6 languages). 16px space before address.
- **CSS Card-Top Spacing** — `margin-bottom` increased from `sm` (8px) to `md` (12px) for uniform spacing between title separator and badges across all cards.
- **CSS Card Hero** — Added `overflow: hidden` via `:has(.lia-card-hero)` on parent card. Removed `max-height` on `lia-card-hero img` for natural aspect ratio.
- **DST-Aware Heartbeat Test** — `test_today_event_shows_time_only` now uses dynamic UTC offset for the test date instead of hardcoded `+01:00`, fixing CET→CEST transition failures.

## [1.13.2] - 2026-03-28

### Added

- **Design System v4 — Standardized HTML Card Components** — Complete visual redesign of all 14 HTML cards using a unified component library. 19 reusable CSS components (`lia-card-top`, `lia-illus`, `lia-chip`, `lia-chip-row`, `lia-sec`, `lia-d-row`, `lia-d-item`, `lia-desc-block`, `lia-card-hero`, `lia-tbadge`, `lia-att-row`, `lia-att-av`, `lia-part-list`, `lia-src-link`, `lia-kv-rows`, `lia-review`, `lia-raw-block`, `lia-file-meta`, `lia-illus-sm`). 17 Python helper functions in `base.py`. Every card now uses the same building blocks — zero domain-specific CSS classes. (`apps/web/src/styles/lia-components.css`, `apps/api/src/domains/agents/display/components/base.py`)
- **42px Illustration Vignettes** — Each card header features a colored square-rounded icon (9 color variants: green, red, amber, blue, indigo, purple, teal, orange, gray) with gradient backgrounds and filled Material Symbols icons. Dark mode uses `rgba()` backgrounds.
- **Chip System** — New inline metadata tags with borders and icons (9 variants: green, amber, red, indigo, time, stars, thread, attach, allday). Replaces inconsistent badge usage across cards.
- **Section Headers with Mini-Vignettes** — Collapsible "Voir plus" sections now use 28px mini-illustrations for each section (hours, reviews, services, participants, sources, etc.).
- **Attendee Avatars** — Stacked colored circle avatars showing participant initials with "+N" overflow indicator.
- **Participant Lists with Emails** — Event and email collapsible sections now show each participant with status icon + name + email (mailto: link).
- **Design System Guide** — Comprehensive documentation covering all components, color variants, responsive rules, Python helpers, and how to create new cards. (`docs/guides/GUIDE_DESIGN_SYSTEM.md`)

### Changed

- **All 14 HTML Cards Migrated** — EventCard, EmailCard, ContactCard, PlaceCard, WeatherCard (3 variants), RouteCard, TaskItem, ReminderCard, FileItem, ArticleCard, WebSearchCard, SearchResultCard, McpResultCard — all now use v4 components.
- **Card Layout Normalization** — All cards with `display: flex` (email, event, task, file, article) corrected to `flex-direction: column` for proper v4 vertical layout.
- **Contact Card** — Type badges colored by category (work=indigo, home=green, mobile=amber). Details aligned left. Collapsible uses same `render_d_row` + `render_type_badge` as main card.
- **Place Card** — Photo hero preserved. Chips organized in 3 rows (stars / type+status / price+distance). Collapsible sections with mini-vignettes (hours as KV grid, reviews, services, accessibility, payment).
- **Weather Card** — French weather descriptions added to icon mapping (~20 terms: ciel dégagé, nuageux, pluie, orage, neige, brouillard). Label "Min / Max" changed to "Températures" (6 languages). Sunrise/sunset icon alignment fixed.
- **Route Card** — Title simplified to "→ Destination". ETA displayed as indigo chip. Chips split into 2 rows (arrival+traffic / duration+distance). "Voiture" badge removed (redundant with illustration icon).
- **Task Card** — Unified mobile/desktop rendering (was 2 separate methods). Notes shown directly without "Voir plus".
- **Reminder Card** — Badge + title on same line. "Créé le" prefix added to creation date.
- **File Card** — Type-colored illustration (doc=blue, sheet=green, pdf=red, folder=amber). Chips with separator below.
- **Email Card** — Square-rounded initials avatar. Full-width separator under header. Recipients with emails in collapsible.
- **Article Card** — Wikipedia badge above title. Separator above categories.
- **WebSearch Card** — Source chips above title. Results web with spacing. Sources as icon+link per line.
- **MCP Card** — KV rows for structured data. Raw block for JSON.
- **Event Organizer Email Filter** — Calendar group emails (`@group.calendar.google.com`, `@resource.calendar.google.com`) no longer displayed as organizer email.
- **`render_collapsible()` Enhancement** — New `with_separator` parameter (default `True`). Cards pass `False` when the preceding element already provides a separator.
- **i18n Labels** — Added `get_accessibility_title()` and `get_payment_title()` to V3Messages (6 languages).

### Fixed

- **Email Card Crash** — `V3Messages.get_messages()` and `get_files()` were called but didn't exist, causing silent render failure. Fixed by using numeric-only chip labels.
- **22 Dead Methods Removed** — Cleaned up legacy rendering methods no longer called after v4 migration across 8 card files.

## [1.13.1] - 2026-03-28

### Fixed

- **Calendar/Reminder/Task Timezone DST Bug** — When creating events for dates across DST boundaries (e.g. March 29 during CET→CEST transition), the LLM sent the current offset (+01:00) instead of the target date's offset (+02:00), causing events to be scheduled 1 hour late. `normalize_user_datetime()` now always strips and re-localizes to the correct offset for the target date. Applied to: create/update event, create/update task (due dates), create reminder (trigger_datetime), and event search (time_min/max). (`src/core/time_utils.py`, `src/domains/agents/tools/calendar_tools.py`, `src/domains/agents/tools/tasks_tools.py`, `src/domains/agents/tools/reminder_tools.py`)
- **Context Resolver Cross-Domain Contamination** — Queries like "show me the last email" after viewing calendar events were incorrectly routed to the event domain instead of email. Root cause: the reference resolver detected "the last" as a contextual reference to the previous turn's domain. Fix: context references can only confirm domains already detected by the query analyzer, or fill in when no domain was detected — never override with an unrelated domain. (`src/domains/agents/services/query_analyzer_service.py`)
- **DevOps Semantic Keywords Overmatch** — DevOps tool keywords were too generic ("check server logs", "vérifier les logs"), causing the briefing skill and other requests to be routed to devops. Replaced with Docker-specific prefixed keywords ("devops check docker container logs"). Removed French keywords (English-only convention). (`src/domains/agents/devops/catalogue_manifests.py`)
- **Prod Docker Socket Permissions** — Deploy scripts now auto-detect the host Docker group GID and inject `DOCKER_GID` into `.env` before running `docker compose up`, ensuring `appuser` has socket access on first deploy. (`scripts/deploy/deploy-prod.ps1`, `scripts/deploy/deploy.sh`)
- **Personal Data in Documentation** — Removed personal email addresses and private IP addresses from public documentation files. (`docs/technical/HITL.md`, `docs/guides/GUIDE_DEVOPS_CLAUDE_CLI.md`, `CHANGELOG.md`)

### Changed

- **Prod Memory Optimization** — Replaced PyTorch CUDA with CPU-only version in Dockerfile.prod (~700MB saved per worker on ARM64). Reventilated container RAM limits: Tempo 512M→768M, Web/Prometheus/Grafana/Loki 512M→256M, Redis/Portainer 256M→128M. API stays at 8GB with ~78% usage (was 94%). (`Dockerfile.prod`, `docker-compose.prod.yml`)
- **DomainConfig Priority Removed** — Removed unused `priority` field from `DomainConfig` dataclass and `get_domains_by_priority()` function. Domain selection is handled by LLM intelligence, not numeric priority. (`src/domains/agents/registry/domain_taxonomy.py`)
- **Blog & Guides Enriched** — Added self-enriching anti-hallucination registry documentation to "Execution Plans" blog article (6 languages) and technical guide section 6.4. (`apps/web/locales/`, `apps/web/src/data/guides/how.*.md`)

## [1.13.0] - 2026-03-28

### Added

- **DevOps Claude CLI Integration (Admin-only)** — New `devops` domain with `claude_server_task_tool` that allows administrators to interact with Claude Code CLI installed inside the API Docker containers. Claude CLI independently inspects logs, diagnoses issues, checks container health, and manages Docker services — all through natural language via the LIA assistant. Features: local subprocess execution (no SSH needed), real-time streaming progress via SSE `execution_step` events, session persistence for multi-turn investigations (`--resume`), configurable `--allowedTools`/`--disallowedTools` per server profile (dev: full access, prod: read-only investigation). Access controlled by `is_superuser` DB check with default-deny. (`src/domains/agents/devops/`, `src/domains/agents/tools/devops_tools.py`, `src/domains/agents/services/devops_ssh_service.py`)
- **Claude CLI in Docker Images** — Node.js 22 + Claude Code CLI + Docker CLI installed in both `Dockerfile.dev` and `Dockerfile.prod`. Docker socket mounted for container management. Auth credentials mounted read-only from host. (`Dockerfile.dev`, `Dockerfile.prod`, `docker-compose.dev.yml`, `docker-compose.prod.yml`)
- **DevOps Documentation** — Comprehensive guide covering architecture, prerequisites, deployment, security model, and troubleshooting. (`docs/guides/GUIDE_DEVOPS_CLAUDE_CLI.md`, `docs/INDEX.md`)
- **Alertmanager Email-Only Template** — Simplified template for environments without Slack/PagerDuty. Auto-selected by entrypoint when webhooks are not configured. (`apps/api/monitoring/alertmanager/alertmanager-email-only.yml.template`)

### Changed

- **DevOps Tool Timeout** — `claude_server_task_tool` added to high-latency tools list in parallel executor with 120s timeout (default 30s was causing CancelledError). (`src/domains/agents/orchestration/parallel_executor.py`)
- **Alertmanager Entrypoint** — Rewritten to gracefully handle missing SMTP (minimal log-only config), missing Slack/PagerDuty (email-only template), and inline env comment parsing bug. (`apps/api/monitoring/alertmanager/docker-entrypoint.sh`)

### Fixed

- **PostgreSQL Health Check FATAL Spam** — `pg_isready` health check was missing `-d ${POSTGRES_DB}`, causing PostgreSQL to attempt connection to a database named after the user (~720 FATAL/hour). Fixed in `compose.services.yml`, `docker-compose.dev.yml`, and `docker-compose.prod.yml`.
- **Philips Hue ConnectorType LookupError (Prod)** — Alembic migration inserted `philips_hue` (enum `.value`, lowercase) but SQLAlchemy expects `PHILIPS_HUE` (enum `.name`, uppercase). Fixed migration to use `.name` and added UPDATE for existing data. (`alembic/versions/2026_03_20_0001-add_philips_hue_global_config.py`)
- **Heartbeat ForeignKeyViolation (Prod)** — Proactive heartbeat used a nil UUID (`00000000-...`) as `conversation_id` fallback instead of `None`, violating the FK constraint on `message_token_summary`. Fixed to pass `None` (column is nullable). (`src/infrastructure/proactive/tracking.py`)
- **Heartbeat Journal Embedding Dimension Mismatch (Prod)** — Heartbeat used `get_local_embeddings()` (E5-small, 384 dim) to search journals indexed with OpenAI embeddings (1536 dim). Fixed to use `get_journal_embeddings()`. (`src/domains/heartbeat/context_aggregator.py`)
- **Missing LLM Pricing: claude-3-5-haiku-latest** — Added alias to pricing seed. (`infrastructure/database/seeds/llm_pricing_seed.sql`)
- **Alertmanager Config Error** — `.env` inline comments (`SLACK_WEBHOOK=  # comment`) were parsed as non-empty values, causing `unsupported scheme "" for URL`. Fixed by commenting out unused webhook variables. (`.env`)

## [1.12.4] - 2026-03-27

### Added

- **IoT Discovery-before-Planning** — When controlling Philips Hue lights, the planner now performs a lightweight discovery call to the Hue Bridge before generating the execution plan. Light and room names are injected into the planner context, enabling the LLM to resolve user descriptions (e.g., "plafond du salon") to exact device names ("Plafond salon"). Follows the same pattern as MCP reference discovery. (`src/domains/agents/services/smart_planner_service.py`)

### Changed

- **Landing Page Hero Subtitle** — Reworked hero subtitle into 3 concise lines: personality, orchestration, simplicity. Updated all 6 locale files. (`apps/web/locales/`)
- **Landing Page Image Generation Description** — Updated to cover all 3 use cases: generate from text, refine generated images, edit photos sent as attachments. Updated all 6 locale files. (`apps/web/locales/`)
- **Hue Semantic Keywords** — Aligned with codebase convention: English-only keywords (was the only multilingual outlier across 20 agent catalogues). (`src/domains/agents/hue/catalogue_manifests.py`)

### Fixed

- **Hue Light vs Room Control** — When asking to control a specific light in a room (e.g., "éteins le plafond du salon"), LIA now correctly targets the individual light instead of turning off the entire room. Root cause: semantic keywords in `control_hue_room_tool` contained room names ("salon") causing higher match scores, and `_find_resource_by_name()` used bidirectional partial matching. Fixed via: specificity rule in Hue agent prompt, strict exact-match in `_find_resource_by_name()`, and IoT discovery context injection. (`src/domains/agents/tools/hue_tools.py`, `src/domains/agents/prompts/v1/hue_agent_prompt.txt`, `src/domains/agents/prompts/v1/smart_planner_prompt.txt`)

## [1.12.3] - 2026-03-26

### Added

- **Image Download Button** — Discrete download button on generated images and browser screenshots in the chat. Visible on hover (desktop) or always semi-visible (mobile). Also available in the full-screen lightbox with loading spinner. Uses `fetch` + Blob to bypass cross-origin `<a download>` restrictions. Shared utility `downloadImage()` in `apps/web/src/lib/utils/download-image.ts` with robust MIME extension parsing (`jpeg→jpg`, `svg+xml→svg`), Unicode-safe filename sanitisation, and `response.ok` guard against error blob downloads. (`apps/web/src/components/chat/ChatMessage.tsx`, `apps/web/src/components/ui/image-lightbox.tsx`)

### Fixed

- **Mobile Long-Press "Save Image"** — Native browser context menu ("Save Image") now works on generated images and browser screenshots on iOS Safari and Android Chrome. Root cause: Starlette `FileResponse` defaulted to `Content-Disposition: attachment` when `filename` was provided, which prevented mobile browsers from recognising the resource as a displayable image. Fixed by using `content_disposition_type="inline"` for image MIME types, while keeping `attachment` for non-image files (PDF). (`apps/api/src/domains/attachments/router.py`)

## [1.12.2] - 2026-03-26

### Added

- **Progressive Browser Screenshots** — During browser navigation, screenshots are streamed in real-time via an SSE side-channel to the frontend, displayed as inline overlays in the chat flow. Thumbnails (640px, JPEG q60, ~30KB) provide lightweight visual feedback without LLM processing. Five capture points: navigate, click, fill, press_key, and the new `browser_snapshot_tool`. (`src/infrastructure/browser/session.py`, `src/domains/agents/tools/browser_tools.py`, `apps/web/src/components/chat/BrowserScreenshotOverlay.tsx`)
- **Final Browser Screenshot Card** — Last screenshot from each browsing session saved as an Attachment (full-res 1280px, JPEG q80) and displayed inside the assistant message bubble before markdown content. Persists on page reload via `loadConversationMessages` metadata extraction. Supports lightbox click-to-expand. (`apps/web/src/components/chat/ChatMessage.tsx`, `src/domains/agents/api/service.py`)
- **Generic Side-Channel Queue** — New `__side_channel_queue` in `RunnableConfig.configurable`, a generic `asyncio.Queue` mechanism for any tool to emit SSE events directly to the frontend without going through the LLM response. Fire-and-forget with graceful degradation. (`src/domains/agents/tools/runtime_helpers.py`)
- **`emit_side_channel_chunk()` Helper** — Generic helper in `runtime_helpers.py` for putting `ChatStreamChunk` instances into the side-channel queue. None-safe, never raises, silently drops chunks if queue unavailable. Reusable by any tool domain. (`src/domains/agents/tools/runtime_helpers.py`)
- **`browser_snapshot_tool`** — Fifth screenshot capture point added to the browser ReAct agent, providing a dedicated tool for explicit page snapshots alongside the implicit captures on navigate/click/fill/press_key. (`src/domains/agents/tools/browser_tools.py`)

### Changed

- **Side-Channel Interleaving** — `_interleave_side_channel()` in `service.py` polls the queue every 300ms even during long graph node executions (ReAct browser loop), ensuring real-time screenshot delivery regardless of graph stream timing. (`src/domains/agents/api/service.py`)

### Removed

- **`BROWSER_SCREENSHOT_ENABLED`** — Removed the legacy setting and `browser_screenshot_tool` that sent screenshots to the LLM as base64 text. The LLM cannot analyze images visually, making this tool useless. Replaced by progressive screenshots which stream directly to the user. (`src/core/config/browser.py`, `src/domains/agents/tools/browser_tools.py`)

## [1.12.1] - 2026-03-26

### Added

- **Image Pricing Admin Panel** — New admin section "LLM Image Pricing" under Settings → Administration. Full CRUD for managing per-image pricing by (model, quality, size). Follows the same pattern as LLM Text Pricing: paginated table with search and sorting, create/edit modal, soft-delete with temporal versioning, audit logging, and cache reload. React 19 `useOptimistic` + `useTransition` for instant UI feedback. 5 backend endpoints at `/admin/image-pricing/pricing` (list, create, update, delete, reload-cache). i18n in 6 languages. (`src/domains/image_generation/router.py`, `src/domains/image_generation/schemas.py`, `apps/web/src/components/settings/AdminImagePricingSection.tsx`)

### Changed

- **Admin Section Naming** — Standardized administration section titles across all 6 languages: "Administration des LLM" → "Tarification LLM Texte", "Administration des API Google" → "Tarification API Google", "Tarification génération d'images" → "Tarification LLM Image".

- **Journal Semantic Dedup Guard** — New programmatic guard in journal extraction that prevents duplicate entries. When the LLM proposes a new entry semantically similar to existing ones (cosine similarity ≥ configurable threshold), the system calls a merge LLM to fuse all matching entries into a single enriched directive instead of creating a duplicate. Supports N→1 consolidation: if multiple existing entries match, they are all merged into the primary and the secondaries are deleted. Configurable via `JOURNAL_DEDUP_SIMILARITY_THRESHOLD` (default: 0.72). New `journal_merge_prompt.txt` for LLM-driven entry fusion. Graceful degradation on any failure (embedding, search, or merge). (`src/domains/journals/extraction_service.py`, `prompts/v1/journal_merge_prompt.txt`)

### Changed

- **Admin Section Naming** — Standardized administration section titles across all 6 languages: "Administration des LLM" → "Tarification LLM Texte", "Administration des API Google" → "Tarification API Google", "Tarification génération d'images" → "Tarification LLM Image".
- **Journal Introspection Prompt Rebalanced** — Replaced the hard "prioritize learnings above all" directive with a neutral theme selection guide. Each theme now has multiple non-exhaustive examples and a classification decision tree. Added thematic diversity directive to avoid over-concentration in a single theme. Result: entries are now distributed across `learnings`, `user_observations`, `self_reflection`, and `ideas_analyses` instead of 87% learnings. (`prompts/v1/journal_introspection_prompt.txt`)

### Fixed

- **Image Edit Auto-Resolution** — `edit_image` tool no longer requires a valid UUID for `source_attachment_id`. When the planner passes a textual description instead of a UUID, the tool automatically resolves the most recent image attachment from the database. (`src/domains/agents/tools/image_generation_tools.py`)
- **UnifiedToolOutput.failure Signature** — All 23 `failure()` calls in image generation tools were missing the required `error_code` positional argument, causing `TypeError` on any error path in production. Fixed with appropriate codes (`TOOL_ERROR`, `NOT_FOUND`, `AUTH_ERROR`). (`src/domains/agents/tools/image_generation_tools.py`)
- **Image Generation Timeout on High Quality** — gpt-image-1 in high quality takes 40-90 seconds. The parallel executor now enforces a minimum 90-second timeout for image tools, overriding the planner's default 30s. (`src/domains/agents/orchestration/parallel_executor.py`)
- **Journal Consolidation Prompt Contradiction** — The consolidation prompt contained contradictory instructions: "most runs should produce few actions" vs "dedup is always mandatory." Removed the inhibiting phrase and strengthened STEP 1 (MANDATORY DEDUP) with explicit semantic similarity guidance (same topic from different angles = duplicate). (`prompts/v1/journal_consolidation_prompt.txt`)

### Security

- **Dependency Vulnerability Fix** — Pinned `picomatch@4.0.4` (was 4.0.3 + 2.3.1) to fix 4 Dependabot alerts: 2 high-severity ReDoS via extglob quantifiers and 2 medium-severity method injection in POSIX character classes. Pinned `flatted@3.4.2` for consistency. All overrides use exact versions. (`package.json`)

## [1.12.0] - 2026-03-26

### Added

- **AI Image Generation** — New domain `image_generation` with multi-provider abstract architecture (`ImageGenerationClient` → `OpenAIImageClient` factory). Users can generate images from text prompts via the `generate_image` tool, with results displayed as cards below the assistant response. Supports gpt-image-1 (low/medium/high quality, 3 size presets). Images saved as attachments on disk with ownership tracking. Cost tracking integrated into `TrackingContext` → `MessageTokenSummary` → `UserStatistics` → `UsageLimits`. Pricing loaded at startup with class-level in-memory cache and cross-worker Redis Pub/Sub invalidation. (`src/domains/image_generation/`, `src/domains/agents/tools/image_generation_tools.py`)
- **AI Image Editing** — New `edit_image` tool for modifying existing images via text instructions using the OpenAI Responses API (`images.generate` with `image` parameter). Auto-resolves the most recent image attachment when no UUID is provided — the planner never needs to know attachment IDs. Includes intelligent resize to the nearest supported dimension (1024×1024, 1024×1536, 1536×1024) preserving aspect ratio, with size-aware cost calculation. (`src/domains/agents/tools/image_generation_tools.py`, `src/domains/image_generation/resize.py`)
- **Image Generation User Preferences** — Per-user settings for quality (low/medium/high), size (square/portrait/landscape), and output format (png/webp). Defaults: enabled, low quality, portrait, PNG. Configurable in Settings → Preferences. Tools always use user preferences for cost control — planner cannot override. (`src/domains/auth/models.py`, `apps/web/src/components/settings/ImageGenerationSettings.tsx`)
- **Image Generation Admin Configuration** — `image_generation` LLM type added to `LLM_TYPES_REGISTRY` (category: specialized). Administrators can select model and provider in the LLM Configuration panel. Pricing seed data for gpt-image-1 (9 combinations: 3 qualities × 3 sizes). (`src/domains/llm_config/constants.py`, `infrastructure/database/seeds/image_generation_pricing_seed.sql`)
- **Image Generation Debug Panel** — Image generation calls appear in LLM Pipeline, LLM Calls, and Execution Times sections of the debug panel. Synthetic node record with model, quality, size, image count, and cost. (`src/domains/agents/api/service.py`)
- **Image Generation Catalogue & Domain** — `image_generation` domain registered in `domain_taxonomy.py` with `image_generation_agent` containing `generate_image` and `edit_image` tools. Full catalogue manifests with semantic keywords, cost profiles, and parameter schemas. 120-second agent timeout to accommodate high-quality generation latency. (`src/domains/agents/image_generation/catalogue_manifests.py`, `src/domains/agents/registry/domain_taxonomy.py`)
- **Generated Image Persistence** — Images stored as attachments with conversation-scoped metadata (`generated_images` array in message metadata). Survive page reload via `loadConversationMessages` metadata extraction. SSE `done` chunk includes `generated_images` for real-time display. Cascade deletion on conversation delete via existing attachment cleanup. (`apps/web/src/components/chat/ChatMessage.tsx`, `apps/web/src/hooks/useConversation.ts`)

### Fixed

- **Image Generation Tool Timeout on High Quality** — gpt-image-1 in high quality takes 40-90 seconds, but the parallel executor imposed a 30-second timeout (from planner LLM or default). Added minimum timeout enforcement for image tools: `max(step_timeout, 90s)` capped at 120s. (`src/domains/agents/orchestration/parallel_executor.py`)
- **Adaptive Replanner Marking Image Results as Empty** — `generate_image` returned a plain string, which the adaptive replanner classified as `empty_results`, triggering an unnecessary replan. Fixed by returning `UnifiedToolOutput.action_success()` with structured data. (`src/domains/agents/tools/image_generation_tools.py`, `src/domains/agents/orchestration/adaptive_replanner.py`)
- **UnifiedToolOutput.failure Missing error_code** — All 23 `failure()` calls in image generation tools were missing the required `error_code` positional argument, causing `TypeError` on any error path. Fixed with appropriate error codes (`TOOL_ERROR`, `NOT_FOUND`, `AUTH_ERROR`). (`src/domains/agents/tools/image_generation_tools.py`)
- **Edit Image Auto-Resolution** — Planner passed textual descriptions (e.g., "the photo of the black and white cat") instead of UUIDs for `source_attachment_id`. Fixed by making the parameter optional and auto-resolving the most recent image attachment from the database when no valid UUID is provided. (`src/domains/agents/tools/image_generation_tools.py`)

### Changed

- **Settings Layout Reorganization** — Moved Channels, Voice Mode, and Image Generation from Features tab to Preferences tab for better UX grouping. (`apps/web/src/app/[lng]/dashboard/settings/page.tsx`)

## [1.11.5] - 2026-03-25

### Fixed

- **Chat Message Bubble Content Truncation** — Markdown tables (and occasionally other long content) caused the assistant's response bubble to visually cut off. Root cause: `overflow: hidden` on `.message-bubble` and `.message-bubble-assistant` created an implicit scroll container that miscalculated intrinsic height when nested elements (like `table-wrapper`) had their own overflow. Fixed by replacing `overflow: hidden` with `overflow-x: clip; overflow-y: visible` — clips horizontal overflow without creating a scroll container, allowing the bubble to size correctly to its content. (`apps/web/src/styles/globals.css`)
- **76-Second Latency Spike After Response (Currency API Timeout Storm)** — After each assistant response, a ~76-second delay blocked the debug panel and new messages. Root cause: `CurrencyRateService` was instantiated fresh on every call in `business_metrics`, losing its in-memory cache each time. When the frankfurter.app currency API became unreachable from Docker, each instance retried 3 times × 5s timeout + exponential backoff = ~19s per call × 4 sequential calls = 76s blocking in `response_node`. Fixed with three changes: (1) cache promoted from instance-level to class-level (`_rate_cache` class dict shared across all instances); (2) negative-result cache (`_negative_cache`, 5-minute TTL) prevents retries after API failure; (3) retry policy reduced from 3 attempts to 2, with shorter backoff (`min=1, max=3` instead of `min=2, max=10`). Worst case drops from ~76s to ~6s on first failure, then 0s for 5 minutes. (`src/infrastructure/external/currency_api.py`, `tests/unit/test_currency_api.py`)
- **Route Arrival/Departure Time Off by 1 Hour (Naive Datetime Treated as UTC)** — When the user asked "arrive at 21h", the LLM passed `2026-03-26T21:00:00` (naive, no timezone) to the route tool. `parse_datetime()` defaulted naive datetimes to UTC, then `convert_to_user_timezone()` converted UTC 21:00 → Paris 22:00. The map and response showed 22h instead of 21h. Fixed by adding `normalize_user_datetime()` utility in `time_utils.py` that detects naive datetime strings (no `Z` or `+/-` offset) and attaches the user's timezone offset directly, without UTC conversion. Applied to both `arrival_time` and `departure_time` in `get_route_tool`. Datetimes with explicit timezone (from calendar events, APIs) are left unchanged. (`src/core/time_utils.py`, `src/domains/agents/tools/routes_tools.py`)

## [1.11.4] - 2026-03-25

### Fixed

- **HITL Draft Recipient Modification Ignored by LLM** — When a user requested a recipient change during draft critique (e.g., "non envoi à user@example.com"), the HITL classifier correctly detected `REPLAN` (converted to `EDIT`), and the `DraftModificationService` called the LLM, but the LLM consistently returned the original recipients unchanged. Root cause: the draft modifier prompt rule 2 ("Respect existing context (recipient, structure, etc.)") contradicted recipient change instructions, and rule 6 only covered contact references (`@carven`) — not direct email addresses. Fixed with a three-layer approach: (1) prompt rule 2 reworded to not protect recipients, rule 6 expanded to cover direct email addresses; (2) `_build_context_info()` now labels recipients as "modifiable" instead of presenting them as fixed context; (3) new `_apply_explicit_recipient_override()` post-processing extracts email addresses from instructions via regex and applies them directly when the LLM fails to change the `to`/`cc` fields. Also resolves contact names from instructions against the contact context as fallback. (`src/domains/agents/services/hitl/draft_modifier.py`, `src/domains/agents/prompts/v1/draft_modifier_prompt.txt`)

### Changed

- **Docker Dev Log Level Set to DEBUG** — `docker-compose.dev.yml` now overrides `LOG_LEVEL=DEBUG` for the API container, ensuring all debug-level logs (including LLM prompts, raw responses, and detailed state transitions) are visible during development without requiring `.env` changes. (`docker-compose.dev.yml`)
- **Draft Modifier Debug Observability** — Added 3 debug-level logs to `DraftModificationService`: `draft_modification_prompt_built` (system prompt preview), `draft_modification_llm_raw_response` (LLM raw output), and `actual_changes` field in `draft_modification_completed` (lists only fields that actually changed vs. all fields returned). Enables rapid diagnosis of LLM modification failures. (`src/domains/agents/services/hitl/draft_modifier.py`)

## [1.11.3] - 2026-03-25

### Security

- **SSRF Prevention in Profile Image Proxy** — `GET /profile-image-proxy` validated the initial URL hostname against `ALLOWED_IMAGE_DOMAINS` but used `follow_redirects=True` without post-redirect validation. An authenticated attacker could craft a Google CDN URL that redirects to internal services (metadata endpoints, private network). Fixed by validating the final response URL hostname after redirects. Reuses the same allowlist pattern as the pre-fetch check. (`src/domains/auth/router.py`)
- **SSRF Prevention in Philips Hue Pairing** — `POST /connectors/philips-hue/pair` accepted an unvalidated `bridge_ip` string parameter, allowing requests to arbitrary hosts (including cloud metadata endpoints, internal services). Added `_HueBridgeIpValidatorMixin` Pydantic validator enforcing private IPv4 addresses only (RFC 1918), rejecting loopback, public IPs, and IPv6. Applied to both `HuePairingRequest` and `HueLocalActivationRequest` schemas. (`src/domains/connectors/schemas.py`)
- **OAuth Redirect Parameter Injection** — Hue OAuth callback embedded the raw `error` query parameter from the OAuth provider directly into the redirect URL without sanitization. This was the only OAuth callback (out of 10) that bypassed the centralized `handle_oauth_callback_error_redirect()` handler. Fixed by aligning with the pattern used by all 9 other callbacks (Gmail, Google Contacts/Calendar/Drive/Tasks, Microsoft x4), which classifies errors via `OAuthCallbackErrorCode` enum values. Also aligned success redirect path to `/dashboard/settings` for consistency. (`src/domains/connectors/router.py`)
- **Incomplete URL Substring Sanitization** — `MarkdownContent.tsx` used `src.includes('googleusercontent.com')` to detect Google profile photos, which could match substrings in unrelated hostnames (e.g., `evil-googleusercontent.com`). Fixed by using `new URL(src).hostname` with exact match against the existing `GOOGLE_IMAGE_DOMAINS` array (exported from `utils.ts`). (`apps/web/src/components/chat/MarkdownContent.tsx`, `apps/web/src/lib/utils.ts`)

### Fixed

- **Journal Size Warning Logic** — `if usage_pct > 80` / `elif usage_pct > 100` conditions were ordered incorrectly: the first branch captured all values above 80 (including >100), making the "CRITICAL: exceeded limit" message unreachable. Users exceeding 100% saw the softer "approaching limit" warning instead. Fixed by reversing condition order (>100 first, then >80). (`src/domains/journals/extraction_service.py`)
- **Duplicate Constant Definition** — `MAX_AGENT_RESULTS_DEFAULT` was defined twice in `constants.py` (lines 1687 and 1891) with identical value. Removed the duplicate at line 1891 (misplaced in the observability section). (`src/core/constants.py`)
- **Implicit String Concatenation in List** — Adjacent string literals in `context_builder.py` list were implicitly concatenated without parentheses, creating a fragile pattern where a missing comma could silently change behavior. Wrapped in explicit parentheses. (`src/domains/journals/context_builder.py`)
- **Empty Except Blocks (10 alerts)** — Added explanatory comments to 6 justified cleanup/fallback `except` blocks (browser session close, pool memory probe, leader elector task cancel, Hue color parsing). Added `logger.debug()` to 2 parsing fallbacks (JSON recovery, UUID validation) and `logger.warning()` to 1 service load failure (personality service in journal extraction). 1 alert was a false positive (browser_tools.py except block was not actually empty). (`src/infrastructure/browser/session.py`, `src/infrastructure/browser/pool.py`, `src/infrastructure/scheduler/leader_elector.py`, `src/domains/journals/extraction_service.py`, `src/domains/connectors/clients/philips_hue_client.py`)
- **TLS Certificate Validation Comment** — Added explicit justification comment for `verify=False` in Hue bridge pairing (bridges use self-signed certificates by design). (`src/domains/connectors/clients/philips_hue_client.py`)

## [1.11.2] - 2026-03-25

### Changed

- **Complete Environment Configuration Overhaul** — All 8 `.env` files reorganized into 73 numbered sections with Table of Contents, standardized English comments (usage, impact, valid values), and full cross-file consistency. Files: `.env`, `.env.example`, `.env.prod`, `.env.prod.example`, `.env.min.prod`, `apps/web/.env.local.example`, `apps/web/.env.local.prod`, `apps/api/.env.test`. Section numbering is consistent across dev and prod files (prod skips `[07] SSL`). All comments are succinct inline format with column-aligned padding.
- **98 Missing Settings Keys Added** — Audit of all 18 Pydantic config modules (645 total fields) against `.env.example` revealed 98 non-LLM Settings fields that had no `.env` entry. All added with default values from `constants.py`, organized in their correct sections. Categories: scoring thresholds (18), HITL (9), context resolution (6), planner/orchestration (11), memory extraction (5), browser (7), RAG (6), and more.

### Fixed

- **`PLACE_CAROUSEL_ENABLED` Settings Violation** — Was read directly via `os.environ.get()` in `constants.py`, bypassing the Settings system. Migrated to `ConnectorsSettings.place_carousel_enabled` field with `PLACE_CAROUSEL_ENABLED_DEFAULT` constant. Removed orphan `import os` from `constants.py`. Updated both usages in `places_tools.py` to read from `settings.place_carousel_enabled`. (`src/core/constants.py`, `src/core/config/connectors.py`, `src/domains/agents/tools/places_tools.py`)
- **`RATE_LIMITING_ENABLED` Typo in `.env.test`** — Was `RATE_LIMITING_ENABLED=false` (non-existent field), corrected to `RATE_LIMIT_ENABLED=false` (actual `ConnectorsSettings.rate_limit_enabled` field).
- **`list[str]` Fields JSON Format** — `APPROVAL_AUTO_APPROVE_ROLES` and `APPROVAL_SENSITIVE_CLASSIFICATIONS` were added with comma-separated format (`admin,power_user`) which Pydantic-settings cannot parse for `list[str]` fields. Fixed to JSON format (`["admin","power_user"]`).
- **`ASSISTANT_NAME` Removed from `.env.min.prod`** — Was present as an env var but is actually a hardcoded constant in `constants.py` (not a Settings field). Removed to prevent confusion.
- **`.env.prod.example` Section Numbering** — SSL section removal caused all subsequent sections to be renumbered `[07]-[72]` instead of keeping `[08]-[73]`. Fixed to maintain consistent numbering with `.env.example`. Also fixed em-dash `—` replaced by `--` in section headers.

### Documentation

- Updated `docs/technical/MCP_INTEGRATION.md` with MCP settings completeness
- Updated `docs/technical/LLM_CONFIG_ADMIN.md` with note about LLM per-agent keys not in `.env`
- Updated `docs/knowledge/11_mcp_servers.md` with new MCP config keys

## [1.11.1] - 2026-03-25

### Added

- **ADR-063: Cross-Worker Cache Invalidation via Redis Pub/Sub** — When running with `uvicorn --workers N`, in-memory caches (class/module-level variables) are per-process. Modifying a config via the admin API only reloaded one worker — the other N-1 workers kept stale data. New centralized `invalidation.py` module uses Redis Pub/Sub to broadcast invalidation events. Each cache exposes `load_*()` (startup/subscriber) and `invalidate_and_reload()` (runtime = load + publish). Publisher includes `os.getpid()` to skip self-reload. `verify_registry_completeness()` at startup detects missing registrations. Applied to 4 caches: `LLMConfigOverrideCache`, `SkillsCache`, `PricingCacheService`, `GoogleApiPricingService`. (`src/infrastructure/cache/invalidation.py`, `src/core/constants.py`)
- **Calendar Tool Semantic Keywords** — Added 5 appointment-lookup keywords to `get_events_tool` catalogue manifest to fix semantic tool selection misranking read queries as update/create operations. Keywords: "which appointment do I have on Saturday", "what appointments this week", "do I have any appointments on that day", "what is on my calendar this weekend", "any events planned for Saturday". (`src/domains/agents/calendar/catalogue_manifests.py`)

### Fixed

- **Initiative Node Per-Turn State Reset** — `initiative_iteration` was never reset between conversation turns. Since LangGraph state is checkpointed to PostgreSQL, after the first turn (which increments `initiative_iteration` to 1), all subsequent turns arrived with `iteration >= max_iterations` (default 1), causing the initiative node to be systematically skipped with `reason: max_iterations`. Fixed by resetting all 4 initiative state fields (`initiative_iteration`, `initiative_results`, `initiative_skipped_reason`, `initiative_suggestion`) in the router node's per-turn state clearing block, alongside the existing `planner_iteration` reset. (`src/domains/agents/nodes/router_node_v3.py`)
- **Calendar Event Tool Selection Misranking** — Asking "quel rdv samedi ?" (which appointment Saturday?) caused the semantic tool selector to rank `update_event_tool` (0.656) and `create_event_tool` (0.341) above `get_events_tool` (0.002). The correct read-only tool was excluded by the catalogue score threshold (0.07), forcing the planner to delegate to a sub-agent, which triggered an unnecessary HITL approval prompt. Root cause: `get_events_tool` lacked appointment-lookup keywords while update/create tools had "change appointment time" and "schedule appointment" keywords that matched better. Fixed by adding targeted read-only appointment keywords. (`src/domains/agents/calendar/catalogue_manifests.py`)
- **Skills Cache Cross-Worker Invalidation** — All skill CRUD endpoints (`import`, `delete`, `update_description`, `translate`) now use `SkillsCache.invalidate_and_reload()` instead of local-only `load_from_disk()`. Reload endpoint explicitly publishes after `sync_from_disk()` commit. (`src/domains/skills/router.py`, `src/domains/skills/cache.py`)
- **LLM Config Cache Cross-Worker Invalidation** — `LLMConfigOverrideCache.invalidate_and_reload()` now publishes to Redis Pub/Sub after local reload. Previously, config changes (e.g., switching Initiative LLM model) were only effective on ~25% of requests (1 worker out of 4). (`src/domains/llm_config/cache.py`)
- **Google API Pricing Cache Cross-Worker Invalidation** — `GoogleApiPricingService.invalidate_and_reload()` added and wired to admin pricing reload endpoint. (`src/domains/google_api/pricing_service.py`, `src/domains/google_api/router.py`)
- **Pricing Cache Cross-Worker Invalidation** — `PricingCacheService.invalidate_and_refresh()` added for future runtime pricing modifications. (`src/infrastructure/cache/pricing_cache.py`)

## [1.11.0] - 2026-03-24

### Added

- **ADR-062: Agent Initiative Phase** — Post-execution enrichment node in the LangGraph pipeline. After the task orchestrator executes the user's request, the initiative node analyzes results, detects cross-domain signals, and proactively performs read-only verifications to enrich the response. Example: weather forecast shows rain → initiative checks calendar for outdoor events → response warns the user. Fully prompt-driven (no hardcoded logic), configurable via `INITIATIVE_ENABLED`, `INITIATIVE_MAX_ITERATIONS`, `INITIATIVE_MAX_ACTIONS`. Uses structured output with `InitiativeDecision` schema (OpenAI strict mode compatible). Includes pre-filter (skips when no adjacent read-only tools), memory/interests injection, and suggestion field for write-action proposals. (`src/domains/agents/nodes/initiative_node.py`, `src/domains/agents/prompts/v1/initiative_prompt.txt`, `src/domains/agents/registry/domain_taxonomy.py`)
- **MCP Iterative Mode (ReAct Sub-Agent)** — MCP servers with `iterative_mode: true` are now handled by a ReAct agent loop instead of the static planner. The agent interacts with the MCP server iteratively (reads documentation, then calls tools with correct parameters), solving the fundamental limitation where the planner pre-generated all parameters without understanding the server's API. Powered by a generic `ReactSubAgentRunner` (also used by browser agent). Configurable via `MCP_REACT_ENABLED`, `MCP_REACT_MAX_ITERATIONS`. Per-server activation via `iterative_mode` attribute on admin and user MCP configs. (`src/domains/agents/tools/react_runner.py`, `src/domains/agents/tools/mcp_react_tools.py`, `src/domains/agents/prompts/v1/mcp_react_agent_prompt.txt`)
- **ReactSubAgentRunner** — Generic, reusable runner for LangGraph ReAct sub-agents. Handles LLM creation, prompt loading, tool wrapping, MCP App registry propagation, and graceful error handling. Used by both browser agent and MCP iterative mode. Replaces 60+ lines of duplicated code in browser_tools.py. (`src/domains/agents/tools/react_runner.py`)
- **Domain Taxonomy Enrichment** — `related_domains` updated across all domain configs to enable richer cross-domain initiative detection: weather↔event (bidirectional), email↔contact↔event, task↔event↔contact, place↔weather↔route, file↔contact, reminder↔contact↔event. (`src/domains/agents/registry/domain_taxonomy.py`)
- **User MCP `iterative_mode`** — New boolean attribute on user MCP server configuration. Users can enable iterative mode per-server via the Settings UI. Includes Alembic migration, Pydantic schema update, frontend toggle with cost warning tooltip, and i18n in 6 languages. (`src/domains/user_mcp/models.py`, `src/domains/user_mcp/schemas.py`, `apps/web/src/components/settings/MCPServersSettings.tsx`)
- **Token Tracking `node_name_override`** — `TokenTrackingCallback` now supports a `node_name_override` in config metadata, allowing sub-agents to display meaningful names in the debug panel instead of internal graph node names. (`src/infrastructure/observability/callbacks.py`)
- **Initiative Prometheus Metrics** — 3 new metrics: `initiative_evaluations_total` (by decision: skip/act/error), `initiative_actions_executed_total`, `initiative_duration_seconds_histogram`. (`src/infrastructure/observability/metrics_agents.py`)
- **MCP ReAct Prometheus Metrics** — 2 new metrics: `mcp_react_invocations_total` (by server/status), `mcp_react_iterations_histogram`. (`src/infrastructure/observability/metrics_agents.py`)

### Changed

- **Browser Agent Refactoring** — `browser_task_tool` now uses `ReactSubAgentRunner` instead of inline ReAct agent creation. Removes ~60 lines of duplicated code. Functionally identical. (`src/domains/agents/tools/browser_tools.py`)
- **Excalidraw Cleanup** — Removed `SPATIAL_SUFFIX` override, `iterative_builder.py`, and `position_corrector.py`. Excalidraw now uses the generic MCP iterative mode (ReAct agent) which handles `read_me` → `create_view` flow naturally. (`src/infrastructure/mcp/excalidraw/overrides.py`, `src/infrastructure/mcp/tool_adapter.py`)
- **Smart Planner MCP Reference Filtering** — When a server uses `iterative_mode`, its `reference_content` is no longer injected into the planner prompt (the ReAct agent reads it itself via `read_me`). Saves ~27K tokens per Excalidraw request. (`src/domains/agents/services/smart_planner_service.py`)
- **OpenAI Strict Mode Compatibility** — Added `ConfigDict(extra="forbid")` to `ParameterValue`, `ParameterItem`, `InitiativeAction`, and `InitiativeDecision` to ensure `additionalProperties: false` in JSON schemas. Required for OpenAI structured output mode. (`src/domains/agents/orchestration/plan_schemas.py`, `src/domains/agents/nodes/initiative_node.py`)

### Fixed

- **Excalidraw Incoherent Diagrams** — Diagrams generated by the static planner were spatially incoherent (texts and arrows scattered randomly). Root cause: the planner is not specialized for Excalidraw JSON format and the 27K-char cheat sheet was being ignored in the complex planning context. Fix: MCP iterative mode lets a dedicated ReAct agent read the documentation and generate elements correctly.

## [1.10.2] - 2026-03-24

### Fixed

- **HITL Draft CC/BCC Modification** — CC and BCC fields were not modifiable during HITL draft review (EDIT action). When a user requested to add, change, or remove CC/BCC recipients on an email draft, the modification was silently ignored. Root cause: `cc` and `bcc` were in `PRESERVED_FIELDS` (immutable) instead of `CONTENT_FIELDS` (LLM-modifiable). Same pattern as the `to` field fix from 2026-01-11, but `cc`/`bcc` were missed. Additionally, `_parse_modification_response()` now supports `clearable_fields` (`cc`, `bcc`) so that returning an empty string explicitly removes recipients instead of preserving originals. (`src/domains/agents/services/hitl/draft_modifier.py`)
- **HITL Draft Field Configuration Audit** — Comprehensive audit and correction of `PRESERVED_FIELDS` and `CONTENT_FIELDS` across all 9 draft types to align with actual Pydantic models and connector protocol signatures:
  - `email_reply`: `in_reply_to` renamed to `message_id` (matching `EmailReplyDraftInput`); `cc`/`bcc`/`subject` excluded from `CONTENT_FIELDS` (not supported by `reply_email` protocol across Google/Apple/Microsoft connectors)
  - `email_forward`: `original_message_id` renamed to `message_id` (matching `EmailForwardDraftInput`); `bcc`/`subject` excluded (not supported by `forward_email` protocol); `cc` confirmed as supported
  - `event`/`event_update`: added `timezone` to `PRESERVED_FIELDS` (prevents LLM from inadvertently changing timezone during content edits)
  - `contact_update`: added `address` to `CONTENT_FIELDS` (field existed in `ContactUpdateDraftInput` but was not modifiable)
  - `task`/`task_update`: fixed `tasklist_id` → `task_list_id` (matching actual field name in `TaskDraftInput`/`TaskUpdateDraftInput`)
    (`src/domains/agents/services/hitl/draft_modifier.py`)

## [1.10.1] - 2026-03-24

### Added

- **ADR-061: Centralized Component Activation** — Three-layer defense system for component enable/disable control. Layer 1: domain gate-keeper validates LLM-output domains against `available_domains` (strips hallucinated/disabled domains post-LLM and post-expansion in `query_analyzer_service.py`). Layer 2: per-request `request_tool_manifests_ctx` ContextVar built once at request start, combining registry manifests minus admin MCP disabled plus user MCP tools — all consumers read filtered manifests from a single source instead of 7+ scattered filter sites. Layer 3: API guard returns 403 on admin MCP proxy endpoints (`call-tool`, `read-resource`) for disabled servers, with defense-in-depth in `MCPClientManager`. (`src/core/context.py`, `src/domains/agents/services/query_analyzer_service.py`, `src/domains/agents/api/service.py`, `src/domains/user_mcp/admin_router.py`, `src/infrastructure/mcp/client_manager.py`)
- **GPT-5.4 Model Support** — Added `gpt-5.4` and `gpt-5.4-mini` model profiles with full capabilities (reasoning, vision, structured output, streaming). Pricing seeded in `llm_pricing_seed.sql` (117 models). (`src/infrastructure/llm/model_profiles.py`, `infrastructure/database/seeds/llm_pricing_seed.sql`)
- **Run-Level Token Tracking** — All `TrackingContext` instances sharing the same `run_id` now publish their committed records to a module-level collector (`_run_records`, `_run_google_api_records`). The debug panel shows EVERY LLM call (pipeline + background tasks like memory/interest/journal extraction) in a single unified view. `cleanup_run_records(run_id)` prevents memory leaks after the debug panel is emitted. (`src/domains/chat/service.py`, `src/domains/agents/services/streaming/service.py`)
- **Debug Metrics sessionStorage Persistence** — Debug metrics history is persisted to `sessionStorage` so it survives page navigation within the same tab. Hydrated on `createInitialState()`, updated via `useEffect`. Capped at 50 entries to stay within the 5 MB storage limit. (`apps/web/src/reducers/chat-reducer.ts`, `apps/web/src/hooks/useChat.ts`)
- **Onboarding Pages Overhaul** — Complete redesign of the onboarding flow: Page 1 adds a 4-line intro explaining what makes LIA different from ChatGPT/Claude/Gemini. Page 2 replaces Google-specific connector options with 5 essential external connectors (Brave Search, Wikipedia, Google Places, OpenWeatherMap, Browser) with descriptions and provider mixing note. Page 4 adds autonomous memory description and settings management tip. Page 7 adds a feature discovery list (Skills, MCPs, RAG, Scheduled Actions, Voice Mode) before the example categories. All 6 locale files updated (en, fr, de, es, it, zh). (`apps/web/src/components/onboarding/pages/Page1Welcome.tsx`, `Page2Connectors.tsx`, `Page4Memory.tsx`, `Page7Examples.tsx`)
- **Background Task Token Awaiting** — Debug panel now awaits background tasks (memory, interest, journal extraction) up to 15s before reading DB-aggregated totals, ensuring the debug panel shows the same cost as the chat bubble. (`src/domains/agents/services/streaming/service.py`)

### Changed

- **Responses API Pattern-Based Eligibility** — Replaced hardcoded `RESPONSES_API_ELIGIBLE_MODELS` set (30+ entries) with a single regex pattern `^(gpt-4\.1|gpt-5|o[1-9])`. Auto-extensible for future GPT-5.x and o-series models. (`src/infrastructure/llm/providers/responses_adapter.py`)
- **Tool Conversion via `convert_to_openai_function`** — `ResponsesLLM._convert_tools()` and `_format_tools_for_binding()` now delegate to LangChain's `convert_to_openai_function()` instead of manual `model_json_schema()` calls. Fixes crash on tools with `InjectedToolArg` annotations (non-serializable `CallableSchema`). (`src/infrastructure/llm/providers/responses_adapter.py`)
- **Excalidraw Intent-Only Mode** — Removed `position_corrector.py` (384 lines) and its test file. The tool adapter no longer has a fallback path for raw Excalidraw elements — only structured intent objects are processed through the iterative builder. Simplified `_prepare_excalidraw()`, updated documentation strings and prompt override. (`src/infrastructure/mcp/tool_adapter.py`, `src/infrastructure/mcp/excalidraw/`)
- **Centralized Tool Manifest Access** — Router node, normal/panic filtering strategies, and expansion service now read from `get_request_tool_manifests()` instead of `registry.list_tool_manifests()` + manual per-consumer filtering. Eliminates duplicate filtering logic across 7+ locations. (`src/domains/agents/nodes/router_node_v3.py`, `src/domains/agents/services/catalogue/strategies/`, `src/domains/agents/semantic/expansion_service.py`)
- **Query Analyzer Domain Builder Extraction** — Extracted `_build_available_domains()` helper from inline code in `analyze_query()`. Called once per request and reused for both LLM prompt construction and post-expansion domain validation. (`src/domains/agents/services/query_analyzer_service.py`)
- **HeroSection Responsive Subtitle** — Removed `whitespace-nowrap` from hero subtitle for proper text wrapping on mobile. (`apps/web/src/components/landing/HeroSection.tsx`)

### Fixed

- **Disabled MCP Server Tool Execution** — When a user disabled an admin MCP app (e.g., Excalidraw), the system continued routing queries to that domain and executing its tools. Root cause: LLM-output domains were never validated against `available_domains`, and semantic expansion could re-introduce disabled domains. Fixed by ADR-061 three-layer defense. (`src/domains/agents/services/query_analyzer_service.py`, `src/core/context.py`)
- **GPT-5.4 reasoning_effort + Tools Incompatibility** — `gpt-5.4` and later models do not support `reasoning_effort` parameter simultaneously with function tools in `/v1/chat/completions`. Fixed by omitting `reasoning_effort` when tools are present. Applied to both `_generate()` and `_stream()` paths. (`src/infrastructure/llm/providers/responses_adapter.py`)
- **Browser Tool Store Propagation** — `browser_task_tool` nested ReAct agent was missing the parent graph's `InMemoryStore`, causing `validate_runtime_config` failures. Fixed by passing `runtime.store` to `create_react_agent()`. (`src/domains/agents/tools/browser_tools.py`)
- **AdminLLMConfigSection Loading Flicker** — Loading spinner was shown during refetches (not just initial load), causing the entire content to unmount and lose focus. Fixed by conditioning spinner on `loading && configs.length === 0`. (`apps/web/src/components/settings/AdminLLMConfigSection.tsx`)
- **Debug Panel Missing Background Task Costs** — The debug panel displayed token costs only from the main pipeline, missing memory/interest/journal extraction costs. Fixed by run-level token aggregation and background task awaiting. (`src/domains/chat/service.py`, `src/domains/agents/services/streaming/service.py`)

### Removed

- **Excalidraw Position Corrector** — Deleted `position_corrector.py` and `test_excalidraw_position_corrector.py`. The module corrected text centering and shape overlaps in raw LLM-generated Excalidraw elements, but is no longer needed since the system now exclusively uses intent-based diagram generation via the iterative builder.

## [1.10.0] - 2026-03-23

### Added

- **Push-to-Talk Mobile Fix** — Comprehensive fix for push-to-talk on smartphones. CSS anti-long-press (`select-none`, `-webkit-touch-callout:none`, `onContextMenu`), handlers always attached (eliminates race condition when `showSendMode` changes mid-touch), `onTouchCancel` for system interruptions, `onTouchMove` for finger-slide cancellation. `e.preventDefault()` now conditional: only called during actual push-to-talk, preserving form submit on mobile. (`apps/web/src/components/chat/ChatInput.tsx`)
- **Push-to-Talk Cancel Support** — Users can release the button during the async setup phase (state 'connecting') to cancel. `cancelledRef` flag checked after `Promise.allSettled` completes. `stopRecording()` extended to handle 'connecting' state. (`apps/web/src/hooks/useVoiceInput.ts`)
- **Push-to-Talk Latency Optimization** — `getUserMedia` + WS connect parallelized via `Promise.allSettled` (saves ~100-500ms). Worklet Blob URL cached across recordings. WebSocket pre-warmed in background during idle state. Setup timeout (10s) prevents indefinite blocking on slow networks. (`apps/web/src/hooks/useVoiceInput.ts`, `apps/web/src/lib/constants.ts`)
- **Voice Mode Latency Optimization** — KWS microphone stream reused for recording (eliminates `getUserMedia` call, saves ~200-800ms). WebSocket pre-connected during listening state. Recording worklet URL cached. VAD silence threshold reduced from 1000ms to 750ms for faster end-of-speech detection. (`apps/web/src/hooks/useVoiceMode.ts`)
- **Ready Chime** — Short synthesized audio cue (ascending C5→E5 major third, ~250ms) plays when recording starts after wake word detection, providing auditory feedback that the app is ready. Uses Web Audio API oscillators, no external audio file. (`apps/web/src/lib/audio/ready-chime.ts`)
- **Per-User STT Language** — User's preferred language (from DB `user.language` column) is now included in the WebSocket ticket and passed to the backend STT service. `SherpaSttService` maintains a thread-safe cache of `OfflineRecognizer` instances keyed by language code, biasing Whisper transcription to the user's language instead of auto-detection. (`apps/api/src/domains/voice/ticket_store.py`, `apps/api/src/domains/voice/stt/sherpa_stt.py`, `apps/api/src/domains/voice/router.py`)
- **Send Button Loading State** — Send icon remains visible (at 30% opacity) with a spinning overlay when disabled, instead of being replaced by a spinner. Preserves visual landmark. Uses `text-primary-foreground` for correct light/dark mode rendering. (`apps/web/src/components/chat/ChatInput.tsx`)
- **Sherpa WASM Setup Script** — New `scripts/download-sherpa-wasm.sh` downloads the pre-built sherpa-onnx WASM runtime (VAD + ASR + Whisper Tiny.en bundled, ~111MB) from GitHub releases. Integrated into `scripts/setup-dev.sh` as step 3/3 and `Dockerfile.prod` model-downloader stage. (`scripts/download-sherpa-wasm.sh`, `scripts/setup-dev.sh`, `apps/web/Dockerfile.prod`)
- **Safari iOS Voice Mode Support** — Changed `Cross-Origin-Embedder-Policy` from `credentialless` to `require-corp`, enabling `crossOriginIsolated` (and thus `SharedArrayBuffer` for Sherpa WASM) on Safari iOS. Google Fonts `crossOrigin="anonymous"` attribute added. Google profile images already proxied via existing endpoint. (`apps/web/next.config.ts`, `apps/web/src/app/[lng]/layout.tsx`)
- **VoiceInputService.updateCallbacks()** — Allows re-wiring callbacks on a pre-warmed service instance without creating a new connection. Used by both push-to-talk and voice mode pre-warm flows. (`apps/web/src/lib/voice-input-service.ts`)

### Fixed

- **Sherpa WASM Script Loading** — Browser `class` declarations at top-level of `<script>` tags don't become `window` properties in strict mode. Fixed by fetching script content, appending a shim that explicitly assigns `createVad`, `CircularBuffer`, and `OfflineRecognizer` to `window`, then executing via Blob `<script>` tag. (`apps/web/src/lib/audio/sherpaKws.ts`)
- **VoiceModeBadge Stuck Initializing** — Badge remained in "Initializing..." state forever on browsers where KWS is not supported (missing `SharedArrayBuffer`). Fixed by checking `isKwsSupported` in the `isInitializing` condition. (`apps/web/src/components/voice/VoiceModeBadge.tsx`)
- **handleSubmit Guard Incomplete** — Form submit was not blocked during push-to-talk 'connecting' state. Added `voiceState !== 'connecting'` to the guard. (`apps/web/src/components/chat/ChatInput.tsx`)

## [1.9.6] - 2026-03-23

### Added

- **Unified LLM + Embedding Tracking** — Embedding calls (journal context, memory search, RAG retrieval via `TrackedOpenAIEmbeddings`) are now recorded in the conversation's main `TrackingContext` instead of a separate standalone tracker. This makes embedding token usage visible in the debug panel alongside chat completions and TTS. Dual-strategy approach: (1) when a conversation tracker is active (via `current_tracker` ContextVar), record directly into it; (2) fallback to standalone `TrackingContext` for background operations (RAG indexing, scheduled tasks). Graceful degradation with try/except ensures embedding calls never break on tracking failures. (`apps/api/src/infrastructure/llm/embedding_context.py`, `apps/api/src/infrastructure/llm/tracked_embeddings.py`)
- **TokenUsageRecord call_type & sequence** — Two new fields on `TokenUsageRecord` NamedTuple: `call_type` (`"chat"` | `"embedding"`, default `"chat"`) distinguishes LLM call categories, and `sequence` (monotonic counter under asyncio lock) provides chronological ordering. Both fields are backward-compatible (keyword defaults). `get_llm_calls_breakdown()` now returns these fields for the debug panel. (`apps/api/src/domains/chat/service.py`)
- **Debug Panel: LLM Pipeline Section** — New `LLMPipelineSection` component showing ALL LLM calls (chat + embedding) in chronological execution order. Each row displays: sequence number, type badge (CHAT/EMB), node badge with color, model name, duration, tokens IN/CACHE/OUT, and cost. Summary header shows total calls (split by type), duration, tokens, and cost. (`apps/web/src/components/debug/components/sections/LLMPipelineSection.tsx`)
- **Debug Panel: Embedding Visibility** — Embedding calls now appear in existing debug sections: LLM Calls section shows `EMB` badge (teal) with `—` for tokens_out; Request Lifecycle section includes embedding nodes; Token Budget totals include embedding tokens; LLM Summary aggregates all call types. (`apps/web/src/components/debug/components/sections/LLMCallsSection.tsx`, `apps/web/src/components/debug/DebugPanel.tsx`)
- **Embedding Duration Tracking** — `TrackedOpenAIEmbeddings` now passes `duration_ms` (latency in milliseconds) to `persist_embedding_tokens()`, enabling timing display in the debug panel. (`apps/api/src/infrastructure/llm/tracked_embeddings.py`)

### Fixed

- **Embedding ContextVar Overwrite Bug** — `persist_embedding_tokens()` previously created `async with TrackingContext(...)` which temporarily overwrote the `current_tracker` ContextVar, potentially corrupting concurrent access to the conversation tracker. The new approach avoids creating a new `TrackingContext` when a conversation tracker is already active. (`apps/api/src/infrastructure/llm/embedding_context.py`)
- **LLMCallsSection Hardcoded Node Colors** — Node color determination in `LLMCallsSection` used inline `includes()` checks instead of the centralized `getNodeColor()` helper, causing new node types (like embedding) to always fall back to default color. Refactored to use `getNodeColor()`. (`apps/web/src/components/debug/components/sections/LLMCallsSection.tsx`)
- **Zod Schema Gaps (v3.2 debt)** — `LLMCallSchema` was missing `duration_ms`, `LifecycleNodeSchema` was missing `duration_ms`, and `RequestLifecycleSchema` was missing `total_duration_ms`. Added as optional fields. (`apps/web/src/components/debug/validation/schemas.ts`)

## [1.9.5] - 2026-03-23

### Added

- **ToolManifest.context_save_mode** — New `context_save_mode: ContextSaveMode | None` field on `ToolManifest` dataclass enables explicit LIST/DETAILS override for context auto-save classification, bypassing the name-based heuristic in `classify_save_mode()`. Propagated through both parallel_executor and `@connector_tool`/`@auto_save_context` decorator chains. Set to `ContextSaveMode.LIST` on all 4 unified tools (get_events, get_emails, get_contacts, get_tasks). (`apps/api/src/domains/agents/registry/catalogue.py`, `apps/api/src/domains/agents/context/manager.py`, `apps/api/src/domains/agents/orchestration/parallel_executor.py`, `apps/api/src/domains/agents/context/decorators.py`, `apps/api/src/domains/agents/tools/decorators.py`)
- **Email Reply/Forward HITL Domains** — Separate `email_reply` and `email_forward` insufficient content domains with domain-specific required fields (reply: body only; forward: recipient + optional body). Includes i18n questions (6 languages), field questions, detection patterns, DRAFT_TYPE_EMOJIS, and DRAFT_SUMMARIES. (`apps/api/src/core/constants.py`, `apps/api/src/core/i18n_hitl.py`)
- **Task Update current_task Fetch** — `UpdateTaskDraftTool` now fetches the current task before creating the draft, enabling before/after comparison in HITL critique (consistent with calendar and contact update patterns). Due date converted from UTC to user timezone. (`apps/api/src/domains/agents/tools/tasks_tools.py`)
- **Rich HITL Draft Critique Prompt** — Redesigned `hitl_draft_critique_prompt.txt` with domain-specific markdown templates (email, event, contact, task), emoji field prefixes, before/after strikethrough for updates, irreversibility warnings for deletions. (`apps/api/src/domains/agents/prompts/v1/hitl_draft_critique_prompt.txt`)
- **Rich Post-HITL Result Display** — `_format_draft_execution_result` now shows all draft attributes with i18n labels, domain emojis, formatted dates, and clickable links. Intermediate search results (`[search] N event(s):...`) are replaced by the execution result instead of being concatenated. Module-level `_DRAFT_RESULT_FIELD_CONFIG` defines field rendering per domain. (`apps/api/src/domains/agents/nodes/response_node.py`)
- **Enriched HITL Fallback Summaries** — `_generate_fallback_critique` now produces multi-line structured summaries with extra fields (body for emails, location/attendees for events, phone/org for contacts, due/notes for tasks) and `---` separator before action buttons. (`apps/api/src/domains/agents/services/hitl/interactions/draft_critique.py`)

### Fixed

- **Calendar 404 on Non-Primary Calendar** — `update_event_tool` and `delete_event_tool` failed with 404 when modifying events on shared calendars (e.g., "Famille"). Root cause: `calendar_id` not propagated from search step to mutation step. Triple fix: (1) `calendar_id` added to `get_events_tool` catalogue outputs + reference_examples with `semantic_type="calendar_id"`, (2) `_CALENDAR_ID_PARAM` gains `semantic_type="calendar_id"` for planner semantic binding, (3) new `_resolve_calendar_id_from_context` helper reads both LIST and DETAILS store keys. (`apps/api/src/domains/agents/calendar/catalogue_manifests.py`, `apps/api/src/domains/agents/tools/calendar_tools.py`)
- **Context Store Classification Bug** — All unified `get_*_tool` names (get_events, get_emails, get_contacts, get_tasks) were classified as DETAILS by `classify_save_mode()` because "get" matched the DETAILS keyword rule. Mutable tools reading from LIST key found nothing. Fixed by `context_save_mode=ContextSaveMode.LIST` on manifests and decorators. (`apps/api/src/domains/agents/registry/catalogue.py` + 4 catalogue files + 4 tool files)
- **GetEventDetailsTool calendar_id Lost** — In ID mode (`get_events_tool(event_id="abc")`), `calendar_id` was resolved for the API call but not included in the result dict. Events stored in the registry had no `calendar_id`. Fixed in `_execute_single`, `_execute_batch`, and `format_registry_response`. (`apps/api/src/domains/agents/tools/calendar_tools.py`)
- **Usage Limits Cache KeyError** — `check_user_allowed()` read `cached["allowed"]` directly but `cache_set_json()` wraps data in `{"data": {...}}` envelope. Fixed with `cached.get("data", cached)` unwrap. (`apps/api/src/domains/usage_limits/service.py`)
- **Semantic Pivot Translating User Content** — Planner received `english_enriched_query` (with translated content like "merci" → "Thank you") instead of `original_query` (user's language). Email bodies, event titles, task names were sent in English. Fixed: planner now always receives `original_query` for content extraction; English enriched version passed as structural context with explicit "CONTENT RULE" directive. (`apps/api/src/domains/agents/services/smart_planner_service.py`, `apps/api/src/domains/agents/prompts/v1/smart_planner_prompt.txt`, `apps/api/src/domains/agents/prompts/v1/smart_planner_multi_domain_prompt.txt`)
- **Email Reply Recipient Override Ignored** — `execute_email_reply_draft()` did not pass the `to` field to `client.reply_email()`, and `google_gmail_client.reply_email()` hardcoded the recipient to the original sender. Draft modifications to recipient were silently ignored. Fixed across Google, Microsoft, Apple clients and protocol. (`apps/api/src/domains/agents/tools/emails_tools.py`, `apps/api/src/domains/connectors/clients/google_gmail_client.py`, `apps/api/src/domains/connectors/clients/microsoft_outlook_client.py`, `apps/api/src/domains/connectors/clients/apple_email_client.py`, `apps/api/src/domains/connectors/clients/protocols.py`)
- **Email Reply Missing Quoted Body** — Gmail and Apple reply_email sent only the new body without the quoted original message. Fixed: both now include `> On [date], [sender] wrote:` quoted block (Microsoft handles this server-side). (`apps/api/src/domains/connectors/clients/google_gmail_client.py`, `apps/api/src/domains/connectors/clients/apple_email_client.py`)
- **Microsoft Outlook Forward Missing CC** — `forward_email()` accepted `cc` parameter but never added `ccRecipients` to the Graph API request. (`apps/api/src/domains/connectors/clients/microsoft_outlook_client.py`)
- **Contact Update Missing Address** — `execute_contact_update_draft()` did not pass `address` field to client. (`apps/api/src/domains/agents/tools/google_contacts_tools.py`)
- **Email Reply HITL Asked for Recipient** — Semantic validator treated reply/forward same as send, requiring recipient + subject + body. Reply only needs body; forward only needs recipient. Fixed with separate `email_reply`/`email_forward` insufficient content domains. (`apps/api/src/core/constants.py`, `apps/api/src/core/i18n_hitl.py`)
- **Contacts Catalogue Alias Mismatch** — `reference_examples` used `emails`/`phones` (old aliases) instead of `emailAddresses`/`phoneNumbers` (actual Google API field names in registry). (`apps/api/src/domains/agents/google_contacts/catalogue_manifests.py`)
- **Email Subject Not Top-Level** — `reference_examples` declared `emails[0].subject` but subject was only in nested `payload.headers`. Promoted to top-level in `build_emails_output()` with Apple Mail fallback. (`apps/api/src/domains/agents/tools/mixins.py`, `apps/api/src/domains/agents/emails/catalogue_manifests.py`)
- **Calendar HITL Timezone Mismatch** — `current_event` dates from Google API were in UTC while draft dates were in user timezone, causing wrong before→after display (e.g., "17h→16h" instead of "17h→15h"). Fixed: UTC→user timezone conversion for `current_event` (update) and `event` (delete). Same fix for task `current_task.due`. (`apps/api/src/domains/agents/tools/calendar_tools.py`, `apps/api/src/domains/agents/tools/tasks_tools.py`)
- **Draft Model Inconsistency** — `EmailReplyDraftInput.to_reply_email_args()` did not include `to` field. (`apps/api/src/domains/agents/drafts/models.py`)
- **Post-HITL Search Results Leak** — After HITL confirmation, `[search] N event(s):...` from intermediate steps was concatenated with the execution result instead of being replaced. (`apps/api/src/domains/agents/nodes/response_node.py`)

## [1.9.4] - 2026-03-23

### Changed

- **Systematic Settings Priority Chain Enforcement** — Comprehensive refactoring of ~291 runtime constant usages across ~80 files to use `settings.field_name` instead of direct constants. Enforces the priority chain APPLICATION (admin UI / DB) > .ENV (settings) > CONSTANT (fallback only). Six fix patterns applied: direct replacement (Pattern A), `getattr` simplification (Pattern B), module-level alias re-sourcing (Pattern C), None sentinel for function defaults (Pattern D), Pydantic `default_factory` for domain schemas (Pattern E), and f-string description updates (Pattern F). Constants now reserved exclusively for: `Field(default=...)` in config files, SQLAlchemy `default=`/`server_default=`, structural values (node names, state keys, Redis prefixes, scheduler IDs). (`apps/api/src/` — 80+ files across all domains)
- **i18n Chain Fix** — `i18n_dates.py` had a hardcoded `DEFAULT_LANGUAGE = "fr"` bypassing settings, and `i18n_drafts.py` imported from `i18n_types.py` (also hardcoded) instead of `i18n.py` (which reads from settings). Both now correctly route through the settings-backed `i18n.py` bridge. (`apps/api/src/core/i18n_dates.py`, `apps/api/src/core/i18n_drafts.py`)
- **Agent Constants Alias Cleanup** — Removed 4 redundant aliases in `agents/constants.py` (`CONTEXT_ACTIVE_WINDOW_TURNS`, `CONTEXT_RESOLUTION_TIMEOUT_MS`, `CONTEXT_DEMONSTRATIVE_CONFIDENCE`, `CONTEXT_CURRENT_ITEM_CONFIDENCE`) that bypassed settings. Consumers migrated to `settings.*` access. (`apps/api/src/domains/agents/constants.py`, `apps/api/src/domains/agents/services/context_resolution_service.py`)
- **Personalities Constants Cleanup** — Removed re-exported `DEFAULT_LANGUAGE`, `SUPPORTED_LANGUAGES`, and `FALLBACK_LANGUAGES` from `personalities/constants.py`. `FALLBACK_LANGUAGES` was capturing the constant "fr" at import time; replaced with inline `(settings.default_language, "en")` in the single consumer. (`apps/api/src/domains/personalities/constants.py`, `apps/api/src/domains/personalities/models.py`)
- **Token Counter Aliases Re-sourced** — `TOKEN_THRESHOLD_SAFE/WARNING/CRITICAL/MAX` module-level aliases in `token_counter_service.py` now read from `settings.*` instead of constants, while preserving backward-compatible exports for tests. (`apps/api/src/domains/agents/services/token_counter_service.py`)

### Fixed

- **Places Tool Crash on Language Parameter** — `get_places_tool()` raised `TypeError: unexpected keyword argument 'language'` when the LLM planner included a `language` parameter in the execution plan. Added optional `language: str | None = None` parameter to accept the argument gracefully (tool already reads language from runtime context). (`apps/api/src/domains/agents/tools/places_tools.py`)

## [1.9.3] - 2026-03-23

### Added

- **Journal Semantic Search Overhaul** — Migrated journal embeddings from local E5-small (384d) to OpenAI `text-embedding-3-small` (1536d) via pgvector `Vector()` column with HNSW index. Added `search_hints` field (LLM-generated keywords in user vocabulary) to bridge the semantic gap between assistant introspection and user queries. Search hints are displayed as badges and editable in Settings → Personal Journals. 3 Alembic migrations (search_hints column, pgvector migration with data purge, injection tracking). (`apps/api/src/domains/journals/embedding.py`, `apps/api/src/domains/journals/service.py`, `apps/api/src/domains/journals/models.py`)
- **Journal Temporal Continuity** — Configurable `JOURNAL_CONTEXT_RECENT_ENTRIES` setting injects the N most recent journal entries regardless of semantic score, ensuring the assistant always has access to its latest reflections. Deduplication with semantic results prevents double injection. (`apps/api/src/domains/journals/context_builder.py`)
- **Journal Injection Tracking** — New `injection_count` and `last_injected_at` columns track how often each journal entry is actually used in prompts. Fire-and-forget background update via `safe_fire_and_forget` to avoid response latency. (`apps/api/src/domains/journals/repository.py`, `apps/api/src/domains/journals/context_builder.py`)
- **Journal Planner Injection** — Journal context is now injected into the planner prompt (in addition to the response prompt), using `intelligence.original_query` as the semantic search query. Separate debug tracking via `journal_planner_injection_debug` state key. (`apps/api/src/domains/agents/nodes/planner_node_v3.py`)
- **Debug Panel Enhancements** — Journal debug section split into Response + Planner sub-sections with `InjectionSubSection` reusable component. Recent entries show "RECENT" badge instead of score bar. Tooltips on injection and extraction entries show full title + content on hover. Background extraction section shows action details. Semantic search scores logged at `info` level for threshold calibration. (`apps/web/src/components/debug/components/sections/JournalInjectionSection.tsx`)
- **Memory Emotional Safety Directive** — Dynamic behavioral directive in psychological profile: `DANGER_DIRECTIVE` activates when any memory has `emotional_weight ≤ -5`, with 4 absolute prohibitions (no jokes, no dismissal, no minimization, no comparison on TRAUMA/DOULEUR topics). Sensitivity-category memories now format `usage_nuance` as imperative obligation (`⚠ OBLIGATION:`) instead of informational italic. Response prompt reinforced with CRITICAL compliance instruction. (`apps/api/src/domains/agents/middleware/memory_injection.py`, `apps/api/src/domains/agents/prompts/v1/response_system_prompt_base.txt`)
- **Embedding Models in LLM Pricing** — OpenAI embedding models (`text-embedding-3-small`, `text-embedding-3-large`, `text-embedding-ada-002`) added to the LLM model administration table for cost tracking. (`infrastructure/database/seeds/`)

### Fixed

- **LLM Cost Tracking Using Wrong Model Name** — 5 background services (journal extraction, journal consolidation, memory extraction, interest extraction, interest content reflection) were tracking token costs against `LLM_DEFAULTS[type].model` (hardcoded code default) instead of the actual model configured in the admin UI. When admins changed models via the application, costs were still calculated with the old default prices. Fixed by replacing `LLM_DEFAULTS[type].model` with `get_llm_config_for_agent(settings, type).model` which resolves the effective config (code defaults → DB admin overrides). (`apps/api/src/domains/journals/extraction_service.py`, `apps/api/src/domains/journals/consolidation_service.py`, `apps/api/src/domains/agents/services/memory_extractor.py`, `apps/api/src/domains/interests/services/extraction_service.py`, `apps/api/src/domains/interests/services/content_sources/llm_reflection_source.py`)
- **Hardcoded Runtime Values Ignoring Settings** — Multiple runtime constants used directly instead of their corresponding `settings.*` fields, bypassing `.env` and application configuration. Fixed: `API_MAX_ITEMS_PER_REQUEST` in HITL dispatch and task orchestrator nodes, `JOURNAL_ENTRY_CONTENT_MAX_LENGTH` in extraction/consolidation service calls, semantic fallback threshold, context reference confidence, HITL demotion confidence, semantic validation fallback confidence, retry middleware parameters, default item confidence, email truncation ratio. (`apps/api/src/domains/agents/nodes/hitl_dispatch_node.py`, `apps/api/src/domains/agents/nodes/task_orchestrator_node.py`, and 7 other files)
- **Constants Misaligned with Production Config** — 25+ constant default values in `constants.py` diverged from actual `.env.prod` production values (e.g., `SEMANTIC_FALLBACK_THRESHOLD` was 0.4 in code but 0.75 in prod, `JOURNAL_CONTEXT_MIN_SCORE` was 0.3 but 0.55 in prod). All constants realigned with production values. `.env.example` also realigned with `.env.prod` for all application configuration values.
- **395+ Hardcoded Config Defaults** — All `Field(default=X)` in 9 config files (agents, connectors, journals, database, advanced, llm, observability, voice, mcp) replaced with named constants from `constants.py`, ensuring the fallback chain APPLICATION > .ENV > CONSTANT is respected even with a minimal `.env` file.
- **LLM_DEFAULTS Misaligned with App Config** — `browser_agent` default was `openai/gpt-4.1-mini` but app uses `anthropic/claude-opus-4-6`. `hitl_question_generator` was `openai/gpt-4.1-mini` but app uses `anthropic/claude-sonnet-4-6`. `journal_extraction/consolidation` was `openai/gpt-5-mini` but app uses `qwen/qwen3.5-plus`. All aligned with actual application configuration. (`apps/api/src/domains/llm_config/constants.py`)
- **Journal Max Entry Size Not Respected** — User-configurable "Max entry size" setting in Personal Journals was ignored by the LLM — the extraction and consolidation prompts used a hardcoded constant (2000) instead of the user's configured value. Fixed by reading `user.journal_max_entry_chars` from DB and passing it to prompts as a MANDATORY size constraint, and to `service.create_entry()`/`service.update_entry()` calls. (`apps/api/src/domains/journals/extraction_service.py`, `apps/api/src/domains/journals/consolidation_service.py`, `apps/api/src/infrastructure/scheduler/journal_consolidation.py`)

## [1.9.2] - 2026-03-22

### Fixed

- **Browser agent unavailable in production** — Playwright Chromium binary was missing from the production Docker image (`Dockerfile.prod`). The Python package was installed but `playwright install chromium` was never executed, causing `BrowserPool` initialization to fail silently (`_healthy=False`) and all browser tools to return "Browser pool is not healthy". Added Chromium binary download in the builder stage, `PLAYWRIGHT_BROWSERS_PATH` env var, and Chromium runtime system dependencies (libnss3, libatk, libgbm, etc.) in the final stage. Dev image (`Dockerfile.dev`) was already correct. (`apps/api/Dockerfile.prod`)
- **Broadcast notification spam for new and existing users** — New users who connected for the first time received the entire history of broadcast messages. Additionally, existing users with many unread broadcasts were overwhelmed with notifications. The `GET /broadcasts/unread` endpoint now only considers the 3 most recent _eligible_ broadcasts (non-expired, created after the user's signup date) and returns only the unread ones among those. This uses a two-subquery approach: one to select the N most recent eligible broadcast IDs, another to exclude already-read IDs. New `MAX_UNREAD_BROADCASTS` constant centralizes the limit. (`apps/api/src/domains/notifications/repository.py`, `apps/api/src/domains/notifications/broadcast_service.py`, `apps/api/src/domains/notifications/router.py`, `apps/api/src/core/constants.py`)
- **Confusing logout button** — The user profile section (avatar + name + email + icon) in the navbar was mistaken for a profile link rather than a logout action. Replaced with a clear red icon-only button (`bg-destructive` + `LogOut` icon). Removed unused `proxyGoogleImageUrl` import. (`apps/web/src/app/[lng]/dashboard/layout.tsx`)
- **Assistant leaking admin-only features to regular users** — When asked "which LLM do you use?", the assistant mentioned admin interfaces like "Admin > LLM Configuration" which are inaccessible to regular users. Added a directive to the app identity prompt instructing the assistant to never reference admin panels, admin settings, or backend configuration options. (`apps/api/src/domains/agents/prompts/v1/app_identity_prompt.txt`)
- **Usage limits console error on startup** — `useUsageLimits` hook logged `ERROR: Failed to fetch` when the backend was unreachable (e.g., during startup). Network errors (`TypeError`) are now silently ignored since the polling interval will retry automatically. (`apps/web/src/hooks/useUsageLimits.ts`)

## [1.9.1] - 2026-03-22

### Added

- **User Consumption Export** — Authenticated users can now export their own LLM token usage, Google API usage, and aggregated consumption summary as CSV from Settings → Features → "My Consumption Export". Three export types with date range filters (current month, last month, last 30 days, all time). Security: `user_id` forced server-side via `current_user.id` — no `user_id` parameter exposed on user endpoints, preventing IDOR. 7 introspection-based security unit tests. (`apps/api/src/domains/google_api/user_export_router.py`, `apps/web/src/components/settings/ConsumptionExportSection.tsx`)
- **Shared Export Service** — Extracted admin export query logic into reusable service functions (`export_token_usage_csv`, `export_google_api_usage_csv`, `export_consumption_summary_csv`) with shared date parsing helper. Both admin and user endpoints delegate to the same service, eliminating code duplication. (`apps/api/src/domains/google_api/export_service.py`)
- **Dual-Mode Export Component** — Unified `ConsumptionExportSection` React component with `mode` prop (`'admin'` | `'user'`). Admin mode shows user filter with autocomplete; user mode shows date filters only and calls user-scoped API endpoints. Admin wrapper (`AdminConsumptionExportSection`) reduced to a thin passthrough. Unique HTML IDs per mode prevent DOM conflicts when both instances coexist for superusers. (`apps/web/src/components/settings/ConsumptionExportSection.tsx`, `apps/web/src/components/settings/AdminConsumptionExportSection.tsx`)
- **Export Unit Tests** — 26 unit tests: `_parse_date_range` validation, CSV output for token/Google API/summary exports, empty data handling, consumption aggregation with partial data, and 9 router security tests (no `user_id` parameter exposed, auth dependency present, correct prefix, allowed params whitelist). (`apps/api/tests/unit/domains/google_api/`)
- **User Export Internationalization (6 languages)** — 18 translation keys per language under `settings.user.export.*` namespace (en, fr, de, es, it, zh) for section title, description, date presets, export card labels, and status messages. (`apps/web/locales/`)

### Fixed

- **Admin export code duplication** — Admin export endpoints (`/admin/google-api/export/*`) refactored to delegate to shared `export_service` functions instead of inlining SQLAlchemy queries. No behavioral change. (`apps/api/src/domains/google_api/router.py`)

## [1.9.0] - 2026-03-22

### Added

- **Per-User Usage Limits** — New domain `src/domains/usage_limits/` enabling administrators to define per-user quotas on tokens, messages, and cost (EUR). Supports both period-based (monthly rolling cycle aligned with account creation) and global/absolute limits. Each dimension can be set to a numeric value or unlimited (null). Includes admin manual block/unblock with reason tracking. (`apps/api/src/domains/usage_limits/`)
- **5-Layer Defense in Depth Enforcement** — Multi-layer enforcement architecture preventing any bypass: Layer 0 (HTTP 429 in chat router before SSE stream), Layer 1 (SSE error in agent service for scheduled actions), Layer 2 (centralized LLM invocation guard in `invoke_with_instrumentation()` covering all background services), Layer 3 (proactive runner skip for blocked users), Layer 4 (migration of direct `.ainvoke()` calls). Fail-open design: infrastructure failures don't block users. (`apps/api/src/domains/agents/api/router.py`, `apps/api/src/domains/agents/api/service.py`, `apps/api/src/infrastructure/llm/invoke_helpers.py`, `apps/api/src/infrastructure/proactive/runner.py`)
- **Admin Usage Limits Dashboard** — Dedicated admin section with searchable, paginated table showing all users with period and global usage gauges (tokens, messages, cost). Inline block toggle with optimistic updates, edit modal with current consumption display per limit dimension. WebSocket endpoint for real-time gauge updates with ticket-based BFF authentication. (`apps/web/src/components/settings/AdminUsageLimitsSection.tsx`, `apps/web/src/components/settings/AdminUsageLimitsEditModal.tsx`, `apps/api/src/domains/usage_limits/websocket.py`)
- **User Usage Limits Dashboard Tiles** — Two dashboard cards (Period Limits / Global Limits) showing color-coded progress gauges when limits are configured. Automatically hidden when all limits are unlimited. (`apps/web/src/components/usage/UsageLimitsTile.tsx`, `apps/web/src/components/usage/UsageGauge.tsx`)
- **Chat Blocking on Limit Exceeded** — Disabled message input, voice input, and destructive alert banner when user is blocked (limit reached or manual block). HTTP 429 handling in chat stream client. SSE error handler for `usage_limit_exceeded` error code with specific toast notification. (`apps/web/src/app/[lng]/dashboard/chat/page.tsx`, `apps/web/src/lib/api/chat.ts`, `apps/web/src/lib/sse-handlers/handlers.ts`)
- **Usage Limits Redis Caching** — 60-second TTL Redis cache on limit check results using existing `cache_get_json`/`cache_set_json` helpers. Cache invalidated after token persistence and admin updates. Stale cycle detection prevents false blocking after billing cycle rollover. (`apps/api/src/domains/usage_limits/service.py`)
- **Usage Limits Configuration** — New `UsageLimitsSettings` config module with feature flag (`USAGE_LIMITS_ENABLED`), default limits for new users via env vars, and configurable cache TTL. Empty string env var handling via `BeforeValidator` for Pydantic-settings compatibility. (`apps/api/src/core/config/usage_limits.py`)
- **Usage Limits Prometheus Metrics** — Two counters: `usage_limit_check_total` (by result status) and `usage_limit_enforcement_total` (by enforcement layer and limit type). (`apps/api/src/infrastructure/observability/metrics_usage_limits.py`)
- **Usage Limits Unit Tests** — 42 unit tests covering `_compute_status` pure logic (manual block, cycle/absolute limits, warning/critical thresholds, zero limits, mixed configurations, stale cycle detection), schema validation (constraints, serialization, enum roundtrip), and `_build_limit_detail` helper. (`apps/api/tests/unit/domains/usage_limits/`)
- **Usage Limits Documentation** — ADR-060 (architectural decision record) and technical documentation covering domain structure, enforcement layers, caching, API endpoints, configuration, and frontend integration. (`docs/architecture/ADR-060-Usage-Limits.md`, `docs/technical/USAGE_LIMITS.md`)
- **Internationalization (6 languages)** — Complete `usage_limits` namespace with translations for all UI elements (admin section, edit modal, dashboard tiles, blocked banner, error messages) in French, English, German, Spanish, Italian, and Chinese. (`apps/web/locales/`)

### Fixed

- **Settings focus loss on preference change** — `refreshUser()` in AuthProvider now compares `JSON.stringify(prev)` vs response before calling `setUser()`, preventing unnecessary re-renders when user data hasn't changed. Context value memoized via `useMemo`. Eliminates focus loss in input fields across all settings tabs (Preferences, Features, Administration). (`apps/web/src/lib/auth.tsx`)
- **Token/cost values mismatch with dashboard** — Usage limits token calculation now includes cached tokens (`cycle_prompt + cycle_completion + cycle_cached`) and cost calculation includes Google API costs (`cycle_cost_eur + cycle_google_api_cost_eur`) to match the dashboard display. (`apps/api/src/domains/usage_limits/repository.py`)
- **Philips Hue connector 500 error** — Fixed `connector_global_config` table storing `'philips_hue'` (lowercase enum value) instead of `'PHILIPS_HUE'` (uppercase enum name) expected by SQLAlchemy `Enum(native_enum=False)`. Data corrected in DB.
- **SQLAlchemy mapper initialization failure** — Added `import_all_models()` call in `main.py` lifespan to ensure all domain models are loaded before the first ORM query. Prevents `UserUsageLimit` forward reference resolution failure. (`apps/api/src/main.py`)
- **Admin settings section ordering** — Reorganized administration tab sections in logical order: Users → Limits → Export → Broadcast → Connectors → LLM → Google API → LLM Config → Personalities → Skills → RAG → Voice → Debug. Renamed section titles for consistency. (`apps/web/src/app/[lng]/dashboard/settings/page.tsx`)

## [1.8.2] - 2026-03-21

### Added

- **Scheduler Leader Election Resilience** — Centralized `SchedulerLeaderElector` class replaces inline leader election logic in `main.py`. Non-blocking background re-election ensures the scheduler always starts, even when a stale Redis lock exists from a killed container (Docker restart/SIGKILL). Includes automatic lock renewal, idempotent shutdown, and comprehensive structured logging (15 event types with `worker_id` correlation). (`apps/api/src/infrastructure/scheduler/leader_elector.py`)
- **Leader Elector unit tests** — 17-test suite covering immediate acquisition, no-Redis fallback, re-election after stale lock, scheduler error rollback with lock release, callback error resilience, double-start guard, and idempotent shutdown. 90% code coverage. (`apps/api/tests/unit/infrastructure/scheduler/test_leader_elector.py`)
- **Leader election debugging guide** — New "Leader election stale lock" section in the debugging guide with Redis diagnostic commands and resolution steps. (`docs/guides/GUIDE_DEBUGGING.md`)
- **SETNX lock variants documentation** — Comparison table of the three Redis SETNX lock patterns (`OAuthLock`, `SchedulerLock`, `SchedulerLeaderElector`) in the Redis architecture ADR. (`docs/architecture/ADR-029-Redis-Multi-Purpose-Architecture.md`)

### Fixed

- **Scheduler not starting after container restart** — When Docker recreated the API container, the stale `scheduler:leader` Redis lock (TTL 120s) from the killed worker prevented the new worker from acquiring leadership. The worker gave up permanently after a single failed SETNX, leaving all 15+ background jobs (journal consolidation, interest notifications, token refresh, etc.) idle. The new `SchedulerLeaderElector` retries every 5s in the background until the lock expires, then starts the scheduler. (`apps/api/src/main.py`, `apps/api/src/infrastructure/scheduler/leader_elector.py`)

## [1.8.1] - 2026-03-21

### Added

- **Journal Extraction Debug Panel** — Background journal extraction results (create/update/delete actions) now visible in the Debug Panel. New `debug_metrics_update` SSE event type emits extraction details after `await_run_id_tasks` completes. Frontend merges supplementary metrics into current debug state via `DEBUG_METRICS_UPDATE` reducer action. Extraction sub-section shows action type badges (CREATE/UPDATE/DELETE), theme, title, mood per action. (`apps/api/src/domains/agents/api/service.py`, `apps/web/src/components/debug/components/sections/JournalInjectionSection.tsx`)
- **Planner v3 Skill Guard** — Early insufficient content detection now skips when a deterministic skill has high domain overlap with the query. Prevents false-positive clarification requests on multi-domain skills (e.g., daily briefing = event+task+weather+email). New `_has_potential_skill_match()` helper with configurable `SKILLS_EARLY_DETECTION_MAX_MISSING_DOMAINS` constant. (`apps/api/src/domains/agents/nodes/planner_node_v3.py`, `apps/api/src/core/constants.py`)
- **Journal Extraction Debug Registry** — In-process `_extraction_debug_results` dict with TTL-based eviction (5 min) stores extraction results per `run_id` for consumption by the SSE streaming service. (`apps/api/src/domains/journals/extraction_service.py`)
- **Planner Skill Guard unit tests** — 284-line test suite covering skill match detection, domain overlap, missing domain threshold, disabled skills, and edge cases. (`apps/api/tests/unit/domains/agents/nodes/test_planner_v3_skill_guard.py`)
- **Smart Home connector category** — `smart_home` category added to frontend connector constants and Admin Connectors section with Philips Hue entry. (`apps/web/src/constants/connectors.ts`, `apps/web/src/components/settings/AdminConnectorsSection.tsx`)
- **Smart Home i18n descriptions** — Connector description for `philips_hue` and `smart_home` category label/description added across 6 languages. (`apps/web/locales/*/translation.json`)

### Changed

- **Weather card temp range** — Current weather cards now display min/max temperature range (not shown for forecast cards which already have it in main stats). (`apps/api/src/domains/agents/display/components/weather_card.py`)
- **Journal entry ID formatting** — Entry headers in extraction and consolidation prompts now use `[id=UUID | ...]` format with a dedicated ID reference table for easy LLM copy-paste. Reduces UUID hallucination in update/delete actions. (`apps/api/src/domains/journals/extraction_service.py`, `apps/api/src/domains/journals/consolidation_service.py`)
- **Journal prompts UUID guidance** — Introspection and consolidation prompts now include CRITICAL instruction to copy-paste exact UUIDs from entry headers, with placeholder `<copy exact UUID from entry header>` in JSON examples. (`apps/api/src/domains/agents/prompts/v1/journal_introspection_prompt.txt`, `apps/api/src/domains/agents/prompts/v1/journal_consolidation_prompt.txt`)

### Fixed

- **Journal hallucinated UUID rejection** — `ExtractedJournalEntry.entry_id` now validates UUID format via `field_validator`, rejecting malformed IDs from LLM hallucination. Both extraction and consolidation services filter out actions referencing unknown entry IDs before applying them. (`apps/api/src/domains/journals/schemas.py`, `apps/api/src/domains/journals/extraction_service.py`, `apps/api/src/domains/journals/consolidation_service.py`)

## [1.8.0] - 2026-03-21

### Added

- **Philips Hue Smart Home Connector** — Full integration with Philips Hue Bridge CLIP v2 API for smart lighting control via natural language. Dual connection mode: local (press-link pairing on same network) and remote (OAuth2 via api.meethue.com cloud relay). 6 LangChain tools: `list_hue_lights_tool`, `control_hue_light_tool`, `list_hue_rooms_tool`, `control_hue_room_tool`, `list_hue_scenes_tool`, `activate_hue_scene_tool`. Multilingual color support (CIE xy mapping for en/fr/de/es), fuzzy name resolution for natural language control ("éteins le salon" → room "Salon" → grouped_light off). (`src/domains/connectors/clients/philips_hue_client.py`, `src/domains/agents/tools/hue_tools.py`)
- **Hue Bridge discovery & press-link pairing UI** — Multi-step wizard in Settings > Smart Home: bridge discovery via discovery.meethue.com, bridge selection, 30-second countdown press-link pairing flow, automatic connector activation. Separate remote mode path via OAuth2 redirect. (`apps/web/src/components/settings/connectors/HueBridgePairingForm.tsx`, `apps/web/src/components/settings/connectors/hooks/useHueConnect.ts`)
- **Hue agent with catalogue manifests** — Dedicated `hue_agent` with versioned prompt (`hue_agent_prompt.txt`), 6 tool manifests with multilingual semantic keywords (en/fr/de/es/it/zh) for Smart Planner tool selection. Agent registered in LangGraph graph with conditional routing edge. (`src/domains/agents/hue/catalogue_manifests.py`, `src/domains/agents/graphs/hue_agent_builder.py`)
- **HueOAuthProvider** — OAuth2 provider dataclass implementing `OAuthProvider` Protocol for Hue Remote API. Factory method `for_remote_control()` with dynamic redirect URI construction. PKCE support via existing `OAuthFlowHandler`. (`src/core/oauth/providers/hue.py`)
- **Smart Home domain taxonomy** — New "hue" domain in `domain_taxonomy.py` with `result_key="hues"`, enabling Smart Planner to route smart home intents. New `RegistryItemType.HUE_LIGHT` for Data Registry frontend rendering. (`src/domains/agents/registry/domain_taxonomy.py`, `src/domains/agents/data_registry/models.py`)
- **Smart Home i18n (6 languages)** — 22 translation keys per language for Hue connector UI: pairing wizard, mode selection, countdown, error messages, connection status. Covers en, fr, de, es, it, zh. (`apps/web/locales/*/translation.json`)

### Changed

- **ConnectorTool credential retrieval** — Added `is_hue` branch in `ConnectorTool.execute()` for Hue-specific credential retrieval via `get_hue_credentials()`, following the existing `is_apple` pattern. (`src/domains/agents/tools/base.py`)
- **Client registry** — `PhilipsHueClient` registered in `ClientRegistry._ensure_initialized()` alongside Google, Apple, and Microsoft clients. (`src/domains/connectors/clients/registry.py`)
- **Connector models** — New `ConnectorType.PHILIPS_HUE` enum value with `is_hue` property, `_HUE_CONNECTOR_TYPES` frozenset, `"smart_home"` functional category. (`src/domains/connectors/models.py`)
- **UserConnectorsSection** — Added "Connected Smart Home" and "Available Smart Home" sections with `HueBridgePairingForm` integration. (`apps/web/src/components/settings/UserConnectorsSection.tsx`)

### Fixed

- **LLM provider error messages** — `OverloadedError` (529) and `RateLimitError` (429) from Anthropic/OpenAI now display a user-friendly message ("Le service d'IA est temporairement surchargé. Veuillez réessayer dans quelques instants.") instead of raw technical error types (`APIStatusError`). Detection covers `stream_error()` and `generic_error()` in all 6 languages. (`src/domains/agents/api/error_messages.py`)

## [1.7.2] - 2026-03-20

### Added

- **Technical Blog (20 articles × 6 languages = 120 pages)** — Full blog system with category-organized technical articles covering architecture, integrations, features, security, and engineering. Each article enriched with verified code-sourced facts (file paths, exact numbers, real class/function names). 5 categories: Architecture (4), Integrations (4), Features (6), Security (2), Technical (4). Articles include real Python code snippets from the codebase (Prometheus metrics, `load_prompt()`, `ToolResponse`, `get_llm()` factory). (`apps/web/src/app/[lng]/blog/`, `apps/web/src/components/blog/`, `apps/web/src/data/blog-articles.ts`)
- **Blog illustrations** — 20 unique PNG illustrations (one per article) served via Next.js `<Image>` with lazy loading, responsive `sizes`, and `priority` on article hero. (`apps/web/public/articles/`)
- **Blog preview on landing page** — `BlogPreviewSection` component showing 6 featured articles with illustrations, inserted before the CTA section. Promotes blog discovery for visitors exploring LIA. (`apps/web/src/components/landing/BlogPreviewSection.tsx`)
- **Tailwind Typography plugin** — Installed `@tailwindcss/typography` for proper `prose` class rendering in blog article bodies. Configured via `@plugin` directive in globals.css.
- **Tempo distributed tracing (production)** — Deployed Grafana Tempo on RPi5 prod, completing the observability trifecta (metrics + logs + traces). Service `lia-tempo-prod` with 0.5 CPU / 512 MB limits, 7-day retention with automatic compaction, zstd/snappy compression. Enables Dashboard 06 (Logs & Traces), trace↔log↔metric correlation via exemplars, and Tempo service graph in Grafana. (`docker-compose.prod.yml`, `infrastructure/observability/tempo/tempo.yml`)
- **Scheduler leader election** — Redis SETNX-based leader election ensures only 1 of 4 uvicorn workers starts APScheduler. Eliminates duplicate job execution caused by `--workers 4`. Lock renewed every 30s (TTL 120s) with automatic failover if leader crashes. Non-leader workers skip scheduler entirely. (`src/main.py`, `src/core/constants.py`)

### Changed

- **SEO & GEO (Generative Engine Optimization)** — Enhanced metadata for Google and AI search engines:
  - OpenGraph images per article (PNG illustrations) with `summary_large_image` Twitter cards
  - `image` and `articleSection` fields added to JSON-LD `BlogPosting` schema
  - `authors` metadata on article pages
  - OpenGraph image on blog listing page
  - Sitemap XML extended with 21 blog URLs (listing + 20 articles) with hreflang alternates
  - `robots.txt` updated: blog paths allowed for all crawlers, AI search bots (OAI-SearchBot, PerplexityBot, Claude-SearchBot) explicitly permitted
  - `llms.txt` updated with blog link and corrected statistics
- **Landing page meta descriptions** — SEO-optimized with keywords "Open Source", "Multi-Agent", "HITL", "6 Languages", "7 LLM providers", "Privacy by design" in all 6 languages.
- **Landing stats correction** — Agent count corrected from 18 to 15 (verified: 15 domain agent builders in `src/domains/agents/graphs/`). Prometheus metrics count corrected from 500 to 350 (verified: 357 metric definitions across 17 observability files).
- **Blog navigation** — `nav.blog` link integrated into `NAV_SECTIONS` array with same styling as other nav items (was isolated in "Right actions" zone with different markup). Supports both anchor links (`#section`) and route links (`/blog`) in the same nav. (`LandingHeader.tsx`)
- **Landing navigation order** — Reordered to: Comment ça marche → Fonctionnalités → Sécurité → Technologie → Blog (was: Fonctionnalités → Comment ça marche → ..., Blog separated).
- **Prometheus remote-write receiver (production)** — Added `--web.enable-remote-write-receiver` flag to prod Prometheus, enabling Tempo's metrics-generator to push span metrics (service graphs, span latency histograms). (`docker-compose.prod.yml`)
- **Grafana prod parity with dev** — Added `grafana.ini` volume mount (Tempo feature flags: `tempoSearch`, `tempoServiceGraph`, `traceqlEditor`) and `depends_on: [prometheus, loki, tempo]`. (`docker-compose.prod.yml`)

### Fixed

- **Factual accuracy audit (8 corrections × 6 languages = 48 fixes)** — Systematic verification of all blog article claims against actual source code:
  - Agent count: 18+ → 15 (verified via `find graphs/ -name "*_builder.py"`)
  - LLM configuration: "environment variables" → "Administration > LLM Configuration" (admin UI is primary, env vars are fallback)
  - Claude model name: `claude-3.5-sonnet` → `claude-sonnet-4-5`
  - RAG embedding model: `E5-small (384 dims)` → `text-embedding-3-small (1536 dims)` (verified in `constants.py`)
  - Wake word: "Hey LIA" → "OK Guy" (verified in `sherpaKws.ts`)
  - Prometheus metrics: 500+ → 350+ (verified: 357 definitions)
  - Prompt count: 45+ → 55 (verified: `find prompts -name "*.txt"`)
  - Token reduction: 93% → 96% (verified in `NormalFilteringStrategy` docstring)
- **Consistent agent count across all surfaces** — Updated FAQ, meta descriptions, `llms.txt`, landing stats, `WebSiteJsonLd`, and all blog references from "18+" to "15" across all 6 languages.
- **Scheduler ×4 duplicate execution** — All 4 uvicorn workers were running independent APScheduler instances, causing every job to execute 4× per interval. Root cause: `--workers 4` in `Dockerfile.prod` with no leader coordination. Fixed with Redis leader election (root cause) + `SchedulerLock` on 5 previously unprotected jobs as safety net: `token_refresh`, `currency_sync`, `memory_cleanup`, `interest_cleanup`, `unverified_account_cleanup`. (`src/main.py`, `src/infrastructure/scheduler/*.py`, `src/core/constants.py`)
- **Tempo OTLP export failures (4 months of silent errors)** — API spammed `Failed to export traces to tempo:4317, StatusCode.UNAVAILABLE` continuously since Tempo was never deployed in prod. Two sub-bugs: (1) Tempo service absent from `docker-compose.prod.yml` despite full config existing, (2) `OTLPSpanExporter(insecure=not settings.is_production)` forced TLS for Docker-internal gRPC — changed to `insecure=True`. (`tracing.py`, `docker-compose.prod.yml`)
- **Background task timeout (memory/interest/journal extraction)** — Post-response LLM extraction tasks (memory, interests, journals) were silently abandoned after 5s timeout. On RPi5 with network latency, LLM calls routinely exceed 5s. Increased `await_run_id_tasks` timeout from 5s to 15s. (`src/infrastructure/async_utils.py`, `src/domains/agents/api/service.py`)
- **Weather hourly forecast `save_details_missing_primary_id`** — Context registry for weather uses `primary_id_field="date"`, but hourly forecast payload lacked a `date` field (only daily/current had it). Added `date` field to hourly forecast registry item. (`weather_tools.py`)
- **Qwen `extra_body` LangChain warning** — `extra_body` (for Qwen thinking mode) was nested inside `model_kwargs` dict, triggering LangChain `UserWarning: Parameters {'extra_body'} should be specified explicitly`. Moved to direct kwarg of `init_chat_model`. (`adapter.py`)

## [1.7.1] - 2026-03-20

### Fixed

- **Constants centralization audit (25 files)** — Systematic elimination of ~60 hardcoded default values across backend and frontend. All configurable defaults now reference centralized constants from `src/core/constants.py` instead of inline literals. Prevents silent divergence between code paths that should share the same default value.
- **Journal settings persistence bug** — Numeric settings (prompt injection budget, max entry size, max search results) appeared to save successfully but reverted on page refresh. Root cause: React `useState` initializers ran once with stale `initialData` and were never synchronized with actual server values. Fix: added `useEffect` sync + removed hardcoded `initialData` from `useJournals`, `useHeartbeatSettings`, and `useInterests` hooks. The API is now the single source of truth for all settings.
- **`journals_enabled` inconsistent defaults** — Three code paths used different fallback values for the same field: `router.py` defaulted to `True`, while `context_builder.py` and `context_aggregator.py` defaulted to `False`. This caused journals to appear enabled in the UI while being silently excluded from heartbeat context and prompt injection. Unified to `JOURNALS_ENABLED_DEFAULT = True`.
- **Proactive notification language bug** — `proactive/runner.py` and `proactive/notification.py` used `"en"` as the language fallback, while all other code paths used `"fr"`. Users without an explicit language preference received notification titles in English instead of French. All sites now use `DEFAULT_LANGUAGE` constant.
- **Interest eligibility checker wrong defaults** — `EligibilityChecker` used heartbeat defaults (min=1, max=3) for interest notifications instead of interest-specific defaults (min=2, max=5). Interests were under-notified (capped at 3/day instead of 5). Refactored constructor to accept `default_min_per_day` / `default_max_per_day` parameters, passed from each scheduler with the correct constants.
- **Frontend optimistic update without revert** — `useInterests.ts` `updateSettings` applied optimistic state changes but never reverted on mutation failure. Added `refetchSettings()` on error to restore server state.

### Changed

- **12 new constants in `constants.py`** — `HEARTBEAT_MIN_PER_DAY_DEFAULT`, `HEARTBEAT_PUSH_ENABLED_DEFAULT`, `HEARTBEAT_NOTIFY_START/END_HOUR_DEFAULT`, `INTEREST_NOTIFY_MIN/MAX_PER_DAY_DEFAULT`, `HEARTBEAT_DECISION/MESSAGE_LLM_MODEL_DEFAULT`, `TOKEN_SUMMARY_CACHE_TTL`, `JOURNALS_ENABLED_DEFAULT`, `JOURNAL_CONSOLIDATION_ENABLED/WITH_HISTORY_DEFAULT`.
- **User model `server_default` alignment** — All 15 user preference columns in `auth/models.py` (timezone, language, interests×4, heartbeat×5, journals×4) now reference constants instead of string literals.
- **`EligibilityChecker` parameterization** — Added `default_start_hour`, `default_end_hour`, `default_min_per_day`, `default_max_per_day` constructor parameters to support task-specific fallback values.

### Security

- **CVE-2026-33228 — `flatted` Prototype Pollution (HIGH)** — Transitive dev dependency `flatted <= 3.4.1` (via eslint → flat-cache) vulnerable to prototype pollution via `parse()`. Fixed via `pnpm.overrides` forcing `flatted >= 3.4.2`. Dev-only dependency — no production runtime impact.
- **GitHub Actions bumped** — codecov/codecov-action 5.5.2→5.5.3, softprops/action-gh-release 2.3.2→2.3.3, github/codeql-action 3.28.16→3.28.17 (PR #63).

## [1.7.0] - 2026-03-20

### Added

- **Personal Journals — Carnets de Bord (evolution)** — The AI assistant now maintains thematic personal journals (self-reflection, user observations, ideas & analyses, learnings) written in first person, colored by its active personality. Dual trigger system: post-conversation extraction (fire-and-forget background task analyzing last user message + context) and periodic consolidation (APScheduler every 4h, reviews and reorganizes notes). Semantic context injection into both response AND planner prompts via E5-small cosine similarity search with configurable minimum score prefiltering (`JOURNAL_CONTEXT_MIN_SCORE`) — two distinct queries (response: tone/formulation, planner: reasoning/learnings). Prompt-driven autonomous lifecycle management: the assistant decides what to keep, summarize, merge, or delete based on a configurable size constraint. Full user control: enable/disable without data loss, configurable consolidation, optional conversation history analysis (with cost warning), 4 numeric settings (max total chars, context budget, max entry chars, max search results). CRUD operations in Settings > Features with theme-based accordion, size gauge, and real cost tracking. GDPR compliant: JSON/CSV export + bulk delete. LLM models configurable in Admin > LLM Configuration (category: background). Heartbeat integration: journals as a context source for proactive notifications with dynamic query (second pass after context aggregation), toggleable badge in heartbeat settings. Debug panel: dedicated "Personal Journals" section showing injection metrics (entries found/injected, scores, budget, per-entry details). (`src/domains/journals/`, `journal_introspection_prompt.txt`, `journal_consolidation_prompt.txt`, `JournalInjectionSection.tsx`, `ADR-057-Personal-Journals.md`, 35 unit tests)

### Database

- **Migration `journals_001`** — Created `journal_entries` table (UUID PK, user_id FK CASCADE, theme, title, content, mood, status, source, session_id, personality_code, char_count, embedding ARRAY(Float), timestamps). Added 11 columns to `users` table: journals_enabled, journal_consolidation_enabled, journal_consolidation_with_history, journal_max_total_chars, journal_context_max_chars, journal_last_consolidated_at, journal_last_cost_tokens_in/out/eur/at/source. Composite indexes on (user_id, status, created_at) and (user_id, theme).
- **Migration `journals_002`** — Added 2 user-configurable columns: journal_max_entry_chars (Integer, default 2000), journal_context_max_results (Integer, default 10). Idempotent upgrade (skips if columns already exist).

## [1.6.1] - 2026-03-19

### Added

- **System RAG Spaces — App Self-Knowledge (evolution)** — LIA can now answer questions about itself, its features, and usage directly in conversation. Built-in FAQ knowledge base (119+ Q/A across 17 sections) indexed from English Markdown files (`docs/knowledge/`), with LLM translation at response time (6 languages). Includes: `SystemSpaceIndexer` with SHA-256 hash-based staleness detection, `is_app_help_query` detection in QueryAnalyzer, RoutingDecider Rule 0 override (prevents misrouting "how do I connect my calendar?" to the planner), App Identity Prompt (~200 tokens) injected conditionally (lazy loading — zero overhead on normal queries), 3 admin API endpoints (list/reindex/staleness), admin UI section with staleness badge and reindex button, automatic indexation at app startup (idempotent — skips if hash matches), 3 Prometheus metrics, seed script (`task db:seed:system-rag`). (`system_indexer.py`, `app_identity_prompt.txt`, `ADR-058`, 35 unit tests)

### Database

- **Migration `system_rag_spaces_001`** — `rag_spaces`: added `is_system` (Boolean, NOT NULL, default false) and `content_hash` (String(64), nullable). Made `user_id` nullable on `rag_spaces`, `rag_documents`, `rag_chunks` (system spaces have no owner). Replaced unique index `uq_rag_spaces_user_id_name` with partial unique indexes: `uq_rag_spaces_user_name` (WHERE user_id IS NOT NULL) and `uq_rag_spaces_system_name` (WHERE is_system = true). Added index `ix_rag_spaces_is_system`.

## [1.6.0] - 2026-03-19

### Added

- **Browser Control (evolution F7)** — Interactive web browsing via Playwright headless Chromium. Autonomous ReAct agent (`browser_task_tool`) navigates websites, searches content, clicks elements, fills forms, and extracts data from JavaScript-rendered pages. Multi-step interaction handled internally — planner sends a natural language task, agent executes autonomously. Includes: session pool with cross-worker Redis recovery, SSRF prevention (reuses web_fetch URL validator), accessibility tree extraction via CDP, generic cookie banner auto-dismiss (20+ multi-language selectors), anti-detection (Chrome UA, webdriver flag removed, dynamic locale/timezone from user preferences), page crash recovery, Prometheus metrics (6 gauges/counters/histograms). Activation via admin connector panel. (`infrastructure/browser/`, `browser_tools.py`, `browser_agent_builder.py`, `browser_agent_prompt.txt`, 36 unit tests)
- **Qwen provider support** — Added Qwen (Alibaba Cloud) as a native LLM provider via DashScope international OpenAI-compatible API. 3 models: qwen3-max (thinking-only), qwen3.5-plus (tools + vision + thinking), qwen3.5-flash (cost-effective). Includes thinking mode mapping (reasoning_effort → enable_thinking + thinking_budget), implicit cache, streaming metrics, model profiles with pricing. (`adapter.py`, `model_profiles.py`, `llm_pricing_seed.sql`, `AdminLLMConfigSection.tsx`)
- **Ollama dynamic model discovery** — Admin LLM config now dynamically lists models installed on the Ollama server with real capabilities. Two-phase discovery: `GET /api/tags` + `POST /api/show` per model (parallel). Dropdown auto-populates when selecting Ollama as provider. In-memory cache (60s TTL), 5s HTTP timeout, per-model error isolation. New endpoint: `GET /admin/llm-config/providers/ollama/models`. (`ollama_discovery.py`, `service.py`, `router.py`, `AdminLLMConfigSection.tsx`)
- **ADR-059** — Architecture Decision Record for Browser Control (ReAct agent, CDP accessibility, Redis session coordination, anti-detection).
- **Browser technical documentation** — `BROWSER_CONTROL.md` (architecture, configuration, security, metrics, limitations).
- **Browser security section** — Added "Browser Automation Security" to `SECURITY.md` (sandbox, SSRF, input sanitization, anti-detection trade-offs).

### Changed

- **LLM config metadata** — Filtered out internal `"default"` fallback entries from the model dropdown for all providers (was showing "default" as a selectable model name).
- **LLM serializer** — Added `content_summary` to `CONTENT_FIELDS` for proper serialization of browser page content (prevents 60-char truncation).
- **Type domain mapping** — Added `browsers` to `SKIP_FILTER_RESULT_KEYS` (browser content always relevant, not emptied by intelligent filtering).

## [1.5.2] - 2026-03-18

### Added

- **RAG Spaces — 15 document formats** — Extended RAG document upload from 4 to 15 formats: PDF, TXT, MD, DOCX, PPTX (slides + tables + notes), XLSX (multi-sheet), CSV, RTF, HTML, ODT, ODS, ODP, EPUB (spine-ordered), JSON, XML (defusedxml). Each format has a dedicated text extractor with edge-case handling. (`processing.py`, `constants.py`, `service.py`)
- **RAG Spaces — Google Drive folder sync** — Link Google Drive folders to RAG Spaces for automatic file vectorization. Manual sync with incremental change detection (skip unchanged, re-process modified, auto-delete removed). Supports Google Docs/Sheets/Slides via API export. Per-file error isolation, Semaphore(5) throttling, atomic sync lock, 500-file pagination cap. Feature flag: `RAG_SPACES_DRIVE_SYNC_ENABLED`. (`drive_sync.py`, 6 API endpoints, 5 frontend components)
- **RAG Drive folder browser** — Folder picker dialog showing both folders (navigable) and files (preview) so users can see what will be synced before selecting.
- **Drive sync Prometheus metrics** — 4 new metrics: `rag_drive_sync_runs_total`, `rag_drive_sync_duration_seconds`, `rag_drive_sync_files_total`, `rag_drive_sources_total_count`.
- **ADR-056** — Architecture Decision Record for RAG Drive Sync (manual-first, non-recursive, incremental sync, per-file error isolation).

### Changed

- **RAG upload format display** — Compact "15+ supported formats" label with tooltip listing all formats (was: "PDF, TXT, MD, DOCX").
- **RAG document model** — Added `source_type`, `drive_source_id`, `drive_file_id`, `drive_modified_time` columns for Drive integration.

### Database

- **Migration `drive_sources_001`** — New `rag_drive_sources` table + 4 columns on `rag_documents` with indexes and FK constraints.

## [1.5.1] - 2026-03-17

### Added

- **Skill Generator meta-skill** — Built-in system skill (`skill-generator`) that guides users through creating custom SKILL.md files from natural language descriptions. 4-phase advisory process: need analysis, archetype selection (Prompt Expert / Advisory / Plan Template), generation with format validation, and delivery with import instructions. Includes 3 reference files (format specification, full tool catalogue with 60+ tools and 17 agents, archetype examples) and a sandboxed Python validation script. Multilingual support (body in user's language, description in English). Compliant with the agentskills.io open standard.

### Security

CodeQL security hardening and code quality sweep. Addresses 667 code scanning alerts (35 critical/high security, 33 errors, 47 warnings, 552 notes). Zero functional regression — all 6,279 unit tests pass.

### Security

- **Removed `verify=False` on Static Maps proxy** — TLS certificate validation was disabled on the `httpx` client proxying Google Static Maps requests, exposing the Google API key to potential MITM interception. Now uses default `verify=True`. (`connectors/router.py`)
- **Added `photo_name` input validation on Places photo proxy** — The `{photo_name:path}` route parameter accepted arbitrary path segments, potentially reaching unintended Google API endpoints with the server's API key. Added regex validation (`^places/[^/]+/photos/[^/]+$`) matching Google's official resource name spec. (`connectors/router.py`)
- **Removed stack-trace exposure in SSE error events** — Exception details (`str(e)`) were sent to the client via Server-Sent Events, potentially leaking internal paths, SQL queries, or connection strings. Replaced with generic error message; detailed error preserved in server logs. (`notifications/router.py`)
- **Masked admin password in CLI output** — The `create_admin.py` setup script printed the admin password in clear text to stdout, capturable by Docker logs or CI pipelines. Now displays masked output. (`scripts/data/create_admin.py`)
- **Gated TLS bypass by `NODE_ENV` in RAG upload proxy** — `rejectUnauthorized: false` was applied unconditionally (not just in development). Now only disables TLS validation when `NODE_ENV !== 'production'`. (`apps/web/src/app/api/rag-upload/[spaceId]/route.ts`)
- **Fixed incomplete HTML tag stripping regex** — `</script>`, `</style>`, `</head>` regexes did not match variants with whitespace before `>` (e.g., `</script >`). Added `\s*` to closing tag patterns. (`display/components/base.py`)

### Fixed

- **`ToolValidationError` crash on multi-field validation** — `validate_fields()` passed `fields=missing` (plural) to `ToolValidationError.__init__` which only accepts `field=` (singular), causing a `TypeError` when 2+ required fields were missing. Fixed to `field=", ".join(missing)`. (`tools/validation_helpers.py`)
- **Uninitialized `errors` variable in email/calendar tools** — `errors` was assigned only inside the `mode == "batch"` branch but could theoretically be accessed outside it after refactoring. Added defensive `errors = None` initialization before branching. (`emails_tools.py`, `calendar_tools.py`)
- **`AgentService.__init__` duplicated mixin attributes** — Four attributes were manually duplicated from `GraphManagementMixin.__init__`. Refactored to use `super().__init__()`. Added missing `hitl_orchestrator` initialization to the mixin. (`api/service.py`, `graph_management.py`)
- **Overly broad `except Exception` in approval gate** — Tool manifest fallback catch was `except Exception:` (masking DB/network errors), while `validator.py` used the specific `except ToolManifestNotFound:`. Narrowed to match. (`approval_gate_node.py`)
- **Overly broad `except Exception` in place card** — Opening hours parsing caught all exceptions instead of the expected `(ValueError, IndexError, TypeError)`. (`place_card.py`)

### Changed

- **Added debug logging to 18 silent `except: pass` blocks** — Best-effort patterns (user preferences, cache invalidation, CalDAV close, LLM callbacks, OAuth discovery, session cleanup) now emit `logger.debug()` for production observability without changing error-handling behavior.
- **Extracted `get_user_language_safe()` DRY helper** — Replaced 4 identical try-except-for-language patterns in `places_tools.py` with a single shared helper in `runtime_helpers.py`. Narrows exception scope from `Exception` to `(ValueError, KeyError, RuntimeError, AttributeError)`.
- **Elevated `token_counter_service` fallback level warning** — Unknown fallback levels now emit `logger.warning` (was silent `pass`) to surface configuration drift.

### Removed

- **16 unused constants** from `agents/constants.py` — 7 legacy `NODE_*_AGENT` constants (replaced by agent catalogue), 1 `CONTEXT_DOMAIN_TASK_LISTS`, 8 legacy `HITL_*` keys (replaced by Phase 3.3 orchestrator).
- **10 legacy `_*_direct_tool_instance` variables** — Unused module-level tool instances in `calendar_tools.py`, `drive_tools.py`, `emails_tools.py`, `google_contacts_tools.py`, `tasks_tools.py`. Marked `LEGACY` in code, excluded from tool registry by underscore prefix convention.
- **12 unused global variables** — Dead logger instances (`goal_inferrer.py`, `planner_utils.py`), obsolete constants (`PRIOR_ALPHA/BETA`, `_CURRENCY_USD/EUR`, `_DESTRUCTIVE_LABEL_WITH_CHILDREN`), write-only `_last_update`, unused `TypeVar T`.
- **~25 unused imports** across 18 files — Removed unused `Language`, `Set`, `List`, `Dict`, `Optional`, `Tuple`, `ast`, `re`, `json`, `subprocess`, `os`, `yaml`, `asdict`, `Template`, `UUID`, `get_function_complexity` imports from source, scripts, and infrastructure files.
- **Self-assignment dead code** in `mixins.py` — `ToolOutputMixin = ToolOutputMixin` and `create_tool_formatter = create_tool_formatter` (no-ops, re-exports handled by `__init__.py`).

## [1.5.0] - 2026-03-17

### Added

- **Persistent specialized sub-agents (F6)** — Delegation system allowing the principal assistant to spawn ephemeral expert sub-agents for complex tasks (research, analysis, synthesis). Includes full DDD domain (`src/domains/sub_agents/`), ORM model, repository, service, REST API (10 endpoints), 3 pre-defined templates (Research Assistant, Writing Assistant, Data Analyst). Sub-agents execute through a simplified direct pipeline (query analysis → planner → parallel executor → LLM synthesis), bypassing the full graph's semantic validator, approval gate, and response node. Read-only V1 (all write tools blocked). Feature flag: `SUB_AGENTS_ENABLED`.
- **Sub-agent planner integration** — Transversal `delegate_to_sub_agent_tool` always included in planner catalogue via `NormalFilteringStrategy`. Planner prompt extended with `{sub_agents_section}` guidelines. Multiple delegates execute in parallel (wave-based). Depth limit: sub-agents cannot spawn sub-sub-agents.
- **Sub-agent catalogue manifests** — `AgentManifest` + `ToolManifest` with semantic keywords for natural discovery (`src/domains/agents/sub_agents/catalogue_manifests.py`).
- **Sub-agent token guard-rails** — Per-execution budget (`SUBAGENT_MAX_TOKEN_BUDGET`), daily budget per user (`SUBAGENT_MAX_TOTAL_TOKENS_PER_DAY`), auto-disable after consecutive failures (`SUBAGENT_MAX_CONSECUTIVE_FAILURES`). `TokenTrackingCallback` consolidation into parent tracker.
- **Sub-agent HITL rejection fallback** — When user rejects a plan with delegation steps, system auto-replans without sub-agents. Catalogue exclusion via `exclude_sub_agent_tools` flag.
- **Sub-agent semantic validator exceptions** — `for_each` cardinality check and repeated-tool consolidation exempt `delegate_to_sub_agent_tool` steps (each step delegates to a different expert).
- **Sub-agent user preference** — Per-user `sub_agents_enabled` toggle (Settings > Features > Sub-Agents). `SubAgentsSettings.tsx` component. `PATCH /auth/me/sub-agents-preference` endpoint.
- **Sub-agent stale recovery job** — APScheduler job recovers sub-agents stuck in `executing` state (configurable interval).
- **Sub-agent observability** — Prometheus metrics module (`metrics_subagent.py`). Sub-agent notification type in SSE/FCM.
- **Skills DB refactoring** — Normalized skills persistence from JSONB `disabled_skills` columns to two relational tables: `skills` (registry: name, is_system, owner_id, admin_enabled, description, descriptions) + `user_skill_states` (user_id, skill_id, is_active). Migration includes data migration from legacy columns. `SkillPreferenceService` for sync, toggle, and state queries. `active_skills_ctx` ContextVar replaces `disabled_skills_ctx` (positive set).
- **Skills admin system-toggle** — `PATCH /skills/admin/{name}/system-toggle` endpoint. When admin disables a system skill, `is_active` is set to `false` for all users. New `adminSystemToggleSkill` in `useSkills` hook. Admin view fetches from `/skills/admin/list`.
- **Skills preference repository** — `SkillRepository` and `SkillStateRepository` for normalized DB access, with `ensure_states_for_user()` and `get_active_skill_names()` methods.
- **HITL plan approval question prompt** — Dedicated prompt template (`hitl_plan_approval_question_prompt.txt`) for generating approval gate questions, avoiding ambiguous/contradictory formulations.
- **Subagent synthesis prompt** — Dedicated prompt (`subagent_synthesis_prompt.txt`) for sub-agent result synthesis.
- **Provider cost adjustment documentation** — Investigation of Anthropic billing delta (~11%) with recommended `cost_adjustment_factor` solution (`docs/technical/PROVIDER_COST_ADJUSTMENT.md`).
- **Google Routes client** — `GoogleRoutesClient` for directions/transit route queries (`src/domains/connectors/clients/google_routes_client.py`).
- **Sub-agents i18n** — All 6 languages (en, fr, de, es, it, zh): templates names/descriptions, settings labels, LLM type label.
- **Sub-agents documentation** — `docs/technical/SUB_AGENTS.md`, `docs/INDEX.md` updated, `docs/ARCHITECTURE.md` updated for skills DB model.
- **104 files changed** — 8,029 insertions, 251 deletions across backend, frontend, docs, and configuration.

### Changed

- **Skills context propagation** — Replaced `disabled_skills_ctx` (negative set) with `active_skills_ctx` (positive set) in `AgentService` and skill injection. Only active skills are injected into the assistant prompt.
- **Skills frontend** — `AdminSkillsSection` now uses `admin_enabled` flag and `adminSystemToggleSkill`. `SkillsSettings` user view shows only admin-enabled system skills. `useSkills` hook accepts `adminView` parameter.
- **HITL interrupt handler** — Removed misleading token metadata from `STREAM_DONE` payload (HITL tokens are partial/incomplete).
- **Smart planner prompts** — Extended with sub-agent delegation section, explicit `execution_mode` (sequential/parallel) and `timeout_seconds` per step in plan schema, guidelines for both single-domain and multi-domain planners.
- **Query intelligence** — Added `include_sub_agent_tools` flag to `ToolFilter` (always `true` for planner).
- **Conversation repository** — Updated queries for sub-agent session tracking. Google API costs now included in per-message and aggregate cost totals.
- **LLM factory** — Added `subagent` LLM type with default model configuration.
- **LLM defaults migration** — Router, planner, semantic validator, approval gate switched to Anthropic `claude-sonnet-4-6` (reasoning: low). Compaction switched to `gpt-4.1-mini` (reasoning: medium).

### Fixed

- **Skills system-disable propagation** — Admin-disabled system skills are now properly excluded from the agent flow (was only excluded from UI, not from assistant context).
- **Google API cost not included in totals** — Costs from Google APIs (Routes Matrix, etc.) stored in `google_api_cost_eur` were not added to the displayed total cost. Fixed in conversation service (per-message cost), conversation repository (aggregate queries), chat service (user statistics), and streaming debug panel. All cost displays now show LLM + Google API combined.
- **HITL question tokens not tracked** — Token consumption for HITL approval question generation was not tracked, causing cost under-reporting (~€0.03/request on Anthropic models). Fixed by wrapping `TrackingContext` in a `TokenTrackingCallback` for the HITL question generator.
- **HITL approval question ambiguous** — Approval gate could generate two contradictory questions in a single prompt. New dedicated prompt template (`hitl_plan_approval_question_prompt.txt`) enforces a single YES/NO-answerable question.
- **Debug panel DB-aggregated tokens** — HITL flows now fetch DB-aggregated token totals (includes tokens from prior SSE request: router, planner, HITL question) for accurate debug panel display.
- **Google Routes Matrix JSON parsing** — `GoogleRoutesClient` now handles both JSON array and NDJSON response formats (was failing on standard JSON array responses).
- **Concurrent connector access in parallel execution** — `ConcurrencySafeConnectorService.is_connector_active()` was not wrapped with the concurrency lock, causing "concurrent operations are not permitted" errors during parallel sub-agent/tool executions.

## [1.4.7] - 2026-03-16

### Added

- **Intelligent context compaction (F4)** — LLM-based conversation history summarization when token count exceeds a dynamic threshold (configurable ratio of response model context window). Preserves recent messages and critical identifiers (UUIDs, URLs, emails). Includes `/resume` user command for forced compaction, 4 HITL safety conditions, chunked summarization for large histories, descriptive fallback on LLM failure. Configurable via 6 `.env` settings (`COMPACTION_*`). New LLM type `compaction` (GPT-4.1-nano default) visible in admin LLM config panel. 6 Prometheus metrics. Graph entry point changed: `compaction → router`. Schema version bumped to 1.1 with migration.
- **Planner cost-awareness for web search** — `unified_web_search_tool` catalogue description now includes cost constraint (max 1 call per plan), directing planner to use lightweight `brave_search_tool` for additional searches.
- **FAQ `/resume` command** — Added FAQ entry explaining the `/resume` command in all 6 languages (en, fr, de, es, it, zh).

## [1.4.6] - 2026-03-16

### Added

- **Heartbeat email source** — Proactive notifications now aggregate today's unread inbox emails as a 9th context source. Supports Google Gmail, Apple Email, and Microsoft Outlook via dynamic provider resolution. LLM filters for urgent/actionable emails only (skips newsletters, marketing). Configurable via `HEARTBEAT_CONTEXT_EMAILS_MAX` (default: 5).
- **Gmail message normalization** — `GoogleGmailClient.get_message()` now extracts top-level `from`, `subject`, `to`, `cc`, `body`, `_provider` fields, matching the format already produced by Apple and Microsoft normalizers. Enables provider-agnostic message consumption throughout the application.
- **Plan validation error logging** — `PlanValidator` now logs individual validation errors and warnings with full details (code, message, step_index, tool_name, context) for debugging.

### Fixed

- **Plan validator false UNAUTHORIZED errors** — `planner_node_v3` was not passing `oauth_scopes` from state to `ValidationContext`, causing all scope-requiring tools to fail validation. Fixed by reading `state["oauth_scopes"]` (matches `approval_gate_node` pattern).

## [1.4.5] - 2026-03-16

### Added

- **External Content Wrapping (F2)** — Prompt injection prevention for untrusted web content. All external content (web pages, Perplexity synthesis, Brave snippets, Wikipedia summaries) is wrapped in `<external_content>` safety markers with an `[UNTRUSTED EXTERNAL CONTENT]` warning before being sent to the LLM. Tag occurrences within content are escaped to prevent marker breakout. Feature-flagged via `EXTERNAL_CONTENT_WRAPPING_ENABLED` (default: `true`).
- **`content_wrapper` module** (`src/domains/agents/utils/content_wrapper.py`) — `wrap_external_content()` and `strip_external_markers()` functions with XML attribute injection prevention (`source_url` quote escaping).
- **21 unit tests** for content wrapping covering wrapping, stripping, roundtrip, tag escape attacks, XML attribute injection, and real-world integration scenarios.

### Changed

- `fetch_web_page_tool` — Markdown content is wrapped with safety markers after sanitization and truncation (step 11).
- `web_search_tools` — Perplexity synthesis, Brave snippets, and Wikipedia summaries are individually wrapped when `external_content_wrapping_enabled` is true.
- `.env.example` — Added `EXTERNAL_CONTENT_WRAPPING_ENABLED` variable.

### Fixed

- `html_renderer.py` — Removed incorrect `web_fetch` → `WebSearchCard` mapping that rendered an empty card. Web fetch results are inline in the LLM response text and do not need a visual card.

## [1.4.4] - 2026-03-16

### Added

- **Web Search/Fetch Cache** — Redis TTL cache for `unified_web_search_tool` (5 min) and `fetch_web_page_tool` (10 min) results. Reduces external API calls (Brave, Perplexity) and HTTP fetches for repeated queries. Configurable via `WEB_SEARCH_CACHE_ENABLED`, `WEB_SEARCH_CACHE_TTL_SECONDS`, `WEB_FETCH_CACHE_TTL_SECONDS` environment variables. Multi-tenant isolated by user_id.
- **`force_refresh` parameter** on `unified_web_search_tool` and `fetch_web_page_tool` — allows planner to bypass cache when user explicitly requests fresh results.
- **`WebSearchCache` class** (`src/infrastructure/cache/web_search_cache.py`) — follows existing `ContactsCache` pattern with `CacheEntryV2` format, automatic Prometheus metrics (`cache_hit_total`/`cache_miss_total`), and graceful degradation on Redis errors.
- **Recency normalization** — `_normalize_recency()` function converts non-standard planner values (`"7d"`, `"pd"`, `"1w"`) to canonical values (`"day"`, `"week"`, `"month"`). Prevents cache key fragmentation and ensures correct API parameter passing.
- **Catalogue manifest enum constraint** — `recency` parameter on `unified_web_search_tool` manifest now has an `enum` constraint guiding the planner to generate valid values only.
- **13 unit tests** for `WebSearchCache` covering cache hit/miss, TTL, disabled state, Redis errors, multi-tenant isolation, and recency key differentiation.

### Changed

- `unified_web_search_tool` — Cache check before triple parallel search (Perplexity + Brave + Wikipedia), cache store after success. Registry updates excluded from cache (RegistryItem objects not serializable).
- `fetch_web_page_tool` — Cache check before HTTP fetch, cache store after extraction. Eliminates redundant HTTP calls for same URL within TTL window.
- `.env.example` — Added 5 new web cache configuration variables.
- `docs/technical/WEB_FETCH.md` — Added cache architecture section, Redis TTL documentation, `force_refresh` parameter documentation.
- `docs/technical/TOOLS.md` — Added `unified_web_search` and `fetch_web_page` to cache hit rates table.
- `docs/architecture/ADR-029-Redis-Multi-Purpose-Architecture.md` — Added `web_search:{user}:{hash}` and `web_fetch:{user}:{hash}` cache keys to architecture diagram and key reference table.

## [1.4.3] - 2026-03-16

### Changed

- **httpx** 0.27.2 → 0.28.1 — Migrate test fixture from `app=` to `ASGITransport(app=)`, add explicit `follow_redirects=False` on 6 OAuth credential flows (RFC 6749/7009)
- **langgraph** 1.0.10 → 1.1.2 — Required by langchain 1.2.12
- **langchain-core** 1.2.17 → 1.2.19
- **langchain** 1.2.10 → 1.2.12
- **langchain-openai** 1.1.10 → 1.1.11
- **langchain-anthropic** 1.3.4 → 1.3.5
- **langchain-google-genai** 3.2.0 → 4.2.1 — SDK rewrite (google-generativeai → google-genai)
- **firebase-admin** 6.8.0 → 7.2.0 — Removed deprecated send_all/send_multicast (not used)
- **ruff** 0.8.4 → 0.15.6 — Exclude new UP042/UP045/UP046/UP047 cosmetic rules
- **mypy** 1.13.0 → 1.19.1 — Remove stale type:ignore, add overrides for new strict checks
- **pytest** 8.3.3 → 9.0.2
- **pytest-asyncio** 0.24.0 → 1.3.0
- **pytest-cov** 6.0.0 → 7.0.0
- **psycopg** 3.2.10 → 3.3.3
- **pgvector** 0.3.6 → 0.4.2
- **redis** 7.1.0 → 7.3.0
- **uvicorn** 0.40.0 → 0.41.0
- **asyncpg** 0.30.0 → 0.31.0
- **sentence-transformers** 5.2.0 → 5.3.0
- **opentelemetry** 1.39.1 → 1.40.0 (api, sdk, instrumentation-fastapi, exporter-otlp)
- **python-jose** 3.4.0 → 3.5.0
- **python-dotenv** 1.0.1 → 1.2.2
- **email-validator** 2.2.0 → 2.3.0
- **apscheduler** 3.10.4 → 3.11.2
- **readability-lxml** 0.8.1 → 0.8.4.1
- **markdownify** 0.14.1 → 1.2.2
- **jsdom** 28.1.0 → 29.0.0
- **types-passlib** 1.7.7.20240819 → 1.7.7.20260211
- **types-python-jose** 3.3.4.20240106 → 3.5.0.20250531
- **pytest-mock** 3.14.0 → 3.15.1
- **testcontainers** 4.8.2 → 4.14.1
- **debugpy** 1.8.9 → 1.8.20
- **safety** 3.2.11 → 3.7.0
- **bandit** 1.8.0 → 1.9.4
- **15 frontend packages** (react 19.2.4, firebase 12.10, zod 4.3.6, vitest 4.1, @hey-api/openapi-ts 0.94.1, etc.)
- **13 GitHub Actions** (checkout v6, upload-artifact v7, codecov v5, docker actions v4/v7, etc.)

### Fixed

- **CI pipeline**: Use venv in backend CI jobs (fixes MyPy import resolution)
- **CI pipeline**: Fix Alembic head detection regex for typed annotations
- **CI pipeline**: Fix synchronous Store call check false positive (exclude `await` lines)
- **CI pipeline**: Rename codecov `file` → `files` for v5 compatibility
- **CI pipeline**: Regenerate pnpm-lock.yaml after jsdom 29 merge
- **CI pipeline**: Mark checkpointer tests as integration (were failing with wrong DB user)
- **CI pipeline**: Lower coverage threshold to 40%
- **Security**: Add OPENAI_API_KEY to .env.example

### Documentation

- Update STACK_TECHNIQUE.md with all version bumps
- Update GUIDE_DEVELOPPEMENT.md test examples (ASGITransport)
- Update README.md badges (LangGraph 1.1.2, LangChain 1.2.12)

## [1.4.1] - 2026-03-15

### Fixed

- **Heartbeat timezone conversion**: Proactive calendar notifications now display event times in the user's local timezone instead of raw ISO/UTC strings. Fixes notifications reporting events 1 hour early (LLM misinterpreting UTC as local time)
  - Multi-provider support: Google (offset in ISO), Microsoft (naive + timeZone field), Apple CalDAV (naive local times)
  - Naive datetimes (no offset, no timeZone) now default to user timezone instead of UTC, fixing a 1-hour-late display for CalDAV events
  - Task due dates cleaned to date-only format (prevents misleading midnight-UTC timezone shifts)
  - Recent heartbeat/interest notification timestamps converted to user timezone
  - Prompt header now includes "(times in user's local timezone)" for LLM clarity
  - DRY refactor: `_resolve_user_tz()` replaces 3 duplicated timezone fallback blocks
- **Interest notification 0 tokens / 0€**: Token tracking now correctly accumulates tokens from both LLM phases (content generation + presentation formatting). Previously only the presentation phase was counted, and generation phase tokens (LLM reflection) were lost
  - Added `tokens_in`/`tokens_out` fields to `ContentResult` dataclass
  - `LLMReflectionContentSource` now returns tokens in `ContentResult` (in addition to persisting via TrackingContext)
  - `_extract_llm_tokens()` helper with `response_metadata` fallback for non-standard providers
- **Interest presentation LLM provider mismatch**: `LLMAgentConfig` was created without `provider` parameter, defaulting to `"openai"` while model was `claude-sonnet-4-6` (Anthropic) — causing silent 404 errors and raw unformatted content as fallback

### Added

- **CI/CD hardening for public repo**: Comprehensive pipeline overhaul for open-source best practices
  - **Branch protection on `main`**: PR required with 1 review (external contributors), 7 required status checks, force push forbidden, stale review dismissal, conversation resolution required. Admins can bypass for direct pushes
  - **SHA-pinned GitHub Actions**: All actions across 3 workflows (`ci.yml`, `security.yml`, `release.yml`) pinned by commit SHA with version comments — prevents supply-chain attacks via tag mutation
  - **`permissions: contents: read`** on CI workflow (least privilege principle)
  - **Code Hygiene CI job**: New job with 6 checks — `.bak` files, sync Store calls, Redis setex without `json.dumps`, i18n keys sync (EN vs 5 languages), Alembic migration conflicts (revision chain parsing), `.env.example` completeness
  - **Docker build smoke test CI job**: Builds API and Web production images without pushing (catches broken Dockerfiles), with GHA cache
  - **Pre-commit hook aligned with CI**: Added i18n keys sync, Alembic migration conflict detection (date prefix), `.env.example` completeness checks to local pre-commit hook
  - **Repo settings**: `delete_branch_on_merge`, `allow_update_branch`, `allow_auto_merge` enabled; homepage URL set
  - **Dependabot groups**: Minor/patch updates grouped per ecosystem (pip, npm) to reduce PR noise; GitHub Actions updates grouped
  - **`.editorconfig`**: New file enforcing consistent formatting across IDEs (indent 4 for Python, indent 2 for TS/JS/JSON, LF line endings, CRLF for Windows scripts)
  - **GitHub labels**: Added `security`, `ci`, `docker`, `python`, `frontend`, `agents`, `priority:high`, `priority:low`
  - **CI tests aligned with pre-commit**: Fast unit tests only (excluding slow/integration/e2e/benchmark markers + 10 ignored files), coverage threshold 43%
  - **CI/CD documentation**: New `docs/technical/CI_CD.md` with full pipeline architecture, check matrix, troubleshooting
- **`extract_llm_tokens()` centralized helper**: New `src/infrastructure/llm/token_utils.py` — single reusable function for extracting token usage from LangChain AIMessage across all providers (DRY refactor from 2 duplicated implementations)

### Changed

- Updated heartbeat context source tables in docs to reflect multi-provider support (Google/Apple/Microsoft Calendar, Google Tasks/Microsoft To Do)
- Ruff and Black now lint `tests/` in addition to `src/` (aligned with pre-commit hook)
- Interest LLM reflection prompt: heading level fix (`##` → `###`), free-form format with paragraphs instead of strict sentence limits

### Fixed

- **i18n desync**: 3 keys missing in fr/de/es/it/zh (`chat.voice_mode.processing`, `speaking`, `error_permission`), 87 keys missing in en/fr (`settings.interests.*` section). All 6 languages now have 2,587 keys in perfect sync
- **Mixed language in docs**: French documentation files (`GUIDE_HEARTBEAT_PROACTIVE_NOTIFICATIONS.md`, `INTERESTS.md`) contained English sentences — translated to French

## [1.4.0] - 2026-03-14

### Added

- **RAG Knowledge Spaces**: Users can create personal knowledge spaces containing their own documents (PDF, TXT, MD, DOCX) to enrich AI assistant responses
  - **Space management**: Create, edit, delete, and toggle activation of knowledge spaces per user
  - **Document processing pipeline**: Background processing with text extraction, chunking (RecursiveCharacterTextSplitter), and embedding (OpenAI `text-embedding-3-small` via TrackedOpenAIEmbeddings)
  - **Hybrid search retrieval**: Semantic similarity (pgvector cosine) + BM25 keyword matching with configurable alpha fusion
  - **Response Node injection**: RAG context automatically injected into assistant responses when active spaces exist
  - **Full cost transparency**: Embedding costs tracked per document (indexing) and per query (retrieval) in TokenUsageLog, MessageTokenSummary, and UserStatistics
  - **Admin reindexation**: Endpoint to reindex all documents after embedding model change, with Redis flag to disable RAG during migration and automatic vector dimension ALTER
  - **14 Prometheus metrics**: Document processing RED, retrieval performance, space lifecycle Gauges, reindex tracking
  - **Grafana dashboard**: Dedicated RAG Spaces dashboard (18th) with 21 panels
  - **Full frontend**: Space list, detail, document upload (drag & drop + progress), processing status polling, activation toggle, active spaces indicator in chat, settings section
  - **i18n**: Full translation support in 6 languages (en, fr, de, es, it, zh)
  - **Feature flag**: `RAG_SPACES_ENABLED=true` to enable (default: true)

## [1.3.0] - 2026-03-14

### Changed

- **FastAPI 0.128.0 → 0.135.1**: Major framework upgrade pulling Starlette 0.50.0
- **Removed Starlette UTF-8 patch**: Starlette 0.50 natively defaults to `encoding="utf-8"` in Config, making the `patch_starlette_utf8()` monkey-patch obsolete
- **SSE ClientDisconnect handling**: Added graceful catch for `starlette.requests.ClientDisconnect` (raised since Starlette 0.42) — client disconnections during streaming are now logged as info instead of errors

### Fixed

- **SSE CancelledError log level**: Client disconnections during streaming are now logged as `info` instead of `error` in orchestration and streaming services — prevents false error alerts and inflated error metrics
- **DB connection leak on client disconnect**: `session.close()` in `get_db_session()`/`get_db_context()` and `tracker.commit()` in the graph streaming finally block are now shielded with `asyncio.shield()`, preventing SQLAlchemy connection pool exhaustion when clients disconnect mid-stream
- **Stale tests**: Fixed 8 pre-existing test failures in semantic validation and routing modules (obsolete feature flag test, incorrect planner_iteration assertions, incomplete mock settings)

## [1.2.0] - 2026-03-14

### Changed

- **Node.js 20 → 22 LTS**: Upgraded Docker images, CI workflows, and engine requirements to Node.js 22 LTS (supported until April 2027)
- Closed Dependabot PR #4 (Node 25 — not LTS) and PR #6 (Python 3.14 — still in beta)

## [1.1.0] - 2026-03-14

### Added

- **LAN Access & SSL Configuration**: Configurable `SSL_DOMAIN` env var for self-signed certificates covering nip.io domains, enabling LAN access from mobile/other devices
- **SSL cert sharing**: Web container now uses ssl-init certificates via `--experimental-https-key`/`--experimental-https-cert`, ensuring consistent certs across API and Web
- **Documentation**: Added section 4.4 "LAN Access & SSL Configuration" in Getting Started guide

### Fixed

- **Token tracking upsert**: Replaced two-step UPDATE-then-INSERT with PostgreSQL native `INSERT ... ON CONFLICT DO UPDATE` for atomic, race-condition-free token summary persistence
- **Tracking resilience**: Token tracking failures no longer break the chat flow (graceful error handling in `TrackingContext.commit()`)
- **WebSocket HMR refresh loops**: Fixed `NEXT_PUBLIC_ALLOWED_DEV_ORIGINS` format — must be hostname only (e.g., `192.168.1.100.nip.io`), not full URL with protocol/port
- **SSL key permissions**: Changed key.pem to 644 so non-root containers (Next.js `node` user) can read it

### Changed

- `.env.example` is now a development template (was production), `.env.prod.example` remains the production template
- `generate-certs.sh` is fully configurable via `SSL_DOMAIN` and `SSL_IP` env vars (no hardcoded IP)
- Frontend dependencies updated: Next.js 16.1.6, i18next 25.8.18, lucide-react 0.577.0, tailwindcss 4.2.1

## [1.0.0] - 2026-03-13

First public open-source release of LIA.

### Features

- **Multi-Agent Orchestration**: LangGraph-based pipeline with Router, Planner, Orchestrator, and Response nodes
- **16+ Domain Agents**: Contacts, Email, Calendar, Drive, Tasks, Weather, Wikipedia, Perplexity, Brave Search, Web Search, Web Fetch, Places, Routes, Reminders, Context, Query, and dynamic MCP agents
- **Human-in-the-Loop (HITL)**: 6 interaction types — Plan Approval, Clarification, Draft Critique, Destructive Confirm, FOR_EACH Confirm, Modifier Review
- **Smart Planner**: LLM-based execution plan generation with dependency graphs and wave-by-wave parallel execution
- **Plan Pattern Learner**: Redis-based Bayesian learning; high-confidence patterns (>=90%) bypass semantic validation
- **Model Context Protocol (MCP)**: Admin MCP (persistent) + Per-User MCP (ephemeral) with OAuth flow support
- **MCP Apps**: Interactive HTML widgets in sandboxed iframes via PostMessage JSON-RPC bridge
- **Excalidraw Integration**: LLM-driven diagram builder with intent-based element generation
- **Skills System**: agentskills.io standard SKILL.md files with per-user toggle and deterministic bypass strategies
- **Multi-Channel Messaging**: Generic abstraction with Telegram as first implementation (webhook, OTP binding, voice)
- **Autonomous Heartbeat**: LLM-driven proactive notifications with two-phase approach (decision + personality-aware rewrite)
- **Voice Mode**: TTS (Edge/OpenAI/Gemini) + STT (Sherpa-onnx Whisper, CPU-only)
- **Multi-Provider LLM**: 6 providers (OpenAI, Anthropic, Gemini, DeepSeek, Perplexity, Ollama) with dynamic config via Admin UI
- **Multi-Provider Connectors**: Google, Apple iCloud, and Microsoft 365 with mutual exclusivity per functional category
- **Scheduled Actions**: User-scheduled deferred task execution
- **Session-based Auth (BFF)**: HTTP-only cookies in Redis, no JWT exposed to frontend
- **Enterprise Observability**: OpenTelemetry traces, Prometheus metrics, Grafana dashboards, Langfuse LLM analytics
- **Internationalization**: 6 languages (fr, en, es, de, it, zh)
- **Multi-arch Docker**: `linux/amd64` + `linux/arm64` builds for Raspberry Pi deployment
- **Comprehensive Test Suite**: 2,300+ tests (unit, integration, e2e, benchmark)

### Infrastructure

- FastAPI 0.128 backend (Python 3.12+) with async SQLAlchemy 2.0 + asyncpg
- Next.js 16 frontend (React 19, TypeScript) with TailwindCSS 4
- PostgreSQL 16 (+ pgvector) for data and vector search
- Redis 7 for sessions, cache, distributed locks, and pattern learning
- APScheduler for 9 background jobs
- Circuit breaker, rate limiting, and distributed locks
- SOPS/Age encryption for secrets management

[Unreleased]: https://github.com/jgouviergmail/LIA-Assistant/compare/v1.25.11...HEAD
[1.25.11]: https://github.com/jgouviergmail/LIA-Assistant/compare/v1.25.10...v1.25.11
[1.13.3]: https://github.com/jgouviergmail/LIA-Assistant/compare/v1.13.2...v1.13.3
[1.13.2]: https://github.com/jgouviergmail/LIA-Assistant/compare/v1.13.1...v1.13.2
[1.13.1]: https://github.com/jgouviergmail/LIA-Assistant/compare/v1.13.0...v1.13.1
[1.13.0]: https://github.com/jgouviergmail/LIA-Assistant/compare/v1.12.4...v1.13.0
[1.12.2]: https://github.com/jgouviergmail/LIA-Assistant/compare/v1.12.1...v1.12.2
[1.12.1]: https://github.com/jgouviergmail/LIA-Assistant/compare/v1.12.0...v1.12.1
[1.12.0]: https://github.com/jgouviergmail/LIA-Assistant/compare/v1.11.5...v1.12.0
[1.11.5]: https://github.com/jgouviergmail/LIA-Assistant/compare/v1.11.4...v1.11.5
[1.8.2]: https://github.com/jgouviergmail/LIA-Assistant/compare/v1.8.1...v1.8.2
[1.8.1]: https://github.com/jgouviergmail/LIA-Assistant/compare/v1.8.0...v1.8.1
[1.8.0]: https://github.com/jgouviergmail/LIA-Assistant/compare/v1.7.2...v1.8.0
[1.7.2]: https://github.com/jgouviergmail/LIA-Assistant/compare/v1.7.1...v1.7.2
[1.7.1]: https://github.com/jgouviergmail/LIA-Assistant/compare/v1.7.0...v1.7.1
[1.7.0]: https://github.com/jgouviergmail/LIA-Assistant/compare/v1.6.1...v1.7.0
[1.6.1]: https://github.com/jgouviergmail/LIA-Assistant/compare/v1.6.0...v1.6.1
[1.6.0]: https://github.com/jgouviergmail/LIA-Assistant/compare/v1.5.2...v1.6.0
[1.5.2]: https://github.com/jgouviergmail/LIA-Assistant/compare/v1.5.1...v1.5.2
[1.5.1]: https://github.com/jgouviergmail/LIA-Assistant/compare/v1.5.0...v1.5.1
[1.5.0]: https://github.com/jgouviergmail/LIA-Assistant/compare/v1.4.7...v1.5.0
[1.4.7]: https://github.com/jgouviergmail/LIA-Assistant/compare/v1.4.6...v1.4.7
[1.4.6]: https://github.com/jgouviergmail/LIA-Assistant/compare/v1.4.5...v1.4.6
[1.4.5]: https://github.com/jgouviergmail/LIA-Assistant/compare/v1.4.4...v1.4.5
[1.4.4]: https://github.com/jgouviergmail/LIA-Assistant/compare/v1.4.3...v1.4.4
[1.4.3]: https://github.com/jgouviergmail/LIA-Assistant/compare/v1.4.1...v1.4.3
[1.4.1]: https://github.com/jgouviergmail/LIA-Assistant/compare/v1.4.0...v1.4.1
[1.4.0]: https://github.com/jgouviergmail/LIA-Assistant/compare/v1.3.0...v1.4.0
[1.3.0]: https://github.com/jgouviergmail/LIA-Assistant/compare/v1.2.0...v1.3.0
[1.2.0]: https://github.com/jgouviergmail/LIA-Assistant/compare/v1.1.0...v1.2.0
[1.1.0]: https://github.com/jgouviergmail/LIA-Assistant/compare/v1.0.0...v1.1.0
[1.0.0]: https://github.com/jgouviergmail/LIA-Assistant/releases/tag/v1.0.0