@unified-product-graph/mcp-server 0.8.0 → 0.8.2

package/dist/tools-manifest.json

@@ -1,7 +1,7 @@
 {
   "schema_version": "2",
   "package": "@unified-product-graph/mcp-server",
-  "package_version": "0.8.0",
+  "package_version": "0.8.2",
   "tool_count": 94,
   "domains": [
     "context",
@@ -153,11 +153,11 @@
         "properties": {
           "skill_invoked": {
             "type": "string",
-            "description": "Register that this skill was just invoked (e.g. \"upg-status\")"
+            "description": "Register that this skill was just invoked (e.g. \"upg-show-status\")"
           },
           "recommendation": {
             "type": "string",
-            "description": "Record a recommendation given to the user (e.g. \"Run /upg-strategy to fill strategy gap\")"
+            "description": "Record a recommendation given to the user (e.g. \"Run /upg-new-strategy to fill strategy gap\")"
           },
           "focus_area": {
             "type": "string",
@@ -167,11 +167,15 @@
             "type": "string",
             "enum": [
               "product",
+              "ux_design",
               "engineering",
-              "design",
-              "growth"
+              "growth",
+              "business",
+              "research",
+              "marketing",
+              "full"
             ],
-            "description": "Switch the active lens. Changes what context, skills, and gaps are surfaced first."
+            "description": "Switch the active lens. Changes what context, skills, and gaps are surfaced first. Canonical lens ids (derived from core): product, ux_design, engineering, growth, business, research, marketing, full."
           },
           "persist_lens": {
             "type": "boolean",
@@ -304,7 +308,7 @@
         "create_node",
         "batch_create_edges"
       ],
-      "source": "src/tools/nodes.ts:991",
+      "source": "src/tools/nodes.ts:1013",
       "symbol": "batchCreateNodes",
       "returns": "JSON: `{ created, edges_created, count, edges_count, warnings? }`.",
       "return_shape": "{ created, edges_created, count, edges_count, warnings? }",
@@ -343,7 +347,7 @@
       "see": [
         "delete_node"
       ],
-      "source": "src/tools/nodes.ts:1095",
+      "source": "src/tools/nodes.ts:1117",
       "symbol": "batchDeleteNodes",
       "returns": "JSON: `{ deleted, edges_removed, count }`.",
       "return_shape": "{ deleted, edges_removed, count }",
@@ -404,7 +408,7 @@
       "see": [
         "update_node"
       ],
-      "source": "src/tools/nodes.ts:1019",
+      "source": "src/tools/nodes.ts:1041",
       "symbol": "batchUpdateNodes",
       "returns": "JSON: `{ updated, count, warnings? }`. `warnings` carries\nlifecycle-phase hints aggregated across the batch.",
       "return_shape": "{ updated, count, warnings? }",
@@ -528,7 +532,7 @@
         "batch_delete_nodes",
         "validate_graph"
       ],
-      "source": "src/tools/nodes.ts:1340",
+      "source": "src/tools/nodes.ts:1362",
       "symbol": "deduplicateNodes",
       "returns": "JSON: with `dry_run: true`, `{ duplicates, total_groups,\ntotal_duplicate_nodes, dry_run, message }`. With `dry_run: false`,\n`{ merged: true, groups_merged, nodes_removed, edges_redirected,\nstrategy }`.",
       "return_notes": [
@@ -567,7 +571,7 @@
       "see": [
         "batch_delete_nodes"
       ],
-      "source": "src/tools/nodes.ts:965",
+      "source": "src/tools/nodes.ts:987",
       "symbol": "deleteNode",
       "returns": "JSON: `{ node, removed_edge_ids }`.",
       "return_shape": "{ node, removed_edge_ids }",
@@ -769,7 +773,7 @@
         "validate_graph",
         "list_type_migrations"
       ],
-      "source": "src/tools/nodes.ts:1286",
+      "source": "src/tools/nodes.ts:1308",
       "symbol": "migrateProperties",
       "returns": "JSON: `{ top_level_renames, lifted_properties, dropped_props,\ndropped_self_referential, dry_run }`.",
       "return_shape": "{ top_level_renames, lifted_properties, dropped_props, dropped_self_referential, dry_run }",
@@ -868,7 +872,7 @@
         "export_edges",
         "update_node"
       ],
-      "source": "src/tools/nodes.ts:1149",
+      "source": "src/tools/nodes.ts:1171",
       "symbol": "migrateType",
       "returns": "JSON: `{ migrated_nodes, migrated_edges, edge_renames,\ndropped_edges, unmapped_legacy_edges, defaults_applied, dry_run }`.\n`edge_renames` is `[{ id, from, to, flipped }]`; `dropped_edges` is\n`[{ id, from }]`; `unmapped_legacy_edges` is `[{ type, count }]`.\n`migrated_edges` is the total mutated count (renames + drops).",
       "return_shape": "{ migrated_nodes, migrated_edges, edge_renames, dropped_edges, unmapped_legacy_edges, defaults_applied, dry_run }",
@@ -1046,6 +1050,13 @@
           "properties": {
             "type": "object",
             "description": "Merged with existing properties"
+          },
+          "unset_properties": {
+            "type": "array",
+            "items": {
+              "type": "string"
+            },
+            "description": "Property keys to DELETE. Applied after the `properties` merge, so one call can set some keys and drop others. Writing `{ key: null }` only stores a literal null; use this to actually remove a key. Unknown keys are ignored."
           }
         },
         "required": [
@@ -1053,7 +1064,7 @@
         ]
       },
       "throws": [
-        "Returns a textError when `node_id` is missing, the type migration\nfails, when `strict: true` and unknown properties are present, or when\nthe underlying store rejects the patch."
+        "Returns a textError when `node_id` is missing, the type migration\nfails, the `status` is not a valid lifecycle phase for the type, when\n`strict: true` and unknown properties are present, or when the underlying\nstore rejects the patch."
       ],
       "examples": [
         {
@@ -1067,13 +1078,14 @@
         "migrate_type",
         "batch_update_nodes"
       ],
-      "source": "src/tools/nodes.ts:874",
+      "source": "src/tools/nodes.ts:880",
       "symbol": "updateNode",
-      "returns": "JSON: `{ node, warning?, unknown_properties? }`. `warning`\naggregates lifecycle-status hints, migration warnings, and any\nunknown-property notice. `unknown_properties` lists property\nkeys not in the entity's schema. Pass `strict: true` to reject unknown\nproperties instead of warning.",
-      "return_shape": "{ node, warning?, unknown_properties? }",
+      "returns": "JSON: `{ node, warning?, unknown_properties?, unset? }`. `warning`\naggregates migration warnings and any unknown-property notice.\n`unknown_properties` lists property keys not in the entity's schema.\n`unset` lists the keys actually removed. Pass `strict: true` to reject\nunknown properties instead of warning.",
+      "return_shape": "{ node, warning?, unknown_properties?, unset? }",
       "return_notes": [
-        "`warning` aggregates lifecycle-status hints, migration warnings, and any unknown-property notice.",
+        "`warning` aggregates migration warnings and any unknown-property notice.",
         "`unknown_properties` lists property keys not in the entity's schema.",
+        "`unset` lists the keys actually removed.",
         "Pass `strict: true` to reject unknown properties instead of warning."
       ],
       "atomicity": "atomic-with-rollback (when `type` is changed); atomic for\nshallow-merge patches."
@@ -1162,7 +1174,7 @@
       "see": [
         "delete_edge"
       ],
-      "source": "src/tools/edges.ts:293",
+      "source": "src/tools/edges.ts:297",
       "symbol": "batchDeleteEdges",
       "returns": "JSON: `{ deleted, count }`.",
       "return_shape": "{ deleted, count }",
@@ -1352,7 +1364,7 @@
         "query",
         "list_nodes"
       ],
