edgegate-mcp 0.2.0 → 0.2.2

package/README.md

@@ -4,7 +4,7 @@ MCP server for [EdgeGate](https://edgegate.frozo.ai) — set up edge-AI regressi
 
 ## What does it do?
 
-EdgeGate runs AI model regression tests on real Snapdragon hardware via Qualcomm AI Hub, then produces signed evidence bundles you can attach to CI gates. This npm package exposes EdgeGate's REST API as 7 MCP tools, plus 4 bundled skills, so you can drive the whole flow from a prompt:
+EdgeGate runs AI model regression tests on real Snapdragon hardware via Qualcomm AI Hub, then produces signed evidence bundles you can attach to CI gates. This npm package exposes EdgeGate's REST API as 9 MCP tools, plus 4 bundled skills, so you can drive the whole flow from a prompt:
 
 ```
 > Use the edgegate MCP to set up a CI gate for my MobileNet ONNX model.
@@ -68,6 +68,7 @@ See [docs/tools.md](./docs/tools.md) for the full tool reference. Quick list:
 | `edgegate_get_audit_report` | Fetch the signed audit PDF |
 | `edgegate_setup_github_action` | Generate the GitHub Actions workflow + secret commands |
 | `edgegate_compare_runs` | Diff two runs — gate flips, metric deltas, per-device breakdown, REGRESSION / IMPROVEMENT / NEUTRAL verdict |
+| `edgegate_export_run_report` | Save a complete run report as a markdown file to disk (returns the file path + preview) |
 
 ## Skills
 
@@ -76,7 +77,9 @@ Slash commands you can invoke directly:
 - `/edgegate-init` — full onboarding flow (zero → CI gate)
 - `/edgegate-gate` — trigger a run on an existing pipeline
 - `/edgegate-status` — check a run's status + metrics
-- `/edgegate-audit` — fetch the audit PDF for a run
+- `/edgegate-audit` — fetch the evidence bundle for a run
+- `/edgegate-compare` — diff two runs (auto-baseline) with REGRESSION/IMPROVEMENT/NEUTRAL verdict
+- `/edgegate-export` — save a run report as a markdown file (for PR comments, Slack, compliance)
 
 ## License
 

package/dist/server.js

@@ -12,6 +12,7 @@ import { getReportHandler, getReportInputSchema } from "./tools/get_report.js";
 import { getAuditReportHandler, getAuditReportInputSchema } from "./tools/get_audit_report.js";
 import { setupGithubActionHandler, setupGithubActionInputSchema, } from "./tools/setup_github_action.js";
 import { compareRunsHandler, compareRunsInputSchema, } from "./tools/compare_runs.js";
+import { exportRunReportHandler, exportRunReportInputSchema, } from "./tools/export_run_report.js";
 const TOOLS = [
     {
         name: "edgegate_setup_workspace",
@@ -70,6 +71,14 @@ const TOOLS = [
         schema: compareRunsInputSchema,
         handler: compareRunsHandler,
     },
+    {
+        name: "edgegate_export_run_report",
+        description: "Download a human-readable markdown report for an EdgeGate run and save it to disk. " +
+            "Returns the absolute file path plus a preview of the first 30 lines. " +
+            "Optionally includes a run-vs-baseline diff section (include_diff=true).",
+        schema: exportRunReportInputSchema,
+        handler: exportRunReportHandler,
+    },
 ];
 function getClient() {
     const apiUrl = process.env.EDGEGATE_API_URL ?? "https://edgegateapi.frozo.ai";

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/tools/export_run_report.d.ts

@@ -0,0 +1,35 @@
+/**
+ * edgegate_export_run_report — render a human-readable markdown report for a
+ * completed (or in-flight) EdgeGate run and write it to disk.
+ *
+ * Steps:
+ *  1. Fetch run detail via getRun
+ *  2. If the run is completed, fetch the evidence bundle via getRunBundle
+ *  3. Optionally fetch the run diff via getRunDiff (when include_diff=true)
+ *  4. Render a comprehensive markdown report
+ *  5. Write the file to disk (creating parent directories as needed)
+ *  6. Return the absolute file path + first ~30 lines of the report
+ */
+import { z } from "zod";
+import { tmpdir } from "node:os";
+import { EdgeGateClient } from "../client.js";
+import type { ToolResult } from "./setup_workspace.js";
+export declare const exportRunReportInputSchema: z.ZodObject<{
+    workspace_id: z.ZodString;
+    run_id: z.ZodString;
+    output_path: z.ZodOptional<z.ZodString>;
+    include_diff: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+}, "strip", z.ZodTypeAny, {
+    workspace_id: string;
+    run_id: string;
+    include_diff: boolean;
+    output_path?: string | undefined;
+}, {
+    workspace_id: string;
+    run_id: string;
+    output_path?: string | undefined;
+    include_diff?: boolean | undefined;
+}>;
+export type ExportRunReportInput = z.infer<typeof exportRunReportInputSchema>;
+export declare function exportRunReportHandler(client: EdgeGateClient, input: ExportRunReportInput): Promise<ToolResult>;
+export { tmpdir as _tmpdir };

package/dist/tools/export_run_report.js

@@ -0,0 +1,327 @@
+/**
+ * edgegate_export_run_report — render a human-readable markdown report for a
+ * completed (or in-flight) EdgeGate run and write it to disk.
+ *
+ * Steps:
+ *  1. Fetch run detail via getRun
+ *  2. If the run is completed, fetch the evidence bundle via getRunBundle
+ *  3. Optionally fetch the run diff via getRunDiff (when include_diff=true)
+ *  4. Render a comprehensive markdown report
+ *  5. Write the file to disk (creating parent directories as needed)
+ *  6. Return the absolute file path + first ~30 lines of the report
+ */
+import { z } from "zod";
+import { join } from "node:path";
+import { homedir, tmpdir } from "node:os";
+import { mkdir, stat, writeFile } from "node:fs/promises";
+import { EdgeGateError } from "../client.js";
+import { VERSION } from "../version.js";
+export const exportRunReportInputSchema = z.object({
+    workspace_id: z.string().uuid(),
+    run_id: z.string().uuid(),
+    output_path: z
+        .string()
+        .optional()
+        .describe("Where to write the markdown file. Defaults to `./edgegate-run-{id-short}.md` in the " +
+        "current working directory. If a directory, the file is named `edgegate-run-{id-short}.md` " +
+        "inside it. Supports `~` and relative paths."),
+    include_diff: z
+        .boolean()
+        .optional()
+        .default(false)
+        .describe("When true, also fetches the run-vs-baseline diff and appends a diff section to the report."),
+});
+// Terminal statuses that should have a bundle available
+const TERMINAL_STATUSES = new Set(["passed", "failed", "error"]);
+export async function exportRunReportHandler(client, input) {
+    try {
+        const { workspace_id, run_id, output_path, include_diff } = input;
+        // --- 1. Fetch run detail ---
+        let run;
+        try {
+            run = await client.getRun(workspace_id, run_id);
+        }
+        catch (err) {
+            if (err instanceof EdgeGateError) {
+                return {
+                    isError: true,
+                    content: [
+                        {
+                            type: "text",
+                            text: `Could not fetch run ${run_id}: ${err.detail}`,
+                        },
+                    ],
+                };
+            }
+            throw err;
+        }
+        // --- 2. Fetch evidence bundle (only for terminal runs) ---
+        let bundle = null;
+        if (TERMINAL_STATUSES.has(run.status)) {
+            try {
+                bundle = await client.getRunBundle(workspace_id, run_id);
+            }
+            catch (err) {
+                if (err instanceof EdgeGateError && (err.status === 404 || err.status === 409)) {
+                    // Bundle not ready yet — proceed without it
+                    bundle = null;
+                }
+                else {
+                    throw err;
+                }
+            }
+        }
+        // --- 3. Optionally fetch diff ---
+        let comparison = null;
+        if (include_diff) {
+            try {
+                comparison = await client.getRunDiff(workspace_id, run_id);
+            }
+            catch (err) {
+                if (err instanceof EdgeGateError && err.status === 404) {
+                    // No diff yet — silently omit the section
+                    comparison = null;
+                }
+                else if (err instanceof EdgeGateError) {
+                    // Non-fatal — skip the diff section but note it
+                    comparison = null;
+                }
+                else {
+                    throw err;
+                }
+            }
+        }
+        // --- 4. Render markdown ---
+        const markdown = renderReport(run, bundle, comparison, workspace_id);
+        // --- 5. Resolve output path ---
+        const idShort = run_id.slice(0, 8);
+        const defaultFilename = `edgegate-run-${idShort}.md`;
+        const resolvedPath = await resolveOutputPath(output_path, defaultFilename);
+        // Ensure parent directory exists
+        const parent = resolvedPath.slice(0, resolvedPath.lastIndexOf("/"));
+        if (parent) {
+            await mkdir(parent, { recursive: true });
+        }
+        // --- 6. Write the file ---
+        await writeFile(resolvedPath, markdown, "utf8");
+        // --- 7. Return result ---
+        const previewLines = markdown.split("\n").slice(0, 30).join("\n");
+        const header = `Wrote run report to ${resolvedPath}\n\n`;
+        return {
+            content: [{ type: "text", text: header + previewLines }],
+        };
+    }
+    catch (err) {
+        if (err instanceof EdgeGateError) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: `EdgeGate returned ${err.status}: ${err.detail}` }],
+            };
+        }
+        throw err;
+    }
+}
+// ─── Path resolution ──────────────────────────────────────────────────────────
+async function resolveOutputPath(outputPath, defaultFilename) {
+    if (!outputPath) {
+        // Default: CWD / edgegate-run-{id-short}.md
+        return join(process.cwd(), defaultFilename);
+    }
+    // Expand ~ to home dir
+    let expanded = outputPath;
+    if (expanded.startsWith("~/")) {
+        expanded = join(homedir(), expanded.slice(2));
+    }
+    else if (expanded === "~") {
+        expanded = homedir();
+    }
+    // Resolve relative to CWD
+    const resolved = expanded.startsWith("/") ? expanded : join(process.cwd(), expanded);
+    // Check if it's an existing directory
+    try {
+        const s = await stat(resolved);
+        if (s.isDirectory()) {
+            return join(resolved, defaultFilename);
+        }
+    }
+    catch {
+        // Doesn't exist yet — treat as file path
+    }
+    return resolved;
+}
+// ─── Rendering ────────────────────────────────────────────────────────────────
+function statusBadge(status) {
+    const upper = status.toUpperCase();
+    switch (upper) {
+        case "PASSED": return "**PASSED**";
+        case "FAILED": return "**FAILED**";
+        case "RUNNING": return "_RUNNING_";
+        case "PENDING": return "_PENDING_";
+        case "ERROR": return "**ERROR**";
+        default: return `_${upper}_`;
+    }
+}
+function wallClock(run) {
+    if (!run.completed_at || !run.created_at)
+        return "(pending)";
+    const startMs = new Date(run.created_at).getTime();
+    const endMs = new Date(run.completed_at).getTime();
+    const totalS = Math.round((endMs - startMs) / 1000);
+    const m = Math.floor(totalS / 60);
+    const s = totalS % 60;
+    return m > 0 ? `${m}m ${s}s` : `${s}s`;
+}
+function renderReport(run, bundle, comparison, workspaceId) {
+    const lines = [];
+    // ── Header ──
+    lines.push(`# EdgeGate Run Report`);
+    lines.push(``);
+    lines.push(`**Run ID:** \`${run.id}\``);
+    lines.push(`**Pipeline:** ${run.pipeline_name} (\`${run.pipeline_id}\`)`);
+    lines.push(`**Status:** ${statusBadge(run.status)}`);
+    lines.push(`**Trigger:** ${run.trigger}`);
+    lines.push(`**Created:** ${run.created_at}`);
+    lines.push(`**Completed:** ${run.completed_at ?? "(in flight)"}`);
+    lines.push(`**Wall clock:** ${wallClock(run)}`);
+    lines.push(``);
+    // ── Model ──
+    if (run.model_artifact_id || run.hub_model_id || run.hub_job_id) {
+        lines.push(`## Model`);
+        if (run.model_artifact_id)
+            lines.push(`- Artifact ID: \`${run.model_artifact_id}\``);
+        if (run.model_filename)
+            lines.push(`- Filename: ${run.model_filename}`);
+        if (run.hub_model_id)
+            lines.push(`- AI Hub model: \`${run.hub_model_id}\``);
+        if (run.hub_job_id)
+            lines.push(`- AI Hub job: \`${run.hub_job_id}\``);
+        lines.push(``);
+    }
+    // ── In-flight guard ──
+    const isComplete = TERMINAL_STATUSES.has(run.status) && (bundle !== null || run.gates_eval !== null);
+    if (!isComplete) {
+        lines.push(`## Status`);
+        lines.push(``);
+        lines.push(`_Run not yet complete — check back._`);
+        lines.push(``);
+        if (run.error_code) {
+            lines.push(`**Error code:** ${run.error_code}`);
+            if (run.error_detail)
+                lines.push(`**Error detail:** ${run.error_detail}`);
+            lines.push(``);
+        }
+        appendFooter(lines);
+        if (comparison)
+            appendDiffSection(lines, comparison);
+        return lines.join("\n");
+    }
+    // ── Metrics ──
+    const metrics = bundle?.normalized_metrics ?? run.normalized_metrics;
+    if (metrics && Object.keys(metrics).length > 0) {
+        lines.push(`## Metrics`);
+        lines.push(`| Metric | Value |`);
+        lines.push(`|---|---|`);
+        for (const [k, v] of Object.entries(metrics)) {
+            lines.push(`| ${k} | ${v} |`);
+        }
+        lines.push(``);
+    }
+    // ── Gate Results ──
+    const gatesEval = bundle?.gates_eval ?? run.gates_eval;
+    if (gatesEval && gatesEval.gates.length > 0) {
+        lines.push(`## Gate Results`);
+        lines.push(`| Metric | Operator | Threshold | Actual | Status |`);
+        lines.push(`|---|---|---|---|---|`);
+        for (const gate of gatesEval.gates) {
+            lines.push(renderGateRow(gate));
+        }
+        lines.push(``);
+        lines.push(`**Overall verdict:** ${gatesEval.passed ? "**PASSED**" : "**FAILED**"}`);
+        lines.push(``);
+    }
+    // ── Error info ──
+    if (run.error_code) {
+        lines.push(`## Error`);
+        lines.push(`- Code: ${run.error_code}`);
+        if (run.error_detail)
+            lines.push(`- Detail: ${run.error_detail}`);
+        lines.push(``);
+    }
+    // ── Evidence Bundle ──
+    const bundleArtifactId = bundle?.bundle_artifact_id ?? run.bundle_artifact_id;
+    if (bundleArtifactId) {
+        lines.push(`## Evidence Bundle`);
+        lines.push(`- Bundle artifact ID: \`${bundleArtifactId}\``);
+        lines.push(`- Download via API: \`GET /v1/workspaces/${workspaceId}/bundles/${bundleArtifactId}/artifact-url\`` +
+            ` (returns short-lived signed URL)`);
+        lines.push(``);
+    }
+    // ── Diff section ──
+    if (comparison) {
+        appendDiffSection(lines, comparison);
+    }
+    appendFooter(lines);
+    return lines.join("\n");
+}
+function renderGateRow(gate) {
+    const statusIcon = gate.passed ? "✓ PASSED" : "✗ FAILED";
+    return `| ${gate.metric} | ${gate.operator} | ${gate.threshold} | ${gate.actual_value} | ${statusIcon} |`;
+}
+function appendDiffSection(lines, comparison) {
+    const diff = comparison.diff;
+    lines.push(`## Run-vs-Baseline Diff`);
+    lines.push(``);
+    lines.push(`**Candidate:** \`${comparison.current_run_id}\`  ` +
+        `(${diff.current_completed_at ?? "in flight"})`);
+    lines.push(`**Baseline:** \`${comparison.previous_run_id ?? "—"}\`  ` +
+        `(${diff.previous_completed_at ?? "—"})`);
+    lines.push(``);
+    if (diff.is_baseline) {
+        lines.push(`> **NO BASELINE** — this is the first completed run in this pipeline.`);
+        lines.push(``);
+        return;
+    }
+    // Metrics
+    const metricKeys = Object.keys(diff.metric_deltas).sort();
+    if (metricKeys.length > 0) {
+        lines.push(`### Metrics`);
+        lines.push(`| Metric | Baseline | Candidate | Delta |`);
+        lines.push(`|---|---|---|---|`);
+        for (const k of metricKeys) {
+            const m = diff.metric_deltas[k];
+            const pct = m.delta_pct !== null
+                ? `${m.delta_pct > 0 ? "+" : ""}${m.delta_pct.toFixed(1)}%`
+                : "—";
+            const delta = m.delta !== null ? `${m.delta > 0 ? "+" : ""}${m.delta.toFixed(2)} (${pct})` : "—";
+            lines.push(`| ${k} | ${m.previous ?? "—"} | ${m.current ?? "—"} | ${delta} |`);
+        }
+        lines.push(``);
+    }
+    // Gate flips
+    if (diff.gate_flips.length > 0) {
+        lines.push(`### Gate Status`);
+        lines.push(`| Gate | Baseline | Candidate | Transition |`);
+        lines.push(`|---|---|---|---|`);
+        for (const gf of diff.gate_flips) {
+            const baseIcon = gf.previous?.passed === true ? "✓" : gf.previous?.passed === false ? "✗" : "—";
+            const candIcon = gf.current?.passed === true ? "✓" : gf.current?.passed === false ? "✗" : "—";
+            const label = gf.transition === "regressed" ? "**REGRESSION** ✓→✗"
+                : gf.transition === "improved" ? "RECOVERY ✗→✓"
+                    : gf.transition;
+            lines.push(`| ${gf.metric} | ${baseIcon} | ${candIcon} | ${label} |`);
+        }
+        lines.push(``);
+    }
+    // Audit
+    if (comparison.diff_sha256) {
+        lines.push(`**Diff SHA-256:** \`${comparison.diff_sha256}\` (signed, embedded in evidence bundle)`);
+        lines.push(``);
+    }
+}
+function appendFooter(lines) {
+    lines.push(`---`);
+    lines.push(`_Generated by edgegate-mcp@${VERSION} on ${new Date().toISOString()}_`);
+}
+// Export the tmpdir helper so tests can use the same default resolution logic
+export { tmpdir as _tmpdir };
+//# sourceMappingURL=export_run_report.js.map

