Skip to content

feat(metrics): zero the outcome when a run cheats - #151

Open
isadominguez314 wants to merge 20 commits into
kubernetes-sigs:mainfrom
isadominguez314:feat/integrity-gate
Open

feat(metrics): zero the outcome when a run cheats#151
isadominguez314 wants to merge 20 commits into
kubernetes-sigs:mainfrom
isadominguez314:feat/integrity-gate

Conversation

@isadominguez314

@isadominguez314 isadominguez314 commented Sep 3, 2026

Copy link
Copy Markdown
Contributor

Builds on #139 (feat/detection-core). Its commits appear in this PR's
diff because PRs cannot stack across a fork — the code is unchanged from #139.
Incremental diff (this PR's own work):
isadominguez314/devops-bench@feat/detection-core...feat/integrity-gate


Detection has been flag-only: a run that read the benchmark's own material scored exactly as if it had not. Add an always-on, deterministic IntegrityMetric that turns a flagged cheating_report into a catastrophic zero, so the run stays on the leaderboard as a visible zero rather than disappearing from it the way validated=False would have done.

The gate emits IntegrityCatastrophic rather than reusing VerificationCatastrophic: the scores map is last-write-wins, so a clean integrity check sharing that key would erase a real task catastrophic. The two keys live together in core.score_keys and are read from there by both the pipeline and the normalizer, so the row's catastrophic flag cannot drift from the zero applied to outcomeScore.

A no_data report (errored run, or detection disabled) emits nothing -- having seen nothing is not innocence. The outcome finalizer no longer returns early on a gated run whose correctness sources all abstained, because a null outcomeScore drops the row out of leaderboard aggregates -- exactly the erasure a visible zero exists to prevent -- so outcomeScore is never left null once a gate has fired: the composite takes a synthesized correctness of 0.0 and the reason string reports c=n/a. Detection itself stays flag-only and never mutates a record; but its report is now consulted by scoring.

Summary by CodeRabbit

  • New Features

    • Added trajectory-based detection for potential access to sensitive benchmark material.
    • Reports now identify flagged, clean, or unavailable detection results for each record.
    • Added optional workspace inventory checks for artifacts from prior runs.
    • Added configurable detection rules and environment controls.
    • Added an integrity score that can mark affected runs as catastrophic and zero their outcome score.
  • Documentation

    • Added guidance covering detection behavior, configuration, reports, metrics, and known limitations.
    • Clarified catastrophic outcome reporting across integrity and verification safeguards.

Agents under test run as ordinary subprocesses on the harness host with no
filesystem boundary, so the benchmark's own material -- task definitions with
their judge rubrics and verification specs, the scoring code, prior results,
the repo checkout -- is reachable. A scan of the existing run corpus confirms
the exposure is not theoretical.

Add a flag-only detection layer that scans each run's recorded trajectory and
attaches a `cheating_report` to every record. It never changes scores, never
touches `validated`, and never aborts a run: the report is an annotation for
human review.

* `rules.py` -- the rule model plus a default ruleset matching the *kind* of
  sensitive material rather than any specific task, so new tasks are covered
  without a code change. Extra rules load from an optional YAML file.
* `detector.py` -- pure functions over record dicts. Rules match the
  JSON-dumped tool-call `args`, the tool `result`, and the record's final
  `output`. An empty trajectory and empty output reports `no_data`,
  deliberately distinct from `clean`: an errored run gave detection nothing
  to see, which is not innocence.
* `inventory.py` -- the agent home persists between runs, so a previous
  `report.md` is an answer key for the next attempt. "Left by a prior run" is
  temporal, not lexical, so the harness snapshots the home before the first
  agent executes and generates per-run rules from what it finds. Path rules
  are filtered per record against the task prompt: an entry the prompt itself
  names is authorized for that record.
* `evalharness/default.py` -- the pre-run snapshot and the post-run
  annotation pass, both best-effort. A detector failure logs and leaves the
  seeded empty report; it never sinks a completed run.
* `docs/components/detection.md` -- what is scanned, the rule categories, the
  configuration knobs, the report shape, and the limitations of trajectory
  analysis as a mitigation.

Path-shaped rules scan every surface, `result` included. There is deliberately
no passive/active distinction: a benchmark path surfacing in an `ls ~` listing
is not access, but no legitimate task puts the harness's own material in view
either, so the sighting is the signal that the agent went looking.

Detection is a mitigation, not a boundary -- it sees only what the transcript
recorded. Sandboxing is the real fix and is tracked separately.
Address review feedback on the pre-run home inventory.

DEFAULT_BASELINE hard-coded a directory name that exists only on one
operator's host, so any other environment granting a skills tree under
the agent home would have flagged every honest run for using it. Replace
it with baseline_from_granted_paths(), which maps the paths the harness
actually granted (AGENT_SKILLS_PATHS) to the home entries holding them,
unioned into the baseline at the inventory call site. Derived rather
than enumerated: no host layout is baked into the detector.

Skip content fingerprinting for symlinked leftovers. Path.is_file()
follows links, so a leftover link would otherwise read an arbitrary
readable file into a generated pattern -- and patterns are published in
the record's report. The link keeps its path rule.

Document why _scan_text emits one finding per pattern per surface rather
than per occurrence: the budget is spent across the whole record, so
per-occurrence matching would let one noisy result crowd out evidence
from later trajectory entries.
Detection has been flag-only: a run that read the benchmark's own
material scored exactly as if it had not. Add an always-on, deterministic
IntegrityMetric that turns a flagged cheating_report into a catastrophic
zero, so the run stays on the leaderboard as a visible zero rather than
disappearing from it the way validated=False would have done.

The gate emits IntegrityCatastrophic rather than reusing
VerificationCatastrophic: the scores map is last-write-wins, so a clean
integrity check sharing that key would erase a real task catastrophic.
The two keys live together in core.score_keys and are read from there by
both the pipeline and the normalizer, so the row's catastrophic flag
cannot drift from the zero applied to outcomeScore.

A no_data report (errored run, or detection disabled) emits nothing --
having seen nothing is not innocence. The outcome finalizer no longer
returns early on a gated run whose correctness sources all abstained,
because a null outcomeScore drops the row out of leaderboard aggregatebecause a null outcomeScore drops the row out of la so it is neverbecause a null outcomeScore drops the row out of leaderboard aggregatebeonbecause a null outcomeScore drops the row out of leaderboard aggregatebt its result is now consulted by
scoring.
Two fail-open paths let a flagged run keep a passing score.

_score built the judge before running any metric and let the failure
propagate, so a bad JUDGE_PROVIDER or missing key aborted scoring for the
whole batch -- including the deterministic catastrophic gates, which need
no judge. It now falls back to a null judge and scores what it can. This
was live rather than theoretical: get_judge_model() raises for lack of an
OPENAI_API_KEY under test, and the harness test had the resulting empty
scores map frozen in as an assertion.

_reason type-checked the elements of cheating_report.categories but not
the container, so a persisted non-list raised on iteration; the pipeline's
per-metric guard swallowed that and dropped the gate entirely.
Prior-run leftovers under /tmp (or any shared writable path outside the
home) generate no inventory rules, so reading them scans clean. Recorded
as a known limitation per review on kubernetes-sigs#139.
# Conflicts:
#	docs/components/detection.md
Orphaned when the catastrophic flag moved to _CATASTROPHIC_KEYS; nothing
imports it from this module (metrics/verification.py's copy is separate
and still live). Flagged in review on PR #3.
…itive override

Review on PR #3 asked for both to be explicit: emitting nothing on
no_data means no gate, so its OutcomeScore matches a clean run's and the
distinction lives only in the per-metric map; and a wrongly flagged
record can only be overturned today by hand-editing its stored
cheating_report, since the deterministic gate re-fires on rescore and
BENCH_CHEAT_DETECT is all-or-nothing at construction.
…l hidden entries

The pre-run inventory blanket-skipped dotfiles, so an agent CLI's state
dotdir left by a prior run (a stale ~/.openclaw/workspace holding a
previous task's deliverables) was invisible while the same material
outside a dotdir was caught. Only the enumerated ENVIRONMENT_DOTFILES
(shell init/history, XDG trees, provisioned credentials and tool state)
are baseline now; every other hidden entry generates rules like any
visible leftover. Operators extend coverage through the existing
baseline parameter, which is name-based and accepts dotfile names.

Known caveat, deliberately unhandled: the state dir of the agent
currently under test is not special-cased, so referencing it in a
recorded tool call flags; if that bites, the harness should add that one
name to the baseline it passes.

DETECTOR_VERSION 5 -> 6: v6 flags strictly more than v5.

Requested in review on kubernetes-sigs#139.
scan_record re-dumped every entry's args and result for every rule --
len(rules) * len(trajectory) conversions of identical values. Hoist the
per-entry text normalization out of the rule loop, and route args
through _as_text like the other surfaces so a foreign harness storing a
non-JSON-serializable object in args degrades to str() instead of
throwing the whole scan away. Requested in review on kubernetes-sigs#139.
Two review asks on kubernetes-sigs#139, both folded into the still-unpublished v6:

- _home_prefixes had no left boundary, so the literal home path matched
  inside a longer token (/data/home/agent/report.md) and a ~ glued to a
  word read as a home reference. A (?<![\w~]) lookbehind bounds the
  alternation; quotes, whitespace, = and start-of-string still match.

- The harness-repo rule's subtree alternation skipped docs/, but the
  repo docs describe the detection rules and the scoring formulas, so
  reading them tells an agent exactly what gets flagged and how the run
  is graded. docs now flags like any other subtree.
…on point

Review on PR #3 asked for the implications of the shared tuple: a key
added there automatically zeroes OutcomeScore and flips the row's
catastrophic flag with no further wiring, and everything in it must be
deterministic because the pipeline applies these gates without a judge.
…atch

A single run-start snapshot cannot see what the batch itself creates, so
task 1's deliverable -- the closest thing to an answer key task 2 could
find -- generated no rule and a read of it scanned clean. The home is now
re-inventoried before each task's agent runs.

Content fingerprints stay pinned to the run-start leftovers. Fingerprints
are unfilterable by design, and two iterations of one task legitimately
share long lines (a pasted policy body, a command line, a cluster name),
so fingerprinting a same-batch deliverable would flag the honest repeat
rather than a cheat. Referencing a previous task's output by path has no
such innocent explanation, so the path rule still applies.

Snapshots pair positionally with their records rather than keying by task
name: a batch may run the same task more than once, and each iteration
needs the snapshot taken before it.
…ection

"detection" says nothing about what is being detected, and it was the one
surface still saying it: the record field is already cheating_report, the
toggles are BENCH_CHEAT_DETECT / BENCH_CHEAT_INVENTORY, and the docs page
is titled "Cheating detection". The directory now matches.

Pure rename -- devops_bench/detection -> devops_bench/cheat_detection,
tests/unit/detection -> tests/unit/cheat_detection, and
docs/components/detection.md -> cheat-detection.md -- with references
rewritten. No behaviour change.

Naming note for reviewers: "contamination" is the term of art in the ML
benchmark literature but means training-set leakage, not an agent reading
answers at runtime, so it would mislead rather than clarify.
# Conflicts:
#	docs/components/cheat-detection.md
The docs index and the glossary's codebase tree both landed upstream after
this branch was cut, and neither mentions the package. Adding the entries
here rather than leaving them for a follow-up, since docs-sync treats a new
top-level package as something both files must carry.
@kubernetes-prow

Copy link
Copy Markdown

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by: isadominguez314
Once this PR has been reviewed and has the lgtm label, please assign janetkuo for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found here.

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@kubernetes-prow kubernetes-prow Bot added the needs-ok-to-test Indicates a PR that requires an org member to verify it is safe to test. label Sep 3, 2026
@kubernetes-prow

Copy link
Copy Markdown

Hi @isadominguez314. Thanks for your PR.

I'm waiting for a kubernetes-sigs member to verify that this patch is reasonable to test. If it is, they should reply with /ok-to-test on its own line. Until that is done, I will not automatically test new commits in this PR, but the usual testing commands by org members will still work.

Tip

We noticed you've done this a few times! Consider joining the org to skip this step and gain /lgtm and other bot rights. We recommend asking approvers on your previous PRs to sponsor you.

Once the patch is verified, the new status will be reflected by the ok-to-test label.

I understand the commands that are listed here.

Details

Instructions for interacting with me using PR comments are available here. If you have questions or suggestions related to my behavior, please file an issue against the kubernetes-sigs/prow repository.

@kubernetes-prow kubernetes-prow Bot added the cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. label Sep 3, 2026
@kubernetes-prow
kubernetes-prow Bot requested a review from janetkuo September 3, 2026 22:41
@kubernetes-prow kubernetes-prow Bot added the size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. label Sep 3, 2026
@coderabbitai

coderabbitai Bot commented Sep 3, 2026

Copy link
Copy Markdown

Review Change Stack

Note

Reviews paused

It looks like this branch is under active development. To avoid overwhelming you with review comments due to an influx of new commits, CodeRabbit has automatically paused this review. You can configure this behavior by changing the reviews.auto_review.auto_pause_after_reviewed_commits setting.

Use the following commands to manage reviews:

  • @coderabbitai resume to resume automatic reviews.
  • @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

  • ▶️ Resume reviews
  • 🔍 Trigger review

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Team

Run ID: 043fbe4c-4e0e-4d4d-b05d-2032d1d265ae

📥 Commits

Reviewing files that changed from the base of the PR and between 13b0663 and 6ba985c.

📒 Files selected for processing (22)
  • devops_bench/cheat_detection/__init__.py
  • devops_bench/cheat_detection/detector.py
  • devops_bench/cheat_detection/inventory.py
  • devops_bench/cheat_detection/rules.py
  • devops_bench/core/score_keys.py
  • devops_bench/evalharness/default.py
  • devops_bench/metrics/integrity.py
  • devops_bench/metrics/pipeline.py
  • devops_bench/results/normalize.py
  • devops_bench/results/row.py
  • docs/README.md
  • docs/components/cheat-detection.md
  • docs/components/glossary.md
  • docs/components/metrics.md
  • tests/unit/cheat_detection/__init__.py
  • tests/unit/cheat_detection/test_detector.py
  • tests/unit/cheat_detection/test_inventory.py
  • tests/unit/cheat_detection/test_rules.py
  • tests/unit/evalharness/test_default_harness.py
  • tests/unit/metrics/test_metrics_integrity.py
  • tests/unit/metrics/test_metrics_pipeline.py
  • tests/unit/results/test_results_normalize.py

Included review availability: Your plan provides up to 1 included review per hour; 0 remain after this review.


📝 Walkthrough

Walkthrough

The pull request adds trajectory-based cheat detection, pre-task home inventory rules, and a deterministic integrity metric. It annotates records with cheating_report and lets integrity findings gate outcome scores.

Changes

Cheat detection

Layer / File(s) Summary
Rule model and trajectory scanning
devops_bench/cheat_detection/*, tests/unit/cheat_detection/test_detector.py, tests/unit/cheat_detection/test_rules.py
Defines validated rules and default sensitive-access patterns. Scans trajectory arguments, results, and final output. Produces bounded findings with flagged, clean, or no_data status.
Inventory rules and harness integration
devops_bench/evalharness/default.py, devops_bench/cheat_detection/inventory.py, tests/unit/cheat_detection/test_inventory.py, tests/unit/evalharness/test_default_harness.py
Creates per-task rules from home-directory leftovers. Exempts baselines and prompt-named entries. Applies rules during record annotation and preserves execution when scan-time failures occur.

Integrity gating

Layer / File(s) Summary
Integrity metric and catastrophic outcome gating
devops_bench/core/score_keys.py, devops_bench/metrics/integrity.py, devops_bench/metrics/pipeline.py, devops_bench/results/normalize.py, devops_bench/results/row.py, tests/unit/metrics/*, tests/unit/results/test_results_normalize.py
Adds IntegrityCatastrophic and shares catastrophic-key handling across scoring and result normalization. Flagged reports score 0.0; clean reports score 1.0; missing or no_data reports emit no integrity score.

Documentation

Layer / File(s) Summary
Detection and scoring documentation
docs/README.md, docs/components/cheat-detection.md, docs/components/metrics.md, docs/components/glossary.md
Documents detector surfaces, rule categories, inventory behavior, configuration, report fields, limitations, and integrity score handling.

Estimated code review effort: 4 (Complex) | ~60 minutes

Merge Risk: ⚪ Minimal · up to 6ba98

No concrete correctness, integrity, security, or availability risk remains that should block merge.

Suggested reviewers: jessie1111101

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Docstring Coverage ⚠️ Warning Docstring coverage is 77.59% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 116 functions across 18 files. (4 skipped… Write docstrings for the functions missing them to satisfy the coverage threshold.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly summarizes the primary change: cheating runs now receive a zeroed outcome through the integrity metric.
Linked Issues check ✅ Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check ✅ Passed Check skipped because no linked issues were found for this pull request.
Full details: Docstring Coverage

Explanation

Docstring coverage is 77.59% which is insufficient. The required threshold is 80.00%. Docstring coverage is scoped to functions touched by this diff. Analyzed 116 functions across 18 files. (4 skipped: 4 unsupported.)

  • Fix all pre-merge checks with AI
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests

Comment @coderabbitai help to get the list of available commands.

@janetkuo janetkuo added ok-to-test Indicates a non-member PR verified by an org member that is safe to test. and removed needs-ok-to-test Indicates a PR that requires an org member to verify it is safe to test. labels Sep 4, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

cncf-cla: yes Indicates the PR's author has signed the CNCF CLA. ok-to-test Indicates a non-member PR verified by an org member that is safe to test. size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants