feat(context): add instrument classification property

This adds an experimental optional classification field to the instrument context. For use in categorizing different types of financial instruments.

Fixes #1615

Author: hughtroeger

packages/fdc3-context/schemas/context/instrument.schema.json

@@ -96,6 +96,47 @@
           "unevaluatedProperties": {
             "type": "string"
           }
+        },
+        "classification": {
+          "title": "Instrument Classification",
+          "description": "@experimental classification of the instrument by type or category. SHOULD be one of the standardized values, although other string values are permitted.",
+          "anyOf": [
+            {
+              "type": "string",
+              "enum": [
+                "commodity",
+                "commodityIndex",
+                "corporateDebt",
+                "creditDefaultSwapIndex",
+                "deal",
+                "debt",
+                "debtIndex",
+                "etf",
+                "fixedIncome",
+                "future",
+                "governmentBenchmarkDebt",
+                "loan",
+                "mortgageBackedSecurity",
+                "municipalDebt",
+                "mutualFund",
+                "mutualFundIndex",
+                "option",
+                "otherDebt",
+                "ownershipPrivateCompany",
+                "pevcFirm",
+                "pevcFund",
+                "privateCompany",
+                "publicCompany",
+                "publicCompanyIndex",
+                "sovereignDebt",
+                "structuredProduct",
+                "unknown"
+              ]
+            },
+            {
+              "type": "string"
+            }
+          ]
         }
       },
       "required": [
@@ -115,7 +156,8 @@
       },
       "market": {
           "MIC": "XNAS"
-      }
+      },
+      "classification": "publicCompany"
     }
   ]
 }

website/docs/context/ref/Instrument.md

@@ -171,6 +171,45 @@ The `market` map can be used to further specify the instrument and help achieve
 
 </details>
 
+<details>
+  <summary><code>classification</code></summary>
+
+**Any of:**
+
+- **type**: `string` with values:
+- `commodity`,
+- `commodityIndex`,
+- `corporateDebt`,
+- `creditDefaultSwapIndex`,
+- `deal`,
+- `debt`,
+- `debtIndex`,
+- `etf`,
+- `fixedIncome`,
+- `future`,
+- `governmentBenchmarkDebt`,
+- `loan`,
+- `mortgageBackedSecurity`,
+- `municipalDebt`,
+- `mutualFund`,
+- `mutualFundIndex`,
+- `option`,
+- `otherDebt`,
+- `ownershipPrivateCompany`,
+- `pevcFirm`,
+- `pevcFund`,
+- `privateCompany`,
+- `publicCompany`,
+- `publicCompanyIndex`,
+- `sovereignDebt`,
+- `structuredProduct`,
+- `unknown`
+- **type**: `string`
+
+[@experimental](/docs/fdc3-compliance#experimental-features) classification of the instrument by type or category. SHOULD be one of the standardized values, although other string values are permitted.
+
+</details>
+
 ## Example
 
 ```json
@@ -184,7 +223,8 @@ The `market` map can be used to further specify the instrument and help achieve
   },
   "market": {
     "MIC": "XNAS"
-  }
+  },
+  "classification": "publicCompany"
 }
 ```