@rsaglobaltech/specgate 0.24.0 → 0.25.0

package/dist/scripts/cli/commands/spec/ClarifyCommands.js

@@ -0,0 +1,275 @@
+"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.BriefAddCommand = exports.AskCommand = exports.AnswerCommand = exports.QuestionsCommand = void 0;
+const project_root_1 = require("../../../lib/project-root");
+const diagnostics_1 = require("../../../lib/diagnostics");
+const agent_1 = require("../../../lib/agent");
+const command_1 = require("../../../lib/command");
+const harness_events_1 = require("../../../lib/harness-events");
+const clarification_1 = require("../../../lib/clarification");
+const brief_add_1 = require("../../../lib/brief-add");
+const HarnessEvents_1 = require("../../../../packages/core/src/domain/HarnessEvents");
+const ui = __importStar(require("../../../lib/ui"));
+function parse(argv, io, shape, command) {
+    const out = { words: [], dir: ".", reviewed: false };
+    for (let i = 0; i < argv.length; i += 1) {
+        const a = argv[i];
+        if (a === "--project-dir")
+            out.dir = argv[++i] || ".";
+        else if (a === "--change")
+            out.change = argv[++i];
+        else if (a === "--reviewed")
+            out.reviewed = true;
+        else if (a === "--json")
+            continue;
+        else if (a.startsWith("-")) {
+            io.usage(shape, [
+                (0, diagnostics_1.error)("unknown_flag", `Unknown flag for ${command}: ${a}`, {
+                    fix: `specgate ${command} --help`,
+                }),
+            ]);
+        }
+        else
+            out.words.push(a);
+    }
+    return out;
+}
+function project(dir, io, shape) {
+    try {
+        return (0, project_root_1.resolveProjectDir)(dir);
+    }
+    catch (err) {
+        return io.usage(shape, [
+            (0, diagnostics_1.error)("project_not_found", err.message, {
+                fix: "Run from inside a spec-driven project, or pass --project-dir.",
+            }),
+        ]);
+    }
+}
+class QuestionsCommand extends command_1.BaseCommand {
+    execute() {
+        const argv = this.args;
+        if (argv.includes("--help") || argv.includes("-h")) {
+            process.stdout.write("Usage:\n  specgate questions [--project-dir <path>] [--json]\n\n" +
+                "Everything waiting for an answer: the open questions of every open change and of\n" +
+                "docs/specs/questions.md, with what each blocks, and the requirements in\n" +
+                "Needs Clarification no open question names. Answer with specgate answer.\n");
+            process.exit(0);
+        }
+        const shape = { questions: null };
+        const io = (0, agent_1.agentIo)((0, agent_1.wantsJson)(argv));
+        const p = parse(argv, io, shape, "questions");
+        const dir = project(p.dir, io, shape);
+        const w = (0, clarification_1.waiting)(dir);
+        io.emit({
+            questions: {
+                open: w.questions.map((q) => ({
+                    id: q.id,
+                    change: q.change,
+                    text: q.text,
+                    blocks: q.blocks,
+                    file: q.file,
+                    line: q.line,
+                })),
+                waitingWithoutQuestion: w.requirements,
+            },
+        }, () => {
+            process.stdout.write(ui.header("questions"));
+            if (w.questions.length === 0 && w.requirements.length === 0) {
+                process.stdout.write(ui.ok("Nothing waits for an answer.") + "\n");
+                return;
+            }
+            for (const q of w.questions) {
+                process.stdout.write(`  ${q.id}  ${ui.muted(q.change)}  ${q.text}\n` +
+                    `      ${ui.muted(q.blocks.length ? `blocks ${q.blocks.join(", ")}` : "blocks nothing")}` +
+                    `  ${ui.muted(`→ specgate answer ${q.id} "…"${q.change !== "project" ? ` --change ${q.change}` : ""}`)}\n`);
+            }
+            if (w.requirements.length) {
+                process.stdout.write(`\n  ${ui.muted("Needs Clarification with no open question:")}\n`);
+                for (const r of w.requirements) {
+                    process.stdout.write(`  ${r.requirement}  ${r.title}  ${ui.muted(`→ specgate ask ${r.requirement} "…"`)}\n`);
+                }
+            }
+        });
+    }
+}
+exports.QuestionsCommand = QuestionsCommand;
+class AnswerCommand extends command_1.BaseCommand {
+    execute() {
+        const argv = this.args;
+        if (argv.includes("--help") || argv.includes("-h")) {
+            process.stdout.write('Usage:\n  specgate answer <Q> "<answer>" [--change <id>] [--project-dir <path>] [--json]\n' +
+                "  specgate answer <Q> --reviewed [--change <id>]\n\n" +
+                "Writes the answer into the question's row, adds it to assumptions.md as an\n" +
+                "assumption to review, and lists the requirements to revise. The draft checklist\n" +
+                "waits until --reviewed says the requirements reflect it. --change picks the\n" +
+                "change when more than one has that question.\n");
+            process.exit(0);
+        }
+        const shape = { answer: null };
+        const io = (0, agent_1.agentIo)((0, agent_1.wantsJson)(argv));
+        const p = parse(argv, io, shape, "answer");
+        const [id, ...rest] = p.words;
+        const text = rest.join(" ").trim();
+        if (!id || (!p.reviewed && !text)) {
+            io.usage(shape, [
+                (0, diagnostics_1.error)("missing_argument", 'answer needs a question id and the answer: specgate answer Q4 "…"', {
+                    fix: "specgate questions lists the open ones.",
+                }),
+            ]);
+        }
+        const dir = project(p.dir, io, shape);
+        if (p.reviewed) {
+            const r = (0, clarification_1.reviewed)(dir, id, p.change);
+            if (!r.ok)
+                io.fail(shape, [(0, diagnostics_1.error)(r.code, r.message, { fix: "specgate questions" })]);
+            else
+                io.emit({ answer: { question: id, change: r.change, reviewed: r.ids } }, () => process.stdout.write(ui.ok(`${r.ids.join(", ")} decided — ${id}'s answer is in the specification.`) + "\n"));
+            return;
+        }
+        const r = (0, clarification_1.answer)(dir, id, text, p.change);
+        if (!r.ok) {
+            io.fail(shape, [
+                (0, diagnostics_1.error)(r.code, r.message, {
+                    fix: r.changes && r.changes.length > 1 ? `--change ${r.changes[0]}` : "specgate questions",
+                }),
+            ]);
+            return;
+        }
+        io.emit({
+            answer: {
+                question: r.question,
+                change: r.change,
+                assumption: r.assumption,
+                revise: r.revise,
+            },
+        }, () => process.stdout.write(ui.ok(`${r.question} answered in ${r.change}; ${r.assumption} added to review.`) +
+            "\n" +
+            (r.revise.length
+                ? `  Revise ${r.revise.join(", ")} so they say it, then: specgate answer ${r.question} --reviewed\n`
+                : `  Then: specgate answer ${r.question} --reviewed\n`)));
+    }
+}
+exports.AnswerCommand = AnswerCommand;
+class AskCommand extends command_1.BaseCommand {
+    execute() {
+        const argv = this.args;
+        if (argv.includes("--help") || argv.includes("-h")) {
+            process.stdout.write('Usage:\n  specgate ask <REQ> "<question>" [--project-dir <path>] [--json]\n\n' +
+                "Asks instead of guessing: adds the question to the change that defines the\n" +
+                "requirement (docs/specs/questions.md when a capability does) and sets it\n" +
+                "Needs Clarification. Inside the harness it only records the question: the\n" +
+                "harness stops the requirement and writes it into the project.\n");
+            process.exit(0);
+        }
+        const shape = { ask: null };
+        const io = (0, agent_1.agentIo)((0, agent_1.wantsJson)(argv));
+        const p = parse(argv, io, shape, "ask");
+        const [req, ...rest] = p.words;
+        const text = rest.join(" ").trim();
+        if (!req || !/^REQ-\d+$/.test(req) || !text) {
+            io.usage(shape, [
+                (0, diagnostics_1.error)("missing_argument", 'ask needs a requirement and the question: specgate ask REQ-007 "…"', {
+                    fix: "specgate ask --help",
+                }),
+            ]);
+        }
+        // Inside the harness the agent may not edit the specification: the
+        // question becomes an event, and the harness writes it (REQ-189).
+        const eventsFile = process.env[HarnessEvents_1.EVENTS_FILE_VAR];
+        if (eventsFile && process.env[HarnessEvents_1.EVENTS_REQ_VAR]) {
+            (0, harness_events_1.appendEvent)(eventsFile, { type: "question", text }, process.env[HarnessEvents_1.EVENTS_REQ_VAR] || req, Number(process.env[HarnessEvents_1.EVENTS_ATTEMPT_VAR]) || undefined);
+            io.emit({ ask: { requirement: req, recorded: "harness" } }, () => process.stdout.write(ui.ok(`Question recorded for ${req}. Stop here: the harness asks the person and ends this attempt.`) + "\n"));
+            return;
+        }
+        const dir = project(p.dir, io, shape);
+        const r = (0, clarification_1.ask)(dir, req, text);
+        if (!r.ok) {
+            io.fail(shape, [
+                (0, diagnostics_1.error)(r.code, r.message, { fix: "specgate status lists the requirements." }),
+            ]);
+            return;
+        }
+        io.emit({ ask: { requirement: req, change: r.change, question: r.question, file: r.file } }, () => process.stdout.write(ui.ok(`${r.question} added to ${r.file}; ${req} is Needs Clarification.`) +
+            "\n" +
+            `  Answer with: specgate answer ${r.question} "…"${r.change !== "project" ? ` --change ${r.change}` : ""}\n`));
+    }
+}
+exports.AskCommand = AskCommand;
+class BriefAddCommand extends command_1.BaseCommand {
+    execute() {
+        const argv = this.args;
+        if (argv.includes("--help") || argv.includes("-h")) {
+            process.stdout.write('Usage:\n  specgate brief add <module> "<text>" [--project-dir <path>] [--json]\n\n' +
+                "A new requirement for a module the brief lists: appends the line to the brief\n" +
+                "under Additions, and adds a requirement quoting it to the module's open change\n" +
+                "(draft-<module> or <module>-additions, created when there is none). Its title\n" +
+                "and statement are yours to write; specgate draft --check asks for them.\n");
+            process.exit(0);
+        }
+        const shape = { brief: null };
+        const io = (0, agent_1.agentIo)((0, agent_1.wantsJson)(argv));
+        const p = parse(argv, io, shape, "brief add");
+        const [module, ...rest] = p.words;
+        const text = rest.join(" ").trim();
+        if (!module || !text) {
+            io.usage(shape, [
+                (0, diagnostics_1.error)("missing_argument", 'brief add needs a module and the text: specgate brief add fichas "…"', {
+                    fix: "specgate brief add --help",
+                }),
+            ]);
+        }
+        const dir = project(p.dir, io, shape);
+        const r = (0, brief_add_1.briefAdd)(dir, module, text, new Date().toISOString().slice(0, 10));
+        if (!r.ok) {
+            io.fail(shape, [(0, diagnostics_1.error)(r.code, r.message, { fix: r.fix })]);
+            return;
+        }
+        io.emit({
+            brief: {
+                module,
+                change: r.change,
+                requirement: r.requirement,
+                created: r.created,
+                delta: r.delta,
+            },
+        }, () => process.stdout.write(ui.ok(`${r.requirement} added to ${r.change}${r.created ? " (new change)" : ""}.`) +
+            "\n" +
+            `  Write its title, statement and a scenario in ${r.delta}, then: specgate draft --check ${r.change}\n`));
+    }
+}
+exports.BriefAddCommand = BriefAddCommand;
+//# sourceMappingURL=ClarifyCommands.js.map

