@unified-product-graph/core 0.26.0 → 0.26.1

package/dist/index.cjs

@@ -135,6 +135,8 @@ __export(index_exports, {
   backfillSlug: () => backfillSlug,
   buildTypeAliases: () => buildTypeAliases,
   canBeChildOf: () => canBeChildOf,
+  checkHeaderSeal: () => checkHeaderSeal,
+  checkHeaderSealText: () => checkHeaderSealText,
   coerceProductStage: () => coerceProductStage,
   collectSlugsForType: () => collectSlugsForType,
   compareVersions: () => compareVersions,
@@ -143,6 +145,9 @@ __export(index_exports, {
   concernFor: () => concernFor,
   concernGatesFor: () => concernGatesFor,
   crossProductScope: () => crossProductScope,
+  deriveCounts: () => deriveCounts,
+  derivePortfolioCounts: () => derivePortfolioCounts,
+  deriveSingleCounts: () => deriveSingleCounts,
   describeTreePattern: () => describeTreePattern,
   edgeCarriesProperties: () => edgeCarriesProperties,
   evaluateAntiPatterns: () => evaluateAntiPatterns,
@@ -30160,6 +30165,28 @@ function portfolioBody(doc) {
     ...doc.signals && doc.signals.length > 0 ? { signals: sortNodes(doc.signals).map(canonicalNode) } : {}
   };
 }
+function deriveSingleCounts(doc) {
+  return { nodes: doc.nodes?.length ?? 0, edges: doc.edges?.length ?? 0 };
+}
+function derivePortfolioCounts(doc) {
+  const members = doc.products ?? [];
+  const memberKindOf = (p) => p.member_kind ?? "product";
+  const watchedCount = members.filter((p) => memberKindOf(p) === "watched").length;
+  const rollupCount = members.filter((p) => memberKindOf(p) === "org_rollup").length;
+  const operatingFunctionCount = members.filter((p) => memberKindOf(p) === "operating_function").length;
+  return {
+    products: members.filter((p) => memberKindOf(p) === "product").length,
+    ...watchedCount > 0 ? { watched_products: watchedCount } : {},
+    ...rollupCount > 0 ? { org_rollups: rollupCount } : {},
+    ...operatingFunctionCount > 0 ? { operating_functions: operatingFunctionCount } : {},
+    product_areas: doc.product_areas?.length ?? 0,
+    portfolios: doc.portfolios?.length ?? 0,
+    cross_edges: doc.cross_edges?.length ?? 0
+  };
+}
+function deriveCounts(doc) {
+  return isPortfolio(doc) ? derivePortfolioCounts(doc) : deriveSingleCounts(doc);
+}
 function computeBodyChecksum(doc) {
   const body = isPortfolio(doc) ? portfolioBody(doc) : singleBody(doc);
   const content = JSON.stringify(body);
@@ -30199,7 +30226,7 @@ function serializeSingleWithHeader(doc, opts) {
   };
   const summary = deriveSummary(product.description);
   if (summary) header.summary = summary;
-  header.counts = { nodes: doc.nodes?.length ?? 0, edges: doc.edges?.length ?? 0 };
+  header.counts = deriveSingleCounts(doc);
   if (doc.member_kind === "org_rollup" || doc.member_kind === "watched" || doc.member_kind === "operating_function") {
     header.member_kind = doc.member_kind;
   }
@@ -30222,20 +30249,7 @@ function serializePortfolioWithHeader(doc, opts) {
   };
   const summary = deriveSummary(org.description);
   if (summary) header.summary = summary;
-  const members = doc.products ?? [];
-  const memberKindOf = (p) => p.member_kind ?? "product";
-  const watchedCount = members.filter((p) => memberKindOf(p) === "watched").length;
-  const rollupCount = members.filter((p) => memberKindOf(p) === "org_rollup").length;
-  const operatingFunctionCount = members.filter((p) => memberKindOf(p) === "operating_function").length;
-  header.counts = {
-    products: members.filter((p) => memberKindOf(p) === "product").length,
-    ...watchedCount > 0 ? { watched_products: watchedCount } : {},
-    ...rollupCount > 0 ? { org_rollups: rollupCount } : {},
-    ...operatingFunctionCount > 0 ? { operating_functions: operatingFunctionCount } : {},
-    product_areas: doc.product_areas?.length ?? 0,
-    portfolios: doc.portfolios?.length ?? 0,
-    cross_edges: doc.cross_edges?.length ?? 0
-  };
+  header.counts = derivePortfolioCounts(doc);
   header.provenance = buildProvenance(doc, opts);
   header.integrity = { algorithm: INTEGRITY_ALGORITHM, body: computeBodyChecksum(doc) };
   return JSON.stringify({ $upg: header, ...body }, null, 2) + "\n";
@@ -30303,9 +30317,61 @@ function isCanonical(text) {
   const parsed = parseUpg(text);
   return text === serializeCanonical(parsed);
 }
+function checkHeaderSeal(obj) {
+  const raw = obj;
+  const header = raw?.$upg;
+  const report = {
+    header_present: !!header,
+    counts_checked: false,
+    integrity_checked: false,
+    counts_drift: [],
+    integrity_drift: []
+  };
+  if (!header) return report;
+  if (header.format_version !== UPG_CANONICAL_FORMAT_VERSION) {
+    report.skipped_reason = `format_version "${header.format_version}" is not this serialiser's "${UPG_CANONICAL_FORMAT_VERSION}"; counts keys and body layout are format-version contracts, so neither seal can be judged here.`;
+    return report;
+  }
+  const doc = normalizeDocument(raw);
+  const declaredCounts = header.counts ?? {};
+  const actualCounts = deriveCounts(doc);
+  if (header.counts === void 0) {
+    report.skipped_reason = "header has no `counts` block to compare.";
+  } else {
+    report.counts_checked = true;
+    const fields = /* @__PURE__ */ new Set([...Object.keys(declaredCounts), ...Object.keys(actualCounts)]);
+    for (const field of [...fields].sort()) {
+      const declaredRaw = declaredCounts[field];
+      const declared = typeof declaredRaw === "number" ? declaredRaw : 0;
+      const actual = actualCounts[field] ?? 0;
+      if (declared !== actual) report.counts_drift.push({ field, declared, actual });
+    }
+  }
+  const integrity = header.integrity;
+  if (!integrity || typeof integrity.body !== "string") {
+    report.skipped_reason = report.skipped_reason ?? "header has no `integrity.body` seal to compare.";
+  } else if (integrity.algorithm !== INTEGRITY_ALGORITHM) {
+    report.skipped_reason = report.skipped_reason ?? `integrity.algorithm "${integrity.algorithm}" is not "${INTEGRITY_ALGORITHM}"; the declared digest cannot be recomputed here.`;
+  } else {
+    report.integrity_checked = true;
+    const computed = computeBodyChecksum(doc);
+    if (computed !== integrity.body) {
+      report.integrity_drift.push({
+        algorithm: integrity.algorithm,
+        declared: integrity.body,
+        computed
+      });
+    }
+  }
+  return report;
+}
+function checkHeaderSealText(text) {
+  const noBom = text.charCodeAt(0) === 65279 ? text.slice(1) : text;
+  return checkHeaderSeal(JSON.parse(noBom));
+}
 
 // src/index.ts
-var UPG_VERSION = "0.26.0";
+var UPG_VERSION = "0.26.1";
 var UPG_FORMAT_VERSION = "0.4.0";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();
@@ -30475,6 +30541,8 @@ var UPG_META_COUNT = UPG_ENTITY_META.length;
   backfillSlug,
   buildTypeAliases,
   canBeChildOf,
+  checkHeaderSeal,
+  checkHeaderSealText,
   coerceProductStage,
   collectSlugsForType,
   compareVersions,
@@ -30483,6 +30551,9 @@ var UPG_META_COUNT = UPG_ENTITY_META.length;
   concernFor,
   concernGatesFor,
   crossProductScope,
+  deriveCounts,
+  derivePortfolioCounts,
+  deriveSingleCounts,
   describeTreePattern,
   edgeCarriesProperties,
   evaluateAntiPatterns,