feat(model-grounded-detection): group 1, subtract the noise architecture

99 source modules -> 81. 832 tests -> 646. The whole learning/ package (16
modules, ~4,100 lines) and six semantic/ modules removed, with the three gates
byte-identical to 2026-09-06-gate-baseline.txt at every step.

The sequence is what made it safe: vocabularies ported first (1.1), importers
detached second (1.2-1.3), deletion third (1.4). Every import break during the
deletion was therefore a detachment miss in the importer and was fixed there --
no module was restored to satisfy one. Both misses were the same shape and were
fixed as a class: operations.py and shapes.py each imported trailing_name from
the deleted variants.py, so it moved to semantic/ir.py, its natural home, and
both importers changed in one edit.

Ported before deleting: the closed guard vocabulary (verbatim, nothing else
holds it) into model/specs.py, which derives TaintSpec and DominanceSpec from
the retained ruleset facts rather than copying them. Re-homed: families ->
model/taxonomy, candidates -> model/candidates, endpoint -> model/endpoint,
plus Region, labeled_family and labeled_spans. labeled_family no longer falls
back to the LLM classifier -- an unlabeled pair is honestly unknown.

Four deviations, each recorded in the spec notes with its reason. improve/
evolve.py and validator.py were stripped, not deleted: each mixes the mechanism
lever (gone) with the deterministic rule-status loop `ousast improve` still
runs, which has no LLM in it; a test now asserts the lever's absence by symbol
so it cannot creep back. The learning CLI group became `model candidates`,
because deleting it outright would have orphaned the retained enumerator by
removing its only entry point. thinking moved from [learning] to [models].

A gap named rather than papered over: no retained sink fact routes by CWE to
path, output_encoding, untrusted_destination or prototype -- the same hole the
entailment ceiling diagnosed. The test asserts the seeded set and the gap set
exactly, so task 4.2 must update it when it authors those sinks.

The audit found exactly one genuine orphan: vectorstore.py, a bakeoff harness
with no production caller and no CLI, alive only through its own test. The five
named subsystems each carry an explicit decision. Manifest committed, with a
test asserting the tree still matches it.

Group 2 (the Joern go/no-go) has not started.

Co-Authored-By: Claude Opus 5 (1M context) <[email protected]>
Claude-Session: https://claude.ai/code/session_01T7XD7x5KonMdmGRkp63EQG
This commit is contained in:
Marius Ciepluch
2026-09-08 12:15:54 +02:00
co-authored by Claude Opus 5
parent fc4dab97fb
commit 9ed0e45c5f
86 changed files with 1710 additions and 12158 deletions
-65
View File
@@ -44,71 +44,6 @@ def test_the_baseline_records_where_it_came_from() -> None:
# --- one optional dependency at a time ---------------------------------------
def test_without_harnessx_the_meta_agent_proposer_proposes_nothing_and_says_why(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
from openultrasast.learning import proposer as proposer_module
from openultrasast.learning.detectors import FamilyConfig
from openultrasast.learning.proposer import FailureFacts, HarnessXProposer
monkeypatch.setattr(proposer_module, "has_harnessx", lambda: False)
(tmp_path / "injection").mkdir()
facts = FailureFacts(
family="injection",
config=FamilyConfig(
family="injection", version="0", prompt="p", checklist="c", tools=("read_file",), max_steps=1, max_cost_usd=0.1, max_chars=100
),
)
proposer = HarnessXProposer(configs_dir=tmp_path, model="m")
assert proposer.propose(facts) is None
assert proposer.reason == "harnessx_unavailable"
def test_without_a_chat_endpoint_the_learning_run_records_it_and_still_writes_its_artifact(
tmp_path: Path, monkeypatch: pytest.MonkeyPatch
) -> None:
from openultrasast.cli import main
for name in ("OPENULTRASAST_HUNTER_CLIENT", "DEEPSEEK_API_KEY", "OPENROUTER_API_KEY"):
monkeypatch.delenv(name, raising=False)
(tmp_path / "a-v.py").write_text("def run():\n return 1\n")
(tmp_path / "a-f.py").write_text("def run():\n return 1\n")
(tmp_path / "pairs.toml").write_text(
'[[pair]]\nname = "a"\nslice = "vibe-py"\nlanguage = "python"\nvuln = "a-v.py"\nfixed = "a-f.py"\n'
'relpath = "app.py"\nsplit = "train"\nreview_tier = "seeded"\n\n'
'[[pair.expected]]\ncwe = "CWE-78"\nclass = "x"\npath = "app.py"\nfunction = "run"\nmechanism = "other"\nfamily = "injection"\n'
)
printed: list[str] = []
monkeypatch.setattr("builtins.print", lambda *args, **kwargs: printed.append(" ".join(str(item) for item in args)))
assert main(["learning", "baseline", "--catalog", str(tmp_path / "pairs.toml"), "--out", str(tmp_path / "l"), "--model", "none"]) == 0
assert any("learning_endpoint_unavailable" in line for line in printed)
assert (tmp_path / "l" / "baseline" / "none" / "report.json").is_file()
def test_without_family_configurations_a_scan_records_the_reason_rather_than_the_traceback(
tmp_path: Path, monkeypatch: pytest.MonkeyPatch
) -> None:
from openultrasast.cli import _run_family_detectors
class _Settings:
configs_dir = "does/not/exist"
families_path = None
class _Runtime:
def __init__(self) -> None:
self.state: dict[str, list[dict[str, object]]] = {"degradations": []}
runtime = _Runtime()
findings, payload, cited = _run_family_detectors(
root=tmp_path,
hotspots=[],
cases=None,
settings=_Settings(),
config=None,
runtime=runtime, # type: ignore[arg-type]
)
assert (findings, payload, cited) == ([], {}, {})
assert [item["reason"] for item in runtime.state["degradations"]] == ["learning_configs_unavailable"]
def test_without_the_network_a_pointer_pair_is_skipped_by_name(tmp_path: Path, monkeypatch: pytest.MonkeyPatch) -> None:
from openultrasast.pairs import evaluate_catalog, load_pair_catalog, select_slice