@unified-product-graph/core 0.9.8 → 0.9.10

package/dist/index.cjs

@@ -182,6 +182,7 @@ __export(index_exports, {
   resolveEntityType: () => resolveEntityType,
   resolveLabel: () => resolveLabel,
   resolveSlugCollision: () => resolveSlugCollision,
+  ringOrderedDomainIds: () => ringOrderedDomainIds,
   rotateSlug: () => rotateSlug,
   serializeCanonical: () => serializeCanonical,
   validateProductStageStrict: () => validateProductStageStrict,
@@ -238,8 +239,8 @@ var UPG_DOMAINS = [
   {
     id: "validation",
     label: "Validation",
-    description: "Testing ideas before committing to build them. Hypotheses state testable beliefs. Experiments run the tests. Evidence captures what was observed. Learnings distill what was understood. Test plans structure the approach. Research plans coordinate broader investigation. Consumes opportunities from Discovery and insights from User Research, producing evidence that informs Strategy and Product Specification.",
-    types: ["hypothesis", "experiment", "experiment_plan", "experiment_run", "learning", "test_plan", "evidence", "research_plan"]
+    description: "Testing ideas before committing to build them. Hypotheses state testable beliefs. Experiment plans structure the validation design. Experiments run the tests, with experiment runs capturing replication. Evidence captures what was observed. Learnings distill what was understood. Research plans coordinate broader investigation. Consumes opportunities from Discovery and insights from User Research, producing evidence that informs Strategy and Product Specification.",
+    types: ["hypothesis", "experiment", "experiment_plan", "experiment_run", "learning", "evidence", "research_plan"]
   },
   {
     id: "market_intelligence",
@@ -484,8 +485,9 @@ var UPG_DOMAINS = [
   {
     id: "testing",
     label: "Quality Assurance",
-    description: "Verifying your product works correctly. Test suites group related tests. Test cases define individual checks. QA sessions capture exploratory testing. Regression tests guard against regressions. Test coverage reports measure completeness. Test environments define where tests run. Test results record outcomes. Validates Engineering (code quality) and Product Specification (acceptance criteria). Feeds DevOps (release confidence).",
+    description: "Verifying your product works correctly. Test plans define the verification approach (scope, environments, pass criteria). Test suites group related tests. Test cases define individual checks. QA sessions capture exploratory testing. Regression tests guard against regressions. Test coverage reports measure completeness. Test environments define where tests run. Test results record outcomes. Validates Engineering (code quality) and Product Specification (acceptance criteria). Feeds DevOps (release confidence).",
     types: [
+      "test_plan",
       "test_suite",
       "test_case",
       "qa_session",
@@ -524,7 +526,7 @@ var UPG_DOMAINS = [
   {
     id: "ai",
     label: "AI & Machine Learning",
-    description: "AI and machine learning capabilities within your product. AI models track deployed models. Prompt versions manage prompt evolution. Eval benchmarks and eval runs measure quality. AI cost trackers monitor spend. Hallucination reports flag reliability issues. AI guardrails set safety boundaries. Model comparisons evaluate alternatives. AI experiments test new approaches. AI datasets track training data. AI traces log inference chains. Connects to Engineering, Data & Analytics, and Product Specification.",
+    description: "AI and machine learning capabilities within your product. AI models track deployed models. Prompt templates define reusable prompts; prompt versions manage their evolution. Eval benchmarks and eval runs measure quality. AI cost trackers monitor spend. Hallucination reports flag reliability issues. AI guardrails set safety boundaries. Model comparisons evaluate alternatives. AI experiments test new approaches. AI datasets track training data. AI traces log inference chains. Connects to Engineering, Data & Analytics, and Product Specification.",
     types: [
       "ai_model",
       "prompt_version",
@@ -747,15 +749,23 @@ var UPG_ENTITY_META = [
   { name: "hypothesis", type_id: "ent_027", maturity: "stable", since: "0.1.0" },
   { name: "hypothesis_claim", type_id: "ent_344", maturity: "deprecated", since: "0.2.8", deprecated_in: "0.4.0", replacement: "hypothesis" },
   { name: "hypothesis_evidence", type_id: "ent_345", maturity: "deprecated", since: "0.2.8", deprecated_in: "0.4.0", replacement: "evidence" },
-  // `experiment` is canonical. It has its own property schema
+  // `experiment` is canonical (UPG-664). It has its own property schema
   // (method, start_date, end_date, sample_size, expected_lift) and is the
-  // canonical parent of `ab_test` in the hierarchy. Plan/Run split
-  // (experiment_plan + experiment_run) remains as the fine-grained option;
-  // `experiment` covers the general-purpose use case.
+  // canonical unit of a structured test. The validation flow is
+  // `hypothesis → experiment_plan → experiment → experiment_run`: the plan is
+  // the validation design, the experiment is the structured test, the run is
+  // the optional multi-run/replication child.
   { name: "experiment", type_id: "ent_028", maturity: "stable", since: "0.1.0" },
-  { name: "experiment_plan", type_id: "ent_340", maturity: "proposed", since: "0.2.6" },
+  // experiment_plan graduated proposed → stable (UPG-664). It is the canonical
+  // validation PLAN type — it absorbed `test_plan`'s planning properties
+  // (method / success_criteria / sample_size) when `test_plan` re-homed to the
+  // QA/testing domain (UPG-678).
+  { name: "experiment_plan", type_id: "ent_340", maturity: "stable", since: "0.2.6" },
   { name: "experiment_run", type_id: "ent_341", maturity: "proposed", since: "0.2.6" },
   { name: "learning", type_id: "ent_029", maturity: "stable", since: "0.1.0" },
+  // test_plan re-homed validation → testing/QA (UPG-678). It is the QA
+  // verification-procedure plan (test scope / environments / pass criteria);
+  // its former validation-planning role is carried by experiment_plan.
   { name: "test_plan", type_id: "ent_030", maturity: "stable", since: "0.1.0" },
   { name: "evidence", type_id: "ent_031", maturity: "stable", since: "0.1.0" },
   { name: "research_plan", type_id: "ent_032", maturity: "stable", since: "0.1.0" },
@@ -889,7 +899,7 @@ var UPG_ENTITY_META = [
   { name: "behavioral_segment", type_id: "ent_111", maturity: "stable", since: "0.1.0" },
   { name: "segment", type_id: "ent_338", maturity: "deprecated", since: "0.1.0", deprecated_in: "0.2.0", replacement: "behavioral_segment" },
   { name: "growth_loop", type_id: "ent_112", maturity: "stable", since: "0.1.0" },
-  { name: "growth_experiment", type_id: "ent_113", maturity: "deprecated", since: "0.1.0", deprecated_in: "0.1.0", replacement: "experiment_run" },
+  { name: "growth_experiment", type_id: "ent_113", maturity: "deprecated", since: "0.1.0", deprecated_in: "0.1.0", replacement: "experiment" },
   { name: "variant", type_id: "ent_114", maturity: "stable", since: "0.1.0" },
   { name: "attribution_model", type_id: "ent_115", maturity: "stable", since: "0.1.0" },
   // ── Business Model ──
@@ -939,7 +949,7 @@ var UPG_ENTITY_META = [
   { name: "metric_definition", type_id: "ent_154", maturity: "deprecated", since: "0.1.0", deprecated_in: "0.1.0", replacement: "metric" },
   { name: "event_schema", type_id: "ent_155", maturity: "stable", since: "0.1.0" },
   { name: "dashboard", type_id: "ent_156", maturity: "stable", since: "0.1.0" },
-  { name: "ab_test", type_id: "ent_157", maturity: "deprecated", since: "0.1.0", deprecated_in: "0.1.0", replacement: "experiment_run" },
+  { name: "ab_test", type_id: "ent_157", maturity: "deprecated", since: "0.1.0", deprecated_in: "0.1.0", replacement: "experiment" },
   { name: "data_model", type_id: "ent_158", maturity: "stable", since: "0.1.0" },
   { name: "data_quality_rule", type_id: "ent_159", maturity: "stable", since: "0.1.0" },
   { name: "data_product", type_id: "ent_160", maturity: "stable", since: "0.1.0" },
@@ -1021,7 +1031,7 @@ var UPG_ENTITY_META = [
   { name: "feedback_theme", type_id: "ent_225", maturity: "stable", since: "0.1.0" },
   // ── Pricing & Packaging ──
   { name: "pricing_strategy", type_id: "ent_226", maturity: "stable", since: "0.1.0" },
-  { name: "pricing_experiment", type_id: "ent_227", maturity: "deprecated", since: "0.1.0", deprecated_in: "0.1.0", replacement: "experiment_run" },
+  { name: "pricing_experiment", type_id: "ent_227", maturity: "deprecated", since: "0.1.0", deprecated_in: "0.1.0", replacement: "experiment" },
   { name: "package", type_id: "ent_228", maturity: "deprecated", since: "0.1.0", deprecated_in: "0.2.0", replacement: "pricing_tier" },
   { name: "discount_strategy", type_id: "ent_229", maturity: "stable", since: "0.1.0" },
   { name: "trial_config", type_id: "ent_230", maturity: "stable", since: "0.1.0" },
@@ -1192,8 +1202,22 @@ var UPG_EDGE_CATALOG = {
   // `evolved_from` in the reverse lets a feature trace its solution ancestry.
   solution_becomes_feature: { forward_verb: "becomes", reverse_verb: "evolved_from", classification: "causal", source_type: "solution", target_type: "feature" },
   hypothesis_requires_experiment_plan: { forward_verb: "requires", reverse_verb: "planned_for", classification: "causal", source_type: "hypothesis", target_type: "experiment_plan" },
-  hypothesis_planned_via_test_plan: { forward_verb: "planned_via", reverse_verb: "plans_for", classification: "hierarchy", source_type: "hypothesis", target_type: "test_plan" },
+  // (UPG-664) V4: close the stable canonical loop directly on `experiment`.
+  // Before this, resolve_edge_for_pair(hypothesis, experiment) and the reverse
+  // were both null — the stable experiment could not attach to the hypothesis
+  // it tests without adopting the proposed run type.
+  hypothesis_tested_by_experiment: { forward_verb: "tested_by", reverse_verb: "tests", classification: "causal", source_type: "hypothesis", target_type: "experiment" },
+  experiment_validates_hypothesis: { forward_verb: "validates", reverse_verb: "validated_by", classification: "causal", source_type: "experiment", target_type: "hypothesis" },
   hypothesis_investigated_via_research_plan: { forward_verb: "investigated_via", reverse_verb: "investigates", classification: "hierarchy", source_type: "hypothesis", target_type: "research_plan" },
+  // (UPG-678) V8: a research insight can seed a hypothesis directly. The region
+  // says validation consumes `insight` from user_research, but the only paths
+  // in were via solution/learning/assumption.
+  insight_generates_hypothesis: { forward_verb: "generates", reverse_verb: "generated_from", classification: "cross-domain", source_type: "insight", target_type: "hypothesis" },
+  // (UPG-678) V7: the validation-side research plan is conducted as the
+  // user_research-side research study. Both sit in the
+  // discovery_research_validation region but had no connecting edge; the plan
+  // jumped straight to `participant`, bypassing the study container.
+  research_plan_conducted_as_research_study: { forward_verb: "conducted_as", reverse_verb: "conducts", classification: "cross-domain", source_type: "research_plan", target_type: "research_study" },
   experiment_run_produces_learning: { forward_verb: "produces", reverse_verb: "learned_from", classification: "causal", source_type: "experiment_run", target_type: "learning" },
   experiment_run_yields_evidence: { forward_verb: "yields", reverse_verb: "supports", classification: "causal", source_type: "experiment_run", target_type: "evidence" },
   // (v0.2.7 closure) the legacy duplicate pair
@@ -1227,7 +1251,11 @@ var UPG_EDGE_CATALOG = {
   // canonical edge, not a foreign-key property (the v0.2.6 ExperimentPlan
   // interface left this slot pending in line with the principle).
   experiment_plan_targets_metric: { forward_verb: "targets", reverse_verb: "targeted_by_plan", classification: "cross-domain", source_type: "experiment_plan", target_type: "metric" },
-  experiment_has_plan: { forward_verb: "has_plan", reverse_verb: "is_plan_for", classification: "hierarchy", source_type: "experiment", target_type: "experiment_plan" },
+  // (UPG-664) The validation plan designs the experiment it produces. This
+  // replaces the backwards `experiment_has_plan` (experiment → experiment_plan):
+  // the chain now reads hypothesis → experiment_plan → experiment → experiment_run,
+  // with experiment_plan the owning parent of experiment.
+  experiment_plan_designs_experiment: { forward_verb: "designs", reverse_verb: "designed_by", classification: "hierarchy", source_type: "experiment_plan", target_type: "experiment" },
   experiment_executed_as_experiment_run: { forward_verb: "executed_as", reverse_verb: "execution_of", classification: "hierarchy", source_type: "experiment", target_type: "experiment_run" },
   experiment_produces_learning: { forward_verb: "produces", reverse_verb: "produced_by", classification: "causal", source_type: "experiment", target_type: "learning" },
   experiment_produces_evidence: { forward_verb: "produces", reverse_verb: "produced_by", classification: "causal", source_type: "experiment", target_type: "evidence" },
@@ -1352,11 +1380,15 @@ var UPG_EDGE_CATALOG = {
   product_holds_assumption: { forward_verb: "holds", reverse_verb: "held_by", classification: "semantic", source_type: "product", target_type: "assumption" },
   product_measures_with_metric: { forward_verb: "measures_with", reverse_verb: "measures", classification: "hierarchy", source_type: "product", target_type: "metric" },
   outcome_measured_by_metric: { forward_verb: "measured_by", reverse_verb: "measures", classification: "hierarchy", source_type: "outcome", target_type: "metric" },
-  outcome_tracked_by_metric: { forward_verb: "tracked_by", reverse_verb: "tracks", classification: "hierarchy", source_type: "outcome", target_type: "metric" },
+  // (UPG-677) outcome_tracked_by_metric retired — near-synonym of
+  // outcome_measured_by_metric (the kept canonical key). Captain's lean =
+  // collapse. See UPG_EDGE_MIGRATIONS['0.9.9'].
   objective_achieved_through_key_result: { forward_verb: "achieved_through", reverse_verb: "achieves", classification: "hierarchy", source_type: "objective", target_type: "key_result" },
   objective_measured_by_metric: { forward_verb: "measured_by", reverse_verb: "measures", classification: "hierarchy", source_type: "objective", target_type: "metric" },
   key_result_quantified_by_metric: { forward_verb: "quantified_by", reverse_verb: "quantifies", classification: "hierarchy", source_type: "key_result", target_type: "metric" },
-  key_result_tracked_by_metric: { forward_verb: "tracked_by", reverse_verb: "tracks", classification: "hierarchy", source_type: "key_result", target_type: "metric" },
+  // (UPG-677) key_result_tracked_by_metric retired — near-synonym of
+  // key_result_quantified_by_metric (the kept canonical key). Captain's lean =
+  // collapse. See UPG_EDGE_MIGRATIONS['0.9.9'].
   vision_realised_through_mission: { forward_verb: "realised_through", reverse_verb: "realises", classification: "hierarchy", source_type: "vision", target_type: "mission" },
   mission_supported_by_strategic_pillar: { forward_verb: "supported_by", reverse_verb: "supports", classification: "hierarchy", source_type: "mission", target_type: "strategic_pillar" },
   strategic_pillar_organises_strategic_theme: { forward_verb: "organises", reverse_verb: "organised_by", classification: "hierarchy", source_type: "strategic_pillar", target_type: "strategic_theme" },
@@ -1380,17 +1412,20 @@ var UPG_EDGE_CATALOG = {
   // make them measurable. Direct link means a dashboard can surface KRs next
   // to the theme without traversing objective.
   //
-  // `objective_rolls_up_to_strategic_theme`: the OKR containment edge.
+  // `strategic_theme_contains_objective`: the OKR containment edge (UPG-676,
+  // renamed from the malformed `objective_rolls_up_to_strategic_theme`).
   // an objective is the specific quarterly bet *within* a theme. strategic_theme
   // is the broader multi-quarter focus area; objective is subordinate.
   // Direction: strategic_theme → objective (parent → child, per UPG hierarchy
-  // convention where source is the parent). The reverse verb `rolls_up_to`
+  // convention where source is the parent). The key now reads source-first
+  // (strategic_theme), the forward verb is the clean `contains` (was the
+  // malformed `contains_objective`), and the reverse verb `rolls_up_to`
   // surfaces the upward-rollup read. Mirrors `strategic_pillar_organises_
   // strategic_theme` (pillar → theme), completing the strategic cascade:
   // strategic_pillar → strategic_theme → objective → key_result.
   strategic_theme_delivers_outcome: { forward_verb: "delivers", reverse_verb: "delivered_by", classification: "causal", source_type: "strategic_theme", target_type: "outcome" },
   strategic_theme_measured_by_key_result: { forward_verb: "measured_by", reverse_verb: "measures", classification: "causal", source_type: "strategic_theme", target_type: "key_result" },
-  objective_rolls_up_to_strategic_theme: { forward_verb: "contains_objective", reverse_verb: "rolls_up_to", classification: "hierarchy", source_type: "strategic_theme", target_type: "objective" },
+  strategic_theme_contains_objective: { forward_verb: "contains", reverse_verb: "rolls_up_to", classification: "hierarchy", source_type: "strategic_theme", target_type: "objective" },
   initiative_assumes_assumption: { forward_verb: "assumes", reverse_verb: "assumed_by", classification: "hierarchy", source_type: "initiative", target_type: "assumption" },
   initiative_drives_outcome: { forward_verb: "drives", reverse_verb: "driven_by", classification: "cross-domain", source_type: "initiative", target_type: "outcome" },
   capability_enables_value_stream: { forward_verb: "enables", reverse_verb: "enabled_by", classification: "cross-domain", source_type: "capability", target_type: "value_stream" },
@@ -1695,7 +1730,9 @@ var UPG_EDGE_CATALOG = {
   threat_model_surfaces_vulnerability: { forward_verb: "surfaces", reverse_verb: "surfaced_by", classification: "hierarchy", source_type: "threat_model", target_type: "vulnerability" },
   product_enforces_security_control: { forward_verb: "enforces", reverse_verb: "enforced_by", classification: "hierarchy", source_type: "product", target_type: "security_control" },
   product_governed_by_security_policy: { forward_verb: "governed_by", reverse_verb: "governs", classification: "hierarchy", source_type: "product", target_type: "security_policy" },
-  product_experiences_incident_hierarchy: { forward_verb: "experiences", reverse_verb: "affects", classification: "hierarchy", source_type: "product", target_type: "incident" },
+  // (UPG-677) product_experiences_incident_hierarchy retired — byte-identical
+  // shadow of product_experiences_incident (the clean key). See
+  // UPG_EDGE_MIGRATIONS['0.9.9'].
   product_tested_by_penetration_test: { forward_verb: "tested_by", reverse_verb: "tests", classification: "hierarchy", source_type: "product", target_type: "penetration_test" },
   product_reviewed_by_security_review: { forward_verb: "reviewed_by", reverse_verb: "reviews", classification: "hierarchy", source_type: "product", target_type: "security_review" },
   product_classifies_data_with_data_classification: { forward_verb: "classifies_data_with", reverse_verb: "classifies_data_for", classification: "hierarchy", source_type: "product", target_type: "data_classification" },
@@ -1716,6 +1753,12 @@ var UPG_EDGE_CATALOG = {
   vulnerability_discovered_by_penetration_test: { forward_verb: "discovered_by", reverse_verb: "discovers", classification: "cross-domain", source_type: "vulnerability", target_type: "penetration_test" },
   data_classification_applies_to_data_source: { forward_verb: "applies_to", reverse_verb: "classified_by", classification: "cross-domain", source_type: "data_classification", target_type: "data_source" },
   // 3.4 Quality Assurance & Testing Domain
+  // (UPG-678) test_plan re-homed validation → QA. It is the QA planning layer:
+  // the product owns its test plans; each plan is carried out by the suites it
+  // groups and specifies the environments it exercises.
+  product_plans_qa_via_test_plan: { forward_verb: "plans_qa_via", reverse_verb: "plans_qa_for", classification: "hierarchy", source_type: "product", target_type: "test_plan" },
+  test_plan_executed_by_test_suite: { forward_verb: "executed_by", reverse_verb: "executes", classification: "hierarchy", source_type: "test_plan", target_type: "test_suite" },
+  test_plan_specifies_test_environment: { forward_verb: "specifies", reverse_verb: "specified_by", classification: "hierarchy", source_type: "test_plan", target_type: "test_environment" },
   product_maintains_test_suite: { forward_verb: "maintains", reverse_verb: "maintained_by", classification: "hierarchy", source_type: "product", target_type: "test_suite" },
   test_suite_contains_test_case: { forward_verb: "contains", reverse_verb: "belongs_to", classification: "hierarchy", source_type: "test_suite", target_type: "test_case" },
   product_undergoes_qa_session: { forward_verb: "undergoes", reverse_verb: "conducted_on", classification: "hierarchy", source_type: "product", target_type: "qa_session" },
@@ -1747,7 +1790,12 @@ var UPG_EDGE_CATALOG = {
   a11y_audit_covers_feature: { forward_verb: "covers", reverse_verb: "covered_by", classification: "cross-domain", source_type: "a11y_audit", target_type: "feature" },
   // 3.6 AI/ML Operations Domain
   product_powered_by_ai_model: { forward_verb: "powered_by", reverse_verb: "powers", classification: "hierarchy", source_type: "product", target_type: "ai_model" },
-  ai_model_prompted_via_prompt_version: { forward_verb: "prompted_via", reverse_verb: "prompts", classification: "hierarchy", source_type: "ai_model", target_type: "prompt_version" },
+  // (UPG-665) The prompt abstraction is corrected to ai_model → prompt_template
+  // → prompt_version. The model defines templates; each template contains its
+  // versions. This replaces the inverted ai_model → prompt_version ownership
+  // and the backwards prompt_version → prompt_template edge.
+  ai_model_defines_prompt_template: { forward_verb: "defines", reverse_verb: "defined_by", classification: "hierarchy", source_type: "ai_model", target_type: "prompt_template" },
+  prompt_template_contains_prompt_version: { forward_verb: "contains", reverse_verb: "version_of", classification: "hierarchy", source_type: "prompt_template", target_type: "prompt_version" },
   ai_model_benchmarked_by_eval_benchmark: { forward_verb: "benchmarked_by", reverse_verb: "benchmarks", classification: "hierarchy", source_type: "ai_model", target_type: "eval_benchmark" },
   eval_benchmark_executed_as_eval_run: { forward_verb: "executed_as", reverse_verb: "executes", classification: "hierarchy", source_type: "eval_benchmark", target_type: "eval_run" },
   ai_model_costed_by_ai_cost_tracker: { forward_verb: "costed_by", reverse_verb: "costs", classification: "hierarchy", source_type: "ai_model", target_type: "ai_cost_tracker" },
@@ -1755,7 +1803,10 @@ var UPG_EDGE_CATALOG = {
   ai_model_constrained_by_ai_guardrail: { forward_verb: "constrained_by", reverse_verb: "constrains", classification: "hierarchy", source_type: "ai_model", target_type: "ai_guardrail" },
   product_compared_via_model_comparison: { forward_verb: "compared_via", reverse_verb: "compares", classification: "hierarchy", source_type: "product", target_type: "model_comparison" },
   ai_model_compared_in_model_comparison: { forward_verb: "compared_in", reverse_verb: "compares", classification: "hierarchy", source_type: "ai_model", target_type: "model_comparison" },
-  prompt_version_evolves_prompt_template: { forward_verb: "evolves", reverse_verb: "evolved_by", classification: "cross-domain", source_type: "prompt_version", target_type: "prompt_template" },
+  // (UPG-665, AI-10) prompt_version self-ordering: track iteration order with a
+  // real edge, not just a string property — the domain's own anti-pattern is
+  // "version prompts like code".
+  prompt_version_supersedes_prompt_version: { forward_verb: "supersedes", reverse_verb: "superseded_by", classification: "semantic", source_type: "prompt_version", target_type: "prompt_version" },
   eval_benchmark_measures_feature: { forward_verb: "measures", reverse_verb: "measured_by", classification: "cross-domain", source_type: "eval_benchmark", target_type: "feature" },
   ai_guardrail_enforces_security_policy: { forward_verb: "enforces", reverse_verb: "enforced_by", classification: "cross-domain", source_type: "ai_guardrail", target_type: "security_policy" },
   model_comparison_informs_decision: { forward_verb: "informs", reverse_verb: "informed_by", classification: "cross-domain", source_type: "model_comparison", target_type: "decision" },
@@ -1763,6 +1814,18 @@ var UPG_EDGE_CATALOG = {
   ai_model_evaluated_through_ai_experiment: { forward_verb: "evaluated_through", reverse_verb: "evaluates", classification: "hierarchy", source_type: "ai_model", target_type: "ai_experiment" },
   ai_model_trained_on_ai_dataset: { forward_verb: "trained_on", reverse_verb: "trains", classification: "hierarchy", source_type: "ai_model", target_type: "ai_dataset" },
   ai_model_produces_ai_trace: { forward_verb: "produces", reverse_verb: "produced_by", classification: "causal", source_type: "ai_model", target_type: "ai_trace" },
+  // (UPG-665) Observability bridges — turn four sinks into wired evidence and
+  // close the Model Evaluation Loop.
+  // AI-3: an eval_run can reach the model and prompt version it judged.
+  eval_run_evaluates_ai_model: { forward_verb: "evaluates", reverse_verb: "evaluated_by", classification: "cross-domain", source_type: "eval_run", target_type: "ai_model" },
+  eval_run_scores_prompt_version: { forward_verb: "scores", reverse_verb: "scored_by", classification: "cross-domain", source_type: "eval_run", target_type: "prompt_version" },
+  // AI-5: a hallucination_report reaches the trace that produced it and its root cause.
+  hallucination_report_traces_to_ai_trace: { forward_verb: "traces_to", reverse_verb: "traced_by", classification: "cross-domain", source_type: "hallucination_report", target_type: "ai_trace" },
+  hallucination_report_caused_by_root_cause: { forward_verb: "caused_by", reverse_verb: "causes", classification: "cross-domain", source_type: "hallucination_report", target_type: "root_cause" },
+  // AI-6: an ai_trace reaches the prompt version it executed.
+  ai_trace_executed_prompt_version: { forward_verb: "executed", reverse_verb: "executed_in", classification: "cross-domain", source_type: "ai_trace", target_type: "prompt_version" },
+  // AI-4/AI-11: an ai_dataset carries provenance to its data source.
+  ai_dataset_sourced_from_data_source: { forward_verb: "sourced_from", reverse_verb: "sources", classification: "cross-domain", source_type: "ai_dataset", target_type: "data_source" },
   // 3.7 Agentic Workflows & Process Domain
   product_automated_via_workflow_template: { forward_verb: "automated_via", reverse_verb: "automates", classification: "hierarchy", source_type: "product", target_type: "workflow_template" },
   workflow_template_executed_as_workflow_run: { forward_verb: "executed_as", reverse_verb: "executes", classification: "hierarchy", source_type: "workflow_template", target_type: "workflow_run" },
@@ -1800,7 +1863,9 @@ var UPG_EDGE_CATALOG = {
   // variant is owned by growth_campaign in the hierarchy; experiments
   // test them via a semantic relationship.
   experiment_run_tests_variant: { forward_verb: "tests", reverse_verb: "tested_in", classification: "semantic", source_type: "experiment_run", target_type: "variant" },
-  metric_decomposed_into_metric: { forward_verb: "decomposed_into", reverse_verb: "rolls_up_to", classification: "hierarchy", source_type: "metric", target_type: "metric" },
+  // (UPG-677) metric_decomposed_into_metric retired — tense-twin of
+  // metric_decomposes_into_metric (the active-voice canonical key). See
+  // UPG_EDGE_MIGRATIONS['0.9.9'].
   metric_drives_metric: { forward_verb: "drives", reverse_verb: "driven_by", classification: "causal", source_type: "metric", target_type: "metric" },
   funnel_step_reveals_need: { forward_verb: "reveals", reverse_verb: "visible_in", classification: "cross-domain", source_type: "funnel_step", target_type: "need" },
   funnel_step_tracks_event_schema: { forward_verb: "tracks", reverse_verb: "fires_in", classification: "cross-domain", source_type: "funnel_step", target_type: "event_schema" },
@@ -1829,7 +1894,11 @@ var UPG_EDGE_CATALOG = {
   business_model_requires_key_resource: { forward_verb: "requires", reverse_verb: "required_by", classification: "hierarchy", source_type: "business_model", target_type: "key_resource" },
   business_model_performs_key_activity: { forward_verb: "performs", reverse_verb: "performed_by", classification: "hierarchy", source_type: "business_model", target_type: "key_activity" },
   business_model_targets_market_segment: { forward_verb: "targets", reverse_verb: "targeted_by", classification: "cross-domain", source_type: "business_model", target_type: "market_segment" },
-  business_model_reaches_via_distribution_channel: { forward_verb: "reaches_via", reverse_verb: "reaches_for", classification: "hierarchy", source_type: "business_model", target_type: "distribution_channel" },
+  // (UPG-677) business_model_reaches_via_distribution_channel retired —
+  // near-synonym of business_model_distributes_via_distribution_channel (the
+  // kept canonical key; "distributes_via" is the Business Model Canvas Channels
+  // verb). FLAG: Captain has not separately confirmed this collapse. See
+  // UPG_EDGE_MIGRATIONS['0.9.9'].
   business_model_maintains_customer_relationship: { forward_verb: "maintains", reverse_verb: "maintained_by", classification: "hierarchy", source_type: "business_model", target_type: "customer_relationship" },
   business_model_distributes_via_distribution_channel: { forward_verb: "distributes_via", reverse_verb: "distributes_for", classification: "hierarchy", source_type: "business_model", target_type: "distribution_channel" },
   revenue_stream_tiered_as_pricing_tier: { forward_verb: "tiered_as", reverse_verb: "tiers", classification: "hierarchy", source_type: "revenue_stream", target_type: "pricing_tier" },
@@ -1851,7 +1920,9 @@ var UPG_EDGE_CATALOG = {
   // as a `need` with `valence='pain'`; link each pain the proposition
   // relieves structurally.
   value_proposition_solves_need: { forward_verb: "solves", reverse_verb: "solved_by", classification: "cross-domain", source_type: "value_proposition", target_type: "need" },
-  value_proposition_targets_persona_cross_domain: { forward_verb: "targets", reverse_verb: "targeted_by", classification: "cross-domain", source_type: "value_proposition", target_type: "persona" },
+  // (UPG-677) value_proposition_targets_persona_cross_domain retired —
+  // byte-identical shadow of value_proposition_targets_persona (the clean key).
+  // See UPG_EDGE_MIGRATIONS['0.9.9'].
   revenue_stream_drives_metric: { forward_verb: "drives", reverse_verb: "driven_by", classification: "cross-domain", source_type: "revenue_stream", target_type: "metric" },
   // Ring 5 structural edges
   // (UPG-668, P-I) These three edges name `funnel_step` but were typed against
@@ -1995,7 +2066,9 @@ var UPG_EDGE_CATALOG = {
   customer_feedback_reveals_churn_reason: { forward_verb: "reveals", reverse_verb: "revealed_by", classification: "hierarchy", source_type: "customer_feedback", target_type: "churn_reason" },
   user_flow_contains_customer_journey_stage: { forward_verb: "contains", reverse_verb: "belongs_to", classification: "hierarchy", source_type: "user_flow", target_type: "customer_journey_stage" },
   customer_journey_stage_contains_touchpoint: { forward_verb: "contains", reverse_verb: "belongs_to", classification: "hierarchy", source_type: "customer_journey_stage", target_type: "touchpoint" },
-  support_ticket_reveals_need: { forward_verb: "reveals", reverse_verb: "revealed_by_ticket", classification: "cross-domain", source_type: "support_ticket", target_type: "need" },
+  // (UPG-677) reverse_verb normalised revealed_by_ticket → revealed_by when the
+  // support_ticket_reveals_need_cross_domain twin was collapsed into this clean key.
+  support_ticket_reveals_need: { forward_verb: "reveals", reverse_verb: "revealed_by", classification: "cross-domain", source_type: "support_ticket", target_type: "need" },
   customer_feedback_creates_observation: { forward_verb: "creates", reverse_verb: "created_from_feedback", classification: "cross-domain", source_type: "customer_feedback", target_type: "observation" },
   churn_reason_generates_hypothesis: { forward_verb: "generates", reverse_verb: "generated_from_churn", classification: "cross-domain", source_type: "churn_reason", target_type: "hypothesis" },
   user_flow_maps_user_journey: { forward_verb: "maps", reverse_verb: "mapped_by", classification: "cross-domain", source_type: "user_flow", target_type: "user_journey" },
@@ -2007,14 +2080,18 @@ var UPG_EDGE_CATALOG = {
   customer_health_score_informs_playbook: { forward_verb: "informs", reverse_verb: "informed_by_health_score", classification: "cross-domain", source_type: "customer_health_score", target_type: "playbook" },
   customer_feedback_becomes_feature_request: { forward_verb: "becomes", reverse_verb: "originated_from", classification: "cross-domain", source_type: "customer_feedback", target_type: "feature_request" },
   support_ticket_reports_bug: { forward_verb: "reports", reverse_verb: "reported_by", classification: "cross-domain", source_type: "support_ticket", target_type: "bug" },
-  support_ticket_reveals_need_cross_domain: { forward_verb: "reveals", reverse_verb: "revealed_by", classification: "cross-domain", source_type: "support_ticket", target_type: "need" },
+  // (UPG-677) support_ticket_reveals_need_cross_domain retired — near-duplicate
+  // of support_ticket_reveals_need (the clean key, whose reverse_verb is now
+  // revealed_by). See UPG_EDGE_MIGRATIONS['0.9.9'].
   churn_reason_reveals_need: { forward_verb: "reveals", reverse_verb: "revealed_by", classification: "cross-domain", source_type: "churn_reason", target_type: "need" },
   // 5.2 Content & Knowledge Domain
   product_publishes_content_piece: { forward_verb: "publishes", reverse_verb: "published_by", classification: "hierarchy", source_type: "product", target_type: "content_piece" },
   product_documents_in_knowledge_base_article: { forward_verb: "documents_in", reverse_verb: "documented_by", classification: "hierarchy", source_type: "product", target_type: "knowledge_base_article" },
   product_expressed_via_brand_asset: { forward_verb: "expressed_via", reverse_verb: "expresses", classification: "hierarchy", source_type: "product", target_type: "brand_asset" },
   product_documented_in_document: { forward_verb: "documented_in", reverse_verb: "documents", classification: "hierarchy", source_type: "product", target_type: "document" },
-  product_prompted_via_prompt_template: { forward_verb: "prompted_via", reverse_verb: "prompts", classification: "hierarchy", source_type: "product", target_type: "prompt_template" },
+  // (UPG-665) product_prompted_via_prompt_template retired — prompt_template
+  // re-parented product → ai_model (ai_model_defines_prompt_template). See
+  // UPG_EDGE_MIGRATIONS['0.9.9'].
   product_templated_via_documentation_template: { forward_verb: "templated_via", reverse_verb: "templates", classification: "hierarchy", source_type: "product", target_type: "documentation_template" },
   product_records_in_document: { forward_verb: "records_in", reverse_verb: "records", classification: "hierarchy", source_type: "product", target_type: "document" },
   content_strategy_scheduled_in_content_calendar: { forward_verb: "scheduled_in", reverse_verb: "schedules", classification: "hierarchy", source_type: "content_strategy", target_type: "content_calendar" },
@@ -2024,12 +2101,19 @@ var UPG_EDGE_CATALOG = {
   content_calendar_schedules_knowledge_base_article: { forward_verb: "schedules", reverse_verb: "scheduled_in", classification: "hierarchy", source_type: "content_calendar", target_type: "knowledge_base_article" },
   content_calendar_schedules_brand_asset: { forward_verb: "schedules", reverse_verb: "scheduled_in", classification: "hierarchy", source_type: "content_calendar", target_type: "brand_asset" },
   content_calendar_schedules_document: { forward_verb: "schedules", reverse_verb: "scheduled_in", classification: "hierarchy", source_type: "content_calendar", target_type: "document" },
-  content_calendar_schedules_prompt_template: { forward_verb: "schedules", reverse_verb: "scheduled_in", classification: "hierarchy", source_type: "content_calendar", target_type: "prompt_template" },
+  // (UPG-665) content_calendar_schedules_prompt_template retired — prompt_template
+  // re-homed to the ai_model containment tree (it is an AI artefact, not a
+  // content-calendar-scheduled item). See UPG_EDGE_MIGRATIONS['0.9.9'].
   content_calendar_schedules_documentation_template: { forward_verb: "schedules", reverse_verb: "scheduled_in", classification: "hierarchy", source_type: "content_calendar", target_type: "documentation_template" },
   content_piece_supports_messaging: { forward_verb: "supports", reverse_verb: "supported_by", classification: "cross-domain", source_type: "content_piece", target_type: "messaging" },
   content_piece_part_of_growth_campaign: { forward_verb: "part_of", reverse_verb: "includes", classification: "cross-domain", source_type: "content_piece", target_type: "growth_campaign" },
   knowledge_base_article_documents_feature: { forward_verb: "documents", reverse_verb: "documented_by", classification: "cross-domain", source_type: "knowledge_base_article", target_type: "feature" },
-  changelog_documents_release: { forward_verb: "documents", reverse_verb: "documented_in", classification: "cross-domain", source_type: "changelog", target_type: "release" },
+  // (UPG-677) changelog_documents_release retired — inverse of the containment
+  // edge release_documented_in_changelog (release → changelog, matching the
+  // hierarchy release: ['changelog']). The "changelog documents release" read is
+  // preserved by that edge's reverse_verb (documents). FLAG: this is the only
+  // inverse pair collapsed; feature↔bug is kept (distinct classification +
+  // semantic). See UPG_EDGE_MIGRATIONS['0.9.9'].
   prompt_template_powers_feature: { forward_verb: "powers", reverse_verb: "powered_by", classification: "cross-domain", source_type: "prompt_template", target_type: "feature" },
   content_theme_targets_persona: { forward_verb: "targets", reverse_verb: "targeted_by", classification: "cross-domain", source_type: "content_theme", target_type: "persona" },
   // v0.7.2 (UPG-571 §1): topic-cluster / content-pillar model; themes organize pieces. Connects the isolated `content_theme` AND `content_piece` members.
@@ -2065,7 +2149,9 @@ var UPG_EDGE_CATALOG = {
   // 6.1 Team & Organisation Domain
   product_staffed_by_team: { forward_verb: "staffed_by", reverse_verb: "staffs", classification: "hierarchy", source_type: "product", target_type: "team" },
   product_influenced_by_stakeholder: { forward_verb: "influenced_by", reverse_verb: "influences", classification: "hierarchy", source_type: "product", target_type: "stakeholder" },
-  product_decided_via_decision_hierarchy: { forward_verb: "decided_via", reverse_verb: "decides", classification: "hierarchy", source_type: "product", target_type: "decision" },
+  // (UPG-677) product_decided_via_decision_hierarchy retired — duplicate of
+  // product_decided_via_decision (the clean key). See
+  // UPG_EDGE_MIGRATIONS['0.9.9'].
   product_organised_into_department: { forward_verb: "organised_into", reverse_verb: "organises", classification: "hierarchy", source_type: "product", target_type: "department" },
   department_contains_team: { forward_verb: "contains", reverse_verb: "belongs_to", classification: "hierarchy", source_type: "department", target_type: "team" },
   department_includes_stakeholder: { forward_verb: "includes", reverse_verb: "included_in", classification: "hierarchy", source_type: "department", target_type: "stakeholder" },
@@ -2169,7 +2255,9 @@ var UPG_EDGE_CATALOG = {
   dashboard_contains_report: { forward_verb: "contains", reverse_verb: "belongs_to", classification: "hierarchy", source_type: "dashboard", target_type: "report" },
   dashboard_contains_experiment_run: { forward_verb: "contains", reverse_verb: "belongs_to", classification: "hierarchy", source_type: "dashboard", target_type: "experiment_run" },
   metric_measures_metric: { forward_verb: "measures", reverse_verb: "measured_by", classification: "cross-domain", source_type: "metric", target_type: "metric" },
-  metric_measures_metric_cross_domain: { forward_verb: "measures", reverse_verb: "measured_by", classification: "cross-domain", source_type: "metric", target_type: "metric" },
+  // (UPG-677) metric_measures_metric_cross_domain retired — byte-identical
+  // shadow of metric_measures_metric (the clean key). See
+  // UPG_EDGE_MIGRATIONS['0.9.9'].
   // `experiment_tests_hypothesis` dropped, superseded by
   // the canonical `experiment_run_validates_hypothesis` (causal) introduced
   // in v0.2.6. Authors expressing "this experiment tests this hypothesis"
@@ -2191,7 +2279,11 @@ var UPG_EDGE_CATALOG = {
   product_area_contains_product_area: { forward_verb: "contains", reverse_verb: "belongs_to", classification: "hierarchy", source_type: "product_area", target_type: "product_area" },
   // decision B: product_area groups features (the natural "Studio area owns 6 features" mental model)
   product_area_contains_feature: { forward_verb: "contains", reverse_verb: "belongs_to", classification: "hierarchy", source_type: "product_area", target_type: "feature" },
-  product_categorised_in_product_area: { forward_verb: "categorised_in", reverse_verb: "categorises", classification: "hierarchy", source_type: "product", target_type: "product_area" },
+  // (UPG-677) product_categorised_in_product_area retired — inverse of
+  // product_area_contains_product (the kept containment direction:
+  // product_area → product, matching the UPG parent→child convention). FLAG:
+  // the inverse "product categorised in area" read is preserved by the kept
+  // edge's reverse_verb (belongs_to). See UPG_EDGE_MIGRATIONS['0.9.9'].
   // 8.2 Cross-Product Edges
   // direct product-level shorthand edges for market-intelligence shapes.
   // These are shortcuts: canonical deep paths go via competitive_analysis and gtm_strategy.
@@ -2255,7 +2347,9 @@ var UPG_EDGE_CATALOG = {
   insight_reveals_desired_outcome: { forward_verb: "reveals", reverse_verb: "revealed_by", classification: "cross-domain", source_type: "insight", target_type: "desired_outcome" },
   insight_informs_job: { forward_verb: "informs", reverse_verb: "informed_by", classification: "cross-domain", source_type: "insight", target_type: "job" },
   insight_characterises_persona: { forward_verb: "characterises", reverse_verb: "characterised_by", classification: "cross-domain", source_type: "insight", target_type: "persona" },
-  insight_validates_need_cross_domain: { forward_verb: "validates", reverse_verb: "validated_by", classification: "cross-domain", source_type: "insight", target_type: "need" },
+  // (UPG-677) insight_validates_need_cross_domain retired — byte-identical
+  // shadow of insight_validates_need (the clean key). See
+  // UPG_EDGE_MIGRATIONS['0.9.9'].
   observation_reveals_need: { forward_verb: "reveals", reverse_verb: "revealed_by", classification: "cross-domain", source_type: "observation", target_type: "need" },
   observation_characterises_persona: { forward_verb: "characterises", reverse_verb: "characterised_by", classification: "cross-domain", source_type: "observation", target_type: "persona" },
   quote_evidences_need: { forward_verb: "evidences", reverse_verb: "evidenced_by", classification: "cross-domain", source_type: "quote", target_type: "need" },
@@ -2269,7 +2363,9 @@ var UPG_EDGE_CATALOG = {
   insight_inspires_design_concept: { forward_verb: "inspires", reverse_verb: "inspired_by", classification: "cross-domain", source_type: "insight", target_type: "design_concept" },
   observation_yields_insight: { forward_verb: "yields", reverse_verb: "yielded_by", classification: "cross-domain", source_type: "observation", target_type: "insight" },
   insight_refines_into_insight: { forward_verb: "refines_into", reverse_verb: "refined_from", classification: "hierarchy", source_type: "insight", target_type: "insight" },
-  insight_informs_opportunity_cross_domain: { forward_verb: "informs", reverse_verb: "informed_by", classification: "cross-domain", source_type: "insight", target_type: "opportunity" },
+  // (UPG-677) insight_informs_opportunity_cross_domain retired — byte-identical
+  // shadow of insight_informs_opportunity (the clean key). See
+  // UPG_EDGE_MIGRATIONS['0.9.9'].
   insight_validates_persona: { forward_verb: "validates", reverse_verb: "validated_by", classification: "cross-domain", source_type: "insight", target_type: "persona" },
   // Validation-to-Discovery Feedback Loops
   learning_validates_opportunity: { forward_verb: "validates", reverse_verb: "validated_by", classification: "cross-domain", source_type: "learning", target_type: "opportunity" },
@@ -2327,7 +2423,9 @@ var UPG_EDGE_CATALOG = {
   customer_health_score_composed_of_metric: { forward_verb: "composed_of", reverse_verb: "composes", classification: "cross-domain", source_type: "customer_health_score", target_type: "metric" },
   service_level_agreement_measures_metric: { forward_verb: "measures", reverse_verb: "measured_by", classification: "cross-domain", source_type: "service_level_agreement", target_type: "metric" },
   // Content
-  prompt_template_targets_ai_model: { forward_verb: "targets", reverse_verb: "targeted_by", classification: "cross-domain", source_type: "prompt_template", target_type: "ai_model" },
+  // (UPG-665) prompt_template_targets_ai_model retired — superseded by the
+  // containment edge ai_model_defines_prompt_template (the model owns its
+  // templates). See UPG_EDGE_MIGRATIONS['0.9.9'].
   // Education
   education_program_targets_persona: { forward_verb: "targets", reverse_verb: "targeted_by", classification: "cross-domain", source_type: "education_program", target_type: "persona" },
   // Programs
@@ -2491,13 +2589,13 @@ var UPG_EDGE_CATALOG = {
   messaging_used_in_launch: { forward_verb: "used_in", reverse_verb: "uses", classification: "cross-domain", source_type: "messaging", target_type: "launch" },
   messaging_enables_sales_motion: { forward_verb: "enables", reverse_verb: "enabled_by", classification: "cross-domain", source_type: "messaging", target_type: "sales_motion" },
   // Test Card + Learning Card (Strategyzer): canonical validation flow
-  // hypothesis → test_plan → experiment_run → evidence → learning → decision.
-  // The catalog already had the hypothesis → test_plan and experiment_run →
-  // {hypothesis, evidence, learning, decision} edges. Missing: the
-  // test_plan ran-as bridge (mirrors `experiment_plan_ran_as_experiment_run`
-  // for the test_plan/test-card pair), the evidence → learning interpretation
-  // step, and the learning → decision commitment step.
-  test_plan_ran_as_experiment_run: { forward_verb: "ran_as", reverse_verb: "ran_for", classification: "hierarchy", source_type: "test_plan", target_type: "experiment_run" },
+  // hypothesis → experiment_plan → experiment → experiment_run → evidence →
+  // learning → decision (UPG-664). The "Test Design" card is the
+  // `experiment_plan`; the plan designs the experiment
+  // (`experiment_plan_designs_experiment`), which is executed as run(s). The
+  // former `test_plan_ran_as_experiment_run` bridge was retired when `test_plan`
+  // re-homed to QA (UPG-678) — see UPG_EDGE_MIGRATIONS['0.9.9']. This block keeps
+  // the evidence → learning interpretation and learning → decision commitment.
   evidence_interpreted_as_learning: { forward_verb: "interpreted_as", reverse_verb: "interpreted_from", classification: "causal", source_type: "evidence", target_type: "learning" },
   learning_informs_decision: { forward_verb: "informs", reverse_verb: "informed_by", classification: "causal", source_type: "learning", target_type: "decision" },
   // Opportunity Canvas: Patton's "Assumptions" slot is meant to capture the
@@ -3223,7 +3321,6 @@ var UPG_VALID_CHILDREN = {
     "knowledge_base_article",
     "brand_asset",
     "document",
-    "prompt_template",
     "documentation_template",
     // Legal
     "legal_entity",
@@ -3256,6 +3353,7 @@ var UPG_VALID_CHILDREN = {
     "a11y_audit",
     "a11y_annotation",
     // Quality Assurance
+    "test_plan",
     "test_suite",
     "qa_session",
     "test_coverage_report",
@@ -3305,7 +3403,10 @@ var UPG_VALID_CHILDREN = {
     "api_ecosystem",
     "developer_portal",
     // Portfolio
-    "product_area",
+    // (UPG-677) product no longer lists product_area as a child: the
+    // product↔product_area containment is the single direction
+    // product_area_contains_product (product_area → product). The inverse
+    // product_categorised_in_product_area edge was collapsed.
     // Workspace
     "workspace"
   ],
@@ -3320,22 +3421,27 @@ var UPG_VALID_CHILDREN = {
   // belief), not the legacy hypothesis type.
   solution: ["hypothesis", "prototype", "metric"],
   // ── Validation hierarchy ────────────────────────────────────────────────────
-  // hypothesis is re-promoted as canonical. hypothesis_evidence
-  // collapsed into evidence; relationship expressed via hypothesis_has_evidence
-  // edge. evidence.direction carries supports/refutes/neutral semantics.
-  hypothesis: ["experiment_plan", "test_plan", "research_plan", "evidence"],
-  // experiment is canonical. It can contain experiment_plan/run
-  // sub-artefacts (the plan/run split is opt-in for finer granularity).
-  experiment: ["experiment_plan", "experiment_run", "learning", "evidence"],
-  experiment_plan: ["experiment_run"],
-  // v0.5.5 (UPG-528 Part 2a): mirrors `experiment_plan_ran_as_experiment_run`
-  // for the Strategyzer Test Card + Learning Card flow. A test plan (the
-  // upfront experiment design captured on the Test Card) runs as one or more
-  // experiment runs that produce evidence and learning.
-  test_plan: ["experiment_run"],
+  // (UPG-664) The validation chain is a single-parent line:
+  //   hypothesis ▷ experiment_plan ▷ experiment ▷ experiment_run.
+  // hypothesis is canonical (hypothesis_evidence collapsed into evidence;
+  // relationship expressed via hypothesis_has_evidence edge; evidence.direction
+  // carries supports/refutes/neutral semantics). `test_plan` re-homed to the
+  // QA/testing domain (UPG-678), so it is no longer a hypothesis child.
+  hypothesis: ["experiment_plan", "research_plan", "evidence"],
+  // experiment_plan is the canonical validation PLAN (graduated stable,
+  // UPG-664). It designs the experiment it produces; the plan owns the
+  // experiment in the containment line. It also retains experiment_run as a
+  // child for the v0.2.6 split-migration path
+  // (`experiment_plan_ran_as_experiment_run`), where a legacy experiment routes
+  // directly to a plan + run pair.
+  experiment_plan: ["experiment", "experiment_run"],
+  // experiment is the canonical structured test. It owns its run(s) and the
+  // learning/evidence it produces. The optional experiment_run child captures
+  // the multi-run / replication case.
+  experiment: ["experiment_run", "learning", "evidence"],
   // experiment_run carries learning/evidence/metric children (run produces
-  // evidence) and self-nests for replications/multi-armed runs that share
-  // a parent plan.
+  // evidence) and self-nests for replications/multi-armed runs (V9: this is
+  // where self-nesting genuinely lives, not on `experiment`).
   experiment_run: ["learning", "evidence", "metric", "experiment_run"],
   // ── OKR hierarchy ──────────────────────────────────────────────────────────
   objective: ["key_result", "metric"],
@@ -3346,8 +3452,9 @@ var UPG_VALID_CHILDREN = {
   strategic_pillar: ["strategic_theme", "capability", "value_stream", "decision"],
   // v0.5.4 (UPG-511): objectives are the specific quarterly bets *within* a
   // strategic theme. The theme is the multi-quarter focus area; objectives are
-  // subordinate. Pairs with `objective_rolls_up_to_strategic_theme` in the edge
-  // catalog (hierarchy, strategic_theme → objective, reverse_verb: rolls_up_to).
+  // subordinate. Pairs with `strategic_theme_contains_objective` in the edge
+  // catalog (hierarchy, strategic_theme → objective, reverse_verb: rolls_up_to;
+  // renamed from objective_rolls_up_to_strategic_theme in UPG-676).
   strategic_theme: ["initiative", "objective"],
   initiative: ["assumption"],
   // v0.5.2 (UPG-528): capability decomposes into sub-capabilities (Wardley
@@ -3527,7 +3634,6 @@ var UPG_VALID_CHILDREN = {
     "knowledge_base_article",
     "brand_asset",
     "document",
-    "prompt_template",
     "documentation_template"
   ],
   // ── Operations & CS hierarchy ────────────────────────────────────────────────
@@ -3632,6 +3738,10 @@ var UPG_VALID_CHILDREN = {
   // a learning_path can include its terminal certification.
   learning_path: ["tutorial", "certification"],
   // ── Quality Assurance & Testing hierarchy ────────────────────────────────────
+  // (UPG-678) test_plan re-homed validation → QA. It is the QA planning layer:
+  // the verification approach (scope, environments, pass criteria) that the
+  // test suites execute. A test_plan groups the suites that carry it out.
+  test_plan: ["test_suite", "test_environment"],
   test_suite: [
     "test_case",
     "regression_test",
@@ -3675,8 +3785,11 @@ var UPG_VALID_CHILDREN = {
     "paywall"
   ],
   // ── AI/ML Operations hierarchy ───────────────────────────────────────────────
+  // (UPG-665) The prompt abstraction is corrected: ai_model → prompt_template →
+  // prompt_version (a model has templates; each template has versions). The
+  // model no longer owns prompt_version directly.
   ai_model: [
-    "prompt_version",
+    "prompt_template",
     "eval_benchmark",
     "ai_cost_tracker",
     "hallucination_report",
@@ -3686,6 +3799,8 @@ var UPG_VALID_CHILDREN = {
     "ai_dataset",
     "ai_trace"
   ],
+  // prompt_template owns its prompt_versions the way a file owns its commits.
+  prompt_template: ["prompt_version"],
   // v0.5.7 (UPG-528 Part 2c): benchmarks define the metric set they measure
   // (HELM, MLPerf, BIG-bench all spec a metric list). metric already has many
   // hierarchy parents (outcome, objective, key_result, solution, data_source).
@@ -7552,22 +7667,18 @@ var UPG_PROPERTY_MIGRATIONS = {
   // graphs typically carry only one of the two; the conflict path is
   // theoretical but documented for predictability.
   "0.2.13": [
-    // 1. Lift properties.stage → status (with value remap to UPGProductStage).
-    {
-      kind: "lift_property_to_top_level",
-      type: "product",
-      from_property: "stage",
-      to: "status",
-      value_map: {
-        // Pre-canonical UPGProductStage aliases from early v0.1 product-node
-        // shape. "idea" was the canonical pre-validation phase before the
-        // 9-stage UPGProductStage shipped; today that's "concept".
-        idea: "concept"
-        // Pass-through: the canonical 9 product stages already exist as
-        // UPGProductStage values and need no remap when surfaced inline.
-      },
-      reason: 'lifecycle phase belongs in top-level `status` per UPGBaseNode contract, not in `properties`. Pre-canonical "idea" alias mapped to canonical `concept` (UPGProductStage[0]).'
-    },
+    // 1. (RETIRED in 0.9.10, batch-6 #33) The product `properties.stage` →
+    //    top-level `status` lift is superseded by UPG-654/661, which
+    //    re-canonicalised a product node's lifecycle stage to
+    //    `properties.stage` — a distinct 9-phase `UPGProductStage` axis,
+    //    separate from the generic top-level `status` other entities use. The
+    //    entire runtime (create_product, get_graph_digest, get_product_context,
+    //    completeness, header-sync) reads and writes `properties.stage`, so
+    //    lifting it to `status` made a freshly-created product read as
+    //    `property_drift` against its own validator (a tool emitting drift its
+    //    validator immediately flags). Legacy "idea"-style values are still
+    //    normalised on READ by `coerceProductStage`, so retiring the lift loses
+    //    no cleanup. Decision: 2026-06-10-product-stage-properties-canonical.md.
     // 2. Rename top-level lifecycle_status → status (with value remap).
     {
       kind: "rename_top_level",
@@ -7944,6 +8055,69 @@ function getSplitMigrations(fromVersion, toVersion) {
   return result;
 }
 var UPG_EDGE_MIGRATIONS = {
+  "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
+    // hypothesis → experiment_plan → experiment → experiment_run, `experiment`
+    // gains its stable hypothesis loop, and `test_plan` re-homes to the QA
+    // domain (its planning role absorbed by `experiment_plan`).
+    //
+    // The plan→experiment containment inverts: the old `experiment_has_plan`
+    // (experiment → experiment_plan, hierarchy) becomes
+    // `experiment_plan_designs_experiment` (experiment_plan → experiment). Flip
+    // swaps endpoints. Endpoint guards reference the post-flip orientation: the
+    // original source (experiment) becomes the new target, the original target
+    // (experiment_plan) becomes the new source.
+    { kind: "rename", from: "experiment_has_plan", to: "experiment_plan_designs_experiment", flip: true, requires_source_type: "experiment", requires_target_type: "experiment_plan", reason: "Validation experiment-model reshape (UPG-664). The plan owns the experiment it designs; the containment direction inverts from experiment \u2192 experiment_plan to experiment_plan \u2192 experiment. Flip swaps endpoints so the surviving edge reads plan-designs-experiment." },
+    // test_plan re-homed validation → QA (UPG-678). Its two validation-side
+    // edges are dropped: a hypothesis no longer plans via a QA test_plan (it
+    // requires an experiment_plan), and the test_plan → experiment_run ran-as
+    // bridge is superseded by the experiment_plan → experiment flow.
+    { kind: "drop", from: "hypothesis_planned_via_test_plan", reason: "test_plan re-homed validation \u2192 QA (UPG-678). A hypothesis no longer plans via test_plan; the validation plan is experiment_plan (hypothesis_requires_experiment_plan)." },
+    { kind: "drop", from: "test_plan_ran_as_experiment_run", reason: "test_plan re-homed validation \u2192 QA (UPG-678). The Strategyzer Test Card flow now runs hypothesis \u2192 experiment_plan \u2192 experiment \u2192 experiment_run; the test_plan \u2192 experiment_run bridge is superseded by experiment_plan_designs_experiment." },
+    // (since v0.9.9, UPG-665) AI prompt-model correction. The prompt abstraction
+    // is inverted to the correct ai_model → prompt_template → prompt_version
+    // containment. The backwards/obsolete edges are dropped, and the
+    // prompt_template → ai_model "targets" relationship is flipped into the new
+    // ai_model → prompt_template ownership.
+    { kind: "rename", from: "prompt_template_targets_ai_model", to: "ai_model_defines_prompt_template", flip: true, requires_source_type: "prompt_template", requires_target_type: "ai_model", reason: 'AI prompt-model correction (UPG-665). The model owns its templates; the prompt_template \u2192 ai_model "targets" edge becomes the ai_model \u2192 prompt_template ownership edge. Flip swaps endpoints so the surviving edge reads model-defines-template.' },
+    { kind: "drop", from: "prompt_version_evolves_prompt_template", reason: "AI prompt-model correction (UPG-665). The backwards prompt_version \u2192 prompt_template edge is retired; prompt_template now contains its versions (prompt_template_contains_prompt_version)." },
+    { kind: "drop", from: "ai_model_prompted_via_prompt_version", reason: "AI prompt-model correction (UPG-665). The model no longer owns prompt_version directly; the chain is ai_model \u2192 prompt_template \u2192 prompt_version." },
+    { kind: "drop", from: "product_prompted_via_prompt_template", reason: "AI prompt-model correction (UPG-665). prompt_template re-parented product \u2192 ai_model (ai_model_defines_prompt_template); the product-level containment is removed." },
+    { kind: "drop", from: "content_calendar_schedules_prompt_template", reason: "AI prompt-model correction (UPG-665). prompt_template re-homed into the ai_model containment tree; it is an AI artefact, not a content-calendar-scheduled item." },
+    // (since v0.9.9, UPG-676) Strategic-theme containment edge rename. The
+    // malformed `objective_rolls_up_to_strategic_theme` (key read object-first
+    // while source_type was strategic_theme; forward_verb was the malformed
+    // `contains_objective`) is renamed to the clean source-first
+    // `strategic_theme_contains_objective`. Endpoints unchanged
+    // (strategic_theme → objective); only the key and forward verb change.
+    { kind: "rename", from: "objective_rolls_up_to_strategic_theme", to: "strategic_theme_contains_objective", requires_source_type: "strategic_theme", requires_target_type: "objective", reason: "Strategic-theme containment edge rename (UPG-676). The key now reads source-first and the forward verb is the clean `contains` (was the malformed `contains_objective`). Endpoints unchanged (strategic_theme \u2192 objective); satisfies the F2 prefix gate." },
+    // (since v0.9.9, UPG-677) Duplicate / shadow edge collapse. Each retired key
+    // is dual-read to the surviving canonical key. Tier 1 = byte-identical
+    // shadows; Tier 2 = tense/suffix twins; Tier 3 = near-synonyms collapsed per
+    // Captain's lean. Inverse pairs flip the direction onto the kept containment
+    // edge. Collapsing these lowers the edge-duplicate gate collision bound.
+    // ── Tier 1: byte-identical shadows ──
+    { kind: "rename", from: "insight_informs_opportunity_cross_domain", to: "insight_informs_opportunity", requires_source_type: "insight", requires_target_type: "opportunity", reason: "Duplicate collapse (UPG-677). Byte-identical shadow of insight_informs_opportunity; the suffixed twin never resolved." },
+    { kind: "rename", from: "product_experiences_incident_hierarchy", to: "product_experiences_incident", requires_source_type: "product", requires_target_type: "incident", reason: "Duplicate collapse (UPG-677). Byte-identical shadow of product_experiences_incident; the suffixed twin never resolved." },
+    { kind: "rename", from: "value_proposition_targets_persona_cross_domain", to: "value_proposition_targets_persona", requires_source_type: "value_proposition", requires_target_type: "persona", reason: "Duplicate collapse (UPG-677). Byte-identical shadow of value_proposition_targets_persona; the suffixed twin never resolved." },
+    { kind: "rename", from: "metric_measures_metric_cross_domain", to: "metric_measures_metric", requires_source_type: "metric", requires_target_type: "metric", reason: "Duplicate collapse (UPG-677). Byte-identical shadow of metric_measures_metric; the suffixed twin never resolved." },
+    { kind: "rename", from: "insight_validates_need_cross_domain", to: "insight_validates_need", requires_source_type: "insight", requires_target_type: "need", reason: "Duplicate collapse (UPG-677). Byte-identical shadow of insight_validates_need; the suffixed twin never resolved." },
+    // ── Tier 2: tense / suffix twins ──
+    { kind: "rename", from: "metric_decomposed_into_metric", to: "metric_decomposes_into_metric", requires_source_type: "metric", requires_target_type: "metric", reason: "Duplicate collapse (UPG-677). Tense-twin of the active-voice metric_decomposes_into_metric." },
+    { kind: "rename", from: "product_decided_via_decision_hierarchy", to: "product_decided_via_decision", requires_source_type: "product", requires_target_type: "decision", reason: "Duplicate collapse (UPG-677). Suffix-twin of product_decided_via_decision." },
+    { kind: "rename", from: "support_ticket_reveals_need_cross_domain", to: "support_ticket_reveals_need", requires_source_type: "support_ticket", requires_target_type: "need", reason: "Duplicate collapse (UPG-677). Near-duplicate of support_ticket_reveals_need (whose reverse_verb is normalised to revealed_by)." },
+    // ── Tier 3: near-synonyms (Captain's lean = collapse) ──
+    { kind: "rename", from: "outcome_tracked_by_metric", to: "outcome_measured_by_metric", requires_source_type: "outcome", requires_target_type: "metric", reason: "Duplicate collapse (UPG-677). Near-synonym of outcome_measured_by_metric (keep measured_by, drop tracked_by)." },
+    { kind: "rename", from: "key_result_tracked_by_metric", to: "key_result_quantified_by_metric", requires_source_type: "key_result", requires_target_type: "metric", reason: "Duplicate collapse (UPG-677). Near-synonym of key_result_quantified_by_metric (keep quantified_by, drop tracked_by)." },
+    { kind: "rename", from: "business_model_reaches_via_distribution_channel", to: "business_model_distributes_via_distribution_channel", requires_source_type: "business_model", requires_target_type: "distribution_channel", reason: "Duplicate collapse (UPG-677). Near-synonym of business_model_distributes_via_distribution_channel (the Business Model Canvas Channels verb)." },
+    // ── Inverse pairs: flip onto the kept containment edge ──
+    // Flip guards reference the PRE-flip (original-edge) endpoints: the original
+    // source becomes the new target after flip, so requires_source_type matches
+    // the new edge's target_type and requires_target_type matches its source_type.
+    { kind: "rename", from: "product_categorised_in_product_area", to: "product_area_contains_product", flip: true, requires_source_type: "product", requires_target_type: "product_area", reason: 'Duplicate collapse (UPG-677). Inverse of the containment edge product_area_contains_product (product_area \u2192 product). Flip swaps endpoints; the "categorised in" read survives as the reverse_verb belongs_to.' },
+    { kind: "rename", from: "changelog_documents_release", to: "release_documented_in_changelog", flip: true, requires_source_type: "changelog", requires_target_type: "release", reason: 'Duplicate collapse (UPG-677). Inverse of the containment edge release_documented_in_changelog (release \u2192 changelog, matching hierarchy release: [changelog]). Flip swaps endpoints; the "changelog documents release" read survives as the reverse_verb documents.' }
+  ],
   "0.9.2": [
     // (since v0.9.2, UPG-663) Journey-model disambiguation. A journey_phase
     // is a temporal BAND over the journey's single step timeline, not a
@@ -9562,6 +9736,7 @@ var UPG_PROPERTY_SCHEMA = {
   // CustomerJourneyStageProperties: Customer journey stage.
   customer_journey_stage: {
     stage_type: { type: "string", enum: ["awareness", "acquisition", "activation", "retention", "revenue", "referral"], description: "Which pirate metric (AAARRR) this stage maps to" },
+    stage_order: { type: "number", description: "Display order along the lifecycle timeline (0-indexed). The `*_order` convention shared with `journey_phase.phase_order` and `journey_step.step_order` (UPG-675 / CS-8), so two same-`stage_type` stages are orderable." },
     avg_duration: { type: "string", description: "Average time a customer spends in this stage" },
     conversion_rate: { type: "number", description: "Percentage of customers who advance to the next stage" }
   },
@@ -9953,7 +10128,7 @@ var UPG_PROPERTY_SCHEMA = {
     observed_at: { type: "string", description: "ISO date observed." },
     source: { type: "string", description: "Free-text provenance note" }
   },
-  // ExperimentProperties: A structured activity designed to test a hypothesis.
+  // ExperimentProperties: A structured test designed to validate a hypothesis. The canonical unit of
   experiment: {
     method: { type: "string", description: 'Experimental method (e.g. "A/B test", "usability study", "smoke test")' },
     start_date: { type: "string", description: "ISO start date" },
@@ -9963,10 +10138,11 @@ var UPG_PROPERTY_SCHEMA = {
     expected_lift_unit: { type: "string", enum: ["percentage", "absolute", "ratio"], description: "Unit of `expected_lift`" },
     actual_lift: { type: "number", description: "Observed change in the primary metric" }
   },
-  // ExperimentPlanProperties: Planning intent for a structured test of a hypothesis (UCS pattern P4: work-unit).
+  // ExperimentPlanProperties: The validation PLAN: the design for a structured test of a hypothesis
   experiment_plan: {
     method: { type: "string", enum: ["a_b_test", "multivariate", "qual_interview", "prototype_test", "fake_door", "wizard_of_oz", "longitudinal"], description: "Experimental method. Drives renderer and analysis tooling." },
     success_criteria: { type: "string", description: 'Plain-English description of "passing"' },
+    sample_size: { type: "number", description: "Targeted participants or observations for the planned test. Absorbed from `test_plan` (UPG-678) when it re-homed to QA; the planning sample size now lives on the validation plan." },
     projected_reach: {
       type: "assessment",
       scale_id: "reach_5",
@@ -10502,7 +10678,7 @@ var UPG_PROPERTY_SCHEMA = {
   // JourneyStepProperties: Single step within a user journey. A user-moment on the journey's single
   journey_step: {
     step_order: { type: "number", description: "Display order within the journey's step timeline (0-indexed). The scalar ordering convention shared with `journey_phase.phase_order` and `journey_action.action_order` (UPG-663). For branching journeys, the explicit `journey_step_precedes_journey_step` edge captures the chain." },
-    touchpoint: { type: "string", description: "Interaction touchpoint" },
+    touchpoint: { type: "string", description: "@deprecated since v0.9.9 (UPG-675). Touchpoints are modelled in two places, neither of which is this string: the `touchpoint` *entity* is the cross-channel customer-success layer (`touchpoint_occurs_in_journey_step`), and `journey_action` is the in-product blueprint layer (the finest band of a `journey_step`). Use one of those rather than a free-text string here. Removed in a future major." },
     channel: { type: "string", description: 'Channel (e.g. "web", "email", "in-store")' },
     emotion_score: {
       type: "assessment",
@@ -11772,12 +11948,13 @@ var UPG_PROPERTY_SCHEMA = {
     env_status: { type: "string", enum: ["available", "in_use", "maintenance", "unavailable"], description: "Current availability status of the environment" },
     config: { type: "string", description: "Configuration details (e.g. OS, browser version, database seed)" }
   },
-  // TestPlanProperties: TestPlan entity.
+  // TestPlanProperties: Test plan: the QA verification procedure for a product or release.
   test_plan: {
-    plan_type: { type: "string", enum: ["usability", "concept", "ab_test", "beta", "smoke"], description: "Test type" },
-    sample_size: { type: "number", description: "Participants or observations" },
-    duration: { type: "string", description: 'Run duration. @example "2 weeks"' },
-    success_criteria: { type: "string", description: "Criteria determining whether the test passes" }
+    test_scope: { type: "string", description: 'What the plan covers (e.g. "checkout flow", "auth module", "release 2.4").' },
+    plan_type: { type: "string", enum: ["release", "regression", "integration", "acceptance", "smoke", "exploratory"], description: "Kind of verification effort this plan governs." },
+    environments: { type: "object", description: "Environments the plan exercises (mirrors `TestEnvironmentProperties.env_type`)." },
+    entry_criteria: { type: "string", description: "Conditions that must hold before execution may begin." },
+    pass_criteria: { type: "string", description: "Exit / pass criteria determining whether the plan succeeds." }
   },
   // TestResultProperties: Single test execution result.
   test_result: {
@@ -11843,7 +12020,7 @@ var UPG_PROPERTY_SCHEMA = {
   },
   // TouchpointProperties: Customer touchpoint.
   touchpoint: {
-    touchpoint_channel: { type: "string", description: 'Channel where the interaction occurs (e.g. "email", "in-app", "call")' },
+    touchpoint_channel: { type: "string", enum: ["in_app", "email", "phone", "chat", "sms", "in_person", "mail"], description: "Medium (modality) of the interaction: how it physically happens. Distinct from a go-to-market *channel* (`marketing_channel`/`acquisition_channel`/ `distribution_channel`), which are market routes, not interaction media. (UPG-679)" },
     touchpoint_type: { type: "string", enum: ["reactive", "proactive", "automated"], description: "Whether the touchpoint is initiated by the customer, CSM, or system" },
     satisfaction_score: { type: "number", description: "Customer satisfaction score for this touchpoint" }
   },
@@ -11896,7 +12073,7 @@ var UPG_PROPERTY_SCHEMA = {
   // UserJourneyProperties: User journey map.
   user_journey: {
     scope: { type: "string", description: 'Scope (e.g. "end-to-end onboarding")' },
-    journey_type: { type: "string", enum: ["current_state", "future_state", "day_in_the_life", "service_blueprint"], description: "Maps current or future state" },
+    journey_type: { type: "string", enum: ["current_state", "future_state", "day_in_the_life"], description: "Maps current or future state" },
     scenario: { type: "string", description: "Scenario context" }
   },
   // UserStoryProperties: "As X, I want Y so Z" templated promise on a user story (UCS pattern P5).
@@ -17966,9 +18143,10 @@ var PRIORITY_LABELS = [
   {
     id: "experiment",
     canonical_label: "Experiment",
+    // V6 (UPG-664): dropped 'test' (too generic; collides) and 'validation'
+    // (the domain name). The deprecated growth/pricing/ab experiment types
+    // redirect to `experiment` (V2), so their labels stay here.
     alt_labels: [
-      "test",
-      "validation",
       "ab test",
       "a/b test",
       "split test",
@@ -18424,8 +18602,8 @@ var STANDARD_LABELS = {
   design_sprint: { alt_labels: ["sprint", "gv sprint", "google ventures sprint"] },
   // Validation layer
   learning: { alt_labels: ["validated learning", "lesson learned", "takeaway"] },
-  // 'experiment plan' stripped (P-B / UPG-670): canonical label of the distinct `experiment_plan` type.
-  test_plan: { alt_labels: ["test strategy", "validation plan"] },
+  // test_plan re-homed validation → QA (UPG-678); its label entry now lives in
+  // the Quality Assurance & Testing layer below.
   research_plan: { alt_labels: ["study plan", "research brief"] },
   evidence: { alt_labels: ["proof", "supporting data", "signal"] },
   variant: { alt_labels: ["test variant", "experiment arm", "variation"] },
@@ -18679,6 +18857,10 @@ var STANDARD_LABELS = {
   help_video: { alt_labels: ["tutorial video", "screencast", "how-to video"] },
   learning_path: { alt_labels: ["curriculum", "course track", "learning journey"] },
   // Quality Assurance & Testing layer
+  // test_plan re-homed validation → QA (UPG-678): QA-shaped labels only.
+  // 'validation plan' and 'experiment plan' stripped — those belong to the
+  // validation-side `experiment_plan` type.
+  test_plan: { alt_labels: ["test strategy", "qa plan", "master test plan"] },
   test_suite: { alt_labels: ["test collection", "test group"] },
   test_case: { alt_labels: ["test", "test scenario", "verification step"] },
   qa_session: { alt_labels: ["testing session", "exploratory test", "qa round"] },
@@ -19050,11 +19232,13 @@ var DISCOVERY_RESEARCH_VALIDATION_PLAYBOOK = {
     seqStep(
       8,
       "Test",
-      // DT-PB-1: was `experiment` — which resolves to NO canonical edge with
-      // hypothesis or test_plan, forcing an orphan. `experiment_run` is the
-      // hypothesis-linked test unit (experiment_run_validates_hypothesis,
-      // test_plan_ran_as_experiment_run, experiment_run_yields_evidence).
-      ["experiment_run", "test_plan", "evidence"],
+      // DT-PB-1: was `experiment` — which resolved to NO canonical edge with
+      // hypothesis, forcing an orphan. `experiment_run` is the hypothesis-linked
+      // test unit (experiment_run_validates_hypothesis, experiment_run_yields_evidence).
+      // (UPG-664) `test_plan` re-homed to QA (UPG-678); the validation plan is
+      // `experiment_plan`, which designs the experiment
+      // (experiment_plan_designs_experiment) and runs as experiment_run(s).
+      ["experiment_run", "experiment_plan", "evidence"],
       "Validate with targeted experiment runs. Close the loop between research and action."
     )
   ]
@@ -20287,19 +20471,23 @@ var UPG_DOMAIN_RINGS = [
     id: "define",
     label: "Define",
     description: "What are we building?",
-    domain_ids: ["strategy", "product_spec", "legal", "ux_design", "design_system", "brand"]
+    // `business_model` lives in the `define` ring (foundational "what are we
+    // building & how it sustains"), not in `grow`. This is an intentional
+    // ring-vs-region divergence: UPG_REGIONS still groups business_model under
+    // `business_gtm_growth` (region membership is a separately-tracked decision).
+    domain_ids: ["strategy", "product_spec", "business_model", "ux_design", "design_system", "brand", "legal"]
   },
   {
     id: "build",
     label: "Build",
     description: "How do we construct it?",
-    domain_ids: ["engineering", "devops", "testing", "security", "accessibility", "data_analytics", "ai", "automation"]
+    domain_ids: ["engineering", "ai", "automation", "data_analytics", "testing", "devops", "security", "accessibility"]
   },
   {
     id: "grow",
     label: "Grow",
     description: "How do we make money?",
-    domain_ids: ["business_model", "growth", "go_to_market", "pricing", "sales", "marketing"]
+    domain_ids: ["pricing", "go_to_market", "sales", "marketing", "growth"]
   },
   {
     id: "operate",
@@ -20311,9 +20499,27 @@ var UPG_DOMAIN_RINGS = [
     id: "extend",
     label: "Extend",
     description: "How do we scale?",
-    domain_ids: ["team_org", "program_mgmt", "localisation", "ecosystem", "compliance"]
+    domain_ids: ["team_org", "program_mgmt", "ecosystem", "localisation", "compliance"]
   }
 ];
+function assertRingsPartitionDomains() {
+  const ringDomainIds = UPG_DOMAIN_RINGS.flatMap((r) => [...r.domain_ids]);
+  const canonical = new Set(UPG_DOMAINS.map((d) => d.id));
+  const ringSet = new Set(ringDomainIds);
+  const duplicates = ringDomainIds.filter((id, i) => ringDomainIds.indexOf(id) !== i);
+  const unknown = [...ringSet].filter((id) => !canonical.has(id));
+  const unassigned = [...canonical].filter((id) => !ringSet.has(id));
+  if (duplicates.length || unknown.length || unassigned.length) {
+    const parts = [];
+    if (unassigned.length) parts.push(`domains in no ring: [${unassigned.join(", ")}]`);
+    if (unknown.length) parts.push(`ring domains not in UPG_DOMAINS: [${unknown.join(", ")}]`);
+    if (duplicates.length) parts.push(`domains in multiple rings: [${[...new Set(duplicates)].join(", ")}]`);
+    throw new Error(
+      `UPG_DOMAIN_RINGS must partition UPG_DOMAINS exactly: ${parts.join("; ")}. Slot every domain into exactly one ring in domain-rings.ts.`
+    );
+  }
+}
+assertRingsPartitionDomains();
 function getRingForDomain(domainId) {
   return UPG_DOMAIN_RINGS.find((ring) => ring.domain_ids.includes(domainId));
 }
@@ -20321,6 +20527,9 @@ function getDomainsInRing(ringId) {
   const ring = UPG_DOMAIN_RINGS.find((r) => r.id === ringId);
   return ring ? [...ring.domain_ids] : [];
 }
+function ringOrderedDomainIds() {
+  return UPG_DOMAIN_RINGS.flatMap((ring) => [...ring.domain_ids]);
+}
 
 // src/intelligence/domain-guides.ts
 var USER_GUIDE = {
@@ -20430,19 +20639,18 @@ var DISCOVERY_GUIDE = {
 var VALIDATION_GUIDE = {
   domain_id: "validation",
   anchor_entity: "hypothesis",
-  // creation_sequence covers every entity registered to the `validation`
-  // domain. `experiment` is the legacy parent that decomposed into
-  // experiment_plan + experiment_run in v0.2.6 (split rule lives in
-  // UPG_SPLIT_MIGRATIONS); it remains in the registry for round-trip
-  // compatibility and is listed last so new authors reach the split pair
-  // first.
-  creation_sequence: ["hypothesis", "experiment_plan", "experiment_run", "test_plan", "evidence", "learning", "research_plan", "experiment"],
+  // (UPG-664) creation_sequence covers every entity registered to the
+  // `validation` domain along the canonical chain hypothesis → experiment_plan
+  // → experiment → experiment_run. `experiment` is the canonical structured
+  // test; experiment_run is its optional replication child. `test_plan`
+  // re-homed to the QA/testing domain (UPG-678).
+  creation_sequence: ["hypothesis", "experiment_plan", "experiment", "experiment_run", "evidence", "learning", "research_plan"],
   patterns: [
     {
       name: "Hypothesis Testing Loop",
-      description: "Hypotheses require plans (intent), plans run as experiment_runs (execution), runs produce evidence and learnings, learnings update hypotheses",
-      entity_types: ["hypothesis", "experiment_plan", "experiment_run", "evidence", "learning"],
-      edge_chain: ["hypothesis_requires_experiment_plan", "experiment_plan_ran_as_experiment_run", "experiment_run_yields_evidence", "experiment_run_produces_learning", "learning_updates_hypothesis"]
+      description: "A hypothesis requires a plan (the experiment design), the plan designs an experiment (the structured test), the experiment is executed as run(s) that produce evidence and learnings, and learnings update the hypothesis",
+      entity_types: ["hypothesis", "experiment_plan", "experiment", "experiment_run", "evidence", "learning"],
+      edge_chain: ["hypothesis_requires_experiment_plan", "experiment_plan_designs_experiment", "experiment_executed_as_experiment_run", "experiment_run_yields_evidence", "experiment_run_produces_learning", "learning_updates_hypothesis"]
     }
   ],
   required_bridges: [
@@ -20560,7 +20768,8 @@ var UX_DESIGN_GUIDE = {
   anti_patterns: [
     { description: "Screens without journeys: isolated screens miss the experience context" },
     { description: "Prototypes without testing: if nobody tests the prototype, it is just art" },
-    { description: "Design questions left open: exploration status should progress to resolved or parked" }
+    { description: "Design questions left open: exploration status should progress to resolved or parked" },
+    { description: "Touchpoints stuffed in the deprecated journey_step.touchpoint string (UPG-675). Touchpoints belong in one of two layers: journey_action is the in-product blueprint layer (the finest band of a journey_step), and the touchpoint entity is the cross-channel customer-success layer (touchpoint_occurs_in_journey_step). Pick the layer; do not duplicate the touch as a free-text string." }
   ]
 };
 var DESIGN_SYSTEM_GUIDE = {
@@ -20703,7 +20912,9 @@ var DEVOPS_GUIDE = {
 var TESTING_GUIDE = {
   domain_id: "testing",
   anchor_entity: "test_suite",
-  creation_sequence: ["test_suite", "test_case", "qa_session", "regression_test", "test_coverage_report", "test_environment", "test_result"],
+  // (UPG-678) test_plan re-homed validation → QA: the verification-approach
+  // plan that the suites execute. Listed first as the QA planning layer.
+  creation_sequence: ["test_plan", "test_suite", "test_case", "qa_session", "regression_test", "test_coverage_report", "test_environment", "test_result"],
   patterns: [
     {
       name: "Test Pyramid",
@@ -20800,7 +21011,7 @@ var AI_GUIDE = {
     }
   ],
   required_bridges: [
-    { edge_type: "prompt_template_targets_ai_model", target_domain: "content", when: "Prompt templates should link to the models they target" },
+    { edge_type: "ai_dataset_sourced_from_data_source", target_domain: "data_analytics", when: "AI datasets should trace provenance to the data sources they draw from" },
     { edge_type: "ai_guardrail_enforces_security_policy", target_domain: "security", when: "AI guardrails should map to the security policies that constrain them" }
   ],
   anti_patterns: [
@@ -20991,7 +21202,8 @@ var CUSTOMER_SUCCESS_GUIDE = {
   anti_patterns: [
     { description: "Health scores without components: define which metrics compose the score" },
     { description: "Playbooks without triggers: specify what conditions activate each playbook" },
-    { description: "Churn reasons without analysis: understand patterns, not just individual cases" }
+    { description: "Churn reasons without analysis: understand patterns, not just individual cases" },
+    { description: "Conflating the two journey models (UPG-675). customer_journey_stage models the post-sale AARRR lifecycle (a customer-success timeline; use stage_order to sequence stages); journey_phase models in-product experience phases of a single user_journey. They are different lenses, not duplicates. Likewise, the touchpoint entity is the cross-channel customer-success layer, distinct from the in-product journey_action." }
   ]
 };
 var CONTENT_GUIDE = {
@@ -24389,9 +24601,7 @@ var UPG_REGIONS = [
       "objective_achieved_through_key_result",
       "objective_measured_by_metric",
       "key_result_quantified_by_metric",
-      "key_result_tracked_by_metric",
       "outcome_measured_by_metric",
-      "outcome_tracked_by_metric",
       "metric_decomposes_into_metric",
       "metric_guards_metric",
       "metric_drives_metric"
@@ -24645,8 +24855,7 @@ var UPG_REGIONS = [
       },
       {
         type: "experiment",
-        role: "hub",
-        notes: "self-nesting"
+        role: "hub"
       },
       {
         type: "experiment_plan",
@@ -24654,7 +24863,8 @@ var UPG_REGIONS = [
       },
       {
         type: "experiment_run",
-        role: "container"
+        role: "container",
+        notes: "self-nesting"
       },
       {
         type: "learning",
@@ -24664,10 +24874,6 @@ var UPG_REGIONS = [
         type: "evidence",
         role: "leaf"
       },
-      {
-        type: "test_plan",
-        role: "leaf"
-      },
       {
         type: "research_plan",
         role: "leaf"
@@ -24759,7 +24965,7 @@ var UPG_REGIONS = [
       },
       {
         direction: "export",
-        edge_id: "insight_informs_opportunity_cross_domain",
+        edge_id: "insight_informs_opportunity",
         crosses_into: "discovery_research_validation"
       },
       {
@@ -25443,7 +25649,7 @@ var UPG_REGIONS = [
       },
       {
         type: "prompt_template",
-        role: "leaf"
+        role: "container"
       },
       {
         type: "prompt_version",
@@ -25875,7 +26081,7 @@ var UPG_REGIONS = [
       "business_model_earns_via_revenue_stream",
       "business_model_costs_via_cost_structure",
       "business_model_measured_by_unit_economics",
-      "business_model_reaches_via_distribution_channel",
+      "business_model_distributes_via_distribution_channel",
       "business_model_maintains_customer_relationship",
       "business_model_requires_key_resource",
       "business_model_performs_key_activity",
@@ -26044,11 +26250,6 @@ var UPG_REGIONS = [
         edge_id: "key_result_quantified_by_metric",
         crosses_into: "strategy_outcomes"
       },
-      {
-        direction: "import",
-        edge_id: "key_result_tracked_by_metric",
-        crosses_into: "strategy_outcomes"
-      },
       {
         direction: "import",
         edge_id: "revenue_stream_measured_by_metric_cross_domain",
@@ -26160,6 +26361,10 @@ var UPG_REGIONS = [
         type: "infrastructure_component",
         role: "container"
       },
+      {
+        type: "test_plan",
+        role: "container"
+      },
       {
         type: "test_suite",
         role: "container"
@@ -26441,7 +26646,7 @@ var UPG_REGIONS = [
     boundary_edges: [
       {
         direction: "import",
-        edge_id: "product_experiences_incident_hierarchy",
+        edge_id: "product_experiences_incident",
         crosses_into: "product_delivery"
       },
       {
@@ -26991,7 +27196,7 @@ function isCanonical(text) {
 }
 
 // src/index.ts
-var UPG_VERSION = "0.9.8";
+var UPG_VERSION = "0.9.10";
 var UPG_FORMAT_VERSION = "0.4.0";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();
@@ -27218,6 +27423,7 @@ var UPG_META_COUNT = UPG_ENTITY_META.length;
   resolveEntityType,
   resolveLabel,
   resolveSlugCollision,
+  ringOrderedDomainIds,
   rotateSlug,
   serializeCanonical,
   validateProductStageStrict,