mirror of
https://github.com/norandom/OpenUltraSAST.git
synced 2026-10-16 03:49:26 +00:00
First implementation slice of the approved harnessx-self-improving-rulesets spec (Foundation: governance + scoring planes). Additive and zero-dependency; findings stay byte-identical and the >=90% recall / <10% FP detection gate is unchanged. - PolicyStore (policy/verycode.py): vendors verycode-policies CWE_Score.tsv (167 CWEs, CRLF + trailing-space header parsed defensively); CwePolicy(severity 0-5, static/dynamic); load_policy, resolve_severity (severity is policy-governed, keyed on CWE — one CWE = one severity), assert_rules_resolve (fail-loud if an enabled rule's CWE is unmapped). Remap the C/C++ buffer rules CWE-120 -> CWE-121 (CWE-120 is absent from verycode; 121 = Stack-Based Buffer Overflow, severity 5). - ScoreModel (scoring/project_score.py): SEV_WEIGHT, REACH_MULT, finding_penalty, project_score (0-100 exponential decay; one sev-5 reachable -> ~43), two-condition gate (sev-5+reachable always fails; score<min_score fails only when blocking), build_score_artifact. - Wire into _run_scan: policy_load + fail-loud policy_check stages; score stage writes score.json and merges a score block into the manifest (advisory-first). - ScoreConfig (k/min_score/block_severity_reachable/blocking) in config.py. - pyproject uv_build ships the vendored TSV in the wheel (verified). - Tests: test_policy, test_scoring, test_score_pipeline (artifact + fail-loud). 85 passed; ruff + mypy clean. Spec phases 1.1-2.4 checked off; spec approved. Co-Authored-By: Claude Opus 4.8 <[email protected]>
74 lines
2.7 KiB
Python
74 lines
2.7 KiB
Python
from openultrasast.findings import StaticFinding
|
|
from openultrasast.policy import CwePolicy
|
|
from openultrasast.scoring import build_score_artifact, gate, project_score
|
|
|
|
POLICY = {
|
|
"CWE-78": CwePolicy("Command Injection", 5, True, False),
|
|
"CWE-89": CwePolicy("SQL Injection", 4, True, False),
|
|
"CWE-999": CwePolicy("DAST Only", 5, False, True), # dynamic-only -> report, never scored
|
|
}
|
|
|
|
|
|
def _finding(finding_id: str, reachability: str) -> StaticFinding:
|
|
return StaticFinding(
|
|
finding_id=finding_id,
|
|
path="a.py",
|
|
title="t",
|
|
severity="high",
|
|
confidence="medium",
|
|
evidence_level="static_corroboration",
|
|
rationale="r",
|
|
line=1,
|
|
function_name=None,
|
|
reachability_status=reachability,
|
|
reachability_evidence=[],
|
|
reachability_conditions=[],
|
|
tags=[],
|
|
ranking_priority=1.0,
|
|
)
|
|
|
|
|
|
def test_empty_corpus_scores_100() -> None:
|
|
assert project_score([], {}, POLICY) == 100
|
|
|
|
|
|
def test_single_severity5_reachable_scores_about_43() -> None:
|
|
finding = _finding("cmd:a.py:1", "reachable")
|
|
score = project_score([finding], {"cmd:a.py:1": "CWE-78"}, POLICY)
|
|
assert score == 43
|
|
|
|
|
|
def test_dynamic_only_and_unmapped_contribute_zero_penalty() -> None:
|
|
dynamic = _finding("dyn:a.py:1", "reachable")
|
|
unmapped = _finding("ump:a.py:2", "reachable")
|
|
rule_cwe = {"dyn:a.py:1": "CWE-999", "ump:a.py:2": "CWE-12345"}
|
|
|
|
artifact = build_score_artifact([dynamic, unmapped], rule_cwe, POLICY)
|
|
|
|
assert artifact.project_score == 100 # neither contributes penalty
|
|
assert artifact.out_of_scope_dynamic_only == 1
|
|
assert artifact.unmapped_cwe == ["CWE-12345"]
|
|
|
|
|
|
def test_hard_gate_fails_on_severity5_reachable_only() -> None:
|
|
reachable = _finding("cmd:a.py:1", "reachable")
|
|
inferred = _finding("cmd:a.py:2", "inferred-file-surface")
|
|
rule_cwe = {"cmd:a.py:1": "CWE-78", "cmd:a.py:2": "CWE-78"}
|
|
|
|
fail = gate([reachable], 90, rule_cwe, POLICY, min_score=80, blocking=False)
|
|
ok = gate([inferred], 90, rule_cwe, POLICY, min_score=80, blocking=False)
|
|
|
|
assert fail["passed"] is False # severity-5 + reachable always fails
|
|
assert ok["passed"] is True # inferred reachability does not trip the hard gate
|
|
|
|
|
|
def test_score_gate_blocks_only_when_blocking_enabled() -> None:
|
|
finding = _finding("sql:a.py:1", "inferred-file-surface")
|
|
rule_cwe = {"sql:a.py:1": "CWE-89"}
|
|
|
|
advisory = build_score_artifact([finding], rule_cwe, POLICY, min_score=99, blocking=False)
|
|
blocking = build_score_artifact([finding], rule_cwe, POLICY, min_score=99, blocking=True)
|
|
|
|
assert advisory.gate["passed"] is True # advisory-first: low score does not block
|
|
assert blocking.gate["passed"] is False # blocking: score below min_score fails
|