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

package/dist/tools-manifest.json

@@ -1,8 +1,8 @@
 {
   "schema_version": "2",
   "package": "@unified-product-graph/mcp-server",
-  "package_version": "0.8.14",
-  "tool_count": 96,
+  "package_version": "0.8.15",
+  "tool_count": 99,
   "domains": [
     "context",
     "nodes",
@@ -1523,6 +1523,42 @@
       ],
       "atomicity": "atomic-with-rollback. Classification runs against the live\ndocument before any mutation; with `dry_run: false`, the drop set is\ncomputed up-front and applied in a single index rebuild."
     },
+    {
+      "name": "assign_product_to_area",
+      "description": "Place an existing product under a product area (adds it to the area's `products[]` in `.upg/portfolio.upg`). Resolves the area against the portfolio document and auto-registers the product on the portfolio registry. Use after `create_product`, or pass `area_id` to `create_product` directly.",
+      "domain": "areas",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "product_id": {
+            "type": "string",
+            "description": "Product id (from create_product / 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, an unknown product, or an unknown\narea id (the message points at list_product_areas / list_local_products)."
+      ],
+      "examples": [],
+      "warnings": [],
+      "see": [
+        "attach_product_to_portfolio",
+        "create_product"
+      ],
+      "source": "src/tools/areas.ts:67",
+      "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 }",
+      "atomicity": "atomic (single portfolio.upg flush)."
+    },
     {
       "name": "create_area",
       "description": "Create a product area entity in the portfolio document (`.upg/portfolio.upg`). Product areas represent the organisational axis (who owns what). Supports nesting via `parent_area_id`. The portfolio document is created on demand.",
@@ -1545,12 +1581,13 @@
           "strategic_priority": {
             "type": "string",
             "enum": [
-              "critical",
+              "urgent",
               "high",
               "medium",
-              "low"
+              "low",
+              "none"
             ],
-            "description": "Strategic priority of this area"
+            "description": "Strategic priority of this area (canonical Priority scale)"
           },
           "owner": {
             "type": "string",
@@ -1575,7 +1612,7 @@
       "see": [
         "list_product_areas"
       ],
-      "source": "src/tools/areas.ts:261",
+      "source": "src/tools/areas.ts:290",
       "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 }",
@@ -1602,7 +1639,7 @@
       ],
       "warnings": [],
       "see": [],
-      "source": "src/tools/areas.ts:211",
+      "source": "src/tools/areas.ts:240",
       "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 }",
@@ -1642,7 +1679,7 @@
       "see": [
         "list_product_areas"
       ],
-      "source": "src/tools/areas.ts:69",
+      "source": "src/tools/areas.ts:98",
       "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 }",
@@ -1674,7 +1711,7 @@
       ],
       "warnings": [],
       "see": [],
-      "source": "src/tools/areas.ts:300",
+      "source": "src/tools/areas.ts:329",
       "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 }",
@@ -1704,12 +1741,48 @@
         "create_area",
         "get_area_graph"
       ],
-      "source": "src/tools/areas.ts:33",
+      "source": "src/tools/areas.ts:34",
       "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": "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.",
+      "domain": "workspace",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "product_id": {
+            "type": "string",
+            "description": "Product id (from create_product / list_local_products)"
+          },
+          "portfolio_id": {
+            "type": "string",
+            "description": "Portfolio id (from list_portfolios)"
+          }
+        },
+        "required": [
+          "product_id",
+          "portfolio_id"
+        ]
+      },
+      "throws": [
+        "textError on a missing workspace, an unknown product, or an unknown\nportfolio id (the message points at list_portfolios / list_local_products)."
+      ],
+      "examples": [],
+      "warnings": [],
+      "see": [
+        "assign_product_to_area",
+        "create_product"
+      ],
+      "source": "src/tools/workspace.ts:737",
+      "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": "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`.",
@@ -1762,7 +1835,7 @@
         "list_portfolio_cross_edges",
         "migrate_cross_edges"
       ],
-      "source": "src/tools/workspace.ts:413",
+      "source": "src/tools/workspace.ts:454",
       "symbol": "createCrossProductEdge",
       "returns": "JSON: `{ edge, portfolio_file }`.",
       "return_shape": "{ edge, portfolio_file }",
