@anselmdk/feature-spec-md 0.5.0 → 0.6.1

package/dist/mocks/current/tests/supportDesk.spec.d.ts

@@ -0,0 +1,3 @@
+export declare function verifiesTicketInboxMock(): ("High priority" | "Low priority" | "Normal priority")[];
+export declare function verifiesReplyDraftMock(): string;
+//# sourceMappingURL=supportDesk.spec.d.ts.map

package/dist/mocks/current/tests/supportDesk.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supportDesk.spec.d.ts","sourceRoot":"","sources":["../../../../src/mocks/current/tests/supportDesk.spec.ts"],"names":[],"mappings":"AAOA,wBAAgB,uBAAuB,6DAItC;AAED,wBAAgB,sBAAsB,WAGrC"}

package/dist/mocks/current/tests/supportDesk.spec.js

@@ -0,0 +1,15 @@
+import { draftReply, priorityBadge, visibleTickets } from "../app/supportDesk.js";
+const tickets = [
+    { id: "T-2", title: "Newer", status: "open", priority: "high", createdAt: "2026-01-02T10:00:00Z" },
+    { id: "T-1", title: "Older", status: "open", priority: "normal", createdAt: "2026-01-01T10:00:00Z" },
+];
+export function verifiesTicketInboxMock() {
+    // Covers SUPPORT-M001, SUPPORT-M002, SUPPORT-M003 and SUPPORT-M-R001.
+    // Covers SUPPORT-INBOX-R001, SUPPORT-INBOX-R002 and SUPPORT-INBOX-S001.
+    return visibleTickets(tickets).map((ticket) => priorityBadge(ticket));
+}
+export function verifiesReplyDraftMock() {
+    // Covers SUPPORT-REPLY-R001 and SUPPORT-REPLY-S001.
+    return draftReply("Existing draft", "Updated draft");
+}
+//# sourceMappingURL=supportDesk.spec.js.map

package/dist/mocks/current/tests/supportDesk.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supportDesk.spec.js","sourceRoot":"","sources":["../../../../src/mocks/current/tests/supportDesk.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAElF,MAAM,OAAO,GAAG;IACd,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAe,EAAE,QAAQ,EAAE,MAAe,EAAE,SAAS,EAAE,sBAAsB,EAAE;IACpH,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAe,EAAE,QAAQ,EAAE,QAAiB,EAAE,SAAS,EAAE,sBAAsB,EAAE;CACvH,CAAC;AAEF,MAAM,UAAU,uBAAuB;IACrC,sEAAsE;IACtE,wEAAwE;IACxE,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;AACxE,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,oDAAoD;IACpD,OAAO,UAAU,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC;AACvD,CAAC"}

package/dist/mocks/previous/app/supportDesk.d.ts

@@ -0,0 +1,10 @@
+export type Ticket = {
+    id: string;
+    title: string;
+    status: "open" | "closed";
+    priority: "low" | "normal" | "high";
+    createdAt: string;
+};
+export declare function visibleTickets(tickets: Ticket[]): Ticket[];
+export declare function draftReply(existingDraft: string, nextText: string): string;
+//# sourceMappingURL=supportDesk.d.ts.map

package/dist/mocks/previous/app/supportDesk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supportDesk.d.ts","sourceRoot":"","sources":["../../../../src/mocks/previous/app/supportDesk.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,GAAG;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC1B,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpC,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,YAI/C;AAED,wBAAgB,UAAU,CAAC,aAAa,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,UAEjE"}

package/dist/mocks/previous/app/supportDesk.js

@@ -0,0 +1,9 @@
+export function visibleTickets(tickets) {
+    return tickets
+        .filter((ticket) => ticket.status === "open")
+        .sort((a, b) => Date.parse(a.createdAt) - Date.parse(b.createdAt));
+}
+export function draftReply(existingDraft, nextText) {
+    return nextText.trim() ? nextText : existingDraft;
+}
+//# sourceMappingURL=supportDesk.js.map

