docs(watcher): state what changedSince can and cannot detect

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-19 21:09:13 +02:00
parent 97ec9e7ce8
commit e6e14102ee
2 changed files with 7 additions and 3 deletions
@@ -446,7 +446,9 @@ func TestProcessDir_KeepsTheOriginalWhenTheArchiveCopyFails(t *testing.T) {
 }

 // If the note is replaced (e.g. by Syncthing) while it is being ingested, the
-// archive holds the OLD content; removing the original would lose the new one.
+// wiki page was extracted from the old content; removing the original would
+// leave the new content only in the archive and never re-ingest it. Observes
+// size/mtime change only: a same-size rewrite with a restored mtime is not caught.
 func TestProcessDir_KeepsANoteThatChangedWhileItWasBeingIngested(t *testing.T) {
 	brainDir := setupBrainDir(t)
 	note := filepath.Join(brainDir, "raw", "edited.md")