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

package/package.json

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

package/skill/edgar/schema.yaml

@@ -27,7 +27,14 @@ flavors:
     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: ["company_cik"]
+    # lei, crd_number, sec_file_number, and pcaob_number let us merge N-CEN
+    # service providers (custodians, investment advisers, transfer agents,
+    # auditors, etc.) across filings even when the SEC doesn't assign them a
+    # CIK. pcaob_number is auditor-specific and is the canonical fallback for
+    # PCAOB-registered audit firms whose filer didn't supply an LEI. crd_number
+    # carries the firm-level FINRA CRD here; the same property on person
+    # carries the individual CRD — the flavor scopes the namespace.
+    strong_id_properties: ["company_cik", "lei", "pcaob_number", "crd_number", "sec_file_number"]
     passive: true
 
   - name: "10_k"
@@ -126,6 +133,30 @@ 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: "ncen"
+    namespace: "sec"
+    description: "Annual report (Form N-CEN) for a registered investment company capturing fund structure, service providers, and operational data"
+    display_name: "N-CEN"
+    mergeability: not_mergeable
+    strong_id_properties: ["accession_number"]
+    passive: true
+
+  - name: "valuation_method_change"
+    namespace: "sec"
+    description: "A material change to fund valuation methodology disclosed under N-CEN Item B.20. Each entity records one valuationMethodsChange record (date, asset type, regulatory basis, free-text explanation) and links to the disclosing N-CEN filing plus any per-series fund(s) affected."
+    display_name: "Valuation Method Change"
+    mergeability: not_mergeable
+    strong_id_properties: ["valuation_change_id"]
+    passive: true
+
   - name: "filing"
     namespace: "sec"
     description: "SEC filing (generic, for form types without a specific modeled flavor)"
@@ -138,14 +169,20 @@ 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: ["person_cik"]
+    # crd_number is FINRA's individual Central Registration Depository
+    # identifier, disclosed for fund directors and chief compliance officers
+    # on N-CEN. Adding it as a strong ID lets the same person merge across
+    # all the registrants (and historical filings) where they're disclosed.
+    # The same crd_number property exists on organization (for firm-level
+    # CRDs) — flavor scoping prevents cross-namespace collisions.
+    strong_id_properties: ["person_cik", "crd_number"]
     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: "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 +204,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", "sec::ncen"]
     passive: true
 
   - name: "ticker"
@@ -589,7 +626,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::ncen", "sec::filing"]
     passive: true
 
   - name: "form_type"
@@ -597,7 +634,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::ncen", "sec::filing"]
     passive: true
 
   - name: "filing_date"
@@ -605,7 +642,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::ncen", "sec::filing"]
     passive: true
 
   - name: "report_date"
@@ -613,7 +650,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::ncen", "sec::filing"]
     passive: true
 
   # ── XBRL Financial Facts (key concepts) ──
@@ -1550,10 +1587,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, fiscal year-end for N-CEN)"
     display_name: "Report Period Date"
     mergeability: not_mergeable
-    domain_flavors: ["sec::13f_hr"]
+    domain_flavors: ["sec::13f_hr", "sec::nport_p", "sec::ncen"]
     passive: true
 
   - name: "confidential_treatment_flag"
