@anselmdk/feature-spec-md 0.1.1-rc.6 → 0.2.1

package/README.md

@@ -1,83 +1,123 @@
 # feature-spec-md
 
-Markdown feature specs with stable model, rule, and scenario IDs, validation, coverage checks, and generated reports.
+Markdown specs for AI-assisted, testable spec driven development.
 
-The goal is simple:
+The concept is deliberately small:
 
 ```txt
-human-readable model + feature specs
-→ exact executable tests
-→ generated coverage report
+model + features + stack + design
+-> AI-written executable tests that reference stable spec IDs
+-> validation, coverage, screenshots, and reports
 ```
 
-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.
+The specs are meant to be written with an AI before implementation. The tests are meant to be written with an AI from those specs. `feature-spec-md` checks that the Markdown stays structured and that executable tests still cover the model items, rules, and scenarios the specs define.
 
-## Format
+## What You Write
 
-Feature Spec Markdown uses ordinary Markdown files:
+Use four ordinary Markdown document types:
 
 ```txt
-*.model.md
-*.feature.md
+*.model.md    shared domain vocabulary
+*.feature.md  user-facing behavior, rules, and scenarios
+*.stack.md    technical platform choices
+*.design.md   product, UI, and interaction direction
 ```
 
-Model files use:
+Each document has frontmatter, a short `## Purpose`, and stable IDs. Tests reference those IDs in titles, tags, annotations, comments, or metadata.
 
-- frontmatter for metadata
-- `## Model` for shared domain vocabulary
-- optional `## Rules` for global invariants
+```md
+### ACCOUNT-ACCESS-S001: Registered person signs in
 
-Feature files use:
+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
+```
+
+```ts
+test("ACCOUNT-ACCESS-S001 registered person signs in", async ({ page }) => {
+  // Covers ACCOUNT-ACCESS-R001 and ACCOUNT-M001.
+});
+```
+
+See [SPEC_FORMAT.md](SPEC_FORMAT.md) for the exact document format.
+
+## Install
+
+```bash
+npm install -D @anselmdk/feature-spec-md
+```
 
-- frontmatter for metadata
-- optional `model` or `models` references
-- `## Rules` for durable product truths
-- `## Scenarios` for Given / When / Then examples
+Create starter specs:
 
-See `SPEC_FORMAT.md` and `examples/account-access.feature.md`.
+```bash
+npx feature-spec-md init --kind model --dir specs
+npx feature-spec-md init --kind feature --dir specs
+npx feature-spec-md init --kind stack --dir specs
+npx feature-spec-md init --kind design --dir specs
+```
+
+## Workflow
+
+1. Ask an AI to draft or update `*.model.md`, `*.feature.md`, `*.stack.md`, and `*.design.md` files.
+2. Run `npx feature-spec-md check` until the spec set is valid.
+3. Ask an AI to write executable tests from the specs, preserving the relevant `-M001`, `-R001`, and `-S001` IDs in the test source.
+4. Run `npx feature-spec-md coverage` to see which scenarios, rules, and model items have tests.
+5. Run `npx feature-spec-md report` to generate an HTML implementation report for review or CI artifacts.
+
+The longer flow, including AI prompts and CI setup, is in [docs/spec-driven-flow.md](docs/spec-driven-flow.md).
 
 ## CLI
 
 ```bash
-npm install
-npm run dev -- check --specs "examples/**/*.feature.md" --tests "tests/**/*.test.ts" --require-scenario-coverage=false
-npm run dev -- coverage --specs "specs/**/*.feature.md" --tests "tests/**/*.spec.ts"
-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"
+npx feature-spec-md check
+npx feature-spec-md coverage --fail-on-missing
+npx feature-spec-md report --out test-results/feature-spec-report/index.html
 ```
 
-The `coverage` command prints a simple terminal report that groups feature
-specs by whether all, some, or none of their scenarios have matching test
-references. Use `--fail-on-missing` when missing scenario tests should fail CI.
-
-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"
-    }
-  ]
-}
+By default the CLI scans:
+
+```txt
+specs/**/*.model.md
+specs/**/*.feature.md
+specs/**/*.stack.md
+specs/**/*.design.md
+tests/**/*.spec.ts
+```
+
+Use explicit patterns when your project uses different paths:
+
+```bash
+npx feature-spec-md check \
+  --specs "product/**/*.model.md,product/**/*.feature.md,product/**/*.stack.md,product/**/*.design.md" \
+  --tests "e2e/**/*.spec.ts"
+```
+
+The `check` command validates spec structure, references between documents, and test coverage. Scenario coverage is required by default when tests are scanned. Use `--require-scenario-coverage=false` while drafting.
+
+The `coverage` command prints a terminal implementation report. Use `--fail-on-missing` when missing scenario tests should fail CI.
+
+The `report` command writes an HTML report. It can include screenshot evidence from Playwright or another test runner by passing one or more screenshot manifest files:
+
+```bash
+npx feature-spec-md report \
+  --screenshots "test-results/spec-report/screenshots-*.json"
 ```
 
 ## Library API
 
+Most integrations can use the top-level document API:
+
 ```ts
 import {
-  checkFeatureSpecs,
-  parseFeatureSpec,
+  checkSpecDocuments,
+  parseSpecDocument,
   renderHtmlReport,
-  validateFeatureSpec,
-} from "feature-spec-md";
+  validateSpecDocument,
+} from "@anselmdk/feature-spec-md";
 ```
 
+Feature-only helpers such as `parseFeatureSpec` and `checkFeatureSpecs` remain available for compatibility.
+
 ## Development
 
 ```bash
@@ -89,16 +129,4 @@ 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
-```
+Release candidates and stable releases are documented in [docs/releasing.md](docs/releasing.md).

package/SPEC_FORMAT.md

@@ -1,12 +1,12 @@
-# Feature Spec Markdown format
+# Feature Spec Markdown Format
 
-Feature Spec Markdown is a lightweight convention for readable, testable specifications.
+Feature Spec Markdown is a lightweight format for testable specs.
 
-It uses ordinary Markdown and stable IDs instead of a dedicated executable specification language.
+It uses ordinary Markdown plus stable IDs so an AI can write clear product specs, another AI pass can write executable tests from those specs, and tooling can verify that the tests still cover the documented behavior.
 
-## File types
+## Document Set
 
-The format has four document types:
+A spec set can contain four document types:
 
 ```txt
 *.model.md
@@ -15,10 +15,19 @@ The format has four document types:
 *.design.md
 ```
 
-- `*.model.md` defines shared domain vocabulary.
+- `*.model.md` defines shared domain vocabulary and global domain rules.
 - `*.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.
+- `*.stack.md` defines technical platform choices and their rationale.
+- `*.design.md` defines product, UI, layout, visual, and interaction direction.
+
+The short version:
+
+```txt
+model tells tests what things mean
+features tell tests what behavior must work
+stack tells implementation what tools and constraints to use
+design tells implementation what experience to create
+```
 
 ## Frontmatter
 
@@ -45,13 +54,15 @@ Optional fields:
 - `model`: a single referenced model id, for feature and design files
 - `models`: comma-separated referenced model ids, for feature and design files
 
+IDs use uppercase words separated by hyphens. IDs are the contract between specs, tests, reports, and implementation work.
+
 ## Purpose
 
 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
 
 Model files use the `.model.md` suffix.
 
@@ -79,9 +90,13 @@ Model items use stable `-M001` IDs:
 A card represents one work item on the board.
 ```
 
-Model rules use stable `-R001` IDs and should describe global invariants for the domain vocabulary.
+Model rules use stable `-R001` IDs and describe global invariants for the domain vocabulary:
+
+```md
+- KANBAN-R001: A card MUST have one current workflow state.
+```
 
-## Feature files
+## Feature Files
 
 Feature files use the `.feature.md` suffix.
 
@@ -121,7 +136,9 @@ Allowed step keywords:
 - `And`
 - `But`
 
-## Stack files
+Rules state durable product truths. Scenarios show concrete examples that executable tests can implement.
+
+## Stack Files
 
 Stack files use the `.stack.md` suffix.
 
