@yottagraph-app/data-model-skill 0.0.14 → 0.0.16

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yottagraph-app/data-model-skill",
-  "version": "0.0.14",
+  "version": "0.0.16",
   "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

@@ -126,6 +126,14 @@ flavors:
     strong_id_properties: ["accession_number"]
     passive: true
 
+  - name: "nport_p"
+    namespace: "sec"
+    description: "Monthly portfolio investments report (Form N-PORT) for a registered investment company"
+    display_name: "N-PORT"
+    mergeability: not_mergeable
+    strong_id_properties: ["accession_number"]
+    passive: true
+
   - name: "filing"
     namespace: "sec"
     description: "SEC filing (generic, for form types without a specific modeled flavor)"
@@ -145,7 +153,7 @@ flavors:
     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: "Financial Instrument"
     mergeability: not_mergeable
-    strong_id_properties: ["cusip_number"]
+    strong_id_properties: ["cusip_number", "holding_isin", "series_id", "series_lei", "nport_holding_id"]
     passive: true
 
   - name: "industry"
@@ -167,7 +175,7 @@ properties:
     description: "SEC Central Index Key, 10-digit zero-padded"
     display_name: "CIK"
     mergeability: not_mergeable
-    domain_flavors: ["organization", "sec::10_k", "sec::10_q", "sec::20_f", "sec::8_k", "sec::6_k", "sec::40_f", "sec::form_3", "sec::form_4", "sec::sc_13d", "sec::sc_13g", "sec::13f_hr", "sec::def_14a"]
+    domain_flavors: ["organization", "sec::10_k", "sec::10_q", "sec::20_f", "sec::8_k", "sec::6_k", "sec::40_f", "sec::form_3", "sec::form_4", "sec::sc_13d", "sec::sc_13g", "sec::13f_hr", "sec::def_14a", "sec::nport_p"]
     passive: true
 
   - name: "ticker"
@@ -589,7 +597,7 @@ properties:
     description: "SEC accession number uniquely identifying a filing"
     display_name: "Accession Number"
     mergeability: not_mergeable
-    domain_flavors: ["sec::10_k", "sec::10_q", "sec::20_f", "sec::8_k", "sec::6_k", "sec::40_f", "sec::form_3", "sec::form_4", "sec::sc_13d", "sec::sc_13g", "sec::13f_hr", "sec::def_14a", "sec::filing"]
+    domain_flavors: ["sec::10_k", "sec::10_q", "sec::20_f", "sec::8_k", "sec::6_k", "sec::40_f", "sec::form_3", "sec::form_4", "sec::sc_13d", "sec::sc_13g", "sec::13f_hr", "sec::def_14a", "sec::nport_p", "sec::filing"]
     passive: true
 
   - name: "form_type"
@@ -597,7 +605,7 @@ properties:
     description: "Normalized SEC form type (e.g. 10-K, SC 13D, 4)"
     display_name: "Form Type"
     mergeability: not_mergeable
-    domain_flavors: ["sec::10_k", "sec::10_q", "sec::20_f", "sec::8_k", "sec::6_k", "sec::40_f", "sec::form_3", "sec::form_4", "sec::sc_13d", "sec::sc_13g", "sec::13f_hr", "sec::def_14a", "sec::filing"]
+    domain_flavors: ["sec::10_k", "sec::10_q", "sec::20_f", "sec::8_k", "sec::6_k", "sec::40_f", "sec::form_3", "sec::form_4", "sec::sc_13d", "sec::sc_13g", "sec::13f_hr", "sec::def_14a", "sec::nport_p", "sec::filing"]
     passive: true
 
   - name: "filing_date"
@@ -605,7 +613,7 @@ properties:
     description: "Date the filing was submitted to the SEC (YYYY-MM-DD)"
     display_name: "Filing Date"
     mergeability: not_mergeable
-    domain_flavors: ["sec::10_k", "sec::10_q", "sec::20_f", "sec::8_k", "sec::6_k", "sec::40_f", "sec::form_3", "sec::form_4", "sec::sc_13d", "sec::sc_13g", "sec::13f_hr", "sec::def_14a", "sec::filing"]
+    domain_flavors: ["sec::10_k", "sec::10_q", "sec::20_f", "sec::8_k", "sec::6_k", "sec::40_f", "sec::form_3", "sec::form_4", "sec::sc_13d", "sec::sc_13g", "sec::13f_hr", "sec::def_14a", "sec::nport_p", "sec::filing"]
     passive: true
 
   - name: "report_date"
