@rsaglobaltech/specgate 0.8.1

package/dist/bin/specgate.js

@@ -0,0 +1,342 @@
+#!/usr/bin/env node
+"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.CreateSpecDrivenAppCommand = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const rootDir = path.resolve(__dirname, "..", "..");
+const distScripts = path.join(__dirname, "..", "scripts");
+const packageJson = require(path.join(rootDir, "package.json"));
+const VERSION = packageJson.version || "0.0.0";
+const surface_1 = require("../scripts/lib/surface");
+/** Resolve a registry row's `script` segments to a path under dist/scripts. */
+function resolveScript(segments) {
+    return path.join(distScripts, ...segments);
+}
+// ── Pretty output helpers ─────────────────────────────────────────────────────────
+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" : "",
+    blue: COLOR_ENABLED ? "\x1b[34m" : "",
+    magenta: COLOR_ENABLED ? "\x1b[35m" : "",
+    cyan: COLOR_ENABLED ? "\x1b[36m" : "",
+};
+function info(msg) {
+    process.stdout.write(`${c.cyan}ℹ${c.reset}  ${msg}\n`);
+}
+function error(msg) {
+    process.stderr.write(`${c.red}✖${c.reset}  ${msg}\n`);
+}
+function banner() {
+    return (`\n` +
+        `  ${c.bold}${c.cyan}🧭 specgate${c.reset}  ${c.dim}v${VERSION}${c.reset}\n` +
+        `  ${c.dim}Specs as executable contracts — requirements, scenarios and traceability that CI enforces.${c.reset}\n`);
+}
+function section(title) {
+    return `\n  ${c.bold}${title}${c.reset}\n`;
+}
+function cmd(emoji, name, summary, pad = 16) {
+    // Use Array.from to count code points (emojis with surrogate pairs count as 1)
+    const visible = Array.from(name).length;
+    const padding = " ".repeat(Math.max(1, pad - visible));
+    return `    ${c.green}${emoji}${c.reset}  ${c.green}${name}${c.reset}${padding}${c.dim}${summary}${c.reset}\n`;
+}
+function flag(name, summary, pad = 18) {
+    const visible = Array.from(name).length;
+    const padding = " ".repeat(Math.max(1, pad - visible));
+    return `    ${c.green}${name}${c.reset}${padding}${c.dim}${summary}${c.reset}\n`;
+}
+function example(line, comment) {
+    const prefix = comment ? `    ${c.dim}# ${comment}${c.reset}\n` : "";
+    return `${prefix}    ${c.yellow}$${c.reset} ${line}\n`;
+}
+/**
+ * The worked examples of `--help --all`. Prose, not surface: they are chosen
+ * for what they teach, so they are declared here rather than derived.
+ */
+const EXAMPLES = example(`npx @rsaglobaltech/specgate@latest init`, "Generate a new project (wizard)") +
+    example(`npx @rsaglobaltech/specgate@latest adopt --project-dir ./my-existing-repo`, "Adopt SDD on an existing codebase") +
+    example(`npx @rsaglobaltech/specgate@latest init --config ./project.config --out ./projects`, "Generate a new project from a config file") +
+    example(`npx @rsaglobaltech/specgate@latest validate ./projects/my-app --strict-tdd`, "Validate with the TDD gate") +
+    example(`npx @rsaglobaltech/specgate@latest expand --pack-root ./domain-packs \\\n        --pack parking-management/backend --project-dir ./projects/my-app \\\n        --var PROJECT_NAME="My App" --var PROJECT_SLUG=my-app --var DOMAIN="parking ops"`, "Apply a local pack") +
+    example(`npx @rsaglobaltech/specgate@latest expand --pack-repo https://github.com/acme/parking-specops.git \\\n        --pack-version v0.1.0 --pack backend --project-dir ./projects/smart-parking \\\n        --var PROJECT_NAME="Smart Parking"`, "Apply a remote pack pinned to a git tag") +
+    example(`npx @rsaglobaltech/specgate@latest specops sync --project-dir ./projects/smart-parking`, "Re-expand everything in .specops.lock / specops.config.yaml") +
+    example(`npx @rsaglobaltech/specgate@latest specops diff --project-dir ./projects/smart-parking --pack-version v0.2.0`, "Preview a version bump") +
+    example(`npx @rsaglobaltech/specgate@latest plan --project-dir ./projects/smart-parking`, "Show what requirements still need work") +
+    example(`npx @rsaglobaltech/specgate@latest plan --project-dir ./projects/smart-parking --format json`, "Same, machine-readable for AI agents") +
+    example(`npx @rsaglobaltech/specgate@latest done REQ-007 --check`, "Mark REQ-007 Implemented (after validate passes)") +
+    example(`npx @rsaglobaltech/specgate@latest pack init --out ./domain-packs --name "Billing Backend" --type contracts`, "Scaffold a contracts-flavoured pack");
+/**
+ * The daily loop, narrowed.
+ *
+ * The surface grew past twenty, which is more than anyone reads. A new user
+ * needs `init` or `adopt` once, then lives in status → plan → req → change →
+ * validate → done. Everything else is real but not first — `--help --all`
+ * shows it, and `specgate config set profile full` makes that the default.
+ *
+ * Both help profiles are rendered from the surface registry, so a command
+ * cannot exist without appearing in one of them or being deliberately absent
+ * from both.
+ */
+function renderGroups(groups) {
+    return groups
+        .map((g) => section(g.title) + g.rows.map((r) => cmd(r.icon, r.label, r.summary)).join(""))
+        .join("");
+}
+function usageCore() {
+    process.stdout.write(banner() +
+        section("USAGE") +
+        `    ${c.cyan}specgate${c.reset} ${c.bold}<command>${c.reset} [options]\n` +
+        `    ${c.dim}Run ‘<command> --help’ for per-command details.${c.reset}\n` +
+        renderGroups((0, surface_1.coreHelpRows)()) +
+        section("MORE") +
+        `    ${c.dim}${(0, surface_1.hiddenCommandCount)()} more commands cover packs, automation, agents and reporting.${c.reset}\n` +
+        `    ${c.green}specgate --help --all${c.reset}${c.dim}                    show every command${c.reset}\n` +
+        `    ${c.green}specgate config set profile full${c.reset}${c.dim}         make that the default${c.reset}\n` +
+        section("EXAMPLES") +
+        example(`npx @rsaglobaltech/specgate@latest adopt`, "Existing codebase") +
+        example(`npx @rsaglobaltech/specgate@latest init`, "New project (wizard)") +
+        example(`specgate status`, "Start of day") +
+        "\n");
+}
+/**
+ * `core` unless the project says otherwise. Read from .csda/config.json so a
+ * team that lives in the full surface is not re-narrowed on every invocation.
+ */
+function helpProfile() {
+    if (process.env.CSDA_PROFILE)
+        return process.env.CSDA_PROFILE;
+    try {
+        const raw = fs.readFileSync(path.join(process.cwd(), ".csda", "config.json"), "utf8");
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed.profile === "string")
+            return parsed.profile;
+    }
+    catch {
+        // No config, unreadable, or malformed — core is the safe default.
+    }
+    return "core";
+}
+function usage(opts) {
+    if (opts && opts.all)
+        return usageFull();
+    if (helpProfile() === "full")
+        return usageFull();
+    return usageCore();
+}
+function usageFull() {
+    process.stdout.write(banner() +
+        section("USAGE") +
+        `    ${c.cyan}specgate${c.reset} ${c.bold}<command>${c.reset} [options]\n` +
+        `    ${c.dim}Run ‘<command> --help’ for per-command details.${c.reset}\n` +
+        renderGroups((0, surface_1.helpRows)()) +
+        section("GLOBAL FLAGS") +
+        flag("-h, --help", "Show this help.") +
+        flag("-v, --version", "Show CLI version.") +
+        section("EXAMPLES") +
+        EXAMPLES +
+        section("LEARN MORE") +
+        `    ${c.dim}📖 How-to guide   ${c.reset}${c.blue}https://github.com/rsaglobaltech/specgate/blob/main/docs/how-to.md${c.reset}\n` +
+        `    ${c.dim}🌐 Documentation  ${c.reset}${c.blue}https://rsaglobaltech.github.io/specgate/${c.reset}\n` +
+        `    ${c.dim}🪲 Report a bug   ${c.reset}${c.blue}https://github.com/rsaglobaltech/specgate/issues${c.reset}\n` +
+        `\n`);
+}
+function ensureExecutable(scriptPath) {
+    if (!fs.existsSync(scriptPath)) {
+        error(`Required script not found: ${scriptPath}`);
+        process.exit(3);
+    }
+}
+function runNodeScript(scriptPath, args) {
+    const result = (0, child_process_1.spawnSync)(process.execPath, [scriptPath, ...args], {
+        stdio: "inherit",
+        env: process.env,
+    });
+    if (result.error) {
+        error(`Failed to execute script: ${result.error.message}`);
+        process.exit(1);
+    }
+    if (result.signal) {
+        error(`Process terminated by signal: ${result.signal}`);
+        process.exit(1);
+    }
+    process.exit(typeof result.status === "number" ? result.status : 1);
+}
+class CreateSpecDrivenAppCommand {
+    execute(args = []) {
+        args = args.length ? args : process.argv.slice(2);
+        if (args.length === 0 || args[0] === "--help" || args[0] === "-h") {
+            usage({ all: args.includes("--all") });
+            process.exit(0);
+        }
+        if (args[0] === "--version" || args[0] === "-v") {
+            process.stdout.write(`${VERSION}\n`);
+            process.exit(0);
+        }
+        const command = args[0];
+        const row = surface_1.SURFACE.find((c) => c.name === command);
+        if (!row) {
+            info(`Unknown command: ${command}`);
+            usage();
+            process.exit(2);
+        }
+        // Three commands need more than a table row. Each is a genuine parsing
+        // decision, not a route, which is why it lives here and not in the registry.
+        if (command === "init")
+            return dispatchInit(args.slice(1));
+        if (command === "validate")
+            return dispatchValidate(args.slice(1));
+        if (command === "harness" && args[1] === "prompt")
+            return dispatchHarnessPrompt(args);
+        // A command with its own script owns its sub-commands: the dispatcher hands
+        // the whole tail over and the script reports an unknown one in its own words.
+        if (row.script) {
+            const target = resolveScript(row.script);
+            ensureExecutable(target);
+            runNodeScript(target, args.slice(1));
+            return;
+        }
+        // Otherwise the sub-command is the route, and an unknown one stops here.
+        const subName = args[1];
+        const sub = (row.subcommands || []).find((s) => s.name === subName);
+        if (!sub) {
+            const expected = (row.subcommands || []).map((s) => s.name).join(", ");
+            error(`Unknown ${command} sub-command: ${subName || "(none)"}. Expected: ${expected}`);
+            usage();
+            process.exit(2);
+        }
+        const target = resolveScript(sub.script);
+        ensureExecutable(target);
+        runNodeScript(target, args.slice(sub.argsFrom === undefined ? 2 : sub.argsFrom));
+    }
+}
+exports.CreateSpecDrivenAppCommand = CreateSpecDrivenAppCommand;
+/**
+ * `init` is two commands wearing one name: `--from-pack` composes it with
+ * `specops add`, which needs its own orchestrator rather than another flag
+ * inside init.
+ */
+function dispatchInit(passThrough) {
+    // Reject --engine=shell — the Bash engine was removed in this release.
+    const engineIdx = passThrough.indexOf("--engine");
+    if (passThrough.includes("--engine=shell") ||
+        (engineIdx !== -1 && passThrough[engineIdx + 1] === "shell")) {
+        error("--engine=shell was removed. The CLI is now Node-only. Drop the flag to use the (sole) Node engine.");
+        process.exit(2);
+    }
+    const script = passThrough.includes("--from-pack")
+        ? resolveScript(["init_from_pack.js"])
+        : resolveScript(["init_project.js"]);
+    ensureExecutable(script);
+    runNodeScript(script, passThrough);
+}
+/**
+ * `validate` is the gate, so a typo in a flag must not read as "nothing to
+ * report". It is the one command whose arguments the dispatcher checks.
+ */
+function dispatchValidate(validateArgs) {
+    const script = resolveScript(["validate_specs.js"]);
+    ensureExecutable(script);
+    const positional = validateArgs.filter((a) => !a.startsWith("-"));
+    if (positional.length !== 1) {
+        error(`'validate' expects exactly one positional argument: <project_dir>`);
+        usage();
+        process.exit(2);
+    }
+    const VALIDATE_FLAGS = new Set([
+        "--strict-tdd",
+        "--strict-scenarios",
+        "--strict-requirements",
+        "--strict-links",
+        "--against-lock",
+        "--json",
+    ]);
+    const unknownFlags = validateArgs.filter((a) => a.startsWith("-") && !VALIDATE_FLAGS.has(a));
+    if (unknownFlags.length > 0) {
+        error(`Unknown flag(s) for validate: ${unknownFlags.join(", ")}`);
+        usage();
+        process.exit(2);
+    }
+    runNodeScript(script, validateArgs);
+}
+/**
+ * `harness prompt <REQ-id>` is a friendly alias for `harness run --dry-run
+ * --req <REQ>`: it prints the prompt the agent would receive, with no git, no
+ * agent and no gate.
+ */
+function dispatchHarnessPrompt(args) {
+    const reqId = args[2];
+    if (!reqId || !/^REQ-\d+$/.test(reqId)) {
+        error("`harness prompt` expects a REQ-id, e.g. `specgate harness prompt REQ-001`.");
+        usage();
+        process.exit(2);
+    }
+    const script = resolveScript(["harness", "run.js"]);
+    ensureExecutable(script);
+    runNodeScript(script, ["--dry-run", "--req", reqId, ...args.slice(3)]);
+}
+/**
+ * Run when this module *is* the entry point, or when the published `bin/` shim
+ * required it.
+ *
+ * The shim is two lines — `require("../dist/bin/specgate.js")` — so
+ * `require.main` is the shim and not this module, and the check has to
+ * recognise it by name.
+ *
+ * Compare on the basename. An earlier form asked
+ * `filename.endsWith("bin/specgate.js")`, and on Windows
+ * `filename` is `bin\specgate.js`, so it never matched: the CLI
+ * loaded, dispatched nothing, and exited 0 with no output on either stream.
+ * Every test that spawns the CLI failed — 437 of them — and none of the
+ * messages said why, because there was no message.
+ *
+ * It survived because this branch had never been through CI, and the two
+ * platforms it was developed on both use `/`.
+ */
+const isEntryPoint = require.main === module ||
+    (require.main
+        ? ["specgate.js", "specgate.js"].includes(path.basename(require.main.filename))
+        : false);
+if (isEntryPoint) {
+    new CreateSpecDrivenAppCommand().execute();
+}
+//# sourceMappingURL=specgate.js.map

