@unified-product-graph/core 0.20.2 → 0.22.0

package/dist/index.cjs

@@ -2557,8 +2557,31 @@ var UPG_EDGE_CATALOG = {
   product_cannibalises_product: { forward_verb: "cannibalises", reverse_verb: "cannibalised_by", classification: "causal", source_type: "product", target_type: "product" },
   product_succeeds_product: { forward_verb: "succeeds", reverse_verb: "succeeded_by", classification: "causal", source_type: "product", target_type: "product" },
   // 8.3 Workspace Edges
+  // Altitude anchors (WS3, 2026-07-05): a workspace scopes to exactly one of
+  // three legal altitudes — organization / product_area ("plane") / product —
+  // each a typed hierarchy edge, not a polymorphic `_node` wildcard. Per the
+  // enum-vs-polymorphism ADR (2026-06-16), this family fails universality
+  // (the anchor set is a closed altitude ladder, not "any entity") and is
+  // structural (it must resolve through `resolveContainmentEdge`/`get_tree`),
+  // so it stays enumerated — the same shape `feature`'s five typed parent
+  // edges already use. Same verb pair across all three altitudes. Neither new
+  // edge is cross_product_eligible: an org/plane-altitude workspace lives in
+  // the same portfolio-level `.upg` as its anchor, same as sibling containment
+  // edges (organization_organised_into_product_area, portfolio_contains_product).
+  organization_thinks_in_workspace: { forward_verb: "thinks_in", reverse_verb: "thinks_for", classification: "hierarchy", source_type: "organization", target_type: "workspace" },
+  product_area_thinks_in_workspace: { forward_verb: "thinks_in", reverse_verb: "thinks_for", classification: "hierarchy", source_type: "product_area", target_type: "workspace" },
   product_thinks_in_workspace: { forward_verb: "thinks_in", reverse_verb: "thinks_for", classification: "hierarchy", source_type: "product", target_type: "workspace" },
-  workspace_produced_decision: { forward_verb: "produced", reverse_verb: "produced_in", classification: "causal", source_type: "workspace", target_type: "decision" },
+  // Commit provenance (WS3, 2026-07-05): widened from the single-target
+  // `workspace_produced_decision` to the `node` wildcard — a workspace's
+  // commit loop can legitimately produce any entity type arranged in it
+  // (decision, feature, persona, ...), so per the same ADR test this family
+  // is universal + non-structural (provenance metadata, not the produced
+  // node's real containment edge) and collapses polymorphic, mirroring
+  // `decision_produces_node`. See UPG_EDGE_MIGRATIONS for the rename rule.
+  // Edge-provenance (which workspace produced a committed *edge*, not just a
+  // node) has no schema mechanism yet — deliberately deferred, see the WS3
+  // proposal doc, ripple map "surprises" #3.
+  workspace_produced_node: { forward_verb: "produced", reverse_verb: "produced_in", classification: "causal", source_type: "workspace", target_type: "node" },
   // ── P14 edges (replacing foreign-key properties) ─────────────────────────
   feature_addresses_job: { forward_verb: "addresses", reverse_verb: "addressed_by", classification: "cross-domain", source_type: "feature", target_type: "job" },
   feature_drives_key_result: { forward_verb: "drives", reverse_verb: "driven_by", classification: "cross-domain", source_type: "feature", target_type: "key_result" },
@@ -3501,7 +3524,10 @@ var UPG_POLYMORPHIC_EDGE_KEYS = [
   // intended semantic domain; the endpoints are the `node` wildcard.
   "work_item_blocks_work_item",
   "work_item_relates_to_work_item",
-  "work_item_duplicates_work_item"
+  "work_item_duplicates_work_item",
+  // Workspace provenance (WS3, 2026-07-05): a workspace can produce any
+  // entity type arranged in it. Widened from workspace_produced_decision.
+  "workspace_produced_node"
 ];
 var _POLY_KEY_SET = new Set(UPG_POLYMORPHIC_EDGE_KEYS);
 function isPolymorphicEdge(key) {
@@ -4263,13 +4289,19 @@ var UPG_VALID_CHILDREN = {
   // ── Portfolio layer hierarchy ────────────────────────────────────────────────
   // organization → product_area is the org-axis anchor (who owns what);
   // organization → portfolio is the strategic-axis anchor (where you invest).
-  organization: ["portfolio", "product_area"],
+  // organization → workspace (WS3, 2026-07-05): org-altitude workspace anchor
+  // (organization_thinks_in_workspace) — a workspace scoped to org altitude
+  // lives in the same portfolio-level graph as its organization node.
+  organization: ["portfolio", "product_area", "workspace"],
   // portfolios can nest (multi-level investment structures).
   portfolio: ["product", "portfolio"],
   // product_area is the organisational container for products and can
   // nest (parent → sub-area). product_area also groups features; the
-  // "Studio area owns 6 features" mental model.
-  product_area: ["product", "product_area", "feature"]
+  // "Studio area owns 6 features" mental model. product_area → workspace
+  // (WS3, 2026-07-05): plane-altitude workspace anchor
+  // (product_area_thinks_in_workspace) — "plane" is Entopo's app-level name
+  // for product_area, not a distinct spec entity.
+  product_area: ["product", "product_area", "feature", "workspace"]
 };
 function getValidChildren(entityType) {
   return UPG_VALID_CHILDREN[entityType] ?? [];
@@ -4352,37 +4384,6 @@ var PRODUCT_LIFECYCLE = {
     }
   ]
 };
-var RESEARCH_STUDY_LIFECYCLE = {
-  entity_type: "research_study",
-  initial_phase: "planned",
-  terminal_phases: ["complete"],
-  phases: [
-    {
-      id: "planned",
-      label: "Planned",
-      description: "The study has been scoped and scheduled. Research questions are defined, method is chosen, participants have not yet been recruited or sessions started.",
-      transitions_to: ["in_progress"]
-    },
-    {
-      id: "in_progress",
-      label: "In Progress",
-      description: "Research sessions are actively running. Participants are being interviewed, observed, or surveyed. Data is being collected.",
-      transitions_to: ["analysing"]
-    },
-    {
-      id: "analysing",
-      label: "Analysing",
-      description: "Data collection is complete. The team is reviewing recordings, notes, and responses to identify patterns and insights.",
-      transitions_to: ["complete"]
-    },
-    {
-      id: "complete",
-      label: "Complete",
-      description: "Analysis is done. Insights have been captured and shared. The study is a historical record.",
-      transitions_to: []
-    }
-  ]
-};
 var NEED_LIFECYCLE = {
   entity_type: "need",
   initial_phase: "raw",
@@ -4464,74 +4465,6 @@ var SOLUTION_LIFECYCLE = {
     }
   ]
 };