@@ -613,7 +621,7 @@ properties:
     description: "End date of the primary reporting period (YYYY-MM-DD)"
     display_name: "Report Date"
     mergeability: not_mergeable
-    domain_flavors: ["sec::10_k", "sec::10_q", "sec::20_f", "sec::8_k", "sec::6_k", "sec::40_f", "sec::form_3", "sec::form_4", "sec::sc_13d", "sec::sc_13g", "sec::13f_hr", "sec::def_14a", "sec::filing"]
+    domain_flavors: ["sec::10_k", "sec::10_q", "sec::20_f", "sec::8_k", "sec::6_k", "sec::40_f", "sec::form_3", "sec::form_4", "sec::sc_13d", "sec::sc_13g", "sec::13f_hr", "sec::def_14a", "sec::nport_p", "sec::filing"]
     passive: true
 
   # ── XBRL Financial Facts (key concepts) ──
@@ -647,7 +655,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 +663,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 +807,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 +823,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 +831,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 +1075,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"
@@ -1550,10 +1558,10 @@ properties:
 
   - name: "report_period_date"
     type: string
-    description: "Quarter-end date for the 13F-HR report period"
+    description: "End date for the report period (e.g. quarter-end for 13F-HR, month-end for N-PORT)"
     display_name: "Report Period Date"
     mergeability: not_mergeable
-    domain_flavors: ["sec::13f_hr"]
+    domain_flavors: ["sec::13f_hr", "sec::nport_p"]
     passive: true
 
   - name: "confidential_treatment_flag"
@@ -1724,6 +1732,307 @@ properties:
     domain_flavors: ["organization", "financial_instrument"]
     passive: true
 
