Small, sharp tools.

The command-line utilities that keep the wiki honest — validators, drift, RAG indexing, the demo and the export bundler, all one make target away.

Make targets

CI validators

Tests, all green

New deps (stdlib)

The Makefile

One entry point for everything (run from automation/).

Target	What it does	Command
sync	install/refresh deps with uv	`make sync`
demo	run the end-to-end pipeline on fixtures	`make demo`
test	run the unit test suite (pytest)	`make test`
validate	front-matter + link validators over the wiki	`make validate`
rag-demo	chunk the wiki, write a mock AI Search payload	`make rag-demo`
drift	print the documentation drift report (Teams-ready)	`make drift`
serve	run the auto-docs flow HTTP API (console at /)	`make serve`

🪓 Open the Makefile Every target in one place — the single entry point. automation/ →

The validators

Three CI gates that fail the build before bad docs merge.

📋 front_matter.py Every page has valid, schema-correct front-matter. tools/validators/ → 🔗 link_check.py No broken internal links. tools/validators/ → 🛡️ hand_edit_guard.py Humans can't hand-edit machine-generated /_generated pages. tools/validators/ →

Tools of the trade

The scripts behind drift, RAG indexing, the demo and offline sharing.

📉 drift/report.py — drift report Nightly diff between /_generated and upstream; Teams-ready markdown. automation/drift/ → ✂️ rag/chunker.py — chunker Splits wiki pages into retrieval chunks. automation/rag/ → 🔎 rag/demo_index.py — RAG indexer Builds a mock AI Search payload. automation/rag/ → 🎬 demo/run_demo.py — end-to-end demo Ingest → route → draft → PR → validate, on fixtures. automation/demo/ → 📦 build-pack.sh — export bundle Zip the exec pack to dist/ for offline sharing. presentation/ → 🗒️ Cheatsheets (wiki) Ansible, Azure CLI, Git & PRs. wiki →

Quick runs

Copy-paste from the repo root and watch it work.

cd automation
make test                 # 27 tests, all green
make demo                 # see a page drafted end-to-end
make validate             # front-matter + links across the wiki
make drift                # what's drifted from source

No new dependencies: the API and scripts are stdlib-only; only pyyaml + pytest are used.

Where to go next

Neighbouring sections of the workspace.

🚜 Tractor · Automation IaC, pipelines and self-driving remediation. Section 03 → 💧 Irrigation · Workflows n8n and ServiceNow orchestration paths. Section 05 → 🌾 Silo · Monitoring Everything we watch — stored and surfaced. Section 02 →