Struct AiSynthesisDriver 

pub struct AiSynthesisDriver { /* private fields */ }

Machinery driving a single-module AI synthesis pass.

Holds an optional provider (behind a trait object), an optional content-addressed response cache, an optional manifest writer, and the synthesis configuration. The driver is constructed once per build and reused across modules.

Implementations

impl AiSynthesisDriver

pub fn deterministic(config: SynthesisConfig) -> Self

Constructs a driver with no provider — every flagged node falls through to Tier 2. Useful for --deterministic builds and for projects that haven’t configured an [ai] section.

pub fn new( provider: Arc<dyn AiProvider>, cache: Option<AiCache>, manifest: Option<Arc<Mutex<ManifestWriter>>>, config: SynthesisConfig, ) -> Self

Constructs a driver backed by provider, optionally with a response cache and a manifest writer.

pub fn with_rule_cache(self, rules: RuleCache) -> Self

Attach a RuleCache consulted before any AI call (§17.7).

On a rule hit the driver applies the template deterministically and records a RuleApplied decision instead of calling the provider — saving tokens on already-learned patterns. Intended for builder-style composition with Self::new or Self::deterministic.

pub fn rule_cache(&self) -> Option<&RuleCache>

Access the configured rule cache, if any.

pub fn manifest(&self) -> Option<&Arc<Mutex<ManifestWriter>>>

Access the configured manifest writer, if any.

pub fn config(&self) -> &SynthesisConfig

Borrow the active config (for diagnostics / tests).

pub async fn synthesize_module( &self, module: &AIRModule, target: &TargetProfile, ctx: &ModuleContext, ) -> Result<SynthesisStats, ManifestError>

Runs a full synthesis pass over module, respecting the target profile’s ai_hints and the driver’s configuration.

Errors

Only returns an error for manifest I/O failures. Every other failure is recorded in SynthesisStats so the caller can continue to Tier 2 rule-based generation.