-      "source": "src/tools/edges.ts:403",
+      "source": "src/tools/edges.ts:407",
       "symbol": "exportEdges",
       "returns": "JSON: `{ edges, total, offset, limit, types?, _hash }`. Each edge\ncarries `{ id, source, target, type, mapping_confidence? }`.",
       "return_shape": "{ edges, total, offset, limit, types?, _hash }",
@@ -1445,7 +1457,7 @@
         "migrate_type",
         "export_edges"
       ],
-      "source": "src/tools/edges.ts:490",
+      "source": "src/tools/edges.ts:494",
       "symbol": "renameEdgeType",
       "returns": "JSON: with `dry_run: true`, `{ dry_run, from, to, flip, would_rename, sample }`.\nWith `dry_run: false`, `{ dry_run, from, to, flip, renamed, ids }`.",
       "return_notes": [
@@ -1493,7 +1505,7 @@
         "Dropping `corrupt` edges is irreversible. The integrity stamp is\nre-computed on next save; a subsequent reload won't bring them back."
       ],
       "see": [],
-      "source": "src/tools/edges.ts:337",
+      "source": "src/tools/edges.ts:341",
       "symbol": "repairDanglingEdges",
       "returns": "JSON: `{ dry_run, report, dropped?, remaining? }`. `report` is\nthe pre-action classification. With `dry_run: false`, `dropped` is the\ncount of edges removed and `remaining` is the post-action report.",
       "return_shape": "{ dry_run, report, dropped?, remaining? }",
@@ -1742,7 +1754,7 @@
         "list_portfolio_cross_edges",
         "migrate_cross_edges"
       ],
-      "source": "src/tools/workspace.ts:395",
+      "source": "src/tools/workspace.ts:403",
       "symbol": "createCrossProductEdge",
       "returns": "JSON: `{ edge, portfolio_file }`.",
       "return_shape": "{ edge, portfolio_file }",
@@ -1794,7 +1806,7 @@
       "see": [
         "init_workspace"
       ],
-      "source": "src/tools/workspace.ts:275",
+      "source": "src/tools/workspace.ts:283",
       "symbol": "createProductTool",
       "returns": "JSON: `{ message, ...result }`. `result` carries `id`, `title`,\n`slug`, `file_path`, and the optional portfolio edge.",
       "return_shape": "{ message,...result }",
@@ -1823,7 +1835,7 @@
       "see": [
         "list_portfolios"
       ],
-      "source": "src/tools/workspace.ts:344",
+      "source": "src/tools/workspace.ts:352",
       "symbol": "getOrganization",
       "returns": "JSON: `{ organization: UPGOrganization | null, portfolio_file? }`.\nReturns `{ organization: null }` when no portfolio document exists yet.",
       "return_shape": "{ organization: UPGOrganization | null, portfolio_file? }",
@@ -1852,7 +1864,7 @@
       "see": [
         "init_workspace"
       ],
-      "source": "src/tools/workspace.ts:163",
+      "source": "src/tools/workspace.ts:171",
       "symbol": "getWorkspaceInfo",
       "returns": "JSON: `{ mode, workspace_path?, current_product?, current_file?,\nproducts }`. The shape depends on whether `.upg/workspace.json` exists.",
       "return_shape": "{ mode, workspace_path?, current_product?, current_file?, products }",
@@ -1892,7 +1904,7 @@
         "switch_product",
         "get_workspace_info"
       ],
-      "source": "src/tools/workspace.ts:239",
+      "source": "src/tools/workspace.ts:247",
       "symbol": "initWorkspaceTool",
       "returns": "JSON: `{ message, ...result }`. `result` carries the workspace\npath and the moved file's new location.",
       "return_shape": "{ message,...result }",
@@ -1922,10 +1934,13 @@
         "switch_product",
         "get_workspace_info"
       ],
-      "source": "src/tools/workspace.ts:40",
+      "source": "src/tools/workspace.ts:44",
       "symbol": "listLocalProducts",
-      "returns": "JSON: `{ products: Array<{ file, title, stage, nodes, edges }> }`.",
+      "returns": "JSON: `{ products: Array<{ file, title, stage, nodes, edges }> }`.\n`stage` is the CANONICAL UPGProductStage (legacy values like `idea` are\ncoerced to `concept`), or `null` when unset — matching what\n`get_product_context` reports for the same product (UPG-611 / DT-MCP-3).",
       "return_shape": "{ products: Array<{ file, title, stage, nodes, edges }> }",
