SubMiner/backlog/tasks/task-177.2 - Count-homepage-new-words-by-headword.md at claude/infallible-murdock - SubMiner

mirror of https://github.com/ksyasuda/SubMiner.git synced 2026-03-20 03:16:46 -07:00

Files

Fix stats command flow and tracking metrics regressions

- Route default `subminer stats` through attached `--stats`; keep daemon path for `--background`/`--stop`
- Update overview metrics: lookup rate uses lifetime Yomitan lookups per 100 tokens; new words dedupe by headword
- Suppress repeated macOS `Overlay loading...` OSD during fullscreen tracker flaps and improve session-detail chart scaling
- Add/adjust launcher, tracker query, stats server, IPC, overlay, and stats UI regression tests; add changelog fragments

2026-03-19 15:46:52 -07:00

3.2 KiB

Raw Permalink Blame History

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

title

status

assignee

created_date

updated_date

labels

dependencies

references

parent_task_id

priority

TASK-177.2

Count homepage new words by headword

Done

@codex

2026-03-19 19:38

2026-03-19 19:40

stats

immersion-tracking

vocabulary

src/core/services/immersion-tracker/query.ts

stats/src/components/overview/TrackingSnapshot.tsx

stats/src/lib/dashboard-data.ts

TASK-177

medium

Description

Align the homepage New Words metric with the Known Words semantics by counting distinct headwords first seen in the selected window, so inflected or alternate forms of the same word do not inflate the summary.

Acceptance Criteria

#1 Homepage new-word counts use distinct headwords by earliest first-seen timestamp instead of counting separate word-form rows
#2 Homepage tooltip/copy reflects the headword-based semantics
#3 Automated tests cover the headword de-duplication behavior and affected overview copy

Implementation Plan

Change the new-word aggregate query to group imm_words by headword, compute each headword's earliest first_seen, and count headwords whose first sighting falls within today/week windows.
Add failing tests first for the aggregate path so multiple rows sharing a headword only contribute once.
Update homepage tooltip/copy to say unique headwords first seen today/week.
Run focused query and stats overview tests, then record verification and any blockers.

Implementation Notes

Updated the new-word aggregate to count distinct headwords by each headword's earliest first_seen timestamp, so multiple inflected/form rows for the same headword contribute only once.

Adjusted homepage tooltip copy to say unique headwords first seen today/week, keeping the visible card labels unchanged.

Focused verification passed for the query aggregate and homepage snapshot tests.

SubMiner verifier core lane artifact: .tmp/skill-verification/subminer-verify-20260319-123942-4intgW. bun run typecheck passed there; bun run test:fast still fails for the unrelated environment issue in scripts/update-aur-package.test.ts (mapfile: command not found).

Final Summary

Homepage New Words now uses headword-level semantics instead of counting separate (headword, word, reading) rows. The aggregate query groups imm_words by headword, uses each headword's earliest first_seen, and counts headwords first seen today or this week so alternate forms do not inflate the summary. The homepage tooltip copy now explicitly says the metric is based on unique headwords.

Added focused regression coverage for the de-duplication rule in getQueryHints and for the updated homepage tooltip text. Targeted bun test runs passed for the touched query and stats UI files. Repo verifier --lane core again passed bun run typecheck; bun run test:fast remains blocked by the unrelated existing scripts/update-aur-package.sh: line 71: mapfile: command not found failure.

3.2 KiB Raw Permalink Blame History