conformance

type Capability uint32

type Harness struct {
	// Factory constructs a fresh planner instance per subtest. Used
	// by scenarios that do NOT need a scenario-specific planner
	// configuration (Sanity, WakeMode_Declared, Sealed_DecisionSum,
	// Steering_DrainBetweenSteps, ConcurrentReuse_D025). When
	// ScenarioFactory is non-nil, scenarios that need a tailored
	// planner consume it instead.
	Factory func() planner.Planner

	// ScenarioFactory, when non-nil, takes a ScenarioName and returns
	// a planner pre-configured for that scenario. Used by scenarios
	// like TopPrompts_LLMRoundTrip (ReAct needs a specific mock-LLM
	// envelope per scenario) and ParallelCall_Atomicity (Deterministic
	// needs a CallParallel-emitting step). Fallback when nil: the
	// scenario uses `Factory()`.
	ScenarioFactory PlannerFactoryFn

	// WakeMode is the wake mode the concrete declares (D-032). The
	// WakeMode_Declared scenario asserts the planner's
	// `ResolveWakeMode` agrees; the WakeMode_RoundTrip scenario
	// drives the corresponding round-trip path (push vs poll).
	WakeMode planner.WakeMode

	// RunContextFactory builds the minimal valid RunContext the
	// concrete needs. Required at Phase 49 — every concrete now
	// validates identity at Next boundary (§6 rule 9 + D-001).
	RunContextFactory func() planner.RunContext

	// Capabilities is the planner's declared capability set. The
	// pack uses the bitmask to gate scenarios — a scenario whose
	// required capability is absent skips with a reason.
	Capabilities Capability

	// TaskRegistryFactory, when non-nil, builds the real
	// `tasks.TaskRegistry` (production inprocess driver) the
	// WakeMode_RoundTrip scenario drives. The factory also wires a
	// real `events.EventBus` since the registry needs one (D-032 +
	// §17.3 #1 — no mocks at the seam).
	//
	// The pack ships a default factory (`DefaultTaskRegistryFactory`)
	// that opens an inmem bus + inprocess registry + inmem state
	// store; per-concrete tests typically set this to the default.
	TaskRegistryFactory func(t *testing.T) (*WakeRoundTripDeps, func())

	// PrebuiltPlannerFactory is the optional hook the
	// WakeMode_RoundTrip scenario consumes when the concrete planner
	// must be constructed AGAINST a pre-existing TaskRegistry (the
	// Deterministic planner binds its registry at construction time
	// via `deterministic.WithRegistry`). When nil, the scenario falls
	// back to the standard Factory and assumes the planner does NOT
	// need a pre-bound registry (ReAct's case — its emission path is
	// LLM-prompted, no registry binding at construction).
	PrebuiltPlannerFactory func(*WakeRoundTripDeps) planner.Planner

	// Cleanup is called at subtest end. Optional — typical for
	// planner concretes that hold lifecycle resources.
	Cleanup func()
}

type PlannerFactoryFn func(scenario ScenarioName) planner.Planner

type ScenarioContentMap map[ScenarioName]string

type ScenarioName string

type WakeRoundTripDeps struct {
	Bus      events.EventBus
	Registry tasks.TaskRegistry
	State    state.StateStore
}