@unified-product-graph/core 0.23.0 → 0.23.1

package/dist/index.d.cts

@@ -7597,6 +7597,14 @@ declare const UPG_EDGE_CATALOG: {
         target_type: string;
         cross_product_eligible: true;
     };
+    dependency_resolved_by_objective: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+        cross_product_eligible: true;
+    };
     objective_raises_strategic_question: {
         forward_verb: string;
         reverse_verb: string;
@@ -8202,7 +8210,7 @@ interface UPGPortfolioDocument {
 /**
  * Legacy product-stage aliases (UPG-509 Part 2).
  *
- * Existing graphs (`entopo.upg`, `sanity.upg`, `maximum-minimum.upg`,
+ * Existing graphs (`entopo.upg`, `nimbus.upg`, `maximum-minimum.upg`,
  * `notion-saturated.upg`, etc.) carry `product.stage` values that pre-date
  * the canonical `UPGProductStage` enum
  * (`concept | validation | build | beta | launch | growth | mature |
@@ -8645,7 +8653,7 @@ declare const UPG_DOMAINS: readonly [{
 }, {
     readonly id: "foundations";
     readonly label: "Foundations";
-    readonly 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.";
+    readonly 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 NQL or Structured 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.";
     readonly types: readonly ["specification", "primitive", "operating_lifecycle", "operating_stage"];
 }];
 /**
@@ -9839,7 +9847,7 @@ declare function migrateEdge<T extends {
  * type's lifecycle exists but the graph carries pre-canonical status values
  * the lifecycle never had.
  *
- * Source: live drift in `.upg/entopo.upg`, `.upg/sanity.upg`, and
+ * Source: live drift in `.upg/entopo.upg`, `.upg/nimbus.upg`, and
  * `.upg/inkling.upg` surveyed during the v0.5 launch train (UPG-527).
  * Highest single drift class: 173 `service` nodes with `status: "active"`
  * against the canonical `[development, staging, production, deprecated]`
@@ -11466,7 +11474,7 @@ interface CompetitorProperties {
     /**
      * Provenance: where this was observed. A changelog, pricing, or docs URL,
      * an analyst report, or a research note.
-     * @example "https://www.contentful.com/pricing/"
+     * @example "https://docs.larch.example/pricing/"
      */
     source?: string;
     /**
@@ -11518,7 +11526,7 @@ interface CompetitorFeatureProperties {
     /**
      * Provenance: where this was observed. A changelog, pricing, or docs URL,
      * an analyst report, or a research note.
-     * @example "https://www.contentful.com/changelog/"
+     * @example "https://docs.larch.example/changelog/"
      */
     source?: string;
     /**
@@ -11640,7 +11648,7 @@ interface CompetitiveAnalysisProperties {
      *
      * @example
      *   [
-     *     { axis_a_value_ref: 'val-git-based', axis_b_value_ref: 'val-portable-text',
+     *     { axis_a_value_ref: 'val-git-based', axis_b_value_ref: 'val-structured-text',
      *       rationale_kind: 'opportunity',
      *       rationale_md: 'No technical reason; only adoption inertia. Watching brief.' },
      *     { axis_a_value_ref: 'val-composable', axis_b_value_ref: 'val-wysiwyg',
@@ -11658,7 +11666,7 @@ interface CompetitiveAnalysisProperties {
     /**
      * Provenance: where this was observed. A changelog, pricing, or docs URL,
      * an analyst report, or a research note.
-     * @example "https://www.contentful.com/changelog/"
+     * @example "https://docs.larch.example/changelog/"
      */
     source?: string;
     /**
@@ -11737,7 +11745,7 @@ interface CompetitorSignalProperties {
     /**
      * Provenance: where this was observed. A changelog, pricing, or docs URL,
      * an analyst report, or a research note.
-     * @example "https://www.contentful.com/changelog/"
+     * @example "https://docs.larch.example/changelog/"
      */
     source?: string;
     /**
@@ -11865,14 +11873,14 @@ interface ClassificationAxisProperties {
  * @example
  * const properties: ClassificationValueProperties = {
  *   rationale: 'Composable extends headless with three load-bearing commitments.',
- *   exemplars: ['Sanity', 'Contentful', 'Hygraph'],
+ *   exemplars: ['Nimbus', 'Larch', 'Prism'],
  *   commitments: [
  *     { name: 'Typed content graph', description: 'Schemas in code; references as edges.' },
  *     { name: 'Real-time backend', description: 'Live queries, CRDT collaboration.' },
  *     { name: 'Embeddable studio', description: 'Editor is a library hosted inside the team app.' },
  *   ],
  *   capabilities: [
- *     { surface: 'delivery', bullets: ['GROQ', 'GraphQL', 'REST', 'Live Content API'] },
+ *     { surface: 'delivery', bullets: ['NQL', 'GraphQL', 'REST', 'Live Sync API'] },
  *   ],
  * }
  */
@@ -11885,7 +11893,7 @@ interface ClassificationValueProperties {
     /**
      * Free-text examples of products occupying this value.
      * For queryable occupancy, prefer `competitor` nodes with `classified_as` edges.
-     * @example ['Sanity', 'Contentful', 'Hygraph']
+     * @example ['Nimbus', 'Larch', 'Prism']
      */
     exemplars?: string[];
     /**
@@ -11912,8 +11920,8 @@ interface ClassificationValueProperties {
      *
      * @example
      *   [
-     *     { surface: 'delivery', bullets: ['GROQ', 'GraphQL', 'REST', 'Live Content API', 'Asset CDN'] },
-     *     { surface: 'extensibility', bullets: ['Custom input components', 'Studio plugins'] },
+     *     { surface: 'delivery', bullets: ['NQL', 'GraphQL', 'REST', 'Live Sync API', 'Asset CDN'] },
+     *     { surface: 'extensibility', bullets: ['Custom input components', 'editor plugins'] },
      *   ]
      */
     capabilities?: Array<ClassificationCapability>;
@@ -18857,9 +18865,9 @@ interface FrameworkExerciseProperties {
  *   kind: 'language',
  *   language_flavor: 'query',
  *   governance: 'open_spec_stewarded',
- *   steward: 'Sanity',
+ *   steward: 'Nimbus',
  *   openness: 'open',
- *   spec_url: 'https://sanity.io/docs/groq',
+ *   spec_url: 'https://nimbus.example/docs/nql',
  *   current_version: '1.0',
  *   since: '2019',
  * }
@@ -18889,13 +18897,13 @@ interface SpecificationProperties {
     conformance?: string;
 }
 /** A foundational compositional unit a specification defines: the noun products
- * pass around and compose with (a Portable Text block, a Sanity reference, a
+ * pass around and compose with (a Structured Text block, a typed reference, a
  * Git commit, a Stripe PaymentIntent). Lifecycle-free, like `metric`.
  *
  * @example
  * const properties: PrimitiveProperties = {
  *   primitive_kind: 'block',
- *   defined_by: 'specification/portable_text',
+ *   defined_by: 'specification/structured_text',
  *   since: '2018',
  * }
  */
@@ -18908,7 +18916,7 @@ interface PrimitiveProperties {
     since?: string;
 }
 /** An operating_lifecycle: a canonical, ordered (often cyclic) operating process
- * that many products' journey phases map onto — e.g. Sanity's content-operations
+ * that many products' journey phases map onto — e.g. Nimbus's content-operations
  * lifecycle. Registry-hostable like a `specification`; the cross-product join key
  * that turns per-surface journeys into one operation. Distinct from the per-entity
  * status `lifecycle` grammar concept (this is an entity, not a state machine).
@@ -18916,13 +18924,13 @@ interface PrimitiveProperties {
  * @example
  * const properties: OperatingLifecycleProperties = {
  *   cyclic: true,
- *   source: 'Sanity official 5-stage content-ops lifecycle',
+ *   source: 'a canonical 5-stage content-ops lifecycle',
  * }
  */
 interface OperatingLifecycleProperties {
     /** 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"). Optional provenance; promote to an edge if it names a real `specification`/`document`. */
+    /** Origin of the canonical model (e.g. "a published 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
@@ -22532,7 +22540,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.23.0";
+declare const UPG_VERSION: "0.23.1";
 /**
  * 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

@@ -7597,6 +7597,14 @@ declare const UPG_EDGE_CATALOG: {
         target_type: string;
         cross_product_eligible: true;
     };
+    dependency_resolved_by_objective: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+        cross_product_eligible: true;
+    };
     objective_raises_strategic_question: {
         forward_verb: string;
         reverse_verb: string;
@@ -8202,7 +8210,7 @@ interface UPGPortfolioDocument {
 /**
  * Legacy product-stage aliases (UPG-509 Part 2).
  *
- * Existing graphs (`entopo.upg`, `sanity.upg`, `maximum-minimum.upg`,
+ * Existing graphs (`entopo.upg`, `nimbus.upg`, `maximum-minimum.upg`,
  * `notion-saturated.upg`, etc.) carry `product.stage` values that pre-date
  * the canonical `UPGProductStage` enum
  * (`concept | validation | build | beta | launch | growth | mature |
@@ -8645,7 +8653,7 @@ declare const UPG_DOMAINS: readonly [{
 }, {
     readonly id: "foundations";
     readonly label: "Foundations";
-    readonly 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.";
+    readonly 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 NQL or Structured 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.";
     readonly types: readonly ["specification", "primitive", "operating_lifecycle", "operating_stage"];
 }];
 /**
@@ -9839,7 +9847,7 @@ declare function migrateEdge<T extends {
  * type's lifecycle exists but the graph carries pre-canonical status values
  * the lifecycle never had.
  *
- * Source: live drift in `.upg/entopo.upg`, `.upg/sanity.upg`, and
+ * Source: live drift in `.upg/entopo.upg`, `.upg/nimbus.upg`, and
  * `.upg/inkling.upg` surveyed during the v0.5 launch train (UPG-527).
  * Highest single drift class: 173 `service` nodes with `status: "active"`
  * against the canonical `[development, staging, production, deprecated]`
@@ -11466,7 +11474,7 @@ interface CompetitorProperties {
     /**
      * Provenance: where this was observed. A changelog, pricing, or docs URL,
      * an analyst report, or a research note.
-     * @example "https://www.contentful.com/pricing/"
+     * @example "https://docs.larch.example/pricing/"
      */
     source?: string;
     /**
@@ -11518,7 +11526,7 @@ interface CompetitorFeatureProperties {
     /**
      * Provenance: where this was observed. A changelog, pricing, or docs URL,
      * an analyst report, or a research note.
-     * @example "https://www.contentful.com/changelog/"
+     * @example "https://docs.larch.example/changelog/"
      */
     source?: string;
     /**
@@ -11640,7 +11648,7 @@ interface CompetitiveAnalysisProperties {
      *
      * @example
      *   [
-     *     { axis_a_value_ref: 'val-git-based', axis_b_value_ref: 'val-portable-text',
+     *     { axis_a_value_ref: 'val-git-based', axis_b_value_ref: 'val-structured-text',
      *       rationale_kind: 'opportunity',
      *       rationale_md: 'No technical reason; only adoption inertia. Watching brief.' },
      *     { axis_a_value_ref: 'val-composable', axis_b_value_ref: 'val-wysiwyg',
@@ -11658,7 +11666,7 @@ interface CompetitiveAnalysisProperties {
     /**
      * Provenance: where this was observed. A changelog, pricing, or docs URL,
      * an analyst report, or a research note.
-     * @example "https://www.contentful.com/changelog/"
+     * @example "https://docs.larch.example/changelog/"
      */
     source?: string;
     /**
@@ -11737,7 +11745,7 @@ interface CompetitorSignalProperties {
     /**
      * Provenance: where this was observed. A changelog, pricing, or docs URL,
      * an analyst report, or a research note.
-     * @example "https://www.contentful.com/changelog/"
+     * @example "https://docs.larch.example/changelog/"
      */
     source?: string;
     /**
@@ -11865,14 +11873,14 @@ interface ClassificationAxisProperties {
  * @example
  * const properties: ClassificationValueProperties = {
  *   rationale: 'Composable extends headless with three load-bearing commitments.',
- *   exemplars: ['Sanity', 'Contentful', 'Hygraph'],
+ *   exemplars: ['Nimbus', 'Larch', 'Prism'],
  *   commitments: [
  *     { name: 'Typed content graph', description: 'Schemas in code; references as edges.' },
  *     { name: 'Real-time backend', description: 'Live queries, CRDT collaboration.' },
  *     { name: 'Embeddable studio', description: 'Editor is a library hosted inside the team app.' },
  *   ],
  *   capabilities: [
- *     { surface: 'delivery', bullets: ['GROQ', 'GraphQL', 'REST', 'Live Content API'] },
+ *     { surface: 'delivery', bullets: ['NQL', 'GraphQL', 'REST', 'Live Sync API'] },
  *   ],
  * }
  */
@@ -11885,7 +11893,7 @@ interface ClassificationValueProperties {
     /**
      * Free-text examples of products occupying this value.
      * For queryable occupancy, prefer `competitor` nodes with `classified_as` edges.
-     * @example ['Sanity', 'Contentful', 'Hygraph']
+     * @example ['Nimbus', 'Larch', 'Prism']
      */
     exemplars?: string[];
     /**
@@ -11912,8 +11920,8 @@ interface ClassificationValueProperties {
      *
      * @example
      *   [
-     *     { surface: 'delivery', bullets: ['GROQ', 'GraphQL', 'REST', 'Live Content API', 'Asset CDN'] },
-     *     { surface: 'extensibility', bullets: ['Custom input components', 'Studio plugins'] },
+     *     { surface: 'delivery', bullets: ['NQL', 'GraphQL', 'REST', 'Live Sync API', 'Asset CDN'] },
+     *     { surface: 'extensibility', bullets: ['Custom input components', 'editor plugins'] },
      *   ]
      */
     capabilities?: Array<ClassificationCapability>;
@@ -18857,9 +18865,9 @@ interface FrameworkExerciseProperties {
  *   kind: 'language',
  *   language_flavor: 'query',
  *   governance: 'open_spec_stewarded',
- *   steward: 'Sanity',
+ *   steward: 'Nimbus',
  *   openness: 'open',
- *   spec_url: 'https://sanity.io/docs/groq',
+ *   spec_url: 'https://nimbus.example/docs/nql',
  *   current_version: '1.0',
  *   since: '2019',
  * }
@@ -18889,13 +18897,13 @@ interface SpecificationProperties {
     conformance?: string;
 }
 /** A foundational compositional unit a specification defines: the noun products
- * pass around and compose with (a Portable Text block, a Sanity reference, a
+ * pass around and compose with (a Structured Text block, a typed reference, a
  * Git commit, a Stripe PaymentIntent). Lifecycle-free, like `metric`.
  *
  * @example
  * const properties: PrimitiveProperties = {
  *   primitive_kind: 'block',
- *   defined_by: 'specification/portable_text',
+ *   defined_by: 'specification/structured_text',
  *   since: '2018',
  * }
  */
@@ -18908,7 +18916,7 @@ interface PrimitiveProperties {
     since?: string;
 }
 /** An operating_lifecycle: a canonical, ordered (often cyclic) operating process
- * that many products' journey phases map onto — e.g. Sanity's content-operations
+ * that many products' journey phases map onto — e.g. Nimbus's content-operations
  * lifecycle. Registry-hostable like a `specification`; the cross-product join key
  * that turns per-surface journeys into one operation. Distinct from the per-entity
  * status `lifecycle` grammar concept (this is an entity, not a state machine).
@@ -18916,13 +18924,13 @@ interface PrimitiveProperties {
  * @example
  * const properties: OperatingLifecycleProperties = {
  *   cyclic: true,
- *   source: 'Sanity official 5-stage content-ops lifecycle',
+ *   source: 'a canonical 5-stage content-ops lifecycle',
  * }
  */
 interface OperatingLifecycleProperties {
     /** 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"). Optional provenance; promote to an edge if it names a real `specification`/`document`. */
+    /** Origin of the canonical model (e.g. "a published 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
@@ -22532,7 +22540,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.23.0";
+declare const UPG_VERSION: "0.23.1";
 /**
  * The `.upg` JSON document format version. Written to the `upg_version` field.
  * Evolves independently from `UPG_VERSION` (the catalogue version).

package/dist/index.js

@@ -495,7 +495,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.",
+    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 NQL or Structured 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", "operating_lifecycle", "operating_stage"]
   }
 ];
@@ -3216,6 +3216,15 @@ var UPG_EDGE_CATALOG = {
   // by another team's graph within the portfolio (0.17.3 locked predicate).
   objective_depends_on_dependency: { forward_verb: "depends_on", reverse_verb: "dependency_of", classification: "cross-domain", source_type: "objective", target_type: "dependency", cross_product_eligible: true },
   dependency_blocks_objective: { forward_verb: "blocks", reverse_verb: "blocked_by", classification: "cross-domain", source_type: "dependency", target_type: "objective", cross_product_eligible: true },
+  // The RESOLVING side, distinct from the two blocking edges above.
+  // `dependency_blocks_objective` names an objective the dependency holds up (the
+  // waiting side); this names the objective whose completion CLEARS the
+  // dependency (the providing side). In a portfolio, a dependency in one
+  // product's graph points at the objective in another product's graph that
+  // delivers the awaited work, instead of recording it only in the free-text
+  // `resolution` property. cross_product_eligible — the resolving objective
+  // lives in another product's graph.
+  dependency_resolved_by_objective: { forward_verb: "resolved_by", reverse_verb: "resolves", classification: "cross-domain", source_type: "dependency", target_type: "objective", cross_product_eligible: true },
   // objective / initiative → strategic_question. A planning doc's "Risks & Open
   // Questions" section names unresolved coordination questions the plan is
   // exposed to (who owns a capability across teams after a reorg). The
@@ -10476,9 +10485,9 @@ var UPG_PROPERTY_SCHEMA = {
   // ClassificationValueProperties: ClassificationValue: a value on a classification axis.
   classification_value: {
     rationale: { type: "string", description: "Short paragraph: why this value earns its own row/column. Longer narrative belongs in `summary_md` or attached `content_piece` nodes." },
-    exemplars: { type: "string[]", description: "Free-text examples of products occupying this value. For queryable occupancy, prefer `competitor` nodes with `classified_as` edges. @example ['Sanity', 'Contentful', 'Hygraph']" },
+    exemplars: { type: "string[]", description: "Free-text examples of products occupying this value. For queryable occupancy, prefer `competitor` nodes with `classified_as` edges. @example ['Nimbus', 'Larch', 'Prism']" },
     commitments: { type: "object[]", description: "The N (typically 2\u20134) load-bearing commitments that define this category. Each commitment is a structural axis; removing it changes the category. Pairs with `capabilities`: commitments are the *load-bearing definition*; capabilities are the *surface offering*. @example [ { name: 'Typed content graph', description: 'Schemas in code; references as edges; content is structured data.' }, { name: 'Real-time backend', description: 'Live queries, CRDT collaboration, sub-second propagation.' }, { name: 'Embeddable studio', description: 'Editor is a library hosted inside the team app, not an external portal.' }, ]" },
-    capabilities: { type: "object[]", description: "Structured capability bullets across the six canonical surfaces. Each surface appears at most once per `classification_value`. Pairs with `commitments`: capabilities describe what the category *offers*; commitments describe what *defines* it. @example [ { surface: 'delivery', bullets: ['GROQ', 'GraphQL', 'REST', 'Live Content API', 'Asset CDN'] }, { surface: 'extensibility', bullets: ['Custom input components', 'Studio plugins'] }, ]" }
+    capabilities: { type: "object[]", description: "Structured capability bullets across the six canonical surfaces. Each surface appears at most once per `classification_value`. Pairs with `commitments`: capabilities describe what the category *offers*; commitments describe what *defines* it. @example [ { surface: 'delivery', bullets: ['NQL', 'GraphQL', 'REST', 'Live Sync API', 'Asset CDN'] }, { surface: 'extensibility', bullets: ['Custom input components', 'editor plugins'] }, ]" }
   },
   // CodeRepositoryProperties: Code repository.
   code_repository: {
@@ -10513,9 +10522,9 @@ var UPG_PROPERTY_SCHEMA = {
     analysis_type: { type: "string", enum: ["feature_comparison", "positioning", "swot", "pricing"], description: "Type of analysis. `feature_comparison` = side-by-side matrix. `positioning` = competitor positioning relative to each other. `swot` = strengths, weaknesses, opportunities, threats. `pricing` = pricing structure comparison." },
     analysis_date: { type: "string", description: 'ISO date conducted. Competitive intelligence decays quickly; track snapshot age. @example "2026-03-15"' },
     framework_id: { type: "string", description: 'Framework ID (references `UPGFramework.id`). @example "porter-five-forces", "swot-analysis", "competitive-matrix"' },
-    empty_cells: { type: "object[]", description: "Empty cells in a 2-axis classification matrix that earn explicit commentary. Only the strategically interesting cells. Opportunity-kind cells are the most valuable; they identify unoccupied strategic space. Each entry references two `classification_value` nodes by id (one from each `classification_axis` child of this `competitive_analysis`). `validate_graph` enforces that the refs resolve to `classification_value` nodes whose parents are distinct `classification_axis` instances. See `ClassificationValueProperties.commitments` for the inverse \"occupied cell\" structural-definition shape. @example [ { axis_a_value_ref: 'val-git-based', axis_b_value_ref: 'val-portable-text', rationale_kind: 'opportunity', rationale_md: 'No technical reason; only adoption inertia. Watching brief.' }, { axis_a_value_ref: 'val-composable', axis_b_value_ref: 'val-wysiwyg', rationale_kind: 'structural', rationale_md: 'Composable rejects HTML blobs; WYSIWYG requires them.' }, ]" },
+    empty_cells: { type: "object[]", description: "Empty cells in a 2-axis classification matrix that earn explicit commentary. Only the strategically interesting cells. Opportunity-kind cells are the most valuable; they identify unoccupied strategic space. Each entry references two `classification_value` nodes by id (one from each `classification_axis` child of this `competitive_analysis`). `validate_graph` enforces that the refs resolve to `classification_value` nodes whose parents are distinct `classification_axis` instances. See `ClassificationValueProperties.commitments` for the inverse \"occupied cell\" structural-definition shape. @example [ { axis_a_value_ref: 'val-git-based', axis_b_value_ref: 'val-structured-text', rationale_kind: 'opportunity', rationale_md: 'No technical reason; only adoption inertia. Watching brief.' }, { axis_a_value_ref: 'val-composable', axis_b_value_ref: 'val-wysiwyg', rationale_kind: 'structural', rationale_md: 'Composable rejects HTML blobs; WYSIWYG requires them.' }, ]" },
     last_updated: { type: "string", description: 'Provenance: ISO date-time this record was last observed or refreshed. Distinct from `analysis_date` (when the analysis was conducted). @example "2026-06-13"' },
-    source: { type: "string", description: 'Provenance: where this was observed. A changelog, pricing, or docs URL, an analyst report, or a research note. @example "https://www.contentful.com/changelog/"' },
+    source: { type: "string", description: 'Provenance: where this was observed. A changelog, pricing, or docs URL, an analyst report, or a research note. @example "https://docs.larch.example/changelog/"' },
     confidence: {
       type: "assessment",
       scale_id: "confidence_5",
@@ -10543,7 +10552,7 @@ var UPG_PROPERTY_SCHEMA = {
     strengths: { type: "string[]", description: "Bulleted factual strengths. Each item is a short statement, not prose. @example ['Real-time multiplayer canvas', 'Generous free tier']" },
     weaknesses: { type: "string[]", description: "Bulleted factual weaknesses: gaps, friction, or capabilities materially below market. @example ['Weak API query capabilities', 'No mobile companion']" },
     last_updated: { type: "string", description: 'Provenance: ISO date-time this record was last observed or refreshed. Lets a stale record be told apart from a fresh one. @example "2026-06-13"' },
-    source: { type: "string", description: 'Provenance: where this was observed. A changelog, pricing, or docs URL, an analyst report, or a research note. @example "https://www.contentful.com/pricing/"' },
+    source: { type: "string", description: 'Provenance: where this was observed. A changelog, pricing, or docs URL, an analyst report, or a research note. @example "https://docs.larch.example/pricing/"' },
     confidence: {
       type: "assessment",
       scale_id: "confidence_5",
@@ -10565,7 +10574,7 @@ var UPG_PROPERTY_SCHEMA = {
     quality: { type: "string", enum: ["better", "same", "worse", "missing"], description: "Quality comparison. `better` = ours is meaningfully superior. `same` = roughly equivalent. `worse` = theirs is meaningfully superior. `missing` = we have no equivalent." },
     parity_status: { type: "string", enum: ["ahead", "behind", "parity", "unique_to_us", "unique_to_them"], description: "Parity. More granular than `quality`; captures whether the gap is offensive or defensive. `ahead` = we lead. `behind` = they lead. `parity` = equivalent. `unique_to_us` / `unique_to_them` = only one side offers it." },
     last_updated: { type: "string", description: 'ISO date this assessment was last updated. Competitor feature landscapes change quickly. @example "2026-02-15"' },
-    source: { type: "string", description: 'Provenance: where this was observed. A changelog, pricing, or docs URL, an analyst report, or a research note. @example "https://www.contentful.com/changelog/"' },
+    source: { type: "string", description: 'Provenance: where this was observed. A changelog, pricing, or docs URL, an analyst report, or a research note. @example "https://docs.larch.example/changelog/"' },
     confidence: {
       type: "assessment",
       scale_id: "confidence_5",
@@ -10591,7 +10600,7 @@ var UPG_PROPERTY_SCHEMA = {
     from_value: { type: "string", description: "Reclassification only. The prior `classification_value` id the competitor was classified as before this move (the superseded cell). Absent for a first-time classification (nothing was superseded)." },
     to_value: { type: "string", description: "Reclassification only. The new `classification_value` id the competitor is classified as after this move (the cell the new classify edge points at)." },
     last_updated: { type: "string", description: 'Provenance: ISO date-time this record was last observed or refreshed. @example "2026-06-13"' },
-    source: { type: "string", description: 'Provenance: where this was observed. A changelog, pricing, or docs URL, an analyst report, or a research note. @example "https://www.contentful.com/changelog/"' },
+    source: { type: "string", description: 'Provenance: where this was observed. A changelog, pricing, or docs URL, an analyst report, or a research note. @example "https://docs.larch.example/changelog/"' },
     confidence: {
       type: "assessment",
       scale_id: "confidence_5",
@@ -12022,7 +12031,7 @@ var UPG_PROPERTY_SCHEMA = {
   // OperatingLifecycleProperties: An operating_lifecycle: a canonical, ordered (often cyclic) operating process
   operating_lifecycle: {
     cyclic: { type: "boolean", description: "True if the process loops (e.g. Analyze \u2192 Extend \u2192 Plan). The sequence is fully expressed by the stages' `stage_order`; `cyclic` adds the wrap from the last stage back to the 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`.' }
+    source: { type: "string", description: 'Origin of the canonical model (e.g. "a published content-ops lifecycle"). Optional provenance; promote to an edge if it names a real `specification`/`document`.' }
   },
   // OperatingStageProperties: An operating_stage: one ordered stage of an `operating_lifecycle`. A product's
   operating_stage: {
@@ -29712,7 +29721,7 @@ function isCanonical(text) {
 }
 
 // src/index.ts
-var UPG_VERSION = "0.23.0";
+var UPG_VERSION = "0.23.1";
 var UPG_FORMAT_VERSION = "0.4.0";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();