Bootstrap hotpath from engineering spec v0.1

Commit the spec and scaffold the system it describes:

- SPEC.md: the full v0.1 engineering spec
- crates/: trust-layer Rust workspace, unit-tested
  - bench-runner: interleaved ABAB scheduling with discarded warm-ups,
    deterministic bootstrap CIs over the ratio of medians,
    CI-lower-bound accept rule, env fingerprinting, and a CLI with
    compare + A/A self-test modes (A/A verified passing end-to-end)
  - diff-test: gate outcome model, sha256 corpus pin verifier that
    refuses on mismatch, per-target equivalence policy parser
    (byte-identical default, explicit fp-tolerance opt-in)
  - ledger: append-only SQLite attempt schema with UPDATE/DELETE
    refused by triggers, anti-double-attempt query
  - report: cores-saved and dollars/yr ROI math over speedup CIs,
    pricing.toml inputs
- playbook/: classes 1-7 with preconditions, procedure, verification
  notes, and known failure modes per class
- agent/: Python package skeleton — six-tool contract and prompting
  spine, harness IPC deferred to Phase 1
- config/: accept.toml (2% threshold, 30 runs/side), pricing.toml
- targets/, corpora/, results/calibration/: layout and policy docs

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01EcKPWQ3MQD4NdEHwar96u2
This commit is contained in:
Claude
2026-07-06 18:34:51 +00:00
parent 836d4c9208
commit 328aafae77
40 changed files with 2468 additions and 0 deletions
+53
View File
@@ -0,0 +1,53 @@
//! Environment fingerprint (SPEC §3.1, §7): every reported number carries
//! the machine state it was measured under. Collection is best-effort —
//! a field we cannot read is recorded as "unknown", never omitted.
use serde::Serialize;
use std::fs;
#[derive(Debug, Clone, Serialize)]
pub struct EnvFingerprint {
pub kernel: String,
pub cpu_model: String,
pub governor: String,
pub smt: String,
pub turbo: String,
/// ASLR handling mode actually in effect for this session (SPEC §7:
/// randomize-and-aggregate vs. fixed; document, don't assume).
pub aslr: String,
pub cpu_pinning: String,
}
fn read_trimmed(path: &str) -> String {
fs::read_to_string(path)
.map(|s| s.trim().to_string())
.unwrap_or_else(|_| "unknown".to_string())
}
impl EnvFingerprint {
pub fn collect(pinning: &str, aslr_mode: &str) -> Self {
let cpu_model = fs::read_to_string("/proc/cpuinfo")
.ok()
.and_then(|s| {
s.lines()
.find(|l| l.starts_with("model name"))
.and_then(|l| l.split(':').nth(1))
.map(|v| v.trim().to_string())
})
.unwrap_or_else(|| "unknown".to_string());
Self {
kernel: read_trimmed("/proc/sys/kernel/osrelease"),
cpu_model,
governor: read_trimmed(
"/sys/devices/system/cpu/cpu0/cpufreq/scaling_governor",
),
smt: read_trimmed("/sys/devices/system/cpu/smt/active"),
turbo: read_trimmed("/sys/devices/system/cpu/intel_pstate/no_turbo"),
aslr: format!(
"mode={aslr_mode} randomize_va_space={}",
read_trimmed("/proc/sys/kernel/randomize_va_space")
),
cpu_pinning: pinning.to_string(),
}
}
}