+      "return_notes": [
+        "`stage` is the CANONICAL UPGProductStage (legacy values like `idea` are coerced to `concept`), or `null` when unset — matching what `get_product_context` reports for the same product (UPG-611 / DT-MCP-3)."
+      ],
       "atomicity": "atomic (read-only)"
     },
     {
@@ -1942,7 +1957,7 @@
       "see": [
         "create_cross_product_edge"
       ],
-      "source": "src/tools/workspace.ts:534",
+      "source": "src/tools/workspace.ts:542",
       "symbol": "listPortfolioCrossEdges",
       "returns": "JSON: `{ cross_edges: UPGCrossEdge[], total, portfolio_file? }`.",
       "return_shape": "{ cross_edges: UPGCrossEdge[], total, portfolio_file? }",
@@ -1969,7 +1984,7 @@
         "create_cross_product_edge",
         "get_organization"
       ],
-      "source": "src/tools/workspace.ts:317",
+      "source": "src/tools/workspace.ts:325",
       "symbol": "listPortfolios",
       "returns": "JSON: `{ portfolios: Array<{ id, title, description?,\nparent_portfolio_id?, hierarchy_model?, products? }>, total }`.",
       "return_shape": "{ portfolios: Array<{ id, title, description?, parent_portfolio_id?, hierarchy_model?, products? }>, total }",
@@ -2012,7 +2027,7 @@
         "list_cross_edge_types",
         "init_workspace"
       ],
-      "source": "src/tools/workspace.ts:603",
+      "source": "src/tools/workspace.ts:611",
       "symbol": "migrateCrossEdges",
       "returns": "JSON: `{ migrated, skipped, dry_run, portfolio_file? }`.",
       "return_shape": "{ migrated, skipped, dry_run, portfolio_file? }",
@@ -2046,7 +2061,7 @@
         "list_local_products",
         "init_workspace"
       ],
-      "source": "src/tools/workspace.ts:108",
+      "source": "src/tools/workspace.ts:116",
       "symbol": "switchProduct",
       "returns": "JSON: `{ message, file, product: { title, stage }, entities }`.",
       "return_shape": "{ message, file, product: { title, stage }, entities }",
@@ -2127,7 +2142,7 @@
         "inspect",
         "validate_graph"
       ],
-      "source": "src/tools/spec.ts:1425",
+      "source": "src/tools/spec.ts:1434",
       "symbol": "getAntiPattern",
       "returns": "JSON: `UPGCuratedAntiPattern`",
       "return_notes": [
@@ -2218,7 +2233,7 @@
         "list_anti_patterns",
         "get_playbook"
       ],
-      "source": "src/tools/spec.ts:746",
+      "source": "src/tools/spec.ts:755",
       "symbol": "getDomainGuide",
       "returns": "JSON: the full `UPGDomainUsageGuide` record.",
       "return_notes": [
@@ -2256,7 +2271,7 @@
         "list_domains",
         "get_domain_guide"
       ],
-      "source": "src/tools/spec.ts:1881",
+      "source": "src/tools/spec.ts:1890",
       "symbol": "getDomainRing",
       "returns": "JSON: the full `UPGDomainRing` record.",
       "return_notes": [
@@ -2297,7 +2312,7 @@
         "list_edge_migrations",
         "rename_edge_type"
       ],
-      "source": "src/tools/spec.ts:877",
+      "source": "src/tools/spec.ts:886",
       "symbol": "getEdgeType",
       "returns": "JSON: `{ type, forward_verb, reverse_verb, classification, source_type, target_type }`",
       "return_shape": "{ type, forward_verb, reverse_verb, classification, source_type, target_type }",
@@ -2336,7 +2351,7 @@
         "get_entity_schema",
         "list_type_migrations"
       ],
-      "source": "src/tools/spec.ts:1340",
+      "source": "src/tools/spec.ts:1349",
       "symbol": "getEntityMeta",
       "returns": "JSON: `EntityTypeMeta & { domain_id: string | null }`",
       "return_notes": [
@@ -2377,7 +2392,7 @@
         "get_playbook",
         "get_approach"
       ],
-      "source": "src/tools/spec.ts:814",
+      "source": "src/tools/spec.ts:823",
       "symbol": "getFramework",
       "returns": "JSON: the full `UPGFramework` record.",
       "return_notes": [
@@ -2418,7 +2433,7 @@
         "get_framework",
         "list_entity_types"
       ],