@@ -1793,7 +1866,11 @@
           },
           "portfolio_id": {
             "type": "string",
-            "description": "Optional portfolio node id in the current store. When provided, a `portfolio_contains_product` edge is created in the current graph."
+            "description": "Optional portfolio id (resolved against portfolio.upg) to place the new product under. A portfolio id that resolves only in the active graph still attaches via an in-graph edge (DEPRECATED; prefer attach_product_to_portfolio)."
+          },
+          "area_id": {
+            "type": "string",
+            "description": "Optional product_area id (resolved against portfolio.upg) to place the new product under."
           }
         },
         "required": [
@@ -1814,7 +1891,7 @@
       "see": [
         "init_workspace"
       ],
-      "source": "src/tools/workspace.ts:293",
+      "source": "src/tools/workspace.ts:295",
       "symbol": "createProductTool",
       "returns": "JSON: `{ message, ...result }`. `result` carries `id`, `title`,\n`slug`, `file_path`, and the optional portfolio edge.",
       "return_shape": "{ message,...result }",
@@ -1843,7 +1920,7 @@
       "see": [
         "list_portfolios"
       ],
-      "source": "src/tools/workspace.ts:362",
+      "source": "src/tools/workspace.ts:403",
       "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? }",
@@ -1872,7 +1949,7 @@
       "see": [
         "init_workspace"
       ],
-      "source": "src/tools/workspace.ts:181",
+      "source": "src/tools/workspace.ts:183",
       "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 }",
@@ -1912,7 +1989,7 @@
         "switch_product",
         "get_workspace_info"
       ],
-      "source": "src/tools/workspace.ts:257",
+      "source": "src/tools/workspace.ts:259",
       "symbol": "initWorkspaceTool",
       "returns": "JSON: `{ message, ...result }`. `result` carries the workspace\npath and the moved file's new location.",
       "return_shape": "{ message,...result }",
@@ -1942,7 +2019,7 @@
         "switch_product",
         "get_workspace_info"
       ],
-      "source": "src/tools/workspace.ts:44",
+      "source": "src/tools/workspace.ts:46",
       "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 }> }",
@@ -1965,7 +2042,7 @@
       "see": [
         "create_cross_product_edge"
       ],
-      "source": "src/tools/workspace.ts:552",
+      "source": "src/tools/workspace.ts:593",
       "symbol": "listPortfolioCrossEdges",
       "returns": "JSON: `{ cross_edges: UPGCrossEdge[], total, portfolio_file? }`.",
       "return_shape": "{ cross_edges: UPGCrossEdge[], total, portfolio_file? }",
@@ -1992,7 +2069,7 @@
         "create_cross_product_edge",
         "get_organization"
       ],
-      "source": "src/tools/workspace.ts:335",
+      "source": "src/tools/workspace.ts:376",
       "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 }",
@@ -2035,7 +2112,7 @@
         "list_cross_edge_types",
         "init_workspace"
       ],
-      "source": "src/tools/workspace.ts:621",
+      "source": "src/tools/workspace.ts:662",
       "symbol": "migrateCrossEdges",
       "returns": "JSON: `{ migrated, skipped, dry_run, portfolio_file? }`.",
       "return_shape": "{ migrated, skipped, dry_run, portfolio_file? }",
@@ -2073,12 +2150,58 @@
         "list_local_products",
         "init_workspace"
       ],
-      "source": "src/tools/workspace.ts:118",
+      "source": "src/tools/workspace.ts:120",
       "symbol": "switchProduct",
       "returns": "JSON: `{ message, file, product: { title, stage }, entities }`.",
       "return_shape": "{ message, file, product: { title, stage }, entities }",
       "atomicity": "non-atomic. Flushes the current store, stops watching, and\nloads the new file as separate filesystem operations."
     },
+    {
+      "name": "update_product",
+      "description": "Update the product header (`$upg.product`): stage, title, description, health_status, url. The supported way to advance a product's lifecycle stage; it writes the value get_graph_digest reads, without hand-editing the .upg file.",
+      "domain": "workspace",
+      "inputSchema": {
+        "type": "object",
+        "properties": {
+          "stage": {
+            "type": "string",
+            "description": "Product lifecycle stage (canonical UPGProductStage)."
+          },
+          "title": {
+            "type": "string",
+            "description": "Product display title."
+          },
+          "description": {
+            "type": "string",
+            "description": "Product description."
+          },
+          "health_status": {
+            "type": "string",
+            "description": "Product health (free-form, e.g. on_track / at_risk)."
+          },
+          "url": {
+            "type": "string",
+            "description": "Product URL."
+          }
+        }
+      },
+      "throws": [
+        "textError when no field is supplied, when there is no product header,\nor when `stage` is non-canonical (same strict validation as create_product)."
+      ],
+      "examples": [],
+      "warnings": [],
+      "see": [
+        "create_product"
+      ],
+      "source": "src/tools/workspace.ts:336",
+      "symbol": "updateProductTool",
+      "returns": "JSON: `{ product, updated: string[] }` (the fields changed).",
+      "return_shape": "{ product, updated: string[] }",
+      "return_notes": [
+        "(the fields changed)."
+      ],
+      "atomicity": "atomic (single flush)."
+    },
     {
       "name": "get_entity_schema",
       "description": "Return expected properties, valid statuses, valid edge types, and domain for an entity type. Lets agents construct valid entities without skill prompts.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unified-product-graph/mcp-server",
-  "version": "0.8.14",
+  "version": "0.8.15",
   "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.14",
-    "@unified-product-graph/sdk": "0.8.14",
+    "@unified-product-graph/core": "0.8.15",
+    "@unified-product-graph/sdk": "0.8.15",
     "chokidar": "^4.0.0",
     "nanoid": "^5.1.0"
   },