Struct ContextForgeBuilder 

pub struct ContextForgeBuilder { /* private fields */ }

Builder for ContextForge.

The builder always pre-seeds DefaultEnglishScorer so plain-English importance signals (“confirmed”, “we decided”, “never mind”, etc.) are active without any additional configuration. A caller-provided persona scorer is optional and stacks additively on top via CompositeLexiconScorer.

Example

use context_forge::{Config, ContextForge, ConfigLexiconScorer};
use std::path::PathBuf;

#[tokio::main]
async fn main() -> Result<(), context_forge::Error> {
    let mut config = Config::default();
    config.db_path = PathBuf::from("memory.db");

    // English scorer only (most common case):
    let cf = ContextForge::builder(config.clone()).build().await?;

    // English + persona scorer loaded from a TOML string:
    let toml = "[affirmations]\npatterns = [\"for the emperor\"]";
    let persona: ConfigLexiconScorer = toml.parse()?;
    let cf = ContextForge::builder(config).with_persona_scorer(persona).build().await?;

    Ok(())
}

Implementations

impl ContextForgeBuilder

pub fn new(config: Config) -> Self

Create a new builder with the given config.

Prefer ContextForge::builder over calling this directly.

pub fn with_persona_scorer(self, scorer: impl LexiconScorer + 'static) -> Self

Stack a persona scorer on top of the always-on DefaultEnglishScorer.

The persona scorer is typically a crate::ConfigLexiconScorer loaded from a domain-specific TOML file. Its boosts are summed with the English layer; the engine applies a -1.0 floor after fusion.

pub async fn build(self) -> Result<ContextForge>

Open the database and build a ContextForge with the configured scorer.

The DefaultEnglishScorer is always included. If Self::with_persona_scorer was called, both scorers are composed via CompositeLexiconScorer.

Errors

Returns an error if the database cannot be opened or migrations fail.