usedesign 0.2.0

package/dist/core.d.ts

@@ -0,0 +1,52 @@
+export type Severity = "error" | "warning";
+export declare class Finding {
+    readonly code: string;
+    readonly detail: string;
+    readonly severity: Severity;
+    constructor(code: string, detail: string, severity?: Severity);
+    toString(): string;
+}
+export declare const errors: (findings: Finding[]) => Finding[];
+export declare const warnings: (findings: Finding[]) => Finding[];
+export declare const codesOf: (findings: Finding[]) => string[];
+/** A card's front matter, as parsed. Deliberately loose: the schema is what judges its shape. */
+export type Card = Record<string, any>;
+export interface Config {
+    usedesign_config?: number;
+    cards?: string[];
+    inventory?: string;
+    test_report?: string;
+    code_root?: string;
+    evidence_horizon_days?: number;
+    exclude?: {
+        path?: string;
+        method?: string;
+        reason?: string;
+    }[];
+    [key: string]: unknown;
+}
+/**
+ * Return the parsed YAML front matter, or null if the file has none.
+ *
+ * The delimiter search matches the Python prototype exactly — `\n---` after the opening fence —
+ * because two implementations disagreeing about where a card ends is the same class of defect
+ * this project exists to catch.
+ */
+export declare function frontMatter(path: string): Card | null;
+export declare function loadConfig(path: string): {
+    config: Config;
+    base: string;
+};
+/**
+ * Expand a glob relative to `base`. Supports `*`, `?` and `**`; enough for `cards:` patterns and
+ * small enough to keep the tool dependency-light, which matters for something meant to be run
+ * with `npx` inside somebody else's CI.
+ */
+export declare function expandGlob(base: string, pattern: string): string[];
+/** Every card the config points at, as [id, front matter]. */
+export declare function loadCardFiles(config: Config, base: string): {
+    cards: [string, Card][];
+    findings: Finding[];
+};
+/** Collect `*.op.md` under the given files or directories. */
+export declare function collectCards(paths: string[]): string[];

package/dist/core.js

@@ -0,0 +1,133 @@
+/**
+ * Shared machinery: findings, front matter, config, and the small amount of path globbing the
+ * tool needs. Nothing here decides anything about a card — the rules live in `validate.ts` and
+ * `checks.ts`, so that a change to a rule never hides inside a helper.
+ */
+import { readFileSync, existsSync, readdirSync, statSync } from "node:fs";
+import { dirname, join, resolve, sep } from "node:path";
+import { parse as parseYaml } from "yaml";
+export class Finding {
+    code;
+    detail;
+    severity;
+    constructor(code, detail, severity = "error") {
+        this.code = code;
+        this.detail = detail;
+        this.severity = severity;
+    }
+    toString() {
+        return `${this.code}: ${this.detail}`;
+    }
+}
+export const errors = (findings) => findings.filter((f) => f.severity === "error");
+export const warnings = (findings) => findings.filter((f) => f.severity === "warning");
+export const codesOf = (findings) => [...new Set(findings.map((f) => f.code))].sort();
+/**
+ * Return the parsed YAML front matter, or null if the file has none.
+ *
+ * The delimiter search matches the Python prototype exactly — `\n---` after the opening fence —
+ * because two implementations disagreeing about where a card ends is the same class of defect
+ * this project exists to catch.
+ */
+export function frontMatter(path) {
+    // Line endings and a byte-order mark must never decide whether a card parses. Left alone, a
+    // CRLF file hands the YAML parser a dangling carriage return after the closing fence, and a
+    // card written on Windows fails on a rule that has nothing to do with its content.
+    const text = readFileSync(path, "utf8").replace(/^/, "").replace(/\r\n/g, "\n");
+    if (!text.startsWith("---"))
+        return null;
+    const end = text.indexOf("\n---", 3);
+    if (end === -1)
+        return null;
+    const parsed = parseYaml(text.slice(3, end));
+    return parsed && typeof parsed === "object" ? parsed : null;
+}
+export function loadConfig(path) {
+    const config = parseYaml(readFileSync(path, "utf8"));
+    if (!config || typeof config !== "object" || config.usedesign_config !== 1) {
+        throw new Error(`${path}: not a usedesign config (expected \`usedesign_config: 1\`)`);
+    }
+    return { config, base: dirname(resolve(path)) };
+}
+/** Translate one glob segment into a regular expression. `*` and `?` do not cross a separator. */
+function segmentToRegExp(segment) {
+    const escaped = segment.replace(/[.+^${}()|[\]\\]/g, "\\$&").replace(/\*/g, "[^/\\\\]*").replace(/\?/g, "[^/\\\\]");
+    return new RegExp(`^${escaped}$`);
+}
+/**
+ * Expand a glob relative to `base`. Supports `*`, `?` and `**`; enough for `cards:` patterns and
+ * small enough to keep the tool dependency-light, which matters for something meant to be run
+ * with `npx` inside somebody else's CI.
+ */
+export function expandGlob(base, pattern) {
+    const segments = pattern.split(/[\\/]+/).filter((s) => s.length > 0);
+    let current = [resolve(base)];
+    for (const [index, segment] of segments.entries()) {
+        const last = index === segments.length - 1;
+        const next = [];
+        if (segment === "**") {
+            for (const dir of current) {
+                const stack = [dir];
+                while (stack.length) {
+                    const here = stack.pop();
+                    next.push(here);
+                    if (!existsSync(here))
+                        continue;
+                    for (const entry of readdirSync(here, { withFileTypes: true })) {
+                        if (entry.isDirectory())
+                            stack.push(join(here, entry.name));
+                    }
+                }
+            }
+        }
+        else if (segment === "." || segment === "..") {
+            next.push(...current.map((dir) => resolve(dir, segment)));
+        }
+        else if (!/[*?]/.test(segment)) {
+            next.push(...current.map((dir) => join(dir, segment)));
+        }
+        else {
+            const matcher = segmentToRegExp(segment);
+            for (const dir of current) {
+                if (!existsSync(dir) || !statSync(dir).isDirectory())
+                    continue;
+                for (const entry of readdirSync(dir, { withFileTypes: true })) {
+                    if (matcher.test(entry.name) && (last || entry.isDirectory()))
+                        next.push(join(dir, entry.name));
+                }
+            }
+        }
+        current = [...new Set(next)];
+    }
+    return current.filter((path) => existsSync(path) && statSync(path).isFile()).sort();
+}
+/** Every card the config points at, as [id, front matter]. */
+export function loadCardFiles(config, base) {
+    const findings = [];
+    const files = new Set();
+    for (const pattern of config.cards ?? []) {
+        for (const file of expandGlob(base, pattern))
+            files.add(file);
+    }
+    if (files.size === 0)
+        findings.push(new Finding("no_cards_found", "the `cards` patterns matched nothing"));
+    const cards = [];
+    for (const path of [...files].sort()) {
+        const fm = frontMatter(path);
+        if (fm)
+            cards.push([String(fm["id"] ?? path.split(sep).pop()), fm]);
+    }
+    return { cards, findings };
+}
+/** Collect `*.op.md` under the given files or directories. */
+export function collectCards(paths) {
+    const files = [];
+    for (const path of paths) {
+        if (existsSync(path) && statSync(path).isDirectory())
+            files.push(...expandGlob(path, "**/*.op.md"));
+        else
+            files.push(path);
+    }
+    return [...new Set(files)].sort();
+}
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+/** Library entry point — the same functions the CLI uses, for embedding in another tool. */
+export { Finding, codesOf, errors, warnings, frontMatter, loadConfig, loadCardFiles, expandGlob, collectCards } from "./core.js";
+export type { Card, Config, Severity } from "./core.js";
+export { validate, validateSchema, schemaPathFor, MATURITY } from "./validate.js";
+export { CHECKS, checkRoutes, checkCoverage, checkMaturity, normalise, findCases, evidencePaths } from "./checks.js";
+export type { CheckResult, TestCase } from "./checks.js";
+export { runCardCorpus, runChecksCorpus } from "./conformance.js";

