hot_path_harness

Deterministic runtime hot-path optimization harness for M35.

Types

Budget

Per-scenario regression budgets.

pub type Budget {
  Budget(
    scenario: Scenario,
    min_p95_latency_improvement_ms: Int,
    min_throughput_gain: Int,
    min_allocation_reduction_units: Int,
  )
}

Constructors

Budget(
  scenario: Scenario,
  min_p95_latency_improvement_ms: Int,
  min_throughput_gain: Int,
  min_allocation_reduction_units: Int,
)

BudgetResult

Budget evaluation result.

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

Constructors

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

Metrics

Hot-path profile metrics.

pub type Metrics {
  Metrics(
    p50_latency_ms: Int,
    p95_latency_ms: Int,
    throughput_events_per_second: Int,
    memory_units: Int,
    allocation_units: Int,
  )
}

Constructors

Metrics(
  p50_latency_ms: Int,
  p95_latency_ms: Int,
  throughput_events_per_second: Int,
  memory_units: Int,
  allocation_units: Int,
)

Report

Full M35 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

M35 hot-path scenarios.

pub type Scenario {
  SessionEventPatchLoop
  TransportAckPressureLoop
  ReconnectRecoveryLoop
}

Constructors

```
SessionEventPatchLoop
```
```
TransportAckPressureLoop
```
```
ReconnectRecoveryLoop
```

ScenarioOutcome

One 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

Number of failing budget checks.

budget_results

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

Report budget results.

budget_version

pub const budget_version: Int

budget_version_label

pub fn budget_version_label() -> String

M35 budget profile version.

default_budget

pub fn default_budget() -> List(Budget)

Default deterministic M35 budget profile.

deterministic

pub fn deterministic(outcome: ScenarioOutcome) -> Bool

Scenario determinism accessor.

evaluate_budget

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

Evaluate one outcome list against one budget profile.

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 failure count.

optimized_metrics

pub fn optimized_metrics(outcome: ScenarioOutcome) -> Metrics

Optimized metrics accessor.

outcomes

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

Report outcomes.

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 M35 hot-path scenarios and evaluate budgets.

run_scenario

pub fn run_scenario(scenario: Scenario) -> ScenarioOutcome

Run one M35 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

Scenario signature accessor.

snapshot_report_markdown

pub fn snapshot_report_markdown() -> String

Deterministic markdown report for M35 fixture scripts.

snapshot_signature

pub fn snapshot_signature() -> String

Deterministic snapshot signature for M35 drift gates.

snapshot_version

pub const snapshot_version: Int