package/dist/bin/specgate.js.map

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

package/dist/packages/core/src/application/AddRequirementUseCase.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AddRequirementUseCase = void 0;
+const TraceabilityMatrix_1 = require("../domain/TraceabilityMatrix");
+const TraceabilityFormat_1 = require("../domain/TraceabilityFormat");
+class AddRequirementUseCase {
+    traceRepo;
+    constructor(traceRepo) {
+        this.traceRepo = traceRepo;
+    }
+    execute(projectDir, fields) {
+        const rawContent = this.traceRepo.readTraceability(projectDir) || "";
+        const parsed = rawContent ? (0, TraceabilityFormat_1.parseTraceabilityRows)(rawContent) : { rows: [] };
+        const result = TraceabilityMatrix_1.TraceabilityMatrix.appendRequirement(rawContent, fields, parsed.rows || []);
+        this.traceRepo.writeTraceability(projectDir, result.content);
+        return {
+            ok: true,
+            reqId: result.reqId,
+            scenarioId: result.scenarioId,
+        };
+    }
+}
+exports.AddRequirementUseCase = AddRequirementUseCase;
+//# sourceMappingURL=AddRequirementUseCase.js.map

package/dist/packages/core/src/application/AddRequirementUseCase.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AddRequirementUseCase.js","sourceRoot":"","sources":["../../../../../packages/core/src/application/AddRequirementUseCase.ts"],"names":[],"mappings":";;;AACA,qEAAkE;AAClE,qEAAqE;AAuBrE,MAAa,qBAAqB;IACZ;IAApB,YAAoB,SAAkC;QAAlC,cAAS,GAAT,SAAS,CAAyB;IAAG,CAAC;IAEnD,OAAO,CAAC,UAAkB,EAAE,MAA4B;QAC7D,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;QACrE,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,IAAA,0CAAqB,EAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;QAE7E,MAAM,MAAM,GAAG,uCAAkB,CAAC,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAC3F,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;QAE7D,OAAO;YACL,EAAE,EAAE,IAAI;YACR,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,UAAU,EAAE,MAAM,CAAC,UAAU;SAC9B,CAAC;IACJ,CAAC;CACF;AAhBD,sDAgBC"}

