@sdd-method/sdd-cli 0.22.0 → 0.23.0

package/dist/lib/pack/leakage.d.ts

@@ -0,0 +1,55 @@
+import type { PackSeed } from "./seed.js";
+/**
+ * Producer-side leakage check. Asserts the pack's managed_paths are
+ * disjoint from the declared forward base's managed_paths, AND that
+ * no managed_paths entry matches any forbidden_paths glob.
+ *
+ * Per ADR 0151 §4.1 + adopter-bundle-leakage-guide.md.
+ *
+ * Resolves the forward base's MANAGED_PATHS.txt from the producer's
+ * local method-baseline.lock (the producer is itself an sdd-method
+ * adopter and has the forward base synced into its docs/ tree).
+ *
+ * Fallback: if the producer has not synced the declared forward base,
+ * accept a path to the forward base's MANAGED_PATHS.txt directly via
+ * `forwardBaseManagedPathsFile` for offline / test scenarios.
+ */
+export interface LeakageCheckOptions {
+    seed: PackSeed;
+    /**
+     * Path to MANAGED_PATHS.txt of the forward base bundle the pack
+     * declares it layers over. Required when the producer hasn't
+     * synced the forward base into the current repo.
+     */
+    forwardBaseManagedPathsFile?: string;
+    /**
+     * Producer's repo root. The check tries to discover the forward
+     * base's managed paths from `<targetRepo>/method-baseline.lock` if
+     * the explicit file isn't provided.
+     */
+    producerRepo?: string;
+}
+export interface LeakageViolation {
+    path: string;
+    /** "forward-base" or "forbidden-pattern" */
+    conflictWith: string;
+    /** human-readable identifier of the conflicting source */
+    conflictSource: string;
+}
+export interface LeakageResult {
+    ok: boolean;
+    violations: LeakageViolation[];
+}
+export declare function checkLeakage(opts: LeakageCheckOptions): Promise<LeakageResult>;
+/**
+ * Extract managed_paths for the named bundle from a method-baseline.lock
+ * file. Minimal parser — the lock file is line-oriented YAML and we
+ * only need a single nested list per named bundle.
+ */
+export declare function extractManagedPathsForBundle(lockYaml: string, bundleName: string): string[];
+/**
+ * Simple glob matcher supporting `*` (any non-slash chars) and `**`
+ * (any chars including slashes). Used for forbidden_paths.
+ */
+export declare function matchesGlob(path: string, pattern: string): boolean;
+//# sourceMappingURL=leakage.d.ts.map

package/dist/lib/pack/leakage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"leakage.d.ts","sourceRoot":"","sources":["../../../src/lib/pack/leakage.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE1C;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,QAAQ,CAAC;IACf;;;;OAIG;IACH,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,YAAY,EAAE,MAAM,CAAC;IACrB,0DAA0D;IAC1D,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,OAAO,CAAC;IACZ,UAAU,EAAE,gBAAgB,EAAE,CAAC;CAChC;AAED,wBAAsB,YAAY,CAChC,IAAI,EAAE,mBAAmB,GACxB,OAAO,CAAC,aAAa,CAAC,CAgCxB;AAkCD;;;;GAIG;AACH,wBAAgB,4BAA4B,CAC1C,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,GACjB,MAAM,EAAE,CAsCV;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAGlE"}

package/dist/lib/pack/leakage.js

