ms-markets 2.2.7.dev31__tar.gz → 2.2.8.dev32__tar.gz

{ms_markets-2.2.7.dev31 → ms_markets-2.2.8.dev32}/CHANGELOG.md

@@ -7,6 +7,15 @@ and this project follows versioned releases.
 
 ## [Unreleased]
 
+## [2.2.8] - 2026-10-11
+
+### Fixed
+
+- Give the hosted migration Job an explicit 300-second MetaTables discovery
+  scope, so waking APIs receive the documented migration wait budget instead
+  of the ordinary 30 seconds. Schema and catalog errors still fail the Job;
+  the data-preserving `0017` bridge and applied revisions stay unchanged.
+
 ## [2.2.7] - 2026-10-11
 
 ### Fixed

{ms_markets-2.2.7.dev31 → ms_markets-2.2.8.dev32}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: ms-markets
-Version: 2.2.7.dev31
+Version: 2.2.8.dev32
 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

{ms_markets-2.2.7.dev31 → ms_markets-2.2.8.dev32}/docs/knowledge/msm/migrations/index.md

@@ -86,9 +86,12 @@ reflection is batched by schema. Finalization requests remain bounded to ten
 tables each, with the version table first. No batching option or project-specific
 runner is required.
 
-Discovery during a migration waits up to 300 seconds for MetaTables to wake or
-finish replacing its pods. Ordinary client calls retain a 30-second discovery
-budget. A discovery failure still fails the Job and blocks deployment.
+The hosted Job wraps `upgrade_application` in
+`api_endpoint_scope(discovery_timeout=300)`, explicitly allowing up to 300 seconds
+for a waking MetaTables deployment. Ordinary client calls retain a 30-second
+discovery budget. A deployment reported as unavailable, a discovery failure,
+or a schema/catalog failure still fails the Job and blocks deployment. Verify
+the Environment's MetaTables deployment is ready before restarting a failed workflow.
 
 `jobs/migrate_markets.py` enables INFO logging for `metatables.migrations.runner`.
 Its logs separate preparation, database setup, table checks, Alembic execution,

{ms_markets-2.2.7.dev31 → ms_markets-2.2.8.dev32}/docs/releasing.md

@@ -161,8 +161,11 @@ The project requires `mainsequence-metatable>=0.1.33,<0.2`; `uv.lock` and
 guidance with `metatables copy-metatables-skills --path .`, and run the checks
 above. Keep the provider identity, version table, and applied revisions unchanged.
 
-The candidate image uses the shared `upgrade_application()` runner. It retains
-the batched inspections and 300-second discovery budget introduced in 0.1.31.
+The candidate image uses the shared `upgrade_application()` runner and batched
+inspections. The Job explicitly wraps the runner in
+`api_endpoint_scope(discovery_timeout=300)` for a waking MetaTables API; ordinary
+client discovery defaults to 30 seconds. Check that the Environment's MetaTables
+deployment is ready before restarting a workflow that failed during discovery.
 The updated runner also sends changed, non-empty authored table and column
 metadata during finalization, even without a new Alembic revision. That payload
 requires the matching MetaTables API; the updated API also fixes SQLite

{ms_markets-2.2.7.dev31 → ms_markets-2.2.8.dev32}/docs/tutorial/index.md

@@ -38,6 +38,8 @@ descriptions, labels, and column metadata refresh during finalization without a
 new revision; empty values preserve existing metadata. The shared MetaTables API
 must support that payload too. See
 [Migrations](../knowledge/msm/migrations/index.md) for the workflow and timing logs.
+The hosted Job explicitly allows 300 seconds for a waking MetaTables API;
+an unavailable deployment or a schema/catalog failure still blocks rollout.
 
 ## Installing MS Markets Agent Skills
 

{ms_markets-2.2.7.dev31 → ms_markets-2.2.8.dev32}/examples/msm/platform/metatable_migration_lifecycle.py

@@ -24,7 +24,8 @@ def main() -> None:
 
     print("\nHosted: candidate image -> jobs/migrate_markets.py -> API rollout")
     print(f"The Job calls metatables.upgrade_application({PROVIDER!r}) on every deployment.")
