chore: versioning initial du systeme Context Continuity

Code du systeme de memoire multi-LLM sur Trilium : - trilium_api.py : wrapper trilium-py (notes, labels, relations) - mcp_server.py : serveur MCP Starlette (19 tools, OAuth + Bearer) - api_context.py : API REST FastAPI - trilium_context.py : workflow CLI - watchdog.sh, start_*.sh : supervision et demarrage - skills, docs et ontologie associes Secrets (.env, oauth_state.json) exclus via .gitignore.
2026-06-29 11:02:22 +02:00
commit 01629780f4
26 changed files with 5259 additions and 0 deletions
@@ -0,0 +1,469 @@
+# SKILL — Sliding Design System (Pernod Ricard)
+
+Ce skill décrit le **design system « PR Editorial »** et le format de données
+que consomme le moteur de rendu `render_engine_v2.py` pour produire des
+présentations PowerPoint au format Pernod Ricard.
+
+**Périmètre de ce skill : design et production uniquement.** Il ne traite pas
+de la structuration narrative, de la rédaction ou de la rhétorique. Il répond
+à une seule question : *comment produire un fichier YAML valide qui, passé au
+moteur, génère un PPTX conforme à la charte Pernod Ricard.*
+
+---
+
+## 1. Principe de fonctionnement
+
+Le moteur prend en entrée un fichier **YAML** décrivant une liste de slides.
+Chaque slide déclare un `layout` (parmi 21) et les champs de contenu de ce
+layout. Le moteur applique automatiquement la charte (couleurs, polices,
+grille, centrage vertical). Tu n'as jamais à spécifier de couleur, de police
+ou de position en mode standard : tu fournis le contenu, le moteur compose.
+
+Commande de rendu :
+```bash
+python3 render_engine_v2.py presentation.yaml sortie.pptx \
+  --theme theme_v2.yaml --components components_v2.yaml --layouts layouts_v2.yaml
+```
+
+Structure générale du YAML :
+```yaml
+slides:
+  - layout: cover_split
+    titre: "..."
+  - layout: kpi_grid
+    titre: "..."
+    items: [...]
+```
+
+---
+
+## 2. La charte (appliquée automatiquement)
+
+Tu n'écris jamais ces valeurs en mode standard ; elles sont là pour information.
+
+**Couleurs**
+| Token | Hex | Usage |
+|---|---|---|
+| navy | `#061033` | dominant — fonds sombres, titres |
+| navy_light | `#10204D` | cercles décoratifs sur fond sombre |
+| coral | `#F4795B` | accent UNIQUE — chiffres, badges, lignes |
+| glacier | `#8FA9D0` | sous-titres sur fond sombre, 3e couleur |
+| slate | `#46505A` | 2e couleur de cycle |
+| card | `#F4F1EC` | fond des cartes (gris chaud) |
+| card_alt | `#EAF0F8` | variante froide |
+| body | `#2B3440` | texte courant sur fond clair |
+| muted | `#8A93A0` | légendes, sources |
+
+**Polices** : Cambria (titres, chiffres) / Calibri (corps).
+**Format slide** : 33,87 × 19,05 cm (16:9).
+**Règle d'accent** : le corail est rare. Un seul élément corail dominant par slide ; le navy domine.
+**Rythme sandwich** : ouverture, transitions et clôture sur fond sombre (navy) ; contenu sur fond clair.
+
+---
+
+## 3. Les 21 layouts standards
+
+Chaque layout liste ses champs **requis** (obligatoires) et **optionnels**.
+`titre` doit être une formulation affirmative (le message du slide), pas un label.
+
+### Ouverture / Clôture / Structure
+
+**cover_split** — couverture (fond sombre)
+Requis : `titre` · Optionnel : `sous_titre`
+```yaml
+- layout: cover_split
+  titre: "Titre de la présentation"
+  sous_titre: "Tagline en une phrase"
+```
+
+**section_divider** — transition de section (fond sombre, numéro auto)
+Requis : `titre`
+```yaml
+- layout: section_divider
+  titre: "Nom de la section"
+```
+
+**end_slide** — clôture (fond sombre)
+Requis : `message`
+```yaml
+- layout: end_slide
+  message: "Phrase de conclusion"
+```
+
+### Synthèse / Message
+
+**executive_summary** — synthèse situation/complication/résolution
+Requis : `titre, situation, complication, resolution`
+```yaml
+- layout: executive_summary
+  titre: "Le So What en une phrase affirmative"
+  situation: "État des lieux factuel"
+  complication: "Le problème ou la tension"
+  resolution: "La réponse proposée"
+```
+
+**key_message** — citation/message fort (fond sombre)
+Requis : `message` · Optionnel : `detail`
+```yaml
+- layout: key_message
+  message: "Le message clé en une phrase forte."
+  detail: "Sous-texte optionnel."
+```
+
+### Données
+
+**big_stat** — un chiffre héro plein écran
+Requis : `titre, valeur` · Optionnel : `description, source`
+```yaml
+- layout: big_stat
+  titre: "Titre affirmatif"
+  valeur: "78%"
+  description: "ce que le chiffre signifie"
+  source: "Référence — 2026"
+```
+
+**kpi_grid** — 2 à 6 cartes KPI
+Requis : `titre, items`
+```yaml
+- layout: kpi_grid
+  titre: "Titre affirmatif"
+  items:
+    - label: "Indicateur 1"
+      valeur: "+13%"
+      description: "Source ou contexte"
+    - label: "Indicateur 2"
+      valeur: "85%"
+      description: "Source ou contexte"
+```
+Note : `valeur` est une chaîne. Les valeurs courtes (≤6 car.) s'affichent en
+très grand, les valeurs longues sont réduites automatiquement.
+
+### Comparaison
+
+**two_cols_text** — deux colonnes en cartes (gauche navy, droite corail)
+Requis : `titre, left, right`
+```yaml
+- layout: two_cols_text
+  titre: "Titre affirmatif"
+  left:
+    titre: "Titre colonne gauche"
+    bullets:
+      - texte: "Premier point"
+      - texte: "Deuxième point"
+  right:
+    titre: "Titre colonne droite"
+    bullets:
+      - texte: "Premier point"
+```
+
+**comparison_table** — tableau comparatif multi-critères
+Requis : `titre, headers, rows` (max ~5 colonnes, 8 lignes)
+```yaml
+- layout: comparison_table
+  titre: "Titre affirmatif"
+  headers: ["Critère", "Option A", "Option B"]
+  rows:
+    - label: "Premier critère"
+      values: ["Valeur A", "Valeur B"]
+    - label: "Deuxième critère"
+      values: ["Valeur A", "Valeur B"]
+```
+
+**from_to_pairs** — transformation avant/après
+Requis : `titre, pairs` · Optionnel : `label_from, label_to` (max 5 paires)
+```yaml
+- layout: from_to_pairs
+  titre: "Titre affirmatif"
+  label_from: "SITUATION ACTUELLE"
+  label_to: "SITUATION CIBLE"
+  pairs:
+    - from: "État de départ"
+      to: "État cible"
+    - from: "Autre point"
+      to: "Autre cible"
+```
+
+### Concept / Texte
+
+**circular_diagram** — 3 à 6 cercles + légende
+Requis : `titre, segments`
+```yaml
+- layout: circular_diagram
+  titre: "Titre affirmatif"
+  segments:
+    - label: "Concept 1"
+      description: "Description courte"
+    - label: "Concept 2"
+      description: "Description courte"
+    - label: "Concept 3"
+      description: "Description courte"
+```
+
+**default_bullets** — liste de points (max 5)
+Requis : `titre, bullets`
+Le format « Mot-clé : explication » met le mot-clé en gras navy.
+```yaml
+- layout: default_bullets
+  titre: "Titre affirmatif"
+  bullets:
+    - texte: "Mot-clé : explication du point"
+      niveau: 1
+    - texte: "Autre mot-clé : explication"
+      niveau: 1
+```
+
+### Process / Planning
+
+**numbered_steps** — étapes en cartes avec badge numéroté (2 à 5)
+Requis : `titre, steps`
+```yaml
+- layout: numbered_steps
+  titre: "Titre affirmatif"
+  steps:
+    - numero: 1
+      titre: "Première étape"
+      description: "Ce que ça implique"
+    - numero: 2
+      titre: "Deuxième étape"
+      description: "Ce que ça implique"
+```
+
+**process_arrow** — flux horizontal de 3 à 6 étapes (sans dates)
+Requis : `titre, steps`
+```yaml
+- layout: process_arrow
+  titre: "Titre affirmatif"
+  steps:
+    - titre: "Étape 1"
+      description: "Ce qui se passe"
+    - titre: "Étape 2"
+      description: "Ce qui se passe"
+    - titre: "Étape 3"
+      description: "Ce qui se passe"
+```
+
+**phases_timeline** — phases avec périodes
+Requis : `titre, phases`
+```yaml
+- layout: phases_timeline
+  titre: "Titre affirmatif"
+  phases:
+    - label: "Mois 1-2"
+      periode: "Ce qui se passe"
+    - label: "Mois 3-8"
+      periode: "Ce qui se passe"
+```
+
+**gantt_timeline** — Gantt par workstreams
+Requis : `titre, periods, workstreams` (max 3 workstreams, 4 tâches chacun)
+`start`/`end` = index dans `periods` (0-based).
+```yaml
+- layout: gantt_timeline
+  titre: "Titre affirmatif"
+  periods: ["Juin", "Juil", "Août", "Sept"]
+  workstreams:
+    - label: "Workstream 1"
+      tasks:
+        - label: "Tâche A"
+          start: 0
+          end: 2
+    - label: "Workstream 2"
+      tasks:
+        - label: "Tâche B"
+          start: 1
+          end: 3
+```
+
+**yearly_timeline** — frise chronologique
+Requis : `titre, milestones` (max 6, `actif: true` met le jalon en corail)
+```yaml
+- layout: yearly_timeline
+  titre: "Titre affirmatif"
+  milestones:
+    - annee: "2024"
+      label: "Premier jalon"
+    - annee: "2025"
+      label: "Deuxième jalon"
+    - annee: "2026"
+      label: "Jalon courant"
+      actif: true
+```
+
+### Gouvernance / Organisation / Décision
+
+**raci_table** — matrice RACI
+Requis : `titre, roles, tasks` (max 4 rôles, 8 tâches)
+Lettres : R (Responsable, corail), A (Autorité, navy), C (Consulté, slate), I (Informé, muted).
+```yaml
+- layout: raci_table
+  titre: "Titre affirmatif"
+  roles: ["Rôle 1", "Rôle 2", "Rôle 3"]
+  tasks:
+    - label: "Première activité"
+      raci: ["A", "R", "C"]
+    - label: "Deuxième activité"
+      raci: ["A", "I", "R"]
+```
+
+**org_chart** — organigramme (max 3 niveaux)
+Requis : `titre, root`
+Les `children` peuvent être des objets `{label, children}` OU de simples
+chaînes. Max 4 enfants directs, 3 petits-enfants par enfant (au-delà, ça serre).
+```yaml
+- layout: org_chart
+  titre: "Titre affirmatif"
+  root:
+    label: "Responsable racine"
+    children:
+      - label: "Manager 1"
+        children:
+          - "Équipe A"
+          - "Équipe B"
+      - label: "Manager 2"
+        children:
+          - "Équipe C"
+```
+
+**matrix_2x2** — matrice effort/impact
+Requis : `titre, items` · Optionnel : `axis_x, axis_y, quadrants` (max 8 items)
+`x` et `y` vont de 0 à 100.
+```yaml
+- layout: matrix_2x2
+  titre: "Titre affirmatif"
+  axis_x:
+    label: "Effort"
+    low: "Faible"
+    high: "Élevé"
+  axis_y:
+    label: "Impact"
+    low: "Faible"
+    high: "Élevé"
+  quadrants:
+    top_left: "Gains rapides"
+    top_right: "Projets stratégiques"
+    bottom_left: "Déprioritiser"
+    bottom_right: "À planifier"
+  items:
+    - label: "Initiative A"
+      x: 30
+      y: 80
+    - label: "Initiative B"
+      x: 70
+      y: 75
+```
+
+**recommendation_card** — carte de recommandation (sidebar navy)
+Requis : `titre, headline, bullets` · Optionnel : `numero, cta`
+```yaml
+- layout: recommendation_card
+  numero: 1
+  titre: "Nom court de la recommandation"
+  headline: "TROIS DÉCISIONS À PRENDRE MAINTENANT"
+  cta: "Décider en réunion du 30 juin"
+  bullets:
+    - texte: "Première décision précise"
+    - texte: "Deuxième décision précise"
+```
+
+---
+
+## 4. Le flux libre (freeform) — composition sur mesure
+
+Pour les slides qui ne rentrent dans aucun layout standard, utilise
+`layout: freeform`. La slide est composée de **blocs positionnés sur une
+grille 12 × 12** (colonnes 0-12, lignes 0-12). La charte reste **imposée** :
+les couleurs ne peuvent être que des tokens nommés (jamais de hex).
+
+Règles de la grille :
+- `col` (0-12) = colonne de départ, `row` (0-12) = ligne de départ
+- `w` = largeur en colonnes, `h` = hauteur en lignes
+- Contraintes : `col + w ≤ 12` et `row + h ≤ 12`
+- Maximum 8 blocs par slide
+- `mode: light` (fond blanc) ou `mode: dark` (fond navy)
+- `footer: false` pour masquer le pied de page (affiché par défaut, même sur fond sombre)
+
+Note : `freeform` est géré directement par le moteur de rendu et ne figure pas
+dans `layouts_v2.yaml`. Un validateur basé sur ce fichier peut donc le signaler
+comme « layout inconnu » — c'est sans effet, le rendu fonctionne normalement.
+
+Types de blocs disponibles :
+| type | description | champs spécifiques |
+|---|---|---|
+| `title` / `heading` | titre serif | `size` (déf. 28), `align`, `color` |
+| `text` | texte courant (Calibri) | `size`, `bold`, `italic`, `serif`, `align`, `color` |
+| `stat` | grand chiffre serif corail | `size` (déf. 72), `align`, `color` |
+| `circle` | cercle plein (motif charte) | `color` (diamètre = min(w,h)) |
+| `badge` | cercle numéroté, texte blanc centré | `text`, `color` |
+| `card` | carte arrondie avec ombre | `color` (déf. card) |
+| `rect` | rectangle plein | `color`, `rounded` |
+| `line` | ligne / séparateur | `color`, `weight` (h:0 = horizontale) |
+
+Tokens couleur autorisés : `navy, navy_light, coral, glacier, slate, card,
+white, body, muted`. Aucun hex.
+
+Exemple — slide manifeste (fond sombre, grand chiffre + titre + accent) :
+```yaml
+- layout: freeform
+  mode: dark
+  blocks:
+    - type: stat
+      text: "3"
+      col: 0.5
+      row: 1
+      w: 3
+      h: 4
+      size: 150
+      color: coral
+      align: center
+    - type: title
+      text: "trois convictions structurantes"
+      col: 4
+      row: 1.5
+      w: 7.5
+      h: 3
+      size: 30
+      color: white
+    - type: line
+      col: 4
+      row: 4.5
+      w: 7
+      h: 0
+      color: coral
+      weight: 2
+    - type: text
+      text: "Le sous-texte en glacier, italique."
+      col: 4
+      row: 5
+      w: 7.5
+      h: 2
+      size: 18
+      italic: true
+      color: glacier
+```
+
+---
+
+## 5. Règles de production (à respecter pour un YAML valide)
+
+1. **Layouts** : utiliser uniquement les 21 noms listés (+ `freeform`).
+2. **Champs requis** : chaque layout doit avoir tous ses champs requis, non vides.
+3. **Chaînes** : toujours entre guillemets. Échapper les guillemets internes.
+4. **Chiffres de contenu** (`valeur`, `stat`) : toujours des chaînes (`"78%"`).
+5. **Entiers de structure** (`numero`, `niveau`, `start`, `end`, `x`, `y`) : sans guillemets.
+6. **`titre`** : formulation affirmative (le message), jamais un label thématique.
+7. **Pas de syntaxe Markdown** dans les valeurs : pas de `**gras**`, pas de `#`.
+   Le formatage est géré par le moteur, pas par le texte.
+8. **Champ optionnel absent** : l'omettre (ne pas mettre `null`).
+9. **Freeform** : respecter `col+w ≤ 12`, `row+h ≤ 12`, max 8 blocs, tokens charte uniquement.
+10. **Densité** : respecter les maxima par layout (ex. kpi_grid ≤ 6, bullets ≤ 5,
+    org_chart ≤ 4 branches). Au-delà, le rendu se dégrade.
+
+---
+
+## 6. Sortie attendue
+
+Quand on te demande de produire une présentation au format Pernod Ricard,
+tu produis **uniquement le YAML** décrit ci-dessus — rien d'autre. Ce YAML
+est destiné à être passé tel quel à `render_engine_v2.py`. Pas de texte
+d'introduction, pas de commentaire, pas de Markdown autour : le YAML brut,
+directement exploitable.