@sdd-method/verify-cli 0.1.0

package/dist/lib/catalogue/relationship-semantics.js

@@ -0,0 +1,66 @@
+// Relationship semantics and catalogue kinds, read from the vendored
+// rubric-coverage-map.yaml — READ-ONLY. Split out of `graph-run.ts`, which also
+// holds `runCatalogueGraph`, the verb that writes `<catalogues-dir>-graph.jsonl`
+// by default. `catalogue impact` needs these loaders and nothing that writes,
+// and the verify-only CLI ships `impact` (M-ADR 0212 §4.3b): while they lived in
+// graph-run the writer came along with them, and the package build caught it.
+// `graph-run.ts` re-exports everything here, so existing imports are unchanged.
+import { readFile } from "node:fs/promises";
+import { fileURLToPath } from "node:url";
+import { join } from "node:path";
+import { parse as parseYaml } from "yaml";
+/**
+ * Vendored copy of sdd-method's orchestration/rubric-coverage-map.yaml —
+ * byte-identical to the canonical (rubric-coverage-map-drift.test.ts guards
+ * it, same one-way contract as canonical-schema.yaml). The build copies it
+ * alongside the compiled module via scripts/copy-yaml-assets.mjs.
+ */
+export const VENDORED_COVERAGE_MAP_PATH = join(fileURLToPath(new URL(".", import.meta.url)), "rubric-coverage-map.yaml");
+function toDecl(where, e) {
+    if (e.class === undefined) {
+        throw new Error(`rubric-coverage-map: ${where} has no class declaration (M-ADR 0206)`);
+    }
+    if ((e.impact_flow === undefined) === (e.impact_flow_by === undefined)) {
+        throw new Error(`rubric-coverage-map: ${where} must declare exactly one of impact_flow / impact_flow_by`);
+    }
+    return {
+        class: e.class,
+        ...(e.impact_flow !== undefined
+            ? { impactFlow: e.impact_flow }
+            : {}),
+        ...(e.impact_flow_by !== undefined
+            ? {
+                impactFlowBy: {
+                    column: e.impact_flow_by.column,
+                    values: e.impact_flow_by.values,
+                },
+            }
+            : {}),
+    };
+}
+export async function loadRelationshipSemantics(mapPath = VENDORED_COVERAGE_MAP_PATH) {
+    const raw = parseYaml(await readFile(mapPath, "utf-8"));
+    const kinds = new Map();
+    const edges = new Map();
+    const entityFks = new Map();
+    for (const [name, entry] of Object.entries(raw.coverage)) {
+        kinds.set(name, entry.kind);
+        if (entry.kind === "edge" || entry.kind === "annotation") {
+            // an annotation classifies at top level exactly as an edge does (schema 3.9.0)
+            edges.set(name, toDecl(`edge ${name}`, entry));
+        }
+        for (const [col, decl] of Object.entries(entry.relationships ?? {})) {
+            entityFks.set(`${name}.${col}`, toDecl(`entity FK ${name}.${col}`, decl));
+        }
+    }
+    return { kinds, edges, entityFks };
+}
+export async function loadCatalogueKinds(mapPath = VENDORED_COVERAGE_MAP_PATH) {
+    const raw = parseYaml(await readFile(mapPath, "utf-8"));
+    const kinds = new Map();
+    for (const [name, entry] of Object.entries(raw.coverage)) {
+        kinds.set(name, entry.kind);
+    }
+    return kinds;
+}
+//# sourceMappingURL=relationship-semantics.js.map