On this docs

What Nuky reports

Nuky reports semantic changes in code and emits deterministic artifacts for CI and review. These docs map to the normative behavior in docs/.

Core ideas

  • Stable callable identity with optional UIDs that survive renames and moves.
  • Dual-hash change detection that separates contract changes from behavior changes.
  • Deterministic diff outputs: JSON artifacts plus a stable NUKY_SUMMARY line.

Nuky is not a policy or enforcement framework.

It emits deterministic classifications and artifacts for CI and review.

Any gate or decision remains explicit and external to Nuky.

Doc map

Start with the shortest path to a diff, then dig into how the signals are computed.