+  # ── Financial Instrument: N-PORT Fund Identity ──
+
+  - name: "series_id"
+    type: string
+    description: "SEC series identifier for a registered investment company fund"
+    display_name: "Series ID"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    examples: ["S000002859", "S000001671"]
+    passive: true
+
+  - name: "series_name"
+    type: string
+    description: "Fund series name as registered with the SEC"
+    display_name: "Series Name"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "series_lei"
+    type: string
+    description: "LEI of the fund series (if assigned)"
+    display_name: "Series LEI"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "lei"
+    type: string
+    description: "Legal Entity Identifier (ISO 17442) — 20-character alphanumeric code for cross-border entity resolution"
+    display_name: "LEI"
+    mergeability: not_mergeable
+    domain_flavors: ["organization"]
+    passive: true
+
+  # ── Financial Instrument: N-PORT Fund Financials ──
+
+  - name: "fund_total_assets"
+    type: float
+    description: "Total assets of the fund (USD)"
+    display_name: "Total Assets"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "fund_total_liabilities"
+    type: float
+    description: "Total liabilities of the fund (USD)"
+    display_name: "Total Liabilities"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "fund_net_assets"
+    type: float
+    description: "Net assets of the fund (USD)"
+    display_name: "Net Assets"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "fund_cash_not_reported"
+    type: float
+    description: "Cash and cash equivalents not reported in portfolio holdings (USD)"
+    display_name: "Cash Not Reported"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  # ── Financial Instrument: N-PORT Monthly Returns ──
+
+  - name: "monthly_return_1"
+    type: float
+    description: "Monthly total return for the first month of the reporting period"
+    display_name: "Monthly Return (M1)"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "monthly_return_2"
+    type: float
+    description: "Monthly total return for the second month of the reporting period"
+    display_name: "Monthly Return (M2)"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "monthly_return_3"
+    type: float
+    description: "Monthly total return for the third month of the reporting period"
+    display_name: "Monthly Return (M3)"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  # ── Financial Instrument: N-PORT Monthly Flows ──
+
+  - name: "monthly_flow_sales_1"
+    type: float
+    description: "Sales (creations) for month 1 of the reporting period (USD)"
+    display_name: "Flow Sales (M1)"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "monthly_flow_sales_2"
+    type: float
+    description: "Sales (creations) for month 2 of the reporting period (USD)"
+    display_name: "Flow Sales (M2)"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "monthly_flow_sales_3"
+    type: float
+    description: "Sales (creations) for month 3 of the reporting period (USD)"
+    display_name: "Flow Sales (M3)"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "monthly_flow_redemptions_1"
+    type: float
+    description: "Redemptions for month 1 of the reporting period (USD)"
+    display_name: "Flow Redemptions (M1)"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "monthly_flow_redemptions_2"
+    type: float
+    description: "Redemptions for month 2 of the reporting period (USD)"
+    display_name: "Flow Redemptions (M2)"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "monthly_flow_redemptions_3"
+    type: float
+    description: "Redemptions for month 3 of the reporting period (USD)"
+    display_name: "Flow Redemptions (M3)"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "monthly_flow_reinvestment_1"
+    type: float
+    description: "Reinvestment for month 1 of the reporting period (USD)"
+    display_name: "Flow Reinvestment (M1)"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "monthly_flow_reinvestment_2"
+    type: float
+    description: "Reinvestment for month 2 of the reporting period (USD)"
+    display_name: "Flow Reinvestment (M2)"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "monthly_flow_reinvestment_3"
+    type: float
+    description: "Reinvestment for month 3 of the reporting period (USD)"
+    display_name: "Flow Reinvestment (M3)"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  # ── Financial Instrument: N-PORT Holding Detail ──
+
+  - name: "nport_holding_id"
+    type: string
+    description: "Synthetic strong ID for N-PORT holdings that lack a CUSIP or ISIN (accession::index::name composite)"
+    display_name: "N-PORT Holding ID"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "holding_isin"
+    type: string
+    description: "ISIN identifier for the security"
+    display_name: "ISIN"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "holding_lei"
+    type: string
+    description: "LEI of the security issuer"
+    display_name: "Holding LEI"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "holding_ticker"
+    type: string
+    description: "Ticker symbol for the security"
+    display_name: "Ticker"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "holding_title"
+    type: string
+    description: "Title of the security class"
+    display_name: "Security Title"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "holding_asset_category"
+    type: string
+    description: "SEC asset category code: EC (equity common), EP (equity preferred), DB (debt), DE (derivative), etc."
+    display_name: "Asset Category"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "holding_issuer_category"
+    type: string
+    description: "Issuer category: CORP, UST, USGA, MUN, SOVN, FN, etc."
+    display_name: "Issuer Category"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "holding_country"
+    type: string
+    description: "Country of investment (ISO 3166-1 alpha-2)"
+    display_name: "Country"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "fair_value_level"
+    type: string
+    description: "Fair value hierarchy level: 1 (quoted prices), 2 (observable inputs), 3 (unobservable inputs)"
+    display_name: "Fair Value Level"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "is_restricted_security"
+    type: string
+    description: "Whether the security is restricted: Y or N"
+    display_name: "Restricted"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  # ── Financial Instrument: Debt Security Detail ──
+
+  - name: "debt_maturity_date"
+    type: string
+    description: "Maturity date of the debt instrument"
+    display_name: "Maturity Date"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "debt_coupon_kind"
+    type: string
+    description: "Coupon type: Fixed, Floating, Variable, None, Other"
+    display_name: "Coupon Kind"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "debt_annualized_rate"
+    type: float
+    description: "Annualized coupon rate of the debt instrument"
+    display_name: "Annualized Rate"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "debt_is_default"
+    type: string
+    description: "Whether the debt instrument is in default: Y or N"
+    display_name: "In Default"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "debt_interest_in_arrears"
+    type: string
+    description: "Whether interest payments are in arrears: Y or N"
+    display_name: "Interest in Arrears"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "debt_paid_in_kind"
+    type: string
+    description: "Whether interest is paid in kind: Y or N"
+    display_name: "Paid in Kind"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
 # =============================================================================
 # RELATIONSHIPS
 # =============================================================================
@@ -1735,8 +2044,8 @@ relationships:
     description: "Link from a company or person to an SEC filing document they filed, or from a sub-record (event, transaction, holding) to its parent filing"
     display_name: "Filed"
     mergeability: not_mergeable
