Signaler un problème à Fraza
Rapporter à l'équipe Fraza un bug, un manque ou une idée qui touche le core ou un module officiel, et une faille de sécurité par la voie privée.
Un bug du core, une page de doc fausse ou une API qui manque se corrige une fois chez Fraza, et tous les projets en profitent. Cette page dit quoi rapporter, où, et quoi joindre pour que le rapport serve.
Ce qui se rapporte à Fraza
Le rapport vaut la peine quand la cause est dans @fraza/core ou dans un module officiel (@fraza/module-*, @fraza-pro/module-*), pas dans le code du projet :
| Cas | Exemple |
|---|---|
| Bug | Une fonction du core renvoie un résultat faux, une page de l'admin plante, une commande fraza-* échoue sur un projet sain. |
| Documentation | Une page décrit un comportement que le code n'a pas, un exemple ne tourne pas, une option n'est documentée nulle part. |
| Manque | Le core n'expose pas ce qu'il faut, et le projet doit copier ou contourner du code interne pour s'en sortir. |
| Conception | Une API pousse à une erreur, une convention se contredit d'une page à l'autre, une mise à jour casse un projet sans prévenir. |
| Idée | Un besoin que plusieurs projets auraient, et qui a sa place dans le core ou un module. |
Ne se rapportent pas : un bug du code du projet, une variable mal remplie dans .env.local, un problème propre à Next.js, à PostgreSQL ou à un hébergeur, ou une préférence de style. En cas de doute, npx fraza-doctor repère déjà les causes les plus courantes du côté du projet.
Où l'envoyer
Le formulaire de la feuille de route reçoit tout, sauf les failles de sécurité. Chaque lien ouvre le bon onglet :
| Type | Lien |
|---|---|
| Bug | https://fraza.ca/feuille-de-route/nouveau?type=bug |
| Idée ou manque | https://fraza.ca/feuille-de-route/nouveau?type=idea |
| Question | https://fraza.ca/feuille-de-route/nouveau?type=question |
L'équipe lit chaque message. Un bug confirmé ou une idée retenue devient une fiche de la feuille de route. Avec un courriel, vous êtes avisé quand la fiche avance.
Une faille de sécurité
Elle ne passe pas par le formulaire. Écrire à [email protected], avec la description, les étapes pour la reproduire, le paquet et sa version touchés, et l'impact. Le correctif se prépare en privé avant toute divulgation. La politique complète est dans SECURITY.md.
Quoi joindre
Un bug se corrige vite quand il se reproduit. Le rapport gagne à contenir :
- le paquet et sa version exacte, que donne
npm ls @fraza/core(ou le nom du module) ; - ce qui était attendu, et ce qui s'est passé ;
- les étapes pour le reproduire sur un projet neuf, si possible ;
- le message d'erreur complet, et une capture d'écran pour un problème d'interface.
Retirer du rapport toute valeur secrète : clé, mot de passe, contenu de .env.local, jeton du .npmrc.
Un agent IA qui travaille sur le projet
Le bloc que @fraza/start pose dans l'AGENTS.md du projet donne la même règle aux agents IA. npx fraza-update le garde à jour, voir fraza-doctor. Un agent qui tombe sur un problème de Fraza pendant son travail peut proposer un rapport, déjà rédigé, avec le lien du bon type. Il ne l'envoie jamais lui-même : c'est le développeur qui décide.
Il ne le propose que si la cause est bien dans Fraza, selon les cas plus haut. Un travail qui s'est bien passé ne mérite aucun rapport.