indiciumforge-core 2.0.0__tar.gz

indiciumforge_core-2.0.0/PKG-INFO

@@ -0,0 +1,42 @@
+Metadata-Version: 2.4
+Name: indiciumforge-core
+Version: 2.0.0
+Summary: Core contracts, artifact schemas, and ports for IndiciumForge evidence-first research workflows.
+Author: IndiciumForge contributors
+License-Expression: Apache-2.0
+Project-URL: Homepage, https://github.com/Cavaradossi/indiciumforge
+Project-URL: Repository, https://github.com/Cavaradossi/indiciumforge
+Project-URL: Documentation, https://github.com/Cavaradossi/indiciumforge/tree/master/docs
+Project-URL: Issues, https://github.com/Cavaradossi/indiciumforge/issues
+Project-URL: Changelog, https://github.com/Cavaradossi/indiciumforge/blob/master/RELEASE_NOTES.md
+Keywords: workflow,artifacts,research,audit,open-core
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+Requires-Dist: pandas>=2.0
+Requires-Dist: tabulate>=0.9
+
+# indiciumforge-core
+
+Core contracts, artifact schemas, and ports for [IndiciumForge](https://github.com/Cavaradossi/indiciumforge).
+
+IndiciumForge produces **research audit artifacts** and parity evidence. It is **not investment advice**, **not a trading system**, and **not a broker execution platform**.
+
+## Install
+
+PyPI publish is pending. Install from the monorepo:
+
+```bash
+pip install -e packages/indiciumforge-core
+```
+
+See [docs/PYPI_RELEASE_CHECKLIST.md](https://github.com/Cavaradossi/indiciumforge/blob/master/docs/PYPI_RELEASE_CHECKLIST.md).

indiciumforge_core-2.0.0/README.md

@@ -0,0 +1,15 @@
+# indiciumforge-core
+
+Core contracts, artifact schemas, and ports for [IndiciumForge](https://github.com/Cavaradossi/indiciumforge).
+
+IndiciumForge produces **research audit artifacts** and parity evidence. It is **not investment advice**, **not a trading system**, and **not a broker execution platform**.
+
+## Install
+
+PyPI publish is pending. Install from the monorepo:
+
+```bash
+pip install -e packages/indiciumforge-core
+```
+
+See [docs/PYPI_RELEASE_CHECKLIST.md](https://github.com/Cavaradossi/indiciumforge/blob/master/docs/PYPI_RELEASE_CHECKLIST.md).

indiciumforge_core-2.0.0/pyproject.toml

@@ -0,0 +1,36 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "indiciumforge-core"
+version = "2.0.0"
+description = "Core contracts, artifact schemas, and ports for IndiciumForge evidence-first research workflows."
+readme = "README.md"
+license = "Apache-2.0"
+requires-python = ">=3.10"
+authors = [{ name = "IndiciumForge contributors" }]
+keywords = ["workflow", "artifacts", "research", "audit", "open-core"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "Intended Audience :: Science/Research",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Topic :: Scientific/Engineering",
+  "Topic :: Software Development :: Libraries",
+]
+dependencies = ["pandas>=2.0", "tabulate>=0.9"]
+
+[project.urls]
+Homepage = "https://github.com/Cavaradossi/indiciumforge"
+Repository = "https://github.com/Cavaradossi/indiciumforge"
+Documentation = "https://github.com/Cavaradossi/indiciumforge/tree/master/docs"
+Issues = "https://github.com/Cavaradossi/indiciumforge/issues"
+Changelog = "https://github.com/Cavaradossi/indiciumforge/blob/master/RELEASE_NOTES.md"
+
+[tool.setuptools.packages.find]
+where = ["src"]

indiciumforge_core-2.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

indiciumforge_core-2.0.0/src/indiciumforge_core/__init__.py

@@ -0,0 +1 @@
+"""Core contracts and artifacts for IndiciumForge."""

indiciumforge_core-2.0.0/src/indiciumforge_core/artifacts/__init__.py

@@ -0,0 +1 @@
+

indiciumforge_core-2.0.0/src/indiciumforge_core/artifacts/comparator.py

@@ -0,0 +1,80 @@
+from __future__ import annotations
+
+import json
+from pathlib import Path
+from typing import Any
+
+import pandas as pd
+
+from indiciumforge_core.labels.market_gate import REVIEW_COLUMNS
+from indiciumforge_core.text import normalize_code_series
+
+GATE_ARTIFACTS = (
+    "market_gated_candidates.csv",
+    "market_gated_observation.csv",
+    "market_gated_active_watch.csv",
+    "market_gated_rejected.csv",
+    "market_gate_calibration_audit.json",
+    "market_gate_summary.json",
+    "market_gate_state.json",
+)
+
+
+def assert_schema_exists(actual_dir: Path, expected_dir: Path) -> None:
+    for name in GATE_ARTIFACTS:
+        assert (expected_dir / name).exists(), f"missing expected artifact {name}"
+        if name.endswith(".json"):
+            continue
+        assert (actual_dir / name).exists(), f"missing actual artifact {name}"
+
+
+def compare_semantic_market_gate(actual_dir: Path, expected_dir: Path) -> None:
+    assert_schema_exists(actual_dir, expected_dir)
+    for stem in (
+        "market_gated_candidates",
+        "market_gated_observation",
+        "market_gated_active_watch",
+        "market_gated_rejected",
+    ):
+        actual = pd.read_csv(actual_dir / f"{stem}.csv", encoding="utf-8-sig")
+        expected = pd.read_csv(expected_dir / f"{stem}.csv", encoding="utf-8-sig")
+        assert list(actual.columns) == list(expected.columns), stem
+        if REVIEW_COLUMNS["code"] in actual.columns:
+            assert set(normalize_code_series(actual[REVIEW_COLUMNS["code"]])) == set(
+                normalize_code_series(expected[REVIEW_COLUMNS["code"]])
+            ), stem
+    for json_name in ("market_gate_calibration_audit.json", "market_gate_summary.json"):
+        actual_payload = json.loads((actual_dir / json_name).read_text(encoding="utf-8-sig"))
+        expected_payload = json.loads((expected_dir / json_name).read_text(encoding="utf-8-sig"))
+        for key in (
+            "strict_count",
+            "observation_count",
+            "watch_count",
+            "rejected_count",
+            "candidate_count",
+            "quality_gate_warning",
+        ):
+            if key in expected_payload:
+                assert actual_payload.get(key) == expected_payload.get(key), f"{json_name}:{key}"
+    actual_state = json.loads(
+        (actual_dir / "market_gate_state.json").read_text(encoding="utf-8-sig")
+    )
+    expected_state = json.loads(
+        (expected_dir / "market_gate_state.json").read_text(encoding="utf-8-sig")
+    )
+    for key in (
+        "workflow_review_source_stage",
+        "strict_count",
+        "observation_count",
+        "watch_count",
+        "rejected_count",
+        "candidate_count",
+        "quality_gate_warning",
+    ):
+        assert actual_state.get(key) == expected_state.get(key), f"state:{key}"
+    if expected_state.get("warnings"):
+        assert actual_state.get("warnings"), "state warnings missing"
+
+
+def load_meta(path: Path) -> dict[str, Any]:
+    return json.loads(path.read_text(encoding="utf-8-sig"))

indiciumforge_core-2.0.0/src/indiciumforge_core/artifacts/formatting.py

@@ -0,0 +1,21 @@
+from __future__ import annotations
+
+import pandas as pd
+
+from indiciumforge_core.labels.market_gate import REVIEW_COLUMNS
+
+
+def format_code_text(frame: pd.DataFrame) -> pd.DataFrame:
+    column = REVIEW_COLUMNS["code"]
+    if column not in frame.columns:
+        return frame
+
+    def _format(value: object) -> str:
+        text = str(value).strip()
+        if text.startswith('="') and text.endswith('"'):
+            return text
+        return f'="{text.zfill(6)}"'
+
+    out = frame.copy()
+    out[column] = out[column].map(_format)
+    return out

indiciumforge_core-2.0.0/src/indiciumforge_core/artifacts/local_store.py

@@ -0,0 +1,14 @@
+from __future__ import annotations
+
+from pathlib import Path
+
+import pandas as pd
+
+
+class LocalArtifactStore:
+    def read_csv(self, path: Path, **kwargs: object) -> pd.DataFrame:
+        return pd.read_csv(path, **kwargs)
+
+    def write_csv(self, path: Path, frame: pd.DataFrame) -> None:
+        path.parent.mkdir(parents=True, exist_ok=True)
+        frame.to_csv(path, index=False, encoding="utf-8-sig")