@sdd-method/sdd-cli 1.41.0 → 1.43.0

package/dist/lib/sync/settings-merge.js

@@ -1,145 +1,99 @@
 /**
- * `.claude/settings.json` merge pass during `sdd-cli sync`. Method-
- * managed `mcpServers` entries (see src/lib/mcp-seed/) get upserted;
- * any adopter-added entries or other top-level keys are preserved.
+ * `.claude/settings.json` merge pass during `sdd-cli sync`. The method's hooks (see
+ * src/lib/hooks-seed/) are upserted when the repo runs the claude-code harness; every adopter
+ * entry and every other top-level key is preserved.
  *
- * The file cannot ship in the method baseline bundle because it
- * carries per-adopter absolute paths. That's why this is a separate
- * sync step, outside the bundle-driven `copyManagedFiles` path.
+ * The method seeds no MCP server (M-ADR 0220 §4.5). Sync removes the `sdd-mcp` entry it seeded
+ * before, without --allow-overwrite, because an entry whose command is the method's own
+ * `sdd-cli mcp serve` is the method's output: the same rule by which sync retired its own
+ * SDD_REPO_PATH value. An adopter's other servers, and an `sdd-mcp` entry that runs anything
+ * else, are left alone.
  *
- * Conflict handling mirrors ADR 0114: if the adopter has manually
- * modified a method-owned entry, sync refuses unless
- * `--allow-overwrite` is passed.
+ * Conflict handling mirrors ADR 0114: if the adopter has modified a method-owned hook, sync
+ * refuses unless `--allow-overwrite` is passed.
  */
 import { access, mkdir, readFile, writeFile } from "node:fs/promises";
 import { dirname, join, resolve } from "node:path";
-import { buildMethodManagedServers, detectManagedDrift, upsertMethodManagedServers, } from "../mcp-seed/index.js";
-import { buildMethodManagedHooks, detectHooksDrift, upsertMethodManagedHooks, } from "../hooks-seed/index.js";
+import { buildMethodManagedHooks, detectHooksDrift, normaliseOwnHookRenders, upsertMethodManagedHooks, } from "../hooks-seed/index.js";
 export const SETTINGS_REL_PATH = ".claude/settings.json";
