@yigemo/choosefire 0.1.0

package/contracts/choosefire-financial-workspace/v1/runtime-schemas/financial-workspace.v1.schema.json

@@ -0,0 +1,1496 @@
+{
+  "$defs": {
+    "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": "#/$defs/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": "#/$defs/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": "#/$defs/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": "#/$defs/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": "#/$defs/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": "#/$defs/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": "#/$defs/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": "#/$defs/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": "#/$defs/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": "#/$defs/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": "#/$defs/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": "#/$defs/ErrorEnvelope400V1"
+        },
+        {
+          "$ref": "#/$defs/ErrorEnvelope401V1"
+        },
+        {
+          "$ref": "#/$defs/ErrorEnvelope403V1"
+        },
+        {
+          "$ref": "#/$defs/ErrorEnvelope404V1"
+        },
+        {
+          "$ref": "#/$defs/ErrorEnvelope409V1"
+        },
+        {
+          "$ref": "#/$defs/ErrorEnvelope410V1"
+        },
+        {
+          "$ref": "#/$defs/ErrorEnvelope413V1"
+        },
+        {
+          "$ref": "#/$defs/ErrorEnvelope415V1"
+        },
+        {
+          "$ref": "#/$defs/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": "#/$defs/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": "#/$defs/AccountAuthorityV1"
+        },
+        "contractVersion": {
+          "const": 1
+        },
+        "hasMore": {
+          "type": "boolean"
+        },
+        "items": {
+          "items": {
+            "$ref": "#/$defs/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": "#/$defs/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": "#/$defs/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": "#/$defs/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": "#/$defs/AccountAuthorityV1"
+        },
+        "capabilities": {
+          "$ref": "#/$defs/FinancialWorkspaceCapabilitiesV1"
+        },
+        "contractVersion": {
+          "const": 1
+        },
+        "currentFacts": {
+          "additionalProperties": false,
+          "properties": {
+            "coverage": {
+              "$ref": "#/$defs/ProjectionCoverageV1"
+            },
+            "items": {
+              "items": {
+                "$ref": "#/$defs/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": "#/$defs/AccountAuthorityV1"
+        },
+        "capabilities": {
+          "$ref": "#/$defs/FinancialWorkspaceCapabilitiesV1"
+        },
+        "contractVersion": {
+          "const": 1
+        },
+        "currentFacts": {
+          "$ref": "#/$defs/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": "#/$defs/FinancialTypedValueV1"
+        }
+      },
+      "required": [
+        "kind",
+        "expectedVersion",
+        "idempotencyKey",
+        "field",
+        "value",
+        "status",
+        "asOf"
+      ],
+      "type": "object"
+    },
+    "ObjectRefV1": {
+      "oneOf": [
+        {
+          "$ref": "#/$defs/FinancialWorkspaceWorkspaceRefV1"
+        },
+        {
+          "$ref": "#/$defs/FinancialWorkspaceFactRefV1"
+        }
+      ]
+    },
+    "OperationProjectionV1": {
+      "additionalProperties": false,
+      "properties": {
+        "affectedObjects": {
+          "items": {
+            "oneOf": [
+              {
+                "$ref": "#/$defs/FinancialWorkspaceWorkspaceRefV1"
+              },
+              {
+                "$ref": "#/$defs/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": "#/$defs/FinancialWorkspaceWorkspaceRefV1"
+            },
+            {
+              "$ref": "#/$defs/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": "#/$defs/FinancialWorkspaceActivityPageV1"
+        },
+        "status": {
+          "const": "success"
+        },
+        "success": {
+          "const": true
+        }
+      },
+      "required": [
+        "code",
+        "success",
+        "status",
+        "data"
+      ],
+      "type": "object"
+    },
+    "SuccessEnvelopeFinancialWorkspaceCommandReceiptV1": {
+      "additionalProperties": false,
+      "properties": {
+        "code": {
+          "const": 0
+        },
+        "data": {
+          "$ref": "#/$defs/FinancialWorkspaceCommandReceiptV1"
+        },
+        "status": {
+          "const": "success"
+        },
+        "success": {
+          "const": true
+        }
+      },
+      "required": [
+        "code",
+        "success",
+        "status",
+        "data"
+      ],
+      "type": "object"
+    },
+    "SuccessEnvelopeFinancialWorkspaceSnapshotV1": {
+      "additionalProperties": false,
+      "properties": {
+        "code": {
+          "const": 0
+        },
+        "data": {
+          "$ref": "#/$defs/FinancialWorkspaceSnapshotV1"
+        },
+        "status": {
+          "const": "success"
+        },
+        "success": {
+          "const": true
+        }
+      },
+      "required": [
+        "code",
+        "success",
+        "status",
+        "data"
+      ],
+      "type": "object"
+    },
+    "SuccessEnvelopeFinancialWorkspaceSummaryV1": {
+      "additionalProperties": false,
+      "properties": {
+        "code": {
+          "const": 0
+        },
+        "data": {
+          "$ref": "#/$defs/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"
+    }
+  },
+  "$id": "https://choosefire.com/contracts/choosefire-financial-workspace/v1/financial-workspace.v1.schema.json",
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "title": "ChooseFIRE Financial Workspace Contract v1"
+}