@esneiderbravo/speclaw 0.3.7 → 0.3.9

package/dist/modules/lawbook/spec-items.js

@@ -0,0 +1,168 @@
+import fs from "node:fs";
+import path from "node:path";
+const RE_REQUIREMENT = /^###\s+Requirement:\s*(.+?)\s*$/;
+const RE_ID = /`([a-z]{2,6})~([A-Za-z0-9._-]+)~(\d+)`/;
+const RE_KEYWORD = /^(Status|Needs|Tags|Depends|Covers)\s*:\s*(.+?)\s*$/i;
+const RE_INLINE = /\[@(test|impl)\s+([^\]]+)\]/gi;
+const RE_ID_LOOSE = /\b([a-z]{2,6})~([A-Za-z0-9._-]+)~(\d+)\b/g;
+/** Format a SpecItemId as `type~name~rev`. */
+export function formatItemId(id) {
+    return `${id.artifactType}~${id.name}~${id.revision}`;
+}
+/** Parse a single `type~name~rev` token, or null if malformed. */
+export function parseItemId(text) {
+    const m = /^([a-z]{2,6})~([A-Za-z0-9._-]+)~(\d+)$/.exec(text.trim());
+    if (!m)
+        return null;
+    return { artifactType: m[1], name: m[2], revision: Number(m[3]) };
+}
+function splitList(value) {
+    return value
+        .split(/[, ]+/)
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+function parseIdList(value) {
+    const out = [];
+    for (const m of value.matchAll(RE_ID_LOOSE)) {
+        out.push(`${m[1]}~${m[2]}~${m[3]}`);
+    }
+    return out;
+}
+/**
+ * Parse one markdown spec file into requirement items. Headings without an
+ * inline-code identifier are returned with `id: null` (ignored by coverage).
+ *
+ * @param specPath - Project-relative path of the spec (for reporting).
+ * @param content - Full markdown source.
+ */
+export function parseSpecItems(specPath, content) {
+    const lines = content.split(/\r?\n/);
+    const items = [];
+    let current = null;
+    const flush = () => {
+        if (current)
+            items.push(current);
+        current = null;
+    };
+    for (let i = 0; i < lines.length; i++) {
+        const line = lines[i];
+        const req = RE_REQUIREMENT.exec(line);
+        if (req) {
+            flush();
+            const rest = req[1];
+            const idMatch = RE_ID.exec(rest);
+            let title = rest;
+            let id = null;
+            let idText = null;
+            if (idMatch) {
+                id = {
+                    artifactType: idMatch[1],
+                    name: idMatch[2],
+                    revision: Number(idMatch[3]),
+                };
+                idText = formatItemId(id);
+                title = rest.replace(idMatch[0], "").replace(/\s+/g, " ").trim();
+                // Common forms: "Title `id`" or "`id` Title"
+                title = title.replace(/^[\s—–-]+|[\s—–-]+$/g, "").trim();
+            }
+            current = {
+                id,
+                idText,
+                title,
+                status: "approved",
+                needs: [],
+                tags: [],
+                depends: [],
+                covers: [],
+                inlineLinks: [],
+                specPath,
+                line: i + 1,
+            };
+            continue;
+        }
+        if (!current)
+            continue;
+        // Next ### Requirement: or # heading ends the item body for keyword purposes,
+        // but #### Scenario lines may still carry inline links.
+        if (/^###?\s+/.test(line) && !/^####\s+/.test(line)) {
+            flush();
+            // Re-process this line as a potential new requirement on next iteration
+            // by rewinding — simpler: only #### and body lines belong to current.
+            i--;
+            continue;
+        }
+        const kw = RE_KEYWORD.exec(line);
+        if (kw) {
+            const key = kw[1].toLowerCase();
+            const value = kw[2];
+            if (key === "status")
+                current.status = value.trim().toLowerCase();
+            else if (key === "needs")
+                current.needs = splitList(value).map((s) => s.toLowerCase());
+            else if (key === "tags")
+                current.tags = splitList(value);
+            else if (key === "depends")
+                current.depends = parseIdList(value);
+            else if (key === "covers")
+                current.covers = parseIdList(value);
+            continue;
+        }
+        for (const m of line.matchAll(RE_INLINE)) {
+            current.inlineLinks.push({
+                kind: m[1].toLowerCase(),
+                targetPath: m[2].trim(),
+                line: i + 1,
+            });
+        }
+    }
+    flush();
+    return items;
+}
+/**
+ * Walk `lawbook/specs/**\/spec.md` (and optionally a change's delta specs) and
+ * parse every requirement item.
+ *
+ * @param projectPath - Absolute project root.
+ * @param opts.change - When set, parse only that change's delta specs.
+ */
+export function loadSpecItems(projectPath, opts = {}) {
+    const roots = [];
+    if (opts.change) {
+        roots.push(path.join(projectPath, "lawbook", "changes", opts.change, "specs"));
+    }
+    else {
+        roots.push(path.join(projectPath, "lawbook", "specs"));
+    }
+    const items = [];
+    for (const root of roots) {
+        if (!fs.existsSync(root))
+            continue;
+        for (const file of walkSpecFiles(root)) {
+            const rel = path.relative(projectPath, file).split(path.sep).join("/");
+            const content = fs.readFileSync(file, "utf8");
+            items.push(...parseSpecItems(rel, content));
+        }
+    }
+    return items;
+}
+function* walkSpecFiles(dir) {
+    const stack = [dir];
+    while (stack.length) {
+        const cur = stack.pop();
+        let entries;
+        try {
+            entries = fs.readdirSync(cur, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const e of entries) {
+            const full = path.join(cur, e.name);
+            if (e.isDirectory())
+                stack.push(full);
+            else if (e.isFile() && e.name === "spec.md")
+                yield full;
+        }
+    }
+}

package/dist/shared/exposure.js

@@ -5,7 +5,7 @@ import { readManifest } from "./manifest.js";
 /**
  * Tools omitted when the exposure profile is `minimal`. Kept tools are the
  * discovery + law loop: compass_explore/search/recall, lawbook_validate/sync,
- * law_verify, speclaw_check.
+ * lawbook_coverage, lawbook_drift, law_verify, speclaw_check.
  */
 export const MINIMAL_OMIT = new Set([
     "compass_index",

package/dist/shared/install.js

@@ -94,6 +94,7 @@ export function copyRendered(srcDir, destDir, vars, report, opts) {
  * @param comment - Comment line written above the entry when it is added.
  * @param report - Report mutated in place; the appended entry is recorded under `written`.
  */
+// Covers: req~ai-specs-gitignore~1
 export function ensureGitignore(projectPath, entry, comment, report) {
     const gitignorePath = path.join(projectPath, ".gitignore");
     let content = "";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esneiderbravo/speclaw",
-  "version": "0.3.7",
+  "version": "0.3.9",
   "publishConfig": {
     "access": "public"
   },