@unified-product-graph/cloud-server 0.9.14 → 0.9.16

package/dist/tools-manifest.json

@@ -1,8 +1,8 @@
 {
   "schema_version": "2",
   "package": "@unified-product-graph/cloud-server",
-  "package_version": "0.9.14",
-  "tool_count": 94,
+  "package_version": "0.9.16",
+  "tool_count": 95,
   "domains": [
     "products",
     "context",
@@ -242,6 +242,64 @@
       ],
       "atomicity": "atomic (read-only)"
     },
+    {
+      "name": "get_tree",
+      "description": "Assemble a canonical tree pattern (ost, okr, user, product, validation, strategy, feature_areas) from the product graph. Walks the pattern's type-driven child map over the live graph (drift-proof, follows whatever edge wired each parent to a child of the expected type), roots at the pattern anchor with fallback, and reports structural gaps. Returns nested data, not rendered text.",
+      "domain": "context",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "product_id": {
+            "type": "string",
+            "description": "The product ID"
+          },
+          "pattern": {
+            "type": "string",
+            "description": "Tree pattern id: ost, okr, user, product, validation, strategy, feature_areas"
+          },
+          "from_id": {
+            "type": "string",
+            "description": "Explicit root node id. Defaults to the pattern's canonical anchor type."
+          },
+          "depth": {
+            "type": "number",
+            "description": "Max levels. Defaults to the pattern's natural depth."
+          },
+          "include_properties": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Node property keys to inline on each tree node."
+          },
+          "max_nodes": {
+            "type": "number",
+            "description": "Cap on assembled nodes. The tree is summarised (stats.truncated) rather than silently cut."
+          }
+        },
+        "required": [
+          "product_id",
+          "pattern"
+        ]
+      },
+      "throws": [
+        "textError when `product_id` or `pattern` is missing or `pattern` is unknown."
+      ],
+      "examples": [],
+      "warnings": [],
+      "see": [
+        "query",
+        "list_playbooks"
+      ],
+      "source": "src/tools/tree.ts:47",
+      "symbol": "getTree",
+      "returns": "JSON: `{ pattern, framework_id?, anchor_type, anchor_used,\nanchor_resolved_from?, roots: TreeNode[], stats: { nodes, levels, truncated },\ngaps: [{ node_id, type, title, missing }] }`. Structured data, never rendered text.",
+      "return_shape": "{ pattern, framework_id?, anchor_type, anchor_used, anchor_resolved_from?, roots: TreeNode[], stats: { nodes, levels, truncated }, gaps: [{ node_id, type, title, missing }] }",
+      "return_notes": [
+        "Structured data, never rendered text."
+      ],
+      "atomicity": "atomic (read-only). Reads the named product only."
+    },
     {
       "name": "query",
       "description": "Traverse the graph following typed edges. Returns a subgraph in a single call. Replaces multi-step fetch patterns. Supports edge type filtering (including !negation), field projection, and truncation metadata.",
@@ -1615,7 +1673,7 @@
         "inspect",
         "validate_graph"
       ],
-      "source": "src/tools/spec.ts:1165",
+      "source": "src/tools/spec.ts:1183",
       "symbol": "getAntiPattern",
       "returns": "JSON: `UPGCuratedAntiPattern`",
       "return_notes": [
@@ -1659,7 +1717,7 @@
         "trace",
         "reflect"
       ],
-      "source": "src/tools/spec.ts:234",
+      "source": "src/tools/spec.ts:237",
       "symbol": "getApproach",
       "returns": "JSON: the full `UPGApproach` record.",
       "return_notes": [
@@ -1693,7 +1751,7 @@
         "list_anti_patterns",
         "get_playbook"
       ],
-      "source": "src/tools/spec.ts:525",
+      "source": "src/tools/spec.ts:528",
       "symbol": "getDomainGuide",
       "returns": "JSON: the full `UPGDomainUsageGuide` record.",
       "return_notes": [
@@ -1727,7 +1785,7 @@
         "list_domains",
         "get_domain_guide"
       ],
-      "source": "src/tools/spec.ts:1664",
+      "source": "src/tools/spec.ts:1682",
       "symbol": "getDomainRing",
       "returns": "JSON: the full `UPGDomainRing` record.",
       "return_notes": [
@@ -1761,7 +1819,7 @@
         "resolve_edge_for_pair",
         "rename_edge_type"
       ],
