@unified-product-graph/core 0.11.5 → 0.12.0

package/dist/index.js

@@ -494,7 +494,7 @@ var UPG_DOMAINS = [
     id: "foundations",
     label: "Foundations",
     description: "The shared specifications and foundational primitives a product organisation stewards or implements everywhere. Specifications are governed specs (query languages, protocols, data formats, encodings) like GROQ or Portable Text; primitives are the compositional units those specs define (a block, a reference, a query value). Both are registry-hostable canonicals that products implement, expose, or conform to. Distinct from a product feature: a specification has no single owner, no P&L, and no buyer; it is the rulebook many products point at.",
-    types: ["specification", "primitive"]
+    types: ["specification", "primitive", "operating_lifecycle", "operating_stage"]
   }
 ];
 var UPG_ENTITY_TO_DOMAIN = Object.freeze(
@@ -517,6 +517,8 @@ var UPG_ENTITY_META = [
   // Foundations (0.9.12): shared specifications + the primitives they define.
   { name: "specification", type_id: "ent_352", maturity: "proposed", since: "0.9.12" },
   { name: "primitive", type_id: "ent_353", maturity: "proposed", since: "0.9.12" },
+  { name: "operating_lifecycle", type_id: "ent_355", maturity: "proposed", since: "0.11.6" },
+  { name: "operating_stage", type_id: "ent_356", maturity: "proposed", since: "0.11.6" },
   // ── Strategic ──
   { name: "product", type_id: "ent_001", maturity: "stable", since: "0.1.0" },
   { name: "outcome", type_id: "ent_002", maturity: "stable", since: "0.1.0" },
@@ -1017,6 +1019,9 @@ var UPG_EDGE_CATALOG = {
   persona_pursues_job: { forward_verb: "pursues", reverse_verb: "pursued_by", classification: "semantic", source_type: "persona", target_type: "job" },
   persona_experiences_need: { forward_verb: "experiences", reverse_verb: "experienced_by", classification: "semantic", source_type: "persona", target_type: "need" },
   persona_aspires_to_desired_outcome: { forward_verb: "aspires_to", reverse_verb: "aspirational_for", classification: "hierarchy", source_type: "persona", target_type: "desired_outcome" },
+  // Delegation (0.11.6): a persona delegates work to another. The common case is human -> agent
+  // (Content Ops Lead -> Content Agent), but it also expresses human -> human (editor -> reviewer).
+  persona_delegates_to_persona: { forward_verb: "delegates_to", reverse_verb: "delegated_by", classification: "semantic", source_type: "persona", target_type: "persona" },
   persona_incurs_switching_cost: { forward_verb: "incurs", reverse_verb: "incurred_by", classification: "hierarchy", source_type: "persona", target_type: "switching_cost" },
   job_surfaces_need: { forward_verb: "surfaces", reverse_verb: "surfaces_from", classification: "causal", source_type: "job", target_type: "need" },
   job_motivates_desired_outcome: { forward_verb: "motivates", reverse_verb: "motivated_by", classification: "causal", source_type: "job", target_type: "desired_outcome" },
@@ -2179,6 +2184,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" },
@@ -2998,8 +3029,13 @@ 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" },
+  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" }
+  specification_governed_by_organization: { forward_verb: "governed_by", reverse_verb: "governs", classification: "semantic", source_type: "specification", target_type: "organization" },
+  // Operating-lifecycle cross-edges (0.11.6): a product's journey phase realises a canonical
+  // operating stage (the cross-surface join key); a stage is measured by a rollup metric (loop close).
+  journey_phase_realises_operating_stage: { forward_verb: "realises", reverse_verb: "realised_by", classification: "cross-domain", source_type: "journey_phase", target_type: "operating_stage" },
+  operating_stage_measured_by_metric: { forward_verb: "measured_by", reverse_verb: "measures", classification: "cross-domain", source_type: "operating_stage", target_type: "metric" }
 };
 var UPG_POLYMORPHIC_EDGE_KEYS = [
   // Universal semantic verbs
@@ -3155,6 +3191,9 @@ var UPG_VALID_CHILDREN = {
   //    primitive_composes_primitive catalog edges.
   specification: ["specification"],
   primitive: ["primitive"],
+  // An operating_lifecycle (e.g. the content-ops lifecycle) contains its ordered
+  // operating_stage children. Backs the operating_lifecycle_contains_operating_stage edge.
+  operating_lifecycle: ["operating_stage"],
   // ── Product (root) ─────────────────────────────────────────────────────────
   product: [
     // Strategy
@@ -6218,9 +6257,13 @@ function getLifecycleForType(entityType) {
   return UPG_LIFECYCLES.find((l) => l.entity_type === entityType);
 }
 var UPG_LIFECYCLE_FREE_TYPES = /* @__PURE__ */ new Set([
-  // ── Foundations (1 of 2): a primitive either exists or is deprecated; no
-  //    phase ladder (like metric). `specification` carries a lifecycle. ──
+  // ── Foundations (3 of 4): a primitive either exists or is deprecated; no
+  //    phase ladder (like metric). `operating_lifecycle`/`operating_stage` are
+  //    static ordered reference data (the loop is a `cyclic` flag, not a state
+  //    machine). `specification` carries a lifecycle. ──
   "primitive",
+  "operating_lifecycle",
+  "operating_stage",
   // ── User (5): personas and JTBD atoms are reference data ──────────────────
   "persona",
   "job",
@@ -7305,6 +7348,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
@@ -8134,6 +8196,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
@@ -9122,7 +9423,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" },
@@ -9171,8 +9471,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: {
@@ -9238,7 +9537,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" },
@@ -9262,7 +9560,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" }
@@ -9278,7 +9575,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" }
@@ -9320,7 +9616,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" },
@@ -9551,7 +9846,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." }
   },
@@ -9567,9 +9861,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: {
@@ -9637,8 +9931,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: {
@@ -9649,7 +9942,7 @@ var UPG_PROPERTY_SCHEMA = {
   },
   // CodeRepositoryProperties: Code repository.
   code_repository: {
-    repo_url: { type: "string", description: "URL" },
+    repo_url: { type: "string", description: "URL", modifier: "volatile" },
     default_branch: { type: "string", description: "Default branch" },
     language: { type: "string", description: "Primary programming language" },
     ci_status: { type: "string", enum: ["passing", "failing", "unknown"], description: "Current CI status" },
@@ -9910,7 +10203,7 @@ var UPG_PROPERTY_SCHEMA = {
   data_classification: {
     level: { type: "string", enum: ["public", "internal", "confidential", "restricted"], description: "Sensitivity level" },
     handling_requirements: { type: "string", description: "Handling rules" },
-    examples: { type: "string", description: "Example data covered" },
+    examples: { type: "string[]", description: "Example data covered" },
     retention_period: { type: "string", description: "Retention period" },
     encryption_required: { type: "boolean", description: "Whether encryption is mandatory" }
   },
@@ -10007,8 +10300,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: {
@@ -10404,7 +10696,7 @@ var UPG_PROPERTY_SCHEMA = {
   feature_area: {
     scope_summary: { type: "string", description: "One-line scope description. Disambiguates from sibling areas at a glance." },
     owning_team: { type: "string", description: "Team identifier or slug. Free-form display. Canonical relationship is the `team_owns_feature_area` edge." },
-    feature_count: { type: "number", description: "Approximate feature count under this area. Snapshot; `feature_area_contains_feature` edges are the source of truth." },
+    feature_count: { type: "number", description: "Approximate feature count under this area. Snapshot; `feature_area_contains_feature` edges are the source of truth.", modifier: "derived" },
     owner: { type: "string", description: "Area owner (handle or email)" },
     priority: { type: "string", enum: ["urgent", "high", "medium", "low", "none"], description: "Importance to the product overall" },
     maturity: { type: "string", enum: ["nascent", "growing", "mature", "legacy"], description: "Maturity. `nascent` = newly-formed grouping. `mature` = established surface. `legacy` = being phased out for a successor." },
@@ -10521,7 +10813,7 @@ var UPG_PROPERTY_SCHEMA = {
   // FunnelProperties: Funnel entity.
   funnel: {
     funnel_type: { type: "string", enum: ["acquisition", "activation", "retention", "revenue", "referral", "custom"], description: "Which stage of the customer lifecycle this funnel measures" },
-    step_count: { type: "number", description: "Number of steps in the funnel" },
+    step_count: { type: "number", description: "Number of steps in the funnel", modifier: "derived" },
     overall_conversion_rate: { type: "number", description: "End-to-end conversion rate through the funnel (0-1)" }
   },
   // FunnelStepProperties: FunnelStep entity.
@@ -10542,7 +10834,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" },
@@ -10576,7 +10867,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.
@@ -10674,7 +10964,7 @@ var UPG_PROPERTY_SCHEMA = {
       },
       required: ["value", "label"]
     },
-    evidence_count: { type: "number", description: "Supporting observations, quotes, or evidence items. Higher counts increase confidence." },
+    evidence_count: { type: "number", description: "Supporting observations, quotes, or evidence items. Higher counts increase confidence.", modifier: "derived" },
     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." },
     source_method: { type: "string", description: 'Producing research method. @example "usability_study", "interview_series", "survey"' },
@@ -10830,7 +11120,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",
@@ -10903,8 +11192,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: {
@@ -11064,7 +11352,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)" },
@@ -11082,8 +11369,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: {
@@ -11099,7 +11385,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" }
   },
@@ -11276,7 +11561,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" }
   },
@@ -11348,7 +11632,8 @@ var UPG_PROPERTY_SCHEMA = {
     motivation: { type: "string", description: 'Primary motivation or driving need @example "Making confident, evidence-based decisions"' },
     tech_comfort: { type: "string", enum: ["low", "medium", "high", "expert", "other"], description: "Tech comfort. Closed set so personas across products compare on the same axis. Free-text colour belongs in `context` or `motivation`." },
     domain_expertise: { type: "string", description: 'Industry or domain knowledge this persona brings @example "10+ years SaaS experience", "New to healthcare IT"' },
-    audience_role: { type: "string", enum: ["buyer", "user", "champion", "influencer", "partner"], description: 'Role in the buying / adoption decision (the decision-making-unit split): who signs (buyer) vs who uses (user) vs who advocates internally (champion) vs who shapes the choice (influencer) vs who delivers / implements (partner). A portfolio must separate the economic buyer from the practitioner user; they are distinct personas with distinct jobs. Closed set so roles compare across products. @example "buyer"' }
+    audience_role: { type: "string", enum: ["buyer", "user", "champion", "influencer", "partner"], description: 'Role in the buying / adoption decision (the decision-making-unit split): who signs (buyer) vs who uses (user) vs who advocates internally (champion) vs who shapes the choice (influencer) vs who delivers / implements (partner). A portfolio must separate the economic buyer from the practitioner user; they are distinct personas with distinct jobs. Closed set so roles compare across products. @example "buyer"' },
+    actor_kind: { type: "string", enum: ["human", "agent", "system"], description: "Who performs the work: a human archetype (default; absent = human, no migration), an autonomous AI agent (e.g. Content Agent), or a non-agentic platform service. An agent persona participates in journeys via the same persona machinery and is delegated to via persona_delegates_to_persona. Human-coverage / segmentation metrics count human only; agent/system opt-in." }
   },
   // PipelineSalesProperties: Sales pipeline.
   pipeline_sales: {
@@ -11411,13 +11696,27 @@ var UPG_PROPERTY_SCHEMA = {
     defined_by: { type: "string", description: "The `specification/<slug>` this primitive comes from; nullable for spec-less internal primitives. Mirrors the `primitive_defined_by_specification` edge for quick lookup." },
     since: { type: "string", description: "Year or version the primitive was introduced." }
   },
+  // 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").' }
+  },
+  // 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." },
+    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." }
+  },
   // 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: {
@@ -11809,9 +12108,8 @@ 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)" },
+    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"' },
     aggregation: { type: "string", enum: ["avg", "sum", "max", "min", "p50", "p95", "p99", "count"], description: 'Aggregation over the evaluation window. p99 and avg tell different stories. @example "p99" for tail latency, "avg" for mean throughput, "count" for total events' },
     measurement_query: { type: "string", description: "Query expression that produces `current_value`. Free-form to fit PromQL, Datadog query strings, SQL, or vendor-specific DSLs. @example 'sum(rate(http_requests_total{status=~\"5..\"}[5m])) / sum(rate(http_requests_total[5m]))'" },
@@ -11967,7 +12265,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)" },
@@ -12060,8 +12357,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: {
@@ -12314,7 +12610,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"' },
@@ -12339,7 +12634,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" },
@@ -12357,7 +12651,7 @@ var UPG_PROPERTY_SCHEMA = {
     completed_at: { type: "string", description: "ISO timestamp when the run completed" },
     run_status: { type: "string", enum: ["pending", "running", "completed", "failed", "canceled"], description: "Current execution status of the run" },
     triggering_event: { type: "string", description: "Event or action that triggered this run" },
-    step_count: { type: "number", description: "Number of steps executed in this run" },
+    step_count: { type: "number", description: "Number of steps executed in this run", modifier: "derived" },
     total_tokens: { type: "number", description: "Total tokens consumed across all steps" },
     total_cost: { type: "number", description: "Total monetary cost of the run" },
     error_message: { type: "string", description: "Error message if the run failed" }
@@ -12365,8 +12659,8 @@ var UPG_PROPERTY_SCHEMA = {
   // WorkflowTemplateProperties: Workflow template.
   workflow_template: {
     template_type: { type: "string", enum: ["sequential", "parallel", "conditional", "loop"], description: "Execution pattern for the workflow steps" },
-    step_count: { type: "number", description: "Number of steps in the workflow" },
-    agent_count: { type: "number", description: "Number of agents involved in the workflow" },
+    step_count: { type: "number", description: "Number of steps in the workflow", modifier: "derived" },
+    agent_count: { type: "number", description: "Number of agents involved in the workflow", modifier: "derived" },
     estimated_duration: { type: "string", description: "Estimated wall-clock duration of a full run" },
     state_schema: { type: "string", description: "Schema describing the workflow's state object" },
     checkpoint_enabled: { type: "boolean", description: "Whether the workflow supports checkpointing for recovery" },
@@ -18865,6 +19159,8 @@ var ENTITY_EMOJI = {
   pricing_strategy: "\u{1F4B1}",
   pricing_tier: "\u{1F949}",
   primitive: "\u{1F4CB}",
+  operating_lifecycle: "\u{1F504}",
+  operating_stage: "\u{1F539}",
   privacy_policy: "\u{1F6E1}\uFE0F",
   product: "\u{1F9EC}",
   product_area: "\u{1FA80}",
@@ -22677,7 +22973,7 @@ var WORKSPACE_GUIDE = {
 var FOUNDATIONS_GUIDE = {
   domain_id: "foundations",
   anchor_entity: "specification",
-  creation_sequence: ["specification", "primitive"],
+  creation_sequence: ["specification", "primitive", "operating_lifecycle", "operating_stage"],
   patterns: [
     {
       name: "Specification defines primitives",
@@ -26044,6 +26340,7 @@ var UPG_REGIONS = [
       "persona_experiences_need",
       "persona_aspires_to_desired_outcome",
       "persona_incurs_switching_cost",
+      "persona_delegates_to_persona",
       "job_surfaces_need"
     ],
     boundary_edges: [
@@ -28063,6 +28360,14 @@ var UPG_REGIONS = [
       {
         type: "primitive",
         role: "container"
+      },
+      {
+        type: "operating_lifecycle",
+        role: "container"
+      },
+      {
+        type: "operating_stage",
+        role: "leaf"
       }
     ],
     anchor: {
@@ -28075,9 +28380,21 @@ var UPG_REGIONS = [
       "specification_extends_specification",
       "specification_competes_with_specification",
       "primitive_defined_by_specification",
-      "primitive_composes_primitive"
+      "primitive_composes_primitive",
+      "operating_lifecycle_contains_operating_stage"
     ],
-    boundary_edges: []
+    boundary_edges: [
+      {
+        direction: "import",
+        edge_id: "journey_phase_realises_operating_stage",
+        crosses_into: "experience_design_brand"
+      },
+      {
+        direction: "export",
+        edge_id: "operating_stage_measured_by_metric",
+        crosses_into: "analytics_data"
+      }
+    ]
   }
 ];
 var UPG_REGION_MAP = Object.fromEntries(UPG_REGIONS.map((r) => [r.id, r]));
@@ -28603,7 +28920,7 @@ function isCanonical(text) {
 }
 
 // src/index.ts
-var UPG_VERSION = "0.11.5";
+var UPG_VERSION = "0.12.0";
 var UPG_FORMAT_VERSION = "0.4.0";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();
@@ -28737,6 +29054,7 @@ export {
   UPG_REGION_COUNT,
   UPG_REGION_MAP,
   UPG_RELATIONSHIP_BENCHMARKS,
+  UPG_SCALAR_TO_EDGE_MIGRATIONS,
   UPG_SCALES,
   UPG_SPLIT_MIGRATIONS,
   UPG_STATUS_MIGRATIONS,
@@ -28805,6 +29123,7 @@ export {
   getRegionForEntityType,
   getReplacementType,
   getRingForDomain,
+  getScalarToEdgeMigrations,
   getScale,
   getSplitMigrations,
   getTreePattern,