-      "source": "src/tools/spec.ts:1134",
+      "source": "src/tools/spec.ts:1143",
       "symbol": "getLensTool",
       "returns": "JSON: `{ ...UPGLens, visible_types: string[] }`",
       "return_shape": "{...UPGLens, visible_types: string[] }",
@@ -2454,7 +2469,7 @@
         "get_entity_meta",
         "get_entity_schema"
       ],
-      "source": "src/tools/spec.ts:1751",
+      "source": "src/tools/spec.ts:1760",
       "symbol": "getLifecycle",
       "returns": "JSON: the full `UPGLifecycle` record, or a descriptive message.",
       "return_notes": [
@@ -2464,7 +2479,7 @@
     },
     {
       "name": "get_playbook",
-      "description": "Return one `UPGPlaybook` by id (e.g. \"playbook:strategy-outcomes\", \"playbook:business-model-bmc\"). Includes the ordered `creation_sequence` with step kinds and prompts. IDs are namespace-prefixed `playbook:*`. For approaches, use `get_approach`.",
+      "description": "Return one `UPGPlaybook` by id (e.g. \"playbook:strategy-outcomes\", \"playbook:business-gtm-growth\"). Includes the ordered `creation_sequence` with step kinds and prompts. IDs are namespace-prefixed `playbook:*`. For approaches, use `get_approach`.",
       "domain": "spec",
       "inputSchema": {
         "type": "object",
@@ -2536,7 +2551,7 @@
         "get_playbook",
         "list_lenses"
       ],
-      "source": "src/tools/spec.ts:936",
+      "source": "src/tools/spec.ts:945",
       "symbol": "getRegion",
       "returns": "JSON: the full `UPGRegion` record.",
       "return_notes": [
@@ -2577,7 +2592,7 @@
         "get_entity_meta",
         "list_entity_types"
       ],
-      "source": "src/tools/spec.ts:958",
+      "source": "src/tools/spec.ts:967",
       "symbol": "getRegionForEntity",
       "returns": "JSON: the full `UPGRegion` record.",
       "return_notes": [
@@ -2608,7 +2623,7 @@
         "list_scales",
         "get_entity_schema"
       ],
-      "source": "src/tools/spec.ts:1797",
+      "source": "src/tools/spec.ts:1806",
       "symbol": "getScale",
       "returns": "JSON: the full `UPGScaleDefinition` record including all points.",
       "return_notes": [
@@ -2639,7 +2654,7 @@
         "list_edge_types",
         "list_regions"
       ],
-      "source": "src/tools/spec.ts:986",
+      "source": "src/tools/spec.ts:995",
       "symbol": "getSpecVersion",
       "returns": "JSON: `{ upg_version, markdown_format_version, entity_count, edge_count, domain_count, region_count }`",
       "return_shape": "{ upg_version, markdown_format_version, entity_count, edge_count, domain_count, region_count }",
@@ -2685,7 +2700,7 @@
         "get_entity_meta",
         "list_frameworks"
       ],
-      "source": "src/tools/spec.ts:1202",
+      "source": "src/tools/spec.ts:1211",
       "symbol": "getTypeLabel",
       "returns": "JSON: `{ ...UPGTypeLabel, resolved_label: string }`",
       "return_shape": "{...UPGTypeLabel, resolved_label: string }",
@@ -2724,7 +2739,7 @@
         "get_entity_meta",
         "create_node"
       ],
-      "source": "src/tools/spec.ts:1232",
+      "source": "src/tools/spec.ts:1241",
       "symbol": "getValidChildrenTool",
       "returns": "JSON: `{ parent_type, valid_children: string[] }`",
       "return_shape": "{ parent_type, valid_children: string[] }",
@@ -2732,7 +2747,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-show-entity 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",
@@ -2762,7 +2777,7 @@
         "plan",
         "reflect"
       ],
-      "source": "src/tools/spec.ts:459",
+      "source": "src/tools/spec.ts:468",
       "symbol": "inspect",
       "returns": "JSON envelope: `{ approach_id, scope, generated_at, approach,\nparams, violations, summary, execution_mode: \"execution_v0_4_0\" }`",
       "return_notes": [
@@ -2827,7 +2842,7 @@
         "inspect",
         "get_domain_guide"
       ],
