@fraza/module-ai 0.0.0-stage → 0.4.23

package/CHANGELOG.md

@@ -0,0 +1,158 @@
+# Journal des versions
+
+Historique des versions publiées de `@fraza/module-ai`.
+
+Ce fichier est généré par `fraza-module changelog` à partir des messages de commit. Ne pas le modifier à la main.
+
+## 0.4.23 (2026-11-08)
+
+### Ajouts
+
+- **ai** : add demo history seed for fraza-db (83306d4)
+
+## 0.4.22 (2026-11-07)
+
+Maintenance interne, aucun changement de comportement.
+
+## 0.4.21 (2026-11-07)
+
+### Ajouts
+
+- **ui** : add animated working status to ai studio (92e1667)
+
+## 0.4.20 (2026-11-07)
+
+Maintenance interne, aucun changement de comportement.
+
+## 0.4.19 (2026-11-07)
+
+Maintenance interne, aucun changement de comportement.
+
+## 0.4.18 (2026-11-07)
+
+Maintenance interne, aucun changement de comportement.
+
+## 0.4.17 (2026-11-07)
+
+Maintenance interne, aucun changement de comportement.
+
+## 0.4.16 (2026-11-07)
+
+Maintenance interne, aucun changement de comportement.
+
+## 0.4.15 (2026-11-07)
+
+### Ajouts
+
+- **admin** : add start mode panel to studio composer (2cbd1f6)
+
+## 0.4.14 (2026-11-07)
+
+### Refontes
+
+- **ai** : extract studio composer into its own component (4e74444)
+
+## 0.4.13 (2026-11-07)
+
+Maintenance interne, aucun changement de comportement.
+
+## 0.4.12 (2026-11-07)
+
+### Refontes
+
+- **admin** : move studio bar and window layout into shared component (ea95fdf)
+
+## 0.4.11 (2026-11-07)
+
+### Ajouts
+
+- **studio** : group hints into menus and animate the compose layout (662ef1c)
+
+## 0.4.10 (2026-11-07)
+
+### Ajouts
+
+- **ai** : add studio compose mode and plan review (46ded16)
+
+## 0.4.9 (2026-11-07)
+
+### Ajouts
+
+- **admin** : add icon-only and size options to ai actions trigger (eaa0877)
+
+### Refontes
+
+- **admin** : rename ai sparkles icon to sparkles icon (3ccf3f6)
+
+## 0.4.8 (2026-11-07)
+
+### Refontes
+
+- **ui** : replace ChatSparkIcon with AiSparklesIcon (1dd3dee)
+
+## 0.4.7 (2026-11-07)
+
+### Refontes
+
+- **ui** : rename ai apply wording to "appliquer" and "laisser tel quel" (471087a)
+
+## 0.4.6 (2026-11-07)
+
+### Ajouts
+
+- **ai** : add studio mode for comparing and applying prompt versions (d2b427d)
+
+## 0.4.5 (2026-11-07)
+
+### Ajouts
+
+- **admin** : enlarge and make resizable long text inputs in ai form (858b23c)
+
+## 0.4.4 (2026-11-07)
+
+### Ajouts
+
+- **ai** : add configurable menu label with action descriptions (526a6f7)
+
+## 0.4.3 (2026-11-07)
+
+### Refontes
+
+- **admin** : use ai trigger component for single action button (b79c212)
+
+## 0.4.2 (2026-11-07)
+
+### Ajouts
+
+- **ai** : redesign ai modal with preview, steps and eyebrow (ec4ca14)
+
+## 0.4.1 (2026-11-07)
+
+### Refontes
+
+- **ai** : use core ai design system in admin actions (44cf966)
+
+## 0.4.0 (2026-11-07)
+
+### Action requise
+
+- `npx fraza-db migrate`
+- `npx fraza-doctor --fix`
+
+### Variables d'environnement
+
+- Ajoutée : `FRAZA_MODULE_AI`
+- Ajoutée : `FRAZA_MODULE_AI_API_KEY`
+- Ajoutée : `FRAZA_MODULE_AI_BASE_URL`
+- Ajoutée : `FRAZA_MODULE_AI_MODEL`
+- Ajoutée : `FRAZA_MODULE_AI_PROVIDER`
+- Ajoutée : `FRAZA_MODULE_AI_RETENTION_DAYS`
+- Ajoutée : `FRAZA_MODULE_AI_TIMEOUT_MS`
+
+### Ajouts
+
+- add ai module with providers, admin pages and prompts (6c49c51)
+
+### Autres
+
+- Initial commit (6240154)

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Fraza
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,73 @@
-# Temporary Holding Version
+<img src="https://docs.fraza.ca/readme/module-ai.png" alt="Fraza : l'IA dans l'admin et dans le code" width="100%">
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Le module ajoute l'intelligence artificielle à un projet Fraza. Le code du projet et les autres modules l'appellent toujours lui, jamais le fournisseur : changer de fournisseur ou de modèle se fait dans la configuration, sans toucher au code.
+
+```sh
+npm i @fraza/module-ai
+```
+
+[Documentation](https://docs.fraza.ca/docs/modules/ai) · [Installation](https://docs.fraza.ca/docs/modules/ai/installation) · [Prompts](https://docs.fraza.ca/docs/modules/ai/prompts)
+
+> [!WARNING]
+> Fraza est en version `0.x`. Une nouvelle version mineure peut contenir un changement cassant.
+
+## Points forts
+
+- **Le fournisseur au choix.** Anthropic, OpenAI, Google, Mistral, un service compatible avec l'API d'OpenAI, ou Ollama sur son propre serveur.
+- **Des réponses structurées et vérifiées.** Chaque prompt décrit la forme de sa réponse. Le module la transmet au fournisseur, vérifie ce qu'il reçoit et relance une fois si la réponse ne correspond pas.
+- **Des boutons dans l'admin.** Posts et Médias offrent les leurs : rédiger un article, proposer un nom de fichier et un texte alternatif. Rien n'est enregistré avant la relecture.
+- **Des prompts ajustables.** Le fichier `ai.js` du projet change le ton ou le texte d'un prompt de module, ou déclare ses propres prompts.
+- **Les jetons comptés.** La page IA de l'admin montre la configuration, l'historique des appels et les jetons consommés, sans jamais garder le texte envoyé ni la réponse.
+
+## Prérequis
+
+- Un projet créé par `npx @fraza/start`, avec `@fraza/core` installé.
+- Un compte chez le fournisseur choisi et sa clé d'API, ou un serveur Ollama.
+
+## Installation
+
+```bash
+npm i @fraza/module-ai
+```
+
+Ajoutez les variables à `.env.local`, et aux variables de la plateforme en production :
+
+```dotenv
+FRAZA_MODULE_AI=true
+FRAZA_MODULE_AI_PROVIDER=anthropic
+FRAZA_MODULE_AI_MODEL=claude-sonnet-5-5
+FRAZA_MODULE_AI_API_KEY=
+```
+
+Régénérez ensuite les manifestes, puis créez les tables :
+
+```bash
+npx fraza-modules sync
+npx fraza-db init
+```
+
+`fraza-db init` crée `fraza_ai_run`, l'historique des appels, et `fraza_ai_result`, les propositions de l'IA en attente à côté d'un contenu. Sur un projet où le module est déjà installé, `npx fraza-db migrate` applique ses migrations.
+
+La tâche planifiée `ai-retention` tourne chaque nuit : elle retire de l'historique les appels de plus de 90 jours. Comme toute tâche du core, elle demande un serveur qui reste allumé.
+
+Le détail est dans [Installation](https://docs.fraza.ca/docs/modules/ai/installation).
+
+## Documentation
+
+| Page | Contenu |
+|---|---|
+| [Installation](https://docs.fraza.ca/docs/modules/ai/installation) | Installer le module, créer les tables, tester la configuration. |
+| [Configuration](https://docs.fraza.ca/docs/modules/ai/configuration) | Fournisseurs, variables d'environnement, permissions. |
+| [Prompts](https://docs.fraza.ca/docs/modules/ai/prompts) | Déclarer un prompt, décrire sa réponse, ajuster ceux des modules dans `ai.js`. |
+| [Boutons](https://docs.fraza.ca/docs/modules/ai/boutons) | Les boutons d'IA de l'admin et leur fonctionnement. |
+| [Tâches](https://docs.fraza.ca/docs/modules/ai/taches) | Lancer un prompt sur un événement ou à heure fixe. |
+| [Modèle de données](https://docs.fraza.ca/docs/modules/ai/modele-de-donnees) | Tables `fraza_ai_run` et `fraza_ai_result`. |
+| [API](https://docs.fraza.ca/docs/modules/ai/api) | Fonctions serveur, routes et intégration `ai` pour les autres modules. |
+
+La documentation est aussi livrée avec le core, lisible hors ligne depuis un projet : `node_modules/@fraza/core/dist/docs/06-modules/ai/`.
+
+## Licence
+
+MIT. Copyright (c) 2026 Fraza. Voir [LICENSE](./LICENSE). Les dépendances tierces sont listées dans [THIRD-PARTY-NOTICES.md](./THIRD-PARTY-NOTICES.md).
+
+Ce paquet fait partie de Fraza Libre.

package/THIRD-PARTY-NOTICES.md

@@ -0,0 +1,11 @@
+# Avis relatifs aux composants tiers
+
+Ce document inventorie les dépendances de production de `@fraza/module-ai` et leurs licences.
+
+Il est généré par `fraza-module notices` à partir de l'arbre réellement installé. Ne pas le modifier à la main.
+
+`@fraza/module-ai` ne bundle aucune dépendance : les dépendances ci-dessous sont installées séparément par le gestionnaire de paquets, depuis leurs sources respectives. Elles ne sont ni distribuées ni couvertes par la [licence MIT](./LICENSE) de ce paquet. Cet inventaire sert à vérifier qu'aucune licence copyleft ne contamine l'application qui installe le paquet, et à fournir la liste nécessaire aux obligations d'attribution du projet consommateur, dont le build, lui, bundle ces dépendances.
+
+## Résumé
+
+Aucune. `@fraza/module-ai` n'a pas de dépendance de production : tout ce dont il a besoin à l'exécution est déclaré en `peerDependencies` et fourni par le projet consommateur. Il n'y a donc aucune dépendance à inventorier ici.