@rsaglobaltech/specgate 0.24.0 → 0.26.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/cli/commands/spec/DraftCommand.js

@@ -73,6 +73,7 @@ const DraftChecklist_1 = require("../../../../packages/core/src/domain/DraftChec
 const ChangeWorkspace_1 = require("../../../../packages/core/src/infrastructure/ChangeWorkspace");
 const ChangeTemplates_1 = require("../../../../packages/core/src/domain/ChangeTemplates");
 const IdsAcrossBranches_1 = require("../../../../packages/core/src/infrastructure/IdsAcrossBranches");
+const HarnessConfigFile_1 = require("../../../../packages/core/src/infrastructure/HarnessConfigFile");
 const DiskLanguageRepository_1 = require("../../../../packages/core/src/infrastructure/DiskLanguageRepository");
 const drafting_guide_1 = require("../../../draft/drafting-guide");
 const confined_agent_1 = require("../../../draft/confined-agent");
@@ -107,6 +108,7 @@ function usage() {
         "  --agent <cmd>    Your agent's command. It gets the drafting guide on standard input,\n" +
         "                   or in a file if the command contains {prompt_file}. Whatever it writes\n" +
         "                   outside the draft is undone.\n" +
+        "  --profile <name> The agent of that profile in .harness/profiles.yaml, instead of --agent.\n" +
         "  [--max-requirements <n>] [--project-dir <dir>] [--json]\n\n" +
         "The checklist (ADR-0029):\n" +
         "  D1 every requirement has a scenario          D5 a cited law or standard names its source\n" +
@@ -165,6 +167,8 @@ function parseArgs(argv) {
         }
         else if (a === "--agent")
             o.agent = value();
+        else if (a === "--profile")
+            o.profile = value();
         else if (a === "--new-brief")
             o.newBrief = true;
         else if (a === "--project-dir")
@@ -183,7 +187,10 @@ function parseArgs(argv) {
     if (o.check && o.module) {
         throw new Error("give a module or --check <change-id>, not both");
     }
-    if (o.checkBrief && (o.module || o.agent || o.newBrief)) {
+    if (o.profile && o.agent) {
+        throw new Error("give --agent or --profile, not both");
+    }
+    if (o.checkBrief && (o.module || o.agent || o.profile || o.newBrief)) {
         throw new Error("--check only checks the brief: run it on its own");
     }
     if (o.module && !ChangeWorkspace_1.CHANGE_ID_RE.test(o.module)) {
@@ -659,6 +666,18 @@ class DraftCommand extends command_1.BaseCommand {
             ]);
         }
         const opts = o;
+        if (opts.profile) {
+            try {
+                opts.agent = (0, HarnessConfigFile_1.resolveProfileAgent)((0, project_root_1.resolveProjectDir)(opts.projectDir), opts.profile);
+            }
+            catch (err) {
+                io0.usage({ draft: null }, [
+                    (0, diagnostics_1.error)("draft_profile", err.message, {
+                        fix: "Name a profile .harness/profiles.yaml declares, or pass --agent.",
+                    }),
+                ]);
+            }
+        }
         if (opts.checkBrief)
             return this.checkBrief(opts);
         if (opts.check)
@@ -1060,14 +1079,27 @@ class DraftCommand extends command_1.BaseCommand {
                 ]);
             }
             const listed = (0, DraftChecklist_1.briefModules)(brief.text);
+            // Drafts opened before this one and still unwritten stop growing once it
+            // takes the next ids: only the last range can (REQ-197).
+            const waiting = unwrittenDrafts(projectDir, `draft-${opts.module}`);
             const opened = openDraft(projectDir, opts.module, brief.rel, opts);
-            const notes = listed.length > 0 && !listed.includes(opts.module)
+            const ahead = waiting.length
                 ? [
-                    (0, diagnostics_1.info)("draft_module_not_in_brief", `${opts.module} is not among the brief's modules (${listed.join(", ")}).`, {
-                        fix: "Add it to `modules:` in the brief's front matter, so `specgate propose --from-brief` lists it.",
+                    (0, diagnostics_1.info)("draft_other_unwritten", `${waiting.join(", ")} ${waiting.length === 1 ? "is" : "are"} not written yet; ${opened.changeId} now holds the last id range, so ${waiting.length === 1 ? "it" : "they"} can no longer grow.`, {
+                        fix: `Write ${waiting[0]} first, or before opening the next module grow it with specgate draft ${waiting[0].replace(/^draft-/, "")} --reserve <n>.`,
                     }),
                 ]
                 : [];
+            const notes = [
+                ...ahead,
+                ...(listed.length > 0 && !listed.includes(opts.module)
+                    ? [
+                        (0, diagnostics_1.info)("draft_module_not_in_brief", `${opts.module} is not among the brief's modules (${listed.join(", ")}).`, {
+                            fix: "Add it to `modules:` in the brief's front matter, so `specgate propose --from-brief` lists it.",
+                        }),
+                    ]
+                    : []),
+            ];
             if (opts.agent)
                 return this.withAgent(opts, projectDir, brief.rel, opened.created);
             io.emit({
@@ -1322,4 +1354,12 @@ function writeBriefFindings(findings) {
             out.write(ui.fix(d.fix));
     }
 }
+/** Open drafts other than `except` whose deltas hold no requirement yet (REQ-197). */
+function unwrittenDrafts(projectDir, except) {
+    return (0, ChangeWorkspace_1.listChangeIds)(projectDir).filter((change) => {
+        if (!change.startsWith("draft-") || change === except)
+            return false;
+        return !(0, ChangeWorkspace_1.listDeltas)(projectDir, change).some((d) => /^###\s+Requirement:\s+REQ-\d+\s+[—–-]\s+[^<\s]/m.test(fs.readFileSync(d.file, "utf8")));
+    });
+}
 //# sourceMappingURL=DraftCommand.js.map