@rsaglobaltech/specgate 0.8.1

package/dist/scripts/done.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"done.js","sourceRoot":"","sources":["../../scripts/done.ts"],"names":[],"mappings":";;;;AAMA,oDAEC;AAPD,iEAA2F;AAGlF,4FAHA,yBAAW,OAGA;AAAE,0FAHA,uBAAS,OAGA;AAAE,iGAHA,8BAAgB,OAGA;AAFjD,uFAAoF;AAIpF,SAAgB,oBAAoB,CAAC,OAAe,EAAE,KAAa,EAAE,SAAiB;IACpF,OAAO,uCAAkB,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;AACpE,CAAC;AAED,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,IAAI,yBAAW,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;AACnD,CAAC"}

package/dist/scripts/expand_domain_pack.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateBaseline = exports.updateLockfile = exports.enforcePackSecurity = exports.resolvePackSource = exports.renderTraceability = exports.renderDomainDocs = exports.renderScenarios = exports.renderStaticFiles = exports.ExpandDomainPackCommand = void 0;
+const ExpandDomainPackCommand_1 = require("./cli/commands/pack/ExpandDomainPackCommand");
+Object.defineProperty(exports, "ExpandDomainPackCommand", { enumerable: true, get: function () { return ExpandDomainPackCommand_1.ExpandDomainPackCommand; } });
+Object.defineProperty(exports, "renderStaticFiles", { enumerable: true, get: function () { return ExpandDomainPackCommand_1.renderStaticFiles; } });
+Object.defineProperty(exports, "renderScenarios", { enumerable: true, get: function () { return ExpandDomainPackCommand_1.renderScenarios; } });
+Object.defineProperty(exports, "renderDomainDocs", { enumerable: true, get: function () { return ExpandDomainPackCommand_1.renderDomainDocs; } });
+Object.defineProperty(exports, "renderTraceability", { enumerable: true, get: function () { return ExpandDomainPackCommand_1.renderTraceability; } });
+Object.defineProperty(exports, "resolvePackSource", { enumerable: true, get: function () { return ExpandDomainPackCommand_1.resolvePackSource; } });
+Object.defineProperty(exports, "enforcePackSecurity", { enumerable: true, get: function () { return ExpandDomainPackCommand_1.enforcePackSecurity; } });
+Object.defineProperty(exports, "updateLockfile", { enumerable: true, get: function () { return ExpandDomainPackCommand_1.updateLockfile; } });
+Object.defineProperty(exports, "updateBaseline", { enumerable: true, get: function () { return ExpandDomainPackCommand_1.updateBaseline; } });
+if (require.main === module) {
+    new ExpandDomainPackCommand_1.ExpandDomainPackCommand(process.argv.slice(2)).execute();
+}
+//# sourceMappingURL=expand_domain_pack.js.map

package/dist/scripts/expand_domain_pack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"expand_domain_pack.js","sourceRoot":"","sources":["../../scripts/expand_domain_pack.ts"],"names":[],"mappings":";;;;AACA,yFAUqD;AAGnD,wGAZA,iDAAuB,OAYA;AACvB,kGAZA,2CAAiB,OAYA;AACjB,gGAZA,yCAAe,OAYA;AACf,iGAZA,0CAAgB,OAYA;AAChB,mGAZA,4CAAkB,OAYA;AAClB,kGAZA,2CAAiB,OAYA;AACjB,oGAZA,6CAAmB,OAYA;AACnB,+FAZA,wCAAc,OAYA;AACd,+FAZA,wCAAc,OAYA;AAGhB,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,IAAI,iDAAuB,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;AAC/D,CAAC"}

package/dist/scripts/fix.js

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseArgs = exports.computeFixes = exports.FixCommand = void 0;
+const FixCommand_1 = require("./cli/commands/quality/FixCommand");
+Object.defineProperty(exports, "FixCommand", { enumerable: true, get: function () { return FixCommand_1.FixCommand; } });
+Object.defineProperty(exports, "computeFixes", { enumerable: true, get: function () { return FixCommand_1.computeFixes; } });
+Object.defineProperty(exports, "parseArgs", { enumerable: true, get: function () { return FixCommand_1.parseArgs; } });
+if (require.main === module) {
+    new FixCommand_1.FixCommand(process.argv.slice(2)).execute();
+}
+//# sourceMappingURL=fix.js.map