-      "source": "src/tools/spec.ts:652",
+      "source": "src/tools/spec.ts:655",
       "symbol": "getEdgeType",
       "returns": "JSON: `{ type, forward_verb, reverse_verb, classification, source_type, target_type }`",
       "return_shape": "{ type, forward_verb, reverse_verb, classification, source_type, target_type }",
@@ -1793,7 +1851,7 @@
         "get_type_label",
         "get_entity_schema"
       ],
-      "source": "src/tools/spec.ts:1084",
+      "source": "src/tools/spec.ts:1102",
       "symbol": "getEntityMeta",
       "returns": "JSON: `EntityTypeMeta & { domain_id: string | null }`",
       "return_notes": [
@@ -1828,7 +1886,7 @@
         "get_playbook",
         "get_approach"
       ],
-      "source": "src/tools/spec.ts:591",
+      "source": "src/tools/spec.ts:594",
       "symbol": "getFramework",
       "returns": "JSON: the full `UPGFramework` record.",
       "return_notes": [
@@ -1863,7 +1921,7 @@
         "get_framework",
         "list_entity_types"
       ],
-      "source": "src/tools/spec.ts:904",
+      "source": "src/tools/spec.ts:922",
       "symbol": "getLensTool",
       "returns": "JSON: `{ ...UPGLens, visible_types: string[] }`",
       "return_shape": "{...UPGLens, visible_types: string[] }",
@@ -1895,7 +1953,7 @@
         "get_entity_meta",
         "get_entity_schema"
       ],
-      "source": "src/tools/spec.ts:1473",
+      "source": "src/tools/spec.ts:1491",
       "symbol": "getLifecycle",
       "returns": "JSON: the full `UPGLifecycle` record, or a descriptive message.",
       "return_notes": [
@@ -1930,7 +1988,7 @@
         "get_framework",
         "get_region"
       ],
-      "source": "src/tools/spec.ts:170",
+      "source": "src/tools/spec.ts:173",
       "symbol": "getPlaybook",
       "returns": "JSON: the full `UPGPlaybook` record.",
       "return_notes": [
@@ -1965,11 +2023,11 @@
         "get_playbook",
         "list_lenses"
       ],
-      "source": "src/tools/spec.ts:711",
+      "source": "src/tools/spec.ts:725",
       "symbol": "getRegion",
-      "returns": "JSON: the full `UPGRegion` record.",
+      "returns": "JSON: the full `UPGRegion` record plus `coverage_keys` and `business_areas`.",
       "return_notes": [
-        "JSON: the full `UPGRegion` record."
+        "JSON: the full `UPGRegion` record plus `coverage_keys` and `business_areas`."
       ],
       "atomicity": "atomic (read-only)"
     },
@@ -2000,7 +2058,7 @@
         "get_entity_meta",
         "list_entity_types"
       ],
-      "source": "src/tools/spec.ts:733",
+      "source": "src/tools/spec.ts:751",
       "symbol": "getRegionForEntity",
       "returns": "JSON: the full `UPGRegion` record.",
       "return_notes": [
@@ -2033,7 +2091,7 @@
         "list_scales",
         "get_entity_schema"
       ],
-      "source": "src/tools/spec.ts:1580",
+      "source": "src/tools/spec.ts:1598",
       "symbol": "getScale",
       "returns": "JSON: the full `UPGScaleDefinition` record including all points.",
       "return_notes": [
@@ -2057,7 +2115,7 @@
         "list_edge_types",
         "list_regions"
       ],
-      "source": "src/tools/spec.ts:760",
+      "source": "src/tools/spec.ts:778",
       "symbol": "getSpecVersion",
       "returns": "JSON: `{ upg_version, markdown_format_version, entity_count, edge_count, domain_count, region_count }`",
       "return_shape": "{ upg_version, markdown_format_version, entity_count, edge_count, domain_count, region_count }",
@@ -2097,7 +2155,7 @@
         "get_entity_meta",
         "list_frameworks"
       ],
-      "source": "src/tools/spec.ts:965",
+      "source": "src/tools/spec.ts:983",
       "symbol": "getTypeLabel",
       "returns": "JSON: `{ ...UPGTypeLabel, resolved_label: string }`",
       "return_shape": "{...UPGTypeLabel, resolved_label: string }",
@@ -2130,7 +2188,7 @@
         "get_entity_meta",
         "create_node"
       ],
-      "source": "src/tools/spec.ts:991",
+      "source": "src/tools/spec.ts:1009",
       "symbol": "getValidChildrenTool",
       "returns": "JSON: `{ parent_type, valid_children: string[] }`",
       "return_shape": "{ parent_type, valid_children: string[] }",
