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

package/dist/specDocuments.js

@@ -0,0 +1,389 @@
+import { readFile } from "node:fs/promises";
+import { expandFilePatterns } from "./filePatterns.js";
+import { buildCoverageSummary, parseFeatureSpec, parseTestReferences, validateCoverage, validateFeatureSpec, } from "./index.js";
+const modelIdPattern = /\b[A-Z][A-Z0-9]*(?:-[A-Z0-9]+)*-M\d{3}\b/g;
+export function parseSpecDocument(source, options = {}) {
+    const filePath = options.filePath ?? "<inline>";
+    const kind = options.kind ?? kindFromPath(filePath);
+    if (kind === "model")
+        return parseModelSpec(source, { filePath });
+    if (kind === "stack")
+        return parseStackSpec(source, { filePath });
+    if (kind === "design")
+        return parseDesignSpec(source, { filePath });
+    return { ...parseFeatureSpec(source, { filePath }), kind: "feature" };
+}
+export function parseModelSpec(source, options = {}) {
+    const filePath = options.filePath ?? "<inline>";
+    const parsed = parseBase(source);
+    return {
+        kind: "model",
+        filePath,
+        frontmatter: parsed.frontmatter,
+        title: parsed.title,
+        purpose: parsed.purpose,
+        modelItems: parseModelItems(parsed.lines, parsed.bodyStartLine),
+        rules: parseRules(parsed.lines, parsed.bodyStartLine),
+        source,
+    };
+}
+export function parseStackSpec(source, options = {}) {
+    const filePath = options.filePath ?? "<inline>";
+    const parsed = parseBase(source);
+    return {
+        kind: "stack",
+        filePath,
+        frontmatter: parsed.frontmatter,
+        title: parsed.title,
+        purpose: parsed.purpose,
+        stack: sectionText(parsed.lines, "Stack").trim(),
+        context: sectionText(parsed.lines, "Context").trim(),
+        rationale: sectionText(parsed.lines, "Rationale").trim(),
+        consequences: sectionText(parsed.lines, "Consequences").trim(),
+        rules: parseRules(parsed.lines, parsed.bodyStartLine),
+        source,
+    };
+}
+export function parseDesignSpec(source, options = {}) {
+    const filePath = options.filePath ?? "<inline>";
+    const parsed = parseBase(source);
+    return {
+        kind: "design",
+        filePath,
+        frontmatter: parsed.frontmatter,
+        title: parsed.title,
+        purpose: parsed.purpose,
+        design: sectionText(parsed.lines, "Design").trim(),
+        principles: sectionText(parsed.lines, "Principles").trim(),
+        layout: sectionText(parsed.lines, "Layout").trim(),
+        interaction: sectionText(parsed.lines, "Interaction").trim(),
+        visualStyle: sectionText(parsed.lines, "Visual style").trim(),
+        rules: parseRules(parsed.lines, parsed.bodyStartLine),
+        source,
+    };
+}
+export async function loadSpecDocuments(patterns) {
+    const documents = [];
+    for (const file of await expandFilePatterns(patterns)) {
+        documents.push(parseSpecDocument(await readFile(file, "utf8"), { filePath: file }));
+    }
+    return documents;
+}
+export function parseSpecTestReferences(source, filePath = "<inline>") {
+    const lines = source.split(/\r?\n/);
+    const modelRefs = Array.from(source.matchAll(modelIdPattern)).map((match) => ({
+        id: match[0],
+        filePath,
+        line: lineForOffset(lines, match.index ?? 0),
+        kind: "model",
+        source: "free-text",
+    }));
+    return dedupe([...parseTestReferences(source, filePath), ...modelRefs]);
+}
+export async function collectSpecTestReferences(patterns) {
+    const refs = [];
+    for (const file of await expandFilePatterns(patterns)) {
+        refs.push(...parseSpecTestReferences(await readFile(file, "utf8"), file));
+    }
+    return refs;
+}
+export function validateModelSpec(spec) {
+    const issues = [];
+    validateCommonSpec(spec, issues);
+    if (!spec.modelItems.length) {
+        issues.push(issue(spec, "missing-model-items", "error", "Model spec must include at least one -M001 model item."));
+    }
+    for (const item of spec.modelItems) {
+        if (!item.id.startsWith(`${spec.frontmatter.id}-`)) {
+            issues.push(issue(spec, "wrong-model-prefix", "error", `Model item id "${item.id}" must start with ${spec.frontmatter.id}-.`, item.line));
+        }
+    }
+    return issues;
+}
+export function validateStackSpec(spec) {
+    const issues = [];
+    validateCommonSpec(spec, issues);
+    if (!spec.stack) {
+        issues.push(issue(spec, "missing-stack", "error", "Stack spec must include a non-empty ## Stack section."));
+    }
+    return issues;
+}
+export function validateDesignSpec(spec) {
+    const issues = [];
+    validateCommonSpec(spec, issues);
+    if (!spec.design) {
+        issues.push(issue(spec, "missing-design", "error", "Design spec must include a non-empty ## Design section."));
+    }
+    return issues;
+}
+export function validateSpecDocument(spec) {
+    if (spec.kind === "model")
+        return validateModelSpec(spec);
+    if (spec.kind === "stack")
+        return validateStackSpec(spec);
+    if (spec.kind === "design")
+        return validateDesignSpec(spec);
+    return validateFeatureSpec(spec);
+}
+export function validateSpecGraph(documents) {
+    const issues = [];
+    const modelIds = new Set(documents.filter(isModelSpec).map((model) => model.frontmatter.id));
+    const seen = new Map();
+    for (const doc of documents) {
+        for (const entry of documentIds(doc)) {
+            const first = seen.get(entry.id);
+            if (first) {
+                issues.push({
+                    code: "duplicate-id",
+                    severity: "error",
+                    message: `Duplicate id "${entry.id}".`,
+                    filePath: entry.filePath,
+                    line: entry.line,
+                });
+            }
+            seen.set(entry.id, entry);
+        }
+        if (isModelReferencingSpec(doc)) {
+            for (const modelId of referencedModelIds(doc)) {
+                if (!modelIds.has(modelId)) {
+                    issues.push({
+                        code: "unknown-model-reference",
+                        severity: "error",
+                        message: `Spec references unknown model "${modelId}".`,
+                        filePath: doc.filePath,
+                    });
+                }
+            }
+        }
+    }
+    return issues;
+}
+export function buildSpecCoverageSummary(documents, references) {
+    const baseCoverage = buildCoverageSummary(documents.filter(isFeatureSpec), references);
+    const modelRefs = references.filter((ref) => ref.kind === "model");
+    const modelItems = documents.flatMap((doc) => doc.kind === "model" ? doc.modelItems.map((modelItem) => ({ doc, modelItem })) : []);
+    return {
+        ...baseCoverage,
+        modelCoverage: modelItems.map(({ doc, modelItem }) => ({
+            id: modelItem.id,
+            title: modelItem.title,
+            filePath: doc.filePath,
+            line: modelItem.line,
+            references: modelRefs.filter((ref) => ref.id === modelItem.id),
+            covered: modelRefs.some((ref) => ref.id === modelItem.id),
+        })),
+        orphanModelReferences: modelRefs.filter((ref) => !modelItems.some(({ modelItem }) => modelItem.id === ref.id)),
+    };
+}
+export async function checkSpecDocuments(options) {
+    const documents = await loadSpecDocuments(options.specs);
+    const references = options.tests?.length ? await collectSpecTestReferences(options.tests) : [];
+    const coverage = options.tests?.length ? buildSpecCoverageSummary(documents, references) : undefined;
+    const validationIssues = [...documents.flatMap(validateSpecDocument), ...validateSpecGraph(documents)];
+    const coverageIssues = coverage
+        ? [...validateCoverage(coverage, options), ...validateModelCoverage(coverage, options.requireModelCoverage)]
+        : [];
+    const models = documents.filter(isModelSpec);
+    const features = documents.filter(isFeatureSpec);
+    const stacks = documents.filter(isStackSpec);
+    const designs = documents.filter(isDesignSpec);
+    return {
+        documents,
+        models,
+        features,
+        stacks,
+        designs,
+        specs: features,
+        validationIssues,
+        coverage,
+        coverageIssues,
+        ok: ![...validationIssues, ...coverageIssues].some((issue) => issue.severity === "error"),
+    };
+}
+function validateModelCoverage(coverage, required = false) {
+    const issues = [];
+    if (required) {
+        for (const item of coverage.modelCoverage?.filter((item) => !item.covered) ?? []) {
+            issues.push({
+                code: "missing-model-coverage",
+                severity: "error",
+                message: `Model item "${item.id}" has no matching test reference.`,
+                filePath: item.filePath,
+                line: item.line,
+            });
+        }
+    }
+    for (const ref of coverage.orphanModelReferences ?? []) {
+        issues.push({
+            code: "orphan-model-reference",
+            severity: "error",
+            message: `Test references unknown model item "${ref.id}".`,
+            filePath: ref.filePath,
+            line: ref.line,
+        });
+    }
+    return issues;
+}
+function parseBase(source) {
+    const normalized = source.replace(/\r\n/g, "\n");
+    if (!normalized.startsWith("---\n")) {
+        throw new Error("Spec document must start with frontmatter delimited by ---. ");
+    }
+    const endIndex = normalized.indexOf("\n---\n", 4);
+    if (endIndex === -1) {
+        throw new Error("Spec document frontmatter must end with a second --- delimiter.");
+    }
+    const frontmatter = parseFrontmatter(normalized.slice(4, endIndex));
+    if (!frontmatter.id || !frontmatter.title) {
+        throw new Error("Spec document frontmatter must contain id and title.");
+    }
+    const body = normalized.slice(endIndex + 5);
+    const lines = body.split("\n");
+    const bodyStartLine = normalized.slice(0, endIndex + 5).split("\n").length;
+    return {
+        frontmatter,
+        lines,
+        bodyStartLine,
+        title: lines
+            .find((line) => line.startsWith("# "))
+            ?.replace(/^#\s+/, "")
+            .trim() ?? frontmatter.title,
+        purpose: sectionText(lines, "Purpose").trim(),
+    };
+}
+function parseFrontmatter(source) {
+    const data = {};
+    for (const line of source.split("\n")) {
+        const match = line.match(/^([A-Za-z][A-Za-z0-9_-]*):\s*(.*)$/);
+        if (match) {
+            data[match[1]] = match[2]
+                .replace(/^[']|[']$/g, "")
+                .replace(/^[\"]|[\"]$/g, "")
+                .trim();
+        }
+    }
+    return data;
+}
+function parseModelItems(lines, bodyStartLine) {
+    const bounds = sectionBounds(lines, "Model");
+    if (!bounds)
+        return [];
+    const items = [];
+    for (let i = bounds.start; i < bounds.end; i += 1) {
+        const match = lines[i].match(/^###\s+([A-Z][A-Z0-9]*(?:-[A-Z0-9]+)*-M\d{3}):\s+(.+)$/);
+        if (match) {
+            items.push({ id: match[1], title: match[2].trim(), body: "", line: bodyStartLine + i });
+        }
+    }
+    return items;
+}
+function parseRules(lines, bodyStartLine) {
+    const bounds = sectionBounds(lines, "Rules");
+    if (!bounds)
+        return [];
+    return lines.slice(bounds.start, bounds.end).flatMap((line, index) => {
+        const match = line.match(/^\s*-\s+([A-Z][A-Z0-9]*(?:-[A-Z0-9]+)*-R\d{3}):\s+(.+)$/);
+        return match
+            ? [
+                {
+                    id: match[1],
+                    text: match[2].trim(),
+                    strength: "unspecified",
+                    line: bodyStartLine + bounds.start + index,
+                },
+            ]
+            : [];
+    });
+}
+function sectionBounds(lines, heading) {
+    const start = lines.findIndex((line) => line.trim() === `## ${heading}`);
+    if (start === -1)
+        return null;
+    let end = lines.length;
+    for (let i = start + 1; i < lines.length; i += 1) {
+        if (/^##\s+/.test(lines[i])) {
+            end = i;
+            break;
+        }
+    }
+    return { start: start + 1, end };
+}
+function sectionText(lines, heading) {
+    const bounds = sectionBounds(lines, heading);
+    return bounds ? lines.slice(bounds.start, bounds.end).join("\n") : "";
+}
+function validateCommonSpec(spec, issues) {
+    if (!spec.purpose) {
+        issues.push(issue(spec, "missing-purpose", "error", "Spec document must include a non-empty ## Purpose section."));
+    }
+}
+function issue(spec, code, severity, message, line) {
+    return { code, severity, message, filePath: spec.filePath, line };
+}
+function referencedModelIds(spec) {
+    const models = typeof spec.frontmatter.models === "string"
+        ? spec.frontmatter.models.split(",")
+        : spec.frontmatter.models ?? [];
+    return [spec.frontmatter.model, ...models]
+        .map((model) => model?.trim())
+        .filter((model) => Boolean(model));
+}
+function kindFromPath(filePath) {
+    if (filePath.endsWith(".model.md"))
+        return "model";
+    if (filePath.endsWith(".stack.md"))
+        return "stack";
+    if (filePath.endsWith(".design.md"))
+        return "design";
+    return "feature";
+}
+function isModelSpec(doc) {
+    return doc.kind === "model";
+}
+function isFeatureSpec(doc) {
+    return doc.kind === "feature" || doc.kind === undefined;
+}
+function isStackSpec(doc) {
+    return doc.kind === "stack";
+}
+function isDesignSpec(doc) {
+    return doc.kind === "design";
+}
+function isModelReferencingSpec(doc) {
+    return isFeatureSpec(doc) || isDesignSpec(doc);
+}
+function documentIds(doc) {
+    return [
+        { id: doc.frontmatter.id, filePath: doc.filePath },
+        ...doc.rules.map((rule) => ({ id: rule.id, filePath: doc.filePath, line: rule.line })),
+        ...(doc.kind === "model"
+            ? doc.modelItems.map((item) => ({ id: item.id, filePath: doc.filePath, line: item.line }))
+            : isFeatureSpec(doc)
+                ? doc.scenarios.map((scenario) => ({
+                    id: scenario.id,
+                    filePath: doc.filePath,
+                    line: scenario.line,
+                }))
+                : []),
+    ];
+}
+function lineForOffset(lines, offset) {
+    let consumed = 0;
+    for (const [index, line] of lines.entries()) {
+        consumed += line.length + 1;
+        if (consumed > offset)
+            return index + 1;
+    }
+    return lines.length;
+}
+function dedupe(refs) {
+    const seen = new Set();
+    return refs.filter((ref) => {
+        const key = `${ref.kind}:${ref.id}:${ref.filePath}:${ref.line}:${ref.source}`;
+        if (seen.has(key))
+            return false;
+        seen.add(key);
+        return true;
+    });
+}
+//# sourceMappingURL=specDocuments.js.map

package/dist/specDocuments.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,142 @@
+/** Shared frontmatter fields supported by all spec documents. */
+export type SpecFrontmatter = {
+    id: string;
+    title: string;
+    status?: "draft" | "active" | "deprecated";
+    owner?: string;
+};
+/** Frontmatter fields supported by documents that may reference models. */
+export type ModelReferenceFrontmatter = SpecFrontmatter & {
+    model?: string;
+    models?: string[] | string;
+};
+/** Frontmatter fields supported by `*.feature.md` files. */
+export type FeatureFrontmatter = ModelReferenceFrontmatter;
+/** Frontmatter fields supported by `*.design.md` files. */
+export type DesignFrontmatter = ModelReferenceFrontmatter;
+/** Parsed contents of one `*.model.md` file. */
+export type ModelSpec = {
+    kind: "model";
+    filePath: string;
+    frontmatter: SpecFrontmatter;
+    title: string;
+    purpose: string;
+    modelItems: ModelItem[];
+    rules: FeatureRule[];
+    source: string;
+};
+/** Parsed contents of one `*.feature.md` file. */
+export type FeatureSpec = {
+    kind?: "feature";
+    filePath: string;
+    frontmatter: FeatureFrontmatter;
+    title: string;
+    purpose: string;
+    rules: FeatureRule[];
+    scenarios: FeatureScenario[];
+    source: string;
+};
+/** Parsed contents of one `*.stack.md` file. */
+export type StackSpec = {
+    kind: "stack";
+    filePath: string;
+    frontmatter: SpecFrontmatter;
+    title: string;
+    purpose: string;
+    stack: string;
+    context: string;
+    rationale: string;
+    consequences: string;
+    rules: FeatureRule[];
+    source: string;
+};
+/** Parsed contents of one `*.design.md` file. */
+export type DesignSpec = {
+    kind: "design";
+    filePath: string;
+    frontmatter: DesignFrontmatter;
+    title: string;
+    purpose: string;
+    design: string;
+    principles: string;
+    layout: string;
+    interaction: string;
+    visualStyle: string;
+    rules: FeatureRule[];
+    source: string;
+};
+/** Any parsed spec document. */
+export type SpecDocument = ModelSpec | FeatureSpec | StackSpec | DesignSpec;
+/** A model concept declared in the `## Model` section. */
+export type ModelItem = {
+    id: string;
+    title: string;
+    body: string;
+    line: number;
+};
+/** A rule declared in the `## Rules` section. */
+export type FeatureRule = {
+    id: string;
+    text: string;
+    keyword?: RuleKeyword;
+    strength: "required" | "recommended" | "optional" | "unspecified";
+    line: number;
+};
+/** A concrete example declared in the `## Scenarios` section. */
+export type FeatureScenario = {
+    id: string;
+    title: string;
+    line: number;
+    steps: FeatureStep[];
+};
+/** A single Given / When / Then style step inside a scenario. */
+export type FeatureStep = {
+    keyword: StepKeyword;
+    text: string;
+    line: number;
+};
+export type RuleKeyword = "MUST" | "MUST NOT" | "SHOULD" | "SHOULD NOT" | "MAY" | "OPTIONAL";
+export type StepKeyword = "Given" | "When" | "Then" | "And" | "But";
+/** Validation problem found in a spec, test reference, or report input. */
+export type ValidationIssue = {
+    code: string;
+    severity: "error" | "warning";
+    message: string;
+    filePath?: string;
+    line?: number;
+};
+/** A model item, rule, or scenario ID found in executable tests. */
+export type TestReference = {
+    id: string;
+    filePath: string;
+    line: number;
+    kind: "model" | "rule" | "scenario";
+    source: "title" | "tag" | "covers" | "annotation" | "free-text";
+};
+/** Coverage state for one expected model item, rule, or scenario. */
+export type CoverageItem = {
+    id: string;
+    title?: string;
+    filePath?: string;
+    line?: number;
+    covered: boolean;
+    references: TestReference[];
+};
+/** Complete test coverage mapping for a set of spec documents. */
+export type CoverageSummary = {
+    modelCoverage?: CoverageItem[];
+    ruleCoverage: CoverageItem[];
+    scenarioCoverage: CoverageItem[];
+    orphanModelReferences?: TestReference[];
+    orphanRuleReferences: TestReference[];
+    orphanScenarioReferences: TestReference[];
+};
+/** Screenshot evidence associated with an exact spec line. */
+export type SpecScreenshot = {
+    specPath: string;
+    line: number;
+    path: string;
+    title?: string;
+    testPath?: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@anselmdk/feature-spec-md",
-  "version": "0.1.0",
-  "description": "Markdown feature specs with rule/scenario IDs, validation, coverage checks, and generated reports.",
+  "version": "0.1.1-rc.1",
+  "description": "Markdown feature specs with model, rule, and scenario IDs, validation, coverage checks, and generated reports.",
   "type": "module",
   "bin": {
     "feature-spec-md": "./dist/cli.js"
@@ -10,6 +10,14 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./specDocuments": {
+      "types": "./dist/specDocuments.d.ts",
+      "import": "./dist/specDocuments.js"
+    },
+    "./playwright": {
+      "types": "./dist/playwright.d.ts",
+      "import": "./dist/playwright.js"
     }
   },
   "files": [
@@ -27,9 +35,15 @@
     "build": "tsc -p tsconfig.build.json",
     "prepare": "npm run build",
     "dev": "tsx src/cli.ts",
-    "check:example": "tsx src/cli.ts check --specs examples/**/*.feature.md --tests tests/**/*.test.ts --require-scenario-coverage=false",
+    "spec": "tsx src/cli.ts check",
+    "spec:init": "tsx src/cli.ts init",
+    "spec:report": "tsx src/cli.ts report",
+    "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",
-    "test": "tsx --test tests/**/*.test.ts",
+    "test": "npm run test:unit && npm run test:playwright",
+    "test:unit": "tsx --test tests/**/*.test.ts",
+    "test:playwright": "playwright install chromium && playwright test",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "verify": "npm run typecheck && npm test && npm run build && npm run check:example"
   },
@@ -43,7 +57,9 @@
   ],
   "license": "MIT",
   "devDependencies": {
+    "@playwright/test": "^1.60.0",
     "@types/node": "^25.3.2",
+    "prettier": "^3.8.4",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"
   }