diff --git a/README.md b/README.md index ada03bf..55844ab 100644 --- a/README.md +++ b/README.md @@ -329,9 +329,17 @@ AGENTS.md's "Gates" section. ## Telemetry and evaluation -Every `wikitool` call appends an event to `reports/telemetry//trace.jsonl`, and the -hook files under `.github/hooks/` and `.vibe/` add what the agent did between those calls. -Nothing leaves the machine: `reports/` is gitignored and no exporter is configured. +In this checkout, every `wikitool` call appends an event to +`reports/telemetry//trace.jsonl`, and the hook files under `.github/hooks/` and +`.vibe/` add what the agent did between those calls. Nothing leaves the machine: `reports/` is +gitignored and no exporter is configured. + +**A distributed instance records nothing unless it asks to.** The default follows the +installation form - on for a git clone of this repo, where the traces are the stack's own +measuring instrument, off for a `dist export` tarball, where nobody ordered telemetry. Two +quantity caps apply either way: 5 MiB per session trace, and 250 session directories. +`wikitool doctor` reports which state a checkout is in and why; EVALS.md ยง "Whether it runs at +all" has the precedence rules and the opt-in file. That record is what makes it possible to ask how a session *worked*, not just what it left behind: