@unified-product-graph/core 0.7.5 → 0.8.0

package/dist/index.js

@@ -6159,20 +6159,42 @@ var PROPERTY_SCALE_MAP = {
   // discovery, users, feedback
   // ── Severity ─────────────────────────────────────────────────────────────
   severity: "severity_5",
-  // users, engineering, ai, gtm, customer-success
+  // users, engineering, ai, gtm, customer-success, security, accessibility
   severity_of_finding: "severity_5",
   // validation/experiment_run
+  bug_severity: "severity_5",
+  // product-spec/bug (UPG-579 Option C collapse)
+  risk_level: "severity_5",
+  // compliance/risk (UPG-579 Option B)
+  scarcity_risk: "severity_5",
+  // market-intelligence (UPG-579 Option B)
   // ── Pain ─────────────────────────────────────────────────────────────────
   pain: "pain_5",
   // discovery
+  pain_score: "pain_5",
+  // user (UPG-579 Option B)
+  friction_score: "pain_5",
+  // growth/ux (UPG-579 Option B)
   // ── Impact ───────────────────────────────────────────────────────────────
   impact: "impact_5",
   // discovery, market, security, compliance
   projected_impact: "impact_5",
   // validation/experiment_plan
+  revenue_impact: "impact_5",
+  // sales/business-model (UPG-579 Option B)
+  effectiveness: "impact_5",
+  // security/marketing (UPG-579 Option B)
+  opportunity_score: "impact_5",
+  // discovery/opportunity (UPG-579 Option B)
   // ── Confidence ───────────────────────────────────────────────────────────
   confidence: "confidence_5",
   // discovery, validation, sales, product-spec
+  current_confidence: "confidence_5",
+  // validation/hypothesis (UPG-579 Option B)
+  likelihood: "confidence_5",
+  // market/risk (UPG-579 Option B)
+  probability: "confidence_5",
+  // sales/forecast (UPG-579 Option B)
   // ── Effort ───────────────────────────────────────────────────────────────
   effort: "effort_5",
   // discovery
@@ -6180,17 +6202,35 @@ var PROPERTY_SCALE_MAP = {
   // feedback
   effort_to_fix: "effort_5",
   // engineering
+  cost_estimate: "effort_5",
+  // validation/experiment_plan (UPG-579 Option B)
   // ── Importance ───────────────────────────────────────────────────────────
   importance: "importance_5",
   // users
+  influence: "importance_5",
+  // team-org/stakeholder (UPG-579 Option B)
+  interest: "importance_5",
+  // team-org/stakeholder (UPG-579 Option B)
+  relevance: "importance_5",
+  // market/content (UPG-579 Option B)
+  weight: "importance_5",
+  // validation/evidence (UPG-579 Option B)
   // ── Satisfaction ─────────────────────────────────────────────────────────
-  current_satisfaction: "satisfaction_5"
+  current_satisfaction: "satisfaction_5",
   // users
+  emotion_score: "satisfaction_5"
+  // ux-design/customer-success journey (UPG-579 Option B)
+  // Intentionally NOT mapped (resolve to the generic scale_5):
+  //   rarity   : VRIO distinctiveness; no canonical named scale fits.
+  //   strength : deprecated (validation/evidence; superseded by weight).
 };
 var DEFAULT_SCALE_ID = "scale_5";
 function getPropertyDefaultScale(_entityType, propertyName) {
   return PROPERTY_SCALE_MAP[propertyName] ?? DEFAULT_SCALE_ID;
 }
+function getPropertiesForScale(scaleId) {
+  return Object.entries(PROPERTY_SCALE_MAP).filter(([, id]) => id === scaleId).map(([property]) => property);
+}
 
 // src/grammar/enum-scales.ts
 var UPG_ENUM_SCALES = {
@@ -6276,6 +6316,159 @@ var UPG_ENUM_SCALES = {
       { value: "warning", label: "Warning", description: "Soft signal: should consider and address, but can override with justification." },
       { value: "guideline", label: "Guideline", description: "Recommendation: encouraged and expected in most cases, but not enforced." }
     ]
+  },
+  // ── ProxyConfidence ─────────────────────────────────────────────────
+  ProxyConfidence: {
+    id: "ProxyConfidence",
+    label: "Proxy confidence",
+    description: "How strongly a proxy metric predicts the direct measure it stands in for.",
+    tone_direction: "high-is-good",
+    values: [
+      { value: "strong", label: "Strong", description: "Tracks the direct measure closely; a reliable stand-in." },
+      { value: "moderate", label: "Moderate", description: "Correlates with the direct measure but with meaningful slippage." },
+      { value: "weak", label: "Weak", description: "Loosely related; use with caution and corroborate." }
+    ]
+  },
+  // ── CauseConfidence ─────────────────────────────────────────────────
+  CauseConfidence: {
+    id: "CauseConfidence",
+    label: "Cause confidence",
+    description: "Maturity of a root-cause determination during incident debugging: how far a proposed cause has been validated.",
+    tone_direction: "high-is-good",
+    values: [
+      { value: "hypothesised", label: "Hypothesised", description: "A proposed cause, not yet tested against evidence." },
+      { value: "likely", label: "Likely", description: "Supported by evidence but not conclusively proven." },
+      { value: "confirmed", label: "Confirmed", description: "Verified as the cause; reproduced or otherwise established." }
+    ]
+  },
+  // ── ComfortLevel ────────────────────────────────────────────────────
+  ComfortLevel: {
+    id: "ComfortLevel",
+    label: "Comfort level",
+    description: "A person's comfort with a tool, technology, or practice. Closed set so personas compare on the same axis across products.",
+    tone_direction: "high-is-good",
+    values: [
+      { value: "low", label: "Low", description: "Little or no familiarity; needs guidance to proceed." },
+      { value: "medium", label: "Medium", description: "Functional, everyday competence." },
+      { value: "high", label: "High", description: "Confident, fluent use without assistance." },
+      { value: "expert", label: "Expert", description: "Deep mastery; can teach others or extend the tool." },
+      { value: "other", label: "Other", description: "A comfort profile not captured by the above tiers." }
+    ]
+  },
+  // ── LogLevel ────────────────────────────────────────────────────────
+  LogLevel: {
+    id: "LogLevel",
+    label: "Log level",
+    description: "Operational verbosity of a monitor or alert signal. How loud the signal should be, not how bad an outcome is for the user (kept distinct from severity_5).",
+    tone_direction: "low-is-good",
+    values: [
+      { value: "critical", label: "Critical", description: "Page immediately; the signal is service-affecting." },
+      { value: "warning", label: "Warning", description: "Needs attention soon; not yet service-affecting." },
+      { value: "info", label: "Info", description: "Informational; no action required." }
+    ]
+  },
+  // ── IncidentSeverity ────────────────────────────────────────────────
+  IncidentSeverity: {
+    id: "IncidentSeverity",
+    label: "Incident severity",
+    description: "Paging-tier classification of an incident, driving escalation and response process. Distinct from user-impact severity_5 and from LogLevel.",
+    tone_direction: "low-is-good",
+    values: [
+      { value: "sev1", label: "SEV1", description: "Critical outage; full response, executive-visible." },
+      { value: "sev2", label: "SEV2", description: "Major degradation; urgent response." },
+      { value: "sev3", label: "SEV3", description: "Minor or partial impact; handled within hours." },
+      { value: "sev4", label: "SEV4", description: "Negligible impact; routine handling." }
+    ]
+  },
+  // ── SignalSentiment ─────────────────────────────────────────────────
+  SignalSentiment: {
+    id: "SignalSentiment",
+    label: "Signal sentiment",
+    description: "Sentiment polarity of an inbound signal (feedback, support, customer).",
+    tone_direction: "high-is-good",
+    values: [
+      { value: "positive", label: "Positive", description: "Favourable signal; satisfaction or advocacy." },
+      { value: "neutral", label: "Neutral", description: "No clear positive or negative lean." },
+      { value: "negative", label: "Negative", description: "Unfavourable signal; dissatisfaction or risk." },
+      { value: "mixed", label: "Mixed", description: "Contains both positive and negative elements." }
+    ]
+  },
+  // ── MaturityLevel ───────────────────────────────────────────────────
+  MaturityLevel: {
+    id: "MaturityLevel",
+    label: "Maturity level",
+    description: "Capability or process maturity on the CMMI ladder.",
+    tone_direction: "high-is-good",
+    values: [
+      { value: "initial", label: "Initial", description: "Ad hoc and unpredictable; little process." },
+      { value: "developing", label: "Developing", description: "Basic process emerging but inconsistent." },
+      { value: "defined", label: "Defined", description: "Documented, standardised process in place." },
+      { value: "managed", label: "Managed", description: "Measured and controlled against objectives." },
+      { value: "optimizing", label: "Optimizing", description: "Continuous, data-driven improvement." }
+    ]
+  },
+  // ── ConformanceLevel ────────────────────────────────────────────────
+  ConformanceLevel: {
+    id: "ConformanceLevel",
+    label: "Conformance level",
+    description: "WCAG accessibility conformance level.",
+    tone_direction: "high-is-good",
+    values: [
+      { value: "A", label: "A", description: "Minimum conformance; essential barriers removed." },
+      { value: "AA", label: "AA", description: "Addresses the most common barriers; the usual legal target." },
+      { value: "AAA", label: "AAA", description: "Highest level; not achievable for all content." }
+    ]
+  },
+  // ── DataSensitivity ─────────────────────────────────────────────────
+  DataSensitivity: {
+    id: "DataSensitivity",
+    label: "Data sensitivity",
+    description: "Data classification tier governing handling and access.",
+    tone_direction: "neutral",
+    values: [
+      { value: "public", label: "Public", description: "No restriction; safe to disclose openly." },
+      { value: "internal", label: "Internal", description: "For internal use; not for external release." },
+      { value: "confidential", label: "Confidential", description: "Sensitive; restricted to a need-to-know basis." },
+      { value: "restricted", label: "Restricted", description: "Highly sensitive; strict controls and auditing." }
+    ]
+  },
+  // ── DifficultyLevel ─────────────────────────────────────────────────
+  DifficultyLevel: {
+    id: "DifficultyLevel",
+    label: "Difficulty level",
+    description: "Learner difficulty tier for educational content.",
+    tone_direction: "neutral",
+    values: [
+      { value: "beginner", label: "Beginner", description: "No prior knowledge assumed." },
+      { value: "intermediate", label: "Intermediate", description: "Assumes working familiarity with the basics." },
+      { value: "advanced", label: "Advanced", description: "Assumes deep, expert-level background." }
+    ]
+  },
+  // ── FrequencyRating ─────────────────────────────────────────────────
+  FrequencyRating: {
+    id: "FrequencyRating",
+    label: "Frequency rating",
+    description: "Qualitative how-often rating. Distinct from the numeric frequency_5 scale and from Cadence calendar tiers.",
+    tone_direction: "neutral",
+    values: [
+      { value: "constant", label: "Constant", description: "Effectively always; continuous occurrence." },
+      { value: "regular", label: "Regular", description: "Happens on a predictable, recurring basis." },
+      { value: "occasional", label: "Occasional", description: "Happens sometimes, without a fixed pattern." },
+      { value: "rare", label: "Rare", description: "Happens infrequently." },
+      { value: "other", label: "Other", description: "A frequency not captured by the above tiers." }
+    ]
+  },
+  // ── EvidenceDirection ───────────────────────────────────────────────
+  EvidenceDirection: {
+    id: "EvidenceDirection",
+    label: "Evidence direction",
+    description: "Direction of evidence relative to a claim. Distinct from confidence_impact (strengthens/weakens) per the UPG-579 polysemy verdicts.",
+    tone_direction: "neutral",
+    values: [
+      { value: "supports", label: "Supports", description: "The evidence backs the claim." },
+      { value: "refutes", label: "Refutes", description: "The evidence contradicts the claim." },
+      { value: "neutral", label: "Neutral", description: "The evidence is inconclusive either way." }
+    ]
   }
 };
 function getEnumScale(name) {
@@ -6622,6 +6815,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
@@ -8425,7 +8653,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" },
@@ -8482,7 +8721,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: {
@@ -8616,7 +8866,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"' }
@@ -8655,16 +8905,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"]
     },
@@ -8775,8 +9037,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)." },
@@ -8806,7 +9078,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.
@@ -8819,7 +9091,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" }
   },
