@unified-product-graph/core 0.13.2 → 0.14.1

package/dist/index.cjs

@@ -1,7 +1,9 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -15,6 +17,14 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
@@ -7605,6 +7615,53 @@ function getDeprecatedTypes() {
   return deprecated;
 }
 var UPG_PROPERTY_MIGRATIONS = {
+  // ── v0.14.0: Pattern E — remove deprecated/ghost properties (UPG-574) ────────
+  //
+  // Properties marked deprecated (some "Removed in 0.9.1") that were never
+  // actually removed, plus superseded soft-aliases. The RICE / opportunity-sizing
+  // scoring inputs were framework-scoped from 0.9.0: their value lives on the
+  // `framework_exercise` includes-edge of the rice-scoring / opportunity-sizing
+  // framework, not on the entity. The remaining four are superseded by a sibling
+  // (cause_category, rule_strength, size_estimate, effort). Loaders drop the
+  // stranded keys; the values were never canonical on the entity.
+  "0.14.0": [
+    {
+      kind: "drop_props",
+      type: "opportunity",
+      drop_props: ["reach", "frequency", "pain", "opportunity_score"],
+      reason: "UPG-574: opportunity scoring (reach/frequency/pain/opportunity_score) was framework-scoped from 0.9.0 (opportunity-sizing). Apply the framework and read the value off the framework_exercise edge; the entity props are removed in 0.14.0."
+    },
+    {
+      kind: "drop_props",
+      type: "solution",
+      drop_props: ["reach", "impact", "confidence", "effort", "rice_score"],
+      reason: "UPG-574: RICE inputs (reach/impact/confidence/effort) and the computed rice_score were framework-scoped from 0.9.0 (rice-scoring). Apply the framework and read the score off the framework_exercise edge; the entity props are removed in 0.14.0."
+    },
+    {
+      kind: "drop_props",
+      type: "root_cause",
+      drop_props: ["category", "verified"],
+      reason: "UPG-574: root_cause.category was a legacy free-form field superseded by the closed-enum cause_category; verified duplicated cause_confidence === confirmed. Both removed in 0.14.0."
+    },
+    {
+      kind: "drop_props",
+      type: "design_guideline",
+      drop_props: ["strictness"],
+      reason: "UPG-574: design_guideline.strictness was superseded by rule_strength (a richer imperative-force enum). Removed in 0.14.0."
+    },
+    {
+      kind: "drop_props",
+      type: "behavioral_segment",
+      drop_props: ["size"],
+      reason: "UPG-574: behavioral_segment.size was a v0.2 alias for size_estimate. Removed in 0.14.0; use size_estimate."
+    },
+    {
+      kind: "drop_props",
+      type: "task",
+      drop_props: ["estimate"],
+      reason: "UPG-574: task.estimate was a story_task-collapse relic that duplicated effort. Removed in 0.14.0; use effort."
+    }
+  ],
   // ── v0.12.0: P14 Bucket C — drop the one non-derived denormalized aggregate ──
   //
   // The count caches (feature_count, evidence_count, workflow step_count /
@@ -10284,8 +10341,7 @@ var UPG_PROPERTY_SCHEMA = {
     source: { type: "string", enum: ["clickstream", "survey", "interview", "mixed", "inferred", "imported"], description: "Membership data source. Drives confidence weighting and refresh policy." },
     included_behaviors: { type: "string[]", description: "Qualifying behaviours (positive criteria, free-text labels)" },
     excluded_behaviors: { type: "string[]", description: "Excluding behaviours (negative criteria, free-text labels)" },
-    size_estimate: { type: "number", description: "Estimated current size. Snapshot value." },
-    size: { type: "number", description: "Size. Alias retained for the v0.2 baseline." },
+    size_estimate: { type: "number", description: "Estimated current size. Snapshot value. (`size`, the v0.2 alias, removed in 0.14.0, UPG-574.)" },
     validity_period_start: { type: "string", description: "ISO start of the validity window. Behavioural definitions decay; outside the window the snapshot should be re-computed." },
     validity_period_end: { type: "string", description: "End of the window over which the segment definition is considered valid (ISO format)" }
   },
@@ -10902,8 +10958,7 @@ var UPG_PROPERTY_SCHEMA = {
     guideline_category: { type: "string", enum: ["spacing", "color", "typography", "layout", "interaction", "content"], description: "Category covered" },
     applies_to: { type: "string", description: "Applicable elements or contexts" },
     rationale: { type: "string", description: "Reasoning. Why this rule exists." },
-    rule_strength: { type: "string", enum: ["must", "must_not", "exception", "warning", "guideline"], description: "Imperative force. Supersedes `strictness`." },
-    strictness: { type: "string", enum: ["must", "should", "may"], description: "RFC-2119-flavoured binding strength" },
+    rule_strength: { type: "string", enum: ["must", "must_not", "exception", "warning", "guideline"], description: "Imperative force. (Superseded the removed `strictness` field in 0.14.0, UPG-574.)" },
     exception_policy: { type: "string", description: "Exception request or documentation process" }
   },
   // DesignPatternProperties: Reusable design pattern.
@@ -12030,46 +12085,11 @@ var UPG_PROPERTY_SCHEMA = {
     rotation_cadence: { type: "string", enum: ["daily", "weekly", "biweekly", "custom"], description: "Cycle cadence. `weekly` for standard team rotations. `daily` for high-incident-volume teams." },
     handoff_time: { type: "string", description: 'Shift handoff time. Affects team coordination and sleep. @example "09:00 UTC", "17:00 local"' }
   },
-  // OpportunityProperties: A problem worth solving, grounded in user need and business value
-  opportunity: {
-    reach: {
-      type: "assessment",
-      scale_id: "reach_5",
-      description: "How many users experience this problem. @deprecated 0.9.0:a framework-scoped scoring input, not an intrinsic property. Apply the `opportunity-sizing` framework; the value lives on the framework_exercise includes-edge. Removed in 0.9.1.",
-      properties: {
-        value: { type: "number", description: "The numeric value, used for computation." },
-        label: { type: "string", description: "The qualitative label (what the assessor meant)." },
-        scale_id: { type: "string", description: "Which assessment scale this was rated on (optional)." },
-        normalized: { type: "number", description: "Normalized 0-1 value for cross-tool comparison (optional)." }
-      },
-      required: ["value", "label"]
-    },
-    frequency: {
-      type: "assessment",
-      scale_id: "frequency_5",
-      description: "How often users experience this problem. @deprecated 0.9.0:framework-scoped (opportunity-sizing). Removed in 0.9.1.",
-      properties: {
-        value: { type: "number", description: "The numeric value, used for computation." },
-        label: { type: "string", description: "The qualitative label (what the assessor meant)." },
-        scale_id: { type: "string", description: "Which assessment scale this was rated on (optional)." },
-        normalized: { type: "number", description: "Normalized 0-1 value for cross-tool comparison (optional)." }
-      },
-      required: ["value", "label"]
-    },
-    pain: {
-      type: "assessment",
-      scale_id: "pain_5",
-      description: "How painful it is when unaddressed. @deprecated 0.9.0:framework-scoped (opportunity-sizing). Removed in 0.9.1.",
-      properties: {
-        value: { type: "number", description: "The numeric value, used for computation." },
-        label: { type: "string", description: "The qualitative label (what the assessor meant)." },
-        scale_id: { type: "string", description: "Which assessment scale this was rated on (optional)." },
-        normalized: { type: "number", description: "Normalized 0-1 value for cross-tool comparison (optional)." }
-      },
-      required: ["value", "label"]
-    },
-    opportunity_score: { type: "number", description: "Computed: normalized_reach x normalized_frequency x normalized_pain (0-1). @deprecated 0.9.0:computed by the `opportunity-sizing` framework on its application edge, not stored on the entity. Removed in 0.9.1." }
-  },
+  // OpportunityProperties: A problem worth solving, grounded in user need and business value.
+  // No intrinsic scalar properties — defined by edges + framework-scoped scoring
+  // (reach/frequency/pain/opportunity_score live on the `opportunity-sizing`
+  // framework_exercise edge). Former props removed in 0.14.0 (UPG-574).
+  opportunity: {},
   // OrganizationProperties: Organization entity.
   organization: {
     logo_url: { type: "string", description: "URL of the organisation's logo" },
@@ -12529,9 +12549,8 @@ var UPG_PROPERTY_SCHEMA = {
     cause_category: { type: "string", enum: ["code", "config", "process", "dependency", "data", "infrastructure", "human_error", "other"], description: "Closed-enum cause category for RCA reporting and dashboards. Distinct from the legacy free-form `category`." },
     cause_confidence: { type: "string", enum: ["hypothesised", "likely", "confirmed"], description: "Team certainty about this cause. `hypothesised` = educated guess. `likely` = evidence points here. `confirmed` = reproduced. Renamed from `confidence` in v0.4.0 to disambiguate from the entity-wide `UPGAssessment`-typed epistemic confidence used elsewhere. The 3-tier shape stays as a discrete RCA-lifecycle marker." },
     evidence_summary: { type: "string", description: "One-paragraph evidence summary. Log lines, traces, repro steps. Detailed artefacts go on linked `evidence` nodes." },
-    category: { type: "string", enum: ["architecture", "design", "data", "infrastructure", "process", "dependency", "other"], description: "Legacy free-form category. Retained for v0.2 baseline; new graphs prefer `cause_category`." },
-    affected_area: { type: "string", description: "Affected area of the system" },
-    verified: { type: "boolean", description: "Verified through investigation" }
+    affected_area: { type: "string", description: "Affected area of the system" }
+    // `category` (legacy, -> `cause_category`) and `verified` (= `cause_confidence === 'confirmed'`) removed in 0.14.0 (UPG-574).
   },
   // RunbookProperties: Runbook.
   runbook: {
@@ -12684,58 +12703,12 @@ var UPG_PROPERTY_SCHEMA = {
     post_type: { type: "string", enum: ["text", "image", "video", "carousel", "story"], description: "Format of the post" },
     scheduled_date: { type: "string", description: "Date the post is scheduled to publish (ISO format)" }
   },
-  // SolutionProperties: A proposed response to an opportunity
+  // SolutionProperties: A proposed response to an opportunity.
+  // RICE scoring inputs (reach/impact/confidence/effort) + computed rice_score
+  // were framework-scoped from 0.9.0 and removed in 0.14.0 (UPG-574): they live
+  // on the `rice-scoring` framework_exercise edge, not the entity.
   solution: {
-    timeline: { type: "string", description: "Estimated delivery or target timeline" },
-    reach: {
-      type: "assessment",
-      scale_id: "reach_5",
-      description: "How many users this solution reaches (1 = few, 5 = most). @deprecated 0.9.0:a framework-scoped scoring input, not an intrinsic property. Apply the `rice-scoring` framework; the value lives on the framework_exercise includes-edge. Removed in 0.9.1.",
-      properties: {
-        value: { type: "number", description: "The numeric value, used for computation." },
-        label: { type: "string", description: "The qualitative label (what the assessor meant)." },
-        scale_id: { type: "string", description: "Which assessment scale this was rated on (optional)." },
-        normalized: { type: "number", description: "Normalized 0-1 value for cross-tool comparison (optional)." }
-      },
-      required: ["value", "label"]
-    },
-    impact: {
-      type: "assessment",
-      scale_id: "impact_5",
-      description: "Expected impact on the target outcome (1 = minimal, 5 = transformative). @deprecated 0.9.0:framework-scoped (rice-scoring). Removed in 0.9.1.",
-      properties: {
-        value: { type: "number", description: "The numeric value, used for computation." },
-        label: { type: "string", description: "The qualitative label (what the assessor meant)." },
-        scale_id: { type: "string", description: "Which assessment scale this was rated on (optional)." },
-        normalized: { type: "number", description: "Normalized 0-1 value for cross-tool comparison (optional)." }
-      },
-      required: ["value", "label"]
-    },
-    confidence: {
-      type: "assessment",
-      scale_id: "confidence_5",
-      description: "How confident the team is in this solution (1 = speculative, 5 = proven). @deprecated 0.9.0:framework-scoped (rice-scoring). Removed in 0.9.1.",
-      properties: {
-        value: { type: "number", description: "The numeric value, used for computation." },
-        label: { type: "string", description: "The qualitative label (what the assessor meant)." },
-        scale_id: { type: "string", description: "Which assessment scale this was rated on (optional)." },
-        normalized: { type: "number", description: "Normalized 0-1 value for cross-tool comparison (optional)." }
-      },
-      required: ["value", "label"]
-    },
-    effort: {
-      type: "assessment",
-      scale_id: "effort_5",
-      description: "Level of effort required to implement (1 = trivial, 5 = very large). @deprecated 0.9.0:effort is a framework-scoped scoring input (it varies by assessor and method), not an intrinsic property. Removed in 0.9.1.",
-      properties: {
-        value: { type: "number", description: "The numeric value, used for computation." },
-        label: { type: "string", description: "The qualitative label (what the assessor meant)." },
-        scale_id: { type: "string", description: "Which assessment scale this was rated on (optional)." },
-        normalized: { type: "number", description: "Normalized 0-1 value for cross-tool comparison (optional)." }
-      },
-      required: ["value", "label"]
-    },
-    rice_score: { type: "number", description: "Computed: (reach \xD7 impact \xD7 confidence) / effort. @deprecated 0.9.0:computed by the `rice-scoring` framework on its application edge, not stored on the entity. Removed in 0.9.1." }
+    timeline: { type: "string", description: "Estimated delivery or target timeline" }
   },
   // SpecificationProperties: A governed specification: a query language, protocol, data format, encoding,
   specification: {
@@ -12893,8 +12866,8 @@ var UPG_PROPERTY_SCHEMA = {
     effort: { type: "string", description: 'Effort estimate (e.g. "2h", "1d", "3 points"). Use a consistent unit within your team.' },
     priority: { type: "string", enum: ["urgent", "high", "medium", "low", "none"], description: "Relative importance against other tasks" },
     due_date: { type: "string", description: "ISO date due. Typically bounded by the containing story's due date." },
-    labels: { type: "string[]", description: "Free-form classification tags. Applied uniformly across work item types." },
-    estimate: { type: "string", description: 'Story-point or sizing estimate. String to support fibonacci, t-shirt sizes, or custom scales (e.g. "5", "M", "3 pts"). Absorbed from `StoryTaskProperties` when `story_task` collapsed into `task` (v0.4.0).' }
+    labels: { type: "string[]", description: "Free-form classification tags. Applied uniformly across work item types." }
+    // `estimate` (story_task collapse relic, duplicated `effort`) removed in 0.14.0 (UPG-574).
   },
   // TeamProperties: Team entity.
   team: {
@@ -29230,7 +29203,7 @@ function validateExpression(expr) {
 }
 
 // src/format/canonical.ts
-var import_node_crypto = require("crypto");
+var nodeCrypto = __toESM(require("crypto"), 1);
 var UPG_CANONICAL_FORMAT_VERSION = "1.0.0";
 var INTEGRITY_HASH_PRIMITIVE = "sha256";
 var INTEGRITY_DIGEST_HEX = 32;
@@ -29406,7 +29379,7 @@ function portfolioBody(doc) {
 function computeBodyChecksum(doc) {
   const body = isPortfolio(doc) ? portfolioBody(doc) : singleBody(doc);
   const content = JSON.stringify(body);
-  return (0, import_node_crypto.createHash)(INTEGRITY_HASH_PRIMITIVE).update(content).digest("hex").slice(0, INTEGRITY_DIGEST_HEX);
+  return nodeCrypto.createHash(INTEGRITY_HASH_PRIMITIVE).update(content).digest("hex").slice(0, INTEGRITY_DIGEST_HEX);
 }
 function isPortfolio(doc) {
   return doc.type === "portfolio" || "cross_edges" in doc;
@@ -29544,7 +29517,7 @@ function isCanonical(text) {
 }
 
 // src/index.ts
-var UPG_VERSION = "0.13.2";
+var UPG_VERSION = "0.14.1";
 var UPG_FORMAT_VERSION = "0.4.0";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();