Skip to main content

Module evolution

Module evolution 

Source
Expand description

Evolution wiring connecting workflow runtime to observation, cost, context, and strategy ports.

§Architecture & Governance

In accordance with docs/plans/Plan.md T07.2, D09, and D21:

  • Connects observation, cost, context, and strategy into existing workflow callbacks.
  • The Assistant receives usable facts and actionable suggestions via callbacks.
  • Strategy versions (from T06.1) feed selection without granting execution permission. Every StrategySuggestion explicitly marks has_execution_permission: false. The configured choice and the adopted default decide first; with neither, the selection is routed by the candidate policy (licoup_model_catalog::candidate_routing) over the same candidate catalog and the effective scope admission, so an alternative the policy does not allow is never suggested — including the first entry of the list, which is not a decision.
  • Permission, version, and resource recheck is strictly evaluated before any effect execution through EffectRecheckContext::for_run_command, the single construction path used by the executor.
  • Group B (economics loop, T03–T06) is a separate Draft: integration seams are strictly typed and wired against existing host-side seams, with gaps explicitly recorded in GroupBIntegrationGaps.

Structs§

AdoptedPlanningDefaultSeam
AgentModelOptionSeam
BudgetPoolReservationSeam
CallbackContextFacts
CallbackEvolutionEnricher
CallbackEvolutionPayload
CallbackFacts
CallbackObservationFacts
CallbackSuggestions
ContextManifestSummarySeam
DefaultEvolutionContextPort
DefaultEvolutionObservationPort
DefaultEvolutionStrategyPort
EffectRecheckContext
Context evaluated immediately prior to executing any effect.
EffectRecheckReceipt
GroupBGapReport
Recorded status and gaps for the separate Group B (economics loop, T03–T06) Draft.
GroupBIntegrationGaps
LedgerEvolutionCostPort
NodeObservationSummary
ObservationFactRecordSeam
ObservationScopeSeam
PlanningScopeSeam
SourceRefSeam
StrategySourceSeam
StrategySuggestion
A strategy suggestion presented to the run’s decider.
StrategyVersionSeam

Enums§

EffectRecheckFailure
ObservationFactKindSeam

Traits§

EvolutionContextPort
EvolutionCostPort
EvolutionObservationPort
EvolutionStrategyPort

Functions§

recheck_before_effect
Recheck permission, version, and resources before executing any effect.

Type Aliases§

CallbackCostFacts
The callback’s cost reading. The fields are the engine’s; the name this host’s callback envelope knows them by is its own.