@@ -8848,9 +9120,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" }
   },
@@ -8964,7 +9236,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: {
@@ -8979,7 +9251,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: {
@@ -9004,13 +9276,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"]
     }
@@ -9029,9 +9302,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" }
   },
@@ -9060,7 +9333,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.
@@ -9120,7 +9393,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.
@@ -9137,7 +9410,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: {
@@ -9168,7 +9441,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" }
@@ -9246,7 +9519,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" }
   },
@@ -9273,24 +9557,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"]
     }
@@ -9408,20 +9694,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: {
@@ -9438,46 +9724,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"]
     },
@@ -9491,13 +9781,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"]
     },
@@ -9516,7 +9807,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: {
@@ -9551,28 +9853,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"]
     },
@@ -9589,13 +9893,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"]
     },
@@ -9613,7 +9918,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)." }
@@ -9623,13 +9928,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"]
     },
@@ -9681,13 +9987,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"]
     },
@@ -9709,13 +10016,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"]
     }
@@ -9725,13 +10033,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"]
     },
@@ -9749,8 +10058,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." },
@@ -9776,7 +10085,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." },
@@ -9814,20 +10134,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*." }
@@ -9853,24 +10174,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"]
     },
@@ -9888,24 +10211,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"]
     },
@@ -9929,24 +10254,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"]
     },
