@unified-product-graph/core 0.14.0 → 0.15.0

package/dist/index.cjs

@@ -1,7 +1,9 @@
 "use strict";
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
 var __export = (target, all) => {
   for (var name in all)
@@ -15,6 +17,14 @@ var __copyProps = (to, from, except, desc) => {
   }
   return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
 // src/index.ts
@@ -7605,6 +7615,118 @@ function getDeprecatedTypes() {
   return deprecated;
 }
 var UPG_PROPERTY_MIGRATIONS = {
+  // ── v0.15.0: Pattern D — collapse *_status shadows into the lifecycle ─────────
+  //
+  // 14 `*_status` enum properties whose values ARE the entity's own lifecycle
+  // phase set (UPG-689 Pattern D, the T1.1 guardrail set). They re-encoded the
+  // lifecycle as a property, shadowing the base-node `status` field that the
+  // lifecycle already drives. Each property is removed and any authored value
+  // LIFTS to `UPGBaseNode.status` (same convention as 0.9.14 kr_status). Two
+  // diverge in vocabulary from their own lifecycle and remap on lift:
+  //   - marketing_channel.channel_status: deprecated -> sunset
+  //   - security_audit.audit_status: scheduled -> planning, in_progress -> active
+  "0.15.0": [
+    {
+      kind: "lift_property_to_top_level",
+      type: "agent_definition",
+      from_property: "agent_status",
+      to: "status",
+      reason: "UPG-689 Pattern D: agent_status duplicated the agent_definition lifecycle (testing/active/disabled). Removed in 0.15.0; the authored value lifts to UPGBaseNode.status."
+    },
+    {
+      kind: "lift_property_to_top_level",
+      type: "data_pipeline",
+      from_property: "pipeline_status",
+      to: "status",
+      reason: "UPG-689 Pattern D: pipeline_status duplicated the data_pipeline lifecycle (active/paused/failed/deprecated). Removed in 0.15.0; lifts to status."
+    },
+    {
+      kind: "lift_property_to_top_level",
+      type: "database_schema",
+      from_property: "migration_status",
+      to: "status",
+      reason: "UPG-689 Pattern D: migration_status duplicated the database_schema lifecycle (current/pending/failed). Removed in 0.15.0; lifts to status."
+    },
+    {
+      kind: "lift_property_to_top_level",
+      type: "deployment",
+      from_property: "deploy_status",
+      to: "status",
+      reason: "UPG-689 Pattern D: deploy_status duplicated the deployment lifecycle (rolling/success/failure). Removed in 0.15.0; lifts to status."
+    },
+    {
+      kind: "lift_property_to_top_level",
+      type: "external_api",
+      from_property: "api_status",
+      to: "status",
+      reason: "UPG-689 Pattern D: api_status duplicated the external_api lifecycle (beta/active/deprecated/unavailable). Removed in 0.15.0; lifts to status."
+    },
+    {
+      kind: "lift_property_to_top_level",
+      type: "feature_area",
+      from_property: "area_status",
+      to: "status",
+      reason: "UPG-689 Pattern D: area_status duplicated the feature_area lifecycle (planned/active/deprecated). Removed in 0.15.0; lifts to status."
+    },
+    {
+      kind: "lift_property_to_top_level",
+      type: "feature_flag",
+      from_property: "flag_status",
+      to: "status",
+      reason: "UPG-689 Pattern D: flag_status duplicated the feature_flag lifecycle (off/rollout/on). Removed in 0.15.0; lifts to status."
+    },
+    {
+      kind: "lift_property_to_top_level",
+      type: "objective",
+      from_property: "objective_status",
+      to: "status",
+      reason: "UPG-689 Pattern D: objective_status duplicated the objective lifecycle (active/achieved/deferred). Removed in 0.15.0; lifts to status."
+    },
+    {
+      kind: "lift_property_to_top_level",
+      type: "outcome",
+      from_property: "outcome_status",
+      to: "status",
+      reason: "UPG-689 Pattern D: outcome_status duplicated the outcome lifecycle (identified/measuring/achieved/abandoned). Removed in 0.15.0; lifts to status."
+    },
+    {
+      kind: "lift_property_to_top_level",
+      type: "prototype",
+      from_property: "test_status",
+      to: "status",
+      reason: "UPG-689 Pattern D: test_status duplicated the prototype lifecycle (untested/testing/passed/failed). Removed in 0.15.0; lifts to status."
+    },
+    {
+      kind: "lift_property_to_top_level",
+      type: "review_gate",
+      from_property: "gate_status",
+      to: "status",
+      reason: "UPG-689 Pattern D: gate_status duplicated the review_gate lifecycle (pending/approved/rejected/bypassed). Removed in 0.15.0; lifts to status."
+    },
+    {
+      kind: "lift_property_to_top_level",
+      type: "roadmap_item",
+      from_property: "item_status",
+      to: "status",
+      reason: "UPG-689 Pattern D: item_status duplicated the roadmap_item lifecycle (planned/in_progress/shipped/deferred). Removed in 0.15.0; lifts to status."
+    },
+    {
+      kind: "lift_property_to_top_level",
+      type: "marketing_channel",
+      from_property: "channel_status",
+      to: "status",
+      value_map: { deprecated: "sunset" },
+      reason: "UPG-689 Pattern D: channel_status (active/paused/deprecated) re-encoded the marketing_channel lifecycle (planning/active/paused/completed/sunset). Removed in 0.15.0; lifts to status with deprecated -> sunset."
+    },
+    {
+      kind: "lift_property_to_top_level",
+      type: "security_audit",
+      from_property: "audit_status",
+      to: "status",
+      value_map: { scheduled: "planning", in_progress: "active" },
+      reason: "UPG-689 Pattern D: audit_status (scheduled/in_progress/completed) re-encoded the security_audit lifecycle (planning/active/paused/completed/sunset). Removed in 0.15.0; lifts to status with scheduled -> planning, in_progress -> active."
+    }
+  ],
   // ── v0.14.0: Pattern E — remove deprecated/ghost properties (UPG-574) ────────
   //
   // Properties marked deprecated (some "Removed in 0.9.1") that were never
@@ -10130,7 +10252,6 @@ var UPG_PROPERTY_SCHEMA = {
     max_execution_time_seconds: { type: "number", description: "Hard timeout for agent execution in seconds" },
     allow_code_execution: { type: "boolean", description: "Whether the agent can execute generated code" },
     multimodal: { type: "boolean", description: "Whether the agent can process images and other media" },
-    agent_status: { type: "string", enum: ["active", "disabled", "testing"], description: "Operational status of this agent definition" },
     version: { type: "string", description: 'Version label for this agent definition (e.g. "1.4.2")' }
   },
   // AgentHookProperties: Agent hook.
@@ -10831,7 +10952,6 @@ var UPG_PROPERTY_SCHEMA = {
   },
   // DataPipelineProperties: DataPipeline entity.
   data_pipeline: {
-    pipeline_status: { type: "string", enum: ["active", "paused", "failed", "deprecated"], description: "Operational status of the pipeline" },
     schedule: { type: "string", description: "Cron or scheduling expression" },
     avg_runtime: { type: "string", description: "Average wall-clock runtime per execution" },
     orchestrator: { type: "string", description: 'Orchestration tool (e.g. "Airflow", "Dagster", "dbt Cloud")' },
@@ -10866,7 +10986,6 @@ var UPG_PROPERTY_SCHEMA = {
   database_schema: {
     db_type: { type: "string", enum: ["postgres", "mysql", "mongodb", "redis", "other"], description: "Engine" },
     schema_version: { type: "string", description: "Current schema version" },
-    migration_status: { type: "string", enum: ["current", "pending", "failed"], description: "Pending-migration status" },
     owner: { type: "string", description: "Owning person or team responsible for design and migrations. Promote to a `node_owned_by_team` edge if ownership must be queryable." },
     table_count: { type: "number", description: "Tables or collections in this schema. Useful for migration scope estimation.", modifier: "derived" }
   },
@@ -10921,7 +11040,6 @@ var UPG_PROPERTY_SCHEMA = {
   deployment: {
     environment: { type: "string", enum: ["dev", "staging", "prod"], description: "Target environment" },
     timestamp: { type: "string", description: "ISO timestamp" },
-    deploy_status: { type: "string", enum: ["success", "failure", "rolling"], description: "Current status" },
     sha: { type: "string", description: "Git SHA of the deployed commit" },
     duration_seconds: { type: "number", description: "Wall-clock duration in seconds. Tracks deployment speed trends." },
     deployer: { type: "string", description: "Triggering person or system. Promote to a `node_owned_by_person` edge if ownership must be queryable." }
@@ -11249,8 +11367,7 @@ var UPG_PROPERTY_SCHEMA = {
     provider: { type: "string", description: "Provider" },
     base_url: { type: "string", description: "Base URL" },
     auth_type: { type: "string", enum: ["api_key", "oauth2", "jwt", "basic", "none"], description: "Authentication method" },
-    rate_limits: { type: "string", description: "Rate limit description" },
-    api_status: { type: "string", enum: ["active", "deprecated", "beta", "unavailable"], description: "Availability" }
+    rate_limits: { type: "string", description: "Rate limit description" }
   },
   // FeasibilityStudyProperties: FeasibilityStudy entity.
   feasibility_study: {
@@ -11284,13 +11401,11 @@ var UPG_PROPERTY_SCHEMA = {
     feature_count: { type: "number", description: "Approximate feature count under this area. Snapshot; `feature_area_contains_feature` edges are the source of truth.", modifier: "derived" },
     owner: { type: "string", description: "Area owner (handle or email). Promote to a `node_owned_by_team` edge if ownership must be queryable." },
     priority: { type: "string", enum: ["urgent", "high", "medium", "low", "none"], description: "Importance to the product overall" },
-    maturity: { type: "string", enum: ["nascent", "growing", "mature", "legacy"], description: "Maturity. `nascent` = newly-formed grouping. `mature` = established surface. `legacy` = being phased out for a successor." },
-    area_status: { type: "string", enum: ["active", "planned", "deprecated"], description: "Status in the product structure" }
+    maturity: { type: "string", enum: ["nascent", "growing", "mature", "legacy"], description: "Maturity. `nascent` = newly-formed grouping. `mature` = established surface. `legacy` = being phased out for a successor." }
   },
   // FeatureFlagProperties: Feature flag.
   feature_flag: {
     key: { type: "string", description: 'Required. Stable flag key used in code (e.g. "new-checkout-flow").' },
-    flag_status: { type: "string", enum: ["on", "off", "rollout"], description: "Activation state. `on` = enabled for all. `off` = disabled for all. `rollout` = partial via targeting_rules." },
     rollout_pct: { type: "number", description: "Percentage enabled (0\u2013100). Meaningful when `flag_status === 'rollout'`.", modifier: "snapshot" },
     targeting_rules: { type: "string", description: "Human-readable targeting rules. Full rule evaluation happens in the flag service." },
     owner: { type: "string", description: "Owning person or team responsible for the flag's lifecycle. Promote to a `node_owned_by_person` edge if ownership must be queryable." },
@@ -11897,8 +12012,7 @@ var UPG_PROPERTY_SCHEMA = {
   marketing_channel: {
     channel_type: { type: "string", enum: ["social", "email", "seo", "sem", "content", "events", "other"], description: "Category of marketing channel" },
     monthly_budget: { type: "number", description: "Monthly spend allocated to this channel", modifier: "snapshot" },
-    roi: { type: "number", description: "Return on investment ratio" },
-    channel_status: { type: "string", enum: ["active", "paused", "deprecated"], description: "Operational status of the channel" }
+    roi: { type: "number", description: "Return on investment ratio" }
   },
   // MarketingStrategyProperties: Marketing strategy.
   marketing_strategy: {
@@ -12056,7 +12170,6 @@ var UPG_PROPERTY_SCHEMA = {
   // ObjectiveProperties: A high-level strategic goal. The O in OKR.
   objective: {
     timeframe: { type: "string", description: 'Planning timeframe (e.g. "Q1 2026", "H1 2026")' },
-    objective_status: { type: "string", enum: ["active", "achieved", "deferred"], description: "Current status" },
     progress: { type: "number", description: "Overall progress (0\u2013100)" }
   },
   // ObservationProperties: Discrete observation captured during research. Absorbed from the deprecated Highlight entity.
@@ -12105,8 +12218,7 @@ var UPG_PROPERTY_SCHEMA = {
         normalized: { type: "number", description: "Normalized 0-1 value for cross-tool comparison (optional)." }
       },
       required: ["value", "label"]
-    },
-    outcome_status: { type: "string", enum: ["identified", "measuring", "achieved", "abandoned"], description: "Current lifecycle phase, mirroring the `outcome` lifecycle in `grammar/lifecycles.ts` (UPG-579 Option B): `identified` -> `measuring` -> `achieved` | `abandoned`." }
+    }
   },
   // ParticipantProperties: Research participant.
   participant: {
@@ -12318,7 +12430,6 @@ var UPG_PROPERTY_SCHEMA = {
   // PrototypeProperties: Prototype.
   prototype: {
     fidelity: { type: "string", enum: ["low", "medium", "high"], description: "Detail level" },
-    test_status: { type: "string", enum: ["untested", "testing", "passed", "failed"], description: "User-test status" },
     tool: { type: "string", description: "Authoring tool" }
   },
   // QaSessionProperties: QA session.
@@ -12448,8 +12559,7 @@ var UPG_PROPERTY_SCHEMA = {
   // ReviewGateProperties: Review gate.
   review_gate: {
     gate_type: { type: "string", enum: ["human_review", "automated_check", "approval"], description: "Kind of review required at this gate" },
-    required_approvers: { type: "string[]", description: "People or roles that must approve. Promote to `node_owned_by_person` edges (one per name) if ownership must be queryable." },
-    gate_status: { type: "string", enum: ["pending", "approved", "rejected", "bypassed"], description: "Current approval status of the gate" }
+    required_approvers: { type: "string[]", description: "People or roles that must approve. Promote to `node_owned_by_person` edges (one per name) if ownership must be queryable." }
   },
   // RiskProperties: Risk.
   risk: {
@@ -12494,7 +12604,6 @@ var UPG_PROPERTY_SCHEMA = {
   roadmap_item: {
     quarter: { type: "string", description: 'Planning quarter (e.g. "Q2 2026"). Pair with `start_date`/`target_date` for precise scheduling.' },
     priority: { type: "string", enum: ["urgent", "high", "medium", "low", "none"], description: "Importance against other items" },
-    item_status: { type: "string", enum: ["planned", "in_progress", "shipped", "deferred"], description: "Status. `deferred` = explicitly pushed to a later period." },
     confidence: {
       type: "assessment",
       scale_id: "confidence_5",
@@ -12574,7 +12683,6 @@ var UPG_PROPERTY_SCHEMA = {
   // SecurityAuditProperties: Security audit.
   security_audit: {
     audit_scope: { type: "string", description: "Systems or processes covered by the audit" },
-    audit_status: { type: "string", enum: ["scheduled", "in_progress", "completed"], description: "Current progress of the audit" },
     findings_count: { type: "number", description: "Total number of findings", modifier: "derived" },
     critical_findings: { type: "number", description: "Number of critical-severity findings" }
   },
@@ -29193,7 +29301,7 @@ function validateExpression(expr) {
 }
 
 // src/format/canonical.ts
-var import_node_crypto = require("crypto");
+var nodeCrypto = __toESM(require("crypto"), 1);
 var UPG_CANONICAL_FORMAT_VERSION = "1.0.0";
 var INTEGRITY_HASH_PRIMITIVE = "sha256";
 var INTEGRITY_DIGEST_HEX = 32;
@@ -29369,7 +29477,7 @@ function portfolioBody(doc) {
 function computeBodyChecksum(doc) {
   const body = isPortfolio(doc) ? portfolioBody(doc) : singleBody(doc);
   const content = JSON.stringify(body);
-  return (0, import_node_crypto.createHash)(INTEGRITY_HASH_PRIMITIVE).update(content).digest("hex").slice(0, INTEGRITY_DIGEST_HEX);
+  return nodeCrypto.createHash(INTEGRITY_HASH_PRIMITIVE).update(content).digest("hex").slice(0, INTEGRITY_DIGEST_HEX);
 }
 function isPortfolio(doc) {
   return doc.type === "portfolio" || "cross_edges" in doc;
@@ -29507,7 +29615,7 @@ function isCanonical(text) {
 }
 
 // src/index.ts
-var UPG_VERSION = "0.14.0";
+var UPG_VERSION = "0.15.0";
 var UPG_FORMAT_VERSION = "0.4.0";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();