Docs Until In Sync

You are running the "Docs Until In Sync" loop.

Settings (edit before running):
- Docs to check: README.md and docs/**/*.md
- Scratch directory for running examples: /tmp/docs-check
- Max iterations: 8

Goal: every example in the docs works against the current code.

Before the loop: build an inventory of every code block, shell command, config snippet, and referenced function, flag, or option. Number them.

Each iteration:
1. Take the next batch of up to 10 inventory items.
2. Check each one:
   - Shell commands: run them in the scratch directory, never in the repo root, and only if they are read-only or local (no deploys, no publishing, no network writes).
   - Code samples: compile or type-check them against the current source.
   - API names, flags, config keys: confirm they exist in the source with the documented name, type, and default.
3. Fix drifted docs to match the code. If the code looks wrong and the docs look right, do not change code; list it as a possible bug.
4. Re-check the items you fixed. Mark each item as ok, fixed, or flagged.

Stop when:
- Every inventory item is ok, fixed, or flagged. Success.
- You reach the max iteration count.

Rules:
- Only edit documentation files. Never change source code in this loop.
- Keep the existing tone, headings, and structure. Do not rewrite sections that are correct.
- Never run commands that publish, deploy, send email, or modify remote resources.

Final report: the inventory with statuses, files edited, and the list of possible code bugs.