@@ -1724,6 +1761,609 @@ 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
+
+  # ── Organization: N-CEN Service Provider Identifiers ──
+  # These are strong IDs on organization (see flavor definition above) so
+  # N-CEN service providers (advisers, transfer agents) merge across filings
+  # even when the SEC hasn't assigned them a CIK.
+
+  - name: "sec_file_number"
+    type: string
+    description: "SEC file number — registrant identifier assigned by the SEC (e.g. 801-XXXXX for advisers, 084-XXXXX for transfer agents, 811-XXXXX for investment-company / fund issuers)"
+    display_name: "SEC File Number"
+    mergeability: not_mergeable
+    domain_flavors: ["organization", "financial_instrument"]
+    passive: true
+
+  - name: "pcaob_number"
+    type: string
+    description: "PCAOB firm ID — the Public Company Accounting Oversight Board's registration number for an audit firm. Mandatory for any auditor of an SEC-registered fund and stable across filings, so it serves as the canonical fallback identifier when a filer doesn't supply the auditor's LEI on N-CEN Item C.7."
+    display_name: "PCAOB Number"
+    mergeability: not_mergeable
+    domain_flavors: ["organization"]
+    passive: true
+
+  # ── N-CEN Filing Metadata ──
+
+  # SEC investment-company classification under the Investment Company
+  # Act of 1940. A durable registrant trait — an adviser complex is
+  # permanently N-1A (open-end), N-2 (closed-end), N-3/N-4 (variable
+  # insurance), N-6 (variable life), etc., barring rare re-organisation.
+  # Lives on the organization for cross-filing querying ("which
+  # registrants are N-1A?") and on the sec::ncen filing that disclosed
+  # it for per-filing provenance. Populated from N-CEN today; any
+  # future form carrying the same classification can emit it.
+  - name: "investment_company_type"
+    type: string
+    description: "SEC investment-company classification under the Investment Company Act of 1940 (e.g. N-1A open-end, N-2 closed-end, N-3/N-4 variable insurance, N-6 variable life). A durable registrant attribute."
+    display_name: "Investment Company Type"
+    mergeability: not_mergeable
+    domain_flavors: ["organization", "sec::ncen"]
+    passive: true
+
+  # Filing-preparer contact. Every SEC submission carries a CONTACT_TYPE
+  # block in the SGML/XML header naming the person SEC should reach about
+  # the submission — typically inside counsel or a fund-admin paralegal,
+  # distinct from the registrant. Flattened into a single comma-joined
+  # "name, email, phone" string because the contact has no stable
+  # identifier across filings (no CIK, no CRD) and no downstream queries
+  # branch on the individual fields. Empty pieces are omitted from the
+  # join. Lives on the filing rather than the registrant org (which has
+  # its own business_phone). Currently populated only by the N-CEN
+  # handler; the full SEC filings domain is declared so other form
+  # handlers can lift the same CONTACT_TYPE block without schema changes.
+  - name: "contact"
+    type: string
+    description: "Filing-preparer contact from the SEC submission CONTACT_TYPE header, formatted as 'Name, email, phone' (e.g. 'Jane Doe, jane@filer.com, 412-444-4444'); empty pieces are omitted. Distinct from the registrant — typically inside counsel or fund-admin staff."
+    display_name: "Contact"
+    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::nport_p", "sec::ncen", "sec::filing"]
+    passive: true
+
+  # N-CEN Item B.* signals. Each property attaches to its single natural
+  # home: durable registrant attributes (fund_family_name) live on the
+  # organization; per-filing lifecycle facts and per-period event flags
+  # (is_first/last_filing, is_material_weakness, is_public_accountant_
+  # changed, is_accounting_principle_change, had_nav_error,
+  # had_dividend_error) live on the sec::ncen filing. Putting per-period
+  # facts on the org would accumulate conflicting Y/N atoms across years
+  # (a fund that had a material weakness in 2018 but not 2019-2025 isn't
+  # permanently a "material weakness" org). To answer "did this fund
+  # ever..." or "what's its current state", join through the filer edge
+  # to the most recent or all sec::ncen filings. Material valuation
+  # method changes (Item B.20) are intentionally modelled only as the
+  # sec::valuation_method_change sub-record flavor — no rollup boolean
+  # on the filing or fund — since the per-change detail (date, asset
+  # type, regulatory basis, free-text explanation) is the meaningful
+  # signal and "did it happen?" is recoverable by existence check on
+  # the sub-records' disclosed_in / affects_series edges.
+  - name: "fund_family_name"
+    type: string
+    description: "Name of the fund family (registrantFamilyInvComp) the registrant belongs to per N-CEN — useful for grouping registrants that share advisers, distributors, and boards (e.g. 'Vanguard', 'BlackRock')."
+    display_name: "Fund Family"
+    mergeability: not_mergeable
+    domain_flavors: ["organization"]
+    passive: true
+
+  # Filing position on the registrant's N-CEN lifecycle. One enum
+  # rather than two independent booleans because a filing is in exactly
+  # one of three positions: first submission (fund launch), last
+  # submission (wind-down), or ongoing. "last" wins when both B.2 and
+  # B.3 are Y on the same filing (rare same-year launch-and-terminate).
+  - name: "filing_lifecycle_position"
+    type: string
+    description: "N-CEN filing's position on the registrant's lifecycle per Items B.2 / B.3. One of: 'first' (fund launch, B.2=Y), 'last' (fund wind-down, B.3=Y), 'ongoing' (neither). 'last' takes precedence if both B.2 and B.3 are Y."
+    display_name: "Filing Lifecycle Position"
+    mergeability: not_mergeable
+    domain_flavors: ["sec::ncen"]
+    passive: true
+
+  - name: "is_material_weakness"
+    type: string
+    description: "Whether the auditor reported a material weakness in internal control (Y or N) per N-CEN Item B.6"
+    display_name: "Material Weakness"
+    mergeability: not_mergeable
+    domain_flavors: ["sec::ncen"]
+    passive: true
+
+  - name: "is_public_accountant_changed"
+    type: string
+    description: "Whether the registrant's public accountant changed during the period (Y or N) per N-CEN Item B.5 — auditor turnover signal"
+    display_name: "Public Accountant Changed"
+    mergeability: not_mergeable
+    domain_flavors: ["sec::ncen"]
+    passive: true
+
+  - name: "is_accounting_principle_change"
+    type: string
+    description: "Whether the registrant changed accounting principles during the period (Y or N) per N-CEN Item B.7"
+    display_name: "Accounting Principle Change"
+    mergeability: not_mergeable
+    domain_flavors: ["sec::ncen"]
+    passive: true
+
+  # NAV- and dividend-error flags live on both the sec::ncen filing
+  # (registrant-wide "did any series have an error?") and on each
+  # affected financial_instrument series. Same concept, two
+  # granularities, so one property per concept with dual flavors.
+  # Registrant-level emission is Y or N (B.22 / B.23 is always
+  # answered); per-series emission is Y-only (absence reads as "this
+  # series was not listed as affected").
+  - name: "had_nav_error"
+    type: string
+    description: "Whether a NAV calculation error occurred during the N-CEN reporting period per Item B.22. On the sec::ncen filing, Y/N registrant-wide. On a financial_instrument, Y when that series appeared in the B.22.a.i affected-series list (absence means not disclosed as affected)."
+    display_name: "Had NAV Error"
+    mergeability: not_mergeable
+    domain_flavors: ["sec::ncen", "financial_instrument"]
+    passive: true
+
+  - name: "had_dividend_error"
+    type: string
+    description: "Whether a dividend or distribution payment error occurred during the N-CEN reporting period per Item B.23. On the sec::ncen filing, Y/N registrant-wide. On a financial_instrument, Y when that series appeared in the B.23.a.i affected-series list (absence means not disclosed as affected)."
+    display_name: "Had Dividend Error"
+    mergeability: not_mergeable
+    domain_flavors: ["sec::ncen", "financial_instrument"]
+    passive: true
+
+  # FINRA Central Registration Depository identifier — applied to both
+  # firms (an investment-adviser, principal underwriter, sub-adviser
+  # disclosed on an N-CEN service-provider list) and individuals (fund
+  # directors and chief compliance officers). Flavor scopes the
+  # namespace, so the same numeric value on an org and a person resolves
+  # to two distinct entities (FINRA does maintain separate firm vs.
+  # individual registries, but flavor scoping is the durable safeguard).
+  - name: "crd_number"
+    type: string
+    description: "FINRA Central Registration Depository identifier. On organization entities the firm-level CRD (e.g. investment-adviser firms, principal underwriters); on person entities the individual CRD (e.g. fund directors, chief compliance officers). The flavor disambiguates the namespace."
+    display_name: "CRD Number"
+    mergeability: not_mergeable
+    domain_flavors: ["organization", "person"]
+    passive: true
+
+  # Valuation method change entity properties (N-CEN Item B.20).
+  - name: "valuation_change_id"
+    type: string
+    description: "Synthetic strong ID for an N-CEN valuation method change record (accession_number::index)"
+    display_name: "Valuation Change ID"
+    mergeability: not_mergeable
+    domain_flavors: ["sec::valuation_method_change"]
+    passive: true
+
+  # Scoped field names — "change_date"/"change_explanation" would be
+  # magnets for future collisions with other change-event sub-records
+  # (auditor change, name change, fiscal-year change, …). Keeping the
+  # valuation_ prefix means each future sub-record can coin its own
+  # scoped pair (auditor_change_date, …) without re-writing history.
+  - name: "valuation_change_date"
+    type: string
+    description: "Date the valuation methodology change took effect (YYYY-MM-DD) per N-CEN Item B.20"
+    display_name: "Valuation Change Date"
+    mergeability: not_mergeable
+    domain_flavors: ["sec::valuation_method_change"]
+    passive: true
+
+  - name: "valuation_change_explanation"
+    type: string
+    description: "Free-text explanation of the valuation methodology change per N-CEN Item B.20"
+    display_name: "Valuation Change Explanation"
+    mergeability: not_mergeable
+    domain_flavors: ["sec::valuation_method_change"]
+    passive: true
+
+  - name: "affected_asset_type"
+    type: string
+    description: "Asset category whose valuation methodology changed (N-CEN ASSET_TYPE enum: equity, debt, derivative, etc.)"
+    display_name: "Affected Asset Type"
+    mergeability: not_mergeable
+    domain_flavors: ["sec::valuation_method_change"]
+    passive: true
+
+  - name: "affected_investment_type"
+    type: string
+    description: "Free-text sub-classification of investments affected by the valuation methodology change per N-CEN"
+    display_name: "Affected Investment Type"
+    mergeability: not_mergeable
+    domain_flavors: ["sec::valuation_method_change"]
+    passive: true
+
+  - name: "regulatory_basis"
+    type: string
+    description: "Statutory or regulatory basis cited for the valuation methodology change per N-CEN (e.g. 'Rule 2a-5 fair value designee determination')"
+    display_name: "Regulatory Basis"
+    mergeability: not_mergeable
+    domain_flavors: ["sec::valuation_method_change"]
+    passive: true
+
+  # ── Financial Instrument: N-CEN Fund Operational Data ──
+
+  - name: "is_fund_of_funds"
+    type: string
+    description: "Whether the fund is a fund-of-funds (Y or N) per N-CEN"
+    display_name: "Fund of Funds"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "is_etf"
+    type: string
+    description: "Whether the fund is an exchange-traded fund (Y or N) per N-CEN"
+    display_name: "ETF"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "securities_lending_enabled"
+    type: string
+    description: "Whether the fund engages in securities lending (Y or N) per N-CEN"
+    display_name: "Securities Lending Enabled"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "avg_portfolio_securities_value"
+    type: float
+    description: "Average value of portfolio securities on loan during the reporting period (USD) per N-CEN"
+    display_name: "Avg Portfolio Securities Value"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "net_income_securities_lending"
+    type: float
+    description: "Net income from securities lending during the reporting period (USD) per N-CEN"
+    display_name: "Net Income (Securities Lending)"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "avg_net_assets_monthly"
+    type: float
+    description: "Average net assets of the fund computed monthly during the reporting period (USD) per N-CEN Item C.19"
+    display_name: "Avg Net Assets (Monthly)"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "avg_net_assets_daily"
+    type: float
+    description: "Average net assets of the fund computed daily during the reporting period (USD) per N-CEN Item C.19"
+    display_name: "Avg Net Assets (Daily)"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "index_tracking_diff_pre_fees"
+    type: float
+    description: "Index fund tracking difference vs. benchmark before fees and expenses (per N-CEN indexFundInfo)"
+    display_name: "Index Tracking Diff (Pre-Fees)"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "index_tracking_diff_post_fees"
+    type: float
+    description: "Index fund tracking difference vs. benchmark after fees and expenses (per N-CEN indexFundInfo)"
+    display_name: "Index Tracking Diff (Post-Fees)"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "index_tracking_stdev_pre_fees"
+    type: float
+    description: "Daily standard deviation of index fund tracking difference before fees and expenses (per N-CEN indexFundInfo)"
+    display_name: "Index Tracking Stdev (Pre-Fees)"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "index_tracking_stdev_post_fees"
+    type: float
+    description: "Daily standard deviation of index fund tracking difference after fees and expenses (per N-CEN indexFundInfo)"
+    display_name: "Index Tracking Stdev (Post-Fees)"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    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 +2375,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::ncen", "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::ncen", "sec::filing"]
     passive: true
 
   - name: "is_issuer_of"
