From 669279a52df6ae0d884606f7ffa794a6a088eb18 Mon Sep 17 00:00:00 2001
From: Tunglies <77394545+Tunglies@users.noreply.github.com>
Date: Wed, 30 Sep 2026 14:25:03 +0800
Subject: [PATCH] docs(backend): record dead wire contract entries

---
 src-tauri/AGENTS.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/src-tauri/AGENTS.md b/src-tauri/AGENTS.md
index 06ad6831a..9fca79414 100644
--- a/src-tauri/AGENTS.md
+++ b/src-tauri/AGENTS.md
@@ -24,6 +24,14 @@ These rules supplement the repository's root `AGENTS.md`.
    status strings pinned by the golden tests. Status additions or changes
    require frontend and backend changes in the same PR and an updated golden
    list; this protects the wire contract. No exceptions.
+
+    Known dead wire entries, recorded here and intentionally kept (no tracking
+    issue): the `config_validate::*` statuses whose frontend handlers never
+    receive a backend send (`core_change`, `stdout_error`, `yaml_key_error`,
+    `yaml_error`, `merge_key_error`, `merge_error`), and `set_config::ok`,
+    sent by the backend with no frontend handler. Each variant carries its own
+    comment in `NoticeStatus`. Removal requires a same-PR frontend change and a
+    golden-list update.
 5. **Preserve lock order.** The order is `config_write` before
    `config_update_in_progress` before `lifecycle_lock`. Patch callers must use
    the executor's guarded claim instead of independently combining these locks;