@rsaglobaltech/specgate 0.8.1

package/dist/packages/core/src/infrastructure/DiskPackRepository.js

@@ -0,0 +1,130 @@
+"use strict";
+/**
+ * Reading packs and writing expanded files.
+ *
+ * The rules a pack must satisfy live in `domain/PackSpec`; this is the half
+ * that touches a disk — loading `pack.yaml`, reading a template, writing an
+ * expanded file, and refusing to write outside the project root.
+ */
+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.loadPack = loadPack;
+exports.ensureProjectDir = ensureProjectDir;
+exports.readTemplate = readTemplate;
+exports.writeFile = writeFile;
+exports.getWrittenFiles = getWrittenFiles;
+exports.resetWrittenFiles = resetWrittenFiles;
+exports.safeResolve = safeResolve;
+exports.validatePackModel = validatePackModel;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const YamlLite_1 = require("../domain/YamlLite");
+const PackSpec_1 = require("../domain/PackSpec");
+const ConsoleReporter_1 = require("./ConsoleReporter");
+function fail(message) {
+    throw new Error(message);
+}
+function loadPack(packRoot, packId) {
+    if (!packRoot)
+        fail("Missing --pack-root <path>.");
+    if (!packId)
+        fail("Missing --pack <domain/type>.");
+    const normalizedRoot = path.resolve(packRoot);
+    const normalizedPackPath = path.resolve(normalizedRoot, packId);
+    const packFile = path.join(normalizedPackPath, "pack.yaml");
+    if (!normalizedPackPath.startsWith(normalizedRoot)) {
+        fail(`Invalid pack path '${packId}'.`);
+    }
+    if (!fs.existsSync(packFile)) {
+        fail(`Pack file not found: ${packFile}`);
+    }
+    const pack = (0, YamlLite_1.parseYamlLite)(fs.readFileSync(packFile, "utf8"));
+    return {
+        pack,
+        packFile,
+        packRoot: normalizedPackPath,
+    };
+}
+function ensureProjectDir(projectDir, dryRun) {
+    if (!projectDir) {
+        fail("Missing --project-dir <path>.");
+    }
+    if (dryRun)
+        return;
+    if (!fs.existsSync(projectDir) || !fs.statSync(projectDir).isDirectory()) {
+        fail(`Project directory does not exist: ${projectDir}`);
+    }
+}
+function readTemplate(packRoot, templatePath) {
+    return fs.readFileSync(path.resolve(packRoot, templatePath), "utf8");
+}
+// Records every file written in the current process so `expand` can snapshot
+// a baseline after rendering. Reset per expansion via resetWrittenFiles().
+const _writtenFiles = [];
+function writeFile(targetFile, content, dryRun) {
+    if (dryRun) {
+        (0, ConsoleReporter_1.logInfo)(`[dry-run] write ${targetFile}`);
+        return;
+    }
+    fs.mkdirSync(path.dirname(targetFile), { recursive: true });
+    fs.writeFileSync(targetFile, content, "utf8");
+    _writtenFiles.push({ file: targetFile, content });
+}
+function getWrittenFiles() {
+    return _writtenFiles.slice();
+}
+function resetWrittenFiles() {
+    _writtenFiles.length = 0;
+}
+function safeResolve(projectDir, relativePath) {
+    if (!(0, PackSpec_1.isSafeRelativePath)(relativePath)) {
+        fail(`Invalid target path '${relativePath}'.`);
+    }
+    const absolute = path.resolve(projectDir, relativePath);
+    const projectRoot = path.resolve(projectDir);
+    if (!absolute.startsWith(projectRoot)) {
+        fail(`Target path escapes project directory: '${relativePath}'.`);
+    }
+    return absolute;
+}
+/**
+ * The pack rules, with the one filesystem question they ask wired to the real
+ * disk. The rules themselves are pure and take the predicate explicitly; this
+ * is the form every caller wants.
+ */
+function validatePackModel(pack, packRoot) {
+    return (0, PackSpec_1.validatePackModel)(pack, packRoot, (absolute) => fs.existsSync(absolute));
+}
+//# sourceMappingURL=DiskPackRepository.js.map

