@unified-product-graph/core 0.11.6 → 0.12.1

package/dist/index.cjs

@@ -90,6 +90,7 @@ __export(index_exports, {
   UPG_REGION_COUNT: () => UPG_REGION_COUNT,
   UPG_REGION_MAP: () => UPG_REGION_MAP,
   UPG_RELATIONSHIP_BENCHMARKS: () => UPG_RELATIONSHIP_BENCHMARKS,
+  UPG_SCALAR_TO_EDGE_MIGRATIONS: () => UPG_SCALAR_TO_EDGE_MIGRATIONS,
   UPG_SCALES: () => UPG_SCALES,
   UPG_SPLIT_MIGRATIONS: () => UPG_SPLIT_MIGRATIONS,
   UPG_STATUS_MIGRATIONS: () => UPG_STATUS_MIGRATIONS,
@@ -158,6 +159,7 @@ __export(index_exports, {
   getRegionForEntityType: () => getRegionForEntityType,
   getReplacementType: () => getReplacementType,
   getRingForDomain: () => getRingForDomain,
+  getScalarToEdgeMigrations: () => getScalarToEdgeMigrations,
   getScale: () => getScale,
   getSplitMigrations: () => getSplitMigrations,
   getTreePattern: () => getTreePattern,
@@ -2396,6 +2398,32 @@ var UPG_EDGE_CATALOG = {
   // owned by feature_area / theme / product. Relationship is semantic.
   changelog_includes_feature: { forward_verb: "includes", reverse_verb: "included_in", classification: "semantic", source_type: "changelog", target_type: "feature" },
   ai_trace_spawns_ai_trace: { forward_verb: "spawns", reverse_verb: "spawned_by", classification: "hierarchy", source_type: "ai_trace", target_type: "ai_trace" },
+  // ── P14 conformance edges (0.12.0) — promote orphan entity-reference scalars ──
+  // Each replaces a string property that named a first-class entity. The matching
+  // `UPGScalarToEdgeMigration['0.12.0']` rule losslessly mints/links + drops the
+  // scalar. See the P14 string-reference sweep.
+  business_model_guided_by_metric: { forward_verb: "guided_by", reverse_verb: "guides", classification: "cross-domain", source_type: "business_model", target_type: "metric" },
+  vision_anchored_by_metric: { forward_verb: "anchored_by", reverse_verb: "anchors", classification: "cross-domain", source_type: "vision", target_type: "metric" },
+  metric_fed_by_data_source: { forward_verb: "fed_by", reverse_verb: "feeds", classification: "cross-domain", source_type: "metric", target_type: "data_source" },
+  hallucination_report_has_root_cause: { forward_verb: "has_root_cause", reverse_verb: "root_cause_of", classification: "causal", source_type: "hallucination_report", target_type: "root_cause" },
+  model_comparison_compares_ai_model: { forward_verb: "compares", reverse_verb: "compared_in", classification: "semantic", source_type: "model_comparison", target_type: "ai_model" },
+  launch_measured_by_metric: { forward_verb: "measured_by", reverse_verb: "measures", classification: "cross-domain", source_type: "launch", target_type: "metric" },
+  wireframe_depicts_screen: { forward_verb: "depicts", reverse_verb: "depicted_by", classification: "semantic", source_type: "wireframe", target_type: "screen" },
+  service_level_indicator_measures_metric: { forward_verb: "measures", reverse_verb: "measured_by", classification: "cross-domain", source_type: "service_level_indicator", target_type: "metric" },
+  agent_definition_uses_ai_model: { forward_verb: "uses", reverse_verb: "used_by", classification: "semantic", source_type: "agent_definition", target_type: "ai_model" },
+  privacy_policy_governs_compliance_requirement: { forward_verb: "governs", reverse_verb: "governed_by", classification: "semantic", source_type: "privacy_policy", target_type: "compliance_requirement" },
+  a11y_annotation_targets_design_component: { forward_verb: "targets", reverse_verb: "targeted_by", classification: "cross-domain", source_type: "a11y_annotation", target_type: "design_component" },
+  metric_quality_assessment_considers_proxy_metric: { forward_verb: "considers_proxy", reverse_verb: "proxy_for", classification: "semantic", source_type: "metric_quality_assessment", target_type: "metric" },
+  ai_experiment_based_on_ai_model: { forward_verb: "based_on", reverse_verb: "basis_for", classification: "semantic", source_type: "ai_experiment", target_type: "ai_model" },
+  rebuttal_supported_by_evidence: { forward_verb: "supported_by", reverse_verb: "supports", classification: "cross-domain", source_type: "rebuttal", target_type: "evidence" },
+  bug_observed_in_release: { forward_verb: "observed_in", reverse_verb: "exhibits", classification: "semantic", source_type: "bug", target_type: "release" },
+  vulnerability_affects_library_dependency: { forward_verb: "affects", reverse_verb: "affected_by", classification: "cross-domain", source_type: "vulnerability", target_type: "library_dependency" },
+  a11y_issue_found_in_screen: { forward_verb: "found_in", reverse_verb: "site_of", classification: "cross-domain", source_type: "a11y_issue", target_type: "screen" },
+  team_okr_cascades_from_team_okr: { forward_verb: "cascades_from", reverse_verb: "cascades_to", classification: "semantic", source_type: "team_okr", target_type: "team_okr" },
+  agent_session_invoked_agent_skill: { forward_verb: "invoked", reverse_verb: "invoked_by", classification: "semantic", source_type: "agent_session", target_type: "agent_skill" },
+  agent_task_uses_agent_skill: { forward_verb: "uses", reverse_verb: "used_by", classification: "semantic", source_type: "agent_task", target_type: "agent_skill" },
+  participant_belongs_to_behavioral_segment: { forward_verb: "belongs_to", reverse_verb: "includes", classification: "cross-domain", source_type: "participant", target_type: "behavioral_segment" },
+  classification_axis_owned_by_product: { forward_verb: "owned_by", reverse_verb: "owns", classification: "cross-domain", source_type: "classification_axis", target_type: "product" },
   // ── Part 9: Cross-Layer Influence Edges ────────────────────────────────────
   product_expressed_as_design_component: { forward_verb: "expressed_as", reverse_verb: "expresses", classification: "cross-domain", source_type: "product", target_type: "design_component" },
   product_manifests_in_design_component: { forward_verb: "manifests_in", reverse_verb: "manifested_by", classification: "cross-domain", source_type: "product", target_type: "design_component" },
@@ -3215,6 +3243,9 @@ var UPG_EDGE_CATALOG = {
   specification_competes_with_specification: { forward_verb: "competes_with", reverse_verb: "competes_with", classification: "semantic", source_type: "specification", target_type: "specification" },
   primitive_defined_by_specification: { forward_verb: "defined_by", reverse_verb: "defines", classification: "semantic", source_type: "primitive", target_type: "specification" },
   primitive_composes_primitive: { forward_verb: "composes", reverse_verb: "composed_by", classification: "hierarchy", source_type: "primitive", target_type: "primitive" },
+  // A canonical specification defines the operating lifecycle (mirrors primitive_defined_by_specification),
+  // so the lifecycle is governed rather than a standalone root (0.12.1 refinement).
+  operating_lifecycle_defined_by_specification: { forward_verb: "defined_by", reverse_verb: "defines", classification: "semantic", source_type: "operating_lifecycle", target_type: "specification" },
   operating_lifecycle_contains_operating_stage: { forward_verb: "contains", reverse_verb: "belongs_to", classification: "hierarchy", source_type: "operating_lifecycle", target_type: "operating_stage" },
   // Stewardship: a registry specification is governed by a (registry-hostable) organization (0.9.13).
   specification_governed_by_organization: { forward_verb: "governed_by", reverse_verb: "governs", classification: "semantic", source_type: "specification", target_type: "organization" },
@@ -3306,7 +3337,8 @@ var UPG_CROSS_EDGE_TYPES = [
   "competitor_signal_maps_to_feature",
   "competitor_signal_surfaces_opportunity",
   "competitor_classified_as_classification_value",
-  "node_classified_as_classification_value"
+  "node_classified_as_classification_value",
+  "journey_phase_realises_operating_stage"
 ];
 var REGISTRY_PRODUCT_ID = "registry";
 
@@ -7534,6 +7566,25 @@ function getDeprecatedTypes() {
   return deprecated;
 }
 var UPG_PROPERTY_MIGRATIONS = {
+  // ── v0.12.0: P14 Bucket C — drop the one non-derived denormalized aggregate ──
+  //
+  // The count caches (feature_count, evidence_count, workflow step_count /
+  // agent_count) are KEPT — 0.11.6 marked them `modifier:'derived'` (the
+  // sanctioned "derived cache" reframe), so tooling knows to recompute rather
+  // than removing them. `business_model.monetisation_basis` is NOT a count: it's
+  // a categorical rollup of the model's revenue_stream.billing_model children, so
+  // it drops here. `pattern` stays (a chosen archetype, not a rollup).
+  // (customer_health_score.metrics — a metric→value map — is deferred: dropping
+  // it is lossy until the per-metric values move onto the composed_of_metric
+  // edges; tracked as a follow-up.)
+  "0.12.0": [
+    {
+      kind: "drop_props",
+      type: "business_model",
+      drop_props: ["monetisation_basis"],
+      reason: "P14 Bucket C: monetisation_basis is a categorical rollup of the model\u2019s revenue_stream.billing_model children, not a first-class attribute. Drop it; KEEP `pattern` (a chosen archetype)."
+    }
+  ],
   // ── v0.10.2: market_intelligence number -> assessment reshape ──────────────
   //
   // The v0.10.0 property-registry generator fix (#43) corrected several property
@@ -8363,6 +8414,245 @@ function getSplitMigrations(fromVersion, toVersion) {
   }
   return result;
 }
+var UPG_SCALAR_TO_EDGE_MIGRATIONS = {
+  "0.12.0": [
+    // ── Bucket A1 — orphan scalars (no edge existed): add edge + migrate + drop ──
+    {
+      from_type: "business_model",
+      scalar_property: "north_star_metric",
+      target_type: "metric",
+      edge_type: "business_model_guided_by_metric",
+      target_match: "title",
+      target_defaults: { designation: "north_star" },
+      drop_scalar: true,
+      reason: 'P14: the optimised metric is a first-class entity you query across business models ("which models optimise for this metric"), not a label. Mint metric{designation:north_star} + link via business_model_guided_by_metric; drop the orphan string.'
+    },
+    // NOTE: revenue_stream.forecast is NOT promoted — its JSDoc ("Free-text
+    // forecast or projection") is narrative prose, not a ref to a forecast
+    // entity. The additive revenue_stream_projected_by_forecast edge exists for
+    // an explicit stream→forecast link; the free-text field stays.
+    {
+      from_type: "metric",
+      scalar_property: "data_source",
+      target_type: "data_source",
+      edge_type: "metric_fed_by_data_source",
+      drop_scalar: true,
+      reason: 'P14: the data source feeding a metric is queryable across metrics ("everything fed by this source"); promote the string to a metric_fed_by_data_source edge.'
+    },
+    {
+      from_type: "hallucination_report",
+      scalar_property: "root_cause",
+      target_type: "root_cause",
+      edge_type: "hallucination_report_has_root_cause",
+      drop_scalar: true,
+      reason: "P14: a root_cause is a first-class entity reused across reports; link it rather than restating the cause as a string."
+    },
+    // NOTE: prompt_version.template is NOT promoted — its JSDoc ("Template body
+    // with variable placeholders") is the prompt CONTENT, not a ref to a
+    // prompt_template entity. The additive prompt_version_child_of_prompt_template
+    // edge exists for an explicit version→template link; the content field stays.
+    {
+      from_type: "model_comparison",
+      scalar_property: "model_ids",
+      target_type: "ai_model",
+      edge_type: "model_comparison_compares_ai_model",
+      multi: true,
+      drop_scalar: true,
+      reason: "P14: the models being compared are first-class ai_model entities; one compares edge per model replaces the id-string list."
+    },
+    {
+      from_type: "launch",
+      scalar_property: "success_metrics",
+      target_type: "metric",
+      edge_type: "launch_measured_by_metric",
+      multi: true,
+      drop_scalar: true,
+      reason: "P14: success metrics are first-class metric entities measured across launches; one measured_by edge per metric replaces the string list."
+    },
+    // NOTE: user_story.as_a is NOT promoted — it is a load-bearing field of the
+    // user_story → story_statement split (the "As a <persona>" templated promise),
+    // and the value is often a role descriptor, not a persona node. Left in place.
+    {
+      from_type: "wireframe",
+      scalar_property: "screen_name",
+      target_type: "screen",
+      edge_type: "wireframe_depicts_screen",
+      drop_scalar: true,
+      reason: "P14: the depicted screen is a first-class entity; link it via wireframe_depicts_screen rather than naming it in a string."
+    },
+    {
+      from_type: "service_level_indicator",
+      scalar_property: "metric_name",
+      target_type: "metric",
+      edge_type: "service_level_indicator_measures_metric",
+      drop_scalar: true,
+      reason: "P14: the SLI\u2019s metric is a first-class entity; link it via service_level_indicator_measures_metric rather than naming it in a string."
+    },
+    {
+      from_type: "agent_definition",
+      scalar_property: "model_ref",
+      target_type: "ai_model",
+      edge_type: "agent_definition_uses_ai_model",
+      drop_scalar: true,
+      reason: 'P14: the model an agent uses is a first-class ai_model entity ("every agent on this model"); promote the ref string to a uses edge.'
+    },
+    {
+      from_type: "privacy_policy",
+      scalar_property: "regulations",
+      target_type: "compliance_requirement",
+      edge_type: "privacy_policy_governs_compliance_requirement",
+      multi: true,
+      drop_scalar: true,
+      reason: "P14: each regulation is a first-class compliance_requirement entity tracked across policies; one governs edge per requirement replaces the string list."
+    },
+    {
+      from_type: "a11y_annotation",
+      scalar_property: "target_component",
+      target_type: "design_component",
+      edge_type: "a11y_annotation_targets_design_component",
+      drop_scalar: true,
+      reason: "P14: the annotated component is a real design_component entity; link it so accessibility coverage rolls up by component."
+    },
+    {
+      from_type: "metric_quality_assessment",
+      scalar_property: "proxy_alternatives",
+      target_type: "metric",
+      edge_type: "metric_quality_assessment_considers_proxy_metric",
+      multi: true,
+      drop_scalar: true,
+      reason: "P14: proxy alternatives are first-class metric entities; one considers_proxy edge per metric replaces the name list."
+    },
+    {
+      from_type: "ai_experiment",
+      scalar_property: "foundation_model",
+      target_type: "ai_model",
+      edge_type: "ai_experiment_based_on_ai_model",
+      drop_scalar: true,
+      reason: "P14: the foundation model is a first-class ai_model entity reused across experiments; promote the string to a based_on edge."
+    },
+    {
+      from_type: "rebuttal",
+      scalar_property: "evidence_refs",
+      target_type: "evidence",
+      edge_type: "rebuttal_supported_by_evidence",
+      multi: true,
+      drop_scalar: true,
+      reason: "P14: each evidence ref is a first-class evidence entity; one supported_by edge per item replaces the ref-string list."
+    },
+    {
+      from_type: "bug",
+      scalar_property: "affected_version",
+      target_type: "release",
+      edge_type: "bug_observed_in_release",
+      drop_scalar: true,
+      reason: 'P14: the affected version is a first-class release entity ("every bug in this release"); promote the version string to an observed_in edge.'
+    },
+    {
+      from_type: "vulnerability",
+      scalar_property: "affected_package",
+      target_type: "library_dependency",
+      edge_type: "vulnerability_affects_library_dependency",
+      drop_scalar: true,
+      reason: "P14: the affected package is a first-class library_dependency entity; link it so vulnerabilities roll up by dependency."
+    },
+    {
+      from_type: "a11y_issue",
+      scalar_property: "discovered_in",
+      target_type: "screen",
+      edge_type: "a11y_issue_found_in_screen",
+      drop_scalar: true,
+      reason: "P14: the screen an issue was found in is a real screen entity; link it so issues roll up by screen rather than naming it in a string."
+    },
+    {
+      from_type: "team_okr",
+      scalar_property: "cascade_from",
+      target_type: "team_okr",
+      edge_type: "team_okr_cascades_from_team_okr",
+      drop_scalar: true,
+      reason: "P14: a cascaded OKR points at its parent OKR (a real entity); the cascade is a self-referential edge, not a name string."
+    },
+    {
+      from_type: "agent_session",
+      scalar_property: "tools_invoked",
+      target_type: "agent_skill",
+      edge_type: "agent_session_invoked_agent_skill",
+      multi: true,
+      drop_scalar: true,
+      reason: "P14: invoked tools are first-class agent_skill entities tracked across sessions; one invoked edge per skill replaces the string list."
+    },
+    {
+      from_type: "agent_task",
+      scalar_property: "tools",
+      target_type: "agent_skill",
+      edge_type: "agent_task_uses_agent_skill",
+      multi: true,
+      drop_scalar: true,
+      reason: "P14: the tools a task uses are first-class agent_skill entities; one uses edge per skill replaces the string list."
+    },
+    {
+      from_type: "participant",
+      scalar_property: "segment",
+      target_type: "behavioral_segment",
+      edge_type: "participant_belongs_to_behavioral_segment",
+      drop_scalar: true,
+      reason: "P14: a participant\u2019s segment is a first-class behavioral_segment entity queried across studies; promote the string to a belongs_to edge."
+    },
+    {
+      from_type: "classification_axis",
+      scalar_property: "owner_product",
+      target_type: "product",
+      edge_type: "classification_axis_owned_by_product",
+      target_match: "id",
+      drop_scalar: true,
+      reason: "P14: the product that owns an axis is a first-class entity; link it via classification_axis_owned_by_product. The scalar holds a product id, so match by id (no mint)."
+    },
+    // ── Bucket A2 — shadow scalars (the canonical edge ALREADY exists): backfill + drop ──
+    {
+      from_type: "growth_campaign",
+      scalar_property: "channels_targeted",
+      target_type: "acquisition_channel",
+      edge_type: "acquisition_channel_runs_growth_campaign",
+      reverse: true,
+      multi: true,
+      drop_scalar: true,
+      reason: "P14 shadow: the acquisition_channel_runs_growth_campaign edge already exists (channel\u2192campaign). Backfill any string-only channels as edges, then drop the drift-prone list."
+    },
+    {
+      from_type: "journey_step",
+      scalar_property: "touchpoint",
+      target_type: "touchpoint",
+      edge_type: "touchpoint_occurs_in_journey_step",
+      reverse: true,
+      drop_scalar: true,
+      reason: "P14 shadow: the touchpoint_occurs_in_journey_step edge already exists (touchpoint\u2192journey_step) and the field was @deprecated 0.9.9. Backfill + finish the drop."
+    },
+    {
+      from_type: "decision",
+      scalar_property: "superseded_by",
+      target_type: "decision",
+      edge_type: "decision_superseded_by_decision",
+      drop_scalar: true,
+      reason: "P14 shadow: the decision_superseded_by_decision edge already exists. Backfill the superseding decision as an edge, then drop the reference string."
+    },
+    {
+      from_type: "subscription",
+      scalar_property: "plan_name",
+      target_type: "pricing_tier",
+      edge_type: "subscription_subscribes_to_pricing_tier",
+      drop_scalar: true,
+      reason: "P14 shadow: the subscription_subscribes_to_pricing_tier edge already exists. Backfill the plan as a pricing_tier edge, then drop the name string."
+    }
+  ]
+};
+function getScalarToEdgeMigrations(fromVersion, toVersion) {
+  const result = [];
+  for (const [version, migrations] of Object.entries(UPG_SCALAR_TO_EDGE_MIGRATIONS)) {
+    if (versionInRange(version, fromVersion, toVersion)) {
+      result.push(...migrations);
+    }
+  }
+  return result;
+}
 var UPG_EDGE_MIGRATIONS = {
   "0.9.9": [
     // (since v0.9.9, UPG-664/UPG-678) Validation experiment-model + test_plan
@@ -9351,7 +9641,6 @@ var UPG_PROPERTY_SCHEMA = {
   // A11yAnnotationProperties: Accessibility annotation.
   a11y_annotation: {
     category: { type: "string", enum: ["focus_order", "alt_text", "heading_level", "aria_label", "colour_contrast", "keyboard_nav", "screen_reader", "motion_preference", "other"], description: "Category of accessibility annotation. Expanded from the original 5-value enum to cover the full range of a11y annotation types." },
-    target_component: { type: "string", description: "Component or element this annotation applies to" },
     requirement: { type: "string", description: "Specific accessibility requirement described" },
     wcag_criterion: { type: "string", description: "WCAG success criterion this annotation relates to" },
     annotation_priority: { type: "string", enum: ["urgent", "high", "medium", "low", "none"], description: "Priority for implementing this annotation" },
@@ -9400,8 +9689,7 @@ var UPG_PROPERTY_SCHEMA = {
     html_snippet: { type: "string", description: "HTML snippet containing the violation" },
     tags: { type: "string[]", description: 'Tags from the audit tool (e.g. "wcag2aa", "cat.color")' },
     remediation: { type: "string", description: "Recommended fix for the issue" },
-    impact_description: { type: "string", description: "Description of the user impact" },
-    discovered_in: { type: "string", description: "Page or component where the issue was found" }
+    impact_description: { type: "string", description: "Description of the user impact" }
   },
   // A11yStandardProperties: Accessibility standard.
   a11y_standard: {
@@ -9467,7 +9755,6 @@ var UPG_PROPERTY_SCHEMA = {
     agent_scope: { type: "string", description: "Boundaries of what this agent can act on" },
     goal: { type: "string", description: "Primary objective the agent is trying to achieve" },
     backstory: { type: "string", description: "Context or persona narrative for the agent" },
-    model_ref: { type: "string", description: "Reference to the AI model powering this agent" },
     allow_delegation: { type: "boolean", description: "Whether the agent can delegate tasks to other agents" },
     memory_enabled: { type: "boolean", description: "Whether the agent retains memory across sessions" },
     max_iterations: { type: "number", description: "Maximum number of reasoning iterations allowed" },
@@ -9491,7 +9778,6 @@ var UPG_PROPERTY_SCHEMA = {
     turns: { type: "number", description: "Number of conversational turns in the session" },
     tokens_used: { type: "number", description: "Total tokens consumed during the session" },
     cost: { type: "number", description: "Total monetary cost of the session" },
-    tools_invoked: { type: "string[]", description: "List of tools invoked during the session" },
     error_count: { type: "number", description: "Number of errors encountered during the session" },
     session_status: { type: "string", enum: ["active", "completed", "errored", "timed_out"], description: "Current status of the session" },
     output_summary: { type: "string", description: "Brief summary of the session's output" }
@@ -9507,7 +9793,6 @@ var UPG_PROPERTY_SCHEMA = {
     description: { type: "string", description: "What the agent should accomplish" },
     expected_output: { type: "string", description: "Description of the expected output format or content" },
     context: { type: "string", description: "Additional context provided to the agent for this task" },
-    tools: { type: "string[]", description: "Tools the agent may use for this task" },
     output_file: { type: "string", description: "File path where the agent should write output" },
     blocking: { type: "boolean", description: "Whether this task blocks downstream tasks" },
     priority: { type: "string", enum: ["urgent", "high", "medium", "low", "none"], description: "Relative priority of this task" }
@@ -9549,7 +9834,6 @@ var UPG_PROPERTY_SCHEMA = {
     summary_metrics: { type: "string", description: "Key-metric summary" },
     started_at: { type: "string", description: "ISO timestamp started" },
     completed_at: { type: "string", description: "ISO timestamp completed" },
-    foundation_model: { type: "string", description: "Foundation starting model" },
     training_steps: { type: "number", description: "Training steps or epochs completed" },
     artifact_uri: { type: "string", description: "Produced artifact URI" },
     notes: { type: "string", description: "Free-text notes" },
@@ -9780,7 +10064,6 @@ var UPG_PROPERTY_SCHEMA = {
     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)." },
     assignee: { type: "string", description: "Assigned person" },
-    affected_version: { type: "string", description: "Product version where first observed. Helps triage regressions." },
     due_date: { type: "string", description: "ISO date due. Often tied to a release gate or SLA." },
     labels: { type: "string[]", description: "Free-form classification tags. Applied uniformly across work item types." }
   },
@@ -9796,9 +10079,9 @@ var UPG_PROPERTY_SCHEMA = {
   business_model: {
     framework_id: { type: "string", description: "Framework ID (references `UPGFramework.id`)" },
     stage: { type: "string", enum: ["draft", "validated", "active"], description: "Maturity" },
-    pattern: { type: "string", enum: ["freemium", "marketplace", "saas", "subscription", "transactional", "advertising", "licensing", "hybrid"], description: "Canonical pattern. Useful for benchmarking against peer businesses with the same shape." },
-    monetisation_basis: { type: "string", enum: ["usage", "seat", "outcome", "transaction", "flat"], description: "Primary monetisation unit" },
-    north_star_metric: { type: "string", description: "The single metric the business optimises for" }
+    pattern: { type: "string", enum: ["freemium", "marketplace", "saas", "subscription", "transactional", "advertising", "licensing", "hybrid"], description: "Canonical pattern. Useful for benchmarking against peer businesses with the same shape." }
+    // monetisation_basis removed in 0.12.0 (P14 Bucket C) — categorical rollup of revenue_stream.billing_model.
+    // north_star_metric removed in 0.12.0 (P14) → `business_model_guided_by_metric` edge.
   },
   // CapabilityProperties: Capability entity.
   capability: {
@@ -9866,8 +10149,7 @@ var UPG_PROPERTY_SCHEMA = {
   // ClassificationAxisProperties: ClassificationAxis: a dimension along which subjects are classified.
   classification_axis: {
     axis_kind: { type: "string", enum: ["categorical", "ordinal", "continuous"], description: "Structural kind of values on this axis. `categorical` = discrete, unordered (most common; CMS architectures). `ordinal` = discrete, ordered (maturity tiers, T-shirt sizes). `continuous` = numeric range (latency budget, price points)." },
-    cardinality: { type: "string", enum: ["single", "multi"], description: 'How many values a subject may hold on this axis at once (UPG 0.11.3). `single` (default) = a subject sits at exactly one value; a re-classification to a new value SUPERSEDES the prior one (the classify writer retires the old same-axis edge and records the move in the reclassification history). `multi` = a subject may legitimately hold several values at once (e.g. an axis like "supported frameworks"); re-classifying ADDS a value and does not supersede. A separate axis from `axis_kind`: an axis can be `categorical` (unordered) yet `single`-select, or `categorical` yet `multi`-select.' },
-    owner_product: { type: "string", description: "Product id when product-specific. Axes are usually product-agnostic; leave empty for shared taxonomies." }
+    cardinality: { type: "string", enum: ["single", "multi"], description: 'How many values a subject may hold on this axis at once (UPG 0.11.3). `single` (default) = a subject sits at exactly one value; a re-classification to a new value SUPERSEDES the prior one (the classify writer retires the old same-axis edge and records the move in the reclassification history). `multi` = a subject may legitimately hold several values at once (e.g. an axis like "supported frameworks"); re-classifying ADDS a value and does not supersede. A separate axis from `axis_kind`: an axis can be `categorical` (unordered) yet `single`-select, or `categorical` yet `multi`-select.' }
   },
   // ClassificationValueProperties: ClassificationValue: a value on a classification axis.
   classification_value: {
@@ -10236,8 +10518,7 @@ var UPG_PROPERTY_SCHEMA = {
     decision_outcome: { type: "string", description: "Outcome text. What was decided. Separate from `rationale` (which explains why)." },
     consequences: { type: "string", description: `Known positive and negative consequences. Mirrors MADR's "Consequences" section.` },
     decision_makers: { type: "string[]", description: `People who made the decision. Mirrors MADR's "Deciders" field.` },
-    decision_drivers: { type: "string[]", description: `Forces, constraints, and goals that shaped the decision. Mirrors MADR's "Decision Drivers" section. @example ["must work offline", "team has no Go expertise", "cost < $500/mo"]` },
-    superseded_by: { type: "string", description: "Reference to the superseding decision, if any." }
+    decision_drivers: { type: "string[]", description: `Forces, constraints, and goals that shaped the decision. Mirrors MADR's "Decision Drivers" section. @example ["must work offline", "team has no Go expertise", "cost < $500/mo"]` }
   },
   // DeliverableProperties: Deliverable.
   deliverable: {
@@ -10771,7 +11052,6 @@ var UPG_PROPERTY_SCHEMA = {
     end_date: { type: "string", description: "ISO end date" },
     budget_amount: { type: "number", description: "Total allocated budget. Use with `budget_currency`." },
     budget_currency: { type: "string", description: 'ISO 4217 currency code (e.g. "USD", "EUR", "GBP")' },
-    channels_targeted: { type: "string[]", description: 'Channels the campaign runs across. Free-form so partner channels and ad networks both fit (e.g. "google_ads", "linkedin", "podcast_sponsorship").' },
     primary_kpi: { type: "string", description: 'Primary KPI optimised for (e.g. "qualified_signups", "MQL_volume", "activated_teams")' },
     kpi_target: { type: "number", description: "Numeric target for `primary_kpi` over the campaign window" },
     utm_parameters: { type: "string", description: "UTM tracking parameters for this campaign" },
@@ -10805,7 +11085,6 @@ var UPG_PROPERTY_SCHEMA = {
       required: ["value", "label"]
     },
     user_facing: { type: "boolean", description: "Visible to end users" },
-    root_cause: { type: "string", description: "Identified cause" },
     remediation: { type: "string", description: "Remediation steps" }
   },
   // HelpVideoProperties: Help video.
@@ -11059,7 +11338,6 @@ var UPG_PROPERTY_SCHEMA = {
   // JourneyStepProperties: Single step within a user journey. A user-moment on the journey's single
   journey_step: {
     step_order: { type: "number", description: "Display order within the journey's step timeline (0-indexed). The scalar ordering convention shared with `journey_phase.phase_order` and `journey_action.action_order` (UPG-663). For branching journeys, the explicit `journey_step_precedes_journey_step` edge captures the chain." },
-    touchpoint: { type: "string", description: "@deprecated since v0.9.9 (UPG-675). Touchpoints are modelled in two places, neither of which is this string: the `touchpoint` *entity* is the cross-channel customer-success layer (`touchpoint_occurs_in_journey_step`), and `journey_action` is the in-product blueprint layer (the finest band of a `journey_step`). Use one of those rather than a free-text string here. Removed in a future major." },
     channel: { type: "string", description: 'Channel (e.g. "web", "email", "in-store")' },
     emotion_score: {
       type: "assessment",
@@ -11132,8 +11410,7 @@ var UPG_PROPERTY_SCHEMA = {
   // LaunchProperties: Launch entity.
   launch: {
     launch_type: { type: "string", enum: ["soft", "beta", "public", "feature"], description: "Scale and audience of the launch" },
-    target_date: { type: "string", description: "Planned launch date (ISO format)" },
-    success_metrics: { type: "string[]", description: "Metrics that define launch success" }
+    target_date: { type: "string", description: "Planned launch date (ISO format)" }
   },
   // LeadProperties: Lead.
   lead: {
@@ -11293,7 +11570,6 @@ var UPG_PROPERTY_SCHEMA = {
     range_min: { type: "number", description: "Minimum expected or baseline value" },
     range_max: { type: "number", description: "Maximum expected or ceiling value" },
     cadence: { type: "string", enum: ["continuous", "hourly", "daily", "weekly", "monthly", "quarterly", "yearly", "on_demand", "other"], description: "Measurement cadence. Canonical `Cadence` since v0.4.0. `'realtime'` migrates to `'continuous'`; all other values 1:1." },
-    data_source: { type: "string", description: 'Data source or tool that feeds this metric (e.g. "PostHog", "Stripe")' },
     owner: { type: "string", description: "Person or team responsible for tracking this metric" },
     metric_health: { type: "string", enum: ["healthy", "at_risk", "unhealthy", "unknown"], description: "Universal health rollup. Orthogonal to lifecycle and `guardrail_status`. Applies to every metric regardless of `designation`. `healthy` = trending well against target / inside safe range. `at_risk` = drifting, approaching breach or target shortfall. `unhealthy` = missed target or breached; action needed. `unknown` = no current reading or not yet measured. For guardrails specifically, `guardrail_status` remains the breach-specific signal (`safe`/`warning`/`breached`)." },
     guardrail_threshold_min: { type: "number", description: "Lower bound for guardrail safety (below this = breach)" },
@@ -11311,8 +11587,7 @@ var UPG_PROPERTY_SCHEMA = {
     quality_related: { type: "boolean", description: "Quality signal: metric relates to other key metrics in the system" },
     quality_score: { type: "number", description: "Computed quality score across all quality signals (0\u20135)" },
     proxy_reason: { type: "string", enum: ["qualitative", "no_direct_measure", "not_yet_instrumented", "too_expensive"], description: "Why this metric is used as a proxy instead of measuring directly" },
-    proxy_confidence: { type: "string", enum: ["strong", "moderate", "weak"], description: "How strongly this metric predicts the direct measure" },
-    proxy_alternatives: { type: "string[]", description: "Other metrics considered as proxy candidates" }
+    proxy_confidence: { type: "string", enum: ["strong", "moderate", "weak"], description: "How strongly this metric predicts the direct measure" }
   },
   // MilestoneProperties: Milestone.
   milestone: {
@@ -11328,7 +11603,6 @@ var UPG_PROPERTY_SCHEMA = {
   },
   // ModelComparisonProperties: Model comparison.
   model_comparison: {
-    model_ids: { type: "string[]", description: "Compared model identifiers" },
     comparison_criteria: { type: "string[]", description: 'Comparison dimensions (e.g. "accuracy", "cost", "latency")' },
     comparison_date: { type: "string", description: "ISO conduct date" }
   },
@@ -11505,7 +11779,6 @@ var UPG_PROPERTY_SCHEMA = {
   // ParticipantProperties: Research participant.
   participant: {
     alias: { type: "string", description: 'Anonymous alias for privacy (e.g. "P01")' },
-    segment: { type: "string", description: "User segment this participant belongs to" },
     recruit_source: { type: "string", description: "How the participant was recruited" },
     consent_status: { type: "string", enum: ["pending", "given", "withdrawn"], description: "Current consent status for data usage" }
   },
@@ -11643,26 +11916,21 @@ var UPG_PROPERTY_SCHEMA = {
   },
   // OperatingLifecycleProperties: a canonical ordered (often cyclic) operating process products' journey phases map onto.
   operating_lifecycle: {
-    label: { type: "string", description: "Human-readable name of the operating process." },
-    cyclic: { type: "boolean", description: "True if the process loops (e.g. Analyze \u2192 Extend \u2192 Plan). Rendered linearly by stage_order with the wrap on the final stage." },
-    source: { type: "string", description: 'Origin of the canonical model (e.g. "Sanity official content-ops lifecycle").' }
+    cyclic: { type: "boolean", description: "True if the process loops (e.g. Analyze \u2192 Extend \u2192 Plan). The sequence is expressed by the stages' stage_order; cyclic adds the wrap from last stage back to first." },
+    source: { type: "string", description: 'Origin of the canonical model (e.g. "Sanity official content-ops lifecycle"). Optional provenance; promote to an edge if it names a real specification/document.' }
   },
   // OperatingStageProperties: one ordered stage of an operating_lifecycle.
   operating_stage: {
-    stage_order: { type: "number", description: "Ordered position within the lifecycle, 0-indexed." },
-    label: { type: "string", description: "Human-readable stage name." },
+    stage_order: { type: "number", description: "Ordered position within the lifecycle, 0-indexed. Source of truth for sequence." },
     goal: { type: "string", description: "What this stage accomplishes." },
-    owner_role: { type: "string", description: "Role that owns the stage (free-text role label)." },
-    os_analogy: { type: "string", description: 'The Content-OS analogy from the source volume (e.g. "Drivers + daemons / cron").' },
-    next_stage: { type: "string", description: "Label of the next stage; on the final stage of a cyclic lifecycle this carries the wrap." }
+    owner_role: { type: "string", description: "Role that owns the stage (free-text role label). Optional; promote to a node_owned_by_role edge if ownership must be queryable." }
   },
   // PrivacyPolicyProperties: Privacy policy.
   privacy_policy: {
     version: { type: "string", description: "Version identifier of the policy" },
     last_updated: { type: "string", description: "Date the policy was last updated (ISO format)" },
     effective_date: { type: "string", description: "Date the policy takes effect (ISO format)" },
-    url: { type: "string", description: "URL where the policy is published" },
-    regulations: { type: "string[]", description: 'Regulations this policy addresses (e.g. "GDPR", "CCPA")' }
+    url: { type: "string", description: "URL where the policy is published" }
   },
   // ProductProperties: The product being created. Root of the graph.
   product: {
@@ -12054,7 +12322,6 @@ var UPG_PROPERTY_SCHEMA = {
   },
   // ServiceLevelIndicatorProperties: Service Level Indicator.
   service_level_indicator: {
-    metric_name: { type: "string", description: 'Indicator metric name. @example "Request latency p99", "Error rate", "Availability"' },
     threshold: { type: "number", description: 'Threshold that defines a "good" event. @example 200 (ms latency), 0.01 (1% error rate), 99.9 (% availability)' },
     current_value: { type: "number", description: "Current observed value. Compared against `threshold` for SLO compliance. @example 150 (ms), 0.003 (0.3% error rate)", modifier: "snapshot" },
     unit: { type: "string", description: 'Unit of measurement. Required to interpret `threshold` and `current_value`. @example "ms", "%", "req/s", "errors/min"' },
@@ -12212,7 +12479,6 @@ var UPG_PROPERTY_SCHEMA = {
   },
   // SubscriptionProperties: Subscription.
   subscription: {
-    plan_name: { type: "string", description: "Name of the subscribed plan" },
     monthly_recurring_revenue: { type: "number", description: "Monthly recurring revenue from this subscription" },
     start_date: { type: "string", description: "Subscription start date (ISO format)" },
     renewal_date: { type: "string", description: "Next renewal date (ISO format)" },
@@ -12305,8 +12571,7 @@ var UPG_PROPERTY_SCHEMA = {
   team_okr: {
     period: { type: "string", description: 'Time period for the OKR (e.g. "Q2 2026")' },
     progress: { type: "number", description: "Overall progress toward the objective (0-100%)" },
-    objective_statement: { type: "string", description: "The team-level objective statement (key results live in child entities)" },
-    cascade_from: { type: "string", description: "Higher-level objective this OKR cascades from (company or department OKR)" }
+    objective_statement: { type: "string", description: "The team-level objective statement (key results live in child entities)" }
   },
   // TechnicalDebtItemProperties: Technical debt item.
   technical_debt_item: {
@@ -12559,7 +12824,6 @@ var UPG_PROPERTY_SCHEMA = {
     },
     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"' },
     exploit_maturity: { type: "string", enum: ["no_known_exploit", "proof_of_concept", "functional_exploit", "active_exploitation"], description: 'Exploit maturity. Primary prioritisation factor after severity. `no_known_exploit` = theoretical. `proof_of_concept` = exploit code exists, not weaponised. `functional_exploit` = working exploit available. `active_exploitation` = active in the wild. @example "active_exploitation" demands immediate response regardless of severity score' },
     fix_available: { type: "boolean", description: "Patch availability. Common triage question after severity. @example false for a zero-day with no available patch" },
     disclosed_at: { type: "string", description: 'ISO date publicly disclosed. Time since disclosure matters for SLA. @example "2024-03-15"' },
@@ -12584,7 +12848,6 @@ var UPG_PROPERTY_SCHEMA = {
   // WireframeProperties: Wireframe.
   wireframe: {
     fidelity: { type: "string", enum: ["low", "medium", "high"], description: "Detail level" },
-    screen_name: { type: "string", description: "Represented screen name" },
     version: { type: "string", description: 'Version or iteration (e.g. "v2", "2026-04-B")' },
     tool: { type: "string", description: 'Authoring tool. @example "Figma", "Balsamiq", "pen and paper"' },
     review_status: { type: "string", enum: ["draft", "in_review", "approved", "rejected"], description: "Review gate status" },
@@ -28332,6 +28595,7 @@ var UPG_REGIONS = [
       "specification_competes_with_specification",
       "primitive_defined_by_specification",
       "primitive_composes_primitive",
+      "operating_lifecycle_defined_by_specification",
       "operating_lifecycle_contains_operating_stage"
     ],
     boundary_edges: [
@@ -28871,7 +29135,7 @@ function isCanonical(text) {
 }
 
 // src/index.ts
-var UPG_VERSION = "0.11.6";
+var UPG_VERSION = "0.12.1";
 var UPG_FORMAT_VERSION = "0.4.0";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();
@@ -29006,6 +29270,7 @@ var UPG_META_COUNT = UPG_ENTITY_META.length;
   UPG_REGION_COUNT,
   UPG_REGION_MAP,
   UPG_RELATIONSHIP_BENCHMARKS,
+  UPG_SCALAR_TO_EDGE_MIGRATIONS,
   UPG_SCALES,
   UPG_SPLIT_MIGRATIONS,
   UPG_STATUS_MIGRATIONS,
@@ -29074,6 +29339,7 @@ var UPG_META_COUNT = UPG_ENTITY_META.length;
   getRegionForEntityType,
   getReplacementType,
   getRingForDomain,
+  getScalarToEdgeMigrations,
   getScale,
   getSplitMigrations,
   getTreePattern,