@anselmdk/feature-spec-md 0.5.0 → 0.6.0

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":"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"}
+{"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.

package/docs/spec-driven-flow.md

@@ -4,9 +4,9 @@
 
 ```txt
 AI drafts specs
--> humans review intent
+-> humans review intent and evidence policy
 -> AI writes tests from stable IDs
--> tooling checks coverage
+-> tooling checks coverage and declared evidence
 -> implementation follows failing tests
 -> reports show what is implemented
 ```
@@ -54,7 +54,9 @@ Useful instruction:
 ```txt
 Create feature-spec-md documents for this change. Keep the documents small.
 Use stable uppercase IDs. Put durable behavior in rules. Put testable examples
-in scenarios. Do not include test mappings inside the specs.
+in scenarios. For each feature or scenario, declare whether the expected test
+is unit, integration, playwright, manual, or skip. Require screenshots only for
+UI flows where visual evidence should be part of the review.
 ```
 
 Run:
@@ -74,9 +76,34 @@ Check that:
 - model terms are clear enough for test authors
 - feature rules are durable product truths
 - scenarios are concrete enough to become executable tests
+- each scenario has the right test policy
+- screenshots are required only for UI/browser behavior where visual evidence is valuable
 - stack choices are specific enough to guide implementation
 - design direction covers the visible behavior users will judge
 
+Example feature-level policy for UI behavior:
+
+```md
+---
+id: ACCOUNT-ACCESS
+title: Account access
+test: playwright
+screenshots: required
+---
+```
+
+Example scenario-level override for unit-only behavior:
+
+```md
+### ACCOUNT-ACCESS-S002: Link expiry is calculated
+Test: unit
+Screenshots: skip
+
+Given a sign-in link was created 31 minutes ago
+When expiry is calculated
+Then the link is expired
+```
+
 Then run:
 
 ```bash
@@ -87,14 +114,17 @@ This keeps the spec set valid while allowing missing tests.
 
 ## 3. Ask AI To Write Tests From The Specs
 
-Give the AI the relevant spec files and tell it to write executable tests that preserve spec IDs in the test source.
+Give the AI the relevant spec files and tell it to write executable tests that preserve spec IDs in the test source and match the declared test policy.
 
 Useful instruction:
 
 ```txt
 Write tests from these feature-spec-md specs. Each scenario test must include
 the scenario ID in the test title. Add comments or annotations for covered
-rule IDs and model item IDs. Do not invent IDs that are not in the specs.
+rule IDs and model item IDs. Use Playwright and the screenshot evidence helper
+for scenarios declared as test: playwright with screenshots: required. Use unit
+or integration tests for scenarios declared that way. Do not invent IDs that are
+not in the specs.
 ```
 
 Example:
@@ -137,7 +167,7 @@ Run:
 npx feature-spec-md report --out test-results/feature-spec-report/index.html
 ```
 
-The report is useful as a PR artifact because it shows specs, coverage state, validation issues, and optional screenshot evidence.
+The report is useful as a PR artifact because it shows specs, coverage state, validation issues, declared evidence policy, and optional screenshot evidence.
 
 If your tests produce screenshot manifests, include them:
 
@@ -147,6 +177,17 @@ npx feature-spec-md report \
   --out test-results/feature-spec-report/index.html
 ```
 
+When missing declared screenshot evidence should block the build, enforce evidence policy:
+
+```bash
+npx feature-spec-md report \
+  --screenshots "test-results/spec-report/screenshots-*.json" \
+  --enforce-evidence \
+  --out test-results/feature-spec-report/index.html
+```
+
+The gate only fails for scenarios whose resolved screenshot policy is `required`.
+
 Screenshot manifest shape:
 
 ```json
@@ -162,14 +203,32 @@ Screenshot manifest shape:
 }
 ```
 
-## 6. Keep The Loop Honest
+## 6. Publish The Report From CI
+
+A typical CI sequence is:
+
+```bash
+npm run build
+npx feature-spec-md check --require-rule-coverage --require-model-coverage
+npx feature-spec-md coverage --fail-on-missing
+npm test
+npx feature-spec-md report \
+  --screenshots "test-results/spec-report/screenshots-*.json" \
+  --enforce-evidence \
+  --out test-results/spec-report/index.html
+npx feature-spec-md github-report --publish ftp --report-dir test-results/spec-report
+```
+
+Use `--enforce-evidence` when the project wants missing required screenshots to fail the build. Leave it out when the report should show screenshot state without blocking.
+
+## 7. Keep The Loop Honest
 
 When behavior changes, update specs first, then regenerate or update tests from the changed specs.
 
 The expected loop is:
 
 ```txt
