Skip to main content

clark_autoresearch/
lib.rs

1//! Clean-room primitives for autonomous research loops.
2//!
3//! The crate models the reusable parts of autoresearch systems:
4//! experiment lineage, objective metrics, gates, outcomes, and frontier
5//! selection. It intentionally avoids host-specific agent execution and any
6//! scanner or exploit implementation so it can stay reusable and publishable.
7
8pub mod acceptance;
9pub mod adapter;
10pub mod cache;
11pub mod embedding;
12pub mod frontier;
13pub mod graph;
14pub mod ids;
15pub mod lm_loop;
16pub mod loop_opt;
17pub mod opportunity;
18pub mod outcome;
19pub mod pareto;
20pub mod policy;
21pub mod proposer;
22pub mod stop;
23
24pub use acceptance::{AcceptanceCriterion, AcceptanceVerdict};
25pub use adapter::{
26    Candidate, EvaluationBatch, GateRunner, ObjectiveScores, ReflectiveDataset, ReflectiveEntry,
27    ResearchAdapter,
28};
29pub use cache::{EvaluationCache, cached_evaluate, candidate_hash};
30pub use embedding::Embedder;
31pub use frontier::{FrontierStrategy, RankedCandidate, enforce_acceptance, rank_frontier};
32pub use graph::{
33    ExperimentGraph, ExperimentId, ExperimentNode, ExperimentStatus, GraphError, Hypothesis,
34    ResearchMode,
35};
36pub use lm_loop::{
37    AbsorbReport, ContextPack, EvidenceConfidence, ExperimentPlan, ExperimentState,
38    HypothesisCandidate, HypothesisState, LedgerEvent, Observation, ResearchDossier,
39    ResearchLedger, ResearchResult, ResultVerdict, WorkBudget, render_dossier,
40};
41pub use loop_opt::{OptimizationState, RejectionRecord, optimize};
42pub use opportunity::{
43    DispatchClass, DispatchHint, ResearchBias, ResearchOpportunity, SurfaceKind,
44    dispatch_class_for, rank_opportunities,
45};
46pub use outcome::{Metric, MetricDirection, Objectives, OutcomeStatus, TaskScore, TrialOutcome};
47pub use pareto::{FrontierKey, FrontierType, ParetoFront, non_dominated_set, pareto_front};
48pub use policy::{Gate, GateOutcome, GatePhase, ResearchPolicy};
49pub use proposer::{DEFAULT_REFLECTION_TEMPLATE, LanguageModel, Proposer, ReflectiveMutation};
50pub use stop::{LoopSnapshot, StopCondition};
51
52// Optional semantic-similarity re-exports (only with the `similarity` feature).
53#[cfg(feature = "similarity")]
54pub use cache::SemanticCandidateCache;
55#[cfg(feature = "similarity")]
56pub use lm_loop::{SemanticSketches, relevance_ranked_dossier};