@@ -9959,7 +10286,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" }
@@ -9970,13 +10297,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"]
     },
@@ -10010,7 +10338,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`." },
@@ -10066,25 +10393,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"]
     },
@@ -10195,35 +10524,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"]
     },
@@ -10244,13 +10576,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"]
     },
@@ -10269,7 +10602,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: {
@@ -10281,35 +10614,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"]
     },
@@ -10330,17 +10666,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: {
@@ -10371,13 +10708,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"]
     },
@@ -10418,7 +10756,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.
@@ -10460,7 +10798,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).
@@ -10569,13 +10907,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"]
     },
@@ -10668,24 +11007,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"]
     },
@@ -10706,7 +11047,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." }
   },
@@ -10720,13 +11072,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"]
     },
@@ -10776,13 +11129,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"]
     },
@@ -10793,7 +11147,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" },
@@ -10864,17 +11218,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"]
     },
@@ -10890,46 +11245,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"]
     },
@@ -10939,24 +11298,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"]
     }
@@ -10968,19 +11329,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" },
@@ -11014,19 +11362,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" }
   },
@@ -11047,19 +11396,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" }
@@ -11072,7 +11422,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" },
@@ -11097,24 +11446,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"]
     },
@@ -11197,24 +11548,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"]
     },
@@ -11272,7 +11625,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.
@@ -11288,6 +11641,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" },
@@ -11302,7 +11662,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"' }
   },
@@ -11322,7 +11682,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"' },
@@ -15964,6 +16335,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(
@@ -16018,6 +16390,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(
@@ -16071,6 +16444,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(
@@ -16147,6 +16521,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(
@@ -16194,6 +16569,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(
@@ -16301,6 +16677,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(
@@ -16364,6 +16741,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(
@@ -16438,6 +16816,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(
@@ -16657,6 +17036,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(
@@ -16704,6 +17084,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(
@@ -23609,7 +23990,7 @@ function isCanonical(text) {
 }
 
 // src/index.ts
-var UPG_VERSION = "0.7.3";
+var UPG_VERSION = "0.8.0";
 var UPG_FORMAT_VERSION = "0.4.0";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();
@@ -23696,6 +24077,7 @@ export {
   OPERATIONS_TEAM_RITUALS_PLAYBOOK,
   PRODUCT_DELIVERY_PLAYBOOK,
   PRODUCT_FEEDBACK_SYNTHESIS_PLAYBOOK,
+  PROPERTY_SCALE_MAP,
   REFLECT_MODES,
   STRATEGY_OUTCOMES_PLAYBOOK,
   UPG_ACTIVE_TYPES,
@@ -23796,6 +24178,7 @@ export {
   getMigrationMap,
   getPlaybookById,
   getPlaybooksForRegion,
+  getPropertiesForScale,
   getPropertyDefaultScale,
   getPropertyMigrations,
   getPropertySchema,