gemmate-srs

The Executa (Anna plugin) behind the GemMate Anna App. A single long-running process that speaks JSON-RPC 2.0 over stdio and exposes the study engine the app's UI calls into.

Tools

Scheduling, deck and card state live in Anna Persistent Storage (APS), never in the iframe, so progress survives window close, reload and device changes.

SM-2 scheduling

Implements the standard SuperMemo-2 update:

• quality >= 3 → first pass sets interval 1 day, second sets 6 days, then interval = round(interval * EF) with round matching Dart's double.round() (half away from zero) — not Python's banker's rounding.
• quality < 3 → repetitions reset to 0, interval back to 1 day.
• EF' = max(1.3, EF + (0.1 - (5 - q) * (0.08 + (5 - q) * 0.02))), applied on every grade including failures, which is what the original GemMate Dart implementation does and what existing review history expects.

LLM use

The four generation tools call the host LLM through Anna sampling (sampling/createMessage). They are additive: review, deck and card management never touch the LLM, so a user who declines the sampling grant still gets a fully working spaced-repetition app.

Development

uv sync --extra test
uv run pytest -q
uv run gemmate-srs          # the plugin loop; reads JSON-RPC frames on stdin

Distribution

Declared in executa.json as distribution.type = "uv". The platform installs it with uv tool install gemmate-srs and launches the gemmate-srs console script.