@@ -0,0 +1,133 @@
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+export async function checkLeakage(opts) {
+    const violations = [];
+    // 1. Disjointness with declared forward base.
+    const forwardBasePaths = await loadForwardBaseManagedPaths(opts);
+    const forwardBaseSet = new Set(forwardBasePaths);
+    for (const p of opts.seed.managedPaths) {
+        if (forwardBaseSet.has(p)) {
+            violations.push({
+                path: p,
+                conflictWith: "forward-base",
+                conflictSource: opts.seed.forwardBase.bundle,
+            });
+        }
+    }
+    // 2. Disjointness with declared forbidden_paths globs (seed self-contract).
+    if (opts.seed.forbiddenPaths) {
+        for (const p of opts.seed.managedPaths) {
+            for (const pattern of opts.seed.forbiddenPaths) {
+                if (matchesGlob(p, pattern)) {
+                    violations.push({
+                        path: p,
+                        conflictWith: "forbidden-pattern",
+                        conflictSource: pattern,
+                    });
+                }
+            }
+        }
+    }
+    return { ok: violations.length === 0, violations };
+}
+async function loadForwardBaseManagedPaths(opts) {
+    if (opts.forwardBaseManagedPathsFile) {
+        const raw = await readFile(opts.forwardBaseManagedPathsFile, "utf8");
+        return raw
+            .split("\n")
+            .map((l) => l.trim())
+            .filter((l) => l.length > 0 && !l.startsWith("#"));
+    }
+    if (opts.producerRepo) {
+        const lockPath = join(opts.producerRepo, "method-baseline.lock");
+        try {
+            const raw = await readFile(lockPath, "utf8");
+            return extractManagedPathsForBundle(raw, opts.seed.forwardBase.bundle);
+        }
+        catch (err) {
+            throw new Error(`Cannot read forward-base managed_paths: ${lockPath} unreadable ` +
+                `(${err.message}). Pass --forward-base-managed-paths ` +
+                `to provide MANAGED_PATHS.txt directly.`);
+        }
+    }
+    throw new Error("Cannot resolve forward-base managed_paths: provide either " +
+        "--producer-repo (with method-baseline.lock present) or " +
+        "--forward-base-managed-paths (path to MANAGED_PATHS.txt).");
+}
+/**
+ * Extract managed_paths for the named bundle from a method-baseline.lock
+ * file. Minimal parser — the lock file is line-oriented YAML and we
+ * only need a single nested list per named bundle.
+ */
+export function extractManagedPathsForBundle(lockYaml, bundleName) {
+    const lines = lockYaml.split("\n");
+    let inBundles = false;
+    let inTargetBundle = false;
+    let inManagedPaths = false;
+    const paths = [];
+    for (const line of lines) {
+        if (line.startsWith("bundles:")) {
+            inBundles = true;
+            continue;
+        }
+        if (!inBundles)
+            continue;
+        if (/^\s*-\s*name:\s*(.+)$/.test(line)) {
+            const m = /^\s*-\s*name:\s*(.+)$/.exec(line);
+            inTargetBundle = m !== null && m[1]?.trim() === bundleName;
+            inManagedPaths = false;
+            continue;
+        }
+        if (inTargetBundle && /^\s+managed_paths:\s*$/.test(line)) {
+            inManagedPaths = true;
+            continue;
+        }
+        if (inManagedPaths) {
+            const m = /^\s+-\s+(.+)$/.exec(line);
+            if (m && m[1]) {
+                paths.push(m[1].trim());
+            }
+            else if (/^\s+\w+:/.test(line) || /^\s*-\s*name:/.test(line)) {
+                // End of managed_paths list (either next field or next bundle)
+                inManagedPaths = false;
+            }
+        }
+    }
+    return paths;
+}
+/**
+ * Simple glob matcher supporting `*` (any non-slash chars) and `**`
+ * (any chars including slashes). Used for forbidden_paths.
+ */
+export function matchesGlob(path, pattern) {
+    const re = globToRegex(pattern);
+    return re.test(path);
+}
+function globToRegex(pattern) {
+    // Escape regex metachars except *, then translate * and **.
+    let regex = "";
+    let i = 0;
+    while (i < pattern.length) {
+        const ch = pattern[i];
+        if (ch === "*") {
+            if (pattern[i + 1] === "*") {
+                regex += ".*";
+                i += 2;
+            }
+            else {
+                regex += "[^/]*";
+                i += 1;
+            }
+        }
+        else if (/[.+?^${}()|[\]\\]/.test(ch)) {
+            regex += `\\${ch}`;
+            i += 1;
+        }
+        else {
+            regex += ch;
+            i += 1;
+        }
+    }
+    return new RegExp(`^${regex}$`);
+}
+//# sourceMappingURL=leakage.js.map

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

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

package/dist/lib/pack/schema.d.ts

