Logo
NeoArc Studio

Using Project Reports

How to open, navigate, and act on Project Reports, covering the dashboard layout, auto-refresh behaviour, report tabs, PDF export with document verification, and guided fix navigation.

Project Reports provides a governance dashboard that analyses the workspace through the Intent Graph. This guide covers how to open the dashboard, interpret the headline metrics, navigate the report tabs, export reports as PDF documents, and use guided fixes to resolve issues directly from the dashboard.

Opening Project Reports

Dashboard Layout

The dashboard is organised into two regions:

  • Headline bar at the top, showing the summary metrics with colour-coded indicators (green for healthy, amber for warnings, red for critical issues).
  • Report tabs below, with one tab for each report type. Each tab contains a chart visualisation and a detailed issues table.

Auto-Refresh Behaviour

Reports regenerate automatically when the explorer index rebuilds. This happens after file saves, renames, and deletions. A 500ms debounce prevents excessive recalculation during rapid editing. The signal-based engine runs all reports in parallel, so results appear progressively as each report completes.

Report Tabs

Each tab analyses a specific aspect of the workspace.

Exporting Reports as PDF

Export reports as a professional PDF document for distribution to lead architects, governance boards, or team reviews. Individual report sections can be included or excluded via the section picker in the export dialog.

Document Verification
Every exported PDF includes a verification page with a SHA-256 content hash, generation timestamp, Git branch and commit SHA, and workspace dirty status. Leads can verify that a report was generated from a specific commit.
Raw Data Attachment
The PDF contains an attached report-data.json file with the complete raw report data. This allows independent verification or further analysis outside NeoArc Studio.
Full PDF Features
Report PDFs support the same features as site PDFs: infographic covers, repeating headers and footers, table of contents with clickable links, bookmarks, page numbers, watermarks, and password protection.

Using Guided Fixes