Get the Japanese items most in need of review right now, ordered by priority. Call this at the start of a review session. Returns grammar points and vocabulary with a freshness score for each, plus a note on how the learner last got it wrong.

Get a pool of Japanese words and grammar the learner has ALREADY mastered, for active-use practice — the opposite of the review queue. Use this when the learner wants to be tested on or practice words they already know, not review what they're forgetting. Workflow: (1) ideate a concrete conversation theme or scenario (ordering at an izakaya, complaining about the weather, a job interview); (2) call this to get the mastered pool; (3) the pool is NOT pre-filtered by theme — from it, you pick the words and grammar that fit your theme, using each item's meaning; (4) propose the scenario and your chosen words to the learner and get their buy-in before starting; (5) run the practice conversation; (6) at the end, call submit_grades once for every item you practiced — grade fluent use 3 or 4, hesitation 2, and a blank or misuse 1 with a one-sentence error_note. Returns each item with its meaning and reading so you can select by theme.

Get everything known about one Japanese grammar point or word, including the learner's own notes from their vault.

Record how the learner performed on items during a review. Call this at the END of a review session, once, with every item you observed. Grade 1 = could not recall or used it wrong, 2 = struggled, 3 = correct, 4 = effortless. Include a one-sentence error_note when they got it wrong, describing the specific mistake.

Add a Japanese grammar point or word the learner has just encountered. Fill in the reading, meaning, and JLPT level yourself from your own knowledge of Japanese — do not ask the learner for them unless the word is genuinely ambiguous. Put any context the learner gave you (where they met it, what confused them) into note. If the learner says they already partly know this word (e.g. "I'm Adept on this" or quotes a Bunpro SRS stage), pass that bucket as progress — one of Beginner, Adept, Seasoned, Expert, Master — so the review schedule starts from their actual familiarity instead of treating it as brand new. Leave progress unset for something they are meeting for the first time.

Import a Bunpro CSV export into the vault. ALWAYS run with dry_run=true first and show the learner the report before running for real.