2026-03-05T08-03-13_auto_memory/2026-03-05-signet-architecture-md-persisten

memory/2026-03-05-signet-architecture-md-persistence-hardening.md

@@ -0,0 +1,20 @@
+# 2026-03-05 Session Notes
+
+## SIGNET-ARCHITECTURE.md Persistence Hardening
+
+Nicholai began implementing a plan to harden the persistence of SIGNET-ARCHITECTURE.md in the Signet monorepo. The work was triggered by a user report of the file missing from `~/.agents/`, though investigation confirmed the root cause was external (`git filter-repo` on Feb 27).
+
+The implementation identified two resilience gaps:
+
+1. **No daemon startup write** — `syncHarnessConfigs()` only runs when the file watcher detects identity file changes. With `ignoreInitial: true`, if the daemon starts and no identity files are edited, SIGNET-ARCHITECTURE.md is never created or re-created.
+
+2. **Not on file watcher** — The file wasn't in the watched paths array (daemon.ts:6620-6628), so writing it never triggered auto-commit. It only got committed as a side effect when another watched file triggered `git add -A`.
+
+The fix involved:
+- Extracting architecture doc write logic into a helper function `ensureArchitectureDoc()`
+- Calling it during daemon startup (~line 7226)
+- Calling it in `syncHarnessConfigs()` to replace inline logic (lines 6587-6598)
+- Adding the file to the watched paths array
+- **NOT** adding it to SYNC_TRIGGER_FILES to avoid triggering harness sync loops
+
+The session began reading relevant sections of daemon.ts to understand the current implementation structure.