@unified-product-graph/core 0.14.1 → 0.16.0

package/dist/index.js

@@ -7381,6 +7381,187 @@ function getDeprecatedTypes() {
   return deprecated;
 }
 var UPG_PROPERTY_MIGRATIONS = {
+  // ── v0.16.0: Pattern G — open-standard data boundary (UPG-691) ───────────────
+  //
+  // The portable graph holds modeling knowledge, not PII, registry filings,
+  // app-session ids, or live vendor figures. These flowed through every export /
+  // snapshot / sync. They are dropped from the body and belong to the hosting
+  // app's identity / tenancy / measurement layer instead (boundary ADR
+  // 2026-06-16-open-standard-data-boundary). The infra-pointer URLs that stay
+  // (repo_url, storage_uri, *.logo_url, help_video.url, ...) were marked
+  // `modifier:'volatile'` in this release rather than dropped, so a consumer
+  // knows they are environment-specific and may be stripped on export. The
+  // `owner: string` -> ownership-edge migration (C1) is a separate, larger wave
+  // (0.17.0). (FALSE-POSITIVE guard kept: specification.spec_url, design_token.value,
+  // vulnerability.cve_id, screen.route, bug.environment -- content / standard refs.)
+  "0.16.0": [
+    {
+      kind: "drop_props",
+      type: "person",
+      drop_props: ["email"],
+      reason: "UPG-691 boundary: person.email is PII for the hosting app identity layer, not the portable graph. Reference the modeled actor by edge; do not inline contact details."
+    },
+    {
+      kind: "drop_props",
+      type: "contact",
+      drop_props: ["email", "phone"],
+      reason: "UPG-691 boundary: contact.email / contact.phone are PII for the app identity layer, not the portable graph."
+    },
+    {
+      kind: "drop_props",
+      type: "document",
+      drop_props: ["author"],
+      reason: "UPG-691 boundary: document.author was free-text name/email (PII). The authoring actor is referenced by edge, not inlined."
+    },
+    {
+      kind: "drop_props",
+      type: "legal_entity",
+      drop_props: ["tax_id", "registration_number", "principal_address"],
+      reason: "UPG-691 boundary: government / registry identifiers belong to the tenancy / records system, not the open interchange body."
+    },
+    {
+      kind: "drop_props",
+      type: "investigation",
+      drop_props: ["session_id"],
+      reason: "UPG-691 boundary: investigation.session_id is an app-runtime / routing artifact, not modeling knowledge."
+    },
+    {
+      kind: "drop_props",
+      type: "workspace",
+      drop_props: ["slug"],
+      reason: "UPG-691 boundary: workspace.slug is an app-routing artifact, not modeling knowledge."
+    },
+    {
+      kind: "drop_props",
+      type: "organization",
+      drop_props: ["billing_plan"],
+      reason: "UPG-691 boundary: organization.billing_plan is a SaaS-account/tenancy concept. Model it via subscription / pricing_tier, not on the structural entity."
+    },
+    {
+      kind: "drop_props",
+      type: "account",
+      drop_props: ["annual_revenue"],
+      reason: "UPG-691 boundary: account.annual_revenue is live firmographic vendor data. Route live figures to a metric node, not the definition entity."
+    },
+    {
+      kind: "drop_props",
+      type: "ai_model",
+      drop_props: ["cost_per_1k_tokens"],
+      reason: "UPG-691 boundary: ai_model.cost_per_1k_tokens is a live vendor price. Route it to a metric / record entity, not the model definition."
+    }
+  ],
+  // ── 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
@@ -9830,8 +10011,8 @@ var UPG_PROPERTY_SCHEMA = {
     rule_id: { type: "string", description: "Identifier of the rule that flagged the issue" },
     help_url: { type: "string", description: "URL to documentation explaining the issue and how to fix it" },
     affected_element: { type: "string", description: "Description of the affected UI element" },
-    css_selector: { type: "string", description: "CSS selector targeting the affected element" },
-    html_snippet: { type: "string", description: "HTML snippet containing the violation" },
+    css_selector: { type: "string", description: "CSS selector targeting the affected element", modifier: "volatile" },
+    html_snippet: { type: "string", description: "HTML snippet containing the violation", modifier: "volatile" },
     tags: { type: "string[]", description: 'Tags from the audit tool (e.g. "wcag2aa", "cat.color")' },
     remediation: { type: "string", description: "Recommended fix for the issue" },
     impact_description: { type: "string", description: "Description of the user impact" }
@@ -9858,8 +10039,7 @@ var UPG_PROPERTY_SCHEMA = {
   account: {
     account_type: { type: "string", enum: ["prospect", "customer", "partner", "churned"], description: "Relationship status of this account" },
     industry: { type: "string", description: "Industry vertical the account operates in" },
-    employee_count: { type: "number", description: "Number of employees at the account", modifier: "snapshot" },
-    annual_revenue: { type: "number", description: "Annual revenue of the account" }
+    employee_count: { type: "number", description: "Number of employees at the account", modifier: "snapshot" }
   },
   // AcquisitionChannelProperties: AcquisitionChannel entity.
   acquisition_channel: {
@@ -9906,7 +10086,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.
@@ -9965,7 +10144,7 @@ var UPG_PROPERTY_SCHEMA = {
     version: { type: "string", description: "Version" },
     record_count: { type: "number", description: "Records", modifier: "snapshot" },
     format: { type: "string", description: 'Format (e.g. "jsonl", "csv", "parquet")' },
-    storage_uri: { type: "string", description: "Storage URI" },
+    storage_uri: { type: "string", description: "Storage URI", modifier: "volatile" },
     checksum: { type: "string", description: "Integrity hash" },
     provenance: { type: "string", enum: ["human_labelled", "synthetic", "scraped", "converted", "mixed"], description: "Origin" },
     license: { type: "string", description: "SPDX license identifier" },
@@ -9980,7 +10159,7 @@ var UPG_PROPERTY_SCHEMA = {
     started_at: { type: "string", description: "ISO timestamp started" },
     completed_at: { type: "string", description: "ISO timestamp completed" },
     training_steps: { type: "number", description: "Training steps or epochs completed" },
-    artifact_uri: { type: "string", description: "Produced artifact URI" },
+    artifact_uri: { type: "string", description: "Produced artifact URI", modifier: "volatile" },
     notes: { type: "string", description: "Free-text notes" },
     tags: { type: "string[]", description: "Free-form classification tags" }
   },
@@ -9993,10 +10172,9 @@ var UPG_PROPERTY_SCHEMA = {
   // AiModelProperties: AI model.
   ai_model: {
     model_provider: { type: "string", enum: ["anthropic", "openai", "google", "meta", "mistral", "custom"], description: "Provider or vendor" },
-    model_id: { type: "string", description: 'Unique model identifier (e.g. "claude-sonnet-4-20250514")' },
+    model_id: { type: "string", description: 'Unique model identifier (e.g. "claude-sonnet-4-20250514")', modifier: "volatile" },
     model_version: { type: "string", description: "Specific version" },
     model_purpose: { type: "string", description: "Intended use case" },
-    cost_per_1k_tokens: { type: "number", description: "Cost per 1,000 tokens", modifier: "snapshot" },
     context_window: { type: "number", description: "Maximum context window (tokens)" },
     latency_p50_ms: { type: "number", description: "Median latency (p50, ms)", modifier: "snapshot" },
     latency_p99_ms: { type: "number", description: "Tail latency (p99, ms)", modifier: "snapshot" },
@@ -10035,7 +10213,7 @@ var UPG_PROPERTY_SCHEMA = {
   },
   // ApiContractProperties: API contract.
   api_contract: {
-    spec_url: { type: "string", description: "URL of the specification document" },
+    spec_url: { type: "string", description: "URL of the specification document", modifier: "volatile" },
     protocol: { type: "string", enum: ["REST", "GraphQL", "gRPC", "AsyncAPI", "SOAP", "WebSocket", "MQTT", "SSE", "other"], description: "Communication protocol. `SSE` (server-sent events) added in 0.9.12." },
     version: { type: "string", description: "API version" },
     owner: { type: "string", description: "Maintaining person or team. Promote to a `node_owned_by_team` edge if ownership must be queryable." }
@@ -10125,7 +10303,7 @@ var UPG_PROPERTY_SCHEMA = {
   // BrandAssetProperties: Brand asset.
   brand_asset: {
     asset_type: { type: "string", enum: ["logo", "icon", "illustration", "photo", "video", "template"], description: "Category of the brand asset" },
-    url: { type: "string", description: "URL or path to the asset file" },
+    url: { type: "string", description: "URL or path to the asset file", modifier: "volatile" },
     usage_rights: { type: "string", description: "Usage rights or licensing restrictions" }
   },
   // BrandColourProperties: Brand colour. A single colour in the brand palette.
@@ -10167,7 +10345,7 @@ var UPG_PROPERTY_SCHEMA = {
     approved_backgrounds: { type: "string[]", description: 'Background colours the logo is approved for use on. @example ["#FFFFFF", "#1A1A1A", "#F5F5F5"]' },
     forbidden_backgrounds: { type: "string[]", description: 'Background colours or contexts where the logo must NOT be placed. @example ["busy photography", "low-contrast surfaces"]' },
     file_formats: { type: "string[]", description: 'File formats this logo variant is available in. @example ["svg", "png", "eps", "pdf"]' },
-    asset_url: { type: "string", description: "URL to the logo asset file or asset library entry." }
+    asset_url: { type: "string", description: "URL to the logo asset file or asset library entry.", modifier: "volatile" }
   },
   // BrandTypographyProperties: Brand typography. A font family and its usage rules.
   brand_typography: {
@@ -10216,8 +10394,8 @@ var UPG_PROPERTY_SCHEMA = {
     artifact_type: { type: "string", enum: ["docker_image", "npm_package", "binary", "static_assets", "other"], description: "Type" },
     version: { type: "string", description: "Version" },
     size: { type: "string", description: 'Human-readable size (e.g. "12.4 MB")' },
-    registry: { type: "string", description: "Registry or storage location" },
-    build_url: { type: "string", description: "URL of the producing CI/CD build run (GitHub Actions, CircleCI, etc.)." }
+    registry: { type: "string", description: "Registry or storage location", modifier: "volatile" },
+    build_url: { type: "string", description: "URL of the producing CI/CD build run (GitHub Actions, CircleCI, etc.).", modifier: "volatile" }
   },
   // BusinessModelProperties: BusinessModel: root of a BMC-style model.
   business_model: {
@@ -10450,8 +10628,6 @@ var UPG_PROPERTY_SCHEMA = {
   // ContactProperties: Contact.
   contact: {
     contact_role: { type: "string", description: "Job title or role within the account" },
-    email: { type: "string", description: "Email address" },
-    phone: { type: "string", description: "Phone number" },
     is_decision_maker: { type: "boolean", description: "Whether this person has purchasing authority" }
   },
   // ContentCalendarProperties: Content calendar.
@@ -10555,7 +10731,7 @@ var UPG_PROPERTY_SCHEMA = {
   // DashboardProperties: Dashboard entity.
   dashboard: {
     tool: { type: "string", enum: ["looker", "amplitude", "mixpanel", "posthog", "custom"], description: "Analytics tool hosting this dashboard" },
-    url: { type: "string", description: "URL to the live dashboard" },
+    url: { type: "string", description: "URL to the live dashboard", modifier: "volatile" },
     audience: { type: "string", description: "Intended audience for this dashboard" },
     element_count: { type: "number", description: "Number of widgets or panels on the dashboard", modifier: "derived" },
     refresh_cadence: { type: "string", enum: ["continuous", "hourly", "daily", "weekly", "monthly", "quarterly", "yearly", "on_demand", "other"], description: "How often the dashboard data refreshes. Uses the shared `Cadence` scale." },
@@ -10607,7 +10783,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")' },
@@ -10642,7 +10817,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" }
   },
@@ -10697,7 +10871,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." }
@@ -10713,7 +10886,7 @@ var UPG_PROPERTY_SCHEMA = {
   },
   // DesignConceptProperties: Design concept being explored.
   design_concept: {
-    sketch_url: { type: "string", description: "URL of the sketch or visual" },
+    sketch_url: { type: "string", description: "URL of the sketch or visual", modifier: "volatile" },
     rationale: { type: "string", description: "Selection or rejection rationale" },
     concept_status: { type: "string", enum: ["exploring", "validated", "selected", "rejected"], description: "Current selection status" },
     maturity: { type: "string", enum: ["sketch", "refined", "final"], description: "Development stage, from rough idea to presentation-ready" },
@@ -10807,7 +10980,7 @@ var UPG_PROPERTY_SCHEMA = {
   },
   // DeveloperPortalProperties: Developer portal.
   developer_portal: {
-    portal_url: { type: "string", description: "URL of the developer portal" },
+    portal_url: { type: "string", description: "URL of the developer portal", modifier: "volatile" },
     doc_count: { type: "number", description: "Number of documentation pages", modifier: "derived" },
     sandbox_available: { type: "boolean", description: "Whether a sandbox environment is available" }
   },
@@ -10830,7 +11003,6 @@ var UPG_PROPERTY_SCHEMA = {
     source_url: { type: "string", description: "Canonical retrievable URL" },
     platform: { type: "string", enum: ["markdown", "notion", "figma", "google_docs", "confluence", "github", "linear", "other"], description: "Hosting platform" },
     document_type: { type: "string", enum: ["vision", "plan", "decision", "research", "spec", "audit", "session", "feedback", "case-study", "narrative", "bug-report", "archive-collection", "rfc", "runbook", "guide", "onboarding", "brief", "report", "reference"], description: "Purpose classification" },
-    author: { type: "string", description: "Author (free-form: name, email, or handle). Promote to a `node_owned_by_person` edge if ownership must be queryable." },
     last_updated: { type: "string", description: "ISO 8601 last-meaningful-update" },
     word_count: { type: "number", description: "Approximate word count. Useful for planning, indexing, summarisation.", modifier: "snapshot" },
     content_summary: { type: "string", description: "1\u20133 sentence summary. Drives previews, search snippets, embedding context." },
@@ -11025,8 +11197,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: {
@@ -11060,13 +11231,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." },
@@ -11142,7 +11311,7 @@ var UPG_PROPERTY_SCHEMA = {
   fix: {
     fix_type: { type: "string", enum: ["hotfix", "permanent", "workaround", "configuration", "process_change"], description: "Kind of fix. `hotfix` = urgent patch. `permanent` = proper structural fix. `workaround` = mitigates symptom without addressing root cause; should track a follow-up." },
     commit: { type: "string", description: "Git commit SHA" },
-    files_changed: { type: "string[]", description: "Files changed" },
+    files_changed: { type: "string[]", description: "Files changed", modifier: "volatile" },
     deployed_at: { type: "string", description: "ISO timestamp landed in the target environment." },
     fixed_date: { type: "string", description: "Application date (ISO date). Coarser-grained complement to `deployed_at`." },
     verified: { type: "boolean", description: "Verified in production" },
@@ -11235,7 +11404,7 @@ var UPG_PROPERTY_SCHEMA = {
     video_type: { type: "string", enum: ["how_to", "overview", "troubleshooting", "best_practice"], description: "Purpose of the video" },
     duration_seconds: { type: "number", description: "Duration of the video in seconds" },
     views: { type: "number", description: "Total number of views" },
-    url: { type: "string", description: "URL where the video is hosted" }
+    url: { type: "string", description: "URL where the video is hosted", modifier: "volatile" }
   },
   // HypothesisProperties: A testable belief. The canonical design artefact for validating product assumptions.
   hypothesis: {
@@ -11378,7 +11547,6 @@ var UPG_PROPERTY_SCHEMA = {
     started_at: { type: "string", description: "ISO timestamp the investigation began" },
     resolved_at: { type: "string", description: "ISO timestamp the investigation was concluded. Pairs with `status === 'resolved' | 'abandoned'`." },
     lead_investigator: { type: "string", description: "Lead investigator (email or handle). Distinct from the team owning the affected service. Promote to a `node_owned_by_person` edge if ownership must be queryable." },
-    session_id: { type: "string", description: "Originating session" },
     category: { type: "string", enum: ["performance", "security", "data_quality", "reliability", "cost", "compliance", "other"], description: "Kind of issue under investigation. Distinct from `RootCauseProperties.cause_category`, which captures *why something went wrong*." }
   },
   // InvoiceProperties: Invoice.
@@ -11583,9 +11751,6 @@ var UPG_PROPERTY_SCHEMA = {
     entity_type: { type: "string", enum: ["corporation", "llc", "partnership", "sole_proprietor", "nonprofit"], description: "Legal structure of the entity" },
     jurisdiction: { type: "string", description: "Jurisdiction where the entity is registered" },
     ip_ownership: { type: "string", description: "Description of intellectual property ownership" },
-    principal_address: { type: "string", description: "Principal business address" },
-    tax_id: { type: "string", description: "Tax identification number" },
-    registration_number: { type: "string", description: "Official registration or incorporation number" },
     date_incorporated: { type: "string", description: "Date the entity was incorporated (ISO format)" }
   },
   // LibraryDependencyProperties: Library or package dependency.
@@ -11673,8 +11838,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: {
@@ -11832,7 +11996,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.
@@ -11858,8 +12021,7 @@ var UPG_PROPERTY_SCHEMA = {
   opportunity: {},
   // OrganizationProperties: Organization entity.
   organization: {
-    logo_url: { type: "string", description: "URL of the organisation's logo" },
-    billing_plan: { type: "string", description: "Current billing / subscription plan" },
+    logo_url: { type: "string", description: "URL of the organisation's logo", modifier: "volatile" },
     industry: { type: "string", description: "Industry vertical the organisation operates in" }
   },
   // OutcomeProperties: A measurable change in user or business state the product drives.
@@ -11881,8 +12043,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: {
@@ -11946,7 +12107,6 @@ var UPG_PROPERTY_SCHEMA = {
   },
   // PersonProperties: Person entity. A named, accountable individual.
   person: {
-    email: { type: "string", description: "Primary contact email. Stable identifier for de-duplication." },
     role_title: { type: "string", description: "Free-text job title. Distinct from the structured `role` entity." },
     time_zone: { type: "string", description: 'IANA time zone (e.g. "Europe/Berlin"). Useful for capacity / on-call planning.' }
   },
@@ -12044,8 +12204,8 @@ var UPG_PROPERTY_SCHEMA = {
   product: {
     stage: { type: "string", enum: ["concept", "validation", "build", "beta", "launch", "growth", "mature", "maintenance", "sunset"], description: "Lifecycle stage" },
     health_status: { type: "string", enum: ["on_track", "at_risk", "off_track"], description: "Overall health" },
-    url: { type: "string", description: "Where the product lives. Marketing site, app store URL, etc." },
-    logo_url: { type: "string", description: "Logo or icon URL. Used to render product cards and lists." },
+    url: { type: "string", description: "Where the product lives. Marketing site, app store URL, etc.", modifier: "volatile" },
+    logo_url: { type: "string", description: "Logo or icon URL. Used to render product cards and lists.", modifier: "volatile" },
     launched_at: { type: "string", description: "When the product became generally available (ISO 8601)" }
   },
   // ProductAreaProperties: ProductArea entity.
@@ -12094,7 +12254,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.
@@ -12224,8 +12383,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: {
@@ -12270,7 +12428,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",
@@ -12350,7 +12507,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" }
   },
@@ -12925,7 +13081,7 @@ var UPG_PROPERTY_SCHEMA = {
     version: { type: "string", description: 'Version or iteration (e.g. "v2", "2026-04-B")' },
     tool: { type: "string", description: 'Authoring tool. @example "Figma", "Balsamiq", "pen and paper"' },
     review_status: { type: "string", enum: ["draft", "in_review", "approved", "rejected"], description: "Review gate status" },
-    linked_prototype_url: { type: "string", description: "URL of the corresponding interactive prototype" }
+    linked_prototype_url: { type: "string", description: "URL of the corresponding interactive prototype", modifier: "volatile" }
   },
   // WorkflowArtifactProperties: Workflow artifact.
   workflow_artifact: {
@@ -12957,7 +13113,6 @@ var UPG_PROPERTY_SCHEMA = {
   },
   // WorkspaceProperties: Workspace: a spatial thinking space for arranging entities.
   workspace: {
-    slug: { type: "string", description: "URL-friendly identifier" },
     visibility: { type: "string", enum: ["private", "shared", "public"], description: "Who can see this workspace" },
     purpose: { type: "string", description: "Free-text description. Pairs with the closed-enum `workspace_purpose`." },
     workspace_purpose: { type: "string", enum: ["discovery", "planning", "retrospective", "design", "research", "strategy", "general"], description: "Closed-enum classifier. Drives template suggestions and surfaces in workspace browsers. `discovery` = persona/job/opportunity exploration. `planning` = roadmap and decision sessions. `retrospective` = reflection on shipped work. `design` = experience or UI exploration. `research` = organising study data and synthesis. `strategy` = high-level direction setting. `general` = catch-all." },
@@ -29283,7 +29438,7 @@ function isCanonical(text) {
 }
 
 // src/index.ts
-var UPG_VERSION = "0.14.1";
+var UPG_VERSION = "0.16.0";
 var UPG_FORMAT_VERSION = "0.4.0";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();