SECURITY REVIEW / Trail of Bits
Graph Evolution
Diffs Trailmark code graphs built at two source snapshots (commits, tags or directories) to surface new attack paths, blast-radius growth, taint changes and privilege-boundary shifts that a text diff does not show.
“Compares Trailmark code graphs at two source code snapshots (git commits, tags, or directories) to surface security-relevant structural changes. Detects new attack paths, complexity shifts, blast radius growth, taint propagation changes, and privilege boundary modifications that text diffs miss. Use when comparing code between commits or tags, analyzing structural evolution, detecting attack surface growth, reviewing what changed between audit snapshots, or finding security-relevant changes that text diffs miss.”
01 / THE REASONING
Why this made the selection.
- Diffs Trailmark graphs at two snapshots (commits, tags or directories) to surface new attack paths, blast-radius growth, taint and privilege-boundary changes.
- Warns that `trailmark diff` defaults --language to python and exits 0 with empty arrays on other targets, so it says to pass --language explicitly before concluding nothing changed.
02 / THE REVIEW RECORD
What we actually inspected.
Source review has boundaries.
A clear record is more useful than a “safe” badge.
Material inspected
- plugins/trailmark/skills/graph-evolution/SKILL.md
- plugins/trailmark/README.md (prerequisites and version notes)
- plugins/trailmark/agents/code-slice-worker.md (host note)
- README.md (installation and licence sections)
- LICENSE
Our findings
- Graph Evolution's SKILL.md frontmatter declares no allowed-tools.
- Phase 3 runs both `trailmark diff --json` and the bundled scripts/graph_diff.py for subgraph membership changes.
- Graph Evolution's Prerequisites tell the agent to run `uv tool install trailmark` if `uv run trailmark` fails, and not to compare snapshots by hand.
- The report is written to GRAPH_EVOLUTION_*.md.
Not established by this review
- Not executed: it was not installed or run.
- The Graph Evolution skill and any bundled scripts were not run.
The review applies to the material and revision named here. A newer upstream release can change its behavior.
03 / PUT IT TO WORK
Add a skill to your workflow.
- `/plugin marketplace add trailofbits/skills` (repository README) adds the whole Trail of Bits marketplace, not one skill.
- Install the `trailmark` plugin from `/plugin menu`; it bundles the Graph Evolution skill with the other trailmark skills listed in the trailmark plugin README.
- `uv tool install trailmark` (trailmark plugin README) installs the Trailmark CLI that this skill drives.
Before you start
- The Trailmark CLI, installed with `uv tool install trailmark` (trailmark plugin README)
- uv
04 / FOLLOW THE EVIDENCE
The source trail.
Our notes are separate from the original resource.
Check upstream before adopting a new version.
- Graph Evolution SKILL.md ↗Checked
https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/trailmark/skills/graph-evolution/SKILL.md
Supports: upstreamDescription, summary, whySelected, bestFor, limitations, access, review.findings
- trailmark plugin README ↗Checked
https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/trailmark/README.md
Supports: install.prerequisites, install.steps
https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/plugins/trailmark/agents/code-slice-worker.md
Supports: compatibility
- trailofbits/skills README ↗Checked
https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/README.md
Supports: install.steps, license
- trailofbits/skills LICENSE ↗Checked
https://raw.githubusercontent.com/trailofbits/skills/8e54050ae63c2f62224c35b1616efe71865b4777/LICENSE
Supports: license