@nielspeter/eess-md 0.1.0

package/dist/model/rows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rows.d.ts","sourceRoot":"","sources":["../../src/model/rows.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAGxD;;;;;;;GAOG;AACH,MAAM,WAAW,KAAK;IACpB,gCAAgC;IAChC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;IACjC,oFAAoF;IACpF,QAAQ,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IACtC,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,wCAAwC;IACxC,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAA;IACxB,qCAAqC;IACrC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CACxB;AAED,gFAAgF;AAChF,MAAM,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;AAEzD,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC9B,wDAAwD;IACxD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAClC;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAA;CAC7B;AAmBD;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,OAAO,CAAA;AAE1C;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,UAAU,EACf,IAAI,EAAE,eAAe,EACrB,IAAI,GAAE,YAAoB,GACzB,KAAK,EAAE,CAuBT"}

package/dist/model/rows.js

@@ -0,0 +1,42 @@
+import { tableInSection } from './query.js';
+/** Does a table's header contain a column for every required role? */
+function tableHasColumns(table, columns) {
+    return Object.values(columns).every((re) => table.header.some((h) => re.test(h)));
+}
+/** Locate the header index for each role (−1 if absent). */
+function columnIndices(table, columns) {
+    const colIndex = new Map();
+    for (const [role, re] of Object.entries(columns)) {
+        colIndex.set(role, table.header.findIndex((h) => re.test(h)));
+    }
+    return colIndex;
+}
+/**
+ * Extract table rows as first-class `MdRow` elements.
+ *
+ * Finds the tables in the document that sit under the requested section (if
+ * any) and have all the requested columns (`mode` decides all vs. first), then
+ * yields one `MdRow` per body row with its real source line.
+ */
+export function matchTableRows(doc, opts, mode = 'all') {
+    const matching = doc.tables.filter((t) => tableInSection(t, opts.section) && tableHasColumns(t, opts.columns));
+    const tables = mode === 'first' ? matching.slice(0, 1) : matching;
+    return tables.flatMap((table) => {
+        const colIndex = columnIndices(table, opts.columns);
+        return table.rows.map((cells, rowIndex) => {
+            const get = (role) => {
+                const idx = colIndex.get(role);
+                return idx !== undefined && idx >= 0 ? (cells[idx] ?? '') : '';
+            };
+            return {
+                cells,
+                get,
+                rowIndex,
+                line: table.rowLines[rowIndex] ?? table.line,
+                doc,
+                table,
+            };
+        });
+    });
+}
+//# sourceMappingURL=rows.js.map

package/dist/model/rows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rows.js","sourceRoot":"","sources":["../../src/model/rows.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAuC3C,sEAAsE;AACtE,SAAS,eAAe,CAAC,KAAc,EAAE,OAAmB;IAC1D,OAAO,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AACnF,CAAC;AAED,4DAA4D;AAC5D,SAAS,aAAa,CAAC,KAAc,EAAE,OAAmB;IACxD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAA;IAC1C,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACjD,QAAQ,CAAC,GAAG,CACV,IAAI,EACJ,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAC1C,CAAA;IACH,CAAC;IACD,OAAO,QAAQ,CAAA;AACjB,CAAC;AAWD;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAC5B,GAAe,EACf,IAAqB,EACrB,OAAqB,KAAK;IAE1B,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAChC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,eAAe,CAAC,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,CAC3E,CAAA;IACD,MAAM,MAAM,GAAG,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAA;IAEjE,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;QAC9B,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAA;QACnD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE;YACxC,MAAM,GAAG,GAAG,CAAC,IAAY,EAAU,EAAE;gBACnC,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;gBAC9B,OAAO,GAAG,KAAK,SAAS,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;YAChE,CAAC,CAAA;YACD,OAAO;gBACL,KAAK;gBACL,GAAG;gBACH,QAAQ;gBACR,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,IAAI;gBAC5C,GAAG;gBACH,KAAK;aACN,CAAA;QACH,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/model/task-items.d.ts

