mirror of
https://github.com/norandom/OpenUltraSAST.git
synced 2026-10-18 04:29:27 +00:00
README: "Configuring the HarnessX agentic plane" becomes "The agentic plane (ax)" (ousast plane run|status|doctor|remember, per-task Model, budget and egress, pointer to ops/ax/README.md, one tagged retirement line); "The HarnessX self-improving cycle" becomes "The self-improving cycle", and its MetaAgent paragraph is replaced by the memory proposer (`ousast improve --memory`, provenance, train-on-test guard). The fusion panel_model/decider_model lines and the [harnessx] spend caps are gone. The README reference test now passes without its strict xfail. docs/examples.md section 6 runs the plane; docs/threat-model.md describes the per-task EgressPolicy, the usd/calls budgets and the start-request credential path. RELEASE_NOTES.md gets an Unreleased entry: HarnessX removed, the retired keys and their errors, the silent loss of the second hunter for users who set [models] hunter, and the plane as the agentic path. Dated retirement notes (2026-09-30) head the requirements, design and brief of harnessx-self-improving-rulesets, learning-harness, three-stage-scan and openrouter-sast-harness, and follow the spec table in steering/overview.md; history is unchanged. All tasks are checked, so spec.json moves to implementation-complete. Co-Authored-By: Claude Opus 5.5 <[email protected]> Claude-Session: https://claude.ai/code/session_01EmM1j46qgKMh3zqD1QMwEo
3.8 KiB
3.8 KiB
Implementation Plan
Order follows the design's commit sequence (Requirement 5): nothing is deleted before its replacement has landed
and passed its fixture test. Every task is a commit gated on the full suite's own exit code, ruff check,
ruff format --check and mypy; the reconciler stays under 500 lines.
-
1. Baseline without the extra
- Equality script (design §3) with its
find_spec("harnessx")and freeze checks; re-sync.venvwithout theharnessxextra first. - Record
benchmarks/measurements/<date>-harnessx-removal-baseline/: full suite,ousast pairs --json, thepython-vulnerablequick benchmark, one standard-mode scan,ousast improve --dry-run; the exclusion list written next to it. - Requirements: 3.1, 5.1
- Equality script (design §3) with its
-
2. Memory store and the
remembertaskplane/memory.py: theMemoryStoreinterface withFileStoreandMinioStore(object metadata/tags, S3 Select JSON queries probed with a local fallback, versioned provenance, lifecycle, presign stubs;OUSAST_MEMORYselects; MinIO settings from.env;minioSDK as an optional extra); JSON rows per repository + pin, facts by content hash,FileStoreingest refuses below 1 GiB free,plane/tasks/remember.py(model-free),reconciler.mark_doneunder the run lock, seed and ingest wiring incli._plane, generator annotations; fact reuse when repository, pin, candidate set and runner image match.- Fixture tests: rows from a recorded Run, reuse on an unchanged pin, recompute on a changed one, disk refusal.
- Requirements: 6.1, 6.4
-
3. Proposals from memory
improve/memory.pywith rules M1 (demote) and M2 (promote) and the advisory disputed-family signal;run_round(proposals=...);ousast improve --memory(opt-in; default output byte-identical); provenance per proposal in the sidecar and journal; the train-on-test guard (qualification population, gated benchmark cases, holdout pairs).- Tests: each rule on crafted rows, the guard drops excluded rows, provenance round-trips, default
improveunchanged. - Requirements: 6.2, 6.4
-
4. The loop as a plane Run
- Tasks
alerts,measure,propose,improve(no Model, zero budget);--loopRun generation; fixed-pin Workspaces; the gate's verdict in<run>/loop-improve/gate.json; adoption stays a maintainer commit. - Fixture tests with the fake ax; one live loop Run on the local ax recorded (no model spend beyond the verify passes it reuses from memory).
- Requirements: 6.3
- Tasks
-
5. Retire the HarnessX scan paths
cli.py,fusion.py,verify_judge.py,stage_processors.pychanges;RetiredConfigErrorfor[models] verifier,[fusion] panel_model/decider_model; one warning for a[harnessx]section (the only tagged retirement text allowed insrc, enforced by a test); tests renamed to the behaviour they assert.- Requirements: 1.1, 1.2, 1.3, 3.3
-
6. Delete HarnessX code and packaging
- Delete
harness_ext.py,hunter_harness.py,verify_judge.py's judge path, the HarnessX-only tests; remove the extra, the mypy override and theuv.lockentry; rename the conftest fixture; audit rows and manifest; the reference search test (Req 2.4). - Requirements: 2.1, 2.2, 2.3, 2.4
- Delete
-
7. Equality proof
- Rerun the baseline script; commit the comparison record next to the baseline; any difference outside the exclusion list blocks the merge.
- Requirements: 3.2
-
8. Documentation and specs
- README ax-plane section pointing at
ops/ax/README.md;docs/examples.md§6 anddocs/threat-model.md(egress policy, budgets); dated retirement notes in the four specs and.kiro/steering/overview.md; release note naming the silent loss of the second hunter for users who set[models] hunter. - Requirements: 4.1, 4.2, 4.3
- README ax-plane section pointing at