@unified-product-graph/core 0.15.0 → 0.16.1

package/dist/index.d.cts

@@ -10001,15 +10001,12 @@ type MarketingPlatform = 'discord' | 'email' | 'google' | 'instagram' | 'linkedi
  * @example
  * const properties: OrganizationProperties = {
  *   logo_url: 'https://arkheiev.com/logo.svg',
- *   billing_plan: 'business-annual',
  *   industry: 'Developer Tools',
  * }
  */
 interface OrganizationProperties {
     /** URL of the organisation's logo */
     logo_url?: string;
-    /** Current billing / subscription plan */
-    billing_plan?: string;
     /** Industry vertical the organisation operates in */
     industry?: string;
 }
@@ -13350,8 +13347,6 @@ interface InvestigationProperties {
     resolved_at?: ISODateTime;
     /** 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. */
     lead_investigator?: string;
-    /** Originating session */
-    session_id?: string;
     /**
      * Kind of issue under investigation. Distinct from `RootCauseProperties.cause_category`,
      * which captures *why something went wrong*.
@@ -15072,7 +15067,6 @@ interface InternalDocProperties {
  *   source_url: 'https://github.com/unified-product-graph/core/blob/main/spec/v0.2/upg-core.md',
  *   platform: 'markdown',
  *   document_type: 'spec',
- *   author: 'fraan@theproductcreator.com',
  *   last_updated: '2026-04-28T13:27:08Z',
  *   word_count: 2480,
  *   content_summary: 'Defines the v0.2 entity catalogue, edge catalogue, and migration adapters.',
@@ -15087,8 +15081,6 @@ interface DocumentProperties {
     platform?: 'markdown' | 'notion' | 'figma' | 'google_docs' | 'confluence' | 'github' | 'linear' | 'other';
     /** Purpose classification */
     document_type?: 'vision' | 'plan' | 'decision' | 'research' | 'spec' | 'audit' | 'session' | 'feedback' | 'case-study' | 'narrative' | 'bug-report' | 'archive-collection' | 'rfc' | 'runbook' | 'guide' | 'onboarding' | 'brief' | 'report' | 'reference';
-    /** Author (free-form: name, email, or handle). Promote to a `node_owned_by_person` edge if ownership must be queryable. */
-    author?: string;
     /** ISO 8601 last-meaningful-update */
     last_updated?: ISODateTime;
     /** Approximate word count. Useful for planning, indexing, summarisation. */
@@ -15176,12 +15168,6 @@ interface LegalEntityProperties {
     jurisdiction?: string;
     /** Description of intellectual property ownership */
     ip_ownership?: string;
-    /** Principal business address */
-    principal_address?: string;
-    /** Tax identification number */
-    tax_id?: string;
-    /** Official registration or incorporation number */
-    registration_number?: string;
     /** Date the entity was incorporated (ISO format) */
     date_incorporated?: string;
 }
@@ -15449,14 +15435,11 @@ interface RoleProperties {
  *
  * @example
  * const properties: PersonProperties = {
- *   email: 'ada@example.com',
  *   role_title: 'Product Engineer',
  *   time_zone: 'Europe/Berlin',
  * }
  */
 interface PersonProperties {
-    /** Primary contact email. Stable identifier for de-duplication. */
-    email?: string;
     /** Free-text job title. Distinct from the structured `role` entity. */
     role_title?: string;
     /** IANA time zone (e.g. "Europe/Berlin"). Useful for capacity / on-call planning. */
@@ -15800,8 +15783,6 @@ interface AiModelProperties {
     model_version?: string;
     /** Intended use case */
     model_purpose?: string;
-    /** Cost per 1,000 tokens */
-    cost_per_1k_tokens?: number;
     /** Maximum context window (tokens) */
     context_window?: number;
     /** Median latency (p50, ms) */
@@ -17186,25 +17167,17 @@ interface AccountProperties {
     industry?: string;
     /** Number of employees at the account */
     employee_count?: number;
-    /** Annual revenue of the account */
-    annual_revenue?: number;
 }
 /** Contact.
  *
  * @example
  * const properties: ContactProperties = {
  *   contact_role: 'champion',
- *   email: 'sam.patel@arkheiev.com',
- *   phone: '+49 30 123456',
  * }
  */
 interface ContactProperties {
     /** Job title or role within the account */
     contact_role?: string;
-    /** Email address */
-    email?: string;
-    /** Phone number */
-    phone?: string;
     /** Whether this person has purchasing authority */
     is_decision_maker?: boolean;
 }
@@ -18190,7 +18163,6 @@ interface PartnerRevenueShareProperties {
  *
  * @example
  * const properties: WorkspaceProperties = {
- *   slug: 'q2-discovery',
  *   visibility: 'shared',
  *   purpose: 'Arrange personas, jobs, and opportunities for the Q2 discovery sprint.',
  *   workspace_purpose: 'discovery',
@@ -18202,8 +18174,6 @@ interface PartnerRevenueShareProperties {
  * }
  */
 interface WorkspaceProperties {
-    /** URL-friendly identifier */
-    slug?: string;
     /** Who can see this workspace */
     visibility?: 'private' | 'shared' | 'public';
     /** Free-text description. Pairs with the closed-enum `workspace_purpose`. */
@@ -21839,7 +21809,7 @@ declare function isCanonical(text: string): boolean;
  * it stamps the `upg_version` field of every `.upg` file written by the SDK.
  * The `check:version-lockstep` gate enforces this at release time.
  */
-declare const UPG_VERSION: "0.15.0";
+declare const UPG_VERSION: "0.16.1";
 /**
  * The `.upg` JSON document format version. Written to the `upg_version` field.
  * Evolves independently from `UPG_VERSION` (the catalogue version).

package/dist/index.d.ts

@@ -10001,15 +10001,12 @@ type MarketingPlatform = 'discord' | 'email' | 'google' | 'instagram' | 'linkedi
  * @example
  * const properties: OrganizationProperties = {
  *   logo_url: 'https://arkheiev.com/logo.svg',
- *   billing_plan: 'business-annual',
  *   industry: 'Developer Tools',
  * }
  */
 interface OrganizationProperties {
     /** URL of the organisation's logo */
     logo_url?: string;
-    /** Current billing / subscription plan */
-    billing_plan?: string;
     /** Industry vertical the organisation operates in */
     industry?: string;
 }
@@ -13350,8 +13347,6 @@ interface InvestigationProperties {
     resolved_at?: ISODateTime;
     /** 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. */
     lead_investigator?: string;
-    /** Originating session */
-    session_id?: string;
     /**
      * Kind of issue under investigation. Distinct from `RootCauseProperties.cause_category`,
      * which captures *why something went wrong*.
@@ -15072,7 +15067,6 @@ interface InternalDocProperties {
  *   source_url: 'https://github.com/unified-product-graph/core/blob/main/spec/v0.2/upg-core.md',
  *   platform: 'markdown',
  *   document_type: 'spec',
- *   author: 'fraan@theproductcreator.com',
  *   last_updated: '2026-04-28T13:27:08Z',
  *   word_count: 2480,
  *   content_summary: 'Defines the v0.2 entity catalogue, edge catalogue, and migration adapters.',
@@ -15087,8 +15081,6 @@ interface DocumentProperties {
     platform?: 'markdown' | 'notion' | 'figma' | 'google_docs' | 'confluence' | 'github' | 'linear' | 'other';
     /** Purpose classification */
     document_type?: 'vision' | 'plan' | 'decision' | 'research' | 'spec' | 'audit' | 'session' | 'feedback' | 'case-study' | 'narrative' | 'bug-report' | 'archive-collection' | 'rfc' | 'runbook' | 'guide' | 'onboarding' | 'brief' | 'report' | 'reference';
-    /** Author (free-form: name, email, or handle). Promote to a `node_owned_by_person` edge if ownership must be queryable. */
-    author?: string;
     /** ISO 8601 last-meaningful-update */
     last_updated?: ISODateTime;
     /** Approximate word count. Useful for planning, indexing, summarisation. */
@@ -15176,12 +15168,6 @@ interface LegalEntityProperties {
     jurisdiction?: string;
     /** Description of intellectual property ownership */
     ip_ownership?: string;
-    /** Principal business address */
-    principal_address?: string;
-    /** Tax identification number */
-    tax_id?: string;
-    /** Official registration or incorporation number */
-    registration_number?: string;
     /** Date the entity was incorporated (ISO format) */
     date_incorporated?: string;
 }
@@ -15449,14 +15435,11 @@ interface RoleProperties {
  *
  * @example
  * const properties: PersonProperties = {
- *   email: 'ada@example.com',
  *   role_title: 'Product Engineer',
  *   time_zone: 'Europe/Berlin',
  * }
  */
 interface PersonProperties {
-    /** Primary contact email. Stable identifier for de-duplication. */
-    email?: string;
     /** Free-text job title. Distinct from the structured `role` entity. */
     role_title?: string;
     /** IANA time zone (e.g. "Europe/Berlin"). Useful for capacity / on-call planning. */
@@ -15800,8 +15783,6 @@ interface AiModelProperties {
     model_version?: string;
     /** Intended use case */
     model_purpose?: string;
-    /** Cost per 1,000 tokens */
-    cost_per_1k_tokens?: number;
     /** Maximum context window (tokens) */
     context_window?: number;
     /** Median latency (p50, ms) */
@@ -17186,25 +17167,17 @@ interface AccountProperties {
     industry?: string;
     /** Number of employees at the account */
     employee_count?: number;
-    /** Annual revenue of the account */
-    annual_revenue?: number;
 }
 /** Contact.
  *
  * @example
  * const properties: ContactProperties = {
  *   contact_role: 'champion',
- *   email: 'sam.patel@arkheiev.com',
- *   phone: '+49 30 123456',
  * }
  */
 interface ContactProperties {
     /** Job title or role within the account */
     contact_role?: string;
-    /** Email address */
-    email?: string;
-    /** Phone number */
-    phone?: string;
     /** Whether this person has purchasing authority */
     is_decision_maker?: boolean;
 }
@@ -18190,7 +18163,6 @@ interface PartnerRevenueShareProperties {
  *
  * @example
  * const properties: WorkspaceProperties = {
- *   slug: 'q2-discovery',
  *   visibility: 'shared',
  *   purpose: 'Arrange personas, jobs, and opportunities for the Q2 discovery sprint.',
  *   workspace_purpose: 'discovery',
@@ -18202,8 +18174,6 @@ interface PartnerRevenueShareProperties {
  * }
  */
 interface WorkspaceProperties {
-    /** URL-friendly identifier */
-    slug?: string;
     /** Who can see this workspace */
     visibility?: 'private' | 'shared' | 'public';
     /** Free-text description. Pairs with the closed-enum `workspace_purpose`. */
@@ -21839,7 +21809,7 @@ declare function isCanonical(text: string): boolean;
  * it stamps the `upg_version` field of every `.upg` file written by the SDK.
  * The `check:version-lockstep` gate enforces this at release time.
  */
-declare const UPG_VERSION: "0.15.0";
+declare const UPG_VERSION: "0.16.1";
 /**
  * The `.upg` JSON document format version. Written to the `upg_version` field.
  * Evolves independently from `UPG_VERSION` (the catalogue version).

package/dist/index.js

@@ -7381,6 +7381,75 @@ 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
@@ -9942,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" }
@@ -9970,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: {
@@ -10076,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" },
@@ -10091,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" }
   },
@@ -10104,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" },
@@ -10146,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." }
@@ -10236,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.
@@ -10278,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: {
@@ -10327,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: {
@@ -10561,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.
@@ -10666,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." },
@@ -10821,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" },
@@ -10915,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" }
   },
@@ -10938,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." },
@@ -11247,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" },
@@ -11340,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: {
@@ -11483,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.
@@ -11688,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.
@@ -11961,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.
@@ -12048,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.' }
   },
@@ -12146,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.
@@ -13023,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: {
@@ -13055,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." },
@@ -29381,7 +29438,7 @@ function isCanonical(text) {
 }
 
 // src/index.ts
-var UPG_VERSION = "0.15.0";
+var UPG_VERSION = "0.16.1";
 var UPG_FORMAT_VERSION = "0.4.0";
 var MARKDOWN_FORMAT_VERSION = "0.1";
 var UPG_TYPES = getTypes();