package/dist/tools/export_run_report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"export_run_report.js","sourceRoot":"","sources":["../../src/tools/export_run_report.ts"],"names":[],"mappings":"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"}

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.2.0";
-export declare const USER_AGENT = "edgegate-mcp/0.2.0";
+export declare const VERSION = "0.2.2";
+export declare const USER_AGENT = "edgegate-mcp/0.2.2";

package/dist/version.js

@@ -1,3 +1,3 @@
-export const VERSION = "0.2.0";
+export const VERSION = "0.2.2";
 export const USER_AGENT = `edgegate-mcp/${VERSION}`;
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "edgegate-mcp",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "MCP server for EdgeGate — set up edge-AI regression gates from Claude Code, Cursor, or Claude Desktop.",
   "license": "MIT",
   "type": "module",

package/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "edgegate",
-  "version": "0.1.0",
-  "description": "Edge-AI regression gates from Claude Code — set up CI, run benchmarks, and fetch audit PDFs from any prompt.",
+  "version": "0.2.2",
+  "description": "Edge-AI regression gates from Claude Code — set up CI, run benchmarks, compare runs, export reports, and fetch audit bundles from any prompt.",
   "author": "Frozo / EdgeGate",
   "homepage": "https://edgegate.frozo.ai",
   "repository": "https://github.com/frozo-ai/edgegate-mcp",