@@ -0,0 +1,36 @@
+import { z } from "zod";
+import type { PackSeed } from "./seed.js";
+export declare const PackSeedSchema: z.ZodObject<{
+    version: z.ZodString;
+    scope: z.ZodString;
+    forwardBase: z.ZodObject<{
+        bundle: z.ZodEnum<{
+            "platform-baseline": "platform-baseline";
+            "app-baseline": "app-baseline";
+            "integration-baseline": "integration-baseline";
+            "reverse-baseline": "reverse-baseline";
+        }>;
+        minimumVersion: z.ZodString;
+        sourceRepo: z.ZodString;
+    }, z.core.$strip>;
+    minimumSddCliVersion: z.ZodString;
+    description: z.ZodString;
+    include: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    managedPaths: z.ZodArray<z.ZodString>;
+    forbiddenPaths: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    requiresPack: z.ZodOptional<z.ZodObject<{
+        name: z.ZodString;
+        version: z.ZodString;
+    }, z.core.$strip>>;
+    sourcePath: z.ZodString;
+}, z.core.$strip>;
+export interface ValidationError {
+    field: string;
+    message: string;
+}
+export interface ValidationResult {
+    ok: boolean;
+    errors: ValidationError[];
+}
+export declare function validateSeed(seed: PackSeed): ValidationResult;
+//# sourceMappingURL=schema.d.ts.map

package/dist/lib/pack/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/lib/pack/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAsB1C,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;iBAmCzB,CAAC;AAEH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,eAAe,EAAE,CAAC;CAC3B;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,gBAAgB,CAU7D"}

package/dist/lib/pack/schema.js

@@ -0,0 +1,63 @@
+import { z } from "zod";
+/**
+ * Zod schema for adopter pack seeds. Mirrors
+ * docs/method/foundations/schemas/context-pack-seed-schema.yaml.
+ *
+ * Used by `sdd-cli pack validate` for fast feedback during authoring.
+ * The structural parse in seed.ts already enforces presence of required
+ * fields; this schema layer adds value-shape checks (semver patterns,
+ * known forward-base bundle names, non-empty managed_paths).
+ */
+const SEMVER_PATTERN = /^\d+\.\d+\.\d+$/;
+const VERSIONED_RANGE_PATTERN = /^(\^|~|>=)?v?\d+\.\d+\.\d+$/;
+const KNOWN_FORWARD_BASES = [
+    "app-baseline",
+    "integration-baseline",
+    "platform-baseline",
+    "reverse-baseline",
+];
+export const PackSeedSchema = z.object({
+    version: z
+        .string()
+        .regex(SEMVER_PATTERN, "version must be semver (X.Y.Z)"),
+    scope: z
+        .string()
+        .regex(/^[a-z0-9-]+$/, "scope must be lower-kebab-case slug"),
+    forwardBase: z.object({
+        bundle: z.enum(KNOWN_FORWARD_BASES),
+        minimumVersion: z
+            .string()
+            .regex(/^v\d+\.\d+\.\d+$/, "forward_base.minimum_version must be vX.Y.Z"),
+        sourceRepo: z.string().min(1),
+    }),
+    minimumSddCliVersion: z
+        .string()
+        .regex(SEMVER_PATTERN, "minimum_sdd_cli_version must be semver (X.Y.Z)"),
+    description: z.string().min(1),
+    include: z.array(z.string()).optional(),
+    managedPaths: z
+        .array(z.string().min(1))
+        .min(1, "managed_paths must have at least one entry"),
+    forbiddenPaths: z.array(z.string()).optional(),
+    requiresPack: z
+        .object({
+        name: z.string().min(1),
+        version: z
+            .string()
+            .regex(VERSIONED_RANGE_PATTERN, "requires_pack.version must be a semver range (e.g. ^v1.2.0)"),
+    })
+        .optional(),
+    sourcePath: z.string(),
+});
+export function validateSeed(seed) {
+    const result = PackSeedSchema.safeParse(seed);
+    if (result.success) {
+        return { ok: true, errors: [] };
+    }
+    const errors = result.error.issues.map((issue) => ({
+        field: issue.path.join("."),
+        message: issue.message,
+    }));
+    return { ok: false, errors };
+}
+//# sourceMappingURL=schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../src/lib/pack/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;GAQG;AAEH,MAAM,cAAc,GAAG,iBAAiB,CAAC;AACzC,MAAM,uBAAuB,GAAG,6BAA6B,CAAC;AAE9D,MAAM,mBAAmB,GAAG;IAC1B,cAAc;IACd,sBAAsB;IACtB,mBAAmB;IACnB,kBAAkB;CACV,CAAC;AAEX,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,KAAK,CAAC,cAAc,EAAE,gCAAgC,CAAC;IAC1D,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,KAAK,CAAC,cAAc,EAAE,qCAAqC,CAAC;IAC/D,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC;QACnC,cAAc,EAAE,CAAC;aACd,MAAM,EAAE;aACR,KAAK,CAAC,kBAAkB,EAAE,6CAA6C,CAAC;QAC3E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;KAC9B,CAAC;IACF,oBAAoB,EAAE,CAAC;SACpB,MAAM,EAAE;SACR,KAAK,CAAC,cAAc,EAAE,gDAAgD,CAAC;IAC1E,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACvC,YAAY,EAAE,CAAC;SACZ,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;SACxB,GAAG,CAAC,CAAC,EAAE,4CAA4C,CAAC;IACvD,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC9C,YAAY,EAAE,CAAC;SACZ,MAAM,CAAC;QACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QACvB,OAAO,EAAE,CAAC;aACP,MAAM,EAAE;aACR,KAAK,CACJ,uBAAuB,EACvB,6DAA6D,CAC9D;KACJ,CAAC;SACD,QAAQ,EAAE;IACb,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;CACvB,CAAC,CAAC;AAYH,MAAM,UAAU,YAAY,CAAC,IAAc;IACzC,MAAM,MAAM,GAAG,cAAc,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9C,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAClC,CAAC;IACD,MAAM,MAAM,GAAsB,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACpE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC;QAC3B,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC,CAAC,CAAC;IACJ,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC/B,CAAC"}

