Skip to content

Foreshadow v0.4.0 — Project Intelligence & Outcome Learning

Choose a tag to compare

@rainhuang0220 rainhuang0220 released this 03 Sep 09:36
b1bcb57

Project Intelligence + Outcome Learning Infrastructure + Champion/Challenger Shadow Learning.

This release is not a claim that Foreshadow now predicts future GitHub success. The ranking champion remains the formula. The learning stack starts in Collecting Data / Shadow mode.

Product

  • Project summaries — extractive 2–4 line description (repo description + README + topics), not a model hallucination.
  • Four scores — Potential, Creator Prior, Contributor Openness, Entry Fit. Homepage sorts by Expected Entry Value. Rank is ordinal (序 ≠ 质量), not a quality grade.
  • Official Top 5 is unchanged: v1 55 / 35 / local v7. Empty Top 5 is still success. EEV never writes selected_rank.
  • Observation intelligence — still the daily radar + observation panel; intelligence scores sit beside it.
  • Creator history — prior from HydrateB owner.repositories. UI: 持续维护项目 (age ≥ 180d and still maintained), not “historical success.”
  • Recent sampled openness — Wilson lower bound of a recent closed external PR sample (not full-history acceptance). Ignored-PR ratio is not shown.
  • Outcome labels — 7 / 30 / 90 day columns. Missing horizons stay NULL, never 0-filled.

Learning

  • Champion — formula-v1 Expected Entry Value. Never auto-promoted away.
  • Challenger — optional sklearn HistGradientBoosting via extra [learn]. First-phase target is growth_sign_30d (sign of 30-day star delta). Shadow only. Not Project Potential. A single +1 star in 30 days is a positive label.
  • Background trainer — weekly oneshot, SQLite read-only, no GitHub. SKIPPED_INSUFFICIENT_DATA is the correct state until labels exist.
  • First real ML milestone is later: challenger beats champion on out-of-time evaluation.

Install

uv tool install "git+https://github.com/rainhuang0220/foreshadow.git@v0.4.0"
# existing install:
uv tool install "git+https://github.com/rainhuang0220/foreshadow.git@v0.4.0" --reinstall

Schema 7 → 8 is additive (model_runs, intel_scores, outcome_labels). foreshadow run / board / doctor migrate.

Unchanged

  • Draft PR remains disabled. No third-party GitHub writes.
  • No PPO / real bandit control.