knowledge-distilllisted

# Knowledge Distill Turns a library's docs + source **at a pinned version** into concept files under `knowledge/libraries/<lib>/` in the current repo. Agents then read them through the index-first protocol the repo already has, instead of guessing at an API that moved. This is a static-artifact pipeline, not a retrieval tool. It runs when asked, writes files, and exits. Nothing loads at task time except through `.claude/rules/knowledge.md`. **Read `references/bundle-format.md` before writing any file.** The output has to pass `tools/knowledge_validate.mjs`, which runs in the target repo's pre-commit and CI, and every rule in that reference is there because the validator enforces it. ## Preconditions - `git` is available and the library's repo is public. Private repos and non-git doc sources are out of scope. - The repo has a `knowledge/` bundle. If `knowledge/index.md` is missing, do Phase 0a first. - The bundle is on the OKF v0.2 layout. If any `knowledge/libraries/*/index.md` carries a `library:` key and has no `pin.md` beside it, that bundle predates v1.62.0 — stop and run `node tools/knowledge_migrate_okf.mjs` (dry run first, then `--write`). Distilling over a legacy bundle leaves two pins in one directory, and only one of them is the one the drift guard reads. The script is in `bigin-harness-setup`'s `references/knowledge-migration.md` if the repo doesn't have it yet. ## Phase 0a — Bootstrap the bundle (only when it's absent) A distilled bundle is self