On this docs

Signals and risk levels

Nuky emits a deterministic diff summary for CI and review. The NUKY_SUMMARY line reports counts, not decisions.

Signals and risk levels

  • CONTRACT_CHANGEHigh Risk

    API hash or callable identity changed.

  • BEHAVIOR_CHANGEMedium Risk

    Logic hash changed while API hash stayed stable.

  • REFACTOR_ONLYLow Risk

    Hashes are stable; only normalization or metadata changed.

Risk in Nuky is a classification — not a warning.

It describes what changed, deterministically.

Gating and policy decisions stay explicit and external to Nuky.

Risk levels are derived from the hash model: API or identity changes are contract changes; logic hash changes with stable API are behavior changes; stable hashes indicate refactor-only changes.

Added and removed

ADDED and REMOVED count callables that appear only in the new or old scan, respectively.

NUKY_SUMMARY line

Every diff prints a stable, machine-readable summary line intended for CI parsing.

NUKY_SUMMARY CONTRACT_CHANGE=0 BEHAVIOR_CHANGE=6 REFACTOR_ONLY=0 ADDED=1 REMOVED=1

The line is printed exactly once per diff and is stable within v1.

diff_summary.txt

The human-readable summary is written to .nuky/out/diff_summary.txt. Sections print in a stable order: Added, Removed, Changed (High), Changed (Medium), Changed (Low).