[Bezalel Epic-004] Wizard Council Automation — Shared Tooling & Environment Validation #148

Closed
opened 2026-04-06 22:42:00 +00:00 by Timmy · 1 comment
Owner

Epic Statement

I will forge shared infrastructure so every wizard boots into a validated, consistent environment. No more 'it works on my machine.'

Scope

  1. Create a wizard-bootstrap/ script that validates a new wizard environment: checks Python version, installs deps, verifies Gitea auth, tests Telegram connectivity, and runs a smoke test.
  2. Build a skills-audit tool that compares each wizard's installed skills against the repo bundled skills and reports drift.
  3. Implement cross-wizard dependency checking: if one wizard's skill relies on a binary or env var, enforce that it is documented and checked at startup.
  4. Document the 'Wizard Environment Contract' — the minimum viable state every forge wizard must maintain.
  5. Run a monthly audit and post the report to wizard-council-automation.

Success Criteria

  • A new wizard can run one script and know if their forge is ready.
  • Skill drift between wizards is detectable and reportable.
  • Environment contract is agreed upon and enforced.
  • Monthly audit runs automatically.

Owner

Bezalel

## Epic Statement I will forge shared infrastructure so every wizard boots into a validated, consistent environment. No more 'it works on my machine.' ## Scope 1. Create a `wizard-bootstrap/` script that validates a new wizard environment: checks Python version, installs deps, verifies Gitea auth, tests Telegram connectivity, and runs a smoke test. 2. Build a `skills-audit` tool that compares each wizard's installed skills against the repo bundled skills and reports drift. 3. Implement cross-wizard dependency checking: if one wizard's skill relies on a binary or env var, enforce that it is documented and checked at startup. 4. Document the 'Wizard Environment Contract' — the minimum viable state every forge wizard must maintain. 5. Run a monthly audit and post the report to `wizard-council-automation`. ## Success Criteria - A new wizard can run one script and know if their forge is ready. - Skill drift between wizards is detectable and reportable. - Environment contract is agreed upon and enforced. - Monthly audit runs automatically. ## Owner Bezalel
claude self-assigned this 2026-04-07 01:47:03 +00:00
Member

PR created: #158

Implemented the full Bezalel Epic-004 scope in wizard-bootstrap/:

  • wizard_bootstrap.py — one-command environment validator (Python version, deps, hermes import, HERMES_HOME, LLM key, Gitea auth, Telegram) — exits 0 if forge-ready
  • skills_audit.py — detects skill drift between repo and ~/.hermes/skills/, reports MISSING/EXTRA/OUTDATED/OK, --fix syncs automatically
  • dependency_checker.py — enforces binary and env_var deps declared in SKILL.md frontmatter across wizards
  • monthly_audit.py — runs all three checks, saves Markdown report to ~/.hermes/wizard-council/audit-YYYY-MM.md, optional Telegram delivery
  • WIZARD_ENVIRONMENT_CONTRACT.md — v1.0.0 spec of minimum viable state every forge wizard must maintain
  • skills/devops/wizard-council-automation/SKILL.md — makes toolset discoverable from any wizard session
  • 21 passing tests in tests/test_wizard_bootstrap.py
PR created: https://forge.alexanderwhitestone.com/Timmy_Foundation/hermes-agent/pulls/158 Implemented the full Bezalel Epic-004 scope in `wizard-bootstrap/`: - **wizard_bootstrap.py** — one-command environment validator (Python version, deps, hermes import, HERMES_HOME, LLM key, Gitea auth, Telegram) — exits 0 if forge-ready - **skills_audit.py** — detects skill drift between repo and `~/.hermes/skills/`, reports MISSING/EXTRA/OUTDATED/OK, `--fix` syncs automatically - **dependency_checker.py** — enforces binary and env_var deps declared in SKILL.md frontmatter across wizards - **monthly_audit.py** — runs all three checks, saves Markdown report to `~/.hermes/wizard-council/audit-YYYY-MM.md`, optional Telegram delivery - **WIZARD_ENVIRONMENT_CONTRACT.md** — v1.0.0 spec of minimum viable state every forge wizard must maintain - **skills/devops/wizard-council-automation/SKILL.md** — makes toolset discoverable from any wizard session - 21 passing tests in `tests/test_wizard_bootstrap.py`
Sign in to join this conversation.
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: Timmy_Foundation/hermes-agent#148