D1: prefer eligible empty candidates + report eligible vs listed (#172)

[xenodeve]

Parent

Part of #172

What to build

Improve the existing case-study (and taxonomy if needed) capped generator loop so each run prefers projects that still need work, and dry-run/apply responses distinguish eligible candidates from merely scanned/listed published GitHub projects. Behavior of generation gates (#160 empty+auto, human skip) stays the same — this slice is ordering + reporting so operators and cron make measurable progress without misreading candidates:46.

Acceptance criteria

• Case-study dry-run reports both listed/scanned and eligible (would attempt LLM) counts
• Eligible empty+auto projects are preferred before already-complete rows in the capped loop
• Unit/controller tests cover the reporting and preference behavior at the public service/controller seam
• Default per-run cap remains 1; no Vercel timeout regression path introduced

Blocked by

None - can start immediately

[xenodeve]

EN — closing with evidence: the convergence this issue asked for has happened

Measured against production (ngpsbetwbhbemcoequoy, github-sourced published projects) on 2026-07-25 via PostgREST, next to the audit numbers this epic was filed with:

metric	at filing	now
published	47	46
has category	1/47	44/46
has content	1/47	44/46
has cover (snapshot_image)	9/47	46/46
has README snapshot	20/47	44/46
has AI overview	15/47	15/46
has live_url	10/47	9/46
category_owner='human' (AI-blocked)	46	0
content_owner='human' (AI-blocked)	46	0
project_tags / project_technologies rows	~1 project	205 / 140

The owner-default root cause was fixed in c4f7317 (#170/#171), and the capped generators have since converged the backlog on their own.

One gap remains, and it is not this issue: AI overview is still 15/46. generate-overviews was only wired into the hourly cron by #199 (merged as a7f8910 today) at maxPerRun = 1, so it converges without further work — that is waiting, not a task. If it has not moved in a few days, that is a new bug, not this one.

Cover note: snapshot_image is 46/46 while live_url is only 9/46, i.e. projects with no live URL are already receiving covers — the social-preview path is working in production.

TH — ปิดพร้อมหลักฐาน: การ converge ที่ issue นี้ขอ เกิดขึ้นแล้ว

วัดกับ production (ngpsbetwbhbemcoequoy โปรเจกต์ที่ published และมาจาก github) เมื่อ 2026-07-25 ผ่าน PostgREST เทียบกับตัวเลข audit ที่ epic นี้ถูกเปิดด้วย:

metric	ตอนเปิด issue	ตอนนี้
published	47	46
มี category	1/47	44/46
มี content	1/47	44/46
มี cover (snapshot_image)	9/47	46/46
มี README snapshot	20/47	44/46
มี AI overview	15/47	15/46
มี live_url	10/47	9/46
category_owner='human' (ถูก AI ข้าม)	46	0
content_owner='human' (ถูก AI ข้าม)	46	0
แถว project_tags / project_technologies	~1 โปรเจกต์	205 / 140

ต้นเหตุเรื่อง owner default ถูกแก้ใน c4f7317 (#170/#171) และ generator แบบ capped ก็ไล่ backlog จนบรรจบเองตั้งแต่นั้น

เหลือช่องว่างหนึ่งจุด และไม่ใช่ issue นี้: AI overview ยังอยู่ที่ 15/46 เพราะ generate-overviews เพิ่งถูกต่อเข้า cron รายชั่วโมงใน #199 (merge เป็น a7f8910 วันนี้) ที่ maxPerRun = 1 มันจะบรรจบเองโดยไม่ต้องทำอะไรเพิ่ม — นี่คือการรอ ไม่ใช่งาน ถ้าผ่านไปสองสามวันแล้วไม่ขยับ นั่นคือบั๊กใหม่ ไม่ใช่อันนี้

หมายเหตุเรื่อง cover: snapshot_image อยู่ที่ 46/46 ขณะที่ live_url มีแค่ 9/46 แปลว่าโปรเจกต์ที่ไม่มี live URL ได้ cover ไปแล้ว — เส้นทาง social-preview ทำงานอยู่บน production