-      "source": "src/tools/spec.ts:1383",
+      "source": "src/tools/spec.ts:1392",
       "symbol": "listAntiPatterns",
       "returns": "JSON: `{ total, count, next_cursor?, anti_patterns: UPGCuratedAntiPattern[] }`",
       "return_shape": "{ total, count, next_cursor?, anti_patterns: UPGCuratedAntiPattern[] }",
@@ -2928,7 +2943,7 @@
         "list_domains",
         "list_anti_patterns"
       ],
-      "source": "src/tools/spec.ts:1472",
+      "source": "src/tools/spec.ts:1481",
       "symbol": "listBenchmarks",
       "returns": "JSON: `{ kind, total, count, benchmarks: ... }`",
       "return_shape": "{ kind, total, count, benchmarks:... }",
@@ -2956,7 +2971,7 @@
         "list_portfolio_cross_edges",
         "migrate_cross_edges"
       ],
-      "source": "src/tools/spec.ts:1072",
+      "source": "src/tools/spec.ts:1081",
       "symbol": "listCrossEdgeTypes",
       "returns": "JSON: `{ count, types: readonly UPGCrossEdgeType[] }`",
       "return_shape": "{ count, types: readonly UPGCrossEdgeType[] }",
@@ -2984,7 +2999,7 @@
         "list_domains",
         "get_domain_guide"
       ],
-      "source": "src/tools/spec.ts:1860",
+      "source": "src/tools/spec.ts:1869",
       "symbol": "listDomainRings",
       "returns": "JSON: `{ rings: UPGDomainRing[], total: number }`",
       "return_shape": "{ rings: UPGDomainRing[], total: number }",
@@ -3019,7 +3034,7 @@
         "list_regions",
         "list_entity_types"
       ],
-      "source": "src/tools/spec.ts:711",
+      "source": "src/tools/spec.ts:720",
       "symbol": "listDomains",
       "returns": "JSON: `{ count, domains: Array<{ domain_id, anchor_entity, creation_sequence } | { domain_id, label, description, types, has_guide }> }`",
       "return_shape": "{ count, domains: Array<{ domain_id, anchor_entity, creation_sequence } | { domain_id, label, description, types, has_guide }> }",
@@ -3054,7 +3069,7 @@
         "list_edge_types",
         "validate_graph"
       ],
-      "source": "src/tools/spec.ts:1644",
+      "source": "src/tools/spec.ts:1653",
       "symbol": "listEdgeMigrations",
       "returns": "JSON: `{ migrations: [{ kind, from, to?, since }], total: number }`",
       "return_shape": "{ migrations: [{ kind, from, to?, since }], total: number }",
@@ -3093,7 +3108,7 @@
         "list_edge_migrations",
         "create_edge"
       ],
-      "source": "src/tools/spec.ts:858",
+      "source": "src/tools/spec.ts:867",
       "symbol": "listEdgeTypes",
       "returns": "JSON: `{ count, edges: Array<{ type, forward_verb, reverse_verb, classification, source_type, target_type }> }`",
       "return_shape": "{ count, edges: Array<{ type, forward_verb, reverse_verb, classification, source_type, target_type }> }",
@@ -3151,7 +3166,7 @@
         "list_type_migrations",
         "list_domains"
       ],
-      "source": "src/tools/spec.ts:1284",
+      "source": "src/tools/spec.ts:1293",
       "symbol": "listEntityTypes",
       "returns": "JSON: `{ total, count, next_cursor?, types: Array<EntityTypeMeta & { domain_id: string | null }> }`",
       "return_shape": "{ total, count, next_cursor?, types: Array<EntityTypeMeta & { domain_id: string | null }> }",
@@ -3178,7 +3193,7 @@
         "list_frameworks",
         "list_framework_structure_patterns"
       ],
-      "source": "src/tools/spec.ts:1816",
+      "source": "src/tools/spec.ts:1825",
       "symbol": "listFrameworkCategories",
       "returns": "JSON: `{ categories: string[], total: number }`",
       "return_shape": "{ categories: string[], total: number }",
@@ -3206,7 +3221,7 @@
         "list_framework_categories",
         "get_framework"
       ],
