Repository navigation
Foreshadow v0.4.0 — Project Intelligence & Outcome Learning
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-v1Expected Entry Value. Never auto-promoted away. - Challenger — optional sklearn HistGradientBoosting via extra
[learn]. First-phase target isgrowth_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_DATAis 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" --reinstallSchema 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.