Framework / Movement
Make legal movement explicit
Edges constrain movement; routers choose among already legal targets. Hard policy belongs in deterministic guards.Three edge roles
- edge_deterministic commits a known target when its optional guard passes.
- Semantic edges allow a model-backed router to select among labeled legal targets.
- edge_fallback leads to the dedicated fallback when no normal path is accepted.
Choose the router by responsibility
- DeterministicRouter: exact business rules and ordered predicates.
- SemanticRouter: soft intent selection among up to nine actionable targets plus fallback.
- PreferredPathRouter: prefer a declared path while preserving graph validation.
- Parallel or multi-step work should be represented with explicit graph structure, not inferred from a routing label.