@unified-product-graph/cloud-server 0.9.18 → 0.9.20

package/dist/tools-manifest.json

@@ -1,8 +1,8 @@
 {
   "schema_version": "2",
   "package": "@unified-product-graph/cloud-server",
-  "package_version": "0.9.18",
-  "tool_count": 95,
+  "package_version": "0.9.20",
+  "tool_count": 97,
   "domains": [
     "products",
     "context",
@@ -244,7 +244,7 @@
     },
     {
       "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.",
+      "description": "Assemble a canonical tree pattern (ost, okr, user, product, validation, strategy, feature_areas, delivery, architecture, journey, design_system) 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",
@@ -255,7 +255,7 @@
           },
           "pattern": {
             "type": "string",
-            "description": "Tree pattern id: ost, okr, user, product, validation, strategy, feature_areas"
+            "description": "Tree pattern id: ost, okr, user, product, validation, strategy, feature_areas, delivery, architecture, journey, design_system"
           },
           "from_id": {
             "type": "string",
@@ -291,7 +291,7 @@
         "query",
         "list_playbooks"
       ],
-      "source": "src/tools/tree.ts:47",
+      "source": "src/tools/tree.ts:49",
       "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 }] }",
@@ -1673,7 +1673,7 @@
         "inspect",
         "validate_graph"
       ],
-      "source": "src/tools/spec.ts:1183",
+      "source": "src/tools/spec.ts:1221",
       "symbol": "getAntiPattern",
       "returns": "JSON: `UPGCuratedAntiPattern`",
       "return_notes": [
@@ -1717,7 +1717,7 @@
         "trace",
         "reflect"
       ],
-      "source": "src/tools/spec.ts:237",
+      "source": "src/tools/spec.ts:239",
       "symbol": "getApproach",
       "returns": "JSON: the full `UPGApproach` record.",
       "return_notes": [
@@ -1751,7 +1751,7 @@
         "list_anti_patterns",
         "get_playbook"
       ],
-      "source": "src/tools/spec.ts:528",
+      "source": "src/tools/spec.ts:530",
       "symbol": "getDomainGuide",
       "returns": "JSON: the full `UPGDomainUsageGuide` record.",
       "return_notes": [
@@ -1785,7 +1785,7 @@
         "list_domains",
         "get_domain_guide"
       ],
-      "source": "src/tools/spec.ts:1682",
+      "source": "src/tools/spec.ts:1720",
       "symbol": "getDomainRing",
       "returns": "JSON: the full `UPGDomainRing` record.",
       "return_notes": [
@@ -1819,7 +1819,7 @@
         "resolve_edge_for_pair",
         "rename_edge_type"
       ],
-      "source": "src/tools/spec.ts:655",
+      "source": "src/tools/spec.ts:657",
       "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 }",
@@ -1851,7 +1851,7 @@
         "get_type_label",
         "get_entity_schema"
       ],
-      "source": "src/tools/spec.ts:1102",
+      "source": "src/tools/spec.ts:1140",
       "symbol": "getEntityMeta",
       "returns": "JSON: `EntityTypeMeta & { domain_id: string | null }`",
       "return_notes": [
@@ -1886,7 +1886,7 @@
         "get_playbook",
         "get_approach"
       ],
-      "source": "src/tools/spec.ts:594",
+      "source": "src/tools/spec.ts:596",
       "symbol": "getFramework",
       "returns": "JSON: the full `UPGFramework` record.",
       "return_notes": [
@@ -1921,7 +1921,7 @@
         "get_framework",
         "list_entity_types"
       ],
-      "source": "src/tools/spec.ts:922",
+      "source": "src/tools/spec.ts:960",
       "symbol": "getLensTool",
       "returns": "JSON: `{ ...UPGLens, visible_types: string[] }`",
       "return_shape": "{...UPGLens, visible_types: string[] }",
@@ -1953,7 +1953,7 @@
         "get_entity_meta",
         "get_entity_schema"
       ],
-      "source": "src/tools/spec.ts:1491",
+      "source": "src/tools/spec.ts:1529",
       "symbol": "getLifecycle",
       "returns": "JSON: the full `UPGLifecycle` record, or a descriptive message.",
       "return_notes": [
@@ -1988,7 +1988,7 @@
         "get_framework",
         "get_region"
       ],
-      "source": "src/tools/spec.ts:173",
+      "source": "src/tools/spec.ts:175",
       "symbol": "getPlaybook",
       "returns": "JSON: the full `UPGPlaybook` record.",
       "return_notes": [
@@ -2023,7 +2023,7 @@
         "get_playbook",
         "list_lenses"
       ],
-      "source": "src/tools/spec.ts:725",
+      "source": "src/tools/spec.ts:727",
       "symbol": "getRegion",
       "returns": "JSON: the full `UPGRegion` record plus `coverage_keys` and `business_areas`.",
       "return_notes": [
@@ -2058,7 +2058,7 @@
         "get_entity_meta",
         "list_entity_types"
       ],
-      "source": "src/tools/spec.ts:751",
+      "source": "src/tools/spec.ts:753",
       "symbol": "getRegionForEntity",
       "returns": "JSON: the full `UPGRegion` record.",
       "return_notes": [
@@ -2091,7 +2091,7 @@
         "list_scales",
         "get_entity_schema"
       ],
-      "source": "src/tools/spec.ts:1598",
+      "source": "src/tools/spec.ts:1636",
       "symbol": "getScale",
       "returns": "JSON: the full `UPGScaleDefinition` record including all points.",
       "return_notes": [
@@ -2115,12 +2115,45 @@
         "list_edge_types",
         "list_regions"
       ],
-      "source": "src/tools/spec.ts:778",
+      "source": "src/tools/spec.ts:816",
       "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 }",
       "atomicity": "atomic (read-only)"
     },
+    {
+      "name": "get_tree_pattern",
+      "description": "Return the full declarative record for one get_tree pattern: its region, anchor_type, fallback_anchors, gap_policy, natural_depth, and its child map resolved to concrete edges. Each parent-to-child slot carries the canonical via edge and its kind, resolved live from the edge catalogue, so a client reads the real wiring and the pattern cannot cite an edge the grammar lacks.",
+      "domain": "spec",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "id": {
+            "type": "string",
+            "description": "Tree pattern id: ost, okr, user, product, validation, strategy, feature_areas, delivery, architecture, journey, design_system."
+          }
+        },
+        "required": [
+          "id"
+        ]
+      },
+      "throws": [
+        "textError when `id` is missing or unknown."
+      ],
+      "examples": [],
+      "warnings": [],
+      "see": [
+        "list_tree_patterns",
+        "resolve_edge_for_pair"
+      ],
+      "source": "src/tools/spec.ts:789",
+      "symbol": "getTreePattern",
+      "returns": "JSON: the `UPGTreePatternDetail` record.",
+      "return_notes": [
+        "JSON: the `UPGTreePatternDetail` record."
+      ],
+      "atomicity": "atomic (read-only)"
+    },
     {
       "name": "get_type_label",
       "description": "Return one canonical UPGTypeLabel by entity type, plus a resolved display label for an optional framework_id and/or designation (wraps resolveLabel). Lookup is exact-match against UPG_TYPE_LABELS_MAP.",
@@ -2155,7 +2188,7 @@
         "get_entity_meta",
         "list_frameworks"
       ],
-      "source": "src/tools/spec.ts:983",
+      "source": "src/tools/spec.ts:1021",
       "symbol": "getTypeLabel",
       "returns": "JSON: `{ ...UPGTypeLabel, resolved_label: string }`",
       "return_shape": "{...UPGTypeLabel, resolved_label: string }",
@@ -2188,7 +2221,7 @@
         "get_entity_meta",
         "create_node"
       ],
-      "source": "src/tools/spec.ts:1009",
+      "source": "src/tools/spec.ts:1047",
       "symbol": "getValidChildrenTool",
       "returns": "JSON: `{ parent_type, valid_children: string[] }`",
       "return_shape": "{ parent_type, valid_children: string[] }",
@@ -2227,7 +2260,7 @@
         "plan",
         "reflect"
       ],
-      "source": "src/tools/spec.ts:329",
+      "source": "src/tools/spec.ts:331",
       "symbol": "inspect",
       "returns": "JSON envelope: `{ approach_id: 'inspect', scope, generated_at, approach, params }`",
       "return_notes": [
@@ -2285,7 +2318,7 @@
         "inspect",
         "get_domain_guide"
       ],
-      "source": "src/tools/spec.ts:1143",
+      "source": "src/tools/spec.ts:1181",
       "symbol": "listAntiPatterns",
       "returns": "JSON: `{ total, count, next_cursor?, anti_patterns: UPGCuratedAntiPattern[] }`",
       "return_shape": "{ total, count, next_cursor?, anti_patterns: UPGCuratedAntiPattern[] }",
@@ -2316,7 +2349,7 @@
         "reflect",
         "list_playbooks"
       ],
-      "source": "src/tools/spec.ts:209",
+      "source": "src/tools/spec.ts:211",
       "symbol": "listApproaches",
       "returns": "JSON: `{ count, approaches: UPGApproach[] }`",
       "return_shape": "{ count, approaches: UPGApproach[] }",
@@ -2374,7 +2407,7 @@
         "list_domains",
         "list_anti_patterns"
       ],
-      "source": "src/tools/spec.ts:1217",
+      "source": "src/tools/spec.ts:1255",
       "symbol": "listBenchmarks",
       "returns": "JSON: `{ kind, total, count, benchmarks: ... }`",
       "return_shape": "{ kind, total, count, benchmarks:... }",
@@ -2396,7 +2429,7 @@
         "list_portfolio_cross_edges",
         "migrate_cross_edges"
       ],
-      "source": "src/tools/spec.ts:863",
+      "source": "src/tools/spec.ts:901",
       "symbol": "listCrossEdgeTypes",
       "returns": "JSON: `{ count, types: readonly UPGCrossEdgeType[] }`",
       "return_shape": "{ count, types: readonly UPGCrossEdgeType[] }",
@@ -2418,7 +2451,7 @@
         "list_domains",
         "get_domain_guide"
       ],
-      "source": "src/tools/spec.ts:1661",
+      "source": "src/tools/spec.ts:1699",
       "symbol": "listDomainRings",
       "returns": "JSON: `{ rings: UPGDomainRing[], total: number }`",
       "return_shape": "{ rings: UPGDomainRing[], total: number }",
@@ -2445,7 +2478,7 @@
         "list_regions",
         "list_entity_types"
       ],
-      "source": "src/tools/spec.ts:494",
+      "source": "src/tools/spec.ts:496",
       "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 }> }",
@@ -2474,7 +2507,7 @@
         "list_edge_types",
         "validate_graph"
       ],
-      "source": "src/tools/spec.ts:1383",
+      "source": "src/tools/spec.ts:1421",
       "symbol": "listEdgeMigrations",
       "returns": "JSON: `{ migrations: [{ kind, from, to?, since }], total: number }`",
       "return_shape": "{ migrations: [{ kind, from, to?, since }], total: number }",
@@ -2506,7 +2539,7 @@
         "list_cross_edge_types",
         "create_edge"
       ],
-      "source": "src/tools/spec.ts:637",
+      "source": "src/tools/spec.ts:639",
       "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 }> }",
@@ -2557,7 +2590,7 @@
         "list_type_labels",
         "list_domains"
       ],
-      "source": "src/tools/spec.ts:1052",
+      "source": "src/tools/spec.ts:1090",
       "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 }> }",
@@ -2578,7 +2611,7 @@
         "list_frameworks",
         "list_framework_structure_patterns"
       ],
