CommandStablesince v0.5.0

ns diff

Compare two .nsz artifacts and emit a report. Enforces architecture-fingerprint compatibility before running any metric.

Audience: All usersRead: 4 minSource

Synopsis

shellbash
ns diff <a.nsz> <b.nsz> [--metric cosine|l2|cka] [--report FILE]

Flags

  • --metric — comparison metric. Default: cosine.
  • --report FILE — write an HTML report; otherwise prints a summary table.
  • --alignment FILE — JSON map for cross-implementation layer alignment.
  • --json — machine-readable output on stdout (for CI).

Output

The summary prints per-layer metric values, aggregated by block. Exit code is 0for a valid comparison regardless of similarity; a mismatch in architecture fingerprint exits 3.

Related