@sdd-method/author-cli 0.12.0 → 0.12.1

package/dist/lib/catalogue/builders/user-journeys.js

@@ -14,7 +14,10 @@
 //   ## Trigger
 //   ...
 //
-// Profile gating: journeys are an application-product profile concept.
+// Any SDD catalogues the journeys it owns: an application its own, and a platform root a journey that no single
+// application owns (a cross-application journey, M-ADR 0146, or one that runs through platform services only), whose
+// journey feature names it with @journey:<id> (M-ADR 0229 §4.2, option B). **App:** is omitted where no app owns it.
+// Only an application is expected to have journeys/, so only there is its absence a coverage finding.
 // id = `{product_id}-{slug}`, slug from filename stem.
 import { readdir, readFile } from "node:fs/promises";
 import { basename, join, relative } from "node:path";
@@ -26,17 +29,6 @@ export async function buildUserJourneys(inputs) {
     const relatedFeatureSlugsById = new Map();
     const primaryPersonaById = new Map();
     const supportingPersonasById = new Map();
-    if (inputs.profile !== "application-product") {
-        return {
-            rows: [],
-            idByPath,
-            idBySlug,
-            featurePathsById,
-            relatedFeatureSlugsById,
-            primaryPersonaById,
-            supportingPersonasById,
-        };
-    }
     const dir = join(inputs.sddPath, JOURNEYS_DIR_REL);
     let entries;
     try {
@@ -45,7 +37,10 @@ export async function buildUserJourneys(inputs) {
     catch (err) {
         if (err.code !== "ENOENT")
             throw err;
-        inputs.findings.add("coverage", `${JOURNEYS_DIR_REL}/ not found — emitting empty user_journeys.csv`);
+        // An application is expected to describe its journeys; another SDD holds journeys only where it owns one.
+        if (inputs.profile === "application-product") {
+            inputs.findings.add("coverage", `${JOURNEYS_DIR_REL}/ not found — emitting empty user_journeys.csv`);
+        }
         return {
             rows: [],
             idByPath,

package/dist/lib/validate/journey-impact.js

@@ -9,7 +9,7 @@
 //              never the proposal's.
 //   unnamed    a listed journey the proposal's `## Affected Journeys` section does not name.
 //   unshown    a journey named `altered` with nothing to show it: no delta in the change to a feature of kind journey
-//              whose id is the journey's id or ends with it (option B), and no task naming it (option A).
+//              whose delta or living spec tags it @journey:<journey-id> (option B), and no task naming it (option A).
 // A proposal line is `- <journey-id>: altered ...` or `- <journey-id>: unaffected, <reason>`; an unaffected line
 // with no reason is reported too.
 //
@@ -52,6 +52,10 @@ async function csv(repo, name, dir = "catalogues") {
     return text === null ? null : parseCatalogueCsv(text).rows;
 }
 /** The `## Affected Journeys` section: journey id -> what the proposal says of it. */
+/** The journey ids a spec tags with @journey:<id>. */
+export function journeyTags(text) {
+    return new Set([...text.matchAll(/@journey:([a-z0-9][a-z0-9-]*)/g)].map((m) => m[1]));
+}
 export function parseAffectedJourneys(proposal) {
     const out = new Map();
     let inSection = false;
@@ -178,7 +182,18 @@ export async function checkJourneyImpact(repo) {
             if (n.verdict === "unaffected" && n.rest === "")
                 warnings.push(`${CHANGES_DIR}/${change}/proposal.md: journey ${j} is named unaffected without a reason`);
             if (n.verdict === "altered") {
-                const journeyDelta = [...deltaFeatures].some((f) => featureKinds.get(f) === "journey" && (f === j || f.endsWith(`-${j}`)));
+                // Option B: a delta to a feature of kind journey that names this journey with its @journey tag, in the delta
+                // or in the living spec it changes (M-ADR 0229 §4.2). The tag, not the feature's id, binds the two.
+                let journeyDelta = false;
+                for (const f of deltaFeatures) {
+                    if (featureKinds.get(f) !== "journey")
+                        continue;
+                    const text = `${(await readText(join(dir, "specs", f, "spec.md"))) ?? ""}\n${(await readText(join(repo, "openspec", "specs", f, "spec.md"))) ?? ""}`;
+                    if (journeyTags(text).has(j)) {
+                        journeyDelta = true;
+                        break;
+                    }
+                }
                 const shown = journeyDelta || tasks.includes(j);
                 if (!shown)
                     warnings.push(`${CHANGES_DIR}/${change}/proposal.md: journey ${j} is named altered, and the change shows nothing for it: no delta to its journey feature and no task naming it`);

package/dist/maintain-version.json

@@ -1,4 +1,4 @@
 {
-  "version": "0.13.0",
-  "built_against_sdd_cli": "4.0.0"
+  "version": "0.13.1",
+  "built_against_sdd_cli": "4.0.1"
 }

package/dist/verify-version.json

@@ -1,4 +1,4 @@
 {
-  "version": "4.0.0",
-  "built_against_sdd_cli": "4.0.0"
+  "version": "4.0.1",
+  "built_against_sdd_cli": "4.0.1"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@sdd-method/author-cli",
-  "version": "0.12.0",
-  "sddCliVersion": "4.0.0",
+  "version": "0.12.1",
+  "sddCliVersion": "4.0.1",
   "description": "Re-author one SDD's content — scaffold, plan, contracts, conformance, api-surface, snapshots, briefings, catalogue check — plus every read-only verify verb. Ships only the code those verbs reach; it cannot sync the baseline or rebuild the catalogues. Maintenance is in @sdd-method/maintain-cli, administration in @sdd-method/sdd-cli.",
   "license": "UNLICENSED",
   "type": "module",