package/dist/packages/core/src/infrastructure/DiskPackRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiskPackRepository.js","sourceRoot":"","sources":["../../../../../packages/core/src/infrastructure/DiskPackRepository.ts"],"names":[],"mappings":"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"}

package/dist/packages/core/src/infrastructure/DiskProjectRepository.js

@@ -0,0 +1,127 @@
+"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.DiskProjectRepository = void 0;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const ChangeWorkspace_1 = require("./ChangeWorkspace");
+class DiskProjectRepository {
+    projectDir;
+    constructor(projectDir) {
+        this.projectDir = projectDir;
+    }
+    changeExists(changeId) {
+        const p = this.getPaths();
+        return fs.existsSync(p.change(changeId));
+    }
+    isChangeSymlink(changeId) {
+        const p = this.getPaths();
+        const changeDir = p.change(changeId);
+        return fs.existsSync(changeDir) && fs.lstatSync(changeDir).isSymbolicLink();
+    }
+    readConfig(changeId) {
+        return (0, ChangeWorkspace_1.readConfig)(this.projectDir, changeId);
+    }
+    getTaskProgress(changeId) {
+        return (0, ChangeWorkspace_1.taskProgress)(this.projectDir, changeId);
+    }
+    listDeltas(changeId) {
+        return (0, ChangeWorkspace_1.listDeltas)(this.projectDir, changeId);
+    }
+    listChangeFeatures(changeId) {
+        return (0, ChangeWorkspace_1.listChangeFeatures)(this.projectDir, changeId);
+    }
+    readFile(absolutePath) {
+        return fs.existsSync(absolutePath) ? fs.readFileSync(absolutePath, "utf8") : null;
+    }
+    getPaths() {
+        return (0, ChangeWorkspace_1.paths)(this.projectDir);
+    }
+    executePlan(plan) {
+        const undo = [];
+        const restore = () => {
+            for (const step of undo.reverse()) {
+                try {
+                    if (step.type === "restore")
+                        fs.writeFileSync(step.file, step.contents, "utf8");
+                    else if (step.type === "unlink")
+                        fs.rmSync(step.file, { force: true });
+                    else if (step.type === "rename")
+                        fs.renameSync(step.from, step.to);
+                }
+                catch {
+                    // Best effort
+                }
+            }
+        };
+        try {
+            for (const write of plan.writes) {
+                fs.mkdirSync(path.dirname(write.file), { recursive: true });
+                if (fs.existsSync(write.file)) {
+                    undo.push({
+                        type: "restore",
+                        file: write.file,
+                        contents: fs.readFileSync(write.file, "utf8"),
+                    });
+                }
+                else {
+                    undo.push({ type: "unlink", file: write.file });
+                }
+                fs.writeFileSync(write.file, write.contents, "utf8");
+            }
+            for (const del of plan.deletes) {
+                if (fs.existsSync(del.file)) {
+                    undo.push({
+                        type: "restore",
+                        file: del.file,
+                        contents: fs.readFileSync(del.file, "utf8"),
+                    });
+                    fs.rmSync(del.file, { force: true });
+                }
+            }
+            if (plan.move) {
+                fs.mkdirSync(path.dirname(plan.move.to), { recursive: true });
+                fs.renameSync(plan.move.from, plan.move.to);
+                undo.push({ type: "rename", from: plan.move.to, to: plan.move.from });
+            }
+        }
+        catch (err) {
+            restore();
+            throw err;
+        }
+    }
+}
+exports.DiskProjectRepository = DiskProjectRepository;
+//# sourceMappingURL=DiskProjectRepository.js.map

