@rsaglobaltech/specgate 0.8.1

package/dist/scripts/lib/capability-specs.js

@@ -0,0 +1,80 @@
+"use strict";
+/**
+ * The one reader of `docs/specs/capabilities/**\/spec.md`.
+ *
+ * Two callers need this: `specgate report` (§8.6, declared-value drift) and
+ * `specgate change new --from-value-drift` (three-routes resolution). Each wrote
+ * its own copy first; the F1/A3 lesson is that two hand-written readers of
+ * the same thing drift, so this is the single one both import.
+ *
+ * Absent entirely on most projects — `specgate init` never writes this
+ * directory, it belongs to the change-lifecycle structure (`specgate change`).
+ * No directory is not an error here; it is "nothing to read yet".
+ */
+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.readCapabilityRequirements = readCapabilityRequirements;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const SpecParser_1 = require("../../packages/core/src/domain/SpecParser");
+const ChangeWorkspace_1 = require("../../packages/core/src/infrastructure/ChangeWorkspace");
+function readCapabilityRequirements(projectDir) {
+    const capabilitiesDir = path.join(projectDir, ChangeWorkspace_1.CAPABILITIES_DIR);
+    if (!fs.existsSync(capabilitiesDir))
+        return [];
+    const out = [];
+    const entries = fs
+        .readdirSync(capabilitiesDir, { withFileTypes: true })
+        .filter((e) => e.isDirectory())
+        .sort((a, b) => a.name.localeCompare(b.name));
+    for (const entry of entries) {
+        const specPath = path.join(capabilitiesDir, entry.name, "spec.md");
+        if (!fs.existsSync(specPath))
+            continue;
+        const rel = path.relative(projectDir, specPath).split(path.sep).join("/");
+        let spec;
+        try {
+            spec = (0, SpecParser_1.parseSpec)(fs.readFileSync(specPath, "utf8"));
+        }
+        catch {
+            continue;
+        }
+        for (const req of spec.requirements || []) {
+            out.push({ req, capability: entry.name, specFile: rel });
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=capability-specs.js.map

package/dist/scripts/lib/capability-specs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability-specs.js","sourceRoot":"","sources":["../../../scripts/lib/capability-specs.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAgBH,gEAwBC;AAtCD,4CAA8B;AAC9B,gDAAkC;AAClC,0EAAsE;AACtE,4FAA0F;AAW1F,SAAgB,0BAA0B,CAAC,UAAkB;IAC3D,MAAM,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,kCAAgB,CAAC,CAAC;IAChE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,eAAe,CAAC;QAAE,OAAO,EAAE,CAAC;IAE/C,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,MAAM,OAAO,GAAG,EAAE;SACf,WAAW,CAAC,eAAe,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;SACrD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;SAC9B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAChD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,KAAK,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACnE,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,SAAS;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC1E,IAAI,IAAS,CAAC;QACd,IAAI,CAAC;YACH,IAAI,GAAG,IAAA,sBAAS,EAAC,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;QACtD,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,YAAY,IAAI,EAAE,EAAE,CAAC;YAC1C,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/scripts/lib/command.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseCommand = void 0;
+class BaseCommand {
+    args;
+    constructor(args = []) {
+        this.args = args;
+    }
+    error(msg) {
+        process.stderr.write(`\x1b[31m✖\x1b[0m  ${msg}\n`);
+    }
+    info(msg) {
+        process.stdout.write(`\x1b[36mℹ\x1b[0m  ${msg}\n`);
+    }
+}
+exports.BaseCommand = BaseCommand;
+//# sourceMappingURL=command.js.map

package/dist/scripts/lib/command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.js","sourceRoot":"","sources":["../../../scripts/lib/command.ts"],"names":[],"mappings":";;;AAIA,MAAsB,WAAW;IACrB,IAAI,CAAW;IAEzB,YAAY,OAAiB,EAAE;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAIS,KAAK,CAAC,GAAW;QACzB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAAC;IACrD,CAAC;IAES,IAAI,CAAC,GAAW;QACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAAC;IACrD,CAAC;CACF;AAhBD,kCAgBC"}

package/dist/scripts/lib/diagnostics.js

@@ -0,0 +1,62 @@
+"use strict";
+/**
+ * Rendering diagnostics for a human at a terminal.
+ *
+ * The envelope itself — the `Diagnostic` shape, its constructors and its
+ * predicates — is domain, and lives in `packages/core/src/domain/Diagnostic`.
+ * This module is the delivery half: colours, stream writes and the `--json`
+ * failure shape. It re-exports the domain half so the ~28 existing importers
+ * keep one import site.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.errorMessage = exports.countBySeverity = exports.hasErrors = exports.info = exports.warning = exports.error = exports.diagnostic = exports.SEVERITY = void 0;
+exports.formatDiagnostic = formatDiagnostic;
+exports.printDiagnostics = printDiagnostics;
+exports.failJson = failJson;
+const Diagnostic_1 = require("../../packages/core/src/domain/Diagnostic");
+var Diagnostic_2 = require("../../packages/core/src/domain/Diagnostic");
+Object.defineProperty(exports, "SEVERITY", { enumerable: true, get: function () { return Diagnostic_2.SEVERITY; } });
+Object.defineProperty(exports, "diagnostic", { enumerable: true, get: function () { return Diagnostic_2.diagnostic; } });
+Object.defineProperty(exports, "error", { enumerable: true, get: function () { return Diagnostic_2.error; } });
+Object.defineProperty(exports, "warning", { enumerable: true, get: function () { return Diagnostic_2.warning; } });
+Object.defineProperty(exports, "info", { enumerable: true, get: function () { return Diagnostic_2.info; } });
+Object.defineProperty(exports, "hasErrors", { enumerable: true, get: function () { return Diagnostic_2.hasErrors; } });
+Object.defineProperty(exports, "countBySeverity", { enumerable: true, get: function () { return Diagnostic_2.countBySeverity; } });
+Object.defineProperty(exports, "errorMessage", { enumerable: true, get: function () { return Diagnostic_2.errorMessage; } });
+// ── Human rendering ───────────────────────────────────────────────────────────
+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" : "",
+    yellow: COLOR_ENABLED ? "\x1b[33m" : "",
+    cyan: COLOR_ENABLED ? "\x1b[36m" : "",
+};
+const MARK = {
+    [Diagnostic_1.SEVERITY.ERROR]: `${c.red}✖${c.reset}`,
+    [Diagnostic_1.SEVERITY.WARNING]: `${c.yellow}▲${c.reset}`,
+    [Diagnostic_1.SEVERITY.INFO]: `${c.cyan}ℹ${c.reset}`,
+};
+function formatDiagnostic(d) {
+    const where = d.file ? `${d.file}${d.line ? `:${d.line}` : ""}` : d.target || "";
+    const head = `${MARK[d.severity] || "-"}  ${where ? `${c.dim}${where}${c.reset} ` : ""}${d.message}`;
+    const fix = d.fix ? `\n     ${c.dim}fix:${c.reset} ${d.fix}` : "";
+    const code = `${c.dim}[${d.code}]${c.reset}`;
+    return `${head} ${code}${fix}`;
+}
+function printDiagnostics(diags, stream) {
+    const out = stream || process.stderr;
+    for (const d of diags || [])
+        out.write(`${formatDiagnostic(d)}\n`);
+}
+/**
+ * The failure shape for `--json` mode: one JSON document on stdout carrying the
+ * command's null-shape plus the diagnostics, and exit 1. Prose never goes to
+ * stdout in JSON mode, so a consumer can always `| jq .`.
+ */
+function failJson(nullShape, diags) {
+    process.stdout.write(`${JSON.stringify({ ...nullShape, status: diags }, null, 2)}\n`);
+    process.exit(1);
+}
+//# sourceMappingURL=diagnostics.js.map

package/dist/scripts/lib/diagnostics.js.map

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

package/dist/scripts/lib/monorepo-fanout.js

@@ -0,0 +1,118 @@
+"use strict";
+/**
+ * `projects:` fan-out, shared (E2-06 / issue #104).
+ *
+ * `specgate validate` has always fanned out over `specops.config.yaml`'s
+ * `projects:` list (`ValidateSpecsCommand.ts`'s `validateMonorepo`) — a
+ * monorepo declares its sibling project directories once, and `validate`
+ * walks them. Measured before writing this: nothing else did. `plan`,
+ * `status` and `report` only ever saw the root project, silently — a
+ * two-project monorepo reported `requirements seen: 1`, not an error, just
+ * wrong.
+ *
+ * This is that same pattern, extracted so a third and fourth command don't
+ * each carry their own copy to drift from `validate`'s (the F1/A3 lesson,
+ * applied again). Not a model change: each sub-project still answers for
+ * itself via its own compiled script, run as a child process exactly as
+ * `validate` already does it — this only removes the copy-paste.
+ *
+ * **Human output only**, matching the existing precedent: `validate`'s own
+ * monorepo mode always prints prose, even under `--json` — it does not
+ * aggregate child JSON documents into one. This does not attempt to solve
+ * that either; it only extends the same behaviour to three more commands.
+ */
+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.runMonorepoFanout = runMonorepoFanout;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+const YamlLite_1 = require("../../packages/core/src/domain/YamlLite");
+const project_root_1 = require("./project-root");
+/**
+ * Runs `scriptName` once per `projects:` entry, in a child process, with
+ * `extraArgs` plus `--project-dir <subDir>` appended. Returns `null` when
+ * `targetDir` carries no `specops.config.yaml` or no `projects:` list — the
+ * caller's cue to proceed with `targetDir` itself as a single project.
+ */
+function runMonorepoFanout(targetDir, scriptName, extraArgs = []) {
+    const cfgPath = path.join(targetDir, "specops.config.yaml");
+    if (!fs.existsSync(cfgPath))
+        return null;
+    let cfg;
+    try {
+        cfg = (0, YamlLite_1.parseYamlLite)(fs.readFileSync(cfgPath, "utf8"));
+    }
+    catch {
+        return null;
+    }
+    const projects = cfg && Array.isArray(cfg.projects) ? cfg.projects : null;
+    if (!projects || projects.length === 0)
+        return null;
+    process.stdout.write(`🗂️ Monorepo: running ${scriptName} on ${projects.length} project(s) from specops.config.yaml\n`);
+    const results = [];
+    const root = (0, project_root_1.findCliRoot)(__dirname);
+    for (const entry of projects) {
+        const rel = typeof entry === "string" ? entry : entry && entry.path;
+        if (!rel) {
+            results.push({ project: String(entry), ok: false, detail: "invalid projects entry" });
+            continue;
+        }
+        const subDir = path.join(targetDir, rel);
+        process.stdout.write(`\n── ${rel} ──\n`);
+        if (!fs.existsSync(subDir)) {
+            process.stderr.write(`✖  Project directory not found: ${rel}\n`);
+            process.stderr.write(`   fix: Fix the 'projects:' entry in specops.config.yaml or create ${rel}.\n`);
+            results.push({ project: rel, ok: false, detail: "directory not found" });
+            continue;
+        }
+        const scriptPath = fs.existsSync(path.join(root, "dist", "scripts", scriptName))
+            ? path.join(root, "dist", "scripts", scriptName)
+            : path.join(root, "scripts", scriptName);
+        const args = [scriptPath, ...extraArgs, "--project-dir", subDir];
+        const r = (0, node_child_process_1.spawnSync)(process.execPath, args, { encoding: "utf8" });
+        process.stdout.write(r.stdout || "");
+        process.stderr.write(r.stderr || "");
+        results.push({ project: rel, ok: r.status === 0 });
+    }
+    const failures = results.filter((r) => !r.ok);
+    process.stdout.write("\n── monorepo summary ──\n");
+    for (const r of results) {
+        process.stdout.write(`  ${r.ok ? "✅" : "❌"} ${r.project}${r.detail ? ` (${r.detail})` : ""}\n`);
+    }
+    process.stdout.write(`\n${failures.length === 0 ? "✅" : "❌"} ${results.length - failures.length}/${results.length} project(s) done\n`);
+    return { failures: failures.length };
+}
+//# sourceMappingURL=monorepo-fanout.js.map

package/dist/scripts/lib/monorepo-fanout.js.map

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

package/dist/scripts/lib/placeholders.js

@@ -0,0 +1,190 @@
+"use strict";
+// csda:allow-placeholders — this module is the {{VAR}} scanner itself.
+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.SKIP_DIRS = exports.PLACEHOLDER_ALLOW_RE = exports.PLACEHOLDER_RE = void 0;
+exports.walk = walk;
+exports.isExempt = isExempt;
+exports.findUnresolvedPlaceholders = findUnresolvedPlaceholders;
+exports.missingVariables = missingVariables;
+/**
+ * The one unresolved-placeholder scan.
+ *
+ * `validate` and `doctor` each had their own copy, and they drifted: fixing
+ * `validate` to skip dependency trees, template files and documentation that
+ * quotes the syntax left `doctor` reporting 64 errors on this very repository,
+ * every one of them a false positive. Two checkers answering the same question
+ * differently is worse than one imperfect checker.
+ */
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+const node_child_process_1 = require("node:child_process");
+exports.PLACEHOLDER_RE = /\{\{[A-Z_][A-Z0-9_]*\}\}/;
+/**
+ * Syntax-neutral on purpose: put it in whatever comment form the file uses —
+ * `<!-- csda:allow-placeholders -->` in markdown, `// csda:allow-placeholders`
+ * in code. Same convention as the `csda:trace` marker.
+ */
+exports.PLACEHOLDER_ALLOW_RE = /csda:allow-placeholders/;
+/**
+ * Never scanned: dependency trees and build output are not the project's specs,
+ * and template libraries inside node_modules are full of {{...}} tokens that
+ * would report as unresolved placeholders in any project with dependencies
+ * installed.
+ */
+exports.SKIP_DIRS = new Set([
+    "node_modules",
+    "dist",
+    "build",
+    "out",
+    "target",
+    "coverage",
+    // Generated reports — mutation HTML embeds mutated source, template tokens
+    // and all.
+    "reports",
+    "vendor",
+    ".git",
+    ".next",
+    ".gradle",
+    ".specops",
+]);
+/**
+ * Paths git is told to ignore, asked of git itself.
+ *
+ * SKIP_DIRS is a fixed list and cannot know what a given project ignores. This
+ * repository generates a `book/` directory that is gitignored and full of
+ * `{{VAR}}` — because it documents the placeholder syntax — and `validate`
+ * reported every one of them as an unresolved placeholder. A project's own
+ * ignore file already states what is not source; asking it is more honest than
+ * growing the list one report at a time.
+ *
+ * Best-effort: no git, no repository, or a git that errors means an empty set
+ * and the fixed list alone. A scan that refuses to run without git would be a
+ * worse failure than the one it prevents.
+ */
+function gitIgnoredNames(dir) {
+    const ignored = new Set();
+    try {
+        const r = (0, node_child_process_1.spawnSync)("git", ["-C", dir, "ls-files", "--others", "--ignored", "--exclude-standard", "--directory"], {
+            encoding: "utf8",
+            maxBuffer: 8 * 1024 * 1024,
+        });
+        if (r.status !== 0 || !r.stdout)
+            return ignored;
+        for (const line of r.stdout.split("\n")) {
+            const trimmed = line.trim().replace(/\/$/, "");
+            if (trimmed)
+                ignored.add(path.resolve(dir, trimmed));
+        }
+    }
+    catch {
+        // git is optional here — see the docblock.
+    }
+    return ignored;
+}
+function walk(dir, ignored = null) {
+    const skipIgnored = ignored || gitIgnoredNames(dir);
+    const out = [];
+    let entries;
+    try {
+        entries = fs.readdirSync(dir, { withFileTypes: true });
+    }
+    catch {
+        return out;
+    }
+    for (const entry of entries) {
+        if (entry.isDirectory() && exports.SKIP_DIRS.has(entry.name))
+            continue;
+        const full = path.join(dir, entry.name);
+        if (skipIgnored.has(path.resolve(full)))
+            continue;
+        if (entry.isDirectory())
+            out.push(...walk(full, skipIgnored));
+        else
+            out.push(full);
+    }
+    return out;
+}
+/** True when the file is exempt for a stated reason, rather than by accident. */
+function isExempt(file, content) {
+    // A .tpl file is unrendered by definition — its {{VAR}} tokens are the point,
+    // not a defect. Generated projects never contain .tpl files, so this does not
+    // weaken the check for the projects the gate is aimed at; it only stops it
+    // firing on template and pack repositories.
+    if (file.endsWith(".tpl"))
+        return true;
+    // Documentation that explains the template syntax has to be able to quote it.
+    // An explicit per-file opt-out keeps that honest: you have to say so.
+    return exports.PLACEHOLDER_ALLOW_RE.test(content);
+}
+/**
+ * Every file under `rootDir` that still carries an unresolved `{{TOKEN}}`,
+ * as paths relative to `rootDir` with POSIX separators.
+ */
+function findUnresolvedPlaceholders(rootDir) {
+    const offenders = [];
+    for (const file of walk(rootDir)) {
+        let content;
+        try {
+            content = fs.readFileSync(file, "utf8");
+        }
+        catch {
+            continue;
+        }
+        if (isExempt(file, content))
+            continue;
+        if (exports.PLACEHOLDER_RE.test(content)) {
+            offenders.push(path.relative(rootDir, file).split(path.sep).join("/"));
+        }
+    }
+    return offenders;
+}
+/** The distinct variable names still unresolved, for an actionable message. */
+function missingVariables(rootDir, offenders) {
+    const names = new Set();
+    for (const rel of offenders) {
+        let content;
+        try {
+            content = fs.readFileSync(path.join(rootDir, rel), "utf8");
+        }
+        catch {
+            continue;
+        }
+        for (const m of content.matchAll(/\{\{([A-Z_][A-Z0-9_]*)\}\}/g))
+            names.add(m[1]);
+    }
+    return [...names].sort();
+}
+//# sourceMappingURL=placeholders.js.map

package/dist/scripts/lib/placeholders.js.map

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

package/dist/scripts/lib/project-root.js

@@ -0,0 +1,124 @@
+"use strict";
+/**
+ * Tiny shared helper used by every command that operates on a project
+ * directory (plan, done, specops sync/diff/add/remove).
+ *
+ * Auto-detection walks up from cwd looking for spec-driven sentinels:
+ *   - spec.md
+ *   - .specops.lock
+ *   - specops.config.yaml
+ *
+ * The user can always override with `--project-dir <path>`.
+ */
+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.SENTINELS = void 0;
+exports.isSpecDrivenDir = isSpecDrivenDir;
+exports.findProjectRoot = findProjectRoot;
+exports.resolveProjectDir = resolveProjectDir;
+exports.findCliRoot = findCliRoot;
+const fs = __importStar(require("node:fs"));
+const path = __importStar(require("node:path"));
+exports.SENTINELS = ["spec.md", ".specops.lock", "specops.config.yaml"];
+function isSpecDrivenDir(dir) {
+    for (const name of exports.SENTINELS) {
+        if (fs.existsSync(path.join(dir, name)))
+            return true;
+    }
+    return false;
+}
+// Canonicalise a path through fs.realpathSync so macOS symlinks (e.g. /tmp →
+// /private/tmp) don't cause path-equality surprises downstream — both for the
+// JSON output of `plan` and for assertions in unit tests. Falls back to the
+// input when the path does not yet exist on disk.
+function canonical(p) {
+    try {
+        return fs.realpathSync(p);
+    }
+    catch {
+        return p;
+    }
+}
+function findProjectRoot(start) {
+    let dir = path.resolve(start);
+    const { root } = path.parse(dir);
+    while (true) {
+        if (isSpecDrivenDir(dir))
+            return canonical(dir);
+        if (dir === root)
+            return null;
+        dir = path.dirname(dir);
+    }
+}
+/**
+ * Resolve a project directory:
+ *   1. If `explicit` was passed (and is not the default "."), use it.
+ *   2. Otherwise walk up from cwd looking for sentinels.
+ *   3. Fall back to cwd.
+ *
+ * The returned path is always canonicalised through `fs.realpathSync` when the
+ * directory exists, so cross-platform behaviour (notably macOS /tmp symlinks)
+ * stays consistent.
+ *
+ * Pass `requireSentinel: true` to throw when no sentinel is found AND the
+ * user did not pass --project-dir.
+ */
+function resolveProjectDir(explicit, opts) {
+    const passed = explicit && explicit !== "." ? explicit : null;
+    if (passed)
+        return canonical(path.resolve(passed));
+    const found = findProjectRoot(process.cwd());
+    if (found)
+        return found;
+    if (opts && opts.requireSentinel) {
+        throw new Error("No spec-driven project detected in this directory tree. " +
+            "Run from a directory that contains spec.md, .specops.lock, or specops.config.yaml, " +
+            "or pass --project-dir explicitly.");
+    }
+    return canonical(path.resolve(process.cwd()));
+}
+function findCliRoot(startDir = __dirname) {
+    let dir = path.resolve(startDir);
+    const { root } = path.parse(dir);
+    while (true) {
+        if (fs.existsSync(path.join(dir, "package.json")))
+            return dir;
+        if (dir === root)
+            break;
+        dir = path.dirname(dir);
+    }
+    return path.resolve(__dirname, "..", "..");
+}
+//# sourceMappingURL=project-root.js.map

package/dist/scripts/lib/project-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-root.js","sourceRoot":"","sources":["../../../scripts/lib/project-root.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAOH,0CAKC;AAcD,0CAQC;AAeD,8CAeC;AAED,kCASC;AAzED,4CAA8B;AAC9B,gDAAkC;AAErB,QAAA,SAAS,GAAG,CAAC,SAAS,EAAE,eAAe,EAAE,qBAAqB,CAAC,CAAC;AAE7E,SAAgB,eAAe,CAAC,GAAG;IACjC,KAAK,MAAM,IAAI,IAAI,iBAAS,EAAE,CAAC;QAC7B,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAAE,OAAO,IAAI,CAAC;IACvD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,6EAA6E;AAC7E,8EAA8E;AAC9E,4EAA4E;AAC5E,kDAAkD;AAClD,SAAS,SAAS,CAAC,CAAC;IAClB,IAAI,CAAC;QACH,OAAO,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IAC5B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED,SAAgB,eAAe,CAAC,KAAK;IACnC,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IAC9B,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,eAAe,CAAC,GAAG,CAAC;YAAE,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC;QAChD,IAAI,GAAG,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC9B,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,SAAgB,iBAAiB,CAAC,QAAgB,EAAE,IAAoC;IACtF,MAAM,MAAM,GAAG,QAAQ,IAAI,QAAQ,KAAK,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9D,IAAI,MAAM;QAAE,OAAO,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAEnD,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IAC7C,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IAExB,IAAI,IAAI,IAAI,IAAI,CAAC,eAAe,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACb,0DAA0D;YACxD,qFAAqF;YACrF,mCAAmC,CACtC,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,SAAgB,WAAW,CAAC,QAAQ,GAAG,SAAS;IAC9C,IAAI,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjC,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,OAAO,IAAI,EAAE,CAAC;QACZ,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;YAAE,OAAO,GAAG,CAAC;QAC9D,IAAI,GAAG,KAAK,IAAI;YAAE,MAAM;QACxB,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC1B,CAAC;IACD,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAC7C,CAAC"}