-var HYPOTHESIS_CLAIM_LIFECYCLE = {
-  entity_type: "hypothesis",
-  initial_phase: "drafted",
-  terminal_phases: ["validated", "invalidated", "archived"],
-  phases: [
-    {
-      id: "drafted",
-      label: "Drafted",
-      description: "The claim is being written. We_believe / will_result_in / we_know_when may not yet be complete. Not yet committed for testing.",
-      transitions_to: ["active", "archived"]
-    },
-    {
-      id: "active",
-      label: "Active",
-      description: "The claim is committed and being tested. Experiments may be running; evidence may be accruing via supports/refutes edges. current_confidence updates as evidence weight shifts.",
-      transitions_to: ["validated", "invalidated", "archived"]
-    },
-    {
-      id: "validated",
-      label: "Validated",
-      description: "Evidence sufficiently supports the claim. The belief held. Reopens to `active` if new evidence materially changes the picture.",
-      transitions_to: ["active"]
-    },
-    {
-      id: "invalidated",
-      label: "Invalidated",
-      description: "Evidence sufficiently refutes the claim. The belief did not hold. Reopens to `active` if new evidence materially changes the picture.",
-      transitions_to: ["active"]
-    },
-    {
-      id: "archived",
-      label: "Archived",
-      description: "Set aside without resolution: superseded by a new claim, deprioritised, or no longer relevant. Reopens to `active` if revisited.",
-      transitions_to: ["active"]
-    }
-  ]
-};
-var EXPERIMENT_LIFECYCLE = {
-  entity_type: "experiment",
-  initial_phase: "planned",
-  terminal_phases: ["done"],
-  phases: [
-    {
-      id: "planned",
-      label: "Planned",
-      description: "The experiment has been designed. Method, sample size, success criteria, and timeline are defined. It has not started yet.",
-      transitions_to: ["running"]
-    },
-    {
-      id: "running",
-      label: "Running",
-      description: "The experiment is live and collecting data. Traffic is being split, interviews are being conducted, or surveys are being distributed.",
-      transitions_to: ["analysing"]
-    },
-    {
-      id: "analysing",
-      label: "Analysing",
-      description: "Data collection is complete. The team is reviewing results, running statistical analysis, and deriving conclusions.",
-      transitions_to: ["done"]
-    },
-    {
-      id: "done",
-      label: "Done",
-      description: "The experiment is concluded. Learnings have been captured. The experiment is a historical record.",
-      transitions_to: []
-    }
-  ]
-};
 var EXPERIMENT_PLAN_LIFECYCLE = {
   entity_type: "experiment_plan",
   initial_phase: "drafted",
@@ -4563,31 +4496,6 @@ var EXPERIMENT_PLAN_LIFECYCLE = {
     }
   ]
 };
-var EXPERIMENT_RUN_LIFECYCLE = {
-  entity_type: "experiment_run",
-  initial_phase: "in_progress",
-  terminal_phases: ["complete", "aborted"],
-  phases: [
-    {
-      id: "in_progress",
-      label: "In Progress",
-      description: "The run is actively collecting data. Traffic is being split, interviews are happening, or surveys are out. Outcome and disposition are not yet recorded.",
-      transitions_to: ["complete", "aborted"]
-    },
-    {
-      id: "complete",
-      label: "Complete",
-      description: "Data collection finished and a disposition was recorded (confirmed, disconfirmed, or inconclusive). Learnings captured; outcome edges (validates, produced_insight, informed_decision) wired to downstream entities.",
-      transitions_to: []
-    },
-    {
-      id: "aborted",
-      label: "Aborted",
-      description: "Terminated early without a valid finding: infrastructure failure, exposure threshold not met, or the underlying plan was withdrawn. No disposition recorded.",
-      transitions_to: []
-    }
-  ]
-};
 var RESEARCH_PLAN_LIFECYCLE = {
   entity_type: "research_plan",
   initial_phase: "draft",
@@ -4755,31 +4663,6 @@ var USER_ADVISORY_BOARD_LIFECYCLE = {
     }
   ]
 };
-var DESIGN_SPRINT_LIFECYCLE = {
-  entity_type: "design_sprint",
-  initial_phase: "planning",
-  terminal_phases: ["completed"],
-  phases: [
-    {
-      id: "planning",
-      label: "Planning",
-      description: "The sprint challenge has been defined. Participants are identified. Space and materials are being arranged.",
-      transitions_to: ["in_progress"]
-    },
-    {
-      id: "in_progress",
-      label: "In Progress",
-      description: "The sprint is running. The team is moving through understand, sketch, decide, prototype, and test phases.",
-      transitions_to: ["completed"]
-    },
-    {
-      id: "completed",
-      label: "Completed",
-      description: "The sprint has concluded. Decisions and prototypes have been captured. Learnings inform next steps.",
-      transitions_to: []
-    }
-  ]
-};
 var OBJECTIVE_LIFECYCLE = {
   entity_type: "objective",
   initial_phase: "draft",
@@ -4929,37 +4812,6 @@ var STRATEGIC_PILLAR_LIFECYCLE = {
     }
   ]
 };
-var ASSUMPTION_LIFECYCLE = {
-  entity_type: "assumption",
-  initial_phase: "untested",
-  terminal_phases: ["validated", "invalidated"],
-  phases: [
-    {
-      id: "untested",
-      label: "Untested",
-      description: "Stated and acknowledged, awaiting systematic test. Some strategic assumptions stay untested by design.",
-      transitions_to: ["testing"]
-    },
-    {
-      id: "testing",
-      label: "Testing",
-      description: "An experiment or research activity is underway to test this assumption. Evidence is being gathered.",
-      transitions_to: ["validated", "invalidated"]
-    },
-    {
-      id: "validated",
-      label: "Validated",
-      description: "Evidence supports the assumption. The belief has been confirmed. Decisions resting on it are on firmer ground.",
-      transitions_to: []
-    },
-    {
-      id: "invalidated",
-      label: "Invalidated",
-      description: "Evidence contradicts the assumption. Decisions or plans that rested on it should be revisited.",
-      transitions_to: []
-    }
-  ]
-};
 var STRATEGIC_QUESTION_LIFECYCLE = {
   entity_type: "strategic_question",
   initial_phase: "open",
@@ -5068,31 +4920,6 @@ var FEATURE_LIFECYCLE = {
     }
   ]
 };
-var EPIC_LIFECYCLE = {
-  entity_type: "epic",
-  initial_phase: "todo",
-  terminal_phases: ["done"],
-  phases: [
-    {
-      id: "todo",
-      label: "To Do",
-      description: "The epic has been defined and scoped but work has not started. It is in the backlog.",
-      transitions_to: ["in_progress"]
-    },
-    {
-      id: "in_progress",
-      label: "In Progress",
-      description: "Work on the epic is underway. Stories are being pulled into sprints.",
-      transitions_to: ["done"]
-    },
-    {
-      id: "done",
-      label: "Done",
-      description: "All stories in the epic have been completed and the epic goal has been achieved.",
-      transitions_to: []
-    }
-  ]
-};
 var RELEASE_LIFECYCLE = {
   entity_type: "release",
   initial_phase: "planned",
@@ -5118,74 +4945,6 @@ var RELEASE_LIFECYCLE = {
     }
   ]
 };