+/** The server id the method used to seed. */
+export const RETIRED_SERVER_ID = "sdd-mcp";
+/**
+ * Whether an `mcpServers` entry is one the method seeded: `sdd-cli mcp serve` and no other field,
+ * with no env or only an SDD_REPO_PATH that resolves to the repo itself (the value older syncs
+ * wrote for a platform repo). An SDD_REPO_PATH pointing anywhere else was the adopter's own
+ * configuration, as is any other change, and the entry stays.
+ */
+export function isOwnSddMcpEntry(entry, targetRepo) {
+    if (!entry || typeof entry !== "object" || Array.isArray(entry))
+        return false;
+    const e = entry;
+    if (Object.keys(e).some((k) => k !== "command" && k !== "args" && k !== "env"))
+        return false;
+    if (e["command"] !== "sdd-cli")
+        return false;
+    const args = e["args"];
+    if (!Array.isArray(args) || args.length !== 2 || args[0] !== "mcp" || args[1] !== "serve")
+        return false;
+    const env = e["env"];
+    if (env === undefined)
+        return true;
+    if (!env || typeof env !== "object" || Array.isArray(env))
+        return false;
+    const keys = Object.keys(env);
+    if (keys.length !== 1 || keys[0] !== "SDD_REPO_PATH")
+        return false;
+    const path = env["SDD_REPO_PATH"];
+    return typeof path === "string" && resolve(targetRepo, path) === resolve(targetRepo);
+}
+/** The settings with the method's own `sdd-mcp` entry removed, and which ids went. */
+export function retireOwnMcpServers(settings, targetRepo) {
+    const servers = settings["mcpServers"];
+    if (!servers || typeof servers !== "object" || Array.isArray(servers))
+        return { settings, retired: [] };
+    const current = servers;
+    if (!(RETIRED_SERVER_ID in current) || !isOwnSddMcpEntry(current[RETIRED_SERVER_ID], targetRepo)) {
+        return { settings, retired: [] };
+    }
+    const { [RETIRED_SERVER_ID]: _retired, ...rest } = current;
+    const { mcpServers: _servers, ...others } = settings;
+    return {
+        settings: Object.keys(rest).length > 0 ? { ...others, mcpServers: rest } : others,
+        retired: [RETIRED_SERVER_ID],
+    };
+}
 export async function syncMethodManagedSettings(opts) {
     const absPath = join(opts.targetRepo, SETTINGS_REL_PATH);
+    const fileExisted = await fileExists(absPath);
     const existing = await readSettings(absPath);
-    // No profile gets an SDD_REPO_PATH any more (ruled 2026-10-01). It was written for platform
-    // repos only because the resolver treated a marker-bearing repo as one candidate among its
-    // marker-bearing siblings (MULTIPLE_SDDS_FOUND in the reverse estate's layout). The resolver now
-    // lets a platform-product repo serve itself, so the env var, an absolute, machine-specific
-    // path in a COMMITTED file, is no longer needed. A value left by an older sync that points at
-    // the repo itself is this tool's own output and is removed (normaliseSddRepoPathForDrift); a
-    // value pointing anywhere else is the adopter's and is still drift. App/integration repos
-    // configure their sibling platform SDD as before.
-    const owned = buildMethodManagedServers({});
-    // Drift is detected against a PATH-NORMALISED view of the existing file,
-    // not the raw bytes. Reason, measured on a live estate: the F27 defect
-    // wrote the literal CLI argument (".") as SDD_REPO_PATH. Once the
-    // generator was fixed to emit the absolute form, a strict comparison
-    // classified the defect's own historical output as an ADOPTER
-    // modification and refused to correct it — while the only offered remedy,
-    // --allow-overwrite, is the flag that rewrites genuinely adopter-owned
-    // keys. A repair that requires the dangerous flag is not a repair. So: an
-    // existing SDD_REPO_PATH that RESOLVES (from the target repo) to the same
-    // absolute path as the generated value is the tool's own output in an
-    // older costume, and is treated as regenerable, never as drift. The raw
-    // `existing` still flows into the upsert below, so the merge rewrites the
-    // stale form to the canonical one — the sync self-heals instead of
-    // wedging. A path that resolves DIFFERENTLY is still drift.
-    const drifted = detectManagedDrift(normaliseSddRepoPathForDrift(existing, owned, opts.targetRepo), owned);
-    // Computed from the state as READ, before any upsert: which method-managed ids
-    // were absent from the file this run opened. Combined with `hadPreviousSync`
-    // that is a re-seed; without it, a first seeding. Deliberately not derived
-    // from the upsert's `added`, which cannot tell the two apart — that conflation
-    // IS the defect.
-    const absentOnRead = absentManagedIds(existing, owned);
-    const reseeded = opts.hadPreviousSync === true ? absentOnRead : [];
     const hooksActive = opts.agentHarness === "claude-code";
     const ownedHooks = hooksActive ? buildMethodManagedHooks() : undefined;
     const hooksDrifted = hooksActive && ownedHooks
-        ? detectHooksDrift(existing, ownedHooks)
+        ? detectHooksDrift(normaliseOwnHookRenders(existing, ownedHooks), ownedHooks)
         : [];
-    if ((drifted.length > 0 || hooksDrifted.length > 0) && !opts.allowOverwrite) {
-        return {
-            path: SETTINGS_REL_PATH,
-            drifted,
-            added: [],
-            // Reported even on the refusal path: the re-seed was OBSERVED when the
-            // file was read, and it stays true whether or not this run went on to
-            // write. Zeroing it here would make a refusal hide a second finding.
-            reseeded,
-            updated: [],
-            unchanged: [],
-            hooksChangedEvents: [],
-            hooksDrifted,
-            wroteFile: false,
-            refused: true,
-        };
+    const base = { path: SETTINGS_REL_PATH, hooksDrifted };
+    if (hooksDrifted.length > 0 && !opts.allowOverwrite) {
+        return { ...base, retiredServers: [], hooksChangedEvents: [], wroteFile: false, refused: true };
     }
+    const retirement = retireOwnMcpServers(existing, opts.targetRepo);
     if (opts.checkOnly) {
-        return {
-            path: SETTINGS_REL_PATH,
-            drifted,
-            added: [],
-            reseeded,
-            updated: [],
-            unchanged: [],
-            hooksChangedEvents: [],
-            hooksDrifted,
-            wroteFile: false,
-            refused: false,
-        };
+        return { ...base, retiredServers: retirement.retired, hooksChangedEvents: [], wroteFile: false, refused: false };
     }
-    const mcpResult = upsertMethodManagedServers(existing, owned);
-    let nextSettings = mcpResult.settings;
+    let nextSettings = retirement.settings;
     let hooksChangedEvents = [];
     if (hooksActive && ownedHooks) {
         const hooksResult = upsertMethodManagedHooks(nextSettings, ownedHooks);
         nextSettings = hooksResult.settings;
         hooksChangedEvents = [...hooksResult.changedEvents];
     }
-    const changed = mcpResult.changed || hooksChangedEvents.length > 0;
-    if (!changed) {
-        return {
-            path: SETTINGS_REL_PATH,
-            drifted,
-            added: mcpResult.added,
-            reseeded,
-            updated: mcpResult.updated,
-            unchanged: mcpResult.unchanged,
-            hooksChangedEvents: [],
-            hooksDrifted,
-            wroteFile: false,
-            refused: false,
-        };
+    const changed = retirement.retired.length > 0 || hooksChangedEvents.length > 0;
+    // Nothing to write: leave the file as it is, and never create one just to hold nothing.
+    if (!changed || (!fileExisted && Object.keys(nextSettings).length === 0)) {
+        return { ...base, retiredServers: [], hooksChangedEvents: [], wroteFile: false, refused: false };
     }
     await mkdir(dirname(absPath), { recursive: true });
     await writeFile(absPath, JSON.stringify(nextSettings, null, 2) + "\n", "utf8");
-    return {
-        path: SETTINGS_REL_PATH,
-        drifted,
-        added: mcpResult.added,
-        reseeded,
-        updated: mcpResult.updated,
-        unchanged: mcpResult.unchanged,
-        hooksChangedEvents,
-        hooksDrifted,
-        wroteFile: true,
-        refused: false,
-    };
-}
-/**
- * Method-managed ids absent from the settings file as read.
- *
- * A missing or malformed `mcpServers` map counts every managed id as absent —
- * `readSettings` already collapses an unparseable file to `{}`, and a file whose
- * managed block was destroyed rather than edited is exactly the re-seed case
- * this exists to name.
- */
-function absentManagedIds(existing, owned) {
-    const servers = existing["mcpServers"];
-    const present = servers && typeof servers === "object" && !Array.isArray(servers)
-        ? servers
-        : {};
-    return Object.keys(owned)
-        .filter((id) => !(id in present))
-        .sort();
+    return { ...base, retiredServers: retirement.retired, hooksChangedEvents, wroteFile: true, refused: false };
 }
 async function readSettings(absPath) {
     if (!(await fileExists(absPath)))
@@ -167,50 +121,4 @@ async function fileExists(path) {
         return false;
     }
 }
-/**
- * A view of `existing` for drift detection ONLY: where a method-managed
- * entry's `env.SDD_REPO_PATH` resolves (from the target repo) to the same
- * absolute path as the generated value, substitute the generated form.
- *
- * This makes "the tool's own older output" (the F27 relative-path defect,
- * or a lexically different spelling of the same location) compare as
- * pristine, so the merge proceeds and REWRITES it — while a path that
- * resolves somewhere else entirely remains drift and still refuses.
- * Never used for the write: the raw `existing` flows into the upsert, so
- * the correction actually lands on disk.
- */
-function normaliseSddRepoPathForDrift(existing, owned, targetRepo) {
-    const servers = existing["mcpServers"];
-    if (!servers || typeof servers !== "object" || Array.isArray(servers)) {
-        return existing;
-    }
-    const current = servers;
-    const out = {};
-    let touched = false;
-    for (const [id, entry] of Object.entries(current)) {
-        const existingPath = entry?.env?.["SDD_REPO_PATH"];
-        const ownedPath = owned[id]?.env?.["SDD_REPO_PATH"];
-        if (typeof existingPath === "string" &&
-            ownedPath === undefined &&
-            resolve(targetRepo, existingPath) === resolve(targetRepo)) {
-            // The retired platform SDD_REPO_PATH, pointing at the repo itself: regenerable, so the
-            // drift view drops it and the write (which replaces the entry whole) removes it.
-            const { SDD_REPO_PATH: _dropped, ...rest } = entry.env ?? {};
-            const { env: _env, ...bare } = entry;
-            out[id] = Object.keys(rest).length > 0 ? { ...bare, env: rest } : bare;
-            touched = true;
-        }
-        else if (typeof existingPath === "string" &&
-            typeof ownedPath === "string" &&
-            existingPath !== ownedPath &&
-            resolve(targetRepo, existingPath) === resolve(ownedPath)) {
-            out[id] = { ...entry, env: { ...entry.env, SDD_REPO_PATH: ownedPath } };
-            touched = true;
-        }
-        else {
-            out[id] = entry;
-        }
-    }
-    return touched ? { ...existing, mcpServers: out } : existing;
-}
 //# sourceMappingURL=settings-merge.js.map

package/dist/lib/sync/settings-merge.js.map

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

package/dist/lib/validate/bundle-coherence.js

@@ -11,7 +11,7 @@
 // read 0 (the scores-coverage precedent, M-ADR 0205 §4.5).
 import { readLockFile, findForwardBase } from "../lock-file.js";
 import { loadSddManifest, } from "../catalogue/manifest-loader.js";
-import { getPackageVersion } from "../package-version.js";
+import { getSddCliVersion } from "../package-version.js";
 /**
  * Manifest profile → the forward base that profile expects. Profiles with no
  * entry (support-repo, organisation-profile) carry no expectation — silence,
@@ -37,7 +37,7 @@ export async function checkBundleCoherence(targetRepo) {
     let profile;
     try {
         const manifest = await loadSddManifest(targetRepo, {
-            cliVersion: getPackageVersion(),
+            cliVersion: getSddCliVersion(),
         });
         profile = manifest.profile;
     }

package/dist/lib/validate/bundle-coherence.js.map

@@ -1 +1 @@
-{"version":3,"file":"bundle-coherence.js","sourceRoot":"","sources":["../../../src/lib/validate/bundle-coherence.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,EAAE;AACF,4EAA4E;AAC5E,uEAAuE;AACvE,yEAAyE;AACzE,6EAA6E;AAC7E,qEAAqE;AACrE,EAAE;AACF,4EAA4E;AAC5E,0EAA0E;AAC1E,2DAA2D;AAC3D,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EACL,eAAe,GAEhB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1D;;;;;GAKG;AACH,MAAM,qBAAqB,GAA6C;IACtE,kBAAkB,EAAE,mBAAmB;IACvC,qBAAqB,EAAE,cAAc;IACrC,qBAAqB,EAAE,sBAAsB;CAC9C,CAAC;AAWF,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,UAAkB;IAElB,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO;YACL,QAAQ,EAAE,CAAC;YACX,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,4DAA4D;SACtE,CAAC;IACJ,CAAC;IAED,IAAI,OAAwB,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,UAAU,EAAE;YACjD,UAAU,EAAE,iBAAiB,EAAE;SAChC,CAAC,CAAC;QACH,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,wEAAwE;QACxE,sEAAsE;QACtE,OAAO;YACL,QAAQ,EAAE,CAAC;YACX,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,yBAA0B,GAAa,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG;SAC3E,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAChD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,oEAAoE;QACpE,kEAAkE;QAClE,OAAO;YACL,QAAQ,EAAE,CAAC;YACX,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,YAAY,OAAO,6DAA6D;SAC1F,CAAC;IACJ,CAAC;IAED,IAAI,WAAW,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CACR,qCAAqC,OAAO,qBAAqB,WAAW,CAAC,IAAI,KAAK,CACvF,CAAC;QACF,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,IAAI,CACR,uCAAuC,OAAO,2BAA2B,QAAQ,IAAI;QACnF,yBAAyB,WAAW,CAAC,IAAI,mCAAmC;QAC5E,0CAA0C,QAAQ,8BAA8B,WAAW,CAAC,IAAI,cAAc;QAC9G,sDAAsD;QACtD,+CAA+C,CAClD,CAAC;IACF,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;AACjD,CAAC"}
+{"version":3,"file":"bundle-coherence.js","sourceRoot":"","sources":["../../../src/lib/validate/bundle-coherence.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,EAAE;AACF,4EAA4E;AAC5E,uEAAuE;AACvE,yEAAyE;AACzE,6EAA6E;AAC7E,qEAAqE;AACrE,EAAE;AACF,4EAA4E;AAC5E,0EAA0E;AAC1E,2DAA2D;AAC3D,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAChE,OAAO,EACL,eAAe,GAEhB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,qBAAqB,GAA6C;IACtE,kBAAkB,EAAE,mBAAmB;IACvC,qBAAqB,EAAE,cAAc;IACrC,qBAAqB,EAAE,sBAAsB;CAC9C,CAAC;AAWF,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,UAAkB;IAElB,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,WAAW,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;IAC1C,IAAI,CAAC,WAAW,EAAE,CAAC;QACjB,OAAO;YACL,QAAQ,EAAE,CAAC;YACX,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,4DAA4D;SACtE,CAAC;IACJ,CAAC;IAED,IAAI,OAAwB,CAAC;IAC7B,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,eAAe,CAAC,UAAU,EAAE;YACjD,UAAU,EAAE,gBAAgB,EAAE;SAC/B,CAAC,CAAC;QACH,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC;IAC7B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,wEAAwE;QACxE,sEAAsE;QACtE,OAAO;YACL,QAAQ,EAAE,CAAC;YACX,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,yBAA0B,GAAa,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG;SAC3E,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,qBAAqB,CAAC,OAAO,CAAC,CAAC;IAChD,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,oEAAoE;QACpE,kEAAkE;QAClE,OAAO;YACL,QAAQ,EAAE,CAAC;YACX,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,YAAY,OAAO,6DAA6D;SAC1F,CAAC;IACJ,CAAC;IAED,IAAI,WAAW,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAClC,KAAK,CAAC,IAAI,CACR,qCAAqC,OAAO,qBAAqB,WAAW,CAAC,IAAI,KAAK,CACvF,CAAC;QACF,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;IACjD,CAAC;IAED,KAAK,CAAC,IAAI,CACR,uCAAuC,OAAO,2BAA2B,QAAQ,IAAI;QACnF,yBAAyB,WAAW,CAAC,IAAI,mCAAmC;QAC5E,0CAA0C,QAAQ,8BAA8B,WAAW,CAAC,IAAI,cAAc;QAC9G,sDAAsD;QACtD,+CAA+C,CAClD,CAAC;IACF,OAAO,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;AACjD,CAAC"}

package/dist/lib/validate/plan.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The method-managed validation job, as DATA (bead sdm-dd6.2; Dagger ruling sdm-s48, 2026-10-15).
+ *
+ * One ordered plan per profile: every default validator, the platform's script-only checks, then the
+ * advisory catalogue freshness check. Every executor renders or runs THIS: the GitHub workflow
+ * generator (ci-workflow.ts) and the Dagger module (via `sdd-verify validate --list`). The job list
+ * drifted once when CI kept a hand copy of the suite (2026-10-01: three validators never reached CI),
+ * so no executor may keep its own list.
+ */
+import type { Profile } from "../repo-kind.js";
+export type PlanTool = "sdd-verify" | "sdd-maintain" | "bash";
+export interface PlanStep {
+    /** Stable id: the validator name, or a fixed id for script and freshness steps. */
+    readonly id: string;
+    readonly title: string;
+    readonly tool: PlanTool;
+    /** argv after the tool, run from the SDD root. */
+    readonly args: readonly string[];
+    /** Advisory steps report but never fail the job (Tom's ruling on the freshness step). */
+    readonly advisory: boolean;
+}
+export declare function methodValidationPlan(profile: Profile): readonly PlanStep[];
+/** The shell form of a step, as a CI host's `run:` line writes it. */
+export declare function stepCommand(step: PlanStep): string;
+//# sourceMappingURL=plan.d.ts.map

package/dist/lib/validate/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../../src/lib/validate/plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAG/C,MAAM,MAAM,QAAQ,GAAG,YAAY,GAAG,cAAc,GAAG,MAAM,CAAC;AAE9D,MAAM,WAAW,QAAQ;IACvB,mFAAmF;IACnF,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,yFAAyF;IACzF,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAoBD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,QAAQ,EAAE,CAwB1E;AAED,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAElD"}

package/dist/lib/validate/plan.js

@@ -0,0 +1,54 @@
+/**
+ * The method-managed validation job, as DATA (bead sdm-dd6.2; Dagger ruling sdm-s48, 2026-10-15).
+ *
+ * One ordered plan per profile: every default validator, the platform's script-only checks, then the
+ * advisory catalogue freshness check. Every executor renders or runs THIS: the GitHub workflow
+ * generator (ci-workflow.ts) and the Dagger module (via `sdd-verify validate --list`). The job list
+ * drifted once when CI kept a hand copy of the suite (2026-10-01: three validators never reached CI),
+ * so no executor may keep its own list.
+ */
+import { validatorsForProfile } from "./dispatch.js";
+/** Titles kept from the hand-kept list, so step names stay readable. */
+const TITLES = {
+    "adr-structure": "Validate ADR metadata",
+    "spec-lifecycle": "Validate spec lifecycle",
+    "no-bare-adr": "Reject bare ADR references",
+    traceability: "Validate traceability",
+    "runway-classification": "Validate runway classification",
+    "corpus-consistency": "Validate corpus consistency",
+    config: "Validate configuration",
+    "app-docs": "Validate app documentation",
+    "integration-docs": "Validate integration documentation",
+    "yaml-parse": "Validate that tracked YAML parses",
+    "gate-readiness": "Validate gate readiness",
+    "bundle-coherence": "Report bundle coherence",
+    // CI has no platform checkout, so this step runs the app-only checks; the met gate needs the platform beside it.
+    "app-dependencies": "Validate app dependencies (app-only checks; no platform checkout in CI)",
+};
+export function methodValidationPlan(profile) {
+    const steps = validatorsForProfile(profile)
+        .filter((v) => v.optional !== true)
+        .map((v) => ({
+        id: v.name,
+        title: TITLES[v.name] ?? `Validate ${v.name}`,
+        tool: "sdd-verify",
+        args: ["validate", "--target-repo", ".", "--validator", v.name],
+        advisory: false,
+    }));
+    if (profile === "platform") {
+        steps.push({ id: "cascade-completeness", title: "Validate cascade completeness", tool: "bash", args: ["orchestration/scripts/validate-cascade-completeness.sh", "all"], advisory: false }, { id: "architecture-alignment", title: "Validate architecture alignment", tool: "bash", args: ["orchestration/scripts/validate-architecture-alignment.sh"], advisory: false });
+    }
+    steps.push({
+        id: "catalogue-freshness",
+        title: "Check catalogues reproduce from the specs (advisory)",
+        tool: "sdd-maintain",
+        args: ["catalogue", "build", "--check", "--sdd-path", "."],
+        advisory: true,
+    });
+    return steps;
+}
+/** The shell form of a step, as a CI host's `run:` line writes it. */
+export function stepCommand(step) {
+    return [step.tool, ...step.args].join(" ");
+}
+//# sourceMappingURL=plan.js.map

package/dist/lib/validate/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../../src/lib/validate/plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AAerD,wEAAwE;AACxE,MAAM,MAAM,GAAqC;IAC/C,eAAe,EAAE,uBAAuB;IACxC,gBAAgB,EAAE,yBAAyB;IAC3C,aAAa,EAAE,4BAA4B;IAC3C,YAAY,EAAE,uBAAuB;IACrC,uBAAuB,EAAE,gCAAgC;IACzD,oBAAoB,EAAE,6BAA6B;IACnD,MAAM,EAAE,wBAAwB;IAChC,UAAU,EAAE,4BAA4B;IACxC,kBAAkB,EAAE,oCAAoC;IACxD,YAAY,EAAE,mCAAmC;IACjD,gBAAgB,EAAE,yBAAyB;IAC3C,kBAAkB,EAAE,yBAAyB;IAC7C,iHAAiH;IACjH,kBAAkB,EAAE,yEAAyE;CAC9F,CAAC;AAEF,MAAM,UAAU,oBAAoB,CAAC,OAAgB;IACnD,MAAM,KAAK,GAAe,oBAAoB,CAAC,OAAO,CAAC;SACpD,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,IAAI,CAAC;SAClC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACX,EAAE,EAAE,CAAC,CAAC,IAAI;QACV,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,CAAC,IAAI,EAAE;QAC7C,IAAI,EAAE,YAAqB;QAC3B,IAAI,EAAE,CAAC,UAAU,EAAE,eAAe,EAAE,GAAG,EAAE,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC;QAC/D,QAAQ,EAAE,KAAK;KAChB,CAAC,CAAC,CAAC;IACN,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;QAC3B,KAAK,CAAC,IAAI,CACR,EAAE,EAAE,EAAE,sBAAsB,EAAE,KAAK,EAAE,+BAA+B,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,wDAAwD,EAAE,KAAK,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,EAC9K,EAAE,EAAE,EAAE,wBAAwB,EAAE,KAAK,EAAE,iCAAiC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,0DAA0D,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAC9K,CAAC;IACJ,CAAC;IACD,KAAK,CAAC,IAAI,CAAC;QACT,EAAE,EAAE,qBAAqB;QACzB,KAAK,EAAE,sDAAsD;QAC7D,IAAI,EAAE,cAAc;QACpB,IAAI,EAAE,CAAC,WAAW,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,GAAG,CAAC;QAC1D,QAAQ,EAAE,IAAI;KACf,CAAC,CAAC;IACH,OAAO,KAAK,CAAC;AACf,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,WAAW,CAAC,IAAc;IACxC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC7C,CAAC"}

package/dist/maintain-bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=maintain-bin.d.ts.map

package/dist/maintain-bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maintain-bin.d.ts","sourceRoot":"","sources":["../src/maintain-bin.ts"],"names":[],"mappings":""}

package/dist/maintain-bin.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { runMaintain } from "./maintain-program.js";
+runMaintain(process.argv.slice(2)).catch((err) => {
+    const message = err instanceof Error ? err.message : String(err);
+    process.stderr.write(`sdd-maintain: ${message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=maintain-bin.js.map

package/dist/maintain-bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"maintain-bin.js","sourceRoot":"","sources":["../src/maintain-bin.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IACxD,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,OAAO,IAAI,CAAC,CAAC;IACnD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/maintain-program.d.ts

@@ -0,0 +1,8 @@
+import { Command } from "commander";
+/** The verbs maintain adds to verify, as `<verb>` or `<verb> <subcommand>`. Asserted by test. */
+export declare const MAINTAIN_ONLY_SURFACE: ReadonlyArray<string>;
+/** The full surface: verify's, plus maintain's own. */
+export declare const MAINTAIN_SURFACE: ReadonlyArray<string>;
+export declare function runMaintain(argv: readonly string[]): Promise<void>;
+export declare function buildMaintainProgram(): Command;
+//# sourceMappingURL=maintain-program.d.ts.map

package/dist/maintain-program.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maintain-program.d.ts","sourceRoot":"","sources":["../src/maintain-program.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,OAAO,EAAkB,MAAM,WAAW,CAAC;AAapD,iGAAiG;AACjG,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAAC,MAAM,CAWvD,CAAC;AAEF,uDAAuD;AACvD,eAAO,MAAM,gBAAgB,EAAE,aAAa,CAAC,MAAM,CAAiD,CAAC;AAMrG,wBAAsB,WAAW,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBxE;AAED,wBAAgB,oBAAoB,IAAI,OAAO,CAoC9C"}

package/dist/maintain-program.js

@@ -0,0 +1,94 @@
+// Fourth entrypoint: the MAINTAIN surface — M-ADR 0218.
+//
+// A binary that brings an SDD current and rebuilds its derived model, and cannot change
+// what the SDD says. It is to unattended sync waves what sdd-verify is to CI.
+//
+// A verb is here when everything it writes is DERIVED or METHOD-MANAGED, deterministically
+// (M-ADR 0218 §4.2–4.3): the method payload, lock, CI block and briefing (`sync`,
+// `generate-briefing`), the derived model (`catalogue build | aggregate | graph | diff`), an
+// output the caller names (`pack build`, `render screen`), and a code repository's briefing
+// (`context pull`). Plus the whole verify surface, because the personas nest.
+//
+// ⚠ As with sdd-verify, the boundary is ABSENCE, not a menu: the package ships only the import
+// closure of maintain-bin.js, so authoring verbs (init, scaffold, plan, conformance,
+// contracts, api-surface, snapshot, metamodel, migration-map) are not present to be reached.
+// That is why every registration below imports a per-subcommand registrar, never a barrel.
+// Unclassified verbs default to AUTHOR (M-ADR 0218 §4.2) and stay out until classified.
+import { Command, CommanderError } from "commander";
+import { getPackageVersion } from "./lib/package-version.js";
+import { registerVerifySurface, rejectOutsideSurface, VERIFY_SURFACE } from "./verify-program.js";
+import { registerCatalogueAggregate, registerCatalogueBuild, registerCatalogueDiff, registerCatalogueGraph } from "./verbs/catalogue-maintain.js";
+import { registerCatalogueCheck } from "./verbs/catalogue-check.js";
+import { registerContext } from "./verbs/context.js";
+import { registerGenerateBriefing } from "./verbs/generate-briefing.js";
+import { registerPackBuild } from "./verbs/pack-build.js";
+import { registerRender } from "./verbs/render.js";
+import { registerSync } from "./verbs/sync.js";
+const SPEC_URL = "https://github.com/tomfosteruk/sdd-method/blob/main/docs/method/cli/sdd-cli-specification.md";
+/** The verbs maintain adds to verify, as `<verb>` or `<verb> <subcommand>`. Asserted by test. */
+export const MAINTAIN_ONLY_SURFACE = [
+    "sync",
+    "generate-briefing",
+    "context pull",
+    "catalogue build",
+    "catalogue check",
+    "catalogue aggregate",
+    "catalogue graph",
+    "catalogue diff",
+    "pack build",
+    "render screen",
+];
+/** The full surface: verify's, plus maintain's own. */
+export const MAINTAIN_SURFACE = [...VERIFY_SURFACE, ...MAINTAIN_ONLY_SURFACE];
+const OUTSIDE = "is not part of sdd-maintain, which can bring a repository current and rebuild its derived model but cannot author specification content. " +
+    "Authoring verbs are in @sdd-method/sdd-cli.";
+export async function runMaintain(argv) {
+    const program = buildMaintainProgram();
+    if (argv.length === 0) {
+        program.outputHelp();
+        return;
+    }
+    rejectOutsideSurface(program, argv, OUTSIDE);
+    try {
+        await program.parseAsync([...argv], { from: "user" });
+    }
+    catch (err) {
+        if (err instanceof CommanderError) {
+            if (err.code === "commander.help" || err.code === "commander.helpDisplayed" || err.code === "commander.version") {
+                return;
+            }
+        }
+        throw err;
+    }
+}
+export function buildMaintainProgram() {
+    const program = new Command();
+    program
+        .name("sdd-maintain")
+        .description("Bring an SDD repository current and rebuild its derived model — sync, briefing, catalogue build and aggregate, pack build, context pull — plus every read-only verify verb. Cannot author specification content.")
+        .version(getPackageVersion(), "-v, --version")
+        .addHelpText("after", `\nSpec: ${SPEC_URL}\nAuthoring verbs (scaffold, plan, conformance, …) are in @sdd-method/author-cli; init is in @sdd-method/sdd-cli.`)
+        .exitOverride()
+        .configureOutput({
+        writeOut: (str) => process.stdout.write(str),
+        writeErr: (str) => process.stderr.write(str),
+    });
+    // The verify surface first, from verify's own registration: the nesting is structural.
+    registerVerifySurface(program);
+    registerSync(program);
+    registerGenerateBriefing(program);
+    registerContext(program);
+    registerRender(program);
+    const catalogue = program.commands.find((c) => c.name() === "catalogue");
+    catalogue.description("Build, aggregate, validate and query per-SDD catalogues (ADR 0134) — the derived model");
+    registerCatalogueBuild(catalogue);
+    registerCatalogueCheck(catalogue);
+    registerCatalogueAggregate(catalogue);
+    registerCatalogueGraph(catalogue);
+    registerCatalogueDiff(catalogue);
+    const pack = program.commands.find((c) => c.name() === "pack");
+    pack.description("Build and validate adopter-shipped context-pack bundles (ADR 0151)");
+    registerPackBuild(pack);
+    return program;
+}
+//# sourceMappingURL=maintain-program.js.map

package/dist/maintain-program.js.map

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

package/dist/maintain-version.json

@@ -0,0 +1,4 @@
+{
+  "version": "0.2.0",
+  "built_against_sdd_cli": "1.43.0"
+}

package/dist/verbs/catalogue-check.d.ts

@@ -0,0 +1,10 @@
+import type { Command } from "commander";
+/**
+ * `catalogue check` (M-ADR 0220 §4.2, ruling 3): whether the committed catalogues are what the
+ * committed specifications build to. It builds into temporary space and writes nothing to the
+ * repository: `catalogue build --check` under its own name, so the author's surface holds no verb
+ * that writes the model. Its own registrar, so an artefact can carry it without the build,
+ * aggregate and graph registrations in catalogue-maintain.ts.
+ */
+export declare function registerCatalogueCheck(catalogue: Command): void;
+//# sourceMappingURL=catalogue-check.d.ts.map

package/dist/verbs/catalogue-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalogue-check.d.ts","sourceRoot":"","sources":["../../src/verbs/catalogue-check.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUzC;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,CAyB/D"}

package/dist/verbs/catalogue-check.js

@@ -0,0 +1,28 @@
+import { resolve } from "node:path";
+import { checkCataloguesFresh } from "../lib/catalogue/freshness.js";
+/**
+ * `catalogue check` (M-ADR 0220 §4.2, ruling 3): whether the committed catalogues are what the
+ * committed specifications build to. It builds into temporary space and writes nothing to the
+ * repository: `catalogue build --check` under its own name, so the author's surface holds no verb
+ * that writes the model. Its own registrar, so an artefact can carry it without the build,
+ * aggregate and graph registrations in catalogue-maintain.ts.
+ */
+export function registerCatalogueCheck(catalogue) {
+    catalogue
+        .command("check")
+        .description("Report whether the committed catalogues/ are what the committed specifications build to; builds in a temporary directory and writes nothing (exit 1 lists every stale file)")
+        .option("--sdd-path <path>", "Path to the SDD repo root (defaults to cwd)")
+        .option("--strict", "Treat build findings as failures")
+        .option("--snapshot-store <dir>", "Snapshot store root the binding's snapshot_area is relative to (default: $SDD_SNAPSHOT_STORE; M-ADR 0214)")
+        .action(async (opts) => {
+        const snapshotStore = opts.snapshotStore ?? process.env.SDD_SNAPSHOT_STORE;
+        const r = await checkCataloguesFresh(resolve(opts.sddPath ?? process.cwd()), {
+            label: "catalogue check",
+            ...(opts.strict !== undefined ? { strict: opts.strict } : {}),
+            ...(snapshotStore !== undefined ? { snapshotStore } : {}),
+        }, (s) => process.stdout.write(s));
+        if (r.exitCode !== 0)
+            process.exit(r.exitCode);
+    });
+}
+//# sourceMappingURL=catalogue-check.js.map