refactor: isolate strategy spec validation

Co-Authored-By: Codex <noreply@openai.com>

Author: Pigbibi

docs/quant_strategy_spec_contract.md

@@ -30,7 +30,8 @@ quant-strategy-spec path/to/spec.json
 The command is silent on success, prints field-level contract violations to
 stderr on failure, and returns a non-zero exit code.  Code integrations may
 use `validate_research_spec`, `validate_optimization_spec`, or
-`validate_strategy_spec_file` from `quant_platform_kit.strategy_lifecycle`.
+`validate_strategy_spec_file` from the lightweight
+`quant_platform_kit.strategy_spec` package.
 Source checkouts may use `python scripts/validate_strategy_spec.py` as an
 equivalent compatibility wrapper.
 

pyproject.toml

@@ -16,7 +16,7 @@ dependencies = []
 
 [project.scripts]
 quant-lifecycle = "quant_platform_kit.strategy_lifecycle.cli:main"
-quant-strategy-spec = "quant_platform_kit.strategy_lifecycle.spec_cli:main"
+quant-strategy-spec = "quant_platform_kit.strategy_spec.cli:main"
 
 [tool.setuptools]
 package-dir = { "" = "src" }

scripts/validate_strategy_spec.py

@@ -10,7 +10,7 @@
 ROOT = Path(__file__).resolve().parents[1]
 sys.path.insert(0, str(ROOT / "src"))
 
-from quant_platform_kit.strategy_lifecycle.spec_cli import main
+from quant_platform_kit.strategy_spec.cli import main
 
 
 if __name__ == "__main__":

src/quant_platform_kit.egg-info/SOURCES.txt

@@ -139,11 +139,12 @@ src/quant_platform_kit/strategy_lifecycle/performance_store.py
 src/quant_platform_kit/strategy_lifecycle/return_collector.py
 src/quant_platform_kit/strategy_lifecycle/rollback_manager.py
 src/quant_platform_kit/strategy_lifecycle/shadow_validator.py
-src/quant_platform_kit/strategy_lifecycle/spec_cli.py
-src/quant_platform_kit/strategy_lifecycle/spec_validation.py
 src/quant_platform_kit/strategy_lifecycle/strategy_health_score.py
 src/quant_platform_kit/strategy_lifecycle/update_orchestrator.py
 src/quant_platform_kit/strategy_lifecycle/update_policy.py
+src/quant_platform_kit/strategy_spec/__init__.py
+src/quant_platform_kit/strategy_spec/cli.py
+src/quant_platform_kit/strategy_spec/validation.py
 tests/test_backtest_orchestrator.py
 tests/test_binance_account.py
 tests/test_binance_client.py

src/quant_platform_kit/strategy_lifecycle/__init__.py

@@ -14,7 +14,7 @@
     UpdateStage,
     WindowPerformance,
 )
-from quant_platform_kit.strategy_lifecycle.spec_validation import (
+from quant_platform_kit.strategy_spec import (
     OPTIMIZATION_SPEC_SCHEMA_VERSION,
     RESEARCH_SPEC_SCHEMA_VERSION,
     validate_optimization_spec,

src/quant_platform_kit/strategy_spec/__init__.py

@@ -0,0 +1,19 @@
+"""Lightweight public API for versioned strategy specification contracts."""
+
+from quant_platform_kit.strategy_spec.validation import (
+    OPTIMIZATION_SPEC_SCHEMA_VERSION,
+    RESEARCH_SPEC_SCHEMA_VERSION,
+    validate_optimization_spec,
+    validate_research_spec,
+    validate_strategy_spec,
+    validate_strategy_spec_file,
+)
+
+__all__ = [
+    "OPTIMIZATION_SPEC_SCHEMA_VERSION",
+    "RESEARCH_SPEC_SCHEMA_VERSION",
+    "validate_optimization_spec",
+    "validate_research_spec",
+    "validate_strategy_spec",
+    "validate_strategy_spec_file",
+]

…tform_kit/strategy_lifecycle/spec_cli.py …/quant_platform_kit/strategy_spec/cli.pysrc/quant_platform_kit/strategy_lifecycle/spec_cli.py renamed to src/quant_platform_kit/strategy_spec/cli.py src/quant_platform_kit/strategy_lifecycle/spec_cli.py renamed to src/quant_platform_kit/strategy_spec/cli.py

@@ -5,7 +5,7 @@
 import argparse
 import sys
 
-from quant_platform_kit.strategy_lifecycle.spec_validation import validate_strategy_spec_file
+from quant_platform_kit.strategy_spec.validation import validate_strategy_spec_file
 
 
 def main(argv: list[str] | None = None) -> int:

…it/strategy_lifecycle/spec_validation.py …platform_kit/strategy_spec/validation.pysrc/quant_platform_kit/strategy_lifecycle/spec_validation.py renamed to src/quant_platform_kit/strategy_spec/validation.py src/quant_platform_kit/strategy_lifecycle/spec_validation.py renamed to src/quant_platform_kit/strategy_spec/validation.py

@@ -443,7 +443,7 @@ def _parse_date(value: Any) -> date | None:
 
 
 def _parse_datetime(value: str) -> datetime | None:
-    candidate = value.strip()
+    candidate = value
     if not _RFC3339_DATETIME.fullmatch(candidate):
         return None
     if candidate.endswith("Z"):

tests/test_strategy_spec_validation.py

@@ -6,14 +6,14 @@
 import sys
 from pathlib import Path
 
-from quant_platform_kit.strategy_lifecycle.spec_validation import (
+from quant_platform_kit.strategy_spec import (
     OPTIMIZATION_SPEC_SCHEMA_VERSION,
     RESEARCH_SPEC_SCHEMA_VERSION,
     validate_optimization_spec,
     validate_research_spec,
     validate_strategy_spec_file,
 )
-from quant_platform_kit.strategy_lifecycle.spec_cli import main as spec_cli_main
+from quant_platform_kit.strategy_spec.cli import main as spec_cli_main
 
 
 ROOT = Path(__file__).resolve().parents[1]
@@ -196,6 +196,13 @@ def test_research_spec_rejects_naive_or_date_only_timestamps() -> None:
     assert "data.as_of must be an ISO date-time" in issues
 
 
+def test_research_spec_rejects_timestamp_whitespace() -> None:
+    payload = _research_spec()
+    payload["created_at"] = " 2026-07-11T00:00:00Z "
+
+    assert "created_at must be an ISO date-time" in validate_research_spec(payload)
+
+
 def test_research_spec_rejects_non_rfc3339_date_forms() -> None:
     payload = _research_spec()
     evaluation = payload["evaluation"]