@rsaglobaltech/specgate 0.27.9 → 1.0.0-rc.1

package/dist/scripts/lib/approvals.js

@@ -0,0 +1,243 @@
+"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.APPROVALS_FILE = void 0;
+exports.approvalSettings = approvalSettings;
+exports.gitIdentity = gitIdentity;
+exports.changeSchema = changeSchema;
+exports.readRecords = readRecords;
+exports.changeApprovals = changeApprovals;
+exports.approveLayers = approveLayers;
+exports.missingApprovals = missingApprovals;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const YamlLite_1 = require("../../packages/core/src/domain/YamlLite");
+const ChangeLayers_1 = require("../../packages/core/src/domain/ChangeLayers");
+const Approvals_1 = require("../../packages/core/src/domain/Approvals");
+/**
+ * The project side of roles and approvals (REQ-310..315, ADR-0043): the
+ * settings in `harness.config.yaml`, the git identity of whoever approves, and
+ * `approvals.json` in the change folder — which moves to the archive with it.
+ */
+exports.APPROVALS_FILE = "approvals.json";
+const changeDir = (projectDir, id) => path.join(projectDir, "docs", "specs", "changes", id);
+function read(file) {
+    try {
+        return fs.readFileSync(file, "utf8");
+    }
+    catch {
+        return null;
+    }
+}
+/** `roles:` and `approvals:` of `harness.config.yaml`; the defaults without one. */
+function approvalSettings(projectDir) {
+    const text = read(path.join(projectDir, "harness.config.yaml"));
+    const parsed = text ? (0, YamlLite_1.parseYamlLite)(text) : {};
+    return (0, Approvals_1.readApprovalSettings)(parsed && typeof parsed === "object" && !Array.isArray(parsed)
+        ? parsed
+        : {});
+}
+/** Who runs the command, as git knows them in this project. */
+function gitIdentity(projectDir) {
+    const get = (key) => ((0, node_child_process_1.spawnSync)("git", ["config", key], { cwd: projectDir, encoding: "utf8" }).stdout || "").trim();
+    return { name: get("user.name"), email: get("user.email") };
+}
+/** The change's schema: `layered` from 1.0 on, `spec-driven` for a 0.27 change. */
+function changeSchema(projectDir, id) {
+    const yaml = read(path.join(changeDir(projectDir, id), "change.yaml")) || "";
+    return (/^schema:\s*(\S+)/m.exec(yaml) || [])[1] || "spec-driven";
+}
+/** Each layer and its text, or null when it is missing or still as scaffolded. */
+function layerTexts(projectDir, id) {
+    const dir = changeDir(projectDir, id);
+    return ChangeLayers_1.LAYERS.map((l) => {
+        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));
+        const written = text !== null && !(0, ChangeLayers_1.isUntouchedLayer)(l.id, text, id);
+        return { id: l.id, owner: l.owner, file, text: written ? text : null };
+    });
+}
+function readRecords(projectDir, id) {
+    const text = read(path.join(changeDir(projectDir, id), exports.APPROVALS_FILE));
+    if (!text)
+        return [];
+    try {
+        const parsed = JSON.parse(text);
+        return Array.isArray(parsed) ? parsed : [];
+    }
+    catch {
+        return [];
+    }
+}
+function changeApprovals(projectDir, id) {
+    const settings = approvalSettings(projectDir);
+    const records = readRecords(projectDir, id);
+    const layers = (0, Approvals_1.layerApprovals)(layerTexts(projectDir, id), records, settings);
+    const schema = changeSchema(projectDir, id);
+    // A change with none of its layers written — a delta and nothing else — is
+    // approved as 0.27 approved it: by the `approved:` line `change approve` writes.
+    const line = approvedLine(projectDir, id);
+    const anyWritten = layers.some((l) => l.present);
+    const approved = anyWritten ? (0, Approvals_1.changeApproved)(layers) : Boolean(line);
+    const dates = layers.flatMap((l) => l.approvals.map((a) => a.at)).sort();
+    return {
+        change: id,
+        schema,
+        required: (0, Approvals_1.approvalsRequired)(schema, settings),
+        layers,
+        approved,
+        approvedAt: !approved ? "" : anyWritten ? dates[dates.length - 1] || "" : line,
+        recorded: records.length > 0,
+    };
+}
+/** The date on the `approved:` line of `change.yaml`, or "". */
+function approvedLine(projectDir, id) {
+    const yaml = read(path.join(changeDir(projectDir, id), "change.yaml")) || "";
+    return (/^approved:\s*(\S+)/m.exec(yaml) || [])[1] || "";
+}
+/** Keep `approved:` in `change.yaml` in step with the approvals: written once all are in. */
+function syncApprovedLine(projectDir, id, date) {
+    const file = path.join(changeDir(projectDir, id), "change.yaml");
+    const yaml = read(file) || "";
+    const without = yaml.replace(/^approved:.*\n?/m, "");
+    const next = date ? `${without.replace(/\n*$/, "\n")}approved: ${date}\n` : without;
+    if (next !== yaml)
+        fs.writeFileSync(file, next, "utf8");
+}
+/**
+ * Record the person's approval of the given layers — or, with `null`, of every
+ * written layer they own (REQ-311). Refuses a layer that is not written or
+ * whose owning role the person does not hold, naming the role and its people.
+ */
+function approveLayers(projectDir, id, layers, today, who = gitIdentity(projectDir)) {
+    if (!fs.existsSync(changeDir(projectDir, id))) {
+        return { ok: false, code: "change_not_found", message: `No open change ${id}.` };
+    }
+    const settings = approvalSettings(projectDir);
+    const texts = layerTexts(projectDir, id);
+    const present = texts.filter((t) => t.text !== null);
+    const person = who.email || who.name || "this git identity";
+    const ownerOf = (owner) => {
+        const people = settings.roles[owner] || [];
+        return `the ${owner} role${people.length ? ` (${people.join(", ")})` : ""}`;
+    };
+    let targets;
+    if (layers) {
+        targets = [];
+        for (const l of layers) {
+            const t = texts.find((x) => x.id === l);
+            if (!t) {
+                return {
+                    ok: false,
+                    code: "approve_unknown_layer",
+                    message: `${l} is not a layer: discover, design or tasks.`,
+                };
+            }
+            if (t.text === null) {
+                return {
+                    ok: false,
+                    code: "approve_layer_missing",
+                    message: `${id} has no ${t.file} written yet: there is nothing of the ${l} to approve.`,
+                    fix: `Write ${t.file}, then approve it.`,
+                };
+            }
+            if (!(0, Approvals_1.holdsRole)(settings, t.owner, who)) {
+                return {
+                    ok: false,
+                    code: "approve_not_owner",
+                    message: `${person} cannot approve the ${l} of ${id}: it belongs to ${ownerOf(t.owner)}.`,
+                    fix: `Have someone in the ${t.owner} role run specgate change approve ${id} --layer ${l}, or name ${person} under roles.${t.owner} in harness.config.yaml.`,
+                };
+            }
+            targets.push(t);
+        }
+    }
+    else {
+        targets = present.filter((t) => (0, Approvals_1.holdsRole)(settings, t.owner, who));
+        if (present.length > 0 && targets.length === 0) {
+            return {
+                ok: false,
+                code: "approve_not_owner",
+                message: `${person} holds none of the roles that own the layers of ${id}: ${present
+                    .map((t) => `${t.id} → ${t.owner}`)
+                    .join(", ")}.`,
+                fix: "Name them under roles: in harness.config.yaml, or have the owners approve.",
+            };
+        }
+    }
+    const records = readRecords(projectDir, id);
+    for (const t of targets) {
+        const hash = (0, Approvals_1.contentHash)(t.text);
+        const key = (who.email || who.name).toLowerCase();
+        const already = records.some((r) => r.layer === t.id && r.hash === hash && (r.by.email || r.by.name).toLowerCase() === key);
+        if (!already)
+            records.push({ layer: t.id, by: who, role: t.owner, hash, at: today });
+    }
+    if (targets.length > 0) {
+        fs.writeFileSync(path.join(changeDir(projectDir, id), exports.APPROVALS_FILE), `${JSON.stringify(records, null, 2)}\n`, "utf8");
+    }
+    const after = changeApprovals(projectDir, id);
+    // A 0.27 change with none of the layers written is approved as 0.27 did it.
+    const date = present.length === 0 ? today : after.approvedAt;
+    syncApprovedLine(projectDir, id, date);
+    return {
+        ok: true,
+        change: id,
+        approved: date,
+        layers: targets.map((t) => t.id),
+        pending: after.layers.filter((l) => l.present && !l.approved).map((l) => l.layer),
+    };
+}
+/** Why the harness must not build the change yet, or null when it may (REQ-315). */
+function missingApprovals(projectDir, id) {
+    const state = changeApprovals(projectDir, id);
+    if (!state.required || state.approved)
+        return null;
+    const waiting = state.layers.filter((l) => l.present && !l.approved);
+    const what = waiting.length
+        ? waiting
+            .map((l) => `${l.layer} (${l.approvals.length} of ${l.quorum} approval(s), by the ${l.owner} role)`)
+            .join(", ")
+        : "nobody approved it";
+    const layer = waiting[0];
+    return {
+        message: `${id} is not approved: ${what}.`,
+        fix: layer
+            ? `specgate change approve ${id} --layer ${layer.layer}, by the ${layer.owner} role — or approvals: { required: never } in harness.config.yaml for the 0.27 behaviour.`
+            : `specgate change approve ${id} — or approvals: { required: never } in harness.config.yaml for the 0.27 behaviour.`,
+    };
+}
+//# sourceMappingURL=approvals.js.map

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

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

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