-var TASK_LIFECYCLE = {
-  entity_type: "task",
-  initial_phase: "todo",
-  terminal_phases: ["done"],
-  phases: [
-    {
-      id: "todo",
-      label: "To Do",
-      description: "The task is defined and ready to be picked up.",
-      transitions_to: ["in_progress"]
-    },
-    {
-      id: "in_progress",
-      label: "In Progress",
-      description: "A team member is actively working on this task.",
-      transitions_to: ["in_review", "done"]
-    },
-    {
-      id: "in_review",
-      label: "In Review",
-      description: "Work is complete and awaiting review, approval, or verification.",
-      transitions_to: ["in_progress", "done"]
-    },
-    {
-      id: "done",
-      label: "Done",
-      description: "The task is complete and verified.",
-      transitions_to: []
-    }
-  ]
-};
-var BUG_LIFECYCLE = {
-  entity_type: "bug",
-  initial_phase: "open",
-  terminal_phases: ["verified", "wont_fix"],
-  phases: [
-    {
-      id: "open",
-      label: "Open",
-      description: "The bug has been reported but not yet triaged or assigned.",
-      transitions_to: ["in_progress", "wont_fix"]
-    },
-    {
-      id: "in_progress",
-      label: "In Progress",
-      description: "A developer is investigating and/or fixing the bug.",
-      transitions_to: ["fixed", "wont_fix"]
-    },
-    {
-      id: "fixed",
-      label: "Fixed",
-      description: "A fix has been implemented and merged. Awaiting verification in the target environment.",
-      transitions_to: ["verified", "open"]
-    },
-    {
-      id: "verified",
-      label: "Verified",
-      description: "The fix has been confirmed to resolve the bug in the target environment.",
-      transitions_to: []
-    },
-    {
-      id: "wont_fix",
-      label: "Won't Fix",
-      description: "Declined: by design, too costly relative to impact, or superseded by other work.",
-      transitions_to: []
-    }
-  ]
-};
 var ROADMAP_ITEM_LIFECYCLE = {
   entity_type: "roadmap_item",
   initial_phase: "planned",
@@ -5328,37 +5087,6 @@ var DESIGN_CONCEPT_LIFECYCLE = {
     }
   ]
 };
-var PROTOTYPE_LIFECYCLE = {
-  entity_type: "prototype",
-  initial_phase: "untested",
-  terminal_phases: ["passed", "failed"],
-  phases: [
-    {
-      id: "untested",
-      label: "Untested",
-      description: "The prototype has been built but has not yet been put in front of users.",
-      transitions_to: ["testing"]
-    },
-    {
-      id: "testing",
-      label: "Testing",
-      description: "The prototype is being tested with users. Sessions are underway.",
-      transitions_to: ["passed", "failed"]
-    },
-    {
-      id: "passed",
-      label: "Passed",
-      description: "Testing confirmed the design concept works for users. It is ready to inform detailed design or development.",
-      transitions_to: []
-    },
-    {
-      id: "failed",
-      label: "Failed",
-      description: "Testing revealed significant usability or concept problems. Learnings will inform a new design direction.",
-      transitions_to: []
-    }
-  ]
-};
 var BRAND_IDENTITY_LIFECYCLE = {
   entity_type: "brand_identity",
   initial_phase: "exploratory",
@@ -5384,6 +5112,43 @@ var BRAND_IDENTITY_LIFECYCLE = {
     }
   ]
 };
+var SCREEN_LIFECYCLE = {
+  entity_type: "screen",
+  initial_phase: "draft",
+  terminal_phases: ["deprecated"],
+  phases: [
+    {
+      id: "draft",
+      label: "Draft",
+      description: "The screen is a rough idea: named and scoped, but not yet worked in a design tool.",
+      transitions_to: ["in_design"]
+    },
+    {
+      id: "in_design",
+      label: "In Design",
+      description: "The screen is being designed: wireframes, mockups, or prototypes are in progress. May fall back to `draft` if the approach is rethought from scratch.",
+      transitions_to: ["built", "draft"]
+    },
+    {
+      id: "built",
+      label: "Built",
+      description: "The screen has been implemented in code. It exists in a build but is not yet live for users. May return to `in_design` if implementation surfaces a design gap.",
+      transitions_to: ["shipped", "in_design"]
+    },
+    {
+      id: "shipped",
+      label: "Shipped",
+      description: "The screen is live in production and reachable by users.",
+      transitions_to: ["deprecated"]
+    },
+    {
+      id: "deprecated",
+      label: "Deprecated",
+      description: "The screen has been retired. It is no longer reachable, or is being phased out in favour of a replacement.",
+      transitions_to: []
+    }
+  ]
+};
 var SERVICE_LIFECYCLE = {
   entity_type: "service",
   initial_phase: "development",
@@ -5465,43 +5230,6 @@ var FEATURE_FLAG_LIFECYCLE = {
     }
   ]
 };
-var TECHNICAL_DEBT_ITEM_LIFECYCLE = {
-  entity_type: "technical_debt_item",
-  initial_phase: "identified",
-  terminal_phases: ["resolved", "accepted"],
-  phases: [
-    {
-      id: "identified",
-      label: "Identified",
-      description: "The debt has been recognised and documented. It has not yet been triaged for action.",
-      transitions_to: ["acknowledged", "accepted"]
-    },
-    {
-      id: "acknowledged",
-      label: "Acknowledged",
-      description: "The team agrees the debt exists and has assessed its severity. A decision on when to address it is pending.",
-      transitions_to: ["in_progress", "accepted"]
-    },
-    {
-      id: "in_progress",
-      label: "In Progress",
-      description: "Work is underway to address and remediate the debt.",
-      transitions_to: ["resolved"]
-    },
-    {
-      id: "resolved",
-      label: "Resolved",
-      description: "The debt has been addressed. The code or system has been improved.",
-      transitions_to: []
-    },
-    {
-      id: "accepted",
-      label: "Accepted",
-      description: "A conscious decision to live with the debt. Remediation cost outweighs current value.",
-      transitions_to: []
-    }
-  ]
-};
 var INVESTIGATION_LIFECYCLE = {
   entity_type: "investigation",
   initial_phase: "open",
@@ -5632,49 +5360,6 @@ var INCIDENT_LIFECYCLE = {
     }
   ]
 };
-var VULNERABILITY_LIFECYCLE = {
-  entity_type: "vulnerability",
-  initial_phase: "open",
-  terminal_phases: ["resolved", "accepted"],
-  phases: [
-    {
-      id: "open",
-      label: "Open",
-      description: "The vulnerability has been identified. It has not yet been assessed for severity or assigned for remediation.",
-      transitions_to: ["triaged"]
-    },
-    {
-      id: "triaged",
-      label: "Triaged",
-      description: "The vulnerability has been assessed. CVSS score assigned. Priority and ownership determined.",
-      transitions_to: ["in_progress", "accepted"]
-    },
-    {
-      id: "in_progress",
-      label: "In Progress",
-      description: "Remediation work is actively underway. A fix is being developed or a compensating control is being implemented.",
-      transitions_to: ["mitigated", "resolved"]
-    },
-    {
-      id: "mitigated",
-      label: "Mitigated",
-      description: "A compensating control is in place. Immediate risk is reduced but the root vulnerability has not been patched.",
-      transitions_to: ["resolved", "accepted"]
-    },
-    {
-      id: "resolved",
-      label: "Resolved",
-      description: "The vulnerability has been fully remediated. The underlying issue is patched or eliminated.",
-      transitions_to: []
-    },
-    {
-      id: "accepted",
-      label: "Accepted",
-      description: "Formally acknowledged by the security team. Remediation is parked: low severity, compensating controls, or cost/benefit analysis.",
-      transitions_to: []
-    }
-  ]
-};
 var SECURITY_CONTROL_LIFECYCLE = {
   entity_type: "security_control",
   initial_phase: "planned",
@@ -5706,49 +5391,6 @@ var SECURITY_CONTROL_LIFECYCLE = {
     }
   ]
 };
