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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yottagraph-app/data-model-skill",
-  "version": "0.0.16",
+  "version": "0.0.18",
   "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"
@@ -134,6 +141,30 @@ flavors:
     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: "form_d"
+    namespace: "sec"
+    description: "Regulation D offering notice (Form D or D/A) filed with the SEC to claim an exemption from registration for a private placement. Covers VC/PE funds, hedge funds, and operating company raises."
+    display_name: "Form D"
+    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)"
@@ -143,10 +174,16 @@ flavors:
     passive: true
 
   - name: "person"
-    description: "A real person as opposed to a fictional character, such as a CEO, politician, or public figure"
+    description: "A real person as opposed to a fictional character, such as a CEO, politician, or public figure. Also used for individual registered broker-dealer representatives identified by their FINRA CRD number."
     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"
@@ -175,7 +212,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", "sec::nport_p"]
+    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", "sec::form_d"]
     passive: true
 
   - name: "ticker"
@@ -212,7 +249,7 @@ properties:
 
   - name: "state_of_incorporation"
     type: string
-    description: "Two-letter US state or country code of incorporation"
+    description: "State or country of incorporation or formation. Submission-derived values are two-letter US state / ISO country codes (e.g. DE, KY); Form D reports the same concept as a full uppercase jurisdiction name (e.g. DELAWARE, CAYMAN ISLANDS) and is emitted as-is. Consumers should treat the value as an opaque jurisdiction string and match by case-insensitive equality after normalising whitespace."
     display_name: "State of Incorporation"
     mergeability: not_mergeable
     domain_flavors: ["organization"]
@@ -597,7 +634,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::nport_p", "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::form_d", "sec::filing"]
     passive: true
 
   - name: "form_type"
@@ -605,7 +642,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::nport_p", "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::form_d", "sec::filing"]
     passive: true
 
   - name: "filing_date"
@@ -613,7 +650,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::nport_p", "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::form_d", "sec::filing"]
     passive: true
 
   - name: "report_date"
@@ -621,7 +658,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::nport_p", "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::form_d", "sec::filing"]
     passive: true
 
   # ── XBRL Financial Facts (key concepts) ──
@@ -1558,10 +1595,10 @@ properties:
 
   - name: "report_period_date"
     type: string
-    description: "End date for the report period (e.g. quarter-end for 13F-HR, month-end for N-PORT)"
+    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", "sec::nport_p"]
+    domain_flavors: ["sec::13f_hr", "sec::nport_p", "sec::ncen"]
     passive: true
 
   - name: "confidential_treatment_flag"
@@ -1767,6 +1804,460 @@ properties:
     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
