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

package/dist/tools-manifest.json

@@ -1,8 +1,8 @@
 {
   "schema_version": "2",
   "package": "@unified-product-graph/mcp-server",
-  "package_version": "0.8.15",
-  "tool_count": 99,
+  "package_version": "0.8.16",
+  "tool_count": 106,
   "domains": [
     "context",
     "nodes",
@@ -1553,7 +1553,7 @@
         "attach_product_to_portfolio",
         "create_product"
       ],
-      "source": "src/tools/areas.ts:67",
+      "source": "src/tools/areas.ts:71",
       "symbol": "assignProductToAreaTool",
       "returns": "JSON: `{ product_id, container_id, container_kind: \"product_area\",\ncontainer_title?, already_member, registered }`.",
       "return_shape": "{ product_id, container_id, container_kind: \"product_area\", container_title?, already_member, registered }",
@@ -1612,7 +1612,7 @@
       "see": [
         "list_product_areas"
       ],
-      "source": "src/tools/areas.ts:290",
+      "source": "src/tools/areas.ts:294",
       "symbol": "createArea",
       "returns": "JSON: `{ node, portfolio_file, written_to }`. `node` is the typed\n`UPGProductArea` record persisted to `portfolio_areas[]`.",
       "return_shape": "{ node, portfolio_file, written_to }",
@@ -1621,6 +1621,41 @@
       ],
       "atomicity": "atomic per write; the portfolio file is read, mutated, and\nflushed in one pass."
     },
+    {
+      "name": "delete_area",
+      "description": "Delete a product area from `.upg/portfolio.upg`. Guarded: refuses while the area still has products unless `force: true`. Child areas are un-nested (their parent link is cleared) so no parent reference dangles.",
+      "domain": "areas",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "area_id": {
+            "type": "string",
+            "description": "Product area id to delete (from list_product_areas)"
+          },
+          "force": {
+            "type": "boolean",
+            "description": "Delete even if the area still has products (default false)"
+          }
+        },
+        "required": [
+          "area_id"
+        ]
+      },
+      "throws": [
+        "textError on a missing workspace, unknown area, or a non-empty area without\n`force`."
+      ],
+      "examples": [],
+      "warnings": [],
+      "see": [
+        "create_area",
+        "remove_product_from_area"
+      ],
+      "source": "src/tools/areas.ts:441",
+      "symbol": "deleteAreaTool",
+      "returns": "JSON: `{ message, area_id, deleted, unnested_children: string[] }`.",
+      "return_shape": "{ message, area_id, deleted, unnested_children: string[] }",
+      "atomicity": "atomic (single portfolio.upg flush)."
+    },
     {
       "name": "get_area_context",
       "description": "Check whether the current working directory has a `.upg-area.json` that scopes work to a specific product area.",
@@ -1639,7 +1674,7 @@
       ],
       "warnings": [],
       "see": [],
-      "source": "src/tools/areas.ts:240",
+      "source": "src/tools/areas.ts:244",
       "symbol": "getAreaContext",
       "returns": "JSON: `{ has_area_context: false }` or\n`{ has_area_context: true, area_id, area_name, found_at }`.",
       "return_shape": "{ has_area_context: false }",
@@ -1679,7 +1714,7 @@
       "see": [
         "list_product_areas"
       ],
-      "source": "src/tools/areas.ts:98",
+      "source": "src/tools/areas.ts:102",
       "symbol": "getAreaGraph",
       "returns": "JSON: `{ area, nodes, edges, node_count, edge_count }`. May\ninclude a `degraded` block when the response was auto-trimmed.",
       "return_shape": "{ area, nodes, edges, node_count, edge_count }",
@@ -1711,7 +1746,7 @@
       ],
       "warnings": [],
       "see": [],