-      "source": "src/tools/spec.ts:1617",
+      "source": "src/tools/spec.ts:1655",
       "symbol": "listFrameworkCategories",
       "returns": "JSON: `{ categories: string[], total: number }`",
       "return_shape": "{ categories: string[], total: number }",
@@ -2600,7 +2633,7 @@
         "list_framework_categories",
         "get_framework"
       ],
-      "source": "src/tools/spec.ts:1638",
+      "source": "src/tools/spec.ts:1676",
       "symbol": "listFrameworkStructurePatterns",
       "returns": "JSON: `{ patterns: string[], total: number }`",
       "return_shape": "{ patterns: string[], total: number }",
@@ -2635,7 +2668,7 @@
         "prioritise",
         "list_approaches"
       ],
-      "source": "src/tools/spec.ts:558",
+      "source": "src/tools/spec.ts:560",
       "symbol": "listFrameworks",
       "returns": "JSON: `{ total, count, next_cursor?, frameworks: UPGFramework[] }`",
       "return_shape": "{ total, count, next_cursor?, frameworks: UPGFramework[] }",
@@ -2658,7 +2691,7 @@
         "list_playbooks",
         "list_frameworks"
       ],
-      "source": "src/tools/spec.ts:889",
+      "source": "src/tools/spec.ts:927",
       "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 }> }",
@@ -2689,7 +2722,7 @@
         "list_entity_types",
         "get_entity_meta"
       ],
-      "source": "src/tools/spec.ts:1448",
+      "source": "src/tools/spec.ts:1486",
       "symbol": "listLifecycles",
       "returns": "JSON: `{ lifecycles, total, free_types: string[], planned_types: string[] }`",
       "return_shape": "{ lifecycles, total, free_types: string[], planned_types: string[] }",
@@ -2725,7 +2758,7 @@
         "list_approaches",
         "list_frameworks"
       ],
-      "source": "src/tools/spec.ts:143",
+      "source": "src/tools/spec.ts:145",
       "symbol": "listPlaybooks",
       "returns": "JSON: `{ count, playbooks: UPGPlaybook[] }`",
       "return_shape": "{ count, playbooks: UPGPlaybook[] }",
@@ -2747,7 +2780,7 @@
         "list_anti_patterns",
         "create_product"
       ],
-      "source": "src/tools/spec.ts:1320",
+      "source": "src/tools/spec.ts:1358",
       "symbol": "listProductStages",
       "returns": "JSON: `{ count, stages: readonly UPGProductStage[] }`",
       "return_shape": "{ count, stages: readonly UPGProductStage[] }",
@@ -2770,7 +2803,7 @@
         "list_domains",
         "list_playbooks"
       ],
-      "source": "src/tools/spec.ts:688",
+      "source": "src/tools/spec.ts:690",
       "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, 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 }",
@@ -2791,7 +2824,7 @@
         "get_scale",
         "get_entity_schema"
       ],
-      "source": "src/tools/spec.ts:1583",
+      "source": "src/tools/spec.ts:1621",
       "symbol": "listScales",
       "returns": "JSON: `{ scales: UPGScaleDefinition[], total: number }`",
       "return_shape": "{ scales: UPGScaleDefinition[], total: number }",
@@ -2814,7 +2847,7 @@
         "migrate_type",
         "validate_graph"
       ],
-      "source": "src/tools/spec.ts:1420",
+      "source": "src/tools/spec.ts:1458",
       "symbol": "listSplitMigrations",
       "returns": "JSON: `{ splits: [...], total: number }`",
       "return_shape": "{ splits: [...], total: number }",
@@ -2843,12 +2876,33 @@
         "get_lifecycle",
         "get_entity_schema"
       ],
-      "source": "src/tools/spec.ts:1523",
+      "source": "src/tools/spec.ts:1561",
       "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? }",
       "atomicity": "atomic (read-only)"
     },