package/dist/packages/core/src/infrastructure/DiskProjectRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiskProjectRepository.js","sourceRoot":"","sources":["../../../../../packages/core/src/infrastructure/DiskProjectRepository.ts"],"names":[],"mappings":"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"}

package/dist/packages/core/src/infrastructure/DiskRequirementGraphRepository.js

@@ -0,0 +1,124 @@
+"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.DiskRequirementGraphRepository = exports.CAPABILITIES_DIR = void 0;
+exports.readDeclaredDependencies = readDeclaredDependencies;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const RequirementGraph_1 = require("../domain/RequirementGraph");
+const SpecParser_1 = require("../domain/SpecParser");
+const TraceabilityFormat_1 = require("../domain/TraceabilityFormat");
+const ChangeWorkspace_1 = require("./ChangeWorkspace");
+// Where capability specs live is the change workspace's fact, stated once there.
+var ChangeWorkspace_2 = require("./ChangeWorkspace");
+Object.defineProperty(exports, "CAPABILITIES_DIR", { enumerable: true, get: function () { return ChangeWorkspace_2.CAPABILITIES_DIR; } });
+const REQ_ID = /^REQ-[A-Za-z0-9.]+$/;
+/**
+ * Read every capability spec and return what each requirement declares.
+ *
+ * A capability whose spec does not parse is `validate`'s problem to report,
+ * not this function's to crash on.
+ */
+function readDeclaredDependencies(projectDir) {
+    // The matrix first, then the capability specs on top: a spec is hand-written
+    // by the project, the matrix line was generated by the last `expand`, so the
+    // hand-written statement wins.
+    const declared = readMatrixDependencies(projectDir);
+    const root = path.join(projectDir, ChangeWorkspace_1.CAPABILITIES_DIR);
+    if (!fs.existsSync(root))
+        return declared;
+    for (const entry of fs.readdirSync(root, { withFileTypes: true })) {
+        if (!entry.isDirectory())
+            continue;
+        const specPath = path.join(root, entry.name, "spec.md");
+        if (!fs.existsSync(specPath))
+            continue;
+        for (const [id, deps] of readSpecDependencies(specPath))
+            declared[id] = deps;
+    }
+    return declared;
+}
+/**
+ * The dependencies a domain pack declared, as `expand` wrote them (B1).
+ *
+ * A pack's requirements do not arrive as capability specs — the capability
+ * document each pack ships is its own template, and the requirements themselves
+ * land in the traceability matrix. So a pack's `depends_on` is written beside
+ * the matrix and read back from there.
+ *
+ * A capability spec wins on a conflict: it is hand-written by the project,
+ * while the matrix line was generated by the last `expand`.
+ */
+function readMatrixDependencies(projectDir) {
+    const matrix = path.join(projectDir, "docs", "specs", "traceability.md");
+    if (!fs.existsSync(matrix))
+        return {};
+    try {
+        return (0, TraceabilityFormat_1.parseMatrixDependencies)(fs.readFileSync(matrix, "utf8"));
+    }
+    catch {
+        return {};
+    }
+}
+function readSpecDependencies(specPath) {
+    let parsed;
+    try {
+        parsed = (0, SpecParser_1.parseSpec)(fs.readFileSync(specPath, "utf8"));
+    }
+    catch {
+        return [];
+    }
+    const found = [];
+    for (const req of parsed.requirements ?? []) {
+        const id = req.id ? String(req.id).toUpperCase() : "";
+        if (!REQ_ID.test(id))
+            continue;
+        const raw = req.trace?.depends;
+        if (!raw)
+            continue;
+        const deps = (0, RequirementGraph_1.splitDependencies)(raw);
+        if (deps.length > 0)
+            found.push([id, deps]);
+    }
+    return found;
+}
+/** Reads the declarations straight off the project's capability specs. */
+class DiskRequirementGraphRepository {
+    readDeclaredDependencies(projectDir) {
+        return readDeclaredDependencies(projectDir);
+    }
+}
+exports.DiskRequirementGraphRepository = DiskRequirementGraphRepository;
+//# sourceMappingURL=DiskRequirementGraphRepository.js.map

