v2.0.0

What's Changed

Added

• Agent Registry and Validation Infrastructure (MAJOR FEATURE)

  • Comprehensive YAML-based agent registry (agents/REGISTRY.yaml) with 16 agents
  • Agent handoff graph validator (scripts/validate-handoff-graph.py) with cycle detection
  • Agent registry query tool (scripts/agent-registry.py) with CLI interface
  • Pipeline documentation for 5 common workflows with cost estimates
  • CI/CD validation script (tests/validate-agents.sh) for automated testing
  • Commands: list-agents, show-agent, find-agents, pipeline, validate-handoff, cost
  • Documentation: docs/AGENT_ORCHESTRATION.md (17KB), docs/README_AGENT_VALIDATION.md (11KB)

• Security Hardening and Documentation

  • Comprehensive Security Policy (SECURITY.md) with threat model and defense-in-depth architecture
  • Hook Permission System documentation (docs/PERMISSIONS.md) covering all safety hooks
  • Key rotation procedures and security recommendations
  • Agent development security guidelines (docs/AGENT_DEVELOPMENT.md)
  • Versioning and migration guide (docs/VERSIONING_AND_MIGRATION.md)

• MCP Server Configuration Schema

  • JSON Schema for MCP server configurations (mcp-servers/schema/mcp-server-config.json)
  • Validation tools for MCP server setup
  • Standardized configuration format across all MCP servers

• Testing Infrastructure Expansion

  • Component tests for MCP protocol compliance (tests/component/mcp/)
  • Pipeline tests for agent handoff validation (tests/pipeline/agents/)
  • Hook test coverage expansion with new test utilities
  • Test fixtures and shared test libraries (tests/lib/)
  • pytest configuration and conftest setup

• Rollback and Version Management

  • Version detection utilities for compatibility checking
  • Rollback mechanism for reverting to previous versions
  • Version markers in configuration files
  • Migration path documentation from v1.x to v2.0

Changed

• Enhanced Hook System

  • Improved bash command dispatcher with better error handling
  • Extended hook coverage across all potentially dangerous operations
  • Refined permission decision logic (allow/ask/block)

• Documentation Reorganization

  • Restructured docs/ directory with clear categorization
  • Added version headers to all documentation files
  • Cross-referenced documentation for easier navigation
  • Enhanced examples and usage patterns

• Agent Metadata

  • All agents now include complete metadata (category, model, cost multiplier)
  • Standardized agent frontmatter format
  • Explicit handoff relationships documented

Fixed

• Hook test reliability improvements
• MCP server configuration validation edge cases
• Agent handoff contract symmetry verification

Breaking Changes

• None: v2.0.0 is fully backward compatible with v1.x configurations
• Migration from v1.x is seamless - no manual intervention required
• All v1.x hooks, agents, and MCP servers continue to work unchanged

Technical Debt Addressed

• Eliminated agent orchestration ambiguity with explicit registry
• Standardized MCP server configuration format
• Unified documentation structure
• Comprehensive validation coverage

Validation Results

Registry Status: PASS
Agents: 16
Pipelines: 5
Errors: 0
Warnings: 0
Test Coverage: 95% (hooks), 85% (examples)

Migration Guide

For users upgrading from v1.x to v2.0.0:

1. No breaking changes - update version and restart Claude Code
2. Review new agent registry: python3 scripts/agent-registry.py list
3. Explore new documentation in docs/ directory
4. Optional: Review docs/VERSIONING_AND_MIGRATION.md for best practices

Docker Images

All images available at ghcr.io/hellblazer/hal-9000:

Profile	Tag	Description
Base	:latest, :2.0.0	Claude CLI + MCP servers
Python	:python, :python-2.0.0	+ Python 3.11, uv, pip
Node	:node, :node-2.0.0	+ Node.js 20, npm, yarn, pnpm
Java	:java, :java-2.0.0	+ GraalVM 25 LTS, native-image, Maven, Gradle

Installation

# Add marketplace to Claude Code
# Settings → Marketplaces → Add: https://github.com/Hellblazer/hal-9000.git

# Or pull Docker image directly
docker pull ghcr.io/hellblazer/hal-9000:latest

Local Docker Build

Docker images are built locally (multi-arch CI was too slow):

cd plugins/hal-9000/docker
./build-profiles.sh --push