@@ -171,7 +188,7 @@ Define the initial technical stack for implementing the Kanban board.
 | Testing  | Playwright |
 ```
 
-## Design files
+## Design Files
 
 Design files use the `.design.md` suffix.
 
@@ -220,17 +237,19 @@ Define the visual and interaction design direction for the Kanban board.
 The board should feel lightweight, immediate, and calm.
 ```
 
-## Splitting guidance
+## Splitting Guidance
 
 Split model files by coherent domain vocabulary, ownership, or lifecycle.
 
-Feature files SHOULD be split by user capability.
+Split feature files by user capability.
 
-Use stack files for broad technical choices such as framework, language, testing, persistence, and deployment.
+Use stack files for broad technical choices such as framework, language, testing, persistence, deployment, and runtime constraints.
 
 Use design files for product/UI direction such as layout, interaction, visual style, and design principles.
 
-## Test coverage convention
+Keep each document small enough for an AI to read, revise, and use as test-writing context without extra explanation.
+
+## Test Coverage Convention
 
 Spec files do not contain test mappings.
 
@@ -243,3 +262,11 @@ Generated tooling can answer:
 - Which rules have executable coverage?
 - Which tests reference deleted or unknown spec IDs?
 - Which visible flows have screenshots, traces, or other evidence?
+
+Example:
+
+```ts
+test("KANBAN-CARD-AUTHORING-S001 user creates a card", async ({ page }) => {
+  // Covers KANBAN-M001 and KANBAN-CARD-AUTHORING-R001.
+});
+```

package/dist/cli.js

@@ -1,4 +1,8 @@
 #!/usr/bin/env node
+/**
+ * Command-line interface for initializing, validating, reporting on, and
+ * measuring test coverage for Feature Spec Markdown documents.
+ */
 import { mkdir, readFile, writeFile } from "node:fs/promises";
 import path from "node:path";
 import { collectSpecScreenshots, renderHtmlReport, writeTextFile, } from "./index.js";