package/dist/packages/core/src/infrastructure/DiskRequirementGraphRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiskRequirementGraphRepository.js","sourceRoot":"","sources":["../../../../../packages/core/src/infrastructure/DiskRequirementGraphRepository.ts"],"names":[],"mappings":"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"}

package/dist/packages/core/src/infrastructure/DiskTraceabilityRepository.js

@@ -0,0 +1,53 @@
+"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.DiskTraceabilityRepository = void 0;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+class DiskTraceabilityRepository {
+    readTraceability(projectDir) {
+        const tracePath = path.join(projectDir, "docs/specs/traceability.md");
+        if (!fs.existsSync(tracePath))
+            return null;
+        return fs.readFileSync(tracePath, "utf8");
+    }
+    writeTraceability(projectDir, content) {
+        const tracePath = path.join(projectDir, "docs/specs/traceability.md");
+        fs.mkdirSync(path.dirname(tracePath), { recursive: true });
+        fs.writeFileSync(tracePath, content, "utf8");
+    }
+}
+exports.DiskTraceabilityRepository = DiskTraceabilityRepository;
+//# sourceMappingURL=DiskTraceabilityRepository.js.map

package/dist/packages/core/src/infrastructure/DiskTraceabilityRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DiskTraceabilityRepository.js","sourceRoot":"","sources":["../../../../../packages/core/src/infrastructure/DiskTraceabilityRepository.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,4CAA8B;AAC9B,gDAAkC;AAGlC,MAAa,0BAA0B;IAC9B,gBAAgB,CAAC,UAAkB;QACxC,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,4BAA4B,CAAC,CAAC;QACtE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,OAAO,IAAI,CAAC;QAC3C,OAAO,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;IAEM,iBAAiB,CAAC,UAAkB,EAAE,OAAe;QAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,4BAA4B,CAAC,CAAC;QACtE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;IAC/C,CAAC;CACF;AAZD,gEAYC"}

package/dist/packages/core/src/infrastructure/GitContributionStager.js

@@ -0,0 +1,99 @@
+"use strict";
+/**
+ * Staging a contribution as a git branch.
+ *
+ * Clones the pack repository, branches from the version the project actually
+ * consumed — so the diff a maintainer sees is against the code the
+ * contribution was written on — writes the files, and commits. What those
+ * files say is domain; see `domain/PackContribution`.
+ */
+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.stageContribution = stageContribution;
+const fs = __importStar(require("node:fs"));
+const GitSafety_1 = require("../domain/GitSafety");
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+function git(args, cwd) {
+    const result = (0, node_child_process_1.spawnSync)("git", args, { cwd, encoding: "utf8" });
+    if (result.error)
+        throw new Error(`git ${args[0]} failed to run: ${result.error.message}`);
+    if (result.status !== 0) {
+        throw new Error(`git ${args.join(" ")} failed: ${result.stderr || result.stdout}`);
+    }
+    return result.stdout;
+}
+/**
+ * Clone the pack, branch, write the contribution, commit. Nothing leaves the
+ * machine — the caller is handed a branch and the command that would publish it.
+ */
+function stageContribution(repo, version, branch, files, outDir) {
+    const dir = outDir || fs.mkdtempSync(path.join(os.tmpdir(), "csda-contribute-"));
+    fs.mkdirSync(dir, { recursive: true });
+    // See `GitSafety`: `--` stops git reading a leading `-` as an option, and the
+    // check stops `ext::`, which a separator cannot.
+    git(["clone", "--quiet", "--", (0, GitSafety_1.assertSafeGitRepo)(repo, "pack repository"), dir], undefined);
+    // Branch from the version the project actually consumed, so the diff a
+    // maintainer sees is against the code the contribution was written on.
+    try {
+        git(["checkout", "--quiet", (0, GitSafety_1.assertSafeGitRef)(version, "pack version"), "--"], dir);
+    }
+    catch {
+        // A lockfile can pin a commit that is not a branch tip; detached HEAD is fine.
+    }
+    git(["checkout", "--quiet", "-b", branch], dir);
+    const written = [];
+    for (const f of files) {
+        const full = path.join(dir, f.file);
+        fs.mkdirSync(path.dirname(full), { recursive: true });
+        fs.writeFileSync(full, f.contents, "utf8");
+        written.push(f.file);
+    }
+    git(["add", "--", ...written], dir);
+    git([
+        "-c",
+        "user.name=csda",
+        "-c",
+        "user.email=csda@localhost",
+        "commit",
+        "--quiet",
+        "-m",
+        files[0].message || "Contribute requirements from a consuming project",
+    ], dir);
+    return { dir, branch, files: written };
+}
+// ── Command ───────────────────────────────────────────────────────────────────
+//# sourceMappingURL=GitContributionStager.js.map