+    {
+      "name": "list_tree_patterns",
+      "description": "List the canonical get_tree patterns as summary rows: id, label, the region each is the tree view of, anchor_type, fallback_anchors, natural_depth, gap_policy, and slot_count. The introspectable index of what get_tree can assemble. Fixed list, non-paginated.",
+      "domain": "spec",
+      "inputSchema": {
+        "type": "object",
+        "properties": {}
+      },
+      "throws": [],
+      "examples": [],
+      "warnings": [],
+      "see": [
+        "get_tree_pattern",
+        "get_tree"
+      ],
+      "source": "src/tools/spec.ts:773",
+      "symbol": "listTreePatterns",
+      "returns": "JSON: `{ count, patterns }`",
+      "return_shape": "{ count, patterns }",
+      "atomicity": "atomic (read-only)"
+    },
     {
       "name": "list_type_labels",
       "description": "List canonical UPGTypeLabel entries: every entity type's display label, alt-labels (synonyms), per-framework labels, and (where applicable) designation labels. Paginated (default limit 100, max 500). Cursor is opaque base64 (offset:N) following the list_frameworks convention. External MCP apps need labels for rendering.",
@@ -2874,7 +2928,7 @@
         "list_entity_types",
         "get_entity_meta"
       ],
-      "source": "src/tools/spec.ts:952",
+      "source": "src/tools/spec.ts:990",
       "symbol": "listTypeLabels",
       "returns": "JSON: `{ total, count, next_cursor?, labels: UPGTypeLabel[] }`",
       "return_shape": "{ total, count, next_cursor?, labels: UPGTypeLabel[] }",
@@ -2903,7 +2957,7 @@
         "validate_graph",
         "list_entity_types"
       ],
-      "source": "src/tools/spec.ts:1352",
+      "source": "src/tools/spec.ts:1390",
       "symbol": "listTypeMigrations",
       "returns": "JSON: `{ migrations: [{ from, to, since }], total: number }`",
       "return_shape": "{ migrations: [{ from, to, since }], total: number }",
@@ -2934,7 +2988,7 @@
         "inspect",
         "prioritise"
       ],
-      "source": "src/tools/spec.ts:301",
+      "source": "src/tools/spec.ts:303",
       "symbol": "plan",
       "returns": "JSON envelope: `{ approach_id: 'plan', scope, generated_at, approach, params }`",
       "return_notes": [
@@ -2980,7 +3034,7 @@
         "plan",
         "trace"
       ],
-      "source": "src/tools/spec.ts:362",
+      "source": "src/tools/spec.ts:364",
       "symbol": "prioritise",
       "returns": "JSON envelope: `{ approach_id: 'prioritise', scope, generated_at, approach, params }`",
       "return_notes": [
@@ -3027,7 +3081,7 @@
         "plan",
         "get_anti_pattern"
       ],
-      "source": "src/tools/spec.ts:453",
+      "source": "src/tools/spec.ts:455",
       "symbol": "reflect",
       "returns": "JSON envelope: `{ approach_id: 'reflect', scope, generated_at, approach, params }`",
       "return_notes": [
@@ -3069,7 +3123,7 @@
         "create_edge",
         "trace"
       ],
-      "source": "src/tools/spec.ts:832",
+      "source": "src/tools/spec.ts:870",
       "symbol": "resolveEdgeForPair",
       "returns": "JSON: `{ source_type, target_type, edge_type: string | null }`",
       "return_shape": "{ source_type, target_type, edge_type: string | null }",
@@ -3124,7 +3178,7 @@
         "plan",
         "prioritise"
       ],
-      "source": "src/tools/spec.ts:406",
+      "source": "src/tools/spec.ts:408",
       "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.18",
+  "version": "0.9.20",
   "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.18",
-    "@unified-product-graph/sdk": "0.9.18",
+    "@unified-product-graph/core": "0.9.20",
+    "@unified-product-graph/sdk": "0.9.20",
     "nanoid": "^5.1.0",
     "pg": "^8.13.0"
   },