Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
34 changes: 17 additions & 17 deletions CURRENT_PLAN.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,41 +2,41 @@

## Plan ID

PLAN-006
PLAN-007

## Goal

Recover the stale ranking data and let delayed GitHub schedule runs catch up once per Los Angeles calendar day without duplicate refreshes, with consistent daily-update copy on both public landing pages.
Complete every missing detailed translation and one-line hook in the current ranking across all five languages, while preserving existing translations and all API-derived data.

## In Scope

- `tools/schedule_guard.py`, `.github/workflows/daily-update.yml`, `tests/test_schedule.py`
- `docs/DAILY_UPDATE.md`, English/Simplified Chinese Pages copy, and project governance records
- Owner-authorized merge of PR #19 and deployment verification
- Manual execution and verification of the existing production data workflow
- Current-source entries in `data/translation_library.json`
- Generated README and details pages via `tools/render_readme.py`
- Completeness, terminology, existing-entry preservation and publication checks

## Out of Scope

- Ranking calculations, generated data edits, translations, cron frequency, local launchd settings
- Star data, ranking order, historical snapshot data, source descriptions, existing translations, model configuration, unrelated copy or automation redesign

## Tasks

- [x] Diagnose skipped schedule runs and start the existing manual data update
- [x] Add regression tests for late runs, same-day deduplication, DST, invalid state and workflow error propagation
- [x] Gate scheduled refreshes on the committed data's Los Angeles date, preserving manual dispatch and local-hour mode
- [x] Run full verification and document operator behavior and follow-up
- [x] Verify production refresh run 42373937914 and committed data at `2656f40`
- [x] Correct both Pages descriptions and metadata; verify the final PR head
- [ ] Verify the first unattended schedule run after the authorized merge; confirm no same-day duplicate
- [x] Audit repository requirements, current source hashes and missing language/hook fields
- [x] Fill the missing detailed translations and short hooks using the glossary and existing guards
- [x] Independently review all new wording and prove no old translated field changed
- [x] Regenerate pages and verify zero translation/hook gaps across all current categories
- [ ] Publish the completed content and verify CI and Pages on the resulting commit

## Verification

- `python3 tools/i18n_pipeline.py --translate --hooks --dry-run`
- `python3 tools/newcomer_i18n.py --strict`
- `python3 tools/verify.py`
- `python3 tools/verify.py --daily`
- `python3 tools/next_plan.py --check`
- Compare all previously stored translation fields and API data with the base commit

## Next Candidates

- After owner-approved merge, verify a delayed scheduled run publishes data and the second trigger skips
- Monitor Pages freshness separately from the data workflow if the bot commit does not trigger deployment
- Thin newcomer boards and acceleration column remain in `TODO_BACKLOG.md`
- Observe the next unattended scheduled update and same-day duplicate suppression
- Consider making the operator completeness check cover hooks as well as translations without blocking raw-data refreshes
- Thin newcomer boards and the acceleration column remain in `TODO_BACKLOG.md`
42 changes: 21 additions & 21 deletions README.ja.md

Large diffs are not rendered by default.

42 changes: 21 additions & 21 deletions README.ko.md

Large diffs are not rendered by default.

42 changes: 21 additions & 21 deletions README.md

Large diffs are not rendered by default.

44 changes: 22 additions & 22 deletions README.zh-Hans.md

Large diffs are not rendered by default.

44 changes: 22 additions & 22 deletions README.zh-Hant.md

Large diffs are not rendered by default.

2 changes: 2 additions & 0 deletions TODO_BACKLOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,8 @@

## Next

- [ ] Add an explicit all-category translation-and-hook completion audit, including non-English sources beyond CJK, separate from the fail-safe raw-data refresh

- [ ] Acceleration column (stars/day this week vs. previous week) from `data/stars.json` snapshots
- [ ] Add more tracked projects (needs five-language `desc`)

Expand Down
663 changes: 659 additions & 4 deletions data/translation_library.json

Large diffs are not rendered by default.

76 changes: 38 additions & 38 deletions docs/DETAILS.ja.md

Large diffs are not rendered by default.

76 changes: 38 additions & 38 deletions docs/DETAILS.ko.md

