@agent-native/core 0.100.2 → 0.101.2

package/corpus/core/docs/content/locales/es-ES/pr-visual-recap.mdx

@@ -102,13 +102,13 @@ explícitamente en cualquier momento:
 npx @agent-native/core@latest skills add visual-plan --with-github-action
 ```
 
-Esto instala la habilidad `visual-plan` (que incluye la habilidad `visual-recap` que ejecuta la acción) y escribe `.github/workflows/pr-visual-recap.yml` en su repositorio. El flujo de trabajo llama a **subcomandos CLI publicados** a través de `npx @agent-native/core@latest recap <subcommand>`, incluidos `gate`, `collect-diff`, `block-reference`, `scan`, `build-prompt`, `publish`, `shot`, `comment`, `check` y `usage`, por lo que no se copia nada en su repositorio como scripts de ayuda. `setup` y `doctor` son los ayudantes interactivos que ejecuta localmente; `gate` es el paso de seguridad que ejecuta el flujo de trabajo antes de cada resumen.
+Esto instala la habilidad `visual-plan` (que incluye la habilidad `visual-recap` que ejecuta la acción) y escribe `.github/workflows/pr-visual-recap.yml` en su repositorio. El flujo de trabajo llama a **subcomandos CLI publicados** a través de `npx @agent-native/recap-cli@latest recap <subcommand>`, incluidos `gate`, `collect-diff`, `block-reference`, `scan`, `build-prompt`, `publish`, `shot`, `comment`, `check` y `usage`, por lo que no se copia nada en su repositorio como scripts de ayuda. `setup` y `doctor` son los ayudantes interactivos que ejecuta localmente; `gate` es el paso de seguridad que ejecuta el flujo de trabajo antes de cada resumen.
 
 Luego ejecute el asistente de configuración guiada:
 
 ```bash
-npx @agent-native/core@latest recap setup
-npx @agent-native/core@latest recap doctor
+npx @agent-native/recap-cli@latest recap setup
+npx @agent-native/recap-cli@latest recap doctor
 ```
 
 `recap setup` actualiza el flujo de trabajo, usa `gh` para configurar GitHub Actions
@@ -118,7 +118,7 @@ conjunto. Los valores secretos se envían a `gh` a través de la entrada estánd
 el archivo de flujo de trabajo generado y abra un PR para verlo ejecutar.
 
 De forma predeterminada, el flujo de trabajo crea el mensaje del agente a partir del último paquete
-Guía de `visual-recap` en `@agent-native/core@latest`, incluido cualquier hermano
+Guía de `visual-recap` en `@agent-native/recap-cli@latest`, incluido cualquier hermano
 archivos de referencia con los que se envía la habilidad. Si su repositorio personaliza intencionalmente y
 fija su carpeta `visual-recap` comprometida, establece la variable del repositorio
 `VISUAL_RECAP_SKILL_SOURCE=repo`.
@@ -135,8 +135,8 @@ De forma predeterminada, el flujo de trabajo se ejecuta en ejecutores `ubuntu-la
 Las comillas JSON son obligatorias. Este valor selecciona el ejecutor del trabajo completo `recap`. Para configurarlo durante la instalación guiada, pase el mismo valor JSON a `--runs-on` y después valide el flujo de trabajo y la disponibilidad del ejecutor con `doctor`:
 
 ```bash
-npx @agent-native/core@latest recap setup --runs-on '["self-hosted","linux","x64","visual-recap"]'
-npx @agent-native/core@latest recap doctor
+npx @agent-native/recap-cli@latest recap setup --runs-on '["self-hosted","linux","x64","visual-recap"]'
+npx @agent-native/recap-cli@latest recap doctor
 ```
 
 La barrera ligera usa `ubuntu-latest` por separado. Los repositorios sin ejecutores alojados por GitHub pueden establecer `VISUAL_RECAP_GATE_RUNS_ON` en una sola etiqueta de texto sin JSON, o usar `--gate-runs-on visual-recap-gate`. La etiqueta personalizada solo se usa para autores `OWNER`, `MEMBER` o `COLLABORATOR` del mismo repositorio; los forks y demás autores se fuerzan a `ubuntu-latest` y pueden quedar sin programar si los ejecutores alojados están desactivados. Use un ejecutor dedicado y, preferiblemente, efímero: la barrera estándar no descarga el árbol del PR y evalúa la lógica del flujo de trabajo y los metadatos del PR.
@@ -160,12 +160,30 @@ Si la variable no está configurada, la acción utiliza `claude`.
 
 Más allá del backend, dos variables del repositorio ajustan _cómo_ se ejecuta el agente:
 
-- **`VISUAL_RECAP_MODEL`** fija el modelo pasado al CLI (`--model`), por ejemplo, `gpt-5.6-sol` para Codex o una identificación de modelo Claude. Déjelo sin configurar para usar el modelo predeterminado del CLI.
+- **`VISUAL_RECAP_MODEL`** fija el modelo pasado al CLI (`--model`) — por ejemplo, `gpt-5.6-luna` para Codex, una identificación de modelo Claude, o `deepseek-chat` para DeepSeek. Es obligatorio para `openai-compatible`. Para el backend **Claude**, dejarlo sin configurar ahora utiliza `claude-sonnet-5` de forma predeterminada; configure la variable explícitamente para usar un modelo Claude diferente, como el más económico `claude-haiku-4-5`. Para el backend **Codex**, dejarlo sin configurar utiliza el modelo predeterminado propio del CLI de Codex.
 - **`VISUAL_RECAP_REASONING`** establece la profundidad del razonamiento: `none`, `minimal`, `low`, `medium`, `high` o `xhigh`. Se aplica al backend Codex; El razonamiento de Claude se basa en modelos, por lo que esta variable se ignora allí.
 - **`VISUAL_RECAP_SKILL_SOURCE`** controla la actualización de los mensajes: `auto`/unset utiliza la guía de habilidades incluida más reciente, mientras que `repo` se fija a la carpeta de habilidades `visual-recap` local del repositorio comprometido.
 
 Por ejemplo, para ejecutar el resumen en Codex con GPT-5.6 Sol en razonamiento alto, configure las variables del repositorio `VISUAL_RECAP_AGENT=codex`, `VISUAL_RECAP_MODEL=gpt-5.6-sol` y `VISUAL_RECAP_REASONING=high`.
 