-var A11Y_ISSUE_LIFECYCLE = {
-  entity_type: "a11y_issue",
-  initial_phase: "open",
-  terminal_phases: ["verified", "accepted"],
-  phases: [
-    {
-      id: "open",
-      label: "Open",
-      description: "The accessibility issue has been identified. It has not yet been triaged for severity or assigned for remediation.",
-      transitions_to: ["triaged"]
-    },
-    {
-      id: "triaged",
-      label: "Triaged",
-      description: "The issue has been assessed for severity and mapped to the affected WCAG criterion. Priority has been assigned.",
-      transitions_to: ["in_progress", "accepted"]
-    },
-    {
-      id: "in_progress",
-      label: "In Progress",
-      description: "A developer or designer is actively working to fix the accessibility issue.",
-      transitions_to: ["fixed"]
-    },
-    {
-      id: "fixed",
-      label: "Fixed",
-      description: "The fix has been implemented. Awaiting verification with assistive technology.",
-      transitions_to: ["verified", "in_progress"]
-    },
-    {
-      id: "verified",
-      label: "Verified",
-      description: "The fix has been confirmed to resolve the accessibility barrier using appropriate assistive technology.",
-      transitions_to: []
-    },
-    {
-      id: "accepted",
-      label: "Accepted",
-      description: "The team has formally acknowledged this issue and made a documented decision not to fix it at this time.",
-      transitions_to: []
-    }
-  ]
-};
 var DATA_PIPELINE_LIFECYCLE = {
   entity_type: "data_pipeline",
   initial_phase: "building",
@@ -5823,37 +5465,6 @@ var AI_MODEL_LIFECYCLE = {
     }
   ]
 };
-var EVAL_RUN_LIFECYCLE = {
-  entity_type: "eval_run",
-  initial_phase: "planned",
-  terminal_phases: ["complete", "failed"],
-  phases: [
-    {
-      id: "planned",
-      label: "Planned",
-      description: "The run has been queued. It has not yet started executing.",
-      transitions_to: ["running"]
-    },
-    {
-      id: "running",
-      label: "Running",
-      description: "Actively executing. Prompts are being sent and responses scored.",
-      transitions_to: ["complete", "failed"]
-    },
-    {
-      id: "complete",
-      label: "Complete",
-      description: "The run finished successfully. Scores and results are available.",
-      transitions_to: []
-    },
-    {
-      id: "failed",
-      label: "Failed",
-      description: "Failed to complete: API error, timeout, or infrastructure failure. Create a new run to retry.",
-      transitions_to: []
-    }
-  ]
-};
 var WORKFLOW_RUN_LIFECYCLE = {
   entity_type: "workflow_run",
   initial_phase: "pending",
@@ -6090,29 +5701,6 @@ var TEST_PLAN_LIFECYCLE = {
     { id: "cancelled", label: "Cancelled", description: "Plan was abandoned mid-flight: assumption changed, priorities shifted, or the underlying code went away.", transitions_to: [] }
   ]
 };
-var FEASIBILITY_STUDY_LIFECYCLE = {
-  entity_type: "feasibility_study",
-  initial_phase: "scoped",
-  terminal_phases: ["concluded", "abandoned"],
-  phases: [
-    { id: "scoped", label: "Scoped", description: "Study has been framed: questions, methods, and budget are agreed.", transitions_to: ["analysing", "abandoned"] },
-    { id: "analysing", label: "Analysing", description: "Active analysis. Data is being gathered and synthesised.", transitions_to: ["concluded", "abandoned"] },
-    { id: "concluded", label: "Concluded", description: "Study reached a conclusion. Findings inform a go/no-go decision.", transitions_to: [] },
-    { id: "abandoned", label: "Abandoned", description: "Study was stopped before reaching a conclusion. Captured for the record.", transitions_to: [] }
-  ]
-};
-var AI_EXPERIMENT_LIFECYCLE = {
-  entity_type: "ai_experiment",
-  initial_phase: "planned",
-  terminal_phases: ["completed", "abandoned"],
-  phases: [
-    { id: "planned", label: "Planned", description: "Experiment has been designed but is not yet running.", transitions_to: ["running", "abandoned"] },
-    { id: "running", label: "Running", description: "Experiment is actively executing: model is being trained, evaluated, or compared.", transitions_to: ["analysed", "abandoned"] },
-    { id: "analysed", label: "Analysed", description: "Run is finished and results are being reviewed.", transitions_to: ["completed", "abandoned"] },
-    { id: "completed", label: "Completed", description: "Findings captured. Linked learnings drive downstream decisions.", transitions_to: [] },
-    { id: "abandoned", label: "Abandoned", description: "Experiment was stopped before producing usable findings.", transitions_to: [] }
-  ]
-};
 var AI_DATASET_LIFECYCLE = {
   entity_type: "ai_dataset",
   initial_phase: "collecting",
@@ -6135,17 +5723,6 @@ var AI_GUARDRAIL_LIFECYCLE = {
     { id: "removed", label: "Removed", description: "Guardrail is no longer enforced. May reopen to active if reinstated.", transitions_to: ["active"] }
   ]
 };
-var HALLUCINATION_REPORT_LIFECYCLE = {
-  entity_type: "hallucination_report",
-  initial_phase: "reported",
-  terminal_phases: ["resolved", "accepted"],
-  phases: [
-    { id: "reported", label: "Reported", description: "A hallucination has been observed and logged. Not yet investigated.", transitions_to: ["investigating"] },
-    { id: "investigating", label: "Investigating", description: "Active investigation: root cause analysis, reproduction, scope.", transitions_to: ["resolved", "accepted"] },
-    { id: "resolved", label: "Resolved", description: "A fix has shipped. Future occurrences should not happen.", transitions_to: ["investigating"] },
-    { id: "accepted", label: "Accepted", description: "Known limitation that will not be fixed in this iteration. Documented for users.", transitions_to: ["investigating"] }
-  ]
-};
 var MODEL_COMPARISON_LIFECYCLE = {
   entity_type: "model_comparison",
   initial_phase: "planned",
@@ -6191,17 +5768,6 @@ var BUSINESS_MODEL_LIFECYCLE = {
     { id: "pivoted", label: "Pivoted", description: "Model became something structurally different. Captured as a milestone before the new model takes over.", transitions_to: [] }
   ]
 };
-var VALUE_PROPOSITION_LIFECYCLE = {
-  entity_type: "value_proposition",
-  initial_phase: "drafted",
-  terminal_phases: ["validated", "invalidated"],
-  phases: [
-    { id: "drafted", label: "Drafted", description: "Statement of value has been articulated. Not yet tested.", transitions_to: ["testing", "invalidated"] },
-    { id: "testing", label: "Testing", description: "Statement is being tested against the target audience.", transitions_to: ["validated", "invalidated"] },
-    { id: "validated", label: "Validated", description: "Audience response confirms the value resonates. Forms the messaging foundation.", transitions_to: ["testing"] },
-    { id: "invalidated", label: "Invalidated", description: "Statement did not resonate. May reopen to drafted for a rewrite.", transitions_to: ["drafted"] }
-  ]
-};
 var REVENUE_STREAM_LIFECYCLE = {
   entity_type: "revenue_stream",
   initial_phase: "proposed",
@@ -6213,29 +5779,6 @@ var REVENUE_STREAM_LIFECYCLE = {
     { id: "sunset", label: "Sunset", description: "Stream is being wound down. May reopen to piloting if revived.", transitions_to: ["piloting"] }
   ]
 };
