v0.6.1

Live Gate-2 readiness. One human Submit click may create exactly one PR.

• READY_FOR_HUMAN_SUBMIT is shown only when the approved commit, write credential, current snapshot, and exact upstream all check out.
• The write port may fork if needed, push that exact commit without force, and create one PR. Lost-response recovery reuses the existing fork or PR.
• Schema 10: one durable submission row per approval snapshot.
• Comments, review, merge, and force-push stay denied.
• This release does not submit ripwire #74.

v0.6.0

Two human gates. Mission identity is mission_id plus issue.

• Gate 1 进入 authorizes local work. Intermediate phases do not stop for extra approval.
• Gate 2 提交到 GitHub authorizes one immutable snapshot: fork if needed, push one branch, create one PR.
• Comments, review, merge, and force-push stay denied.
• ripwire #74 is imported as READY_FOR_HUMAN_SUBMIT and is not submitted by this release.

Foreshadow v0.5.1 — short maintainer PR titles

Patch on v0.5.0. Maintainer-facing PR titles now take short quoted literals from the change (for example undefined symbol) instead of pasting a whole added Go or test-log line.

Guarded local contribution, the review workspace, and the maintainer-output safety gate are unchanged. Third-party GitHub writes stay refused.

Install

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

Foreshadow v0.5.0 — guarded contribution and PR draft safety

Local autonomous contribution now stops at a review workspace. Maintainer-facing PR drafts are gated so Official ranking notes, privacy leaks, and ungrounded acceptance criteria cannot be sent to a third-party GitHub repo.

Added

• End-to-end local contribution on a confirmed issue: recertify, sandbox executor, tests, QA, and a package that stops at user review.
• Contribution Review Dashboard: Overview / Changes / PR Preview / Checks, with active vs history missions on the same repo.
• Maintainer-output safety gate on every PR draft. Unsafe drafts are MAINTAINER_OUTPUT_UNSAFE and cannot be submitted. Historical packages are revised by appending a new artifact, not overwritten.
• PR Preview shows a compact Draft safety status. Check details stay on Checks / Technical Details.

Unchanged

• Official Top 5 remains v1. Empty Top 5 is success.
• Third-party GitHub writes remain refused. YOLO auto-submit is not enabled.
• No PPO / RL.

Install

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

Foreshadow v0.4.1 — Board daily rollover

Board now follows the latest completed Official daily run without a process restart.

Fix

On 2026-09-04, Official finished at 00:37Z and wrote 120 intel_scores, but the public Board (started 2026-09-03) kept showing 2026-09-03 until systemctl restart foreshadow-board.

Each GET /api/board now selects the latest complete/degraded daily_runs row at or before UTC today. Pending or failed today keeps yesterday. Empty DB returns 200.

Schema remains 8. Official Top 5, EEV, learning, and Draft PR are unchanged.

Install

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

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-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.

v0.3.1

Fix Board CSRF origin check behind nginx: Host without a port is no longer treated as HTTP :80, so browser POSTs from https://foreshadow.plainlist.space work.

v0.3.0 tag is unchanged. Pin install to @v0.3.1.

v0.3.0

Opportunity → Contribution Agent.

• GitHub OAuth identity (token discarded after login). 30-day hashed sessions.
• Observation: fact / interpretation / decision, honest sparklines, clickable pools.
• Entry strategy Plan A/B/C with evidence-backed issue ids.
• Contribution executor with mini-SWE-agent. Stops at Contribution Ready.
• Real golden path: Cyrax321/CONTINUUM #582, QA PASS, 37→39 tests, 3 files, remote writes 0.
• Approve & Create Draft PR remains disabled.
• Schema 7 (additive). Bounded hydrate concurrency (6).

Pin install to @v0.3.0. Do not move v0.2.4.

Production URL: https://foreshadow.plainlist.space/ (HTTPS/OAuth operator setup after DNS).
Temporary HTTP: http://175.24.134.228:666/

v0.2.4

Public Board SPA no longer stays on the loading screen for anonymous visitors.

• Anonymous /api/portfolio 401 no longer wipes a loaded daily board.
• systemd units set PYTHONUNBUFFERED=1.
• Local foreshadow board is unchanged.

Pin install to @v0.2.4. Do not move v0.2.2 or v0.2.3.

Foreshadow v0.2.3

Public Board can be served behind a reverse proxy.

Anonymous visitors may read the daily list. Clone, mission setup, and reviews require login. Remote GitHub writes stay refused.

Install:

uv tool install \"git+https://github.com/rainhuang0220/foreshadow.git@v0.2.3\"

See docs/deploy.md for systemd + nginx.