@overcrow/mcp 0.1.0 → 0.1.2

package/dist/content/docs/fr/creator-space.md

@@ -0,0 +1,83 @@
+# Démarrer dans l’espace créateurs
+
+L’espace créateurs de PlayerVox OverCrow, à l’adresse
+`creators.playervox.com`, sert à publier des widgets : vous y créez votre éditeur une fois, réservez les
+identifiants de vos widgets, envoyez leurs versions et suivez leur revue. Il
+est ouvert sur invitation pour l’instant.
+
+## Se connecter
+
+Connectez-vous avec votre compte PlayerVox : l’espace créateurs vous envoie
+sur playervox.com, qui vous demande de confirmer, puis vous ramène. Vous ne
+tapez jamais votre mot de passe dans l’espace créateurs. La session dure tant
+que vous l’utilisez, 14 jours au plus ; vous pouvez la fermer sur
+playervox.com, dans **Appareils connectés**.
+
+L’interface est en français ou en anglais : choisissez dans le menu du
+compte. Les adresses restent les mêmes dans les deux langues.
+
+## Activer la double authentification
+
+Publier exige la double authentification sur votre compte. La première
+visite l’active :
+
+1. Ouvrez une application d’authentification (Aegis, 2FAS, Google
+   Authenticator, 1Password…).
+2. Scannez le QR code sur un ordinateur, ou touchez **Ajouter à mon
+   application** sur un téléphone ou une tablette. Vous pouvez aussi saisir
+   la clé à la main.
+3. Entrez le code à 6 chiffres affiché par l’application.
+
+Vous recevez ensuite dix codes de secours, affichés une seule fois : chacun
+vous connecte une fois si vous perdez votre téléphone. Rangez-les en lieu
+sûr. Créer une clé de publication ou supprimer votre éditeur redemande un
+code récent.
+
+## Créer votre éditeur
+
+L’éditeur est le nom sous lequel vos widgets apparaissent.
+
+- **Nom affiché** : montré aux joueurs. Un nom qui se lit comme PlayerVox,
+  OverCrow ou Valhallab est refusé.
+- **Identifiant** : de 3 à 32 lettres minuscules, chiffres et tirets, sans
+  tiret au début ni à la fin. Il est **définitif** : il ne peut plus être
+  changé, et un identifiant n’est jamais donné à quelqu’un d’autre, même
+  après une suppression. Les identifiants de vos widgets commencent par lui.
+- **E-mail de contact** : pour que PlayerVox vous joigne. Il n’est jamais
+  affiché.
+- **Site web** et **logo** (carré, PNG ou WebP) : facultatifs, affichés sur
+  votre page éditeur. Tapez le site comme vous le connaissez
+  (`exemple.com`) : `https://` est ajouté pour vous.
+
+Votre profil public (nom, présentation, site, logo) paraît avec la prochaine
+publication du catalogue : d’ici là, l’espace créateurs indique **Visible
+après la prochaine publication**.
+
+Lisez ensuite l’accord créateur, résumé en six points à l’écran, et
+acceptez-le. Votre espace est prêt.
+
+## Réserver l’identifiant de votre premier widget
+
+L’identifiant d’un widget s’écrit `<identifiant>.<nom>` : `nova.lol-timers`
+pour l’identifiant `nova`. Avec un [domaine vérifié](verified-domain.md), il
+peut aussi commencer par votre domaine inversé : `gg.nova.lol-timers` pour
+`nova.gg`. Le nom s’écrit en lettres minuscules, chiffres et tirets. Un
+identifiant est définitif et ne ressert jamais.
+
+Dans **Widgets**, **Nouveau widget** réserve l’identifiant. Créez le projet
+avec le même identifiant :
+
+```sh
+overcrow-widget init lol-timers --id nova.lol-timers
+```
+
+Essayez-le dans votre jeu avec le [canal de développement](dev-channel.md) :
+rien n’est publié.
+
+## Ensuite
+
+- Envoyer une version : [publication et revue](publishing.md).
+- Envoyer depuis un terminal ou une CI :
+  [clés de publication et CI](publish-keys.md).
+- Obtenir le badge vérifié et des identifiants à votre domaine :
+  [domaine vérifié](verified-domain.md).

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

