laxy-verify 1.2.3 → 1.3.0

package/dist/report-markdown.js

@@ -1,407 +1,407 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.shouldWriteMarkdownReport = shouldWriteMarkdownReport;
-exports.getMarkdownReportPath = getMarkdownReportPath;
-exports.buildMarkdownReport = buildMarkdownReport;
-const path = __importStar(require("node:path"));
-const visual_diff_js_1 = require("./visual-diff.js");
-function titleCasePlan(plan) {
-    switch (plan) {
-        case "pro":
-            return "Pro";
-        case "team":
-            return "Team";
-        default:
-            return "Free";
-    }
-}
-function titleCaseVerdict(verdict) {
-    return verdict
-        .split("-")
-        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
-        .join(" ");
-}
-function formatTimestamp(iso) {
-    const date = new Date(iso);
-    if (Number.isNaN(date.getTime()))
-        return iso;
-    return date.toISOString().replace("T", " ").replace(".000Z", " UTC");
-}
-function sentenceForVerdict(view) {
-    switch (view.verdict) {
-        case "client-ready":
-            return "Yes. This run collected enough evidence to support a client-ready call.";
-        case "release-ready":
-            return "Yes. This run collected enough evidence to support a release-ready call.";
-        case "hold":
-            return "No. This run found blockers that should be fixed before release.";
-        case "investigate":
-            return "Not yet. The project is standing, but there is not enough confidence to call it release-ready.";
-        case "build-failed":
-            return "No. The production build failed, so the release should be held immediately.";
-        default:
-            return "This run did not find an immediate hard blocker, but it is still a shallow release-confidence pass.";
-    }
-}
-function defaultNextActions(result) {
-    const view = result.verification?.view;
-    if (!view)
-        return ["Rerun verification after the project changes are applied."];
-    if (view.nextActions.length > 0)
-        return view.nextActions;
-    switch (view.verdict) {
-        case "client-ready":
-            return ["Send this version to the client, or rerun verification after meaningful UI or flow changes."];
-        case "release-ready":
-            return ["Ship this version, or archive this report as release evidence."];
-        case "investigate":
-            return ["Collect the missing verification evidence, then rerun the command before release."];
-        case "build-failed":
-            return ["Fix the production build first, then rerun the verification command."];
-        case "quick-pass":
-            return ["Run another full verification pass after the next meaningful change."];
-        default:
-            return ["Rerun verification after the blockers are fixed."];
-    }
-}
-function renderChecklist(title, items) {
-    if (items.length === 0) {
-        return `## ${title}\n\n- None.\n`;
-    }
-    return `## ${title}\n\n${items.map((item) => `- ${item}`).join("\n")}\n`;
-}
-function renderBuildErrors(errors) {
-    if (errors.length === 0)
-        return "";
-    const trimmed = errors.slice(0, 5).map((error) => error.trim()).filter(Boolean);
-    if (trimmed.length === 0)
-        return "";
-    return [
-        "## Build Errors",
-        "",
-        "```text",
-        ...trimmed,
-        "```",
-        "",
-    ].join("\n");
-}
-function renderE2EFailures(result) {
-    const failedScenarios = result.e2e?.results.filter((scenario) => !scenario.passed).slice(0, 5) ?? [];
-    if (failedScenarios.length === 0) {
-        return "";
-    }
-    const lines = ["## Failed E2E Scenarios", ""];
-    for (const scenario of failedScenarios) {
-        lines.push(`### ${scenario.name}`);
-        if (scenario.error) {
-            lines.push("", `- Error: ${scenario.error}`);
-        }
-        const failedSteps = scenario.steps.filter((step) => !step.passed).slice(0, 3);
-        if (failedSteps.length > 0) {
-            lines.push("", "- Failing steps:");
-            for (const step of failedSteps) {
-                const detail = step.error ? ` - ${step.error}` : "";
-                lines.push(`  - ${step.description}${detail}`);
-            }
-        }
-        lines.push("");
-    }
-    return `${lines.join("\n")}\n`;
-}
-function renderMetrics(result) {
-    const lines = ["## Verification Evidence", ""];
-    lines.push("| Check | Result |");
-    lines.push("|---|---|");
-    lines.push(`| Build | ${result.build.success ? "Passed" : "Failed"} in ${result.build.durationMs}ms |`);
-    if (result.lighthouse) {
-        lines.push(`| Lighthouse | P ${result.lighthouse.performance}, A ${result.lighthouse.accessibility}, SEO ${result.lighthouse.seo}, BP ${result.lighthouse.bestPractices} over ${result.lighthouse.runs} run(s) |`);
-    }
-    else {
-        lines.push("| Lighthouse | Skipped |");
-    }
-    if (result.e2e) {
-        lines.push(`| E2E | ${result.e2e.passed}/${result.e2e.total} passed |`);
-    }
-    const reportInput = result.verification?.report.evidence.input;
-    if (typeof reportInput?.viewportIssues === "number" || typeof reportInput?.multiViewportPassed === "boolean") {
-        lines.push(`| Multi-viewport | ${reportInput.multiViewportPassed ? "Passed" : "Needs work"}${reportInput.multiViewportSummary ? `, ${reportInput.multiViewportSummary}` : ""} |`);
-    }
-    if (result.visualDiff) {
-        lines.push(`| Visual diff | ${(0, visual_diff_js_1.formatVisualDiffSummary)(result.visualDiff)} |`);
-    }
-    if (result.typecheck && !result.typecheck.skipped) {
-        lines.push(`| TypeScript | ${result.typecheck.passed ? "OK" : `${result.typecheck.errorCount} error(s)`} |`);
-    }
-    if (result.secretScan && !result.secretScan.skipped) {
-        lines.push(`| Secret scan | ${result.secretScan.passed ? "OK" : `${result.secretScan.findings.length} finding(s)`} (${result.secretScan.filesScanned} files) |`);
-    }
-    if (result.bundleSize && !result.bundleSize.skipped) {
-        lines.push(`| Bundle size | ${result.bundleSize.advisory} |`);
-    }
-    if (result.outdatedCheck && !result.outdatedCheck.skipped) {
-        lines.push(`| Outdated deps | ${result.outdatedCheck.advisory} |`);
-    }
-    if (result.a11yDeep && !result.a11yDeep.skipped) {
-        lines.push(`| A11y deep | ${result.a11yDeep.summary} |`);
-    }
-    if (result.seoDeep && !result.seoDeep.skipped) {
-        lines.push(`| SEO deep | ${result.seoDeep.summary} |`);
-    }
-    if (result.vitalsBudget && !result.vitalsBudget.skipped) {
-        lines.push(`| Vitals budget | ${result.vitalsBudget.summary} |`);
-    }
-    lines.push("");
-    return `${lines.join("\n")}\n`;
-}
-function getReportFlavor(view) {
-    switch (view.tier) {
-        case "pro":
-            return "delivery";
-        case "team":
-            return "release";
-        default:
-            return "generic";
-    }
-}
-function sectionTitle(flavor, key) {
-    if (flavor === "delivery") {
-        switch (key) {
-            case "title":
-                return "Laxy Verify Delivery Report";
-            case "decision":
-                return "Client Delivery Call";
-            case "evidence":
-                return "Delivery Evidence";
-            case "passes":
-                return "What Looks Ready";
-            case "blockers":
-                return "Client-Facing Blockers";
-            case "warnings":
-                return "Watch Before Delivery";
-            case "nextActions":
-                return "Fix Before Sending";
-            case "recordedEvidence":
-                return "Proof Collected In This Run";
-            case "copy":
-                return "Copy For AI";
-            default:
-                return key;
-        }
-    }
-    if (flavor === "release") {
-        switch (key) {
-            case "title":
-                return "Laxy Verify Release Report";
-            case "decision":
-                return "Release Call";
-            case "evidence":
-                return "Release Evidence";
-            case "passes":
-                return "Release Signals That Passed";
-            case "blockers":
-                return "Release Blockers";
-            case "warnings":
-                return "Release Risks To Watch";
-            case "nextActions":
-                return "What Must Happen Next";
-            case "recordedEvidence":
-                return "Evidence Pack";
-            case "copy":
-                return "Copy For AI";
-            default:
-                return key;
-        }
-    }
-    switch (key) {
-        case "title":
-            return "Laxy Verify Report";
-        case "decision":
-            return "Decision";
-        case "evidence":
-            return "Verification Evidence";
-        case "passes":
-            return "What Passed";
-        case "blockers":
-            return "Blockers";
-        case "warnings":
-            return "Warnings";
-        case "nextActions":
-            return "Next Actions";
-        case "recordedEvidence":
-            return "Recorded Evidence";
-        case "copy":
-            return "Copy For AI";
-        default:
-            return key;
-    }
-}
-function renderCopyForAI(result, flavor) {
-    const view = result.verification?.view;
-    if (!view)
-        return "";
-    const blockers = view.blockers.map((blocker) => `- ${blocker.title}: ${blocker.action}`);
-    const warnings = view.warnings.map((warning) => `- ${warning.title}: ${warning.action}`);
-    const evidence = view.failureEvidence.map((item) => `- ${item}`);
-    const closingLine = view.verdict === "release-ready"
-        ? "Use this as release evidence, or rerun after any code change that could affect quality."
-        : view.verdict === "client-ready"
-            ? "Use this as client handoff evidence, or rerun after any code change that could affect user-facing flows."
-            : view.verdict === "investigate" && view.blockers.length === 0
-                ? "Collect the missing verification evidence, then rerun the command and compare the new report."
-                : "Please fix the blockers first, then rerun the verification command and compare the new report.";
-    const openingLine = flavor === "release"
-        ? "Use this release report to decide whether the project is truly ready to ship."
-        : flavor === "delivery"
-            ? "Use this delivery report to fix the project before sending it to a client."
-            : "Use this verification report to fix the project.";
-    const targetLine = flavor === "release"
-        ? "Goal: reach a release-ready verdict with strong viewport, visual, and user-flow evidence."
-        : flavor === "delivery"
-            ? "Goal: remove client-visible blockers and reach a confident client-ready call."
-            : "Goal: fix the blockers and improve confidence on the next run.";
-    return [
-        `## ${sectionTitle(flavor, "copy")}`,
-        "",
-        "```text",
-        openingLine,
-        "",
-        `Plan: ${titleCasePlan(result._plan)}`,
-        `Question: ${view.question}`,
-        `Verdict: ${titleCaseVerdict(view.verdict)}`,
-        targetLine,
-        "",
-        "Priority blockers:",
-        ...(blockers.length > 0 ? blockers : ["- None listed."]),
-        "",
-        "Warnings to review after blockers:",
-        ...(warnings.length > 0 ? warnings : ["- None listed."]),
-        "",
-        "Evidence from the verification run:",
-        ...(evidence.length > 0 ? evidence : ["- No extra evidence recorded."]),
-        "",
-        closingLine,
-        "```",
-        "",
-    ].join("\n");
-}
-function shouldWriteMarkdownReport(result) {
-    return result.verification?.view.showReportExport === true;
-}
-function getMarkdownReportPath(projectDir) {
-    return path.join(projectDir, "laxy-verify-report.md");
-}
-function buildMarkdownReport(projectDir, result) {
-    const projectName = path.basename(path.resolve(projectDir));
-    const plan = titleCasePlan(result._plan);
-    const view = result.verification?.view;
-    if (!view) {
-        return [
-            "# Laxy Verify Report",
-            "",
-            `Project: ${projectName}`,
-            `Generated: ${formatTimestamp(result.timestamp)}`,
-            "",
-            "No detailed verification report was available for this run.",
-            "",
-        ].join("\n");
-    }
-    const blockers = view.blockers.map((blocker) => `**${blocker.title}**\n  Why it matters: ${blocker.description}\n  What to do: ${blocker.action}`);
-    const warnings = view.warnings.map((warning) => `**${warning.title}**\n  Why it matters: ${warning.description}\n  What to do: ${warning.action}`);
-    const passes = view.passes.map((check) => `${check.passed ? "Passed" : "Failed"}: ${check.label}`);
-    const nextActions = defaultNextActions(result);
-    const flavor = getReportFlavor(view);
-    const decisionLead = flavor === "release"
-        ? "This section answers whether the current build is strong enough to call release-ready."
-        : flavor === "delivery"
-            ? "This section answers whether the current build is strong enough to call client-ready."
-            : "This section explains the outcome of the current verification run.";
-    const atAGlanceLead = flavor === "release"
-        ? "This report is written for a ship or hold decision."
-        : flavor === "delivery"
-            ? "This report is written for a client handoff decision."
-            : "This report is written for a quick verification summary.";
-    const decisionLabel = flavor === "release"
-        ? "Release recommendation"
-        : flavor === "delivery"
-            ? "Client delivery recommendation"
-            : "Recommendation";
-    return [
-        `# ${sectionTitle(flavor, "title")}`,
-        "",
-        `Project: ${projectName}`,
-        `Generated: ${formatTimestamp(result.timestamp)}`,
-        `Plan: ${plan}`,
-        `Framework: ${result.framework ?? "unknown"}`,
-        "",
-        "## At A Glance",
-        "",
-        atAGlanceLead,
-        "",
-        `Short answer: ${sentenceForVerdict(view)}`,
-        `Why: ${view.summary}`,
-        `Recommended next move: ${nextActions[0]}`,
-        "",
-        `## ${sectionTitle(flavor, "decision")}`,
-        "",
-        decisionLead,
-        "",
-        `Question: ${view.question}`,
-        `Answer: ${titleCaseVerdict(view.verdict)}`,
-        `Verdict: ${titleCaseVerdict(view.verdict)}`,
-        `${decisionLabel}: ${titleCaseVerdict(view.verdict)}`,
-        `Confidence: ${view.confidence}`,
-        `Grade: ${result.grade}`,
-        "",
-        renderMetrics(result).replace("## Verification Evidence", `## ${sectionTitle(flavor, "evidence")}`).trimEnd(),
-        "",
-        renderChecklist(sectionTitle(flavor, "passes"), passes).trimEnd(),
-        "",
-        renderChecklist(sectionTitle(flavor, "blockers"), blockers).trimEnd(),
-        "",
-        renderChecklist(sectionTitle(flavor, "warnings"), warnings).trimEnd(),
-        "",
-        renderChecklist(sectionTitle(flavor, "nextActions"), nextActions).trimEnd(),
-        "",
-        renderChecklist(sectionTitle(flavor, "recordedEvidence"), view.failureEvidence).trimEnd(),
-        "",
-        renderBuildErrors(result.build.errors).trimEnd(),
-        renderE2EFailures(result).trimEnd(),
-        renderCopyForAI(result, flavor).trimEnd(),
-        "",
-    ]
-        .filter(Boolean)
-        .join("\n");
-}
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.shouldWriteMarkdownReport = shouldWriteMarkdownReport;
+exports.getMarkdownReportPath = getMarkdownReportPath;
+exports.buildMarkdownReport = buildMarkdownReport;
+const path = __importStar(require("node:path"));
+const visual_diff_js_1 = require("./visual-diff.js");
+function titleCasePlan(plan) {
+    switch (plan) {
+        case "pro":
+            return "Pro";
+        case "team":
+            return "Team";
+        default:
+            return "Free";
+    }
+}
+function titleCaseVerdict(verdict) {
+    return verdict
+        .split("-")
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join(" ");
+}
+function formatTimestamp(iso) {
+    const date = new Date(iso);
+    if (Number.isNaN(date.getTime()))
+        return iso;
+    return date.toISOString().replace("T", " ").replace(".000Z", " UTC");
+}
+function sentenceForVerdict(view) {
+    switch (view.verdict) {
+        case "client-ready":
+            return "Yes. This run collected enough evidence to support a client-ready call.";
+        case "release-ready":
+            return "Yes. This run collected enough evidence to support a release-ready call.";
+        case "hold":
+            return "No. This run found blockers that should be fixed before release.";
+        case "investigate":
+            return "Not yet. The project is standing, but there is not enough confidence to call it release-ready.";
+        case "build-failed":
+            return "No. The production build failed, so the release should be held immediately.";
+        default:
+            return "This run did not find an immediate hard blocker, but it is still a shallow release-confidence pass.";
+    }
+}
+function defaultNextActions(result) {
+    const view = result.verification?.view;
+    if (!view)
+        return ["Rerun verification after the project changes are applied."];
+    if (view.nextActions.length > 0)
+        return view.nextActions;
+    switch (view.verdict) {
+        case "client-ready":
+            return ["Send this version to the client, or rerun verification after meaningful UI or flow changes."];
+        case "release-ready":
+            return ["Ship this version, or archive this report as release evidence."];
+        case "investigate":
+            return ["Collect the missing verification evidence, then rerun the command before release."];
+        case "build-failed":
+            return ["Fix the production build first, then rerun the verification command."];
+        case "quick-pass":
+            return ["Run another full verification pass after the next meaningful change."];
+        default:
+            return ["Rerun verification after the blockers are fixed."];
+    }
+}
+function renderChecklist(title, items) {
+    if (items.length === 0) {
+        return `## ${title}\n\n- None.\n`;
+    }
+    return `## ${title}\n\n${items.map((item) => `- ${item}`).join("\n")}\n`;
+}
+function renderBuildErrors(errors) {
+    if (errors.length === 0)
+        return "";
+    const trimmed = errors.slice(0, 5).map((error) => error.trim()).filter(Boolean);
+    if (trimmed.length === 0)
+        return "";
+    return [
+        "## Build Errors",
+        "",
+        "```text",
+        ...trimmed,
+        "```",
+        "",
+    ].join("\n");
+}
+function renderE2EFailures(result) {
+    const failedScenarios = result.e2e?.results.filter((scenario) => !scenario.passed).slice(0, 5) ?? [];
+    if (failedScenarios.length === 0) {
+        return "";
+    }
+    const lines = ["## Failed E2E Scenarios", ""];
+    for (const scenario of failedScenarios) {
+        lines.push(`### ${scenario.name}`);
+        if (scenario.error) {
+            lines.push("", `- Error: ${scenario.error}`);
+        }
+        const failedSteps = scenario.steps.filter((step) => !step.passed).slice(0, 3);
+        if (failedSteps.length > 0) {
+            lines.push("", "- Failing steps:");
+            for (const step of failedSteps) {
+                const detail = step.error ? ` - ${step.error}` : "";
+                lines.push(`  - ${step.description}${detail}`);
+            }
+        }
+        lines.push("");
+    }
+    return `${lines.join("\n")}\n`;
+}
+function renderMetrics(result) {
+    const lines = ["## Verification Evidence", ""];
+    lines.push("| Check | Result |");
+    lines.push("|---|---|");
+    lines.push(`| Build | ${result.build.success ? "Passed" : "Failed"} in ${result.build.durationMs}ms |`);
+    if (result.lighthouse) {
+        lines.push(`| Lighthouse | P ${result.lighthouse.performance}, A ${result.lighthouse.accessibility}, SEO ${result.lighthouse.seo}, BP ${result.lighthouse.bestPractices} over ${result.lighthouse.runs} run(s) |`);
+    }
+    else {
+        lines.push("| Lighthouse | Skipped |");
+    }
+    if (result.e2e) {
+        lines.push(`| E2E | ${result.e2e.passed}/${result.e2e.total} passed |`);
+    }
+    const reportInput = result.verification?.report.evidence.input;
+    if (typeof reportInput?.viewportIssues === "number" || typeof reportInput?.multiViewportPassed === "boolean") {
+        lines.push(`| Multi-viewport | ${reportInput.multiViewportPassed ? "Passed" : "Needs work"}${reportInput.multiViewportSummary ? `, ${reportInput.multiViewportSummary}` : ""} |`);
+    }
+    if (result.visualDiff) {
+        lines.push(`| Visual diff | ${(0, visual_diff_js_1.formatVisualDiffSummary)(result.visualDiff)} |`);
+    }
+    if (result.typecheck && !result.typecheck.skipped) {
+        lines.push(`| TypeScript | ${result.typecheck.passed ? "OK" : `${result.typecheck.errorCount} error(s)`} |`);
+    }
+    if (result.secretScan && !result.secretScan.skipped) {
+        lines.push(`| Secret scan | ${result.secretScan.passed ? "OK" : `${result.secretScan.findings.length} finding(s)`} (${result.secretScan.filesScanned} files) |`);
+    }
+    if (result.bundleSize && !result.bundleSize.skipped) {
+        lines.push(`| Bundle size | ${result.bundleSize.advisory} |`);
+    }
+    if (result.outdatedCheck && !result.outdatedCheck.skipped) {
+        lines.push(`| Outdated deps | ${result.outdatedCheck.advisory} |`);
+    }
+    if (result.a11yDeep && !result.a11yDeep.skipped) {
+        lines.push(`| A11y deep | ${result.a11yDeep.summary} |`);
+    }
+    if (result.seoDeep && !result.seoDeep.skipped) {
+        lines.push(`| SEO deep | ${result.seoDeep.summary} |`);
+    }
+    if (result.vitalsBudget && !result.vitalsBudget.skipped) {
+        lines.push(`| Vitals budget | ${result.vitalsBudget.summary} |`);
+    }
+    lines.push("");
+    return `${lines.join("\n")}\n`;
+}
+function getReportFlavor(view) {
+    switch (view.tier) {
+        case "pro":
+            return "delivery";
+        case "team":
+            return "release";
+        default:
+            return "generic";
+    }
+}
+function sectionTitle(flavor, key) {
+    if (flavor === "delivery") {
+        switch (key) {
+            case "title":
+                return "Laxy Verify Delivery Report";
+            case "decision":
+                return "Client Delivery Call";
+            case "evidence":
+                return "Delivery Evidence";
+            case "passes":
+                return "What Looks Ready";
+            case "blockers":
+                return "Client-Facing Blockers";
+            case "warnings":
+                return "Watch Before Delivery";
+            case "nextActions":
+                return "Fix Before Sending";
+            case "recordedEvidence":
+                return "Proof Collected In This Run";
+            case "copy":
+                return "Copy For AI";
+            default:
+                return key;
+        }
+    }
+    if (flavor === "release") {
+        switch (key) {
+            case "title":
+                return "Laxy Verify Release Report";
+            case "decision":
+                return "Release Call";
+            case "evidence":
+                return "Release Evidence";
+            case "passes":
+                return "Release Signals That Passed";
+            case "blockers":
+                return "Release Blockers";
+            case "warnings":
+                return "Release Risks To Watch";
+            case "nextActions":
+                return "What Must Happen Next";
+            case "recordedEvidence":
+                return "Evidence Pack";
+            case "copy":
+                return "Copy For AI";
+            default:
+                return key;
+        }
+    }
+    switch (key) {
+        case "title":
+            return "Laxy Verify Report";
+        case "decision":
+            return "Decision";
+        case "evidence":
+            return "Verification Evidence";
+        case "passes":
+            return "What Passed";
+        case "blockers":
+            return "Blockers";
+        case "warnings":
+            return "Warnings";
+        case "nextActions":
+            return "Next Actions";
+        case "recordedEvidence":
+            return "Recorded Evidence";
+        case "copy":
+            return "Copy For AI";
+        default:
+            return key;
+    }
+}
+function renderCopyForAI(result, flavor) {
+    const view = result.verification?.view;
+    if (!view)
+        return "";
+    const blockers = view.blockers.map((blocker) => `- ${blocker.title}: ${blocker.action}`);
+    const warnings = view.warnings.map((warning) => `- ${warning.title}: ${warning.action}`);
+    const evidence = view.failureEvidence.map((item) => `- ${item}`);
+    const closingLine = view.verdict === "release-ready"
+        ? "Use this as release evidence, or rerun after any code change that could affect quality."
+        : view.verdict === "client-ready"
+            ? "Use this as client handoff evidence, or rerun after any code change that could affect user-facing flows."
+            : view.verdict === "investigate" && view.blockers.length === 0
+                ? "Collect the missing verification evidence, then rerun the command and compare the new report."
+                : "Please fix the blockers first, then rerun the verification command and compare the new report.";
+    const openingLine = flavor === "release"
+        ? "Use this release report to decide whether the project is truly ready to ship."
+        : flavor === "delivery"
+            ? "Use this delivery report to fix the project before sending it to a client."
+            : "Use this verification report to fix the project.";
+    const targetLine = flavor === "release"
+        ? "Goal: reach a release-ready verdict with strong viewport, visual, and user-flow evidence."
+        : flavor === "delivery"
+            ? "Goal: remove client-visible blockers and reach a confident client-ready call."
+            : "Goal: fix the blockers and improve confidence on the next run.";
+    return [
+        `## ${sectionTitle(flavor, "copy")}`,
+        "",
+        "```text",
+        openingLine,
+        "",
+        `Plan: ${titleCasePlan(result._plan)}`,
+        `Question: ${view.question}`,
+        `Verdict: ${titleCaseVerdict(view.verdict)}`,
+        targetLine,
+        "",
+        "Priority blockers:",
+        ...(blockers.length > 0 ? blockers : ["- None listed."]),
+        "",
+        "Warnings to review after blockers:",
+        ...(warnings.length > 0 ? warnings : ["- None listed."]),
+        "",
+        "Evidence from the verification run:",
+        ...(evidence.length > 0 ? evidence : ["- No extra evidence recorded."]),
+        "",
+        closingLine,
+        "```",
+        "",
+    ].join("\n");
+}
+function shouldWriteMarkdownReport(result) {
+    return result.verification?.view.showReportExport === true;
+}
+function getMarkdownReportPath(projectDir) {
+    return path.join(projectDir, "laxy-verify-report.md");
+}
+function buildMarkdownReport(projectDir, result) {
+    const projectName = path.basename(path.resolve(projectDir));
+    const plan = titleCasePlan(result._plan);
+    const view = result.verification?.view;
+    if (!view) {
+        return [
+            "# Laxy Verify Report",
+            "",
+            `Project: ${projectName}`,
+            `Generated: ${formatTimestamp(result.timestamp)}`,
+            "",
+            "No detailed verification report was available for this run.",
+            "",
+        ].join("\n");
+    }
+    const blockers = view.blockers.map((blocker) => `**${blocker.title}**\n  Why it matters: ${blocker.description}\n  What to do: ${blocker.action}`);
+    const warnings = view.warnings.map((warning) => `**${warning.title}**\n  Why it matters: ${warning.description}\n  What to do: ${warning.action}`);
+    const passes = view.passes.map((check) => `${check.passed ? "Passed" : "Failed"}: ${check.label}`);
+    const nextActions = defaultNextActions(result);
+    const flavor = getReportFlavor(view);
+    const decisionLead = flavor === "release"
+        ? "This section answers whether the current build is strong enough to call release-ready."
+        : flavor === "delivery"
+            ? "This section answers whether the current build is strong enough to call client-ready."
+            : "This section explains the outcome of the current verification run.";
+    const atAGlanceLead = flavor === "release"
+        ? "This report is written for a ship or hold decision."
+        : flavor === "delivery"
+            ? "This report is written for a client handoff decision."
+            : "This report is written for a quick verification summary.";
+    const decisionLabel = flavor === "release"
+        ? "Release recommendation"
+        : flavor === "delivery"
+            ? "Client delivery recommendation"
+            : "Recommendation";
+    return [
+        `# ${sectionTitle(flavor, "title")}`,
+        "",
+        `Project: ${projectName}`,
+        `Generated: ${formatTimestamp(result.timestamp)}`,
+        `Plan: ${plan}`,
+        `Framework: ${result.framework ?? "unknown"}`,
+        "",
+        "## At A Glance",
+        "",
+        atAGlanceLead,
+        "",
+        `Short answer: ${sentenceForVerdict(view)}`,
+        `Why: ${view.summary}`,
+        `Recommended next move: ${nextActions[0]}`,
+        "",
+        `## ${sectionTitle(flavor, "decision")}`,
+        "",
+        decisionLead,
+        "",
+        `Question: ${view.question}`,
+        `Answer: ${titleCaseVerdict(view.verdict)}`,
+        `Verdict: ${titleCaseVerdict(view.verdict)}`,
+        `${decisionLabel}: ${titleCaseVerdict(view.verdict)}`,
+        `Confidence: ${view.confidence}`,
+        `Grade: ${result.grade}`,
+        "",
+        renderMetrics(result).replace("## Verification Evidence", `## ${sectionTitle(flavor, "evidence")}`).trimEnd(),
+        "",
+        renderChecklist(sectionTitle(flavor, "passes"), passes).trimEnd(),
+        "",
+        renderChecklist(sectionTitle(flavor, "blockers"), blockers).trimEnd(),
+        "",
+        renderChecklist(sectionTitle(flavor, "warnings"), warnings).trimEnd(),
+        "",
+        renderChecklist(sectionTitle(flavor, "nextActions"), nextActions).trimEnd(),
+        "",
+        renderChecklist(sectionTitle(flavor, "recordedEvidence"), view.failureEvidence).trimEnd(),
+        "",
+        renderBuildErrors(result.build.errors).trimEnd(),
+        renderE2EFailures(result).trimEnd(),
+        renderCopyForAI(result, flavor).trimEnd(),
+        "",
+    ]
+        .filter(Boolean)
+        .join("\n");
+}