@unified-product-graph/core 0.7.4 → 0.8.0

package/dist/index.cjs

@@ -43,12 +43,14 @@ __export(index_exports, {
   OPERATIONS_TEAM_RITUALS_PLAYBOOK: () => OPERATIONS_TEAM_RITUALS_PLAYBOOK,
   PRODUCT_DELIVERY_PLAYBOOK: () => PRODUCT_DELIVERY_PLAYBOOK,
   PRODUCT_FEEDBACK_SYNTHESIS_PLAYBOOK: () => PRODUCT_FEEDBACK_SYNTHESIS_PLAYBOOK,
+  PROPERTY_SCALE_MAP: () => PROPERTY_SCALE_MAP,
   REFLECT_MODES: () => REFLECT_MODES,
   STRATEGY_OUTCOMES_PLAYBOOK: () => STRATEGY_OUTCOMES_PLAYBOOK,
   UPG_ACTIVE_TYPES: () => UPG_ACTIVE_TYPES,
   UPG_ANTI_PATTERNS: () => UPG_ANTI_PATTERNS,
   UPG_APPROACHES: () => UPG_APPROACHES,
   UPG_APPROACHES_BY_ID: () => UPG_APPROACHES_BY_ID,
+  UPG_CANONICAL_FORMAT_VERSION: () => UPG_CANONICAL_FORMAT_VERSION,
   UPG_CONTAINMENT_FREE_TYPES: () => UPG_CONTAINMENT_FREE_TYPES,
   UPG_COUNT_BENCHMARKS: () => UPG_COUNT_BENCHMARKS,
   UPG_CROSS_EDGE_TYPES: () => UPG_CROSS_EDGE_TYPES,
@@ -112,8 +114,10 @@ __export(index_exports, {
   coerceProductStage: () => coerceProductStage,
   collectSlugsForType: () => collectSlugsForType,
   compareVersions: () => compareVersions,
+  computeBodyChecksum: () => computeBodyChecksum,
   evaluateAntiPatterns: () => evaluateAntiPatterns,
   findInvalidStatusMigrationTargets: () => findInvalidStatusMigrationTargets,
+  formatUpgText: () => formatUpgText,
   generateSlug: () => generateSlug,
   getAnchorEntity: () => getAnchorEntity,
   getAntiPatternById: () => getAntiPatternById,
@@ -140,6 +144,7 @@ __export(index_exports, {
   getMigrationMap: () => getMigrationMap,
   getPlaybookById: () => getPlaybookById,
   getPlaybooksForRegion: () => getPlaybooksForRegion,
+  getPropertiesForScale: () => getPropertiesForScale,
   getPropertyDefaultScale: () => getPropertyDefaultScale,
   getPropertyMigrations: () => getPropertyMigrations,
   getPropertySchema: () => getPropertySchema,
@@ -156,6 +161,7 @@ __export(index_exports, {
   getValidChildren: () => getValidChildren,
   getVisibleTypes: () => getVisibleTypes,
   hasStatusMigration: () => hasStatusMigration,
+  isCanonical: () => isCanonical,
   isCanonicalProductStage: () => isCanonicalProductStage,
   isContainmentFreeType: () => isContainmentFreeType,
   isDeprecatedType: () => isDeprecatedType,
@@ -166,6 +172,7 @@ __export(index_exports, {
   isLifecycleFreeType: () => isLifecycleFreeType,
   isLifecyclePlannedType: () => isLifecyclePlannedType,
   isPolymorphicEdge: () => isPolymorphicEdge,
+  isPortfolio: () => isPortfolio,
   isRegisteredPolymorphicEdge: () => isRegisteredPolymorphicEdge,
   isSubSequenceStep: () => isSubSequenceStep,
   isUPGDocument: () => isUPGDocument,
@@ -175,6 +182,8 @@ __export(index_exports, {
   migrateNodeProperties: () => migrateNodeProperties,
   migrateProductStage: () => migrateProductStage,
   migrateStatusValue: () => migrateStatusValue,
+  normalizeDocument: () => normalizeDocument,
+  parseUpg: () => parseUpg,
   pickCanonicalEdge: () => pickCanonicalEdge,
   resolveAllEdges: () => resolveAllEdges,
   resolveContainmentEdge: () => resolveContainmentEdge,
@@ -182,6 +191,7 @@ __export(index_exports, {
   resolveLabel: () => resolveLabel,
   resolveSlugCollision: () => resolveSlugCollision,
   rotateSlug: () => rotateSlug,
+  serializeCanonical: () => serializeCanonical,
   validateProductStageStrict: () => validateProductStageStrict,
   validateUPGDocument: () => validateUPGDocument,
   validateUPGFramework: () => validateUPGFramework,
@@ -6350,20 +6360,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
@@ -6371,17 +6403,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 = {
@@ -6467,6 +6517,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) {
@@ -6813,6 +7016,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
@@ -8616,7 +8854,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" },
@@ -8673,7 +8922,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: {
@@ -8807,7 +9067,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"' }
@@ -8846,16 +9106,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"]
     },
@@ -8966,8 +9238,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)." },
@@ -8997,7 +9279,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.
@@ -9010,7 +9292,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" }
   },
@@ -9039,9 +9321,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" }
   },
@@ -9155,7 +9437,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: {
@@ -9170,7 +9452,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: {
@@ -9195,13 +9477,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"]
     }
@@ -9220,9 +9503,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" }
   },
@@ -9251,7 +9534,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.
@@ -9311,7 +9594,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.
@@ -9328,7 +9611,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: {
@@ -9359,7 +9642,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" }
@@ -9437,7 +9720,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" }
   },
@@ -9464,24 +9758,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"]
     }
@@ -9599,20 +9895,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: {
@@ -9629,46 +9925,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"]
     },
@@ -9682,13 +9982,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"]
     },
@@ -9707,7 +10008,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: {
@@ -9742,28 +10054,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"]
     },
@@ -9780,13 +10094,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"]
     },
@@ -9804,7 +10119,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)." }
@@ -9814,13 +10129,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"]
     },
@@ -9872,13 +10188,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"]
     },
@@ -9900,13 +10217,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"]
     }
@@ -9916,13 +10234,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"]
     },
@@ -9940,8 +10259,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." },
@@ -9967,7 +10286,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." },
@@ -10005,20 +10335,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*." }
@@ -10044,24 +10375,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"]
     },
@@ -10079,24 +10412,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"]
     },
@@ -10120,24 +10455,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"]
     },
@@ -10150,7 +10487,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" }
@@ -10161,13 +10498,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"]
     },
