@unified-product-graph/mcp-server 0.7.1 → 0.7.4

package/dist/preflight.js

@@ -18,7 +18,7 @@ for (const [label, specifier] of REQUIRED_DEPS) {
 if (missing.length > 0) {
   process.stderr.write(
     `
-\u256D\u2500 UPG MCP Server \u2014 missing dependencies \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256E
+\u256D\u2500 UPG MCP Server: missing dependencies \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u256E
 \u2502                                                          \u2502
 ` + missing.map(
       (d) => `\u2502  \u2717 ${d}${" ".repeat(Math.max(0, 52 - d.length))}\u2502

package/dist/preflight.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/preflight.ts"],"sourcesContent":["/**\n * Preflight dependency check for the UPG MCP Server.\n *\n * ES module imports are hoisted, so if a dependency is missing the process\n * crashes before any error-handling code runs, producing silent failure\n * in Claude Code. This script checks critical deps first, prints a\n * human-readable message on failure, then dynamically imports the real\n * entry point.\n */\n\nconst REQUIRED_DEPS: Array<[label: string, specifier: string]> = [\n  ['@modelcontextprotocol/sdk', '@modelcontextprotocol/sdk/server'],\n  ['@unified-product-graph/core', '@unified-product-graph/core'],\n  ['chokidar', 'chokidar'],\n  ['nanoid', 'nanoid'],\n]\n\nconst missing: string[] = []\n\nfor (const [label, specifier] of REQUIRED_DEPS) {\n  try {\n    await import(specifier)\n  } catch {\n    missing.push(label)\n  }\n}\n\nif (missing.length > 0) {\n  process.stderr.write(\n    `\\n╭─ UPG MCP Server — missing dependencies ─────────────────╮\\n` +\n    `│                                                          │\\n` +\n    missing.map((d) =>\n      `│  ✗ ${d}${' '.repeat(Math.max(0, 52 - d.length))}│\\n`\n    ).join('') +\n    `│                                                          │\\n` +\n    `│  Run \\`npm install\\` in the project root to fix this.      │\\n` +\n    `╰──────────────────────────────────────────────────────────╯\\n\\n`,\n  )\n  process.exit(1)\n}\n\n// All deps present — boot the real server\nawait import('./index.js')\n\nexport {}\n"],"mappings":";;;AAUA,IAAM,gBAA2D;AAAA,EAC/D,CAAC,6BAA6B,kCAAkC;AAAA,EAChE,CAAC,+BAA+B,6BAA6B;AAAA,EAC7D,CAAC,YAAY,UAAU;AAAA,EACvB,CAAC,UAAU,QAAQ;AACrB;AAEA,IAAM,UAAoB,CAAC;AAE3B,WAAW,CAAC,OAAO,SAAS,KAAK,eAAe;AAC9C,MAAI;AACF,UAAM,OAAO;AAAA,EACf,QAAQ;AACN,YAAQ,KAAK,KAAK;AAAA,EACpB;AACF;AAEA,IAAI,QAAQ,SAAS,GAAG;AACtB,UAAQ,OAAO;AAAA,IACb;AAAA;AAAA;AAAA,IAEA,QAAQ;AAAA,MAAI,CAAC,MACX,kBAAQ,CAAC,GAAG,IAAI,OAAO,KAAK,IAAI,GAAG,KAAK,EAAE,MAAM,CAAC,CAAC;AAAA;AAAA,IACpD,EAAE,KAAK,EAAE,IACT;AAAA;AAAA;AAAA;AAAA;AAAA,EAGF;AACA,UAAQ,KAAK,CAAC;AAChB;AAGA,MAAM,OAAO,YAAY;","names":[]}
+{"version":3,"sources":["../src/preflight.ts"],"sourcesContent":["/**\n * Preflight dependency check for the UPG MCP Server.\n *\n * ES module imports are hoisted, so if a dependency is missing the process\n * crashes before any error-handling code runs, producing silent failure\n * in Claude Code. This script checks critical deps first, prints a\n * human-readable message on failure, then dynamically imports the real\n * entry point.\n */\n\nconst REQUIRED_DEPS: Array<[label: string, specifier: string]> = [\n  ['@modelcontextprotocol/sdk', '@modelcontextprotocol/sdk/server'],\n  ['@unified-product-graph/core', '@unified-product-graph/core'],\n  ['chokidar', 'chokidar'],\n  ['nanoid', 'nanoid'],\n]\n\nconst missing: string[] = []\n\nfor (const [label, specifier] of REQUIRED_DEPS) {\n  try {\n    await import(specifier)\n  } catch {\n    missing.push(label)\n  }\n}\n\nif (missing.length > 0) {\n  process.stderr.write(\n    `\\n╭─ UPG MCP Server: missing dependencies ─────────────────╮\\n` +\n    `│                                                          │\\n` +\n    missing.map((d) =>\n      `│  ✗ ${d}${' '.repeat(Math.max(0, 52 - d.length))}│\\n`\n    ).join('') +\n    `│                                                          │\\n` +\n    `│  Run \\`npm install\\` in the project root to fix this.      │\\n` +\n    `╰──────────────────────────────────────────────────────────╯\\n\\n`,\n  )\n  process.exit(1)\n}\n\n// All deps present; boot the real server\nawait import('./index.js')\n\nexport {}\n"],"mappings":";;;AAUA,IAAM,gBAA2D;AAAA,EAC/D,CAAC,6BAA6B,kCAAkC;AAAA,EAChE,CAAC,+BAA+B,6BAA6B;AAAA,EAC7D,CAAC,YAAY,UAAU;AAAA,EACvB,CAAC,UAAU,QAAQ;AACrB;AAEA,IAAM,UAAoB,CAAC;AAE3B,WAAW,CAAC,OAAO,SAAS,KAAK,eAAe;AAC9C,MAAI;AACF,UAAM,OAAO;AAAA,EACf,QAAQ;AACN,YAAQ,KAAK,KAAK;AAAA,EACpB;AACF;AAEA,IAAI,QAAQ,SAAS,GAAG;AACtB,UAAQ,OAAO;AAAA,IACb;AAAA;AAAA;AAAA,IAEA,QAAQ;AAAA,MAAI,CAAC,MACX,kBAAQ,CAAC,GAAG,IAAI,OAAO,KAAK,IAAI,GAAG,KAAK,EAAE,MAAM,CAAC,CAAC;AAAA;AAAA,IACpD,EAAE,KAAK,EAAE,IACT;AAAA;AAAA;AAAA;AAAA;AAAA,EAGF;AACA,UAAQ,KAAK,CAAC;AAChB;AAGA,MAAM,OAAO,YAAY;","names":[]}

package/dist/tools-manifest.json

@@ -1,7 +1,7 @@
 {
   "schema_version": "2",
   "package": "@unified-product-graph/mcp-server",
-  "package_version": "0.7.1",
+  "package_version": "0.7.4",
   "tool_count": 93,
   "domains": [
     "context",
@@ -35,7 +35,7 @@
         {
           "description": "Live call against the Notion example graph.",
           "input": "{}",
-          "output": "{\n  \"product\": {\n    \"title\": \"Notion (SATURATED test graph)\",\n    \"stage\": \"concept\"\n  },\n  \"counts\": {\n    \"total_nodes\": 2054,\n    \"total_edges\": 3120,\n    \"by_type\": {\n      \"product\": 13,\n      \"capability\": 20,\n      \"value_stream\": 3,\n      \"decision\": 13,\n      \"evidence\": 10,\n      \"assumption\": 30,\n      \"outcome\": 6,\n      \"document\": 9,\n      \"objective\": 6,\n      \"key_result\": 14,\n      \"design_component\": 15,\n      \"hypothesis\": 6,\n      \"experiment\": 5,\n      \"experiment_plan\": 13,\n      \"job\": 10,\n      \"bounded_context\": 13,\n      \"initiative\": 11,\n      \"strategic_pillar\": 6,\n      \"test_plan\": 8,\n      \"screen\": 15,\n      \"experiment_run\": 18,\n      \"design_system\": 4,\n      \"team\": 1,\n      \"compliance_requirement\": 5,\n      \"workspace\": 3,\n      \"epic\": 4,\n      \"bug\": 6,\n      \"task\": 3,\n      \"feature_area\": 3,\n      \"mission\": 2,\n      \"desired_outcome\": 4,\n      \"model_comparison\": 3,\n      \"agent_session\": 3,\n      \"learning\": 17,\n      \"research_plan\": 6,\n      \"constraint\": 3,\n      \"stakeholder\": 10,\n      \"feature\": 12,\n      \"security_review\": 8,\n      \"metric\": 23,\n      \"person\": 215,\n      \"technical_debt_item\": 12,\n      \"risk\": 9,\n      \"service\": 11,\n      \"opportunity\": 7,\n      \"solution\": 11,\n      \"feasibility_study\": 3,\n      \"design_sprint\": 3,\n      \"prototype\": 8,\n      \"design_concept\": 7,\n      \"vision\": 1,\n… (truncated)"
+          "output": "{\n  \"product\": {\n    \"title\": \"Notion (SATURATED test graph)\",\n    \"stage\": \"concept\"\n  },\n  \"counts\": {\n    \"total_nodes\": 2054,\n    \"total_edges\": 3216,\n    \"by_type\": {\n      \"product\": 13,\n      \"capability\": 20,\n      \"value_stream\": 3,\n      \"decision\": 13,\n      \"evidence\": 10,\n      \"assumption\": 30,\n      \"outcome\": 6,\n      \"document\": 9,\n      \"objective\": 6,\n      \"key_result\": 14,\n      \"design_component\": 15,\n      \"hypothesis\": 6,\n      \"experiment\": 5,\n      \"experiment_plan\": 13,\n      \"job\": 10,\n      \"bounded_context\": 13,\n      \"initiative\": 11,\n      \"strategic_pillar\": 6,\n      \"test_plan\": 8,\n      \"screen\": 15,\n      \"experiment_run\": 18,\n      \"design_system\": 4,\n      \"team\": 1,\n      \"compliance_requirement\": 5,\n      \"workspace\": 3,\n      \"epic\": 4,\n      \"bug\": 6,\n      \"task\": 3,\n      \"feature_area\": 3,\n      \"mission\": 2,\n      \"desired_outcome\": 4,\n      \"model_comparison\": 3,\n      \"agent_session\": 3,\n      \"learning\": 17,\n      \"research_plan\": 6,\n      \"constraint\": 3,\n      \"stakeholder\": 10,\n      \"feature\": 12,\n      \"security_review\": 8,\n      \"metric\": 23,\n      \"person\": 215,\n      \"technical_debt_item\": 12,\n      \"risk\": 9,\n      \"service\": 11,\n      \"opportunity\": 7,\n      \"solution\": 11,\n      \"feasibility_study\": 3,\n      \"design_sprint\": 3,\n      \"prototype\": 8,\n      \"design_concept\": 7,\n      \"vision\": 1,\n… (truncated)"
         }
       ],
       "warnings": [],
@@ -69,7 +69,7 @@
         {
           "description": "Live call against the Notion example graph.",
           "input": "{}",
-          "output": "## Notion (SATURATED test graph)\n\nStage: concept\n\nLens: product\n\n### 🧭 Product Lens\n- Personas: 4\n- Outcomes: 6\n- Hypotheses: 6 (0 validated)\n\n### Graph Stats\n- Nodes: 2054\n- Edges: 3120\n- Entity types: 312\n\n### Entities by Type\n- Person (`person`): 215\n- Journey Step (`journey_step`): 53\n- Test Case (`test_case`): 48\n- Screen State (`screen_state`): 36\n- Assumption (`assumption`): 30\n- Journey Phase (`journey_phase`): 28\n- Journey Action (`journey_action`): 28\n- Interaction Spec (`interaction_spec`): 28\n- Metric (`metric`): 23\n- Test Result (`test_result`): 23\n- Capability (`capability`): 20\n- Participant (`participant`): 19\n- Regression Test (`regression_test`): 19\n- Experiment Run (`experiment_run`): 18\n- Alert Rule (`alert_rule`): 18\n- Validated Learning (`learning`): 17\n- Observation (`observation`): 17\n- Survey Response (`survey_response`): 17\n- Annotation (`annotation`): 17\n- Vulnerability (`vulnerability`): 16\n- Design Component (`design_component`): 15\n- Screen (`screen`): 15\n- Monitor (`monitor`): 15\n- Research Question (`research_question`): 15\n- Service Level Indicator (`service_level_indicator`): 15\n- Error Budget (`error_budget`): 15\n- Key Result (`key_result`): 14\n- Product (`product`): 13\n- Decision (`decision`): 13\n- Experiment Plan (`experiment_plan`): 13\n- Bounded Context (`bounded_context`): 13\n- Insight (`insight`): 13\n- Theme (`theme`): 13\n- Feature\n… (truncated)"
+          "output": "## Notion (SATURATED test graph)\n\nStage: concept\n\nLens: product\n\n### 🧭 Product Lens\n- Personas: 4\n- Outcomes: 6\n- Hypotheses: 6 (0 validated)\n\n### Graph Stats\n- Nodes: 2054\n- Edges: 3216\n- Entity types: 312\n\n### Entities by Type\n- Person (`person`): 215\n- Journey Step (`journey_step`): 53\n- Test Case (`test_case`): 48\n- Screen State (`screen_state`): 36\n- Assumption (`assumption`): 30\n- Journey Phase (`journey_phase`): 28\n- Journey Action (`journey_action`): 28\n- Interaction Spec (`interaction_spec`): 28\n- Metric (`metric`): 23\n- Test Result (`test_result`): 23\n- Capability (`capability`): 20\n- Participant (`participant`): 19\n- Regression Test (`regression_test`): 19\n- Experiment Run (`experiment_run`): 18\n- Alert Rule (`alert_rule`): 18\n- Validated Learning (`learning`): 17\n- Observation (`observation`): 17\n- Survey Response (`survey_response`): 17\n- Annotation (`annotation`): 17\n- Vulnerability (`vulnerability`): 16\n- Design Component (`design_component`): 15\n- Screen (`screen`): 15\n- Monitor (`monitor`): 15\n- Research Question (`research_question`): 15\n- Service Level Indicator (`service_level_indicator`): 15\n- Error Budget (`error_budget`): 15\n- Key Result (`key_result`): 14\n- Product (`product`): 13\n- Decision (`decision`): 13\n- Experiment Plan (`experiment_plan`): 13\n- Bounded Context (`bounded_context`): 13\n- Insight (`insight`): 13\n- Theme (`theme`): 13\n- Feature\n… (truncated)"
         }
       ],
       "warnings": [],
@@ -84,7 +84,7 @@
     },
     {
       "name": "get_session_context",
-      "description": "Read session context: which skills ran, what was recommended, current focus area. Returns `recommendations_to_avoid` — the deduped list of recommendations already given this session. Pick your next recommendation NOT in that array (data-layer dedup, not prose).",
+      "description": "Read session context: which skills ran, what was recommended, current focus area. Returns `recommendations_to_avoid`; the deduped list of recommendations already given this session. Pick your next recommendation NOT in that array (data-layer dedup, not prose).",
       "domain": "context",
       "inputSchema": {
         "type": "object",
@@ -104,7 +104,7 @@
       ],
       "source": "src/tools/context.ts:295",
       "symbol": "getSessionContext",
-      "returns": "JSON: `{ lens, skills_invoked, recommendations_given,\nrecommendations_to_avoid, focus_area, custom, skills_count, last_skill,\nlast_recommendation }`. `recommendations_to_avoid` is the deduped list of\nevery recommendation given this session — runners should filter their\nnext recommendation against this array rather than re-deriving the\ndedup rule from prose.",
+      "returns": "JSON: `{ lens, skills_invoked, recommendations_given,\nrecommendations_to_avoid, focus_area, custom, skills_count, last_skill,\nlast_recommendation }`. `recommendations_to_avoid` is the deduped list of\nevery recommendation given this session; runners should filter their\nnext recommendation against this array rather than re-deriving the\ndedup rule from prose.",
       "atomicity": "atomic (read-only)"
     },
     {
@@ -255,7 +255,7 @@
         {
           "description": "Live call against the Notion example graph.",
           "input": "{\n  \"nodes\": [\n    {\n      \"type\": \"person\",\n      \"title\": \"Example node A\"\n    },\n    {\n      \"type\": \"person\",\n      \"title\": \"Example node B\"\n    }\n  ]\n}",
-          "output": "{\n  \"created\": [\n    {\n      \"id\": \"n_j6U_8nTCFs7stzLl\",\n      \"type\": \"person\",\n      \"title\": \"Example node A\"\n    },\n    {\n      \"id\": \"n_J6z4nc-D40LV54G5\",\n      \"type\": \"person\",\n      \"title\": \"Example node B\"\n    }\n  ],\n  \"edges\": [],\n  \"count\": 2,\n  \"warnings\": [\n    \"Created 2 nodes with no edges — they are orphans. Use the edges[] array in this call to link them. See get_entity_schema(<type>) for canonical edges per type.\"\n  ]\n}"
+          "output": "{\n  \"created\": [\n    {\n      \"id\": \"n_psZXNbg3DydBoRqy\",\n      \"type\": \"person\",\n      \"title\": \"Example node A\"\n    },\n    {\n      \"id\": \"n_UJalQ1iIh93K5eJ9\",\n      \"type\": \"person\",\n      \"title\": \"Example node B\"\n    }\n  ],\n  \"edges\": [],\n  \"count\": 2,\n  \"warnings\": [\n    \"Created 2 nodes with no edges; they are orphans. Use the edges[] array in this call to link them. See get_entity_schema(<type>) for canonical edges per type.\"\n  ]\n}"
         }
       ],
       "warnings": [],
@@ -294,7 +294,7 @@
         {
           "description": "Live call against the Notion example graph.",
           "input": "{\n  \"node_ids\": [\n    \"1c051617-6cb7-4a59-b0a1-7779f404145b\"\n  ]\n}",
-          "output": "{\n  \"deleted\": [\n    {\n      \"id\": \"1c051617-6cb7-4a59-b0a1-7779f404145b\",\n      \"title\": \"Real-time multi-cursor collaboration\"\n    }\n  ],\n  \"edges_removed\": 4,\n  \"count\": 1\n}"
+          "output": "{\n  \"deleted\": [\n    {\n      \"id\": \"1c051617-6cb7-4a59-b0a1-7779f404145b\",\n      \"title\": \"Real-time multi-cursor collaboration\"\n    }\n  ],\n  \"edges_removed\": 10,\n  \"count\": 1\n}"
         }
       ],
       "warnings": [],
@@ -421,7 +421,7 @@
         {
           "description": "Live call against the Notion example graph.",
           "input": "{\n  \"type\": \"person\",\n  \"title\": \"Example node\"\n}",
-          "output": "{\n  \"node\": {\n    \"id\": \"n_LSjd64yzUUdx5X9r\",\n    \"type\": \"person\",\n    \"title\": \"Example node\",\n    \"slug\": \"example-node\"\n  },\n  \"edge\": null\n}"
+          "output": "{\n  \"node\": {\n    \"id\": \"n_lsZ0CjPWcrZ6Hhw8\",\n    \"type\": \"person\",\n    \"title\": \"Example node\",\n    \"slug\": \"example-node\"\n  },\n  \"edge\": null\n}"
         }
       ],
       "warnings": [],
@@ -1377,7 +1377,7 @@
         {
           "description": "Live call against the Notion example graph.",
           "input": "{\n  \"title\": \"Example node\"\n}",
-          "output": "{\n  \"node\": {\n    \"id\": \"n_cyDWeH77JTYEF4t_\",\n    \"title\": \"Example node\"\n  },\n  \"portfolio_file\": \"/Users/FH/Documents/_Code/tpc-worktrees/wt-cli-section/packages/upg-mcp-server/.upg/portfolio.upg\",\n  \"written_to\": \"product_areas\"\n}"
+          "output": "{\n  \"node\": {\n    \"id\": \"n_ntp_s5A9-x-aKjjS\",\n    \"title\": \"Example node\"\n  },\n  \"portfolio_file\": \"/Users/FH/Documents/_Code/tpc-emdash-packages/packages/upg-mcp-server/.upg/portfolio.upg\",\n  \"written_to\": \"product_areas\"\n}"
         }
       ],
       "warnings": [],
@@ -1387,7 +1387,7 @@
       "source": "src/tools/areas.ts:261",
       "symbol": "createArea",
       "returns": "JSON: `{ node, portfolio_file, written_to }`. `node` is the typed\n`UPGProductArea` record persisted to `portfolio_areas[]`.",
-      "atomicity": "atomic per write — the portfolio file is read, mutated, and\nflushed in one pass."
+      "atomicity": "atomic per write; the portfolio file is read, mutated, and\nflushed in one pass."
     },
     {
       "name": "get_area_context",
@@ -1466,7 +1466,7 @@
         {
           "description": "Live call against the Notion example graph.",
           "input": "{}",
-          "output": "{\n  \"changes\": [\n    {\n      \"action\": \"create\",\n      \"entity\": \"node\",\n      \"id\": \"n_LSjd64yzUUdx5X9r\",\n      \"type\": \"person\",\n      \"title\": \"Example node\",\n      \"timestamp\": \"2026-05-26T13:23:52.872Z\"\n    },\n    {\n      \"action\": \"update\",\n      \"entity\": \"node\",\n      \"id\": \"ec3d5479-4947-4bd9-9e77-b5ee01beb851\",\n      \"type\": \"product\",\n      \"title\": \"Notion (SATURATED test graph)\",\n      \"timestamp\": \"2026-05-26T13:23:52.873Z\"\n    },\n    {\n      \"action\": \"delete\",\n      \"entity\": \"node\",\n      \"id\": \"ec3d5479-4947-4bd9-9e77-b5ee01beb851\",\n      \"type\": \"product\",\n      \"title\": \"Notion (SATURATED test graph)\",\n      \"timestamp\": \"2026-05-26T13:23:52.874Z\"\n    },\n    {\n      \"action\": \"delete\",\n      \"entity\": \"edge\",\n      \"id\": \"1d645a2e-391b-4bc7-b0de-e15691c8a7d6\",\n      \"type\": \"cascade\",\n      \"timestamp\": \"2026-05-26T13:23:52.874Z\"\n    },\n    {\n      \"action\": \"delete\",\n      \"entity\": \"edge\",\n      \"id\": \"b4a77a49-7d28-4926-831f-464574d927fe\",\n      \"type\": \"cascade\",\n      \"timestamp\": \"2026-05-26T13:23:52.874Z\"\n    },\n    {\n      \"action\": \"delete\",\n      \"entity\": \"edge\",\n      \"id\": \"1ee422bc-64c1-4da1-b797-62e4d206b79c\",\n      \"type\": \"cascade\",\n      \"timestamp\": \"2026-05-26T13:23:52.874Z\"\n    },\n    {\n      \"action\": \"delete\",\n      \"entity\": \"edge\",\n      \"id\": \"013ac760-b99a-423e-bb94-700acda058c0\",\n      \"type\": \"cascade\",\n      \"timestamp\":\n… (truncated)"
+          "output": "{\n  \"changes\": [\n    {\n      \"action\": \"create\",\n      \"entity\": \"node\",\n      \"id\": \"n_lsZ0CjPWcrZ6Hhw8\",\n      \"type\": \"person\",\n      \"title\": \"Example node\",\n      \"timestamp\": \"2026-05-29T20:13:19.656Z\"\n    },\n    {\n      \"action\": \"update\",\n      \"entity\": \"node\",\n      \"id\": \"ec3d5479-4947-4bd9-9e77-b5ee01beb851\",\n      \"type\": \"product\",\n      \"title\": \"Notion (SATURATED test graph)\",\n      \"timestamp\": \"2026-05-29T20:13:19.656Z\"\n    },\n    {\n      \"action\": \"delete\",\n      \"entity\": \"node\",\n      \"id\": \"ec3d5479-4947-4bd9-9e77-b5ee01beb851\",\n      \"type\": \"product\",\n      \"title\": \"Notion (SATURATED test graph)\",\n      \"timestamp\": \"2026-05-29T20:13:19.658Z\"\n    },\n    {\n      \"action\": \"delete\",\n      \"entity\": \"edge\",\n      \"id\": \"1d645a2e-391b-4bc7-b0de-e15691c8a7d6\",\n      \"type\": \"cascade\",\n      \"timestamp\": \"2026-05-29T20:13:19.658Z\"\n    },\n    {\n      \"action\": \"delete\",\n      \"entity\": \"edge\",\n      \"id\": \"b4a77a49-7d28-4926-831f-464574d927fe\",\n      \"type\": \"cascade\",\n      \"timestamp\": \"2026-05-29T20:13:19.658Z\"\n    },\n    {\n      \"action\": \"delete\",\n      \"entity\": \"edge\",\n      \"id\": \"1ee422bc-64c1-4da1-b797-62e4d206b79c\",\n      \"type\": \"cascade\",\n      \"timestamp\": \"2026-05-29T20:13:19.658Z\"\n    },\n    {\n      \"action\": \"delete\",\n      \"entity\": \"edge\",\n      \"id\": \"013ac760-b99a-423e-bb94-700acda058c0\",\n      \"type\": \"cascade\",\n      \"timestamp\":\n… (truncated)"
         }
       ],
       "warnings": [],
@@ -1598,7 +1598,7 @@
         {
           "description": "Live call against the Notion example graph.",
           "input": "{\n  \"name\": \"example\"\n}",
-          "output": "{\n  \"message\": \"Created product: example\",\n  \"id\": \"p_1IGfQKJJbvHp3zuo\",\n  \"file\": \"example.upg\",\n  \"slug\": \"example\",\n  \"title\": \"example\",\n  \"workspace_path\": \".upg/\",\n  \"portfolio_attached\": false\n}"
+          "output": "{\n  \"message\": \"Created product: example\",\n  \"id\": \"p_P9zFGBICvycswgnv\",\n  \"file\": \"example.upg\",\n  \"slug\": \"example\",\n  \"title\": \"example\",\n  \"workspace_path\": \".upg/\",\n  \"portfolio_attached\": false\n}"
         }
       ],
       "warnings": [],
@@ -1648,7 +1648,7 @@
         {
           "description": "Live call against the Notion example graph.",
           "input": "{}",
-          "output": "{\n  \"mode\": \"single-file\",\n  \"current_file\": \"../../../../../../../../var/folders/68/wlsstx1s23l9n5shd79wgw8r0000gp/T/upg-capture-cdOo0q/fixture.upg\",\n  \"products\": [\n    {\n      \"file\": \"../../../../../../../../var/folders/68/wlsstx1s23l9n5shd79wgw8r0000gp/T/upg-capture-cdOo0q/fixture.upg\",\n      \"title\": \"Notion (SATURATED test graph)\",\n      \"active\": true\n    }\n  ]\n}"
+          "output": "{\n  \"mode\": \"single-file\",\n  \"current_file\": \"../../../../../../../tmp/claude-502/upg-capture-vP3Dh5/fixture.upg\",\n  \"products\": [\n    {\n      \"file\": \"../../../../../../../tmp/claude-502/upg-capture-vP3Dh5/fixture.upg\",\n      \"title\": \"Notion (SATURATED test graph)\",\n      \"active\": true\n    }\n  ]\n}"
         }
       ],
       "warnings": [],
@@ -1865,7 +1865,7 @@
         {
           "description": "Live call against the Notion example graph.",
           "input": "{\n  \"type\": \"person\"\n}",
-          "output": "{\n  \"type\": \"person\",\n  \"domain\": {\n    \"id\": \"team_org\",\n    \"label\": \"Team & Organisation\"\n  },\n  \"expected_properties\": {\n    \"email\": {\n      \"type\": \"string\",\n      \"description\": \"Primary contact email. Stable identifier for de-duplication.\"\n    },\n    \"role_title\": {\n      \"type\": \"string\",\n      \"description\": \"Free-text job title. Distinct from the structured `role` entity.\"\n    },\n    \"time_zone\": {\n      \"type\": \"string\",\n      \"description\": \"IANA time zone (e.g. \\\"Europe/Berlin\\\"). Useful for capacity / on-call planning.\"\n    }\n  },\n  \"edges_out\": [],\n  \"edges_in\": [\n    {\n      \"edge_type\": \"node_owned_by_person\",\n      \"source_type\": \"node\",\n      \"reverse_verb\": \"owns\"\n    }\n  ],\n  \"domain_guide\": {\n    \"anchor_entity\": \"team\",\n    \"creation_sequence\": [\n      \"team\",\n      \"role\",\n      \"stakeholder\",\n      \"person\",\n      \"team_okr\",\n      \"retrospective\",\n      \"dependency\",\n      \"department\",\n      \"skill\",\n      \"ceremony\",\n      \"capacity_plan\"\n    ],\n    \"position_in_sequence\": 3,\n    \"anti_patterns\": [\n      {\n        \"description\": \"Teams without OKRs — every team needs clear goals\"\n      },\n      {\n        \"description\": \"Dependencies without both teams linked — a dependency must connect blocker and blocked\"\n      },\n      {\n        \"description\": \"Retrospectives without action items — reflection without action is just venting\"\n      }\n    ]\n  }\n}"
+          "output": "{\n  \"type\": \"person\",\n  \"domain\": {\n    \"id\": \"team_org\",\n    \"label\": \"Team & Organisation\"\n  },\n  \"expected_properties\": {\n    \"email\": {\n      \"type\": \"string\",\n      \"description\": \"Primary contact email. Stable identifier for de-duplication.\"\n    },\n    \"role_title\": {\n      \"type\": \"string\",\n      \"description\": \"Free-text job title. Distinct from the structured `role` entity.\"\n    },\n    \"time_zone\": {\n      \"type\": \"string\",\n      \"description\": \"IANA time zone (e.g. \\\"Europe/Berlin\\\"). Useful for capacity / on-call planning.\"\n    }\n  },\n  \"edges_out\": [],\n  \"edges_in\": [\n    {\n      \"edge_type\": \"node_owned_by_person\",\n      \"source_type\": \"node\",\n      \"reverse_verb\": \"owns\"\n    }\n  ],\n  \"domain_guide\": {\n    \"anchor_entity\": \"team\",\n    \"creation_sequence\": [\n      \"team\",\n      \"role\",\n      \"stakeholder\",\n      \"person\",\n      \"team_okr\",\n      \"retrospective\",\n      \"dependency\",\n      \"department\",\n      \"skill\",\n      \"ceremony\",\n      \"capacity_plan\"\n    ],\n    \"position_in_sequence\": 3,\n    \"anti_patterns\": [\n      {\n        \"description\": \"Teams without OKRs: every team needs clear goals\"\n      },\n      {\n        \"description\": \"Dependencies without both teams linked: a dependency must connect blocker and blocked\"\n      },\n      {\n        \"description\": \"Retrospectives without action items: reflection without action is just venting\"\n      }\n    ]\n  }\n}"
         }
       ],
       "warnings": [],
@@ -2178,7 +2178,7 @@
         {
           "description": "Live call against the Notion example graph.",
           "input": "{\n  \"id\": \"product\"\n}",
-          "output": "{\n  \"id\": \"product\",\n  \"name\": \"Product\",\n  \"description\": \"Full graph, PM vocabulary, outcome-driven workflow\",\n  \"icon\": \"target\",\n  \"framework_id\": \"ost\",\n  \"label_overrides\": {\n    \"experiment\": \"Experiment\",\n    \"learning\": \"Validated Learning\"\n  },\n  \"visible_domains\": [],\n  \"benchmark_domains\": [\n    \"strategy\",\n    \"user\",\n    \"discovery\",\n    \"validation\",\n    \"market_intelligence\",\n    \"product_spec\",\n    \"growth\"\n  ],\n  \"intelligence_prompts\": [\n    {\n      \"condition\": \"outcomes.length === 0\",\n      \"structured_condition\": {\n        \"check\": {\n          \"type\": \"entity_count\",\n          \"entity_type\": \"outcome\",\n          \"comparison\": \"zero\"\n        }\n      },\n      \"message\": \"No outcomes defined yet. Start with what success looks like — what measurable result should this product drive?\"\n    },\n    {\n      \"condition\": \"hypotheses.untested.length > 3\",\n      \"structured_condition\": {\n        \"check\": {\n          \"type\": \"entity_count\",\n          \"entity_type\": \"hypothesis\",\n          \"filter\": {\n            \"status\": \"untested\"\n          },\n          \"comparison\": \"gt\",\n          \"threshold\": 3\n        }\n      },\n      \"message\": \"You have untested hypotheses stacking up. Pick the riskiest one and design an experiment before adding more.\"\n    },\n    {\n      \"condition\": \"features.length > 0 && hypotheses.length === 0\",\n      \"structured_condition\": {\n… (truncated)"
+          "output": "{\n  \"id\": \"product\",\n  \"name\": \"Product\",\n  \"description\": \"Full graph, PM vocabulary, outcome-driven workflow\",\n  \"icon\": \"target\",\n  \"framework_id\": \"ost\",\n  \"label_overrides\": {\n    \"experiment\": \"Experiment\",\n    \"learning\": \"Validated Learning\"\n  },\n  \"visible_domains\": [],\n  \"benchmark_domains\": [\n    \"strategy\",\n    \"user\",\n    \"discovery\",\n    \"validation\",\n    \"market_intelligence\",\n    \"product_spec\",\n    \"growth\"\n  ],\n  \"intelligence_prompts\": [\n    {\n      \"condition\": \"outcomes.length === 0\",\n      \"structured_condition\": {\n        \"check\": {\n          \"type\": \"entity_count\",\n          \"entity_type\": \"outcome\",\n          \"comparison\": \"zero\"\n        }\n      },\n      \"message\": \"No outcomes defined yet. Start with what success looks like: what measurable result should this product drive?\"\n    },\n    {\n      \"condition\": \"hypotheses.untested.length > 3\",\n      \"structured_condition\": {\n        \"check\": {\n          \"type\": \"entity_count\",\n          \"entity_type\": \"hypothesis\",\n          \"filter\": {\n            \"status\": \"untested\"\n          },\n          \"comparison\": \"gt\",\n          \"threshold\": 3\n        }\n      },\n      \"message\": \"You have untested hypotheses stacking up. Pick the riskiest one and design an experiment before adding more.\"\n    },\n    {\n      \"condition\": \"features.length > 0 && hypotheses.length === 0\",\n      \"structured_condition\": {\n… (truncated)"
         }
       ],
       "warnings": [],
@@ -2251,7 +2251,7 @@
         {
           "description": "Live call against the Notion example graph.",
           "input": "{\n  \"id\": \"playbook:strategy-outcomes\"\n}",
-          "output": "{\n  \"id\": \"playbook:strategy-outcomes\",\n  \"name\": \"Strategy & Outcomes\",\n  \"version\": \"0.2.0\",\n  \"description\": \"Cascade vision through themes, outcomes, objectives, key results — and the bets you are making to get there.\",\n  \"region\": \"strategy_outcomes\",\n  \"is_canonical\": true,\n  \"target_anchor_entity\": \"objective\",\n  \"creation_sequence\": [\n    {\n      \"kind\": \"entity_sequence\",\n      \"order\": 1,\n      \"phase\": \"Vision & Mission\",\n      \"name\": \"Vision & Mission\",\n      \"prompt_hint\": \"Name what you are building toward and how you will get there. Vision is the destination; mission is the orientation. One of each — more is dilution.\",\n      \"entity_types\": [\n        \"vision\",\n        \"mission\"\n      ]\n    },\n    {\n      \"kind\": \"entity_sequence\",\n      \"order\": 2,\n      \"phase\": \"Themes\",\n      \"name\": \"Themes\",\n      \"prompt_hint\": \"Choose 2–4 strategic themes that focus the work. Past four, you have lost focus, not gained coverage.\",\n      \"entity_types\": [\n        \"strategic_theme\",\n        \"strategic_pillar\"\n      ]\n    },\n    {\n      \"kind\": \"entity_sequence\",\n      \"order\": 3,\n      \"phase\": \"Outcomes\",\n      \"name\": \"Outcomes\",\n      \"prompt_hint\": \"Frame the changes in the world the product is trying to cause — shifts in behavior, perception, or position. Not features shipped.\",\n      \"entity_types\": [\n        \"outcome\"\n      ]\n    },\n    {\n      \"kind\":\n… (truncated)"
+          "output": "{\n  \"id\": \"playbook:strategy-outcomes\",\n  \"name\": \"Strategy & Outcomes\",\n  \"version\": \"0.2.0\",\n  \"description\": \"Cascade vision through themes, outcomes, objectives, key results, and the bets you are making to get there.\",\n  \"region\": \"strategy_outcomes\",\n  \"is_canonical\": true,\n  \"target_anchor_entity\": \"objective\",\n  \"creation_sequence\": [\n    {\n      \"kind\": \"entity_sequence\",\n      \"order\": 1,\n      \"phase\": \"Vision & Mission\",\n      \"name\": \"Vision & Mission\",\n      \"prompt_hint\": \"Name what you are building toward and how you will get there. Vision is the destination; mission is the orientation. One of each, no more.\",\n      \"entity_types\": [\n        \"vision\",\n        \"mission\"\n      ]\n    },\n    {\n      \"kind\": \"entity_sequence\",\n      \"order\": 2,\n      \"phase\": \"Themes\",\n      \"name\": \"Themes\",\n      \"prompt_hint\": \"Choose 2–4 strategic themes that focus the work. Past four, you have lost focus, not gained coverage.\",\n      \"entity_types\": [\n        \"strategic_theme\",\n        \"strategic_pillar\"\n      ]\n    },\n    {\n      \"kind\": \"entity_sequence\",\n      \"order\": 3,\n      \"phase\": \"Outcomes\",\n      \"name\": \"Outcomes\",\n      \"prompt_hint\": \"Frame the changes in the world the product is trying to cause: shifts in behavior, perception, or position. Not features shipped.\",\n      \"entity_types\": [\n        \"outcome\"\n      ]\n    },\n    {\n      \"kind\": \"entity_sequence\",\n… (truncated)"
         }
       ],
       "warnings": [],
@@ -2383,7 +2383,7 @@
         {
           "description": "Live call against the Notion example graph.",
           "input": "{}",
-          "output": "{\n  \"upg_version\": \"0.5.8\",\n  \"markdown_format_version\": \"0.1\",\n  \"entity_count\": 312,\n  \"edge_count\": 938,\n  \"domain_count\": 36,\n  \"region_count\": 10\n}"
+          "output": "{\n  \"upg_version\": \"0.7.3\",\n  \"markdown_format_version\": \"0.1\",\n  \"entity_count\": 312,\n  \"edge_count\": 946,\n  \"domain_count\": 36,\n  \"region_count\": 10\n}"
         }
       ],
       "warnings": [],
@@ -2483,7 +2483,7 @@
     },
     {
       "name": "inspect",
-      "description": "[LLM-mediated] This tool returns a routing envelope, not computed results. For user-facing inspection, invoke the /upg-inspect skill instead of calling this tool directly. — Inspect approach: path of arrival to \"what's broken?\". Returns the Inspect record + invocation params in the family-resemblance envelope. The LLM consumes `signature_hint` and emits `{ violations: [{ severity, kind, entity_id, description, fix_hint }] }` against `UPG_ANTI_PATTERNS` + the live graph. Optional `region` or `entities[]` scope the audit.",
+      "description": "[LLM-mediated] This tool returns a routing envelope, not computed results. For user-facing inspection, invoke the /upg-inspect skill instead of calling this tool directly. Inspect approach: path of arrival to \"what's broken?\". Returns the Inspect record + invocation params in the family-resemblance envelope. The LLM consumes `signature_hint` and emits `{ violations: [{ severity, kind, entity_id, description, fix_hint }] }` against `UPG_ANTI_PATTERNS` + the live graph. Optional `region` or `entities[]` scope the audit.",
       "domain": "spec",
       "inputSchema": {
         "type": "object",
@@ -2785,7 +2785,7 @@
         {
           "description": "Live call against the Notion example graph.",
           "input": "{}",
-          "output": "{\n  \"migrations\": [\n    {\n      \"kind\": \"rename\",\n      \"from\": \"solution_proposes_hypothesis_claim\",\n      \"to\": \"solution_proposes_hypothesis\",\n      \"since\": \"0.4.0\"\n    },\n    {\n      \"kind\": \"rename\",\n      \"from\": \"hypothesis_claim_requires_experiment_plan\",\n      \"to\": \"hypothesis_requires_experiment_plan\",\n      \"since\": \"0.4.0\"\n    },\n    {\n      \"kind\": \"rename\",\n      \"from\": \"hypothesis_claim_planned_via_test_plan\",\n      \"to\": \"hypothesis_planned_via_test_plan\",\n      \"since\": \"0.4.0\"\n    },\n    {\n      \"kind\": \"rename\",\n      \"from\": \"hypothesis_claim_investigated_via_research_plan\",\n      \"to\": \"hypothesis_investigated_via_research_plan\",\n      \"since\": \"0.4.0\"\n    },\n    {\n      \"kind\": \"rename\",\n      \"from\": \"learning_updates_hypothesis_claim\",\n      \"to\": \"learning_updates_hypothesis\",\n      \"since\": \"0.4.0\"\n    },\n    {\n      \"kind\": \"rename\",\n      \"from\": \"learning_refines_hypothesis_claim\",\n      \"to\": \"learning_refines_hypothesis\",\n      \"since\": \"0.4.0\"\n    },\n    {\n      \"kind\": \"rename\",\n      \"from\": \"assumption_becomes_hypothesis_claim\",\n      \"to\": \"assumption_becomes_hypothesis\",\n      \"since\": \"0.4.0\"\n    },\n    {\n      \"kind\": \"rename\",\n      \"from\": \"experiment_run_validates_hypothesis_claim\",\n      \"to\": \"experiment_run_validates_hypothesis\",\n      \"since\": \"0.4.0\"\n    },\n    {\n      \"kind\": \"rename\",\n      \"from\":\n… (truncated)"
+          "output": "{\n  \"migrations\": [\n    {\n      \"kind\": \"rename\",\n      \"from\": \"task_implements_story_statement\",\n      \"to\": \"task_implements_user_story\",\n      \"since\": \"0.7.0\"\n    },\n    {\n      \"kind\": \"rename\",\n      \"from\": \"epic_specified_by_story_statement\",\n      \"to\": \"epic_specified_by_user_story\",\n      \"since\": \"0.7.0\"\n    },\n    {\n      \"kind\": \"rename\",\n      \"from\": \"story_statement_verified_by_acceptance_criterion\",\n      \"to\": \"user_story_verified_by_acceptance_criterion\",\n      \"since\": \"0.7.0\"\n    },\n    {\n      \"kind\": \"rename\",\n      \"from\": \"test_case_covers_story_statement\",\n      \"to\": \"test_case_covers_user_story\",\n      \"since\": \"0.7.0\"\n    },\n    {\n      \"kind\": \"rename\",\n      \"from\": \"solution_proposes_hypothesis_claim\",\n      \"to\": \"solution_proposes_hypothesis\",\n      \"since\": \"0.4.0\"\n    },\n    {\n      \"kind\": \"rename\",\n      \"from\": \"hypothesis_claim_requires_experiment_plan\",\n      \"to\": \"hypothesis_requires_experiment_plan\",\n      \"since\": \"0.4.0\"\n    },\n    {\n      \"kind\": \"rename\",\n      \"from\": \"hypothesis_claim_planned_via_test_plan\",\n      \"to\": \"hypothesis_planned_via_test_plan\",\n      \"since\": \"0.4.0\"\n    },\n    {\n      \"kind\": \"rename\",\n      \"from\": \"hypothesis_claim_investigated_via_research_plan\",\n      \"to\": \"hypothesis_investigated_via_research_plan\",\n      \"since\": \"0.4.0\"\n    },\n    {\n      \"kind\": \"rename\",\n      \"from\":\n… (truncated)"
         }
       ],
       "warnings": [],
@@ -2823,7 +2823,7 @@
         {
           "description": "Live call against the Notion example graph.",
           "input": "{}",
-          "output": "{\n  \"count\": 938,\n  \"edges\": [\n    {\n      \"type\": \"product_targets_persona\",\n      \"forward_verb\": \"targets\",\n      \"reverse_verb\": \"targeted_by\",\n      \"classification\": \"semantic\",\n      \"source_type\": \"product\",\n      \"target_type\": \"persona\"\n    },\n    {\n      \"type\": \"persona_pursues_job\",\n      \"forward_verb\": \"pursues\",\n      \"reverse_verb\": \"pursued_by\",\n      \"classification\": \"semantic\",\n      \"source_type\": \"persona\",\n      \"target_type\": \"job\"\n    },\n    {\n      \"type\": \"persona_experiences_need\",\n      \"forward_verb\": \"experiences\",\n      \"reverse_verb\": \"experienced_by\",\n      \"classification\": \"semantic\",\n      \"source_type\": \"persona\",\n      \"target_type\": \"need\"\n    },\n    {\n      \"type\": \"persona_aspires_to_desired_outcome\",\n      \"forward_verb\": \"aspires_to\",\n      \"reverse_verb\": \"aspirational_for\",\n      \"classification\": \"hierarchy\",\n      \"source_type\": \"persona\",\n      \"target_type\": \"desired_outcome\"\n    },\n    {\n      \"type\": \"persona_incurs_switching_cost\",\n      \"forward_verb\": \"incurs\",\n      \"reverse_verb\": \"incurred_by\",\n      \"classification\": \"hierarchy\",\n      \"source_type\": \"persona\",\n      \"target_type\": \"switching_cost\"\n    },\n    {\n      \"type\": \"job_surfaces_need\",\n      \"forward_verb\": \"surfaces\",\n      \"reverse_verb\": \"surfaces_from\",\n      \"classification\": \"causal\",\n      \"source_type\": \"job\",\n      \"target_type\": \"need\"\n    },\n    {\n… (truncated)"
+          "output": "{\n  \"count\": 946,\n  \"edges\": [\n    {\n      \"type\": \"product_targets_persona\",\n      \"forward_verb\": \"targets\",\n      \"reverse_verb\": \"targeted_by\",\n      \"classification\": \"semantic\",\n      \"source_type\": \"product\",\n      \"target_type\": \"persona\"\n    },\n    {\n      \"type\": \"persona_pursues_job\",\n      \"forward_verb\": \"pursues\",\n      \"reverse_verb\": \"pursued_by\",\n      \"classification\": \"semantic\",\n      \"source_type\": \"persona\",\n      \"target_type\": \"job\"\n    },\n    {\n      \"type\": \"persona_experiences_need\",\n      \"forward_verb\": \"experiences\",\n      \"reverse_verb\": \"experienced_by\",\n      \"classification\": \"semantic\",\n      \"source_type\": \"persona\",\n      \"target_type\": \"need\"\n    },\n    {\n      \"type\": \"persona_aspires_to_desired_outcome\",\n      \"forward_verb\": \"aspires_to\",\n      \"reverse_verb\": \"aspirational_for\",\n      \"classification\": \"hierarchy\",\n      \"source_type\": \"persona\",\n      \"target_type\": \"desired_outcome\"\n    },\n    {\n      \"type\": \"persona_incurs_switching_cost\",\n      \"forward_verb\": \"incurs\",\n      \"reverse_verb\": \"incurred_by\",\n      \"classification\": \"hierarchy\",\n      \"source_type\": \"persona\",\n      \"target_type\": \"switching_cost\"\n    },\n    {\n      \"type\": \"job_surfaces_need\",\n      \"forward_verb\": \"surfaces\",\n      \"reverse_verb\": \"surfaces_from\",\n      \"classification\": \"causal\",\n      \"source_type\": \"job\",\n      \"target_type\": \"need\"\n    },\n    {\n… (truncated)"
         }
       ],
       "warnings": [],
@@ -2951,7 +2951,7 @@
     },
     {
       "name": "list_frameworks",
-      "description": "List the canonical `UPGFramework` definitions — the 34 curated, famous product frameworks that anchor the public catalog (spanning strategy, discovery, prioritisation, design, growth, engineering, and reflection classics). Paginated (default 50, max 200). Cursor is opaque: pass `next_cursor` from a previous response. Optional `category` is exact-match against `UPGFramework.category` and applies before pagination.",
+      "description": "List the canonical `UPGFramework` definitions; the 34 curated, famous product frameworks that anchor the public catalog (spanning strategy, discovery, prioritisation, design, growth, engineering, and reflection classics). Paginated (default 50, max 200). Cursor is opaque: pass `next_cursor` from a previous response. Optional `category` is exact-match against `UPGFramework.category` and applies before pagination.",
       "domain": "spec",
       "inputSchema": {
         "type": "object",
@@ -2975,7 +2975,7 @@
         {
           "description": "Live call against the Notion example graph.",
           "input": "{}",
-          "output": "{\n  \"total\": 216,\n  \"count\": 50,\n  \"frameworks\": [\n    {\n      \"id\": \"rice-scoring\",\n      \"approach_ids\": [\n        \"prioritise\"\n      ],\n      \"name\": \"RICE Scoring\",\n      \"version\": \"1.0.0\",\n      \"description\": \"Score features and opportunities by Reach, Impact, Confidence, and Effort to produce a ranked priority list.\",\n      \"category\": \"prioritization\",\n      \"origin\": {\n        \"type\": \"practitioner\",\n        \"attribution\": \"Intercom (Sean McBride)\",\n        \"description\": \"Developed at Intercom as a way to quantify feature prioritisation. Published as a blog post that became an industry standard.\",\n        \"url\": \"https://www.intercom.com/blog/rice-simple-prioritization-for-product-managers/\",\n        \"year\": 2014,\n        \"license\": \"open_attribution\"\n      },\n      \"tags\": [\n        \"prioritization\",\n        \"table\"\n      ],\n      \"slots\": [\n        {\n          \"label\": \"Items to score\",\n          \"entityTypeId\": \"feature\",\n          \"description\": \"Features, opportunities, or solutions being evaluated\"\n        },\n        {\n          \"label\": \"Reach\",\n          \"entityTypeId\": \"feature\",\n          \"description\": \"How many users does this affect per quarter?\"\n        },\n        {\n          \"label\": \"Impact\",\n          \"entityTypeId\": \"feature\",\n          \"description\": \"How much does this move the target outcome?\"\n        },\n        {\n          \"label\":\n… (truncated)"
+          "output": "{\n  \"total\": 34,\n  \"count\": 34,\n  \"frameworks\": [\n    {\n      \"id\": \"opportunity-solution-tree\",\n      \"approach_ids\": [\n        \"trace\"\n      ],\n      \"name\": \"Opportunity Solution Tree\",\n      \"version\": \"1.0.0\",\n      \"description\": \"Map desired outcomes to opportunities, then branch into solutions and experiments. Ensures every solution traces back to a real user need.\",\n      \"category\": \"discovery\",\n      \"origin\": {\n        \"type\": \"practitioner\",\n        \"attribution\": \"Teresa Torres\",\n        \"description\": \"Introduced in Continuous Discovery Habits. Maps outcomes to opportunities, solutions, and experiments.\",\n        \"url\": \"https://www.producttalk.org/opportunity-solution-tree/\",\n        \"year\": 2021,\n        \"license\": \"published_methodology\"\n      },\n      \"tags\": [\n        \"discovery\",\n        \"tree\"\n      ],\n      \"slots\": [\n        {\n          \"label\": \"Root Outcome\",\n          \"entityTypeId\": \"outcome\",\n          \"description\": \"The desired business or user outcome\"\n        },\n        {\n          \"label\": \"Opportunities\",\n          \"entityTypeId\": \"opportunity\",\n          \"description\": \"User needs, pain points, or desires\"\n        },\n        {\n          \"label\": \"Solutions\",\n          \"entityTypeId\": \"solution\",\n          \"description\": \"Ideas to address each opportunity\"\n        },\n        {\n          \"label\": \"Experiments\",\n          \"entityTypeId\":\n… (truncated)"
         }
       ],
       "warnings": [],
@@ -3041,7 +3041,7 @@
         {
           "description": "Live call against the Notion example graph.",
           "input": "{}",
-          "output": "{\n  \"total\": 189,\n  \"lifecycles\": [\n    {\n      \"entity_type\": \"product\",\n      \"initial_phase\": \"concept\",\n      \"terminal_phases\": [\n        \"sunset\"\n      ],\n      \"phases\": [\n        {\n          \"id\": \"concept\",\n          \"label\": \"Concept\",\n          \"description\": \"Napkin idea. Problem shape and solution sketch, pre-validation.\",\n          \"transitions_to\": [\n            \"validation\",\n            \"build\",\n            \"beta\",\n            \"launch\",\n            \"growth\",\n            \"mature\",\n            \"sunset\"\n          ]\n        },\n        {\n          \"id\": \"validation\",\n          \"label\": \"Validation\",\n          \"description\": \"Testing demand. User conversations and experiments pressure-test assumptions before build commits.\",\n          \"transitions_to\": [\n            \"build\",\n            \"beta\",\n            \"launch\",\n            \"growth\",\n            \"mature\",\n            \"sunset\"\n          ]\n        },\n        {\n          \"id\": \"build\",\n          \"label\": \"Build\",\n          \"description\": \"Actively developing v1. Core functionality is being authored, pre-user.\",\n          \"transitions_to\": [\n            \"beta\",\n            \"launch\",\n            \"growth\",\n            \"mature\",\n            \"sunset\"\n          ]\n        },\n        {\n          \"id\": \"beta\",\n          \"label\": \"Beta\",\n          \"description\": \"Early users, iterating. Feature-complete enough to learn from,\n… (truncated)"
+          "output": "{\n  \"total\": 188,\n  \"lifecycles\": [\n    {\n      \"entity_type\": \"product\",\n      \"initial_phase\": \"concept\",\n      \"terminal_phases\": [\n        \"sunset\"\n      ],\n      \"phases\": [\n        {\n          \"id\": \"concept\",\n          \"label\": \"Concept\",\n          \"description\": \"Napkin idea. Problem shape and solution sketch, pre-validation.\",\n          \"transitions_to\": [\n            \"validation\",\n            \"build\",\n            \"beta\",\n            \"launch\",\n            \"growth\",\n            \"mature\",\n            \"sunset\"\n          ]\n        },\n        {\n          \"id\": \"validation\",\n          \"label\": \"Validation\",\n          \"description\": \"Testing demand. User conversations and experiments pressure-test assumptions before build commits.\",\n          \"transitions_to\": [\n            \"build\",\n            \"beta\",\n            \"launch\",\n            \"growth\",\n            \"mature\",\n            \"sunset\"\n          ]\n        },\n        {\n          \"id\": \"build\",\n          \"label\": \"Build\",\n          \"description\": \"Actively developing v1. Core functionality is being authored, pre-user.\",\n          \"transitions_to\": [\n            \"beta\",\n            \"launch\",\n            \"growth\",\n            \"mature\",\n            \"sunset\"\n          ]\n        },\n        {\n          \"id\": \"beta\",\n          \"label\": \"Beta\",\n          \"description\": \"Early users, iterating. Feature-complete enough to learn from,\n… (truncated)"
         }
       ],
       "warnings": [],
@@ -3081,7 +3081,7 @@
         {
           "description": "Live call against the Notion example graph.",
           "input": "{}",
-          "output": "{\n  \"count\": 23,\n  \"playbooks\": [\n    {\n      \"id\": \"playbook:strategy-outcomes\",\n      \"name\": \"Strategy & Outcomes\",\n      \"version\": \"0.2.0\",\n      \"description\": \"Cascade vision through themes, outcomes, objectives, key results — and the bets you are making to get there.\",\n      \"region\": \"strategy_outcomes\",\n      \"is_canonical\": true,\n      \"target_anchor_entity\": \"objective\",\n      \"creation_sequence\": [\n        {\n          \"kind\": \"entity_sequence\",\n          \"order\": 1,\n          \"phase\": \"Vision & Mission\",\n          \"name\": \"Vision & Mission\",\n          \"prompt_hint\": \"Name what you are building toward and how you will get there. Vision is the destination; mission is the orientation. One of each — more is dilution.\",\n          \"entity_types\": [\n            \"vision\",\n            \"mission\"\n          ]\n        },\n        {\n          \"kind\": \"entity_sequence\",\n          \"order\": 2,\n          \"phase\": \"Themes\",\n          \"name\": \"Themes\",\n          \"prompt_hint\": \"Choose 2–4 strategic themes that focus the work. Past four, you have lost focus, not gained coverage.\",\n          \"entity_types\": [\n            \"strategic_theme\",\n            \"strategic_pillar\"\n          ]\n        },\n        {\n          \"kind\": \"entity_sequence\",\n          \"order\": 3,\n          \"phase\": \"Outcomes\",\n          \"name\": \"Outcomes\",\n          \"prompt_hint\": \"Frame the changes in the world the\n… (truncated)"
+          "output": "{\n  \"count\": 23,\n  \"playbooks\": [\n    {\n      \"id\": \"playbook:strategy-outcomes\",\n      \"name\": \"Strategy & Outcomes\",\n      \"version\": \"0.2.0\",\n      \"description\": \"Cascade vision through themes, outcomes, objectives, key results, and the bets you are making to get there.\",\n      \"region\": \"strategy_outcomes\",\n      \"is_canonical\": true,\n      \"target_anchor_entity\": \"objective\",\n      \"creation_sequence\": [\n        {\n          \"kind\": \"entity_sequence\",\n          \"order\": 1,\n          \"phase\": \"Vision & Mission\",\n          \"name\": \"Vision & Mission\",\n          \"prompt_hint\": \"Name what you are building toward and how you will get there. Vision is the destination; mission is the orientation. One of each, no more.\",\n          \"entity_types\": [\n            \"vision\",\n            \"mission\"\n          ]\n        },\n        {\n          \"kind\": \"entity_sequence\",\n          \"order\": 2,\n          \"phase\": \"Themes\",\n          \"name\": \"Themes\",\n          \"prompt_hint\": \"Choose 2–4 strategic themes that focus the work. Past four, you have lost focus, not gained coverage.\",\n          \"entity_types\": [\n            \"strategic_theme\",\n            \"strategic_pillar\"\n          ]\n        },\n        {\n          \"kind\": \"entity_sequence\",\n          \"order\": 3,\n          \"phase\": \"Outcomes\",\n          \"name\": \"Outcomes\",\n          \"prompt_hint\": \"Frame the changes in the world the product is trying\n… (truncated)"
         }
       ],
       "warnings": [],
@@ -3260,7 +3260,7 @@
         {
           "description": "Live call against the Notion example graph.",
           "input": "{}",
-          "output": "{\n  \"migrations\": [\n    {\n      \"from\": \"hypothesis_claim\",\n      \"to\": \"hypothesis\",\n      \"since\": \"0.4.0\"\n    },\n    {\n      \"from\": \"hypothesis_evidence\",\n      \"to\": \"evidence\",\n      \"since\": \"0.4.0\"\n    },\n    {\n      \"from\": \"story_task\",\n      \"to\": \"task\",\n      \"since\": \"0.4.0\"\n    },\n    {\n      \"from\": \"hypothesis\",\n      \"to\": \"hypothesis_claim\",\n      \"since\": \"0.2.8\"\n    },\n    {\n      \"from\": \"pain_point\",\n      \"to\": \"need\",\n      \"since\": \"0.1.0\"\n    },\n    {\n      \"from\": \"user_need\",\n      \"to\": \"need\",\n      \"since\": \"0.1.0\"\n    },\n    {\n      \"from\": \"research_insight\",\n      \"to\": \"insight\",\n      \"since\": \"0.1.0\"\n    },\n    {\n      \"from\": \"finding\",\n      \"to\": \"insight\",\n      \"since\": \"0.1.0\"\n    },\n    {\n      \"from\": \"ux_insight\",\n      \"to\": \"insight\",\n      \"since\": \"0.1.0\"\n    },\n    {\n      \"from\": \"highlight\",\n      \"to\": \"observation\",\n      \"since\": \"0.1.0\"\n    },\n    {\n      \"from\": \"kpi\",\n      \"to\": \"metric\",\n      \"since\": \"0.1.0\"\n    },\n    {\n      \"from\": \"north_star_metric\",\n      \"to\": \"metric\",\n      \"since\": \"0.1.0\"\n    },\n    {\n      \"from\": \"input_metric\",\n      \"to\": \"metric\",\n      \"since\": \"0.1.0\"\n    },\n    {\n      \"from\": \"metric_definition\",\n      \"to\": \"metric\",\n      \"since\": \"0.1.0\"\n    },\n    {\n      \"from\": \"ab_test\",\n      \"to\": \"experiment_run\",\n      \"since\": \"0.1.0\"\n    },\n    {\n      \"from\": \"growth_experiment\",\n… (truncated)"
+          "output": "{\n  \"migrations\": [\n    {\n      \"from\": \"story_statement\",\n      \"to\": \"user_story\",\n      \"since\": \"0.7.0\"\n    },\n    {\n      \"from\": \"hypothesis_claim\",\n      \"to\": \"hypothesis\",\n      \"since\": \"0.4.0\"\n    },\n    {\n      \"from\": \"hypothesis_evidence\",\n      \"to\": \"evidence\",\n      \"since\": \"0.4.0\"\n    },\n    {\n      \"from\": \"story_task\",\n      \"to\": \"task\",\n      \"since\": \"0.4.0\"\n    },\n    {\n      \"from\": \"hypothesis\",\n      \"to\": \"hypothesis_claim\",\n      \"since\": \"0.2.8\"\n    },\n    {\n      \"from\": \"pain_point\",\n      \"to\": \"need\",\n      \"since\": \"0.1.0\"\n    },\n    {\n      \"from\": \"user_need\",\n      \"to\": \"need\",\n      \"since\": \"0.1.0\"\n    },\n    {\n      \"from\": \"research_insight\",\n      \"to\": \"insight\",\n      \"since\": \"0.1.0\"\n    },\n    {\n      \"from\": \"finding\",\n      \"to\": \"insight\",\n      \"since\": \"0.1.0\"\n    },\n    {\n      \"from\": \"ux_insight\",\n      \"to\": \"insight\",\n      \"since\": \"0.1.0\"\n    },\n    {\n      \"from\": \"highlight\",\n      \"to\": \"observation\",\n      \"since\": \"0.1.0\"\n    },\n    {\n      \"from\": \"kpi\",\n      \"to\": \"metric\",\n      \"since\": \"0.1.0\"\n    },\n    {\n      \"from\": \"north_star_metric\",\n      \"to\": \"metric\",\n      \"since\": \"0.1.0\"\n    },\n    {\n      \"from\": \"input_metric\",\n      \"to\": \"metric\",\n      \"since\": \"0.1.0\"\n    },\n    {\n      \"from\": \"metric_definition\",\n      \"to\": \"metric\",\n      \"since\": \"0.1.0\"\n    },\n    {\n      \"from\": \"ab_test\",\n… (truncated)"
         }
       ],
       "warnings": [],
@@ -3295,7 +3295,7 @@
         {
           "description": "Live call against the Notion example graph.",
           "input": "{}",
-          "output": "{\n  \"approach_id\": \"plan\",\n  \"scope\": null,\n  \"generated_at\": \"2026-05-26T13:23:53.077Z\",\n  \"approach\": {\n    \"id\": \"plan\",\n    \"label\": \"Plan\",\n    \"description\": \"The path of arrival to \\\"what should I build next?\\\". Plan engages a region by surveying its entity coverage against canonical expectations and surfacing the missing scaffolding: the entities a healthy region carries that this graph does not. Cartographic sense: you are walking the coastline of a region and noting where the contour is incomplete, not deciding a strategy. Frameworks like Now/Next/Later, MoSCoW, and Wardley Mapping live within Plan as the named techniques for organising the gap-filling sequence.\",\n    \"question_answered\": \"what should I build next?\",\n    \"signature_hint\": \"({ region?: UPGRegionId }) → { missing_entities, coverage_score }\",\n    \"framework_id_examples\": [\n      \"now-next-later\",\n      \"moscow\",\n      \"wardley-map\",\n      \"okr-framework\",\n      \"three-horizons\"\n    ]\n  },\n  \"params\": {\n    \"region\": null\n  },\n  \"region\": null,\n  \"missing_entities\": [],\n  \"coverage_score\": 1,\n  \"expected_count\": 312,\n  \"covered_count\": 312,\n  \"execution_mode\": \"execution_v0_4_0\"\n}"
+          "output": "{\n  \"approach_id\": \"plan\",\n  \"scope\": null,\n  \"generated_at\": \"2026-05-29T20:13:19.977Z\",\n  \"approach\": {\n    \"id\": \"plan\",\n    \"label\": \"Plan\",\n    \"description\": \"The path of arrival to \\\"what should I build next?\\\". Plan engages a region by surveying its entity coverage against canonical expectations and surfacing the missing scaffolding: the entities a healthy region carries that this graph does not. Cartographic sense: you are walking the coastline of a region and noting where the contour is incomplete, not deciding a strategy. Frameworks like Now/Next/Later, MoSCoW, and Wardley Mapping live within Plan as the named techniques for organising the gap-filling sequence.\",\n    \"question_answered\": \"what should I build next?\",\n    \"signature_hint\": \"({ region?: UPGRegionId }) → { missing_entities, coverage_score }\",\n    \"framework_id_examples\": [\n      \"now-next-later\",\n      \"moscow\",\n      \"wardley-map\",\n      \"okr-framework\",\n      \"three-horizons\"\n    ]\n  },\n  \"params\": {\n    \"region\": null\n  },\n  \"region\": null,\n  \"missing_entities\": [],\n  \"coverage_score\": 1,\n  \"expected_count\": 312,\n  \"covered_count\": 312,\n  \"execution_mode\": \"execution_v0_4_0\"\n}"
         }
       ],
       "warnings": [],
@@ -3313,7 +3313,7 @@
     },
     {
       "name": "prioritise",
-      "description": "[LLM-mediated] This tool returns a routing envelope, not computed results. For user-facing prioritisation, invoke the /upg-prioritise skill instead of calling this tool directly. — Prioritise approach: path of arrival to \"what's most important?\". Returns the Prioritise record + invocation params + framework metadata in the family-resemblance envelope. Both `candidates` and `framework_id` are required. The LLM looks up the framework via `get_framework`, reads its scoring spec, and emits `{ ranked: [{ entity_id, score, rationale }], framework_used }`.",
+      "description": "[LLM-mediated] This tool returns a routing envelope, not computed results. For user-facing prioritisation, invoke the /upg-prioritise skill instead of calling this tool directly. Prioritise approach: path of arrival to \"what's most important?\". Returns the Prioritise record + invocation params + framework metadata in the family-resemblance envelope. Both `candidates` and `framework_id` are required. The LLM looks up the framework via `get_framework`, reads its scoring spec, and emits `{ ranked: [{ entity_id, score, rationale }], framework_used }`.",
       "domain": "spec",
       "inputSchema": {
         "type": "object",
@@ -3354,7 +3354,7 @@
     },
     {
       "name": "reflect",
-      "description": "[LLM-mediated] This tool returns a routing envelope, not computed results. For user-facing reflection, invoke the /upg-reflect skill instead of calling this tool directly. — Reflect approach: path of arrival to \"what should I be questioning?\". Returns the Reflect record + invocation params in the family-resemblance envelope. The LLM consumes `mode` + `scope` + `signature_hint` and emits `{ prompts: [{ kind, question, target_entities? }] }`. `mode` is one of: `assumptions`, `alternatives`, `blind-spots`, `load-bearing`; omit for open reflection. `scope` accepts a region id, entity id, or `null` for whole-graph.",
+      "description": "[LLM-mediated] This tool returns a routing envelope, not computed results. For user-facing reflection, invoke the /upg-reflect skill instead of calling this tool directly. Reflect approach: path of arrival to \"what should I be questioning?\". Returns the Reflect record + invocation params in the family-resemblance envelope. The LLM consumes `mode` + `scope` + `signature_hint` and emits `{ prompts: [{ kind, question, target_entities? }] }`. `mode` is one of: `assumptions`, `alternatives`, `blind-spots`, `load-bearing`; omit for open reflection. `scope` accepts a region id, entity id, or `null` for whole-graph.",
       "domain": "spec",
       "inputSchema": {
         "type": "object",
@@ -3385,7 +3385,7 @@
         {
           "description": "Live call against the Notion example graph.",
           "input": "{}",
-          "output": "{\n  \"approach_id\": \"reflect\",\n  \"scope\": null,\n  \"generated_at\": \"2026-05-26T13:23:53.082Z\",\n  \"approach\": {\n    \"id\": \"reflect\",\n    \"label\": \"Reflect\",\n    \"description\": \"The path of arrival to \\\"what should I be questioning?\\\". Reflect engages an optional scope (region, entity, or `null` for the whole graph) and emits structured prompts a thinker should consider: assumptions to test, alternatives to weigh, blind-spots to surface, load-bearing claims to verify. Mode is optional; absence is open reflection. Cartographic sense: before approaching the coastline, you are asking which features of your chart you have not actually verified; the prompts mark the parts of the map that may be conjecture. Five Whys, Pre-mortem, Red Team, and Devil's Advocate are the named techniques inside this approach.\",\n    \"question_answered\": \"what should I be questioning?\",\n    \"signature_hint\": \"({ scope?: UPGRegionId | entity_id | null, mode?: 'assumptions' | 'alternatives' | 'blind-spots' | 'load-bearing' }) → { prompts: [{ kind, question, target_entities? }] }\",\n    \"framework_id_examples\": [\n      \"five-whys\",\n      \"pre-mortem\",\n      \"red-team\",\n      \"devils-advocate\",\n      \"second-order-thinking\",\n      \"retrospective\",\n      \"four-forces-of-progress\",\n      \"assumption-canvas\",\n      \"win-loss-analysis\"\n    ]\n  },\n  \"params\": {\n    \"scope\": null,\n    \"mode\": null\n  },\n  \"prompts\": [\n… (truncated)"
+          "output": "{\n  \"approach_id\": \"reflect\",\n  \"scope\": null,\n  \"generated_at\": \"2026-05-29T20:13:20.019Z\",\n  \"approach\": {\n    \"id\": \"reflect\",\n    \"label\": \"Reflect\",\n    \"description\": \"The path of arrival to \\\"what should I be questioning?\\\". Reflect engages an optional scope (region, entity, or `null` for the whole graph) and emits structured prompts a thinker should consider: assumptions to test, alternatives to weigh, blind-spots to surface, load-bearing claims to verify. Mode is optional; absence is open reflection. Cartographic sense: before approaching the coastline, you are asking which features of your chart you have not actually verified; the prompts mark the parts of the map that may be conjecture. Five Whys, Pre-mortem, Red Team, and Devil's Advocate are the named techniques inside this approach.\",\n    \"question_answered\": \"what should I be questioning?\",\n    \"signature_hint\": \"({ scope?: UPGRegionId | entity_id | null, mode?: 'assumptions' | 'alternatives' | 'blind-spots' | 'load-bearing' }) → { prompts: [{ kind, question, target_entities? }] }\",\n    \"framework_id_examples\": [\n      \"five-whys\",\n      \"pre-mortem\",\n      \"red-team\",\n      \"devils-advocate\",\n      \"second-order-thinking\",\n      \"retrospective\",\n      \"four-forces-of-progress\",\n      \"assumption-canvas\",\n      \"win-loss-analysis\"\n    ]\n  },\n  \"params\": {\n    \"scope\": null,\n    \"mode\": null\n  },\n  \"prompts\": [\n… (truncated)"
         }
       ],
       "warnings": [],
@@ -3447,7 +3447,7 @@
     },
     {
       "name": "trace",
-      "description": "[LLM-mediated] This tool returns a routing envelope, not computed results. For user-facing tracing, invoke the /upg-trace skill instead of calling this tool directly. — Trace approach: path of arrival to \"walk a meaningful path through existing graph\". Returns the Trace record + invocation params in the family-resemblance envelope. The LLM uses `anchor` + `path` to compose `query()` calls and emits `{ trail: [{ depth, entity_id, edge_type_in }], reached: entity_id[] }`. `path` is type-shorthand: `[\"persona\",\"job\",\"feature\"]` walks persona→job→feature using the canonical edge per pair (via `resolve_edge_for_pair`). Optional `edges_override` selects non-canonical edges per hop; `null` per element means \"use canonical\".",
+      "description": "[LLM-mediated] This tool returns a routing envelope, not computed results. For user-facing tracing, invoke the /upg-trace skill instead of calling this tool directly. Trace approach: path of arrival to \"walk a meaningful path through existing graph\". Returns the Trace record + invocation params in the family-resemblance envelope. The LLM uses `anchor` + `path` to compose `query()` calls and emits `{ trail: [{ depth, entity_id, edge_type_in }], reached: entity_id[] }`. `path` is type-shorthand: `[\"persona\",\"job\",\"feature\"]` walks persona→job→feature using the canonical edge per pair (via `resolve_edge_for_pair`). Optional `edges_override` selects non-canonical edges per hop; `null` per element means \"use canonical\".",
       "domain": "spec",
       "inputSchema": {
         "type": "object",
@@ -3486,7 +3486,7 @@
         {
           "description": "Live call against the Notion example graph.",
           "input": "{\n  \"anchor\": \"ec3d5479-4947-4bd9-9e77-b5ee01beb851\",\n  \"path\": [\n    \"opportunity_drives_solution\"\n  ]\n}",
-          "output": "{\n  \"approach_id\": \"trace\",\n  \"scope\": \"ec3d5479-4947-4bd9-9e77-b5ee01beb851\",\n  \"generated_at\": \"2026-05-26T13:23:53.077Z\",\n  \"approach\": {\n    \"id\": \"trace\",\n    \"label\": \"Trace\",\n    \"description\": \"The path of arrival to \\\"walk a meaningful path through existing graph\\\". Trace engages an anchor entity and follows a path expressed as a UPGEntityType[] shorthand. Example: `[\\\"persona\\\", \\\"job\\\", \\\"feature\\\"]` walks persona→job→feature using the canonical edge for each pair (resolved via `resolve_edge_for_pair`). An optional `edges_override` array selects non-canonical edges per hop when a pair has multiple resolutions. Cartographic sense: you are tracing a route across charted terrain; anchor is the departure, path is the heading sequence, the canonical edges are the roads. No DSL invented; the shorthand IS the path expression.\",\n    \"question_answered\": \"walk a meaningful path through existing graph\",\n    \"signature_hint\": \"({ anchor: entity_id, path: UPGEntityType[], edges_override?: (string | null)[] }) → { trail: [{ depth, entity_id, edge_type_in }], reached: entity_id[] }\",\n    \"framework_id_examples\": [\n      \"opportunity-solution-tree\",\n      \"strategic-cascade\",\n      \"metrics-tree\",\n      \"user-journey-map\",\n      \"impact-map\",\n      \"dependency-map\"\n    ]\n  },\n  \"params\": {\n    \"anchor\": \"ec3d5479-4947-4bd9-9e77-b5ee01beb851\",\n    \"path\": [\n… (truncated)"
+          "output": "{\n  \"approach_id\": \"trace\",\n  \"scope\": \"ec3d5479-4947-4bd9-9e77-b5ee01beb851\",\n  \"generated_at\": \"2026-05-29T20:13:19.988Z\",\n  \"approach\": {\n    \"id\": \"trace\",\n    \"label\": \"Trace\",\n    \"description\": \"The path of arrival to \\\"walk a meaningful path through existing graph\\\". Trace engages an anchor entity and follows a path expressed as a UPGEntityType[] shorthand. Example: `[\\\"persona\\\", \\\"job\\\", \\\"feature\\\"]` walks persona→job→feature using the canonical edge for each pair (resolved via `resolve_edge_for_pair`). An optional `edges_override` array selects non-canonical edges per hop when a pair has multiple resolutions. Cartographic sense: you are tracing a route across charted terrain; anchor is the departure, path is the heading sequence, the canonical edges are the roads. No DSL invented; the shorthand IS the path expression.\",\n    \"question_answered\": \"walk a meaningful path through existing graph\",\n    \"signature_hint\": \"({ anchor: entity_id, path: UPGEntityType[], edges_override?: (string | null)[] }) → { trail: [{ depth, entity_id, edge_type_in }], reached: entity_id[] }\",\n    \"framework_id_examples\": [\n      \"opportunity-solution-tree\",\n      \"strategic-cascade\",\n      \"metrics-tree\",\n      \"user-journey-map\",\n      \"impact-map\",\n      \"dependency-map\"\n    ]\n  },\n  \"params\": {\n    \"anchor\": \"ec3d5479-4947-4bd9-9e77-b5ee01beb851\",\n    \"path\": [\n… (truncated)"
         }
       ],
       "warnings": [],
@@ -3736,7 +3736,7 @@
           },
           "include_polymorphic_upgrades": {
             "type": "boolean",
-            "description": "When true, include a `polymorphic_with_typed_alternative` array listing polymorphic edges (e.g. node_owned_by_person, node_constrains_node) that have a more-specific typed alternative for their actual source/target pair. Opt-in only — omitted by default to avoid cluttering routine validation output. Does not affect `valid`; these are advisory suggestions."
+            "description": "When true, include a `polymorphic_with_typed_alternative` array listing polymorphic edges (e.g. node_owned_by_person, node_constrains_node) that have a more-specific typed alternative for their actual source/target pair. Opt-in only; omitted by default to avoid cluttering routine validation output. Does not affect `valid`; these are advisory suggestions."
           }
         }
       },
@@ -3747,7 +3747,7 @@
         {
           "description": "Live call against the Notion example graph.",
           "input": "{}",
-          "output": "{\n  \"valid\": false,\n  \"summary\": {\n    \"entity_drift\": 0,\n    \"edge_drift\": 0,\n    \"top_level_drift\": 0,\n    \"lifecycle_drift\": 0,\n    \"self_referential\": 0,\n    \"property_drift\": 164,\n    \"total_nodes\": 2054,\n    \"total_edges\": 3120,\n    \"spec_version\": \"0.5.8\",\n    \"scope\": \"all\",\n    \"limit\": 100,\n    \"anti_pattern_violations_high\": 0,\n    \"anti_pattern_violations_medium\": 1,\n    \"anti_pattern_violations_low\": 0,\n    \"edge_type_pair_drift\": 100,\n    \"graph_topology_self_loops\": 0,\n    \"property_type_drift\": 100\n  },\n  \"_hash\": \"592a8d0ae65f17ac\",\n  \"entity_drift\": [],\n  \"edge_drift\": [],\n  \"top_level_drift\": [],\n  \"lifecycle_drift\": [],\n  \"self_referential\": [],\n  \"property_drift\": [\n    {\n      \"id\": \"ec3d5479-4947-4bd9-9e77-b5ee01beb851\",\n      \"type\": \"product\",\n      \"property\": \"stage\",\n      \"via\": \"UPG_PROPERTY_MIGRATIONS['0.2.13']\"\n    },\n    {\n      \"id\": \"3f1c1804-b33b-4b1f-9094-c91cc8957912\",\n      \"type\": \"assumption\",\n      \"property\": \"validation_status\",\n      \"via\": \"UPG_PROPERTY_MIGRATIONS['0.5.0']\"\n    },\n    {\n      \"id\": \"6719fce7-61e7-44df-b6cf-92f7c7312554\",\n      \"type\": \"assumption\",\n      \"property\": \"validation_status\",\n      \"via\": \"UPG_PROPERTY_MIGRATIONS['0.5.0']\"\n    },\n    {\n      \"id\": \"7b22f5f3-b344-4e49-8d5a-35cf9087dc6c\",\n      \"type\": \"assumption\",\n      \"property\": \"validation_status\",\n      \"via\": \"UPG_PROPERTY_MIGRATIONS['0.5.0']\"\n… (truncated)"
+          "output": "{\n  \"valid\": false,\n  \"summary\": {\n    \"entity_drift\": 0,\n    \"edge_drift\": 0,\n    \"top_level_drift\": 0,\n    \"lifecycle_drift\": 0,\n    \"self_referential\": 0,\n    \"property_drift\": 164,\n    \"total_nodes\": 2054,\n    \"total_edges\": 3216,\n    \"spec_version\": \"0.7.3\",\n    \"scope\": \"all\",\n    \"limit\": 100,\n    \"anti_pattern_violations_high\": 0,\n    \"anti_pattern_violations_medium\": 1,\n    \"anti_pattern_violations_low\": 0,\n    \"edge_type_pair_drift\": 100,\n    \"graph_topology_self_loops\": 0,\n    \"property_type_drift\": 100\n  },\n  \"_hash\": \"c0f701e327319f2e\",\n  \"entity_drift\": [],\n  \"edge_drift\": [],\n  \"top_level_drift\": [],\n  \"lifecycle_drift\": [],\n  \"self_referential\": [],\n  \"property_drift\": [\n    {\n      \"id\": \"ec3d5479-4947-4bd9-9e77-b5ee01beb851\",\n      \"type\": \"product\",\n      \"property\": \"stage\",\n      \"via\": \"UPG_PROPERTY_MIGRATIONS['0.2.13']\"\n    },\n    {\n      \"id\": \"3f1c1804-b33b-4b1f-9094-c91cc8957912\",\n      \"type\": \"assumption\",\n      \"property\": \"validation_status\",\n      \"via\": \"UPG_PROPERTY_MIGRATIONS['0.5.0']\"\n    },\n    {\n      \"id\": \"6719fce7-61e7-44df-b6cf-92f7c7312554\",\n      \"type\": \"assumption\",\n      \"property\": \"validation_status\",\n      \"via\": \"UPG_PROPERTY_MIGRATIONS['0.5.0']\"\n    },\n    {\n      \"id\": \"7b22f5f3-b344-4e49-8d5a-35cf9087dc6c\",\n      \"type\": \"assumption\",\n      \"property\": \"validation_status\",\n      \"via\": \"UPG_PROPERTY_MIGRATIONS['0.5.0']\"\n… (truncated)"
         }
       ],
       "warnings": [
@@ -3804,7 +3804,7 @@
         }
       ],
       "warnings": [
-        "Default is `dry_run: true`. Pass `dry_run: false` to commit.\nIdempotent on retry — re-running after a successful commit reports\nzero changes (canonical statuses pass the validity check)."
+        "Default is `dry_run: true`. Pass `dry_run: false` to commit.\nIdempotent on retry; re-running after a successful commit reports\nzero changes (canonical statuses pass the validity check)."
       ],
       "see": [
         "migrate_type",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unified-product-graph/mcp-server",
-  "version": "0.7.1",
+  "version": "0.7.4",
   "description": "Local MCP server for .upg files. Read and write product knowledge graphs offline.",
   "license": "MIT",
   "author": "The Product Creator <hello@theproductcreator.com>",

package/scripts/claudemd-snippet.md

@@ -3,16 +3,16 @@
 This project uses the Unified Product Graph to structure product thinking. A `.upg` file in the repo root contains the product graph.
 
 ### Available Commands
-- `/upg` — See your product graph status and all available commands
-- `/upg-journey` — Guided 7-phase product journey with progress tracking
-- `/upg-init` — Bootstrap a new product graph (~5 min guided setup)
-- `/upg-explore` — Create any entity (90+ types across 32 domains)
-- `/upg-status` — Health dashboard with maturity scoring
-- `/upg-gaps` — Gap analysis across 8 business areas
-- `/upg-capture` — Capture session work into the graph
+- `/upg`: See your product graph status and all available commands
+- `/upg-journey`: Guided 7-phase product journey with progress tracking
+- `/upg-init`: Bootstrap a new product graph (~5 min guided setup)
+- `/upg-explore`: Create any entity (90+ types across 32 domains)
+- `/upg-status`: Health dashboard with maturity scoring
+- `/upg-gaps`: Gap analysis across 8 business areas
+- `/upg-capture`: Capture session work into the graph
 
 ### Graph Awareness
-When a `.upg` file exists, be aware of the product graph context. During conversations about product decisions, features, user research, or business strategy, offer to capture relevant insights into the graph. Don't be pushy — only suggest when the work is clearly graph-worthy (new features, strategic decisions, user insights). Routine code changes are not graph-worthy.
+When a `.upg` file exists, be aware of the product graph context. During conversations about product decisions, features, user research, or business strategy, offer to capture relevant insights into the graph. Don't be pushy; only suggest when the work is clearly graph-worthy (new features, strategic decisions, user insights). Routine code changes are not graph-worthy.
 
 At natural checkpoints (after commits, before session end, after design discussions), suggest running `/upg-capture` to review and save session work.
 

package/scripts/install-skills.sh

@@ -129,7 +129,7 @@ for t in "${SELECTED_TARGETS[@]}"; do
   if [ -n "$dir" ]; then
     VALID_TARGETS+=("$t")
   else
-    echo "Warning: Unknown target '$t' — skipping"
+    echo "Warning: Unknown target '$t', skipping"
   fi
 done
 
@@ -205,7 +205,7 @@ if [ "$NO_CLAUDEMD" = false ]; then
 
   # Check if snippet already exists
   if [ -f "$CLAUDEMD_PATH" ] && grep -q "## Unified Product Graph" "$CLAUDEMD_PATH" 2>/dev/null; then
-    echo "  CLAUDE.md already has UPG awareness — skipping"
+    echo "  CLAUDE.md already has UPG awareness, skipping"
     CLAUDEMD_UPDATED=true
   else
     printf "Add UPG awareness to your CLAUDE.md? [Y/n] "
@@ -213,7 +213,7 @@ if [ "$NO_CLAUDEMD" = false ]; then
 
     if [ "${answer:-Y}" != "n" ] && [ "${answer:-Y}" != "N" ]; then
       if [ ! -f "$SNIPPET_FILE" ]; then
-        echo "Warning: Snippet file not found at $SNIPPET_FILE — skipping"
+        echo "Warning: Snippet file not found at $SNIPPET_FILE, skipping"
       else
         # Create CLAUDE.md if it doesn't exist
         if [ ! -f "$CLAUDEMD_PATH" ]; then
@@ -251,9 +251,9 @@ if [ "$CLAUDEMD_UPDATED" = true ]; then
 fi
 echo ""
 echo "Quick start:"
-echo "  /upg          — see your product graph"
-echo "  /upg-init     — bootstrap a new graph (~5 min)"
-echo "  /upg-journey  — guided product journey"
+echo "  /upg:          see your product graph"
+echo "  /upg-init:     bootstrap a new graph (~5 min)"
+echo "  /upg-journey:  guided product journey"
 echo ""
-echo "Skills are symlinked — edits in the source are live immediately."
+echo "Skills are symlinked; edits in the source are live immediately."
 echo ""