Files
NeuroSploit/neurosploit-rs/templates/report.typ
T
CyberSecurityUPandClaude Opus 5 53a6a45448 feat(report): CVSS v3.1 with vectors, a PDF that survives long payloads, capped over-claims
Driven by the Arena Hockey engagement, where all 24 findings shipped with an
empty CVSS field and the PDF ran payloads off the page edge.

CVSS
- Derived deterministically from what the harness knows: the weakness class
  sets the impact shape, the PROVEN exploitability sets attack complexity, and
  the auth context sets privileges required. The vector is emitted with the
  score, because a score without its vector cannot be checked and an unchecked
  score is just a bigger adjective.
- The base equation is the v3.1 specification verbatim, including round-up and
  the scope-changed privileges table. Tests anchor it against known values
  (9.8 unauthenticated RCE, 10.0 with scope change, 6.1 reflected XSS, 0.0 for
  no impact).
- An unknown weakness stays conservative — guessing high impact from a class
  nobody mapped is how reports get inflated. An agent-supplied score is never
  overwritten.

PDF
- Steps are passed as an ARRAY and rendered as a real numbered list, one command
  per box. The previous template flattened them into a single `raw` block, which
  rendered five separate commands as one run-on paragraph.
- Finding blocks are breakable, so a long evidence dump flows to the next page
  instead of off the bottom of this one.
- `wrappable()` inserts zero-width breaks so encoded payloads wrap. The first
  attempt broke prose mid-word ("rota ted", "lockoutOnFailu re=false") by
  breaking every N characters regardless of context; it now works per token and
  leaves anything that fits on a line exactly as it was.
- rebuild() re-enriches before rendering, so a run that finished before a
  mapping existed picks it up instead of reprinting the gap forever.

Over-claimed findings are capped, not deleted
- The engagement rejected "no rate limiting on the password-reset flow" because
  the agent claimed inbox flooding and only proved 25 unthrottled requests. The
  claim was inflated; the measurement was real, and dropping it hid a genuine
  gap. A unanimously rejected finding that still carries a checkable receipt is
  now capped to Low and flagged for review, with the validator's reason
  attached — the reader gets the fact without the story built on it.
- The agent contract now says impact must be what was MEASURED, and warns that
  inflating it costs the whole finding.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-14 00:22:10 -03:00

234 lines
8.6 KiB
Typst