-      "source": "src/tools/areas.ts:329",
+      "source": "src/tools/areas.ts:333",
       "symbol": "getChanges",
       "returns": "JSON: `{ changes, summary: { create, update, delete }, total }`.\n`since` filters to ISO 8601 timestamps after the cutoff.",
       "return_shape": "{ changes, summary: { create, update, delete }, total }",
@@ -1741,12 +1776,152 @@
         "create_area",
         "get_area_graph"
       ],
-      "source": "src/tools/areas.ts:34",
+      "source": "src/tools/areas.ts:38",
       "symbol": "listProductAreas",
       "returns": "JSON: `{ areas: Array<{ id, title, strategic_priority?,\nparent_area_id?, products? }>, total }`.",
       "return_shape": "{ areas: Array<{ id, title, strategic_priority?, parent_area_id?, products? }>, total }",
       "atomicity": "atomic (read-only)"
     },
+    {
+      "name": "move_product_to_area",
+      "description": "Move a product to a different product area: remove it from `from_area_id` (or, when omitted, from every area it currently sits in) and add it to `to_area_id`. Convenience over remove_product_from_area + assign_product_to_area.",
+      "domain": "areas",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "product_id": {
+            "type": "string",
+            "description": "Product id (from list_local_products)"
+          },
+          "to_area_id": {
+            "type": "string",
+            "description": "Destination product area id (from list_product_areas)"
+          },
+          "from_area_id": {
+            "type": "string",
+            "description": "Source area id to remove from; omit to remove from all areas"
+          }
+        },
+        "required": [
+          "product_id",
+          "to_area_id"
+        ]
+      },
+      "throws": [
+        "textError on a missing workspace, unknown product, or unknown target area."
+      ],
+      "examples": [],
+      "warnings": [],
+      "see": [
+        "assign_product_to_area",
+        "remove_product_from_area"
+      ],
+      "source": "src/tools/areas.ts:464",
+      "symbol": "moveProductToAreaTool",
+      "returns": "JSON: `{ product_id, to_area_id, to_area_title?, removed_from: string[], added }`.",
+      "return_shape": "{ product_id, to_area_id, to_area_title?, removed_from: string[], added }",
+      "atomicity": "atomic (single portfolio.upg flush)."
+    },
+    {
+      "name": "remove_product_from_area",
+      "description": "Remove a product from a product area's `products[]` in `.upg/portfolio.upg` (the product stays registered on the portfolio and in any other container). The inverse of `assign_product_to_area`.",
+      "domain": "areas",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "product_id": {
+            "type": "string",
+            "description": "Product id (from list_local_products)"
+          },
+          "area_id": {
+            "type": "string",
+            "description": "Product area id (from list_product_areas)"
+          }
+        },
+        "required": [
+          "product_id",
+          "area_id"
+        ]
+      },
+      "throws": [
+        "textError on a missing workspace or an unknown area id."
+      ],
+      "examples": [],
+      "warnings": [],
+      "see": [
+        "assign_product_to_area",
+        "move_product_to_area"
+      ],
+      "source": "src/tools/areas.ts:414",
+      "symbol": "removeProductFromAreaTool",
+      "returns": "JSON: `{ product_id, container_id, container_kind: \"product_area\",\ncontainer_title?, removed }`. `removed: false` (not an error) when the product\nwas not a member, so retries are idempotent.",
+      "return_shape": "{ product_id, container_id, container_kind: \"product_area\", container_title?, removed }",
+      "return_notes": [
+        "`removed: false` (not an error) when the product was not a member, so retries are idempotent."
+      ],
+      "atomicity": "atomic (single portfolio.upg flush)."
+    },
+    {
+      "name": "update_area",
+      "description": "Edit a product area in `.upg/portfolio.upg` (title, description, strategic_priority, owner) and/or re-parent it via `parent_area_id`. The mirror of `update_product` for the organisational axis. `parent_area_id` is tri-state: omit to leave unchanged, pass null to un-nest (top-level), or pass an area id to re-parent (rejected if it would create a cycle).",
+      "domain": "areas",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "area_id": {
+            "type": "string",
+            "description": "Product area id to edit (from list_product_areas)"
+          },
+          "title": {
+            "type": "string",
+            "description": "New area title"
+          },
+          "description": {
+            "type": "string",
+            "description": "New area description"
+          },
+          "strategic_priority": {
+            "type": "string",
+            "enum": [
+              "urgent",
+              "high",
+              "medium",
+              "low",
+              "none"
+            ],
+            "description": "Strategic priority (canonical Priority scale)"
+          },
+          "parent_area_id": {
+            "type": [
+              "string",
+              "null"
+            ],
+            "description": "Re-parent under this area id; null un-nests (top-level); omit to leave unchanged"
+          },
+          "owner": {
+            "type": "string",
+            "description": "Person or team that owns this area"
+          }
+        },
+        "required": [
+          "area_id"
+        ]
+      },
+      "throws": [
+        "textError on a missing workspace, unknown area/parent, a re-parent cycle, or\nwhen no editable field is supplied."
+      ],
+      "examples": [],
+      "warnings": [],
+      "see": [
+        "create_area",
+        "list_product_areas"
+      ],
+      "source": "src/tools/areas.ts:367",
+      "symbol": "updateAreaTool",
+      "returns": "JSON: `{ message, area, updated: string[] }`.",
+      "return_shape": "{ message, area, updated: string[] }",
+      "atomicity": "atomic (single portfolio.upg flush)."
+    },
     {
       "name": "attach_product_to_portfolio",
       "description": "Place an existing product under a portfolio (adds it to the portfolio's `products[]` in `.upg/portfolio.upg`). Resolves the portfolio against the portfolio document and auto-registers the product on the portfolio registry. Use after `create_product`, or pass `portfolio_id` to `create_product` directly.",
@@ -1777,15 +1952,89 @@
         "assign_product_to_area",
         "create_product"
       ],
