Skip to content

vox-corpus API Reference (generated)

Crate: vox-corpus · Version: 0.6.0 · Target: Library (lib.rs)

Training data contracts, preflight, corpus SSOT, and Mens dataset metadata

Corpus crate for the Vox workspace: aggregates training data, MCP meta corpora, synthetic-search generators, tool-workflow corpora, and codegen-Vox samples. Used by vox-ml-cli and downstream training pipelines.

FeatureDefault / Enables
ast-extract—
databasedep:vox-db, dep:turso
parser-verifyast-extract
DependencyKind
vox-bounded-fsNormal
vox-compilerNormal
vox-dbNormal
vox-evalNormal
vox-kb-facetsNormal
vox-mcp-registryNormal
vox-repositoryNormal
ModuleDescription
arca_replay—
ast_mutator—
codegen_vox—
corpus—
dataset_snapshot—
external_review_replay—
flywheel—
humaneval_runner—
research_gen—
rust_to_vox—
synthetic_gen—
synthetic_search_gen—
tool_workflow_corpus—
training—
Dependency Topology, diagram 115 nodes, 14 edges: vox-corpus → vox-bounded-fs; vox-corpus → vox-compiler; vox-corpus → vox-db; vox-corpus → vox-eval; vox-corpus → vox-kb-facets; vox-corpus → vox-mcp-registry; vox-corpus → vox-repository; vox-cli → vox-corpus; vox-cli-research → vox-corpus; vox-cli-review → vox-corpus; vox-ml-cl…vox-corpusvox-bounded-fsvox-compilervox-dbvox-evalvox-kb-facetsvox-mcp-registryvox-repositoryvox-clivox-cli-researchvox-cli-reviewvox-ml-clivox-orchestratorvox-orchestrator-mcpvox-populi
Diagram source
graph {
direction: right
node vox_corpus: "vox-corpus"
node vox_bounded_fs: "vox-bounded-fs"
vox_corpus -> vox_bounded_fs
node vox_compiler: "vox-compiler"
vox_corpus -> vox_compiler
node vox_db: "vox-db"
vox_corpus -> vox_db
node vox_eval: "vox-eval"
vox_corpus -> vox_eval
node vox_kb_facets: "vox-kb-facets"
vox_corpus -> vox_kb_facets
node vox_mcp_registry: "vox-mcp-registry"
vox_corpus -> vox_mcp_registry
node vox_repository: "vox-repository"
vox_corpus -> vox_repository
node vox_cli: "vox-cli"
vox_cli -> vox_corpus
node vox_cli_research: "vox-cli-research"
vox_cli_research -> vox_corpus
node vox_cli_review: "vox-cli-review"
vox_cli_review -> vox_corpus
node vox_ml_cli: "vox-ml-cli"
vox_ml_cli -> vox_corpus
node vox_orchestrator: "vox-orchestrator"
vox_orchestrator -> vox_corpus
node vox_orchestrator_mcp: "vox-orchestrator-mcp"
vox_orchestrator_mcp -> vox_corpus
node vox_populi: "vox-populi"
vox_populi -> vox_corpus
}
Consumer CrateRole
vox-cliDirect workspace dependent
vox-cli-researchDirect workspace dependent
vox-cli-reviewDirect workspace dependent
vox-ml-cliDirect workspace dependent
vox-orchestratorDirect workspace dependent
vox-orchestrator-mcpDirect workspace dependent
vox-populiDirect workspace dependent
KindSymbolSignatureSourceDescription
structarca_replay::ReplayRowpub struct ReplayRowcrates/vox-corpus/src/arca_replay.rs#L9-L20Container for extracted real-world corpus rows from Arca telemetry.
fnarca_replay::extract_arca_pairspub async fn extract_arca_pairs(crates/vox-corpus/src/arca_replay.rs#L23—
fnarca_replay::to_training_record_v2pub fn to_training_record_v2(&self) -> Option<crate::training::TrainingRecordV2>crates/vox-corpus/src/arca_replay.rs#L360-L400Convert an Arca telemetry [ReplayRow] into a validated [crate::training::TrainingRecordV2] with secret redaction and safety-floor verification (CORPUS-04, CORPUS-06).
fnarca_replay::replay_snapshot_for_spokepub async fn replay_snapshot_for_spoke(crates/vox-corpus/src/arca_replay.rs#L406Deterministically replay verified [crate::training::TrainingRecordV2] records from a persisted VoxDb dataset snapshot, optionally filtered to a single [crate::training::SpokeKind] (CORPUS-06).
structast_mutator::Mutationpub struct Mutationcrates/vox-corpus/src/ast_mutator.rs#L7-L11—
fnast_mutator::generate_mutationspub fn generate_mutations(source: &str, _module: &Module) -> Vec<Mutation>crates/vox-corpus/src/ast_mutator.rs#L18-L55—
fnast_mutator::apply_mutationspub fn apply_mutations(source: &str, mut mutations: Vec<Mutation>) -> Stringcrates/vox-corpus/src/ast_mutator.rs#L57-L71—
fnast_mutator::mutate_corpuspub fn mutate_corpus(crates/vox-corpus/src/ast_mutator.rs#L73—
fnast_mutator::mint_hard_negative_dpo_pairpub fn mint_hard_negative_dpo_pair(crates/vox-corpus/src/ast_mutator.rs#L118Deterministic 5-spoke hard-negative mutation generator (AUDIT-03). Takes a verified positive [crate::training::contract::TrainingRecordV2] (chosen) and synthesizes a realistic hard-negative mutation (rejected) for the same spoke, verifying via the spoke’s round-trip oracle that rejected fails deterministically.
enumdataset_snapshot::SnapshotSourceClasspub enum SnapshotSourceClasscrates/vox-corpus/src/dataset_snapshot.rs#L8-L25Source class contributing rows to a snapshot.
structdataset_snapshot::SourceDigestpub struct SourceDigestcrates/vox-corpus/src/dataset_snapshot.rs#L29-L36Per-source digest and counts for reproducibility.
structdataset_snapshot::SplitPolicypub struct SplitPolicycrates/vox-corpus/src/dataset_snapshot.rs#L40-L47Training/eval split policy stored alongside the snapshot.
structdataset_snapshot::DatasetSnapshotManifestpub struct DatasetSnapshotManifestcrates/vox-corpus/src/dataset_snapshot.rs#L51-L68Full snapshot manifest written next to exported JSONL.
fndataset_snapshot::to_jsonpub fn to_json(&self) -> anyhow::Result<String>crates/vox-corpus/src/dataset_snapshot.rs#L72-L74Pretty-printed JSON for sidecar manifest.json next to JSONL exports.
fndataset_snapshot::create_snapshotpub fn create_snapshot(crates/vox-corpus/src/dataset_snapshot.rs#L77—
structdataset_snapshot::SpokeMixtureSummarypub struct SpokeMixtureSummarycrates/vox-corpus/src/dataset_snapshot.rs#L128-L135Per-spoke row count and canonical digest inside a [TrustyDatasetSnapshot] (CORPUS-06).
structdataset_snapshot::TrustyDatasetSnapshotpub struct TrustyDatasetSnapshotcrates/vox-corpus/src/dataset_snapshot.rs#L139-L154Immutable, Trusty-URI-identified multi-spoke dataset snapshot persisted in VoxDb (CORPUS-06).
fndataset_snapshot::build_trusty_snapshotpub fn build_trusty_snapshot(crates/vox-corpus/src/dataset_snapshot.rs#L162Construct a deterministic [TrustyDatasetSnapshot] and canonical JSONL bundle from verified [crate::training::TrainingRecordV2] records (CORPUS-06).
fndataset_snapshot::persist_snapshot_to_dbpub async fn persist_snapshot_to_db(crates/vox-corpus/src/dataset_snapshot.rs#L217Persist an immutable [TrustyDatasetSnapshot] and its [crate::training::TrainingRecordV2] rows into VoxDb (objects CAS + names binding + mens_corpus_quality rows) (CORPUS-06).
fndataset_snapshot::load_snapshot_from_dbpub async fn load_snapshot_from_db(crates/vox-corpus/src/dataset_snapshot.rs#L275Deterministically reload a [TrustyDatasetSnapshot] and its [crate::training::TrainingRecordV2] rows from VoxDb by snapshot_id or trusty_uri (CORPUS-06).
structexternal_review_replay::ExternalReviewReplayRowpub struct ExternalReviewReplayRowcrates/vox-corpus/src/external_review_replay.rs#L8-L21Canonical replay row for review-derived training/eval artifacts.
fnexternal_review_replay::extract_external_review_rowspub async fn extract_external_review_rows(crates/vox-corpus/src/external_review_replay.rs#L24—
fnexternal_review_replay::validate_external_review_rowspub fn validate_external_review_rows(rows: &[ExternalReviewReplayRow]) -> anyhow::Result<()>crates/vox-corpus/src/external_review_replay.rs#L103-L119Basic validation for exported rows.
fnexternal_review_replay::build_repeated_error_featurespub fn build_repeated_error_features(rows: &[ExternalReviewReplayRow]) -> Vec<serde_json::Value>crates/vox-corpus/src/external_review_replay.rs#L122-L151Build repeated-error features and hard negatives from review rows.
structflywheel::FlywheelConfigpub struct FlywheelConfigcrates/vox-corpus/src/flywheel.rs#L4-L18—
structflywheel::FlywheelDomainConfigpub struct FlywheelDomainConfigcrates/vox-corpus/src/flywheel.rs#L21-L24—
fnflywheel::loadpub fn load() -> Selfcrates/vox-corpus/src/flywheel.rs#L27-L35—
fnflywheel::for_domainpub fn for_domain(&self, domain: Option<&str>) -> Selfcrates/vox-corpus/src/flywheel.rs#L38-L51Resolve effective config for a specific domain.
enumflywheel::FlywheelSignalpub enum FlywheelSignalcrates/vox-corpus/src/flywheel.rs#L67-L72—
structflywheel::FlywheelStatepub struct FlywheelStatecrates/vox-corpus/src/flywheel.rs#L74-L78—
fnflywheel::newpub fn new(config: FlywheelConfig) -> Selfcrates/vox-corpus/src/flywheel.rs#L81-L87—
fnflywheel::checkpub fn check(&self, current_samples: usize, current_diversity: f64) -> FlywheelSignalcrates/vox-corpus/src/flywheel.rs#L89-L103—
fnflywheel::evaluate_readinesspub fn evaluate_readiness(crates/vox-corpus/src/flywheel.rs#L107—
structflywheel::LintFeedbackRecordpub struct LintFeedbackRecordcrates/vox-corpus/src/flywheel.rs#L160-L169Helper record for vox.lint.* telemetry outcomes feeding CR-L8 feedback.
structflywheel::RepairFeedbackRecordpub struct RepairFeedbackRecordcrates/vox-corpus/src/flywheel.rs#L173-L182Helper record for vox.repair.* telemetry outcomes feeding CR-L8 feedback.
fnflywheel::record_lint_finding_eventpub fn record_lint_finding_event(crates/vox-corpus/src/flywheel.rs#L185Atomically append a lint finding event to the corpus feedback events sink.
fnflywheel::record_repair_outcome_eventpub fn record_repair_outcome_event(crates/vox-corpus/src/flywheel.rs#L212Atomically append a repair outcome event to the corpus feedback events sink.
structflywheel::FlywheelCycleReceiptpub struct FlywheelCycleReceiptcrates/vox-corpus/src/flywheel.rs#L241-L260Receipt for one completed cycle (Cycle 0, Cycle 1, Cycle 2) of the Mens multi-spoke autonomous training & evaluation flywheel (LOOP-01..03).
structflywheel::MensFlywheelBurninReportV1pub struct MensFlywheelBurninReportV1crates/vox-corpus/src/flywheel.rs#L264-L273Full 2-cycle autonomous burn-in report (contracts/reports/mens-flywheel-burnin.v1.json) (LOOP-01..03).
fnflywheel::to_contract_summary_jsonpub fn to_contract_summary_json(&self) -> serde_json::Valuecrates/vox-corpus/src/flywheel.rs#L282-L303Project the full report into the compact summary stored in contracts/reports/mens-flywheel-burnin.v1.json.
fnflywheel::run_two_cycle_autonomous_burninpub fn run_two_cycle_autonomous_burnin() -> MensFlywheelBurninReportV1crates/vox-corpus/src/flywheel.rs#L309-L413Execute the closed-loop 2-cycle autonomous burn-in across all 5 spokes (LOOP-01..03).
fnflywheel::persist_burnin_report_to_dbpub async fn persist_burnin_report_to_db(crates/vox-corpus/src/flywheel.rs#L417Persist a [MensFlywheelBurninReportV1] into VoxDb CAS (LOOP-02).
fnflywheel::load_burnin_report_from_dbpub async fn load_burnin_report_from_db(crates/vox-corpus/src/flywheel.rs#L430Load a [MensFlywheelBurninReportV1] from VoxDb CAS by run_id (LOOP-02).
structflywheel::MensBeforeAfterSpokeDeltaV1pub struct MensBeforeAfterSpokeDeltaV1crates/vox-corpus/src/flywheel.rs#L447-L484Per-spoke before/mid/after benchmark delta row (MENS-PERF-02..03).
structflywheel::MensBeforeAfterEvaluationV1pub struct MensBeforeAfterEvaluationV1crates/vox-corpus/src/flywheel.rs#L488-L529Full 25-problem 5-spoke before/after evaluation report (contracts/reports/mens-before-after-comparison.v1.json) (MENS-PERF-01..04).