docs(examples): runnable, verified examples for the full kb.* surface

[plind-junior]

summary

adds runnable, verified examples covering the full kb.* surface (all 54
methods), mirroring AKBP's examples in shape (README.md + run.sh) while
keeping vouch's existing <name>/vouch/ snapshot convention. an auditable
method → example coverage matrix lives in examples/README.md.

what's added

• 17 runnable flows — each builds a throwaway KB in a temp dir, drives the
  real CLI / JSONL surface, asserts the end state, and cleans up: review gate,
  dry-run preview, jsonl quickstart, search backends, context + synthesize,
  browse/read, the propose family, lifecycle, sessions + crystallize, graph +
  provenance, maintenance/health, embeddings, export/import bundles, audit,
  scoping.
• 4 playbooks — for features that spawn external agents or hit the network
  (dual-solve, auto-pr, vault sync, install-mcp): the safe legs run, the
  dangerous command is printed with its requirements rather than executed.
• 2 conformance-level snapshots — level-0-markdown-wiki, level-3-graph,
  in the existing snapshot style.

verification

every run.sh was run exit-0 against vouch 1.0.0 (during authoring and
re-checked independently). generic placeholder data only (alice-example,
acme-example).

coverage

all 54 kb.* methods are mapped to at least one example in
examples/README.md; nothing under "Not yet covered". the matrix doubles as a
regression guard — add a method, add a row.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 7dcd4d82-d514-42ad-8c9b-a36c6c58a836

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch docs/examples

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}