-      "source": "src/tools/spec.ts:1837",
+      "source": "src/tools/spec.ts:1846",
       "symbol": "listFrameworkStructurePatterns",
       "returns": "JSON: `{ patterns: string[], total: number }`",
       "return_shape": "{ patterns: string[], total: number }",
@@ -3249,7 +3264,7 @@
         "prioritise",
         "list_approaches"
       ],
-      "source": "src/tools/spec.ts:778",
+      "source": "src/tools/spec.ts:787",
       "symbol": "listFrameworks",
       "returns": "JSON: `{ total, count, next_cursor?, frameworks: UPGFramework[] }`",
       "return_shape": "{ total, count, next_cursor?, frameworks: UPGFramework[] }",
@@ -3278,7 +3293,7 @@
         "list_playbooks",
         "list_frameworks"
       ],
-      "source": "src/tools/spec.ts:1101",
+      "source": "src/tools/spec.ts:1110",
       "symbol": "listLenses",
       "returns": "JSON: `{ count, lenses: Array<{ id, name, description, icon, audience, perspective, framework_id?, playbook_id?, visible_domain_count, intelligence_prompt_count }> }`",
       "return_shape": "{ count, lenses: Array<{ id, name, description, icon, audience, perspective, framework_id?, playbook_id?, visible_domain_count, intelligence_prompt_count }> }",
@@ -3315,7 +3330,7 @@
         "list_entity_types",
         "get_entity_meta"
       ],
-      "source": "src/tools/spec.ts:1709",
+      "source": "src/tools/spec.ts:1718",
       "symbol": "listLifecycles",
       "returns": "JSON: `{ lifecycles, total, free_types: string[], planned_types: string[] }`",
       "return_shape": "{ lifecycles, total, free_types: string[], planned_types: string[] }",
@@ -3386,7 +3401,7 @@
         "list_domain_rings",
         "create_product"
       ],
-      "source": "src/tools/spec.ts:1580",
+      "source": "src/tools/spec.ts:1589",
       "symbol": "listProductStages",
       "returns": "JSON: `{ count, stages: readonly UPGProductStage[] }`",
       "return_shape": "{ count, stages: readonly UPGProductStage[] }",
@@ -3415,7 +3430,7 @@
         "list_domains",
         "list_playbooks"
       ],
-      "source": "src/tools/spec.ts:904",
+      "source": "src/tools/spec.ts:913",
       "symbol": "listRegions",
       "returns": "JSON: `{ count, regions: Array<{ id, label, order, shape, mental_model, anchor_type, composes_atomic_domains, entity_count, intra_edge_count, boundary_edge_count }> }`",
       "return_shape": "{ count, regions: Array<{ id, label, order, shape, mental_model, anchor_type, composes_atomic_domains, entity_count, intra_edge_count, boundary_edge_count }> }",
@@ -3442,7 +3457,7 @@
         "get_scale",
         "get_entity_schema"
       ],
-      "source": "src/tools/spec.ts:1782",
+      "source": "src/tools/spec.ts:1791",
       "symbol": "listScales",
       "returns": "JSON: `{ scales: UPGScaleDefinition[], total: number }`",
       "return_shape": "{ scales: UPGScaleDefinition[], total: number }",
@@ -3471,7 +3486,7 @@
         "migrate_type",
         "validate_graph"
       ],
-      "source": "src/tools/spec.ts:1681",
+      "source": "src/tools/spec.ts:1690",
       "symbol": "listSplitMigrations",
       "returns": "JSON: `{ splits: [...], total: number }`",
       "return_shape": "{ splits: [...], total: number }",
@@ -3508,7 +3523,7 @@
         "list_entity_types",
         "get_entity_meta"
       ],
-      "source": "src/tools/spec.ts:1167",
+      "source": "src/tools/spec.ts:1176",
       "symbol": "listTypeLabels",
       "returns": "JSON: `{ total, count, next_cursor?, labels: UPGTypeLabel[] }`",
       "return_shape": "{ total, count, next_cursor?, labels: UPGTypeLabel[] }",
@@ -3544,7 +3559,7 @@
         "validate_graph",
         "list_entity_types"
       ],
