mirror of
https://github.com/norandom/OpenUltraSAST.git
synced 2026-10-16 11:49:28 +00:00
Keyed by model alone, the memory-safety run over the vfc slice silently replaced the run over the web families, and the published table would have shown one of them as if it were everything. The artifact key and the comparison label now carry the slice selection when it is not the default. Co-Authored-By: Claude Opus 5 (1M context) <[email protected]> Claude-Session: https://claude.ai/code/session_01T7XD7x5KonMdmGRkp63EQG
298 lines
11 KiB
Python
298 lines
11 KiB
Python
"""learning-harness task 3.3: round zero and the per-family noise floor (offline)."""
|
|
|
|
from __future__ import annotations
|
|
|
|
import json
|
|
from pathlib import Path
|
|
|
|
from openultrasast.benchmark import ExpectedFinding
|
|
from openultrasast.findings import StaticFinding
|
|
from openultrasast.learning.families import load_families
|
|
from openultrasast.pairs import PairCase
|
|
|
|
VULN = "from flask import request\nimport os\n\n\ndef run():\n os.system(request.args.get('cmd'))\n"
|
|
FIXED = "from flask import request\nimport subprocess\n\n\ndef run():\n subprocess.run(['echo', 'x'], check=False)\n"
|
|
|
|
|
|
def _case(tmp_path: Path, name: str, *, family: str = "injection", slice_name: str = "vibe-py", unscorable: str | None = None) -> PairCase:
|
|
(tmp_path / f"{name}-v.py").write_text(VULN)
|
|
(tmp_path / f"{name}-f.py").write_text(FIXED)
|
|
return PairCase(
|
|
name=name,
|
|
slice=slice_name,
|
|
language="python",
|
|
origin="test",
|
|
vuln_file=tmp_path / f"{name}-v.py",
|
|
fixed_file=tmp_path / f"{name}-f.py",
|
|
relpath="app.py",
|
|
expected=(
|
|
ExpectedFinding(
|
|
cwe="CWE-78", vulnerability_class="x", path="app.py", evidence="", function="run", mechanism="other", family=family
|
|
),
|
|
),
|
|
min_recall=1.0,
|
|
fix_policy="silent",
|
|
review_tier="seeded",
|
|
)
|
|
|
|
|
|
def _finding(family: str) -> StaticFinding:
|
|
return StaticFinding(
|
|
finding_id="detector:app.py:6",
|
|
path="app.py",
|
|
title="t",
|
|
severity="high",
|
|
confidence="low",
|
|
evidence_level="suspicion",
|
|
rationale="r",
|
|
line=6,
|
|
function_name="run",
|
|
reachability_status="unknown",
|
|
reachability_evidence=[],
|
|
reachability_conditions=[],
|
|
tags=[f"family:{family}", "detector:x@0"],
|
|
ranking_priority=0.0,
|
|
)
|
|
|
|
|
|
def _is_vulnerable_side(root: Path) -> bool:
|
|
"""The materialized side, by directory name only.
|
|
|
|
An earlier version also matched "-v" anywhere in the path, which the random temporary directory name
|
|
sometimes contained, so the detector "found" the bug on the fixed side too and the pair flipped. A
|
|
flaky harness is indistinguishable from a flaky detector, which is precisely what a noise floor must
|
|
not measure.
|
|
"""
|
|
return root.name == "vuln"
|
|
|
|
|
|
def _steady(root: Path) -> list[StaticFinding]:
|
|
return [_finding("injection")] if _is_vulnerable_side(root) else []
|
|
|
|
|
|
def _always(scan): # type: ignore[no-untyped-def]
|
|
"""Round zero asks for a detector per family; these tests deliberately give every family the same one so the
|
|
noise-floor arithmetic is the only thing under test."""
|
|
|
|
def build(_config): # type: ignore[no-untyped-def]
|
|
return scan
|
|
|
|
return build
|
|
|
|
|
|
def _flaky(counter: list[int]): # type: ignore[no-untyped-def]
|
|
def scan(root: Path) -> list[StaticFinding]:
|
|
if not _is_vulnerable_side(root):
|
|
return []
|
|
counter.append(1)
|
|
return [_finding("injection")] if len(counter) % 2 else []
|
|
|
|
return scan
|
|
|
|
|
|
def test_round_zero_writes_a_configuration_for_every_family(tmp_path: Path) -> None:
|
|
from openultrasast.learning.detectors import load_family_configs
|
|
from openultrasast.learning.rounds import run_baseline
|
|
|
|
taxonomy = load_families()
|
|
report = run_baseline(
|
|
[_case(tmp_path, "a")],
|
|
taxonomy=taxonomy,
|
|
configs_dir=tmp_path / "configs",
|
|
scan_factory=_always(_steady),
|
|
model="m",
|
|
out_dir=tmp_path / "out",
|
|
)
|
|
configs = load_family_configs(tmp_path / "configs", taxonomy)
|
|
assert set(configs) == {family.id for family in taxonomy.families}
|
|
assert all(config.version == "0" for config in configs.values())
|
|
assert report.model == "m" and report.k_runs == 5
|
|
|
|
|
|
def test_a_steady_detector_has_a_zero_noise_floor_and_a_flaky_one_does_not(tmp_path: Path) -> None:
|
|
from openultrasast.learning.rounds import run_baseline
|
|
|
|
taxonomy = load_families()
|
|
steady = run_baseline(
|
|
[_case(tmp_path, "a"), _case(tmp_path, "b")],
|
|
taxonomy=taxonomy,
|
|
configs_dir=tmp_path / "c1",
|
|
scan_factory=_always(_steady),
|
|
model="m",
|
|
out_dir=tmp_path / "o1",
|
|
)
|
|
floor = steady.floors["injection"]
|
|
assert floor.k_runs == 5 and floor.negative_flip_rate == 0.0 and floor.budget_flips == 0 and floor.gates is True
|
|
flaky = run_baseline(
|
|
[_case(tmp_path, "a"), _case(tmp_path, "b")],
|
|
taxonomy=taxonomy,
|
|
configs_dir=tmp_path / "c2",
|
|
scan_factory=_always(_flaky([])),
|
|
model="m",
|
|
out_dir=tmp_path / "o2",
|
|
)
|
|
assert flaky.floors["injection"].negative_flip_rate > 0.0 and flaky.floors["injection"].budget_flips >= 1
|
|
|
|
|
|
def test_the_memory_family_is_measured_but_never_gates(tmp_path: Path) -> None:
|
|
from openultrasast.learning.rounds import run_baseline
|
|
|
|
taxonomy = load_families()
|
|
report = run_baseline(
|
|
[_case(tmp_path, "m", family="memory", slice_name="vfc")],
|
|
taxonomy=taxonomy,
|
|
configs_dir=tmp_path / "configs",
|
|
scan_factory=_always(_steady),
|
|
model="m",
|
|
out_dir=tmp_path / "out",
|
|
slices=("vfc",),
|
|
)
|
|
assert "memory" in report.floors and report.floors["memory"].gates is False
|
|
assert report.metrics["memory"]["scorable"] == 1
|
|
|
|
|
|
def test_the_default_selection_is_the_web_slices(tmp_path: Path) -> None:
|
|
from openultrasast.learning.rounds import run_baseline
|
|
|
|
taxonomy = load_families()
|
|
cases = [_case(tmp_path, "web", slice_name="vibe-py"), _case(tmp_path, "c", family="memory", slice_name="vfc")]
|
|
report = run_baseline(
|
|
cases, taxonomy=taxonomy, configs_dir=tmp_path / "configs", scan_factory=_always(_steady), model="m", out_dir=tmp_path / "out"
|
|
)
|
|
assert set(report.metrics) == {"injection"} and "memory" not in report.floors
|
|
|
|
|
|
def test_artifacts_are_keyed_by_model_so_another_model_can_be_compared(tmp_path: Path) -> None:
|
|
from openultrasast.learning.rounds import compare_baselines, run_baseline
|
|
|
|
taxonomy = load_families()
|
|
out = tmp_path / "out"
|
|
for index, model in enumerate(("deepseek-v4-flash", "deepseek-v4-pro")):
|
|
run_baseline(
|
|
[_case(tmp_path, f"a{index}")],
|
|
taxonomy=taxonomy,
|
|
configs_dir=tmp_path / "configs",
|
|
scan_factory=_always(_steady),
|
|
model=model,
|
|
out_dir=out,
|
|
)
|
|
written = sorted(path.name for path in (out / "baseline").iterdir())
|
|
assert written == ["deepseek-v4-flash", "deepseek-v4-pro"]
|
|
floors = json.loads((out / "baseline" / "deepseek-v4-flash" / "noise-floors.json").read_text())
|
|
assert floors["model"] == "deepseek-v4-flash" and floors["floors"]["injection"]["k_runs"] == 5
|
|
report = json.loads((out / "baseline" / "deepseek-v4-flash" / "report.json").read_text())
|
|
assert report["metrics"]["injection"]["recall"] == 1.0 and report["taxonomy_version"]
|
|
table = compare_baselines(out)
|
|
assert set(table) == {"deepseek-v4-flash", "deepseek-v4-pro"}
|
|
assert table["deepseek-v4-pro"]["injection"]["youden"] == 1.0
|
|
# a second baseline never rewrites a configuration
|
|
assert (tmp_path / "configs" / "injection" / "family.toml").read_text().count("version") == 1
|
|
|
|
|
|
def test_an_unscorable_pair_is_listed_and_never_run(tmp_path: Path) -> None:
|
|
from openultrasast.learning.rounds import run_baseline
|
|
|
|
calls: list[Path] = []
|
|
|
|
def counting(root: Path) -> list[StaticFinding]:
|
|
calls.append(root)
|
|
return _steady(root)
|
|
|
|
taxonomy = load_families()
|
|
case = _case(tmp_path, "twin")
|
|
twin = PairCase(**{**case.__dict__, "unscorable": "identical_twin"})
|
|
report = run_baseline(
|
|
[twin], taxonomy=taxonomy, configs_dir=tmp_path / "configs", scan_factory=_always(counting), model="m", out_dir=tmp_path / "out"
|
|
)
|
|
assert report.metrics["injection"]["scorable"] == 0
|
|
assert report.metrics["injection"]["unscorable"] == {"identical_twin": 1}
|
|
assert calls == []
|
|
|
|
|
|
def test_round_zero_records_what_it_spent(tmp_path: Path) -> None:
|
|
"""Publishing puts a cost beside every number, so the baseline has to know what it cost."""
|
|
from openultrasast.learning.rounds import run_baseline
|
|
|
|
report = run_baseline(
|
|
[_case(tmp_path, "a")],
|
|
taxonomy=load_families(),
|
|
configs_dir=tmp_path / "configs",
|
|
scan_factory=_always(_steady),
|
|
model="m",
|
|
out_dir=tmp_path / "out",
|
|
spent_usd=lambda: 1.25,
|
|
)
|
|
assert report.cost_usd == 1.25
|
|
assert json.loads((tmp_path / "out" / "baseline" / "m" / "report.json").read_text())["cost_usd"] == 1.25
|
|
|
|
|
|
def test_round_zero_records_the_pairs_it_could_not_reach_instead_of_losing_the_run(tmp_path: Path) -> None:
|
|
"""One transient error must not cost a run that has already paid for hundreds of calls.
|
|
|
|
Round zero is the most expensive thing this harness does. A provider hiccup two thirds of the way through used
|
|
to raise straight out of `run_baseline`, and everything measured so far went with it — so the honest response
|
|
to a flaky endpoint was to run the whole thing again and hope."""
|
|
from openultrasast.learning.rounds import run_baseline
|
|
|
|
taxonomy = load_families()
|
|
seen: list[str] = []
|
|
|
|
def build(_config): # type: ignore[no-untyped-def]
|
|
def scan(root: Path) -> list[StaticFinding]:
|
|
seen.append(root.name)
|
|
if len(seen) == 3:
|
|
raise TimeoutError("the endpoint hung up")
|
|
return _steady(root)
|
|
|
|
return scan
|
|
|
|
report = run_baseline(
|
|
[_case(tmp_path, "a"), _case(tmp_path, "b")],
|
|
taxonomy=taxonomy,
|
|
configs_dir=tmp_path / "configs",
|
|
scan_factory=build,
|
|
model="m",
|
|
out_dir=tmp_path / "out",
|
|
k_runs=3,
|
|
)
|
|
assert report.metrics["injection"]["scorable"] == 1, "the pair that was reached is still measured"
|
|
assert report.metrics["injection"]["unscorable"] == {"detector_unreachable": 1}
|
|
assert (tmp_path / "out" / "baseline" / "m" / "report.json").is_file()
|
|
|
|
|
|
def test_two_slices_on_one_model_are_two_baselines_not_one_overwriting_the_other(tmp_path: Path) -> None:
|
|
"""Artifacts are keyed by what identifies the run, and the slice selection is part of that.
|
|
|
|
Req 8.4 asks for the web families and, separately, the memory-safety family over the vfc slice. Keyed by model
|
|
alone, the second run silently replaces the first and the published table shows one of them as if it were
|
|
everything."""
|
|
from openultrasast.learning.rounds import compare_baselines, run_baseline
|
|
|
|
taxonomy = load_families()
|
|
out = tmp_path / "out"
|
|
web = run_baseline(
|
|
[_case(tmp_path, "w", slice_name="vibe-py")],
|
|
taxonomy=taxonomy,
|
|
configs_dir=tmp_path / "configs",
|
|
scan_factory=_always(_steady),
|
|
model="deepseek-v4-flash",
|
|
out_dir=out,
|
|
k_runs=3,
|
|
)
|
|
memory = run_baseline(
|
|
[_case(tmp_path, "m", family="memory", slice_name="vfc")],
|
|
taxonomy=taxonomy,
|
|
configs_dir=tmp_path / "configs",
|
|
scan_factory=_always(_steady),
|
|
model="deepseek-v4-flash",
|
|
out_dir=out,
|
|
k_runs=3,
|
|
slices=("vfc",),
|
|
)
|
|
assert set(web.metrics) == {"injection"} and set(memory.metrics) == {"memory"}
|
|
written = sorted(path.name for path in (out / "baseline").iterdir())
|
|
assert written == ["deepseek-v4-flash", "deepseek-v4-flash-vfc"], written
|
|
table = compare_baselines(out)
|
|
assert set(table) == {"deepseek-v4-flash", "deepseek-v4-flash (vfc)"}
|
|
assert "memory" in table["deepseek-v4-flash (vfc)"] and "injection" in table["deepseek-v4-flash"]
|