Ce plan découpe knitproof en jalons, puis en tranches verticales : chaque tranche part d’un test d’acceptation et livre un comportement utilisable. L’architecture est décrite dans architecture.md.
- Architecture, plan et protocole d’évaluation (ce document et ses voisins).
- Décisions d’architecture (ADR).
- Conventions Python et d’architecture, vérifiées automatiquement.
- Flow de branches :
main(production),develop(sandbox), branches de travail depuisdevelop, une pull request à chaque étape. - Intégration continue : tests, ruff, typage (mypy strict) et contrats de couches sur chaque pull request ;
mainetdevelopprotégées. Le déploiement continu (developvers la sandbox,mainvers la production) arrive en M3, avec l’image Docker.
| Tranche | Contenu | Dépend de |
|---|---|---|
| 0. Outillage | Pydantic, PyYAML (types-PyYAML en développement) ; plugin pydantic.mypy activé (ADR 0001), avec [tool.pydantic-mypy] ; examples/bonnet-erreur-rang-33.yaml et examples/bonnet-3-ans.yaml, formats provisoires ; deux tests d’acceptation qui lancent la commande knitproof, en xfail(raises=FileNotFoundError, strict=True) ; xfail_strict = true |
— |
| 1. Vérifier | Op, Repeat, Round, Pattern, simulate, verify ; format YAML figé, examples/synthetiques/bonnets/bonnet-synthetique.yaml ; exemple « erreur au rang 33 » et cas « répétition qui ne tombe pas juste » |
aucune question métier |
| 2. Montage, valeurs saisies | CLA-65 : Length (cm et pouces), SwatchMeasurement (demi-mailles admises), StitchMultiple, stitches_for_width, cast_on à un seul point (multiple et reste), contrôle d’un nombre proposé ; tests de propriétés (multiple respecté, monotonie, aucun float). CLA-104 (livré) : NeedleSize (système explicite, mm saisi), Needle, matière, méthode, check_needles (swatch_needle_mismatch) ; CLA-103 (livré) : Transition, build_transition (rang d’ajustement réparti selon l’ADR 0019 et vérifié par le moteur), refus typé au-delà d’un rang, ADR 0025 |
question 4 |
| 3. Échantillon et résolution (livrée, CLA-66) | Swatch avant et après blocage, table de résolution par grandeur, constat « échantillon non bloqué » (96 m contre 88 m), constat gauge_differs_from_label (échantillon comparé à la jauge de l’étiquette), questions en attente |
questions 2, 3, 7, 9, 14 |
| 4. Bibliothèque | Chargeur YAML typé par registre (CLA-67), StitchPattern, ReferenceMeasurement, table de correspondance des aiguilles ; chaque valeur sourcée et validée ; bibliothèque versionnée |
questions 1, 10, 11 |
| 5. Hauteur et calotte (livrée, CLA-68) | SwatchMeasurement avec jauge en rangs, rounds_for_height et knitted_rows (arrondi tracé), crown_plan en rond et à plat, needle_change dans la calotte, beanie_plan (bord, corps, calotte, verify), plan_beanie (hauteur saisie ou Knit Picks, questions en attente), exemple 3 ans ; bonnet à plat avec lisières, ADR 0028 |
questions 5, 6, 12 |
| 6. Rendu et CLI (livrée, CLA-69) | Report unique (ADR 0029), calc_beanie, knitproof calc et knitproof verify, fichiers de sortie de référence, test qui empêche le README de dériver |
— |
Critère de fin
-
uv run knitproof verify examples/bonnet-erreur-rang-33.yamlsort en code 1 avec un constatcount_mismatchau rang 33 (attendu 90, annoncé 89). -
uv run knitproof calc examples/bonnet-3-ans.yaml(aisance et hauteur saisies) donne la sortie de référence : 88 m, alerte à 96 m, rejet de 120 m, plan complet du bonnet. -
uv run pytest,uv run ruff check .,uv run lint-importsetuv run mypypassent.
- Protocole d’évaluation (
evaluation.md) figé avant tout prompt. Fait (CLA-126). - Adaptateur
llmsur pydanticAI (ADR 0005), dont au moins un modèle ouvert ou souverain. Fait (CLA-127). Accès souverain local et autres fournisseurs : CLA-62. - Ligne de base « LLM seul » sur les demandes de bonnet. Faite (CLA-188, ADR 0035) : commande
knitproof eval, prompt figé, 5 casdevet 15 castest; mesuresdevfaites (CLA-188, CLA-199,evals/results/), réessai sur erreur passagère (CLA-197, ADR 0036), reprise d’une mesure interrompue par journal de passages (CLA-203, ADR 0037). - Étiquette en photo →
YarnLabel(photos personnelles, sans EXIF). - Demande en texte →
BeanieSpecification. - Source Ravelry : recherche d’un fil, fiche pré-remplie, divergence avec l’étiquette signalée.
- Plusieurs modèles, plusieurs passages ; désaccord ⇒ « À VÉRIFIER », avec mesure de ce que ce signal attrape.
- Cas d’injection de prompt.
Critère de fin : uv run knitproof eval --split test --models a,b,c produit le tableau du README ; la CI vérifie le manifeste et rejoue les réponses enregistrées.
- API JSON (FastAPI, OpenAPI) au-dessus de
app. - Interface accessible en React et React Aria Components (ADR 0006), bilingue français et anglais, pour les tricoteuses (design).
- Docker ; déploiement continu de
developsur la sandbox et demainen production ; la CI ajoute le rejeu de l’évaluation, sans appel payant (le manifeste est vérifié dès M2). - Audit RGAA publié ; axe-core en CI.
Critère de fin : URL publique ; docker run démarre l’API ; CI verte ; audit RGAA sans non-conformité bloquante sur le parcours de calcul.
Lecture de patrons texte et PDF libres de droits, bibliothèque de points complète et RAG, reconnaissance des points par photo, génération de patrons et constructions multiples, raglan, gradation multi-tailles.
Ces questions ne sont pas tranchées par le code : chacune bloque une tranche jusqu’à sa réponse.
| # | Question | Bloque |
|---|---|---|
| 1 | — | |
| 2 | — | |
| 3 | — | |
| 4 | — | |
| 5 | k2tog partout sous 24 m, fermeture déclarée ; profondeur calculée, rangs de la calotte × 10 / rangs pour 10 cm, jauge après blocage (décision d’Isabelle, modifiable, sans source ; Oslo en comparaison) (ADR 0019). |
— |
| 6 | — | |
| 7 | — | |
| 8 | — | |
| 9 | — | |
| 10 | Decision ; la question en attente propose d’abord de mesurer la tête, et la valeur « À VÉRIFIER » reste le choix à défaut ; l’OMS fait foi, une seule source par âge ; au-delà, tour de tête demandé ; une mesure hors plage donne un signal à vérifier, pas un refus (ADR 0018). Complété le 05/11/2026 par Isabelle : grille de tailles nommées jusqu’à l’adulte (ADR 0026). Complété le 09/11/2026 par Isabelle : le tour de tête par âge vient des patrons et, dès 15 ans, du Craft Yarn Council, en plage sans valeur proposée (ADR 0027). |
— |
| 11 | — | |
| 12 | — | |
| 13 | — | |
| 14 | — |
- Périmètre : rien d’autre que le bonnet avant la fin de M1 ; M2 limité à l’étiquette, à la demande et à Ravelry.
- Exactitude métier : aucune valeur de bibliothèque sans source ni validation.
- Questions bloquantes : la tranche « vérifier » avance sans elles.
- Fuite d’évaluation : le jeu
testne sert jamais à mettre au point les prompts. - Droits et données : pas de patron du commerce dans le dépôt ; photos sans EXIF ; patrons Ravelry en usage privé ; patrons réels (Oslo Hue, DROPS) transcrits seulement dans
local-patterns/, ignoré par git, pour des essais privés, vérifiables à la demande parKNITPROOF_PATTERNS(README, « Vérifier un patron YAML ») : la CI n’en dépend pas, et un échec dû à une opération hors périmètre ne prouve pas une erreur de calcul. - Sur-modélisation : chaque modèle naît d’un test qui échoue.