palabre 0.1.5 → 0.2.0

package/README.md

@@ -1,48 +1,106 @@
-# PALABRE
-
-<p>
-  <a href="https://www.npmjs.com/package/palabre"><img src="https://img.shields.io/npm/v/palabre.svg?style=flat&colorA=18181B&colorB=7C3AED" alt="Version"></a>
-  <a href="https://www.npmjs.com/package/palabre"><img src="https://img.shields.io/npm/dm/palabre.svg?style=flat&colorA=18181B&colorB=7C3AED" alt="Downloads"></a>
-  <a href="https://github.com/JuReyms/Palabre/blob/main/LICENSE"><img src="https://img.shields.io/github/license/JuReyms/Palabre.svg?style=flat&colorA=18181B&colorB=7C3AED" alt="License"></a>
-  <a href="https://palab.re"><img src="https://img.shields.io/badge/palab.re-18181B?logo=netlify&logoColor=7C3AED" alt="Website"></a>
-</p>
-
-PALABRE est un orchestrateur de debat entre agents IA installes localement : CLIs comme Codex, Claude ou OpenCode, et modeles locaux exposes par Ollama.
-
-L'objectif du projet est de permettre a un utilisateur deja a l'aise avec le terminal de faire dialoguer plusieurs assistants sur un sujet technique, sans imposer une API payante au jeton. PALABRE pilote les outils deja configures sur la machine et exporte la session en Markdown.
-
-## Etat actuel
-
-Le projet contient un premier MVP technique :
-
-- CLI Node.js/TypeScript avec `pnpm`.
-- Configuration JSON des agents.
-- Adapter CLI minimal via `child_process`.
-- Adapter Ollama via HTTP local.
-- Orchestration ping-pong avec limite de tours.
-- Arret anticipe si les agents expriment clairement un accord complet.
-- Injection explicite de fichiers texte via `--files`.
-- Selection bornee de contexte projet via `--context`.
-- Contexte de session explicite dans tous les prompts : date locale, fuseau horaire et dossier courant.
-- Rendu console pretty, avec fallback `--plain`.
-- Etat vivant pendant qu'un agent genere sa reponse.
-- Assistant interactif `palabre new` pour composer un debat pas a pas.
-- Export `.debate.md`.
-
-Le preset CLI actuel vise les modes non interactifs : `codex exec` et `claude --print`. Le prochain gros chantier reste l'adapter PTY robuste pour les vraies sessions interactives.
-
-## Prerequis
-
-- Node.js 20 ou plus.
-- pnpm 10.
-- Pour les agents CLI : les commandes visees doivent deja etre installees et authentifiees, par exemple `codex` ou `claude`.
-- Gemini CLI est aussi supporte en mode batch si `gemini` est installe et authentifie.
-- OpenCode est supporte en mode batch si `opencode` est installe et authentifie.
-- Pour Ollama : Ollama doit tourner localement, par defaut sur `http://localhost:11434`, avec le modele configure deja disponible.
-
-## Installation
-
-Quand le package npm est publie :
+# PALABRE
+
+<p>
+  <a href="https://www.npmjs.com/package/palabre"><img src="https://img.shields.io/npm/v/palabre.svg?style=flat&colorA=18181B&colorB=7C3AED" alt="Version"></a>
+  <a href="https://www.npmjs.com/package/palabre"><img src="https://img.shields.io/npm/dm/palabre.svg?style=flat&colorA=18181B&colorB=7C3AED" alt="Downloads"></a>
+  <a href="https://github.com/JuReyms/Palabre/blob/main/LICENSE"><img src="https://img.shields.io/github/license/JuReyms/Palabre.svg?style=flat&colorA=18181B&colorB=7C3AED" alt="License"></a>
+  <a href="https://palab.re"><img src="https://img.shields.io/badge/docs-palab.re-18181B?logo=netlify&logoColor=7C3AED" alt="Documentation"></a>
+</p>
+
+![PALABRE](docs/assets/palabre-logo-text-og.png)
+
+[Français](#français) | [English](#english)
+
+## Français
+
+PALABRE est un orchestrateur CLI qui fait dialoguer plusieurs agents IA installés sur votre machine : Claude Code, Codex CLI, Gemini CLI, OpenCode et Ollama.
+
+Il ne remplace pas vos outils : il les pilote. Vous gardez vos abonnements, vos modèles par défaut, vos habitudes de terminal et vos fichiers en local. PALABRE exporte ensuite le débat en Markdown.
+
+### Documentation
+
+- https://palab.re
+- https://palabre.netlify.app
+
+Pages utiles : [Installation](https://palab.re/fr/get-started/installation), [Configuration](https://palab.re/fr/get-started/configuration), [Premier débat](https://palab.re/fr/get-started/first-debate), [Référence CLI](https://palab.re/fr/reference/cli), [Dépannage](https://palab.re/fr/troubleshooting), [Roadmap](https://palab.re/fr/roadmap).
+
+### Installation
+
+Prérequis : Node.js 20 ou plus, et au moins deux agents déjà installés/authentifiés si vous voulez les faire débattre.
+
+```bash
+npm install -g palabre
+palabre --version
+palabre --help
+```
+
+### Démarrage rapide
+
+```bash
+palabre init
+palabre doctor
+palabre new
+```
+
+Exemples directs :
+
+```bash
+palabre codex-claude "Critique ce plan" -t 4
+palabre -s "Compare ces deux approches" -t 2
+palabre codex-claude "Relis cette architecture" --context src docs
+palabre claude-ollama "Critique ce fichier" --files README.md
+palabre codex-claude "Preview" --context src --show-prompt
+```
+
+### Agents supportés
+
+- Claude Code via `claude --print`
+- Codex CLI via `codex exec`
+- Gemini CLI via `gemini --prompt -`
+- OpenCode via `opencode run`
+- Ollama via l'API locale HTTP
+
+PALABRE ne liste pas les modèles : ils changent souvent et dépendent de chaque CLI ou compte utilisateur. `--model-a`, `--model-b` et `--summary-model` transmettent simplement la valeur brute à l'agent concerné.
+
+### Confidentialité
+
+PALABRE tourne localement et n'envoie aucune donnée à un serveur appartenant à PALABRE. Les données envoyées aux agents dépendent des outils que vous utilisez : vérifiez les politiques de confidentialité de Claude Code, Codex CLI, Gemini CLI, OpenCode, Ollama ou de tout autre agent configuré.
+
+### Développement local
+
+```bash
+git clone https://github.com/JuReyms/Palabre.git
+cd Palabre
+pnpm install
+pnpm build
+pnpm link --global
+palabre --version
+```
+
+Commandes utiles : `pnpm check`, `pnpm test`, `pnpm build`.
+
+Roadmap publique : [docs/guide/fr/roadmap.md](./docs/guide/fr/roadmap.md). Guide agents/contributeurs : [AGENTS.md](./AGENTS.md).
+
+### Licence
+
+MIT. Voir [LICENSE](./LICENSE).
+
+## English
+
+PALABRE is a CLI orchestrator that lets multiple AI agents installed on your machine talk to each other: Claude Code, Codex CLI, Gemini CLI, OpenCode, and Ollama.
+
+It does not replace your tools: it drives them. You keep your subscriptions, default models, terminal habits, and local files. PALABRE then exports the debate as Markdown.
+
+### Documentation
+
+- https://palab.re
+- https://palabre.netlify.app
+
+Useful pages: [Installation](https://palab.re/fr/get-started/installation), [Configuration](https://palab.re/fr/get-started/configuration), [First debate](https://palab.re/fr/get-started/first-debate), [CLI reference](https://palab.re/fr/reference/cli), [Troubleshooting](https://palab.re/fr/troubleshooting), [Roadmap](https://palab.re/fr/roadmap).
+
+### Installation
+
+Requirements: Node.js 20 or newer, and at least two already installed/authenticated agents if you want them to debate.
 
 ```bash
 npm install -g palabre
@@ -50,327 +108,53 @@ palabre --version
 palabre --help
 ```
 
-Pour tester depuis le depot source :
+### Quick Start
+
+```bash
+palabre init
+palabre doctor
+palabre new
+```
+
+Direct examples:
 
 ```bash
+palabre codex-claude "Review this plan" -t 4
+palabre -s "Compare these two approaches" -t 2
+palabre codex-claude "Review this architecture" --context src docs
+palabre claude-ollama "Review this file" --files README.md
+palabre codex-claude "Preview" --context src --show-prompt
+```
+
+### Supported Agents
+
+- Claude Code via `claude --print`
+- Codex CLI via `codex exec`
+- Gemini CLI via `gemini --prompt -`
+- OpenCode via `opencode run`
+- Ollama via the local HTTP API
+
+PALABRE does not list models: they change often and depend on each CLI or user account. `--model-a`, `--model-b`, and `--summary-model` simply pass the raw value to the selected agent.
+
+### Privacy
+
+PALABRE runs locally and does not send data to a PALABRE-owned server. Data sent to agents depends on the tools you use: check the privacy policies of Claude Code, Codex CLI, Gemini CLI, OpenCode, Ollama, or any custom agent you configure.
+
+### Local Development
+
+```bash
+git clone https://github.com/JuReyms/Palabre.git
+cd Palabre
 pnpm install
 pnpm build
 pnpm link --global
 palabre --version
-```
-
-## Configuration
-
-```bash
-palabre init
-```
-
-Cette commande cree par defaut une config globale dans `~/.palabre/palabre.config.json`. Pendant l'init, Palabre detecte `codex`, `claude`, `gemini`, `opencode` et l'API locale Ollama, puis choisit une paire par defaut detectee quand c'est possible. Le fichier d'exemple versionne est [palabre.config.example.json](./palabre.config.example.json).
-
-Resolution de config : `./palabre.config.json` est prioritaire quand il existe dans le dossier courant, puis `./chicane.config.json` en fallback legacy, puis `~/.palabre/palabre.config.json`, puis `~/.palabre/chicane.config.json`. Pour creer une config locale volontairement : `palabre init --local`.
-
-Pour verifier l'installation sans lancer de debat :
-
-```bash
-palabre doctor
-```
-
-Pour composer un premier debat pas a pas, avec les agents detectes et une commande equivalente affichee avant le lancement :
-
-```bash
-palabre new
-```
-
-Extrait de configuration :
-
-```json
-{
-  "defaults": {
-    "agentA": "codex",
-    "agentB": "claude",
-    "summaryAgent": "claude",
-    "turns": 4
-  },
-  "agents": {
-    "codex": {
-      "type": "cli",
-      "command": "codex",
-      "args": ["exec", "--skip-git-repo-check", "--color", "never", "--sandbox", "read-only", "-"],
-      "role": "implementer"
-    },
-    "ollama-local": {
-      "type": "ollama",
-      "baseUrl": "http://localhost:11434",
-      "model": "nemotron-3-nano:4b",
-      "role": "critic",
-      "validateModel": true,
-      "unloadOtherModels": true
-    }
-  }
-}
-```
-
-## Agents et roles
-
-Palabre se base sur des adapters :
-
-- `cli` : lance une commande locale, injecte le prompt, capture la sortie.
-- `ollama` : appelle l'API HTTP locale d'Ollama.
-
-Les presets CLI fournis utilisent les modes batch quand ils existent :
-
-- Codex : `codex exec ... -`, prompt via `stdin`.
-- Claude : `claude --print`, prompt via `stdin`.
-- Gemini : `gemini --prompt -`, prompt via `stdin`.
-- OpenCode : `opencode run`, prompt via `stdin`.
-
-Sur Windows, les wrappers npm comme `codex`, `gemini` et `opencode` peuvent necessiter `"shell": true` dans la config agent. Claude fonctionne mieux via `claude.exe` avec `"shell": false`.
-
-Les roles documentent l'intention de l'agent dans le debat et ajoutent une consigne de role dans chaque prompt :
-
-- `implementer` : propose une solution concrete.
-- `reviewer` ou `critic` : cherche les risques, angles morts et contradictions.
-- `architect` : arbitre ou structure une direction technique.
-- `scout` : explore rapidement un sujet.
-- `summarizer` : produit une synthese.
-
-Ollama est pense par defaut comme `critic`, `scout` ou `summarizer`, car les machines utilisateur font souvent tourner des modeles modestes. Un utilisateur peut quand meme le promouvoir en agent principal dans sa config.
-
-## Lancer un debat
-
-Mode guide :
-
-```bash
-palabre new
-```
-
-Mode direct :
-
-```bash
-palabre run --subject "Refacto de l'auth Nuxt" --agent-a codex --agent-b claude --turns 4
-```
-
-Autres exemples :
-
-```bash
-palabre run --subject "Comparer deux strategies de cache" --agent-a claude --agent-b codex
-palabre run --subject "Critique rapide du plan de migration" --agent-a codex --agent-b ollama-local --turns 2
-```
-
-Presets disponibles :
-
-```bash
-palabre run --preset codex-claude --subject "Debattez du prochain jalon"
-palabre run --preset claude-ollama --subject "Critique le MVP batch"
-palabre run --preset gemini-ollama --subject "Gemini est-il un bon reviewer ?"
-palabre run --preset claude-opencode --subject "OpenCode comme reviewer ?"
-```
-
-Syntaxe courte equivalente :
-
-```bash
-palabre claude-gemini "quel jour sommes nous ?" -t 4
-palabre -s "Critique rapide du MVP" -t 2
-```
-
-`--subject` est le nom long recommande pour le sujet. `-s` est son alias court, et `--topic` reste accepte pour compatibilite.
-
-Un preset choisit seulement les deux agents. Il ne change pas les modeles par defaut configures dans les CLIs. Pour demander un modele explicitement, Palabre transmet la string brute sans valider ni lister les modeles :
-
-```bash
-palabre run --preset codex-claude --model-a 5.5 --model-b opus --subject "Compare les approches"
-palabre run --preset codex-ollama --model-b gemma4:e4b --subject "Critique locale plus profonde"
-```
-
-Pour Ollama, Palabre valide par defaut que le modele est installe localement. Il ne telecharge rien sans accord explicite. Pour autoriser un telechargement Ollama si le modele manque :
-
-```bash
-palabre run --preset codex-ollama --model-b nemotron-3-nano:4b --pull-models --subject "Critique locale"
-```
-
-Equivalent dans la config agent :
-
-```json
-{
-  "type": "ollama",
-  "model": "nemotron-3-nano:4b",
-  "autoPullModel": true
-}
-```
-
-Pour inspecter le prompt du premier tour sans appeler d'agent :
-
-```bash
-palabre run --preset codex-claude --subject "Preview" --context src docs --show-prompt
-```
-
-Pour mettre a jour une installation locale :
-
-```bash
-palabre update
-palabre update --apply
-```
-
-`palabre update` affiche les etapes adaptees. `--apply` les execute seulement si Palabre est installe depuis un checkout git.
-
-Par defaut, Palabre produit une synthese finale avec `defaults.summaryAgent` si ce champ est configure, sinon avec l'agent B. Tu peux choisir un autre agent, un modele specifique, ou desactiver la synthese :
-
-```bash
-palabre run --preset codex-claude --subject "Critique le MVP" --summary-agent claude
-palabre run --preset codex-claude --subject "Critique le MVP" --summary-agent ollama-local --summary-model nemotron-3-nano:4b
-palabre run --preset codex-claude --subject "Critique le MVP" --no-summary
-```
-
-Le rendu console est un premier TUI leger : en-tete, separateurs, tours, synthese lisible et etat "agent en cours" pendant les generations longues. Pour revenir au rendu brut :
-
-```bash
-palabre run --preset codex-claude --subject "Critique le MVP" --plain
-```
-
-Les couleurs sont automatiquement desactivees si `NO_COLOR` est defini.
-
-La session genere un fichier `.debate.md` dans le dossier configure par `outputDir`. L'en-tete de l'export est rendu en table Markdown pour rester lisible dans les renderers courants.
-
-`--turns` est une limite haute entre 1 et 20 réponses. Par defaut, Palabre peut s'arreter avant la limite apres un tour complet si le dernier agent exprime clairement un accord complet (`rien a trancher`, `accord complet`, `aucun desaccord`, etc.). Pour forcer tous les tours :
-
-```bash
-palabre run --subject "Sujet" --turns 4 --no-early-stop
-```
-
-## Contexte projet
-
-Palabre distingue deux modes de contexte :
-
-- `--files` : selection explicite et stricte de fichiers texte.
-- `--context` : scan tolerant de fichiers ou dossiers texte avec exclusions et warnings.
-
-`--files` est utile quand tu sais exactement quels fichiers doivent etre envoyes :
-
-```bash
-palabre run --subject "Critique le MVP batch" --files README.md src/adapters/cli.ts --agent-a claude --agent-b ollama-local --turns 2
-```
-
-Si un chemin `--files` pointe vers un dossier, un fichier binaire ou un fichier trop gros, Palabre arrete la commande avec une erreur claire.
-
-`--context` est utile pour donner une vue projet plus large sans tout envoyer aveuglement :
-
-```bash
-palabre run --preset codex-ollama --subject "Critique l'architecture" --context src docs --turns 2
-palabre run --preset codex-claude --subject "Preview contexte" --context . --show-prompt
-```
-
-Le scan `--context` :
-
-- parcourt recursivement les dossiers passes ;
-- ignore par defaut `.git`, `.gitignore`, `.tmp`, `.pnpm-store`,
-ode_modules` et `dist` ;
-- applique les regles simples de `.gitignore` du projet ;
-- garde seulement les extensions texte connues (`.ts`, `.md`, `.json`, `.yaml`, etc.) ;
-- ignore les fichiers binaires, trop gros ou au-dela de la limite totale avec un warning.
-
-Les fichiers retenus, qu'ils viennent de `--files` ou de `--context`, sont envoyes a tous les agents, y compris Ollama. Ils sont aussi listes dans l'export `.debate.md`.
-
-Palabre injecte aussi un contexte de session minimal dans tous les prompts :
-
-- date locale ;
-- fuseau horaire ;
-- dossier courant ;
-- horodatage de debut de session.
-
-Ce contexte est fourni par Palabre et visible par tous les agents du debat. Il evite que Codex, Claude, Gemini, OpenCode ou Ollama se contredisent sur des informations implicites comme la date ou le fuseau horaire.
-
-Les agents CLI sont lances depuis le dossier courant. Selon leur propre fonctionnement et leurs permissions, Codex, Claude, Gemini ou OpenCode peuvent donc inspecter le workspace par leurs outils internes. Ce comportement depend de chaque CLI et ne doit pas etre considere comme un contrat garanti par Palabre.
-
-Ollama ne lit pas le filesystem par lui-meme. L'adapter Ollama recoit uniquement le prompt construit par Palabre : sujet, role, instructions, fichiers retenus par `--files` ou `--context`, et historique du debat. Si aucun contexte n'est passe, Ollama ne voit pas le contenu du projet.
-
-Limites actuelles :
-
-- chaque fichier est limite a 64 KiB ;
-- le contexte total est limite a 192 KiB ;
-- les fichiers binaires sont refuses avec `--files` et ignores avec warning via `--context` ;
-- le support `.gitignore` reste volontairement simple pour le MVP.
-
-## Scripts
-
-```bash
-pnpm check
-pnpm test
-pnpm build
-palabre help
-palabre -h
-palabre -v
-```
-
-## Validation locale actuelle
-
-Tests effectues sur Windows :
-
-- `ollama ↔ ollama` avec `gemma4:e4b` : OK.
-- `codex exec ↔ ollama` : OK.
-- `claude --print ↔ ollama` : OK avec `claude.exe` et `"shell": false`.
-- `gemini --prompt - ↔ ollama` : OK.
-- `opencode run` via Palabre : OK en debat reel 1 tour avec export.
-- `codex exec ↔ claude --print` : OK.
-- `--show-prompt` avec `--files` : OK.
-- `--show-prompt` avec `--context docs` : OK.
-- contexte de session visible dans `--show-prompt` : OK.
-- arret anticipe sur accord clair : OK.
-- syntaxe courte `palabre preset "sujet" -t 4` et `palabre -s "sujet" -t 2` : OK.
-- smoke tests automatises de l'adapter CLI avec agents mockes : OK.
-- detection des limites d'usage CLI type Codex/Claude/Gemini/OpenCode : OK par simulation stderr.
-- `init` avec detection locale des agents : OK.
-- config globale `~/.palabre/palabre.config.json` avec fallback local/legacy : OK.
-- en-tete des exports `.debate.md` en table Markdown : OK.
-- `update` en mode instructions : OK.
-- etat "agent en cours" pendant les generations : OK.
-- synthese finale avec `defaults.summaryAgent`, fallback agent B : OK.
-- `--no-summary` : OK.
-- rendu console pretty et `--plain` : OK.
-
-Reglages importants observes :
-
-- Codex via le wrapper npm Windows necessite `"shell": true`.
-- Gemini via le wrapper npm Windows fonctionne avec `"shell": true` et `--prompt -`.
-- OpenCode via le wrapper PowerShell/npm Windows fonctionne avec `"shell": true` et `opencode run`.
-- Claude capture correctement `stdin` avec `command: "claude.exe"` et `"shell": false`.
-- `idleTimeoutMs` ne doit pas etre active par defaut pour les CLIs IA en batch, car elles peuvent rester silencieuses pendant la generation.
-
-## Limites connues
-
-- L'adapter CLI actuel est volontairement minimal. Il marche mieux avec des commandes non interactives ou des CLIs qui acceptent un prompt via `stdin`.
-- `palabre init` detecte les outils locaux et ajuste seulement les defaults ; les blocs agents exemples restent dans la config pour faciliter l'edition.
-- La resolution de config cherche `./palabre.config.json`, `./chicane.config.json`, `~/.palabre/palabre.config.json`, puis `~/.palabre/chicane.config.json` dans cet ordre.
-- Sans config existante, Palabre cree la config globale et quitte ; il n'ecrit plus automatiquement dans le dossier courant. `palabre init --local` force une config locale.
-- Les adapters exposent un contrat (`capabilities` et `guarantees`) pour documenter timeout, sortie vide, stderr, exit code, model override, filesystem et streaming.
-- Les erreurs CLI de limite d'usage ou de quota sont detectees dans stderr et reformatees sans recopier tout le prompt.
-- `--files` est explicite et strict ; `--context` scanne des dossiers texte de facon bornee et best-effort.
-- `--show-prompt` affiche le prompt exact du premier tour seulement. Les tours suivants dependent du transcript reel.
-- `--turns` est une limite haute quand l'arret anticipe est actif ; `--no-early-stop` force tous les tours demandes.
-- `--model-a` et `--model-b` transmettent une string brute aux adapters ; Palabre ne maintient pas de catalogue de modeles.
-- L'adapter Ollama detecte les modeles installes via `/api/tags` quand `validateModel` est actif.
-- L'adapter Ollama peut telecharger un modele manquant via `/api/pull` seulement si `--pull-models` ou `autoPullModel` est actif.
-- L'adapter Ollama decharge les autres modeles charges via `/api/ps` puis `keep_alive: 0` quand `unloadOtherModels` est actif.
-- Palabre affiche un warning si Ollama participe sans contexte fourni, car Ollama ne lit pas le filesystem.
-- La synthese finale est activee par defaut et utilise `defaults.summaryAgent` quand il existe, sinon l'agent B. `--summary-agent` garde la priorite, et `--no-summary` la desactive.
-- Le rendu console pretty est volontairement leger. Il affiche deja l'agent en cours, mais le split-view, le scrolling interactif et l'input humain arriveront avec le vrai TUI.
-- Une sortie CLI vide est consideree comme une erreur, sauf si `allowEmptyOutput` est active explicitement.
-- `idleTimeoutMs` doit etre utilise avec prudence : les CLIs IA peuvent rester silencieuses pendant la generation.
-- Les CLIs interactives auront besoin d'un vrai PTY, probablement via
-ode-pty`.
-- La detection de fin de reponse est encore heuristique avec `idleTimeoutMs`.
-- La TUI et l'extension VS Code sont prevues apres stabilisation du coeur CLI.
-
-## Documentation projet
-
-Site de documentation : **https://palab.re** (aussi accessible sur https://palabre.netlify.app)
-
-- Roadmap : [docs/roadmap.md](./docs/roadmap.md)
-- Introduction : [docs/guide/get-started/introduction.md](./docs/guide/get-started/introduction.md)
-- Installation : [docs/guide/get-started/installation.md](./docs/guide/get-started/installation.md)
-- Premiere configuration : [docs/guide/get-started/configuration.md](./docs/guide/get-started/configuration.md)
-- Premier debat : [docs/guide/get-started/first-debate.md](./docs/guide/get-started/first-debate.md)
-- Reference CLI : [docs/guide/reference/cli.md](./docs/guide/reference/cli.md)
-- Depannage : [docs/guide/troubleshooting.md](./docs/guide/troubleshooting.md)
-- Roadmap utilisateur : [docs/guide/roadmap.md](./docs/guide/roadmap.md)
-- Guide agents/contributeurs : [AGENTS.md](./AGENTS.md)
-- Archive de specification initiale : [docs/archive/Palabre-Specification.md](./docs/archive/Palabre-Specification.md)
+```
+
+Useful commands: `pnpm check`, `pnpm test`, `pnpm build`.
+
+Public roadmap: [docs/guide/fr/roadmap.md](./docs/guide/fr/roadmap.md). Agent/contributor guide: [AGENTS.md](./AGENTS.md).
+
+### License
+
+MIT. See [LICENSE](./LICENSE).