package/dist/lib/pack/seed.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Adopter pack seed file. Per ADR 0151 + context-pack-seed-schema.yaml.
+ *
+ * Loaded by `sdd-cli pack build` and `sdd-cli pack validate` from
+ * `orchestration/distribution/{pack-name}-seed.yaml` in adopter repos.
+ *
+ * Includes are resolved before validation: the merged seed presents
+ * all `include`'d managed_paths + forbidden_paths concatenated with
+ * the host seed's own.
+ */
+export interface PackSeed {
+    version: string;
+    scope: string;
+    forwardBase: ForwardBaseRef;
+    minimumSddCliVersion: string;
+    description: string;
+    include?: string[];
+    managedPaths: string[];
+    forbiddenPaths?: string[];
+    requiresPack?: PackRef;
+    /**
+     * Absolute path to the seed file this was loaded from. Used by the
+     * builder to anchor relative payload-source paths.
+     */
+    sourcePath: string;
+}
+export interface ForwardBaseRef {
+    bundle: string;
+    minimumVersion: string;
+    sourceRepo: string;
+}
+export interface PackRef {
+    name: string;
+    version: string;
+}
+/**
+ * Load a seed file from disk, resolve its `include:` directives,
+ * and return a merged PackSeed. Throws if any include cannot be read
+ * or if circular includes are detected.
+ *
+ * NOTE: This does not validate the seed structure — only parses YAML
+ * and assembles the typed shape. Use `validateSeed` (separate module)
+ * for schema enforcement.
+ */
+export declare function loadSeed(seedPath: string): Promise<PackSeed>;
+//# sourceMappingURL=seed.d.ts.map

package/dist/lib/pack/seed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../../../src/lib/pack/seed.ts"],"names":[],"mappings":"AAIA;;;;;;;;;GASG;AACH,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,cAAc,CAAC;IAC5B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAqBD;;;;;;;;GAQG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAIlE"}

package/dist/lib/pack/seed.js

