@unified-product-graph/core 0.17.3 → 0.17.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +1 -1
- package/dist/index.cjs +102 -8
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +142 -4
- package/dist/index.d.ts +142 -4
- package/dist/index.js +99 -8
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/dist/index.d.ts
CHANGED
|
@@ -11,7 +11,7 @@
|
|
|
11
11
|
* @see registry/entity-meta.ts for type IDs and maturity
|
|
12
12
|
* @see grammar/hierarchy.ts for parent-child rules
|
|
13
13
|
*/
|
|
14
|
-
type UPGEntityType = 'specification' | 'primitive' | 'operating_lifecycle' | 'operating_stage' | 'product' | 'outcome' | 'objective' | 'key_result' | 'metric' | 'metric_quality_assessment' | 'vision' | 'mission' | 'strategic_theme' | 'initiative' | 'capability' | 'value_stream' | 'strategic_pillar' | 'assumption' | 'decision' | 'constraint' | 'persona' | 'job' | 'need' | 'desired_outcome' | 'job_step' | 'switching_cost' | 'opportunity' | 'solution' | 'feasibility_study' | 'design_sprint' | 'hypothesis' | 'hypothesis_evidence' | 'experiment' | 'experiment_plan' | 'experiment_run' | 'learning' | 'test_plan' | 'evidence' | 'research_plan' | 'competitor' | 'competitor_feature' | 'competitor_signal' | 'market_trend' | 'market_segment' | 'competitive_analysis' | 'classification_axis' | 'classification_value' | 'research_study' | 'insight' | 'participant' | 'observation' | 'quote' | 'affinity_cluster' | 'research_question' | 'interview_guide' | 'survey_response' | 'user_journey' | 'journey_step' | 'journey_phase' | 'journey_action' | 'design_question' | 'design_concept' | 'prototype' | 'wireframe' | 'user_flow' | 'screen' | 'screen_state' | 'annotation' | 'interaction_spec' | 'design_component' | 'design_token' | 'design_system' | 'design_pattern' | 'design_guideline' | 'brand_identity' | 'brand_colour' | 'brand_typography' | 'brand_voice' | 'brand_logo' | 'brand_imagery' | 'feature_area' | 'feature' | 'epic' | 'user_story' | 'story_statement' | 'story_task' | 'acceptance_criterion' | 'release' | 'task' | 'bug' | 'roadmap' | 'roadmap_item' | 'theme' | 'roadmap_theme' | 'changelog' | 'bounded_context' | 'service' | 'domain_event' | 'api_contract' | 'technical_debt_item' | 'feature_flag' | 'deployment' | 'aggregate' | 'domain_entity' | 'value_object' | 'command' | 'read_model' | 'api_endpoint' | 'database_schema' | 'queue_topic' | 'build_artifact' | 'code_repository' | 'library_dependency' | 'integration_pattern' | 'external_api' | 'data_flow' | 'investigation' | 'root_cause' | 'symptom' | 'fix' | 'funnel' | 'funnel_step' | 'acquisition_channel' | 'growth_campaign' | 'cohort' | 'behavioral_segment' | 'growth_loop' | 'variant' | 'attribution_model' | 'business_model' | 'value_proposition' | 'revenue_stream' | 'pricing_tier' | 'cost_structure' | 'unit_economics' | 'partnership' | 'key_resource' | 'key_activity' | 'customer_relationship' | 'distribution_channel' | 'gtm_strategy' | 'ideal_customer_profile' | 'positioning' | 'messaging' | 'launch' | 'content_strategy' | 'sales_motion' | 'competitive_battle_card' | 'demand_gen_program' | 'territory' | 'objection' | 'rebuttal' | 'proof_point' | 'team' | 'role' | 'stakeholder' | 'person' | 'team_okr' | 'retrospective' | 'dependency' | 'department' | 'skill' | 'ceremony' | 'capacity_plan' | 'data_source' | 'event_schema' | 'dashboard' | 'data_model' | 'data_quality_rule' | 'data_product' | 'data_pipeline' | 'data_lineage' | 'glossary_term' | 'data_domain' | 'report' | 'content_piece' | 'knowledge_base_article' | 'brand_asset' | 'prompt_template' | 'content_calendar' | 'content_theme' | 'documentation_template' | 'document' | 'legal_entity' | 'ip_asset' | 'contract' | 'contract_clause' | 'privacy_policy' | 'compliance_requirement' | 'risk' | 'data_contract' | 'audit_log_policy' | 'compliance_framework' | 'security_audit' | 'service_level_indicator' | 'service_level_objective' | 'error_budget' | 'incident' | 'postmortem' | 'runbook' | 'monitor' | 'alert_rule' | 'ci_pipeline' | 'release_strategy' | 'on_call_rotation' | 'infrastructure_component' | 'threat_model' | 'threat' | 'vulnerability' | 'security_control' | 'security_policy' | 'penetration_test' | 'security_review' | 'data_classification' | 'access_policy' | 'a11y_standard' | 'a11y_guideline' | 'a11y_audit' | 'a11y_issue' | 'a11y_annotation' | 'test_suite' | 'test_case' | 'qa_session' | 'regression_test' | 'test_coverage_report' | 'test_environment' | 'test_result' | 'feedback_program' | 'feature_request' | 'feedback_vote' | 'nps_campaign' | 'user_advisory_board' | 'beta_program' | 'feedback_theme' | 'pricing_strategy' | 'discount_strategy' | 'trial_config' | 'paywall' | 'ai_model' | 'prompt_version' | 'eval_benchmark' | 'eval_run' | 'ai_cost_tracker' | 'hallucination_report' | 'ai_guardrail' | 'model_comparison' | 'ai_experiment' | 'ai_dataset' | 'ai_trace' | 'workflow_template' | 'workflow_run' | 'agent_definition' | 'agent_session' | 'review_gate' | 'approval_record' | 'agent_skill' | 'agent_hook' | 'workflow_artifact' | 'agent_task' | 'organization' | 'portfolio' | 'product_area' | 'workspace' | 'framework_exercise' | 'account' | 'contact' | 'lead' | 'deal' | 'pipeline_sales' | 'pipeline_stage' | 'quote_document' | 'subscription' | 'invoice' | 'forecast' | 'program' | 'project' | 'milestone' | 'risk_register' | 'change_request' | 'deliverable' | 'resource_allocation' | 'status_report' | 'marketing_strategy' | 'marketing_channel' | 'marketing_campaign_plan' | 'email_sequence' | 'social_post' | 'seo_keyword' | 'ad_creative' | 'press_release' | 'event' | 'community_initiative' | 'support_ticket' | 'customer_feedback' | 'churn_reason' | 'customer_health_score' | 'playbook' | 'service_level_agreement' | 'customer_journey_stage' | 'touchpoint' | 'success_milestone' | 'service_blueprint' | 'locale' | 'translation_key' | 'translation_bundle' | 'locale_config' | 'cultural_adaptation' | 'regional_pricing' | 'education_program' | 'tutorial' | 'walkthrough' | 'webinar' | 'certification' | 'help_video' | 'learning_path' | 'partner_program' | 'partner_tier' | 'api_ecosystem' | 'marketplace_listing' | 'developer_portal' | 'integration_partner' | 'partner_revenue_share';
|
|
14
|
+
type UPGEntityType = 'specification' | 'primitive' | 'operating_lifecycle' | 'operating_stage' | 'product' | 'outcome' | 'objective' | 'key_result' | 'metric' | 'metric_quality_assessment' | 'vision' | 'mission' | 'strategic_theme' | 'initiative' | 'capability' | 'value_stream' | 'strategic_pillar' | 'assumption' | 'decision' | 'constraint' | 'strategic_question' | 'persona' | 'job' | 'need' | 'desired_outcome' | 'job_step' | 'switching_cost' | 'opportunity' | 'solution' | 'feasibility_study' | 'design_sprint' | 'hypothesis' | 'hypothesis_evidence' | 'experiment' | 'experiment_plan' | 'experiment_run' | 'learning' | 'test_plan' | 'evidence' | 'research_plan' | 'competitor' | 'competitor_feature' | 'competitor_signal' | 'market_trend' | 'market_segment' | 'competitive_analysis' | 'classification_axis' | 'classification_value' | 'research_study' | 'insight' | 'participant' | 'observation' | 'quote' | 'affinity_cluster' | 'research_question' | 'interview_guide' | 'survey_response' | 'user_journey' | 'journey_step' | 'journey_phase' | 'journey_action' | 'design_question' | 'design_concept' | 'prototype' | 'wireframe' | 'user_flow' | 'screen' | 'screen_state' | 'annotation' | 'interaction_spec' | 'design_component' | 'design_token' | 'design_system' | 'design_pattern' | 'design_guideline' | 'brand_identity' | 'brand_colour' | 'brand_typography' | 'brand_voice' | 'brand_logo' | 'brand_imagery' | 'feature_area' | 'feature' | 'epic' | 'user_story' | 'story_statement' | 'story_task' | 'acceptance_criterion' | 'release' | 'task' | 'bug' | 'roadmap' | 'roadmap_item' | 'theme' | 'roadmap_theme' | 'changelog' | 'bounded_context' | 'service' | 'domain_event' | 'api_contract' | 'technical_debt_item' | 'feature_flag' | 'deployment' | 'aggregate' | 'domain_entity' | 'value_object' | 'command' | 'read_model' | 'api_endpoint' | 'database_schema' | 'queue_topic' | 'build_artifact' | 'code_repository' | 'library_dependency' | 'integration_pattern' | 'external_api' | 'data_flow' | 'investigation' | 'root_cause' | 'symptom' | 'fix' | 'funnel' | 'funnel_step' | 'acquisition_channel' | 'growth_campaign' | 'cohort' | 'behavioral_segment' | 'growth_loop' | 'variant' | 'attribution_model' | 'business_model' | 'value_proposition' | 'revenue_stream' | 'pricing_tier' | 'cost_structure' | 'unit_economics' | 'partnership' | 'key_resource' | 'key_activity' | 'customer_relationship' | 'distribution_channel' | 'gtm_strategy' | 'ideal_customer_profile' | 'positioning' | 'messaging' | 'launch' | 'content_strategy' | 'sales_motion' | 'competitive_battle_card' | 'demand_gen_program' | 'territory' | 'objection' | 'rebuttal' | 'proof_point' | 'team' | 'role' | 'stakeholder' | 'person' | 'team_okr' | 'retrospective' | 'dependency' | 'department' | 'skill' | 'ceremony' | 'capacity_plan' | 'data_source' | 'event_schema' | 'dashboard' | 'data_model' | 'data_quality_rule' | 'data_product' | 'data_pipeline' | 'data_lineage' | 'glossary_term' | 'data_domain' | 'report' | 'content_piece' | 'knowledge_base_article' | 'brand_asset' | 'prompt_template' | 'content_calendar' | 'content_theme' | 'documentation_template' | 'document' | 'legal_entity' | 'ip_asset' | 'contract' | 'contract_clause' | 'privacy_policy' | 'compliance_requirement' | 'risk' | 'data_contract' | 'audit_log_policy' | 'compliance_framework' | 'security_audit' | 'service_level_indicator' | 'service_level_objective' | 'error_budget' | 'incident' | 'postmortem' | 'runbook' | 'monitor' | 'alert_rule' | 'ci_pipeline' | 'release_strategy' | 'on_call_rotation' | 'infrastructure_component' | 'threat_model' | 'threat' | 'vulnerability' | 'security_control' | 'security_policy' | 'penetration_test' | 'security_review' | 'data_classification' | 'access_policy' | 'a11y_standard' | 'a11y_guideline' | 'a11y_audit' | 'a11y_issue' | 'a11y_annotation' | 'test_suite' | 'test_case' | 'qa_session' | 'regression_test' | 'test_coverage_report' | 'test_environment' | 'test_result' | 'feedback_program' | 'feature_request' | 'feedback_vote' | 'nps_campaign' | 'user_advisory_board' | 'beta_program' | 'feedback_theme' | 'pricing_strategy' | 'discount_strategy' | 'trial_config' | 'paywall' | 'ai_model' | 'prompt_version' | 'eval_benchmark' | 'eval_run' | 'ai_cost_tracker' | 'hallucination_report' | 'ai_guardrail' | 'model_comparison' | 'ai_experiment' | 'ai_dataset' | 'ai_trace' | 'workflow_template' | 'workflow_run' | 'agent_definition' | 'agent_session' | 'review_gate' | 'approval_record' | 'agent_skill' | 'agent_hook' | 'workflow_artifact' | 'agent_task' | 'organization' | 'portfolio' | 'product_area' | 'workspace' | 'framework_exercise' | 'account' | 'contact' | 'lead' | 'deal' | 'pipeline_sales' | 'pipeline_stage' | 'quote_document' | 'subscription' | 'invoice' | 'forecast' | 'program' | 'project' | 'milestone' | 'risk_register' | 'change_request' | 'deliverable' | 'resource_allocation' | 'status_report' | 'marketing_strategy' | 'marketing_channel' | 'marketing_campaign_plan' | 'email_sequence' | 'social_post' | 'seo_keyword' | 'ad_creative' | 'press_release' | 'event' | 'community_initiative' | 'support_ticket' | 'customer_feedback' | 'churn_reason' | 'customer_health_score' | 'playbook' | 'service_level_agreement' | 'customer_journey_stage' | 'touchpoint' | 'success_milestone' | 'service_blueprint' | 'locale' | 'translation_key' | 'translation_bundle' | 'locale_config' | 'cultural_adaptation' | 'regional_pricing' | 'education_program' | 'tutorial' | 'walkthrough' | 'webinar' | 'certification' | 'help_video' | 'learning_path' | 'partner_program' | 'partner_tier' | 'api_ecosystem' | 'marketplace_listing' | 'developer_portal' | 'integration_partner' | 'partner_revenue_share';
|
|
15
15
|
/**
|
|
16
16
|
* No entity types are currently deprecated; this union is `never`. The
|
|
17
17
|
* deprecated-name bridge, which previously widened this union to early
|
|
@@ -250,6 +250,22 @@ interface UPGEdgeDefinition {
|
|
|
250
250
|
* live in `UPG_CROSS_ONLY_EDGE_TYPES` instead. Discoverable via `get_edge_type`.
|
|
251
251
|
*/
|
|
252
252
|
cross_product_eligible?: true;
|
|
253
|
+
/**
|
|
254
|
+
* Deliberate-only marker (0.17.4). When `true`, this edge carries a meaning that
|
|
255
|
+
* is a deliberate authoring act, NOT a relationship that can be inferred from a
|
|
256
|
+
* source's hierarchy or a generic parent nesting. `objective_defers_feature` /
|
|
257
|
+
* `objective_defers_capability` mean an objective explicitly PARKS a
|
|
258
|
+
* feature/capability out of scope, the opposite of the "this child contributes to
|
|
259
|
+
* this parent" link a nesting implies. Generic-inference chokepoints
|
|
260
|
+
* (`inferEdgeTypeWithTier` in auto-nest mode, the adapter parentage resolvers)
|
|
261
|
+
* skip these, declining to auto-materialise them so the write path falls back to a
|
|
262
|
+
* `node_informs_node` link or a decline+warn. Explicit resolution
|
|
263
|
+
* (`resolve_edge_for_pair`, `create_edge`) is UNAFFECTED — the edge is authored on
|
|
264
|
+
* request. Single source of truth: `UPG_DELIBERATE_ONLY_EDGE_TYPES` (the runtime
|
|
265
|
+
* list) and `isDeliberateOnlyEdge` derive from this flag, so flagging one edge here
|
|
266
|
+
* is the only edit needed. Discoverable via `get_edge_type`.
|
|
267
|
+
*/
|
|
268
|
+
deliberate_only?: true;
|
|
253
269
|
}
|
|
254
270
|
/**
|
|
255
271
|
* Property schema carried by the two classification cross-edges
|
|
@@ -261,6 +277,16 @@ interface UPGEdgeDefinition {
|
|
|
261
277
|
* mirroring the `competitor.confidence` entity precedent. 0.10.4.
|
|
262
278
|
*/
|
|
263
279
|
declare const CLASSIFICATION_EDGE_PROPERTY_SCHEMA: PropertySchema;
|
|
280
|
+
/**
|
|
281
|
+
* Property schema carried by the two defer edges (`objective_defers_feature`
|
|
282
|
+
* and `objective_defers_capability`, 0.17.4). A single freeform `deferred_to`
|
|
283
|
+
* key names the period the parked work is deferred to. Freeform on purpose,
|
|
284
|
+
* mirroring `strategic_theme.time_horizon` ("Q1 2026", "FY26"): a deferral
|
|
285
|
+
* target is a planning label, not a typed date, and can name a quarter, a
|
|
286
|
+
* release, or a coarser horizon. Optional (a defer edge is meaningful without
|
|
287
|
+
* a stated period); the writers reject any other key.
|
|
288
|
+
*/
|
|
289
|
+
declare const DEFER_EDGE_PROPERTY_SCHEMA: PropertySchema;
|
|
264
290
|
declare const UPG_EDGE_CATALOG: {
|
|
265
291
|
product_targets_persona: {
|
|
266
292
|
forward_verb: string;
|
|
@@ -7433,6 +7459,58 @@ declare const UPG_EDGE_CATALOG: {
|
|
|
7433
7459
|
source_type: string;
|
|
7434
7460
|
target_type: string;
|
|
7435
7461
|
};
|
|
7462
|
+
objective_depends_on_dependency: {
|
|
7463
|
+
forward_verb: string;
|
|
7464
|
+
reverse_verb: string;
|
|
7465
|
+
classification: "cross-domain";
|
|
7466
|
+
source_type: string;
|
|
7467
|
+
target_type: string;
|
|
7468
|
+
cross_product_eligible: true;
|
|
7469
|
+
};
|
|
7470
|
+
dependency_blocks_objective: {
|
|
7471
|
+
forward_verb: string;
|
|
7472
|
+
reverse_verb: string;
|
|
7473
|
+
classification: "cross-domain";
|
|
7474
|
+
source_type: string;
|
|
7475
|
+
target_type: string;
|
|
7476
|
+
cross_product_eligible: true;
|
|
7477
|
+
};
|
|
7478
|
+
objective_raises_strategic_question: {
|
|
7479
|
+
forward_verb: string;
|
|
7480
|
+
reverse_verb: string;
|
|
7481
|
+
classification: "hierarchy";
|
|
7482
|
+
source_type: string;
|
|
7483
|
+
target_type: string;
|
|
7484
|
+
};
|
|
7485
|
+
initiative_raises_strategic_question: {
|
|
7486
|
+
forward_verb: string;
|
|
7487
|
+
reverse_verb: string;
|
|
7488
|
+
classification: "hierarchy";
|
|
7489
|
+
source_type: string;
|
|
7490
|
+
target_type: string;
|
|
7491
|
+
};
|
|
7492
|
+
objective_defers_feature: {
|
|
7493
|
+
forward_verb: string;
|
|
7494
|
+
reverse_verb: string;
|
|
7495
|
+
classification: "cross-domain";
|
|
7496
|
+
source_type: string;
|
|
7497
|
+
target_type: string;
|
|
7498
|
+
carries_properties: true;
|
|
7499
|
+
property_schema: PropertySchema;
|
|
7500
|
+
cross_product_eligible: true;
|
|
7501
|
+
deliberate_only: true;
|
|
7502
|
+
};
|
|
7503
|
+
objective_defers_capability: {
|
|
7504
|
+
forward_verb: string;
|
|
7505
|
+
reverse_verb: string;
|
|
7506
|
+
classification: "semantic";
|
|
7507
|
+
source_type: string;
|
|
7508
|
+
target_type: string;
|
|
7509
|
+
carries_properties: true;
|
|
7510
|
+
property_schema: PropertySchema;
|
|
7511
|
+
cross_product_eligible: true;
|
|
7512
|
+
deliberate_only: true;
|
|
7513
|
+
};
|
|
7436
7514
|
};
|
|
7437
7515
|
/** The `UPGEdgeType` union derived from the registry above. Declared here (not
|
|
7438
7516
|
* in `shapes/edges.ts`) so the polymorphic list below can reference it
|
|
@@ -7468,6 +7546,35 @@ declare const UPG_CROSS_ELIGIBLE_CATALOG_EDGE_TYPES: readonly CrossProductEligib
|
|
|
7468
7546
|
* isCrossProductEligible('feature_area_contains_feature') // → false
|
|
7469
7547
|
*/
|
|
7470
7548
|
declare function isCrossProductEligible(type: string): boolean;
|
|
7549
|
+
/**
|
|
7550
|
+
* The deliberate-only edges, as a value-filtered union derived from the
|
|
7551
|
+
* `deliberate_only` flag (0.17.4). Same `satisfies`-preserved pattern as
|
|
7552
|
+
* `CrossProductEligibleEdgeType`: flag one catalog entry and it appears here with
|
|
7553
|
+
* no other edit. These edges must never be inferred from a generic parent nesting;
|
|
7554
|
+
* generic-inference chokepoints skip them.
|
|
7555
|
+
*/
|
|
7556
|
+
type DeliberateOnlyEdgeType = {
|
|
7557
|
+
[K in keyof typeof UPG_EDGE_CATALOG]: typeof UPG_EDGE_CATALOG[K] extends {
|
|
7558
|
+
deliberate_only: true;
|
|
7559
|
+
} ? K : never;
|
|
7560
|
+
}[keyof typeof UPG_EDGE_CATALOG];
|
|
7561
|
+
/**
|
|
7562
|
+
* Runtime list of catalog edges flagged `deliberate_only`, derived from the catalog
|
|
7563
|
+
* in declaration order. The single source of truth the SDK's auto-nest inference and
|
|
7564
|
+
* the import adapters' parentage resolvers consume, so a deliberate-only edge
|
|
7565
|
+
* self-excludes from every generic-inference path with one flag.
|
|
7566
|
+
*/
|
|
7567
|
+
declare const UPG_DELIBERATE_ONLY_EDGE_TYPES: readonly DeliberateOnlyEdgeType[];
|
|
7568
|
+
/**
|
|
7569
|
+
* True if this catalog edge is deliberate-only: it must be authored explicitly and
|
|
7570
|
+
* is never inferred from a generic parent nesting (0.17.4). Accepts any string for
|
|
7571
|
+
* ergonomic call sites.
|
|
7572
|
+
*
|
|
7573
|
+
* @example
|
|
7574
|
+
* isDeliberateOnlyEdge('objective_defers_feature') // → true
|
|
7575
|
+
* isDeliberateOnlyEdge('feature_area_contains_feature') // → false
|
|
7576
|
+
*/
|
|
7577
|
+
declare function isDeliberateOnlyEdge(type: string): boolean;
|
|
7471
7578
|
/**
|
|
7472
7579
|
* Canonical allow-list of edges that use the `'node'` wildcard endpoint.
|
|
7473
7580
|
*
|
|
@@ -8189,7 +8296,7 @@ declare const UPG_DOMAINS: readonly [{
|
|
|
8189
8296
|
readonly id: "strategy";
|
|
8190
8297
|
readonly label: "Strategy";
|
|
8191
8298
|
readonly description: "The high-level direction of your product. Tracks the product itself, vision, mission, strategic themes, strategic pillars, initiatives, and capabilities that define what to build. Outcomes, objectives, and key results (OKRs) measure progress. Metrics quantify success. Assumptions and decisions record the reasoning. Value streams map how value flows. Connects upward to Portfolio and downward to Product Specification and Discovery.";
|
|
8192
|
-
readonly types: readonly ["product", "outcome", "objective", "key_result", "metric", "metric_quality_assessment", "vision", "mission", "strategic_theme", "initiative", "capability", "value_stream", "strategic_pillar", "assumption", "decision", "constraint"];
|
|
8299
|
+
readonly types: readonly ["product", "outcome", "objective", "key_result", "metric", "metric_quality_assessment", "vision", "mission", "strategic_theme", "initiative", "capability", "value_stream", "strategic_pillar", "assumption", "decision", "constraint", "strategic_question"];
|
|
8193
8300
|
}, {
|
|
8194
8301
|
readonly id: "user";
|
|
8195
8302
|
readonly label: "User";
|
|
@@ -10408,6 +10515,35 @@ interface AssumptionProperties {
|
|
|
10408
10515
|
/** Observation that would prove this assumption false */
|
|
10409
10516
|
falsifiability?: string;
|
|
10410
10517
|
}
|
|
10518
|
+
/** StrategicQuestion entity.
|
|
10519
|
+
*
|
|
10520
|
+
* An open coordination or ownership question a plan is exposed to: who owns a
|
|
10521
|
+
* capability across teams, where a boundary falls after a reorg. The
|
|
10522
|
+
* strategy-domain sibling of `research_question` and `design_question`.
|
|
10523
|
+
*
|
|
10524
|
+
* Distinct from `assumption`. An assumption is a premise the plan is built on
|
|
10525
|
+
* and resolves by being tested (`assumption_becomes_hypothesis`). A
|
|
10526
|
+
* strategic_question is not a testable premise; it is an unresolved question
|
|
10527
|
+
* the plan is exposed to and carries until someone answers it. `status` is the
|
|
10528
|
+
* node lifecycle (open → resolved); the answer lands in `resolution`.
|
|
10529
|
+
*
|
|
10530
|
+
* @example
|
|
10531
|
+
* const properties: StrategicQuestionProperties = {
|
|
10532
|
+
* question: 'Who owns Variants delivery across MCP, Content Agent, and SDK?',
|
|
10533
|
+
* context: 'Studio does not own the full platform deployment path.',
|
|
10534
|
+
* priority: 'high',
|
|
10535
|
+
* }
|
|
10536
|
+
*/
|
|
10537
|
+
interface StrategicQuestionProperties {
|
|
10538
|
+
/** The question itself. Primary content. */
|
|
10539
|
+
question?: string;
|
|
10540
|
+
/** Context that surfaced the question: the reorg, the boundary, the unowned area. */
|
|
10541
|
+
context?: string;
|
|
10542
|
+
/** The answer, captured when the question moves to `resolved`. */
|
|
10543
|
+
resolution?: string;
|
|
10544
|
+
/** Importance to resolve relative to other open questions. */
|
|
10545
|
+
priority?: Priority;
|
|
10546
|
+
}
|
|
10411
10547
|
/** Decision record. Strategic, product, engineering, or design.
|
|
10412
10548
|
*
|
|
10413
10549
|
* @example
|
|
@@ -18524,6 +18660,8 @@ interface UPGPropertyMap {
|
|
|
18524
18660
|
/** A named limitation or boundary (resource, technical, regulatory,
|
|
18525
18661
|
* temporal, or compliance) that bounds product creation. Edge-defined. */
|
|
18526
18662
|
constraint: ConstraintProperties;
|
|
18663
|
+
/** An open coordination or ownership question a plan is exposed to (strategy sibling of research_question / design_question) */
|
|
18664
|
+
strategic_question: StrategicQuestionProperties;
|
|
18527
18665
|
/** A user persona representing a segment of people the product serves */
|
|
18528
18666
|
persona: PersonaProperties;
|
|
18529
18667
|
/** A job-to-be-done: the progress a user is trying to make */
|
|
@@ -22066,7 +22204,7 @@ declare function isCanonical(text: string): boolean;
|
|
|
22066
22204
|
* it stamps the `upg_version` field of every `.upg` file written by the SDK.
|
|
22067
22205
|
* The `check:version-lockstep` gate enforces this at release time.
|
|
22068
22206
|
*/
|
|
22069
|
-
declare const UPG_VERSION: "0.17.
|
|
22207
|
+
declare const UPG_VERSION: "0.17.4";
|
|
22070
22208
|
/**
|
|
22071
22209
|
* The `.upg` JSON document format version. Written to the `upg_version` field.
|
|
22072
22210
|
* Evolves independently from `UPG_VERSION` (the catalogue version).
|
|
@@ -22191,4 +22329,4 @@ declare const UPG_EDGE_COUNT: number;
|
|
|
22191
22329
|
*/
|
|
22192
22330
|
declare const UPG_META_COUNT: number;
|
|
22193
22331
|
|
|
22194
|
-
export { type A11yAnnotationProperties, type A11yAuditProperties, type A11yGuidelineProperties, type A11yIssueProperties, type A11yStandardProperties, ANALYTICS_DATA_PLAYBOOK, type AcceptanceCriterionProperties, type AccessPolicyProperties, type AccountProperties, type AcquisitionChannelProperties, type AdCreativeProperties, type AffinityClusterProperties, type AgentDefinitionProperties, type AgentHookProperties, type AgentSessionProperties, type AgentSkillProperties, type AgentTaskProperties, type AggregateProperties, type AiCostTrackerProperties, type AiDatasetProperties, type AiExperimentProperties, type AiGuardrailProperties, type AiModelProperties, type AiTraceProperties, type AlertRuleProperties, type AnnotationProperties, type AntiPatternInputs, type AntiPatternViolation, type AnyUPGEntityType, type ApiContractProperties, type ApiEcosystemProperties, type ApiEndpointProperties, type ApproachBinding, type ApproachFilter, type ApproachRun, type ApproachRuntime, type ApprovalRecordProperties, type AssumptionProperties, type AttributionModelProperties, type AuditLogPolicyProperties, BUSINESS_GROWTH_METRIC_DRIVEN_PLAYBOOK, BUSINESS_GTM_GROWTH_PLAYBOOK, BUSINESS_MARKETING_AUDIENCE_FIRST_PLAYBOOK, type BehavioralSegmentProperties, type BenchmarkCheck, type BetaProgramProperties, type BoundedContextProperties, type BrandAssetProperties, type BrandColourProperties, type BrandIdentityProperties, type BrandImageryProperties, type BrandLogoProperties, type BrandTypographyProperties, type BrandVoiceProperties, type BugProperties, type BuildArtifactProperties, type BusinessModelProperties, CLASSIFICATION_EDGE_PROPERTY_SCHEMA, CONTENT_DEPTH_WARNING_RULES, COVERAGE_ANTI_PATTERNS, type Cadence, type CapabilityProperties, type CapacityPlanProperties, type CauseConfidence, type CeremonyProperties, type CertificationProperties, type ChangeRequestProperties, type ChangelogProperties, type ChurnReasonProperties, type CiPipelineProperties, type ClassificationAxisProperties, type ClassificationCapability, type ClassificationCapabilitySurface, type ClassificationCommitment, type ClassificationValueProperties, type CodeRepositoryProperties, type CohortProperties, type ComfortLevel, type CommandProperties, type CommunityInitiativeProperties, type CompetitiveAnalysisProperties, type CompetitiveBattleCardProperties, type CompetitorFeatureProperties, type CompetitorProperties, type CompetitorSignalProperties, type ComplianceFrameworkProperties, type ComplianceRequirementProperties, type Confidence, type ConformanceLevel, type ConstraintKind, type ConstraintOrigin, type ConstraintProperties, type ConstraintStatus, type ContactProperties, type ContentCalendarProperties, type ContentPieceProperties, type ContentStrategyProperties, type ContentThemeProperties, type ContractClauseProperties, type ContractProperties, type CostStructureProperties, type CountBenchmark, type Cron, type CrossProductEligibleEdgeType, type CulturalAdaptationProperties, type CustomerFeedbackProperties, type CustomerHealthScoreProperties, type CustomerJourneyStageProperties, type CustomerRelationshipProperties, DEFAULT_ENTITY_EMOJI, DEFERRED_PROPOSED_BY_CONTRACT, DISCOVERY_RESEARCH_VALIDATION_PLAYBOOK, type DashboardProperties, type DataClassificationProperties, type DataContractProperties, type DataDomainProperties, type DataFlowProperties, type DataLineageProperties, type DataModelProperties, type DataPipelineProperties, type DataProductProperties, type DataQualityRuleProperties, type DataSensitivity, type DataSourceProperties, type DatabaseSchemaProperties, type DealProperties, type DecisionProperties, type DeliverableProperties, type DemandGenProgramProperties, type DepartmentProperties, type DependencyProperties, type DeploymentProperties, type DeprecatedUPGEntityType, type DesignComponentProperties, type DesignConceptProperties, type DesignGuidelineProperties, type DesignPatternProperties, type DesignQuestionProperties, type DesignSprintProperties, type DesignSystemProperties, type DesignTokenProperties, type DesiredOutcomeProperties, type DeveloperPortalProperties, type DifficultyLevel, type DiscountStrategyProperties, type DistributionChannelProperties, type DocumentProperties, type DocumentationTemplateProperties, type DomainActivation, type DomainCountCheck, type DomainEntityProperties, type DomainEventProperties, type DomainGuideStep, type DomainPopulationCheck, type Duration, ENGINEERING_PLATFORM_PLAYBOOK, ENTITY_EMOJI, EXPERIENCE_DESIGN_BRAND_PLAYBOOK, type EducationProgramProperties, type EmailSequenceProperties, type EmptyCell, type EmptyCellRationaleKind, type EntityCheck, type EntitySequenceStep, type EntityTypeMeta, type EntityTypeResolution, type EntryMode, type EpicProperties, type ErrorBudgetProperties, type EvalBenchmarkProperties, type EvalRunProperties, type EvaluateAntiPatternsOptions, type EventProperties, type EventSchemaProperties, type EvidenceDirection, type EvidenceProperties, type ExperimentPlanProperties, type ExperimentProperties, type ExperimentRunProperties, type ExternalApiProperties, FOUNDATIONS_PLAYBOOK, type FeasibilityStudyProperties, type FeatureAreaProperties, type FeatureFlagProperties, type FeatureProperties, type FeatureRequestProperties, type FeedbackProgramProperties, type FeedbackThemeProperties, type FeedbackVoteProperties, type FixProperties, type ForecastProperties, type FrameworkCategory, type FrameworkComputedProperty, type FrameworkConstant, type FrameworkDataSpec, type FrameworkEducation, type FrameworkEntityTypeSpec, type FrameworkExerciseProperties, type FrameworkInvocationStep, type FrameworkLayout, type FrameworkLevel, type FrameworkOrigin, type FrameworkPresentationSpec, type FrameworkPropertyRequirement, type FrameworkScoringMethod, type FrameworkSlot, type FrameworkStep, type FrameworkStructureSpec, type FrameworkValidationResult, type FrequencyRating, type FunnelProperties, type FunnelStage, type FunnelStepProperties, type GlossaryTermProperties, type GrowthCampaignProperties, type GrowthLoopProperties, type GtmStrategyProperties, type GuardrailStatus, type HallucinationReportProperties, type HealthStatus, type HelpVideoProperties, type HypothesisEvidenceProperties, type HypothesisProperties, type ISO4217, type ISODate, type ISODateTime, type IdealCustomerProfileProperties, type IncidentProperties, type IncidentSeverity, type InfrastructureComponentProperties, type InitiativeProperties, type InsightProperties, type IntegrationPartnerProperties, type IntegrationPatternProperties, type IntelligenceCondition, type InteractionSpecProperties, type InternalDocProperties, type InterviewGuideProperties, type InvestigationProperties, type InvoiceProperties, type IpAssetProperties, type JobProperties, type JobStepProperties, type JourneyActionProperties, type JourneyPhaseProperties, type JourneyStepProperties, type JourneyType, type KeyActivityProperties, type KeyResourceProperties, type KeyResultProperties, type KnowledgeBaseArticleProperties, LEGACY_PRODUCT_STAGES, type LaunchProperties, type LeadProperties, type LearningPathProperties, type LearningProperties, type LegalEntityProperties, type LibraryDependencyProperties, type LifecyclePhase, type LifecycleRenderShape, type LifecycleRenderState, type LifecycleRenderTransition, type LifecycleState, type LocaleConfigProperties, type LocaleProperties, type LogLevel, type LowMedHigh, MARKDOWN_FORMAT_VERSION, MARKET_COMPETITIVE_PLAYBOOK, type MarketSegmentProperties, type MarketTrendProperties, type MarketingCampaignPlanProperties, type MarketingChannelProperties, type MarketingPlatform, type MarketingStrategyProperties, type MarketplaceListingProperties, type MatrixSlot, type MaturityLevel, type MessagingProperties, type MetricCategory, type MetricDataPoint, type MetricDesignation, type MetricHealth, type MetricImpactLevel, type MetricIndicatorDirection, type MetricProperties, type MetricQualityAssessmentProperties, type MetricSegmentType, type MetricStatisticalFunction, type MilestoneProperties, type MissionProperties, type ModelComparisonProperties, type ModifiedProperty, type MonitorProperties, type NamedGroup, type NeedMaturity, type NeedProperties, type NeedValence, type NpsCampaignProperties, OPERATIONS_QUALITY_PLAYBOOK, type ObjectionProperties, type ObjectiveProperties, type ObservationProperties, type OnCallRotationProperties, type OperatingLifecycleProperties, type OperatingStageProperties, type OpportunityProperties, type OrganizationProperties, type OrphanCheck, type OutcomeProperties, PRODUCT_DELIVERY_PLAYBOOK, PROPERTY_MODIFIERS, PROPERTY_MODIFIER_SEMANTICS, PROPERTY_SCALE_MAP, type ParticipantProperties, type PartnerProgramProperties, type PartnerRevenueShareProperties, type PartnerTierProperties, type PartnershipProperties, type PaywallProperties, type PenetrationTestProperties, type PersonProperties, type PersonaProperties, type PipelineSalesProperties, type PipelineStageProperties, type PlaybookBinding, type PlaybookFilter, type PlaybookProperties, type PlaybookRun, type PlaybookRuntime, type PortfolioProperties, type PositioningProperties, type PostmortemProperties, type PressReleaseProperties, type PricingStrategyProperties, type PricingTierProperties, type PrimitiveProperties, type Priority, type PrivacyPolicyProperties, type ProductAreaProperties, type ProductProperties, type ProductStageCoercion, type ProgramProperties, type ProjectProperties, type PromptTemplateProperties, type PromptVersionProperties, type ProofPointProperties, type PropertyDefinition, type PropertyModifier, type PropertySchema, type Protocol, type PrototypeProperties, type ProxyConfidence, type ProxyReason, type QaSessionProperties, type QueueTopicProperties, type QuoteDocumentProperties, type QuoteProperties, RECORD_ENTITY_TYPES, REFLECT_MODES, REGISTRY_PRODUCT_ID, type RatioBenchmark, type ReadModelProperties, type RebuttalProperties, type ReflectMode, type RegionalPricingProperties, type RegressionTestProperties, type RelationshipBenchmark, type RelationshipCheck, type ReleaseProperties, type ReleaseStrategyProperties, type ReportProperties, type ResearchPlanProperties, type ResearchQuestionProperties, type ResearchStudyProperties, type ResourceAllocationProperties, type RetrospectiveProperties, type RevenueStreamProperties, type ReviewGateProperties, type RiskProperties, type RiskRegisterProperties, type RoadmapItemProperties, type RoadmapProperties, type RoadmapThemeProperties, type RoleProperties, type RootCauseProperties, type RuleStrength, type RunContext, type RunbookProperties, STRATEGY_OUTCOMES_PLAYBOOK, type SalesMotionProperties, type ScreenProperties, type ScreenStateProperties, type SecurityAuditProperties, type SecurityControlProperties, type SecurityPolicyProperties, type SecurityReviewProperties, type Semver, type SeoKeywordProperties, type SerializeOptions, type ServiceBlueprintProperties, type ServiceLevelAgreementProperties, type ServiceLevelIndicatorProperties, type ServiceLevelObjectiveProperties, type ServiceProperties, type SignalChannel, type SignalSentiment, type SignalUrgency, type SkillProperties, type SocialPostProperties, type SolutionProperties, type SpecificationProperties, type StageRange, type StakeholderProperties, type StatusReportProperties, type Step, type StepKind, type StepOutput, type StepOutputKind, type StoryTaskProperties, type StrategicPillarProperties, type StrategicThemeProperties, type StructurePattern, type SubSequenceStep, type SubscriptionProperties, type SuccessMilestoneProperties, type SupportTicketProperties, type SurfaceId, type SurveyResponseProperties, type SwitchingCostProperties, type SymptomProperties, THIN_GRAPH_THRESHOLD, type TableColumn, type TargetCustomerSegmentProperties, type TaskProperties, type TeamOkrProperties, type TeamProperties, type TechnicalDebtItemProperties, type TerritoryProperties, type TestCaseProperties, type TestCoverageReportProperties, type TestEnvironmentProperties, type TestPlanProperties, type TestResultProperties, type TestSuiteProperties, type ThreatModelProperties, type ThreatProperties, type Timeframe, type TotalEntityCountCheck, type TouchpointProperties, type TranslationBundleProperties, type TranslationKeyProperties, type TrialConfigProperties, type TutorialProperties, type UPGAnchorEntity, type UPGAntiPattern, type UPGAntiPatternConcern, type UPGAntiPatternSeverity, type UPGApproach, type UPGApproachEnvelope, type UPGApproachId, type UPGAreaTaxonomyEntry, type UPGAssessment, type UPGBaseNode, type UPGBenchmarkSource, type UPGBoundaryDirection, type UPGBoundaryEdge, type UPGCrossEdge, type UPGCrossEdgeType, type UPGCrossOnlyEdgeType, type UPGCuratedAntiPattern, type UPGDocument, type UPGDomain, type UPGDomainBridge, type UPGDomainId, type UPGDomainPattern, type UPGDomainRing, type UPGDomainUsageGuide, type UPGEdge, type UPGEdgeDefinition, type UPGEdgeMigration, type UPGEdgeMigrationEndpoints, type UPGEdgePickHint, type UPGEdgeType, type UPGEntityType, type UPGEntityTypeMaturity, type UPGEnumScaleDefinition, type UPGEnumScaleValue, type UPGFramework, type UPGFrameworkMeta, type UPGHeader, type UPGHeaderIntegrity, type UPGHeaderProvenance, type UPGIntegrity, type UPGLens, type UPGLensIntelligencePrompt, type UPGLifecycle, type UPGMappingConfidence, type UPGMemberKindKey, type UPGNode, type UPGOrganization, type UPGPlaybook, type UPGPortfolio, type UPGPortfolioDocument, type UPGPortfolioKind, type UPGProduct, type UPGProductArea, type UPGProductStage, type UPGPropertyMap, type UPGPropertyMigration, type UPGPropertyMigrationChange, type UPGRegion, type UPGRegionEntityMembership, type UPGRegionEntityRole, type UPGRegionId, type UPGRegionShape, type UPGRegistry, type UPGScalarToEdgeMigration, type UPGScaleDefinition, type UPGScalePoint, type UPGSource, type UPGSplitEdge, type UPGSplitMigration, type UPGSplitRoute, type UPGSplitRouteTarget, type UPGSplitTarget, type UPGTreeChild, type UPGTreeGapPolicy, type UPGTreePattern, type UPGTreePatternDetail, type UPGTreePatternEdge, type UPGTreePatternSummary, type UPGTypeLabel, type UPGTypeMigration, type UPGValidationError, type UPGValidationProfile, type UPGValidationResult, type UPGValidationWarning, type UPGWildcardEndpoint, UPG_ACTIVE_TYPES, UPG_ANTI_PATTERNS, UPG_ANTI_PATTERN_CONCERNS, UPG_APPROACHES, UPG_APPROACHES_BY_ID, UPG_AREA_TAXONOMY, UPG_AREA_TAXONOMY_BY_COVERAGE_KEY, UPG_CANONICAL_FORMAT_VERSION, UPG_CONTAINMENT_FREE_TYPES, UPG_COUNT_BENCHMARKS, UPG_CROSS_EDGE_TYPES, UPG_CROSS_ELIGIBLE_CATALOG_EDGE_TYPES, UPG_CROSS_ONLY_EDGE_TYPES, UPG_DEPRECATED_TYPES, UPG_DOMAINS, UPG_DOMAIN_ACTIVATION, UPG_DOMAIN_COUNT, UPG_DOMAIN_GUIDES, UPG_DOMAIN_RINGS, UPG_EDGE_CATALOG, UPG_EDGE_COUNT, UPG_EDGE_MIGRATIONS, UPG_EDGE_PAIR_MAP, UPG_EDGE_TYPES, UPG_ENTITY_COUNT, UPG_ENTITY_META, UPG_ENTITY_META_BY_ID, UPG_ENTITY_META_BY_NAME, UPG_ENTITY_TO_DOMAIN, UPG_ENUM_SCALES, UPG_FORMAT_VERSION, UPG_FRAMEWORKS, UPG_FRAMEWORKS_BY_CATEGORY, UPG_FRAMEWORKS_BY_ID, UPG_FRAMEWORK_CATEGORIES, UPG_LENSES, UPG_LIFECYCLES, UPG_LIFECYCLE_FREE_TYPES, UPG_LIFECYCLE_PLANNED_TYPES, UPG_META_COUNT, UPG_MIGRATIONS, UPG_PLAYBOOKS, UPG_POLYMORPHIC_EDGE_KEYS, UPG_PORTFOLIO_KINDS, UPG_PRODUCT_STAGES, UPG_PRODUCT_STAGE_COERCION_MAP, UPG_PROPERTY_MIGRATIONS, UPG_PROPERTY_SCHEMA, UPG_RATIO_BENCHMARKS, UPG_REGIONS, UPG_REGION_COUNT, UPG_REGION_MAP, UPG_RELATIONSHIP_BENCHMARKS, UPG_SCALAR_TO_EDGE_MIGRATIONS, UPG_SCALES, UPG_SPLIT_MIGRATIONS, UPG_STATUS_MIGRATIONS, UPG_STRUCTURE_PATTERNS, UPG_TREE_PATTERNS, UPG_TREE_PATTERNS_BY_ID, UPG_TYPES, UPG_TYPES_SET, UPG_TYPE_ALIASES, UPG_TYPE_LABELS, UPG_TYPE_LABELS_MAP, UPG_TYPE_NAMES, UPG_VALIDATION_PROFILES, UPG_VALID_CHILDREN, UPG_VERSION, UPG_WILDCARD_ENDPOINT, USERS_NEEDS_PLAYBOOK, type UnitEconomicsProperties, UnknownEntityTypeError, type UserAdvisoryBoardProperties, type UserFlowProperties, type UserJourneyProperties, type UserStoryProperties, type ValueObjectProperties, type ValuePropositionProperties, type ValueStreamProperties, type VariantProperties, type VisionProperties, type VulnerabilityProperties, type WalkMigrationChainResult, type WalkthroughProperties, type WebinarProperties, type WireframeProperties, type WorkflowArtifactProperties, type WorkflowRunProperties, type WorkflowTemplateProperties, type WorkspaceProperties, backfillSlug, buildTypeAliases, canBeChildOf, coerceProductStage, collectSlugsForType, compareVersions, computeBodyChecksum, concernEvaluatedFor, concernFor, concernGatesFor, describeTreePattern, edgeCarriesProperties, evaluateAntiPatterns, findInvalidStatusMigrationTargets, formatUpgText, friendlyToAssessment, generateSlug, getAnchorEntity, getAntiPatternById, getAntiPatterns, getAntiPatternsBySeverity, getAntiPatternsForStage, getAreaTaxonomyEntry, getBenchmark, getBenchmarksByDomain, getBusinessAreasForRegion, getCanonicalPlaybookForRegion, getCoverageKeysForRegion, getDefaultLens, getDeprecatedTypes, getDomainForType, getDomainIdForType, getDomainsInRing, getEdgePropertySchema, getEntityModifierSummary, getEnumScale, getEnumValueMeta, getGuideForDomain, getLens, getLensIds, getLensPlaybook, getLensesForDomain, getLifecycleForType, getLifecycleRenderShape, getMigrationMap, getPlaybookById, getPlaybooksForRegion, getPropertiesForScale, getPropertyDefaultScale, getPropertyMigrations, getPropertyModifier, getPropertySchema, getRegion, getRegionForEntityType, getReplacementType, getRingForDomain, getScalarToEdgeMigrations, getScale, getSplitMigrations, getTreePattern, getTypeId, getTypeName, getTypes, getUPGEdgeMigrations, getValidChildren, getVisibleTypes, hasStatusMigration, isAggregateShapedProperty, isCanonical, isCanonicalProductStage, isContainmentFreeType, isCrossProductEligible, isDeprecatedType, isDomainGuideStep, isEntitySequenceStep, isFrameworkInvocationStep, isLegacyProductStage, isLifecycleFreeType, isLifecyclePlannedType, isPolymorphicEdge, isPortfolio, isRecordEntity, isRegisteredPolymorphicEdge, isRuntimeStateShapedProperty, isSubSequenceStep, isThinCoverageAdvisory, isUPGDocument, listPropertiesByModifier, listStatusMigrations, listTreePatternSummaries, migrateEdge, migrateNode, migrateNodeProperties, migrateProductStage, migrateStatusValue, normalizeDocument, parseUpg, pickCanonicalEdge, resolveAllEdges, resolveContainmentEdge, resolveEntityType, resolveLabel, resolveSlugCollision, resolveTreePatternEdges, ringOrderedDomainIds, rotateSlug, serializeCanonical, validateEdgeProperties, validateProductStageStrict, validateUPGDocument, validateUPGFramework, validationProfileFor, walkMigrationChainToCanonical };
|
|
22332
|
+
export { type A11yAnnotationProperties, type A11yAuditProperties, type A11yGuidelineProperties, type A11yIssueProperties, type A11yStandardProperties, ANALYTICS_DATA_PLAYBOOK, type AcceptanceCriterionProperties, type AccessPolicyProperties, type AccountProperties, type AcquisitionChannelProperties, type AdCreativeProperties, type AffinityClusterProperties, type AgentDefinitionProperties, type AgentHookProperties, type AgentSessionProperties, type AgentSkillProperties, type AgentTaskProperties, type AggregateProperties, type AiCostTrackerProperties, type AiDatasetProperties, type AiExperimentProperties, type AiGuardrailProperties, type AiModelProperties, type AiTraceProperties, type AlertRuleProperties, type AnnotationProperties, type AntiPatternInputs, type AntiPatternViolation, type AnyUPGEntityType, type ApiContractProperties, type ApiEcosystemProperties, type ApiEndpointProperties, type ApproachBinding, type ApproachFilter, type ApproachRun, type ApproachRuntime, type ApprovalRecordProperties, type AssumptionProperties, type AttributionModelProperties, type AuditLogPolicyProperties, BUSINESS_GROWTH_METRIC_DRIVEN_PLAYBOOK, BUSINESS_GTM_GROWTH_PLAYBOOK, BUSINESS_MARKETING_AUDIENCE_FIRST_PLAYBOOK, type BehavioralSegmentProperties, type BenchmarkCheck, type BetaProgramProperties, type BoundedContextProperties, type BrandAssetProperties, type BrandColourProperties, type BrandIdentityProperties, type BrandImageryProperties, type BrandLogoProperties, type BrandTypographyProperties, type BrandVoiceProperties, type BugProperties, type BuildArtifactProperties, type BusinessModelProperties, CLASSIFICATION_EDGE_PROPERTY_SCHEMA, CONTENT_DEPTH_WARNING_RULES, COVERAGE_ANTI_PATTERNS, type Cadence, type CapabilityProperties, type CapacityPlanProperties, type CauseConfidence, type CeremonyProperties, type CertificationProperties, type ChangeRequestProperties, type ChangelogProperties, type ChurnReasonProperties, type CiPipelineProperties, type ClassificationAxisProperties, type ClassificationCapability, type ClassificationCapabilitySurface, type ClassificationCommitment, type ClassificationValueProperties, type CodeRepositoryProperties, type CohortProperties, type ComfortLevel, type CommandProperties, type CommunityInitiativeProperties, type CompetitiveAnalysisProperties, type CompetitiveBattleCardProperties, type CompetitorFeatureProperties, type CompetitorProperties, type CompetitorSignalProperties, type ComplianceFrameworkProperties, type ComplianceRequirementProperties, type Confidence, type ConformanceLevel, type ConstraintKind, type ConstraintOrigin, type ConstraintProperties, type ConstraintStatus, type ContactProperties, type ContentCalendarProperties, type ContentPieceProperties, type ContentStrategyProperties, type ContentThemeProperties, type ContractClauseProperties, type ContractProperties, type CostStructureProperties, type CountBenchmark, type Cron, type CrossProductEligibleEdgeType, type CulturalAdaptationProperties, type CustomerFeedbackProperties, type CustomerHealthScoreProperties, type CustomerJourneyStageProperties, type CustomerRelationshipProperties, DEFAULT_ENTITY_EMOJI, DEFERRED_PROPOSED_BY_CONTRACT, DEFER_EDGE_PROPERTY_SCHEMA, DISCOVERY_RESEARCH_VALIDATION_PLAYBOOK, type DashboardProperties, type DataClassificationProperties, type DataContractProperties, type DataDomainProperties, type DataFlowProperties, type DataLineageProperties, type DataModelProperties, type DataPipelineProperties, type DataProductProperties, type DataQualityRuleProperties, type DataSensitivity, type DataSourceProperties, type DatabaseSchemaProperties, type DealProperties, type DecisionProperties, type DeliberateOnlyEdgeType, type DeliverableProperties, type DemandGenProgramProperties, type DepartmentProperties, type DependencyProperties, type DeploymentProperties, type DeprecatedUPGEntityType, type DesignComponentProperties, type DesignConceptProperties, type DesignGuidelineProperties, type DesignPatternProperties, type DesignQuestionProperties, type DesignSprintProperties, type DesignSystemProperties, type DesignTokenProperties, type DesiredOutcomeProperties, type DeveloperPortalProperties, type DifficultyLevel, type DiscountStrategyProperties, type DistributionChannelProperties, type DocumentProperties, type DocumentationTemplateProperties, type DomainActivation, type DomainCountCheck, type DomainEntityProperties, type DomainEventProperties, type DomainGuideStep, type DomainPopulationCheck, type Duration, ENGINEERING_PLATFORM_PLAYBOOK, ENTITY_EMOJI, EXPERIENCE_DESIGN_BRAND_PLAYBOOK, type EducationProgramProperties, type EmailSequenceProperties, type EmptyCell, type EmptyCellRationaleKind, type EntityCheck, type EntitySequenceStep, type EntityTypeMeta, type EntityTypeResolution, type EntryMode, type EpicProperties, type ErrorBudgetProperties, type EvalBenchmarkProperties, type EvalRunProperties, type EvaluateAntiPatternsOptions, type EventProperties, type EventSchemaProperties, type EvidenceDirection, type EvidenceProperties, type ExperimentPlanProperties, type ExperimentProperties, type ExperimentRunProperties, type ExternalApiProperties, FOUNDATIONS_PLAYBOOK, type FeasibilityStudyProperties, type FeatureAreaProperties, type FeatureFlagProperties, type FeatureProperties, type FeatureRequestProperties, type FeedbackProgramProperties, type FeedbackThemeProperties, type FeedbackVoteProperties, type FixProperties, type ForecastProperties, type FrameworkCategory, type FrameworkComputedProperty, type FrameworkConstant, type FrameworkDataSpec, type FrameworkEducation, type FrameworkEntityTypeSpec, type FrameworkExerciseProperties, type FrameworkInvocationStep, type FrameworkLayout, type FrameworkLevel, type FrameworkOrigin, type FrameworkPresentationSpec, type FrameworkPropertyRequirement, type FrameworkScoringMethod, type FrameworkSlot, type FrameworkStep, type FrameworkStructureSpec, type FrameworkValidationResult, type FrequencyRating, type FunnelProperties, type FunnelStage, type FunnelStepProperties, type GlossaryTermProperties, type GrowthCampaignProperties, type GrowthLoopProperties, type GtmStrategyProperties, type GuardrailStatus, type HallucinationReportProperties, type HealthStatus, type HelpVideoProperties, type HypothesisEvidenceProperties, type HypothesisProperties, type ISO4217, type ISODate, type ISODateTime, type IdealCustomerProfileProperties, type IncidentProperties, type IncidentSeverity, type InfrastructureComponentProperties, type InitiativeProperties, type InsightProperties, type IntegrationPartnerProperties, type IntegrationPatternProperties, type IntelligenceCondition, type InteractionSpecProperties, type InternalDocProperties, type InterviewGuideProperties, type InvestigationProperties, type InvoiceProperties, type IpAssetProperties, type JobProperties, type JobStepProperties, type JourneyActionProperties, type JourneyPhaseProperties, type JourneyStepProperties, type JourneyType, type KeyActivityProperties, type KeyResourceProperties, type KeyResultProperties, type KnowledgeBaseArticleProperties, LEGACY_PRODUCT_STAGES, type LaunchProperties, type LeadProperties, type LearningPathProperties, type LearningProperties, type LegalEntityProperties, type LibraryDependencyProperties, type LifecyclePhase, type LifecycleRenderShape, type LifecycleRenderState, type LifecycleRenderTransition, type LifecycleState, type LocaleConfigProperties, type LocaleProperties, type LogLevel, type LowMedHigh, MARKDOWN_FORMAT_VERSION, MARKET_COMPETITIVE_PLAYBOOK, type MarketSegmentProperties, type MarketTrendProperties, type MarketingCampaignPlanProperties, type MarketingChannelProperties, type MarketingPlatform, type MarketingStrategyProperties, type MarketplaceListingProperties, type MatrixSlot, type MaturityLevel, type MessagingProperties, type MetricCategory, type MetricDataPoint, type MetricDesignation, type MetricHealth, type MetricImpactLevel, type MetricIndicatorDirection, type MetricProperties, type MetricQualityAssessmentProperties, type MetricSegmentType, type MetricStatisticalFunction, type MilestoneProperties, type MissionProperties, type ModelComparisonProperties, type ModifiedProperty, type MonitorProperties, type NamedGroup, type NeedMaturity, type NeedProperties, type NeedValence, type NpsCampaignProperties, OPERATIONS_QUALITY_PLAYBOOK, type ObjectionProperties, type ObjectiveProperties, type ObservationProperties, type OnCallRotationProperties, type OperatingLifecycleProperties, type OperatingStageProperties, type OpportunityProperties, type OrganizationProperties, type OrphanCheck, type OutcomeProperties, PRODUCT_DELIVERY_PLAYBOOK, PROPERTY_MODIFIERS, PROPERTY_MODIFIER_SEMANTICS, PROPERTY_SCALE_MAP, type ParticipantProperties, type PartnerProgramProperties, type PartnerRevenueShareProperties, type PartnerTierProperties, type PartnershipProperties, type PaywallProperties, type PenetrationTestProperties, type PersonProperties, type PersonaProperties, type PipelineSalesProperties, type PipelineStageProperties, type PlaybookBinding, type PlaybookFilter, type PlaybookProperties, type PlaybookRun, type PlaybookRuntime, type PortfolioProperties, type PositioningProperties, type PostmortemProperties, type PressReleaseProperties, type PricingStrategyProperties, type PricingTierProperties, type PrimitiveProperties, type Priority, type PrivacyPolicyProperties, type ProductAreaProperties, type ProductProperties, type ProductStageCoercion, type ProgramProperties, type ProjectProperties, type PromptTemplateProperties, type PromptVersionProperties, type ProofPointProperties, type PropertyDefinition, type PropertyModifier, type PropertySchema, type Protocol, type PrototypeProperties, type ProxyConfidence, type ProxyReason, type QaSessionProperties, type QueueTopicProperties, type QuoteDocumentProperties, type QuoteProperties, RECORD_ENTITY_TYPES, REFLECT_MODES, REGISTRY_PRODUCT_ID, type RatioBenchmark, type ReadModelProperties, type RebuttalProperties, type ReflectMode, type RegionalPricingProperties, type RegressionTestProperties, type RelationshipBenchmark, type RelationshipCheck, type ReleaseProperties, type ReleaseStrategyProperties, type ReportProperties, type ResearchPlanProperties, type ResearchQuestionProperties, type ResearchStudyProperties, type ResourceAllocationProperties, type RetrospectiveProperties, type RevenueStreamProperties, type ReviewGateProperties, type RiskProperties, type RiskRegisterProperties, type RoadmapItemProperties, type RoadmapProperties, type RoadmapThemeProperties, type RoleProperties, type RootCauseProperties, type RuleStrength, type RunContext, type RunbookProperties, STRATEGY_OUTCOMES_PLAYBOOK, type SalesMotionProperties, type ScreenProperties, type ScreenStateProperties, type SecurityAuditProperties, type SecurityControlProperties, type SecurityPolicyProperties, type SecurityReviewProperties, type Semver, type SeoKeywordProperties, type SerializeOptions, type ServiceBlueprintProperties, type ServiceLevelAgreementProperties, type ServiceLevelIndicatorProperties, type ServiceLevelObjectiveProperties, type ServiceProperties, type SignalChannel, type SignalSentiment, type SignalUrgency, type SkillProperties, type SocialPostProperties, type SolutionProperties, type SpecificationProperties, type StageRange, type StakeholderProperties, type StatusReportProperties, type Step, type StepKind, type StepOutput, type StepOutputKind, type StoryTaskProperties, type StrategicPillarProperties, type StrategicQuestionProperties, type StrategicThemeProperties, type StructurePattern, type SubSequenceStep, type SubscriptionProperties, type SuccessMilestoneProperties, type SupportTicketProperties, type SurfaceId, type SurveyResponseProperties, type SwitchingCostProperties, type SymptomProperties, THIN_GRAPH_THRESHOLD, type TableColumn, type TargetCustomerSegmentProperties, type TaskProperties, type TeamOkrProperties, type TeamProperties, type TechnicalDebtItemProperties, type TerritoryProperties, type TestCaseProperties, type TestCoverageReportProperties, type TestEnvironmentProperties, type TestPlanProperties, type TestResultProperties, type TestSuiteProperties, type ThreatModelProperties, type ThreatProperties, type Timeframe, type TotalEntityCountCheck, type TouchpointProperties, type TranslationBundleProperties, type TranslationKeyProperties, type TrialConfigProperties, type TutorialProperties, type UPGAnchorEntity, type UPGAntiPattern, type UPGAntiPatternConcern, type UPGAntiPatternSeverity, type UPGApproach, type UPGApproachEnvelope, type UPGApproachId, type UPGAreaTaxonomyEntry, type UPGAssessment, type UPGBaseNode, type UPGBenchmarkSource, type UPGBoundaryDirection, type UPGBoundaryEdge, type UPGCrossEdge, type UPGCrossEdgeType, type UPGCrossOnlyEdgeType, type UPGCuratedAntiPattern, type UPGDocument, type UPGDomain, type UPGDomainBridge, type UPGDomainId, type UPGDomainPattern, type UPGDomainRing, type UPGDomainUsageGuide, type UPGEdge, type UPGEdgeDefinition, type UPGEdgeMigration, type UPGEdgeMigrationEndpoints, type UPGEdgePickHint, type UPGEdgeType, type UPGEntityType, type UPGEntityTypeMaturity, type UPGEnumScaleDefinition, type UPGEnumScaleValue, type UPGFramework, type UPGFrameworkMeta, type UPGHeader, type UPGHeaderIntegrity, type UPGHeaderProvenance, type UPGIntegrity, type UPGLens, type UPGLensIntelligencePrompt, type UPGLifecycle, type UPGMappingConfidence, type UPGMemberKindKey, type UPGNode, type UPGOrganization, type UPGPlaybook, type UPGPortfolio, type UPGPortfolioDocument, type UPGPortfolioKind, type UPGProduct, type UPGProductArea, type UPGProductStage, type UPGPropertyMap, type UPGPropertyMigration, type UPGPropertyMigrationChange, type UPGRegion, type UPGRegionEntityMembership, type UPGRegionEntityRole, type UPGRegionId, type UPGRegionShape, type UPGRegistry, type UPGScalarToEdgeMigration, type UPGScaleDefinition, type UPGScalePoint, type UPGSource, type UPGSplitEdge, type UPGSplitMigration, type UPGSplitRoute, type UPGSplitRouteTarget, type UPGSplitTarget, type UPGTreeChild, type UPGTreeGapPolicy, type UPGTreePattern, type UPGTreePatternDetail, type UPGTreePatternEdge, type UPGTreePatternSummary, type UPGTypeLabel, type UPGTypeMigration, type UPGValidationError, type UPGValidationProfile, type UPGValidationResult, type UPGValidationWarning, type UPGWildcardEndpoint, UPG_ACTIVE_TYPES, UPG_ANTI_PATTERNS, UPG_ANTI_PATTERN_CONCERNS, UPG_APPROACHES, UPG_APPROACHES_BY_ID, UPG_AREA_TAXONOMY, UPG_AREA_TAXONOMY_BY_COVERAGE_KEY, UPG_CANONICAL_FORMAT_VERSION, UPG_CONTAINMENT_FREE_TYPES, UPG_COUNT_BENCHMARKS, UPG_CROSS_EDGE_TYPES, UPG_CROSS_ELIGIBLE_CATALOG_EDGE_TYPES, UPG_CROSS_ONLY_EDGE_TYPES, UPG_DELIBERATE_ONLY_EDGE_TYPES, UPG_DEPRECATED_TYPES, UPG_DOMAINS, UPG_DOMAIN_ACTIVATION, UPG_DOMAIN_COUNT, UPG_DOMAIN_GUIDES, UPG_DOMAIN_RINGS, UPG_EDGE_CATALOG, UPG_EDGE_COUNT, UPG_EDGE_MIGRATIONS, UPG_EDGE_PAIR_MAP, UPG_EDGE_TYPES, UPG_ENTITY_COUNT, UPG_ENTITY_META, UPG_ENTITY_META_BY_ID, UPG_ENTITY_META_BY_NAME, UPG_ENTITY_TO_DOMAIN, UPG_ENUM_SCALES, UPG_FORMAT_VERSION, UPG_FRAMEWORKS, UPG_FRAMEWORKS_BY_CATEGORY, UPG_FRAMEWORKS_BY_ID, UPG_FRAMEWORK_CATEGORIES, UPG_LENSES, UPG_LIFECYCLES, UPG_LIFECYCLE_FREE_TYPES, UPG_LIFECYCLE_PLANNED_TYPES, UPG_META_COUNT, UPG_MIGRATIONS, UPG_PLAYBOOKS, UPG_POLYMORPHIC_EDGE_KEYS, UPG_PORTFOLIO_KINDS, UPG_PRODUCT_STAGES, UPG_PRODUCT_STAGE_COERCION_MAP, UPG_PROPERTY_MIGRATIONS, UPG_PROPERTY_SCHEMA, UPG_RATIO_BENCHMARKS, UPG_REGIONS, UPG_REGION_COUNT, UPG_REGION_MAP, UPG_RELATIONSHIP_BENCHMARKS, UPG_SCALAR_TO_EDGE_MIGRATIONS, UPG_SCALES, UPG_SPLIT_MIGRATIONS, UPG_STATUS_MIGRATIONS, UPG_STRUCTURE_PATTERNS, UPG_TREE_PATTERNS, UPG_TREE_PATTERNS_BY_ID, UPG_TYPES, UPG_TYPES_SET, UPG_TYPE_ALIASES, UPG_TYPE_LABELS, UPG_TYPE_LABELS_MAP, UPG_TYPE_NAMES, UPG_VALIDATION_PROFILES, UPG_VALID_CHILDREN, UPG_VERSION, UPG_WILDCARD_ENDPOINT, USERS_NEEDS_PLAYBOOK, type UnitEconomicsProperties, UnknownEntityTypeError, type UserAdvisoryBoardProperties, type UserFlowProperties, type UserJourneyProperties, type UserStoryProperties, type ValueObjectProperties, type ValuePropositionProperties, type ValueStreamProperties, type VariantProperties, type VisionProperties, type VulnerabilityProperties, type WalkMigrationChainResult, type WalkthroughProperties, type WebinarProperties, type WireframeProperties, type WorkflowArtifactProperties, type WorkflowRunProperties, type WorkflowTemplateProperties, type WorkspaceProperties, backfillSlug, buildTypeAliases, canBeChildOf, coerceProductStage, collectSlugsForType, compareVersions, computeBodyChecksum, concernEvaluatedFor, concernFor, concernGatesFor, describeTreePattern, edgeCarriesProperties, evaluateAntiPatterns, findInvalidStatusMigrationTargets, formatUpgText, friendlyToAssessment, generateSlug, getAnchorEntity, getAntiPatternById, getAntiPatterns, getAntiPatternsBySeverity, getAntiPatternsForStage, getAreaTaxonomyEntry, getBenchmark, getBenchmarksByDomain, getBusinessAreasForRegion, getCanonicalPlaybookForRegion, getCoverageKeysForRegion, getDefaultLens, getDeprecatedTypes, getDomainForType, getDomainIdForType, getDomainsInRing, getEdgePropertySchema, getEntityModifierSummary, getEnumScale, getEnumValueMeta, getGuideForDomain, getLens, getLensIds, getLensPlaybook, getLensesForDomain, getLifecycleForType, getLifecycleRenderShape, getMigrationMap, getPlaybookById, getPlaybooksForRegion, getPropertiesForScale, getPropertyDefaultScale, getPropertyMigrations, getPropertyModifier, getPropertySchema, getRegion, getRegionForEntityType, getReplacementType, getRingForDomain, getScalarToEdgeMigrations, getScale, getSplitMigrations, getTreePattern, getTypeId, getTypeName, getTypes, getUPGEdgeMigrations, getValidChildren, getVisibleTypes, hasStatusMigration, isAggregateShapedProperty, isCanonical, isCanonicalProductStage, isContainmentFreeType, isCrossProductEligible, isDeliberateOnlyEdge, isDeprecatedType, isDomainGuideStep, isEntitySequenceStep, isFrameworkInvocationStep, isLegacyProductStage, isLifecycleFreeType, isLifecyclePlannedType, isPolymorphicEdge, isPortfolio, isRecordEntity, isRegisteredPolymorphicEdge, isRuntimeStateShapedProperty, isSubSequenceStep, isThinCoverageAdvisory, isUPGDocument, listPropertiesByModifier, listStatusMigrations, listTreePatternSummaries, migrateEdge, migrateNode, migrateNodeProperties, migrateProductStage, migrateStatusValue, normalizeDocument, parseUpg, pickCanonicalEdge, resolveAllEdges, resolveContainmentEdge, resolveEntityType, resolveLabel, resolveSlugCollision, resolveTreePatternEdges, ringOrderedDomainIds, rotateSlug, serializeCanonical, validateEdgeProperties, validateProductStageStrict, validateUPGDocument, validateUPGFramework, validationProfileFor, walkMigrationChainToCanonical };
|
package/dist/index.js
CHANGED
|
@@ -20,7 +20,8 @@ var UPG_DOMAINS = [
|
|
|
20
20
|
"strategic_pillar",
|
|
21
21
|
"assumption",
|
|
22
22
|
"decision",
|
|
23
|
-
"constraint"
|
|
23
|
+
"constraint",
|
|
24
|
+
"strategic_question"
|
|
24
25
|
]
|
|
25
26
|
},
|
|
26
27
|
{
|
|
@@ -539,6 +540,10 @@ var UPG_ENTITY_META = [
|
|
|
539
540
|
{ name: "assumption", type_id: "ent_014", maturity: "stable", since: "0.1.0" },
|
|
540
541
|
{ name: "decision", type_id: "ent_015", maturity: "stable", since: "0.1.0" },
|
|
541
542
|
{ name: "constraint", type_id: "ent_348", maturity: "stable", since: "0.4.3" },
|
|
543
|
+
// (0.17.4) Strategy-domain sibling of research_question / design_question,
|
|
544
|
+
// completing the domain-question triad. An open coordination/ownership question
|
|
545
|
+
// a plan is exposed to (distinct from `assumption`, which the plan is built on).
|
|
546
|
+
{ name: "strategic_question", type_id: "ent_357", maturity: "proposed", since: "0.17.4" },
|
|
542
547
|
// ── User ──
|
|
543
548
|
{ name: "persona", type_id: "ent_016", maturity: "stable", since: "0.1.0" },
|
|
544
549
|
{ name: "job", type_id: "ent_017", maturity: "stable", since: "0.1.0" },
|
|
@@ -1013,6 +1018,12 @@ var CLASSIFICATION_EDGE_PROPERTY_SCHEMA = {
|
|
|
1013
1018
|
description: "Optional. A source URL, or a competitor_signal / evidence node id backing the classification. Mirrors feature_rivals_competitor_feature.evidence (free text or a node id)."
|
|
1014
1019
|
}
|
|
1015
1020
|
};
|
|
1021
|
+
var DEFER_EDGE_PROPERTY_SCHEMA = {
|
|
1022
|
+
deferred_to: {
|
|
1023
|
+
type: "string",
|
|
1024
|
+
description: 'Target period the parked work is deferred to. Freeform, mirroring strategic_theme.time_horizon. @example "Q4 2026", "FY27", "next release".'
|
|
1025
|
+
}
|
|
1026
|
+
};
|
|
1016
1027
|
var UPG_EDGE_CATALOG = {
|
|
1017
1028
|
// ── Part 1: Core Narrative Spine (Ring 1) ──────────────────────────────────
|
|
1018
1029
|
// 1.1 User Domain
|
|
@@ -3087,7 +3098,45 @@ var UPG_EDGE_CATALOG = {
|
|
|
3087
3098
|
// Operating-lifecycle cross-edges (0.11.6): a product's journey phase realises a canonical
|
|
3088
3099
|
// operating stage (the cross-surface join key); a stage is measured by a rollup metric (loop close).
|
|
3089
3100
|
journey_phase_realises_operating_stage: { forward_verb: "realises", reverse_verb: "realised_by", classification: "cross-domain", source_type: "journey_phase", target_type: "operating_stage", cross_product_eligible: true },
|
|
3090
|
-
operating_stage_measured_by_metric: { forward_verb: "measured_by", reverse_verb: "measures", classification: "cross-domain", source_type: "operating_stage", target_type: "metric" }
|
|
3101
|
+
operating_stage_measured_by_metric: { forward_verb: "measured_by", reverse_verb: "measures", classification: "cross-domain", source_type: "operating_stage", target_type: "metric" },
|
|
3102
|
+
// ── OKR planning coverage (0.17.4) ──────────────────────────────────────────
|
|
3103
|
+
// Reconciling the strategy graph against a live planning doc surfaced texture
|
|
3104
|
+
// the objective — the node every OKR doc organises itself around — could not
|
|
3105
|
+
// reach: cross-team dependencies and deferred (out-of-scope) work.
|
|
3106
|
+
// objective ↔ dependency. Every OKR in the source doc carries a dependency
|
|
3107
|
+
// table ("which other team's work this depends on"). `dependency` (team_org)
|
|
3108
|
+
// already carries dependency_type / criticality / target_date; it was
|
|
3109
|
+
// reachable only from `team`. An objective DEPENDS ON a dependency; the
|
|
3110
|
+
// dependency BLOCKS the objective (explicit mirror, not left implicit).
|
|
3111
|
+
// Cross-domain, not hierarchy: a dependency is parented under its owning team,
|
|
3112
|
+
// so an objective references it laterally rather than containing it. Both are
|
|
3113
|
+
// cross_product_eligible — a Studio objective can depend on a dependency owned
|
|
3114
|
+
// by another team's graph within the portfolio (0.17.3 locked predicate).
|
|
3115
|
+
objective_depends_on_dependency: { forward_verb: "depends_on", reverse_verb: "dependency_of", classification: "cross-domain", source_type: "objective", target_type: "dependency", cross_product_eligible: true },
|
|
3116
|
+
dependency_blocks_objective: { forward_verb: "blocks", reverse_verb: "blocked_by", classification: "cross-domain", source_type: "dependency", target_type: "objective", cross_product_eligible: true },
|
|
3117
|
+
// objective / initiative → strategic_question. A planning doc's "Risks & Open
|
|
3118
|
+
// Questions" section names unresolved coordination questions the plan is
|
|
3119
|
+
// exposed to (who owns a capability across teams after a reorg). The
|
|
3120
|
+
// strategy-domain sibling of research_question / design_question. The question
|
|
3121
|
+
// is raised under (contained by) the objective or initiative that surfaces it,
|
|
3122
|
+
// so hierarchy — mirroring initiative_assumes_assumption. Within-graph: the
|
|
3123
|
+
// question node is authored alongside its objective, so NOT
|
|
3124
|
+
// cross_product_eligible (the cross-team nature lives in the question text, not
|
|
3125
|
+
// in a cross-graph edge).
|
|
3126
|
+
objective_raises_strategic_question: { forward_verb: "raises", reverse_verb: "raised_by", classification: "hierarchy", source_type: "objective", target_type: "strategic_question" },
|
|
3127
|
+
initiative_raises_strategic_question: { forward_verb: "raises", reverse_verb: "raised_by", classification: "hierarchy", source_type: "initiative", target_type: "strategic_question" },
|
|
3128
|
+
// objective → feature / capability (the defer / out-of-scope edge). Every OKR
|
|
3129
|
+
// in the source doc carries an explicit "Out of scope" list, load-bearing for
|
|
3130
|
+
// keeping a quarter from silently expanding (localization deferred to Q4,
|
|
3131
|
+
// another team's feature work parked). Modelled as an edge to the real feature
|
|
3132
|
+
// or capability parked for later, not a scalar exclusion string, so the parked
|
|
3133
|
+
// work stays queryable and connected. The `deferred_to` edge property carries
|
|
3134
|
+
// the temporal target. feature is product_spec (cross-domain); capability is
|
|
3135
|
+
// intra-strategy (semantic). Both cross_product_eligible: deferring another
|
|
3136
|
+
// product's feature or capability, authored in a different graph within the
|
|
3137
|
+
// portfolio, fits the 0.17.3 locked predicate.
|
|
3138
|
+
objective_defers_feature: { forward_verb: "defers", reverse_verb: "deferred_by", classification: "cross-domain", source_type: "objective", target_type: "feature", carries_properties: true, property_schema: DEFER_EDGE_PROPERTY_SCHEMA, cross_product_eligible: true, deliberate_only: true },
|
|
3139
|
+
objective_defers_capability: { forward_verb: "defers", reverse_verb: "deferred_by", classification: "semantic", source_type: "objective", target_type: "capability", carries_properties: true, property_schema: DEFER_EDGE_PROPERTY_SCHEMA, cross_product_eligible: true, deliberate_only: true }
|
|
3091
3140
|
};
|
|
3092
3141
|
var UPG_CROSS_ELIGIBLE_CATALOG_EDGE_TYPES = Object.keys(UPG_EDGE_CATALOG).filter(
|
|
3093
3142
|
(k) => UPG_EDGE_CATALOG[k].cross_product_eligible === true
|
|
@@ -3096,6 +3145,13 @@ function isCrossProductEligible(type) {
|
|
|
3096
3145
|
const def = UPG_EDGE_CATALOG[type];
|
|
3097
3146
|
return def?.cross_product_eligible === true;
|
|
3098
3147
|
}
|
|
3148
|
+
var UPG_DELIBERATE_ONLY_EDGE_TYPES = Object.keys(UPG_EDGE_CATALOG).filter(
|
|
3149
|
+
(k) => UPG_EDGE_CATALOG[k].deliberate_only === true
|
|
3150
|
+
);
|
|
3151
|
+
function isDeliberateOnlyEdge(type) {
|
|
3152
|
+
const def = UPG_EDGE_CATALOG[type];
|
|
3153
|
+
return def?.deliberate_only === true;
|
|
3154
|
+
}
|
|
3099
3155
|
var UPG_POLYMORPHIC_EDGE_KEYS = [
|
|
3100
3156
|
// Universal semantic verbs
|
|
3101
3157
|
"node_informs_node",
|
|
@@ -3463,7 +3519,9 @@ var UPG_VALID_CHILDREN = {
|
|
|
3463
3519
|
// where self-nesting genuinely lives, not on `experiment`).
|
|
3464
3520
|
experiment_run: ["learning", "evidence", "metric", "experiment_run"],
|
|
3465
3521
|
// ── OKR hierarchy ──────────────────────────────────────────────────────────
|
|
3466
|
-
|
|
3522
|
+
// strategic_question (0.17.4): an open coordination question raised under an
|
|
3523
|
+
// objective (objective_raises_strategic_question, hierarchy).
|
|
3524
|
+
objective: ["key_result", "metric", "strategic_question"],
|
|
3467
3525
|
key_result: ["metric"],
|
|
3468
3526
|
// ── Strategic cascade: vision → mission → strategic_pillar → strategic_theme →
|
|
3469
3527
|
// { initiative, objective } ───────────────────────────────────────────────
|
|
@@ -3488,7 +3546,7 @@ var UPG_VALID_CHILDREN = {
|
|
|
3488
3546
|
// catalog (hierarchy, strategic_theme → objective, reverse_verb: rolls_up_to;
|
|
3489
3547
|
// renamed from objective_rolls_up_to_strategic_theme in UPG-676).
|
|
3490
3548
|
strategic_theme: ["initiative", "objective"],
|
|
3491
|
-
initiative: ["assumption"],
|
|
3549
|
+
initiative: ["assumption", "strategic_question"],
|
|
3492
3550
|
// v0.5.2 (UPG-528): capability decomposes into sub-capabilities (Wardley
|
|
3493
3551
|
// value-chain spine) and is realised by user-facing features. Pairs with
|
|
3494
3552
|
// `capability_depends_on_capability` and `capability_implemented_by_feature`
|
|
@@ -4561,6 +4619,15 @@ var ASSUMPTION_LIFECYCLE = {
|
|
|
4561
4619
|
}
|
|
4562
4620
|
]
|
|
4563
4621
|
};
|
|
4622
|
+
var STRATEGIC_QUESTION_LIFECYCLE = {
|
|
4623
|
+
entity_type: "strategic_question",
|
|
4624
|
+
initial_phase: "open",
|
|
4625
|
+
terminal_phases: ["resolved"],
|
|
4626
|
+
phases: [
|
|
4627
|
+
{ id: "open", label: "Open", description: "The question has been raised but not yet answered. The plan is exposed to it.", transitions_to: ["resolved"] },
|
|
4628
|
+
{ id: "resolved", label: "Resolved", description: "The question has been answered; the resolution is captured. The plan is no longer exposed to it. May reopen if the answer unravels.", transitions_to: ["open"] }
|
|
4629
|
+
]
|
|
4630
|
+
};
|
|
4564
4631
|
var OUTCOME_LIFECYCLE = {
|
|
4565
4632
|
entity_type: "outcome",
|
|
4566
4633
|
initial_phase: "identified",
|
|
@@ -6238,6 +6305,7 @@ var UPG_LIFECYCLES = [
|
|
|
6238
6305
|
INITIATIVE_LIFECYCLE,
|
|
6239
6306
|
STRATEGIC_PILLAR_LIFECYCLE,
|
|
6240
6307
|
ASSUMPTION_LIFECYCLE,
|
|
6308
|
+
STRATEGIC_QUESTION_LIFECYCLE,
|
|
6241
6309
|
FEATURE_AREA_LIFECYCLE,
|
|
6242
6310
|
FEATURE_LIFECYCLE,
|
|
6243
6311
|
EPIC_LIFECYCLE,
|
|
@@ -12714,6 +12782,15 @@ var UPG_PROPERTY_SCHEMA = {
|
|
|
12714
12782
|
time_horizon: { type: "string", description: 'Standing / multi-year horizon, often open-ended (a pillar is durable). @example "3 years", "2026-2028", "ongoing"' },
|
|
12715
12783
|
success_indicator: { type: "string", description: "How the business knows this durable pillar is on track. Narrative, not a metric edge. A strategic_theme deliberately has no success_indicator: it is measured through its child objectives, not on its own." }
|
|
12716
12784
|
},
|
|
12785
|
+
// StrategicQuestionProperties: StrategicQuestion entity. An open coordination or
|
|
12786
|
+
// ownership question a plan is exposed to (strategy sibling of research_question /
|
|
12787
|
+
// design_question). `status` is the node lifecycle (open -> resolved).
|
|
12788
|
+
strategic_question: {
|
|
12789
|
+
question: { type: "string", description: "The question itself. Primary content." },
|
|
12790
|
+
context: { type: "string", description: "Context that surfaced the question: the reorg, the boundary, the unowned area." },
|
|
12791
|
+
resolution: { type: "string", description: "The answer, captured when the question moves to `resolved`." },
|
|
12792
|
+
priority: { type: "string", enum: ["urgent", "high", "medium", "low", "none"], description: "Importance to resolve relative to other open questions." }
|
|
12793
|
+
},
|
|
12717
12794
|
// StrategicThemeProperties: StrategicTheme entity. A time-bound thrust WITHIN a
|
|
12718
12795
|
// strategic_pillar (distinct cascade level, UPG-692 T3.3) — measured through its
|
|
12719
12796
|
// child objectives, so it carries no success_indicator of its own.
|
|
@@ -19742,6 +19819,7 @@ var ENTITY_EMOJI = {
|
|
|
19742
19819
|
stakeholder: "\u{1F9D1}\u200D\u{1F4BC}",
|
|
19743
19820
|
status_report: "\u{1F4C4}",
|
|
19744
19821
|
strategic_pillar: "\u{1F3DB}\uFE0F",
|
|
19822
|
+
strategic_question: "\u2754",
|
|
19745
19823
|
strategic_theme: "\u{1F9F5}",
|
|
19746
19824
|
subscription: "\u{1F502}",
|
|
19747
19825
|
success_milestone: "\u{1F389}",
|
|
@@ -20299,6 +20377,7 @@ var STANDARD_LABELS = {
|
|
|
20299
20377
|
value_stream: { alt_labels: ["value chain", "stream"] },
|
|
20300
20378
|
strategic_pillar: { alt_labels: ["pillar", "foundation"] },
|
|
20301
20379
|
assumption: { alt_labels: ["belief", "working assumption", "premise"] },
|
|
20380
|
+
strategic_question: { alt_labels: ["open question", "coordination question", "ownership question"] },
|
|
20302
20381
|
// User layer
|
|
20303
20382
|
job_step: { alt_labels: ["job stage", "job phase", "job map step"] },
|
|
20304
20383
|
switching_cost: { alt_labels: ["lock-in", "migration cost", "switching barrier"] },
|
|
@@ -22843,7 +22922,7 @@ var STRATEGY_GUIDE = {
|
|
|
22843
22922
|
// entries are later additions appended in chronological-introduction
|
|
22844
22923
|
// order. Placement reflects the order in which they would naturally be
|
|
22845
22924
|
// authored after the canonical strategy spine.
|
|
22846
|
-
creation_sequence: ["product", "vision", "mission", "outcome", "objective", "key_result", "metric", "metric_quality_assessment", "strategic_theme", "strategic_pillar", "initiative", "capability", "value_stream", "assumption", "decision", "constraint"],
|
|
22925
|
+
creation_sequence: ["product", "vision", "mission", "outcome", "objective", "key_result", "metric", "metric_quality_assessment", "strategic_theme", "strategic_pillar", "initiative", "capability", "value_stream", "assumption", "strategic_question", "decision", "constraint"],
|
|
22847
22926
|
patterns: [
|
|
22848
22927
|
{
|
|
22849
22928
|
name: "Strategic Cascade",
|
|
@@ -22861,13 +22940,16 @@ var STRATEGY_GUIDE = {
|
|
|
22861
22940
|
required_bridges: [
|
|
22862
22941
|
{ edge_type: "outcome_reveals_opportunity", target_domain: "discovery", when: "Outcomes should connect to the opportunities that deliver them" },
|
|
22863
22942
|
{ edge_type: "outcome_delivered_by_feature", target_domain: "product_spec", when: "Strategic outcomes should decompose into shipped features" },
|
|
22864
|
-
{ edge_type: "assumption_becomes_hypothesis", target_domain: "validation", when: "Risky assumptions should become testable hypotheses" }
|
|
22943
|
+
{ edge_type: "assumption_becomes_hypothesis", target_domain: "validation", when: "Risky assumptions should become testable hypotheses" },
|
|
22944
|
+
{ edge_type: "objective_depends_on_dependency", target_domain: "team_org", when: "An objective that hinges on cross-team work should name the dependency it is exposed to" },
|
|
22945
|
+
{ edge_type: "objective_defers_feature", target_domain: "product_spec", when: "Work an objective explicitly puts out of scope for now should point at the deferred feature with a deferred_to period, not silently vanish from the quarter" }
|
|
22865
22946
|
],
|
|
22866
22947
|
anti_patterns: [
|
|
22867
22948
|
{ description: "Outcomes without metrics. Measurement is the signal an outcome happened." },
|
|
22868
22949
|
{ description: "Objectives without key results: an objective without measurement is a wish" },
|
|
22869
22950
|
{ description: "Too many strategic themes: focus beats breadth, aim for 2-4 active themes" },
|
|
22870
|
-
{ description: "Constraints without an origin: a qualitative guardrail lives on a constraint, so set constraint_origin to say where it comes from. internal marks a self-imposed principle or operating tenet the team commits to; external marks a limit, requirement, or ceiling imposed from outside (a regulation, a budget cap, a platform bound)." }
|
|
22951
|
+
{ description: "Constraints without an origin: a qualitative guardrail lives on a constraint, so set constraint_origin to say where it comes from. internal marks a self-imposed principle or operating tenet the team commits to; external marks a limit, requirement, or ceiling imposed from outside (a regulation, a budget cap, a platform bound)." },
|
|
22952
|
+
{ description: "Overloading assumption for open questions: an assumption is a premise the plan is built on and resolves by being tested (assumption_becomes_hypothesis). An unresolved coordination or ownership question the plan is exposed to (who owns a capability across teams, where a boundary falls after a reorg) is a strategic_question, raised under the objective or initiative it hangs off. Do not force one into the other." }
|
|
22871
22953
|
]
|
|
22872
22954
|
};
|
|
22873
22955
|
var PRODUCT_SPEC_GUIDE = {
|
|
@@ -26920,6 +27002,10 @@ var UPG_REGIONS = [
|
|
|
26920
27002
|
type: "assumption",
|
|
26921
27003
|
role: "leaf"
|
|
26922
27004
|
},
|
|
27005
|
+
{
|
|
27006
|
+
type: "strategic_question",
|
|
27007
|
+
role: "leaf"
|
|
27008
|
+
},
|
|
26923
27009
|
{
|
|
26924
27010
|
type: "constraint",
|
|
26925
27011
|
role: "leaf"
|
|
@@ -26945,6 +27031,8 @@ var UPG_REGIONS = [
|
|
|
26945
27031
|
"strategic_pillar_decided_via_decision",
|
|
26946
27032
|
"strategic_theme_pursues_initiative",
|
|
26947
27033
|
"initiative_assumes_assumption",
|
|
27034
|
+
"objective_raises_strategic_question",
|
|
27035
|
+
"initiative_raises_strategic_question",
|
|
26948
27036
|
"initiative_drives_outcome",
|
|
26949
27037
|
"objective_achieved_through_key_result",
|
|
26950
27038
|
"objective_measured_by_metric",
|
|
@@ -29629,7 +29717,7 @@ function isCanonical(text) {
|
|
|
29629
29717
|
}
|
|
29630
29718
|
|
|
29631
29719
|
// src/index.ts
|
|
29632
|
-
var UPG_VERSION = "0.17.
|
|
29720
|
+
var UPG_VERSION = "0.17.4";
|
|
29633
29721
|
var UPG_FORMAT_VERSION = "0.4.0";
|
|
29634
29722
|
var MARKDOWN_FORMAT_VERSION = "0.1";
|
|
29635
29723
|
var UPG_TYPES = getTypes();
|
|
@@ -29702,6 +29790,7 @@ export {
|
|
|
29702
29790
|
COVERAGE_ANTI_PATTERNS,
|
|
29703
29791
|
DEFAULT_ENTITY_EMOJI,
|
|
29704
29792
|
DEFERRED_PROPOSED_BY_CONTRACT,
|
|
29793
|
+
DEFER_EDGE_PROPERTY_SCHEMA,
|
|
29705
29794
|
DISCOVERY_RESEARCH_VALIDATION_PLAYBOOK,
|
|
29706
29795
|
ENGINEERING_PLATFORM_PLAYBOOK,
|
|
29707
29796
|
ENTITY_EMOJI,
|
|
@@ -29733,6 +29822,7 @@ export {
|
|
|
29733
29822
|
UPG_CROSS_EDGE_TYPES,
|
|
29734
29823
|
UPG_CROSS_ELIGIBLE_CATALOG_EDGE_TYPES,
|
|
29735
29824
|
UPG_CROSS_ONLY_EDGE_TYPES,
|
|
29825
|
+
UPG_DELIBERATE_ONLY_EDGE_TYPES,
|
|
29736
29826
|
UPG_DEPRECATED_TYPES,
|
|
29737
29827
|
UPG_DOMAINS,
|
|
29738
29828
|
UPG_DOMAIN_ACTIVATION,
|
|
@@ -29864,6 +29954,7 @@ export {
|
|
|
29864
29954
|
isCanonicalProductStage,
|
|
29865
29955
|
isContainmentFreeType,
|
|
29866
29956
|
isCrossProductEligible,
|
|
29957
|
+
isDeliberateOnlyEdge,
|
|
29867
29958
|
isDeprecatedType,
|
|
29868
29959
|
isDomainGuideStep,
|
|
29869
29960
|
isEntitySequenceStep,
|