-      "source": "src/tools/workspace.ts:737",
+      "source": "src/tools/workspace.ts:777",
       "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 }",
       "atomicity": "atomic (single portfolio.upg flush)."
     },
+    {
+      "name": "batch_create_cross_product_edges",
+      "description": "Create up to 50 cross-product edges in one atomic write (the portfolio-tier mirror of batch_create_edges). Every edge is validated and qualified before anything is written; if any is invalid the whole batch is rejected. Referenced products are auto-registered.",
+      "domain": "workspace",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "edges": {
+            "type": "array",
+            "description": "Cross-product edges to create (max 50). Each: { source_id, target_id, type, source_product_id?, target_product_id? }.",
+            "items": {
+              "type": "object",
+              "properties": {
+                "source_id": {
+                  "type": "string",
+                  "description": "Source node ID (bare or qualified {product_id}/{node_id})"
+                },
+                "target_id": {
+                  "type": "string",
+                  "description": "Target node ID (bare or qualified {product_id}/{node_id})"
+                },
+                "type": {
+                  "type": "string",
+                  "enum": [
+                    "shares_persona",
+                    "shares_competitor",
+                    "shares_metric",
+                    "depends_on_product",
+                    "cannibalises",
+                    "succeeds",
+                    "hosts"
+                  ],
+                  "description": "Cross-product relationship type"
+                },
+                "source_product_id": {
+                  "type": "string",
+                  "description": "Product ID of the source node (qualifies a bare source_id)"
+                },
+                "target_product_id": {
+                  "type": "string",
+                  "description": "Product ID of the target node (qualifies a bare target_id)"
+                }
+              },
+              "required": [
+                "source_id",
+                "target_id",
+                "type"
+              ]
+            }
+          },
+          "auto_create_portfolio": {
+            "type": "boolean",
+            "description": "Create an empty portfolio document if none exists (default false)"
+          }
+        },
+        "required": [
+          "edges"
+        ]
+      },
+      "throws": [
+        "textError when `edges` is missing/empty/oversized, when any edge is invalid,\nor when no portfolio document exists (pass `auto_create_portfolio: true` to mint one)."
+      ],
+      "examples": [],
+      "warnings": [],
+      "see": [
+        "create_cross_product_edge",
+        "list_cross_edge_types"
+      ],
+      "source": "src/tools/workspace.ts:860",
+      "symbol": "batchCreateCrossProductEdges",
+      "returns": "JSON: `{ message, created: UPGCrossEdge[], count, portfolio_file,\nregistered_products? }`.",
+      "return_shape": "{ message, created: UPGCrossEdge[], count, portfolio_file, registered_products? }",
+      "atomicity": "atomic. All edges validated first, then a single portfolio.upg flush."
+    },
     {
       "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`.",
+      "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).",
       "domain": "workspace",
       "inputSchema": {
         "type": "object",
@@ -1806,7 +2055,8 @@
               "shares_metric",
               "depends_on_product",
               "cannibalises",
-              "succeeds"
+              "succeeds",
+              "hosts"
             ],
             "description": "Cross-product relationship type"
           },
