@unified-product-graph/core 0.9.25 → 0.10.1

package/dist/index.cjs

@@ -260,7 +260,7 @@ var UPG_DOMAINS = [
     id: "market_intelligence",
     label: "Market Intelligence",
     description: "The competitive landscape your product operates in. Competitors and their competitor features map the field. Market trends track industry shifts. Market segments define addressable audiences. Competitive analyses synthesize the full picture. Classification axes and values express the dimensional structure of the landscape (e.g. CMS Architecture \xD7 Editing Paradigm). Informs Strategy (positioning), Go-To-Market (battle cards), and Business Model (differentiation).",
-    types: ["competitor", "competitor_feature", "market_trend", "market_segment", "competitive_analysis", "classification_axis", "classification_value"]
+    types: ["competitor", "competitor_feature", "competitor_signal", "market_trend", "market_segment", "competitive_analysis", "classification_axis", "classification_value"]
   },
   {
     id: "user_research",
@@ -795,6 +795,7 @@ var UPG_ENTITY_META = [
   // ── Market Intelligence ──
   { name: "competitor", type_id: "ent_033", maturity: "stable", since: "0.1.0" },
   { name: "competitor_feature", type_id: "ent_034", maturity: "stable", since: "0.1.0" },
+  { name: "competitor_signal", type_id: "ent_354", maturity: "proposed", since: "0.10.0" },
   { name: "market_trend", type_id: "ent_035", maturity: "stable", since: "0.1.0" },
   { name: "market_segment", type_id: "ent_036", maturity: "stable", since: "0.1.0" },
   { name: "competitive_analysis", type_id: "ent_037", maturity: "stable", since: "0.1.0" },
@@ -1306,6 +1307,24 @@ var UPG_EDGE_CATALOG = {
   // programming concern.
   product_contains_competitive_analysis: { forward_verb: "contains", reverse_verb: "contained_by", classification: "hierarchy", source_type: "product", target_type: "competitive_analysis" },
   competitor_offers_competitor_feature: { forward_verb: "offers", reverse_verb: "offered_by", classification: "hierarchy", source_type: "competitor", target_type: "competitor_feature" },
+  // 0.10.0 (spec issue #38): parity / rivalry edge. Our `feature` rivals a
+  // `competitor_feature`, carrying the parity assessment as EDGE metadata
+  // (parity_status / quality / is_gap / assessed_on / evidence / confidence) so
+  // "where are we behind, by area?" is one traversal, not a scan over the
+  // free-text `our_equivalent`. `carries_properties` puts the assessment on the
+  // edge; the node `parity_status` stays as a denormalised single-rival cache.
+  // Dual-registered as a cross-edge (UPG_CROSS_EDGE_TYPES) so it also spans our
+  // product graph and a watched competitor-intelligence graph. Distinct from
+  // `competitor_feature_inspires_feature` (ideation lineage, not parity).
+  feature_rivals_competitor_feature: { forward_verb: "rivals", reverse_verb: "is_rivalled_by", classification: "cross-domain", source_type: "feature", target_type: "competitor_feature", carries_properties: true },
+  // 0.10.0 (spec issue #41): competitor_signal is a dated competitor move (feature
+  // launch / pricing change / acquisition / partnership / market entry) emitted by a
+  // competitor and mapped onto our portfolio. `emits` is within the watched graph;
+  // `maps_to_feature` / `surfaces_opportunity` cross from the watched signal into our
+  // product graph (dual-registered as cross-edges in UPG_CROSS_EDGE_TYPES).
+  competitor_emits_competitor_signal: { forward_verb: "emits", reverse_verb: "emitted_by", classification: "hierarchy", source_type: "competitor", target_type: "competitor_signal" },
+  competitor_signal_maps_to_feature: { forward_verb: "maps_to", reverse_verb: "targeted_by_signal", classification: "cross-domain", source_type: "competitor_signal", target_type: "feature" },
+  competitor_signal_surfaces_opportunity: { forward_verb: "surfaces", reverse_verb: "prompted_by_signal", classification: "cross-domain", source_type: "competitor_signal", target_type: "opportunity" },
   competitive_analysis_analyses_competitor: { forward_verb: "analyses", reverse_verb: "analysed_in", classification: "hierarchy", source_type: "competitive_analysis", target_type: "competitor" },
   competitive_analysis_identifies_market_trend: { forward_verb: "identifies", reverse_verb: "identified_in", classification: "hierarchy", source_type: "competitive_analysis", target_type: "market_trend" },
   competitive_analysis_scopes_market_segment: { forward_verb: "scopes", reverse_verb: "scoped_in", classification: "hierarchy", source_type: "competitive_analysis", target_type: "market_segment" },
@@ -3226,7 +3245,10 @@ var UPG_CROSS_EDGE_TYPES = [
   "api_contract_speaks_specification",
   "product_exposes_primitive",
   "feature_manipulates_primitive",
-  "primitive_stored_as_data_type"
+  "primitive_stored_as_data_type",
+  "feature_rivals_competitor_feature",
+  "competitor_signal_maps_to_feature",
+  "competitor_signal_surfaces_opportunity"
 ];
 var REGISTRY_PRODUCT_ID = "registry";
 
@@ -3514,7 +3536,7 @@ var UPG_VALID_CHILDREN = {
   // each axis hosts its values; values are reusable across the row and column
   // dossiers of a 2-axis matrix.
   competitive_analysis: ["competitor", "market_trend", "market_segment", "classification_axis"],
-  competitor: ["competitor_feature"],
+  competitor: ["competitor_feature", "competitor_signal"],
   classification_axis: ["classification_value"],
   // ── UX Research hierarchy ───────────────────────────────────────────────────
   research_study: [
@@ -6369,12 +6391,14 @@ var UPG_LIFECYCLE_FREE_TYPES = /* @__PURE__ */ new Set([
   "job_step",
   "desired_outcome",
   "switching_cost",
-  // ── Market Intelligence (6 of 7): competitor landscape is reference data;
+  // ── Market Intelligence (7 of 8): competitor landscape is reference data;
+  //    competitor_signal is an append-only dated event (no phase ladder);
   //    competitive_analysis shipped PUBLISHING lifecycle in Phase C;
   //    classification_axis and classification_value are reference taxonomy
   //    atoms with no state machine. ─
   "competitor",
   "competitor_feature",
+  "competitor_signal",
   "market_trend",
   "market_segment",
   "classification_axis",
@@ -9724,8 +9748,8 @@ var UPG_PROPERTY_SCHEMA = {
   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']" },
-    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'] }, ]" }
+    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'] }, ]" }
   },
   // CodeRepositoryProperties: Code repository.
   code_repository: {
@@ -9760,7 +9784,22 @@ 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-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.' }, ]" },
+    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/"' },
+    confidence: {
+      type: "assessment",
+      scale_id: "confidence_5",
+      description: "Provenance: how sure we are, on the canonical confidence_5 scale. Carries both a numeric value and a high / medium / low label.",
+      properties: {
+        value: { type: "number", description: "The numeric value, used for computation." },
+        label: { type: "string", description: "The qualitative label (what the assessor meant)." },
+        scale_id: { type: "string", description: "Which assessment scale this was rated on (optional)." },
+        normalized: { type: "number", description: "Normalized 0-1 value for cross-tool comparison (optional)." }
+      },
+      required: ["value", "label"]
+    },
+    observed_by: { type: "string", description: 'Provenance: agent or routine id that last wrote this. Absent when hand-authored, the signal that a human (not a poller) is the last writer. @example "competitor-watch-agent"' }
   },
   // CompetitiveBattleCardProperties: CompetitiveBattleCard entity.
   competitive_battle_card: {
@@ -9773,7 +9812,22 @@ var UPG_PROPERTY_SCHEMA = {
     pricing_model: { type: "string", description: 'Pricing model (e.g. "freemium", "per-seat SaaS", "usage-based")' },
     website: { type: "string", description: "Public website URL" },
     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']" }
+    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/"' },
+    confidence: {
+      type: "assessment",
+      scale_id: "confidence_5",
+      description: "Provenance: how sure we are, on the canonical confidence_5 scale. Carries both a numeric value and a high / medium / low label.",
+      properties: {
+        value: { type: "number", description: "The numeric value, used for computation." },
+        label: { type: "string", description: "The qualitative label (what the assessor meant)." },
+        scale_id: { type: "string", description: "Which assessment scale this was rated on (optional)." },
+        normalized: { type: "number", description: "Normalized 0-1 value for cross-tool comparison (optional)." }
+      },
+      required: ["value", "label"]
+    },
+    observed_by: { type: "string", description: 'Provenance: agent or routine id that last wrote this. Absent when hand-authored, the signal that a human (not a poller) is the last writer. @example "competitor-watch-agent"' }
   },
   // CompetitorFeatureProperties: Competitor feature or capability.
   competitor_feature: {
@@ -9781,7 +9835,43 @@ var UPG_PROPERTY_SCHEMA = {
     is_gap: { type: "boolean", description: "Gap in our offering. True when `our_equivalent` is absent or materially inferior." },
     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"' }
+    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/"' },
+    confidence: {
+      type: "assessment",
+      scale_id: "confidence_5",
+      description: "Provenance: how sure we are, on the canonical confidence_5 scale. Carries both a numeric value and a high / medium / low label.",
+      properties: {
+        value: { type: "number", description: "The numeric value, used for computation." },
+        label: { type: "string", description: "The qualitative label (what the assessor meant)." },
+        scale_id: { type: "string", description: "Which assessment scale this was rated on (optional)." },
+        normalized: { type: "number", description: "Normalized 0-1 value for cross-tool comparison (optional)." }
+      },
+      required: ["value", "label"]
+    },
+    observed_by: { type: "string", description: 'Provenance: agent or routine id that last wrote this. Absent when hand-authored, the signal that a human (not a poller) is the last writer. @example "competitor-watch-agent"' }
+  },
+  // 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." },
+    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." },
+    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: {
+      type: "assessment",
+      scale_id: "confidence_5",
+      description: "Provenance: how sure we are, on the canonical confidence_5 scale. Carries both a numeric value and a high / medium / low label.",
+      properties: {
+        value: { type: "number", description: "The numeric value, used for computation." },
+        label: { type: "string", description: "The qualitative label (what the assessor meant)." },
+        scale_id: { type: "string", description: "Which assessment scale this was rated on (optional)." },
+        normalized: { type: "number", description: "Normalized 0-1 value for cross-tool comparison (optional)." }
+      },
+      required: ["value", "label"]
+    },
+    observed_by: { type: "string", description: 'Provenance: agent or routine id that last wrote this. Absent when hand-authored, the signal that a human (not a poller) is the last writer. @example "competitor-watch-agent"' }
   },
   // ComplianceFrameworkProperties: Compliance framework.
   compliance_framework: {
@@ -11006,7 +11096,21 @@ var UPG_PROPERTY_SCHEMA = {
       },
       required: ["value", "label"]
     },
-    source: { type: "string", description: 'Source of the trend data: analyst report, research firm, observed behaviour. @example "Gartner Hype Cycle 2025", "Observed in user interviews Q1 2026"' }
+    source: { type: "string", description: 'Source of the trend data: analyst report, research firm, observed behaviour. @example "Gartner Hype Cycle 2025", "Observed in user interviews Q1 2026"' },
+    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"' },
+    confidence: {
+      type: "assessment",
+      scale_id: "confidence_5",
+      description: "Provenance: how sure we are, on the canonical confidence_5 scale. Carries both a numeric value and a high / medium / low label.",
+      properties: {
+        value: { type: "number", description: "The numeric value, used for computation." },
+        label: { type: "string", description: "The qualitative label (what the assessor meant)." },
+        scale_id: { type: "string", description: "Which assessment scale this was rated on (optional)." },
+        normalized: { type: "number", description: "Normalized 0-1 value for cross-tool comparison (optional)." }
+      },
+      required: ["value", "label"]
+    },
+    observed_by: { type: "string", description: 'Provenance: agent or routine id that last wrote this. Absent when hand-authored, the signal that a human (not a poller) is the last writer. @example "competitor-watch-agent"' }
   },
   // MarketingCampaignPlanProperties: Marketing campaign plan.
   marketing_campaign_plan: {
@@ -11782,7 +11886,7 @@ var UPG_PROPERTY_SCHEMA = {
     owner: { type: "string", description: "Owning person or team. Backstage marks this required; strongly recommended." },
     lifecycle: { type: "string", enum: ["experimental", "production", "deprecated"], description: 'Service maturity. Answers "how mature is it?". `experimental` = early-stage. `production` = battle-tested. `deprecated` = being phased out.' },
     tags: { type: "string[]", description: 'Free-form filter tags (e.g. ["payments", "critical-path", "team-alpha"]).' },
-    links: { type: "object", description: "Named URLs for documentation, dashboards, runbooks." }
+    links: { type: "object[]", description: "Named URLs for documentation, dashboards, runbooks." }
   },
   // ServiceBlueprintProperties: Service blueprint.
   service_blueprint: {
@@ -12131,7 +12235,7 @@ var UPG_PROPERTY_SCHEMA = {
   test_plan: {
     test_scope: { type: "string", description: 'What the plan covers (e.g. "checkout flow", "auth module", "release 2.4").' },
     plan_type: { type: "string", enum: ["release", "regression", "integration", "acceptance", "smoke", "exploratory"], description: "Kind of verification effort this plan governs." },
-    environments: { type: "object", description: "Environments the plan exercises (mirrors `TestEnvironmentProperties.env_type`)." },
+    environments: { type: "string[]", enum: ["local", "ci", "staging", "sandbox", "production_mirror"], description: "Environments the plan exercises (mirrors `TestEnvironmentProperties.env_type`)." },
     entry_criteria: { type: "string", description: "Conditions that must hold before execution may begin." },
     pass_criteria: { type: "string", description: "Exit / pass criteria determining whether the plan succeeds." }
   },
@@ -18146,6 +18250,7 @@ for (const fw of UPG_FRAMEWORKS) {
 
 // src/grammar/validate.ts
 var crossProductEdgeTypeSet = new Set(UPG_CROSS_EDGE_TYPES);
+var withinProductEdgeTypeSet = new Set(Object.keys(UPG_EDGE_CATALOG));
 var CONTENT_DEPTH_WARNING_RULES = /* @__PURE__ */ new Set([
   "property-type",
   "property-enum",
@@ -18248,7 +18353,7 @@ function validateUPGDocument(doc) {
         if (!e.id || typeof e.id !== "string") {
           errors.push({ path: `${path}.id`, message: "Edge id is required and must be a string" });
         }
-        if (typeof e.type === "string" && crossProductEdgeTypeSet.has(e.type)) {
+        if (typeof e.type === "string" && crossProductEdgeTypeSet.has(e.type) && !withinProductEdgeTypeSet.has(e.type)) {
           errors.push({
             path: `${path}.type`,
             message: `Cross-product edge type "${e.type}" must live in portfolio.cross_edges[], not product edges[].`
@@ -18535,6 +18640,7 @@ function valueMatchesType(defType, val) {
     case "boolean":
       return kind === "boolean";
     case "string[]":
+    case "object[]":
       return kind === "string[]";
     case "object":
     case "assessment":
@@ -18645,6 +18751,7 @@ var ENTITY_EMOJI = {
   competitive_battle_card: "\u2694\uFE0F",
   competitor: "\u{1F94A}",
   competitor_feature: "\u{1F52C}",
+  competitor_signal: "\u{1F4E1}",
   compliance_framework: "\u{1F3DF}\uFE0F",
   compliance_requirement: "\u26F2",
   constraint: "\u{1F512}",
@@ -20391,8 +20498,8 @@ var MARKET_COMPETITIVE_PLAYBOOK = {
     seqStep(
       6,
       "Moves",
-      ["competitive_battle_card"],
-      "Look where competitors are weak and trends are strong. That intersection is where your moves live: arm the team with battle cards that turn each competitor weakness into a position you can win. (Partnership moves belong in the business & GTM playbook, where `partnership` connects.)"
+      ["competitor_signal", "competitive_battle_card"],
+      "Capture rivals' dated moves as competitor_signals (launches, pricing changes, acquisitions) and map each onto the feature it threatens. Then look where competitors are weak and trends are strong: that intersection is where your moves live. Arm the team with battle cards that turn each competitor weakness into a position you can win. (Partnership moves belong in the business & GTM playbook, where `partnership` connects.)"
     )
   ]
 };
@@ -21498,7 +21605,36 @@ var UPG_LENSES = [
     perspective: "Sees the product as something that needs to reach and resonate with people. Audience-aware, message-focused, always asking what makes someone care."
   },
   // ═══════════════════════════════════════════════════════════════════════════════
-  // 8. FULL LENS - everything, canonical vocabulary (default)
+  // 8. COMPETITIVE LENS - rivals, their dated moves, and where we stand
+  // ═══════════════════════════════════════════════════════════════════════════════
+  {
+    id: "competitive",
+    name: "Competitive",
+    description: "The competitive landscape: rivals, their offerings, dated moves, and where we stand",
+    icon: "swords",
+    visible_domains: ["market_intelligence"],
+    // Parity (#38) and signal (#41) edges reach onto our side of the graph;
+    // surface those endpoints so a parity row or a mapped signal shows both ends.
+    always_show_types: ["feature", "capability", "opportunity"],
+    playbook_id: "playbook:market-competitive",
+    benchmark_domains: ["market_intelligence"],
+    intelligence_prompts: [
+      {
+        condition: "competitors.length === 0",
+        structured_condition: { check: { type: "entity_count", entity_type: "competitor", comparison: "zero" } },
+        message: "No competitors mapped yet. Name the 3 to 7 closest alternatives, including the status quo and DIY."
+      },
+      {
+        condition: "competitor_signals.length === 0",
+        structured_condition: { check: { type: "entity_count", entity_type: "competitor_signal", comparison: "zero" } },
+        message: "No competitor signals captured. Log rivals' dated moves (launches, pricing changes) and map each onto the feature it threatens."
+      }
+    ],
+    audience: "Product marketers, strategists, and founders sizing up the field",
+    perspective: "Sees the product through its rivals: who competes, what they ship, the dated moves they make, and where we lead or trail."
+  },
+  // ═══════════════════════════════════════════════════════════════════════════════
+  // 9. FULL LENS - everything, canonical vocabulary (default)
   // ═══════════════════════════════════════════════════════════════════════════════
   {
     id: "full",
@@ -21718,7 +21854,7 @@ var USER_RESEARCH_GUIDE = {
 var MARKET_INTELLIGENCE_GUIDE = {
   domain_id: "market_intelligence",
   anchor_entity: "competitive_analysis",
-  creation_sequence: ["competitive_analysis", "competitor", "competitor_feature", "market_trend", "market_segment", "classification_axis", "classification_value"],
+  creation_sequence: ["competitive_analysis", "competitor", "competitor_feature", "competitor_signal", "market_trend", "market_segment", "classification_axis", "classification_value"],
   patterns: [
     {
       name: "Competitive Landscape Map",
@@ -26215,6 +26351,11 @@ var UPG_REGIONS = [
         type: "competitor_feature",
         role: "leaf"
       },
+      {
+        type: "competitor_signal",
+        role: "leaf",
+        notes: "a dated competitor move (feature launch, pricing change, ...) emitted by a competitor"
+      },
       {
         type: "market_trend",
         role: "leaf"
@@ -26246,6 +26387,7 @@ var UPG_REGIONS = [
     },
     intra_edges: [
       "competitor_offers_competitor_feature",
+      "competitor_emits_competitor_signal",
       "competitive_analysis_analyses_competitor",
       "competitive_analysis_dimensioned_by_classification_axis",
       "classification_axis_includes_classification_value",
@@ -28345,6 +28487,9 @@ function serializeSingleWithHeader(doc, opts) {
   const summary = deriveSummary(product.description);
   if (summary) header.summary = summary;
   header.counts = { nodes: doc.nodes?.length ?? 0, edges: doc.edges?.length ?? 0 };
+  if (doc.member_kind === "org_rollup" || doc.member_kind === "watched") {
+    header.member_kind = doc.member_kind;
+  }
   header.provenance = buildProvenance(doc, opts);
   header.integrity = { algorithm: INTEGRITY_ALGORITHM, body: computeBodyChecksum(doc) };
   return JSON.stringify({ $upg: header, ...body }, null, 2) + "\n";
@@ -28364,8 +28509,14 @@ function serializePortfolioWithHeader(doc, opts) {
   };
   const summary = deriveSummary(org.description);
   if (summary) header.summary = summary;
+  const members = doc.products ?? [];
+  const memberKindOf = (p) => p.member_kind ?? "product";
+  const watchedCount = members.filter((p) => memberKindOf(p) === "watched").length;
+  const rollupCount = members.filter((p) => memberKindOf(p) === "org_rollup").length;
   header.counts = {
-    products: doc.products?.length ?? 0,
+    products: members.filter((p) => memberKindOf(p) === "product").length,
+    ...watchedCount > 0 ? { watched_products: watchedCount } : {},
+    ...rollupCount > 0 ? { org_rollups: rollupCount } : {},
     product_areas: doc.product_areas?.length ?? 0,
     portfolios: doc.portfolios?.length ?? 0,
     cross_edges: doc.cross_edges?.length ?? 0
@@ -28419,6 +28570,8 @@ function normalizeDocument(obj) {
     nodes: (raw.nodes ?? []).map((n) => repairNodeDrift(n)),
     edges: raw.edges ?? []
   };
+  const memberKind = header?.member_kind ?? raw.member_kind;
+  if (memberKind === "org_rollup" || memberKind === "watched") out.member_kind = memberKind;
   if (_integrity) out._integrity = _integrity;
   return out;
 }
@@ -28431,7 +28584,7 @@ function isCanonical(text) {
 }
 
 // src/index.ts
-var UPG_VERSION = "0.9.25";
+var UPG_VERSION = "0.10.1";
 var UPG_FORMAT_VERSION = "0.4.0";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();