@unified-product-graph/cloud-server 0.9.10 → 0.9.11

package/dist/tools-manifest.json

@@ -1,8 +1,8 @@
 {
   "schema_version": "2",
   "package": "@unified-product-graph/cloud-server",
-  "package_version": "0.9.10",
-  "tool_count": 93,
+  "package_version": "0.9.11",
+  "tool_count": 94,
   "domains": [
     "products",
     "context",
@@ -1615,7 +1615,7 @@
         "inspect",
         "validate_graph"
       ],
-      "source": "src/tools/spec.ts:1152",
+      "source": "src/tools/spec.ts:1165",
       "symbol": "getAntiPattern",
       "returns": "JSON: `UPGCuratedAntiPattern`",
       "return_notes": [
@@ -1727,7 +1727,7 @@
         "list_domains",
         "get_domain_guide"
       ],
-      "source": "src/tools/spec.ts:1591",
+      "source": "src/tools/spec.ts:1664",
       "symbol": "getDomainRing",
       "returns": "JSON: the full `UPGDomainRing` record.",
       "return_notes": [
@@ -1793,7 +1793,7 @@
         "get_type_label",
         "get_entity_schema"
       ],
-      "source": "src/tools/spec.ts:1071",
+      "source": "src/tools/spec.ts:1084",
       "symbol": "getEntityMeta",
       "returns": "JSON: `EntityTypeMeta & { domain_id: string | null }`",
       "return_notes": [
@@ -1863,7 +1863,7 @@
         "get_framework",
         "list_entity_types"
       ],
-      "source": "src/tools/spec.ts:891",
+      "source": "src/tools/spec.ts:904",
       "symbol": "getLensTool",
       "returns": "JSON: `{ ...UPGLens, visible_types: string[] }`",
       "return_shape": "{...UPGLens, visible_types: string[] }",
@@ -1895,7 +1895,7 @@
         "get_entity_meta",
         "get_entity_schema"
       ],
-      "source": "src/tools/spec.ts:1460",
+      "source": "src/tools/spec.ts:1473",
       "symbol": "getLifecycle",
       "returns": "JSON: the full `UPGLifecycle` record, or a descriptive message.",
       "return_notes": [
@@ -2033,7 +2033,7 @@
         "list_scales",
         "get_entity_schema"
       ],
-      "source": "src/tools/spec.ts:1507",
+      "source": "src/tools/spec.ts:1580",
       "symbol": "getScale",
       "returns": "JSON: the full `UPGScaleDefinition` record including all points.",
       "return_notes": [
@@ -2097,7 +2097,7 @@
         "get_entity_meta",
         "list_frameworks"
       ],
-      "source": "src/tools/spec.ts:952",
+      "source": "src/tools/spec.ts:965",
       "symbol": "getTypeLabel",
       "returns": "JSON: `{ ...UPGTypeLabel, resolved_label: string }`",
       "return_shape": "{...UPGTypeLabel, resolved_label: string }",
@@ -2130,7 +2130,7 @@
         "get_entity_meta",
         "create_node"
       ],
-      "source": "src/tools/spec.ts:978",
+      "source": "src/tools/spec.ts:991",
       "symbol": "getValidChildrenTool",
       "returns": "JSON: `{ parent_type, valid_children: string[] }`",
       "return_shape": "{ parent_type, valid_children: string[] }",
@@ -2227,7 +2227,7 @@
         "inspect",
         "get_domain_guide"
       ],
-      "source": "src/tools/spec.ts:1112",
+      "source": "src/tools/spec.ts:1125",
       "symbol": "listAntiPatterns",
       "returns": "JSON: `{ total, count, next_cursor?, anti_patterns: UPGCuratedAntiPattern[] }`",
       "return_shape": "{ total, count, next_cursor?, anti_patterns: UPGCuratedAntiPattern[] }",
@@ -2316,7 +2316,7 @@
         "list_domains",
         "list_anti_patterns"
       ],
-      "source": "src/tools/spec.ts:1186",
+      "source": "src/tools/spec.ts:1199",
       "symbol": "listBenchmarks",
       "returns": "JSON: `{ kind, total, count, benchmarks: ... }`",
       "return_shape": "{ kind, total, count, benchmarks:... }",
@@ -2338,7 +2338,7 @@
         "list_portfolio_cross_edges",
         "migrate_cross_edges"
       ],
-      "source": "src/tools/spec.ts:832",
+      "source": "src/tools/spec.ts:845",
       "symbol": "listCrossEdgeTypes",
       "returns": "JSON: `{ count, types: readonly UPGCrossEdgeType[] }`",
       "return_shape": "{ count, types: readonly UPGCrossEdgeType[] }",
@@ -2360,7 +2360,7 @@
         "list_domains",
         "get_domain_guide"
       ],
-      "source": "src/tools/spec.ts:1570",
+      "source": "src/tools/spec.ts:1643",
       "symbol": "listDomainRings",
       "returns": "JSON: `{ rings: UPGDomainRing[], total: number }`",
       "return_shape": "{ rings: UPGDomainRing[], total: number }",
@@ -2416,7 +2416,7 @@
         "list_edge_types",
         "validate_graph"
       ],
-      "source": "src/tools/spec.ts:1352",
+      "source": "src/tools/spec.ts:1365",
       "symbol": "listEdgeMigrations",
       "returns": "JSON: `{ migrations: [{ kind, from, to?, since }], total: number }`",
       "return_shape": "{ migrations: [{ kind, from, to?, since }], total: number }",
