@event4u/agent-config 14.7.0 → 14.9.0

package/src/scripts/adr/regenerate_index.ts

@@ -16,13 +16,10 @@ import * as fs from 'node:fs';
 import * as path from 'node:path';
 import process from 'node:process';
 import { fileURLToPath, pathToFileURL } from 'node:url';
+import { readAdrAxisCells, readAdrFrontmatterScalars } from '../_lib/adr_frontmatter.js';
 
 // ^ADR-(\d{3})-([a-z0-9-]+)\.md$
 const NAMED = /^ADR-(\d{3})-([a-z0-9-]+)\.md$/;
-// ^---\n(.*?)\n---  (DOTALL)
-const FM = /^---\n([\s\S]*?)\n---/;
-// ^([a-z_]+):\s*(.+?)\s*$  (MULTILINE)
-const FIELD = /^([a-z_]+):[ \t]*(.+?)[ \t]*$/gm;
 /**
  * The index used to render `| # | Title | Status | Date | Supersedes |`, which
  * is forward-only: a dead ADR showed `superseded | —` and the reader learned it
@@ -32,8 +29,8 @@ const FIELD = /^([a-z_]+):[ \t]*(.+?)[ \t]*$/gm;
  * amendments from one never touched.
  */
 const HEAD =
-    '| # | Title | Status | Date | Supersedes | Superseded by | Amended by |\n' +
-    '|---|---|---|---|---|---|---|';
+    '| # | Title | Status | Date | Provenance | Evidence | Supersedes | Superseded by | Amended by |\n' +
+    '|---|---|---|---|---|---|---|---|---|';
 
 type Meta = Record<string, string>;
 interface Row extends Meta {
@@ -41,19 +38,6 @@ interface Row extends Meta {
     [k: string]: string;
 }
 
-/** Mirror Python `str.strip(" \"'")` — strip listed chars from both ends. */
-function _stripChars(s: string, chars: string): string {
-    let start = 0;
-    let end = s.length;
-    while (start < end && chars.includes(s[start] as string)) {
-        start += 1;
-    }
-    while (end > start && chars.includes(s[end - 1] as string)) {
-        end -= 1;
-    }
-    return s.slice(start, end);
-}
-
 /** Mirror Python `str.title()`: cap first letter of each alphabetic run, lower the rest. */
 function _title(s: string): string {
     let out = '';
@@ -106,22 +90,18 @@ function _pyPathJoin(d: string, child: string): string {
     return base === '.' ? child : `${base}/${child}`;
 }
 
-/** Mirror `fm(t)` — parse the leading `---` frontmatter block into a dict. */
+/**
+ * Parse the leading `---` frontmatter block into a dict.
+ *
+ * Delegates to the shared reader (`_lib/adr_frontmatter.ts`). This was the
+ * weakest of the three parsers it replaces — a scalar-only regex that matched
+ * neither a key with an empty value nor an indented line, so `provenance:` and
+ * `evidence:` would have read as ABSENT here while the other two readers folded
+ * them into a string. Silently absent on the surface that renders the public
+ * index is the failure mode the extraction exists to prevent.
+ */
 function fm(t: string): Meta {
-    const m = FM.exec(t);
-    if (!m) {
-        return {};
-    }
-    const out: Meta = {};
-    const body = m[1] as string;
-    FIELD.lastIndex = 0;
-    let f: RegExpExecArray | null;
-    while ((f = FIELD.exec(body)) !== null) {
-        const k = f[1] as string;
-        const v = f[2] as string;
-        out[k] = _stripChars(v, ' "\'');
-    }
-    return out;
+    return (readAdrFrontmatterScalars(t) ?? {}) as Meta;
 }
 
 /** `sorted(d.glob("ADR-*.md"))` — flat children matching ADR-*.md, lexically sorted. */
@@ -150,10 +130,16 @@ export function scan(d: string): [Row[], Row[], string[]] {
         if (name === 'INDEX.md') {
             continue;
         }
-        const meta = fm(fs.readFileSync(p, 'utf-8'));
+        const text = fs.readFileSync(p, 'utf-8');
+        const meta = fm(text);
+        // Read apart from `meta` on purpose. `provenance` and `evidence` are
+        // nested, so the scalar reader keeps them out of its map entirely —
+        // spreading `meta` could never produce these two cells, and the axis
+        // reader is where the `discovery`-rides-in-the-grade rule lives.
+        const axes = readAdrAxisCells(text);
         const m = NAMED.exec(name);
         if (!m) {
-            leg.push({ path: name, ...meta });
+            leg.push({ path: name, ...meta, ...axes });
             continue;
         }
         const n = m[1] as string;
@@ -164,7 +150,7 @@ export function scan(d: string): [Row[], Row[], string[]] {
             errs.push(`ADR-${n} duplicate: ${name} and ${seen[n]}`);
         }
         seen[n] = name;
-        num.push({ num: n, slug: m[2] as string, path: name, ...meta });
+        num.push({ num: n, slug: m[2] as string, path: name, ...meta, ...axes });
     }
     const nums = new Set(num.map((r) => r.num as string));
     for (const r of num) {
@@ -192,7 +178,8 @@ export function row(r: Row): string {
     const label = 'num' in r ? `ADR-${r.num}` : (r.path as string).slice(0, -3);
     return (
         `| [${label}](${r.path}) | ${title} | ${r.status ?? '—'} ` +
-        `| ${r.date ?? '—'} | ${r.supersedes ?? '—'} | ${r.superseded_by ?? '—'} ` +
+        `| ${r.date ?? '—'} | ${r.provenance_kind ?? '—'} | ${r.evidence_grade ?? '—'} ` +
+        `| ${r.supersedes ?? '—'} | ${r.superseded_by ?? '—'} ` +
         `| ${r.amended_by ?? '—'} |`
     );
 }