package/dist/scripts/fix.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fix.js","sourceRoot":"","sources":["../../scripts/fix.ts"],"names":[],"mappings":";;;;AACA,kEAAoG;AAE3F,2FAFA,uBAAU,OAEA;AAAE,6FAFA,yBAAY,OAEA;AAAE,0FAFA,sBAAS,OAEA;AAE5C,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,IAAI,uBAAU,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;AAClD,CAAC"}

package/dist/scripts/gen_agent_contract.js

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.render = exports.harvestCodes = exports.COMMANDS = exports.OUTPUT = exports.GenAgentContractCommand = void 0;
+const GenAgentContractCommand_1 = require("./cli/commands/config/GenAgentContractCommand");
+Object.defineProperty(exports, "GenAgentContractCommand", { enumerable: true, get: function () { return GenAgentContractCommand_1.GenAgentContractCommand; } });
+Object.defineProperty(exports, "OUTPUT", { enumerable: true, get: function () { return GenAgentContractCommand_1.OUTPUT; } });
+Object.defineProperty(exports, "COMMANDS", { enumerable: true, get: function () { return GenAgentContractCommand_1.COMMANDS; } });
+Object.defineProperty(exports, "harvestCodes", { enumerable: true, get: function () { return GenAgentContractCommand_1.harvestCodes; } });
+Object.defineProperty(exports, "render", { enumerable: true, get: function () { return GenAgentContractCommand_1.render; } });
+if (require.main === module) {
+    new GenAgentContractCommand_1.GenAgentContractCommand(process.argv.slice(2)).execute();
+}
+//# sourceMappingURL=gen_agent_contract.js.map

package/dist/scripts/gen_agent_contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gen_agent_contract.js","sourceRoot":"","sources":["../../scripts/gen_agent_contract.ts"],"names":[],"mappings":";;;;AACA,2FAMuD;AAE9C,wGAPP,iDAAuB,OAOO;AAAE,uFANhC,gCAAM,OAMgC;AAAE,yFALxC,kCAAQ,OAKwC;AAAE,6FAJlD,sCAAY,OAIkD;AAAE,uFAHhE,gCAAM,OAGgE;AAExE,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;IAC5B,IAAI,iDAAuB,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;AAC/D,CAAC"}

package/dist/scripts/gen_mcp_tools.js

