2d:I[403991,["/_next/static/immutable/chunks/1esd38fookkju.js","/_next/static/immutable/chunks/1gpydmb_p35rp.js","/_next/static/immutable/chunks/31rzrsafijs90.js","/_next/static/immutable/chunks/437t2nz9idvsk.js","/_next/static/immutable/chunks/3v5v0ho4k5az6.js","/_next/static/immutable/chunks/0zcpf7_7g0nu0.js","/_next/static/immutable/chunks/3piti6u5aun-z.js","/_next/static/immutable/chunks/3vmk_yjqfy1f7.js","/_next/static/immutable/chunks/1kolr0mnrqme4.js","/_next/static/immutable/chunks/1qsf6bqbee_mn.js","/_next/static/immutable/chunks/0r8ovu4lq4cbt.js"],"DocsShell"] 3e:I[290340,["/_next/static/immutable/chunks/1esd38fookkju.js","/_next/static/immutable/chunks/1gpydmb_p35rp.js","/_next/static/immutable/chunks/31rzrsafijs90.js","/_next/static/immutable/chunks/437t2nz9idvsk.js","/_next/static/immutable/chunks/3v5v0ho4k5az6.js","/_next/static/immutable/chunks/0zcpf7_7g0nu0.js","/_next/static/immutable/chunks/3piti6u5aun-z.js"],"GlobalCommandPaletteLazy"] 2e:T56f,{ "product": { "title": "Notion (SATURATED test graph)", "stage": "concept" }, "counts": { "total_nodes": 2054, "total_edges": 3216, "by_type": { "product": 13, "capability": 20, "value_stream": 3, "decision": 13, "evidence": 10, "assumption": 30, "outcome": 6, "document": 9, "objective": 6, "key_result": 14, "design_component": 15, "hypothesis": 6, "experiment": 5, "experiment_plan": 13, "job": 10, "bounded_context": 13, "initiative": 11, "strategic_pillar": 6, "test_plan": 8, "screen": 15, "experiment_run": 18, "design_system": 4, "team": 1, "compliance_requirement": 5, "workspace": 3, "epic": 4, "bug": 6, "task": 3, "feature_area": 3, "mission": 2, "desired_outcome": 4, "model_comparison": 3, "agent_session": 3, "learning": 17, "research_plan": 6, "constraint": 3, "stakeholder": 10, "feature": 12, "security_review": 8, "metric": 23, "person": 215, "technical_debt_item": 12, "risk": 9, "service": 11, "opportunity": 7, "solution": 11, "feasibility_study": 3, "design_sprint": 3, "prototype": 8, "design_concept": 7, "vision": 1, … (truncated)2f:T584,## Notion (SATURATED test graph) Stage: concept Lens: product ### 🧭 Product Lens - Personas: 4 - Outcomes: 6 - Hypotheses: 6 (0 validated) ### Graph Stats - Nodes: 2054 - Edges: 3216 - Entity types: 312 ### Entities by Type - Person (`person`): 215 - Journey Step (`journey_step`): 53 - Test Case (`test_case`): 48 - Screen State (`screen_state`): 36 - Assumption (`assumption`): 30 - Journey Phase (`journey_phase`): 28 - Journey Action (`journey_action`): 28 - Interaction Spec (`interaction_spec`): 28 - Metric (`metric`): 23 - Test Result (`test_result`): 23 - Capability (`capability`): 20 - Participant (`participant`): 19 - Regression Test (`regression_test`): 19 - Experiment Run (`experiment_run`): 18 - Alert Rule (`alert_rule`): 18 - Validated Learning (`learning`): 17 - Observation (`observation`): 17 - Survey Response (`survey_response`): 17 - Annotation (`annotation`): 17 - Vulnerability (`vulnerability`): 16 - Design Component (`design_component`): 15 - Screen (`screen`): 15 - Monitor (`monitor`): 15 - Research Question (`research_question`): 15 - Service Level Indicator (`service_level_indicator`): 15 - Error Budget (`error_budget`): 15 - Key Result (`key_result`): 14 - Product (`product`): 13 - Decision (`decision`): 13 - Experiment Plan (`experiment_plan`): 13 - Bounded Context (`bounded_context`): 13 - Insight (`insight`): 13 - Theme (`theme`): 13 - Feature … (truncated)30:T57f,{ "duplicates": [ { "title": "Cap AI inference cost at $0.18 / MAU / month", "type": "decision", "count": 2, "ids": [ "e4078a2d-ff4f-4047-98e7-7d6556109eb0", "afd2234f-3c50-487d-8507-95762895c7dd" ] }, { "title": "AI Q&A acceptance rate ≥ 70%", "type": "key_result", "count": 2, "ids": [ "6d6991c4-36f2-46d4-bd1a-cccc87313751", "eee73bb6-52ac-47eb-b007-d578d17870cf" ] }, { "title": "AI-native, not AI-bolted-on", "type": "strategic_pillar", "count": 2, "ids": [ "620af368-90b8-4d26-8479-1359826af5e1", "d8665db0-5210-4354-a4ab-391ae8a843a2" ] }, { "title": "Notion Calendar", "type": "product", "count": 2, "ids": [ "c355f3ea-1e9f-45a1-aedc-a7adf66050e1", "4d5b21d6-66b1-4663-add8-2b24a10848ea" ] }, { "title": "One workspace, every team", "type": "strategic_pillar", "count": 2, "ids": [ "4c23a9dc-a4b3-4c80-83ee-10e35b839c26", "4d1b0619-b5eb-4d5d-a465-b98bc164a203" ] }, { "title": "react", "type": "library_dependency", "count": 2, "ids": [ "abe04949-9bc9-48e7-8ff8-8023a6c87b11", "4a04fd43-2451-4492-9647-c883545af3c2" ] }, { "title": "AI-native vs … (truncated)31:T56f,{ "deleted_node_id": "ec3d5479-4947-4bd9-9e77-b5ee01beb851", "deleted_node_title": "Notion (SATURATED test graph)", "deleted_edge_ids": [ "1d645a2e-391b-4bc7-b0de-e15691c8a7d6", "b4a77a49-7d28-4926-831f-464574d927fe", "1ee422bc-64c1-4da1-b797-62e4d206b79c", "013ac760-b99a-423e-bb94-700acda058c0", "e72fc432-9b4e-443d-b0c3-619b4a1cff62", "1dd3f0dd-4185-43b0-bbf5-a4685099b22a", "e1002543-96a9-4d6c-b708-b7c91055f391", "f080a424-9da2-499e-98b0-b9219493690c", "66237b58-5c5f-4ce1-9f69-13338b363d51", "95795513-430f-408c-b4ab-ea08a7744939", "5db91b8d-0d36-40fa-861d-d528ac22c1f5", "f986bd5c-19a6-4c97-86b7-c07555c37495", "2ace745e-05a9-4d2c-9683-343a52ae6e64", "6e2abc91-7066-4310-9e17-3441d81c4e63", "f0a45c02-54e4-4cd8-8752-d265fa1957bb", "10dc7124-99e0-4851-9268-5c5896e4e365", "02552438-55e4-4bac-957e-c2d451a70eee", "16308874-0ebc-4303-a2ef-ea1e0a987a8f", "9ece5292-9874-4b2e-a797-15f542e63467", "372bf1ec-da83-4ce0-97d6-484374a74c67", "0fe88c72-7bca-4b65-8f2e-46a7b17a5dde", "3fc58a2e-79bf-476c-9092-3f658d03536b", "e0172dc5-4d03-41d7-b615-1c18b6cbfff7", "45920303-286d-467e-a7c4-5afdce1374ba", "cfb6d93c-ad4c-4565-971b-df5d5d6da734", "d3919111-98e7-409a-b212-0bf453aae0c4", "e149cd50-8fc1-40cc-8a8e-5fab20daa8c9", "b089a933-a5b7-4a5c-97f2-abfe73d91614", … (truncated)32:T561,{ "node": { "id": "ec3d5479-4947-4bd9-9e77-b5ee01beb851", "type": "product", "title": "Notion (SATURATED test graph)", "slug": "notion-saturated-test-graph", "description": "Canonical SATURATED test graph for UCS / GPE / .upg-loader / MCP test surfaces. Fictional Notion modelled as a thinly-disguised version of the real Notion. Built via parallel MCP-driven domain waves. Exported as `.upg/notion-saturated.upg` in `the-product-creator` repo at `mr-data/upg-saturated-graph` branch (PR #1532).", "properties": { "stage": "idea", "health_status": "off_track", "url": "url sample 10", "logo_url": "logo url sample 69", "launched_at": "2026-12-13T09:00:00Z" } }, "edges_out": [ { "id": "1d645a2e-391b-4bc7-b0de-e15691c8a7d6", "source": "ec3d5479-4947-4bd9-9e77-b5ee01beb851", "target": "dce7a627-2ef4-4cb7-a63a-5044a8ad1802", "type": "product_serves_account", "target_title": "Acme Corp Enterprise Workspace" }, { "id": "b4a77a49-7d28-4926-831f-464574d927fe", "source": "ec3d5479-4947-4bd9-9e77-b5ee01beb851", "target": "2a3ab02e-4110-43f2-848b-a1ebeedb6fa9", "type": "product_shares_metric_with_product", "target_title": "Notion Mail (preview)" }, { "id": "1ee422bc-64c1-4da1-b797-62e4d206b79c", "source": … (truncated)33:T568,{ "nodes": [ { "node": { "id": "ec3d5479-4947-4bd9-9e77-b5ee01beb851", "type": "product", "title": "Notion (SATURATED test graph)", "slug": "notion-saturated-test-graph" }, "edges_out": [ { "id": "1d645a2e-391b-4bc7-b0de-e15691c8a7d6", "type": "product_serves_account", "source": "ec3d5479-4947-4bd9-9e77-b5ee01beb851", "target": "dce7a627-2ef4-4cb7-a63a-5044a8ad1802" }, { "id": "b4a77a49-7d28-4926-831f-464574d927fe", "type": "product_shares_metric_with_product", "source": "ec3d5479-4947-4bd9-9e77-b5ee01beb851", "target": "2a3ab02e-4110-43f2-848b-a1ebeedb6fa9" }, { "id": "1ee422bc-64c1-4da1-b797-62e4d206b79c", "type": "product_ships_via_release", "source": "ec3d5479-4947-4bd9-9e77-b5ee01beb851", "target": "024aa3ef-d8e0-4791-8979-c8a9f2a69618" }, { "id": "013ac760-b99a-423e-bb94-700acda058c0", "type": "product_sold_via_pipeline_sales", "source": "ec3d5479-4947-4bd9-9e77-b5ee01beb851", "target": "8737db50-a948-4225-9fa6-7a54ca4ca374" }, { "id": "e72fc432-9b4e-443d-b0c3-619b4a1cff62", "type": "product_stored_in_code_repository", "source": … (truncated)34:T583,{ "nodes": [ { "id": "ec3d5479-4947-4bd9-9e77-b5ee01beb851", "type": "product", "title": "Notion (SATURATED test graph)" }, { "id": "1c051617-6cb7-4a59-b0a1-7779f404145b", "type": "capability", "title": "Real-time multi-cursor collaboration" }, { "id": "478852b7-ca46-4bdd-85fa-cd2334b9565d", "type": "capability", "title": "Block-based composable editing" }, { "id": "0904ef52-cc7e-4bcd-9c9d-0072beb28878", "type": "capability", "title": "Tree-inherited permissions" }, { "id": "f8ce72c1-af1a-48ba-945e-72e08c5aeeb5", "type": "capability", "title": "Permission-aware AI grounding" }, { "id": "4dffea49-4122-4599-858c-f3c2f0c3e5c4", "type": "value_stream", "title": "Personal → Team conversion stream" }, { "id": "9d03304e-8beb-4734-845b-1bc3c07ce20c", "type": "decision", "title": "Build Frankfurt region (not partner)" }, { "id": "6ea52729-4462-4fc0-b2a1-0c7e2c0362b2", "type": "evidence", "title": "Self-hostable waitlist: 1.2k signups, 0% paid intent" }, { "id": "3f1c1804-b33b-4b1f-9094-c91cc8957912", "type": "assumption", "title": "Teams prefer one tool over a stack of four" }, { "id": "6719fce7-61e7-44df-b6cf-92f7c7312554", "type": … (truncated)35:T57b,{ "top_level_renames": [], "lifted_properties": [ { "id": "ec3d5479-4947-4bd9-9e77-b5ee01beb851", "from_property": "stage", "to": "status", "value_changed": true }, { "id": "3f1c1804-b33b-4b1f-9094-c91cc8957912", "from_property": "validation_status", "to": "status", "value_changed": false }, { "id": "6719fce7-61e7-44df-b6cf-92f7c7312554", "from_property": "validation_status", "to": "status", "value_changed": false }, { "id": "7b22f5f3-b344-4e49-8d5a-35cf9087dc6c", "from_property": "validation_status", "to": "status", "value_changed": false }, { "id": "c969753e-8e7b-4c14-9c99-acba5b1862be", "from_property": "validation_status", "to": "status", "value_changed": false }, { "id": "6bc0cfd3-29a2-47b5-8f2e-746ded26351f", "from_property": "validation_status", "to": "status", "value_changed": false }, { "id": "2326222c-cfab-4793-bf58-818039939753", "from_property": "bug_status", "to": "status", "value_changed": false }, { "id": "1373c0c9-4aba-49fc-8a26-bbc78661ca5a", "from_property": "bug_status", "to": "status", "value_changed": false }, { "id": "655c81dc-f827-45e3-b871-d9c78e569076", "from_property": … (truncated)36:T582,{ "results": [ { "id": "ec3d5479-4947-4bd9-9e77-b5ee01beb851", "type": "product", "title": "Notion (SATURATED test graph)", "match_field": "title", "score": 3 }, { "id": "7f5ae55d-68c5-4ca7-9e4c-b5e9d4dd32a5", "type": "design_system", "title": "Notion Design System · Block-primitive foundation", "match_field": "title", "score": 3 }, { "id": "24b43d57-48a4-4499-bac7-e38f3eb7bae4", "type": "design_system", "title": "Notion Design System · Database views", "match_field": "title", "score": 3 }, { "id": "6700fd68-27be-4b21-9186-82e490bebf33", "type": "workspace", "title": "Notion Internal · Architecture Decisions workspace", "match_field": "title", "score": 3 }, { "id": "c355f3ea-1e9f-45a1-aedc-a7adf66050e1", "type": "product", "title": "Notion Calendar", "match_field": "title", "score": 3 }, { "id": "2a3ab02e-4110-43f2-848b-a1ebeedb6fa9", "type": "product", "title": "Notion Mail (preview)", "match_field": "title", "score": 3 }, { "id": "e83e8cec-8f00-4dd5-b36a-c5e143f7e911", "type": "design_system", "title": "Notion Design System · Mobile parity tokens", "match_field": "title", "score": 3 }, { "id": … (truncated)37:T57a,{ "edges": [ { "id": "44012ce7-99d5-4a96-b930-c8f7b1d6b45f", "source": "3197ef3e-4ffc-48cf-9903-59db8eed94f8", "target": "a719b36e-97a9-4927-b27c-f95f0da05d8c", "type": "opportunity_drives_solution" }, { "id": "d7aaba50-cf2e-4a46-ac1b-15e61aa49212", "source": "d8c4bbfb-669d-4e29-b75e-fba353455255", "target": "d272290a-7006-4372-b4f4-0deb59161d39", "type": "opportunity_drives_solution" }, { "id": "4c3e592e-61f3-4d7d-a7c9-486fa3a5cb6d", "source": "88766ab4-a3e7-40be-bffa-469882937e47", "target": "d8b467ef-9b3f-4d52-994e-ada00327f73e", "type": "opportunity_drives_solution" }, { "id": "676dcc0e-7fa6-46c0-b0d3-0c4cc0e10982", "source": "b5df3308-dc29-4958-aae7-123bc616217d", "target": "425b4721-6c79-4da7-9b94-a66f97d308ed", "type": "opportunity_drives_solution" }, { "id": "6e4b2226-2d47-4e3a-ba14-4291a2e8896b", "source": "3197ef3e-4ffc-48cf-9903-59db8eed94f8", "target": "b17e4f0e-5ed2-4170-a754-b17cafb42b21", "type": "opportunity_assessed_by_feasibility_study" }, { "id": "5101bf03-3d91-4da1-b3e8-33363a117227", "source": "87d8086c-ac51-4021-882a-7728c394f6ab", "target": "dade8cd7-ffae-4800-9f72-c8767520a21c", "type": "opportunity_assessed_by_feasibility_study" }, { "id": … (truncated)38:T580,{ "changes": [ { "action": "create", "entity": "node", "id": "n_lsZ0CjPWcrZ6Hhw8", "type": "person", "title": "Example node", "timestamp": "2026-05-29T20:13:19.656Z" }, { "action": "update", "entity": "node", "id": "ec3d5479-4947-4bd9-9e77-b5ee01beb851", "type": "product", "title": "Notion (SATURATED test graph)", "timestamp": "2026-05-29T20:13:19.656Z" }, { "action": "delete", "entity": "node", "id": "ec3d5479-4947-4bd9-9e77-b5ee01beb851", "type": "product", "title": "Notion (SATURATED test graph)", "timestamp": "2026-05-29T20:13:19.658Z" }, { "action": "delete", "entity": "edge", "id": "1d645a2e-391b-4bc7-b0de-e15691c8a7d6", "type": "cascade", "timestamp": "2026-05-29T20:13:19.658Z" }, { "action": "delete", "entity": "edge", "id": "b4a77a49-7d28-4926-831f-464574d927fe", "type": "cascade", "timestamp": "2026-05-29T20:13:19.658Z" }, { "action": "delete", "entity": "edge", "id": "1ee422bc-64c1-4da1-b797-62e4d206b79c", "type": "cascade", "timestamp": "2026-05-29T20:13:19.658Z" }, { "action": "delete", "entity": "edge", "id": "013ac760-b99a-423e-bb94-700acda058c0", "type": "cascade", "timestamp": … (truncated)39:T4b1,JSON: `{ products: Array<{ product_id, file, title, valid, structurally_valid, drift, anti_patterns: { high, medium, low }, top_violations? }>, rollup: { products, valid, invalid, structurally_valid, anti_pattern_violations, all_valid }, errored_products?, unmatched_scope? }`. `severity` filters anti-patterns; `include_violations: false` drops the per-product `top_violations` list. When the portfolio has a canonical registry, a `registry_drift` block reports `instance_of` edges that point at a missing canonical, dangle, mismatch type, or were renamed off-canon (canonical-registry initiative, Phase 3). When the portfolio uses the foundations tier (a registry specification / primitive or a foundations cross-edge), a `portfolio_anti_patterns` block reports the portfolio-scoped (`scope: 'portfolio'`) anti-patterns: specification-without-implementer, primitive-scattered-without-canonical, product-reimplements-specification (0.9.13), operating-function-without-org-link (0.17.0), and duplicate-key-across-products (0.34.0). The last also makes the block relevant on its own: a portfolio whose products mint citable keys gets the report even with no foundations tier and no operating functions.3a:T4a0,Create or republish a composition (a named, published view) at `slug`, writing the node and its `composition_focuses_node` edges in ONE atomic commit. Use this instead of create_node/update_node for any composition write, because `rev` is DERIVED: it is re-read inside the write and incremented only on a transition into `published`, so update_node({ properties: { rev: N } }) writes whatever number you hold and is silently wrong. Reads stay generic: list_nodes({ type: "composition" }) enumerates views and `status` filters them by lifecycle, and the id IS the slug so get_node({ id: slug }) returns the view and its focus edges together. Pass `rev` to make the write conditional on the revision you last read; a mismatch refuses with `stored_rev` and leaves the file byte-unchanged rather than overwriting a print you never saw. Omitting `members` PRESERVES the stored arrangement (so withdrawing or renaming a view keeps what it looked like) while `[]` clears it. A `focus_node_ids` entry that does not resolve here is dropped rather than written as a dangling edge. To withdraw a view, write lifecycle "archived" rather than deleting it, so old links resolve to something honest.3b:T571,{ "type": "person", "domain": { "id": "team_org", "label": "Team & Organisation" }, "expected_properties": { "email": { "type": "string", "description": "Primary contact email. Stable identifier for de-duplication." }, "role_title": { "type": "string", "description": "Free-text job title. Distinct from the structured `role` entity." }, "time_zone": { "type": "string", "description": "IANA time zone (e.g. \"Europe/Berlin\"). Useful for capacity / on-call planning." } }, "edges_out": [], "edges_in": [ { "edge_type": "node_owned_by_person", "source_type": "node", "reverse_verb": "owns" } ], "domain_guide": { "anchor_entity": "team", "creation_sequence": [ "team", "role", "stakeholder", "person", "team_okr", "retrospective", "dependency", "department", "skill", "ceremony", "capacity_plan" ], "position_in_sequence": 3, "anti_patterns": [ { "description": "Teams without OKRs: every team needs clear goals" }, { "description": "Dependencies without both teams linked: a dependency must connect blocker and blocked" }, { "description": "Retrospectives without action items: reflection without action is just venting" } ] } }3c:T582,{ "valid": false, "summary": { "entity_drift": 0, "edge_drift": 0, "top_level_drift": 0, "lifecycle_drift": 0, "self_referential": 0, "property_drift": 164, "total_nodes": 2054, "total_edges": 3216, "spec_version": "0.7.3", "scope": "all", "limit": 100, "anti_pattern_violations_high": 0, "anti_pattern_violations_medium": 1, "anti_pattern_violations_low": 0, "edge_type_pair_drift": 100, "graph_topology_self_loops": 0, "property_type_drift": 100 }, "_hash": "c0f701e327319f2e", "entity_drift": [], "edge_drift": [], "top_level_drift": [], "lifecycle_drift": [], "self_referential": [], "property_drift": [ { "id": "ec3d5479-4947-4bd9-9e77-b5ee01beb851", "type": "product", "property": "stage", "via": "UPG_PROPERTY_MIGRATIONS['0.2.13']" }, { "id": "3f1c1804-b33b-4b1f-9094-c91cc8957912", "type": "assumption", "property": "validation_status", "via": "UPG_PROPERTY_MIGRATIONS['0.5.0']" }, { "id": "6719fce7-61e7-44df-b6cf-92f7c7312554", "type": "assumption", "property": "validation_status", "via": "UPG_PROPERTY_MIGRATIONS['0.5.0']" }, { "id": "7b22f5f3-b344-4e49-8d5a-35cf9087dc6c", "type": "assumption", "property": "validation_status", "via": "UPG_PROPERTY_MIGRATIONS['0.5.0']" … (truncated)10:["$","$L2d",null,{"domains":[{"id":"accessibility","name":"Accessibility","color":"#2dd4bf","description":"The inclusion. Standards, guidelines, audits, issues, and design annotations.","entityIds":["a11y_annotation","a11y_audit","a11y_guideline","a11y_issue","a11y_standard"]},{"id":"ai","name":"AI & Machine Learning","color":"#7c3aed","description":"The intelligence layer. AI models, prompts, evaluations, guardrails, and cost tracking.","entityIds":["ai_cost_tracker","ai_guardrail","ai_model","eval_benchmark","eval_run","hallucination_report","model_comparison","prompt_template","prompt_version"]},{"id":"brand","name":"Brand Identity","color":"#ec4899","description":"The identity. Visual language, typography, voice, and logo system.","entityIds":["brand_asset","brand_colour","brand_identity","brand_typography","brand_voice"]},{"id":"business_model","name":"Business Model","color":"#10b981","description":"The economics. Value props, revenue streams, pricing, costs, and partnerships.","entityIds":["business_model","cost_structure","customer_relationship","distribution_channel","key_activity","key_resource","partnership","revenue_stream","unit_economics","value_proposition"]},{"id":"compliance","name":"Compliance","color":"#64748b","description":"The guardrails. Compliance frameworks, requirements, risks, and audit policies.","entityIds":["audit_log_policy","compliance_requirement","data_contract","compliance_framework","risk","security_audit"]},{"id":"content","name":"Content & Knowledge","color":"#7c3aed","description":"The record. Content pieces, KB articles, prompt templates, and changelogs.","entityIds":["content_calendar","content_piece","content_theme","documentation_template","knowledge_base_article"]},{"id":"education","name":"Customer Education","color":"#f59e0b","description":"The classroom. Programs, tutorials, walkthroughs, webinars, and certifications.","entityIds":["certification","education_program","help_video","learning_path","tutorial","walkthrough","webinar"]},{"id":"feedback","name":"Customer Feedback","color":"#14b8a6","description":"The listening post. Feedback programs, feature requests, NPS campaigns, and beta programs.","entityIds":["beta_program","feature_request","feedback_program","feedback_theme","feedback_vote","nps_campaign","user_advisory_board"]},{"id":"customer_success","name":"Customer Success","color":"#14b8a6","description":"The care. Support tickets, health scores, NPS, onboarding, and playbooks.","entityIds":["churn_reason","customer_feedback","customer_health_score","customer_journey_stage","playbook","service_blueprint","success_milestone","support_ticket","touchpoint"]},{"id":"data_analytics","name":"Data & Analytics","color":"#0ea5e9","description":"The instruments. Data sources, pipelines, dashboards, lineage, and quality rules.","entityIds":["dashboard","data_domain","data_lineage","data_model","data_pipeline","data_product","data_quality_rule","data_source","event_schema","glossary_term","report"]},{"id":"design_system","name":"Design System","color":"#2dd4bf","description":"The reusable building blocks. Components, tokens, patterns, and guidelines.","entityIds":["annotation","design_component","design_guideline","design_pattern","design_system","design_token","interaction_spec"]},{"id":"devops","name":"DevOps & Platform","color":"#06b6d4","description":"The reliability. SLOs, incidents, runbooks, CI pipelines, and on-call rotations.","entityIds":["alert_rule","ci_pipeline","error_budget","incident","infrastructure_component","monitor","on_call_rotation","postmortem","release_strategy","runbook"]},{"id":"discovery","name":"Discovery","color":"#22c55e","description":"The gaps. Opportunities validated, solutions proposed, sprints run.","entityIds":["design_sprint","feasibility_study","opportunity","solution"]},{"id":"engineering","name":"Engineering","color":"#6366f1","description":"The machinery. Bounded contexts, services, APIs, DDD patterns, and deployments.","entityIds":["api_contract","api_endpoint","aggregate","bounded_context","build_artifact","code_repository","command","data_flow","database_schema","deployment","domain_entity","domain_event","external_api","feature_flag","integration_pattern","library_dependency","queue_topic","read_model","service","technical_debt_item","value_object"]},{"id":"ux_design","name":"Experience Design","color":"#2dd4bf","description":"The craft. Journeys, concepts, prototypes, components, tokens, and brand identity.","entityIds":["design_concept","journey_step","prototype","screen","screen_state","user_flow","user_journey","wireframe"]},{"id":"go_to_market","name":"Go-To-Market","color":"#f43f5e","description":"The launch playbook. GTM strategy, ICP, positioning, messaging, and sales.","entityIds":["competitive_battle_card","content_strategy","demand_gen_program","gtm_strategy","ideal_customer_profile","launch","messaging","objection","positioning","proof_point","rebuttal","sales_motion","territory"]},{"id":"growth","name":"Growth","color":"#fb923c","description":"The engine. North star metrics, funnels, cohorts, loops, and attribution.","entityIds":["acquisition_channel","attribution_model","cohort","funnel","funnel_step","growth_loop","variant"]},{"id":"legal","name":"Legal","color":"#64748b","description":"The structure. Legal entities, IP, contracts, and privacy policies.","entityIds":["contract","contract_clause","ip_asset","legal_entity","privacy_policy"]},{"id":"localisation","name":"Localisation","color":"#8b5cf6","description":"The globe. Locales, translations, cultural adaptations, and regional pricing.","entityIds":["cultural_adaptation","locale","locale_config","regional_pricing","translation_bundle","translation_key"]},{"id":"market_intelligence","name":"Market Intelligence","color":"#f43f5e","description":"The landscape. Competitors, segments, features, and shifting trends.","entityIds":["competitive_analysis","competitor","competitor_feature","market_segment","market_trend"]},{"id":"marketing","name":"Marketing","color":"#ec4899","description":"The megaphone. Strategies, channels, campaigns, SEO, social, and events.","entityIds":["ad_creative","marketing_campaign_plan","community_initiative","email_sequence","event","marketing_channel","marketing_strategy","press_release","seo_keyword","social_post"]},{"id":"ecosystem","name":"Partners & Ecosystem","color":"#6366f1","description":"The network. Partner programs, tiers, API ecosystems, and marketplace listings.","entityIds":["api_ecosystem","developer_portal","integration_partner","marketplace_listing","partner_program","partner_revenue_share","partner_tier"]},{"id":"portfolio","name":"Portfolio","color":"#6366f1","description":"The organisation. Products, portfolios, product areas, and the top-level container.","entityIds":["organization","portfolio","product_area"]},{"id":"pricing","name":"Pricing & Packaging","color":"#f97316","description":"The monetisation lab. Pricing strategies, experiments, packages, and paywalls.","entityIds":["discount_strategy","paywall","pricing_strategy","pricing_tier","trial_config"]},{"id":"product_spec","name":"Product Specification","color":"#8b5cf6","description":"The blueprint. Features, epics, stories, roadmaps, and releases.","entityIds":["acceptance_criterion","bug","changelog","epic","feature","release","roadmap","roadmap_item","task","theme"]},{"id":"program_mgmt","name":"Program Management","color":"#d946ef","description":"The coordination. Programs, projects, milestones, risks, and deliverables.","entityIds":["change_request","deliverable","milestone","program","project","resource_allocation","risk_register","status_report"]},{"id":"testing","name":"Quality Assurance","color":"#10b981","description":"The quality gate. Test suites, test cases, QA sessions, and coverage reports.","entityIds":["qa_session","regression_test","test_case","test_coverage_report","test_environment","test_suite"]},{"id":"sales","name":"Sales & Revenue","color":"#84cc16","description":"The pipeline. Accounts, deals, subscriptions, invoices, and forecasts.","entityIds":["account","contact","deal","forecast","invoice","lead","pipeline_stage","quote_document","pipeline_sales","subscription"]},{"id":"security","name":"Security","color":"#ef4444","description":"The shield. Threat models, vulnerabilities, controls, and access policies.","entityIds":["access_policy","data_classification","penetration_test","security_control","security_policy","security_review","threat","threat_model","vulnerability"]},{"id":"strategy","name":"Strategy","color":"#f97316","description":"The north star. Vision, mission, objectives, and the pillars that guide every decision.","entityIds":["assumption","capability","decision","initiative","key_result","metric","mission","objective","outcome","product","strategic_pillar","strategic_theme","value_stream","vision"]},{"id":"team_org","name":"Team & Organisation","color":"#f59e0b","description":"The people. Teams, departments, roles, OKRs, retros, and ceremonies.","entityIds":["capacity_plan","ceremony","department","dependency","retrospective","role","skill","stakeholder","team","team_okr"]},{"id":"user","name":"User","color":"#a974ee","description":"The humans. Who they are, what they're trying to do, what hurts, what they need.","entityIds":["desired_outcome","job_step","need","persona","switching_cost"]},{"id":"user_research","name":"User Research","color":"#38bdf8","description":"The evidence. Studies, participants, observations, clusters, and synthesised insights.","entityIds":["affinity_cluster","insight","interview_guide","observation","participant","quote","research_question","research_study","survey_response"]},{"id":"validation","name":"Validation","color":"#eab308","description":"The proof. Hypotheses tested through experiments, producing learnings that compound.","entityIds":["evidence","experiment","hypothesis","learning","research_plan","test_plan"]},{"id":"automation","name":"Workflows & Agents","color":"#0ea5e9","description":"The automation engine. Workflow templates, agent definitions, review gates, and approvals.","entityIds":["agent_definition","agent_hook","agent_session","agent_skill","approval_record","review_gate","workflow_artifact","workflow_run","workflow_template"]}],"entities":[{"id":"a11y_annotation","label":"A11y Annotation","icon":"📌","description":"An accessibility note on a design artefact","interfaceName":"","domainId":"accessibility","color":"#2dd4bf","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"a11y_audit","label":"A11y Audit","icon":"🔍","description":"An audit assessing accessibility compliance","interfaceName":"","domainId":"accessibility","color":"#2dd4bf","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"a11y_guideline","label":"A11y Guideline","icon":"📏","description":"A specific guideline within a standard","interfaceName":"","domainId":"accessibility","color":"#2dd4bf","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"a11y_issue","label":"A11y Issue","icon":"⚠️","description":"An accessibility defect found during audit","interfaceName":"","domainId":"accessibility","color":"#2dd4bf","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"a11y_standard","label":"A11y Standard","icon":"♿","description":"WCAG, Section 508, or similar standard","interfaceName":"","domainId":"accessibility","color":"#2dd4bf","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"ai_cost_tracker","label":"AI Cost Tracker","icon":"💰","description":"A tracker monitoring AI inference costs and usage","interfaceName":"","domainId":"ai","color":"#7c3aed","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"ai_guardrail","label":"AI Guardrail","icon":"🛡️","description":"A safety guardrail constraining AI model behaviour","interfaceName":"","domainId":"ai","color":"#6d28d9","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"ai_model","label":"AI Model","icon":"🤖","description":"An AI or ML model used within the product","interfaceName":"","domainId":"ai","color":"#7c3aed","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"api_contract","label":"API Contract","icon":"📡","description":"An API contract or specification","interfaceName":"","domainId":"engineering","color":"#a5b4fc","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"api_ecosystem","label":"API Ecosystem","icon":"🔌","description":"The API ecosystem enabling third-party integrations","interfaceName":"","domainId":"ecosystem","color":"#4f46e5","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"api_endpoint","label":"API Endpoint","icon":"🔌","description":"A single endpoint exposed by a service","interfaceName":"","domainId":"engineering","color":"#6366f1","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"acceptance_criterion","label":"Acceptance Criterion","icon":"✅","description":"A criterion for accepting a user story","interfaceName":"","domainId":"product_spec","color":"#c4b5fd","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"access_policy","label":"Access Policy","icon":"🔑","description":"A policy defining resource access","interfaceName":"","domainId":"security","color":"#ef4444","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"account","label":"Account","icon":"🏢","description":"A customer or prospect organisation","interfaceName":"","domainId":"sales","color":"#84cc16","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"acquisition_channel","label":"Acquisition Channel","icon":"📣","description":"A customer acquisition channel","interfaceName":"","domainId":"growth","color":"#f87171","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"ad_creative","label":"Ad Creative","icon":"🎨","description":"An advertisement creative asset — copy, image, or video","interfaceName":"","domainId":"marketing","color":"#ec4899","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"affinity_cluster","label":"Affinity Cluster","icon":"🗂️","description":"A thematic grouping of observations","interfaceName":"","domainId":"user_research","color":"#0ea5e9","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"agent_definition","label":"Agent Definition","icon":"🤖","description":"The definition of an AI agent including its role and capabilities","interfaceName":"","domainId":"automation","color":"#0284c7","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"agent_hook","label":"Agent Hook","icon":"🪝","description":"A hook or trigger that connects an agent to external systems","interfaceName":"","domainId":"automation","color":"#0ea5e9","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"agent_session","label":"Agent Session","icon":"💬","description":"A session of interaction with an AI agent","interfaceName":"","domainId":"automation","color":"#0ea5e9","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"agent_skill","label":"Agent Skill","icon":"🎯","description":"A specific skill or capability that an agent can perform","interfaceName":"","domainId":"automation","color":"#0284c7","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"aggregate","label":"Aggregate","icon":"📦","description":"A DDD aggregate root enforcing consistency","interfaceName":"","domainId":"engineering","color":"#4f46e5","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"alert_rule","label":"Alert Rule","icon":"🔔","description":"A rule triggering notifications on conditions","interfaceName":"","domainId":"devops","color":"#06b6d4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"annotation","label":"Annotation","icon":"📌","description":"A note attached to a design artefact","interfaceName":"","domainId":"design_system","color":"#2dd4bf","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"approval_record","label":"Approval Record","icon":"✅","description":"A record of an approval or rejection at a review gate","interfaceName":"","domainId":"automation","color":"#38bdf8","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"assumption","label":"Assumption","icon":"🤔","description":"A belief taken as true that underpins a strategy","interfaceName":"","domainId":"strategy","color":"#f97316","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"attribution_model","label":"Attribution Model","icon":"📊","description":"A model attributing conversions to channels","interfaceName":"","domainId":"growth","color":"#f87171","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"audit_log_policy","label":"Audit Log Policy","icon":"📝","description":"Event tracking and log retention policy","interfaceName":"","domainId":"compliance","color":"#334155","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"competitive_battle_card","label":"Battle Card","icon":"⚔️","description":"A tactical comparison for competitive sales","interfaceName":"","domainId":"go_to_market","color":"#f43f5e","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"beta_program","label":"Beta Program","icon":"🧪","description":"A beta testing program for pre-release features","interfaceName":"","domainId":"feedback","color":"#2dd4bf","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"bounded_context","label":"Bounded Context","icon":"🏗️","description":"A DDD bounded context","interfaceName":"","domainId":"engineering","color":"#4f46e5","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"brand_asset","label":"Brand Asset","icon":"🎨","description":"Logo, colour, typography, or illustration","interfaceName":"","domainId":"brand","color":"#a78bfa","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"brand_colour","label":"Brand Colour","icon":"🎨","description":"A brand colour with role and context","interfaceName":"","domainId":"brand","color":"#38bdf8","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"brand_identity","label":"Brand Identity","icon":"🏷️","description":"Brand personality and positioning","interfaceName":"","domainId":"brand","color":"#0ea5e9","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"brand_typography","label":"Brand Typography","icon":"🔤","description":"A typeface in the brand type scale","interfaceName":"","domainId":"brand","color":"#0284c7","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"brand_voice","label":"Brand Voice","icon":"🗣️","description":"Brand voice and tone guidelines","interfaceName":"","domainId":"brand","color":"#0369a1","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"bug","label":"Bug","icon":"🐛","description":"A defect or unintended behaviour in the product","interfaceName":"","domainId":"product_spec","color":"#8b5cf6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"build_artifact","label":"Build Artifact","icon":"📦","description":"A compiled output from a CI build","interfaceName":"","domainId":"engineering","color":"#94a3b8","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"business_model","label":"Business Model","icon":"💰","description":"The business model canvas","interfaceName":"","domainId":"business_model","color":"#10b981","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"ci_pipeline","label":"CI Pipeline","icon":"🔄","description":"A continuous integration pipeline","interfaceName":"","domainId":"devops","color":"#06b6d4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"marketing_campaign_plan","label":"Campaign Plan","icon":"📋","description":"A planned marketing campaign with timeline, budget, and target audience","interfaceName":"","domainId":"marketing","color":"#db2777","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"capability","label":"Capability","icon":"💪","description":"An ability that enables value delivery","interfaceName":"","domainId":"strategy","color":"#f97316","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"capacity_plan","label":"Capacity Plan","icon":"📊","description":"A plan for allocating team capacity","interfaceName":"","domainId":"team_org","color":"#b45309","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"ceremony","label":"Ceremony","icon":"📅","description":"A recurring team ritual (standup, planning)","interfaceName":"","domainId":"team_org","color":"#fbbf24","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"certification","label":"Certification","icon":"🏅","description":"A certification program validating skill or knowledge attainment","interfaceName":"","domainId":"education","color":"#b45309","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"change_request","label":"Change Request","icon":"🔄","description":"A formal request to change scope or timeline","interfaceName":"","domainId":"program_mgmt","color":"#d946ef","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"changelog","label":"Changelog","icon":"📋","description":"Release changelog entry","interfaceName":"","domainId":"product_spec","color":"#8b5cf6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"churn_reason","label":"Churn Reason","icon":"🚪","description":"Categorised causes of churn","interfaceName":"","domainId":"customer_success","color":"#0f766e","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"code_repository","label":"Code Repository","icon":"📂","description":"A version-controlled source code repository","interfaceName":"","domainId":"engineering","color":"#475569","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"cohort","label":"Cohort","icon":"👥","description":"A group sharing a characteristic","interfaceName":"","domainId":"growth","color":"#e11d48","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"command","label":"Command","icon":"⌨️","description":"A request to change system state","interfaceName":"","domainId":"engineering","color":"#a5b4fc","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"community_initiative","label":"Community Initiative","icon":"🤝","description":"A community-building initiative to engage users or advocates","interfaceName":"","domainId":"marketing","color":"#db2777","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"competitive_analysis","label":"Competitive Analysis","icon":"📊","description":"A structured comparison of competitive offerings","interfaceName":"","domainId":"market_intelligence","color":"#f43f5e","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"competitor","label":"Competitor","icon":"⚔️","description":"A competing product or company","interfaceName":"","domainId":"market_intelligence","color":"#f43f5e","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"competitor_feature","label":"Competitor Feature","icon":"🔍","description":"A feature offered by a competitor","interfaceName":"","domainId":"market_intelligence","color":"#fb7185","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"compliance_requirement","label":"Compliance Req.","icon":"📜","description":"A regulatory obligation to meet","interfaceName":"","domainId":"compliance","color":"#475569","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"contact","label":"Contact","icon":"👤","description":"An individual person within an account","interfaceName":"","domainId":"sales","color":"#84cc16","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"content_calendar","label":"Content Calendar","icon":"📅","description":"A schedule for planning and publishing","interfaceName":"","domainId":"content","color":"#7c3aed","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"content_piece","label":"Content Piece","icon":"📝","description":"Blog post, video, podcast, or newsletter","interfaceName":"","domainId":"content","color":"#7c3aed","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"content_strategy","label":"Content Strategy","icon":"📝","description":"A content marketing strategy","interfaceName":"","domainId":"go_to_market","color":"#f43f5e","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"content_theme","label":"Content Theme","icon":"🏷️","description":"A thematic focus area for content","interfaceName":"","domainId":"content","color":"#a78bfa","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"contract","label":"Contract","icon":"📑","description":"A legal agreement between parties","interfaceName":"","domainId":"legal","color":"#475569","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"contract_clause","label":"Contract Clause","icon":"📄","description":"A clause or provision within a contract","interfaceName":"","domainId":"legal","color":"#64748b","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"cost_structure","label":"Cost Structure","icon":"🧾","description":"A cost category in the business","interfaceName":"","domainId":"business_model","color":"#047857","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"cultural_adaptation","label":"Cultural Adaptation","icon":"🌍","description":"An adaptation of content or UX for a specific cultural context","interfaceName":"","domainId":"localisation","color":"#6d28d9","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"customer_feedback","label":"Customer Feedback","icon":"📣","description":"Voice-of-customer input","interfaceName":"","domainId":"customer_success","color":"#14b8a6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"customer_relationship","label":"Customer Relationship","icon":"🤝","description":"How you engage and maintain relationships with customers","interfaceName":"","domainId":"business_model","color":"#a7f3d0","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"dashboard","label":"Dashboard","icon":"📊","description":"An analytics dashboard","interfaceName":"","domainId":"data_analytics","color":"#67e8f9","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"data_classification","label":"Data Classification","icon":"🏷️","description":"A classification level for data sensitivity","interfaceName":"","domainId":"security","color":"#ef4444","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"data_contract","label":"Data Contract","icon":"📋","description":"Data handling terms and policies","interfaceName":"","domainId":"compliance","color":"#334155","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"data_domain","label":"Data Domain","icon":"🏷️","description":"A logical grouping of related data assets","interfaceName":"","domainId":"data_analytics","color":"#0e7490","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"data_flow","label":"Data Flow","icon":"🌊","description":"Directional data movement between services — for architecture diagrams","interfaceName":"","domainId":"engineering","color":"#818cf8","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"data_lineage","label":"Data Lineage","icon":"🌳","description":"A record of data origin and transformations","interfaceName":"","domainId":"data_analytics","color":"#22d3ee","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"data_model","label":"Data Model","icon":"🗃️","description":"A data model or schema","interfaceName":"","domainId":"data_analytics","color":"#06b6d4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"data_pipeline","label":"Data Pipeline","icon":"🔀","description":"An automated pipeline for data transformation","interfaceName":"","domainId":"data_analytics","color":"#0891b2","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"data_product","label":"Data Product","icon":"📦","description":"A curated, reusable data asset","interfaceName":"","domainId":"data_analytics","color":"#06b6d4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"data_quality_rule","label":"Data Quality Rule","icon":"✅","description":"A data quality validation rule","interfaceName":"","domainId":"data_analytics","color":"#22d3ee","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"data_source","label":"Data Source","icon":"🗄️","description":"A data source or integration","interfaceName":"","domainId":"data_analytics","color":"#06b6d4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"database_schema","label":"Database Schema","icon":"🗄️","description":"The schema definition for a service database","interfaceName":"","domainId":"engineering","color":"#64748b","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"deal","label":"Deal","icon":"🤝","description":"A sales opportunity being pursued","interfaceName":"","domainId":"sales","color":"#84cc16","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"decision","label":"Decision","icon":"⚖️","description":"A cross-layer decision capturing options considered, rationale, and entities influenced","interfaceName":"","domainId":"strategy","color":"#78716c","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"deliverable","label":"Deliverable","icon":"📦","description":"A tangible output from a project","interfaceName":"","domainId":"program_mgmt","color":"#d946ef","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"demand_gen_program","label":"Demand Gen","icon":"📢","description":"A program to generate demand and pipeline","interfaceName":"","domainId":"go_to_market","color":"#e11d48","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"department","label":"Department","icon":"🏢","description":"An organisational department or division","interfaceName":"","domainId":"team_org","color":"#d97706","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"dependency","label":"Dependency","icon":"🔗","description":"A dependency between teams","interfaceName":"","domainId":"team_org","color":"#fbbf24","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"deployment","label":"Deployment","icon":"🚀","description":"A deployment event","interfaceName":"","domainId":"engineering","color":"#475569","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"design_component","label":"Design Component","icon":"🧩","description":"A reusable design component","interfaceName":"","domainId":"design_system","color":"#0d9488","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"design_concept","label":"Design Concept","icon":"🎨","description":"A design concept or idea","interfaceName":"","domainId":"ux_design","color":"#2dd4bf","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"design_guideline","label":"Design Guideline","icon":"📏","description":"A rule or best practice for design consistency","interfaceName":"","domainId":"design_system","color":"#14b8a6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"design_pattern","label":"Design Pattern","icon":"🧩","description":"A reusable solution to a common design problem","interfaceName":"","domainId":"design_system","color":"#0d9488","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"design_sprint","label":"Design Sprint","icon":"🏃","description":"A time-boxed sprint to prototype and validate ideas","interfaceName":"","domainId":"discovery","color":"#22c55e","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"design_system","label":"Design System","icon":"🎨","description":"The parent container for all design components and tokens in the product","interfaceName":"","domainId":"design_system","color":"#0d9488","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"design_token","label":"Design Token","icon":"🎛️","description":"A design token (colour, spacing, etc.)","interfaceName":"","domainId":"design_system","color":"#14b8a6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"desired_outcome","label":"Desired Outcome","icon":"🌟","description":"What the user hopes to achieve","interfaceName":"","domainId":"user","color":"#06b6d4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"developer_portal","label":"Developer Portal","icon":"👨‍💻","description":"A portal providing API documentation and developer resources","interfaceName":"","domainId":"ecosystem","color":"#4338ca","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"discount_strategy","label":"Discount Strategy","icon":"🏷️","description":"A strategy for offering discounts, coupons, or promotional pricing","interfaceName":"","domainId":"pricing","color":"#f97316","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"distribution_channel","label":"Distribution Channel","icon":"🚚","description":"How you deliver your value proposition to customers","interfaceName":"","domainId":"business_model","color":"#a7f3d0","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"documentation_template","label":"Doc Template","icon":"📄","description":"A reusable template for documentation","interfaceName":"","domainId":"content","color":"#6d28d9","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"domain_entity","label":"Domain Entity","icon":"🏗️","description":"A domain object with identity and lifecycle","interfaceName":"","domainId":"engineering","color":"#6366f1","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"domain_event","label":"Domain Event","icon":"⚡","description":"A domain event in the system","interfaceName":"","domainId":"engineering","color":"#818cf8","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"education_program","label":"Education Program","icon":"🎓","description":"A structured education program for customers or partners","interfaceName":"","domainId":"education","color":"#f59e0b","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"email_sequence","label":"Email Sequence","icon":"📧","description":"An automated email sequence for nurturing or onboarding","interfaceName":"","domainId":"marketing","color":"#ec4899","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"epic","label":"Epic","icon":"📚","description":"A large body of work containing user stories","interfaceName":"","domainId":"product_spec","color":"#a78bfa","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"error_budget","label":"Error Budget","icon":"💰","description":"Allowed unreliability before action is required","interfaceName":"","domainId":"devops","color":"#06b6d4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"eval_benchmark","label":"Eval Benchmark","icon":"📏","description":"A benchmark dataset or criteria for evaluating AI model performance","interfaceName":"","domainId":"ai","color":"#6d28d9","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"eval_run","label":"Eval Run","icon":"🏃","description":"A single evaluation run of an AI model against a benchmark","interfaceName":"","domainId":"ai","color":"#a78bfa","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"event","label":"Event","icon":"🎪","description":"A marketing event such as a webinar, conference, or meetup","interfaceName":"","domainId":"marketing","color":"#f472b6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"event_schema","label":"Event Schema","icon":"📋","description":"An event schema for tracking","interfaceName":"","domainId":"data_analytics","color":"#0891b2","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"evidence","label":"Evidence","icon":"🔎","description":"Data supporting or refuting a hypothesis","interfaceName":"","domainId":"validation","color":"#eab308","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"experiment","label":"Experiment","icon":"🧫","description":"A test designed to validate a hypothesis","interfaceName":"","domainId":"validation","color":"#f59e0b","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"external_api","label":"External API","icon":"🔌","description":"A named, configured third-party API connection used by this product","interfaceName":"","domainId":"engineering","color":"#6366f1","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"feasibility_study","label":"Feasibility Study","icon":"📋","description":"An assessment of technical or business viability","interfaceName":"","domainId":"discovery","color":"#22c55e","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"feature","label":"Feature","icon":"⭐","description":"A product feature","interfaceName":"","domainId":"product_spec","color":"#8b5cf6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"feature_flag","label":"Feature Flag","icon":"🚩","description":"A feature flag for controlled rollout","interfaceName":"","domainId":"engineering","color":"#94a3b8","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"feature_request","label":"Feature Request","icon":"💡","description":"A user-submitted request for a new feature or enhancement","interfaceName":"","domainId":"feedback","color":"#2dd4bf","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"feedback_program","label":"Feedback Program","icon":"📣","description":"A structured program for collecting and managing user feedback","interfaceName":"","domainId":"feedback","color":"#14b8a6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"feedback_theme","label":"Feedback Theme","icon":"🏷️","description":"A recurring theme identified across multiple feedback items","interfaceName":"","domainId":"feedback","color":"#0d9488","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"feedback_vote","label":"Feedback Vote","icon":"👍","description":"A vote or upvote on a feature request or feedback item","interfaceName":"","domainId":"feedback","color":"#0d9488","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"forecast","label":"Forecast","icon":"📈","description":"A revenue forecast for a given period","interfaceName":"","domainId":"sales","color":"#84cc16","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"compliance_framework","label":"Framework","icon":"🏛️","description":"A structured compliance controls framework","interfaceName":"","domainId":"compliance","color":"#475569","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"funnel","label":"Funnel","icon":"🔽","description":"A conversion funnel","interfaceName":"","domainId":"growth","color":"#ea580c","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"funnel_step","label":"Funnel Step","icon":"📐","description":"A step in a conversion funnel","interfaceName":"","domainId":"growth","color":"#fdba74","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"gtm_strategy","label":"GTM Strategy","icon":"🚀","description":"A go-to-market strategy","interfaceName":"","domainId":"go_to_market","color":"#f43f5e","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"glossary_term","label":"Glossary Term","icon":"📖","description":"A defined term for shared understanding","interfaceName":"","domainId":"data_analytics","color":"#67e8f9","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"growth_loop","label":"Growth Loop","icon":"🔄","description":"A self-reinforcing cycle driving growth","interfaceName":"","domainId":"growth","color":"#f97316","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"hallucination_report","label":"Hallucination Report","icon":"👻","description":"A report documenting AI hallucination incidents and patterns","interfaceName":"","domainId":"ai","color":"#ef4444","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"customer_health_score","label":"Health Score","icon":"💚","description":"Composite satisfaction and retention score","interfaceName":"","domainId":"customer_success","color":"#0d9488","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"help_video","label":"Help Video","icon":"🎬","description":"A short help video explaining a feature or process","interfaceName":"","domainId":"education","color":"#fbbf24","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"hypothesis","label":"Hypothesis","icon":"🧪","description":"A testable belief about a solution","interfaceName":"","domainId":"validation","color":"#eab308","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"ip_asset","label":"IP Asset","icon":"🔒","description":"Patent, trademark, copyright, or trade secret","interfaceName":"","domainId":"legal","color":"#64748b","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"ideal_customer_profile","label":"Ideal Customer Profile","icon":"🎯","description":"The ideal customer profile (ICP)","interfaceName":"","domainId":"go_to_market","color":"#fb7185","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"incident","label":"Incident","icon":"🚨","description":"An unplanned disruption of service","interfaceName":"","domainId":"devops","color":"#06b6d4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"infrastructure_component","label":"Infrastructure","icon":"🖥️","description":"A cloud or physical infrastructure building block","interfaceName":"","domainId":"devops","color":"#06b6d4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"initiative","label":"Initiative","icon":"🚀","description":"A large coordinated effort to achieve a strategic goal","interfaceName":"","domainId":"strategy","color":"#f97316","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"insight","label":"Insight","icon":"💡","description":"A finding from research that informs product decisions. Consolidates research_insight, finding, and ux_insight (v0.1).","interfaceName":"","domainId":"user_research","color":"#0284c7","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"integration_partner","label":"Integration Partner","icon":"🔗","description":"A partner who builds integrations with the product","interfaceName":"","domainId":"ecosystem","color":"#818cf8","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"integration_pattern","label":"Integration Pattern","icon":"🔗","description":"A pattern for integrating between systems","interfaceName":"","domainId":"engineering","color":"#6366f1","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"interaction_spec","label":"Interaction Spec","icon":"🖱️","description":"A specification of component interaction behaviour","interfaceName":"","domainId":"design_system","color":"#5eead4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"interview_guide","label":"Interview Guide","icon":"🎙️","description":"A structured guide for research interviews","interfaceName":"","domainId":"user_research","color":"#38bdf8","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"invoice","label":"Invoice","icon":"🧾","description":"A billing invoice for products or services","interfaceName":"","domainId":"sales","color":"#84cc16","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"job_step","label":"Job Step","icon":"👣","description":"A discrete step within a Job To Be Done","interfaceName":"","domainId":"user","color":"#a855f7","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"customer_journey_stage","label":"Journey Stage","icon":"🗺️","description":"A stage in the customer lifecycle","interfaceName":"","domainId":"customer_success","color":"#2dd4bf","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"journey_step","label":"Journey Step","icon":"👣","description":"A single step in a user journey","interfaceName":"","domainId":"ux_design","color":"#5eead4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"knowledge_base_article","label":"KB Article","icon":"📖","description":"Help centre or internal KB article","interfaceName":"","domainId":"content","color":"#8b5cf6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"key_activity","label":"Key Activity","icon":"⚡","description":"A critical activity to operate the business","interfaceName":"","domainId":"business_model","color":"#059669","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"key_resource","label":"Key Resource","icon":"🔑","description":"A critical resource to deliver value","interfaceName":"","domainId":"business_model","color":"#10b981","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"key_result","label":"Key Result","icon":"📈","description":"A measurable result tied to an objective","interfaceName":"","domainId":"strategy","color":"#818cf8","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"launch","label":"Launch","icon":"🎉","description":"A product or feature launch","interfaceName":"","domainId":"go_to_market","color":"#be123c","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"lead","label":"Lead","icon":"🎣","description":"A potential customer who has shown interest","interfaceName":"","domainId":"sales","color":"#84cc16","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"learning","label":"Learning","icon":"📝","description":"An insight gained from an experiment","interfaceName":"","domainId":"validation","color":"#14b8a6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"learning_path","label":"Learning Path","icon":"🛤️","description":"An ordered sequence of tutorials and content for progressive learning","interfaceName":"","domainId":"education","color":"#d97706","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"legal_entity","label":"Legal Entity","icon":"🏛️","description":"A corporate entity with jurisdiction","interfaceName":"","domainId":"legal","color":"#475569","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"library_dependency","label":"Library Dependency","icon":"📚","description":"An external library or package dependency","interfaceName":"","domainId":"engineering","color":"#64748b","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"locale","label":"Locale","icon":"🌐","description":"A supported language/region locale such as en-GB or fr-FR","interfaceName":"","domainId":"localisation","color":"#8b5cf6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"locale_config","label":"Locale Config","icon":"⚙️","description":"Configuration settings for a locale including formats and fallbacks","interfaceName":"","domainId":"localisation","color":"#8b5cf6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"market_segment","label":"Market Segment","icon":"🎯","description":"A distinct group within the target market","interfaceName":"","domainId":"market_intelligence","color":"#f43f5e","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"market_trend","label":"Market Trend","icon":"📉","description":"An emerging trend in the market","interfaceName":"","domainId":"market_intelligence","color":"#64748b","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"marketing_channel","label":"Marketing Channel","icon":"📡","description":"A specific marketing channel such as email, social, or paid ads","interfaceName":"","domainId":"marketing","color":"#f472b6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"marketing_strategy","label":"Marketing Strategy","icon":"📣","description":"An overarching marketing strategy defining channels, audiences, and goals","interfaceName":"","domainId":"marketing","color":"#ec4899","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"marketplace_listing","label":"Marketplace Listing","icon":"🏪","description":"A listing in an app marketplace or integration directory","interfaceName":"","domainId":"ecosystem","color":"#6366f1","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"messaging","label":"Messaging","icon":"💬","description":"Marketing messaging and copy","interfaceName":"","domainId":"go_to_market","color":"#fda4af","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"metric","label":"Metric","icon":"📐","description":"A unified metric — measures progress, health, or behaviour across the product","interfaceName":"","domainId":"strategy","color":"#ec4899","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"milestone","label":"Milestone","icon":"🏁","description":"A significant checkpoint or deadline","interfaceName":"","domainId":"program_mgmt","color":"#d946ef","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"mission","label":"Mission","icon":"🧭","description":"The purpose and reason the product exists","interfaceName":"","domainId":"strategy","color":"#f97316","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"model_comparison","label":"Model Comparison","icon":"⚖️","description":"A structured comparison of AI models on cost, quality, and latency","interfaceName":"","domainId":"ai","color":"#8b5cf6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"monitor","label":"Monitor","icon":"👁️","description":"A monitoring check observing system health","interfaceName":"","domainId":"devops","color":"#06b6d4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"nps_campaign","label":"NPS Campaign","icon":"📊","description":"A Net Promoter Score survey campaign targeting users","interfaceName":"","domainId":"feedback","color":"#14b8a6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"need","label":"Need","icon":"💡","description":"A user need, pain, desire, or constraint. Replaces pain_point and user_need (v0.1). Called 'Problem' in Lean Canvas, 'Struggle' in JTBD, 'Pain Point' in Design Thinking.","interfaceName":"","domainId":"user","color":"#ef4444","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"objection","label":"Objection","icon":"🚧","description":"A counter-argument a prospect, user, or stakeholder raises against a positioning or value proposition claim","interfaceName":"","domainId":"go_to_market","color":"#f97316","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"objective","label":"Objective","icon":"🏁","description":"A strategic goal (OKR)","interfaceName":"","domainId":"strategy","color":"#6366f1","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"observation","label":"Observation","icon":"👁️","description":"A behavioural observation from research","interfaceName":"","domainId":"user_research","color":"#38bdf8","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"on_call_rotation","label":"On-Call Rotation","icon":"📟","description":"A rotation schedule for incident response","interfaceName":"","domainId":"devops","color":"#06b6d4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"opportunity","label":"Opportunity","icon":"💡","description":"A validated gap worth solving","interfaceName":"","domainId":"discovery","color":"#22c55e","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"organization","label":"Organization","icon":"🏢","description":"A top-level container for portfolios and billing","interfaceName":"","domainId":"portfolio","color":"#6366f1","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"outcome","label":"Outcome","icon":"🎯","description":"A desired business or user outcome","interfaceName":"","domainId":"strategy","color":"#f97316","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"participant","label":"Participant","icon":"🙋","description":"A research study participant","interfaceName":"","domainId":"user_research","color":"#7dd3fc","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"partner_program","label":"Partner Program","icon":"🤝","description":"A structured program for managing partner relationships","interfaceName":"","domainId":"ecosystem","color":"#6366f1","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"partner_revenue_share","label":"Partner Revenue Share","icon":"💰","description":"A revenue sharing arrangement with a partner","interfaceName":"","domainId":"ecosystem","color":"#4f46e5","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"partner_tier","label":"Partner Tier","icon":"🏆","description":"A tier level within a partner program with specific benefits","interfaceName":"","domainId":"ecosystem","color":"#818cf8","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"partnership","label":"Partnership","icon":"🤝","description":"A strategic partnership","interfaceName":"","domainId":"business_model","color":"#34d399","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"paywall","label":"Paywall","icon":"🚧","description":"A paywall controlling access to premium features or content","interfaceName":"","domainId":"pricing","color":"#fb923c","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"penetration_test","label":"Penetration Test","icon":"🔓","description":"A simulated attack to find weaknesses","interfaceName":"","domainId":"security","color":"#ef4444","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"persona","label":"Persona","icon":"👤","description":"An archetype representing a user segment","interfaceName":"","domainId":"user","color":"#a855f7","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"pipeline_stage","label":"Pipeline Stage","icon":"📊","description":"A stage within the sales pipeline","interfaceName":"","domainId":"sales","color":"#84cc16","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"playbook","label":"Playbook","icon":"📋","description":"Repeatable process for CS scenarios","interfaceName":"","domainId":"customer_success","color":"#14b8a6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"portfolio","label":"Portfolio","icon":"📂","description":"A collection of related products managed as a portfolio","interfaceName":"","domainId":"portfolio","color":"#8b5cf6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"positioning","label":"Positioning","icon":"📍","description":"Product positioning in the market","interfaceName":"","domainId":"go_to_market","color":"#e11d48","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"postmortem","label":"Postmortem","icon":"📋","description":"A post-incident analysis documenting lessons","interfaceName":"","domainId":"devops","color":"#06b6d4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"press_release","label":"Press Release","icon":"📰","description":"A formal press release for media distribution","interfaceName":"","domainId":"marketing","color":"#be185d","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"pricing_strategy","label":"Pricing Strategy","icon":"💲","description":"An overarching pricing strategy defining the approach to monetisation","interfaceName":"","domainId":"pricing","color":"#f97316","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"pricing_tier","label":"Pricing Tier","icon":"🏷️","description":"A pricing plan or tier","interfaceName":"","domainId":"pricing","color":"#6ee7b7","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"privacy_policy","label":"Privacy Policy","icon":"🔒","description":"A policy governing data privacy","interfaceName":"","domainId":"legal","color":"#334155","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"product","label":"Product","icon":"📦","description":"A product or service being built in the graph","interfaceName":"","domainId":"strategy","color":"#6b7280","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"product_area","label":"Product Area","icon":"📐","description":"A lightweight grouping of concerns within a product","interfaceName":"","domainId":"portfolio","color":"#a78bfa","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"program","label":"Program","icon":"📋","description":"Related projects delivering strategic outcomes","interfaceName":"","domainId":"program_mgmt","color":"#d946ef","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"project","label":"Project","icon":"📂","description":"A time-bound effort to deliver specific outputs","interfaceName":"","domainId":"program_mgmt","color":"#d946ef","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"prompt_template","label":"Prompt Template","icon":"🤖","description":"AI prompt template with variables","interfaceName":"","domainId":"ai","color":"#7c3aed","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"prompt_version","label":"Prompt Version","icon":"📝","description":"A versioned prompt template for an AI model","interfaceName":"","domainId":"ai","color":"#8b5cf6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"proof_point","label":"Proof Point","icon":"✅","description":"Evidence supporting a rebuttal, positioning statement, or value proposition","interfaceName":"","domainId":"go_to_market","color":"#22c55e","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"prototype","label":"Prototype","icon":"🖼️","description":"A testable prototype","interfaceName":"","domainId":"ux_design","color":"#5eead4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"qa_session","label":"QA Session","icon":"🔍","description":"A manual QA testing session with findings and notes","interfaceName":"","domainId":"testing","color":"#059669","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"queue_topic","label":"Queue Topic","icon":"📨","description":"A message queue topic for async communication","interfaceName":"","domainId":"engineering","color":"#818cf8","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"quote","label":"Quote","icon":"💬","description":"A verbatim quote from a participant","interfaceName":"","domainId":"user_research","color":"#7dd3fc","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"quote_document","label":"Quote","icon":"💲","description":"A formal price quote sent to a prospect","interfaceName":"","domainId":"sales","color":"#84cc16","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"read_model","label":"Read Model","icon":"👁️","description":"A query-optimised projection of domain data","interfaceName":"","domainId":"engineering","color":"#4338ca","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"rebuttal","label":"Rebuttal","icon":"💬","description":"A structured response to an objection","interfaceName":"","domainId":"go_to_market","color":"#14b8a6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"regional_pricing","label":"Regional Pricing","icon":"💱","description":"Pricing configuration adjusted for a specific region or market","interfaceName":"","domainId":"localisation","color":"#a78bfa","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"regression_test","label":"Regression Test","icon":"🔁","description":"A regression test ensuring existing functionality is preserved","interfaceName":"","domainId":"testing","color":"#10b981","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"release","label":"Release","icon":"🚢","description":"A product release or version","interfaceName":"","domainId":"product_spec","color":"#6d28d9","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"release_strategy","label":"Release Strategy","icon":"🚀","description":"A strategy for releasing to production","interfaceName":"","domainId":"devops","color":"#06b6d4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"report","label":"Report","icon":"📄","description":"A structured analytical report","interfaceName":"","domainId":"data_analytics","color":"#06b6d4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"research_plan","label":"Research Plan","icon":"🔬","description":"A copilot-generated plan for gathering evidence to validate a draft entity","interfaceName":"","domainId":"validation","color":"#d97706","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"research_question","label":"Research Question","icon":"❓","description":"A question a research study aims to answer","interfaceName":"","domainId":"user_research","color":"#38bdf8","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"research_study","label":"Research Study","icon":"🔬","description":"A UX research study or project","interfaceName":"","domainId":"user_research","color":"#38bdf8","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"resource_allocation","label":"Resource Allocation","icon":"👥","description":"An allocation of people or budget","interfaceName":"","domainId":"program_mgmt","color":"#d946ef","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"retrospective","label":"Retrospective","icon":"🔄","description":"A team retrospective","interfaceName":"","domainId":"team_org","color":"#f59e0b","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"revenue_stream","label":"Revenue Stream","icon":"💵","description":"A source of revenue","interfaceName":"","domainId":"business_model","color":"#059669","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"review_gate","label":"Review Gate","icon":"🚪","description":"A checkpoint requiring human review or approval before proceeding","interfaceName":"","domainId":"automation","color":"#0369a1","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"risk","label":"Risk","icon":"⚠️","description":"A product, technical, or business risk","interfaceName":"","domainId":"compliance","color":"#64748b","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"risk_register","label":"Risk Register","icon":"📒","description":"A register tracking identified risks","interfaceName":"","domainId":"program_mgmt","color":"#d946ef","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"roadmap","label":"Roadmap","icon":"🗺️","description":"A visual plan of features and initiatives over time","interfaceName":"","domainId":"product_spec","color":"#8b5cf6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"roadmap_item","label":"Roadmap Item","icon":"📍","description":"A single item on the product roadmap","interfaceName":"","domainId":"product_spec","color":"#8b5cf6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"role","label":"Role","icon":"🪪","description":"A role within a team","interfaceName":"","domainId":"team_org","color":"#f59e0b","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"runbook","label":"Runbook","icon":"📖","description":"A procedure for operational tasks or incidents","interfaceName":"","domainId":"devops","color":"#06b6d4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"seo_keyword","label":"SEO Keyword","icon":"🔑","description":"A target SEO keyword with search volume and ranking data","interfaceName":"","domainId":"marketing","color":"#db2777","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"sales_motion","label":"Sales Motion","icon":"🤝","description":"A sales process or motion","interfaceName":"","domainId":"go_to_market","color":"#fb7185","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"pipeline_sales","label":"Sales Pipeline","icon":"🔽","description":"A structured sales pipeline with stages","interfaceName":"","domainId":"sales","color":"#84cc16","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"screen","label":"Screen","icon":"🖥️","description":"A live UI route or state — the actual running screen at a URL","interfaceName":"","domainId":"ux_design","color":"#14b8a6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"screen_state","label":"Screen State","icon":"📐","description":"A variant state of a screen: empty, loading, error, populated, or skeleton","interfaceName":"","domainId":"ux_design","color":"#5eead4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"security_audit","label":"Security Audit","icon":"🔍","description":"An audit assessing security posture","interfaceName":"","domainId":"compliance","color":"#64748b","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"security_control","label":"Security Control","icon":"🔐","description":"A safeguard to mitigate threats","interfaceName":"","domainId":"security","color":"#ef4444","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"security_policy","label":"Security Policy","icon":"📜","description":"A policy governing security practices","interfaceName":"","domainId":"security","color":"#ef4444","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"security_review","label":"Security Review","icon":"🔍","description":"A review of security posture","interfaceName":"","domainId":"security","color":"#ef4444","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"service","label":"Service","icon":"⚙️","description":"A microservice or application service","interfaceName":"","domainId":"engineering","color":"#6366f1","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"service_blueprint","label":"Service Blueprint","icon":"📐","description":"A diagram mapping service delivery","interfaceName":"","domainId":"customer_success","color":"#0f766e","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"skill","label":"Skill","icon":"🎓","description":"A skill or competency within a team","interfaceName":"","domainId":"team_org","color":"#f59e0b","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"social_post","label":"Social Post","icon":"💬","description":"A social media post or thread planned or published","interfaceName":"","domainId":"marketing","color":"#f472b6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"solution","label":"Solution","icon":"🔧","description":"A proposed approach to address an opportunity","interfaceName":"","domainId":"discovery","color":"#3b82f6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"stakeholder","label":"Stakeholder","icon":"🏢","description":"A stakeholder with interest in the product","interfaceName":"","domainId":"team_org","color":"#fbbf24","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"status_report","label":"Status Report","icon":"📊","description":"A periodic report on progress","interfaceName":"","domainId":"program_mgmt","color":"#d946ef","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"strategic_pillar","label":"Strategic Pillar","icon":"🏛️","description":"A foundational principle that guides decisions","interfaceName":"","domainId":"strategy","color":"#f97316","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"strategic_theme","label":"Strategic Theme","icon":"🎯","description":"A high-level strategic focus area for a planning period","interfaceName":"","domainId":"strategy","color":"#f97316","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"subscription","label":"Subscription","icon":"🔄","description":"A recurring revenue subscription","interfaceName":"","domainId":"sales","color":"#84cc16","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"success_milestone","label":"Success Milestone","icon":"🏆","description":"A key milestone indicating customer success","interfaceName":"","domainId":"customer_success","color":"#0d9488","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"support_ticket","label":"Support Ticket","icon":"🎫","description":"Customer support request or issue","interfaceName":"","domainId":"customer_success","color":"#0d9488","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"survey_response","label":"Survey Response","icon":"📩","description":"An individual response to a research survey","interfaceName":"","domainId":"user_research","color":"#38bdf8","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"switching_cost","label":"Switching Cost","icon":"🔄","description":"A barrier preventing users from switching alternatives","interfaceName":"","domainId":"user","color":"#a855f7","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"task","label":"Task","icon":"☑️","description":"A discrete unit of work within a user story","interfaceName":"","domainId":"product_spec","color":"#8b5cf6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"team","label":"Team","icon":"👥","description":"A team within the organisation","interfaceName":"","domainId":"team_org","color":"#d97706","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"team_okr","label":"Team OKR","icon":"🎯","description":"An OKR owned by a team","interfaceName":"","domainId":"team_org","color":"#d97706","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"technical_debt_item","label":"Tech Debt Item","icon":"🧹","description":"A piece of technical debt to address","interfaceName":"","domainId":"engineering","color":"#64748b","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"territory","label":"Territory","icon":"🗺️","description":"A geographic or account-based sales territory","interfaceName":"","domainId":"go_to_market","color":"#fb7185","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"test_case","label":"Test Case","icon":"✅","description":"A single test case with steps, expected results, and status","interfaceName":"","domainId":"testing","color":"#34d399","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"test_coverage_report","label":"Test Coverage Report","icon":"📊","description":"A report measuring test coverage across the product","interfaceName":"","domainId":"testing","color":"#047857","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"test_environment","label":"Test Environment","icon":"🖥️","description":"A testing environment configuration for QA activities","interfaceName":"","domainId":"testing","color":"#34d399","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"test_plan","label":"Test Plan","icon":"📝","description":"A structured plan for testing a hypothesis","interfaceName":"","domainId":"validation","color":"#eab308","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"test_suite","label":"Test Suite","icon":"🧪","description":"A collection of test cases grouped by feature or component","interfaceName":"","domainId":"testing","color":"#10b981","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"theme","label":"Theme","icon":"🏷️","description":"A high-level grouping of related features","interfaceName":"","domainId":"product_spec","color":"#8b5cf6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"threat","label":"Threat","icon":"⚠️","description":"A specific threat actor or attack vector","interfaceName":"","domainId":"security","color":"#ef4444","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"threat_model","label":"Threat Model","icon":"🛡️","description":"A structured analysis of potential threats","interfaceName":"","domainId":"security","color":"#ef4444","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"touchpoint","label":"Touchpoint","icon":"👆","description":"A point of interaction with the product","interfaceName":"","domainId":"customer_success","color":"#14b8a6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"translation_bundle","label":"Translation Bundle","icon":"📦","description":"A bundle of translation keys grouped for a feature or screen","interfaceName":"","domainId":"localisation","color":"#7c3aed","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"translation_key","label":"Translation Key","icon":"🔤","description":"A single translatable string key with its translations","interfaceName":"","domainId":"localisation","color":"#a78bfa","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"trial_config","label":"Trial Config","icon":"🆓","description":"Configuration for a free trial including duration and feature access","interfaceName":"","domainId":"pricing","color":"#c2410c","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"tutorial","label":"Tutorial","icon":"📖","description":"A step-by-step tutorial teaching a specific task or concept","interfaceName":"","domainId":"education","color":"#fbbf24","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"unit_economics","label":"Unit Economics","icon":"📊","description":"Per-unit economics (LTV, CAC, etc.)","interfaceName":"","domainId":"business_model","color":"#10b981","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"user_advisory_board","label":"User Advisory Board","icon":"👥","description":"A panel of users providing ongoing product feedback","interfaceName":"","domainId":"feedback","color":"#0f766e","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"user_flow","label":"User Flow","icon":"🔀","description":"A task-level navigation path showing how a user completes a specific task","interfaceName":"","domainId":"ux_design","color":"#2dd4bf","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"user_journey","label":"User Journey","icon":"🗺️","description":"An end-to-end user journey map","interfaceName":"","domainId":"ux_design","color":"#2dd4bf","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"value_object","label":"Value Object","icon":"💎","description":"An immutable object defined by its attributes","interfaceName":"","domainId":"engineering","color":"#818cf8","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"value_proposition","label":"Value Proposition","icon":"💎","description":"The value delivered to customers","interfaceName":"","domainId":"business_model","color":"#34d399","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"value_stream","label":"Value Stream","icon":"🌊","description":"An end-to-end flow delivering value to the customer","interfaceName":"","domainId":"strategy","color":"#f97316","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"variant","label":"Variant","icon":"🅰️","description":"A variation in an experiment or test","interfaceName":"","domainId":"growth","color":"#ea580c","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"vision","label":"Vision","icon":"🔭","description":"A long-term aspirational statement of the future state","interfaceName":"","domainId":"strategy","color":"#f97316","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"vulnerability","label":"Vulnerability","icon":"🕳️","description":"A weakness that could be exploited","interfaceName":"","domainId":"security","color":"#ef4444","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"walkthrough","label":"Walkthrough","icon":"🚶","description":"An interactive walkthrough guiding users through a feature or flow","interfaceName":"","domainId":"education","color":"#d97706","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"webinar","label":"Webinar","icon":"🎥","description":"A live or recorded webinar session for education or marketing","interfaceName":"","domainId":"education","color":"#f59e0b","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"wireframe","label":"Wireframe","icon":"📐","description":"A low-fidelity visual layout of a screen","interfaceName":"","domainId":"ux_design","color":"#2dd4bf","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"workflow_artifact","label":"Workflow Artifact","icon":"📦","description":"An output artifact produced by a workflow run","interfaceName":"","domainId":"automation","color":"#38bdf8","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"workflow_run","label":"Workflow Run","icon":"▶️","description":"A single execution instance of a workflow template","interfaceName":"","domainId":"automation","color":"#38bdf8","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"workflow_template","label":"Workflow Template","icon":"🔄","description":"A reusable template defining an automated or agentic workflow","interfaceName":"","domainId":"automation","color":"#0ea5e9","properties":[],"relationships":[],"deprecated":false,"replacement":null}],"toolGroups":[{"id":"context","label":"Context & Session","description":"Graph overview, session state, product context, and digest tools.","tools":[{"name":"get_graph_digest","slug":"get-graph-digest","description":"Pre-computed graph analytics in one call: counts, health, chain completeness, business-area coverage, lifecycle balance. ~500 tokens vs ~5-8K for equivalent manual fetches.","domain":"context","groupId":"context","args":[{"name":"if_changed_since","type":"string","required":false,"description":"Hash from a previous response. Returns { changed: false } if graph unchanged (saves ~470 tokens).","enumValues":"$undefined"},{"name":"coverage_profile","type":"array","required":false,"description":"Batch-4 #22: coverage region ids (the keys of the `coverage` block: identity, understanding, discovery, validation, reaching, converting, building, sustaining, learning, operations) to score against instead of the product stage default. Adds `coverage.profile_summary` (overall_pct over just these regions), so a deliberately-scoped product (e.g. a structural spine) reads its parity without out-of-scope regions dragging the headline down.","enumValues":"$undefined"}],"returns":"JSON object: `{ counts, health, chains, coverage, lifecycle,\nlens, lens_digest, _hash }`. ~500 tokens vs ~5-8K for equivalent manual\nfetches.","returnShape":"{ counts, health, chains, coverage, lifecycle, lens, lens_digest, _hash }","returnNotes":["~500 tokens vs ~5-8K for equivalent manual fetches."],"examples":[{"description":"Live call against the Notion example graph.","input":"{}","output":"$2e"}],"warnings":[],"see":["get_product_context"],"source":"src/tools/context.ts:246","atomicity":"atomic (read-only)"},{"name":"get_product_context","slug":"get-product-context","description":"Product summary, entity counts by type, and a human-readable graph overview. Call first to understand the file. Pass include_summary for edge counts, orphans, and edges-by-type.","domain":"context","groupId":"context","args":[{"name":"include_summary","type":"boolean","required":false,"description":"Include detailed graph statistics (edge counts by type, orphan count)","enumValues":"$undefined"},{"name":"if_changed_since","type":"string","required":false,"description":"Hash from a previous response. Returns { changed: false } if graph unchanged.","enumValues":"$undefined"}],"returns":"Markdown string with product header, lens preamble, entity counts,\nactive-domain creation sequences, and `_hash` footer for `if_changed_since`\ndiffing.","returnShape":"$undefined","returnNotes":["Markdown string with product header, lens preamble, entity counts, active-domain creation sequences, and `_hash` footer for `if_changed_since` diffing."],"examples":[{"description":"Live call against the Notion example graph.","input":"{}","output":"$2f"}],"warnings":[],"see":["get_graph_digest","get_entity_schema"],"source":"src/tools/context.ts:56","atomicity":"atomic (read-only)"},{"name":"get_session_context","slug":"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).","domain":"context","groupId":"context","args":[],"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.","returnShape":"{ lens, skills_invoked, recommendations_given, recommendations_to_avoid, focus_area, custom, skills_count, last_skill, last_recommendation }","returnNotes":["`recommendations_to_avoid` is the deduped list of every recommendation given this session; runners should filter their next recommendation against this array rather than re-deriving the dedup rule from prose."],"examples":[{"description":"Live call against the Notion example graph.","input":"{}","output":"{\n \"lens\": \"product\",\n \"skills_invoked\": [],\n \"recommendations_given\": [],\n \"recommendations_to_avoid\": [],\n \"focus_area\": null,\n \"custom\": {},\n \"skills_count\": 0,\n \"last_skill\": null,\n \"last_recommendation\": null\n}"}],"warnings":[],"see":["update_session_context"],"source":"src/tools/context.ts:428","atomicity":"atomic (read-only)"},{"name":"start","slug":"start","description":"Zero-state on-ramp: \"there is nothing here yet, where do I begin?\". Reads the live graph and, for an empty or barely-started graph, recommends the first canonical playbook (from UPG_PLAYBOOKS) plus the exact create_node call for its anchor entity. Established graphs are routed to plan / inspect / get_graph_digest instead. Takes no arguments.","domain":"context","groupId":"context","args":[],"returns":"JSON: `{ graph_state: \"empty\" | \"young\" | \"established\", product,\nnode_count, recommended_playbook?, first_action?, recommendation,\nnext_tools }`. `recommended_playbook` and `first_action` are present only\nfor empty/young graphs.","returnShape":"{ graph_state: \"empty\" | \"young\" | \"established\", product, node_count, recommended_playbook?, first_action?, recommendation, next_tools }","returnNotes":["`recommended_playbook` and `first_action` are present only for empty/young graphs."],"examples":["// Input (empty graph):\n{}\n// Output (truncated):\n{\n \"graph_state\": \"empty\",\n \"node_count\": 0,\n \"recommended_playbook\": { \"id\": \"playbook:users-needs\", \"name\": \"Users & Needs\", \"target_anchor_entity\": \"persona\" },\n \"first_action\": { \"tool\": \"create_node\", \"args\": { \"type\": \"persona\", \"title\": \"\" } },\n \"recommendation\": \"Your graph is empty. Begin with the \\\"Users & Needs\\\" playbook: create your first persona.\"\n}"],"warnings":[],"see":["plan","get_playbook","list_playbooks","get_graph_digest"],"source":"src/tools/context.ts:337","atomicity":"atomic (read-only)"},{"name":"submit_feedback","slug":"submit-feedback","description":"Send feedback about the Unified Product Graph (a bug, a feature request, an observation) to the project's triage queue at unifiedproductgraph.org, from any MCP client. Anonymous; no account. SHAPE IT FIRST for actionability, asking the user at most one round of questions (don't guess): a bug wants steps to reproduce, expected vs actual, and severity (`details`); a feature_request wants the underlying problem, the desired outcome, and any current workaround (`details`). CONSENT IS REQUIRED: the tool sends NOTHING unless you pass confirmed:true. Call it first WITHOUT confirmed to get back the exact payload, show that payload to the user (including the auto-collected `context`), and only re-call with confirmed:true after they say yes. PRIVACY: `context` is auto-assembled from the MCP client name/version, the server version, the runtime, and graph SIZE counts only; it never includes node titles, descriptions, or any graph content.","domain":"context","groupId":"context","args":[{"name":"type","type":"string","required":true,"description":"Intake type: \"bug\" (something is broken), \"feature_request\" (something is missing), \"observation\" (a note/pattern worth recording), or \"general\".","enumValues":["bug","feature_request","observation","general"]},{"name":"title","type":"string","required":true,"description":"A concise one-line summary (≤200 chars).","enumValues":"$undefined"},{"name":"description","type":"string","required":true,"description":"The full report (≤5000 chars). Make it actionable: enough for someone to act without a follow-up.","enumValues":"$undefined"},{"name":"details","type":"object","required":false,"description":"Type-aware structured fields (optional). For a bug: steps_to_reproduce, expected, actual, severity (low|medium|high|critical). For a feature_request: problem, desired_outcome, workaround. Ignored for observation/general.","enumValues":"$undefined"},{"name":"product_stage","type":"string","required":false,"description":"Optional product stage the reporter is working at.","enumValues":"$undefined"},{"name":"confirmed","type":"boolean","required":false,"description":"CONSENT GATE. Must be true to actually send. Omit (or false) to get back a preview of the exact payload and send nothing.","enumValues":"$undefined"}],"returns":"On send: `{ status: \"submitted\", id, message }`. Without consent:\n`{ status: \"confirmation_required\", preview }`. On a rejected/failed POST:\nan error result with a clear message (401 bad key, 429 rate-limited, …).","returnShape":"$undefined","returnNotes":["On send: `{ status: \"submitted\", id, message }`.","Without consent: `{ status: \"confirmation_required\", preview }`.","On a rejected/failed POST: an error result with a clear message (401 bad key, 429 rate-limited, …)."],"examples":[],"warnings":[],"see":[],"source":"src/tools/feedback.ts:171","atomicity":"atomic (single outbound POST). Never reads or writes the local graph."},{"name":"update_session_context","slug":"update-session-context","description":"Update session context: register a skill invocation, record a recommendation, set focus area, switch lens, or store custom state for cross-skill coordination.","domain":"context","groupId":"context","args":[{"name":"skill_invoked","type":"string","required":false,"description":"Register that this skill was just invoked (e.g. \"upg-show-status\")","enumValues":"$undefined"},{"name":"recommendation","type":"string","required":false,"description":"Record a recommendation given to the user (e.g. \"Run /upg-new-strategy to fill strategy gap\")","enumValues":"$undefined"},{"name":"focus_area","type":"string","required":false,"description":"Set the current focus area (e.g. \"strategy\", \"validation\", \"user_research\")","enumValues":"$undefined"},{"name":"lens","type":"string","required":false,"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.","enumValues":["product","ux_design","engineering","growth","business","research","marketing","competitive","full"]},{"name":"persist_lens","type":"boolean","required":false,"description":"If true, also save the lens to the .upg file so it persists across sessions","enumValues":"$undefined"},{"name":"custom","type":"object","required":false,"description":"Arbitrary key-value pairs for cross-skill state","enumValues":"$undefined"}],"returns":"JSON: `{ updated: true, session: SessionContext }` reflecting the\nnew state.","returnShape":"{ updated: true, session: SessionContext }","returnNotes":["reflecting the new state."],"examples":[{"description":"Live call against the Notion example graph.","input":"{}","output":"{\n \"updated\": true,\n \"session\": {\n \"lens\": \"product\",\n \"skills_invoked\": [],\n \"recommendations_given\": [],\n \"focus_area\": null,\n \"custom\": {}\n }\n}"}],"warnings":[],"see":["get_session_context"],"source":"src/tools/context.ts:469","atomicity":"non-atomic. Session mutates in-memory immediately; lens\npersistence flushes the .upg file as a separate side-effect that may\nsucceed or fail independently of the session update."}]},{"id":"nodes","label":"Nodes","description":"Create, read, update, delete, search, move, batch, and deduplicate nodes.","tools":[{"name":"batch_create_nodes","slug":"batch-create-nodes","description":"Create up to 50 entities in one atomic call, optionally with explicit edges in the same transaction. Reference earlier nodes from `parent_ref` / `edges` by a positional `$N` (\"$0\", \"$1\") OR by a batch-local `ref` alias declared on a node (e.g. ref:\"persona_dev\" then from_ref:\"persona_dev\"); aliases remove the index-counting that most often breaks a batch. `edges` endpoints also accept existing node IDs. All nodes and edges validate up front; on failure nothing lands and the response carries the full `errors` list plus the alias `ref_map`. Pass `validate_only: true` for a dry-run that reports every would-be error WITHOUT writing.","domain":"nodes","groupId":"nodes","args":[{"name":"nodes","type":"array","required":true,"description":"Array of nodes to create (max 50)","enumValues":"$undefined"},{"name":"edges","type":"array","required":false,"description":"Optional edges to create alongside the nodes (same atomic transaction). Each edge's from/to may be a `$N` ref into the `nodes` array, a declared `ref` alias, OR an existing node ID.","enumValues":"$undefined"},{"name":"validate_only","type":"boolean","required":false,"description":"Dry-run: run the full validation pass and report `{ valid, errors, would_create_nodes, would_create_edges }` WITHOUT writing. Lets an agent self-correct the whole batch before committing.","enumValues":"$undefined"},{"name":"expect_product","type":"string","required":false,"description":"Optional guard: abort if the active product is not this id/title/file. Cheap insurance against a forgotten switch_product writing into the wrong graph.","enumValues":"$undefined"}],"returns":"JSON: on commit, `{ created, edges, explicit_edges?, count,\nwarnings? }`. On `validate_only`, `{ validate_only, valid, errors,\nwould_create_nodes, would_create_edges, ref_map?, warnings? }`. On a failed\ncommit, a `{ error, errors?, ref_map? }` error envelope.","returnShape":"$undefined","returnNotes":["JSON: on commit, `{ created, edges, explicit_edges?, count, warnings? }`.","On `validate_only`, `{ validate_only, valid, errors, would_create_nodes, would_create_edges, ref_map?, warnings? }`.","On a failed commit, a `{ error, errors?, ref_map? }` error envelope."],"examples":[{"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_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() for canonical edges per type.\"\n ]\n}"}],"warnings":[],"see":["create_node","batch_create_edges"],"source":"src/tools/nodes.ts:1294","atomicity":"atomic-with-rollback. Full validation pass first, then commit.\n`validate_only` never mutates."},{"name":"batch_delete_nodes","slug":"batch-delete-nodes","description":"Delete up to 50 entities and their connected edges in one atomic call (all succeed or all fail).","domain":"nodes","groupId":"nodes","args":[{"name":"node_ids","type":"array","required":true,"description":"Array of node IDs to delete (max 50)","enumValues":"$undefined"},{"name":"expect_product","type":"string","required":false,"description":"Optional guard: abort if the active product is not this id/title/file.","enumValues":"$undefined"}],"returns":"JSON: `{ deleted, edges_removed, count }`.","returnShape":"{ deleted, edges_removed, count }","returnNotes":"$undefined","examples":[{"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\": 10,\n \"count\": 1\n}"}],"warnings":[],"see":["delete_node"],"source":"src/tools/nodes.ts:1476","atomicity":"atomic. Validation pass rejects the entire batch before any\nmutation lands."},{"name":"batch_update_nodes","slug":"batch-update-nodes","description":"Update up to 50 entities atomically (all succeed or all fail). Unspecified fields preserved. Properties merge with existing; pass `unset_properties` per entry to remove keys rather than writing a literal null. `key` is NOT updatable: an entry carrying one is refused and the whole batch lands nothing.","domain":"nodes","groupId":"nodes","args":[{"name":"updates","type":"array","required":true,"description":"Array of updates to apply (max 50)","enumValues":"$undefined"},{"name":"expect_product","type":"string","required":false,"description":"Optional guard: abort if the active product is not this id/title/file.","enumValues":"$undefined"}],"returns":"JSON: `{ updated, count, unset?, warnings? }`. `unset` maps node id\nto the keys actually removed. `warnings` carries lifecycle-phase hints\naggregated across the batch.","returnShape":"{ updated, count, unset?, warnings? }","returnNotes":["`unset` maps node id to the keys actually removed.","`warnings` carries lifecycle-phase hints aggregated across the batch."],"examples":[],"warnings":[],"see":["update_node"],"source":"src/tools/nodes.ts:1351","atomicity":"atomic. Validation pass rejects the entire batch before any\nmutation lands."},{"name":"create_node","slug":"create-node","description":"Create one entity, optionally with a parent edge. For 3+ entities, use `batch_create_nodes` instead of looping. Portfolio-scoped types (`portfolio`, `organization`, `product_area`) route to `.upg/portfolio.upg` rather than the active product's `nodes[]`.","domain":"nodes","groupId":"nodes","args":[{"name":"type","type":"string","required":true,"description":"UPG entity type (e.g. \"persona\", \"opportunity\"). Portfolio-scoped: \"portfolio\", \"organization\", \"product_area\".","enumValues":"$undefined"},{"name":"title","type":"string","required":true,"description":"Entity title","enumValues":"$undefined"},{"name":"description","type":"string","required":false,"description":"Optional description","enumValues":"$undefined"},{"name":"tags","type":"array","required":false,"description":"Freeform tags","enumValues":"$undefined"},{"name":"status","type":"string","required":false,"description":"Lifecycle status","enumValues":"$undefined"},{"name":"properties","type":"object","required":false,"description":"Type-specific fields","enumValues":"$undefined"},{"name":"parent_id","type":"string","required":false,"description":"Parent node ID. Creates an edge automatically. Ignored for portfolio-scoped types.","enumValues":"$undefined"},{"name":"key","type":"string","required":false,"description":"Optional citable key for this entity (e.g. \"LTN-311\"). Unique within the product across entity types, immutable once assigned, and never reused, so it is settable HERE and refused by update_node / batch_update_nodes. Supply one you already hold (an imported tracker key, or one your create surface chose); this tool never mints one for you.","enumValues":"$undefined"},{"name":"archived","type":"boolean","required":false,"description":"Sweep this entity out of default views. Orthogonal to `status`: an entity can be done and live, or done and archived, and those are different facts.","enumValues":"$undefined"},{"name":"archived_at","type":"string","required":false,"description":"ISO timestamp archived. Pairs with `archived: true`.","enumValues":"$undefined"},{"name":"overwrite_organization","type":"boolean","required":false,"description":"For type=\"organization\" only. When true, replaces the existing portfolio organisation instead of throwing.","enumValues":"$undefined"}],"returns":"JSON: `{ node, edge?, unknown_properties?, warning? }`. The `edge`\nfield is present only when `parent_id` was supplied and a canonical\nhierarchy edge could be inferred. `unknown_properties` and `warning` are\npresent when the caller passed properties not in the entity's schema.\nPass `strict: true` to reject unknown properties instead of\nwarning. For portfolio-scoped types the response shape is\n`{ node, portfolio_file, written_to, warning? }` where `node` is the\npersisted typed record.","returnShape":"{ node, edge?, unknown_properties?, warning? }","returnNotes":["The `edge` field is present only when `parent_id` was supplied and a canonical hierarchy edge could be inferred.","`unknown_properties` and `warning` are present when the caller passed properties not in the entity's schema.","Pass `strict: true` to reject unknown properties instead of warning.","For portfolio-scoped types the response shape is `{ node, portfolio_file, written_to, warning? }` where `node` is the persisted typed record."],"examples":[{"description":"Live call against the Notion example graph.","input":"{\n \"type\": \"person\",\n \"title\": \"Example node\"\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":[],"see":["batch_create_nodes","update_node"],"source":"src/tools/nodes.ts:916","atomicity":"atomic-with-rollback. Schema validation runs before mutation."},{"name":"deduplicate_nodes","slug":"deduplicate-nodes","description":"Find duplicate entities and return them grouped. `match: \"exact\"` (default) groups by identical title + type and can merge (dry_run previews; otherwise keeps one per group and redirects edges from the others). `match: \"similar\"` is a read-only SUGGESTION pass that surfaces near-duplicates exact matching misses: entities of the same type whose titles are fuzzy-similar (token overlap above `similarity_threshold`), plus metrics that share a `statistical_function` and an area with overlapping titles. It never merges; review the candidates and align them by hand (rename then run an exact pass, or `update_node` / `batch_delete_nodes`).","domain":"nodes","groupId":"nodes","args":[{"name":"type","type":"string","required":false,"description":"Only check this entity type. Omit to check all types.","enumValues":"$undefined"},{"name":"match","type":"string","required":false,"description":"\"exact\" (default) groups by identical title + type and can merge. \"similar\" is a read-only pass that surfaces fuzzy-title and same-statistical_function near-duplicates; it never merges.","enumValues":"$undefined"},{"name":"similarity_threshold","type":"number","required":false,"description":"For match: \"similar\" only. Title token-overlap (Jaccard) above which two same-type entities are flagged. 0 to 1, default 0.6.","enumValues":"$undefined"},{"name":"dry_run","type":"boolean","required":false,"description":"For match: \"exact\" only. Preview duplicates without merging (default true). Ignored for \"similar\", which never mutates.","enumValues":"$undefined"},{"name":"keep","type":"string","required":false,"description":"Which duplicate to keep when merging: \"newest\" (default) or \"oldest\".","enumValues":"$undefined"}],"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 }`.","returnShape":"$undefined","returnNotes":["JSON: with `dry_run: true`, `{ duplicates, total_groups, total_duplicate_nodes, dry_run, message }`.","With `dry_run: false`, `{ merged: true, groups_merged, nodes_removed, edges_redirected, strategy }`."],"examples":[{"description":"Live call against the Notion example graph.","input":"{}","output":"$30"}],"warnings":["Default is `dry_run: true`. Pass `dry_run: false` to commit.\nIdempotent on retry: a second `dry_run: false` against an\nalready-deduplicated graph reports zero merges."],"see":["search_nodes","list_nodes","batch_delete_nodes","validate_graph"],"source":"src/tools/nodes.ts:1916","atomicity":"non-atomic. Merges are applied group-by-group; a mid-flight\nerror leaves earlier groups merged."},{"name":"delete_node","slug":"delete-node","description":"Remove one entity and all its connected edges. For 3+ entities, use `batch_delete_nodes`.","domain":"nodes","groupId":"nodes","args":[{"name":"node_id","type":"string","required":true,"description":"The node ID to delete","enumValues":"$undefined"}],"returns":"JSON: `{ node, removed_edge_ids }`.","returnShape":"{ node, removed_edge_ids }","returnNotes":"$undefined","examples":[{"description":"Live call against the Notion example graph.","input":"{\n \"node_id\": \"ec3d5479-4947-4bd9-9e77-b5ee01beb851\"\n}","output":"$31"}],"warnings":[],"see":["batch_delete_nodes"],"source":"src/tools/nodes.ts:1256","atomicity":"atomic. Node + cascading edges removed in one mutation."},{"name":"get_node","slug":"get-node","description":"Get a single entity by ID, with full properties and all connected edges.","domain":"nodes","groupId":"nodes","args":[{"name":"node_id","type":"string","required":true,"description":"The node ID. Alias: `id`.","enumValues":"$undefined"},{"name":"id","type":"string","required":false,"description":"Alias for `node_id`.","enumValues":"$undefined"},{"name":"compact_edges","type":"boolean","required":false,"description":"Omit source_title/target_title from edges (saves ~30% on edge-heavy nodes)","enumValues":"$undefined"}],"returns":"JSON: the node object plus an `edges` array. `compact_edges: true`\nomits `source_title` and `target_title` (saves ~30% on edge-heavy nodes).","returnShape":"$undefined","returnNotes":["JSON: the node object plus an `edges` array.","`compact_edges: true` omits `source_title` and `target_title` (saves ~30% on edge-heavy nodes)."],"examples":[{"description":"Live call against the Notion example graph.","input":"{\n \"node_id\": \"ec3d5479-4947-4bd9-9e77-b5ee01beb851\"\n}","output":"$32"}],"warnings":[],"see":["get_nodes"],"source":"src/tools/nodes.ts:203","atomicity":"atomic (read-only)"},{"name":"get_nodes","slug":"get-nodes","description":"Batch-fetch up to 50 entities by ID. Returns each node with its edges. Use instead of looping `get_node`. A bare id reads the active product; a qualified `{product_id}/{node_id}` (the form list_registry / export_edges / cross-edges return) reads that product cross-portfolio (read-only for non-active products), so a connective pass can fetch node content across graphs without a switch_product sweep. Cross-product results carry a `product_id`.","domain":"nodes","groupId":"nodes","args":[{"name":"ids","type":"array","required":true,"description":"Node IDs (max 50). Bare (active product) or qualified `{product_id}/{node_id}` for any product in the workspace.","enumValues":"$undefined"},{"name":"compact_edges","type":"boolean","required":false,"description":"Omit titles from edges","enumValues":"$undefined"}],"returns":"JSON array of node objects with edges. Missing IDs are silently\nskipped. May include a `degraded` block when the response was\nauto-trimmed to fit.","returnShape":"$undefined","returnNotes":["JSON array of node objects with edges.","Missing IDs are silently skipped.","May include a `degraded` block when the response was auto-trimmed to fit."],"examples":[{"description":"Live call against the Notion example graph.","input":"{\n \"ids\": [\n \"ec3d5479-4947-4bd9-9e77-b5ee01beb851\",\n \"1c051617-6cb7-4a59-b0a1-7779f404145b\"\n ]\n}","output":"$33"}],"warnings":["Pre-flight payload guardrail: refuses above\n`UPG_MCP_PAYLOAD_HARD_LIMIT` (default 150 KB), warns above\n`UPG_MCP_PAYLOAD_SOFT_LIMIT` (default 50 KB). 50 edge-heavy nodes can\nstill cross 50 KB. Pass `compact_edges:true` to halve edge size.","Auto-degrade: between soft and hard limits, the server\nmay drop edge titles, optional node fields, or truncate the result list.\nSurfaced as `degraded.applied[]` on the response."],"see":["get_node"],"source":"src/tools/nodes.ts:327","atomicity":"atomic (read-only)"},{"name":"get_tree","slug":"get-tree","description":"Assemble a canonical tree pattern (ost, okr, user, product, validation, strategy, feature_areas, delivery, architecture, journey, design_system, commercial, north_star, org) from the active product graph, server-side. Returns NESTED data (roots with children) plus structural `gaps` (nodes whose pattern expects children the graph lacks). Walks the pattern type-driven child map over the live graph, so it follows whatever edge wired a parent to a child of the expected type (no hardcoded edge names to drift). Roots at the pattern anchor, falling back through fallback anchors when the anchor has no nodes or reaches nothing, and reports the substitution in `anchor_resolved_from`/`anchor_used`. Rendering stays in the client. Composes with `query`.","domain":"nodes","groupId":"nodes","args":[{"name":"pattern","type":"string","required":true,"description":"Tree pattern id: ost, okr, user, product, validation, strategy, feature_areas, delivery, architecture, journey, design_system, commercial, north_star, or org.","enumValues":"$undefined"},{"name":"from_id","type":"string","required":false,"description":"Explicit root node id; otherwise the pattern canonical anchor.","enumValues":"$undefined"},{"name":"depth","type":"number","required":false,"description":"Max levels (default = the pattern natural depth; max 12).","enumValues":"$undefined"},{"name":"include_properties","type":"array","required":false,"description":"Node property keys to inline on each tree node.","enumValues":"$undefined"},{"name":"max_nodes","type":"number","required":false,"description":"Cap on nodes; the tree is summarised (stats.truncated) rather than silently cut (default 400, max 2000).","enumValues":"$undefined"},{"name":"configuration","type":"object","required":false,"description":"Read ONE configuration instead of the union. Maps a configuration_axis (by node id, or by title when unambiguous) to a single one of its values. Surfaces absent under that value are dropped, composition edges qualified to other values are dropped, and edges left dangling go with them. An unknown axis or value is an error, never a silent no-op. Omit to read the union, which is the default and unchanged behaviour.","enumValues":"$undefined"}],"returns":"JSON: `{ pattern, framework_id?, anchor_type, anchor_used,\nanchor_resolved_from?, roots: TreeNode[], stats: { nodes, levels, truncated },\ngaps: [{ node_id, type, title, missing }] }`. Structured data, never rendered text.","returnShape":"{ pattern, framework_id?, anchor_type, anchor_used, anchor_resolved_from?, roots: TreeNode[], stats: { nodes, levels, truncated }, gaps: [{ node_id, type, title, missing }] }","returnNotes":["Structured data, never rendered text."],"examples":[],"warnings":[],"see":["query","list_playbooks"],"source":"src/tools/tree.ts:45","atomicity":"atomic (read-only). Reads the active product only."},{"name":"list_nodes","slug":"list-nodes","description":"List entities with filtering, edge inclusion, count-only mode, and pagination. For graph-wide edge enumeration, prefer `export_edges` (flat) or `query` (traversal). `list_nodes(include_edges:true)` is for entity-scoped reads.","domain":"nodes","groupId":"nodes","args":[{"name":"type","type":"string","required":false,"description":"Filter by entity type","enumValues":"$undefined"},{"name":"status","type":"string","required":false,"description":"Filter by status value","enumValues":"$undefined"},{"name":"tags","type":"array","required":false,"description":"Filter by tags (matches any)","enumValues":"$undefined"},{"name":"parent_id","type":"string","required":false,"description":"Filter to children of this node (connected by outgoing edge from parent)","enumValues":"$undefined"},{"name":"include_edges","type":"boolean","required":false,"description":"Include compact edge data (id, type, source, target) per node","enumValues":"$undefined"},{"name":"count_only","type":"boolean","required":false,"description":"Return only the total count, no node data","enumValues":"$undefined"},{"name":"offset","type":"number","required":false,"description":"Skip N results (default 0)","enumValues":"$undefined"},{"name":"limit","type":"number","required":false,"description":"Max results (default 50, max 200)","enumValues":"$undefined"},{"name":"if_changed_since","type":"string","required":false,"description":"Hash from a previous response. Returns { changed: false } if graph unchanged.","enumValues":"$undefined"}],"returns":"JSON: `{ nodes, total, offset, limit, _hash }`. With\n`count_only: true`, returns `{ total, _hash }` only. May include a\n`degraded` block when the response was auto-trimmed to fit.","returnShape":"{ nodes, total, offset, limit, _hash }","returnNotes":["With `count_only: true`, returns `{ total, _hash }` only.","May include a `degraded` block when the response was auto-trimmed to fit."],"examples":[{"description":"Live call against the Notion example graph.","input":"{}","output":"$34"}],"warnings":["Pre-flight payload guardrail: refuses with a steering\nerror when the estimated response exceeds `UPG_MCP_PAYLOAD_HARD_LIMIT`\n(default 150 KB), and attaches a `_warning` field above\n`UPG_MCP_PAYLOAD_SOFT_LIMIT` (default 50 KB). For graph-wide reads,\nprefer `query` with a tight projection.","Auto-degrade: between the soft and hard limits, the\nresponse is automatically truncated. Surfaced as\n`degraded.applied: ['truncate_at_count_auto']` on the response."],"see":["search_nodes","query"],"source":"src/tools/nodes.ts:101","atomicity":"atomic (read-only)"},{"name":"migrate_properties","slug":"migrate-properties","description":"Apply `UPG_PROPERTY_MIGRATIONS` graph-wide with no type rename or edge migration. Pure property pass over all kinds: `drop_props`, `rename_top_level`, `lift_property_to_top_level`, `drop_when_self_referential`, `remap_property_value` (stale enum values, e.g. the 0.9.12 data_flow / integration_pattern / api_contract / service tightenings), and `reshape_value_to_assessment` (a bare number wrapped into an assessment object on its scale, e.g. the 0.10.2 market_trend impact / relevance). `validate_graph` property_drift now surfaces every value-aware rule, so a graph that went invalid on a tightening points here. Default `dry_run=true` previews the per-rule change set; pass `dry_run=false` to commit. Use when you want property cleanup standalone; `migrate_type` folds the same pass into its rename.","domain":"nodes","groupId":"nodes","args":[{"name":"dry_run","type":"boolean","required":false,"description":"Preview changes without applying (default true). Pass false to commit.","enumValues":"$undefined"}],"returns":"JSON: `{ top_level_renames, lifted_properties, dropped_props,\ndropped_self_referential, dry_run }`.","returnShape":"{ top_level_renames, lifted_properties, dropped_props, dropped_self_referential, dry_run }","returnNotes":"$undefined","examples":[{"description":"Live call against the Notion example graph.","input":"{}","output":"$35"}],"warnings":["Default is `dry_run: true`. Pass `dry_run: false` to commit.\nRe-running with `dry_run: true` after a successful commit reports zero\nchanges (idempotent on the canonical-properties shape)."],"see":["migrate_type","validate_graph","list_type_migrations"],"source":"src/tools/nodes.ts:1670","atomicity":"non-atomic. Mutations are applied node-by-node; a mid-flight\nerror may leave the graph partially migrated."},{"name":"migrate_status","slug":"migrate-status","description":"Apply `UPG_STATUS_MIGRATIONS` graph-wide: rewrite legacy lifecycle status values to canonical phase ids. Auto-mode (no filters) selects nodes whose current status is invalid against the entity type's lifecycle and has a registered replacement (the same invariant that drives `validate_graph` lifecycle_drift). Surgical mode (`from_status` + `to_status`) overrides the registry and rewrites every (entity_type?, from_status) match. Nodes with invalid statuses but no registered replacement surface under `skipped_no_migration`. Default `dry_run=true`; pass `dry_run=false` to commit.","domain":"nodes","groupId":"nodes","args":[{"name":"entity_type","type":"string","required":false,"description":"Optional. Restrict the rewrite to nodes of this canonical entity type (e.g. \"service\", \"feature\").","enumValues":"$undefined"},{"name":"from_status","type":"string","required":false,"description":"Optional. Restrict the rewrite to nodes whose current status equals this exact value. When provided, `to_status` is required and the registry is bypassed.","enumValues":"$undefined"},{"name":"to_status","type":"string","required":false,"description":"Required when `from_status` is provided. The canonical phase id to write.","enumValues":"$undefined"},{"name":"dry_run","type":"boolean","required":false,"description":"Preview changes without applying (default true). Pass false to commit.","enumValues":"$undefined"}],"returns":"JSON: `MigrateStatusResult`.","returnShape":"$undefined","returnNotes":["JSON: `MigrateStatusResult`."],"examples":[{"description":"Live call against the Notion example graph.","input":"{}","output":"{\n \"migrated_nodes\": 0,\n \"skipped_no_migration\": 0,\n \"changes\": [],\n \"dry_run\": true\n}"}],"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)."],"see":["migrate_type","migrate_properties","validate_graph","list_lifecycles"],"source":"src/tools/migrations.ts:64","atomicity":"per-node. Status writes go through `store.updateNode`\none at a time. Dry-run is read-only."},{"name":"migrate_type","slug":"migrate-type","description":"Migrate every entity of one type to another, applying defaults from `UPG_MIGRATIONS`. Three passes commit as one write: (1) node rename, (2) edges through `UPG_EDGE_MIGRATIONS` (catalog-aware renames, direction flips, drops; endpoint guards check post-migration types; uncatalogued edges surface as `unmapped_legacy_edges`), (3) every node through `UPG_PROPERTY_MIGRATIONS` (top-level renames, lifts, drops, self-referential cleanup). Type-specific property rules see the post-rename type.","domain":"nodes","groupId":"nodes","args":[{"name":"from_type","type":"string","required":true,"description":"The current entity type to migrate FROM","enumValues":"$undefined"},{"name":"to_type","type":"string","required":true,"description":"The new entity type to migrate TO","enumValues":"$undefined"},{"name":"dry_run","type":"boolean","required":false,"description":"Preview changes without applying (default false)","enumValues":"$undefined"}],"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).","returnShape":"{ migrated_nodes, migrated_edges, edge_renames, dropped_edges, unmapped_legacy_edges, defaults_applied, dry_run }","returnNotes":["`edge_renames` is `[{ id, from, to, flipped }]`; `dropped_edges` is `[{ id, from }]`; `unmapped_legacy_edges` is `[{ type, count }]`.","`migrated_edges` is the total mutated count (renames + drops)."],"examples":[{"description":"Live call against the Notion example graph.","input":"{\n \"from_type\": \"jtbd\",\n \"to_type\": \"job\",\n \"dry_run\": true\n}","output":"{\n \"migrated_nodes\": 0,\n \"migrated_edges\": 0,\n \"edge_renames\": [],\n \"dropped_edges\": [],\n \"unmapped_legacy_edges\": [],\n \"defaults_applied\": null,\n \"dry_run\": true\n}"}],"warnings":[],"see":["rename_edge_type","export_edges","update_node"],"source":"src/tools/nodes.ts:1530","atomicity":"atomic. Single store-level migration call commits or fails as\none mutation. Note: full graph canonicalisation runs as a side-effect of\nany node-type migration, so unrelated legacy edges may also be retargeted."},{"name":"promote_scalars_to_edges","slug":"promote-scalars-to-edges","description":"Apply `UPG_SCALAR_TO_EDGE_MIGRATIONS` graph-wide (P14 conformance): promote scalar properties that name a first-class entity into canonical edges. Per rule: find-or-create the referenced entity by normalized title, link it with the canonical edge, then drop the now-redundant scalar (unless the rule keeps it as an actor display-cache). Lossless (the string becomes a real node) and idempotent (re-running mints/links nothing new). Snapshot the .upg first. Default `dry_run=true` previews the per-rule plan (minted / linked / dropped / skipped); pass `dry_run=false` to commit. The rules are listed by `list_scalar_to_edge_migrations`.","domain":"nodes","groupId":"nodes","args":[{"name":"dry_run","type":"boolean","required":false,"description":"Preview changes without applying (default true). Pass false to commit.","enumValues":"$undefined"}],"returns":"JSON: the `ApplyScalarToEdgeResult` plus `dry_run`.","returnShape":"$undefined","returnNotes":["JSON: the `ApplyScalarToEdgeResult` plus `dry_run`."],"examples":[],"warnings":[],"see":["list_scalar_to_edge_migrations","migrate_properties"],"source":"src/tools/nodes.ts:1719","atomicity":"atomic per call (one save)"},{"name":"query","slug":"query","description":"Traverse the graph following typed edges. Returns a subgraph (nodes + edges) in a single call. Example: query({ from: \"persona\", traverse: [\"persona_pursues_job\", \"job_surfaces_need\"], depth: 2 })","domain":"nodes","groupId":"nodes","args":[{"name":"from","type":"string","required":false,"description":"Start from all nodes of this type","enumValues":"$undefined"},{"name":"from_id","type":"string","required":false,"description":"Start from a specific node ID (alternative to from)","enumValues":"$undefined"},{"name":"traverse","type":"array","required":false,"description":"Edge types to follow at each level (in order). If omitted, follows all edges. Prefix with ! to exclude (e.g. \"!product_builds_feature\").","enumValues":"$undefined"},{"name":"depth","type":"number","required":false,"description":"Max traversal depth (default 3, max 10)","enumValues":"$undefined"},{"name":"include","type":"array","required":false,"description":"Fields to include per node: \"title\", \"status\", \"tags\", \"description\", \"properties\" (default: title, status, type)","enumValues":"$undefined"},{"name":"limit","type":"number","required":false,"description":"Max nodes to return (default 200, max 1000)","enumValues":"$undefined"},{"name":"edge_include","type":"array","required":false,"description":"Edge fields to return: \"id\", \"type\", \"source\", \"target\". Empty array = no edges. Default: all fields.","enumValues":"$undefined"},{"name":"property_include","type":"array","required":false,"description":"When \"properties\" is in include, only return these property keys (e.g. [\"severity\", \"importance\"])","enumValues":"$undefined"},{"name":"diff_from","type":"string","required":false,"description":"Result ID from a previous query. Returns added/removed NODES, plus added/removed EDGES when `edge_include` asks for edges. Two calls that differ only by `configuration` therefore diff one configuration against another.","enumValues":"$undefined"},{"name":"configuration","type":"object","required":false,"description":"Read ONE configuration instead of the union. Maps a configuration_axis (by node id, or by title when unambiguous) to a single one of its values. Surfaces absent under that value are dropped, composition edges qualified to other values are dropped, and edges left dangling go with them. An unknown axis or value is an error, never a silent no-op. Omit to read the union, which is the default and unchanged behaviour.","enumValues":"$undefined"}],"returns":"JSON: `{ nodes, edges, total_nodes, total_edges, _result_id,\ntruncated?, truncated_at_depth?, diff? }`. The `_result_id` is a cache\nhandle for `diff_from`; cache holds the last 20 results.","returnShape":"{ nodes, edges, total_nodes, total_edges, _result_id, truncated?, truncated_at_depth?, diff? }","returnNotes":["The `_result_id` is a cache handle for `diff_from`; cache holds the last 20 results."],"examples":[{"description":"Live call against the Notion example graph.","input":"{\n \"from\": \"persona\",\n \"traverse\": [\n \"persona_pursues_job\"\n ],\n \"depth\": 1,\n \"limit\": 5,\n \"include\": [\n \"title\"\n ],\n \"edge_include\": []\n}","output":"{\n \"nodes\": [\n {\n \"id\": \"9cd363dc-b1be-4132-b1dc-043467866e57\",\n \"type\": \"persona\",\n \"title\": \"Akira the Admin\"\n },\n {\n \"id\": \"65234b60-eb2b-4c41-be63-7b17b2bc6a38\",\n \"type\": \"persona\",\n \"title\": \"Theo the Consultant\"\n },\n {\n \"id\": \"e956a8ef-288f-4ee2-b758-2a14b9d07206\",\n \"type\": \"persona\",\n \"title\": \"Lin the Thinker\"\n },\n {\n \"id\": \"2e8dd86d-6085-4068-a804-38d3e891ea1b\",\n \"type\": \"persona\",\n \"title\": \"Maya the Maker\"\n },\n {\n \"id\": \"7b2e7c5a-a73e-42c9-9416-e9e9ccfecc20\",\n \"type\": \"job\",\n \"title\": \"Build a team system that survives growth\"\n }\n ],\n \"edges\": [],\n \"total_nodes\": 5,\n \"total_edges\": 0,\n \"truncated\": true,\n \"truncated_at_depth\": 0,\n \"hint\": \"Limit of 5 nodes reached at depth 0. Increase limit to see deeper results.\",\n \"_result_id\": \"qr_1\"\n}"}],"warnings":["Pre-flight payload guardrail: refuses above\n`UPG_MCP_PAYLOAD_HARD_LIMIT` (default 150 KB), warns above\n`UPG_MCP_PAYLOAD_SOFT_LIMIT` (default 50 KB). Tighten with `include`\n(e.g. `[\"title\"]`) or `edge_include: []` to drop edges from the wire."],"see":["list_nodes","get_area_graph"],"source":"src/tools/nodes.ts:532","atomicity":"atomic (read-only)"},{"name":"search_nodes","slug":"search-nodes","description":"Search entities by text. Default fields: title (score 3) and description (score 1). Add `fields` to include tags (score 2) and properties (score 1). Results include `matched_field`.","domain":"nodes","groupId":"nodes","args":[{"name":"query","type":"string","required":true,"description":"Search text (case-insensitive substring match)","enumValues":"$undefined"},{"name":"type","type":"string","required":false,"description":"Optional type filter","enumValues":"$undefined"},{"name":"fields","type":"array","required":false,"description":"Fields to search: \"title\", \"description\", \"tags\", \"properties\" (default: title + description)","enumValues":"$undefined"},{"name":"limit","type":"number","required":false,"description":"Max results (default 20, max 100)","enumValues":"$undefined"}],"returns":"JSON: `{ results: Array<{ id, type, title, status, tags,\nmatch_field, score }>, total, searched_fields }`.","returnShape":"{ results: Array<{ id, type, title, status, tags, match_field, score }>, total, searched_fields }","returnNotes":"$undefined","examples":[{"description":"Live call against the Notion example graph.","input":"{\n \"query\": \"Notion\"\n}","output":"$36"}],"warnings":[],"see":["list_nodes","query"],"source":"src/tools/nodes.ts:481","atomicity":"atomic (read-only)"},{"name":"update_node","slug":"update-node","description":"Update one entity. Unspecified fields are preserved. `key` is NOT updatable: it is minted once at create, never reused, and passing it here is refused rather than ignored. Passing `type` performs an atomic single-node migration: every incident edge is re-inferred against the catalog and rollback applies on failure. For 3+ entities, use `batch_update_nodes`.","domain":"nodes","groupId":"nodes","args":[{"name":"node_id","type":"string","required":true,"description":"The node ID to update","enumValues":"$undefined"},{"name":"type","type":"string","required":false,"description":"Change the entity type. Atomic single-node migration: validates against UPG_TYPES, rewrites incident edges to canonical types.","enumValues":"$undefined"},{"name":"title","type":"string","required":false,"description":"","enumValues":"$undefined"},{"name":"description","type":"string","required":false,"description":"","enumValues":"$undefined"},{"name":"tags","type":"array","required":false,"description":"","enumValues":"$undefined"},{"name":"status","type":"string","required":false,"description":"","enumValues":"$undefined"},{"name":"properties","type":"object","required":false,"description":"Merged with existing properties","enumValues":"$undefined"},{"name":"archived","type":"boolean","required":false,"description":"Sweep this entity out of default views. Orthogonal to `status`: an entity can be done and live, or done and archived, and those are different facts.","enumValues":"$undefined"},{"name":"archived_at","type":["string","null"],"required":false,"description":"ISO timestamp archived. Pairs with `archived: true`. Pass null to clear it.","enumValues":"$undefined"},{"name":"unset_properties","type":"array","required":false,"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.","enumValues":"$undefined"}],"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.","returnShape":"{ node, warning?, unknown_properties?, unset? }","returnNotes":["`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."],"examples":[{"description":"Live call against the Notion example graph.","input":"{\n \"node_id\": \"ec3d5479-4947-4bd9-9e77-b5ee01beb851\"\n}","output":"{\n \"node\": {\n \"id\": \"ec3d5479-4947-4bd9-9e77-b5ee01beb851\",\n \"type\": \"product\",\n \"title\": \"Notion (SATURATED test graph)\",\n \"slug\": \"notion-saturated-test-graph\"\n }\n}"}],"warnings":[],"see":["migrate_type","batch_update_nodes"],"source":"src/tools/nodes.ts:1122","atomicity":"atomic-with-rollback (when `type` is changed); atomic for\nshallow-merge patches."}]},{"id":"edges","label":"Edges","description":"Create, read, delete, export, rename, and resolve edge types.","tools":[{"name":"batch_create_edges","slug":"batch-create-edges","description":"Create up to 50 edges in one atomic call. Use this for 3+ edges instead of looping `create_edge`. Edge type auto-infers when omitted. Pass `validate_only: true` for a dry-run that reports every would-be error WITHOUT writing.","domain":"edges","groupId":"edges","args":[{"name":"edges","type":"array","required":true,"description":"Array of edges to create (max 50)","enumValues":"$undefined"},{"name":"validate_only","type":"boolean","required":false,"description":"Dry-run: validate every edge and report `{ valid, errors, would_create_edges }` WITHOUT writing.","enumValues":"$undefined"},{"name":"expect_product","type":"string","required":false,"description":"Optional guard: abort if the active product is not this id/title/file.","enumValues":"$undefined"}],"returns":"JSON: on commit, `{ created, count }`. On `validate_only`,\n`{ validate_only, valid, errors, would_create_edges }`.","returnShape":"$undefined","returnNotes":["JSON: on commit, `{ created, count }`.","On `validate_only`, `{ validate_only, valid, errors, would_create_edges }`."],"examples":[],"warnings":[],"see":["create_edge"],"source":"src/tools/edges.ts:457","atomicity":"atomic. Full validation pass before any mutation lands.\n`validate_only` never mutates."},{"name":"batch_delete_edges","slug":"batch-delete-edges","description":"Delete up to 50 edges in one atomic call (all succeed or all fail).","domain":"edges","groupId":"edges","args":[{"name":"edge_ids","type":"array","required":true,"description":"Array of edge IDs to delete (max 50)","enumValues":"$undefined"},{"name":"expect_product","type":"string","required":false,"description":"Optional guard: abort if the active product is not this id/title/file.","enumValues":"$undefined"}],"returns":"JSON: `{ deleted, count }`.","returnShape":"{ deleted, count }","returnNotes":"$undefined","examples":[{"description":"Live call against the Notion example graph.","input":"{\n \"edge_ids\": [\n \"8a3b23fd-172e-4151-8283-aee40eeb4c0d\"\n ]\n}","output":"{\n \"deleted\": [\n {\n \"id\": \"8a3b23fd-172e-4151-8283-aee40eeb4c0d\",\n \"type\": \"opportunity_drives_solution\"\n }\n ],\n \"count\": 1\n}"}],"warnings":[],"see":["delete_edge"],"source":"src/tools/edges.ts:612","atomicity":"atomic. Validation pass rejects the batch before any mutation\nlands."},{"name":"batch_move_nodes","slug":"batch-move-nodes","description":"Apply up to 50 atomic re-parents. All moves validate against the schema first; any failure rolls back the whole batch.","domain":"edges","groupId":"edges","args":[{"name":"moves","type":"array","required":true,"description":"","enumValues":"$undefined"}],"returns":"JSON: `{ moves, warnings? }` mirroring the per-move result of\n`move_node`.","returnShape":"{ moves, warnings? }","returnNotes":["mirroring the per-move result of `move_node`."],"examples":[],"warnings":[],"see":["move_node"],"source":"src/tools/edges.ts:417","atomicity":"atomic-with-rollback."},{"name":"create_edge","slug":"create-edge","description":"Create one edge between two nodes. Edge type auto-infers when omitted. Target accepts an ID, or a title+type pair the server resolves. For 3+ edges, use `batch_create_edges`.","domain":"edges","groupId":"edges","args":[{"name":"source_id","type":"string","required":true,"description":"Source node ID","enumValues":"$undefined"},{"name":"target_id","type":"string","required":false,"description":"Target node ID","enumValues":"$undefined"},{"name":"target_title","type":"string","required":false,"description":"Target node title (alternative to target_id; requires target_type).","enumValues":"$undefined"},{"name":"target_type","type":"string","required":false,"description":"Target node type (used with target_title for resolution)","enumValues":"$undefined"},{"name":"type","type":"string","required":false,"description":"Edge type. Auto-inferred if omitted.","enumValues":"$undefined"},{"name":"properties","type":"object","required":false,"description":"Edge-scoped properties. Only permitted on edge types that opt in (currently framework_exercise_includes_node); rejected on plain semantic edges.","enumValues":"$undefined"}],"returns":"JSON: the created edge object plus optional resolution metadata.","returnShape":"$undefined","returnNotes":["JSON: the created edge object plus optional resolution metadata."],"examples":["// Wire a persona to a job using the canonical edge type persona_pursues_job\n// Input:\n{ \"source_id\": \"persona_01\", \"target_id\": \"job_03\", \"type\": \"persona_pursues_job\" }\n// Output (truncated):\n{\n \"edge\": { \"id\": \"edge_15\", \"type\": \"persona_pursues_job\", \"source\": \"persona_01\", \"target\": \"job_03\" },\n \"inferred\": false\n}"],"warnings":[],"see":["batch_create_edges","resolve_edge_for_pair","list_edge_types","get_edge_type"],"source":"src/tools/edges.ts:283","atomicity":"atomic. Single store mutation."},{"name":"delete_edge","slug":"delete-edge","description":"Remove one edge by ID.","domain":"edges","groupId":"edges","args":[{"name":"edge_id","type":"string","required":true,"description":"The edge ID to delete","enumValues":"$undefined"}],"returns":"JSON: the removed edge object.","returnShape":"$undefined","returnNotes":["JSON: the removed edge object."],"examples":[],"warnings":[],"see":["batch_delete_edges","export_edges","repair_dangling_edges"],"source":"src/tools/edges.ts:362","atomicity":"atomic."},{"name":"export_edges","slug":"export-edges","description":"Flat edge enumeration. Returns every edge of the listed `types` (or all edges when `types` is omitted) as `{id, source, target, type}` with no parent-node payload. Right for migration and canonicalisation passes. Paginates via offset/limit.","domain":"edges","groupId":"edges","args":[{"name":"types","type":"array","required":false,"description":"Filter by exact edge-type match. Omit to enumerate every edge in the document.","enumValues":"$undefined"},{"name":"offset","type":"number","required":false,"description":"Skip N results (default 0)","enumValues":"$undefined"},{"name":"limit","type":"number","required":false,"description":"Max results (default 500, max 2000)","enumValues":"$undefined"},{"name":"if_changed_since","type":"string","required":false,"description":"Hash from a previous response. Returns { changed: false } if graph unchanged.","enumValues":"$undefined"}],"returns":"JSON: `{ edges, total, offset, limit, types?, _hash }`. Each edge\ncarries `{ id, source, target, type, mapping_confidence? }`.","returnShape":"{ edges, total, offset, limit, types?, _hash }","returnNotes":["Each edge carries `{ id, source, target, type, mapping_confidence? }`."],"examples":[{"description":"Live call against the Notion example graph.","input":"{}","output":"$37"}],"warnings":[],"see":["query","list_nodes"],"source":"src/tools/edges.ts:722","atomicity":"atomic (read-only)"},{"name":"move_node","slug":"move-node","description":"Atomic re-parent. Removes any existing hierarchy edge and creates a new one to `new_parent_id`. Validates against `UPG_EDGE_CATALOG` first; rolls back fully on failure.","domain":"edges","groupId":"edges","args":[{"name":"node_id","type":"string","required":true,"description":"The node to re-parent","enumValues":"$undefined"},{"name":"new_parent_id","type":"string","required":true,"description":"The new parent node id","enumValues":"$undefined"},{"name":"new_edge_type","type":"string","required":false,"description":"Optional override. Must be a key in UPG_EDGE_CATALOG. If omitted, the edge type is inferred from new_parent.type → node.type.","enumValues":"$undefined"},{"name":"old_edge_id","type":"string","required":false,"description":"Required when the node has more than one hierarchy edge. Picks which one to delete.","enumValues":"$undefined"}],"returns":"JSON: `{ moved: true, node_id, new_parent_id, new_edge,\nold_edge_id?, warning? }`. The internal `removed_edge` field is stripped\nfrom the wire payload.","returnShape":"{ moved: true, node_id, new_parent_id, new_edge, old_edge_id?, warning? }","returnNotes":["The internal `removed_edge` field is stripped from the wire payload."],"examples":[],"warnings":[],"see":["batch_move_nodes"],"source":"src/tools/edges.ts:389","atomicity":"atomic-with-rollback. Pre-validates the new edge before\ntouching the old one."},{"name":"rename_edge_type","slug":"rename-edge-type","description":"Exact-match rename of every edge of type `from` to type `to`, optionally flipping source/target. Single transactional pass. Defaults to `dry_run: true`; pass `dry_run: false` to commit. Low-level primitive: skips catalog validation. Use catalog-aware migration tools for validated renames.","domain":"edges","groupId":"edges","args":[{"name":"from","type":"string","required":true,"description":"Current edge type (exact match)","enumValues":"$undefined"},{"name":"to","type":"string","required":true,"description":"New edge type to assign","enumValues":"$undefined"},{"name":"flip","type":"boolean","required":false,"description":"When true, swap source/target on each renamed edge (default false)","enumValues":"$undefined"},{"name":"dry_run","type":"boolean","required":false,"description":"Preview without mutating (default true)","enumValues":"$undefined"}],"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 }`.","returnShape":"$undefined","returnNotes":["JSON: with `dry_run: true`, `{ dry_run, from, to, flip, would_rename, sample }`.","With `dry_run: false`, `{ dry_run, from, to, flip, renamed, ids }`."],"examples":[],"warnings":[],"see":["migrate_type","export_edges"],"source":"src/tools/edges.ts:840","atomicity":"atomic. Single-pass mutation; an empty match-set is a clean\nno-op rather than an error."},{"name":"repair_dangling_edges","slug":"repair-dangling-edges","description":"Inspect or drop edges whose source or target node fails to resolve. Each is classified `expected` (cross-product, sibling not loaded; keep), `suspect` (cross-product, missing product-id annotation), or `corrupt` (broken endpoint on a non-cross edge). Defaults to `dry_run: true`. Pass `dry_run: false` plus `drop: [\"suspect\", \"corrupt\"]` to remove.","domain":"edges","groupId":"edges","args":[{"name":"dry_run","type":"boolean","required":false,"description":"When true (default), returns the classification report without mutating. When false, drops edges matching `drop`.","enumValues":"$undefined"},{"name":"drop","type":"array","required":false,"description":"Classes of dangling edge to drop. Only honoured when dry_run is false. Omit to no-op.","enumValues":"$undefined"}],"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.","returnShape":"{ dry_run, report, dropped?, remaining? }","returnNotes":["`report` is the pre-action classification.","With `dry_run: false`, `dropped` is the count of edges removed and `remaining` is the post-action report."],"examples":[{"description":"Live call against the Notion example graph.","input":"{}","output":"{\n \"dry_run\": true,\n \"report\": {\n \"total\": 0,\n \"by_class\": {\n \"expected\": 0,\n \"suspect\": 0,\n \"corrupt\": 0\n },\n \"edges\": []\n }\n}"}],"warnings":["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:656","atomicity":"atomic-with-rollback. Classification runs against the live\ndocument before any mutation; with `dry_run: false`, the drop set is\ncomputed up-front and applied in a single index rebuild."}]},{"id":"areas","label":"Areas & Change Log","description":"Areas, change log, and time-bounded change queries.","tools":[{"name":"assign_product_to_area","slug":"assign-product-to-area","description":"Place an existing product under a product area (adds it to the area's `products[]` in `.upg/portfolio.upg`). Resolves the area against the portfolio document and auto-registers the product on the portfolio registry. Use after `create_product`, or pass `area_id` to `create_product` directly.","domain":"areas","groupId":"areas","args":[{"name":"product_id","type":"string","required":true,"description":"Product id (from create_product / list_local_products)","enumValues":"$undefined"},{"name":"area_id","type":"string","required":true,"description":"Product area id (from list_product_areas)","enumValues":"$undefined"}],"returns":"JSON: `{ product_id, container_id, container_kind: \"product_area\",\ncontainer_title?, already_member, registered }`.","returnShape":"{ product_id, container_id, container_kind: \"product_area\", container_title?, already_member, registered }","returnNotes":"$undefined","examples":[],"warnings":[],"see":["attach_product_to_portfolio","create_product"],"source":"src/tools/areas.ts:72","atomicity":"atomic (single portfolio.upg flush)."},{"name":"create_area","slug":"create-area","description":"Create a product area entity in the portfolio document (`.upg/portfolio.upg`). Product areas represent the organisational axis (who owns what). Supports nesting via `parent_area_id`. The portfolio document is created on demand.","domain":"areas","groupId":"areas","args":[{"name":"title","type":"string","required":true,"description":"Area name (e.g. \"Search\", \"Payments\")","enumValues":"$undefined"},{"name":"description","type":"string","required":false,"description":"What this area covers","enumValues":"$undefined"},{"name":"parent_area_id","type":"string","required":false,"description":"Parent area ID for creating a sub-area","enumValues":"$undefined"},{"name":"strategic_priority","type":"string","required":false,"description":"Strategic priority of this area (canonical Priority scale)","enumValues":["urgent","high","medium","low","none"]},{"name":"owner","type":"string","required":false,"description":"Person or team that owns this area","enumValues":"$undefined"}],"returns":"JSON: `{ node, portfolio_file, written_to }`. `node` is the typed\n`UPGProductArea` record persisted to `portfolio_areas[]`.","returnShape":"{ node, portfolio_file, written_to }","returnNotes":["`node` is the typed `UPGProductArea` record persisted to `portfolio_areas[]`."],"examples":[{"description":"Live call against the Notion example graph.","input":"{\n \"title\": \"Example node\"\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":[],"see":["list_product_areas"],"source":"src/tools/areas.ts:295","atomicity":"atomic per write; the portfolio file is read, mutated, and\nflushed in one pass."},{"name":"create_portfolio","slug":"create-portfolio","description":"Create a portfolio entity in the portfolio document (`.upg/portfolio.upg`): the investment / grouping container products and operating functions belong to. A first-class wrapper over `create_node({type:\"portfolio\"})` (closes gap G2 / #39). `kind` sets the posture: owned (default), watched (the only kind that relaxes product grading), or the owned-side groupings strategic / internal / gtm (e.g. a Go-to-Market portfolio of revenue operating_functions). The portfolio document is created on demand.","domain":"areas","groupId":"areas","args":[{"name":"title","type":"string","required":true,"description":"Portfolio name (e.g. \"Go-to-Market\", \"Internal Functions\")","enumValues":"$undefined"},{"name":"description","type":"string","required":false,"description":"The portfolio's strategic focus","enumValues":"$undefined"},{"name":"kind","type":"string","required":false,"description":"Investment posture / grouping (default owned). Only watched relaxes product grading.","enumValues":["owned","watched","strategic","internal","gtm"]},{"name":"parent_portfolio_id","type":"string","required":false,"description":"Parent portfolio id for nesting (a sub-portfolio)","enumValues":"$undefined"},{"name":"hierarchy_model","type":"string","required":false,"description":"How products are structured within this portfolio","enumValues":["flat","nested","matrix"]}],"returns":"JSON: `{ node, portfolio_file, written_to }`. `node` is the typed\n`UPGPortfolio` record persisted to `portfolios[]`.","returnShape":"{ node, portfolio_file, written_to }","returnNotes":["`node` is the typed `UPGPortfolio` record persisted to `portfolios[]`."],"examples":[],"warnings":[],"see":["list_portfolios","create_area"],"source":"src/tools/areas.ts:346","atomicity":"atomic per write."},{"name":"delete_area","slug":"delete-area","description":"Delete a product area from `.upg/portfolio.upg`. Guarded: refuses while the area still has products unless `force: true`. Child areas are un-nested (their parent link is cleared) so no parent reference dangles.","domain":"areas","groupId":"areas","args":[{"name":"area_id","type":"string","required":true,"description":"Product area id to delete (from list_product_areas)","enumValues":"$undefined"},{"name":"force","type":"boolean","required":false,"description":"Delete even if the area still has products (default false)","enumValues":"$undefined"}],"returns":"JSON: `{ message, area_id, deleted, unnested_children: string[] }`.","returnShape":"{ message, area_id, deleted, unnested_children: string[] }","returnNotes":"$undefined","examples":[],"warnings":[],"see":["create_area","remove_product_from_area"],"source":"src/tools/areas.ts:494","atomicity":"atomic (single portfolio.upg flush)."},{"name":"get_area_context","slug":"get-area-context","description":"Check whether the current working directory has a `.upg-area.json` that scopes work to a specific product area.","domain":"areas","groupId":"areas","args":[],"returns":"JSON: `{ has_area_context: false }` or\n`{ has_area_context: true, area_id, area_name, found_at }`.","returnShape":"{ has_area_context: false }","returnNotes":["or `{ has_area_context: true, area_id, area_name, found_at }`."],"examples":[{"description":"Live call against the Notion example graph.","input":"{}","output":"{\n \"has_area_context\": false\n}"}],"warnings":[],"see":[],"source":"src/tools/areas.ts:245","atomicity":"atomic (read-only)"},{"name":"get_area_graph","slug":"get-area-graph","description":"Return the sub-graph (entities and edges) scoped to a product area.","domain":"areas","groupId":"areas","args":[{"name":"area_id","type":"string","required":true,"description":"The product area node ID","enumValues":"$undefined"},{"name":"depth","type":"number","required":false,"description":"How many levels deep to traverse (default 3, max 10)","enumValues":"$undefined"}],"returns":"JSON: `{ area, nodes, edges, node_count, edge_count }`. May\ninclude a `degraded` block when the response was auto-trimmed.","returnShape":"{ area, nodes, edges, node_count, edge_count }","returnNotes":["May include a `degraded` block when the response was auto-trimmed."],"examples":[],"warnings":["Pre-flight payload guardrail: refuses above\n`UPG_MCP_PAYLOAD_HARD_LIMIT` (default 150 KB), warns above\n`UPG_MCP_PAYLOAD_SOFT_LIMIT` (default 50 KB). Reduce `depth` or use\n`query` with a tight projection if the area has many neighbours.","Auto-degrade: between soft and hard, the server may\ncompact edges, drop optional node fields, or truncate. Surfaced as\n`degraded.applied[]` on the response."],"see":["list_product_areas"],"source":"src/tools/areas.ts:103","atomicity":"atomic (read-only)"},{"name":"get_changes","slug":"get-changes","description":"Mutation log for this session. Verify what was created, updated, or deleted without re-fetching.","domain":"areas","groupId":"areas","args":[{"name":"since","type":"string","required":false,"description":"ISO 8601 timestamp. Only returns changes after this time (default: all session changes).","enumValues":"$undefined"}],"returns":"JSON: `{ changes, summary: { create, update, delete }, total }`.\n`since` filters to ISO 8601 timestamps after the cutoff.","returnShape":"{ changes, summary: { create, update, delete }, total }","returnNotes":["`since` filters to ISO 8601 timestamps after the cutoff."],"examples":[{"description":"Live call against the Notion example graph.","input":"{}","output":"$38"}],"warnings":[],"see":[],"source":"src/tools/areas.ts:386","atomicity":"atomic (read-only)"},{"name":"list_product_areas","slug":"list-product-areas","description":"List product areas from the portfolio document (`.upg/portfolio.upg`). Returns an empty list when no portfolio document exists yet.","domain":"areas","groupId":"areas","args":[],"returns":"JSON: `{ areas: Array<{ id, title, strategic_priority?,\nparent_area_id?, products? }>, total }`.","returnShape":"{ areas: Array<{ id, title, strategic_priority?, parent_area_id?, products? }>, total }","returnNotes":"$undefined","examples":[{"description":"Live call against the Notion example graph.","input":"{}","output":"{\n \"areas\": [],\n \"total\": 0\n}"}],"warnings":[],"see":["create_area","get_area_graph"],"source":"src/tools/areas.ts:39","atomicity":"atomic (read-only)"},{"name":"move_product_to_area","slug":"move-product-to-area","description":"Move a product to a different product area: remove it from `from_area_id` (or, when omitted, from every area it currently sits in) and add it to `to_area_id`. Convenience over remove_product_from_area + assign_product_to_area.","domain":"areas","groupId":"areas","args":[{"name":"product_id","type":"string","required":true,"description":"Product id (from list_local_products)","enumValues":"$undefined"},{"name":"to_area_id","type":"string","required":true,"description":"Destination product area id (from list_product_areas)","enumValues":"$undefined"},{"name":"from_area_id","type":"string","required":false,"description":"Source area id to remove from; omit to remove from all areas","enumValues":"$undefined"}],"returns":"JSON: `{ product_id, to_area_id, to_area_title?, removed_from: string[], added }`.","returnShape":"{ product_id, to_area_id, to_area_title?, removed_from: string[], added }","returnNotes":"$undefined","examples":[],"warnings":[],"see":["assign_product_to_area","remove_product_from_area"],"source":"src/tools/areas.ts:517","atomicity":"atomic (single portfolio.upg flush)."},{"name":"remove_product_from_area","slug":"remove-product-from-area","description":"Remove a product from a product area's `products[]` in `.upg/portfolio.upg` (the product stays registered on the portfolio and in any other container). The inverse of `assign_product_to_area`.","domain":"areas","groupId":"areas","args":[{"name":"product_id","type":"string","required":true,"description":"Product id (from list_local_products)","enumValues":"$undefined"},{"name":"area_id","type":"string","required":true,"description":"Product area id (from list_product_areas)","enumValues":"$undefined"}],"returns":"JSON: `{ product_id, container_id, container_kind: \"product_area\",\ncontainer_title?, removed }`. `removed: false` (not an error) when the product\nwas not a member, so retries are idempotent.","returnShape":"{ product_id, container_id, container_kind: \"product_area\", container_title?, removed }","returnNotes":["`removed: false` (not an error) when the product was not a member, so retries are idempotent."],"examples":[],"warnings":[],"see":["assign_product_to_area","move_product_to_area"],"source":"src/tools/areas.ts:467","atomicity":"atomic (single portfolio.upg flush)."},{"name":"update_area","slug":"update-area","description":"Edit a product area in `.upg/portfolio.upg` (title, description, strategic_priority, owner) and/or re-parent it via `parent_area_id`. The mirror of `update_product` for the organisational axis. `parent_area_id` is tri-state: omit to leave unchanged, pass null to un-nest (top-level), or pass an area id to re-parent (rejected if it would create a cycle).","domain":"areas","groupId":"areas","args":[{"name":"area_id","type":"string","required":true,"description":"Product area id to edit (from list_product_areas)","enumValues":"$undefined"},{"name":"title","type":"string","required":false,"description":"New area title","enumValues":"$undefined"},{"name":"description","type":"string","required":false,"description":"New area description","enumValues":"$undefined"},{"name":"strategic_priority","type":"string","required":false,"description":"Strategic priority (canonical Priority scale)","enumValues":["urgent","high","medium","low","none"]},{"name":"parent_area_id","type":["string","null"],"required":false,"description":"Re-parent under this area id; null un-nests (top-level); omit to leave unchanged","enumValues":"$undefined"},{"name":"owner","type":"string","required":false,"description":"Person or team that owns this area","enumValues":"$undefined"}],"returns":"JSON: `{ message, area, updated: string[] }`.","returnShape":"{ message, area, updated: string[] }","returnNotes":"$undefined","examples":[],"warnings":[],"see":["create_area","list_product_areas"],"source":"src/tools/areas.ts:420","atomicity":"atomic (single portfolio.upg flush)."}]},{"id":"workspace","label":"Workspace & Portfolios","description":"Workspace initialisation, product switching, portfolios, and cross-product edges.","tools":[{"name":"aggregate_edge_properties","slug":"aggregate-edge-properties","description":"Aggregate the distribution of one property across every portfolio cross-edge of a type, optionally grouped by a dimension. The digest of the property layer: turns the by-eye \"165 high / 53 medium / 0 low, mediums cluster on ext_api_sdk\" count over a `jq` dump into one call. `property` defaults to `confidence` (an assessment-object property buckets by its `label`). `group_by`: `none` (one overall distribution, default), `axis` (the classification axis the target value belongs to), `competitor` (the source node), or `value` (the target value). Read-only.","domain":"workspace","groupId":"workspace","args":[{"name":"edge_type","type":"string","required":true,"description":"Cross-edge type to aggregate (e.g. competitor_classified_as_classification_value).","enumValues":"$undefined"},{"name":"group_by","type":"string","required":false,"description":"Dimension to group the distribution by. Default none (one overall distribution).","enumValues":["none","axis","competitor","value"]},{"name":"property","type":"string","required":false,"description":"The edge property whose distribution to compute. Default confidence.","enumValues":"$undefined"}],"returns":"JSON: `{ shape: \"edge_property_aggregate\", edge_type, property,\ngroup_by, total, with_property, without_property, overall: [{ key, count }],\ngroups?: [{ group, group_label?, total, with_property, distribution }] }`.\n`overall` is the whole-type distribution; `groups` appears when `group_by` is\nnot `none`.","returnShape":"{ shape: \"edge_property_aggregate\", edge_type, property, group_by, total, with_property, without_property, overall: [{ key, count }], groups?: [{ group, group_label?, total, with_property, distribution }] }","returnNotes":["`overall` is the whole-type distribution; `groups` appears when `group_by` is not `none`."],"examples":[],"warnings":[],"see":["audit_property_coverage","list_portfolio_cross_edges"],"source":"src/tools/portfolio-read.ts:1525","atomicity":"atomic (read-only). Reads the portfolio document only; never mutates."},{"name":"attach_product_to_portfolio","slug":"attach-product-to-portfolio","description":"Place an existing product under a portfolio (adds it to the portfolio's `products[]` in `.upg/portfolio.upg`). Resolves the portfolio against the portfolio document and auto-registers the product on the portfolio registry. Use after `create_product`, or pass `portfolio_id` to `create_product` directly.","domain":"workspace","groupId":"workspace","args":[{"name":"product_id","type":"string","required":true,"description":"Product id (from create_product / list_local_products)","enumValues":"$undefined"},{"name":"portfolio_id","type":"string","required":true,"description":"Portfolio id (from list_portfolios)","enumValues":"$undefined"}],"returns":"JSON: `{ product_id, container_id, container_kind: \"portfolio\",\ncontainer_title?, already_member, registered }`.","returnShape":"{ product_id, container_id, container_kind: \"portfolio\", container_title?, already_member, registered }","returnNotes":"$undefined","examples":[],"warnings":[],"see":["assign_product_to_area","create_product"],"source":"src/tools/workspace.ts:1715","atomicity":"atomic (single portfolio.upg flush)."},{"name":"audit_axis_overlap","slug":"audit-axis-overlap","description":"List every classified source that holds MORE THAN ONE value on a single-select classification axis (the stale-edge symptom a reclassification leaves when the prior same-axis edge is not retired). From 0.11.3 the classify writer supersedes by default, so this is the regression guard (a clean graph returns `overlaps: []`) and the detector for overlaps already in a graph. A `multi`-select axis is exempt; unaxed values are skipped. Titles resolve to entity names. Read-only.","domain":"workspace","groupId":"workspace","args":[],"returns":"JSON: `{ total, overlaps: Array<{ source, source_title?, axis,\naxis_label, values: [{ value, value_label, edge_id, assessed_on? }] }> }`.\n`total` is the number of (source, single-select axis) pairs with > 1 value.","returnShape":"{ total, overlaps: Array<{ source, source_title?, axis, axis_label, values: [{ value, value_label, edge_id, assessed_on? }] }> }","returnNotes":["`total` is the number of (source, single-select axis) pairs with > 1 value."],"examples":[],"warnings":[],"see":["create_classification_edge","get_portfolio_tree"],"source":"src/tools/portfolio-read.ts:1580","atomicity":"atomic (read-only). Reads the portfolio document only; never mutates."},{"name":"audit_property_coverage","slug":"audit-property-coverage","description":"Audit which portfolio cross-edges of a given type are MISSING required `properties` keys (the completeness check for a property backfill, without a shell over `portfolio.upg`). Given `edge_type` and `required_keys`, returns the edges that lack any of them, plus (when `check_values`) the edges whose present values fail the type property schema. Resolves entity titles. Example: `audit_property_coverage({ edge_type: \"competitor_classified_as_classification_value\", required_keys: [\"confidence\", \"assessed_on\"] })` returns `missing: []` once every classify edge carries both. Read-only.","domain":"workspace","groupId":"workspace","args":[{"name":"edge_type","type":"string","required":true,"description":"Cross-edge type to audit (e.g. competitor_classified_as_classification_value).","enumValues":"$undefined"},{"name":"required_keys","type":"array","required":true,"description":"The properties keys that should be present on every edge of this type (e.g. [\"confidence\", \"assessed_on\"]).","enumValues":"$undefined"},{"name":"source_product_id","type":"string","required":false,"description":"Restrict to edges whose source node is in this product.","enumValues":"$undefined"},{"name":"check_values","type":"boolean","required":false,"description":"Also report edges whose PRESENT properties fail the type property schema (off-scale, missing nested keys). Default true.","enumValues":"$undefined"}],"returns":"JSON: `{ edge_type, required_keys, total, complete,\nmissing: [{ edge_id, source, target, source_title?, target_title?,\nmissing_keys }], malformed?: [...] }`.","returnShape":"{ edge_type, required_keys, total, complete, missing: [{ edge_id, source, target, source_title?, target_title?, missing_keys }], malformed?: [...] }","returnNotes":"$undefined","examples":[],"warnings":[],"see":["list_portfolio_cross_edges","get_portfolio_tree"],"source":"src/tools/portfolio-read.ts:1294","atomicity":"atomic (read-only). Reads the portfolio document only."},{"name":"batch_create_cross_product_edges","slug":"batch-create-cross-product-edges","description":"Create up to 50 cross-product edges in one atomic write (the portfolio-tier mirror of batch_create_edges). Every edge is validated and qualified before anything is written; if any is invalid the whole batch is rejected. Referenced products are auto-registered.","domain":"workspace","groupId":"workspace","args":[{"name":"edges","type":"array","required":true,"description":"Cross-product edges to create (max 50). Each: { source_id, target_id, type, source_product_id?, target_product_id? }.","enumValues":"$undefined"},{"name":"auto_create_portfolio","type":"boolean","required":false,"description":"Create an empty portfolio document if none exists (default false)","enumValues":"$undefined"},{"name":"dry_run","type":"boolean","required":false,"description":"Forecast the batch without mutating: returns { dry_run: true, would_counts, edges:[{ would, edge }] } and writes nothing. The pre-flight that makes a large backfill safe to reason about.","enumValues":"$undefined"},{"name":"supersede","type":"boolean","required":false,"description":"Classification edges only. Retire a prior same-axis edge when a classify write moves a source on a single-select axis (default true). Set false to keep both (additive).","enumValues":"$undefined"}],"returns":"JSON: `{ message, created: UPGCrossEdge[], count, portfolio_file,\nregistered_products? }`.","returnShape":"{ message, created: UPGCrossEdge[], count, portfolio_file, registered_products? }","returnNotes":"$undefined","examples":[],"warnings":[],"see":["create_cross_product_edge","list_cross_edge_types"],"source":"src/tools/workspace.ts:1830","atomicity":"atomic. All edges validated first, then a single portfolio.upg flush."},{"name":"batch_define_canonical_entity","slug":"batch-define-canonical-entity","description":"Batch-create canonical registry entities in one atomic call (the migration counterpart to `define_canonical_entity`). Validates every entity up front (valid type, unique id) then writes all and flushes once, so a registry stand-up is a handful of batches, not one call per canonical.","domain":"workspace","groupId":"workspace","args":[{"name":"entities","type":"array","required":true,"description":"Up to 50 canonical entities.","enumValues":"$undefined"}],"returns":"JSON: `{ defined: [{ canonical_id, qualified_id, type, title }], count, portfolio_file }`.","returnShape":"{ defined: [{ canonical_id, qualified_id, type, title }], count, portfolio_file }","returnNotes":"$undefined","examples":[],"warnings":[],"see":["define_canonical_entity"],"source":"src/tools/registry.ts:521","atomicity":"validate-all-then-write. A single invalid entity rejects the whole batch."},{"name":"batch_delete_cross_product_edges","slug":"batch-delete-cross-product-edges","description":"Delete up to 50 cross-product edges from `.upg/portfolio.upg` by id in one atomic write (the inverse of batch_create_cross_product_edges). All ids are removed, then a single portfolio flush persists the batch, so retiring a wave of superseded edges costs one write instead of one per id. A missing id is reported deleted: false, not an error, so the call is idempotent. Get ids from list_portfolio_cross_edges.","domain":"workspace","groupId":"workspace","args":[{"name":"edge_ids","type":"array","required":true,"description":"Cross-product edge ids to delete (max 50, from list_portfolio_cross_edges).","enumValues":"$undefined"}],"returns":"JSON: `{ message, deleted: [{ edge_id, deleted, edge? }], count, counts }`.","returnShape":"{ message, deleted: [{ edge_id, deleted, edge? }], count, counts }","returnNotes":"$undefined","examples":[],"warnings":[],"see":["delete_cross_product_edge","batch_create_cross_product_edges"],"source":"src/tools/workspace.ts:1793","atomicity":"atomic (single portfolio.upg flush)."},{"name":"batch_register_instance","slug":"batch-register-instance","description":"Batch-register product instances against canonical entities in one atomic call (the migration counterpart to `register_instance`). Validates every instance up front (canonical exists, same-type) then writes all `instance_of` edges and flushes once. Per-instance idempotent; `alias` honoured per instance.","domain":"workspace","groupId":"workspace","args":[{"name":"instances","type":"array","required":true,"description":"Up to 50 instances.","enumValues":"$undefined"}],"returns":"JSON: `{ results: [...], registered, already_existed, count, portfolio_file }`.","returnShape":"{ results: [...], registered, already_existed, count, portfolio_file }","returnNotes":"$undefined","examples":[],"warnings":[],"see":["register_instance"],"source":"src/tools/registry.ts:604","atomicity":"validate-all-then-write. A single invalid instance rejects the whole batch."},{"name":"clone_structure","slug":"clone-structure","description":"Stamp the SHAPE of one product (typed nodes + canonical edges + hierarchy, with `TODO:` placeholder titles) into another, without re-authoring the skeleton. Content (descriptions, properties, real titles, statuses) never crosses; only the structure does. The lever for multi-product structural parity: one stamp plus a content pass replaces a multi-batch rebuild. `from_product` is the read-only exemplar; `into` is the write target and DEFAULTS to the active product (name a non-active product to write there with no `switch_product`). `regions` scopes the clone to entity types in those super-domains. `dry_run: true` previews the plan without writing. Local-only.","domain":"workspace","groupId":"workspace","args":[{"name":"from_product","type":"string","required":true,"description":"Exemplar product (id, file, or basename) whose shape is copied. Read-only.","enumValues":"$undefined"},{"name":"into","type":"string","required":false,"description":"Target product to stamp the shape into. Defaults to the ACTIVE product; name a non-active product to write there without switch_product.","enumValues":"$undefined"},{"name":"regions","type":"array","required":false,"description":"Optional region ids (or labels) to scope the clone to entity types in those super-domains. Omit to clone the whole shape.","enumValues":"$undefined"},{"name":"dry_run","type":"boolean","required":false,"description":"Preview the plan (counts by type, edges, sample titles) without writing. Default false.","enumValues":"$undefined"}],"returns":"JSON: on `dry_run`, `{ dry_run, from, into, into_is_active,\nwould_clone: { nodes, edges, by_type }, region_scope?, unmatched_regions?,\ntarget_existing_stubs?, sample_titles }`. On commit, `{ cloned: true, from,\ninto, into_is_active, nodes_created, edges_created, edges_skipped?, by_type,\nwarnings? }`.","returnShape":"$undefined","returnNotes":["JSON: on `dry_run`, `{ dry_run, from, into, into_is_active, would_clone: { nodes, edges, by_type }, region_scope?, unmatched_regions?, target_existing_stubs?, sample_titles }`.","On commit, `{ cloned: true, from, into, into_is_active, nodes_created, edges_created, edges_skipped?, by_type, warnings? }`."],"examples":[],"warnings":[],"see":["portfolio_validate","batch_create_nodes","switch_product"],"source":"src/tools/clone-structure.ts:169","atomicity":"atomic-with-rollback on commit (created twins + edges are rolled\nback if a hard error lands mid-clone; catalog-invalid source edges are\nskipped and reported, not fatal). `dry_run` never writes."},{"name":"compare_classifications","slug":"compare-classifications","description":"Compare two classified nodes (competitors) axis-by-axis: where they AGREE (same classification_value), DIVERGE (different values), or where only one has been graded. The bridge from the classification layer to the parity layer: `create_parity_edge` writes a parity relationship, this derives which axes warrant one. Reuses the same per-node profile assembly as `get_portfolio_tree` competitor_profile, so axis / value / confidence resolution is identical, then joins the two. Divergences are ordered first (the actionable rows). Titles resolve to entity names. Read-only.","domain":"workspace","groupId":"workspace","args":[{"name":"a","type":"string","required":true,"description":"First node to compare (qualified or bare id, e.g. p_rival/n_acme or a registry competitor id).","enumValues":"$undefined"},{"name":"b","type":"string","required":true,"description":"Second node to compare (qualified or bare id).","enumValues":"$undefined"},{"name":"axis","type":"string","required":false,"description":"Restrict the comparison to one classification axis (bare or qualified id). Omit to compare across every axis either node is graded on.","enumValues":"$undefined"}],"returns":"JSON: `{ shape: \"comparison\", a, b, axes: Array<{ axis, axis_label,\na: [{value, value_label, confidence?}], b: [...], status }>, stats:\n{ shared_axes, agreements, divergences, a_only, b_only } }`. Divergences are\nordered first (the actionable rows).","returnShape":"{ shape: \"comparison\", a, b, axes: Array<{ axis, axis_label, a: [{value, value_label, confidence?}], b: [...], status }>, stats: { shared_axes, agreements, divergences, a_only, b_only } }","returnNotes":["Divergences are ordered first (the actionable rows)."],"examples":[],"warnings":[],"see":["get_portfolio_tree","create_parity_edge"],"source":"src/tools/portfolio-read.ts:1473","atomicity":"atomic (read-only). Reads the portfolio document and, for title\nresolution, referenced product files read-only; never mutates active state."},{"name":"create_classification_edge","slug":"create-classification-edge","description":"Place a node in a classification cell, carrying optional confidence and provenance as edge metadata (confidence / assessed_on / rationale / evidence). A typed convenience over the generic edge writers, mirroring create_parity_edge: it picks the edge type from the source node type (a competitor source writes competitor_classified_as_classification_value; any other node writes the polymorphic node_classified_as_classification_value), expands a friendly confidence (low/medium/high) into the canonical confidence_5 assessment, defaults assessed_on to today, and routes automatically. A registry/{value} target (or a supplied node_product_id) writes a cross-edge; a bare local value writes a catalogue edge.","domain":"workspace","groupId":"workspace","args":[{"name":"node_id","type":"string","required":true,"description":"The node being classified (the edge source). Bare, or {product_id}/{node_id}.","enumValues":"$undefined"},{"name":"classification_value_id","type":"string","required":true,"description":"The target classification_value. Bare for a local value, or registry/{value} for a canonical.","enumValues":"$undefined"},{"name":"node_product_id","type":"string","required":false,"description":"Cross mode: product id holding node_id (defaults to the active product).","enumValues":"$undefined"},{"name":"confidence","type":"string","required":false,"description":"Confidence this node belongs in this cell. Expanded to a confidence_5 assessment.","enumValues":["low","medium","high"]},{"name":"assessed_on","type":"string","required":false,"description":"ISO date the classification was made or last re-checked. Defaults to today.","enumValues":"$undefined"},{"name":"rationale","type":"string","required":false,"description":"Short note on why this node sits in this cell.","enumValues":"$undefined"},{"name":"evidence","type":"string","required":false,"description":"A source URL, or a competitor_signal / evidence node id backing the classification.","enumValues":"$undefined"},{"name":"supersede","type":"boolean","required":false,"description":"When this classifies the source to a new value on a single-select axis, retire its prior same-axis edge (default true) and record the move in the reclassification history. Set false to keep both values (additive). A multi-select axis always keeps both.","enumValues":"$undefined"},{"name":"auto_create_portfolio","type":"boolean","required":false,"description":"Cross mode only: create an empty portfolio document if none exists (default false).","enumValues":"$undefined"}],"returns":"JSON: the created edge (within-graph or cross-product shape).","returnShape":"$undefined","returnNotes":["JSON: the created edge (within-graph or cross-product shape)."],"examples":[],"warnings":[],"see":["create_cross_product_edge","create_edge"],"source":"src/tools/workspace.ts:1196","atomicity":"inherits the delegated writer's atomicity."},{"name":"create_cross_product_edge","slug":"create-cross-product-edge","description":"Create a cross-product relationship between two entities in different products within a portfolio graph. Types: `shares_persona`, `shares_competitor`, `shares_metric`, `depends_on_product`, `cannibalises`, `succeeds`, `hosts` (host product runs the hosted product inside itself, directed host to hosted), `contributes_to` (a product strategy entity rolls up to a higher-level one, e.g. product objective → company objective; directed subordinate to superior), `rolls_up_to` (a product metric feeds a company/portfolio metric, e.g. a product KPI → a company north-star; directed feeder to feed, same-type metric → metric). For `instance_of` use `register_instance`; for `area_serves_persona` / `area_targets_market_segment` use `link_area_to_audience`.","domain":"workspace","groupId":"workspace","args":[{"name":"source_id","type":"string","required":true,"description":"Source node ID","enumValues":"$undefined"},{"name":"target_id","type":"string","required":true,"description":"Target node ID","enumValues":"$undefined"},{"name":"type","type":"string","required":true,"description":"Cross-product relationship type","enumValues":["shares_persona","shares_competitor","shares_metric","shares_job","shares_need","depends_on_product","cannibalises","succeeds","hosts","contributes_to","rolls_up_to","product_implements_specification","product_exposes_specification","feature_conforms_to_specification","api_contract_speaks_specification","product_exposes_primitive","feature_manipulates_primitive","primitive_stored_as_data_type","persona_delegates_to_persona","feature_rivals_competitor_feature","competitor_signal_maps_to_feature","competitor_signal_surfaces_opportunity","competitor_classified_as_classification_value","node_classified_as_classification_value","product_pursues_outcome","product_targets_objective","product_guided_by_vision","product_fulfils_mission","product_organises_around_strategic_theme","product_stands_on_strategic_pillar","product_invests_in_initiative","product_measures_with_metric","outcome_measured_by_metric","objective_achieved_through_key_result","objective_measured_by_metric","key_result_quantified_by_metric","strategic_pillar_measured_by_metric","strategic_theme_pursues_initiative","strategic_theme_delivers_outcome","strategic_theme_measured_by_key_result","strategic_theme_contains_objective","initiative_advances_key_result","initiative_drives_outcome","epic_decomposes_into_task","epic_affected_by_bug","surface_governed_by_design_guideline","surface_renders_design_component","surface_measured_by_metric","product_expresses_brand_identity","screen_renders_design_component","screen_markets_product","screen_targets_competitor","feature_surfaces_product","feature_uses_design_component","product_implements_design_system","node_owned_by_team","node_owned_by_department","objective_advances_outcome","journey_phase_realises_operating_stage","objective_depends_on_dependency","dependency_blocks_objective","dependency_resolved_by_objective","objective_defers_feature","objective_defers_capability","deal_blocked_by_feature","research_study_analyzes_deal"]},{"name":"source_product_id","type":"string","required":false,"description":"Product ID of the source node","enumValues":"$undefined"},{"name":"target_product_id","type":"string","required":false,"description":"Product ID of the target node","enumValues":"$undefined"},{"name":"properties","type":"object","required":false,"description":"Edge metadata, accepted only for cross-edge types declared carries_properties (e.g. feature_rivals_competitor_feature, carrying the parity assessment parity_status / quality / is_gap / assessed_on / evidence / confidence). Rejected for types that do not carry properties.","enumValues":"$undefined"},{"name":"dry_run","type":"boolean","required":false,"description":"Forecast the write without mutating: returns { dry_run: true, would: create | update | unchanged, edge } and writes nothing. Use to reason about a write before running it.","enumValues":"$undefined"},{"name":"supersede","type":"boolean","required":false,"description":"Classification edges only. When a classify write moves a source to a new value on a single-select axis, retire the prior same-axis edge (default true) so the source carries one current value. Set false to keep both (additive). A multi-select axis always keeps both.","enumValues":"$undefined"}],"returns":"JSON: `{ edge, portfolio_file }`.","returnShape":"{ edge, portfolio_file }","returnNotes":"$undefined","examples":[],"warnings":[],"see":["list_portfolios","list_portfolio_cross_edges","migrate_cross_edges"],"source":"src/tools/workspace.ts:802","atomicity":"non-atomic. Portfolio file create (if new) + edge append are\nseparate filesystem operations."},{"name":"create_parity_edge","slug":"create-parity-edge","description":"Create the parity / rivalry edge `feature_rivals_competitor_feature` from our `feature` to a `competitor_feature`, carrying the assessment (parity_status / quality / is_gap / assessed_on / evidence / confidence) as edge metadata. A typed convenience over the generic edge writers: it fixes the edge type, validates the parity enums, derives `is_gap` from `parity_status` when omitted, and routes automatically. Within the active graph it writes a catalogue edge (like `create_edge`); cross-product (their `competitor_feature` in a separate watched intelligence graph) it writes a cross-edge (like `create_cross_product_edge`), with the our-side product defaulting to the active product. The edge is authoritative; the node `parity_status` is a denormalised single-rival cache that `validate_graph` checks for divergence.","domain":"workspace","groupId":"workspace","args":[{"name":"feature_id","type":"string","required":true,"description":"Our feature node id (the rivalry edge source). Bare, or {product_id}/{node_id} in cross mode.","enumValues":"$undefined"},{"name":"competitor_feature_id","type":"string","required":true,"description":"Their competitor_feature node id (the target). Bare for within-graph, or {product_id}/{node_id} for a competitor in a separate watched graph.","enumValues":"$undefined"},{"name":"parity_status","type":"string","required":true,"description":"Our standing versus theirs on this feature.","enumValues":["ahead","behind","parity","unique_to_us","unique_to_them"]},{"name":"quality","type":"string","required":false,"description":"Relative quality of our equivalent.","enumValues":["better","same","worse","missing"]},{"name":"is_gap","type":"boolean","required":false,"description":"Gap in our offering. Defaults to true when parity_status is behind or unique_to_them.","enumValues":"$undefined"},{"name":"assessed_on","type":"string","required":false,"description":"ISO date the assessment was made.","enumValues":"$undefined"},{"name":"evidence","type":"string","required":false,"description":"Free text, or an evidence / competitor_signal node id backing the assessment.","enumValues":"$undefined"},{"name":"confidence","type":"string","required":false,"description":"Confidence in the assessment.","enumValues":["low","medium","high"]},{"name":"feature_product_id","type":"string","required":false,"description":"Cross mode: product id of our feature (defaults to the active product).","enumValues":"$undefined"},{"name":"competitor_product_id","type":"string","required":false,"description":"Cross mode: product id of the watched graph holding the competitor_feature.","enumValues":"$undefined"},{"name":"auto_create_portfolio","type":"boolean","required":false,"description":"Cross mode only: create an empty portfolio document if none exists (default false).","enumValues":"$undefined"}],"returns":"JSON: the created edge (within-graph `create_edge` shape, or the\ncross-product `{ edge, portfolio_file }` shape).","returnShape":"$undefined","returnNotes":["JSON: the created edge (within-graph `create_edge` shape, or the cross-product `{ edge, portfolio_file }` shape)."],"examples":[],"warnings":[],"see":["create_edge","create_cross_product_edge","validate_graph"],"source":"src/tools/workspace.ts:1078","atomicity":"inherits the delegated writer's atomicity."},{"name":"create_product","slug":"create-product","description":"Create a sibling .upg product in the current workspace. Mints a canonical product id, writes the file, stamps integrity, registers in `workspace.json`. Pairs with `init_workspace` and `switch_product`.","domain":"workspace","groupId":"workspace","args":[{"name":"name","type":"string","required":true,"description":"Product display title (required, non-empty).","enumValues":"$undefined"},{"name":"slug","type":"string","required":false,"description":"Optional slug for the .upg filename. Defaults to a slug derived from `name`. Collisions append `-2`, `-3`, …","enumValues":"$undefined"},{"name":"description","type":"string","required":false,"description":"Optional product description","enumValues":"$undefined"},{"name":"stage","type":"string","required":false,"description":"Product lifecycle stage. See UPGProductStage in @unified-product-graph/core.","enumValues":"$undefined"},{"name":"portfolio_id","type":"string","required":false,"description":"Optional portfolio id (resolved against portfolio.upg) to place the new product under. A portfolio id that resolves only in the active graph still attaches via an in-graph edge (DEPRECATED; prefer attach_product_to_portfolio).","enumValues":"$undefined"},{"name":"area_id","type":"string","required":false,"description":"Optional product_area id (resolved against portfolio.upg) to place the new product under.","enumValues":"$undefined"},{"name":"dir","type":"string","required":false,"description":"Optional subfolder under .upg/ to write the graph into (e.g. \"competitors\"). The file lands at .upg//.upg and is registered in workspace.json with that subpath, so a watched portfolio can keep its intelligence graphs in competitors/. Absent writes flat at .upg/.upg. No leading slash or \"..\".","enumValues":"$undefined"},{"name":"member_kind","type":"string","required":false,"description":"Workspace member kind. product (default) = a product under management; org_rollup = the company umbrella graph; watched = a monitored intelligence graph (e.g. a competitor); operating_function = a function a team operates (revenue/success/finance/people/marketing), not a product it ships. Stamped into $upg.member_kind and cached in workspace.json; non-product kinds are excluded from counts.products and graded on their own validation profile (product-spine anti-patterns are suppressed).","enumValues":["product","org_rollup","watched","operating_function"]}],"returns":"JSON: `{ message, ...result }`. `result` carries `id`, `title`,\n`slug`, `file_path`, and the optional portfolio edge.","returnShape":"{ message,...result }","returnNotes":["`result` carries `id`, `title`, `slug`, `file_path`, and the optional portfolio edge."],"examples":[{"description":"Live call against the Notion example graph.","input":"{\n \"name\": \"example\"\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":[],"see":["init_workspace"],"source":"src/tools/workspace.ts:635","atomicity":"non-atomic. File write + workspace.json patch + optional\nportfolio edge are separate mutations."},{"name":"create_registry_edge","slug":"create-registry-edge","description":"Create a canonical-internal edge between two registry entities: the authoring path for `registry.edges`. Canonical entities relate to one another (a registry specification governed_by a registry organization, a primitive defined_by a specification, a specification that extends another specification). These edges live in the portfolio registry and never touch product graphs. Validates that both endpoints exist in the registry, the type is a real `UPG_EDGE_CATALOG` edge, and the catalog source_type/target_type match the two nodes (the canonical edge for the pair). Idempotent: an identical edge (same source/target/type) already present is returned, not duplicated.","domain":"workspace","groupId":"workspace","args":[{"name":"source_id","type":"string","required":true,"description":"Source registry entity id (bare or registry/{id}).","enumValues":"$undefined"},{"name":"target_id","type":"string","required":true,"description":"Target registry entity id (bare or registry/{id}).","enumValues":"$undefined"},{"name":"type","type":"string","required":true,"description":"A UPG_EDGE_CATALOG edge type whose endpoint types match the two registry nodes (see resolve_edge_for_pair).","enumValues":"$undefined"}],"returns":"JSON: `{ edge, source, target, portfolio_file, already_existed? }`.","returnShape":"{ edge, source, target, portfolio_file, already_existed? }","returnNotes":"$undefined","examples":[],"warnings":[],"see":["define_canonical_entity","list_registry"],"source":"src/tools/registry.ts:826","atomicity":"non-atomic. Registry edge append to the portfolio document."},{"name":"define_canonical_entity","slug":"define-canonical-entity","description":"Define a canonical shared entity in the portfolio registry (the shared-vocabulary tier of `.upg/portfolio.upg`). Use when an archetype is shared across products (a Developer persona, a North-Star metric, a competitor) and should have ONE authoritative definition that product instances link to via `register_instance`. A canonical entity is a normal node of any active entity type (persona, metric, competitor, market_segment, and any other active type) that lives in the registry rather than in a product. Creates the portfolio document if absent. Returns the canonical node and its `registry/{id}` qualified id.","domain":"workspace","groupId":"workspace","args":[{"name":"type","type":"string","required":true,"description":"Any active UPG entity type, including `proposed`-maturity types. There is no canonical allowlist; persona, metric, competitor, market_segment are common examples, not the allowed set. The only gate is that the type is active (see list_entity_types).","enumValues":"$undefined"},{"name":"title","type":"string","required":true,"description":"Canonical name (e.g. \"Developer\").","enumValues":"$undefined"},{"name":"description","type":"string","required":false,"description":"Optional longer description of the canonical entity.","enumValues":"$undefined"},{"name":"properties","type":"object","required":false,"description":"Optional properties (e.g. a persona's audience_role).","enumValues":"$undefined"},{"name":"tags","type":"array","required":false,"description":"Optional tags.","enumValues":"$undefined"},{"name":"canonical_id","type":"string","required":false,"description":"Optional explicit registry id; otherwise derived from type + title (e.g. persona_developer).","enumValues":"$undefined"}],"returns":"JSON: `{ canonical, qualified_id, portfolio_file }`.","returnShape":"{ canonical, qualified_id, portfolio_file }","returnNotes":"$undefined","examples":[],"warnings":[],"see":["register_instance","list_registry"],"source":"src/tools/registry.ts:86","atomicity":"non-atomic. Portfolio file create (if new) + registry append."},{"name":"delete_canonical_entity","slug":"delete-canonical-entity","description":"Delete a canonical entity from the portfolio registry: the registry counterpart to `delete_node` (which only sees the active product). Retires an obsolete or twin canonical that would otherwise linger as a 0-instance orphan in `list_registry`. Safe by default: refuses while anything still references the canonical (instance_of edges, area/classification cross-edges, registry-internal edges) unless `cascade: true`, which deletes those references in the same atomic flush, severing the instances. When instances should SURVIVE under another canonical, use `merge_canonical_entities` instead: it repoints them. Preview the exact blast radius first with `dry_run: true`.","domain":"workspace","groupId":"workspace","args":[{"name":"canonical_id","type":"string","required":true,"description":"The registry entity id (bare, or registry/{id}).","enumValues":"$undefined"},{"name":"cascade","type":"boolean","required":false,"description":"Also delete every edge referencing the canonical (default false). Without it, a referenced canonical is refused.","enumValues":"$undefined"},{"name":"dry_run","type":"boolean","required":false,"description":"Preview the canonical + every referencing edge that deletion would remove; nothing is written (default false).","enumValues":"$undefined"}],"returns":"JSON: `{ deleted, cascaded: { instance_of, cross_edges, registry_edges },\nportfolio_file }` — or `{ dry_run: true, would_delete, references }`.","returnShape":"{ deleted, cascaded: { instance_of, cross_edges, registry_edges }, portfolio_file }","returnNotes":["— or `{ dry_run: true, would_delete, references }`."],"examples":[],"warnings":[],"see":["merge_canonical_entities","list_registry"],"source":"src/tools/registry.ts:1055","atomicity":"atomic. All removals land in one portfolio flush."},{"name":"delete_cross_product_edge","slug":"delete-cross-product-edge","description":"Delete a cross-product edge from `.upg/portfolio.upg` by id. The inverse of `create_cross_product_edge`. Returns `deleted: false` (not an error) when no edge with that id exists.","domain":"workspace","groupId":"workspace","args":[{"name":"edge_id","type":"string","required":true,"description":"Cross-product edge id (from list_portfolio_cross_edges)","enumValues":"$undefined"}],"returns":"JSON: `{ edge_id, deleted, edge? }`. `deleted: false` (not an error) when\nno edge with that id exists, so retries are idempotent.","returnShape":"{ edge_id, deleted, edge? }","returnNotes":["`deleted: false` (not an error) when no edge with that id exists, so retries are idempotent."],"examples":[],"warnings":[],"see":["create_cross_product_edge","list_portfolio_cross_edges"],"source":"src/tools/workspace.ts:1769","atomicity":"atomic (single portfolio.upg flush)."},{"name":"detach_product_from_portfolio","slug":"detach-product-from-portfolio","description":"Remove a product from a portfolio's `products[]` in `.upg/portfolio.upg` (the product stays registered and in any other container). The inverse of `attach_product_to_portfolio`.","domain":"workspace","groupId":"workspace","args":[{"name":"product_id","type":"string","required":true,"description":"Product id (from list_local_products)","enumValues":"$undefined"},{"name":"portfolio_id","type":"string","required":true,"description":"Portfolio id (from list_portfolios)","enumValues":"$undefined"}],"returns":"JSON: `{ product_id, container_id, container_kind: \"portfolio\",\ncontainer_title?, removed }`. `removed: false` (not an error) when the product was\nnot a member, so retries are idempotent.","returnShape":"{ product_id, container_id, container_kind: \"portfolio\", container_title?, removed }","returnNotes":["`removed: false` (not an error) when the product was not a member, so retries are idempotent."],"examples":[],"warnings":[],"see":["attach_product_to_portfolio"],"source":"src/tools/workspace.ts:1742","atomicity":"atomic (single portfolio.upg flush)."},{"name":"diff_classification","slug":"diff-classification","description":"Show what MOVED on the competitive classification landscape: each competitor reclassification (from one classification_value to another on an axis) since a date. Reads the append-only reclassification history auto-recorded at the classify-write chokepoint, so \"did AEM move from integrated to agentic\" is one call instead of in-head reasoning. Returns transitions with resolved titles (competitor, from, to), sorted newest first. Pairs with `list_portfolio_cross_edges` freshness (which decides WHEN to re-assess); this surfaces WHAT changed. Empty when nothing moved or no history exists. Read-only.","domain":"workspace","groupId":"workspace","args":[{"name":"product","type":"string","required":false,"description":"Restrict to reclassifications of competitors owned by this product (matched on the competitor id product prefix).","enumValues":"$undefined"},{"name":"competitor","type":"string","required":false,"description":"Restrict to one competitor by its qualified id (e.g. p_rival/n_acme).","enumValues":"$undefined"},{"name":"since","type":"string","required":false,"description":"ISO date. Only transitions observed on or after this date (e.g. 2026-06-01). Omit for all history.","enumValues":"$undefined"}],"returns":"JSON: `{ product?, competitor?, since?, total, transitions: Array<{\nsignal_id, competitor, competitor_title?, axis, from_value, from_title?,\nto_value, to_title?, observed_at, confidence?, observed_by? }> }`, newest\nfirst. Empty `transitions` when nothing moved or no history exists.","returnShape":"{ product?, competitor?, since?, total, transitions: Array<{ signal_id, competitor, competitor_title?, axis, from_value, from_title?, to_value, to_title?, observed_at, confidence?, observed_by? }> }","returnNotes":[", newest first.","Empty `transitions` when nothing moved or no history exists."],"examples":[],"warnings":[],"see":[],"source":"src/tools/portfolio-read.ts:1382","atomicity":"atomic (read-only). Reads the portfolio document only; never mutates."},{"name":"get_organization","slug":"get-organization","description":"Get the organisation that owns the current workspace's portfolio. Reads the singleton `portfolio.upg.organization`. Returns `{ organization: null }` when no portfolio document exists yet.","domain":"workspace","groupId":"workspace","args":[],"returns":"JSON: `{ organization: UPGOrganization | null, portfolio_file? }`.\nReturns `{ organization: null }` when no portfolio document exists yet.","returnShape":"{ organization: UPGOrganization | null, portfolio_file? }","returnNotes":["Returns `{ organization: null }` when no portfolio document exists yet."],"examples":[{"description":"Live call against the Notion example graph.","input":"{}","output":"{\n \"organization\": {\n \"id\": \"org_1853eb2e\",\n \"title\": \"Portfolio\"\n },\n \"portfolio_file\": \".upg/portfolio.upg\"\n}"}],"warnings":[],"see":["list_portfolios"],"source":"src/tools/workspace.ts:751","atomicity":"atomic (read-only)"},{"name":"get_portfolio_tree","slug":"get-portfolio-tree","description":"Assemble a portfolio-grain tree from `.upg/portfolio.upg` (the portfolio complement to `get_tree`, which is product-scoped). `shape: \"landscape\"` (default) walks the shared classification registry and the `*_classified_as_classification_value` cross edges: classification axis to its values to the nodes classified at each value, every leaf carrying `confidence` / `assessed_on`; anchor at one axis or value with `from_id`, or omit for the whole portfolio. `shape: \"competitor_profile\"` returns one node (a competitor) and its position on every axis it has been graded against; `from_id` required. `shape: \"structure\"` returns the org chart from the portfolio DOCUMENT FIELDS (organisation to product areas / portfolios to their member products, nested), no graph traversal; areas are the ownership axis and portfolios the strategic axis, so a product can appear under both. Titles resolve to entity names (e.g. \"Directus\"), not opaque ids. Values with no wired axis surface under an `unaxed` bucket. Read-only.","domain":"workspace","groupId":"workspace","args":[{"name":"shape","type":"string","required":false,"description":"landscape (axis to value to classified members, default), competitor_profile (one node to its per-axis positions), or structure (org to areas / portfolios to products, from document fields).","enumValues":["landscape","competitor_profile","structure"]},{"name":"from_id","type":"string","required":false,"description":"Anchor node id (qualified or bare). Optional for landscape (a classification axis or value); required for competitor_profile (the node to profile).","enumValues":"$undefined"},{"name":"include_properties","type":"array","required":false,"description":"Classification-edge property keys to inline on each leaf, in addition to the always-included confidence / assessed_on.","enumValues":"$undefined"},{"name":"include_members","type":"boolean","required":false,"description":"Landscape only. Force classified members to inline on the whole-portfolio overview (counts-only by default). Subject to the payload guard.","enumValues":"$undefined"}],"returns":"JSON: the landscape or profile structure (see the SDK shapes).","returnShape":"$undefined","returnNotes":["JSON: the landscape or profile structure (see the SDK shapes)."],"examples":[],"warnings":[],"see":["portfolio_digest","list_portfolio_cross_edges","get_tree"],"source":"src/tools/portfolio-read.ts:1193","atomicity":"atomic (read-only). Reads the portfolio document and, for title\nresolution, referenced product files read-only; never mutates active state."},{"name":"get_workspace_info","slug":"get-workspace-info","description":"Workspace info: which product is loaded, what other products are available, current workspace mode.","domain":"workspace","groupId":"workspace","args":[],"returns":"JSON: `{ mode, workspace_path?, current_product?, current_file?,\nproducts }`. The shape depends on whether `.upg/workspace.json` exists.","returnShape":"{ mode, workspace_path?, current_product?, current_file?, products }","returnNotes":["The shape depends on whether `.upg/workspace.json` exists."],"examples":[{"description":"Live call against the Notion example graph.","input":"{}","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":[],"see":["init_workspace"],"source":"src/tools/workspace.ts:516","atomicity":"atomic (read-only)"},{"name":"init_workspace","slug":"init-workspace","description":"Initialise a UPG workspace. Creates `.upg/` and moves the current .upg file into it. Unlocks multi-product management.","domain":"workspace","groupId":"workspace","args":[{"name":"move_existing","type":"boolean","required":false,"description":"Move existing .upg files into the workspace (default true)","enumValues":"$undefined"}],"returns":"JSON: `{ message, ...result }`. `result` carries the workspace\npath and the moved file's new location.","returnShape":"{ message,...result }","returnNotes":["`result` carries the workspace path and the moved file's new location."],"examples":[{"description":"Live call against the Notion example graph.","input":"{}","output":"{\n \"message\": \"Workspace initialized\",\n \"workspace_path\": \".upg/\",\n \"default_product\": \"fixture.upg\",\n \"products\": [\n {\n \"file\": \"fixture.upg\",\n \"title\": \"Notion (SATURATED test graph)\"\n }\n ],\n \"current_product\": {\n \"title\": \"Notion (SATURATED test graph)\",\n \"entities\": 2054\n }\n}"}],"warnings":["One-time setup operation. Idempotent failure on retry: if the\nworkspace already exists, raises `WorkspaceAlreadyExistsError`. Pair\nwith `get_workspace_info` to check state before re-running."],"see":["create_product","switch_product","get_workspace_info"],"source":"src/tools/workspace.ts:599","atomicity":"non-atomic. The operation creates a directory and (optionally)\nmoves a file as separate filesystem mutations."},{"name":"link_area_to_audience","slug":"link-area-to-audience","description":"Link a product area to a canonical audience: create an `area_serves_persona` (target is a registry persona) or `area_targets_market_segment` (target is a registry market_segment) cross-edge, with optional `relevance` (primary/secondary) and `audience_role` qualifiers. The edge type is inferred from the canonical entity's type. Source is the product_area id; target is `registry/{canonical_id}`. This is the only path that creates the area↔audience edges. Idempotent: an existing edge is updated (qualifiers), not duplicated.","domain":"workspace","groupId":"workspace","args":[{"name":"area_id","type":"string","required":true,"description":"The product_area id (see list_product_areas).","enumValues":"$undefined"},{"name":"canonical_id","type":"string","required":true,"description":"A registry persona or market_segment (bare or registry/{id}).","enumValues":"$undefined"},{"name":"relevance","type":"string","required":false,"description":"Whether this audience is a primary or secondary focus of the area.","enumValues":["primary","secondary"]},{"name":"audience_role","type":"string","required":false,"description":"The audience role in this area's context (persona targets only).","enumValues":["buyer","user","champion","influencer","partner"]}],"returns":"JSON: `{ edge, area, canonical, portfolio_file, already_existed?, updated? }`.","returnShape":"{ edge, area, canonical, portfolio_file, already_existed?, updated? }","returnNotes":"$undefined","examples":[],"warnings":[],"see":["define_canonical_entity","list_product_areas"],"source":"src/tools/workspace.ts:1320","atomicity":"non-atomic. Edge append to the portfolio document."},{"name":"list_local_products","slug":"list-local-products","description":"Find every .upg file in the current directory and its immediate subdirectories.","domain":"workspace","groupId":"workspace","args":[],"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).","returnShape":"{ products: Array<{ file, title, stage, nodes, edges }> }","returnNotes":["`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)."],"examples":[{"description":"Live call against the Notion example graph.","input":"{}","output":"{\n \"products\": [\n {\n \"file\": \"test-fixtures/sample.upg\",\n \"title\": \"Example Product Graph\",\n \"stage\": \"mvp\",\n \"nodes\": 8,\n \"edges\": 6\n }\n ]\n}"}],"warnings":[],"see":["switch_product","get_workspace_info"],"source":"src/tools/workspace.ts:222","atomicity":"atomic (read-only)"},{"name":"list_portfolio_cross_edges","slug":"list-portfolio-cross-edges","description":"List cross-product edges stored in the portfolio document (`.upg/portfolio.upg`), optionally filtered, grouped, title-resolved, property-projected, freshness-filtered, and paginated. Empty list when the portfolio document is absent. Use `type` + `group_by` to read a focused comparison matrix; `resolve_titles` (default on) names entities (\"Sitecore\") instead of opaque ids; `property_include` trims heavy edge properties; `older_than_days` / `assessed_before` return the stale set (edges whose assessed_on is old or absent); `limit` / `offset` page the flat list. For the nested axis to value to members view use `get_portfolio_tree`.","domain":"workspace","groupId":"workspace","args":[{"name":"type","type":"string","required":false,"description":"Filter to one cross-edge type (e.g. competitor_classified_as_classification_value).","enumValues":"$undefined"},{"name":"source_product_id","type":"string","required":false,"description":"Filter to edges whose source node is in this product.","enumValues":"$undefined"},{"name":"group_by","type":"string","required":false,"description":"Group edges by source or target endpoint (the comparison matrix) instead of a flat list.","enumValues":["source","target"]},{"name":"resolve_titles","type":"boolean","required":false,"description":"Add source_title / target_title to each edge, resolved from the registry and instance_of registrations. Default true.","enumValues":"$undefined"},{"name":"property_include","type":"array","required":false,"description":"Keep only these keys of each edge properties object (e.g. [\"confidence\"]). Pass [] to drop properties entirely.","enumValues":"$undefined"},{"name":"older_than_days","type":"number","required":false,"description":"Freshness filter: keep only edges whose properties.assessed_on is older than this many days (the stale set). An edge with no assessed_on counts as stale. Wins over assessed_before.","enumValues":"$undefined"},{"name":"assessed_before","type":"string","required":false,"description":"Freshness filter: keep only edges assessed before this ISO date (e.g. 2026-06-15). An edge with no assessed_on counts as stale.","enumValues":"$undefined"},{"name":"limit","type":"number","required":false,"description":"Max edges to return in the flat list (ignored when group_by is set).","enumValues":"$undefined"},{"name":"offset","type":"number","required":false,"description":"Skip this many edges before the page (flat list only).","enumValues":"$undefined"}],"returns":"JSON: flat `{ cross_edges, total, returned, offset?, has_more?,\nportfolio_file? }`, or when grouped `{ grouped_by, groups, total,\ngroup_count }`.","returnShape":"$undefined","returnNotes":["JSON: flat `{ cross_edges, total, returned, offset?, has_more?, portfolio_file? }`, or when grouped `{ grouped_by, groups, total, group_count }`."],"examples":[],"warnings":[],"see":["get_portfolio_tree","create_cross_product_edge"],"source":"src/tools/workspace.ts:1475","atomicity":"atomic (read-only)"},{"name":"list_portfolios","slug":"list-portfolios","description":"List portfolios from the portfolio document (`.upg/portfolio.upg`). Portfolios represent the strategic axis (where we invest). Returns an empty list when no portfolio document exists yet.","domain":"workspace","groupId":"workspace","args":[],"returns":"JSON: `{ portfolios: Array<{ id, title, description?,\nparent_portfolio_id?, hierarchy_model?, products? }>, total }`.","returnShape":"{ portfolios: Array<{ id, title, description?, parent_portfolio_id?, hierarchy_model?, products? }>, total }","returnNotes":"$undefined","examples":[{"description":"Live call against the Notion example graph.","input":"{}","output":"{\n \"portfolios\": [],\n \"total\": 0\n}"}],"warnings":[],"see":["create_cross_product_edge","get_organization"],"source":"src/tools/workspace.ts:724","atomicity":"atomic (read-only)"},{"name":"list_registry","slug":"list-registry","description":"List the canonical shared entities in the portfolio registry. Each row carries id, type, title, optional audience_role, and TWO counts that answer different questions: `instance_count` (inbound `instance_of` edges from PRODUCT graphs) and `registry_edge_count` (the registry's own internal edges on either endpoint, written by `create_registry_edge`). A canonical with `instance_count: 0` is NOT necessarily unreferenced, so check `registry_edge_count` before treating one as safe to retire or re-point. With `include_instances` / `include_edges`, attaches the instances / registry-internal edges themselves. Empty when no registry exists yet.","domain":"workspace","groupId":"workspace","args":[{"name":"type","type":"string","required":false,"description":"Filter to one entity type (e.g. persona).","enumValues":"$undefined"},{"name":"include_instances","type":"boolean","required":false,"description":"Attach each canonical's product instances (default false).","enumValues":"$undefined"},{"name":"include_edges","type":"boolean","required":false,"description":"Attach each canonical's registry-internal edges, each tagged inbound/outbound (default false).","enumValues":"$undefined"}],"returns":"JSON: `{ registry: Array<{ id, type, title, description?,\naudience_role?, instance_count, registry_edge_count, instances?, edges? }>,\ntotal, by_type }`. Returns an empty registry when none exists yet.","returnShape":"{ registry: Array<{ id, type, title, description?, audience_role?, instance_count, registry_edge_count, instances?, edges? }>, total, by_type }","returnNotes":["Returns an empty registry when none exists yet."],"examples":[],"warnings":[],"see":["list_registry_edges","define_canonical_entity","register_instance"],"source":"src/tools/registry.ts:392","atomicity":"atomic (read-only)."},{"name":"list_registry_edges","slug":"list-registry-edges","description":"Enumerate the registry's INTERNAL edges: the read counterpart to `create_registry_edge`. These edges live in `registry.edges` in the portfolio document and never touch a product graph, which is why the product-scoped readers miss them. `export_edges` enumerates the ACTIVE PRODUCT's edges and returns an empty array for registry-only types, and an empty array meaning *wrong scope* is indistinguishable from one meaning *no such edges*. Ask this tool \"what points at this canonical\" before planning any migration that retires or re-points registry entities, because `list_registry`'s `instance_count` counts only inbound `instance_of` edges from product graphs, not these. Returns the same `{ id, source, target, type }` shape as `export_edges`, with bare (unqualified) registry endpoint ids.","domain":"workspace","groupId":"workspace","args":[{"name":"types","type":"array","required":false,"description":"Filter to these catalog edge types (omit to enumerate all registry edges).","enumValues":"$undefined"},{"name":"endpoint_id","type":"string","required":false,"description":"Filter to edges touching this registry node in EITHER direction (bare or registry/{id}).","enumValues":"$undefined"},{"name":"source_id","type":"string","required":false,"description":"Filter to edges leaving this registry node (bare or registry/{id}).","enumValues":"$undefined"},{"name":"target_id","type":"string","required":false,"description":"Filter to edges arriving at this registry node (bare or registry/{id}).","enumValues":"$undefined"}],"returns":"JSON: `{ edges: Array<{ id, source, target, type }>, total, by_type }`.\nReturns an empty enumeration when no portfolio/registry exists yet.","returnShape":"{ edges: Array<{ id, source, target, type }>, total, by_type }","returnNotes":["Returns an empty enumeration when no portfolio/registry exists yet."],"examples":[],"warnings":[],"see":["create_registry_edge","list_registry","export_edges"],"source":"src/tools/registry.ts:951","atomicity":"atomic (read-only)."},{"name":"merge_canonical_entities","slug":"merge-canonical-entities","description":"Merge two or more canonical registry entities into one surviving canonical: the fix for twin canonicals created across separate canonicalization passes (e.g. `persona_editor` + `persona_editor_2` with every instance registered under both). In one atomic flush: repoints every cross-edge from `registry/{loser}` to `registry/{keep}` (a repoint that would duplicate an existing edge, the double-parented instance case, drops the redundant edge instead, preserving any `alias` sanction), repoints registry-internal edges (self-loops and duplicates drop), unions each loser's description/tags/properties into the keeper's GAPS (the keeper always wins where both define a value), then deletes the losers. All canonicals must share one entity type. Preview the full plan with `dry_run: true`.","domain":"workspace","groupId":"workspace","args":[{"name":"keep","type":"string","required":true,"description":"The surviving canonical id (bare, or registry/{id}).","enumValues":"$undefined"},{"name":"merge","type":"array","required":true,"description":"1–20 canonical ids to fold into keep. Same type as keep.","enumValues":"$undefined"},{"name":"dry_run","type":"boolean","required":false,"description":"Preview the merge plan (repoints, drops, property fills); nothing is written (default false).","enumValues":"$undefined"}],"returns":"JSON: `{ kept, merged, repointed_cross_edges, dropped_duplicate_edges,\nrepointed_registry_edges, dropped_registry_edges, properties_added,\nportfolio_file }` — or the same shape under `dry_run: true`.","returnShape":"{ kept, merged, repointed_cross_edges, dropped_duplicate_edges, repointed_registry_edges, dropped_registry_edges, properties_added, portfolio_file }","returnNotes":["— or the same shape under `dry_run: true`."],"examples":[],"warnings":[],"see":["delete_canonical_entity","list_registry"],"source":"src/tools/registry.ts:1163","atomicity":"atomic. Repoints, unions, and deletions land in one portfolio flush."},{"name":"migrate_cross_edges","slug":"migrate-cross-edges","description":"Migrate inline cross-product edges from the current product's `edges[]` into the portfolio document (`.upg/portfolio.upg`) with qualified IDs. `dry_run: true` (default) previews; `dry_run: false` applies. Requires `source_product_id` to qualify source node IDs.","domain":"workspace","groupId":"workspace","args":[{"name":"source_product_id","type":"string","required":true,"description":"Product ID that owns the current document's nodes. Used to build qualified source IDs ({product_id}/{node_id}).","enumValues":"$undefined"},{"name":"target_product_id","type":"string","required":false,"description":"Product ID that owns the target nodes, when the target node is not in the current product. Edges without a resolvable target product are skipped.","enumValues":"$undefined"},{"name":"dry_run","type":"boolean","required":false,"description":"When true (default), report what would be migrated without writing anything.","enumValues":"$undefined"}],"returns":"JSON: `{ migrated, skipped, dry_run, portfolio_file? }`.","returnShape":"{ migrated, skipped, dry_run, portfolio_file? }","returnNotes":"$undefined","examples":[],"warnings":["Default is `dry_run: true`. Pass `dry_run: false` to commit. Idempotent\non retry: a second `dry_run: false` after a successful migration finds zero\ninline cross-edges and reports `migrated: []`."],"see":["create_cross_product_edge","list_portfolio_cross_edges","list_cross_edge_types","init_workspace"],"source":"src/tools/workspace.ts:1640","atomicity":"non-atomic. Portfolio write + product file save are separate."},{"name":"portfolio_census","slug":"portfolio-census","description":"List product-local nodes of ONE type ACROSS the whole portfolio with a chosen projection (the cross-product `list_nodes`). The overflow-safe answer to \"every metric across all 16 graphs, with title + description\": the read every canonicalisation / coverage pass needs. Unlike `portfolio_query` (which returns full nodes AND traversed edges, and overflows the payload cap past ~195 nodes), a census never traverses and never returns edges, so payload scales only with row count x projected-field size. Each row is `{ product_id, node_id, }`; `group_by: \"product\"` nests rows under each product instead. Read-only; never mutates active-product state.","domain":"workspace","groupId":"workspace","args":[{"name":"type","type":"string","required":true,"description":"Entity type to census (e.g. \"metric\", \"persona\", \"primitive\"). Required.","enumValues":"$undefined"},{"name":"include","type":"array","required":false,"description":"Projected fields per node: \"title\", \"status\", \"tags\", \"description\", \"properties\" (default: [\"title\"]). id (as node_id) and product_id are always present.","enumValues":"$undefined"},{"name":"property_include","type":"array","required":false,"description":"When \"properties\" is in include, only return these property keys.","enumValues":"$undefined"},{"name":"group_by","type":"string","required":false,"description":"none (one flat `rows` list, default) or product (nest rows under each product, the comparison view).","enumValues":["none","product"]},{"name":"status","type":"string","required":false,"description":"Only census nodes with this lifecycle status.","enumValues":"$undefined"},{"name":"tags","type":"array","required":false,"description":"Only census nodes carrying at least one of these tags.","enumValues":"$undefined"},{"name":"scope","type":"array","required":false,"description":"Product IDs (or files) to census. Omit to census ALL products in the workspace. Match by product id, relative file, or basename. (`products` is accepted as an alias.)","enumValues":"$undefined"},{"name":"limit","type":"number","required":false,"description":"Max rows in the returned page (default 1000, max 5000). Pages the flat sequence; `total` reports the full match count.","enumValues":"$undefined"},{"name":"offset","type":"number","required":false,"description":"Skip this many rows before the page (default 0). With `limit`, pages a large census.","enumValues":"$undefined"}],"returns":"JSON. Flat (default): `{ type, rows: Array<{ product_id, node_id,\n }>, total, returned, offset, limit, has_more, products_searched,\nproducts_with_matches, errored_products?, unmatched_scope? }`. With\n`group_by: \"product\"`: a `products: Array<{ product_id, file, title, count,\nrows: Array<{ node_id, }> }>` nesting replaces the flat `rows`.\n`total` is the full match count across the portfolio; `rows`/`products` hold\nthe requested page (`offset`/`limit`). Projection defaults to `[\"title\"]`.","returnShape":"$undefined","returnNotes":["JSON.","Flat (default): `{ type, rows: Array<{ product_id, node_id, }>, total, returned, offset, limit, has_more, products_searched, products_with_matches, errored_products?, unmatched_scope? }`.","With `group_by: \"product\"`: a `products: Array<{ product_id, file, title, count, rows: Array<{ node_id, }> }>` nesting replaces the flat `rows`.","`total` is the full match count across the portfolio; `rows`/`products` hold the requested page (`offset`/`limit`).","Projection defaults to `[\"title\"]`."],"examples":[],"warnings":[],"see":["list_nodes","portfolio_query","portfolio_digest"],"source":"src/tools/portfolio-read.ts:1636","atomicity":"atomic (read-only). Never mutates active-product state."},{"name":"portfolio_digest","slug":"portfolio-digest","description":"Roll up every product's counts, health, and stage-coverage in one call (the multi-product `get_graph_digest`). The strategic-surface read that otherwise required `switch_product` + `get_graph_digest` per graph. Returns per-product summaries plus a portfolio rollup (totals, products-by-stage). Read-only; never mutates active-product state.","domain":"workspace","groupId":"workspace","args":[{"name":"scope","type":"array","required":false,"description":"Product IDs (or files) to summarise. Omit to summarise ALL products in the workspace.","enumValues":"$undefined"},{"name":"coverage_profile","type":"array","required":false,"description":"Batch-4 #22: coverage region ids (keys of the `coverage` block, e.g. understanding, discovery, building) to score each product against, so \"is this product at parity?\" is a direct read across the portfolio. Adds `coverage_profile_pct` to every product summary.","enumValues":"$undefined"}],"returns":"JSON: `{ products: Array<{ product_id, file, title, stage,\ntotal_nodes, total_edges, health, coverage_pct, top_types }>, rollup:\n{ products, total_nodes, total_edges, by_stage }, errored_products?,\nunmatched_scope? }`. `health`/`coverage_pct` come from `computeGraphDigest`,\nidentical to what `get_graph_digest` reports per product.","returnShape":"{ products: Array<{ product_id, file, title, stage, total_nodes, total_edges, health, coverage_pct, top_types }>, rollup: { products, total_nodes, total_edges, by_stage }, errored_products?, unmatched_scope? }","returnNotes":["`health`/`coverage_pct` come from `computeGraphDigest`, identical to what `get_graph_digest` reports per product."],"examples":[],"warnings":[],"see":["get_graph_digest","portfolio_query"],"source":"src/tools/portfolio-read.ts:436","atomicity":"atomic (read-only). Never mutates active-product state."},{"name":"portfolio_query","slug":"portfolio-query","description":"Traverse the graph ACROSS products in one call (the multi-product `query`). Runs the same BFS (typed-edge traversal + field projection) against every product in scope and tags each subgraph with its source `product_id`, without `switch_product` (the active product is read live; others are read-only). Use for portfolio-level questions (\"every product's strategy region\", \"which products have a persona\"). `from_id` only matches in its owning product. Read-only.","domain":"workspace","groupId":"workspace","args":[{"name":"from","type":"string","required":false,"description":"Start from all nodes of this type (in each product)","enumValues":"$undefined"},{"name":"from_id","type":"string","required":false,"description":"Start from a specific node ID. Node IDs are product-local; only the owning product returns results.","enumValues":"$undefined"},{"name":"traverse","type":"array","required":false,"description":"Edge types to follow at each level (in order). If omitted, follows all edges. Prefix with ! to exclude.","enumValues":"$undefined"},{"name":"depth","type":"number","required":false,"description":"Max traversal depth (default 3, max 10)","enumValues":"$undefined"},{"name":"include","type":"array","required":false,"description":"Fields per node: \"title\", \"status\", \"tags\", \"description\", \"properties\" (default: title, status, type)","enumValues":"$undefined"},{"name":"limit","type":"number","required":false,"description":"Max nodes per product (default 100, max 1000)","enumValues":"$undefined"},{"name":"edge_include","type":"array","required":false,"description":"Edge fields to return: \"id\", \"type\", \"source\", \"target\". Empty array = no edges. Default: all fields.","enumValues":"$undefined"},{"name":"property_include","type":"array","required":false,"description":"When \"properties\" is in include, only return these property keys.","enumValues":"$undefined"},{"name":"scope","type":"array","required":false,"description":"Product IDs (or files) to query. Omit to query ALL products in the workspace. Match by product id, relative file, or basename.","enumValues":"$undefined"}],"returns":"JSON: `{ products: Array<{ product_id, file, title, total_nodes,\ntotal_edges, nodes, edges, truncated? }>, products_searched,\nproducts_with_matches, empty_products, unmatched_scope? }`. Products that\nmatched zero nodes are summarised in `empty_products`, not expanded, to\nkeep the payload lean. `from_id` only matches in its owning product; the\nrest report empty.","returnShape":"{ products: Array<{ product_id, file, title, total_nodes, total_edges, nodes, edges, truncated? }>, products_searched, products_with_matches, empty_products, unmatched_scope? }","returnNotes":["Products that matched zero nodes are summarised in `empty_products`, not expanded, to keep the payload lean.","`from_id` only matches in its owning product; the rest report empty."],"examples":[],"warnings":[],"see":["query","portfolio_digest","list_local_products"],"source":"src/tools/portfolio-read.ts:264","atomicity":"atomic (read-only). Never mutates active-product state."},{"name":"portfolio_validate","slug":"portfolio-validate","description":"Run `validate_graph` ACROSS every product in scope in one call (the audit counterpart to `portfolio_digest`). Replaces the `switch_product` + `validate_graph` round-trip per product. Each product is checked by the SAME single-product code path (schema drift + anti-patterns), so per-product verdicts never diverge. Returns a per-product `valid` / `structurally_valid` + drift + anti-pattern counts, plus a portfolio rollup with `all_valid`. Read-only; the active product is read live, the rest read-only.","domain":"workspace","groupId":"workspace","args":[{"name":"scope","type":"array","required":false,"description":"Product IDs (or files) to validate. Omit to validate ALL products in the workspace.","enumValues":"$undefined"},{"name":"severity","type":"string","required":false,"description":"Restrict anti-pattern evaluation to this severity (passed through to validate_graph).","enumValues":["high","medium","low"]},{"name":"include_violations","type":"boolean","required":false,"description":"Include a per-product `top_violations` list (default true).","enumValues":"$undefined"},{"name":"violation_limit","type":"number","required":false,"description":"Max anti-pattern violations listed per product (default 5, max 25).","enumValues":"$undefined"}],"returns":"$39","returnShape":"{ products: Array<{ product_id, file, title, valid, structurally_valid, drift, anti_patterns: { high, medium, low }, top_violations? }>, rollup: { products, valid, invalid, structurally_valid, anti_pattern_violations, all_valid }, errored_products?, unmatched_scope? }","returnNotes":["`severity` filters anti-patterns; `include_violations: false` drops the per-product `top_violations` list.","When the portfolio has a canonical registry, a `registry_drift` block reports `instance_of` edges that point at a missing canonical, dangle, mismatch type, or were renamed off-canon (canonical-registry initiative, Phase 3).","When the portfolio uses the foundations tier (a registry specification / primitive or a foundations cross-edge), a `portfolio_anti_patterns` block reports the portfolio-scoped (`scope: 'portfolio'`) anti-patterns: specification-without-implementer, primitive-scattered-without-canonical, product-reimplements-specification (0.9.13), operating-function-without-org-link (0.17.0), and duplicate-key-across-products (0.34.0).","The last also makes the block relevant on its own: a portfolio whose products mint citable keys gets the report even with no foundations tier and no operating functions."],"examples":[],"warnings":[],"see":["validate_graph","portfolio_digest","portfolio_query","list_registry"],"source":"src/tools/portfolio-read.ts:947","atomicity":"atomic (read-only). Never mutates active-product state."},{"name":"promote_to_canonical","slug":"promote-to-canonical","description":"Promote an existing product node into the registry as its canonical, instead of authoring a fresh thinner one with `define_canonical_entity`. Copies the source node's description/tags/properties into a new registry node and (by default) registers the source as the canonical's first instance. Lets a team canonicalise the rich node they already curated.","domain":"workspace","groupId":"workspace","args":[{"name":"node_id","type":"string","required":true,"description":"The existing node (bare resolves against active product or source_product_id; or qualified {product_id}/{node_id}).","enumValues":"$undefined"},{"name":"source_product_id","type":"string","required":false,"description":"Product ID owning a bare node_id.","enumValues":"$undefined"},{"name":"canonical_id","type":"string","required":false,"description":"Optional explicit registry id; otherwise derived from type + title.","enumValues":"$undefined"},{"name":"register_source","type":"boolean","required":false,"description":"Register the source node as the first instance (default true).","enumValues":"$undefined"}],"returns":"JSON: `{ canonical, qualified_id, registered_source, edge?, portfolio_file }`.","returnShape":"{ canonical, qualified_id, registered_source, edge?, portfolio_file }","returnNotes":"$undefined","examples":[],"warnings":[],"see":["define_canonical_entity","register_instance"],"source":"src/tools/registry.ts:733","atomicity":"non-atomic. Registry node add (+ optional instance_of edge) + flush."},{"name":"register_instance","slug":"register-instance","description":"Link a product node to a canonical registry entity by creating an `instance_of` cross-edge (product entity → `registry/{id}`). This is the only path that creates `instance_of` edges: it requires the canonical to exist and enforces the same-type constraint (a persona instance_of a persona). Idempotent: re-registering the same instance returns the existing edge. Set `alias: true` to sanction a deliberate title divergence (an informative product-local name) so registry drift detection ignores it. Use after `define_canonical_entity` to attach each product's local copy to the shared definition.","domain":"workspace","groupId":"workspace","args":[{"name":"node_id","type":"string","required":true,"description":"The product instance node. Bare id resolves against the active product (or source_product_id); a qualified {product_id}/{node_id} targets any workspace product.","enumValues":"$undefined"},{"name":"canonical_id","type":"string","required":true,"description":"The registry entity id (bare, or registry/{id}).","enumValues":"$undefined"},{"name":"source_product_id","type":"string","required":false,"description":"Product ID owning the instance, when node_id is a bare id not in the active product.","enumValues":"$undefined"},{"name":"alias","type":"boolean","required":false,"description":"Mark a deliberate title divergence from the canonical as sanctioned, excluding it from registry drift. Can be toggled on an existing instance_of edge.","enumValues":"$undefined"}],"returns":"JSON: `{ edge, instance, canonical, portfolio_file, already_existed? }`.","returnShape":"{ edge, instance, canonical, portfolio_file, already_existed? }","returnNotes":"$undefined","examples":[],"warnings":[],"see":["define_canonical_entity","list_registry"],"source":"src/tools/registry.ts:255","atomicity":"non-atomic. Edge append to the portfolio document."},{"name":"reload_product","slug":"reload-product","description":"Re-read the ACTIVE product from disk, discarding any unsaved in-memory changes. The in-band escape from a wedged save-conflict: when the active product was edited in another session, flush()/switch_product keep throwing CONFLICT and the stale snapshot persists; this clears it WITHOUT restarting the server. When there are unsaved changes you must pass `discard_local: true` to proceed (the reload would drop them); with no unsaved changes it is a safe refresh. Local-only.","domain":"workspace","groupId":"workspace","args":[{"name":"discard_local","type":"boolean","required":false,"description":"Discard unsaved in-memory changes and re-read from disk. Required (true) when the active product has unsaved changes; ignored when it is clean. Default false.","enumValues":"$undefined"}],"returns":"JSON: `{ message, file, product: { title, stage }, entities,\ndiscarded_local_changes }`.","returnShape":"{ message, file, product: { title, stage }, entities, discarded_local_changes }","returnNotes":"$undefined","examples":[],"warnings":[],"see":["switch_product","get_workspace_info"],"source":"src/tools/workspace.ts:468","atomicity":"non-atomic. Stops the watcher, re-reads the file, re-arms the watcher."},{"name":"switch_product","slug":"switch-product","description":"Switch to a different .upg file without restarting the server. In workspace mode, accepts just a filename (e.g. \"client-project\" or \"client-project.upg\").","domain":"workspace","groupId":"workspace","args":[{"name":"file","type":"string","required":true,"description":"Path to the .upg file (relative, absolute, or a bare product name in workspace mode). Alias: `product`.","enumValues":"$undefined"},{"name":"product","type":"string","required":false,"description":"Alias for `file`.","enumValues":"$undefined"}],"returns":"JSON: `{ message, file, product: { title, stage }, entities }`.","returnShape":"{ message, file, product: { title, stage }, entities }","returnNotes":"$undefined","examples":[],"warnings":["Mutates server-side workspace state. After an MCP reconnect the\nserver reverts to the workspace default. Call `get_workspace_info`\nbefore any read/mutation to confirm the active product."],"see":["get_workspace_info","list_local_products","init_workspace"],"source":"src/tools/workspace.ts:316","atomicity":"non-atomic. Flushes the current store, stops watching, and\nloads the new file as separate filesystem operations."},{"name":"update_canonical_entity","slug":"update-canonical-entity","description":"Edit a canonical registry entity in place (title, description, audience_role, tags, properties) WITHOUT disturbing the `instance_of` edges that point at it. The fix for a canonical seeded with a typo or placeholder: correct it via the API instead of hand-editing portfolio.upg. Properties are shallow-merged. At least one editable field is required.","domain":"workspace","groupId":"workspace","args":[{"name":"canonical_id","type":"string","required":true,"description":"The registry entity id (bare, or registry/{id}).","enumValues":"$undefined"},{"name":"title","type":"string","required":false,"description":"New canonical name.","enumValues":"$undefined"},{"name":"description","type":"string","required":false,"description":"New description.","enumValues":"$undefined"},{"name":"audience_role","type":"string","required":false,"description":"Persona audience role (buyer/user/champion/influencer/partner); merged into properties.","enumValues":"$undefined"},{"name":"tags","type":"array","required":false,"description":"Replacement tags.","enumValues":"$undefined"},{"name":"properties","type":"object","required":false,"description":"Properties to shallow-merge into the canonical.","enumValues":"$undefined"}],"returns":"JSON: `{ canonical, qualified_id, instance_count, portfolio_file }`.","returnShape":"{ canonical, qualified_id, instance_count, portfolio_file }","returnNotes":"$undefined","examples":[],"warnings":[],"see":["define_canonical_entity"],"source":"src/tools/registry.ts:459","atomicity":"non-atomic. In-place registry node patch + flush."},{"name":"update_product","slug":"update-product","description":"Update the product header (`$upg.product`): stage, title, description, health_status, url, and the workspace member_kind. The supported way to advance a product's lifecycle stage or re-kind a graph; it writes the value get_graph_digest reads, without hand-editing the integrity-hashed .upg file. A title rename or a re-kind also reconciles the workspace.json cache and the portfolio.upg registry, so list_local_products, get_workspace_info, portfolio_census, counts.products, and the watched anti-pattern scoping all show the current value. Set rename_file (or pass an explicit slug) to also rename the .upg file to match the title: it moves the file, repoints the open handle so the rest of the session writes to the new path, and updates the workspace.json file path and the portfolio.upg file_path. The rename is opt-in; a plain title change leaves the filename alone.","domain":"workspace","groupId":"workspace","args":[{"name":"stage","type":"string","required":false,"description":"Product lifecycle stage (canonical UPGProductStage).","enumValues":"$undefined"},{"name":"title","type":"string","required":false,"description":"Product display title.","enumValues":"$undefined"},{"name":"description","type":"string","required":false,"description":"Product description.","enumValues":"$undefined"},{"name":"health_status","type":"string","required":false,"description":"Product health (free-form, e.g. on_track / at_risk).","enumValues":"$undefined"},{"name":"url","type":"string","required":false,"description":"Product URL.","enumValues":"$undefined"},{"name":"member_kind","type":"string","required":false,"description":"Workspace member kind. product (default, an owned product), org_rollup (company umbrella graph), watched (a monitored intelligence graph, e.g. a competitor), or operating_function (a function a team operates, across revenue/success/finance/people/marketing, not a product it ships). Non-product kinds are excluded from product coverage / counts and graded on their own validation profile.","enumValues":["product","org_rollup","watched","operating_function"]},{"name":"rename_file","type":"boolean","required":false,"description":"Rename the .upg file to match the title slug. Opt-in; moves the file and reconciles the open handle, workspace.json path, and portfolio.upg file_path.","enumValues":"$undefined"},{"name":"slug","type":"string","required":false,"description":"Explicit slug for the file rename (implies rename_file). Slugified and collision-resolved so a sibling file is never clobbered.","enumValues":"$undefined"}],"returns":"JSON: `{ product, updated: string[] }` (the fields changed).","returnShape":"{ product, updated: string[] }","returnNotes":["(the fields changed)."],"examples":[],"warnings":[],"see":["create_product"],"source":"src/tools/workspace.ts:678","atomicity":"atomic (single flush)."},{"name":"upsert_composition","slug":"upsert-composition","description":"$3a","domain":"workspace","groupId":"workspace","args":[{"name":"slug","type":"string","required":true,"description":"The slug, which IS the node id. A composition is addressed by what appears in its URL, so no surrogate id is minted. Reusing an existing slug republishes that view.","enumValues":"$undefined"},{"name":"title","type":"string","required":true,"description":"Display title of the view.","enumValues":"$undefined"},{"name":"description","type":"string","required":false,"description":"What this view is for. Omit to leave any stored description alone.","enumValues":"$undefined"},{"name":"lifecycle","type":"string","required":true,"description":"Where the view stands: \"draft\" while it is being arranged and has never been live, \"published\" once it resolves at its slug, \"archived\" when withdrawn but kept so old links resolve. Written to the node's `status`, using the phases the spec declares for a composition. \"retired\" is a DEPRECATED alias for \"archived\" and is accepted, stored as \"archived\". Only a write with \"published\" increments `rev`.","enumValues":["draft","published","archived","retired"]},{"name":"focus_node_ids","type":"array","required":false,"description":"Nodes this view is ABOUT, written as `composition_focuses_node` edges. This is what makes \"which published views show this persona?\" answerable to a tool that cannot parse the URLs of whichever tool published the view. An empty set is valid: a view scoped by query rather than enumeration focuses nothing in particular. Ids that do not resolve here are dropped.","enumValues":"$undefined"},{"name":"members","type":"array","required":false,"description":"The frozen block arrangement. OMIT to leave the stored arrangement untouched; pass [] to clear it. The two are different instructions.","enumValues":"$undefined"},{"name":"member_query","type":"object","required":false,"description":"A declarative, portable SELECTION over the graph: which nodes the view shows. Selection only; what it looks like is `presentation`. `clauses` is authoritative and the named fields are a positive-only shorthand for it, so a reader that finds `clauses` uses it and ignores the named fields. Holds no node references except `classified_as`, and relative selections walk from the focused set via `from_focus` rather than naming ids.","enumValues":"$undefined"},{"name":"presentation","type":"object","required":false,"description":"Advisory rendering intent. A consumer MAY ignore every field here and stay conformant, because every default it then applies is the safe one.","enumValues":"$undefined"},{"name":"published_by","type":"string","required":false,"description":"Publisher handle or email. A display scalar.","enumValues":"$undefined"},{"name":"rev","type":"integer","required":false,"description":"The revision you last read, as an optimistic PRECONDITION. Never the value written: the stored revision is re-derived inside the write, so two publishers racing produce N+1 then N+2. Supplying it turns \"I am publishing\" into \"I am publishing what I saw at rev N\", and a mismatch returns status \"stale_revision\" with `stored_rev`. Omit to publish unconditionally.","enumValues":"$undefined"}],"returns":"JSON `{ status: 'ok', composition }` on success. Refusals are\nreturned as errors carrying a structured body: `{ status: 'stale_revision',\nstored_rev, reason }` when a supplied `rev` did not match, `{ status:\n'conflict', reason }` when the file moved under us or the slug belongs to a\nnode of another type, `{ status: 'not_found' }` when no graph is loaded.","returnShape":"{ status: 'ok', composition }","returnNotes":["on success.","Refusals are returned as errors carrying a structured body: `{ status: 'stale_revision', stored_rev, reason }` when a supplied `rev` did not match, `{ status: 'conflict', reason }` when the file moved under us or the slug belongs to a node of another type, `{ status: 'not_found' }` when no graph is loaded."],"examples":[],"warnings":["`rev` is never written from the argument. Supplying it makes the\nwrite conditional (publish what I saw at rev N); a mismatch refuses and the\nfile is left BYTE-UNCHANGED. Omitting `members` PRESERVES the stored\narrangement, while `[]` clears it. A `focus_node_ids` entry that does not\nresolve in this graph is dropped rather than written as a dangling edge."],"see":["get_node","list_nodes"],"source":"src/tools/workspace.ts:2059","atomicity":"atomic (node + focus edges in a single flush; a refused write\nnever touches the file)."}]},{"id":"schema","label":"Schema","description":"Entity schemas, valid children, entity metadata, and type labels.","tools":[{"name":"get_entity_schema","slug":"get-entity-schema","description":"Return expected properties, valid statuses, valid edge types, and domain for an entity type. Lets agents construct valid entities without skill prompts. Each property carries its contract in `description`; pass `include_notes` for the longform rationale. Optional `include` folds in valid child types / super-domain region; optional `resolve_edge_to` folds in the canonical edge for this type → that target.","domain":"schema","groupId":"schema","args":[{"name":"type","type":"string","required":true,"description":"Entity type (e.g. \"hypothesis\", \"persona\", \"opportunity\")","enumValues":"$undefined"},{"name":"include","type":"array","required":false,"description":"Optional extra blocks: \"valid_children\" (folds get_valid_children), \"region\" (folds get_region_for_entity_type).","enumValues":"$undefined"},{"name":"include_notes","type":"boolean","required":false,"description":"Fold the longform half of each property doc (`notes`: rationale, edge cases, workflow recipes) into `expected_properties`. Default false, because `description` already carries the contract and the longform is rarely needed while constructing an entity. Ask for it when a property's exact semantics matter.","enumValues":"$undefined"},{"name":"resolve_edge_to","type":"string","required":false,"description":"Optional target entity type. Folds resolve_edge_for_pair(type → target) into a `resolve_edge` block.","enumValues":"$undefined"}],"returns":"JSON: `{ type, alias_of?, domain, expected_properties, edges_out,\nedges_in, phases?, initial_phase?, terminal_phases?, domain_guide?,\nvalid_children?, region?, resolve_edge? }`.","returnShape":"{ type, alias_of?, domain, expected_properties, edges_out, edges_in, phases?, initial_phase?, terminal_phases?, domain_guide?, valid_children?, region?, resolve_edge? }","returnNotes":"$undefined","examples":[{"description":"Live call against the Notion example graph.","input":"{\n \"type\": \"person\"\n}","output":"$3b"}],"warnings":[],"see":["get_entity_meta","list_entity_types","get_valid_children","get_lifecycle","get_domain_guide","list_edge_types","create_node"],"source":"src/tools/schema.ts:67","atomicity":"atomic (read-only)"}]},{"id":"spec","label":"Spec Introspection","description":"Spec introspection: approaches, playbooks, regions, domains, lenses, frameworks.","tools":[{"name":"apply_framework","slug":"apply-framework","description":"Apply a framework (MoSCoW, RICE, Kano, ...) to a set of entities: creates a framework_exercise node and an `includes` edge to each entity. The per-entity result is recorded on the edge via score_entity, never on the entity node, so the same entity can sit in many exercises and any entity type can be scored. Returns { exercise_id, exercise, included, warnings }.","domain":"spec","groupId":"spec","args":[{"name":"framework_id","type":"string","required":true,"description":"Required. UPGFramework.id (e.g. \"moscow\", \"rice-scoring\").","enumValues":"$undefined"},{"name":"title","type":"string","required":false,"description":"Human label for the exercise (default \" exercise\").","enumValues":"$undefined"},{"name":"entity_ids","type":"array","required":false,"description":"Entities to pull into the exercise (any type).","enumValues":"$undefined"},{"name":"slot_roles","type":"object","required":false,"description":"Optional map of entity id → framework slot role (e.g. { \"feat_x\": \"pain_reliever\" }), stamped onto each entity's includes edge. Validated against the framework's declared slot roles (warn-only).","enumValues":"$undefined"},{"name":"status","type":"string","required":false,"description":"Lifecycle phase: draft | active | archived (default draft).","enumValues":"$undefined"}],"returns":"JSON: `{ exercise_id, exercise, included: [{ edge_id, entity_id, edge_type, slot_role? }], warnings }`\n(the shared cross-surface envelope; identical to CLI `apply --json`).","returnShape":"{ exercise_id, exercise, included: [{ edge_id, entity_id, edge_type, slot_role? }], warnings }","returnNotes":["(the shared cross-surface envelope; identical to CLI `apply --json`)."],"examples":[],"warnings":[],"see":["score_entity"],"source":"src/tools/frameworks.ts:30","atomicity":"atomic."},{"name":"get_catalog_entry","slug":"get-catalog-entry","description":"Fetch one static spec catalog record by `kind` + `id` (one faceted tool replacing the 15 `get_*-by-id` spec-introspection tools). Reads `@unified-product-graph/core`. `id` is the record identifier for that kind: `playbook`/`framework`/`lens`/`scale`/`anti_pattern`/`tree_pattern`/`domain_ring`/`region`/`approach` take their record id; `entity_meta` takes an entity-type name; `edge_type` takes an edge-type key; `lifecycle`/`type_label` take an entity type; `domain_guide` takes a domain id; `template` takes a template id. Use `list_catalog` to enumerate a kind.","domain":"spec","groupId":"spec","args":[{"name":"kind","type":"string","required":true,"description":"Which static spec catalog to read one record from.","enumValues":["entity_meta","edge_type","region","domain_guide","domain_ring","framework","lens","lifecycle","playbook","scale","anti_pattern","tree_pattern","type_label","template","approach"]},{"name":"id","type":"string","required":true,"description":"The record identifier for that kind (see the tool description for the per-kind id meaning).","enumValues":"$undefined"}],"returns":"JSON: the delegated `get_` record verbatim (shape varies by kind).","returnShape":"$undefined","returnNotes":["JSON: the delegated `get_` record verbatim (shape varies by kind)."],"examples":[],"warnings":[],"see":["list_catalog","get_entity_schema"],"source":"src/tools/catalog.ts:151","atomicity":"atomic (read-only)"},{"name":"get_import_recipe","slug":"get-import-recipe","description":"Get an import recipe for a source: (a) the target UPG schema slice (entity/edge types in play + fields), (b) the source→UPG mapping, a canonical CURATED table served verbatim when one exists (Notion, Jira, Dovetail, and 30+ more), else a schema-grounded SCAFFOLD, and (c) the write tools to call in order (batch_create_nodes → batch_create_edges). You already hold the source data and the write tools; this returns the mapping guidance, executes nothing. The consistency guarantee: a curated source resolves to ONE mapping, so the same source imported twice yields the same graph. Surfaces every deliberate-only edge (e.g. insight_informs_opportunity) as a warning, never a silent write. Sibling of get_catalog_entry (kind: \"template\"). Omit source to list curated sources.","domain":"spec","groupId":"spec","args":[{"name":"source","type":"string","required":false,"description":"Source slug or free-text description (e.g. \"notion\", \"Linear issues\", \"a CSV of feature requests\"). Omit to list the curated sources.","enumValues":"$undefined"}],"returns":"JSON: `{ source, target_schema, mapping, execution, warnings? }` for\na resolved source; `{ available_sources, usage }` when `source` is omitted.\nA curated `mapping.kind` serves verbatim adapter tables; a `scaffold`\nreturns catalogue-grounded heuristics. `warnings` surfaces every\ndeliberate-only edge (e.g. `insight_informs_opportunity`) the mapping could\nproduce, so it is never emitted as a silent write.","returnShape":"{ source, target_schema, mapping, execution, warnings? }","returnNotes":["for a resolved source; `{ available_sources, usage }` when `source` is omitted.","A curated `mapping.kind` serves verbatim adapter tables; a `scaffold` returns catalogue-grounded heuristics.","`warnings` surfaces every deliberate-only edge (e.g. `insight_informs_opportunity`) the mapping could produce, so it is never emitted as a silent write."],"examples":[],"warnings":[],"see":["get_catalog_entry","get_entity_schema","resolve_edge_for_pair","list_entity_types"],"source":"src/tools/import-recipe.ts:252","atomicity":"atomic (read-only). Touches neither the source nor the graph."},{"name":"get_spec_version","slug":"get-spec-version","description":"Spec-level metadata for compatibility checks: `upg_version`, `markdown_format_version`, and canonical counts (entity types, edge types, atomic domains, super-domain regions). Pin against the version pair; counts are informational. Pass `changelog: true` to fold in the spec CHANGELOG (a `whats_new` surface); `since` (a version) returns only newer entries.","domain":"spec","groupId":"spec","args":[{"name":"changelog","type":"boolean","required":false,"description":"When true, include a `changelog` array parsed from the spec CHANGELOG.md.","enumValues":"$undefined"},{"name":"since","type":"string","required":false,"description":"With changelog: return only entries strictly newer than this version (e.g. \"0.17.0\").","enumValues":"$undefined"}],"returns":"JSON: `{ upg_version, markdown_format_version, entity_count, edge_count, domain_count, region_count }`","returnShape":"{ upg_version, markdown_format_version, entity_count, edge_count, domain_count, region_count }","returnNotes":"$undefined","examples":[{"description":"Live call against the Notion example graph.","input":"{}","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":[],"see":["get_workspace_info","list_entity_types","list_edge_types","list_regions"],"source":"src/tools/spec.ts:1106","atomicity":"atomic (read-only)"},{"name":"list_catalog","slug":"list-catalog","description":"List a static spec catalog by `kind` (one faceted tool replacing the 25 `list_*` spec-introspection tools). Reads `@unified-product-graph/core`; identical for every client on a given spec version. Kind-specific filters pass straight through: e.g. `playbooks` accepts `region` / `canonical_only` / `framework_id`; `entity_types` accepts `domain` / `maturity` / `deprecated` / `limit` / `cursor`; `benchmarks` requires `benchmark_kind` (`count` | `relationship` | `ratio` | `domain_activation`) plus optional `stage` / `domain`. Use `get_catalog_entry` to fetch one record by id.","domain":"spec","groupId":"spec","args":[{"name":"kind","type":"string","required":true,"description":"Which static spec catalog to list.","enumValues":["entity_types","edge_types","cross_edge_types","regions","domains","domain_rings","frameworks","framework_categories","framework_structure_patterns","lenses","lifecycles","playbooks","scales","anti_patterns","tree_patterns","templates","approaches","type_labels","status_values","product_stages","benchmarks","edge_migrations","scalar_to_edge_migrations","split_migrations","type_migrations"]},{"name":"region","type":"string","required":false,"description":"Filter (playbooks): exact UPGRegionId.","enumValues":"$undefined"},{"name":"canonical_only","type":"boolean","required":false,"description":"Filter (playbooks): canonical playbook per region only.","enumValues":"$undefined"},{"name":"framework_id","type":"string","required":false,"description":"Filter (playbooks / approaches): exact framework id.","enumValues":"$undefined"},{"name":"domain","type":"string","required":false,"description":"Filter (entity_types / benchmarks): exact atomic-domain id.","enumValues":"$undefined"},{"name":"maturity","type":"string","required":false,"description":"Filter (entity_types): draft | proposed | stable | deprecated | removed.","enumValues":"$undefined"},{"name":"deprecated","type":"boolean","required":false,"description":"Filter (entity_types): keep only / exclude deprecated types.","enumValues":"$undefined"},{"name":"stage","type":"string","required":false,"description":"Filter (benchmarks): UPGProductStage.","enumValues":"$undefined"},{"name":"benchmark_kind","type":"string","required":false,"description":"Required for kind=benchmarks: which benchmark catalog (remapped to the retired tool's `kind`).","enumValues":["count","relationship","ratio","domain_activation"]},{"name":"limit","type":"number","required":false,"description":"Pagination (entity_types / type_labels / frameworks / anti_patterns): page size.","enumValues":"$undefined"},{"name":"cursor","type":"string","required":false,"description":"Pagination: opaque cursor from a prior `next_cursor`.","enumValues":"$undefined"}],"returns":"JSON: the delegated `list_` payload verbatim (shape varies by kind).","returnShape":"$undefined","returnNotes":["JSON: the delegated `list_` payload verbatim (shape varies by kind)."],"examples":[],"warnings":[],"see":["get_catalog_entry","get_entity_schema","get_spec_version"],"source":"src/tools/catalog.ts:136","atomicity":"atomic (read-only)"},{"name":"score_entity","slug":"score-entity","description":"Record a framework's result for one entity on the exercise's includes edge (a MoSCoW bucket, a RICE score, a canvas slot). Auto-includes the entity if not already in scope. Merges into existing edge properties unless replace is set. Returns { edge, warnings }.","domain":"spec","groupId":"spec","args":[{"name":"exercise_id","type":"string","required":true,"description":"Required. The framework_exercise id.","enumValues":"$undefined"},{"name":"entity_id","type":"string","required":true,"description":"Required. The entity being scored.","enumValues":"$undefined"},{"name":"values","type":"object","required":true,"description":"Required. The result as { input: value }, e.g. { \"moscow\": \"must\" } or { \"reach\": 4, \"impact\": 3 }.","enumValues":"$undefined"},{"name":"slot_role","type":"string","required":false,"description":"Optional framework slot role this entity plays (e.g. \"pain_reliever\"). Rides the same edge as the scores; validated against the framework's declared slot roles (warn-only).","enumValues":"$undefined"},{"name":"replace","type":"boolean","required":false,"description":"Replace the edge properties instead of merging (default false).","enumValues":"$undefined"}],"returns":"JSON: `{ edge, warnings }`.","returnShape":"{ edge, warnings }","returnNotes":"$undefined","examples":[],"warnings":[],"see":["apply_framework"],"source":"src/tools/frameworks.ts:63","atomicity":"atomic."}]},{"id":"sync","label":"Cloud Sync","description":"Push and pull graph state to/from the UPG cloud.","tools":[{"name":"apply_pull_changeset","slug":"apply-pull-changeset","description":"Apply cloud changes to the local `.upg` file. Takes cloud nodes and edges (from `export_upg_document` on the cloud server), computes the diff, merges into the local graph, and updates `.upg-sync` with new mappings. `strategy`: `cloud_wins` (default), `local_wins`, or `merge` (reports conflicts without resolving).","domain":"sync","groupId":"sync","args":[{"name":"cloud_nodes","type":"array","required":true,"description":"All cloud nodes (from export_upg_document)","enumValues":"$undefined"},{"name":"cloud_edges","type":"array","required":true,"description":"All cloud edges (from export_upg_document)","enumValues":"$undefined"},{"name":"cloud_product_id","type":"string","required":true,"description":"Cloud product ID","enumValues":"$undefined"},{"name":"cloud_endpoint","type":"string","required":false,"description":"Cloud endpoint URL (e.g. https://cloud.unifiedproductgraph.org)","enumValues":"$undefined"},{"name":"strategy","type":"string","required":false,"description":"Conflict resolution: cloud_wins (default), local_wins, or merge (report conflicts without resolving)","enumValues":["cloud_wins","local_wins","merge"]}],"returns":"JSON: `{ nodes_created, nodes_updated, nodes_deleted,\nedges_created, edges_deleted, strategy, conflicts?, message? }`.","returnShape":"{ nodes_created, nodes_updated, nodes_deleted, edges_created, edges_deleted, strategy, conflicts?, message? }","returnNotes":"$undefined","examples":[],"warnings":["Mutates the active product. Always call `get_workspace_info`\nfirst to confirm the right product is loaded; otherwise cloud changes\nland in the wrong file. `merge` strategy returns conflicts without\napplying them; the caller must re-run with `cloud_wins`/`local_wins`\nto commit."],"see":["push_to_cloud","get_sync_state","get_workspace_info","get_changes"],"source":"src/tools/sync.ts:80","atomicity":"non-atomic. Node/edge mutations apply incrementally; a partial\nfailure mid-application leaves the graph in a half-merged state. The\n`.upg-sync` file is updated after the merge sweep so its hashes reflect\nwhatever landed."},{"name":"get_sync_state","slug":"get-sync-state","description":"Read the `.upg-sync` file for the active product. Returns cloud product ID, ID mappings, last sync timestamp. Returns null when the product has never been pushed.","domain":"sync","groupId":"sync","args":[],"returns":"JSON: `{ synced: false, message }` or\n`{ synced: true, cloud_endpoint, product_id, last_synced_at,\nmapped_nodes, mapped_edges, last_snapshot_hash }`.","returnShape":"{ synced: false, message }","returnNotes":["or `{ synced: true, cloud_endpoint, product_id, last_synced_at, mapped_nodes, mapped_edges, last_snapshot_hash }`."],"examples":[{"description":"Live call against the Notion example graph.","input":"{}","output":"{\n \"synced\": false,\n \"message\": \"No .upg-sync file found. This product has never been pushed to the cloud.\"\n}"}],"warnings":[],"see":["push_to_cloud","apply_pull_changeset","get_workspace_info","get_changes"],"source":"src/tools/sync.ts:31","atomicity":"atomic (read-only)"},{"name":"push_to_cloud","slug":"push-to-cloud","description":"Push the current local graph to the cloud in one call. Reads the in-memory graph, POSTs to the cloud import endpoint, and creates or updates the `.upg-sync` file with ID mappings. Auto-discovers `cloud_endpoint` and `api_key` from a `upg-cloud` entry in `.mcp.json`. Recommended push path from Claude Code (zero context cost).","domain":"sync","groupId":"sync","args":[{"name":"cloud_endpoint","type":"string","required":false,"description":"Cloud base URL. Auto-discovered from .mcp.json upg-cloud entry if omitted.","enumValues":"$undefined"},{"name":"api_key","type":"string","required":false,"description":"UPG Cloud API key. Auto-discovered from .mcp.json upg-cloud entry if omitted.","enumValues":"$undefined"},{"name":"strategy","type":"string","required":false,"description":"Import strategy. Default: create_new","enumValues":["create_new","merge","replace"]},{"name":"product_id","type":"string","required":false,"description":"Optional. Push to an existing cloud product instead of creating new.","enumValues":"$undefined"}],"returns":"JSON: `{ success, product_id, nodes_created, edges_created,\nerrors, sync_file_updated }`.","returnShape":"{ success, product_id, nodes_created, edges_created, errors, sync_file_updated }","returnNotes":"$undefined","examples":[],"warnings":["Pushes the **currently-loaded** product. Call\n`get_workspace_info` first to confirm. Auto-discovers credentials\nfrom `.mcp.json`'s `upg-cloud` server entry; falls back to explicit\n`cloud_endpoint` + `api_key` arguments. Default `strategy: 'create_new'`\ncreates a fresh cloud product on every call; pass `product_id` to\ntarget an existing one."],"see":["apply_pull_changeset","get_sync_state","get_workspace_info"],"source":"src/tools/sync.ts:264","atomicity":"non-atomic. Performs an HTTP round-trip and then writes the\nsync file as a separate filesystem mutation. A partial failure (e.g.\ncloud accepted some entities, then network broke) is reflected in the\n`errors` array; the sync file is only updated when the import call\nsucceeds."}]},{"id":"validation","label":"Validation","description":"Validate the graph, detect anti-patterns, run structural health checks, and audit skill integrity.","tools":[{"name":"get_anti_pattern_violations_for","slug":"get-anti-pattern-violations-for","description":"Reverse lookup: given an entity id, return the anti-pattern violations that implicate it. Use after `validate_graph` to drill into one entity's implicated patterns. Matches by node id where the detector can name nodes and by entity type otherwise; each violation carries `matched_by` saying which, so a type match can be read as the approximation it is. Underpins the Inspect approach.","domain":"validation","groupId":"validation","args":[{"name":"entity_id","type":"string","required":true,"description":"Node id to look up.","enumValues":"$undefined"}],"returns":"JSON: `{ entity_id, type, violations: [...] }`, each violation\ncarrying `matched_by: 'node' | 'type'`.","returnShape":"{ entity_id, type, violations: [...] }","returnNotes":[", each violation carrying `matched_by: 'node' | 'type'`."],"examples":[{"description":"Live call against the Notion example graph.","input":"{\n \"entity_id\": \"ec3d5479-4947-4bd9-9e77-b5ee01beb851\"\n}","output":"{\n \"entity_id\": \"ec3d5479-4947-4bd9-9e77-b5ee01beb851\",\n \"type\": \"product\",\n \"violations\": []\n}"}],"warnings":["A `matched_by: 'type'` violation is an approximation: the detector\nis a whole-graph check that cannot name nodes, so every entity of that type\nshares the result. Treat those as \"worth looking at\", and `matched_by:\n'node'` as \"this entity specifically\"."],"see":["validate_graph","list_anti_patterns","get_anti_pattern","inspect"],"source":"src/tools/validation.ts:1651","atomicity":"atomic (read-only)"},{"name":"skill_audit","slug":"skill-audit","description":"Audit one or every UPG skill for source-vs-deployed integrity. Use before recommending a skill to confirm `.claude/skills//SKILL.md` is a symlink to canonical source and the bodies match. When `in_sync: false`, what you read from `packages/upg-mcp-server/skills/` is NOT what the user will experience.","domain":"validation","groupId":"validation","args":[{"name":"name","type":"string","required":false,"description":"Optional skill name (e.g. \"upg-trace\"). If omitted, audits every canonical skill.","enumValues":"$undefined"}],"returns":"`{ skills: SkillAuditRecord[] }`","returnShape":"{ skills: SkillAuditRecord[] }","returnNotes":"$undefined","examples":[{"description":"Live call against the Notion example graph.","input":"{}","output":"{\n \"skills\": []\n}"}],"warnings":[],"see":[],"source":"src/tools/skills.ts:261","atomicity":"atomic (read-only filesystem stat + read)"},{"name":"validate_graph","slug":"validate-graph","description":"Walk the loaded graph and return a per-class, per-node report of schema drift plus anti-pattern violations from `UPG_ANTI_PATTERNS`. Schema-drift classes: non-canonical entity types, non-canonical edge types, top-level fields outside `UPGBaseNode`, invalid status values, self-referential `source_id`/`source_type`, properties matching `UPG_PROPERTY_MIGRATIONS` rules. Anti-patterns: catalog entries that fired against the live graph, sorted high → medium → low. Each entry carries `suggested_migration` (drift) or `remediation` (anti-pattern). Top-level `valid` is true iff drift is empty AND no violations fired. Read-only; pairs with `migrate_type`, `rename_edge_type`, `get_anti_pattern_violations_for`.","domain":"validation","groupId":"validation","args":[{"name":"scope","type":"string","required":false,"description":"Which drift class(es) to include in the response (default \"all\"). Counts in `summary` are always returned for every class.","enumValues":["all","entity_drift","edge_drift","property_drift","top_level_drift","lifecycle_drift","self_referential","configuration_drift"]},{"name":"limit","type":"number","required":false,"description":"Max entries per class (default 100, max 1000)","enumValues":"$undefined"},{"name":"severity","type":"string","required":false,"description":"Filter anti-pattern violations to one severity tier.","enumValues":["high","medium","low"]},{"name":"anti_pattern_ids","type":"array","required":false,"description":"Restrict anti-pattern evaluation to a subset of catalog ids (e.g. [\"features-without-hypotheses\"]).","enumValues":"$undefined"},{"name":"skip_drift","type":"boolean","required":false,"description":"Skip the schema-drift block. Only returns anti-pattern violations.","enumValues":"$undefined"},{"name":"skip_anti_patterns","type":"boolean","required":false,"description":"Skip anti-pattern evaluation. Only returns schema drift.","enumValues":"$undefined"},{"name":"configuration","type":"object","required":false,"description":"Evaluate ANTI-PATTERNS against one configuration instead of across the family. Maps a configuration_axis (by node id, or by title when unambiguous) to a single one of its values. Configuration drift is NOT narrowed: the declarations it checks are facts about the whole family, so they are always validated on the union, by design. Omit this and anti-patterns are still evaluated per projection automatically: findings true everywhere report unqualified, findings true in only some report annotated with where they hold, and findings true only of the superposed union are suppressed and counted. Rejected with an error alongside skip_anti_patterns: true, since it would then have no effect.","enumValues":"$undefined"},{"name":"if_changed_since","type":"string","required":false,"description":"Hash from a previous response. Returns { changed: false } if graph unchanged.","enumValues":"$undefined"},{"name":"include_polymorphic_upgrades","type":"boolean","required":false,"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.","enumValues":"$undefined"},{"name":"pending_nodes","type":"array","required":false,"description":"Batch-4 #18 pre-commit preview: nodes you are ABOUT to create. When supplied (with/without pending_edges), validate_graph evaluates anti-patterns against the CURRENT graph PLUS this delta WITHOUT writing, and returns which violations the delta would newly trigger or resolve. Each item: `{ type, title?, status?, tags?, properties? }`.","enumValues":"$undefined"},{"name":"pending_edges","type":"array","required":false,"description":"Pre-commit preview edges (paired with pending_nodes). Each item: `{ from, to, type? }`, where from/to is an existing node id OR a `$N` index into pending_nodes; type is inferred from endpoints when omitted.","enumValues":"$undefined"}],"returns":"JSON: `{ valid, structurally_valid?, summary, entity_drift?,\nedge_drift?, property_drift?, top_level_drift?, lifecycle_drift?,\nself_referential?, counts_drift?, integrity_drift?, header_seal_note?,\nanti_pattern_violations?, notes?, _hash }`. Per-class\ndrift arrays appear only when the requested `scope` includes that class.\nEach array is capped at `limit` (default 100). `structurally_valid` is\nomitted when `skip_drift: true`.","returnShape":"{ valid, structurally_valid?, summary, entity_drift?, edge_drift?, property_drift?, top_level_drift?, lifecycle_drift?, self_referential?, counts_drift?, integrity_drift?, header_seal_note?, anti_pattern_violations?, notes?, _hash }","returnNotes":["Per-class drift arrays appear only when the requested `scope` includes that class.","Each array is capped at `limit` (default 100).","`structurally_valid` is omitted when `skip_drift: true`."],"examples":[{"description":"Live call against the Notion example graph.","input":"{}","output":"$3c"}],"warnings":["`valid` is true ONLY when both drift is empty AND no anti-pattern\nviolations fired — it conflates structure and product-health. For a pure\nspec-conformance check read `structurally_valid` (or set\n`skip_anti_patterns: true`, which makes `valid` track structure alone).\n`skip_drift: true` gives a catalog-only run and omits `structurally_valid`.","`counts_drift` / `integrity_drift` describe the `.upg` file ON DISK,\nnot the in-memory graph — they re-read the file and compare its header to\nits own body. Unsaved writes therefore never show up as seal drift (the\nlast-written file is still self-consistent), and a seal defect is repaired\nby `upg fmt`, not by any of the `migrate_*` tools."],"see":["migrate_type","migrate_properties","rename_edge_type","get_anti_pattern_violations_for","list_anti_patterns","list_type_migrations","list_edge_migrations","inspect"],"source":"src/tools/validation.ts:338","atomicity":"atomic (read-only)"}]}],"playbooks":[{"id":"playbook:strategy-outcomes","slug":"strategy-outcomes","name":"Strategy & Outcomes","version":"0.2.0","description":"Cascade vision through themes, outcomes, objectives, key results, and the bets you are making to get there.","region":"strategy_outcomes","isCanonical":true,"anchor":"outcome","frameworkId":"$undefined","relatedFrameworkIds":["okr-framework","three-horizons","north-star-metric","metrics-tree","wardley-map"],"steps":[{"order":1,"phase":"Vision & Mission","kind":"entity_sequence","promptHint":"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.","nextSequenceOnGap":"$undefined","entityTypes":["vision","mission"]},{"order":2,"phase":"Themes","kind":"entity_sequence","promptHint":"Choose 2–4 strategic themes that focus the work. Past four, you have lost focus, not gained coverage.","nextSequenceOnGap":"$undefined","entityTypes":["strategic_theme","strategic_pillar"]},{"order":3,"phase":"Outcomes","kind":"entity_sequence","promptHint":"Frame the changes in the world the product is trying to cause: shifts in behavior, perception, or position. Not features shipped.","nextSequenceOnGap":"$undefined","entityTypes":["outcome"]},{"order":4,"phase":"Objectives","kind":"entity_sequence","promptHint":"Translate outcomes into directional bets the team commits to within a horizon. An objective is an ambition with a deadline attached.","nextSequenceOnGap":"$undefined","entityTypes":["objective"]},{"order":5,"phase":"Key Results","kind":"entity_sequence","promptHint":"Give each objective 2–4 measurable key results. Without measurement, the objective is a wish.","nextSequenceOnGap":"$undefined","entityTypes":["key_result","metric"]},{"order":6,"phase":"Initiatives & Capabilities","kind":"entity_sequence","promptHint":"Group features and work streams into initiatives the team will actually execute. Name the capabilities they build.","nextSequenceOnGap":"$undefined","entityTypes":["initiative","capability"]},{"order":7,"phase":"Assumptions & Decisions","kind":"entity_sequence","promptHint":"Capture the bets you are making (assumptions) and the choices you have ratified (decisions). These guard the work against silent drift.","nextSequenceOnGap":"playbook:discovery-research-validation","entityTypes":["assumption","decision"]}]},{"id":"playbook:users-needs","slug":"users-needs","name":"Users & Needs","version":"0.1.0","description":"Bootstrap personas, jobs, needs, and desired outcomes: the user side of every product graph.","region":"users_needs","isCanonical":true,"anchor":"persona","frameworkId":"$undefined","relatedFrameworkIds":["persona-canvas","empathy-map","value-proposition-canvas","kano-model"],"steps":[{"order":1,"phase":"Anchor","kind":"entity_sequence","promptHint":"Capture 1–3 user archetypes you are building for. Keep the set small: one persona per distinct mental model.","nextSequenceOnGap":"$undefined","entityTypes":["persona"]},{"order":2,"phase":"Jobs","kind":"entity_sequence","promptHint":"Name the jobs each persona is trying to get done. What progress are they trying to make?","nextSequenceOnGap":"$undefined","entityTypes":["job"]},{"order":3,"phase":"Job steps","kind":"entity_sequence","promptHint":"Decompose each job into the observable steps a persona walks through (when this is useful).","nextSequenceOnGap":"$undefined","entityTypes":["job_step"]},{"order":4,"phase":"Needs","kind":"entity_sequence","promptHint":"Capture what each persona requires to make progress on each job: the explicit asks and gaps.","nextSequenceOnGap":"$undefined","entityTypes":["need"]},{"order":5,"phase":"Desired outcomes","kind":"entity_sequence","promptHint":"Frame measurable success criteria each persona would accept: the “done” signal for the job.","nextSequenceOnGap":"$undefined","entityTypes":["desired_outcome"]},{"order":6,"phase":"Switching costs","kind":"entity_sequence","promptHint":"List what stops each persona from moving from their current solution: the friction to overcome.","nextSequenceOnGap":"$undefined","entityTypes":["switching_cost"]},{"order":7,"phase":"Participants","kind":"entity_sequence","promptHint":"Optional, post-research: research-resolved instances of personas (real people you spoke with).","nextSequenceOnGap":"$undefined","entityTypes":["participant"]}]},{"id":"playbook:discovery-research-validation","slug":"discovery-research-validation","name":"Discovery, Research & Validation","version":"0.1.0","description":"Evidence-first discovery sequence: plan → recruit → observe → synthesize → insight → opportunity → hypothesis → test.","region":"discovery_research_validation","isCanonical":true,"anchor":"opportunity","frameworkId":"$undefined","relatedFrameworkIds":["double-diamond","opportunity-solution-tree","build-measure-learn","hypothesis-board"],"steps":[{"order":1,"phase":"Plan","kind":"entity_sequence","promptHint":"Define what you need to learn: research questions, study design, interview guides.","nextSequenceOnGap":"$undefined","entityTypes":["research_plan","research_question","interview_guide","research_study"]},{"order":2,"phase":"Recruit","kind":"entity_sequence","promptHint":"Find the right participants. Who can teach you what you need to know?","nextSequenceOnGap":"$undefined","entityTypes":["participant","persona","behavioral_segment"]},{"order":3,"phase":"Observe","kind":"entity_sequence","promptHint":"Gather raw data: observations, quotes, survey responses, field notes.","nextSequenceOnGap":"$undefined","entityTypes":["observation","quote","survey_response"]},{"order":4,"phase":"Synthesize","kind":"entity_sequence","promptHint":"Make sense of the data: cluster, pattern-match, extract themes.","nextSequenceOnGap":"$undefined","entityTypes":["affinity_cluster","feedback_theme"]},{"order":5,"phase":"Insight","kind":"entity_sequence","promptHint":"Crystallize learnings into actionable insights. What did you discover?","nextSequenceOnGap":"$undefined","entityTypes":["insight","evidence","learning"]},{"order":6,"phase":"Opportunity","kind":"entity_sequence","promptHint":"Connect insights to opportunities. What should the product do about this?","nextSequenceOnGap":"$undefined","entityTypes":["opportunity","need","desired_outcome"]},{"order":7,"phase":"Hypothesis","kind":"entity_sequence","promptHint":"Frame testable hypotheses from research. What assumptions need validation?","nextSequenceOnGap":"$undefined","entityTypes":["hypothesis","assumption"]},{"order":8,"phase":"Test","kind":"entity_sequence","promptHint":"Validate with targeted experiment runs. Close the loop between research and action.","nextSequenceOnGap":"$undefined","entityTypes":["experiment_run","experiment_plan","evidence"]}]},{"id":"playbook:market-competitive","slug":"market-competitive","name":"Market & Competitive","version":"0.2.0","description":"Map the competitive landscape: define the market, name the alternatives, read trends, find moves.","region":"market_competitive","isCanonical":true,"anchor":"competitor","frameworkId":"$undefined","relatedFrameworkIds":["porter-five-forces","swot-analysis","value-chain-analysis","wardley-map","bullseye-framework"],"steps":[{"order":1,"phase":"Market","kind":"entity_sequence","promptHint":"Frame the market you compete in. What axes distinguish segments: size, vertical, sophistication, urgency?","nextSequenceOnGap":"$undefined","entityTypes":["market_segment","classification_axis","classification_value"]},{"order":2,"phase":"Competitors","kind":"entity_sequence","promptHint":"List the 3–7 closest alternatives, including DIY, status quo, and adjacent solutions. \"No competition\" is rarely true.","nextSequenceOnGap":"$undefined","entityTypes":["competitor"]},{"order":3,"phase":"Their offerings","kind":"entity_sequence","promptHint":"For the top 3–5 competitors, catalog what they actually ship, not their marketing claims.","nextSequenceOnGap":"$undefined","entityTypes":["competitor_feature"]},{"order":4,"phase":"Trends","kind":"entity_sequence","promptHint":"Capture the shifts in technology, behavior, regulation, or economy that change the playing field underneath everyone.","nextSequenceOnGap":"$undefined","entityTypes":["market_trend"]},{"order":5,"phase":"Analysis","kind":"entity_sequence","promptHint":"Synthesize into structured comparisons: feature parity matrices, win/loss patterns, positioning maps.","nextSequenceOnGap":"$undefined","entityTypes":["competitive_analysis"]},{"order":6,"phase":"Moves","kind":"entity_sequence","promptHint":"Capture rivals' dated moves as competitor_signals (launches, pricing changes, acquisitions) and map each onto the feature it threatens. Then look where competitors are weak and trends are strong: that intersection is where your moves live. Arm the team with battle cards that turn each competitor weakness into a position you can win. (Partnership moves belong in the business & GTM playbook, where `partnership` connects.)","nextSequenceOnGap":"$undefined","entityTypes":["competitor_signal","competitive_battle_card"]}]},{"id":"playbook:experience-design-brand","slug":"experience-design-brand","name":"Experience, Design & Brand","version":"0.1.0","description":"Journey-first design sequence: research → personas → journeys → define → ideate → prototype → test → design system.","region":"experience_design_brand","isCanonical":true,"anchor":"user_journey","frameworkId":"$undefined","relatedFrameworkIds":["double-diamond","atomic-design","story-map"],"steps":[{"order":1,"phase":"Research","kind":"entity_sequence","promptHint":"Understand the problem space: observe real users, gather evidence.","nextSequenceOnGap":"$undefined","entityTypes":["research_study","participant","observation","quote","survey_response"]},{"order":2,"phase":"Personas","kind":"entity_sequence","promptHint":"Synthesize research into archetypes. Who are you designing for?","nextSequenceOnGap":"$undefined","entityTypes":["persona","job","need","desired_outcome"]},{"order":3,"phase":"Journeys","kind":"entity_sequence","promptHint":"Map how users move through the experience. Where is the friction?","nextSequenceOnGap":"$undefined","entityTypes":["user_journey","journey_step","user_flow","touchpoint"]},{"order":4,"phase":"Define","kind":"entity_sequence","promptHint":"Frame the design challenge: How Might We questions, insights, opportunities.","nextSequenceOnGap":"$undefined","entityTypes":["design_question","insight","affinity_cluster","opportunity"]},{"order":5,"phase":"Ideate","kind":"entity_sequence","promptHint":"Generate solutions: concepts, screens, interaction ideas.","nextSequenceOnGap":"$undefined","entityTypes":["design_concept","solution","screen","screen_state"]},{"order":6,"phase":"Prototype","kind":"entity_sequence","promptHint":"Build testable artifacts: wireframes, prototypes, interaction specs.","nextSequenceOnGap":"$undefined","entityTypes":["wireframe","prototype","interaction_spec","design_component"]},{"order":7,"phase":"Test","kind":"entity_sequence","promptHint":"Put prototypes in front of users: observe, learn, iterate.","nextSequenceOnGap":"$undefined","entityTypes":["experiment","learning","evidence","feedback_theme"]},{"order":8,"phase":"Design System","kind":"entity_sequence","promptHint":"Codify patterns: components, tokens, guidelines that scale.","nextSequenceOnGap":"$undefined","entityTypes":["design_system","design_component","design_token","design_pattern","design_guideline"]}]},{"id":"playbook:product-delivery","slug":"product-delivery","name":"Product Delivery","version":"0.2.0","description":"Shape what gets built: features, epics, user stories, releases, milestones, and the dependencies between them.","region":"product_delivery","isCanonical":true,"anchor":"feature","frameworkId":"$undefined","relatedFrameworkIds":["story-map","rice-scoring","moscow","now-next-later","shape-up","kano-model"],"steps":[{"order":1,"phase":"Features","kind":"entity_sequence","promptHint":"Name the units of value the product delivers. Each feature should be a thing a user can describe in plain language.","nextSequenceOnGap":"$undefined","entityTypes":["feature"]},{"order":2,"phase":"Epics","kind":"entity_sequence","promptHint":"Group related features into epics that ship together. Epics are user-visible; tasks are not.","nextSequenceOnGap":"$undefined","entityTypes":["epic"]},{"order":3,"phase":"Stories","kind":"entity_sequence","promptHint":"Write each feature from the user perspective. \"As [persona], I want [job], so that [outcome].\" Define acceptance criteria.","nextSequenceOnGap":"$undefined","entityTypes":["user_story","acceptance_criterion"]},{"order":4,"phase":"Tasks & Dependencies","kind":"entity_sequence","promptHint":"Decompose stories into the smallest unit of work an engineer can pick up. Surface the dependencies between them.","nextSequenceOnGap":"$undefined","entityTypes":["task","dependency"]},{"order":5,"phase":"Releases & Milestones","kind":"entity_sequence","promptHint":"Bundle stories into releases. Milestones mark moments of strategic significance: first paying customer, first 1000 users.","nextSequenceOnGap":"$undefined","entityTypes":["release","milestone"]},{"order":6,"phase":"Roadmap Themes & Changelog","kind":"entity_sequence","promptHint":"Group roadmap work into roadmap themes around the customer problem. Maintain a changelog the team and customers can read together.","nextSequenceOnGap":"$undefined","entityTypes":["roadmap_theme","changelog"]}]},{"id":"playbook:engineering-platform","slug":"engineering-platform","name":"Engineering & Platform","version":"0.1.0","description":"Architecture-first engineering sequence: architecture → services → data → build → test → deploy → monitor → security.","region":"engineering_platform","isCanonical":true,"anchor":"service","frameworkId":"$undefined","relatedFrameworkIds":["c4-model","adr-log","dora-metrics"],"steps":[{"order":1,"phase":"Architecture","kind":"entity_sequence","promptHint":"Define the system shape: bounded contexts, services, key decisions.","nextSequenceOnGap":"$undefined","entityTypes":["bounded_context","decision","service","aggregate"]},{"order":2,"phase":"Services & APIs","kind":"entity_sequence","promptHint":"Map the service layer: endpoints, contracts, integrations.","nextSequenceOnGap":"$undefined","entityTypes":["service","api_endpoint","api_contract","external_api","integration_pattern"]},{"order":3,"phase":"Data","kind":"entity_sequence","promptHint":"Design the data layer: schemas, events, pipelines.","nextSequenceOnGap":"$undefined","entityTypes":["database_schema","domain_event","event_schema","data_model","data_pipeline","queue_topic"]},{"order":4,"phase":"Build","kind":"entity_sequence","promptHint":"Scope the work: features, epics, stories, tasks.","nextSequenceOnGap":"$undefined","entityTypes":["feature","epic","user_story","task","technical_debt_item"]},{"order":5,"phase":"Test","kind":"entity_sequence","promptHint":"Verify the system: test suites, coverage, QA sessions.","nextSequenceOnGap":"$undefined","entityTypes":["test_suite","test_case","qa_session","regression_test","test_coverage_report"]},{"order":6,"phase":"Deploy","kind":"entity_sequence","promptHint":"Ship reliably: pipelines, feature flags, release strategy.","nextSequenceOnGap":"$undefined","entityTypes":["deployment","ci_pipeline","feature_flag","release","release_strategy"]},{"order":7,"phase":"Monitor","kind":"entity_sequence","promptHint":"Keep it running: SLIs, monitors, alerts, incident response.","nextSequenceOnGap":"$undefined","entityTypes":["service_level_indicator","service_level_objective","monitor","alert_rule","incident","runbook","on_call_rotation"]},{"order":8,"phase":"Security","kind":"entity_sequence","promptHint":"Keep it safe: threat models, controls, access policies.","nextSequenceOnGap":"$undefined","entityTypes":["threat_model","threat","vulnerability","security_control","security_policy","access_policy"]}]},{"id":"playbook:business-gtm-growth","slug":"business-gtm-growth","name":"Business, GTM & Growth","version":"0.1.0","description":"Viability-first business sequence: value prop → customer → revenue → costs → unit economics → GTM → competitive advantage.","region":"business_gtm_growth","isCanonical":true,"anchor":"value_proposition","frameworkId":"$undefined","relatedFrameworkIds":["business-model-canvas","pirate-metrics-aarrr","north-star-metric","product-led-growth-framework","marketing-mix-4ps"],"steps":[{"order":1,"phase":"Value Proposition","kind":"entity_sequence","promptHint":"Define the value you create. Why should someone pay for this?","nextSequenceOnGap":"$undefined","entityTypes":["value_proposition","product","need","desired_outcome"]},{"order":2,"phase":"Customer","kind":"entity_sequence","promptHint":"Know your customer: segments, ICPs, what they are willing to pay for.","nextSequenceOnGap":"$undefined","entityTypes":["persona","market_segment","ideal_customer_profile"]},{"order":3,"phase":"Revenue","kind":"entity_sequence","promptHint":"Design the revenue engine: streams, pricing tiers, discounts.","nextSequenceOnGap":"$undefined","entityTypes":["revenue_stream","pricing_tier","pricing_strategy","discount_strategy","trial_config","paywall"]},{"order":4,"phase":"Cost Structure","kind":"entity_sequence","promptHint":"Map the costs. What does it take to build, deliver, and support this?","nextSequenceOnGap":"$undefined","entityTypes":["cost_structure","unit_economics","key_resource","key_activity"]},{"order":5,"phase":"Unit Economics","kind":"entity_sequence","promptHint":"Prove the math works: LTV, CAC, margins, breakeven.","nextSequenceOnGap":"$undefined","entityTypes":["unit_economics","metric"]},{"order":6,"phase":"Go-To-Market","kind":"entity_sequence","promptHint":"Plan the path to customers: positioning, channels, launch strategy.","nextSequenceOnGap":"$undefined","entityTypes":["gtm_strategy","positioning","messaging","distribution_channel","launch"]},{"order":7,"phase":"Competitive Advantage","kind":"entity_sequence","promptHint":"Understand the landscape: competitors, differentiation, moats.","nextSequenceOnGap":"$undefined","entityTypes":["competitor","competitive_analysis","market_trend","partnership"]}]},{"id":"playbook:business-growth-metric-driven","slug":"business-growth-metric-driven","name":"Metric-Driven Growth","version":"0.1.0","description":"Metric-driven growth sequence: north star → funnel → channels → segments → experiments → measure → iterate.","region":"business_gtm_growth","isCanonical":false,"anchor":"$undefined","frameworkId":"$undefined","relatedFrameworkIds":[],"steps":[{"order":1,"phase":"North Star","kind":"entity_sequence","promptHint":"Define the one metric that matters most: the number that captures the value you create.","nextSequenceOnGap":"$undefined","entityTypes":["metric","outcome","objective"]},{"order":2,"phase":"Funnel","kind":"entity_sequence","promptHint":"Map how users flow from awareness to value. Where are the drops?","nextSequenceOnGap":"$undefined","entityTypes":["funnel","funnel_step","user_flow"]},{"order":3,"phase":"Channels","kind":"entity_sequence","promptHint":"Identify where users come from. Which channels are scalable and cost-effective?","nextSequenceOnGap":"$undefined","entityTypes":["acquisition_channel","growth_campaign","attribution_model"]},{"order":4,"phase":"Segments","kind":"entity_sequence","promptHint":"Break users into cohorts. Who retains, who converts, who churns?","nextSequenceOnGap":"$undefined","entityTypes":["cohort","behavioral_segment","persona","ideal_customer_profile"]},{"order":5,"phase":"Experiments","kind":"entity_sequence","promptHint":"Run experiments to move the numbers: A/B tests, pricing tests, growth loops.","nextSequenceOnGap":"$undefined","entityTypes":["experiment","variant","hypothesis","growth_loop"]},{"order":6,"phase":"Measure","kind":"entity_sequence","promptHint":"Track results: dashboards, event schemas, metric definitions.","nextSequenceOnGap":"$undefined","entityTypes":["metric","dashboard","event_schema","data_source"]},{"order":7,"phase":"Iterate","kind":"entity_sequence","promptHint":"Learn and loop: what worked, what didn’t, what to try next.","nextSequenceOnGap":"$undefined","entityTypes":["learning","evidence","insight"]}]},{"id":"playbook:business-marketing-audience-first","slug":"business-marketing-audience-first","name":"Audience-First Marketing","version":"0.1.0","description":"Audience-first marketing sequence: positioning → messaging → audience → channels → content → launch → measure.","region":"business_gtm_growth","isCanonical":false,"anchor":"$undefined","frameworkId":"$undefined","relatedFrameworkIds":[],"steps":[{"order":1,"phase":"Positioning","kind":"entity_sequence","promptHint":"Define where you sit in the customer's mind. Who is this for, and why is it different?","nextSequenceOnGap":"$undefined","entityTypes":["positioning","competitive_analysis","competitor","market_segment"]},{"order":2,"phase":"Messaging","kind":"entity_sequence","promptHint":"Craft the words that resonate: value props, taglines, proof points.","nextSequenceOnGap":"$undefined","entityTypes":["messaging","value_proposition","proof_point","objection","rebuttal"]},{"order":3,"phase":"Audience","kind":"entity_sequence","promptHint":"Know who you are speaking to: personas, ICPs, segments.","nextSequenceOnGap":"$undefined","entityTypes":["persona","ideal_customer_profile","market_segment","behavioral_segment"]},{"order":4,"phase":"Channels","kind":"entity_sequence","promptHint":"Choose where to show up. Which channels reach your audience cost-effectively?","nextSequenceOnGap":"$undefined","entityTypes":["acquisition_channel","distribution_channel","marketing_channel"]},{"order":5,"phase":"Content","kind":"entity_sequence","promptHint":"Create what resonates: content strategy, calendar, individual pieces.","nextSequenceOnGap":"$undefined","entityTypes":["content_strategy","content_piece","content_calendar","content_theme","brand_asset"]},{"order":6,"phase":"Launch","kind":"entity_sequence","promptHint":"Orchestrate the go-to-market: launch plans, campaigns, press.","nextSequenceOnGap":"$undefined","entityTypes":["launch","growth_campaign","demand_gen_program","press_release","event"]},{"order":7,"phase":"Measure","kind":"entity_sequence","promptHint":"Track what works: attribution, conversion, engagement metrics.","nextSequenceOnGap":"$undefined","entityTypes":["metric","dashboard","attribution_model","funnel","nps_campaign"]}]},{"id":"playbook:analytics-data","slug":"analytics-data","name":"Analytics & Data","version":"0.2.0","description":"Bootstrap the measurement plane: sources, schemas, pipelines, metrics, dashboards, and the rules that keep them honest.","region":"analytics_data","isCanonical":true,"anchor":"metric","frameworkId":"$undefined","relatedFrameworkIds":["metrics-tree","north-star-metric","pirate-metrics-aarrr","dora-metrics"],"steps":[{"order":1,"phase":"Data Sources","kind":"entity_sequence","promptHint":"List where the truth lives: the systems that emit events you can measure. Product, billing, support, CRM, external.","nextSequenceOnGap":"$undefined","entityTypes":["data_source"]},{"order":2,"phase":"Event Schemas","kind":"entity_sequence","promptHint":"Define the events you will instrument. Schema first; instrumentation second. Each event needs a name, properties, and emit conditions.","nextSequenceOnGap":"$undefined","entityTypes":["event_schema"]},{"order":3,"phase":"Pipelines & Models","kind":"entity_sequence","promptHint":"Move data from source to warehouse. Define transformations and the resulting models the rest of the org consumes.","nextSequenceOnGap":"$undefined","entityTypes":["data_pipeline","data_model"]},{"order":4,"phase":"Metrics","kind":"entity_sequence","promptHint":"Define the numbers the team will look at. Group into North Star, input metrics, guardrail metrics, and diagnostic metrics.","nextSequenceOnGap":"$undefined","entityTypes":["metric"]},{"order":5,"phase":"Dashboards","kind":"entity_sequence","promptHint":"Compose metrics into dashboards by audience: leadership weekly, team daily, on-call always-on.","nextSequenceOnGap":"$undefined","entityTypes":["dashboard"]},{"order":6,"phase":"Data Quality","kind":"entity_sequence","promptHint":"Set the rules that guard against silent drift: freshness, completeness, accuracy, schema integrity.","nextSequenceOnGap":"$undefined","entityTypes":["data_quality_rule"]}]},{"id":"playbook:operations-quality","slug":"operations-quality","name":"Operations & Quality","version":"0.2.0","description":"The operational backbone: pipelines, monitoring, incident response, security, quality gates, compliance, support. Specialised playbooks cover team rituals.","region":"operations_quality","isCanonical":true,"anchor":"incident","frameworkId":"$undefined","relatedFrameworkIds":["raci-matrix","retrospective","team-health-check","raid-log"],"steps":[{"order":1,"phase":"DevOps Backbone","kind":"entity_sequence","promptHint":"Establish the pipeline. How does code go from commit to production reliably and reversibly?","nextSequenceOnGap":"$undefined","entityTypes":["deployment","ci_pipeline","runbook"]},{"order":2,"phase":"Monitoring & SLOs","kind":"entity_sequence","promptHint":"Decide what you measure for availability, latency, and quality. Set targets. Wire alerts to people, not silence.","nextSequenceOnGap":"$undefined","entityTypes":["service_level_indicator","service_level_objective","monitor","alert_rule"]},{"order":3,"phase":"Incident Response","kind":"entity_sequence","promptHint":"Define how you respond when things break. Every incident gets a postmortem; every postmortem identifies root causes; root causes drive change.","nextSequenceOnGap":"$undefined","entityTypes":["incident","postmortem","root_cause"]},{"order":4,"phase":"Security","kind":"entity_sequence","promptHint":"Model what could go wrong. Catalog known threats. Wire controls and access policies that actually constrain risk.","nextSequenceOnGap":"$undefined","entityTypes":["threat_model","threat","vulnerability","security_control","access_policy"]},{"order":5,"phase":"Quality Gates","kind":"entity_sequence","promptHint":"Establish what does not ship until tests pass. Define the test pyramid: unit, integration, end-to-end. Quality is a delivery concern: gates guard the features they cover and the bugs they catch, which is also where incidents trace back (a shipped defect becomes a production incident).","nextSequenceOnGap":"$undefined","entityTypes":["test_suite","test_case","regression_test","qa_session","feature","bug"]},{"order":6,"phase":"Compliance & Accessibility","kind":"entity_sequence","promptHint":"Map the frameworks you must comply with: SOC 2, GDPR, HIPAA, WCAG. Surface controls and audit cadence.","nextSequenceOnGap":"$undefined","entityTypes":["compliance_framework","a11y_audit","security_policy"]},{"order":7,"phase":"Customer Support","kind":"entity_sequence","promptHint":"Define how customers reach you when things break, and how you build collective memory from each interaction.","nextSequenceOnGap":"$undefined","entityTypes":["support_ticket","knowledge_base_article"]}]},{"id":"playbook:foundations","slug":"foundations","name":"Foundations","version":"0.9.12","description":"Register the specifications your products implement and expose, and the primitives those specs define, as canonical entities instead of scattered per-product features.","region":"foundations","isCanonical":true,"anchor":"specification","frameworkId":"$undefined","relatedFrameworkIds":[],"steps":[{"order":1,"phase":"Specifications","kind":"entity_sequence","promptHint":"Define each governed spec your products implement, expose, or conform to (a query language, protocol, or format) as one canonical specification, not a per-product feature.","nextSequenceOnGap":"$undefined","entityTypes":["specification"]},{"order":2,"phase":"Primitives","kind":"entity_sequence","promptHint":"Define the compositional units those specs define (a block, a reference, a query value) as primitives, each linked to its specification.","nextSequenceOnGap":"$undefined","entityTypes":["primitive"]}]}],"approaches":[{"id":"plan","label":"Plan","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.","questionAnswered":"what should I build next?","signatureHint":"({ region?: UPGRegionId }) → { missing_entities, coverage_score }","frameworkExamples":["story-map","wardley-map","business-model-canvas","product-vision-board","three-horizons","now-next-later","moscow","double-diamond","shape-up","north-star-metric","marketing-mix-4ps","bullseye-framework","product-led-growth-framework","gtm-playbook","okr-framework"],"color":"#60a5fa"},{"id":"inspect","label":"Inspect","description":"The path of arrival to \"what's broken?\". Inspect engages a region or a set of entities by running canonical health checks (anti-pattern audits, drift reports, lint passes) and emitting a structured violation list with severity, kind, target entity, description, and fix hint. Cartographic sense: you are surveying the coastline for hazards before approach; the violations are the rocks marked on the chart. The named techniques inside Inspect are the audit catalogues themselves (`UPG_ANTI_PATTERNS` and the lint passes built on the structural rules).","questionAnswered":"what's broken?","signatureHint":"({ region?: UPGRegionId, entities?: entity_ids[] }) → { violations: [{ severity, kind, entity_id, description, fix_hint }] }","frameworkExamples":["competitive-landscape","porter-five-forces","swot-analysis","adr-log","threat-model-canvas","dora-metrics","raci-matrix","team-health-check","raid-log","five-whys","red-team"],"color":"#f87171"},{"id":"prioritise","label":"Prioritise","description":"The path of arrival to \"what's most important?\". Prioritise engages an explicit candidate set (entity ids the caller passes in) and ranks it by an explicit framework: RICE, Kano, MoSCoW. The framework_id is required because prioritisation without a declared scoring lens is incoherent. Cartographic sense: you have a set of charted destinations and you are computing the order of arrival from a chosen vantage. Different frameworks weight the same candidate set differently; the approach delegates the actual ranking math to the named technique (the framework definition).","questionAnswered":"what's most important?","signatureHint":"({ candidates: entity_ids[], framework_id }) → { ranked: [{ entity_id, score, rationale }], framework_used }","frameworkExamples":["opportunity-sizing","rice-scoring","kano-model","moscow","ice-scoring","wsjf","cost-of-delay","value-vs-effort","eisenhower-matrix"],"color":"#f59e0b"},{"id":"trace","label":"Trace","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.","questionAnswered":"walk a meaningful path through existing graph","signatureHint":"({ anchor: entity_id, path: UPGEntityType[], edges_override?: (string | null)[] }) → { trail: [{ depth, entity_id, edge_type_in }], reached: entity_id[] }","frameworkExamples":["opportunity-solution-tree","value-proposition-canvas","persona-canvas","empathy-map","value-chain-analysis","c4-model","atomic-design","pirate-metrics-aarrr","metrics-tree"],"color":"#a78bfa"},{"id":"reflect","label":"Reflect","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. Retrospective and Build-Measure-Learn are the named reflective techniques in the canonical surface.","questionAnswered":"what should I be questioning?","signatureHint":"({ scope?: UPGRegionId | entity_id | null, mode?: 'assumptions' | 'alternatives' | 'blind-spots' | 'load-bearing' }) → { prompts: [{ kind, question, target_entities? }] }","frameworkExamples":["build-measure-learn","hypothesis-board","retrospective","five-whys","pre-mortem","red-team","devils-advocate","second-order-thinking","four-forces-of-progress","assumption-map"],"color":"#34d399"}],"children":"$L3d"}] 23:["$","$L3e",null,{"entities":[{"id":"a11y_annotation","label":"A11y Annotation","icon":"📌","description":"An accessibility note on a design artefact","interfaceName":"","domainId":"accessibility","color":"#2dd4bf","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"a11y_audit","label":"A11y Audit","icon":"🔍","description":"An audit assessing accessibility compliance","interfaceName":"","domainId":"accessibility","color":"#2dd4bf","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"a11y_guideline","label":"A11y Guideline","icon":"📏","description":"A specific guideline within a standard","interfaceName":"","domainId":"accessibility","color":"#2dd4bf","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"a11y_issue","label":"A11y Issue","icon":"⚠️","description":"An accessibility defect found during audit","interfaceName":"","domainId":"accessibility","color":"#2dd4bf","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"a11y_standard","label":"A11y Standard","icon":"♿","description":"WCAG, Section 508, or similar standard","interfaceName":"","domainId":"accessibility","color":"#2dd4bf","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"ai_cost_tracker","label":"AI Cost Tracker","icon":"💰","description":"A tracker monitoring AI inference costs and usage","interfaceName":"","domainId":"ai","color":"#7c3aed","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"ai_guardrail","label":"AI Guardrail","icon":"🛡️","description":"A safety guardrail constraining AI model behaviour","interfaceName":"","domainId":"ai","color":"#6d28d9","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"ai_model","label":"AI Model","icon":"🤖","description":"An AI or ML model used within the product","interfaceName":"","domainId":"ai","color":"#7c3aed","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"api_contract","label":"API Contract","icon":"📡","description":"An API contract or specification","interfaceName":"","domainId":"engineering","color":"#a5b4fc","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"api_ecosystem","label":"API Ecosystem","icon":"🔌","description":"The API ecosystem enabling third-party integrations","interfaceName":"","domainId":"ecosystem","color":"#4f46e5","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"api_endpoint","label":"API Endpoint","icon":"🔌","description":"A single endpoint exposed by a service","interfaceName":"","domainId":"engineering","color":"#6366f1","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"acceptance_criterion","label":"Acceptance Criterion","icon":"✅","description":"A criterion for accepting a user story","interfaceName":"","domainId":"product_spec","color":"#c4b5fd","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"access_policy","label":"Access Policy","icon":"🔑","description":"A policy defining resource access","interfaceName":"","domainId":"security","color":"#ef4444","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"account","label":"Account","icon":"🏢","description":"A customer or prospect organisation","interfaceName":"","domainId":"sales","color":"#84cc16","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"acquisition_channel","label":"Acquisition Channel","icon":"📣","description":"A customer acquisition channel","interfaceName":"","domainId":"growth","color":"#f87171","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"ad_creative","label":"Ad Creative","icon":"🎨","description":"An advertisement creative asset — copy, image, or video","interfaceName":"","domainId":"marketing","color":"#ec4899","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"affinity_cluster","label":"Affinity Cluster","icon":"🗂️","description":"A thematic grouping of observations","interfaceName":"","domainId":"user_research","color":"#0ea5e9","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"agent_definition","label":"Agent Definition","icon":"🤖","description":"The definition of an AI agent including its role and capabilities","interfaceName":"","domainId":"automation","color":"#0284c7","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"agent_hook","label":"Agent Hook","icon":"🪝","description":"A hook or trigger that connects an agent to external systems","interfaceName":"","domainId":"automation","color":"#0ea5e9","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"agent_session","label":"Agent Session","icon":"💬","description":"A session of interaction with an AI agent","interfaceName":"","domainId":"automation","color":"#0ea5e9","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"agent_skill","label":"Agent Skill","icon":"🎯","description":"A specific skill or capability that an agent can perform","interfaceName":"","domainId":"automation","color":"#0284c7","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"aggregate","label":"Aggregate","icon":"📦","description":"A DDD aggregate root enforcing consistency","interfaceName":"","domainId":"engineering","color":"#4f46e5","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"alert_rule","label":"Alert Rule","icon":"🔔","description":"A rule triggering notifications on conditions","interfaceName":"","domainId":"devops","color":"#06b6d4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"annotation","label":"Annotation","icon":"📌","description":"A note attached to a design artefact","interfaceName":"","domainId":"design_system","color":"#2dd4bf","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"approval_record","label":"Approval Record","icon":"✅","description":"A record of an approval or rejection at a review gate","interfaceName":"","domainId":"automation","color":"#38bdf8","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"assumption","label":"Assumption","icon":"🤔","description":"A belief taken as true that underpins a strategy","interfaceName":"","domainId":"strategy","color":"#f97316","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"attribution_model","label":"Attribution Model","icon":"📊","description":"A model attributing conversions to channels","interfaceName":"","domainId":"growth","color":"#f87171","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"audit_log_policy","label":"Audit Log Policy","icon":"📝","description":"Event tracking and log retention policy","interfaceName":"","domainId":"compliance","color":"#334155","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"competitive_battle_card","label":"Battle Card","icon":"⚔️","description":"A tactical comparison for competitive sales","interfaceName":"","domainId":"go_to_market","color":"#f43f5e","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"beta_program","label":"Beta Program","icon":"🧪","description":"A beta testing program for pre-release features","interfaceName":"","domainId":"feedback","color":"#2dd4bf","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"bounded_context","label":"Bounded Context","icon":"🏗️","description":"A DDD bounded context","interfaceName":"","domainId":"engineering","color":"#4f46e5","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"brand_asset","label":"Brand Asset","icon":"🎨","description":"Logo, colour, typography, or illustration","interfaceName":"","domainId":"brand","color":"#a78bfa","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"brand_colour","label":"Brand Colour","icon":"🎨","description":"A brand colour with role and context","interfaceName":"","domainId":"brand","color":"#38bdf8","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"brand_identity","label":"Brand Identity","icon":"🏷️","description":"Brand personality and positioning","interfaceName":"","domainId":"brand","color":"#0ea5e9","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"brand_typography","label":"Brand Typography","icon":"🔤","description":"A typeface in the brand type scale","interfaceName":"","domainId":"brand","color":"#0284c7","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"brand_voice","label":"Brand Voice","icon":"🗣️","description":"Brand voice and tone guidelines","interfaceName":"","domainId":"brand","color":"#0369a1","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"bug","label":"Bug","icon":"🐛","description":"A defect or unintended behaviour in the product","interfaceName":"","domainId":"product_spec","color":"#8b5cf6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"build_artifact","label":"Build Artifact","icon":"📦","description":"A compiled output from a CI build","interfaceName":"","domainId":"engineering","color":"#94a3b8","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"business_model","label":"Business Model","icon":"💰","description":"The business model canvas","interfaceName":"","domainId":"business_model","color":"#10b981","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"ci_pipeline","label":"CI Pipeline","icon":"🔄","description":"A continuous integration pipeline","interfaceName":"","domainId":"devops","color":"#06b6d4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"marketing_campaign_plan","label":"Campaign Plan","icon":"📋","description":"A planned marketing campaign with timeline, budget, and target audience","interfaceName":"","domainId":"marketing","color":"#db2777","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"capability","label":"Capability","icon":"💪","description":"An ability that enables value delivery","interfaceName":"","domainId":"strategy","color":"#f97316","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"capacity_plan","label":"Capacity Plan","icon":"📊","description":"A plan for allocating team capacity","interfaceName":"","domainId":"team_org","color":"#b45309","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"ceremony","label":"Ceremony","icon":"📅","description":"A recurring team ritual (standup, planning)","interfaceName":"","domainId":"team_org","color":"#fbbf24","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"certification","label":"Certification","icon":"🏅","description":"A certification program validating skill or knowledge attainment","interfaceName":"","domainId":"education","color":"#b45309","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"change_request","label":"Change Request","icon":"🔄","description":"A formal request to change scope or timeline","interfaceName":"","domainId":"program_mgmt","color":"#d946ef","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"changelog","label":"Changelog","icon":"📋","description":"Release changelog entry","interfaceName":"","domainId":"product_spec","color":"#8b5cf6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"churn_reason","label":"Churn Reason","icon":"🚪","description":"Categorised causes of churn","interfaceName":"","domainId":"customer_success","color":"#0f766e","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"code_repository","label":"Code Repository","icon":"📂","description":"A version-controlled source code repository","interfaceName":"","domainId":"engineering","color":"#475569","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"cohort","label":"Cohort","icon":"👥","description":"A group sharing a characteristic","interfaceName":"","domainId":"growth","color":"#e11d48","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"command","label":"Command","icon":"⌨️","description":"A request to change system state","interfaceName":"","domainId":"engineering","color":"#a5b4fc","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"community_initiative","label":"Community Initiative","icon":"🤝","description":"A community-building initiative to engage users or advocates","interfaceName":"","domainId":"marketing","color":"#db2777","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"competitive_analysis","label":"Competitive Analysis","icon":"📊","description":"A structured comparison of competitive offerings","interfaceName":"","domainId":"market_intelligence","color":"#f43f5e","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"competitor","label":"Competitor","icon":"⚔️","description":"A competing product or company","interfaceName":"","domainId":"market_intelligence","color":"#f43f5e","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"competitor_feature","label":"Competitor Feature","icon":"🔍","description":"A feature offered by a competitor","interfaceName":"","domainId":"market_intelligence","color":"#fb7185","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"compliance_requirement","label":"Compliance Req.","icon":"📜","description":"A regulatory obligation to meet","interfaceName":"","domainId":"compliance","color":"#475569","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"contact","label":"Contact","icon":"👤","description":"An individual person within an account","interfaceName":"","domainId":"sales","color":"#84cc16","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"content_calendar","label":"Content Calendar","icon":"📅","description":"A schedule for planning and publishing","interfaceName":"","domainId":"content","color":"#7c3aed","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"content_piece","label":"Content Piece","icon":"📝","description":"Blog post, video, podcast, or newsletter","interfaceName":"","domainId":"content","color":"#7c3aed","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"content_strategy","label":"Content Strategy","icon":"📝","description":"A content marketing strategy","interfaceName":"","domainId":"go_to_market","color":"#f43f5e","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"content_theme","label":"Content Theme","icon":"🏷️","description":"A thematic focus area for content","interfaceName":"","domainId":"content","color":"#a78bfa","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"contract","label":"Contract","icon":"📑","description":"A legal agreement between parties","interfaceName":"","domainId":"legal","color":"#475569","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"contract_clause","label":"Contract Clause","icon":"📄","description":"A clause or provision within a contract","interfaceName":"","domainId":"legal","color":"#64748b","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"cost_structure","label":"Cost Structure","icon":"🧾","description":"A cost category in the business","interfaceName":"","domainId":"business_model","color":"#047857","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"cultural_adaptation","label":"Cultural Adaptation","icon":"🌍","description":"An adaptation of content or UX for a specific cultural context","interfaceName":"","domainId":"localisation","color":"#6d28d9","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"customer_feedback","label":"Customer Feedback","icon":"📣","description":"Voice-of-customer input","interfaceName":"","domainId":"customer_success","color":"#14b8a6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"customer_relationship","label":"Customer Relationship","icon":"🤝","description":"How you engage and maintain relationships with customers","interfaceName":"","domainId":"business_model","color":"#a7f3d0","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"dashboard","label":"Dashboard","icon":"📊","description":"An analytics dashboard","interfaceName":"","domainId":"data_analytics","color":"#67e8f9","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"data_classification","label":"Data Classification","icon":"🏷️","description":"A classification level for data sensitivity","interfaceName":"","domainId":"security","color":"#ef4444","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"data_contract","label":"Data Contract","icon":"📋","description":"Data handling terms and policies","interfaceName":"","domainId":"compliance","color":"#334155","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"data_domain","label":"Data Domain","icon":"🏷️","description":"A logical grouping of related data assets","interfaceName":"","domainId":"data_analytics","color":"#0e7490","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"data_flow","label":"Data Flow","icon":"🌊","description":"Directional data movement between services — for architecture diagrams","interfaceName":"","domainId":"engineering","color":"#818cf8","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"data_lineage","label":"Data Lineage","icon":"🌳","description":"A record of data origin and transformations","interfaceName":"","domainId":"data_analytics","color":"#22d3ee","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"data_model","label":"Data Model","icon":"🗃️","description":"A data model or schema","interfaceName":"","domainId":"data_analytics","color":"#06b6d4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"data_pipeline","label":"Data Pipeline","icon":"🔀","description":"An automated pipeline for data transformation","interfaceName":"","domainId":"data_analytics","color":"#0891b2","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"data_product","label":"Data Product","icon":"📦","description":"A curated, reusable data asset","interfaceName":"","domainId":"data_analytics","color":"#06b6d4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"data_quality_rule","label":"Data Quality Rule","icon":"✅","description":"A data quality validation rule","interfaceName":"","domainId":"data_analytics","color":"#22d3ee","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"data_source","label":"Data Source","icon":"🗄️","description":"A data source or integration","interfaceName":"","domainId":"data_analytics","color":"#06b6d4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"database_schema","label":"Database Schema","icon":"🗄️","description":"The schema definition for a service database","interfaceName":"","domainId":"engineering","color":"#64748b","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"deal","label":"Deal","icon":"🤝","description":"A sales opportunity being pursued","interfaceName":"","domainId":"sales","color":"#84cc16","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"decision","label":"Decision","icon":"⚖️","description":"A cross-layer decision capturing options considered, rationale, and entities influenced","interfaceName":"","domainId":"strategy","color":"#78716c","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"deliverable","label":"Deliverable","icon":"📦","description":"A tangible output from a project","interfaceName":"","domainId":"program_mgmt","color":"#d946ef","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"demand_gen_program","label":"Demand Gen","icon":"📢","description":"A program to generate demand and pipeline","interfaceName":"","domainId":"go_to_market","color":"#e11d48","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"department","label":"Department","icon":"🏢","description":"An organisational department or division","interfaceName":"","domainId":"team_org","color":"#d97706","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"dependency","label":"Dependency","icon":"🔗","description":"A dependency between teams","interfaceName":"","domainId":"team_org","color":"#fbbf24","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"deployment","label":"Deployment","icon":"🚀","description":"A deployment event","interfaceName":"","domainId":"engineering","color":"#475569","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"design_component","label":"Design Component","icon":"🧩","description":"A reusable design component","interfaceName":"","domainId":"design_system","color":"#0d9488","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"design_concept","label":"Design Concept","icon":"🎨","description":"A design concept or idea","interfaceName":"","domainId":"ux_design","color":"#2dd4bf","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"design_guideline","label":"Design Guideline","icon":"📏","description":"A rule or best practice for design consistency","interfaceName":"","domainId":"design_system","color":"#14b8a6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"design_pattern","label":"Design Pattern","icon":"🧩","description":"A reusable solution to a common design problem","interfaceName":"","domainId":"design_system","color":"#0d9488","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"design_sprint","label":"Design Sprint","icon":"🏃","description":"A time-boxed sprint to prototype and validate ideas","interfaceName":"","domainId":"discovery","color":"#22c55e","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"design_system","label":"Design System","icon":"🎨","description":"The parent container for all design components and tokens in the product","interfaceName":"","domainId":"design_system","color":"#0d9488","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"design_token","label":"Design Token","icon":"🎛️","description":"A design token (colour, spacing, etc.)","interfaceName":"","domainId":"design_system","color":"#14b8a6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"desired_outcome","label":"Desired Outcome","icon":"🌟","description":"What the user hopes to achieve","interfaceName":"","domainId":"user","color":"#06b6d4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"developer_portal","label":"Developer Portal","icon":"👨‍💻","description":"A portal providing API documentation and developer resources","interfaceName":"","domainId":"ecosystem","color":"#4338ca","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"discount_strategy","label":"Discount Strategy","icon":"🏷️","description":"A strategy for offering discounts, coupons, or promotional pricing","interfaceName":"","domainId":"pricing","color":"#f97316","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"distribution_channel","label":"Distribution Channel","icon":"🚚","description":"How you deliver your value proposition to customers","interfaceName":"","domainId":"business_model","color":"#a7f3d0","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"documentation_template","label":"Doc Template","icon":"📄","description":"A reusable template for documentation","interfaceName":"","domainId":"content","color":"#6d28d9","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"domain_entity","label":"Domain Entity","icon":"🏗️","description":"A domain object with identity and lifecycle","interfaceName":"","domainId":"engineering","color":"#6366f1","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"domain_event","label":"Domain Event","icon":"⚡","description":"A domain event in the system","interfaceName":"","domainId":"engineering","color":"#818cf8","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"education_program","label":"Education Program","icon":"🎓","description":"A structured education program for customers or partners","interfaceName":"","domainId":"education","color":"#f59e0b","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"email_sequence","label":"Email Sequence","icon":"📧","description":"An automated email sequence for nurturing or onboarding","interfaceName":"","domainId":"marketing","color":"#ec4899","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"epic","label":"Epic","icon":"📚","description":"A large body of work containing user stories","interfaceName":"","domainId":"product_spec","color":"#a78bfa","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"error_budget","label":"Error Budget","icon":"💰","description":"Allowed unreliability before action is required","interfaceName":"","domainId":"devops","color":"#06b6d4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"eval_benchmark","label":"Eval Benchmark","icon":"📏","description":"A benchmark dataset or criteria for evaluating AI model performance","interfaceName":"","domainId":"ai","color":"#6d28d9","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"eval_run","label":"Eval Run","icon":"🏃","description":"A single evaluation run of an AI model against a benchmark","interfaceName":"","domainId":"ai","color":"#a78bfa","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"event","label":"Event","icon":"🎪","description":"A marketing event such as a webinar, conference, or meetup","interfaceName":"","domainId":"marketing","color":"#f472b6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"event_schema","label":"Event Schema","icon":"📋","description":"An event schema for tracking","interfaceName":"","domainId":"data_analytics","color":"#0891b2","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"evidence","label":"Evidence","icon":"🔎","description":"Data supporting or refuting a hypothesis","interfaceName":"","domainId":"validation","color":"#eab308","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"experiment","label":"Experiment","icon":"🧫","description":"A test designed to validate a hypothesis","interfaceName":"","domainId":"validation","color":"#f59e0b","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"external_api","label":"External API","icon":"🔌","description":"A named, configured third-party API connection used by this product","interfaceName":"","domainId":"engineering","color":"#6366f1","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"feasibility_study","label":"Feasibility Study","icon":"📋","description":"An assessment of technical or business viability","interfaceName":"","domainId":"discovery","color":"#22c55e","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"feature","label":"Feature","icon":"⭐","description":"A product feature","interfaceName":"","domainId":"product_spec","color":"#8b5cf6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"feature_flag","label":"Feature Flag","icon":"🚩","description":"A feature flag for controlled rollout","interfaceName":"","domainId":"engineering","color":"#94a3b8","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"feature_request","label":"Feature Request","icon":"💡","description":"A user-submitted request for a new feature or enhancement","interfaceName":"","domainId":"feedback","color":"#2dd4bf","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"feedback_program","label":"Feedback Program","icon":"📣","description":"A structured program for collecting and managing user feedback","interfaceName":"","domainId":"feedback","color":"#14b8a6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"feedback_theme","label":"Feedback Theme","icon":"🏷️","description":"A recurring theme identified across multiple feedback items","interfaceName":"","domainId":"feedback","color":"#0d9488","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"feedback_vote","label":"Feedback Vote","icon":"👍","description":"A vote or upvote on a feature request or feedback item","interfaceName":"","domainId":"feedback","color":"#0d9488","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"forecast","label":"Forecast","icon":"📈","description":"A revenue forecast for a given period","interfaceName":"","domainId":"sales","color":"#84cc16","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"compliance_framework","label":"Framework","icon":"🏛️","description":"A structured compliance controls framework","interfaceName":"","domainId":"compliance","color":"#475569","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"funnel","label":"Funnel","icon":"🔽","description":"A conversion funnel","interfaceName":"","domainId":"growth","color":"#ea580c","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"funnel_step","label":"Funnel Step","icon":"📐","description":"A step in a conversion funnel","interfaceName":"","domainId":"growth","color":"#fdba74","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"gtm_strategy","label":"GTM Strategy","icon":"🚀","description":"A go-to-market strategy","interfaceName":"","domainId":"go_to_market","color":"#f43f5e","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"glossary_term","label":"Glossary Term","icon":"📖","description":"A defined term for shared understanding","interfaceName":"","domainId":"data_analytics","color":"#67e8f9","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"growth_loop","label":"Growth Loop","icon":"🔄","description":"A self-reinforcing cycle driving growth","interfaceName":"","domainId":"growth","color":"#f97316","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"hallucination_report","label":"Hallucination Report","icon":"👻","description":"A report documenting AI hallucination incidents and patterns","interfaceName":"","domainId":"ai","color":"#ef4444","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"customer_health_score","label":"Health Score","icon":"💚","description":"Composite satisfaction and retention score","interfaceName":"","domainId":"customer_success","color":"#0d9488","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"help_video","label":"Help Video","icon":"🎬","description":"A short help video explaining a feature or process","interfaceName":"","domainId":"education","color":"#fbbf24","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"hypothesis","label":"Hypothesis","icon":"🧪","description":"A testable belief about a solution","interfaceName":"","domainId":"validation","color":"#eab308","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"ip_asset","label":"IP Asset","icon":"🔒","description":"Patent, trademark, copyright, or trade secret","interfaceName":"","domainId":"legal","color":"#64748b","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"ideal_customer_profile","label":"Ideal Customer Profile","icon":"🎯","description":"The ideal customer profile (ICP)","interfaceName":"","domainId":"go_to_market","color":"#fb7185","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"incident","label":"Incident","icon":"🚨","description":"An unplanned disruption of service","interfaceName":"","domainId":"devops","color":"#06b6d4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"infrastructure_component","label":"Infrastructure","icon":"🖥️","description":"A cloud or physical infrastructure building block","interfaceName":"","domainId":"devops","color":"#06b6d4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"initiative","label":"Initiative","icon":"🚀","description":"A large coordinated effort to achieve a strategic goal","interfaceName":"","domainId":"strategy","color":"#f97316","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"insight","label":"Insight","icon":"💡","description":"A finding from research that informs product decisions. Consolidates research_insight, finding, and ux_insight (v0.1).","interfaceName":"","domainId":"user_research","color":"#0284c7","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"integration_partner","label":"Integration Partner","icon":"🔗","description":"A partner who builds integrations with the product","interfaceName":"","domainId":"ecosystem","color":"#818cf8","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"integration_pattern","label":"Integration Pattern","icon":"🔗","description":"A pattern for integrating between systems","interfaceName":"","domainId":"engineering","color":"#6366f1","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"interaction_spec","label":"Interaction Spec","icon":"🖱️","description":"A specification of component interaction behaviour","interfaceName":"","domainId":"design_system","color":"#5eead4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"interview_guide","label":"Interview Guide","icon":"🎙️","description":"A structured guide for research interviews","interfaceName":"","domainId":"user_research","color":"#38bdf8","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"invoice","label":"Invoice","icon":"🧾","description":"A billing invoice for products or services","interfaceName":"","domainId":"sales","color":"#84cc16","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"job_step","label":"Job Step","icon":"👣","description":"A discrete step within a Job To Be Done","interfaceName":"","domainId":"user","color":"#a855f7","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"customer_journey_stage","label":"Journey Stage","icon":"🗺️","description":"A stage in the customer lifecycle","interfaceName":"","domainId":"customer_success","color":"#2dd4bf","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"journey_step","label":"Journey Step","icon":"👣","description":"A single step in a user journey","interfaceName":"","domainId":"ux_design","color":"#5eead4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"knowledge_base_article","label":"KB Article","icon":"📖","description":"Help centre or internal KB article","interfaceName":"","domainId":"content","color":"#8b5cf6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"key_activity","label":"Key Activity","icon":"⚡","description":"A critical activity to operate the business","interfaceName":"","domainId":"business_model","color":"#059669","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"key_resource","label":"Key Resource","icon":"🔑","description":"A critical resource to deliver value","interfaceName":"","domainId":"business_model","color":"#10b981","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"key_result","label":"Key Result","icon":"📈","description":"A measurable result tied to an objective","interfaceName":"","domainId":"strategy","color":"#818cf8","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"launch","label":"Launch","icon":"🎉","description":"A product or feature launch","interfaceName":"","domainId":"go_to_market","color":"#be123c","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"lead","label":"Lead","icon":"🎣","description":"A potential customer who has shown interest","interfaceName":"","domainId":"sales","color":"#84cc16","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"learning","label":"Learning","icon":"📝","description":"An insight gained from an experiment","interfaceName":"","domainId":"validation","color":"#14b8a6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"learning_path","label":"Learning Path","icon":"🛤️","description":"An ordered sequence of tutorials and content for progressive learning","interfaceName":"","domainId":"education","color":"#d97706","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"legal_entity","label":"Legal Entity","icon":"🏛️","description":"A corporate entity with jurisdiction","interfaceName":"","domainId":"legal","color":"#475569","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"library_dependency","label":"Library Dependency","icon":"📚","description":"An external library or package dependency","interfaceName":"","domainId":"engineering","color":"#64748b","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"locale","label":"Locale","icon":"🌐","description":"A supported language/region locale such as en-GB or fr-FR","interfaceName":"","domainId":"localisation","color":"#8b5cf6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"locale_config","label":"Locale Config","icon":"⚙️","description":"Configuration settings for a locale including formats and fallbacks","interfaceName":"","domainId":"localisation","color":"#8b5cf6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"market_segment","label":"Market Segment","icon":"🎯","description":"A distinct group within the target market","interfaceName":"","domainId":"market_intelligence","color":"#f43f5e","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"market_trend","label":"Market Trend","icon":"📉","description":"An emerging trend in the market","interfaceName":"","domainId":"market_intelligence","color":"#64748b","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"marketing_channel","label":"Marketing Channel","icon":"📡","description":"A specific marketing channel such as email, social, or paid ads","interfaceName":"","domainId":"marketing","color":"#f472b6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"marketing_strategy","label":"Marketing Strategy","icon":"📣","description":"An overarching marketing strategy defining channels, audiences, and goals","interfaceName":"","domainId":"marketing","color":"#ec4899","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"marketplace_listing","label":"Marketplace Listing","icon":"🏪","description":"A listing in an app marketplace or integration directory","interfaceName":"","domainId":"ecosystem","color":"#6366f1","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"messaging","label":"Messaging","icon":"💬","description":"Marketing messaging and copy","interfaceName":"","domainId":"go_to_market","color":"#fda4af","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"metric","label":"Metric","icon":"📐","description":"A unified metric — measures progress, health, or behaviour across the product","interfaceName":"","domainId":"strategy","color":"#ec4899","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"milestone","label":"Milestone","icon":"🏁","description":"A significant checkpoint or deadline","interfaceName":"","domainId":"program_mgmt","color":"#d946ef","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"mission","label":"Mission","icon":"🧭","description":"The purpose and reason the product exists","interfaceName":"","domainId":"strategy","color":"#f97316","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"model_comparison","label":"Model Comparison","icon":"⚖️","description":"A structured comparison of AI models on cost, quality, and latency","interfaceName":"","domainId":"ai","color":"#8b5cf6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"monitor","label":"Monitor","icon":"👁️","description":"A monitoring check observing system health","interfaceName":"","domainId":"devops","color":"#06b6d4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"nps_campaign","label":"NPS Campaign","icon":"📊","description":"A Net Promoter Score survey campaign targeting users","interfaceName":"","domainId":"feedback","color":"#14b8a6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"need","label":"Need","icon":"💡","description":"A user need, pain, desire, or constraint. Replaces pain_point and user_need (v0.1). Called 'Problem' in Lean Canvas, 'Struggle' in JTBD, 'Pain Point' in Design Thinking.","interfaceName":"","domainId":"user","color":"#ef4444","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"objection","label":"Objection","icon":"🚧","description":"A counter-argument a prospect, user, or stakeholder raises against a positioning or value proposition claim","interfaceName":"","domainId":"go_to_market","color":"#f97316","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"objective","label":"Objective","icon":"🏁","description":"A strategic goal (OKR)","interfaceName":"","domainId":"strategy","color":"#6366f1","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"observation","label":"Observation","icon":"👁️","description":"A behavioural observation from research","interfaceName":"","domainId":"user_research","color":"#38bdf8","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"on_call_rotation","label":"On-Call Rotation","icon":"📟","description":"A rotation schedule for incident response","interfaceName":"","domainId":"devops","color":"#06b6d4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"opportunity","label":"Opportunity","icon":"💡","description":"A validated gap worth solving","interfaceName":"","domainId":"discovery","color":"#22c55e","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"organization","label":"Organization","icon":"🏢","description":"A top-level container for portfolios and billing","interfaceName":"","domainId":"portfolio","color":"#6366f1","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"outcome","label":"Outcome","icon":"🎯","description":"A desired business or user outcome","interfaceName":"","domainId":"strategy","color":"#f97316","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"participant","label":"Participant","icon":"🙋","description":"A research study participant","interfaceName":"","domainId":"user_research","color":"#7dd3fc","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"partner_program","label":"Partner Program","icon":"🤝","description":"A structured program for managing partner relationships","interfaceName":"","domainId":"ecosystem","color":"#6366f1","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"partner_revenue_share","label":"Partner Revenue Share","icon":"💰","description":"A revenue sharing arrangement with a partner","interfaceName":"","domainId":"ecosystem","color":"#4f46e5","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"partner_tier","label":"Partner Tier","icon":"🏆","description":"A tier level within a partner program with specific benefits","interfaceName":"","domainId":"ecosystem","color":"#818cf8","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"partnership","label":"Partnership","icon":"🤝","description":"A strategic partnership","interfaceName":"","domainId":"business_model","color":"#34d399","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"paywall","label":"Paywall","icon":"🚧","description":"A paywall controlling access to premium features or content","interfaceName":"","domainId":"pricing","color":"#fb923c","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"penetration_test","label":"Penetration Test","icon":"🔓","description":"A simulated attack to find weaknesses","interfaceName":"","domainId":"security","color":"#ef4444","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"persona","label":"Persona","icon":"👤","description":"An archetype representing a user segment","interfaceName":"","domainId":"user","color":"#a855f7","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"pipeline_stage","label":"Pipeline Stage","icon":"📊","description":"A stage within the sales pipeline","interfaceName":"","domainId":"sales","color":"#84cc16","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"playbook","label":"Playbook","icon":"📋","description":"Repeatable process for CS scenarios","interfaceName":"","domainId":"customer_success","color":"#14b8a6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"portfolio","label":"Portfolio","icon":"📂","description":"A collection of related products managed as a portfolio","interfaceName":"","domainId":"portfolio","color":"#8b5cf6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"positioning","label":"Positioning","icon":"📍","description":"Product positioning in the market","interfaceName":"","domainId":"go_to_market","color":"#e11d48","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"postmortem","label":"Postmortem","icon":"📋","description":"A post-incident analysis documenting lessons","interfaceName":"","domainId":"devops","color":"#06b6d4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"press_release","label":"Press Release","icon":"📰","description":"A formal press release for media distribution","interfaceName":"","domainId":"marketing","color":"#be185d","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"pricing_strategy","label":"Pricing Strategy","icon":"💲","description":"An overarching pricing strategy defining the approach to monetisation","interfaceName":"","domainId":"pricing","color":"#f97316","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"pricing_tier","label":"Pricing Tier","icon":"🏷️","description":"A pricing plan or tier","interfaceName":"","domainId":"pricing","color":"#6ee7b7","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"privacy_policy","label":"Privacy Policy","icon":"🔒","description":"A policy governing data privacy","interfaceName":"","domainId":"legal","color":"#334155","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"product","label":"Product","icon":"📦","description":"A product or service being built in the graph","interfaceName":"","domainId":"strategy","color":"#6b7280","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"product_area","label":"Product Area","icon":"📐","description":"A lightweight grouping of concerns within a product","interfaceName":"","domainId":"portfolio","color":"#a78bfa","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"program","label":"Program","icon":"📋","description":"Related projects delivering strategic outcomes","interfaceName":"","domainId":"program_mgmt","color":"#d946ef","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"project","label":"Project","icon":"📂","description":"A time-bound effort to deliver specific outputs","interfaceName":"","domainId":"program_mgmt","color":"#d946ef","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"prompt_template","label":"Prompt Template","icon":"🤖","description":"AI prompt template with variables","interfaceName":"","domainId":"ai","color":"#7c3aed","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"prompt_version","label":"Prompt Version","icon":"📝","description":"A versioned prompt template for an AI model","interfaceName":"","domainId":"ai","color":"#8b5cf6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"proof_point","label":"Proof Point","icon":"✅","description":"Evidence supporting a rebuttal, positioning statement, or value proposition","interfaceName":"","domainId":"go_to_market","color":"#22c55e","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"prototype","label":"Prototype","icon":"🖼️","description":"A testable prototype","interfaceName":"","domainId":"ux_design","color":"#5eead4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"qa_session","label":"QA Session","icon":"🔍","description":"A manual QA testing session with findings and notes","interfaceName":"","domainId":"testing","color":"#059669","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"queue_topic","label":"Queue Topic","icon":"📨","description":"A message queue topic for async communication","interfaceName":"","domainId":"engineering","color":"#818cf8","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"quote","label":"Quote","icon":"💬","description":"A verbatim quote from a participant","interfaceName":"","domainId":"user_research","color":"#7dd3fc","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"quote_document","label":"Quote","icon":"💲","description":"A formal price quote sent to a prospect","interfaceName":"","domainId":"sales","color":"#84cc16","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"read_model","label":"Read Model","icon":"👁️","description":"A query-optimised projection of domain data","interfaceName":"","domainId":"engineering","color":"#4338ca","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"rebuttal","label":"Rebuttal","icon":"💬","description":"A structured response to an objection","interfaceName":"","domainId":"go_to_market","color":"#14b8a6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"regional_pricing","label":"Regional Pricing","icon":"💱","description":"Pricing configuration adjusted for a specific region or market","interfaceName":"","domainId":"localisation","color":"#a78bfa","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"regression_test","label":"Regression Test","icon":"🔁","description":"A regression test ensuring existing functionality is preserved","interfaceName":"","domainId":"testing","color":"#10b981","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"release","label":"Release","icon":"🚢","description":"A product release or version","interfaceName":"","domainId":"product_spec","color":"#6d28d9","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"release_strategy","label":"Release Strategy","icon":"🚀","description":"A strategy for releasing to production","interfaceName":"","domainId":"devops","color":"#06b6d4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"report","label":"Report","icon":"📄","description":"A structured analytical report","interfaceName":"","domainId":"data_analytics","color":"#06b6d4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"research_plan","label":"Research Plan","icon":"🔬","description":"A copilot-generated plan for gathering evidence to validate a draft entity","interfaceName":"","domainId":"validation","color":"#d97706","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"research_question","label":"Research Question","icon":"❓","description":"A question a research study aims to answer","interfaceName":"","domainId":"user_research","color":"#38bdf8","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"research_study","label":"Research Study","icon":"🔬","description":"A UX research study or project","interfaceName":"","domainId":"user_research","color":"#38bdf8","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"resource_allocation","label":"Resource Allocation","icon":"👥","description":"An allocation of people or budget","interfaceName":"","domainId":"program_mgmt","color":"#d946ef","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"retrospective","label":"Retrospective","icon":"🔄","description":"A team retrospective","interfaceName":"","domainId":"team_org","color":"#f59e0b","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"revenue_stream","label":"Revenue Stream","icon":"💵","description":"A source of revenue","interfaceName":"","domainId":"business_model","color":"#059669","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"review_gate","label":"Review Gate","icon":"🚪","description":"A checkpoint requiring human review or approval before proceeding","interfaceName":"","domainId":"automation","color":"#0369a1","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"risk","label":"Risk","icon":"⚠️","description":"A product, technical, or business risk","interfaceName":"","domainId":"compliance","color":"#64748b","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"risk_register","label":"Risk Register","icon":"📒","description":"A register tracking identified risks","interfaceName":"","domainId":"program_mgmt","color":"#d946ef","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"roadmap","label":"Roadmap","icon":"🗺️","description":"A visual plan of features and initiatives over time","interfaceName":"","domainId":"product_spec","color":"#8b5cf6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"roadmap_item","label":"Roadmap Item","icon":"📍","description":"A single item on the product roadmap","interfaceName":"","domainId":"product_spec","color":"#8b5cf6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"role","label":"Role","icon":"🪪","description":"A role within a team","interfaceName":"","domainId":"team_org","color":"#f59e0b","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"runbook","label":"Runbook","icon":"📖","description":"A procedure for operational tasks or incidents","interfaceName":"","domainId":"devops","color":"#06b6d4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"seo_keyword","label":"SEO Keyword","icon":"🔑","description":"A target SEO keyword with search volume and ranking data","interfaceName":"","domainId":"marketing","color":"#db2777","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"sales_motion","label":"Sales Motion","icon":"🤝","description":"A sales process or motion","interfaceName":"","domainId":"go_to_market","color":"#fb7185","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"pipeline_sales","label":"Sales Pipeline","icon":"🔽","description":"A structured sales pipeline with stages","interfaceName":"","domainId":"sales","color":"#84cc16","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"screen","label":"Screen","icon":"🖥️","description":"A live UI route or state — the actual running screen at a URL","interfaceName":"","domainId":"ux_design","color":"#14b8a6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"screen_state","label":"Screen State","icon":"📐","description":"A variant state of a screen: empty, loading, error, populated, or skeleton","interfaceName":"","domainId":"ux_design","color":"#5eead4","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"security_audit","label":"Security Audit","icon":"🔍","description":"An audit assessing security posture","interfaceName":"","domainId":"compliance","color":"#64748b","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"security_control","label":"Security Control","icon":"🔐","description":"A safeguard to mitigate threats","interfaceName":"","domainId":"security","color":"#ef4444","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"security_policy","label":"Security Policy","icon":"📜","description":"A policy governing security practices","interfaceName":"","domainId":"security","color":"#ef4444","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"security_review","label":"Security Review","icon":"🔍","description":"A review of security posture","interfaceName":"","domainId":"security","color":"#ef4444","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"service","label":"Service","icon":"⚙️","description":"A microservice or application service","interfaceName":"","domainId":"engineering","color":"#6366f1","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"service_blueprint","label":"Service Blueprint","icon":"📐","description":"A diagram mapping service delivery","interfaceName":"","domainId":"customer_success","color":"#0f766e","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"skill","label":"Skill","icon":"🎓","description":"A skill or competency within a team","interfaceName":"","domainId":"team_org","color":"#f59e0b","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"social_post","label":"Social Post","icon":"💬","description":"A social media post or thread planned or published","interfaceName":"","domainId":"marketing","color":"#f472b6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"solution","label":"Solution","icon":"🔧","description":"A proposed approach to address an opportunity","interfaceName":"","domainId":"discovery","color":"#3b82f6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"stakeholder","label":"Stakeholder","icon":"🏢","description":"A stakeholder with interest in the product","interfaceName":"","domainId":"team_org","color":"#fbbf24","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"status_report","label":"Status Report","icon":"📊","description":"A periodic report on progress","interfaceName":"","domainId":"program_mgmt","color":"#d946ef","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"strategic_pillar","label":"Strategic Pillar","icon":"🏛️","description":"A foundational principle that guides decisions","interfaceName":"","domainId":"strategy","color":"#f97316","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"strategic_theme","label":"Strategic Theme","icon":"🎯","description":"A high-level strategic focus area for a planning period","interfaceName":"","domainId":"strategy","color":"#f97316","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"subscription","label":"Subscription","icon":"🔄","description":"A recurring revenue subscription","interfaceName":"","domainId":"sales","color":"#84cc16","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"success_milestone","label":"Success Milestone","icon":"🏆","description":"A key milestone indicating customer success","interfaceName":"","domainId":"customer_success","color":"#0d9488","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"support_ticket","label":"Support Ticket","icon":"🎫","description":"Customer support request or issue","interfaceName":"","domainId":"customer_success","color":"#0d9488","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"survey_response","label":"Survey Response","icon":"📩","description":"An individual response to a research survey","interfaceName":"","domainId":"user_research","color":"#38bdf8","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"switching_cost","label":"Switching Cost","icon":"🔄","description":"A barrier preventing users from switching alternatives","interfaceName":"","domainId":"user","color":"#a855f7","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"task","label":"Task","icon":"☑️","description":"A discrete unit of work within a user story","interfaceName":"","domainId":"product_spec","color":"#8b5cf6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"team","label":"Team","icon":"👥","description":"A team within the organisation","interfaceName":"","domainId":"team_org","color":"#d97706","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"team_okr","label":"Team OKR","icon":"🎯","description":"An OKR owned by a team","interfaceName":"","domainId":"team_org","color":"#d97706","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"technical_debt_item","label":"Tech Debt Item","icon":"🧹","description":"A piece of technical debt to address","interfaceName":"","domainId":"engineering","color":"#64748b","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"territory","label":"Territory","icon":"🗺️","description":"A geographic or account-based sales territory","interfaceName":"","domainId":"go_to_market","color":"#fb7185","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"test_case","label":"Test Case","icon":"✅","description":"A single test case with steps, expected results, and status","interfaceName":"","domainId":"testing","color":"#34d399","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"test_coverage_report","label":"Test Coverage Report","icon":"📊","description":"A report measuring test coverage across the product","interfaceName":"","domainId":"testing","color":"#047857","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"test_environment","label":"Test Environment","icon":"🖥️","description":"A testing environment configuration for QA activities","interfaceName":"","domainId":"testing","color":"#34d399","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"test_plan","label":"Test Plan","icon":"📝","description":"A structured plan for testing a hypothesis","interfaceName":"","domainId":"validation","color":"#eab308","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"test_suite","label":"Test Suite","icon":"🧪","description":"A collection of test cases grouped by feature or component","interfaceName":"","domainId":"testing","color":"#10b981","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"theme","label":"Theme","icon":"🏷️","description":"A high-level grouping of related features","interfaceName":"","domainId":"product_spec","color":"#8b5cf6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"threat","label":"Threat","icon":"⚠️","description":"A specific threat actor or attack vector","interfaceName":"","domainId":"security","color":"#ef4444","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"threat_model","label":"Threat Model","icon":"🛡️","description":"A structured analysis of potential threats","interfaceName":"","domainId":"security","color":"#ef4444","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"touchpoint","label":"Touchpoint","icon":"👆","description":"A point of interaction with the product","interfaceName":"","domainId":"customer_success","color":"#14b8a6","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"translation_bundle","label":"Translation Bundle","icon":"📦","description":"A bundle of translation keys grouped for a feature or screen","interfaceName":"","domainId":"localisation","color":"#7c3aed","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"translation_key","label":"Translation Key","icon":"🔤","description":"A single translatable string key with its translations","interfaceName":"","domainId":"localisation","color":"#a78bfa","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"trial_config","label":"Trial Config","icon":"🆓","description":"Configuration for a free trial including duration and feature access","interfaceName":"","domainId":"pricing","color":"#c2410c","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"tutorial","label":"Tutorial","icon":"📖","description":"A step-by-step tutorial teaching a specific task or concept","interfaceName":"","domainId":"education","color":"#fbbf24","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"unit_economics","label":"Unit Economics","icon":"📊","description":"Per-unit economics (LTV, CAC, etc.)","interfaceName":"","domainId":"business_model","color":"#10b981","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"user_advisory_board","label":"User Advisory Board","icon":"👥","description":"A panel of users providing ongoing product feedback","interfaceName":"","domainId":"feedback","color":"#0f766e","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"user_flow","label":"User Flow","icon":"🔀","description":"A task-level navigation path showing how a user completes a specific task","interfaceName":"","domainId":"ux_design","color":"#2dd4bf","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"user_journey","label":"User Journey","icon":"🗺️","description":"An end-to-end user journey map","interfaceName":"","domainId":"ux_design","color":"#2dd4bf","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"value_object","label":"Value Object","icon":"💎","description":"An immutable object defined by its attributes","interfaceName":"","domainId":"engineering","color":"#818cf8","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"value_proposition","label":"Value Proposition","icon":"💎","description":"The value delivered to customers","interfaceName":"","domainId":"business_model","color":"#34d399","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"value_stream","label":"Value Stream","icon":"🌊","description":"An end-to-end flow delivering value to the customer","interfaceName":"","domainId":"strategy","color":"#f97316","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"variant","label":"Variant","icon":"🅰️","description":"A variation in an experiment or test","interfaceName":"","domainId":"growth","color":"#ea580c","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"vision","label":"Vision","icon":"🔭","description":"A long-term aspirational statement of the future state","interfaceName":"","domainId":"strategy","color":"#f97316","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"vulnerability","label":"Vulnerability","icon":"🕳️","description":"A weakness that could be exploited","interfaceName":"","domainId":"security","color":"#ef4444","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"walkthrough","label":"Walkthrough","icon":"🚶","description":"An interactive walkthrough guiding users through a feature or flow","interfaceName":"","domainId":"education","color":"#d97706","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"webinar","label":"Webinar","icon":"🎥","description":"A live or recorded webinar session for education or marketing","interfaceName":"","domainId":"education","color":"#f59e0b","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"wireframe","label":"Wireframe","icon":"📐","description":"A low-fidelity visual layout of a screen","interfaceName":"","domainId":"ux_design","color":"#2dd4bf","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"workflow_artifact","label":"Workflow Artifact","icon":"📦","description":"An output artifact produced by a workflow run","interfaceName":"","domainId":"automation","color":"#38bdf8","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"workflow_run","label":"Workflow Run","icon":"▶️","description":"A single execution instance of a workflow template","interfaceName":"","domainId":"automation","color":"#38bdf8","properties":[],"relationships":[],"deprecated":false,"replacement":null},{"id":"workflow_template","label":"Workflow Template","icon":"🔄","description":"A reusable template defining an automated or agentic workflow","interfaceName":"","domainId":"automation","color":"#0ea5e9","properties":[],"relationships":[],"deprecated":false,"replacement":null}],"toolGroups":"$10:props:toolGroups","playbooks":"$10:props:playbooks","approaches":"$10:props:approaches"}]