package/dist/mocks/previous/app/supportDesk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supportDesk.js","sourceRoot":"","sources":["../../../../src/mocks/previous/app/supportDesk.ts"],"names":[],"mappings":"AAQA,MAAM,UAAU,cAAc,CAAC,OAAiB;IAC9C,OAAO,OAAO;SACX,MAAM,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,MAAM,CAAC;SAC5C,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,aAAqB,EAAE,QAAgB;IAChE,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC;AACpD,CAAC"}

package/dist/mocks/previous/tests/supportDesk.spec.d.ts

@@ -0,0 +1,3 @@
+export declare function verifiesTicketInboxMock(): import("../app/supportDesk.js").Ticket[];
+export declare function verifiesReplyDraftMock(): string;
+//# sourceMappingURL=supportDesk.spec.d.ts.map

package/dist/mocks/previous/tests/supportDesk.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"supportDesk.spec.d.ts","sourceRoot":"","sources":["../../../../src/mocks/previous/tests/supportDesk.spec.ts"],"names":[],"mappings":"AAOA,wBAAgB,uBAAuB,6CAItC;AAED,wBAAgB,sBAAsB,WAGrC"}

package/dist/mocks/previous/tests/supportDesk.spec.js

@@ -0,0 +1,15 @@
+import { draftReply, visibleTickets } from "../app/supportDesk.js";
+const tickets = [
+    { id: "T-2", title: "Newer", status: "open", priority: "high", createdAt: "2026-01-02T10:00:00Z" },
+    { id: "T-1", title: "Older", status: "open", priority: "normal", createdAt: "2026-01-01T10:00:00Z" },
+];
+export function verifiesTicketInboxMock() {
+    // Covers SUPPORT-M001, SUPPORT-M002, SUPPORT-M003 and SUPPORT-M-R001.
+    // Covers SUPPORT-INBOX-R001 and SUPPORT-INBOX-S001.
+    return visibleTickets(tickets);
+}
+export function verifiesReplyDraftMock() {
+    // Covers SUPPORT-REPLY-R001 and SUPPORT-REPLY-S001.
+    return draftReply("Existing draft", "Updated draft");
+}
+//# sourceMappingURL=supportDesk.spec.js.map

package/dist/mocks/previous/tests/supportDesk.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"supportDesk.spec.js","sourceRoot":"","sources":["../../../../src/mocks/previous/tests/supportDesk.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEnE,MAAM,OAAO,GAAG;IACd,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAe,EAAE,QAAQ,EAAE,MAAe,EAAE,SAAS,EAAE,sBAAsB,EAAE;IACpH,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAe,EAAE,QAAQ,EAAE,QAAiB,EAAE,SAAS,EAAE,sBAAsB,EAAE;CACvH,CAAC;AAEF,MAAM,UAAU,uBAAuB;IACrC,sEAAsE;IACtE,oDAAoD;IACpD,OAAO,cAAc,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC;AAED,MAAM,UAAU,sBAAsB;IACpC,oDAAoD;IACpD,OAAO,UAAU,CAAC,gBAAgB,EAAE,eAAe,CAAC,CAAC;AACvD,CAAC"}

package/dist/reportArtifacts.d.ts

@@ -0,0 +1,7 @@
+export declare const publishedSpecRoot = "__feature-spec-md/specs";
+export type PublishedSpecManifestItem = {
+    filePath: string;
+    publishedPath: string;
+};
+export declare function writePublishedFeatureSpecFiles(reportDir: string, patterns: string[]): Promise<void>;
+//# sourceMappingURL=reportArtifacts.d.ts.map

package/dist/reportArtifacts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reportArtifacts.d.ts","sourceRoot":"","sources":["../src/reportArtifacts.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,iBAAiB,4BAA4B,CAAC;AAE3D,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,wBAAsB,8BAA8B,CAClD,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAAE,iBAuBnB"}

package/dist/reportArtifacts.js

