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
StrategySuggestionexplicitly markshas_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§
- Adopted
Planning Default Seam - Agent
Model Option Seam - Budget
Pool Reservation Seam - Callback
Context Facts - Callback
Evolution Enricher - Callback
Evolution Payload - Callback
Facts - Callback
Observation Facts - Callback
Suggestions - Context
Manifest Summary Seam - Default
Evolution Context Port - Default
Evolution Observation Port - Default
Evolution Strategy Port - Effect
Recheck Context - Context evaluated immediately prior to executing any effect.
- Effect
Recheck Receipt - GroupB
GapReport - Recorded status and gaps for the separate Group B (economics loop, T03–T06) Draft.
- GroupB
Integration Gaps - Ledger
Evolution Cost Port - Node
Observation Summary - Observation
Fact Record Seam - Observation
Scope Seam - Planning
Scope Seam - Source
RefSeam - Strategy
Source Seam - Strategy
Suggestion - A strategy suggestion presented to the run’s decider.
- Strategy
Version Seam
Enums§
Traits§
Functions§
- recheck_
before_ effect - Recheck permission, version, and resources before executing any effect.
Type Aliases§
- Callback
Cost Facts - The callback’s cost reading. The fields are the engine’s; the name this host’s callback envelope knows them by is its own.