@@ -2499,7 +2499,7 @@
         "list_type_labels",
         "list_domains"
       ],
-      "source": "src/tools/spec.ts:1021",
+      "source": "src/tools/spec.ts:1034",
       "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 +2520,7 @@
         "list_frameworks",
         "list_framework_structure_patterns"
       ],
-      "source": "src/tools/spec.ts:1526",
+      "source": "src/tools/spec.ts:1599",
       "symbol": "listFrameworkCategories",
       "returns": "JSON: `{ categories: string[], total: number }`",
       "return_shape": "{ categories: string[], total: number }",
@@ -2542,7 +2542,7 @@
         "list_framework_categories",
         "get_framework"
       ],
-      "source": "src/tools/spec.ts:1547",
+      "source": "src/tools/spec.ts:1620",
       "symbol": "listFrameworkStructurePatterns",
       "returns": "JSON: `{ patterns: string[], total: number }`",
       "return_shape": "{ patterns: string[], total: number }",
@@ -2600,7 +2600,7 @@
         "list_playbooks",
         "list_frameworks"
       ],
-      "source": "src/tools/spec.ts:858",
+      "source": "src/tools/spec.ts:871",
       "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 +2631,7 @@
         "list_entity_types",
         "get_entity_meta"
       ],
-      "source": "src/tools/spec.ts:1417",
+      "source": "src/tools/spec.ts:1430",
       "symbol": "listLifecycles",
       "returns": "JSON: `{ lifecycles, total, free_types: string[], planned_types: string[] }`",
       "return_shape": "{ lifecycles, total, free_types: string[], planned_types: string[] }",
@@ -2689,7 +2689,7 @@
         "list_anti_patterns",
         "create_product"
       ],
-      "source": "src/tools/spec.ts:1289",
+      "source": "src/tools/spec.ts:1302",
       "symbol": "listProductStages",
       "returns": "JSON: `{ count, stages: readonly UPGProductStage[] }`",
       "return_shape": "{ count, stages: readonly UPGProductStage[] }",
@@ -2733,7 +2733,7 @@
         "get_scale",
         "get_entity_schema"
       ],
-      "source": "src/tools/spec.ts:1492",
+      "source": "src/tools/spec.ts:1565",
       "symbol": "listScales",
       "returns": "JSON: `{ scales: UPGScaleDefinition[], total: number }`",
       "return_shape": "{ scales: UPGScaleDefinition[], total: number }",
@@ -2756,12 +2756,41 @@
         "migrate_type",
         "validate_graph"
       ],
-      "source": "src/tools/spec.ts:1389",
+      "source": "src/tools/spec.ts:1402",
       "symbol": "listSplitMigrations",
       "returns": "JSON: `{ splits: [...], total: number }`",
       "return_shape": "{ splits: [...], total: number }",
       "atomicity": "atomic (read-only)"
     },
+    {
+      "name": "list_status_values",
+      "description": "List the valid `status` values an entity type can hold: the pre-flight lookup so you no longer learn the set only from a rejected write. For a lifecycle type, returns each phase as `{ status, label, terminal }` plus `initial_status` and `terminal_statuses`; for a lifecycle-free type, returns `lifecycle_free: true` with empty `values`. The focused, low-token sibling of `get_lifecycle`.",
+      "domain": "spec",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "entity_type": {
+            "type": "string",
+            "description": "Canonical entity type name (e.g. \"feature\", \"key_result\", \"need\")."
+          }
+        },
+        "required": [
+          "entity_type"
+        ]
+      },
+      "throws": [],
+      "examples": [],
+      "warnings": [],
+      "see": [
+        "get_lifecycle",
+        "get_entity_schema"
+      ],
+      "source": "src/tools/spec.ts:1505",
+      "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_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.",
@@ -2787,7 +2816,7 @@
         "list_entity_types",
         "get_entity_meta"
       ],
-      "source": "src/tools/spec.ts:921",
+      "source": "src/tools/spec.ts:934",
       "symbol": "listTypeLabels",
       "returns": "JSON: `{ total, count, next_cursor?, labels: UPGTypeLabel[] }`",
       "return_shape": "{ total, count, next_cursor?, labels: UPGTypeLabel[] }",
@@ -2816,7 +2845,7 @@
         "validate_graph",
         "list_entity_types"
       ],
-      "source": "src/tools/spec.ts:1321",
+      "source": "src/tools/spec.ts:1334",
       "symbol": "listTypeMigrations",
       "returns": "JSON: `{ migrations: [{ from, to, since }], total: number }`",
       "return_shape": "{ migrations: [{ from, to, since }], total: number }",
@@ -2982,7 +3011,7 @@
         "create_edge",
         "trace"
       ],
-      "source": "src/tools/spec.ts:801",
+      "source": "src/tools/spec.ts:814",
       "symbol": "resolveEdgeForPair",
       "returns": "JSON: `{ source_type, target_type, edge_type: string | null }`",
       "return_shape": "{ source_type, target_type, edge_type: string | null }",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unified-product-graph/cloud-server",
-  "version": "0.9.10",
+  "version": "0.9.11",
   "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.10",
-    "@unified-product-graph/sdk": "0.9.10",
+    "@unified-product-graph/core": "0.9.11",
+    "@unified-product-graph/sdk": "0.9.11",
     "nanoid": "^5.1.0",
     "pg": "^8.13.0"
   },