Skip to main content

Module indexwatch

Module indexwatch 

Source
Expand description

Opportunistic filesystem watcher for the OKF index.

The daemon is deliberately an optimization: clients use a bounded file-based barrier when it is healthy and run synchronous reconciliation otherwise.

Structs§

Status

Functions§

barrier
Ask a healthy daemon to drain observed events. Returns false quickly when no trustworthy daemon is present so the caller can reconcile synchronously.
condense
ensure_started
Start one detached watcher if the per-project OS lock proves that no daemon exists. The short-lived file claim closes the parent/child lock-handoff race and is age-recovered if a child dies before entering the daemon body.
read_status
rebuild
reconcile
The authoritative synchronous reconciliation path shared by normal commands and the watcher. Events only decide when this needs to run.
request_stop
run_daemon
Foreground body of the detached watcher process. Standard streams remain detached; only sparse lifecycle events are written to the bounded log.
runtime_dir
start_failure