@@ -0,0 +1,28 @@
+import type { Root } from 'mdast';
+/** A GFM task-list item (`- [ ]` / `- [x]`) within a document. */
+export interface MdTaskItemRef {
+    /** `false` for an open box `- [ ]`, `true` for a checked box `- [x]`. */
+    readonly checked: boolean;
+    /** The item's own text (its first paragraph), trimmed; nested sub-items excluded. */
+    readonly text: string;
+    /** 1-based line of the `- [ ]` in the source document. */
+    readonly line: number;
+}
+/**
+ * Collect GFM task-list items from a document tree.
+ *
+ * mdast supplies for free the false-positive guards a line-regex scanner has to
+ * emulate by hand:
+ *  - a `- [ ]` inside fenced code is part of a `code` node, never a `listItem`,
+ *    so it is naturally excluded;
+ *  - a task item inside a blockquote is a `listItem` under a `blockquote`
+ *    ancestor and is skipped here — a quoted box is not a live ledger entry.
+ *
+ * Only list items with a boolean `checked` are task items; ordinary list items
+ * have `checked: null`. The item's `text` is its first paragraph (its own line),
+ * so a disposition token on the box line is seen but a nested sub-item's text is
+ * not folded in — nested boxes are their own `listItem`s and are yielded
+ * separately.
+ */
+export declare function collectTaskItems(root: Root): MdTaskItemRef[];
+//# sourceMappingURL=task-items.d.ts.map

package/dist/model/task-items.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-items.d.ts","sourceRoot":"","sources":["../../src/model/task-items.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAS,MAAM,OAAO,CAAA;AAExC,kEAAkE;AAClE,MAAM,WAAW,aAAa;IAC5B,yEAAyE;IACzE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,qFAAqF;IACrF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAQD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,aAAa,EAAE,CAoB5D"}

package/dist/model/task-items.js

@@ -0,0 +1,47 @@
+function textOf(node) {
+    if ('value' in node && typeof node.value === 'string')
+        return node.value;
+    if ('children' in node)
+        return node.children.map((c) => textOf(c)).join('');
+    return '';
+}
+/**
+ * Collect GFM task-list items from a document tree.
+ *
+ * mdast supplies for free the false-positive guards a line-regex scanner has to
+ * emulate by hand:
+ *  - a `- [ ]` inside fenced code is part of a `code` node, never a `listItem`,
+ *    so it is naturally excluded;
+ *  - a task item inside a blockquote is a `listItem` under a `blockquote`
+ *    ancestor and is skipped here — a quoted box is not a live ledger entry.
+ *
+ * Only list items with a boolean `checked` are task items; ordinary list items
+ * have `checked: null`. The item's `text` is its first paragraph (its own line),
+ * so a disposition token on the box line is seen but a nested sub-item's text is
+ * not folded in — nested boxes are their own `listItem`s and are yielded
+ * separately.
+ */
+export function collectTaskItems(root) {
+    const out = [];
+    const visit = (node, inBlockquote) => {
+        if (node.type === 'blockquote') {
+            for (const child of node.children)
+                visit(child, true);
+            return;
+        }
+        if (node.type === 'listItem' && typeof node.checked === 'boolean') {
+            if (!inBlockquote) {
+                const firstParagraph = node.children.find((c) => c.type === 'paragraph');
+                const text = (firstParagraph ? textOf(firstParagraph) : textOf(node)).trim();
+                out.push({ checked: node.checked, text, line: node.position?.start.line ?? 0 });
+            }
+        }
+        if ('children' in node) {
+            for (const child of node.children)
+                visit(child, inBlockquote);
+        }
+    };
+    visit(root, false);
+    return out;
+}
+//# sourceMappingURL=task-items.js.map

package/dist/model/task-items.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-items.js","sourceRoot":"","sources":["../../src/model/task-items.ts"],"names":[],"mappings":"AAYA,SAAS,MAAM,CAAC,IAAW;IACzB,IAAI,OAAO,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,KAAK,CAAA;IACxE,IAAI,UAAU,IAAI,IAAI;QAAE,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;IAC3E,OAAO,EAAE,CAAA;AACX,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAU;IACzC,MAAM,GAAG,GAAoB,EAAE,CAAA;IAC/B,MAAM,KAAK,GAAG,CAAC,IAAW,EAAE,YAAqB,EAAQ,EAAE;QACzD,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YAC/B,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ;gBAAE,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;YACrD,OAAM;QACR,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,IAAI,OAAO,IAAI,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YAClE,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,MAAM,cAAc,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAA;gBACxE,MAAM,IAAI,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;gBAC5E,GAAG,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,CAAA;YACjF,CAAC;QACH,CAAC;QACD,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;YACvB,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,QAAQ;gBAAE,KAAK,CAAC,KAAK,EAAE,YAAY,CAAC,CAAA;QAC/D,CAAC;IACH,CAAC,CAAA;IACD,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;IAClB,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/model/violation.d.ts

