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

package/dist/index.js

@@ -2733,7 +2733,8 @@ var UPG_CROSS_EDGE_TYPES = [
   "shares_metric",
   "depends_on_product",
   "cannibalises",
-  "succeeds"
+  "succeeds",
+  "hosts"
 ];
 var TYPES = getTypes();
 var TYPES_SET = new Set(TYPES);
@@ -24372,7 +24373,7 @@ function serializePortfolioWithHeader(doc, opts) {
   header.integrity = { algorithm: INTEGRITY_ALGORITHM, body: computeBodyChecksum(doc) };
   return JSON.stringify({ $upg: header, ...body }, null, 2) + "\n";
 }
-var UPG_VERSION = "0.8.15";
+var UPG_VERSION = "0.8.16";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();
 var UPG_TYPES_SET = new Set(UPG_TYPES);
@@ -26257,6 +26258,10 @@ import {
   writePortfolioScopedNode as writePortfolioScopedNode2,
   openPortfolioStoreIfExists,
   assignProductToArea,
+  updateProductArea,
+  removeProductFromArea,
+  deleteArea,
+  moveProductToArea,
   PortfolioRoutingError as PortfolioRoutingError2
 } from "@unified-product-graph/sdk";
 var listProductAreas = async (_args, _ctx) => {
@@ -26479,6 +26484,73 @@ var getChanges = (args, ctx) => {
     )
   );
 };
+var updateAreaTool = async (args, _ctx) => {
+  const areaId = args.area_id;
+  if (!areaId) return textError("Missing required parameter: area_id");
+  const hasField = args.title !== void 0 || args.description !== void 0 || args.strategic_priority !== void 0 || args.owner !== void 0 || "parent_area_id" in args;
+  if (!hasField) {
+    return textError(
+      "Nothing to update: pass at least one of: title, description, strategic_priority, owner, parent_area_id."
+    );
+  }
+  try {
+    const result = await updateProductArea(process.cwd(), areaId, {
+      title: args.title,
+      description: args.description,
+      strategic_priority: args.strategic_priority,
+      owner: args.owner,
+      // Tri-state: present (incl. null) re-parents/un-nests; absent leaves unchanged.
+      ..."parent_area_id" in args ? { parent_area_id: args.parent_area_id ?? null } : {}
+    });
+    return text(
+      JSON.stringify({ message: `Updated area (${result.updated.join(", ")})`, ...result }, null, 2)
+    );
+  } catch (err) {
+    if (err instanceof PortfolioRoutingError2) return textError(err.message);
+    return textError(err.message);
+  }
+};
+var removeProductFromAreaTool = async (args, _ctx) => {
+  const productId = args.product_id;
+  const areaId = args.area_id;
+  if (!productId) return textError("Missing required parameter: product_id");
+  if (!areaId) return textError("Missing required parameter: area_id");
+  try {
+    const result = await removeProductFromArea(process.cwd(), { product_id: productId, area_id: areaId });
+    return text(JSON.stringify(result, null, 2));
+  } catch (err) {
+    if (err instanceof PortfolioRoutingError2) return textError(err.message);
+    return textError(err.message);
+  }
+};
+var deleteAreaTool = async (args, _ctx) => {
+  const areaId = args.area_id;
+  if (!areaId) return textError("Missing required parameter: area_id");
+  try {
+    const result = await deleteArea(process.cwd(), areaId, { force: args.force });
+    return text(JSON.stringify({ message: `Deleted area ${areaId}`, ...result }, null, 2));
+  } catch (err) {
+    if (err instanceof PortfolioRoutingError2) return textError(err.message);
+    return textError(err.message);
+  }
+};
+var moveProductToAreaTool = async (args, _ctx) => {
+  const productId = args.product_id;
+  const toAreaId = args.to_area_id;
+  if (!productId) return textError("Missing required parameter: product_id");
+  if (!toAreaId) return textError("Missing required parameter: to_area_id");
+  try {
+    const result = await moveProductToArea(process.cwd(), {
+      product_id: productId,
+      to_area_id: toAreaId,
+      from_area_id: args.from_area_id
+    });
+    return text(JSON.stringify(result, null, 2));
+  } catch (err) {
+    if (err instanceof PortfolioRoutingError2) return textError(err.message);
+    return textError(err.message);
+  }
+};
 
 // src/tools/workspace.ts
 import * as fs from "fs";
