bibliotheque-assets

# Bibliothèque d'assets Ce skill gère le **stock de fichiers officiels** (logos, mascottes, visuels produit, textures, templates…) : les importer proprement, les retrouver, les rattacher à la bonne marque, et repérer ce qui manque. Il s'appuie sur les outils fichiers/marque de RapidoCMS dont le **contrat live** est décrit dans `reference/outils-marque.md` — comportements non évidents (upload sans id, `remove_asset` sur l'id du lien) qu'il faut respecter à la lettre. ## Étape 0 — Références (obligatoire) Charger `${CLAUDE_PLUGIN_ROOT}/reference/outils-marque.md` (contrat des outils marque & assets, vérifié en direct) et `${CLAUDE_PLUGIN_ROOT}/reference/pieges-outils.md` (pièges communs des tools). ## Convention de nommage (imposée à l'import) Tout asset importé est nommé : **`{marque}-{type}-{variante}-v{N}`** - minuscules, séparateur `-`, suffixe de version `-v1`, `-v2`… - ex. `braindcode-logo-blanc-v2`, `pronoclip-mascotte-face-v1`. **Types canoniques** (les seuls admis) : `logo-principal`, `logo-blanc`, `logo-noir`, `icone`, `mascotte`, `produit`, `texture`, `template`, `photo-equipe`. Cette convention rend les assets **retrouvables et audables par script**. Un nom hors convention est signalé (voir §Audit) et une reprise de nom proposée. > **Divergence connue.** L'ancien skill `gestion-marques` documentait une > convention en prose (`"<Marque> — <type> — <variante>"`, espaces/tirets > longs). Les deux coexistent tant que le parc n'est pas migré : l'audit > ci-dessous liste les noms non conformes pour piloter la reprise. Pour tout > NOUVEL import, appliquer la convention machine ci-dessus. ## Importer un fichier — `upload_file_tool` `upload_file_tool(type=image|video|doc, name="<nom conforme>", file_url=<URL PUBLIQUE>)`. - Le serveur **télécharge le fichier depuis l'URL** : elle doit être **publique et à fetch direct** (S3, CDN…). Un fichier **local** ne marche pas → l'expliquer et proposer : héberger via l'UI CMS (bibliothèque), ou réutiliser une URL déjà hébergée. Ne jamais inventer d'URL. - ⚠️ La réponse **ne contient pas d'id** — voir §Résoudre l'asset_id. ## Inventorier — `list_all_files` `list_all_files(type, search)` → présenter en **tableau** : `nom | type | asset_id` (l'`asset_id` = le champ `id` du fichier). ⚠️ `search` **ne filtre pas de façon fiable** : filtrer **côté client** sur le `nom` (ne pas affirmer « aucun résultat » sur la seule base du paramètre). ## Résoudre l'asset_id (toujours avant un rattachement) `upload_file_tool` ne renvoie pas d'id. Pour obtenir l'`asset_id` réel : `list_all_files(type=…)` → retrouver l'entrée par son `nom` exact → lire son `id`. **Jamais d'id inventé ni deviné.** ## Rattacher à une marque — `add_asset` Séquence obligatoire, dans l'ordre : 1. `get_brand(nom)` → **confirmer le `brand_id`** (le champ `id`, cf. contrat live ; plusieurs marques → demander laquelle, jamais de défaut). 2. `list_all_files` → résoudre l'`asset_id` réel du fichier visé. 3. `add_asset(asset_id=<id fichier biblio>, brand_id=<id marque>)`. ## Détacher d'une marque — `remove_asset` (irréversible) `get_brand(nom)` → dans `assets[]`, repérer l'entrée du fichier → prendre son **`id` de LIEN** (⚠️ **PAS** `asset_id`/l'id du fichier) → `remove_asset(asset_id=<id du lien>)`. **Confirmation explicite** exigée (retrait irréversible du référentiel de la marque ; le fichier reste dans la bibliothèque — il n'existe pas d'outil pour supprimer un fichier). ## Audit de complétude — `scripts/audit_assets.py` Pour « quels visuels officiels me manquent ? » ou avant un lancement de marque. Ne **jamais** calculer l'écart de tête — passer par le script : 1. `get_brand(nom)` → collecter les `file.nom` des `assets[]` de la marque. 2. Exécuter : `python3 "${CLAUDE_PLUGIN_ROOT}/skills/bibliotheque-assets/scripts/audit_assets.py"` avec en entrée (stdin ou fichier JSON) : `{"marque": "<marque>", "assets": ["<nom1>", "<nom2>", …]}`. 3. Restituer la sortie : `presents`, `manquants`, `non_conformes` (avec les raisons), et **`plan_import`** (nom attendu par type manquant) → proposer d'importer les manquants (via `upload_file_tool`) et de renommer les non conformes. Aucune écriture sans accord. ## Garde-fous - Import : **URL publique** obligatoire ; nom **conforme** à la convention. - Rattachement : `get_brand` + `list_all_files` **avant** `add_asset` — jamais d'`asset_id` ni de `brand_id` inventé. - `remove_asset` : id du **LIEN** (pas du fichier) + **confirmation** ; rappeler que le fichier n'est pas supprimé de la bibliothèque. - Complétude : **toujours** via `audit_assets.py`, jamais de calcul de tête. - Multi-marques → demander la marque cible. ## Frontières - Créer/éditer/supprimer une **marque** (identité, couleurs, font) → `gestion-marques`. Ce skill-ci gère les **fichiers/assets** et leur rattachement, pas l'identité de marque. - **Appliquer** la charte à un contenu → `contenu-conforme-marque`.