graph-integrity-validator

Agent graph integrity validation detects broken references by verifying node-to-skill paths, edge-to-node connections, and team-member IDs. It enforces backlink rules, logs violations, and blocks swarm execution until all reference issues are resolved.

Swarm initialization fails when graph nodes reference missing skills because the integrity validator halts bootstrap execution upon detecting broken backlinks. It logs these violations and provides corrective suggestions via a backlinks registry to fix missing SKILL.md directories.

The best way to ensure edges reference existing nodes is running a graph validation check during bootstrap. Edge-to-node validation verifies all edge connections point to valid nodes, blocking execution and logging violations if any broken references are found.

Yes, team-member validation checks that all team node memberIds exist in graph.nodes before swarm execution. This integrity check runs during initialization, logs any invalid member references, and prevents the swarm from starting until violations are corrected.

When graph integrity violations are detected, the validator logs the broken references and blocks swarm execution entirely. It uses a self-healing backlinks registry to provide corrective suggestions, ensuring all nodes, edges, and team members sync before proceeding.

Graph validation checks are needed during swarm initialization and before any agent orchestration execution. Running validateGraphIntegrity first in your bootstrap sequence ensures 100% sync between knowledge, abilities, and usages by catching broken references early.