@@ -21,6 +21,8 @@
     "skills/edgegate-init.md",
     "skills/edgegate-gate.md",
     "skills/edgegate-status.md",
-    "skills/edgegate-audit.md"
+    "skills/edgegate-audit.md",
+    "skills/edgegate-compare.md",
+    "skills/edgegate-export.md"
   ]
 }

package/skills/edgegate-compare.md

@@ -0,0 +1,31 @@
+---
+name: edgegate-compare
+description: Diff two EdgeGate runs in the same pipeline. Use when the user wants to know "what changed" between runs, "is this a regression", "compare these runs", or "show the delta vs main".
+---
+
+# /edgegate-compare
+
+The user wants to compare two EdgeGate runs and understand the verdict.
+
+## Steps
+
+1. **Identify the candidate run.** If the user gave you a `run_id`, use it. If they said "the latest run" or didn't specify, call `edgegate_get_report` to list recent runs and ask which one they mean.
+
+2. **Identify the baseline.**
+   - If the user provided a `baseline_run_id`, use it.
+   - Otherwise, omit the field — `edgegate_compare_runs` auto-selects the most recent PASSED run from the same pipeline (excluding the candidate). This is almost always what users want.
+
+3. **Call `edgegate_compare_runs`** with `workspace_id`, `run_id`, and optionally `baseline_run_id`.
+
+4. **Lead with the verdict.** The tool returns one of:
+   - **REGRESSION** — at least one gate flipped ✓→✗ OR a lower-is-better metric increased by ≥ 25%. Call this out at the top. List which gates flipped and what metric jumped.
+   - **IMPROVEMENT** — at least one ✗→✓ gate recovery with no regressions. Briefly highlight what got better.
+   - **NEUTRAL** — no significant changes. Reassure the user the run is safe to merge.
+   - **NO BASELINE** — this is the first run in the pipeline (nothing to compare against).
+
+5. **For PR comments:** suggest the user attach the metric deltas table + verdict line. The audit trail (signed diff SHA-256) is in the response and worth including for compliance.
+
+## Failure modes
+
+- **404 on the candidate** — wrong `run_id`. Ask the user to double-check or call `edgegate_get_report`.
+- **NO BASELINE on a pipeline that should have runs** — only one run exists in that pipeline OR the prior runs never completed. Check via `edgegate_get_report` and explain.

