ms-markets 2.2.1.dev8__tar.gz → 2.2.2__tar.gz

{ms_markets-2.2.1.dev8 → ms_markets-2.2.2}/CHANGELOG.md

@@ -7,6 +7,33 @@ and this project follows versioned releases.
 
 ## [Unreleased]
 
+## [2.2.2] - 2026-10-03
+
+### Changed
+
+- Requires `mainsequence-metatable>=0.1.17,<0.2`; the lock and exported
+  `requirements.txt` select `mainsequence-metatable` 0.1.17. Earlier releases
+  refuse to finalize tables with cascading foreign keys
+  (`cascading_foreign_key_unsupported`), so the ms-markets provider could not
+  finish `migrations upgrade`. MetaTables 0.1.17 allows them: writing a table
+  requires write access on every table its cascades modify. The ms-markets
+  cascades are unchanged.
+- Refreshed the MetaTables agent skills to 0.1.17. They document explicit
+  `__storage_layout__` names, cascading foreign keys and the `get_impact`
+  pre-flight.
+
+### Fixed
+
+- `PortfolioEventLedgerTS` declares an explicit `__storage_layout__` whose
+  lookup index is named `portfolio_event_ledger_identity`. The default layout
+  derived a 70-character name from its four identity dimensions, which
+  MetaTables rejects (it never shortens derived names), so the ms-markets
+  migration provider could not be applied in any new environment
+  ([#19](https://github.com/mainsequence-projects/MainSequenceMarkets/issues/19)).
+  A test runs the MetaTables layout check on every provider time-index model.
+
+## [2.2.1] - 2026-10-03
+
 ### Changed
 
 - The VS Code launch configurations and tasks that check, apply and downgrade

{ms_markets-2.2.1.dev8 → ms_markets-2.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ms-markets
-Version: 2.2.1.dev8
+Version: 2.2.2
 Summary: Financial markets ORM, engines, and application management extensions for Main Sequence.
 Project-URL: Changelog, https://github.com/mainsequence-projects/MainSequenceMarkets/blob/main/CHANGELOG.md
 Project-URL: Source, https://github.com/mainsequence-projects/MainSequenceMarkets
@@ -227,7 +227,7 @@ Requires-Python: <3.14,>=3.13
 Requires-Dist: alembic>=1.18.4
 Requires-Dist: cachetools
 Requires-Dist: fastapi>=0.136.3
-Requires-Dist: mainsequence-metatable<0.2,>=0.1.14
+Requires-Dist: mainsequence-metatable<0.2,>=0.1.17
 Requires-Dist: mainsequence<10,>=9.0.5
 Requires-Dist: numpy
 Requires-Dist: pandas
@@ -385,7 +385,7 @@ Recommended entry points:
 ## Quick Start
 
 `ms-markets` 2.x requires Python 3.13, Main Sequence SDK `>=9.0.5,<10`, and
-the MetaTables client `mainsequence-metatable>=0.1.14,<0.2`, which is imported
+the MetaTables client `mainsequence-metatable>=0.1.17,<0.2`, which is imported
 as `metatables`. SDK 8 and earlier are not supported; install a 1.x
 `ms-markets` release when maintaining an SDK 8 project. See
 [ADR 0043](https://mainsequence-projects.github.io/MainSequenceMarkets/ADR/0043-sdk-9-metatables-client-hard-cut/)
@@ -503,7 +503,7 @@ The core stack starts with:
 
 - `mainsequence>=9.0.5,<10` for identity, login, Git source context,
   CodeRepository, jobs, and agents
-- `mainsequence-metatable>=0.1.14,<0.2` (import `metatables`) for MetaTables,
+- `mainsequence-metatable>=0.1.17,<0.2` (import `metatables`) for MetaTables,
   time-index table updaters, governed compiled SQL, and application-owned
   Alembic migrations
 - `SQLAlchemy` for market-domain ORM models

{ms_markets-2.2.1.dev8 → ms_markets-2.2.2}/README.md

@@ -108,7 +108,7 @@ Recommended entry points:
 ## Quick Start
 
 `ms-markets` 2.x requires Python 3.13, Main Sequence SDK `>=9.0.5,<10`, and
-the MetaTables client `mainsequence-metatable>=0.1.14,<0.2`, which is imported
+the MetaTables client `mainsequence-metatable>=0.1.17,<0.2`, which is imported
 as `metatables`. SDK 8 and earlier are not supported; install a 1.x
 `ms-markets` release when maintaining an SDK 8 project. See
 [ADR 0043](https://mainsequence-projects.github.io/MainSequenceMarkets/ADR/0043-sdk-9-metatables-client-hard-cut/)
@@ -226,7 +226,7 @@ The core stack starts with:
 
 - `mainsequence>=9.0.5,<10` for identity, login, Git source context,
   CodeRepository, jobs, and agents
-- `mainsequence-metatable>=0.1.14,<0.2` (import `metatables`) for MetaTables,
+- `mainsequence-metatable>=0.1.17,<0.2` (import `metatables`) for MetaTables,
   time-index table updaters, governed compiled SQL, and application-owned
   Alembic migrations
 - `SQLAlchemy` for market-domain ORM models

{ms_markets-2.2.1.dev8 → ms_markets-2.2.2}/docs/fast_api/v1/index.md

@@ -164,7 +164,7 @@ push alone as deployment success.
 
 Runtime dependencies must be resolvable from the backend build environment.
 The published `ms-markets` 2.x package therefore declares
-`mainsequence>=9.0.5,<10` and `mainsequence-metatable>=0.1.14,<0.2` without
+`mainsequence>=9.0.5,<10` and `mainsequence-metatable>=0.1.17,<0.2` without
 exact patch pins. The lower bounds enforce the SDK 9 and MetaTables client
 extraction hard cut, while the project lock and exported runtime requirements
 select the exact releases validated for this repository. Do not replace the

{ms_markets-2.2.1.dev8 → ms_markets-2.2.2}/docs/getting-started.md

@@ -1,7 +1,7 @@
 # Getting Started
 
 `ms-markets` 2.x requires Python 3.13, Main Sequence SDK `>=9.0.5,<10`, and
-the MetaTables client `mainsequence-metatable>=0.1.14,<0.2` (imported as
+the MetaTables client `mainsequence-metatable>=0.1.17,<0.2` (imported as
 `metatables`). It cannot run against an SDK 8 or earlier contract and does not
 provide compatibility aliases or a mixed-version mode. Install a 1.x
 `ms-markets` release when maintaining an SDK 8 project.

{ms_markets-2.2.1.dev8 → ms_markets-2.2.2}/docs/knowledge/msm/platform/metatable_migrations.md

@@ -110,7 +110,7 @@ history is the Alembic revision graph plus the provider's version table.
 
 ## Client Requirement
 
-The implementation requires `mainsequence-metatable>=0.1.14,<0.2` with
+The implementation requires `mainsequence-metatable>=0.1.17,<0.2` with
 `mainsequence>=9.0.5,<10`. The client exposes `AlembicMetaTableMigration`,
 `AlembicVersionMetaTable`, application-owned Alembic execution, and the command
 shape where

{ms_markets-2.2.1.dev8 → ms_markets-2.2.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ms-markets"
-version = "2.2.1.dev8"
+version = "2.2.2"
 description = "Financial markets ORM, engines, and application management extensions for Main Sequence."
 readme = "README.md"
 requires-python = ">=3.13,<3.14"
@@ -37,7 +37,7 @@ dependencies = [
   "cachetools",
   "fastapi>=0.136.3",
   "mainsequence>=9.0.5,<10",
-  "mainsequence-metatable>=0.1.14,<0.2",
+  "mainsequence-metatable>=0.1.17,<0.2",
   "numpy",
   "pandas",
   "pip>=26.1.1",

{ms_markets-2.2.1.dev8 → ms_markets-2.2.2}/src/msm_portfolios/data_nodes/portfolios/storage.py

@@ -525,6 +525,14 @@ class PortfolioAnalyticsStorage(MarketsTimeIndexMetaTableMixin, MarketsBase):
     )
 
 
+_PORTFOLIO_EVENT_LEDGER_DIMENSIONS = [
+    PORTFOLIO_IDENTIFIER_DIMENSION,
+    "event_identifier",
+    "event_revision",
+    "record_identifier",
+]
+
+
 class PortfolioEventLedgerStorage(MarketsTimeIndexMetaTableMixin, MarketsBase):
     """Authoritative typed records for position-aware portfolio accounting."""
 
@@ -536,11 +544,26 @@ class PortfolioEventLedgerStorage(MarketsTimeIndexMetaTableMixin, MarketsBase):
     __time_index_name__: ClassVar[str] = "time_index"
     __index_names__: ClassVar[list[str]] = [
         "time_index",
-        PORTFOLIO_IDENTIFIER_DIMENSION,
-        "event_identifier",
-        "event_revision",
-        "record_identifier",
+        *_PORTFOLIO_EVENT_LEDGER_DIMENSIONS,
     ]
+    # The default layout names the lookup index by joining the identity
+    # dimensions (70 characters here), which exceeds PostgreSQL's 63-character
+    # identifier limit. MetaTables never shortens derived names, so the table
+    # declares its own. Keep this name stable: it is the physical index name.
+    __storage_layout__: ClassVar[dict] = {
+        "version": 1,
+        "time_index": {"name": "time_index"},
+        "identity_dimensions": _PORTFOLIO_EVENT_LEDGER_DIMENSIONS,
+        "index_progress": {"grain": _PORTFOLIO_EVENT_LEDGER_DIMENSIONS},
+        "uniqueness": {"columns": ["time_index", *_PORTFOLIO_EVENT_LEDGER_DIMENSIONS]},
+        "tail_delete": {"scope_dimensions": _PORTFOLIO_EVENT_LEDGER_DIMENSIONS},
+        "secondary_indexes": [
+            {
+                "name": "portfolio_event_ledger_identity",
+                "columns": _PORTFOLIO_EVENT_LEDGER_DIMENSIONS,
+            }
+        ],
+    }
     __table_args__ = (
         UniqueConstraint(
             "portfolio_identifier",

{ms_markets-2.2.1.dev8 → ms_markets-2.2.2}/tests/msm/models/test_metatable_models.py

@@ -58,6 +58,7 @@ from msm.models import (
     VirtualFundTable,
     markets_sqlalchemy_models,
 )
+from msm_portfolios.data_nodes.portfolios.storage import PortfolioEventLedgerStorage
 from msm_pricing.meta_tables import pricing_sqlalchemy_models
 from msm.settings import MSM_AUTO_REGISTER_NAMESPACE_ENV
 
@@ -125,6 +126,31 @@ def test_time_index_models_use_package_owned_table_names() -> None:
     )
 
 
+def test_time_index_provider_models_have_valid_storage_layouts() -> None:
+    # Run the API's own layout check: without __storage_layout__, MetaTables
+    # derives the lookup index name from the identity dimensions and rejects
+    # it when it exceeds PostgreSQL's 63-character limit.
+    from metatables.api.backend.contracts.storage_layouts import parse_storage_layout
+
+    time_index_models = [
+        model
+        for model in metatable_provider_models()
+        if issubclass(model, PlatformTimeIndexMetaTable)
+    ]
+    assert PortfolioEventLedgerStorage in time_index_models
+
+    for model in time_index_models:
+        layout = parse_storage_layout(
+            getattr(model, "__storage_layout__", None),
+            time_index_name=model.__time_index_name__,
+            index_names=model.__index_names__,
+            columns_by_name={column.name: column for column in model.__table__.columns},
+        )
+        for secondary_index in layout.secondary_indexes:
+            # The physical index is "<name>_idx" and must not be truncated.
+            assert len(f"{secondary_index.name}_idx") <= 63, model.__name__
+
+
 def test_markets_table_name_applies_optional_suffix() -> None:
     assert (
         markets_table_name(

{ms_markets-2.2.1.dev8 → ms_markets-2.2.2}/tests/msm/test_package_metadata.py

@@ -38,8 +38,8 @@ def test_package_metadata_enforces_sdk_9_floor_without_exact_patch_pin() -> None
 def test_package_metadata_requires_extracted_metatables_client() -> None:
     requirement = _requirement("mainsequence-metatable")
 
-    assert Version("0.1.13") not in requirement.specifier
-    assert Version("0.1.14") in requirement.specifier
+    assert Version("0.1.16") not in requirement.specifier
+    assert Version("0.1.17") in requirement.specifier
     assert Version("0.1.99") in requirement.specifier
     assert Version("0.2.0") not in requirement.specifier
     assert all(specifier.operator != "==" for specifier in requirement.specifier)