@@ -0,0 +1,26 @@
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { expandFilePatterns } from "./filePatterns.js";
+export const publishedSpecRoot = "__feature-spec-md/specs";
+export async function writePublishedFeatureSpecFiles(reportDir, patterns) {
+    const files = (await expandFilePatterns(patterns)).filter((file) => file.endsWith(".feature.md"));
+    const features = [];
+    for (const sourcePath of files) {
+        const filePath = safeRelativePath(sourcePath);
+        const publishedPath = `${publishedSpecRoot}/${filePath}`;
+        const target = join(reportDir, publishedPath);
+        await mkdir(dirname(target), { recursive: true });
+        await writeFile(target, await readFile(sourcePath, "utf8"), "utf8");
+        features.push({ filePath, publishedPath });
+    }
+    const manifestPath = join(reportDir, "__feature-spec-md", "manifest.json");
+    await mkdir(dirname(manifestPath), { recursive: true });
+    await writeFile(manifestPath, JSON.stringify({ generatedAt: new Date().toISOString(), features }, null, 2), "utf8");
+}
+function safeRelativePath(filePath) {
+    return filePath
+        .split(/[\\/]+/)
+        .filter((part) => part && part !== "." && part !== "..")
+        .join("/");
+}
+//# sourceMappingURL=reportArtifacts.js.map

package/dist/reportArtifacts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reportArtifacts.js","sourceRoot":"","sources":["../src/reportArtifacts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,CAAC,MAAM,iBAAiB,GAAG,yBAAyB,CAAC;AAO3D,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,SAAiB,EACjB,QAAkB;IAElB,MAAM,KAAK,GAAG,CAAC,MAAM,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CACjE,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAC7B,CAAC;IACF,MAAM,QAAQ,GAAgC,EAAE,CAAC;IAEjD,KAAK,MAAM,UAAU,IAAI,KAAK,EAAE,CAAC;QAC/B,MAAM,QAAQ,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAC9C,MAAM,aAAa,GAAG,GAAG,iBAAiB,IAAI,QAAQ,EAAE,CAAC;QACzD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QAC9C,MAAM,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,MAAM,SAAS,CAAC,MAAM,EAAE,MAAM,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;QACpE,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,EAAE,mBAAmB,EAAE,eAAe,CAAC,CAAC;IAC3E,MAAM,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxD,MAAM,SAAS,CACb,YAAY,EACZ,IAAI,CAAC,SAAS,CAAC,EAAE,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,QAAQ,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAC5E,MAAM,CACP,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB,CAAC,QAAgB;IACxC,OAAO,QAAQ;SACZ,KAAK,CAAC,QAAQ,CAAC;SACf,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,KAAK,IAAI,CAAC;SACvD,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC"}

package/dist/reportHtml.d.ts

@@ -0,0 +1,9 @@
+export type HtmlPageOptions = {
+    title: string;
+    body: string;
+    styles?: string;
+    scripts?: string;
+    maxWidth?: string;
+};
+export declare function renderHtmlPage({ title, body, styles, scripts, maxWidth, }: HtmlPageOptions): string;
+//# sourceMappingURL=reportHtml.d.ts.map

package/dist/reportHtml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reportHtml.d.ts","sourceRoot":"","sources":["../src/reportHtml.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,IAAI,EACJ,MAAW,EACX,OAAY,EACZ,QAAmB,GACpB,EAAE,eAAe,UAyBjB"}

package/dist/reportHtml.js

@@ -0,0 +1,36 @@
+import { html } from "./html.js";
+export function renderHtmlPage({ title, body, styles = "", scripts = "", maxWidth = "1180px", }) {
+    return `<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1">
+  <title>${html(title)}</title>
+  <style>
+    body {
+      font-family: system-ui, sans-serif;
+      max-width: ${maxWidth};
+      margin: 0 auto;
+      padding: 40px 24px;
+      color: #1f2328;
+      line-height: 1.5;
+    }
+${indent(styles, 4)}
+  </style>
+</head>
+<body>
+${indent(body, 2)}
+${scripts ? indent(scripts, 2) : ""}
+</body>
+</html>
+`;
+}
+function indent(value, spaces) {
+    const prefix = " ".repeat(spaces);
+    return value
+        .trim()
+        .split("\n")
+        .map((line) => (line ? `${prefix}${line}` : line))
+        .join("\n");
+}
+//# sourceMappingURL=reportHtml.js.map

package/dist/reportHtml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reportHtml.js","sourceRoot":"","sources":["../src/reportHtml.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAUjC,MAAM,UAAU,cAAc,CAAC,EAC7B,KAAK,EACL,IAAI,EACJ,MAAM,GAAG,EAAE,EACX,OAAO,GAAG,EAAE,EACZ,QAAQ,GAAG,QAAQ,GACH;IAChB,OAAO;;;;;WAKE,IAAI,CAAC,KAAK,CAAC;;;;mBAIH,QAAQ;;;;;;EAMzB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC;;;;EAIjB,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;EACf,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE;;;CAGlC,CAAC;AACF,CAAC;AAED,SAAS,MAAM,CAAC,KAAa,EAAE,MAAc;IAC3C,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAClC,OAAO,KAAK;SACT,IAAI,EAAE;SACN,KAAK,CAAC,IAAI,CAAC;SACX,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;SACjD,IAAI,CAAC,IAAI,CAAC,CAAC;AAChB,CAAC"}

package/dist/reportMetadata.d.ts

@@ -0,0 +1,9 @@
+export type ReportMetadataItem = {
+    label: string;
+    value: string;
+    url?: string;
+};
+/** Insert report metadata directly below the first report title. */
+export declare function insertReportMetadata(reportHtml: string, metadata?: ReportMetadataItem[]): string;
+export declare function renderReportMetadata(metadata: ReportMetadataItem[]): string;
+//# sourceMappingURL=reportMetadata.d.ts.map

package/dist/reportMetadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reportMetadata.d.ts","sourceRoot":"","sources":["../src/reportMetadata.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,kBAAkB,GAAG;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,oEAAoE;AACpE,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,QAAQ,GAAE,kBAAkB,EAAO,UAWpC;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,UAOlE"}

package/dist/reportMetadata.js

@@ -0,0 +1,28 @@
+/**
+ * Helpers for adding build/source metadata to generated HTML reports.
+ */
+import { html } from "./html.js";
+/** Insert report metadata directly below the first report title. */
+export function insertReportMetadata(reportHtml, metadata = []) {
+    const visibleMetadata = metadata.filter((item) => item.label.trim() && item.value.trim());
+    if (!visibleMetadata.length)
+        return reportHtml;
+    const block = renderReportMetadata(visibleMetadata);
+    if (reportHtml.includes(block))
+        return reportHtml;
+    return reportHtml.replace(/(<h1[\s\S]*?<\/h1>)/, `$1\n    ${block}`);
+}
+export function renderReportMetadata(metadata) {
+    const visibleMetadata = metadata.filter((item) => item.label.trim() && item.value.trim());
+    if (!visibleMetadata.length)
+        return "";
+    return `<p>${visibleMetadata.map(renderReportMetadataItem).join(" · ")}</p>`;
+}
+function renderReportMetadataItem(item) {
+    const label = `<strong>${html(item.label)}:</strong>`;
+    const value = item.url
+        ? `<a href="${html(item.url)}" target="_blank" rel="noopener noreferrer">${html(item.value)}</a>`
+        : html(item.value);
+    return `${label} ${value}`;
+}
+//# sourceMappingURL=reportMetadata.js.map

