SubMiner/backlog/tasks/task-204.1 - Restore-stale-only-startup-known-word-cache-refresh.md at 5feed360caa29aed4e61cefc78f206d52774ff55 - SubMiner

mirror of https://github.com/ksyasuda/SubMiner.git synced 2026-03-24 00:11:27 -07:00

Files

sudacode 5feed360ca feat: add app-owned YouTube subtitle flow with absPlayer-style parsing (#31 )

* fix: harden preload argv parsing for popup windows

* fix: align youtube playback with shared overlay startup

* fix: unwrap mpv youtube streams for anki media mining

* docs: update docs for youtube subtitle and mining flow

* refactor: unify cli and runtime wiring for startup and youtube flow

* feat: update subtitle sidebar overlay behavior

* chore: add shared log-file source for diagnostics

* fix(ci): add changelog fragment for immersion changes

* fix: address CodeRabbit review feedback

* fix: persist canonical title from youtube metadata

* style: format stats library tab

* fix: address latest review feedback

* style: format stats library files

* test: stub launcher youtube deps in CI

* test: isolate launcher youtube flow deps

* test: stub launcher youtube deps in failing case

* test: force x11 backend in launcher ci harness

* test: address latest review feedback

* fix(launcher): preserve user YouTube ytdl raw options

* docs(backlog): update task tracking notes

* fix(immersion): special-case youtube media paths in runtime and tracking

* feat(stats): improve YouTube media metadata and picker key handling

* fix(ci): format stats media library hook

* fix: address latest CodeRabbit review items

* docs: update youtube release notes and docs

* feat: auto-load youtube subtitles before manual picker

* fix: restore app-owned youtube subtitle flow

* docs: update youtube playback docs and config copy

* refactor: remove legacy youtube launcher mode plumbing

* fix: refine youtube subtitle startup binding

* docs: clarify youtube subtitle startup behavior

* fix: address PR #31 latest review follow-ups

* fix: address PR #31 follow-up review comments

* test: harden youtube picker test harness

* udpate backlog

* fix: add timeout to youtube metadata probe

* docs: refresh youtube and stats docs

* update backlog

* update backlog

* chore: release v0.9.0

2026-03-24 00:01:24 -07:00

3.1 KiB

Raw Blame History

id, title, status, assignee, created_date, updated_date, labels, dependencies, references, parent_task_id, priority, ordinal

title

status

assignee

created_date

updated_date

labels

dependencies

references

parent_task_id

priority

ordinal

TASK-204.1

Restore stale-only startup known-word cache refresh

Done

@Codex

2026-03-20 02:52

2026-03-23 03:22

anki

cache

bug

src/anki-integration/known-word-cache.ts

src/anki-integration/known-word-cache.test.ts

docs/plans/2026-03-19-known-word-cache-incremental-sync-design.md

TASK-204

high

124500

Description

Follow up on the incremental known-word cache change so startup still performs a refresh when the persisted cache is older than the configured refresh interval, while leaving fresh persisted state untouched.

Acceptance Criteria

#1 Startup refreshes known words immediately when persisted cache state is stale for the configured interval.
#2 Startup skips the immediate refresh when persisted cache state is still fresh.
#3 Regression tests cover both stale and fresh startup paths.

Implementation Plan

Add focused known-word cache lifecycle tests that distinguish fresh startup state from stale startup state and verify the stale path currently fails.
Update startup scheduling in src/anki-integration/known-word-cache.ts so persisted cache still loads immediately, but startup only triggers an immediate refresh when the cache is stale for the configured interval or the cache scope/config changed.
Run focused known-word cache tests and targeted SubMiner verification for the touched cache/runtime lane, then update the task with results.

Implementation Notes

Verified current lifecycle behavior: fresh persisted known-word cache already skips immediate startup refresh when the cache scope/config matches; stale persisted cache already refreshes immediately. Added regression coverage for both startup paths plus a proxy integration test showing addNote responses return without waiting for background enrichment.

Final Summary

Added regression coverage for known-word cache startup behavior and proxy response timing. The cache tests now lock in the intended lifecycle: fresh persisted state stays load-only on startup, while stale persisted state refreshes immediately. Added a proxy integration test proving addNote responses return without waiting for background enrichment. Verification: targeted Bun tests passed (bun test src/anki-connect.test.ts src/anki-integration/anki-connect-proxy.test.ts src/anki-integration/known-word-cache.test.ts src/anki-integration/note-update-workflow.test.ts src/anki-integration/runtime.test.ts) and direct bun run test:fast passed. The subminer-change-verification helper repeatedly reported bun run test:fast as failed in its isolated lane despite the direct command passing, so that helper lane remains a flaky/blocking verification artifact rather than a reproduced code failure.

3.1 KiB Raw Blame History