Phase 3: Advanced Governance - Diagnostics, Discovery & CLI

[stevei101]

Phase 3: Advanced Features (Week 3)

Add Nix diagnostics, agent discovery, and CLI governance commands.

Tasks

• Integrate Nix CI diagnostics into src/error.rs - GovernanceViolation error handling
• Create src/governance/discovery.rs - Automatic agent scanning & discovery
• Extend src/bin/server.rs - Add governance CLI commands
  • governance validate - Validate configuration
  • governance sync - Sync symlinks
  • governance status - Show symlink status
  • governance list-agents - List discovered agents
  • governance check-compliance <graph-id> - Validate graph compliance
• Create compliance validation in src/governance/validator.rs
• Add comprehensive tests in tests/governance_advanced.rs
• Create tests/governance_nix_diagnostics.rs - Diagnostic tests

Acceptance Criteria

• Nix diagnostics properly diagnose governance violations
• Agent discovery finds all agents in repo
• All CLI commands work correctly
• Compliance checking validates rules are followed
• All advanced tests pass
• Error messages are clear & actionable

Dependencies

• Depends on: Phase 2: Governance Integration - Node Awareness & Symlinks #32 (Phase 2)

Related Issue

Part of: #30 (Epic)

---

Estimated Effort: 5 days
Labels: governance, phase-3, advanced