package/dist/reportMetadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reportMetadata.js","sourceRoot":"","sources":["../src/reportMetadata.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAQjC,oEAAoE;AACpE,MAAM,UAAU,oBAAoB,CAClC,UAAkB,EAClB,WAAiC,EAAE;IAEnC,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CACrC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CACjD,CAAC;IACF,IAAI,CAAC,eAAe,CAAC,MAAM;QAAE,OAAO,UAAU,CAAC;IAE/C,MAAM,KAAK,GAAG,oBAAoB,CAAC,eAAe,CAAC,CAAC;IACpD,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,UAAU,CAAC;IAElD,OAAO,UAAU,CAAC,OAAO,CAAC,qBAAqB,EAAE,WAAW,KAAK,EAAE,CAAC,CAAC;AACvE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAA8B;IACjE,MAAM,eAAe,GAAG,QAAQ,CAAC,MAAM,CACrC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CACjD,CAAC;IACF,IAAI,CAAC,eAAe,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IAEvC,OAAO,MAAM,eAAe,CAAC,GAAG,CAAC,wBAAwB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;AAC/E,CAAC;AAED,SAAS,wBAAwB,CAAC,IAAwB;IACxD,MAAM,KAAK,GAAG,WAAW,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC;IACtD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG;QACpB,CAAC,CAAC,YAAY,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,+CAA+C,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM;QACjG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,OAAO,GAAG,KAAK,IAAI,KAAK,EAAE,CAAC;AAC7B,CAAC"}

package/dist/screenshots.d.ts

@@ -1,6 +1,8 @@
-import type { SpecScreenshot } from "./types.js";
+import type { FeatureSpec, SpecScreenshot, ValidationIssue } from "./types.js";
 /** Load screenshot evidence manifests and normalize entries for report rendering. */
 export declare function collectSpecScreenshots(patterns: string[]): Promise<SpecScreenshot[]>;
+/** Validate screenshot evidence manifests against scenario policies. */
+export declare function validateScenarioScreenshots(specs: FeatureSpec[], screenshots: SpecScreenshot[]): ValidationIssue[];
 export declare function screenshotKey(filePath: string, line: number): string;
 export declare function normalizeFilePath(filePath: string): string;
 //# sourceMappingURL=screenshots.d.ts.map

package/dist/screenshots.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"screenshots.d.ts","sourceRoot":"","sources":["../src/screenshots.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,qFAAqF;AACrF,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,6BAgB9D;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,UAE3D;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,UAEjD"}
+{"version":3,"file":"screenshots.d.ts","sourceRoot":"","sources":["../src/screenshots.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAE/E,qFAAqF;AACrF,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,6BAgB9D;AAED,wEAAwE;AACxE,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,WAAW,EAAE,EACpB,WAAW,EAAE,cAAc,EAAE,qBA0B9B;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,UAE3D;AAED,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,UAEjD"}

package/dist/screenshots.js

@@ -22,6 +22,29 @@ export async function collectSpecScreenshots(patterns) {
     }
     return screenshots;
 }
+/** Validate screenshot evidence manifests against scenario policies. */
+export function validateScenarioScreenshots(specs, screenshots) {
+    const screenshotKeys = new Set(screenshots.map((screenshot) => screenshotKey(screenshot.specPath, screenshot.line)));
+    const issues = [];
+    for (const spec of specs) {
+        for (const scenario of spec.scenarios) {
+            if (scenario.evidence.screenshots === "required") {
+                for (const step of scenario.steps) {
+                    if (!screenshotKeys.has(screenshotKey(spec.filePath, step.line))) {
+                        issues.push({
+                            code: "missing-screenshot-evidence",
+                            severity: "error",
+                            filePath: spec.filePath,
+                            line: step.line,
+                            message: `Screenshot evidence is required for ${scenario.id} ${step.keyword} ${step.text}`,
+                        });
+                    }
+                }
+            }
+        }
+    }
+    return issues;
+}
 export function screenshotKey(filePath, line) {
     return `${normalizeFilePath(filePath)}:${line}`;
 }

package/dist/screenshots.js.map

