report

Generate penetration test report named: $ARGUMENTS

1. Setup:

   ═══════════════════════════════════════════
   REPORT GENERATION
   Name:    $ARGUMENTS
   Output:  reports/$ARGUMENTS.md
   Source:  evidence/ directory
   ═══════════════════════════════════════════
   

   Ensure mkdir -p reports/ exists.

2. Evidence Discovery: Find all findings files:

   • Glob evidence/**/*findings*.md
   • Glob evidence/**/*_report.md
   • Glob evidence/**/exploitation.md
   • Glob evidence/**/post_ex.md
   • Glob evidence/**/ad_findings.md
   • Glob evidence/**/web_findings.md
   • Glob evidence/**/api_findings.md
   • Glob evidence/**/network_findings.md

3. Invoke report-writer Agent: Delegate with:

   • List of all evidence files found
   • Engagement name: $ARGUMENTS
   • Read scope.txt for scope section
   • Consolidate all findings into the full report template
   • Sort findings by CVSS score (critical first)
   • Deduplicate overlapping findings
   • Write to reports/$ARGUMENTS.md

4. Quality Check: After writing:

   • Count findings by severity
   • Verify all CRITICAL findings have CVSS vectors
   • Verify all findings have remediation steps
   • Check for any [PLACEHOLDER] text left unreplaced
   • Verify no plaintext credentials in report (search for common patterns)

5. Print Report Summary:

   ═══ REPORT COMPLETE ════════════════════════════
   File:       reports/$ARGUMENTS.md
   Word count: $(wc -w reports/$ARGUMENTS.md | awk '{print $1}')
   Pages est.: ~$(wc -w reports/$ARGUMENTS.md | awk '{print int($1/300)}')
   
   Findings by severity:
     Critical: $(grep -c "| CRITICAL |" reports/$ARGUMENTS.md || echo 0)
     High:     $(grep -c "| HIGH |" reports/$ARGUMENTS.md || echo 0)
     Medium:   $(grep -c "| MEDIUM |" reports/$ARGUMENTS.md || echo 0)
     Low:      $(grep -c "| LOW |" reports/$ARGUMENTS.md || echo 0)
     Info:     $(grep -c "| INFO |" reports/$ARGUMENTS.md || echo 0)
   
   Top recommendations:
   [print first 3 critical/high finding titles]
   
   Report ready: reports/$ARGUMENTS.md
   ════════════════════════════════════════════════
   

If no evidence files are found, output:

⚠ No findings files found in evidence/
Run /project:engage <target> first to collect evidence.