@@ -0,0 +1,23 @@
+import { type ArchViolation, type ArchFix } from '@nielspeter/eess';
+export type { ArchViolation };
+/**
+ * Build an `ArchViolation` for a markdown-corpus finding. `sourceText` (the
+ * document text) yields a code frame around `line` when provided. `fix` attaches
+ * a deterministic autofix (plan 0066) when the repair is unique.
+ */
+export declare function mdViolation(args: {
+    element: string;
+    file: string;
+    line: number;
+    message: string;
+    sourceText?: string;
+    fix?: ArchFix;
+    context: {
+        rule: string;
+        because?: string;
+        suggestion?: string;
+        ruleId?: string;
+        docs?: string;
+    };
+}): ArchViolation;
+//# sourceMappingURL=violation.d.ts.map

package/dist/model/violation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"violation.d.ts","sourceRoot":"","sources":["../../src/model/violation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,aAAa,EAAE,KAAK,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAKtF,YAAY,EAAE,aAAa,EAAE,CAAA;AAE7B;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE;IAChC,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,GAAG,CAAC,EAAE,OAAO,CAAA;IACb,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAA;QACZ,OAAO,CAAC,EAAE,MAAM,CAAA;QAChB,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAA;CACF,GAAG,aAAa,CAehB"}

package/dist/model/violation.js

@@ -0,0 +1,22 @@
+import { generateCodeFrame } from '@nielspeter/eess';
+/**
+ * Build an `ArchViolation` for a markdown-corpus finding. `sourceText` (the
+ * document text) yields a code frame around `line` when provided. `fix` attaches
+ * a deterministic autofix (plan 0066) when the repair is unique.
+ */
+export function mdViolation(args) {
+    return {
+        rule: args.context.rule,
+        ruleId: args.context.ruleId,
+        element: args.element,
+        file: args.file,
+        line: args.line,
+        message: args.message,
+        because: args.context.because,
+        suggestion: args.context.suggestion,
+        docs: args.context.docs,
+        fix: args.fix,
+        codeFrame: args.sourceText !== undefined ? generateCodeFrame(args.sourceText, args.line) : undefined,
+    };
+}
+//# sourceMappingURL=violation.js.map

package/dist/model/violation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"violation.js","sourceRoot":"","sources":["../../src/model/violation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAoC,MAAM,kBAAkB,CAAA;AAOtF;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,IAc3B;IACC,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI;QACvB,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;QAC3B,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,OAAO;QAC7B,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU;QACnC,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI;QACvB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,SAAS,EACP,IAAI,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,iBAAiB,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;KAC5F,CAAA;AACH,CAAC"}

package/dist/predicates/document.d.ts

@@ -0,0 +1,8 @@
+import type { Predicate } from '@nielspeter/eess';
+import type { MdDocument } from '../model/document.js';
+export declare function resideInFolder(glob: string): Predicate<MdDocument>;
+export declare function resideInFile(glob: string): Predicate<MdDocument>;
+export declare function haveNameMatching(re: RegExp): Predicate<MdDocument>;
+/** Predicate form of `haveSection` — "documents that have section X". */
+export declare function haveSectionPredicate(name: string | RegExp): Predicate<MdDocument>;
+//# sourceMappingURL=document.d.ts.map

package/dist/predicates/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../../src/predicates/document.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAEjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAA;AAGtD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC,CAGlE;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC,CAGhE;AAED,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC,CAKlE;AAED,yEAAyE;AACzE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,UAAU,CAAC,CAEjF"}

package/dist/predicates/document.js

