Skip to main content

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​

AreaWhat's in 1.2.0
Item typesFive beyond multiple choice: matching, true-false-not-given, fill-in-blank, short-answer, essay
IELTSRegistered end to end; sections named by skill, each narrowing the item types it accepts
Built-in examsAcademic Reading (14 questions, one original 400–600 word passage, 60 min) and Academic Writing (2 ungraded essay tasks)
ResultsWritten responses show as awaiting review rather than wrong; a mixed paper reports the graded denominator
VersioningAuthored once in the root package.json; a guard test fails CI on drift

New since v1.1.1​

Item types and exam-type registries​

  • matching and true-false-not-given are choice-shaped and reuse options / correctAnswer
  • fill-in-blank and short-answer are text-graded — whitespace-collapsed and case-folded unless caseSensitive
  • essay is captured and never auto-scored
  • An all-essay paper no longer reads "0% — NOT PASSED"

Authoring and sitting​

  • Alembic 0011_question_answer_key — nullable answer_key JSON on questions
  • 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). custom exams 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_key joins the existing freeze-diff

Engineering​

  • The version is authored once in the root package.json. npm run version:sync writes it into frontend/package.json and a generated backend/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=True and ielts is enabled by default in exam_type_flags, so they are visible to all users unless IELTS is disabled in this environment
  • ielts-academic-reading-1 seeds at seedVersion 4; 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.