package/skills/edgegate-export.md

@@ -0,0 +1,34 @@
+---
+name: edgegate-export
+description: Save an EdgeGate run report as a markdown file on disk. Use when the user wants to "export", "download", "save", or "share" a run report — e.g. for a PR comment, Slack message, or compliance record.
+---
+
+# /edgegate-export
+
+The user wants the run report saved as a file they can share or attach.
+
+## Steps
+
+1. **Identify the run.** If they gave a `run_id`, use it. If not, call `edgegate_get_report` and ask which run.
+
+2. **Pick the output path.**
+   - If the user said "save to Downloads" or similar, use `~/Downloads`.
+   - If they said "save next to my code" or didn't specify, default to the current working directory (the tool defaults to `./edgegate-run-{id-short}.md`).
+   - If they said "save as <name>", use that exact filename.
+   - The tool accepts directory paths (auto-appends a filename), file paths (used as-is), `~/` (expanded to home), and relative paths.
+
+3. **Decide whether to include the diff.**
+   - If the user mentioned "for the PR" or "vs main" or "with the comparison", pass `include_diff: true` — adds the run-vs-baseline diff section to the report.
+   - Otherwise default `include_diff: false` — keeps the report focused on this run.
+
+4. **Call `edgegate_export_run_report`** with the args.
+
+5. **Confirm the file path** the tool returns and show the preview. Tell the user:
+   - The file is ready to attach to a PR comment, paste into Slack, or store with compliance records.
+   - If they want to also get a programmatic JSON version, point them at `edgegate_get_audit_report` for the bundle metadata.
+
+## Failure modes
+
+- **404 on the run** — wrong `run_id`. Check `edgegate_get_report`.
+- **In-flight run** — the report omits gate results and bundle sections (they don't exist yet) but still writes a partial file noting the status. Tell the user to retry after the run completes.
+- **Permission errors writing the file** — fall back to `/tmp/edgegate-run-{id}.md` and tell the user.

package/skills/edgegate-status.md

@@ -16,3 +16,7 @@ For PASSED runs, briefly summarize the metrics so the user has the numbers handy
 ## "Is this run a regression?"
 
 If the user asks whether a run is a regression, or wants to see how it compares to the previous one, call `edgegate_compare_runs` with the `run_id` (and optionally a `baseline_run_id`). The tool auto-selects the baseline from the same pipeline when no explicit baseline is given. Read the **Verdict** section of the output — REGRESSION means at least one gate flipped ✓→✗ or a lower-is-better metric increased by ≥ 25%.
+
+## "Save" or "export" the report
+
+If the user asks to save, export, or download the run report as a file, call `edgegate_export_run_report` with the `workspace_id`, `run_id`, and optionally an `output_path`. Pass `include_diff: true` if they also want the baseline comparison included in the file. The tool writes a complete markdown file to disk and returns the absolute path.