@yigemo/choosefire 0.1.0 → 0.2.0

package/contracts/choosefire-family-wealth/v2/openapi.generated.json

@@ -24,7 +24,8 @@
                     "workspace",
                     "asset_account",
                     "valuation_snapshot",
-                    "classification"
+                    "classification",
+                    "holding"
                   ]
                 }
               },
@@ -57,7 +58,10 @@
               "asset_account.update.v2",
               "asset_account.archive.v2",
               "valuation_snapshot.append.v2",
-              "classification.replace.v2"
+              "classification.replace.v2",
+              "holding.create.v2",
+              "holding.update.v2",
+              "holding.archive.v2"
             ]
           },
           "operationId": {
@@ -313,6 +317,93 @@
         ],
         "type": "object"
       },
+      "AssetAccountDetailQueryV2": {
+        "additionalProperties": false,
+        "properties": {
+          "accountId": {
+            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "accountId"
+        ],
+        "type": "object"
+      },
+      "AssetAccountDetailSuccessV2": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "const": 0
+          },
+          "data": {
+            "$ref": "#/components/schemas/AssetAccountDetailV2"
+          },
+          "kind": {
+            "const": "family_wealth_success.v2"
+          },
+          "status": {
+            "const": "success"
+          },
+          "success": {
+            "const": true
+          }
+        },
+        "required": [
+          "kind",
+          "success",
+          "status",
+          "code",
+          "data"
+        ],
+        "type": "object"
+      },
+      "AssetAccountDetailV2": {
+        "additionalProperties": false,
+        "properties": {
+          "account": {
+            "$ref": "#/components/schemas/OverviewAccountV2"
+          },
+          "asOf": {
+            "format": "date-time",
+            "type": "string"
+          },
+          "authority": {
+            "$ref": "#/components/schemas/WorkspaceAuthorityV2"
+          },
+          "contractVersion": {
+            "const": 2
+          },
+          "holdings": {
+            "items": {
+              "$ref": "#/components/schemas/HoldingV2"
+            },
+            "maxItems": 1000,
+            "type": "array"
+          },
+          "kind": {
+            "const": "asset_account.detail.v2"
+          },
+          "projectionVersion": {
+            "const": 1
+          },
+          "workspaceVersion": {
+            "minimum": 1,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "kind",
+          "contractVersion",
+          "projectionVersion",
+          "workspaceVersion",
+          "asOf",
+          "authority",
+          "account",
+          "holdings"
+        ],
+        "type": "object"
+      },
       "AssetAccountDraftV2": {
         "additionalProperties": false,
         "properties": {
@@ -644,6 +735,11 @@
         "pattern": "^(?:0|[1-9]\\d*|-[1-9]\\d*)(?:\\.\\d{1,8})?$",
         "type": "string"
       },
+      "DecimalQuantityV2": {
+        "maxLength": 48,
+        "pattern": "^(?:0|[1-9]\\d*)(?:\\.\\d{1,12})?$",
+        "type": "string"
+      },
       "FamilyWealthErrorV2": {
         "additionalProperties": false,
         "properties": {
@@ -710,35 +806,383 @@
                 "minLength": 1,
                 "type": "string"
               },
-              "requestId": {
-                "maxLength": 200,
-                "minLength": 1,
-                "type": "string"
+              "requestId": {
+                "maxLength": 200,
+                "minLength": 1,
+                "type": "string"
+              }
+            },
+            "required": [
+              "message",
+              "requestId",
+              "data"
+            ],
+            "type": "object"
+          },
+          "kind": {
+            "const": "family_wealth_error.v2"
+          },
+          "status": {
+            "const": "error"
+          },
+          "success": {
+            "const": false
+          }
+        },
+        "required": [
+          "kind",
+          "success",
+          "status",
+          "code",
+          "error"
+        ],
+        "type": "object"
+      },
+      "HoldingArchiveCommandV2": {
+        "additionalProperties": false,
+        "properties": {
+          "commandId": {
+            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+            "type": "string"
+          },
+          "expectedObjectRevision": {
+            "minimum": 1,
+            "type": "integer"
+          },
+          "expectedWorkspaceVersion": {
+            "minimum": 1,
+            "type": "integer"
+          },
+          "idempotencyKey": {
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{7,199}$",
+            "type": "string"
+          },
+          "kind": {
+            "const": "holding.archive.v2"
+          },
+          "payload": {
+            "$ref": "#/components/schemas/HoldingArchivePayloadV2"
+          },
+          "source": {
+            "$ref": "#/components/schemas/SourceV2"
+          }
+        },
+        "required": [
+          "kind",
+          "commandId",
+          "idempotencyKey",
+          "expectedWorkspaceVersion",
+          "expectedObjectRevision",
+          "source",
+          "payload"
+        ],
+        "type": "object"
+      },
+      "HoldingArchivePayloadV2": {
+        "additionalProperties": false,
+        "properties": {
+          "holdingId": {
+            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+            "type": "string"
+          },
+          "reason": {
+            "maxLength": 240,
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "holdingId",
+          "reason"
+        ],
+        "type": "object"
+      },
+      "HoldingCreateCommandV2": {
+        "additionalProperties": false,
+        "properties": {
+          "commandId": {
+            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+            "type": "string"
+          },
+          "expectedObjectRevision": {
+            "type": "null"
+          },
+          "expectedWorkspaceVersion": {
+            "minimum": 1,
+            "type": "integer"
+          },
+          "idempotencyKey": {
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{7,199}$",
+            "type": "string"
+          },
+          "kind": {
+            "const": "holding.create.v2"
+          },
+          "payload": {
+            "$ref": "#/components/schemas/HoldingCreatePayloadV2"
+          },
+          "source": {
+            "$ref": "#/components/schemas/SourceV2"
+          }
+        },
+        "required": [
+          "kind",
+          "commandId",
+          "idempotencyKey",
+          "expectedWorkspaceVersion",
+          "expectedObjectRevision",
+          "source",
+          "payload"
+        ],
+        "type": "object"
+      },
+      "HoldingCreatePayloadV2": {
+        "additionalProperties": false,
+        "properties": {
+          "accountId": {
+            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+            "type": "string"
+          },
+          "holding": {
+            "$ref": "#/components/schemas/HoldingDraftV2"
+          },
+          "holdingId": {
+            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "holdingId",
+          "accountId",
+          "holding"
+        ],
+        "type": "object"
+      },
+      "HoldingDraftV2": {
+        "additionalProperties": false,
+        "properties": {
+          "currency": {
+            "$ref": "#/components/schemas/CurrencyCodeV2"
+          },
+          "instrumentRef": {
+            "anyOf": [
+              {
+                "maxLength": 160,
+                "minLength": 1,
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "name": {
+            "maxLength": 120,
+            "minLength": 1,
+            "type": "string"
+          },
+          "quality": {
+            "$ref": "#/components/schemas/QualityV2"
+          },
+          "quantity": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/DecimalQuantityV2"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "quantityAsOf": {
+            "anyOf": [
+              {
+                "format": "date-time",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "source": {
+            "$ref": "#/components/schemas/SourceV2"
+          }
+        },
+        "required": [
+          "name",
+          "instrumentRef",
+          "quantity",
+          "quantityAsOf",
+          "currency",
+          "quality",
+          "source"
+        ],
+        "type": "object"
+      },
+      "HoldingUpdateCommandV2": {
+        "additionalProperties": false,
+        "properties": {
+          "commandId": {
+            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+            "type": "string"
+          },
+          "expectedObjectRevision": {
+            "minimum": 1,
+            "type": "integer"
+          },
+          "expectedWorkspaceVersion": {
+            "minimum": 1,
+            "type": "integer"
+          },
+          "idempotencyKey": {
+            "pattern": "^[A-Za-z0-9][A-Za-z0-9._:-]{7,199}$",
+            "type": "string"
+          },
+          "kind": {
+            "const": "holding.update.v2"
+          },
+          "payload": {
+            "$ref": "#/components/schemas/HoldingUpdatePayloadV2"
+          },
+          "source": {
+            "$ref": "#/components/schemas/SourceV2"
+          }
+        },
+        "required": [
+          "kind",
+          "commandId",
+          "idempotencyKey",
+          "expectedWorkspaceVersion",
+          "expectedObjectRevision",
+          "source",
+          "payload"
+        ],
+        "type": "object"
+      },
+      "HoldingUpdatePayloadV2": {
+        "additionalProperties": false,
+        "properties": {
+          "holding": {
+            "$ref": "#/components/schemas/HoldingDraftV2"
+          },
+          "holdingId": {
+            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+            "type": "string"
+          }
+        },
+        "required": [
+          "holdingId",
+          "holding"
+        ],
+        "type": "object"
+      },
+      "HoldingV2": {
+        "additionalProperties": false,
+        "properties": {
+          "accountId": {
+            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+            "type": "string"
+          },
+          "assetClasses": {
+            "items": {
+              "$ref": "#/components/schemas/AllocationLineV2"
+            },
+            "maxItems": 20,
+            "type": "array"
+          },
+          "classificationRevision": {
+            "minimum": 0,
+            "type": "integer"
+          },
+          "classificationSource": {
+            "enum": [
+              "holding",
+              "account_default"
+            ]
+          },
+          "currency": {
+            "$ref": "#/components/schemas/CurrencyCodeV2"
+          },
+          "holdingId": {
+            "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$",
+            "type": "string"
+          },
+          "instrumentRef": {
+            "anyOf": [
+              {
+                "maxLength": 160,
+                "minLength": 1,
+                "type": "string"
+              },
+              {
+                "type": "null"
               }
+            ]
+          },
+          "name": {
+            "maxLength": 120,
+            "minLength": 1,
+            "type": "string"
+          },
+          "purposeBuckets": {
+            "items": {
+              "$ref": "#/components/schemas/AllocationLineV2"
             },
-            "required": [
-              "message",
-              "requestId",
-              "data"
-            ],
-            "type": "object"
+            "maxItems": 20,
+            "type": "array"
           },
-          "kind": {
-            "const": "family_wealth_error.v2"
+          "quality": {
+            "$ref": "#/components/schemas/QualityV2"
           },
-          "status": {
-            "const": "error"
+          "quantity": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/DecimalQuantityV2"
+              },
+              {
+                "type": "null"
+              }
+            ]
           },
-          "success": {
-            "const": false
+          "quantityAsOf": {
+            "anyOf": [
+              {
+                "format": "date-time",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
+          "revision": {
+            "minimum": 1,
+            "type": "integer"
+          },
+          "source": {
+            "$ref": "#/components/schemas/SourceV2"
+          },
+          "valuation": {
+            "$ref": "#/components/schemas/OverviewValuationV2"
           }
         },
         "required": [
-          "kind",
-          "success",
-          "status",
-          "code",
-          "error"
+          "holdingId",
+          "accountId",
+          "name",
+          "instrumentRef",
+          "quantity",
+          "quantityAsOf",
+          "currency",
+          "quality",
+          "source",
+          "revision",
+          "classificationRevision",
+          "classificationSource",
+          "assetClasses",
+          "purposeBuckets",
+          "valuation"
         ],
         "type": "object"
       },
@@ -1452,7 +1896,8 @@
               "enum": [
                 "workspace.summary.v2",
                 "activity.page.v2",
-                "workspace.overview.v2"
+                "workspace.overview.v2",
+                "asset_account.detail.v2"
               ]
             },
             "type": "array",
@@ -1465,7 +1910,10 @@
                 "asset_account.update.v2",
                 "asset_account.archive.v2",
                 "valuation_snapshot.append.v2",
-                "classification.replace.v2"
+                "classification.replace.v2",
+                "holding.create.v2",
+                "holding.update.v2",
+                "holding.archive.v2"
               ]
             },
             "type": "array",
@@ -1677,20 +2125,43 @@
         "additionalProperties": false,
         "properties": {
           "readable": {
-            "maxItems": 3,
-            "minItems": 3,
-            "prefixItems": [
+            "oneOf": [
               {
-                "const": "workspace.summary.v2"
-              },
-              {
-                "const": "activity.page.v2"
+                "maxItems": 3,
+                "minItems": 3,
+                "prefixItems": [
+                  {
+                    "const": "workspace.summary.v2"
+                  },
+                  {
+                    "const": "activity.page.v2"
+                  },
+                  {
+                    "const": "workspace.overview.v2"
+                  }
+                ],
+                "type": "array"
               },
               {
-                "const": "workspace.overview.v2"
+                "maxItems": 4,
+                "minItems": 4,
+                "prefixItems": [
+                  {
+                    "const": "workspace.summary.v2"
+                  },
+                  {
+                    "const": "activity.page.v2"
+                  },
+                  {
+                    "const": "workspace.overview.v2"
+                  },
+                  {
+                    "const": "asset_account.detail.v2"
+                  }
+                ],
+                "type": "array"
               }
-            ],
-            "type": "array"
+            ]
           },
           "role": {
             "anyOf": [
@@ -2064,7 +2535,8 @@
                 "type": "integer"
               },
               "holdings": {
-                "const": 0
+                "minimum": 0,
+                "type": "integer"
               },
               "pendingItems": {
                 "minimum": 0,
@@ -2131,8 +2603,8 @@
     }
   },
   "info": {
-    "title": "ChooseFIRE Family Wealth v2 R2 Contract",
-    "version": "2.0.0-r2"
+    "title": "ChooseFIRE Family Wealth v2 R3 Holdings Contract",
+    "version": "2.0.0-r3-holdings"
   },
   "openapi": "3.1.0",
   "paths": {
@@ -2380,6 +2852,50 @@
         "summary": "Archive one active asset account without deleting history"
       }
     },
+    "/choosefire/v2/workspace/asset-accounts/{accountId}": {
+      "get": {
+        "operationId": "getFamilyWealthAssetAccountDetailV2",
+        "parameters": [
+          {
+            "in": "path",
+            "name": "accountId",
+            "required": true,
+            "schema": {
+              "format": "uuid",
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/AssetAccountDetailSuccessV2"
+                }
+              }
+            },
+            "description": "Role-bound asset account detail"
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/FamilyWealthErrorV2"
+                }
+              }
+            },
+            "description": "Account is absent, archived, or hidden from the caller"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Read one account and its bounded active holdings"
+      }
+    },
     "/choosefire/v2/workspace/classifications": {
       "put": {
         "operationId": "replaceFamilyWealthClassificationV2",
@@ -2433,6 +2949,133 @@
         "summary": "Replace account or holding asset and purpose allocations"
       }
     },
+    "/choosefire/v2/workspace/holdings": {
+      "post": {
+        "operationId": "createFamilyWealthHoldingV2",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/HoldingCreateCommandV2"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CommandSuccessV2"
+                }
+              }
+            },
+            "description": "Committed holding receipt"
+          },
+          "409": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/FamilyWealthErrorV2"
+                }
+              }
+            },
+            "description": "Workspace or object conflict"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Create one holding under an active detailed account"
+      },
+      "put": {
+        "operationId": "updateFamilyWealthHoldingV2",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/HoldingUpdateCommandV2"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CommandSuccessV2"
+                }
+              }
+            },
+            "description": "Committed holding update receipt"
+          },
+          "409": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/FamilyWealthErrorV2"
+                }
+              }
+            },
+            "description": "Workspace or holding revision conflict"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Replace editable metadata for one active holding"
+      }
+    },
+    "/choosefire/v2/workspace/holdings/archive": {
+      "post": {
+        "operationId": "archiveFamilyWealthHoldingV2",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/HoldingArchiveCommandV2"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/CommandSuccessV2"
+                }
+              }
+            },
+            "description": "Committed holding archive receipt"
+          },
+          "409": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/FamilyWealthErrorV2"
+                }
+              }
+            },
+            "description": "Workspace or holding revision conflict"
+          }
+        },
+        "security": [
+          {
+            "bearer": []
+          }
+        ],
+        "summary": "Archive one active holding without deleting history"
+      }
+    },
     "/choosefire/v2/workspace/mcp/delegation": {
       "post": {
         "operationId": "issueFamilyWealthWorkspaceMcpDelegationV2",
@@ -2601,5 +3244,5 @@
   },
   "x-choosefire-contract-id": "choosefire-family-wealth.v2",
   "x-choosefire-contract-version": 2,
-  "x-choosefire-runtime-state": "r1-runtime-r2-contract-only"
+  "x-choosefire-runtime-state": "r3-holdings-parity"
 }