Tools

Every Python script in tools/ follows the same contract: reads files, produces JSON or a table to stdout, never calls an API, never modifies wiki content directly. The agent orchestrates the tools through skill-defined workflows — see Architecture for how the deterministic and semantic layers interact.

All scripts accept --help for full options. Most support --json for machine-readable output.

Python scripts

Deterministic tools

Script	What it does
health.py	Structural integrity checks — empty pages, index sync, log coverage, tag validation
build_graph.py	Extract wikilinks, detect communities via Louvain, generate graph data and structural report
print_graph.py	Render interactive graph.html from graph data — supports --tag for project-specific views
validate_domain.py	TF-IDF + entity/concept overlap scoring for domain affinity during blind review
wiki_index.py	Manage wiki/index.md deterministically — add, remove, or update entry descriptions
wiki_search.py	Exhaustive wiki page scanning by term matching — returns ranked results with match counts
extract_terms.py	Extract term frequencies from a document for discovery review during ingest

Standalone usage

The scripts can run directly from terminal, without a coding agent.

python tools/health.py
python tools/build_graph.py
python tools/print_graph.py
python tools/validate_domain.py --doc raw/doc.md --tag project-alpha
python tools/wiki_index.py --add wiki/entities/OpenAI.md --desc "AI company"
python tools/wiki_search.py --terms "RAG,embeddings" --tag project-alpha
python tools/extract_terms.py raw/doc.md

Where they appear

Each tool is orchestrated by the agent within specific workflows. The full command reference is in Getting Started.