fin-infra 0.1.82__py3-none-any.whl → 0.4.0__py3-none-any.whl

fin_infra/analytics/__init__.py

@@ -8,8 +8,8 @@ This module provides comprehensive financial analytics capabilities including:
 - Growth projections (net worth forecasting with scenarios)
 
 Feature Status:
-    ✅ STABLE: Core calculation functions (all analytics work with provided data)
-    ⚠️  INTEGRATION: Auto-fetching from providers requires setup:
+    [OK] STABLE: Core calculation functions (all analytics work with provided data)
+    [!]  INTEGRATION: Auto-fetching from providers requires setup:
         - Banking provider for transaction data
         - Brokerage provider for investment data
         - Categorization for expense categorization

fin_infra/analytics/add.py

@@ -239,9 +239,9 @@ def add_analytics(
 
         Note:
             Real holdings provide:
-            - Accurate cost basis → real profit/loss
-            - Security types → precise asset allocation
-            - Current values → live portfolio tracking
+            - Accurate cost basis -> real profit/loss
+            - Security types -> precise asset allocation
+            - Current values -> live portfolio tracking
         """
         # If with_holdings requested and investment provider available
         if with_holdings:

fin_infra/analytics/cash_flow.py

@@ -7,7 +7,7 @@ from __future__ import annotations
 
 from datetime import datetime, timedelta
 from decimal import Decimal
-from typing import Any, Optional
+from typing import Any
 
 from ..models import Transaction
 from .models import CashFlowAnalysis
@@ -17,7 +17,7 @@ async def calculate_cash_flow(
     user_id: str,
     start_date: str | datetime,
     end_date: str | datetime,
-    accounts: Optional[list[str]] = None,
+    accounts: list[str] | None = None,
     *,
     banking_provider=None,
     categorization_provider=None,
@@ -117,7 +117,7 @@ async def calculate_cash_flow(
 async def forecast_cash_flow(
     user_id: str,
     months: int = 6,
-    assumptions: Optional[dict[str, Any]] = None,
+    assumptions: dict[str, Any] | None = None,
     *,
     recurring_provider=None,
 ) -> list[CashFlowAnalysis]:

fin_infra/analytics/models.py

@@ -7,7 +7,7 @@ from __future__ import annotations
 
 from datetime import datetime
 from enum import Enum
-from typing import Any, Optional
+from typing import Any
 
 from pydantic import BaseModel, ConfigDict, Field
 
@@ -72,7 +72,7 @@ class SavingsRateData(BaseModel):
     expenses: float = Field(..., description="Total expenses for period")
     period: Period = Field(..., description="Period type")
     definition: SavingsDefinition = Field(..., description="Calculation method used")
-    trend: Optional[TrendDirection] = Field(None, description="Trend over time")
+    trend: TrendDirection | None = Field(None, description="Trend over time")
 
 
 class SpendingAnomaly(BaseModel):
@@ -132,7 +132,7 @@ class PersonalizedSpendingAdvice(BaseModel):
     alerts: list[str] = Field(
         default_factory=list, description="Urgent spending issues requiring attention"
     )
-    estimated_monthly_savings: Optional[float] = Field(
+    estimated_monthly_savings: float | None = Field(
         None, description="Potential monthly savings if recommendations followed"
     )
 
@@ -183,7 +183,7 @@ class BenchmarkComparison(BaseModel):
     benchmark_return_percent: float = Field(..., description="Benchmark return percentage")
     benchmark_symbol: str = Field(..., description="Benchmark ticker (e.g., SPY)")
     alpha: float = Field(..., description="Portfolio alpha (excess return)")
-    beta: Optional[float] = Field(None, description="Portfolio beta (volatility vs benchmark)")
+    beta: float | None = Field(None, description="Portfolio beta (volatility vs benchmark)")
     period: str = Field(..., description="Comparison period (1y, 3y, 5y, etc.)")
 
 
@@ -213,6 +213,6 @@ class GrowthProjection(BaseModel):
     assumptions: dict[str, Any] = Field(
         default_factory=dict, description="Assumptions used (inflation, returns, etc.)"
     )
-    confidence_intervals: Optional[dict[str, tuple[float, float]]] = Field(
+    confidence_intervals: dict[str, tuple[float, float]] | None = Field(
         None, description="95% confidence intervals by scenario"
     )

fin_infra/analytics/portfolio.py

@@ -527,10 +527,10 @@ def portfolio_metrics_with_holdings(holdings: list) -> PortfolioMetrics:
         PortfolioMetrics with real portfolio analysis
 
     Real Data Advantages:
-        - Actual cost basis → accurate P/L calculations
-        - Real security types → precise asset allocation
-        - Current market values → live portfolio value
-        - No mock data → production-ready analytics
+        - Actual cost basis -> accurate P/L calculations
+        - Real security types -> precise asset allocation
+        - Current market values -> live portfolio value
+        - No mock data -> production-ready analytics
 
     Limitations:
         - Day/YTD/MTD returns require historical snapshots (not in holdings)
@@ -652,7 +652,7 @@ def calculate_day_change_with_snapshot(
         Function matches holdings by account_id + security_id for accurate tracking
         of individual position changes (accounts for buys/sells, not just price moves).
     """
-    # Build lookup map for previous snapshot: (account_id, security_id) → value
+    # Build lookup map for previous snapshot: (account_id, security_id) -> value
     previous_map = {}
     for holding in previous_snapshot:
         key = (holding.account_id, holding.security.security_id)
@@ -703,13 +703,13 @@ def _calculate_allocation_from_holdings(
         list[AssetAllocation] with asset_class, value, and percentage
 
     Asset Class Mapping:
-        - equity → Stocks
-        - etf → Stocks (equity ETFs grouped with stocks)
-        - mutual_fund → Bonds (conservative assumption)
-        - bond → Bonds
-        - cash → Cash
-        - derivative → Other
-        - other → Other
+        - equity -> Stocks
+        - etf -> Stocks (equity ETFs grouped with stocks)
+        - mutual_fund -> Bonds (conservative assumption)
+        - bond -> Bonds
+        - cash -> Cash
+        - derivative -> Other
+        - other -> Other
     """
     from collections import defaultdict
 

fin_infra/analytics/spending.py

@@ -45,7 +45,6 @@ Examples:
 from collections import defaultdict
 from datetime import timedelta
 from decimal import Decimal
-from typing import Optional
 
 from fin_infra.analytics.models import (
     PersonalizedSpendingAdvice,
@@ -60,7 +59,7 @@ async def analyze_spending(
     user_id: str,
     *,
     period: str = "30d",
-    categories: Optional[list[str]] = None,
+    categories: list[str] | None = None,
     banking_provider=None,
     categorization_provider=None,
 ) -> SpendingInsight:
@@ -426,7 +425,7 @@ def _generate_mock_transactions(days: int) -> list[Transaction]:
 async def generate_spending_insights(
     spending_insight: SpendingInsight,
     *,
-    user_context: Optional[dict] = None,
+    user_context: dict | None = None,
     llm_provider=None,
 ) -> "PersonalizedSpendingAdvice":
     """Generate personalized spending insights using LLM.
@@ -521,7 +520,7 @@ async def generate_spending_insights(
 
 def _build_spending_insights_prompt(
     spending_insight: SpendingInsight,
-    user_context: Optional[dict] = None,
+    user_context: dict | None = None,
 ) -> str:
     """Build LLM prompt with financial context.
 
@@ -621,7 +620,7 @@ Be specific, encouraging, and actionable. Focus on realistic savings, not extrem
 
 def _generate_rule_based_insights(
     spending_insight: SpendingInsight,
-    user_context: Optional[dict] = None,
+    user_context: dict | None = None,
 ) -> "PersonalizedSpendingAdvice":
     """Generate rule-based insights when LLM is unavailable.
 

fin_infra/banking/history.py

@@ -4,7 +4,7 @@ This module provides functionality to record and retrieve historical account bal
 snapshots over time. This enables balance trend analysis, sparklines, and time-series
 visualizations in fintech dashboards.
 
-⚠️ WARNING: This module uses IN-MEMORY storage by default. All data is LOST on restart.
+[!] WARNING: This module uses IN-MEMORY storage by default. All data is LOST on restart.
 For production use, integrate with svc-infra SQL database or set FIN_INFRA_STORAGE_BACKEND.
 
 Features:
@@ -57,7 +57,7 @@ __all__ = [
 _logger = logging.getLogger(__name__)
 
 # In-memory storage for testing (will be replaced with SQL database in production)
-# ⚠️ WARNING: All data is LOST on restart when using in-memory storage!
+# [!] WARNING: All data is LOST on restart when using in-memory storage!
 _balance_snapshots: list[BalanceSnapshot] = []
 _production_warning_logged = False
 
@@ -73,7 +73,7 @@ def _check_in_memory_warning() -> None:
 
     if env in ("production", "staging") and storage_backend == "memory":
         _logger.warning(
-            "⚠️ CRITICAL: Balance history using IN-MEMORY storage in %s environment! "
+            "[!] CRITICAL: Balance history using IN-MEMORY storage in %s environment! "
             "All balance snapshots will be LOST on restart. "
             "Set FIN_INFRA_STORAGE_BACKEND=sql for production persistence.",
             env,
@@ -114,7 +114,7 @@ def record_balance_snapshot(
     This function stores a point-in-time balance record for trend analysis.
     In production, this would write to a SQL database via svc-infra.
 
-    ⚠️ WARNING: Uses in-memory storage by default. Data is LOST on restart!
+    [!] WARNING: Uses in-memory storage by default. Data is LOST on restart!
 
     Args:
         account_id: Account identifier

fin_infra/brokerage/__init__.py

@@ -1,6 +1,6 @@
 """Brokerage module - easy setup for trading operations.
 
-⚠️ **TRADING WARNING**: This module provides real trading capabilities.
+[!] **TRADING WARNING**: This module provides real trading capabilities.
 Always use paper trading mode for development and testing.
 Live trading requires explicit opt-in and involves real financial risk.
 
@@ -51,11 +51,11 @@ def easy_brokerage(
 ) -> BrokerageProvider:
     """Create a brokerage provider with paper/live trading support.
 
-    ⚠️ **SAFETY**: Defaults to paper trading mode. Live trading requires explicit mode="live".
+    [!] **SAFETY**: Defaults to paper trading mode. Live trading requires explicit mode="live".
 
     Auto-detects provider based on environment variables:
-    1. If ALPACA_API_KEY and ALPACA_API_SECRET are set → Alpaca
-    2. Otherwise → Raises error (credentials required)
+    1. If ALPACA_API_KEY and ALPACA_API_SECRET are set -> Alpaca
+    2. Otherwise -> Raises error (credentials required)
 
     Args:
         provider: Provider name ("alpaca"). If None, defaults to alpaca.
@@ -138,7 +138,7 @@ def add_brokerage(
 ) -> BrokerageProvider:
     """Wire brokerage provider to FastAPI app with routes and safety checks.
 
-    ⚠️ **TRADING WARNING**: This mounts trading API endpoints.
+    [!] **TRADING WARNING**: This mounts trading API endpoints.
     Always use paper trading mode for development.
     Live trading requires explicit mode="live" and proper safeguards.
 
@@ -280,7 +280,7 @@ def add_brokerage(
     async def submit_order(order_request: OrderRequest):
         """Submit a new order.
 
-        ⚠️ **TRADING WARNING**: This endpoint executes real trades in live mode.
+        [!] **TRADING WARNING**: This endpoint executes real trades in live mode.
         """
         try:
             order = brokerage_provider.submit_order(
@@ -447,7 +447,7 @@ def add_brokerage(
     add_prefixed_docs(
         app,
         prefix=prefix,
-        title="Brokerage" + (" (Paper Trading)" if mode == "paper" else " ⚠️ LIVE"),
+        title="Brokerage" + (" (Paper Trading)" if mode == "paper" else " [!] LIVE"),
         auto_exclude_from_root=True,
         visible_envs=None,  # Show in all environments
     )

fin_infra/budgets/alerts.py

@@ -35,7 +35,7 @@ Example:
 from __future__ import annotations
 
 from datetime import datetime
-from typing import TYPE_CHECKING, Optional
+from typing import TYPE_CHECKING
 
 from fin_infra.budgets.models import (
     AlertSeverity,
@@ -51,7 +51,7 @@ if TYPE_CHECKING:
 async def check_budget_alerts(
     budget_id: str,
     tracker: BudgetTracker,
-    thresholds: Optional[dict[str, float]] = None,
+    thresholds: dict[str, float] | None = None,
 ) -> list[BudgetAlert]:
     """
     Check budget for alerts (overspending, approaching limits, unusual patterns).

fin_infra/budgets/ease.py

@@ -12,7 +12,6 @@ Generic Design:
 from __future__ import annotations
 
 import os
-from typing import Optional
 
 from sqlalchemy.ext.asyncio import create_async_engine
 
@@ -20,7 +19,7 @@ from fin_infra.budgets.tracker import BudgetTracker
 
 
 def easy_budgets(
-    db_url: Optional[str] = None,
+    db_url: str | None = None,
     pool_size: int = 5,
     max_overflow: int = 10,
     pool_pre_ping: bool = True,

fin_infra/budgets/models.py

@@ -8,7 +8,6 @@ from __future__ import annotations
 
 from datetime import datetime
 from enum import Enum
-from typing import Optional
 
 from pydantic import BaseModel, ConfigDict, Field
 
@@ -296,7 +295,7 @@ class BudgetAlert(BaseModel):
     """
 
     budget_id: str = Field(..., description="Budget identifier")
-    category: Optional[str] = Field(None, description="Category triggering alert")
+    category: str | None = Field(None, description="Category triggering alert")
     alert_type: AlertType = Field(..., description="Type of alert")
     threshold: float = Field(..., description="Threshold that triggered alert")
     message: str = Field(..., description="Human-readable alert message")

fin_infra/budgets/templates.py

@@ -16,7 +16,7 @@ Generic Design:
 from __future__ import annotations
 
 from datetime import datetime
-from typing import TYPE_CHECKING, Optional
+from typing import TYPE_CHECKING
 
 from fin_infra.budgets.models import Budget, BudgetPeriod, BudgetType
 
@@ -177,9 +177,9 @@ async def apply_template(
     template_name: str,
     total_income: float,
     tracker: BudgetTracker,
-    budget_name: Optional[str] = None,
-    start_date: Optional[datetime] = None,
-    custom_template: Optional[BudgetTemplate] = None,
+    budget_name: str | None = None,
+    start_date: datetime | None = None,
+    custom_template: BudgetTemplate | None = None,
 ) -> Budget:
     """Apply a budget template to create a new budget.
 

fin_infra/budgets/tracker.py

@@ -36,7 +36,7 @@ from __future__ import annotations
 
 import uuid
 from datetime import datetime, timedelta
-from typing import TYPE_CHECKING, Optional
+from typing import TYPE_CHECKING
 
 from sqlalchemy.ext.asyncio import async_sessionmaker
 
@@ -116,7 +116,7 @@ class BudgetTracker:
         type: str,  # BudgetType value
         period: str,  # BudgetPeriod value
         categories: dict[str, float],
-        start_date: Optional[datetime] = None,
+        start_date: datetime | None = None,
         rollover_enabled: bool = False,
     ) -> Budget:
         """
@@ -205,7 +205,7 @@ class BudgetTracker:
     async def get_budgets(
         self,
         user_id: str,
-        type: Optional[str] = None,
+        type: str | None = None,
     ) -> list[Budget]:
         """
         Get all budgets for a user.

fin_infra/categorization/__init__.py

@@ -2,7 +2,7 @@
 Transaction categorization module.
 
 Provides ML-based categorization of merchant transactions into 56 categories
-using a hybrid approach (exact match → regex → sklearn Naive Bayes → LLM).
+using a hybrid approach (exact match -> regex -> sklearn Naive Bayes -> LLM).
 
 Basic usage:
     from fin_infra.categorization import categorize

fin_infra/categorization/ease.py

@@ -5,7 +5,7 @@ Provides one-line setup with sensible defaults.
 """
 
 from pathlib import Path
-from typing import Literal, Optional
+from typing import Literal
 
 from .engine import CategorizationEngine
 
@@ -21,10 +21,10 @@ def easy_categorization(
     taxonomy: str = "mx",
     enable_ml: bool = False,
     confidence_threshold: float = 0.6,
-    model_path: Optional[Path] = None,
+    model_path: Path | None = None,
     # LLM-specific parameters (V2)
     llm_provider: Literal["google", "openai", "anthropic", "none"] = "google",
-    llm_model: Optional[str] = None,
+    llm_model: str | None = None,
     llm_confidence_threshold: float = 0.6,
     llm_cache_ttl: int = 86400,  # 24 hours
     llm_max_cost_per_day: float = 0.10,  # $0.10/day

fin_infra/categorization/engine.py

@@ -1,5 +1,5 @@
 """
-Hybrid categorization engine (exact → regex → ML → LLM).
+Hybrid categorization engine (exact -> regex -> ML -> LLM).
 
 4-layer approach:
 1. Layer 1 (Exact Match): O(1) dictionary lookup, 85-90% coverage

fin_infra/categorization/llm_layer.py

@@ -197,7 +197,7 @@ class LLMCategorizer:
             self._track_cost()
 
             logger.info(
-                f"LLM categorized '{merchant_name}' → {prediction.category} "
+                f"LLM categorized '{merchant_name}' -> {prediction.category} "
                 f"(confidence={prediction.confidence:.2f})"
             )
 
@@ -252,7 +252,7 @@ class LLMCategorizer:
         # Format few-shot examples
         examples_text = "\n\n".join(
             [
-                f'Merchant: "{merchant}"\n→ Category: "{category}"\n→ Reasoning: "{reasoning}"'
+                f'Merchant: "{merchant}"\n-> Category: "{category}"\n-> Reasoning: "{reasoning}"'
                 for merchant, category, reasoning in FEW_SHOT_EXAMPLES
             ]
         )
@@ -300,6 +300,8 @@ Return JSON with category, confidence, and reasoning."""
     def _get_cache_key(self, merchant_name: str) -> str:
         """Generate stable cache key from merchant name."""
         normalized = merchant_name.lower().strip()
+        # Security: B324 skip justified - MD5 used for cache key generation only,
+        # not for security. We need deterministic hashing for cache lookups.
         hash_value = hashlib.md5(normalized.encode()).hexdigest()
         return f"llm_category:{hash_value}"
 
@@ -338,10 +340,10 @@ Return JSON with category, confidence, and reasoning."""
 
     def reset_daily_cost(self):
         """Reset daily cost counter (called at midnight UTC)."""
-        logger.info(f"Resetting daily cost: ${self.daily_cost:.5f} → $0.00")
+        logger.info(f"Resetting daily cost: ${self.daily_cost:.5f} -> $0.00")
         self.daily_cost = 0.0
 
     def reset_monthly_cost(self):
         """Reset monthly cost counter (called on 1st of month)."""
-        logger.info(f"Resetting monthly cost: ${self.monthly_cost:.5f} → $0.00")
+        logger.info(f"Resetting monthly cost: ${self.monthly_cost:.5f} -> $0.00")
         self.monthly_cost = 0.0

fin_infra/categorization/models.py

@@ -4,7 +4,6 @@ Pydantic models for transaction categorization.
 
 from datetime import datetime
 from enum import Enum
-from typing import Optional
 
 from pydantic import BaseModel, ConfigDict, Field
 
@@ -34,7 +33,7 @@ class CategoryPrediction(BaseModel):
         default_factory=list,
         description="Alternative predictions (category, confidence)",
     )
-    reasoning: Optional[str] = Field(None, description="Explanation of prediction (for LLM)")
+    reasoning: str | None = Field(None, description="Explanation of prediction (for LLM)")
 
     model_config = ConfigDict(
         json_schema_extra={
@@ -100,7 +99,7 @@ class CategorizationRequest(BaseModel):
     """Request to categorize a merchant."""
 
     merchant_name: str = Field(..., description="Merchant name to categorize")
-    user_id: Optional[str] = Field(None, description="User ID for personalized overrides")
+    user_id: str | None = Field(None, description="User ID for personalized overrides")
     include_alternatives: bool = Field(default=False, description="Include alternative predictions")
     min_confidence: float = Field(
         default=0.0,
@@ -152,7 +151,7 @@ class CategoryStats(BaseModel):
     total_categories: int = Field(..., description="Total number of categories")
     categories_by_group: dict[str, int] = Field(..., description="Category counts by group")
     total_rules: int = Field(..., description="Total number of rules")
-    cache_hit_rate: Optional[float] = Field(None, description="Cache hit rate (0-1)")
+    cache_hit_rate: float | None = Field(None, description="Cache hit rate (0-1)")
 
     model_config = ConfigDict(
         json_schema_extra={

fin_infra/chat/planning.py

@@ -173,7 +173,7 @@ Answer: "To assess your retirement progress, I need more information: (1) What's
 Follow-ups: ["I want to retire at 65 with $1.5M", "How much should I save monthly?", "What's a realistic retirement goal?"]
 Sources: []
 
-⚠️ This is AI-generated advice. Not a substitute for a certified financial advisor.
+[!] This is AI-generated advice. Not a substitute for a certified financial advisor.
 Verify calculations independently. For personalized advice, consult a professional."""
 
 

fin_infra/cli/cmds/scaffold_cmds.py

@@ -102,7 +102,7 @@ def cmd_scaffold(
     # Validate required parameters
     if dest_dir is None:
         typer.secho(
-            "❌ Error: --dest-dir is required",
+            "[X] Error: --dest-dir is required",
             fg=typer.colors.RED,
             err=True,
         )
@@ -137,7 +137,7 @@ def cmd_scaffold(
         )
     else:
         typer.secho(
-            f"❌ Unknown domain: {domain}. Must be one of: budgets, goals",
+            f"[X] Unknown domain: {domain}. Must be one of: budgets, goals",
             fg=typer.colors.RED,
             err=True,
         )
@@ -145,7 +145,7 @@ def cmd_scaffold(
 
     # Display results
     typer.echo("")
-    typer.secho("📦 Scaffold Results:", bold=True)
+    typer.secho(" Scaffold Results:", bold=True)
     typer.echo("")
 
     files = result.get("files", [])
@@ -157,7 +157,7 @@ def cmd_scaffold(
         action = file_info.get("action", "unknown")
 
         if action == "wrote":
-            typer.secho(f"  ✓ Created: {path}", fg=typer.colors.GREEN)
+            typer.secho(f"  [OK] Created: {path}", fg=typer.colors.GREEN)
             wrote_count += 1
         elif action == "skipped":
             reason = file_info.get("reason", "unknown")
@@ -168,7 +168,7 @@ def cmd_scaffold(
 
     # Summary
     typer.echo("")
-    typer.secho(f"✨ Done! Created {wrote_count} file(s), skipped {skipped_count}.", bold=True)
+    typer.secho(f" Done! Created {wrote_count} file(s), skipped {skipped_count}.", bold=True)
     typer.echo("")
 
     # Next steps
@@ -187,7 +187,7 @@ def cmd_scaffold(
         }
         route_prefix = prefix_map.get(domain, f"/{domain}")
 
-        typer.secho("📝 Next Steps:", bold=True)
+        typer.secho(" Next Steps:", bold=True)
         typer.echo("")
         typer.echo("  1. Review generated files and customize as needed")
         typer.echo("  2. Run migrations:")

fin_infra/credit/experian/parser.py

@@ -1,11 +1,11 @@
 """Response parsers for Experian API data to fin_infra models.
 
 Converts Experian API JSON responses to typed Pydantic models:
-- parse_credit_score(): dict → CreditScore
-- parse_credit_report(): dict → CreditReport
-- parse_account(): dict → CreditAccount
-- parse_inquiry(): dict → CreditInquiry
-- parse_public_record(): dict → PublicRecord
+- parse_credit_score(): dict -> CreditScore
+- parse_credit_report(): dict -> CreditReport
+- parse_account(): dict -> CreditAccount
+- parse_inquiry(): dict -> CreditInquiry
+- parse_public_record(): dict -> PublicRecord
 
 Example:
     >>> data = await client.get_credit_score("user123")

fin_infra/crypto/__init__.py

@@ -29,8 +29,8 @@ def easy_crypto(
     """Create a crypto data provider with zero or minimal configuration.
 
     Auto-detects provider based on environment variables:
-    1. If COINGECKO_API_KEY is set → CoinGecko Pro
-    2. Otherwise → CoinGecko Free (no key needed)
+    1. If COINGECKO_API_KEY is set -> CoinGecko Pro
+    2. Otherwise -> CoinGecko Free (no key needed)
 
     Args:
         provider: Provider name ("coingecko"). If None, defaults to coingecko.

fin_infra/documents/models.py

@@ -31,7 +31,6 @@ from __future__ import annotations
 
 from datetime import datetime
 from enum import Enum
-from typing import Optional
 
 from pydantic import BaseModel, ConfigDict, Field
 from svc_infra.documents import Document as BaseDocument
@@ -111,8 +110,8 @@ class FinancialDocument(BaseDocument):
 
     # Financial-specific fields
     type: DocumentType = Field(..., description="Document type category (financial-specific)")
-    tax_year: Optional[int] = Field(None, description="Tax year for tax documents (e.g., 2024)")
-    form_type: Optional[str] = Field(None, description="Tax form type (W-2, 1099-INT, 1040, etc.)")
+    tax_year: int | None = Field(None, description="Tax year for tax documents (e.g., 2024)")
+    form_type: str | None = Field(None, description="Tax form type (W-2, 1099-INT, 1040, etc.)")
 
 
 # Backward compatibility: alias for existing code

fin_infra/goals/management.py

@@ -182,7 +182,7 @@ Your response: {
   "confidence": 0.94
 }
 
-⚠️ This is AI-generated advice. Not a substitute for a certified financial advisor.
+[!] This is AI-generated advice. Not a substitute for a certified financial advisor.
 Verify calculations independently. For personalized advice, consult a professional."""
 
 GOAL_PROGRESS_SYSTEM_PROMPT = """You are a financial advisor reviewing goal progress.
@@ -237,7 +237,7 @@ Your response: {
   "projected_completion_date": "2029-06-01",
   "variance_from_target_days": -365,
   "course_corrections": [
-    "⚠️ 12 months behind! Current $1,000/month payment needs to increase to $1,500/month",
+    "[!] 12 months behind! Current $1,000/month payment needs to increase to $1,500/month",
     "Emergency: reduce expenses by $500/month (cancel subscriptions, cut entertainment)",
     "Contact debt counselor for consolidation or negotiation options",
     "Consider side income: gig work, selling unused items ($500/month target)",
@@ -246,7 +246,7 @@ Your response: {
   "confidence": 0.95
 }
 
-⚠️ This is AI-generated advice. Not a substitute for a certified financial advisor.
+[!] This is AI-generated advice. Not a substitute for a certified financial advisor.
 Verify calculations independently. For personalized advice, consult a professional."""