Module validation 

Queue validation facade.

Responsibilities:

• Expose queue validation entrypoints and warning types.
• Coordinate queue-file checks with dependency, relationship, and parent validators.
• Keep shared validation data structures local to this module tree.

Not handled here:

• Queue persistence or mutation workflows.
• Config validation or CLI reporting.

Invariants/assumptions:

• Task IDs are unique within a queue file and across active/done files, except rejected tasks.
• Dependency and blocking graphs must remain acyclic.
• Warnings are non-blocking and may be logged separately by callers.

Structs

DependencyValidationResult

Result of dependency and relationship validation containing warnings.

ValidationWarning

Represents a validation issue that doesn’t prevent queue operation but should be reported.

Functions

log_warnings

Log all validation warnings.

validate_queue

Validate a single queue file.

validate_queue_set

Validate active and optional done queues together, returning non-blocking warnings.