render_churn_harness

Deterministic render-churn reduction harness for M36.

Types

Budget

Per-scenario churn budgets.

pub type Budget {
  Budget(
    scenario: Scenario,
    min_patch_bytes_reduction: Int,
    min_root_churn_reduction: Int,
    min_patch_count_reduction: Int,
  )
}

Constructors

Budget(
  scenario: Scenario,
  min_patch_bytes_reduction: Int,
  min_root_churn_reduction: Int,
  min_patch_count_reduction: Int,
)

BudgetResult

One budget-check result.

pub type BudgetResult {
  BudgetResult(scenario: Scenario, passed: Bool, reason: String)
}

Constructors

BudgetResult(scenario: Scenario, passed: Bool, reason: String)

Metrics

Churn metrics for one scenario run.

pub type Metrics {
  Metrics(
    total_events: Int,
    total_patches: Int,
    total_patch_bytes: Int,
    avg_patch_bytes: Int,
    root_churn_events: Int,
    keyed_patch_ops: Int,
    reorder_ops: Int,
  )
}

Constructors

Metrics(
  total_events: Int,
  total_patches: Int,
  total_patch_bytes: Int,
  avg_patch_bytes: Int,
  root_churn_events: Int,
  keyed_patch_ops: Int,
  reorder_ops: Int,
)

Report

Full M36 report.

pub type Report {
  Report(
    outcomes: List(ScenarioOutcome),
    budget_results: List(BudgetResult),
    failed_scenarios: Int,
    nondeterministic_failures: Int,
    failed_budgets: Int,
  )
}

Constructors

Report(
  outcomes: List(ScenarioOutcome),
  budget_results: List(BudgetResult),
  failed_scenarios: Int,
  nondeterministic_failures: Int,
  failed_budgets: Int,
)

Scenario

M36 churn scenarios.

pub type Scenario {
  CounterBurstTraffic
  StreamBurstTraffic
  FormBurstTraffic
}

Constructors

```
CounterBurstTraffic
```
```
StreamBurstTraffic
```
```
FormBurstTraffic
```

ScenarioOutcome

One M36 scenario outcome.

pub type ScenarioOutcome {
  ScenarioOutcome(
    scenario: Scenario,
    passed: Bool,
    deterministic: Bool,
    signature: String,
    baseline: Metrics,
    optimized: Metrics,
  )
}

Constructors

ScenarioOutcome(
  scenario: Scenario,
  passed: Bool,
  deterministic: Bool,
  signature: String,
  baseline: Metrics,
  optimized: Metrics,
)

Values

baseline_metrics

pub fn baseline_metrics(outcome: ScenarioOutcome) -> Metrics

Baseline metrics accessor.

budget_failures

pub fn budget_failures(results: List(BudgetResult)) -> Int

Count failing budgets.

budget_results

pub fn budget_results(report: Report) -> List(BudgetResult)

Report budget-results accessor.

budget_version

pub const budget_version: Int

budget_version_label

pub fn budget_version_label() -> String

M36 budget profile version label.

default_budget

pub fn default_budget() -> List(Budget)

Default deterministic M36 budget profile.

deterministic

pub fn deterministic(outcome: ScenarioOutcome) -> Bool

Determinism accessor.

evaluate_budget

pub fn evaluate_budget(
  outcomes: List(ScenarioOutcome),
  budgets: List(Budget),
) -> List(BudgetResult)

Evaluate outcomes against budgets.

failed_budgets

pub fn failed_budgets(report: Report) -> Int

Failed budget count.

failed_scenarios

pub fn failed_scenarios(report: Report) -> Int

Failed scenario count.

metrics_signature

pub fn metrics_signature(metrics: Metrics) -> String

Stable metrics signature.

nondeterministic_failures

pub fn nondeterministic_failures(report: Report) -> Int

Nondeterministic failures count.

optimized_metrics

pub fn optimized_metrics(outcome: ScenarioOutcome) -> Metrics

Optimized metrics accessor.

outcomes

pub fn outcomes(report: Report) -> List(ScenarioOutcome)

Report outcomes accessor.

pass_fail_label

pub fn pass_fail_label(outcome: ScenarioOutcome) -> String

Stable pass/fail label.

report_signature

pub fn report_signature(report: Report) -> String

Stable report signature.

run_matrix

pub fn run_matrix() -> Report

Run all M36 scenarios and evaluate budgets.

run_scenario

pub fn run_scenario(scenario: Scenario) -> ScenarioOutcome

Run one scenario twice and require deterministic parity.

scenario

pub fn scenario(outcome: ScenarioOutcome) -> Scenario

Scenario accessor.

scenario_label

pub fn scenario_label(scenario: Scenario) -> String

Scenario label.

signature

pub fn signature(outcome: ScenarioOutcome) -> String

Outcome signature accessor.

snapshot_report_markdown

pub fn snapshot_report_markdown() -> String

Deterministic markdown report for M36 fixture scripts.

snapshot_signature

pub fn snapshot_signature() -> String

Deterministic snapshot signature for M36 drift gates.

snapshot_version

pub const snapshot_version: Int