trailmark-structural

# Trailmark Structural Analysis Runs `trailmark analyze` with all four pre-analysis passes. ## When to Use - Vivisect Phase 1 needs full structural data (hotspots, taint, blast radius, privilege boundaries) - Detailed pre-analysis passes for a specific target scope - Generating complexity and taint data for audit prioritization ## When NOT to Use - Quick overview only (use `trailmark-summary` instead) - Ad-hoc code graph queries (use the main `trailmark` skill directly) - Target is a single small file where structural analysis adds no value ## Rationalizations to Reject | Rationalization | Why It's Wrong | Required Action | |-----------------|----------------|-----------------| | "Summary analysis is enough" | Summary skips taint, blast radius, and privilege boundary data | Run full structural analysis when detailed data is needed | | "One pass is sufficient" | Passes cross-reference each other — taint without blast radius misses critical nodes | Run all four passes | | "Tool isn't installed, I'll analyze manually" | Manual analysis misses what tooling catches | Report "trailmark is not installed" and return | | "Empty pass output means the pass failed" | Some passes produce no data for some codebases (e.g., no privilege boundaries) | Return full output regardless | ## Usage The target directory is passed via the `args` parameter. ## Execution **Step 1: Check that trailmark is available.** ```bash trailmark analyze --help 2>/dev/null || \ uv run trailmark analyz...