@sdd-method/sdd-cli 0.9.0 → 0.11.0

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAcA,wBAAsB,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAahE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAeA,wBAAsB,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAahE"}

package/dist/index.js

@@ -1,4 +1,5 @@
 import { Command, CommanderError } from "commander";
+import { registerCatalogue } from "./verbs/catalogue.js";
 import { registerGenerateClaudeMd } from "./verbs/generate-claude-md.js";
 import { registerInit } from "./verbs/init.js";
 import { registerList } from "./verbs/list.js";
@@ -28,7 +29,7 @@ function buildProgram() {
     program
         .name("sdd-cli")
         .description("Method-layer CLI for SDD repository lifecycle — init, sync, validate, list, plan, generate-claude-md.")
-        .version("0.9.0", "-v, --version")
+        .version("0.11.0", "-v, --version")
         .addHelpText("after", `\nSpec: ${SPEC_URL}`)
         .exitOverride()
         .configureOutput({
@@ -42,6 +43,7 @@ function buildProgram() {
     registerPlan(program);
     registerGenerateClaudeMd(program);
     registerMcp(program);
+    registerCatalogue(program);
     for (const { verb, summary } of NOT_YET_IMPLEMENTED) {
         registerNotYetImplemented(program, verb, summary);
     }

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAEvD,MAAM,QAAQ,GACZ,8FAA8F,CAAC;AAEjG,MAAM,mBAAmB,GAAqD,EAAE,CAAC;AAEjF,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAuB;IAC/C,MAAM,OAAO,GAAG,YAAY,EAAE,CAAC;IAE/B,IAAI,CAAC;QACH,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtB,OAAO,CAAC,UAAU,EAAE,CAAC;YACrB,OAAO;QACT,CAAC;QACD,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IACxD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,uBAAuB,CAAC,GAAG,CAAC;YAAE,OAAO;QACzC,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,YAAY;IACnB,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,SAAS,CAAC;SACf,WAAW,CACV,uGAAuG,CACxG;SACA,OAAO,CAAC,OAAO,EAAE,eAAe,CAAC;SACjC,WAAW,CAAC,OAAO,EAAE,WAAW,QAAQ,EAAE,CAAC;SAC3C,YAAY,EAAE;SACd,eAAe,CAAC;QACf,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;QAC5C,QAAQ,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;KAC7C,CAAC,CAAC;IAEL,YAAY,CAAC,OAAO,CAAC,CAAC;IACtB,YAAY,CAAC,OAAO,CAAC,CAAC;IACtB,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAC1B,YAAY,CAAC,OAAO,CAAC,CAAC;IACtB,YAAY,CAAC,OAAO,CAAC,CAAC;IACtB,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAClC,WAAW,CAAC,OAAO,CAAC,CAAC;IACrB,KAAK,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,mBAAmB,EAAE,CAAC;QACpD,yBAAyB,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACpD,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,yBAAyB,CAChC,OAAgB,EAChB,IAAY,EACZ,OAAe;IAEf,OAAO;SACJ,OAAO,CAAC,IAAI,CAAC;SACb,WAAW,CAAC,GAAG,OAAO,uBAAuB,CAAC;SAC9C,kBAAkB,EAAE;SACpB,MAAM,CAAC,GAAG,EAAE;QACX,MAAM,IAAI,KAAK,CACb,SAAS,IAAI,iCAAiC,QAAQ,8BAA8B,CACrF,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC;AAED,SAAS,uBAAuB,CAAC,GAAY;IAC3C,IAAI,CAAC,CAAC,GAAG,YAAY,cAAc,CAAC;QAAE,OAAO,KAAK,CAAC;IACnD,OAAO,CACL,GAAG,CAAC,IAAI,KAAK,gBAAgB;QAC7B,GAAG,CAAC,IAAI,KAAK,yBAAyB;QACtC,GAAG,CAAC,IAAI,KAAK,mBAAmB,CACjC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/lib/catalogue/aggregate.d.ts

@@ -0,0 +1,39 @@
+import { type CatalogueDef } from "./schema-loader.js";
+import { parseCatalogueCsv } from "./csv-reader.js";
+import { type CatalogueRow } from "./csv-writer.js";
+export interface AggregateInputs {
+    /** Path to the ecosystem-root SDD repo (defaults to cwd). */
+    readonly sddPath?: string;
+    /**
+     * Path to the aggregation manifest. Resolution order:
+     *   1. explicit option
+     *   2. ecosystem-root manifest's `aggregation_manifest_path`
+     *   3. orchestration/aggregation-manifest.yaml
+     */
+    readonly manifestPath?: string;
+    /** Output directory. Defaults to <sddPath>/catalogues-aggregated. */
+    readonly outDir?: string;
+    /** Treat any finding as a failure (non-zero exit). */
+    readonly strict?: boolean;
+}
+export interface AggregateResult {
+    readonly exitCode: number;
+    readonly schemaVersion: string;
+    readonly ecosystemRoot: string;
+    readonly siblingCount: number;
+    readonly rowCounts: ReadonlyMap<string, number>;
+    /** Pre-merge per-sibling counts — for the JSON manifest output. */
+    readonly perSiblingCounts: ReadonlyMap<string, ReadonlyMap<string, number>>;
+    readonly aggregatedFkPass: boolean;
+    readonly findingsCount: number;
+    readonly outDir: string;
+}
+export type Writer = (s: string) => void;
+export declare function runCatalogueAggregate(inputs: AggregateInputs, write: Writer): Promise<AggregateResult>;
+declare function stampSourceSddId(catalogue: CatalogueDef, rows: readonly Record<string, string>[], sourceSddId: string): CatalogueRow[];
+export declare const __test_only__: {
+    stampSourceSddId: typeof stampSourceSddId;
+    parseCatalogueCsv: typeof parseCatalogueCsv;
+};
+export {};
+//# sourceMappingURL=aggregate.d.ts.map

package/dist/lib/catalogue/aggregate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate.d.ts","sourceRoot":"","sources":["../../../src/lib/catalogue/aggregate.ts"],"names":[],"mappings":"AA8BA,OAAO,EAA6C,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClG,OAAO,EAAoB,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACtE,OAAO,EAAkB,KAAK,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAIpE,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,qEAAqE;IACrE,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,sDAAsD;IACtD,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,mEAAmE;IACnE,QAAQ,CAAC,gBAAgB,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5E,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;AAEzC,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,eAAe,EACvB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,eAAe,CAAC,CAoK1B;AAiFD,iBAAS,gBAAgB,CACvB,SAAS,EAAE,YAAY,EACvB,IAAI,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,EACvC,WAAW,EAAE,MAAM,GAClB,YAAY,EAAE,CAUhB;AA6KD,eAAO,MAAM,aAAa;;;CAA0C,CAAC"}

package/dist/lib/catalogue/aggregate.js

@@ -0,0 +1,344 @@
+// Catalogue aggregator — `sdd-cli catalogue aggregate`.
+//
+// Implements the 8-step contract in
+// docs/method/methods/catalogue-builder-specification.md
+// §"Aggregator contract":
+//
+//   1. Discover sibling SDDs via aggregation-manifest.yaml.
+//   2. Pull each sibling's catalogues/ (filesystem only in v1).
+//   3. Verify schema-version alignment across SDDs.
+//   4. Concatenate per-catalogue rows.
+//   5. Stamp source_sdd_id on every node-catalogue row.
+//   6. Fail on duplicate primary keys.
+//   7. Run full FK validation including external references.
+//   8. Emit catalogues/ + aggregation-manifest.json.
+//
+// The ecosystem-root SDD itself contributes its own catalogues to the
+// aggregation alongside the siblings — it doesn't list itself in the
+// manifest. That's how single-SDD ecosystems and federated ecosystems
+// share the same code path: with zero siblings the aggregator just
+// re-emits the ecosystem-root's catalogues stamped with source_sdd_id.
+import { readFile, stat, writeFile } from "node:fs/promises";
+import { join, relative, resolve } from "node:path";
+import { CLI_VERSION } from "./cli-version.js";
+import { loadAggregationManifest, DEFAULT_AGGREGATION_MANIFEST_REL, } from "./aggregation-manifest-loader.js";
+import { loadSddManifest } from "./manifest-loader.js";
+import { loadCanonicalSchema } from "./schema-loader.js";
+import { readCatalogueCsv, parseCatalogueCsv } from "./csv-reader.js";
+import { writeCatalogue } from "./csv-writer.js";
+import { validateForeignKeys } from "./fk-validator.js";
+import { FindingsLog } from "./findings.js";
+export async function runCatalogueAggregate(inputs, write) {
+    const sddPath = resolve(inputs.sddPath ?? process.cwd());
+    const findings = new FindingsLog();
+    // 0. Load canonical schema.
+    const schema = await loadCanonicalSchema();
+    write(`sdd-cli catalogue aggregate (canonical schema ${schema.schemaVersion})\n`);
+    // 0a. Load ecosystem-root manifest.
+    const rootManifest = await loadSddManifest(sddPath, {
+        cliVersion: CLI_VERSION,
+    });
+    write(`  ecosystem-root: ${rootManifest.sddId}  profile: ${rootManifest.profile}\n`);
+    // 1. Resolve aggregation-manifest path + load.
+    const manifestPath = resolve(inputs.manifestPath ??
+        rootManifest.aggregationManifestPath ??
+        join(sddPath, DEFAULT_AGGREGATION_MANIFEST_REL));
+    const aggManifest = await loadAggregationManifest(manifestPath, {
+        cliVersion: CLI_VERSION,
+        ecosystemRootPath: sddPath,
+    });
+    if (aggManifest.ecosystemRoot !== rootManifest.sddId) {
+        throw new Error(`aggregation manifest ecosystem_root="${aggManifest.ecosystemRoot}"\n` +
+            `  does not match ecosystem-root SDD's sdd_id="${rootManifest.sddId}"\n` +
+            `  (manifest: ${manifestPath})`);
+    }
+    write(`  aggregation manifest: ${relative(sddPath, manifestPath)}\n`);
+    write(`  siblings: ${aggManifest.siblings.length}\n`);
+    // 2. Pull (filesystem only in v1) — pre-checked at manifest load. Now
+    //    cross-check each sibling's own .sdd/sdd-manifest.yaml + its
+    //    vendored schema vs the aggregator's.
+    await crossCheckSiblings(sddPath, aggManifest.siblings, schema, write);
+    // 3. Schema-version alignment was checked in crossCheckSiblings.
+    // 4 + 5. Concatenate per-catalogue rows from the ecosystem-root + every
+    // sibling, stamping source_sdd_id on node catalogues as we go.
+    const rowsByCatalogue = new Map();
+    const perSiblingCounts = new Map();
+    for (const cat of schema.catalogues) {
+        rowsByCatalogue.set(cat.name, []);
+    }
+    perSiblingCounts.set(rootManifest.sddId, await mergeCatalogues(schema, rowsByCatalogue, join(sddPath, "catalogues"), rootManifest.sddId));
+    for (const sib of aggManifest.siblings) {
+        perSiblingCounts.set(sib.sddId, await mergeCatalogues(schema, rowsByCatalogue, sib.cataloguesPath, sib.sddId));
+    }
+    // 6. Duplicate primary key check.
+    const duplicates = findDuplicatePrimaryKeys(schema, rowsByCatalogue);
+    if (duplicates.length > 0) {
+        write(`\nDuplicate primary keys (${duplicates.length}) — aggregation fails:\n`);
+        for (const d of duplicates) {
+            write(`  ${d.catalogue}.${d.primaryKey}="${d.value}" contributed by [${d.sources.join(", ")}]\n`);
+        }
+        return finalise({
+            schema,
+            ecosystemRoot: rootManifest.sddId,
+            aggManifest,
+            rowsByCatalogue,
+            perSiblingCounts,
+            aggregatedFkPass: false,
+            findings,
+            outDir: resolveOutDir(sddPath, inputs.outDir),
+            manifestPath,
+            writeOutputs: false,
+            duplicateCount: duplicates.length,
+            write,
+            strict: inputs.strict === true,
+        });
+    }
+    // 7. Full FK validation, treating external as internal.
+    const fk = validateForeignKeys(schema, rowsByCatalogue, findings, {
+        treatExternalAsInternal: true,
+    });
+    // 8. Emit aggregated catalogues + aggregation-manifest.json.
+    const outDir = resolveOutDir(sddPath, inputs.outDir);
+    const rowCounts = new Map();
+    for (const cat of schema.catalogues) {
+        const rows = rowsByCatalogue.get(cat.name) ?? [];
+        const result = await writeCatalogue({ outDir, catalogue: cat, rows });
+        rowCounts.set(cat.name, result.rowCount);
+    }
+    await writeAggregationManifestJson({
+        outDir,
+        schemaVersion: schema.schemaVersion,
+        ecosystemRoot: rootManifest.sddId,
+        siblings: aggManifest.siblings,
+        perSiblingCounts,
+        aggregatedRowCounts: rowCounts,
+        cliVersion: CLI_VERSION,
+    });
+    // Report.
+    write("\nAggregated row counts:\n");
+    for (const [name, count] of rowCounts) {
+        if (count > 0)
+            write(`  ${name}: ${count}\n`);
+    }
+    const emptyCount = [...rowCounts.values()].filter((c) => c === 0).length;
+    write(`  (${emptyCount} headers-only)\n`);
+    const findingsText = findings.render();
+    if (findingsText)
+        write(`\n${findingsText}\n`);
+    if (fk.internalPass) {
+        write(`\nAggregated FK validation: PASS\n`);
+    }
+    else {
+        write(`\nAggregated FK validation: FAIL (${fk.internalFailures.length} dangling)\n`);
+        for (const f of fk.internalFailures) {
+            const sourceSdd = findSourceSdd(rowsByCatalogue, f.catalogue, f.referencingRow);
+            write(`  ${f.catalogue}.${f.column}: row pk=${f.referencingRow} → ${f.target}=${f.value || "<empty>"}` +
+                (sourceSdd ? ` (from ${sourceSdd})\n` : "\n"));
+        }
+    }
+    const strictFail = inputs.strict === true && findings.count() > 0;
+    const exitCode = !fk.internalPass || strictFail ? 1 : 0;
+    return {
+        exitCode,
+        schemaVersion: schema.schemaVersion,
+        ecosystemRoot: rootManifest.sddId,
+        siblingCount: aggManifest.siblings.length,
+        rowCounts,
+        perSiblingCounts,
+        aggregatedFkPass: fk.internalPass,
+        findingsCount: findings.count(),
+        outDir,
+    };
+}
+function findDuplicatePrimaryKeys(schema, rowsByCatalogue) {
+    const out = [];
+    for (const cat of schema.catalogues) {
+        const rows = rowsByCatalogue.get(cat.name) ?? [];
+        const byKey = new Map();
+        for (const row of rows) {
+            const pk = row[cat.primaryKey];
+            if (pk === undefined || pk === null || pk === "")
+                continue;
+            const value = String(pk);
+            const sourceSdd = String(row["source_sdd_id"] ?? "");
+            const list = byKey.get(value) ?? [];
+            list.push(sourceSdd || "<unknown>");
+            byKey.set(value, list);
+        }
+        for (const [value, sources] of byKey) {
+            if (sources.length > 1) {
+                out.push({
+                    catalogue: cat.name,
+                    primaryKey: cat.primaryKey,
+                    value,
+                    sources,
+                });
+            }
+        }
+    }
+    return out;
+}
+async function mergeCatalogues(schema, rowsByCatalogue, cataloguesDir, sourceSddId) {
+    const counts = new Map();
+    let dirExists = true;
+    try {
+        const s = await stat(cataloguesDir);
+        if (!s.isDirectory())
+            dirExists = false;
+    }
+    catch (err) {
+        if (err.code === "ENOENT")
+            dirExists = false;
+        else
+            throw err;
+    }
+    if (!dirExists) {
+        throw new Error(`catalogues/ directory not found at ${cataloguesDir}\n` +
+            `  Run \`sdd-cli catalogue build\` in that SDD before aggregating.`);
+    }
+    for (const cat of schema.catalogues) {
+        const filePath = join(cataloguesDir, `${cat.name}.csv`);
+        let parsed;
+        try {
+            parsed = await readCatalogueCsv(filePath);
+        }
+        catch (err) {
+            if (err.code === "ENOENT") {
+                counts.set(cat.name, 0);
+                continue;
+            }
+            throw err;
+        }
+        const stamped = stampSourceSddId(cat, parsed.rows, sourceSddId);
+        rowsByCatalogue.get(cat.name).push(...stamped);
+        counts.set(cat.name, stamped.length);
+    }
+    return counts;
+}
+function stampSourceSddId(catalogue, rows, sourceSddId) {
+    const hasColumn = catalogue.columns.some((c) => c.name === "source_sdd_id");
+    if (!hasColumn)
+        return rows.map((r) => ({ ...r }));
+    return rows.map((r) => {
+        if (r["source_sdd_id"] && r["source_sdd_id"].trim() !== "") {
+            // Already stamped — preserve (chained aggregation).
+            return { ...r };
+        }
+        return { ...r, source_sdd_id: sourceSddId };
+    });
+}
+async function crossCheckSiblings(ecosystemRootPath, siblings, aggregatorSchema, write) {
+    const findings = new FindingsLog();
+    for (const sib of siblings) {
+        // Cross-check sibling's .sdd/sdd-manifest.yaml.
+        let sibManifest;
+        try {
+            sibManifest = await loadSddManifest(sib.sddRoot, {
+                cliVersion: CLI_VERSION,
+            });
+        }
+        catch (err) {
+            throw new Error(`aggregator: sibling "${sib.sddId}" at ${relative(ecosystemRootPath, sib.sddRoot)}\n` +
+                `  failed to load .sdd/sdd-manifest.yaml: ${err.message}`);
+        }
+        if (sibManifest.sddId !== sib.sddId) {
+            throw new Error(`aggregator: sibling "${sib.sddId}" in aggregation manifest\n` +
+                `  but its own .sdd/sdd-manifest.yaml declares sdd_id="${sibManifest.sddId}"\n` +
+                `  (rule: sibling_id_matches_sibling_manifest)`);
+        }
+        // Cross-check sibling's vendored catalogue-schema.yaml against aggregator's.
+        const sibSchemaPath = await findVendoredSchema(sib.sddRoot);
+        if (sibSchemaPath !== "") {
+            const text = await readFile(sibSchemaPath, "utf-8");
+            const m = /^schema_version:\s*"?([0-9.]+)"?/m.exec(text);
+            const sibVersion = m?.[1] ?? "";
+            if (sibVersion !== aggregatorSchema.schemaVersion) {
+                throw new Error(`aggregator: sibling "${sib.sddId}" vendored catalogue-schema.yaml\n` +
+                    `  is at ${sibVersion}, aggregator at ${aggregatorSchema.schemaVersion}\n` +
+                    `  Run \`sdd-cli catalogue build\` in the sibling against a matching\n` +
+                    `  schema before aggregating (rule: schema_version_alignment).`);
+            }
+        }
+        write(`    ✓ ${sib.sddId} (${sibManifest.profile})\n`);
+    }
+    return { findings };
+}
+async function findVendoredSchema(sddRoot) {
+    // Adopters typically vendor canonical schema indirectly via sdd-cli.
+    // Some SDDs pin a copy at docs/method/methods/catalogue-schema.yaml.
+    for (const candidate of [
+        "docs/method/methods/catalogue-schema.yaml",
+    ]) {
+        const path = join(sddRoot, candidate);
+        try {
+            const s = await stat(path);
+            if (s.isFile())
+                return path;
+        }
+        catch {
+            // not present — try next
+        }
+    }
+    return "";
+}
+function resolveOutDir(sddPath, override) {
+    if (override !== undefined)
+        return resolve(override);
+    return join(sddPath, "catalogues-aggregated");
+}
+function findSourceSdd(rowsByCatalogue, catalogue, pkValue) {
+    const rows = rowsByCatalogue.get(catalogue) ?? [];
+    for (const row of rows) {
+        if (String(row["id"] ?? "") === pkValue) {
+            const src = String(row["source_sdd_id"] ?? "");
+            return src;
+        }
+    }
+    return "";
+}
+async function writeAggregationManifestJson(inputs) {
+    const out = {
+        schema_version: inputs.schemaVersion,
+        cli_version: inputs.cliVersion,
+        ecosystem_root: inputs.ecosystemRoot,
+        siblings: inputs.siblings.map((s) => ({
+            sdd_id: s.sddId,
+            description: s.description,
+            catalogues_path: s.cataloguesPath,
+            pre_merge_row_counts: counts(inputs.perSiblingCounts.get(s.sddId)),
+        })),
+        ecosystem_root_pre_merge_row_counts: counts(inputs.perSiblingCounts.get(inputs.ecosystemRoot)),
+        aggregated_row_counts: counts(inputs.aggregatedRowCounts),
+    };
+    await writeFile(join(inputs.outDir, "aggregation-manifest.json"), JSON.stringify(out, null, 2) + "\n", "utf-8");
+}
+function counts(map) {
+    const out = {};
+    if (!map)
+        return out;
+    for (const [k, v] of [...map.entries()].sort(([a], [b]) => a.localeCompare(b))) {
+        out[k] = v;
+    }
+    return out;
+}
+async function finalise(inputs) {
+    const rowCounts = new Map();
+    for (const cat of inputs.schema.catalogues) {
+        rowCounts.set(cat.name, (inputs.rowsByCatalogue.get(cat.name) ?? []).length);
+    }
+    return {
+        exitCode: 1,
+        schemaVersion: inputs.schema.schemaVersion,
+        ecosystemRoot: inputs.ecosystemRoot,
+        siblingCount: inputs.aggManifest.siblings.length,
+        rowCounts,
+        perSiblingCounts: inputs.perSiblingCounts,
+        aggregatedFkPass: inputs.aggregatedFkPass,
+        findingsCount: inputs.findings.count(),
+        outDir: inputs.outDir,
+    };
+}
+// Used by tests that want to round-trip CSV through the aggregator's
+// stamping logic without writing files.
+export const __test_only__ = { stampSourceSddId, parseCatalogueCsv };
+//# sourceMappingURL=aggregate.js.map

package/dist/lib/catalogue/aggregate.js.map

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

package/dist/lib/catalogue/aggregation-manifest-loader.d.ts

@@ -0,0 +1,25 @@
+export declare const DEFAULT_AGGREGATION_MANIFEST_REL = "orchestration/aggregation-manifest.yaml";
+export interface ResolvedSibling {
+    readonly sddId: string;
+    readonly description: string;
+    /** Absolute path to the sibling's `catalogues/` directory. */
+    readonly cataloguesPath: string;
+    /** Absolute path to the sibling SDD's repo root (parent of catalogues/). */
+    readonly sddRoot: string;
+}
+export interface LoadedAggregationManifest {
+    readonly schemaVersion: string;
+    readonly ecosystemRoot: string;
+    readonly siblings: readonly ResolvedSibling[];
+    readonly sourcePath: string;
+}
+export interface LoadAggregationManifestOptions {
+    readonly cliVersion: string;
+    /**
+     * Absolute path to the ecosystem-root SDD repo (used to resolve
+     * relative `pull.path` values).
+     */
+    readonly ecosystemRootPath: string;
+}
+export declare function loadAggregationManifest(manifestPath: string, options: LoadAggregationManifestOptions): Promise<LoadedAggregationManifest>;
+//# sourceMappingURL=aggregation-manifest-loader.d.ts.map

package/dist/lib/catalogue/aggregation-manifest-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregation-manifest-loader.d.ts","sourceRoot":"","sources":["../../../src/lib/catalogue/aggregation-manifest-loader.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,gCAAgC,4CACF,CAAC;AAuB5C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,8DAA8D;IAC9D,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,4EAA4E;IAC5E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED,wBAAsB,uBAAuB,CAC3C,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,yBAAyB,CAAC,CAgGpC"}

package/dist/lib/catalogue/aggregation-manifest-loader.js

@@ -0,0 +1,111 @@
+// Aggregation-manifest loader per
+// docs/method/methods/aggregation-manifest-schema.yaml.
+//
+// v1 supports `pull.kind: filesystem` only; other kinds (git-ref,
+// release-asset, mcp-resource) are schema-reserved and reject with a
+// clear "deferred" error so adopters get unambiguous feedback.
+import { readFile } from "node:fs/promises";
+import { isAbsolute, resolve } from "node:path";
+import { parse as parseYaml } from "yaml";
+import { z } from "zod";
+import { SCHEMA_COMPAT, formatSchemaVersionMismatch } from "./schema-compat.js";
+import { isInRange } from "./manifest-loader.js";
+export const DEFAULT_AGGREGATION_MANIFEST_REL = "orchestration/aggregation-manifest.yaml";
+const PullSchema = z
+    .object({
+    kind: z.string(),
+    path: z.string().optional(),
+})
+    .passthrough();
+const SiblingSchema = z.object({
+    sdd_id: z.string().regex(/^[a-z][a-z0-9-]*$/, {
+        message: "sdd_id must match /^[a-z][a-z0-9-]*$/",
+    }),
+    pull: PullSchema,
+    description: z.string().optional(),
+});
+const AggregationManifestSchema = z.object({
+    schema_version: z.string(),
+    ecosystem_root: z.string().regex(/^[a-z][a-z0-9-]*$/),
+    siblings: z.array(SiblingSchema),
+});
+export async function loadAggregationManifest(manifestPath, options) {
+    let text;
+    try {
+        text = await readFile(manifestPath, "utf-8");
+    }
+    catch (err) {
+        if (err.code === "ENOENT") {
+            throw new Error(`Aggregation manifest not found at ${manifestPath}\n\n` +
+                `Ecosystem-root SDDs declare an aggregation manifest at the path\n` +
+                `recorded in .sdd/sdd-manifest.yaml#aggregation_manifest_path, or\n` +
+                `at ${DEFAULT_AGGREGATION_MANIFEST_REL} by default.\n` +
+                `Schema: docs/method/methods/aggregation-manifest-schema.yaml.`);
+        }
+        throw err;
+    }
+    let raw;
+    try {
+        raw = parseYaml(text);
+    }
+    catch (err) {
+        throw new Error(`failed to parse YAML at ${manifestPath}: ${err.message}`);
+    }
+    const parsed = AggregationManifestSchema.safeParse(raw);
+    if (!parsed.success) {
+        const issues = parsed.error.issues
+            .map((i) => `  - ${i.path.join(".") || "<root>"}: ${i.message}`)
+            .join("\n");
+        throw new Error(`invalid aggregation manifest at ${manifestPath}:\n${issues}`);
+    }
+    if (!isInRange(parsed.data.schema_version, SCHEMA_COMPAT.aggregation_manifest)) {
+        throw new Error(formatSchemaVersionMismatch({
+            schema: "aggregation_manifest",
+            readVersion: parsed.data.schema_version,
+            cliVersion: options.cliVersion,
+            sourcePath: manifestPath,
+        }));
+    }
+    // Duplicate sibling-id check.
+    const seen = new Set();
+    for (const s of parsed.data.siblings) {
+        if (seen.has(s.sdd_id)) {
+            throw new Error(`aggregation manifest has duplicate sibling sdd_id "${s.sdd_id}"\n` +
+                `  (${manifestPath})`);
+        }
+        seen.add(s.sdd_id);
+    }
+    // Resolve each sibling's pull. v1 supports `kind: filesystem` only.
+    const resolved = [];
+    for (const s of parsed.data.siblings) {
+        const kind = s.pull.kind;
+        if (kind !== "filesystem") {
+            throw new Error(`aggregation manifest: sibling "${s.sdd_id}" uses pull.kind="${kind}"\n` +
+                `  v1 supports filesystem only. Other kinds (git-ref, release-asset,\n` +
+                `  mcp-resource) are schema-reserved and not yet implemented.\n` +
+                `  See: docs/method/methods/aggregation-manifest-schema.yaml#pull_kinds`);
+        }
+        const path = s.pull.path;
+        if (!path || typeof path !== "string") {
+            throw new Error(`aggregation manifest: sibling "${s.sdd_id}" pull.kind=filesystem requires \`path\``);
+        }
+        const cataloguesPath = isAbsolute(path)
+            ? path
+            : resolve(options.ecosystemRootPath, path);
+        // The sibling's repo root is the parent of `catalogues/`.
+        const sddRoot = resolve(cataloguesPath, "..");
+        resolved.push({
+            sddId: s.sdd_id,
+            description: s.description ?? "",
+            cataloguesPath,
+            sddRoot,
+        });
+    }
+    return {
+        schemaVersion: parsed.data.schema_version,
+        ecosystemRoot: parsed.data.ecosystem_root,
+        siblings: resolved,
+        sourcePath: manifestPath,
+    };
+}
+//# sourceMappingURL=aggregation-manifest-loader.js.map

package/dist/lib/catalogue/aggregation-manifest-loader.js.map

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

package/dist/lib/catalogue/build.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Per-SDD catalogue builder — `sdd-cli catalogue build` orchestrator.
+ *
+ * Per ADR 0134 §4.6, the canonical builder reads method-defined declarative
+ * inputs and emits `catalogues/*.csv` matching the canonical schema.
+ *
+ * This is Phase 1 of the canonical-builder implementation per
+ * adopt-canonical-catalogue-builder.md Step F. Phase 1 ships:
+ *   - manifest loading + schema-version compat check,
+ *   - schema loading,
+ *   - headers-only emission for every catalogue declared in the schema,
+ *   - internal FK validation,
+ *   - findings + row-count reporting.
+ *
+ * Per-source discoverers (domains, repos, services, capabilities, features,
+ * etc.) land in subsequent phases. Until then the builder produces a valid
+ * but empty `catalogues/` directory — useful as a smoke test that the
+ * infrastructure works end-to-end on any SDD repo.
+ */
+export interface BuildInputs {
+    /** SDD repo root (defaults to cwd). */
+    readonly sddPath?: string;
+    /** Output directory for catalogues/ (defaults to <sddPath>/catalogues). */
+    readonly outDir?: string;
+    /** Strict mode — non-zero exit on any finding. Default: only internal FK FAIL exits non-zero. */
+    readonly strict?: boolean;
+}
+export interface BuildResult {
+    readonly exitCode: number;
+    readonly schemaVersion: string;
+    readonly sddId: string;
+    readonly profile: string;
+    readonly category: string;
+    readonly rowCounts: ReadonlyMap<string, number>;
+    readonly internalFkPass: boolean;
+    readonly externalFindings: number;
+    readonly findingsCount: number;
+    readonly outDir: string;
+}
+export type Writer = (s: string) => void;
+export declare function runCatalogueBuild(inputs: BuildInputs, write: Writer): Promise<BuildResult>;
+//# sourceMappingURL=build.d.ts.map

package/dist/lib/catalogue/build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"build.d.ts","sourceRoot":"","sources":["../../../src/lib/catalogue/build.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AA2CH,MAAM,WAAW,WAAW;IAC1B,uCAAuC;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,iGAAiG;IACjG,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,MAAM,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;AAEzC,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,WAAW,CAAC,CAuEtB"}