@unified-product-graph/core 0.14.1 → 0.15.0

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/dist/index.d.cts CHANGED
@@ -11838,15 +11838,12 @@ interface DesignConceptProperties {
11838
11838
  * @example
11839
11839
  * const properties: PrototypeProperties = {
11840
11840
  * fidelity: 'low',
11841
- * test_status: 'untested',
11842
11841
  * tool: 'entopo',
11843
11842
  * }
11844
11843
  */
11845
11844
  interface PrototypeProperties {
11846
11845
  /** Detail level */
11847
11846
  fidelity?: 'low' | 'medium' | 'high';
11848
- /** User-test status */
11849
- test_status?: 'untested' | 'testing' | 'passed' | 'failed';
11850
11847
  /** Authoring tool */
11851
11848
  tool?: string;
11852
11849
  }
@@ -12397,27 +12394,18 @@ interface OutcomeProperties {
12397
12394
  evidence_summary?: string;
12398
12395
  /** Confidence this is the right outcome to pursue */
12399
12396
  confidence?: UPGAssessment;
12400
- /**
12401
- * Current lifecycle phase, mirroring the `outcome` lifecycle in
12402
- * `grammar/lifecycles.ts` (UPG-579 Option B): `identified` -> `measuring` ->
12403
- * `achieved` | `abandoned`.
12404
- */
12405
- outcome_status?: 'identified' | 'measuring' | 'achieved' | 'abandoned';
12406
12397
  }
12407
12398
  /** A high-level strategic goal. The O in OKR.
12408
12399
  *
12409
12400
  * @example
12410
12401
  * const properties: ObjectiveProperties = {
12411
12402
  * timeframe: '12-18 months',
12412
- * objective_status: 'active',
12413
12403
  * progress: 42,
12414
12404
  * }
12415
12405
  */
12416
12406
  interface ObjectiveProperties {
12417
12407
  /** Planning timeframe (e.g. "Q1 2026", "H1 2026") */
12418
12408
  timeframe?: string;
12419
- /** Current status */
12420
- objective_status?: 'active' | 'achieved' | 'deferred';
12421
12409
  /** Overall progress (0–100) */
12422
12410
  progress?: number;
12423
12411
  }
@@ -12443,7 +12431,8 @@ interface KeyResultProperties {
12443
12431
  * A semantic container (e.g. "Canvas & Visualisation", "AI & Intelligence",
12444
12432
  * "Onboarding") that gathers features under a shared product surface, owning
12445
12433
  * team, or capability. Lifecycle (planned → active → deprecated) is governed
12446
- * by `area_status`.
12434
+ * by the base-node `status` field (the former `area_status` property was
12435
+ * collapsed into it in 0.15.0, UPG-689 Pattern D).
12447
12436
  *
12448
12437
  * Per UPG principle P14, structural relationships are edges:
12449
12438
  * parent product: `product_organised_by_feature_area`
@@ -12460,7 +12449,6 @@ interface KeyResultProperties {
12460
12449
  * priority: 'high',
12461
12450
  * maturity: 'mature',
12462
12451
  * owner: 'sam.patel@arkheiev.com',
12463
- * area_status: 'active',
12464
12452
  * }
12465
12453
  */
12466
12454
  interface FeatureAreaProperties {
@@ -12480,8 +12468,6 @@ interface FeatureAreaProperties {
12480
12468
  * `legacy` = being phased out for a successor.
12481
12469
  */
12482
12470
  maturity?: 'nascent' | 'growing' | 'mature' | 'legacy';
12483
- /** Status in the product structure */
12484
- area_status?: 'active' | 'planned' | 'deprecated';
12485
12471
  }
12486
12472
  /** A discrete, user-facing capability of the product.
12487
12473
  *
@@ -12672,7 +12658,6 @@ interface RoadmapProperties {
12672
12658
  * const properties: RoadmapItemProperties = {
12673
12659
  * quarter: '2026-Q2',
12674
12660
  * priority: 'high',
12675
- * item_status: 'planned',
12676
12661
  * }
12677
12662
  */
12678
12663
  interface RoadmapItemProperties {
@@ -12680,8 +12665,6 @@ interface RoadmapItemProperties {
12680
12665
  quarter?: string;
12681
12666
  /** Importance against other items */
12682
12667
  priority?: Priority;
12683
- /** Status. `deferred` = explicitly pushed to a later period. */
12684
- item_status?: 'planned' | 'in_progress' | 'shipped' | 'deferred';
12685
12668
  /** Delivery confidence within the planned period (UPGAssessment on `confidence_5`). */
12686
12669
  confidence?: UPGAssessment;
12687
12670
  /** ISO date work begins. More precise than `quarter` for continuous planning. */
@@ -13024,20 +13007,13 @@ interface TechnicalDebtItemProperties {
13024
13007
  * @example
13025
13008
  * const properties: FeatureFlagProperties = {
13026
13009
  * key: 'cta.primary.signup',
13027
- * flag_status: 'on',
13028
13010
  * rollout_pct: 42,
13029
13011
  * }
13030
13012
  */
13031
13013
  interface FeatureFlagProperties {
13032
13014
  /** Required. Stable flag key used in code (e.g. "new-checkout-flow"). */
13033
13015
  key: string;
13034
- /**
13035
- * Activation state.
13036
- * `on` = enabled for all. `off` = disabled for all.
13037
- * `rollout` = partial via targeting_rules.
13038
- */
13039
- flag_status?: 'on' | 'off' | 'rollout';
13040
- /** Percentage enabled (0–100). Meaningful when `flag_status === 'rollout'`. */
13016
+ /** Percentage enabled (0–100). Meaningful when the flag's `status === 'rollout'`. */
13041
13017
  rollout_pct?: number;
13042
13018
  /** Human-readable targeting rules. Full rule evaluation happens in the flag service. */
13043
13019
  targeting_rules?: string;
@@ -13064,7 +13040,6 @@ interface FeatureFlagProperties {
13064
13040
  * const properties: DeploymentProperties = {
13065
13041
  * environment: 'prod',
13066
13042
  * timestamp: '2026-04-17T09:00:00Z',
13067
- * deploy_status: 'success',
13068
13043
  * }
13069
13044
  */
13070
13045
  interface DeploymentProperties {
@@ -13072,8 +13047,6 @@ interface DeploymentProperties {
13072
13047
  environment?: 'dev' | 'staging' | 'prod';
13073
13048
  /** ISO timestamp */
13074
13049
  timestamp?: string;
13075
- /** Current status */
13076
- deploy_status?: 'success' | 'failure' | 'rolling';
13077
13050
  /** Git SHA of the deployed commit */
13078
13051
  sha?: string;
13079
13052
  /** Wall-clock duration in seconds. Tracks deployment speed trends. */
@@ -13176,7 +13149,6 @@ interface ApiEndpointProperties {
13176
13149
  * const properties: DatabaseSchemaProperties = {
13177
13150
  * db_type: 'postgres',
13178
13151
  * schema_version: '1.3.0',
13179
- * migration_status: 'current',
13180
13152
  * }
13181
13153
  */
13182
13154
  interface DatabaseSchemaProperties {
@@ -13184,8 +13156,6 @@ interface DatabaseSchemaProperties {
13184
13156
  db_type?: 'postgres' | 'mysql' | 'mongodb' | 'redis' | 'other';
13185
13157
  /** Current schema version */
13186
13158
  schema_version?: string;
13187
- /** Pending-migration status */
13188
- migration_status?: 'current' | 'pending' | 'failed';
13189
13159
  /** Owning person or team responsible for design and migrations. Promote to a `node_owned_by_team` edge if ownership must be queryable. */
13190
13160
  owner?: string;
13191
13161
  /** Tables or collections in this schema. Useful for migration scope estimation. */
@@ -13311,8 +13281,6 @@ interface ExternalApiProperties {
13311
13281
  auth_type?: 'api_key' | 'oauth2' | 'jwt' | 'basic' | 'none';
13312
13282
  /** Rate limit description */
13313
13283
  rate_limits?: string;
13314
- /** Availability */
13315
- api_status?: 'active' | 'deprecated' | 'beta' | 'unavailable';
13316
13284
  }
13317
13285
  /** Data flow between services.
13318
13286
  *
@@ -14926,14 +14894,11 @@ interface DataProductProperties {
14926
14894
  *
14927
14895
  * @example
14928
14896
  * const properties: DataPipelineProperties = {
14929
- * pipeline_status: 'active',
14930
14897
  * schedule: '0 2 * * *',
14931
14898
  * avg_runtime: '3m 20s',
14932
14899
  * }
14933
14900
  */
14934
14901
  interface DataPipelineProperties {
14935
- /** Operational status of the pipeline */
14936
- pipeline_status?: 'active' | 'paused' | 'failed' | 'deprecated';
14937
14902
  /** Cron or scheduling expression */
14938
14903
  schedule?: string;
14939
14904
  /** Average wall-clock runtime per execution */
@@ -15411,15 +15376,12 @@ interface ComplianceFrameworkProperties {
15411
15376
  * @example
15412
15377
  * const properties: SecurityAuditProperties = {
15413
15378
  * audit_scope: 'All customer-facing APIs and the billing service.',
15414
- * audit_status: 'scheduled',
15415
15379
  * findings_count: 42,
15416
15380
  * }
15417
15381
  */
15418
15382
  interface SecurityAuditProperties {
15419
15383
  /** Systems or processes covered by the audit */
15420
15384
  audit_scope?: string;
15421
- /** Current progress of the audit */
15422
- audit_status?: 'scheduled' | 'in_progress' | 'completed';
15423
15385
  /** Total number of findings */
15424
15386
  findings_count?: number;
15425
15387
  /** Number of critical-severity findings */
@@ -16218,8 +16180,6 @@ interface AgentDefinitionProperties {
16218
16180
  allow_code_execution?: boolean;
16219
16181
  /** Whether the agent can process images and other media */
16220
16182
  multimodal?: boolean;
16221
- /** Operational status of this agent definition */
16222
- agent_status?: 'active' | 'disabled' | 'testing';
16223
16183
  /** Version label for this agent definition (e.g. "1.4.2") */
16224
16184
  version?: string;
16225
16185
  }
@@ -16279,7 +16239,6 @@ interface AgentTaskProperties {
16279
16239
  * const properties: ReviewGateProperties = {
16280
16240
  * gate_type: 'human_review',
16281
16241
  * required_approvers: ['eng-lead', 'security-reviewer'],
16282
- * gate_status: 'pending',
16283
16242
  * }
16284
16243
  */
16285
16244
  interface ReviewGateProperties {
@@ -16287,8 +16246,6 @@ interface ReviewGateProperties {
16287
16246
  gate_type?: 'human_review' | 'automated_check' | 'approval';
16288
16247
  /** People or roles that must approve. Promote to `node_owned_by_person` edges (one per name) if ownership must be queryable. */
16289
16248
  required_approvers?: string[];
16290
- /** Current approval status of the gate */
16291
- gate_status?: 'pending' | 'approved' | 'rejected' | 'bypassed';
16292
16249
  }
16293
16250
  /** Approval record.
16294
16251
  *
@@ -17433,8 +17390,6 @@ interface MarketingChannelProperties {
17433
17390
  monthly_budget?: number;
17434
17391
  /** Return on investment ratio */
17435
17392
  roi?: number;
17436
- /** Operational status of the channel */
17437
- channel_status?: 'active' | 'paused' | 'deprecated';
17438
17393
  }
17439
17394
  /** Marketing campaign plan.
17440
17395
  *
@@ -21884,7 +21839,7 @@ declare function isCanonical(text: string): boolean;
21884
21839
  * it stamps the `upg_version` field of every `.upg` file written by the SDK.
21885
21840
  * The `check:version-lockstep` gate enforces this at release time.
21886
21841
  */
21887
- declare const UPG_VERSION: "0.14.1";
21842
+ declare const UPG_VERSION: "0.15.0";
21888
21843
  /**
21889
21844
  * The `.upg` JSON document format version. Written to the `upg_version` field.
21890
21845
  * Evolves independently from `UPG_VERSION` (the catalogue version).
package/dist/index.d.ts CHANGED
@@ -11838,15 +11838,12 @@ interface DesignConceptProperties {
11838
11838
  * @example
11839
11839
  * const properties: PrototypeProperties = {
11840
11840
  * fidelity: 'low',
11841
- * test_status: 'untested',
11842
11841
  * tool: 'entopo',
11843
11842
  * }
11844
11843
  */
11845
11844
  interface PrototypeProperties {
11846
11845
  /** Detail level */
11847
11846
  fidelity?: 'low' | 'medium' | 'high';
11848
- /** User-test status */
11849
- test_status?: 'untested' | 'testing' | 'passed' | 'failed';
11850
11847
  /** Authoring tool */
11851
11848
  tool?: string;
11852
11849
  }
@@ -12397,27 +12394,18 @@ interface OutcomeProperties {
12397
12394
  evidence_summary?: string;
12398
12395
  /** Confidence this is the right outcome to pursue */
12399
12396
  confidence?: UPGAssessment;
12400
- /**
12401
- * Current lifecycle phase, mirroring the `outcome` lifecycle in
12402
- * `grammar/lifecycles.ts` (UPG-579 Option B): `identified` -> `measuring` ->
12403
- * `achieved` | `abandoned`.
12404
- */
12405
- outcome_status?: 'identified' | 'measuring' | 'achieved' | 'abandoned';
12406
12397
  }
12407
12398
  /** A high-level strategic goal. The O in OKR.
12408
12399
  *
12409
12400
  * @example
12410
12401
  * const properties: ObjectiveProperties = {
12411
12402
  * timeframe: '12-18 months',
12412
- * objective_status: 'active',
12413
12403
  * progress: 42,
12414
12404
  * }
12415
12405
  */
12416
12406
  interface ObjectiveProperties {
12417
12407
  /** Planning timeframe (e.g. "Q1 2026", "H1 2026") */
12418
12408
  timeframe?: string;
12419
- /** Current status */
12420
- objective_status?: 'active' | 'achieved' | 'deferred';
12421
12409
  /** Overall progress (0–100) */
12422
12410
  progress?: number;
12423
12411
  }
@@ -12443,7 +12431,8 @@ interface KeyResultProperties {
12443
12431
  * A semantic container (e.g. "Canvas & Visualisation", "AI & Intelligence",
12444
12432
  * "Onboarding") that gathers features under a shared product surface, owning
12445
12433
  * team, or capability. Lifecycle (planned → active → deprecated) is governed
12446
- * by `area_status`.
12434
+ * by the base-node `status` field (the former `area_status` property was
12435
+ * collapsed into it in 0.15.0, UPG-689 Pattern D).
12447
12436
  *
12448
12437
  * Per UPG principle P14, structural relationships are edges:
12449
12438
  * parent product: `product_organised_by_feature_area`
@@ -12460,7 +12449,6 @@ interface KeyResultProperties {
12460
12449
  * priority: 'high',
12461
12450
  * maturity: 'mature',
12462
12451
  * owner: 'sam.patel@arkheiev.com',
12463
- * area_status: 'active',
12464
12452
  * }
12465
12453
  */
12466
12454
  interface FeatureAreaProperties {
@@ -12480,8 +12468,6 @@ interface FeatureAreaProperties {
12480
12468
  * `legacy` = being phased out for a successor.
12481
12469
  */
12482
12470
  maturity?: 'nascent' | 'growing' | 'mature' | 'legacy';
12483
- /** Status in the product structure */
12484
- area_status?: 'active' | 'planned' | 'deprecated';
12485
12471
  }
12486
12472
  /** A discrete, user-facing capability of the product.
12487
12473
  *
@@ -12672,7 +12658,6 @@ interface RoadmapProperties {
12672
12658
  * const properties: RoadmapItemProperties = {
12673
12659
  * quarter: '2026-Q2',
12674
12660
  * priority: 'high',
12675
- * item_status: 'planned',
12676
12661
  * }
12677
12662
  */
12678
12663
  interface RoadmapItemProperties {
@@ -12680,8 +12665,6 @@ interface RoadmapItemProperties {
12680
12665
  quarter?: string;
12681
12666
  /** Importance against other items */
12682
12667
  priority?: Priority;
12683
- /** Status. `deferred` = explicitly pushed to a later period. */
12684
- item_status?: 'planned' | 'in_progress' | 'shipped' | 'deferred';
12685
12668
  /** Delivery confidence within the planned period (UPGAssessment on `confidence_5`). */
12686
12669
  confidence?: UPGAssessment;
12687
12670
  /** ISO date work begins. More precise than `quarter` for continuous planning. */
@@ -13024,20 +13007,13 @@ interface TechnicalDebtItemProperties {
13024
13007
  * @example
13025
13008
  * const properties: FeatureFlagProperties = {
13026
13009
  * key: 'cta.primary.signup',
13027
- * flag_status: 'on',
13028
13010
  * rollout_pct: 42,
13029
13011
  * }
13030
13012
  */
13031
13013
  interface FeatureFlagProperties {
13032
13014
  /** Required. Stable flag key used in code (e.g. "new-checkout-flow"). */
13033
13015
  key: string;
13034
- /**
13035
- * Activation state.
13036
- * `on` = enabled for all. `off` = disabled for all.
13037
- * `rollout` = partial via targeting_rules.
13038
- */
13039
- flag_status?: 'on' | 'off' | 'rollout';
13040
- /** Percentage enabled (0–100). Meaningful when `flag_status === 'rollout'`. */
13016
+ /** Percentage enabled (0–100). Meaningful when the flag's `status === 'rollout'`. */
13041
13017
  rollout_pct?: number;
13042
13018
  /** Human-readable targeting rules. Full rule evaluation happens in the flag service. */
13043
13019
  targeting_rules?: string;
@@ -13064,7 +13040,6 @@ interface FeatureFlagProperties {
13064
13040
  * const properties: DeploymentProperties = {
13065
13041
  * environment: 'prod',
13066
13042
  * timestamp: '2026-04-17T09:00:00Z',
13067
- * deploy_status: 'success',
13068
13043
  * }
13069
13044
  */
13070
13045
  interface DeploymentProperties {
@@ -13072,8 +13047,6 @@ interface DeploymentProperties {
13072
13047
  environment?: 'dev' | 'staging' | 'prod';
13073
13048
  /** ISO timestamp */
13074
13049
  timestamp?: string;
13075
- /** Current status */
13076
- deploy_status?: 'success' | 'failure' | 'rolling';
13077
13050
  /** Git SHA of the deployed commit */
13078
13051
  sha?: string;
13079
13052
  /** Wall-clock duration in seconds. Tracks deployment speed trends. */
@@ -13176,7 +13149,6 @@ interface ApiEndpointProperties {
13176
13149
  * const properties: DatabaseSchemaProperties = {
13177
13150
  * db_type: 'postgres',
13178
13151
  * schema_version: '1.3.0',
13179
- * migration_status: 'current',
13180
13152
  * }
13181
13153
  */
13182
13154
  interface DatabaseSchemaProperties {
@@ -13184,8 +13156,6 @@ interface DatabaseSchemaProperties {
13184
13156
  db_type?: 'postgres' | 'mysql' | 'mongodb' | 'redis' | 'other';
13185
13157
  /** Current schema version */
13186
13158
  schema_version?: string;
13187
- /** Pending-migration status */
13188
- migration_status?: 'current' | 'pending' | 'failed';
13189
13159
  /** Owning person or team responsible for design and migrations. Promote to a `node_owned_by_team` edge if ownership must be queryable. */
13190
13160
  owner?: string;
13191
13161
  /** Tables or collections in this schema. Useful for migration scope estimation. */
@@ -13311,8 +13281,6 @@ interface ExternalApiProperties {
13311
13281
  auth_type?: 'api_key' | 'oauth2' | 'jwt' | 'basic' | 'none';
13312
13282
  /** Rate limit description */
13313
13283
  rate_limits?: string;
13314
- /** Availability */
13315
- api_status?: 'active' | 'deprecated' | 'beta' | 'unavailable';
13316
13284
  }
13317
13285
  /** Data flow between services.
13318
13286
  *
@@ -14926,14 +14894,11 @@ interface DataProductProperties {
14926
14894
  *
14927
14895
  * @example
14928
14896
  * const properties: DataPipelineProperties = {
14929
- * pipeline_status: 'active',
14930
14897
  * schedule: '0 2 * * *',
14931
14898
  * avg_runtime: '3m 20s',
14932
14899
  * }
14933
14900
  */
14934
14901
  interface DataPipelineProperties {
14935
- /** Operational status of the pipeline */
14936
- pipeline_status?: 'active' | 'paused' | 'failed' | 'deprecated';
14937
14902
  /** Cron or scheduling expression */
14938
14903
  schedule?: string;
14939
14904
  /** Average wall-clock runtime per execution */
@@ -15411,15 +15376,12 @@ interface ComplianceFrameworkProperties {
15411
15376
  * @example
15412
15377
  * const properties: SecurityAuditProperties = {
15413
15378
  * audit_scope: 'All customer-facing APIs and the billing service.',
15414
- * audit_status: 'scheduled',
15415
15379
  * findings_count: 42,
15416
15380
  * }
15417
15381
  */
15418
15382
  interface SecurityAuditProperties {
15419
15383
  /** Systems or processes covered by the audit */
15420
15384
  audit_scope?: string;
15421
- /** Current progress of the audit */
15422
- audit_status?: 'scheduled' | 'in_progress' | 'completed';
15423
15385
  /** Total number of findings */
15424
15386
  findings_count?: number;
15425
15387
  /** Number of critical-severity findings */
@@ -16218,8 +16180,6 @@ interface AgentDefinitionProperties {
16218
16180
  allow_code_execution?: boolean;
16219
16181
  /** Whether the agent can process images and other media */
16220
16182
  multimodal?: boolean;
16221
- /** Operational status of this agent definition */
16222
- agent_status?: 'active' | 'disabled' | 'testing';
16223
16183
  /** Version label for this agent definition (e.g. "1.4.2") */
16224
16184
  version?: string;
16225
16185
  }
@@ -16279,7 +16239,6 @@ interface AgentTaskProperties {
16279
16239
  * const properties: ReviewGateProperties = {
16280
16240
  * gate_type: 'human_review',
16281
16241
  * required_approvers: ['eng-lead', 'security-reviewer'],
16282
- * gate_status: 'pending',
16283
16242
  * }
16284
16243
  */
16285
16244
  interface ReviewGateProperties {
@@ -16287,8 +16246,6 @@ interface ReviewGateProperties {
16287
16246
  gate_type?: 'human_review' | 'automated_check' | 'approval';
16288
16247
  /** People or roles that must approve. Promote to `node_owned_by_person` edges (one per name) if ownership must be queryable. */
16289
16248
  required_approvers?: string[];
16290
- /** Current approval status of the gate */
16291
- gate_status?: 'pending' | 'approved' | 'rejected' | 'bypassed';
16292
16249
  }
16293
16250
  /** Approval record.
16294
16251
  *
@@ -17433,8 +17390,6 @@ interface MarketingChannelProperties {
17433
17390
  monthly_budget?: number;
17434
17391
  /** Return on investment ratio */
17435
17392
  roi?: number;
17436
- /** Operational status of the channel */
17437
- channel_status?: 'active' | 'paused' | 'deprecated';
17438
17393
  }
17439
17394
  /** Marketing campaign plan.
17440
17395
  *
@@ -21884,7 +21839,7 @@ declare function isCanonical(text: string): boolean;
21884
21839
  * it stamps the `upg_version` field of every `.upg` file written by the SDK.
21885
21840
  * The `check:version-lockstep` gate enforces this at release time.
21886
21841
  */
21887
- declare const UPG_VERSION: "0.14.1";
21842
+ declare const UPG_VERSION: "0.15.0";
21888
21843
  /**
21889
21844
  * The `.upg` JSON document format version. Written to the `upg_version` field.
21890
21845
  * Evolves independently from `UPG_VERSION` (the catalogue version).