@overcrow/mcp 0.0.0 → 0.1.0

package/dist/content/docs/fr/manifest.md

@@ -0,0 +1,392 @@
+# Le manifeste
+
+`manifest.json` dit à PlayerVox OverCrow ce qu’est un widget avant que son
+code ne s’exécute : son identité et sa version, ses noms, les tailles qu’il
+accepte, les permissions qu’il demande et les lignes qu’il ajoute à son menu
+d’options. Vous l’écrivez à la main ; il est empaqueté tel quel.
+
+Le fichier est un seul objet JSON strict. Une marque d’ordre des octets, une
+clé en double, des données après l’objet ou un champ inconnu le font
+refuser : OverCrow n’ignore aucun champ.
+
+## Un exemple complet
+
+<!-- source: templates/counter/manifest.json -->
+```json
+{
+  "schemaVersion": 1,
+  "apiVersion": 1,
+  "id": "{{id}}",
+  "version": "0.1.0",
+  "name": {
+    "en": "{{name}}",
+    "fr": "{{name}}"
+  },
+  "sizing": {
+    "fit": "none",
+    "preferred": { "width": 200, "height": 96 },
+    "min": { "width": 140, "height": 72 },
+    "max": { "width": 640, "height": 640 }
+  }
+}
+```
+
+`overcrow-widget init` écrit ce fichier ; `{{id}}` et `{{name}}` sont les
+valeurs qu’il remplit. Voici un manifeste avec des permissions et un menu :
+
+<!-- source: docs/content/examples/countdown/manifest.json -->
+```json
+{
+  "schemaVersion": 1,
+  "apiVersion": 1,
+  "id": "com.example.countdown",
+  "version": "1.0.0",
+  "name": { "en": "Countdown", "fr": "Compte à rebours" },
+  "sizing": {
+    "fit": "none",
+    "preferred": { "width": 220, "height": 190 },
+    "min": { "width": 180, "height": 160 },
+    "max": { "width": 480, "height": 400 }
+  },
+  "permissions": {
+    "storage": true
+  },
+  "wrapper": {
+    "menu": [
+      {
+        "type": "toggle",
+        "id": "show-rounds",
+        "label": { "en": "Show finished rounds", "fr": "Afficher les tours terminés" },
+        "icon": "circle-check",
+        "default": true
+      },
+      {
+        "type": "action",
+        "id": "reset-rounds",
+        "label": { "en": "Reset the rounds", "fr": "Remettre les tours à zéro" },
+        "icon": "rotate-ccw",
+        "visibleWhen": "show-rounds"
+      }
+    ]
+  }
+}
+```
+
+## Champs
+
+<!-- generated:manifest-fields -->
+| Champ | Type | Obligatoire | Signification |
+| --- | --- | --- | --- |
+| `schemaVersion` | entier de 1 à 1 | oui | Version du document de manifeste. |
+| `apiVersion` | entier de 1 à 1 | oui | Version de l’API des widgets ; elle sélectionne ce schéma. |
+| `id` | `widget ID` | oui | ID en DNS inversé, de 3 octets à 128 octets : au moins deux segments de `[a-z0-9-]` séparés par des points, chacun d’au plus 63 octets, sans `-` au début ni à la fin. `com.playervox` et `com.playervox.*` sont réservés aux paquets signés par PlayerVox. |
+| `version` | `version` | oui | SemVer 2.0.0 `MAJOR.MINOR.PATCH[-PRERELEASE]` sous sa forme canonique, d’au plus 64 octets ; les métadonnées de build sont refusées. |
+| `name` | `WidgetName` | oui | Nom localisé du widget, affiché par l’hôte. |
+| `sizing` | `Sizing` | oui | Règles de taille et d’ajustement appliquées par le cadre du widget. |
+| `vm` | `VmRequest` | non | Budget demandé pour la VM ; absent, les valeurs par défaut s’appliquent. |
+| `permissions` | `Permissions` | non | Permissions demandées ; absent, aucune. |
+| `wrapper` | `wrapper` | non | Lignes du widget dans le menu d’options de l’hôte. |
+| `requires` | `host features` | non | Sources de données de l’hôte, distinctes, sans lesquelles le widget ne peut pas fonctionner, comme le `requires` d’une ligne de `wrapper.menu`. Sur une machine à laquelle il en manque une, l’hôte ne démarre ni n’affiche le widget et conserve sa place ; le widget revient quand la source revient. |
+<!-- /generated:manifest-fields -->
+
+### Identité et version
+
+- **`id`** est l’identité du widget partout : dans le catalogue, dans le
+  profil de l’utilisateur, dans son stockage. Choisissez un ID en DNS
+  inversé sous un domaine que vous contrôlez, et gardez-le. Les ID sous
+  `com.playervox` sont réservés aux widgets publiés par PlayerVox.
+- **`version`** est une version sémantique. Une version publiée ne change
+  jamais : toute modification d’un widget publié est une nouvelle version,
+  supérieure.
+- **`schemaVersion`** et **`apiVersion`** valent tous deux `1`.
+
+### Noms
+
+`name` donne le nom qu’OverCrow affiche dans sa liste de widgets et dans ses
+menus, en anglais et en français. Les deux sont obligatoires.
+
+<!-- generated:manifest-name -->
+| Champ | Type | Obligatoire | Signification |
+| --- | --- | --- | --- |
+| `en` | `name text` | oui | Nom en anglais. |
+| `fr` | `name text` | oui | Nom en français. |
+<!-- /generated:manifest-name -->
+
+## Tailles
+
+`sizing` indique la taille du widget quand l’utilisateur l’ajoute, jusqu’où
+celui-ci peut le réduire et l’agrandir, et si OverCrow peut ajuster son
+cadre à son contenu. Les longueurs sont en pixels logiques, à une échelle de
+100 % ; l’échelle du contenu choisie par l’utilisateur (de 50 % à 175 %)
+les multiplie.
+
+<!-- generated:manifest-sizing -->
+| Champ | Type | Obligatoire | Signification |
+| --- | --- | --- | --- |
+| `fit` | `none` \| `both` \| `height` | oui | Ajustement au contenu que le widget accepte : sur les deux axes (`both`), en hauteur seulement (`height`) ou aucun (`none`). Le redimensionnement manuel reste toujours possible. |
+| `defaultMode` | `fit` \| `manual` | non | Mode d’un widget nouvellement placé ; par défaut `fit` quand `fit` n’est pas `none`, sinon `manual`. `fit` avec `fit: none` est refusé. |
+| `preferred` | `Dimensions` | oui | Taille initiale ; entre `min` et `max`. |
+| `min` | `Dimensions` | oui | Plus petite taille. |
+| `max` | `Dimensions` | oui | Plus grande taille. |
+<!-- /generated:manifest-sizing -->
+
+`preferred`, `min` et `max` sont chacun une paire de dimensions, avec
+`min` ≤ `preferred` ≤ `max` sur les deux axes :
+
+<!-- generated:manifest-dimensions -->
+| Champ | Type | Obligatoire | Signification |
+| --- | --- | --- | --- |
+| `width` | entier de 1 à 4096 | oui | Pixels logiques. |
+| `height` | entier de 1 à 4096 | oui | Pixels logiques. |
+<!-- /generated:manifest-dimensions -->
+
+Avec `fit: "both"`, OverCrow donne au cadre la taille dont la vue a besoin,
+dans les deux directions : l’Horloge grandit quand l’utilisateur active les
+secondes. Avec `fit: "height"`, l’utilisateur choisit la largeur et la
+hauteur suit le contenu. Avec `fit: "none"`, le cadre garde la taille que
+l’utilisateur lui a donnée et la vue le remplit. L’utilisateur peut toujours
+redimensionner à la main.
+
+<!-- source: widgets/clock/manifest.json -->
+```json
+  "sizing": {
+    "fit": "both",
+    "preferred": { "width": 110, "height": 60 },
+    "min": { "width": 40, "height": 24 },
+    "max": { "width": 480, "height": 240 }
+  },
+```
+
+## Permissions
+
+Un widget n’obtient rien qu’il n’ait déclaré ici, et une déclaration
+n’accorde rien à elle seule : l’utilisateur donne d’abord son accord, dans
+le Centre de contrôle.
+[Services et permissions](services.md) explique chaque permission et ce
+qu’elle autorise.
+
+<!-- generated:manifest-permissions -->
+| Champ | Type | Obligatoire | Signification |
+| --- | --- | --- | --- |
+| `network` | liste de `NetworkRule` ≤ 32 | non | Règles réseau, distinctes. |
+| `storage` | booléen | non | Stockage clé-valeur tenu par l’hôte ; `false` par défaut. |
+| `clipboardWrite` | booléen | non | Écriture de texte dans le presse-papiers ; `false` par défaut. |
+| `gameEvents` | liste de `game event` ≤ 32 | non | Noms d’événements `overcrow.game.<name>.v1`, distincts. |
+| `capabilities` | `capability names` | non | Capabilities du schéma, distinctes. |
+<!-- /generated:manifest-permissions -->
+
+<!-- source: widgets/stopwatch/manifest.json -->
+```json
+  "permissions": {
+    "capabilities": ["stopwatch.read", "stopwatch.control"]
+  }
+```
+
+Une règle réseau est un objet à part entière ; ses champs sont décrits avec
+les [règles réseau](services.md#règles-réseau).
+
+## Le menu d’options
+
+Chaque widget a un menu d’options, ouvert depuis son cadre. OverCrow y place
+d’abord ses propres lignes : opacité, taille du contenu, ajustement au
+contenu et, si le widget en a besoin, son compte. La visibilité en mode
+passif est l’œil de la barre d’outils du widget, pas une ligne du menu.
+`wrapper.menu` ajoute les vôtres en dessous : bascules, curseurs, choix,
+actions et groupes, chacun avec un libellé dans les deux langues.
+
+Le menu prend la largeur de sa ligne la plus large, de 248 à 320 points.
+Au-delà, un libellé se termine par « … » et s’affiche en entier dans une
+infobulle ; un choix montre sa valeur sur 120 points au plus. Gardez des
+libellés courts, dans les deux langues.
+
+<!-- source: widgets/clock/manifest.json -->
+```json
+  "wrapper": {
+    "menu": [
+      {
+        "type": "toggle",
+        "id": "show-seconds",
+        "label": { "en": "Show seconds", "fr": "Afficher les secondes" },
+        "default": false
+      },
+      {
+        "type": "toggle",
+        "id": "show-date",
+        "label": { "en": "Show date", "fr": "Afficher la date" },
+        "default": true
+      },
+      {
+        "type": "choice",
+        "id": "date-format",
+        "label": { "en": "Date format", "fr": "Format de date" },
+        "visibleWhen": "show-date",
+        "choices": [
+          { "value": "day-month-year", "label": { "en": "dd/mm/yyyy", "fr": "jj/mm/aaaa" } },
+          { "value": "year-month-day", "label": { "en": "yyyy-mm-dd", "fr": "aaaa-mm-jj" } },
+          { "value": "month-day-year", "label": { "en": "mm/dd/yyyy", "fr": "mm/jj/aaaa" } }
+        ],
+        "default": "day-month-year"
+      }
+    ]
+  }
+```
+
+OverCrow dessine les lignes, enregistre leurs valeurs dans le profil de
+l’utilisateur et les donne à la logique : lisez une valeur avec
+`option(id, fallback)` et suivez les changements avec `onHost`. Une ligne
+`action` n’a pas de valeur : elle appelle le gestionnaire que vous avez
+enregistré avec `onMenu`. Voir
+[le menu d’options dans la logique](logic.md#le-menu-doptions).
+
+Une ligne du menu peut fixer l’une de ses valeurs déclarées ou envoyer son
+action, rien d’autre. Elle ne peut ni accorder une permission ni ouvrir un
+lien, et choisir une ligne n’est pas une
+[action de l’utilisateur](services.md#les-appels-qui-demandent-une-action-de-lutilisateur)
+qui autorise un appel de service protégé.
+
+### Champs communs à toutes les lignes
+
+<!-- generated:menu-row-fields -->
+| Champ | Type | Obligatoire | Signification |
+| --- | --- | --- | --- |
+| `type` | `toggle` \| `slider` \| `choice` \| `action` \| `group` | oui | Type de la ligne. |
+| `id` | identifiant ≤ 48 octets | oui | Unique parmi toutes les lignes du widget ; clé de la valeur enregistrée. |
+| `label` | `MenuLabel` | oui | Libellé localisé de la ligne. |
+| `icon` | nom d’icône Lucide | non | Icône placée devant le libellé, prise dans la liste de l’hôte et dessinée par lui. |
+| `visibleWhen` | identifiant ≤ 48 octets | non | ID d’une ligne `toggle` déclarée plus haut ; cette ligne n’est affichée que tant que cette bascule est activée. |
+| `requires` | `fps` \| `telemetry.cpuTemperature` \| `telemetry.gpuTemperature` | non | Source de données de l’hôte ; l’hôte masque la ligne quand il ne peut pas la fournir. |
+<!-- /generated:menu-row-fields -->
+
+Une ligne dotée de `visibleWhen` ne s’affiche que tant que la bascule nommée
+est activée : le format de date de l’Horloge apparaît quand la date est
+affichée. Une ligne dotée de `requires` est masquée sur une machine qui ne
+peut pas fournir cette donnée, comme les lignes de température du widget
+Performances :
+
+<!-- source: widgets/performance/manifest.json -->
+```json
+            "requires": "telemetry.cpuTemperature",
+```
+
+Une ligne `group` ouvre un sous-menu latéral avec ses propres lignes ; le
+widget Performances range ses cinq bascules de mesures sous une seule ligne :
+
+<!-- source: widgets/performance/manifest.json -->
+```json
+        "type": "group",
+        "id": "shown-values",
+        "label": { "en": "Shown values", "fr": "Valeurs affichées" },
+        "rows": [
+```
+
+### Types de ligne
+
+<!-- generated:menu-row-types -->
+### `toggle`
+
+Bascule booléenne.
+
+| Champ | Type | Obligatoire | Signification |
+| --- | --- | --- | --- |
+| `default` | booléen | oui | Valeur initiale. |
+
+### `slider`
+
+Nombre borné ; `step` > 0, `step` ≤ `max - min`, au plus 10000 pas, `default` dans l’intervalle.
+
+| Champ | Type | Obligatoire | Signification |
+| --- | --- | --- | --- |
+| `min` | nombre de -1000000 à 1000000 | oui | Borne inférieure. |
+| `max` | nombre de -1000000 à 1000000 | oui | Borne supérieure, plus grande que `min`. |
+| `step` | nombre de -1000000 à 1000000 | oui | Pas. |
+| `default` | nombre de -1000000 à 1000000 | oui | Valeur initiale. |
+
+### `choice`
+
+Une valeur parmi les choix déclarés.
+
+| Champ | Type | Obligatoire | Signification |
+| --- | --- | --- | --- |
+| `choices` | liste de `MenuChoice` ≤ 16 | oui | Au moins 2 choix. |
+| `default` | identifiant ≤ 48 octets | oui | Valeur de l’un des choix déclarés. |
+
+### `action`
+
+Appelle le gestionnaire enregistré par `onMenu` avec l’ID de la ligne. Ce n’est pas une action de l’utilisateur.
+
+### `group`
+
+Sous-menu latéral qui contient des lignes autres que des groupes.
+
+| Champ | Type | Obligatoire | Signification |
+| --- | --- | --- | --- |
+| `rows` | liste de `MenuRow` ≤ 16 | oui | Au moins une ligne ; un `group` n’y est pas admis. |
+<!-- /generated:menu-row-types -->
+
+### Libellés et choix
+
+Un `label` est un objet qui porte les deux langues :
+
+<!-- generated:menu-label -->
+| Champ | Type | Obligatoire | Signification |
+| --- | --- | --- | --- |
+| `en` | `label text` | oui | Libellé en anglais. |
+| `fr` | `label text` | oui | Libellé en français. |
+<!-- /generated:menu-label -->
+
+Chaque entrée de `choices` est une valeur et son libellé :
+
+<!-- generated:menu-choice -->
+| Champ | Type | Obligatoire | Signification |
+| --- | --- | --- | --- |
+| `value` | identifiant ≤ 48 octets | oui | Valeur enregistrée ; unique dans la ligne. |
+| `label` | `MenuLabel` | oui | Libellé localisé du choix. |
+<!-- /generated:menu-choice -->
+
+## Sources de données indispensables
+
+Au premier niveau du manifeste, `requires` liste les sources de données sans
+lesquelles le widget ne peut pas fonctionner, avec les mêmes noms que le
+`requires` d’une ligne. Sur une machine à laquelle il en manque une,
+OverCrow ne démarre pas le widget, ne l’affiche pas et conserve sa place
+dans la disposition ; le widget revient quand la source revient.
+Utilisez-le pour un widget qui n’a rien d’autre à afficher, comme un
+compteur d’images par seconde sans source de fréquence d’images. Pour une
+seule valeur facultative, préférez le `requires` d’une ligne.
+
+## Un budget de mémoire plus grand
+
+La logique s’exécute avec un tas de 16 Mio. Un widget qui a besoin de plus
+le demande avec `vm` ; aucun autre budget de la VM ne peut être modifié.
+
+<!-- generated:manifest-vm -->
+| Champ | Type | Obligatoire | Signification |
+| --- | --- | --- | --- |
+| `heapMiB` | entier de 16 à 48 | oui | Plafond du tas QuickJS en Mio, de 16 Mio à 48 Mio. Le plafond du processus de la VM (64 Mio) ne change pas. |
+<!-- /generated:manifest-vm -->
+
+Le plafond de mémoire du processus du widget reste le même : un tas plus
+grand laisse donc moins de place à tout le reste. Ne le demandez que si
+`overcrow-widget dev` montre que le widget s’arrête avec `resource_limit`.
+
+## Comment le manifeste est vérifié
+
+`overcrow-widget check` valide le manifeste avec le validateur qu’OverCrow
+exécute lui-même, et désigne le membre qu’il refuse :
+
+```text
+error[manifest.sizing]: `sizing` is out of bounds or inconsistent
+  --> manifest.json:7:3
+   |
+ 7 |   "sizing": {
+   |   ^
+   = help: `min` <= `preferred` <= `max`, each within the schema's widget size bounds
+check: 1 error(s), 0 warning(s)
+```
+
+OverCrow le valide de nouveau quand le paquet est admis dans le catalogue,
+quand il est installé et à chaque démarrage du widget. Une nouvelle version
+dont le manifeste demande plus que la précédente (une règle réseau, un
+événement de jeu, une capability, le stockage ou le presse-papiers) attend
+que l’utilisateur l’approuve dans le Centre de contrôle avant de remplacer
+la version installée.

package/dist/content/docs/fr/mcp.md

@@ -0,0 +1,173 @@
+# MCP
+
+PlayerVox OverCrow a un serveur pour les assistants IA : `@overcrow/mcp`.
+Ajoutez-le à Claude Code, Claude Desktop, Cursor, VS Code ou Codex, et votre
+assistant peut créer un widget, le vérifier, le tester, l’auditer,
+l’empaqueter et préparer sa soumission. Il vous faut Node.js 22.18 ou plus
+récent, rien d’autre : le serveur installe lui-même les outils OverCrow dont
+il a besoin.
+
+```sh
+claude mcp add overcrow -- npx -y @overcrow/mcp
+```
+
+Demandez ensuite : « Crée un widget OverCrow qui affiche… ».
+
+## Ajouter le serveur
+
+Ouvrez votre dossier de widgets dans l’assistant, puis ajoutez le serveur.
+
+### En une commande
+
+**Claude Code**, depuis ce dossier :
+
+```sh
+claude mcp add overcrow -- npx -y @overcrow/mcp
+```
+
+**Codex** :
+
+```sh
+codex mcp add overcrow -- npx -y @overcrow/mcp
+```
+
+**VS Code** : [installer dans VS Code](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%257B%2522name%2522%253A%2522overcrow%2522%252C%2522command%2522%253A%2522npx%2522%252C%2522args%2522%253A%255B%2522-y%2522%252C%2522%2540overcrow%252Fmcp%2522%255D%257D), ou :
+
+```sh
+code --add-mcp '{"name":"overcrow","command":"npx","args":["-y","@overcrow/mcp"]}'
+```
+
+### Avec un fichier de configuration
+
+**Cursor** : un fichier `.cursor/mcp.json` dans le dossier.
+
+<!-- source: mcp/examples/cursor-mcp.json -->
+```json
+{
+  "mcpServers": {
+    "overcrow": {
+      "command": "npx",
+      "args": ["-y", "@overcrow/mcp"]
+    }
+  }
+}
+```
+
+**VS Code** : un fichier `.vscode/mcp.json` dans le dossier.
+
+<!-- source: mcp/examples/vscode-mcp.json -->
+```json
+{
+  "servers": {
+    "overcrow": {
+      "type": "stdio",
+      "command": "npx",
+      "args": ["-y", "@overcrow/mcp"]
+    }
+  }
+}
+```
+
+**Claude Desktop** lance ses serveurs hors de vos dossiers : indiquez votre
+dossier de widgets avec `--root` dans `claude_desktop_config.json`
+(Paramètres, Développeur, Modifier la configuration), puis redémarrez
+Claude Desktop.
+
+<!-- source: mcp/examples/claude_desktop_config.json -->
+```json
+{
+  "mcpServers": {
+    "overcrow": {
+      "command": "npx",
+      "args": ["-y", "@overcrow/mcp", "--root", "C:\\Users\\you\\Documents\\widgets"]
+    }
+  }
+}
+```
+
+## Ce que fait le serveur
+
+- **La première fois**, il télécharge les outils créateurs OverCrow de
+  votre ordinateur ([l’outil en ligne de commande](cli.md) et le runtime
+  qui joue les [tests](testing.md), environ 15 Mo) depuis la release GitHub
+  d’OverCrow. Il vérifie chaque fichier avec les empreintes inscrites dans
+  le serveur, puis les garde dans son propre dossier
+  (`~/.cache/overcrow-mcp`, ou `%LOCALAPPDATA%\overcrow-mcp` sous Windows).
+  Rien ne s’ajoute à votre `PATH`, et aucun droit d’administrateur n’est
+  nécessaire.
+- **Ensuite**, votre assistant travaille avec ses outils, dans cet ordre :
+  créer le widget depuis un modèle, installer le SDK (il vous le demande
+  d’abord), vérifier, tester (il voit les images qui diffèrent), auditer,
+  empaqueter, préparer la soumission.
+- **L’identifiant du widget** est définitif. Votre assistant vous le
+  demande : votre pseudo d’éditeur dans l’espace créateurs d’OverCrow et un
+  nom (`nova.lol-timers`), ou un domaine que vous pouvez vérifier
+  (`gg.nova.lol-timers`).
+- **La soumission** : le serveur vérifie tout ce que demande l’espace
+  créateurs, puis écrit le zip des sources de votre widget dans `dist/`,
+  sans `node_modules`, `dist`, fichiers cachés ni clés, et liste ce qu’il a
+  laissé de côté. Il liste aussi les textes à écrire : pourquoi le widget a
+  besoin de chaque permission, les notes de version et la description en
+  français et en anglais. Votre assistant les rédige avec vous.
+- **L’audit** note le widget sur 100 pour la sécurité et pour la légèreté,
+  avec pour chaque constat une correction et un exemple tiré d’un
+  [widget de référence](widgets.md) : permissions inutilisées, règles
+  réseau trop larges, secrets, écritures dans le presse-papiers sans action
+  de l’utilisateur, minuteurs rapides, interrogation répétée du réseau,
+  listes qui grandissent sans fin, grosses réponses lues en un seul tour,
+  images lourdes.
+- **La documentation** de ce site, en français et en anglais, et les
+  sources des widgets de référence viennent avec le serveur : votre
+  assistant les lit sans accès au réseau.
+
+## Ce qu’il ne fait pas
+
+- Il n’envoie, ne signe et ne publie jamais rien. Vous envoyez le zip et
+  les textes dans l’espace créateurs d’OverCrow, sur overcrow.playervox.com.
+- Il n’installe pas votre widget dans OverCrow : l’essayer en jeu passe par
+  le [canal de développement](dev-channel.md) de l’outil en ligne de
+  commande.
+- Il n’envoie rien sur vous : ni télémétrie, ni compte.
+
+## Sécurité
+
+- **Vos dossiers seulement.** Le serveur travaille dans le dossier ouvert
+  dans votre assistant (ou ceux donnés avec `--root`). Il refuse un dossier
+  système, votre dossier personnel entier, les dossiers cachés et les liens
+  qui mènent ailleurs.
+- **Aucune commande de son choix.** Le serveur lance l’outil en ligne de
+  commande d’OverCrow et npm, rien d’autre, jamais à travers un shell.
+- **Téléchargements vérifiés.** Il ne télécharge que les fichiers épinglés
+  depuis GitHub, et les vérifie avant de s’en servir. npm n’installe que
+  `@overcrow/sdk` et TypeScript, sans scripts d’installation, et leur
+  intégrité est comparée à celle des paquets publiés.
+- **Vous confirmez.** Installer des paquets et remplacer des images de
+  référence demandent votre accord.
+- **Vos fichiers sont des données.** Ce que les outils renvoient de vos
+  fichiers est marqué comme donnée : un texte placé dans un widget ne peut
+  pas donner d’ordres à votre assistant par le serveur. Relisez tout de même
+  ce que votre assistant modifie, et validez ses actions comme d’habitude.
+
+## Hors ligne
+
+Téléchargez une fois depuis la release GitHub d’OverCrow le fichier
+`overcrow-creator-tools-VERSION-PLATFORME.zip` de votre plateforme,
+placez-le dans votre dossier de widgets, et demandez à votre assistant de
+lancer `setup` avec ce fichier (`zipPath`). Ou lancez le serveur avec
+`--tools-zip` et le chemin du fichier. Le fichier doit être exactement celui
+que le serveur épingle.
+
+## Ordinateurs pris en charge
+
+Vérifier, tester et empaqueter demandent Windows x64 ou Linux x86-64. Sous
+macOS et sur ARM, le serveur donne quand même la documentation, les
+explications et l’audit.
+
+## En cas de problème
+
+- **« not tied to a published OverCrow release »** : mettez le serveur à
+  jour avec `npx -y @overcrow/mcp@latest`.
+- **Derrière un proxy** : définissez `HTTPS_PROXY` dans l’environnement du
+  serveur.
+- **« cannot work in / »** (souvent Claude Desktop) : ajoutez `--root` et
+  votre dossier de widgets.