Skip to Content
ReferenceTools

cpl explain

The normative description of each tool.

Normative text from spec/tools/explain.md.

Status: draft for 0.3.0. The report every implicit choice owes the contestant (AGENTS.md "nothing secret under the hood"). Its content is defined by core/13-lowering.md §13.6; the LSP shows the same data.

$ cpl explain d dist
dist: [V]?Int
  element  8 B, None = Int.MIN
  count    V.count <= 2e5   peak 1.6 MB
$ cpl explain d Ev
Ev  8 B  (Ask: l @0 4 B, r @4 4 B; Add: v @0, r = 0xFFFFFFFF)
?Ev 8 B  None = r 0xFFFFFFFE
$ cpl explain d st
st: SegTree(max, a, act: add)   iterative, no push-down (add commutes)
  nodes 4 B x 2^19 = 2 MB       (max is Selective over 1..=1e9)

Sections: types (size, storage order, padding, niches), arrays (width, peak bytes, wide_array and padding notes with fixes), memory total against the profile, specializations and the laws or bounds that chose them, remaining checks per build, contexts and generic instances with output bytes, unsafe-tier sites. --json for tools.