+## Costo
+
+Cada ejecución de resumen es una sesión completa de agente de codificación que lee un diff real, no un resumen barato basado en plantillas, por lo que su costo depende de la elección del modelo y de la frecuencia con la que se ejecuta:
+
+- **Una sesión completa por cada push al PR.** El disparador predeterminado se activa en `synchronize`, por lo que un PR al que se le hacen diez pushes ejecuta el agente diez veces.
+- **Todo el PR cada vez**, no solo los commits desde la última ejecución — el costo escala con el tamaño total del PR, no con el tamaño incremental del diff.
+- **Entrada de diff limitada a ~600KB.** Esto acota el peor caso por ejecución, pero los diffs grandes siguen costando considerablemente más que los pequeños.
+- **Un reintento automático en caso de fallo**, que puede aproximadamente duplicar el costo de una ejecución que falla de forma transitoria.
+
+Para reducir el costo:
+
+- **Fije un modelo más económico.** Para Claude, configure `VISUAL_RECAP_MODEL=claude-haiku-4-5` para repositorios simples o pequeños — es el nivel más económico de Claude; `claude-sonnet-5` (el predeterminado) es el nivel equilibrado.
+- **Cambie a Codex con un modelo más económico.** Configure `VISUAL_RECAP_AGENT=codex` con `VISUAL_RECAP_MODEL=gpt-5.6-luna` (el nivel más económico de GPT-5.6) o `gpt-5.6-terra` (nivel intermedio), y configure `VISUAL_RECAP_REASONING=low` para reducir aún más el gasto en tokens de razonamiento. La profundidad de razonamiento solo se aplica a Codex.
+- **Apunte a un proveedor compatible con OpenAI más económico.** Configure `VISUAL_RECAP_AGENT=openai-compatible` con `VISUAL_RECAP_BASE_URL`/`VISUAL_RECAP_MODEL`/`VISUAL_RECAP_API_KEY` apuntando a DeepSeek, Kimi o cualquier otro endpoint compatible con OpenAI.
+- **Resuma con menos frecuencia.** Edite el `on.pull_request.types` del flujo de trabajo instalado de `[opened, synchronize, reopened, ready_for_review, closed]` a `[opened, ready_for_review, closed]` para que solo genere resúmenes cuando un PR se abre y cuando se fusiona, en lugar de en cada push.
+
+Cada ejecución registra lo que realmente gastó: el paso `recap usage` del flujo de trabajo adjunta el uso de tokens y costo al plan publicado, para que pueda ver el gasto real por ejecución en lugar de adivinar.
+
 ## Secretos y variables
 
 Configúrelos en **Configuración → Secretos y variables → Actions** de su repositorio.
@@ -196,11 +214,11 @@ Aplicación de planes.
 
 **Solo: un token personal todavía funciona.** Acuñalo con `npx @agent-native/core@latest connect`
 contra tu aplicación de Planes. Para la aplicación alojada, esto también escribe un local
-archivo de token de publicación que `npx @agent-native/core@latest recap setup` puede leer:
+archivo de token de publicación que `npx @agent-native/recap-cli@latest recap setup` puede leer:
 
 ```bash
 npx @agent-native/core@latest connect https://plan.agent-native.com --client codex
-npx @agent-native/core@latest recap setup
+npx @agent-native/recap-cli@latest recap setup
 ```
 
 Si prefiere la configuración manual, pegue el token en el secreto GitHub. Utilice un
@@ -209,16 +227,16 @@ token real.
 
 ### Opcional (solo si cambia los valores predeterminados)
 
