@unified-product-graph/core 0.10.8 → 0.11.0

package/dist/index.d.cts

@@ -129,7 +129,7 @@ interface UPGBaseNode {
  * AUTO-GENERATED by scripts/generate-property-registry.ts
  * Do not edit manually. Run: npx tsx scripts/generate-property-registry.ts
  *
- * Generated: 2026-06-13T10:55:29.604Z
+ * Generated: 2026-06-14T07:17:48.412Z
  * Entity types with properties: 319
  */
 interface PropertyDefinition {
@@ -7576,6 +7576,18 @@ interface UPGPortfolioDocument {
      * canonical nodes here via `instance_of` cross-edges (`registry/{node_id}`).
      */
     registry?: UPGRegistry;
+    /**
+     * Append-only classification-history stream (UPG 0.11.0). Each entry is a
+     * `competitor_signal` node with `signal_type: 'reclassification'`, auto-emitted
+     * at the classify-write chokepoint when a competitor moves between
+     * classification cells on an axis. Kept here (a portfolio-scoped collection)
+     * rather than in `registry.nodes` so it never pollutes the canonical-vocabulary
+     * tier or the landscape/tree reads, and rather than in a product graph so the
+     * emit stays atomic with the portfolio cross-edge write. Read by
+     * `diff_classification`. Optional and additive: omitted when empty; portfolio
+     * documents without it remain valid.
+     */
+    signals?: UPGBaseNode[];
 }
 
 /**
@@ -10861,12 +10873,39 @@ interface CompetitorSignalProperties {
     /**
      * Kind of move. `feature_launch` = shipped a feature. `pricing_change` = a plan
      * or tier change. `acquisition` / `partnership` / `market_entry` = strategic moves.
+     * `reclassification` = the competitor moved between classification cells on an
+     * axis (e.g. ai_integrated to ai_agentic); auto-emitted at the classify-write
+     * chokepoint and carries `axis` / `from_value` / `to_value` / `competitor`.
      */
-    signal_type?: 'feature_launch' | 'pricing_change' | 'acquisition' | 'partnership' | 'market_entry';
+    signal_type?: 'feature_launch' | 'pricing_change' | 'acquisition' | 'partnership' | 'market_entry' | 'reclassification';
     /** One-line factual summary of the move (what shipped, not marketing copy). */
     summary?: string;
     /** Expected impact on our position. */
     impact?: 'high' | 'medium' | 'low';
+    /**
+     * Reclassification only. The qualified id of the competitor that moved, as the
+     * classify cross-edge source (e.g. `p_rival/n_acme`). Identifies both the
+     * subject and its owning product, so `diff_classification({ product })` can
+     * filter the history stream.
+     */
+    competitor?: string;
+    /**
+     * Reclassification only. The `classification_axis` id the move is on (e.g.
+     * `ca_ai_maturity`). Mirrors the axis the superseded and new classify edges
+     * share.
+     */
+    axis?: string;
+    /**
+     * 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).
+     */
+    from_value?: string;
+    /**
+     * Reclassification only. The new `classification_value` id the competitor is
+     * classified as after this move (the cell the new classify edge points at).
+     */
+    to_value?: string;
     /**
      * Provenance: ISO date-time this record was last observed or refreshed.
      * @example "2026-06-13"
@@ -21485,7 +21524,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.10.8";
+declare const UPG_VERSION: "0.11.0";
 /**
  * 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

@@ -129,7 +129,7 @@ interface UPGBaseNode {
  * AUTO-GENERATED by scripts/generate-property-registry.ts
  * Do not edit manually. Run: npx tsx scripts/generate-property-registry.ts
  *
- * Generated: 2026-06-13T10:55:29.604Z
+ * Generated: 2026-06-14T07:17:48.412Z
  * Entity types with properties: 319
  */
 interface PropertyDefinition {
@@ -7576,6 +7576,18 @@ interface UPGPortfolioDocument {
      * canonical nodes here via `instance_of` cross-edges (`registry/{node_id}`).
      */
     registry?: UPGRegistry;
+    /**
+     * Append-only classification-history stream (UPG 0.11.0). Each entry is a
+     * `competitor_signal` node with `signal_type: 'reclassification'`, auto-emitted
+     * at the classify-write chokepoint when a competitor moves between
+     * classification cells on an axis. Kept here (a portfolio-scoped collection)
+     * rather than in `registry.nodes` so it never pollutes the canonical-vocabulary
+     * tier or the landscape/tree reads, and rather than in a product graph so the
+     * emit stays atomic with the portfolio cross-edge write. Read by
+     * `diff_classification`. Optional and additive: omitted when empty; portfolio
+     * documents without it remain valid.
+     */
+    signals?: UPGBaseNode[];
 }
 
 /**
@@ -10861,12 +10873,39 @@ interface CompetitorSignalProperties {
     /**
      * Kind of move. `feature_launch` = shipped a feature. `pricing_change` = a plan
      * or tier change. `acquisition` / `partnership` / `market_entry` = strategic moves.
+     * `reclassification` = the competitor moved between classification cells on an
+     * axis (e.g. ai_integrated to ai_agentic); auto-emitted at the classify-write
+     * chokepoint and carries `axis` / `from_value` / `to_value` / `competitor`.
      */
-    signal_type?: 'feature_launch' | 'pricing_change' | 'acquisition' | 'partnership' | 'market_entry';
+    signal_type?: 'feature_launch' | 'pricing_change' | 'acquisition' | 'partnership' | 'market_entry' | 'reclassification';
     /** One-line factual summary of the move (what shipped, not marketing copy). */
     summary?: string;
     /** Expected impact on our position. */
     impact?: 'high' | 'medium' | 'low';
+    /**
+     * Reclassification only. The qualified id of the competitor that moved, as the
+     * classify cross-edge source (e.g. `p_rival/n_acme`). Identifies both the
+     * subject and its owning product, so `diff_classification({ product })` can
+     * filter the history stream.
+     */
+    competitor?: string;
+    /**
+     * Reclassification only. The `classification_axis` id the move is on (e.g.
+     * `ca_ai_maturity`). Mirrors the axis the superseded and new classify edges
+     * share.
+     */
+    axis?: string;
+    /**
+     * 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).
+     */
+    from_value?: string;
+    /**
+     * Reclassification only. The new `classification_value` id the competitor is
+     * classified as after this move (the cell the new classify edge points at).
+     */
+    to_value?: string;
     /**
      * Provenance: ISO date-time this record was last observed or refreshed.
      * @example "2026-06-13"
@@ -21485,7 +21524,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.10.8";
+declare const UPG_VERSION: "0.11.0";
 /**
  * The `.upg` JSON document format version. Written to the `upg_version` field.
  * Evolves independently from `UPG_VERSION` (the catalogue version).

package/dist/index.js

@@ -9738,9 +9738,13 @@ var UPG_PROPERTY_SCHEMA = {
   // CompetitorSignalProperties: Competitor signal: a dated competitor move mapped onto our portfolio.
   competitor_signal: {
     observed_at: { type: "string", description: 'ISO date-time the move was observed. @example "2026-06-10"' },
-    signal_type: { type: "string", enum: ["feature_launch", "pricing_change", "acquisition", "partnership", "market_entry"], description: "Kind of move. `feature_launch` = shipped a feature. `pricing_change` = a plan or tier change. `acquisition` / `partnership` / `market_entry` = strategic moves." },
+    signal_type: { type: "string", enum: ["feature_launch", "pricing_change", "acquisition", "partnership", "market_entry", "reclassification"], description: "Kind of move. `feature_launch` = shipped a feature. `pricing_change` = a plan or tier change. `acquisition` / `partnership` / `market_entry` = strategic moves. `reclassification` = the competitor moved between classification cells on an axis (e.g. ai_integrated to ai_agentic); auto-emitted at the classify-write chokepoint and carries `axis` / `from_value` / `to_value` / `competitor`." },
     summary: { type: "string", description: "One-line factual summary of the move (what shipped, not marketing copy)." },
     impact: { type: "string", enum: ["high", "medium", "low"], description: "Expected impact on our position." },
+    competitor: { type: "string", description: "Reclassification only. The qualified id of the competitor that moved, as the classify cross-edge source (e.g. `p_rival/n_acme`). Identifies both the subject and its owning product, so `diff_classification({ product })` can filter the history stream." },
+    axis: { type: "string", description: "Reclassification only. The `classification_axis` id the move is on (e.g. `ca_ai_maturity`). Mirrors the axis the superseded and new classify edges share." },
+    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/"' },
     confidence: {
@@ -28392,7 +28396,11 @@ function portfolioBody(doc) {
         nodes: sortNodes(doc.registry.nodes).map(canonicalNode),
         ...doc.registry.edges && doc.registry.edges.length > 0 ? { edges: sortEdges(doc.registry.edges).map(canonicalEdge) } : {}
       }
-    } : {}
+    } : {},
+    // Append-only classification-history stream (0.11.0). Emitted only when
+    // non-empty so existing portfolio files without it stay byte-identical.
+    // Each entry is a competitor_signal node (serialised with the node rules).
+    ...doc.signals && doc.signals.length > 0 ? { signals: sortNodes(doc.signals).map(canonicalNode) } : {}
   };
 }
 function computeBodyChecksum(doc) {
@@ -28508,6 +28516,10 @@ function normalizeDocument(obj) {
         ...Array.isArray(rawRegistry.edges) ? { edges: rawRegistry.edges } : {}
       };
     }
+    const rawSignals = raw.signals;
+    if (Array.isArray(rawSignals) && rawSignals.length > 0) {
+      out2.signals = rawSignals.map((n) => repairNodeDrift(n));
+    }
     return out2;
   }
   const out = {
@@ -28532,7 +28544,7 @@ function isCanonical(text) {
 }
 
 // src/index.ts
-var UPG_VERSION = "0.10.8";
+var UPG_VERSION = "0.11.0";
 var UPG_FORMAT_VERSION = "0.4.0";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();