Skip to content

Release 1.3.1 - #36

Merged
egno merged 40 commits into
mainfrom
dev
Aug 5, 2026
Merged

Release 1.3.1#36
egno merged 40 commits into
mainfrom
dev

Conversation

@egno

@egno egno commented Aug 5, 2026

Copy link
Copy Markdown
Owner

Summary

  • Skill vs confidence split — unlocks and transition gating use per-key skill (min(speed, accuracy) without attempt ramp); confidence drives HUD labels, heatmap, and focus weighting.
  • Bigram progression — newest-key cohort gates the next letter; deficient cohort bigrams get guaranteed lesson slots and prioritized practice after solo keys clear.
  • Word-list and bounds fixes — dictionary words filter on 3–10 letter bounds (separate from Markov 2–4); focus bigram drills resample real words instead of splicing characters.
  • Bump to v1.3.1; refresh CHANGELOG, README, wiki (Focus states, Confidence tuning, Word lists), and demo GIF.

Test plan

  • uv run ruff check and uv run pyright pass locally
  • uv run pytest -q passes locally (592 tests)
  • uv run pytest -m snapshot -q passes locally (4 snapshots)
  • CI green on macOS, Ubuntu, and Windows matrix

Made with Cursor

Egno and others added 30 commits July 29, 2026 11:05
Expose session window and attempt floors in settings so unlocks, focus,
and heatmap respond to tunable confidence inputs; round scores to two
decimals so weak/mastered decisions match what practice displays.

Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Remove session window and attempt floors from Settings so routine saves
do not overwrite advanced adaptive-engine values; document settings.toml.

Co-authored-by: Cursor <cursoragent@cursor.com>
…in comments.

Also fixes a pyright error in _snapshot_unlock_state (list invariance on
Iterator vs list) that CI never reached because ruff failed first.
FOCUS_CHAR_BOOST weighting (added in b0f130e) changed the generated
lesson text but the checked-in snapshot was never refreshed to match.
Confidence uses min(speed, accuracy) with recency-weighted session
aggregates; stats trends unified on one widget; practice gets word-wrap,
typing colors, underline cursor, idle learn timer, and HUD Last deltas.

Co-authored-by: Cursor <cursoragent@cursor.com>
Keep dev 1.2.3 release changes when resolving conflicts with main (1.2.2).

Co-authored-by: Cursor <cursoragent@cursor.com>
Ruff import order, line length, unused imports, and aggregate int casts.

Co-authored-by: Cursor <cursoragent@cursor.com>
Run `uv run pre-commit install` once per clone to enable lint on commit.

Co-authored-by: Cursor <cursoragent@cursor.com>
Matches CI: uv run pyright with pass_filenames false so pyproject.toml scope applies.

Co-authored-by: Cursor <cursoragent@cursor.com>
Use explicit grid/spark_width kwargs in format_metric_trend_block and
TypedDict session fixtures in tests instead of untyped dict unpacking.

Co-authored-by: Cursor <cursoragent@cursor.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
Baselines were stale after 1.2.3 presentation changes; README now lists
what pre-commit covers vs the macOS snapshot job.

Co-authored-by: Cursor <cursoragent@cursor.com>
…ut dropdown when TOML layouts change without restart. Bump to 1.2.3 and expand layout TOML/repo tests.

Co-authored-by: Cursor <cursoragent@cursor.com>
Word-list sampling now scores dictionary words with transition weights so
adaptive lessons practice measured weak pairs, not just weak keys.

Co-authored-by: Cursor <cursoragent@cursor.com>
…a settings.toml.

New keys stay locked until unlocked bigrams with data meet the confidence threshold; lesson generation boosts weak focus keys and transitions using configurable multipliers (not exposed in the Settings UI).

Co-authored-by: Cursor <cursoragent@cursor.com>
Same-letter pairs no longer enter transition stats or unlock gates; lesson
building favors letter drill while any unlocked key is below mastery.
Leading skip keys also apply at word boundaries for accidental spaces.

Co-authored-by: Cursor <cursoragent@cursor.com>
Weak-focus lessons now guarantee a configurable share of focus-matching
words, sample the wordlist without replacement, and fall back to Markov
when the pool is exhausted. Adds lesson_word_count, focus_word_min_fraction,
and max_word_repeats to settings.toml, fixes empty-transition rebuild loops,
and hardens edge cases around invalid settings and tiny alphabets.

Co-authored-by: Cursor <cursoragent@cursor.com>
Users can set min/max generated word length in settings; the generator,
Markov fallback padding, and WPM↔CPM conversion use those bounds so
target speed matches the text they actually type.

Co-authored-by: Cursor <cursoragent@cursor.com>
Dictionary words in lessons now honor generated_word_min/max (same as
Markov), defaults tighten to 2-4 for shorter practice text, with
integration tests for settings.toml and WPM conversion paths.

Co-authored-by: Cursor <cursoragent@cursor.com>
# Conflicts:
#	.pre-commit-config.yaml
#	README.md
#	docs/CHANGELOG.md
#	pyproject.toml
#	src/keystrike/app.py
#	src/keystrike/application/build_lesson.py
#	src/keystrike/application/session_use_cases.py
#	src/keystrike/application/stats_use_cases.py
#	src/keystrike/domain/aggregate.py
#	src/keystrike/domain/confidence.py
#	src/keystrike/domain/version.py
#	src/keystrike/infrastructure/session_repo_jsonl.py
#	src/keystrike/presentation/screens/practice.py
#	src/keystrike/presentation/screens/stats.py
#	src/keystrike/presentation/textual_app.py
#	src/keystrike/presentation/theme.py
#	src/keystrike/presentation/widgets/hud.py
#	src/keystrike/presentation/widgets/kb_heatmap.py
#	tests/application/test_session_use_cases.py
#	tests/application/test_stats_use_cases.py
#	tests/domain/test_aggregate.py
#	tests/infrastructure/test_session_repo_jsonl.py
#	tests/presentation/__snapshots__/test_snapshots/test_practice_screen_snapshot.svg
#	tests/presentation/test_hud.py
#	tests/presentation/test_kb_heatmap.py
#	tests/presentation/test_practice_screen.py
#	tests/presentation/test_stats_screen.py
#	tests/presentation/test_typing_area.py
#	uv.lock
Remove duplicated session timer helpers, refresh practice/settings
snapshots, and skip Unix permission tests on Windows where chmod
semantics differ.

Co-authored-by: Cursor <cursoragent@cursor.com>
Egno and others added 10 commits July 31, 2026 13:32
Resolve conflicts: keep deduped session timer helpers, Windows
permission test skips, and dev practice-screen snapshot baseline.

Co-authored-by: Cursor <cursoragent@cursor.com>
Heatmap and HUD used attempt-ramped confidence, so calibrating keys could
look mastered while lessons still treated them as uncertain. skill_of keeps
display honest without changing scheduling; calibrating is first-class in
the UI with shorter HUD copy and Focus-States wiki docs.

Co-authored-by: Cursor <cursoragent@cursor.com>
Unlock the next key from per-key skill plus attempt floor, not ramped
confidence or bigram thresholds. Transition focus uses skill-only gating
so calibrating keys no longer block bigram focus; lesson sampling adds
coverage-deficit weight for under-sampled keys.

Co-authored-by: Cursor <cursoragent@cursor.com>
Wordlist sampling was using generated_word_min/max, so valid imported words were dropped or capped incorrectly while Markov fill should stay on its own 2–4 range.

Co-authored-by: Cursor <cursoragent@cursor.com>
Unpracticed auto-unlocked keys no longer block transition focus; two-key drills get an unmeasured-pair fallback and sparse transition weighting.

Co-authored-by: Cursor <cursoragent@cursor.com>
…on it

Give a just-mastered key's bigrams sampling weight and focus priority right
away instead of waiting for them to appear by chance (newest_key_unmeasured_pairs,
shared by focus selection and lesson weighting). Extend compute_unlocked with
an optional transition gate so the next letter also waits on the newest key's
single weakest measured bigram, bounded to one pair with a stall-attempts
safety valve so a stuck pair can't block progression forever.

Fix session_use_cases' unlock snapshot to pass transitions/gate settings into
compute_unlocked too, so alphabet_size can't ratchet past what the gate
actually cleared. Move the gate's shared "newest practiced key" primitives
into a neutral domain/newest_key module so focus.py and unlock.py depend on
it instead of each other.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Keep unlock and focus on measured skill while confidence drives remedial pacing; extract session_queries and refactor BuildLesson gating/focus resolution. Persist word-length bounds on SessionResult (schema v4) for remedial WPM gates and split domain tests with doc updates.

Co-authored-by: Cursor <cursoragent@cursor.com>
Resample dictionary words for focus bigrams instead of splicing chars into real words.

Co-authored-by: Cursor <cursoragent@cursor.com>
Skill/confidence split for unlocks and focus, bigram progression gating,
dictionary vs Markov word bounds, and word-list focus drill fixes.
Refresh README, wiki, CHANGELOG, and demo GIF.

Co-authored-by: Cursor <cursoragent@cursor.com>
@egno
egno merged commit a807932 into main Aug 5, 2026
8 checks passed
@egno
egno deleted the dev branch August 5, 2026 09:07
@egno
egno restored the dev branch August 5, 2026 09:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants