@anselmdk/feature-spec-md 0.1.0 → 0.1.1-rc.1

package/README.md

@@ -1,26 +1,37 @@
 # feature-spec-md
 
-Markdown feature specs with stable rule and scenario IDs, validation, coverage checks, and generated reports.
+Markdown feature specs with stable model, rule, and scenario IDs, validation, coverage checks, and generated reports.
 
 The goal is simple:
 
 ```txt
-human-readable feature spec
+human-readable model + feature specs
 → exact executable tests
 → generated coverage report
 ```
 
-The handwritten spec stays clean. It contains purpose, rules, and scenarios. Test mapping is derived from stable IDs instead of being written manually in the spec.
+The handwritten specs stay clean. Shared domain language lives in `*.model.md` files. User-facing capabilities live in `*.feature.md` files with rules and scenarios. Test mapping is derived from stable IDs instead of being written manually in the spec.
 
 ## Format
 
-Feature specs are ordinary Markdown files named `*.feature.md`.
+Feature Spec Markdown uses ordinary Markdown files:
 
-They use:
+```txt
+*.model.md
+*.feature.md
+```
+
+Model files use:
 
 - frontmatter for metadata
-- `## Purpose` for intent
-- `## Rules` for general business rules
+- `## Model` for shared domain vocabulary
+- optional `## Rules` for global invariants
+
+Feature files use:
+
+- frontmatter for metadata
+- optional `model` or `models` references
+- `## Rules` for durable product truths
 - `## Scenarios` for Given / When / Then examples
 
 See `SPEC_FORMAT.md` and `examples/account-access.feature.md`.
@@ -31,6 +42,24 @@ See `SPEC_FORMAT.md` and `examples/account-access.feature.md`.
 npm install
 npm run dev -- check --specs "examples/**/*.feature.md" --tests "tests/**/*.test.ts" --require-scenario-coverage=false
 npm run dev -- report --specs "examples/**/*.feature.md" --tests "tests/**/*.test.ts"
+npm run dev -- report --specs "examples/**/*.feature.md" --tests "tests/**/*.test.ts" --screenshots "test-results/spec-report/screenshots-*.json"
+```
+
+Playwright screenshot evidence can be shown in the report by passing one or
+more screenshot manifest JSON files. Each screenshot should point at the spec
+file and line it proves:
+
+```json
+{
+  "screenshots": [
+    {
+      "specPath": "specs/account-access.feature.md",
+      "line": 24,
+      "path": "screenshots/account-s001-line-24.png",
+      "title": "ACCOUNT-S001:24 Given a registered person is on the sign-in page"
+    }
+  ]
+}
 ```
 
 ## Library API
@@ -52,3 +81,19 @@ npm test
 npm run typecheck
 npm run build
 ```
+
+## Releases
+
+Stable releases are published to npm by the `Publish to npm` GitHub Actions workflow when a `v*` tag is pushed, or when the workflow is run manually.
+
+Release candidates are published manually from GitHub Actions:
+
+1. Open the `Publish RC to npm` workflow.
+2. Run the workflow from `main`.
+3. The workflow verifies the package, creates a prerelease version using the current package version and GitHub run number, and publishes it with the npm `rc` dist-tag.
+
+Install the latest release candidate with:
+
+```bash
+npm install @anselmdk/feature-spec-md@rc
+```

package/SPEC_FORMAT.md

@@ -1,22 +1,24 @@
 # Feature Spec Markdown format
 
-Feature Spec Markdown is a lightweight convention for readable, testable feature specifications.
+Feature Spec Markdown is a lightweight convention for readable, testable specifications.
 
-It intentionally uses ordinary Markdown and stable IDs instead of a dedicated executable specification language.
+It uses ordinary Markdown and stable IDs instead of a dedicated executable specification language.
 
-## File name
+## File types
 
-Use:
+The format has four document types:
 
 ```txt
+*.model.md
 *.feature.md
+*.stack.md
+*.design.md
 ```
 
-Example:
-
-```txt
-account-access.feature.md
-```
+- `*.model.md` defines shared domain vocabulary.
+- `*.feature.md` defines user-facing behavior with rules and scenarios.
+- `*.stack.md` defines technical platform choices.
+- `*.design.md` defines product, UI, and interaction design direction.
 
 ## Frontmatter
 