@@ -0,0 +1,264 @@
+"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 });
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const surface_1 = require("./lib/surface");
+/**
+ * Resolve the repository root rather than walking up from `__dirname`.
+ *
+ * Compiled, this file runs from `dist/scripts/`, so `../packages/...` resolved
+ * to `dist/packages/mcp-spec-driven/src/tools.ts` — build output. The generator
+ * reported success on every run and never once wrote the file it is for, which
+ * is why the committed registry drifted from the surface it is generated from.
+ */
+function repoRoot() {
+    let dir = __dirname;
+    for (;;) {
+        if (fs.existsSync(path.join(dir, "package.json")))
+            return dir;
+        const parent = path.dirname(dir);
+        if (parent === dir)
+            throw new Error("package.json not found above " + __dirname);
+        dir = parent;
+    }
+}
+const OUT_FILE = path.join(repoRoot(), "packages/mcp-spec-driven/src/tools.ts");
+const toolsMap = (0, surface_1.mcpTools)();
+// Convert toolsMap { toolName: "command name" } back into lookup by "command name"
+const cmdToTool = Object.entries(toolsMap).reduce((acc, [tool, cmd]) => {
+    acc[cmd] = tool;
+    return acc;
+}, {});
+let out = `// GENERATED FILE - DO NOT EDIT BY HAND
+// Derived from scripts/lib/surface.ts
+
+import * as fs from "node:fs";
+import * as path from "node:path";
+import { spawnSync } from "node:child_process";
+import {
+  ReadSpecTool,
+  ListRequirementsTool,
+  UpdateTraceabilityTool,
+} from "./native-tools";
+
+export interface ITool {
+  readonly name: string;
+  readonly description: string;
+  readonly inputSchema: Record<string, unknown>;
+  readonly csda?: string;
+  handler(args: Record<string, unknown>): unknown;
+}
+
+class ProjectHelper {
+  /**
+   * A tool that is handed a directory which is not a spec-driven project has to
+   * say so. #138 reduced this to a type check, so every such call went on to
+   * shell out and came back \`{ exitCode: 1, raw: "" }\` — a failure with no
+   * reason in it, which is exactly the shape ADR-0017 exists to prevent.
+   */
+  public static ensureProjectDir(projectDir: unknown): string {
+    if (!projectDir || typeof projectDir !== "string") {
+      throw new Error("projectDir is required (absolute path to a spec-driven project)");
+    }
+    if (!fs.existsSync(projectDir)) {
+      throw new Error(\`projectDir does not exist: \${projectDir}\`);
+    }
+    if (!fs.existsSync(path.join(projectDir, "spec.md"))) {
+      throw new Error(\`Not a spec-driven project (no spec.md): \${projectDir}\`);
+    }
+    return projectDir;
+  }
+}
+
+class CliInvoker {
+  /**
+   * Split a command line, honouring quotes.
+   *
+   * \`bin.split(" ")\` was the whole parser after #138, so any interpreter path
+   * with a space in it — \`"/Users/me/My Tools/node" "…/cli.js"\` — was torn into
+   * fragments and the spawn failed with no output.
+   */
+  private static parseCliCommand(cliPath: string | undefined): string[] {
+    const raw = (cliPath || "npx @rsaglobaltech/specgate").trim();
+    const tokens: string[] = [];
+    const re = /"([^"]*)"|'([^']*)'|(\\S+)/g;
+    let m;
+    while ((m = re.exec(raw)) !== null) {
+      tokens.push(m[1] !== undefined ? m[1] : m[2] !== undefined ? m[2] : m[3]);
+    }
+    return tokens;
+  }
+
+  public static spawnCli(cliPath: string | undefined, args: string[]) {
+    const cmd = CliInvoker.parseCliCommand(cliPath);
+    const useShell = process.platform === "win32";
+    const quote = (v: string) => (useShell && /\\s/.test(v) ? \`"\${v}"\` : v);
+    return spawnSync(quote(cmd[0]), [...cmd.slice(1), ...args].map(quote), {
+      encoding: "utf8",
+      shell: useShell,
+      timeout: 60000,
+    });
+  }
+}
+
+export class GenericCliTool implements ITool {
+  constructor(
+    public readonly name: string,
+    public readonly description: string,
+    public readonly csda: string,
+    public readonly inputSchema: Record<string, unknown>,
+    /**
+     * How this command takes the project directory. \`validate\` takes it as a
+     * positional \`<dir>\` and rejects \`--project-dir\` outright, so the flag form
+     * made \`validate_project\` — the most used tool of the seven — fail with
+     * "Unknown flag(s)" and an empty payload over MCP. The surface already
+     * records which is which in \`json.args\`; this reads it instead of assuming.
+     */
+    public readonly dirStyle: "flag" | "positional" = "flag"
+  ) {}
+
+  public handler(args: Record<string, unknown>) {
+    const dir = ProjectHelper.ensureProjectDir(args.projectDir);
+    const argv = this.csda.split(" ");
+    
+    if (this.dirStyle === "positional") argv.push(dir);
+    else argv.push("--project-dir", dir);
+    
+    // Pass args safely
+    for (const [k, v] of Object.entries(args)) {
+      if (k === "projectDir" || k === "cliPath") continue;
+      if (typeof v === "string") {
+        argv.push(v); // Quick hack, we need proper arg mapping
+      }
+    }
+    
+    if (!argv.includes("--json")) {
+       argv.push("--json");
+    }
+
+    const result = CliInvoker.spawnCli(args.cliPath as string, argv);
+    const combined = (result.stdout || "") + "\\n" + (result.stderr || "");
+    try {
+      if (result.stdout && result.stdout.trim().startsWith("{")) {
+         return JSON.parse(result.stdout.trim());
+      }
+    } catch {
+      // Not JSON: fall through to the raw envelope below.
+    }
+    
+    return {
+      exitCode: typeof result.status === "number" ? result.status : 1,
+      raw: combined.trim(),
+    };
+  }
+}
+
+export const TOOLS: Record<string, ITool> = {};
+
+`;
+for (const command of surface_1.SURFACE) {
+    const processCmd = (cmdDef, subDef) => {
+        const cmdString = subDef ? `${cmdDef.name} ${subDef.name}` : cmdDef.name;
+        const toolName = cmdToTool[cmdString];
+        if (!toolName)
+            return; // skipped via mcp: false
+        const summary = (subDef ? subDef.help?.summary : cmdDef.help?.summary) || `Run specgate ${cmdString}`;
+        // `json.args: "<dir>"` is the surface saying this command takes the project
+        // directory positionally rather than behind `--project-dir`.
+        const jsonDef = subDef ? subDef.json : cmdDef.json;
+        const dirStyle = jsonDef && jsonDef.args === "<dir>" ? "positional" : "flag";
+        out += `TOOLS["${toolName}"] = new GenericCliTool(
+  "${toolName}",
+  ${JSON.stringify(summary)},
+  "${cmdString}",
+  {
+    type: "object",
+    properties: {
+      projectDir: { type: "string" },
+      cliPath: { type: "string" }
+    },
+    required: ["projectDir"]
+  },
+  "${dirStyle}"
+);\n`;
+    };
+    if (command.subcommands) {
+        for (const sub of command.subcommands) {
+            processCmd(command, sub);
+        }
+    }
+    else {
+        processCmd(command, null);
+    }
+}
+// The three tools that are not a CLI command behind a shell, plus the published
+// names of the four that are.
+//
+// #138 generated the whole registry from the command surface and, in doing so,
+// deleted `read_spec`, `list_requirements` and `update_traceability` and renamed
+// the other four to `csda_*`. An MCP tool id lives in someone else's agent
+// config: the seven published names have to keep resolving, so they are
+// registered here as well as the generated ids. Both spellings reach the same
+// handler, and the tools that read files come from `native-tools.ts` — which is
+// not generated, so this file can be regenerated without losing them.
+out += `
+// ── The published seven ──────────────────────────────────────────────────────
+
+TOOLS["read_spec"] = new ReadSpecTool();
+TOOLS["list_requirements"] = new ListRequirementsTool();
+TOOLS["update_traceability"] = new UpdateTraceabilityTool();
+
+// Aliases: the documented name and the generated id are the same tool.
+for (const [published, generated] of [
+  ["lint_pack", "csda_pack_lint"],
+  ["validate_project", "csda_validate"],
+  ["plan", "csda_plan"],
+  ["mark_requirement_done", "csda_done"],
+] as const) {
+  if (TOOLS[generated]) TOOLS[published] = TOOLS[generated];
+}
+
+export const readSpec = (args: any) => TOOLS["read_spec"].handler(args);
+export const listRequirements = (args: any) => TOOLS["list_requirements"].handler(args);
+export const updateTraceability = (args: any) => TOOLS["update_traceability"].handler(args);
+export const lintPack = (args: any) => TOOLS["lint_pack"].handler(args);
+export const validateProject = (args: any) => TOOLS["validate_project"].handler(args);
+export const plan = (args: any) => TOOLS["plan"].handler(args);
+export const markRequirementDone = (args: any) => TOOLS["mark_requirement_done"].handler(args);
+`;
+fs.writeFileSync(OUT_FILE, out);
+console.log("Generated tools.ts");
+//# sourceMappingURL=gen_mcp_tools.js.map

package/dist/scripts/gen_mcp_tools.js.map

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