@@ -10201,7 +10539,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`." },
@@ -10257,25 +10594,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"]
     },
@@ -10386,35 +10725,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"]
     },
@@ -10435,13 +10777,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"]
     },
@@ -10460,7 +10803,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: {
@@ -10472,35 +10815,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"]
     },
@@ -10521,17 +10867,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: {
@@ -10562,13 +10909,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"]
     },
@@ -10609,7 +10957,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.
@@ -10651,7 +10999,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).
@@ -10760,13 +11108,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"]
     },
@@ -10859,24 +11208,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"]
     },
@@ -10897,7 +11248,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." }
   },
@@ -10911,13 +11273,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"]
     },
@@ -10967,13 +11330,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"]
     },
@@ -10984,7 +11348,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" },
@@ -11055,17 +11419,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"]
     },
@@ -11081,46 +11446,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"]
     },
@@ -11130,24 +11499,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"]
     }
@@ -11159,19 +11530,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" },
@@ -11205,19 +11563,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" }
   },
@@ -11238,19 +11597,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" }
@@ -11263,7 +11623,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" },
@@ -11288,24 +11647,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"]
     },
@@ -11388,24 +11749,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"]
     },
@@ -11463,7 +11826,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.
@@ -11479,6 +11842,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" },
@@ -11493,7 +11863,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"' }
   },
@@ -11513,7 +11883,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"' },
@@ -12821,26 +13202,6 @@ var UPG_FRAMEWORKS = [
         "label": "Items to score",
         "entityTypeId": "feature",
         "description": "Features, opportunities, or solutions being evaluated"
-      },
-      {
-        "label": "Reach",
-        "entityTypeId": "feature",
-        "description": "How many users does this affect per quarter?"
-      },
-      {
-        "label": "Impact",
-        "entityTypeId": "feature",
-        "description": "How much does this move the target outcome?"
-      },
-      {
-        "label": "Confidence",
-        "entityTypeId": "feature",
-        "description": "How sure are we about these estimates?"
-      },
-      {
-        "label": "Effort",
-        "entityTypeId": "feature",
-        "description": "How many person-months to build?"
       }
     ],
     "data": {
@@ -12854,31 +13215,35 @@ var UPG_FRAMEWORKS = [
         "feature": [
           {
             "property": "reach",
-            "type": "number",
+            "type": "assessment",
+            "scale_id": "reach_5",
             "required": true,
             "label": "Reach",
             "description": "How many users will this impact per quarter?"
           },
           {
             "property": "impact",
-            "type": "number",
+            "type": "assessment",
+            "scale_id": "impact_5",
             "required": true,
             "label": "Impact",
-            "description": "How much will this impact each user? (1=minimal, 2=low, 3=medium, 4=high, 5=massive)"
+            "description": "How much will this impact each user, on the impact scale?"
           },
           {
             "property": "confidence",
-            "type": "number",
+            "type": "assessment",
+            "scale_id": "confidence_5",
             "required": true,
             "label": "Confidence",
-            "description": "How confident are you in the estimates? (0.5=low, 0.8=medium, 1.0=high)"
+            "description": "How confident are you in the reach, impact, and effort estimates?"
           },
           {
             "property": "effort",
-            "type": "number",
+            "type": "assessment",
+            "scale_id": "effort_5",
             "required": true,
             "label": "Effort",
-            "description": "Person-months of effort required"
+            "description": "How much work is required to build and ship this, on the effort scale?"
           }
         ]
       },
@@ -13072,7 +13437,7 @@ var UPG_FRAMEWORKS = [
       {
         "label": "Performance",
         "entityTypeId": "feature",
-        "description": "More is better, with linear satisfaction increase"
+        "description": "More is better: linear satisfaction increase"
       },
       {
         "label": "Delighters",
@@ -13321,24 +13686,9 @@ var UPG_FRAMEWORKS = [
     ],
     "slots": [
       {
-        "label": "Must Have",
-        "entityTypeId": "feature",
-        "description": "Non-negotiable requirements for this release"
-      },
-      {
-        "label": "Should Have",
-        "entityTypeId": "feature",
-        "description": "Important but not critical; a workaround exists"
-      },
-      {
-        "label": "Could Have",
+        "label": "Requirements to categorise",
         "entityTypeId": "feature",
-        "description": "Nice to have; include if time permits"
-      },
-      {
-        "label": "Won't Have",
-        "entityTypeId": "feature",
-        "description": "Explicitly out of scope for now"
+        "description": "Features or requirements sorted into the four MoSCoW buckets"
       }
     ],
     "data": {
@@ -13348,7 +13698,23 @@ var UPG_FRAMEWORKS = [
           "role": "scored_item"
         }
       ],
-      "required_properties": {},
+      "required_properties": {
+        "feature": [
+          {
+            "property": "moscow",
+            "type": "enum",
+            "required": true,
+            "label": "MoSCoW priority",
+            "description": "Which scope bucket this requirement falls into for the current release",
+            "enum_values": [
+              "must",
+              "should",
+              "could",
+              "wont"
+            ]
+          }
+        ]
+      },
       "computed_properties": [
         {
           "property": "must_have_ratio",
@@ -13368,28 +13734,19 @@ var UPG_FRAMEWORKS = [
         "columns": [
           {
             "property": "title",
-            "label": "Must Have",
+            "label": "Requirement",
             "sortable": true
           },
           {
-            "property": "title",
-            "label": "Should Have",
-            "sortable": true
-          },
-          {
-            "property": "title",
-            "label": "Could Have",
-            "sortable": true
-          },
-          {
-            "property": "title",
-            "label": "Won't Have",
-            "sortable": true
+            "property": "moscow",
+            "label": "Priority",
+            "sortable": true,
+            "format": "badge"
           }
         ]
       },
       "sort_by": {
-        "property": "title",
+        "property": "moscow",
         "direction": "asc"
       },
       "colour_by": "type",
@@ -13940,24 +14297,9 @@ var UPG_FRAMEWORKS = [
     ],
     "slots": [
       {
-        "label": "Deployment Frequency",
+        "label": "Delivery metric",
         "entityTypeId": "metric",
-        "description": "How often you deploy to production"
-      },
-      {
-        "label": "Lead Time for Changes",
-        "entityTypeId": "metric",
-        "description": "Time from commit to production"
-      },
-      {
-        "label": "Change Failure Rate",
-        "entityTypeId": "metric",
-        "description": "Percentage of deployments causing failures"
-      },
-      {
-        "label": "Time to Restore",
-        "entityTypeId": "metric",
-        "description": "How long to recover from a failure"
+        "description": "One of the four DORA software-delivery performance metrics"
       }
     ],
     "data": {
@@ -13967,7 +14309,36 @@ var UPG_FRAMEWORKS = [
           "role": "item"
         }
       ],
-      "required_properties": {},
+      "required_properties": {
+        "metric": [
+          {
+            "property": "dora_metric",
+            "type": "enum",
+            "required": true,
+            "label": "DORA metric",
+            "description": "Which of the four DORA metrics this measures",
+            "enum_values": [
+              "deployment_frequency",
+              "lead_time_for_changes",
+              "change_failure_rate",
+              "time_to_restore"
+            ]
+          },
+          {
+            "property": "performance_tier",
+            "type": "enum",
+            "required": false,
+            "label": "Performance tier",
+            "description": "Where this metric sits on the DORA elite-to-low benchmark",
+            "enum_values": [
+              "elite",
+              "high",
+              "medium",
+              "low"
+            ]
+          }
+        ]
+      },
       "computed_properties": [
         {
           "property": "stability_index",
@@ -14123,29 +14494,9 @@ var UPG_FRAMEWORKS = [
     ],
     "slots": [
       {
-        "label": "Acquisition",
-        "entityTypeId": "metric",
-        "description": "How do users find you?"
-      },
-      {
-        "label": "Activation",
-        "entityTypeId": "metric",
-        "description": "Do users have a great first experience?"
-      },
-      {
-        "label": "Retention",
-        "entityTypeId": "metric",
-        "description": "Do users come back?"
-      },
-      {
-        "label": "Revenue",
+        "label": "Lifecycle metric",
         "entityTypeId": "metric",
-        "description": "Can you monetise the behaviour?"
-      },
-      {
-        "label": "Referral",
-        "entityTypeId": "metric",
-        "description": "Do users tell others?"
+        "description": "A metric tracking one stage of the customer lifecycle funnel"
       }
     ],
     "data": {
@@ -14155,7 +14506,24 @@ var UPG_FRAMEWORKS = [
           "role": "item"
         }
       ],
-      "required_properties": {},
+      "required_properties": {
+        "metric": [
+          {
+            "property": "lifecycle_stage",
+            "type": "enum",
+            "required": true,
+            "label": "Lifecycle stage",
+            "description": "Which AARRR funnel stage this metric measures",
+            "enum_values": [
+              "acquisition",
+              "activation",
+              "retention",
+              "revenue",
+              "referral"
+            ]
+          }
+        ]
+      },
       "computed_properties": [
         {
           "property": "conversion_rate",
@@ -14167,7 +14535,39 @@ var UPG_FRAMEWORKS = [
       ]
     },
     "structure": {
-      "pattern": "funnel"
+      "pattern": "funnel",
+      "stages": [
+        {
+          "id": "acquisition",
+          "label": "Acquisition",
+          "order": 0,
+          "entity_type": "metric"
+        },
+        {
+          "id": "activation",
+          "label": "Activation",
+          "order": 1,
+          "entity_type": "metric"
+        },
+        {
+          "id": "retention",
+          "label": "Retention",
+          "order": 2,
+          "entity_type": "metric"
+        },
+        {
+          "id": "revenue",
+          "label": "Revenue",
+          "order": 3,
+          "entity_type": "metric"
+        },
+        {
+          "id": "referral",
+          "label": "Referral",
+          "order": 4,
+          "entity_type": "metric"
+        }
+      ]
     },
     "presentation": {
       "layout": {
@@ -14214,24 +14614,9 @@ var UPG_FRAMEWORKS = [
     ],
     "slots": [
       {
-        "label": "North Star",
-        "entityTypeId": "metric",
-        "description": "The single metric reflecting core value delivered"
-      },
-      {
-        "label": "Input Metric 1",
-        "entityTypeId": "metric",
-        "description": "A driver metric you can directly influence"
-      },
-      {
-        "label": "Input Metric 2",
-        "entityTypeId": "metric",
-        "description": "A driver metric you can directly influence"
-      },
-      {
-        "label": "Input Metric 3",
+        "label": "Metric",
         "entityTypeId": "metric",
-        "description": "A driver metric you can directly influence"
+        "description": "The North Star metric or one of its 3-5 input (driver) metrics"
       }
     ],
     "data": {
@@ -14241,7 +14626,28 @@ var UPG_FRAMEWORKS = [
           "role": "item"
         }
       ],
-      "required_properties": {},
+      "required_properties": {
+        "metric": [
+          {
+            "property": "metric_role",
+            "type": "enum",
+            "required": true,
+            "label": "Metric role",
+            "description": "Whether this is the single North Star or a driver that feeds it",
+            "enum_values": [
+              "north_star",
+              "input"
+            ]
+          },
+          {
+            "property": "leverage",
+            "type": "number",
+            "required": false,
+            "label": "Leverage",
+            "description": "How strongly this input metric moves the North Star (input metrics only)"
+          }
+        ]
+      },
       "computed_properties": [
         {
           "property": "nsm_impact",
@@ -14541,7 +14947,7 @@ var UPG_FRAMEWORKS = [
       ]
     },
     "education": {
-      "purpose": "Design the product itself as the primary growth driver (free tier, self-serve onboarding, in-product virality), reducing dependence on sales-led acquisition.",
+      "purpose": "Design the product itself as the primary growth driver (free tier, self-serve onboarding, in-product virality) to reduce dependence on sales-led acquisition.",
       "core_question": "Can our product acquire, activate, and expand users without human intervention, and where in the loop do we still need sales?",
       "when_to_use": [
         "You are launching a new product, feature, or entering a new market",
@@ -14951,7 +15357,7 @@ var UPG_FRAMEWORKS = [
       {
         "label": "Team",
         "entityTypeId": "team",
-        "description": "Team conducting the health check: all members vote anonymously on each dimension"
+        "description": "Team conducting the health check; all members vote anonymously on each dimension"
       },
       {
         "label": "Retrospective",
@@ -15040,7 +15446,7 @@ var UPG_FRAMEWORKS = [
     },
     "education": {
       "purpose": "Regularly assess team health across dimensions (psychological safety, autonomy, mission clarity, fun, speed, learning) to catch problems early and celebrate strengths.",
-      "core_question": "How is the team really doing? Where do they feel strong, where do they feel stuck, and what has changed since last check?",
+      "core_question": "How is the team really doing: where do they feel strong, where do they feel stuck, and what has changed since last check?",
       "when_to_use": [
         "You need to improve team collaboration, clarity, or effectiveness",
         "Roles and responsibilities are unclear or causing friction",
@@ -15056,7 +15462,7 @@ var UPG_FRAMEWORKS = [
     "id": "raid-log",
     "name": "RAID Log",
     "version": "1.0.0",
-    "description": "A project management register tracking Risks, Assumptions, Issues, and Dependencies: the four categories most likely to derail a project if left unmanaged.",
+    "description": "A project management register tracking Risks, Assumptions, Issues, and Dependencies, the four categories most likely to derail a project if left unmanaged.",
     "category": "program_mgmt",
     "origin": {
       "type": "practitioner",
@@ -16130,6 +16536,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(
@@ -16184,6 +16591,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(
@@ -16237,6 +16645,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(
@@ -16313,6 +16722,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(
@@ -16360,6 +16770,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(
@@ -16467,6 +16878,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(
@@ -16530,6 +16942,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(
@@ -16604,6 +17017,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(
@@ -16823,6 +17237,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(
@@ -16870,6 +17285,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(
@@ -23507,8 +23923,275 @@ function validateExpression(expr) {
   return null;
 }
 
+// src/format/canonical.ts
+var import_node_crypto = require("crypto");
+var UPG_CANONICAL_FORMAT_VERSION = "1.0.0";
+var INTEGRITY_HASH_PRIMITIVE = "sha256";
+var INTEGRITY_DIGEST_HEX = 32;
+var INTEGRITY_ALGORITHM = "sha256-128";
+function canonicalizeOpen(value) {
+  if (Array.isArray(value)) return value.map(canonicalizeOpen);
+  if (value !== null && typeof value === "object") {
+    const out = {};
+    for (const key of Object.keys(value).sort(byCodeUnit)) {
+      out[key] = canonicalizeOpen(value[key]);
+    }
+    return out;
+  }
+  return value;
+}
+function byCodeUnit(a, b) {
+  return a < b ? -1 : a > b ? 1 : 0;
+}
+function isEmpty(value) {
+  if (value === null || value === void 0) return true;
+  if (typeof value === "string") return value.length === 0;
+  if (Array.isArray(value)) return value.length === 0;
+  if (typeof value === "object") return Object.keys(value).length === 0;
+  return false;
+}
+function orderedObject(source, keyOrder, opts = {}) {
+  const force = new Set(opts.forceKeys ?? []);
+  const open = new Set(opts.openKeys ?? []);
+  const out = {};
+  const emit = (key) => {
+    if (!(key in source)) return;
+    const raw = source[key];
+    if (!force.has(key) && isEmpty(raw)) return;
+    out[key] = open.has(key) ? canonicalizeOpen(raw) : raw;
+  };
+  for (const key of keyOrder) emit(key);
+  for (const key of Object.keys(source).sort(byCodeUnit)) {
+    if (!keyOrder.includes(key)) emit(key);
+  }
+  return out;
+}
+function repairNodeDrift(node) {
+  const out = { ...node };
+  if (typeof out.properties === "string") {
+    out.properties = parseDriftString(out.properties, "object", `node ${node.id}.properties`);
+  }
+  if (typeof out.tags === "string") {
+    out.tags = parseDriftString(out.tags, "array", `node ${node.id}.tags`);
+  }
+  return out;
+}
+function parseDriftString(raw, expect, where) {
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    throw new Error(`[upg fmt] ${where} is a string that is not valid JSON: ${truncate(raw)}`);
+  }
+  const ok = expect === "array" ? Array.isArray(parsed) : parsed !== null && typeof parsed === "object" && !Array.isArray(parsed);
+  if (!ok) throw new Error(`[upg fmt] ${where} is a string that does not parse to a JSON ${expect}: ${truncate(raw)}`);
+  return parsed;
+}
+function truncate(s) {
+  return s.length > 60 ? s.slice(0, 57) + "..." : s;
+}
+function deriveSummary(description) {
+  if (!description) return void 0;
+  const firstLine = description.split("\n").map((l) => l.trim()).find((l) => l.length > 0);
+  if (!firstLine) return void 0;
+  return firstLine.length > 200 ? firstLine.slice(0, 197) + "..." : firstLine;
+}
+function sortNodes(nodes) {
+  return [...nodes].sort(
+    (a, b) => byCodeUnit(a.type ?? "", b.type ?? "") || byCodeUnit(a.slug ?? a.title ?? "", b.slug ?? b.title ?? "") || byCodeUnit(a.id ?? "", b.id ?? "")
+  );
+}
+function sortEdges(edges) {
+  return [...edges].sort(
+    (a, b) => byCodeUnit(a.source ?? "", b.source ?? "") || byCodeUnit(a.target ?? "", b.target ?? "") || byCodeUnit(a.type ?? "", b.type ?? "") || byCodeUnit(a.id ?? "", b.id ?? "")
+  );
+}
+var NODE_KEY_ORDER = [
+  "id",
+  "type",
+  "title",
+  "slug",
+  "aliases",
+  "description",
+  "tags",
+  "status",
+  "lifecycle_status",
+  "source_id",
+  "source_type",
+  "mapping_confidence",
+  "external_tool",
+  "external_ref",
+  "external_id",
+  "sort_order",
+  "properties"
+];
+var EDGE_KEY_ORDER = ["id", "source", "target", "type", "mapping_confidence"];
+var CROSS_EDGE_KEY_ORDER = ["id", "source", "target", "type", "source_product_id", "target_product_id", "mapping_confidence"];
+var PRODUCT_KEY_ORDER = ["id", "title", "description", "stage", "properties"];
+function canonicalNode(node) {
+  const repaired = repairNodeDrift(node);
+  if (Array.isArray(repaired.tags)) {
+    repaired.tags = [...new Set(repaired.tags)].sort(byCodeUnit);
+  }
+  return orderedObject(repaired, NODE_KEY_ORDER, { forceKeys: ["id", "type", "title"], openKeys: ["properties"] });
+}
+function canonicalEdge(edge) {
+  return orderedObject(edge, EDGE_KEY_ORDER, {
+    forceKeys: ["id", "source", "target", "type"]
+  });
+}
+function canonicalCrossEdge(edge) {
+  return orderedObject(edge, CROSS_EDGE_KEY_ORDER, {
+    forceKeys: ["id", "source", "target", "type"]
+  });
+}
+function canonicalProduct(product) {
+  return orderedObject(product, PRODUCT_KEY_ORDER, { forceKeys: ["id", "title"], openKeys: ["properties"] });
+}
+function singleBody(doc) {
+  return {
+    product: canonicalProduct(doc.product),
+    nodes: sortNodes(doc.nodes ?? []).map(canonicalNode),
+    edges: sortEdges(doc.edges ?? []).map(canonicalEdge)
+  };
+}
+function portfolioBody(doc) {
+  const products = [...doc.products ?? []].sort((a, b) => byCodeUnit(a.id ?? "", b.id ?? "")).map((p) => {
+    const { nodes, edges, ...rest } = p;
+    return {
+      ...canonicalProduct(rest),
+      nodes: sortNodes(nodes ?? []).map(canonicalNode),
+      edges: sortEdges(edges ?? []).map(canonicalEdge)
+    };
+  });
+  return {
+    organization: orderedObject(doc.organization, ["id", "title", "description", "logo_url", "industry"], { forceKeys: ["id", "title"] }),
+    product_areas: [...doc.product_areas ?? []].sort((a, b) => byCodeUnit(a.id ?? "", b.id ?? "")).map((a) => orderedObject(a, ["id", "title", "description", "parent_area_id", "strategic_priority", "products"], { forceKeys: ["id", "title"] })),
+    portfolios: [...doc.portfolios ?? []].sort((a, b) => byCodeUnit(a.id ?? "", b.id ?? "")).map((p) => orderedObject(p, ["id", "title", "description", "parent_portfolio_id", "hierarchy_model", "products"], { forceKeys: ["id", "title"] })),
+    products,
+    cross_edges: sortEdges(doc.cross_edges ?? []).map(canonicalCrossEdge)
+  };
+}
+function computeBodyChecksum(doc) {
+  const body = isPortfolio(doc) ? portfolioBody(doc) : singleBody(doc);
+  const content = JSON.stringify(body);
+  return (0, import_node_crypto.createHash)(INTEGRITY_HASH_PRIMITIVE).update(content).digest("hex").slice(0, INTEGRITY_DIGEST_HEX);
+}
+function isPortfolio(doc) {
+  return doc.type === "portfolio" || "cross_edges" in doc;
+}
+function serializeCanonical(doc, opts = {}) {
+  if (isPortfolio(doc)) return serializePortfolioWithHeader(doc, opts);
+  return serializeSingleWithHeader(doc, opts);
+}
+function buildProvenance(doc, opts) {
+  const source = opts.source ?? doc.source ?? { tool: "unknown" };
+  return orderedObject(
+    {
+      tool: source.tool,
+      tool_version: source.tool_version,
+      workspace_id: source.workspace_id,
+      exported_at: opts.exportedAt ?? doc.exported_at
+    },
+    ["tool", "tool_version", "workspace_id", "exported_at"],
+    { forceKeys: ["tool"] }
+  );
+}
+function serializeSingleWithHeader(doc, opts) {
+  const body = singleBody(doc);
+  const product = doc.product;
+  const header = {
+    format_version: UPG_CANONICAL_FORMAT_VERSION,
+    spec_version: doc.upg_version,
+    product: orderedObject(
+      { id: product.id, title: product.title, stage: product.stage },
+      ["id", "title", "stage"],
+      { forceKeys: ["id", "title"] }
+    )
+  };
+  const summary = deriveSummary(product.description);
+  if (summary) header.summary = summary;
+  header.counts = { nodes: doc.nodes?.length ?? 0, edges: doc.edges?.length ?? 0 };
+  header.provenance = buildProvenance(doc, opts);
+  header.integrity = { algorithm: INTEGRITY_ALGORITHM, body: computeBodyChecksum(doc) };
+  return JSON.stringify({ $upg: header, ...body }, null, 2) + "\n";
+}
+function serializePortfolioWithHeader(doc, opts) {
+  const body = portfolioBody(doc);
+  const org = doc.organization;
+  const header = {
+    format_version: UPG_CANONICAL_FORMAT_VERSION,
+    spec_version: doc.upg_version,
+    kind: "portfolio",
+    organization: orderedObject(
+      { id: org.id, title: org.title },
+      ["id", "title"],
+      { forceKeys: ["id", "title"] }
+    )
+  };
+  const summary = deriveSummary(org.description);
+  if (summary) header.summary = summary;
+  header.counts = {
+    products: doc.products?.length ?? 0,
+    product_areas: doc.product_areas?.length ?? 0,
+    portfolios: doc.portfolios?.length ?? 0,
+    cross_edges: doc.cross_edges?.length ?? 0
+  };
+  header.provenance = buildProvenance(doc, opts);
+  header.integrity = { algorithm: INTEGRITY_ALGORITHM, body: computeBodyChecksum(doc) };
+  return JSON.stringify({ $upg: header, ...body }, null, 2) + "\n";
+}
+function parseUpg(text) {
+  return normalizeDocument(JSON.parse(text));
+}
+function normalizeDocument(obj) {
+  const raw = obj;
+  const header = raw.$upg;
+  const upg_version = header?.spec_version ?? raw.upg_version;
+  const provenance = header?.provenance;
+  const exported_at = provenance?.exported_at ?? raw.exported_at;
+  const source = provenance ? { tool: provenance.tool, tool_version: provenance.tool_version, workspace_id: provenance.workspace_id } : raw.source;
+  const _integrity = header ? void 0 : raw._integrity;
+  const isPortfolioDoc = raw.type === "portfolio" || header?.kind === "portfolio" || "cross_edges" in raw;
+  if (isPortfolioDoc) {
+    const out2 = {
+      upg_version,
+      type: "portfolio",
+      exported_at: exported_at ?? "",
+      source: source ?? { tool: "unknown" },
+      organization: raw.organization,
+      product_areas: raw.product_areas ?? [],
+      portfolios: raw.portfolios ?? [],
+      products: (raw.products ?? []).map((p) => ({
+        ...p,
+        nodes: (p.nodes ?? []).map((n) => repairNodeDrift(n)),
+        edges: p.edges ?? []
+      })),
+      cross_edges: raw.cross_edges ?? []
+    };
+    return out2;
+  }
+  const out = {
+    upg_version,
+    exported_at: exported_at ?? "",
+    source: source ?? { tool: "unknown" },
+    product: raw.product,
+    nodes: (raw.nodes ?? []).map((n) => repairNodeDrift(n)),
+    edges: raw.edges ?? []
+  };
+  if (_integrity) out._integrity = _integrity;
+  return out;
+}
+function formatUpgText(text, opts = {}) {
+  return serializeCanonical(parseUpg(text), opts);
+}
+function isCanonical(text) {
+  const parsed = parseUpg(text);
+  return text === serializeCanonical(parsed);
+}
+
 // 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();
@@ -23596,12 +24279,14 @@ var UPG_META_COUNT = UPG_ENTITY_META.length;
   OPERATIONS_TEAM_RITUALS_PLAYBOOK,
   PRODUCT_DELIVERY_PLAYBOOK,
   PRODUCT_FEEDBACK_SYNTHESIS_PLAYBOOK,
+  PROPERTY_SCALE_MAP,
   REFLECT_MODES,
   STRATEGY_OUTCOMES_PLAYBOOK,
   UPG_ACTIVE_TYPES,
   UPG_ANTI_PATTERNS,
   UPG_APPROACHES,
   UPG_APPROACHES_BY_ID,
+  UPG_CANONICAL_FORMAT_VERSION,
   UPG_CONTAINMENT_FREE_TYPES,
   UPG_COUNT_BENCHMARKS,
   UPG_CROSS_EDGE_TYPES,
@@ -23665,8 +24350,10 @@ var UPG_META_COUNT = UPG_ENTITY_META.length;
   coerceProductStage,
   collectSlugsForType,
   compareVersions,
+  computeBodyChecksum,
   evaluateAntiPatterns,
   findInvalidStatusMigrationTargets,
+  formatUpgText,
   generateSlug,
   getAnchorEntity,
   getAntiPatternById,
@@ -23693,6 +24380,7 @@ var UPG_META_COUNT = UPG_ENTITY_META.length;
   getMigrationMap,
   getPlaybookById,
   getPlaybooksForRegion,
+  getPropertiesForScale,
   getPropertyDefaultScale,
   getPropertyMigrations,
   getPropertySchema,
@@ -23709,6 +24397,7 @@ var UPG_META_COUNT = UPG_ENTITY_META.length;
   getValidChildren,
   getVisibleTypes,
   hasStatusMigration,
+  isCanonical,
   isCanonicalProductStage,
   isContainmentFreeType,
   isDeprecatedType,
@@ -23719,6 +24408,7 @@ var UPG_META_COUNT = UPG_ENTITY_META.length;
   isLifecycleFreeType,
   isLifecyclePlannedType,
   isPolymorphicEdge,
+  isPortfolio,
   isRegisteredPolymorphicEdge,
   isSubSequenceStep,
   isUPGDocument,
@@ -23728,6 +24418,8 @@ var UPG_META_COUNT = UPG_ENTITY_META.length;
   migrateNodeProperties,
   migrateProductStage,
   migrateStatusValue,
+  normalizeDocument,
+  parseUpg,
   pickCanonicalEdge,
   resolveAllEdges,
   resolveContainmentEdge,
@@ -23735,6 +24427,7 @@ var UPG_META_COUNT = UPG_ENTITY_META.length;
   resolveLabel,
   resolveSlugCollision,
   rotateSlug,
+  serializeCanonical,
   validateProductStageStrict,
   validateUPGDocument,
   validateUPGFramework,