@@ -1835,7 +2085,7 @@
         "list_portfolio_cross_edges",
         "migrate_cross_edges"
       ],
-      "source": "src/tools/workspace.ts:454",
+      "source": "src/tools/workspace.ts:494",
       "symbol": "createCrossProductEdge",
       "returns": "JSON: `{ edge, portfolio_file }`.",
       "return_shape": "{ edge, portfolio_file }",
@@ -1891,7 +2141,7 @@
       "see": [
         "init_workspace"
       ],
-      "source": "src/tools/workspace.ts:295",
+      "source": "src/tools/workspace.ts:335",
       "symbol": "createProductTool",
       "returns": "JSON: `{ message, ...result }`. `result` carries `id`, `title`,\n`slug`, `file_path`, and the optional portfolio edge.",
       "return_shape": "{ message,...result }",
@@ -1900,6 +2150,78 @@
       ],
       "atomicity": "non-atomic. File write + workspace.json patch + optional\nportfolio edge are separate mutations."
     },
+    {
+      "name": "delete_cross_product_edge",
+      "description": "Delete a cross-product edge from `.upg/portfolio.upg` by id. The inverse of `create_cross_product_edge`. Returns `deleted: false` (not an error) when no edge with that id exists.",
+      "domain": "workspace",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "edge_id": {
+            "type": "string",
+            "description": "Cross-product edge id (from list_portfolio_cross_edges)"
+          }
+        },
+        "required": [
+          "edge_id"
+        ]
+      },
+      "throws": [
+        "textError on a missing workspace."
+      ],
+      "examples": [],
+      "warnings": [],
+      "see": [
+        "create_cross_product_edge",
+        "list_portfolio_cross_edges"
+      ],
+      "source": "src/tools/workspace.ts:831",
+      "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? }",
+      "return_notes": [
+        "`deleted: false` (not an error) when no edge with that id exists, so retries are idempotent."
+      ],
+      "atomicity": "atomic (single portfolio.upg flush)."
+    },
+    {
+      "name": "detach_product_from_portfolio",
+      "description": "Remove a product from a portfolio's `products[]` in `.upg/portfolio.upg` (the product stays registered and in any other container). The inverse of `attach_product_to_portfolio`.",
+      "domain": "workspace",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "product_id": {
+            "type": "string",
+            "description": "Product id (from list_local_products)"
+          },
+          "portfolio_id": {
+            "type": "string",
+            "description": "Portfolio id (from list_portfolios)"
+          }
+        },
+        "required": [
+          "product_id",
+          "portfolio_id"
+        ]
+      },
+      "throws": [
+        "textError on a missing workspace or an unknown portfolio id."
+      ],
+      "examples": [],
+      "warnings": [],
+      "see": [
+        "attach_product_to_portfolio"
+      ],
+      "source": "src/tools/workspace.ts:804",
+      "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 }",
+      "return_notes": [
+        "`removed: false` (not an error) when the product was not a member, so retries are idempotent."
+      ],
+      "atomicity": "atomic (single portfolio.upg flush)."
+    },
     {
       "name": "get_organization",
       "description": "Get the organisation that owns the current workspace's portfolio. Reads the singleton `portfolio.upg.organization`. Returns `{ organization: null }` when no portfolio document exists yet.",
@@ -1920,7 +2242,7 @@
       "see": [
         "list_portfolios"
       ],
-      "source": "src/tools/workspace.ts:403",
+      "source": "src/tools/workspace.ts:443",
       "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? }",
@@ -1949,7 +2271,7 @@
       "see": [
         "init_workspace"
       ],
-      "source": "src/tools/workspace.ts:183",
+      "source": "src/tools/workspace.ts:223",
       "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 }",
@@ -1989,7 +2311,7 @@
         "switch_product",
         "get_workspace_info"
       ],
