@unified-product-graph/core 0.9.7 → 0.9.9

package/dist/index.d.ts

@@ -315,10 +315,17 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
-    hypothesis_planned_via_test_plan: {
+    hypothesis_tested_by_experiment: {
         forward_verb: string;
         reverse_verb: string;
-        classification: "hierarchy";
+        classification: "causal";
+        source_type: string;
+        target_type: string;
+    };
+    experiment_validates_hypothesis: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "causal";
         source_type: string;
         target_type: string;
     };
@@ -329,6 +336,20 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
+    insight_generates_hypothesis: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    research_plan_conducted_as_research_study: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
     experiment_run_produces_learning: {
         forward_verb: string;
         reverse_verb: string;
@@ -406,7 +427,7 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
-    experiment_has_plan: {
+    experiment_plan_designs_experiment: {
         forward_verb: string;
         reverse_verb: string;
         classification: "hierarchy";
@@ -882,13 +903,6 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
-    outcome_tracked_by_metric: {
-        forward_verb: string;
-        reverse_verb: string;
-        classification: "hierarchy";
-        source_type: string;
-        target_type: string;
-    };
     objective_achieved_through_key_result: {
         forward_verb: string;
         reverse_verb: string;
@@ -910,13 +924,6 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
-    key_result_tracked_by_metric: {
-        forward_verb: string;
-        reverse_verb: string;
-        classification: "hierarchy";
-        source_type: string;
-        target_type: string;
-    };
     vision_realised_through_mission: {
         forward_verb: string;
         reverse_verb: string;
@@ -987,7 +994,7 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
-    objective_rolls_up_to_strategic_theme: {
+    strategic_theme_contains_objective: {
         forward_verb: string;
         reverse_verb: string;
         classification: "hierarchy";
@@ -2359,13 +2366,6 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
-    product_experiences_incident_hierarchy: {
-        forward_verb: string;
-        reverse_verb: string;
-        classification: "hierarchy";
-        source_type: string;
-        target_type: string;
-    };
     product_tested_by_penetration_test: {
         forward_verb: string;
         reverse_verb: string;
@@ -2499,6 +2499,27 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
+    product_plans_qa_via_test_plan: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "hierarchy";
+        source_type: string;
+        target_type: string;
+    };
+    test_plan_executed_by_test_suite: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "hierarchy";
+        source_type: string;
+        target_type: string;
+    };
+    test_plan_specifies_test_environment: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "hierarchy";
+        source_type: string;
+        target_type: string;
+    };
     product_maintains_test_suite: {
         forward_verb: string;
         reverse_verb: string;
@@ -2702,7 +2723,14 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
-    ai_model_prompted_via_prompt_version: {
+    ai_model_defines_prompt_template: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "hierarchy";
+        source_type: string;
+        target_type: string;
+    };
+    prompt_template_contains_prompt_version: {
         forward_verb: string;
         reverse_verb: string;
         classification: "hierarchy";
@@ -2758,10 +2786,10 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
-    prompt_version_evolves_prompt_template: {
+    prompt_version_supersedes_prompt_version: {
         forward_verb: string;
         reverse_verb: string;
-        classification: "cross-domain";
+        classification: "semantic";
         source_type: string;
         target_type: string;
     };
@@ -2814,6 +2842,48 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
+    eval_run_evaluates_ai_model: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    eval_run_scores_prompt_version: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    hallucination_report_traces_to_ai_trace: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    hallucination_report_caused_by_root_cause: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    ai_trace_executed_prompt_version: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
+    ai_dataset_sourced_from_data_source: {
+        forward_verb: string;
+        reverse_verb: string;
+        classification: "cross-domain";
+        source_type: string;
+        target_type: string;
+    };
     product_automated_via_workflow_template: {
         forward_verb: string;
         reverse_verb: string;
@@ -3031,13 +3101,6 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
-    metric_decomposed_into_metric: {
-        forward_verb: string;
-        reverse_verb: string;
-        classification: "hierarchy";
-        source_type: string;
-        target_type: string;
-    };
     metric_drives_metric: {
         forward_verb: string;
         reverse_verb: string;
@@ -3220,13 +3283,6 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
-    business_model_reaches_via_distribution_channel: {
-        forward_verb: string;
-        reverse_verb: string;
-        classification: "hierarchy";
-        source_type: string;
-        target_type: string;
-    };
     business_model_maintains_customer_relationship: {
         forward_verb: string;
         reverse_verb: string;
@@ -3290,13 +3346,6 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
-    value_proposition_targets_persona_cross_domain: {
-        forward_verb: string;
-        reverse_verb: string;
-        classification: "cross-domain";
-        source_type: string;
-        target_type: string;
-    };
     revenue_stream_drives_metric: {
         forward_verb: string;
         reverse_verb: string;
@@ -4284,13 +4333,6 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
-    support_ticket_reveals_need_cross_domain: {
-        forward_verb: string;
-        reverse_verb: string;
-        classification: "cross-domain";
-        source_type: string;
-        target_type: string;
-    };
     churn_reason_reveals_need: {
         forward_verb: string;
         reverse_verb: string;
@@ -4326,13 +4368,6 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
-    product_prompted_via_prompt_template: {
-        forward_verb: string;
-        reverse_verb: string;
-        classification: "hierarchy";
-        source_type: string;
-        target_type: string;
-    };
     product_templated_via_documentation_template: {
         forward_verb: string;
         reverse_verb: string;
@@ -4396,13 +4431,6 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
-    content_calendar_schedules_prompt_template: {
-        forward_verb: string;
-        reverse_verb: string;
-        classification: "hierarchy";
-        source_type: string;
-        target_type: string;
-    };
     content_calendar_schedules_documentation_template: {
         forward_verb: string;
         reverse_verb: string;
@@ -4431,13 +4459,6 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
-    changelog_documents_release: {
-        forward_verb: string;
-        reverse_verb: string;
-        classification: "cross-domain";
-        source_type: string;
-        target_type: string;
-    };
     prompt_template_powers_feature: {
         forward_verb: string;
         reverse_verb: string;
@@ -4648,13 +4669,6 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
-    product_decided_via_decision_hierarchy: {
-        forward_verb: string;
-        reverse_verb: string;
-        classification: "hierarchy";
-        source_type: string;
-        target_type: string;
-    };
     product_organised_into_department: {
         forward_verb: string;
         reverse_verb: string;
@@ -5299,13 +5313,6 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
-    metric_measures_metric_cross_domain: {
-        forward_verb: string;
-        reverse_verb: string;
-        classification: "cross-domain";
-        source_type: string;
-        target_type: string;
-    };
     event_schema_tracks_funnel_step: {
         forward_verb: string;
         reverse_verb: string;
@@ -5383,13 +5390,6 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
-    product_categorised_in_product_area: {
-        forward_verb: string;
-        reverse_verb: string;
-        classification: "hierarchy";
-        source_type: string;
-        target_type: string;
-    };
     product_has_competitor: {
         forward_verb: string;
         reverse_verb: string;
@@ -5712,13 +5712,6 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
-    insight_validates_need_cross_domain: {
-        forward_verb: string;
-        reverse_verb: string;
-        classification: "cross-domain";
-        source_type: string;
-        target_type: string;
-    };
     observation_reveals_need: {
         forward_verb: string;
         reverse_verb: string;
@@ -5810,13 +5803,6 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
-    insight_informs_opportunity_cross_domain: {
-        forward_verb: string;
-        reverse_verb: string;
-        classification: "cross-domain";
-        source_type: string;
-        target_type: string;
-    };
     insight_validates_persona: {
         forward_verb: string;
         reverse_verb: string;
@@ -6014,13 +6000,6 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
-    prompt_template_targets_ai_model: {
-        forward_verb: string;
-        reverse_verb: string;
-        classification: "cross-domain";
-        source_type: string;
-        target_type: string;
-    };
     education_program_targets_persona: {
         forward_verb: string;
         reverse_verb: string;
@@ -6453,13 +6432,6 @@ declare const UPG_EDGE_CATALOG: {
         source_type: string;
         target_type: string;
     };
-    test_plan_ran_as_experiment_run: {
-        forward_verb: string;
-        reverse_verb: string;
-        classification: "hierarchy";
-        source_type: string;
-        target_type: string;
-    };
     evidence_interpreted_as_learning: {
         forward_verb: string;
         reverse_verb: string;
@@ -7172,7 +7144,7 @@ interface UPGProduct {
 /** Product lifecycle stages. Covers the full arc from napkin idea to end-of-life. */
 type UPGProductStage = 'concept' | 'validation' | 'build' | 'beta' | 'launch' | 'growth' | 'mature' | 'maintenance' | 'sunset';
 /** The set of valid cross-product relationship types */
-type UPGCrossEdgeType = 'shares_persona' | 'shares_competitor' | 'shares_metric' | 'depends_on_product' | 'cannibalises' | 'succeeds' | 'hosts' | 'contributes_to' | 'instance_of';
+type UPGCrossEdgeType = 'shares_persona' | 'shares_competitor' | 'shares_metric' | 'depends_on_product' | 'cannibalises' | 'succeeds' | 'hosts' | 'contributes_to' | 'instance_of' | 'area_serves_persona' | 'area_targets_market_segment' | 'rolls_up_to';
 /**
  * Runtime-checkable list of valid cross-product edge types. Mirrors
  * `UPGCrossEdgeType` for use in validators and writers that need to test
@@ -7207,6 +7179,26 @@ interface UPGCrossEdge {
     target_product_id?: string;
     /** Confidence level if this edge was inferred during import */
     mapping_confidence?: UPGMappingConfidence;
+    /**
+     * Sanctioned divergence marker (`instance_of` only). When true, registry drift
+     * detection treats an instance title that differs from its canonical as
+     * intentional (an informative product-local name, e.g. "Vercel Platform / SDK"
+     * vs canonical "Vercel"), excluding it from the `title_divergence` count so
+     * `clean` reflects only un-sanctioned drift.
+     */
+    alias?: boolean;
+    /**
+     * Audience relevance for `area_serves_persona` / `area_targets_market_segment`:
+     * whether the audience is a primary or secondary focus of this area. The
+     * primary-vs-secondary distinction is the core value of the area-to-audience matrix.
+     */
+    relevance?: 'primary' | 'secondary';
+    /**
+     * Audience role in this area's context (`area_serves_persona`). Mirrors
+     * `PersonaProperties.audience_role`: the same persona can be a `buyer` for one
+     * area and a `user` for another.
+     */
+    audience_role?: 'buyer' | 'user' | 'champion' | 'influencer' | 'partner';
 }
 /**
  * A product area within a portfolio. The organisational axis (who owns
@@ -7657,8 +7649,8 @@ declare const UPG_DOMAINS: readonly [{
 }, {
     readonly id: "validation";
     readonly label: "Validation";
-    readonly 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.";
-    readonly types: readonly ["hypothesis", "experiment", "experiment_plan", "experiment_run", "learning", "test_plan", "evidence", "research_plan"];
+    readonly 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.";
+    readonly types: readonly ["hypothesis", "experiment", "experiment_plan", "experiment_run", "learning", "evidence", "research_plan"];
 }, {
     readonly id: "market_intelligence";
     readonly label: "Market Intelligence";
@@ -7747,8 +7739,8 @@ declare const UPG_DOMAINS: readonly [{
 }, {
     readonly id: "testing";
     readonly label: "Quality Assurance";
-    readonly 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).";
-    readonly types: readonly ["test_suite", "test_case", "qa_session", "regression_test", "test_coverage_report", "test_environment", "test_result"];
+    readonly 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).";
+    readonly types: readonly ["test_plan", "test_suite", "test_case", "qa_session", "regression_test", "test_coverage_report", "test_environment", "test_result"];
 }, {
     readonly id: "feedback";
     readonly label: "Customer Feedback";
@@ -7762,7 +7754,7 @@ declare const UPG_DOMAINS: readonly [{
 }, {
     readonly id: "ai";
     readonly label: "AI & Machine Learning";
-    readonly 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.";
+    readonly 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.";
     readonly types: readonly ["ai_model", "prompt_version", "eval_benchmark", "eval_run", "ai_cost_tracker", "hallucination_report", "ai_guardrail", "model_comparison", "ai_experiment", "ai_dataset", "ai_trace", "prompt_template"];
 }, {
     readonly id: "automation";
@@ -10097,7 +10089,8 @@ interface DesignSprintProperties {
 
 /**
  * UPG Property Schemas: Validation Domain.
- * Hypothesis, Experiment, Learning, TestPlan, Evidence, ResearchPlan.
+ * Hypothesis, ExperimentPlan, Experiment, ExperimentRun, Learning, Evidence,
+ * ResearchPlan. (`test_plan` re-homed to the QA/testing domain — UPG-678.)
  * https://unifiedproductgraph.org/spec | MIT
  */
 
@@ -10170,16 +10163,15 @@ interface HypothesisEvidenceProperties {
     /** ISO date observed. */
     observed_at?: ISODate;
 }
-/** A structured activity designed to test a hypothesis.
- *
- * `experiment` is canonical-stable. Split into `experiment_plan` + `experiment_run`
- * in v0.2.6 for teams needing fine-grained plan/run separation, then re-promoted
- * as the general-purpose option. The plan/run split remains the fine-grained
- * alternative, not a replacement.
+/** A structured test designed to validate a hypothesis. The canonical unit of
+ * a test.
  *
- * Use `experiment` for a single entity capturing method, dates, and outcome.
- * Use `experiment_plan` + `experiment_run` when lifecycle separation between
- * planning and execution matters to your workflow.
+ * `experiment` is canonical-stable and the spine of the validation chain
+ * `hypothesis → experiment_plan → experiment → experiment_run`: the
+ * `experiment_plan` is the validation design, the `experiment` is the
+ * structured test it produces, and the optional `experiment_run` child captures
+ * the multi-run / replication case (longitudinal or replicated tests). For a
+ * single everyday A/B test, `experiment` alone (with its plan) suffices.
  *
  * @example
  * const properties: ExperimentProperties = {
@@ -10204,21 +10196,22 @@ interface ExperimentProperties {
     /** Observed change in the primary metric */
     actual_lift?: number;
 }
-/** Planning intent for a structured test of a hypothesis (UCS pattern P4: work-unit).
+/** The validation PLAN: the design for a structured test of a hypothesis
+ * (UCS pattern P4: work-unit).
  *
- * Plan-shape fields only: method, success criteria, target metric, projected
- * reach/impact, ownership, intended dates. Once approved and an actual run
- * begins, an `experiment_run` links back via
- * `experiment_plan_ran_as_experiment_run`.
- *
- * Pairs with `experiment_run` (UCS pattern P6: event-occurrence). Replaces the
- * deprecated `experiment` type along with `experiment_run` (v0.2.6 split 1).
+ * `experiment_plan` is the canonical validation plan type (graduated
+ * `proposed → stable` in UPG-664). It carries the plan-shape fields — method,
+ * success criteria, sample size, projected reach/impact, intended dates — and
+ * designs the `experiment` it produces (`experiment_plan_designs_experiment`).
+ * It absorbed `test_plan`'s planning properties when `test_plan` re-homed to
+ * the QA/testing domain (UPG-678): `test_plan` is now the QA
+ * verification-procedure plan, not a validation-planning artefact.
  *
  * @example
  * const plan: ExperimentPlanProperties = {
  *   method: 'a_b_test',
  *   success_criteria: 'Day-7 activation rate +5% lift, p<0.05',
- *   target_metric_id: 'mtr_day7_activation',
+ *   sample_size: 4000,
  *   projected_reach: { value: 4, scale: 'reach_5', evidence: 'Cohort sizing' },
  *   confidence: { value: 3, scale: 'confidence_5' },
  *   planned_start_date: '2026-05-01',
@@ -10230,6 +10223,12 @@ interface ExperimentPlanProperties {
     method?: 'a_b_test' | 'multivariate' | 'qual_interview' | 'prototype_test' | 'fake_door' | 'wizard_of_oz' | 'longitudinal';
     /** Plain-English description of "passing" */
     success_criteria?: string;
+    /**
+     * 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.
+     */
+    sample_size?: number;
     /** Projected reach: how many people the run is expected to touch (UPGAssessment) */
     projected_reach?: UPGAssessment;
     /** Projected impact on the target metric (UPGAssessment) */
@@ -10245,13 +10244,11 @@ interface ExperimentPlanProperties {
 }
 /** Execution evidence for a structured test of a hypothesis (UCS pattern P6: event-occurrence).
  *
- * Created when an `experiment_plan` actually starts collecting data. Run-shape
- * fields only: actual dates, observed reach, outcome summary, severity of
- * finding, learning, and disposition. Multiple runs may spawn from the same
- * plan when re-executed; each run is its own event with its own evidence.
- *
- * Pairs with `experiment_plan` (UCS pattern P4: work-unit). Replaces the
- * deprecated `experiment` type along with `experiment_plan` (v0.2.6 split 1).
+ * The optional multi-run / replication child of `experiment` (UPG-664). A
+ * single `experiment` produces one or more runs; each run is its own event
+ * with its own dates, observed reach, outcome summary, severity of finding,
+ * learning, and disposition. Use runs only when longitudinal or replicated
+ * execution matters — an everyday single test needs only the `experiment`.
  *
  * @example
  * const run: ExperimentRunProperties = {
@@ -10314,28 +10311,6 @@ interface LearningProperties {
     /** Confidence impact on the parent hypothesis */
     confidence_impact?: 'strengthens' | 'weakens' | 'neutral';
 }
-/** TestPlan entity.
- *
- * @example
- * const properties: TestPlanProperties = {
- *   plan_type: 'usability',
- *   sample_size: 42,
- *   duration: '5 days',
- * }
- */
-interface TestPlanProperties {
-    /** Test type */
-    plan_type?: 'usability' | 'concept' | 'ab_test' | 'beta' | 'smoke';
-    /** Participants or observations */
-    sample_size?: number;
-    /**
-     * Run duration.
-     * @example "2 weeks"
-     */
-    duration?: string;
-    /** Criteria determining whether the test passes */
-    success_criteria?: string;
-}
 /** ResearchPlan entity.
  *
  * @example
@@ -10941,8 +10916,17 @@ interface SurveyResponseProperties {
  * https://unifiedproductgraph.org/spec | MIT
  */
 
-/** Whether a journey maps current or future state */
-type JourneyType = 'current_state' | 'future_state' | 'day_in_the_life' | 'service_blueprint';
+/** Whether a journey maps current or future state.
+ *
+ * BREAKING in v0.9.9 (UPG-675): the `'service_blueprint'` value is deprecated
+ * and removed from the union. A service blueprint is a first-class
+ * `service_blueprint` *entity* (in the customer_success domain), not a *type of*
+ * `user_journey`. Migration: a `user_journey` carrying
+ * `journey_type: 'service_blueprint'` should be re-modelled as a
+ * `service_blueprint` node; drop the journey_type value (it no longer
+ * type-checks). `current_state` / `future_state` / `day_in_the_life` are kept.
+ */
+type JourneyType = 'current_state' | 'future_state' | 'day_in_the_life';
 /** User journey map.
  *
  * @example
@@ -11030,7 +11014,14 @@ interface JourneyStepProperties {
      * explicit `journey_step_precedes_journey_step` edge captures the chain.
      */
     step_order?: number;
-    /** Interaction touchpoint */
+    /**
+     * @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.
+     */
     touchpoint?: string;
     /** Channel (e.g. "web", "email", "in-store") */
     channel?: string;
@@ -13344,11 +13335,40 @@ interface InfrastructureComponentProperties {
 
 /**
  * UPG Property Schemas: QA & Testing Domain.
- * TestSuite, TestCase, QaSession, RegressionTest, TestCoverageReport,
+ * TestPlan, TestSuite, TestCase, QaSession, RegressionTest, TestCoverageReport,
  * TestEnvironment, TestResult.
  * https://unifiedproductgraph.org/spec | MIT
  */
 
+/** Test plan: the QA verification procedure for a product or release.
+ *
+ * Re-homed validation → QA in UPG-678. A `test_plan` defines HOW the team
+ * verifies the software works — the scope under test, the environments it runs
+ * in, the entry/exit (pass) criteria — and groups the `test_suite`s that carry
+ * it out. Its former validation-planning role (designing an experiment for a
+ * hypothesis) is now carried by `experiment_plan`.
+ *
+ * @example
+ * const properties: TestPlanProperties = {
+ *   test_scope: 'Checkout, billing settlement, and refund flows.',
+ *   plan_type: 'release',
+ *   environments: ['staging', 'production_mirror'],
+ *   entry_criteria: 'Build deployed to staging; seed data loaded.',
+ *   pass_criteria: 'All P0/P1 suites green; no open blocker bugs.',
+ * }
+ */
+interface TestPlanProperties {
+    /** What the plan covers (e.g. "checkout flow", "auth module", "release 2.4"). */
+    test_scope?: string;
+    /** Kind of verification effort this plan governs. */
+    plan_type?: 'release' | 'regression' | 'integration' | 'acceptance' | 'smoke' | 'exploratory';
+    /** Environments the plan exercises (mirrors `TestEnvironmentProperties.env_type`). */
+    environments?: Array<'local' | 'ci' | 'staging' | 'sandbox' | 'production_mirror'>;
+    /** Conditions that must hold before execution may begin. */
+    entry_criteria?: string;
+    /** Exit / pass criteria determining whether the plan succeeds. */
+    pass_criteria?: string;
+}
 /** Test suite.
  *
  * @example
@@ -14357,7 +14377,8 @@ interface ReportProperties {
 /**
  * UPG Property Schemas: Content & Knowledge Domain.
  * ContentPiece, KnowledgeBaseArticle, BrandAsset, InternalDoc,
- * PromptTemplate, ContentCalendar, ContentTheme, DocumentationTemplate, Document.
+ * ContentCalendar, ContentTheme, DocumentationTemplate, Document.
+ * (`PromptTemplate` moved to the AI domain file — UPG-665.)
  * https://unifiedproductgraph.org/spec | MIT
  */
 
@@ -14467,23 +14488,6 @@ interface DocumentProperties {
     /** Primary language (BCP 47 tag, e.g. "en", "en-GB", "fr") */
     language?: string;
 }
-/** Prompt template.
- *
- * @example
- * const properties: PromptTemplateProperties = {
- *   use_case: 'Kick off a discovery sprint with a fresh persona set.',
- *   variables: ['user_name', 'workspace_slug', 'cta_url'],
- *   version: '0.3.1',
- * }
- */
-interface PromptTemplateProperties {
-    /** Intended use case for the prompt */
-    use_case?: string;
-    /** Variable names expected by the template */
-    variables?: string[];
-    /** Version identifier of the template */
-    version?: string;
-}
 /** Content calendar.
  *
  * @example
@@ -15168,9 +15172,10 @@ interface StatusReportProperties {
 
 /**
  * UPG Property Schemas: AI & ML Domain.
- * AiModel, PromptVersion, EvalBenchmark, EvalRun, AiCostTracker,
- * HallucinationReport, AiGuardrail, ModelComparison, AiExperiment,
- * AiDataset, AiTrace.
+ * AiModel, PromptTemplate, PromptVersion, EvalBenchmark, EvalRun,
+ * AiCostTracker, HallucinationReport, AiGuardrail, ModelComparison,
+ * AiExperiment, AiDataset, AiTrace.
+ * Creation order: ai_model → prompt_template → prompt_version (UPG-665).
  * https://unifiedproductgraph.org/spec | MIT
  */
 
@@ -15209,6 +15214,27 @@ interface AiModelProperties {
     /** Free-form classification tags */
     tags?: string[];
 }
+/** Prompt template.
+ *
+ * The canonical parent of `prompt_version` (UPG-665): a template contains its
+ * versions the way a file contains its commits. Lives in the AI domain, owned
+ * by the `ai_model` that defines it (ai_model → prompt_template → prompt_version).
+ *
+ * @example
+ * const properties: PromptTemplateProperties = {
+ *   use_case: 'Kick off a discovery sprint with a fresh persona set.',
+ *   variables: ['user_name', 'workspace_slug', 'cta_url'],
+ *   version: '0.3.1',
+ * }
+ */
+interface PromptTemplateProperties {
+    /** Intended use case for the prompt */
+    use_case?: string;
+    /** Variable names expected by the template */
+    variables?: string[];
+    /** Version identifier of the template */
+    version?: string;
+}
 /** Prompt version.
  *
  * @example
@@ -17115,6 +17141,7 @@ interface ServiceLevelAgreementProperties {
  * @example
  * const properties: CustomerJourneyStageProperties = {
  *   stage_type: 'awareness',
+ *   stage_order: 0,
  *   avg_duration: '45m',
  *   conversion_rate: 0.08,
  * }
@@ -17122,6 +17149,13 @@ interface ServiceLevelAgreementProperties {
 interface CustomerJourneyStageProperties {
     /** Which pirate metric (AAARRR) this stage maps to */
     stage_type?: 'awareness' | 'acquisition' | 'activation' | 'retention' | 'revenue' | 'referral';
+    /**
+     * 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.
+     */
+    stage_order?: number;
     /** Average time a customer spends in this stage */
     avg_duration?: string;
     /** Percentage of customers who advance to the next stage */
@@ -17131,14 +17165,18 @@ interface CustomerJourneyStageProperties {
  *
  * @example
  * const properties: TouchpointProperties = {
- *   touchpoint_channel: 'in-product',
+ *   touchpoint_channel: 'in_app',
  *   touchpoint_type: 'reactive',
  *   satisfaction_score: 42,
  * }
  */
 interface TouchpointProperties {
-    /** Channel where the interaction occurs (e.g. "email", "in-app", "call") */
-    touchpoint_channel?: string;
+    /**
+     * 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_channel?: 'in_app' | 'email' | 'phone' | 'chat' | 'sms' | 'in_person' | 'mail';
     /** Whether the touchpoint is initiated by the customer, CSM, or system */
     touchpoint_type?: 'reactive' | 'proactive' | 'automated';
     /** Customer satisfaction score for this touchpoint */
@@ -18337,7 +18375,7 @@ type UPGNode<T extends keyof UPGPropertyMap = keyof UPGPropertyMap> = UPGBaseNod
  * AUTO-GENERATED by scripts/generate-property-registry.ts
  * Do not edit manually. Run: npx tsx scripts/generate-property-registry.ts
  *
- * Generated: 2026-06-10T00:33:26.360Z
+ * Generated: 2026-06-10T09:09:38.050Z
  * Entity types with properties: 316
  */
 interface PropertyDefinition {
@@ -20778,7 +20816,7 @@ declare function isCanonical(text: string): boolean;
  * it stamps the `upg_version` field of every `.upg` file written by the SDK.
  * The `check:version-lockstep` gate enforces this at release time.
  */
-declare const UPG_VERSION: "0.9.7";
+declare const UPG_VERSION: "0.9.9";
 /**
  * The `.upg` JSON document format version. Written to the `upg_version` field.
  * Evolves independently from `UPG_VERSION` (the catalogue version).