@@ -250,10 +250,9 @@ utilisateurs obtiennent les widgets par le catalogue signé. Voir
 
 ## 12. Soumettre
 
-Ajoutez un `listing.json` avec le texte de la marketplace, lancez vous-même
-l’admission, puis ouvrez une pull request qui ajoute votre widget sous
-`widgets/<dir>/`, sur la branche `candidate` du
-[dépôt public](https://github.com/Valhallab/playervox-overcrow-releases) :
+Ajoutez un `listing.json` avec le texte de la marketplace et lancez
+vous-même l’admission. Les widgets ne sont plus proposés par pull request :
+vous enverrez le vôtre depuis l’espace créateurs OverCrow, à son ouverture.
 
 ```sh
 overcrow-widget admit

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

@@ -39,7 +39,7 @@ valeurs qu’il remplit. Voici un manifeste avec des permissions et un menu :
 {
   "schemaVersion": 1,
   "apiVersion": 1,
-  "id": "com.example.countdown",
+  "id": "nova.countdown",
   "version": "1.0.0",
   "name": { "en": "Countdown", "fr": "Compte à rebours" },
   "sizing": {
@@ -79,7 +79,7 @@ valeurs qu’il remplit. Voici un manifeste avec des permissions et un menu :
 | --- | --- | --- | --- |
 | `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. |
+| `id` | `widget ID` | oui | ID du widget, 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 ; `<pseudo>.<nom>` avec le pseudo de l’éditeur, ou un domaine vérifié de l’éditeur, inversé, suivi d’un nom. `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. |
@@ -92,9 +92,14 @@ valeurs qu’il remplit. Voici un manifeste avec des permissions et un menu :
 ### 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.
+  profil de l’utilisateur, dans son stockage. Il s’écrit `<pseudo>.<nom>`,
+  votre pseudo d’éditeur dans l’espace créateurs d’OverCrow et un nom
+  (`nova.lol-timers`), ou, une fois un domaine vérifié, ce domaine inversé
+  et un nom (`gg.nova.lol-timers`). Un ID est définitif : il n’est jamais
+  donné à un autre widget, même après la suppression du vôtre. `nova`,
+  `example`, `yourhandle` et `yourname` sont des pseudos d’exemple sous
+  lesquels personne ne peut publier, et 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.
@@ -103,7 +108,11 @@ valeurs qu’il remplit. Voici un manifeste avec des permissions et un menu :
 ### 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.
+menus, en anglais et en français. Les deux sont obligatoires. Un nom
+s’affiche tel qu’il est écrit : ni caractère de contrôle, ni caractère
+invisible ou de sens d’écriture, comme U+200B (espace sans chasse) ou
+U+202E (forçage de droite à gauche). Les libellés du menu suivent la même
+règle.
 
 <!-- generated:manifest-name -->
 | Champ | Type | Obligatoire | Signification |

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

@@ -123,7 +123,7 @@ Claude Desktop.
 ## 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.
+  les textes dans l’espace créateurs d’OverCrow, à l’adresse creators.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.

package/dist/content/docs/fr/publish-a-widget.md

@@ -0,0 +1,101 @@
+# Publier un widget
+
+Dans l’espace créateurs de PlayerVox OverCrow, à l’adresse
+`creators.playervox.com`, un widget arrive aux joueurs en quatre
+étapes : vous envoyez ses sources, elles sont contrôlées automatiquement,
+PlayerVox les relit, puis la version est publiée dans le catalogue. Cette
+page couvre les deux premières et l’écran qui envoie une version en revue ;
+la [revue](widget-review.md) et la [fiche](widget-listing.md) ont leur
+propre page.
+
+## Avant d’envoyer
+
+- L’identifiant de votre widget est réservé dans l’espace créateurs
+  ([démarrer](creator-space.md)), et `manifest.json` l’utilise.
+- `overcrow-widget check` passe dans le dossier du widget.
+- La version de `manifest.json` est plus récente que la dernière approuvée :
+  `1.2.1` ou plus après `1.2.0`.
+
+## Envoyer les sources
+
+Ouvrez le widget dans **Widgets**, puis **Envoyer une version**.
+
+- Sur un ordinateur, déposez le dossier du widget sur la page, ou
+  choisissez-le. Vous pouvez aussi envoyer un `.zip` du dossier.
+- Sur un téléphone ou une tablette, qui ne savent pas choisir un dossier,
+  choisissez le `.zip`.
+
+L’espace créateurs lit un dossier avec les mêmes règles que
+`overcrow-widget submit`, sur votre ordinateur, et envoie les mêmes
+fichiers. Il laisse de côté les fichiers et dossiers cachés (`.env`,
+`.git/`…), `node_modules/`, `dist/`, `tests/output/`, `__MACOSX/`, les
+paquets déjà construits, les fichiers de clés, les fichiers système et les
+noms qui ne sont pas en ASCII portable ; la page liste ce qu’il a laissé de
+côté. Un `.zip` est envoyé tel quel. Les bornes et les refus sont ceux des
+[archives de sources](cli.md#archives-de-sources) : 32 Mio pour l’archive,
+64 Mio et 2 000 fichiers une fois décompressé, 16 niveaux de dossiers, des
+chemins de 255 octets au plus, aucun nom qui ne diffère d’un autre que par
+la casse.
+
+- Un `.zip` fait par Windows PowerShell 5.1 (`Compress-Archive`) sépare les
+  dossiers par `\` et est refusé aussitôt : déposez plutôt le dossier.
+- Un nom de fichier ou de dossier avec `\ : * ? " < > |` est refusé avant
+  tout envoi : Windows ne peut pas l’utiliser. Renommez-le.
+- Un navigateur lit le fichier vers lequel pointe un lien, là où l’outil en
+  ligne de commande laisse le lien de côté. Gardez les liens hors du dossier
+  du widget.
+- Vos sources restent privées : seuls les relecteurs PlayerVox les lisent,
+  et chaque consultation apparaît dans l’espace créateurs.
+
+Un éditeur fait au plus 20 envois en 24 heures ; la page dit quand le
+suivant est possible. Si la page se ferme ou si la connexion se coupe
+pendant l’envoi, déposez à nouveau le même dossier : l’envoi reprend, et
+rien n’est compté deux fois.
+
+## Les contrôles
+
+Les contrôles prennent environ une minute : le manifeste, le numéro de
+version, le code, la construction du paquet, les permissions, la taille.
+Vous pouvez quitter la page : un e-mail vous prévient quand ils sont finis.
+
+- Quand un contrôle échoue, chaque problème est montré dans vos propres
+  fichiers, avec la ligne et la correction. Corrigez et envoyez à nouveau ;
+  rien n’arrive aux relecteurs.
+- « Problème de notre côté » signifie que PlayerVox n’a pas pu faire les
+  contrôles : votre code n’est pas en cause. PlayerVox est prévenu et les
+  relance.
+
+## Soumettre pour revue
+
+Quand les contrôles passent, la page de la version dit ce qui change pour
+les joueurs :
+
+- **Permissions.** Expliquez pourquoi le widget a besoin de chaque
+  permission nouvelle ou élargie, avec des mots que les joueurs comprennent.
+  Une première version les explique toutes.
+- **Politique de confidentialité.** Obligatoire dès que le widget utilise
+  le réseau. L’adresse tapée ici est aussi enregistrée dans la fiche.
+- **Fiche.** Une première version part en revue avec sa fiche, qui demande
+  une description en anglais, une licence et un contact d’assistance.
+- **Notes de version**, visibles par les joueurs : facultatives. L’anglais
+  vient d’abord ; **Ajouter une langue** en ajoute d’autres, 16 au plus. Dès
+  que vous en écrivez, écrivez-les aussi en anglais.
+- **Message pour la revue**, lu seulement par PlayerVox : un compte de test,
+  un contexte utile.
+
+La page dit aussi quelle revue la version reçoit (rapide ou complète) et ce
+qui a changé depuis la dernière version approuvée. **Soumettre pour revue**
+l’envoie.
+
+## Depuis un terminal ou une CI
+
+`overcrow-widget submit` envoie une version avec une clé de publication, et
+s’arrête au même écran quand il manque quelque chose : voir
+[`submit`](cli.md#submit) et [clés de publication et CI](publish-keys.md).
+
+## Après la revue
+
+Une version approuvée est publiée sous 24 heures ouvrées. Dans l’espace
+créateurs, vous pouvez ensuite la retirer, ou retirer le widget entier
+(**Réglages**) : il sort du catalogue à la prochaine publication, et les
+copies installées continuent de fonctionner.

package/dist/content/docs/fr/publish-keys.md

@@ -0,0 +1,97 @@
+# Clés de publication et CI
+
+Une clé de publication permet à `overcrow-widget submit` d’envoyer les
+versions d’un widget PlayerVox OverCrow depuis un terminal ou une CI, sans
+votre mot de passe.
+Elle ne permet rien d’autre.
+
+## Ce qu’une clé permet
+
+- Soumettre des versions d’**un seul** widget, et suivre leurs contrôles.
+  Chaque version passe toujours par la revue avant d’arriver aux joueurs.
+- Elle ne permet ni de publier, ni de modifier la fiche, ni d’accéder à
+  votre compte ou à vos autres widgets.
+- Elle dure de 1 à 365 jours (90 par défaut). Nous vous prévenons par e-mail
+  et dans l’espace créateurs 14 jours avant son expiration.
+- PlayerVox n’en garde qu’une empreinte : la clé est affichée **une seule
+  fois**, à sa création.
+
+## Créer une clé
+
+Dans l’espace créateurs, **Clés de publication**, **Créer une clé** :
+
+1. Nommez-la d’après l’endroit où elle servira (`GitHub Actions`,
+   `Portable`).
+2. Choisissez le widget et la durée.
+3. Confirmez avec un code récent de votre application d’authentification.
+
+Copiez aussitôt la clé dans les secrets de votre CI : elle commence par
+`ocw_pub_` et ne sera plus jamais affichée. Si vous la perdez, révoquez-la et
+créez-en une autre. Un widget a au plus dix clés actives.
+
+## L’utiliser
+
+`overcrow-widget submit` lit la clé dans la variable d’environnement
+`OVERCROW_PUBLISH_KEY`, et seulement là : ne la mettez jamais dans un fichier
+du projet ni dans une ligne de commande.
+
+```sh
+export OVERCROW_PUBLISH_KEY=ocw_pub_…
+overcrow-widget submit
+```
+
+La [commande submit](cli.md#submit) contrôle la version comme le fera
+l’espace créateurs, l’envoie, puis suit ses contrôles, environ une minute.
+
+## Dans GitHub Actions
+
+Gardez la clé comme secret du dépôt, `OVERCROW_PUBLISH_KEY`. Ce workflow
+soumet le widget à chaque tag de version :
+
+<!-- source: docs/content/examples/weather/.github/workflows/submit.yml -->
+```yaml
+# Sends the widget to the OverCrow creator space when a version tag is
+# pushed. The publish key is a secret of the repository, and the OverCrow
+# release whose creator tools to use is a variable of the repository.
+name: Submit to OverCrow
+
+on:
+  push:
+    tags: ["v*"]
+
+permissions:
+  contents: read
+
+jobs:
+  submit:
+    runs-on: ubuntu-24.04
+    env:
+      OVERCROW_VERSION: ${{ vars.OVERCROW_VERSION }}
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install overcrow-widget
+        run: |
+          tools="overcrow-creator-tools-$OVERCROW_VERSION-linux-x86_64"
+          curl --fail --location --silent --show-error --remote-name \
+            "https://github.com/Valhallab/playervox-overcrow-releases/releases/download/v$OVERCROW_VERSION/$tools.zip"
+          unzip -q "$tools.zip"
+          (cd "$tools" && sha256sum --check --quiet SHA256SUMS)
+          install -D -m 755 "$tools"/overcrow-widget-*-linux-x86_64 "$HOME/.local/bin/overcrow-widget"
+          echo "$HOME/.local/bin" >> "$GITHUB_PATH"
+      - name: Submit to OverCrow
+        run: overcrow-widget submit --submission submission.json
+        env:
+          OVERCROW_PUBLISH_KEY: ${{ secrets.OVERCROW_PUBLISH_KEY }}
+```
+
+La tâche échoue quand les contrôles échouent, avec chaque problème sur la
+ligne de votre fichier. Une version que l’espace créateurs a déjà n’est pas
+renvoyée : `submit` donne son état, et la même tâche peut aussi tourner à
+chaque push sur votre branche principale.
+
+## Révoquer une clé
+
+**Révoquer** arrête la clé aussitôt : un envoi en cours avec elle échoue.
+Les versions qu’elle a déjà envoyées restent, mais n’entrent plus seules en
+revue : envoyez-les en revue depuis l’espace créateurs. Révoquez une clé dès
+que vous pensez qu’elle a fuité, puis créez-en une nouvelle.

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

@@ -1,5 +1,10 @@
 # Publication et revue
 
+> **Les pull requests sont fermées.** Les widgets ne sont plus proposés par
+> pull request : ceux de PlayerVox passent déjà par l’espace créateurs
+> OverCrow, et le vôtre y passera à son ouverture. D’ici là, cette page
+> décrit l’admission, la revue et le catalogue que suit un widget.
+
 Les widgets atteignent les utilisateurs de PlayerVox OverCrow par le
 catalogue signé des widgets : OverCrow n’installe que ce que liste ce
 catalogue. Cette page va du dossier de sources d’un widget à une version

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

@@ -390,7 +390,7 @@ hasard sont réels.
 `overcrow-widget-headless` est le code d’OverCrow lui-même, sans fenêtre :
 il valide le paquet comme le fait l’overlay et exécute la logique du widget
 dans le même sandbox. `overcrow-widget test` exécute la version que la CLI
-épingle, 0.6.0-beta.2, et affiche sa version et son SHA-256. Sans le
+épingle, 0.7.0-beta.1, et affiche sa version et son SHA-256. Sans le
 sandbox du système d’exploitation, le runtime refuse de s’exécuter et le
 dit ; la commande de test se termine alors avec le code 2.
 
@@ -402,8 +402,8 @@ ensuite dans le cache de la CLI :
 
 | Plateforme | Chemin |
 | --- | --- |
-| Linux | `~/.cache/overcrow-widget/runtime/0.6.0-beta.2/` (`$XDG_CACHE_HOME` au lieu de `~/.cache` s’il est défini) |
-| Windows | `%LOCALAPPDATA%\overcrow-widget\runtime\0.6.0-beta.2\` |
+| Linux | `~/.cache/overcrow-widget/runtime/0.7.0-beta.1/` (`$XDG_CACHE_HOME` au lieu de `~/.cache` s’il est défini) |
+| Windows | `%LOCALAPPDATA%\overcrow-widget\runtime\0.7.0-beta.1\` |
 
 Pour travailler hors ligne, placez-y vous-même le runtime du ZIP des
 outils créateurs (exécutable sous Linux) : `test` le trouve et ne

package/dist/content/docs/fr/verified-domain.md

@@ -0,0 +1,49 @@
+# Domaine vérifié
+
+Vérifier un domaine qui vous appartient ajoute le badge **Domaine vérifié** à
+côté du nom de votre éditeur, dans le Centre de contrôle de PlayerVox
+OverCrow et sur le site, et
+permet aux identifiants de vos widgets de commencer par ce domaine inversé :
+`gg.nova.lol-timers` pour `nova.gg`.
+
+## Ajouter un domaine
+
+Dans l’espace créateurs, **Profil de l’éditeur**, **Ajouter un domaine**.
+Écrivez le domaine seul, sans `https://` ni `www.` : `nova.gg`. Un éditeur
+peut avoir jusqu’à huit domaines.
+
+L’espace créateurs donne alors l’enregistrement DNS à publier chez votre
+hébergeur : un enregistrement TXT nommé `_overcrow.` suivi de votre domaine,
+dont la valeur est `overcrow-verify=` suivi d’un jeton.
+
+```text
+_overcrow.nova.gg.  TXT  "overcrow-verify=3f9c1e7a52d04b8e"
+```
+
+## La vérification
+
+**Vérifier maintenant** cherche l’enregistrement tout de suite (une fois par
+minute au plus). Nous vérifions aussi tout seuls, toutes les heures pendant
+sept jours. Le DNS peut mettre quelques minutes à se propager.
+
+| État | Signification |
+| --- | --- |
+| En attente | L’enregistrement n’est pas encore trouvé ; vérifié toutes les heures pendant sept jours. |
+| Vérifié | L’enregistrement est trouvé. Il est revérifié tous les 30 jours. |
+| Perdu | L’enregistrement a disparu. Remettez-le, puis vérifiez maintenant. |
+| Expiré | Pas vérifié en sept jours. Vérifiez maintenant pour recommencer. |
+
+Laissez l’enregistrement en place : s’il disparaît, le badge s’en va. Les
+identifiants des widgets déjà créés sous ce domaine restent à vous.
+
+## Qui peut revendiquer un domaine
+
+- Un domaine vérifié une fois par un éditeur lui est réservé, ainsi que les
+  domaines en dessous et au-dessus : personne d’autre ne peut les
+  revendiquer.
+- Un domaine qui se lit comme PlayerVox, OverCrow ou Valhallab est refusé ;
+  écrivez à l’assistance s’il vous appartient. Les identifiants sous
+  `com.playervox` appartiennent à PlayerVox.
+- Retirer un domaine jamais vérifié l’oublie. Un domaine vérifié une fois
+  vous reste réservé, et ne peut pas être retiré tant que des identifiants
+  de widgets l’utilisent.

package/dist/content/docs/fr/widget-listing.md

@@ -0,0 +1,69 @@
+# Fiche : bonnes pratiques
+
+La fiche est ce que les joueurs lisent dans le catalogue de PlayerVox
+OverCrow avant d’installer un widget : sa description, son aperçu, sa
+catégorie, ses jeux, sa licence et ses liens. Vous l’écrivez dans l’espace
+créateurs, dans l’onglet **Fiche** du widget.
+
+## Enregistrée au fil de la saisie
+
+La fiche est un brouillon, enregistré tout seul pendant que vous écrivez.
+
+- La première fiche d’un widget part en revue avec sa première version.
+- Les modifications suivantes partent seules en revue rapide :
+  **Soumettre la fiche**. Elles ne demandent pas de nouvelle version du
+  widget. **Annuler les modifications** ramène le brouillon à la fiche
+  publiée.
+- La catégorie fait exception : vous la changez quand vous voulez, sans
+  revue, et le changement arrive aux joueurs avec la prochaine publication
+  du catalogue.
+
+## Langues
+
+L’anglais vient en premier : c’est la langue par défaut, montrée quand la
+langue d’un joueur n’a pas de description. **Ajouter une langue** en ajoute
+une autre, 16 langues au plus. Le nom du widget vient de son manifeste
+(`name.en`, `name.fr`) : pour le changer, changez le manifeste et envoyez une
+version. Les langues de l’interface du widget viennent de ses fichiers
+`locales/`.
+
+## Description
+
+- 500 caractères au plus par langue. Les deux premières lignes apparaissent
+  sur la carte du catalogue : dites simplement ce que fait le widget.
+- Dites quand le widget contacte un serveur, et lequel.
+- Pas de publicité, et aucune promesse que le widget ne tient pas.
+
+## Image d’aperçu
+
+Une seule image, en anglais, pour toutes les langues : un PNG au format 4:3,
+de 480 × 360 à 1 024 × 768 (1 024 × 768 conseillé), 256 Kio au plus.
+Montrez le widget en situation, sans texte marketing.
+
+## Catégorie et jeux
+
+La catégorie place le widget dans le catalogue. Ajoutez jusqu’à cinq jeux
+pour lesquels il est fait : les joueurs filtrent le catalogue par jeu.
+
+## Licence et liens
+
+- **Licence** : « Propriétaire, tous droits réservés », ou une licence SPDX
+  comme `MIT` ou `Apache-2.0`.
+- **Assistance** : une adresse e-mail ou une page web où les joueurs
+  trouvent de l’aide. Obligatoire.
+- **Politique de confidentialité** : obligatoire dès que le widget utilise
+  le réseau.
+- **Code source public** : facultatif ; un dépôt public ajoute le badge
+  « Code source public ».
+
+Tapez une adresse comme vous la connaissez (`exemple.com/confidentialite`) :
+`https://` est ajouté pour vous, et un `/` après un domaine seul
+(`exemple.com` est enregistré `https://exemple.com/`). Une adresse en
+`http://` est refusée.
+
+## Depuis listing.json
+
+Les sources d’une version peuvent contenir un `listing.json`, tel que
+l’outil en ligne de commande le lit (voir [`admit`](cli.md#admit)). Dans
+l’onglet **Fiche**, **Importer listing.json** applique ses descriptions, sa
+licence et l’adresse de son code source au brouillon.

package/dist/content/docs/fr/widget-review.md

@@ -0,0 +1,59 @@
+# Revue : types, délais, recours
+
+Chaque version d’un widget PlayerVox OverCrow, et chaque modification de sa
+fiche, est lue par une personne de PlayerVox avant que les joueurs ne la
+reçoivent. Cette page couvre les deux types de revue, leurs délais, le fil
+de revue et le recours. Pour envoyer une version, voir
+[publier un widget](publish-a-widget.md).
+
+## Rapide ou complète
+
+| Revue | Quand | Délai maximal |
+| --- | --- | --- |
+| Complète | La première publication, ou une mise à jour qui ajoute une permission, une route réseau ou une capability | 5 jours ouvrés |
+| Rapide | Toute autre mise à jour, ou une modification de la fiche seule | 2 jours ouvrés |
+| Recours | Une fois par décision, sous six mois | 7 jours |
+| Publication | Après l’approbation | 24 heures ouvrées |
+
+Les jours ouvrés vont du lundi au vendredi, hors jours fériés en France. Le
+délai est suspendu tant que la revue attend votre réponse ou une version
+corrigée. Une revue rapide lit les lignes modifiées depuis la dernière
+version approuvée ; une revue complète lit l’ensemble du widget.
+
+## Le fil de revue
+
+Chaque version en revue a un fil dans l’espace créateurs :
+
+- Une **remarque** pointe un fichier et une ligne, cite le code que le
+  relecteur a lu et une règle numérotée des règles de publication.
+- Vous pouvez **répondre** au relecteur. Votre réponse renvoie la revue au
+  relecteur quand elle vous attendait.
+- Une **version corrigée** reprend le même fil : envoyez-la depuis
+  **Envoyer une version**, avec un numéro de version plus récent.
+- La **décision** est une approbation, des modifications demandées ou un
+  refus, toujours motivés.
+
+Les relecteurs apparaissent comme « Relecteur PlayerVox », jamais par leur
+nom. Chaque fois qu’un relecteur ouvre vos sources, l’espace créateurs
+montre quand, quelle version et pourquoi, dans **Accès à vos sources**.
+
+## Recours
+
+Vous pouvez contester un refus ou une suspension une fois par décision,
+sous six mois, avec **Contester la décision**. PlayerVox réexamine
+entièrement la décision et vous répond sous 7 jours, de façon motivée. Vous
+pouvez toujours envoyer une nouvelle version à la place.
+
+## Suspension
+
+Quand les joueurs sont en danger (code malveillant, clé divulguée, fuite de
+données), PlayerVox peut suspendre un widget ou une version aussitôt : les
+copies installées sont désactivées. L’espace créateurs donne le motif et la
+règle, et le recours reste ouvert.
+
+## Retrait
+
+Vous pouvez retirer une version ou le widget entier à tout moment : il sort
+du catalogue à la prochaine publication, et les copies installées
+continuent de fonctionner. Une version en revue, ou approuvée et pas encore
+publiée, est retirée tout de suite.