package/dist/index.js

@@ -0,0 +1,6 @@
+/** Library entry point — the same functions the CLI uses, for embedding in another tool. */
+export { Finding, codesOf, errors, warnings, frontMatter, loadConfig, loadCardFiles, expandGlob, collectCards } from "./core.js";
+export { validate, validateSchema, schemaPathFor, MATURITY } from "./validate.js";
+export { CHECKS, checkRoutes, checkCoverage, checkMaturity, normalise, findCases, evidencePaths } from "./checks.js";
+export { runCardCorpus, runChecksCorpus } from "./conformance.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4FAA4F;AAC5F,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEjI,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAClF,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,SAAS,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAErH,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/schema/config.schema.json

@@ -0,0 +1,61 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://github.com/nistoc/usedesign/schema/config.schema.json",
+  "title": "usedesign.config.yaml",
+  "description": "The one configuration file of the project. Everything else is description. Lives at the root of the checked repository.",
+  "type": "object",
+  "required": ["usedesign_config", "cards"],
+  "additionalProperties": false,
+  "properties": {
+    "usedesign_config": { "const": 1 },
+    "cards": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "type": "string" },
+      "description": "Glob patterns locating the operation cards."
+    },
+    "inventory": {
+      "type": "string",
+      "description": "Path to the route inventory (schema/route-inventory.schema.json). Without it, check 1 cannot run and is reported as not run — never as passed."
+    },
+    "code_root": {
+      "type": "string",
+      "description": "Root the `maturity_evidence.implemented` paths are resolved against. Without it, the path part of check 3 is reported as not run — never as passed."
+    },
+    "evidence_horizon_days": {
+      "type": "integer",
+      "minimum": 1,
+      "default": 180,
+      "description": "How long an unverifiable claim (a dated `deployed`) is accepted before it is reported as stale. Any number is wrong for somebody, which is why it is configurable."
+    },
+    "test_report": {
+      "type": "string",
+      "description": "Path to a JUnit XML report from the run being checked. Without it, check 2 cannot confirm that the tests a card names exist and pass, and is reported as not run — never as passed. Freshness is procedural: run the check in the same CI job as the suite. See design/step-coverage.md §6."
+    },
+    "exclude": {
+      "type": "array",
+      "description": "Routes that are deliberately not operations: health probes, metrics, generated documentation UI, static assets.",
+      "items": {
+        "type": "object",
+        "required": ["path", "reason"],
+        "additionalProperties": false,
+        "properties": {
+          "path": {
+            "type": "string",
+            "description": "Glob over the normalised path, e.g. '/health' or '/docs/**'."
+          },
+          "method": {
+            "enum": ["GET", "POST", "PUT", "PATCH", "DELETE", "HEAD", "OPTIONS"],
+            "description": "Optional. Omitted means every method."
+          },
+          "reason": {
+            "type": "string",
+            "minLength": 1,
+            "$comment": "Required, for the same reason a relaxed concurrency policy requires a rationale: an exclusion is a hole in the check, and a hole nobody had to justify is a hole nobody will revisit.",
+            "description": "Why this is not an operation."
+          }
+        }
+      }
+    }
+  }
+}