feat(web-security): add structured findings via produces item types#74
Merged
GangGreenTemperTatum merged 1 commit intoJul 7, 2026
Conversation
Enable the platform items subsystem for the web-security capability. Adds two domain-specific Pydantic models alongside the built-in finding and asset types: - WebVulnerability: full-lifecycle vulnerability record with CVSS 3.1 and 4.0 scoring, CWE/OWASP classification, affected endpoint and parameter, evidence, reproduction steps, attacker model, chain suggestions, and validation verdict. Designed for bug bounty triage and professional pentest reporting. - WebEndpoint: discovered attack surface record for endpoints, services, and API surfaces — URL, method, technology fingerprint, auth requirement, parameters, and response characteristics. The produces config in capability.yaml wires these into the runtime's report_item / update_item / link_items tools automatically. Items land in the project Items UI with severity filtering, triage workflow, and cross-item linking. Refs: CAP-1135
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Enable the platform structured items subsystem (
produces) for the web-security capability. This gives every agent session running underweb-securitythereport_item/update_item/link_itemstools automatically, with items landing in the project Items UI for triage, filtering, and cross-session tracking.Changes
capability.yamlAdded
producesconfig:items.py(new)Two domain-specific Pydantic models alongside the platform built-ins:
WebVulnerability(20 fields) — full-lifecycle vulnerability record designed for bug bounty and professional pentest workflows:WebEndpoint(10 fields) — discovered attack surface for recon output:Design rationale
Models were designed by studying the existing capability surface:
record_findingtool fields → vulnerability classification, evidence, attacker modelreport-writerskill template → CVSS 3.1 + 4.0, CWE, reproduction steps formatexploit-verifierTriple-Check → validation verdict vocabularyooda-discipline→ confidence = gadget → lead → vulnerability progressionvuln-critic→ severity calibration from evidence qualityOnly 3 fields are required (title, severity, affected_endpoint, description) — a black-box tester may not have CVSS or source-level detail.
What this enables
link_itemsconnects findings to the endpoints they affectRefs: CAP-1135