@@ -24,9 +26,10 @@ Every file starts with YAML-like frontmatter:
 
 ```md
 ---
-id: ACCOUNT
-title: Account access
+id: KANBAN-CARD-AUTHORING
+title: Card authoring
 status: draft
+model: KANBAN
 ---
 ```
 
@@ -39,48 +42,75 @@ Optional fields:
 
 - `status`: `draft`, `active`, or `deprecated`
 - `owner`
+- `model`: a single referenced model id, for feature and design files
+- `models`: comma-separated referenced model ids, for feature and design files
+
+## Purpose
 
-## Required sections
+Every model, feature, stack, and design file MUST include a short `## Purpose` section.
+
+Purpose explains the document boundary and intent. It SHOULD be one or two short paragraphs and SHOULD NOT contain rules, scenarios, implementation details, or roadmap notes.
+
+## Model files
+
+Model files use the `.model.md` suffix.
+
+Required sections:
 
 ```md
-# Account access
+# Kanban model
 
 ## Purpose
 
-## Rules
-
-## Scenarios
+## Model
 ```
 
+Optional sections:
+
+```md
 ## Rules
+```
 
-Rules are durable business truths. They use stable IDs and requirement keywords.
+Model items use stable `-M001` IDs:
 
 ```md
-- ACCOUNT-R001: A person MUST prove control of a registered email address before accessing an account.
-- ACCOUNT-R002: The system MUST NOT reveal whether an unknown email address belongs to an account.
-- ACCOUNT-R003: A signed-in person SHOULD be returned to the page they originally requested.
+### KANBAN-M001: Card
+
+A card represents one work item on the board.
 ```
 
-Use these keywords:
+Model rules use stable `-R001` IDs and should describe global invariants for the domain vocabulary.
+
+## Feature files
+
+Feature files use the `.feature.md` suffix.
+
+Required sections:
+
+```md
+# Card authoring
+
+## Purpose
 
-- `MUST`
-- `MUST NOT`
-- `SHOULD`
-- `SHOULD NOT`
-- `MAY`
-- `OPTIONAL`
+## Rules
 
 ## Scenarios
+```
+
+Rules use stable `-R001` IDs:
+
+```md
+- KANBAN-CARD-AUTHORING-R001: A new card MUST start in the To do column.
+```
 
-Scenarios are concrete examples. They use stable IDs and Given / When / Then steps.
+Scenarios use stable `-S001` IDs and Given / When / Then steps:
 
 ```md
-### ACCOUNT-S001: Registered person signs in
+### KANBAN-CARD-AUTHORING-S001: User creates a card
 
-Given a registered person is on the sign-in page  
-When they request and open a valid sign-in link  
-Then they are signed in
+Given the user is on the board
+When they create a card with the title "Write release notes"
+Then the card "Write release notes" is visible in the To do column
 ```
 
 Allowed step keywords:
@@ -91,14 +121,124 @@ Allowed step keywords:
 - `And`
 - `But`
 
+## Stack files
+
+Stack files use the `.stack.md` suffix.
+
+A stack file defines technical platform choices and the reasoning behind them.
+
+Required sections:
+
+```md
+# Kanban tech stack
+
+## Purpose
+
+## Stack
+```
+
+Optional sections:
+
+```md
+## Context
+
+## Rationale
+
+## Consequences
+```
+
+Example:
+
+```md
+---
+id: KANBAN-STACK
+title: Kanban tech stack
+status: draft
+---
+
+# Kanban tech stack
+
+## Purpose
+
+Define the initial technical stack for implementing the Kanban board.
+
+## Stack
+
+| Area | Choice |
+|---|---|
+| Frontend | React |
+| Language | TypeScript |
+| Testing | Playwright |
+```
+
+## Design files
+
+Design files use the `.design.md` suffix.
+
+A design file defines product, UI, layout, visual, and interaction direction.
+
+Required sections:
+
+```md
+# Kanban board design
+
+## Purpose
+
+## Design
+```
+
+Optional sections:
+
+```md
+## Principles
+
+## Layout
+
+## Interaction
+
+## Visual style
+```
+
+Example:
+
+```md
+---
+id: KANBAN-DESIGN
+title: Kanban board design
+status: draft
+model: KANBAN
+---
+
+# Kanban board design
+
+## Purpose
+
+Define the visual and interaction design direction for the Kanban board.
+
+## Design
+
+The board should feel lightweight, immediate, and calm.
+```
+
+## Splitting guidance
+
+Split model files by coherent domain vocabulary, ownership, or lifecycle.
+
+Feature files SHOULD be split by user capability.
+
+Use stack files for broad technical choices such as framework, language, testing, persistence, and deployment.
+
+Use design files for product/UI direction such as layout, interaction, visual style, and design principles.
+
 ## Test coverage convention
 