@@ -0,0 +1,22 @@
+import { basename } from 'node:path';
+import picomatch from 'picomatch';
+import { hasSection } from '../model/query.js';
+export function resideInFolder(glob) {
+    const match = picomatch(glob);
+    return { description: `reside in folder ${glob}`, test: (d) => match(d.relPath) };
+}
+export function resideInFile(glob) {
+    const match = picomatch(glob);
+    return { description: `reside in file ${glob}`, test: (d) => match(d.relPath) };
+}
+export function haveNameMatching(re) {
+    return {
+        description: `have name matching ${String(re)}`,
+        test: (d) => re.test(basename(d.relPath)),
+    };
+}
+/** Predicate form of `haveSection` — "documents that have section X". */
+export function haveSectionPredicate(name) {
+    return { description: `have section "${String(name)}"`, test: (d) => hasSection(d, name) };
+}
+//# sourceMappingURL=document.js.map

package/dist/predicates/document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.js","sourceRoot":"","sources":["../../src/predicates/document.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAEpC,OAAO,SAAS,MAAM,WAAW,CAAA;AAEjC,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE9C,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;IAC7B,OAAO,EAAE,WAAW,EAAE,oBAAoB,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAA;AACnF,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAA;IAC7B,OAAO,EAAE,WAAW,EAAE,kBAAkB,IAAI,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,EAAE,CAAA;AACjF,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,EAAU;IACzC,OAAO;QACL,WAAW,EAAE,sBAAsB,MAAM,CAAC,EAAE,CAAC,EAAE;QAC/C,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;KAC1C,CAAA;AACH,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,oBAAoB,CAAC,IAAqB;IACxD,OAAO,EAAE,WAAW,EAAE,iBAAiB,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,CAAA;AAC5F,CAAC"}

package/dist/rules/adr.d.ts

@@ -0,0 +1,34 @@
+import { type ArchViolation, type PresetBaseOptions } from '@nielspeter/eess';
+import type { Corpus } from '../corpus.js';
+/**
+ * Options for `adrEnforcement` — an OPINIONATED preset implementing the EESS
+ * enforcement-tier model (a `## Enforcement` table with tier + mechanism +
+ * status). Teams whose ADRs differ compose their own gate from the generic
+ * primitives (`haveSection`, `haveTable`, `haveTableRowsSatisfying`, `resolve`).
+ */
+export interface AdrEnforcementOptions extends PresetBaseOptions {
+    /** Glob selecting ADR files. Default `docs/adr/**`. */
+    readonly dir?: string;
+    /** Heading of the enforcement section. Default `/^enforcement$/i`. */
+    readonly section?: string | RegExp;
+    /** Header patterns locating the tier/mechanism/status columns. */
+    readonly columns?: {
+        tier: RegExp;
+        mechanism: RegExp;
+        status: RegExp;
+    };
+    /** Valid tier numbers. Default `[1,2,3,4,5]`. */
+    readonly tiers?: readonly number[];
+    /** Verify cited file paths exist and cited `it('…')` titles resolve. Default `true`. */
+    readonly verifyCitations?: boolean;
+}
+/**
+ * OPINIONATED preset: gate a repo's ADRs on the EESS enforcement-tier model.
+ * Gates on *declaration* — an ADR fails for a missing `## Enforcement` table, a
+ * clause with no valid tier, or (when `verifyCitations`) a citation that doesn't
+ * resolve; a soft-tier clause declared as such passes.
+ *
+ * Emits per-rule ids so `overrides` can downgrade/disable individual checks.
+ */
+export declare function adrEnforcement(corpus: Corpus, options?: AdrEnforcementOptions): ArchViolation[];
+//# sourceMappingURL=adr.d.ts.map

package/dist/rules/adr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adr.d.ts","sourceRoot":"","sources":["../../src/rules/adr.ts"],"names":[],"mappings":"AAEA,OAAO,EAKL,KAAK,aAAa,EAClB,KAAK,iBAAiB,EACvB,MAAM,kBAAkB,CAAA;AACzB,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAW1C;;;;;GAKG;AACH,MAAM,WAAW,qBAAsB,SAAQ,iBAAiB;IAC9D,uDAAuD;IACvD,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,sEAAsE;IACtE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;IAClC,kEAAkE;IAClE,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;IACtE,iDAAiD;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAClC,wFAAwF;IACxF,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAA;CACnC;AAuDD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,qBAA0B,GAClC,aAAa,EAAE,CA4CjB"}

