Crate candle_graph 

TensorFlow Profiler-style execution graphs for Candle runs.

Record one representative JSONL trace with instrument::TraceSession, qualify its structural health and evidence capabilities with evidence::build_evidence, and inspect it through the CLI or, with the visualizer feature, viewer::render_evidence_html.

There is no static Rust analysis — the graph comes only from what executed.

Keep these evidence planes distinct:

• span duration is host timing unless the producer declares stronger synchronization semantics;
• timing device intervals retain their own device clock;
• trace::memory logical storage lifetimes do not imply physical allocator usage; and
• optional nsight evidence retains the Nsight clock and artifact provenance.

Failed or structurally invalid captures remain diagnostic but do not produce a derived graph::ExecutionGraph. Finalized evidence can be published and deeply verified through artifact, while eligible repeated timing comparisons require verified bundles through comparison.

Re-exports

pub use artifact::publish_bundle;

pub use artifact::verify_bundle;

pub use artifact::BundleManifest;

pub use artifact::BundleVerificationReceipt;

pub use artifact::SCHEMA as BUNDLE_SCHEMA;

pub use campaign::build_series;

pub use campaign::campaign_status;

pub use campaign::CampaignManifest;

pub use campaign::CampaignStatus;

pub use campaign::CaptureState;

pub use campaign::CaptureStatus;

pub use campaign::PlannedCapture;

pub use campaign::SeriesReport;

pub use campaign::CAMPAIGN_SCHEMA;

pub use campaign::CAMPAIGN_STATUS_SCHEMA;

pub use campaign::SERIES_SCHEMA;

pub use capability::CaptureContract;

pub use capability::CoverageLevel;

pub use capability::ExpectedGradient;

pub use capability::GradientContract;

pub use capability::GradientFamilyContract;

pub use capability::GradientFamilyExpectation;

pub use capability::MeasurementScope;

pub use capability::GRADIENT_MANIFEST_SCHEMA;

pub use comparison::compare_unverified_traces;

pub use comparison::compare_verified_bundles;

pub use comparison::ComparisonInputVerification;

pub use comparison::ComparisonInputs;

pub use comparison::ComparisonReason;

pub use comparison::ComparisonReasonCode;

pub use comparison::ComparisonVerdict;

pub use comparison::ReplicatedComparison;

pub use comparison::TensorStatsComparison;

pub use comparison::TensorStatsComparisonRow;

pub use comparison::VerifiedBundleInput;

pub use comparison::SCHEMA as COMPARISON_SCHEMA;

pub use evidence::build_evidence;

pub use evidence::EvidencePacket;

pub use evidence::SCHEMA as EVIDENCE_SCHEMA;

pub use graph::build_from_trace;

pub use graph::ExecutionGraph;

pub use graph::SCHEMA as GRAPH_SCHEMA;

pub use instrument::candle;

pub use instrument::CaptureSelector;

pub use instrument::DeviceIntervalRecord;

pub use instrument::DeviceMemoryRecord;

pub use instrument::MemoryRecord;

pub use instrument::OpRecord;

pub use instrument::ProfileRun;

pub use instrument::SpanGuard;

pub use instrument::SpanId;

pub use instrument::SpanKind;

pub use instrument::TensorRecord;

pub use instrument::TraceSession;

pub use nsight::GpuEvidenceStatus;

pub use nsight::NsightEvidence;

pub use phase::ExecutionPhase;

pub use phase::ExecutionStep;

pub use publication::reconcile_published_bundle;

pub use publication::CaptureBegin;

pub use publication::CaptureRun;

pub use publication::PublicationReceipt;

pub use publication::PublicationStatus;

pub use publication::PUBLICATION_SCHEMA;

pub use trace::parse_trace;

pub use trace::write_jsonl;

pub use trace::TraceDocument;

pub use trace::TraceEvent;

pub use trace::SCHEMA as TRACE_SCHEMA;

pub use trace::ComparisonIdentity;

pub use trace::TimingMode;

Modules

artifact

Atomic publication of self-contained, content-addressed evidence bundles.

campaign

Application-neutral campaign/series layer over published evidence bundles.

capability

Typed coverage and capability states used across capture, analysis, and comparison.

cli

Trace-file CLI helpers.

comparison

Fail-closed replicated performance comparisons.

evidence

Capability-qualified evidence packet shared by the CLI, bundles, and viewer.

graph

Execution graph derived purely from trace documents.

instrument

Post-run trace instrumentation — TensorFlow Profiler-style span API.

nsight

Stable normalization seam for official nsys stats --format csv reports.

phase

Train vs inference execution phase for trace metadata.

publication

Canonical capture-to-bundle publication with idempotent crash reconciliation.

timing

Separate host and device timing planes with overlap-safe device aggregation.

trace

TensorFlow-Profiler-style trace protocol (candle-graph/trace/10).

viewer

Dependency-free interactive HTML visualizer for candle-graph/viewer/5 evidence payloads.