DAG Operations
Deterministic DAG infrastructure operations for workflow execution.
Overview
This skill wraps the hil-dag CLI from the humaninloop_brain package, providing the DAG Assembler and State Analyst agents with deterministic graph operations: assembly (with auto-bootstrap), validation, sorting, status updates, analysis recording, and pass freezing.
Available Operations
| Operation | Script | Purpose |
|---|---|---|
assemble | dag-assemble.sh | Add a catalog node with edge inference (auto-creates StrategyGraph if missing) |
validate | dag-validate.sh | Run structural validation |
sort | dag-sort.sh | Topological execution order |
status | dag-status.sh | Update node status |
record | dag-record.sh | Record analysis results (status + evidence + trace) |
freeze | dag-freeze.sh | Freeze a completed pass (with triggered_by edges and next pass creation) |
catalog-validate | dag-catalog-validate.sh | Validate a node catalog |
Output Format
All operations produce JSON to stdout following the constitution pattern:
{
"status": "valid|invalid|success|error",
"checks": [...],
"summary": {"total": N, "passed": M, "failed": K}
}
Exit codes: 0=success, 1=validation failure, 2=unexpected error.
Usage
Scripts are invoked by the DAG Assembler agent during workflow execution. The agent passes file paths to the single StrategyGraph JSON file and catalog JSON files.
# Add a node by ID (auto-creates StrategyGraph if file missing; --workflow required for first call)
./scripts/dag-assemble.sh <dag-path> <catalog-path> --node <node-id> [--workflow <workflow-id>]
# Add a node by capability tags (primary resolution — resolves to catalog node via tag matching)
./scripts/dag-assemble.sh <dag-path> <catalog-path> --capability-tags <tag1> [<tag2>...] [--node-type <type>] [--intent "<description>"] [--workflow <workflow-id>]
# Validate
./scripts/dag-validate.sh <dag-path> <catalog-path>
# Sort
./scripts/dag-sort.sh <dag-path>
# Update status (optional --pass to target specific pass)
./scripts/dag-status.sh <dag-path> <node-id> <new-status> [<pass-number>]
# Record analysis results (optional --pass and --verdict for gate nodes)
./scripts/dag-record.sh <dag-path> <node-id> <status> '<evidence-json-array>' '<trace-json-object>' [--pass <pass-number>] [--verdict <verdict>]
# Freeze (optional triggered nodes, trigger source gate, and reason for triggered_by edges)
./scripts/dag-freeze.sh <dag-path> <outcome> <detail> [--triggered-nodes <node>...] [--trigger-source <gate-node>] [--reason <reason>]
# Validate catalog
./scripts/dag-catalog-validate.sh <catalog-path>
Dependencies
Requires the humaninloop_brain package (>= 0.1.0) to be installed. Run from the humaninloop_brain/ directory or ensure hil-dag is on PATH:
cd humaninloop_brain && uv sync