+
+  # ── Form D: Issuer Attributes (on organization) ──
+
+  # Form-D-specific issuer attributes are scoped with form_d_ prefixes when
+  # they overlap conceptually with broader properties (industry_group →
+  # form_d_industry_group disambiguates from sic_code and the 'industry'
+  # flavor). Truly Form-D-only attributes (legal_entity_form,
+  # private_fund_type, year_of_inc) keep simple names. Fields that change
+  # over time relative to the filing date (e.g. "incorporated within the
+  # last 5 years") are deliberately not stored: they're derivable from
+  # year_of_inc + filing_date and would otherwise accumulate conflicting
+  # answers across filings.
+
+  - name: "legal_entity_form"
+    type: string
+    description: "Legal entity structure as reported in Form D: e.g. Limited Partnership, Limited Liability Company, Corporation, Business Trust"
+    display_name: "Legal Entity Form"
+    mergeability: not_mergeable
+    domain_flavors: ["organization"]
+    examples: ["Limited Partnership", "Limited Liability Company", "Corporation"]
+    passive: true
+
+  - name: "form_d_industry_group"
+    type: string
+    description: "Form D's coarse industry classification (e.g. Pooled Investment Fund, Technology, Real Estate, Banking). Distinct from the SIC taxonomy carried by sic_code/sic_description and the 'industry' flavor — Form D's enum is much coarser and self-reported by the issuer."
+    display_name: "Form D Industry Group"
+    mergeability: not_mergeable
+    domain_flavors: ["organization"]
+    examples: ["Pooled Investment Fund", "Technology", "Real Estate"]
+    passive: true
+
+  - name: "private_fund_type"
+    type: string
+    description: "Fund type for pooled investment fund issuers in Form D: Venture Capital Fund, Hedge Fund, Private Equity Fund, Real Estate Fund, etc."
+    display_name: "Private Fund Type"
+    mergeability: not_mergeable
+    domain_flavors: ["organization"]
+    examples: ["Venture Capital Fund", "Hedge Fund", "Private Equity Fund"]
+    passive: true
+
+  - name: "year_of_inc"
+    type: string
+    description: "Year the issuer was incorporated or formed (from Form D)"
+    display_name: "Year of Incorporation"
+    mergeability: not_mergeable
+    domain_flavors: ["organization"]
+    examples: ["2024", "1985"]
+    passive: true
+
+  # ── Form D: Offering Attributes (on sec::form_d) ──
+  #
+  # Offering-level facts use the `offering_` prefix to scope them clearly
+  # to the offering record (sec::form_d) and avoid collisions with future
+  # broader concepts of "amount" or "investors" on other filing types.
+  # Booleans derivable from other properties (e.g. is_amendment, recoverable
+  # from form_type ending in "/A") are intentionally omitted — see the
+  # Form D handler for the derivation contract.
+
+  - name: "date_of_first_sale"
+    type: string
+    description: "Date on which the first securities were sold in this offering (from Form D)"
+    display_name: "Date of First Sale"
+    mergeability: not_mergeable
+    domain_flavors: ["sec::form_d"]
+    examples: ["2026-02-26"]
+    passive: true
+
+  - name: "offering_total_amount"
+    type: float
+    description: "Total target offering size in USD (from Form D). Empty when the offering amount is Indefinite — see offering_amount_indefinite."
+    display_name: "Offering Total Amount"
+    mergeability: not_mergeable
+    domain_flavors: ["sec::form_d"]
+    passive: true
+
+  - name: "offering_amount_sold"
+    type: float
+    description: "Total amount already sold/raised from investors in USD (from Form D)"
+    display_name: "Offering Amount Sold"
+    mergeability: not_mergeable
+    domain_flavors: ["sec::form_d"]
+    passive: true
+
+  - name: "offering_total_investors"
+    type: float
+    description: "Number of investors who have already participated in this offering (from Form D). Typed as float to match the schema-wide convention for numeric counts (entity_number_of_employees, board_size, us_gaap:number_of_segments)."
+    display_name: "Offering Total Investors"
+    mergeability: not_mergeable
+    domain_flavors: ["sec::form_d"]
+    passive: true
+
+  - name: "offering_min_investment"
+    type: float
+    description: "Minimum investment accepted from a single investor in USD (from Form D)"
+    display_name: "Offering Min Investment"
+    mergeability: not_mergeable
+    domain_flavors: ["sec::form_d"]
+    passive: true
+
+  - name: "federal_exemption"
+    type: string
+    description: "Primary Reg D federal exemption claimed: 06b (Rule 506(b) accredited), 06c (Rule 506(c) general solicitation), 04a5, 04a6, etc."
+    display_name: "Federal Exemption"
+    mergeability: not_mergeable
+    domain_flavors: ["sec::form_d"]
+    examples: ["06b", "06c", "04a5"]
+    passive: true
+
+  - name: "offering_amount_indefinite"
+    type: string
+    description: "Whether the total offering amount is Indefinite (open-ended offering with no fixed cap): Y or N"
+    display_name: "Indefinite Offering"
+    mergeability: not_mergeable
+    domain_flavors: ["sec::form_d"]
+    examples: ["Y", "N"]
+    passive: true
+
+  - name: "issuer_size_range"
+    type: string
+    description: "Verbal size range of the issuer from Form D: aggregateNetAssetValueRange for funds or revenueRange for operating companies"
+    display_name: "Issuer Size Range"
+    mergeability: not_mergeable
+    domain_flavors: ["sec::form_d"]
+    examples: ["$1 - $5,000,000", "Over $1,000,000,000", "Decline to Disclose"]
+    passive: true
+
+  - name: "more_than_one_year"
+    type: string
+    description: "Whether the offering is expected to last more than one year: true or false (from Form D durationOfOffering)"
+    display_name: "Multi-Year Offering"
+    mergeability: not_mergeable
+    domain_flavors: ["sec::form_d"]
+    examples: ["true", "false"]
+    passive: true
+
+  - name: "has_non_accredited_investors"
+    type: string
+    description: "Whether the offering has sold securities to any non-accredited investors: true or false (from Form D)"
+    display_name: "Non-Accredited Investors"
+    mergeability: not_mergeable
+    domain_flavors: ["sec::form_d"]
+    examples: ["true", "false"]
+    passive: true
+
+  - name: "is_40_act_fund"
+    type: string
+    description: "Whether the issuer is a fund registered under the Investment Company Act of 1940: true or false. Registered funds are subject to stricter regulation than exempt funds under 3(c)(1) or 3(c)(7). This is the issuer's own assertion at Form D filing time; the canonical durable registrant attribute for the same concept is investment_company_type on organization (a non-empty value there implies 1940 Act registration)."
+    display_name: "40 Act Registered"
+    mergeability: not_mergeable
+    domain_flavors: ["sec::form_d"]
+    examples: ["true", "false"]
+    passive: true
+
   # ── Financial Instrument: N-PORT Fund Financials ──
 
   - name: "fund_total_assets"
@@ -2044,8 +2535,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::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"]
+    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::form_d", "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::form_d", "sec::filing"]
     passive: true
 
   - name: "is_issuer_of"
@@ -2061,7 +2552,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", "sec::nport_p"]
+    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::form_d"]
     passive: true
 
   # ── Filing → Organization ──
@@ -2070,7 +2561,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::nport_p", "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::form_d", "sec::filing", "financial_instrument"]
     target_flavors: ["organization"]
     passive: true
 
@@ -2086,7 +2577,23 @@ 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::nport_p", "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::form_d", "sec::filing"]
+    target_flavors: ["organization", "person"]
+    passive: true
+
+  # placed_offering is a per-offering transactional edge from the Form D
+  # filing to a sales compensation recipient — distinct from the N-CEN
+  # service-provider edges (audited_by, advised_by, has_principal_underwriter,
+  # has_transfer_agent, custodied_by, sub_advised_by, has_securities_lending_
+  # agent), which are durable registrant-↔-provider relationships that live
+  # on the organization or financial_instrument. A single broker-dealer may
+  # appear as `placed_offering` from many Form D filings while never
+  # appearing on an N-CEN service-provider edge for those same issuers.
+  - name: "placed_offering"
+    description: "Link from a Form D filing to a broker-dealer, investment adviser, or registered representative receiving sales compensation for placing the Reg D offering"
+    display_name: "Placed Offering"
+    mergeability: not_mergeable
+    domain_flavors: ["sec::form_d"]
     target_flavors: ["organization", "person"]
     passive: true
 
@@ -2194,6 +2701,122 @@ relationships:
     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
 # =============================================================================
@@ -2422,3 +3045,39 @@ attributes:
     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