@rsaglobaltech/specgate 0.8.1

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

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CheckAgainstLockUseCase = void 0;
+class CheckAgainstLockUseCase {
+    lockRepo;
+    packRepo;
+    constructor(lockRepo, packRepo) {
+        this.lockRepo = lockRepo;
+        this.packRepo = packRepo;
+    }
+    execute(matrixRows, isLegacyMatrix, opts = {}) {
+        const diagnostics = [];
+        const lock = this.lockRepo.readLock();
+        if (!lock || !Array.isArray(lock.packs) || lock.packs.length === 0) {
+            return { checked: 0, diagnostics };
+        }
+        if (isLegacyMatrix || matrixRows === null) {
+            diagnostics.push({
+                severity: "warning",
+                code: "traceability_legacy_format",
+                message: "traceability.md uses the legacy 4-column format; requirement-level drift cannot be checked.",
+                fix: "Migrate the matrix to the 10-column format.",
+            });
+            return { checked: 0, diagnostics };
+        }
+        let checked = 0;
+        for (const entry of lock.packs) {
+            if (opts.pack && entry.pack_id !== opts.pack)
+                continue;
+            if (!entry.repo)
+                continue;
+            let resolved;
+            try {
+                resolved = this.packRepo.resolveRemotePack({
+                    repo: entry.repo,
+                    version: entry.version,
+                    cacheDir: opts.cacheDir,
+                });
+            }
+            catch (err) {
+                diagnostics.push({
+                    severity: "error",
+                    code: "pack_unavailable",
+                    message: `Could not resolve ${entry.pack_id}@${entry.version}: ${err.message}`,
+                    target: entry.pack_id,
+                    fix: "Check network access and that the pinned tag still exists upstream.",
+                });
+                continue;
+            }
+            let pack;
+            try {
+                pack = this.packRepo.loadPackModel(resolved.packRoot, entry.pack_id);
+            }
+            catch (err) {
+                diagnostics.push({
+                    severity: "error",
+                    code: "pack_unreadable",
+                    message: `Could not read the model of ${entry.pack_id}: ${err.message}`,
+                    target: entry.pack_id,
+                    fix: "The locked tag may not contain this pack id any more.",
+                });
+                continue;
+            }
+            checked += 1;
+            diagnostics.push(...this.checkPackAgainstMatrix(pack, entry, matrixRows));
+        }
+        return { checked, diagnostics };
+    }
+    checkPackAgainstMatrix(pack, entry, matrixRows) {
+        const diagnostics = [];
+        const requirements = pack.getRequirementsById();
+        const scenarios = pack.getScenariosByRequirement();
+        const bare = (val) => String(val === undefined || val === null ? "" : val)
+            .trim()
+            .replace(/^`|`$/g, "");
+        const EMPTY = new Set(["", "-", "TBD"]);
+        const isEmpty = (v) => EMPTY.has(bare(v));
+        const rowFor = (id) => matrixRows.find((r) => bare(r.requirement).toUpperCase() === String(id).toUpperCase());
+        for (const [id, req] of requirements) {
+            const row = rowFor(id);
+            const label = `${id} — ${req.title || id}`;
+            if (!row) {
+                diagnostics.push({
+                    severity: "error",
+                    code: "pack_requirement_missing",
+                    message: `${label} is declared by the pack but absent from the project.`,
+                    target: id,
+                    fix: `Run \`specgate specops sync --pack ${entry.pack_id}\` to bring it in.`,
+                });
+                continue;
+            }
+            const packScenarios = scenarios.get(id) || [];
+            const expectedScenario = packScenarios[0] && packScenarios[0].id;
+            const expectedFeature = packScenarios[0] && packScenarios[0].target;
+            if (expectedScenario &&
+                !isEmpty(row.scenarioId) &&
+                bare(row.scenarioId) !== expectedScenario) {
+                diagnostics.push({
+                    severity: "error",
+                    code: "pack_requirement_drifted",
+                    message: `${label} points at scenario ${bare(row.scenarioId)}, but the pack declares ${expectedScenario}.`,
+                    target: id,
+                    fix: `Reconcile with \`specgate specops diff --pack ${entry.pack_id} --as-change\`, or accept the local decision by recording it in a change.`,
+                });
+            }
+            if (expectedFeature &&
+                !isEmpty(row.featureFile) &&
+                bare(row.featureFile) !== expectedFeature) {
+                diagnostics.push({
+                    severity: "error",
+                    code: "pack_requirement_drifted",
+                    message: `${label} points at feature ${bare(row.featureFile)}, but the pack declares ${expectedFeature}.`,
+                    target: id,
+                    fix: `Reconcile with \`specgate specops diff --pack ${entry.pack_id} --as-change\`, or accept the local decision by recording it in a change.`,
+                });
+            }
+        }
+        const local = matrixRows.filter((r) => {
+            const id = bare(r.requirement).toUpperCase();
+            return id && !requirements.has(id) && /^REQ-/.test(id);
+        });
+        if (local.length > 0) {
+            diagnostics.push({
+                severity: "info",
+                code: "local_requirements",
+                message: `${local.length} requirement(s) are local to this project.`,
+                target: local.map((r) => bare(r.requirement)).join(", "),
+            });
+        }
+        return diagnostics;
+    }
+}
+exports.CheckAgainstLockUseCase = CheckAgainstLockUseCase;
+//# sourceMappingURL=CheckAgainstLockUseCase.js.map

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

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

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

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GenerateAgentPromptUseCase = void 0;
+const AgentPrompt_1 = require("../domain/AgentPrompt");
+const HarnessRun_1 = require("../domain/HarnessRun");
+class GenerateAgentPromptUseCase {
+    configRepo;
+    constructor(configRepo) {
+        this.configRepo = configRepo;
+    }
+    execute(req, projectDir, opts = {}) {
+        const featurePath = (0, HarnessRun_1.featureFilePath)(req) || null;
+        const featureContent = featurePath
+            ? this.configRepo.readProjectFile(projectDir, featurePath)
+            : null;
+        const aiRulesContent = this.configRepo.readProjectFile(projectDir, "AI_RULES.md");
+        return AgentPrompt_1.AgentPrompt.build(req, {
+            ...opts,
+            featureContent,
+            aiRulesContent,
+        });
+    }
+}
+exports.GenerateAgentPromptUseCase = GenerateAgentPromptUseCase;
+//# sourceMappingURL=GenerateAgentPromptUseCase.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GenerateAgentPromptUseCase.js","sourceRoot":"","sources":["../../../../../packages/core/src/application/GenerateAgentPromptUseCase.ts"],"names":[],"mappings":";;;AACA,uDAAsF;AACtF,qDAAuD;AAEvD,MAAa,0BAA0B;IACjB;IAApB,YAAoB,UAAoC;QAApC,eAAU,GAAV,UAAU,CAA0B;IAAG,CAAC;IAErD,OAAO,CAAC,GAAsB,EAAE,UAAkB,EAAE,OAAsB,EAAE;QACjF,MAAM,WAAW,GAAG,IAAA,4BAAe,EAAC,GAAG,CAAC,IAAI,IAAI,CAAC;QACjD,MAAM,cAAc,GAAG,WAAW;YAChC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,UAAU,EAAE,WAAW,CAAC;YAC1D,CAAC,CAAC,IAAI,CAAC;QACT,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC,eAAe,CAAC,UAAU,EAAE,aAAa,CAAC,CAAC;QAElF,OAAO,yBAAW,CAAC,KAAK,CAAC,GAAG,EAAE;YAC5B,GAAG,IAAI;YACP,cAAc;YACd,cAAc;SACf,CAAC,CAAC;IACL,CAAC;CACF;AAhBD,gEAgBC"}

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