-    print("MetaTables >=0.1.33 batches inspections and waits up to 300s for a waking API.")
+    print("MetaTables >=0.1.33 batches inspections; the Job explicitly allows 300s to wake.")
+    print("It uses api_endpoint_scope(discovery_timeout=300); failures still stop rollout.")
     print("At head, catalog reconciliation still runs; migrated=False is not a skip signal.")
     print("Changed non-empty authored metadata refreshes without a new Alembic revision.")
     print("Empty metadata preserves existing values; equal-valued reruns avoid catalog writes.")

{ms_markets-2.2.7.dev31 → ms_markets-2.2.8.dev32}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "ms-markets"
-version = "2.2.7.dev31"
+version = "2.2.8.dev32"
 description = "Financial markets ORM, engines, and application management extensions for Main Sequence."
 readme = "README.md"
 requires-python = ">=3.13,<3.14"

{ms_markets-2.2.7.dev31 → ms_markets-2.2.8.dev32}/tests/msm/maintenance/test_migration_job.py

@@ -2,9 +2,11 @@ from __future__ import annotations
 
 import logging
 import runpy
+from contextlib import contextmanager
 from pathlib import Path
 
 import metatables
+import metatables.endpoint
 import pytest
 
 
@@ -12,18 +14,38 @@ PROJECT_ROOT = Path(__file__).resolve().parents[3]
 JOB_PATH = PROJECT_ROOT / "jobs" / "migrate_markets.py"
 
 
+@pytest.fixture
+def discovery_scope(monkeypatch):
+    state = {"budgets": [], "active": False}
+    original = metatables.endpoint.api_endpoint_scope
+
+    @contextmanager
+    def observe_scope(*, discovery_timeout):
+        state["budgets"].append(discovery_timeout)
+        with original(discovery_timeout=discovery_timeout):
+            state["active"] = True
+            try:
+                yield
+            finally:
+                state["active"] = False
+
+    monkeypatch.setattr(metatables.endpoint, "api_endpoint_scope", observe_scope)
+    return state
+
+
 @pytest.mark.parametrize("migrated", [False, True])
 def test_job_always_calls_shared_upgrade_and_exposes_timings(
-    monkeypatch, capsys, caplog, migrated: bool
+    monkeypatch, capsys, caplog, discovery_scope, migrated: bool
 ) -> None:
     calls = []
 
     def upgrade(provider):
+        assert discovery_scope["active"]
         calls.append(provider)
         logging.getLogger("metatables.migrations.runner").info(
             "Application migration msm:mainsequence.markets: catalog finalization took 0.001s"
         )
-        return {"revision": "0018", "migrated": migrated, "data_source_uid": "test-source"}
+        return {"revision": "0020", "migrated": migrated, "data_source_uid": "test-source"}
 
     monkeypatch.setattr(metatables, "upgrade_application", upgrade)
     # Restore the logger's level after running the script in this process.
@@ -33,17 +55,21 @@ def test_job_always_calls_shared_upgrade_and_exposes_timings(
     runpy.run_path(str(JOB_PATH), run_name="__main__")
 
     assert calls == ["msm_migrations:migration"]
+    assert discovery_scope == {"budgets": [300], "active": False}
     assert "catalog finalization took 0.001s" in caplog.text
     output = capsys.readouterr().out
     assert "Applying and reconciling msm_migrations:migration" in output
     state = "migrated" if migrated else "already current"
-    assert f"0018 ({state}) on test-source" in output
+    assert f"0020 ({state}) on test-source" in output
 
 
-def test_job_does_not_hide_migration_or_finalization_failure(monkeypatch, capsys) -> None:
+def test_job_does_not_hide_migration_or_finalization_failure(
+    monkeypatch, capsys, discovery_scope
+) -> None:
     failure = RuntimeError("catalog finalization failed")
 
     def upgrade(provider):
+        assert discovery_scope["active"]
         assert provider == "msm_migrations:migration"
         raise failure
 
@@ -54,4 +80,5 @@ def test_job_does_not_hide_migration_or_finalization_failure(monkeypatch, capsys
         runpy.run_path(str(JOB_PATH), run_name="__main__")
 
     assert raised.value is failure
+    assert discovery_scope == {"budgets": [300], "active": False}
     assert "already current" not in capsys.readouterr().out