@unified-product-graph/core 0.12.0 → 0.12.2

package/dist/index.d.cts

@@ -7294,6 +7294,13 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
+    operating_lifecycle_defined_by_specification: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "semantic";
+        source_type: string;
+        target_type: string;
+    };
     operating_lifecycle_contains_operating_stage: {
         forward_verb: string;
         reverse_verb: string;
@@ -7474,7 +7481,7 @@ interface UPGProduct {
 /** Product lifecycle stages. Covers the full arc from napkin idea to end-of-life. */
 type UPGProductStage = 'concept' | 'validation' | 'build' | 'beta' | 'launch' | 'growth' | 'mature' | 'maintenance' | 'sunset';
 /** The set of valid cross-product relationship types */
-type UPGCrossEdgeType = 'shares_persona' | 'shares_competitor' | 'shares_metric' | 'depends_on_product' | 'cannibalises' | 'succeeds' | 'hosts' | 'contributes_to' | 'instance_of' | 'area_serves_persona' | 'area_targets_market_segment' | 'rolls_up_to' | 'product_implements_specification' | 'product_exposes_specification' | 'feature_conforms_to_specification' | 'api_contract_speaks_specification' | 'product_exposes_primitive' | 'feature_manipulates_primitive' | 'primitive_stored_as_data_type' | 'feature_rivals_competitor_feature' | 'competitor_signal_maps_to_feature' | 'competitor_signal_surfaces_opportunity' | 'competitor_classified_as_classification_value' | 'node_classified_as_classification_value';
+type UPGCrossEdgeType = 'shares_persona' | 'shares_competitor' | 'shares_metric' | 'depends_on_product' | 'cannibalises' | 'succeeds' | 'hosts' | 'contributes_to' | 'instance_of' | 'area_serves_persona' | 'area_targets_market_segment' | 'rolls_up_to' | 'product_implements_specification' | 'product_exposes_specification' | 'feature_conforms_to_specification' | 'api_contract_speaks_specification' | 'product_exposes_primitive' | 'feature_manipulates_primitive' | 'primitive_stored_as_data_type' | 'feature_rivals_competitor_feature' | 'competitor_signal_maps_to_feature' | 'competitor_signal_surfaces_opportunity' | 'competitor_classified_as_classification_value' | 'node_classified_as_classification_value' | 'journey_phase_realises_operating_stage';
 /**
  * Runtime-checkable list of valid cross-product edge types. Mirrors
  * `UPGCrossEdgeType` for use in validators and writers that need to test
@@ -18384,17 +18391,14 @@ interface PrimitiveProperties {
  *
  * @example
  * const properties: OperatingLifecycleProperties = {
- *   label: 'Sanity Content Operations',
  *   cyclic: true,
  *   source: 'Sanity official 5-stage content-ops lifecycle',
  * }
  */
 interface OperatingLifecycleProperties {
-    /** Human-readable name of the operating process. */
-    label?: string;
-    /** True if the process loops (e.g. Analyze → Extend → Plan). Rendered linearly by `stage_order` with the wrap on the final stage's `next_stage`. */
+    /** True if the process loops (e.g. Analyze → Extend → Plan). The sequence is fully expressed by the stages' `stage_order`; `cyclic` adds the wrap from the last stage back to the first. */
     cyclic?: boolean;
-    /** Origin of the canonical model (e.g. "Sanity official content-ops lifecycle"). */
+    /** 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`. */
     source?: string;
 }
 /** An operating_stage: one ordered stage of an `operating_lifecycle`. A product's
@@ -18404,24 +18408,16 @@ interface OperatingLifecycleProperties {
  * @example
  * const properties: OperatingStageProperties = {
  *   stage_order: 1,
- *   label: 'Create & Manage',
  *   goal: 'Model, create, and review content',
- *   os_analogy: 'The shell / GUI + file formats',
  * }
  */
 interface OperatingStageProperties {
-    /** Ordered position within the lifecycle, 0-indexed. */
+    /** Ordered position within the lifecycle, 0-indexed. The source of truth for sequence (pairs with `phase_order`/`step_order`/`action_order`). */
     stage_order?: number;
-    /** Human-readable stage name. */
-    label?: string;
     /** What this stage accomplishes. */
     goal?: string;
-    /** Role that owns the stage (free-text role label). */
+    /** Role that owns the stage (free-text role label). Optional; promote to a `node_owned_by_role` edge if ownership must be queryable across stages. */
     owner_role?: string;
-    /** The Content-OS analogy from the source volume (e.g. "Drivers + daemons / cron"). */
-    os_analogy?: string;
-    /** Label of the next stage; on the final stage of a cyclic lifecycle this carries the wrap. */
-    next_stage?: string;
 }
 
 /**
@@ -21826,7 +21822,7 @@ declare function isCanonical(text: string): boolean;
  * it stamps the `upg_version` field of every `.upg` file written by the SDK.
  * The `check:version-lockstep` gate enforces this at release time.
  */
-declare const UPG_VERSION: "0.12.0";
+declare const UPG_VERSION: "0.12.2";
 /**
  * The `.upg` JSON document format version. Written to the `upg_version` field.
  * Evolves independently from `UPG_VERSION` (the catalogue version).

package/dist/index.d.ts

@@ -7294,6 +7294,13 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
+    operating_lifecycle_defined_by_specification: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "semantic";
+        source_type: string;
+        target_type: string;
+    };
     operating_lifecycle_contains_operating_stage: {
         forward_verb: string;
         reverse_verb: string;
@@ -7474,7 +7481,7 @@ interface UPGProduct {
 /** Product lifecycle stages. Covers the full arc from napkin idea to end-of-life. */
 type UPGProductStage = 'concept' | 'validation' | 'build' | 'beta' | 'launch' | 'growth' | 'mature' | 'maintenance' | 'sunset';
 /** The set of valid cross-product relationship types */
-type UPGCrossEdgeType = 'shares_persona' | 'shares_competitor' | 'shares_metric' | 'depends_on_product' | 'cannibalises' | 'succeeds' | 'hosts' | 'contributes_to' | 'instance_of' | 'area_serves_persona' | 'area_targets_market_segment' | 'rolls_up_to' | 'product_implements_specification' | 'product_exposes_specification' | 'feature_conforms_to_specification' | 'api_contract_speaks_specification' | 'product_exposes_primitive' | 'feature_manipulates_primitive' | 'primitive_stored_as_data_type' | 'feature_rivals_competitor_feature' | 'competitor_signal_maps_to_feature' | 'competitor_signal_surfaces_opportunity' | 'competitor_classified_as_classification_value' | 'node_classified_as_classification_value';
+type UPGCrossEdgeType = 'shares_persona' | 'shares_competitor' | 'shares_metric' | 'depends_on_product' | 'cannibalises' | 'succeeds' | 'hosts' | 'contributes_to' | 'instance_of' | 'area_serves_persona' | 'area_targets_market_segment' | 'rolls_up_to' | 'product_implements_specification' | 'product_exposes_specification' | 'feature_conforms_to_specification' | 'api_contract_speaks_specification' | 'product_exposes_primitive' | 'feature_manipulates_primitive' | 'primitive_stored_as_data_type' | 'feature_rivals_competitor_feature' | 'competitor_signal_maps_to_feature' | 'competitor_signal_surfaces_opportunity' | 'competitor_classified_as_classification_value' | 'node_classified_as_classification_value' | 'journey_phase_realises_operating_stage';
 /**
  * Runtime-checkable list of valid cross-product edge types. Mirrors
  * `UPGCrossEdgeType` for use in validators and writers that need to test
@@ -18384,17 +18391,14 @@ interface PrimitiveProperties {
  *
  * @example
  * const properties: OperatingLifecycleProperties = {
- *   label: 'Sanity Content Operations',
  *   cyclic: true,
  *   source: 'Sanity official 5-stage content-ops lifecycle',
  * }
  */
 interface OperatingLifecycleProperties {
-    /** Human-readable name of the operating process. */
-    label?: string;
-    /** True if the process loops (e.g. Analyze → Extend → Plan). Rendered linearly by `stage_order` with the wrap on the final stage's `next_stage`. */
+    /** True if the process loops (e.g. Analyze → Extend → Plan). The sequence is fully expressed by the stages' `stage_order`; `cyclic` adds the wrap from the last stage back to the first. */
     cyclic?: boolean;
-    /** Origin of the canonical model (e.g. "Sanity official content-ops lifecycle"). */
+    /** 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`. */
     source?: string;
 }
 /** An operating_stage: one ordered stage of an `operating_lifecycle`. A product's
@@ -18404,24 +18408,16 @@ interface OperatingLifecycleProperties {
  * @example
  * const properties: OperatingStageProperties = {
  *   stage_order: 1,
- *   label: 'Create & Manage',
  *   goal: 'Model, create, and review content',
- *   os_analogy: 'The shell / GUI + file formats',
  * }
  */
 interface OperatingStageProperties {
-    /** Ordered position within the lifecycle, 0-indexed. */
+    /** Ordered position within the lifecycle, 0-indexed. The source of truth for sequence (pairs with `phase_order`/`step_order`/`action_order`). */
     stage_order?: number;
-    /** Human-readable stage name. */
-    label?: string;
     /** What this stage accomplishes. */
     goal?: string;
-    /** Role that owns the stage (free-text role label). */
+    /** Role that owns the stage (free-text role label). Optional; promote to a `node_owned_by_role` edge if ownership must be queryable across stages. */
     owner_role?: string;
-    /** The Content-OS analogy from the source volume (e.g. "Drivers + daemons / cron"). */
-    os_analogy?: string;
-    /** Label of the next stage; on the final stage of a cyclic lifecycle this carries the wrap. */
-    next_stage?: string;
 }
 
 /**
@@ -21826,7 +21822,7 @@ declare function isCanonical(text: string): boolean;
  * it stamps the `upg_version` field of every `.upg` file written by the SDK.
  * The `check:version-lockstep` gate enforces this at release time.
  */
-declare const UPG_VERSION: "0.12.0";
+declare const UPG_VERSION: "0.12.2";
 /**
  * The `.upg` JSON document format version. Written to the `upg_version` field.
  * Evolves independently from `UPG_VERSION` (the catalogue version).

package/dist/index.js

@@ -3029,6 +3029,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" },
@@ -3120,7 +3123,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";
 
@@ -11698,18 +11702,14 @@ 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: {
@@ -28381,6 +28381,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: [
@@ -28920,7 +28921,7 @@ function isCanonical(text) {
 }
 
 // src/index.ts
-var UPG_VERSION = "0.12.0";
+var UPG_VERSION = "0.12.2";
 var UPG_FORMAT_VERSION = "0.4.0";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();