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

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.