Skip to content

feat: add inference setup and baseline experiment contract - #14

Merged
Jammy2211 merged 1 commit into
mainfrom
feature/inference-setup-contract
Oct 8, 2026
Merged

Jammy2211 merged 1 commit into
mainfrom
feature/inference-setup-contract

Conversation

@Jammy2211

Copy link
Copy Markdown
Contributor

Inference records currently lack a stable setup/prepared-problem contract, so consumers cannot reliably distinguish sampler cold starts, baseline-informed warm starts and checkpoint resumptions. This adds inference-summary@2 alongside v1, with validated baseline-stage/artifact references, separate preparation and initialization clocks, and explicit work-unit definitions.

Comparisons refuse mismatched or unknown start/environment/problem conditions. Archived or unassessed baseline candidates remain visible but cannot become selected trusted references. The live registry stays on v1 until the producer and consumer migration; this is phase 1 of the approved setup-oriented redesign.

Scripts Changed

  • insight/catalogue.py: setup, prepared problem, initialization provenance and comparison validation.
  • insight/summary.py: v1/v2 routing and comparison integration.
  • REFERENCE.md: producer contract and staged migration.
  • tests/test_catalogue.py, tests/fixtures/lens_summary_v2.json: synthetic baseline/cold/warm/resume evidence, malformed inputs, compatibility and immutable ingest/cache replay.

Validation

  • 157 tests passed (python -m pytest tests -q).
  • ruff check . and ruff format --check . passed.
  • bin/pyauto-insight check --offline passed against the unchanged 56-record v1 capture.
  • git diff --check passed.
  • Heart readiness: STALE (85); exact reason: release validation incomplete: no rehearsal for current source. No red/yellow reasons; freeze clear. Development shipping allowed by the Heart contract; this is not release readiness.

Limits and next phases

Artifact hashes and scientific identities are producer declarations; the executor must verify bytes before reuse. No scientific runs, baseline acceptance, new sampler integration or dashboard redesign occurs in this reader-first phase. Producer/script migration, setup UI, assistant/wiki lookup and curated literature candidates remain tracked in the Mind umbrella draft/feature/pyautoinsight/inference_setup_redesign.md and must coordinate with the existing search-extensibility epic.

Tier: judge — human /prm; no merge authorization.

Closes #13.

Accept inference-summary v2 alongside v1. Preserve prepared-problem and baseline provenance, distinguish cold/warm/resume from compilation/cache state, and refuse incompatible cost comparisons.

Agent: Codex; model: GPT-6
@Jammy2211
Jammy2211 merged commit 2d6ea0e into main Oct 8, 2026
2 checks passed
@Jammy2211
Jammy2211 deleted the feature/inference-setup-contract branch October 8, 2026 08:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat: add inference setup and baseline experiment contract

1 participant