@@ -26491,7 +26563,9 @@ import {
   openPortfolioStoreIfExists as openPortfolioStoreIfExists2,
   registerProductOnPortfolio,
   findProductFileById,
-  attachProductToPortfolio
+  attachProductToPortfolio,
+  detachProductFromPortfolio,
+  deleteCrossProductEdge
 } from "@unified-product-graph/sdk";
 import {
   createProduct,
@@ -26505,6 +26579,25 @@ import {
 var listLocalProducts = (_args, _ctx) => {
   const cwd = process.cwd();
   const products = [];
+  const membership = /* @__PURE__ */ new Map();
+  try {
+    const pdoc = JSON.parse(fs.readFileSync(path3.join(cwd, ".upg", "portfolio.upg"), "utf-8"));
+    for (const area of pdoc.product_areas ?? []) {
+      for (const pid of area.products ?? []) {
+        const m = membership.get(pid) ?? { areas: [], portfolios: [] };
+        m.areas.push(area.title ?? area.id);
+        membership.set(pid, m);
+      }
+    }
+    for (const pf of pdoc.portfolios ?? []) {
+      for (const pid of pf.products ?? []) {
+        const m = membership.get(pid) ?? { areas: [], portfolios: [] };
+        m.portfolios.push(pf.title ?? pf.id);
+        membership.set(pid, m);
+      }
+    }
+  } catch {
+  }
   const candidates = [];
   const topEntries = fs.readdirSync(cwd, { withFileTypes: true });
   for (const entry of topEntries) {
@@ -26529,13 +26622,19 @@ var listLocalProducts = (_args, _ctx) => {
     try {
       const raw = fs.readFileSync(filePath, "utf-8");
       const doc = JSON.parse(raw);
+      if (!doc.product) continue;
       const coerced = coerceProductStage(doc.product?.stage);
+      const pid = doc.product?.id ?? null;
+      const m = pid ? membership.get(pid) : void 0;
       products.push({
+        id: pid,
         file: path3.relative(cwd, filePath),
         title: doc.product?.title ?? "(untitled)",
         stage: coerced.canonical ?? null,
         nodes: Array.isArray(doc.nodes) ? doc.nodes.length : 0,
-        edges: Array.isArray(doc.edges) ? doc.edges.length : 0
+        edges: Array.isArray(doc.edges) ? doc.edges.length : 0,
+        ...m && m.areas.length > 0 ? { areas: m.areas } : {},
+        ...m && m.portfolios.length > 0 ? { portfolios: m.portfolios } : {}
       });
     } catch {
     }
@@ -26926,6 +27025,126 @@ var attachProductToPortfolioTool = async (args, _ctx) => {
     return textError(err.message);
   }
 };
+var detachProductFromPortfolioTool = async (args, _ctx) => {
+  const productId = args.product_id;
+  const portfolioId = args.portfolio_id;
+  if (!productId) return textError("Missing required parameter: product_id");
+  if (!portfolioId) return textError("Missing required parameter: portfolio_id");
+  try {
+    const result = await detachProductFromPortfolio(process.cwd(), {
+      product_id: productId,
+      portfolio_id: portfolioId
+    });
+    return text(JSON.stringify(result, null, 2));
+  } catch (err) {
+    return textError(err.message);
+  }
+};
+var deleteCrossProductEdgeTool = async (args, _ctx) => {
+  const edgeIdArg = args.edge_id;
+  if (!edgeIdArg) return textError("Missing required parameter: edge_id");
+  try {
+    const result = await deleteCrossProductEdge(process.cwd(), edgeIdArg);
+    return text(JSON.stringify(result, null, 2));
+  } catch (err) {
+    return textError(err.message);
+  }
+};
+var batchCreateCrossProductEdges = async (args, _ctx) => {
+  const edgesArg = args.edges;
+  if (!Array.isArray(edgesArg) || edgesArg.length === 0) {
+    return textError("Missing required parameter: edges (a non-empty array).");
+  }
+  if (edgesArg.length > 50) {
+    return textError(`Too many edges: ${edgesArg.length}. Max 50 per batch_create_cross_product_edges call.`);
+  }
+  const cwd = process.cwd();
+  const portfolioPath = resolvePortfolioPath(cwd);
+  if (!portfolioPath) {
+    return textError("No workspace found. Run `init_workspace` first to enable portfolio cross-product edges.");
+  }
+  const autoCreatePortfolio = args.auto_create_portfolio ?? false;
+  const portfolioExisted = fs.existsSync(portfolioPath);
+  if (!portfolioExisted && !autoCreatePortfolio) {
+    return textError(
+      'No portfolio document found at .upg/portfolio.upg. Cross-product edges express portfolio-level relationships and should be anchored to a portfolio that contains the products. Create a portfolio first (`create_node({type: "portfolio", title: "..."})`), or pass `auto_create_portfolio: true`.'
+    );
+  }
+  const prepared = [];
+  for (let i = 0; i < edgesArg.length; i++) {
+    const e = edgesArg[i];
+    const sourceIdArg = e.source_id;
+    const targetIdArg = e.target_id;
+    const edgeTypeArg = e.type;
+    const sourceProductId = e.source_product_id;
+    const targetProductId = e.target_product_id;
+    if (!sourceIdArg) return textError(`edges[${i}]: missing source_id`);
+    if (!targetIdArg) return textError(`edges[${i}]: missing target_id`);
+    if (!edgeTypeArg) return textError(`edges[${i}]: missing type`);
+    if (!UPG_CROSS_EDGE_TYPES.includes(edgeTypeArg)) {
+      return textError(`edges[${i}]: invalid cross-product edge type "${edgeTypeArg}". Valid types: ${UPG_CROSS_EDGE_TYPES.join(", ")}`);
+    }
+    let qualifiedSource;
+    if (sourceIdArg.includes("/")) qualifiedSource = sourceIdArg;
+    else if (sourceProductId) qualifiedSource = `${sourceProductId}/${sourceIdArg}`;
+    else return textError(`edges[${i}]: source_id "${sourceIdArg}" is a bare node id. Supply source_product_id or a qualified {product_id}/{node_id}.`);
+    let qualifiedTarget;
+    if (targetIdArg.includes("/")) qualifiedTarget = targetIdArg;
+    else if (targetProductId) qualifiedTarget = `${targetProductId}/${targetIdArg}`;
+    else return textError(`edges[${i}]: target_id "${targetIdArg}" is a bare node id. Supply target_product_id or a qualified {product_id}/{node_id}.`);
+    prepared.push({
+      id: edgeId3(),
+      source: qualifiedSource,
+      target: qualifiedTarget,
+      type: edgeTypeArg,
+      source_product_id: sourceProductId ?? qualifiedSource.split("/")[0],
+      target_product_id: targetProductId ?? qualifiedTarget.split("/")[0]
+    });
+  }
+  const portfolioStore = new UPGPortfolioStore();
+  try {
+    await portfolioStore.loadOrInit(portfolioPath);
+  } catch (err) {
+    return textError(`Failed to load portfolio document: ${err.message}`);
+  }
+  const registeredProducts = [];
+  const portfolioDoc = portfolioStore.getDocument();
+  if (portfolioDoc) {
+    const productIds = /* @__PURE__ */ new Set();
+    for (const e of prepared) {
+      if (e.source_product_id) productIds.add(e.source_product_id);
+      if (e.target_product_id) productIds.add(e.target_product_id);
+    }
+    for (const pid of productIds) {
+      const lookup = findProductFileById(cwd, pid);
+      const wasNew = registerProductOnPortfolio(portfolioDoc, {
+        id: pid,
+        ...lookup ? { file_path: lookup.file_path, title: lookup.title } : {}
+      });
+      if (wasNew) registeredProducts.push({ id: pid, ...lookup ? { file_path: lookup.file_path, title: lookup.title } : {} });
+    }
+    if (registeredProducts.length > 0) portfolioStore.markDirty();
+  }
+  try {
+    for (const e of prepared) portfolioStore.addCrossEdge(e);
+    await portfolioStore.flush();
+  } catch (err) {
+    return textError(`Failed to write cross-product edges: ${err.message}`);
+  }
+  return text(
+    JSON.stringify(
+      {
+        message: `Created ${prepared.length} cross-product edge(s)`,
+        created: prepared,
+        count: prepared.length,
+        portfolio_file: path3.relative(cwd, portfolioPath),
+        ...registeredProducts.length > 0 ? { registered_products: registeredProducts } : {}
+      },
+      null,
+      2
+    )
+  );
+};
 
 // src/tools/schema.ts
 var getEntitySchema = (args, _ctx) => {
@@ -29552,7 +29771,7 @@ var TOOL_DEFINITIONS = [
   },
   {
     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`.",
     inputSchema: { type: "object", properties: {} }
   },
   {
@@ -29937,6 +30156,66 @@ var TOOL_DEFINITIONS = [
       required: ["product_id", "area_id"]
     }
   },
+  {
+    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).",
+    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"]
+    }
+  },
+  {
+    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`.",
+    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"]
+    }
+  },
+  {
+    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.",
+    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"]
+    }
+  },
+  {
+    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.",
+    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"]
+    }
+  },
   {
     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.",
@@ -29949,6 +30228,18 @@ var TOOL_DEFINITIONS = [
       required: ["product_id", "portfolio_id"]
     }
   },
+  {
+    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`.",
+    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"]
+    }
+  },
   {
     name: "list_portfolios",
     description: "List portfolios from the portfolio document (`.upg/portfolio.upg`). Portfolios represent the strategic axis (where we invest). Returns an empty list when no portfolio document exists yet.",
@@ -29961,7 +30252,7 @@ var TOOL_DEFINITIONS = [
   },
   {
     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).",
     inputSchema: {
       type: "object",
       properties: {
@@ -29969,7 +30260,7 @@ var TOOL_DEFINITIONS = [
         target_id: { type: "string", description: "Target node ID" },
         type: {
           type: "string",
-          enum: ["shares_persona", "shares_competitor", "shares_metric", "depends_on_product", "cannibalises", "succeeds"],
+          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" },
@@ -29978,6 +30269,47 @@ var TOOL_DEFINITIONS = [
       required: ["source_id", "target_id", "type"]
     }
   },
+  {
+    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.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        edge_id: { type: "string", description: "Cross-product edge id (from list_portfolio_cross_edges)" }
+      },
+      required: ["edge_id"]
+    }
+  },
+  {
+    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.",
+    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"]
+    }
+  },
   {
     name: "list_portfolio_cross_edges",
     description: "List all cross-product edges stored in the portfolio document (`.upg/portfolio.upg`). Empty list when the portfolio document is absent.",
@@ -30157,10 +30489,17 @@ var HANDLERS = {
   get_area_context: getAreaContext,
   create_area: createArea,
   assign_product_to_area: assignProductToAreaTool,
+  update_area: updateAreaTool,
+  remove_product_from_area: removeProductFromAreaTool,
+  delete_area: deleteAreaTool,
+  move_product_to_area: moveProductToAreaTool,
   list_portfolios: listPortfolios,
   get_organization: getOrganization,
   create_cross_product_edge: createCrossProductEdge,
+  delete_cross_product_edge: deleteCrossProductEdgeTool,
+  batch_create_cross_product_edges: batchCreateCrossProductEdges,
   attach_product_to_portfolio: attachProductToPortfolioTool,
+  detach_product_from_portfolio: detachProductFromPortfolioTool,
   list_portfolio_cross_edges: listPortfolioCrossEdges,
   migrate_cross_edges: migrateCrossEdges,
   get_sync_state: getSyncState,