@@ -42,6 +42,7 @@ 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");
+const approvals_1 = require("./approvals");
 /**
  * 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.
@@ -58,10 +59,19 @@ function read(file) {
         return undefined;
     }
 }
-/** When a person approved the change, or "" when nobody has. */
+/**
+ * When the change was approved, or "" while it is not. A 1.0 change, and any
+ * change with recorded approvals, is approved only while every written layer's
+ * approvals match its text (REQ-314); a 0.27 change without any reads the
+ * `approved:` line it always had.
+ */
 function approvedOn(projectDir, id) {
     const yaml = read(path.join(changeDir(projectDir, id), "change.yaml")) || "";
-    return (/^approved:\s*(\S+)/m.exec(yaml) || [])[1] || "";
+    const line = (/^approved:\s*(\S+)/m.exec(yaml) || [])[1] || "";
+    const state = (0, approvals_1.changeApprovals)(projectDir, id);
+    if (state.schema === "layered" || state.recorded)
+        return state.approved ? state.approvedAt : "";
+    return line;
 }
 /** What stops a change from being approved: checklist errors and open questions. */
 function approvalBlockers(projectDir, id) {
@@ -84,9 +94,12 @@ function approvalBlockers(projectDir, id) {
     }
     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");
+/**
+ * Record that a person approved the change (REQ-206): the layers they own, or
+ * the one named (REQ-311). `approved` is the date once every layer is in, ""
+ * while some still wait.
+ */
+function approveChange(projectDir, id, today, layer) {
     if (!fs.existsSync(changeDir(projectDir, id))) {
         return { ok: false, code: "change_not_found", message: `No open change ${id}.` };
     }
@@ -99,12 +112,7 @@ function approveChange(projectDir, id, today) {
             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 };
+    return (0, approvals_1.approveLayers)(projectDir, id, layer ? [layer] : null, today);
 }
 const NOTES_HEADER = "| Date | Requirement | Request |";
 function cell(text) {

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

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

package/dist/scripts/lib/contracts.js

@@ -0,0 +1,211 @@
+"use strict";
+/**
+ * The project's interface contracts and the requirements that cite them
+ * (REQ-335, REQ-336).
+ *
+ * A contract is an OpenAPI or AsyncAPI document anywhere in the project, or
+ * any file an `api=` reference names. A reference is read off the
+ * `specgate:trace` comment of a requirement in spec.md or a capability spec.
+ */
+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.apiCitations = apiCitations;
+exports.projectContracts = projectContracts;
+exports.apiReferenceProblems = apiReferenceProblems;
+exports.contractReport = contractReport;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const ApiContract_1 = require("../../packages/core/src/domain/ApiContract");
+const SpecParser_1 = require("../../packages/core/src/domain/SpecParser");
+const ChangeWorkspace_1 = require("../../packages/core/src/infrastructure/ChangeWorkspace");
+const diagnostics_1 = require("./diagnostics");
+const SKIP = new Set([
+    ".git",
+    "node_modules",
+    "dist",
+    "target",
+    "build",
+    ".next",
+    "coverage",
+    ".harness",
+]);
+const CANDIDATE = /\.(ya?ml|json)$/i;
+/** Every requirement's `api=` references, from spec.md and the capability specs. */
+function apiCitations(projectDir) {
+    const files = [path.join(projectDir, "spec.md")];
+    const caps = path.join(projectDir, ChangeWorkspace_1.CAPABILITIES_DIR);
+    if (fs.existsSync(caps)) {
+        for (const e of fs.readdirSync(caps, { withFileTypes: true })) {
+            if (e.isDirectory())
+                files.push(path.join(caps, e.name, "spec.md"));
+        }
+    }
+    const out = [];
+    for (const f of files) {
+        if (!fs.existsSync(f))
+            continue;
+        let requirement = "";
+        const lines = fs.readFileSync(f, "utf8").split(/\r?\n/);
+        for (let i = 0; i < lines.length; i++) {
+            const h = /^#{2,4}\s+(?:Requirement:\s*)?(REQ-\d+)\b/.exec(lines[i]);
+            if (h) {
+                requirement = h[1];
+                continue;
+            }
+            if (!requirement || !/<!--\s*specgate:trace\b/.test(lines[i]))
+                continue;
+            let comment = lines[i];
+            while (!comment.includes("-->") && i + 1 < lines.length)
+                comment += `\n${lines[++i]}`;
+            const api = (0, SpecParser_1.parseTraceComment)(comment).api;
+            if (!api)
+                continue;
+            for (const ref of api
+                .split(",")
+                .map((s) => s.trim())
+                .filter(Boolean)) {
+                out.push({ requirement, ref });
+            }
+        }
+    }
+    return out;
+}
+/** The contracts: every OpenAPI/AsyncAPI file found, plus those cited by path. */
+function projectContracts(projectDir, cited = apiCitations(projectDir)) {
+    const found = {};
+    const read = (rel) => {
+        const abs = path.join(projectDir, rel);
+        let text;
+        try {
+            text = fs.readFileSync(abs, "utf8");
+        }
+        catch {
+            return;
+        }
+        if (!(0, ApiContract_1.contractKind)(text))
+            return;
+        found[rel.replace(/\\/g, "/")] = (0, ApiContract_1.contractOperations)(text, rel);
+    };
+    const walk = (rel, depth) => {
+        if (depth > 6)
+            return;
+        let entries;
+        try {
+            entries = fs.readdirSync(path.join(projectDir, rel), { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            if (SKIP.has(e.name) || e.name.startsWith("."))
+                continue;
+            const p = rel ? `${rel}/${e.name}` : e.name;
+            if (e.isDirectory())
+                walk(p, depth + 1);
+            else if (CANDIDATE.test(e.name) && /openapi|asyncapi|swagger|contract|api/i.test(p))
+                read(p);
+        }
+    };
+    walk("", 0);
+    for (const c of cited) {
+        const { file } = (0, ApiContract_1.parseApiRef)(c.ref);
+        const norm = file.replace(/\\/g, "/").replace(/^\.\//, "");
+        if (norm && !found[norm] && fs.existsSync(path.join(projectDir, norm)))
+            read(norm);
+    }
+    return found;
+}
+/** `validate`'s findings: each reference that does not resolve (REQ-335). */
+function apiReferenceProblems(projectDir) {
+    const cited = apiCitations(projectDir);
+    if (cited.length === 0)
+        return [];
+    const contracts = projectContracts(projectDir, cited);
+    const problems = [];
+    for (const c of cited) {
+        const r = (0, ApiContract_1.resolveApiRef)(c.ref, contracts);
+        if (r.ok)
+            continue;
+        problems.push(r.reason === "contract_missing"
+            ? (0, diagnostics_1.error)("api_contract_missing", `${c.requirement} cites api=${c.ref}, and ${r.file} is not a contract in this project.`, {
+                target: c.requirement,
+                fix: `Correct the path in ${c.requirement}'s specgate:trace comment, or add the contract.`,
+            })
+            : (0, diagnostics_1.error)("api_operation_missing", `${c.requirement} cites api=${c.ref}, which is not an operation of ${r.file || "any contract in this project"}.`, {
+                target: c.requirement,
+                fix: `Correct the operation in ${c.requirement}'s specgate:trace comment, or add it to the contract.`,
+            }));
+    }
+    return problems;
+}
+/** `specgate contract check` (REQ-336). */
+function contractReport(projectDir) {
+    const cited = apiCitations(projectDir);
+    const contracts = projectContracts(projectDir, cited);
+    const status = apiReferenceProblems(projectDir);
+    const citedBy = new Map();
+    for (const c of cited) {
+        const r = (0, ApiContract_1.resolveApiRef)(c.ref, contracts);
+        if (!r.ok)
+            continue;
+        const key = `${r.file}#${r.operation.pointer}`;
+        citedBy.set(key, [...(citedBy.get(key) || []), c.requirement]);
+    }
+    const report = { contracts: [] };
+    for (const [file, ops] of Object.entries(contracts).sort(([a], [b]) => a.localeCompare(b))) {
+        const entry = {
+            file,
+            kind: ops[0]?.kind || "",
+            operations: ops.length,
+            cited: [],
+            uncited: [],
+        };
+        for (const op of ops) {
+            const by = citedBy.get(`${file}#${op.pointer}`);
+            if (by)
+                entry.cited.push(`${op.label} — ${[...new Set(by)].join(", ")}`);
+            else {
+                entry.uncited.push(op.label);
+                status.push((0, diagnostics_1.warning)("api_operation_uncited", `${file}: ${op.label} is cited by no requirement.`, {
+                    target: op.operationId || op.pointer,
+                    fix: `Specify it: a requirement whose specgate:trace says api=${file}#${op.operationId || op.pointer}.`,
+                }));
+            }
+        }
+        report.contracts.push(entry);
+    }
+    return { report, status };
+}
+//# sourceMappingURL=contracts.js.map

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

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

package/dist/scripts/lib/drift.js

@@ -0,0 +1,80 @@
+"use strict";
+/**
+ * Behaviour changed without a specification (REQ-333, REQ-334).
+ *
+ * A commit since the base drifts when it changes production code, its message
+ * names no requirement, and no test file it changes names one: a person
+ * patched the product and the specification never heard of it. The harness's
+ * commits name their requirement, so they never drift.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isProductionFile = isProductionFile;
+exports.driftSince = driftSince;
+exports.driftFindings = driftFindings;
+const node_child_process_1 = require("node:child_process");
+const diagnostics_1 = require("./diagnostics");
+const quality_run_1 = require("./quality-run");
+const REQ = /\bREQ-\d+\b/;
+const SOURCE = /\.(ts|tsx|js|jsx|mjs|cjs|java|kt|scala|groovy|py|go|rs|cs|fs|rb|php|swift|vue|svelte|sql|c|cc|cpp|h|hpp)$/i;
+const NOT_PRODUCTION = [
+    /(^|\/)(tests?|__tests__|__mocks__|spec|specs|e2e|fixtures|testdata)\//i,
+    /(^|\/)src\/(test|it|integrationTest)\//i,
+    /\.(test|spec|e2e|stories)\.[^/]+$/i,
+    /(Test|Tests|IT|Spec)\.(java|kt|scala|groovy|cs)$/,
+    /(^|\/)(docs|features|\.github|\.specgate|\.harness)\//,
+    /(^|[/.])(eslint|prettier|vite|vitest|jest|playwright|next|webpack|rollup|tailwind|postcss|babel|tsup)\.config\.[^/]+$/i,
+    /(^|\/)build\.gradle(\.kts)?$|(^|\/)settings\.gradle(\.kts)?$/,
+];
+function isProductionFile(file) {
+    const f = file.replace(/\\/g, "/");
+    return SOURCE.test(f) && !NOT_PRODUCTION.some((re) => re.test(f));
+}
+function isTestFile(file) {
+    const f = file.replace(/\\/g, "/");
+    return NOT_PRODUCTION.slice(0, 4).some((re) => re.test(f));
+}
+function git(dir, args) {
+    return (0, node_child_process_1.spawnSync)("git", ["-C", dir, ...args], { encoding: "utf8", maxBuffer: 64 * 1024 * 1024 });
+}
+function driftSince(projectDir, explicitBase = "") {
+    const base = (0, quality_run_1.baseOf)(projectDir, explicitBase);
+    if (!base)
+        return { base: "", commits: [] };
+    const list = git(projectDir, ["rev-list", "--no-merges", "--reverse", `${base}..HEAD`]);
+    if (list.status !== 0)
+        return { base, commits: [] };
+    const commits = [];
+    for (const sha of (list.stdout || "").split("\n").filter(Boolean)) {
+        const message = git(projectDir, ["log", "-1", "--format=%B", sha]).stdout || "";
+        if (REQ.test(message))
+            continue;
+        const files = (git(projectDir, ["diff-tree", "--no-commit-id", "--name-only", "-r", "--root", sha]).stdout ||
+            "")
+            .split("\n")
+            .filter(Boolean);
+        const production = files.filter(isProductionFile);
+        if (production.length === 0)
+            continue;
+        const namedByATest = files.filter(isTestFile).some((f) => {
+            const shown = git(projectDir, ["show", `${sha}:${f}`]);
+            return shown.status === 0 && REQ.test(shown.stdout || "");
+        });
+        if (namedByATest)
+            continue;
+        commits.push({
+            sha: sha.slice(0, 12),
+            subject: message.split("\n")[0].trim(),
+            files: production,
+        });
+    }
+    return { base, commits };
+}
+/** One finding per drifting commit; errors when the project gates on drift. */
+function driftFindings(report, gate) {
+    const make = gate ? diagnostics_1.error : diagnostics_1.warning;
+    return report.commits.map((c) => make("spec_drift", `${c.sha} "${c.subject}" changes ${c.files.join(", ")} and names no requirement, nor does any test it changes.`, {
+        target: c.sha,
+        fix: 'Name the requirement it serves in the commit and a test, or specify the behaviour first: specgate new "<behaviour>".',
+    }));
+}
+//# sourceMappingURL=drift.js.map