Large diffs are not rendered by default.

78 changes: 39 additions & 39 deletions docs/DETAILS.md

Large diffs are not rendered by default.

78 changes: 39 additions & 39 deletions docs/DETAILS.zh-Hans.md

Large diffs are not rendered by default.

78 changes: 39 additions & 39 deletions docs/DETAILS.zh-Hant.md

Large diffs are not rendered by default.

5 changes: 5 additions & 0 deletions docs/project-governance/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,10 @@
# CHANGELOG.md

## 2026-11-07 (complete current translations)

- Completed detailed descriptions and short hooks for all current ranking entries in English, Simplified Chinese, Traditional Chinese, Japanese and Korean.
- Retained existing translations, source descriptions, rankings and star data; regenerated README and details pages from the translation library.

## 2026-11-07 (delayed schedule recovery)

- Scheduled updates can catch up after GitHub starts a job late. The committed data date prevents a second scheduled refresh on the same Los Angeles day.
Expand Down
7 changes: 7 additions & 0 deletions docs/project-governance/DECISIONS.md
Original file line number Diff line number Diff line change
Expand Up @@ -100,3 +100,10 @@
- Any successfully committed refresh on that LA date suppresses scheduled duplicates, including manual refreshes. Manual dispatch remains unconditional; local hour-gated fallback is unchanged.
- Keep workflow concurrency and fresh `main` checkout. Invalid/future state fails visibly; only exit 1 means an intentional skip. Do not backfill missed snapshots with today's numbers.
- The immediate refresh used the existing production workflow. The owner subsequently authorized merging PR #19 and correcting the stale Pages schedule copy. Public English and Simplified Chinese copy says daily without exact clock claims; visible text and structured metadata stay aligned.


## 2026-11-07 — translation completion is separate from data freshness

- A successful API refresh or permissive daily verification is not evidence that translation is complete. Completion requires zero missing detailed-description and hook languages across every current category, plus a source-language audit for English output.
- Translation-library edits fill missing fields under the exact source hash; existing translated text and original descriptions stay unchanged. Public tables use short hooks and details pages retain complete introductions.
- The existing CJK-only English-gap detector can miss Turkish/Vietnamese sources. Their missing English translations are filled explicitly in this round without changing the model configuration or weakening validators.
10 changes: 10 additions & 0 deletions docs/project-governance/WORKLOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -96,3 +96,13 @@
- Updated English and Simplified Chinese Pages body copy, facts table, FAQ, search/social metadata and JSON-LD to daily, matching the current public README/FAQ wording. No ranking data or layout changes.
- Page verification first failed on the old structured description, then passed for both languages after correction; JSON-LD is valid and the visible FAQ matches its structured answer. Full verification passed with 231 tests; daily verification, plan validation and diff checks passed.
- Merge the exact verified final head after its CI passes. No formal review approval is submitted. Next operational check: confirm main CI/Pages deployment, then observe the next unattended schedule run for refresh and duplicate suppression.


## 2026-11-07 — complete current ranking translations (PLAN-007)

- The current ranking had 38 missing detailed descriptions and 39 repos with missing hook languages. API/data success did not mean translation completeness; the previous completion report left this work unfinished.
- Added 159 detailed translations and 192 one-line hooks across 40 current-source entries. This includes English for two Turkish source descriptions and one Vietnamese source description that the CJK-only English-gap detector did not report.
- All 48 current newcomers now have complete displayed descriptions in all five languages and 240 valid hooks. Existing 70 tracked-project descriptions/hooks remain intact. Only missing fields were filled; prior library fields are preserved except the normal `seen` date metadata on entries used today.
- Independent semantic review covered all new wording; corrected truncated endings, neutral software-package labels and the meaning of persistent bots. Detailed descriptions retain facts/names/versions; hooks remain separate short text.
- Verification: 48/48 translation hits, zero translation or hook gaps; `newcomer_i18n.py --strict`, all 231 tests, `verify.py --daily`, plan and diff checks passed. API star counts, ranking inputs, latest stats and every historical stats snapshot are byte-identical to the base commit.
- Next: publish and verify the exact final commit, then ensure future completeness checks cover all categories, hooks and non-English sources beyond CJK.
Loading