package/dist/scripts/cli/commands/spec/ClarifyCommands.js.map

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

package/dist/scripts/harness/prompt.js

@@ -18,6 +18,8 @@ const HARNESS_RULES = [
     ...(instructions_1.STAGES?.apply?.rules ?? []).filter((r) => !/is the queue|Close each requirement with `specgate apply/.test(r)),
     "Do not run `specgate` yourself: when you finish, the harness runs the gate and marks the " +
         "requirement. The `specgate` on your PATH may not even be this project's version.",
+    // REQ-189: the one command an agent runs — asking beats guessing.
+    'The one exception: when the requirement leaves a decision open that its statement, scenarios and assumptions do not settle, do not guess. Run `specgate ask <REQ> "<your question>"` and stop: the harness ends the attempt without spending another and asks the person.',
 ];
 function buildPrompt(req, projectDir, opts = {}) {
     const repo = new DiskHarnessConfigRepository_1.DiskHarnessConfigRepository();

package/dist/scripts/harness/prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../scripts/harness/prompt.ts"],"names":[],"mappings":";AAAA;;GAEG;;AA2BH,kCAYC;AArCD,yDAAgD;AAChD,oHAAiH;AACjH,+GAA4G;AAQ5G;;;;;;GAMG;AACH,MAAM,aAAa,GAAa;IAC9B,GAAG,CAAC,qBAAM,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,CACpC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,0DAA0D,CAAC,IAAI,CAAC,CAAC,CAAC,CAC3E;IACD,2FAA2F;QACzF,kFAAkF;CACrF,CAAC;AAEF,SAAgB,WAAW,CACzB,GAA4B,EAC5B,UAAkB,EAClB,OAAsB,EAAE;IAExB,MAAM,IAAI,GAAG,IAAI,yDAA2B,EAAE,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAI,uDAA0B,CAAC,IAAI,CAAC,CAAC;IAErD,OAAO,OAAO,CAAC,OAAO,CAAC,GAAwB,EAAE,UAAU,EAAE;QAC3D,GAAG,IAAI;QACP,UAAU,EAAE,aAAa;KAC1B,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../scripts/harness/prompt.ts"],"names":[],"mappings":";AAAA;;GAEG;;AA6BH,kCAYC;AAvCD,yDAAgD;AAChD,oHAAiH;AACjH,+GAA4G;AAQ5G;;;;;;GAMG;AACH,MAAM,aAAa,GAAa;IAC9B,GAAG,CAAC,qBAAM,EAAE,KAAK,EAAE,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,CACpC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,0DAA0D,CAAC,IAAI,CAAC,CAAC,CAAC,CAC3E;IACD,2FAA2F;QACzF,kFAAkF;IACpF,kEAAkE;IAClE,2QAA2Q;CAC5Q,CAAC;AAEF,SAAgB,WAAW,CACzB,GAA4B,EAC5B,UAAkB,EAClB,OAAsB,EAAE;IAExB,MAAM,IAAI,GAAG,IAAI,yDAA2B,EAAE,CAAC;IAC/C,MAAM,OAAO,GAAG,IAAI,uDAA0B,CAAC,IAAI,CAAC,CAAC;IAErD,OAAO,OAAO,CAAC,OAAO,CAAC,GAAwB,EAAE,UAAU,EAAE;QAC3D,GAAG,IAAI;QACP,UAAU,EAAE,aAAa;KAC1B,CAAC,CAAC;AACL,CAAC"}

package/dist/scripts/lib/brief-add.js

@@ -0,0 +1,197 @@
+"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.briefAdd = briefAdd;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const DraftChecklist_1 = require("../../packages/core/src/domain/DraftChecklist");
+const ChangeWorkspace_1 = require("../../packages/core/src/infrastructure/ChangeWorkspace");
+const project_root_1 = require("./project-root");
+function briefFile(projectDir) {
+    for (const rel of [path.join("docs", "brief.md"), "brief.md"]) {
+        const file = path.join(projectDir, rel);
+        if (fs.existsSync(file))
+            return file;
+    }
+    return null;
+}
+function rangeOf(changeDir) {
+    try {
+        const yaml = fs.readFileSync(path.join(changeDir, "change.yaml"), "utf8");
+        const m = /req_range:\s*\[\s*REQ-(\d+)\s*,\s*REQ-(\d+)\s*\]/.exec(yaml);
+        return m ? [Number(m[1]), Number(m[2])] : null;
+    }
+    catch {
+        return null;
+    }
+}
+function idsIn(changeDir) {
+    const used = new Set();
+    const walk = (dir) => {
+        let entries = [];
+        try {
+            entries = fs.readdirSync(dir, { withFileTypes: true });
+        }
+        catch {
+            return;
+        }
+        for (const e of entries) {
+            const full = path.join(dir, e.name);
+            if (e.isDirectory())
+                walk(full);
+            else if (e.name.endsWith(".md")) {
+                for (const m of fs.readFileSync(full, "utf8").matchAll(/###\s+Requirement:\s+REQ-(\d+)/g)) {
+                    used.add(Number(m[1]));
+                }
+            }
+        }
+    };
+    walk(path.join(changeDir, "specs"));
+    return used;
+}
+const pad = (n) => `REQ-${String(n).padStart(3, "0")}`;
+/** The block `brief add` writes: a requirement whose title and statement are the author's to write. */
+function block(id, text) {
+    return [
+        `### Requirement: ${id} — <a short name>`,
+        "",
+        "The system SHALL <what it does, from the brief line below>.",
+        "",
+        `> Brief: "${text.replace(/"/g, "'")}"`,
+        "",
+        "<!-- specgate:trace status=Draft kind=functional -->",
+        "",
+    ].join("\n");
+}
+function addToDelta(file, capability, req) {
+    if (!fs.existsSync(file)) {
+        fs.mkdirSync(path.dirname(file), { recursive: true });
+        fs.writeFileSync(file, `# Delta — ${capability}\n\n## ADDED Requirements\n\n${req}`, "utf8");
+        return;
+    }
+    const text = fs.readFileSync(file, "utf8").replace(/\r\n/g, "\n");
+    const at = text.indexOf("## ADDED Requirements");
+    if (at === -1) {
+        fs.writeFileSync(file, `${text.replace(/\n*$/, "\n")}\n## ADDED Requirements\n\n${req}`, "utf8");
+        return;
+    }
+    const after = text.slice(at + 3);
+    const next = after.search(/^## /m);
+    const end = next === -1 ? text.length : at + 3 + next;
+    const before = text.slice(0, end).replace(/\n*$/, "\n\n");
+    fs.writeFileSync(file, `${before}${req}${next === -1 ? "" : `\n${text.slice(end)}`}`, "utf8");
+}
+function briefAdd(projectDir, module, text, today) {
+    const brief = briefFile(projectDir);
+    if (!brief) {
+        return {
+            ok: false,
+            code: "brief_not_found",
+            message: "No brief: neither docs/brief.md nor brief.md exists.",
+            fix: "Write the brief first; specgate draft explains what it needs.",
+        };
+    }
+    const modules = (0, DraftChecklist_1.briefModules)(fs.readFileSync(brief, "utf8"));
+    if (!modules.includes(module)) {
+        return {
+            ok: false,
+            code: "brief_module_unknown",
+            message: `The brief lists no module "${module}". Its modules: ${modules.join(", ") || "none"}.`,
+            fix: "Use one of them, or add the module to the brief's front matter.",
+        };
+    }
+    const open = (0, ChangeWorkspace_1.listChangeIds)(projectDir);
+    let change = [`draft-${module}`, `${module}-additions`].find((c) => open.includes(c));
+    let created = false;
+    if (!change) {
+        change = `${module}-additions`;
+        const r = (0, node_child_process_1.spawnSync)(process.execPath, [
+            path.join((0, project_root_1.findCliRoot)(__dirname), "bin", "specgate.js"),
+            "change",
+            "new",
+            change,
+            "--reserve",
+            "3",
+            "--project-dir",
+            projectDir,
+            "--json",
+        ], { cwd: projectDir, encoding: "utf8" });
+        if (r.status !== 0) {
+            return {
+                ok: false,
+                code: "brief_change_not_created",
+                message: `Could not create ${change}: ${(r.stdout + r.stderr).trim().split("\n").pop()}`,
+                fix: `specgate change new ${change}`,
+            };
+        }
+        created = true;
+    }
+    const dir = path.join(projectDir, "docs", "specs", "changes", change);
+    const range = rangeOf(dir);
+    const used = idsIn(dir);
+    let id = null;
+    if (range) {
+        for (let n = range[0]; n <= range[1]; n += 1) {
+            if (!used.has(n)) {
+                id = n;
+                break;
+            }
+        }
+    }
+    if (id === null) {
+        return {
+            ok: false,
+            code: "brief_range_used_up",
+            message: `${change} has no free id left in its range${range ? ` ${pad(range[0])}…${pad(range[1])}` : ""}.`,
+            fix: `Grow it with specgate draft --reserve <n> when it is the last open draft, or open another change.`,
+        };
+    }
+    const delta = path.join(dir, "specs", module, "spec.md");
+    addToDelta(delta, module, block(pad(id), text));
+    const raw = fs.readFileSync(brief, "utf8");
+    const line = `- ${module} (${today}): ${text}`;
+    fs.writeFileSync(brief, /^## Additions\s*$/m.test(raw)
+        ? `${raw.replace(/\n*$/, "\n")}${line}\n`
+        : `${raw.replace(/\n*$/, "\n")}\n## Additions\n\n${line}\n`, "utf8");
+    return {
+        ok: true,
+        change,
+        requirement: pad(id),
+        created,
+        delta: path.relative(projectDir, delta).split(path.sep).join("/"),
+    };
+}
+//# sourceMappingURL=brief-add.js.map

package/dist/scripts/lib/brief-add.js.map

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