@@ -2169,7 +2227,7 @@
         "plan",
         "reflect"
       ],
-      "source": "src/tools/spec.ts:326",
+      "source": "src/tools/spec.ts:329",
       "symbol": "inspect",
       "returns": "JSON envelope: `{ approach_id: 'inspect', scope, generated_at, approach, params }`",
       "return_notes": [
@@ -2227,7 +2285,7 @@
         "inspect",
         "get_domain_guide"
       ],
-      "source": "src/tools/spec.ts:1125",
+      "source": "src/tools/spec.ts:1143",
       "symbol": "listAntiPatterns",
       "returns": "JSON: `{ total, count, next_cursor?, anti_patterns: UPGCuratedAntiPattern[] }`",
       "return_shape": "{ total, count, next_cursor?, anti_patterns: UPGCuratedAntiPattern[] }",
@@ -2258,7 +2316,7 @@
         "reflect",
         "list_playbooks"
       ],
-      "source": "src/tools/spec.ts:206",
+      "source": "src/tools/spec.ts:209",
       "symbol": "listApproaches",
       "returns": "JSON: `{ count, approaches: UPGApproach[] }`",
       "return_shape": "{ count, approaches: UPGApproach[] }",
@@ -2316,7 +2374,7 @@
         "list_domains",
         "list_anti_patterns"
       ],
-      "source": "src/tools/spec.ts:1199",
+      "source": "src/tools/spec.ts:1217",
       "symbol": "listBenchmarks",
       "returns": "JSON: `{ kind, total, count, benchmarks: ... }`",
       "return_shape": "{ kind, total, count, benchmarks:... }",
@@ -2338,7 +2396,7 @@
         "list_portfolio_cross_edges",
         "migrate_cross_edges"
       ],
-      "source": "src/tools/spec.ts:845",
+      "source": "src/tools/spec.ts:863",
       "symbol": "listCrossEdgeTypes",
       "returns": "JSON: `{ count, types: readonly UPGCrossEdgeType[] }`",
       "return_shape": "{ count, types: readonly UPGCrossEdgeType[] }",
@@ -2360,7 +2418,7 @@
         "list_domains",
         "get_domain_guide"
       ],
-      "source": "src/tools/spec.ts:1643",
+      "source": "src/tools/spec.ts:1661",
       "symbol": "listDomainRings",
       "returns": "JSON: `{ rings: UPGDomainRing[], total: number }`",
       "return_shape": "{ rings: UPGDomainRing[], total: number }",
@@ -2387,7 +2445,7 @@
         "list_regions",
         "list_entity_types"
       ],
-      "source": "src/tools/spec.ts:491",
+      "source": "src/tools/spec.ts:494",
       "symbol": "listDomains",
       "returns": "JSON: `{ count, domains: Array<{ domain_id, anchor_entity, creation_sequence } | { domain_id, label, description, types, has_guide }> }`",
       "return_shape": "{ count, domains: Array<{ domain_id, anchor_entity, creation_sequence } | { domain_id, label, description, types, has_guide }> }",
@@ -2416,7 +2474,7 @@
         "list_edge_types",
         "validate_graph"
       ],
-      "source": "src/tools/spec.ts:1365",
+      "source": "src/tools/spec.ts:1383",
       "symbol": "listEdgeMigrations",
       "returns": "JSON: `{ migrations: [{ kind, from, to?, since }], total: number }`",
       "return_shape": "{ migrations: [{ kind, from, to?, since }], total: number }",
@@ -2448,7 +2506,7 @@
         "list_cross_edge_types",
         "create_edge"
       ],
-      "source": "src/tools/spec.ts:634",
+      "source": "src/tools/spec.ts:637",
       "symbol": "listEdgeTypes",
       "returns": "JSON: `{ count, edges: Array<{ type, forward_verb, reverse_verb, classification, source_type, target_type }> }`",
       "return_shape": "{ count, edges: Array<{ type, forward_verb, reverse_verb, classification, source_type, target_type }> }",
@@ -2499,7 +2557,7 @@
         "list_type_labels",
         "list_domains"
       ],
-      "source": "src/tools/spec.ts:1034",
+      "source": "src/tools/spec.ts:1052",
       "symbol": "listEntityTypes",
       "returns": "JSON: `{ total, count, next_cursor?, types: Array<EntityTypeMeta & { domain_id: string | null }> }`",
       "return_shape": "{ total, count, next_cursor?, types: Array<EntityTypeMeta & { domain_id: string | null }> }",
