Phase 29: Economic Indicators Vertical (CPI/PPI/NFP/GDP/jobless/Fed + Kalshi)

.github/workflows/release.yml

@@ -1,13 +1,14 @@
 name: Release (PyPI trusted publishing)
 
-# Phase 4 CI-03 (PKG-01): publish the three sibling distributions to PyPI on
+# Phase 4 CI-03 (PKG-01): publish the sibling distributions to PyPI on
 # every v* tag, using PEP 740 trusted publishing (no API tokens stored in
 # secrets). Each package has its own job because trusted publishing is
 # registered per-package on PyPI.
 #
 # Setup checklist (one-time, before the first tagged release):
 #   1. Register the project as a "pending publisher" on PyPI for each of
-#      mostlyrightmd, mostlyrightmd-weather, mostlyrightmd-markets
+#      mostlyrightmd, mostlyrightmd-weather, mostlyrightmd-markets,
+#      mostlyrightmd-econ
 #      against owner=mostlyrightmd, repo=mostlyright-sdk.
 #      https://docs.pypi.org/trusted-publishers/adding-a-publisher/
 #   2. Workflow ref must match: workflow filename `release.yml`,
@@ -37,16 +38,16 @@ permissions:
 
 jobs:
   # codex iter-1 HIGH fix: tag/version-match preflight.
-  # release.yml fires on every v* tag, but the 3 sibling pyproject.toml files
+  # release.yml fires on every v* tag, but the 4 sibling pyproject.toml files
   # each carry their own version. Tagging v0.1.0 while one of the packages is
   # still at 0.1.0a1 would publish stale alpha artifacts OR fail mid-job (a
   # PyPI publish step that finds the version already exists fails the build,
-  # but the OTHER two jobs have already published their wheels — leaving PyPI
+  # but the OTHER jobs have already published their wheels — leaving PyPI
   # in a half-released state). This preflight extracts the version from each
   # pyproject and refuses to proceed unless GITHUB_REF_NAME == "v{version}"
-  # for ALL three.
+  # for ALL four.
   version-guard:
-    name: Verify tag matches all 3 package versions
+    name: Verify tag matches all 4 package versions
     runs-on: ubuntu-latest
     steps:
       - uses: actions/checkout@v4
@@ -85,7 +86,8 @@ jobs:
               sys.exit(f"ERROR: tag {ref!r} is not a valid PEP 440 version: {exc}")
           for pkg in ("packages/core/pyproject.toml",
                       "packages/weather/pyproject.toml",
-                      "packages/markets/pyproject.toml"):
+                      "packages/markets/pyproject.toml",
+                      "packages/econ/pyproject.toml"):
               with open(pkg, "rb") as f:
                   pyproj = tomllib.load(f)
               raw_version = pyproj["project"]["version"]
@@ -159,3 +161,29 @@ jobs:
         run: uv run python scripts/check_wheel_metadata.py
       - name: Publish to PyPI
         uses: pypa/gh-action-pypi-publish@release/v1
+
+  # Phase 29 (29-01): the 4th published distribution. Mirrors the markets job
+  # verbatim (own trusted-publishing environment url; own `uv build --package`).
+  # NOTE: `mostlyrightmd-econ` must be registered as a PyPI "pending publisher"
+  # (owner=mostlyrightmd, repo=mostlyright-sdk, workflow=release.yml,
+  # environment=pypi) BEFORE the first tagged release, exactly like the other
+  # three (see the one-time setup checklist at the top of this file).
+  publish-econ:
+    name: Publish mostlyrightmd-econ
+    needs: version-guard
+    runs-on: ubuntu-latest
+    environment:
+      name: pypi
+      url: https://pypi.org/project/mostlyrightmd-econ/
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install uv
+        uses: astral-sh/setup-uv@v3
+      - name: Set up Python
+        run: uv python install 3.12
+      - name: Build mostlyrightmd-econ wheel + sdist
+        run: uv build --package mostlyrightmd-econ
+      - name: Verify Requires-Dist pin (CI-04 gate)
+        run: uv run python scripts/check_wheel_metadata.py
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1

CHANGELOG.md

@@ -4,6 +4,30 @@ All notable changes to `mostlyright`. The format follows [Keep a Changelog](http
 
 ## [Unreleased]
 
+### Added
+
+- **Econ surface conformance to the 1.13/1.14 source-identity contract
+  (dual-SDK, plan 29-11).** The `mostlyright.econ` vertical now mirrors the
+  cross-vertical [`docs/source-identity.md`](docs/source-identity.md) surface it
+  was unified under: `series()` is the canonical read function (`history()` is a
+  byte-identical, docstring-`@deprecated` silent alias — no runtime warning this
+  release, warning next minor, removal at 2.0); `series()`/`research_econ()` gain
+  `source=` (contract §1 provenance: accepted `{None,"fred","bls","bea","dol",
+  "fed"}`, an unknown source OR a valid authority that cannot serve the indicator
+  raises `ValueError` **before any network call** — never a silent fallback) and
+  `delivery=` (contract §2: `"live"` default | `"hosted"` raises
+  `SourceUnavailableError` naming `ECON_HOSTED_URL` + `MOSTLYRIGHT_API_KEY`, the
+  reserved paid-tier seam); and a new `snapshot(indicator, *, as_of=None)` returns
+  the settlement-target state — the latest `settlement_grade=True` vintage with
+  `vintage_date <= as_of`, raising `IndicatorNotYetReleasedError` when nothing is
+  knowable. TS mirrors the whole surface (`series`/`snapshot`, `@deprecated`
+  `history` re-export, `source`/`delivery` options with the same loud validation).
+  The engine (fetchers/schema/cache/resolver/first-print logic) is untouched — a
+  default call is byte-identical to the pre-conformance output. Core's
+  `dataset()`/`research()` are **not** modified (an `include_econ` covariate seam
+  is an option-B question deferred to review); the econ↔weather firewall
+  (`test_firewall.py`) stays green.
+
 ## [1.15.0] — 2026-07-10 — General-first re-layering: the label axis, thin markets delegators, panels, and the contributor registry
 
 Minor release, dual-SDK (PyPI 1.15.0 + npm 1.15.0 in lockstep). The SDK is now