From 61e18dc4aafee18647d2f6f6e1f3fbf7af8fb93e Mon Sep 17 00:00:00 2001 From: Torben Nehmer Date: Wed, 7 Oct 2026 07:08:22 +0200 Subject: [PATCH] docs: the ingest and maintenance how-tos say the generated indexes, log and provenance do not count toward the Mass-Update Gate (#191) Files changed: - docs/how-to/ingest-a-source.md - docs/how-to/maintain-the-wiki.md Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SnAJ7Z3CpVD3PRbN73QtU2 --- docs/how-to/ingest-a-source.md | 3 ++- docs/how-to/maintain-the-wiki.md | 3 ++- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/docs/how-to/ingest-a-source.md b/docs/how-to/ingest-a-source.md index c1eecb4..36086ee 100644 --- a/docs/how-to/ingest-a-source.md +++ b/docs/how-to/ingest-a-source.md @@ -43,7 +43,8 @@ what is waiting and names the entry the next bare `Ingest` will take. - **Before writing pages**, the agent presents the key takeaways and asks which points matter most and what to emphasise. The pages follow your answer. - **When it publishes**, a source that touches ten or more files stops at the Mass-Update Gate - (exit 42). The agent shows you the file list and the `--confirm` line. Nothing is committed until + (exit 42). The generated indexes, `kb/log.md` and `kb/provenance.md` do not count, so a small + source goes straight through. The agent shows you the file list and the `--confirm` line. Nothing is committed until you approve. [Exit codes and gates](../reference/exit-codes.md) lists every gate. ## What you get back diff --git a/docs/how-to/maintain-the-wiki.md b/docs/how-to/maintain-the-wiki.md index cb21291..8813732 100644 --- a/docs/how-to/maintain-the-wiki.md +++ b/docs/how-to/maintain-the-wiki.md @@ -47,7 +47,8 @@ tools/wikitool sources trace --page "HA Integration" # which raw files this p ## Where the agent stops -- **Publishing ten or more files** stops at the Mass-Update Gate (exit 42). A lint pass that repairs +- **Publishing ten or more files** stops at the Mass-Update Gate (exit 42); the generated indexes, + `kb/log.md` and `kb/provenance.md` are not counted. A lint pass that repairs many pages does this routinely. The agent shows you the full file list and the `--confirm` line, and publishes only after you approve. The token is a digest of that file list, so your approval never covers a changeset you did not see.