@yigemo/choosefire 0.1.0

package/contracts/choosefire-financial-workspace/v1/openapi.generated.json

@@ -0,0 +1,1987 @@
+{
+  "components": {
+    "schemas": {
+      "AccountAuthorityV1": {
+        "additionalProperties": false,
+        "properties": {
+          "householdId": {
+            "maxLength": 200,
+            "minLength": 1,
+            "type": "string"
+          },
+          "mode": {
+            "const": "account"
+          },
+          "status": {
+            "const": "authoritative"
+          },
+          "storeId": {
+            "maxLength": 200,
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "mode",
+          "storeId",
+          "householdId",
+          "status"
+        ],
+        "type": "object"
+      },
+      "CursorExpiredErrorDataV1": {
+        "additionalProperties": false,
+        "properties": {
+          "recovery": {
+            "const": "read_snapshot"
+          }
+        },
+        "required": [
+          "recovery"
+        ],
+        "type": "object"
+      },
+      "EmptyErrorDataV1": {
+        "additionalProperties": false,
+        "maxProperties": 0,
+        "properties": {},
+        "required": [],
+        "type": "object"
+      },
+      "ErrorEnvelope400V1": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "enum": [
+              "INVALID_HTTP_FRAMING",
+              "INVALID_JSON",
+              "VALIDATION_ERROR"
+            ]
+          },
+          "error": {
+            "additionalProperties": false,
+            "properties": {
+              "data": {
+                "$ref": "#/components/schemas/EmptyErrorDataV1"
+              },
+              "message": {
+                "maxLength": 500,
+                "minLength": 1,
+                "type": "string"
+              },
+              "requestId": {
+                "maxLength": 200,
+                "minLength": 1,
+                "type": "string"
+              }
+            },
+            "required": [
+              "message",
+              "data"
+            ],
+            "type": "object"
+          },
+          "kind": {
+            "const": "financial_workspace_error.v1"
+          },
+          "status": {
+            "const": "error"
+          },
+          "success": {
+            "const": false
+          }
+        },
+        "required": [
+          "kind",
+          "code",
+          "success",
+          "status",
+          "error"
+        ],
+        "type": "object"
+      },
+      "ErrorEnvelope401V1": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "enum": [
+              "AUTH_REQUIRED"
+            ]
+          },
+          "error": {
+            "additionalProperties": false,
+            "properties": {
+              "data": {
+                "$ref": "#/components/schemas/EmptyErrorDataV1"
+              },
+              "message": {
+                "maxLength": 500,
+                "minLength": 1,
+                "type": "string"
+              },
+              "requestId": {
+                "maxLength": 200,
+                "minLength": 1,
+                "type": "string"
+              }
+            },
+            "required": [
+              "message",
+              "data"
+            ],
+            "type": "object"
+          },
+          "kind": {
+            "const": "financial_workspace_error.v1"
+          },
+          "status": {
+            "const": "error"
+          },
+          "success": {
+            "const": false
+          }
+        },
+        "required": [
+          "kind",
+          "code",
+          "success",
+          "status",
+          "error"
+        ],
+        "type": "object"
+      },
+      "ErrorEnvelope403V1": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "enum": [
+              "ACCOUNT_SCOPE_REQUIRED",
+              "CSRF_VALIDATION_FAILED"
+            ]
+          },
+          "error": {
+            "additionalProperties": false,
+            "properties": {
+              "data": {
+                "$ref": "#/components/schemas/EmptyErrorDataV1"
+              },
+              "message": {
+                "maxLength": 500,
+                "minLength": 1,
+                "type": "string"
+              },
+              "requestId": {
+                "maxLength": 200,
+                "minLength": 1,
+                "type": "string"
+              }
+            },
+            "required": [
+              "message",
+              "data"
+            ],
+            "type": "object"
+          },
+          "kind": {
+            "const": "financial_workspace_error.v1"
+          },
+          "status": {
+            "const": "error"
+          },
+          "success": {
+            "const": false
+          }
+        },
+        "required": [
+          "kind",
+          "code",
+          "success",
+          "status",
+          "error"
+        ],
+        "type": "object"
+      },
+      "ErrorEnvelope404V1": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "enum": [
+              "WORKSPACE_NOT_INITIALIZED"
+            ]
+          },
+          "error": {
+            "additionalProperties": false,
+            "properties": {
+              "data": {
+                "$ref": "#/components/schemas/EmptyErrorDataV1"
+              },
+              "message": {
+                "maxLength": 500,
+                "minLength": 1,
+                "type": "string"
+              },
+              "requestId": {
+                "maxLength": 200,
+                "minLength": 1,
+                "type": "string"
+              }
+            },
+            "required": [
+              "message",
+              "data"
+            ],
+            "type": "object"
+          },
+          "kind": {
+            "const": "financial_workspace_error.v1"
+          },
+          "status": {
+            "const": "error"
+          },
+          "success": {
+            "const": false
+          }
+        },
+        "required": [
+          "kind",
+          "code",
+          "success",
+          "status",
+          "error"
+        ],
+        "type": "object"
+      },
+      "ErrorEnvelope409V1": {
+        "oneOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "code": {
+                "enum": [
+                  "WORKSPACE_ALREADY_INITIALIZED",
+                  "WORKSPACE_AUTHORITY_MISMATCH",
+                  "IDEMPOTENCY_CONFLICT",
+                  "PROTECTED_FACT_CHANGE_REQUIRES_PREVIEW"
+                ]
+              },
+              "error": {
+                "additionalProperties": false,
+                "properties": {
+                  "data": {
+                    "$ref": "#/components/schemas/EmptyErrorDataV1"
+                  },
+                  "message": {
+                    "maxLength": 500,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "requestId": {
+                    "maxLength": 200,
+                    "minLength": 1,
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "message",
+                  "data"
+                ],
+                "type": "object"
+              },
+              "kind": {
+                "const": "financial_workspace_error.v1"
+              },
+              "status": {
+                "const": "error"
+              },
+              "success": {
+                "const": false
+              }
+            },
+            "required": [
+              "kind",
+              "code",
+              "success",
+              "status",
+              "error"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "code": {
+                "enum": [
+                  "VERSION_CONFLICT"
+                ]
+              },
+              "error": {
+                "additionalProperties": false,
+                "properties": {
+                  "data": {
+                    "$ref": "#/components/schemas/VersionConflictErrorDataV1"
+                  },
+                  "message": {
+                    "maxLength": 500,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "requestId": {
+                    "maxLength": 200,
+                    "minLength": 1,
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "message",
+                  "data"
+                ],
+                "type": "object"
+              },
+              "kind": {
+                "const": "financial_workspace_error.v1"
+              },
+              "status": {
+                "const": "error"
+              },
+              "success": {
+                "const": false
+              }
+            },
+            "required": [
+              "kind",
+              "code",
+              "success",
+              "status",
+              "error"
+            ],
+            "type": "object"
+          }
+        ]
+      },
+      "ErrorEnvelope410V1": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "enum": [
+              "CURSOR_EXPIRED"
+            ]
+          },
+          "error": {
+            "additionalProperties": false,
+            "properties": {
+              "data": {
+                "$ref": "#/components/schemas/CursorExpiredErrorDataV1"
+              },
+              "message": {
+                "maxLength": 500,
+                "minLength": 1,
+                "type": "string"
+              },
+              "requestId": {
+                "maxLength": 200,
+                "minLength": 1,
+                "type": "string"
+              }
+            },
+            "required": [
+              "message",
+              "data"
+            ],
+            "type": "object"
+          },
+          "kind": {
+            "const": "financial_workspace_error.v1"
+          },
+          "status": {
+            "const": "error"
+          },
+          "success": {
+            "const": false
+          }
+        },
+        "required": [
+          "kind",
+          "code",
+          "success",
+          "status",
+          "error"
+        ],
+        "type": "object"
+      },
+      "ErrorEnvelope413V1": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "enum": [
+              "PAYLOAD_TOO_LARGE"
+            ]
+          },
+          "error": {
+            "additionalProperties": false,
+            "properties": {
+              "data": {
+                "$ref": "#/components/schemas/EmptyErrorDataV1"
+              },
+              "message": {
+                "maxLength": 500,
+                "minLength": 1,
+                "type": "string"
+              },
+              "requestId": {
+                "maxLength": 200,
+                "minLength": 1,
+                "type": "string"
+              }
+            },
+            "required": [
+              "message",
+              "data"
+            ],
+            "type": "object"
+          },
+          "kind": {
+            "const": "financial_workspace_error.v1"
+          },
+          "status": {
+            "const": "error"
+          },
+          "success": {
+            "const": false
+          }
+        },
+        "required": [
+          "kind",
+          "code",
+          "success",
+          "status",
+          "error"
+        ],
+        "type": "object"
+      },
+      "ErrorEnvelope415V1": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "enum": [
+              "UNSUPPORTED_MEDIA_TYPE"
+            ]
+          },
+          "error": {
+            "additionalProperties": false,
+            "properties": {
+              "data": {
+                "$ref": "#/components/schemas/EmptyErrorDataV1"
+              },
+              "message": {
+                "maxLength": 500,
+                "minLength": 1,
+                "type": "string"
+              },
+              "requestId": {
+                "maxLength": 200,
+                "minLength": 1,
+                "type": "string"
+              }
+            },
+            "required": [
+              "message",
+              "data"
+            ],
+            "type": "object"
+          },
+          "kind": {
+            "const": "financial_workspace_error.v1"
+          },
+          "status": {
+            "const": "error"
+          },
+          "success": {
+            "const": false
+          }
+        },
+        "required": [
+          "kind",
+          "code",
+          "success",
+          "status",
+          "error"
+        ],
+        "type": "object"
+      },
+      "ErrorEnvelope503V1": {
+        "oneOf": [
+          {
+            "additionalProperties": false,
+            "properties": {
+              "code": {
+                "enum": [
+                  "TRANSACTION_RETRYABLE"
+                ]
+              },
+              "error": {
+                "additionalProperties": false,
+                "properties": {
+                  "data": {
+                    "$ref": "#/components/schemas/TransactionRetryableErrorDataV1"
+                  },
+                  "message": {
+                    "maxLength": 500,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "requestId": {
+                    "maxLength": 200,
+                    "minLength": 1,
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "message",
+                  "data"
+                ],
+                "type": "object"
+              },
+              "kind": {
+                "const": "financial_workspace_error.v1"
+              },
+              "status": {
+                "const": "error"
+              },
+              "success": {
+                "const": false
+              }
+            },
+            "required": [
+              "kind",
+              "code",
+              "success",
+              "status",
+              "error"
+            ],
+            "type": "object"
+          },
+          {
+            "additionalProperties": false,
+            "properties": {
+              "code": {
+                "enum": [
+                  "REMOTE_UNAVAILABLE"
+                ]
+              },
+              "error": {
+                "additionalProperties": false,
+                "properties": {
+                  "data": {
+                    "$ref": "#/components/schemas/EmptyErrorDataV1"
+                  },
+                  "message": {
+                    "maxLength": 500,
+                    "minLength": 1,
+                    "type": "string"
+                  },
+                  "requestId": {
+                    "maxLength": 200,
+                    "minLength": 1,
+                    "type": "string"
+                  }
+                },
+                "required": [
+                  "message",
+                  "data"
+                ],
+                "type": "object"
+              },
+              "kind": {
+                "const": "financial_workspace_error.v1"
+              },
+              "status": {
+                "const": "error"
+              },
+              "success": {
+                "const": false
+              }
+            },
+            "required": [
+              "kind",
+              "code",
+              "success",
+              "status",
+              "error"
+            ],
+            "type": "object"
+          }
+        ]
+      },
+      "ErrorEnvelopeV1": {
+        "oneOf": [
+          {
+            "$ref": "#/components/schemas/ErrorEnvelope400V1"
+          },
+          {
+            "$ref": "#/components/schemas/ErrorEnvelope401V1"
+          },
+          {
+            "$ref": "#/components/schemas/ErrorEnvelope403V1"
+          },
+          {
+            "$ref": "#/components/schemas/ErrorEnvelope404V1"
+          },
+          {
+            "$ref": "#/components/schemas/ErrorEnvelope409V1"
+          },
+          {
+            "$ref": "#/components/schemas/ErrorEnvelope410V1"
+          },
+          {
+            "$ref": "#/components/schemas/ErrorEnvelope413V1"
+          },
+          {
+            "$ref": "#/components/schemas/ErrorEnvelope415V1"
+          },
+          {
+            "$ref": "#/components/schemas/ErrorEnvelope503V1"
+          }
+        ]
+      },
+      "FinancialFactProjectionV1": {
+        "additionalProperties": false,
+        "properties": {
+          "asOf": {
+            "format": "date-time",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$",
+            "type": "string"
+          },
+          "factId": {
+            "maxLength": 200,
+            "minLength": 1,
+            "type": "string"
+          },
+          "field": {
+            "enum": [
+              "household.total_assets",
+              "household.long_term_allocatable_assets",
+              "household.spending.last_12_months",
+              "household.spending.last_12_months.necessary",
+              "household.spending.last_12_months.discretionary",
+              "household.monthly_contribution",
+              "household.liquid_assets",
+              "household.investments.total",
+              "household.total_debt"
+            ],
+            "type": "string"
+          },
+          "kind": {
+            "const": "financial_fact_projection.v1"
+          },
+          "recordedAt": {
+            "format": "date-time",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$",
+            "type": "string"
+          },
+          "recordedVersion": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "status": {
+            "enum": [
+              "confirmed",
+              "estimated"
+            ]
+          },
+          "value": {
+            "$ref": "#/components/schemas/FinancialTypedValueV1"
+          }
+        },
+        "required": [
+          "kind",
+          "factId",
+          "field",
+          "value",
+          "status",
+          "asOf",
+          "recordedAt",
+          "recordedVersion"
+        ],
+        "type": "object"
+      },
+      "FinancialTypedValueInputV1": {
+        "additionalProperties": false,
+        "properties": {
+          "amount": {
+            "format": "choosefire-money-v1",
+            "type": "string"
+          },
+          "currency": {
+            "maxLength": 32,
+            "minLength": 3,
+            "pattern": "^\\s*[A-Za-z]{3}\\s*$",
+            "type": "string"
+          },
+          "kind": {
+            "const": "money.v1"
+          }
+        },
+        "required": [
+          "kind",
+          "amount",
+          "currency"
+        ],
+        "type": "object"
+      },
+      "FinancialTypedValueV1": {
+        "additionalProperties": false,
+        "properties": {
+          "amount": {
+            "format": "choosefire-money-v1",
+            "type": "string"
+          },
+          "currency": {
+            "pattern": "^[A-Z]{3}$",
+            "type": "string"
+          },
+          "kind": {
+            "const": "money.v1"
+          }
+        },
+        "required": [
+          "kind",
+          "amount",
+          "currency"
+        ],
+        "type": "object"
+      },
+      "FinancialWorkspaceActivityPageV1": {
+        "additionalProperties": false,
+        "properties": {
+          "authority": {
+            "$ref": "#/components/schemas/AccountAuthorityV1"
+          },
+          "contractVersion": {
+            "const": 1
+          },
+          "hasMore": {
+            "type": "boolean"
+          },
+          "items": {
+            "items": {
+              "$ref": "#/components/schemas/OperationProjectionV1"
+            },
+            "maxItems": 100,
+            "type": "array"
+          },
+          "kind": {
+            "const": "financial_workspace_activity_page.v1"
+          },
+          "nextCursor": {
+            "maxLength": 2048,
+            "minLength": 1,
+            "type": "string"
+          },
+          "projectionVersion": {
+            "const": 1
+          },
+          "throughVersion": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "kind",
+          "authority",
+          "contractVersion",
+          "projectionVersion",
+          "throughVersion",
+          "items",
+          "nextCursor",
+          "hasMore"
+        ],
+        "type": "object"
+      },
+      "FinancialWorkspaceActivityQueryV1": {
+        "additionalProperties": false,
+        "properties": {
+          "cursor": {
+            "maxLength": 2048,
+            "minLength": 1,
+            "type": "string"
+          },
+          "limit": {
+            "maximum": 100,
+            "minimum": 1,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "limit"
+        ],
+        "type": "object"
+      },
+      "FinancialWorkspaceCapabilitiesV1": {
+        "additionalProperties": false,
+        "properties": {
+          "kind": {
+            "const": "financial_workspace_capabilities.v1"
+          },
+          "protectedChange": {
+            "const": "unavailable"
+          },
+          "readable": {
+            "items": false,
+            "maxItems": 3,
+            "minItems": 3,
+            "prefixItems": [
+              {
+                "const": "snapshot"
+              },
+              {
+                "const": "summary"
+              },
+              {
+                "const": "activity"
+              }
+            ],
+            "type": "array"
+          },
+          "writable": {
+            "items": false,
+            "maxItems": 1,
+            "minItems": 1,
+            "prefixItems": [
+              {
+                "const": "fact.record"
+              }
+            ],
+            "type": "array"
+          }
+        },
+        "required": [
+          "kind",
+          "readable",
+          "writable",
+          "protectedChange"
+        ],
+        "type": "object"
+      },
+      "FinancialWorkspaceCommandReceiptV1": {
+        "additionalProperties": false,
+        "properties": {
+          "authority": {
+            "$ref": "#/components/schemas/AccountAuthorityV1"
+          },
+          "baseVersion": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "committedAt": {
+            "format": "date-time",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$",
+            "type": "string"
+          },
+          "cursor": {
+            "maxLength": 2048,
+            "minLength": 1,
+            "type": "string"
+          },
+          "kind": {
+            "const": "financial_workspace_command_receipt.v1"
+          },
+          "operation": {
+            "$ref": "#/components/schemas/OperationProjectionV1"
+          },
+          "replayed": {
+            "type": "boolean"
+          },
+          "resultVersion": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "kind",
+          "authority",
+          "operation",
+          "baseVersion",
+          "resultVersion",
+          "replayed",
+          "cursor",
+          "committedAt"
+        ],
+        "type": "object"
+      },
+      "FinancialWorkspaceEmptyRequestV1": {
+        "additionalProperties": false,
+        "properties": {},
+        "required": [],
+        "type": "object"
+      },
+      "FinancialWorkspaceFactRecordCommandV1": {
+        "additionalProperties": false,
+        "properties": {
+          "asOf": {
+            "format": "date-time",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(?:\\.\\d{1,3})?(?:Z|[+-]\\d{2}:\\d{2})$",
+            "type": "string"
+          },
+          "expectedVersion": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "field": {
+            "enum": [
+              "household.total_assets",
+              "household.long_term_allocatable_assets",
+              "household.spending.last_12_months",
+              "household.spending.last_12_months.necessary",
+              "household.spending.last_12_months.discretionary",
+              "household.monthly_contribution",
+              "household.liquid_assets",
+              "household.investments.total",
+              "household.total_debt"
+            ],
+            "type": "string"
+          },
+          "idempotencyKey": {
+            "maxLength": 200,
+            "minLength": 1,
+            "type": "string"
+          },
+          "kind": {
+            "const": "financial_workspace_fact_record_command.v1"
+          },
+          "status": {
+            "enum": [
+              "confirmed",
+              "estimated"
+            ]
+          },
+          "value": {
+            "$ref": "#/components/schemas/FinancialTypedValueInputV1"
+          }
+        },
+        "required": [
+          "kind",
+          "expectedVersion",
+          "idempotencyKey",
+          "field",
+          "value"
+        ],
+        "type": "object"
+      },
+      "FinancialWorkspaceFactRefV1": {
+        "additionalProperties": false,
+        "properties": {
+          "factId": {
+            "maxLength": 200,
+            "minLength": 1,
+            "type": "string"
+          },
+          "kind": {
+            "const": "financial_workspace_fact_ref.v1"
+          }
+        },
+        "required": [
+          "kind",
+          "factId"
+        ],
+        "type": "object"
+      },
+      "FinancialWorkspaceSnapshotV1": {
+        "additionalProperties": false,
+        "properties": {
+          "authority": {
+            "$ref": "#/components/schemas/AccountAuthorityV1"
+          },
+          "capabilities": {
+            "$ref": "#/components/schemas/FinancialWorkspaceCapabilitiesV1"
+          },
+          "contractVersion": {
+            "const": 1
+          },
+          "currentFacts": {
+            "additionalProperties": false,
+            "properties": {
+              "coverage": {
+                "$ref": "#/components/schemas/ProjectionCoverageV1"
+              },
+              "items": {
+                "items": {
+                  "$ref": "#/components/schemas/FinancialFactProjectionV1"
+                },
+                "maxItems": 9,
+                "type": "array"
+              }
+            },
+            "required": [
+              "items",
+              "coverage"
+            ],
+            "type": "object"
+          },
+          "cursor": {
+            "maxLength": 2048,
+            "minLength": 1,
+            "type": "string"
+          },
+          "kind": {
+            "const": "financial_workspace_snapshot.v1"
+          },
+          "projectionVersion": {
+            "const": 1
+          },
+          "updatedAt": {
+            "format": "date-time",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$",
+            "type": "string"
+          },
+          "version": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "kind",
+          "authority",
+          "contractVersion",
+          "projectionVersion",
+          "version",
+          "updatedAt",
+          "cursor",
+          "capabilities",
+          "currentFacts"
+        ],
+        "type": "object"
+      },
+      "FinancialWorkspaceSummaryV1": {
+        "additionalProperties": false,
+        "properties": {
+          "authority": {
+            "$ref": "#/components/schemas/AccountAuthorityV1"
+          },
+          "capabilities": {
+            "$ref": "#/components/schemas/FinancialWorkspaceCapabilitiesV1"
+          },
+          "contractVersion": {
+            "const": 1
+          },
+          "currentFacts": {
+            "$ref": "#/components/schemas/ProjectionCoverageV1"
+          },
+          "cursor": {
+            "maxLength": 2048,
+            "minLength": 1,
+            "type": "string"
+          },
+          "kind": {
+            "const": "financial_workspace_summary.v1"
+          },
+          "projectionVersion": {
+            "const": 1
+          },
+          "updatedAt": {
+            "format": "date-time",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$",
+            "type": "string"
+          },
+          "version": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "kind",
+          "authority",
+          "contractVersion",
+          "projectionVersion",
+          "version",
+          "updatedAt",
+          "cursor",
+          "capabilities",
+          "currentFacts"
+        ],
+        "type": "object"
+      },
+      "FinancialWorkspaceWorkspaceRefV1": {
+        "additionalProperties": false,
+        "properties": {
+          "kind": {
+            "const": "financial_workspace_workspace_ref.v1"
+          },
+          "storeId": {
+            "maxLength": 200,
+            "minLength": 1,
+            "type": "string"
+          }
+        },
+        "required": [
+          "kind",
+          "storeId"
+        ],
+        "type": "object"
+      },
+      "InitializeFinancialWorkspaceCommandV1": {
+        "additionalProperties": false,
+        "properties": {
+          "idempotencyKey": {
+            "maxLength": 200,
+            "minLength": 1,
+            "type": "string"
+          },
+          "kind": {
+            "const": "financial_workspace_initialize_command.v1"
+          }
+        },
+        "required": [
+          "kind",
+          "idempotencyKey"
+        ],
+        "type": "object"
+      },
+      "NormalizedFinancialWorkspaceFactRecordCommandV1": {
+        "additionalProperties": false,
+        "properties": {
+          "asOf": {
+            "oneOf": [
+              {
+                "type": "null"
+              },
+              {
+                "format": "date-time",
+                "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$",
+                "type": "string"
+              }
+            ]
+          },
+          "expectedVersion": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "field": {
+            "enum": [
+              "household.total_assets",
+              "household.long_term_allocatable_assets",
+              "household.spending.last_12_months",
+              "household.spending.last_12_months.necessary",
+              "household.spending.last_12_months.discretionary",
+              "household.monthly_contribution",
+              "household.liquid_assets",
+              "household.investments.total",
+              "household.total_debt"
+            ],
+            "type": "string"
+          },
+          "idempotencyKey": {
+            "maxLength": 200,
+            "minLength": 1,
+            "type": "string"
+          },
+          "kind": {
+            "const": "financial_workspace_fact_record_command.v1"
+          },
+          "status": {
+            "enum": [
+              "confirmed",
+              "estimated"
+            ]
+          },
+          "value": {
+            "$ref": "#/components/schemas/FinancialTypedValueV1"
+          }
+        },
+        "required": [
+          "kind",
+          "expectedVersion",
+          "idempotencyKey",
+          "field",
+          "value",
+          "status",
+          "asOf"
+        ],
+        "type": "object"
+      },
+      "ObjectRefV1": {
+        "oneOf": [
+          {
+            "$ref": "#/components/schemas/FinancialWorkspaceWorkspaceRefV1"
+          },
+          {
+            "$ref": "#/components/schemas/FinancialWorkspaceFactRefV1"
+          }
+        ]
+      },
+      "OperationProjectionV1": {
+        "additionalProperties": false,
+        "properties": {
+          "affectedObjects": {
+            "items": {
+              "oneOf": [
+                {
+                  "$ref": "#/components/schemas/FinancialWorkspaceWorkspaceRefV1"
+                },
+                {
+                  "$ref": "#/components/schemas/FinancialWorkspaceFactRefV1"
+                }
+              ]
+            },
+            "maxItems": 2,
+            "minItems": 1,
+            "type": "array",
+            "uniqueItems": true
+          },
+          "baseVersion": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "channel": {
+            "enum": [
+              "web",
+              "cli"
+            ]
+          },
+          "committedAt": {
+            "format": "date-time",
+            "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}\\.\\d{3}Z$",
+            "type": "string"
+          },
+          "kind": {
+            "const": "financial_workspace_operation.v1"
+          },
+          "operation": {
+            "enum": [
+              "workspace.initialize",
+              "fact.record"
+            ]
+          },
+          "operationId": {
+            "maxLength": 200,
+            "minLength": 1,
+            "type": "string"
+          },
+          "primaryObject": {
+            "oneOf": [
+              {
+                "$ref": "#/components/schemas/FinancialWorkspaceWorkspaceRefV1"
+              },
+              {
+                "$ref": "#/components/schemas/FinancialWorkspaceFactRefV1"
+              }
+            ]
+          },
+          "resultVersion": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "kind",
+          "operationId",
+          "operation",
+          "channel",
+          "baseVersion",
+          "resultVersion",
+          "committedAt",
+          "primaryObject",
+          "affectedObjects"
+        ],
+        "type": "object"
+      },
+      "ProjectionCoverageV1": {
+        "additionalProperties": false,
+        "properties": {
+          "kind": {
+            "const": "financial_workspace_fact_coverage.v1"
+          },
+          "missingFields": {
+            "items": {
+              "enum": [
+                "household.total_assets",
+                "household.long_term_allocatable_assets",
+                "household.spending.last_12_months",
+                "household.spending.last_12_months.necessary",
+                "household.spending.last_12_months.discretionary",
+                "household.monthly_contribution",
+                "household.liquid_assets",
+                "household.investments.total",
+                "household.total_debt"
+              ],
+              "type": "string"
+            },
+            "maxItems": 9,
+            "type": "array",
+            "uniqueItems": true
+          },
+          "recordedFields": {
+            "items": {
+              "enum": [
+                "household.total_assets",
+                "household.long_term_allocatable_assets",
+                "household.spending.last_12_months",
+                "household.spending.last_12_months.necessary",
+                "household.spending.last_12_months.discretionary",
+                "household.monthly_contribution",
+                "household.liquid_assets",
+                "household.investments.total",
+                "household.total_debt"
+              ],
+              "type": "string"
+            },
+            "maxItems": 9,
+            "type": "array",
+            "uniqueItems": true
+          },
+          "supportedFields": {
+            "const": [
+              "household.total_assets",
+              "household.long_term_allocatable_assets",
+              "household.spending.last_12_months",
+              "household.spending.last_12_months.necessary",
+              "household.spending.last_12_months.discretionary",
+              "household.monthly_contribution",
+              "household.liquid_assets",
+              "household.investments.total",
+              "household.total_debt"
+            ]
+          }
+        },
+        "required": [
+          "kind",
+          "supportedFields",
+          "recordedFields",
+          "missingFields"
+        ],
+        "type": "object"
+      },
+      "SuccessEnvelopeFinancialWorkspaceActivityPageV1": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "const": 0
+          },
+          "data": {
+            "$ref": "#/components/schemas/FinancialWorkspaceActivityPageV1"
+          },
+          "status": {
+            "const": "success"
+          },
+          "success": {
+            "const": true
+          }
+        },
+        "required": [
+          "code",
+          "success",
+          "status",
+          "data"
+        ],
+        "type": "object"
+      },
+      "SuccessEnvelopeFinancialWorkspaceCommandReceiptV1": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "const": 0
+          },
+          "data": {
+            "$ref": "#/components/schemas/FinancialWorkspaceCommandReceiptV1"
+          },
+          "status": {
+            "const": "success"
+          },
+          "success": {
+            "const": true
+          }
+        },
+        "required": [
+          "code",
+          "success",
+          "status",
+          "data"
+        ],
+        "type": "object"
+      },
+      "SuccessEnvelopeFinancialWorkspaceSnapshotV1": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "const": 0
+          },
+          "data": {
+            "$ref": "#/components/schemas/FinancialWorkspaceSnapshotV1"
+          },
+          "status": {
+            "const": "success"
+          },
+          "success": {
+            "const": true
+          }
+        },
+        "required": [
+          "code",
+          "success",
+          "status",
+          "data"
+        ],
+        "type": "object"
+      },
+      "SuccessEnvelopeFinancialWorkspaceSummaryV1": {
+        "additionalProperties": false,
+        "properties": {
+          "code": {
+            "const": 0
+          },
+          "data": {
+            "$ref": "#/components/schemas/FinancialWorkspaceSummaryV1"
+          },
+          "status": {
+            "const": "success"
+          },
+          "success": {
+            "const": true
+          }
+        },
+        "required": [
+          "code",
+          "success",
+          "status",
+          "data"
+        ],
+        "type": "object"
+      },
+      "TransactionRetryableErrorDataV1": {
+        "additionalProperties": false,
+        "properties": {
+          "retryAfterMs": {
+            "maximum": 30000,
+            "minimum": 100,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "retryAfterMs"
+        ],
+        "type": "object"
+      },
+      "VersionConflictErrorDataV1": {
+        "additionalProperties": false,
+        "properties": {
+          "currentCursor": {
+            "maxLength": 2048,
+            "minLength": 1,
+            "type": "string"
+          },
+          "currentVersion": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "currentVersion",
+          "currentCursor"
+        ],
+        "type": "object"
+      }
+    },
+    "securitySchemes": {
+      "choosefireWorkspaceBearer": {
+        "bearerFormat": "JWT",
+        "scheme": "bearer",
+        "type": "http"
+      }
+    }
+  },
+  "info": {
+    "title": "ChooseFIRE Financial Workspace API",
+    "version": "1.0.0"
+  },
+  "openapi": "3.1.0",
+  "paths": {
+    "/choosefire/financial-workspace": {
+      "get": {
+        "operationId": "getFinancialWorkspaceSnapshot",
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SuccessEnvelopeFinancialWorkspaceSnapshotV1"
+                }
+              }
+            },
+            "description": "Successful financial workspace response."
+          },
+          "400": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope400V1"
+                }
+              }
+            },
+            "description": "Invalid request."
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope401V1"
+                }
+              }
+            },
+            "description": "Workspace authentication is required."
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope403V1"
+                }
+              }
+            },
+            "description": "Required account scope is missing."
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope404V1"
+                }
+              }
+            },
+            "description": "Financial workspace is not initialized."
+          },
+          "503": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope503V1"
+                }
+              }
+            },
+            "description": "Financial workspace is unavailable."
+          }
+        },
+        "security": [
+          {
+            "choosefireWorkspaceBearer": []
+          }
+        ],
+        "x-choosefire-required-scope": "workspace:read"
+      },
+      "post": {
+        "operationId": "initializeFinancialWorkspace",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/InitializeFinancialWorkspaceCommandV1"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SuccessEnvelopeFinancialWorkspaceCommandReceiptV1"
+                }
+              }
+            },
+            "description": "Successful financial workspace response."
+          },
+          "400": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope400V1"
+                }
+              }
+            },
+            "description": "Invalid request."
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope401V1"
+                }
+              }
+            },
+            "description": "Workspace authentication is required."
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope403V1"
+                }
+              }
+            },
+            "description": "Required account scope is missing."
+          },
+          "409": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope409V1"
+                }
+              }
+            },
+            "description": "Initialization or idempotency conflict."
+          },
+          "413": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope413V1"
+                }
+              }
+            },
+            "description": "Request payload is too large."
+          },
+          "415": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope415V1"
+                }
+              }
+            },
+            "description": "Request media type is unsupported."
+          },
+          "503": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope503V1"
+                }
+              }
+            },
+            "description": "Financial workspace is unavailable."
+          }
+        },
+        "security": [
+          {
+            "choosefireWorkspaceBearer": []
+          }
+        ],
+        "x-choosefire-required-scope": "workspace:initialize"
+      }
+    },
+    "/choosefire/financial-workspace/activity": {
+      "get": {
+        "operationId": "listFinancialWorkspaceActivity",
+        "parameters": [
+          {
+            "in": "query",
+            "name": "limit",
+            "required": true,
+            "schema": {
+              "maximum": 100,
+              "minimum": 1,
+              "type": "integer"
+            }
+          },
+          {
+            "in": "query",
+            "name": "cursor",
+            "required": false,
+            "schema": {
+              "maxLength": 2048,
+              "minLength": 1,
+              "type": "string"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SuccessEnvelopeFinancialWorkspaceActivityPageV1"
+                }
+              }
+            },
+            "description": "Successful financial workspace response."
+          },
+          "400": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope400V1"
+                }
+              }
+            },
+            "description": "Invalid activity query or cursor."
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope401V1"
+                }
+              }
+            },
+            "description": "Workspace authentication is required."
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope403V1"
+                }
+              }
+            },
+            "description": "Required account scope is missing."
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope404V1"
+                }
+              }
+            },
+            "description": "Financial workspace is not initialized."
+          },
+          "409": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope409V1"
+                }
+              }
+            },
+            "description": "Cursor authority does not match."
+          },
+          "410": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope410V1"
+                }
+              }
+            },
+            "description": "Cursor is expired."
+          },
+          "503": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope503V1"
+                }
+              }
+            },
+            "description": "Financial workspace is unavailable."
+          }
+        },
+        "security": [
+          {
+            "choosefireWorkspaceBearer": []
+          }
+        ],
+        "x-choosefire-required-scope": "workspace:read"
+      }
+    },
+    "/choosefire/financial-workspace/facts": {
+      "post": {
+        "operationId": "recordFinancialWorkspaceFact",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/FinancialWorkspaceFactRecordCommandV1"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SuccessEnvelopeFinancialWorkspaceCommandReceiptV1"
+                }
+              }
+            },
+            "description": "Successful financial workspace response."
+          },
+          "400": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope400V1"
+                }
+              }
+            },
+            "description": "Invalid fact command."
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope401V1"
+                }
+              }
+            },
+            "description": "Workspace authentication is required."
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope403V1"
+                }
+              }
+            },
+            "description": "Required account scope is missing."
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope404V1"
+                }
+              }
+            },
+            "description": "Financial workspace is not initialized."
+          },
+          "409": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope409V1"
+                }
+              }
+            },
+            "description": "Version, idempotency, or protected fact conflict."
+          },
+          "413": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope413V1"
+                }
+              }
+            },
+            "description": "Request payload is too large."
+          },
+          "415": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope415V1"
+                }
+              }
+            },
+            "description": "Request media type is unsupported."
+          },
+          "503": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope503V1"
+                }
+              }
+            },
+            "description": "Financial workspace is unavailable."
+          }
+        },
+        "security": [
+          {
+            "choosefireWorkspaceBearer": []
+          }
+        ],
+        "x-choosefire-required-scope": "workspace:write:fact"
+      }
+    },
+    "/choosefire/financial-workspace/summary": {
+      "get": {
+        "operationId": "getFinancialWorkspaceSummary",
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/SuccessEnvelopeFinancialWorkspaceSummaryV1"
+                }
+              }
+            },
+            "description": "Successful financial workspace response."
+          },
+          "400": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope400V1"
+                }
+              }
+            },
+            "description": "Invalid request."
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope401V1"
+                }
+              }
+            },
+            "description": "Workspace authentication is required."
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope403V1"
+                }
+              }
+            },
+            "description": "Required account scope is missing."
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope404V1"
+                }
+              }
+            },
+            "description": "Financial workspace is not initialized."
+          },
+          "503": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorEnvelope503V1"
+                }
+              }
+            },
+            "description": "Financial workspace is unavailable."
+          }
+        },
+        "security": [
+          {
+            "choosefireWorkspaceBearer": []
+          }
+        ],
+        "x-choosefire-required-scope": "workspace:read"
+      }
+    }
+  },
+  "x-choosefire-contract-id": "choosefire-financial-workspace.v1",
+  "x-choosefire-contract-version": 1,
+  "x-choosefire-field-registry-sha256": "3ecc94b8fee854c4a1012a79de1216007191c853b62fbf99641a1f9aadde2b16"
+}