submit_audit_report
Submit the completed Playwright audit report with score, findings, and recommendations to finalize the audit flow and attach it to the correct 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. 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 | Structured audit target (e.g. spec path, feature area). Pass this when the audit was scoped to a specific slice. | |
| findings | No | Array of findings. Each should have: title, category, severity (critical/high/medium/low), summary, recommendation, and evidence (file, lineStart, lineEnd, observation). 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. | |
| 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. |