docs(rules-engine-2): document exploit-evidence, reachability and asset-exposure condition fields - #15713
Merged
Merged
Conversation
… exposure fields Pairs with the dojo-pro change that adds these to the rule item envelope. Adds the two new field groups to the available-fields contract table, extends the asset block to name its three new keys, and adds a section explaining what each one means -- including the exploit-maturity scale, since "20" is not self-describing, and the distinction between reachability (can the vulnerable code be reached inside the app) and exposure (can the asset be reached from outside), which are separate questions on separate rollups and easy to conflate. Also states why both exposure answers are offered: the manual checkbox is what somebody ticked, the verdict is computed from connector evidence, and they can disagree. And it records that these read empty where the feature populating them is off, so an author knows a rule will match nothing rather than misbehave. English only. The translated variants of this page lag behind by design and are updated in dedicated translation passes -- the acceptance fields added earlier are likewise not yet in them. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
blakeaowens
approved these changes
Aug 19, 2026
Maffooch
approved these changes
Aug 19, 2026
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.
Description
Documents new condition fields in the Rules Engine 2.0 rule-building guide. Pairs with a Pro change that adds these to the rule item envelope; this is the user-facing half.
The available-fields contract table gains two groups:
exploit_maturity,kev_due_date,vex_statereachability,reachability_confidenceThe asset block gains
internet_accessible,business_criticalityandexposurealongsideidandname.A new section explains what each one means, because several are not self-describing:
exploit_maturityis a number (0 none, 10 proof of concept, 20 weaponized, 30 observed exploited in the wild), sogte 20means "weaponized or worse". Documented as a scale because "20" tells a rule author nothing on its own.It also records that these fields read empty where the feature populating them is off (
reachabilityreadsunknown), so an author knows a rule written against them matches nothing rather than misbehaving.English only. The translated variants of this page lag behind by design and are updated in dedicated translation passes — the risk-acceptance condition fields added earlier are likewise not yet in them.
Documentation only; no code or behavior change in this repository.