submit_audit_report
Submit a completed audit report to TestDino, including score, findings, and recommendations, so it is stored and attached to the correct audit context.
Instructions
FINAL STEP of the TestDino Playwright audit flow — submits a completed audit report. Requires write permission. Call this only AFTER get_audit_report(action='context') and after you have analyzed the local Playwright code and produced findings. score (0-100) and either markdownReport or markdownReportPath are required. Include findings, recommendations, reportName, branch, scope, and target as available. Every finding MUST include title, summary, and severity (low|medium|high|critical) — incomplete findings are rejected, not stored. target, if sent, accepts only { value, path }. orgId is required — resolve it via health() if you do not already have it. Use the same branch/scope/target you passed to get_audit_report(action='context') so the report attaches to the right audit context.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| orgId | Yes | Organization ID (Required to submit). Resolve via health() if you don't have it. | |
| scope | No | Audit scope. Defaults to 'suite'. Use 'feature' or 'spec_file' when the user names a slice such as auth/login, dashboards, or a specific spec. | |
| score | Yes | Final audit score (0-100). Required. | |
| branch | No | Git branch that was audited. Optional — auto-detected via git if omitted. | |
| target | No | Optional scoped-audit target. Only { value, path } (non-empty strings) are stored — the dashboard reads these; any other key is rejected. | |
| findings | No | Array of findings. Each finding REQUIRES title, summary, and severity (critical/high/medium/low) — a finding missing any of these is rejected, not stored. category must be one of: surface_level_tests, missing_validation, stability_issues, hard_to_maintain, coverage_gaps, organization_ownership, setup_configuration, duplication_overlap, other. Optional: subCategory, recommendation, and evidence (file, lineStart, lineEnd, observation). | |
| projectId | Yes | Project ID (Required). The TestDino project identifier. | |
| outputPath | No | Relative file path for the local save (see writeMarkdown). Resolved from TESTDINO_MCP_WORKSPACE. Defaults to TEST-AUDIT.md. | |
| reportName | No | Short human-readable title for the saved report (e.g. 'Login Flow Tests', 'API Integration Suite'). | |
| writeMarkdown | No | When true, also write the submitted markdown to a local file. Ignored when markdownReportPath was supplied (the file already exists on disk). | |
| markdownReport | No | The complete markdown report content. Prefer markdownReportPath to avoid large tool calls. | |
| recommendations | No | Array of recommendation strings. | |
| markdownReportPath | No | Path to a local markdown file to read for submission. Relative from TESTDINO_MCP_WORKSPACE (or an absolute path). Preferred over markdownReport. |