@rsaglobaltech/specgate 0.27.9 → 1.0.0-rc.2

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

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

package/dist/scripts/lib/role-packages.js

@@ -0,0 +1,230 @@
+"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.PACKAGES_DIR = void 0;
+exports.readPackages = readPackages;
+exports.requirementFacts = requirementFacts;
+exports.packagesFor = packagesFor;
+exports.rolePromptSection = rolePromptSection;
+exports.reviewAdvice = reviewAdvice;
+exports.packageUse = packageUse;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const YamlLite_1 = require("../../packages/core/src/domain/YamlLite");
+/**
+ * Role packages (REQ-316..318, ADR-0043): what security, performance,
+ * infrastructure — any role — asks of the work, written once in
+ * `harness/<role>.md` and given to the agent for the requirements it concerns.
+ *
+ *   ---
+ *   role: security
+ *   owner: sec@acme.eu
+ *   version: 2
+ *   applies-to:
+ *     kind: [functional, business-rule]
+ *     capability: [payments]
+ *     tag: [pii]
+ *   ---
+ *   The constraints, in Markdown.
+ *
+ * A package applies when every dimension it lists matches the requirement (any
+ * value of a list); with no `applies-to`, to every requirement.
+ */
+exports.PACKAGES_DIR = "harness";
+const list = (v) => Array.isArray(v)
+    ? v.map((x) => String(x).trim().toLowerCase()).filter(Boolean)
+    : v === undefined || v === null || v === ""
+        ? []
+        : String(v)
+            .split(",")
+            .map((x) => x.trim().toLowerCase())
+            .filter(Boolean);
+/** Every package of the project; one that cannot be read is left out, with why. */
+function readPackages(projectDir) {
+    const dir = path.join(projectDir, exports.PACKAGES_DIR);
+    const packages = [];
+    const problems = [];
+    let names = [];
+    try {
+        names = fs
+            .readdirSync(dir)
+            .filter((n) => n.endsWith(".md"))
+            .sort();
+    }
+    catch {
+        return { packages, problems };
+    }
+    for (const name of names) {
+        const file = path.join(exports.PACKAGES_DIR, name).split(path.sep).join("/");
+        const text = fs.readFileSync(path.join(dir, name), "utf8").replace(/\r\n/g, "\n");
+        const m = /^---\n([\s\S]*?)\n---\n?([\s\S]*)$/.exec(text);
+        if (!m) {
+            problems.push(`${file}: no front matter (role, owner, version, applies-to)`);
+            continue;
+        }
+        let meta;
+        try {
+            meta = ((0, YamlLite_1.parseYamlLite)(m[1]) || {});
+        }
+        catch (err) {
+            problems.push(`${file}: ${err.message}`);
+            continue;
+        }
+        const role = String(meta.role || name.replace(/\.md$/, "")).trim();
+        const version = String(meta.version ?? "1").trim();
+        const applies = (meta["applies-to"] || {});
+        packages.push({
+            id: `${role}@${version}`,
+            role,
+            owner: String(meta.owner || "").trim(),
+            version,
+            appliesTo: {
+                kind: list(applies.kind),
+                capability: list(applies.capability),
+                tag: list(applies.tag ?? applies.tags),
+            },
+            body: m[2].trim(),
+            file,
+        });
+    }
+    return { packages, problems };
+}
+/** The requirement's kind, capability and tags, from where the specification states it. */
+function requirementFacts(projectDir, id) {
+    const specs = [
+        { file: path.join(projectDir, "spec.md"), capability: "" },
+    ];
+    const caps = path.join(projectDir, "docs", "specs", "capabilities");
+    try {
+        for (const c of fs.readdirSync(caps)) {
+            specs.push({ file: path.join(caps, c, "spec.md"), capability: c });
+        }
+    }
+    catch {
+        /* no capability specs */
+    }
+    const heading = new RegExp(`^###\\s+Requirement:\\s+${id}\\b`, "m");
+    for (const s of specs) {
+        let text;
+        try {
+            text = fs.readFileSync(s.file, "utf8");
+        }
+        catch {
+            continue;
+        }
+        const at = text.search(heading);
+        if (at < 0)
+            continue;
+        const rest = text.slice(at + 4);
+        const next = rest.search(/^###\s+Requirement:/m);
+        const block = next >= 0 ? rest.slice(0, next) : rest;
+        const trace = /<!--\s*specgate:trace([^>]*)-->/.exec(block);
+        const attr = (k) => {
+            const m = trace ? new RegExp(`\\b${k}=(?:"([^"]*)"|(\\S+))`).exec(trace[1]) : null;
+            return m ? (m[1] ?? m[2]) : "";
+        };
+        return {
+            kind: attr("kind").toLowerCase(),
+            capability: s.capability.toLowerCase(),
+            tags: list(attr("tags")),
+        };
+    }
+    return null;
+}
+function applies(p, facts) {
+    const { kind, capability, tag } = p.appliesTo;
+    if (kind.length && !kind.includes(facts.kind))
+        return false;
+    if (capability.length && !capability.includes(facts.capability))
+        return false;
+    if (tag.length && !tag.some((t) => facts.tags.includes(t)))
+        return false;
+    return true;
+}
+/** The packages that apply to one requirement, in file order. */
+function packagesFor(projectDir, id) {
+    const { packages } = readPackages(projectDir);
+    if (packages.length === 0)
+        return [];
+    const facts = requirementFacts(projectDir, id) || { kind: "", capability: "", tags: [] };
+    return packages.filter((p) => applies(p, facts));
+}
+/** The prompt section the agent reads, or "" when no package applies (REQ-316). */
+function rolePromptSection(pkgs) {
+    if (pkgs.length === 0)
+        return "";
+    return [
+        "## Role constraints",
+        "",
+        "Each package below is a role's constraints on this work. Meet them as you meet the " +
+            "requirement: a change that breaks one is not done.",
+        "",
+        ...pkgs.flatMap((p) => [
+            `### ${p.role} · v${p.version}${p.owner ? ` · owner ${p.owner}` : ""}`,
+            "",
+            p.body,
+            "",
+        ]),
+    ].join("\n");
+}
+/** What the review check asks per package (REQ-318); "" when none applies. */
+function reviewAdvice(pkgs) {
+    if (pkgs.length === 0)
+        return "";
+    return [
+        "",
+        "Then, for each role package under Role constraints, add one line: " +
+            pkgs.map((p) => `\`- ${p.role}: OK\``).join(", ") +
+            " — or `- <role>: ADVICE — what to change`. This advice is for the person; it does " +
+            "not decide the verdict.",
+    ].join("\n");
+}
+/** Each package, with the number of distinct requirements it reached across the runs (REQ-317). */
+function packageUse(runs) {
+    const reached = new Map();
+    for (const run of runs) {
+        for (const r of run.results || []) {
+            for (const id of r.packages || []) {
+                if (!reached.has(id))
+                    reached.set(id, new Set());
+                reached.get(id).add(String(r.requirement || ""));
+            }
+        }
+    }
+    return [...reached.entries()]
+        .map(([id, reqs]) => ({ id, requirements: reqs.size }))
+        .sort((a, b) => b.requirements - a.requirements || a.id.localeCompare(b.id));
+}
+//# sourceMappingURL=role-packages.js.map

package/dist/scripts/lib/role-packages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-packages.js","sourceRoot":"","sources":["../../../scripts/lib/role-packages.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsDA,oCAiDC;AAGD,4CAqCC;AAWD,kCAKC;AAGD,8CAeC;AAGD,oCASC;AAGD,gCAeC;AA/MD,4CAA8B;AAC9B,gDAAkC;AAClC,sEAAwE;AAExE;;;;;;;;;;;;;;;;;;GAkBG;AAEU,QAAA,YAAY,GAAG,SAAS,CAAC;AAmBtC,MAAM,IAAI,GAAG,CAAC,CAAU,EAAY,EAAE,CACpC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;IACd,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;IAC9D,CAAC,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,EAAE;QACzC,CAAC,CAAC,EAAE;QACJ,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;aACN,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;aAClC,MAAM,CAAC,OAAO,CAAC,CAAC;AAE3B,mFAAmF;AACnF,SAAgB,YAAY,CAAC,UAAkB;IAI7C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,oBAAY,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAkB,EAAE,CAAC;IACnC,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,IAAI,KAAK,GAAa,EAAE,CAAC;IACzB,IAAI,CAAC;QACH,KAAK,GAAG,EAAE;aACP,WAAW,CAAC,GAAG,CAAC;aAChB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;aAChC,IAAI,EAAE,CAAC;IACZ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;IAChC,CAAC;IACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,oBAAY,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACrE,MAAM,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QAClF,MAAM,CAAC,GAAG,oCAAoC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1D,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,sDAAsD,CAAC,CAAC;YAC7E,SAAS;QACX,CAAC;QACD,IAAI,IAA6B,CAAC;QAClC,IAAI,CAAC;YACH,IAAI,GAAG,CAAC,IAAA,wBAAa,EAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAA4B,CAAC;QAChE,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,KAAM,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;YACpD,SAAS;QACX,CAAC;QACD,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACnE,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACnD,MAAM,OAAO,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,EAAE,CAA4B,CAAC;QACtE,QAAQ,CAAC,IAAI,CAAC;YACZ,EAAE,EAAE,GAAG,IAAI,IAAI,OAAO,EAAE;YACxB,IAAI;YACJ,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;YACtC,OAAO;YACP,SAAS,EAAE;gBACT,IAAI,EAAE,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;gBACxB,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC;gBACpC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;aACvC;YACD,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE;YACjB,IAAI;SACL,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AAChC,CAAC;AAED,2FAA2F;AAC3F,SAAgB,gBAAgB,CAAC,UAAkB,EAAE,EAAU;IAC7D,MAAM,KAAK,GAAgD;QACzD,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE;KAC3D,CAAC;IACF,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;IACpE,IAAI,CAAC;QACH,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YACrC,KAAK,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,SAAS,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC,CAAC;QACrE,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,yBAAyB;IAC3B,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,MAAM,CAAC,2BAA2B,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;IACpE,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,IAAY,CAAC;QACjB,IAAI,CAAC;YACH,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACzC,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAChC,IAAI,EAAE,GAAG,CAAC;YAAE,SAAS;QACrB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,sBAAsB,CAAC,CAAC;QACjD,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACrD,MAAM,KAAK,GAAG,iCAAiC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAG,CAAC,CAAS,EAAE,EAAE;YACzB,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;YACnF,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACjC,CAAC,CAAC;QACF,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE;YAChC,UAAU,EAAE,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE;YACtC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;SACzB,CAAC;IACJ,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,OAAO,CAAC,CAAc,EAAE,KAAuB;IACtD,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC;IAC9C,IAAI,IAAI,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC5D,IAAI,UAAU,CAAC,MAAM,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9E,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACzE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,iEAAiE;AACjE,SAAgB,WAAW,CAAC,UAAkB,EAAE,EAAU;IACxD,MAAM,EAAE,QAAQ,EAAE,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC;IAC9C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,MAAM,KAAK,GAAG,gBAAgB,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IACzF,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,mFAAmF;AACnF,SAAgB,iBAAiB,CAAC,IAAmB;IACnD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,OAAO;QACL,qBAAqB;QACrB,EAAE;QACF,qFAAqF;YACnF,oDAAoD;QACtD,EAAE;QACF,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YACrB,OAAO,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;YACtE,EAAE;YACF,CAAC,CAAC,IAAI;YACN,EAAE;SACH,CAAC;KACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,8EAA8E;AAC9E,SAAgB,YAAY,CAAC,IAAmB;IAC9C,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACjC,OAAO;QACL,EAAE;QACF,oEAAoE;YAClE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,CAAC,IAAI,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YACjD,oFAAoF;YACpF,yBAAyB;KAC5B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,mGAAmG;AACnG,SAAgB,UAAU,CACxB,IAA+E;IAE/E,MAAM,OAAO,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC/C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;YAClC,KAAK,MAAM,EAAE,IAAI,CAAC,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;gBAClC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;oBAAE,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;gBACjD,OAAO,CAAC,GAAG,CAAC,EAAE,CAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;SAC1B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;SACtD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACjF,CAAC"}

package/dist/scripts/lib/steering.js

@@ -0,0 +1,180 @@
+"use strict";
+/**
+ * The organization's principles as `check` sees them (REQ-330..332): the
+ * version this repository follows, whether its source has a newer one, and the
+ * principles' machine checks.
+ */
+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.steering = steering;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const diagnostics_1 = require("./diagnostics");
+const shell_command_1 = require("./shell-command");
+const Principles_1 = require("../../packages/core/src/domain/Principles");
+const YamlLite_1 = require("../../packages/core/src/domain/YamlLite");
+const lock_1 = require("../specops/lock");
+/** The version a pack's source declares, when the source is a local folder. */
+function packVersion(projectDir, packId) {
+    let lock;
+    try {
+        lock = (0, lock_1.readLock)(projectDir);
+    }
+    catch {
+        return null;
+    }
+    const entry = lock?.packs.find((p) => p.pack_id === packId);
+    if (!entry)
+        return null;
+    const repo = path.resolve(projectDir, String(entry.repo || ""));
+    if (!fs.existsSync(repo) || !fs.statSync(repo).isDirectory())
+        return null;
+    const candidates = [entry.pack, entry.pack_id, ""].filter((x) => x !== undefined);
+    for (const sub of candidates) {
+        const file = path.join(repo, String(sub), "pack.yaml");
+        if (!fs.existsSync(file))
+            continue;
+        try {
+            const meta = (0, YamlLite_1.parseYamlLite)(fs.readFileSync(file, "utf8")).metadata;
+            if (meta && meta.version)
+                return String(meta.version);
+        }
+        catch {
+            return null;
+        }
+    }
+    return null;
+}
+/** The version the source offers, and how to take it; null when unknown. */
+function upstream(projectDir, doc) {
+    if (!doc.source)
+        return null;
+    if (doc.source.startsWith("pack:")) {
+        const id = doc.source.slice("pack:".length).trim();
+        const version = packVersion(projectDir, id);
+        return version ? { version, update: `specgate specops sync --pack ${id}` } : null;
+    }
+    const file = path.resolve(projectDir, doc.source);
+    if (!fs.existsSync(file))
+        return null;
+    const version = (0, Principles_1.parsePrinciples)(fs.readFileSync(file, "utf8")).version;
+    return version
+        ? { version, update: `copy ${doc.source} over ${Principles_1.PRINCIPLES_FILE}, and review what changed` }
+        : null;
+}
+/** Files a pattern principle reads: tracked ones, or every file without git. */
+function projectFiles(projectDir) {
+    const r = (0, node_child_process_1.spawnSync)("git", ["-C", projectDir, "ls-files"], { encoding: "utf8" });
+    if (r.status === 0)
+        return (r.stdout || "").split("\n").filter(Boolean);
+    const out = [];
+    const skip = new Set([".git", "node_modules", "dist", "target", "build"]);
+    const walk = (rel) => {
+        for (const e of fs.readdirSync(path.join(projectDir, rel), { withFileTypes: true })) {
+            if (skip.has(e.name))
+                continue;
+            const p = rel ? `${rel}/${e.name}` : e.name;
+            if (e.isDirectory())
+                walk(p);
+            else
+                out.push(p);
+        }
+    };
+    walk("");
+    return out;
+}
+function steering(projectDir) {
+    const file = path.join(projectDir, Principles_1.PRINCIPLES_FILE);
+    if (!fs.existsSync(file))
+        return { principles: null, findings: [] };
+    const doc = (0, Principles_1.parsePrinciples)(fs.readFileSync(file, "utf8"));
+    const findings = [];
+    const up = upstream(projectDir, doc);
+    if (up && doc.version && (0, Principles_1.compareVersions)(up.version, doc.version) > 0) {
+        findings.push((0, diagnostics_1.warning)("principles_behind", `This repository follows the principles ${doc.version}; ${doc.source} has ${up.version}.`, { target: Principles_1.PRINCIPLES_FILE, fix: up.update }));
+    }
+    let files = null;
+    let checked = 0;
+    for (const p of doc.principles) {
+        const make = p.level === "warn" ? diagnostics_1.warning : diagnostics_1.error;
+        if (p.run) {
+            checked++;
+            const r = (0, node_child_process_1.spawnSync)((0, shell_command_1.forShell)(p.run), { cwd: projectDir, shell: true, encoding: "utf8" });
+            if (r.status !== 0) {
+                findings.push(make("principle_failed", `Principle ${p.id} (${p.title}): \`${p.run}\` exited ${r.status}.`, {
+                    target: p.id,
+                    fix: `Make \`${p.run}\` pass, or change ${p.id} in ${Principles_1.PRINCIPLES_FILE} on purpose.`,
+                }));
+            }
+        }
+        if (p.forbid) {
+            checked++;
+            let pattern;
+            try {
+                pattern = new RegExp(p.forbid);
+            }
+            catch {
+                findings.push((0, diagnostics_1.error)("principle_invalid", `Principle ${p.id}: forbid is not a valid pattern: ${p.forbid}`, {
+                    target: p.id,
+                }));
+                continue;
+            }
+            files = files || projectFiles(projectDir);
+            const scope = p.in ? (0, Principles_1.globToRegExp)(p.in) : null;
+            const hits = [];
+            for (const f of files) {
+                if (f === Principles_1.PRINCIPLES_FILE || (scope && !scope.test(f)))
+                    continue;
+                let text;
+                try {
+                    text = fs.readFileSync(path.join(projectDir, f), "utf8");
+                }
+                catch {
+                    continue;
+                }
+                text.split(/\r?\n/).forEach((line, i) => {
+                    if (pattern.test(line))
+                        hits.push(`${f}:${i + 1}`);
+                });
+            }
+            if (hits.length > 0) {
+                findings.push(make("principle_failed", `Principle ${p.id} (${p.title}): forbidden in ${hits.slice(0, 5).join(", ")}${hits.length > 5 ? ` and ${hits.length - 5} more` : ""}.`, { target: p.id, fix: `Remove it, or change ${p.id} in ${Principles_1.PRINCIPLES_FILE} on purpose.` }));
+            }
+        }
+    }
+    return { principles: { version: doc.version, source: doc.source, checked }, findings };
+}
+//# sourceMappingURL=steering.js.map

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

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

package/dist/scripts/lib/studio-app-page.js

@@ -142,7 +142,7 @@ function studioAppPage(projectName, token = "") {
       s_build:"R listos · B de T construidos", s_build_locked:"Se abre cuando apruebes un borrador",
       s_report:"B de T construidos y probados", s_report_locked:"Aparece con el primer requisito construido", s_locked:"Se abre con el paso anterior",
       repeat:"Los pasos 3 a 6 se repiten por módulo: puedes construir uno mientras redactas otro.",
-      loading:"Cargando…", mods:"módulos", sOf:"de", modules:"Módulos", ready:"listo", qWait:"pregunta", draft:"borrador por revisar", reqs:"requisitos",
+      loading:"Cargando…", mods:"módulos", sOf:"de", modules:"Módulos", ready:"listo", qWait:"pregunta", draft:"borrador por revisar", reqs:"requisitos", own_product:"producto", own_architect:"arquitectura", own_developer:"desarrollo", layerDone:"escrito", layerTodo:"por escribir", layerApproved:"aprobado", layerWaits:"aprobaciones", approveLayer:"Aprobar", byWhom:"por",
       newTitle:"Empecemos un proyecto", newIntro:"Esta carpeta está vacía. Cinco preguntas y specgate la prepara: especificación, pruebas y el asistente que programa.",
       q1:"1 · ¿Cómo se llama?", q2:"2 · ¿Qué vas a construir?", q3:"3 · ¿Con qué tecnología?", q4:"4 · ¿Qué asistente programa?",
       kWeb:"Una web", kWebP:"Pantallas que se abren en el navegador", kApi:"Un servicio (API)", kApiP:"Datos y reglas para otras apps", kMob:"Una app móvil", kMobP:"Para el teléfono",
@@ -193,7 +193,7 @@ function studioAppPage(projectName, token = "") {
       stAttempt:"en cada intento", stEnd:"al final", stCi:"en CI",
       q5:"5 · ¿Qué nivel de calidad?", qlBasic:"Básico (recomendado)", qlBasicP:"Secretos, dependencias, tests que cubren lo cambiado y análisis estático. Todo en Docker.",
       qlStrict:"Estricto", qlStrictP:"Además: tests de mutación, complejidad y SAST. Más lento, más exigente.", qlNone:"Ninguno por ahora", qlNoneP:"Se puede activar después en Proyecto.",
-      rQuality:"Calidad del código", rQualityP:"cobertura C % · mutación M %", covShort:"cobertura", mutShort:"mutación"},
+      rQuality:"Calidad del código", rQualityP:"cobertura C % · mutación M %", covShort:"cobertura", mutShort:"mutación", rGaps:"Dónde se desvió", rGapsP:"spec → código S % · intención → spec I %"},
     en: {route:"Route", project:"Project", brief:"Brief", drafts:"Drafts", report:"Report",
       home:"Home", questions:"Questions", review:"Review", build:"Build", simple:"Simple", adv:"Advanced",
       routeTitle:"Your project, step by step", routeIntro:"From the brief to the app built and proven. Each step opens once the one before is ready; you can go back to any.",
@@ -212,7 +212,7 @@ function studioAppPage(projectName, token = "") {
       s_build:"R ready · B of T built", s_build_locked:"Opens once you approve a draft",
       s_report:"B of T built and proven", s_report_locked:"Appears with the first requirement built", s_locked:"Opens with the step before",
       repeat:"Steps 3 to 6 repeat per module: you can build one while another is drafted.",
-      loading:"Loading…", mods:"modules", sOf:"of", modules:"Modules", ready:"done", qWait:"question", draft:"draft to review", reqs:"requirements",
+      loading:"Loading…", mods:"modules", sOf:"of", modules:"Modules", ready:"done", qWait:"question", draft:"draft to review", reqs:"requirements", own_product:"product", own_architect:"architect", own_developer:"developer", layerDone:"written", layerTodo:"to write", layerApproved:"approved", layerWaits:"approvals", approveLayer:"Approve", byWhom:"by",
       newTitle:"Let's start a project", newIntro:"This folder is empty. Five questions and specgate prepares it: specification, tests and the assistant that codes.",
       q1:"1 · What is it called?", q2:"2 · What are you building?", q3:"3 · With which technology?", q4:"4 · Which assistant codes?",
       kWeb:"A website", kWebP:"Screens opened in the browser", kApi:"A service (API)", kApiP:"Data and rules for other apps", kMob:"A mobile app", kMobP:"For the phone",
@@ -263,7 +263,7 @@ function studioAppPage(projectName, token = "") {
       stAttempt:"every attempt", stEnd:"at the end", stCi:"in CI",
       q5:"5 · Which quality level?", qlBasic:"Basic (recommended)", qlBasicP:"Secrets, dependencies, tests that cover the change and static analysis. All in Docker.",
       qlStrict:"Strict", qlStrictP:"Also: mutation tests, complexity and SAST. Slower, stricter.", qlNone:"None for now", qlNoneP:"It can be turned on later in Project.",
-      rQuality:"Code quality", rQualityP:"coverage C % · mutation M %", covShort:"coverage", mutShort:"mutation"}
+      rQuality:"Code quality", rQualityP:"coverage C % · mutation M %", covShort:"coverage", mutShort:"mutation", rGaps:"Where it diverged", rGapsP:"spec → code S % · intent → spec I %"}
   };
   function load(k, d){ try { return localStorage.getItem(k) || d; } catch (e) { return d; } }
   function save(k, v){ try { localStorage.setItem(k, v); } catch (e) {} }
@@ -779,6 +779,26 @@ function studioAppPage(projectName, token = "") {
     list.forEach(function(d){
       var split = el("section", "split"), main = el("div", "main"), aside = el("aside");
       main.appendChild(el("h2", "", cap(d.module) + " · " + d.requirements.length + " " + t("reqs")));
+      // REQ-289: the change's layers, each with its owner (ADR-0042); REQ-319:
+      // who approved each, how many it needs, and a button for the layer the viewer owns.
+      if (d.layers && d.layers.length) {
+        var lys = el("div", "small muted");
+        d.layers.forEach(function(l){
+          var row = el("div"), mL = msgEl();
+          var who = (l.approvals || []).map(function(a){ return a.by.name || a.by.email; }).join(", ");
+          var state = !l.written ? t("layerTodo")
+            : l.approved ? t("layerApproved") + (who ? " " + t("byWhom") + " " + who : "")
+            : t("layerDone") + " · " + (l.approvals || []).length + "/" + (l.quorum || 1) + " " + t("layerWaits");
+          row.appendChild(el("span", "", l.file + " · " + t("own_" + l.owner) + " · " + state));
+          if (l.mine && l.written && !l.approved) {
+            row.append(" ", button("ghost", t("approveLayer"), function(){
+              post("api/approve", {change:d.change, layer:l.id}).then(function(res){ say(mL, res); if (res.ok) refresh(); });
+            }), mL);
+          }
+          lys.appendChild(row);
+        });
+        main.appendChild(lys);
+      }
       d.requirements.forEach(function(r){
         var waits = d.questions.filter(function(q){ return q.blocks.indexOf(r.id) >= 0; });
         var c = el("article", "card" + (waits.length ? " warn" : ""));
@@ -914,6 +934,9 @@ function studioAppPage(projectName, token = "") {
   }
 
   // ── Report (REQ-217) ────────────────────────────────────────────────────
+  // REQ-304: the two gaps, as harness report computes them.
+  function pctNum(v){ return v === null || v === undefined ? "—" : String(Math.round(v * 100)); }
+  function pctOrDash(v){ return v === null || v === undefined ? "—" : Math.round(v * 100) + "%"; }
   function viewReport(r){
     var m = $("view"); m.replaceChildren();
     var top = el("section"); flex(top); top.style.alignItems = "flex-end"; top.style.justifyContent = "space-between";
@@ -924,7 +947,7 @@ function studioAppPage(projectName, token = "") {
     var dl = el("a", "go", t("download")); dl.href = "report.html"; dl.style.display = "inline-flex"; dl.style.alignItems = "center"; dl.style.color = "#fff";
     acts.append(pdf, dl); top.append(g, acts); m.appendChild(top);
     var s = el("section", "stats");
-    [[t("rBuilt"), r.built + " " + t("sOf") + " " + r.total, t("reqs"), ""], [t("rExamples"), String(r.scenarios), "", "var(--pass)"], [t("rGate"), r.gate.ok ? t("rGateOk") : t("rGateBad"), r.gate.findings[0] || "", r.gate.ok ? "var(--pass)" : "var(--fail)"], [t("rCost"), r.cost === null ? "—" : "$" + r.cost.toFixed(2), r.minutes + " min", ""]].concat(r.quality && r.quality.measured ? [[t("rQuality"), (r.quality.coverage === null ? "—" : r.quality.coverage + "%"), fill("rQualityP", {C: r.quality.coverage === null ? "—" : r.quality.coverage, M: r.quality.mutation === null ? "—" : r.quality.mutation}), "var(--pass)"]] : []).forEach(function(x){
+    [[t("rBuilt"), r.built + " " + t("sOf") + " " + r.total, t("reqs"), ""], [t("rExamples"), String(r.scenarios), "", "var(--pass)"], [t("rGate"), r.gate.ok ? t("rGateOk") : t("rGateBad"), r.gate.findings[0] || "", r.gate.ok ? "var(--pass)" : "var(--fail)"], [t("rCost"), r.cost === null ? "—" : "$" + r.cost.toFixed(2), r.minutes + " min", ""]].concat(r.quality && r.quality.measured ? [[t("rQuality"), (r.quality.coverage === null ? "—" : r.quality.coverage + "%"), fill("rQualityP", {C: r.quality.coverage === null ? "—" : r.quality.coverage, M: r.quality.mutation === null ? "—" : r.quality.mutation}), "var(--pass)"]] : []).concat(r.gaps ? [[t("rGaps"), pctOrDash(r.gaps.specImpl) + " · " + pctOrDash(r.gaps.intentSpec), fill("rGapsP", {S: pctNum(r.gaps.specImpl), I: pctNum(r.gaps.intentSpec)}), ""]] : []).forEach(function(x){
       var d = el("div", "stat"), b = el("b", "", x[1]); if (x[3]) b.style.color = x[3]; d.append(el("span", "muted small", x[0]), b); if (x[2]) d.appendChild(el("span", "small muted", x[2])); s.appendChild(d);
     });
     m.appendChild(s);

package/dist/scripts/lib/studio-app-page.js.map

@@ -1 +1 @@
-{"version":3,"file":"studio-app-page.js","sourceRoot":"","sources":["../../../scripts/lib/studio-app-page.ts"],"names":[],"mappings":";;AAUA,sCAm/BC;AA7/BD;;;;;;;;;GASG;AACH,SAAgB,aAAa,CAAC,WAAmB,EAAE,KAAK,GAAG,EAAE;IAC3D,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC1D,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IACpD,OAAO;;;uCAG8B,GAAG;2BACf,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iRA+FiP,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eA44BvQ,CAAC;AAChB,CAAC"}
+{"version":3,"file":"studio-app-page.js","sourceRoot":"","sources":["../../../scripts/lib/studio-app-page.ts"],"names":[],"mappings":";;AAUA,sCA0gCC;AAphCD;;;;;;;;;GASG;AACH,SAAgB,aAAa,CAAC,WAAmB,EAAE,KAAK,GAAG,EAAE;IAC3D,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC1D,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IACpD,OAAO;;;uCAG8B,GAAG;2BACf,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iRA+FiP,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;eAm6BvQ,CAAC;AAChB,CAAC"}

package/dist/scripts/lib/studio-app.js

@@ -46,6 +46,7 @@ const path = __importStar(require("node:path"));
 const node_child_process_1 = require("node:child_process");
 const ChangeWorkspace_1 = require("../../packages/core/src/infrastructure/ChangeWorkspace");
 const SpecParser_1 = require("../../packages/core/src/domain/SpecParser");
+const ChangeLayers_1 = require("../../packages/core/src/domain/ChangeLayers");
 const Clarification_1 = require("../../packages/core/src/domain/Clarification");
 const HarnessConfigFile_1 = require("../../packages/core/src/infrastructure/HarnessConfigFile");
 const harness_environment_1 = require("./harness-environment");
@@ -57,6 +58,8 @@ const change_review_1 = require("./change-review");
 const harness_guard_1 = require("./harness-guard");
 const project_root_1 = require("./project-root");
 const in_flight_1 = require("./in-flight");
+const approvals_1 = require("./approvals");
+const Approvals_1 = require("../../packages/core/src/domain/Approvals");
 /**
  * What the visual studio shows and does (REQ-204..210): each read is built from
  * what the specgate commands read, and each write runs the command that makes
@@ -108,6 +111,31 @@ function draftRequirements(projectDir, change) {
     }
     return out;
 }
+/**
+ * The change's layers with their owners, and whether each is written
+ * (REQ-289, ADR-0042). A 0.27 change shows its proposal as the Discover.
+ */
+function draftLayers(projectDir, change) {
+    const dir = path.join(projectDir, "docs", "specs", "changes", change);
+    const state = (0, approvals_1.changeApprovals)(projectDir, change);
+    const settings = (0, approvals_1.approvalSettings)(projectDir);
+    const viewer = (0, approvals_1.gitIdentity)(projectDir);
+    return ChangeLayers_1.LAYERS.map((l) => {
+        const a = state.layers.find((x) => x.layer === l.id);
+        const file = l.id === "discover" && !fs.existsSync(path.join(dir, l.file)) ? ChangeLayers_1.LEGACY_DISCOVER : l.file;
+        const text = read(path.join(dir, file));
+        return {
+            id: l.id,
+            owner: l.owner,
+            file,
+            written: text !== undefined && !(0, ChangeLayers_1.isUntouchedLayer)(l.id, text, change),
+            approvals: a.approvals,
+            quorum: a.quorum,
+            approved: a.approved,
+            mine: (0, Approvals_1.holdsRole)(settings, l.owner, viewer),
+        };
+    });
+}
 /** Open changes a person has not approved yet, each as Review shows it (REQ-206). */
 function drafts(projectDir) {
     const open = (0, clarification_1.waiting)(projectDir).questions;
@@ -117,6 +145,7 @@ function drafts(projectDir) {
         change,
         module: change.replace(/^draft-/, "").replace(/-additions$/, ""),
         requirements: draftRequirements(projectDir, change),
+        layers: draftLayers(projectDir, change),
         blockers: (0, change_review_1.approvalBlockers)(projectDir, change),
         notes: (0, change_review_1.reviewNotes)(projectDir, change),
         questions: open