@@ -1752,7 +2392,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", "sec::ncen"]
     passive: true
 
   # ── Filing → Organization ──
@@ -1761,7 +2401,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::ncen", "sec::filing", "financial_instrument"]
     target_flavors: ["organization"]
     passive: true
 
@@ -1777,7 +2417,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::ncen", "sec::filing"]
     target_flavors: ["organization", "person"]
     passive: true
 
@@ -1870,13 +2510,137 @@ 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
+
+  # ── N-CEN Service Provider Relationships ──
+  # N-CEN filings disclose a registrant's service providers (auditors,
+  # underwriters, advisers, custodians, transfer agents, securities lending
+  # agents). Registrant-level providers attach to the organization; per-series
+  # providers attach to the fund's financial_instrument.
+
+  - name: "audited_by"
+    description: "Link from a registrant to its public accountant / auditor (N-CEN)"
+    display_name: "Audited By"
+    mergeability: not_mergeable
+    domain_flavors: ["organization"]
+    target_flavors: ["organization"]
+    passive: true
+
+  - name: "has_principal_underwriter"
+    description: "Link from a registrant to its principal underwriter (N-CEN)"
+    display_name: "Has Principal Underwriter"
+    mergeability: not_mergeable
+    domain_flavors: ["organization"]
+    target_flavors: ["organization"]
+    passive: true
+
+  - name: "advised_by"
+    description: "Link from a registrant or fund series to an investment adviser (N-CEN)"
+    display_name: "Advised By"
+    mergeability: not_mergeable
+    domain_flavors: ["organization", "financial_instrument"]
+    target_flavors: ["organization"]
+    passive: true
+
+  - name: "has_transfer_agent"
+    description: "Link from a registrant or fund series to a transfer agent (N-CEN)"
+    display_name: "Has Transfer Agent"
+    mergeability: not_mergeable
+    domain_flavors: ["organization", "financial_instrument"]
+    target_flavors: ["organization"]
+    passive: true
+
+  - name: "custodied_by"
+    description: "Link from a fund series to its primary custodian (N-CEN). Sub-custodians are excluded; the custody_type attribute captures the custodian's role."
+    display_name: "Custodied By"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    target_flavors: ["organization"]
+    passive: true
+
+  - name: "has_securities_lending_agent"
+    description: "Link from a fund series to its securities lending agent (N-CEN)"
+    display_name: "Has Securities Lending Agent"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    target_flavors: ["organization"]
+    passive: true
+
+  - name: "sub_advised_by"
+    description: "Link from a fund series to a sub-adviser organization (N-CEN Item C.9.c). Sub-advisers are delegated portfolio-management authority by the primary investment adviser, so this complements 'advised_by' rather than replacing it."
+    display_name: "Sub-Advised By"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    target_flavors: ["organization"]
+    passive: true
+
+  - name: "has_master_fund"
+    description: "Link from a feeder fund to its master fund in a master-feeder structure (N-CEN Item C.3). The feeder invests substantially all assets in the master, so resolving this edge is required to see the feeder's true portfolio (which lives on the master's N-PORT)."
+    display_name: "Has Master Fund"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    target_flavors: ["financial_instrument"]
+    passive: true
+
+  - name: "has_feeder_fund"
+    description: "Link from a master fund to one of its feeder funds (N-CEN master-feeder structure)."
+    display_name: "Has Feeder Fund"
+    mergeability: not_mergeable
+    domain_flavors: ["financial_instrument"]
+    target_flavors: ["financial_instrument"]
+    passive: true
+
+  # ── N-CEN Governance (board + compliance) ──
+  # is_director already exists for person → organization; we attach board
+  # service from N-CEN directors to the registrant organization (board
+  # service is registrant-wide, not per-fund). is_chief_compliance_officer
+  # is a distinct edge from is_officer because the SEC discloses CCOs as
+  # a separate registrant-level role with its own change-since-last-filing
+  # signal.
+  - name: "is_chief_compliance_officer"
+    description: "A person serves as the Chief Compliance Officer of a registered investment company. Disclosed under N-CEN Item B.10."
+    display_name: "Is CCO"
+    mergeability: not_mergeable
+    domain_flavors: ["person"]
+    target_flavors: ["organization"]
+    passive: true
+
+  # ── N-CEN Operational Incidents (Item B.20) ──
+  # A valuation_method_change entity records a single materially-changed
+  # valuation methodology. It links back to the disclosing N-CEN filing
+  # (disclosed_in) and to each fund series the change applied to
+  # (affects_series). Item B.22 / B.23 (NAV / dividend errors) are modelled
+  # as per-fund booleans rather than separate entities since the XSD
+  # carries no per-incident metadata for them.
+  - name: "disclosed_in"
+    description: "Link from an operational-incident sub-record (e.g. a valuation method change) to the SEC filing where it was disclosed."
+    display_name: "Disclosed In"
+    mergeability: not_mergeable
+    domain_flavors: ["sec::valuation_method_change"]
+    target_flavors: ["sec::ncen"]
+    passive: true
+
+  - name: "affects_series"
+    description: "Link from an operational-incident sub-record to a fund series the incident applied to (N-CEN per-incident series fan-out)."
+    display_name: "Affects Series"
+    mergeability: not_mergeable
+    domain_flavors: ["sec::valuation_method_change"]
+    target_flavors: ["financial_instrument"]
+    passive: true
+
 # =============================================================================
 # ATTRIBUTES
 # =============================================================================
