LinguFlow 1.2.0
Release version: v1.2.0
Status: Superseded by v1.2.1
GitHub Release: https://github.com/newtc22222/lingu-flow/releases/tag/v1.2.0
Previous: v1.1.1 · v1.0.0
Production cut of staging since v1.1.1. The exam system is no longer TOEIC-only: per-exam-type behaviour moved into code-driven registries, five new item types shipped, and IELTS became the first exam registered against the new abstraction.
Version strings are 1.2.0 on the package, OpenAPI, GET /api/health, and the
arcade footer — and from this release they all derive from a single authored
location.
Product highlights
| Area | What's in 1.2.0 |
|---|---|
| Item types | Five beyond multiple choice: matching, true-false-not-given, fill-in-blank, short-answer, essay |
| IELTS | Registered end to end; sections named by skill, each narrowing the item types it accepts |
| Built-in exams | Academic Reading (14 questions, one original 400–600 word passage, 60 min) and Academic Writing (2 ungraded essay tasks) |
| Results | Written responses show as awaiting review rather than wrong; a mixed paper reports the graded denominator |
| Versioning | Authored once in the root package.json; a guard test fails CI on drift |
New since v1.1.1
Item types and exam-type registries
matchingandtrue-false-not-givenare choice-shaped and reuseoptions/correctAnswerfill-in-blankandshort-answerare text-graded — whitespace-collapsed and case-folded unlesscaseSensitiveessayis captured and never auto-scored- An all-essay paper no longer reads "0% — NOT PASSED"
Authoring and sitting
- Alembic
0011_question_answer_key— nullableanswer_keyJSON onquestions - Authoring is section-aware: the item-type selector offers only what the chosen section uses, and switching exam type re-defaults the section
- The API rejects an item type a registered section does not use (422).
customexams and questions without a part stay unconstrained - Free-text answers save on a 600 ms per-question debounce, are serialized per question so a slow write cannot persist a stale prefix, and are flushed and awaited before submit
- An answered question's answer key stays frozen (409) —
answer_keyjoins the existing freeze-diff
Engineering
- The version is authored once in the root
package.json.npm run version:syncwrites it intofrontend/package.jsonand a generatedbackend/app/version.py. It previously lived in seven places and drifted silently - The Postgres integrity CI job now genuinely runs. It had been passing without
executing a single assertion — Alembic never found
alembic.ini, and a broad handler reported that as "Postgres not available" and skipped
Deploy notes (production)
Railway must apply Alembic 0011_question_answer_key — additive and
nullable, no backfill.
The seeder then runs from the same entrypoint and changes built-in content:
- Two new public IELTS templates appear. Seeded templates are
is_public=Trueandieltsis enabled by default inexam_type_flags, so they are visible to all users unless IELTS is disabled in this environment ielts-academic-reading-1seeds atseedVersion4; the template row is updated in place, so its id survives and sessions already sat against it keep resolving. Its questions are archived and recreated via soft delete, so past results still render- No TOEIC content changes
Confirm GET /api/health reports "version": "1.2.0".
Not in this release
- Grading of written responses — essays are captured and excluded from the score denominator, but there is no reviewer flow (#20)
- Speaking — no mic capture, no sitter-side upload, no audio playback in results (#79, #89, #90, #91)
- TOEIC Listening content — Parts 1–4 exist in the taxonomy and the player works, but no paper seeds them; TOEIC ships Reading only (Parts 5–7)
- Scaled and band scoring — scores remain a raw percentage, not 10–990 or 0–9
Shipped PRs
- #102 generalize the exam system beyond TOEIC (IELTS build-out)
- #103 this release (staging → main)
Issues closed
None. This work came from a reviewed design document rather than tracked issues; the exam-type items above stay open.
Tag: v1.2.0 on main.
Next: v1.2.1 — three-theme system and the OMR answer sheet.