Integraatori kontrollnimekiri

See leht on MATx-i companion-lehe kõrval ja toetab pikemat PR-plaani repos packages/bkt-core/integration-patches/pr1-bookkeeping.md. Siin on kompaktne „mida vajutada“ ilma põhjendusteta.

Enne alustamist

• ☐ Node ≥ 20 (NodeNext ESM-resolver).
• ☐ Kirjutusõigus projekti andmebaasi (migratsioonid / Drizzle push).
• ☐ Loetud Pipelini ülevaade — et parameetrid oleks ühises keeles.

Sammud

1. Pakett ühendada

Kaks varianti:

# A) git submodule
git submodule add https://github.com/sapsan14/matx-hack.git vendor/matx-hack
cd vendor/matx-hack/packages/bkt-core && npm install && npm run build
# package.json-is:
#   "@matx-hack/bkt-core": "file:./vendor/matx-hack/packages/bkt-core"

# B) tarball
cd packages/bkt-core && npm install && npm run build && npm pack
# tarbija pool:
npm install /path/to/matx-hack-bkt-core-0.1.1.tgz

• ☐ import { recommend, applyAttempt, DEFAULT_BKT } from "@matx-hack/bkt-core" kompileerub.

2. DB migratsioon

Loo seisundi tabel (vt SQL pr1-bookkeeping.md sammus 1).

• ☐ Tabel student_skill_state eksisteerib.
• ☐ Drizzle-skeem uuendatud (shared/schema.ts).

3. Vastuse salvestamise endpointi uuendus

Vastuse salvestamise käsitlejas (createResult või analoog):

• ☐ Pärast db.insert(results) laetakse pKnown tabelist student_skill_state.
• ☐ bktUpdate(prior, isCorrect, DEFAULT_BKT) arvutab posterior.
• ☐ Upsert tabelisse student_skill_state salvestab uue väärtuse ja inkrementib attempts.

4. (Vabatahtlik) ZPD-selektor

Ainult juhul, kui muudame ülesande valikut — PR-1-s seda ei puudutata.

• ☐ Järgmise ülesande endpoint kasutab recommend(state, pool, 1).
• ☐ Tagastatakse ülesanne, mille pSolve on lähemal 0.7-le.

5. Käsitsi kontroll

Pärast paari katset ühe kasutajaga:

SELECT user_id, competency_id, p_known, attempts
FROM student_skill_state
ORDER BY last_updated DESC LIMIT 10;

• ☐ Värske kasutaja alustab p_known = 0.2.
• ☐ Üks õige vastus: 0.2 → ~0.40.
• ☐ Kaks õiget järjest: ~0.40 → ~0.70.
• ☐ Üks vale pärast seda: ~0.70 → ~0.45.

Tagasipööramine

PR-1 on puhtalt aditiivne: piisab tabeli student_skill_state kustutamisest ja BKT-update-ploki eemaldamisest createResult-ist. UI ja vana getNextRecommendedQuestion jäävad puutumata.

Kiirviited

• Companion — MATx — üldine motivatsioon ja PR-1/PR-2 plaan.
• PR-1 täisplaan GitHubis.
• Paketi README — quickstart ja edge cases.
• EU AI Act — miks deterministlik BKT on compliance’i seisukohast mugav.