-var SUPPORT_TICKET_LIFECYCLE = {
-  entity_type: "support_ticket",
-  initial_phase: "opened",
-  terminal_phases: ["resolved", "closed"],
-  phases: [
-    { id: "opened", label: "Opened", description: "Ticket has been filed. Not yet looked at.", transitions_to: ["triaged"] },
-    { id: "triaged", label: "Triaged", description: "Ticket has been categorised, prioritised, and assigned. Ready for work.", transitions_to: ["in_progress"] },
-    { id: "in_progress", label: "In Progress", description: "Support is actively working on the ticket.", transitions_to: ["resolved", "triaged"] },
-    { id: "resolved", label: "Resolved", description: "Support believes the issue is fixed. Awaiting customer confirmation.", transitions_to: ["in_progress", "closed"] },
-    { id: "closed", label: "Closed", description: "Customer has confirmed. Ticket is fully done.", transitions_to: [] }
-  ]
-};
-var CUSTOMER_FEEDBACK_LIFECYCLE = {
-  entity_type: "customer_feedback",
-  initial_phase: "received",
-  terminal_phases: ["actioned", "acknowledged"],
-  phases: [
-    { id: "received", label: "Received", description: "Feedback has been captured. Not yet processed.", transitions_to: ["triaged"] },
-    { id: "triaged", label: "Triaged", description: "Feedback has been categorised and routed. Decision on action is pending.", transitions_to: ["actioned", "acknowledged"] },
-    { id: "actioned", label: "Actioned", description: "Feedback drove a change (a feature, a process, a doc update). Captured for the record.", transitions_to: [] },
-    { id: "acknowledged", label: "Acknowledged", description: "Feedback was read and considered but will not drive a change. Customer has been thanked.", transitions_to: [] }
-  ]
-};
 var CUSTOMER_HEALTH_SCORE_LIFECYCLE = {
   entity_type: "customer_health_score",
   initial_phase: "monitoring",
@@ -6439,6 +5982,43 @@ var SALES_DEAL_TEMPLATE = {
     { id: "closed_lost", label: "Closed Lost", description: "Deal did not close. A re-engaged prospect becomes a new `deal` rather than reviving this one.", transitions_to: [] }
   ]
 };
