From fa190d2187cdc2dfcdb549e77590c3cee10d7d86 Mon Sep 17 00:00:00 2001
From: teknium1 <127238744+teknium1@users.noreply.github.com>
Date: Sat, 3 Oct 2026 23:42:50 -0700
Subject: [PATCH] docs(desktop): note the local-secondary exception on the
 owner stamp helper

---
 apps/desktop/src/lib/session-owner-stamp.ts | 9 ++++++---
 1 file changed, 6 insertions(+), 3 deletions(-)

diff --git a/apps/desktop/src/lib/session-owner-stamp.ts b/apps/desktop/src/lib/session-owner-stamp.ts
index 04839e0d48..121c401b45 100644
--- a/apps/desktop/src/lib/session-owner-stamp.ts
+++ b/apps/desktop/src/lib/session-owner-stamp.ts
@@ -13,9 +13,12 @@ import type { SessionInfo } from '@/types/hermes'
  * an active NON-local source get stamped: the gateway's HTTP APIs correctly
  * know nothing about Desktop-local registry ids, and an untagged remote row
  * would let a later resume fall back to a same-named local profile
- * ("session not found" on turn two). `local` is never stamped — a bare local
- * row already routes correctly and a `local` tag would only pin it against
- * the fail-closed owner resolution for no benefit.
+ * ("session not found" on turn two). `local` is never stamped here — a bare
+ * local row already routes correctly while local is the primary, and a `local`
+ * tag would only pin it against the fail-closed owner resolution. The one
+ * exception, `local` serving as a registry SECONDARY, is stamped by its caller
+ * (`stampProjectSessions` in store/projects), because there a bare row would
+ * route to the remote primary.
  */
 export function stampRowsWithOwningConnection(
   sessions: SessionInfo[],