@@ -0,0 +1,107 @@
+import { readFile } from "node:fs/promises";
+import { dirname, isAbsolute, resolve } from "node:path";
+import { parse as parseYaml } from "yaml";
+/**
+ * Load a seed file from disk, resolve its `include:` directives,
+ * and return a merged PackSeed. Throws if any include cannot be read
+ * or if circular includes are detected.
+ *
+ * NOTE: This does not validate the seed structure — only parses YAML
+ * and assembles the typed shape. Use `validateSeed` (separate module)
+ * for schema enforcement.
+ */
+export async function loadSeed(seedPath) {
+    const absPath = isAbsolute(seedPath) ? seedPath : resolve(seedPath);
+    const visited = new Set();
+    return loadSeedRecursive(absPath, visited);
+}
+async function loadSeedRecursive(absPath, visited) {
+    if (visited.has(absPath)) {
+        throw new Error(`Circular include detected at ${absPath}`);
+    }
+    visited.add(absPath);
+    let raw;
+    try {
+        raw = await readFile(absPath, "utf8");
+    }
+    catch (err) {
+        throw new Error(`Cannot read seed file ${absPath}: ${err.message}`);
+    }
+    const parsed = parseYaml(raw);
+    if (parsed === null || typeof parsed !== "object") {
+        throw new Error(`Seed file ${absPath} is not a YAML object`);
+    }
+    const baseDir = dirname(absPath);
+    const includes = Array.isArray(parsed.include) ? parsed.include : [];
+    const includedManaged = [];
+    const includedForbidden = [];
+    for (const inc of includes) {
+        if (typeof inc !== "string") {
+            throw new Error(`Non-string include entry in ${absPath}: ${String(inc)}`);
+        }
+        const incPath = isAbsolute(inc) ? inc : resolve(baseDir, inc);
+        const includedSeed = await loadSeedRecursive(incPath, visited);
+        includedManaged.push(...includedSeed.managedPaths);
+        if (includedSeed.forbiddenPaths) {
+            includedForbidden.push(...includedSeed.forbiddenPaths);
+        }
+    }
+    const own = parsed;
+    const managedPaths = [
+        ...includedManaged,
+        ...asStringArray(own.managed_paths, "managed_paths", absPath),
+    ];
+    const forbiddenPaths = includedForbidden.length > 0 || Array.isArray(own.forbidden_paths)
+        ? [
+            ...includedForbidden,
+            ...asStringArray(own.forbidden_paths, "forbidden_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",
+        },
+        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 }),
+        ...(own.requires_pack && {
+            requiresPack: {
+                name: asString(own.requires_pack.name, "requires_pack.name", absPath),
+                version: asString(own.requires_pack.version, "requires_pack.version", absPath),
+            },
+        }),
+    };
+    return seed;
+}
+function asString(value, field, file) {
+    if (typeof value !== "string" || value.length === 0) {
+        throw new Error(`Seed field "${field}" must be a non-empty string in ${file}`);
+    }
+    return value;
+}
+function asStringArray(value, field, file, allowEmpty = false) {
+    if (value === undefined || value === null) {
+        if (allowEmpty)
+            return [];
+        throw new Error(`Seed field "${field}" is required in ${file}`);
+    }
+    if (!Array.isArray(value)) {
+        throw new Error(`Seed field "${field}" must be a list in ${file}`);
+    }
+    for (const entry of value) {
+        if (typeof entry !== "string") {
+            throw new Error(`Seed field "${field}" entries must be strings in ${file}`);
+        }
+    }
+    return value;
+}
+//# sourceMappingURL=seed.js.map

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

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

package/dist/lib/repo-kind.d.ts

@@ -13,16 +13,20 @@ export declare function profileFromRepoKind(kind: RepoKind): Profile;
 export declare function repoKindFromProfile(profile: Profile): RepoKind;
 /**
  * Returns the profile a bundle authoritatively claims, or null for
- * additive bundles that don't claim a profile of their own.
+ * additive bundles that don't claim a profile of their own. Accepts
+ * arbitrary strings (adopter pack names per ADR 0151) and returns null
+ * for any name not in the closed sdd-method bundle set.
  */
