update-docs

Introspect Code & Update All Documentation Surfaces

This command reads the actual source code to count routes, tools, and providers, then updates every documentation surface (README, docs/, docs-site/, GitHub About) with the correct values.

It runs fully automatically with NO user prompts.

Instructions

Follow these steps strictly and sequentially. Do NOT ask the user for confirmation between steps — proceed automatically.

Step 1: Introspect source of truth

Count the actual values from code. Use Grep/Read tools — do NOT guess or use cached values.

1a. Count routes

Read no_commit/api-routes.md (canonical route list). Extract:

• Total from the ## Total: line at the bottom
• Base routes count from the ## Base Routes (N) header
• Feature-gated breakdowns from the ## Feature: name (N) headers

Do NOT re-parse routes.rs — the canonical file is the source of truth. If no_commit/api-routes.md does not exist, warn the user and skip route counting.

1b. Count tools

Read crates/zenii-core/src/boot.rs. Count:

• Base tools: tool_registry.register( calls NOT inside #[cfg(feature blocks
• Feature-gated tools: tool_registry.register( calls inside #[cfg(feature blocks
• Total: base + feature-gated

1c. Count providers

Read crates/zenii-core/src/ai/providers.json. Count entries in the providers array.

1d. Print summary

Print the introspected values:

Introspected values:
- Routes: {core} core + {channels} channels + {scheduler} scheduler + {workflows} workflows = {total} total
- Tools: {base} base + {feature_gated} feature-gated = {total} total
- Providers: {count} AI providers

Step 2: Find stale values

Search for stale/incorrect counts across all doc surfaces:

grep -rn "routes" README.md docs/ docs-site/ --include="*.md" | grep -E "\d+ (API )?routes"
grep -rn "built-in" README.md docs/ --include="*.md" | grep -E "\d+ built"
grep -rn "tools" README.md docs/ --include="*.md" | grep -E "\d+ (base |built-in )?tools"
grep -rn "providers" README.md docs/ --include="*.md" | grep -E "\d+ .* providers"