@@ -0,0 +1,135 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GeneratePlanUseCase = void 0;
+const RequirementPlan_1 = require("../domain/RequirementPlan");
+const RequirementGraph_1 = require("../domain/RequirementGraph");
+class GeneratePlanUseCase {
+    traceRepo;
+    fileExistsFn;
+    graphRepo;
+    constructor(traceRepo, fileExistsFn, graphRepo) {
+        this.traceRepo = traceRepo;
+        this.fileExistsFn = fileExistsFn;
+        this.graphRepo = graphRepo;
+    }
+    execute(projectDir) {
+        const rawContent = this.traceRepo.readTraceability(projectDir);
+        if (!rawContent) {
+            return {
+                items: [],
+                summary: {
+                    total: 0,
+                    done: 0,
+                    needs_feature: 0,
+                    needs_test: 0,
+                    needs_implementation: 0,
+                    needs_status_update: 0,
+                    needs_everything: 0,
+                    blocked: 0,
+                },
+                rawMatrix: null,
+            };
+        }
+        const rows = this.parseTraceabilityRows(rawContent);
+        const unconstrainedItems = [];
+        for (const row of rows) {
+            const item = RequirementPlan_1.RequirementPlan.classifyRow(row, (rel) => this.fileExistsFn(projectDir, rel));
+            if (item) {
+                unconstrainedItems.push(item);
+            }
+        }
+        const items = this.applyDependencies(unconstrainedItems, projectDir);
+        const summary = RequirementPlan_1.RequirementPlan.buildSummary(items);
+        return {
+            items,
+            summary,
+            rawMatrix: rawContent,
+        };
+    }
+    parseTraceabilityRows(content) {
+        const rows = [];
+        let mode = null;
+        const trimCell = (v) => (v || "").trim();
+        for (const raw of content.split("\n")) {
+            const line = raw.trimEnd();
+            if (!line.startsWith("|"))
+                continue;
+            if (line.includes("---"))
+                continue;
+            if (line.includes("| Requirement | Scenario ID |")) {
+                mode = "rich";
+                continue;
+            }
+            if (line.includes("| Feature | Scenario |")) {
+                mode = "legacy";
+                continue;
+            }
+            if (!mode)
+                continue;
+            const cells = line.split("|").map(trimCell);
+            if (mode === "rich" && cells.length >= 12) {
+                rows.push({
+                    mode,
+                    requirement: cells[1],
+                    scenarioId: cells[2],
+                    featureFile: cells[3],
+                    useCase: cells[4],
+                    command: cells[5],
+                    aggregate: cells[6],
+                    event: cells[7],
+                    technicalArtifact: cells[8],
+                    testArtifact: cells[9],
+                    status: cells[10],
+                });
+            }
+            else if (mode === "legacy" && cells.length >= 6) {
+                rows.push({
+                    mode,
+                    requirement: this.extractReqFromCells(cells),
+                    scenarioId: cells[2],
+                    featureFile: cells[1],
+                    technicalArtifact: cells[3],
+                    testArtifact: "",
+                    status: cells[4],
+                });
+            }
+        }
+        return rows;
+    }
+    extractReqFromCells(cells) {
+        for (const cell of cells) {
+            const m = (cell || "").match(/REQ-\d+/);
+            if (m)
+                return m[0];
+        }
+        return "";
+    }
+    applyDependencies(items, projectDir) {
+        const ids = items.map((it) => it.requirement);
+        const declared = this.graphRepo.readDeclaredDependencies(projectDir);
+        const graph = RequirementGraph_1.RequirementGraph.fromDependencies(ids, declared);
+        const byId = new Map(items.map((it) => [it.requirement, it]));
+        const isDone = (id) => {
+            const item = byId.get(id);
+            return Boolean(item) && item?.category === "DONE";
+        };
+        for (const item of items) {
+            const deps = graph.dependsOn[item.requirement] || [];
+            item.depends_on = deps;
+            item.blocked_by = deps.filter((dep) => !isDone(dep));
+        }
+        const ordered = [];
+        for (const id of graph.order) {
+            const item = byId.get(id);
+            if (item)
+                ordered.push(item);
+        }
+        for (const item of items) {
+            if (!ordered.includes(item))
+                ordered.push(item);
+        }
+        return ordered;
+    }
+}
+exports.GeneratePlanUseCase = GeneratePlanUseCase;
+//# sourceMappingURL=GeneratePlanUseCase.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GeneratePlanUseCase.js","sourceRoot":"","sources":["../../../../../packages/core/src/application/GeneratePlanUseCase.ts"],"names":[],"mappings":";;;AACA,+DAAiG;AACjG,iEAA8D;AAS9D,MAAa,mBAAmB;IAEpB;IACA;IACA;IAHV,YACU,SAAkC,EAClC,YAA8D,EAC9D,SAAsC;QAFtC,cAAS,GAAT,SAAS,CAAyB;QAClC,iBAAY,GAAZ,YAAY,CAAkD;QAC9D,cAAS,GAAT,SAAS,CAA6B;IAC7C,CAAC;IAEG,OAAO,CAAC,UAAkB;QAC/B,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAC/D,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO;gBACL,KAAK,EAAE,EAAE;gBACT,OAAO,EAAE;oBACP,KAAK,EAAE,CAAC;oBACR,IAAI,EAAE,CAAC;oBACP,aAAa,EAAE,CAAC;oBAChB,UAAU,EAAE,CAAC;oBACb,oBAAoB,EAAE,CAAC;oBACvB,mBAAmB,EAAE,CAAC;oBACtB,gBAAgB,EAAE,CAAC;oBACnB,OAAO,EAAE,CAAC;iBACX;gBACD,SAAS,EAAE,IAAI;aAChB,CAAC;QACJ,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC;QACpD,MAAM,kBAAkB,GAAe,EAAE,CAAC;QAE1C,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,iCAAe,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,CAAC;YAC3F,IAAI,IAAI,EAAE,CAAC;gBACT,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QAED,MAAM,KAAK,GAAG,IAAI,CAAC,iBAAiB,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC;QACrE,MAAM,OAAO,GAAG,iCAAe,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAEpD,OAAO;YACL,KAAK;YACL,OAAO;YACP,SAAS,EAAE,UAAU;SACtB,CAAC;IACJ,CAAC;IAEO,qBAAqB,CAAC,OAAe;QAC3C,MAAM,IAAI,GAAmB,EAAE,CAAC;QAChC,IAAI,IAAI,GAA6B,IAAI,CAAC;QAC1C,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAEjD,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;YAC3B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,SAAS;YACpC,IAAI,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;gBAAE,SAAS;YACnC,IAAI,IAAI,CAAC,QAAQ,CAAC,+BAA+B,CAAC,EAAE,CAAC;gBACnD,IAAI,GAAG,MAAM,CAAC;gBACd,SAAS;YACX,CAAC;YACD,IAAI,IAAI,CAAC,QAAQ,CAAC,wBAAwB,CAAC,EAAE,CAAC;gBAC5C,IAAI,GAAG,QAAQ,CAAC;gBAChB,SAAS;YACX,CAAC;YACD,IAAI,CAAC,IAAI;gBAAE,SAAS;YAEpB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAC5C,IAAI,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;gBAC1C,IAAI,CAAC,IAAI,CAAC;oBACR,IAAI;oBACJ,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;oBACrB,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;oBACpB,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;oBACrB,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;oBACjB,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;oBACjB,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;oBACnB,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;oBACf,iBAAiB,EAAE,KAAK,CAAC,CAAC,CAAC;oBAC3B,YAAY,EAAE,KAAK,CAAC,CAAC,CAAC;oBACtB,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;iBAClB,CAAC,CAAC;YACL,CAAC;iBAAM,IAAI,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;gBAClD,IAAI,CAAC,IAAI,CAAC;oBACR,IAAI;oBACJ,WAAW,EAAE,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAC;oBAC5C,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;oBACpB,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;oBACrB,iBAAiB,EAAE,KAAK,CAAC,CAAC,CAAC;oBAC3B,YAAY,EAAE,EAAE;oBAChB,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;iBACjB,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,mBAAmB,CAAC,KAAe;QACzC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YACxC,IAAI,CAAC;gBAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACrB,CAAC;QACD,OAAO,EAAE,CAAC;IACZ,CAAC;IAEO,iBAAiB,CAAC,KAAiB,EAAE,UAAkB;QAC7D,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,wBAAwB,CAAC,UAAU,CAAC,CAAC;QACrE,MAAM,KAAK,GAAG,mCAAgB,CAAC,gBAAgB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAE/D,MAAM,IAAI,GAAG,IAAI,GAAG,CAAmB,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;QAChF,MAAM,MAAM,GAAG,CAAC,EAAU,EAAE,EAAE;YAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC1B,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,QAAQ,KAAK,MAAM,CAAC;QACpD,CAAC,CAAC;QAEF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,CAAC;YACrD,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;YACvB,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAW,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QAC/D,CAAC;QAED,MAAM,OAAO,GAAe,EAAE,CAAC;QAC/B,KAAK,MAAM,EAAE,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC1B,IAAI,IAAI;gBAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;QACD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClD,CAAC;QACD,OAAO,OAAO,CAAC;IACjB,CAAC;CACF;AAlID,kDAkIC"}

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

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LinkRequirementUseCase = void 0;
+const TraceabilityMatrix_1 = require("../domain/TraceabilityMatrix");
+class LinkRequirementUseCase {
+    traceRepo;
+    columnMap;
+    constructor(traceRepo, columnMap) {
+        this.traceRepo = traceRepo;
+        this.columnMap = columnMap;
+    }
+    execute(projectDir, reqId, fields) {
+        const rawContent = this.traceRepo.readTraceability(projectDir);
+        if (!rawContent) {
+            return { ok: false, updated: 0, error: "Traceability matrix not found." };
+        }
+        const { content, updated } = TraceabilityMatrix_1.TraceabilityMatrix.updateRequirementFields(rawContent, reqId, fields, this.columnMap);
+        if (updated > 0) {
+            this.traceRepo.writeTraceability(projectDir, content);
+        }
+        return { ok: updated > 0, updated };
+    }
+}
+exports.LinkRequirementUseCase = LinkRequirementUseCase;
+//# sourceMappingURL=LinkRequirementUseCase.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"LinkRequirementUseCase.js","sourceRoot":"","sources":["../../../../../packages/core/src/application/LinkRequirementUseCase.ts"],"names":[],"mappings":";;;AACA,qEAAkE;AAoBlE,MAAa,sBAAsB;IAEvB;IACA;IAFV,YACU,SAAkC,EAClC,SAAiC;QADjC,cAAS,GAAT,SAAS,CAAyB;QAClC,cAAS,GAAT,SAAS,CAAwB;IACxC,CAAC;IAEG,OAAO,CAAC,UAAkB,EAAE,KAAa,EAAE,MAAkB;QAClE,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAC/D,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,gCAAgC,EAAE,CAAC;QAC5E,CAAC;QAED,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,uCAAkB,CAAC,uBAAuB,CACrE,UAAU,EACV,KAAK,EACL,MAAM,EACN,IAAI,CAAC,SAAS,CACf,CAAC;QAEF,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;YAChB,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACxD,CAAC;QAED,OAAO,EAAE,EAAE,EAAE,OAAO,GAAG,CAAC,EAAE,OAAO,EAAE,CAAC;IACtC,CAAC;CACF;AAzBD,wDAyBC"}

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

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RemovePackUseCase = void 0;
+class RemovePackUseCase {
+    lockRepo;
+    constructor(lockRepo) {
+        this.lockRepo = lockRepo;
+    }
+    execute(packId, options = {}) {
+        const lock = this.lockRepo.readLock();
+        if (!lock) {
+            return { ok: false, message: "No lockfile found. Nothing to remove.", removedCount: 0 };
+        }
+        const before = lock.packs.length;
+        const remaining = lock.packs.filter((p) => p.pack_id !== packId);
+        const removedCount = before - remaining.length;
+        if (removedCount === 0) {
+            return { ok: false, message: `Pack "${packId}" not found in lockfile.`, removedCount: 0 };
+        }
+        lock.packs = remaining;
+        if (!options.dryRun) {
+            this.lockRepo.writeLock(lock);
+        }
+        return { ok: true, message: `Removed ${removedCount} entry for "${packId}".`, removedCount };
+    }
+}
+exports.RemovePackUseCase = RemovePackUseCase;
+//# sourceMappingURL=RemovePackUseCase.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RemovePackUseCase.js","sourceRoot":"","sources":["../../../../../packages/core/src/application/RemovePackUseCase.ts"],"names":[],"mappings":";;;AAQA,MAAa,iBAAiB;IACR;IAApB,YAAoB,QAA6B;QAA7B,aAAQ,GAAR,QAAQ,CAAqB;IAAG,CAAC;IAE9C,OAAO,CAAC,MAAc,EAAE,UAAgC,EAAE;QAC/D,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;QAEtC,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,uCAAuC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;QAC1F,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;QACjC,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,KAAK,MAAM,CAAC,CAAC;QACjE,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;QAE/C,IAAI,YAAY,KAAK,CAAC,EAAE,CAAC;YACvB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,MAAM,0BAA0B,EAAE,YAAY,EAAE,CAAC,EAAE,CAAC;QAC5F,CAAC;QAED,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QAEvB,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;YACpB,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAChC,CAAC;QAED,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,YAAY,eAAe,MAAM,IAAI,EAAE,YAAY,EAAE,CAAC;IAC/F,CAAC;CACF;AA1BD,8CA0BC"}

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

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateRequirementStatusUseCase = void 0;
+const TraceabilityMatrix_1 = require("../domain/TraceabilityMatrix");
+class UpdateRequirementStatusUseCase {
+    traceRepo;
+    constructor(traceRepo) {
+        this.traceRepo = traceRepo;
+    }
+    execute(projectDir, reqId, newStatus) {
+        const original = this.traceRepo.readTraceability(projectDir);
+        if (!original) {
+            return {
+                ok: false,
+                updated: 0,
+                code: "traceability_not_found",
+                error: `docs/specs/traceability.md not found in ${projectDir}`,
+            };
+        }
+        const { content, updated } = TraceabilityMatrix_1.TraceabilityMatrix.updateStatus(original, reqId, newStatus);
+        if (updated === 0) {
+            return {
+                ok: false,
+                updated: 0,
+                code: "requirement_not_in_matrix",
+                error: `${reqId} not found in traceability.md.`,
+            };
+        }
+        this.traceRepo.writeTraceability(projectDir, content);
+        return {
+            ok: true,
+            updated,
+        };
+    }
+}
+exports.UpdateRequirementStatusUseCase = UpdateRequirementStatusUseCase;
+//# sourceMappingURL=UpdateRequirementStatusUseCase.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"UpdateRequirementStatusUseCase.js","sourceRoot":"","sources":["../../../../../packages/core/src/application/UpdateRequirementStatusUseCase.ts"],"names":[],"mappings":";;;AACA,qEAAkE;AASlE,MAAa,8BAA8B;IACrB;IAApB,YAAoB,SAAkC;QAAlC,cAAS,GAAT,SAAS,CAAyB;IAAG,CAAC;IAEnD,OAAO,CAAC,UAAkB,EAAE,KAAa,EAAE,SAAiB;QACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;QAC7D,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,OAAO,EAAE,CAAC;gBACV,IAAI,EAAE,wBAAwB;gBAC9B,KAAK,EAAE,2CAA2C,UAAU,EAAE;aAC/D,CAAC;QACJ,CAAC;QAED,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,GAAG,uCAAkB,CAAC,YAAY,CAAC,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;QACzF,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;YAClB,OAAO;gBACL,EAAE,EAAE,KAAK;gBACT,OAAO,EAAE,CAAC;gBACV,IAAI,EAAE,2BAA2B;gBACjC,KAAK,EAAE,GAAG,KAAK,gCAAgC;aAChD,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACtD,OAAO;YACL,EAAE,EAAE,IAAI;YACR,OAAO;SACR,CAAC;IACJ,CAAC;CACF;AA9BD,wEA8BC"}

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

