@unified-product-graph/mcp-server 0.8.16 → 0.9.1

package/dist/tools-manifest.json

@@ -1,8 +1,8 @@
 {
   "schema_version": "2",
   "package": "@unified-product-graph/mcp-server",
-  "package_version": "0.8.16",
-  "tool_count": 106,
+  "package_version": "0.9.1",
+  "tool_count": 108,
   "domains": [
     "context",
     "nodes",
@@ -1952,7 +1952,7 @@
         "assign_product_to_area",
         "create_product"
       ],
-      "source": "src/tools/workspace.ts:777",
+      "source": "src/tools/workspace.ts:816",
       "symbol": "attachProductToPortfolioTool",
       "returns": "JSON: `{ product_id, container_id, container_kind: \"portfolio\",\ncontainer_title?, already_member, registered }`.",
       "return_shape": "{ product_id, container_id, container_kind: \"portfolio\", container_title?, already_member, registered }",
@@ -1988,7 +1988,8 @@
                     "depends_on_product",
                     "cannibalises",
                     "succeeds",
-                    "hosts"
+                    "hosts",
+                    "contributes_to"
                   ],
                   "description": "Cross-product relationship type"
                 },
@@ -2026,7 +2027,7 @@
         "create_cross_product_edge",
         "list_cross_edge_types"
       ],
-      "source": "src/tools/workspace.ts:860",
+      "source": "src/tools/workspace.ts:899",
       "symbol": "batchCreateCrossProductEdges",
       "returns": "JSON: `{ message, created: UPGCrossEdge[], count, portfolio_file,\nregistered_products? }`.",
       "return_shape": "{ message, created: UPGCrossEdge[], count, portfolio_file, registered_products? }",
@@ -2034,7 +2035,7 @@
     },
     {
       "name": "create_cross_product_edge",
-      "description": "Create a cross-product relationship between two entities in different products within a portfolio graph. Types: `shares_persona`, `shares_competitor`, `shares_metric`, `depends_on_product`, `cannibalises`, `succeeds`, `hosts` (host product runs the hosted product inside itself, directed host to hosted).",
+      "description": "Create a cross-product relationship between two entities in different products within a portfolio graph. Types: `shares_persona`, `shares_competitor`, `shares_metric`, `depends_on_product`, `cannibalises`, `succeeds`, `hosts` (host product runs the hosted product inside itself, directed host to hosted), `contributes_to` (a product strategy entity rolls up to a higher-level one, e.g. product objective → company objective, product key_result → company key_result; directed subordinate to superior).",
       "domain": "workspace",
       "inputSchema": {
         "type": "object",
@@ -2056,7 +2057,8 @@
               "depends_on_product",
               "cannibalises",
               "succeeds",
-              "hosts"
+              "hosts",
+              "contributes_to"
             ],
             "description": "Cross-product relationship type"
           },
@@ -2085,7 +2087,7 @@
         "list_portfolio_cross_edges",
         "migrate_cross_edges"
       ],
-      "source": "src/tools/workspace.ts:494",
+      "source": "src/tools/workspace.ts:533",
       "symbol": "createCrossProductEdge",
       "returns": "JSON: `{ edge, portfolio_file }`.",
       "return_shape": "{ edge, portfolio_file }",
@@ -2141,7 +2143,7 @@
       "see": [
         "init_workspace"
       ],
-      "source": "src/tools/workspace.ts:335",
+      "source": "src/tools/workspace.ts:374",
       "symbol": "createProductTool",
       "returns": "JSON: `{ message, ...result }`. `result` carries `id`, `title`,\n`slug`, `file_path`, and the optional portfolio edge.",
       "return_shape": "{ message,...result }",
@@ -2175,7 +2177,7 @@
         "create_cross_product_edge",
         "list_portfolio_cross_edges"
       ],
-      "source": "src/tools/workspace.ts:831",
+      "source": "src/tools/workspace.ts:870",
       "symbol": "deleteCrossProductEdgeTool",
       "returns": "JSON: `{ edge_id, deleted, edge? }`. `deleted: false` (not an error) when\nno edge with that id exists, so retries are idempotent.",
       "return_shape": "{ edge_id, deleted, edge? }",
@@ -2213,7 +2215,7 @@
       "see": [
         "attach_product_to_portfolio"
       ],
-      "source": "src/tools/workspace.ts:804",
+      "source": "src/tools/workspace.ts:843",
       "symbol": "detachProductFromPortfolioTool",
       "returns": "JSON: `{ product_id, container_id, container_kind: \"portfolio\",\ncontainer_title?, removed }`. `removed: false` (not an error) when the product was\nnot a member, so retries are idempotent.",
       "return_shape": "{ product_id, container_id, container_kind: \"portfolio\", container_title?, removed }",
@@ -2242,7 +2244,7 @@
       "see": [
         "list_portfolios"
       ],
-      "source": "src/tools/workspace.ts:443",
+      "source": "src/tools/workspace.ts:482",
       "symbol": "getOrganization",
       "returns": "JSON: `{ organization: UPGOrganization | null, portfolio_file? }`.\nReturns `{ organization: null }` when no portfolio document exists yet.",
       "return_shape": "{ organization: UPGOrganization | null, portfolio_file? }",