-      "source": "src/tools/spec.ts:1613",
+      "source": "src/tools/spec.ts:1622",
       "symbol": "listTypeMigrations",
       "returns": "JSON: `{ migrations: [{ from, to, since }], total: number }`",
       "return_shape": "{ migrations: [{ from, to, since }], total: number }",
@@ -3552,14 +3567,18 @@
     },
     {
       "name": "plan",
-      "description": "Plan approach: path of arrival to \"what should I build next?\". Returns the Plan record + invocation params wrapped in `{ approach_id, scope, generated_at, approach, params }`. The LLM consumes `signature_hint` and synthesises `{ missing_entities, coverage_score }` against the live graph. Optional `region` narrows scope.",
+      "description": "Plan approach: path of arrival to \"what should I build next?\". Returns the Plan record + invocation params wrapped in `{ approach_id, scope, generated_at, approach, params }`. The LLM consumes `signature_hint` and synthesises `{ missing_entities, coverage_score }` against the live graph. Optional `region` narrows scope; omit `region` to scope to the product's ACTIVE regions; pass `exhaustive:true` to score the full type universe (UPG-601).",
       "domain": "spec",
       "inputSchema": {
         "type": "object",
         "properties": {
           "region": {
             "type": "string",
-            "description": "Optional UPGRegionId. Narrows planning scope to a single region (e.g. \"users_needs\", \"business_gtm_growth\"). Omit for whole-graph planning."
+            "description": "Optional UPGRegionId or atomic-domain id. Narrows planning scope to a single region (e.g. \"users_needs\", \"business_gtm_growth\"). Omit to scope to the product's active regions."
+          },
+          "exhaustive": {
+            "type": "boolean",
+            "description": "If true, score against the entire 312-type universe (every domain creation sequence). Off by default; whole-universe gap scoring is noisy for a focused product. Only applies when `region` is omitted."
           }
         }
       },
@@ -3623,7 +3642,7 @@
         "plan",
         "trace"
       ],
-      "source": "src/tools/spec.ts:518",
+      "source": "src/tools/spec.ts:527",
       "symbol": "prioritise",
       "returns": "JSON envelope: `{ approach_id, scope, generated_at, approach,\nparams, framework_resolved, ranked?, required_properties?,\nhint?, execution_mode }`. Execution mode is `\"execution_v0_4_0\"` when\nthe framework has an expression, `\"definition_lookup_v0_4_0\"` otherwise.",
       "return_notes": [
@@ -3675,7 +3694,7 @@
         "plan",
         "get_anti_pattern"
       ],
-      "source": "src/tools/spec.ts:661",
+      "source": "src/tools/spec.ts:670",
       "symbol": "reflect",
       "returns": "JSON envelope: `{ approach_id, scope, generated_at, approach,\nparams, prompts, execution_mode: \"execution_v0_4_0\" }`",
       "return_notes": [
@@ -3723,7 +3742,7 @@
         "create_edge",
         "trace"
       ],
-      "source": "src/tools/spec.ts:1040",
+      "source": "src/tools/spec.ts:1049",
       "symbol": "resolveEdgeForPair",
       "returns": "JSON: `{ source_type, target_type, edge_type: string | null,\nanchor_hint?, alternate_anchors?, adjacent_edges? }`",
       "return_shape": "{ source_type, target_type, edge_type: string | null, anchor_hint?, alternate_anchors?, adjacent_edges? }",
@@ -3782,7 +3801,7 @@
         "plan",
         "prioritise"
       ],
-      "source": "src/tools/spec.ts:598",
+      "source": "src/tools/spec.ts:607",
       "symbol": "trace",
       "returns": "JSON envelope: `{ approach_id, scope, generated_at, approach,\nparams, trail, reached, error?, halted_at_depth?,\nexecution_mode: \"execution_v0_4_0\" }`",
       "return_notes": [
@@ -3999,7 +4018,7 @@
       ],
       "warnings": [],
       "see": [],
-      "source": "src/tools/skills.ts:191",
+      "source": "src/tools/skills.ts:207",
       "symbol": "skillAudit",
       "returns": "`{ skills: SkillAuditRecord[] }`",
       "return_shape": "{ skills: SkillAuditRecord[] }",