-spec change -> validation -> AI test update -> coverage -> implementation -> report
+spec change -> validation -> AI test update -> coverage -> implementation -> evidence report
 ```
 
 That keeps the AI-generated work anchored to a small, reviewable contract instead of a loose conversation history.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@anselmdk/feature-spec-md",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Markdown specs for AI-assisted, testable spec driven development across model, feature, stack, and design documents.",
   "type": "module",
   "repository": {
@@ -26,6 +26,7 @@
   },
   "files": [
     "dist",
+    "src/mocks",
     "README.md",
     "SPEC_FORMAT.md",
     "docs",
@@ -43,6 +44,7 @@
     "spec": "tsx src/cli.ts check",
     "spec:init": "tsx src/cli.ts init",
     "spec:report": "tsx src/cli.ts report",
+    "report:mock": "tsx src/mockReports.ts",
     "format": "prettier --write .",
     "check:example": "tsx src/cli.ts check --specs examples/**/*.feature.md --require-scenario-coverage=false",
     "report:example": "tsx src/cli.ts report --specs examples/**/*.feature.md --tests tests/**/*.test.ts --out test-results/feature-spec-report/index.html",

package/src/mocks/current/app/supportDesk.ts

@@ -0,0 +1,27 @@
+export type Ticket = {
+  id: string;
+  title: string;
+  status: "open" | "closed";
+  priority: "low" | "normal" | "high";
+  createdAt: string;
+};
+
+export function visibleTickets(tickets: Ticket[]) {
+  return tickets
+    .filter((ticket) => ticket.status === "open")
+    .sort((a, b) => Date.parse(a.createdAt) - Date.parse(b.createdAt));
+}
+
+export function priorityBadge(ticket: Ticket) {
+  if (ticket.priority === "high") return "High priority";
+  if (ticket.priority === "low") return "Low priority";
+  return "Normal priority";
+}
+
+export function draftReply(existingDraft: string, nextText: string) {
+  return nextText.trim() ? nextText : existingDraft;
+}
+
+export function applySavedReply(template: string) {
+  return template.trim();
+}

package/src/mocks/current/screenshots/SUPPORT-INBOX-S001-line-27-current.svg

@@ -0,0 +1,10 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="960" height="540" viewBox="0 0 960 540" role="img" aria-label="Inbox with priority badges">
+  <rect width="960" height="540" fill="#f6f8fa"/>
+  <rect x="72" y="64" width="816" height="412" rx="24" fill="white" stroke="#d0d7de"/>
+  <rect x="112" y="112" width="736" height="72" rx="14" fill="#ddf4ff" stroke="#54aeff"/>
+  <text x="144" y="158" font-family="system-ui, sans-serif" font-size="28" font-weight="700" fill="#1f2328">Inbox with priority badges</text>
+  <rect x="112" y="224" width="520" height="44" rx="10" fill="#f6f8fa"/>
+  <rect x="112" y="292" width="660" height="44" rx="10" fill="#f6f8fa"/>
+  <rect x="112" y="360" width="420" height="44" rx="10" fill="#f6f8fa"/>
+  <circle cx="812" cy="384" r="34" fill="#ddf4ff" stroke="#54aeff"/>
+</svg>

package/src/mocks/current/screenshots/SUPPORT-REPLY-S001-line-27-current.svg

@@ -0,0 +1,10 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="960" height="540" viewBox="0 0 960 540" role="img" aria-label="Reply composer with suggested answer">
+  <rect width="960" height="540" fill="#f6f8fa"/>
+  <rect x="72" y="64" width="816" height="412" rx="24" fill="white" stroke="#d0d7de"/>
+  <rect x="112" y="112" width="736" height="72" rx="14" fill="#ddf4ff" stroke="#54aeff"/>
+  <text x="144" y="158" font-family="system-ui, sans-serif" font-size="28" font-weight="700" fill="#1f2328">Reply composer with suggested answer</text>
+  <rect x="112" y="224" width="680" height="44" rx="10" fill="#f6f8fa"/>
+  <rect x="112" y="292" width="620" height="44" rx="10" fill="#f6f8fa"/>
+  <rect x="112" y="360" width="300" height="44" rx="10" fill="#ddf4ff" stroke="#54aeff"/>
+  <circle cx="812" cy="384" r="34" fill="#ddf4ff" stroke="#54aeff"/>
+</svg>

package/src/mocks/current/screenshots/screenshots.json

@@ -0,0 +1,18 @@
+{
+  "screenshots": [
+    {
+      "specPath": "src/mocks/current/specs/ticket-inbox.feature.md",
+      "line": 27,
+      "path": "screenshots/SUPPORT-INBOX-S001-line-27-current.svg",
+      "title": "Inbox with priority badges",
+      "testPath": "src/mocks/current/tests/supportDesk.spec.ts"
+    },
+    {
+      "specPath": "src/mocks/current/specs/ticket-reply.feature.md",
+      "line": 27,
+      "path": "screenshots/SUPPORT-REPLY-S001-line-27-current.svg",
+      "title": "Reply composer with suggested answer",
+      "testPath": "src/mocks/current/tests/supportDesk.spec.ts"
+    }
+  ]
+}

package/src/mocks/current/specs/support-desk.model.md

@@ -0,0 +1,29 @@
+---
+id: SUPPORT
+title: Support desk
+status: active
+---
+
+# Support desk
+
+## Purpose
+
+Define the shared vocabulary for a small customer support workflow.
+
+## Model
+
+### SUPPORT-M001: Ticket
+
+A customer request that needs a response from an agent.
+
+### SUPPORT-M002: Agent
+
+A team member who reviews tickets and sends replies.
+
+### SUPPORT-M003: Priority
+
+A visible urgency label used to sort the queue.
+
+## Rules
+
+- SUPPORT-M-R001: Tickets MUST keep a stable public reference.

package/src/mocks/current/specs/ticket-inbox.feature.md

@@ -0,0 +1,27 @@
+---
+id: SUPPORT-INBOX
+title: Ticket inbox
+status: active
+model: SUPPORT
+test: playwright
+screenshots: optional
+---
+
+# Ticket inbox
+
+## Purpose
+
+Let agents find the next ticket to work on without losing context.
+
+## Rules
+
+- SUPPORT-INBOX-R001: The inbox MUST show open tickets first.
+- SUPPORT-INBOX-R002: The inbox SHOULD highlight high priority tickets.
+
+## Scenarios
+
+### SUPPORT-INBOX-S001: Agent reviews the queue
+
+Given an agent has open tickets
+When they open the inbox
+Then open tickets are listed by age with priority badges

package/src/mocks/current/specs/ticket-reply.feature.md

@@ -0,0 +1,33 @@
+---
+id: SUPPORT-REPLY
+title: Ticket replies
+status: active
+model: SUPPORT
+test: playwright
+screenshots: optional
+---
+
+# Ticket replies
+
+## Purpose
+
+Help agents answer a customer without leaving the ticket.
+
+## Rules
+
+- SUPPORT-REPLY-R001: The reply composer MUST preserve unsent text.
+- SUPPORT-REPLY-R002: Saved replies SHOULD be reusable across tickets.
+
+## Scenarios
+
+### SUPPORT-REPLY-S001: Agent drafts a reply
+
+Given an agent has selected a ticket
+When they write a reply
+Then the draft remains visible
+
+### SUPPORT-REPLY-S002: Agent sends a saved reply
+
+Given an agent has selected a ticket
+When they choose a saved reply
+Then the composer is filled with reusable text

package/src/mocks/current/tests/supportDesk.spec.ts

@@ -0,0 +1,17 @@
+import { draftReply, priorityBadge, visibleTickets } from "../app/supportDesk.js";
+
+const tickets = [
+  { id: "T-2", title: "Newer", status: "open" as const, priority: "high" as const, createdAt: "2026-01-02T10:00:00Z" },
+  { id: "T-1", title: "Older", status: "open" as const, priority: "normal" as const, 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");
+}

package/src/mocks/previous/app/supportDesk.ts

@@ -0,0 +1,17 @@
+export type Ticket = {
+  id: string;
+  title: string;
+  status: "open" | "closed";
+  priority: "low" | "normal" | "high";
+  createdAt: string;
+};
+
+export function visibleTickets(tickets: Ticket[]) {
+  return tickets
+    .filter((ticket) => ticket.status === "open")
+    .sort((a, b) => Date.parse(a.createdAt) - Date.parse(b.createdAt));
+}
+
+export function draftReply(existingDraft: string, nextText: string) {
+  return nextText.trim() ? nextText : existingDraft;
+}

package/src/mocks/previous/screenshots/SUPPORT-INBOX-S001-line-27-previous.svg

@@ -0,0 +1,10 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="960" height="540" viewBox="0 0 960 540" role="img" aria-label="Inbox before priority badges">
+  <rect width="960" height="540" fill="#f6f8fa"/>
+  <rect x="72" y="64" width="816" height="412" rx="24" fill="white" stroke="#d0d7de"/>
+  <rect x="112" y="112" width="736" height="72" rx="14" fill="#fff8c5" stroke="#d4a72c"/>
+  <text x="144" y="158" font-family="system-ui, sans-serif" font-size="28" font-weight="700" fill="#1f2328">Inbox before priority badges</text>
+  <rect x="112" y="224" width="520" height="44" rx="10" fill="#f6f8fa"/>
+  <rect x="112" y="292" width="660" height="44" rx="10" fill="#f6f8fa"/>
+  <rect x="112" y="360" width="420" height="44" rx="10" fill="#f6f8fa"/>
+  <circle cx="812" cy="384" r="34" fill="#fff8c5" stroke="#d4a72c"/>
+</svg>