@firela/api-types 0.0.0-canary.69a6df79 → 0.0.0-canary.6af2ffd3

package/src/generated/schemas.gen.ts

@@ -51,6 +51,14 @@ export const $CreateAccountDto = {
       description: 'Icon identifier (overrides template)',
       example: 'bank-custom'
     },
+    displayName: {
+      type: 'string',
+      description:
+        'User-set display name override (omit/null = keep the derived name)',
+      nullable: true,
+      maxLength: 50,
+      example: 'Salary card'
+    },
     openDirectiveMeta: {
       type: 'object',
       description:
@@ -181,7 +189,8 @@ export const $AccountResponseDto = {
     },
     displayName: {
       type: 'string',
-      description: 'Localized display name (ADR-0114, read-time projection)',
+      description:
+        'Display name with precedence: user-set name (#762) > ADR-0114 localized name > path leaf (read-time projection)',
       example: 'Checking'
     },
     icon: {
@@ -197,7 +206,7 @@ export const $AccountResponseDto = {
       }
     },
     platformId: {
-      type: 'object',
+      type: 'string',
       description: 'Platform ID (null if unbound)',
       example: 'c98e5d4a-2f71-4a5a-bb3c-92c9f231d5e2'
     },
@@ -277,6 +286,14 @@ export const $UpdateAccountDto = {
       description: 'Icon identifier',
       example: 'bank-custom'
     },
+    displayName: {
+      type: 'string',
+      description:
+        'User-set display name override (null = clear the override and fall back to the derived name, omit = unchanged)',
+      nullable: true,
+      maxLength: 50,
+      example: 'Salary card'
+    },
     openDirectiveMeta: {
       type: 'object',
       description:
@@ -377,16 +394,43 @@ export const $AccountStandardResponseDto = {
     },
     name: {
       type: 'string',
-      description: 'Short localized display name',
+      description:
+        'Short display name. Universal rows project to the request locale (Accept-Language); regional rows keep the authored native name — mixed-language by design (ADR-0131 class P vs class A).',
       example: 'Housing Fund'
     },
+    aliases: {
+      description:
+        'Authored market-language alternative names delivered verbatim (not localized copy, not xlf-managed, not locale-projected). Flat string[] per ADR-0129 D1; ADR-0131 class A.',
+      example: ['Alipay', 'WeChat Pay'],
+      type: 'array',
+      items: {
+        type: 'string'
+      }
+    },
+    searchTerms: {
+      description:
+        'Locale-projected search synonyms (e.g. the zh bank-card / debit-card everyday terms for the checking account). Pure-locale projection — absent when the locale has no seeded synonyms; English fallback rides the authored aliases field. Search-only vocabulary, not the NLP routing corpus (#698, ADR-0131 fourth-class adjudication).',
+      example: ['yinhangka', 'jiejika'],
+      type: 'array',
+      items: {
+        type: 'string'
+      }
+    },
+    currency: {
+      type: 'string',
+      description:
+        'Product denomination as a 3-letter ISO 4217 code, authored market data delivered verbatim (not localized, not xlf-managed). ADR-0131 class A. Absent = single-currency not asserted — consumers fall back to their own region currency (#714).',
+      example: 'HKD'
+    },
     description: {
       type: 'string',
-      description: 'Account description (stable semantics only)',
+      description:
+        'Account description (stable semantics only). Mixed-language contract: universal rows project to the request locale via the accountDesc xlf axis with an en fallback (ADR-0131 class P, ADR-0132; unseeded locales falling back to English are expected); regional rows deliver the authored market language (ADR-0131 class A, verbatim, never xlf-managed).',
       example: 'ICBC checking account for daily transactions'
     },
     tags: {
-      description: 'Account tags for categorization',
+      description:
+        'Account tags for categorization — structured metadata delivered verbatim (not localized, not xlf-managed). ADR-0131 class A.',
       example: ['bank', 'checking', 'primary'],
       type: 'array',
       items: {
@@ -498,7 +542,10 @@ export const $RegionConfigDto = {
     },
     locale: {
       type: 'string',
-      example: 'de-DE'
+      example: 'de-DE',
+      pattern: '^[a-z]{2,8}-[A-Z]{2}$',
+      description:
+        "Region-qualified BCP-47 tag whose region subtag equals the region's own ISO 3166-1 code (e.g., ja-JP, zh-CN, zh-HK)"
     }
   },
   required: ['currency', 'dateFormat', 'locale']
@@ -511,6 +558,12 @@ export const $RegionInfoDto = {
       type: 'string',
       example: 'de'
     },
+    open: {
+      type: 'boolean',
+      example: true,
+      description:
+        'Whether the region is open (has a ready regional account template). Not-yet-open regions still return identity metadata and degrade to the universal-only catalog.'
+    },
     displayName: {
       type: 'string',
       example: 'Germany'
@@ -529,7 +582,7 @@ export const $RegionInfoDto = {
       $ref: '#/components/schemas/RegionConfigDto'
     }
   },
-  required: ['code', 'displayName', 'chain', 'config']
+  required: ['code', 'open', 'displayName', 'chain', 'config']
 } as const;
 
 export const $RegionsMetadataResponseDto = {
@@ -1951,13 +2004,17 @@ export const $ReviewStatsDto = {
       type: 'object',
       description: 'Count by type'
     },
+    resolved: {
+      type: 'number',
+      description: 'Current count of reviews in RESOLVED status'
+    },
     oldestPending: {
       format: 'date-time',
       type: 'string',
       description: 'Oldest pending review date'
     }
   },
-  required: ['total', 'byType']
+  required: ['total', 'byType', 'resolved']
 } as const;
 
 export const $DecisionOptionDto = {
@@ -2510,10 +2567,10 @@ export const $UpdatePayeeDto = {
     meta: {
       type: 'object',
       description:
-        'Metadata for extended information (location, notes, contact info, etc.). Will merge with existing metadata.',
+        'Metadata for extended information (location, notes, contact info, etc.)',
       example: {
         location: 'Zhongguancun',
-        note: 'Updated note',
+        note: 'Near subway station',
         favorite: true
       }
     },
@@ -3074,568 +3131,660 @@ export const $UpdateCommodityDto = {
   }
 } as const;
 
-export const $CreateBeanPriceDto = {
+export const $CurrencyBalanceDto = {
   type: 'object',
   properties: {
     currency: {
       type: 'string',
-      description: 'Currency being priced (e.g., USD, AAPL, BTC)',
-      example: 'USD'
-    },
-    quoteCurrency: {
-      type: 'string',
-      description: 'Quote currency (pricing currency, e.g., CNY, EUR)',
+      description: 'ISO 4217 currency code',
       example: 'CNY'
     },
-    amount: {
-      type: 'number',
-      description:
-        'Price amount (MUST be >= 0 per Beancount spec, supports up to 15 decimal places). Zero allowed for conversion entries, negative strictly prohibited.',
-      example: 175.5,
-      minimum: 0
-    },
-    date: {
+    balance: {
       type: 'string',
-      description: 'Price date (ISO 8601 format)',
-      example: '2024-11-05'
-    },
-    metadata: {
-      type: 'object',
-      description:
-        'Metadata (validated by Zod schema, max field lengths enforced)',
-      example: {
-        source: 'MANUAL',
-        note: 'Bank valuation report',
-        confidence: 0.95
-      }
+      description: 'Balance amount',
+      example: '500000.00'
     }
   },
-  required: ['currency', 'quoteCurrency', 'amount', 'date']
+  required: ['currency', 'balance']
 } as const;
 
-export const $PriceResponseDto = {
+export const $TimeSeriesPointDto = {
   type: 'object',
   properties: {
-    id: {
+    date: {
       type: 'string',
-      description: 'Unique identifier',
-      example: 'uuid-123-456'
+      description: 'Date in YYYY-MM-DD format',
+      example: '2024-06-15'
     },
-    userId: {
+    value: {
       type: 'string',
-      description: 'User ID (owner of the price)',
-      example: 'user-123'
+      description: 'Value at this date (in base currency)',
+      example: '500000.00'
     },
-    currency: {
+    change: {
       type: 'string',
-      description: 'Currency being priced (e.g., USD, AAPL, BTC)',
-      example: 'BTC'
+      description: 'Change from previous point',
+      example: '5000.00'
     },
-    quoteCurrency: {
+    assets: {
       type: 'string',
-      description: 'Quote currency (pricing currency, e.g., USD, CNY)',
-      example: 'USD'
-    },
-    amount: {
-      type: 'number',
-      description:
-        'Price amount (corresponds to Beancount Amount.number). Supports up to 15 decimal places.',
-      example: 50000
+      description: 'Total assets at this date (in base currency)',
+      example: '494338.00'
     },
-    date: {
+    liabilities: {
       type: 'string',
-      description:
-        'Price date (ISO 8601 format). Represents the date this price was valid.',
-      example: '2024-01-01',
-      format: 'date'
+      description: 'Total liabilities at this date (in base currency)',
+      example: '310098.00'
     },
-    meta: {
-      type: 'object',
-      description:
-        'Metadata (corresponds to Beancount meta field). Contains source, confidence, note, etc.',
-      example: {
-        source: 'MANUAL',
-        note: 'User-defined price',
-        confidence: 1
+    byCurrency: {
+      description: 'Multi-currency breakdown for this point',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/CurrencyBalanceDto'
       }
+    }
+  },
+  required: ['date', 'value']
+} as const;
+
+export const $TrendSummaryDto = {
+  type: 'object',
+  properties: {
+    startValue: {
+      type: 'string',
+      description: 'Value at start of period',
+      example: '450000.00'
     },
-    createdAt: {
-      format: 'date-time',
+    endValue: {
       type: 'string',
-      description: 'Creation timestamp',
-      example: '2024-11-03T10:00:00Z'
+      description: 'Value at end of period',
+      example: '500000.00'
     },
-    updatedAt: {
-      format: 'date-time',
+    totalChange: {
       type: 'string',
-      description: 'Last update timestamp',
-      example: '2024-11-03T10:00:00Z'
+      description: 'Total change over period',
+      example: '50000.00'
+    },
+    totalChangePercentage: {
+      type: 'string',
+      description: 'Total change percentage',
+      example: '+11.11%'
     }
   },
-  required: [
-    'id',
-    'userId',
-    'currency',
-    'quoteCurrency',
-    'amount',
-    'date',
-    'meta',
-    'createdAt',
-    'updatedAt'
-  ]
+  required: ['startValue', 'endValue', 'totalChange', 'totalChangePercentage']
 } as const;
 
-export const $PriceListResponseDto = {
+export const $MultiCurrencyPointDto = {
   type: 'object',
   properties: {
-    items: {
-      description: 'List of prices',
+    date: {
+      type: 'string',
+      description: 'Date in YYYY-MM-DD format',
+      example: '2024-06-15'
+    },
+    byCurrency: {
+      description: 'Balances by currency',
       type: 'array',
       items: {
-        $ref: '#/components/schemas/PriceResponseDto'
+        $ref: '#/components/schemas/CurrencyBalanceDto'
       }
-    },
-    total: {
-      type: 'number',
-      description: 'Total number of prices',
-      example: 42
     }
   },
-  required: ['items', 'total']
+  required: ['date', 'byCurrency']
 } as const;
 
-export const $UpdateBeanPriceDto = {
+export const $PortfolioTrendsResponseDto = {
   type: 'object',
   properties: {
-    currency: {
-      type: 'string',
-      description: 'Currency being priced'
+    series: {
+      description: 'Time series data points',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/TimeSeriesPointDto'
+      }
     },
-    quoteCurrency: {
+    summary: {
+      description: 'Period summary',
+      allOf: [
+        {
+          $ref: '#/components/schemas/TrendSummaryDto'
+        }
+      ]
+    },
+    period: {
       type: 'string',
-      description: 'Quote currency (pricing currency)'
+      description: 'Period requested',
+      example: '6m'
     },
-    amount: {
-      type: 'number',
-      description: 'Price amount (MUST be >= 0 per Beancount spec)',
-      minimum: 0
+    granularity: {
+      type: 'string',
+      description: 'Data granularity',
+      example: 'month'
     },
-    date: {
+    currency: {
       type: 'string',
-      description: 'Price date (ISO 8601 format)'
+      description: 'Base currency for converted values',
+      example: 'CNY'
     },
-    metadata: {
-      type: 'object',
-      description: 'Metadata'
+    byCurrency: {
+      description:
+        'Multi-currency time series (each point has currency breakdown)',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/MultiCurrencyPointDto'
+      }
+    },
+    warnings: {
+      description: 'Exchange rate warnings',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/ExchangeRateWarningDto'
+      }
     }
-  }
+  },
+  required: ['series', 'summary', 'period', 'granularity', 'currency']
 } as const;
 
-export const $CreateRecurringRuleDto = {
+export const $CashFlowPointDto = {
   type: 'object',
   properties: {
-    name: {
+    month: {
       type: 'string',
-      description: 'Rule name (unique per user)',
-      maxLength: 100
-    },
-    icon: {
-      type: 'string',
-      description: 'Icon emoji',
-      maxLength: 10
+      description: 'Month key (YYYY-MM)',
+      example: '2024-03'
     },
-    frequency: {
+    income: {
       type: 'string',
-      description: 'Recurring frequency',
-      enum: [
-        'WEEKLY',
-        'BIWEEKLY',
-        'MONTHLY',
-        'BIMONTHLY',
-        'QUARTERLY',
-        'YEARLY',
-        'CUSTOM'
-      ]
+      description: 'Income in base currency (absolute, converted)',
+      example: '10000.00'
     },
-    expectedAmount: {
-      type: 'number',
-      description: 'Expected amount (positive number)',
-      minimum: 0
+    expense: {
+      type: 'string',
+      description: 'Expense in base currency (absolute, converted)',
+      example: '5000.00'
     },
-    expectedDay: {
-      type: 'number',
-      description: 'Expected day of month (1-31)',
-      minimum: 1,
-      maximum: 31
+    netSavings: {
+      type: 'string',
+      description: 'netSavings = income − expense (savings positive)',
+      example: '5000.00'
+    }
+  },
+  required: ['month', 'income', 'expense', 'netSavings']
+} as const;
+
+export const $CashFlowTrendSummaryDto = {
+  type: 'object',
+  properties: {
+    totalIncome: {
+      type: 'string',
+      description: 'Total income across the period',
+      example: '60000.00'
     },
-    customIntervalDays: {
-      type: 'number',
-      description: 'Custom interval in days (required for CUSTOM frequency)',
-      minimum: 1
+    totalExpense: {
+      type: 'string',
+      description: 'Total expense across the period',
+      example: '30000.00'
     },
-    currency: {
+    totalNetSavings: {
       type: 'string',
-      description: 'Currency code',
-      default: 'CNY',
-      maxLength: 10
+      description: 'income − expense across the period',
+      example: '30000.00'
     },
-    matchPayeePattern: {
+    averageMonthlyNetSavings: {
       type: 'string',
-      description: 'Payee matching pattern (supports wildcards)',
-      maxLength: 200
+      description:
+        'totalNetSavings divided by the window length (N months, incl. zero-filled)',
+      example: '5000.00'
+    }
+  },
+  required: [
+    'totalIncome',
+    'totalExpense',
+    'totalNetSavings',
+    'averageMonthlyNetSavings'
+  ]
+} as const;
+
+export const $CashFlowTrendsResponseDto = {
+  type: 'object',
+  properties: {
+    series: {
+      description:
+        'Monthly cash-flow series (fixed N-month window, zero-filled)',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/CashFlowPointDto'
+      }
     },
-    matchAmountTolerance: {
-      type: 'number',
-      description: 'Amount tolerance percentage (0-1)',
-      default: 0.075,
-      minimum: 0,
-      maximum: 1
+    summary: {
+      description: 'Period totals',
+      allOf: [
+        {
+          $ref: '#/components/schemas/CashFlowTrendSummaryDto'
+        }
+      ]
     },
-    defaultExpenseAccount: {
+    period: {
       type: 'string',
-      description: 'Default expense account for auto-create',
-      maxLength: 200
+      description: 'Period requested',
+      example: '6m'
     },
-    defaultPaymentAccount: {
+    granularity: {
       type: 'string',
-      description: 'Default payment account for auto-create',
-      maxLength: 200
+      description: 'Data granularity (v1 returns month buckets)',
+      example: 'month'
     },
-    defaultPayee: {
+    currency: {
       type: 'string',
-      description: 'Default payee for auto-create',
-      maxLength: 200
+      description: 'Base currency for converted values',
+      example: 'CNY'
     },
-    autoCreate: {
-      type: 'boolean',
-      description: 'Auto-create transaction when expected date arrives',
-      default: false
+    warnings: {
+      description: 'Exchange rate warnings (e.g. missing rate for a currency)',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/ExchangeRateWarningDto'
+      }
+    }
+  },
+  required: ['series', 'summary', 'period', 'granularity', 'currency']
+} as const;
+
+export const $GenerateSnapshotBody = {
+  type: 'object',
+  properties: {}
+} as const;
+
+export const $GenerateSnapshotResponse = {
+  type: 'object',
+  properties: {}
+} as const;
+
+export const $BackfillSnapshotsBody = {
+  type: 'object',
+  properties: {}
+} as const;
+
+export const $BackfillSnapshotsResponse = {
+  type: 'object',
+  properties: {}
+} as const;
+
+export const $CreateBeanPriceDto = {
+  type: 'object',
+  properties: {
+    currency: {
+      type: 'string',
+      description: 'Currency being priced (e.g., USD, AAPL, BTC)',
+      example: 'USD'
     },
-    startDate: {
+    quoteCurrency: {
       type: 'string',
-      description: 'Rule start date (ISO format)'
+      description: 'Quote currency (pricing currency, e.g., CNY, EUR)',
+      example: 'CNY'
     },
-    endDate: {
+    amount: {
+      type: 'number',
+      description:
+        'Price amount (MUST be >= 0 per Beancount spec, supports up to 15 decimal places). Zero allowed for conversion entries, negative strictly prohibited.',
+      example: 175.5,
+      minimum: 0
+    },
+    date: {
       type: 'string',
-      description: 'Rule end date (ISO format)'
+      description: 'Price date (ISO 8601 format)',
+      example: '2024-11-05'
+    },
+    metadata: {
+      type: 'object',
+      description:
+        'Metadata (validated by Zod schema, max field lengths enforced)',
+      example: {
+        source: 'MANUAL',
+        note: 'Bank valuation report',
+        confidence: 0.95
+      }
     }
   },
-  required: [
-    'name',
-    'frequency',
-    'expectedAmount',
-    'currency',
-    'matchAmountTolerance',
-    'autoCreate'
-  ]
+  required: ['currency', 'quoteCurrency', 'amount', 'date']
 } as const;
 
-export const $RecurringRuleResponseDto = {
+export const $PriceResponseDto = {
   type: 'object',
   properties: {
     id: {
       type: 'string',
-      description: 'Rule ID'
+      description: 'Unique identifier',
+      example: 'uuid-123-456'
     },
     userId: {
       type: 'string',
-      description: 'User ID'
+      description: 'User ID (owner of the price)',
+      example: 'user-123'
     },
-    name: {
+    currency: {
       type: 'string',
-      description: 'Rule name'
-    },
-    icon: {
-      type: 'object',
-      description: 'Icon emoji'
+      description: 'Currency being priced (e.g., USD, AAPL, BTC)',
+      example: 'BTC'
     },
-    frequency: {
+    quoteCurrency: {
       type: 'string',
-      description: 'Recurring frequency'
+      description: 'Quote currency (pricing currency, e.g., USD, CNY)',
+      example: 'USD'
     },
-    expectedAmount: {
+    amount: {
       type: 'number',
-      description: 'Expected amount'
+      description:
+        'Price amount (corresponds to Beancount Amount.number). Supports up to 15 decimal places.',
+      example: 50000
     },
-    expectedDay: {
-      type: 'object',
-      description: 'Expected day of month'
+    date: {
+      type: 'string',
+      description:
+        'Price date (ISO 8601 format). Represents the date this price was valid.',
+      example: '2024-01-01',
+      format: 'date'
     },
-    customIntervalDays: {
+    meta: {
       type: 'object',
-      description: 'Custom interval in days'
+      description:
+        'Metadata (corresponds to Beancount meta field). Contains source, confidence, note, etc.',
+      example: {
+        source: 'MANUAL',
+        note: 'User-defined price',
+        confidence: 1
+      }
     },
-    currency: {
+    createdAt: {
+      format: 'date-time',
       type: 'string',
-      description: 'Currency code'
-    },
-    matchPayeePattern: {
-      type: 'object',
-      description: 'Payee matching pattern'
-    },
-    matchAmountTolerance: {
-      type: 'number',
-      description: 'Amount tolerance percentage'
-    },
-    defaultExpenseAccount: {
-      type: 'object',
-      description: 'Default expense account'
-    },
-    defaultPaymentAccount: {
-      type: 'object',
-      description: 'Default payment account'
-    },
-    defaultPayee: {
-      type: 'object',
-      description: 'Default payee'
-    },
-    isActive: {
-      type: 'boolean',
-      description: 'Whether rule is active'
-    },
-    startDate: {
-      type: 'string',
-      description: 'Rule start date (YYYY-MM-DD)'
-    },
-    endDate: {
-      type: 'object',
-      description: 'Rule end date (YYYY-MM-DD)'
-    },
-    autoCreate: {
-      type: 'boolean',
-      description: 'Auto-create transaction on expected date'
-    },
-    lastOccurrence: {
-      type: 'object',
-      description: 'Last matched occurrence date (YYYY-MM-DD)'
-    },
-    totalCount: {
-      type: 'number',
-      description: 'Total matched transactions count'
-    },
-    createdAt: {
-      format: 'date-time',
-      type: 'string',
-      description: 'Created at timestamp'
+      description: 'Creation timestamp',
+      example: '2024-11-03T10:00:00Z'
     },
     updatedAt: {
       format: 'date-time',
       type: 'string',
-      description: 'Updated at timestamp'
+      description: 'Last update timestamp',
+      example: '2024-11-03T10:00:00Z'
     }
   },
   required: [
     'id',
     'userId',
-    'name',
-    'frequency',
-    'expectedAmount',
     'currency',
-    'matchAmountTolerance',
-    'isActive',
-    'startDate',
-    'autoCreate',
-    'totalCount',
+    'quoteCurrency',
+    'amount',
+    'date',
+    'meta',
     'createdAt',
     'updatedAt'
   ]
 } as const;
 
-export const $CreateRuleFromTransactionDto = {
+export const $PriceListResponseDto = {
   type: 'object',
   properties: {
-    frequency: {
+    items: {
+      description: 'List of prices',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/PriceResponseDto'
+      }
+    },
+    total: {
+      type: 'number',
+      description: 'Total number of prices',
+      example: 42
+    }
+  },
+  required: ['items', 'total']
+} as const;
+
+export const $UpdateBeanPriceDto = {
+  type: 'object',
+  properties: {
+    currency: {
       type: 'string',
-      description: 'Recurring frequency',
-      enum: [
-        'WEEKLY',
-        'BIWEEKLY',
-        'MONTHLY',
-        'BIMONTHLY',
-        'QUARTERLY',
-        'YEARLY',
-        'CUSTOM'
-      ],
-      example: 'MONTHLY'
+      description: 'Currency being priced'
     },
-    name: {
+    quoteCurrency: {
       type: 'string',
-      description: 'Optional name override (default: transaction payee)',
-      maxLength: 100
+      description: 'Quote currency (pricing currency)'
     },
-    icon: {
+    amount: {
+      type: 'number',
+      description: 'Price amount (MUST be >= 0 per Beancount spec)',
+      minimum: 0
+    },
+    date: {
       type: 'string',
-      description: 'Optional icon emoji',
-      maxLength: 10
+      description: 'Price date (ISO 8601 format)'
+    },
+    metadata: {
+      type: 'object',
+      description: 'Metadata'
+    }
+  }
+} as const;
+
+export const $DeleteOwnUserDto = {
+  type: 'object',
+  properties: {
+    accessToken: {
+      type: 'string',
+      description: 'Access token for user verification',
+      example: 'abc123xyz'
     }
   },
-  required: ['frequency']
+  required: ['accessToken']
 } as const;
 
-export const $RecurringRuleWithStatsResponseDto = {
+export const $UserSettingsResponseDto = {
   type: 'object',
   properties: {
-    id: {
+    baseCurrency: {
       type: 'string',
-      description: 'Rule ID'
-    },
-    userId: {
+      description:
+        'Stored base currency choice (ISO 4217) for net-worth/report aggregation. null = user never chose; aggregates fall back to the region default at display time (#713).',
+      example: 'USD',
+      nullable: true
+    }
+  },
+  required: ['baseCurrency']
+} as const;
+
+export const $UserResponseDto = {
+  type: 'object',
+  properties: {
+    id: {
       type: 'string',
       description: 'User ID'
     },
-    name: {
+    role: {
       type: 'string',
-      description: 'Rule name'
+      description: 'Assigned user role'
     },
-    icon: {
-      type: 'object',
-      description: 'Icon emoji'
+    permissions: {
+      description: 'Permission strings',
+      type: 'array',
+      items: {
+        type: 'string'
+      }
     },
-    frequency: {
+    settings: {
+      description: 'User settings',
+      allOf: [
+        {
+          $ref: '#/components/schemas/UserSettingsResponseDto'
+        }
+      ]
+    }
+  },
+  required: ['id', 'role', 'permissions', 'settings']
+} as const;
+
+export const $SignupDto = {
+  type: 'object',
+  properties: {
+    turnstileToken: {
       type: 'string',
-      description: 'Recurring frequency'
+      description:
+        'Cloudflare Turnstile verification token (optional when Turnstile disabled)',
+      example: '0.abc123def456...'
+    }
+  }
+} as const;
+
+export const $SignupResponseDto = {
+  type: 'object',
+  properties: {
+    authToken: {
+      type: 'string',
+      description: 'JWT auth token',
+      example: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'
     },
-    expectedAmount: {
-      type: 'number',
-      description: 'Expected amount'
+    accessToken: {
+      type: 'string',
+      description: 'Auto-generated access token'
     },
-    expectedDay: {
-      type: 'object',
-      description: 'Expected day of month'
+    role: {
+      type: 'string',
+      description: 'Assigned user role',
+      enum: ['USER', 'ADMIN', 'DEMO', 'INACTIVE', 'PAID', 'OPS']
+    }
+  },
+  required: ['authToken', 'accessToken', 'role']
+} as const;
+
+export const $UpdateUserSettingDto = {
+  type: 'object',
+  properties: {
+    secId: {
+      type: 'number',
+      description: 'Security ID'
     },
-    customIntervalDays: {
-      type: 'object',
-      description: 'Custom interval in days'
+    annualInterestRate: {
+      type: 'number',
+      description: 'Annual interest rate',
+      example: 0.05
     },
     currency: {
       type: 'string',
-      description: 'Currency code'
+      description: 'Currency code',
+      example: 'USD'
     },
-    matchPayeePattern: {
-      type: 'object',
-      description: 'Payee matching pattern'
+    baseCurrency: {
+      type: 'string',
+      description: 'Base currency code',
+      example: 'USD'
     },
-    matchAmountTolerance: {
-      type: 'number',
-      description: 'Amount tolerance percentage'
+    benchmark: {
+      type: 'string',
+      description: 'Benchmark symbol',
+      example: 'SPY'
     },
-    defaultExpenseAccount: {
-      type: 'object',
-      description: 'Default expense account'
+    colorScheme: {
+      type: 'string',
+      description: 'Color scheme',
+      enum: ['DARK', 'LIGHT']
     },
-    defaultPaymentAccount: {
-      type: 'object',
-      description: 'Default payment account'
+    dateRange: {
+      type: 'string',
+      description: 'Date range filter',
+      example: '1y'
     },
-    defaultPayee: {
-      type: 'object',
-      description: 'Default payee'
-    },
-    isActive: {
-      type: 'boolean',
-      description: 'Whether rule is active'
-    },
-    startDate: {
-      type: 'string',
-      description: 'Rule start date (YYYY-MM-DD)'
-    },
-    endDate: {
-      type: 'object',
-      description: 'Rule end date (YYYY-MM-DD)'
-    },
-    autoCreate: {
-      type: 'boolean',
-      description: 'Auto-create transaction on expected date'
+    emergencyFund: {
+      type: 'number',
+      description: 'Emergency fund amount',
+      example: 10000
     },
-    lastOccurrence: {
-      type: 'object',
-      description: 'Last matched occurrence date (YYYY-MM-DD)'
+    'filters.accounts': {
+      description: 'Account filter IDs',
+      type: 'array',
+      items: {
+        type: 'string'
+      }
     },
-    totalCount: {
-      type: 'number',
-      description: 'Total matched transactions count'
+    'filters.assetClasses': {
+      description: 'Asset class filters',
+      type: 'array',
+      items: {
+        type: 'string'
+      }
     },
-    createdAt: {
-      format: 'date-time',
+    'filters.dataSource': {
       type: 'string',
-      description: 'Created at timestamp'
+      description: 'Data source filter'
     },
-    updatedAt: {
-      format: 'date-time',
+    'filters.symbol': {
       type: 'string',
-      description: 'Updated at timestamp'
+      description: 'Symbol filter'
     },
-    pendingCount: {
-      type: 'number',
-      description: 'Number of pending expected transactions'
+    'filters.tags': {
+      description: 'Tag filters',
+      type: 'array',
+      items: {
+        type: 'string'
+      }
     },
-    overdueCount: {
-      type: 'number',
-      description: 'Number of overdue expected transactions'
+    isExperimentalFeatures: {
+      type: 'boolean',
+      description: 'Enable experimental features'
     },
-    nextExpectedDate: {
-      type: 'object',
-      description: 'Next expected date (YYYY-MM-DD)'
+    isRestrictedView: {
+      type: 'boolean',
+      description: 'Enable restricted view mode'
     },
-    totalAmount: {
-      type: 'number',
-      description: 'Total amount of all matched transactions'
+    language: {
+      type: 'string',
+      description: 'Language code',
+      example: 'en'
     },
-    averageAmount: {
-      type: 'number',
-      description: 'Average amount per transaction'
+    locale: {
+      type: 'string',
+      description: 'Locale code',
+      example: 'en-US'
     },
-    transactionCount: {
+    projectedTotalAmount: {
       type: 'number',
-      description: 'Number of matched transactions'
-    },
-    firstDate: {
-      type: 'object',
-      description: 'First matched transaction date (YYYY-MM-DD)'
+      description: 'Projected total amount',
+      example: 1000000
     },
-    lastDate: {
-      type: 'object',
-      description: 'Last matched transaction date (YYYY-MM-DD)'
+    retirementDate: {
+      type: 'string',
+      description: 'Retirement date in ISO 8601 format',
+      example: '2050-01-01'
     },
-    variance: {
+    savingsRate: {
       type: 'number',
-      description: 'Amount variance (standard deviation squared)'
+      description: 'Savings rate percentage',
+      example: 0.2
     },
-    upcomingCount: {
-      type: 'number',
-      description: 'Number of upcoming expected transactions'
+    viewMode: {
+      type: 'string',
+      description: 'View mode',
+      enum: ['DEFAULT', 'ZEN']
+    }
+  }
+} as const;
+
+export const $UpdatePropertyDto = {
+  type: 'object',
+  properties: {
+    value: {
+      type: 'string',
+      description: 'Property value'
     }
   },
-  required: [
-    'id',
-    'userId',
-    'name',
-    'frequency',
-    'expectedAmount',
-    'currency',
-    'matchAmountTolerance',
-    'isActive',
-    'startDate',
-    'autoCreate',
-    'totalCount',
-    'createdAt',
-    'updatedAt',
-    'pendingCount',
-    'overdueCount',
-    'totalAmount',
-    'averageAmount',
-    'transactionCount',
-    'variance',
-    'upcomingCount'
-  ]
+  required: ['value']
 } as const;
 
-export const $UpdateRecurringRuleDto = {
+export const $CreateRecurringRuleDto = {
   type: 'object',
   properties: {
     name: {
       type: 'string',
-      description: 'Rule name',
+      description: 'Rule name (unique per user)',
       maxLength: 100
     },
     icon: {
@@ -3658,7 +3807,7 @@ export const $UpdateRecurringRuleDto = {
     },
     expectedAmount: {
       type: 'number',
-      description: 'Expected amount',
+      description: 'Expected amount (positive number)',
       minimum: 0
     },
     expectedDay: {
@@ -3669,7 +3818,7 @@ export const $UpdateRecurringRuleDto = {
     },
     customIntervalDays: {
       type: 'number',
-      description: 'Custom interval in days',
+      description: 'Custom interval in days (required for CUSTOM frequency)',
       minimum: 1
     },
     currency: {
@@ -3679,118 +3828,136 @@ export const $UpdateRecurringRuleDto = {
     },
     matchPayeePattern: {
       type: 'string',
-      description: 'Payee matching pattern',
+      description: 'Payee matching pattern (supports wildcards)',
       maxLength: 200
     },
     matchAmountTolerance: {
       type: 'number',
       description: 'Amount tolerance percentage (0-1)',
+      default: 0.075,
       minimum: 0,
       maximum: 1
     },
     defaultExpenseAccount: {
       type: 'string',
-      description: 'Default expense account',
+      description: 'Default expense account for auto-create',
       maxLength: 200
     },
     defaultPaymentAccount: {
       type: 'string',
-      description: 'Default payment account',
+      description: 'Default payment account for auto-create',
       maxLength: 200
     },
     defaultPayee: {
       type: 'string',
-      description: 'Default payee',
+      description: 'Default payee for auto-create',
       maxLength: 200
     },
     autoCreate: {
       type: 'boolean',
-      description: 'Auto-create transaction'
+      description: 'Auto-create transaction when expected date arrives',
+      default: false
     },
-    isActive: {
-      type: 'boolean',
-      description: 'Rule active status'
+    startDate: {
+      type: 'string',
+      description: 'Rule start date (ISO format)'
     },
     endDate: {
       type: 'string',
       description: 'Rule end date (ISO format)'
     }
-  }
+  },
+  required: [
+    'name',
+    'frequency',
+    'expectedAmount',
+    'matchAmountTolerance',
+    'autoCreate'
+  ]
 } as const;
 
-export const $ExpectedTransactionRuleDto = {
+export const $RecurringRuleResponseDto = {
   type: 'object',
   properties: {
+    id: {
+      type: 'string',
+      description: 'Rule ID'
+    },
+    userId: {
+      type: 'string',
+      description: 'User ID'
+    },
     name: {
       type: 'string',
       description: 'Rule name'
     },
     icon: {
-      type: 'object',
-      description: 'Rule icon'
+      type: 'string',
+      description: 'Icon emoji'
     },
     frequency: {
       type: 'string',
-      description: 'Rule frequency'
+      description: 'Recurring frequency'
+    },
+    expectedAmount: {
+      type: 'number',
+      description: 'Expected amount'
+    },
+    expectedDay: {
+      type: 'number',
+      description: 'Expected day of month'
+    },
+    customIntervalDays: {
+      type: 'number',
+      description: 'Custom interval in days'
     },
     currency: {
       type: 'string',
       description: 'Currency code'
-    }
-  },
-  required: ['name', 'frequency', 'currency']
-} as const;
-
-export const $ExpectedTransactionResponseDto = {
-  type: 'object',
-  properties: {
-    id: {
+    },
+    matchPayeePattern: {
       type: 'string',
-      description: 'Expected transaction ID'
+      description: 'Payee matching pattern'
     },
-    userId: {
+    matchAmountTolerance: {
+      type: 'number',
+      description: 'Amount tolerance percentage'
+    },
+    defaultExpenseAccount: {
       type: 'string',
-      description: 'User ID'
+      description: 'Default expense account'
     },
-    ruleId: {
+    defaultPaymentAccount: {
       type: 'string',
-      description: 'Associated rule ID'
+      description: 'Default payment account'
     },
-    expectedDate: {
+    defaultPayee: {
       type: 'string',
-      description: 'Expected date (YYYY-MM-DD)'
+      description: 'Default payee'
     },
-    expectedAmount: {
-      type: 'number',
-      description: 'Expected amount'
+    isActive: {
+      type: 'boolean',
+      description: 'Whether rule is active'
     },
-    status: {
+    startDate: {
       type: 'string',
-      description: 'Status (PENDING, COMPLETED, SKIPPED)'
+      description: 'Rule start date (YYYY-MM-DD)'
     },
-    matchedTransactionId: {
-      type: 'object',
-      description: 'Matched transaction ID'
+    endDate: {
+      type: 'string',
+      description: 'Rule end date (YYYY-MM-DD)'
     },
-    matchedAt: {
-      type: 'object',
-      description: 'Match timestamp (ISO 8601)'
+    autoCreate: {
+      type: 'boolean',
+      description: 'Auto-create transaction on expected date'
     },
-    matchConfidence: {
-      type: 'object',
-      description: 'Match confidence score (0-1)'
-    },
-    isOverdue: {
-      type: 'boolean',
-      description: 'Whether this expected transaction is overdue'
+    lastOccurrence: {
+      type: 'string',
+      description: 'Last matched occurrence date (YYYY-MM-DD)'
     },
-    rule: {
-      description: 'Rule information',
-      allOf: [
-        {
-          $ref: '#/components/schemas/ExpectedTransactionRuleDto'
-        }
-      ]
+    totalCount: {
+      type: 'number',
+      description: 'Total matched transactions count'
     },
     createdAt: {
       format: 'date-time',
@@ -3806,691 +3973,581 @@ export const $ExpectedTransactionResponseDto = {
   required: [
     'id',
     'userId',
-    'ruleId',
-    'expectedDate',
+    'name',
+    'frequency',
     'expectedAmount',
-    'status',
-    'isOverdue',
-    'rule',
+    'currency',
+    'matchAmountTolerance',
+    'isActive',
+    'startDate',
+    'autoCreate',
+    'totalCount',
     'createdAt',
     'updatedAt'
   ]
 } as const;
 
-export const $ExpectedTransactionListResponseDto = {
+export const $CreateRuleFromTransactionDto = {
   type: 'object',
   properties: {
-    items: {
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/ExpectedTransactionResponseDto'
-      }
+    frequency: {
+      type: 'string',
+      description: 'Recurring frequency',
+      enum: [
+        'WEEKLY',
+        'BIWEEKLY',
+        'MONTHLY',
+        'BIMONTHLY',
+        'QUARTERLY',
+        'YEARLY',
+        'CUSTOM'
+      ],
+      example: 'MONTHLY'
     },
-    total: {
-      type: 'number',
-      description: 'Total count'
-    }
-  },
-  required: ['items', 'total']
-} as const;
-
-export const $ConfirmMatchDto = {
-  type: 'object',
-  properties: {
-    transactionId: {
+    name: {
       type: 'string',
-      description: 'Transaction ID to match with'
+      description: 'Optional name override (default: transaction payee)',
+      maxLength: 100
+    },
+    icon: {
+      type: 'string',
+      description: 'Optional icon emoji',
+      maxLength: 10
     }
   },
-  required: ['transactionId']
+  required: ['frequency']
 } as const;
 
-export const $EnterNowDto = {
+export const $RecurringRuleWithStatsResponseDto = {
   type: 'object',
   properties: {
-    expenseAccount: {
+    id: {
       type: 'string',
-      description:
-        'Override expense account (uses rule default if not provided)',
-      maxLength: 200
+      description: 'Rule ID'
     },
-    paymentAccount: {
+    userId: {
       type: 'string',
-      description:
-        'Override payment account (uses rule default if not provided)',
-      maxLength: 200
+      description: 'User ID'
     },
-    amount: {
-      type: 'number',
-      description: 'Override amount (uses expected amount if not provided)',
-      minimum: 0
+    name: {
+      type: 'string',
+      description: 'Rule name'
     },
-    payee: {
+    icon: {
       type: 'string',
-      description: 'Override payee (uses rule default if not provided)',
-      maxLength: 200
+      description: 'Icon emoji'
     },
-    narration: {
+    frequency: {
       type: 'string',
-      description: 'Optional narration',
-      maxLength: 500
-    }
-  }
-} as const;
-
-export const $ForecastItemDto = {
-  type: 'object',
-  properties: {
-    rule: {
+      description: 'Recurring frequency'
+    },
+    expectedAmount: {
+      type: 'number',
+      description: 'Expected amount'
+    },
+    expectedDay: {
+      type: 'number',
+      description: 'Expected day of month'
+    },
+    customIntervalDays: {
+      type: 'number',
+      description: 'Custom interval in days'
+    },
+    currency: {
       type: 'string',
-      description: 'Rule name',
-      example: 'Rent'
+      description: 'Currency code'
     },
-    ruleId: {
+    matchPayeePattern: {
       type: 'string',
-      description: 'Rule ID',
-      example: 'clx123...'
+      description: 'Payee matching pattern'
     },
-    amount: {
+    matchAmountTolerance: {
       type: 'number',
-      description: 'Expected amount',
-      example: 3000
+      description: 'Amount tolerance percentage'
     },
-    date: {
+    defaultExpenseAccount: {
       type: 'string',
-      description: 'Expected date (YYYY-MM-DD)',
-      example: '2024-04-01'
+      description: 'Default expense account'
     },
-    icon: {
+    defaultPaymentAccount: {
       type: 'string',
-      description: 'Rule icon emoji',
-      example: '🏠',
-      nullable: true
+      description: 'Default payment account'
     },
-    currency: {
+    defaultPayee: {
       type: 'string',
-      description: 'Currency code',
-      example: 'CNY'
-    }
-  },
-  required: ['rule', 'ruleId', 'amount', 'date', 'icon', 'currency']
-} as const;
-
-export const $MonthlyForecastDto = {
-  type: 'object',
-  properties: {
-    month: {
+      description: 'Default payee'
+    },
+    isActive: {
+      type: 'boolean',
+      description: 'Whether rule is active'
+    },
+    startDate: {
       type: 'string',
-      description: 'Month (YYYY-MM)',
-      example: '2024-04'
+      description: 'Rule start date (YYYY-MM-DD)'
     },
-    expectedOutflow: {
-      type: 'number',
-      description: 'Total expected outflow for the month',
-      example: 8500
+    endDate: {
+      type: 'string',
+      description: 'Rule end date (YYYY-MM-DD)'
     },
-    itemCount: {
+    autoCreate: {
+      type: 'boolean',
+      description: 'Auto-create transaction on expected date'
+    },
+    lastOccurrence: {
+      type: 'string',
+      description: 'Last matched occurrence date (YYYY-MM-DD)'
+    },
+    totalCount: {
       type: 'number',
-      description: 'Number of expected transactions',
-      example: 3
+      description: 'Total matched transactions count'
     },
-    byCurrency: {
-      type: 'object',
-      description: 'Breakdown by currency',
-      example: {
-        CNY: 8500,
-        USD: 100
-      }
+    createdAt: {
+      format: 'date-time',
+      type: 'string',
+      description: 'Created at timestamp'
     },
-    items: {
-      description: 'Individual forecast items',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/ForecastItemDto'
-      }
-    }
-  },
-  required: ['month', 'expectedOutflow', 'itemCount', 'byCurrency', 'items']
-} as const;
-
-export const $ForecastResponseDto = {
-  type: 'object',
-  properties: {
-    forecast: {
-      description: 'Monthly forecast data',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/MonthlyForecastDto'
-      }
+    updatedAt: {
+      format: 'date-time',
+      type: 'string',
+      description: 'Updated at timestamp'
     },
-    totalOutflow: {
+    pendingCount: {
       type: 'number',
-      description: 'Total expected outflow across all months',
-      example: 25500
-    },
-    totalByCurrency: {
-      type: 'object',
-      description: 'Total by currency across all months',
-      example: {
-        CNY: 25500,
-        USD: 300
-      }
+      description: 'Number of pending expected transactions'
     },
-    rulesCount: {
+    overdueCount: {
       type: 'number',
-      description: 'Number of active recurring rules included',
-      example: 5
+      description: 'Number of overdue expected transactions'
     },
-    periodStart: {
+    nextExpectedDate: {
       type: 'string',
-      description: 'Forecast period start date',
-      example: '2024-04-01'
+      description: 'Next expected date (YYYY-MM-DD)'
     },
-    periodEnd: {
-      type: 'string',
-      description: 'Forecast period end date',
-      example: '2024-06-30'
-    }
-  },
-  required: [
-    'forecast',
-    'totalOutflow',
-    'totalByCurrency',
-    'rulesCount',
-    'periodStart',
-    'periodEnd'
-  ]
-} as const;
-
-export const $CurrencyBalanceDto = {
-  type: 'object',
-  properties: {
-    currency: {
-      type: 'string',
-      description: 'ISO 4217 currency code',
-      example: 'CNY'
-    },
-    balance: {
-      type: 'string',
-      description: 'Balance amount',
-      example: '500000.00'
-    }
-  },
-  required: ['currency', 'balance']
-} as const;
-
-export const $TimeSeriesPointDto = {
-  type: 'object',
-  properties: {
-    date: {
-      type: 'string',
-      description: 'Date in YYYY-MM-DD format',
-      example: '2024-06-15'
+    totalAmount: {
+      type: 'number',
+      description: 'Total amount of all matched transactions'
     },
-    value: {
-      type: 'string',
-      description: 'Value at this date (in base currency)',
-      example: '500000.00'
+    averageAmount: {
+      type: 'number',
+      description: 'Average amount per transaction'
     },
-    change: {
-      type: 'object',
-      description: 'Change from previous point',
-      example: '5000.00'
+    transactionCount: {
+      type: 'number',
+      description: 'Number of matched transactions'
     },
-    assets: {
+    firstDate: {
       type: 'string',
-      description: 'Total assets at this date (in base currency)',
-      example: '494338.00'
+      description: 'First matched transaction date (YYYY-MM-DD)'
     },
-    liabilities: {
+    lastDate: {
       type: 'string',
-      description: 'Total liabilities at this date (in base currency)',
-      example: '310098.00'
+      description: 'Last matched transaction date (YYYY-MM-DD)'
     },
-    byCurrency: {
-      description: 'Multi-currency breakdown for this point',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/CurrencyBalanceDto'
-      }
+    variance: {
+      type: 'number',
+      description: 'Amount variance (standard deviation squared)'
+    },
+    upcomingCount: {
+      type: 'number',
+      description: 'Number of upcoming expected transactions'
     }
   },
-  required: ['date', 'value']
+  required: [
+    'id',
+    'userId',
+    'name',
+    'frequency',
+    'expectedAmount',
+    'currency',
+    'matchAmountTolerance',
+    'isActive',
+    'startDate',
+    'autoCreate',
+    'totalCount',
+    'createdAt',
+    'updatedAt',
+    'pendingCount',
+    'overdueCount',
+    'totalAmount',
+    'averageAmount',
+    'transactionCount',
+    'variance',
+    'upcomingCount'
+  ]
 } as const;
 
-export const $TrendSummaryDto = {
+export const $UpdateRecurringRuleDto = {
   type: 'object',
   properties: {
-    startValue: {
-      type: 'string',
-      description: 'Value at start of period',
-      example: '450000.00'
-    },
-    endValue: {
+    name: {
       type: 'string',
-      description: 'Value at end of period',
-      example: '500000.00'
+      description: 'Rule name (unique per user)',
+      maxLength: 100
     },
-    totalChange: {
+    icon: {
       type: 'string',
-      description: 'Total change over period',
-      example: '50000.00'
+      description: 'Icon emoji',
+      maxLength: 10
     },
-    totalChangePercentage: {
-      type: 'string',
-      description: 'Total change percentage',
-      example: '+11.11%'
-    }
-  },
-  required: ['startValue', 'endValue', 'totalChange', 'totalChangePercentage']
-} as const;
-
-export const $MultiCurrencyPointDto = {
-  type: 'object',
-  properties: {
-    date: {
+    frequency: {
       type: 'string',
-      description: 'Date in YYYY-MM-DD format',
-      example: '2024-06-15'
-    },
-    byCurrency: {
-      description: 'Balances by currency',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/CurrencyBalanceDto'
-      }
-    }
-  },
-  required: ['date', 'byCurrency']
-} as const;
-
-export const $PortfolioTrendsResponseDto = {
-  type: 'object',
-  properties: {
-    series: {
-      description: 'Time series data points',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/TimeSeriesPointDto'
-      }
-    },
-    summary: {
-      description: 'Period summary',
-      allOf: [
-        {
-          $ref: '#/components/schemas/TrendSummaryDto'
-        }
+      description: 'Recurring frequency',
+      enum: [
+        'WEEKLY',
+        'BIWEEKLY',
+        'MONTHLY',
+        'BIMONTHLY',
+        'QUARTERLY',
+        'YEARLY',
+        'CUSTOM'
       ]
     },
-    period: {
-      type: 'string',
-      description: 'Period requested',
-      example: '6m'
+    expectedAmount: {
+      type: 'number',
+      description: 'Expected amount (positive number)',
+      minimum: 0
     },
-    granularity: {
-      type: 'string',
-      description: 'Data granularity',
-      example: 'month'
+    expectedDay: {
+      type: 'number',
+      description: 'Expected day of month (1-31)',
+      minimum: 1,
+      maximum: 31
     },
     currency: {
       type: 'string',
-      description: 'Base currency for converted values',
-      example: 'CNY'
-    },
-    byCurrency: {
-      description:
-        'Multi-currency time series (each point has currency breakdown)',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/MultiCurrencyPointDto'
-      }
-    },
-    warnings: {
-      description: 'Exchange rate warnings',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/ExchangeRateWarningDto'
-      }
-    }
-  },
-  required: ['series', 'summary', 'period', 'granularity', 'currency']
-} as const;
-
-export const $CashFlowPointDto = {
-  type: 'object',
-  properties: {
-    month: {
-      type: 'string',
-      description: 'Month key (YYYY-MM)',
-      example: '2024-03'
-    },
-    income: {
-      type: 'string',
-      description: 'Income in base currency (absolute, converted)',
-      example: '10000.00'
+      description: 'Currency code',
+      maxLength: 10
     },
-    expense: {
+    matchPayeePattern: {
       type: 'string',
-      description: 'Expense in base currency (absolute, converted)',
-      example: '5000.00'
+      description: 'Payee matching pattern (supports wildcards)',
+      maxLength: 200
     },
-    netSavings: {
-      type: 'string',
-      description: 'netSavings = income − expense (savings positive)',
-      example: '5000.00'
-    }
-  },
-  required: ['month', 'income', 'expense', 'netSavings']
-} as const;
-
-export const $CashFlowTrendSummaryDto = {
-  type: 'object',
-  properties: {
-    totalIncome: {
-      type: 'string',
-      description: 'Total income across the period',
-      example: '60000.00'
+    matchAmountTolerance: {
+      type: 'number',
+      description: 'Amount tolerance percentage (0-1)',
+      default: 0.075,
+      minimum: 0,
+      maximum: 1
     },
-    totalExpense: {
+    defaultExpenseAccount: {
       type: 'string',
-      description: 'Total expense across the period',
-      example: '30000.00'
+      description: 'Default expense account for auto-create',
+      maxLength: 200
     },
-    totalNetSavings: {
+    defaultPaymentAccount: {
       type: 'string',
-      description: 'income − expense across the period',
-      example: '30000.00'
+      description: 'Default payment account for auto-create',
+      maxLength: 200
     },
-    averageMonthlyNetSavings: {
+    defaultPayee: {
       type: 'string',
-      description:
-        'totalNetSavings divided by the window length (N months, incl. zero-filled)',
-      example: '5000.00'
-    }
-  },
-  required: [
-    'totalIncome',
-    'totalExpense',
-    'totalNetSavings',
-    'averageMonthlyNetSavings'
-  ]
-} as const;
-
-export const $CashFlowTrendsResponseDto = {
-  type: 'object',
-  properties: {
-    series: {
-      description:
-        'Monthly cash-flow series (fixed N-month window, zero-filled)',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/CashFlowPointDto'
-      }
-    },
-    summary: {
-      description: 'Period totals',
-      allOf: [
-        {
-          $ref: '#/components/schemas/CashFlowTrendSummaryDto'
-        }
-      ]
+      description: 'Default payee for auto-create',
+      maxLength: 200
     },
-    period: {
-      type: 'string',
-      description: 'Period requested',
-      example: '6m'
+    autoCreate: {
+      type: 'boolean',
+      description: 'Auto-create transaction when expected date arrives',
+      default: false
     },
-    granularity: {
+    endDate: {
       type: 'string',
-      description: 'Data granularity (v1 returns month buckets)',
-      example: 'month'
+      description: 'Rule end date (ISO format)'
     },
-    currency: {
-      type: 'string',
-      description: 'Base currency for converted values',
-      example: 'CNY'
+    customIntervalDays: {
+      type: 'number',
+      description: 'Custom interval in days',
+      minimum: 1
     },
-    warnings: {
-      description: 'Exchange rate warnings (e.g. missing rate for a currency)',
-      type: 'array',
-      items: {
-        $ref: '#/components/schemas/ExchangeRateWarningDto'
-      }
-    }
-  },
-  required: ['series', 'summary', 'period', 'granularity', 'currency']
-} as const;
-
-export const $GenerateSnapshotBody = {
-  type: 'object',
-  properties: {}
-} as const;
-
-export const $GenerateSnapshotResponse = {
-  type: 'object',
-  properties: {}
-} as const;
-
-export const $BackfillSnapshotsBody = {
-  type: 'object',
-  properties: {}
-} as const;
-
-export const $BackfillSnapshotsResponse = {
-  type: 'object',
-  properties: {}
-} as const;
-
-export const $DeleteOwnUserDto = {
-  type: 'object',
-  properties: {
-    accessToken: {
-      type: 'string',
-      description: 'Access token for user verification',
-      example: 'abc123xyz'
+    isActive: {
+      type: 'boolean',
+      description: 'Rule active status'
     }
-  },
-  required: ['accessToken']
+  }
 } as const;
 
-export const $UserSettingsResponseDto = {
+export const $ExpectedTransactionRuleDto = {
   type: 'object',
   properties: {
-    baseCurrency: {
+    name: {
       type: 'string',
-      description:
-        'Base currency (ISO 4217) for net-worth/report aggregation. Independent of region (ADR-0006).',
-      example: 'USD',
-      nullable: true
+      description: 'Rule name'
+    },
+    icon: {
+      type: 'string',
+      description: 'Rule icon'
+    },
+    frequency: {
+      type: 'string',
+      description: 'Rule frequency'
+    },
+    currency: {
+      type: 'string',
+      description: 'Currency code'
     }
   },
-  required: ['baseCurrency']
+  required: ['name', 'frequency', 'currency']
 } as const;
 
-export const $UserResponseDto = {
+export const $ExpectedTransactionResponseDto = {
   type: 'object',
   properties: {
     id: {
+      type: 'string',
+      description: 'Expected transaction ID'
+    },
+    userId: {
       type: 'string',
       description: 'User ID'
     },
-    role: {
+    ruleId: {
       type: 'string',
-      description: 'Assigned user role'
+      description: 'Associated rule ID'
     },
-    permissions: {
-      description: 'Permission strings',
-      type: 'array',
-      items: {
-        type: 'string'
-      }
+    expectedDate: {
+      type: 'string',
+      description: 'Expected date (YYYY-MM-DD)'
     },
-    settings: {
-      description: 'User settings',
+    expectedAmount: {
+      type: 'number',
+      description: 'Expected amount'
+    },
+    status: {
+      type: 'string',
+      description: 'Status (PENDING, COMPLETED, SKIPPED)'
+    },
+    matchedTransactionId: {
+      type: 'string',
+      description: 'Matched transaction ID'
+    },
+    matchedAt: {
+      type: 'string',
+      description: 'Match timestamp (ISO 8601)'
+    },
+    matchConfidence: {
+      type: 'number',
+      description: 'Match confidence score (0-1)'
+    },
+    isOverdue: {
+      type: 'boolean',
+      description: 'Whether this expected transaction is overdue'
+    },
+    rule: {
+      description: 'Rule information',
       allOf: [
         {
-          $ref: '#/components/schemas/UserSettingsResponseDto'
+          $ref: '#/components/schemas/ExpectedTransactionRuleDto'
         }
       ]
+    },
+    createdAt: {
+      format: 'date-time',
+      type: 'string',
+      description: 'Created at timestamp'
+    },
+    updatedAt: {
+      format: 'date-time',
+      type: 'string',
+      description: 'Updated at timestamp'
     }
   },
-  required: ['id', 'role', 'permissions', 'settings']
+  required: [
+    'id',
+    'userId',
+    'ruleId',
+    'expectedDate',
+    'expectedAmount',
+    'status',
+    'isOverdue',
+    'rule',
+    'createdAt',
+    'updatedAt'
+  ]
 } as const;
 
-export const $SignupDto = {
+export const $ExpectedTransactionListResponseDto = {
   type: 'object',
   properties: {
-    turnstileToken: {
+    items: {
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/ExpectedTransactionResponseDto'
+      }
+    },
+    total: {
+      type: 'number',
+      description: 'Total count'
+    }
+  },
+  required: ['items', 'total']
+} as const;
+
+export const $ConfirmMatchDto = {
+  type: 'object',
+  properties: {
+    transactionId: {
       type: 'string',
-      description:
-        'Cloudflare Turnstile verification token (optional when Turnstile disabled)',
-      example: '0.abc123def456...'
+      description: 'Transaction ID to match with'
     }
-  }
+  },
+  required: ['transactionId']
 } as const;
 
-export const $SignupResponseDto = {
+export const $EnterNowDto = {
   type: 'object',
   properties: {
-    authToken: {
+    expenseAccount: {
       type: 'string',
-      description: 'JWT auth token',
-      example: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'
+      description:
+        'Override expense account (uses rule default if not provided)',
+      maxLength: 200
     },
-    accessToken: {
+    paymentAccount: {
       type: 'string',
-      description: 'Auto-generated access token'
+      description:
+        'Override payment account (uses rule default if not provided)',
+      maxLength: 200
     },
-    role: {
+    amount: {
+      type: 'number',
+      description: 'Override amount (uses expected amount if not provided)',
+      minimum: 0
+    },
+    payee: {
       type: 'string',
-      description: 'Assigned user role',
-      enum: ['USER', 'ADMIN', 'DEMO', 'INACTIVE', 'PAID', 'OPS']
+      description: 'Override payee (uses rule default if not provided)',
+      maxLength: 200
+    },
+    narration: {
+      type: 'string',
+      description: 'Optional narration',
+      maxLength: 500
     }
-  },
-  required: ['authToken', 'accessToken', 'role']
+  }
 } as const;
 
-export const $UpdateUserSettingDto = {
+export const $ForecastItemDto = {
   type: 'object',
   properties: {
-    secId: {
-      type: 'number',
-      description: 'Security ID'
+    rule: {
+      type: 'string',
+      description: 'Rule name',
+      example: 'Rent'
     },
-    annualInterestRate: {
+    ruleId: {
+      type: 'string',
+      description: 'Rule ID',
+      example: 'clx123...'
+    },
+    amount: {
       type: 'number',
-      description: 'Annual interest rate',
-      example: 0.05
+      description: 'Expected amount',
+      example: 3000
     },
-    currency: {
+    date: {
       type: 'string',
-      description: 'Currency code',
-      example: 'USD'
+      description: 'Expected date (YYYY-MM-DD)',
+      example: '2024-04-01'
     },
-    baseCurrency: {
+    icon: {
       type: 'string',
-      description: 'Base currency code',
-      example: 'USD'
+      description: 'Rule icon emoji',
+      example: '🏠',
+      nullable: true
     },
-    benchmark: {
+    currency: {
       type: 'string',
-      description: 'Benchmark symbol',
-      example: 'SPY'
-    },
-    colorScheme: {
+      description: 'Currency code',
+      example: 'CNY'
+    }
+  },
+  required: ['rule', 'ruleId', 'amount', 'date', 'icon', 'currency']
+} as const;
+
+export const $MonthlyForecastDto = {
+  type: 'object',
+  properties: {
+    month: {
       type: 'string',
-      description: 'Color scheme',
-      enum: ['DARK', 'LIGHT']
+      description: 'Month (YYYY-MM)',
+      example: '2024-04'
     },
-    dateRange: {
-      type: 'string',
-      description: 'Date range filter',
-      example: '1y'
+    expectedOutflow: {
+      type: 'number',
+      description: 'Total expected outflow for the month',
+      example: 8500
     },
-    emergencyFund: {
+    itemCount: {
       type: 'number',
-      description: 'Emergency fund amount',
-      example: 10000
+      description: 'Number of expected transactions',
+      example: 3
     },
-    'filters.accounts': {
-      description: 'Account filter IDs',
-      type: 'array',
-      items: {
-        type: 'string'
+    byCurrency: {
+      type: 'object',
+      description: 'Breakdown by currency',
+      example: {
+        CNY: 8500,
+        USD: 100
       }
     },
-    'filters.assetClasses': {
-      description: 'Asset class filters',
+    items: {
+      description: 'Individual forecast items',
       type: 'array',
       items: {
-        type: 'string'
-      }
-    },
-    'filters.dataSource': {
-      type: 'string',
-      description: 'Data source filter'
-    },
-    'filters.symbol': {
-      type: 'string',
-      description: 'Symbol filter'
-    },
-    'filters.tags': {
-      description: 'Tag filters',
+        $ref: '#/components/schemas/ForecastItemDto'
+      }
+    }
+  },
+  required: ['month', 'expectedOutflow', 'itemCount', 'byCurrency', 'items']
+} as const;
+
+export const $ForecastResponseDto = {
+  type: 'object',
+  properties: {
+    forecast: {
+      description: 'Monthly forecast data',
       type: 'array',
       items: {
-        type: 'string'
+        $ref: '#/components/schemas/MonthlyForecastDto'
       }
     },
-    isExperimentalFeatures: {
-      type: 'boolean',
-      description: 'Enable experimental features'
-    },
-    isRestrictedView: {
-      type: 'boolean',
-      description: 'Enable restricted view mode'
-    },
-    language: {
-      type: 'string',
-      description: 'Language code',
-      example: 'en'
-    },
-    locale: {
-      type: 'string',
-      description: 'Locale code',
-      example: 'en-US'
-    },
-    projectedTotalAmount: {
+    totalOutflow: {
       type: 'number',
-      description: 'Projected total amount',
-      example: 1000000
+      description: 'Total expected outflow across all months',
+      example: 25500
     },
-    retirementDate: {
-      type: 'string',
-      description: 'Retirement date in ISO 8601 format',
-      example: '2050-01-01'
+    totalByCurrency: {
+      type: 'object',
+      description: 'Total by currency across all months',
+      example: {
+        CNY: 25500,
+        USD: 300
+      }
     },
-    savingsRate: {
+    rulesCount: {
       type: 'number',
-      description: 'Savings rate percentage',
-      example: 0.2
+      description: 'Number of active recurring rules included',
+      example: 5
     },
-    viewMode: {
+    periodStart: {
       type: 'string',
-      description: 'View mode',
-      enum: ['DEFAULT', 'ZEN']
-    }
-  }
-} as const;
-
-export const $UpdatePropertyDto = {
-  type: 'object',
-  properties: {
-    value: {
+      description: 'Forecast period start date',
+      example: '2024-04-01'
+    },
+    periodEnd: {
       type: 'string',
-      description: 'Property value'
+      description: 'Forecast period end date',
+      example: '2024-06-30'
     }
   },
-  required: ['value']
+  required: [
+    'forecast',
+    'totalOutflow',
+    'totalByCurrency',
+    'rulesCount',
+    'periodStart',
+    'periodEnd'
+  ]
 } as const;
 
 export const $CreateTransactionRuleDto = {
@@ -5052,7 +5109,8 @@ export const $UpdateTransactionRuleDto = {
     },
     matchLogic: {
       type: 'string',
-      enum: ['OR', 'AND']
+      enum: ['OR', 'AND'],
+      default: 'OR'
     },
     amountMin: {
       type: 'number',
@@ -5066,13 +5124,10 @@ export const $UpdateTransactionRuleDto = {
     },
     priority: {
       type: 'number',
+      default: 50,
       minimum: 0,
       maximum: 1000
     },
-    enabled: {
-      type: 'boolean',
-      description: 'Enable or disable the rule'
-    },
     additionalTags: {
       items: {
         type: 'array'
@@ -5082,6 +5137,10 @@ export const $UpdateTransactionRuleDto = {
     },
     additionalMetadata: {
       type: 'object'
+    },
+    enabled: {
+      type: 'boolean',
+      description: 'Enable or disable the rule'
     }
   }
 } as const;
@@ -5175,9 +5234,23 @@ export const $CategoryCatalogEntryDto = {
       items: {
         type: 'string'
       }
+    },
+    categoryAccounts: {
+      description:
+        "Beancount account paths (categoryAccount) of the region-enabled system rules whose categoryKeywords include this slug (#816). System rules only (public endpoint — user rules excluded); one-to-many by design (e.g. 'utilities' → Electricity/Water/Internet/Gas), sorted, [] when no rule maps the slug.",
+      example: [
+        'Expenses:Utilities:Electricity',
+        'Expenses:Utilities:Gas',
+        'Expenses:Utilities:Internet',
+        'Expenses:Utilities:Water'
+      ],
+      type: 'array',
+      items: {
+        type: 'string'
+      }
     }
   },
-  required: ['slug', 'scenario', 'icon', 'regions']
+  required: ['slug', 'scenario', 'icon', 'regions', 'categoryAccounts']
 } as const;
 
 export const $CategoryCatalogListResponseDto = {
@@ -5368,6 +5441,14 @@ export const $OnboardingAccountDto = {
       description:
         'Platform ID to bind the account to (references Platform.id); omit for unbound',
       example: 'c98e5d4a-2f71-4a5a-bb3c-92c9f231d5e2'
+    },
+    displayName: {
+      type: 'string',
+      description:
+        'User-set display name override (omit/null = keep the derived name)',
+      nullable: true,
+      maxLength: 50,
+      example: 'Salary card'
     }
   },
   required: ['path', 'currency']
@@ -6288,8 +6369,9 @@ export const $ClientParsedDataDto = {
     },
     category: {
       type: 'string',
-      description: 'Category slug',
-      example: 'food_restaurant'
+      description:
+        'Category in canonical form (catalog slug or Stage-2 rule keyword token, ADR-0116) — echo back verbatim from parsedData.category. Foreign forms (locale display names, account paths) are rejected with nlp.category.invalid.',
+      example: 'food'
     },
     incomeType: {
       type: 'string',
@@ -6389,6 +6471,25 @@ export const $ProcessNlpDto = {
       description:
         'confirm_account echo-back: account path selected from the prior confirm_account response (suggestedAccount, similarAccounts[i].path, or a typed path). Applied directly when the session is confirming_account — no NL re-parse.',
       example: 'Expenses:Food:Coffee'
+    },
+    viewpointAccount: {
+      type: 'string',
+      description:
+        'Viewpoint account hint: the beancount path the user drilled into (e.g. from an account drill-down). Tie-break only — never overrides accounts resolved from the text. Must be an owned, OPEN Assets:/Liabilities: account; unresolvable hints are silently ignored.',
+      example: 'Assets:CN:Bank:ICBC'
+    },
+    viewpointCategory: {
+      type: 'string',
+      description:
+        "Viewpoint category hint: the ADR-0075 Group segment the user drilled into (e.g. 'Food'). Resolved to a concrete OPEN account in that group; tie-break only — never overrides a category resolved from the text.",
+      example: 'Food'
+    },
+    viewpointFlow: {
+      type: 'string',
+      description:
+        "Companion flow root for viewpointCategory ('income' | 'expense'), mirroring the ADR-0126 list-endpoint invariant. Derived from the session's routed intent (multi-turn) when absent; a first-turn flow-less category hint is dropped — send the flow explicitly.",
+      enum: ['income', 'expense'],
+      example: 'expense'
     }
   }
 } as const;
@@ -6456,7 +6557,9 @@ export const $NlpParsedDataDto = {
     },
     category: {
       type: 'string',
-      description: 'Category'
+      description:
+        'Category in canonical form: a CATEGORY_CATALOG slug (GET /{region}/bean/categories) or a Stage-2 rule categoryKeywords token (ADR-0116 D2). Never a locale display name or a beancount account path. Echo back verbatim on confirm.',
+      example: 'food'
     },
     incomeType: {
       type: 'string',
@@ -7367,6 +7470,79 @@ export const $PlatformMatchResponseDto = {
   required: ['platforms', 'matchType', 'total', 'hasMore']
 } as const;
 
+export const $PlatformStandardsPlatformDto = {
+  type: 'object',
+  properties: {
+    id: {
+      type: 'string',
+      description: 'Global platform ID'
+    },
+    name: {
+      type: 'string',
+      description: 'Platform name (e.g., "ICBC")'
+    },
+    canonical: {
+      type: 'string',
+      description: 'Canonical identifier in ACCOUNT_RE format (e.g., "icbc")'
+    },
+    suggestedSegment: {
+      type: 'string',
+      description:
+        'Suggested path segment — canonical PascalCased per hyphen-part, hyphens preserved (e.g. "Apple-Pay")'
+    },
+    type: {
+      type: 'string',
+      description: 'Platform type',
+      enum: [
+        'BANK',
+        'BROKERAGE',
+        'CRYPTO_EXCHANGE',
+        'PAYMENT',
+        'INVESTMENT',
+        'INSURANCE',
+        'OTHER'
+      ]
+    },
+    category: {
+      type: 'string',
+      description:
+        'Region-aware category (institution vocab, e.g. DigitalWallet/Bank) resolved against the final region. null = no region-aware suggestion; fall back to type.',
+      nullable: true,
+      example: 'Bank'
+    }
+  },
+  required: ['id', 'name', 'canonical', 'suggestedSegment', 'type', 'category']
+} as const;
+
+export const $PlatformStandardsResponseDto = {
+  type: 'object',
+  properties: {
+    platform: {
+      description: 'The selected platform (institution lock source)',
+      allOf: [
+        {
+          $ref: '#/components/schemas/PlatformStandardsPlatformDto'
+        }
+      ]
+    },
+    region: {
+      type: 'string',
+      description:
+        "Resolved template region (ISO 3166-1 alpha-2, UPPERCASE): the platform's own countryCode when set, else the region query param. For regions without a regional template file the template list falls back to the universal-only catalog while region still echoes the code.",
+      example: 'CN'
+    },
+    templates: {
+      description:
+        'Candidate account-standard templates of the resolved region (groupable by productCategory client-side)',
+      type: 'array',
+      items: {
+        $ref: '#/components/schemas/AccountStandardResponseDto'
+      }
+    }
+  },
+  required: ['platform', 'region', 'templates']
+} as const;
+
 export const $CreatePlatformDto = {
   type: 'object',
   properties: {
@@ -7468,7 +7644,8 @@ export const $UpdatePlatformDto = {
     },
     isActive: {
       type: 'boolean',
-      description: 'Whether the platform is active'
+      description: 'Whether the platform is active',
+      default: true
     }
   }
 } as const;
@@ -7631,7 +7808,8 @@ export const $AccountItemDto = {
     },
     displayName: {
       type: 'string',
-      description: 'Display name (last part of account path)',
+      description:
+        'Display name: user-set name if provided (#762), else the ADR-0114 chain — request-locale catalog name, en pivot, then the last part of the account path (#771)',
       example: 'Savings'
     },
     balance: {
@@ -7667,7 +7845,8 @@ export const $PlatformGroupDto = {
       example: 'CMB Bank'
     },
     accounts: {
-      description: 'Accounts within this platform',
+      description:
+        'Accounts within this platform (Assets and Liabilities rows, #696)',
       type: 'array',
       items: {
         $ref: '#/components/schemas/AccountItemDto'
@@ -7675,7 +7854,8 @@ export const $PlatformGroupDto = {
     },
     totalBalance: {
       type: 'string',
-      description: 'FX-converted total balance in base currency',
+      description:
+        'FX-converted total balance in base currency (nets Assets + Liabilities rows; can be negative)',
       example: '100000.00'
     },
     balanceByCurrency: {
@@ -7694,7 +7874,7 @@ export const $PlatformGroupDto = {
     sharePct: {
       type: 'number',
       description:
-        'Share of the grand converted total (0-100); 0 when grand total is 0',
+        'Share of the converted asset-side grand total (0-100); liability balances are excluded from the basis; 0 when grand total is 0 (#696)',
       example: 42.5
     }
   },
@@ -7742,7 +7922,8 @@ export const $AccountsSummaryDto = {
   properties: {
     totalAccounts: {
       type: 'number',
-      description: 'Total number of accounts'
+      description:
+        'Total number of accounts (balance sheet: Assets + Liabilities, #696)'
     },
     totalPlatforms: {
       type: 'number',
@@ -7800,7 +7981,8 @@ export const $AccountItemWithAssetClassDto = {
     },
     displayName: {
       type: 'string',
-      description: 'Display name (last part of account path)',
+      description:
+        'Display name: user-set name if provided (#762), else the ADR-0114 chain — request-locale catalog name, en pivot, then the last part of the account path (#771)',
       example: 'Savings'
     },
     balance: {
@@ -8286,7 +8468,7 @@ export const $MonetaryDto = {
       example: 'USD'
     },
     baseCcyEquivalent: {
-      type: 'object',
+      type: 'string',
       description: 'Converted to user base currency (Decimal string)',
       example: '21600',
       nullable: true
@@ -8362,13 +8544,13 @@ export const $HoldingPnlRowDto = {
       example: 'Assets:US:Broker:AAPL'
     },
     accountCcy: {
-      type: 'object',
+      type: 'string',
       description: 'Account settlement currency (ISO 4217), from cost currency',
       nullable: true,
       example: 'USD'
     },
     brokerType: {
-      type: 'object',
+      type: 'string',
       description: 'Broker type derived from Platform.type',
       nullable: true,
       example: 'broker'
@@ -8389,7 +8571,7 @@ export const $HoldingPnlRowDto = {
       example: 'EQUITY'
     },
     assetSubClass: {
-      type: 'object',
+      type: 'string',
       nullable: true,
       example: 'STOCK'
     },
@@ -8436,14 +8618,14 @@ export const $HoldingPnlRowDto = {
       ]
     },
     unrealizedPnlBase: {
-      type: 'object',
+      type: 'string',
       description:
         'Unrealized P&L in base currency (Decimal string); null when any FX/price missing',
       nullable: true,
       example: '6000'
     },
     unrealizedPnlPct: {
-      type: 'object',
+      type: 'string',
       description: 'Unrealized P&L % (Decimal string)',
       nullable: true,
       example: '25'
@@ -8467,7 +8649,7 @@ export const $HoldingPnlRowDto = {
       ]
     },
     pctOfInvestedAssets: {
-      type: 'object',
+      type: 'string',
       description:
         'Share of invested assets % (Decimal string); only for invested chartTokens',
       nullable: true,
@@ -8512,15 +8694,15 @@ export const $HoldingPnlWarningDto = {
       ]
     },
     symbol: {
-      type: 'object',
+      type: 'string',
       nullable: true
     },
     accountId: {
-      type: 'object',
+      type: 'string',
       nullable: true
     },
     currency: {
-      type: 'object',
+      type: 'string',
       nullable: true
     }
   },
@@ -8802,35 +8984,35 @@ export const $SymbolSearchResultDto = {
       example: 'AAPL'
     },
     name: {
-      type: 'object',
+      type: 'string',
       example: 'Apple Inc.',
       nullable: true
     },
     exchange: {
-      type: 'object',
+      type: 'string',
       example: 'US',
       nullable: true
     },
     assetType: {
-      type: 'object',
+      type: 'string',
       description: 'OpenBB asset_type (e.g. stock, etf)',
       example: 'stock',
       nullable: true
     },
     assetClass: {
-      type: 'object',
+      type: 'string',
       description: 'IGN asset class (region.types.ts ASSET_CLASSES)',
       example: 'EQUITY',
       nullable: true
     },
     assetSubClass: {
-      type: 'object',
+      type: 'string',
       description: 'IGN asset sub-class (region.types.ts ASSET_SUB_CLASSES)',
       example: 'STOCK',
       nullable: true
     },
     currency: {
-      type: 'object',
+      type: 'string',
       description: 'Trading currency (extra_data or inferred from exchange)',
       example: 'USD',
       nullable: true
@@ -8847,90 +9029,90 @@ export const $SymbolQuoteDto = {
       example: 'AAPL'
     },
     name: {
-      type: 'object',
+      type: 'string',
       example: 'Apple Inc.',
       nullable: true
     },
     exchange: {
-      type: 'object',
+      type: 'string',
       example: 'US',
       nullable: true
     },
     assetType: {
-      type: 'object',
+      type: 'string',
       description: 'OpenBB asset_type',
       example: 'stock',
       nullable: true
     },
     assetClass: {
-      type: 'object',
+      type: 'string',
       description: 'IGN asset class',
       example: 'EQUITY',
       nullable: true
     },
     assetSubClass: {
-      type: 'object',
+      type: 'string',
       description: 'IGN asset sub-class',
       example: 'STOCK',
       nullable: true
     },
     currency: {
-      type: 'object',
+      type: 'string',
       description: 'Trading currency (extra_data or inferred from exchange)',
       example: 'USD',
       nullable: true
     },
     price: {
-      type: 'object',
+      type: 'string',
       description: 'Latest price (Decimal string)',
       example: '189.84',
       nullable: true
     },
     priceDate: {
-      type: 'object',
+      type: 'string',
       description: 'Date the price was observed (ISO yyyy-MM-dd)',
       example: '2026-08-05',
       nullable: true
     },
     changePercent: {
-      type: 'object',
+      type: 'number',
       description:
         'Change vs previous close, in percentage points (1.7 == 1.7%). openbb stores change_percent as a normalized decimal; this exposes percentage points for frontend convenience.',
       example: 1.7,
       nullable: true
     },
     prevClose: {
-      type: 'object',
+      type: 'string',
       description: 'Previous close (Decimal string)',
       nullable: true
     },
     open: {
-      type: 'object',
+      type: 'string',
       description: 'Day open (Decimal string)',
       nullable: true
     },
     high: {
-      type: 'object',
+      type: 'string',
       description: 'Day high (Decimal string)',
       nullable: true
     },
     low: {
-      type: 'object',
+      type: 'string',
       description: 'Day low (Decimal string)',
       nullable: true
     },
     volume: {
-      type: 'object',
+      type: 'string',
       description: 'Day volume (Decimal string)',
       nullable: true
     },
     yearHigh: {
-      type: 'object',
+      type: 'string',
       description: '52-week high (Decimal string)',
       nullable: true
     },
     yearLow: {
-      type: 'object',
+      type: 'string',
       description: '52-week low (Decimal string)',
       nullable: true
     }