@rsaglobaltech/specgate 0.17.10 → 0.18.0

package/dist/scripts/draft/brief-setup.js

@@ -0,0 +1,363 @@
+"use strict";
+/**
+ * The brief's front matter: what it is for, how to write it, and what is
+ * wrong with one.
+ *
+ * `specgate draft` needs four facts the brief rarely states in a form a tool
+ * can read: the product, where people use it, who uses it where, and the
+ * pieces to draft one at a time. The user who tried the first version did
+ * not know who was meant to write them, or how (#95). So this module holds
+ * everything `draft` tells a person about them — the explanation, the
+ * template, the guide an agent follows to propose them — and checks a front
+ * matter in plain words, each problem with its fix.
+ *
+ * The parsing is the checklist's own (`actorSurfaces`, `briefModules`), so a
+ * front matter this module accepts is one the checklist can read.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BRIEF_SETUP_PASTE = exports.BRIEF_SETUP_FILE = exports.BRIEF_TEMPLATE = exports.FRONT_MATTER_EXAMPLE = exports.SURFACES = void 0;
+exports.frontMatter = frontMatter;
+exports.briefBody = briefBody;
+exports.checkFrontMatter = checkFrontMatter;
+exports.frontMatterExplanation = frontMatterExplanation;
+exports.noBriefExplanation = noBriefExplanation;
+exports.briefSetupGuide = briefSetupGuide;
+exports.briefSetupPrompt = briefSetupPrompt;
+const DraftChecklist_1 = require("../../packages/core/src/domain/DraftChecklist");
+/** The places D3 knows how to check: an HTTP call, or a screen. */
+exports.SURFACES = ["api", "web", "mobile", "desktop"];
+const FRONT = /^---\r?\n([\s\S]*?)\r?\n---[ \t]*(?:\r?\n|$)/;
+/** The YAML between the leading `---` lines, or null. */
+function frontMatter(brief) {
+    const m = FRONT.exec(brief);
+    return m ? m[1] : null;
+}
+/** Everything after the front matter, without the blank lines that follow it. */
+function briefBody(brief) {
+    const m = FRONT.exec(brief);
+    return (m ? brief.slice(m[0].length) : brief).replace(/^(?:[ \t]*\r?\n)+/, "");
+}
+const uncomment = (fm) => fm
+    .split("\n")
+    .filter((l) => !/^\s*#/.test(l))
+    .join("\n");
+function field(fm, name) {
+    const m = new RegExp(`^${name}:[ \\t]*(.*)$`, "m").exec(uncomment(fm));
+    return m ? m[1].trim() : null;
+}
+function list(value) {
+    const m = /^\[([^\]]*)\]/.exec(value || "");
+    return m
+        ? m[1]
+            .split(",")
+            .map((s) => s.trim())
+            .filter(Boolean)
+        : [];
+}
+const placeholder = (v) => /<[^>]+>/.test(v);
+const kebab = (s) => s
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "-")
+    .replace(/^-|-$/g, "");
+/** What is wrong with a front matter, in plain words. Empty when it is usable. */
+function checkFrontMatter(brief) {
+    const fm = frontMatter(brief);
+    if (fm === null)
+        return [];
+    const text = uncomment(fm);
+    const out = [];
+    const known = (s) => exports.SURFACES.includes(s);
+    const surfaceList = exports.SURFACES.join(", ");
+    const product = field(fm, "product");
+    if (!product) {
+        out.push({
+            code: "brief_no_product",
+            message: "There is no `product:` line.",
+            fix: "Add one with the product in a few words, e.g. `product: Lingo — online lessons for a language school`.",
+        });
+    }
+    else if (placeholder(product)) {
+        out.push({
+            code: "brief_placeholder",
+            message: `\`product:\` still says ${product}.`,
+            fix: "Replace it with your product in a few words.",
+        });
+    }
+    const surfaces = list(field(fm, "surfaces"));
+    const unfilled = surfaces.filter(placeholder);
+    if (unfilled.length > 0) {
+        out.push({
+            code: "brief_placeholder",
+            message: `\`surfaces:\` still says ${unfilled.join(", ")}.`,
+            fix: `Use the places people reach the product: ${surfaceList}.`,
+        });
+    }
+    for (const s of surfaces.filter((x) => !placeholder(x))) {
+        if (!known(s.toLowerCase())) {
+            out.push({
+                code: "brief_unknown_surface",
+                message: `\`surfaces:\` names "${s}", which Specgate cannot check.`,
+                fix: `Use ${surfaceList}. A tablet or a kiosk is \`web\` or \`mobile\`; another system calling yours is \`api\`.`,
+            });
+        }
+    }
+    // Every `name:` is an actor; the checklist only reads `{ name: X, surfaces: [..] }`.
+    const named = [...text.matchAll(/\bname:\s*([^,}\n]+)/g)].map((m) => m[1].trim());
+    const actors = (0, DraftChecklist_1.actorSurfaces)(brief);
+    if (named.length === 0) {
+        out.push({
+            code: "brief_no_actors",
+            message: "There is no `actors:` list.",
+            fix: "Name everyone who uses the product and where: `- { name: Student, surfaces: [web, mobile] }`.",
+        });
+    }
+    for (const name of named) {
+        if (placeholder(name)) {
+            out.push({
+                code: "brief_placeholder",
+                message: `An actor is still called ${name}.`,
+                fix: "Name the person or system, e.g. Teacher, Student, Payment provider.",
+            });
+            continue;
+        }
+        const theirs = actors.get(name.toLowerCase());
+        if (!theirs || theirs.length === 0) {
+            out.push({
+                code: "brief_actor_without_surfaces",
+                message: `${name} has no surfaces.`,
+                fix: `Write it as \`- { name: ${name}, surfaces: [web] }\`, with every place ${name} uses.`,
+            });
+            continue;
+        }
+        for (const s of theirs) {
+            if (placeholder(s)) {
+                out.push({
+                    code: "brief_placeholder",
+                    message: `${name}'s surfaces still say ${s}.`,
+                    fix: `Use ${surfaceList}.`,
+                });
+            }
+            else if (!known(s)) {
+                out.push({
+                    code: "brief_unknown_surface",
+                    message: `${name} uses "${s}", which Specgate cannot check.`,
+                    fix: `Use ${surfaceList}. A tablet or a kiosk is \`web\` or \`mobile\`.`,
+                });
+            }
+            else if (surfaces.length > 0 && !surfaces.map((x) => x.toLowerCase()).includes(s)) {
+                out.push({
+                    code: "brief_surface_not_in_product",
+                    message: `${name} uses ${s}, but \`surfaces:\` does not list it.`,
+                    fix: `Add ${s} to \`surfaces:\`, or take it off ${name}.`,
+                });
+            }
+        }
+    }
+    const modules = (0, DraftChecklist_1.briefModules)(brief);
+    if (modules.length === 0) {
+        out.push({
+            code: "brief_no_modules",
+            message: "There is no `modules:` list, or it is empty.",
+            fix: "List the pieces to build, in order: `modules: [courses, lessons, exercises]`.",
+        });
+    }
+    const unnamed = modules.filter(placeholder);
+    if (unnamed.length > 0) {
+        out.push({
+            code: "brief_placeholder",
+            message: `\`modules:\` still says ${unnamed.join(", ")}.`,
+            fix: "Name the pieces of the product you will build, e.g. courses, lessons, exercises.",
+        });
+    }
+    const seen = new Set();
+    for (const m of modules.filter((x) => !placeholder(x))) {
+        if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(m)) {
+            out.push({
+                code: "brief_module_name",
+                message: `The module "${m}" has spaces, capitals or symbols.`,
+                fix: `Write it as ${kebab(m) || "lowercase-words"} — it becomes a folder and a command: specgate draft ${kebab(m) || "<module>"}.`,
+            });
+        }
+        else if (seen.has(m)) {
+            out.push({
+                code: "brief_module_twice",
+                message: `The module "${m}" is listed twice.`,
+                fix: "Keep one.",
+            });
+        }
+        seen.add(m);
+    }
+    return out;
+}
+/** The front matter to paste, with every field explained beside an example. */
+exports.FRONT_MATTER_EXAMPLE = [
+    "---",
+    "product: Lingo — online lessons for a language school",
+    "surfaces: [api, web, mobile]",
+    "actors:",
+    "  - { name: Teacher, surfaces: [api, web] }",
+    "  - { name: Student, surfaces: [api, web, mobile] }",
+    "modules: [courses, lessons, exercises, progress]",
+    "---",
+].join("\n");
+/** What `specgate draft` prints when the brief has no front matter. */
+function frontMatterExplanation(brief) {
+    return [
+        `  Your brief has no front matter yet: four fields at the very top of ${brief}`,
+        "  that tell Specgate what to draft, and what to check each draft against.",
+        "  Your text below them stays exactly as it is.",
+        "",
+        "  product   What you are building, in a few words.",
+        "            product: Lingo — online lessons for a language school",
+        "",
+        `  surfaces  Where people reach it. Any of: ${exports.SURFACES.join(", ")}.`,
+        "            api means another program calls it; web, mobile and desktop are screens.",
+        "            surfaces: [api, web, mobile]",
+        "",
+        "  actors    Everyone who uses it, and where. Each gets a scenario on each of",
+        "            their surfaces — so no screen is forgotten. (In the first pilot every",
+        "            requirement was done and nobody could use the product: there was",
+        "            not a single screen.) Only people and systems your brief mentions.",
+        "            actors:",
+        "              - { name: Teacher, surfaces: [api, web] }",
+        "              - { name: Student, surfaces: [api, web, mobile] }",
+        "",
+        "  modules   The pieces to specify and build, in the order you will build them.",
+        "            Each small enough to review in one sitting — 25 requirements at",
+        "            most. Lowercase words with dashes; each becomes `specgate draft <module>`.",
+        "            modules: [courses, lessons, exercises, progress]",
+        "",
+        "  The whole block, to paste at the top and change:",
+        "",
+        ...exports.FRONT_MATTER_EXAMPLE.split("\n").map((l) => `    ${l}`),
+        "",
+    ].join("\n");
+}
+/** What a good brief is, for a person who has none yet. */
+function noBriefExplanation(brief) {
+    return [
+        `  No brief yet. Specgate drafts your specification from a brief: ${brief}.`,
+        "",
+        "  A brief is whatever says what the product must do — your own plan, a",
+        "  client's email, meeting notes. Any markdown. Paste it as it is: Specgate",
+        "  never rewrites it, and checks every draft against its words.",
+        "",
+        "  A good brief says:",
+        "    · what the product is, and for whom",
+        "    · who uses it, and where — on the web, on a phone, through an API",
+        "    · what each of them must be able to do",
+        "    · the rules and numbers you already know — prices, limits, deadlines",
+        "    · what you don't know yet — those become questions, not guesses",
+        "    · what is out of scope",
+        "",
+        "  Already have one?  Save it as docs/brief.md, then  specgate draft",
+        "  Starting fresh?    specgate draft --new-brief   writes one to fill in",
+        "",
+    ].join("\n");
+}
+/** `docs/brief.md` from `specgate draft --new-brief`. */
+exports.BRIEF_TEMPLATE = `---
+# The product, in a few words.
+# Example: Lingo — online lessons for a language school
+product: <your product>
+# Where people reach it. Any of: api, web, mobile, desktop.
+# api means another program calls it; the others are screens.
+# Example: [api, web, mobile]
+surfaces: [<surface>, <surface>]
+# Everyone who uses it, and where. Each gets a scenario on each of their
+# surfaces, so no screen is forgotten. Example:
+#   - { name: Teacher, surfaces: [api, web] }
+#   - { name: Student, surfaces: [api, web, mobile] }
+actors:
+  - { name: <Actor>, surfaces: [<surface>] }
+# The pieces to specify and build, in the order you will build them, each
+# small enough to review in one sitting. Lowercase words with dashes.
+# Example: [courses, lessons, exercises, progress]
+modules: [<first-module>, <second-module>]
+---
+
+# <your product>
+
+## What the product is
+
+<!-- Two or three sentences: what it does, and for whom. -->
+
+## Who uses it and how
+
+<!-- Each kind of person, or system, and where: on the web, on a phone, through an API. -->
+
+## What each one must be able to do
+
+<!-- For each of them, the things they do, in their own words. A line each is enough. -->
+
+## Rules and numbers you already know
+
+<!-- Prices, limits, deadlines, opening hours. Only real ones: if you are not sure, leave it out. -->
+
+## What you don't know yet
+
+<!-- Open questions. Each becomes a question for the client instead of a guess. -->
+
+## Out of scope
+
+<!-- What the product will not do, at least for now. -->
+`;
+/** Where the guide for an agent proposing the front matter is written. */
+exports.BRIEF_SETUP_FILE = "docs/specs/BRIEF-SETUP.md";
+/** The guide an agent follows to propose a front matter. */
+function briefSetupGuide(brief) {
+    return [
+        "# Propose the brief's front matter",
+        "",
+        `Read \`${brief}\` and add a front matter at its very top: the lines between`,
+        "two `---` that tell Specgate what to draft. A person reviews what you write.",
+        "",
+        "## The rules",
+        "",
+        `- **Change nothing below the front matter.** The brief is the client's words;`,
+        "  if a single character of it changes, your work is undone.",
+        "- **Only what the brief states.** Never invent an actor, a surface or a module",
+        "  the brief does not support. When you are unsure, still propose it, with a",
+        "  `# check: …` comment on the line above saying what is uncertain.",
+        `- Write only \`${brief}\`. Anything else you write is undone.`,
+        "",
+        "## The fields",
+        "",
+        "```yaml",
+        "---",
+        "product: <the product, in a few words>",
+        `surfaces: [<where people reach it: ${exports.SURFACES.join(", ")}>]`,
+        "actors:",
+        "  - { name: <a person or system the brief names>, surfaces: [<where they use it>] }",
+        "modules: [<pieces to build, in build order>]",
+        "---",
+        "```",
+        "",
+        `- \`surfaces\`: only ${exports.SURFACES.join(", ")}. \`api\` means another program calls`,
+        "  the product; `web`, `mobile` and `desktop` are screens.",
+        "- `actors`: one line each, in exactly that `{ name: …, surfaces: [...] }` form.",
+        "  Every surface of an actor is also in `surfaces`.",
+        "- `modules`: lowercase words with dashes. In the order they can be built —",
+        "  what others depend on first. Each small enough to review in one sitting:",
+        "  25 requirements at most; split a large area in two.",
+        "",
+        "## Then",
+        "",
+        "Run `specgate draft` and fix anything it reports about the front matter.",
+        "Stop there and show the front matter to the person: they review it before",
+        "anything is drafted. Do not run `specgate draft <module>`.",
+        "",
+    ].join("\n");
+}
+/** The prompt `--agent` sends, and the line to paste into any agent. */
+exports.BRIEF_SETUP_PASTE = `Propose the front matter of docs/brief.md: follow ${exports.BRIEF_SETUP_FILE}`;
+function briefSetupPrompt(guide) {
+    return [
+        `Propose the front matter of docs/brief.md, following the guide below (also saved as ${exports.BRIEF_SETUP_FILE}).`,
+        "",
+        "---",
+        "",
+        guide,
+    ].join("\n");
+}
+//# sourceMappingURL=brief-setup.js.map