@@ -149,7 +153,7 @@ function printHelp() {
 Usage:
   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 coverage [--specs "specs/**/*.feature.md"] [--tests "tests/**/*.spec.ts"] [--fail-on-missing]
+  feature-spec-md coverage [--specs "specs/**/*.model.md,specs/**/*.feature.md,specs/**/*.stack.md,specs/**/*.design.md"] [--tests "tests/**/*.spec.ts"] [--fail-on-missing]
   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:

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,aAAa,GAEd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EACL,6BAA6B,EAC7B,8BAA8B,GAC/B,MAAM,+BAA+B,CAAC;AAEvC,MAAM,kBAAkB,GACtB,oFAAoF,CAAC;AACvF,MAAM,kBAAkB,GAAG,oBAAoB,CAAC;AAEhD,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,KAAK,UAAU,IAAI;IACjB,MAAM,CAAC,OAAO,GAAG,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAEhC,IAAI,OAAO,KAAK,OAAO;QAAE,OAAO,QAAQ,CAAC,OAAO,CAAC,CAAC;IAClD,IAAI,OAAO,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC;IACpD,IAAI,OAAO,KAAK,UAAU;QAAE,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC;IACxD,IAAI,OAAO,KAAK,MAAM;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,CAAC;IAEhD,SAAS,EAAE,CAAC;IACZ,OAAO,CAAC,IAAI,CACV,OAAO,KAAK,MAAM,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CACvE,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,QAAQ,CAAC,OAAmB;IACzC,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC;QACtC,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,kBAAkB,CAAC;QACpD,KAAK,EACH,OAAO,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,kBAAkB,CAAC;QAC3E,mBAAmB,EAAE,OAAO,CAAC,uBAAuB,CAAC,KAAK,MAAM;QAChE,uBAAuB,EAAE,OAAO,CAAC,2BAA2B,CAAC,KAAK,OAAO;KAC1E,CAAC,CAAC;IAEH,WAAW,CAAC,CAAC,GAAG,MAAM,CAAC,gBAAgB,EAAE,GAAG,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC;IACpE,IAAI,CAAC,MAAM,CAAC,EAAE;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAEhC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CACzC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,MAAM,EAC3C,CAAC,CACF,CAAC;IACF,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,MAAM,CACvC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EACtC,CAAC,CACF,CAAC;IACF,MAAM,aAAa,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAC1C,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,CAAC,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAC1C,CAAC,CACF,CAAC;IACF,OAAO,CAAC,GAAG,CACT,sBAAsB,MAAM,CAAC,MAAM,CAAC,MAAM,cAAc,MAAM,CAAC,QAAQ,CAAC,MAAM,gBAAgB,MAAM,CAAC,MAAM,CAAC,MAAM,cAAc,MAAM,CAAC,OAAO,CAAC,MAAM,eAAe,cAAc,mBAAmB,SAAS,aAAa,aAAa,eAAe,CACxP,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,WAAW,CAAC,OAAmB;IAC5C,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC;QACtC,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,kBAAkB,CAAC;QACpD,KAAK,EACH,OAAO,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,kBAAkB,CAAC;QAC3E,oBAAoB,EAAE,KAAK;QAC3B,mBAAmB,EAAE,KAAK;QAC1B,uBAAuB,EAAE,KAAK;KAC/B,CAAC,CAAC;IAEH,WAAW,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IAEnC,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,iCAAiC,CAAC,CAAC;QAC/C,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAChB,OAAO,CAAC,GAAG,CACT,oGAAoG,CACrG,CAAC;QACF,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,6BAA6B,CAC1C,MAAM,CAAC,QAAQ,EACf,MAAM,CAAC,QAAQ,EACf,MAAM,CAAC,MAAM,CACd,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,8BAA8B,CAAC,MAAM,CAAC,CAAC,CAAC;IAEpD,IAAI,OAAO,CAAC,iBAAiB,CAAC,KAAK,MAAM,IAAI,MAAM,CAAC,gBAAgB,GAAG,CAAC,EAAE,CAAC;QACzE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,SAAS,CAAC,OAAmB;IAC1C,MAAM,MAAM,GAAG,MAAM,kBAAkB,CAAC;QACtC,KAAK,EAAE,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,kBAAkB,CAAC;QACpD,KAAK,EACH,OAAO,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,KAAK,EAAE,kBAAkB,CAAC;QAC3E,mBAAmB,EAAE,OAAO,CAAC,uBAAuB,CAAC,KAAK,MAAM;QAChE,uBAAuB,EAAE,KAAK;KAC/B,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,6CAA6C,CAAC;IACzE,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW;QACrC,CAAC,CAAC,MAAM,sBAAsB,CAAC,UAAU,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACnE,CAAC,CAAC,EAAE,CAAC;IACP,MAAM,aAAa,CACjB,GAAG,EACH,gBAAgB,CAAC,MAAM,CAAC,QAAQ,EAAE;QAChC,KAAK,EAAE,MAAM,WAAW,EAAE;QAC1B,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,WAAW;QACX,gBAAgB,EAAE,CAAC,GAAG,MAAM,CAAC,gBAAgB,EAAE,GAAG,MAAM,CAAC,cAAc,CAAC;KACzE,CAAC,CACH,CAAC;IACF,OAAO,CAAC,GAAG,CAAC,kCAAkC,GAAG,EAAE,CAAC,CAAC;AACvD,CAAC;AAED,KAAK,UAAU,OAAO,CAAC,OAAmB;IACxC,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC;IACnC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,SAAS,CAAC;IACvC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;IACrD,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,MAAM,SAAS,CAAC,MAAM,EAAE,cAAc,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;IACtD,OAAO,CAAC,GAAG,CAAC,WAAW,MAAM,EAAE,CAAC,CAAC;AACnC,CAAC;AAID,SAAS,SAAS,CAAC,IAAc;IAC/B,MAAM,OAAO,GAAe,EAAE,CAAC;IAC/B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC;YAAE,SAAS;QACpC,MAAM,CAAC,GAAG,EAAE,WAAW,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACtD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YAC9B,OAAO,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC;YAC3B,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAC7B,IAAI,IAAI,KAAK,SAAS,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACjD,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;YACpB,KAAK,IAAI,CAAC,CAAC;YACX,SAAS;QACX,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;IACxB,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,UAAU,CAAC,KAAyB,EAAE,QAAgB;IAC7D,OAAO,CAAC,KAAK,IAAI,QAAQ,CAAC;SACvB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;SAC1B,MAAM,CAAC,OAAO,CAAC,CAAC;AACrB,CAAC;AAED,SAAS,WAAW,CAAC,MAAyB;IAC5C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ;YAC7B,CAAC,CAAC,GAAG,KAAK,CAAC,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;YAC1D,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,CAAC,KAAK,CACX,GAAG,KAAK,CAAC,QAAQ,CAAC,WAAW,EAAE,IAAI,KAAK,CAAC,IAAI,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,OAAO,EAAE,CACnG,CAAC;IACJ,CAAC;AACH,CAAC;AAED,KAAK,UAAU,WAAW;IACxB,MAAM,WAAW,GAAG,MAAM,eAAe,EAAE,CAAC;IAC5C,OAAO,WAAW;QAChB,CAAC,CAAC,2BAA2B,WAAW,EAAE;QAC1C,CAAC,CAAC,qBAAqB,CAAC;AAC5B,CAAC;AAED,KAAK,UAAU,eAAe;IAC5B,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC;QACnD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAuB,CAAC;QACrD,OAAO,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE;YAC1D,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE;YACpB,CAAC,CAAC,SAAS,CAAC;IAChB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;CAcb,CAAC,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,IAAY;IACnC,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,kBAAkB,CAAC;IAChD,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,kBAAkB,CAAC;IAChD,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,mBAAmB,CAAC;IAClD,OAAO,2BAA2B,CAAC;AACrC,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,YAAY,CAAC;IAC1C,IAAI,IAAI,KAAK,OAAO;QAAE,OAAO,YAAY,CAAC;IAC1C,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,aAAa,CAAC;IAC5C,OAAO,cAAc,CAAC;AACxB,CAAC;AAED,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;CAiBpB,CAAC;AAEF,MAAM,cAAc,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;CAyBtB,CAAC;AAEF,MAAM,YAAY,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BpB,CAAC;AAEF,MAAM,aAAa,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAkCrB,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/featureSpecs.d.ts

@@ -0,0 +1,34 @@
+import type { CoverageSummary, FeatureSpec, TestReference, ValidationIssue } from "./types.js";
+/** Parse one feature spec Markdown document into structured metadata, rules, and scenarios. */
+export declare function parseFeatureSpec(source: string, options?: {
+    filePath?: string;
+}): FeatureSpec;
+/** Validate spec structure, ID prefixes, duplicate IDs, and required sections. */
+export declare function validateFeatureSpec(spec: FeatureSpec): ValidationIssue[];
+/** Find rule and scenario IDs referenced by one test source file. */
+export declare function parseTestReferences(source: string, filePath?: string): TestReference[];
+/** Expand test file globs and collect all rule and scenario references from them. */
+export declare function collectTestReferences(patterns: string[]): Promise<TestReference[]>;
+/** Build rule and scenario coverage from parsed specs and collected test references. */
+export declare function buildCoverageSummary(specs: FeatureSpec[], references: TestReference[]): CoverageSummary;
+/** Validate coverage expectations and orphaned references. */
+export declare function validateCoverage(coverage: CoverageSummary, options?: {
+    requireRuleCoverage?: boolean;
+    requireScenarioCoverage?: boolean;
+}): ValidationIssue[];
+/** Load and parse all feature specs matching the provided globs. */
+export declare function loadFeatureSpecs(patterns: string[]): Promise<FeatureSpec[]>;
+/** Run spec validation and optional test coverage validation in one call. */
+export declare function checkFeatureSpecs(options: {
+    specs: string[];
+    tests?: string[];
+    requireRuleCoverage?: boolean;
+    requireScenarioCoverage?: boolean;
+}): Promise<{
+    specs: FeatureSpec[];
+    validationIssues: ValidationIssue[];
+    coverage: CoverageSummary | undefined;
+    coverageIssues: ValidationIssue[];
+    ok: boolean;
+}>;
+//# sourceMappingURL=featureSpecs.d.ts.map

package/dist/featureSpecs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"featureSpecs.d.ts","sourceRoot":"","sources":["../src/featureSpecs.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAEV,eAAe,EAGf,WAAW,EAEX,aAAa,EACb,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,+FAA+F;AAC/F,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAO,GAClC,WAAW,CAab;AAED,kFAAkF;AAClF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,GAAG,eAAe,EAAE,CA2GxE;AAED,qEAAqE;AACrE,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,MAAM,EACd,QAAQ,SAAa,GACpB,aAAa,EAAE,CAyBjB;AAED,qFAAqF;AACrF,wBAAsB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,4BAM7D;AAED,wFAAwF;AACxF,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,WAAW,EAAE,EACpB,UAAU,EAAE,aAAa,EAAE,GAC1B,eAAe,CAkCjB;AAED,8DAA8D;AAC9D,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,eAAe,EACzB,OAAO,GAAE;IACP,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,uBAAuB,CAAC,EAAE,OAAO,CAAC;CAC9B,qBAmDP;AAED,oEAAoE;AACpE,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,0BAQxD;AAED,6EAA6E;AAC7E,wBAAsB,iBAAiB,CAAC,OAAO,EAAE;IAC/C,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;;;;;;GAsBA"}

package/dist/featureSpecs.js

@@ -0,0 +1,240 @@
+/**
+ * Feature-spec parsing, validation, test-reference extraction, and coverage
+ * checks for `*.feature.md` documents.
+ */
+import { readFile } from "node:fs/promises";
+import { expandFilePatterns } from "./filePatterns.js";
+import { dedupeTestReferences, lineForOffset, parseMarkdownDocument, parseRuleItems, ruleIdPattern, scenarioIdPattern, } from "./specMarkdown.js";
+/** Parse one feature spec Markdown document into structured metadata, rules, and scenarios. */
+export function parseFeatureSpec(source, options = {}) {
+    const filePath = options.filePath ?? "<inline>";
+    const parsed = parseMarkdownDocument(source, "Feature spec");
+    return {
+        filePath,
+        frontmatter: parsed.frontmatter,
+        title: parsed.title,
+        purpose: parsed.purpose,
+        rules: parseRuleItems(parsed.lines, parsed.bodyStartLine),
+        scenarios: parseScenarios(parsed.lines, parsed.bodyStartLine),
+        source,
+    };
+}
+/** Validate spec structure, ID prefixes, duplicate IDs, and required sections. */
+export function validateFeatureSpec(spec) {
+    const issues = [];
+    const seen = new Map();
+    if (!/^[A-Z][A-Z0-9]*(?:-[A-Z0-9]+)*$/.test(spec.frontmatter.id)) {
+        issues.push(issue(spec, "invalid-feature-id", "error", `Feature id "${spec.frontmatter.id}" must use uppercase words separated by hyphens.`));
+    }
+    if (spec.title !== spec.frontmatter.title) {
+        issues.push(issue(spec, "title-mismatch", "warning", "The H1 title should match frontmatter.title."));
+    }
+    if (!spec.purpose) {
+        issues.push(issue(spec, "missing-purpose", "error", "Feature spec must include a non-empty ## Purpose section."));
+    }
+    if (spec.scenarios.length === 0) {
+        issues.push(issue(spec, "missing-scenarios", "error", "Feature spec must include at least one scenario."));
+    }
+    for (const rule of spec.rules) {
+        if (!rule.id.startsWith(`${spec.frontmatter.id}-`)) {
+            issues.push(issue(spec, "wrong-rule-prefix", "error", `Rule id "${rule.id}" must start with ${spec.frontmatter.id}-.`, rule.line));
+        }
+        if (!rule.keyword) {
+            issues.push(issue(spec, "missing-rule-keyword", "warning", `Rule "${rule.id}" should use MUST, MUST NOT, SHOULD, SHOULD NOT, MAY, or OPTIONAL.`, rule.line));
+        }
+        registerId(spec, issues, seen, rule.id, rule.line);
+    }
+    for (const scenario of spec.scenarios) {
+        if (!scenario.id.startsWith(`${spec.frontmatter.id}-`)) {
+            issues.push(issue(spec, "wrong-scenario-prefix", "error", `Scenario id "${scenario.id}" must start with ${spec.frontmatter.id}-.`, scenario.line));
+        }
+        for (const keyword of ["Given", "When", "Then"]) {
+            if (!scenario.steps.some((step) => step.keyword === keyword)) {
+                issues.push(issue(spec, `missing-${keyword.toLowerCase()}`, "warning", `Scenario "${scenario.id}" should include a ${keyword} step.`, scenario.line));
+            }
+        }
+        registerId(spec, issues, seen, scenario.id, scenario.line);
+    }
+    return issues;
+}
+/** Find rule and scenario IDs referenced by one test source file. */
+export function parseTestReferences(source, filePath = "<inline>") {
+    const lines = source.split(/\r?\n/);
+    const refs = [];
+    for (const match of source.matchAll(scenarioIdPattern)) {
+        refs.push({
+            id: match[0],
+            filePath,
+            line: lineForOffset(lines, match.index ?? 0),
+            kind: "scenario",
+            source: sourceForMatch(source, match.index ?? 0),
+        });
+    }
+    for (const match of source.matchAll(ruleIdPattern)) {
+        refs.push({
+            id: match[0],
+            filePath,
+            line: lineForOffset(lines, match.index ?? 0),
+            kind: "rule",
+            source: sourceForMatch(source, match.index ?? 0),
+        });
+    }
+    return dedupeTestReferences(refs);
+}
+/** Expand test file globs and collect all rule and scenario references from them. */
+export async function collectTestReferences(patterns) {
+    const refs = [];
+    for (const file of await expandFilePatterns(patterns)) {
+        refs.push(...parseTestReferences(await readFile(file, "utf8"), file));
+    }
+    return refs;
+}
+/** Build rule and scenario coverage from parsed specs and collected test references. */
+export function buildCoverageSummary(specs, references) {
+    const scenarios = new Map(specs.flatMap((spec) => spec.scenarios.map((scenario) => [scenario.id, { spec, scenario }])));
+    const rules = new Map(specs.flatMap((spec) => spec.rules.map((rule) => [rule.id, { spec, rule }])));
+    const scenarioRefs = references.filter((ref) => ref.kind === "scenario");
+    const ruleRefs = references.filter((ref) => ref.kind === "rule");
+    return {
+        scenarioCoverage: Array.from(scenarios.entries()).map(([id, value]) => item(id, value.scenario.title, value.spec.filePath, value.scenario.line, scenarioRefs)),
+        ruleCoverage: Array.from(rules.entries()).map(([id, value]) => item(id, value.rule.text, value.spec.filePath, value.rule.line, ruleRefs)),
+        orphanScenarioReferences: scenarioRefs.filter((ref) => !scenarios.has(ref.id)),
+        orphanRuleReferences: ruleRefs.filter((ref) => !rules.has(ref.id)),
+    };
+}
+/** Validate coverage expectations and orphaned references. */
+export function validateCoverage(coverage, options = {}) {
+    const issues = [];
+    if (options.requireScenarioCoverage ?? true) {
+        for (const item of coverage.scenarioCoverage.filter((item) => !item.covered)) {
+            issues.push({
+                code: "missing-scenario-coverage",
+                severity: "error",
+                message: `Scenario "${item.id}" has no matching test reference.`,
+                filePath: item.filePath,
+                line: item.line,
+            });
+        }
+    }
+    if (options.requireRuleCoverage ?? false) {
+        for (const item of coverage.ruleCoverage.filter((item) => !item.covered)) {
+            issues.push({
+                code: "missing-rule-coverage",
+                severity: "error",
+                message: `Rule "${item.id}" has no matching test reference.`,
+                filePath: item.filePath,
+                line: item.line,
+            });
+        }
+    }
+    for (const ref of coverage.orphanScenarioReferences) {
+        issues.push({
+            code: "orphan-scenario-reference",
+            severity: "error",
+            message: `Test references unknown scenario "${ref.id}".`,
+            filePath: ref.filePath,
+            line: ref.line,
+        });
+    }
+    for (const ref of coverage.orphanRuleReferences) {
+        issues.push({
+            code: "orphan-rule-reference",
+            severity: "error",
+            message: `Test references unknown rule "${ref.id}".`,
+            filePath: ref.filePath,
+            line: ref.line,
+        });
+    }
+    return issues;
+}
+/** Load and parse all feature specs matching the provided globs. */
+export async function loadFeatureSpecs(patterns) {
+    const specs = [];
+    for (const file of await expandFilePatterns(patterns)) {
+        specs.push(parseFeatureSpec(await readFile(file, "utf8"), { filePath: file }));
+    }
+    return specs;
+}
+/** Run spec validation and optional test coverage validation in one call. */
+export async function checkFeatureSpecs(options) {
+    const specs = await loadFeatureSpecs(options.specs);
+    const validationIssues = specs.flatMap(validateFeatureSpec);
+    const coverage = options.tests?.length
+        ? buildCoverageSummary(specs, await collectTestReferences(options.tests))
+        : undefined;
+    const coverageIssues = coverage
+        ? validateCoverage(coverage, {
+            requireRuleCoverage: options.requireRuleCoverage,
+            requireScenarioCoverage: options.requireScenarioCoverage,
+        })
+        : [];
+    return {
+        specs,
+        validationIssues,
+        coverage,
+        coverageIssues,
+        ok: ![...validationIssues, ...coverageIssues].some((i) => i.severity === "error"),
+    };
+}
+function parseScenarios(lines, bodyStartLine) {
+    const scenarios = [];
+    for (let i = 0; i < lines.length; i += 1) {
+        const match = lines[i].match(/^###\s+([A-Z][A-Z0-9]*(?:-[A-Z0-9]+)*-S\d{3}):\s+(.+)$/);
+        if (!match)
+            continue;
+        const steps = [];
+        for (let j = i + 1; j < lines.length; j += 1) {
+            if (/^##?#\s+/.test(lines[j]))
+                break;
+            const step = lines[j].trim().match(/^(Given|When|Then|And|But)\s+(.+)$/);
+            if (step)
+                steps.push({
+                    keyword: step[1],
+                    text: step[2].trim(),
+                    line: bodyStartLine + j,
+                });
+        }
+        scenarios.push({
+            id: match[1],
+            title: match[2].trim(),
+            line: bodyStartLine + i,
+            steps,
+        });
+    }
+    return scenarios;
+}
+function issue(spec, code, severity, message, line) {
+    return { code, severity, message, filePath: spec.filePath, line };
+}
+function registerId(spec, issues, seen, id, line) {
+    const previous = seen.get(id);
+    if (previous)
+        issues.push(issue(spec, "duplicate-id", "error", `Duplicate id "${id}". First occurrence is on line ${previous}.`, line));
+    seen.set(id, line);
+}
+function item(id, title, filePath, line, refs) {
+    const references = refs.filter((ref) => ref.id === id);
+    return {
+        id,
+        title,
+        filePath,
+        line,
+        references,
+        covered: references.length > 0,
+    };
+}
+function sourceForMatch(source, offset) {
+    const before = source.slice(Math.max(0, offset - 80), offset);
+    const context = source.slice(Math.max(0, offset - 80), offset + 80);
+    if (/covers\s*:\s*\[[^\]]*$/.test(before))
+        return "covers";
+    if (/tag\s*:\s*\[[^\]]*$/.test(before) ||
+        /@/.test(source.slice(Math.max(0, offset - 2), offset + 2)))
+        return "tag";
+    if (/annotation/.test(context))
+        return "annotation";
+    if (/test|scenario/.test(before.slice(-40)))
+        return "title";
+    return "free-text";
+}
+//# sourceMappingURL=featureSpecs.js.map