@@ -2520,7 +2578,7 @@
         "list_frameworks",
         "list_framework_structure_patterns"
       ],
-      "source": "src/tools/spec.ts:1599",
+      "source": "src/tools/spec.ts:1617",
       "symbol": "listFrameworkCategories",
       "returns": "JSON: `{ categories: string[], total: number }`",
       "return_shape": "{ categories: string[], total: number }",
@@ -2542,7 +2600,7 @@
         "list_framework_categories",
         "get_framework"
       ],
-      "source": "src/tools/spec.ts:1620",
+      "source": "src/tools/spec.ts:1638",
       "symbol": "listFrameworkStructurePatterns",
       "returns": "JSON: `{ patterns: string[], total: number }`",
       "return_shape": "{ patterns: string[], total: number }",
@@ -2577,7 +2635,7 @@
         "prioritise",
         "list_approaches"
       ],
-      "source": "src/tools/spec.ts:555",
+      "source": "src/tools/spec.ts:558",
       "symbol": "listFrameworks",
       "returns": "JSON: `{ total, count, next_cursor?, frameworks: UPGFramework[] }`",
       "return_shape": "{ total, count, next_cursor?, frameworks: UPGFramework[] }",
@@ -2600,7 +2658,7 @@
         "list_playbooks",
         "list_frameworks"
       ],
-      "source": "src/tools/spec.ts:871",
+      "source": "src/tools/spec.ts:889",
       "symbol": "listLenses",
       "returns": "JSON: `{ count, lenses: Array<{ id, name, description, icon, audience, perspective, framework_id?, playbook_id?, visible_domain_count, intelligence_prompt_count }> }`",
       "return_shape": "{ count, lenses: Array<{ id, name, description, icon, audience, perspective, framework_id?, playbook_id?, visible_domain_count, intelligence_prompt_count }> }",
@@ -2631,7 +2689,7 @@
         "list_entity_types",
         "get_entity_meta"
       ],
-      "source": "src/tools/spec.ts:1430",
+      "source": "src/tools/spec.ts:1448",
       "symbol": "listLifecycles",
       "returns": "JSON: `{ lifecycles, total, free_types: string[], planned_types: string[] }`",
       "return_shape": "{ lifecycles, total, free_types: string[], planned_types: string[] }",
@@ -2667,7 +2725,7 @@
         "list_approaches",
         "list_frameworks"
       ],
-      "source": "src/tools/spec.ts:140",
+      "source": "src/tools/spec.ts:143",
       "symbol": "listPlaybooks",
       "returns": "JSON: `{ count, playbooks: UPGPlaybook[] }`",
       "return_shape": "{ count, playbooks: UPGPlaybook[] }",
@@ -2689,7 +2747,7 @@
         "list_anti_patterns",
         "create_product"
       ],
-      "source": "src/tools/spec.ts:1302",
+      "source": "src/tools/spec.ts:1320",
       "symbol": "listProductStages",
       "returns": "JSON: `{ count, stages: readonly UPGProductStage[] }`",
       "return_shape": "{ count, stages: readonly UPGProductStage[] }",
@@ -2712,10 +2770,10 @@
         "list_domains",
         "list_playbooks"
       ],
-      "source": "src/tools/spec.ts:679",
+      "source": "src/tools/spec.ts:688",
       "symbol": "listRegions",
-      "returns": "JSON: `{ count, regions: Array<{ id, label, order, shape, mental_model, anchor_type, composes_atomic_domains, entity_count, intra_edge_count, boundary_edge_count }> }`",
-      "return_shape": "{ count, regions: Array<{ id, label, order, shape, mental_model, anchor_type, composes_atomic_domains, entity_count, intra_edge_count, boundary_edge_count }> }",
+      "returns": "JSON: `{ count, regions: Array<{ id, label, order, shape, mental_model, anchor_type, composes_atomic_domains, entity_count, intra_edge_count, boundary_edge_count, coverage_keys, business_areas }>, area_taxonomy }`",
+      "return_shape": "{ count, regions: Array<{ id, label, order, shape, mental_model, anchor_type, composes_atomic_domains, entity_count, intra_edge_count, boundary_edge_count, coverage_keys, business_areas }>, area_taxonomy }",
       "atomicity": "atomic (read-only)"
     },
     {
@@ -2733,7 +2791,7 @@
         "get_scale",
         "get_entity_schema"
       ],
