0
Fork 0
mirror of https://github.com/trailofbits/skills.git synced 2026-11-14 18:56:11 +00:00
trailofbits-skills/plugins/patching-bugs
dependabot[bot] e8e1da16d3
deps: bump the python-minor-patch group across 4 directories with 4 updates (#505)
Bumps the python-minor-patch group with 2 updates in the /plugins/patching-bugs directory: [ruff](https://github.com/astral-sh/ruff) and [ty](https://github.com/astral-sh/ty).
Bumps the python-minor-patch group with 2 updates in the /plugins/regression-hunt directory: [ruff](https://github.com/astral-sh/ruff) and [ty](https://github.com/astral-sh/ty).
Bumps the python-minor-patch group with 2 updates in the /plugins/trailmark/skills/slicing-code-context/scripts directory: [ruff](https://github.com/astral-sh/ruff) and [trailmark](https://github.com/trailofbits/trailmark).
Bumps the python-minor-patch group with 1 update in the /plugins/yara-authoring/skills/yara-rule-authoring/scripts directory: [yara-x](https://github.com/VirusTotal/yara-x).


Updates `ruff` from 0.17.0 to 0.17.1
- [Release notes](https://github.com/astral-sh/ruff/releases)
- [Changelog](https://github.com/astral-sh/ruff/blob/main/CHANGELOG.md)
- [Commits](https://github.com/astral-sh/ruff/compare/0.17.0...0.17.1)

Updates `ty` from 0.0.87 to 0.0.90
- [Release notes](https://github.com/astral-sh/ty/releases)
- [Changelog](https://github.com/astral-sh/ty/blob/main/CHANGELOG.md)
- [Commits](https://github.com/astral-sh/ty/compare/0.0.87...0.0.90)

Updates `ruff` from 0.17.0 to 0.17.1
- [Release notes](https://github.com/astral-sh/ruff/releases)
- [Changelog](https://github.com/astral-sh/ruff/blob/main/CHANGELOG.md)
- [Commits](https://github.com/astral-sh/ruff/compare/0.17.0...0.17.1)

Updates `ty` from 0.0.87 to 0.0.90
- [Release notes](https://github.com/astral-sh/ty/releases)
- [Changelog](https://github.com/astral-sh/ty/blob/main/CHANGELOG.md)
- [Commits](https://github.com/astral-sh/ty/compare/0.0.87...0.0.90)

Updates `ruff` from 0.17.0 to 0.17.1
- [Release notes](https://github.com/astral-sh/ruff/releases)
- [Changelog](https://github.com/astral-sh/ruff/blob/main/CHANGELOG.md)
- [Commits](https://github.com/astral-sh/ruff/compare/0.17.0...0.17.1)

Updates `trailmark` from 0.5.0 to 0.6.0
- [Release notes](https://github.com/trailofbits/trailmark/releases)
- [Changelog](https://github.com/trailofbits/trailmark/blob/main/CHANGELOG.md)
- [Commits](https://github.com/trailofbits/trailmark/compare/v0.5.0...v0.6.0)

Updates `yara-x` from 1.21.0 to 1.22.0
- [Release notes](https://github.com/VirusTotal/yara-x/releases)
- [Commits](https://github.com/VirusTotal/yara-x/compare/v1.21.0...v1.22.0)

---
updated-dependencies:
- dependency-name: ruff
  dependency-version: 0.17.1
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: python-minor-patch
- dependency-name: ty
  dependency-version: 0.0.90
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: python-minor-patch
- dependency-name: ruff
  dependency-version: 0.17.1
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: python-minor-patch
- dependency-name: ty
  dependency-version: 0.0.90
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: python-minor-patch
- dependency-name: ruff
  dependency-version: 0.17.1
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: python-minor-patch
- dependency-name: trailmark
  dependency-version: 0.6.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: python-minor-patch
- dependency-name: yara-x
  dependency-version: 1.22.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: python-minor-patch
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
History 2026-10-28 14:10:49 -04:00
..
.claude-plugin Add regression-hunt and patching-bugs plugins (#471) 2026-10-20 16:16:47 -04:00
assets Add regression-hunt and patching-bugs plugins (#471) 2026-10-20 16:16:47 -04:00
references Add regression-hunt and patching-bugs plugins (#471) 2026-10-20 16:16:47 -04:00
schemas Add regression-hunt and patching-bugs plugins (#471) 2026-10-20 16:16:47 -04:00
scripts Add regression-hunt and patching-bugs plugins (#471) 2026-10-20 16:16:47 -04:00
skills Add regression-hunt and patching-bugs plugins (#471) 2026-10-20 16:16:47 -04:00
tests Add regression-hunt and patching-bugs plugins (#471) 2026-10-20 16:16:47 -04:00
pyproject.toml deps: bump the python-minor-patch group across 4 directories with 4 updates (#505) 2026-10-28 14:10:49 -04:00
README.md Add regression-hunt and patching-bugs plugins (#471) 2026-10-20 16:16:47 -04:00
uv.lock deps: bump the python-minor-patch group across 4 directories with 4 updates (#505) 2026-10-28 14:10:49 -04:00

Patching Bugs

An agent coordinates focused skills to repair one supplied bug or falsifiable hypothesis in a local Git repository. Fresh agents reproduce and validate the claim, make a scoped repair, and prove the patch against the baseline, patched, and completely reverted trees.

Start with patching-bugs. Supply a clean target checkout with a working project build and a run directory outside its tracked tree. The workflow handles runtime and compiler failures and requires the regression-hunt plugin for the final regression check. It never pushes or opens a PR.

The coordinator and standalone skills use any root AGENTS.md, PATCHING_GUIDELINES.md, and THREAT_MODEL.md as described in the project guidance.

Skills

Skill Responsibility
patching-bugs Coordinate one claim, repair attempts, regression check, and reports
reproduce-bug Exercise the unchanged baseline and retain the PoC and raw receipts
validate-bug Independently rerun the unchanged PoC and judge the claim
implement-patch Fix the scoped invariant, test variants, and create one local commit
prove-patch Independently run scoped checks and three-arm proof

The record contract defines the run records, numbered attempts, and receipt manifests. A reportable run produces report.html for the auditor, including failed and inconclusive runs. Only a verified patch with a READY verdict produces maintainer-report.html for the local handoff.

Deterministic helpers

The standard-library scripts require Python 3.13+; invoke them with uv run --no-project. They do not dispatch agents or replace independent review.

  • records.py: validate records and repair scope, and write or check receipt manifests.
  • arms.py: build and exercise baseline, patched, and completely reverted trees in isolated worktrees.
  • render.py: validate retained evidence and render the auditor report and, when ready, the maintainer handoff.

Development

Run make check from the repository root for repository checks and behavioral tests. For the plugin's type check, run uv sync --frozen and uv run --frozen ty check scripts tests from this directory.