DAG Handbook

bijux-dag is the graph execution and evidence subsystem in bijux-core. It owns deterministic DAG semantics, run/artifact identity, replay classification, and diff classification.

This handbook is optimized for operational questions that need hard answers:

• what changed (graph, run, or artifact)
• whether replay stayed equivalent, drifted, or is incomplete
• where ownership boundaries are between DAG crates

Open the kernel package Open the runtime package Open the app package

Visual Summary

flowchart TB
    handbook["DAG handbook"]
    handbook --> core["bijux-dag-core"]
    handbook --> runtime["bijux-dag-runtime"]
    handbook --> app["bijux-dag-app"]
    handbook --> cli["bijux-dag-cli"]
    handbook --> artifacts["bijux-dag-artifacts"]
    handbook --> testkit["bijux-dag-testkit"]

Package Destinations

• bijux-dag-core owns graph truth and planner lowering
• bijux-dag-runtime owns execution policy, replay, and diagnostics
• bijux-dag-app owns command orchestration and response shaping
• bijux-dag-cli owns the thin executable wrapper
• bijux-dag-artifacts owns artifact identity, integrity, and lifecycle helpers
• bijux-dag-testkit owns shared deterministic fixtures

Code Anchors

• crates/bijux-dag-cli/src/main.rs
• crates/bijux-dag-app/src/
• crates/bijux-dag-core/src/
• crates/bijux-dag-runtime/src/
• crates/bijux-dag-artifacts/src/

Main Paths

• Foundation
• Architecture
• Interfaces
• Operations
• Quality

Related Handbooks

• Repository Handbook
• CLI Handbook
• Maintainer Handbook