-      "source": "src/tools/workspace.ts:259",
+      "source": "src/tools/workspace.ts:299",
       "symbol": "initWorkspaceTool",
       "returns": "JSON: `{ message, ...result }`. `result` carries the workspace\npath and the moved file's new location.",
       "return_shape": "{ message,...result }",
@@ -2019,7 +2341,7 @@
         "switch_product",
         "get_workspace_info"
       ],
-      "source": "src/tools/workspace.ts:46",
+      "source": "src/tools/workspace.ts:48",
       "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 }> }",
@@ -2042,7 +2364,7 @@
       "see": [
         "create_cross_product_edge"
       ],
-      "source": "src/tools/workspace.ts:593",
+      "source": "src/tools/workspace.ts:633",
       "symbol": "listPortfolioCrossEdges",
       "returns": "JSON: `{ cross_edges: UPGCrossEdge[], total, portfolio_file? }`.",
       "return_shape": "{ cross_edges: UPGCrossEdge[], total, portfolio_file? }",
@@ -2069,7 +2391,7 @@
         "create_cross_product_edge",
         "get_organization"
       ],
-      "source": "src/tools/workspace.ts:376",
+      "source": "src/tools/workspace.ts:416",
       "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 }",
@@ -2112,7 +2434,7 @@
         "list_cross_edge_types",
         "init_workspace"
       ],
-      "source": "src/tools/workspace.ts:662",
+      "source": "src/tools/workspace.ts:702",
       "symbol": "migrateCrossEdges",
       "returns": "JSON: `{ migrated, skipped, dry_run, portfolio_file? }`.",
       "return_shape": "{ migrated, skipped, dry_run, portfolio_file? }",
@@ -2150,7 +2472,7 @@
         "list_local_products",
         "init_workspace"
       ],
-      "source": "src/tools/workspace.ts:120",
+      "source": "src/tools/workspace.ts:160",
       "symbol": "switchProduct",
       "returns": "JSON: `{ message, file, product: { title, stage }, entities }`.",
       "return_shape": "{ message, file, product: { title, stage }, entities }",
@@ -2193,7 +2515,7 @@
       "see": [
         "create_product"
       ],
-      "source": "src/tools/workspace.ts:336",
+      "source": "src/tools/workspace.ts:376",
       "symbol": "updateProductTool",
       "returns": "JSON: `{ product, updated: string[] }` (the fields changed).",
       "return_shape": "{ product, updated: string[] }",
@@ -3142,7 +3464,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`. 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`. 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.15",
+  "version": "0.8.16",
   "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.15",
-    "@unified-product-graph/sdk": "0.8.15",
+    "@unified-product-graph/core": "0.8.16",
+    "@unified-product-graph/sdk": "0.8.16",
     "chokidar": "^4.0.0",
     "nanoid": "^5.1.0"
   },