@rsaglobaltech/specgate 0.8.1

package/dist/scripts/schema/cli.js.map

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

package/dist/scripts/schema/registry.js

@@ -0,0 +1,264 @@
+"use strict";
+/**
+ * Artefact schemas — which artefacts a change produces, and in what order.
+ *
+ * ADR-0018 fixed the semantics: dependencies are **enablers, not gates**. A
+ * schema says "tasks make more sense once the specs exist", never "you are
+ * forbidden from writing tasks first". Making this configurable does not
+ * change that; it changes *which* artefacts a team recognises.
+ *
+ * Two schemas ship. `spec-driven` reproduces the flow the tool has always had.
+ * `bdd-first` is an opinion: the executable scenario comes before the prose
+ * spec, because a team with Cucumber already writes the `.feature` first and
+ * the spec afterwards to explain it.
+ *
+ * A project overrides either by forking it into `.csda/schemas/<name>/schema.yaml`.
+ */
+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.BUILT_IN = exports.SCHEMA_FILE = exports.SCHEMA_DIR = void 0;
+exports.toYaml = toYaml;
+exports.parseYaml = parseYaml;
+exports.validateSchema = validateSchema;
+exports.findCycle = findCycle;
+exports.resolveSchema = resolveSchema;
+exports.listSchemas = listSchemas;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+exports.SCHEMA_DIR = path.join(".csda", "schemas");
+exports.SCHEMA_FILE = "schema.yaml";
+exports.BUILT_IN = {
+    "spec-driven": {
+        name: "spec-driven",
+        description: "Proposal first, then the delta specs, then the tasks. The default.",
+        artifacts: [
+            { id: "proposal", generates: "proposal.md", requires: [] },
+            { id: "specs", generates: "specs/**/spec.md", requires: ["proposal"] },
+            { id: "design", generates: "design.md", requires: ["proposal"] },
+            { id: "tasks", generates: "tasks.md", requires: ["specs", "design"] },
+        ],
+    },
+    "bdd-first": {
+        name: "bdd-first",
+        description: "The executable scenario before the prose spec. For teams whose Cucumber suite is the real contract.",
+        artifacts: [
+            { id: "proposal", generates: "proposal.md", requires: [] },
+            { id: "feature", generates: "features/**/*.feature", requires: ["proposal"] },
+            { id: "specs", generates: "specs/**/spec.md", requires: ["feature"] },
+            { id: "design", generates: "design.md", requires: ["proposal"] },
+            { id: "tasks", generates: "tasks.md", requires: ["specs", "design"] },
+        ],
+    },
+};
+/** Minimal YAML emitter for a schema — the repo has no YAML dependency. */
+function toYaml(schema) {
+    const lines = [
+        `# ${schema.description}`,
+        "#",
+        "# Dependencies are enablers, not gates (ADR-0018): `requires` says what makes",
+        "# an artefact easier to write, never what blocks it.",
+        `name: ${schema.name}`,
+        // Backslash first — see PackContribution.yamlString.
+        `description: "${String(schema.description).replace(/\\/g, "\\\\").replace(/"/g, '\\"')}"`,
+        "artifacts:",
+    ];
+    for (const a of schema.artifacts) {
+        lines.push(`  - id: ${a.id}`);
+        lines.push(`    generates: "${a.generates}"`);
+        lines.push(a.requires.length === 0 ? "    requires: []" : `    requires: [${a.requires.join(", ")}]`);
+    }
+    return `${lines.join("\n")}\n`;
+}
+/**
+ * Parse the subset of YAML a schema file uses. Hand-rolled to keep the CLI's
+ * zero-runtime-dependency promise, and narrow on purpose: anything richer than
+ * this list-of-maps shape is rejected rather than half-understood.
+ */
+function parseYaml(text) {
+    const schema = { artifacts: [] };
+    let current = null;
+    for (const raw of text.replace(/\r\n/g, "\n").split("\n")) {
+        const line = raw.replace(/\s+$/, "");
+        if (!line.trim() || line.trim().startsWith("#"))
+            continue;
+        const top = /^([a-z_]+):\s*(.*)$/.exec(line);
+        if (top && !line.startsWith(" ")) {
+            if (top[1] === "artifacts")
+                continue;
+            schema[top[1]] = unquote(top[2]);
+            continue;
+        }
+        const item = /^\s*-\s*id:\s*(.+)$/.exec(line);
+        if (item) {
+            current = { id: unquote(item[1]), generates: "", requires: [] };
+            schema.artifacts.push(current);
+            continue;
+        }
+        const field = /^\s+([a-z_]+):\s*(.*)$/.exec(line);
+        if (field && current) {
+            const [, key, value] = field;
+            if (key === "requires") {
+                const inner = value
+                    .trim()
+                    .replace(/^\[|\]$/g, "")
+                    .trim();
+                current.requires = inner
+                    ? inner
+                        .split(",")
+                        .map((v) => v.trim())
+                        .filter(Boolean)
+                    : [];
+            }
+            else {
+                current[key] = unquote(value);
+            }
+        }
+    }
+    return schema;
+}
+function unquote(value) {
+    const v = (value || "").trim();
+    return v.replace(/^["']|["']$/g, "");
+}
+/**
+ * Structural problems, as diagnostics rather than exceptions. A schema that
+ * names a dependency it does not declare would silently mark every artefact
+ * blocked, which looks like the tool being broken.
+ */
+function validateSchema(schema) {
+    const problems = [];
+    if (!schema.name) {
+        problems.push({ code: "schema_no_name", message: "The schema has no `name`." });
+    }
+    if (!Array.isArray(schema.artifacts) || schema.artifacts.length === 0) {
+        problems.push({ code: "schema_no_artifacts", message: "The schema declares no artifacts." });
+        return problems;
+    }
+    const ids = new Set();
+    for (const a of schema.artifacts) {
+        if (!a.id) {
+            problems.push({ code: "artifact_no_id", message: "An artifact has no `id`." });
+            continue;
+        }
+        if (ids.has(a.id)) {
+            problems.push({
+                code: "artifact_duplicate_id",
+                message: `Duplicate artifact id: ${a.id}.`,
+                target: a.id,
+            });
+        }
+        ids.add(a.id);
+        if (!a.generates) {
+            problems.push({
+                code: "artifact_no_output",
+                message: `Artifact ${a.id} does not say what it generates.`,
+                target: a.id,
+            });
+        }
+    }
+    for (const a of schema.artifacts) {
+        for (const dep of a.requires || []) {
+            if (!ids.has(dep)) {
+                problems.push({
+                    code: "artifact_unknown_dependency",
+                    message: `Artifact ${a.id} requires "${dep}", which the schema does not declare.`,
+                    target: a.id,
+                });
+            }
+        }
+    }
+    const cycle = findCycle(schema.artifacts);
+    if (cycle) {
+        problems.push({
+            code: "artifact_cycle",
+            message: `Artifacts form a cycle: ${cycle.join(" → ")}.`,
+            target: cycle[0],
+        });
+    }
+    return problems;
+}
+function findCycle(artifacts) {
+    const byId = new Map(artifacts.map((a) => [a.id, a]));
+    const state = new Map();
+    let cycle = null;
+    function visit(id, trail) {
+        if (cycle)
+            return;
+        if (state.get(id) === "done")
+            return;
+        if (state.get(id) === "visiting") {
+            cycle = [...trail.slice(trail.indexOf(id)), id];
+            return;
+        }
+        state.set(id, "visiting");
+        for (const dep of (byId.get(id) || { requires: [] }).requires || []) {
+            if (byId.has(dep))
+                visit(dep, [...trail, id]);
+        }
+        state.set(id, "done");
+    }
+    for (const a of artifacts)
+        visit(a.id, []);
+    return cycle;
+}
+/** Where a schema comes from: the project's fork, or the built-in. */
+function resolveSchema(projectDir, name) {
+    const wanted = name || "spec-driven";
+    const forked = path.join(projectDir, exports.SCHEMA_DIR, wanted, exports.SCHEMA_FILE);
+    if (fs.existsSync(forked)) {
+        return {
+            source: "project",
+            path: path.join(exports.SCHEMA_DIR, wanted, exports.SCHEMA_FILE),
+            schema: parseYaml(fs.readFileSync(forked, "utf8")),
+        };
+    }
+    if (exports.BUILT_IN[wanted]) {
+        return { source: "built-in", path: null, schema: exports.BUILT_IN[wanted] };
+    }
+    return null;
+}
+function listSchemas(projectDir) {
+    const names = new Set(Object.keys(exports.BUILT_IN));
+    const dir = path.join(projectDir, exports.SCHEMA_DIR);
+    if (fs.existsSync(dir)) {
+        for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+            if (entry.isDirectory() && fs.existsSync(path.join(dir, entry.name, exports.SCHEMA_FILE))) {
+                names.add(entry.name);
+            }
+        }
+    }
+    return [...names].sort();
+}
+//# sourceMappingURL=registry.js.map

package/dist/scripts/schema/registry.js.map

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

package/dist/scripts/specops/add.js

@@ -0,0 +1,180 @@
+#!/usr/bin/env node
+"use strict";
+/**
+ * `specops add` — thin npm-install-style wrapper around `expand`.
+ *
+ *   specgate specops add --pack-repo https://github.com/acme/x.git \
+ *                    --pack-version v0.1.0 --pack backend \
+ *                    --var PROJECT_NAME=Foo --var PROJECT_SLUG=foo
+ *
+ * Delegates the actual work to `expand_domain_pack.js`, which already
+ * writes/updates `.specops.lock` and persists the vars. The reason this
+ * command exists is ergonomic:
+ *
+ *   1. Project root is auto-detected from cwd (no need for --project-dir).
+ *   2. Mental model aligns with `npm install` / `specops remove`.
+ *   3. Pre-flight checks the arguments the user *almost certainly* needs.
+ */
+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.AddCommand = void 0;
+exports.parseArgs = parseArgs;
+const path = __importStar(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const command_1 = require("../lib/command");
+const project_root_1 = require("../lib/project-root");
+const EXPAND_SCRIPT = path.join(__dirname, "..", "expand_domain_pack.js");
+const COLOR_ENABLED = process.stdout.isTTY && process.env.NO_COLOR === undefined && process.env.TERM !== "dumb";
+const c = {
+    reset: COLOR_ENABLED ? "\x1b[0m" : "",
+    bold: COLOR_ENABLED ? "\x1b[1m" : "",
+    dim: COLOR_ENABLED ? "\x1b[2m" : "",
+    red: COLOR_ENABLED ? "\x1b[31m" : "",
+    green: COLOR_ENABLED ? "\x1b[32m" : "",
+    yellow: COLOR_ENABLED ? "\x1b[33m" : "",
+    cyan: COLOR_ENABLED ? "\x1b[36m" : "",
+};
+function usage() {
+    process.stdout.write(`\n  ${c.bold}${c.cyan}➕ specops add${c.reset}  ${c.dim}— add a pack to this project${c.reset}\n\n` +
+        `  ${c.bold}USAGE${c.reset}\n` +
+        `    ${c.cyan}specgate specops add${c.reset} --pack-repo <url> --pack-version <tag> --pack <pack-id> [--var K=V]... [--project-dir <path>] [--cache-dir <path>] [--dry-run]\n` +
+        `    ${c.cyan}specgate specops add${c.reset} --pack-root <path> --pack <pack-id> [--var K=V]... [--project-dir <path>]\n\n` +
+        `  ${c.bold}OPTIONS${c.reset}\n` +
+        `    ${c.green}--pack-repo <url>${c.reset}      ${c.dim}Git URL of the pack repository.${c.reset}\n` +
+        `    ${c.green}--pack-version <tag>${c.reset}   ${c.dim}Git tag/sha to pin (required with --pack-repo).${c.reset}\n` +
+        `    ${c.green}--pack-root <path>${c.reset}     ${c.dim}Local directory containing packs (alternative to --pack-repo).${c.reset}\n` +
+        `    ${c.green}--pack <pack-id>${c.reset}       ${c.dim}Pack identifier, e.g. parking-management/backend.${c.reset}\n` +
+        `    ${c.green}--var KEY=VALUE${c.reset}        ${c.dim}Template variable (repeatable). Persisted to .specops.lock.${c.reset}\n` +
+        `    ${c.green}--project-dir <path>${c.reset}   ${c.dim}Project root (auto-detected from cwd if omitted).${c.reset}\n` +
+        `    ${c.green}--cache-dir <path>${c.reset}     ${c.dim}Override the remote-pack cache directory.${c.reset}\n` +
+        `    ${c.green}--dry-run${c.reset}              ${c.dim}Print actions without writing.${c.reset}\n` +
+        `    ${c.green}-h, --help${c.reset}             ${c.dim}Show this help.${c.reset}\n\n` +
+        `  ${c.bold}EXAMPLES${c.reset}\n` +
+        `    ${c.yellow}$${c.reset} specgate specops add --pack-repo https://github.com/rsaglobaltech/parking-management-specops.git \\\n        --pack-version v0.1.0 --pack backend \\\n        --var PROJECT_NAME="Smart Parking" --var PROJECT_SLUG=smart-parking --var DOMAIN="parking ops"\n` +
+        `    ${c.yellow}$${c.reset} specgate specops add --pack-root ./domain-packs --pack billing/backend --var PROJECT_NAME="..." --var PROJECT_SLUG=...\n\n`);
+}
+function parseArgs(argv) {
+    const opts = {
+        packRepo: "",
+        packRoot: "",
+        packVersion: "",
+        pack: "",
+        projectDir: ".",
+        cacheDir: "",
+        vars: [],
+        dryRun: false,
+    };
+    for (let i = 0; i < argv.length; i++) {
+        const a = argv[i];
+        if (a === "--pack-repo" && argv[i + 1])
+            opts.packRepo = argv[++i];
+        else if (a === "--pack-root" && argv[i + 1])
+            opts.packRoot = argv[++i];
+        else if (a === "--pack-version" && argv[i + 1])
+            opts.packVersion = argv[++i];
+        else if (a === "--pack" && argv[i + 1])
+            opts.pack = argv[++i];
+        else if (a === "--project-dir" && argv[i + 1])
+            opts.projectDir = argv[++i];
+        else if (a === "--cache-dir" && argv[i + 1])
+            opts.cacheDir = argv[++i];
+        else if (a === "--var" && argv[i + 1])
+            opts.vars.push(argv[++i]);
+        else if (a === "--dry-run")
+            opts.dryRun = true;
+        else if (a === "--help" || a === "-h") {
+            usage();
+            process.exit(0);
+        }
+        else {
+            process.stderr.write(`Unknown argument: ${a}\n`);
+            process.exit(2);
+        }
+    }
+    return opts;
+}
+class AddCommand extends command_1.BaseCommand {
+    execute() {
+        const opts = parseArgs(this.args);
+        if (!opts.pack) {
+            process.stderr.write(`${c.red}✖${c.reset}  --pack <pack-id> is required.\n`);
+            usage();
+            process.exit(2);
+        }
+        if (opts.packRepo && opts.packRoot) {
+            process.stderr.write(`${c.red}✖${c.reset}  Pass either --pack-repo or --pack-root, not both.\n`);
+            process.exit(2);
+        }
+        if (!opts.packRepo && !opts.packRoot) {
+            process.stderr.write(`${c.red}✖${c.reset}  Either --pack-repo (with --pack-version) or --pack-root is required.\n`);
+            process.exit(2);
+        }
+        if (opts.packRepo && !opts.packVersion) {
+            process.stderr.write(`${c.red}✖${c.reset}  --pack-repo requires --pack-version (pin to a git tag or sha).\n`);
+            process.exit(2);
+        }
+        let projectDir;
+        try {
+            projectDir = (0, project_root_1.resolveProjectDir)(opts.projectDir);
+        }
+        catch (err) {
+            process.stderr.write(`${err.message}\n`);
+            process.exit(2);
+        }
+        const expandArgs = [];
+        if (opts.packRepo) {
+            expandArgs.push("--pack-repo", opts.packRepo, "--pack-version", opts.packVersion);
+        }
+        else {
+            expandArgs.push("--pack-root", opts.packRoot);
+        }
+        expandArgs.push("--pack", opts.pack, "--project-dir", projectDir);
+        if (opts.cacheDir)
+            expandArgs.push("--cache-dir", opts.cacheDir);
+        for (const v of opts.vars)
+            expandArgs.push("--var", v);
+        if (opts.dryRun)
+            expandArgs.push("--dry-run");
+        process.stdout.write(`${c.cyan}ℹ${c.reset}  Adding ${c.bold}${opts.pack}${c.reset}${opts.packVersion ? ` @ ${c.bold}${opts.packVersion}${c.reset}` : ""} to ${c.dim}${projectDir}${c.reset}\n`);
+        const result = (0, node_child_process_1.spawnSync)(process.execPath, [EXPAND_SCRIPT, ...expandArgs], {
+            stdio: "inherit",
+        });
+        process.exit(typeof result.status === "number" ? result.status : 1);
+    }
+}
+exports.AddCommand = AddCommand;
+if (require.main === module)
+    new AddCommand(process.argv.slice(2)).execute();
+//# sourceMappingURL=add.js.map

package/dist/scripts/specops/add.js.map

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

package/dist/scripts/specops/against_lock.js

@@ -0,0 +1,100 @@
+"use strict";
+/**
+ * `validate --against-lock` — the drift gate.
+ *
+ * Checks the project's traceability matrix against locked domain packs.
+ */
+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.bare = bare;
+exports.checkAgainstLock = checkAgainstLock;
+exports.checkPackAgainstProject = checkPackAgainstProject;
+const fs = __importStar(require("node:fs"));
+const TraceabilityFormat_1 = require("../../packages/core/src/domain/TraceabilityFormat");
+const ChangeWorkspace_1 = require("../../packages/core/src/infrastructure/ChangeWorkspace");
+const diagnostics_1 = require("../lib/diagnostics");
+const DiskLockfileRepository_1 = require("../../packages/core/src/infrastructure/DiskLockfileRepository");
+const DiskDomainPackRepository_1 = require("../../packages/core/src/infrastructure/DiskDomainPackRepository");
+const CheckAgainstLockUseCase_1 = require("../../packages/core/src/application/CheckAgainstLockUseCase");
+/** Strip the backticks the generated matrix wraps paths in. */
+function bare(value) {
+    return String(value === undefined || value === null ? "" : value)
+        .trim()
+        .replace(/^`|`$/g, "");
+}
+/**
+ * Run the gate for every pack in the lockfile using the Clean Architecture Use Case.
+ */
+function checkAgainstLock(projectDir, opts) {
+    const traceabilityFile = (0, ChangeWorkspace_1.paths)(projectDir).traceability;
+    const matrix = fs.existsSync(traceabilityFile)
+        ? (0, TraceabilityFormat_1.parseTraceabilityRows)(fs.readFileSync(traceabilityFile, "utf8"))
+        : { mode: "rich", rows: [] };
+    const isLegacy = matrix.mode !== "rich";
+    const rows = isLegacy ? null : matrix.rows;
+    const lockRepo = new DiskLockfileRepository_1.DiskLockfileRepository(projectDir);
+    const packRepo = new DiskDomainPackRepository_1.DiskDomainPackRepository();
+    const useCase = new CheckAgainstLockUseCase_1.CheckAgainstLockUseCase(lockRepo, packRepo);
+    const result = useCase.execute(rows, isLegacy, opts);
+    // Convert to full diagnostics
+    const diagnostics = result.diagnostics.map((d) => {
+        if (d.severity === "error") {
+            return (0, diagnostics_1.error)(d.code, d.message, { target: d.target, fix: d.fix });
+        }
+        if (d.severity === "warning") {
+            return (0, diagnostics_1.warning)(d.code, d.message, { target: d.target, fix: d.fix });
+        }
+        return (0, diagnostics_1.info)(d.code, d.message, { target: d.target, fix: d.fix });
+    });
+    return { checked: result.checked, diagnostics };
+}
+const DomainPack_1 = require("../../packages/core/src/domain/DomainPack");
+function checkPackAgainstProject(pack, entry, matrixRows) {
+    const domainPack = new DomainPack_1.DomainPack(entry.pack_id || "", pack, entry.version || "");
+    const lockRepo = { readLock: () => null };
+    const packRepo = { resolveRemotePack: () => ({ packRoot: "", commit: "" }) };
+    const useCase = new CheckAgainstLockUseCase_1.CheckAgainstLockUseCase(lockRepo, packRepo);
+    const rawDiags = useCase.checkPackAgainstMatrix(domainPack, entry, matrixRows);
+    return rawDiags.map((d) => {
+        if (d.severity === "error") {
+            return (0, diagnostics_1.error)(d.code, d.message, { target: d.target, fix: d.fix });
+        }
+        if (d.severity === "warning") {
+            return (0, diagnostics_1.warning)(d.code, d.message, { target: d.target, fix: d.fix });
+        }
+        return (0, diagnostics_1.info)(d.code, d.message, { target: d.target, fix: d.fix });
+    });
+}
+//# sourceMappingURL=against_lock.js.map

package/dist/scripts/specops/against_lock.js.map

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

package/dist/scripts/specops/as_change.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * `specops diff --as-change` — a pack version bump, expressed as intent.
+ *
+ * What counts as a change is domain (`core/domain/PackDelta`); loading a pack,
+ * reading its Gherkin templates and writing the change folder are
+ * infrastructure (`DiskPackDeltaRepository`). This module wires the two and
+ * keeps the signatures its callers and tests already use: `deriveDelta` takes
+ * pack roots, and `materialiseChange` takes a project directory, with the
+ * project's phrase table resolved here rather than deep inside the renderer.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stepsForScenario = exports.loadPackModel = exports.renderTasks = exports.renderProposal = exports.changeIdFor = exports.renderRequirementBlock = exports.requirementFingerprint = exports.scenariosByRequirement = exports.requirementsById = void 0;
+exports.deriveDelta = deriveDelta;
+exports.materialiseChange = materialiseChange;
+const DiskLanguageRepository_1 = require("../../packages/core/src/infrastructure/DiskLanguageRepository");
+const DiskPackDeltaRepository_1 = require("../../packages/core/src/infrastructure/DiskPackDeltaRepository");
+const PackDelta_1 = require("../../packages/core/src/domain/PackDelta");
+var PackDelta_2 = require("../../packages/core/src/domain/PackDelta");
+Object.defineProperty(exports, "requirementsById", { enumerable: true, get: function () { return PackDelta_2.requirementsById; } });
+Object.defineProperty(exports, "scenariosByRequirement", { enumerable: true, get: function () { return PackDelta_2.scenariosByRequirement; } });
+Object.defineProperty(exports, "requirementFingerprint", { enumerable: true, get: function () { return PackDelta_2.requirementFingerprint; } });
+Object.defineProperty(exports, "renderRequirementBlock", { enumerable: true, get: function () { return PackDelta_2.renderRequirementBlock; } });
+Object.defineProperty(exports, "changeIdFor", { enumerable: true, get: function () { return PackDelta_2.changeIdFor; } });
+Object.defineProperty(exports, "renderProposal", { enumerable: true, get: function () { return PackDelta_2.renderProposal; } });
+Object.defineProperty(exports, "renderTasks", { enumerable: true, get: function () { return PackDelta_2.renderTasks; } });
+var DiskPackDeltaRepository_2 = require("../../packages/core/src/infrastructure/DiskPackDeltaRepository");
+Object.defineProperty(exports, "loadPackModel", { enumerable: true, get: function () { return DiskPackDeltaRepository_2.loadPackModel; } });
+Object.defineProperty(exports, "stepsForScenario", { enumerable: true, get: function () { return DiskPackDeltaRepository_2.stepsForScenario; } });
+/**
+ * Compare two versions of a pack and produce the delta markdown plus a summary.
+ *
+ * @returns { capability, markdown, summary: {added[], modified[], removed[]} }
+ *          `markdown` is null when nothing behavioural changed.
+ */
+function deriveDelta(oldPackRoot, newPackRoot, packId, opts) {
+    const options = opts || {};
+    const oldPack = oldPackRoot ? (0, DiskPackDeltaRepository_1.loadPackModel)(oldPackRoot, packId) : null;
+    const newPack = (0, DiskPackDeltaRepository_1.loadPackModel)(newPackRoot, packId);
+    return (0, PackDelta_1.derivePackDelta)(oldPack, newPack, packId, (0, DiskLanguageRepository_1.phrases)(options.projectDir), DiskPackDeltaRepository_1.stepsForScenario, options);
+}
+/**
+ * Materialise the derived delta as a change folder. Returns the list of files
+ * written (or that would be written, when `dryRun`).
+ */
+function materialiseChange(projectDir, entry, targetVersion, derived, opts) {
+    return (0, DiskPackDeltaRepository_1.materialiseChange)(projectDir, entry, targetVersion, derived, (0, DiskLanguageRepository_1.phrases)(projectDir), opts);
+}
+//# sourceMappingURL=as_change.js.map

package/dist/scripts/specops/as_change.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"as_change.js","sourceRoot":"","sources":["../../../scripts/specops/as_change.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;;AAiCH,kCAYC;AAMD,8CAEC;AAnDD,0GAAwF;AACxF,4GAIwE;AACxE,wEAA2E;AAE3E,sEAUkD;AAThD,6GAAA,gBAAgB,OAAA;AAChB,mHAAA,sBAAsB,OAAA;AACtB,mHAAA,sBAAsB,OAAA;AACtB,mHAAA,sBAAsB,OAAA;AACtB,wGAAA,WAAW,OAAA;AACX,2GAAA,cAAc,OAAA;AACd,wGAAA,WAAW,OAAA;AAKb,0GAGwE;AAFtE,wHAAA,aAAa,OAAA;AACb,2HAAA,gBAAgB,OAAA;AAGlB;;;;;GAKG;AACH,SAAgB,WAAW,CAAC,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,IAAK;IACjE,MAAM,OAAO,GAAG,IAAI,IAAI,EAAE,CAAC;IAC3B,MAAM,OAAO,GAAG,WAAW,CAAC,CAAC,CAAC,IAAA,uCAAa,EAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACxE,MAAM,OAAO,GAAG,IAAA,uCAAa,EAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACnD,OAAO,IAAA,2BAAe,EACpB,OAAO,EACP,OAAO,EACP,MAAM,EACN,IAAA,gCAAO,EAAC,OAAO,CAAC,UAAU,CAAC,EAC3B,0CAAgB,EAChB,OAAO,CACR,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAgB,iBAAiB,CAAC,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,IAAK;IAChF,OAAO,IAAA,2CAAW,EAAC,UAAU,EAAE,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,IAAA,gCAAO,EAAC,UAAU,CAAC,EAAE,IAAI,CAAC,CAAC;AAC3F,CAAC"}