-      "source": "src/tools/spec.ts:1565",
+      "source": "src/tools/spec.ts:1583",
       "symbol": "listScales",
       "returns": "JSON: `{ scales: UPGScaleDefinition[], total: number }`",
       "return_shape": "{ scales: UPGScaleDefinition[], total: number }",
@@ -2756,7 +2814,7 @@
         "migrate_type",
         "validate_graph"
       ],
-      "source": "src/tools/spec.ts:1402",
+      "source": "src/tools/spec.ts:1420",
       "symbol": "listSplitMigrations",
       "returns": "JSON: `{ splits: [...], total: number }`",
       "return_shape": "{ splits: [...], total: number }",
@@ -2785,7 +2843,7 @@
         "get_lifecycle",
         "get_entity_schema"
       ],
-      "source": "src/tools/spec.ts:1505",
+      "source": "src/tools/spec.ts:1523",
       "symbol": "listStatusValues",
       "returns": "JSON: `{ entity_type, lifecycle_free, initial_status?, terminal_statuses?, values: [{ status, label, terminal }], note? }`.",
       "return_shape": "{ entity_type, lifecycle_free, initial_status?, terminal_statuses?, values: [{ status, label, terminal }], note? }",
@@ -2816,7 +2874,7 @@
         "list_entity_types",
         "get_entity_meta"
       ],
-      "source": "src/tools/spec.ts:934",
+      "source": "src/tools/spec.ts:952",
       "symbol": "listTypeLabels",
       "returns": "JSON: `{ total, count, next_cursor?, labels: UPGTypeLabel[] }`",
       "return_shape": "{ total, count, next_cursor?, labels: UPGTypeLabel[] }",
@@ -2845,7 +2903,7 @@
         "validate_graph",
         "list_entity_types"
       ],
-      "source": "src/tools/spec.ts:1334",
+      "source": "src/tools/spec.ts:1352",
       "symbol": "listTypeMigrations",
       "returns": "JSON: `{ migrations: [{ from, to, since }], total: number }`",
       "return_shape": "{ migrations: [{ from, to, since }], total: number }",
@@ -2876,7 +2934,7 @@
         "inspect",
         "prioritise"
       ],
-      "source": "src/tools/spec.ts:298",
+      "source": "src/tools/spec.ts:301",
       "symbol": "plan",
       "returns": "JSON envelope: `{ approach_id: 'plan', scope, generated_at, approach, params }`",
       "return_notes": [
@@ -2922,7 +2980,7 @@
         "plan",
         "trace"
       ],
-      "source": "src/tools/spec.ts:359",
+      "source": "src/tools/spec.ts:362",
       "symbol": "prioritise",
       "returns": "JSON envelope: `{ approach_id: 'prioritise', scope, generated_at, approach, params }`",
       "return_notes": [
@@ -2969,7 +3027,7 @@
         "plan",
         "get_anti_pattern"
       ],
-      "source": "src/tools/spec.ts:450",
+      "source": "src/tools/spec.ts:453",
       "symbol": "reflect",
       "returns": "JSON envelope: `{ approach_id: 'reflect', scope, generated_at, approach, params }`",
       "return_notes": [
@@ -3011,7 +3069,7 @@
         "create_edge",
         "trace"
       ],
-      "source": "src/tools/spec.ts:814",
+      "source": "src/tools/spec.ts:832",
       "symbol": "resolveEdgeForPair",
       "returns": "JSON: `{ source_type, target_type, edge_type: string | null }`",
       "return_shape": "{ source_type, target_type, edge_type: string | null }",
@@ -3066,7 +3124,7 @@
         "plan",
         "prioritise"
       ],
-      "source": "src/tools/spec.ts:403",
+      "source": "src/tools/spec.ts:406",
       "symbol": "trace",
       "returns": "JSON envelope: `{ approach_id: 'trace', scope, generated_at, approach, params }`",
       "return_notes": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unified-product-graph/cloud-server",
-  "version": "0.9.14",
+  "version": "0.9.16",
   "description": "Postgres-backed MCP server for the Unified Product Graph, self-hostable, open source",
   "license": "MIT",
   "author": "The Product Creator <hello@theproductcreator.com>",
@@ -40,8 +40,8 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.27.0",
-    "@unified-product-graph/core": "0.9.14",
-    "@unified-product-graph/sdk": "0.9.14",
+    "@unified-product-graph/core": "0.9.16",
+    "@unified-product-graph/sdk": "0.9.16",
     "nanoid": "^5.1.0",
     "pg": "^8.13.0"
   },