@yottagraph-app/data-model-skill 0.0.13 → 0.0.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yottagraph-app/data-model-skill",
-  "version": "0.0.13",
+  "version": "0.0.15",
   "description": "Data model skill documentation for AI agents - entity types, properties, and schemas from Lovelace fetch sources",
   "repository": {
     "type": "git",

package/skill/edgar/DATA_DICTIONARY.md

@@ -51,6 +51,16 @@ Each SEC form type is a separate flavor, namespaced under `sec`. All share the s
 | `sec::sc_13g` | SC 13G | Beneficial ownership report (passive) |
 | `sec::13f_hr` | 13F-HR | Institutional investment manager holdings |
 | `sec::def_14a` | DEF 14A | Definitive proxy statement |
+| `sec::6_k` | 6-K | Foreign private issuer current report (XBRL only, no form download) |
+| `sec::40_f` | 40-F | Canadian cross-border annual report (XBRL only, no form download) |
+| `sec::filing` | SEC Filing | Generic filing — defined in `schema.yaml` but **never produced**: `SecFormFlavor()` returns `""` for unmodeled forms, causing them to be skipped in `AtomizeFilingsV2` |
+
+### `industry`
+
+A Standard Industrial Classification (SIC) category assigned by the SEC.
+
+- Primary key: `sic_code`
+- Entity resolver: named entity. Strong ID = `sic_code`.
 
 ### Sub-Records (8-K Events, Form 4 Transactions, Form 3 Holdings)
 
@@ -84,7 +94,7 @@ organization --[filed]--> 8-K filing --[linked, distance 1]--> event sub-records
 A corporate insider (officer, director, or significant owner) from Form 3 or Form 4.
 
 - Primary key: `person_cik` when available; otherwise named entity resolution.
-- Entity resolver: named entity, mergeable. Strong ID = `person_cik` when present.
+- Entity resolver: named entity, not mergeable. Strong ID = `person_cik` when present.
 
 ### `financial_instrument`
 
@@ -178,12 +188,28 @@ The six core financial properties appear on both the **organization** and its **
 * `total_liabilities` — Sum of all liabilities. May be computed fallback. Unit: USD. On: organization + document
 * `shareholders_equity` — Total stockholders' equity. Unit: USD. On: organization + document
 * `shares_outstanding` — Common shares outstanding. Unit: shares. On: organization + document
-* `eps_basic` — Basic earnings per share (10-K only). Unit: USD. On: document only
-* `eps_diluted` — Diluted earnings per share (10-K only). Unit: USD. On: document only
+* `eps_basic` — Basic earnings per share. Unit: USD. On: document only (10-K, 10-Q, 20-F)
+* `eps_diluted` — Diluted earnings per share. Unit: USD. On: document only (10-K, 10-Q, 20-F)
 * `entity_shell_company` — Whether the entity is a shell company. Values: `"true"`, `"false"`. On: organization only
 * `reporting_currency` — ISO 4217 currency code (20-F only). Examples: `"JPY"`, `"EUR"`. On: document only
 * `country_of_incorporation` — Country of incorporation (20-F only). Examples: `"Japan"`, `"Israel"`. On: document only
 
+#### DEI Cover Page Properties (source: `edgar_10k`, `edgar_10q`)
+
+Data source: iXBRL DEI (Document and Entity Information) cover page elements. On organization only unless noted.
+
+* `entity_number_of_employees` — Workforce size (10-K only). Unit: count
+* `entity_filer_category_dei` — Filer category from DEI. Examples: `"Large Accelerated Filer"`, `"Non-accelerated Filer"`
+* `entity_small_business` — Whether the entity is a smaller reporting company. Values: `"true"`, `"false"`
+* `entity_emerging_growth_company` — Whether the entity is an emerging growth company (JOBS Act). Values: `"true"`, `"false"`
+* `entity_voluntary_filers` — Voluntary vs mandatory filer status (10-K only). Values: `"Yes"`, `"No"`
+* `entity_well_known_seasoned_issuer` — WKSI flag — shelf registration eligible (10-K only). Values: `"Yes"`, `"No"`
+* `entity_tax_id_number` — IRS tax identification number from DEI (10-K only)
+* `security_12b_title` — Title of listed security class. Example: `"Common Stock, $0.00001 par value per share"`
+* `entity_listing_exchange` — Securities exchange from DEI. Examples: `"NASDAQ"`, `"NYSE"`
+* `document_fiscal_period_focus` — Fiscal period. Values: `"FY"`, `"Q1"`, `"Q2"`, `"Q3"`. On: organization + document
+* `entity_incorporation_state_dei` — State or country of incorporation from DEI (cross-check vs submissions API)
+
 #### 8-K Corporate Events (source: `edgar_8k`)
 
 Data source: 8-K current report filings.
@@ -225,6 +251,9 @@ Data source: SC 13D/G XML filings. Properties on the filer organization.
 * `shares_declared` — Shares by individual group member. Unit: shares
 * `ownership_percent` — Percentage by individual member or SC 13G filer
 * `investment_purpose` — Stated purpose from Item 4. Examples: `"Investment"`, `"Strategic investment"`
+* `intends_to_buy_more` — Filer stated intent to acquire additional shares. Float: `1.0` when true (only stored when true)
+* `intends_to_sell_all` — Filer stated intent to dispose of all shares. Float: `1.0` when true (only stored when true)
+* `intends_to_influence` — Filer stated intent to influence board or management. Float: `1.0` when true (only stored when true)
 * `is_passive_investor` — Always `1.0` on SC 13G records
 * `aggregate_amount_beneficially_owned` — Total shares beneficially owned. Unit: shares
 * `sole_voting_power` / `shared_voting_power` — Sole/shared voting authority. Unit: shares
@@ -242,6 +271,10 @@ Data source: co-registrant entries and EX-21 exhibit subsidiary tables.
 * `is_part_of` — Relationship: subsidiary → parent
 * `citizenship_or_state_of_organization` — Subsidiary jurisdiction (EX-21 only)
 
+#### 8-K Counterparties (source: `edgar_8k`)
+
+* `relationship_type` — Relationship between a counterparty organization and the issuer from 8-K (e.g. `"acquirer"`, `"creditor"`). On: counterparty organization entity
+
 ### Document Properties
 
 #### Filing Metadata (all pipelines)
@@ -279,6 +312,8 @@ Data source: Form 3/4 XML.
 
 * `person_cik` — SEC CIK for the reporting person (10-digit zero-padded). From `<rptOwnerCik>`.
 * `job_title` — Officer title. Examples: `"Chief Executive Officer"`, `"Director"`. From `<officerTitle>`.
+* `owner_address` — Reporting owner address from Form 3/4 XML (city, state)
+* `change_type` — Type of officer/director change from 8-K Item 5.02 (source: `edgar_8k`, not Form 3/4). Examples: `"appointed"`, `"resigned"`, `"terminated"`
 * `is_officer` — Relationship: person → organization (when `<isOfficer>1`)
 * `is_director` — Relationship: person → organization (when `<isDirector>1`)
 * `is_ten_percent_owner` — Relationship: person → organization (when `<isTenPercentOwner>1`)
@@ -303,13 +338,18 @@ Data source: Form 3/4 XML.
 * `price_per_share` — Transaction price. Unit: USD
 * `shares_owned_after` — Post-transaction shares. Unit: shares
 * `exercise_price` — Derivative exercise price (USD, derivatives only)
+* `underlying_security_type` — Title of the underlying security for derivative holdings
+* `underlying_security_shares` — Shares of the underlying security for derivative holdings. Unit: shares
 * `direct_or_indirect_ownership` — `"Direct"` or `"Indirect"`
 * `is_10b5_1_plan` — `"true"` when under a Rule 10b5-1 plan
+* `equity_swap_involved` — Whether the transaction involves an equity swap. Values: `"true"`, `"false"`
+* `footnote_text` — Footnote text providing transaction context (plan details, vesting schedules)
+* `insider_trade_event` — Derived event classification. Values: `"INSIDER_BUY"`, `"INSIDER_SELL"`
 
 #### DEF 14A Proxy (source: `edgar_def_14a`)
 
 * `board_committee` — Committee membership. Examples: `"Audit"`, `"Compensation"`
-* `is_independent` — Independence classification. Values: `"true"`, `"false"`
+* `is_independent` — Independence classification. Float: `1.0` = independent, `0.0` = not independent
 * `director_since` — Year. Example: `"2018"`
 * `total_compensation` — Summary Compensation Table total. Unit: USD
 * `board_size` — Number of directors (also on document)
@@ -331,6 +371,8 @@ Data source: 13F-HR XML information table.
 * `put_call` — `"PUT"`, `"CALL"`, or empty for equity
 * `voting_authority_sole` / `voting_authority_shared` / `voting_authority_none` — Voting authority breakdown. Unit: shares
 * `investment_discretion` — `"SOLE"`, `"DFND"`, or `"OTR"` (on organization)
+* `report_period_date` — Quarter-end date for the 13F-HR report period (YYYY-MM-DD). On: document only
+* `confidential_treatment_flag` — Whether the manager requested confidential treatment. On: document only
 * `holds_position` — Relationship: investment manager → financial instrument
 
 ---
@@ -342,10 +384,12 @@ Data source: 13F-HR XML information table.
 ```
 organization         ──[filed]────────────────────→ document
 organization         ──[filing_reference]─────────→ document
+organization         ──[is_issuer_of]─────────────→ document        (Forms 3/4, SC 13D/G: issuer → ownership filing)
 organization         ──[owns_stake_in]────────────→ organization    (SC 13D/G)
 organization         ──[has_subsidiary]───────────→ organization    (co-registrant, EX-21)
 organization         ──[is_part_of]───────────────→ organization    (subsidiary → parent)
 organization         ──[holds_position]───────────→ financial_instrument (13F-HR)
+organization         ──[issues_security]──────────→ financial_instrument (SC 13D/G: issuer → CUSIP)
 document             ──[issued_by]────────────────→ organization
 document             ──[refers_to]────────────────→ organization
 document             ──[filer]────────────────────→ organization    (SC 13D/G)
@@ -357,6 +401,7 @@ person               ──[is_officer]─────────────
 person               ──[is_director]──────────────→ organization
 person               ──[is_ten_percent_owner]─────→ organization
 person               ──[works_at]─────────────────→ organization
+person               ──[owns_stake_in]────────────→ organization    (SC 13D/G: person beneficial owner)
 person               ──[filing_reference]─────────→ document
 financial_instrument ──[filing_reference]─────────→ document
 ```

package/skill/edgar/schema.yaml

@@ -647,7 +647,7 @@ properties:
     description: "Total revenues (USD). XBRL: us-gaap:Revenues"
     display_name: "Revenues"
     mergeability: not_mergeable
-    domain_flavors: ["sec::10_k", "sec::10_q", "sec::20_f", "sec::8_k", "sec::6_k", "sec::40_f", "organization"]
+    domain_flavors: ["sec::10_k", "sec::10_q", "sec::20_f", "sec::8_k", "sec::6_k", "sec::40_f", "sec::def_14a", "organization"]
     passive: true
 
   - name: "us_gaap:net_income_loss"
@@ -655,7 +655,7 @@ properties:
     description: "Net income or loss (USD). XBRL: us-gaap:NetIncomeLoss"
     display_name: "Net Income/Loss"
     mergeability: not_mergeable
-    domain_flavors: ["sec::10_k", "sec::10_q", "sec::20_f", "sec::8_k", "sec::6_k", "sec::40_f", "organization"]
+    domain_flavors: ["sec::10_k", "sec::10_q", "sec::20_f", "sec::8_k", "sec::6_k", "sec::40_f", "sec::def_14a", "organization"]
     passive: true
 
   - name: "us_gaap:operating_income_loss"
@@ -799,7 +799,7 @@ properties:
     description: "Profit or loss including noncontrolling interest (USD). XBRL: us-gaap:ProfitLoss"
     display_name: "Profit/Loss"
     mergeability: not_mergeable
-    domain_flavors: ["sec::10_k", "sec::10_q", "sec::20_f", "sec::8_k", "sec::6_k", "sec::40_f", "organization"]
+    domain_flavors: ["sec::10_k", "sec::10_q", "sec::20_f", "sec::8_k", "sec::6_k", "sec::40_f", "sec::def_14a", "organization"]
     passive: true
 
   - name: "us_gaap:cogs"
@@ -815,7 +815,7 @@ properties:
     description: "Depreciation, depletion and amortization (USD). XBRL: us-gaap:DepreciationDepletionAndAmortization"
     display_name: "D&A"
     mergeability: not_mergeable
-    domain_flavors: ["sec::10_k", "sec::10_q", "sec::20_f", "sec::8_k", "sec::6_k", "sec::40_f", "organization"]
+    domain_flavors: ["sec::10_k", "sec::10_q", "sec::20_f", "sec::8_k", "sec::6_k", "sec::40_f", "sec::def_14a", "organization"]
     passive: true
 
   - name: "us_gaap:interest_expense"
@@ -823,7 +823,7 @@ properties:
     description: "Interest expense (USD). XBRL: us-gaap:InterestExpense"
     display_name: "Interest Expense"
     mergeability: not_mergeable
-    domain_flavors: ["sec::10_k", "sec::10_q", "sec::20_f", "sec::8_k", "sec::6_k", "sec::40_f", "organization"]
+    domain_flavors: ["sec::10_k", "sec::10_q", "sec::20_f", "sec::8_k", "sec::6_k", "sec::40_f", "sec::def_14a", "organization"]
     passive: true
 
   - name: "us_gaap:interest_expense_nonoperating"
@@ -1067,7 +1067,7 @@ properties:
     description: "Income tax expense or benefit (USD). XBRL: us-gaap:IncomeTaxExpenseBenefit"
     display_name: "Income Tax Expense"
     mergeability: not_mergeable
-    domain_flavors: ["sec::10_k", "sec::10_q", "sec::20_f", "sec::8_k", "sec::6_k", "sec::40_f", "organization"]
+    domain_flavors: ["sec::10_k", "sec::10_q", "sec::20_f", "sec::8_k", "sec::6_k", "sec::40_f", "sec::def_14a", "organization"]
     passive: true
 
   - name: "us_gaap:operating_expenses"

package/skill/sanctions/schema.yaml

@@ -19,24 +19,91 @@ flavors:
     description: "A real person as opposed to a fictional character, such as a CEO, politician, or public figure"
     display_name: "Person"
     mergeability: not_mergeable
+    strong_id_properties: ["sanctions_id"]
     passive: true
 
   - name: "organization"
     description: "A particular business, institution, or organization such as a corporation, university, government agency, or non-profit"
     display_name: "Organization"
     mergeability: not_mergeable
+    strong_id_properties: ["sanctions_id"]
+    passive: true
+
+  - name: "legal_entity"
+    description: "An entity with legal personality whose type (person vs organization) is unknown in the source data, common in leak-derived datasets like ICIJ Offshore Leaks"
+    display_name: "Legal Entity"
+    mergeability: not_mergeable
+    strong_id_properties: ["sanctions_id"]
     passive: true
 
   - name: "sanction_program"
     description: "A government or international sanctions program under which entities are designated"
     display_name: "Sanction Program"
     mergeability: not_mergeable
+    strong_id_properties: ["program_id"]
     passive: true
 
-  - name: "country"
-    description: "A country referenced by sanctioned organizations, identified by ISO country code"
-    display_name: "Country"
+  - name: "ship"
+    description: "A vessel (boat or ship) identified in sanctions designations"
+    display_name: "Vessel"
+    mergeability: not_mergeable
+    strong_id_properties: ["sanctions_id"]
+    passive: true
+
+  - name: "aircraft"
+    description: "An airplane identified in sanctions designations"
+    display_name: "Aircraft"
     mergeability: not_mergeable
+    strong_id_properties: ["sanctions_id"]
+    passive: true
+
+  - name: "financial_instrument"
+    description: "A specific asset that can be traded, such as a stock, ETF, bond, CD, or fund. Companies are organizations, NOT financial instruments. Specific currency amounts are NOT financial instruments."
+    display_name: "Security"
+    mergeability: not_mergeable
+    strong_id_properties: ["sanctions_id", "cusip_number", "isin"]
+    passive: true
+
+  - name: "crypto_wallet"
+    description: "A cryptocurrency wallet address identified in sanctions designations"
+    display_name: "Crypto Wallet"
+    mergeability: not_mergeable
+    strong_id_properties: ["sanctions_id", "public_key"]
+    passive: true
+
+  - name: "location"
+    description: "A specific named geographic location such as a city, country, region, or landmark"
+    display_name: "Address"
+    mergeability: not_mergeable
+    strong_id_properties: ["sanctions_id"]
+    passive: true
+
+  - name: "political_position"
+    description: "A political office or government position held by a PEP"
+    display_name: "Political Position"
+    mergeability: not_mergeable
+    strong_id_properties: ["sanctions_id"]
+    passive: true
+
+  - name: "physical_asset"
+    description: "A physical asset such as real estate or business property linked to a sanctioned person"
+    display_name: "Physical Asset"
+    mergeability: not_mergeable
+    strong_id_properties: ["sanctions_id"]
+    passive: true
+
+  - name: "article"
+    description: "A news article or press release being processed"
+    display_name: "Article"
+    mergeability: not_mergeable
+    strong_id_properties: ["sanctions_id"]
+    passive: true
+
+  - name: "identity_document"
+    description: "An identity document (passport, national ID) linked to a sanctioned person"
+    display_name: "Identity Document"
+    mergeability: not_mergeable
+    strong_id_properties: ["sanctions_id"]
     passive: true
 
 properties:
@@ -45,7 +112,7 @@ properties:
     description: "Unique identifier assigned to this entity by the upstream sanctions data provider (OpenSanctions entity ID)"
     display_name: "Sanctions ID"
     mergeability: not_mergeable
-    domain_flavors: ["person", "organization"]
+    domain_flavors: ["person", "organization", "legal_entity", "ship", "aircraft", "financial_instrument", "crypto_wallet", "location", "political_position", "physical_asset", "article", "identity_document"]
     examples: ["ch-seco-94982", "us-ofac-12345"]
     passive: true
 
@@ -54,7 +121,7 @@ properties:
     description: "Display name of the entity"
     display_name: "Name"
     mergeability: not_mergeable
-    domain_flavors: ["person", "organization"]
+    domain_flavors: ["person", "organization", "legal_entity", "sanction_program", "ship", "aircraft", "financial_instrument", "crypto_wallet", "location", "political_position", "physical_asset", "article"]
     examples: ["Zhongheng Lin", "Vladimir Putin"]
     passive: true
 
@@ -63,7 +130,7 @@ properties:
     description: "An alternative name or spelling for this entity, one atom per alias"
     display_name: "Alias"
     mergeability: not_mergeable
-    domain_flavors: ["person", "organization"]
+    domain_flavors: ["person", "organization", "legal_entity", "ship", "aircraft", "financial_instrument", "crypto_wallet"]
     passive: true
 
   - name: "birth_date"
@@ -98,7 +165,7 @@ properties:
     description: "Classification tag indicating the type of sanctions designation, one atom per topic"
     display_name: "Sanctions Topic"
     mergeability: not_mergeable
-    domain_flavors: ["person", "organization"]
+    domain_flavors: ["person", "organization", "legal_entity", "ship", "aircraft", "financial_instrument", "crypto_wallet"]
     examples: ["sanction", "poi", "debarment", "entity.associate"]
     passive: true
 
@@ -107,47 +174,512 @@ properties:
     description: "Descriptive notes or commentary associated with the entity"
     display_name: "Notes"
     mergeability: not_mergeable
-    domain_flavors: ["person", "organization"]
+    domain_flavors: ["person", "organization", "legal_entity", "ship", "aircraft", "physical_asset", "crypto_wallet"]
     passive: true
 
-  - name: "sanctioned"
-    type: float
-    description: "Boolean flag indicating this entity is a sanctions target, emitted only when no notes are present as a fallback marker"
-    display_name: "Sanctioned"
+  - name: "sanction_source_url"
+    type: string
+    description: "URL of the original source document for this sanctions listing, one atom per URL"
+    display_name: "Sanction Source URL"
+    mergeability: not_mergeable
+    domain_flavors: ["person", "organization", "legal_entity", "ship", "aircraft", "financial_instrument", "crypto_wallet", "article"]
+    examples: ["https://www.federalreserve.gov/boarddocs/press/enforcement/2005/20050607/default.htm"]
+    passive: true
+
+  - name: "sanction_start_date"
+    type: string
+    description: "ISO 8601 date when this entity first appeared in the sanctions dataset (from OpenSanctions first_seen)"
+    display_name: "Sanction Start Date"
     mergeability: not_mergeable
-    domain_flavors: ["person", "organization"]
+    domain_flavors: ["person", "organization", "legal_entity", "ship", "aircraft", "financial_instrument", "crypto_wallet", "political_position", "location", "article"]
+    examples: ["2022-02-25", "2023-06-14"]
+    passive: true
+
+  - name: "sanction_end_date"
+    type: string
+    description: "ISO 8601 date when this entity was removed from the sanctions dataset; absent while actively sanctioned"
+    display_name: "Sanction End Date"
+    mergeability: not_mergeable
+    domain_flavors: ["person", "organization", "legal_entity", "ship", "aircraft", "financial_instrument", "crypto_wallet"]
+    examples: ["2026-04-06"]
+    passive: true
+
+  - name: "last_fetched"
+    type: string
+    description: "ISO 8601 date of the last dataset snapshot in which this entity or relationship was present"
+    display_name: "Last Fetched"
+    mergeability: not_mergeable
+    domain_flavors: ["person", "organization", "legal_entity", "ship", "aircraft", "financial_instrument", "crypto_wallet", "physical_asset", "political_position", "location", "article"]
+    examples: ["2026-04-09"]
     passive: true
 
   - name: "address"
     type: string
-    description: "Physical address of the sanctioned organization as stated in the sanctions listing"
+    description: "Physical street address of the entity"
     display_name: "Address"
     mergeability: not_mergeable
-    domain_flavors: ["organization"]
+    domain_flavors: ["organization", "legal_entity"]
     passive: true
 
-  - name: "sector"
+  - name: "sanction_sector"
     type: string
     description: "Business sector or industry classification of the sanctioned organization"
-    display_name: "Sector"
+    display_name: "Sanction Sector"
     mergeability: not_mergeable
     domain_flavors: ["organization"]
     examples: ["Energy", "Banking", "Defense"]
     passive: true
 
+  # Vessel properties
+  - name: "imo_number"
+    type: string
+    description: "IMO number of the vessel"
+    display_name: "IMO Number"
+    mergeability: not_mergeable
+    domain_flavors: ["ship"]
+    examples: ["IMO9553359"]
+    passive: true
+
+  - name: "mmsi"
+    type: string
+    description: "Maritime Mobile Service Identity of the vessel"
+    display_name: "MMSI"
+    mergeability: not_mergeable
+    domain_flavors: ["ship"]
+    passive: true
+
+  - name: "callsign"
+    type: string
+    description: "Radio call sign of the vessel"
+    display_name: "Call Sign"
+    mergeability: not_mergeable
+    domain_flavors: ["ship"]
+    passive: true
+
+  - name: "shipAndCargoType"
+    type: string
+    description: "Type classification of the vessel"
+    display_name: "Ship / Cargo Type"
+    mergeability: not_mergeable
+    domain_flavors: ["ship"]
+    examples: ["General cargo/multipurpose", "Oil tanker"]
+    passive: true
+
+  - name: "grossTonnage"
+    type: float
+    description: "Gross registered tonnage of the vessel"
+    display_name: "Gross Tonnage"
+    mergeability: not_mergeable
+    domain_flavors: ["ship"]
+    passive: true
+
+  # Aircraft properties
+  - name: "serial_number"
+    type: string
+    description: "Manufacturer serial number of the aircraft"
+    display_name: "Serial Number"
+    mergeability: not_mergeable
+    domain_flavors: ["aircraft"]
+    passive: true
+
+  - name: "tailNumber"
+    type: string
+    description: "Registration number (tail number) of the aircraft"
+    display_name: "Tail Number"
+    mergeability: not_mergeable
+    domain_flavors: ["aircraft"]
+    passive: true
+
+  - name: "model"
+    type: string
+    description: "Aircraft model"
+    display_name: "Model"
+    mergeability: not_mergeable
+    domain_flavors: ["aircraft"]
+    examples: ["Gulfstream 200", "Boeing 737"]
+    passive: true
+
+  # Security properties
+  - name: "isin"
+    type: string
+    description: "International Securities Identification Number (ISO 6166) uniquely identifying this financial instrument"
+    display_name: "ISIN"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "cusip_number"
+    type: string
+    description: "CUSIP identifier for the security"
+    display_name: "CUSIP Number"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "ticker"
+    type: string
+    description: "Primary stock ticker symbol"
+    display_name: "Ticker"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "currency"
+    type: string
+    description: "Currency denomination of the security or crypto wallet"
+    display_name: "Currency"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument", "crypto_wallet"]
+    passive: true
+
+  - name: "figi"
+    type: string
+    description: "Financial Instrument Global Identifier (Bloomberg OpenFIGI)"
+    display_name: "FIGI"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  # issuer is modeled as the instrument_issuer relationship (see relationships section)
+
+  # CryptoWallet properties
+  - name: "public_key"
+    type: string
+    description: "Blockchain public key or wallet address"
+    display_name: "Public Key"
+    mergeability: not_mergeable
+    domain_flavors: ["crypto_wallet"]
+    passive: true
+
+  # Document properties
+  - name: "document_number"
+    type: string
+    description: "Passport or identity document number"
+    display_name: "Document Number"
+    mergeability: not_mergeable
+    domain_flavors: ["identity_document"]
+    passive: true
+
+  - name: "document_country"
+    type: string
+    description: "Issuing country of the identity document"
+    display_name: "Document Country"
+    mergeability: not_mergeable
+    domain_flavors: ["identity_document"]
+    passive: true
+
+  # Article properties
+  - name: "title"
+    type: string
+    description: "Title of the entity"
+    display_name: "Title"
+    mergeability: not_mergeable
+    domain_flavors: ["article"]
+    passive: true
+
+  - name: "published_at"
+    type: string
+    description: "Publication date of the article"
+    display_name: "Published At"
+    mergeability: not_mergeable
+    domain_flavors: ["article"]
+    passive: true
+
+  # Sanction program properties
+  - name: "program_description"
+    type: string
+    description: "Description of the sanctions program and its legal basis"
+    display_name: "Program Description"
+    mergeability: not_mergeable
+    domain_flavors: ["sanction_program"]
+    passive: true
+
+  - name: "program_url"
+    type: string
+    description: "URL of the official sanctions program page"
+    display_name: "Program URL"
+    mergeability: not_mergeable
+    domain_flavors: ["sanction_program"]
+    passive: true
+
+  - name: "program_issuer"
+    type: string
+    description: "Government body or authority that administers the sanctions program"
+    display_name: "Program Issuer"
+    mergeability: not_mergeable
+    domain_flavors: ["sanction_program"]
+    passive: true
+
+  - name: "program_measures"
+    type: string
+    description: "Type of sanctions measures imposed by the program, one atom per measure"
+    display_name: "Program Measures"
+    mergeability: not_mergeable
+    domain_flavors: ["sanction_program"]
+    passive: true
+
 relationships:
   - name: "sanction_program"
     description: "Links a sanctioned entity to the sanctions program under which it is designated"
     display_name: "Sanction Program"
     mergeability: not_mergeable
-    domain_flavors: ["person", "organization"]
-    target_flavors: ["sanction_program"]
+    domain_flavors: ["person", "organization", "legal_entity", "ship", "aircraft", "financial_instrument", "crypto_wallet", "location", "physical_asset"]
+    target_flavors: ["sanction_program", "organization"]
+    passive: true
+
+  - name: "flag"
+    description: "Links a vessel to its flag state country"
+    display_name: "Flag"
+    mergeability: not_mergeable
+    domain_flavors: ["ship"]
+    target_flavors: ["location"]
     passive: true
 
   - name: "country"
     description: "Links a sanctioned organization to its associated country"
     display_name: "Country"
     mergeability: not_mergeable
-    domain_flavors: ["organization"]
-    target_flavors: ["country"]
+    domain_flavors: ["organization", "legal_entity", "ship", "financial_instrument", "physical_asset", "political_position"]
+    target_flavors: ["location"]
+    passive: true
+
+  - name: "owns"
+    description: "A person or organization owns or controls another organization or location (such as real estate)."
+    display_name: "Owns"
+    mergeability: not_mergeable
+    domain_flavors: ["person", "organization", "legal_entity"]
+    target_flavors: ["organization", "legal_entity", "ship", "aircraft", "financial_instrument", "crypto_wallet", "physical_asset", "location"]
+    passive: true
+
+  - name: "is_director"
+    description: "A person or entity is on the board of directors of an organization. Not to be used for heads of organizations."
+    display_name: "Is Director"
+    mergeability: not_mergeable
+    domain_flavors: ["person", "legal_entity", "organization"]
+    target_flavors: ["organization", "legal_entity"]
+    passive: true
+
+  - name: "holds_political_position"
+    description: "Links a politically exposed person to the position they hold"
+    display_name: "Holds Political Position"
+    mergeability: not_mergeable
+    domain_flavors: ["person", "legal_entity"]
+    target_flavors: ["political_position"]
+    passive: true
+
+  - name: "is_holder"
+    description: "Links a person to an identity document (passport, national ID)"
+    display_name: "Is Holder"
+    mergeability: not_mergeable
+    domain_flavors: ["person", "legal_entity"]
+    target_flavors: ["identity_document"]
+    passive: true
+
+  - name: "instrument_issuer"
+    description: "Links a financial instrument to the organization that issued it"
+    display_name: "Instrument Issuer"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    target_flavors: ["organization", "legal_entity"]
+    passive: true
+
+  - name: "appears_in"
+    description: "An entity or event appears in a source document"
+    display_name: "Appears In"
+    mergeability: not_mergeable
+    domain_flavors: ["person", "organization", "legal_entity"]
+    target_flavors: ["article"]
+    passive: true
+
+  - name: "family_member"
+    description: "Links a person to a family member (spouse, parent, child, sibling)"
+    display_name: "Family Member"
+    mergeability: not_mergeable
+    domain_flavors: ["person", "legal_entity"]
+    target_flavors: ["person", "legal_entity"]
+    passive: true
+
+  - name: "associated_with"
+    description: "A generic association between two entities, from UnknownLink or Associate schemas"
+    display_name: "Associated With"
+    mergeability: not_mergeable
+    domain_flavors: ["person", "organization", "legal_entity", "ship", "aircraft", "financial_instrument", "crypto_wallet", "physical_asset"]
+    target_flavors: ["person", "organization", "legal_entity", "ship", "aircraft", "financial_instrument", "crypto_wallet", "physical_asset"]
+    passive: true
+
+  - name: "succeeds"
+    description: "Links a successor entity to its predecessor (positions or organizations)"
+    display_name: "Succeeds"
+    mergeability: not_mergeable
+    domain_flavors: ["person", "organization", "legal_entity", "political_position"]
+    target_flavors: ["person", "organization", "legal_entity", "political_position"]
+    passive: true
+
+  - name: "represents"
+    description: "A person or entity legally or diplomatically represents another entity"
+    display_name: "Represents"
+    mergeability: not_mergeable
+    domain_flavors: ["person", "organization", "legal_entity"]
+    target_flavors: ["person", "organization", "legal_entity"]
+    passive: true
+
+  - name: "is_member"
+    description: "A person is a member of an organization"
+    display_name: "Is Member"
+    mergeability: not_mergeable
+    domain_flavors: ["person", "legal_entity"]
+    target_flavors: ["organization", "legal_entity"]
+    passive: true
+
+  - name: "employed_by"
+    description: "A person is employed by an organization"
+    display_name: "Employed By"
+    mergeability: not_mergeable
+    domain_flavors: ["person", "legal_entity"]
+    target_flavors: ["organization", "legal_entity"]
+    passive: true
+
+  - name: "paid"
+    description: "One entity made a payment to another"
+    display_name: "Paid"
+    mergeability: not_mergeable
+    domain_flavors: ["person", "organization", "legal_entity", "physical_asset"]
+    target_flavors: ["person", "organization", "legal_entity", "physical_asset"]
+    passive: true
+
+  - name: "owes_debt"
+    description: "One entity owes a debt to another"
+    display_name: "Owes Debt"
+    mergeability: not_mergeable
+    domain_flavors: ["person", "organization", "legal_entity", "physical_asset"]
+    target_flavors: ["person", "organization", "legal_entity", "physical_asset"]
+    passive: true
+
+attributes:
+  - property: "sanction_program"
+    name: "authority"
+    type: string
+    description: "Name of the sanctioning authority"
+    display_name: "Authority"
+    mergeability: not_mergeable
+    passive: true
+
+  - property: "sanction_program"
+    name: "reason"
+    type: string
+    description: "Reason(s) for the sanctions designation"
+    display_name: "Reason"
+    mergeability: not_mergeable
+    passive: true
+
+  - property: "sanction_program"
+    name: "listing_date"
+    type: string
+    description: "Date when the entity was listed under this program"
+    display_name: "Listing Date"
+    mergeability: not_mergeable
+    passive: true
+
+  - property: "sanction_program"
+    name: "start_date"
+    type: string
+    description: "Start date of the sanctions measures"
+    display_name: "Start Date"
+    mergeability: not_mergeable
+    passive: true
+
+  - property: "sanction_program"
+    name: "end_date"
+    type: string
+    description: "End date of the sanctions measures, if lifted"
+    display_name: "End Date"
+    mergeability: not_mergeable
+    passive: true
+
+  - property: "sanction_program"
+    name: "status"
+    type: string
+    description: "Current status of the designation"
+    display_name: "Status"
+    mergeability: not_mergeable
+    passive: true
+
+  - property: "sanction_program"
+    name: "provisions"
+    type: string
+    description: "Legal provisions under which the entity is designated"
+    display_name: "Provisions"
+    mergeability: not_mergeable
+    passive: true
+
+  - property: "sanction_program"
+    name: "summary"
+    type: string
+    description: "Summary of the sanctions designation"
+    display_name: "Summary"
+    mergeability: not_mergeable
+    passive: true
+
+  - property: "family_member"
+    name: "relationship_type"
+    type: string
+    description: "Type of family relationship (e.g. spouse, child, parent, sibling)"
+    display_name: "Relationship Type"
+    mergeability: not_mergeable
+    passive: true
+
+  - property: "associated_with"
+    name: "role"
+    type: string
+    description: "Role or nature of the association"
+    display_name: "Role"
+    mergeability: not_mergeable
+    passive: true
+
+  - property: "associated_with"
+    name: "relationship_type"
+    type: string
+    description: "Type of association (e.g. partner in business, significant person)"
+    display_name: "Relationship Type"
+    mergeability: not_mergeable
+    passive: true
+
+  - property: "represents"
+    name: "role"
+    type: string
+    description: "Nature of the representation (e.g. lawyer, diplomat)"
+    display_name: "Role"
+    mergeability: not_mergeable
+    passive: true
+
+  - property: "is_member"
+    name: "role"
+    type: string
+    description: "Role within the organization"
+    display_name: "Role"
+    mergeability: not_mergeable
+    passive: true
+
+  - property: "employed_by"
+    name: "role"
+    type: string
+    description: "Job title or role"
+    display_name: "Role"
+    mergeability: not_mergeable
+    passive: true
+
+  - property: "paid"
+    name: "summary"
+    type: string
+    description: "Description of the payment"
+    display_name: "Summary"
+    mergeability: not_mergeable
+    passive: true
+
+  - property: "owes_debt"
+    name: "summary"
+    type: string
+    description: "Description of the debt"
+    display_name: "Summary"
+    mergeability: not_mergeable
     passive: true