@unified-product-graph/core 0.12.5 → 0.12.6

package/dist/index.d.cts

@@ -21834,7 +21834,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.5";
+declare const UPG_VERSION: "0.12.6";
 /**
  * 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

@@ -21834,7 +21834,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.5";
+declare const UPG_VERSION: "0.12.6";
 /**
  * The `.upg` JSON document format version. Written to the `upg_version` field.
  * Evolves independently from `UPG_VERSION` (the catalogue version).

package/dist/index.js

@@ -578,7 +578,7 @@ var UPG_ENTITY_META = [
   // (method / success_criteria / sample_size) when `test_plan` re-homed to the
   // QA/testing domain (UPG-678).
   { name: "experiment_plan", type_id: "ent_340", maturity: "stable", since: "0.2.6" },
-  { name: "experiment_run", type_id: "ent_341", maturity: "proposed", since: "0.2.6" },
+  { name: "experiment_run", type_id: "ent_341", maturity: "stable", since: "0.2.6" },
   { name: "learning", type_id: "ent_029", maturity: "stable", since: "0.1.0" },
   // test_plan re-homed validation → testing/QA (UPG-678). It is the QA
   // verification-procedure plan (test scope / environments / pass criteria);
@@ -666,7 +666,7 @@ var UPG_ENTITY_META = [
   // asserts `proposed` as the post-re-canon invariant. Graduating here would
   // break that contract; promotion is a separate, ticketed decision once the
   // story_statement → user_story migration has fully aged out.
-  { name: "user_story", type_id: "ent_073", maturity: "proposed", since: "0.1.0" },
+  { name: "user_story", type_id: "ent_073", maturity: "stable", since: "0.1.0" },
   { name: "story_statement", type_id: "ent_342", maturity: "deprecated", since: "0.2.7", deprecated_in: "0.7.0", replacement: "user_story" },
   { name: "story_task", type_id: "ent_343", maturity: "deprecated", since: "0.2.7", deprecated_in: "0.4.0", replacement: "task" },
   { name: "acceptance_criterion", type_id: "ent_074", maturity: "stable", since: "0.1.0" },
@@ -955,8 +955,9 @@ var UPG_ENTITY_META = [
   { name: "framework_exercise", type_id: "ent_350", maturity: "proposed", since: "0.8.4" }
 ];
 var DEFERRED_PROPOSED_BY_CONTRACT = {
-  user_story: "UPG-571: frozen proposed by the v0.7.0 re-canon contract (story_statement to user_story); user-story-split.test.ts asserts the invariant.",
-  experiment_run: "UPG-664: the optional multi-run / replication child; experiment_plan graduated to stable, the run stays proposed.",
+  // user_story (UPG-571) and experiment_run (UPG-664) graduated to stable in
+  // 0.12.6 — Captain lifted both freezes ("we are using them"). Their contracts
+  // are settled; they are now stable, not deferred.
   ai_experiment: "UPG-665: AI prompt/model restructure (open ADR).",
   ai_dataset: "UPG-665: AI prompt/model restructure (open ADR).",
   ai_trace: "UPG-665: AI prompt/model restructure (open ADR)."
@@ -3401,7 +3402,20 @@ var UPG_VALID_CHILDREN = {
   // ── OKR hierarchy ──────────────────────────────────────────────────────────
   objective: ["key_result", "metric"],
   key_result: ["metric"],
-  // ── Strategic cascade: vision → mission → strategic_pillar → … ─────────────
+  // ── Strategic cascade: vision → mission → strategic_pillar → strategic_theme →
+  //    { initiative, objective } ───────────────────────────────────────────────
+  //
+  // strategic_pillar vs strategic_theme (UPG-692 T3.3 — distinct cascade levels,
+  // NOT duplicates; sharpened rather than merged):
+  //   - strategic_pillar = a DURABLE structural division of the strategy. A
+  //     standing area the org organises around for years (e.g. "Structured
+  //     content", "Developer experience"). Few, long-lived; time_horizon is
+  //     multi-year / open-ended; carries its own `success_indicator`.
+  //   - strategic_theme = a TIME-BOUND thrust WITHIN a pillar. The current bet
+  //     for a period (e.g. "Go AI-native this year"). More numerous, rotates;
+  //     time_horizon is bounded (Q / FY); has NO `success_indicator` because it
+  //     is measured through its child objectives (strategic_theme_contains_objective).
+  //     That success-measurement asymmetry is the load-bearing distinction.
   vision: ["mission"],
   mission: ["strategic_pillar"],
   strategic_pillar: ["strategic_theme", "capability", "value_stream", "decision"],
@@ -12541,16 +12555,18 @@ var UPG_PROPERTY_SCHEMA = {
   // StrategicPillarProperties: StrategicPillar entity. Durable multi-year direction the product commits to.
   strategic_pillar: {
     owner: { type: "string", description: "Owning person or team. Promote to a `node_owned_by_person` edge if ownership must be queryable." },
-    description: { type: "string", description: "Narrative of the pillar's intent" },
-    scope: { type: "string", description: "What this pillar covers" },
-    time_horizon: { type: "string", description: 'Planning horizon. Typically multi-year. @example "3 years", "2026-2028"' },
-    success_indicator: { type: "string", description: "How the business knows the pillar is on track. Narrative, not a metric edge." }
-  },
-  // StrategicThemeProperties: StrategicTheme entity.
+    description: { type: "string", description: "Narrative of the pillar's intent as a durable strategic area" },
+    scope: { type: "string", description: "The standing organisational area this pillar owns" },
+    time_horizon: { type: "string", description: 'Standing / multi-year horizon, often open-ended (a pillar is durable). @example "3 years", "2026-2028", "ongoing"' },
+    success_indicator: { type: "string", description: "How the business knows this durable pillar is on track. Narrative, not a metric edge. A strategic_theme deliberately has no success_indicator: it is measured through its child objectives, not on its own." }
+  },
+  // StrategicThemeProperties: StrategicTheme entity. A time-bound thrust WITHIN a
+  // strategic_pillar (distinct cascade level, UPG-692 T3.3) — measured through its
+  // child objectives, so it carries no success_indicator of its own.
   strategic_theme: {
     owner: { type: "string", description: "Owning person or team. Promote to a `node_owned_by_person` edge if ownership must be queryable." },
-    time_horizon: { type: "string", description: 'Planning horizon. @example "Q1 2026", "FY26"' },
-    description: { type: "string", description: "Short narrative of what the theme is about" },
+    time_horizon: { type: "string", description: 'Bounded period this theme is active (a theme is time-bound, within a pillar). @example "Q1 2026", "FY26"' },
+    description: { type: "string", description: "Short narrative of this time-bound thrust within its pillar" },
     scope: { type: "string", description: "What the theme explicitly includes or excludes" }
   },
   // SubscriptionProperties: Subscription.
@@ -29222,7 +29238,7 @@ function isCanonical(text) {
 }
 
 // src/index.ts
-var UPG_VERSION = "0.12.5";
+var UPG_VERSION = "0.12.6";
 var UPG_FORMAT_VERSION = "0.4.0";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();