@@ -2271,7 +2273,7 @@
       "see": [
         "init_workspace"
       ],
-      "source": "src/tools/workspace.ts:223",
+      "source": "src/tools/workspace.ts:262",
       "symbol": "getWorkspaceInfo",
       "returns": "JSON: `{ mode, workspace_path?, current_product?, current_file?,\nproducts }`. The shape depends on whether `.upg/workspace.json` exists.",
       "return_shape": "{ mode, workspace_path?, current_product?, current_file?, products }",
@@ -2311,7 +2313,7 @@
         "switch_product",
         "get_workspace_info"
       ],
-      "source": "src/tools/workspace.ts:299",
+      "source": "src/tools/workspace.ts:338",
       "symbol": "initWorkspaceTool",
       "returns": "JSON: `{ message, ...result }`. `result` carries the workspace\npath and the moved file's new location.",
       "return_shape": "{ message,...result }",
@@ -2341,7 +2343,7 @@
         "switch_product",
         "get_workspace_info"
       ],
-      "source": "src/tools/workspace.ts:48",
+      "source": "src/tools/workspace.ts:98",
       "symbol": "listLocalProducts",
       "returns": "JSON: `{ products: Array<{ file, title, stage, nodes, edges }> }`.\n`stage` is the CANONICAL UPGProductStage (legacy values like `idea` are\ncoerced to `concept`), or `null` when unset — matching what\n`get_product_context` reports for the same product (UPG-611 / DT-MCP-3).",
       "return_shape": "{ products: Array<{ file, title, stage, nodes, edges }> }",
@@ -2364,7 +2366,7 @@
       "see": [
         "create_cross_product_edge"
       ],
-      "source": "src/tools/workspace.ts:633",
+      "source": "src/tools/workspace.ts:672",
       "symbol": "listPortfolioCrossEdges",
       "returns": "JSON: `{ cross_edges: UPGCrossEdge[], total, portfolio_file? }`.",
       "return_shape": "{ cross_edges: UPGCrossEdge[], total, portfolio_file? }",
@@ -2391,7 +2393,7 @@
         "create_cross_product_edge",
         "get_organization"
       ],
-      "source": "src/tools/workspace.ts:416",
+      "source": "src/tools/workspace.ts:455",
       "symbol": "listPortfolios",
       "returns": "JSON: `{ portfolios: Array<{ id, title, description?,\nparent_portfolio_id?, hierarchy_model?, products? }>, total }`.",
       "return_shape": "{ portfolios: Array<{ id, title, description?, parent_portfolio_id?, hierarchy_model?, products? }>, total }",
@@ -2434,12 +2436,122 @@
         "list_cross_edge_types",
         "init_workspace"
       ],
-      "source": "src/tools/workspace.ts:702",
+      "source": "src/tools/workspace.ts:741",
       "symbol": "migrateCrossEdges",
       "returns": "JSON: `{ migrated, skipped, dry_run, portfolio_file? }`.",
       "return_shape": "{ migrated, skipped, dry_run, portfolio_file? }",
       "atomicity": "non-atomic. Portfolio write + product file save are separate."
     },
