@rsaglobaltech/specgate 0.24.0 → 0.26.0

package/dist/scripts/lib/change-impact.js

@@ -0,0 +1,156 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requirementImpact = requirementImpact;
+exports.changedBy = changedBy;
+exports.impactOf = impactOf;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const live_detail_1 = require("./live-detail");
+const ChangeWorkspace_1 = require("../../packages/core/src/infrastructure/ChangeWorkspace");
+const HEADING = /^(?:###\s+Requirement:|#{2,3})\s+(REQ-\d+)\b/;
+function specFiles(projectDir) {
+    const out = [];
+    const spec = path.join(projectDir, "spec.md");
+    if (fs.existsSync(spec))
+        out.push(spec);
+    const walk = (dir) => {
+        let entries = [];
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            const full = path.join(dir, e.name);
+            if (e.isDirectory() && e.name !== "archive")
+                walk(full);
+            else if (e.name === "spec.md")
+                out.push(full);
+        }
+    };
+    walk(path.join(projectDir, "docs", "specs"));
+    return out;
+}
+/** The requirements whose statement or scenarios name `id`, other than itself. */
+function namedBy(projectDir, id) {
+    const found = new Set();
+    const named = new RegExp(`(^|[^\\w-])${id}(?!\\d)`);
+    for (const file of specFiles(projectDir)) {
+        let current = null;
+        for (const line of fs.readFileSync(file, "utf8").split(/\r?\n/)) {
+            const h = HEADING.exec(line);
+            if (h) {
+                current = h[1];
+                continue;
+            }
+            if (current && current !== id && !line.includes("specgate:trace") && named.test(line)) {
+                found.add(current);
+            }
+        }
+    }
+    return [...found].sort();
+}
+/** The files the commits naming `id` changed, outside the specification. */
+function filesOf(projectDir, id) {
+    const r = (0, node_child_process_1.spawnSync)("git", ["log", "-E", `--grep=${id}([^0-9]|$)`, "--name-only", "--format="], {
+        cwd: projectDir,
+        encoding: "utf8",
+        maxBuffer: 64 * 1024 * 1024,
+    });
+    if (r.status !== 0)
+        return [];
+    return [
+        ...new Set(r.stdout
+            .split("\n")
+            .map((l) => l.trim())
+            .filter(Boolean)
+            .filter((f) => !/^(docs\/specs\/|features\/|spec\.md$)/.test(f))),
+    ].sort();
+}
+/** Feature files named after the requirement, as `archive` writes them: features/<area>/<REQ>.feature. */
+function featuresNamed(projectDir, id) {
+    const out = [];
+    const root = path.join(projectDir, "features");
+    let areas = [];
+    try {
+        areas = fs.readdirSync(root, { withFileTypes: true });
+    }
+    catch {
+        return out;
+    }
+    for (const a of areas) {
+        if (a.isDirectory() && fs.existsSync(path.join(root, a.name, `${id}.feature`))) {
+            out.push(`features/${a.name}/${id}.feature`);
+        }
+    }
+    return out;
+}
+function requirementImpact(projectDir, id) {
+    const d = (0, live_detail_1.requirementDetail)(projectDir, id);
+    return {
+        requirement: id,
+        spec: d.source || null,
+        features: [...new Set([...(d.features || []), ...featuresNamed(projectDir, id)])].sort(),
+        tests: d.tests || [],
+        files: filesOf(projectDir, id),
+        namedBy: namedBy(projectDir, id),
+    };
+}
+/** The requirements a change modifies or removes, in id order. */
+function changedBy(projectDir, change) {
+    const ids = new Set();
+    for (const d of (0, ChangeWorkspace_1.listDeltas)(projectDir, change)) {
+        const text = fs.readFileSync(d.file, "utf8");
+        for (const section of text.split(/^## /m)) {
+            if (!/^(MODIFIED|REMOVED|RENAMED) Requirements/.test(section))
+                continue;
+            for (const m of section.matchAll(/^###\s+Requirement:\s+(REQ-\d+)/gm))
+                ids.add(m[1]);
+        }
+    }
+    return [...ids].sort();
+}
+/** The impact of a requirement, or of each requirement a change modifies or removes. */
+function impactOf(projectDir, target) {
+    if (/^REQ-\d+$/.test(target))
+        return [requirementImpact(projectDir, target)];
+    if (!(0, ChangeWorkspace_1.listChangeIds)(projectDir).includes(target))
+        return null;
+    return changedBy(projectDir, target).map((id) => requirementImpact(projectDir, id));
+}
+//# sourceMappingURL=change-impact.js.map

package/dist/scripts/lib/change-impact.js.map

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

package/dist/scripts/lib/change-review.js

@@ -0,0 +1,145 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.approvedOn = approvedOn;
+exports.approvalBlockers = approvalBlockers;
+exports.approveChange = approveChange;
+exports.reviewNotes = reviewNotes;
+exports.noteChange = noteChange;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const Clarification_1 = require("../../packages/core/src/domain/Clarification");
+const DraftCommand_1 = require("../cli/commands/spec/DraftCommand");
+/**
+ * A person's review of a draft change (REQ-206, REQ-207): approving it, which
+ * Build waits for, and asking for a change in their own words.
+ */
+const CHANGES = path.join("docs", "specs", "changes");
+function changeDir(projectDir, id) {
+    return path.join(projectDir, CHANGES, id);
+}
+function read(file) {
+    try {
+        return fs.readFileSync(file, "utf8");
+    }
+    catch {
+        return undefined;
+    }
+}
+/** When a person approved the change, or "" when nobody has. */
+function approvedOn(projectDir, id) {
+    const yaml = read(path.join(changeDir(projectDir, id), "change.yaml")) || "";
+    return (/^approved:\s*(\S+)/m.exec(yaml) || [])[1] || "";
+}
+/** What stops a change from being approved: checklist errors and open questions. */
+function approvalBlockers(projectDir, id) {
+    const out = [];
+    const r = (0, DraftCommand_1.draftReport)(projectDir, id);
+    if ("failure" in r) {
+        out.push({ code: r.failure.code, message: r.failure.message });
+    }
+    else {
+        for (const d of r.report.status) {
+            if (d.severity === "error")
+                out.push({ code: d.code, message: d.message });
+        }
+    }
+    const questions = read(path.join(changeDir(projectDir, id), "questions.md"));
+    for (const q of questions ? (0, Clarification_1.questionTable)(questions) : []) {
+        if (!q.answered && !out.some((b) => b.message.includes(q.id))) {
+            out.push({ code: "approve_question_open", message: `${q.id} is open: ${q.text}` });
+        }
+    }
+    return out;
+}
+/** Record that a person approved the change (REQ-206). */
+function approveChange(projectDir, id, today) {
+    const file = path.join(changeDir(projectDir, id), "change.yaml");
+    if (!fs.existsSync(changeDir(projectDir, id))) {
+        return { ok: false, code: "change_not_found", message: `No open change ${id}.` };
+    }
+    const blockers = approvalBlockers(projectDir, id);
+    if (blockers.length) {
+        return {
+            ok: false,
+            code: "approve_blocked",
+            message: `${id} cannot be approved yet: ${blockers.map((b) => b.message).join("; ")}`,
+            blockers,
+        };
+    }
+    const yaml = read(file) || "";
+    const next = /^approved:/m.test(yaml)
+        ? yaml.replace(/^approved:.*$/m, `approved: ${today}`)
+        : `${yaml.replace(/\n*$/, "\n")}approved: ${today}\n`;
+    fs.writeFileSync(file, next, "utf8");
+    return { ok: true, change: id, approved: today };
+}
+const NOTES_HEADER = "| Date | Requirement | Request |";
+function cell(text) {
+    return String(text).replace(/\s+/g, " ").trim().replace(/\|/g, "\\|");
+}
+/** The change's review notes. */
+function reviewNotes(projectDir, id) {
+    const md = read(path.join(changeDir(projectDir, id), "review.md")) || "";
+    return md
+        .split(/\r?\n/)
+        .filter((l) => /^\|\s*\d{4}-\d{2}-\d{2}\s*\|/.test(l))
+        .map((l) => {
+        const c = l
+            .split(/(?<!\\)\|/)
+            .slice(1, -1)
+            .map((x) => x.trim());
+        return {
+            date: c[0],
+            requirement: c[1] === "—" ? "" : c[1],
+            text: (c[2] || "").replace(/\\\|/g, "|"),
+        };
+    });
+}
+/** Ask the draft for a change in your own words (REQ-207). */
+function noteChange(projectDir, id, text, requirement, today) {
+    if (!fs.existsSync(changeDir(projectDir, id))) {
+        return { ok: false, code: "change_not_found", message: `No open change ${id}.` };
+    }
+    if (!text.trim())
+        return { ok: false, code: "note_empty", message: "The request is empty." };
+    const file = path.join(changeDir(projectDir, id), "review.md");
+    const md = read(file) ||
+        `# Review — ${id}\n\nWhat the person reviewing this draft asked to change.\n\n${NOTES_HEADER}\n|---|---|---|\n`;
+    const row = `| ${today} | ${requirement || "—"} | ${cell(text)} |`;
+    fs.writeFileSync(file, `${md.replace(/\n*$/, "\n")}${row}\n`, "utf8");
+    return { ok: true, change: id, notes: reviewNotes(projectDir, id).length };
+}
+//# sourceMappingURL=change-review.js.map

package/dist/scripts/lib/change-review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-review.js","sourceRoot":"","sources":["../../../scripts/lib/change-review.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAyBA,gCAGC;AAQD,4CAiBC;AAOD,sCAoBC;AAeD,kCAgBC;AAGD,gCAkBC;AApID,4CAA8B;AAC9B,gDAAkC;AAClC,gFAA6E;AAC7E,oEAAgE;AAEhE;;;GAGG;AAEH,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;AAEtD,SAAS,SAAS,CAAC,UAAkB,EAAE,EAAU;IAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,IAAI,CAAC,IAAY;IACxB,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,gEAAgE;AAChE,SAAgB,UAAU,CAAC,UAAkB,EAAE,EAAU;IACvD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,CAAC,EAAE,aAAa,CAAC,CAAC,IAAI,EAAE,CAAC;IAC7E,OAAO,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AAC3D,CAAC;AAOD,oFAAoF;AACpF,SAAgB,gBAAgB,CAAC,UAAkB,EAAE,EAAU;IAC7D,MAAM,GAAG,GAAc,EAAE,CAAC;IAC1B,MAAM,CAAC,GAAG,IAAA,0BAAW,EAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACtC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QACnB,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;SAAM,CAAC;QACN,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YAChC,IAAI,CAAC,CAAC,QAAQ,KAAK,OAAO;gBAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC;IAC7E,KAAK,MAAM,CAAC,IAAI,SAAS,CAAC,CAAC,CAAC,IAAA,6BAAa,EAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC1D,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;YAC9D,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,GAAG,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAMD,0DAA0D;AAC1D,SAAgB,aAAa,CAAC,UAAkB,EAAE,EAAU,EAAE,KAAa;IACzE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,CAAC,EAAE,aAAa,CAAC,CAAC;IACjE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;QAC9C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,CAAC;IACnF,CAAC;IACD,MAAM,QAAQ,GAAG,gBAAgB,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAClD,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QACpB,OAAO;YACL,EAAE,EAAE,KAAK;YACT,IAAI,EAAE,iBAAiB;YACvB,OAAO,EAAE,GAAG,EAAE,4BAA4B,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YACrF,QAAQ;SACT,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IAC9B,MAAM,IAAI,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;QACnC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,aAAa,KAAK,EAAE,CAAC;QACtD,CAAC,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,aAAa,KAAK,IAAI,CAAC;IACxD,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACrC,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AACnD,CAAC;AAQD,MAAM,YAAY,GAAG,kCAAkC,CAAC;AAExD,SAAS,IAAI,CAAC,IAAY;IACxB,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AACxE,CAAC;AAED,iCAAiC;AACjC,SAAgB,WAAW,CAAC,UAAkB,EAAE,EAAU;IACxD,MAAM,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC,IAAI,EAAE,CAAC;IACzE,OAAO,EAAE;SACN,KAAK,CAAC,OAAO,CAAC;SACd,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,8BAA8B,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;SACrD,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QACT,MAAM,CAAC,GAAG,CAAC;aACR,KAAK,CAAC,WAAW,CAAC;aAClB,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;aACZ,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACxB,OAAO;YACL,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;YACV,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACrC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC;SACzC,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC;AAED,8DAA8D;AAC9D,SAAgB,UAAU,CACxB,UAAkB,EAClB,EAAU,EACV,IAAY,EACZ,WAAmB,EACnB,KAAa;IAEb,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;QAC9C,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,kBAAkB,EAAE,GAAG,EAAE,CAAC;IACnF,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,uBAAuB,EAAE,CAAC;IAC7F,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,EAAE,CAAC,EAAE,WAAW,CAAC,CAAC;IAC/D,MAAM,EAAE,GACN,IAAI,CAAC,IAAI,CAAC;QACV,cAAc,EAAE,gEAAgE,YAAY,mBAAmB,CAAC;IAClH,MAAM,GAAG,GAAG,KAAK,KAAK,MAAM,WAAW,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IACnE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,GAAG,IAAI,EAAE,MAAM,CAAC,CAAC;IACtE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,WAAW,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAC7E,CAAC"}

package/dist/scripts/lib/clarification.js

@@ -0,0 +1,319 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PROJECT = void 0;
+exports.allQuestions = allQuestions;
+exports.waiting = waiting;
+exports.answer = answer;
+exports.reviewed = reviewed;
+exports.definedIn = definedIn;
+exports.setWaiting = setWaiting;
+exports.setStatusIn = setStatusIn;
+exports.ask = ask;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const Clarification_1 = require("../../packages/core/src/domain/Clarification");
+const ChangeWorkspace_1 = require("../../packages/core/src/infrastructure/ChangeWorkspace");
+const live_detail_1 = require("./live-detail");
+const MatrixCommand_1 = require("../cli/commands/spec/MatrixCommand");
+/**
+ * Questions and answers on disk (REQ-187..189): each open change's
+ * `questions.md` and `assumptions.md`, and the project's own
+ * `docs/specs/questions.md` for requirements a capability already defines.
+ */
+/** The change a project-level question belongs to, as `questions` prints it. */
+exports.PROJECT = "project";
+const PROJECT_QUESTIONS = path.join("docs", "specs", "questions.md");
+const PROJECT_ASSUMPTIONS = path.join("docs", "specs", "assumptions.md");
+function changeDir(projectDir, change) {
+    return path.join(projectDir, "docs", "specs", "changes", change);
+}
+function questionsFile(projectDir, change) {
+    return change === exports.PROJECT
+        ? path.join(projectDir, PROJECT_QUESTIONS)
+        : path.join(changeDir(projectDir, change), "questions.md");
+}
+function assumptionsFile(projectDir, change) {
+    return change === exports.PROJECT
+        ? path.join(projectDir, PROJECT_ASSUMPTIONS)
+        : path.join(changeDir(projectDir, change), "assumptions.md");
+}
+function read(file) {
+    try {
+        return fs.readFileSync(file, "utf8");
+    }
+    catch {
+        return undefined;
+    }
+}
+function write(file, text) {
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, text.endsWith("\n") ? text : `${text}\n`, "utf8");
+}
+/** Every question of every open change, and of the project. */
+function allQuestions(projectDir) {
+    const out = [];
+    for (const change of [...(0, ChangeWorkspace_1.listChangeIds)(projectDir), exports.PROJECT]) {
+        const file = questionsFile(projectDir, change);
+        const md = read(file);
+        if (!md)
+            continue;
+        for (const q of (0, Clarification_1.questionTable)(md)) {
+            out.push({ ...q, change, file: path.relative(projectDir, file).split(path.sep).join("/") });
+        }
+    }
+    return out;
+}
+/** What waits for an answer: open questions, and requirements in Needs Clarification no open question names. */
+function waiting(projectDir) {
+    const questions = allQuestions(projectDir).filter((q) => !q.answered);
+    const named = new Set(questions.flatMap((q) => q.blocks));
+    const seen = new Set();
+    const requirements = [];
+    for (const row of (0, live_detail_1.liveMatrix)(projectDir)) {
+        if (row.status !== "Needs Clarification" || named.has(row.requirement))
+            continue;
+        if (seen.has(row.requirement))
+            continue;
+        seen.add(row.requirement);
+        requirements.push({ requirement: row.requirement, title: row.title });
+    }
+    return { questions, requirements };
+}
+/** The changes that have a question with this id. */
+function changesWith(projectDir, id) {
+    return [
+        ...new Set(allQuestions(projectDir)
+            .filter((q) => q.id === id)
+            .map((q) => q.change)),
+    ];
+}
+function pickChange(projectDir, id, change) {
+    const found = changesWith(projectDir, id);
+    if (change) {
+        if (!found.includes(change)) {
+            return {
+                ok: false,
+                code: "question_not_found",
+                message: `${change} has no question ${id}.`,
+                changes: found,
+            };
+        }
+        return change;
+    }
+    if (found.length === 0) {
+        return {
+            ok: false,
+            code: "question_not_found",
+            message: `No open change has a question ${id}.`,
+        };
+    }
+    if (found.length > 1) {
+        return {
+            ok: false,
+            code: "question_ambiguous",
+            message: `${found.length} changes have a question ${id}: ${found.join(", ")}. Say which with --change.`,
+            changes: found,
+        };
+    }
+    return found[0];
+}
+/** Write the answer, add its assumption to review, and say which requirements to revise (REQ-188). */
+function answer(projectDir, id, text, change) {
+    const picked = pickChange(projectDir, id, change);
+    if (typeof picked !== "string")
+        return picked;
+    const qFile = questionsFile(projectDir, picked);
+    const written = (0, Clarification_1.answerQuestion)(read(qFile) || "", id, text);
+    if (!written.ok) {
+        return {
+            ok: false,
+            code: written.code,
+            message: written.code === "answer_deferred"
+                ? `"${text}" puts the decision off; an answer decides. Answer when it is decided.`
+                : `${picked} has no question ${id}.`,
+        };
+    }
+    const aFile = assumptionsFile(projectDir, picked);
+    const added = (0, Clarification_1.addAssumption)(read(aFile), picked, {
+        text,
+        usedIn: written.blocks,
+        why: id,
+    });
+    write(qFile, written.md);
+    write(aFile, added.md);
+    return { ok: true, change: picked, question: id, assumption: added.id, revise: written.blocks };
+}
+/** Mark the question's assumptions reviewed: the spec reflects the answer (REQ-188). */
+function reviewed(projectDir, id, change) {
+    const picked = pickChange(projectDir, id, change);
+    if (typeof picked !== "string")
+        return picked;
+    const aFile = assumptionsFile(projectDir, picked);
+    const r = (0, Clarification_1.reviewAssumptions)(read(aFile) || "", id);
+    if (r.ids.length === 0) {
+        return {
+            ok: false,
+            code: "nothing_to_review",
+            message: `No assumption from ${id} is waiting for review in ${picked}.`,
+        };
+    }
+    write(aFile, r.md);
+    // The decision is in the spec: what waited only for this question can be
+    // built again (REQ-210). Another open question still holds its own.
+    const all = allQuestions(projectDir);
+    const blocks = (all.find((q) => q.id === id && q.change === picked) || { blocks: [] }).blocks;
+    const stillHeld = new Set(all.filter((q) => !q.answered).flatMap((q) => q.blocks));
+    const status = new Map((0, live_detail_1.liveMatrix)(projectDir).map((m) => [m.requirement, m.status]));
+    for (const req of blocks) {
+        if (stillHeld.has(req) || status.get(req) !== "Needs Clarification")
+            continue;
+        const where = definedIn(projectDir, req);
+        if (where)
+            setStatusIn(where.file, projectDir, req, "Draft");
+    }
+    return { ok: true, change: picked, ids: r.ids };
+}
+/** Where a requirement is defined: the open change that adds or modifies it, or the capability spec. */
+function definedIn(projectDir, req) {
+    const heading = new RegExp(`^###\\s+Requirement:\\s+${req}\\b`, "m");
+    for (const change of (0, ChangeWorkspace_1.listChangeIds)(projectDir)) {
+        const specs = path.join(changeDir(projectDir, change), "specs");
+        for (const cap of safeDirs(specs)) {
+            const file = path.join(specs, cap, "spec.md");
+            if (heading.test(read(file) || ""))
+                return { change, file };
+        }
+    }
+    const caps = path.join(projectDir, "docs", "specs", "capabilities");
+    for (const cap of safeDirs(caps)) {
+        const file = path.join(caps, cap, "spec.md");
+        if (heading.test(read(file) || ""))
+            return { change: exports.PROJECT, file };
+    }
+    const spec = path.join(projectDir, "spec.md");
+    if (new RegExp(`^#{2,3}\\s+${req}\\b`, "m").test(read(spec) || ""))
+        return { change: exports.PROJECT, file: spec };
+    return null;
+}
+/**
+ * A requirement of `spec.md` keeps its status in tables — the summary in
+ * `spec.md` and the matrix — whose last cell is the status: set both.
+ */
+function setStatusInTables(projectDir, req, status) {
+    let done = false;
+    for (const rel of ["spec.md", path.join("docs", "specs", "traceability.md")]) {
+        const file = path.join(projectDir, rel);
+        const text = read(file);
+        if (!text)
+            continue;
+        const row = new RegExp(`^(\\|\\s*${req}\\s*\\|.*\\|)\\s*[^|]+?\\s*\\|\\s*$`, "gm");
+        const next = text.replace(row, (_m, head) => `${head} ${status} |`);
+        if (next !== text) {
+            write(file, next);
+            done = true;
+        }
+    }
+    return done;
+}
+function safeDirs(dir) {
+    try {
+        return fs
+            .readdirSync(dir, { withFileTypes: true })
+            .filter((e) => e.isDirectory())
+            .map((e) => e.name);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * The requirement's trace status set to Needs Clarification in the file that
+ * defines it, and the derived matrix refreshed. `apply` writes only the
+ * statuses a delivery moves through, and this one is not.
+ */
+function setWaiting(file, projectDir, req) {
+    return setStatusIn(file, projectDir, req, "Needs Clarification");
+}
+/** The requirement's trace status set in the file that defines it, the matrix refreshed. */
+function setStatusIn(file, projectDir, req, status) {
+    const value = /\s/.test(status) ? `"${status}"` : status;
+    if (path.basename(file) === "spec.md" && path.dirname(file) === projectDir) {
+        return setStatusInTables(projectDir, req, status);
+    }
+    const lines = (read(file) || "").split("\n");
+    const head = new RegExp(`^(?:###\\s+Requirement:|##)\\s+${req}\\b`);
+    const start = lines.findIndex((l) => head.test(l));
+    if (start === -1)
+        return false;
+    for (let i = start + 1; i < lines.length && !/^#{2,3}\s(?!#)/.test(lines[i]); i += 1) {
+        if (!/<!--\s*specgate:trace\b/.test(lines[i]))
+            continue;
+        lines[i] = /\bstatus=/.test(lines[i])
+            ? lines[i].replace(/\bstatus=(?:"[^"]*"|[^\s"]+?)(?=\s|-->)/, `status=${value}`)
+            : lines[i].replace(/<!--\s*specgate:trace/, `<!-- specgate:trace status=${value}`);
+        write(file, lines.join("\n"));
+        try {
+            (0, MatrixCommand_1.refreshDerivedMatrix)(projectDir);
+        }
+        catch {
+            /* the next validate refreshes it */
+        }
+        return true;
+    }
+    return false;
+}
+/** Add the question to where the requirement is defined, and set it waiting (REQ-189). */
+function ask(projectDir, req, text) {
+    const where = definedIn(projectDir, req);
+    if (!where) {
+        return {
+            ok: false,
+            code: "requirement_not_found",
+            message: `${req} is not defined by an open change or a capability spec.`,
+        };
+    }
+    const qFile = questionsFile(projectDir, where.change);
+    const added = (0, Clarification_1.addQuestion)(read(qFile), where.change, text, [req]);
+    write(qFile, added.md);
+    setWaiting(where.file, projectDir, req);
+    return {
+        ok: true,
+        change: where.change,
+        question: added.id,
+        file: path.relative(projectDir, qFile).split(path.sep).join("/"),
+    };
+}
+//# sourceMappingURL=clarification.js.map

package/dist/scripts/lib/clarification.js.map

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