@unified-product-graph/core 0.9.15 → 0.9.16

package/CHANGELOG.md

@@ -7,6 +7,21 @@ This project uses [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
 ---
 
+## [0.9.16] - 2026-06-11
+
+**get_tree reaches the cloud, the show-tree skill calls it, and the three "area" taxonomies get a documented cross-walk.** 0.9.15 shipped `get_tree` local-only and left the show-tree skill on its interim hardcoded chains; this release finishes the loop and closes the deferred A4 introspection gap.
+
+### Added
+- **`get_tree` on the cloud server** (cloud tools 94 to 95; local unchanged at 121). The assembler (`assembleTree` + the `GraphReader` interface) moved to the shared `@unified-product-graph/mcp-tooling` package, so the local file-backed server and the cloud Postgres-backed server assemble byte-identical trees from one source. The cloud handler builds an in-memory `GraphReader` from a one-shot product node+edge load. `get_tree` leaves the CLOUD_NA parity list.
+- **`UPG_AREA_TAXONOMY`** (core): the documented cross-walk between the three overlapping "area" groupings that skills kept conflating into a stale coverage denominator: the 10 `get_graph_digest.coverage` keys, the 11 canonical regions, and the 8 "business areas". Keyed by coverage key; each row names the matching business area (null for `validation` and `operations`, which the 8-area grouping folds into discovery / omits) and the region ids its entities live in. Helpers `getCoverageKeysForRegion` / `getBusinessAreasForRegion`. Surfaced on `list_regions` (an `area_taxonomy` block plus per-region `coverage_keys` / `business_areas`) and `get_region` (per-region `coverage_keys` / `business_areas`), local and cloud. An SDK drift test pins the key sets against the runtime sources (`BUSINESS_AREAS`, `BUSINESS_AREA_META`).
+
+### Changed
+- **`/upg-show-tree` calls `get_tree`** instead of building traverse chains and resolving edge names. The skill now renders the returned roots / children, surfaces `gaps`, and notes anchor fallback; it no longer carries the edge-name chains that drifted (the exact failure `get_tree` exists to prevent). Adds the `feature_areas` pattern. Skills ship in the mcp-server package, so this reaches users with the release.
+
+No entity, domain, region, playbook, framework, or edge-count change, and no change to the local tool surface (entities 315, edges 980, local tools 121, regions 11).
+
+---
+
 ## [0.9.15] - 2026-06-11
 
 **get_tree: server-side tree assembly.** Tree views (OST, OKR, user, product, validation, strategy, feature areas) were assembled client-side by the show-tree skill out of multiple query calls and hardcoded edge chains that drifted with the spec. This release relocates assembly to the server, which owns the catalogue.

package/dist/index.cjs

@@ -44,6 +44,8 @@ __export(index_exports, {
   UPG_ANTI_PATTERNS: () => UPG_ANTI_PATTERNS,
   UPG_APPROACHES: () => UPG_APPROACHES,
   UPG_APPROACHES_BY_ID: () => UPG_APPROACHES_BY_ID,
+  UPG_AREA_TAXONOMY: () => UPG_AREA_TAXONOMY,
+  UPG_AREA_TAXONOMY_BY_COVERAGE_KEY: () => UPG_AREA_TAXONOMY_BY_COVERAGE_KEY,
   UPG_CANONICAL_FORMAT_VERSION: () => UPG_CANONICAL_FORMAT_VERSION,
   UPG_CONTAINMENT_FREE_TYPES: () => UPG_CONTAINMENT_FREE_TYPES,
   UPG_COUNT_BENCHMARKS: () => UPG_COUNT_BENCHMARKS,
@@ -121,9 +123,12 @@ __export(index_exports, {
   getAntiPatterns: () => getAntiPatterns,
   getAntiPatternsBySeverity: () => getAntiPatternsBySeverity,
   getAntiPatternsForStage: () => getAntiPatternsForStage,
+  getAreaTaxonomyEntry: () => getAreaTaxonomyEntry,
   getBenchmark: () => getBenchmark,
   getBenchmarksByDomain: () => getBenchmarksByDomain,
+  getBusinessAreasForRegion: () => getBusinessAreasForRegion,
   getCanonicalPlaybookForRegion: () => getCanonicalPlaybookForRegion,
+  getCoverageKeysForRegion: () => getCoverageKeysForRegion,
   getDefaultLens: () => getDefaultLens,
   getDeprecatedTypes: () => getDeprecatedTypes,
   getDomainForType: () => getDomainForType,
@@ -19969,6 +19974,36 @@ function getTreePattern(id) {
   return UPG_TREE_PATTERNS_BY_ID[id];
 }
 
+// src/presentation/area-taxonomy.ts
+var UPG_AREA_TAXONOMY = [
+  { coverage_key: "identity", label: "Identity", business_area: "identity", regions: ["strategy_outcomes"] },
+  { coverage_key: "understanding", label: "Understanding", business_area: "understanding", regions: ["users_needs", "discovery_research_validation"] },
+  { coverage_key: "discovery", label: "Discovery", business_area: "discovery", regions: ["discovery_research_validation", "market_competitive"] },
+  { coverage_key: "validation", label: "Validation", business_area: null, regions: ["discovery_research_validation"] },
+  { coverage_key: "reaching", label: "Reaching", business_area: "reaching", regions: ["business_gtm_growth"] },
+  { coverage_key: "converting", label: "Converting", business_area: "converting", regions: ["business_gtm_growth"] },
+  { coverage_key: "building", label: "Building", business_area: "building", regions: ["product_delivery", "experience_design_brand"] },
+  { coverage_key: "sustaining", label: "Sustaining", business_area: "sustaining", regions: ["business_gtm_growth"] },
+  { coverage_key: "learning", label: "Learning", business_area: "learning", regions: ["strategy_outcomes", "analytics_data", "operations_quality"] },
+  { coverage_key: "operations", label: "Operations", business_area: null, regions: ["operations_quality"] }
+];
+var UPG_AREA_TAXONOMY_BY_COVERAGE_KEY = Object.fromEntries(UPG_AREA_TAXONOMY.map((e) => [e.coverage_key, e]));
+function getAreaTaxonomyEntry(coverageKey) {
+  return UPG_AREA_TAXONOMY_BY_COVERAGE_KEY[coverageKey];
+}
+function getCoverageKeysForRegion(regionId) {
+  return UPG_AREA_TAXONOMY.filter((e) => e.regions.includes(regionId)).map((e) => e.coverage_key);
+}
+function getBusinessAreasForRegion(regionId) {
+  const out = [];
+  for (const e of UPG_AREA_TAXONOMY) {
+    if (e.regions.includes(regionId) && e.business_area && !out.includes(e.business_area)) {
+      out.push(e.business_area);
+    }
+  }
+  return out;
+}
+
 // src/playbooks/definitions/index.ts
 function seqStep(order, phase, entity_types, prompt_hint, options) {
   return {
@@ -28242,7 +28277,7 @@ function isCanonical(text) {
 }
 
 // src/index.ts
-var UPG_VERSION = "0.9.15";
+var UPG_VERSION = "0.9.16";
 var UPG_FORMAT_VERSION = "0.4.0";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();
@@ -28331,6 +28366,8 @@ var UPG_META_COUNT = UPG_ENTITY_META.length;
   UPG_ANTI_PATTERNS,
   UPG_APPROACHES,
   UPG_APPROACHES_BY_ID,
+  UPG_AREA_TAXONOMY,
+  UPG_AREA_TAXONOMY_BY_COVERAGE_KEY,
   UPG_CANONICAL_FORMAT_VERSION,
   UPG_CONTAINMENT_FREE_TYPES,
   UPG_COUNT_BENCHMARKS,
@@ -28408,9 +28445,12 @@ var UPG_META_COUNT = UPG_ENTITY_META.length;
   getAntiPatterns,
   getAntiPatternsBySeverity,
   getAntiPatternsForStage,
+  getAreaTaxonomyEntry,
   getBenchmark,
   getBenchmarksByDomain,
+  getBusinessAreasForRegion,
   getCanonicalPlaybookForRegion,
+  getCoverageKeysForRegion,
   getDefaultLens,
   getDeprecatedTypes,
   getDomainForType,