-    domain_flavors: ["organization", "person", "sec::10_k", "sec::10_q", "sec::20_f", "sec::8_k", "sec::6_k", "sec::40_f", "sec::form_3", "sec::form_4", "sec::sc_13d", "sec::sc_13g", "sec::13f_hr", "sec::def_14a", "sec::filing"]
-    target_flavors: ["sec::10_k", "sec::10_q", "sec::20_f", "sec::8_k", "sec::6_k", "sec::40_f", "sec::form_3", "sec::form_4", "sec::sc_13d", "sec::sc_13g", "sec::13f_hr", "sec::def_14a", "sec::filing"]
+    domain_flavors: ["organization", "person", "sec::10_k", "sec::10_q", "sec::20_f", "sec::8_k", "sec::6_k", "sec::40_f", "sec::form_3", "sec::form_4", "sec::sc_13d", "sec::sc_13g", "sec::13f_hr", "sec::def_14a", "sec::nport_p", "sec::filing"]
+    target_flavors: ["sec::10_k", "sec::10_q", "sec::20_f", "sec::8_k", "sec::6_k", "sec::40_f", "sec::form_3", "sec::form_4", "sec::sc_13d", "sec::sc_13g", "sec::13f_hr", "sec::def_14a", "sec::nport_p", "sec::filing"]
     passive: true
 
   - name: "is_issuer_of"
@@ -1752,7 +2061,7 @@ relationships:
     display_name: "Filing Reference"
     mergeability: not_mergeable
     domain_flavors: ["organization", "person", "financial_instrument"]
-    target_flavors: ["sec::10_k", "sec::10_q", "sec::20_f", "sec::8_k", "sec::6_k", "sec::40_f", "sec::form_3", "sec::form_4", "sec::sc_13d", "sec::sc_13g", "sec::13f_hr", "sec::def_14a"]
+    target_flavors: ["sec::10_k", "sec::10_q", "sec::20_f", "sec::8_k", "sec::6_k", "sec::40_f", "sec::form_3", "sec::form_4", "sec::sc_13d", "sec::sc_13g", "sec::13f_hr", "sec::def_14a", "sec::nport_p"]
     passive: true
 
   # ── Filing → Organization ──
@@ -1761,7 +2070,7 @@ relationships:
     description: "Link from a filing or financial instrument to the company it pertains to (the filer for most forms; the issuer for ownership forms and 13F holdings)"
     display_name: "Issued By"
     mergeability: not_mergeable
-    domain_flavors: ["sec::10_k", "sec::10_q", "sec::20_f", "sec::8_k", "sec::6_k", "sec::40_f", "sec::form_3", "sec::form_4", "sec::sc_13d", "sec::sc_13g", "sec::13f_hr", "sec::def_14a", "sec::filing", "financial_instrument"]
+    domain_flavors: ["sec::10_k", "sec::10_q", "sec::20_f", "sec::8_k", "sec::6_k", "sec::40_f", "sec::form_3", "sec::form_4", "sec::sc_13d", "sec::sc_13g", "sec::13f_hr", "sec::def_14a", "sec::nport_p", "sec::filing", "financial_instrument"]
     target_flavors: ["organization"]
     passive: true
 
@@ -1777,7 +2086,7 @@ relationships:
     description: "Link from a filing to the entity (person or organization) who filed it"
     display_name: "Filer"
     mergeability: not_mergeable
-    domain_flavors: ["sec::10_k", "sec::10_q", "sec::20_f", "sec::8_k", "sec::6_k", "sec::40_f", "sec::form_3", "sec::form_4", "sec::sc_13d", "sec::sc_13g", "sec::13f_hr", "sec::def_14a", "sec::filing"]
+    domain_flavors: ["sec::10_k", "sec::10_q", "sec::20_f", "sec::8_k", "sec::6_k", "sec::40_f", "sec::form_3", "sec::form_4", "sec::sc_13d", "sec::sc_13g", "sec::13f_hr", "sec::def_14a", "sec::nport_p", "sec::filing"]
     target_flavors: ["organization", "person"]
     passive: true
 
@@ -1870,13 +2179,21 @@ relationships:
   # ── Organization → Financial Instrument (issuer link) ──
 
   - name: "issues_security"
-    description: "Link from an issuing company to a financial instrument it has issued, identified by CUSIP (SC 13D/G)"
+    description: "Link from an issuing company to a financial instrument it has issued or manages"
     display_name: "Issues Security"
     mergeability: not_mergeable
     domain_flavors: ["organization"]
     target_flavors: ["financial_instrument"]
     passive: true
 
