@unified-product-graph/mcp-server 0.7.5 → 0.8.0

package/dist/index.js

@@ -6410,6 +6410,41 @@ function getDeprecatedTypes() {
   return deprecated;
 }
 var UPG_PROPERTY_MIGRATIONS = {
+  // ── v0.8.0: UPG-574 deprecated-property removal pass ───────────────────
+  //
+  // The seven properties tagged `@deprecated since v0.4.0` that survived the
+  // v0.5.0 hygiene pass are removed from the spec in v0.8.0 (a breaking
+  // release). Five of the seven already carry a migration:
+  //   - `task.task_status` / `bug.bug_status` lift to `UPGBaseNode.status`
+  //     (see `UPG_PROPERTY_MIGRATIONS['0.4.0']`, values identical).
+  //   - `learning.metric` drops in favour of the `learning_observed_on_metric`
+  //     edge (see `UPG_PROPERTY_MIGRATIONS['0.5.0']`).
+  // The two remaining property surfaces are migrated here:
+  //   - `evidence.strength` (simple `strong | moderate | weak` enum) is
+  //     dropped in favour of `weight: UPGAssessment` (scale `weight_5pt`).
+  //     Authors carrying the legacy key should copy the value to `weight`
+  //     before applying this migration: `strong → 5`, `moderate → 3`,
+  //     `weak → 1`, with the old word preserved in `weight.label`.
+  //   - `story_task.estimate` / `.effort` / `.priority` drop. `story_task`
+  //     itself is deprecated (`UPG_MIGRATIONS['0.4.0']` renames it to the
+  //     canonical `task`); the type rename copies every property verbatim,
+  //     so the values survive on `task` (`TaskProperties.estimate` /
+  //     `.effort` / `.priority`, all live). This rule removes the residue
+  //     from any node still typed `story_task` at migration time.
+  "0.8.0": [
+    {
+      kind: "drop_props",
+      type: "evidence",
+      drop_props: ["strength"],
+      reason: "UPG-574 (v0.8.0). evidence.strength was `@deprecated since v0.4.0`; the structured `weight: UPGAssessment` (scale `weight_5pt`) replaces the `strong | moderate | weak` enum to align with the spec-wide scoring pattern. Authors should copy the value to `weight` before applying this migration (strong -> 5, moderate -> 3, weak -> 1; carry the old word in `weight.label`). The migration drops the residue."
+    },
+    {
+      kind: "drop_props",
+      type: "story_task",
+      drop_props: ["estimate", "effort", "priority"],
+      reason: 'UPG-574 (v0.8.0). story_task.estimate / .effort / .priority were `@deprecated since v0.4.0`; story_task itself is deprecated (UPG_MIGRATIONS["0.4.0"] renames it to canonical `task`, copying all properties verbatim), so the values survive on TaskProperties.estimate / .effort / .priority (all live). This rule removes the residue from any node still typed `story_task` at migration time.'
+    }
+  ],
   // ── v0.5.0: UPG-509 deprecation hygiene pass ───────────────────────────
   //
   // Properties tagged `@deprecated since="0.4.0" removeIn="0.5.0"` (and the
@@ -7913,7 +7948,18 @@ var UPG_PROPERTY_SCHEMA = {
   },
   // A11yIssueProperties: Accessibility issue.
   a11y_issue: {
-    severity: { type: "string", enum: ["minor", "moderate", "serious", "critical"], description: "Severity. Aligned to axe-core's 4-level impact scale (industry standard): 'minor' < 'moderate' < 'serious' < 'critical'. Migration: the previous 3-level scale ('critical' | 'major' | 'minor') maps to ('critical' | 'serious' | 'minor') respectively." },
+    severity: {
+      type: "assessment",
+      scale_id: "severity_5",
+      description: "Impact severity (UPGAssessment on the `severity_5` scale). Migrated from the inline axe-core 4-level enum (`minor|moderate|serious|critical`) (UPG-579 Option C): map `critical` -> 5, `serious` -> 4, `moderate` -> 3, `minor` -> 2; carry the old word in `label`.",
+      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"]
+    },
     wcag_criterion: { type: "string", description: 'WCAG success criterion violated (e.g. "1.1.1", "2.4.7")' },
     rule_id: { type: "string", description: "Identifier of the rule that flagged the issue" },
     help_url: { type: "string", description: "URL to documentation explaining the issue and how to fix it" },
@@ -7970,7 +8016,18 @@ var UPG_PROPERTY_SCHEMA = {
   affinity_cluster: {
     theme: { type: "string", description: "Emergent theme label" },
     child_observation_count: { type: "number", description: "Observations in this cluster" },
-    confidence: { type: "string", enum: ["high", "medium", "low"], description: "Confidence in the theme's validity" }
+    confidence: {
+      type: "assessment",
+      scale_id: "confidence_5",
+      description: "Confidence in the theme's validity (UPGAssessment on `confidence_5`).",
+      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"]
+    }
   },
   // AgentDefinitionProperties: Agent definition.
   agent_definition: {
@@ -8104,7 +8161,7 @@ var UPG_PROPERTY_SCHEMA = {
   // AlertRuleProperties: Alert rule.
   alert_rule: {
     condition: { type: "string", description: 'Triggering query or expression. @example "avg(rate(http_errors_total[5m])) > 0.05"' },
-    severity: { type: "string", enum: ["critical", "warning", "info"], description: "Routes notification and escalation. `critical` = page immediately. `warning` = notify, don't page. `info` = log only." },
+    severity: { type: "string", enum: ["critical", "warning", "info"], description: "Routes notification and escalation. Uses the `LogLevel` scale (operational verbosity, distinct from user-impact `severity_5`). `critical` = page immediately. `warning` = notify, don't page. `info` = log only." },
     notification_channel: { type: "string", description: 'Notification destination. @example "pagerduty:sev1-rotation", "slack:#alerts-low"' },
     evaluation_window: { type: "string", description: 'Required duration the condition holds before firing. Prevents flapping on transient spikes. @example "5m", "15m", "1h"' },
     escalation_policy: { type: "string", description: 'Escalation behaviour on unacknowledged alerts. @example "Escalate to engineering lead after 10 minutes"' }
@@ -8143,16 +8200,28 @@ var UPG_PROPERTY_SCHEMA = {
   },
   // AssumptionProperties: Assumption entity.
   assumption: {
-    confidence: { type: "string", enum: ["high", "medium", "low"], description: "Confidence before testing. Independent of whether the assumption is validated (tracked in lifecycle)." },
+    confidence: {
+      type: "assessment",
+      scale_id: "confidence_5",
+      description: "Confidence before testing (UPGAssessment on `confidence_5`). Independent of whether the assumption is validated (tracked in lifecycle).",
+      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"]
+    },
     validation_method: { type: "string", description: "Validation method, planned or used" },
     risk_level: {
-      type: "object",
+      type: "assessment",
+      scale_id: "severity_5",
       description: "Exposure if the assumption turns out wrong",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
@@ -8263,8 +8332,18 @@ var UPG_PROPERTY_SCHEMA = {
   },
   // BugProperties: Bug report.
   bug: {
-    bug_severity: { type: "string", enum: ["critical", "major", "minor", "trivial"], description: "Impact severity. Independent of priority (which governs when it gets fixed). `critical` = data loss or complete feature failure. `trivial` = cosmetic only." },
-    bug_status: { type: "string", enum: ["open", "in_progress", "fixed", "verified", "wont_fix"], description: "@deprecated since v0.4.0. Use top-level `UPGBaseNode.status`. Values map identically: open | in_progress | fixed | verified | wont_fix. Migration: `UPG_PROPERTY_MIGRATIONS['0.4.0']` lifts this to `status`." },
+    bug_severity: {
+      type: "assessment",
+      scale_id: "severity_5",
+      description: "Impact severity (UPGAssessment on the `severity_5` scale). Independent of priority (which governs when it gets fixed). Migrated from the inline `critical|major|minor|trivial` enum (UPG-579 Option C): map `critical` -> 5, `major` -> 4, `minor` -> 2, `trivial` -> 1; carry the old word in `label`.",
+      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"]
+    },
     steps_to_reproduce: { type: "string", description: "Step-by-step reproduction" },
     environment: { type: "string", description: 'Observed environment (e.g. "prod", "staging", "iOS 17.4")' },
     priority: { type: "string", enum: ["urgent", "high", "medium", "low", "none"], description: "Urgency relative to other work. Independent of `bug_severity` (a critical bug can have low priority if rare)." },
@@ -8294,7 +8373,7 @@ var UPG_PROPERTY_SCHEMA = {
     maturity_level: { type: "string", enum: ["initial", "developing", "defined", "managed", "optimizing"], description: "Current maturity" },
     target_maturity: { type: "string", enum: ["initial", "developing", "defined", "managed", "optimizing"], description: "Target maturity" },
     gap: { type: "string", description: "Gap between current and target" },
-    evolution_stage: { type: "string", enum: ["genesis", "custom", "product", "commodity"], description: 'Wardley evolution axis: where this capability sits on the genesis \u2192 custom \u2192 product \u2192 commodity spectrum. Used by frameworks like `wardley-map`; generally useful as a maturity-of-the-domain signal independent of `maturity_level` (which measures the team\'s internal capability practice). @example "product"' },
+    evolution_stage: { type: "string", enum: ["genesis", "custom", "product", "commodity"], description: "Wardley evolution axis: where this capability sits on the genesis \u2192 custom \u2192 product \u2192 commodity spectrum. Used by frameworks like `wardley-map`; generally useful as a maturity-of-the-domain signal independent of `maturity_level` (which measures the team's internal capability practice). @example 'product'" },
     visibility: { type: "number", description: "Position on the visibility axis from `0.0` (deepest dependency, infra the user never sees) to `1.0` (user-visible anchor). Used by `wardley-map` for the y-axis position of each capability in the value chain. @example 0.8" }
   },
   // CapacityPlanProperties: CapacityPlan entity.
@@ -8307,7 +8386,7 @@ var UPG_PROPERTY_SCHEMA = {
   // CeremonyProperties: Ceremony entity.
   ceremony: {
     ceremony_type: { type: "string", enum: ["standup", "planning", "review", "retro", "sync", "demo", "other"], description: "Kind of recurring meeting" },
-    cadence: { type: "string", description: 'How often the ceremony occurs (e.g. "daily", "biweekly")' },
+    cadence: { type: "string", enum: ["continuous", "hourly", "daily", "weekly", "monthly", "quarterly", "yearly", "on_demand", "other"], description: "How often the ceremony occurs. Uses the shared `Cadence` scale." },
     duration_minutes: { type: "number", description: "Typical duration of the meeting in minutes" },
     participants: { type: "string", description: "People or roles who attend" }
   },
@@ -8336,9 +8415,9 @@ var UPG_PROPERTY_SCHEMA = {
     category: { type: "string", description: "High-level category of the churn reason" },
     frequency_count: { type: "number", description: "Exact count of times this reason has been cited in `frequency_period`" },
     frequency_period: { type: "string", description: "The recurrence period the count is measured over (ISO-8601 `Duration`, e.g. `'P30D'`)" },
-    frequency_rating: { type: "string", enum: ["rare", "occasional", "regular", "constant", "other"], description: "Qualitative frequency tier when an exact count is not known" },
+    frequency_rating: { type: "string", enum: ["constant", "regular", "occasional", "rare", "other"], description: "Qualitative frequency tier when an exact count is not known" },
     contributing_factors: { type: "string[]", description: "Other factors that contributed to the churn" },
-    signal_sentiment: { type: "string", enum: ["positive", "negative", "neutral", "mixed"], description: "Detected sentiment of the churn signal" },
+    signal_sentiment: { type: "string", enum: ["positive", "neutral", "negative", "mixed"], description: "Detected sentiment of the churn signal" },
     signal_channel: { type: "string", description: "Channel through which the churn signal was received" },
     signal_urgency: { type: "string", enum: ["low", "medium", "high", "critical"], description: "Urgency of the churn risk" }
   },
@@ -8452,7 +8531,7 @@ var UPG_PROPERTY_SCHEMA = {
     publish_cadence: { type: "string", enum: ["continuous", "hourly", "daily", "weekly", "monthly", "quarterly", "yearly", "on_demand", "other"], description: "Publishing cadence (canonical `Cadence` since v0.4.0). Retyped from the legacy free-form `publish_cadence: string`. For exact rates (\"3 per week\"), set `frequency_count` + `frequency_period`. BREAKING in v0.4.0: previous string values like `\"3x/week\"` no longer type-check. Map to `'weekly'` + `frequency_count: 3` + `frequency_period: 'P7D'`." },
     frequency_count: { type: "number", description: "Exact count in the period. Pairs with `frequency_period`." },
     frequency_period: { type: "string", description: "Recurrence period (ISO-8601 `Duration`, e.g. `'P7D'`)" },
-    frequency_rating: { type: "string", enum: ["rare", "occasional", "regular", "constant", "other"], description: "Qualitative rate tier when an exact rate is unknown" }
+    frequency_rating: { type: "string", enum: ["constant", "regular", "occasional", "rare", "other"], description: "Qualitative rate tier when an exact rate is unknown" }
   },
   // ContentPieceProperties: Content piece.
   content_piece: {
@@ -8467,7 +8546,7 @@ var UPG_PROPERTY_SCHEMA = {
     cadence: { type: "string", enum: ["continuous", "hourly", "daily", "weekly", "monthly", "quarterly", "yearly", "on_demand", "other"], description: "Publishing cadence (canonical `Cadence` since v0.4.0). Retyped from the legacy free-form `cadence: string` (e.g. \"2x/week\"). For exact rates, set `frequency_count` + `frequency_period`. BREAKING in v0.4.0: previous string values like `\"2x/week\"` no longer type-check. Map to `'weekly'` + `frequency_count: 2` + `frequency_period: 'P7D'`." },
     frequency_count: { type: "number", description: "Exact count of publications in the period. Pairs with `frequency_period`." },
     frequency_period: { type: "string", description: "Recurrence period (ISO-8601 `Duration`, e.g. `'P7D'`)" },
-    frequency_rating: { type: "string", enum: ["rare", "occasional", "regular", "constant", "other"], description: "Qualitative rate tier when an exact rate is unknown" }
+    frequency_rating: { type: "string", enum: ["constant", "regular", "occasional", "rare", "other"], description: "Qualitative rate tier when an exact rate is unknown" }
   },
   // ContentThemeProperties: Content theme.
   content_theme: {
@@ -8492,13 +8571,14 @@ var UPG_PROPERTY_SCHEMA = {
     clause_text: { type: "string", description: "Full text of the clause" },
     is_negotiable: { type: "boolean", description: "Whether this clause is open to negotiation" },
     risk_level: {
-      type: "object",
+      type: "assessment",
+      scale_id: "severity_5",
       description: "Risk level if the clause is accepted as-is (1 = negligible, 5 = severe exposure)",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     }
@@ -8517,9 +8597,9 @@ var UPG_PROPERTY_SCHEMA = {
   // CustomerFeedbackProperties: Customer feedback.
   customer_feedback: {
     feedback_type: { type: "string", enum: ["survey", "interview", "review", "nps"], description: "How the feedback was collected" },
-    sentiment: { type: "string", enum: ["positive", "neutral", "negative"], description: "Overall sentiment of the feedback" },
+    sentiment: { type: "string", enum: ["positive", "neutral", "negative", "mixed"], description: "Overall sentiment of the feedback" },
     verbatim: { type: "string", description: "Exact words from the customer" },
-    signal_sentiment: { type: "string", enum: ["positive", "negative", "neutral", "mixed"], description: "Detected sentiment of the underlying signal" },
+    signal_sentiment: { type: "string", enum: ["positive", "neutral", "negative", "mixed"], description: "Detected sentiment of the underlying signal" },
     signal_channel: { type: "string", description: "Channel through which the signal was received" },
     signal_urgency: { type: "string", enum: ["low", "medium", "high", "critical"], description: "Perceived urgency of the feedback" }
   },
@@ -8548,7 +8628,7 @@ var UPG_PROPERTY_SCHEMA = {
     url: { type: "string", description: "URL to the live dashboard" },
     audience: { type: "string", description: "Intended audience for this dashboard" },
     element_count: { type: "number", description: "Number of widgets or panels on the dashboard" },
-    refresh_cadence: { type: "string", description: "How often the dashboard data refreshes" },
+    refresh_cadence: { type: "string", enum: ["continuous", "hourly", "daily", "weekly", "monthly", "quarterly", "yearly", "on_demand", "other"], description: "How often the dashboard data refreshes. Uses the shared `Cadence` scale." },
     filter_count: { type: "number", description: "Number of user-configurable filters" }
   },
   // DataClassificationProperties: Data classification.
@@ -8608,7 +8688,7 @@ var UPG_PROPERTY_SCHEMA = {
   },
   // DataProductProperties: DataProduct entity.
   data_product: {
-    data_product_type: { type: "string", description: 'Classification of the data product (e.g. "report", "dataset", "stream")' },
+    data_product_type: { type: "string", enum: ["report", "dataset", "stream", "api", "ml_feature", "other"], description: "Classification of the data product (UPG-579 Option B)." },
     sla_freshness: { type: "string", description: 'Freshness SLA commitment (e.g. "< 1 hour")' }
   },
   // DataQualityRuleProperties: DataQualityRule entity.
@@ -8625,7 +8705,7 @@ var UPG_PROPERTY_SCHEMA = {
   data_source: {
     source_type: { type: "string", enum: ["database", "api", "event_stream", "warehouse"], description: "Kind of data source" },
     connection_status: { type: "string", enum: ["connected", "disconnected", "error"], description: "Current connection health" },
-    refresh_cadence: { type: "string", description: 'How often the data is refreshed (e.g. "hourly", "daily")' }
+    refresh_cadence: { type: "string", enum: ["continuous", "hourly", "daily", "weekly", "monthly", "quarterly", "yearly", "on_demand", "other"], description: "How often the data is refreshed. Uses the shared `Cadence` scale." }
   },
   // DatabaseSchemaProperties: Database schema.
   database_schema: {
@@ -8656,7 +8736,7 @@ var UPG_PROPERTY_SCHEMA = {
   },
   // DeliverableProperties: Deliverable.
   deliverable: {
-    deliverable_type: { type: "string", description: 'Kind of deliverable (e.g. "document", "prototype", "release")' },
+    deliverable_type: { type: "string", enum: ["document", "prototype", "release", "design", "report", "other"], description: "Kind of deliverable (UPG-579 Option B)." },
     due_date: { type: "string", description: "Due date for the deliverable (ISO format)" },
     deliverable_status: { type: "string", enum: ["not_started", "in_progress", "in_review", "accepted", "rejected"], description: "Current progress status" },
     acceptance_criteria: { type: "string", description: "Criteria that must be met for the deliverable to be accepted" }
@@ -8734,7 +8814,18 @@ var UPG_PROPERTY_SCHEMA = {
     target_domain: { type: "string", enum: ["ux", "visual", "interaction", "content", "accessibility", "other"], description: "Target design discipline" },
     framing: { type: "string", enum: ["how_might_we", "what_if", "why_do", "how_do", "what_prevents", "other"], description: "Question framing template" },
     priority: { type: "string", enum: ["urgent", "high", "medium", "low", "none"], description: "Importance against other backlog questions" },
-    confidence: { type: "string", enum: ["high", "medium", "low"], description: "Confidence the question is well-framed. Distinct from confidence in any answer." },
+    confidence: {
+      type: "assessment",
+      scale_id: "confidence_5",
+      description: "Confidence the question is well-framed (UPGAssessment on `confidence_5`). Distinct from confidence in any answer.",
+      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"]
+    },
     assumptions: { type: "string[]", description: "Underlying assumptions. Surfaced explicitly so they can be challenged or validated." },
     validation_method: { type: "string", enum: ["interview", "survey", "usability_test", "analytics", "a_b_test", "prototype_test", "literature_review", "other"], description: "Primary validation method" }
   },
@@ -8761,24 +8852,26 @@ var UPG_PROPERTY_SCHEMA = {
   desired_outcome: {
     statement: { type: "string", description: "Outcome statement in the user's words" },
     importance: {
-      type: "object",
+      type: "assessment",
+      scale_id: "importance_5",
       description: "How important this outcome is to the user (1 = low, 5 = critical)",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
     current_satisfaction: {
-      type: "object",
+      type: "assessment",
+      scale_id: "satisfaction_5",
       description: "How satisfied the user currently is with this outcome (1 = very unsatisfied, 5 = fully satisfied)",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     }
@@ -8896,20 +8989,20 @@ var UPG_PROPERTY_SCHEMA = {
     evidence_source: { type: "string", enum: ["experiment_run", "observation", "quote", "metric_change", "market_data", "interview"], description: "Origin type. Drives renderer + filter UI; the provenance edge (`derived_from_*`) carries the actual source node reference." },
     direction: { type: "string", enum: ["supports", "refutes", "neutral"], description: "Direction relative to the parent hypothesis." },
     weight: {
-      type: "object",
-      description: "Strength (UPGAssessment, scale `weight_5pt`).",
+      type: "assessment",
+      scale_id: "importance_5",
+      description: "Strength (UPGAssessment, scale `scale_5`).",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
     summary: { type: "string", description: "Plain-English summary." },
     observed_at: { type: "string", description: "ISO date observed." },
-    source: { type: "string", description: "Free-text provenance note" },
-    strength: { type: "string", enum: ["strong", "moderate", "weak"], description: "@deprecated since v0.4.0. Use `weight: UPGAssessment`. Simple enum replaced by structured assessment to align with UPG scoring patterns." }
+    source: { type: "string", description: "Free-text provenance note" }
   },
   // ExperimentProperties: A structured activity designed to test a hypothesis.
   experiment: {
@@ -8926,46 +9019,50 @@ var UPG_PROPERTY_SCHEMA = {
     method: { type: "string", enum: ["a_b_test", "multivariate", "qual_interview", "prototype_test", "fake_door", "wizard_of_oz", "longitudinal"], description: "Experimental method. Drives renderer and analysis tooling." },
     success_criteria: { type: "string", description: 'Plain-English description of "passing"' },
     projected_reach: {
-      type: "object",
+      type: "assessment",
+      scale_id: "reach_5",
       description: "Projected reach: how many people the run is expected to touch (UPGAssessment)",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
     projected_impact: {
-      type: "object",
+      type: "assessment",
+      scale_id: "impact_5",
       description: "Projected impact on the target metric (UPGAssessment)",
       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\u20131 value for cross-tool comparison (optional)" }
+        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: "object",
-      description: "Team confidence at plan-time (UPGAssessment, scale `confidence_5pt`)",
+      type: "assessment",
+      scale_id: "confidence_5",
+      description: "Team confidence at plan-time (UPGAssessment, scale `confidence_5`)",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
     cost_estimate: {
-      type: "object",
+      type: "assessment",
+      scale_id: "effort_5",
       description: "Cost estimate at plan-time (UPGAssessment)",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
@@ -8979,13 +9076,14 @@ var UPG_PROPERTY_SCHEMA = {
     actual_reach: { type: "number", description: "Observed reach: how many people the run actually touched" },
     outcome_summary: { type: "string", description: "Plain-English outcome" },
     severity_of_finding: {
-      type: "object",
+      type: "assessment",
+      scale_id: "severity_5",
       description: "Severity / strength of the finding (UPGAssessment)",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
@@ -9004,7 +9102,18 @@ var UPG_PROPERTY_SCHEMA = {
   feasibility_study: {
     study_type: { type: "string", enum: ["technical", "business", "market", "resource"], description: 'Type of feasibility being assessed. @example "technical" for assessing engineering viability' },
     conclusion: { type: "string", enum: ["feasible", "not_feasible", "conditional", "needs_more_data"], description: "Outcome conclusion of the study" },
-    confidence: { type: "string", enum: ["high", "medium", "low"], description: "Confidence in the conclusion" }
+    confidence: {
+      type: "assessment",
+      scale_id: "confidence_5",
+      description: "Confidence in the conclusion (UPGAssessment on `confidence_5`).",
+      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"]
+    }
   },
   // FeatureProperties: A discrete, user-facing capability of the product.
   feature: {
@@ -9039,28 +9148,30 @@ var UPG_PROPERTY_SCHEMA = {
   feature_request: {
     request_source: { type: "string", enum: ["customer", "internal", "prospect", "support", "community"], description: "Where the request originated" },
     vote_count: { type: "number", description: "Number of votes or upvotes from users" },
-    signal_sentiment: { type: "string", enum: ["positive", "negative", "neutral", "mixed"], description: "Detected sentiment of the request" },
+    signal_sentiment: { type: "string", enum: ["positive", "neutral", "negative", "mixed"], description: "Detected sentiment of the request" },
     signal_channel: { type: "string", description: "Channel through which the request was received" },
     signal_urgency: { type: "string", enum: ["low", "medium", "high", "critical"], description: "Perceived urgency of the request" },
     revenue_impact: {
-      type: "object",
+      type: "assessment",
+      scale_id: "impact_5",
       description: "Estimated revenue impact if implemented (1-5)",
       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\u20131 value for cross-tool comparison (optional)" }
+        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_estimate: {
-      type: "object",
+      type: "assessment",
+      scale_id: "effort_5",
       description: "Estimated implementation effort (1-5)",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
@@ -9077,13 +9188,14 @@ var UPG_PROPERTY_SCHEMA = {
     sentiment: { type: "string", enum: ["positive", "neutral", "negative", "mixed"], description: "Overall sentiment across mentions" },
     actionable: { type: "boolean", description: "Whether this theme can be acted upon" },
     frequency: {
-      type: "object",
+      type: "assessment",
+      scale_id: "frequency_5",
       description: "How often the theme is mentioned (1-5)",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
@@ -9101,7 +9213,7 @@ var UPG_PROPERTY_SCHEMA = {
     fix_type: { type: "string", enum: ["hotfix", "permanent", "workaround", "configuration", "process_change"], description: "Kind of fix. `hotfix` = urgent patch. `permanent` = proper structural fix. `workaround` = mitigates symptom without addressing root cause; should track a follow-up." },
     commit: { type: "string", description: "Git commit SHA" },
     files_changed: { type: "string[]", description: "Files changed" },
-    deployed_at: { type: "string", description: "ISO timestamp landed in the target environment. Pairs with `fix_status === 'deployed'`." },
+    deployed_at: { type: "string", description: "ISO timestamp landed in the target environment." },
     fixed_date: { type: "string", description: "Application date (ISO date). Coarser-grained complement to `deployed_at`." },
     verified: { type: "boolean", description: "Verified in production" },
     verified_by_test: { type: "boolean", description: "Validated by an automated regression or integration test. Distinct from `verified` (human judgment)." }
@@ -9111,13 +9223,14 @@ var UPG_PROPERTY_SCHEMA = {
     forecast_period: { type: "string", description: 'Time period the forecast covers (e.g. "Q2 2026")' },
     predicted_revenue: { type: "number", description: "Predicted revenue amount" },
     confidence: {
-      type: "object",
+      type: "assessment",
+      scale_id: "confidence_5",
       description: "Confidence in the prediction (1 = speculative, 5 = high conviction)",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
@@ -9169,13 +9282,14 @@ var UPG_PROPERTY_SCHEMA = {
   hallucination_report: {
     report_type: { type: "string", enum: ["factual", "logical", "fabrication", "inconsistency"], description: "Classification" },
     severity: {
-      type: "object",
+      type: "assessment",
+      scale_id: "severity_5",
       description: "Impact severity (1 = trivial, 5 = dangerous misinformation)",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
@@ -9197,13 +9311,14 @@ var UPG_PROPERTY_SCHEMA = {
     we_know_when: { type: "string", description: "The measurable signal that confirms or refutes the claim." },
     risk_if_wrong: { type: "string", description: "Risk surface for prioritisation if the claim turns out wrong." },
     current_confidence: {
-      type: "object",
+      type: "assessment",
+      scale_id: "confidence_5",
       description: "Team confidence at the current point in time. Derived from the weighted sum of attached `hypothesis_evidence` rows (formula spec'd separately). Authors may set explicitly; loaders may overwrite from derivation.",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     }
@@ -9213,13 +9328,14 @@ var UPG_PROPERTY_SCHEMA = {
     evidence_type: { type: "string", enum: ["experiment_run", "observation", "quote", "metric_change", "market_data", "interview"], description: "Kind of evidence. Drives renderer + filter UI. The provenance edge (`derived_from_*`) carries the actual source node reference per P14; this enum is typing/UI metadata." },
     direction: { type: "string", enum: ["supports", "refutes", "neutral"], description: "Direction relative to the parent claim. Canonical direction axis aligned to `Evidence.direction` so every direction-of-evidence property uses the same vocab. `supports` = paired with the `supports` edge. `refutes` = paired with the `refutes` edge. `neutral` = data insufficient or noisy. BREAKING in v0.4.0: legacy `'confirms'`, `'disconfirms'`, `'inconclusive'` no longer type-check. Migration: `confirms \u2192 supports`, `disconfirms \u2192 refutes`, `inconclusive \u2192 neutral`." },
     weight: {
-      type: "object",
-      description: "Strength of the evidence (UPGAssessment, scale `weight_5pt`).",
+      type: "assessment",
+      scale_id: "importance_5",
+      description: "Strength of the evidence (UPGAssessment, scale `scale_5`).",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
@@ -9237,8 +9353,8 @@ var UPG_PROPERTY_SCHEMA = {
   // IncidentProperties: Incident.
   incident: {
     incident_type: { type: "string", enum: ["operational", "security", "data_breach", "performance", "dependency", "other"], description: 'Discriminator. Absorbs the deprecated `security_incident` type. When `incident_type === \'security\'`, this node replaces the former `security_incident`. @example "security" for a data breach, "operational" for a service outage, "performance" for degradation' },
-    severity_level: { type: "string", enum: ["sev1", "sev2", "sev3", "sev4"], description: 'Severity. `sev1` = critical/system down. `sev2` = major impact. `sev3` = minor impact. `sev4` = minimal impact. @example "sev1" for complete service unavailability' },
-    urgency: { type: "string", enum: ["high", "low"], description: "Notification urgency. Independent of severity. `high` triggers phone calls. `low` sends a message." },
+    severity_level: { type: "string", enum: ["sev1", "sev2", "sev3", "sev4"], description: 'Incident severity tier (paging classification). `sev1` = critical/system down. `sev2` = major impact. `sev3` = minor impact. `sev4` = minimal. Uses the `IncidentSeverity` scale; distinct from user-impact `severity_5`. @example "sev1" for complete service unavailability' },
+    urgency: { type: "string", enum: ["low", "medium", "high", "critical"], description: "Notification urgency. Independent of severity. Uses the shared `SignalUrgency` scale (`low` | `medium` | `high` | `critical`); higher tiers escalate the notification channel." },
     started_at: { type: "string", description: "ISO timestamp the incident started or was first detected." },
     acknowledged_at: { type: "string", description: "ISO timestamp first acknowledged by a responder. Used to compute time-to-acknowledge." },
     contained_at: { type: "string", description: "ISO timestamp contained. Blast radius limited, bleeding stopped. Containment precedes full resolution, especially for security incidents." },
@@ -9264,7 +9380,18 @@ var UPG_PROPERTY_SCHEMA = {
   // InsightProperties: Unified insight, synthesised from evidence and observations.
   insight: {
     insight_level: { type: "string", enum: ["pattern", "finding", "actionable", "strategic"], description: "Maturity level. `pattern` = recurring observation, not yet interpreted. `finding` = interpreted pattern with a clear meaning. `actionable` = finding with a clear next step. `strategic` = finding that affects product direction." },
-    confidence: { type: "string", enum: ["high", "medium", "low"], description: "Confidence. Reflects the strength and diversity of supporting evidence." },
+    confidence: {
+      type: "assessment",
+      scale_id: "confidence_5",
+      description: "Confidence (UPGAssessment on `confidence_5`). Reflects the strength and diversity of supporting evidence.",
+      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"]
+    },
     evidence_count: { type: "number", description: "Supporting observations, quotes, or evidence items. Higher counts increase confidence." },
     novelty: { type: "string", enum: ["known", "surprising", "contradictory"], description: "Novelty against existing knowledge. `known` = confirms what we already believed. `surprising` = challenges or extends our understanding. `contradictory` = directly conflicts with a prior assumption." },
     actionability: { type: "string", enum: ["immediate", "needs_validation", "informational"], description: "Current actionability. `immediate` = clear action, no further research needed. `needs_validation` = promising but requires more evidence. `informational` = important context, no direct action." },
@@ -9302,20 +9429,21 @@ var UPG_PROPERTY_SCHEMA = {
   // InvestigationProperties: Active thread of inquiry: debugging, architecture exploration, RCA.
   investigation: {
     severity: {
-      type: "object",
+      type: "assessment",
+      scale_id: "severity_5",
       description: "Believed severity of the underlying issue. Drives prioritisation across investigations. Canonicalised in v0.4.0: the ad-hoc `'low' | 'medium' | 'high' | 'critical'` shape was replaced by `UPGAssessment` so every \"severity\" property reports on the same axis. Migration: `low \u2192 2`, `medium \u2192 3`, `high \u2192 4`, `critical \u2192 5`.",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
     hypothesis: { type: "string", description: "Working hypothesis about the root cause" },
     findings: { type: "string", description: "Findings discovered so far" },
     started_at: { type: "string", description: "ISO timestamp the investigation began" },
-    resolved_at: { type: "string", description: "ISO timestamp the investigation was concluded. Pairs with `investigation_status === 'resolved' | 'abandoned'`." },
+    resolved_at: { type: "string", description: "ISO timestamp the investigation was concluded. Pairs with `status === 'resolved' | 'abandoned'`." },
     lead_investigator: { type: "string", description: "Lead investigator (email or handle). Distinct from the team owning the affected service." },
     session_id: { type: "string", description: "Originating session" },
     category: { type: "string", enum: ["performance", "security", "data_quality", "reliability", "cost", "compliance", "other"], description: "Kind of issue under investigation. Distinct from `RootCauseProperties.cause_category`, which captures *why something went wrong*." }
@@ -9341,24 +9469,26 @@ var UPG_PROPERTY_SCHEMA = {
     statement: { type: "string", description: 'Job statement: "When I... I want to... So I can..."' },
     job_type: { type: "string", enum: ["functional", "emotional", "social", "supporting"], description: "Classification by motivation dimension" },
     importance: {
-      type: "object",
+      type: "assessment",
+      scale_id: "importance_5",
       description: "Importance to the user (1 = low, 5 = critical)",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
     current_satisfaction: {
-      type: "object",
+      type: "assessment",
+      scale_id: "satisfaction_5",
       description: "Current satisfaction with how this job gets done (1 = very unsatisfied, 5 = fully satisfied)",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
@@ -9376,24 +9506,26 @@ var UPG_PROPERTY_SCHEMA = {
     action_description: { type: "string", description: "Plain-language description. Primary content of the action." },
     channel: { type: "string", enum: ["in-app", "email", "web", "mobile", "phone", "in-person", "sms", "social", "other"], description: "Channel or surface. Keeps service-blueprint columns consistent across the journey." },
     pain_score: {
-      type: "object",
+      type: "assessment",
+      scale_id: "pain_5",
       description: "Pain (1 = effortless, 5 = very painful). Drives opportunity discovery.",
       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\u20131 value for cross-tool comparison (optional)" }
+        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: "object",
+      type: "assessment",
+      scale_id: "impact_5",
       description: "Opportunity (1 = low leverage, 5 = high leverage). Pairs with `pain_score` to rank investment.",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
@@ -9417,24 +9549,26 @@ var UPG_PROPERTY_SCHEMA = {
     touchpoint: { type: "string", description: "Interaction touchpoint" },
     channel: { type: "string", description: 'Channel (e.g. "web", "email", "in-store")' },
     emotion_score: {
-      type: "object",
+      type: "assessment",
+      scale_id: "satisfaction_5",
       description: "User emotion (1 = very negative, 5 = very positive)",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
     friction_score: {
-      type: "object",
+      type: "assessment",
+      scale_id: "pain_5",
       description: "Friction (1 = effortless, 5 = very painful)",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
@@ -9447,7 +9581,7 @@ var UPG_PROPERTY_SCHEMA = {
     cadence: { type: "string", enum: ["continuous", "hourly", "daily", "weekly", "monthly", "quarterly", "yearly", "on_demand", "other"], description: 'Canonical `Cadence`. Replaces the legacy free-form `frequency: string` in v0.4.0. For exact rates (e.g. "3 times per week") set `frequency_count` + `frequency_period`. For qualitative tiers ("rare" \u2192 "constant") use `frequency_rating`.' },
     frequency_count: { type: "number", description: "Exact count of runs in the period. Pairs with `frequency_period`." },
     frequency_period: { type: "string", description: "Recurrence period (ISO-8601 `Duration`, e.g. `'P7D'`)" },
-    frequency_rating: { type: "string", enum: ["rare", "occasional", "regular", "constant", "other"], description: "Qualitative tier. Use when an exact rate is unknown." },
+    frequency_rating: { type: "string", enum: ["constant", "regular", "occasional", "rare", "other"], description: "Qualitative tier. Use when an exact rate is unknown." },
     operational_owner: { type: "string", description: "Operationally accountable team or individual" },
     capacity_constraint: { type: "string", description: "Bottleneck or scaling constraint" },
     automation_level: { type: "string", enum: ["manual", "assisted", "automated"], description: "How much runs without human intervention" }
@@ -9458,13 +9592,14 @@ var UPG_PROPERTY_SCHEMA = {
     criticality: { type: "string", enum: ["urgent", "high", "medium", "low", "none"], description: "Criticality to the business model" },
     owner: { type: "string", description: "Accountable person or team" },
     scarcity_risk: {
-      type: "object",
+      type: "assessment",
+      scale_id: "severity_5",
       description: "Replacement difficulty",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
@@ -9498,7 +9633,6 @@ var UPG_PROPERTY_SCHEMA = {
   // LearningProperties: Result of an experiment. Evidence that updates a hypothesis.
   learning: {
     result: { type: "string", description: "Summary" },
-    metric: { type: "string", description: 'Observed metric. @deprecated since="0.4.0" removeIn="0.5.0". Use the canonical edge `learning_observed_on_metric` to link to the metric structurally. Free-text was the wrong shape: a metric is a queryable graph entity.' },
     result_value: { type: "number", description: "Measured value of the result" },
     result_unit: { type: "string", description: 'Unit (e.g. "%" or "ms")' },
     result_direction: { type: "string", enum: ["supports", "refutes", "neutral"], description: "Direction relative to the parent hypothesis. Canonical direction axis. BREAKING in v0.4.0: legacy `'positive'`, `'negative'`, `'neutral'` are replaced by `'supports'`, `'refutes'`, `'neutral'` to align with `Evidence.direction` and `HypothesisEvidence.direction`. Migration: `positive \u2192 supports`, `negative \u2192 refutes`, `neutral \u2192 neutral`." },
@@ -9554,25 +9688,27 @@ var UPG_PROPERTY_SCHEMA = {
   // MarketTrendProperties: Market trend.
   market_trend: {
     relevance: {
-      type: "object",
+      type: "assessment",
+      scale_id: "importance_5",
       description: "Relevance to our product (1 = low, 5 = critical).",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
     timeframe: { type: "string", description: 'Expected peak or mainstream window. @example "12-18 months", "2027"' },
     impact: {
-      type: "object",
+      type: "assessment",
+      scale_id: "impact_5",
       description: "Expected impact on our market or category.",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
@@ -9683,35 +9819,38 @@ var UPG_PROPERTY_SCHEMA = {
     valence: { type: "string", enum: ["pain", "gap", "constraint"], description: "What kind of experience: pain (friction), gap (unmet), constraint (limitation)" },
     maturity: { type: "string", enum: ["raw", "validated", "prioritized"], description: "How mature is this need in our understanding" },
     frequency: {
-      type: "object",
+      type: "assessment",
+      scale_id: "frequency_5",
       description: "How often the user encounters this need (1 = rarely, 5 = constantly)",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
     severity: {
-      type: "object",
+      type: "assessment",
+      scale_id: "severity_5",
       description: "How painful or disruptive the need is when unaddressed (1 = minor, 5 = critical)",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
     importance: {
-      type: "object",
+      type: "assessment",
+      scale_id: "importance_5",
       description: "How important resolving this need is to the user (1 = low, 5 = critical)",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
@@ -9732,13 +9871,14 @@ var UPG_PROPERTY_SCHEMA = {
     statement: { type: "string", description: "The objection as stated by the source" },
     source_type: { type: "string", enum: ["prospect", "competitor", "internal", "market"], description: "Where this objection originated" },
     severity: {
-      type: "object",
+      type: "assessment",
+      scale_id: "severity_5",
       description: "How frequently or strongly this objection comes up (1-5)",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
@@ -9757,7 +9897,7 @@ var UPG_PROPERTY_SCHEMA = {
     session_ref: { type: "string", description: "Capturing session reference. Convenience field; the canonical relationship to study/session is an edge per P14. Retained as a lightweight context anchor for AI inference." },
     is_highlighted: { type: "boolean", description: "Flagged as a highlight. Absorbed from the deprecated Highlight entity." },
     highlight_tag: { type: "string", description: 'Free-form highlight type tag. @example "pain", "delight", "behaviour", "moment of clarity"' },
-    sentiment: { type: "string", enum: ["positive", "negative", "neutral", "mixed"], description: "Structured sentiment. Tools like Dovetail and EnjoyHQ converge on these four values. More precise than `highlight_tag` for aggregation." }
+    sentiment: { type: "string", enum: ["positive", "neutral", "negative", "mixed"], description: "Structured sentiment. Tools like Dovetail and EnjoyHQ converge on these four values. More precise than `highlight_tag` for aggregation." }
   },
   // OnCallRotationProperties: On-call rotation.
   on_call_rotation: {
@@ -9769,35 +9909,38 @@ var UPG_PROPERTY_SCHEMA = {
   // OpportunityProperties: A problem worth solving, grounded in user need and business value
   opportunity: {
     reach: {
-      type: "object",
+      type: "assessment",
+      scale_id: "reach_5",
       description: "How many users experience this problem",
       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\u20131 value for cross-tool comparison (optional)" }
+        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: "object",
+      type: "assessment",
+      scale_id: "frequency_5",
       description: "How often users experience this problem",
       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\u20131 value for cross-tool comparison (optional)" }
+        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: "object",
+      type: "assessment",
+      scale_id: "pain_5",
       description: "How painful it is when unaddressed",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
@@ -9818,17 +9961,18 @@ var UPG_PROPERTY_SCHEMA = {
     current_state: { type: "string", description: "Baseline or latest read" },
     evidence_summary: { type: "string", description: "Evidence gathered so far (quotes, metrics, studies)" },
     confidence: {
-      type: "object",
+      type: "assessment",
+      scale_id: "confidence_5",
       description: "Confidence this is the right outcome to pursue",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
-    outcome_status: { type: "string", description: "Current lifecycle phase. Free-form until an outcome lifecycle is defined in `grammar/lifecycles.ts`." }
+    outcome_status: { type: "string", enum: ["identified", "measuring", "achieved", "abandoned"], description: "Current lifecycle phase, mirroring the `outcome` lifecycle in `grammar/lifecycles.ts` (UPG-579 Option B): `identified` -> `measuring` -> `achieved` | `abandoned`." }
   },
   // ParticipantProperties: Research participant.
   participant: {
@@ -9859,13 +10003,14 @@ var UPG_PROPERTY_SCHEMA = {
     value_exchange: { type: "string", description: "What each party gives and receives" },
     partnership_tier: { type: "string", enum: ["strategic", "preferred", "standard", "trial"], description: "Commercial significance. Drives attention and exec sponsorship." },
     risk_level: {
-      type: "object",
+      type: "assessment",
+      scale_id: "severity_5",
       description: "Exposure if the partnership fails (concentration risk, IP risk, etc.)",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
@@ -9906,7 +10051,7 @@ var UPG_PROPERTY_SCHEMA = {
   },
   // PipelineSalesProperties: Sales pipeline.
   pipeline_sales: {
-    pipeline_type: { type: "string", description: 'Classification of the pipeline (e.g. "new business", "expansion")' },
+    pipeline_type: { type: "string", enum: ["new_business", "expansion", "renewal", "partner", "other"], description: "Classification of the pipeline (UPG-579 Option B)." },
     avg_cycle_days: { type: "number", description: "Average days from opportunity creation to close" }
   },
   // PipelineStageProperties: Pipeline stage.
@@ -9948,7 +10093,7 @@ var UPG_PROPERTY_SCHEMA = {
   // PricingStrategyProperties: Pricing strategy.
   pricing_strategy: {
     strategy_type: { type: "string", enum: ["value_based", "cost_plus", "competitor_based", "penetration", "freemium"], description: "Pricing methodology used" },
-    review_cadence: { type: "string", description: "How often pricing is reviewed" },
+    review_cadence: { type: "string", enum: ["continuous", "hourly", "daily", "weekly", "monthly", "quarterly", "yearly", "on_demand", "other"], description: "How often pricing is reviewed. Uses the shared `Cadence` scale." },
     last_change: { type: "string", description: "Date of the last pricing change (ISO format)" }
   },
   // PricingTierProperties: PricingTier: the central pricing concept (the plan a customer buys).
@@ -10057,13 +10202,14 @@ var UPG_PROPERTY_SCHEMA = {
   rebuttal: {
     statement: { type: "string", description: "The counter-argument or response to an objection" },
     strength: {
-      type: "object",
+      type: "assessment",
+      scale_id: "scale_5",
       description: "How convincing this rebuttal is (1-5)",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
@@ -10156,24 +10302,26 @@ var UPG_PROPERTY_SCHEMA = {
   risk: {
     risk_type: { type: "string", enum: ["technical", "business", "legal", "security", "operational"], description: "Domain the risk belongs to" },
     probability: {
-      type: "object",
+      type: "assessment",
+      scale_id: "confidence_5",
       description: "How likely this risk is to materialise (1 = unlikely, 5 = near certain)",
       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\u20131 value for cross-tool comparison (optional)" }
+        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: "object",
+      type: "assessment",
+      scale_id: "impact_5",
       description: "Severity of consequences if the risk materialises (1 = negligible, 5 = catastrophic)",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
@@ -10194,7 +10342,18 @@ var UPG_PROPERTY_SCHEMA = {
     quarter: { type: "string", description: 'Planning quarter (e.g. "Q2 2026"). Pair with `start_date`/`target_date` for precise scheduling.' },
     priority: { type: "string", enum: ["urgent", "high", "medium", "low", "none"], description: "Importance against other items" },
     item_status: { type: "string", enum: ["planned", "in_progress", "shipped", "deferred"], description: "Status. `deferred` = explicitly pushed to a later period." },
-    confidence: { type: "string", enum: ["high", "medium", "low"], description: "Delivery confidence within the planned period." },
+    confidence: {
+      type: "assessment",
+      scale_id: "confidence_5",
+      description: "Delivery confidence within the planned period (UPGAssessment on `confidence_5`).",
+      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"]
+    },
     start_date: { type: "string", description: "ISO date work begins. More precise than `quarter` for continuous planning." },
     target_date: { type: "string", description: "ISO date completion is expected. For shipped items, the actual completion date." }
   },
@@ -10208,13 +10367,14 @@ var UPG_PROPERTY_SCHEMA = {
   // RootCauseProperties: Underlying architectural or systemic issue.
   root_cause: {
     severity: {
-      type: "object",
+      type: "assessment",
+      scale_id: "severity_5",
       description: "Severity (1 = minor, 5 = critical)",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
@@ -10264,13 +10424,14 @@ var UPG_PROPERTY_SCHEMA = {
   security_control: {
     control_type: { type: "string", enum: ["preventive", "detective", "corrective", "compensating"], description: "Functional role. `preventive` = stops attacks (MFA, input validation). `detective` = identifies attacks in progress (intrusion detection, audit logs). `corrective` = reduces impact after an attack (incident response, backup restore). `compensating` = alternative when primary isn't feasible." },
     effectiveness: {
-      type: "object",
+      type: "assessment",
+      scale_id: "impact_5",
       description: "Mitigation effectiveness (1 = minimal, 5 = fully effective)",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
@@ -10281,7 +10442,7 @@ var UPG_PROPERTY_SCHEMA = {
   // SecurityPolicyProperties: Security policy.
   security_policy: {
     scope: { type: "string", description: "Systems or processes covered" },
-    review_cadence: { type: "string", description: 'Review cadence (e.g. "annually", "quarterly")' },
+    review_cadence: { type: "string", enum: ["continuous", "hourly", "daily", "weekly", "monthly", "quarterly", "yearly", "on_demand", "other"], description: "Review cadence (e.g. `yearly`, `quarterly`). Uses the shared `Cadence` scale." },
     version: { type: "string", description: "Version" },
     effective_date: { type: "string", description: "ISO effective date" },
     url: { type: "string", description: "Policy document URL" },
@@ -10352,17 +10513,18 @@ var UPG_PROPERTY_SCHEMA = {
   },
   // SkillProperties: Skill entity.
   skill: {
-    skill_category: { type: "string", description: 'Category of the skill (e.g. "technical", "leadership", "design")' },
+    skill_category: { type: "string", enum: ["technical", "leadership", "design", "product", "business", "operations", "other"], description: "Category of the skill (UPG-579 Option B)." },
     proficiency_levels: { type: "string[]", description: "Description of proficiency levels for this skill" },
     domain: { type: "string", description: 'Problem domain the skill applies to (e.g. "payments", "accessibility")' },
     rarity: {
-      type: "object",
+      type: "assessment",
+      scale_id: "scale_5",
       description: "How scarce this skill is in the labour market this team hires from",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
@@ -10378,46 +10540,50 @@ var UPG_PROPERTY_SCHEMA = {
   solution: {
     timeline: { type: "string", description: "Estimated delivery or target timeline" },
     reach: {
-      type: "object",
+      type: "assessment",
+      scale_id: "reach_5",
       description: "How many users this solution reaches (1 = few, 5 = most)",
       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\u20131 value for cross-tool comparison (optional)" }
+        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: "object",
+      type: "assessment",
+      scale_id: "impact_5",
       description: "Expected impact on the target outcome (1 = minimal, 5 = transformative)",
       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\u20131 value for cross-tool comparison (optional)" }
+        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: "object",
+      type: "assessment",
+      scale_id: "confidence_5",
       description: "How confident the team is in this solution (1 = speculative, 5 = proven)",
       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\u20131 value for cross-tool comparison (optional)" }
+        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: "object",
+      type: "assessment",
+      scale_id: "effort_5",
       description: "Level of effort required to implement (1 = trivial, 5 = very large)",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
@@ -10427,24 +10593,26 @@ var UPG_PROPERTY_SCHEMA = {
   stakeholder: {
     stakeholder_type: { type: "string", enum: ["internal", "external", "investor", "regulator"], description: "Relationship of the stakeholder to the organisation" },
     influence: {
-      type: "object",
+      type: "assessment",
+      scale_id: "importance_5",
       description: "How much influence this stakeholder has over decisions (1 = minimal, 5 = decisive)",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
     interest: {
-      type: "object",
+      type: "assessment",
+      scale_id: "importance_5",
       description: "How much interest this stakeholder has in the outcome (1 = passive, 5 = deeply invested)",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     }
@@ -10456,19 +10624,6 @@ var UPG_PROPERTY_SCHEMA = {
     risks_flagged: { type: "number", description: "Number of risks flagged in this report" },
     blockers: { type: "string", description: "Description of current blockers" }
   },
-  // UserStoryProperties: "As X, I want Y so Z" templated promise, a user story (UCS pattern P5).
-  user_story: {
-    as_a: { type: "string", description: '"As a [persona], \u2026". Free-text persona name or slug ref.' },
-    i_want_to: { type: "string", description: "Capability or action the persona wants." },
-    so_that: { type: "string", description: "Benefit or outcome the persona expects." },
-    text: { type: "string", description: "Free-form story text. Used as a single-line rendered view." }
-  },
-  // StoryTaskProperties
-  story_task: {
-    estimate: { type: "string", description: "@deprecated Use TaskProperties.estimate" },
-    effort: { type: "number", description: "@deprecated Use TaskProperties.effort (string form)" },
-    priority: { type: "string", enum: ["urgent", "high", "medium", "low", "none"], description: "@deprecated Use TaskProperties.priority" }
-  },
   // StrategicPillarProperties: StrategicPillar entity. Durable multi-year direction the product commits to.
   strategic_pillar: {
     owner: { type: "string", description: "Owning person or team" },
@@ -10502,19 +10657,20 @@ var UPG_PROPERTY_SCHEMA = {
   support_ticket: {
     ticket_type: { type: "string", enum: ["bug", "question", "feature_request"], description: "Classification of the ticket" },
     severity: {
-      type: "object",
+      type: "assessment",
+      scale_id: "severity_5",
       description: "Impact severity of the issue (1 = cosmetic, 5 = service down)",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
     resolution: { type: "string", description: "Description of how the ticket was resolved" },
     source: { type: "string", description: 'Where the ticket originated (e.g. "email", "in-app", "chat")' },
-    signal_sentiment: { type: "string", enum: ["positive", "negative", "neutral", "mixed"], description: "Detected sentiment of the customer's message" },
+    signal_sentiment: { type: "string", enum: ["positive", "neutral", "negative", "mixed"], description: "Detected sentiment of the customer's message" },
     signal_channel: { type: "string", description: "Channel through which the signal was received" },
     signal_urgency: { type: "string", enum: ["low", "medium", "high", "critical"], description: "Perceived urgency of the customer's request" }
   },
@@ -10535,19 +10691,20 @@ var UPG_PROPERTY_SCHEMA = {
     symptom_description: { type: "string", description: "Plain-language description of observed behaviour. Primary content of the entity." },
     first_observed_at: { type: "string", description: "ISO timestamp first observed in the wild. Pairs with `frequency_rating` and `reproducibility` for triage." },
     severity: {
-      type: "object",
+      type: "assessment",
+      scale_id: "severity_5",
       description: "Severity for affected users. Independent of how widespread the symptom is. Canonicalised in v0.4.0: the ad-hoc `'low' | 'medium' | 'high' | 'critical'` shape was replaced by `UPGAssessment`.",
       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\u20131 value for cross-tool comparison (optional)" }
+        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_count: { type: "number", description: "Exact observation count in the period. Pairs with `frequency_period` for a precise rate." },
     frequency_period: { type: "string", description: "Recurrence period (ISO-8601 `Duration`). @example 'P7D' (per week), 'P1D' (per day), 'PT1H' (per hour)" },
-    frequency_rating: { type: "string", enum: ["rare", "occasional", "regular", "constant", "other"], description: "Qualitative frequency tier. Canonical replacement for the legacy `'once' | 'sporadic' | 'frequent' | 'constant' | string` shape. Use when an exact rate is unknown. Migration: `once \u2192 rare`, `sporadic \u2192 occasional`, `frequent \u2192 regular`, `constant \u2192 constant`." },
+    frequency_rating: { type: "string", enum: ["constant", "regular", "occasional", "rare", "other"], description: "Qualitative frequency tier. Canonical replacement for the legacy `'once' | 'sporadic' | 'frequent' | 'constant' | string` shape. Use when an exact rate is unknown. Migration: `once \u2192 rare`, `sporadic \u2192 occasional`, `frequent \u2192 regular`, `constant \u2192 constant`." },
     affected_users_estimate: { type: "number", description: "Approximate count of users affected. Snapshot estimate." },
     reproducibility: { type: "string", enum: ["always", "frequent", "intermittent", "rare", "once"], description: "Reproduction reliability" },
     steps_to_reproduce: { type: "string", description: "Steps to reproduce" }
@@ -10560,7 +10717,6 @@ var UPG_PROPERTY_SCHEMA = {
   },
   // TaskProperties: Task: a discrete unit of work, smaller than a story.
   task: {
-    task_status: { type: "string", enum: ["todo", "in_progress", "in_review", "done"], description: "@deprecated since v0.4.0. Use top-level `UPGBaseNode.status`. Values map identically: todo | in_progress | in_review | done. Migration: `UPG_PROPERTY_MIGRATIONS['0.4.0']` lifts this to `status`." },
     assignee: { type: "string", description: "Assigned person" },
     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" },
@@ -10585,24 +10741,26 @@ var UPG_PROPERTY_SCHEMA = {
   technical_debt_item: {
     debt_type: { type: "string", enum: ["code", "architecture", "security", "test", "docs", "dependency"], description: "Type of debt. `code` = quality issues. `architecture` = structural problems. `security` = unpatched vulnerabilities. `test` = missing/flaky tests. `docs` = missing or stale documentation. `dependency` = outdated packages." },
     severity: {
-      type: "object",
+      type: "assessment",
+      scale_id: "severity_5",
       description: "Severity on system or team. Requires human evaluation.",
       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\u20131 value for cross-tool comparison (optional)" }
+        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_to_fix: {
-      type: "object",
+      type: "assessment",
+      scale_id: "effort_5",
       description: "Estimated effort to resolve. Requires team knowledge of the codebase.",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
@@ -10685,24 +10843,26 @@ var UPG_PROPERTY_SCHEMA = {
   threat: {
     category: { type: "string", description: 'Attack or threat scenario. @example "injection", "misconfiguration", "social engineering", "supply chain"' },
     likelihood: {
-      type: "object",
+      type: "assessment",
+      scale_id: "confidence_5",
       description: "Likelihood (1 = theoretical, 5 = actively exploited). @example value 5 for a known, exploitable, commonly targeted pattern",
       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\u20131 value for cross-tool comparison (optional)" }
+        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: "object",
+      type: "assessment",
+      scale_id: "impact_5",
       description: "Impact (1 = minimal, 5 = catastrophic). @example value 5 for threats that expose PII or cause complete service compromise",
       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\u20131 value for cross-tool comparison (optional)" }
+        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"]
     },
@@ -10760,7 +10920,7 @@ var UPG_PROPERTY_SCHEMA = {
   // UserAdvisoryBoardProperties: User advisory board.
   user_advisory_board: {
     member_count: { type: "number", description: "Number of members on the board" },
-    meeting_cadence: { type: "string", description: 'How often the board meets (e.g. "monthly", "quarterly")' },
+    meeting_cadence: { type: "string", enum: ["continuous", "hourly", "daily", "weekly", "monthly", "quarterly", "yearly", "on_demand", "other"], description: "How often the board meets. Uses the shared `Cadence` scale." },
     board_focus: { type: "string", description: "Primary topic or area the board advises on" }
   },
   // UserFlowProperties: User flow.
@@ -10776,6 +10936,13 @@ var UPG_PROPERTY_SCHEMA = {
     journey_type: { type: "string", enum: ["current_state", "future_state", "day_in_the_life", "service_blueprint"], description: "Maps current or future state" },
     scenario: { type: "string", description: "Scenario context" }
   },
+  // UserStoryProperties: "As X, I want Y so Z" templated promise on a user story (UCS pattern P5).
+  user_story: {
+    as_a: { type: "string", description: '"As a [persona], \u2026". Free-text persona name or slug ref.' },
+    i_want_to: { type: "string", description: "Capability or action the persona wants." },
+    so_that: { type: "string", description: "Benefit or outcome the persona expects." },
+    text: { type: "string", description: "Free-form story text. Used as a single-line rendered view." }
+  },
   // ValueObjectProperties: DDD value object.
   value_object: {
     immutable: { type: "boolean", description: "Whether immutable" },
@@ -10790,7 +10957,7 @@ var UPG_PROPERTY_SCHEMA = {
   },
   // ValueStreamProperties: ValueStream entity.
   value_stream: {
-    stream_stage: { type: "string", description: "Current stage in the value delivery pipeline" },
+    stream_stage: { type: "string", enum: ["discovery", "definition", "build", "delivery", "operation", "other"], description: "Current stage in the value delivery pipeline (UPG-579 Option B)." },
     lead_time: { type: "string", description: 'End-to-end lead time. @example "2 weeks"' },
     throughput: { type: "string", description: 'Throughput measure. @example "5 features/sprint"' }
   },
@@ -10810,7 +10977,18 @@ var UPG_PROPERTY_SCHEMA = {
   vulnerability: {
     cve_id: { type: "string", description: 'CVE identifier from the National Vulnerability Database. @example "CVE-2024-1234"' },
     cvss_score: { type: "number", description: "CVSS numeric score (0.0\u201310.0). Computed from the CVSS vector. Distinct from the categorical `severity`. @example 9.8 (critical), 6.5 (medium), 3.7 (low)" },
-    severity: { type: "string", enum: ["critical", "high", "medium", "low", "informational"], description: 'Categorical severity derived from CVSS. `critical` = 9.0\u201310.0. `high` = 7.0\u20138.9. `medium` = 4.0\u20136.9. `low` = 0.1\u20133.9. `informational` = 0.0. Score alone is insufficient for triage; severity drives filtering and prioritisation. @example "critical" for a remotely exploitable, no-auth-required vulnerability' },
+    severity: {
+      type: "assessment",
+      scale_id: "severity_5",
+      description: "Categorical severity derived from CVSS. Impact severity (UPGAssessment on the `severity_5` scale). Score alone is insufficient for triage; severity drives filtering and prioritisation. Migrated from the inline `critical|high|medium|low|informational` enum (UPG-579 Option C): map `critical` -> 5, `high` -> 4, `medium` -> 3, `low` -> 2, `informational` -> 1; carry the old word in `label`. @example value 5, label 'Critical', scale_id 'severity_5' (a remotely exploitable, no-auth vuln)",
+      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"]
+    },
     cvss_version: { type: "string", enum: ["v3.1", "v4.0"], description: 'CVSS scoring version. v3.1 and v4.0 differ significantly for the same vulnerability. @example "v4.0" for vulnerabilities scored after the v4.0 release in 2023' },
     affected_component: { type: "string", description: 'Affected component, library, or system. @example "lodash", "openssl", "login service"' },
     affected_package: { type: "string", description: 'Affected package with version. More precise than `affected_component`. @example "lodash@4.17.20", "openssl@1.1.1q"' },
@@ -15446,6 +15624,7 @@ var STRATEGY_OUTCOMES_PLAYBOOK = {
   description: "Cascade vision through themes, outcomes, objectives, key results, and the bets you are making to get there.",
   region: "strategy_outcomes",
   is_canonical: true,
+  related_framework_ids: ["okr-framework", "three-horizons", "north-star-metric", "metrics-tree", "wardley-map"],
   target_anchor_entity: "objective",
   creation_sequence: [
     seqStep(
@@ -15500,6 +15679,7 @@ var USERS_NEEDS_PLAYBOOK = {
   description: "Bootstrap personas, jobs, needs, and desired outcomes: the user side of every product graph.",
   region: "users_needs",
   is_canonical: true,
+  related_framework_ids: ["persona-canvas", "empathy-map", "value-proposition-canvas", "kano-model"],
   target_anchor_entity: "persona",
   creation_sequence: [
     seqStep(
@@ -15553,6 +15733,7 @@ var DISCOVERY_RESEARCH_VALIDATION_PLAYBOOK = {
   description: "Evidence-first discovery sequence: plan \u2192 recruit \u2192 observe \u2192 synthesize \u2192 insight \u2192 opportunity \u2192 hypothesis \u2192 test.",
   region: "discovery_research_validation",
   is_canonical: true,
+  related_framework_ids: ["double-diamond", "opportunity-solution-tree", "build-measure-learn", "hypothesis-board"],
   target_anchor_entity: "opportunity",
   creation_sequence: [
     seqStep(
@@ -15629,6 +15810,7 @@ var MARKET_COMPETITIVE_PLAYBOOK = {
   description: "Map the competitive landscape: define the market, name the alternatives, read trends, find moves.",
   region: "market_competitive",
   is_canonical: true,
+  related_framework_ids: ["porter-five-forces", "swot-analysis", "value-chain-analysis", "wardley-map", "bullseye-framework"],
   target_anchor_entity: "competitor",
   creation_sequence: [
     seqStep(
@@ -15676,6 +15858,7 @@ var EXPERIENCE_DESIGN_BRAND_PLAYBOOK = {
   description: "Journey-first design sequence: research \u2192 personas \u2192 journeys \u2192 define \u2192 ideate \u2192 prototype \u2192 test \u2192 design system.",
   region: "experience_design_brand",
   is_canonical: true,
+  related_framework_ids: ["double-diamond", "atomic-design", "story-map"],
   target_anchor_entity: "user_journey",
   creation_sequence: [
     seqStep(
@@ -15783,6 +15966,7 @@ var PRODUCT_DELIVERY_PLAYBOOK = {
   description: "Shape what gets built: features, epics, user stories, releases, milestones, and the dependencies between them.",
   region: "product_delivery",
   is_canonical: true,
+  related_framework_ids: ["story-map", "rice-scoring", "moscow", "now-next-later", "shape-up", "kano-model"],
   target_anchor_entity: "feature",
   creation_sequence: [
     seqStep(
@@ -15846,6 +16030,7 @@ var ENGINEERING_PLATFORM_PLAYBOOK = {
   description: "Architecture-first engineering sequence: architecture \u2192 services \u2192 data \u2192 build \u2192 test \u2192 deploy \u2192 monitor \u2192 security.",
   region: "engineering_platform",
   is_canonical: true,
+  related_framework_ids: ["c4-model", "adr-log", "dora-metrics"],
   target_anchor_entity: "service",
   creation_sequence: [
     seqStep(
@@ -15920,6 +16105,7 @@ var BUSINESS_GTM_GROWTH_PLAYBOOK = {
   description: "Viability-first business sequence: value prop \u2192 customer \u2192 revenue \u2192 costs \u2192 unit economics \u2192 GTM \u2192 competitive advantage.",
   region: "business_gtm_growth",
   is_canonical: true,
+  related_framework_ids: ["business-model-canvas", "pirate-metrics-aarrr", "north-star-metric", "product-led-growth-framework", "marketing-mix-4ps"],
   target_anchor_entity: "value_proposition",
   creation_sequence: [
     seqStep(
@@ -16139,6 +16325,7 @@ var ANALYTICS_DATA_PLAYBOOK = {
   description: "Bootstrap the measurement plane: sources, schemas, pipelines, metrics, dashboards, and the rules that keep them honest.",
   region: "analytics_data",
   is_canonical: true,
+  related_framework_ids: ["metrics-tree", "north-star-metric", "pirate-metrics-aarrr", "dora-metrics"],
   target_anchor_entity: "metric",
   creation_sequence: [
     seqStep(
@@ -16186,6 +16373,7 @@ var OPERATIONS_QUALITY_PLAYBOOK = {
   description: "The operational backbone: pipelines, monitoring, incident response, security, quality gates, compliance, support. Specialised playbooks cover team rituals.",
   region: "operations_quality",
   is_canonical: true,
+  related_framework_ids: ["raci-matrix", "retrospective", "team-health-check", "raid-log"],
   target_anchor_entity: "incident",
   creation_sequence: [
     seqStep(
@@ -22762,7 +22950,7 @@ function serializePortfolioWithHeader(doc, opts) {
   header.integrity = { algorithm: INTEGRITY_ALGORITHM, body: computeBodyChecksum(doc) };
   return JSON.stringify({ $upg: header, ...body }, null, 2) + "\n";
 }
-var UPG_VERSION = "0.7.3";
+var UPG_VERSION = "0.8.0";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();
 var UPG_TYPES_SET = new Set(UPG_TYPES);
@@ -23011,6 +23199,62 @@ var getGraphDigest = (args, ctx) => {
   }
   return text(JSON.stringify({ ...digest, lens: sessionContext.lens, lens_digest: lensDigest, _hash: currentHash }, null, 2));
 };
+var YOUNG_GRAPH_THRESHOLD = 8;
+var start = (_args, ctx) => {
+  const { store } = ctx;
+  const allNodes = store.getAllNodes();
+  const realNodes = allNodes.filter((n) => n.type !== "product");
+  const nodeCount = realNodes.length;
+  const product = store.getProduct();
+  const presentTypes = new Set(allNodes.map((n) => n.type));
+  const productInfo = product ? { title: product.title, stage: product.stage ?? null } : null;
+  const state = nodeCount === 0 ? "empty" : nodeCount < YOUNG_GRAPH_THRESHOLD ? "young" : "established";
+  if (state === "established") {
+    return text(
+      JSON.stringify(
+        {
+          graph_state: state,
+          product: productInfo,
+          node_count: nodeCount,
+          recommendation: `Graph is established (${nodeCount} entities). Use plan for the missing-entities backlog, inspect for issues, and get_graph_digest for health.`,
+          next_tools: ["plan", "inspect", "get_graph_digest"]
+        },
+        null,
+        2
+      )
+    );
+  }
+  const canonicalPlaybooks = UPG_PLAYBOOKS.filter((p) => p.is_canonical === true);
+  const recommend = canonicalPlaybooks.find(
+    (p) => p.target_anchor_entity ? !presentTypes.has(p.target_anchor_entity) : true
+  ) ?? canonicalPlaybooks[0];
+  const response = {
+    graph_state: state,
+    product: productInfo,
+    node_count: nodeCount
+  };
+  if (recommend) {
+    const anchor = recommend.target_anchor_entity;
+    response.recommended_playbook = {
+      id: recommend.id,
+      name: recommend.name,
+      region: recommend.region,
+      target_anchor_entity: anchor ?? null,
+      description: recommend.description
+    };
+    if (anchor) {
+      response.first_action = {
+        tool: "create_node",
+        args: { type: anchor, title: `<your first ${anchor}>` }
+      };
+    }
+    response.recommendation = state === "empty" ? `Your graph is empty. Begin with the "${recommend.name}" playbook${anchor ? `: create your first ${anchor}` : ""}. Open the full sequence with get_playbook("${recommend.id}").` : `You have ${nodeCount} ${nodeCount === 1 ? "entity" : "entities"}. Continue with the "${recommend.name}" playbook${anchor ? `: add a ${anchor}` : ""}. Use plan for the full missing-entities backlog.`;
+  } else {
+    response.recommendation = "No canonical playbooks available. Use plan to see the missing-entities backlog.";
+  }
+  response.next_tools = state === "empty" ? ["get_playbook", "create_node", "list_playbooks"] : ["plan", "get_playbook", "get_graph_digest"];
+  return text(JSON.stringify(response, null, 2));
+};
 var getSessionContext = (_args, ctx) => {
   const { sessionContext } = ctx;
   const recommendationsToAvoid = Array.from(
@@ -23738,6 +23982,21 @@ function buildFirstUseHints(canonicalType) {
   if (edgesOut.length > 0) hints.canonical_edges_out = edgesOut;
   return hints;
 }
+function buildOrphanWarning(canonicalType) {
+  let schema;
+  try {
+    schema = buildEntitySchema(canonicalType);
+  } catch {
+    return void 0;
+  }
+  const guide = schema.domain_guide;
+  if (!guide || guide.position_in_sequence <= 0) return void 0;
+  const anchor = guide.anchor_entity;
+  if (!anchor || anchor === canonicalType) return void 0;
+  const edge = resolveContainmentEdge(anchor, canonicalType);
+  const via = edge ? ` (canonical edge: ${edge})` : "";
+  return `Orphan: created ${canonicalType} with no parent. ${canonicalType} typically attaches under ${anchor}${via}. Pass parent_id on create, or wire it later with create_edge.`;
+}
 var createNode = async (args, ctx) => {
   const { store } = ctx;
   if (!args.type) return textError(`Missing required parameter: type`);
@@ -23804,6 +24063,10 @@ var createNode = async (args, ctx) => {
     const aggregatedWarnings = [];
     if (warning) aggregatedWarnings.push(warning);
     if (lengthWarnings.length > 0) aggregatedWarnings.push(...lengthWarnings);
+    if (!args.parent_id && !result.edge) {
+      const orphanWarning = buildOrphanWarning(result.node.type);
+      if (orphanWarning) aggregatedWarnings.push(orphanWarning);
+    }
     const libWarning = result.warning;
     const combinedWarning = libWarning ? aggregatedWarnings.length > 0 ? `${libWarning} | ${aggregatedWarnings.join(" | ")}` : libWarning : aggregatedWarnings.length > 0 ? aggregatedWarnings.join(" | ") : void 0;
     if (unknown_properties.length > 0 || combinedWarning || hints) {
@@ -26753,6 +27016,14 @@ var TOOL_DEFINITIONS = [
       }
     }
   },
+  {
+    name: "start",
+    description: 'Zero-state on-ramp: "there is nothing here yet, where do I begin?". Reads the live graph and, for an empty or barely-started graph, recommends the first canonical playbook (from UPG_PLAYBOOKS) plus the exact create_node call for its anchor entity. Established graphs are routed to plan / inspect / get_graph_digest instead. Takes no arguments.',
+    inputSchema: {
+      type: "object",
+      properties: {}
+    }
+  },
   {
     name: "list_nodes",
     description: "List entities with filtering, edge inclusion, count-only mode, and pagination. For graph-wide edge enumeration, prefer `export_edges` (flat) or `query` (traversal). `list_nodes(include_edges:true)` is for entity-scoped reads.",
@@ -28052,6 +28323,7 @@ var TOOL_DEFINITIONS = [
 var HANDLERS = {
   get_product_context: getProductContext,
   get_graph_digest: getGraphDigest,
+  start,
   list_nodes: listNodes,
   get_node: getNode,
   get_nodes: getNodes,