package/dist/rules/adr.js

@@ -0,0 +1,103 @@
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { dispatchRule, finishPreset, validateOverrides, not, } from '@nielspeter/eess';
+import { docs } from '../builders/docs.js';
+import { haveNameMatching } from '../predicates/document.js';
+import { haveTableRowsSatisfying } from '../conditions/table-rows.js';
+// The ADR directory's index/schema doc (README.md, index.md) is not an ADR —
+// exempt it so it isn't required to carry an `## Enforcement` table. the external repo's
+// hand-built adr-enforcement.ts scopes to numbered files for the same reason;
+// excluding by name (not "numbered-only") keeps MADR-style named ADRs in scope.
+const notIndexDoc = not(haveNameMatching(/^(README|index)\.md$/i));
+const RULE_IDS = ['adr/enforcement-declared', 'adr/valid-tiers', 'adr/citations-resolve'];
+const PATH_RE = /`([A-Za-z0-9_./-]+\.[A-Za-z0-9]+)`/g;
+const IT_CITE_RE = /it(?:\.\w+)?\(\s*['"]([^'"]+)['"]/g;
+/** Does `testFile` define a test titled `title`? (Text-level; 0059 upgrades to AST.) */
+function testDefinesIt(testAbs, title) {
+    if (!existsSync(testAbs))
+        return false;
+    const content = readFileSync(testAbs, 'utf8');
+    const esc = title.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    return new RegExp(`it(?:\\.\\w+)?\\(\\s*['"\`]${esc}`).test(content);
+}
+function validateTier(ctx, tiers) {
+    const clause = ctx.cells[0] ?? '';
+    const match = ctx.get('tier').match(/[1-5]/);
+    if (!match || !tiers.has(Number(match[0]))) {
+        return [`clause "${clause}" has no valid tier (1–5): got "${ctx.get('tier')}"`];
+    }
+    return [];
+}
+function validateCitations(ctx, corpus) {
+    const clause = ctx.cells[0] ?? '';
+    const mech = ctx.get('mechanism');
+    const problems = [];
+    const citedPaths = [];
+    for (const m of mech.matchAll(PATH_RE)) {
+        const p = m[1];
+        if (p === undefined)
+            continue;
+        citedPaths.push(p);
+        if (!corpus.fileIndex.has(p)) {
+            problems.push(`clause "${clause}" cites missing file \`${p}\``);
+        }
+    }
+    const testFiles = citedPaths.filter((p) => p.endsWith('.ts'));
+    for (const m of mech.matchAll(IT_CITE_RE)) {
+        const title = m[1];
+        if (title === undefined)
+            continue;
+        const found = testFiles.some((p) => testDefinesIt(join(corpus.root, p), title));
+        if (!found) {
+            problems.push(`clause "${clause}" cites it('${title}') not found in ${testFiles.length ? testFiles.join(', ') : 'any cited test file'}`);
+        }
+    }
+    return problems;
+}
+/**
+ * OPINIONATED preset: gate a repo's ADRs on the EESS enforcement-tier model.
+ * Gates on *declaration* — an ADR fails for a missing `## Enforcement` table, a
+ * clause with no valid tier, or (when `verifyCitations`) a citation that doesn't
+ * resolve; a soft-tier clause declared as such passes.
+ *
+ * Emits per-rule ids so `overrides` can downgrade/disable individual checks.
+ */
+export function adrEnforcement(corpus, options = {}) {
+    const dir = options.dir ?? 'docs/adr/**';
+    const section = options.section ?? /^enforcement$/i;
+    const columns = options.columns ?? {
+        tier: /tier/i,
+        mechanism: /mechanism/i,
+        status: /status/i,
+    };
+    const tiers = new Set(options.tiers ?? [1, 2, 3, 4, 5]);
+    const verify = options.verifyCitations ?? true;
+    validateOverrides(options.overrides, [...RULE_IDS]);
+    const declared = docs(corpus)
+        .that()
+        .resideInFolder(dir)
+        .satisfy(notIndexDoc)
+        .should()
+        .haveTable({ section, columns: [columns.tier, columns.mechanism, columns.status] });
+    const validTiers = docs(corpus)
+        .that()
+        .resideInFolder(dir)
+        .satisfy(notIndexDoc)
+        .should()
+        .satisfy(haveTableRowsSatisfying({ section, columns, row: (ctx) => validateTier(ctx, tiers) }));
+    const violations = [
+        ...dispatchRule(declared, 'adr/enforcement-declared', 'error', options.overrides),
+        ...dispatchRule(validTiers, 'adr/valid-tiers', 'error', options.overrides),
+    ];
+    if (verify) {
+        const citations = docs(corpus)
+            .that()
+            .resideInFolder(dir)
+            .satisfy(notIndexDoc)
+            .should()
+            .satisfy(haveTableRowsSatisfying({ section, columns, row: (ctx) => validateCitations(ctx, corpus) }));
+        violations.push(...dispatchRule(citations, 'adr/citations-resolve', 'error', options.overrides));
+    }
+    return finishPreset(violations, options);
+}
+//# sourceMappingURL=adr.js.map

package/dist/rules/adr.js.map

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

package/dist/rules/ledger.d.ts

@@ -0,0 +1,44 @@
+import { type PresetReportOptions } from '@nielspeter/eess';
+import type { Corpus } from '../corpus.js';
+import type { ArchViolation } from '../model/violation.js';
+/**
+ * `honestyAtClose` — the ledger-reconciliation gate for an engineering corpus.
+ *
+ * The working method's first firm principle: when an item is finished, every
+ * part of it ends as *done*, *done-otherwise*, *deferred to a named home*, or
+ * *dropped on purpose* — and the deferral count is said out loud. "Silence is
+ * not 'nothing deferred.'" A *done*-item that still carries an undisposed open
+ * box has silently lost scope.
+ *
+ * This preset enforces only the mechanically-knowable slice — the *silent* case.
+ * Whether a `deferred→<home>` is *truthful* is Tier-4 judgment for the reviewer.
+ * So it is a necessary-not-sufficient floor (form-gated / content-judgment).
+ *
+ * Three findings: `silent-open-box`, `deferred-none-lie`, `state-folder-mismatch`
+ * (see plan 0068 Phase 3). The GFM task boxes are read from mdast (via
+ * `collectTaskItems`), so a `- [ ]` in fenced code or a blockquote is excluded
+ * for free — no hand-rolled stripping. `deferred: none` summaries and the
+ * `State:` header token are unambiguous prose lines, scanned from the source.
+ */
+export interface HonestyAtCloseOptions extends PresetReportOptions {
+    /**
+     * Path segments that mark a document as *done* (in addition to a terminal
+     * `State:` token in its header). Default: the common terminal folders.
+     */
+    readonly doneFolders?: readonly string[];
+    /** Board/index basenames that are not items and are never scanned. */
+    readonly boardFiles?: readonly string[];
+    /**
+     * When `true`, items close *in place* rather than moving to a done-folder, so
+     * the "a `State: Done` item must sit in a done-folder" half of the placement
+     * check is disabled. Default `false`.
+     */
+    readonly closeInPlace?: boolean;
+}
+/**
+ * Run the honesty-at-close gate over a corpus. Throws `ArchRuleError` on any
+ * finding. Placement is checked on every item; ledger reconciliation only on
+ * done-items (the inverse of the frozen-folder exemption).
+ */
+export declare function honestyAtClose(corpus: Corpus, options?: HonestyAtCloseOptions): ArchViolation[];
+//# sourceMappingURL=ledger.d.ts.map

package/dist/rules/ledger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ledger.d.ts","sourceRoot":"","sources":["../../src/rules/ledger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,mBAAmB,EAAE,MAAM,kBAAkB,CAAA;AACzE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAE1C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAA;AAG1D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;IAChE;;;OAGG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACxC,sEAAsE;IACtE,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IACvC;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;CAChC;AA6ID;;;;GAIG;AACH,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,qBAA0B,GAClC,aAAa,EAAE,CAkBjB"}

package/dist/rules/ledger.js

@@ -0,0 +1,119 @@
+import { finishPreset } from '@nielspeter/eess';
+import { collectTaskItems } from '../model/task-items.js';
+const DEFAULT_DONE_FOLDERS = ['/completed/', '/fixed/', '/wont-do/', '/delivered/', '/archived/'];
+const DEFAULT_BOARD_FILES = ['ROADMAP.md', 'BUGS.md', 'REFINEMENT.md', 'SUPPORT.md', 'README.md'];
+// A terminal `State:` token in the header — `**State:** Done` / `Won't-do`.
+const DONE_STATE_RE = /^\s*(?:[-*]\s+)?(?:\*\*)?State:?(?:\*\*)?\s*(Done|Won't-do)\b/im;
+// The full neutral State enum on one line (for state↔folder coherence).
+const STATE_TOKEN_LINE_RE = /^\s*(?:[-*]\s+)?(?:\*\*)?State:?(?:\*\*)?\s*(Draft|Ready|Open|Done|Won't-do)\b/i;
+const TERMINAL_STATES = new Set(['Done', "Won't-do"]);
+// Any one of these on a box's line marks it *disposed* (not silent). Tokens are
+// the canonical hyphenated enum, word-bounded — so prose like "…the connection
+// dropped in prod" does not falsely exempt a silent box. `deferred` must name a
+// home other than "none".
+const DISPOSITION_RE = /(\bdone-otherwise\b|\bdropped-on-purpose\b|\bvalidation-owed\b|deferred\s*(?:→|->|:|\bto\b)\s*(?!none\b)\S)/i;
+const DEFERRED_DISPOSITION_RE = /deferred\s*(?:→|->|:|\bto\b)\s*(?!none\b)\S/i;
+// A summary line asserting the deferral count out loud, e.g. `Deferred: none`.
+const DEFERRED_SUMMARY_RE = /^[^\S\n]*(?:[-*+][^\S\n]+)?(?:\*\*)?deferred:?(?:\*\*)?[^\S\n]*(.+?)[^\S\n]*$/im;
+const FENCE_RE = /(```|~~~)[\s\S]*?\1/g;
+// Blank out fenced code in place (preserve line numbers) so an illustrative
+// `**State:** Done` or `Deferred: none` in an example never misclassifies.
+function stripFencedCode(s) {
+    return s.replace(FENCE_RE, (m) => '\n'.repeat((m.match(/\n/g) ?? []).length));
+}
+function headerRegion(text) {
+    return stripFencedCode(text).split(/^##\s/m)[0] ?? '';
+}
+function isDoneItem(doc, doneFolders) {
+    if (doneFolders.some((seg) => `/${doc.relPath}`.includes(seg)))
+        return true;
+    return DONE_STATE_RE.test(headerRegion(doc.text));
+}
+const v = (rule, doc, line, message, because) => ({
+    rule,
+    element: doc.relPath,
+    file: doc.file,
+    line,
+    message,
+    because,
+});
+/** State↔folder coherence — the two mechanically-knowable placement defects. */
+function placementViolation(doc, inDoneFolder, closeInPlace) {
+    const lines = stripFencedCode(doc.text).split('\n');
+    let stateLine = 0;
+    let state = '';
+    for (let i = 0; i < lines.length; i++) {
+        if (/^##\s/.test(lines[i] ?? ''))
+            break; // header region only
+        const m = STATE_TOKEN_LINE_RE.exec(lines[i] ?? '');
+        if (m) {
+            stateLine = i + 1;
+            state = m[1] ?? '';
+            break;
+        }
+    }
+    if (!stateLine)
+        return null; // no neutral State token → nothing to check
+    const terminal = TERMINAL_STATES.has(state);
+    if (inDoneFolder && !terminal) {
+        return v('ledger/state-folder-mismatch', doc, stateLine, `State: ${state} but filed in a done-folder — move it back to the active lane or close it out.`, 'a done-folder item marked as not-done is a silent placement corruption');
+    }
+    if (!inDoneFolder && terminal && !closeInPlace) {
+        return v('ledger/state-folder-mismatch', doc, stateLine, `State: ${state} but not in a done-folder — the move-to-done was never made (orphaned close).`, 'a done item left in an active lane is an orphaned post-merge move');
+    }
+    return null;
+}
+/** Ledger reconciliation of one done-item: unchecked boxes + the `none`-summary lie. */
+function ledgerViolations(doc) {
+    const out = [];
+    let anyDeferredDisposedBox = false;
+    for (const box of collectTaskItems(doc.root)) {
+        if (box.checked)
+            continue; // only open boxes are live ledger entries
+        if (DEFERRED_DISPOSITION_RE.test(box.text))
+            anyDeferredDisposedBox = true;
+        if (!DISPOSITION_RE.test(box.text)) {
+            out.push(v('ledger/silent-open-box', doc, box.line, 'unchecked box with no disposition (done-otherwise / deferred→<home> / dropped-on-purpose / validation-owed)', "silence is not 'nothing deferred' — a done-item with a silently-open box has lost scope"));
+        }
+    }
+    // A `none` deferral-summary while a box carries a defer disposition — the
+    // summary contradicts the boxes. (Absence of a summary is deliberately NOT gated.)
+    if (anyDeferredDisposedBox) {
+        const lines = stripFencedCode(doc.text).split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            const raw = lines[i] ?? '';
+            if (/^\s*>/.test(raw))
+                continue;
+            const sm = raw.match(DEFERRED_SUMMARY_RE);
+            if (sm && /^none\b/i.test((sm[1] ?? '').trim())) {
+                out.push(v('ledger/deferred-none-lie', doc, i + 1, "'deferred: none' contradicts a box disposed as deferred→<home>", 'the out-loud summary must reconcile with the box states, not override them'));
+                break;
+            }
+        }
+    }
+    return out;
+}
+/**
+ * Run the honesty-at-close gate over a corpus. Throws `ArchRuleError` on any
+ * finding. Placement is checked on every item; ledger reconciliation only on
+ * done-items (the inverse of the frozen-folder exemption).
+ */
+export function honestyAtClose(corpus, options = {}) {
+    const doneFolders = options.doneFolders ?? DEFAULT_DONE_FOLDERS;
+    const boardFiles = new Set(options.boardFiles ?? DEFAULT_BOARD_FILES);
+    const closeInPlace = options.closeInPlace ?? false;
+    const violations = [];
+    for (const doc of corpus.documents()) {
+        const base = doc.relPath.split('/').pop() ?? doc.relPath;
+        if (boardFiles.has(base))
+            continue;
+        const inDoneFolder = doneFolders.some((seg) => `/${doc.relPath}`.includes(seg));
+        const placement = placementViolation(doc, inDoneFolder, closeInPlace);
+        if (placement)
+            violations.push(placement);
+        if (isDoneItem(doc, doneFolders))
+            violations.push(...ledgerViolations(doc));
+    }
+    return finishPreset(violations, options);
+}
+//# sourceMappingURL=ledger.js.map

package/dist/rules/ledger.js.map

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

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@nielspeter/eess-md",
+  "version": "0.1.0",
+  "description": "Architecture testing for a Markdown corpus — the Markdown dialect of the eess family. Links resolve, code pointers ground, ADRs declare enforcement.",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./rules/adr": {
+      "types": "./dist/rules/adr.d.ts",
+      "import": "./dist/rules/adr.js"
+    },
+    "./rules/ledger": {
+      "types": "./dist/rules/ledger.d.ts",
+      "import": "./dist/rules/ledger.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=24.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/nielspeter/eess.git",
+    "directory": "packages/md"
+  },
+  "author": "Niels Peter",
+  "license": "MIT",
+  "scripts": {
+    "prepublishOnly": "npm run build",
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "markdown",
+    "architecture",
+    "testing",
+    "adr",
+    "documentation",
+    "eess"
+  ],
+  "dependencies": {
+    "@nielspeter/eess": "^0.1.0",
+    "mdast-util-from-markdown": "^2.0.3",
+    "mdast-util-gfm": "^3.1.0",
+    "micromark-extension-gfm": "^3.0.0",
+    "picomatch": "^4.0.4"
+  },
+  "devDependencies": {
+    "@types/mdast": "^4.0.4"
+  }
+}