@sdd-method/sdd-cli 0.48.0 → 0.50.0

package/dist/lib/pack/seed.js

@@ -57,22 +57,29 @@ async function loadSeedRecursive(absPath, visited) {
             ...asStringArray(own.forbidden_paths, "forbidden_paths", absPath, true),
         ]
         : undefined;
+    const scaffoldSourcePaths = Array.isArray(own.scaffold_source_paths)
+        ? asStringArray(own.scaffold_source_paths, "scaffold_source_paths", absPath, true)
+        : undefined;
     const seed = {
         version: asString(own.version, "version", absPath),
         scope: asString(own.scope, "scope", absPath),
-        forwardBase: {
-            bundle: asString(own.forward_base?.bundle, "forward_base.bundle", absPath),
-            minimumVersion: asString(own.forward_base?.minimum_version, "forward_base.minimum_version", absPath),
-            sourceRepo: own.forward_base?.source_repo
-                ? asString(own.forward_base.source_repo, "forward_base.source_repo", absPath)
-                : "sdd-method",
-        },
+        // forward_base optional per ADR 0176 §4.6 (profile-agnostic packs omit it)
+        ...(own.forward_base && {
+            forwardBase: {
+                bundle: asString(own.forward_base.bundle, "forward_base.bundle", absPath),
+                minimumVersion: asString(own.forward_base.minimum_version, "forward_base.minimum_version", absPath),
+                sourceRepo: own.forward_base.source_repo
+                    ? asString(own.forward_base.source_repo, "forward_base.source_repo", absPath)
+                    : "sdd-method",
+            },
+        }),
         minimumSddCliVersion: asString(own.minimum_sdd_cli_version, "minimum_sdd_cli_version", absPath),
         description: asString(own.description, "description", absPath),
         managedPaths,
         sourcePath: absPath,
         ...(includes.length > 0 && { include: includes }),
         ...(forbiddenPaths && { forbiddenPaths }),
+        ...(scaffoldSourcePaths && scaffoldSourcePaths.length > 0 && { scaffoldSourcePaths }),
         ...(own.requires_pack && {
             requiresPack: {
                 name: asString(own.requires_pack.name, "requires_pack.name", absPath),

package/dist/lib/pack/seed.js.map

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

package/dist/lib/scaffold/domain.d.ts

@@ -1,3 +1,4 @@
+import type { RegistryArchetype } from "./registry.js";
 /**
  * Domain scaffolding (ADR 0173). Writes the invariant domain shape into a
  * platform-root SDD, optionally seeded from a domain archetype. The generic
@@ -14,6 +15,13 @@ export interface DomainScaffoldInput {
     name: string;
     targetRepo: string;
     archetype?: DomainArchetype;
+    /**
+     * Registry-resolved archetype (reference-architecture / adopter tier,
+     * ADR 0176 §4.4). Mutually exclusive with the method-tier `archetype`.
+     * Seed files are copied from the bundle cache into the new domain —
+     * copy-and-own: the output is adopter content from creation.
+     */
+    registryArchetype?: RegistryArchetype;
     withContracts?: boolean;
 }
 export declare function scaffoldDomain(input: DomainScaffoldInput): Promise<{

package/dist/lib/scaffold/domain.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../../src/lib/scaffold/domain.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAEH,eAAO,MAAM,wBAAwB,0BAA2B,CAAC;AACjE,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,eAAe,CAE/E;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,wBAAsB,cAAc,CAClC,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA0BrC"}
+{"version":3,"file":"domain.d.ts","sourceRoot":"","sources":["../../../src/lib/scaffold/domain.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEvD;;;;;;;;GAQG;AAEH,eAAO,MAAM,wBAAwB,0BAA2B,CAAC;AACjE,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,eAAe,CAE/E;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,eAAe,CAAC;IAC5B;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,wBAAsB,cAAc,CAClC,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAwCrC"}

package/dist/lib/scaffold/domain.js

@@ -1,5 +1,5 @@
-import { mkdir, writeFile } from "node:fs/promises";
-import { dirname, join } from "node:path";
+import { access, copyFile, mkdir, readdir, writeFile } from "node:fs/promises";
+import { dirname, join, relative } from "node:path";
 /**
  * Domain scaffolding (ADR 0173). Writes the invariant domain shape into a
  * platform-root SDD, optionally seeded from a domain archetype. The generic
@@ -20,22 +20,89 @@ export async function scaffoldDomain(input) {
         await writeFileAt(join(base, rel), content);
         filesWritten.push(join("docs", "domains", input.name, rel));
     };
-    await write("README.md", renderDomainReadme(input));
-    await write("architecture/glossary.md", renderDomainGlossary(input));
-    await write("architecture/data-model.mermaid.md", renderDomainDataModel(input));
-    await write("architecture/diagrams/.gitkeep", "");
-    await write("architecture/adr/.gitkeep", "");
-    await write("design/.gitkeep", "");
-    await write("product/.gitkeep", "");
+    const writeIfMissing = async (rel, content) => {
+        if (await fileExists(join(base, rel)))
+            return;
+        await write(rel, content);
+    };
+    // Registry archetype (ADR 0176 §4.4): copy seed files from the bundle
+    // cache FIRST — copy-and-own; the generic shape then fills only the
+    // gaps the seed didn't provide.
+    if (input.registryArchetype) {
+        const copied = await copyRegistrySeeds(input.registryArchetype, base);
+        for (const rel of copied) {
+            filesWritten.push(join("docs", "domains", input.name, rel));
+        }
+    }
+    await writeIfMissing("README.md", renderDomainReadme(input));
+    await writeIfMissing("architecture/glossary.md", renderDomainGlossary(input));
+    await writeIfMissing("architecture/data-model.mermaid.md", renderDomainDataModel(input));
+    await writeIfMissing("architecture/diagrams/.gitkeep", "");
+    await writeIfMissing("architecture/adr/.gitkeep", "");
+    await writeIfMissing("design/.gitkeep", "");
+    await writeIfMissing("product/.gitkeep", "");
     if (input.withContracts) {
-        await write("contracts/.gitkeep", "");
+        await writeIfMissing("contracts/.gitkeep", "");
     }
-    // Archetype overlay (method tier only in this prototype).
+    // Archetype overlay (method tier).
     if (input.archetype === "integration") {
         await write("architecture/interaction-patterns.md", renderIntegrationArchetype());
     }
     return { filesWritten };
 }
+/**
+ * Copy a registry archetype's seed files from the bundle cache into the
+ * domain directory, stripping the seed prefix: a seed prefix
+ * `core-b2b-saas/domains/identity/` maps its files onto the domain root.
+ * Returns the relative paths written (relative to the domain dir).
+ */
+async function copyRegistrySeeds(archetype, domainDir) {
+    const written = [];
+    for (const seedPrefix of archetype.seeds) {
+        const seedRoot = join(archetype.bundleCacheDir, seedPrefix);
+        const files = await walkFiles(seedRoot);
+        for (const abs of files) {
+            const rel = relative(seedRoot, abs);
+            const dst = join(domainDir, rel);
+            await mkdir(dirname(dst), { recursive: true });
+            await copyFile(abs, dst);
+            written.push(rel);
+        }
+    }
+    if (written.length === 0) {
+        throw new Error(`Archetype '${archetype.id}' (bundle ${archetype.bundleName}) has no seed files in the cache — re-sync the bundle.`);
+    }
+    return written;
+}
+async function walkFiles(root) {
+    const out = [];
+    let entries;
+    try {
+        entries = await readdir(root, { withFileTypes: true });
+    }
+    catch {
+        return out;
+    }
+    for (const e of entries) {
+        const child = join(root, e.name);
+        if (e.isDirectory()) {
+            out.push(...(await walkFiles(child)));
+        }
+        else if (e.isFile()) {
+            out.push(child);
+        }
+    }
+    return out;
+}
+async function fileExists(path) {
+    try {
+        await access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
 function titleize(slug) {
     return slug
         .split("-")

package/dist/lib/scaffold/domain.js.map

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

package/dist/lib/scaffold/registry.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Archetype-registry resolution (ADR 0176 §4.1/§4.4).
+ *
+ * Non-method-tier domain archetypes are resolved from the registries of
+ * consumed bundles in the local bundle cache
+ * (`.sdd/bundle-cache/<bundle>@<version>/registry.yaml`). The method
+ * tier stays built into sdd-cli (ADR 0173).
+ *
+ * Reference form: `<id>` resolves when unique across cached bundles;
+ * `<bundle>:<id>` qualifies on collision (mirrors ADR 0140 §4.5).
+ */
+export interface RegistryArchetype {
+    id: string;
+    tier: string;
+    layer?: string;
+    domainName?: string;
+    status?: string;
+    seeds: string[];
+    notes?: string;
+    /** Bundle (name, no version) whose registry declared this archetype. */
+    bundleName: string;
+    /** Absolute path to the cached bundle root (payload-shaped). */
+    bundleCacheDir: string;
+}
+export interface RegistryResolution {
+    ok: boolean;
+    archetype?: RegistryArchetype;
+    /** All discovered archetypes (for error messages / listings). */
+    available: RegistryArchetype[];
+    error?: string;
+}
+/**
+ * Scan the bundle cache for registries and return every archetype found.
+ * Bundles without a registry.yaml are skipped silently (vendor packs etc.).
+ */
+export declare function discoverArchetypes(targetRepo: string): Promise<RegistryArchetype[]>;
+/**
+ * Resolve an archetype reference against the cache. Accepts bare ids
+ * (`core/identity`) and bundle-qualified ids
+ * (`ref-arch-core-b2b-saas:core/identity`).
+ */
+export declare function resolveArchetype(targetRepo: string, reference: string): Promise<RegistryResolution>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/lib/scaffold/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/lib/scaffold/registry.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;GAUG;AAEH,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wEAAwE;IACxE,UAAU,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,OAAO,CAAC;IACZ,SAAS,CAAC,EAAE,iBAAiB,CAAC;IAC9B,iEAAiE;IACjE,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAQD;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAuD9B;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CACpC,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,kBAAkB,CAAC,CAmC7B"}

package/dist/lib/scaffold/registry.js

@@ -0,0 +1,104 @@
+import { readFile, readdir } from "node:fs/promises";
+import { join } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { BUNDLE_CACHE_REL, REGISTRY_FILE } from "../sync/bundle-cache.js";
+/**
+ * Scan the bundle cache for registries and return every archetype found.
+ * Bundles without a registry.yaml are skipped silently (vendor packs etc.).
+ */
+export async function discoverArchetypes(targetRepo) {
+    const cacheRoot = join(targetRepo, BUNDLE_CACHE_REL);
+    let entries;
+    try {
+        entries = await readdir(cacheRoot, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const out = [];
+    for (const e of entries) {
+        if (!e.isDirectory())
+            continue;
+        const bundleCacheDir = join(cacheRoot, e.name);
+        const at = e.name.lastIndexOf("@");
+        const bundleName = at > 0 ? e.name.slice(0, at) : e.name;
+        let raw;
+        try {
+            raw = await readFile(join(bundleCacheDir, REGISTRY_FILE), "utf8");
+        }
+        catch {
+            continue; // no registry in this bundle
+        }
+        let parsed;
+        try {
+            parsed = parseYaml(raw);
+        }
+        catch {
+            continue; // malformed registry — skip rather than break scaffold
+        }
+        if (parsed === null || typeof parsed !== "object")
+            continue;
+        if (!Array.isArray(parsed.archetypes))
+            continue;
+        const tier = typeof parsed.tier === "string" ? parsed.tier : "unknown";
+        for (const a of parsed.archetypes) {
+            if (a === null || typeof a !== "object")
+                continue;
+            const rec = a;
+            const id = typeof rec.id === "string" ? rec.id : undefined;
+            const seeds = Array.isArray(rec.seeds)
+                ? rec.seeds.filter((s) => typeof s === "string")
+                : [];
+            if (!id || seeds.length === 0)
+                continue;
+            out.push({
+                id,
+                tier,
+                seeds,
+                bundleName,
+                bundleCacheDir,
+                ...(typeof rec.layer === "string" && { layer: rec.layer }),
+                ...(typeof rec.domain_name === "string" && { domainName: rec.domain_name }),
+                ...(typeof rec.status === "string" && { status: rec.status }),
+                ...(typeof rec.notes === "string" && { notes: rec.notes }),
+            });
+        }
+    }
+    return out;
+}
+/**
+ * Resolve an archetype reference against the cache. Accepts bare ids
+ * (`core/identity`) and bundle-qualified ids
+ * (`ref-arch-core-b2b-saas:core/identity`).
+ */
+export async function resolveArchetype(targetRepo, reference) {
+    const available = await discoverArchetypes(targetRepo);
+    let bundleFilter;
+    let id = reference;
+    const colon = reference.indexOf(":");
+    if (colon > 0) {
+        bundleFilter = reference.slice(0, colon);
+        id = reference.slice(colon + 1);
+    }
+    const matches = available.filter((a) => a.id === id && (bundleFilter === undefined || a.bundleName === bundleFilter));
+    if (matches.length === 1) {
+        return { ok: true, archetype: matches[0], available };
+    }
+    if (matches.length === 0) {
+        const known = available.map((a) => `${a.bundleName}:${a.id}`).join(", ");
+        return {
+            ok: false,
+            available,
+            error: available.length === 0
+                ? `No archetype registries found in ${BUNDLE_CACHE_REL}/ — sync an archetype-bearing bundle first (ADR 0176).`
+                : `Archetype '${reference}' not found in cached registries. Available: ${known}`,
+        };
+    }
+    const collisions = matches.map((a) => `${a.bundleName}:${a.id}`).join(", ");
+    return {
+        ok: false,
+        available,
+        error: `Archetype id '${id}' is declared by multiple bundles (${collisions}). Use the qualified form '<bundle>:<id>'.`,
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/lib/scaffold/registry.js.map

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

package/dist/lib/sync/bundle-cache.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Consumer-side bundle cache (ADR 0176 §4.2).
+ *
+ * Every consumed non-forward-base bundle is extracted to
+ * `<targetRepo>/.sdd/bundle-cache/<bundleName>@<version>/` — the
+ * resolution substrate for `sdd-cli scaffold domain --archetype` and
+ * the staging source for materialise-mode paths. The cache directory
+ * is gitignored (ensured at sync time).
+ *
+ * Cache layout per bundle: the bundle's payload tree, verbatim (so
+ * registry.yaml and scaffold-source files sit at their shipped paths).
+ * Stale versions of the same bundle name are pruned on refresh.
+ */
+export declare const BUNDLE_CACHE_REL = ".sdd/bundle-cache";
+/** The registry file name (ADR 0176 §4.1) — always cache-only. */
+export declare const REGISTRY_FILE = "registry.yaml";
+/**
+ * Split a bundle's managed paths into the set to materialise into the
+ * repo tree vs the set that stays cache-only (ADR 0176 §4.3):
+ * scaffold-source-prefixed paths and the registry file are cache-only.
+ */
+export declare function splitConsumptionModes(managedPaths: readonly string[], scaffoldSourcePaths: readonly string[] | undefined): {
+    materialise: string[];
+    cacheOnly: string[];
+};
+export interface CacheBundleInput {
+    targetRepo: string;
+    bundleName: string;
+    bundleVersion: string;
+    /** All managed paths (the full payload is cached, both modes). */
+    managedPaths: readonly string[];
+    payloadDir: string;
+}
+/**
+ * Extract a bundle's payload into the cache, replacing any previously
+ * cached version of the same bundle name (one cached version per
+ * bundle — the lock pins exactly one).
+ */
+export declare function cacheBundle(input: CacheBundleInput): Promise<string>;
+/**
+ * Ensure the consumer's .gitignore excludes the bundle cache. Appends
+ * a marked line when absent; leaves adopter content untouched otherwise.
+ */
+export declare function ensureCacheGitignored(targetRepo: string): Promise<boolean>;
+//# sourceMappingURL=bundle-cache.d.ts.map

package/dist/lib/sync/bundle-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-cache.d.ts","sourceRoot":"","sources":["../../../src/lib/sync/bundle-cache.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AAEH,eAAO,MAAM,gBAAgB,sBAAsB,CAAC;AAEpD,kEAAkE;AAClE,eAAO,MAAM,aAAa,kBAAkB,CAAC;AAE7C;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,SAAS,MAAM,EAAE,EAC/B,mBAAmB,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GACjD;IAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAAC,SAAS,EAAE,MAAM,EAAE,CAAA;CAAE,CAchD;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,kEAAkE;IAClE,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAY1E;AAmBD;;;GAGG;AACH,wBAAsB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAkBhF"}

package/dist/lib/sync/bundle-cache.js

@@ -0,0 +1,92 @@
+import { appendFile, copyFile, mkdir, readFile, readdir, rm } from "node:fs/promises";
+import { dirname, join } from "node:path";
+/**
+ * Consumer-side bundle cache (ADR 0176 §4.2).
+ *
+ * Every consumed non-forward-base bundle is extracted to
+ * `<targetRepo>/.sdd/bundle-cache/<bundleName>@<version>/` — the
+ * resolution substrate for `sdd-cli scaffold domain --archetype` and
+ * the staging source for materialise-mode paths. The cache directory
+ * is gitignored (ensured at sync time).
+ *
+ * Cache layout per bundle: the bundle's payload tree, verbatim (so
+ * registry.yaml and scaffold-source files sit at their shipped paths).
+ * Stale versions of the same bundle name are pruned on refresh.
+ */
+export const BUNDLE_CACHE_REL = ".sdd/bundle-cache";
+/** The registry file name (ADR 0176 §4.1) — always cache-only. */
+export const REGISTRY_FILE = "registry.yaml";
+/**
+ * Split a bundle's managed paths into the set to materialise into the
+ * repo tree vs the set that stays cache-only (ADR 0176 §4.3):
+ * scaffold-source-prefixed paths and the registry file are cache-only.
+ */
+export function splitConsumptionModes(managedPaths, scaffoldSourcePaths) {
+    const prefixes = scaffoldSourcePaths ?? [];
+    const materialise = [];
+    const cacheOnly = [];
+    for (const p of managedPaths) {
+        const isScaffoldSource = prefixes.some((prefix) => p.startsWith(prefix));
+        const isRegistry = p === REGISTRY_FILE;
+        if (isScaffoldSource || isRegistry) {
+            cacheOnly.push(p);
+        }
+        else {
+            materialise.push(p);
+        }
+    }
+    return { materialise, cacheOnly };
+}
+/**
+ * Extract a bundle's payload into the cache, replacing any previously
+ * cached version of the same bundle name (one cached version per
+ * bundle — the lock pins exactly one).
+ */
+export async function cacheBundle(input) {
+    const cacheRoot = join(input.targetRepo, BUNDLE_CACHE_REL);
+    await prunePreviousVersions(cacheRoot, input.bundleName);
+    const dest = join(cacheRoot, `${input.bundleName}@${input.bundleVersion}`);
+    for (const p of input.managedPaths) {
+        const src = join(input.payloadDir, p);
+        const dst = join(dest, p);
+        await mkdir(dirname(dst), { recursive: true });
+        await copyFile(src, dst);
+    }
+    return dest;
+}
+async function prunePreviousVersions(cacheRoot, bundleName) {
+    let entries;
+    try {
+        entries = await readdir(cacheRoot, { withFileTypes: true });
+    }
+    catch {
+        return; // no cache yet
+    }
+    for (const e of entries) {
+        if (e.isDirectory() && e.name.startsWith(`${bundleName}@`)) {
+            await rm(join(cacheRoot, e.name), { recursive: true, force: true });
+        }
+    }
+}
+/**
+ * Ensure the consumer's .gitignore excludes the bundle cache. Appends
+ * a marked line when absent; leaves adopter content untouched otherwise.
+ */
+export async function ensureCacheGitignored(targetRepo) {
+    const giPath = join(targetRepo, ".gitignore");
+    const line = `${BUNDLE_CACHE_REL}/`;
+    let existing = "";
+    try {
+        existing = await readFile(giPath, "utf8");
+    }
+    catch {
+        // no .gitignore yet — create one below
+    }
+    if (existing.split("\n").some((l) => l.trim() === line || l.trim() === BUNDLE_CACHE_REL)) {
+        return false;
+    }
+    const prefixNewline = existing.length > 0 && !existing.endsWith("\n") ? "\n" : "";
+    await appendFile(giPath, `${prefixNewline}# sdd-cli bundle cache (ADR 0176) — extracted bundle payloads, not source\n${line}\n`);
+    return true;
+}
+//# sourceMappingURL=bundle-cache.js.map

package/dist/lib/sync/bundle-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundle-cache.js","sourceRoot":"","sources":["../../../src/lib/sync/bundle-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACtF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAE1C;;;;;;;;;;;;GAYG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG,mBAAmB,CAAC;AAEpD,kEAAkE;AAClE,MAAM,CAAC,MAAM,aAAa,GAAG,eAAe,CAAC;AAE7C;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CACnC,YAA+B,EAC/B,mBAAkD;IAElD,MAAM,QAAQ,GAAG,mBAAmB,IAAI,EAAE,CAAC;IAC3C,MAAM,WAAW,GAAa,EAAE,CAAC;IACjC,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,KAAK,MAAM,CAAC,IAAI,YAAY,EAAE,CAAC;QAC7B,MAAM,gBAAgB,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QACzE,MAAM,UAAU,GAAG,CAAC,KAAK,aAAa,CAAC;QACvC,IAAI,gBAAgB,IAAI,UAAU,EAAE,CAAC;YACnC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,CAAC;AACpC,CAAC;AAWD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAuB;IACvD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC;IAC3D,MAAM,qBAAqB,CAAC,SAAS,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAEzD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,EAAE,GAAG,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC;IAC3E,KAAK,MAAM,CAAC,IAAI,KAAK,CAAC,YAAY,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;QACtC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QAC1B,MAAM,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,MAAM,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,KAAK,UAAU,qBAAqB,CAClC,SAAiB,EACjB,UAAkB;IAElB,IAAI,OAAO,CAAC;IACZ,IAAI,CAAC;QACH,OAAO,GAAG,MAAM,OAAO,CAAC,SAAS,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,eAAe;IACzB,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,UAAU,GAAG,CAAC,EAAE,CAAC;YAC3D,MAAM,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACtE,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,UAAkB;IAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,EAAE,YAAY,CAAC,CAAC;IAC9C,MAAM,IAAI,GAAG,GAAG,gBAAgB,GAAG,CAAC;IACpC,IAAI,QAAQ,GAAG,EAAE,CAAC;IAClB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5C,CAAC;IAAC,MAAM,CAAC;QACP,uCAAuC;IACzC,CAAC;IACD,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,gBAAgB,CAAC,EAAE,CAAC;QACzF,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,aAAa,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IAClF,MAAM,UAAU,CACd,MAAM,EACN,GAAG,aAAa,8EAA8E,IAAI,IAAI,CACvG,CAAC;IACF,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/lib/sync/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/sync/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAE/D,OAAO,EASL,KAAK,QAAQ,EACd,MAAM,iBAAiB,CAAC;AAmBzB,OAAO,EAAyB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAa/E,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc,EAAE,OAAO,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID,wBAAsB,OAAO,CAC3B,IAAI,EAAE,WAAW,EACjB,MAAM,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAA2C,GACpE,OAAO,CAAC,UAAU,CAAC,CA8WrB;AA2BD;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,cAAc,EACxB,iBAAiB,CAAC,EAAE,MAAM,GACzB,MAAM,GAAG,IAAI,CAUf;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,QAAQ,GAAG,IAAI,EACzB,QAAQ,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,EACpD,kBAAkB,EAAE,MAAM,GACzB,MAAM,GAAG,IAAI,CAqBf;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,QAAQ,GAAG,IAAI,EACzB,QAAQ,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAC3C,kBAAkB,EAAE,MAAM,GACzB,MAAM,GAAG,IAAI,CAef;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAkCtE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/sync/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAE/D,OAAO,EASL,KAAK,QAAQ,EACd,MAAM,iBAAiB,CAAC;AAwBzB,OAAO,EAAyB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAa/E,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,cAAc,EAAE,OAAO,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,YAAY,CAAC;CAC7B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID,wBAAsB,OAAO,CAC3B,IAAI,EAAE,WAAW,EACjB,MAAM,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAA2C,GACpE,OAAO,CAAC,UAAU,CAAC,CAiZrB;AA2BD;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,cAAc,EACxB,iBAAiB,CAAC,EAAE,MAAM,GACzB,MAAM,GAAG,IAAI,CAUf;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,QAAQ,GAAG,IAAI,EACzB,QAAQ,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,EACpD,kBAAkB,EAAE,MAAM,GACzB,MAAM,GAAG,IAAI,CAqBf;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,QAAQ,GAAG,IAAI,EACzB,QAAQ,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,EAC3C,kBAAkB,EAAE,MAAM,GACzB,MAAM,GAAG,IAAI,CAef;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAkCtE"}

package/dist/lib/sync/index.js

@@ -6,6 +6,7 @@ import { findBundle, findForwardBase, hasForwardBase, pathToBundleMap, readLockF
 import { REPO_KIND_FILE, profileFromBundleName, repoKindFromProfile, writeRepoKind, } from "../repo-kind.js";
 import { join } from "node:path";
 import { copyManagedFiles, removeManagedFiles } from "./apply.js";
+import { cacheBundle, ensureCacheGitignored, splitConsumptionModes, } from "./bundle-cache.js";
 import { PROTECTED_PREFIXES, computeRemovals, findConflicts, findMissingPayloadFiles, findProtectedPaths, } from "./diff.js";
 import { syncMethodManagedSettings } from "./settings-merge.js";
 import { syncMethodManagedCopilotHooks } from "./copilot-hooks-merge.js";
@@ -45,13 +46,17 @@ export async function runSync(opts, stdout = (line) => process.stdout.write(line
             stdout(fail(`Missing payload file listed in MANAGED_PATHS.txt: ${missing[0]}`));
             return { exitCode: 1 };
         }
+        // ADR 0176 §4.3: split consumption modes. Scaffold-source paths and
+        // the registry file extract to the bundle cache only; everything
+        // else materialises into the repo tree as before.
+        const { materialise: materialisePaths, cacheOnly: cacheOnlyPaths } = splitConsumptionModes(bundle.managedPaths, bundle.manifest.scaffoldSourcePaths);
         const protectedIncoming = findProtectedPaths(bundle.managedPaths);
         if (protectedIncoming.length > 0) {
             stdout(fail(`Incoming bundle attempts to manage protected product-owned path: ${protectedIncoming[0]}`));
             stdout(fail(`Method baseline bundles must not manage files under: ${PROTECTED_PREFIXES.join(" ")}`));
             return { exitCode: 1 };
         }
-        const conflicts = await findConflicts(bundle.managedPaths, bundle.payloadDir, opts.targetRepo);
+        const conflicts = await findConflicts(materialisePaths, bundle.payloadDir, opts.targetRepo);
         if (conflicts.length > 0 && !opts.allowOverwrite) {
             stdout(fail(`Found ${conflicts.length} conflicting managed file(s). Re-run with --allow-overwrite to apply.`));
             for (const p of conflicts)
@@ -112,11 +117,14 @@ export async function runSync(opts, stdout = (line) => process.stdout.write(line
         // Removals are scoped to THIS bundle's previously-managed paths.
         const prevBundleEntry = findBundle(prevLock, incomingBundleName);
         const prevPaths = prevBundleEntry?.managedPaths ?? [];
-        const removals = computeRemovals(prevPaths, bundle.managedPaths, {
+        const removals = computeRemovals(prevPaths, materialisePaths, {
             noDelete: !opts.delete,
         });
         stdout(info(`Bundle: ${incomingBundleName} (version: ${bundle.manifest.bundleVersion})`));
         stdout(info(`Incoming managed files: ${bundle.managedPaths.length}`));
+        if (cacheOnlyPaths.length > 0) {
+            stdout(info(`Cache-only (scaffold-source/registry) files: ${cacheOnlyPaths.length} — extracted to .sdd/bundle-cache, not materialised`));
+        }
         stdout(info(`Conflicts: ${conflicts.length}`));
         stdout(info(`Removals from previous sync of this bundle: ${removals.length}`));
         stdout(info(`Protected ownership prefixes: ${PROTECTED_PREFIXES.join(" ")}`));
@@ -134,8 +142,22 @@ export async function runSync(opts, stdout = (line) => process.stdout.write(line
             }
             return { exitCode: 0 };
         }
-        await copyManagedFiles(bundle.managedPaths, bundle.payloadDir, opts.targetRepo);
+        await copyManagedFiles(materialisePaths, bundle.payloadDir, opts.targetRepo);
         await removeManagedFiles(removals, opts.targetRepo);
+        // ADR 0176 §4.2: cache non-forward-base bundles (the resolution
+        // substrate for scaffold --archetype). Forward bases are not cached
+        // — they carry no archetype registries and are large.
+        if (!bundle.manifest.isForwardBase) {
+            await cacheBundle({
+                targetRepo: opts.targetRepo,
+                bundleName: bundle.manifest.bundleName,
+                bundleVersion: bundle.manifest.bundleVersion,
+                managedPaths: bundle.managedPaths,
+                payloadDir: bundle.payloadDir,
+            });
+            const ignored = await ensureCacheGitignored(opts.targetRepo);
+            stdout(info(`Bundle cached: .sdd/bundle-cache/${bundle.manifest.bundleName}@${bundle.manifest.bundleVersion}${ignored ? " (.gitignore updated)" : ""}`));
+        }
         const bundleSha = await sha256File(opts.bundle);
         const newEntry = {
             name: incomingBundleName,