The ns diff command compares two sealed .nsz telemetry artifacts. It computes layer-wise activation similarity, quality score variance, step-by-step latency deltas, and token cost differences.
Synopsis
terminal
bash
ns diff <baseline.nsz> <candidate.nsz> [--metric cosine|l2|cka] [--report FILE] [--strict]Flags & Metrics
--metric— Distance metric (cosine,l2,cka). Default:cosine.--report FILE— Generate HTML or Markdown comparison report.--strict— Fail with non-zero exit code if quality or latency regression exceeds threshold.--json— Output machine-readable JSON summary for CI automation scripts.
Report Outputs
terminal
bash
$ns diff baseline.nsz candidate.nsz --report diff_summary.md$cat diff_summary.md | head -10# Telemetry Diff — baseline.nsz vs candidate.nsz
Aligned: 32/32 layers, 128/128 steps
Max Latency Delta: +12ms at step 4 (RAG Vector Query)