+var VALIDATION_TEMPLATE = {
+  template_id: "VALIDATION",
+  initial_phase: "untested",
+  terminal_phases: ["validated", "invalidated", "archived"],
+  phases: [
+    { id: "untested", label: "Untested", description: "Articulated but not yet examined against evidence.", transitions_to: ["testing"] },
+    { id: "testing", label: "Testing", description: "Actively gathering evidence for or against the claim.", transitions_to: ["validated", "invalidated"] },
+    { id: "validated", label: "Validated", description: "Evidence supports the claim. Treated as true until contradicted.", transitions_to: ["archived"] },
+    { id: "invalidated", label: "Invalidated", description: "Evidence contradicts the claim. May re-test if new evidence appears.", transitions_to: ["archived", "testing"] },
+    { id: "archived", label: "Archived", description: "Settled and retained for provenance. No longer active.", transitions_to: [] }
+  ]
+};
+var INCIDENT_TEMPLATE = {
+  template_id: "INCIDENT",
+  initial_phase: "open",
+  terminal_phases: ["resolved", "closed", "wont_fix"],
+  phases: [
+    { id: "open", label: "Open", description: "Surfaced and logged. Not yet triaged.", transitions_to: ["triaged"] },
+    { id: "triaged", label: "Triaged", description: "Assessed for severity and ownership. Routed for work or dispositioned.", transitions_to: ["in_progress", "resolved", "wont_fix"] },
+    { id: "in_progress", label: "In Progress", description: "Actively being worked toward a fix.", transitions_to: ["resolved", "wont_fix"] },
+    { id: "resolved", label: "Resolved", description: "Addressed and verified. May reopen to `triaged` on regression.", transitions_to: ["closed", "triaged"] },
+    { id: "closed", label: "Closed", description: "Administratively closed (duplicate, withdrawn, or no longer relevant).", transitions_to: [] },
+    { id: "wont_fix", label: "Won't Fix", description: "Triaged as not to be actioned. Reason should be documented.", transitions_to: [] }
+  ]
+};
+var STUDY_TEMPLATE = {
+  template_id: "STUDY",
+  initial_phase: "planned",
+  terminal_phases: ["complete", "abandoned"],
+  phases: [
+    { id: "planned", label: "Planned", description: "Scoped and scheduled. Not yet started.", transitions_to: ["running"] },
+    { id: "running", label: "Running", description: "Actively executing: collecting data or running the protocol.", transitions_to: ["analysing", "abandoned"] },
+    { id: "analysing", label: "Analysing", description: "Execution done; results are being analysed and written up.", transitions_to: ["complete", "abandoned"] },
+    { id: "complete", label: "Complete", description: "Analysed and concluded. Findings captured.", transitions_to: [] },
+    { id: "abandoned", label: "Abandoned", description: "Stopped before completion (killed, timed out, or superseded).", transitions_to: [] }
+  ]
+};
 var TEMPLATE_LIFECYCLES = [
   // Publishing lifecycle
   fromTemplate("content_piece", PUBLISHING_TEMPLATE),
@@ -6538,10 +6118,11 @@ var TEMPLATE_LIFECYCLES = [
   fromTemplate("access_policy", APPROVAL_TEMPLATE),
   fromTemplate("privacy_policy", APPROVAL_TEMPLATE),
   // ── Phase C: MATURITY (alpha / beta / ga / deprecated) ──────────────────────
+  // screen removed (UPG-690 Q3, 0.21.0): hand-authored SCREEN_LIFECYCLE below —
+  // the build-pipeline IS the real lifecycle, MATURITY was the mis-fit.
   fromTemplate("design_system", MATURITY_TEMPLATE),
   fromTemplate("design_component", MATURITY_TEMPLATE),
   fromTemplate("design_pattern", MATURITY_TEMPLATE),
-  fromTemplate("screen", MATURITY_TEMPLATE),
   fromTemplate("brand_logo", MATURITY_TEMPLATE),
   fromTemplate("certification", MATURITY_TEMPLATE),
   fromTemplate("data_source", MATURITY_TEMPLATE),
@@ -6551,12 +6132,44 @@ var TEMPLATE_LIFECYCLES = [
   fromTemplate("agent_task", WORK_ITEM_TEMPLATE),
   fromTemplate("agent_skill", WORK_ITEM_TEMPLATE),
   fromTemplate("agent_hook", WORK_ITEM_TEMPLATE),
+  // UPG-690 (0.21.0): task (exact match) + epic (todo→in_progress→done ⊆ WORK_ITEM,
+  // in_review becomes available — non-breaking widening) folded off hand-authored.
+  fromTemplate("task", WORK_ITEM_TEMPLATE),
+  fromTemplate("epic", WORK_ITEM_TEMPLATE),
   // ── Phase B: RISK_ITEM (identified → assessed → mitigated/accepted/closed) ──
   fromTemplate("threat", RISK_ITEM_TEMPLATE),
   fromTemplate("risk", RISK_ITEM_TEMPLATE),
   fromTemplate("compliance_requirement", RISK_ITEM_TEMPLATE),
   // ── Phase B: SALES_DEAL (qualified → proposal → negotiation → won/lost) ─────
-  fromTemplate("deal", SALES_DEAL_TEMPLATE)
+  fromTemplate("deal", SALES_DEAL_TEMPLATE),
+  // ── STUDY (planned → running → analysing → complete / abandoned) ───────────
+  // UPG-690 (0.21.0): time-boxed investigations folded off bespoke singletons.
+  // `model_comparison` stays bespoke — its publish/archive tail is a weak fit.
+  fromTemplate("experiment", STUDY_TEMPLATE),
+  fromTemplate("experiment_run", STUDY_TEMPLATE),
+  fromTemplate("research_study", STUDY_TEMPLATE),
+  fromTemplate("design_sprint", STUDY_TEMPLATE),
+  fromTemplate("feasibility_study", STUDY_TEMPLATE),
+  fromTemplate("ai_experiment", STUDY_TEMPLATE),
+  fromTemplate("eval_run", STUDY_TEMPLATE),
+  // ── VALIDATION (untested → testing → validated / invalidated → archived) ───
+  // UPG-690 (0.21.0): claims-tested-to-a-verdict folded off bespoke singletons.
+  // `business_model` stays bespoke — its `pivoted` terminal is a strategic
+  // outcome, not a verdict.
+  fromTemplate("assumption", VALIDATION_TEMPLATE),
+  fromTemplate("prototype", VALIDATION_TEMPLATE),
+  fromTemplate("value_proposition", VALIDATION_TEMPLATE),
+  fromTemplate("hypothesis", VALIDATION_TEMPLATE),
+  // ── INCIDENT (open → triaged → in_progress → resolved / closed / wont_fix) ─
+  // UPG-690 (0.21.0): triage-to-resolution defect/ticket family folded off
+  // bespoke singletons. `incident` stays bespoke (richer SRE flow).
+  fromTemplate("support_ticket", INCIDENT_TEMPLATE),
+  fromTemplate("bug", INCIDENT_TEMPLATE),
+  fromTemplate("a11y_issue", INCIDENT_TEMPLATE),
+  fromTemplate("vulnerability", INCIDENT_TEMPLATE),
+  fromTemplate("hallucination_report", INCIDENT_TEMPLATE),
+  fromTemplate("technical_debt_item", INCIDENT_TEMPLATE),
+  fromTemplate("customer_feedback", INCIDENT_TEMPLATE)
 ];
 var FRAMEWORK_EXERCISE_LIFECYCLE = {
   entity_type: "framework_exercise",
@@ -6630,21 +6243,15 @@ var UPG_LIFECYCLES = [
   // Foundations (0.9.12)
   SPECIFICATION_LIFECYCLE,
   // Discovery & Validation
-  RESEARCH_STUDY_LIFECYCLE,
   NEED_LIFECYCLE,
   OPPORTUNITY_LIFECYCLE,
   SOLUTION_LIFECYCLE,
-  HYPOTHESIS_CLAIM_LIFECYCLE,
-  // canonical 'hypothesis' lifecycle. The pre-v0.2.8 legacy binding (untested → testing → resolved) was removed in 0.13.0 Wave 1 (UPG-685 T0.3): it was a dead second binding for the same entity_type, always shadowed by this one, and the legacy-status remap lives in UPG_*_MIGRATIONS, not a live lifecycle.
-  EXPERIMENT_LIFECYCLE,
   EXPERIMENT_PLAN_LIFECYCLE,
-  EXPERIMENT_RUN_LIFECYCLE,
   RESEARCH_PLAN_LIFECYCLE,
   FEEDBACK_PROGRAM_LIFECYCLE,
   FEATURE_REQUEST_LIFECYCLE,
   BETA_PROGRAM_LIFECYCLE,
   USER_ADVISORY_BOARD_LIFECYCLE,
-  DESIGN_SPRINT_LIFECYCLE,
   // Strategy & Product Specification
   OUTCOME_LIFECYCLE,
   VISION_LIFECYCLE,
@@ -6655,39 +6262,31 @@ var UPG_LIFECYCLES = [
   STRATEGIC_THEME_LIFECYCLE,
   INITIATIVE_LIFECYCLE,
   STRATEGIC_PILLAR_LIFECYCLE,
-  ASSUMPTION_LIFECYCLE,
   STRATEGIC_QUESTION_LIFECYCLE,
   FEATURE_AREA_LIFECYCLE,
   FEATURE_LIFECYCLE,
-  EPIC_LIFECYCLE,
   // user_story is lifecycle-free (declared in UPG_LIFECYCLE_FREE_TYPES below).
-  // story_task lifecycle removed v0.4.0; collapsed into task (TASK_LIFECYCLE,
-  // WORK_ITEM_TEMPLATE).
+  // story_task lifecycle removed v0.4.0; collapsed into task. task + epic are
+  // now WORK_ITEM-template-derived (UPG-690, 0.21.0) — see TEMPLATE_LIFECYCLES.
   RELEASE_LIFECYCLE,
-  TASK_LIFECYCLE,
-  BUG_LIFECYCLE,
   ROADMAP_ITEM_LIFECYCLE,
   PLANNING_CYCLE_LIFECYCLE,
   IP_ASSET_LIFECYCLE,
   CONTRACT_LIFECYCLE,
   DESIGN_CONCEPT_LIFECYCLE,
-  PROTOTYPE_LIFECYCLE,
   BRAND_IDENTITY_LIFECYCLE,
+  SCREEN_LIFECYCLE,
   // Engineering & Operations
   SERVICE_LIFECYCLE,
   DEPLOYMENT_LIFECYCLE,
   FEATURE_FLAG_LIFECYCLE,
-  TECHNICAL_DEBT_ITEM_LIFECYCLE,
   INVESTIGATION_LIFECYCLE,
   EXTERNAL_API_LIFECYCLE,
   DATABASE_SCHEMA_LIFECYCLE,
   INCIDENT_LIFECYCLE,
-  VULNERABILITY_LIFECYCLE,
   SECURITY_CONTROL_LIFECYCLE,
-  A11Y_ISSUE_LIFECYCLE,
   DATA_PIPELINE_LIFECYCLE,
   AI_MODEL_LIFECYCLE,
-  EVAL_RUN_LIFECYCLE,
   WORKFLOW_RUN_LIFECYCLE,
   AGENT_DEFINITION_LIFECYCLE,
   AGENT_SESSION_LIFECYCLE,
@@ -6700,22 +6299,16 @@ var UPG_LIFECYCLES = [
   RESEARCH_QUESTION_LIFECYCLE,
   INTERVIEW_GUIDE_LIFECYCLE,
   TEST_PLAN_LIFECYCLE,
-  FEASIBILITY_STUDY_LIFECYCLE,
   // AI workflow
-  AI_EXPERIMENT_LIFECYCLE,
   AI_DATASET_LIFECYCLE,
   AI_GUARDRAIL_LIFECYCLE,
-  HALLUCINATION_REPORT_LIFECYCLE,
   MODEL_COMPARISON_LIFECYCLE,
   PROMPT_VERSION_LIFECYCLE,
   EVAL_BENCHMARK_LIFECYCLE,
   // Business Model
   BUSINESS_MODEL_LIFECYCLE,
-  VALUE_PROPOSITION_LIFECYCLE,
   REVENUE_STREAM_LIFECYCLE,
   // Customer Success
-  SUPPORT_TICKET_LIFECYCLE,
-  CUSTOMER_FEEDBACK_LIFECYCLE,
   CUSTOMER_HEALTH_SCORE_LIFECYCLE,
   PLAYBOOK_LIFECYCLE,
   // Team & Organisation
@@ -7829,6 +7422,64 @@ function getDeprecatedTypes() {
   return deprecated;
 }
 var UPG_PROPERTY_MIGRATIONS = {
+  // ── v0.21.0: UPG-690 D.1 — collapse residual *_status shadows into status ────
+  //
+  // Six `*_status` enum properties that re-encode their entity's own lifecycle
+  // phases (the residual Pattern-D shadows not caught by the 0.15.0 sweep, now
+  // that the entities sit on shared templates). Each is removed; the authored
+  // value LIFTS to UPGBaseNode.status, remapping where the property vocabulary
+  // diverged from the (template) lifecycle. `security_policy.policy_status` was
+  // deliberately EXCLUDED (Captain 2026-07-04): its active/under_review/retired
+  // values are an operational-status axis distinct from its APPROVAL lifecycle
+  // (active != approved) — a distinct-axis keeper, not a shadow.
+  "0.21.0": [
+    {
+      kind: "lift_property_to_top_level",
+      type: "brand_identity",
+      from_property: "brand_stage",
+      to: "status",
+      reason: "UPG-690 D.1: brand_stage (exploratory/defined/mature) is an exact shadow of the brand_identity lifecycle. Removed in 0.21.0; lifts to status verbatim."
+    },
+    {
+      kind: "lift_property_to_top_level",
+      type: "deliverable",
+      from_property: "deliverable_status",
+      to: "status",
+      value_map: { not_started: "todo", accepted: "done", rejected: "done" },
+      reason: "UPG-690 D.1: deliverable_status re-encoded the deliverable WORK_ITEM lifecycle. Removed in 0.21.0; lifts to status with not_started -> todo, accepted/rejected -> done."
+    },
+    {
+      kind: "lift_property_to_top_level",
+      type: "press_release",
+      from_property: "pr_status",
+      to: "status",
+      value_map: { in_review: "review", distributed: "published" },
+      reason: "UPG-690 D.1: pr_status re-encoded the press_release PUBLISHING lifecycle. Removed in 0.21.0; lifts to status with in_review -> review, distributed -> published."
+    },
+    {
+      kind: "lift_property_to_top_level",
+      type: "program",
+      from_property: "program_status",
+      to: "status",
+      value_map: { on_hold: "paused", cancelled: "sunset" },
+      reason: "UPG-690 D.1: program_status re-encoded the program OPERATIONAL lifecycle. Removed in 0.21.0; lifts to status with on_hold -> paused, cancelled -> sunset."
+    },
+    {
+      kind: "lift_property_to_top_level",
+      type: "project",
+      from_property: "project_status",
+      to: "status",
+      value_map: { on_hold: "paused", cancelled: "sunset" },
+      reason: "UPG-690 D.1: project_status re-encoded the project OPERATIONAL lifecycle. Removed in 0.21.0; lifts to status with on_hold -> paused, cancelled -> sunset."
+    },
+    {
+      kind: "lift_property_to_top_level",
+      type: "screen",
+      from_property: "screen_status",
+      to: "status",
+      reason: "UPG-690 D.3/Q3: screen flips from MATURITY to a hand-authored build-pipeline lifecycle (draft/in_design/built/shipped/deprecated); screen_status already carried those exact values. Removed in 0.21.0; lifts to status verbatim."
+    }
+  ],
   // ── v0.16.0: Pattern G — open-standard data boundary (UPG-691) ───────────────
   //
   // The portable graph holds modeling knowledge, not PII, registry filings,
@@ -9427,6 +9078,25 @@ function getScalarToEdgeMigrations(fromVersion, toVersion) {
   return result;
 }
 var UPG_EDGE_MIGRATIONS = {
+  // (target version TBD at release ceremony — pencilled at 0.22.0, the next
+  // breaking slot after 0.21.0 per the docket; adjust the key if Wave 4
+  // claims it first.) WS3 commit-provenance collapse (2026-07-05, ratified):
+  // `workspace_produced_decision` widens to the `node` wildcard endpoint —
+  // a workspace's commit loop can legitimately produce any entity type
+  // arranged in it (decision, feature, persona, ...), not just decisions.
+  // No flip (source stays workspace); the target node's concrete type is
+  // unchanged (still a decision), only the edge key + catalog target_type
+  // widen. See the enum-vs-polymorphism ADR and the WS3 proposal doc for
+  // the full reasoning (mirrors decision_produces_node).
+  "0.22.0": [
+    // No requires_target_type: the destination's target_type is the `node`
+    // wildcard, and the endpoint guard is checked against the catalog's
+    // declared type (per the spec-integrity "endpoint guards match the
+    // catalog entry" test), not the concrete instance type — a concrete
+    // `decision` instance would never satisfy a literal 'node' guard at
+    // runtime. Gate only on the unwidened source endpoint.
+    { kind: "rename", from: "workspace_produced_decision", to: "workspace_produced_node", requires_source_type: "workspace", reason: "WS3 commit-provenance collapse (2026-07-05, Captain-ratified). workspace_produced_decision widens to the polymorphic workspace_produced_node: a workspace commit can legitimately produce any entity type, not just a decision. No flip; only the target_type widens from decision to the node wildcard." }
+  ],
   "0.9.9": [
     // (since v0.9.9, UPG-664/UPG-678) Validation experiment-model + test_plan
     // re-home. The validation chain is reshaped to the single-parent line
@@ -10253,19 +9923,7 @@ var UPG_STATUS_MIGRATIONS = {
     retired: "deprecated"
   },
   // ── Discovery & Validation ───────────────────────────────────────────────
-  hypothesis: {
-    // Lifecycle: [drafted, active, validated, invalidated, archived]
-    // Legacy pre-v0.2.8 vocabulary mapped via UPG_PROPERTY_MIGRATIONS for
-    // property→top-level lifts, but raw top-level legacy values surface
-    // when authors set `status: untested` directly without going through
-    // the property bag.
-    untested: "drafted",
-    testing: "active",
-    proposed: "drafted",
-    deferred: "archived",
-    resolved: "active"
-    // ambiguous: prefer active until evidence settles
-  },
+  // (hypothesis moved to the VALIDATION template fold section below, 0.21.0)
   opportunity: {
     // Lifecycle: [identified, validated, deferred]  (no terminal phases)
     // Common authoring leftovers from pre-canonical Lean Canvas
@@ -10317,7 +9975,118 @@ var UPG_STATUS_MIGRATIONS = {
     archived: "sunset",
     retired: "sunset"
   },
-  // ── DevOps: incident ─────────────────────────────────────────────────────
+  // ── VALIDATION template fold (UPG-690, 0.21.0) ───────────────────────────
+  // Bespoke claim vocabularies remapped onto VALIDATION
+  // [untested, testing, validated, invalidated, archived].
+  // `assumption` already matches (untested, testing, validated, invalidated) —
+  // no migration entry needed.
+  prototype: {
+    // was [untested, testing, passed, failed]
+    passed: "validated",
+    failed: "invalidated"
+  },
+  value_proposition: {
+    // was [drafted, testing, validated, invalidated]
+    drafted: "untested"
+  },
+  hypothesis: {
+    // was [drafted, active, validated, invalidated, archived] (HYPOTHESIS_CLAIM
+    // const, re-homed to entity_type 'hypothesis' at v0.4.0). The legacy
+    // pre-v0.2.8 [untested, testing, resolved] mapping already lived here; it is
+    // now consistent with the VALIDATION spine.
+    drafted: "untested",
+    active: "testing",
+    // pre-v0.2.8 legacy values (kept from the prior hypothesis migration):
+    proposed: "untested",
+    deferred: "archived",
+    resolved: "validated"
+    // ambiguous historically; prefer validated on resolve
+  },
+  // ── STUDY template fold (UPG-690, 0.21.0) ────────────────────────────────
+  // Bespoke run/study vocabularies remapped onto STUDY
+  // [planned, running, analysing, complete, abandoned].
+  experiment: {
+    // was [planned, running, analysing, done]
+    done: "complete"
+  },
+  experiment_run: {
+    // was [in_progress, complete, aborted]
+    in_progress: "running",
+    aborted: "abandoned"
+  },
+  research_study: {
+    // was [planned, in_progress, analysing, complete]
+    in_progress: "running"
+  },
+  design_sprint: {
+    // was [planning, in_progress, completed]
+    planning: "planned",
+    in_progress: "running",
+    completed: "complete"
+  },
+  feasibility_study: {
+    // was [scoped, analysing, concluded, abandoned]
+    scoped: "planned",
+    concluded: "complete"
+  },
+  ai_experiment: {
+    // was [planned, running, analysed, completed, abandoned]
+    analysed: "analysing",
+    completed: "complete"
+  },
+  eval_run: {
+    // was [planned, running, complete, failed]. `failed` = the run did not
+    // finish cleanly (errored / killed) → abandoned. A completed run whose
+    // result was negative stays `complete` (the verdict lives elsewhere).
+    failed: "abandoned"
+  },
+  // ── INCIDENT template fold (UPG-690, 0.21.0) ─────────────────────────────
+  // Bespoke triage vocabularies remapped onto INCIDENT
+  // [open, triaged, in_progress, resolved, closed, wont_fix]. `incident` itself
+  // is NOT folded (stays bespoke; see the DevOps entry below).
+  support_ticket: {
+    // was [opened, triaged, in_progress, resolved, closed]
+    opened: "open"
+  },
+  bug: {
+    // was [open, in_progress, fixed, verified, wont_fix]
+    fixed: "in_progress",
+    // fixed-but-not-verified is still work in progress
+    verified: "resolved"
+  },
+  a11y_issue: {
+    // was [open, triaged, in_progress, fixed, verified, accepted]
+    fixed: "in_progress",
+    verified: "resolved",
+    accepted: "resolved"
+    // verified-and-accepted == resolved
+  },
+  vulnerability: {
+    // was [open, triaged, in_progress, mitigated, resolved, accepted]
+    mitigated: "in_progress",
+    // mitigation applied, not yet fully resolved
+    accepted: "resolved"
+  },
+  hallucination_report: {
+    // was [reported, investigating, resolved, accepted]
+    reported: "open",
+    investigating: "in_progress",
+    accepted: "resolved"
+  },
+  technical_debt_item: {
+    // was [identified, acknowledged, in_progress, resolved, accepted]
+    identified: "open",
+    acknowledged: "triaged",
+    accepted: "resolved"
+  },
+  customer_feedback: {
+    // was [received, triaged, actioned, acknowledged]
+    received: "open",
+    actioned: "resolved",
+    acknowledged: "closed"
+    // noted with no action == administratively closed
+  },
+  // ── DevOps: incident (stays bespoke — richer SRE flow, not folded) ────────
   incident: {
     // Lifecycle: [detected, triaged, contained, resolved, mitigated]
     open: "detected",
@@ -10326,6 +10095,16 @@ var UPG_STATUS_MIGRATIONS = {
     in_progress: "triaged",
     closed: "resolved",
     fixed: "resolved"
+  },
+  // ── UX/Design: screen (UPG-690 Q3/D.3, 0.21.0) — MATURITY → build-pipeline
+  // flip. Old lifecycle [alpha, beta, ga, deprecated]; new SCREEN_LIFECYCLE
+  // [draft, in_design, built, shipped, deprecated]. `deprecated` IS canonical
+  // in both (no rewrite needed); omitted per the no-identity-entries doctrine
+  // (see status-migrations.test.ts).
+  screen: {
+    alpha: "built",
+    beta: "shipped",
+    ga: "shipped"
   }
 };
 function migrateStatusValue(entityType, currentStatus) {
@@ -10785,7 +10564,6 @@ var UPG_PROPERTY_SCHEMA = {
     personality_traits: { type: "string[]", description: 'Core personality traits of the brand (e.g. "bold", "approachable", "innovative")' },
     tagline: { type: "string", description: 'Brand tagline or slogan (e.g. "Just Do It", "Think Different")' },
     mission_statement: { type: "string", description: "Mission statement: what the brand exists to do." },
-    brand_stage: { type: "string", enum: ["exploratory", "defined", "mature"], description: "Current lifecycle stage of the brand" },
     brand_values: { type: "string[]", description: 'Core brand values. The principles the brand stands for. @example ["innovation", "transparency", "sustainability"]' },
     brand_story: { type: "string", description: "Brand origin story or narrative. Free-form text, may be multiple paragraphs." },
     target_audience_description: { type: "string", description: 'Target audience description. Who the brand speaks to. @example "Solo founders and small product teams building their first product."' },
@@ -11306,7 +11084,6 @@ var UPG_PROPERTY_SCHEMA = {
   deliverable: {
     deliverable_type: { type: "string", enum: ["document", "prototype", "release", "design", "report", "other"], description: "Kind of deliverable (UPG-579 Option B)." },
     due_date: { type: "string", description: "Due date for the deliverable (ISO format)" },
-    deliverable_status: { type: "string", enum: ["not_started", "in_progress", "in_review", "accepted", "rejected"], description: "Current progress status" },
     acceptance_criteria: { type: "string", description: "Criteria that must be met for the deliverable to be accepted" }
   },
   // DemandGenProgramProperties: DemandGenProgram entity.
@@ -12647,8 +12424,7 @@ var UPG_PROPERTY_SCHEMA = {
   press_release: {
     pr_type: { type: "string", enum: ["product_launch", "partnership", "funding", "milestone", "other"], description: "Category of the press release" },
     publish_date: { type: "string", description: "Date the release was or will be published (ISO format)" },
-    outlets: { type: "string[]", description: "Media outlets targeted for distribution" },
-    pr_status: { type: "string", enum: ["draft", "in_review", "distributed", "published"], description: "Current status of the press release" }
+    outlets: { type: "string[]", description: "Media outlets targeted for distribution" }
   },
   // PricingStrategyProperties: Pricing strategy.
   pricing_strategy: {
@@ -12693,14 +12469,12 @@ var UPG_PROPERTY_SCHEMA = {
   },
   // ProgramProperties: Program.
   program: {
-    program_status: { type: "string", enum: ["planning", "active", "on_hold", "completed", "cancelled"], description: "Current status of the program" },
     start_date: { type: "string", description: "Program start date (ISO format)" },
     end_date: { type: "string", description: "Program end date (ISO format)" },
     budget: { type: "number", description: "Total budget allocated to the program" }
   },
   // ProjectProperties: Project.
   project: {
-    project_status: { type: "string", enum: ["planning", "active", "on_hold", "completed", "cancelled"], description: "Current status of the project" },
     start_date: { type: "string", description: "Project start date (ISO format)" },
     end_date: { type: "string", description: "Project end date (ISO format)" },
     methodology: { type: "string", enum: ["agile", "waterfall", "kanban", "hybrid"], description: "Development methodology used" }
@@ -12970,7 +12744,6 @@ var UPG_PROPERTY_SCHEMA = {
     route: { type: "string", description: 'Application route. @example "/dashboard", "/settings/billing"' },
     viewport: { type: "string", enum: ["mobile", "tablet", "desktop", "tv", "watch", "responsive"], description: "Primary target viewport" },
     access_level: { type: "string", enum: ["public", "authenticated", "admin", "internal"], description: "Reach" },
-    screen_status: { type: "string", enum: ["draft", "in_design", "built", "shipped", "deprecated"], description: "Build pipeline stage" },
     purpose: { type: "string", description: "One-line purpose" }
   },
   // ScreenStateProperties: Specific state of a screen.
@@ -30174,7 +29947,7 @@ function isCanonical(text) {
 }
 
 // src/index.ts
-var UPG_VERSION = "0.20.2";
+var UPG_VERSION = "0.22.0";
 var UPG_FORMAT_VERSION = "0.4.0";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();