Upload alpha_factory/deterministic/acceptance_checklist.py with huggingface_hub

alpha_factory/deterministic/acceptance_checklist.py

@@ -0,0 +1,124 @@
+"""
+Acceptance Checklist — Layer 7 enforcer.
+Every alpha MUST pass all 14 checks before submission.
+This is the "print and tape to your monitor" checklist, codified.
+"""
+from dataclasses import dataclass, field
+from ..schemas import Blueprint, Expression, LintResult
+from ..deterministic.lint import quick_dedup_hash
+
+
+@dataclass
+class ChecklistResult:
+    """Result of running the full acceptance checklist."""
+    all_passed: bool = False
+    checks: dict = field(default_factory=dict)
+    blocking_failures: list = field(default_factory=list)
+
+    def __str__(self):
+        lines = ["═══ ACCEPTANCE CHECKLIST ═══"]
+        for name, passed in self.checks.items():
+            icon = "✓" if passed else "✗"
+            lines.append(f"  [{icon}] {name}")
+        if self.blocking_failures:
+            lines.append(f"\n  BLOCKING: {', '.join(self.blocking_failures)}")
+        lines.append(f"\n  VERDICT: {'PASS ✓' if self.all_passed else 'FAIL ✗'}")
+        return "\n".join(lines)
+
+
+def run_acceptance_checklist(
+    blueprint: Blueprint,
+    expression: Expression,
+    lint_result: LintResult,
+    alpha_id: str,
+    existing_hashes: set,
+    existing_anomaly_tags: list,
+    max_corr_to_library: float = 0.0,
+    local_sim_sharpe: float = 0.0,
+    local_sim_fitness: float = 0.0,
+    local_sim_turnover: float = 0.0,
+    returns_corr: float = 0.0,
+    sign_validated: bool = False,
+) -> ChecklistResult:
+    """
+    Run all 14 acceptance checks from §3 of the design doc.
+    Returns ChecklistResult with pass/fail for each.
+    """
+    checks = {}
+    failures = []
+
+    # 1. ARCHETYPE — maps to proven archetype or cites paper
+    archetype_ok = (
+        blueprint.archetype in ["value_quality_blend", "intraday_mr_decay", "vol_scaled_shock",
+                                 "pead_revisions", "skew_term", "social_momentum",
+                                 "multi_horizon_mr", "fundamental_yield_composite"]
+        or blueprint.academic_anchor is not None
+    )
+    checks["ARCHETYPE (proven or cited)"] = archetype_ok
+    if not archetype_ok:
+        failures.append("No proven archetype and no academic anchor")
+
+    # 2. LINT — passes static lint
+    checks["LINT (operators, lookahead, units)"] = lint_result.passed
+    if not lint_result.passed:
+        failures.append(f"Lint failed: {lint_result.errors[:2]}")
+
+    # 3. DEDUP — not already in factor store
+    dedup_ok = alpha_id not in existing_hashes
+    checks["DEDUP (not in factor store)"] = dedup_ok
+    if not dedup_ok:
+        failures.append("Duplicate expression")
+
+    # 4. COVERAGE — fields have coverage ≥ 0.5 (placeholder — need field coverage data)
+    checks["COVERAGE (fields ≥ 0.5)"] = True  # assume pass until we have coverage data
+
+    # 5. SIGN — direction validated
+    checks["SIGN (validated by paper or sweep)"] = sign_validated or blueprint.academic_anchor is not None
+    if not (sign_validated or blueprint.academic_anchor):
+        failures.append("Sign not validated")
+
+    # 6. LOCAL SIM — passes local BRAIN simulation
+    local_sim_pass = local_sim_sharpe >= 1.0
+    checks["LOCAL SIM (Sharpe ≥ 1.0)"] = local_sim_pass
+
+    # 7. CORRELATION — max corr to library < 0.65
+    corr_ok = max_corr_to_library < 0.65
+    checks["CORRELATION (< 0.65 to library)"] = corr_ok
+    if not corr_ok:
+        failures.append(f"Max corr {max_corr_to_library:.2f} ≥ 0.65")
+
+    # 8. RETURNS-CORR — not a momentum mirror, not noise
+    returns_corr_ok = 0.05 <= abs(returns_corr) <= 0.85
+    checks["RETURNS-CORR (0.05 ≤ |corr| ≤ 0.85)"] = returns_corr_ok
+
+    # 9. ANOMALY-TAG — novel or under-represented
+    tag_count = existing_anomaly_tags.count(blueprint.anomaly_tag.value)
+    anomaly_ok = tag_count < 3
+    checks["ANOMALY-TAG (< 3 in library)"] = anomaly_ok
+    if not anomaly_ok:
+        failures.append(f"Anomaly '{blueprint.anomaly_tag.value}' already has {tag_count} alphas")
+
+    # 10. ACADEMIC ANCHOR — at least one cited paper
+    checks["ACADEMIC ANCHOR (paper cited)"] = blueprint.academic_anchor is not None
+
+    # 11. NEUTRALIZED — chosen consciously
+    checks["NEUTRALIZED (explicit choice)"] = blueprint.neutralization.value != "none"
+
+    # 12. DECAY — applied if noisy
+    checks["DECAY (applied if needed)"] = blueprint.decay > 0
+
+    # 13. NOVELTY CLAIM — non-empty, meaningful
+    novelty_ok = len(blueprint.novelty_claim) >= 20
+    checks["NOVELTY CLAIM (≥ 20 chars)"] = novelty_ok
+
+    # 14. DECISION TREE — kill criterion defined (implicit in pipeline)
+    checks["DECISION TREE (kill criterion set)"] = True
+
+    # Overall verdict
+    all_passed = len(failures) == 0 and all(checks.values())
+
+    return ChecklistResult(
+        all_passed=all_passed,
+        checks=checks,
+        blocking_failures=failures,
+    )