package/dist/packages/core/src/infrastructure/GitContributionStager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitContributionStager.js","sourceRoot":"","sources":["../../../../../packages/core/src/infrastructure/GitContributionStager.ts"],"names":[],"mappings":"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"}

package/dist/packages/core/src/infrastructure/GitMergeDriver.js

@@ -0,0 +1,103 @@
+"use strict";
+/**
+ * Three-way merge primitive for `specops sync`.
+ *
+ * Given the common ancestor (`base` — what the pack rendered last sync),
+ * the working copy (`local` — what is in the project now, possibly
+ * hand-edited) and the new render (`incoming` — what the pack renders at
+ * the target version), produce a merged result.
+ *
+ * Delegates to `git merge-file`, which is always available wherever the
+ * CLI runs (the project is a git repo by construction). `git merge-file`
+ * exit codes: 0 = clean, N>0 = number of conflict regions, <0 = error.
+ *
+ * Pure-ish: writes only to a throwaway temp dir, never to the project.
+ */
+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.DEFAULT_LABELS = void 0;
+exports.threeWayMerge = threeWayMerge;
+const fs = __importStar(require("node:fs"));
+const os = __importStar(require("node:os"));
+const path = __importStar(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+exports.DEFAULT_LABELS = {
+    local: "local (your edits)",
+    base: "base (last sync)",
+    incoming: "incoming (new pack version)",
+};
+/**
+ * @returns {{ merged: string, conflict: boolean, conflicts: number }}
+ */
+function threeWayMerge(base, local, incoming, labels = {}) {
+    const lbl = { ...exports.DEFAULT_LABELS, ...labels };
+    const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "specops-merge-"));
+    try {
+        const localPath = path.join(tmpDir, "local");
+        const basePath = path.join(tmpDir, "base");
+        const incomingPath = path.join(tmpDir, "incoming");
+        fs.writeFileSync(localPath, local, "utf8");
+        fs.writeFileSync(basePath, base, "utf8");
+        fs.writeFileSync(incomingPath, incoming, "utf8");
+        const result = (0, node_child_process_1.spawnSync)("git", [
+            "merge-file",
+            "-p",
+            "-L",
+            lbl.local,
+            "-L",
+            lbl.base,
+            "-L",
+            lbl.incoming,
+            localPath,
+            basePath,
+            incomingPath,
+        ], { encoding: "utf8" });
+        if (result.error) {
+            throw new Error(`git merge-file failed to run: ${result.error.message}`);
+        }
+        if (typeof result.status !== "number" || result.status < 0) {
+            throw new Error(`git merge-file errored: ${result.stderr || "unknown error"}`);
+        }
+        return {
+            merged: result.stdout,
+            conflict: result.status > 0,
+            conflicts: result.status,
+        };
+    }
+    finally {
+        fs.rmSync(tmpDir, { recursive: true, force: true });
+    }
+}
+//# sourceMappingURL=GitMergeDriver.js.map