Skip to content

Remove stale triage CSV worksheet references from the report (+ refresh demo report)#598

Merged
kmcquade merged 2 commits into
masterfrom
docs/fix-in-report-triage-guidance
Jun 14, 2026
Merged

Remove stale triage CSV worksheet references from the report (+ refresh demo report)#598
kmcquade merged 2 commits into
masterfrom
docs/fix-in-report-triage-guidance

Conversation

@kmcquade

@kmcquade kmcquade commented Jun 14, 2026

Copy link
Copy Markdown
Collaborator

What

Removes the stale triage CSV worksheet wording from the report's in-app Triaging guidance, rebuilds the committed Vue bundle, and refreshes the demo report that embeds it.

  • cloudsplaining/output/src/assets/2-triage-guidance.md — the guidance source rendered in the HTML report (via Guidance.vue). It still told users to "attach the CSV worksheet" and "fill out the Triage CSV worksheet," which the scan no longer produces. Reframed to: review the HTML report and provide a justification for each finding.
  • cloudsplaining/output/dist/{index.html,js/index.js} — rebuilt bundle.
  • index.html — refreshed demo report, re-rendered so it embeds the corrected bundle.

This is the follow-up flagged in #597 (which fixed the docs-site copy of the same guidance).

How it was built (and why it's drift-free)

  • Bundle: rebuilt with npm run build directly rather than just build-js, to skip generate_example_iam_data.py (which would regenerate fixtures and risk finding drift).
  • Demo report: re-rendered with generate_example_report.py only (not just generate-report), so it re-embeds the new bundle using the existing committed fixture.

Verification:

  • compare-reports0 findings added, 0 removed; example-iam-data.json / sampleData.js untouched.
  • Corrected text present in both the bundle and the refreshed report; stale "fill out the Triage CSV worksheet" text is gone from both.
  • just test-js → 47 passing.
  • Demo report eyeballed in-browser — renders correctly.

🤖 Generated with Claude Code

The HTML report's Triaging guidance still told users to attach and fill out a
"Triage CSV worksheet" that the scan no longer generates. Update the in-report
guidance asset (2-triage-guidance.md) to ask reviewers to justify findings
against the HTML report directly, and rebuild the committed Vue bundle so the
generated report reflects it.

Rebuilt with `npm run build` (not `just build-js`) to avoid regenerating example
IAM fixtures; diff is limited to the asset and the dist bundle, no fixture drift.
Mirrors the docs-site fix in #597.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Re-render index.html from the existing committed fixture and the rebuilt Vue
bundle so the demo report no longer shows the stale "Triage CSV worksheet"
wording. Used generate_example_report.py (not generate-report) to avoid
regenerating fixtures: compare-reports confirms 0 findings added/removed, and
example-iam-data.json / sampleData.js are untouched.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@kmcquade kmcquade changed the title Remove stale triage CSV worksheet references from the in-report guidance Remove stale triage CSV worksheet references from the report (+ refresh demo report) Jun 14, 2026
@kmcquade kmcquade merged commit 75a67ea into master Jun 14, 2026
14 checks passed
@kmcquade kmcquade deleted the docs/fix-in-report-triage-guidance branch June 14, 2026 23:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant