Printable idea sheet
indexing_trigger_auto
reqlan rq/extension/index-host/graph-analysers.rq:29
Katz 0.113
When the editor host is idle, run a **background staleness check** — not a reindex and not a soft full sync UI pass.
Philosophy: computationally cheap. Load document mtimes in **one** SQLite read, compare each file's FS mtime in memory, and only then index mismatched or new files; drop deleted docs in one batched delete.
A single MAX ( mtime ) watermark is not sufficient ( one file can get newer while another gets older ).
If nothing is stale: no state transition, no progress UI, no parse.
If some files are stale: index **only those files** under nonblocking_index.
Schedule after a quiet period with no index activity; prefer running when the window is unfocused; defer or cancel if the user becomes active again.
Extension host only ( index-service.ts ); CLI / MCP have no idle loop ( they sync on activate / command ).
- status
- done
Interactive page: indexing_trigger_auto