xrtm-data 0.3.0__tar.gz → 0.3.2__tar.gz

xrtm_data-0.3.2/PKG-INFO

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: xrtm-data
+Version: 0.3.2
+Summary: The Snapshot Vault for XRTM.
+Author-email: XRTM Team <moy@xrtm.org>
+License-Expression: Apache-2.0
+Requires-Python: <3.13,>=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: scipy>=1.11.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Dynamic: license-file
+
+# xrtm-data v0.3.0
+
+[![PyPI](https://img.shields.io/pypi/v/xrtm-data?style=flat-square)](https://pypi.org/project/xrtm-data/)
+
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+[![Python](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+
+**The Snapshot Vault for XRTM.**
+
+`xrtm-data` provides the schemas, question sources, and temporal sandboxing for the XRTM forecasting ecosystem.
+
+## Installation
+
+```bash
+pip install xrtm-data
+```
+
+## Schemas
+
+- **`ForecastQuestion`** — Standardized forecast question input
+- **`ForecastOutput`** (alias `ForecastResult`) — Forecast result with probability, reasoning trace, causal graph
+- **`CausalNode` / `CausalEdge` / `CausalGraph`** — Reasoning chain DAG
+- **`BetaPrior` / `PriorState`** — Beta distribution for belief states
+- **`TradeEvent` / `TradeWindow`** — Market trade data with temporal integrity
+
+## Question Sources
+
+| Source | API Key | Description |
+|--------|---------|-------------|
+| **real-binary** | None | 21 embedded historical binary questions (CI fixture) |
+| **Polymarket** | None (public) | Live prediction market data via Gamma API |
+| **Metaculus** | Free account | Forecasting questions from Metaculus |
+
+```python
+from xrtm.data.corpora import load_real_binary_questions
+from xrtm.data.providers.online import PolymarketSource, MetaculusSource
+
+# Built-in corpus
+
+
+questions = load_real_binary_questions(limit=5)
+
+# Live prediction markets (no API key)
+poly = PolymarketSource()
+markets = await poly.fetch_questions(limit=10)
+
+# Metaculus (needs METACULUS_API_KEY)
+meta = MetaculusSource()
+meta_qs = await meta.fetch_questions(limit=10)
+```
+
+## License
+
+Apache 2.0

xrtm_data-0.3.2/README.md

@@ -0,0 +1,54 @@
+# xrtm-data v0.3.0
+
+[![PyPI](https://img.shields.io/pypi/v/xrtm-data?style=flat-square)](https://pypi.org/project/xrtm-data/)
+
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+[![Python](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+
+**The Snapshot Vault for XRTM.**
+
+`xrtm-data` provides the schemas, question sources, and temporal sandboxing for the XRTM forecasting ecosystem.
+
+## Installation
+
+```bash
+pip install xrtm-data
+```
+
+## Schemas
+
+- **`ForecastQuestion`** — Standardized forecast question input
+- **`ForecastOutput`** (alias `ForecastResult`) — Forecast result with probability, reasoning trace, causal graph
+- **`CausalNode` / `CausalEdge` / `CausalGraph`** — Reasoning chain DAG
+- **`BetaPrior` / `PriorState`** — Beta distribution for belief states
+- **`TradeEvent` / `TradeWindow`** — Market trade data with temporal integrity
+
+## Question Sources
+
+| Source | API Key | Description |
+|--------|---------|-------------|
+| **real-binary** | None | 21 embedded historical binary questions (CI fixture) |
+| **Polymarket** | None (public) | Live prediction market data via Gamma API |
+| **Metaculus** | Free account | Forecasting questions from Metaculus |
+
+```python
+from xrtm.data.corpora import load_real_binary_questions
+from xrtm.data.providers.online import PolymarketSource, MetaculusSource
+
+# Built-in corpus
+
+
+questions = load_real_binary_questions(limit=5)
+
+# Live prediction markets (no API key)
+poly = PolymarketSource()
+markets = await poly.fetch_questions(limit=10)
+
+# Metaculus (needs METACULUS_API_KEY)
+meta = MetaculusSource()
+meta_qs = await meta.fetch_questions(limit=10)
+```
+
+## License
+
+Apache 2.0

{xrtm_data-0.3.0 → xrtm_data-0.3.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "xrtm-data"
-version = "0.3.0"
+version = "0.3.2"
 description = "The Snapshot Vault for XRTM."
 readme = "README.md"
 requires-python = ">=3.11,<3.13"

{xrtm_data-0.3.0 → xrtm_data-0.3.2}/src/xrtm/data/core/schemas/forecast.py

@@ -111,6 +111,10 @@ class ForecastQuestion(BaseModel):
         description="Detailed context and background",
     )
     resolution_criteria: Optional[str] = Field(None, description="Explicit rules for ground truth determination")
+    context: Optional[Dict[str, Any]] = Field(
+        None,
+        description="Optional market context or metadata injected by downstream consumers (e.g., price, volume, spread)",
+    )
     metadata: MetadataBase = Field(default_factory=MetadataBase)  # type: ignore[arg-type]
 
     @property

{xrtm_data-0.3.0 → xrtm_data-0.3.2}/src/xrtm/data/version.py

@@ -21,7 +21,7 @@ This module provides the single source of truth for the package version.
 
 __all__ = ["__version__", "__author__", "__contact__", "__license__", "__copyright__"]
 
-__version__ = "0.3.0"
+__version__ = "0.3.2"
 __author__ = "XRTM Team"
 __contact__ = "moy@xrtm.org"
 __license__ = "Apache-2.0"

xrtm_data-0.3.2/src/xrtm_data.egg-info/PKG-INFO

@@ -0,0 +1,73 @@
+Metadata-Version: 2.4
+Name: xrtm-data
+Version: 0.3.2
+Summary: The Snapshot Vault for XRTM.
+Author-email: XRTM Team <moy@xrtm.org>
+License-Expression: Apache-2.0
+Requires-Python: <3.13,>=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2.0.0
+Requires-Dist: scipy>=1.11.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: ruff>=0.1.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Dynamic: license-file
+
+# xrtm-data v0.3.0
+
+[![PyPI](https://img.shields.io/pypi/v/xrtm-data?style=flat-square)](https://pypi.org/project/xrtm-data/)
+
+[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
+[![Python](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
+
+**The Snapshot Vault for XRTM.**
+
+`xrtm-data` provides the schemas, question sources, and temporal sandboxing for the XRTM forecasting ecosystem.
+
+## Installation
+
+```bash
+pip install xrtm-data
+```
+
+## Schemas
+
+- **`ForecastQuestion`** — Standardized forecast question input
+- **`ForecastOutput`** (alias `ForecastResult`) — Forecast result with probability, reasoning trace, causal graph
+- **`CausalNode` / `CausalEdge` / `CausalGraph`** — Reasoning chain DAG
+- **`BetaPrior` / `PriorState`** — Beta distribution for belief states
+- **`TradeEvent` / `TradeWindow`** — Market trade data with temporal integrity
+
+## Question Sources
+
+| Source | API Key | Description |
+|--------|---------|-------------|
+| **real-binary** | None | 21 embedded historical binary questions (CI fixture) |
+| **Polymarket** | None (public) | Live prediction market data via Gamma API |
+| **Metaculus** | Free account | Forecasting questions from Metaculus |
+
+```python
+from xrtm.data.corpora import load_real_binary_questions
+from xrtm.data.providers.online import PolymarketSource, MetaculusSource
+
+# Built-in corpus
+
+
+questions = load_real_binary_questions(limit=5)
+
+# Live prediction markets (no API key)
+poly = PolymarketSource()
+markets = await poly.fetch_questions(limit=10)
+
+# Metaculus (needs METACULUS_API_KEY)
+meta = MetaculusSource()
+meta_qs = await meta.fetch_questions(limit=10)
+```
+
+## License
+
+Apache 2.0

{xrtm_data-0.3.0 → xrtm_data-0.3.2}/tests/test_schemas.py

@@ -16,7 +16,7 @@ from datetime import datetime, timedelta, timezone
 
 import pytest
 
-from xrtm.data import CausalEdge, CausalNode, ForecastOutput, ForecastResult, MetadataBase
+from xrtm.data import CausalEdge, CausalNode, ForecastOutput, ForecastQuestion, ForecastResult, MetadataBase
 from xrtm.data.core.schemas import TradeEvent, TradeWindow
 
 
@@ -172,3 +172,33 @@ def test_trade_window_normalizes_naive_boundaries_and_timestamps():
 
     assert window.start_time.tzinfo == timezone.utc
     assert window.trades[0].timestamp.tzinfo == timezone.utc
+
+
+def test_forecast_question_context_field():
+    """ForecastQuestion accepts an optional context dict for market metadata."""
+    q = ForecastQuestion(
+        id="q1",
+        title="Will market X exceed $100?",
+        context={"market_price": 0.55, "volume_24h": 150000, "spread": 0.02},
+    )
+    assert q.context == {"market_price": 0.55, "volume_24h": 150000, "spread": 0.02}
+
+
+def test_forecast_question_context_defaults_to_none():
+    """ForecastQuestion context is None by default for backward compatibility."""
+    q = ForecastQuestion(id="q2", title="Simple question")
+    assert q.context is None
+
+
+def test_forecast_question_context_serializes():
+    """Context field serializes to JSON and round-trips correctly."""
+    q = ForecastQuestion(
+        id="q3",
+        title="Serialization test",
+        context={"key": "value", "nested": {"a": 1}},
+    )
+    payload = q.model_dump(mode="json")
+    assert payload["context"] == {"key": "value", "nested": {"a": 1}}
+
+    reloaded = ForecastQuestion.model_validate(payload)
+    assert reloaded.context == {"key": "value", "nested": {"a": 1}}

xrtm_data-0.3.0/PKG-INFO

@@ -1,102 +0,0 @@
-Metadata-Version: 2.4
-Name: xrtm-data
-Version: 0.3.0
-Summary: The Snapshot Vault for XRTM.
-Author-email: XRTM Team <moy@xrtm.org>
-License-Expression: Apache-2.0
-Requires-Python: <3.13,>=3.11
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: pydantic>=2.0.0
-Requires-Dist: scipy>=1.11.0
-Provides-Extra: dev
-Requires-Dist: pytest>=7.0.0; extra == "dev"
-Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
-Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
-Requires-Dist: ruff>=0.1.0; extra == "dev"
-Requires-Dist: mypy>=1.0.0; extra == "dev"
-Dynamic: license-file
-
-# xrtm-data
-
-[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
-[![Python](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
-[![PyPI](https://img.shields.io/pypi/v/xrtm-data.svg)](https://pypi.org/project/xrtm-data/)
-
-**The Snapshot Vault for XRTM.**
-
-`xrtm-data` provides the rigid schemas and temporal sandboxing infrastructure required for zero-leakage forecasting. It defines the "Ground Truth" data structures that the rest of the ecosystem (Forecast, Eval, Train) relies on.
-
-## Part of the XRTM Ecosystem
-
-```
-Layer 4: xrtm-train    → (imports all)
-Layer 3: xrtm-forecast → (imports eval, data)
-Layer 2: xrtm-eval     → (imports data)
-Layer 1: xrtm-data     → (zero dependencies) ← YOU ARE HERE
-```
-
-`xrtm-data` is the foundation layer with **zero dependencies** on other xrtm packages.
-
-## Installation
-
-```bash
-pip install xrtm-data
-```
-
-## Core Primitives
-
-### 1. The Forecast Object Standard
-Adhering to strict Governance, the canonical runtime schema is
-`ForecastResult` (legacy alias: `ForecastOutput`). Every forecast result carries
-`forecast_request_id`, `probability`, a `reasoning_trace`, and an optional
-`execution_trace`. Legacy `question_id`, `reasoning`, `logical_trace`,
-`logical_edges`, and `structural_trace` inputs remain accepted for compatibility.
-
-```python
-from xrtm.data import ForecastResult, CausalNode
-
-forecast_result = ForecastResult(
-    forecast_request_id="q_123",
-    probability=0.75,
-    reasoning_trace={
-        "narrative": "Base rate analysis suggests...",
-        "causal_graph": {
-            "nodes": [
-                CausalNode(event="Inflation rises", probability=0.8),
-                CausalNode(event="Fed cuts rates", probability=0.4),
-            ]
-        },
-    },
-    execution_trace=["ingestion", "forecast"],
-)
-```
-
-### 2. Zero Leakage
-The `MetadataBase` enforces a strict `snapshot_time`. This timestamp represents the "End of History" for the model. Any data point generated after this time is considered "Future Leakage" and is programmatically inaccessible during backtesting.
-
-## Project Structure
-
-```
-src/xrtm/data/
-├── core/            # Interfaces & Schemas (domain-agnostic)
-│   ├── interfaces.py    # DataSource protocol
-│   └── schemas/         # ForecastRequest, ForecastResult, etc.
-├── kit/             # Composable utilities (processors)
-└── providers/       # External data source implementations
-    ├── local/           # LocalDataSource (JSON files)
-    └── online/          # PolymarketSource (Gamma API)
-```
-
-## Development
-
-Prerequisites:
-- [uv](https://github.com/astral-sh/uv)
-
-```bash
-# Install dependencies
-uv sync
-
-# Run tests
-uv run pytest
-```

xrtm_data-0.3.0/README.md

@@ -1,83 +0,0 @@
-# xrtm-data
-
-[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
-[![Python](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
-[![PyPI](https://img.shields.io/pypi/v/xrtm-data.svg)](https://pypi.org/project/xrtm-data/)
-
-**The Snapshot Vault for XRTM.**
-
-`xrtm-data` provides the rigid schemas and temporal sandboxing infrastructure required for zero-leakage forecasting. It defines the "Ground Truth" data structures that the rest of the ecosystem (Forecast, Eval, Train) relies on.
-
-## Part of the XRTM Ecosystem
-
-```
-Layer 4: xrtm-train    → (imports all)
-Layer 3: xrtm-forecast → (imports eval, data)
-Layer 2: xrtm-eval     → (imports data)
-Layer 1: xrtm-data     → (zero dependencies) ← YOU ARE HERE
-```
-
-`xrtm-data` is the foundation layer with **zero dependencies** on other xrtm packages.
-
-## Installation
-
-```bash
-pip install xrtm-data
-```
-
-## Core Primitives
-
-### 1. The Forecast Object Standard
-Adhering to strict Governance, the canonical runtime schema is
-`ForecastResult` (legacy alias: `ForecastOutput`). Every forecast result carries
-`forecast_request_id`, `probability`, a `reasoning_trace`, and an optional
-`execution_trace`. Legacy `question_id`, `reasoning`, `logical_trace`,
-`logical_edges`, and `structural_trace` inputs remain accepted for compatibility.
-
-```python
-from xrtm.data import ForecastResult, CausalNode
-
-forecast_result = ForecastResult(
-    forecast_request_id="q_123",
-    probability=0.75,
-    reasoning_trace={
-        "narrative": "Base rate analysis suggests...",
-        "causal_graph": {
-            "nodes": [
-                CausalNode(event="Inflation rises", probability=0.8),
-                CausalNode(event="Fed cuts rates", probability=0.4),
-            ]
-        },
-    },
-    execution_trace=["ingestion", "forecast"],
-)
-```
-
-### 2. Zero Leakage
-The `MetadataBase` enforces a strict `snapshot_time`. This timestamp represents the "End of History" for the model. Any data point generated after this time is considered "Future Leakage" and is programmatically inaccessible during backtesting.
-
-## Project Structure
-
-```
-src/xrtm/data/
-├── core/            # Interfaces & Schemas (domain-agnostic)
-│   ├── interfaces.py    # DataSource protocol
-│   └── schemas/         # ForecastRequest, ForecastResult, etc.
-├── kit/             # Composable utilities (processors)
-└── providers/       # External data source implementations
-    ├── local/           # LocalDataSource (JSON files)
-    └── online/          # PolymarketSource (Gamma API)
-```
-
-## Development
-
-Prerequisites:
-- [uv](https://github.com/astral-sh/uv)
-
-```bash
-# Install dependencies
-uv sync
-
-# Run tests
-uv run pytest
-```

xrtm_data-0.3.0/src/xrtm_data.egg-info/PKG-INFO

@@ -1,102 +0,0 @@
-Metadata-Version: 2.4
-Name: xrtm-data
-Version: 0.3.0
-Summary: The Snapshot Vault for XRTM.
-Author-email: XRTM Team <moy@xrtm.org>
-License-Expression: Apache-2.0
-Requires-Python: <3.13,>=3.11
-Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: pydantic>=2.0.0
-Requires-Dist: scipy>=1.11.0
-Provides-Extra: dev
-Requires-Dist: pytest>=7.0.0; extra == "dev"
-Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
-Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
-Requires-Dist: ruff>=0.1.0; extra == "dev"
-Requires-Dist: mypy>=1.0.0; extra == "dev"
-Dynamic: license-file
-
-# xrtm-data
-
-[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0)
-[![Python](https://img.shields.io/badge/python-3.11+-blue.svg)](https://www.python.org/downloads/)
-[![PyPI](https://img.shields.io/pypi/v/xrtm-data.svg)](https://pypi.org/project/xrtm-data/)
-
-**The Snapshot Vault for XRTM.**
-
-`xrtm-data` provides the rigid schemas and temporal sandboxing infrastructure required for zero-leakage forecasting. It defines the "Ground Truth" data structures that the rest of the ecosystem (Forecast, Eval, Train) relies on.
-
-## Part of the XRTM Ecosystem
-
-```
-Layer 4: xrtm-train    → (imports all)
-Layer 3: xrtm-forecast → (imports eval, data)
-Layer 2: xrtm-eval     → (imports data)
-Layer 1: xrtm-data     → (zero dependencies) ← YOU ARE HERE
-```
-
-`xrtm-data` is the foundation layer with **zero dependencies** on other xrtm packages.
-
-## Installation
-
-```bash
-pip install xrtm-data
-```
-
-## Core Primitives
-
-### 1. The Forecast Object Standard
-Adhering to strict Governance, the canonical runtime schema is
-`ForecastResult` (legacy alias: `ForecastOutput`). Every forecast result carries
-`forecast_request_id`, `probability`, a `reasoning_trace`, and an optional
-`execution_trace`. Legacy `question_id`, `reasoning`, `logical_trace`,
-`logical_edges`, and `structural_trace` inputs remain accepted for compatibility.
-
-```python
-from xrtm.data import ForecastResult, CausalNode
-
-forecast_result = ForecastResult(
-    forecast_request_id="q_123",
-    probability=0.75,
-    reasoning_trace={
-        "narrative": "Base rate analysis suggests...",
-        "causal_graph": {
-            "nodes": [
-                CausalNode(event="Inflation rises", probability=0.8),
-                CausalNode(event="Fed cuts rates", probability=0.4),
-            ]
-        },
-    },
-    execution_trace=["ingestion", "forecast"],
-)
-```
-
-### 2. Zero Leakage
-The `MetadataBase` enforces a strict `snapshot_time`. This timestamp represents the "End of History" for the model. Any data point generated after this time is considered "Future Leakage" and is programmatically inaccessible during backtesting.
-
-## Project Structure
-
-```
-src/xrtm/data/
-├── core/            # Interfaces & Schemas (domain-agnostic)
-│   ├── interfaces.py    # DataSource protocol
-│   └── schemas/         # ForecastRequest, ForecastResult, etc.
-├── kit/             # Composable utilities (processors)
-└── providers/       # External data source implementations
-    ├── local/           # LocalDataSource (JSON files)
-    └── online/          # PolymarketSource (Gamma API)
-```
-
-## Development
-
-Prerequisites:
-- [uv](https://github.com/astral-sh/uv)
-
-```bash
-# Install dependencies
-uv sync
-
-# Run tests
-uv run pytest
-```