// NeuroSploit v3.5.1 — Typst report template (blank, structured).
//
// The harness generates `report.typ` per run by prepending a `findings` array
// and a `meta` dict, then including this template's rendering logic. This file
// is the reference/blank template: it renders a cover, an executive summary with
// severity counts, and one section per finding. Compile with:
// typst compile report.typ report.pdf
//
// Expected inputs (defined above this template in the generated file):
// #let meta = (target: "", run_id: "", generated: "", model: "")
// #let findings = ( (severity: "", title: "", agent: "", cwe: "", cvss: "",
// endpoint: "", payload: "", evidence: "", impact: "",
// remediation: "", votes: "", confidence: 0.0,
// location: "", steps: ""), ... )
#let sevcolor = (
Critical: rgb("#c0392b"), High: rgb("#e67e22"), Medium: rgb("#f1c40f"),
Low: rgb("#3498db"), Info: rgb("#7f8c8d"),
)
#let sevbadge(s) = box(
fill: sevcolor.at(s, default: rgb("#7f8c8d")), inset: (x: 5pt, y: 2pt),
radius: 3pt, text(fill: white, weight: "bold", size: 8pt, upper(s)),
)
#let sevrank(s) = (Critical: 0, High: 1, Medium: 2, Low: 3, Info: 4).at(s, default: 5)
// A section label inside a finding: consistent spacing, so the eye can find
// "How to fix it" without reading the paragraph above it.
#let sectionhead(t) = [
#v(7pt)
#text(9pt, weight: "bold", fill: rgb("#2c3e50"), upper(t))
#v(3pt)
]
// Machine text: monospaced, on a tinted ground, wrapping at the zero-width
// breaks the generator inserted. `raw` is deliberately NOT used — it refuses to
// wrap, which is what pushed payloads off the page edge.
#let codebox(body) = block(
width: 100%, breakable: true, fill: rgb("#f7f7f9"), inset: 6pt, radius: 4pt,
stroke: 0.5pt + rgb("#e4e4e8"),
)[
#set par(justify: false, leading: 0.55em)
#text(font: ("Menlo", "DejaVu Sans Mono", "Courier New"), size: 7.5pt)[#body]
]
// "9.8 (CVSS:3.1/AV:N/...)" — the number reads large, the vector stays legible
// underneath so the score can be checked rather than believed.
#let cvssline(v) = {
let parts = v.split(" (")
let score = parts.at(0, default: v)
let vector = if parts.len() > 1 { parts.at(1).trim(")") } else { "" }
[#text(weight: "bold")[#score] #if vector != "" [ #linebreak() #text(6.5pt, fill: gray, font: ("Menlo", "Courier New"))[#vector] ]]
}
#set page(margin: 2cm, numbering: "1", footer: context [
#set text(size: 8pt, fill: gray)
NeuroSploit v3.5.1 · #meta.target · confidential
#h(1fr) #counter(page).display()
])
#set text(font: ("Helvetica Neue", "Helvetica", "Arial"), size: 10pt)
#set heading(numbering: none)
// ---- Cover ----
#v(3cm)
#align(center)[
#text(28pt, weight: "bold")[#text(fill: rgb("#7c5cff"))[Neuro]Sploit]
#v(2pt)
#text(15pt, fill: gray)[Penetration Test Report]
#v(1cm)
#text(14pt)[Asset: #strong(meta.asset)]
#v(4pt)
#text(11pt, fill: gray)[#meta.target]
#v(2pt)
#if meta.tech != "" [ #text(9pt, fill: gray)[Stack: #meta.tech] #v(2pt) ]
#v(6pt)
#text(10pt, fill: gray)[Run #meta.run_id · #meta.generated · models: #meta.model]
#v(8pt)
#text(9pt, fill: gray)[by #strong[Joas A Santos] & #strong[Red Team Leaders]]
]
#pagebreak()
// ---- Asset under test ----
= Asset Under Test
#table(columns: (auto, 1fr), inset: 6pt, stroke: 0.5pt + rgb("#dddddd"), align: left + horizon,
text(9pt, fill: gray)[Asset], text(9pt)[#strong(meta.asset)],
text(9pt, fill: gray)[URL / target], text(9pt)[#raw(meta.target)],
..(if meta.tech != "" { (text(9pt, fill: gray)[Technology], text(9pt)[#meta.tech]) } else { () }),
..(if meta.server != "" { (text(9pt, fill: gray)[Server], text(9pt)[#meta.server]) } else { () }),
)
#v(8pt)
// ---- Executive summary ----
= Executive Summary
#text(10pt)[#meta.exec]
#let counts = (:)
#for f in findings {
if f.status != "needs-review" { counts.insert(f.severity, counts.at(f.severity, default: 0) + 1) }
}
#if findings.len() == 0 [
] else [
#v(6pt)
#grid(columns: 5, gutter: 8pt,
..("Critical", "High", "Medium", "Low", "Info").map(s => box(
width: 100%, inset: 8pt, radius: 6pt, stroke: 0.5pt + sevcolor.at(s),
align(center)[
#text(18pt, weight: "bold", fill: sevcolor.at(s))[#str(counts.at(s, default: 0))]
#v(-4pt) #text(8pt, upper(s))
],
))
)
]
#let sorted = findings.sorted(key: f => sevrank(f.severity))
// ---- Vulnerability summary table ----
#if sorted.len() > 0 [
#v(8pt)
== Vulnerability Summary
#v(4pt)
#table(
columns: (auto, 1fr, auto, auto, auto),
inset: 6pt, align: (left + horizon, left + horizon, center + horizon, center + horizon, center + horizon),
stroke: 0.5pt + rgb("#dddddd"),
table.header(
text(weight: "bold")[\#], text(weight: "bold")[Vulnerability],
text(weight: "bold")[Severity], text(weight: "bold")[Status], text(weight: "bold")[OWASP / CWE],
),
..sorted.enumerate().map(((i, f)) => (
str(i + 1), f.title, sevbadge(f.severity),
if f.status == "needs-review" { text(8pt, fill: rgb("#8e44ad"))[needs-review] } else { text(8pt, fill: rgb("#27ae60"))[confirmed] },
f.owasp,
)).flatten()
)
]
// ---- Test accounts created ----
#if meta.accounts != "" [
#v(8pt)
== Test Accounts Created (delete after)
#v(3pt)
#text(9pt, fill: gray)[Created to reach the authenticated surface. Credentials are in the run vault (.neurosploit/vault/<run-id>.json); delete once testing is complete.]
#v(3pt)
#block(width: 100%, inset: 8pt, radius: 4pt, fill: rgb("#faf7ff"), text(9pt)[#meta.accounts])
]
#v(10pt)
#line(length: 100%, stroke: 0.5pt + gray)
// ---- Detailed findings ----
= Findings
#if sorted.len() == 0 [
#text(fill: gray)[_Nothing to report._]
]
#for (i, f) in sorted.enumerate() [
// Breakable: a finding with a long evidence dump must flow onto the next
// page instead of overflowing off the bottom of this one.
#block(breakable: true, width: 100%, inset: 10pt, radius: 6pt, above: 10pt,
stroke: (left: 3pt + sevcolor.at(f.severity, default: gray), rest: 0.5pt + rgb("#dddddd")))[
#sevbadge(f.severity) #h(6pt)
#if f.status == "needs-review" [ #box(fill: rgb("#8e44ad"), inset: (x: 5pt, y: 2pt), radius: 3pt, text(fill: white, weight: "bold", size: 8pt)[NEEDS REVIEW]) #h(6pt) ]
#text(12pt, weight: "bold")[#str(i + 1). #f.title]
#v(5pt)
#table(
columns: (auto, 1fr, auto, 1fr),
inset: 4pt, stroke: none, align: left + top,
text(8pt, fill: gray)[Severity], text(8pt)[#f.severity],
text(8pt, fill: gray)[Status], text(8pt)[#f.status],
text(8pt, fill: gray)[OWASP / CWE], text(8pt)[#f.owasp · #f.cwe],
text(8pt, fill: gray)[Confidence], text(8pt)[#f.votes · #str(f.confidence)],
..(if f.at("cvss", default: "") != "" {
(text(8pt, fill: gray)[CVSS v3.1], text(8pt)[#cvssline(f.cvss)],
text(8pt, fill: gray)[Auth context], text(8pt)[#f.auth])
} else {
(text(8pt, fill: gray)[Auth context], text(8pt)[#f.auth], [], [])
}),
text(8pt, fill: gray)[Agent], text(8pt)[#raw(f.agent)],
[], [],
)
#v(2pt)
#sectionhead("Where the problem is")
#text(9pt)[#f.at("location", default: f.endpoint)]
#sectionhead("What it means")
#text(9pt)[#f.impact]
#sectionhead("How to fix it")
#text(9pt)[#f.remediation]
#let steps = f.at("steps", default: ())
#if type(steps) == array and steps.len() > 0 [
#sectionhead("Proof of concept — step by step")
// A real numbered list, one command per item. The previous template
// pushed every step into a single raw block, which rendered as one
// run-on paragraph nobody could follow or paste.
#for (n, st) in steps.enumerate() [
#grid(columns: (16pt, 1fr), gutter: 4pt,
text(8pt, fill: gray, weight: "bold")[#str(n + 1).],
codebox(st),
)
#v(3pt)
]
] else if f.payload != "" [
#sectionhead("Proof of concept")
#codebox(f.payload)
]
#if f.payload != "" and type(steps) == array and steps.len() > 0 [
#sectionhead("Payload")
#codebox(f.payload)
]
#if f.evidence != "" [
#sectionhead("Technical evidence")
#codebox(f.evidence)
]
#let shots = f.at("screenshots", default: ())
#if shots.len() > 0 [
#sectionhead("Proof screenshots")
#for sp in shots [
#v(3pt)
#block(breakable: false, width: 100%)[
#box(stroke: 0.5pt + rgb("#dddddd"), radius: 4pt, clip: true, image(sp, width: 100%))
#v(2pt) #text(7pt, fill: gray, font: "Menlo")[#sp]
]
]
]
]
]
// ---- Conclusion ----
#v(6pt)
#line(length: 100%, stroke: 0.5pt + gray)
= Conclusion
#text(10pt)[#meta.conclusion]