@@ -1 +1 @@
-{"version":3,"file":"screenshots.js","sourceRoot":"","sources":["../src/screenshots.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAG3D,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,QAAkB;IAC7D,MAAM,WAAW,GAAqB,EAAE,CAAC;IACzC,KAAK,MAAM,IAAI,IAAI,MAAM,sBAAsB,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAY,CAAC;QACnE,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YACnC,CAAC,CAAC,MAAM;YACR,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC;gBACrD,CAAC,CAAC,MAAM,CAAC,WAAW;gBACpB,CAAC,CAAC,EAAE,CAAC;QAET,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,UAAU,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC;YAC9C,IAAI,UAAU;gBAAE,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,QAAgB,EAAE,IAAY;IAC1D,OAAO,GAAG,iBAAiB,CAAC,QAAQ,CAAC,IAAI,IAAI,EAAE,CAAC;AAClD,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,QAAgB;IAChD,OAAO,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAc;IACzC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IAChC,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACxB,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,SAAS,CAAC;IAChD,IACE,OAAO,QAAQ,KAAK,QAAQ;QAC5B,OAAO,IAAI,KAAK,QAAQ;QACxB,OAAO,SAAS,KAAK,QAAQ,EAC7B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO;QACL,QAAQ,EAAE,iBAAiB,CAAC,QAAQ,CAAC;QACrC,IAAI;QACJ,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS;QAChE,QAAQ,EAAE,OAAO,KAAK,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;KAC1E,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,KAAc;IAC9B,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,CAAC;AACrD,CAAC"}
+{"version":3,"file":"screenshots.js","sourceRoot":"","sources":["../src/screenshots.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -14,8 +14,17 @@ export type ModelReferenceFrontmatter = SpecFrontmatter & {
     model?: string;
     models?: string[] | string;
 };
+export type ScenarioTestType = "unit" | "integration" | "playwright" | "manual" | "skip";
+export type ScreenshotPolicy = "required" | "optional" | "skip";
+export type ScenarioEvidencePolicy = {
+    test: ScenarioTestType;
+    screenshots: ScreenshotPolicy;
+};
 /** Frontmatter fields supported by `*.feature.md` files. */
-export type FeatureFrontmatter = ModelReferenceFrontmatter;
+export type FeatureFrontmatter = ModelReferenceFrontmatter & {
+    test?: ScenarioTestType;
+    screenshots?: ScreenshotPolicy;
+};
 /** Frontmatter fields supported by `*.design.md` files. */
 export type DesignFrontmatter = ModelReferenceFrontmatter;
 /** Parsed contents of one `*.model.md` file. */
@@ -91,6 +100,7 @@ export type FeatureScenario = {
     id: string;
     title: string;
     line: number;
+    evidence: ScenarioEvidencePolicy;
     steps: FeatureStep[];
 };
 /** A single Given / When / Then style step inside a scenario. */

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,iEAAiE;AACjE,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,YAAY,CAAC;IAC3C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,2EAA2E;AAC3E,MAAM,MAAM,yBAAyB,GAAG,eAAe,GAAG;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC;CAC5B,CAAC;AAEF,4DAA4D;AAC5D,MAAM,MAAM,kBAAkB,GAAG,yBAAyB,CAAC;AAE3D,2DAA2D;AAC3D,MAAM,MAAM,iBAAiB,GAAG,yBAAyB,CAAC;AAE1D,gDAAgD;AAChD,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,eAAe,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,SAAS,EAAE,CAAC;IACxB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,kDAAkD;AAClD,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,kBAAkB,CAAC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,SAAS,EAAE,eAAe,EAAE,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,gDAAgD;AAChD,MAAM,MAAM,SAAS,GAAG;IACtB,IAAI,EAAE,OAAO,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,eAAe,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,iDAAiD;AACjD,MAAM,MAAM,UAAU,GAAG;IACvB,IAAI,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,iBAAiB,CAAC;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,gCAAgC;AAChC,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,UAAU,CAAC;AAE5E,0DAA0D;AAC1D,MAAM,MAAM,SAAS,GAAG;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,iDAAiD;AACjD,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,QAAQ,EAAE,UAAU,GAAG,aAAa,GAAG,UAAU,GAAG,aAAa,CAAC;IAClE,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,iEAAiE;AACjE,MAAM,MAAM,eAAe,GAAG;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,WAAW,EAAE,CAAC;CACtB,CAAC;AAEF,iEAAiE;AACjE,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,MAAM,MAAM,WAAW,GACnB,MAAM,GACN,UAAU,GACV,QAAQ,GACR,YAAY,GACZ,KAAK,GACL,UAAU,CAAC;AAEf,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,CAAC;AAEpE,2EAA2E;AAC3E,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,oEAAoE;AACpE,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,GAAG,MAAM,GAAG,UAAU,CAAC;IACpC,MAAM,EAAE,OAAO,GAAG,KAAK,GAAG,QAAQ,GAAG,YAAY,GAAG,WAAW,CAAC;CACjE,CAAC;AAEF,qEAAqE;AACrE,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,aAAa,EAAE,CAAC;CAC7B,CAAC;AAEF,kEAAkE;AAClE,MAAM,MAAM,eAAe,GAAG;IAC5B,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;IAC/B,YAAY,EAAE,YAAY,EAAE,CAAC;IAC7B,gBAAgB,EAAE,YAAY,EAAE,CAAC;IACjC,qBAAqB,CAAC,EAAE,aAAa,EAAE,CAAC;IACxC,oBAAoB,EAAE,aAAa,EAAE,CAAC;IACtC,wBAAwB,EAAE,aAAa,EAAE,CAAC;CAC3C,CAAC;AAEF,8DAA8D;AAC9D,MAAM,MAAM,cAAc,GAAG;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/docs/evidence-policy.md

@@ -0,0 +1,63 @@
+# Scenario Test And Evidence Policy
+
+Feature specs can declare how scenarios are expected to be tested and whether screenshot evidence is required.
+
+Use feature frontmatter to set defaults for all scenarios in a feature:
+
+```md
+---
+id: KANBAN-CARD-AUTHORING
+title: Card authoring
+test: playwright
+screenshots: required
+---
+```
+
+Use scenario-level overrides directly below a scenario heading when one scenario needs different evidence:
+
+```md
+### KANBAN-CARD-AUTHORING-S002: Card title is normalized
+Test: unit
+Screenshots: skip
+
+Given the raw card title contains leading whitespace
+When the title is normalized
+Then the stored title has no leading whitespace
+```
+
+## `test` values
+
+- `unit`: behavior is expected to be covered by unit tests.
+- `integration`: behavior is expected to be covered by integration tests.
+- `playwright`: behavior is expected to be covered by Playwright or another UI/browser test.
+- `manual`: behavior is intentionally verified manually.
+- `skip`: no executable test is expected for this scenario.
+
+## `screenshots` values
+
+- `required`: every scenario step should have screenshot evidence in the report manifest.
+- `optional`: screenshot evidence may be included when useful, but missing screenshots do not fail validation.
+- `skip`: screenshots are not expected and should not be treated as missing evidence.
+
+`screenshots: none` is accepted as an alias for `screenshots: skip`.
+
+## Defaults
+
+- If `test` is omitted, scenarios default to `unit`.
+- If `screenshots` is omitted and `test` resolves to `playwright`, screenshots default to `required`.
+- If `screenshots` is omitted and `test` resolves to `unit`, `integration`, `manual`, or `skip`, screenshots default to `skip`.
+
+This lets UI scenarios fail CI when screenshot evidence is missing, while unit-only domain behavior does not need screenshots.
+
+## CI enforcement
+
+Use report evidence enforcement in CI when declared screenshot evidence should block a build:
+
+```bash
+npx feature-spec-md report \
+  --screenshots "test-results/spec-report/screenshots-*.json" \
+  --enforce-evidence \
+  --out test-results/spec-report/index.html
+```
+
+The gate only fails for scenarios whose resolved screenshot policy is `required`.

package/docs/report-development.md

@@ -0,0 +1,102 @@
+# Report development mock data
+
+The report UI is easier to develop when it can be rendered without a real app build, Playwright run, FTP server, or multiple published builds.
+
+The mock setup keeps the maintainable source material in `src/mocks/`:
+
+```txt
+src/mocks/
+├── current/
+│   ├── app/
+│   ├── specs/
+│   ├── tests/
+│   └── screenshots/
+└── previous/
+    ├── app/
+    ├── specs/
+    ├── tests/
+    └── screenshots/
+```
+
+The feature reports are generated by the normal library pipeline. The mock command loads the Markdown specs, scans the test files for coverage references, loads the screenshot manifests, and then renders the report HTML.
+
+The diff report is generated by the same implementation used by the PR diff workflow. `src/mockReports.ts` prepares previous/current published-report directories, then calls `renderLocalDiffReport` from `src/githubActionDiffReport.ts`. That means the mock report exercises the real diff extraction, file comparison, screenshot grouping, and diff renderer instead of maintaining a separate mock-only diff renderer.
+
+Run the library-owned mock setup from this package:
+
+```bash
+npm run report:mock
+```
+
+It writes a deterministic set of report fixtures to `test-results/mock-reports/`:
+
+```txt
+test-results/mock-reports/
+├── feature-spec-report/index.html
+├── previous-feature-spec-report/index.html
+└── diff-report/index.html
+```
+
+The fixtures intentionally include the states that are otherwise cumbersome to reproduce by hand:
+
+- covered and missing model/rule/scenario coverage
+- current and previous screenshot evidence
+- report metadata for branch, build, commit, and pull request
+- a PR diff report with changed spec text, added spec text, changed screenshots, and added screenshots
+
+Use `--out` to write the mock reports somewhere else:
+
+```bash
+npm run report:mock -- --out /tmp/feature-spec-md-reports
+```
+
+## FTP publishing
+
+The `.github/workflows/mock-reports.yml` workflow publishes the generated mock reports on every push and on manual workflow dispatch.
+
+It uses the same publishing command that consuming projects use:
+
+```bash
+node dist/cli.js github-report --publish ftp --report-dir test-results/mock-reports --name mock-feature-spec-reports
+```
+
+Before publishing, the workflow adds a root `test-results/mock-reports/index.html` that links to:
+
+- `feature-spec-report/`
+- `previous-feature-spec-report/`
+- `diff-report/`
+
+The FTP publisher then uploads the whole `test-results/mock-reports` directory to `build/<github.run_number>/` and updates the build index.
+
+Configure these repository settings before enabling the workflow:
+
+| Name | Source |
+| --- | --- |
+| `FEATURE_SPEC_FTP_HOST` | Repository variable |
+| `FEATURE_SPEC_FTP_USER` | Repository variable |
+| `FEATURE_SPEC_FTP_PASSWORD` | Repository secret |
+| `FEATURE_SPEC_REPORT_BASE_URL` | Repository variable |
+| `FEATURE_SPEC_FTP_REMOTE_DIR` | Repository variable |
+
+Optional settings:
+
+| Name | Source |
+| --- | --- |
+| `FEATURE_SPEC_FTP_PORT` | Repository variable |
+| `FEATURE_SPEC_FTP_SECURE` | Repository variable |
+
+Use a mock-specific base URL and remote directory value so these reports do not overwrite the demo or any consumer report. For example, use a public base URL ending in `/mocks/` and an FTP remote directory ending in `/mocks`.
+
+The same data is available from the library for custom dev servers or visual tests:
+
+```ts
+import {
+  loadMockReportData,
+  renderLocalDiffReport,
+  renderMockDiffReport,
+  renderMockFeatureSpecReport,
+  writeMockReports,
+} from "@anselmdk/feature-spec-md";
+```
+
+Keep new reusable report states in `src/mocks/` where possible, and only put report-generation glue in `src/mockReports.ts`. That keeps the fixtures readable as normal specs, tests, manifests, and app code instead of duplicating parsed TypeScript objects.