+    {
+      "name": "portfolio_digest",
+      "description": "Roll up every product's counts, health, and stage-coverage in one call (the multi-product `get_graph_digest`). The strategic-surface read that otherwise required `switch_product` + `get_graph_digest` per graph. Returns per-product summaries plus a portfolio rollup (totals, products-by-stage). Read-only; never mutates active-product state.",
+      "domain": "workspace",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "scope": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Product IDs (or files) to summarise. Omit to summarise ALL products in the workspace."
+          }
+        }
+      },
+      "throws": [],
+      "examples": [],
+      "warnings": [],
+      "see": [
+        "get_graph_digest",
+        "portfolio_query"
+      ],
+      "source": "src/tools/portfolio-read.ts:243",
+      "symbol": "portfolioDigest",
+      "returns": "JSON: `{ products: Array<{ product_id, file, title, stage,\ntotal_nodes, total_edges, health, coverage_pct, top_types }>, rollup:\n{ products, total_nodes, total_edges, by_stage }, errored_products?,\nunmatched_scope? }`. `health`/`coverage_pct` come from `computeGraphDigest`,\nidentical to what `get_graph_digest` reports per product.",
+      "return_shape": "{ products: Array<{ product_id, file, title, stage, total_nodes, total_edges, health, coverage_pct, top_types }>, rollup: { products, total_nodes, total_edges, by_stage }, errored_products?, unmatched_scope? }",
+      "return_notes": [
+        "`health`/`coverage_pct` come from `computeGraphDigest`, identical to what `get_graph_digest` reports per product."
+      ],
+      "atomicity": "atomic (read-only). Never mutates active-product state."
+    },
+    {
+      "name": "portfolio_query",
+      "description": "Traverse the graph ACROSS products in one call (the multi-product `query`). Runs the same BFS (typed-edge traversal + field projection) against every product in scope and tags each subgraph with its source `product_id`, without `switch_product` (the active product is read live; others are read-only). Use for portfolio-level questions (\"every product's strategy region\", \"which products have a persona\"). `from_id` only matches in its owning product. Read-only.",
+      "domain": "workspace",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "from": {
+            "type": "string",
+            "description": "Start from all nodes of this type (in each product)"
+          },
+          "from_id": {
+            "type": "string",
+            "description": "Start from a specific node ID. Node IDs are product-local; only the owning product returns results."
+          },
+          "traverse": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Edge types to follow at each level (in order). If omitted, follows all edges. Prefix with ! to exclude."
+          },
+          "depth": {
+            "type": "number",
+            "description": "Max traversal depth (default 3, max 10)"
+          },
+          "include": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Fields per node: \"title\", \"status\", \"tags\", \"description\", \"properties\" (default: title, status, type)"
+          },
+          "limit": {
+            "type": "number",
+            "description": "Max nodes per product (default 100, max 1000)"
+          },
+          "edge_include": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Edge fields to return: \"id\", \"type\", \"source\", \"target\". Empty array = no edges. Default: all fields."
+          },
+          "property_include": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "When \"properties\" is in include, only return these property keys."
+          },
+          "scope": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Product IDs (or files) to query. Omit to query ALL products in the workspace. Match by product id, relative file, or basename."
+          }
+        }
+      },
+      "throws": [],
+      "examples": [],
+      "warnings": [],
+      "see": [
+        "query",
+        "portfolio_digest",
+        "list_local_products"
+      ],
+      "source": "src/tools/portfolio-read.ts:119",
+      "symbol": "portfolioQuery",
+      "returns": "JSON: `{ products: Array<{ product_id, file, title, total_nodes,\ntotal_edges, nodes, edges, truncated? }>, products_searched,\nproducts_with_matches, empty_products, unmatched_scope? }`. Products that\nmatched zero nodes are summarised in `empty_products`, not expanded, to\nkeep the payload lean. `from_id` only matches in its owning product; the\nrest report empty.",
+      "return_shape": "{ products: Array<{ product_id, file, title, total_nodes, total_edges, nodes, edges, truncated? }>, products_searched, products_with_matches, empty_products, unmatched_scope? }",
+      "return_notes": [
+        "Products that matched zero nodes are summarised in `empty_products`, not expanded, to keep the payload lean.",
+        "`from_id` only matches in its owning product; the rest report empty."
+      ],
+      "atomicity": "atomic (read-only). Never mutates active-product state."
+    },
     {
       "name": "switch_product",
       "description": "Switch to a different .upg file without restarting the server. In workspace mode, accepts just a filename (e.g. \"client-project\" or \"client-project.upg\").",
@@ -2472,7 +2584,7 @@
         "list_local_products",
         "init_workspace"
       ],
-      "source": "src/tools/workspace.ts:160",
+      "source": "src/tools/workspace.ts:190",
       "symbol": "switchProduct",
       "returns": "JSON: `{ message, file, product: { title, stage }, entities }`.",
       "return_shape": "{ message, file, product: { title, stage }, entities }",
@@ -2515,7 +2627,7 @@
       "see": [
         "create_product"
       ],
-      "source": "src/tools/workspace.ts:376",
+      "source": "src/tools/workspace.ts:415",
       "symbol": "updateProductTool",
       "returns": "JSON: `{ product, updated: string[] }` (the fields changed).",
       "return_shape": "{ product, updated: string[] }",
@@ -3464,7 +3576,7 @@
     },
     {
       "name": "list_cross_edge_types",
-      "description": "List the canonical cross-product edge types from `UPG_CROSS_EDGE_TYPES`: `shares_persona`, `shares_competitor`, `shares_metric`, `depends_on_product`, `cannibalises`, `succeeds`, `hosts`. Portfolio-level relationships across products. Distinct from the within-product `UPG_EDGE_CATALOG`.",
+      "description": "List the canonical cross-product edge types from `UPG_CROSS_EDGE_TYPES`: `shares_persona`, `shares_competitor`, `shares_metric`, `depends_on_product`, `cannibalises`, `succeeds`, `hosts`, `contributes_to`. Portfolio-level relationships across products. Distinct from the within-product `UPG_EDGE_CATALOG`.",
       "domain": "spec",
       "inputSchema": {
         "type": "object",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unified-product-graph/mcp-server",
-  "version": "0.8.16",
+  "version": "0.9.1",
   "description": "Local MCP server for .upg files. Read and write product knowledge graphs offline.",
   "license": "MIT",
   "author": "The Product Creator <hello@theproductcreator.com>",
@@ -52,8 +52,8 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.27.0",
-    "@unified-product-graph/core": "0.8.16",
-    "@unified-product-graph/sdk": "0.8.16",
+    "@unified-product-graph/core": "0.9.1",
+    "@unified-product-graph/sdk": "0.9.1",
     "chokidar": "^4.0.0",
     "nanoid": "^5.1.0"
   },