`9e97f1b`

core/result: ProbeResult.ci_95 + safe_finalize passthrough (null-safe)

Authored by mfwolffe <wolffemf@dukes.jmu.edu> 3 weeks ago

SHA: 9e97f1bd59a7c30bd4702a68b33ff3c8900d2e69
Parents: fd975b7
Tree: ce53d6c

1 changed file

Status	File	+	-
M	`src/dlm_sway/core/result.py`	17	0

src/dlm_sway/core/result.pymodified

          One-line diagnostic. Surfaces in the terminal report.
      duration_s:
          Wall time to execute.
 +    ci_95:
 +        95% percentile-bootstrap confidence interval on :attr:`raw`.
 +        Populated by aggregating probes (``delta_kl`` over N prompts,
 +        ``calibration_drift`` over pack items, etc.) via
 +        :func:`dlm_sway.core.stats.bootstrap_ci`. ``None`` when the
 +        probe doesn't aggregate (``adapter_ablation``,
 +        ``style_fingerprint``), when the sample count is too low to
 +        bootstrap meaningfully, or when the raw value isn't finite.
 +        Report surfaces it inline as ``raw [lo–hi]``.
      """
      name: str
      evidence: dict[str, Any] = field(default_factory=dict)
      message: str = ""
      duration_s: float = 0.0
 +    ci_95: tuple[float, float] | None = None
  @dataclass(frozen=True, slots=True)
      evidence: dict[str, Any] | None = None,
      message: str = "",
      duration_s: float = 0.0,
 +    ci_95: tuple[float, float] | None = None,
      critical_fields: tuple[str, ...] = ("raw",),
  ) -> ProbeResult:
      """Build a :class:`ProbeResult` with defense against non-finite metrics.
          for fname in non_finite:
              numeric_kwargs[fname] = None
 +    # ``ci_95`` is only attached when ``raw`` survived the
 +    # defensive-null sweep — a CI bracketing a nulled-out point
 +    # estimate would mislead more than it informs.
 +    final_ci_95 = ci_95 if numeric_kwargs["raw"] is not None else None
++
      return ProbeResult(
          name=name,
          kind=kind,
          evidence=ev,
          message=message,
          duration_s=duration_s,
 +        ci_95=final_ci_95,
+     )