v1.1.0: pooled runtime, 959 tests, production hardening (0 squash)

2025-08-15 10:00:00 -07:00
commit 92deb689cd
321 changed files with 79170 additions and 0 deletions
@@ -0,0 +1,85 @@
+/**
+ * Property run result contracts.
+ *
+ * These interfaces materialize Invariant 6: every result must clearly say
+ * whether it is scene-determinate, scene-indeterminate, enumerated-determinate,
+ * or sampled. The mode field is a literal discriminant so switch-exhaustiveness
+ * checking works.
+ */
+
+import type { ImhotepId } from './types.js'
+
+// ---------------------------------------------------------------------------
+// SampledRunResult
+// ---------------------------------------------------------------------------
+
+export interface SampledRunResult {
+  mode: 'sampled'
+  seed: number
+  numRuns: number
+  passed: boolean
+  counterexample?: unknown
+  shrunkCounterexample?: unknown
+  failingScene?: unknown
+  diagnostics: unknown[]
+  // P1.3 Property-Run Reporting Upgrade
+  minimalFailingCase?: unknown
+  caseIndex?: number
+  durationMs?: number
+  replayPayload?: { props: unknown; seed: number; caseIndex: number }
+}
+
+// ---------------------------------------------------------------------------
+// EnumeratedRunResult
+// ---------------------------------------------------------------------------
+
+export interface EnumeratedRunResult {
+  mode: 'enumerated-determinate'
+  totalCases: number
+  passed: boolean
+  failingCase?: unknown
+  diagnostics: unknown[]
+  // P1.3 Property-Run Reporting Upgrade
+  minimalFailingCase?: unknown
+  caseIndex?: number
+  seed?: number
+  durationMs?: number
+  replayPayload?: { props: unknown; seed: number; caseIndex: number }
+}
+
+// ---------------------------------------------------------------------------
+// Scene Evaluation Results (for completeness in the taxonomy)
+// ---------------------------------------------------------------------------
+
+export interface DeterministicSceneResult {
+  mode: 'scene-determinate' | 'scene-indeterminate'
+  sceneId: ImhotepId
+  results: unknown[]
+  proofs: unknown[]
+  diagnostics: unknown[]
+}
+
+// ---------------------------------------------------------------------------
+// Union type for any property or scene run result
+// ---------------------------------------------------------------------------
+
+export type PropertyRunResult =
+  | SampledRunResult
+  | EnumeratedRunResult
+  | DeterministicSceneResult
+
+// ---------------------------------------------------------------------------
+// Type Guards
+// ---------------------------------------------------------------------------
+
+export function isSampledRunResult(result: PropertyRunResult): result is SampledRunResult {
+  return result.mode === 'sampled'
+}
+
+export function isEnumeratedRunResult(result: PropertyRunResult): result is EnumeratedRunResult {
+  return result.mode === 'enumerated-determinate'
+}
+
+export function isDeterministicSceneResult(result: PropertyRunResult): result is DeterministicSceneResult {
+  return result.mode === 'scene-determinate' || result.mode === 'scene-indeterminate'
+}