+  - name: "lends_securities_to"
+    description: "Link from a fund to an organization that borrows securities from it (N-PORT securities lending)"
+    display_name: "Lends Securities To"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    target_flavors: ["organization"]
+    passive: true
+
 # =============================================================================
 # ATTRIBUTES
 # =============================================================================
@@ -1982,3 +2299,126 @@ attributes:
     description: "Shares with no voting authority"
     display_name: "Voting Authority (None)"
     mergeability: not_mergeable
+
+  # ── holds_position relationship attributes (N-PORT) ──
+
+  - property: "holds_position"
+    name: "holding_pct_of_nav"
+    type: string
+    description: "Position value as percentage of fund net asset value"
+    display_name: "% of NAV"
+    mergeability: not_mergeable
+
+  - property: "holds_position"
+    name: "holding_units"
+    type: string
+    description: "Unit type: NS (number of shares), PA (principal amount), NC (number of contracts)"
+    display_name: "Units"
+    mergeability: not_mergeable
+
+  - property: "holds_position"
+    name: "holding_currency"
+    type: string
+    description: "Currency of the position (ISO 4217)"
+    display_name: "Currency"
+    mergeability: not_mergeable
+
+  - property: "holds_position"
+    name: "payoff_profile"
+    type: string
+    description: "Payoff profile: Long, Short, or N/A"
+    display_name: "Payoff Profile"
+    mergeability: not_mergeable
+
+  - property: "holds_position"
+    name: "is_on_loan"
+    type: string
+    description: "Whether the security is currently on loan by this fund: Y or N"
+    display_name: "On Loan"
+    mergeability: not_mergeable
+
+  - property: "holds_position"
+    name: "derivative_category"
+    type: string
+    description: "Derivative type: SWP (swap), FUT (future), OPT (option), FWD (forward)"
+    display_name: "Derivative Type"
+    mergeability: not_mergeable
+
+  - property: "holds_position"
+    name: "counterparty_name"
+    type: string
+    description: "Name of the derivative counterparty or exchange"
+    display_name: "Counterparty"
+    mergeability: not_mergeable
+
+  - property: "holds_position"
+    name: "counterparty_lei"
+    type: string
+    description: "LEI of the derivative counterparty"
+    display_name: "Counterparty LEI"
+    mergeability: not_mergeable
+
+  - property: "holds_position"
+    name: "derivative_notional"
+    type: string
+    description: "Notional amount of the derivative contract"
+    display_name: "Notional Amount"
+    mergeability: not_mergeable
+
+  - property: "holds_position"
+    name: "derivative_expiration"
+    type: string
+    description: "Expiration or termination date of the derivative contract"
+    display_name: "Expiration"
+    mergeability: not_mergeable
+
+  - property: "holds_position"
+    name: "derivative_unrealized"
+    type: string
+    description: "Unrealized appreciation or depreciation on the derivative (USD)"
+    display_name: "Unrealized Gain/Loss"
+    mergeability: not_mergeable
+
+  - property: "holds_position"
+    name: "option_put_or_call"
+    type: string
+    description: "Whether the option is a Put or Call"
+    display_name: "Put/Call"
+    mergeability: not_mergeable
+
+  - property: "holds_position"
+    name: "option_written_or_purchased"
+    type: string
+    description: "Whether the option was Written (sold) or Purchased (bought)"
+    display_name: "Written/Purchased"
+    mergeability: not_mergeable
+
+  - property: "holds_position"
+    name: "option_strike_price"
+    type: string
+    description: "Strike price of the option contract"
+    display_name: "Strike Price"
+    mergeability: not_mergeable
+
+  - property: "holds_position"
+    name: "option_delta"
+    type: string
+    description: "Option delta (sensitivity to underlying price)"
+    display_name: "Delta"
+    mergeability: not_mergeable
+
+  - property: "holds_position"
+    name: "cash_collateral_value"
+    type: string
+    description: "Cash collateral value for securities on loan (USD)"
+    display_name: "Collateral Value"
+    mergeability: not_mergeable
+
+  # ── lends_securities_to relationship attributes (N-PORT) ──
+
+  - property: "lends_securities_to"
+    name: "aggregate_lending_value"
+    type: string
+    description: "Aggregate value of securities lent to this borrower (USD)"
+    display_name: "Lending Value"
+    mergeability: not_mergeable