@@ -1982,3 +2746,162 @@ 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
+
+  # ── custodied_by relationship attributes (N-CEN) ──
+
+  - property: "custodied_by"
+    name: "custody_type"
+    type: string
+    description: "Custodian's role per N-CEN (e.g. SECURITIES, CASH, BANK_CUSTODIAN)"
+    display_name: "Custody Type"
+    mergeability: not_mergeable
+
+  # ── sub_advised_by relationship attributes (N-CEN) ──
+
+  - property: "sub_advised_by"
+    name: "is_sub_adviser_affiliated"
+    type: string
+    description: "Whether the sub-adviser is affiliated with the registrant or primary adviser (Y or N) per N-CEN"
+    display_name: "Sub-Adviser Affiliated"
+    mergeability: not_mergeable
+
+  # ── is_director relationship attributes (N-CEN) ──
+
+  - property: "is_director"
+    name: "is_interested_person"
+    type: string
+    description: "Whether the director is an 'interested person' (Y or N) of the registrant under section 2(a)(19) of the Investment Company Act per N-CEN Item B.9. Distinguishes affiliated/inside directors from independents."
+    display_name: "Interested Person"
+    mergeability: not_mergeable
+
+  # ── is_chief_compliance_officer relationship attributes (N-CEN) ──
+
+  - property: "is_chief_compliance_officer"
+    name: "is_changed_since_last_filing"
+    type: string
+    description: "Whether the CCO changed since the registrant's last N-CEN filing (Y or N) per Item B.10"
+    display_name: "Changed Since Last Filing"
+    mergeability: not_mergeable