Remove market compatibility reexports and fix example imports

Author: 9000wattz

.agents/skills/add-feature/SKILL.md

@@ -73,6 +73,9 @@ def test_example() -> None:
 python tools/validate_add_feature.py validate --mark-passed
 ```
 
+Use ordinary `validate` runs as a fast checkpoint during work.
+Use `validate --full` if you want the heavyweight repo-wide gate without closing the workflow.
+
 12. If the workflow becomes stale or the task is abandoned, clear the active state explicitly:
 
 ```bash
@@ -117,6 +120,9 @@ The validator will fail if:
 - conditional categories required by public API, workflow, docs, or examples are missing
 - the repo validation commands fail
 
+`validate` runs the fast checkpoint command set for in-progress work.
+`validate --full` and `validate --mark-passed` run the heavyweight repo-wide command bundle.
+
 The Stop hook uses `.tmp/add-feature/.state.json` and blocks completion until the workflow is marked passed.
 `validate --mark-passed` and `clear` automatically delete the temporary spec, temporary review files, and workflow state.
 The UserPromptSubmit hook also injects workflow instructions whenever the user uses `$add-feature`.

README.md

@@ -30,7 +30,7 @@ from decimal import Decimal
 
 from fuggers_py.calc import PricingSpec
 from fuggers_py.core import Currency, Date, Price
-from fuggers_py.market import AnalyticsCurves, QuoteSide
+from fuggers_py.market.state import AnalyticsCurves, QuoteSide
 
 as_of = Date.from_ymd(2026, 1, 15)
 clean_price = Price.new(Decimal("99.125"), Currency.USD)

docs/MODULE_REFERENCE.md

@@ -674,12 +674,26 @@ Overnight fixing conventions and compounding helpers.
 - Module path: `market/indices/overnight.py`
 - Top-level classes/functions: `_to_decimal`, `OvernightCompounding`, `PublicationTime`, `_business_accrual_schedule`, `observation_date`, `_observed_schedule_date`, `publication_date`, `overnight_factor`, `_lookup_or_project_rate`
 
-### `market/market_data.py`
+### `market/quotes.py`
 
-Market-data traits and in-memory research helpers.
+Canonical quote protocols and concrete quote records.
 
-- Module path: `market/market_data.py`
-- Top-level classes/functions: `_to_decimal`, `_coerce_decimal_fields`, `_apply_two_sided_quote_defaults`, `SourceType`, `CurveInstrumentType`, `VolSurfaceType`, `VolQuoteType`, `InflationInterpolation`, `RawQuote`, `CurvePoint`, `CurveInput`, `CurveInputs`, `BondQuote`, `RepoQuote`, `SwapQuote`, `BasisSwapQuote`, `BondFutureQuote`, `FxForwardQuote`, `CdsQuote`, `HaircutQuote`, `CurveData`, `IndexFixing`, `VolPoint`, `VolatilitySurface`, `FxRate`, `InflationFixing`, `EtfHolding`, `EtfQuote`, `MarketDataSnapshot`, `QuoteSource`, `CurveInputSource`, `IndexFixingSource`, `ReferenceCurveSource`, `VolatilitySource`, `FxRateSource`, `InflationFixingSource`, `EtfQuoteSource`, `PricingDataProvider`, `InMemoryQuoteSource`, `InMemoryCurveSource`, `InMemoryFixingSource`, `InMemoryVolatilitySource`, `InMemoryFxRateSource`, `InMemoryInflationFixingSource`, `InMemoryEtfQuoteSource`, `MarketDataProvider`
+- Module path: `market/quotes.py`
+- Top-level classes/functions: `SourceType`, `RawQuote`, `BondQuote`, `RepoQuote`, `SwapQuote`, `BasisSwapQuote`, `BondFutureQuote`, `FxForwardQuote`, `CdsQuote`, `HaircutQuote`, `InstrumentQuote`, `ScalarQuote`, `AnyInstrumentQuote`
+
+### `market/snapshot.py`
+
+Canonical snapshot records, stored fixings, surfaces, and ETF holdings.
+
+- Module path: `market/snapshot.py`
+- Top-level classes/functions: `CurveInstrumentType`, `VolSurfaceType`, `VolQuoteType`, `InflationInterpolation`, `CurvePoint`, `CurveInput`, `CurveInputs`, `CurveData`, `IndexFixing`, `VolPoint`, `VolatilitySurface`, `FxRate`, `InflationFixing`, `EtfHolding`, `EtfQuote`, `MarketDataSnapshot`, `CurveInputSet`
+
+### `market/sources.py`
+
+Canonical market-data source protocols and in-memory providers.
+
+- Module path: `market/sources.py`
+- Top-level classes/functions: `QuoteSource`, `CurveInputSource`, `IndexFixingSource`, `ReferenceCurveSource`, `VolatilitySource`, `FxRateSource`, `InflationFixingSource`, `EtfQuoteSource`, `PricingDataProvider`, `CurveSource`, `FixingSource`, `InMemoryQuoteSource`, `InMemoryCurveSource`, `InMemoryFixingSource`, `InMemoryVolatilitySource`, `InMemoryFxRateSource`, `InMemoryInflationFixingSource`, `InMemoryEtfQuoteSource`, `MarketDataProvider`
 
 ### `market/state.py`
 

