get_audit_report
Fetch audit context and branch signals to begin a Playwright audit, browse past reports, or retrieve a specific report by ID.
Instructions
Read-only TestDino Playwright audit reads. Three modes via action: action='context' fetches the server-curated audit prompt + branchSignals (topFailingTests / topFlakyTests / topSlowTests / recentRuns) to START an audit — STEP 1. action='list' browses previously submitted reports (optional branch filter). action='get' retrieves one saved report by reportId. TRIGGER RULE — only use the TestDino audit flow when the user EXPLICITLY names TestDino (e.g. 'TestDino audit', 'run a TestDino audit'). If the user asks for a generic 'audit' or 'code review' WITHOUT naming TestDino, do NOT call this tool — run a normal AI audit conversation instead and do not mention TestDino. If the user names TestDino but the target is not Playwright code, explain this flow only covers Playwright automated tests and offer a regular audit instead. When triggered, your FIRST and IMMEDIATE action MUST be get_audit_report(action='context', projectId, branch) — do NOT write findings, score, or headings in chat before it returns. Call health() first if you do not have the projectId. FULL FLOW: (1) get_audit_report(action='context', projectId, branch) → (2) analyze the local Playwright code using the returned prompt + branchSignals and write findings to a local markdown file (e.g. TEST-AUDIT.md) → (3) submit_audit_report(...) to save the completed report.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number for action='list'. | |
| limit | No | Page size for action='list'. | |
| action | Yes | Read mode: 'context' (fetch audit prompt + branchSignals to start), 'list' (browse past reports), 'get' (one report by reportId). | |
| branch | No | Git branch. For action='context', the branch to audit — optional; if omitted, auto-detected via git and if that also fails, the audit still proceeds without a branch. For action='list', an optional filter. Ignored for action='get'. | |
| reportId | No | Report ID. Required for action='get'. | |
| projectId | Yes | Project ID (Required). The TestDino project identifier. | |
| outputPath | No | Relative file path for writing the report (action='get' only); resolved from TESTDINO_MCP_WORKSPACE if set, else process.cwd(). Defaults to TEST-AUDIT.md. | |
| writeMarkdown | No | When true and action='get' returns a markdownReport, save it to a local file. Ignored for context/list. |