package/dist/scripts/draft/brief-setup.js.map

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

package/dist/scripts/draft/confined-agent.js

@@ -0,0 +1,175 @@
+"use strict";
+/**
+ * Run an agent on one change, and undo whatever it writes anywhere else.
+ *
+ * `change author` does the same with a precondition: a clean working tree, so
+ * that reverting can only ever discard the agent's own work. That is the
+ * safe rule, and on the brief-first path it is the wrong one — the person
+ * has just saved `docs/brief.md` and `specgate draft` has just created the
+ * change, so the tree is never clean when they reach for `--agent`.
+ *
+ * So this one remembers instead of refusing. Before the agent runs, it reads
+ * every file git already reports as changed or untracked; afterwards, any
+ * path outside the change that differs is put back the way it was — a file
+ * the person had edited returns to *their* edit, not to the last commit, and
+ * a file the agent created is removed. Git is still required: it is how the
+ * agent's footprint is found at all.
+ */
+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.agentInvocation = agentInvocation;
+exports.runConfinedAgent = runConfinedAgent;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const os = __importStar(require("node:os"));
+const node_child_process_1 = require("node:child_process");
+const AuthoringScope_1 = require("../../packages/core/src/domain/AuthoringScope");
+/** Every path git sees as changed or untracked, one file per entry. */
+function dirtyPaths(projectDir) {
+    const r = (0, node_child_process_1.spawnSync)("git", ["-C", projectDir, "status", "--porcelain", "--untracked-files=all", "-z"], { encoding: "utf8" });
+    if (r.status !== 0)
+        return null;
+    const out = [];
+    const parts = String(r.stdout).split("\0").filter(Boolean);
+    for (let i = 0; i < parts.length; i += 1) {
+        const code = parts[i].slice(0, 2);
+        out.push(parts[i].slice(3));
+        // A rename carries its old path as the next entry.
+        if (code[0] === "R" || code[0] === "C")
+            i += 1;
+    }
+    return out;
+}
+/**
+ * The command, with the prompt delivered: a `{prompt_file}` placeholder is
+ * replaced by a file holding it; otherwise the prompt goes to standard input,
+ * which is what `claude -p`, `codex exec -` and most agent CLIs read.
+ */
+function agentInvocation(command, promptFile) {
+    return command.includes("{prompt_file}")
+        ? { command: command.split("{prompt_file}").join(promptFile), stdin: false }
+        : { command, stdin: true };
+}
+function runConfinedAgent(o) {
+    const inScope = o.allowed || ((rel) => (0, AuthoringScope_1.isInScope)(rel, o.changeId));
+    const before = dirtyPaths(o.projectDir);
+    if (before === null)
+        return { ok: false, problem: "no_git", wrote: [], reverted: [] };
+    // What the person had, outside the change, before the agent touched anything.
+    const saved = new Map();
+    for (const rel of before) {
+        if (inScope(rel))
+            continue;
+        const full = path.join(o.projectDir, rel);
+        saved.set(rel, fs.existsSync(full) && fs.statSync(full).isFile() ? fs.readFileSync(full) : null);
+    }
+    const promptFile = path.join(os.tmpdir(), `specgate-draft-${o.changeId}-${Date.now()}.md`);
+    fs.writeFileSync(promptFile, o.prompt, "utf8");
+    let agent;
+    try {
+        const call = agentInvocation(o.command, promptFile);
+        agent = (0, node_child_process_1.spawnSync)(call.command, {
+            shell: true,
+            cwd: o.projectDir,
+            encoding: "utf8",
+            input: call.stdin ? o.prompt : "",
+            // Shown, the agent talks in the same stream as the command around it, so
+            // its lines land in order. In --json mode it is captured: stdout is one
+            // document and nothing else.
+            stdio: ["pipe", o.showOutput ? 1 : "pipe", o.showOutput ? 2 : "pipe"],
+        });
+    }
+    finally {
+        fs.rmSync(promptFile, { force: true });
+    }
+    const after = dirtyPaths(o.projectDir) || [];
+    const wrote = [];
+    const reverted = [];
+    for (const rel of after) {
+        if (inScope(rel)) {
+            if (!before.includes(rel))
+                wrote.push(rel);
+            continue;
+        }
+        const full = path.join(o.projectDir, rel);
+        if (saved.has(rel)) {
+            const was = saved.get(rel);
+            const now = fs.existsSync(full) && fs.statSync(full).isFile() ? fs.readFileSync(full) : null;
+            if (was === null && now === null)
+                continue;
+            if (was !== null && now !== null && was.equals(now))
+                continue;
+            if (was === null)
+                fs.rmSync(full, { recursive: true, force: true });
+            else
+                fs.writeFileSync(full, was);
+            reverted.push(rel);
+        }
+        else {
+            // Clean before, changed now: the agent did it.
+            const tracked = (0, node_child_process_1.spawnSync)("git", ["-C", o.projectDir, "ls-files", "--error-unmatch", "--", rel], {
+                encoding: "utf8",
+            }).status === 0;
+            if (tracked)
+                (0, node_child_process_1.spawnSync)("git", ["-C", o.projectDir, "checkout", "--", rel]);
+            else
+                fs.rmSync(full, { recursive: true, force: true });
+            reverted.push(rel);
+        }
+    }
+    // A file the person had changed and the agent deleted is gone from `after`.
+    for (const [rel, was] of saved) {
+        if (was === null || after.includes(rel))
+            continue;
+        const full = path.join(o.projectDir, rel);
+        if (!fs.existsSync(full)) {
+            fs.mkdirSync(path.dirname(full), { recursive: true });
+            fs.writeFileSync(full, was);
+            reverted.push(rel);
+        }
+    }
+    if (agent.status !== 0) {
+        const tail = `${agent.stdout || ""}${agent.stderr || ""}`.trim().slice(-500);
+        return {
+            ok: false,
+            problem: "agent_failed",
+            detail: `exited ${agent.status ?? "on a signal"}${tail ? `: ${tail}` : ""}`,
+            wrote,
+            reverted,
+        };
+    }
+    return { ok: true, wrote, reverted };
+}
+//# sourceMappingURL=confined-agent.js.map

package/dist/scripts/draft/confined-agent.js.map

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