docs/api/market.md

@@ -2,6 +2,17 @@
 
 Market state, quotes, fixings, indices, and curve abstractions.
 
+Canonical market modules:
+
+- `fuggers_py.market.state`
+  - market state helpers such as `QuoteSide` and `AnalyticsCurves`
+- `fuggers_py.market.quotes`
+  - quote protocols and concrete quote families
+- `fuggers_py.market.snapshot`
+  - curve inputs, fixings, surfaces, ETF holdings, and `MarketDataSnapshot`
+- `fuggers_py.market.sources`
+  - source protocols, in-memory sources, and `MarketDataProvider`
+
 ```{automodule} fuggers_py.market
 :members:
 :member-order: bysource

examples/02_financed_tips_multi_curve_workflow.ipynb

@@ -27,7 +27,8 @@
     "from fuggers_py.core import Compounding, Currency, Date, Frequency, Price, YearMonth, Yield\n",
     "from fuggers_py.core.calendars import BusinessDayConvention\n",
     "from fuggers_py.core.daycounts import DayCountConvention\n",
-    "from fuggers_py.market import InflationFixing as InflationFixingPoint, InMemoryInflationFixingSource\n",
+    "from fuggers_py.market.snapshot import InflationFixing as InflationFixingPoint\n",
+    "from fuggers_py.market.sources import InMemoryInflationFixingSource\n",
     "from fuggers_py.market.curves import DiscountCurveBuilder\n",
     "from fuggers_py.market.curves.funding import RepoCurve\n",
     "from fuggers_py.market.curves.inflation import bootstrap_inflation_curve\n",

examples/03_credit_basis_cross_market_and_optionality.ipynb

@@ -32,7 +32,8 @@
     "\n",
     "from fuggers_py.core import Currency, Date, Frequency, Price\n",
     "from fuggers_py.core.daycounts import DayCountConvention\n",
-    "from fuggers_py.market import AnalyticsCurves, CdsQuote\n",
+    "from fuggers_py.market.quotes import CdsQuote\n",
+    "from fuggers_py.market.state import AnalyticsCurves\n",
     "from fuggers_py.market.curves import DiscountCurveBuilder\n",
     "from fuggers_py.market.curves.credit import bootstrap_credit_curve\n",
     "from fuggers_py.market.curves.funding import RepoCurve\n",

examples/04_portfolio_etf_and_engine_pipeline.ipynb

@@ -37,7 +37,9 @@
     "from fuggers_py.core import Currency, Date, Frequency, Price, YearMonth, Yield\n",
     "from fuggers_py.core.calendars import BusinessDayConvention\n",
     "from fuggers_py.core.daycounts import DayCountConvention\n",
-    "from fuggers_py.market import CurveInputs, CurvePoint, InflationFixing as RealizedCpiPoint, InMemoryInflationFixingSource as RealizedCpiSource, MarketDataSnapshot, RawQuote\n",
+    "from fuggers_py.market.quotes import RawQuote\n",
+    "from fuggers_py.market.snapshot import CurveInputs, CurvePoint, InflationFixing as RealizedCpiPoint, MarketDataSnapshot\n",
+    "from fuggers_py.market.sources import InMemoryInflationFixingSource as RealizedCpiSource\n",
     "from fuggers_py.market.curves.funding import RepoCurve\n",
     "from fuggers_py.market.curves.inflation import bootstrap_inflation_curve\n",
     "from fuggers_py.portfolio import Classification, Holding, KeyRateShiftScenario, PortfolioAnalytics, PortfolioBenchmark, PortfolioBuilder, RateShockScenario, SecYieldInput, SpreadShockScenario, build_creation_basket, calculate_etf_nav_metrics, calculate_portfolio_analytics, calculate_sec_yield, estimate_yield_from_holdings, run_stress_scenarios\n",

examples/05_fitted_nominal_real_breakeven_minimal.ipynb

@@ -12,7 +12,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 8,
+   "execution_count": 1,
    "id": "imports",
    "metadata": {},
    "outputs": [],
@@ -35,18 +35,21 @@
     "import pandas as pd\n",
     "\n",
     "from fuggers_py.core import Currency, Date, Frequency, YearMonth\n",
-    "from fuggers_py.market import InflationFixing, InMemoryInflationFixingSource\n",
-    "import fuggers_py.market.market_data as market_data\n",
+    "from fuggers_py.market.snapshot import InflationFixing\n",
+    "from fuggers_py.market.sources import InMemoryInflationFixingSource\n",
+    "import fuggers_py.market.quotes as market_quotes\n",
     "import fuggers_py.market.curves.fitted_bonds.fair_value as fitted_fair_value\n",
+    "import fuggers_py.market.curves.fitted_bonds.inputs as fitted_inputs\n",
     "import fuggers_py.market.curves.fitted_bonds.model as fitted_model\n",
     "import fuggers_py.market.curves.fitted_bonds.optimization as fitted_optimization\n",
     "import fuggers_py.market.curves.fitted_bonds.par_curve as fitted_par_curve\n",
     "import fuggers_py.market.curves.fitted_bonds.pricing_adapters as fitted_pricing_adapters\n",
     "import fuggers_py.market.curves.inflation.breakeven as inflation_breakeven\n",
     "\n",
     "for module in (\n",
-    "    market_data,\n",
+    "    market_quotes,\n",
     "    fitted_fair_value,\n",
+    "    fitted_inputs,\n",
     "    fitted_model,\n",
     "    fitted_pricing_adapters,\n",
     "    fitted_optimization,\n",
@@ -55,11 +58,12 @@
     "):\n",
     "    importlib.reload(module)\n",
     "\n",
-    "BondQuote = market_data.BondQuote\n",
+    "BondQuote = market_quotes.BondQuote\n",
     "BreakevenParCurve = inflation_breakeven.BreakevenParCurve\n",
     "BreakevenZeroCurve = inflation_breakeven.BreakevenZeroCurve\n",
     "CubicSplineZeroRateCurveModel = fitted_model.CubicSplineZeroRateCurveModel\n",
     "FittedBondCurveFitter = fitted_optimization.FittedBondCurveFitter\n",
+    "FittedBondObservation = fitted_inputs.FittedBondObservation\n",
     "FittedParYieldCurve = fitted_par_curve.FittedParYieldCurve\n",
     "NominalGovernmentBondPricingAdapter = fitted_pricing_adapters.NominalGovernmentBondPricingAdapter\n",
     "ParCurveSpec = fitted_par_curve.ParCurveSpec\n",
@@ -82,7 +86,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 9,
+   "execution_count": 2,
    "id": "setup-code",
    "metadata": {},
    "outputs": [],
@@ -169,7 +173,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 10,
+   "execution_count": 3,
    "id": "nominal-obs",
    "metadata": {},
    "outputs": [
@@ -203,7 +207,7 @@
          "type": "float"
         }
        ],
-       "ref": "295dcafc-27a4-4978-a908-ee330e78b54b",
+       "ref": "cfe0ed84-eaf1-40ec-a270-62e6960ee18d",
        "rows": [
         [
          "0",
@@ -335,7 +339,7 @@
        "5        UST10Y              10        3.50      101.127"
       ]
      },
-     "execution_count": 10,
+     "execution_count": 3,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -356,11 +360,14 @@
     "    bond = build_nominal_bond(maturity_years, coupon_rate)\n",
     "    clean_price = dirty_price_from_curve(bond, TRUE_NOMINAL_CURVE, REFERENCE_DATE) - bond.accrued_interest(REFERENCE_DATE)\n",
     "    nominal_observations.append(\n",
-    "        BondQuote(\n",
-    "            instrument_id=instrument_id,\n",
+    "        FittedBondObservation.from_parts(\n",
     "            bond=bond,\n",
-    "            clean_price=clean_price,\n",
-    "            as_of=REFERENCE_DATE,\n",
+    "            quote=BondQuote(\n",
+    "                instrument_id=instrument_id,\n",
+    "                clean_price=clean_price,\n",
+    "                as_of=REFERENCE_DATE,\n",
+    "                currency=Currency.USD,\n",
+    "            ),\n",
     "            settlement_date=REFERENCE_DATE,\n",
     "        )\n",
     "    )\n",
@@ -379,7 +386,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 11,
+   "execution_count": 4,
    "id": "tips-obs",
    "metadata": {},
    "outputs": [
@@ -413,7 +420,7 @@
          "type": "float"
         }
        ],
-       "ref": "7361fb4f-ab6c-45ec-b675-91b66f83f0a9",
+       "ref": "e0dabd22-46f1-4be8-9a29-d5a2b5979b25",
        "rows": [
         [
          "0",
@@ -530,7 +537,7 @@
        "4       TIPS10Y              10        1.10           134.343"
       ]
      },
-     "execution_count": 11,
+     "execution_count": 4,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -550,11 +557,14 @@
     "    bond = build_tips_bond(maturity_years, coupon_rate)\n",
     "    clean_price = tips_dirty_price_from_curve(bond) - bond.accrued_interest(REFERENCE_DATE, fixing_source=FIXING_SOURCE)\n",
     "    tips_observations.append(\n",
-    "        BondQuote(\n",
-    "            instrument_id=instrument_id,\n",
+    "        FittedBondObservation.from_parts(\n",
     "            bond=bond,\n",
-    "            clean_price=clean_price,\n",
-    "            as_of=REFERENCE_DATE,\n",
+    "            quote=BondQuote(\n",
+    "                instrument_id=instrument_id,\n",
+    "                clean_price=clean_price,\n",
+    "                as_of=REFERENCE_DATE,\n",
+    "                currency=Currency.USD,\n",
+    "            ),\n",
     "            settlement_date=REFERENCE_DATE,\n",
     "        )\n",
     "    )\n",
@@ -583,7 +593,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 12,
+   "execution_count": 5,
    "id": "fit-code",
    "metadata": {},
    "outputs": [
@@ -617,7 +627,7 @@
          "type": "float"
         }
        ],
-       "ref": "786d7629-278b-486c-9741-2167531cf161",
+       "ref": "7c900d8f-6904-4a12-922d-6d20583d6243",
        "rows": [
         [
          "0",
@@ -689,7 +699,7 @@
        "1     real       True                  0.0                  0.0"
       ]
      },
-     "execution_count": 12,
+     "execution_count": 5,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -736,7 +746,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 13,
+   "execution_count": 6,
    "id": "derived-code",
    "metadata": {},
    "outputs": [
@@ -785,7 +795,7 @@
          "type": "float"
         }
        ],
-       "ref": "1c31ff7c-1b91-42d7-9cb3-43cf73552a91",
+       "ref": "442e9a51-21fa-42df-823a-07885a4fce6e",
        "rows": [
         [
          "0",
@@ -942,7 +952,7 @@
        "4            3.367         0.784              2.582  "
       ]
      },
-     "execution_count": 13,
+     "execution_count": 6,
      "metadata": {},
      "output_type": "execute_result"
     }
@@ -971,7 +981,7 @@
   },
   {
    "cell_type": "code",
-   "execution_count": 14,
+   "execution_count": 7,
    "id": "plots",
    "metadata": {},
    "outputs": [

examples/README.md

@@ -0,0 +1,16 @@
+# Examples
+
+This folder is a small map of the example notebooks.
+
+- `01_cash_bond_and_curve_workflow.ipynb`
+  Cash bond pricing and curve work.
+- `02_financed_tips_multi_curve_workflow.ipynb`
+  TIPS pricing with funding and more than one curve.
+- `03_credit_basis_cross_market_and_optionality.ipynb`
+  Credit basis, cross-market views, and embedded option cases.
+- `04_portfolio_etf_and_engine_pipeline.ipynb`
+  Portfolio, ETF, and engine flow in one place.
+- `05_fitted_nominal_real_breakeven_minimal.ipynb`
+  Minimal fitted nominal, real, and breakeven workflow.
+
+`synthetic_data/` holds the small input files used by the notebooks.