package/dist/packages/core/src/application/ArchiveChangeUseCase.js

@@ -0,0 +1,185 @@
+"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.ArchiveChangeUseCase = void 0;
+const path = __importStar(require("node:path"));
+const ArchivePlan_1 = require("../domain/ArchivePlan");
+const DeltaSpec_1 = require("../domain/DeltaSpec");
+const TraceabilityMatrix_1 = require("../domain/TraceabilityMatrix");
+const SpecParser_1 = require("../domain/SpecParser");
+const Diagnostic_1 = require("../domain/Diagnostic");
+class ArchiveChangeUseCase {
+    repo;
+    constructor(repo) {
+        this.repo = repo;
+    }
+    execute(changeId, opts) {
+        const o = opts || {};
+        const plan = new ArchivePlan_1.ArchivePlan();
+        if (!this.repo.changeExists(changeId)) {
+            plan.diagnostics.push((0, Diagnostic_1.error)("archive_change_not_found", `Change "${changeId}" does not exist.`, {
+                target: changeId,
+                fix: `Run \`specgate change list\` to see active changes.`,
+            }));
+            return plan;
+        }
+        if (this.repo.isChangeSymlink(changeId)) {
+            plan.diagnostics.push((0, Diagnostic_1.error)("archive_change_symlink", `Change "${changeId}" is a symlink; refusing to archive.`, {
+                target: changeId,
+                fix: "Replace the symlink with a real directory.",
+            }));
+            return plan;
+        }
+        const config = this.repo.readConfig(changeId);
+        const progress = this.repo.getTaskProgress(changeId);
+        if (progress.remaining > 0 && !o.force) {
+            plan.diagnostics.push((0, Diagnostic_1.error)("archive_tasks_incomplete", `Change "${changeId}" still has ${progress.remaining} unchecked task(s).`, {
+                target: changeId,
+                fix: "Finish the tasks, or pass --force to archive anyway.",
+            }));
+        }
+        const deltas = config.skip_specs ? [] : this.repo.listDeltas(changeId);
+        if (!config.skip_specs && deltas.length === 0) {
+            plan.warnings.push((0, Diagnostic_1.warning)("archive_no_deltas", `Change "${changeId}" carries no delta specs.`, {
+                target: changeId,
+                fix: "Set `skip_specs: true` in change.yaml if this change does not alter behaviour.",
+            }));
+        }
+        const applied = { upserts: [], removals: [] };
+        const p = this.repo.getPaths();
+        for (const entry of deltas) {
+            const deltaSource = this.repo.readFile(entry.file) || "";
+            const specFile = p.capabilitySpec(entry.capability);
+            const specSource = this.repo.readFile(specFile);
+            const { diagnostics: deltaDiags } = DeltaSpec_1.DeltaSpec.validate(deltaSource, {
+                specSource,
+                file: entry.relative,
+            });
+            for (const d of deltaDiags) {
+                if (d.severity === "error")
+                    plan.diagnostics.push(d);
+                else
+                    plan.warnings.push(d);
+            }
+            if (deltaDiags.some((d) => d.severity === "error"))
+                continue;
+            const merged = DeltaSpec_1.DeltaSpec.apply(specSource, deltaSource, {
+                title: this.capabilityTitle(entry.capability),
+            });
+            plan.totals.added += merged.applied.added.length;
+            plan.totals.modified += merged.applied.modified.length;
+            plan.totals.removed += merged.applied.removed.length;
+            const parsedDelta = (0, SpecParser_1.parseDelta)(deltaSource);
+            for (const req of [...parsedDelta.added, ...parsedDelta.modified]) {
+                applied.upserts.push({ req, capability: entry.capability });
+            }
+            for (const req of parsedDelta.removed) {
+                applied.removals.push(req.id || req.name);
+            }
+            if (merged.retired) {
+                if (config.retire_capabilities) {
+                    plan.deletes.push({ file: specFile, reason: "capability_retired" });
+                    plan.totals.specsRetired++;
+                    plan.warnings.push((0, Diagnostic_1.warning)("archive_capability_retired", `Capability "${entry.capability}" lost its last requirement and its spec was deleted.`, {
+                        target: entry.capability,
+                        file: path.relative(p.root, specFile),
+                        fix: `Recover with: git checkout HEAD -- ${path.relative(p.root, specFile)}`,
+                    }));
+                }
+                else {
+                    plan.diagnostics.push((0, Diagnostic_1.error)("archive_retire_not_declared", `Change "${changeId}" removes the last requirement of "${entry.capability}" but does not declare retire_capabilities.`, {
+                        target: entry.capability,
+                        fix: "Set `retire_capabilities: true` in change.yaml to confirm the capability should disappear.",
+                    }));
+                }
+            }
+            else {
+                plan.writes.push({ file: specFile, contents: merged.markdown, kind: "spec" });
+                plan.totals.specsWritten++;
+            }
+        }
+        for (const feature of this.repo.listChangeFeatures(changeId)) {
+            const target = path.join(p.root, "features", feature.relative);
+            if (this.repo.readFile(target) !== null && !o.force) {
+                plan.warnings.push((0, Diagnostic_1.warning)("archive_feature_exists", `features/${feature.relative} already exists and was left untouched.`, {
+                    target: `features/${feature.relative}`,
+                    fix: "Delete or merge the existing file, or re-run with --force to overwrite.",
+                }));
+                continue;
+            }
+            plan.writes.push({
+                file: target,
+                contents: this.repo.readFile(feature.file) || "",
+                kind: "feature",
+            });
+        }
+        let traceTotals = { added: 0, updated: 0, removed: 0, legacyDropped: 0 };
+        if (applied.upserts.length > 0 || applied.removals.length > 0) {
+            const existingContent = this.repo.readFile(p.traceability);
+            const synced = TraceabilityMatrix_1.TraceabilityMatrix.syncTraceability(existingContent, applied);
+            traceTotals = synced.totals;
+            plan.writes.push({ file: p.traceability, contents: synced.markdown, kind: "traceability" });
+            if (synced.totals.legacyDropped > 0) {
+                plan.warnings.push((0, Diagnostic_1.warning)("traceability_upgraded", `traceability.md used the legacy 4-column format; ${synced.totals.legacyDropped} row(s) could not be carried over.`, {
+                    file: path.relative(p.root, p.traceability),
+                    fix: "Re-add those rows in the 10-column format, or restore from git and migrate by hand.",
+                }));
+            }
+        }
+        plan.totals.traceability = traceTotals;
+        const archivedAs = `${o.stamp || this.todayStamp(o.now)}-${changeId}`;
+        plan.move = { from: p.change(changeId), to: path.join(p.archive, archivedAs) };
+        if (this.repo.readFile(plan.move.to) !== null || this.repo.changeExists(plan.move.to)) {
+            plan.diagnostics.push((0, Diagnostic_1.error)("archive_target_exists", `Archive entry "${archivedAs}" already exists.`, {
+                target: archivedAs,
+                fix: "Rename the change, or remove the existing archive entry.",
+            }));
+        }
+        return plan;
+    }
+    capabilityTitle(capability) {
+        return String(capability)
+            .split("/")
+            .map((part) => part.replace(/[-_]+/g, " ").replace(/\b\w/g, (ch) => ch.toUpperCase()))
+            .join(" / ");
+    }
+    todayStamp(now) {
+        const d = now instanceof Date ? now : new Date();
+        const pad = (n) => String(n).padStart(2, "0");
+        return `${d.getFullYear()}-${pad(d.getMonth() + 1)}-${pad(d.getDate())}`;
+    }
+}
+exports.ArchiveChangeUseCase = ArchiveChangeUseCase;
+//# sourceMappingURL=ArchiveChangeUseCase.js.map

package/dist/packages/core/src/application/ArchiveChangeUseCase.js.map

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