@@ -0,0 +1,86 @@
+"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.ValidateChangeUseCase = void 0;
+const path = __importStar(require("node:path"));
+const DeltaSpec_1 = require("../domain/DeltaSpec");
+const Diagnostic_1 = require("../domain/Diagnostic");
+/**
+ * Is this change well-formed?
+ *
+ * A change is a proposal plus zero or more delta specs. Zero is a warning
+ * rather than an error, because `skip_specs` is a legitimate way to record a
+ * change that alters no requirement — and a project that sets it should not be
+ * nagged. Each delta is then checked against the capability spec it amends,
+ * which is what catches a `MODIFIED` of a requirement that does not exist.
+ */
+class ValidateChangeUseCase {
+    projectRepo;
+    constructor(projectRepo) {
+        this.projectRepo = projectRepo;
+    }
+    execute(changeId, opts = {}) {
+        const paths = this.projectRepo.getPaths();
+        const diagnostics = [];
+        const config = this.projectRepo.readConfig(changeId);
+        if (this.projectRepo.readFile(path.join(paths.change(changeId), "proposal.md")) === null) {
+            diagnostics.push((0, Diagnostic_1.error)("missing_proposal", `Change "${changeId}" has no proposal.md.`, {
+                target: changeId,
+                fix: `Create ${path.join("docs/specs/changes", changeId, "proposal.md")}.`,
+            }));
+        }
+        const deltas = this.projectRepo.listDeltas(changeId);
+        if (deltas.length === 0 && !config.skip_specs) {
+            diagnostics.push((0, Diagnostic_1.warning)("no_deltas", `Change "${changeId}" carries no delta specs.`, {
+                target: changeId,
+                fix: "Add a delta under specs/<capability>/spec.md, or set skip_specs: true.",
+            }));
+        }
+        for (const entry of deltas) {
+            const deltaSource = this.projectRepo.readFile(entry.file);
+            if (deltaSource === null)
+                continue;
+            const { diagnostics: d } = DeltaSpec_1.DeltaSpec.validate(deltaSource, {
+                specSource: this.projectRepo.readFile(paths.capabilitySpec(entry.capability)),
+                file: entry.relative,
+                strict: opts.strict,
+            });
+            diagnostics.push(...d);
+        }
+        return { changeId, deltaCount: deltas.length, diagnostics };
+    }
+}
+exports.ValidateChangeUseCase = ValidateChangeUseCase;
+//# sourceMappingURL=ValidateChangeUseCase.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ValidateChangeUseCase.js","sourceRoot":"","sources":["../../../../../packages/core/src/application/ValidateChangeUseCase.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,gDAAkC;AAElC,mDAAgD;AAChD,qDAAkE;AAclE;;;;;;;;GAQG;AACH,MAAa,qBAAqB;IACZ;IAApB,YAAoB,WAA+B;QAA/B,gBAAW,GAAX,WAAW,CAAoB;IAAG,CAAC;IAEhD,OAAO,CAAC,QAAgB,EAAE,OAA8B,EAAE;QAC/D,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC;QAC1C,MAAM,WAAW,GAAiB,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAErD,IAAI,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACzF,WAAW,CAAC,IAAI,CACd,IAAA,kBAAK,EAAC,kBAAkB,EAAE,WAAW,QAAQ,uBAAuB,EAAE;gBACpE,MAAM,EAAE,QAAQ;gBAChB,GAAG,EAAE,UAAU,IAAI,CAAC,IAAI,CAAC,oBAAoB,EAAE,QAAQ,EAAE,aAAa,CAAC,GAAG;aAC3E,CAAC,CACH,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QACrD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YAC9C,WAAW,CAAC,IAAI,CACd,IAAA,oBAAO,EAAC,WAAW,EAAE,WAAW,QAAQ,2BAA2B,EAAE;gBACnE,MAAM,EAAE,QAAQ;gBAChB,GAAG,EAAE,wEAAwE;aAC9E,CAAC,CACH,CAAC;QACJ,CAAC;QAED,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;YAC3B,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC1D,IAAI,WAAW,KAAK,IAAI;gBAAE,SAAS;YACnC,MAAM,EAAE,WAAW,EAAE,CAAC,EAAE,GAAG,qBAAS,CAAC,QAAQ,CAAC,WAAW,EAAE;gBACzD,UAAU,EAAE,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,cAAc,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;gBAC7E,IAAI,EAAE,KAAK,CAAC,QAAQ;gBACpB,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;YACH,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QACzB,CAAC;QAED,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC;IAC9D,CAAC;CACF;AAxCD,sDAwCC"}

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

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.POST_DRAFT_STATUS = exports.ALLOWED_STATUS = exports.RICH_HEADER = exports.LEGACY_HEADER = exports.ValidateProjectUseCase = void 0;
+const ValidationReport_1 = require("../domain/ValidationReport");
+const TraceabilityFormat_1 = require("../domain/TraceabilityFormat");
+Object.defineProperty(exports, "ALLOWED_STATUS", { enumerable: true, get: function () { return TraceabilityFormat_1.ALLOWED_STATUS; } });
+Object.defineProperty(exports, "LEGACY_HEADER", { enumerable: true, get: function () { return TraceabilityFormat_1.LEGACY_HEADER; } });
+Object.defineProperty(exports, "POST_DRAFT_STATUS", { enumerable: true, get: function () { return TraceabilityFormat_1.POST_DRAFT_STATUS; } });
+Object.defineProperty(exports, "RICH_HEADER", { enumerable: true, get: function () { return TraceabilityFormat_1.RICH_HEADER; } });
+/**
+ * Everything `validate` checks about the traceability matrix itself.
+ *
+ * The file checks around it — required files, unresolved placeholders, feature
+ * files, the monorepo fan-out — stay with the command, because they are about
+ * a project's layout on disk rather than about the matrix. What lives here is
+ * the part that is pure judgement over the matrix's contents, and it is the
+ * only copy: the command renders these findings rather than repeating them.
+ *
+ * Findings come back in the order the checks run, so a caller that stops at the
+ * first error reports the same one the old inline loop did.
+ */
+class ValidateProjectUseCase {
+    traceRepo;
+    constructor(traceRepo) {
+        this.traceRepo = traceRepo;
+    }
+    execute(projectDir, opts = {}) {
+        const traceContent = this.traceRepo.readTraceability(projectDir);
+        const report = new ValidationReport_1.ValidationReport();
+        if (traceContent === null) {
+            report.addError("traceability_missing", `docs/specs/traceability.md not found in ${projectDir}`, {
+                file: "docs/specs/traceability.md",
+                fixLines: ["Run `specgate init` to scaffold the project structure."],
+            });
+            return { report, mode: null, requirements: new Set() };
+        }
+        return this.checkMatrix(traceContent, opts);
+    }
+    /** The same checks against content the caller already has in hand. */
+    checkMatrix(traceContent, opts = {}) {
+        const report = new ValidationReport_1.ValidationReport();
+        const requirements = new Set();
+        const mode = (0, TraceabilityFormat_1.detectTraceabilityMode)(traceContent);
+        if (mode === null) {
+            report.addError("traceability_header_missing", "traceability.md is missing the expected legacy or rich matrix header", {
+                file: "docs/specs/traceability.md",
+                fixLines: [
+                    "Add the rich matrix header (recommended) to docs/specs/traceability.md:",
+                    `  ${TraceabilityFormat_1.RICH_HEADER}`,
+                ],
+            });
+            return { report, mode, requirements };
+        }
+        const strictTdd = opts.strictTdd === true;
+        const seenScenarios = new Set();
+        for (const cells of (0, TraceabilityFormat_1.parseMatrixRows)(traceContent)) {
+            const { requirementId, scenarioId, testArtifact, status } = (0, TraceabilityFormat_1.readRowFields)(cells, mode);
+            if (requirementId)
+                requirements.add(requirementId);
+            if (scenarioId && scenarioId !== "-") {
+                if (seenScenarios.has(scenarioId)) {
+                    report.addError("duplicate_scenario_id", `Duplicate Scenario ID in traceability.md: ${scenarioId}`, {
+                        target: scenarioId,
+                        fixLines: [
+                            "Every Scenario ID must be unique across the matrix — renumber one of the rows",
+                            `(e.g. keep ${scenarioId} on the first row and give the second a new ID).`,
+                        ],
+                    });
+                }
+                seenScenarios.add(scenarioId);
+            }
+            if (status && !TraceabilityFormat_1.ALLOWED_STATUS.has(status)) {
+                report.addError("invalid_status", `Invalid status in traceability.md: ${status}`, {
+                    target: status,
+                    fixLines: [
+                        `Allowed statuses: ${[...TraceabilityFormat_1.ALLOWED_STATUS].join(" · ")}`,
+                        "Use `specgate done <REQ-id>` to flip a row to Implemented safely.",
+                    ],
+                });
+            }
+            if (!strictTdd)
+                continue;
+            if (testArtifact.toUpperCase() === "TBD" && status && TraceabilityFormat_1.POST_DRAFT_STATUS.has(status)) {
+                report.addError("strict_tdd_violation", `[TDD-1] Test artifact is TBD but status is '${status}' (scenario: ${scenarioId || "(no id)"})`, { target: "TDD-1" });
+            }
+            if (mode === "rich" && !scenarioId && status && status !== "Draft") {
+                report.addError("strict_tdd_violation", `[TDD-2] Traceability row missing Scenario ID with status '${status}' (requirement: ${requirementId || "(none)"})`, { target: "TDD-2" });
+            }
+        }
+        if (strictTdd && mode === "rich" && typeof opts.specContent === "string") {
+            for (const reqId of new Set(opts.specContent.match(/\bREQ-\d+\b/g) || [])) {
+                if (!requirements.has(reqId)) {
+                    report.addError("strict_tdd_violation", `[TDD-3] Requirement ${reqId} found in spec.md but has no row in traceability.md`, { target: "TDD-3" });
+                }
+            }
+        }
+        return { report, mode, requirements };
+    }
+}
+exports.ValidateProjectUseCase = ValidateProjectUseCase;
+//# sourceMappingURL=ValidateProjectUseCase.js.map

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

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

package/dist/packages/core/src/application/ports/IDomainPackRepository.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IDomainPackRepository.js.map

package/dist/packages/core/src/application/ports/IDomainPackRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IDomainPackRepository.js","sourceRoot":"","sources":["../../../../../../packages/core/src/application/ports/IDomainPackRepository.ts"],"names":[],"mappings":""}

package/dist/packages/core/src/application/ports/IHarnessConfigRepository.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IHarnessConfigRepository.js.map

package/dist/packages/core/src/application/ports/IHarnessConfigRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IHarnessConfigRepository.js","sourceRoot":"","sources":["../../../../../../packages/core/src/application/ports/IHarnessConfigRepository.ts"],"names":[],"mappings":""}