-export declare function profileFromBundleName(name: BundleName): Profile | null;
+export declare function profileFromBundleName(name: string): Profile | null;
 export declare function bundleNameFromProfile(profile: Profile): BundleName;
 /**
  * Forward-base bundles set `.sdd-repo-kind` and qualify as the base
  * layer that additive extensions compose on top of. Additive bundles
- * (e.g. `reverse-extension-baseline`) return false.
+ * (sdd-method's `reverse-extension-baseline` and ADR 0151 adopter
+ * packs) return false. Accepts arbitrary strings; unknown names return
+ * false.
  */
-export declare function isForwardBase(name: BundleName): boolean;
+export declare function isForwardBase(name: string): boolean;
 /**
  * Maps repo-kind → forward-base bundle name. Used when migrating a
  * legacy v1 lock file (which doesn't record bundle name) to v2.

package/dist/lib/repo-kind.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"repo-kind.d.ts","sourceRoot":"","sources":["../../src/lib/repo-kind.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,aAAa,GAAG,aAAa,GAAG,SAAS,CAAC;AAE7E,MAAM,MAAM,QAAQ,GAChB,kBAAkB,GAClB,qBAAqB,GACrB,qBAAqB,GACrB,gBAAgB,CAAC;AAErB,MAAM,MAAM,UAAU,GAClB,mBAAmB,GACnB,cAAc,GACd,sBAAsB,GACtB,kBAAkB,GAClB,4BAA4B,CAAC;AAgBjC,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAC/C;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAmC7D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAE3D;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,CAE9D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,GAAG,IAAI,CAEtE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAElE;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAEvD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,CAEjE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,QAAQ,CAE3D;AAUD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,UAAU,CAE/D;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAoB7E;AAED,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,QAAQ,GACb,OAAO,CAAC,IAAI,CAAC,CAEf"}
+{"version":3,"file":"repo-kind.d.ts","sourceRoot":"","sources":["../../src/lib/repo-kind.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,aAAa,GAAG,aAAa,GAAG,SAAS,CAAC;AAE7E,MAAM,MAAM,QAAQ,GAChB,kBAAkB,GAClB,qBAAqB,GACrB,qBAAqB,GACrB,gBAAgB,CAAC;AAErB,MAAM,MAAM,UAAU,GAClB,mBAAmB,GACnB,cAAc,GACd,sBAAsB,GACtB,kBAAkB,GAClB,4BAA4B,CAAC;AAgBjC,eAAO,MAAM,cAAc,mBAAmB,CAAC;AAC/C;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,0BAA0B,CAAC;AAmC7D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAE3D;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,CAE9D;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAGlE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAElE;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGnD;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,QAAQ,GAAG,UAAU,CAEjE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,QAAQ,CAE3D;AAUD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,UAAU,CAE/D;AAED,wBAAsB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAoB7E;AAED,wBAAsB,aAAa,CACjC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,QAAQ,GACb,OAAO,CAAC,IAAI,CAAC,CAEf"}

package/dist/lib/repo-kind.js

@@ -58,9 +58,13 @@ export function repoKindFromProfile(profile) {
 }
 /**
  * Returns the profile a bundle authoritatively claims, or null for
- * additive bundles that don't claim a profile of their own.
+ * additive bundles that don't claim a profile of their own. Accepts
+ * arbitrary strings (adopter pack names per ADR 0151) and returns null
+ * for any name not in the closed sdd-method bundle set.
  */
 export function profileFromBundleName(name) {
+    if (!isBundleName(name))
+        return null;
     return PROFILE_BY_BUNDLE_NAME[name] ?? null;
 }
 export function bundleNameFromProfile(profile) {
@@ -69,9 +73,13 @@ export function bundleNameFromProfile(profile) {
 /**
  * Forward-base bundles set `.sdd-repo-kind` and qualify as the base
  * layer that additive extensions compose on top of. Additive bundles
- * (e.g. `reverse-extension-baseline`) return false.
+ * (sdd-method's `reverse-extension-baseline` and ADR 0151 adopter
+ * packs) return false. Accepts arbitrary strings; unknown names return
+ * false.
  */
 export function isForwardBase(name) {
+    if (!isBundleName(name))
+        return false;
     return FORWARD_BASE_BUNDLES.has(name);
 }
 /**

package/dist/lib/repo-kind.js.map

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

package/dist/lib/sync/config.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Multi-bundle sync config file. Per ADR 0151 + companion plan Phase 3b.
+ *
+ * Lives at `method-baseline.config.yaml` (or any path passed via
+ * `sdd-cli sync --config <path>`). Declares an ordered list of bundle
+ * sources to sync in sequence.
+ *
+ * Shape:
+ *
+ * ```yaml
+ * version: "1.0"
+ * bundles:
+ *   - source: "./dist/method-baseline/method-baseline-v0.9.0.tar.gz"
+ *   - source: "./dist/contextua-app-context-pack/contextua-app-context-pack-v0.1.0.tar.gz"
+ * ```
+ *
+ * `source` may be:
+ *   - Absolute path
+ *   - Path relative to the config file's directory
+ *
+ * Remote URL support is reserved for a future minor (consumers fetch
+ * to a temp file and pass the local path on for now).
+ */
+export interface SyncConfig {
+    version: string;
+    bundles: SyncConfigBundle[];
+}
+export interface SyncConfigBundle {
+    /** Resolved absolute path to the tarball. */
+    source: string;
+}
+export declare function loadSyncConfig(configPath: string): Promise<SyncConfig>;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/lib/sync/config.ts"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,gBAAgB,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;CAChB;AAWD,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CA2C5E"}

package/dist/lib/sync/config.js

@@ -0,0 +1,40 @@
+import { readFile } from "node:fs/promises";
+import { dirname, isAbsolute, resolve } from "node:path";
+import { parse as parseYaml } from "yaml";
+export async function loadSyncConfig(configPath) {
+    const absPath = isAbsolute(configPath) ? configPath : resolve(configPath);
+    let raw;
+    try {
+        raw = await readFile(absPath, "utf8");
+    }
+    catch (err) {
+        throw new Error(`Cannot read sync config ${absPath}: ${err.message}`);
+    }
+    const parsed = parseYaml(raw);
+    if (parsed === null || typeof parsed !== "object") {
+        throw new Error(`Sync config ${absPath} is not a YAML object`);
+    }
+    const version = typeof parsed.version === "string" ? parsed.version : undefined;
+    if (!version) {
+        throw new Error(`Sync config ${absPath} missing required field: version`);
+    }
+    if (!Array.isArray(parsed.bundles)) {
+        throw new Error(`Sync config ${absPath} field "bundles" must be a list`);
+    }
+    if (parsed.bundles.length === 0) {
+        throw new Error(`Sync config ${absPath} field "bundles" must not be empty`);
+    }
+    const configDir = dirname(absPath);
+    const bundles = [];
+    for (const [i, entry] of parsed.bundles.entries()) {
+        const raw = entry;
+        const src = typeof raw.source === "string" ? raw.source : undefined;
+        if (!src) {
+            throw new Error(`Sync config ${absPath} bundles[${i}] missing required field: source`);
+        }
+        const resolved = isAbsolute(src) ? src : resolve(configDir, src);
+        bundles.push({ source: resolved });
+    }
+    return { version, bundles };
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/sync/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/lib/sync/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACzD,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AA4C1C,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,UAAkB;IACrD,MAAM,OAAO,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC1E,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IACxC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,2BAA2B,OAAO,KAAM,GAAa,CAAC,OAAO,EAAE,CAChE,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAAc,CAAC;IAC3C,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,eAAe,OAAO,uBAAuB,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,OAAO,GACX,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAClE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,eAAe,OAAO,kCAAkC,CAAC,CAAC;IAC5E,CAAC;IAED,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CAAC,eAAe,OAAO,iCAAiC,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,KAAK,CAAC,eAAe,OAAO,oCAAoC,CAAC,CAAC;IAC9E,CAAC;IAED,MAAM,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnC,MAAM,OAAO,GAAuB,EAAE,CAAC;IACvC,KAAK,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QAClD,MAAM,GAAG,GAAG,KAAkB,CAAC;QAC/B,MAAM,GAAG,GAAG,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;QACpE,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,MAAM,IAAI,KAAK,CACb,eAAe,OAAO,YAAY,CAAC,kCAAkC,CACtE,CAAC;QACJ,CAAC;QACD,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;QACjE,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC;IACrC,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC9B,CAAC"}