@sdd-method/sdd-cli 0.47.0 → 0.49.0

package/dist/lib/scaffold/domain.js

@@ -0,0 +1,234 @@
+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
+ * shape is method-owned and domain-agnostic; archetypes overlay starter content.
+ *
+ * Only the `integration` archetype is built in (the method tier — the method
+ * owns that vocabulary via ADR 0171/0172). Reference-architecture and adopter
+ * archetypes are resolved from a consumed registry (not in this prototype).
+ */
+export const METHOD_DOMAIN_ARCHETYPES = ["integration"];
+export function isMethodDomainArchetype(value) {
+    return METHOD_DOMAIN_ARCHETYPES.includes(value);
+}
+export async function scaffoldDomain(input) {
+    const base = join(input.targetRepo, "docs", "domains", input.name);
+    const filesWritten = [];
+    const write = async (rel, content) => {
+        await writeFileAt(join(base, rel), content);
+        filesWritten.push(join("docs", "domains", input.name, rel));
+    };
+    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 writeIfMissing("contracts/.gitkeep", "");
+    }
+    // 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("-")
+        .filter((p) => p.length > 0)
+        .map((p) => p[0].toUpperCase() + p.slice(1))
+        .join(" ");
+}
+function renderDomainReadme(input) {
+    const title = titleize(input.name);
+    const intro = input.archetype === "integration"
+        ? "Provider-specific integrations that bridge external systems to the platform via canonical contracts. Each integration is a separate `integration-product` SDD that registers into this domain (ADR 0136)."
+        : `TODO: one-paragraph description of the ${title} domain — the capability slice it owns and its boundary.`;
+    return ([
+        `# ${title} Domain`,
+        "",
+        `> ${intro}`,
+        "",
+        "## Architecture",
+        "",
+        "- [Glossary](architecture/glossary.md) — domain vocabulary",
+        "- [Data Model](architecture/data-model.mermaid.md) — entity-relationship diagram",
+        "- [ADRs](architecture/adr/) — domain-specific architecture decisions",
+        "- [Diagrams](architecture/diagrams/) — C4 and other diagrams",
+        ...(input.archetype === "integration"
+            ? [
+                "- [Interaction Patterns](architecture/interaction-patterns.md) — ingestion / invocation patterns (sdd-method#0171/#0172)",
+            ]
+            : []),
+        "",
+        "## Product",
+        "",
+        "- [Capability Specs](product/) — domain capabilities",
+        "",
+        "## Design",
+        "",
+        "- [Design](design/) — feature/design grounding",
+        ...(input.withContracts
+            ? ["", "## Contracts", "", "- [Contracts](contracts/) — contracts this domain exposes"]
+            : []),
+        "",
+    ].join("\n"));
+}
+function renderDomainGlossary(input) {
+    const title = titleize(input.name);
+    if (input.archetype === "integration") {
+        return ([
+            `# ${title} Domain Glossary`,
+            "",
+            "> Vocabulary for this domain. Interaction-pattern terms below are anchored in",
+            "> Enterprise Integration Patterns (sdd-method#0172).",
+            "",
+            "| Term | Definition |",
+            "|------|------------|",
+            "| Provider | An external system this platform integrates with. |",
+            "| Ingestion pattern | How an integration acquires data (event-stream-consume / webhook / socket-listen / poll). |",
+            "| Invocation pattern | How an integration invokes a provider (request-response / async-request / publish). |",
+            "| CanonicalEvent | The normalised event an integration translates provider data into. |",
+            "",
+        ].join("\n"));
+    }
+    return ([
+        `# ${title} Domain Glossary`,
+        "",
+        "> Owned vocabulary for this domain. One row per term the domain defines.",
+        "",
+        "| Term | Definition |",
+        "|------|------------|",
+        "| TODO | TODO — define the domain's core terms. |",
+        "",
+    ].join("\n"));
+}
+function renderDomainDataModel(input) {
+    const title = titleize(input.name);
+    return ([
+        `# ${title} Domain — Data Model`,
+        "",
+        "> Entity-relationship diagram for this domain (ADR 0142 — first-class catalogue entity).",
+        "",
+        "```mermaid",
+        "erDiagram",
+        "    %% TODO: model this domain's entities and relationships",
+        "    ENTITY {",
+        "        string id",
+        "    }",
+        "```",
+        "",
+    ].join("\n"));
+}
+function renderIntegrationArchetype() {
+    return ([
+        "# Integration Interaction Patterns",
+        "",
+        "> Seeded by the `integration` domain archetype (sdd-method#0173). The interaction",
+        "> pattern is the adopter-agnostic, EIP-anchored data-flow axis (sdd-method#0171),",
+        "> orthogonal to provider category (`profileType`, sdd-method#0137).",
+        "",
+        "## Ingestion (inbound)",
+        "",
+        "| Pattern | Meaning |",
+        "|---------|---------|",
+        "| `event-stream-consume` | Subscribe to / drain a provider-hosted broker, stream or feed. |",
+        "| `webhook` | Expose an endpoint the provider pushes events to. |",
+        "| `socket-listen` | Accept connection-oriented sessions and read framed data. |",
+        "| `poll` | Request the provider on a schedule. |",
+        "",
+        "## Invocation (outbound)",
+        "",
+        "| Pattern | Meaning |",
+        "|---------|---------|",
+        "| `request-response` | Synchronous call-and-wait. |",
+        "| `async-request` | Submit; result returns later via a separate channel, correlated. |",
+        "| `publish` | Fire-and-forget write to a broker. |",
+        "",
+        "## Adopter framework roles",
+        "",
+        "If your platform runs an integration/component framework, map its component roles",
+        "onto these patterns **here** (sdd-method#0171 §9.5) — the method stays role-name-neutral.",
+        "",
+        "| Your role | Ingestion / Invocation pattern |",
+        "|-----------|-------------------------------|",
+        "| TODO | TODO |",
+        "",
+    ].join("\n"));
+}
+async function writeFileAt(path, content) {
+    await mkdir(dirname(path), { recursive: true });
+    await writeFile(path, content, "utf8");
+}
+//# sourceMappingURL=domain.js.map

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

@@ -0,0 +1 @@
+{"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,