README: pin --version to this repo's commit in the ingest recipe

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01EvxzSKi1zR395wvYXUenVE
2026-08-22 16:53:10 +09:00
parent 119309debf
commit ccefd1751b
2 changed files with 74 additions and 1 deletions
@@ -34,12 +34,17 @@ Markdown needs no conversion and no extraction verifier — admit it straight fr

 ```bash
 index.py admit ~/dev/handbooks/git-operations.md --corpus engineering \
-  --vouch mikkeli --title 'Git operations' --collection dev-practice
+  --vouch mikkeli --title 'Git operations' --collection dev-practice \
+  --version "$(git -C ~/dev/handbooks rev-parse --short HEAD)"
 ```

 Without `--title` the document is titled by its filename, which is what a retrieval hit then shows.
 `--collection` is a flat cluster tag; getting it wrong costs recall and nothing else.

+⚠ **`--version` is this repo's commit, and it is the one that matters.** Re-admitting replaces a
+document outright with no version history, so the pin is the only record of which revision a chunk
+reflects.
+
 ⚠ **Editing a file here does not update the corpus.** Re-admission is deliberate, because the vouch
 is a claim about a specific version of a document.