-| Secreto/variable         | Predeterminado                      | Cuando lo necesites                                                                                                                                   |
-| ------------------------ | ----------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `OPENAI_API_KEY`         | —                                   | Secreto. Configúrelo junto con `VISUAL_RECAP_AGENT=codex` para ejecutar el resumen con Codex.                                                         |
-| `VISUAL_RECAP_AGENT`     | `claude`                            | Variable. Selecciona el backend del agente de codificación (`claude` o `codex`).                                                                      |
-| `VISUAL_RECAP_MODEL`     | el valor predeterminado de cada CLI | Variable. Fija el modelo, p.e. `gpt-5.6-sol` para Codex, o una identificación de modelo Claude. Unset utiliza el valor predeterminado del CLI.        |
-| `VISUAL_RECAP_REASONING` | valor predeterminado de cada modelo | Variable. Profundidad de razonamiento: `none`, `minimal`, `low`, `medium`, `high` o `xhigh`. Se aplica al backend Codex.                              |
-| `RECAP_CLI_VERSION`      | `latest`                            | Variable. Fija la versión `@agent-native/core` CLI que instala el flujo de trabajo, p. `1.5.0`. Ver [Version pinning](#version-pinning-copy-variant). |
-| `PLAN_RECAP_APP_URL`     | `https://plan.agent-native.com`     | Secreto. Solo cuando se aloja la aplicación Planes en un origen diferente.                                                                            |
+| Secreto/variable         | Predeterminado                                                        | Cuando lo necesites                                                                                                                                                                                                                                                                                                                                                |
+| ------------------------ | --------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| `OPENAI_API_KEY`         | —                                                                     | Secreto. Configúrelo junto con `VISUAL_RECAP_AGENT=codex` para ejecutar el resumen con Codex.                                                                                                                                                                                                                                                                      |
+| `VISUAL_RECAP_AGENT`     | `claude`                                                              | Variable. Selecciona el backend del agente de codificación (`claude` o `codex`).                                                                                                                                                                                                                                                                                   |
+| `VISUAL_RECAP_MODEL`     | `claude-sonnet-5` para Claude; obligatorio para el backend compatible | Variable. Identificación del modelo del proveedor para backends compatibles con OpenAI (obligatoria allí). Para Claude, sin configurar ahora usa `claude-sonnet-5` de forma predeterminada — configúrelo para anularlo, p. ej. `claude-haiku-4-5` para el nivel más económico. Para Codex, sin configurar utiliza el valor predeterminado propio del CLI de Codex. |
+| `VISUAL_RECAP_REASONING` | valor predeterminado de cada modelo                                   | Variable. Profundidad de razonamiento: `none`, `minimal`, `low`, `medium`, `high` o `xhigh`. Se aplica al backend Codex.                                                                                                                                                                                                                                           |
+| `RECAP_CLI_VERSION`      | `latest`                                                              | Variable. Fija la versión `@agent-native/recap-cli` CLI que instala el flujo de trabajo, p. `1.5.0`. Ver [Version pinning](#version-pinning-copy-variant).                                                                                                                                                                                                         |
+| `PLAN_RECAP_APP_URL`     | `https://plan.agent-native.com`                                       | Secreto. Solo cuando se aloja la aplicación Planes en un origen diferente.                                                                                                                                                                                                                                                                                         |
 
-El flujo de trabajo detecta automáticamente cómo invocar su asistente CLI (fuente local dentro de este monorepo, el `@agent-native/core` publicado en otro lugar), por lo que no hay ninguna variable `RECAP_CLI` para configurar.
+El flujo de trabajo detecta automáticamente cómo invocar su asistente CLI (fuente local dentro de este monorepo, el `@agent-native/recap-cli` publicado en otro lugar), por lo que no hay ninguna variable `RECAP_CLI` para configurar.
 
 ## Captura de pantalla en línea en el comentario
 
@@ -359,9 +377,9 @@ recapitular sin enviar el contenido del resumen a la base de datos del plan Agen
 en su lugar, el mismo flujo de ayuda local en modo de archivos locales:
 
 ```bash
-npx @agent-native/core@latest recap collect-diff --base main --head HEAD --out recap.diff --stat recap.stat
-npx @agent-native/core@latest recap scan --diff recap.diff
-npx @agent-native/core@latest recap build-prompt --pr 123 --diff recap.diff --stat recap.stat --local-files --local-dir plans/pr-123-visual-recap
+npx @agent-native/recap-cli@latest recap collect-diff --base main --head HEAD --out recap.diff --stat recap.stat
+npx @agent-native/recap-cli@latest recap scan --diff recap.diff
+npx @agent-native/recap-cli@latest recap build-prompt --pr 123 --diff recap.diff --stat recap.stat --local-files --local-dir plans/pr-123-visual-recap
 ```
 
 Entregue el `recap-prompt.md` generado a su agente codificador. En modo de archivos locales
@@ -391,7 +409,7 @@ El resumen es una ayuda de revisión que se suma al flujo normal de relaciones p
 
 ## Fijación de versión (variante de copia) {#version-pinning-copy-variant}
 
-De forma predeterminada, el flujo de trabajo de variante de copia instala `@agent-native/core@latest` en tiempo de ejecución, de modo que cada ejecución de resumen selecciona automáticamente el CLI más reciente. Si su CI necesita herramientas reproducibles, configure la variable de repositorio **`RECAP_CLI_VERSION`** para fijar la versión instalada:
+De forma predeterminada, el flujo de trabajo de variante de copia instala `@agent-native/recap-cli@latest` en tiempo de ejecución, de modo que cada ejecución de resumen selecciona automáticamente el CLI más reciente. Si su CI necesita herramientas reproducibles, configure la variable de repositorio **`RECAP_CLI_VERSION`** para fijar la versión instalada:
 
 1. Vaya a **Configuración → Secretos y variables → Actions → Variables** de su repositorio.
 2. Cree una variable llamada `RECAP_CLI_VERSION` con un valor como `1.5.0`.
@@ -402,7 +420,7 @@ Para la variante de llamada reutilizable, utilice la entrada `cli-version` (cons
 
 ## Lista permitida de escaneo secreto
 
-Antes de publicar un resumen, el flujo de trabajo ejecuta `npx @agent-native/core@latest recap scan` para detectar posibles secretos en la diferencia. Cualquier PR cuya diferencia coincida con un patrón secreto conocido se bloquea con un comentario explicativo: el resumen no se publica y no se envía ningún contenido de diferencia al agente codificador.
+Antes de publicar un resumen, el flujo de trabajo ejecuta `npx @agent-native/recap-cli@latest recap scan` para detectar posibles secretos en la diferencia. Cualquier PR cuya diferencia coincida con un patrón secreto conocido se bloquea con un comentario explicativo: el resumen no se publica y no se envía ningún contenido de diferencia al agente codificador.
 
 En casos excepcionales, un repositorio tiene dispositivos de prueba intencionales o cadenas no secretas que superficialmente se parecen a patrones secretos (por ejemplo, una clave de dispositivo en un archivo de prueba). Para suprimir un falso positivo, cree `.github/recap-scan-allowlist` en la raíz de su repositorio.
 
@@ -436,7 +454,7 @@ La lista de permitidos solo la consulta la puerta de escaneo secreto. No afecta
 
 ### ¿Por qué utilizar la variante reutilizable?
 
-El instalador predeterminado copia el flujo de trabajo completo de ~360 líneas YAML en su repositorio (la opción **copiar**). Esta es la opción correcta para repositorios aislados o repositorios que necesitan auditar cada línea de lo que se ejecuta. La desventaja es que las correcciones de errores y las mejoras nunca llegan a usted: debe volver a ejecutar `npx @agent-native/core@latest recap setup` manualmente después de cada versión.
+El instalador predeterminado copia el flujo de trabajo completo de ~360 líneas YAML en su repositorio (la opción **copiar**). Esta es la opción correcta para repositorios aislados o repositorios que necesitan auditar cada línea de lo que se ejecuta. La desventaja es que las correcciones de errores y las mejoras nunca llegan a usted: debe volver a ejecutar `npx @agent-native/recap-cli@latest recap setup` manualmente después de cada versión.
 
 En su lugar, la opción **reutilizable** escribe una persona que llama delgada de ~20 líneas. Delega a `BuilderIO/agent-native/.github/workflows/pr-visual-recap-reusable.yml` vía `uses:`. Cada persona que llama selecciona automáticamente la lógica más reciente cuando se ejecuta el flujo de trabajo, sin necesidad de actualización local.
 
@@ -449,7 +467,7 @@ En su lugar, la opción **reutilizable** escribe una persona que llama delgada d
 
 ### Fragmento de la persona que llama
 
-Esto es lo que escribe `npx @agent-native/core@latest recap setup --reusable` (o puedes pegarlo manualmente):
+Esto es lo que escribe `npx @agent-native/recap-cli@latest recap setup --reusable` (o puedes pegarlo manualmente):
 
 ```yaml
 name: PR Visual Recap
@@ -484,7 +502,7 @@ jobs:
       skill-source: ${{ vars.VISUAL_RECAP_SKILL_SOURCE || 'auto' }}
       runs-on: ${{ vars.VISUAL_RECAP_RUNS_ON || '"ubuntu-latest"' }}
       gate-runs-on: ${{ vars.VISUAL_RECAP_GATE_RUNS_ON || 'ubuntu-latest' }}
-      # cli-version: "latest"  # pin to a specific @agent-native/core version
+      # cli-version: "latest"  # pin to a specific @agent-native/recap-cli version
 ```
 
 Se aplican los mismos secretos y variables descritos en [Secrets and variables](#secrets-and-variables); configúrelos como en la variante de copia. El llamador reutilizable reenvía `VISUAL_RECAP_RUNS_ON` como `runs-on` para el trabajo completo y `VISUAL_RECAP_GATE_RUNS_ON` como la etiqueta simple `gate-runs-on` para la barrera. Ambos conservan `ubuntu-latest` cuando se omiten.
@@ -493,15 +511,15 @@ Se aplican los mismos secretos y variables descritos en [Secrets and variables](
 
 ```bash
 # Escriba la persona que llama en lugar de la copia completa:
-npx @agent-native/core@latest recap setup --reusable
+npx @agent-native/recap-cli@latest recap setup --reusable
 
 # O con una referencia fijada para mayor reproducibilidad:
-npx @agent-native/core@latest recap setup --reusable --ref v1.2.3
+npx @agent-native/recap-cli@latest recap setup --reusable --ref v1.2.3
 ```
 
 Ambas variantes escriben el flujo de trabajo en `.github/workflows/pr-visual-recap.yml`. Si ya existe un flujo de trabajo existente y es diferente, el comando lo rechaza y le indica que pase `--force` para sobrescribirlo.
 
-Después de escribir, ejecute `npx @agent-native/core@latest recap doctor` como de costumbre para confirmar que los secretos estén configurados.
+Después de escribir, ejecute `npx @agent-native/recap-cli@latest recap doctor` como de costumbre para confirmar que los secretos estén configurados.
 
 ### Fijar versión
 
@@ -511,7 +529,7 @@ De forma predeterminada, la persona que llama hace referencia a `@main`, que sie
 uses: BuilderIO/agent-native/.github/workflows/pr-visual-recap-reusable.yml@v1.2.3
 ```
 
-La entrada `cli-version` controla qué versión de `@agent-native/core` CLI se ejecuta dentro del flujo de trabajo; déjela en `"latest"` para realizar un seguimiento de la versión más reciente o fíjela a una cadena de versión (por ejemplo, `"1.5.0"`) para una reproducibilidad total.
+La entrada `cli-version` controla qué versión de `@agent-native/recap-cli` CLI se ejecuta dentro del flujo de trabajo; déjela en `"latest"` para realizar un seguimiento de la versión más reciente o fíjela a una cadena de versión (por ejemplo, `"1.5.0"`) para una reproducibilidad total.
 
 ### contexto del evento workflow_call
 

package/corpus/core/docs/content/locales/es-ES/template-plan.mdx

@@ -212,6 +212,20 @@ Si el primer pase todavía tiene decisiones responsables, el agente puede coloca
 Formulario **Preguntas abiertas** en la parte inferior del mismo plan. Responderlo y enviar
 El agente inicia un turno de revisión contra el plan existente.
 
+## Costo y elección de modelo
+
+Generar un plan o un resumen ejecuta una sesión completa de agente frente al LLM
+de su agente de codificación, no un simple relleno de plantilla ligero, por lo que
+el costo escala con el tamaño del diff o del plan y con el modelo que elija.
+
+- El modelo de chat predeterminado de la propia aplicación es Sonnet 5; cámbielo
+  en cualquier momento en **Configuración**. Haiku es la opción más económica de
+  Claude, y Luna es la opción más económica dentro de la familia GPT-5.6.
+- Los resúmenes de PR automatizados de la GitHub Action se ejecutan por separado
+  de la aplicación interactiva y tienen sus propios controles de modelo y costo;
+  consulte [PR Visual Recap](/docs/pr-visual-recap) para `VISUAL_RECAP_MODEL`,
+  `VISUAL_RECAP_AGENT` y `VISUAL_RECAP_REASONING`.
+
 ## Qué puedes hacer con él
 
 - **Revisión antes de la implementación.** React a diagramas, estructuras alámbricas, pestañas de opciones,

package/corpus/core/docs/content/locales/fr-FR/pr-visual-recap.mdx

@@ -102,13 +102,13 @@ explicitement à tout moment :
 npx @agent-native/core@latest skills add visual-plan --with-github-action
 ```
 
-Cela installe la compétence `visual-plan` (qui inclut la compétence `visual-recap` exécutée par l'action) et écrit `.github/workflows/pr-visual-recap.yml` dans votre dépôt. Le flux de travail appelle **les sous-commandes CLI publiées** via `npx @agent-native/core@latest recap <subcommand>` — notamment `gate`, `collect-diff`, `block-reference`, `scan`, `build-prompt`, `publish`, `shot`, `comment`, `check` et `usage` — afin que rien ne soit copié dans votre dépôt en tant que scripts d'assistance. `setup` et `doctor` sont les assistants interactifs que vous exécutez localement ; `gate` est l'étape de sécurité que le flux de travail exécute avant chaque récapitulatif.
+Cela installe la compétence `visual-plan` (qui inclut la compétence `visual-recap` exécutée par l'action) et écrit `.github/workflows/pr-visual-recap.yml` dans votre dépôt. Le flux de travail appelle **les sous-commandes CLI publiées** via `npx @agent-native/recap-cli@latest recap <subcommand>` — notamment `gate`, `collect-diff`, `block-reference`, `scan`, `build-prompt`, `publish`, `shot`, `comment`, `check` et `usage` — afin que rien ne soit copié dans votre dépôt en tant que scripts d'assistance. `setup` et `doctor` sont les assistants interactifs que vous exécutez localement ; `gate` est l'étape de sécurité que le flux de travail exécute avant chaque récapitulatif.
 
 Ensuite, exécutez l'assistant de configuration guidée :
 
 ```bash
-npx @agent-native/core@latest recap setup
-npx @agent-native/core@latest recap doctor
+npx @agent-native/recap-cli@latest recap setup
+npx @agent-native/recap-cli@latest recap doctor
 ```
 
 `recap setup` actualise le flux de travail et utilise `gh` pour définir GitHub Actions
@@ -118,7 +118,7 @@ défini. Les valeurs secrètes sont envoyées à `gh` via stdin, et non via les
 le fichier de workflow généré et ouvrez un PR pour le voir s'exécuter.
 
 Par défaut, le workflow crée son invite d'agent à partir de la dernière version groupée
-Conseils `visual-recap` dans `@agent-native/core@latest`, y compris les frères et sœurs
+Conseils `visual-recap` dans `@agent-native/recap-cli@latest`, y compris les frères et sœurs
 fichiers de référence avec lesquels la compétence est livrée. Si votre dépôt personnalise intentionnellement et
 épingle son dossier `visual-recap` validé, définit la variable du référentiel
 `VISUAL_RECAP_SKILL_SOURCE=repo`.
@@ -135,8 +135,8 @@ Par défaut, le workflow s'exécute sur des runners `ubuntu-latest` hébergés p
 Les guillemets JSON sont obligatoires. Cette valeur sélectionne le runner du job complet `recap`. Pour le configurer pendant l'installation guidée, transmettez la même valeur JSON à `--runs-on`, puis validez le workflow et la disponibilité du runner avec `doctor` :
 
 ```bash
-npx @agent-native/core@latest recap setup --runs-on '["self-hosted","linux","x64","visual-recap"]'
-npx @agent-native/core@latest recap doctor
+npx @agent-native/recap-cli@latest recap setup --runs-on '["self-hosted","linux","x64","visual-recap"]'
+npx @agent-native/recap-cli@latest recap doctor
 ```
 
 Le gate léger utilise séparément `ubuntu-latest`. Les dépôts sans runners hébergés par GitHub peuvent définir `VISUAL_RECAP_GATE_RUNS_ON` sur une seule étiquette en texte brut, sans JSON, ou utiliser `--gate-runs-on visual-recap-gate`. L'étiquette personnalisée ne s'applique qu'aux auteurs `OWNER`, `MEMBER` ou `COLLABORATOR` du même dépôt ; les forks et autres auteurs sont forcés sur `ubuntu-latest` et peuvent rester non planifiés si les runners hébergés sont désactivés. Utilisez un runner dédié et de préférence éphémère : le gate standard n'extrait pas l'arborescence de la PR et évalue la logique du workflow ainsi que les métadonnées de la PR.
@@ -160,12 +160,30 @@ Si la variable n'est pas définie, l'action utilise `claude`.
 
 Au-delà du backend, deux variables du référentiel ajustent _comment_ l'agent s'exécute :
 
-- **`VISUAL_RECAP_MODEL`** épingle le modèle transmis au CLI (`--model`) — par exemple `gpt-5.6-sol` pour Codex, ou un identifiant de modèle Claude. Laissez-le non défini pour utiliser le modèle par défaut du CLI.
+- **`VISUAL_RECAP_MODEL`** épingle le modèle transmis au CLI (`--model`) — par exemple `gpt-5.6-luna` pour Codex, un identifiant de modèle Claude, ou `deepseek-chat` pour DeepSeek. Elle est requise pour `openai-compatible`. Pour le backend **Claude**, la laisser non définie utilise désormais par défaut `claude-sonnet-5` ; définissez la variable explicitement pour utiliser un autre modèle Claude, comme le moins cher `claude-haiku-4-5`. Pour le backend **Codex**, la laisser non définie utilise le modèle par défaut du CLI Codex lui-même.
 - **`VISUAL_RECAP_REASONING`** définit la profondeur du raisonnement : `none`, `minimal`, `low`, `medium`, `high` ou `xhigh`. Cela s'applique au backend Codex ; Le raisonnement de Claude est basé sur un modèle, cette variable y est donc ignorée.
 - **`VISUAL_RECAP_SKILL_SOURCE`** contrôle la fraîcheur des invites : `auto`/unset utilise les dernières instructions de compétences groupées, tandis que `repo` s'épingle dans le dossier de compétences `visual-recap` local du dépôt validé.
 
 Par exemple, pour exécuter le récapitulatif sur Codex avec GPT-5.6 Sol avec un raisonnement élevé, définissez les variables du référentiel `VISUAL_RECAP_AGENT=codex`, `VISUAL_RECAP_MODEL=gpt-5.6-sol` et `VISUAL_RECAP_REASONING=high`.
 
+## Coût
+
+Chaque exécution du récapitulatif est une session complète d'agent de codage agentique qui lit un véritable diff, et non un résumé calqué sur un modèle bon marché ; son coût dépend donc du modèle choisi et de la fréquence d'exécution :
+
+- **Une session complète par poussée de PR.** Le déclencheur par défaut se déclenche sur `synchronize`, donc une PR poussée dix fois exécute l'agent dix fois.
+- **La PR entière à chaque fois**, pas seulement les commits depuis la dernière exécution — le coût augmente avec la taille totale de la PR, pas avec la taille incrémentale du diff.
+- **Entrée de diff plafonnée à environ 600 Ko.** Cela borne le pire cas par exécution, mais les diffs volumineux coûtent tout de même sensiblement plus cher que les petits.
+- **Une nouvelle tentative automatique en cas d'échec**, ce qui peut à peu près doubler le coût d'une exécution qui échoue de manière transitoire.
+
+Pour réduire le coût :
+
+- **Épinglez un modèle moins cher.** Pour Claude, définissez `VISUAL_RECAP_MODEL=claude-haiku-4-5` pour les dépôts simples ou petits — c'est le niveau Claude le moins cher ; `claude-sonnet-5` (la valeur par défaut) est le niveau équilibré.
+- **Passez à Codex avec un modèle moins cher.** Définissez `VISUAL_RECAP_AGENT=codex` avec `VISUAL_RECAP_MODEL=gpt-5.6-luna` (le niveau GPT-5.6 le moins cher) ou `gpt-5.6-terra` (niveau intermédiaire), et définissez `VISUAL_RECAP_REASONING=low` pour réduire encore la dépense en jetons de raisonnement. La profondeur de raisonnement ne s'applique qu'à Codex.
+- **Pointez vers un fournisseur compatible OpenAI moins cher.** Définissez `VISUAL_RECAP_AGENT=openai-compatible` avec `VISUAL_RECAP_BASE_URL`/`VISUAL_RECAP_MODEL`/`VISUAL_RECAP_API_KEY` ciblant DeepSeek, Kimi ou tout autre point de terminaison compatible OpenAI.
+- **Récapitulez moins souvent.** Modifiez le `on.pull_request.types` du flux de travail installé de `[opened, synchronize, reopened, ready_for_review, closed]` à `[opened, ready_for_review, closed]` afin qu'il ne récapitule que lorsqu'une PR s'ouvre et lorsqu'elle est fusionnée, au lieu de le faire à chaque poussée.
+
+Chaque exécution enregistre ce qu'elle a réellement dépensé : l'étape `recap usage` du flux de travail associe l'utilisation de jetons et de coût au plan publié, afin que vous puissiez consulter la dépense réelle par exécution plutôt que de deviner.
+
 ## Secrets et variables
 
 Définissez-les dans **Paramètres → Secrets et variables → Actions** de votre référentiel.
@@ -196,11 +214,11 @@ Application Plans.
 
 **Solo : un jeton personnel fonctionne toujours.** Fabriquez-le avec `npx @agent-native/core@latest connect`
 contre votre application Plans. Pour l'application hébergée, ceci écrit également un local
-fichier de jeton de publication que `npx @agent-native/core@latest recap setup` peut lire :
+fichier de jeton de publication que `npx @agent-native/recap-cli@latest recap setup` peut lire :
 
 ```bash
 npx @agent-native/core@latest connect https://plan.agent-native.com --client codex
-npx @agent-native/core@latest recap setup
+npx @agent-native/recap-cli@latest recap setup
 ```
 
 Si vous préférez une configuration manuelle, collez le jeton dans le secret GitHub. Utilisez un
@@ -209,16 +227,16 @@ vrai jeton.
 
 ### Facultatif (uniquement si vous modifiez les valeurs par défaut)
 
-| Secret / variable        | Par défaut                         | Quand vous en avez besoin                                                                                                                                       |
-| ------------------------ | ---------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| `OPENAI_API_KEY`         | —                                  | Secret. Configurez-le avec `VISUAL_RECAP_AGENT=codex` pour exécuter le récapitulatif avec Codex à la place.                                                     |
-| `VISUAL_RECAP_AGENT`     | `claude`                           | Variable. Sélectionne le backend de l'agent de codage (`claude` ou `codex`).                                                                                    |
-| `VISUAL_RECAP_MODEL`     | valeur par défaut de chaque CLI    | Variable. Épingle le modèle - par ex. `gpt-5.6-sol` pour Codex, ou un identifiant de modèle Claude. Unset utilise la valeur par défaut du CLI.                  |
-| `VISUAL_RECAP_REASONING` | valeur par défaut de chaque modèle | Variable. Profondeur de raisonnement : `none`, `minimal`, `low`, `medium`, `high` ou `xhigh`. S'applique au backend Codex.                                      |
-| `RECAP_CLI_VERSION`      | `latest`                           | Variable. Épingle la version `@agent-native/core` CLI installée par le flux de travail, par ex. `1.5.0`. Voir [Version pinning](#version-pinning-copy-variant). |
-| `PLAN_RECAP_APP_URL`     | `https://plan.agent-native.com`    | Secret. Uniquement lors de l'auto-hébergement de l'application Plans à une origine différente.                                                                  |
+| Secret / variable        | Par défaut                                                        | Quand vous en avez besoin                                                                                                                                                                                                                                                                                                                               |
+| ------------------------ | ----------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `OPENAI_API_KEY`         | —                                                                 | Secret. Configurez-le avec `VISUAL_RECAP_AGENT=codex` pour exécuter le récapitulatif avec Codex à la place.                                                                                                                                                                                                                                             |
+| `VISUAL_RECAP_AGENT`     | `claude`                                                          | Variable. Sélectionne le backend de l'agent de codage (`claude` ou `codex`).                                                                                                                                                                                                                                                                            |
+| `VISUAL_RECAP_MODEL`     | `claude-sonnet-5` pour Claude ; requis pour le backend compatible | Variable. Identifiant du modèle du fournisseur pour les backends compatibles OpenAI (requis dans ce cas). Pour Claude, non défini utilise désormais par défaut `claude-sonnet-5` — définissez-le pour le remplacer, par ex. `claude-haiku-4-5` pour le niveau le moins cher. Pour Codex, non défini utilise la valeur par défaut du CLI Codex lui-même. |
+| `VISUAL_RECAP_REASONING` | valeur par défaut de chaque modèle                                | Variable. Profondeur de raisonnement : `none`, `minimal`, `low`, `medium`, `high` ou `xhigh`. S'applique au backend Codex.                                                                                                                                                                                                                              |
+| `RECAP_CLI_VERSION`      | `latest`                                                          | Variable. Épingle la version `@agent-native/recap-cli` CLI installée par le flux de travail, par ex. `1.5.0`. Voir [Version pinning](#version-pinning-copy-variant).                                                                                                                                                                                    |
+| `PLAN_RECAP_APP_URL`     | `https://plan.agent-native.com`                                   | Secret. Uniquement lors de l'auto-hébergement de l'application Plans à une origine différente.                                                                                                                                                                                                                                                          |
 
-Le workflow détecte automatiquement comment appeler son assistant CLI (source locale dans ce monorepo, le `@agent-native/core` publié ailleurs), il n'y a donc aucune variable `RECAP_CLI` à définir.
+Le workflow détecte automatiquement comment appeler son assistant CLI (source locale dans ce monorepo, le `@agent-native/recap-cli` publié ailleurs), il n'y a donc aucune variable `RECAP_CLI` à définir.
 
 ## Capture d'écran en ligne dans le commentaire
 
@@ -360,9 +378,9 @@ récapitulatif sans envoyer le contenu du récapitulatif à la base de données
 même flux d'assistance localement en mode fichiers locaux :
 
 ```bash
-npx @agent-native/core@latest recap collect-diff --base main --head HEAD --out recap.diff --stat recap.stat
-npx @agent-native/core@latest recap scan --diff recap.diff
-npx @agent-native/core@latest recap build-prompt --pr 123 --diff recap.diff --stat recap.stat --local-files --local-dir plans/pr-123-visual-recap
+npx @agent-native/recap-cli@latest recap collect-diff --base main --head HEAD --out recap.diff --stat recap.stat
+npx @agent-native/recap-cli@latest recap scan --diff recap.diff
+npx @agent-native/recap-cli@latest recap build-prompt --pr 123 --diff recap.diff --stat recap.stat --local-files --local-dir plans/pr-123-visual-recap
 ```
 
 Donnez le `recap-prompt.md` généré à votre agent de codage. En mode fichiers locaux
@@ -392,7 +410,7 @@ Le récapitulatif est une aide à la révision superposée au flux normal de rel
 
 ## Épinglage de version (variante de copie) {#version-pinning-copy-variant}
 
-Par défaut, le workflow de copie de variante installe `@agent-native/core@latest` au moment de l'exécution afin que chaque exécution de récapitulation récupère automatiquement le dernier CLI. Si votre CI a besoin d'outils reproductibles, définissez la variable du référentiel **`RECAP_CLI_VERSION`** pour épingler la version installée :
+Par défaut, le workflow de copie de variante installe `@agent-native/recap-cli@latest` au moment de l'exécution afin que chaque exécution de récapitulation récupère automatiquement le dernier CLI. Si votre CI a besoin d'outils reproductibles, définissez la variable du référentiel **`RECAP_CLI_VERSION`** pour épingler la version installée :
 
 1. Accédez aux **Paramètres → Secrets et variables → Actions → Variables** de votre dépôt.
 2. Créez une variable nommée `RECAP_CLI_VERSION` avec une valeur telle que `1.5.0`.
@@ -403,7 +421,7 @@ Pour la variante d'appelant réutilisable, utilisez plutôt l'entrée `cli-versi
 
 ## Liste autorisée d'analyse secrète
 
-Avant de publier un récapitulatif, le workflow exécute `npx @agent-native/core@latest recap scan` pour détecter les secrets probables dans le diff. Tout PR dont la différence correspond à un modèle secret connu est bloqué avec un commentaire explicatif : le récapitulatif n'est pas publié et aucun contenu de différence n'est envoyé à l'agent de codage.
+Avant de publier un récapitulatif, le workflow exécute `npx @agent-native/recap-cli@latest recap scan` pour détecter les secrets probables dans le diff. Tout PR dont la différence correspond à un modèle secret connu est bloqué avec un commentaire explicatif : le récapitulatif n'est pas publié et aucun contenu de différence n'est envoyé à l'agent de codage.
 
 Dans de rares cas, un dépôt contient des appareils de test intentionnels ou des chaînes non secrètes qui ressemblent superficiellement à des modèles secrets (par exemple, une clé d'appareil dans un fichier de test). Pour supprimer un faux positif, créez `.github/recap-scan-allowlist` à la racine de votre référentiel.
 
@@ -437,7 +455,7 @@ La liste blanche n'est consultée que par la porte secrète-scan. Cela n'affecte
 
 ### Pourquoi utiliser la variante réutilisable ?
 
-Le programme d'installation par défaut copie le flux de travail complet d'environ 360 lignes YAML dans votre dépôt (l'option **copier**). C'est le bon choix pour les dépôts à air isolé ou les dépôts qui doivent auditer chaque ligne de ce qui s'exécute. L'inconvénient est que les corrections de bogues et les améliorations ne vous parviennent jamais : vous devez réexécuter `npx @agent-native/core@latest recap setup` manuellement après chaque version.
+Le programme d'installation par défaut copie le flux de travail complet d'environ 360 lignes YAML dans votre dépôt (l'option **copier**). C'est le bon choix pour les dépôts à air isolé ou les dépôts qui doivent auditer chaque ligne de ce qui s'exécute. L'inconvénient est que les corrections de bogues et les améliorations ne vous parviennent jamais : vous devez réexécuter `npx @agent-native/recap-cli@latest recap setup` manuellement après chaque version.
 
 L'option **réutilisable** écrit à la place un appelant mince d'environ 20 lignes. Il délègue à `BuilderIO/agent-native/.github/workflows/pr-visual-recap-reusable.yml` via `uses:`. Chaque appelant récupère automatiquement la dernière logique lors de l'exécution du workflow, sans qu'aucune mise à jour locale ne soit nécessaire.
 
@@ -450,7 +468,7 @@ L'option **réutilisable** écrit à la place un appelant mince d'environ 20 lig
 
 ### Extrait de l'appelant
 
-Voici ce qu'écrit `npx @agent-native/core@latest recap setup --reusable` (ou vous pouvez le coller manuellement) :
+Voici ce qu'écrit `npx @agent-native/recap-cli@latest recap setup --reusable` (ou vous pouvez le coller manuellement) :
 
 ```yaml
 name: PR Visual Recap
@@ -485,7 +503,7 @@ jobs:
       skill-source: ${{ vars.VISUAL_RECAP_SKILL_SOURCE || 'auto' }}
       runs-on: ${{ vars.VISUAL_RECAP_RUNS_ON || '"ubuntu-latest"' }}
       gate-runs-on: ${{ vars.VISUAL_RECAP_GATE_RUNS_ON || 'ubuntu-latest' }}
-      # cli-version: "latest"  # pin to a specific @agent-native/core version
+      # cli-version: "latest"  # pin to a specific @agent-native/recap-cli version
 ```
 
 Les mêmes secrets et variables décrits dans [Secrets and variables](#secrets-and-variables) s'appliquent. L'appelant réutilisable transmet `VISUAL_RECAP_RUNS_ON` via `runs-on` pour le job complet et `VISUAL_RECAP_GATE_RUNS_ON` via l'étiquette simple `gate-runs-on` pour le gate. Les deux utilisent `ubuntu-latest` par défaut.
@@ -494,15 +512,15 @@ Les mêmes secrets et variables décrits dans [Secrets and variables](#secrets-a
 
 ```bash
 # Écrivez l'appelant léger au lieu de la copie complète :
-npx @agent-native/core@latest recap setup --reusable
+npx @agent-native/recap-cli@latest recap setup --reusable
 
 # Ou avec une référence épinglée pour plus de reproductibilité :
-npx @agent-native/core@latest recap setup --reusable --ref v1.2.3
+npx @agent-native/recap-cli@latest recap setup --reusable --ref v1.2.3
 ```
 
 Les deux variantes écrivent le flux de travail dans `.github/workflows/pr-visual-recap.yml`. Si un workflow existant existe déjà et diffère, la commande refuse et vous demande de passer `--force` pour l'écraser.
 
-Après l'écriture, exécutez `npx @agent-native/core@latest recap doctor` comme d'habitude pour confirmer que les secrets sont configurés.
+Après l'écriture, exécutez `npx @agent-native/recap-cli@latest recap doctor` comme d'habitude pour confirmer que les secrets sont configurés.
 
 ### Épinglage de version
 
@@ -512,7 +530,7 @@ Par défaut, l'appelant fait référence à `@main`, qui utilise toujours la der
 uses: BuilderIO/agent-native/.github/workflows/pr-visual-recap-reusable.yml@v1.2.3
 ```
 
-L'entrée `cli-version` contrôle quelle version de `@agent-native/core` CLI s'exécute dans le flux de travail : laissez-la sur `"latest"` pour suivre la version la plus récente, ou épinglez-la à une chaîne de version (par exemple, `"1.5.0"`) pour une reproductibilité totale.
+L'entrée `cli-version` contrôle quelle version de `@agent-native/recap-cli` CLI s'exécute dans le flux de travail : laissez-la sur `"latest"` pour suivre la version la plus récente, ou épinglez-la à une chaîne de version (par exemple, `"1.5.0"`) pour une reproductibilité totale.
 
 ### Contexte de l'événement workflow_call
 

package/corpus/core/docs/content/locales/fr-FR/template-plan.mdx

@@ -212,6 +212,13 @@ Si le premier passage comporte encore des décisions responsables, l'agent peut
 **Formulaire de questions ouvertes** au bas du même plan. Y répondre et envoyer
 l'agent démarre un tour de révision par rapport au plan existant.
 
+## Coût et choix du modèle
+
+Générer un plan ou un récapitulatif exécute une session agentique complète contre le LLM de votre agent de codage, et non un simple remplissage de modèle léger ; le coût dépend donc de la taille du diff ou du plan et du modèle choisi.
+
+- Le modèle de chat par défaut de l'application est Sonnet 5 ; changez-le à tout moment dans les **Paramètres**. Haiku est l'option Claude moins chère, et Luna est l'option moins chère de la famille GPT-5.6.
+- Les récapitulatifs de PR automatisés depuis l'action GitHub s'exécutent séparément de l'application interactive et ont leurs propres réglages de modèle et de coût — voir [PR Visual Recap](/docs/pr-visual-recap) pour `VISUAL_RECAP_MODEL`, `VISUAL_RECAP_AGENT` et `VISUAL_RECAP_REASONING`.
+
 ## Ce que vous pouvez en faire
 
 - **Révision avant mise en œuvre.** React vers les diagrammes, les wireframes, les onglets d'options,