-The spec file does not contain test mappings.
+Spec files do not contain test mappings.
 
-Tests reference rule and scenario IDs in test titles, tags, annotations, comments, or metadata.
+Tests reference model item, rule, and scenario IDs in test titles, tags, annotations, comments, or metadata.
 
-Generated tooling can then answer:
+Generated tooling can answer:
 
+- Which model items are referenced?
 - Which scenarios have tests?
 - Which rules have executable coverage?
 - Which tests reference deleted or unknown spec IDs?

package/dist/cli.js

@@ -1,8 +1,9 @@
 #!/usr/bin/env node
 import { mkdir, writeFile } from "node:fs/promises";
 import path from "node:path";
-import { checkFeatureSpecs, renderHtmlReport, writeTextFile } from "./index.js";
-const defaultSpecPattern = "specs/**/*.feature.md";
+import { collectSpecScreenshots, renderHtmlReport, writeTextFile } from "./index.js";
+import { checkSpecDocuments } from "./specDocuments.js";
+const defaultSpecPattern = "specs/**/*.model.md,specs/**/*.feature.md,specs/**/*.stack.md,specs/**/*.design.md";
 const defaultTestPattern = "tests/**/*.spec.ts";
 main().catch((error) => {
     console.error(error instanceof Error ? error.message : error);
@@ -21,38 +22,47 @@ async function main() {
     process.exit(command === "help" || command === "--help" || command === "-h" ? 0 : 1);
 }
 async function runCheck(options) {
-    const result = await checkFeatureSpecs({
+    const result = await checkSpecDocuments({
         specs: optionList(options.specs, defaultSpecPattern),
         tests: options.tests === "" ? [] : optionList(options.tests, defaultTestPattern),
+        requireModelCoverage: options["require-model-coverage"] === "true",
         requireRuleCoverage: options["require-rule-coverage"] === "true",
         requireScenarioCoverage: options["require-scenario-coverage"] !== "false",
     });
     printIssues([...result.validationIssues, ...result.coverageIssues]);
     if (!result.ok)
         process.exit(1);
-    const scenarioCount = result.specs.reduce((sum, spec) => sum + spec.scenarios.length, 0);
-    const ruleCount = result.specs.reduce((sum, spec) => sum + spec.rules.length, 0);
-    console.log(`Feature spec check passed: ${result.specs.length} spec(s), ${ruleCount} rule(s), ${scenarioCount} scenario(s).`);
+    const modelItemCount = result.models.reduce((sum, spec) => sum + spec.modelItems.length, 0);
+    const ruleCount = result.documents.reduce((sum, spec) => sum + spec.rules.length, 0);
+    const scenarioCount = result.features.reduce((sum, spec) => sum + spec.scenarios.length, 0);
+    console.log(`Spec check passed: ${result.models.length} model(s), ${result.features.length} feature(s), ${result.stacks.length} stack(s), ${result.designs.length} design(s), ${modelItemCount} model item(s), ${ruleCount} rule(s), ${scenarioCount} scenario(s).`);
 }
 async function runReport(options) {
-    const result = await checkFeatureSpecs({
+    const result = await checkSpecDocuments({
         specs: optionList(options.specs, defaultSpecPattern),
         tests: options.tests === "" ? [] : optionList(options.tests, defaultTestPattern),
+        requireModelCoverage: options["require-model-coverage"] === "true",
         requireRuleCoverage: options["require-rule-coverage"] === "true",
         requireScenarioCoverage: false,
     });
     const out = options.out ?? "test-results/feature-spec-report/index.html";
-    await writeTextFile(out, renderHtmlReport(result.specs, {
+    const screenshots = options.screenshots ? await collectSpecScreenshots(optionList(options.screenshots, "")) : [];
+    await writeTextFile(out, renderHtmlReport(result.features, {
+        models: result.models,
+        stacks: result.stacks,
+        designs: result.designs,
         coverage: result.coverage,
+        screenshots,
         validationIssues: [...result.validationIssues, ...result.coverageIssues],
     }));
     console.log(`Feature spec report written to ${out}`);
 }
 async function runInit(options) {
     const dir = options.dir ?? "specs";
-    const target = path.join(dir, "account-access.feature.md");
+    const kind = options.kind ?? "feature";
+    const target = path.join(dir, fileNameForKind(kind));
     await mkdir(dir, { recursive: true });
-    await writeFile(target, exampleSpec, "utf8");
+    await writeFile(target, exampleForKind(kind), "utf8");
     console.log(`Created ${target}`);
 }
 function parseArgs(args) {
@@ -89,20 +99,59 @@ function printHelp() {
     console.log(`feature-spec-md
 
 Usage:
-  feature-spec-md init [--dir specs]
-  feature-spec-md check [--specs "specs/**/*.feature.md"] [--tests "tests/**/*.spec.ts"]
-  feature-spec-md report [--specs "specs/**/*.feature.md"] [--tests "tests/**/*.spec.ts"] [--out test-results/feature-spec-report/index.html]
+  feature-spec-md init [--kind feature|model|stack|design] [--dir specs]
+  feature-spec-md check [--specs "specs/**/*.model.md,specs/**/*.feature.md,specs/**/*.stack.md,specs/**/*.design.md"] [--tests "tests/**/*.spec.ts"]
+  feature-spec-md report [--specs "specs/**/*.model.md,specs/**/*.feature.md,specs/**/*.stack.md,specs/**/*.design.md"] [--tests "tests/**/*.spec.ts"] [--screenshots "test-results/spec-report/screenshots.json"] [--out test-results/feature-spec-report/index.html]
 
 Options:
+  --require-model-coverage      Fail when model items have no matching test references.
   --require-rule-coverage       Fail when rules have no matching test references.
   --require-scenario-coverage   Defaults to true for check. Use --require-scenario-coverage=false to disable.
+  --screenshots                 Screenshot manifest JSON glob for report evidence.
   --tests ""                   Disable test coverage lookup.
 `);
 }
-const exampleSpec = `---
+function fileNameForKind(kind) {
+    if (kind === "model")
+        return "example.model.md";
+    if (kind === "stack")
+        return "example.stack.md";
+    if (kind === "design")
+        return "example.design.md";
+    return "account-access.feature.md";
+}
+function exampleForKind(kind) {
+    if (kind === "model")
+        return exampleModel;
+    if (kind === "stack")
+        return exampleStack;
+    if (kind === "design")
+        return exampleDesign;
+    return exampleFeature;
+}
+const exampleModel = `---
 id: ACCOUNT
+title: Account model
+status: draft
+---
+
+# Account model
+
+## Purpose
+
+Define the shared account concepts used by account access features.
+
+## Model
+
+### ACCOUNT-M001: Account
+
+An account represents one registered person.
+`;
+const exampleFeature = `---
+id: ACCOUNT-ACCESS
 title: Account access
 status: draft
+model: ACCOUNT
 ---
 
 # Account access
@@ -113,24 +162,82 @@ People can access their own account after proving their identity.
 
 ## Rules
 
-- ACCOUNT-R001: A person MUST prove control of a registered email address before accessing an account.
-- ACCOUNT-R002: The system MUST NOT reveal whether an unknown email address belongs to an account.
-- ACCOUNT-R003: A signed-in person SHOULD be returned to the page they originally requested.
+- ACCOUNT-ACCESS-R001: A person MUST prove control of a registered email address before accessing an account.
+- ACCOUNT-ACCESS-R002: The system MUST NOT reveal whether an unknown email address belongs to an account.
 
 ## Scenarios
 
-### ACCOUNT-S001: Registered person signs in
+### ACCOUNT-ACCESS-S001: Registered person signs in
+
+Given a registered person is on the sign-in page
+When they request and open a valid sign-in link
+Then they are signed in
+`;
+const exampleStack = `---
+id: ACCOUNT-STACK
+title: Account stack
+status: draft
+---
+
+# Account stack
+
+## Purpose
+
+Define the initial technical stack for the account access demo.
+
+## Context
+
+The demo is a small browser-based application with automated tests.
+
+## Stack
+
+| Area | Choice |
+|---|---|
+| Frontend | React |
+| Language | TypeScript |
+| Testing | Playwright |
+
+## Rationale
+
+React, TypeScript, and Playwright fit the interaction-heavy UI and scenario-based testing style.
+
+## Consequences
+
+The stack is optimized for a browser UI and static deployment.
+`;
+const exampleDesign = `---
+id: ACCOUNT-DESIGN
+title: Account design
+status: draft
+model: ACCOUNT
+---
+
+# Account design
+
+## Purpose
+
+Define the initial interaction and visual design direction for account access.
+
+## Design
+
+The account access flow should feel simple, calm, and direct.
+
+## Principles
+
+- Keep the sign-in flow short.
+- Avoid revealing whether an email address exists.
+- Make recovery states easy to understand.
+
+## Layout
+
+The sign-in page uses one primary form and one primary action.
+
+## Interaction
 
-Given a registered person is on the sign-in page  
-When they request and open a valid sign-in link  
-Then they are signed in  
-And they are returned to the page they originally requested
+Validation messages appear near the field they describe.
 
-### ACCOUNT-S002: Unknown email receives a neutral response
+## Visual style
 
-Given a person enters an email address that is not registered  
-When they request a sign-in link  
-Then the response says to check their email  
-And the response does not reveal whether the email address is registered
+Use a clean, low-distraction visual style.
 `;
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/filePatterns.d.ts

@@ -0,0 +1,5 @@
+/** Expand user-provided source globs while ignoring generated directories. */
+export declare function expandFilePatterns(patterns: string[]): Promise<string[]>;
+/** Expand report artifact globs, including files under `test-results`. */
+export declare function expandArtifactPatterns(patterns: string[]): Promise<string[]>;
+//# sourceMappingURL=filePatterns.d.ts.map

package/dist/filePatterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filePatterns.d.ts","sourceRoot":"","sources":["../src/filePatterns.ts"],"names":[],"mappings":"AAEA,8EAA8E;AAC9E,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,qBAO1D;AAED,0EAA0E;AAC1E,wBAAsB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,qBAE9D"}

package/dist/filePatterns.js

@@ -0,0 +1,24 @@
+import { glob } from "node:fs/promises";
+/** Expand user-provided source globs while ignoring generated directories. */
+export async function expandFilePatterns(patterns) {
+    return expandPatterns(patterns, [
+        "node_modules/**",
+        ".git/**",
+        "dist/**",
+        "test-results/**",
+    ]);
+}
+/** Expand report artifact globs, including files under `test-results`. */
+export async function expandArtifactPatterns(patterns) {
+    return expandPatterns(patterns, ["node_modules/**", ".git/**", "dist/**"]);
+}
+async function expandPatterns(patterns, exclude) {
+    const files = new Set();
+    for (const pattern of patterns) {
+        for await (const file of glob(pattern, { exclude })) {
+            files.add(file);
+        }
+    }
+    return Array.from(files).sort();
+}
+//# sourceMappingURL=filePatterns.js.map

package/dist/filePatterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filePatterns.js","sourceRoot":"","sources":["../src/filePatterns.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,8EAA8E;AAC9E,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,QAAkB;IACzD,OAAO,cAAc,CAAC,QAAQ,EAAE;QAC9B,iBAAiB;QACjB,SAAS;QACT,SAAS;QACT,iBAAiB;KAClB,CAAC,CAAC;AACL,CAAC;AAED,0EAA0E;AAC1E,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,QAAkB;IAC7D,OAAO,cAAc,CAAC,QAAQ,EAAE,CAAC,iBAAiB,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,QAAkB,EAAE,OAAiB;IACjE,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;YACpD,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;AAClC,CAAC"}

package/dist/html.d.ts

@@ -0,0 +1,2 @@
+export declare function html(value: string): string;
+//# sourceMappingURL=html.d.ts.map

package/dist/html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../src/html.ts"],"names":[],"mappings":"AAAA,wBAAgB,IAAI,CAAC,KAAK,EAAE,MAAM,UAOjC"}

package/dist/html.js

@@ -0,0 +1,9 @@
+export function html(value) {
+    return value
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/\"/g, "&quot;")
+        .replace(/'/g, "&#039;");
+}
+//# sourceMappingURL=html.js.map

package/dist/html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.js","sourceRoot":"","sources":["../src/html.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,IAAI,CAAC,KAAa;IAChC,OAAO,KAAK;SACT,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC;SACxB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7B,CAAC"}