Skip to content

HTML report: trace view (step timeline + findings), not a bare table - #55

Merged
AshwinUgale merged 1 commit into
mainfrom
feat/html-report-trace-view
Sep 4, 2026
Merged

HTML report: trace view (step timeline + findings), not a bare table#55
AshwinUgale merged 1 commit into
mainfrom
feat/html-report-trace-view

Conversation

@AshwinUgale

Copy link
Copy Markdown
Owner

"Option A" from the UI discussion: make the report tracelint already emits (--html) show what the agent did, not just a findings table — the honest, cheap "UI" (a static artifact, not a hosted app).

What changed

tracelint check spans.json --html report.html now renders each linted run as:

  • a step timeline — the agent's actual steps (messages, tool calls, results), with each step a finding touches marked inline by rule + tier (colored edge + badge);
  • finding cards beside it — tier chip, rule, finding_type, summary, and an evidence snippet;
  • a verification-coverage bar (evaluatable / total per rule).

render_html gained a traces= parameter (pass alongside reports=). Without it, the previous compact findings table still renders — so existing callers and tests are unchanged. _cmd_check now threads the traces through.

Honest by construction

Still a single self-contained file — inline CSS, no <script>, no external resources (a test enforces this). It reuses the canonical Trace + LintReport data already produced; no new plumbing, no backend. This is the "UI" as a report artifact, deliberately not a hosted dashboard (that would reintroduce "another place to go," against the strategy).

Tests

Added test_html_trace_view_shows_steps_and_findings (steps + finding + evidence render, still script-free). Full suite green; ruff clean.

Bonus: the generated report is now a real screenshot source for the site hero.

🤖 Generated with Claude Code

…re table

`tracelint check --html` now shows what happened, visually: each linted run
renders as the agent's step timeline — every step a finding touches is marked
inline with its rule and tier — beside finding cards (tier, rule, summary,
evidence) and a verification-coverage bar. The CLI now passes the traces
through; render_html gained a `traces=` param (without it, the compact findings
table still renders, so existing callers/tests are unchanged).

Still a single self-contained file: inline CSS, no scripts, no external
resources (the report stays script-free by design). Reuses the canonical Trace
+ LintReport data already produced — no new plumbing.

This is the "UI" done honestly: a static report artifact, not a hosted app.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@AshwinUgale
AshwinUgale merged commit 2bae96b into main Sep 4, 2026
3 checks passed
@AshwinUgale
AshwinUgale deleted the feat/html-report-trace-view branch September 4, 2026 02:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant