denis/aventuriers-des-mots
1
0
Fork 0
mirror of https://github.com/deunix-educ/aventuriers-des-mots.git synced 2026-10-13 02:11:58 +02:00
Code Issues Packages Projects Releases Wiki Activity

Add pure correction and pedagogy logic with full test coverage

Browse Source 
scripts/correction/: AnswerValidator (multiple choice, sentence
correction via tap-the-faulty-word + retype) and DictationAnalyzer
build the CorrectionResult structure from cahier des charges §6.
Dictation analysis aligns words with WordAligner (Wagner-Fischer edit
distance) before any character comparison, so an omitted or added
word doesn't cascade into false errors on every following word.
TextNormalizer handles non-breaking spaces, typographic apostrophes,
and decomposed-vs-composed French accented characters via an
explicit table (GDScript has no built-in NFC/NFD normalization).
Error classification follows the data annotations only (rule_id
present -> grammatical, absent -> unclassified), never a runtime
linguistic guess.

scripts/pedagogy/: DifficultyManager (per-skill difficulty from
recent results), AttemptFlow (3-attempt graduated aid: hint, then
explanation, then reveal, matching exercise-lifecycle.md's second
gap), and ReviewScheduler (the five mastery states from §9, with
session-counted spaced review intervals [1, 3, 6, 12] rather than
wall-clock dates, since a family device's clock isn't trustworthy).

All of it is pure: no scene tree, no clock or RNG read directly,
every effectful input (session number, attempt outcome) is a
parameter. 65 headless tests across both layers, including the
word-omission-doesn't-cascade regression and the full
decouverte -> acquise -> a_reviser -> acquise path.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
Denis Defolie
2026-10-11 17:03:14 +02:00
parent d057c8ee77
commit 2fe455f5d1
36 changed files with 1111 additions and 28 deletions
Download Patch File Download Diff File Expand all files Collapse all files
tests/data/test_semantic_checks.gd
+6 -8
View File
@@ -3,24 +3,24 @@ extends GutTest
func test_multiple_choice_rejects_out_of_bounds_correct_answer() -> void:
var data := { "answers": ["a", "b"], "correct_answer": 5 }
var data := {"answers": ["a", "b"], "correct_answer": 5}
var errors := SemanticChecks.check_multiple_choice(data, "test")
assert_eq(errors.size(), 1)
func test_multiple_choice_accepts_valid_index() -> void:
var data := { "answers": ["a", "b"], "correct_answer": 1 }
var data := {"answers": ["a", "b"], "correct_answer": 1}
assert_eq(SemanticChecks.check_multiple_choice(data, "test"), [])
func test_sentence_correction_requires_at_least_one_error_token() -> void:
var data := { "tokens": [{ "text": "Les", "correct": true }] }
var data := {"tokens": [{"text": "Les", "correct": true}]}
var errors := SemanticChecks.check_sentence_correction(data, "test")
assert_eq(errors.size(), 1)
func test_sentence_correction_requires_expected_on_error_tokens() -> void:
var data := { "tokens": [{ "text": "petit", "correct": false }] }
var data := {"tokens": [{"text": "petit", "correct": false}]}
var errors := SemanticChecks.check_sentence_correction(data, "test")
assert_eq(errors.size(), 1)
assert_string_contains(errors[0], "expected")
@@ -29,7 +29,7 @@ func test_sentence_correction_requires_expected_on_error_tokens() -> void:
func test_dictation_word_count_must_match_target_text() -> void:
var data := {
"target_text": "Les petits chats dorment.",
"words": [{ "text": "Les" }, { "text": "petits" }],
"words": [{"text": "Les"}, {"text": "petits"}],
}
var errors := SemanticChecks.check_dictation(data, "test")
assert_eq(errors.size(), 1)
@@ -38,8 +38,6 @@ func test_dictation_word_count_must_match_target_text() -> void:
func test_dictation_accepts_matching_word_count() -> void:
var data := {
"target_text": "Les petits chats dorment.",
"words": [
{ "text": "Les" }, { "text": "petits" }, { "text": "chats" }, { "text": "dorment." }
],
"words": [{"text": "Les"}, {"text": "petits"}, {"text": "chats"}, {"text": "dorment."}],
}
assert_eq(SemanticChecks.check_dictation(data, "test"), [])