dsh-eslat 1.0.0 → 2.0.0

package/README.md

@@ -1,31 +1,30 @@
 # dsh-eslat · EsLat
 
-> **English summary** — **EsLat**, a [DeepSeek Harness](https://github.com/deepseek-ai/DeepSeek-Harness)
-> language bundle that shows **Spanish labels for tool calls and status summaries** in the web GUI
-> (`Read`, `Running`, `Preparing tool call`, `Reading files`, `Ran commands`, …) while everything else
-> keeps its English fallback. 435 labels across four client namespaces; it selects Spanish once and
-> never overrides a language the user chose afterwards. Install with
-> `dsh plugin add dsh-eslat`, or from the **Plugins** page in the sidebar. Revert with
-> Settings → General → *Idioma* → English. Full documentation below is in Spanish.
-
-Etiquetas en español para las **llamadas a herramientas** y los **resúmenes de estado** de la
-interfaz web de DSH. Es un plugin local: un paquete de idioma que registra el idioma `es` y sus
-diccionarios en los namespaces que DSH usa para esas dos cosas, y deja todo lo demás en su texto
-original en inglés.
+> **English summary** — **EsLat** is a [DeepSeek Harness](https://github.com/deepseek-ai/DeepSeek-Harness)
+> language bundle that translates the **whole web GUI** into neutral **Latin American Spanish**:
+> 1,615 labels across all 36 client namespaces shipped by DSH 0.2.0-rc.2 — conversation, sidebar,
+> settings, trajectory, tool calls, status summaries, dialogs, errors and empty states. Nothing is
+> left falling back to English. Install with `dsh plugin add dsh-eslat`, or from the **Plugins** page
+> in the sidebar. Revert to English with Settings → *Idioma* → English. Full documentation below is
+> in Spanish.
+
+Traducción completa al **español neutro de Latinoamérica** de la interfaz web de DSH. Es un paquete
+de idioma: registra el idioma `es` y un diccionario para **cada** namespace que el cliente de DSH
+publica, de modo que la interfaz entera —no solo las herramientas— aparece en español.
 
 ```
-Llamada a herramienta        →  Leer / Escribir / Editar / Buscar en el contenido / Buscar archivos
-                               Bash / PowerShell / Obtener página web / Crear subagente …
-Estado de la llamada         →  En ejecución / Preparando la llamada / Fallida / Detenida
-Resumen de estado en curso   →  Leyendo archivos / Ejecutando comandos / Coordinando subagentes …
-Resumen del turno terminado  →  Completado en 12 s · Se leyeron archivos y se ejecutaron comandos
-Panel Inspeccionar           →  Estado / Tipo / Código de salida / Resultado / Sin resultados …
+Conversación      →  Escribe un mensaje o una tarea, / para comandos, @ para archivos o sesiones
+Barra lateral     →  Espacios de trabajo · Sesiones · Archivar · Fijar · Cambiar nombre
+Ajustes           →  Configuración · Apariencia · Permisos · Tamaño de letra · Atajos
+Trayectoria       →  Turnos · Llamadas · Solicitudes · Mediciones · Uso de tokens
+Herramientas      →  Leer / Escribir / Editar / Buscar en el contenido / PowerShell / Crear subagente
+Estados           →  En ejecución / Preparando la llamada / Fallida / Detenida
+Resúmenes         →  Leyendo archivos · Completado en 12 s · Se leyeron archivos y se ejecutaron comandos
 ```
 
 ## Instalación
 
-Es un **bundle** de DSH (`dsh.bundle.patch`), así que se instala como cualquier otro plugin. Tres
-formas, de la más cómoda a la más manual:
+Es un **bundle** de DSH (`dsh.bundle.patch`), así que se instala como cualquier otro plugin.
 
 ### Desde npm
 
@@ -38,10 +37,10 @@ o en la interfaz web: barra lateral → **Plugins** → **Add plugin** → escri
 
 ### Desde un tarball
 
-Sin cuenta de npm y sin permisos de compilación: el tarball ya trae la mitad Cliente construida.
+Sin cuenta de npm y sin permisos de compilación: el tarball trae la mitad Cliente ya construida.
 
 ```
-dsh plugin add ./dsh-eslat-1.0.0.tgz
+dsh plugin add ./dsh-eslat-2.0.0.tgz
 ```
 
 ### Desde un repositorio Git
@@ -50,60 +49,70 @@ dsh plugin add ./dsh-eslat-1.0.0.tgz
 dsh plugin add github:Amador-Aguilar/dsh-eslat
 ```
 
-Este paquete **no necesita `prepare` ni autorizar scripts de compilación** en la instalación: el
-bundle del navegador (`lib/client.js`) se publica ya construido, no se genera al instalar.
+Este paquete **no necesita `prepare` ni autorizar scripts de compilación**: el bundle del navegador
+(`lib/client.js`) se publica construido, no se genera al instalar.
 
 ### En este equipo (desarrollo)
 
-En el perfil `desktop` está instalado como dependencia local enlazada:
-
-```jsonc
-// C:\Users\HP ZBook\.dsh\profiles\desktop\package.json
-"dependencies": { "dsh-eslat": "link:C:/Users/HP ZBook/Documents/deepseek-harness/default-workspace/dsh-eslat" },
-"dsh": { "profile": { "bundles": ["@deepseek-ai/dsh-base", "@deepseek-ai/dsh-web-app", "dsh-eslat"] } }
-```
-
-Como es un enlace, editar `src/*.es.json`, ejecutar `node tools/build.mjs` y recargar la página
-aplica los cambios sin reinstalar.
-
-Al desactivarlo, el idioma `es` desaparece del selector y la interfaz vuelve al idioma disponible (no
-borra la preferencia guardada, simplemente deja de estar disponible).
+En el perfil `desktop` está instalado desde el registro (`"dsh-eslat": "^2.0.0"`). Para probar
+cambios locales sin publicar, instálalo desde la ruta del proyecto con el gestor de plugins: queda
+como `link:` y los cambios de `src/` + `node tools/build.mjs` se aplican al recargar la página.
 
 ## Activación
 
-Al montarse, el plugin hace dos cosas: registra el idioma y selecciona **Español** una sola vez,
+Al montarse, el plugin registra el idioma y sus diccionarios, y selecciona **Español** una sola vez,
 sustituyendo únicamente el idioma por defecto (`en`). Después:
 
 | Situación | Qué ocurre |
 |---|---|
-| La interfaz estaba en inglés (por defecto) | Pasa a Español; las etiquetas de herramientas y los resúmenes de estado salen en español |
-| Ya estaba en chino o en otro idioma elegido | No se toca nada: solo sustituye el idioma por defecto |
-| El usuario cambia a otro idioma en Ajustes → Idioma | Se respeta para siempre; el plugin no vuelve a forzar el español |
+| La interfaz estaba en inglés (por defecto) | Pasa a Español; toda la interfaz cambia |
+| Ya estaba en chino u otro idioma elegido | No se toca nada: solo sustituye el idioma por defecto |
+| El usuario cambia a otro idioma en Configuración → Idioma | Se respeta para siempre; el plugin no vuelve a forzar el español |
 | Un shell nativo vuelve a anunciar su idioma por defecto | El plugin recupera el español, porque la elección no fue del usuario |
 
-La memoria de esa decisión vive en `localStorage` del navegador
-(`dsh-eslat:activation`). Si el almacenamiento no está disponible, el plugin se limita a
-seleccionar español en cada carga cuando la interfaz está en inglés.
+La memoria de esa decisión vive en `localStorage` del navegador (`dsh-eslat:activation`). Si el
+almacenamiento no está disponible, el plugin selecciona español en cada carga cuando la interfaz está
+en inglés.
 
-**Para volver atrás:** Ajustes → General → *Idioma* → English. Las etiquetas vuelven al inglés y el
-plugin no las cambiará de nuevo. Para quitarlo del todo, desactívalo o desinstálalo desde la página
+**Para volver atrás:** Configuración → General → *Idioma* → English. Para desinstalarlo, página
 **Plugins**.
 
-## Alcance
+## Cobertura
 
-Traduce 435 etiquetas en cuatro namespaces del cliente. La cobertura de las claves que pertenecen a
-llamadas a herramientas y resúmenes de estado es del 100 %; el resto de la interfaz no se toca.
+**1.615 de 1.615 claves (100 %) en 36 de 36 namespaces.** La verificación por clave lo garantiza y
+falla si alguna falta.
 
-| Namespace | Claves traducidas | Qué cubre |
-|---|---|---|
-| `conversation` | 284 de 367 | Títulos de cada herramienta (`tool.title.*`), estado de la fila (`row.*`, `bash.*`), tarjetas de búsqueda y lectura (`search.*`, `read.*`, `diff.*`), web (`web.*`), terminal (`terminal.*`), preguntas al usuario (`ask.*`), tareas (`todo.*`) y etiquetas del panel Inspeccionar (`detail.*`) |
-| `chat` | 109 de 186 | Resúmenes de estado en curso y terminados (`message.stepProcess.*`, `message.turnProcess.*`), disparadores del turno (`message.trigger.*`), reintentos, errores, uso del turno, `row.*`, `command.*`, duraciones y formato de fecha |
-| `common` | 41 de 41 | Vocabulario compartido de las tarjetas: Copiar, Copiado, Contraer, Expandir, Bloque de código… |
-| `settings.locale` | 1 de 1 | El título de la fila de idioma: *Idioma* |
+| Grupo | Namespaces | Claves |
+|---|---|---:|
+| Conversación y chat | `conversation` 367 · `chat` 186 | 553 |
+| Trayectoria y entregables | `trajectory` 192 · `deliverables` 60 | 252 |
+| Navegación y paneles | `workspace` 112 · `sidebarRight` 34 · `sidebarBrowser` 19 · `sidebarFiles` 11 · `sidebarDocumentPreview` 11 · `sidebar` 5 · `sidebarTerminal` 1 | 193 |
+| Ajustes y preferencias | `settings` 34 · `shortcuts` 28 · `permission.access` 17 · `settings.permission` 12 · `settings.theme` 9 | 100 |
+| Tareas y automatización | `schedule.manager` 133 · `job` 39 · `workflowRun` 18 · `schedule.catalog` 16 | 206 |
+| Herramientas y agentes | `cordis` 51 · `subagent` 39 · `model` 23 · `slash.menu` 9 · `skill` 8 | 130 |
+| Comandos y diálogos | `question` 31 · `command` 28 · `feedback` 20 · `plan` 17 · `goal` 12 · `approval` 1 | 109 |
+| Base compartida | `common` 41 · `open-in-app` 15 · `reference` 11 · `documentMarkdown` 4 · `settings.locale` 1 | 72 |
 
-Las claves que no se traducen caen automáticamente al inglés, porque el idioma `es` declara `en`
-como respaldo. Ese es el motivo de que la interfaz quede mixta: español en las herramientas y los
-estados, inglés en el resto.
+## Dialecto
+
+Español neutro de Latinoamérica, con estas decisiones aplicadas en todo el paquete:
+
+| Se usa | En lugar de |
+|---|---|
+| Configuración | Ajustes |
+| presiona / haz clic | pulsa / pincha |
+| agregar | añadir |
+| computadora, celular | ordenador, móvil |
+| archivo | fichero |
+| costo | coste |
+| `dd/mm/aaaa`, millar con punto (`1.615`) | formato inglés |
+
+Términos que se mantienen: `Bash`, `PowerShell`, `JSON`, `ZIP`, `TTFT`, `tok/s`, `Markdown`,
+`Cordis`, `sandbox`, `preset` y los nombres de modelos.
+
+`test/verify.mjs` incluye un **guardián de dialecto**: falla si reaparece un lexema peninsular
+(`ordenador`, `fichero`, `puls…`, `añad…`, `vosotros`, `móvil`, `coger`, `pinch…`, `zumo`, `patata`,
+`coche`).
 
 ## Identidad del plugin
 
@@ -111,156 +120,84 @@ estados, inglés en el resto.
 |---|---|---|
 | Nombre visible | **EsLat** | `locale/{en,es}.json` → `meta.title` |
 | Nombre técnico (npm y **id del módulo del navegador**) | `dsh-eslat` | `package.json` → `name` |
-| Icono | monograma «ñ»: tilde cian sobre trazo azul degradado, 36×36 | `icon.svg` |
+| Icono | «Es» sobre «Lat»: degradado azul + cian, 36×36 | `icon.svg` |
 | Autor | Amador Aguilar (`@amador_aguilar` en npm, `Amador-Aguilar` en GitHub) | `package.json` → `author` |
 | Repositorio | [github.com/Amador-Aguilar/dsh-eslat](https://github.com/Amador-Aguilar/dsh-eslat) | `package.json` → `repository` |
 
-La tarjeta de la página **Plugins** muestra el icono, el título visible y la descripción, y debajo el
-nombre del paquete. La autoría formal no depende de la tarjeta: la registra npm al publicar, y se
-consulta con `npm owner ls dsh-eslat`.
-
-### Si prefieres un nombre con ámbito
-
-`@amador_aguilar/dsh-eslat` es válido en npm (el ámbito es tu usuario, confirmado) y pone tu nombre en
-el propio nombre del paquete. Cuesta tres cambios y una reconstrucción, y la verificación falla si te
-falta uno:
-
-```powershell
-# 1. package.json      → "name": "@amador_aguilar/dsh-eslat"
-# 2. cordis.patch.yml  → name: '@amador_aguilar/dsh-eslat'
-node tools/build.mjs   # 3. regenera el id del módulo
-npm run verify
-```
-
-El paquete sin ámbito es más fácil de teclear y de encontrar por búsqueda; el ámbito pone tu usuario
-a la vista. Ambas opciones son válidas: npm registra al editor en cualquiera de las dos.
-
-### Campos del repositorio (ya configurados)
-
-`package.json` ya enlaza el código, así que la ficha de npm mostrará los botones de repositorio e
-incidencias:
-
-```jsonc
-"repository": { "type": "git", "url": "git+https://github.com/Amador-Aguilar/dsh-eslat.git" },
-"homepage": "https://github.com/Amador-Aguilar/dsh-eslat#readme",
-"bugs": { "url": "https://github.com/Amador-Aguilar/dsh-eslat/issues" }
-```
-
-## Publicar
-
-Requisitos de DSH para que un paquete sea instalable y aparezca como tarjeta en **Plugins**
-(según la [guía oficial de empaquetado](https://github.com/deepseek-ai/DeepSeek-Harness/blob/master/docs/user/develop/basic/publish.zh.md)
-y el [cookbook de paquetes](https://deepseek-harness.github.io/deepseek-harness/en/reference/cookbook/adding-a-package)):
-
-| Requisito | Estado |
-|---|---|
-| `dsh.bundle.patch` con un archivo existente | `./cordis.patch.yml` |
-| La fila del patch usa el **nombre del paquete** (no una ruta) | `dsh-eslat` |
-| `name` + `version` no vacíos (identidad en el inventario) | `dsh-eslat@1.0.0` |
-| Mitad Cliente **ya construida**: nadie ejecuta tu build al instalar | `lib/client.js` versionado |
-| `dsh.client.platform: 'web'` y `exports["./client"]` | presentes |
-| `files` incluye todo lo que hace falta en ejecución | bundle, map, patch, `locale/*.json` |
-| `engines.dsh` declarado | `>=0.2.0-rc.2` (solo mínimo; sin techo) |
-
-`test/verify.mjs` comprueba todas esas condiciones, incluido que `package.json`, la fila del patch y
-el `id` del bundle se llamen igual, y que `files` no deje fuera el artefacto. `prepublishOnly`
-encadena build + verificación + pruebas, así que un `publish` no puede salir con el bundle obsoleto.
-
-### Pasos
-
-```powershell
-# 1. Comprobar que todo sigue en verde y que el bundle está al día
-npm run verify
-
-# 2. Revisar el contenido exacto del paquete (9 archivos, ~19 kB)
-npm pack --dry-run
-
-# 3. Publicar en npm (la primera vez: npm adduser)
-npm publish
-```
-
-Si el `dsh-eslat` ya estuviera ocupado en el registro, publica con tu ámbito:
-
-```powershell
-# cambiar el nombre en package.json, cordis.patch.yml y reconstruir:
-#   "name": "@tu-usuario/dsh-eslat"
-node tools/build.mjs
-npm publish --access public
-```
-
-El `id` del módulo del navegador sale de `package.json`, así que reconstruir es obligatorio: la
-verificación falla si el bundle, el patch y el manifiesto discrepan.
-
-### Notas de compatibilidad
-
-- **Sin `peerDependencies` sobre `@deepseek-ai/dsh*`** a propósito: DSH rechaza instalar y arrancar
-  un bundle cuyos peers (o su `engines.dsh`) no satisfagan el runtime. Este plugin no importa nada
-  de DSH —solo usa servicios ambientales del cliente—, así que no declara ninguno y no queda atado a
-  una versión concreta. `engines.dsh` solo pone el mínimo.
-- **`engines.dsh` sin techo superior**: `>=0.2.0-rc.2` documenta el mínimo real (la versión cuyos
-  diccionarios se verifican) sin bloquear versiones futuras.
-- **Sin scripts de instalación**: no hay `prepare`, `install` ni `postinstall`, así que instalar
-  desde Git o tarball no pide autorizar la ejecución de código en la máquina del usuario.
-- **Sin actualización automática**: DSH no actualiza plugins instalados; una versión nueva se
-  instala desinstalando la anterior.
-- **Descubrimiento**: en `0.2.0-rc.2` no hay catálogo de terceros ni formulario de envío. El grupo
-  **Official** de la página Plugins es lo que la instalación de DSH trae consigo, no un canal de
-  publicación. La distribución es npm (o Git/tarball), y el descubrimiento pasa por las palabras
-  clave del `package.json`, el repositorio y las listas de la comunidad.
+La autoría formal la registra npm al publicar (`npm owner ls dsh-eslat`); la tarjeta de Plugins solo
+muestra icono, título y descripción.
 
 ## Estructura
 
 ```
 package.json              manifiesto: dsh.bundle.patch + dsh.client (platform web)
-cordis.patch.yml          capa de parche del bundle: inserta la fila locale-es-labels
+cordis.patch.yml          capa de parche del bundle: inserta la fila eslat
 lib/index.js              mitad Host: inerte, solo mantiene el paquete en el árbol del Loader
 lib/client.js             mitad Cliente construida (generada) — todo el comportamiento vive aquí
 lib/client.js.map         source map de identidad del bundle
 locale/{en,es}.json       título y descripción del plugin en la página Plugins
-LICENSE                   MIT
-src/*.es.json             diccionarios españoles editables (la fuente de verdad)
+icon.svg                  icono de la tarjeta (36×36, convención de DSH)
+src/<namespace>.es.json   un diccionario por namespace; añadir cobertura es añadir un archivo
 src/language.json         definición del idioma: id, etiqueta y respaldo
-tools/build.mjs           construye lib/client.js a partir de src/
-tools/extract-shipped-keys.mjs   regenera la instantánea de claves inglesas de DSH
-test/verify.mjs           claves, marcadores, frescura del bundle y requisitos de publicación
+tools/build.mjs           construye lib/client.js y su map a partir de src/
+tools/extract-shipped-keys.mjs   descubre los namespaces de DSH y regenera la instantánea de claves
+test/verify.mjs           claves, marcadores, dialecto, frescura del bundle y requisitos de publicación
 test/smoke.mjs            ejecuta la mitad Cliente contra dobles de prueba
+test/shipped-en.json      instantánea de los diccionarios ingleses de DSH 0.2.0-rc.2
 ```
 
-Solo se publica la primera mitad: `src/`, `tools/` y `test/` son material del repositorio. La
-instantánea `test/shipped-en.json` es lo que permite verificar el paquete sin tener DSH delante.
+Solo se publica la primera mitad: `src/`, `tools/` y `test/` son material del repositorio.
 
 ### Por qué la mitad Cliente es un archivo construido
 
 DSH sirve cada plugin del navegador como un bundle *lazy-CJS* ya construido: el host lee
 `exports["./client"]` y el navegador evalúa el archivo, que debe estar en la forma del cargador de
 módulos (`window.__ModuleLoader__.load({ id, factory })`) y no puede importar nada, porque el
-protocolo no admite `require` relativos entre bundles.
+protocolo no admite `require` relativos entre bundles. Por eso los diccionarios viven en `src/` y se
+incorporan al bundle generado.
+
+## Desarrollo
+
+```powershell
+node tools/build.mjs             # regenera lib/client.js y su map
+node test/verify.mjs             # claves, marcadores, dialecto, frescura, publicación
+node test/verify.mjs --strict    # además exige cobertura 100 %
+node test/smoke.mjs              # comportamiento de la mitad Cliente
+node tools/extract-shipped-keys.mjs   # re-descubre los namespaces de la imagen instalada
+```
+
+`verify` distingue **errores** (clave inexistente, marcador `{…}` que no cuadra, bundle obsoleto,
+lexema peninsular) de **cobertura pendiente**, que informa; `--strict` la exige y es lo que corre
+`prepublishOnly`.
+
+`test/shipped-en.json` es una instantánea extraída de DSH `0.2.0-rc.2`. Si una versión futura
+renombra o añade claves, `node tools/extract-shipped-keys.mjs` refresca la instantánea y `verify`
+dice exactamente qué falta.
+
+## Publicar
 
-Por eso los diccionarios viven en `src/*.es.json` y se incorporan al bundle generado. Editar el
-JSON y reconstruir es todo el ciclo de trabajo:
+`prepublishOnly` encadena build + `verify --strict` + smoke, así que no puede salir una versión con
+cobertura incompleta.
 
 ```powershell
-node tools/build.mjs     # regenera lib/client.js y su map
-node test/verify.mjs     # claves, marcadores {…}, frescura del bundle
-node test/smoke.mjs      # comportamiento de la mitad Cliente
+npm run verify     # build + verificación + pruebas
+npm publish        # con OTP: npm publish --otp=123456
 ```
 
-`test/shipped-en.json` es una instantánea de los diccionarios ingleses extraídos de DSH
-`0.2.0-rc.2`: si una versión futura renombra o elimina una clave, `verify` falla y lo dice, en lugar
-de dejar la etiqueta en inglés en silencio.
+Requisitos que `verify` comprueba: `dsh.bundle.patch` presente, la fila del patch con el nombre del
+paquete, `name`/`version` válidos, mitad Cliente construida y en `files`, `engines.dsh`, licencia y
+`prepublishOnly`.
 
 ## Limitaciones
 
-- **Interfaz mixta por diseño** — solo se sustituyen las etiquetas de herramientas y de estado; el
-  resto sigue en inglés a través del respaldo `en`.
 - **Claves atadas a una versión** — la verificación está anclada a DSH `0.2.0-rc.2`. Una clave
-  renombrada aguas arriba revierte esa etiqueta al inglés hasta que se actualice el diccionario.
-- **Enumeraciones de tres o más elementos** — DSH une los resúmenes cerrados con `message.stepProcess.comma`
-  y no ofrece una ranura para la conjunción final, así que una lista de tres sale como
-  «Se leyeron archivos, se buscó en el código, se ejecutaron comandos» en lugar de usar «y» antes
-  del último. Con dos elementos sí aparece la «y».
-- **Sin reglas de plural propias** — los plurales usan las ranuras `.one`/`.other` que DSH ya
-  consulta; `es` comparte con `en` la regla de singular y plural.
-- **Separador de millares y fechas** — se aplican las convenciones de España (`1.234` y `dd/mm`).
-- **Sin configuración** — el plugin no declara esquema de configuración: activarlo o desactivarlo en
-  la página Plugins es el único mando, y así se evita depender de librerías fuera del paquete.
+  renombrada aguas arriba revierte esa etiqueta al inglés hasta que se actualice el diccionario; el
+  extractor y el verificador lo detectan.
+- **Los datos no se traducen** — rutas de archivos, descripciones de comandos, resúmenes derivados de
+  los argumentos de cada herramienta y la respuesta del modelo siguen en el idioma en que lleguen.
+- **Enumeraciones de tres o más elementos** — DSH une los resúmenes cerrados con un separador fijo,
+  sin ranura para la conjunción final, así que una lista de tres sale con comas en lugar de «y».
+- **Sin reglas de plural propias** — se usan las ranuras `.one`/`.other` que DSH consulta; `es`
+  comparte con `en` la regla singular/plural.
+- **Sin configuración** — el plugin no declara esquema: activarlo o desactivarlo en la página Plugins
+  es el único mando.