Skip to content

cold_start

diapason.learning.spec_search.gate.cold_start

Cold start detection and bootstrap for the spec-search subsystem.

Day one: no traces, no benchmark. The system must not crash and must give the user a clear message about what's needed. This module provides readiness checks and the bootstrap logic.

See spec §13.

ReadinessResult dataclass

Result of a readiness check.

check_benchmark_ready(trace_store, min_feedback=0.7, min_samples=10)

Check if there are enough high-feedback traces for a benchmark.

The bootstrap benchmark needs at least min_samples traces with feedback >= min_feedback.

Parameters

trace_store : TraceStore instance. min_feedback : Minimum feedback score for benchmark-quality traces. min_samples : Minimum number of high-feedback traces needed.

check_readiness(trace_store, min_traces=20)

Check if there are enough traces to run a learning session.

Parameters

trace_store : TraceStore instance. min_traces : Minimum total trace count required.

Returns

ReadinessResult ready is True if there are enough traces.